@happyvertical/speech 0.96.1 → 0.98.0

package/dist/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","names":[],"sources":["../src/adapters/local/env.ts","../src/adapters/local/runtime.ts","../src/adapters/local/abort.ts","../src/adapters/local/audio.ts","../src/adapters/local/transcriber.ts","../src/adapters/local/worker.ts","../src/local.ts"],"sourcesContent":["/**\n * Environment configuration for the `local` transcriber. Explicit options win,\n * then the factory context, then `HAVE_SPEECH_TRANSCRIBER_*` variables (Node).\n */\n\nimport {\n  defaultEnv,\n  readEnv,\n  resolveTranscriberConfig,\n} from '../../shared/env.js';\nimport type { SpeechFactoryContext } from '../../shared/factory.js';\nimport type { LocalTranscriberOptions } from './types.js';\n\n/** Local-only environment variables, in priority order. */\nexport const LOCAL_TRANSCRIBER_ENV_KEYS = {\n  device: ['HAVE_SPEECH_TRANSCRIBER_DEVICE'],\n  dtype: ['HAVE_SPEECH_TRANSCRIBER_DTYPE'],\n  cacheDir: ['HAVE_SPEECH_TRANSCRIBER_CACHE_DIR'],\n  modelHost: ['HAVE_SPEECH_TRANSCRIBER_MODEL_HOST'],\n} as const;\n\n/**\n * Merges explicit options with the environment. `model` and `maxBytes` reuse\n * the shared `HAVE_SPEECH_TRANSCRIBER_MODEL`/`_MAX_BYTES` keys.\n */\nexport function resolveLocalTranscriberOptions(\n  options: LocalTranscriberOptions = {},\n  context: Pick<SpeechFactoryContext, 'env'> = {},\n): LocalTranscriberOptions {\n  const env = context.env ?? defaultEnv();\n  const shared = resolveTranscriberConfig(\n    { model: options.model, maxBytes: options.maxBytes },\n    { env },\n  );\n\n  return {\n    ...options,\n    type: 'local',\n    model: shared.model,\n    maxBytes: shared.maxBytes,\n    device:\n      options.device ?? readEnv(env, ...LOCAL_TRANSCRIBER_ENV_KEYS.device),\n    dtype: options.dtype ?? readEnv(env, ...LOCAL_TRANSCRIBER_ENV_KEYS.dtype),\n    cacheDir:\n      options.cacheDir ?? readEnv(env, ...LOCAL_TRANSCRIBER_ENV_KEYS.cacheDir),\n    modelHost:\n      options.modelHost ??\n      readEnv(env, ...LOCAL_TRANSCRIBER_ENV_KEYS.modelHost),\n  };\n}\n","// biome-ignore-all lint/style/useNamingConvention: transformers.js options and outputs use snake_case and PascalCase exports.\n/**\n * Loads the optional `@huggingface/transformers` peer dependency and builds\n * `automatic-speech-recognition` pipelines from it.\n *\n * This is the only module that names the peer. It is reachable only from the\n * `@happyvertical/speech/local` entry, never from the core entry.\n */\n\nimport { SpeechConfigurationError } from '../../shared/errors.js';\nimport type {\n  LocalTranscriberDevice,\n  LocalTranscriberDtype,\n  LocalTranscriberProgressCallback,\n  LocalTransformersRuntime,\n} from './types.js';\n\nexport const TRANSFORMERS_PACKAGE = '@huggingface/transformers';\n\nexport const TRANSFORMERS_INSTALL_HINT =\n  `Local transcription needs the optional peer dependency ${TRANSFORMERS_PACKAGE}. ` +\n  `Install it with \\`pnpm add ${TRANSFORMERS_PACKAGE}\\` (or npm/yarn equivalent).`;\n\n/** One ASR result as returned by transformers.js. */\nexport interface AsrOutput {\n  text: string;\n  chunks?: Array<{ text: string; timestamp: [number, number | null] }>;\n}\n\n/** Callable `automatic-speech-recognition` pipeline (structural subset). */\nexport interface AsrPipeline {\n  (\n    audio: Float32Array,\n    options?: Record<string, unknown>,\n  ): Promise<AsrOutput | AsrOutput[]>;\n  dispose?: () => Promise<void>;\n  model?: { config?: { model_type?: string } };\n}\n\n/** The parts of the transformers.js module this adapter uses. */\nexport interface TransformersModule {\n  pipeline: (\n    task: 'automatic-speech-recognition',\n    model: string,\n    options: Record<string, unknown>,\n  ) => Promise<AsrPipeline>;\n  env?: Record<string, unknown>;\n  InterruptableStoppingCriteria?: new () => { interrupt(): void };\n}\n\n/**\n * Resolves the transformers.js module: an injected module or loader, else a\n * dynamic import of the peer. A missing peer becomes a\n * `SpeechConfigurationError` with an install hint.\n */\nexport async function loadTransformers(\n  runtime: LocalTransformersRuntime | undefined,\n): Promise<TransformersModule> {\n  let loaded: unknown;\n  try {\n    loaded =\n      typeof runtime === 'function'\n        ? await runtime()\n        : (runtime ?? (await importTransformers()));\n  } catch (error) {\n    if (error instanceof SpeechConfigurationError) {\n      throw error;\n    }\n    const configurationError = new SpeechConfigurationError(\n      `${TRANSFORMERS_INSTALL_HINT} (${errorMessage(error)})`,\n      'local',\n    );\n    configurationError.cause = error;\n    throw configurationError;\n  }\n\n  // Accept both the ES namespace and a CommonJS-style `default` wrapper.\n  const candidate = loaded as\n    | (Partial<TransformersModule> & { default?: TransformersModule })\n    | undefined;\n  const module =\n    typeof candidate?.pipeline === 'function'\n      ? (candidate as TransformersModule)\n      : candidate?.default;\n\n  if (typeof module?.pipeline !== 'function') {\n    throw new SpeechConfigurationError(\n      `${TRANSFORMERS_PACKAGE} did not export pipeline(); expected v4 or later`,\n      'local',\n    );\n  }\n  return module;\n}\n\n/** Isolated so tests can observe whether the peer was ever imported. */\nexport function importTransformers(): Promise<unknown> {\n  return import('@huggingface/transformers');\n}\n\nexport interface CreatePipelineOptions {\n  model: string;\n  device: LocalTranscriberDevice;\n  dtype?: LocalTranscriberDtype;\n  revision?: string;\n  cacheDir?: string;\n  onProgress?: LocalTranscriberProgressCallback;\n}\n\n/**\n * Creates the ASR pipeline. `device: 'auto'` resolves to WebGPU when a\n * browser adapter is available (retrying on WASM if WebGPU fails to\n * initialise) and to CPU elsewhere.\n */\nexport async function createAsrPipeline(\n  transformers: TransformersModule,\n  options: CreatePipelineOptions,\n): Promise<{ pipeline: AsrPipeline; device: string }> {\n  const device =\n    options.device === 'auto' ? await detectAutoDevice() : options.device;\n  const build = (selected: string) =>\n    transformers.pipeline('automatic-speech-recognition', options.model, {\n      device: selected,\n      ...(options.dtype ? { dtype: options.dtype } : {}),\n      ...(options.revision ? { revision: options.revision } : {}),\n      ...(options.cacheDir ? { cache_dir: options.cacheDir } : {}),\n      ...(options.onProgress ? { progress_callback: options.onProgress } : {}),\n    });\n\n  try {\n    return { pipeline: await build(device), device };\n  } catch (error) {\n    if (options.device === 'auto' && device === 'webgpu') {\n      return { pipeline: await build('wasm'), device: 'wasm' };\n    }\n    throw error;\n  }\n}\n\n/** `webgpu` when a browser exposes a usable adapter, `wasm` in other browsers, `cpu` in Node. */\nexport async function detectAutoDevice(): Promise<string> {\n  if (isNodeRuntime()) {\n    return 'cpu';\n  }\n\n  const gpu = (\n    globalThis.navigator as\n      | { gpu?: { requestAdapter(): Promise<unknown> } }\n      | undefined\n  )?.gpu;\n  if (gpu) {\n    try {\n      if (await gpu.requestAdapter()) {\n        return 'webgpu';\n      }\n    } catch {\n      // No usable adapter: fall through to WASM.\n    }\n  }\n  return 'wasm';\n}\n\nexport function isNodeRuntime(): boolean {\n  return Boolean(\n    (globalThis as { process?: { versions?: { node?: string } } }).process\n      ?.versions?.node,\n  );\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n","/**\n * Rejects with the signal's reason as soon as it aborts, without waiting for\n * `promise` (which keeps running; its eventual result is ignored).\n */\nexport function raceAbort<T>(\n  promise: Promise<T>,\n  signal: AbortSignal | undefined,\n): Promise<T> {\n  if (!signal) {\n    return promise;\n  }\n  if (signal.aborted) {\n    // Mark the abandoned promise handled so a later rejection is not reported.\n    promise.catch(() => undefined);\n    return Promise.reject(signal.reason);\n  }\n  return new Promise<T>((resolve, reject) => {\n    const onAbort = () => reject(signal.reason);\n    signal.addEventListener('abort', onAbort, { once: true });\n    promise.then(\n      (value) => {\n        signal.removeEventListener('abort', onAbort);\n        resolve(value);\n      },\n      (error: unknown) => {\n        signal.removeEventListener('abort', onAbort);\n        reject(error);\n      },\n    );\n  });\n}\n","/**\n * Audio decoding for on-device inference: turns encoded bytes into 16 kHz\n * mono Float32 PCM, the input Whisper and Moonshine expect.\n *\n * - WAV (PCM 8/16/24/32-bit, IEEE float 32/64, WAVE_FORMAT_EXTENSIBLE) and raw\n *   `audio/pcm` are decoded in-process in every runtime, including workers.\n * - Anything else goes to the caller's `decodeAudio` hook, or, in browsers,\n *   to `OfflineAudioContext.decodeAudioData` (MediaRecorder WebM/Opus, Safari\n *   `audio/mp4`, MP3, ...).\n */\n\nimport { normalizeMimeType } from '../../shared/audio.js';\nimport { SpeechConfigurationError } from '../../shared/errors.js';\nimport { raceAbort } from './abort.js';\nimport type { DecodedAudio, LocalAudioDecoder } from './types.js';\n\n/** Sample rate expected by Whisper and Moonshine feature extractors. */\nexport const LOCAL_SAMPLE_RATE = 16_000;\n\nconst ADAPTER = 'local';\n\nconst WAV_MIME_TYPES = new Set([\n  'audio/wav',\n  'audio/wave',\n  'audio/x-wav',\n  'audio/vnd.wave',\n]);\nconst PCM_MIME_TYPES = new Set(['audio/pcm', 'audio/x-pcm', 'audio/raw']);\n\nexport interface DecodeToPcmOptions {\n  /** Full MIME type including parameters (`audio/pcm;rate=16000`). */\n  mimeType: string;\n  /** Sample rate for raw PCM when the MIME type has no `rate` parameter. */\n  sampleRate?: number;\n  /** Channel count for raw PCM when the MIME type has no `channels` parameter. */\n  channels?: number;\n  decodeAudio?: LocalAudioDecoder;\n  signal?: AbortSignal;\n}\n\n/**\n * Decodes `bytes` and returns 16 kHz mono Float32 samples.\n *\n * Raw PCM (`audio/pcm`) is little-endian signed 16-bit by default; pass\n * `encoding=f32le` for Float32. The rate comes from the `rate` MIME parameter\n * or `sampleRate`, the channel count from `channels` (default 1).\n */\nexport async function decodeToPcm16k(\n  bytes: Uint8Array,\n  options: DecodeToPcmOptions,\n): Promise<Float32Array> {\n  // Decoders (caller hooks, decodeAudioData) cannot be cancelled: stop waiting on abort.\n  const decoded = await raceAbort(\n    decodeAudioBytes(bytes, options),\n    options.signal,\n  );\n  return toPcm16k(decoded);\n}\n\n/** Downmixes decoded audio to mono and resamples it to 16 kHz. */\nexport function toPcm16k(decoded: DecodedAudio): Float32Array {\n  return resample(\n    downmix(decoded.samples),\n    decoded.sampleRate,\n    LOCAL_SAMPLE_RATE,\n  );\n}\n\n/**\n * True for WAV and raw PCM, which this module decodes itself in every\n * runtime, including Web Workers.\n */\nexport function isInProcessDecodable(\n  bytes: Uint8Array,\n  mimeType: string,\n): boolean {\n  const essence = normalizeMimeType(mimeType);\n  return Boolean(\n    (essence && (WAV_MIME_TYPES.has(essence) || PCM_MIME_TYPES.has(essence))) ||\n      isRiffWave(bytes),\n  );\n}\n\n/**\n * Decodes a format without an in-process decoder through the caller's\n * `decodeAudio` hook or, in browsers, `OfflineAudioContext`. Resolves\n * `undefined` when neither is available.\n */\nexport async function decodeExternally(\n  bytes: Uint8Array,\n  options: Omit<DecodeToPcmOptions, 'sampleRate' | 'channels'>,\n): Promise<DecodedAudio | undefined> {\n  if (options.decodeAudio) {\n    const decoded = await options.decodeAudio({\n      bytes,\n      mimeType: options.mimeType,\n      signal: options.signal,\n    });\n    assertDecodedAudio(decoded);\n    return decoded;\n  }\n\n  if (hasOfflineAudioContext()) {\n    return decodeWithAudioContext(bytes);\n  }\n\n  return undefined;\n}\n\nasync function decodeAudioBytes(\n  bytes: Uint8Array,\n  options: DecodeToPcmOptions,\n): Promise<DecodedAudio> {\n  const essence = normalizeMimeType(options.mimeType);\n\n  if ((essence && WAV_MIME_TYPES.has(essence)) || isRiffWave(bytes)) {\n    return decodeWav(bytes);\n  }\n\n  if (essence && PCM_MIME_TYPES.has(essence)) {\n    return decodeRawPcm(bytes, options);\n  }\n\n  const decoded = await decodeExternally(bytes, options);\n  if (decoded) {\n    return decoded;\n  }\n\n  throw new SpeechConfigurationError(\n    `Cannot decode '${options.mimeType}' audio on this runtime: pass WAV or audio/pcm, ` +\n      'or supply a decodeAudio hook (e.g. ffmpeg) for compressed formats',\n    ADAPTER,\n  );\n}\n\nfunction isRiffWave(bytes: Uint8Array): boolean {\n  return (\n    bytes.byteLength >= 12 &&\n    ascii(bytes, 0, 4) === 'RIFF' &&\n    ascii(bytes, 8, 4) === 'WAVE'\n  );\n}\n\n/** Parses a RIFF/WAVE file into per-channel Float32 samples. */\nexport function decodeWav(bytes: Uint8Array): DecodedAudio {\n  if (!isRiffWave(bytes)) {\n    throw new SpeechConfigurationError(\n      'Invalid WAV data: missing RIFF/WAVE header',\n      ADAPTER,\n    );\n  }\n\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  let format: WavFormat | undefined;\n  let offset = 12;\n\n  while (offset + 8 <= bytes.byteLength) {\n    const id = ascii(bytes, offset, 4);\n    const size = view.getUint32(offset + 4, true);\n    const body = offset + 8;\n\n    if (id === 'fmt ') {\n      format = readWavFormat(view, body, size);\n    } else if (id === 'data') {\n      if (!format) {\n        throw new SpeechConfigurationError(\n          'Invalid WAV data: data chunk before fmt chunk',\n          ADAPTER,\n        );\n      }\n      // Streamed WAVs may leave the size as 0 or 0xFFFFFFFF; clamp to the bytes we have.\n      const available = bytes.byteLength - body;\n      const length = size === 0 || size > available ? available : size;\n      return {\n        samples: deinterleave(\n          bytes.subarray(body, body + length),\n          format.channels,\n          format.encoding,\n        ),\n        sampleRate: format.sampleRate,\n      };\n    }\n\n    offset = body + size + (size % 2);\n  }\n\n  throw new SpeechConfigurationError(\n    'Invalid WAV data: no data chunk',\n    ADAPTER,\n  );\n}\n\ntype PcmEncoding = 'u8' | 's16le' | 's24le' | 's32le' | 'f32le' | 'f64le';\n\ninterface WavFormat {\n  channels: number;\n  sampleRate: number;\n  encoding: PcmEncoding;\n}\n\nconst WAVE_FORMAT_PCM = 1;\nconst WAVE_FORMAT_IEEE_FLOAT = 3;\nconst WAVE_FORMAT_EXTENSIBLE = 0xfffe;\n\nfunction readWavFormat(view: DataView, body: number, size: number): WavFormat {\n  if (size < 16) {\n    throw new SpeechConfigurationError(\n      'Invalid WAV data: fmt chunk too short',\n      ADAPTER,\n    );\n  }\n\n  let tag = view.getUint16(body, true);\n  const channels = view.getUint16(body + 2, true);\n  const sampleRate = view.getUint32(body + 4, true);\n  const bitsPerSample = view.getUint16(body + 14, true);\n\n  if (tag === WAVE_FORMAT_EXTENSIBLE && size >= 26) {\n    // The first two bytes of the SubFormat GUID carry the real format tag.\n    tag = view.getUint16(body + 24, true);\n  }\n\n  const encoding =\n    tag === WAVE_FORMAT_PCM\n      ? ({ 8: 'u8', 16: 's16le', 24: 's24le', 32: 's32le' } as const)[\n          bitsPerSample\n        ]\n      : tag === WAVE_FORMAT_IEEE_FLOAT\n        ? ({ 32: 'f32le', 64: 'f64le' } as const)[bitsPerSample]\n        : undefined;\n\n  if (!encoding || channels < 1 || sampleRate < 1) {\n    throw new SpeechConfigurationError(\n      `Unsupported WAV encoding (format ${tag}, ${bitsPerSample}-bit, ${channels} channels); ` +\n        'use PCM or IEEE float, or supply a decodeAudio hook',\n      ADAPTER,\n    );\n  }\n\n  return { channels, sampleRate, encoding };\n}\n\nfunction decodeRawPcm(\n  bytes: Uint8Array,\n  options: DecodeToPcmOptions,\n): DecodedAudio {\n  const params = mimeParameters(options.mimeType);\n  const sampleRate =\n    positiveInteger(params.rate) ??\n    explicitPositiveInteger(options.sampleRate, 'sampleRate');\n  const channels =\n    positiveInteger(params.channels) ??\n    explicitPositiveInteger(options.channels, 'channels') ??\n    1;\n  const encoding = (params.encoding ?? 's16le').toLowerCase();\n\n  if (!sampleRate) {\n    throw new SpeechConfigurationError(\n      \"Raw PCM audio needs a sample rate: use 'audio/pcm;rate=16000' or AudioInput.sampleRate\",\n      ADAPTER,\n    );\n  }\n  if (encoding !== 's16le' && encoding !== 'f32le') {\n    throw new SpeechConfigurationError(\n      `Unsupported raw PCM encoding '${encoding}' (expected s16le or f32le)`,\n      ADAPTER,\n    );\n  }\n\n  return {\n    samples: deinterleave(bytes, channels, encoding),\n    sampleRate,\n  };\n}\n\nconst BYTES_PER_SAMPLE: Record<PcmEncoding, number> = {\n  u8: 1,\n  s16le: 2,\n  s24le: 3,\n  s32le: 4,\n  f32le: 4,\n  f64le: 8,\n};\n\nfunction deinterleave(\n  bytes: Uint8Array,\n  channels: number,\n  encoding: PcmEncoding,\n): Float32Array[] {\n  const width = BYTES_PER_SAMPLE[encoding];\n  const frames = Math.floor(bytes.byteLength / (width * channels));\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  const output = Array.from(\n    { length: channels },\n    () => new Float32Array(frames),\n  );\n\n  for (let frame = 0; frame < frames; frame++) {\n    for (let channel = 0; channel < channels; channel++) {\n      const at = (frame * channels + channel) * width;\n      (output[channel] as Float32Array)[frame] = readSample(view, at, encoding);\n    }\n  }\n\n  return output;\n}\n\nfunction readSample(view: DataView, at: number, encoding: PcmEncoding): number {\n  switch (encoding) {\n    case 'u8':\n      return (view.getUint8(at) - 128) / 128;\n    case 's16le':\n      return view.getInt16(at, true) / 32_768;\n    case 's24le': {\n      const value =\n        view.getUint8(at) |\n        (view.getUint8(at + 1) << 8) |\n        (view.getInt8(at + 2) << 16);\n      return value / 8_388_608;\n    }\n    case 's32le':\n      return view.getInt32(at, true) / 2_147_483_648;\n    case 'f32le':\n      return view.getFloat32(at, true);\n    case 'f64le':\n      return view.getFloat64(at, true);\n  }\n}\n\n/** Averages channels into one mono track. */\nexport function downmix(samples: Float32Array | Float32Array[]): Float32Array {\n  if (samples instanceof Float32Array) {\n    return samples;\n  }\n  if (samples.length === 1) {\n    return samples[0] as Float32Array;\n  }\n\n  const length = Math.min(...samples.map((channel) => channel.length));\n  const mono = new Float32Array(length);\n  for (const channel of samples) {\n    for (let index = 0; index < length; index++) {\n      (mono as Float32Array)[index] =\n        (mono[index] as number) + (channel[index] as number) / samples.length;\n    }\n  }\n  return mono;\n}\n\n/**\n * Resamples mono audio with linear interpolation. When downsampling, a box\n * filter one source period wide is applied first to limit aliasing; this is\n * adequate for speech recognition, not for music playback.\n */\nexport function resample(\n  samples: Float32Array,\n  fromRate: number,\n  toRate: number,\n): Float32Array {\n  if (fromRate === toRate || samples.length === 0) {\n    return samples;\n  }\n\n  const ratio = fromRate / toRate;\n  const source = ratio > 1 ? boxFilter(samples, Math.round(ratio)) : samples;\n  const length = Math.max(1, Math.round(samples.length / ratio));\n  const output = new Float32Array(length);\n\n  for (let index = 0; index < length; index++) {\n    const position = index * ratio;\n    const left = Math.floor(position);\n    const right = Math.min(left + 1, source.length - 1);\n    const fraction = position - left;\n    output[index] =\n      (source[left] as number) * (1 - fraction) +\n      (source[right] as number) * fraction;\n  }\n\n  return output;\n}\n\nfunction boxFilter(samples: Float32Array, width: number): Float32Array {\n  if (width <= 1) {\n    return samples;\n  }\n\n  const output = new Float32Array(samples.length);\n  const half = Math.floor(width / 2);\n  let sum = 0;\n  let count = 0;\n  let start = 0;\n  let end = 0;\n\n  for (let index = 0; index < samples.length; index++) {\n    const windowStart = Math.max(0, index - half);\n    const windowEnd = Math.min(samples.length, index - half + width);\n    while (end < windowEnd) {\n      sum += samples[end] as number;\n      count++;\n      end++;\n    }\n    while (start < windowStart) {\n      sum -= samples[start] as number;\n      count--;\n      start++;\n    }\n    output[index] = sum / count;\n  }\n\n  return output;\n}\n\nfunction hasOfflineAudioContext(): boolean {\n  return typeof globalThis.OfflineAudioContext === 'function';\n}\n\n/**\n * Browser decode path. Decoding through a 16 kHz `OfflineAudioContext` makes\n * the browser resample with its own high-quality resampler. Not available in\n * Web Workers: decode on the main thread (see the worker client).\n */\nasync function decodeWithAudioContext(\n  bytes: Uint8Array,\n): Promise<DecodedAudio> {\n  const context = new OfflineAudioContext(1, 1, LOCAL_SAMPLE_RATE);\n  // decodeAudioData detaches its input, so hand it a private copy.\n  const copy = new Uint8Array(bytes.byteLength);\n  copy.set(bytes);\n\n  let buffer: AudioBuffer;\n  try {\n    buffer = await context.decodeAudioData(copy.buffer);\n  } catch (error) {\n    throw new SpeechConfigurationError(\n      `The browser could not decode the audio: ${errorMessage(error)}`,\n      ADAPTER,\n    );\n  }\n\n  const channels = Array.from({ length: buffer.numberOfChannels }, (_, index) =>\n    buffer.getChannelData(index),\n  );\n  return { samples: channels, sampleRate: buffer.sampleRate };\n}\n\nfunction assertDecodedAudio(decoded: DecodedAudio): void {\n  const channels =\n    decoded?.samples instanceof Float32Array\n      ? [decoded.samples]\n      : decoded?.samples;\n  if (\n    !Array.isArray(channels) ||\n    channels.length === 0 ||\n    !channels.every((channel) => channel instanceof Float32Array) ||\n    !(decoded.sampleRate > 0)\n  ) {\n    throw new SpeechConfigurationError(\n      'decodeAudio must return { samples: Float32Array | Float32Array[], sampleRate }',\n      ADAPTER,\n    );\n  }\n}\n\nfunction mimeParameters(mimeType: string): Record<string, string> {\n  const params: Record<string, string> = {};\n  for (const part of mimeType.split(';').slice(1)) {\n    const [key, value] = part.split('=');\n    if (key && value) {\n      params[key.trim().toLowerCase()] = value.trim().replace(/^\"|\"$/g, '');\n    }\n  }\n  return params;\n}\n\nfunction positiveInteger(value: string | undefined): number | undefined {\n  const parsed = value ? Number.parseInt(value, 10) : Number.NaN;\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;\n}\n\n/** Validates a caller-supplied `AudioInput.sampleRate`/`channels`. */\nfunction explicitPositiveInteger(\n  value: number | undefined,\n  name: 'sampleRate' | 'channels',\n): number | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  }\n  if (!Number.isInteger(value) || value < 1) {\n    throw new SpeechConfigurationError(\n      `AudioInput.${name} must be a positive integer, got ${String(value)}`,\n      ADAPTER,\n    );\n  }\n  return value;\n}\n\nfunction ascii(bytes: Uint8Array, offset: number, length: number): string {\n  return String.fromCharCode(...bytes.subarray(offset, offset + length));\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n","import {\n  DEFAULT_MAX_AUDIO_BYTES,\n  normalizeAudioInput,\n} from '../../shared/audio.js';\nimport {\n  SpeechConfigurationError,\n  SpeechProviderError,\n} from '../../shared/errors.js';\nimport type {\n  AudioInput,\n  AudioSource,\n  Transcriber,\n  TranscriptionRequest,\n  TranscriptResult,\n  TranscriptSegment,\n  WordTiming,\n} from '../../shared/types.js';\nimport {\n  reportSpeechUsage,\n  type SpeechUsage,\n  type SpeechUsageCallback,\n} from '../../shared/usage.js';\nimport { raceAbort } from './abort.js';\nimport { decodeToPcm16k, LOCAL_SAMPLE_RATE } from './audio.js';\nimport {\n  type AsrOutput,\n  type AsrPipeline,\n  createAsrPipeline,\n  loadTransformers,\n  type TransformersModule,\n} from './runtime.js';\nimport type { LocalTranscriberOptions } from './types.js';\n\n/** Small multilingual Whisper (~80 MB at the default q8 quantisation). */\nexport const DEFAULT_LOCAL_MODEL = 'onnx-community/whisper-base';\n\nconst DEFAULT_CHUNK_LENGTH_SECONDS = 30;\nconst WHISPER_WINDOW_SECONDS = 30;\nconst WHISPER_MODEL_TYPES = new Set(['whisper', 'lite-whisper']);\n\ninterface LoadedPipeline {\n  pipeline: AsrPipeline;\n  device: string;\n}\n\n/**\n * On-device speech-to-text with transformers.js (Whisper or Moonshine ONNX).\n * Runs on WebGPU/WASM in browsers and onnxruntime-node in Node; no audio\n * leaves the device and no API key is involved.\n */\nexport class LocalTranscriber implements Transcriber {\n  readonly type = 'local' as const;\n\n  private readonly options: LocalTranscriberOptions;\n  private readonly model: string;\n  private readonly maxBytes: number;\n  private readonly onUsage?: SpeechUsageCallback;\n  private runtime?: Promise<TransformersModule>;\n  private readonly pipelines = new Map<string, Promise<LoadedPipeline>>();\n  /** Serialises inference: ONNX sessions (especially WebGPU) run one call at a time. */\n  private queue: Promise<unknown> = Promise.resolve();\n\n  constructor(options: LocalTranscriberOptions = {}) {\n    this.options = options;\n    this.model = options.model?.trim() || DEFAULT_LOCAL_MODEL;\n    this.maxBytes = options.maxBytes ?? DEFAULT_MAX_AUDIO_BYTES;\n    this.onUsage = options.onUsage;\n  }\n\n  /**\n   * Downloads (first time) and initialises the model so the first\n   * `transcribe()` is fast. Progress goes to `onProgress`.\n   */\n  async preload(model?: string, signal?: AbortSignal): Promise<void> {\n    await raceAbort(this.loadPipeline(model?.trim() || this.model), signal);\n  }\n\n  async transcribe(request: TranscriptionRequest): Promise<TranscriptResult> {\n    const { signal } = request;\n    const audio = await normalizeAudioInput(request.audio, {\n      mimeType: request.mimeType,\n      maxBytes: request.maxBytes ?? this.maxBytes,\n      adapter: this.type,\n      signal,\n    });\n    const format = pcmFormat(request.audio);\n    const samples = await decodeToPcm16k(\n      new Uint8Array(await audio.blob.arrayBuffer()),\n      {\n        mimeType: audio.mimeType,\n        sampleRate: format.sampleRate,\n        channels: format.channels,\n        decodeAudio: this.options.decodeAudio,\n        signal,\n      },\n    );\n    signal?.throwIfAborted();\n\n    const model = request.model?.trim() || this.model;\n    const loaded = await raceAbort(this.loadPipeline(model), signal);\n    const audioSeconds = samples.length / LOCAL_SAMPLE_RATE;\n    // The queue tracks the real inference; the caller stops waiting on abort.\n    const output = await raceAbort(\n      this.enqueue(() =>\n        this.run(loaded.pipeline, samples, audioSeconds, request),\n      ),\n      signal,\n    );\n\n    const usage: SpeechUsage = {\n      operation: 'transcription',\n      provider: this.type,\n      model,\n      audioSeconds,\n      bytes: audio.bytes,\n    };\n    const result: TranscriptResult = {\n      ...mapAsrOutput(\n        output,\n        request.timestampGranularities?.includes('word') ?? false,\n      ),\n      language: request.language,\n      durationSeconds: audioSeconds,\n      provider: this.type,\n      model,\n      raw: output,\n      usage,\n    };\n\n    await reportSpeechUsage(usage, this.onUsage, request.onUsage);\n    return result;\n  }\n\n  /** Waits for in-flight inference, then releases every loaded model session. */\n  async dispose(): Promise<void> {\n    await this.queue;\n    const loaded = [...this.pipelines.values()];\n    this.pipelines.clear();\n    await Promise.all(\n      loaded.map(async (entry) => {\n        const { pipeline } = await entry.catch(() => ({ pipeline: undefined }));\n        await pipeline?.dispose?.();\n      }),\n    );\n  }\n\n  private async run(\n    pipeline: AsrPipeline,\n    samples: Float32Array,\n    audioSeconds: number,\n    request: TranscriptionRequest,\n  ): Promise<AsrOutput> {\n    const { signal } = request;\n    signal?.throwIfAborted();\n\n    const transformers = await this.loadRuntime();\n    const options: Record<string, unknown> = {};\n    const isWhisper = WHISPER_MODEL_TYPES.has(\n      pipeline.model?.config?.model_type ?? 'whisper',\n    );\n\n    if (isWhisper) {\n      const granularities = request.timestampGranularities ?? [];\n      if (granularities.includes('word')) {\n        options.return_timestamps = 'word';\n      } else if (granularities.includes('segment')) {\n        options.return_timestamps = true;\n      }\n      const chunkLength =\n        this.options.chunkLengthSeconds ?? DEFAULT_CHUNK_LENGTH_SECONDS;\n      if (chunkLength > 0 && audioSeconds > WHISPER_WINDOW_SECONDS) {\n        options.chunk_length_s = chunkLength;\n      }\n      if (request.language) {\n        options.language = request.language;\n        options.task = 'transcribe';\n      }\n    }\n\n    // Stops generation between tokens when the caller aborts.\n    let stopping: { interrupt(): void } | undefined;\n    if (signal && transformers.InterruptableStoppingCriteria) {\n      stopping = new transformers.InterruptableStoppingCriteria();\n      options.stopping_criteria = stopping;\n    }\n    const onAbort = () => stopping?.interrupt();\n    signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const output = await pipeline(samples, options);\n      return Array.isArray(output) ? (output[0] ?? { text: '' }) : output;\n    } catch (error) {\n      if (signal?.aborted) {\n        throw signal.reason;\n      }\n      const hint =\n        options.return_timestamps === 'word' &&\n        /cross attentions/i.test(errorMessage(error))\n          ? ' (word timestamps need a model exported with cross attentions, e.g. onnx-community/whisper-base_timestamped)'\n          : '';\n      throw new SpeechProviderError(\n        this.type,\n        `Local transcription failed: ${errorMessage(error)}${hint}`,\n        { cause: error },\n      );\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n    }\n  }\n\n  private enqueue<T>(task: () => Promise<T>): Promise<T> {\n    const next = this.queue.then(task, task);\n    this.queue = next.catch(() => undefined);\n    return next;\n  }\n\n  private loadRuntime(): Promise<TransformersModule> {\n    if (!this.runtime) {\n      const { transformers, configureEnv, modelHost } = this.options;\n      this.runtime = loadTransformers(transformers).then((module) => {\n        if (module.env) {\n          if (modelHost) {\n            module.env.remoteHost = modelHost;\n          }\n          configureEnv?.(module.env);\n        }\n        return module;\n      });\n      // A failed load (e.g. missing peer) is retried on the next call.\n      this.runtime.catch(() => {\n        this.runtime = undefined;\n      });\n    }\n    return this.runtime;\n  }\n\n  private loadPipeline(model: string): Promise<LoadedPipeline> {\n    let loaded = this.pipelines.get(model);\n    if (!loaded) {\n      loaded = this.loadRuntime().then((transformers) =>\n        createAsrPipeline(transformers, {\n          model,\n          device: this.options.device ?? 'auto',\n          dtype: this.options.dtype,\n          revision: this.options.revision,\n          cacheDir: this.options.cacheDir,\n          onProgress: this.options.onProgress,\n        }).catch((error: unknown) => {\n          if (error instanceof SpeechConfigurationError) {\n            throw error;\n          }\n          throw new SpeechProviderError(\n            this.type,\n            `Failed to load local model '${model}': ${errorMessage(error)}`,\n            { cause: error },\n          );\n        }),\n      );\n      this.pipelines.set(model, loaded);\n      loaded.catch(() => {\n        if (this.pipelines.get(model) === loaded) {\n          this.pipelines.delete(model);\n        }\n      });\n    }\n    return loaded;\n  }\n}\n\n/**\n * Maps transformers.js chunks onto `words` (when word timestamps were\n * requested) or `segments`.\n */\nexport function mapAsrOutput(\n  output: AsrOutput,\n  wordLevel: boolean,\n): Pick<TranscriptResult, 'text' | 'segments' | 'words'> {\n  const result: Pick<TranscriptResult, 'text' | 'segments' | 'words'> = {\n    text: (output.text ?? '').trim(),\n  };\n  const chunks = output.chunks;\n  if (!chunks?.length) {\n    return result;\n  }\n\n  if (wordLevel) {\n    result.words = chunks\n      .filter((chunk) => chunk.text.trim())\n      .map(\n        (chunk): WordTiming => ({\n          word: chunk.text.trim(),\n          startSeconds: chunk.timestamp[0],\n          endSeconds: chunk.timestamp[1] ?? chunk.timestamp[0],\n        }),\n      );\n  } else {\n    result.segments = chunks.map(\n      (chunk): TranscriptSegment => ({\n        text: chunk.text.trim(),\n        startSeconds: chunk.timestamp[0],\n        endSeconds: chunk.timestamp[1] ?? undefined,\n      }),\n    );\n  }\n  return result;\n}\n\nfunction pcmFormat(audio: AudioInput | AudioSource): {\n  sampleRate?: number;\n  channels?: number;\n} {\n  if (\n    audio &&\n    typeof audio === 'object' &&\n    'data' in audio &&\n    !(audio instanceof Uint8Array)\n  ) {\n    return { sampleRate: audio.sampleRate, channels: audio.channels };\n  }\n  return {};\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n","/**\n * Web Worker support for the `local` transcriber.\n *\n * Inference runs in a worker (`serveLocalTranscriber`) so long recordings never\n * block the UI thread. The main-thread client (`LocalTranscriberWorkerClient`)\n * transfers WAV and raw PCM bytes to the worker, which parses, downmixes, and\n * resamples them there. Only formats that need `AudioContext` (which workers\n * lack) or the client's `decodeAudio` hook are decoded on the main thread;\n * their Float32 channels are then transferred and resampled in the worker.\n */\n\nimport {\n  DEFAULT_MAX_AUDIO_BYTES,\n  normalizeAudioInput,\n} from '../../shared/audio.js';\nimport {\n  SpeechConfigurationError,\n  SpeechError,\n  SpeechProviderError,\n} from '../../shared/errors.js';\nimport type {\n  AudioInput,\n  TimestampGranularity,\n  Transcriber,\n  TranscriptionRequest,\n  TranscriptResult,\n} from '../../shared/types.js';\nimport {\n  reportSpeechUsage,\n  type SpeechUsage,\n  type SpeechUsageCallback,\n} from '../../shared/usage.js';\nimport { raceAbort } from './abort.js';\nimport {\n  decodeExternally,\n  isInProcessDecodable,\n  LOCAL_SAMPLE_RATE,\n  toPcm16k,\n} from './audio.js';\nimport { resolveLocalTranscriberOptions } from './env.js';\nimport { LocalTranscriber } from './transcriber.js';\nimport type {\n  LocalAudioDecoder,\n  LocalTranscriberOptions,\n  LocalTranscriberProgress,\n  LocalTranscriberProgressCallback,\n} from './types.js';\n\n/** Minimal `postMessage` endpoint: a `Worker`, `DedicatedWorkerGlobalScope`, or `MessagePort`. */\nexport interface LocalWorkerEndpoint {\n  postMessage(message: unknown, transfer?: Transferable[]): void;\n  addEventListener(\n    type: 'message',\n    listener: (event: MessageEvent) => void,\n  ): void;\n  removeEventListener(\n    type: 'message',\n    listener: (event: MessageEvent) => void,\n  ): void;\n}\n\n/** Audio sent to the worker. Its buffers are transferred, not copied. */\nexport type LocalWorkerAudio =\n  | {\n      /** WAV or raw PCM bytes (or any format the worker's `decodeAudio` handles). */\n      kind: 'encoded';\n      bytes: Uint8Array;\n      mimeType: string;\n      sampleRate?: number;\n      channels?: number;\n    }\n  | {\n      /** Channels decoded on the main thread; the worker downmixes and resamples. */\n      kind: 'decoded';\n      samples: Float32Array[];\n      sampleRate: number;\n    };\n\n/** Messages from the client to the worker. */\nexport type LocalWorkerRequest =\n  | {\n      kind: 'transcribe';\n      id: number;\n      audio: LocalWorkerAudio;\n      model?: string;\n      language?: string;\n      timestampGranularities?: TimestampGranularity[];\n    }\n  | { kind: 'preload'; id: number; model?: string }\n  | { kind: 'abort'; id: number };\n\n/** Messages from the worker to the client. */\nexport type LocalWorkerResponse =\n  | { kind: 'result'; id: number; result?: TranscriptResult }\n  | {\n      kind: 'error';\n      id: number;\n      error: { name: string; message: string; code?: string };\n    }\n  | { kind: 'progress'; progress: LocalTranscriberProgress };\n\nconst PCM_MIME_TYPE = `audio/pcm;rate=${LOCAL_SAMPLE_RATE};encoding=f32le`;\n\n/**\n * Runs a {@link LocalTranscriber} inside a worker and answers client\n * requests. Call it from your worker module:\n *\n * ```ts\n * // transcriber.worker.ts\n * import { serveLocalTranscriber } from '@happyvertical/speech/local';\n * serveLocalTranscriber({ model: 'onnx-community/whisper-base' });\n * ```\n *\n * Returns a function that stops listening and disposes the model.\n */\nexport function serveLocalTranscriber(\n  options: LocalTranscriberOptions = {},\n  endpoint: LocalWorkerEndpoint = globalThis as unknown as LocalWorkerEndpoint,\n): () => Promise<void> {\n  const userProgress = options.onProgress;\n  const transcriber = new LocalTranscriber({\n    ...resolveLocalTranscriberOptions(options),\n    // The client already enforced its byte limit on the encoded input.\n    maxBytes: Number.POSITIVE_INFINITY,\n    onProgress: (progress) => {\n      userProgress?.(progress);\n      endpoint.postMessage({\n        kind: 'progress',\n        progress: toCloneable(progress),\n      } satisfies LocalWorkerResponse);\n    },\n  });\n  const pending = new Map<number, AbortController>();\n\n  const reply = (message: LocalWorkerResponse) => endpoint.postMessage(message);\n  const listener = (event: MessageEvent) => {\n    const message = event.data as LocalWorkerRequest;\n    if (!message || typeof message !== 'object') {\n      return;\n    }\n\n    if (message.kind === 'abort') {\n      pending.get(message.id)?.abort();\n      return;\n    }\n\n    const controller = new AbortController();\n    pending.set(message.id, controller);\n    const work =\n      message.kind === 'preload'\n        ? transcriber.preload(message.model, controller.signal).then(() => {\n            reply({ kind: 'result', id: message.id });\n          })\n        : Promise.resolve()\n            .then(() =>\n              transcriber.transcribe({\n                audio: toAudioInput(message.audio),\n                model: message.model,\n                language: message.language,\n                timestampGranularities: message.timestampGranularities,\n                signal: controller.signal,\n              }),\n            )\n            .then((result) => {\n              reply({ kind: 'result', id: message.id, result });\n            });\n\n    work\n      .catch((error: unknown) => {\n        reply({ kind: 'error', id: message.id, error: serializeError(error) });\n      })\n      .finally(() => pending.delete(message.id));\n  };\n\n  endpoint.addEventListener('message', listener);\n  return async () => {\n    endpoint.removeEventListener('message', listener);\n    for (const controller of pending.values()) {\n      controller.abort();\n    }\n    await transcriber.dispose();\n  };\n}\n\nexport interface LocalTranscriberWorkerClientOptions {\n  /** Encoded input byte limit, checked on the main thread. Default 25 MB. */\n  maxBytes?: number;\n  /**\n   * Main-thread decoder for formats other than WAV and raw PCM. Formats with\n   * neither this hook nor `AudioContext` go to the worker's own `decodeAudio`.\n   */\n  decodeAudio?: LocalAudioDecoder;\n  /** Model download/load progress forwarded from the worker. */\n  onProgress?: LocalTranscriberProgressCallback;\n  /** Called with usage after every successful transcription. */\n  onUsage?: SpeechUsageCallback;\n}\n\n/**\n * Main-thread {@link Transcriber} that delegates inference to a worker running\n * {@link serveLocalTranscriber}.\n *\n * ```ts\n * const worker = new Worker(new URL('./transcriber.worker.ts', import.meta.url), { type: 'module' });\n * const transcriber = new LocalTranscriberWorkerClient(worker, { onProgress });\n * const { text } = await transcriber.transcribe({ audio: recordingBlob });\n * ```\n */\nexport class LocalTranscriberWorkerClient implements Transcriber {\n  readonly type = 'local' as const;\n\n  private readonly endpoint: LocalWorkerEndpoint;\n  private readonly options: LocalTranscriberWorkerClientOptions;\n  private readonly calls = new Map<\n    number,\n    {\n      resolve: (result: TranscriptResult | undefined) => void;\n      reject: (error: unknown) => void;\n    }\n  >();\n  private nextId = 1;\n  private closed = false;\n  /** Aborted by `close()` to reject calls still buffering or decoding. */\n  private readonly closing = new AbortController();\n  private readonly listener = (event: MessageEvent) =>\n    this.onMessage(event.data as LocalWorkerResponse);\n\n  constructor(\n    endpoint: LocalWorkerEndpoint,\n    options: LocalTranscriberWorkerClientOptions = {},\n  ) {\n    this.endpoint = endpoint;\n    this.options = options;\n    endpoint.addEventListener('message', this.listener);\n  }\n\n  /** Loads the model in the worker ahead of the first transcription. */\n  async preload(model?: string, signal?: AbortSignal): Promise<void> {\n    await this.call({ kind: 'preload', model }, signal);\n  }\n\n  async transcribe(request: TranscriptionRequest): Promise<TranscriptResult> {\n    this.assertOpen();\n    const { signal } = request;\n    // Buffering and main-thread decoding count as in flight: close() rejects them.\n    const { audio, bytes } = await raceAbort(\n      this.prepare(request),\n      this.closing.signal,\n    );\n\n    const result = await this.call(\n      {\n        kind: 'transcribe',\n        audio,\n        model: request.model,\n        language: request.language,\n        timestampGranularities: request.timestampGranularities,\n      },\n      signal,\n      transferList(audio),\n    );\n    if (!result) {\n      throw new SpeechProviderError(this.type, 'Worker returned no result');\n    }\n\n    const usage: SpeechUsage = {\n      ...(result.usage ?? { operation: 'transcription', provider: this.type }),\n      bytes,\n    };\n    await reportSpeechUsage(usage, this.options.onUsage, request.onUsage);\n    return { ...result, usage };\n  }\n\n  /**\n   * Stops listening, rejects in-flight and later calls, and asks the worker to\n   * abort posted work. Does not terminate the worker.\n   */\n  close(): void {\n    if (this.closed) {\n      return;\n    }\n    this.closed = true;\n    this.endpoint.removeEventListener('message', this.listener);\n    this.closing.abort(closedError());\n    for (const [id, call] of this.calls) {\n      this.endpoint.postMessage({\n        kind: 'abort',\n        id,\n      } satisfies LocalWorkerRequest);\n      call.reject(closedError());\n    }\n    this.calls.clear();\n  }\n\n  /** Buffers the input and, only when the worker cannot, decodes it here. */\n  private async prepare(\n    request: TranscriptionRequest,\n  ): Promise<{ audio: LocalWorkerAudio; bytes: number }> {\n    const { signal } = request;\n    const normalized = await normalizeAudioInput(request.audio, {\n      mimeType: request.mimeType,\n      maxBytes:\n        request.maxBytes ?? this.options.maxBytes ?? DEFAULT_MAX_AUDIO_BYTES,\n      adapter: this.type,\n      signal,\n    });\n    const bytes = new Uint8Array(await normalized.blob.arrayBuffer());\n\n    if (!isInProcessDecodable(bytes, normalized.mimeType)) {\n      // Decoders (caller hooks, decodeAudioData) cannot be cancelled: stop waiting on abort.\n      const decoded = await raceAbort(\n        decodeExternally(bytes, {\n          mimeType: normalized.mimeType,\n          decodeAudio: this.options.decodeAudio,\n          signal,\n        }),\n        signal,\n      );\n      if (decoded) {\n        const channels =\n          decoded.samples instanceof Float32Array\n            ? [decoded.samples]\n            : decoded.samples;\n        return {\n          audio: {\n            kind: 'decoded',\n            samples: channels.map(ownedCopy),\n            sampleRate: decoded.sampleRate,\n          },\n          bytes: normalized.bytes,\n        };\n      }\n    }\n\n    const wrapped =\n      typeof request.audio === 'object' &&\n      'data' in request.audio &&\n      !(request.audio instanceof Uint8Array)\n        ? request.audio\n        : undefined;\n    return {\n      audio: {\n        kind: 'encoded',\n        bytes: ownedCopy(bytes),\n        mimeType: normalized.mimeType,\n        sampleRate: wrapped?.sampleRate,\n        channels: wrapped?.channels,\n      },\n      bytes: normalized.bytes,\n    };\n  }\n\n  private assertOpen(): void {\n    if (this.closed) {\n      throw closedError();\n    }\n  }\n\n  private call(\n    message:\n      | Omit<Extract<LocalWorkerRequest, { kind: 'transcribe' }>, 'id'>\n      | Omit<Extract<LocalWorkerRequest, { kind: 'preload' }>, 'id'>,\n    signal: AbortSignal | undefined,\n    transfer: Transferable[] = [],\n  ): Promise<TranscriptResult | undefined> {\n    this.assertOpen();\n    signal?.throwIfAborted();\n    const id = this.nextId++;\n\n    return new Promise((resolve, reject) => {\n      const onAbort = () => {\n        this.calls.delete(id);\n        this.endpoint.postMessage({ kind: 'abort', id });\n        reject(signal?.reason);\n      };\n      const settle = () => signal?.removeEventListener('abort', onAbort);\n      this.calls.set(id, {\n        resolve: (result) => {\n          settle();\n          resolve(result);\n        },\n        reject: (error) => {\n          settle();\n          reject(error);\n        },\n      });\n      signal?.addEventListener('abort', onAbort, { once: true });\n      this.endpoint.postMessage({ ...message, id }, transfer);\n    });\n  }\n\n  private onMessage(message: LocalWorkerResponse): void {\n    if (!message || typeof message !== 'object') {\n      return;\n    }\n    if (message.kind === 'progress') {\n      this.options.onProgress?.(message.progress);\n      return;\n    }\n\n    const call = this.calls.get(message.id);\n    if (!call) {\n      return;\n    }\n    this.calls.delete(message.id);\n    if (message.kind === 'result') {\n      call.resolve(message.result);\n    } else {\n      call.reject(deserializeError(message.error));\n    }\n  }\n}\n\nfunction closedError(): SpeechConfigurationError {\n  return new SpeechConfigurationError('Worker client closed', 'local');\n}\n\n/** Rebuilds the transcriber input from a worker message, resampling decoded channels here. */\nfunction toAudioInput(audio: LocalWorkerAudio): AudioInput {\n  if (audio.kind === 'decoded') {\n    const pcm = toPcm16k({\n      samples: audio.samples,\n      sampleRate: audio.sampleRate,\n    });\n    return {\n      data: new Uint8Array(pcm.buffer, pcm.byteOffset, pcm.byteLength),\n      mimeType: PCM_MIME_TYPE,\n    };\n  }\n  return {\n    data: audio.bytes,\n    mimeType: audio.mimeType,\n    sampleRate: audio.sampleRate,\n    channels: audio.channels,\n  };\n}\n\n/**\n * Returns `view` when it spans a whole ordinary `ArrayBuffer` (safe to\n * transfer), otherwise a copy. Views of a larger buffer would transfer\n * unrelated bytes, and a `SharedArrayBuffer` cannot be transferred at all.\n */\nfunction ownedCopy<T extends Uint8Array | Float32Array>(view: T): T {\n  const { buffer } = view;\n  return isPlainArrayBuffer(buffer) &&\n    view.byteOffset === 0 &&\n    view.byteLength === buffer.byteLength\n    ? view\n    : (view.slice() as T);\n}\n\nfunction isPlainArrayBuffer(buffer: ArrayBufferLike): buffer is ArrayBuffer {\n  // Tag check rather than instanceof: buffers may come from another realm.\n  return Object.prototype.toString.call(buffer) === '[object ArrayBuffer]';\n}\n\n/** Distinct buffers to transfer (two channels may share one). */\nfunction transferList(audio: LocalWorkerAudio): ArrayBuffer[] {\n  const views = audio.kind === 'decoded' ? audio.samples : [audio.bytes];\n  return [...new Set(views.map((view) => view.buffer as ArrayBuffer))];\n}\n\nfunction serializeError(error: unknown): {\n  name: string;\n  message: string;\n  code?: string;\n} {\n  if (error instanceof SpeechError) {\n    return { name: error.name, message: error.message, code: error.code };\n  }\n  if (error instanceof Error) {\n    return { name: error.name, message: error.message };\n  }\n  return { name: 'Error', message: String(error) };\n}\n\nfunction deserializeError(error: {\n  name: string;\n  message: string;\n  code?: string;\n}): Error {\n  switch (error.name) {\n    case 'SpeechConfigurationError':\n      return new SpeechConfigurationError(error.message, 'local');\n    case 'SpeechProviderError':\n      return new SpeechProviderError('local', error.message);\n    case 'AbortError':\n      return new DOMException(error.message, 'AbortError');\n    default: {\n      const restored = new Error(error.message);\n      restored.name = error.name;\n      return restored;\n    }\n  }\n}\n\n/** Progress objects cross `postMessage`, so drop anything not cloneable. */\nfunction toCloneable(\n  progress: LocalTranscriberProgress,\n): LocalTranscriberProgress {\n  const clone: LocalTranscriberProgress = { status: progress.status };\n  for (const [key, value] of Object.entries(progress)) {\n    if (\n      value === null ||\n      ['string', 'number', 'boolean'].includes(typeof value)\n    ) {\n      clone[key] = value;\n    }\n  }\n  return clone;\n}\n","/**\n * @happyvertical/speech/local\n *\n * On-device speech-to-text with transformers.js (`@huggingface/transformers`,\n * an optional peer dependency loaded on first use). Importing this entry\n * registers `type: 'local'` with `getTranscriber()` and `getSpeech()`.\n *\n * @example\n * ```typescript\n * import { getTranscriber } from '@happyvertical/speech';\n * import '@happyvertical/speech/local';\n *\n * const transcriber = await getTranscriber({ type: 'local' });\n * const { text } = await transcriber.transcribe({ audio: wavBytes, mimeType: 'audio/wav' });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { resolveLocalTranscriberOptions } from './adapters/local/env.js';\nimport { loadTransformers } from './adapters/local/runtime.js';\nimport { LocalTranscriber } from './adapters/local/transcriber.js';\nimport type { LocalTranscriberOptions } from './adapters/local/types.js';\nimport type { SpeechFactoryContext } from './shared/factory.js';\nimport { registerOptionalTranscriber } from './shared/registry.js';\n\nexport {\n  decodeToPcm16k,\n  LOCAL_SAMPLE_RATE,\n} from './adapters/local/audio.js';\nexport { LOCAL_TRANSCRIBER_ENV_KEYS } from './adapters/local/env.js';\nexport {\n  TRANSFORMERS_INSTALL_HINT,\n  TRANSFORMERS_PACKAGE,\n} from './adapters/local/runtime.js';\nexport {\n  DEFAULT_LOCAL_MODEL,\n  LocalTranscriber,\n} from './adapters/local/transcriber.js';\nexport type {\n  DecodedAudio,\n  LocalAudioDecoder,\n  LocalTranscriberDevice,\n  LocalTranscriberDtype,\n  LocalTranscriberOptions,\n  LocalTranscriberProgress,\n  LocalTranscriberProgressCallback,\n  LocalTranscriberSettings,\n  LocalTransformersRuntime,\n} from './adapters/local/types.js';\nexport {\n  LocalTranscriberWorkerClient,\n  type LocalTranscriberWorkerClientOptions,\n  type LocalWorkerAudio,\n  type LocalWorkerEndpoint,\n  type LocalWorkerRequest,\n  type LocalWorkerResponse,\n  serveLocalTranscriber,\n} from './adapters/local/worker.js';\n\n/**\n * Creates an on-device transcriber. Explicit options win over\n * `HAVE_SPEECH_TRANSCRIBER_*` environment variables (see\n * `LOCAL_TRANSCRIBER_ENV_KEYS`). The model loads on first use.\n */\nexport function createLocalTranscriber(\n  options: LocalTranscriberOptions = {},\n  context: Pick<SpeechFactoryContext, 'env'> = {},\n): LocalTranscriber {\n  return new LocalTranscriber(resolveLocalTranscriberOptions(options, context));\n}\n\n/**\n * Resolves `true` when `@huggingface/transformers` can be imported in this\n * runtime. This imports the runtime, so call it only when you intend to use it.\n */\nexport async function isLocalTranscriberAvailable(): Promise<boolean> {\n  try {\n    await loadTransformers(undefined);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nregisterOptionalTranscriber('local', (options, context) =>\n  createLocalTranscriber(\n    { ...options, type: 'local' } as LocalTranscriberOptions,\n    context,\n  ),\n);\n"],"mappings":"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"}

