@tryhakim/voice 1.0.0

package/dist/audio/speech.js

@@ -0,0 +1,125 @@
+/**
+ * `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 { ConnectionError } from '../errors.js';
+import { parseLimitsFromHeaders, parseUsageBlockFromHeaders } from '../observability.js';
+import { openSpeechStream } from './speech-stream-ws.js';
+export class SpeechAPI {
+    transport;
+    constructor(transport) {
+        this.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 = {}) {
+        return openSpeechStream(this.transport, opts);
+    }
+    /** Non-streaming TTS. Returns the complete audio body as a Uint8Array. */
+    async create(request, opts = {}) {
+        const res = await this.transport.request({
+            method: 'POST',
+            path: '/v1/audio/speech',
+            json: { ...request, stream: false },
+            accept: 'audio/*',
+            headers: { accept: 'audio/*' },
+            ...(opts.idempotencyKey !== undefined ? { idempotencyKey: opts.idempotencyKey } : {}),
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        const buffer = await res.arrayBuffer();
+        return {
+            audio: new Uint8Array(buffer),
+            contentType: res.headers.get('content-type') ?? 'application/octet-stream',
+            usageCharacters: parsePositiveInt(res.headers.get('x-usage-characters')),
+            durationMs: parsePositiveInt(res.headers.get('x-duration-ms')),
+            usage: parseUsageBlockFromHeaders(res.headers),
+            limits: parseLimitsFromHeaders(res.headers),
+            meta: {
+                requestId: res.headers.get('x-request-id') ?? undefined,
+                status: res.status,
+                headers: res.headers,
+            },
+        };
+    }
+    /** Streaming TTS. Starts yielding chunks as soon as the server writes
+     *  them, without buffering the whole response. */
+    async stream(request, opts = {}) {
+        const res = await this.transport.request({
+            method: 'POST',
+            path: '/v1/audio/speech',
+            json: { ...request, stream: true },
+            accept: 'audio/*',
+            headers: { accept: 'audio/*' },
+            stream: true,
+            ...(opts.idempotencyKey !== undefined ? { idempotencyKey: opts.idempotencyKey } : {}),
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        if (!res.body) {
+            throw new ConnectionError({
+                message: 'Hakim SDK: TTS streaming response has no body',
+                requestId: res.headers.get('x-request-id') ?? undefined,
+            });
+        }
+        return {
+            stream: iterateReader(res.body),
+            contentType: res.headers.get('content-type') ?? 'application/octet-stream',
+            usageCharacters: parsePositiveInt(res.headers.get('x-usage-characters')),
+            usage: parseUsageBlockFromHeaders(res.headers),
+            limits: parseLimitsFromHeaders(res.headers),
+            meta: {
+                requestId: res.headers.get('x-request-id') ?? undefined,
+                status: res.status,
+                headers: res.headers,
+            },
+        };
+    }
+}
+/** Convert a `ReadableStream<Uint8Array>` (returned by fetch on Node 18+)
+ *  to an `AsyncIterable<Uint8Array>` so callers can `for await …`. */
+async function* iterateReader(body) {
+    const reader = body.getReader();
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                return;
+            if (value)
+                yield value;
+        }
+    }
+    finally {
+        // Release the reader lock so the stream can be GC'd if the caller
+        // bailed out mid-iteration.
+        reader.releaseLock();
+    }
+}
+function parsePositiveInt(raw) {
+    if (!raw)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0)
+        return undefined;
+    return Math.floor(n);
+}
+//# sourceMappingURL=speech.js.map

package/dist/audio/speech.js.map

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

