@tryhakim/voice 1.0.0

package/dist/chat/sse.js

@@ -0,0 +1,142 @@
+/**
+ * Server-Sent Events (`text/event-stream`) parser for the chat
+ * completions streaming surface.
+ *
+ * Splits a `ReadableStream<Uint8Array>` from `fetch` into discrete
+ * SSE events (delimited by `\n\n`), then for each event:
+ *
+ *   - skips heartbeat comments (`: …`)
+ *   - parses the `data: …` payload into the caller-supplied chunk
+ *     shape (`ChatCompletionChunk` in practice)
+ *   - terminates on `data: [DONE]`
+ *   - surfaces `event: error\ndata: {…}` payloads as a thrown
+ *     `HakimError` so a mid-stream upstream failure doesn't get
+ *     swallowed by the iterator
+ *
+ * Kept generic on the chunk type so we can reuse it for any future
+ * SSE surface (e.g. a server-events stream on a webhook console)
+ * without copy-paste.
+ */
+import { errorFromPayload, HakimError } from '../errors.js';
+/**
+ * Iterate the SSE wire and yield parsed chunks of type `T`.
+ *
+ * Terminates cleanly on `data: [DONE]` or when the underlying
+ * `ReadableStream` closes. Throws when the wire carries an
+ * `event: error` envelope whose `data` is a Hakim error JSON
+ * payload.
+ */
+export async function* parseSseStream(body, opts = {}) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder('utf-8');
+    let buffered = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                // Flush any tail event the server emitted without the
+                // trailing blank line. Spec-lenient.
+                if (buffered.trim().length > 0) {
+                    const tail = parseSseEvent(buffered, opts.requestId);
+                    if (tail === DONE_SENTINEL)
+                        return;
+                    if (tail !== undefined)
+                        yield tail;
+                }
+                return;
+            }
+            if (value)
+                buffered += decoder.decode(value, { stream: true });
+            // SSE frames are blank-line-delimited (`\n\n`). Slice them
+            // out one at a time so the inner parser sees one frame per
+            // call.
+            let sep = buffered.indexOf('\n\n');
+            while (sep !== -1) {
+                const frame = buffered.slice(0, sep);
+                buffered = buffered.slice(sep + 2);
+                const parsed = parseSseEvent(frame, opts.requestId);
+                if (parsed === DONE_SENTINEL)
+                    return;
+                if (parsed !== undefined)
+                    yield parsed;
+                sep = buffered.indexOf('\n\n');
+            }
+        }
+    }
+    finally {
+        // Release the lock so the underlying stream can be GC'd or
+        // re-used when the caller bails out (e.g. an `await break`
+        // out of the loop or a thrown error).
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            /* already released */
+        }
+    }
+}
+/**
+ * Returned in place of a chunk when the frame was the terminal
+ * `data: [DONE]` marker — signals the outer loop to stop iterating
+ * without yielding `undefined` (which a consumer might mistake for
+ * a real value).
+ */
+const DONE_SENTINEL = Symbol('hakim-sse-done');
+function parseSseEvent(frame, requestId) {
+    let eventType;
+    const dataLines = [];
+    for (const rawLine of frame.split('\n')) {
+        const line = rawLine.replace(/\r$/, '');
+        if (line.length === 0)
+            continue;
+        if (line.startsWith(':'))
+            continue;
+        if (line.startsWith('event:')) {
+            eventType = line.slice(6).trim();
+            continue;
+        }
+        if (line.startsWith('data:')) {
+            dataLines.push(line.slice(5).replace(/^ /, ''));
+            continue;
+        }
+    }
+    if (dataLines.length === 0)
+        return undefined;
+    const payload = dataLines.join('\n');
+    if (payload === '[DONE]')
+        return DONE_SENTINEL;
+    if (eventType === 'error') {
+        let body;
+        try {
+            const parsed = JSON.parse(payload);
+            body = parsed.error;
+        }
+        catch {
+            /* fall through to the unstructured path below */
+        }
+        if (body) {
+            throw errorFromPayload(body, 500, requestId);
+        }
+        throw new HakimError({
+            type: 'service_unavailable',
+            code: 'upstream_error',
+            message: `Hakim SDK: streaming error envelope was not JSON-parseable (${payload.slice(0, 200)}).`,
+            status: 500,
+            requestId,
+        });
+    }
+    try {
+        return JSON.parse(payload);
+    }
+    catch (err) {
+        throw new HakimError({
+            type: 'api_error',
+            code: 'malformed_sse_chunk',
+            message: `Hakim SDK: failed to parse SSE chunk JSON: ${err instanceof Error ? err.message : String(err)}`,
+            status: 500,
+            requestId,
+            cause: err,
+        });
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/chat/sse.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Top-level `Hakim` client. Usage:
+ *
+ *   const hakim = new Hakim({ apiKey: process.env.HAKIM_API_KEY! });
+ *   await hakim.audio.speech.create({ model: 'hakim-fast-v1', … });
+ *
+ * Configurable knobs (all optional):
+ *
+ *   - `baseURL`        — override the API host (defaults to prod).
+ *                         Also reads HAKIM_BASE_URL env var.
+ *   - `timeoutMs`      — per-request timeout. Defaults to 120 s so
+ *                         long TTS synthesis doesn't spuriously abort.
+ *   - `maxRetries`     — transient-failure retries. Defaults to 2.
+ *   - `userAgentSuffix` — appended to the SDK UA (e.g. 'my-app/1.0.0').
+ *   - `fetchImpl`      — inject a custom fetch (for tests or edge runtimes).
+ */
+import { SpeechAPI } from './audio/speech.js';
+import { TranscriptionsAPI } from './audio/transcriptions.js';
+import { TranslateAPI } from './audio/translate.js';
+import { VoicesAPI } from './audio/voices.js';
+import { ChatCompletionsAPI } from './chat/completions.js';
+import { JobsAPI } from './jobs.js';
+import { NotificationsAPI, SettingsAPI } from './settings.js';
+import { Transport } from './transport.js';
+import { UsageAPI } from './usage.js';
+import { WebhooksAPI } from './webhooks.js';
+export interface HakimOptions {
+    apiKey?: string;
+    baseURL?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    userAgentSuffix?: string;
+    fetchImpl?: typeof fetch;
+    /** Internal testing knob: override the random source used for
+     *  backoff jitter. Don't use in application code. */
+    random?: () => number;
+    /** Internal testing knob: override sleep between retries. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Internal testing knob: override idempotency key generation. */
+    generateIdempotencyKey?: () => string;
+}
+export declare class Hakim {
+    readonly audio: {
+        speech: SpeechAPI;
+        transcriptions: TranscriptionsAPI;
+        translate: TranslateAPI;
+        voices: VoicesAPI;
+    };
+    readonly voices: VoicesAPI;
+    readonly chat: {
+        completions: ChatCompletionsAPI;
+    };
+    readonly usage: UsageAPI;
+    readonly webhooks: WebhooksAPI;
+    readonly jobs: JobsAPI;
+    readonly settings: SettingsAPI;
+    readonly notifications: NotificationsAPI;
+    /** Expose the transport for advanced callers (custom endpoints,
+     *  debugging). Stability of this interface is NOT guaranteed. */
+    readonly _transport: Transport;
+    constructor(options?: HakimOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;yDACqD;IACrD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,MAAM,MAAM,CAAC;CACvC;AAED,qBAAa,KAAK;IAChB,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,SAAS,CAAC;QAClB,cAAc,EAAE,iBAAiB,CAAC;QAClC,SAAS,EAAE,YAAY,CAAC;QACxB,MAAM,EAAE,SAAS,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE;QACb,WAAW,EAAE,kBAAkB,CAAC;KACjC,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAEzC;qEACiE;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;gBAEnB,OAAO,GAAE,YAAiB;CA2CvC"}

package/dist/client.js

@@ -0,0 +1,80 @@
+/**
+ * Top-level `Hakim` client. Usage:
+ *
+ *   const hakim = new Hakim({ apiKey: process.env.HAKIM_API_KEY! });
+ *   await hakim.audio.speech.create({ model: 'hakim-fast-v1', … });
+ *
+ * Configurable knobs (all optional):
+ *
+ *   - `baseURL`        — override the API host (defaults to prod).
+ *                         Also reads HAKIM_BASE_URL env var.
+ *   - `timeoutMs`      — per-request timeout. Defaults to 120 s so
+ *                         long TTS synthesis doesn't spuriously abort.
+ *   - `maxRetries`     — transient-failure retries. Defaults to 2.
+ *   - `userAgentSuffix` — appended to the SDK UA (e.g. 'my-app/1.0.0').
+ *   - `fetchImpl`      — inject a custom fetch (for tests or edge runtimes).
+ */
+import { SpeechAPI } from './audio/speech.js';
+import { TranscriptionsAPI } from './audio/transcriptions.js';
+import { TranslateAPI } from './audio/translate.js';
+import { VoicesAPI } from './audio/voices.js';
+import { ChatCompletionsAPI } from './chat/completions.js';
+import { JobsAPI } from './jobs.js';
+import { NotificationsAPI, SettingsAPI } from './settings.js';
+import { Transport } from './transport.js';
+import { UsageAPI } from './usage.js';
+import { WebhooksAPI } from './webhooks.js';
+const DEFAULT_BASE_URL = 'https://api.tryhakim.ai';
+const DEFAULT_TIMEOUT_MS = 120_000;
+const DEFAULT_MAX_RETRIES = 2;
+export class Hakim {
+    audio;
+    voices;
+    chat;
+    usage;
+    webhooks;
+    jobs;
+    settings;
+    notifications;
+    /** Expose the transport for advanced callers (custom endpoints,
+     *  debugging). Stability of this interface is NOT guaranteed. */
+    _transport;
+    constructor(options = {}) {
+        const env = typeof process !== 'undefined' ? (process.env ?? {}) : {};
+        const apiKey = options.apiKey ?? env.HAKIM_API_KEY ?? env.HAKIM_API_TOKEN;
+        if (!apiKey) {
+            throw new TypeError('Hakim SDK: missing API key. Pass `apiKey` to new Hakim({...}) or set the HAKIM_API_KEY env var.');
+        }
+        const baseURL = options.baseURL ?? env.HAKIM_BASE_URL ?? DEFAULT_BASE_URL;
+        this._transport = new Transport({
+            apiKey,
+            baseURL,
+            timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+            maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES,
+            userAgentSuffix: options.userAgentSuffix,
+            ...(options.fetchImpl !== undefined ? { fetchImpl: options.fetchImpl } : {}),
+            ...(options.random !== undefined ? { random: options.random } : {}),
+            ...(options.sleep !== undefined ? { sleep: options.sleep } : {}),
+            ...(options.generateIdempotencyKey !== undefined
+                ? { generateIdempotencyKey: options.generateIdempotencyKey }
+                : {}),
+        });
+        const voicesApi = new VoicesAPI(this._transport);
+        this.audio = {
+            speech: new SpeechAPI(this._transport),
+            transcriptions: new TranscriptionsAPI(this._transport),
+            translate: new TranslateAPI(this._transport),
+            voices: voicesApi,
+        };
+        this.voices = voicesApi;
+        this.chat = {
+            completions: new ChatCompletionsAPI(this._transport),
+        };
+        this.usage = new UsageAPI(this._transport);
+        this.webhooks = new WebhooksAPI(this._transport);
+        this.jobs = new JobsAPI(this._transport);
+        this.settings = new SettingsAPI(this._transport);
+        this.notifications = new NotificationsAPI(this._transport);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,99 @@
+/**
+ * SDK error hierarchy (mirrors `@hakim/schemas` `ApiError.type` values).
+ *
+ * Every HTTP-level failure surfaces as a `HakimError` subclass so callers
+ * can `instanceof` on either the base class or a specific subclass:
+ *
+ *   try {
+ *     await hakim.audio.speech.create({ … });
+ *   } catch (err) {
+ *     if (err instanceof RateLimitError) await sleep(err.retryAfterMs);
+ *     else if (err instanceof HakimError) console.error(err.requestId, err);
+ *     else throw err;
+ *   }
+ *
+ * Transport-level failures (DNS, connection reset, AbortError) are
+ * wrapped in `ConnectionError` so the caller never has to distinguish
+ * them from Node's own error strings.
+ */
+export type HakimErrorType = 'invalid_request_error' | 'authentication_error' | 'permission_error' | 'not_found' | 'rate_limit_error' | 'quota_exceeded' | 'api_error' | 'service_unavailable' | 'idempotency_conflict' | 'connection_error';
+export interface HakimApiErrorPayload {
+    type: HakimErrorType;
+    code: string;
+    message: string;
+    param?: string;
+    request_id?: string;
+    retry_after_seconds?: number;
+    upgrade_url?: string;
+    docs_url?: string;
+}
+export interface HakimErrorInit {
+    type: HakimErrorType;
+    code: string;
+    message: string;
+    status: number;
+    requestId: string | undefined;
+    param?: string;
+    cause?: unknown;
+    retryAfterMs?: number;
+    retryAfterSeconds?: number;
+    upgradeUrl?: string;
+    docsUrl?: string;
+}
+export declare class HakimError extends Error {
+    readonly type: HakimErrorType;
+    readonly code: string;
+    readonly status: number;
+    readonly requestId: string | undefined;
+    readonly param: string | undefined;
+    readonly cause: unknown;
+    /** For 429 / 503: milliseconds the server asked us to wait. */
+    readonly retryAfterMs: number | undefined;
+    constructor(init: HakimErrorInit);
+}
+export declare class InvalidRequestError extends HakimError {
+    constructor(init: HakimErrorInit);
+}
+export declare class AuthenticationError extends HakimError {
+    constructor(init: HakimErrorInit);
+}
+export declare class PermissionError extends HakimError {
+    /**
+     * M3 Phase 11 — set when the caller hit the Free-tier paywall
+     * (code === 'feature_requires_paid_plan'). Consumers can deep-link
+     * users to the billing page without re-parsing the payload.
+     */
+    readonly upgradeUrl: string | undefined;
+    /** Docs link explaining the specific restriction. */
+    readonly docsUrl: string | undefined;
+    constructor(init: HakimErrorInit);
+}
+export declare class NotFoundError extends HakimError {
+    constructor(init: HakimErrorInit);
+}
+export declare class QuotaExceededError extends HakimError {
+    /** Server-suggested seconds until retry. Mirrors `Retry-After`. */
+    readonly retryAfterSeconds: number | undefined;
+    /** Dashboard link to upgrade plan / update payment method. */
+    readonly upgradeUrl: string | undefined;
+    /** Docs link explaining the specific 402 reason code. */
+    readonly docsUrl: string | undefined;
+    constructor(init: HakimErrorInit);
+}
+export declare class RateLimitError extends HakimError {
+    constructor(init: HakimErrorInit);
+}
+export declare class IdempotencyConflictError extends HakimError {
+    constructor(init: HakimErrorInit);
+}
+export declare class ServiceUnavailableError extends HakimError {
+    constructor(init: HakimErrorInit);
+}
+export declare class ConnectionError extends HakimError {
+    constructor(init: Omit<HakimErrorInit, 'type' | 'code' | 'status'> & {
+        code?: string;
+    });
+}
+/** Factory: construct the right subclass from the wire payload. */
+export declare function errorFromPayload(payload: HakimApiErrorPayload, status: number, requestId: string | undefined, retryAfterMs?: number): HakimError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,158 @@
+/**
+ * SDK error hierarchy (mirrors `@hakim/schemas` `ApiError.type` values).
+ *
+ * Every HTTP-level failure surfaces as a `HakimError` subclass so callers
+ * can `instanceof` on either the base class or a specific subclass:
+ *
+ *   try {
+ *     await hakim.audio.speech.create({ … });
+ *   } catch (err) {
+ *     if (err instanceof RateLimitError) await sleep(err.retryAfterMs);
+ *     else if (err instanceof HakimError) console.error(err.requestId, err);
+ *     else throw err;
+ *   }
+ *
+ * Transport-level failures (DNS, connection reset, AbortError) are
+ * wrapped in `ConnectionError` so the caller never has to distinguish
+ * them from Node's own error strings.
+ */
+export class HakimError extends Error {
+    type;
+    code;
+    status;
+    requestId;
+    param;
+    cause;
+    /** For 429 / 503: milliseconds the server asked us to wait. */
+    retryAfterMs;
+    constructor(init) {
+        super(init.message);
+        this.name = 'HakimError';
+        this.type = init.type;
+        this.code = init.code;
+        this.status = init.status;
+        this.requestId = init.requestId;
+        this.param = init.param;
+        this.cause = init.cause;
+        this.retryAfterMs = init.retryAfterMs;
+    }
+}
+export class InvalidRequestError extends HakimError {
+    constructor(init) {
+        super(init);
+        this.name = 'InvalidRequestError';
+    }
+}
+export class AuthenticationError extends HakimError {
+    constructor(init) {
+        super(init);
+        this.name = 'AuthenticationError';
+    }
+}
+export class PermissionError extends HakimError {
+    /**
+     * M3 Phase 11 — set when the caller hit the Free-tier paywall
+     * (code === 'feature_requires_paid_plan'). Consumers can deep-link
+     * users to the billing page without re-parsing the payload.
+     */
+    upgradeUrl;
+    /** Docs link explaining the specific restriction. */
+    docsUrl;
+    constructor(init) {
+        super(init);
+        this.name = 'PermissionError';
+        this.upgradeUrl = init.upgradeUrl;
+        this.docsUrl = init.docsUrl;
+    }
+}
+export class NotFoundError extends HakimError {
+    constructor(init) {
+        super(init);
+        this.name = 'NotFoundError';
+    }
+}
+export class QuotaExceededError extends HakimError {
+    /** Server-suggested seconds until retry. Mirrors `Retry-After`. */
+    retryAfterSeconds;
+    /** Dashboard link to upgrade plan / update payment method. */
+    upgradeUrl;
+    /** Docs link explaining the specific 402 reason code. */
+    docsUrl;
+    constructor(init) {
+        super(init);
+        this.name = 'QuotaExceededError';
+        this.retryAfterSeconds = init.retryAfterSeconds;
+        this.upgradeUrl = init.upgradeUrl;
+        this.docsUrl = init.docsUrl;
+    }
+}
+export class RateLimitError extends HakimError {
+    constructor(init) {
+        super(init);
+        this.name = 'RateLimitError';
+    }
+}
+export class IdempotencyConflictError extends HakimError {
+    constructor(init) {
+        super(init);
+        this.name = 'IdempotencyConflictError';
+    }
+}
+export class ServiceUnavailableError extends HakimError {
+    constructor(init) {
+        super(init);
+        this.name = 'ServiceUnavailableError';
+    }
+}
+export class ConnectionError extends HakimError {
+    constructor(init) {
+        super({
+            type: 'connection_error',
+            code: init.code ?? 'connection_failed',
+            message: init.message,
+            status: 0,
+            requestId: init.requestId,
+            cause: init.cause,
+        });
+        this.name = 'ConnectionError';
+    }
+}
+/** Factory: construct the right subclass from the wire payload. */
+export function errorFromPayload(payload, status, requestId, retryAfterMs) {
+    const init = {
+        type: payload.type,
+        code: payload.code,
+        message: payload.message,
+        status,
+        requestId: payload.request_id ?? requestId,
+        ...(payload.param !== undefined ? { param: payload.param } : {}),
+        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+        ...(payload.retry_after_seconds !== undefined
+            ? { retryAfterSeconds: payload.retry_after_seconds }
+            : {}),
+        ...(payload.upgrade_url !== undefined ? { upgradeUrl: payload.upgrade_url } : {}),
+        ...(payload.docs_url !== undefined ? { docsUrl: payload.docs_url } : {}),
+    };
+    switch (payload.type) {
+        case 'invalid_request_error':
+            return new InvalidRequestError(init);
+        case 'authentication_error':
+            return new AuthenticationError(init);
+        case 'permission_error':
+            return new PermissionError(init);
+        case 'not_found':
+            return new NotFoundError(init);
+        case 'quota_exceeded':
+            return new QuotaExceededError(init);
+        case 'rate_limit_error':
+            return new RateLimitError(init);
+        case 'idempotency_conflict':
+            return new IdempotencyConflictError(init);
+        case 'service_unavailable':
+            return new ServiceUnavailableError(init);
+        case 'api_error':
+        default:
+            return new HakimError(init);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA2CH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,IAAI,CAAS;IACb,MAAM,CAAS;IACf,SAAS,CAAqB;IAC9B,KAAK,CAAqB;IACjB,KAAK,CAAU;IACjC,+DAA+D;IACtD,YAAY,CAAqB;IAE1C,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C;;;;OAIG;IACM,UAAU,CAAqB;IACxC,qDAAqD;IAC5C,OAAO,CAAqB;IAErC,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,mEAAmE;IAC1D,iBAAiB,CAAqB;IAC/C,8DAA8D;IACrD,UAAU,CAAqB;IACxC,yDAAyD;IAChD,OAAO,CAAqB;IAErC,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACtD,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,IAA0E;QACpF,KAAK,CAAC;YACJ,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,mBAAmB;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAC9B,OAA6B,EAC7B,MAAc,EACd,SAA6B,EAC7B,YAAqB;IAErB,MAAM,IAAI,GAAmB;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM;QACN,SAAS,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC1C,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,mBAAmB,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;IACF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,uBAAuB;YAC1B,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACvC,KAAK,sBAAsB;YACzB,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACvC,KAAK,kBAAkB;YACrB,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,WAAW;YACd,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,gBAAgB;YACnB,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,kBAAkB;YACrB,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,sBAAsB;YACzB,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC5C,KAAK,qBAAqB;YACxB,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,WAAW,CAAC;QACjB;YACE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `@tryhakim/voice` — official Hakim API client for Node.js.
+ *
+ *   import { Hakim } from '@tryhakim/voice';
+ *
+ *   const hakim = new Hakim({ apiKey: process.env.HAKIM_API_KEY });
+ *   const speech = await hakim.audio.speech.create({
+ *     model: 'hakim-fast-v1',
+ *     input: 'مرحبا بالعالم',
+ *     // Pass the `id` from `hakim.audio.voices.list()` for stable
+ *     // production traffic. Slugs (e.g. `'omar'`) are accepted but
+ *     // are best for prototyping — they may collide between presets
+ *     // and clones, and may shift if the voice catalogue is renamed.
+ *     voice: 'cmokbc2b1001pvu39wmj61b7h',
+ *   });
+ *
+ * See the package README for a tour of every namespace.
+ */
+export { Hakim, type HakimOptions } from './client.js';
+export { HakimError, InvalidRequestError, AuthenticationError, PermissionError, NotFoundError, QuotaExceededError, RateLimitError, IdempotencyConflictError, ServiceUnavailableError, ConnectionError, type HakimErrorType, type HakimApiErrorPayload, } from './errors.js';
+export type { SpeechRequest, TranscriptionRequest, TranscriptionRequestCommon, TranscriptionStreamOptions, TranscriptionStreamHandle, TranscriptionStreamEvent, TranscriptionPartialEvent, TranscriptionFinalEvent, TranscriptionUsageEvent, TranscriptionErrorEvent, SpeechStreamOptions, SpeechStreamCreateRequest, SpeechStreamHandle, SpeechStreamEvent, SpeechStreamStartedEvent, SpeechStreamAudioEvent, SpeechStreamDoneEvent, SpeechStreamUsageEvent, SpeechStreamErrorEvent, TranslateStreamOptions, TranslateStreamHandle, TranslateStreamEvent, TranslateStreamCreatedEvent, TranslateStreamTranscriptionDeltaEvent, TranslateStreamTranscriptionDoneEvent, TranslateStreamTranslationDeltaEvent, TranslateStreamTranslationDoneEvent, TranslateStreamSpeechStartedEvent, TranslateStreamSpeechAudioEvent, TranslateStreamSpeechDoneEvent, TranslateStreamSessionUsageEvent, TranslateStreamErrorEvent, VoicesListQuery, VoiceCreateRequest, UsageEventsQuery, AudioInput, ChatModel, ChatRole, ChatMessage, ChatMessageContent, ChatTextContentPart, ChatReasoningOption, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChoice, ChatCompletionChunk, ChatCompletionChunkChoice, ChatCompletionChunkDelta, ChatCompletionUsage, ChatFinishReason, Webhook, WebhookCreated, WebhookCreateRequest, WebhookUpdateRequest, WebhooksListResponse, WebhookDelivery, WebhookDeliveriesListQuery, WebhookDeliveriesListResponse, WebhookDeliveryStatus, WebhookEventKey, Job, JobType, JobStatus, JobsListQuery, JobsListResponse, SpeechResponse, SpeechStreamResponse, TranscriptionResult, TranscriptionJsonResponse, TranscriptionAsyncAccepted, VoicesListResponse, Voice, UsageSummary, UsageEvent, UsageEventsList, ResponseMeta, TTSModel, ResponseFormat, SampleRate, STTModel, } from './types.js';
+export { DEFAULT_TTS_MODEL, DEFAULT_STT_MODEL } from './types.js';
+export type { STTResponseFormat, STTTimestamps, STTLanguage, BaseLanguageCode, ArabicDialectCode, VoiceKind, VoiceLanguage, VoiceGender, VoiceStatus, UsageKind, Profile, ProfileUpdateRequest, OrganizationSettings, OrganizationSettingsUpdateRequest, NotificationPreferences, NotificationPreferencesUpdateRequest, UserLocale, } from './types.js';
+export { verifyWebhookSignature, type VerifyWebhookSignatureOptions, type WebhookSignatureVerifyResult, } from './webhooks.js';
+export { ChatCompletionsAPI, type ChatCompletionCreateResponse, type ChatCompletionStreamResponse, type StreamingUsagePreflight, } from './chat/index.js';
+export { SDK_VERSION, SDK_NAME } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAEV,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,sCAAsC,EACtC,qCAAqC,EACrC,oCAAoC,EACpC,mCAAmC,EACnC,iCAAiC,EACjC,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EAEV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAEhB,OAAO,EACP,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,6BAA6B,EAC7B,qBAAqB,EACrB,eAAe,EAEf,GAAG,EACH,OAAO,EACP,SAAS,EACT,aAAa,EACb,gBAAgB,EAEhB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,EAClB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EAEZ,QAAQ,EACR,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EAET,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,iCAAiC,EACjC,uBAAuB,EACvB,oCAAoC,EACpC,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,GAClC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@tryhakim/voice` — official Hakim API client for Node.js.
+ *
+ *   import { Hakim } from '@tryhakim/voice';
+ *
+ *   const hakim = new Hakim({ apiKey: process.env.HAKIM_API_KEY });
+ *   const speech = await hakim.audio.speech.create({
+ *     model: 'hakim-fast-v1',
+ *     input: 'مرحبا بالعالم',
+ *     // Pass the `id` from `hakim.audio.voices.list()` for stable
+ *     // production traffic. Slugs (e.g. `'omar'`) are accepted but
+ *     // are best for prototyping — they may collide between presets
+ *     // and clones, and may shift if the voice catalogue is renamed.
+ *     voice: 'cmokbc2b1001pvu39wmj61b7h',
+ *   });
+ *
+ * See the package README for a tour of every namespace.
+ */
+export { Hakim } from './client.js';
+export { HakimError, InvalidRequestError, AuthenticationError, PermissionError, NotFoundError, QuotaExceededError, RateLimitError, IdempotencyConflictError, ServiceUnavailableError, ConnectionError, } from './errors.js';
+export { DEFAULT_TTS_MODEL, DEFAULT_STT_MODEL } from './types.js';
+export { verifyWebhookSignature, } from './webhooks.js';
+export { ChatCompletionsAPI, } from './chat/index.js';
+export { SDK_VERSION, SDK_NAME } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,GAGhB,MAAM,aAAa,CAAC;AAyFrB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqBlE,OAAO,EACL,sBAAsB,GAGvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,GAInB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}