feat(ai-tts): per-block AI narration for articles

apps/admin/src/api/ai.ts

@@ -405,3 +405,60 @@ export function updateTranslationEntry(
 export function deleteTranslationEntry(id: string) {
   return deleteJson<void>(`/ai/translations/entries/${id}`)
 }
+
+export interface AITtsSegment {
+  blockId: string
+  chunkIndex: number
+  text: string
+  url: string
+}
+
+export interface AITtsRow {
+  blockOrder: string[]
+  charCount: number
+  id: string
+  isTranslation: boolean
+  lang: string
+  model: string
+  segments: AITtsSegment[]
+  speed: number
+  updatedAt?: null | string
+  voice: string
+}
+
+export function createTtsTask(data: {
+  force?: boolean
+  langs?: string[]
+  refId: string
+}) {
+  return postJson<CreateTaskResponse, typeof data>('/ai/tts/task', data)
+}
+
+export function getTtsByRefId(refId: string) {
+  return getJson<AITtsRow[]>(`/ai/tts/ref/${refId}`)
+}
+
+export function deleteTts(id: string) {
+  return deleteJson<void>(`/ai/tts/${id}`)
+}
+
+export interface AITtsListRow {
+  blockCount: number
+  charCount: number
+  id: string
+  lang: string
+  refId: string
+  updatedAt?: null | string
+}
+
+export type AITtsArticleMap = Record<string, ArticleInfo>
+
+export interface AITtsListResponse {
+  articles: AITtsArticleMap
+  data: AITtsListRow[]
+  pagination: PaginationInfo
+}
+
+export function getTtsList(params: { page?: number; size?: number }) {
+  return getJson<AITtsListResponse>('/ai/tts', params)
+}

apps/admin/src/api/http.test.ts

@@ -50,3 +50,48 @@ describe('requestJson error handling', () => {
     expect((error as ApiRequestError).code).toBeUndefined()
   })
 })
+
+describe('requestJson meta unwrapping', () => {
+  afterEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('flattens pagination alongside data', async () => {
+    vi.spyOn(globalThis, 'fetch').mockResolvedValueOnce(
+      jsonResponse({
+        data: [{ id: '1' }],
+        meta: { pagination: { page: 1, size: 10, total: 1, totalPages: 1 } },
+      }),
+    )
+
+    const result = await getJson<{
+      data: unknown[]
+      pagination: { total: number }
+    }>('/ai/tts')
+
+    expect(result.data).toEqual([{ id: '1' }])
+    expect(result.pagination.total).toBe(1)
+  })
+
+  it('carries sibling meta fields (e.g. articles) alongside pagination', async () => {
+    vi.spyOn(globalThis, 'fetch').mockResolvedValueOnce(
+      jsonResponse({
+        data: [{ id: '1', ref_id: '9' }],
+        meta: {
+          articles: { '9': { id: '9', title: 'Hello', type: 'Post' } },
+          pagination: { page: 1, size: 10, total: 1, totalPages: 1 },
+        },
+      }),
+    )
+
+    const result = await getJson<{
+      articles: Record<string, { id: string; title: string }>
+      data: unknown[]
+      pagination: { total: number }
+    }>('/ai/tts')
+
+    expect(result.articles).toEqual({
+      '9': { id: '9', title: 'Hello', type: 'Post' },
+    })
+  })
+})

apps/admin/src/api/http.ts

@@ -13,6 +13,7 @@ type ResponseEnvelope<T> = {
   }
   meta?: {
     pagination?: unknown
+    [key: string]: unknown
   }
   message?: string | string[]
 }
@@ -94,9 +95,11 @@ export async function requestJson<TResponse>(
 
   if (responseData && 'data' in responseData) {
     if (responseData.meta?.pagination) {
+      const { pagination, ...restMeta } = responseData.meta
       return {
         data: responseData.data,
-        pagination: responseData.meta.pagination,
+        pagination,
+        ...restMeta,
       } as TResponse
     }
 

apps/admin/src/api/tasks.ts

@@ -11,6 +11,7 @@ export enum AITaskType {
   Insights = 'ai:insights',
   InsightsTranslation = 'ai:insights:translation',
   ImageGeneration = 'ai:image:generation',
+  Tts = 'ai:tts',
 }
 
 export enum AITaskStatus {