package/dist/audio/stream.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Realtime STT over WebSocket (`WSS /v1/audio/transcriptions/stream`).
+ *
+ * The SDK translates the server's `session.created` / `transcription.delta`
+ * / `transcription.done` / `error` frames into friendly
+ * `TranscriptionStreamEvent`s and translates caller audio chunks into
+ * base64-encoded `input_audio_buffer.append` frames.
+ *
+ * The SDK 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. Consumers on
+ * those engines must install `ws` alongside `@tryhakim/voice`; we surface
+ * a helpful error if it's missing instead of blowing up with an
+ * opaque module-not-found trace.
+ *
+ * The handle is lazy: the WebSocket opens on the first call to
+ * `sendAudio` / `close` / the first consumer iteration of `events`.
+ * This keeps the hot path fast and avoids dangling connections when a
+ * caller creates a handle but bails before sending anything.
+ */
+import type { Transport } from '../transport.js';
+import type { TranscriptionStreamEvent, TranscriptionStreamHandle, TranscriptionStreamOptions } from '../types.js';
+export declare function openTranscriptionStream(transport: Transport, opts: TranscriptionStreamOptions): TranscriptionStreamHandle;
+declare function translateFrame(frame: unknown): TranscriptionStreamEvent | null;
+declare function buildSessionUpdate(opts: TranscriptionStreamOptions): {
+    type: 'session.update';
+    session: Record<string, unknown>;
+} | null;
+declare function buildWsUrl(baseURL: string): string;
+declare function estimateAudioMs(byteLength: number, sampleRate: number, format: 'pcm16'): number | undefined;
+export declare const __internals: {
+    translateFrame: typeof translateFrame;
+    buildSessionUpdate: typeof buildSessionUpdate;
+    buildWsUrl: typeof buildWsUrl;
+    estimateAudioMs: typeof estimateAudioMs;
+};
+export {};
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/audio/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAGV,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAE3B,MAAM,aAAa,CAAC;AAerB,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,0BAA0B,GAC/B,yBAAyB,CAyN3B;AA6CD,iBAAS,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,GAAG,IAAI,CA+EvE;AAED,iBAAS,kBAAkB,CACzB,IAAI,EAAE,0BAA0B,GAC/B;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAQrE;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,GACd,MAAM,GAAG,SAAS,CAKpB;AAgGD,eAAO,MAAM,WAAW;;;;;CAAsE,CAAC"}

package/dist/audio/stream.js