package/dist/shared/audio.d.ts

@@ -0,0 +1,47 @@
+import { AudioInput, AudioSource } from './types.js';
+/** OpenAI caps `/audio/transcriptions` uploads at 25 MB. */
+export declare const DEFAULT_MAX_AUDIO_BYTES: number;
+/**
+ * Strips parameters (e.g. `;codecs=opus`) and lower-cases a MIME type.
+ * Returns `undefined` for blank input.
+ */
+export declare function normalizeMimeType(mimeType: string | undefined | null): string | undefined;
+/**
+ * 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.
+ */
+export declare function mimeTypeToAudioExtension(mimeType: string | undefined | null): string | undefined;
+export interface NormalizeAudioOptions {
+    /** MIME type override; wins over `AudioInput.mimeType`/`contentType` and Blob type. */
+    mimeType?: string;
+    /**
+     * Maximum payload size in bytes. `undefined` or `Infinity` disables the
+     * limit. Streams are cancelled as soon as they exceed it.
+     */
+    maxBytes?: number;
+    /** Adapter name recorded on configuration errors. */
+    adapter?: string;
+    /** Aborts buffering (including a pending stream read) with the signal's reason. */
+    signal?: AbortSignal;
+    /** Base filename (without extension) used when the input has none. */
+    defaultBasename?: string;
+    /** Append a MIME-derived extension to the default filename. Default `true`. */
+    deriveExtension?: boolean;
+}
+export interface NormalizedAudio {
+    blob: Blob;
+    /** Full MIME type including parameters, or `application/octet-stream`. */
+    mimeType: string;
+    bytes: number;
+    /** Explicit filename, or `<basename>.<ext>` derived from the MIME type. */
+    filename: string;
+    durationSeconds?: number;
+}
+/**
+ * Accepts either an {@link AudioInput} wrapper or a bare {@link AudioSource}
+ * and returns a size-checked Blob plus the metadata needed for multipart
+ * uploads.
+ */
+export declare function normalizeAudioInput(input: AudioInput | AudioSource, options?: NormalizeAudioOptions): Promise<NormalizedAudio>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/shared/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/shared/audio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AAsBxD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAClC,MAAM,GAAG,SAAS,CAGpB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAClC,MAAM,GAAG,SAAS,CAGpB;AAED,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,eAAe,CAAC,CAuD1B"}

