@tapra/sdk 0.0.0-stage → 0.1.2

package/README.md

@@ -1,3 +1,61 @@
-# Temporary Holding Version
+# Tapra TypeScript SDK
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Official TypeScript client for the Tapra API: Tunisian Arabic / French / English
+code-switching transcription, speech, translation, and Arabizi ↔ Arabic conversion.
+ESM, Node.js 22+ and modern browsers, no runtime dependencies.
+
+```ts
+import { TapraClient, Tapra } from '@tapra/sdk';
+
+const client = new TapraClient(); // https://api.tapra.tn; apiKey defaults to TAPRA_API_KEY
+
+const transcript = await client.transcriptions.create({ file: audioFile, timestamps: 'word' });
+await client.script.convert({ text: '3lech 7abit l9anoun?', direction: 'ZI2AR' });
+
+for await (const event of await client.translations.createStream({ input: 'عندي برشا خدمة', target: 'French' })) {
+  process.stdout.write(event.delta ?? '');
+}
+```
+
+Pass `baseUrl` to target another host, such as a local model host.
+
+Errors are typed (`Tapra.PaymentRequiredError` for HTTP 402, …) and carry `body.error.type`.
+Pass `{ idempotencyKey }` as request options to retry metered requests safely, and call
+`.withRawResponse()` to read `x-tapra-cost-tnd`.
+
+## Realtime transcription
+
+```ts
+import { connectRealtime } from '@tapra/sdk';
+
+const session = await connectRealtime({ language: 'ar-AR' }); // wss://api.tapra.tn
+session.on('partial', (event) => render(event.text));
+session.sendAudio(pcmChunk); // mono pcm_s16le, 16 kHz
+const final = await session.stop();
+```
+
+The key is sent as the `tapra-auth.<key>` WebSocket subprotocol, never in the URL. In a browser,
+pass a short-lived session token as `apiKey`, not a permanent key.
+
+## Prices
+
+Tapra charges in TND. The SDK does not hardcode any price or dollar amount: it reads the
+same live price list the website and the meter use.
+
+```ts
+import { fetchTapraPrices, estimateCostTnd, estimateCostUsd } from '@tapra/sdk';
+
+const prices = await fetchTapraPrices(); // GET https://www.tapra.tn/api/pricing, no key needed
+
+estimateCostTnd(prices, 'tts', 1200); // 0.24 TND — 1,200 characters
+estimateCostUsd(prices, 'tts', 1200); // ≈ $0.08, at the rate the list was fetched with
+```
+
+`estimateCostMicroTnd` returns the exact integer amount the meter charges, including the
+per-request minimum for text products. The endpoint also returns `tndPerUsd` and the date of
+the published rate, so a UI can show which rate it used.
+
+## Development
+
+`src/` is generated by Fern from `openapi/tapra-api.json`; do not edit it by hand.
+`lib/` (package entry, realtime helper, price list) is hand-written. Tests: `sdks/tests/typescript`.

package/dist/lib/index.d.ts

@@ -0,0 +1,5 @@
+export * from '../src/index.js';
+export { RealtimeError, RealtimeSession, connectRealtime, transcribeStream } from './realtime.js';
+export type { AudioChunk, RealtimeOptions, WebSocketLike } from './realtime.js';
+export { TAPRA_PRICING_URL, estimateCostMicroTnd, estimateCostTnd, estimateCostUsd, fetchTapraPrices, formatUsd, tndToUsd, usdToTnd } from './pricing.js';
+export type { TapraPrices, TapraServicePrice } from './pricing.js';

package/dist/lib/index.js

@@ -0,0 +1,7 @@
+// Package entry: the Fern-generated client (src/, never edit) plus the hand-written
+// realtime WebSocket helper (lib/realtime.ts) and the price-list helper
+// (lib/pricing.ts).
+export * from '../src/index.js';
+export { RealtimeError, RealtimeSession, connectRealtime, transcribeStream } from './realtime.js';
+export { TAPRA_PRICING_URL, estimateCostMicroTnd, estimateCostTnd, estimateCostUsd, fetchTapraPrices, formatUsd, tndToUsd, usdToTnd } from './pricing.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wEAAwE;AACxE,oBAAoB;AACpB,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,QAAQ,EACT,MAAM,cAAc,CAAC"}

