@voiceinput/openai 0.1.0-beta.1

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["OPENAI_SAMPLE_RATE","VoiceInputError","validateOpenAITokenRequest","createOpenAITranscriptionSession","sendWithBackpressure"],"sources":["../src/index.ts"],"sourcesContent":["import { sendWithBackpressure } from \"@voiceinput/provider/transport\";\nimport {\n  VoiceInputError,\n  type VoiceInputProviderV1,\n  type VoiceInputProviderV1CallOptions,\n  type VoiceInputProviderV1Session,\n  type VoiceInputProviderV1StreamPart,\n  type VoiceTranscriptionOptions,\n} from \"@voiceinput/provider\";\n\nimport {\n  OPENAI_DEFAULT_MODEL,\n  OPENAI_SAMPLE_RATE,\n  createOpenAITranscriptionSession,\n  validateOpenAITokenRequest,\n  type OpenAITokenRequest,\n} from \"./session-config.js\";\n\nconst DEFAULT_REALTIME_URL = \"wss://api.openai.com/v1/realtime\";\n\nexport interface OpenAIVoiceInputProviderOptions {\n  readonly tokenEndpoint: string | URL;\n  readonly model?: string;\n  readonly fetch?: typeof globalThis.fetch;\n  readonly webSocket?: typeof globalThis.WebSocket;\n  readonly realtimeUrl?: string;\n}\n\ninterface OpenAICredential {\n  value: string;\n  expires_at: number;\n}\n\ninterface TranscriptState {\n  delta: string;\n  final?: string;\n  lastEmittedInterim?: string;\n}\n\nexport function openai(\n  options: OpenAIVoiceInputProviderOptions,\n): VoiceInputProviderV1 {\n  const model = validateFactoryString(\n    options.model ?? OPENAI_DEFAULT_MODEL,\n    \"model\",\n  );\n  const tokenEndpoint = validateFactoryString(\n    String(options.tokenEndpoint),\n    \"tokenEndpoint\",\n  );\n  const realtimeUrl = validateFactoryString(\n    options.realtimeUrl ?? DEFAULT_REALTIME_URL,\n    \"realtimeUrl\",\n  );\n  const fetchImplementation = options.fetch ?? globalThis.fetch;\n  const WebSocketImplementation = options.webSocket ?? globalThis.WebSocket;\n  const validateProviderOptions = (\n    transcriptionOptions: VoiceTranscriptionOptions,\n  ): void => validateOptions(transcriptionOptions, model);\n\n  return Object.freeze({\n    specificationVersion: \"v1\" as const,\n    provider: \"openai\",\n    modelId: model,\n    sampleRate: OPENAI_SAMPLE_RATE,\n    validateOptions: validateProviderOptions,\n    async doOpen(callOptions: VoiceInputProviderV1CallOptions) {\n      validateProviderOptions(callOptions);\n      return await openSession({\n        callOptions,\n        fetchImplementation,\n        model,\n        realtimeUrl,\n        tokenEndpoint,\n        WebSocketImplementation,\n      });\n    },\n  });\n}\n\nfunction validateOptions(\n  options: VoiceTranscriptionOptions,\n  model: string,\n): void {\n  try {\n    validateOpenAITokenRequest({\n      model,\n      ...options,\n    });\n  } catch (cause) {\n    if (VoiceInputError.isInstance(cause)) {\n      throw cause;\n    }\n    throw new VoiceInputError({\n      code: \"invalid-configuration\",\n      message:\n        cause instanceof Error\n          ? cause.message\n          : \"Invalid OpenAI transcription options.\",\n      provider: \"openai\",\n      cause,\n    });\n  }\n}\n\nasync function openSession(options: {\n  callOptions: VoiceInputProviderV1CallOptions;\n  fetchImplementation: typeof globalThis.fetch;\n  model: string;\n  realtimeUrl: string;\n  tokenEndpoint: string;\n  WebSocketImplementation: typeof globalThis.WebSocket;\n}): Promise<VoiceInputProviderV1Session> {\n  const { abortSignal } = options.callOptions;\n  throwIfAborted(abortSignal);\n  if (typeof options.fetchImplementation !== \"function\") {\n    throw unsupportedBrowserFeature(\"fetch\");\n  }\n  if (typeof options.WebSocketImplementation !== \"function\") {\n    throw unsupportedBrowserFeature(\"WebSocket\");\n  }\n  const tokenRequest = validateOpenAITokenRequest({\n    model: options.model,\n    ...options.callOptions,\n  });\n  const credential = await requestCredential(\n    options.fetchImplementation,\n    options.tokenEndpoint,\n    tokenRequest,\n    abortSignal,\n  );\n  throwIfAborted(abortSignal);\n\n  const socket = new options.WebSocketImplementation(options.realtimeUrl, [\n    \"realtime\",\n    `openai-insecure-api-key.${credential.value}`,\n  ]);\n  return await createSession(socket, tokenRequest, abortSignal);\n}\n\nasync function requestCredential(\n  fetchImplementation: typeof globalThis.fetch,\n  tokenEndpoint: string,\n  tokenRequest: OpenAITokenRequest,\n  abortSignal: AbortSignal,\n): Promise<OpenAICredential> {\n  let response: Response;\n  try {\n    response = await fetchImplementation(tokenEndpoint, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(tokenRequest),\n      credentials: \"same-origin\",\n      signal: abortSignal,\n    });\n  } catch (cause) {\n    throwIfAborted(abortSignal);\n    throw new VoiceInputError({\n      code: \"network-error\",\n      message: \"Unable to reach the OpenAI token endpoint.\",\n      provider: \"openai\",\n      retryable: true,\n      cause,\n    });\n  }\n\n  if (!response.ok) {\n    throw await tokenResponseError(response);\n  }\n\n  let value: unknown;\n  try {\n    value = await response.json();\n  } catch (cause) {\n    throw new VoiceInputError({\n      code: \"token-error\",\n      message: \"The OpenAI token endpoint returned invalid JSON.\",\n      provider: \"openai\",\n      cause,\n    });\n  }\n  if (\n    !isRecord(value) ||\n    typeof value[\"value\"] !== \"string\" ||\n    value[\"value\"].length === 0 ||\n    typeof value[\"expires_at\"] !== \"number\" ||\n    !Number.isFinite(value[\"expires_at\"])\n  ) {\n    throw new VoiceInputError({\n      code: \"token-error\",\n      message: \"The OpenAI token endpoint returned an invalid credential.\",\n      provider: \"openai\",\n    });\n  }\n  return { value: value[\"value\"], expires_at: value[\"expires_at\"] };\n}\n\nasync function tokenResponseError(\n  response: Response,\n): Promise<VoiceInputError> {\n  const retryAfterMs = parseRetryAfter(response.headers.get(\"Retry-After\"));\n  if (response.status === 401 || response.status === 403) {\n    return new VoiceInputError({\n      code: \"unauthorized\",\n      message: \"The OpenAI token endpoint rejected this request.\",\n      provider: \"openai\",\n    });\n  }\n  if (response.status === 429) {\n    return new VoiceInputError({\n      code: \"rate-limited\",\n      message: \"The OpenAI token endpoint rate limit was exceeded.\",\n      provider: \"openai\",\n      retryable: true,\n      ...(retryAfterMs === undefined ? {} : { retryAfterMs }),\n    });\n  }\n  const safeError = await readSafeTokenError(response);\n  if (safeError !== undefined) {\n    return new VoiceInputError({ ...safeError, provider: \"openai\" });\n  }\n  return new VoiceInputError({\n    code: \"token-error\",\n    message: \"The OpenAI token endpoint did not issue a credential.\",\n    provider: \"openai\",\n    retryable: response.status >= 500,\n  });\n}\n\nasync function readSafeTokenError(response: Response): Promise<\n  | {\n      code: \"invalid-configuration\" | \"unsupported-feature\";\n      message: string;\n    }\n  | undefined\n> {\n  if (\n    response.status !== 400 ||\n    response.headers.get(\"X-VoiceInput-Error\") !== \"1\" ||\n    response.headers.get(\"Content-Type\")?.split(\";\", 1)[0]?.trim() !==\n      \"application/json\"\n  ) {\n    return undefined;\n  }\n  const text = await readBoundedErrorText(response);\n  if (text === undefined) return undefined;\n  try {\n    const value = JSON.parse(text) as unknown;\n    const error = isRecord(value) ? value[\"error\"] : undefined;\n    if (\n      !isRecord(error) ||\n      (error[\"code\"] !== \"invalid-configuration\" &&\n        error[\"code\"] !== \"unsupported-feature\") ||\n      typeof error[\"message\"] !== \"string\" ||\n      error[\"message\"].length === 0 ||\n      error[\"message\"].length > 1_000\n    ) {\n      return undefined;\n    }\n    return { code: error[\"code\"], message: error[\"message\"] };\n  } catch {\n    return undefined;\n  }\n}\n\nasync function readBoundedErrorText(\n  response: Response,\n): Promise<string | undefined> {\n  const reader = response.body?.getReader();\n  if (reader === undefined) return undefined;\n  const decoder = new TextDecoder();\n  let bytesRead = 0;\n  let text = \"\";\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) return text + decoder.decode();\n      bytesRead += value.byteLength;\n      if (bytesRead > 4_096) {\n        await reader.cancel().catch(() => {});\n        return undefined;\n      }\n      text += decoder.decode(value, { stream: true });\n    }\n  } catch {\n    return undefined;\n  }\n}\n\nasync function createSession(\n  socket: WebSocket,\n  tokenRequest: OpenAITokenRequest,\n  abortSignal: AbortSignal,\n): Promise<VoiceInputProviderV1Session> {\n  let streamController:\n    ReadableStreamDefaultController<VoiceInputProviderV1StreamPart> | undefined;\n  const stream = new ReadableStream<VoiceInputProviderV1StreamPart>({\n    start(controller) {\n      streamController = controller;\n    },\n  });\n  if (streamController === undefined) {\n    throw new VoiceInputError({\n      code: \"provider-error\",\n      message: \"Unable to initialize the OpenAI transcript stream.\",\n      provider: \"openai\",\n    });\n  }\n\n  const transcripts = new Map<string, TranscriptState>();\n  const transcriptOrder: string[] = [];\n  const closedItems = new Set<string>();\n  let audioSent = false;\n  let closed = false;\n  let failed = false;\n  let finishing = false;\n  let manualCommitPending = false;\n  let vadCommitPending = false;\n  const manualCommitEventId = \"voiceinput-finish\";\n\n  const closeStream = (): void => {\n    if (closed) {\n      return;\n    }\n    closed = true;\n    abortSignal.removeEventListener(\"abort\", abort);\n    streamController?.close();\n  };\n\n  const closeSocket = (reason: \"aborted\" | \"finished\"): void => {\n    if (socket.readyState === 1 || socket.readyState === 0) {\n      socket.close(1000, reason);\n    }\n  };\n\n  const finishCleanly = (): void => {\n    closeStream();\n    closeSocket(\"finished\");\n  };\n\n  const fail = (error: VoiceInputError): void => {\n    if (closed || failed) {\n      return;\n    }\n    failed = true;\n    streamController?.enqueue({ type: \"error\", error });\n    closeStream();\n    closeSocket(\"aborted\");\n  };\n\n  const maybeFinish = (): void => {\n    if (\n      finishing &&\n      !manualCommitPending &&\n      !vadCommitPending &&\n      transcripts.size === 0\n    ) {\n      finishCleanly();\n    }\n  };\n\n  const emitInterim = (state: TranscriptState): void => {\n    if (state.delta && state.delta !== state.lastEmittedInterim) {\n      state.lastEmittedInterim = state.delta;\n      streamController?.enqueue({\n        type: \"interim\",\n        text: state.delta,\n        segmentId: transcriptOrder[0] as string,\n      });\n    }\n  };\n\n  const flushFinals = (): void => {\n    while (transcriptOrder.length > 0) {\n      const itemId = transcriptOrder[0] as string;\n      const state = transcripts.get(itemId);\n      if (state?.final === undefined) {\n        if (state !== undefined) {\n          emitInterim(state);\n        }\n        break;\n      }\n      transcriptOrder.shift();\n      transcripts.delete(itemId);\n      closedItems.add(itemId);\n      streamController?.enqueue({\n        type: \"final\",\n        text: state.final,\n        segmentId: itemId,\n      });\n    }\n    maybeFinish();\n  };\n\n  const ensureTranscript = (itemId: string): TranscriptState => {\n    let state = transcripts.get(itemId);\n    if (state === undefined) {\n      state = { delta: \"\" };\n      transcripts.set(itemId, state);\n      transcriptOrder.push(itemId);\n    }\n    return state;\n  };\n\n  const handleMessage = (event: MessageEvent): void => {\n    if (closed) {\n      return;\n    }\n    try {\n      const value = JSON.parse(String(event.data)) as unknown;\n      if (!isRecord(value) || typeof value[\"type\"] !== \"string\") {\n        throw new TypeError(\"OpenAI sent an invalid Realtime event.\");\n      }\n      const type = value[\"type\"];\n      if (type === \"input_audio_buffer.speech_started\") {\n        streamController?.enqueue({ type: \"speech-start\" });\n        return;\n      }\n      if (type === \"input_audio_buffer.speech_stopped\") {\n        vadCommitPending = true;\n        streamController?.enqueue({ type: \"speech-end\" });\n        return;\n      }\n      if (type === \"input_audio_buffer.committed\") {\n        const itemId = readString(value, \"item_id\");\n        if (closedItems.has(itemId)) return;\n        manualCommitPending = false;\n        vadCommitPending = false;\n        ensureTranscript(itemId);\n        flushFinals();\n        return;\n      }\n      if (type === \"conversation.item.input_audio_transcription.delta\") {\n        const itemId = readString(value, \"item_id\");\n        if (closedItems.has(itemId)) return;\n        const state = ensureTranscript(itemId);\n        state.delta += readString(value, \"delta\");\n        if (transcriptOrder[0] === itemId) {\n          emitInterim(state);\n        }\n        return;\n      }\n      if (type === \"conversation.item.input_audio_transcription.completed\") {\n        const itemId = readString(value, \"item_id\");\n        if (closedItems.has(itemId)) return;\n        ensureTranscript(itemId).final = readString(value, \"transcript\");\n        flushFinals();\n        return;\n      }\n      if (type === \"conversation.item.input_audio_transcription.failed\") {\n        fail(normalizeTranscriptionFailure(value));\n        return;\n      }\n      if (type === \"error\") {\n        if (isExpectedEmptyCommitError(value, manualCommitEventId)) {\n          manualCommitPending = false;\n          maybeFinish();\n          return;\n        }\n        fail(normalizeRealtimeError(value));\n      }\n    } catch (cause) {\n      fail(\n        new VoiceInputError({\n          code: \"provider-error\",\n          message: \"OpenAI sent an invalid Realtime event.\",\n          provider: \"openai\",\n          cause,\n        }),\n      );\n    }\n  };\n\n  const handleClose = (event: CloseEvent): void => {\n    if (closed) {\n      return;\n    }\n    if (event.code === 1000) {\n      closeStream();\n    } else {\n      fail(\n        new VoiceInputError({\n          code: \"network-error\",\n          message: \"The OpenAI Realtime connection closed unexpectedly.\",\n          provider: \"openai\",\n          retryable: true,\n          cause: event,\n        }),\n      );\n    }\n  };\n\n  const abort = (): void => {\n    if (closed) {\n      return;\n    }\n    closeStream();\n    closeSocket(\"aborted\");\n  };\n\n  socket.addEventListener(\"message\", handleMessage);\n  socket.addEventListener(\"close\", handleClose);\n  socket.addEventListener(\"error\", () => {\n    fail(\n      new VoiceInputError({\n        code: \"network-error\",\n        message: \"The OpenAI Realtime connection failed.\",\n        provider: \"openai\",\n        retryable: true,\n      }),\n    );\n  });\n  abortSignal.addEventListener(\"abort\", abort, { once: true });\n\n  await waitForOpen(socket, abortSignal);\n  sendEvent(socket, {\n    type: \"session.update\",\n    session: createOpenAITranscriptionSession(tokenRequest),\n  });\n\n  return {\n    stream,\n    sendAudio(chunk) {\n      if (closed || finishing) {\n        return;\n      }\n      audioSent ||= chunk.length > 0;\n      if (chunk.length > 0) {\n        return sendWithBackpressure(\n          socket,\n          Math.ceil((chunk.byteLength * 4) / 3) + 128,\n          abortSignal,\n          \"openai\",\n          () =>\n            sendEvent(socket, {\n              type: \"input_audio_buffer.append\",\n              audio: encodePcm16(chunk),\n            }),\n        );\n      }\n    },\n    finish() {\n      if (closed || finishing) {\n        return;\n      }\n      finishing = true;\n      if (!audioSent) {\n        finishCleanly();\n        return;\n      }\n      if (!vadCommitPending) {\n        manualCommitPending = true;\n        sendEvent(socket, {\n          type: \"input_audio_buffer.commit\",\n          event_id: manualCommitEventId,\n        });\n      }\n      maybeFinish();\n    },\n    abort,\n  };\n}\n\nfunction waitForOpen(\n  socket: WebSocket,\n  abortSignal: AbortSignal,\n): Promise<void> {\n  if (socket.readyState === 1) {\n    return Promise.resolve();\n  }\n  return new Promise((resolve, reject) => {\n    const cleanup = (): void => {\n      socket.removeEventListener(\"open\", handleOpen);\n      socket.removeEventListener(\"error\", handleError);\n      abortSignal.removeEventListener(\"abort\", handleAbort);\n    };\n    const handleOpen = (): void => {\n      cleanup();\n      resolve();\n    };\n    const handleError = (event: Event): void => {\n      cleanup();\n      reject(\n        new VoiceInputError({\n          code: \"network-error\",\n          message: \"Unable to open the OpenAI Realtime connection.\",\n          provider: \"openai\",\n          retryable: true,\n          cause: event,\n        }),\n      );\n    };\n    const handleAbort = (): void => {\n      cleanup();\n      reject(abortSignal.reason);\n    };\n    socket.addEventListener(\"open\", handleOpen, { once: true });\n    socket.addEventListener(\"error\", handleError, { once: true });\n    abortSignal.addEventListener(\"abort\", handleAbort, { once: true });\n  });\n}\n\nfunction sendEvent(socket: WebSocket, event: Record<string, unknown>): void {\n  try {\n    socket.send(JSON.stringify(event));\n  } catch (cause) {\n    throw new VoiceInputError({\n      code: \"network-error\",\n      message: \"Unable to send data to OpenAI Realtime.\",\n      provider: \"openai\",\n      retryable: true,\n      cause,\n    });\n  }\n}\n\nfunction encodePcm16(chunk: Int16Array): string {\n  const bytes = new Uint8Array(\n    chunk.buffer,\n    chunk.byteOffset,\n    chunk.byteLength,\n  );\n  let binary = \"\";\n  for (let offset = 0; offset < bytes.length; offset += 8_192) {\n    binary += String.fromCharCode(...bytes.subarray(offset, offset + 8_192));\n  }\n  return btoa(binary);\n}\n\nfunction normalizeRealtimeError(\n  value: Record<string, unknown>,\n): VoiceInputError {\n  const error = isRecord(value[\"error\"]) ? value[\"error\"] : value;\n  const code = typeof error[\"code\"] === \"string\" ? error[\"code\"] : \"\";\n  const message =\n    typeof error[\"message\"] === \"string\"\n      ? error[\"message\"]\n      : \"OpenAI Realtime reported an error.\";\n  const rateLimited = code.includes(\"rate_limit\");\n  return new VoiceInputError({\n    code: rateLimited ? \"rate-limited\" : \"provider-error\",\n    message,\n    provider: \"openai\",\n    retryable: rateLimited || code.includes(\"server_error\"),\n    cause: value,\n  });\n}\n\nfunction normalizeTranscriptionFailure(\n  value: Record<string, unknown>,\n): VoiceInputError {\n  const error = isRecord(value[\"error\"]) ? value[\"error\"] : {};\n  return new VoiceInputError({\n    code: \"provider-error\",\n    message:\n      typeof error[\"message\"] === \"string\"\n        ? error[\"message\"]\n        : \"OpenAI could not transcribe an audio turn.\",\n    provider: \"openai\",\n    retryable:\n      typeof error[\"code\"] === \"string\" &&\n      error[\"code\"].includes(\"server_error\"),\n    cause: value,\n  });\n}\n\nfunction isExpectedEmptyCommitError(\n  value: Record<string, unknown>,\n  eventId: string,\n): boolean {\n  const error = isRecord(value[\"error\"]) ? value[\"error\"] : {};\n  return (\n    error[\"code\"] === \"input_audio_buffer_commit_empty\" &&\n    error[\"event_id\"] === eventId\n  );\n}\n\nfunction readString(value: Record<string, unknown>, key: string): string {\n  const result = value[key];\n  if (typeof result !== \"string\") {\n    throw new TypeError(`${key} must be a string.`);\n  }\n  return result;\n}\n\nfunction parseRetryAfter(value: string | null): number | undefined {\n  if (value === null) {\n    return undefined;\n  }\n  const seconds = Number(value);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.ceil(seconds * 1_000);\n  }\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n}\n\nfunction throwIfAborted(signal: AbortSignal): void {\n  if (signal.aborted) {\n    throw signal.reason;\n  }\n}\n\nfunction validateFactoryString(value: string, name: string): string {\n  if (value.trim().length === 0) {\n    throw new VoiceInputError({\n      code: \"invalid-configuration\",\n      message: `${name} must be a non-empty string.`,\n      provider: \"openai\",\n    });\n  }\n  return value;\n}\n\nfunction unsupportedBrowserFeature(feature: string): VoiceInputError {\n  return new VoiceInputError({\n    code: \"unsupported-browser\",\n    message: `OpenAI voice input requires browser ${feature} support.`,\n    provider: \"openai\",\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport { OPENAI_DEFAULT_MODEL } from \"./session-config.js\";\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import { VoiceInputProviderV1 } from "@voiceinput/provider";
+//#region src/session-config.d.ts
+declare const OPENAI_DEFAULT_MODEL = "gpt-transcribe";
+//#endregion
+//#region src/index.d.ts
+interface OpenAIVoiceInputProviderOptions {
+  readonly tokenEndpoint: string | URL;
+  readonly model?: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly webSocket?: typeof globalThis.WebSocket;
+  readonly realtimeUrl?: string;
+}
+declare function openai(options: OpenAIVoiceInputProviderOptions): VoiceInputProviderV1;
+//#endregion
+export { OPENAI_DEFAULT_MODEL, OpenAIVoiceInputProviderOptions, openai };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/session-config.ts","../src/index.ts"],"mappings":";;cAMa;;;UCcI;WACN,wBAAwB;WACxB;WACA,eAAe,WAAW;WAC1B,mBAAmB,WAAW;WAC9B;;iBAcK,OACd,SAAS,kCACR"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { VoiceInputProviderV1 } from "@voiceinput/provider";
+//#region src/session-config.d.ts
+declare const OPENAI_DEFAULT_MODEL = "gpt-transcribe";
+//#endregion
+//#region src/index.d.ts
+interface OpenAIVoiceInputProviderOptions {
+  readonly tokenEndpoint: string | URL;
+  readonly model?: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly webSocket?: typeof globalThis.WebSocket;
+  readonly realtimeUrl?: string;
+}
+declare function openai(options: OpenAIVoiceInputProviderOptions): VoiceInputProviderV1;
+//#endregion
+export { OPENAI_DEFAULT_MODEL, OpenAIVoiceInputProviderOptions, openai };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/session-config.ts","../src/index.ts"],"mappings":";;cAMa;;;UCcI;WACN,wBAAwB;WACxB;WACA,eAAe,WAAW;WAC1B,mBAAmB,WAAW;WAC9B;;iBAcK,OACd,SAAS,kCACR"}

package/dist/index.js

@@ -0,0 +1,484 @@
+import { i as validateOpenAITokenRequest, n as OPENAI_SAMPLE_RATE, r as createOpenAITranscriptionSession, t as OPENAI_DEFAULT_MODEL } from "./session-config-CuDb4m9Q.js";
+import { sendWithBackpressure } from "@voiceinput/provider/transport";
+import { VoiceInputError } from "@voiceinput/provider";
+//#region src/index.ts
+const DEFAULT_REALTIME_URL = "wss://api.openai.com/v1/realtime";
+function openai(options) {
+	const model = validateFactoryString(options.model ?? "gpt-transcribe", "model");
+	const tokenEndpoint = validateFactoryString(String(options.tokenEndpoint), "tokenEndpoint");
+	const realtimeUrl = validateFactoryString(options.realtimeUrl ?? DEFAULT_REALTIME_URL, "realtimeUrl");
+	const fetchImplementation = options.fetch ?? globalThis.fetch;
+	const WebSocketImplementation = options.webSocket ?? globalThis.WebSocket;
+	const validateProviderOptions = (transcriptionOptions) => validateOptions(transcriptionOptions, model);
+	return Object.freeze({
+		specificationVersion: "v1",
+		provider: "openai",
+		modelId: model,
+		sampleRate: OPENAI_SAMPLE_RATE,
+		validateOptions: validateProviderOptions,
+		async doOpen(callOptions) {
+			validateProviderOptions(callOptions);
+			return await openSession({
+				callOptions,
+				fetchImplementation,
+				model,
+				realtimeUrl,
+				tokenEndpoint,
+				WebSocketImplementation
+			});
+		}
+	});
+}
+function validateOptions(options, model) {
+	try {
+		validateOpenAITokenRequest({
+			model,
+			...options
+		});
+	} catch (cause) {
+		if (VoiceInputError.isInstance(cause)) throw cause;
+		throw new VoiceInputError({
+			code: "invalid-configuration",
+			message: cause instanceof Error ? cause.message : "Invalid OpenAI transcription options.",
+			provider: "openai",
+			cause
+		});
+	}
+}
+async function openSession(options) {
+	const { abortSignal } = options.callOptions;
+	throwIfAborted(abortSignal);
+	if (typeof options.fetchImplementation !== "function") throw unsupportedBrowserFeature("fetch");
+	if (typeof options.WebSocketImplementation !== "function") throw unsupportedBrowserFeature("WebSocket");
+	const tokenRequest = validateOpenAITokenRequest({
+		model: options.model,
+		...options.callOptions
+	});
+	const credential = await requestCredential(options.fetchImplementation, options.tokenEndpoint, tokenRequest, abortSignal);
+	throwIfAborted(abortSignal);
+	return await createSession(new options.WebSocketImplementation(options.realtimeUrl, ["realtime", `openai-insecure-api-key.${credential.value}`]), tokenRequest, abortSignal);
+}
+async function requestCredential(fetchImplementation, tokenEndpoint, tokenRequest, abortSignal) {
+	let response;
+	try {
+		response = await fetchImplementation(tokenEndpoint, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(tokenRequest),
+			credentials: "same-origin",
+			signal: abortSignal
+		});
+	} catch (cause) {
+		throwIfAborted(abortSignal);
+		throw new VoiceInputError({
+			code: "network-error",
+			message: "Unable to reach the OpenAI token endpoint.",
+			provider: "openai",
+			retryable: true,
+			cause
+		});
+	}
+	if (!response.ok) throw await tokenResponseError(response);
+	let value;
+	try {
+		value = await response.json();
+	} catch (cause) {
+		throw new VoiceInputError({
+			code: "token-error",
+			message: "The OpenAI token endpoint returned invalid JSON.",
+			provider: "openai",
+			cause
+		});
+	}
+	if (!isRecord(value) || typeof value["value"] !== "string" || value["value"].length === 0 || typeof value["expires_at"] !== "number" || !Number.isFinite(value["expires_at"])) throw new VoiceInputError({
+		code: "token-error",
+		message: "The OpenAI token endpoint returned an invalid credential.",
+		provider: "openai"
+	});
+	return {
+		value: value["value"],
+		expires_at: value["expires_at"]
+	};
+}
+async function tokenResponseError(response) {
+	const retryAfterMs = parseRetryAfter(response.headers.get("Retry-After"));
+	if (response.status === 401 || response.status === 403) return new VoiceInputError({
+		code: "unauthorized",
+		message: "The OpenAI token endpoint rejected this request.",
+		provider: "openai"
+	});
+	if (response.status === 429) return new VoiceInputError({
+		code: "rate-limited",
+		message: "The OpenAI token endpoint rate limit was exceeded.",
+		provider: "openai",
+		retryable: true,
+		...retryAfterMs === void 0 ? {} : { retryAfterMs }
+	});
+	const safeError = await readSafeTokenError(response);
+	if (safeError !== void 0) return new VoiceInputError({
+		...safeError,
+		provider: "openai"
+	});
+	return new VoiceInputError({
+		code: "token-error",
+		message: "The OpenAI token endpoint did not issue a credential.",
+		provider: "openai",
+		retryable: response.status >= 500
+	});
+}
+async function readSafeTokenError(response) {
+	if (response.status !== 400 || response.headers.get("X-VoiceInput-Error") !== "1" || response.headers.get("Content-Type")?.split(";", 1)[0]?.trim() !== "application/json") return;
+	const text = await readBoundedErrorText(response);
+	if (text === void 0) return void 0;
+	try {
+		const value = JSON.parse(text);
+		const error = isRecord(value) ? value["error"] : void 0;
+		if (!isRecord(error) || error["code"] !== "invalid-configuration" && error["code"] !== "unsupported-feature" || typeof error["message"] !== "string" || error["message"].length === 0 || error["message"].length > 1e3) return;
+		return {
+			code: error["code"],
+			message: error["message"]
+		};
+	} catch {
+		return;
+	}
+}
+async function readBoundedErrorText(response) {
+	const reader = response.body?.getReader();
+	if (reader === void 0) return void 0;
+	const decoder = new TextDecoder();
+	let bytesRead = 0;
+	let text = "";
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) return text + decoder.decode();
+			bytesRead += value.byteLength;
+			if (bytesRead > 4096) {
+				await reader.cancel().catch(() => {});
+				return;
+			}
+			text += decoder.decode(value, { stream: true });
+		}
+	} catch {
+		return;
+	}
+}
+async function createSession(socket, tokenRequest, abortSignal) {
+	let streamController;
+	const stream = new ReadableStream({ start(controller) {
+		streamController = controller;
+	} });
+	if (streamController === void 0) throw new VoiceInputError({
+		code: "provider-error",
+		message: "Unable to initialize the OpenAI transcript stream.",
+		provider: "openai"
+	});
+	const transcripts = /* @__PURE__ */ new Map();
+	const transcriptOrder = [];
+	const closedItems = /* @__PURE__ */ new Set();
+	let audioSent = false;
+	let closed = false;
+	let failed = false;
+	let finishing = false;
+	let manualCommitPending = false;
+	let vadCommitPending = false;
+	const manualCommitEventId = "voiceinput-finish";
+	const closeStream = () => {
+		if (closed) return;
+		closed = true;
+		abortSignal.removeEventListener("abort", abort);
+		streamController?.close();
+	};
+	const closeSocket = (reason) => {
+		if (socket.readyState === 1 || socket.readyState === 0) socket.close(1e3, reason);
+	};
+	const finishCleanly = () => {
+		closeStream();
+		closeSocket("finished");
+	};
+	const fail = (error) => {
+		if (closed || failed) return;
+		failed = true;
+		streamController?.enqueue({
+			type: "error",
+			error
+		});
+		closeStream();
+		closeSocket("aborted");
+	};
+	const maybeFinish = () => {
+		if (finishing && !manualCommitPending && !vadCommitPending && transcripts.size === 0) finishCleanly();
+	};
+	const emitInterim = (state) => {
+		if (state.delta && state.delta !== state.lastEmittedInterim) {
+			state.lastEmittedInterim = state.delta;
+			streamController?.enqueue({
+				type: "interim",
+				text: state.delta,
+				segmentId: transcriptOrder[0]
+			});
+		}
+	};
+	const flushFinals = () => {
+		while (transcriptOrder.length > 0) {
+			const itemId = transcriptOrder[0];
+			const state = transcripts.get(itemId);
+			if (state?.final === void 0) {
+				if (state !== void 0) emitInterim(state);
+				break;
+			}
+			transcriptOrder.shift();
+			transcripts.delete(itemId);
+			closedItems.add(itemId);
+			streamController?.enqueue({
+				type: "final",
+				text: state.final,
+				segmentId: itemId
+			});
+		}
+		maybeFinish();
+	};
+	const ensureTranscript = (itemId) => {
+		let state = transcripts.get(itemId);
+		if (state === void 0) {
+			state = { delta: "" };
+			transcripts.set(itemId, state);
+			transcriptOrder.push(itemId);
+		}
+		return state;
+	};
+	const handleMessage = (event) => {
+		if (closed) return;
+		try {
+			const value = JSON.parse(String(event.data));
+			if (!isRecord(value) || typeof value["type"] !== "string") throw new TypeError("OpenAI sent an invalid Realtime event.");
+			const type = value["type"];
+			if (type === "input_audio_buffer.speech_started") {
+				streamController?.enqueue({ type: "speech-start" });
+				return;
+			}
+			if (type === "input_audio_buffer.speech_stopped") {
+				vadCommitPending = true;
+				streamController?.enqueue({ type: "speech-end" });
+				return;
+			}
+			if (type === "input_audio_buffer.committed") {
+				const itemId = readString(value, "item_id");
+				if (closedItems.has(itemId)) return;
+				manualCommitPending = false;
+				vadCommitPending = false;
+				ensureTranscript(itemId);
+				flushFinals();
+				return;
+			}
+			if (type === "conversation.item.input_audio_transcription.delta") {
+				const itemId = readString(value, "item_id");
+				if (closedItems.has(itemId)) return;
+				const state = ensureTranscript(itemId);
+				state.delta += readString(value, "delta");
+				if (transcriptOrder[0] === itemId) emitInterim(state);
+				return;
+			}
+			if (type === "conversation.item.input_audio_transcription.completed") {
+				const itemId = readString(value, "item_id");
+				if (closedItems.has(itemId)) return;
+				ensureTranscript(itemId).final = readString(value, "transcript");
+				flushFinals();
+				return;
+			}
+			if (type === "conversation.item.input_audio_transcription.failed") {
+				fail(normalizeTranscriptionFailure(value));
+				return;
+			}
+			if (type === "error") {
+				if (isExpectedEmptyCommitError(value, manualCommitEventId)) {
+					manualCommitPending = false;
+					maybeFinish();
+					return;
+				}
+				fail(normalizeRealtimeError(value));
+			}
+		} catch (cause) {
+			fail(new VoiceInputError({
+				code: "provider-error",
+				message: "OpenAI sent an invalid Realtime event.",
+				provider: "openai",
+				cause
+			}));
+		}
+	};
+	const handleClose = (event) => {
+		if (closed) return;
+		if (event.code === 1e3) closeStream();
+		else fail(new VoiceInputError({
+			code: "network-error",
+			message: "The OpenAI Realtime connection closed unexpectedly.",
+			provider: "openai",
+			retryable: true,
+			cause: event
+		}));
+	};
+	const abort = () => {
+		if (closed) return;
+		closeStream();
+		closeSocket("aborted");
+	};
+	socket.addEventListener("message", handleMessage);
+	socket.addEventListener("close", handleClose);
+	socket.addEventListener("error", () => {
+		fail(new VoiceInputError({
+			code: "network-error",
+			message: "The OpenAI Realtime connection failed.",
+			provider: "openai",
+			retryable: true
+		}));
+	});
+	abortSignal.addEventListener("abort", abort, { once: true });
+	await waitForOpen(socket, abortSignal);
+	sendEvent(socket, {
+		type: "session.update",
+		session: createOpenAITranscriptionSession(tokenRequest)
+	});
+	return {
+		stream,
+		sendAudio(chunk) {
+			if (closed || finishing) return;
+			audioSent ||= chunk.length > 0;
+			if (chunk.length > 0) return sendWithBackpressure(socket, Math.ceil(chunk.byteLength * 4 / 3) + 128, abortSignal, "openai", () => sendEvent(socket, {
+				type: "input_audio_buffer.append",
+				audio: encodePcm16(chunk)
+			}));
+		},
+		finish() {
+			if (closed || finishing) return;
+			finishing = true;
+			if (!audioSent) {
+				finishCleanly();
+				return;
+			}
+			if (!vadCommitPending) {
+				manualCommitPending = true;
+				sendEvent(socket, {
+					type: "input_audio_buffer.commit",
+					event_id: manualCommitEventId
+				});
+			}
+			maybeFinish();
+		},
+		abort
+	};
+}
+function waitForOpen(socket, abortSignal) {
+	if (socket.readyState === 1) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		const cleanup = () => {
+			socket.removeEventListener("open", handleOpen);
+			socket.removeEventListener("error", handleError);
+			abortSignal.removeEventListener("abort", handleAbort);
+		};
+		const handleOpen = () => {
+			cleanup();
+			resolve();
+		};
+		const handleError = (event) => {
+			cleanup();
+			reject(new VoiceInputError({
+				code: "network-error",
+				message: "Unable to open the OpenAI Realtime connection.",
+				provider: "openai",
+				retryable: true,
+				cause: event
+			}));
+		};
+		const handleAbort = () => {
+			cleanup();
+			reject(abortSignal.reason);
+		};
+		socket.addEventListener("open", handleOpen, { once: true });
+		socket.addEventListener("error", handleError, { once: true });
+		abortSignal.addEventListener("abort", handleAbort, { once: true });
+	});
+}
+function sendEvent(socket, event) {
+	try {
+		socket.send(JSON.stringify(event));
+	} catch (cause) {
+		throw new VoiceInputError({
+			code: "network-error",
+			message: "Unable to send data to OpenAI Realtime.",
+			provider: "openai",
+			retryable: true,
+			cause
+		});
+	}
+}
+function encodePcm16(chunk) {
+	const bytes = new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+	let binary = "";
+	for (let offset = 0; offset < bytes.length; offset += 8192) binary += String.fromCharCode(...bytes.subarray(offset, offset + 8192));
+	return btoa(binary);
+}
+function normalizeRealtimeError(value) {
+	const error = isRecord(value["error"]) ? value["error"] : value;
+	const code = typeof error["code"] === "string" ? error["code"] : "";
+	const message = typeof error["message"] === "string" ? error["message"] : "OpenAI Realtime reported an error.";
+	const rateLimited = code.includes("rate_limit");
+	return new VoiceInputError({
+		code: rateLimited ? "rate-limited" : "provider-error",
+		message,
+		provider: "openai",
+		retryable: rateLimited || code.includes("server_error"),
+		cause: value
+	});
+}
+function normalizeTranscriptionFailure(value) {
+	const error = isRecord(value["error"]) ? value["error"] : {};
+	return new VoiceInputError({
+		code: "provider-error",
+		message: typeof error["message"] === "string" ? error["message"] : "OpenAI could not transcribe an audio turn.",
+		provider: "openai",
+		retryable: typeof error["code"] === "string" && error["code"].includes("server_error"),
+		cause: value
+	});
+}
+function isExpectedEmptyCommitError(value, eventId) {
+	const error = isRecord(value["error"]) ? value["error"] : {};
+	return error["code"] === "input_audio_buffer_commit_empty" && error["event_id"] === eventId;
+}
+function readString(value, key) {
+	const result = value[key];
+	if (typeof result !== "string") throw new TypeError(`${key} must be a string.`);
+	return result;
+}
+function parseRetryAfter(value) {
+	if (value === null) return;
+	const seconds = Number(value);
+	if (Number.isFinite(seconds) && seconds >= 0) return Math.ceil(seconds * 1e3);
+	const date = Date.parse(value);
+	return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
+}
+function throwIfAborted(signal) {
+	if (signal.aborted) throw signal.reason;
+}
+function validateFactoryString(value, name) {
+	if (value.trim().length === 0) throw new VoiceInputError({
+		code: "invalid-configuration",
+		message: `${name} must be a non-empty string.`,
+		provider: "openai"
+	});
+	return value;
+}
+function unsupportedBrowserFeature(feature) {
+	return new VoiceInputError({
+		code: "unsupported-browser",
+		message: `OpenAI voice input requires browser ${feature} support.`,
+		provider: "openai"
+	});
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { OPENAI_DEFAULT_MODEL, openai };
+
+//# sourceMappingURL=index.js.map