@voiceinput/deepgram 0.1.0-beta.1

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { VoiceInputProviderV1 } from "@voiceinput/provider";
+//#region src/session-config.d.ts
+declare const DEEPGRAM_DEFAULT_MODEL = "nova-3";
+interface DeepgramRealtimeSettings {
+  readonly smartFormat?: boolean;
+  readonly punctuate?: boolean;
+  readonly profanityFilter?: boolean;
+  readonly numerals?: boolean;
+}
+//#endregion
+//#region src/index.d.ts
+interface DeepgramVoiceInputProviderOptions extends DeepgramRealtimeSettings {
+  readonly tokenEndpoint: string | URL;
+  readonly model?: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly webSocket?: typeof globalThis.WebSocket;
+  readonly realtimeUrl?: string;
+}
+declare function deepgram(options: DeepgramVoiceInputProviderOptions): VoiceInputProviderV1;
+//#endregion
+export { DEEPGRAM_DEFAULT_MODEL, DeepgramVoiceInputProviderOptions, deepgram };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/session-config.ts","../src/index.ts"],"mappings":";;cAKa;UAYI;WACN;WACA;WACA;WACA;;;;UCAM,0CAA0C;WAChD,wBAAwB;WACxB;WACA,eAAe,WAAW;WAC1B,mBAAmB,WAAW;WAC9B;;iBAGK,SACd,SAAS,oCACR"}

package/dist/index.js