package/dist/shared/env.d.ts

@@ -0,0 +1,75 @@
+import { SpeechFetch } from './types.js';
+export interface SpeechEnv {
+    [key: string]: string | undefined;
+}
+/** Environment variable names read for each transcriber setting, in priority order. */
+export declare const TRANSCRIBER_ENV_KEYS: {
+    readonly type: readonly ["HAVE_SPEECH_TRANSCRIBER_TYPE", "HAVE_SPEECH_STT_TYPE", "HAVE_SPEECH_STT_ADAPTER", "STT_ADAPTER"];
+    readonly baseUrl: readonly ["HAVE_SPEECH_TRANSCRIBER_BASE_URL", "HAVE_SPEECH_STT_BASE_URL", "STT_BASE_URL"];
+    readonly model: readonly ["HAVE_SPEECH_TRANSCRIBER_MODEL", "HAVE_SPEECH_STT_MODEL", "STT_MODEL"];
+    readonly apiKey: readonly ["HAVE_SPEECH_TRANSCRIBER_API_KEY", "HAVE_SPEECH_STT_API_KEY", "STT_API_KEY", "SPEECH_API_KEY"];
+    readonly timeoutMs: readonly ["HAVE_SPEECH_TRANSCRIBER_TIMEOUT", "HAVE_SPEECH_TRANSCRIBER_TIMEOUT_MS", "HAVE_SPEECH_STT_TIMEOUT_MS", "STT_TIMEOUT_MS"];
+    readonly maxBytes: readonly ["HAVE_SPEECH_TRANSCRIBER_MAX_BYTES", "STT_MAX_BYTES"];
+    readonly headers: readonly ["HAVE_SPEECH_TRANSCRIBER_HEADERS", "STT_HEADERS"];
+    readonly path: readonly ["HAVE_SPEECH_TRANSCRIBER_PATH", "HAVE_SPEECH_STT_PATH", "STT_PATH"];
+};
+/** Transcriber settings read from the environment. All fields are optional. */
+export interface TranscriberEnvConfig {
+    type?: string;
+    baseUrl?: string;
+    model?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    maxBytes?: number;
+    headers?: Record<string, string>;
+    path?: string;
+}
+/** Options shape accepted by {@link resolveTranscriberConfig}. */
+export interface TranscriberConfigInput {
+    type?: string;
+    baseUrl?: string;
+    model?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    maxBytes?: number;
+    headers?: HeadersInit;
+    fetch?: SpeechFetch;
+}
+export interface TranscriberConfigContext {
+    env?: SpeechEnv;
+    fetch?: SpeechFetch;
+    headers?: HeadersInit;
+}
+/** Resolved transcriber settings. `headers` merges env → context → options. */
+export interface ResolvedTranscriberConfig {
+    type?: string;
+    baseUrl?: string;
+    model?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    maxBytes?: number;
+    headers?: Headers;
+    fetch?: SpeechFetch;
+    path?: string;
+}
+export declare function readTranscriberEnv(env: SpeechEnv): TranscriberEnvConfig;
+export declare function hasTranscriberEnv(env: SpeechEnv): boolean;
+/**
+ * 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.
+ */
+export declare function resolveTranscriberConfig(options?: TranscriberConfigInput, context?: TranscriberConfigContext): ResolvedTranscriberConfig;
+/** Merges header sets left to right; later sets win per header name. */
+export declare function mergeHeaderInits(...sets: Array<HeadersInit | undefined>): Headers | undefined;
+export declare function readEnv(env: SpeechEnv, ...keys: string[]): string | undefined;
+export declare function hasAnyEnv(env: SpeechEnv, ...keys: string[]): boolean;
+export declare function parseOptionalInteger(value: string | undefined): number | undefined;
+export declare function defaultEnv(): SpeechEnv;
+/**
+ * Parses a JSON object of header names to string values. The raw value is
+ * never echoed in errors because it may carry credentials.
+ */
+export declare function parseHeadersEnv(env: SpeechEnv, keys: readonly string[]): Record<string, string> | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/shared/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/shared/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,uFAAuF;AACvF,eAAO,MAAM,oBAAoB;;;;;;;;;CAgCvB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,oBAAoB,CAevE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,sBAA2B,EACpC,OAAO,GAAE,wBAA6B,GACrC,yBAAyB,CAmB3B;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GACtC,OAAO,GAAG,SAAS,CAarB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAS7E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEpE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,UAAU,IAAI,SAAS,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA+BpC"}

