@speechrouter/sdk 0.1.0 → 0.1.1

package/README.md

@@ -1,10 +1,95 @@
 # @speechrouter/sdk
 
-Official scoped alias of [`speechrouter`](https://www.npmjs.com/package/speechrouter) —
-one API for every speech model, [speechrouter.ai](https://speechrouter.ai).
+One API for every speech model — [speechrouter.ai](https://speechrouter.ai).
+
+Streaming speech-to-text over WebSocket with mid-stream provider failover,
+plus batch transcription. Works in browsers, Node ≥ 18, and React Native.
+Zero runtime dependencies.
 
 ```sh
-npm install speechrouter
+npm install speechrouter        # canonical
+npm install @speechrouter/sdk   # same client, scoped
+```
+
+## Streaming
+
+```ts
+import { SpeechRouter } from "speechrouter";
+
+const sr = new SpeechRouter({ apiKey: "sk_sr_..." });
+
+const stream = sr.listen({
+  model: "deepgram/nova-3",
+  fallbacks: ["soniox/stt-rt-v5"],   // dies mid-stream? we switch, you keep captioning
+});
+
+stream.on("transcript", (t) => {
+  if (t.is_final) console.log(t.text);
+});
+stream.on("provider_switched", (s) => console.log(`failover: ${s.from} → ${s.to}`));
+
+stream.sendAudio(pcmChunk);            // 16-bit linear PCM, 16 kHz mono by default
+const { usage } = await stream.stop(); // finalize → transcript tail → usage
+```
+
+Or consume the session as an async stream:
+
+```ts
+for await (const event of stream) {
+  if (event.type === "transcript" && event.is_final) console.log(event.text);
+}
+```
+
+## Microphone (browser)
+
+```ts
+import { openMicrophone } from "speechrouter/mic";
+
+const mic = await openMicrophone(stream, { onLevel: (rms) => meter.style.width = `${rms * 300}px` });
+// later: mic.stop(); await stream.stop();
+```
+
+Captures the default mic, resamples whatever rate the browser gives you
+(96 kHz interfaces included) down to 16 kHz PCM, and pumps it into the stream.
+
+In React Native, capture PCM with a native module (e.g.
+`react-native-live-audio-stream`) and call `stream.sendAudio(chunk)` — the
+core client is RN-safe and never imports browser APIs.
+
+## Batch
+
+```ts
+const { text } = await sr.transcribe({ model: "cartesia/ink-whisper", file });
+
+// subtitles straight out:
+const srt = await sr.transcribe({ model: "deepgram/nova-3", file, responseFormat: "srt" });
+```
+
+`file` accepts a browser `File`/`Blob`, raw bytes (`Uint8Array`/`ArrayBuffer`),
+or a React Native descriptor `{ uri, name, type }`. Pass `url` instead to have
+the gateway fetch the audio itself.
+
+## Models
+
+```ts
+const models = await sr.listModels(); // slugs, capabilities, live pricing
+```
+
+## Errors
+
+Everything throws or emits `SpeechRouterError` with a machine-readable
+`code` (`insufficient_credits`, `concurrency_exceeded`, `provider_error`,
+…), the upstream `provider` when known, and a `recoverable` hint.
+
+## Self-hosting
+
+Point the client at your own gateway:
+
+```ts
+new SpeechRouter({ apiKey, baseUrl: "http://localhost:8080" });
 ```
 
-Both names ship the same client; `speechrouter` is canonical.
+Note for browsers: an API key shipped to a page is public. Mint short-lived
+keys from your backend, or proxy the socket.
+
+Apache-2.0 · [protocol spec](https://github.com/speech-router/speechrouter/tree/main/packages/spec) · [gateway](https://github.com/speech-router/speechrouter)

package/dist/index.cjs

@@ -0,0 +1,441 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ListenStream: () => ListenStream,
+  SpeechRouter: () => SpeechRouter,
+  SpeechRouterError: () => SpeechRouterError,
+  buildListenUrl: () => buildListenUrl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var SpeechRouterError = class extends Error {
+  constructor(message, opts) {
+    super(message);
+    this.name = "SpeechRouterError";
+    this.code = opts.code;
+    if (opts.status !== void 0) this.status = opts.status;
+    if (opts.provider !== void 0) this.provider = opts.provider;
+    this.recoverable = opts.recoverable ?? false;
+  }
+};
+
+// src/ws.ts
+async function resolveWebSocket() {
+  const g = globalThis;
+  if (typeof g.WebSocket === "function") return g.WebSocket;
+  try {
+    const mod = await import(
+      /* webpackIgnore: true */
+      "ws"
+    );
+    return mod.WebSocket ?? mod.default;
+  } catch {
+    throw new Error(
+      "No WebSocket implementation found. Use Node >= 22, or install the optional peer dependency: npm install ws"
+    );
+  }
+}
+
+// src/listen.ts
+function toQuery(opts, apiKey) {
+  const q = new URLSearchParams();
+  q.set("model", opts.model);
+  if (opts.fallbacks?.length) q.set("fallbacks", opts.fallbacks.join(","));
+  q.set("encoding", opts.encoding ?? "linear16");
+  q.set("sample_rate", String(opts.sampleRate ?? 16e3));
+  q.set("channels", String(opts.channels ?? 1));
+  if (opts.language) q.set("language", opts.language);
+  if (opts.interimResults === false) q.set("interim_results", "false");
+  if (opts.diarization) q.set("diarization", "true");
+  if (opts.keyterms?.length) q.set("keyterms", opts.keyterms.join(","));
+  if (opts.includeRaw) q.set("include_raw", "true");
+  if (opts.providerParams && Object.keys(opts.providerParams).length)
+    q.set("provider_params", JSON.stringify(opts.providerParams));
+  q.set("api_key", apiKey);
+  return q.toString();
+}
+function buildListenUrl(wsBase, opts, apiKey) {
+  return `${wsBase}/v1/listen?${toQuery(opts, apiKey)}`;
+}
+var ListenStream = class {
+  constructor(url, opts) {
+    this.url = url;
+    this.opts = opts;
+    this.ws = null;
+    this.listeners = /* @__PURE__ */ new Map();
+    this.sendQueue = [];
+    this.iterQueue = [];
+    this.iterWaiter = null;
+    this.keepAliveTimer = null;
+    this.connectTimer = null;
+    this.doneSettled = false;
+    /** 'connecting' → 'open' → 'closed'; 'finalizing' between finalize() and done. */
+    this.state = "connecting";
+    /** Set once the gateway confirms the session. */
+    this.session = null;
+    this.donePromise = new Promise((resolve, reject) => {
+      this.resolveDone = resolve;
+      this.rejectDone = reject;
+    });
+    this.donePromise.catch(() => {
+    });
+    void this.connect();
+  }
+  /* ---- event plumbing ------------------------------------------------ */
+  on(type, fn) {
+    let set = this.listeners.get(type);
+    if (!set) this.listeners.set(type, set = /* @__PURE__ */ new Set());
+    set.add(fn);
+    return () => set.delete(fn);
+  }
+  once(type, fn) {
+    const off = this.on(type, (e) => {
+      off();
+      fn(e);
+    });
+    return off;
+  }
+  emit(type, event) {
+    this.listeners.get(type)?.forEach((fn) => fn(event));
+  }
+  /** Consume the session as an async stream of wire events. */
+  [Symbol.asyncIterator]() {
+    return {
+      next: () => {
+        const queued = this.iterQueue.shift();
+        if (queued) return Promise.resolve({ value: queued, done: false });
+        if (this.state === "closed") return Promise.resolve({ value: void 0, done: true });
+        return new Promise((resolve) => this.iterWaiter = resolve);
+      },
+      return: () => {
+        this.close();
+        return Promise.resolve({ value: void 0, done: true });
+      }
+    };
+  }
+  /* ---- lifecycle ----------------------------------------------------- */
+  async connect() {
+    let WS;
+    try {
+      WS = await resolveWebSocket();
+      this.ws = new WS(this.url);
+    } catch (err) {
+      this.fail(
+        new SpeechRouterError(err instanceof Error ? err.message : "could not open socket", {
+          code: "connection_failed"
+        })
+      );
+      return;
+    }
+    const ws = this.ws;
+    ws.binaryType = "arraybuffer";
+    const timeoutMs = this.opts.connectTimeoutMs ?? 1e4;
+    this.connectTimer = setTimeout(() => {
+      if (this.state === "connecting") {
+        this.fail(new SpeechRouterError(`socket not open after ${timeoutMs}ms`, { code: "timeout" }));
+        try {
+          ws.close();
+        } catch {
+        }
+      }
+    }, timeoutMs);
+    ws.addEventListener("open", () => {
+      if (this.connectTimer) clearTimeout(this.connectTimer);
+      if (this.state !== "connecting") return;
+      this.state = "open";
+      for (const chunk of this.sendQueue) ws.send(chunk);
+      this.sendQueue = [];
+      this.startKeepAlive();
+    });
+    ws.addEventListener("message", (e) => {
+      void this.handleMessage(e.data);
+    });
+    ws.addEventListener("error", () => {
+      if (this.state === "connecting") {
+        this.fail(new SpeechRouterError("websocket connection failed", { code: "connection_failed" }));
+      }
+    });
+    ws.addEventListener("close", (e) => {
+      this.teardown(e.code, e.reason);
+    });
+  }
+  async handleMessage(data) {
+    let text;
+    if (typeof data === "string") text = data;
+    else if (data instanceof ArrayBuffer) text = new TextDecoder().decode(data);
+    else if (typeof data?.text === "function") text = await data.text();
+    else return;
+    let event;
+    try {
+      event = JSON.parse(text);
+    } catch {
+      return;
+    }
+    this.emit("event", event);
+    this.pushIter(event);
+    switch (event.type) {
+      case "session.open":
+        this.session = event;
+        this.emit("open", event);
+        break;
+      case "transcript":
+        this.emit("transcript", event);
+        break;
+      case "provider_switched":
+        this.emit("provider_switched", event);
+        break;
+      case "done":
+        this.settleDone(event);
+        this.emit("done", event);
+        break;
+      case "error": {
+        const err = new SpeechRouterError(event.message, {
+          code: event.code,
+          recoverable: event.recoverable ?? false,
+          ...event.provider !== void 0 ? { provider: event.provider } : {}
+        });
+        if (!event.recoverable) this.settleDoneWith(err);
+        this.emit("error", err);
+        break;
+      }
+    }
+  }
+  pushIter(event) {
+    if (this.iterWaiter) {
+      const w = this.iterWaiter;
+      this.iterWaiter = null;
+      w({ value: event, done: false });
+    } else {
+      this.iterQueue.push(event);
+    }
+  }
+  startKeepAlive() {
+    const setting = this.opts.keepAlive ?? true;
+    if (setting === false) return;
+    const interval = typeof setting === "number" ? setting : 8e3;
+    this.keepAliveTimer = setInterval(() => {
+      if (this.state === "open") this.sendJson({ type: "keepalive" });
+    }, interval);
+  }
+  fail(err) {
+    this.settleDoneWith(err);
+    this.emit("error", err);
+    this.teardown();
+  }
+  settleDone(d) {
+    if (!this.doneSettled) {
+      this.doneSettled = true;
+      this.resolveDone(d);
+    }
+  }
+  settleDoneWith(err) {
+    if (!this.doneSettled) {
+      this.doneSettled = true;
+      this.rejectDone(err);
+    }
+  }
+  teardown(code, reason) {
+    if (this.state === "closed") return;
+    this.state = "closed";
+    if (this.keepAliveTimer) clearInterval(this.keepAliveTimer);
+    if (this.connectTimer) clearTimeout(this.connectTimer);
+    this.settleDoneWith(
+      new SpeechRouterError("connection closed before the session finished", {
+        code: "connection_closed"
+      })
+    );
+    if (this.iterWaiter) {
+      const w = this.iterWaiter;
+      this.iterWaiter = null;
+      w({ value: void 0, done: true });
+    }
+    this.emit("close", {
+      ...code !== void 0 ? { code } : {},
+      ...reason !== void 0 ? { reason } : {}
+    });
+  }
+  /* ---- outbound ------------------------------------------------------ */
+  /** Send a chunk of PCM audio. Chunks sent before the socket opens are queued. */
+  sendAudio(chunk) {
+    if (this.state === "closed" || this.state === "finalizing")
+      throw new SpeechRouterError("cannot send audio: stream is " + this.state, {
+        code: "connection_closed"
+      });
+    if (this.state === "connecting") {
+      this.sendQueue.push(chunk);
+      return;
+    }
+    this.ws.send(chunk);
+  }
+  /** Bytes accepted but not yet on the wire — use to pace large sends. */
+  get bufferedAmount() {
+    return this.ws?.bufferedAmount ?? 0;
+  }
+  sendJson(msg) {
+    if (this.state === "open" || this.state === "finalizing") this.ws.send(JSON.stringify(msg));
+  }
+  /** Ask the gateway to flush pending audio into a final transcript. */
+  finalize() {
+    if (this.state === "open") {
+      this.state = "finalizing";
+      this.sendJson({ type: "finalize" });
+    }
+  }
+  /** Resolves with the gateway's usage summary once the session completes. */
+  done() {
+    return this.donePromise;
+  }
+  /**
+   * Graceful shutdown: finalize, wait for the `done` usage event, close the
+   * socket. Returns the done event; rejects if the session errored.
+   */
+  async stop(timeoutMs = 3e4) {
+    this.finalize();
+    const timeout = new Promise(
+      (_, reject) => setTimeout(
+        () => reject(new SpeechRouterError("gave up waiting for done", { code: "timeout" })),
+        timeoutMs
+      )
+    );
+    try {
+      return await Promise.race([this.donePromise, timeout]);
+    } finally {
+      this.close();
+    }
+  }
+  /** Immediate shutdown. In-flight audio may go untranscribed — prefer stop(). */
+  close() {
+    try {
+      this.ws?.close(1e3);
+    } catch {
+    }
+    this.teardown();
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE = "https://api.speechrouter.ai";
+var SpeechRouter = class {
+  constructor(opts) {
+    if (!opts.apiKey) throw new SpeechRouterError("apiKey is required", { code: "auth_failed" });
+    this.apiKey = opts.apiKey;
+    this.base = (opts.baseUrl ?? DEFAULT_BASE).replace(/\/+$/, "");
+    this.wsBase = this.base.replace(/^http/, "ws");
+    this.fetchImpl = opts.fetch ?? globalThis.fetch?.bind(globalThis);
+    if (!this.fetchImpl)
+      throw new SpeechRouterError("no fetch available in this runtime", { code: "internal_error" });
+  }
+  /** Open a live transcription session over WebSocket. */
+  listen(opts) {
+    return new ListenStream(buildListenUrl(this.wsBase, opts, this.apiKey), opts);
+  }
+  async transcribe(opts) {
+    const form = new FormData();
+    form.set("model", opts.model);
+    if (opts.responseFormat) form.set("response_format", opts.responseFormat);
+    if (opts.language) form.set("language", opts.language);
+    if (opts.diarization) form.set("diarization", "true");
+    if (opts.keyterms?.length) form.set("keyterms", opts.keyterms.join(","));
+    if (opts.includeRaw) form.set("include_raw", "true");
+    if (opts.providerParams && Object.keys(opts.providerParams).length)
+      form.set("provider_params", JSON.stringify(opts.providerParams));
+    if (opts.url) {
+      form.set("url", opts.url);
+    } else if (opts.file !== void 0) {
+      form.set("file", this.toFormPart(opts.file), this.partName(opts.file, opts.filename));
+    } else {
+      throw new SpeechRouterError("transcribe needs a file or a url", { code: "invalid_request" });
+    }
+    const response = await this.request("/v1/audio/transcriptions", {
+      method: "POST",
+      body: form
+    });
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) return response.json();
+    return response.text();
+  }
+  /** The live model catalog — slugs, capabilities, pricing. */
+  async listModels() {
+    const response = await this.request("/v1/models", { method: "GET" });
+    const payload = await response.json();
+    return payload.data ?? [];
+  }
+  /* ---- internals ----------------------------------------------------- */
+  toFormPart(file) {
+    if (file instanceof Uint8Array)
+      return new Blob([file.slice().buffer]);
+    if (file instanceof ArrayBuffer) return new Blob([file]);
+    return file;
+  }
+  partName(file, filename) {
+    if (filename) return filename;
+    if (typeof File !== "undefined" && file instanceof File) return file.name;
+    return "audio";
+  }
+  async request(path, init) {
+    let response;
+    try {
+      response = await this.fetchImpl(`${this.base}${path}`, {
+        ...init,
+        headers: { Authorization: `Bearer ${this.apiKey}` }
+      });
+    } catch (err) {
+      throw new SpeechRouterError(
+        err instanceof Error ? err.message : "network request failed",
+        { code: "connection_failed" }
+      );
+    }
+    if (response.ok) return response;
+    let code = "internal_error";
+    let message = `HTTP ${response.status}`;
+    try {
+      const body = await response.json();
+      if (body.error?.code) code = body.error.code;
+      if (body.error?.message) message = body.error.message;
+    } catch {
+    }
+    throw new SpeechRouterError(message, {
+      code,
+      status: response.status,
+      recoverable: response.status >= 500
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ListenStream,
+  SpeechRouter,
+  SpeechRouterError,
+  buildListenUrl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/ws.ts","../src/listen.ts","../src/client.ts"],"sourcesContent":["export { SpeechRouter } from './client'\nexport type { SpeechRouterOptions, TranscribeOptions, FileInput } from './client'\nexport { ListenStream, buildListenUrl } from './listen'\nexport type { ListenOptions, ListenEventMap } from './listen'\nexport { SpeechRouterError } from './errors'\nexport type {\n  ListenEvent,\n  SessionOpenEvent,\n  TranscriptEvent,\n  SpeechStartedEvent,\n  UtteranceEndEvent,\n  ProviderSwitchedEvent,\n  TextDeltaEvent,\n  ClearedEvent,\n  KeepAliveEvent,\n  DoneEvent,\n  ErrorEvent,\n  ErrorCode,\n  Word,\n  Model,\n  Transcription,\n  VerboseTranscription,\n} from './events'\n","import type { ErrorCode } from './events'\n\n/** Every failure the SDK surfaces is one of these. */\nexport class SpeechRouterError extends Error {\n  /** Machine-readable code from the gateway's 16-code error enum, or a\n   * client-side code ('connection_failed', 'connection_closed', 'timeout'). */\n  readonly code: ErrorCode | 'connection_failed' | 'connection_closed' | 'timeout'\n  /** HTTP status for REST calls; undefined for WebSocket errors. */\n  readonly status?: number\n  /** Which upstream provider tripped, when the gateway says. */\n  readonly provider?: string\n  /** Gateway's hint that retrying the same request may succeed. */\n  readonly recoverable: boolean\n\n  constructor(\n    message: string,\n    opts: {\n      code: SpeechRouterError['code']\n      status?: number\n      provider?: string\n      recoverable?: boolean\n    },\n  ) {\n    super(message)\n    this.name = 'SpeechRouterError'\n    this.code = opts.code\n    if (opts.status !== undefined) this.status = opts.status\n    if (opts.provider !== undefined) this.provider = opts.provider\n    this.recoverable = opts.recoverable ?? false\n  }\n}\n","/* Runtime-adaptive WebSocket: browsers and React Native have a global;\n * Node 22+ ships one (undici); older Node falls back to the optional `ws`\n * peer dependency. Everything downstream codes against the browser API. */\n\nexport interface WSLike {\n  binaryType: string\n  readonly readyState: number\n  readonly bufferedAmount?: number\n  send(data: string | ArrayBufferLike | ArrayBufferView): void\n  close(code?: number, reason?: string): void\n  addEventListener(type: string, listener: (event: any) => void): void\n}\n\nexport type WSConstructor = new (url: string) => WSLike\n\nexport async function resolveWebSocket(): Promise<WSConstructor> {\n  const g = globalThis as Record<string, unknown>\n  if (typeof g.WebSocket === 'function') return g.WebSocket as WSConstructor\n  try {\n    const mod = await import(/* webpackIgnore: true */ 'ws')\n    return (mod.WebSocket ?? mod.default) as WSConstructor\n  } catch {\n    throw new Error(\n      'No WebSocket implementation found. Use Node >= 22, or install the optional peer dependency: npm install ws',\n    )\n  }\n}\n","import { SpeechRouterError } from './errors'\nimport type {\n  DoneEvent,\n  ListenEvent,\n  ProviderSwitchedEvent,\n  SessionOpenEvent,\n  TranscriptEvent,\n} from './events'\nimport { resolveWebSocket, type WSLike } from './ws'\n\nexport interface ListenOptions {\n  /** Model slug, e.g. \"deepgram/nova-3\". */\n  model: string\n  /** Ordered failover lane, e.g. [\"soniox/stt-rt-v5\"]. */\n  fallbacks?: string[]\n  /** PCM encoding of the audio you will send. Default \"linear16\". */\n  encoding?: string\n  /** Sample rate of the audio you will send. Default 16000. */\n  sampleRate?: number\n  /** Channel count. Default 1. */\n  channels?: number\n  language?: string\n  /** Emit non-final hypotheses. Default true. */\n  interimResults?: boolean\n  diarization?: boolean\n  /** Bias recognition toward these terms (when the model supports it). */\n  keyterms?: string[]\n  /** Attach the untouched provider payload to every transcript. */\n  includeRaw?: boolean\n  /** Escape hatch: raw params forwarded to the provider. */\n  providerParams?: Record<string, unknown>\n  /** Abort the dial if the socket is not open in this many ms. Default 10000. */\n  connectTimeoutMs?: number\n  /**\n   * Keep the session alive through silences by sending keepalive frames.\n   * true = every 8000 ms, a number = that interval, false = off (default\n   * true). Note: an open session bills wall-clock time on session-billed\n   * providers — close streams you are done with.\n   */\n  keepAlive?: boolean | number\n}\n\ntype Listener<E> = (event: E) => void\n\nexport interface ListenEventMap {\n  /** Socket is open and the gateway accepted the session. */\n  open: SessionOpenEvent\n  transcript: TranscriptEvent\n  provider_switched: ProviderSwitchedEvent\n  done: DoneEvent\n  error: SpeechRouterError\n  /** Fired exactly once, after every other event. */\n  close: { code?: number; reason?: string }\n  /** Every wire event, untouched — including ones without a named channel. */\n  event: ListenEvent\n}\n\nconst CLIENT_CODES = new Set([\n  'connection_failed',\n  'connection_closed',\n  'timeout',\n])\n\nfunction toQuery(opts: ListenOptions, apiKey: string): string {\n  const q = new URLSearchParams()\n  q.set('model', opts.model)\n  if (opts.fallbacks?.length) q.set('fallbacks', opts.fallbacks.join(','))\n  q.set('encoding', opts.encoding ?? 'linear16')\n  q.set('sample_rate', String(opts.sampleRate ?? 16000))\n  q.set('channels', String(opts.channels ?? 1))\n  if (opts.language) q.set('language', opts.language)\n  if (opts.interimResults === false) q.set('interim_results', 'false')\n  if (opts.diarization) q.set('diarization', 'true')\n  if (opts.keyterms?.length) q.set('keyterms', opts.keyterms.join(','))\n  if (opts.includeRaw) q.set('include_raw', 'true')\n  if (opts.providerParams && Object.keys(opts.providerParams).length)\n    q.set('provider_params', JSON.stringify(opts.providerParams))\n  q.set('api_key', apiKey)\n  return q.toString()\n}\n\nexport function buildListenUrl(wsBase: string, opts: ListenOptions, apiKey: string): string {\n  return `${wsBase}/v1/listen?${toQuery(opts, apiKey)}`\n}\n\n/**\n * A live transcription session. Create via `client.listen(...)`, then send\n * PCM with `sendAudio()` and consume events with `on()` or `for await`.\n */\nexport class ListenStream {\n  private ws: WSLike | null = null\n  private listeners = new Map<keyof ListenEventMap, Set<Listener<any>>>()\n  private sendQueue: (ArrayBufferLike | ArrayBufferView)[] = []\n  private iterQueue: ListenEvent[] = []\n  private iterWaiter: ((r: IteratorResult<ListenEvent>) => void) | null = null\n  private keepAliveTimer: ReturnType<typeof setInterval> | null = null\n  private connectTimer: ReturnType<typeof setTimeout> | null = null\n  private donePromise: Promise<DoneEvent>\n  private resolveDone!: (d: DoneEvent) => void\n  private rejectDone!: (e: SpeechRouterError) => void\n  private doneSettled = false\n\n  /** 'connecting' → 'open' → 'closed'; 'finalizing' between finalize() and done. */\n  state: 'connecting' | 'open' | 'finalizing' | 'closed' = 'connecting'\n  /** Set once the gateway confirms the session. */\n  session: SessionOpenEvent | null = null\n\n  constructor(private url: string, private opts: ListenOptions) {\n    this.donePromise = new Promise((resolve, reject) => {\n      this.resolveDone = resolve\n      this.rejectDone = reject\n    })\n    // A caller may only await done(); don't let that surface as unhandled.\n    this.donePromise.catch(() => {})\n    void this.connect()\n  }\n\n  /* ---- event plumbing ------------------------------------------------ */\n\n  on<K extends keyof ListenEventMap>(type: K, fn: Listener<ListenEventMap[K]>): () => void {\n    let set = this.listeners.get(type)\n    if (!set) this.listeners.set(type, (set = new Set()))\n    set.add(fn)\n    return () => set!.delete(fn)\n  }\n\n  once<K extends keyof ListenEventMap>(type: K, fn: Listener<ListenEventMap[K]>): () => void {\n    const off = this.on(type, (e) => {\n      off()\n      fn(e)\n    })\n    return off\n  }\n\n  private emit<K extends keyof ListenEventMap>(type: K, event: ListenEventMap[K]): void {\n    this.listeners.get(type)?.forEach((fn) => fn(event))\n  }\n\n  /** Consume the session as an async stream of wire events. */\n  [Symbol.asyncIterator](): AsyncIterator<ListenEvent> {\n    return {\n      next: (): Promise<IteratorResult<ListenEvent>> => {\n        const queued = this.iterQueue.shift()\n        if (queued) return Promise.resolve({ value: queued, done: false })\n        if (this.state === 'closed') return Promise.resolve({ value: undefined, done: true })\n        return new Promise((resolve) => (this.iterWaiter = resolve))\n      },\n      return: (): Promise<IteratorResult<ListenEvent>> => {\n        this.close()\n        return Promise.resolve({ value: undefined, done: true })\n      },\n    }\n  }\n\n  /* ---- lifecycle ----------------------------------------------------- */\n\n  private async connect(): Promise<void> {\n    let WS\n    try {\n      WS = await resolveWebSocket()\n      this.ws = new WS(this.url)\n    } catch (err) {\n      this.fail(\n        new SpeechRouterError(err instanceof Error ? err.message : 'could not open socket', {\n          code: 'connection_failed',\n        }),\n      )\n      return\n    }\n    const ws = this.ws\n    ws.binaryType = 'arraybuffer'\n\n    const timeoutMs = this.opts.connectTimeoutMs ?? 10_000\n    this.connectTimer = setTimeout(() => {\n      if (this.state === 'connecting') {\n        this.fail(new SpeechRouterError(`socket not open after ${timeoutMs}ms`, { code: 'timeout' }))\n        try {\n          ws.close()\n        } catch {\n          /* already dead */\n        }\n      }\n    }, timeoutMs)\n\n    ws.addEventListener('open', () => {\n      if (this.connectTimer) clearTimeout(this.connectTimer)\n      if (this.state !== 'connecting') return\n      this.state = 'open'\n      for (const chunk of this.sendQueue) ws.send(chunk)\n      this.sendQueue = []\n      this.startKeepAlive()\n    })\n\n    ws.addEventListener('message', (e: { data: unknown }) => {\n      void this.handleMessage(e.data)\n    })\n\n    ws.addEventListener('error', () => {\n      // The close event carries the useful signal; error objects here are\n      // implementation-specific noise. Connection-phase failures reject fast:\n      if (this.state === 'connecting') {\n        this.fail(new SpeechRouterError('websocket connection failed', { code: 'connection_failed' }))\n      }\n    })\n\n    ws.addEventListener('close', (e: { code?: number; reason?: string }) => {\n      this.teardown(e.code, e.reason)\n    })\n  }\n\n  private async handleMessage(data: unknown): Promise<void> {\n    let text: string\n    if (typeof data === 'string') text = data\n    else if (data instanceof ArrayBuffer) text = new TextDecoder().decode(data)\n    else if (typeof (data as Blob)?.text === 'function') text = await (data as Blob).text()\n    else return\n    let event: ListenEvent\n    try {\n      event = JSON.parse(text) as ListenEvent\n    } catch {\n      return\n    }\n\n    this.emit('event', event)\n    this.pushIter(event)\n\n    switch (event.type) {\n      case 'session.open':\n        this.session = event\n        this.emit('open', event)\n        break\n      case 'transcript':\n        this.emit('transcript', event)\n        break\n      case 'provider_switched':\n        this.emit('provider_switched', event)\n        break\n      case 'done':\n        this.settleDone(event)\n        this.emit('done', event)\n        break\n      case 'error': {\n        const err = new SpeechRouterError(event.message, {\n          code: event.code,\n          recoverable: event.recoverable ?? false,\n          ...(event.provider !== undefined ? { provider: event.provider } : {}),\n        })\n        if (!event.recoverable) this.settleDoneWith(err)\n        this.emit('error', err)\n        break\n      }\n    }\n  }\n\n  private pushIter(event: ListenEvent): void {\n    if (this.iterWaiter) {\n      const w = this.iterWaiter\n      this.iterWaiter = null\n      w({ value: event, done: false })\n    } else {\n      this.iterQueue.push(event)\n    }\n  }\n\n  private startKeepAlive(): void {\n    const setting = this.opts.keepAlive ?? true\n    if (setting === false) return\n    const interval = typeof setting === 'number' ? setting : 8000\n    this.keepAliveTimer = setInterval(() => {\n      if (this.state === 'open') this.sendJson({ type: 'keepalive' })\n    }, interval)\n  }\n\n  private fail(err: SpeechRouterError): void {\n    this.settleDoneWith(err)\n    this.emit('error', err)\n    this.teardown()\n  }\n\n  private settleDone(d: DoneEvent): void {\n    if (!this.doneSettled) {\n      this.doneSettled = true\n      this.resolveDone(d)\n    }\n  }\n\n  private settleDoneWith(err: SpeechRouterError): void {\n    if (!this.doneSettled) {\n      this.doneSettled = true\n      this.rejectDone(err)\n    }\n  }\n\n  private teardown(code?: number, reason?: string): void {\n    if (this.state === 'closed') return\n    this.state = 'closed'\n    if (this.keepAliveTimer) clearInterval(this.keepAliveTimer)\n    if (this.connectTimer) clearTimeout(this.connectTimer)\n    this.settleDoneWith(\n      new SpeechRouterError('connection closed before the session finished', {\n        code: 'connection_closed',\n      }),\n    )\n    if (this.iterWaiter) {\n      const w = this.iterWaiter\n      this.iterWaiter = null\n      w({ value: undefined, done: true })\n    }\n    this.emit('close', {\n      ...(code !== undefined ? { code } : {}),\n      ...(reason !== undefined ? { reason } : {}),\n    })\n  }\n\n  /* ---- outbound ------------------------------------------------------ */\n\n  /** Send a chunk of PCM audio. Chunks sent before the socket opens are queued. */\n  sendAudio(chunk: ArrayBufferLike | ArrayBufferView): void {\n    if (this.state === 'closed' || this.state === 'finalizing')\n      throw new SpeechRouterError('cannot send audio: stream is ' + this.state, {\n        code: 'connection_closed',\n      })\n    if (this.state === 'connecting') {\n      this.sendQueue.push(chunk)\n      return\n    }\n    this.ws!.send(chunk)\n  }\n\n  /** Bytes accepted but not yet on the wire — use to pace large sends. */\n  get bufferedAmount(): number {\n    return this.ws?.bufferedAmount ?? 0\n  }\n\n  private sendJson(msg: Record<string, unknown>): void {\n    if (this.state === 'open' || this.state === 'finalizing') this.ws!.send(JSON.stringify(msg))\n  }\n\n  /** Ask the gateway to flush pending audio into a final transcript. */\n  finalize(): void {\n    if (this.state === 'open') {\n      this.state = 'finalizing'\n      this.sendJson({ type: 'finalize' })\n    }\n  }\n\n  /** Resolves with the gateway's usage summary once the session completes. */\n  done(): Promise<DoneEvent> {\n    return this.donePromise\n  }\n\n  /**\n   * Graceful shutdown: finalize, wait for the `done` usage event, close the\n   * socket. Returns the done event; rejects if the session errored.\n   */\n  async stop(timeoutMs = 30_000): Promise<DoneEvent> {\n    this.finalize()\n    const timeout = new Promise<never>((_, reject) =>\n      setTimeout(\n        () => reject(new SpeechRouterError('gave up waiting for done', { code: 'timeout' })),\n        timeoutMs,\n      ),\n    )\n    try {\n      return await Promise.race([this.donePromise, timeout])\n    } finally {\n      this.close()\n    }\n  }\n\n  /** Immediate shutdown. In-flight audio may go untranscribed — prefer stop(). */\n  close(): void {\n    try {\n      this.ws?.close(1000)\n    } catch {\n      /* already closed */\n    }\n    this.teardown()\n  }\n}\n\nexport function isClientCode(code: string): boolean {\n  return CLIENT_CODES.has(code)\n}\n","import { SpeechRouterError } from './errors'\nimport type { ErrorCode, Model, Transcription, VerboseTranscription } from './events'\nimport { buildListenUrl, ListenStream, type ListenOptions } from './listen'\n\nexport interface SpeechRouterOptions {\n  /** Your sk_sr_... key. In browsers, prefer a short-lived key minted by\n   * your backend — anything shipped to a page is public. */\n  apiKey: string\n  /** Override for self-hosted gateways, e.g. \"http://localhost:8080\". */\n  baseUrl?: string\n  /** Custom fetch (tests, polyfills). Defaults to globalThis.fetch. */\n  fetch?: typeof fetch\n}\n\n/** File input accepted by transcribe(): browser File/Blob, raw bytes, or a\n * React Native file descriptor ({ uri, name, type }). */\nexport type FileInput =\n  | Blob\n  | ArrayBuffer\n  | Uint8Array\n  | { uri: string; name: string; type: string }\n\nexport interface TranscribeOptions {\n  model: string\n  file?: FileInput\n  /** Let the gateway fetch the audio itself instead of uploading. */\n  url?: string\n  /** Filename hint when passing raw bytes. Default \"audio\". */\n  filename?: string\n  language?: string\n  diarization?: boolean\n  keyterms?: string[]\n  includeRaw?: boolean\n  providerParams?: Record<string, unknown>\n}\n\nconst DEFAULT_BASE = 'https://api.speechrouter.ai'\n\nexport class SpeechRouter {\n  private apiKey: string\n  private base: string\n  private wsBase: string\n  private fetchImpl: typeof fetch\n\n  constructor(opts: SpeechRouterOptions) {\n    if (!opts.apiKey) throw new SpeechRouterError('apiKey is required', { code: 'auth_failed' })\n    this.apiKey = opts.apiKey\n    this.base = (opts.baseUrl ?? DEFAULT_BASE).replace(/\\/+$/, '')\n    this.wsBase = this.base.replace(/^http/, 'ws')\n    this.fetchImpl = opts.fetch ?? globalThis.fetch?.bind(globalThis)\n    if (!this.fetchImpl)\n      throw new SpeechRouterError('no fetch available in this runtime', { code: 'internal_error' })\n  }\n\n  /** Open a live transcription session over WebSocket. */\n  listen(opts: ListenOptions): ListenStream {\n    return new ListenStream(buildListenUrl(this.wsBase, opts, this.apiKey), opts)\n  }\n\n  /** Transcribe a complete file. Returns `{ text }`. */\n  async transcribe(opts: TranscribeOptions): Promise<Transcription>\n  async transcribe(\n    opts: TranscribeOptions & { responseFormat: 'verbose_json' },\n  ): Promise<VerboseTranscription>\n  async transcribe(\n    opts: TranscribeOptions & { responseFormat: 'srt' | 'vtt' | 'text' },\n  ): Promise<string>\n  async transcribe(\n    opts: TranscribeOptions & { responseFormat?: string },\n  ): Promise<Transcription | VerboseTranscription | string> {\n    const form = new FormData()\n    form.set('model', opts.model)\n    if (opts.responseFormat) form.set('response_format', opts.responseFormat)\n    if (opts.language) form.set('language', opts.language)\n    if (opts.diarization) form.set('diarization', 'true')\n    if (opts.keyterms?.length) form.set('keyterms', opts.keyterms.join(','))\n    if (opts.includeRaw) form.set('include_raw', 'true')\n    if (opts.providerParams && Object.keys(opts.providerParams).length)\n      form.set('provider_params', JSON.stringify(opts.providerParams))\n\n    if (opts.url) {\n      form.set('url', opts.url)\n    } else if (opts.file !== undefined) {\n      form.set('file', this.toFormPart(opts.file), this.partName(opts.file, opts.filename))\n    } else {\n      throw new SpeechRouterError('transcribe needs a file or a url', { code: 'invalid_request' })\n    }\n\n    const response = await this.request('/v1/audio/transcriptions', {\n      method: 'POST',\n      body: form,\n    })\n    const contentType = response.headers.get('content-type') ?? ''\n    if (contentType.includes('application/json')) return response.json()\n    return response.text()\n  }\n\n  /** The live model catalog — slugs, capabilities, pricing. */\n  async listModels(): Promise<Model[]> {\n    const response = await this.request('/v1/models', { method: 'GET' })\n    const payload = (await response.json()) as { data?: Model[] }\n    return payload.data ?? []\n  }\n\n  /* ---- internals ----------------------------------------------------- */\n\n  private toFormPart(file: FileInput): Blob {\n    if (file instanceof Uint8Array)\n      // Copy into a fresh ArrayBuffer so SharedArrayBuffer-backed views are boxed too.\n      return new Blob([file.slice().buffer])\n    if (file instanceof ArrayBuffer) return new Blob([file])\n    // RN descriptor rides FormData natively; the cast keeps web types happy.\n    return file as Blob\n  }\n\n  private partName(file: FileInput, filename?: string): string {\n    if (filename) return filename\n    if (typeof File !== 'undefined' && file instanceof File) return file.name\n    return 'audio'\n  }\n\n  private async request(path: string, init: RequestInit): Promise<Response> {\n    let response: Response\n    try {\n      response = await this.fetchImpl(`${this.base}${path}`, {\n        ...init,\n        headers: { Authorization: `Bearer ${this.apiKey}` },\n      })\n    } catch (err) {\n      throw new SpeechRouterError(\n        err instanceof Error ? err.message : 'network request failed',\n        { code: 'connection_failed' },\n      )\n    }\n    if (response.ok) return response\n\n    let code: ErrorCode = 'internal_error'\n    let message = `HTTP ${response.status}`\n    try {\n      const body = (await response.json()) as {\n        error?: { code?: ErrorCode; message?: string }\n      }\n      if (body.error?.code) code = body.error.code\n      if (body.error?.message) message = body.error.message\n    } catch {\n      /* non-JSON error body; keep the status line */\n    }\n    throw new SpeechRouterError(message, {\n      code,\n      status: response.status,\n      recoverable: response.status >= 500,\n    })\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,56 @@
+import { L as ListenOptions, a as ListenStream, T as Transcription, V as VerboseTranscription, M as Model } from './listen-DEvmsIUS.cjs';
+export { C as ClearedEvent, D as DoneEvent, E as ErrorCode, b as ErrorEvent, K as KeepAliveEvent, c as ListenEvent, d as ListenEventMap, P as ProviderSwitchedEvent, S as SessionOpenEvent, e as SpeechRouterError, f as SpeechStartedEvent, g as TextDeltaEvent, h as TranscriptEvent, U as UtteranceEndEvent, W as Word, i as buildListenUrl } from './listen-DEvmsIUS.cjs';
+
+interface SpeechRouterOptions {
+    /** Your sk_sr_... key. In browsers, prefer a short-lived key minted by
+     * your backend — anything shipped to a page is public. */
+    apiKey: string;
+    /** Override for self-hosted gateways, e.g. "http://localhost:8080". */
+    baseUrl?: string;
+    /** Custom fetch (tests, polyfills). Defaults to globalThis.fetch. */
+    fetch?: typeof fetch;
+}
+/** File input accepted by transcribe(): browser File/Blob, raw bytes, or a
+ * React Native file descriptor ({ uri, name, type }). */
+type FileInput = Blob | ArrayBuffer | Uint8Array | {
+    uri: string;
+    name: string;
+    type: string;
+};
+interface TranscribeOptions {
+    model: string;
+    file?: FileInput;
+    /** Let the gateway fetch the audio itself instead of uploading. */
+    url?: string;
+    /** Filename hint when passing raw bytes. Default "audio". */
+    filename?: string;
+    language?: string;
+    diarization?: boolean;
+    keyterms?: string[];
+    includeRaw?: boolean;
+    providerParams?: Record<string, unknown>;
+}
+declare class SpeechRouter {
+    private apiKey;
+    private base;
+    private wsBase;
+    private fetchImpl;
+    constructor(opts: SpeechRouterOptions);
+    /** Open a live transcription session over WebSocket. */
+    listen(opts: ListenOptions): ListenStream;
+    /** Transcribe a complete file. Returns `{ text }`. */
+    transcribe(opts: TranscribeOptions): Promise<Transcription>;
+    transcribe(opts: TranscribeOptions & {
+        responseFormat: 'verbose_json';
+    }): Promise<VerboseTranscription>;
+    transcribe(opts: TranscribeOptions & {
+        responseFormat: 'srt' | 'vtt' | 'text';
+    }): Promise<string>;
+    /** The live model catalog — slugs, capabilities, pricing. */
+    listModels(): Promise<Model[]>;
+    private toFormPart;
+    private partName;
+    private request;
+}
+
+export { type FileInput, ListenOptions, ListenStream, Model, SpeechRouter, type SpeechRouterOptions, type TranscribeOptions, Transcription, VerboseTranscription };