package/dist/lib/pricing.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tapra price list.
+ *
+ * Tapra charges in TND. The dollar figures in this package are never written
+ * down: they come from the same live rate the website and the meter use, which
+ * the SDK reads from `GET /api/pricing`.
+ *
+ *     import { fetchTapraPrices, estimateCostTnd } from '@tapra/sdk';
+ *
+ *     const prices = await fetchTapraPrices();
+ *     const costTnd = estimateCostTnd(prices, 'tts', 1200);
+ *
+ * The endpoint is public, needs no key, and answers with the exact integer
+ * micro-TND amounts the meter charges.
+ */
+export declare const TAPRA_PRICING_URL = "https://www.tapra.tn/api/pricing";
+export interface TapraServicePrice {
+    /** The exact model id sent to the API. */
+    model: string;
+    /** `audio_ms` for speech, `characters` for text. */
+    unit: 'audio_ms' | 'characters';
+    /** How many metered units one charge unit covers (60,000 ms or 1,000 chars). */
+    unitsPerChargeUnit: number;
+    /** The price of one charge unit in TND. */
+    tndPerUnit: number;
+    /** The same price in USD, at the rate the endpoint was fetched with. */
+    usdPerUnit: number;
+    /** The same price in exact micro-TND (1 TND = 1,000,000 micro-TND). */
+    microTndPerUnit: number;
+    /** The per-request floor in TND (text products only). */
+    minimumTnd: number;
+    /** The per-request floor in USD. */
+    minimumUsd: number;
+}
+export interface TapraPrices {
+    version: string;
+    currency: 'TND';
+    /** Units of TND per 1 USD. */
+    tndPerUsd: number;
+    /** Date the rate was published (ISO yyyy-mm-dd), when known. */
+    rateDate: string | null;
+    rateSource: 'frankfurter' | 'fallback';
+    microTndPerTnd: number;
+    minimumChargeMicroTnd: number;
+    welcomeCreditTnd: number;
+    topUpPackagesTnd: number[];
+    ttsFlashMultiplier: number;
+    services: Record<string, TapraServicePrice>;
+}
+/** Fetches the live price list. */
+export declare function fetchTapraPrices(options?: {
+    baseUrl?: string;
+    signal?: AbortSignal;
+    fetch?: typeof fetch;
+}): Promise<TapraPrices>;
+/** Converts an amount in TND to USD at the rate of a fetched price list. */
+export declare function tndToUsd(tnd: number, tndPerUsd: number): number;
+/** Converts an amount in USD to TND at the rate of a fetched price list. */
+export declare function usdToTnd(usd: number, tndPerUsd: number): number;
+/** Formats a USD amount the way the site does: up to three decimals. */
+export declare function formatUsd(value: number): string;
+/**
+ * The charge for a request, in exact micro-TND, exactly as the meter computes
+ * it. `quantity` is audio milliseconds for speech and characters for text.
+ */
+export declare function estimateCostMicroTnd(prices: TapraPrices, service: string, quantity: number): number;
+/** The charge for a request, in TND. */
+export declare function estimateCostTnd(prices: TapraPrices, service: string, quantity: number): number;
+/** The charge for a request, in USD, at the rate of the fetched price list. */
+export declare function estimateCostUsd(prices: TapraPrices, service: string, quantity: number): number;

package/dist/lib/pricing.js