package/dist/shared/errors.d.ts

@@ -12,9 +12,12 @@ export declare class InvalidSpeechAdapterError extends SpeechError {
 export declare class SpeechProviderError extends SpeechError {
     readonly status?: number;
     readonly responseBody?: string;
+    /** Parsed `Retry-After` delay in milliseconds, when the provider sent one. */
+    readonly retryAfterMs?: number;
     constructor(adapter: string, message: string, options?: {
         status?: number;
         responseBody?: string;
+        retryAfterMs?: number;
         cause?: unknown;
     });
 }

package/dist/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM;gBAFvB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,YAAA;CAK1B;AAED,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI9C;AAED,qBAAa,yBAA0B,SAAQ,WAAW;gBAC5C,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAIvC;AAED,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAU5E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM;gBAFvB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,YAAA;CAK1B;AAED,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI9C;AAED,qBAAa,yBAA0B,SAAQ,WAAW;gBAC5C,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAIvC;AAED,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAWT"}

package/dist/shared/factory.d.ts

@@ -1,7 +1,5 @@
+import { SpeechEnv } from './env.js';
 import { GetSpeechOptions, GetSpeechSynthesizerOptions, GetTranscriberOptions, Speech, SpeechAdapterAvailability, SpeechFetch, SpeechSynthesizer, Transcriber } from './types.js';
-interface SpeechEnv {
-    [key: string]: string | undefined;
-}
 export interface SpeechFactoryContext {
     env?: SpeechEnv;
     fetch?: SpeechFetch;
@@ -18,5 +16,4 @@ export declare function getSpeech(options?: GetSpeechOptions, context?: SpeechFa
 export declare function getTranscriber(options?: GetTranscriberOptions, context?: SpeechFactoryContext): Promise<Transcriber>;
 export declare function getSpeechSynthesizer(options?: GetSpeechSynthesizerOptions, context?: SpeechFactoryContext): Promise<SpeechSynthesizer>;
 export declare function getAvailableSpeechAdapters(): SpeechAdapterAvailability;
-export {};
 //# sourceMappingURL=factory.d.ts.map

package/dist/shared/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/shared/factory.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EAGrB,MAAM,EACN,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EAKjB,WAAW,EAGZ,MAAM,YAAY,CAAC;AAEpB,UAAU,SAAS;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,OAAO,GAAE,gBAAqB,EAC9B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,EACnC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,2BAA2B,EACrC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAgB5B;AAED,wBAAgB,0BAA0B,IAAI,yBAAyB,CAKtE"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/shared/factory.ts"],"names":[],"mappings":"AAOA,OAAO,EAOL,KAAK,SAAS,EAEf,MAAM,UAAU,CAAC;AAqBlB,OAAO,KAAK,EACV,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EAIrB,MAAM,EACN,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EAKjB,WAAW,EAGZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,OAAO,GAAE,gBAAqB,EAC9B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,EACnC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,CA0BtB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,2BAA2B,EACrC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAgB5B;AAED,wBAAgB,0BAA0B,IAAI,yBAAyB,CAWtE"}

package/dist/shared/http.d.ts

@@ -1,6 +1,24 @@
-import { AudioInput, HttpSpeechOptions, SpeechFetch, SynthesisRequest, SynthesizedSpeech, TranscriptResult, TranscriptSegment, WordTiming } from './types.js';
+import { SpeechRetryOptions } from './retry.js';
+import { HttpSpeechOptions, SpeechFetch, SynthesisRequest, SynthesizedSpeech, TranscriptResult, TranscriptSegment, WordTiming } from './types.js';
+/**
+ * Returns `baseUrl` with a trailing `/` on its path so relative paths resolve
+ * beneath it. The query string is preserved and any fragment is dropped.
+ */
 export declare function normalizeBaseUrl(baseUrl: string): string;
+/**
+ * Resolves `path` against `baseUrl`. A relative path without its own query
+ * inherits the base URL's query (for example a gateway `api-version`); an
+ * absolute URL is returned unchanged.
+ */
 export declare function resolveSpeechUrl(baseUrl: string, path: string): string;
+/**
+ * Resolves an OpenAI-compatible endpoint from a base URL. Accepts a server
+ * root (`https://api.openai.com` → `/v1/<resource>`), an API root ending in a
+ * version segment (`http://gateway/stt/v1` → `/<resource>`), or the full
+ * endpoint URL (used as-is). Only the path is rewritten: the query string is
+ * preserved and any fragment is dropped.
+ */
+export declare function resolveOpenAICompatibleUrl(baseUrl: string, resource: string): string;
 export declare function resolveFetch(fetchOverride?: SpeechFetch): SpeechFetch;
 export declare function mergeHeaders(options: Pick<HttpSpeechOptions, 'apiKey' | 'headers'>, extra?: HeadersInit): Headers;
 export declare abstract class HttpSpeechAdapter {
@@ -10,9 +28,17 @@ export declare abstract class HttpSpeechAdapter {
     protected readonly headers?: HeadersInit;
     protected readonly timeoutMs?: number;
     constructor(options: HttpSpeechOptions);
-    protected post<T>(adapterName: string, path: string, init: Omit<RequestInit, 'method'>, readResponse: (response: Response) => Promise<T>): Promise<T>;
+    /**
+     * POSTs to `path` (relative to `baseUrl`, or an absolute URL). The optional
+     * `retry` policy retries 429/5xx responses; `timeoutMs` applies per attempt.
+     * The request body must be re-sendable (string, Blob, FormData) when
+     * retries are enabled.
+     */
+    protected post<T>(adapterName: string, path: string, init: Omit<RequestInit, 'method'>, readResponse: (response: Response) => Promise<T>, retry?: Required<SpeechRetryOptions> | false): Promise<T>;
+    private postOnce;
 }
-export declare function appendAudioInput(form: FormData, audio: AudioInput, fieldName?: string): void;
+/** Removes an API key from provider-supplied text before it is surfaced. */
+export declare function redactSecret(text: string | undefined, secret: string | undefined): string | undefined;
 export declare function appendOptionalFormValue(form: FormData, name: string, value: unknown): void;
 export declare function createHappyVerticalSynthesisForm(request: SynthesisRequest, defaultVoice?: string): FormData;
 export declare function voiceToString(voice: string | {

package/dist/shared/http.d.ts.map

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

package/dist/shared/pcm.d.ts

@@ -0,0 +1,21 @@
+import { StreamingAudioChunk, StreamingAudioFormat } from './streaming-types.js';
+/** Returns a byte view over a chunk without copying. */
+export declare function chunkToBytes(chunk: StreamingAudioChunk, adapter?: string): Uint8Array;
+export declare function encodeBase64(bytes: Uint8Array): string;
+/** Bytes per second of audio in `format`. */
+export declare function bytesPerSecond(format: StreamingAudioFormat): number;
+/** Audio duration in seconds for `bytes` of `format`, rounded to milliseconds. */
+export declare function audioSecondsForBytes(bytes: number, format: StreamingAudioFormat): number;
+export interface RawAudio {
+    bytes: Uint8Array;
+    /** Format fields the input declared (WAV header, MIME parameters, or `AudioInput`). */
+    format: Partial<StreamingAudioFormat>;
+}
+/**
+ * Interprets a finished recording as raw audio for a streaming session.
+ * Accepts PCM/G.711 WAV files, `audio/pcm`/`audio/L16` (with optional `rate`
+ * and `channels` parameters), `audio/pcmu`/`audio/pcma`, and untyped bytes.
+ * Compressed containers are rejected with a `SpeechConfigurationError`.
+ */
+export declare function unwrapRawAudio(bytes: Uint8Array, mimeType: string, adapter: string): RawAudio;
+//# sourceMappingURL=pcm.d.ts.map

package/dist/shared/pcm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm.d.ts","sourceRoot":"","sources":["../../src/shared/pcm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEnB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAQ9B,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,UAAU,CAcZ;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAetD;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAMnE;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAER;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,uFAAuF;IACvF,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACvC;AAmBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,QAAQ,CA2CV"}

package/dist/shared/realtime-auth.d.ts

@@ -0,0 +1,34 @@
+import { RealtimeConnection } from './realtime-session.js';
+import { StreamingClientSecret } from './streaming-types.js';
+/** Subprotocol prefix that carries a client secret (OpenAI's convention). */
+export declare const CLIENT_SECRET_SUBPROTOCOL_PREFIX = "openai-insecure-api-key.";
+/** Throws when an adapter is given a long-lived `apiKey` in a browser. */
+export declare function assertNoBrowserApiKey(adapter: string, apiKey: string | undefined): void;
+/** Resolves a static or per-session client secret and validates its shape. */
+export declare function resolveClientSecret(adapter: string, secret: StreamingClientSecret | undefined): Promise<string | undefined>;
+export interface RealtimeConnectorOptions {
+    adapter: string;
+    url: string;
+    apiKey?: string;
+    headers: Record<string, string>;
+    clientSecret?: StreamingClientSecret;
+    /** Subprotocols to offer, given the resolved client secret (if any). */
+    protocols: (secret: string | undefined) => string[];
+}
+/**
+ * Builds the per-session `connect` callback: refuses handshake headers in a
+ * browser, resolves the client secret, and sets `Authorization` from
+ * `apiKey` unless a header already supplies it.
+ */
+export declare function realtimeConnector(options: RealtimeConnectorOptions): () => Promise<RealtimeConnection>;
+/**
+ * Values of caller-supplied headers to redact from provider error text.
+ * Credential-named headers are redacted whatever their length; for
+ * `Authorization`, the credential after the scheme is included too. Other
+ * headers may also carry tenant secrets, so their values are redacted when
+ * they are at least 8 characters long, which keeps short values such as
+ * `1` from mangling messages.
+ */
+export declare function headerSecrets(headers: HeadersInit | undefined): string[];
+export declare function mergeHeaderRecords(...sets: Array<HeadersInit | undefined>): Record<string, string>;
+//# sourceMappingURL=realtime-auth.d.ts.map

package/dist/shared/realtime-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-auth.d.ts","sourceRoot":"","sources":["../../src/shared/realtime-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,6EAA6E;AAC7E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAS3E,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,IAAI,CAON;AAED,8EAA8E;AAC9E,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,wEAAwE;IACxE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,EAAE,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAiCnC;AAYD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,EAAE,CAkBxE;AAED,wBAAgB,kBAAkB,CAChC,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB"}