@tryhakim/voice 1.0.0

package/dist/jobs.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `jobs` — public `/v1/jobs` list + retrieve.
+ *
+ *   GET /v1/jobs            → paginated list for the caller's org
+ *   GET /v1/jobs/:id        → fetch one job (result_url on success)
+ *
+ * The server cursor-paginates on `(createdAt desc, id desc)` so
+ * `has_more` + `next_cursor` ride alongside the data array.
+ *
+ * The SDK does NOT auto-download `result_url`. Callers get a fresh
+ * signed URL on every `retrieve()` call (TTL is 24 h server-side);
+ * downloading is a plain `fetch(result_url)` away. The `iter()`
+ * helper below walks all pages and is the canonical "fetch everything
+ * newer than my bookmark" affordance.
+ */
+import type { Transport } from './transport.js';
+import type { Job, JobsListQuery, JobsListResponse } from './types.js';
+export declare class JobsAPI {
+    private readonly transport;
+    constructor(transport: Transport);
+    list(query?: JobsListQuery, opts?: {
+        signal?: AbortSignal;
+    }): Promise<JobsListResponse>;
+    retrieve(id: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Job>;
+    /** Walk every job page-by-page. Stops once the server reports
+     *  `has_more: false`. Passes the original filter + limit through
+     *  unchanged; only `cursor` advances. */
+    iter(query?: JobsListQuery, opts?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<Job>;
+}
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvE,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE3C,IAAI,CACR,KAAK,GAAE,aAAkB,EACzB,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAClC,OAAO,CAAC,gBAAgB,CAAC;IAgBtB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAS7E;;6CAEyC;IAClC,IAAI,CAAC,KAAK,GAAE,aAAkB,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,aAAa,CAAC,GAAG,CAAC;CAShG"}

package/dist/jobs.js

@@ -0,0 +1,62 @@
+/**
+ * `jobs` — public `/v1/jobs` list + retrieve.
+ *
+ *   GET /v1/jobs            → paginated list for the caller's org
+ *   GET /v1/jobs/:id        → fetch one job (result_url on success)
+ *
+ * The server cursor-paginates on `(createdAt desc, id desc)` so
+ * `has_more` + `next_cursor` ride alongside the data array.
+ *
+ * The SDK does NOT auto-download `result_url`. Callers get a fresh
+ * signed URL on every `retrieve()` call (TTL is 24 h server-side);
+ * downloading is a plain `fetch(result_url)` away. The `iter()`
+ * helper below walks all pages and is the canonical "fetch everything
+ * newer than my bookmark" affordance.
+ */
+export class JobsAPI {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async list(query = {}, opts = {}) {
+        const q = {};
+        if (query.status !== undefined)
+            q.status = query.status;
+        if (query.type !== undefined)
+            q.type = query.type;
+        if (query.limit !== undefined)
+            q.limit = query.limit;
+        if (query.cursor !== undefined)
+            q.cursor = query.cursor;
+        const res = await this.transport.request({
+            method: 'GET',
+            path: '/v1/jobs',
+            query: q,
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+    async retrieve(id, opts = {}) {
+        const res = await this.transport.request({
+            method: 'GET',
+            path: `/v1/jobs/${encodeURIComponent(id)}`,
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+    /** Walk every job page-by-page. Stops once the server reports
+     *  `has_more: false`. Passes the original filter + limit through
+     *  unchanged; only `cursor` advances. */
+    async *iter(query = {}, opts = {}) {
+        let cursor = query.cursor;
+        while (true) {
+            const page = await this.list({ ...query, ...(cursor !== undefined ? { cursor } : {}) }, opts);
+            for (const j of page.data)
+                yield j;
+            if (!page.has_more || !page.next_cursor)
+                return;
+            cursor = page.next_cursor;
+        }
+    }
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,KAAK,CAAC,IAAI,CACR,QAAuB,EAAE,EACzB,OAAiC,EAAE;QAEnC,MAAM,CAAC,GAAgD,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACxD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAClD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACrD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAExD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqB,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAiC,EAAE;QAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAC1C,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAQ,CAAC;IACnC,CAAC;IAED;;6CAEyC;IACzC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAuB,EAAE,EAAE,OAAiC,EAAE;QACxE,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9F,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW;gBAAE,OAAO;YAChD,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/observability.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `observability` — parse the `x-hakim-*` response headers into typed
+ * shapes mirroring `@hakim/schemas/observability.ts`.
+ *
+ * The server stamps every successful TTS / STT response with the
+ * canonical observability header set. Customers integrating with
+ * `Snowpipe`/`BigQuery`/`Splunk` can copy the headers into a warehouse
+ * directly, but in-process callers usually want a typed object on the
+ * response · these helpers do that lift without forcing every caller
+ * to remember the header names.
+ *
+ * The header names are the contract; we intentionally hard-code them
+ * here (rather than importing `OBSERVABILITY_HEADERS` from
+ * `@hakim/schemas`) so the SDK stays publishable stand-alone. The
+ * drift test in `openapi-drift.test.ts` keeps the header surface in
+ * lockstep with the Zod source.
+ */
+import type { SpeechResponseLimits, UsageBlock } from './types.js';
+/** Decode the `x-hakim-usage-*` family into a `UsageBlock`. Returns
+ *  `undefined` when any required header is missing · the server emits
+ *  the full set atomically, so a partial set means we're talking to a
+ *  pre-observability API (or a non-billable surface). */
+export declare function parseUsageBlockFromHeaders(headers: Headers): UsageBlock | undefined;
+/** Decode the period + credits + concurrency snapshot a response
+ *  carries on its headers. The rate-limit dimension is dropped on
+ *  purpose · see `SpeechResponseLimits` docblock. */
+export declare function parseLimitsFromHeaders(headers: Headers): SpeechResponseLimits | undefined;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAKV,oBAAoB,EACpB,UAAU,EAEX,MAAM,YAAY,CAAC;AAEpB;;;yDAGyD;AACzD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAkCnF;AAED;;qDAEqD;AACrD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAsCzF"}

package/dist/observability.js

@@ -0,0 +1,107 @@
+/** Decode the `x-hakim-usage-*` family into a `UsageBlock`. Returns
+ *  `undefined` when any required header is missing · the server emits
+ *  the full set atomically, so a partial set means we're talking to a
+ *  pre-observability API (or a non-billable surface). */
+export function parseUsageBlockFromHeaders(headers) {
+    const kind = readKind(headers.get('x-hakim-usage-kind'));
+    const units = readInt(headers.get('x-hakim-usage-units'));
+    const unitType = readUnitType(headers.get('x-hakim-usage-unit-type'));
+    const credits = readInt(headers.get('x-hakim-usage-credits'));
+    const cost = headers.get('x-hakim-usage-cost-usd');
+    const requestId = headers.get('x-request-id');
+    const periodStart = headers.get('x-hakim-period-start');
+    const periodEnd = headers.get('x-hakim-period-end');
+    if (kind === undefined ||
+        units === undefined ||
+        unitType === undefined ||
+        credits === undefined ||
+        cost === null ||
+        requestId === null ||
+        periodStart === null ||
+        periodEnd === null) {
+        return undefined;
+    }
+    return {
+        request_id: requestId,
+        kind,
+        units,
+        unit_type: unitType,
+        credits,
+        cost_usd: cost,
+        model: headers.get('x-hakim-model'),
+        billing_period_start: periodStart,
+        billing_period_end: periodEnd,
+    };
+}
+/** Decode the period + credits + concurrency snapshot a response
+ *  carries on its headers. The rate-limit dimension is dropped on
+ *  purpose · see `SpeechResponseLimits` docblock. */
+export function parseLimitsFromHeaders(headers) {
+    const planId = headers.get('x-hakim-plan-id');
+    const periodStart = headers.get('x-hakim-period-start');
+    const periodEnd = headers.get('x-hakim-period-end');
+    const included = readInt(headers.get('x-hakim-credits-included'));
+    const used = readInt(headers.get('x-hakim-credits-used'));
+    const remaining = readInt(headers.get('x-hakim-credits-remaining'));
+    const effective = readInt(headers.get('x-hakim-credits-effective-limit'));
+    const concLimit = readInt(headers.get('x-hakim-concurrency-limit'));
+    const concCurrent = readInt(headers.get('x-hakim-concurrency-current'));
+    if (!planId ||
+        !periodStart ||
+        !periodEnd ||
+        included === undefined ||
+        used === undefined ||
+        remaining === undefined ||
+        effective === undefined ||
+        concLimit === undefined ||
+        concCurrent === undefined) {
+        return undefined;
+    }
+    const plan = {
+        id: planId,
+        name: planId,
+        // The header set doesn't carry the overage-mode literal · use
+        // `topup` (the current default) so the shape parses cleanly.
+        // Callers that need the authoritative overage-mode should call
+        // `usage.limits()`.
+        overage_mode: 'topup',
+    };
+    const period = { start: periodStart, end: periodEnd };
+    const credits = { included, used, remaining, effective_limit: effective };
+    const concurrency = { limit: concLimit, current: concCurrent };
+    return { plan, period, credits, concurrency };
+}
+function readInt(raw) {
+    if (raw === null)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0)
+        return undefined;
+    return Math.floor(n);
+}
+const KIND_VALUES = new Set([
+    'tts',
+    'stt_batch',
+    'stt_realtime',
+    'voice_clone',
+    'video_studio',
+    'llm_chat',
+]);
+function readKind(raw) {
+    if (raw === null)
+        return undefined;
+    return KIND_VALUES.has(raw) ? raw : undefined;
+}
+const UNIT_TYPE_VALUES = new Set([
+    'characters',
+    'seconds',
+    'count',
+    'credits',
+    'tokens',
+]);
+function readUnitType(raw) {
+    if (raw === null)
+        return undefined;
+    return UNIT_TYPE_VALUES.has(raw) ? raw : undefined;
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `client.settings.*` + `client.notifications.*` — M2 follow-up surface.
+ *
+ * Thin fetch wrappers around the public `/v1/settings/*` and
+ * `/v1/notifications` endpoints. Both hang off the same bearer-auth
+ * transport as the rest of the SDK; the server scopes reads to
+ * `settings:read` and writes to `settings:write`.
+ *
+ * The "profile" and "notifications" endpoints target the API-key
+ * creator user, while "organization" targets the key's org. The
+ * resulting DX is:
+ *
+ *   const me   = await hakim.settings.getProfile();
+ *   const org  = await hakim.settings.getOrganization();
+ *   const prefs = await hakim.notifications.get();
+ *
+ *   await hakim.settings.updateProfile({ locale: 'en' });
+ *   await hakim.settings.updateOrganization({ name: 'Acme Corp' });
+ *   await hakim.notifications.update({ product_updates: true });
+ */
+import type { Transport } from './transport.js';
+import type { NotificationPreferences, NotificationPreferencesUpdateRequest, OrganizationSettings, OrganizationSettingsUpdateRequest, Profile, ProfileUpdateRequest } from './types.js';
+export declare class SettingsAPI {
+    private readonly transport;
+    constructor(transport: Transport);
+    getProfile(opts?: {
+        signal?: AbortSignal;
+    }): Promise<Profile>;
+    updateProfile(patch: ProfileUpdateRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Profile>;
+    getOrganization(opts?: {
+        signal?: AbortSignal;
+    }): Promise<OrganizationSettings>;
+    updateOrganization(patch: OrganizationSettingsUpdateRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<OrganizationSettings>;
+}
+export declare class NotificationsAPI {
+    private readonly transport;
+    constructor(transport: Transport);
+    get(opts?: {
+        signal?: AbortSignal;
+    }): Promise<NotificationPreferences>;
+    update(patch: NotificationPreferencesUpdateRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<NotificationPreferences>;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,uBAAuB,EACvB,oCAAoC,EACpC,oBAAoB,EACpB,iCAAiC,EACjC,OAAO,EACP,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE3C,UAAU,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IASjE,aAAa,CACjB,KAAK,EAAE,oBAAoB,EAC3B,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAClC,OAAO,CAAC,OAAO,CAAC;IAUb,eAAe,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;IASnF,kBAAkB,CACtB,KAAK,EAAE,iCAAiC,EACxC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAClC,OAAO,CAAC,oBAAoB,CAAC;CASjC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE3C,GAAG,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAS1E,MAAM,CACV,KAAK,EAAE,oCAAoC,EAC3C,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAClC,OAAO,CAAC,uBAAuB,CAAC;CASpC"}

package/dist/settings.js

@@ -0,0 +1,84 @@
+/**
+ * `client.settings.*` + `client.notifications.*` — M2 follow-up surface.
+ *
+ * Thin fetch wrappers around the public `/v1/settings/*` and
+ * `/v1/notifications` endpoints. Both hang off the same bearer-auth
+ * transport as the rest of the SDK; the server scopes reads to
+ * `settings:read` and writes to `settings:write`.
+ *
+ * The "profile" and "notifications" endpoints target the API-key
+ * creator user, while "organization" targets the key's org. The
+ * resulting DX is:
+ *
+ *   const me   = await hakim.settings.getProfile();
+ *   const org  = await hakim.settings.getOrganization();
+ *   const prefs = await hakim.notifications.get();
+ *
+ *   await hakim.settings.updateProfile({ locale: 'en' });
+ *   await hakim.settings.updateOrganization({ name: 'Acme Corp' });
+ *   await hakim.notifications.update({ product_updates: true });
+ */
+export class SettingsAPI {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async getProfile(opts = {}) {
+        const res = await this.transport.request({
+            method: 'GET',
+            path: '/v1/settings/profile',
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+    async updateProfile(patch, opts = {}) {
+        const res = await this.transport.request({
+            method: 'PATCH',
+            path: '/v1/settings/profile',
+            json: patch,
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+    async getOrganization(opts = {}) {
+        const res = await this.transport.request({
+            method: 'GET',
+            path: '/v1/settings/organization',
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+    async updateOrganization(patch, opts = {}) {
+        const res = await this.transport.request({
+            method: 'PATCH',
+            path: '/v1/settings/organization',
+            json: patch,
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+}
+export class NotificationsAPI {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async get(opts = {}) {
+        const res = await this.transport.request({
+            method: 'GET',
+            path: '/v1/notifications',
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+    async update(patch, opts = {}) {
+        const res = await this.transport.request({
+            method: 'PATCH',
+            path: '/v1/notifications',
+            json: patch,
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        return (await res.json());
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,82 @@
+/**
+ * HTTP transport for the SDK.
+ *
+ * Contract:
+ *   - Uses native `fetch` (Node 18+ builds it in). No `axios` / `undici`
+ *     dependency so the SDK bundle stays small.
+ *   - Every call attaches Authorization + User-Agent + X-Request-Id.
+ *   - Mutating calls (POST) auto-generate an `Idempotency-Key` unless
+ *     the caller supplied one (T39).
+ *   - Retries on transient failures: 5xx, 429, 408, 503, and low-level
+ *     connection errors. Back-off is exponential with jitter, honoring
+ *     the server's `Retry-After` when present. Max 3 attempts by default.
+ *   - 4xx (except 408 / 429) is NOT retried — those are caller errors.
+ *   - Stream responses (TTS streaming, raw binary) are returned as a
+ *     `Response` object so callers can `body.getReader()` or iterate
+ *     via our adapter without us buffering the entire audio in memory.
+ *
+ * Error shape: every non-2xx raises a `HakimError` subclass built from
+ * the server's uniform `ApiError` JSON body. Network-level
+ * failures raise `ConnectionError`.
+ */
+export interface TransportOptions {
+    apiKey: string;
+    baseURL: string;
+    timeoutMs: number;
+    maxRetries: number;
+    userAgentSuffix?: string | undefined;
+    /** Injected for tests — defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+    /** Injected for tests — overrides the Math.random used for jitter. */
+    random?: () => number;
+    /** Injected for tests — overrides setTimeout used between retries. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Injected for tests — overrides idempotency key generation. */
+    generateIdempotencyKey?: () => string;
+}
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    /** JSON body. Mutually exclusive with `formData` / `body`. */
+    json?: unknown;
+    /** Multipart body. Mutually exclusive with `json` / `body`. */
+    formData?: FormData;
+    /** Raw body. Mutually exclusive with `json` / `formData`. */
+    body?: BodyInit | undefined;
+    query?: Record<string, string | number | boolean | undefined> | undefined;
+    headers?: Record<string, string> | undefined;
+    /** Client-supplied idempotency key. Overrides auto-generation. */
+    idempotencyKey?: string | undefined;
+    /** When true the response body is returned untouched for the caller
+     *  to stream. The transport still validates the HTTP status + parses
+     *  error bodies for non-2xx. */
+    stream?: boolean;
+    /** Override the request timeout on a per-call basis. */
+    timeoutMs?: number;
+    /** When set, the server returned `Accept` header. Default:
+     *  `application/json` for non-stream, omitted for stream/binary. */
+    accept?: string;
+    /** External AbortSignal. When aborted, the in-flight request is cancelled. */
+    signal?: AbortSignal;
+}
+export declare class Transport {
+    /** Exposed for the realtime WSS helper which needs to build a `wss://`
+     *  URL and set the Authorization header on a raw WebSocket. Treat as
+     *  read-only; regular HTTP calls should never touch this directly. */
+    readonly apiKey: string;
+    readonly baseURL: string;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly userAgent;
+    private readonly fetchImpl;
+    private readonly random;
+    private readonly sleep;
+    private readonly generateIdempotencyKey;
+    constructor(options: TransportOptions);
+    request(opts: RequestOptions): Promise<Response>;
+    private buildURL;
+    private buildHeaders;
+    /** Base backoff: 200ms, 600ms, 1400ms; with ±25% jitter. Cap at 10s. */
+    private backoffMs;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,MAAM,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;oCAEgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;wEACoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD,qBAAa,SAAS;IACpB;;0EAEsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAe;gBAE1C,OAAO,EAAE,gBAAgB;IAuB/B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4FtD,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,YAAY;IA+BpB,wEAAwE;IACxE,OAAO,CAAC,SAAS;CAKlB"}