@@ -0,0 +1,425 @@
+import { i as validateDeepgramConfiguration, n as DEEPGRAM_SAMPLE_RATE, r as createDeepgramRealtimeUrl, t as DEEPGRAM_DEFAULT_MODEL } from "./session-config-JCvVU8gI.js";
+import { sendWithBackpressure } from "@voiceinput/provider/transport";
+import { VoiceInputError } from "@voiceinput/provider";
+//#region src/index.ts
+const DEFAULT_REALTIME_URL = "wss://api.deepgram.com/v1/listen";
+function deepgram(options) {
+	const model = factoryString(options.model ?? "nova-3", "model");
+	const tokenEndpoint = factoryString(String(options.tokenEndpoint), "tokenEndpoint");
+	const realtimeUrl = factoryString(options.realtimeUrl ?? DEFAULT_REALTIME_URL, "realtimeUrl");
+	const providerSettings = {
+		...options.smartFormat === void 0 ? {} : { smartFormat: options.smartFormat },
+		...options.punctuate === void 0 ? {} : { punctuate: options.punctuate },
+		...options.profanityFilter === void 0 ? {} : { profanityFilter: options.profanityFilter },
+		...options.numerals === void 0 ? {} : { numerals: options.numerals }
+	};
+	const validateProviderOptions = (transcriptionOptions) => {
+		try {
+			validateDeepgramConfiguration({
+				model,
+				...providerSettings,
+				...transcriptionOptions
+			});
+		} catch (cause) {
+			if (VoiceInputError.isInstance(cause)) throw cause;
+			throw invalidConfiguration(cause);
+		}
+	};
+	return Object.freeze({
+		specificationVersion: "v1",
+		provider: "deepgram",
+		modelId: model,
+		sampleRate: DEEPGRAM_SAMPLE_RATE,
+		validateOptions: validateProviderOptions,
+		async doOpen(callOptions) {
+			validateProviderOptions(callOptions);
+			const configuration = validateDeepgramConfiguration({
+				model,
+				...providerSettings,
+				...callOptions
+			});
+			return await openSession({
+				abortSignal: callOptions.abortSignal,
+				configuration,
+				fetchImplementation: options.fetch ?? globalThis.fetch,
+				realtimeUrl,
+				tokenEndpoint,
+				WebSocketImplementation: options.webSocket ?? globalThis.WebSocket
+			});
+		}
+	});
+}
+async function openSession(options) {
+	throwIfAborted(options.abortSignal);
+	requireBrowserFunction(options.fetchImplementation, "fetch");
+	requireBrowserFunction(options.WebSocketImplementation, "WebSocket");
+	const token = await requestToken(options.fetchImplementation, options.tokenEndpoint, options.configuration.model, options.abortSignal);
+	throwIfAborted(options.abortSignal);
+	return await createSession(new options.WebSocketImplementation(createDeepgramRealtimeUrl(options.realtimeUrl, options.configuration), ["bearer", token]), options.abortSignal);
+}
+async function requestToken(fetchImplementation, tokenEndpoint, model, abortSignal) {
+	let response;
+	try {
+		response = await fetchImplementation(tokenEndpoint, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ model }),
+			credentials: "same-origin",
+			signal: abortSignal
+		});
+	} catch (cause) {
+		throwIfAborted(abortSignal);
+		throw new VoiceInputError({
+			code: "network-error",
+			message: "Unable to reach the Deepgram token endpoint.",
+			provider: "deepgram",
+			retryable: true,
+			cause
+		});
+	}
+	if (!response.ok) throw await tokenResponseError(response);
+	let value;
+	try {
+		value = await response.json();
+	} catch (cause) {
+		throw new VoiceInputError({
+			code: "token-error",
+			message: "The Deepgram token endpoint returned invalid JSON.",
+			provider: "deepgram",
+			cause
+		});
+	}
+	if (!isRecord(value) || !nonEmpty(value["access_token"])) throw new VoiceInputError({
+		code: "token-error",
+		message: "The Deepgram token endpoint returned an invalid token.",
+		provider: "deepgram"
+	});
+	return value["access_token"];
+}
+async function createSession(socket, abortSignal) {
+	let controller;
+	const stream = new ReadableStream({ start(value) {
+		controller = value;
+	} });
+	if (controller === void 0) throw new VoiceInputError({
+		code: "provider-error",
+		message: "Unable to initialize the Deepgram transcript stream.",
+		provider: "deepgram"
+	});
+	let audioSent = false;
+	let closed = false;
+	let failed = false;
+	let finishing = false;
+	const closedSegments = /* @__PURE__ */ new Set();
+	let lastInterim = "";
+	let speechActive = false;
+	const closeSocket = (reason) => {
+		if (socket.readyState === 0 || socket.readyState === 1) socket.close(1e3, reason);
+	};
+	const closeStream = () => {
+		if (closed) return;
+		closed = true;
+		abortSignal.removeEventListener("abort", abort);
+		controller?.close();
+	};
+	const finishCleanly = () => {
+		closeStream();
+		closeSocket("finished");
+	};
+	const fail = (error) => {
+		if (closed || failed) return;
+		failed = true;
+		controller?.enqueue({
+			type: "error",
+			error
+		});
+		closeStream();
+		closeSocket("aborted");
+	};
+	const startSpeech = () => {
+		if (!speechActive) {
+			speechActive = true;
+			controller?.enqueue({ type: "speech-start" });
+		}
+	};
+	const endSpeech = () => {
+		if (speechActive) {
+			speechActive = false;
+			controller?.enqueue({ type: "speech-end" });
+		}
+	};
+	const handleResults = (value) => {
+		const channel = value["channel"];
+		if (!isRecord(channel) || !Array.isArray(channel["alternatives"])) throw new TypeError("Deepgram Results did not contain alternatives.");
+		const alternative = channel["alternatives"][0];
+		if (!isRecord(alternative) || typeof alternative["transcript"] !== "string") throw new TypeError("Deepgram Results did not contain a transcript.");
+		const text = alternative["transcript"];
+		const isFinal = value["is_final"] === true;
+		const start = value["start"];
+		if (typeof start !== "number" || !Number.isFinite(start) || start < 0) throw new TypeError("Deepgram Results did not contain an audio start boundary.");
+		const segmentId = `audio:${start}`;
+		if (closedSegments.has(segmentId)) return;
+		if (text.length > 0 || isFinal) {
+			if (text.length > 0) startSpeech();
+			if (isFinal) {
+				closedSegments.add(segmentId);
+				controller?.enqueue({
+					type: "final",
+					text,
+					segmentId
+				});
+				lastInterim = "";
+			} else if (text !== lastInterim) {
+				lastInterim = text;
+				controller?.enqueue({
+					type: "interim",
+					text,
+					segmentId
+				});
+			}
+		}
+		if (value["speech_final"] === true) endSpeech();
+	};
+	const handleMessage = (event) => {
+		if (closed) return;
+		try {
+			const value = JSON.parse(String(event.data));
+			if (!isRecord(value) || !nonEmpty(value["type"])) throw new TypeError("Deepgram sent an invalid streaming event.");
+			const type = value["type"];
+			if (type === "Results") handleResults(value);
+			else if (type === "SpeechStarted") startSpeech();
+			else if (type === "UtteranceEnd") endSpeech();
+			else if (type === "Error") fail(normalizeMessageError(value));
+		} catch (cause) {
+			fail(new VoiceInputError({
+				code: "provider-error",
+				message: "Deepgram sent an invalid streaming event.",
+				provider: "deepgram",
+				cause
+			}));
+		}
+	};
+	const handleClose = (event) => {
+		if (closed) return;
+		if (event.code === 1e3) closeStream();
+		else fail(normalizeCloseError(event));
+	};
+	function abort() {
+		if (closed) return;
+		closeStream();
+		closeSocket("aborted");
+	}
+	socket.addEventListener("message", handleMessage);
+	socket.addEventListener("close", handleClose);
+	socket.addEventListener("error", () => {
+		fail(new VoiceInputError({
+			code: "network-error",
+			message: "The Deepgram streaming connection failed.",
+			provider: "deepgram",
+			retryable: true
+		}));
+	});
+	abortSignal.addEventListener("abort", abort, { once: true });
+	await waitForOpen(socket, abortSignal);
+	return {
+		stream,
+		sendAudio(chunk) {
+			if (closed || finishing || chunk.length === 0) return;
+			audioSent = true;
+			try {
+				return sendWithBackpressure(socket, chunk.byteLength, abortSignal, "deepgram", () => socket.send(new Int16Array(chunk).buffer));
+			} catch (cause) {
+				throw new VoiceInputError({
+					code: "network-error",
+					message: "Unable to send audio to Deepgram.",
+					provider: "deepgram",
+					retryable: true,
+					cause
+				});
+			}
+		},
+		finish() {
+			if (closed || finishing) return;
+			finishing = true;
+			if (!audioSent) {
+				finishCleanly();
+				return;
+			}
+			sendJson(socket, { type: "CloseStream" });
+		},
+		abort
+	};
+}
+function normalizeMessageError(value) {
+	const code = typeof value["code"] === "string" ? value["code"] : "";
+	const description = typeof value["description"] === "string" ? value["description"] : typeof value["message"] === "string" ? value["message"] : "";
+	const source = `${code} ${description}`;
+	const rateLimited = /rate|quota|429/iu.test(source);
+	const unauthorized = /auth|unauthorized|401|403/iu.test(source);
+	return new VoiceInputError({
+		code: unauthorized ? "unauthorized" : rateLimited ? "rate-limited" : "provider-error",
+		message: description || "Deepgram reported a streaming error.",
+		provider: "deepgram",
+		retryable: rateLimited || /internal|unavailable/iu.test(source),
+		cause: value
+	});
+}
+function normalizeCloseError(event) {
+	const reason = event.reason ?? "";
+	const rateLimited = event.code === 1013 || /rate|quota|429/iu.test(reason);
+	const unauthorized = /auth|unauthorized|401|403/iu.test(reason);
+	const invalidAudio = event.code === 1008 && /data|audio|decode/iu.test(reason);
+	return new VoiceInputError({
+		code: unauthorized ? "unauthorized" : rateLimited ? "rate-limited" : invalidAudio ? "audio-error" : "network-error",
+		message: "The Deepgram streaming connection closed unexpectedly.",
+		provider: "deepgram",
+		retryable: rateLimited || !unauthorized && !invalidAudio,
+		cause: event
+	});
+}
+function invalidConfiguration(cause) {
+	return new VoiceInputError({
+		code: "invalid-configuration",
+		message: cause instanceof Error ? cause.message : "Invalid Deepgram transcription options.",
+		provider: "deepgram",
+		cause
+	});
+}
+function requireBrowserFunction(value, feature) {
+	if (typeof value !== "function") throw new VoiceInputError({
+		code: "unsupported-browser",
+		message: `Deepgram voice input requires browser ${feature} support.`,
+		provider: "deepgram"
+	});
+}
+function factoryString(value, name) {
+	if (value.trim().length === 0) throw invalidConfiguration(/* @__PURE__ */ new TypeError(`${name} must be non-empty.`));
+	return value;
+}
+async function tokenResponseError(response) {
+	const retryAfterMs = parseRetryAfter(response.headers.get("Retry-After"));
+	if (response.status === 401 || response.status === 403) return new VoiceInputError({
+		code: "unauthorized",
+		message: "The Deepgram token endpoint rejected this request.",
+		provider: "deepgram"
+	});
+	if (response.status === 429) return new VoiceInputError({
+		code: "rate-limited",
+		message: "The Deepgram token endpoint rate limit was exceeded.",
+		provider: "deepgram",
+		retryable: true,
+		...retryAfterMs === void 0 ? {} : { retryAfterMs }
+	});
+	const safeError = await readSafeTokenError(response);
+	if (safeError !== void 0) return new VoiceInputError({
+		...safeError,
+		provider: "deepgram"
+	});
+	return new VoiceInputError({
+		code: "token-error",
+		message: "The Deepgram token endpoint did not issue a token.",
+		provider: "deepgram",
+		retryable: response.status >= 500
+	});
+}
+async function readSafeTokenError(response) {
+	if (response.status !== 400 || response.headers.get("X-VoiceInput-Error") !== "1" || response.headers.get("Content-Type")?.split(";", 1)[0]?.trim() !== "application/json") return;
+	const text = await readBoundedErrorText(response);
+	if (text === void 0) return void 0;
+	try {
+		const value = JSON.parse(text);
+		const error = isRecord(value) ? value["error"] : void 0;
+		if (!isRecord(error) || error["code"] !== "invalid-configuration" && error["code"] !== "unsupported-feature" || typeof error["message"] !== "string" || error["message"].length === 0 || error["message"].length > 1e3) return;
+		return {
+			code: error["code"],
+			message: error["message"]
+		};
+	} catch {
+		return;
+	}
+}
+async function readBoundedErrorText(response) {
+	const reader = response.body?.getReader();
+	if (reader === void 0) return void 0;
+	const decoder = new TextDecoder();
+	let bytesRead = 0;
+	let text = "";
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) return text + decoder.decode();
+			bytesRead += value.byteLength;
+			if (bytesRead > 4096) {
+				await reader.cancel().catch(() => {});
+				return;
+			}
+			text += decoder.decode(value, { stream: true });
+		}
+	} catch {
+		return;
+	}
+}
+function waitForOpen(socket, abortSignal) {
+	if (socket.readyState === 1) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		const cleanup = () => {
+			socket.removeEventListener("open", handleOpen);
+			socket.removeEventListener("error", handleError);
+			abortSignal.removeEventListener("abort", handleAbort);
+		};
+		const handleOpen = () => {
+			cleanup();
+			resolve();
+		};
+		const handleError = (event) => {
+			cleanup();
+			reject(new VoiceInputError({
+				code: "network-error",
+				message: "Unable to open the Deepgram streaming connection.",
+				provider: "deepgram",
+				retryable: true,
+				cause: event
+			}));
+		};
+		const handleAbort = () => {
+			cleanup();
+			reject(abortSignal.reason);
+		};
+		socket.addEventListener("open", handleOpen, { once: true });
+		socket.addEventListener("error", handleError, { once: true });
+		abortSignal.addEventListener("abort", handleAbort, { once: true });
+	});
+}
+function sendJson(socket, value) {
+	try {
+		socket.send(JSON.stringify(value));
+	} catch (cause) {
+		throw new VoiceInputError({
+			code: "network-error",
+			message: "Unable to send data to Deepgram.",
+			provider: "deepgram",
+			retryable: true,
+			cause
+		});
+	}
+}
+function parseRetryAfter(value) {
+	if (value === null) return;
+	const seconds = Number(value);
+	if (Number.isFinite(seconds) && seconds >= 0) return Math.ceil(seconds * 1e3);
+	const date = Date.parse(value);
+	return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
+}
+function throwIfAborted(signal) {
+	if (signal.aborted) throw signal.reason;
+}
+function nonEmpty(value) {
+	return typeof value === "string" && value.length > 0;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { DEEPGRAM_DEFAULT_MODEL, deepgram };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { sendWithBackpressure } from \"@voiceinput/provider/transport\";\nimport {\n  VoiceInputError,\n  type VoiceInputProviderV1,\n  type VoiceInputProviderV1CallOptions,\n  type VoiceInputProviderV1Session,\n  type VoiceInputProviderV1StreamPart,\n  type VoiceTranscriptionOptions,\n} from \"@voiceinput/provider\";\n\nimport {\n  DEEPGRAM_DEFAULT_MODEL,\n  DEEPGRAM_SAMPLE_RATE,\n  createDeepgramRealtimeUrl,\n  validateDeepgramConfiguration,\n  type DeepgramRealtimeSettings,\n  type DeepgramSessionConfiguration,\n} from \"./session-config.js\";\n\nconst DEFAULT_REALTIME_URL = \"wss://api.deepgram.com/v1/listen\";\n\nexport interface DeepgramVoiceInputProviderOptions extends DeepgramRealtimeSettings {\n  readonly tokenEndpoint: string | URL;\n  readonly model?: string;\n  readonly fetch?: typeof globalThis.fetch;\n  readonly webSocket?: typeof globalThis.WebSocket;\n  readonly realtimeUrl?: string;\n}\n\nexport function deepgram(\n  options: DeepgramVoiceInputProviderOptions,\n): VoiceInputProviderV1 {\n  const model = factoryString(options.model ?? DEEPGRAM_DEFAULT_MODEL, \"model\");\n  const tokenEndpoint = factoryString(\n    String(options.tokenEndpoint),\n    \"tokenEndpoint\",\n  );\n  const realtimeUrl = factoryString(\n    options.realtimeUrl ?? DEFAULT_REALTIME_URL,\n    \"realtimeUrl\",\n  );\n  const providerSettings: DeepgramRealtimeSettings = {\n    ...(options.smartFormat === undefined\n      ? {}\n      : { smartFormat: options.smartFormat }),\n    ...(options.punctuate === undefined\n      ? {}\n      : { punctuate: options.punctuate }),\n    ...(options.profanityFilter === undefined\n      ? {}\n      : { profanityFilter: options.profanityFilter }),\n    ...(options.numerals === undefined ? {} : { numerals: options.numerals }),\n  };\n  const validateProviderOptions = (\n    transcriptionOptions: VoiceTranscriptionOptions,\n  ): void => {\n    try {\n      validateDeepgramConfiguration({\n        model,\n        ...providerSettings,\n        ...transcriptionOptions,\n      });\n    } catch (cause) {\n      if (VoiceInputError.isInstance(cause)) {\n        throw cause;\n      }\n      throw invalidConfiguration(cause);\n    }\n  };\n\n  return Object.freeze({\n    specificationVersion: \"v1\" as const,\n    provider: \"deepgram\",\n    modelId: model,\n    sampleRate: DEEPGRAM_SAMPLE_RATE,\n    validateOptions: validateProviderOptions,\n    async doOpen(callOptions: VoiceInputProviderV1CallOptions) {\n      validateProviderOptions(callOptions);\n      const configuration = validateDeepgramConfiguration({\n        model,\n        ...providerSettings,\n        ...callOptions,\n      });\n      return await openSession({\n        abortSignal: callOptions.abortSignal,\n        configuration,\n        fetchImplementation: options.fetch ?? globalThis.fetch,\n        realtimeUrl,\n        tokenEndpoint,\n        WebSocketImplementation: options.webSocket ?? globalThis.WebSocket,\n      });\n    },\n  });\n}\n\nasync function openSession(options: {\n  abortSignal: AbortSignal;\n  configuration: DeepgramSessionConfiguration;\n  fetchImplementation: typeof globalThis.fetch;\n  realtimeUrl: string;\n  tokenEndpoint: string;\n  WebSocketImplementation: typeof globalThis.WebSocket;\n}): Promise<VoiceInputProviderV1Session> {\n  throwIfAborted(options.abortSignal);\n  requireBrowserFunction(options.fetchImplementation, \"fetch\");\n  requireBrowserFunction(options.WebSocketImplementation, \"WebSocket\");\n  const token = await requestToken(\n    options.fetchImplementation,\n    options.tokenEndpoint,\n    options.configuration.model,\n    options.abortSignal,\n  );\n  throwIfAborted(options.abortSignal);\n  const socket = new options.WebSocketImplementation(\n    createDeepgramRealtimeUrl(options.realtimeUrl, options.configuration),\n    [\"bearer\", token],\n  );\n  return await createSession(socket, options.abortSignal);\n}\n\nasync function requestToken(\n  fetchImplementation: typeof globalThis.fetch,\n  tokenEndpoint: string,\n  model: string,\n  abortSignal: AbortSignal,\n): Promise<string> {\n  let response: Response;\n  try {\n    response = await fetchImplementation(tokenEndpoint, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ model }),\n      credentials: \"same-origin\",\n      signal: abortSignal,\n    });\n  } catch (cause) {\n    throwIfAborted(abortSignal);\n    throw new VoiceInputError({\n      code: \"network-error\",\n      message: \"Unable to reach the Deepgram token endpoint.\",\n      provider: \"deepgram\",\n      retryable: true,\n      cause,\n    });\n  }\n  if (!response.ok) {\n    throw await tokenResponseError(response);\n  }\n  let value: unknown;\n  try {\n    value = await response.json();\n  } catch (cause) {\n    throw new VoiceInputError({\n      code: \"token-error\",\n      message: \"The Deepgram token endpoint returned invalid JSON.\",\n      provider: \"deepgram\",\n      cause,\n    });\n  }\n  if (!isRecord(value) || !nonEmpty(value[\"access_token\"])) {\n    throw new VoiceInputError({\n      code: \"token-error\",\n      message: \"The Deepgram token endpoint returned an invalid token.\",\n      provider: \"deepgram\",\n    });\n  }\n  return value[\"access_token\"];\n}\n\nasync function createSession(\n  socket: WebSocket,\n  abortSignal: AbortSignal,\n): Promise<VoiceInputProviderV1Session> {\n  let controller:\n    ReadableStreamDefaultController<VoiceInputProviderV1StreamPart> | undefined;\n  const stream = new ReadableStream<VoiceInputProviderV1StreamPart>({\n    start(value) {\n      controller = value;\n    },\n  });\n  if (controller === undefined) {\n    throw new VoiceInputError({\n      code: \"provider-error\",\n      message: \"Unable to initialize the Deepgram transcript stream.\",\n      provider: \"deepgram\",\n    });\n  }\n\n  let audioSent = false;\n  let closed = false;\n  let failed = false;\n  let finishing = false;\n  const closedSegments = new Set<string>();\n  let lastInterim = \"\";\n  let speechActive = false;\n\n  const closeSocket = (reason: \"aborted\" | \"finished\"): void => {\n    if (socket.readyState === 0 || socket.readyState === 1) {\n      socket.close(1000, reason);\n    }\n  };\n  const closeStream = (): void => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    abortSignal.removeEventListener(\"abort\", abort);\n    controller?.close();\n  };\n  const finishCleanly = (): void => {\n    closeStream();\n    closeSocket(\"finished\");\n  };\n  const fail = (error: VoiceInputError): void => {\n    if (closed || failed) {\n      return;\n    }\n    failed = true;\n    controller?.enqueue({ type: \"error\", error });\n    closeStream();\n    closeSocket(\"aborted\");\n  };\n  const startSpeech = (): void => {\n    if (!speechActive) {\n      speechActive = true;\n      controller?.enqueue({ type: \"speech-start\" });\n    }\n  };\n  const endSpeech = (): void => {\n    if (speechActive) {\n      speechActive = false;\n      controller?.enqueue({ type: \"speech-end\" });\n    }\n  };\n  const handleResults = (value: Record<string, unknown>): void => {\n    const channel = value[\"channel\"];\n    if (!isRecord(channel) || !Array.isArray(channel[\"alternatives\"])) {\n      throw new TypeError(\"Deepgram Results did not contain alternatives.\");\n    }\n    const alternative = channel[\"alternatives\"][0];\n    if (\n      !isRecord(alternative) ||\n      typeof alternative[\"transcript\"] !== \"string\"\n    ) {\n      throw new TypeError(\"Deepgram Results did not contain a transcript.\");\n    }\n    const text = alternative[\"transcript\"];\n    const isFinal = value[\"is_final\"] === true;\n    const start = value[\"start\"];\n    if (typeof start !== \"number\" || !Number.isFinite(start) || start < 0)\n      throw new TypeError(\n        \"Deepgram Results did not contain an audio start boundary.\",\n      );\n    const segmentId = `audio:${start}`;\n    if (closedSegments.has(segmentId)) return;\n    if (text.length > 0 || isFinal) {\n      if (text.length > 0) startSpeech();\n      if (isFinal) {\n        closedSegments.add(segmentId);\n        controller?.enqueue({ type: \"final\", text, segmentId });\n        lastInterim = \"\";\n      } else if (text !== lastInterim) {\n        lastInterim = text;\n        controller?.enqueue({ type: \"interim\", text, segmentId });\n      }\n    }\n    if (value[\"speech_final\"] === true) {\n      endSpeech();\n    }\n  };\n  const handleMessage = (event: MessageEvent): void => {\n    if (closed) {\n      return;\n    }\n    try {\n      const value = JSON.parse(String(event.data)) as unknown;\n      if (!isRecord(value) || !nonEmpty(value[\"type\"])) {\n        throw new TypeError(\"Deepgram sent an invalid streaming event.\");\n      }\n      const type = value[\"type\"];\n      if (type === \"Results\") {\n        handleResults(value);\n      } else if (type === \"SpeechStarted\") {\n        startSpeech();\n      } else if (type === \"UtteranceEnd\") {\n        endSpeech();\n      } else if (type === \"Error\") {\n        fail(normalizeMessageError(value));\n      }\n    } catch (cause) {\n      fail(\n        new VoiceInputError({\n          code: \"provider-error\",\n          message: \"Deepgram sent an invalid streaming event.\",\n          provider: \"deepgram\",\n          cause,\n        }),\n      );\n    }\n  };\n  const handleClose = (event: CloseEvent): void => {\n    if (closed) {\n      return;\n    }\n    if (event.code === 1000) {\n      closeStream();\n    } else {\n      fail(normalizeCloseError(event));\n    }\n  };\n  function abort(): void {\n    if (closed) {\n      return;\n    }\n    closeStream();\n    closeSocket(\"aborted\");\n  }\n\n  socket.addEventListener(\"message\", handleMessage);\n  socket.addEventListener(\"close\", handleClose);\n  socket.addEventListener(\"error\", () => {\n    fail(\n      new VoiceInputError({\n        code: \"network-error\",\n        message: \"The Deepgram streaming connection failed.\",\n        provider: \"deepgram\",\n        retryable: true,\n      }),\n    );\n  });\n  abortSignal.addEventListener(\"abort\", abort, { once: true });\n  await waitForOpen(socket, abortSignal);\n\n  return {\n    stream,\n    sendAudio(chunk) {\n      if (closed || finishing || chunk.length === 0) {\n        return;\n      }\n      audioSent = true;\n      try {\n        return sendWithBackpressure(\n          socket,\n          chunk.byteLength,\n          abortSignal,\n          \"deepgram\",\n          () => socket.send(new Int16Array(chunk).buffer),\n        );\n      } catch (cause) {\n        throw new VoiceInputError({\n          code: \"network-error\",\n          message: \"Unable to send audio to Deepgram.\",\n          provider: \"deepgram\",\n          retryable: true,\n          cause,\n        });\n      }\n    },\n    finish() {\n      if (closed || finishing) {\n        return;\n      }\n      finishing = true;\n      if (!audioSent) {\n        finishCleanly();\n        return;\n      }\n      sendJson(socket, { type: \"CloseStream\" });\n    },\n    abort,\n  };\n}\n\nfunction normalizeMessageError(\n  value: Record<string, unknown>,\n): VoiceInputError {\n  const code = typeof value[\"code\"] === \"string\" ? value[\"code\"] : \"\";\n  const description =\n    typeof value[\"description\"] === \"string\"\n      ? value[\"description\"]\n      : typeof value[\"message\"] === \"string\"\n        ? value[\"message\"]\n        : \"\";\n  const source = `${code} ${description}`;\n  const rateLimited = /rate|quota|429/iu.test(source);\n  const unauthorized = /auth|unauthorized|401|403/iu.test(source);\n  return new VoiceInputError({\n    code: unauthorized\n      ? \"unauthorized\"\n      : rateLimited\n        ? \"rate-limited\"\n        : \"provider-error\",\n    message: description || \"Deepgram reported a streaming error.\",\n    provider: \"deepgram\",\n    retryable: rateLimited || /internal|unavailable/iu.test(source),\n    cause: value,\n  });\n}\n\nfunction normalizeCloseError(event: CloseEvent): VoiceInputError {\n  const reason = event.reason ?? \"\";\n  const rateLimited = event.code === 1013 || /rate|quota|429/iu.test(reason);\n  const unauthorized = /auth|unauthorized|401|403/iu.test(reason);\n  const invalidAudio =\n    event.code === 1008 && /data|audio|decode/iu.test(reason);\n  return new VoiceInputError({\n    code: unauthorized\n      ? \"unauthorized\"\n      : rateLimited\n        ? \"rate-limited\"\n        : invalidAudio\n          ? \"audio-error\"\n          : \"network-error\",\n    message: \"The Deepgram streaming connection closed unexpectedly.\",\n    provider: \"deepgram\",\n    retryable: rateLimited || (!unauthorized && !invalidAudio),\n    cause: event,\n  });\n}\n\nfunction invalidConfiguration(cause: unknown): VoiceInputError {\n  return new VoiceInputError({\n    code: \"invalid-configuration\",\n    message:\n      cause instanceof Error\n        ? cause.message\n        : \"Invalid Deepgram transcription options.\",\n    provider: \"deepgram\",\n    cause,\n  });\n}\n\nfunction requireBrowserFunction(value: unknown, feature: string): void {\n  if (typeof value !== \"function\") {\n    throw new VoiceInputError({\n      code: \"unsupported-browser\",\n      message: `Deepgram voice input requires browser ${feature} support.`,\n      provider: \"deepgram\",\n    });\n  }\n}\n\nfunction factoryString(value: string, name: string): string {\n  if (value.trim().length === 0) {\n    throw invalidConfiguration(new TypeError(`${name} must be non-empty.`));\n  }\n  return value;\n}\n\nasync function tokenResponseError(\n  response: Response,\n): Promise<VoiceInputError> {\n  const retryAfterMs = parseRetryAfter(response.headers.get(\"Retry-After\"));\n  if (response.status === 401 || response.status === 403) {\n    return new VoiceInputError({\n      code: \"unauthorized\",\n      message: \"The Deepgram token endpoint rejected this request.\",\n      provider: \"deepgram\",\n    });\n  }\n  if (response.status === 429) {\n    return new VoiceInputError({\n      code: \"rate-limited\",\n      message: \"The Deepgram token endpoint rate limit was exceeded.\",\n      provider: \"deepgram\",\n      retryable: true,\n      ...(retryAfterMs === undefined ? {} : { retryAfterMs }),\n    });\n  }\n  const safeError = await readSafeTokenError(response);\n  if (safeError !== undefined) {\n    return new VoiceInputError({ ...safeError, provider: \"deepgram\" });\n  }\n  return new VoiceInputError({\n    code: \"token-error\",\n    message: \"The Deepgram token endpoint did not issue a token.\",\n    provider: \"deepgram\",\n    retryable: response.status >= 500,\n  });\n}\n\nasync function readSafeTokenError(response: Response): Promise<\n  | {\n      code: \"invalid-configuration\" | \"unsupported-feature\";\n      message: string;\n    }\n  | undefined\n> {\n  if (\n    response.status !== 400 ||\n    response.headers.get(\"X-VoiceInput-Error\") !== \"1\" ||\n    response.headers.get(\"Content-Type\")?.split(\";\", 1)[0]?.trim() !==\n      \"application/json\"\n  ) {\n    return undefined;\n  }\n  const text = await readBoundedErrorText(response);\n  if (text === undefined) return undefined;\n  try {\n    const value = JSON.parse(text) as unknown;\n    const error = isRecord(value) ? value[\"error\"] : undefined;\n    if (\n      !isRecord(error) ||\n      (error[\"code\"] !== \"invalid-configuration\" &&\n        error[\"code\"] !== \"unsupported-feature\") ||\n      typeof error[\"message\"] !== \"string\" ||\n      error[\"message\"].length === 0 ||\n      error[\"message\"].length > 1_000\n    ) {\n      return undefined;\n    }\n    return { code: error[\"code\"], message: error[\"message\"] };\n  } catch {\n    return undefined;\n  }\n}\n\nasync function readBoundedErrorText(\n  response: Response,\n): Promise<string | undefined> {\n  const reader = response.body?.getReader();\n  if (reader === undefined) return undefined;\n  const decoder = new TextDecoder();\n  let bytesRead = 0;\n  let text = \"\";\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) return text + decoder.decode();\n      bytesRead += value.byteLength;\n      if (bytesRead > 4_096) {\n        await reader.cancel().catch(() => {});\n        return undefined;\n      }\n      text += decoder.decode(value, { stream: true });\n    }\n  } catch {\n    return undefined;\n  }\n}\n\nfunction waitForOpen(\n  socket: WebSocket,\n  abortSignal: AbortSignal,\n): Promise<void> {\n  if (socket.readyState === 1) {\n    return Promise.resolve();\n  }\n  return new Promise((resolve, reject) => {\n    const cleanup = (): void => {\n      socket.removeEventListener(\"open\", handleOpen);\n      socket.removeEventListener(\"error\", handleError);\n      abortSignal.removeEventListener(\"abort\", handleAbort);\n    };\n    const handleOpen = (): void => {\n      cleanup();\n      resolve();\n    };\n    const handleError = (event: Event): void => {\n      cleanup();\n      reject(\n        new VoiceInputError({\n          code: \"network-error\",\n          message: \"Unable to open the Deepgram streaming connection.\",\n          provider: \"deepgram\",\n          retryable: true,\n          cause: event,\n        }),\n      );\n    };\n    const handleAbort = (): void => {\n      cleanup();\n      reject(abortSignal.reason);\n    };\n    socket.addEventListener(\"open\", handleOpen, { once: true });\n    socket.addEventListener(\"error\", handleError, { once: true });\n    abortSignal.addEventListener(\"abort\", handleAbort, { once: true });\n  });\n}\n\nfunction sendJson(socket: WebSocket, value: Record<string, unknown>): void {\n  try {\n    socket.send(JSON.stringify(value));\n  } catch (cause) {\n    throw new VoiceInputError({\n      code: \"network-error\",\n      message: \"Unable to send data to Deepgram.\",\n      provider: \"deepgram\",\n      retryable: true,\n      cause,\n    });\n  }\n}\n\nfunction parseRetryAfter(value: string | null): number | undefined {\n  if (value === null) {\n    return undefined;\n  }\n  const seconds = Number(value);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.ceil(seconds * 1_000);\n  }\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n}\n\nfunction throwIfAborted(signal: AbortSignal): void {\n  if (signal.aborted) {\n    throw signal.reason;\n  }\n}\n\nfunction nonEmpty(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport { DEEPGRAM_DEFAULT_MODEL } from \"./session-config.js\";\n"],"mappings":"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"}