@@ -0,0 +1,67 @@
+/**
+ * Tapra price list.
+ *
+ * Tapra charges in TND. The dollar figures in this package are never written
+ * down: they come from the same live rate the website and the meter use, which
+ * the SDK reads from `GET /api/pricing`.
+ *
+ *     import { fetchTapraPrices, estimateCostTnd } from '@tapra/sdk';
+ *
+ *     const prices = await fetchTapraPrices();
+ *     const costTnd = estimateCostTnd(prices, 'tts', 1200);
+ *
+ * The endpoint is public, needs no key, and answers with the exact integer
+ * micro-TND amounts the meter charges.
+ */
+export const TAPRA_PRICING_URL = 'https://www.tapra.tn/api/pricing';
+/** Fetches the live price list. */
+export async function fetchTapraPrices(options = {}) {
+    const url = options.baseUrl ? `${options.baseUrl.replace(/\/$/, '')}/api/pricing` : TAPRA_PRICING_URL;
+    const doFetch = options.fetch ?? fetch;
+    const response = await doFetch(url, { signal: options.signal });
+    if (!response.ok) {
+        throw new Error(`Could not load the Tapra price list (HTTP ${response.status}).`);
+    }
+    return (await response.json());
+}
+/** Converts an amount in TND to USD at the rate of a fetched price list. */
+export function tndToUsd(tnd, tndPerUsd) {
+    if (!Number.isFinite(tnd) || !Number.isFinite(tndPerUsd) || tndPerUsd <= 0)
+        return 0;
+    return tnd / tndPerUsd;
+}
+/** Converts an amount in USD to TND at the rate of a fetched price list. */
+export function usdToTnd(usd, tndPerUsd) {
+    if (!Number.isFinite(usd) || !Number.isFinite(tndPerUsd) || tndPerUsd <= 0)
+        return 0;
+    return usd * tndPerUsd;
+}
+/** Formats a USD amount the way the site does: up to three decimals. */
+export function formatUsd(value) {
+    const fixed = value.toFixed(3);
+    return `$${fixed.includes('.') ? fixed.replace(/0+$/, '').replace(/\.$/, '') : fixed}`;
+}
+/**
+ * The charge for a request, in exact micro-TND, exactly as the meter computes
+ * it. `quantity` is audio milliseconds for speech and characters for text.
+ */
+export function estimateCostMicroTnd(prices, service, quantity) {
+    const price = prices.services[service];
+    if (!price)
+        throw new Error(`Unknown Tapra service: ${service}`);
+    if (!Number.isFinite(quantity) || quantity < 0) {
+        throw new Error('Quantity must be a non-negative number.');
+    }
+    const units = Math.ceil(quantity);
+    const charge = Math.ceil((units * price.microTndPerUnit) / price.unitsPerChargeUnit);
+    return price.unit === 'characters' ? Math.max(prices.minimumChargeMicroTnd, charge) : charge;
+}
+/** The charge for a request, in TND. */
+export function estimateCostTnd(prices, service, quantity) {
+    return estimateCostMicroTnd(prices, service, quantity) / prices.microTndPerTnd;
+}
+/** The charge for a request, in USD, at the rate of the fetched price list. */
+export function estimateCostUsd(prices, service, quantity) {
+    return tndToUsd(estimateCostTnd(prices, service, quantity), prices.tndPerUsd);
+}
+//# sourceMappingURL=pricing.js.map

package/dist/lib/pricing.js.map

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

