@happyvertical/speech 0.97.0 → 0.98.0

package/dist/chunks/registry-DfID41Ew.js

@@ -0,0 +1,343 @@
+//#region src/shared/errors.ts
+var SpeechError = class extends Error {
+	code;
+	adapter;
+	constructor(message, code, adapter) {
+		super(message);
+		this.code = code;
+		this.adapter = adapter;
+		this.name = "SpeechError";
+	}
+};
+var SpeechConfigurationError = class extends SpeechError {
+	constructor(message, adapter) {
+		super(message, "SPEECH_CONFIGURATION_ERROR", adapter);
+		this.name = "SpeechConfigurationError";
+	}
+};
+var InvalidSpeechAdapterError = class extends SpeechError {
+	constructor(type, kind) {
+		super(`Invalid ${kind} speech adapter type: ${type}`, "INVALID_ADAPTER");
+		this.name = "InvalidSpeechAdapterError";
+	}
+};
+var SpeechProviderError = class extends SpeechError {
+	status;
+	responseBody;
+	/** Parsed `Retry-After` delay in milliseconds, when the provider sent one. */
+	retryAfterMs;
+	constructor(adapter, message, options = {}) {
+		super(message, "SPEECH_PROVIDER_ERROR", adapter);
+		this.name = "SpeechProviderError";
+		this.status = options.status;
+		this.responseBody = options.responseBody;
+		this.retryAfterMs = options.retryAfterMs;
+		if (options.cause !== void 0) this.cause = options.cause;
+	}
+};
+//#endregion
+//#region src/shared/audio.ts
+/**
+* Audio input normalisation shared by speech adapters: accepts the input
+* shapes callers actually have (Blob, Buffer, Uint8Array, ArrayBuffer,
+* ReadableStream), enforces byte limits while buffering, and derives a
+* multipart filename whose extension matches the MIME type.
+*/
+/** OpenAI caps `/audio/transcriptions` uploads at 25 MB. */
+var DEFAULT_MAX_AUDIO_BYTES = 25 * 1024 * 1024;
+var MIME_EXTENSIONS = {
+	"audio/webm": "webm",
+	"video/webm": "webm",
+	"audio/mp4": "m4a",
+	"audio/m4a": "m4a",
+	"audio/x-m4a": "m4a",
+	"video/mp4": "mp4",
+	"audio/wav": "wav",
+	"audio/wave": "wav",
+	"audio/x-wav": "wav",
+	"audio/vnd.wave": "wav",
+	"audio/ogg": "ogg",
+	"application/ogg": "ogg",
+	"audio/mpeg": "mp3",
+	"audio/mp3": "mp3",
+	"audio/mpga": "mp3",
+	"audio/flac": "flac",
+	"audio/x-flac": "flac"
+};
+/**
+* Strips parameters (e.g. `;codecs=opus`) and lower-cases a MIME type.
+* Returns `undefined` for blank input.
+*/
+function normalizeMimeType(mimeType) {
+	const essence = mimeType?.split(";")[0]?.trim().toLowerCase();
+	return essence ? essence : void 0;
+}
+/**
+* Maps an audio MIME type to the file extension OpenAI-compatible servers use
+* to detect the container format. Codec parameters are ignored, so
+* `audio/webm;codecs=opus` maps to `webm`. Returns `undefined` when unknown.
+*/
+function mimeTypeToAudioExtension(mimeType) {
+	const essence = normalizeMimeType(mimeType);
+	return essence ? MIME_EXTENSIONS[essence] : void 0;
+}
+/**
+* Accepts either an {@link AudioInput} wrapper or a bare {@link AudioSource}
+* and returns a size-checked Blob plus the metadata needed for multipart
+* uploads.
+*/
+async function normalizeAudioInput(input, options = {}) {
+	const wrapped = isAudioInput(input) ? input : { data: input };
+	const { adapter, signal } = options;
+	signal?.throwIfAborted();
+	const maxBytes = resolveMaxBytes(options.maxBytes, adapter);
+	const data = wrapped.data;
+	const blobType = typeof Blob !== "undefined" && data instanceof Blob ? data.type : void 0;
+	const mimeType = options.mimeType ?? wrapped.mimeType ?? wrapped.contentType ?? (blobType || void 0) ?? "application/octet-stream";
+	let blob;
+	if (typeof Blob !== "undefined" && data instanceof Blob) {
+		assertWithinLimit(data.size, maxBytes, adapter);
+		blob = data.type === mimeType ? data : new Blob([data], { type: mimeType });
+	} else if (data instanceof Uint8Array) {
+		assertWithinLimit(data.byteLength, maxBytes, adapter);
+		blob = new Blob([copyBytes(data)], { type: mimeType });
+	} else if (data instanceof ArrayBuffer) {
+		assertWithinLimit(data.byteLength, maxBytes, adapter);
+		blob = new Blob([data], { type: mimeType });
+	} else if (isReadableStream(data)) {
+		const chunks = await readStreamWithLimit(data, maxBytes, adapter, signal);
+		blob = new Blob(chunks, { type: mimeType });
+	} else throw new SpeechConfigurationError("Unsupported audio input: expected Blob, Buffer, Uint8Array, ArrayBuffer, or ReadableStream", adapter);
+	if (blob.size === 0) throw new SpeechConfigurationError("Audio input is empty", adapter);
+	const extension = options.deriveExtension === false ? void 0 : mimeTypeToAudioExtension(mimeType);
+	const basename = options.defaultBasename ?? "audio";
+	const filename = wrapped.filename ?? (extension ? `${basename}.${extension}` : basename);
+	return {
+		blob,
+		mimeType,
+		bytes: blob.size,
+		filename,
+		durationSeconds: wrapped.durationSeconds
+	};
+}
+function isAudioInput(value) {
+	return typeof value === "object" && value !== null && "data" in value && !(typeof Blob !== "undefined" && value instanceof Blob) && !(value instanceof Uint8Array) && !(value instanceof ArrayBuffer) && !isReadableStream(value);
+}
+function isReadableStream(value) {
+	return typeof value === "object" && value !== null && typeof value.getReader === "function";
+}
+function resolveMaxBytes(maxBytes, adapter) {
+	if (maxBytes === void 0) return Number.POSITIVE_INFINITY;
+	if (Number.isNaN(maxBytes) || maxBytes <= 0) throw new SpeechConfigurationError("maxBytes must be a positive number", adapter);
+	return maxBytes;
+}
+function assertWithinLimit(bytes, maxBytes, adapter) {
+	if (bytes > maxBytes) throw new SpeechConfigurationError(`Audio input exceeds maxBytes (${bytes} > ${maxBytes} bytes)`, adapter);
+}
+async function readStreamWithLimit(stream, maxBytes, adapter, signal) {
+	const reader = stream.getReader();
+	const chunks = [];
+	let total = 0;
+	const onAbort = () => {
+		reader.cancel(signal?.reason).catch(() => void 0);
+	};
+	signal?.addEventListener("abort", onAbort, { once: true });
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			signal?.throwIfAborted();
+			if (done) break;
+			total += chunkByteLength(value, adapter);
+			if (total > maxBytes) {
+				await reader.cancel().catch(() => void 0);
+				throw new SpeechConfigurationError(`Audio stream exceeds maxBytes (more than ${maxBytes} bytes)`, adapter);
+			}
+			chunks.push(toBytes(value));
+		}
+	} finally {
+		signal?.removeEventListener("abort", onAbort);
+		reader.releaseLock();
+	}
+	return chunks;
+}
+function chunkByteLength(value, adapter) {
+	if (value instanceof Uint8Array || value instanceof ArrayBuffer) return value.byteLength;
+	throw new SpeechConfigurationError("Audio stream chunks must be Uint8Array or ArrayBuffer", adapter);
+}
+function toBytes(value) {
+	return value instanceof Uint8Array ? copyBytes(value) : new Uint8Array(value.slice(0));
+}
+function copyBytes(bytes) {
+	const copy = new Uint8Array(bytes.byteLength);
+	copy.set(bytes);
+	return copy;
+}
+//#endregion
+//#region src/shared/usage.ts
+/**
+* Invokes every configured usage callback in order (adapter-level first, then
+* request-level). Callback errors propagate to the caller so that billing
+* hooks never fail silently.
+*/
+async function reportSpeechUsage(usage, ...callbacks) {
+	for (const callback of callbacks) if (callback) await callback(usage);
+}
+/**
+* Extracts audio seconds from an OpenAI-style `usage` block
+* (`{ type: 'duration', seconds }`).
+*/
+function audioSecondsFromProviderUsage(providerUsage) {
+	if (!providerUsage) return;
+	const seconds = providerUsage.seconds;
+	return typeof seconds === "number" && Number.isFinite(seconds) ? seconds : void 0;
+}
+//#endregion
+//#region src/shared/env.ts
+/**
+* Environment configuration for speech adapters.
+*
+* Transcriber settings resolve in this order (first wins):
+* explicit options → factory context → `HAVE_SPEECH_TRANSCRIBER_*` →
+* legacy `HAVE_SPEECH_STT_*` → gateway `STT_*` aliases.
+*/
+/** Environment variable names read for each transcriber setting, in priority order. */
+var TRANSCRIBER_ENV_KEYS = {
+	type: [
+		"HAVE_SPEECH_TRANSCRIBER_TYPE",
+		"HAVE_SPEECH_STT_TYPE",
+		"HAVE_SPEECH_STT_ADAPTER",
+		"STT_ADAPTER"
+	],
+	baseUrl: [
+		"HAVE_SPEECH_TRANSCRIBER_BASE_URL",
+		"HAVE_SPEECH_STT_BASE_URL",
+		"STT_BASE_URL"
+	],
+	model: [
+		"HAVE_SPEECH_TRANSCRIBER_MODEL",
+		"HAVE_SPEECH_STT_MODEL",
+		"STT_MODEL"
+	],
+	apiKey: [
+		"HAVE_SPEECH_TRANSCRIBER_API_KEY",
+		"HAVE_SPEECH_STT_API_KEY",
+		"STT_API_KEY",
+		"SPEECH_API_KEY"
+	],
+	timeoutMs: [
+		"HAVE_SPEECH_TRANSCRIBER_TIMEOUT",
+		"HAVE_SPEECH_TRANSCRIBER_TIMEOUT_MS",
+		"HAVE_SPEECH_STT_TIMEOUT_MS",
+		"STT_TIMEOUT_MS"
+	],
+	maxBytes: ["HAVE_SPEECH_TRANSCRIBER_MAX_BYTES", "STT_MAX_BYTES"],
+	headers: ["HAVE_SPEECH_TRANSCRIBER_HEADERS", "STT_HEADERS"],
+	path: [
+		"HAVE_SPEECH_TRANSCRIBER_PATH",
+		"HAVE_SPEECH_STT_PATH",
+		"STT_PATH"
+	]
+};
+function readTranscriberEnv(env) {
+	return {
+		type: readEnv(env, ...TRANSCRIBER_ENV_KEYS.type),
+		baseUrl: readEnv(env, ...TRANSCRIBER_ENV_KEYS.baseUrl),
+		model: readEnv(env, ...TRANSCRIBER_ENV_KEYS.model),
+		apiKey: readEnv(env, ...TRANSCRIBER_ENV_KEYS.apiKey),
+		timeoutMs: parseOptionalInteger(readEnv(env, ...TRANSCRIBER_ENV_KEYS.timeoutMs)),
+		maxBytes: parseOptionalInteger(readEnv(env, ...TRANSCRIBER_ENV_KEYS.maxBytes)),
+		headers: parseHeadersEnv(env, TRANSCRIBER_ENV_KEYS.headers),
+		path: readEnv(env, ...TRANSCRIBER_ENV_KEYS.path)
+	};
+}
+function hasTranscriberEnv(env) {
+	return hasAnyEnv(env, ...TRANSCRIBER_ENV_KEYS.type, ...TRANSCRIBER_ENV_KEYS.baseUrl);
+}
+/**
+* Merges explicit transcriber options with the factory context and the
+* environment. Explicit options always win; headers are merged so a
+* per-deployment env header (e.g. a gateway virtual key) can be combined with
+* explicit ones.
+*/
+function resolveTranscriberConfig(options = {}, context = {}) {
+	const fromEnv = readTranscriberEnv(context.env ?? defaultEnv());
+	const headers = mergeHeaderInits(fromEnv.headers, context.headers, options.headers);
+	return {
+		type: options.type ?? fromEnv.type,
+		baseUrl: (options.baseUrl ?? fromEnv.baseUrl)?.trim(),
+		model: options.model ?? fromEnv.model,
+		apiKey: options.apiKey ?? fromEnv.apiKey,
+		timeoutMs: options.timeoutMs ?? fromEnv.timeoutMs,
+		maxBytes: options.maxBytes ?? fromEnv.maxBytes,
+		headers,
+		fetch: options.fetch ?? context.fetch,
+		path: fromEnv.path
+	};
+}
+/** Merges header sets left to right; later sets win per header name. */
+function mergeHeaderInits(...sets) {
+	const present = sets.filter((set) => Boolean(set));
+	if (present.length === 0) return;
+	const merged = new Headers();
+	for (const set of present) new Headers(set).forEach((value, key) => {
+		merged.set(key, value);
+	});
+	return merged;
+}
+function readEnv(env, ...keys) {
+	for (const key of keys) {
+		const value = env[key];
+		if (value?.trim()) return value.trim();
+	}
+}
+function hasAnyEnv(env, ...keys) {
+	return keys.some((key) => Boolean(env[key]?.trim()));
+}
+function parseOptionalInteger(value) {
+	if (!value) return;
+	const parsed = Number.parseInt(value, 10);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function defaultEnv() {
+	return globalThis.process?.env ?? {};
+}
+/**
+* Parses a JSON object of header names to string values. The raw value is
+* never echoed in errors because it may carry credentials.
+*/
+function parseHeadersEnv(env, keys) {
+	for (const key of keys) {
+		const raw = env[key]?.trim();
+		if (!raw) continue;
+		let parsed;
+		try {
+			parsed = JSON.parse(raw);
+		} catch {
+			throw new SpeechConfigurationError(`${key} must be a JSON object of header names to string values`);
+		}
+		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed) || !Object.values(parsed).every((value) => typeof value === "string")) throw new SpeechConfigurationError(`${key} must be a JSON object of header names to string values`);
+		return parsed;
+	}
+}
+//#endregion
+//#region src/shared/registry.ts
+/** Adapter types that are only available after importing a subpath. */
+var OPTIONAL_TRANSCRIBER_ENTRIES = { local: "@happyvertical/speech/local" };
+var registered = /* @__PURE__ */ new Map();
+function registerOptionalTranscriber(type, factory) {
+	registered.set(type, factory);
+}
+function getOptionalTranscriberFactory(type) {
+	return registered.get(type);
+}
+/** Subpath that registers `type`, when it is an opt-in adapter. */
+function optionalTranscriberEntry(type) {
+	return OPTIONAL_TRANSCRIBER_ENTRIES[type];
+}
+function registeredOptionalTranscribers() {
+	return [...registered.keys()];
+}
+//#endregion
+export { SpeechProviderError as C, SpeechError as S, mimeTypeToAudioExtension as _, TRANSCRIBER_ENV_KEYS as a, InvalidSpeechAdapterError as b, hasTranscriberEnv as c, parseOptionalInteger as d, readEnv as f, DEFAULT_MAX_AUDIO_BYTES as g, reportSpeechUsage as h, registeredOptionalTranscribers as i, mergeHeaderInits as l, audioSecondsFromProviderUsage as m, optionalTranscriberEntry as n, defaultEnv as o, resolveTranscriberConfig as p, registerOptionalTranscriber as r, hasAnyEnv as s, getOptionalTranscriberFactory as t, parseHeadersEnv as u, normalizeAudioInput as v, SpeechConfigurationError as x, normalizeMimeType as y };
+
+//# sourceMappingURL=registry-DfID41Ew.js.map