package/dist/server.cjs

@@ -0,0 +1,167 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./session-config-aoO2eGMT.cjs");
+//#region src/server.ts
+const DEFAULT_GRANT_URL = "https://api.deepgram.com/v1/auth/grant";
+const DEFAULT_TTL_SECONDS = 30;
+const MAX_TOKEN_REQUEST_BYTES = 16384;
+function createDeepgramTokenHandler(options) {
+	const defaultModel = nonEmpty(options.model ?? "nova-3", "model");
+	const allowedModels = new Set(options.allowedModels ?? [defaultModel]);
+	if (!allowedModels.has(defaultModel)) throw new TypeError("allowedModels must contain the default model.");
+	if (typeof options.authorize !== "function") throw new TypeError("authorize must be a function.");
+	const apiKey = nonEmpty(options.apiKey, "apiKey");
+	const ttlSeconds = validateTtl(options.ttlSeconds ?? DEFAULT_TTL_SECONDS);
+	const fetchImplementation = options.fetch ?? globalThis.fetch;
+	const grantUrl = options.grantUrl ?? DEFAULT_GRANT_URL;
+	return async (request) => {
+		if (request.method !== "POST") return jsonError(405, "invalid-request", "Method not allowed.", { Allow: "POST" });
+		try {
+			const requestBody = await readJsonBody(request);
+			const authorization = await options.authorize(copyRequest(request, requestBody));
+			if (authorization === null) return jsonError(401, "unauthorized", "Unauthorized.");
+			const subject = nonEmpty(authorization.subject, "subject");
+			const model = readModel(requestBody, defaultModel);
+			if (!allowedModels.has(model)) return jsonError(400, "invalid-configuration", "The requested Deepgram model is not allowed.");
+			const context = {
+				request: copyRequest(request, requestBody),
+				subject,
+				model
+			};
+			const limit = await options.rateLimit?.(context);
+			if (limit?.allowed === false) {
+				const retryAfter = normalizeRetryAfter(limit.retryAfterSeconds);
+				return jsonError(429, "rate-limited", "Rate limit exceeded.", retryAfter === void 0 ? {} : { "Retry-After": String(retryAfter) });
+			}
+			const response = await fetchImplementation(grantUrl, {
+				method: "POST",
+				headers: {
+					Authorization: `Token ${apiKey}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify({ ttl_seconds: ttlSeconds }),
+				signal: request.signal
+			});
+			if (!response.ok) {
+				if (response.status === 429) return jsonError(429, "rate-limited", "Deepgram rate limit exceeded.", copyRetryAfter(response.headers));
+				return jsonError(502, "token-error", "Deepgram did not issue a temporary token.");
+			}
+			const token = validateToken(await response.json());
+			await options.onTokenIssued?.({
+				provider: "deepgram",
+				subject,
+				model,
+				expiresIn: token.expires_in
+			});
+			return Response.json(token, { headers: { "Cache-Control": "no-store" } });
+		} catch (error) {
+			if (request.signal.aborted) return jsonError(499, "network-error", "The request was cancelled.");
+			if (error instanceof InvalidTokenRequestError) return jsonError(error.status, error.code, error.message);
+			return jsonError(500, "token-error", "Unable to issue a Deepgram temporary token.");
+		}
+	};
+}
+function readModel(body, defaultModel) {
+	try {
+		if (body.length === 0) return defaultModel;
+		const value = JSON.parse(body);
+		if (!isRecord(value) || Object.keys(value).some((key) => key !== "model")) throw new TypeError("The token request must contain only model.");
+		return value["model"] === void 0 ? defaultModel : nonEmpty(value["model"], "model");
+	} catch (cause) {
+		if (cause instanceof SyntaxError || cause instanceof TypeError) throw new InvalidTokenRequestError(cause.message);
+		throw cause;
+	}
+}
+function copyRequest(request, body) {
+	return new Request(request, {
+		method: "POST",
+		body,
+		referrer: request.referrer,
+		referrerPolicy: request.referrerPolicy
+	});
+}
+function validateTtl(value) {
+	if (!Number.isInteger(value) || value < 1 || value > 3600) throw new TypeError("ttlSeconds must be an integer from 1 to 3600.");
+	return value;
+}
+function validateToken(value) {
+	if (!isRecord(value) || typeof value["access_token"] !== "string" || value["access_token"].length === 0 || typeof value["expires_in"] !== "number" || !Number.isFinite(value["expires_in"]) || value["expires_in"] <= 0) throw new Error("Deepgram returned an invalid token.");
+	return {
+		access_token: value["access_token"],
+		expires_in: value["expires_in"]
+	};
+}
+var InvalidTokenRequestError = class extends Error {
+	code;
+	status;
+	constructor(message, code = "invalid-configuration", status = 400) {
+		super(message);
+		this.code = code;
+		this.status = status;
+		this.name = "InvalidTokenRequestError";
+	}
+};
+async function readJsonBody(request) {
+	if (request.headers.get("Content-Type")?.split(";", 1)[0]?.trim().toLowerCase() !== "application/json") throw new InvalidTokenRequestError("Content-Type must be application/json.", "invalid-request", 415);
+	if (Number(request.headers.get("Content-Length")) > MAX_TOKEN_REQUEST_BYTES) throw requestTooLarge();
+	const reader = request.body?.getReader();
+	if (reader === void 0) return "";
+	const decoder = new TextDecoder("utf-8", { fatal: true });
+	let bytesRead = 0;
+	let text = "";
+	while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		bytesRead += value.byteLength;
+		if (bytesRead > MAX_TOKEN_REQUEST_BYTES) {
+			await reader.cancel().catch(() => {});
+			throw requestTooLarge();
+		}
+		try {
+			text += decoder.decode(value, { stream: true });
+		} catch {
+			await reader.cancel().catch(() => {});
+			throw invalidUtf8();
+		}
+	}
+	try {
+		return text + decoder.decode();
+	} catch {
+		throw invalidUtf8();
+	}
+}
+function requestTooLarge() {
+	return new InvalidTokenRequestError(`Token request body exceeds ${MAX_TOKEN_REQUEST_BYTES} bytes.`, "invalid-request", 413);
+}
+function invalidUtf8() {
+	return new InvalidTokenRequestError("Token request body must be valid UTF-8.", "invalid-request");
+}
+function jsonError(status, code, message, headers = {}) {
+	const responseHeaders = new Headers(headers);
+	responseHeaders.set("Cache-Control", "no-store");
+	responseHeaders.set("X-VoiceInput-Error", "1");
+	return Response.json({ error: {
+		code,
+		message
+	} }, {
+		status,
+		headers: responseHeaders
+	});
+}
+function copyRetryAfter(headers) {
+	const value = headers.get("Retry-After");
+	return value === null ? {} : { "Retry-After": value };
+}
+function normalizeRetryAfter(value) {
+	return value === void 0 || !Number.isFinite(value) || value <= 0 ? void 0 : Math.ceil(value);
+}
+function nonEmpty(value, name) {
+	if (typeof value !== "string" || value.trim().length === 0) throw new TypeError(`${name} must be a non-empty string.`);
+	return value;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+exports.createDeepgramTokenHandler = createDeepgramTokenHandler;
+
+//# sourceMappingURL=server.cjs.map