@tryhakim/voice 1.0.0

package/dist/audio/to-blob.js

@@ -0,0 +1,78 @@
+/**
+ * Shared helper for multipart uploads. Normalizes the broad SDK
+ * `AudioInput` union into a single `Blob` suitable for
+ * `FormData.append`. Extracted so the transcriptions + voices (clone)
+ * endpoints use identical input-coercion rules — a future multipart
+ * endpoint can import this helper instead of re-rolling it.
+ */
+import { HakimError } from '../errors.js';
+export async function audioInputToBlob(input, filename) {
+    if (isBlobLike(input)) {
+        return input;
+    }
+    if (input instanceof ArrayBuffer) {
+        return new Blob([toFixedArrayBuffer(new Uint8Array(input))]);
+    }
+    if (ArrayBuffer.isView(input)) {
+        return new Blob([toFixedArrayBuffer(input)]);
+    }
+    if (isReadableStream(input)) {
+        const parts = [];
+        for await (const raw of input) {
+            const chunk = raw;
+            if (chunk instanceof Uint8Array) {
+                parts.push(toFixedArrayBuffer(chunk));
+            }
+            else if (typeof chunk === 'string') {
+                parts.push(toFixedArrayBuffer(new TextEncoder().encode(chunk)));
+            }
+            else if (chunk instanceof ArrayBuffer) {
+                parts.push(chunk);
+            }
+            else if (ArrayBuffer.isView(chunk)) {
+                parts.push(toFixedArrayBuffer(chunk));
+            }
+            else {
+                throw new HakimError({
+                    type: 'invalid_request_error',
+                    code: 'invalid_audio_chunk',
+                    message: `Hakim SDK: unsupported chunk type in stream (${typeof chunk}).`,
+                    status: 400,
+                    requestId: undefined,
+                });
+            }
+        }
+        return new Blob(parts);
+    }
+    throw new HakimError({
+        type: 'invalid_request_error',
+        code: 'invalid_audio_input',
+        message: `Hakim SDK: unsupported file input type (${typeof input}). Pass a Blob, Buffer, Uint8Array, ArrayBuffer, or Node ReadableStream. (filename=${filename})`,
+        status: 400,
+        requestId: undefined,
+    });
+}
+function isReadableStream(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const maybe = value;
+    return typeof maybe.pipe === 'function' || typeof maybe[Symbol.asyncIterator] === 'function';
+}
+function isBlobLike(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const maybe = value;
+    return (typeof maybe.arrayBuffer === 'function' &&
+        typeof maybe.slice === 'function' &&
+        typeof maybe.size === 'number');
+}
+/** Normalize a TypedArray/view to a plain `ArrayBuffer` (not
+ *  `ArrayBufferLike`, which would include `SharedArrayBuffer`). Keeps
+ *  us compatible with the global `Blob` constructor's DOM types under
+ *  TypeScript 5.7+, which tightened up `BlobPart`. */
+function toFixedArrayBuffer(view) {
+    const out = new ArrayBuffer(view.byteLength);
+    new Uint8Array(out).set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+    return out;
+}
+//# sourceMappingURL=to-blob.js.map

package/dist/audio/to-blob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-blob.js","sourceRoot":"","sources":["../../src/audio/to-blob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB,EAAE,QAAgB;IACxE,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,IAAI,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAY,GAAG,CAAC;YAC3B,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,CAAC;iBAAM,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;iBAAM,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,UAAU,CAAC;oBACnB,IAAI,EAAE,uBAAuB;oBAC7B,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,gDAAgD,OAAO,KAAK,IAAI;oBACzE,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,SAAS;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,2CAA2C,OAAO,KAAK,sFAAsF,QAAQ,GAAG;QACjK,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,KAAiF,CAAC;IAChG,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,CAAC;AAC/F,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,KAMb,CAAC;IACF,OAAO,CACL,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU;QACvC,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;QACjC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAC/B,CAAC;AACJ,CAAC;AAED;;;sDAGsD;AACtD,SAAS,kBAAkB,CAAC,IAAqB;IAC/C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACvF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/audio/transcriptions.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `audio.transcriptions` — POST /v1/audio/transcriptions.
+ *
+ * The server accepts **multipart/form-data** with a `file` field plus
+ * form-scalar parameters. We accept a broad set of audio input types
+ * and normalize them to something `FormData` can hold (a `Blob`):
+ *
+ *   - `Blob` / `File` — passed through.
+ *   - `ArrayBuffer` / `ArrayBufferView` / `Uint8Array` / `Buffer` — wrapped
+ *     in a `Blob` (which, on Node 18+, is provided by `buffer.Blob`).
+ *   - `NodeJS.ReadableStream` — collected into a `Buffer` first (PRD
+ *     §9: streaming STT upload is nice-to-have; sync API is buffered).
+ *
+ * The sync path (≤25 MiB AND ≤10 min) returns a typed `TranscriptionResult`
+ * variant keyed by `response_format`. The server may also return 202
+ * with an async acceptance body — we surface that as `kind: 'async_accepted'`.
+ */
+import type { Transport } from '../transport.js';
+import type { TranscriptionRequest, TranscriptionResult, TranscriptionStreamHandle, TranscriptionStreamOptions } from '../types.js';
+export declare class TranscriptionsAPI {
+    private readonly transport;
+    constructor(transport: Transport);
+    create(request: TranscriptionRequest, opts?: {
+        idempotencyKey?: string;
+        signal?: AbortSignal;
+    }): Promise<TranscriptionResult>;
+    private buildUploadForm;
+    private buildUrlBody;
+    /** Realtime STT over a WebSocket (`/v1/audio/transcriptions/stream`).
+     *  Returns a handle the caller writes audio chunks into and iterates
+     *  for `partial` / `final` / `usage` events. See
+     *  `TranscriptionStreamHandle` for lifecycle. */
+    stream(opts?: TranscriptionStreamOptions): TranscriptionStreamHandle;
+}
+//# sourceMappingURL=transcriptions.d.ts.map