package/dist/chunks/registry-DfID41Ew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-DfID41Ew.js","names":[],"sources":["../../src/shared/errors.ts","../../src/shared/audio.ts","../../src/shared/usage.ts","../../src/shared/env.ts","../../src/shared/registry.ts"],"sourcesContent":["export class SpeechError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public adapter?: string,\n  ) {\n    super(message);\n    this.name = 'SpeechError';\n  }\n}\n\nexport class SpeechConfigurationError extends SpeechError {\n  constructor(message: string, adapter?: string) {\n    super(message, 'SPEECH_CONFIGURATION_ERROR', adapter);\n    this.name = 'SpeechConfigurationError';\n  }\n}\n\nexport class InvalidSpeechAdapterError extends SpeechError {\n  constructor(type: string, kind: string) {\n    super(`Invalid ${kind} speech adapter type: ${type}`, 'INVALID_ADAPTER');\n    this.name = 'InvalidSpeechAdapterError';\n  }\n}\n\nexport class SpeechProviderError extends SpeechError {\n  readonly status?: number;\n  readonly responseBody?: string;\n  /** Parsed `Retry-After` delay in milliseconds, when the provider sent one. */\n  readonly retryAfterMs?: number;\n\n  constructor(\n    adapter: string,\n    message: string,\n    options: {\n      status?: number;\n      responseBody?: string;\n      retryAfterMs?: number;\n      cause?: unknown;\n    } = {},\n  ) {\n    super(message, 'SPEECH_PROVIDER_ERROR', adapter);\n    this.name = 'SpeechProviderError';\n    this.status = options.status;\n    this.responseBody = options.responseBody;\n    this.retryAfterMs = options.retryAfterMs;\n    if (options.cause !== undefined) {\n      this.cause = options.cause;\n    }\n  }\n}\n","/**\n * Audio input normalisation shared by speech adapters: accepts the input\n * shapes callers actually have (Blob, Buffer, Uint8Array, ArrayBuffer,\n * ReadableStream), enforces byte limits while buffering, and derives a\n * multipart filename whose extension matches the MIME type.\n */\n\nimport { SpeechConfigurationError } from './errors.js';\nimport type { AudioInput, AudioSource } from './types.js';\n\n/** OpenAI caps `/audio/transcriptions` uploads at 25 MB. */\nexport const DEFAULT_MAX_AUDIO_BYTES = 25 * 1024 * 1024;\n\nconst MIME_EXTENSIONS: Record<string, string> = {\n  'audio/webm': 'webm',\n  'video/webm': 'webm',\n  'audio/mp4': 'm4a',\n  'audio/m4a': 'm4a',\n  'audio/x-m4a': 'm4a',\n  'video/mp4': 'mp4',\n  'audio/wav': 'wav',\n  'audio/wave': 'wav',\n  'audio/x-wav': 'wav',\n  'audio/vnd.wave': 'wav',\n  'audio/ogg': 'ogg',\n  'application/ogg': 'ogg',\n  'audio/mpeg': 'mp3',\n  'audio/mp3': 'mp3',\n  'audio/mpga': 'mp3',\n  'audio/flac': 'flac',\n  'audio/x-flac': 'flac',\n};\n\n/**\n * Strips parameters (e.g. `;codecs=opus`) and lower-cases a MIME type.\n * Returns `undefined` for blank input.\n */\nexport function normalizeMimeType(\n  mimeType: string | undefined | null,\n): string | undefined {\n  const essence = mimeType?.split(';')[0]?.trim().toLowerCase();\n  return essence ? essence : undefined;\n}\n\n/**\n * Maps an audio MIME type to the file extension OpenAI-compatible servers use\n * to detect the container format. Codec parameters are ignored, so\n * `audio/webm;codecs=opus` maps to `webm`. Returns `undefined` when unknown.\n */\nexport function mimeTypeToAudioExtension(\n  mimeType: string | undefined | null,\n): string | undefined {\n  const essence = normalizeMimeType(mimeType);\n  return essence ? MIME_EXTENSIONS[essence] : undefined;\n}\n\nexport interface NormalizeAudioOptions {\n  /** MIME type override; wins over `AudioInput.mimeType`/`contentType` and Blob type. */\n  mimeType?: string;\n  /**\n   * Maximum payload size in bytes. `undefined` or `Infinity` disables the\n   * limit. Streams are cancelled as soon as they exceed it.\n   */\n  maxBytes?: number;\n  /** Adapter name recorded on configuration errors. */\n  adapter?: string;\n  /** Aborts buffering (including a pending stream read) with the signal's reason. */\n  signal?: AbortSignal;\n  /** Base filename (without extension) used when the input has none. */\n  defaultBasename?: string;\n  /** Append a MIME-derived extension to the default filename. Default `true`. */\n  deriveExtension?: boolean;\n}\n\nexport interface NormalizedAudio {\n  blob: Blob;\n  /** Full MIME type including parameters, or `application/octet-stream`. */\n  mimeType: string;\n  bytes: number;\n  /** Explicit filename, or `<basename>.<ext>` derived from the MIME type. */\n  filename: string;\n  durationSeconds?: number;\n}\n\n/**\n * Accepts either an {@link AudioInput} wrapper or a bare {@link AudioSource}\n * and returns a size-checked Blob plus the metadata needed for multipart\n * uploads.\n */\nexport async function normalizeAudioInput(\n  input: AudioInput | AudioSource,\n  options: NormalizeAudioOptions = {},\n): Promise<NormalizedAudio> {\n  const wrapped: AudioInput = isAudioInput(input) ? input : { data: input };\n  const { adapter, signal } = options;\n  signal?.throwIfAborted();\n  const maxBytes = resolveMaxBytes(options.maxBytes, adapter);\n  const data = wrapped.data;\n\n  const blobType =\n    typeof Blob !== 'undefined' && data instanceof Blob ? data.type : undefined;\n  const mimeType =\n    options.mimeType ??\n    wrapped.mimeType ??\n    wrapped.contentType ??\n    (blobType || undefined) ??\n    'application/octet-stream';\n\n  let blob: Blob;\n  if (typeof Blob !== 'undefined' && data instanceof Blob) {\n    assertWithinLimit(data.size, maxBytes, adapter);\n    blob = data.type === mimeType ? data : new Blob([data], { type: mimeType });\n  } else if (data instanceof Uint8Array) {\n    assertWithinLimit(data.byteLength, maxBytes, adapter);\n    blob = new Blob([copyBytes(data)], { type: mimeType });\n  } else if (data instanceof ArrayBuffer) {\n    assertWithinLimit(data.byteLength, maxBytes, adapter);\n    blob = new Blob([data], { type: mimeType });\n  } else if (isReadableStream(data)) {\n    const chunks = await readStreamWithLimit(data, maxBytes, adapter, signal);\n    blob = new Blob(chunks, { type: mimeType });\n  } else {\n    throw new SpeechConfigurationError(\n      'Unsupported audio input: expected Blob, Buffer, Uint8Array, ArrayBuffer, or ReadableStream',\n      adapter,\n    );\n  }\n\n  if (blob.size === 0) {\n    throw new SpeechConfigurationError('Audio input is empty', adapter);\n  }\n\n  const extension =\n    options.deriveExtension === false\n      ? undefined\n      : mimeTypeToAudioExtension(mimeType);\n  const basename = options.defaultBasename ?? 'audio';\n  const filename =\n    wrapped.filename ?? (extension ? `${basename}.${extension}` : basename);\n\n  return {\n    blob,\n    mimeType,\n    bytes: blob.size,\n    filename,\n    durationSeconds: wrapped.durationSeconds,\n  };\n}\n\nfunction isAudioInput(value: AudioInput | AudioSource): value is AudioInput {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'data' in value &&\n    !(typeof Blob !== 'undefined' && value instanceof Blob) &&\n    !(value instanceof Uint8Array) &&\n    !(value instanceof ArrayBuffer) &&\n    !isReadableStream(value)\n  );\n}\n\nfunction isReadableStream(value: unknown): value is ReadableStream<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as ReadableStream).getReader === 'function'\n  );\n}\n\nfunction resolveMaxBytes(\n  maxBytes: number | undefined,\n  adapter: string | undefined,\n): number {\n  if (maxBytes === undefined) {\n    return Number.POSITIVE_INFINITY;\n  }\n\n  if (Number.isNaN(maxBytes) || maxBytes <= 0) {\n    throw new SpeechConfigurationError(\n      'maxBytes must be a positive number',\n      adapter,\n    );\n  }\n\n  return maxBytes;\n}\n\nfunction assertWithinLimit(\n  bytes: number,\n  maxBytes: number,\n  adapter: string | undefined,\n): void {\n  if (bytes > maxBytes) {\n    throw new SpeechConfigurationError(\n      `Audio input exceeds maxBytes (${bytes} > ${maxBytes} bytes)`,\n      adapter,\n    );\n  }\n}\n\nasync function readStreamWithLimit(\n  stream: ReadableStream<unknown>,\n  maxBytes: number,\n  adapter: string | undefined,\n  signal: AbortSignal | undefined,\n): Promise<Uint8Array<ArrayBuffer>[]> {\n  const reader = stream.getReader();\n  const chunks: Uint8Array<ArrayBuffer>[] = [];\n  let total = 0;\n  // Cancelling the reader settles any pending read, so an abort cannot hang.\n  const onAbort = () => {\n    reader.cancel(signal?.reason).catch(() => undefined);\n  };\n  signal?.addEventListener('abort', onAbort, { once: true });\n\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      signal?.throwIfAborted();\n      if (done) {\n        break;\n      }\n\n      // Check the size before copying so one oversized chunk is never duplicated.\n      total += chunkByteLength(value, adapter);\n      if (total > maxBytes) {\n        await reader.cancel().catch(() => undefined);\n        throw new SpeechConfigurationError(\n          `Audio stream exceeds maxBytes (more than ${maxBytes} bytes)`,\n          adapter,\n        );\n      }\n      chunks.push(toBytes(value));\n    }\n  } finally {\n    signal?.removeEventListener('abort', onAbort);\n    reader.releaseLock();\n  }\n\n  return chunks;\n}\n\nfunction chunkByteLength(value: unknown, adapter: string | undefined): number {\n  if (value instanceof Uint8Array || value instanceof ArrayBuffer) {\n    return value.byteLength;\n  }\n\n  throw new SpeechConfigurationError(\n    'Audio stream chunks must be Uint8Array or ArrayBuffer',\n    adapter,\n  );\n}\n\nfunction toBytes(value: unknown): Uint8Array<ArrayBuffer> {\n  return value instanceof Uint8Array\n    ? copyBytes(value)\n    : new Uint8Array((value as ArrayBuffer).slice(0));\n}\n\nfunction copyBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer> {\n  const copy = new Uint8Array(bytes.byteLength);\n  copy.set(bytes);\n  return copy;\n}\n","/**\n * Usage reporting shared by speech adapters.\n *\n * Adapters attach a {@link SpeechUsage} record to their results and call the\n * optional {@link SpeechUsageCallback} so callers can attribute each provider\n * call (for example to a tenant for billing).\n */\n\nexport type SpeechOperation = 'transcription' | 'synthesis';\n\nexport interface SpeechUsage {\n  /** Operation that produced this usage record. */\n  operation: SpeechOperation;\n  /** Adapter type that made the provider call, e.g. `openai-compatible`. */\n  provider: string;\n  /** Model identifier sent to (or reported by) the provider. */\n  model?: string;\n  /** Audio duration in seconds, when the provider or caller reports it. */\n  audioSeconds?: number;\n  /** Size of the audio payload in bytes (uploaded for STT, received for TTS). */\n  bytes?: number;\n  /** Provider usage block, passed through untouched (e.g. OpenAI `usage`). */\n  providerUsage?: Record<string, unknown>;\n}\n\nexport type SpeechUsageCallback = (usage: SpeechUsage) => void | Promise<void>;\n\n/**\n * Invokes every configured usage callback in order (adapter-level first, then\n * request-level). Callback errors propagate to the caller so that billing\n * hooks never fail silently.\n */\nexport async function reportSpeechUsage(\n  usage: SpeechUsage,\n  ...callbacks: Array<SpeechUsageCallback | undefined>\n): Promise<void> {\n  for (const callback of callbacks) {\n    if (callback) {\n      await callback(usage);\n    }\n  }\n}\n\n/**\n * Extracts audio seconds from an OpenAI-style `usage` block\n * (`{ type: 'duration', seconds }`).\n */\nexport function audioSecondsFromProviderUsage(\n  providerUsage: Record<string, unknown> | undefined,\n): number | undefined {\n  if (!providerUsage) {\n    return undefined;\n  }\n\n  const seconds = providerUsage.seconds;\n  return typeof seconds === 'number' && Number.isFinite(seconds)\n    ? seconds\n    : undefined;\n}\n","/**\n * Environment configuration for speech adapters.\n *\n * Transcriber settings resolve in this order (first wins):\n * explicit options → factory context → `HAVE_SPEECH_TRANSCRIBER_*` →\n * legacy `HAVE_SPEECH_STT_*` → gateway `STT_*` aliases.\n */\n\nimport { SpeechConfigurationError } from './errors.js';\nimport type { SpeechFetch } from './types.js';\n\nexport interface SpeechEnv {\n  [key: string]: string | undefined;\n}\n\n/** Environment variable names read for each transcriber setting, in priority order. */\nexport const TRANSCRIBER_ENV_KEYS = {\n  type: [\n    'HAVE_SPEECH_TRANSCRIBER_TYPE',\n    'HAVE_SPEECH_STT_TYPE',\n    'HAVE_SPEECH_STT_ADAPTER',\n    'STT_ADAPTER',\n  ],\n  baseUrl: [\n    'HAVE_SPEECH_TRANSCRIBER_BASE_URL',\n    'HAVE_SPEECH_STT_BASE_URL',\n    'STT_BASE_URL',\n  ],\n  model: [\n    'HAVE_SPEECH_TRANSCRIBER_MODEL',\n    'HAVE_SPEECH_STT_MODEL',\n    'STT_MODEL',\n  ],\n  apiKey: [\n    'HAVE_SPEECH_TRANSCRIBER_API_KEY',\n    'HAVE_SPEECH_STT_API_KEY',\n    'STT_API_KEY',\n    'SPEECH_API_KEY',\n  ],\n  timeoutMs: [\n    'HAVE_SPEECH_TRANSCRIBER_TIMEOUT',\n    'HAVE_SPEECH_TRANSCRIBER_TIMEOUT_MS',\n    'HAVE_SPEECH_STT_TIMEOUT_MS',\n    'STT_TIMEOUT_MS',\n  ],\n  maxBytes: ['HAVE_SPEECH_TRANSCRIBER_MAX_BYTES', 'STT_MAX_BYTES'],\n  headers: ['HAVE_SPEECH_TRANSCRIBER_HEADERS', 'STT_HEADERS'],\n  path: ['HAVE_SPEECH_TRANSCRIBER_PATH', 'HAVE_SPEECH_STT_PATH', 'STT_PATH'],\n} as const;\n\n/** Transcriber settings read from the environment. All fields are optional. */\nexport interface TranscriberEnvConfig {\n  type?: string;\n  baseUrl?: string;\n  model?: string;\n  apiKey?: string;\n  timeoutMs?: number;\n  maxBytes?: number;\n  headers?: Record<string, string>;\n  path?: string;\n}\n\n/** Options shape accepted by {@link resolveTranscriberConfig}. */\nexport interface TranscriberConfigInput {\n  type?: string;\n  baseUrl?: string;\n  model?: string;\n  apiKey?: string;\n  timeoutMs?: number;\n  maxBytes?: number;\n  headers?: HeadersInit;\n  fetch?: SpeechFetch;\n}\n\nexport interface TranscriberConfigContext {\n  env?: SpeechEnv;\n  fetch?: SpeechFetch;\n  headers?: HeadersInit;\n}\n\n/** Resolved transcriber settings. `headers` merges env → context → options. */\nexport interface ResolvedTranscriberConfig {\n  type?: string;\n  baseUrl?: string;\n  model?: string;\n  apiKey?: string;\n  timeoutMs?: number;\n  maxBytes?: number;\n  headers?: Headers;\n  fetch?: SpeechFetch;\n  path?: string;\n}\n\nexport function readTranscriberEnv(env: SpeechEnv): TranscriberEnvConfig {\n  return {\n    type: readEnv(env, ...TRANSCRIBER_ENV_KEYS.type),\n    baseUrl: readEnv(env, ...TRANSCRIBER_ENV_KEYS.baseUrl),\n    model: readEnv(env, ...TRANSCRIBER_ENV_KEYS.model),\n    apiKey: readEnv(env, ...TRANSCRIBER_ENV_KEYS.apiKey),\n    timeoutMs: parseOptionalInteger(\n      readEnv(env, ...TRANSCRIBER_ENV_KEYS.timeoutMs),\n    ),\n    maxBytes: parseOptionalInteger(\n      readEnv(env, ...TRANSCRIBER_ENV_KEYS.maxBytes),\n    ),\n    headers: parseHeadersEnv(env, TRANSCRIBER_ENV_KEYS.headers),\n    path: readEnv(env, ...TRANSCRIBER_ENV_KEYS.path),\n  };\n}\n\nexport function hasTranscriberEnv(env: SpeechEnv): boolean {\n  return hasAnyEnv(\n    env,\n    ...TRANSCRIBER_ENV_KEYS.type,\n    ...TRANSCRIBER_ENV_KEYS.baseUrl,\n  );\n}\n\n/**\n * Merges explicit transcriber options with the factory context and the\n * environment. Explicit options always win; headers are merged so a\n * per-deployment env header (e.g. a gateway virtual key) can be combined with\n * explicit ones.\n */\nexport function resolveTranscriberConfig(\n  options: TranscriberConfigInput = {},\n  context: TranscriberConfigContext = {},\n): ResolvedTranscriberConfig {\n  const fromEnv = readTranscriberEnv(context.env ?? defaultEnv());\n  const headers = mergeHeaderInits(\n    fromEnv.headers,\n    context.headers,\n    options.headers,\n  );\n\n  return {\n    type: options.type ?? fromEnv.type,\n    baseUrl: (options.baseUrl ?? fromEnv.baseUrl)?.trim(),\n    model: options.model ?? fromEnv.model,\n    apiKey: options.apiKey ?? fromEnv.apiKey,\n    timeoutMs: options.timeoutMs ?? fromEnv.timeoutMs,\n    maxBytes: options.maxBytes ?? fromEnv.maxBytes,\n    headers,\n    fetch: options.fetch ?? context.fetch,\n    path: fromEnv.path,\n  };\n}\n\n/** Merges header sets left to right; later sets win per header name. */\nexport function mergeHeaderInits(\n  ...sets: Array<HeadersInit | undefined>\n): Headers | undefined {\n  const present = sets.filter((set): set is HeadersInit => Boolean(set));\n  if (present.length === 0) {\n    return undefined;\n  }\n\n  const merged = new Headers();\n  for (const set of present) {\n    new Headers(set).forEach((value, key) => {\n      merged.set(key, value);\n    });\n  }\n  return merged;\n}\n\nexport function readEnv(env: SpeechEnv, ...keys: string[]): string | undefined {\n  for (const key of keys) {\n    const value = env[key];\n    if (value?.trim()) {\n      return value.trim();\n    }\n  }\n\n  return undefined;\n}\n\nexport function hasAnyEnv(env: SpeechEnv, ...keys: string[]): boolean {\n  return keys.some((key) => Boolean(env[key]?.trim()));\n}\n\nexport function parseOptionalInteger(\n  value: string | undefined,\n): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n\n  const parsed = Number.parseInt(value, 10);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nexport function defaultEnv(): SpeechEnv {\n  return globalThis.process?.env ?? {};\n}\n\n/**\n * Parses a JSON object of header names to string values. The raw value is\n * never echoed in errors because it may carry credentials.\n */\nexport function parseHeadersEnv(\n  env: SpeechEnv,\n  keys: readonly string[],\n): Record<string, string> | undefined {\n  for (const key of keys) {\n    const raw = env[key]?.trim();\n    if (!raw) {\n      continue;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      throw new SpeechConfigurationError(\n        `${key} must be a JSON object of header names to string values`,\n      );\n    }\n\n    if (\n      !parsed ||\n      typeof parsed !== 'object' ||\n      Array.isArray(parsed) ||\n      !Object.values(parsed).every((value) => typeof value === 'string')\n    ) {\n      throw new SpeechConfigurationError(\n        `${key} must be a JSON object of header names to string values`,\n      );\n    }\n\n    return parsed as Record<string, string>;\n  }\n\n  return undefined;\n}\n","/**\n * Registry for opt-in transcriber adapters that live behind subpath exports\n * (e.g. `@happyvertical/speech/local`).\n *\n * The core entry never imports those adapters, so their heavy optional peer\n * dependencies are never resolved by bundlers or loaded at runtime unless the\n * caller imports the subpath, which registers its factory here.\n */\n\nimport type { SpeechFactoryContext } from './factory.js';\nimport type {\n  GetTranscriberOptions,\n  Transcriber,\n  TranscriberType,\n} from './types.js';\n\nexport type OptionalTranscriberFactory = (\n  options: GetTranscriberOptions,\n  context: SpeechFactoryContext,\n) => Transcriber | Promise<Transcriber>;\n\n/** Adapter types that are only available after importing a subpath. */\nconst OPTIONAL_TRANSCRIBER_ENTRIES: Partial<Record<TranscriberType, string>> = {\n  local: '@happyvertical/speech/local',\n};\n\nconst registered = new Map<TranscriberType, OptionalTranscriberFactory>();\n\nexport function registerOptionalTranscriber(\n  type: TranscriberType,\n  factory: OptionalTranscriberFactory,\n): void {\n  registered.set(type, factory);\n}\n\nexport function getOptionalTranscriberFactory(\n  type: string,\n): OptionalTranscriberFactory | undefined {\n  return registered.get(type as TranscriberType);\n}\n\n/** Subpath that registers `type`, when it is an opt-in adapter. */\nexport function optionalTranscriberEntry(type: string): string | undefined {\n  return OPTIONAL_TRANSCRIBER_ENTRIES[type as TranscriberType];\n}\n\nexport function registeredOptionalTranscribers(): TranscriberType[] {\n  return [...registered.keys()];\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -21,9 +21,18 @@
  *
  * @packageDocumentation
  */
+export { OPENAI_REALTIME_DEFAULT_MODEL, OPENAI_REALTIME_DEFAULT_URL, openAIRealtimeProtocol, openAIRealtimeTranscriptionSession, parseOpenAIRealtimeEvent, resolveOpenAIRealtimeFormat, resolveRealtimeUrl, } from './adapters/openai-realtime.js';
+export { parseVoxtralRealtimeEvent, resolveVoxtralRealtimeUrl, VOXTRAL_REALTIME_AUDIO_FORMAT, VOXTRAL_REALTIME_DEFAULT_MODEL, voxtralRealtimeProtocol, } from './adapters/voxtral-realtime.js';
 export { DEFAULT_MAX_AUDIO_BYTES, mimeTypeToAudioExtension, } from './shared/audio.js';
 export { type SpeechEnv, TRANSCRIBER_ENV_KEYS, } from './shared/env.js';
 export * from './shared/errors.js';
 export { getAvailableSpeechAdapters, getSpeech, getSpeechSynthesizer, getTranscriber, type SpeechFactoryContext, } from './shared/factory.js';
+export { audioSecondsForBytes, bytesPerSecond, unwrapRawAudio, } from './shared/pcm.js';
+export { type RealtimeConnection, type RealtimeProtocol, type RealtimeProtocolEvent, type RealtimeSessionConfig, type RealtimeSessionInit, RealtimeTranscriptionSession, } from './shared/realtime-session.js';
+export { CLIENT_SECRET_TTL_RANGE, type CreateStreamingClientSecretOptions, createStreamingClientSecret, DEFAULT_CLIENT_SECRET_TTL_SECONDS, resolveClientSecretUrl, type StreamingClientSecretContext, type StreamingClientSecretResult, } from './shared/streaming-client-secret.js';
+export { getStreamingTranscriber, isStreamingTranscriberType, parseMaxTurnSeconds, STREAMING_TRANSCRIBER_ENV_KEYS, STREAMING_TRANSCRIBER_TYPES, type StreamingFactoryContext, type StreamingTranscriberWrapperOptions, wrapStreamingTranscriber, } from './shared/streaming-factory.js';
+export type { GetStreamingTranscriberOptions, OpenAIRealtimeTranscriberOptions, StreamingAudioChunk, StreamingAudioEncoding, StreamingAudioFormat, StreamingClientSecret, StreamingCloseEvent, StreamingFinalEvent, StreamingPartialEvent, StreamingRolloverOptions, StreamingSession, StreamingSessionEventName, StreamingSessionEvents, StreamingSessionListener, StreamingSessionOptions, StreamingSessionSettings, StreamingSessionState, StreamingSpeechEvent, StreamingTranscriber, StreamingTranscriberOptions, StreamingTranscriberType, StreamingTurnDetection, StreamingTurnLimit, VoxtralRealtimeTranscriberOptions, } from './shared/streaming-types.js';
+export { DEFAULT_MAX_TURN_SECONDS, DEFAULT_ROLLOVER_MIN_SILENCE_MS, DEFAULT_ROLLOVER_SILENCE_THRESHOLD, DEFAULT_ROLLOVER_WINDOW_SECONDS, } from './shared/turn-limit.js';
 export type { AudioBytes, AudioInput, AudioSource, GetSpeechOptions, GetSpeechSynthesizerOptions, GetTranscriberOptions, OpenAICompatibleSpeechSynthesizerOptions, OpenAICompatibleTranscriberOptions, Qwen3SpeechSynthesizerOptions, Speech, SpeechAdapterAvailability, SpeechAdapterType, SpeechFetch, SpeechOperation, SpeechRetryOptions, SpeechSynthesizer, SpeechSynthesizerType, SpeechUsage, SpeechUsageCallback, SpeechVoice, SpeechVoiceInput, StudioServerSpeechSynthesizerOptions, StudioServerTranscriberOptions, SynthesisRequest, SynthesizedSpeech, TimestampGranularity, Transcriber, TranscriberType, TranscriptionRequest, TranscriptionResponseFormat, TranscriptResult, TranscriptSegment, WordTiming, } from './shared/types.js';
+export { isBrowserRuntime, type SpeechWebSocket, type SpeechWebSocketConstructor, type SpeechWebSocketFactory, type SpeechWebSocketInit, } from './shared/websocket.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,SAAS,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,0BAA0B,EAC1B,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EACrB,wCAAwC,EACxC,kCAAkC,EAClC,6BAA6B,EAC7B,MAAM,EACN,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,oCAAoC,EACpC,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,sBAAsB,EACtB,kCAAkC,EAClC,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,SAAS,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,0BAA0B,EAC1B,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,KAAK,kCAAkC,EACvC,2BAA2B,EAC3B,iCAAiC,EACjC,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,GACjC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,8BAA8B,EAC9B,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,kCAAkC,EACvC,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,8BAA8B,EAC9B,gCAAgC,EAChC,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,iCAAiC,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,kCAAkC,EAClC,+BAA+B,GAChC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EACrB,wCAAwC,EACxC,kCAAkC,EAClC,6BAA6B,EAC7B,MAAM,EACN,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,oCAAoC,EACpC,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC"}