@tryhakim/voice 1.0.0

package/dist/audio/speech-stream-ws.js

@@ -0,0 +1,565 @@
+/**
+ * Realtime TTS over WebSocket (`WSS /v1/audio/speech/stream`).
+ *
+ * The SDK translates server frames into friendly `SpeechStreamEvent`s
+ * and emits caller `sendSpeech({...})` requests as `speech.create`
+ * frames upstream.
+ *
+ * Like the STT counterpart in `./stream.ts`, this helper stays
+ * dependency-free. We 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 `sendSpeech` /
+ * iteration of `events` / `audio` / `close`. This keeps the hot
+ * path fast and avoids dangling connections when a caller
+ * constructs a handle but bails before using it.
+ *
+ * Binary chunks coming back from the server are surfaced as
+ * `speech.audio` events (each carries a `chunk: Uint8Array`) so
+ * consumers can iterate a single stream of events instead of
+ * juggling a separate audio channel. The companion `audio` iterable
+ * filters to those chunks for callers who only want raw PCM.
+ */
+import { ConnectionError, HakimError } from '../errors.js';
+import { SDK_NAME, SDK_VERSION } from '../version.js';
+export function openSpeechStream(transport, opts = {}) {
+    const url = buildWsUrl(transport.baseURL);
+    const apiKey = transport.apiKey;
+    const pending = [];
+    let socket = null;
+    let openPromise = null;
+    const queue = [];
+    let waiter = null;
+    const audioQueue = [];
+    let audioWaiter = null;
+    let streamClosed = false;
+    let closedResolve;
+    const closedPromise = new Promise((r) => {
+        closedResolve = r;
+    });
+    let requestSeq = 0;
+    function emit(ev) {
+        if (streamClosed)
+            return;
+        if (waiter) {
+            const w = waiter;
+            waiter = null;
+            w({ value: ev, done: false });
+        }
+        else {
+            queue.push(ev);
+        }
+        if (ev.type === 'speech.audio') {
+            if (audioWaiter) {
+                const w = audioWaiter;
+                audioWaiter = null;
+                w({ value: ev.chunk, done: false });
+            }
+            else {
+                audioQueue.push(ev.chunk);
+            }
+        }
+    }
+    function finishStream() {
+        if (streamClosed)
+            return;
+        streamClosed = true;
+        if (waiter) {
+            const w = waiter;
+            waiter = null;
+            w({ value: undefined, done: true });
+        }
+        if (audioWaiter) {
+            const w = audioWaiter;
+            audioWaiter = null;
+            w({ value: undefined, done: true });
+        }
+        closedResolve();
+    }
+    async function ensureOpen() {
+        if (socket)
+            return socket;
+        if (openPromise)
+            return openPromise;
+        openPromise = (async () => {
+            const Ctor = await resolveSocketCtor();
+            const headers = {
+                Authorization: `Bearer ${apiKey}`,
+                'User-Agent': `${SDK_NAME}/${SDK_VERSION}`,
+            };
+            const s = new Ctor(url, { headers });
+            // Browser WebSocket: ask for arraybuffer so the message handler
+            // sees ArrayBuffer rather than Blob (Node `ws` ignores this and
+            // delivers Buffer regardless).
+            try {
+                s.binaryType = 'arraybuffer';
+            }
+            catch {
+                /* soft-fail · some socket impls reject the assignment */
+            }
+            await new Promise((resolve, reject) => {
+                const onOpen = () => {
+                    detach();
+                    resolve();
+                };
+                const onError = (err) => {
+                    detach();
+                    reject(new ConnectionError({
+                        message: 'Hakim SDK: could not open WebSocket to ' +
+                            `${url}. Is HAKIM_API_KEY valid and the network reachable?` +
+                            (err instanceof Error ? ` Cause: ${err.message}` : ''),
+                        requestId: undefined,
+                    }));
+                };
+                const detach = () => {
+                    removeListener(s, 'open', onOpen);
+                    removeListener(s, 'error', onError);
+                };
+                addListener(s, 'open', onOpen);
+                addListener(s, 'error', onError);
+            });
+            attachSocketHandlers(s, emit, finishStream);
+            socket = s;
+            // Send the initial session.update for any defaults the caller
+            // pinned. The server applies these to every subsequent
+            // speech.create that doesn't override the field per request.
+            const sessionUpdate = buildSessionUpdate(opts);
+            if (sessionUpdate) {
+                s.send(JSON.stringify(sessionUpdate));
+            }
+            for (const frame of pending.splice(0)) {
+                s.send(frame);
+            }
+            return s;
+        })();
+        return openPromise;
+    }
+    function enqueueFrame(frame) {
+        if (socket && socket.readyState === 1 /* OPEN */) {
+            socket.send(frame);
+        }
+        else {
+            pending.push(frame);
+            ensureOpen().catch((err) => {
+                if (err instanceof HakimError || err instanceof ConnectionError) {
+                    emit({
+                        type: 'error',
+                        code: err.code ?? 'connection_error',
+                        message: err.message,
+                        retryable: false,
+                        fatal: true,
+                    });
+                }
+                finishStream();
+            });
+        }
+    }
+    function sendSpeech(request) {
+        if (streamClosed) {
+            throw new HakimError({
+                type: 'invalid_request_error',
+                code: 'stream_closed',
+                message: 'Hakim SDK: cannot send speech; stream is closed.',
+                status: 400,
+                requestId: undefined,
+            });
+        }
+        if (typeof request.input !== 'string' || request.input.length === 0) {
+            throw new HakimError({
+                type: 'invalid_request_error',
+                code: 'input_required',
+                message: 'Hakim SDK: sendSpeech({ input }) must be a non-empty string.',
+                status: 400,
+                requestId: undefined,
+            });
+        }
+        const requestId = request.request_id ?? `wst_local_${(requestSeq++).toString(36)}`;
+        const frame = {
+            type: 'speech.create',
+            input: request.input,
+            request_id: requestId,
+        };
+        if (request.voice !== undefined)
+            frame.voice = request.voice;
+        if (request.model !== undefined)
+            frame.model = request.model;
+        if (request.cfg !== undefined)
+            frame.cfg = request.cfg;
+        if (request.voice_prompt !== undefined)
+            frame.voice_prompt = request.voice_prompt;
+        enqueueFrame(JSON.stringify(frame));
+        return requestId;
+    }
+    function updateSession(session) {
+        if (streamClosed) {
+            throw new HakimError({
+                type: 'invalid_request_error',
+                code: 'stream_closed',
+                message: 'Hakim SDK: cannot update session; stream is closed.',
+                status: 400,
+                requestId: undefined,
+            });
+        }
+        // Merge into the local defaults so a later lazy open picks them up
+        // even if the socket wasn't open yet when updateSession was called.
+        if (session.model !== undefined)
+            opts.model = session.model;
+        if (session.voice !== undefined)
+            opts.voice = session.voice;
+        if (session.cfg !== undefined)
+            opts.cfg = session.cfg;
+        if (session.voice_prompt !== undefined)
+            opts.voice_prompt = session.voice_prompt;
+        const upd = buildSessionUpdate(session);
+        if (upd)
+            enqueueFrame(JSON.stringify(upd));
+    }
+    async function close() {
+        if (streamClosed)
+            return;
+        enqueueFrame(JSON.stringify({ type: 'session.close' }));
+        await closedPromise;
+    }
+    if (opts.signal) {
+        if (opts.signal.aborted) {
+            Promise.resolve()
+                .then(() => close())
+                .catch(() => undefined);
+        }
+        else {
+            opts.signal.addEventListener('abort', () => {
+                close().catch(() => undefined);
+            }, { once: true });
+        }
+    }
+    const events = {
+        [Symbol.asyncIterator]() {
+            return {
+                next() {
+                    if (queue.length > 0) {
+                        return Promise.resolve({ value: queue.shift(), done: false });
+                    }
+                    if (streamClosed) {
+                        return Promise.resolve({
+                            value: undefined,
+                            done: true,
+                        });
+                    }
+                    return new Promise((resolve) => {
+                        waiter = resolve;
+                        if (!socket && !openPromise) {
+                            ensureOpen().catch((err) => {
+                                if (!streamClosed) {
+                                    emit({
+                                        type: 'error',
+                                        code: err?.code ?? 'connection_error',
+                                        message: err instanceof Error ? err.message : 'connection error',
+                                        retryable: false,
+                                        fatal: true,
+                                    });
+                                    finishStream();
+                                }
+                            });
+                        }
+                    });
+                },
+                return() {
+                    close().catch(() => undefined);
+                    return Promise.resolve({
+                        value: undefined,
+                        done: true,
+                    });
+                },
+            };
+        },
+    };
+    const audio = {
+        [Symbol.asyncIterator]() {
+            return {
+                next() {
+                    if (audioQueue.length > 0) {
+                        return Promise.resolve({ value: audioQueue.shift(), done: false });
+                    }
+                    if (streamClosed) {
+                        return Promise.resolve({
+                            value: undefined,
+                            done: true,
+                        });
+                    }
+                    return new Promise((resolve) => {
+                        audioWaiter = resolve;
+                        if (!socket && !openPromise) {
+                            ensureOpen().catch((err) => {
+                                if (!streamClosed) {
+                                    emit({
+                                        type: 'error',
+                                        code: err?.code ?? 'connection_error',
+                                        message: err instanceof Error ? err.message : 'connection error',
+                                        retryable: false,
+                                        fatal: true,
+                                    });
+                                    finishStream();
+                                }
+                            });
+                        }
+                    });
+                },
+                return() {
+                    close().catch(() => undefined);
+                    return Promise.resolve({
+                        value: undefined,
+                        done: true,
+                    });
+                },
+            };
+        },
+    };
+    return {
+        sendSpeech,
+        updateSession,
+        events,
+        audio,
+        close,
+        closed: closedPromise,
+    };
+}
+function attachSocketHandlers(s, emit, finishStream) {
+    // Track the last request_id seen on the wire so we can attach it
+    // to binary audio frames (which carry no envelope of their own).
+    // The server always emits `speech.started` before any audio chunk
+    // for that utterance, so this is a safe single-cursor approach.
+    let currentRequestId = null;
+    const onMessage = (raw, maybeIsBinary) => {
+        const binary = decodeBinary(raw, maybeIsBinary);
+        if (binary !== null) {
+            if (currentRequestId === null)
+                return;
+            emit({ type: 'speech.audio', request_id: currentRequestId, chunk: binary });
+            return;
+        }
+        const text = extractMessageText(raw);
+        if (text === null)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        const translated = translateFrame(parsed);
+        if (!translated)
+            return;
+        if (translated.type === 'speech.started') {
+            currentRequestId = translated.request_id;
+        }
+        emit(translated);
+        if (translated.type === 'speech.done' || (translated.type === 'error' && translated.fatal)) {
+            // Don't reset on .done — the next .started arrives with its
+            // own request_id and overwrites cleanly. Resetting here would
+            // race with a follow-up binary frame the engine queued before
+            // we processed the .done text frame.
+        }
+    };
+    const onClose = () => {
+        finishStream();
+    };
+    addListener(s, 'message', onMessage);
+    addListener(s, 'close', onClose);
+}
+/** Try to extract binary payload from the on('message', ...) raw arg.
+ *  Returns null when the frame is text. */
+function decodeBinary(raw, maybeIsBinary) {
+    // Node `ws` emits (data: Buffer | ArrayBuffer | Buffer[], isBinary: boolean)
+    if (maybeIsBinary === true) {
+        if (raw instanceof Uint8Array)
+            return raw;
+        if (raw instanceof ArrayBuffer)
+            return new Uint8Array(raw);
+        if (Array.isArray(raw)) {
+            const total = raw.reduce((n, b) => n + (b?.byteLength ?? 0), 0);
+            const out = new Uint8Array(total);
+            let off = 0;
+            for (const b of raw) {
+                out.set(b, off);
+                off += b.byteLength;
+            }
+            return out;
+        }
+    }
+    // Browser MessageEvent: `{ data: string | ArrayBuffer | Blob }`.
+    if (raw && typeof raw === 'object' && 'data' in raw) {
+        const d = raw.data;
+        if (d instanceof ArrayBuffer)
+            return new Uint8Array(d);
+        if (ArrayBuffer.isView(d) && d instanceof Uint8Array)
+            return d;
+    }
+    return null;
+}
+function extractMessageText(raw) {
+    if (typeof raw === 'string')
+        return raw;
+    if (raw && typeof raw === 'object' && 'data' in raw) {
+        const d = raw.data;
+        if (typeof d === 'string')
+            return d;
+        return null;
+    }
+    if (raw instanceof Uint8Array)
+        return new TextDecoder().decode(raw);
+    if (Array.isArray(raw)) {
+        // Node `ws` fragmented text frames arrive as Buffer[].
+        try {
+            const parts = raw;
+            const total = parts.reduce((n, b) => n + b.byteLength, 0);
+            const out = new Uint8Array(total);
+            let off = 0;
+            for (const b of parts) {
+                out.set(b, off);
+                off += b.byteLength;
+            }
+            return new TextDecoder().decode(out);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+export function translateFrame(frame) {
+    if (!frame || typeof frame !== 'object')
+        return null;
+    const f = frame;
+    switch (f.type) {
+        case 'speech.started': {
+            const d = frame;
+            if (typeof d.request_id !== 'string')
+                return null;
+            return {
+                type: 'speech.started',
+                request_id: d.request_id,
+                characters: typeof d.characters === 'number' ? d.characters : 0,
+                sample_rate: typeof d.sample_rate === 'number' ? d.sample_rate : 24000,
+                encoding: 'pcm_s16le',
+                channels: 1,
+                model: typeof d.model === 'string' ? d.model : 'hakim-fast-v1',
+                voice: typeof d.voice === 'string' ? d.voice : 'unknown',
+            };
+        }
+        case 'speech.done': {
+            const d = frame;
+            if (typeof d.request_id !== 'string')
+                return null;
+            return {
+                type: 'speech.done',
+                request_id: d.request_id,
+                duration_ms: typeof d.duration_ms === 'number' ? d.duration_ms : 0,
+                usage: d.usage,
+            };
+        }
+        case 'session.usage': {
+            const d = frame;
+            return {
+                type: 'session.usage',
+                session_characters: typeof d.session_characters === 'number' ? d.session_characters : 0,
+                usage: d.usage,
+            };
+        }
+        case 'error': {
+            const d = frame;
+            const out = {
+                type: 'error',
+                code: typeof d.code === 'string' ? d.code : 'unknown_error',
+                message: typeof d.message === 'string' ? d.message : 'unknown error',
+                retryable: d.retryable === true,
+                fatal: d.fatal === true,
+            };
+            if (typeof d.request_id === 'string')
+                out.request_id = d.request_id;
+            return out;
+        }
+        case 'session.created':
+            // Informational — surfaces session ids + limits in the server
+            // log; SDK consumers don't need to branch on it.
+            return null;
+        default:
+            return null;
+    }
+}
+export function buildSessionUpdate(session) {
+    const out = {};
+    if (session.model !== undefined)
+        out.model = session.model;
+    if (session.voice !== undefined)
+        out.voice = session.voice;
+    if (session.cfg !== undefined)
+        out.cfg = session.cfg;
+    if (session.voice_prompt !== undefined)
+        out.voice_prompt = session.voice_prompt;
+    if (Object.keys(out).length === 0)
+        return null;
+    return { type: 'session.update', session: out };
+}
+function buildWsUrl(baseURL) {
+    const u = new URL(baseURL);
+    u.protocol = u.protocol === 'https:' ? 'wss:' : 'ws:';
+    u.pathname = u.pathname.replace(/\/$/, '') + '/v1/audio/speech/stream';
+    return u.toString();
+}
+function addListener(socket, type, listener) {
+    if (socket.addEventListener) {
+        socket.addEventListener(type, listener);
+    }
+    else if (socket.on) {
+        socket.on(type, listener);
+    }
+}
+function removeListener(socket, type, listener) {
+    const s = socket;
+    if (s.removeEventListener)
+        s.removeEventListener(type, listener);
+    else if (s.off)
+        s.off(type, listener);
+}
+let _socketCtor = null;
+let _socketCtorPromise = null;
+async function resolveSocketCtor() {
+    if (_socketCtor)
+        return _socketCtor;
+    if (_socketCtorPromise)
+        return _socketCtorPromise;
+    const globalWs = globalThis.WebSocket;
+    if (globalWs) {
+        _socketCtor = globalWs;
+        return globalWs;
+    }
+    _socketCtorPromise = (async () => {
+        try {
+            // Computed specifier so `tsc` doesn't try to resolve `ws`'s
+            // types at compile time (the SDK ships zero deps; `ws` is
+            // only resolved at runtime on older Node).
+            const mod = await new Function('s', 'return import(s)')('ws');
+            const Ctor = mod.default ?? mod.WebSocket;
+            if (!Ctor)
+                throw new Error('ws module did not export a WebSocket class');
+            _socketCtor = Ctor;
+            return Ctor;
+        }
+        catch (err) {
+            throw new HakimError({
+                type: 'invalid_request_error',
+                code: 'websocket_impl_missing',
+                message: 'Hakim SDK: realtime TTS requires a WebSocket implementation. On Node 22+ / Bun / Deno / browsers it is built in. On Node 18 / 20, run `npm install ws` alongside @tryhakim/voice. ' +
+                    (err instanceof Error ? `(cause: ${err.message})` : ''),
+                status: 0,
+                requestId: undefined,
+            });
+        }
+    })();
+    return _socketCtorPromise;
+}
+export const __internals = { translateFrame, buildSessionUpdate, buildWsUrl };
+//# sourceMappingURL=speech-stream-ws.js.map

package/dist/audio/speech-stream-ws.js.map

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

package/dist/audio/speech.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `audio.speech` — POST /v1/audio/speech.
+ *
+ * Two entry points:
+ *
+ *   - `create(request)` — buffers the full audio into memory and
+ *     returns it with decoded headers. Use for short outputs or when
+ *     you need `usageCharacters` / `durationMs` immediately.
+ *
+ *   - `stream(request)` — returns an AsyncIterable of `Uint8Array`
+ *     chunks so the caller can start playback / uploading before the
+ *     server finishes synthesis. `stream` forces `stream: true` on the
+ *     request payload regardless of what the caller passed.
+ */
+import type { Transport } from '../transport.js';
+import type { SpeechRequest, SpeechResponse, SpeechStreamHandle, SpeechStreamOptions, SpeechStreamResponse } from '../types.js';
+export declare class SpeechAPI {
+    private readonly transport;
+    constructor(transport: Transport);
+    /** Realtime TTS over a WebSocket (`/v1/audio/speech/stream`).
+     *
+     *  Trades the per-request TCP/TLS/HTTP-header setup of the HTTP
+     *  path (~7 ms per call cross-region) for a long-lived socket that
+     *  can serve many utterances back-to-back. The persistent surface
+     *  is the right pick for LLM-→-TTS pipelines (synthesise the next
+     *  sentence while the LLM is still generating tokens) and embed
+     *  widgets that make many TTS calls per session.
+     *
+     *  Returns a `SpeechStreamHandle` — call `sendSpeech({...})` to
+     *  request an utterance, iterate `audio` (raw PCM-S16LE @ 24 kHz
+     *  mono) or `events` (started / audio / done / usage / error), and
+     *  `close()` when finished. */
+    streamWs(opts?: SpeechStreamOptions): SpeechStreamHandle;
+    /** Non-streaming TTS. Returns the complete audio body as a Uint8Array. */
+    create(request: SpeechRequest, opts?: {
+        idempotencyKey?: string;
+        signal?: AbortSignal;
+    }): Promise<SpeechResponse>;
+    /** Streaming TTS. Starts yielding chunks as soon as the server writes
+     *  them, without buffering the whole response. */
+    stream(request: SpeechRequest, opts?: {
+        idempotencyKey?: string;
+        signal?: AbortSignal;
+    }): Promise<SpeechStreamResponse>;
+}
+//# sourceMappingURL=speech.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../src/audio/speech.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAKrB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD;;;;;;;;;;;;mCAY+B;IAC/B,QAAQ,CAAC,IAAI,GAAE,mBAAwB,GAAG,kBAAkB;IAI5D,0EAA0E;IACpE,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC3D,OAAO,CAAC,cAAc,CAAC;IA2B1B;sDACkD;IAC5C,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC3D,OAAO,CAAC,oBAAoB,CAAC;CAgCjC"}