feat: complete release preparation, 10+ ad mediation, CI/CD, and docker deployment

packages/api-client/src/index.ts

@@ -15,5 +15,6 @@ export * from './auth'
 export * from './meetings'
 export * from './history'
 export * from './usage'
+export * from './transcribe'
 export * from './supabase-browser'
 export * from './supabase-server'

packages/api-client/src/transcribe.ts

@@ -0,0 +1,91 @@
+// packages/api-client/src/transcribe.ts
+// D3RO Cloud STT Transcription Unified Client
+
+export interface TranscribeAudioParams {
+  audio: Blob | ArrayBuffer | Uint8Array | string // Blob, Binary, or Base64 string
+  language?: string
+  prompt?: string
+  model?: string
+  provider?: string
+  apiBaseUrl?: string
+  token?: string
+}
+
+export interface TranscribeAudioResult {
+  text: string
+  confidence: number
+  language: string
+  durationSeconds: number
+  provider: string
+  modelId: string
+  latencyMs: number
+  cost: number
+}
+
+/**
+ * 전사(STT) API를 호출합니다.
+ * 사용자는 클라우드 서비스를 통해 자연스럽게 음성을 전사할 수 있으며,
+ * 관리자에서 설정된 기본 프로바이더(Groq, OpenAI, Deepgram, Google 등)를 통해 자동으로 처리됩니다.
+ */
+export async function transcribeAudio(params: TranscribeAudioParams): Promise<TranscribeAudioResult> {
+  const apiBase = (params.apiBaseUrl || process.env.NEXT_PUBLIC_API_URL || 'http://localhost:5000').replace(/\/$/, '')
+  const url = `${apiBase}/api/stt/transcribe`
+
+  const headers: Record<string, string> = {}
+  if (params.token) {
+    headers['Authorization'] = `Bearer ${params.token}`
+  }
+
+  // 1. If audio is Blob or ArrayBuffer, send via FormData
+  if (params.audio instanceof Blob) {
+    const formData = new FormData()
+    formData.append('file', params.audio, 'recording.webm')
+    if (params.language) formData.append('language', params.language)
+    if (params.prompt) formData.append('prompt', params.prompt)
+    if (params.model) formData.append('model', params.model)
+    if (params.provider) formData.append('provider', params.provider)
+
+    const res = await fetch(url, {
+      method: 'POST',
+      headers,
+      body: formData,
+    })
+
+    if (!res.ok) {
+      const errText = await res.text()
+      throw new Error(`STT transcription failed (${res.status}): ${errText}`)
+    }
+
+    return (await res.json()) as TranscribeAudioResult
+  } else if (params.audio instanceof ArrayBuffer || params.audio instanceof Uint8Array) {
+    const blob = new Blob([params.audio as BlobPart], { type: 'audio/webm' })
+    return transcribeAudio({ ...params, audio: blob })
+  } else if (typeof params.audio === 'string') {
+    // 2. If audio is Base64 string, send JSON payload
+    const payload = {
+      audioBase64: params.audio,
+      language: params.language || 'ko',
+      initialPrompt: params.prompt,
+      modelId: params.model,
+      provider: params.provider,
+    }
+
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        ...headers,
+      },
+      body: JSON.stringify(payload),
+    })
+
+    if (!res.ok) {
+      const errText = await res.text()
+      throw new Error(`STT transcription failed (${res.status}): ${errText}`)
+    }
+
+    return (await res.json()) as TranscribeAudioResult
+  } else {
+    throw new Error('Unsupported audio payload format.')
+  }
+}