@@ -0,0 +1,452 @@
+/**
+ * Realtime STT over WebSocket (`WSS /v1/audio/transcriptions/stream`).
+ *
+ * The SDK translates the server's `session.created` / `transcription.delta`
+ * / `transcription.done` / `error` frames into friendly
+ * `TranscriptionStreamEvent`s and translates caller audio chunks into
+ * base64-encoded `input_audio_buffer.append` frames.
+ *
+ * The SDK 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. Consumers on
+ * those engines must install `ws` alongside `@tryhakim/voice`; we surface
+ * a helpful error if it's missing instead of blowing up with an
+ * opaque module-not-found trace.
+ *
+ * The handle is lazy: the WebSocket opens on the first call to
+ * `sendAudio` / `close` / the first consumer iteration of `events`.
+ * This keeps the hot path fast and avoids dangling connections when a
+ * caller creates a handle but bails before sending anything.
+ */
+import { ConnectionError, HakimError } from '../errors.js';
+import { SDK_NAME, SDK_VERSION } from '../version.js';
+export function openTranscriptionStream(transport, opts) {
+    const url = buildWsUrl(transport.baseURL);
+    const apiKey = transport.apiKey;
+    // Accumulated audio chunks / control frames queued before the socket
+    // is OPEN. Flushed in-order on open.
+    const pending = [];
+    let socket = null;
+    let openPromise = null;
+    const queue = [];
+    let waiter = null;
+    let streamClosed = false;
+    let closedResolve;
+    const closedPromise = new Promise((r) => {
+        closedResolve = r;
+    });
+    function emit(ev) {
+        if (streamClosed)
+            return;
+        if (waiter) {
+            const w = waiter;
+            waiter = null;
+            w({ value: ev, done: false });
+        }
+        else {
+            queue.push(ev);
+        }
+    }
+    function finishStream() {
+        if (streamClosed)
+            return;
+        streamClosed = true;
+        if (waiter) {
+            const w = waiter;
+            waiter = 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}`,
+            };
+            // `ws` on Node takes `{ headers }` as second arg; the browser
+            // `WebSocket` ignores extra args — in the browser the auth has
+            // to come from a subprotocol token. For the SDK-in-Node path we
+            // always have headers available; for custom browser usage, the
+            // caller should pre-construct a socket (future extension point).
+            const s = new Ctor(url, { headers });
+            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 using the caller's opts.
+            const sessionUpdate = buildSessionUpdate(opts);
+            if (sessionUpdate) {
+                s.send(JSON.stringify(sessionUpdate));
+            }
+            // Flush anything queued while we were connecting.
+            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);
+            // Fire-and-forget the open; errors surface on the iterator.
+            ensureOpen().catch((err) => {
+                if (err instanceof HakimError || err instanceof ConnectionError) {
+                    emit({
+                        type: 'error',
+                        code: err.code ?? 'connection_error',
+                        message: err.message,
+                    });
+                }
+                finishStream();
+            });
+        }
+    }
+    function sendAudio(chunk) {
+        if (streamClosed) {
+            throw new HakimError({
+                type: 'invalid_request_error',
+                code: 'stream_closed',
+                message: 'Hakim SDK: cannot send audio; stream is closed.',
+                status: 400,
+                requestId: undefined,
+            });
+        }
+        const bytes = toUint8Array(chunk);
+        const frame = {
+            type: 'input_audio_buffer.append',
+            audio: bufferToBase64(bytes),
+        };
+        const durationMs = estimateAudioMs(bytes.byteLength, opts.sample_rate ?? 16000, opts.audio_format ?? 'pcm16');
+        if (durationMs !== undefined)
+            frame.audio_ms = durationMs;
+        enqueueFrame(JSON.stringify(frame));
+    }
+    async function close() {
+        if (streamClosed)
+            return;
+        // Commit any buffered audio, then ask the server to close.
+        enqueueFrame(JSON.stringify({ type: 'input_audio_buffer.commit' }));
+        enqueueFrame(JSON.stringify({ type: 'session.close' }));
+        // Wait for the server to emit `usage` + close the socket.
+        await closedPromise;
+    }
+    // Wire the caller-supplied AbortSignal to a clean close.
+    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;
+                        // Opening lazily: if the caller started by iterating
+                        // events (without any sendAudio yet), kick the socket
+                        // open so `session.created` / `error` can land.
+                        if (!socket && !openPromise) {
+                            ensureOpen().catch((err) => {
+                                if (!streamClosed) {
+                                    emit({
+                                        type: 'error',
+                                        code: err?.code ?? 'connection_error',
+                                        message: err instanceof Error ? err.message : 'connection error',
+                                    });
+                                    finishStream();
+                                }
+                            });
+                        }
+                    });
+                },
+                return() {
+                    close().catch(() => undefined);
+                    return Promise.resolve({
+                        value: undefined,
+                        done: true,
+                    });
+                },
+            };
+        },
+    };
+    return {
+        sendAudio,
+        events,
+        close,
+        closed: closedPromise,
+    };
+}
+function attachSocketHandlers(s, emit, finishStream) {
+    const onMessage = (raw) => {
+        // In `ws` Node, raw is a Buffer-like; in browsers, raw.data is a
+        // string. Normalise.
+        const text = extractMessageText(raw);
+        if (text === null)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        const translated = translateFrame(parsed);
+        if (translated)
+            emit(translated);
+    };
+    const onClose = () => {
+        finishStream();
+    };
+    addListener(s, 'message', onMessage);
+    addListener(s, 'close', onClose);
+}
+function extractMessageText(raw) {
+    if (typeof raw === 'string')
+        return raw;
+    // Browser MessageEvent: `{ data: string | ArrayBuffer | Blob }`.
+    if (raw && typeof raw === 'object' && 'data' in raw) {
+        const d = raw.data;
+        if (typeof d === 'string')
+            return d;
+        if (d instanceof ArrayBuffer)
+            return new TextDecoder().decode(d);
+        if (ArrayBuffer.isView(d)) {
+            return new TextDecoder().decode(new Uint8Array(d.buffer, d.byteOffset, d.byteLength));
+        }
+        return null;
+    }
+    // `ws` Node 'message' listener receives (data, isBinary) — Buffer.
+    if (raw instanceof Uint8Array)
+        return new TextDecoder().decode(raw);
+    return null;
+}
+function translateFrame(frame) {
+    if (!frame || typeof frame !== 'object')
+        return null;
+    const f = frame;
+    switch (f.type) {
+        case 'transcription.delta': {
+            const d = frame;
+            if (typeof d.text !== 'string')
+                return null;
+            const seq = typeof d.event_id === 'number' ? d.event_id : 0;
+            if (d.is_final === true) {
+                const ev = {
+                    type: 'final',
+                    text: d.text,
+                    seq,
+                };
+                if (typeof d.start_ms === 'number')
+                    ev.start = d.start_ms / 1000;
+                if (typeof d.end_ms === 'number')
+                    ev.end = d.end_ms / 1000;
+                return ev;
+            }
+            const partial = {
+                type: 'partial',
+                text: d.text,
+                seq,
+            };
+            return partial;
+        }
+        case 'transcription.done': {
+            const d = frame;
+            // `transcription.done` carries the final stitched text; expose it
+            // as a `final` event so callers see a single committed snapshot
+            // per commit window.
+            if (typeof d.text === 'string') {
+                const ev = {
+                    type: 'final',
+                    text: d.text,
+                    seq: typeof d.event_id === 'number' ? d.event_id : 0,
+                };
+                if (typeof d.language === 'string')
+                    ev.language = d.language;
+                return ev;
+            }
+            return null;
+        }
+        case 'session.usage':
+        case 'usage': {
+            const d = frame;
+            const seconds = typeof d.seconds === 'number'
+                ? d.seconds
+                : typeof d.audio_ms === 'number'
+                    ? d.audio_ms / 1000
+                    : null;
+            if (seconds === null)
+                return null;
+            const ev = { type: 'usage', seconds };
+            return ev;
+        }
+        case 'error': {
+            const d = frame;
+            return {
+                type: 'error',
+                code: typeof d.code === 'string' ? d.code : 'unknown_error',
+                message: typeof d.message === 'string' ? d.message : 'unknown error',
+            };
+        }
+        case 'session.created':
+            // Informational — don't surface to callers.
+            return null;
+        default:
+            return null;
+    }
+}
+function buildSessionUpdate(opts) {
+    const session = {};
+    if (opts.model !== undefined)
+        session.model = opts.model;
+    if (opts.language !== undefined)
+        session.language = opts.language;
+    if (opts.sample_rate !== undefined)
+        session.input_sample_rate = opts.sample_rate;
+    if (opts.audio_format !== undefined)
+        session.input_audio_format = opts.audio_format;
+    if (Object.keys(session).length === 0)
+        return null;
+    return { type: 'session.update', session };
+}
+function buildWsUrl(baseURL) {
+    const u = new URL(baseURL);
+    u.protocol = u.protocol === 'https:' ? 'wss:' : 'ws:';
+    u.pathname = u.pathname.replace(/\/$/, '') + '/v1/audio/transcriptions/stream';
+    return u.toString();
+}
+function estimateAudioMs(byteLength, sampleRate, format) {
+    if (format === 'pcm16' && sampleRate > 0) {
+        return Math.round((byteLength / 2 / sampleRate) * 1000);
+    }
+    return undefined;
+}
+function toUint8Array(chunk) {
+    if (chunk instanceof Uint8Array)
+        return chunk;
+    if (chunk instanceof ArrayBuffer)
+        return new Uint8Array(chunk);
+    if (ArrayBuffer.isView(chunk)) {
+        return new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+    }
+    throw new HakimError({
+        type: 'invalid_request_error',
+        code: 'invalid_audio_chunk',
+        message: `Hakim SDK: unsupported audio chunk type (${typeof chunk}). Pass a Uint8Array, Buffer, ArrayBuffer, or ArrayBufferView.`,
+        status: 400,
+        requestId: undefined,
+    });
+}
+function bufferToBase64(bytes) {
+    // Node + Bun have Buffer; browsers have btoa. Handle both.
+    if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {
+        return Buffer.from(bytes).toString('base64');
+    }
+    let binary = '';
+    for (let i = 0; i < bytes.byteLength; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+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) {
+    // `ws` supports .off() on EventEmitter; browser WebSocket supports
+    // .removeEventListener(). Support both.
+    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 {
+            // Dynamic import so a bundler building for the browser doesn't
+            // try to statically resolve `ws`.
+            // Dynamic import with a 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 STT 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, estimateAudioMs };
+//# sourceMappingURL=stream.js.map

package/dist/audio/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/audio/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU3D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AActD,MAAM,UAAU,uBAAuB,CACrC,SAAoB,EACpB,IAAgC;IAEhC,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAEhC,qEAAqE;IACrE,qCAAqC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAyB,IAAI,CAAC;IACxC,IAAI,WAAW,GAAkC,IAAI,CAAC;IAEtD,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,IAAI,MAAM,GAAmE,IAAI,CAAC;IAClF,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,aAA0B,CAAC;IAC/B,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;QAC5C,aAAa,GAAG,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,SAAS,IAAI,CAAC,EAA4B;QACxC,IAAI,YAAY;YAAE,OAAO;QACzB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,MAAM,CAAC;YACjB,MAAM,GAAG,IAAI,CAAC;YACd,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,SAAS,YAAY;QACnB,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,MAAM,CAAC;YACjB,MAAM,GAAG,IAAI,CAAC;YACd,CAAC,CAAC,EAAE,KAAK,EAAE,SAAgD,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,aAAa,EAAE,CAAC;IAClB,CAAC;IAED,KAAK,UAAU,UAAU;QACvB,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QAEpC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACvC,MAAM,OAAO,GAA2B;gBACtC,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,YAAY,EAAE,GAAG,QAAQ,IAAI,WAAW,EAAE;aAC3C,CAAC;YACF,8DAA8D;YAC9D,+DAA+D;YAC/D,gEAAgE;YAChE,+DAA+D;YAC/D,iEAAiE;YACjE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAErC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,MAAM,GAAG,GAAS,EAAE;oBACxB,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;gBACF,MAAM,OAAO,GAAG,CAAC,GAAY,EAAQ,EAAE;oBACrC,MAAM,EAAE,CAAC;oBACT,MAAM,CACJ,IAAI,eAAe,CAAC;wBAClB,OAAO,EACL,yCAAyC;4BACzC,GAAG,GAAG,qDAAqD;4BAC3D,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACxD,SAAS,EAAE,SAAS;qBACrB,CAAC,CACH,CAAC;gBACJ,CAAC,CAAC;gBACF,MAAM,MAAM,GAAG,GAAS,EAAE;oBACxB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;oBAClC,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAuC,CAAC,CAAC;gBACtE,CAAC,CAAC;gBACF,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC/B,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC5C,MAAM,GAAG,CAAC,CAAC;YACX,2DAA2D;YAC3D,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,aAAa,EAAE,CAAC;gBAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,kDAAkD;YAClD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,SAAS,YAAY,CAAC,KAAa;QACjC,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,4DAA4D;YAC5D,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,GAAG,YAAY,UAAU,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;oBAChE,IAAI,CAAC;wBACH,IAAI,EAAE,OAAO;wBACb,IAAI,EAAG,GAAyB,CAAC,IAAI,IAAI,kBAAkB;wBAC3D,OAAO,EAAE,GAAG,CAAC,OAAO;qBACrB,CAAC,CAAC;gBACL,CAAC;gBACD,YAAY,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,SAAS,SAAS,CAAC,KAA0D;QAC3E,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,iDAAiD;gBAC1D,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,KAAK,GAA4B;YACrC,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;SAC7B,CAAC;QACF,MAAM,UAAU,GAAG,eAAe,CAChC,KAAK,CAAC,UAAU,EAChB,IAAI,CAAC,WAAW,IAAI,KAAK,EACzB,IAAI,CAAC,YAAY,IAAI,OAAO,CAC7B,CAAC;QACF,IAAI,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC1D,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,UAAU,KAAK;QAClB,IAAI,YAAY;YAAE,OAAO;QACzB,2DAA2D;QAC3D,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC;QACpE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACxD,0DAA0D;QAC1D,MAAM,aAAa,CAAC;IACtB,CAAC;IAED,yDAAyD;IACzD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE;iBACd,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;iBACnB,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAC1B,OAAO,EACP,GAAG,EAAE;gBACH,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACjC,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAA4C;QACtD,CAAC,MAAM,CAAC,aAAa,CAAC;YACpB,OAAO;gBACL,IAAI;oBACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;oBACjE,CAAC;oBACD,IAAI,YAAY,EAAE,CAAC;wBACjB,OAAO,OAAO,CAAC,OAAO,CAAC;4BACrB,KAAK,EAAE,SAAgD;4BACvD,IAAI,EAAE,IAAI;yBACX,CAAC,CAAC;oBACL,CAAC;oBACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;wBAC7B,MAAM,GAAG,OAAO,CAAC;wBACjB,qDAAqD;wBACrD,sDAAsD;wBACtD,gDAAgD;wBAChD,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;4BAC5B,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gCACzB,IAAI,CAAC,YAAY,EAAE,CAAC;oCAClB,IAAI,CAAC;wCACH,IAAI,EAAE,OAAO;wCACb,IAAI,EAAG,GAAyB,EAAE,IAAI,IAAI,kBAAkB;wCAC5D,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;qCACjE,CAAC,CAAC;oCACH,YAAY,EAAE,CAAC;gCACjB,CAAC;4BACH,CAAC,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;oBACJ,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC/B,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,KAAK,EAAE,SAAgD;wBACvD,IAAI,EAAE,IAAI;qBACX,CAAC,CAAC;gBACL,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,SAAS;QACT,MAAM;QACN,KAAK;QACL,MAAM,EAAE,aAAa;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,CAAgB,EAChB,IAA4C,EAC5C,YAAwB;IAExB,MAAM,SAAS,GAAG,CAAC,GAAY,EAAQ,EAAE;QACvC,iEAAiE;QACjE,qBAAqB;QACrB,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,UAAU;YAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,YAAY,EAAE,CAAC;IACjB,CAAC,CAAC;IACF,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACrC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,iEAAiE;IACjE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,CAAC,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,WAAW;YAAE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,mEAAmE;IACnE,IAAI,GAAG,YAAY,UAAU;QAAE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,CAAC,GAAG,KAA2B,CAAC;IACtC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,GAAG,KAMT,CAAC;YACF,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACxB,MAAM,EAAE,GAA4B;oBAClC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG;iBACJ,CAAC;gBACF,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;oBAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACjE,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;oBAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;gBAC3D,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,OAAO,GAA8B;gBACzC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,GAAG;aACJ,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,KAKT,CAAC;YACF,kEAAkE;YAClE,gEAAgE;YAChE,qBAAqB;YACrB,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,EAAE,GAA4B;oBAClC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBACrD,CAAC;gBACF,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;oBAAE,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;gBAC7D,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,eAAe,CAAC;QACrB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,CAAC,GAAG,KAAkD,CAAC;YAC7D,MAAM,OAAO,GACX,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;gBAC3B,CAAC,CAAC,CAAC,CAAC,OAAO;gBACX,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;oBAC9B,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI;oBACnB,CAAC,CAAC,IAAI,CAAC;YACb,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAClC,MAAM,EAAE,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAC/D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,CAAC,GAAG,KAA8C,CAAC;YACzD,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe;gBAC3D,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aACrE,CAAC;QACJ,CAAC;QACD,KAAK,iBAAiB;YACpB,4CAA4C;YAC5C,OAAO,IAAI,CAAC;QACd;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAgC;IAEhC,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAClE,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC;IACjF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,YAAY,CAAC;IACpF,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,iCAAiC,CAAC;IAC/E,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,eAAe,CACtB,UAAkB,EAClB,UAAkB,EAClB,MAAe;IAEf,IAAI,MAAM,KAAK,OAAO,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAA0D;IAC9E,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,4CAA4C,OAAO,KAAK,gEAAgE;QACjI,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,KAAiB;IACvC,2DAA2D;IAC3D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACvE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,WAAW,CAAC,MAAqB,EAAE,IAAY,EAAE,QAA+B;IACvF,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,MAAqB,EACrB,IAAY,EACZ,QAA+B;IAE/B,mEAAmE;IACnE,wCAAwC;IACxC,MAAM,CAAC,GAAG,MAGT,CAAC;IACF,IAAI,CAAC,CAAC,mBAAmB;QAAE,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;SAC5D,IAAI,CAAC,CAAC,GAAG;QAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,IAAI,WAAW,GAAsB,IAAI,CAAC;AAC1C,IAAI,kBAAkB,GAA+B,IAAI,CAAC;AAE1D,KAAK,UAAU,iBAAiB;IAC9B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,kBAAkB;QAAE,OAAO,kBAAkB,CAAC;IAElD,MAAM,QAAQ,GAAI,UAAyC,CAAC,SAAS,CAAC;IACtE,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,GAAG,QAAQ,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,kBAAkB,GAAG,CAAC,KAAK,IAAI,EAAE;QAC/B,IAAI,CAAC;YACH,+DAA+D;YAC/D,kCAAkC;YAClC,4DAA4D;YAC5D,6DAA6D;YAC7D,8DAA8D;YAC9D,MAAM,GAAG,GAAG,MACV,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAGrC,CAAC,IAAI,CAAC,CAAC;YACR,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC;YAC1C,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YACzE,WAAW,GAAG,IAAI,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EACL,oLAAoL;oBACpL,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/dist/audio/to-blob.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 type { AudioInput } from '../types.js';
+export declare function audioInputToBlob(input: AudioInput, filename: string): Promise<Blob>;
+//# sourceMappingURL=to-blob.d.ts.map

package/dist/audio/to-blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-blob.d.ts","sourceRoot":"","sources":["../../src/audio/to-blob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CzF"}