package/dist/audio/transcriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptions.d.ts","sourceRoot":"","sources":["../../src/audio/transcriptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAIV,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,aAAa,CAAC;AAKrB,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE3C,MAAM,CACV,OAAO,EAAE,oBAAoB,EAC7B,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC3D,OAAO,CAAC,mBAAmB,CAAC;YAkDjB,eAAe;IAgB7B,OAAO,CAAC,YAAY;IAepB;;;qDAGiD;IACjD,MAAM,CAAC,IAAI,GAAE,0BAA+B,GAAG,yBAAyB;CAGzE"}

package/dist/audio/transcriptions.js

@@ -0,0 +1,105 @@
+/**
+ * `audio.transcriptions` — POST /v1/audio/transcriptions.
+ *
+ * The server accepts **multipart/form-data** with a `file` field plus
+ * form-scalar parameters. We accept a broad set of audio input types
+ * and normalize them to something `FormData` can hold (a `Blob`):
+ *
+ *   - `Blob` / `File` — passed through.
+ *   - `ArrayBuffer` / `ArrayBufferView` / `Uint8Array` / `Buffer` — wrapped
+ *     in a `Blob` (which, on Node 18+, is provided by `buffer.Blob`).
+ *   - `NodeJS.ReadableStream` — collected into a `Buffer` first (PRD
+ *     §9: streaming STT upload is nice-to-have; sync API is buffered).
+ *
+ * The sync path (≤25 MiB AND ≤10 min) returns a typed `TranscriptionResult`
+ * variant keyed by `response_format`. The server may also return 202
+ * with an async acceptance body — we surface that as `kind: 'async_accepted'`.
+ */
+import { DEFAULT_STT_MODEL } from '../types.js';
+import { audioInputToBlob } from './to-blob.js';
+import { openTranscriptionStream } from './stream.js';
+export class TranscriptionsAPI {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async create(request, opts = {}) {
+        const responseFormat = request.response_format ?? 'json';
+        const acceptByFormat = {
+            json: 'application/json',
+            verbose_json: 'application/json',
+            text: 'text/plain, application/json;q=0.9',
+            srt: 'application/x-subrip, text/plain;q=0.9, application/json;q=0.8',
+            vtt: 'text/vtt, text/plain;q=0.9, application/json;q=0.8',
+        };
+        const accept = acceptByFormat[responseFormat] ?? 'application/json';
+        // URL source → JSON body; the server fetches the audio. Otherwise
+        // upload the bytes as multipart/form-data.
+        const usesUrl = 'url' in request && typeof request.url === 'string';
+        const res = await this.transport.request({
+            method: 'POST',
+            path: '/v1/audio/transcriptions',
+            accept,
+            headers: { accept },
+            ...(usesUrl
+                ? { json: this.buildUrlBody(request, responseFormat) }
+                : { formData: await this.buildUploadForm(request, responseFormat) }),
+            ...(opts.idempotencyKey !== undefined ? { idempotencyKey: opts.idempotencyKey } : {}),
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        if (res.status === 202) {
+            const data = (await res.json());
+            return { kind: 'async_accepted', data };
+        }
+        const contentType = (res.headers.get('content-type') ?? '').toLowerCase();
+        if (contentType.includes('application/json')) {
+            const data = (await res.json());
+            return { kind: 'sync_json', data };
+        }
+        const text = await res.text();
+        if (responseFormat === 'srt' || contentType.includes('subrip')) {
+            return { kind: 'sync_srt', text };
+        }
+        if (responseFormat === 'vtt' || contentType.includes('vtt')) {
+            return { kind: 'sync_vtt', text };
+        }
+        return { kind: 'sync_text', text };
+    }
+    async buildUploadForm(request, responseFormat) {
+        const filename = request.filename ?? 'audio.bin';
+        const blob = await audioInputToBlob(request.file, filename);
+        const form = new FormData();
+        form.append('file', blob, filename);
+        form.append('model', request.model ?? DEFAULT_STT_MODEL);
+        if (request.language !== undefined)
+            form.append('language', request.language);
+        form.append('response_format', responseFormat);
+        if (request.timestamps !== undefined)
+            form.append('timestamps', request.timestamps);
+        if (request.diarize !== undefined)
+            form.append('diarize', String(request.diarize));
+        return form;
+    }
+    buildUrlBody(request, responseFormat) {
+        const body = {
+            url: request.url,
+            model: request.model ?? DEFAULT_STT_MODEL,
+            response_format: responseFormat,
+        };
+        if (request.language !== undefined)
+            body.language = request.language;
+        if (request.timestamps !== undefined)
+            body.timestamps = request.timestamps;
+        if (request.diarize !== undefined)
+            body.diarize = request.diarize;
+        return body;
+    }
+    /** Realtime STT over a WebSocket (`/v1/audio/transcriptions/stream`).
+     *  Returns a handle the caller writes audio chunks into and iterates
+     *  for `partial` / `final` / `usage` events. See
+     *  `TranscriptionStreamHandle` for lifecycle. */
+    stream(opts = {}) {
+        return openTranscriptionStream(this.transport, opts);
+    }
+}
+//# sourceMappingURL=transcriptions.js.map

package/dist/audio/transcriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptions.js","sourceRoot":"","sources":["../../src/audio/transcriptions.ts"],"names":[],"mappings":"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"}

package/dist/audio/translate-stream-ws.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Realtime translate over WebSocket (`WSS /v1/audio/translate/stream`).
+ *
+ * The SDK chains caller-supplied source audio (`sendAudio()` → base64
+ * `input_audio_buffer.append`) into the proxy and translates server
+ * frames into friendly `TranslateStreamEvent`s — STT partials + finals,
+ * LLM partials + finals, TTS started + binary audio + done, and a
+ * cross-modality `session.usage` rollup.
+ *
+ * Same dependency posture as the STT/TTS helpers: prefer
+ * `globalThis.WebSocket` when present (Node 22+, Bun, Deno, browsers).
+ * On Node 18/20 the global isn't there — we dynamically import `ws`
+ * at runtime and surface a helpful error if it's missing.
+ *
+ * The handle is lazy: the socket opens on the first `sendAudio` /
+ * iteration / `close`. This keeps the hot path fast and avoids
+ * dangling connections when a caller constructs a handle but bails
+ * before using it.
+ */
+import type { Transport } from '../transport.js';
+import type { TranslateStreamEvent, TranslateStreamHandle, TranslateStreamOptions } from '../types.js';
+export declare function openTranslateStream(transport: Transport, opts?: TranslateStreamOptions): TranslateStreamHandle;
+export declare function translateFrame(frame: unknown): TranslateStreamEvent | null;
+export declare function buildSessionUpdate(session: Partial<TranslateStreamOptions>): {
+    type: 'session.update';
+    session: Record<string, unknown>;
+} | null;
+declare function buildWsUrl(baseURL: string): string;
+declare function estimateAudioMs(byteLength: number, sampleRate: number, format: 'pcm16' | 'opus' | 'mulaw'): number | undefined;
+export declare const __internals: {
+    translateFrame: typeof translateFrame;
+    buildSessionUpdate: typeof buildSessionUpdate;
+    buildWsUrl: typeof buildWsUrl;
+    estimateAudioMs: typeof estimateAudioMs;
+};
+export {};
+//# sourceMappingURL=translate-stream-ws.d.ts.map

package/dist/audio/translate-stream-ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-stream-ws.d.ts","sourceRoot":"","sources":["../../src/audio/translate-stream-ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,aAAa,CAAC;AAcrB,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,IAAI,GAAE,sBAA2B,GAChC,qBAAqB,CA6TvB;AA8FD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAoJ1E;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAgBrE;AAED,iBAAS,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK3C;AAED,iBAAS,eAAe,CACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GACjC,MAAM,GAAG,SAAS,CAOpB;AA4FD,eAAO,MAAM,WAAW;;;;;CAAsE,CAAC"}