package/dist/lib/realtime.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Hand-written client for the realtime transcription WebSocket (/v1/realtime/stream).
+ * OpenAPI cannot describe WebSockets, so Fern does not generate this part; the event
+ * types still come from the generated contract (Tapra.RealtimeEvent).
+ *
+ * Works with the browser WebSocket and the Node.js 22+ global WebSocket. The API key is
+ * sent as the `tapra-auth.<key>` subprotocol, never in the URL. Permanent keys belong
+ * in server-side code; browsers should use a short-lived session token as `apiKey`.
+ */
+import type * as Tapra from '../src/api/index.js';
+type RealtimeEvent = Tapra.RealtimeEvent;
+type EventType = RealtimeEvent['type'];
+/** Mono 16-bit little-endian PCM at 16 kHz. */
+export type AudioChunk = ArrayBuffer | ArrayBufferView;
+/** The subset of the WebSocket API this helper uses. */
+export interface WebSocketLike {
+    readonly readyState: number;
+    binaryType: string;
+    send(data: string | ArrayBuffer | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, listener: (event: any) => void): void;
+}
+export type WebSocketConstructor = new (url: string, protocols?: string | string[]) => WebSocketLike;
+export interface RealtimeOptions {
+    /** Defaults to the TAPRA_API_KEY environment variable. */
+    apiKey?: string;
+    /** API origin, e.g. https://api.example.com. Defaults to TapraEnvironment.Default. */
+    baseUrl?: string;
+    /** Decoding hint; code-switching stays enabled. Server default: ar-AR. */
+    language?: string;
+    /** Mask silence before the decoder. Server default: true. */
+    vad?: boolean;
+    /** Emit `utterance` events after trailing silence. Server default: true. */
+    endpointing?: boolean;
+    /** Trailing silence that closes an utterance (200-3000). Server default: 800. */
+    endpointingMs?: number;
+    /** End the session after a long silence. Server default: true. */
+    idleStop?: boolean;
+    /** Silence that ends the session (1000-120000). Server default: 10000. */
+    idleStopMs?: number;
+    /** Punctuate `utterance` and `final` text. Server default: false. */
+    punctuation?: boolean;
+    /** How long to wait for the `ready` event. Default: 15000. */
+    connectTimeoutMs?: number;
+    /** WebSocket implementation. Defaults to globalThis.WebSocket. */
+    WebSocket?: WebSocketConstructor;
+}
+export declare class RealtimeError extends Error {
+    /** `connection_rejected`, `timeout`, `closed`, `not_open`, `missing_api_key`, or a server error code. */
+    readonly code: string;
+    readonly closeCode?: number;
+    constructor(message: string, code: string, closeCode?: number);
+}
+export declare function realtimeUrl(options?: RealtimeOptions): string;
+/** One realtime transcription session. Create it with {@link connectRealtime}. */
+export declare class RealtimeSession implements AsyncIterable<RealtimeEvent> {
+    private readonly socket;
+    private readonly readyState;
+    private readonly finalState;
+    private readonly queue;
+    private readonly waiters;
+    private readonly listeners;
+    private closed;
+    private readyEvent?;
+    /** @internal Use connectRealtime(). */
+    constructor(socket: WebSocketLike);
+    /** The `ready` event: audio format and the session settings the server applied. */
+    get ready(): RealtimeEvent;
+    /** True while audio can be sent. */
+    get isOpen(): boolean;
+    /** @internal */
+    waitUntilReady(timeoutMs: number): Promise<RealtimeEvent>;
+    /** Send one chunk of mono pcm_s16le audio at 16 kHz. */
+    sendAudio(chunk: AudioChunk): void;
+    /** Keep an idle connection alive; send every 15 s when no audio is flowing. */
+    ping(): void;
+    /** Finish the session and resolve with the `final` event (full transcript and usage). */
+    stop(): Promise<RealtimeEvent>;
+    /** Resolves with the `final` event, whether it follows stop() or an idle stop. */
+    get final(): Promise<RealtimeEvent>;
+    /** Close without waiting for the final transcript (no final charge event is received). */
+    close(): void;
+    /** Subscribe to one event type. Returns an unsubscribe function. */
+    on(type: EventType, listener: (event: RealtimeEvent) => void): () => void;
+    /** Iterate over every event after `ready` until the socket closes. */
+    [Symbol.asyncIterator](): AsyncIterator<RealtimeEvent>;
+    private onMessage;
+    private onClose;
+}
+/** Open a realtime session and resolve once the server sends `ready`. */
+export declare function connectRealtime(options?: RealtimeOptions): Promise<RealtimeSession>;
+/**
+ * Stream audio chunks through one session and resolve with the `final` event.
+ * `onEvent` receives every partial/utterance event while audio is flowing.
+ */
+export declare function transcribeStream(audio: AsyncIterable<AudioChunk> | Iterable<AudioChunk>, options?: RealtimeOptions & {
+    onEvent?: (event: RealtimeEvent) => void;
+}): Promise<RealtimeEvent>;
+export {};

package/dist/lib/realtime.js

@@ -0,0 +1,230 @@
+import { TapraEnvironment } from '../src/environments.js';
+export class RealtimeError extends Error {
+    /** `connection_rejected`, `timeout`, `closed`, `not_open`, `missing_api_key`, or a server error code. */
+    code;
+    closeCode;
+    constructor(message, code, closeCode) {
+        super(message);
+        this.name = 'RealtimeError';
+        this.code = code;
+        this.closeCode = closeCode;
+    }
+}
+const OPEN = 1;
+const PATH = '/v1/realtime/stream';
+function deferred() {
+    const state = { settled: false };
+    state.promise = new Promise((resolve, reject) => {
+        state.resolve = (value) => {
+            if (state.settled)
+                return;
+            state.settled = true;
+            resolve(value);
+        };
+        state.reject = (error) => {
+            if (state.settled)
+                return;
+            state.settled = true;
+            reject(error);
+        };
+    });
+    // Unobserved rejections (e.g. nobody awaits `final`) must not crash the process.
+    state.promise.catch(() => undefined);
+    return state;
+}
+function environmentApiKey() {
+    const env = globalThis.process
+        ?.env;
+    return env?.TAPRA_API_KEY;
+}
+function flag(value) {
+    return value ? 'true' : 'false';
+}
+export function realtimeUrl(options = {}) {
+    const url = new URL(options.baseUrl ?? TapraEnvironment.Default);
+    if (url.protocol === 'https:')
+        url.protocol = 'wss:';
+    else if (url.protocol === 'http:')
+        url.protocol = 'ws:';
+    else if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+        throw new RealtimeError(`Unsupported base URL protocol: ${url.protocol}`, 'invalid_base_url');
+    }
+    url.pathname = url.pathname.replace(/\/+$/, '') + PATH;
+    const query = [
+        ['language', options.language],
+        ['vad', options.vad === undefined ? undefined : flag(options.vad)],
+        ['endpointing', options.endpointing === undefined ? undefined : flag(options.endpointing)],
+        ['endpointing_ms', options.endpointingMs?.toString()],
+        ['idle_stop', options.idleStop === undefined ? undefined : flag(options.idleStop)],
+        ['idle_stop_ms', options.idleStopMs?.toString()],
+        ['punctuation', options.punctuation === undefined ? undefined : flag(options.punctuation)]
+    ];
+    for (const [name, value] of query) {
+        if (value !== undefined)
+            url.searchParams.set(name, value);
+    }
+    return url.toString();
+}
+/** One realtime transcription session. Create it with {@link connectRealtime}. */
+export class RealtimeSession {
+    socket;
+    readyState = deferred();
+    finalState = deferred();
+    queue = [];
+    waiters = [];
+    listeners = new Map();
+    closed = false;
+    readyEvent;
+    /** @internal Use connectRealtime(). */
+    constructor(socket) {
+        this.socket = socket;
+        socket.binaryType = 'arraybuffer';
+        socket.addEventListener('message', (message) => this.onMessage(message.data));
+        socket.addEventListener('close', (event) => this.onClose(event.code, event.reason));
+        // Some runtimes (Node.js 22) report a refused handshake only as an error event.
+        socket.addEventListener('error', () => {
+            if (this.readyState.settled)
+                return;
+            this.readyState.reject(new RealtimeError('The server rejected the connection', 'connection_rejected'));
+            this.onClose(undefined, 'The server rejected the connection');
+        });
+    }
+    /** The `ready` event: audio format and the session settings the server applied. */
+    get ready() {
+        if (!this.readyEvent)
+            throw new RealtimeError('The session is not ready yet', 'not_open');
+        return this.readyEvent;
+    }
+    /** True while audio can be sent. */
+    get isOpen() {
+        return !this.closed && this.socket.readyState === OPEN;
+    }
+    /** @internal */
+    waitUntilReady(timeoutMs) {
+        const timer = setTimeout(() => {
+            this.readyState.reject(new RealtimeError('Timed out waiting for the ready event', 'timeout'));
+            this.socket.close(1000, 'Connect timeout');
+        }, timeoutMs);
+        return this.readyState.promise.finally(() => clearTimeout(timer));
+    }
+    /** Send one chunk of mono pcm_s16le audio at 16 kHz. */
+    sendAudio(chunk) {
+        if (!this.isOpen)
+            throw new RealtimeError('The session is not open', 'not_open');
+        this.socket.send(chunk);
+    }
+    /** Keep an idle connection alive; send every 15 s when no audio is flowing. */
+    ping() {
+        if (this.isOpen)
+            this.socket.send(JSON.stringify({ type: 'ping' }));
+    }
+    /** Finish the session and resolve with the `final` event (full transcript and usage). */
+    stop() {
+        if (this.isOpen && !this.finalState.settled) {
+            this.socket.send(JSON.stringify({ type: 'stop' }));
+        }
+        return this.finalState.promise;
+    }
+    /** Resolves with the `final` event, whether it follows stop() or an idle stop. */
+    get final() {
+        return this.finalState.promise;
+    }
+    /** Close without waiting for the final transcript (no final charge event is received). */
+    close() {
+        this.socket.close(1000, 'Client closed');
+    }
+    /** Subscribe to one event type. Returns an unsubscribe function. */
+    on(type, listener) {
+        const set = this.listeners.get(type) ?? new Set();
+        set.add(listener);
+        this.listeners.set(type, set);
+        return () => set.delete(listener);
+    }
+    /** Iterate over every event after `ready` until the socket closes. */
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                const event = this.queue.shift();
+                if (event)
+                    return Promise.resolve({ value: event, done: false });
+                if (this.closed)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise((resolve) => this.waiters.push(resolve));
+            }
+        };
+    }
+    onMessage(data) {
+        if (typeof data !== 'string')
+            return;
+        let event;
+        try {
+            event = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (event.type === 'ready') {
+            this.readyEvent = event;
+            this.readyState.resolve(event);
+            return;
+        }
+        if (event.type === 'final')
+            this.finalState.resolve(event);
+        if (event.type === 'error') {
+            const error = new RealtimeError(event.message ?? 'The transcription stream failed', event.code ?? 'server_error');
+            this.readyState.reject(error);
+            this.finalState.reject(error);
+        }
+        for (const listener of this.listeners.get(event.type) ?? [])
+            listener(event);
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter({ value: event, done: false });
+        else
+            this.queue.push(event);
+    }
+    onClose(code, reason) {
+        this.closed = true;
+        if (!this.readyState.settled) {
+            this.readyState.reject(new RealtimeError(reason || 'The server rejected the connection', 'connection_rejected', code));
+        }
+        this.finalState.reject(new RealtimeError(reason || 'The socket closed before the final event', 'closed', code));
+        for (const waiter of this.waiters.splice(0))
+            waiter({ value: undefined, done: true });
+    }
+}
+/** Open a realtime session and resolve once the server sends `ready`. */
+export async function connectRealtime(options = {}) {
+    const apiKey = options.apiKey ?? environmentApiKey();
+    if (!apiKey) {
+        throw new RealtimeError('Pass apiKey or set TAPRA_API_KEY', 'missing_api_key');
+    }
+    const WebSocketImpl = options.WebSocket ?? globalThis.WebSocket;
+    if (!WebSocketImpl) {
+        throw new RealtimeError('No WebSocket implementation; pass options.WebSocket', 'not_open');
+    }
+    const socket = new WebSocketImpl(realtimeUrl(options), ['tapra-realtime', `tapra-auth.${apiKey}`]);
+    const session = new RealtimeSession(socket);
+    await session.waitUntilReady(options.connectTimeoutMs ?? 15_000);
+    return session;
+}
+/**
+ * Stream audio chunks through one session and resolve with the `final` event.
+ * `onEvent` receives every partial/utterance event while audio is flowing.
+ */
+export async function transcribeStream(audio, options = {}) {
+    const session = await connectRealtime(options);
+    const { onEvent } = options;
+    const unsubscribe = onEvent
+        ? ['partial', 'utterance'].map((type) => session.on(type, onEvent))
+        : [];
+    try {
+        for await (const chunk of audio)
+            session.sendAudio(chunk);
+        return await session.stop();
+    }
+    finally {
+        unsubscribe.forEach((off) => off());
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/dist/lib/realtime.js.map

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

package/dist/src/BaseClient.d.ts

@@ -0,0 +1,57 @@
+import { BearerAuthProvider } from "./auth/BearerAuthProvider.js";
+import * as core from "./core/index.js";
+import type * as environments from "./environments.js";
+export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BearerAuthProvider.AuthOptions;
+export type BaseClientOptions = {
+    environment?: core.Supplier<environments.TapraEnvironment | string>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Default options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
+} & BearerAuthProvider.AuthOptions;
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** A dictionary containing additional parameters to spread into the request's body. */
+    additionalBodyParameters?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** Options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+}
+export interface BaseIdempotentRequestOptions {
+    idempotencyKey?: string | undefined;
+}
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions> = NormalizedClientOptions<T> & {
+    authProvider: core.AuthProvider;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+export declare function normalizeClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptionsWithAuth<T>;