@cloudflare/tanstack-ai 0.0.0 → 0.1.0

package/dist/chunk-RQT7M6MU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/workers-ai-image.ts"],"sourcesContent":["import { BaseImageAdapter } from \"@tanstack/ai/adapters\";\nimport type { ImageGenerationOptions, ImageGenerationResult } from \"@tanstack/ai\";\nimport type { AiModels, BaseAiTextToImage } from \"@cloudflare/workers-types\";\nimport {\n\ttype WorkersAiAdapterConfig,\n\ttype WorkersAiDirectBindingConfig,\n\ttype AiGatewayAdapterConfig,\n\tcreateGatewayFetch,\n\tisDirectBindingConfig,\n\tisDirectCredentialsConfig,\n} from \"../utils/create-fetcher\";\nimport { workersAiRestFetch } from \"../utils/workers-ai-rest\";\nimport { binaryToBase64, uint8ArrayToBase64 } from \"../utils/binary\";\nimport type { WorkersAiDirectCredentialsConfig } from \"../utils/create-fetcher\";\n\n// ---------------------------------------------------------------------------\n// Model type derived from @cloudflare/workers-types\n// ---------------------------------------------------------------------------\n\nexport type WorkersAiImageModel = {\n\t[K in keyof AiModels]: AiModels[K] extends BaseAiTextToImage ? K : never;\n}[keyof AiModels];\n\n// ---------------------------------------------------------------------------\n// WorkersAiImageAdapter: image generation via Workers AI\n// Extends BaseImageAdapter so it works with TanStack AI's generateImage()\n// ---------------------------------------------------------------------------\n\nexport class WorkersAiImageAdapter extends BaseImageAdapter<WorkersAiImageModel> {\n\treadonly name = \"workers-ai-image\" as const;\n\tprivate adapterConfig: WorkersAiAdapterConfig;\n\n\tconstructor(config: WorkersAiAdapterConfig, model: WorkersAiImageModel) {\n\t\tsuper({}, model);\n\t\tthis.adapterConfig = config;\n\t}\n\n\tasync generateImages(options: ImageGenerationOptions): Promise<ImageGenerationResult> {\n\t\tconst { prompt, size, modelOptions } = options;\n\t\tconst extra: Record<string, unknown> = { ...modelOptions };\n\n\t\t// Note: Workers AI Stable Diffusion models only generate a single image\n\t\t// per request — there is no multi-image parameter. `numberOfImages` from\n\t\t// the TanStack AI options is intentionally not forwarded. Use\n\t\t// `modelOptions.num_steps` to control the number of diffusion steps.\n\n\t\tif (size) {\n\t\t\tconst [w, h] = size.split(\"x\");\n\t\t\tif (w) extra.width = Number(w);\n\t\t\tif (h) extra.height = Number(h);\n\t\t}\n\n\t\tif (isDirectBindingConfig(this.adapterConfig)) {\n\t\t\treturn this.generateViaBinding(prompt, extra);\n\t\t}\n\n\t\tif (isDirectCredentialsConfig(this.adapterConfig)) {\n\t\t\treturn this.generateViaRest(prompt, extra);\n\t\t}\n\n\t\t// Gateway mode\n\t\treturn this.generateViaGateway(prompt, extra);\n\t}\n\n\tprivate async generateViaBinding(\n\t\tprompt: string,\n\t\toptions: Record<string, unknown>,\n\t): Promise<ImageGenerationResult> {\n\t\tconst ai = (this.adapterConfig as WorkersAiDirectBindingConfig).binding;\n\t\tconst result = await ai.run(this.model, { prompt, ...options });\n\n\t\tconst b64 = await binaryToBase64(result, \"image\");\n\t\treturn this.wrapResult(b64);\n\t}\n\n\tprivate async generateViaRest(\n\t\tprompt: string,\n\t\toptions: Record<string, unknown>,\n\t): Promise<ImageGenerationResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\t\tconst response = await workersAiRestFetch(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\t{ prompt, ...options },\n\t\t\t{ label: \"Workers AI image\", signal: (options as { signal?: AbortSignal }).signal },\n\t\t);\n\n\t\tconst buffer = await response.arrayBuffer();\n\t\treturn this.wrapResult(uint8ArrayToBase64(new Uint8Array(buffer)));\n\t}\n\n\tprivate async generateViaGateway(\n\t\tprompt: string,\n\t\toptions: Record<string, unknown>,\n\t): Promise<ImageGenerationResult> {\n\t\tconst gatewayConfig = this.adapterConfig as AiGatewayAdapterConfig;\n\t\tconst gatewayFetch = createGatewayFetch(\"workers-ai\", gatewayConfig);\n\n\t\t// The URL here is a placeholder — createGatewayFetch for \"workers-ai\" extracts\n\t\t// the model from the body, sets it as the endpoint, and routes through the gateway.\n\t\t// The actual URL path is not used.\n\t\tconst response = await gatewayFetch(\"https://api.cloudflare.com/v1/images/generations\", {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmodel: this.model,\n\t\t\t\tprompt,\n\t\t\t\t...options,\n\t\t\t}),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errorText = await response.text();\n\t\t\tthrow new Error(\n\t\t\t\t`Workers AI image gateway request failed (${response.status}): ${errorText}`,\n\t\t\t);\n\t\t}\n\n\t\tconst buffer = await response.arrayBuffer();\n\t\treturn this.wrapResult(uint8ArrayToBase64(new Uint8Array(buffer)));\n\t}\n\n\t/** Wrap a base64 image string into the standard ImageGenerationResult. */\n\tprivate wrapResult(b64: string): ImageGenerationResult {\n\t\treturn {\n\t\t\tid: this.generateId(),\n\t\t\tmodel: this.model,\n\t\t\timages: [{ b64Json: b64 }],\n\t\t};\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a Workers AI image generation adapter.\n *\n * Works with TanStack AI's `generateImage()` activity function:\n * ```ts\n * import { generateImage } from \"@tanstack/ai\";\n * import { createWorkersAiImage } from \"@cloudflare/tanstack-ai\";\n *\n * const adapter = createWorkersAiImage(\n *   \"@cf/stabilityai/stable-diffusion-xl-base-1.0\",\n *   { binding: env.AI },\n * );\n *\n * const result = await generateImage({ adapter, prompt: \"a cat in space\" });\n * ```\n *\n * Note: Factory takes `(model, config)` for ergonomics — the class constructor\n * uses `(config, model)` to match TanStack AI's upstream convention.\n */\nexport function createWorkersAiImage(model: WorkersAiImageModel, config: WorkersAiAdapterConfig) {\n\treturn new WorkersAiImageAdapter(config, model);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,wBAAwB;AA4B1B,IAAM,wBAAN,cAAoC,iBAAsC;AAAA,EAIhF,YAAY,QAAgC,OAA4B;AACvE,UAAM,CAAC,GAAG,KAAK;AAJhB,wBAAS,QAAO;AAChB,wBAAQ;AAIP,SAAK,gBAAgB;AAAA,EACtB;AAAA,EAEA,MAAM,eAAe,SAAiE;AACrF,UAAM,EAAE,QAAQ,MAAM,aAAa,IAAI;AACvC,UAAM,QAAiC,EAAE,GAAG,aAAa;AAOzD,QAAI,MAAM;AACT,YAAM,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,GAAG;AAC7B,UAAI,EAAG,OAAM,QAAQ,OAAO,CAAC;AAC7B,UAAI,EAAG,OAAM,SAAS,OAAO,CAAC;AAAA,IAC/B;AAEA,QAAI,sBAAsB,KAAK,aAAa,GAAG;AAC9C,aAAO,KAAK,mBAAmB,QAAQ,KAAK;AAAA,IAC7C;AAEA,QAAI,0BAA0B,KAAK,aAAa,GAAG;AAClD,aAAO,KAAK,gBAAgB,QAAQ,KAAK;AAAA,IAC1C;AAGA,WAAO,KAAK,mBAAmB,QAAQ,KAAK;AAAA,EAC7C;AAAA,EAEA,MAAc,mBACb,QACA,SACiC;AACjC,UAAM,KAAM,KAAK,cAA+C;AAChE,UAAM,SAAS,MAAM,GAAG,IAAI,KAAK,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;AAE9D,UAAM,MAAM,MAAM,eAAe,QAAQ,OAAO;AAChD,WAAO,KAAK,WAAW,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAc,gBACb,QACA,SACiC;AACjC,UAAM,SAAS,KAAK;AACpB,UAAM,WAAW,MAAM;AAAA,MACtB;AAAA,MACA,KAAK;AAAA,MACL,EAAE,QAAQ,GAAG,QAAQ;AAAA,MACrB,EAAE,OAAO,oBAAoB,QAAS,QAAqC,OAAO;AAAA,IACnF;AAEA,UAAM,SAAS,MAAM,SAAS,YAAY;AAC1C,WAAO,KAAK,WAAW,mBAAmB,IAAI,WAAW,MAAM,CAAC,CAAC;AAAA,EAClE;AAAA,EAEA,MAAc,mBACb,QACA,SACiC;AACjC,UAAM,gBAAgB,KAAK;AAC3B,UAAM,eAAe,mBAAmB,cAAc,aAAa;AAKnE,UAAM,WAAW,MAAM,aAAa,oDAAoD;AAAA,MACvF,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACpB,OAAO,KAAK;AAAA,QACZ;AAAA,QACA,GAAG;AAAA,MACJ,CAAC;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACjB,YAAM,YAAY,MAAM,SAAS,KAAK;AACtC,YAAM,IAAI;AAAA,QACT,4CAA4C,SAAS,MAAM,MAAM,SAAS;AAAA,MAC3E;AAAA,IACD;AAEA,UAAM,SAAS,MAAM,SAAS,YAAY;AAC1C,WAAO,KAAK,WAAW,mBAAmB,IAAI,WAAW,MAAM,CAAC,CAAC;AAAA,EAClE;AAAA;AAAA,EAGQ,WAAW,KAAoC;AACtD,WAAO;AAAA,MACN,IAAI,KAAK,WAAW;AAAA,MACpB,OAAO,KAAK;AAAA,MACZ,QAAQ,CAAC,EAAE,SAAS,IAAI,CAAC;AAAA,IAC1B;AAAA,EACD;AACD;AAyBO,SAAS,qBAAqB,OAA4B,QAAgC;AAChG,SAAO,IAAI,sBAAsB,QAAQ,KAAK;AAC/C;","names":[]}

package/dist/chunk-U5YJQYLZ.cjs

@@ -0,0 +1,57 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkGOU66I5Tcjs = require('./chunk-GOU66I5T.cjs');
+
+// src/adapters/openai.ts
+
+
+
+
+
+
+
+
+
+
+
+
+var _aiopenai = require('@tanstack/ai-openai');
+function buildOpenAiConfig(provider, config) {
+  return {
+    apiKey: _nullishCoalesce(config.apiKey, () => ( "unused")),
+    fetch: _chunkGOU66I5Tcjs.createGatewayFetch.call(void 0, provider, config)
+  };
+}
+function createOpenAiChat(model, config) {
+  return new (0, _aiopenai.OpenAITextAdapter)(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiSummarize(model, config) {
+  return new (0, _aiopenai.OpenAISummarizeAdapter)(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiImage(model, config) {
+  return new (0, _aiopenai.OpenAIImageAdapter)(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiTranscription(model, config) {
+  return new (0, _aiopenai.OpenAITranscriptionAdapter)(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiTts(model, config) {
+  return new (0, _aiopenai.OpenAITTSAdapter)(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiVideo(model, config) {
+  return new (0, _aiopenai.OpenAIVideoAdapter)(buildOpenAiConfig("openai", config), model);
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.OPENAI_CHAT_MODELS = _aiopenai.OPENAI_CHAT_MODELS; exports.OPENAI_IMAGE_MODELS = _aiopenai.OPENAI_IMAGE_MODELS; exports.OPENAI_TRANSCRIPTION_MODELS = _aiopenai.OPENAI_TRANSCRIPTION_MODELS; exports.OPENAI_TTS_MODELS = _aiopenai.OPENAI_TTS_MODELS; exports.OPENAI_VIDEO_MODELS = _aiopenai.OPENAI_VIDEO_MODELS; exports.createOpenAiChat = createOpenAiChat; exports.createOpenAiSummarize = createOpenAiSummarize; exports.createOpenAiImage = createOpenAiImage; exports.createOpenAiTranscription = createOpenAiTranscription; exports.createOpenAiTts = createOpenAiTts; exports.createOpenAiVideo = createOpenAiVideo;
+//# sourceMappingURL=chunk-U5YJQYLZ.cjs.map

package/dist/chunk-U5YJQYLZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-U5YJQYLZ.cjs","../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACA;ACJA;AACC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA,+CAMM;AASP,SAAS,iBAAA,CAAkB,QAAA,EAAkB,MAAA,EAA6B;AACzE,EAAA,OAAO;AAAA,IACN,MAAA,mBAAQ,MAAA,CAAO,MAAA,UAAU,UAAA;AAAA,IACzB,KAAA,EAAO,kDAAA,QAAmB,EAAU,MAAM;AAAA,EAC3C,CAAA;AACD;AAQO,SAAS,gBAAA,CAAiB,KAAA,EAAwB,MAAA,EAA6B;AACrF,EAAA,OAAO,IAAI,gCAAA,CAAkB,iBAAA,CAAkB,QAAA,EAAU,MAAM,CAAA,EAAG,KAAK,CAAA;AACxE;AAOO,SAAS,qBAAA,CAAsB,KAAA,EAAwB,MAAA,EAA6B;AAC1F,EAAA,OAAO,IAAI,qCAAA,CAAuB,iBAAA,CAAkB,QAAA,EAAU,MAAM,CAAA,EAAG,KAAK,CAAA;AAC7E;AAOO,SAAS,iBAAA,CAAkB,KAAA,EAAyB,MAAA,EAA6B;AACvF,EAAA,OAAO,IAAI,iCAAA,CAAmB,iBAAA,CAAkB,QAAA,EAAU,MAAM,CAAA,EAAG,KAAK,CAAA;AACzE;AAOO,SAAS,yBAAA,CACf,KAAA,EACA,MAAA,EACC;AACD,EAAA,OAAO,IAAI,yCAAA,CAA2B,iBAAA,CAAkB,QAAA,EAAU,MAAM,CAAA,EAAG,KAAK,CAAA;AACjF;AAOO,SAAS,eAAA,CAAgB,KAAA,EAAuB,MAAA,EAA6B;AACnF,EAAA,OAAO,IAAI,+BAAA,CAAiB,iBAAA,CAAkB,QAAA,EAAU,MAAM,CAAA,EAAG,KAAK,CAAA;AACvE;AAOO,SAAS,iBAAA,CAAkB,KAAA,EAAyB,MAAA,EAA6B;AACvF,EAAA,OAAO,IAAI,iCAAA,CAAmB,iBAAA,CAAkB,QAAA,EAAU,MAAM,CAAA,EAAG,KAAK,CAAA;AACzE;AD/CA;AACA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,smBAAC","file":"/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-U5YJQYLZ.cjs","sourcesContent":[null,"import {\n\tOpenAIImageAdapter,\n\tOpenAISummarizeAdapter,\n\tOpenAITextAdapter,\n\tOpenAITranscriptionAdapter,\n\tOpenAITTSAdapter,\n\tOpenAIVideoAdapter,\n\tOPENAI_CHAT_MODELS,\n\tOPENAI_IMAGE_MODELS,\n\tOPENAI_TRANSCRIPTION_MODELS,\n\tOPENAI_TTS_MODELS,\n\tOPENAI_VIDEO_MODELS,\n\ttype OpenAIChatModel,\n\ttype OpenAIImageModel,\n\ttype OpenAITranscriptionModel,\n\ttype OpenAITTSModel,\n\ttype OpenAIVideoModel,\n} from \"@tanstack/ai-openai\";\nimport { createGatewayFetch, type AiGatewayAdapterConfig } from \"../utils/create-fetcher\";\n\nexport type OpenAiGatewayConfig = AiGatewayAdapterConfig;\n\n/**\n * Builds an OpenAI-compatible config that injects the gateway fetch.\n * OpenAITextConfig extends OpenAI SDK's ClientOptions, which supports a `fetch` parameter.\n */\nfunction buildOpenAiConfig(provider: string, config: OpenAiGatewayConfig) {\n\treturn {\n\t\tapiKey: config.apiKey ?? \"unused\",\n\t\tfetch: createGatewayFetch(provider, config),\n\t};\n}\n\n/**\n * Creates an OpenAI chat adapter which uses Cloudflare AI Gateway.\n * Supports both binding and credential-based configurations.\n * @param model The OpenAI model to use\n * @param config Configuration options\n */\nexport function createOpenAiChat(model: OpenAIChatModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAITextAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI summarize adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI model to use\n * @param config Configuration options\n */\nexport function createOpenAiSummarize(model: OpenAIChatModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAISummarizeAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI image adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI image model to use\n * @param config Configuration options\n */\nexport function createOpenAiImage(model: OpenAIImageModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAIImageAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI transcription adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI transcription model to use\n * @param config Configuration options\n */\nexport function createOpenAiTranscription(\n\tmodel: OpenAITranscriptionModel,\n\tconfig: OpenAiGatewayConfig,\n) {\n\treturn new OpenAITranscriptionAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI TTS adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI TTS model to use\n * @param config Configuration options\n */\nexport function createOpenAiTts(model: OpenAITTSModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAITTSAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI video adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI video model to use\n * @param config Configuration options\n */\nexport function createOpenAiVideo(model: OpenAIVideoModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAIVideoAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\nexport {\n\tOPENAI_CHAT_MODELS,\n\tOPENAI_IMAGE_MODELS,\n\tOPENAI_TRANSCRIPTION_MODELS,\n\tOPENAI_TTS_MODELS,\n\tOPENAI_VIDEO_MODELS,\n\ttype OpenAIChatModel,\n\ttype OpenAIImageModel,\n\ttype OpenAITranscriptionModel,\n\ttype OpenAITTSModel,\n\ttype OpenAIVideoModel,\n};\n"]}

package/dist/chunk-V6TY7KAL.js

@@ -0,0 +1,8 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+export {
+  __publicField
+};
+//# sourceMappingURL=chunk-V6TY7KAL.js.map

package/dist/chunk-V6TY7KAL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-VTDJEUFS.js

@@ -0,0 +1,57 @@
+import {
+  createGatewayFetch
+} from "./chunk-F5YJMXZR.js";
+
+// src/adapters/openai.ts
+import {
+  OpenAIImageAdapter,
+  OpenAISummarizeAdapter,
+  OpenAITextAdapter,
+  OpenAITranscriptionAdapter,
+  OpenAITTSAdapter,
+  OpenAIVideoAdapter,
+  OPENAI_CHAT_MODELS,
+  OPENAI_IMAGE_MODELS,
+  OPENAI_TRANSCRIPTION_MODELS,
+  OPENAI_TTS_MODELS,
+  OPENAI_VIDEO_MODELS
+} from "@tanstack/ai-openai";
+function buildOpenAiConfig(provider, config) {
+  return {
+    apiKey: config.apiKey ?? "unused",
+    fetch: createGatewayFetch(provider, config)
+  };
+}
+function createOpenAiChat(model, config) {
+  return new OpenAITextAdapter(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiSummarize(model, config) {
+  return new OpenAISummarizeAdapter(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiImage(model, config) {
+  return new OpenAIImageAdapter(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiTranscription(model, config) {
+  return new OpenAITranscriptionAdapter(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiTts(model, config) {
+  return new OpenAITTSAdapter(buildOpenAiConfig("openai", config), model);
+}
+function createOpenAiVideo(model, config) {
+  return new OpenAIVideoAdapter(buildOpenAiConfig("openai", config), model);
+}
+
+export {
+  OPENAI_CHAT_MODELS,
+  OPENAI_IMAGE_MODELS,
+  OPENAI_TRANSCRIPTION_MODELS,
+  OPENAI_TTS_MODELS,
+  OPENAI_VIDEO_MODELS,
+  createOpenAiChat,
+  createOpenAiSummarize,
+  createOpenAiImage,
+  createOpenAiTranscription,
+  createOpenAiTts,
+  createOpenAiVideo
+};
+//# sourceMappingURL=chunk-VTDJEUFS.js.map

package/dist/chunk-VTDJEUFS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/openai.ts"],"sourcesContent":["import {\n\tOpenAIImageAdapter,\n\tOpenAISummarizeAdapter,\n\tOpenAITextAdapter,\n\tOpenAITranscriptionAdapter,\n\tOpenAITTSAdapter,\n\tOpenAIVideoAdapter,\n\tOPENAI_CHAT_MODELS,\n\tOPENAI_IMAGE_MODELS,\n\tOPENAI_TRANSCRIPTION_MODELS,\n\tOPENAI_TTS_MODELS,\n\tOPENAI_VIDEO_MODELS,\n\ttype OpenAIChatModel,\n\ttype OpenAIImageModel,\n\ttype OpenAITranscriptionModel,\n\ttype OpenAITTSModel,\n\ttype OpenAIVideoModel,\n} from \"@tanstack/ai-openai\";\nimport { createGatewayFetch, type AiGatewayAdapterConfig } from \"../utils/create-fetcher\";\n\nexport type OpenAiGatewayConfig = AiGatewayAdapterConfig;\n\n/**\n * Builds an OpenAI-compatible config that injects the gateway fetch.\n * OpenAITextConfig extends OpenAI SDK's ClientOptions, which supports a `fetch` parameter.\n */\nfunction buildOpenAiConfig(provider: string, config: OpenAiGatewayConfig) {\n\treturn {\n\t\tapiKey: config.apiKey ?? \"unused\",\n\t\tfetch: createGatewayFetch(provider, config),\n\t};\n}\n\n/**\n * Creates an OpenAI chat adapter which uses Cloudflare AI Gateway.\n * Supports both binding and credential-based configurations.\n * @param model The OpenAI model to use\n * @param config Configuration options\n */\nexport function createOpenAiChat(model: OpenAIChatModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAITextAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI summarize adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI model to use\n * @param config Configuration options\n */\nexport function createOpenAiSummarize(model: OpenAIChatModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAISummarizeAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI image adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI image model to use\n * @param config Configuration options\n */\nexport function createOpenAiImage(model: OpenAIImageModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAIImageAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI transcription adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI transcription model to use\n * @param config Configuration options\n */\nexport function createOpenAiTranscription(\n\tmodel: OpenAITranscriptionModel,\n\tconfig: OpenAiGatewayConfig,\n) {\n\treturn new OpenAITranscriptionAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI TTS adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI TTS model to use\n * @param config Configuration options\n */\nexport function createOpenAiTts(model: OpenAITTSModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAITTSAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\n/**\n * Creates an OpenAI video adapter which uses Cloudflare AI Gateway.\n * @param model The OpenAI video model to use\n * @param config Configuration options\n */\nexport function createOpenAiVideo(model: OpenAIVideoModel, config: OpenAiGatewayConfig) {\n\treturn new OpenAIVideoAdapter(buildOpenAiConfig(\"openai\", config), model);\n}\n\nexport {\n\tOPENAI_CHAT_MODELS,\n\tOPENAI_IMAGE_MODELS,\n\tOPENAI_TRANSCRIPTION_MODELS,\n\tOPENAI_TTS_MODELS,\n\tOPENAI_VIDEO_MODELS,\n\ttype OpenAIChatModel,\n\ttype OpenAIImageModel,\n\ttype OpenAITranscriptionModel,\n\ttype OpenAITTSModel,\n\ttype OpenAIVideoModel,\n};\n"],"mappings":";;;;;AAAA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMM;AASP,SAAS,kBAAkB,UAAkB,QAA6B;AACzE,SAAO;AAAA,IACN,QAAQ,OAAO,UAAU;AAAA,IACzB,OAAO,mBAAmB,UAAU,MAAM;AAAA,EAC3C;AACD;AAQO,SAAS,iBAAiB,OAAwB,QAA6B;AACrF,SAAO,IAAI,kBAAkB,kBAAkB,UAAU,MAAM,GAAG,KAAK;AACxE;AAOO,SAAS,sBAAsB,OAAwB,QAA6B;AAC1F,SAAO,IAAI,uBAAuB,kBAAkB,UAAU,MAAM,GAAG,KAAK;AAC7E;AAOO,SAAS,kBAAkB,OAAyB,QAA6B;AACvF,SAAO,IAAI,mBAAmB,kBAAkB,UAAU,MAAM,GAAG,KAAK;AACzE;AAOO,SAAS,0BACf,OACA,QACC;AACD,SAAO,IAAI,2BAA2B,kBAAkB,UAAU,MAAM,GAAG,KAAK;AACjF;AAOO,SAAS,gBAAgB,OAAuB,QAA6B;AACnF,SAAO,IAAI,iBAAiB,kBAAkB,UAAU,MAAM,GAAG,KAAK;AACvE;AAOO,SAAS,kBAAkB,OAAyB,QAA6B;AACvF,SAAO,IAAI,mBAAmB,kBAAkB,UAAU,MAAM,GAAG,KAAK;AACzE;","names":[]}

package/dist/chunk-XCNU7EEC.js

@@ -0,0 +1,48 @@
+import {
+  createGatewayFetch
+} from "./chunk-F5YJMXZR.js";
+
+// src/adapters/grok.ts
+import {
+  GrokTextAdapter,
+  GrokImageAdapter,
+  GrokSummarizeAdapter,
+  GROK_CHAT_MODELS,
+  GROK_IMAGE_MODELS
+} from "@tanstack/ai-grok";
+function createGrokChat(model, config) {
+  return new GrokTextAdapter(
+    {
+      apiKey: config.apiKey ?? "unused",
+      fetch: createGatewayFetch("grok", config)
+    },
+    model
+  );
+}
+function createGrokImage(model, config) {
+  return new GrokImageAdapter(
+    {
+      apiKey: config.apiKey ?? "unused",
+      fetch: createGatewayFetch("grok", config)
+    },
+    model
+  );
+}
+function createGrokSummarize(model, config) {
+  return new GrokSummarizeAdapter(
+    {
+      apiKey: config.apiKey ?? "unused",
+      fetch: createGatewayFetch("grok", config)
+    },
+    model
+  );
+}
+
+export {
+  GROK_CHAT_MODELS,
+  GROK_IMAGE_MODELS,
+  createGrokChat,
+  createGrokImage,
+  createGrokSummarize
+};
+//# sourceMappingURL=chunk-XCNU7EEC.js.map

package/dist/chunk-XCNU7EEC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/grok.ts"],"sourcesContent":["import {\n\tGrokTextAdapter,\n\tGrokImageAdapter,\n\tGrokSummarizeAdapter,\n\tGROK_CHAT_MODELS,\n\tGROK_IMAGE_MODELS,\n\ttype GrokChatModel,\n\ttype GrokImageModel,\n\ttype GrokSummarizeModel,\n} from \"@tanstack/ai-grok\";\nimport { createGatewayFetch, type AiGatewayAdapterConfig } from \"../utils/create-fetcher\";\n\nexport type GrokGatewayConfig = AiGatewayAdapterConfig;\n\n/**\n * Creates a Grok chat adapter which uses Cloudflare AI Gateway.\n * Supports both binding and credential-based configurations.\n *\n * Since GrokTextConfig extends the OpenAI SDK's ClientOptions,\n * we can inject the gateway fetch directly — no subclassing needed.\n */\nexport function createGrokChat(model: GrokChatModel, config: GrokGatewayConfig) {\n\treturn new GrokTextAdapter(\n\t\t{\n\t\t\tapiKey: config.apiKey ?? \"unused\",\n\t\t\tfetch: createGatewayFetch(\"grok\", config),\n\t\t},\n\t\tmodel,\n\t);\n}\n\n/**\n * Creates a Grok image adapter which uses Cloudflare AI Gateway.\n * Supports both binding and credential-based configurations.\n */\nexport function createGrokImage(model: GrokImageModel, config: GrokGatewayConfig) {\n\treturn new GrokImageAdapter(\n\t\t{\n\t\t\tapiKey: config.apiKey ?? \"unused\",\n\t\t\tfetch: createGatewayFetch(\"grok\", config),\n\t\t},\n\t\tmodel,\n\t);\n}\n\n/**\n * Creates a Grok summarize adapter which uses Cloudflare AI Gateway.\n * Supports both binding and credential-based configurations.\n */\nexport function createGrokSummarize(model: GrokSummarizeModel, config: GrokGatewayConfig) {\n\treturn new GrokSummarizeAdapter(\n\t\t{\n\t\t\tapiKey: config.apiKey ?? \"unused\",\n\t\t\tfetch: createGatewayFetch(\"grok\", config),\n\t\t},\n\t\tmodel,\n\t);\n}\n\nexport {\n\tGROK_CHAT_MODELS,\n\tGROK_IMAGE_MODELS,\n\ttype GrokChatModel,\n\ttype GrokImageModel,\n\ttype GrokSummarizeModel,\n};\n"],"mappings":";;;;;AAAA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIM;AAYA,SAAS,eAAe,OAAsB,QAA2B;AAC/E,SAAO,IAAI;AAAA,IACV;AAAA,MACC,QAAQ,OAAO,UAAU;AAAA,MACzB,OAAO,mBAAmB,QAAQ,MAAM;AAAA,IACzC;AAAA,IACA;AAAA,EACD;AACD;AAMO,SAAS,gBAAgB,OAAuB,QAA2B;AACjF,SAAO,IAAI;AAAA,IACV;AAAA,MACC,QAAQ,OAAO,UAAU;AAAA,MACzB,OAAO,mBAAmB,QAAQ,MAAM;AAAA,IACzC;AAAA,IACA;AAAA,EACD;AACD;AAMO,SAAS,oBAAoB,OAA2B,QAA2B;AACzF,SAAO,IAAI;AAAA,IACV;AAAA,MACC,QAAQ,OAAO,UAAU;AAAA,MACzB,OAAO,mBAAmB,QAAQ,MAAM;AAAA,IACzC;AAAA,IACA;AAAA,EACD;AACD;","names":[]}

package/dist/chunk-XI2BOYEI.js

@@ -0,0 +1,109 @@
+import {
+  binaryToBase64,
+  uint8ArrayToBase64
+} from "./chunk-XU7YEPML.js";
+import {
+  workersAiRestFetch
+} from "./chunk-2VII5BK2.js";
+import {
+  createGatewayFetch,
+  isDirectBindingConfig,
+  isDirectCredentialsConfig
+} from "./chunk-F5YJMXZR.js";
+import {
+  __publicField
+} from "./chunk-V6TY7KAL.js";
+
+// src/adapters/workers-ai-tts.ts
+import { BaseTTSAdapter } from "@tanstack/ai/adapters";
+var WorkersAiTTSAdapter = class extends BaseTTSAdapter {
+  constructor(config, model) {
+    super({}, model);
+    __publicField(this, "name", "workers-ai-tts");
+    __publicField(this, "adapterConfig");
+    this.adapterConfig = config;
+  }
+  async generateSpeech(options) {
+    const { text, voice, format, speed, modelOptions } = options;
+    const extra = { ...modelOptions };
+    if (voice) extra.voice = voice;
+    if (speed != null) extra.speed = speed;
+    if (isDirectBindingConfig(this.adapterConfig)) {
+      return this.generateViaBinding(text, format, extra);
+    }
+    if (isDirectCredentialsConfig(this.adapterConfig)) {
+      return this.generateViaRest(text, format, extra);
+    }
+    return this.generateViaGateway(text, format, extra);
+  }
+  async generateViaBinding(text, format, options) {
+    const ai = this.adapterConfig.binding;
+    const result = await ai.run(this.model, { text, ...options });
+    return this.normalizeResult(result, format);
+  }
+  async generateViaRest(text, format, options) {
+    const config = this.adapterConfig;
+    const response = await workersAiRestFetch(
+      config,
+      this.model,
+      { text, ...options },
+      { label: "Workers AI TTS", signal: options.signal }
+    );
+    const buffer = await response.arrayBuffer();
+    return this.wrapAudioResult(new Uint8Array(buffer), format);
+  }
+  async generateViaGateway(text, format, options) {
+    const gatewayConfig = this.adapterConfig;
+    const gatewayFetch = createGatewayFetch("workers-ai", gatewayConfig);
+    const response = await gatewayFetch("https://api.cloudflare.com/v1/audio/speech", {
+      method: "POST",
+      body: JSON.stringify({
+        model: this.model,
+        text,
+        ...options
+      })
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(
+        `Workers AI TTS gateway request failed (${response.status}): ${errorText}`
+      );
+    }
+    const buffer = await response.arrayBuffer();
+    return this.wrapAudioResult(new Uint8Array(buffer), format);
+  }
+  /**
+   * Normalize binding results. Workers AI TTS can return:
+   * - Uint8Array / ArrayBuffer (raw audio bytes)
+   * - ReadableStream<Uint8Array> (streamed audio bytes)
+   * - { audio: "base64..." } (JSON wrapper)
+   */
+  async normalizeResult(result, format) {
+    const b64 = await binaryToBase64(result, "audio");
+    return {
+      id: this.generateId(),
+      model: this.model,
+      audio: b64,
+      format: format ?? "mp3",
+      contentType: `audio/${format ?? "mp3"}`
+    };
+  }
+  wrapAudioResult(bytes, format) {
+    return {
+      id: this.generateId(),
+      model: this.model,
+      audio: uint8ArrayToBase64(bytes),
+      format: format ?? "mp3",
+      contentType: `audio/${format ?? "mp3"}`
+    };
+  }
+};
+function createWorkersAiTts(model, config) {
+  return new WorkersAiTTSAdapter(config, model);
+}
+
+export {
+  WorkersAiTTSAdapter,
+  createWorkersAiTts
+};
+//# sourceMappingURL=chunk-XI2BOYEI.js.map

package/dist/chunk-XI2BOYEI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/workers-ai-tts.ts"],"sourcesContent":["import { BaseTTSAdapter } from \"@tanstack/ai/adapters\";\nimport type { TTSOptions, TTSResult } from \"@tanstack/ai\";\nimport {\n\ttype WorkersAiAdapterConfig,\n\ttype WorkersAiDirectBindingConfig,\n\ttype WorkersAiDirectCredentialsConfig,\n\ttype AiGatewayAdapterConfig,\n\tcreateGatewayFetch,\n\tisDirectBindingConfig,\n\tisDirectCredentialsConfig,\n} from \"../utils/create-fetcher\";\nimport { workersAiRestFetch } from \"../utils/workers-ai-rest\";\nimport { binaryToBase64, uint8ArrayToBase64 } from \"../utils/binary\";\n\n// ---------------------------------------------------------------------------\n// Model types\n// ---------------------------------------------------------------------------\n\n/**\n * Workers AI models that support text-to-speech generation.\n *\n * Note: the typed `AiModels` interface in `@cloudflare/workers-types` may lag\n * behind what's deployed. We use a string union here that matches the known\n * models including Deepgram partner models.\n */\nexport type WorkersAiTTSModel = \"@cf/deepgram/aura-1\";\n\n// ---------------------------------------------------------------------------\n// WorkersAiTTSAdapter\n// ---------------------------------------------------------------------------\n\nexport class WorkersAiTTSAdapter extends BaseTTSAdapter<WorkersAiTTSModel> {\n\treadonly name = \"workers-ai-tts\" as const;\n\tprivate adapterConfig: WorkersAiAdapterConfig;\n\n\tconstructor(config: WorkersAiAdapterConfig, model: WorkersAiTTSModel) {\n\t\tsuper({}, model);\n\t\tthis.adapterConfig = config;\n\t}\n\n\tasync generateSpeech(options: TTSOptions): Promise<TTSResult> {\n\t\tconst { text, voice, format, speed, modelOptions } = options;\n\n\t\t// Workers AI TTS models (Deepgram aura-1) accept { text, lang? }\n\t\tconst extra: Record<string, unknown> = { ...modelOptions };\n\t\tif (voice) extra.voice = voice;\n\t\tif (speed != null) extra.speed = speed;\n\n\t\tif (isDirectBindingConfig(this.adapterConfig)) {\n\t\t\treturn this.generateViaBinding(text, format, extra);\n\t\t}\n\n\t\tif (isDirectCredentialsConfig(this.adapterConfig)) {\n\t\t\treturn this.generateViaRest(text, format, extra);\n\t\t}\n\n\t\treturn this.generateViaGateway(text, format, extra);\n\t}\n\n\tprivate async generateViaBinding(\n\t\ttext: string,\n\t\tformat: string | undefined,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TTSResult> {\n\t\tconst ai = (this.adapterConfig as WorkersAiDirectBindingConfig).binding;\n\t\tconst result = await ai.run(this.model, { text, ...options });\n\n\t\treturn this.normalizeResult(result, format);\n\t}\n\n\tprivate async generateViaRest(\n\t\ttext: string,\n\t\tformat: string | undefined,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TTSResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\t\tconst response = await workersAiRestFetch(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\t{ text, ...options },\n\t\t\t{ label: \"Workers AI TTS\", signal: (options as { signal?: AbortSignal }).signal },\n\t\t);\n\n\t\t// Workers AI TTS returns audio bytes directly\n\t\tconst buffer = await response.arrayBuffer();\n\t\treturn this.wrapAudioResult(new Uint8Array(buffer), format);\n\t}\n\n\tprivate async generateViaGateway(\n\t\ttext: string,\n\t\tformat: string | undefined,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TTSResult> {\n\t\tconst gatewayConfig = this.adapterConfig as AiGatewayAdapterConfig;\n\t\tconst gatewayFetch = createGatewayFetch(\"workers-ai\", gatewayConfig);\n\n\t\t// The URL here is a placeholder — createGatewayFetch for \"workers-ai\" extracts\n\t\t// the model from the body, sets it as the endpoint, and routes through the gateway.\n\t\t// The actual URL path is not used.\n\t\tconst response = await gatewayFetch(\"https://api.cloudflare.com/v1/audio/speech\", {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmodel: this.model,\n\t\t\t\ttext,\n\t\t\t\t...options,\n\t\t\t}),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errorText = await response.text();\n\t\t\tthrow new Error(\n\t\t\t\t`Workers AI TTS gateway request failed (${response.status}): ${errorText}`,\n\t\t\t);\n\t\t}\n\n\t\tconst buffer = await response.arrayBuffer();\n\t\treturn this.wrapAudioResult(new Uint8Array(buffer), format);\n\t}\n\n\t/**\n\t * Normalize binding results. Workers AI TTS can return:\n\t * - Uint8Array / ArrayBuffer (raw audio bytes)\n\t * - ReadableStream<Uint8Array> (streamed audio bytes)\n\t * - { audio: \"base64...\" } (JSON wrapper)\n\t */\n\tprivate async normalizeResult(result: unknown, format: string | undefined): Promise<TTSResult> {\n\t\t// Use the shared binaryToBase64 helper for Uint8Array/ArrayBuffer/ReadableStream\n\t\t// and { audio: \"base64...\" } JSON wrapper\n\t\tconst b64 = await binaryToBase64(result, \"audio\");\n\t\treturn {\n\t\t\tid: this.generateId(),\n\t\t\tmodel: this.model,\n\t\t\taudio: b64,\n\t\t\tformat: format ?? \"mp3\",\n\t\t\tcontentType: `audio/${format ?? \"mp3\"}`,\n\t\t};\n\t}\n\n\tprivate wrapAudioResult(bytes: Uint8Array, format: string | undefined): TTSResult {\n\t\treturn {\n\t\t\tid: this.generateId(),\n\t\t\tmodel: this.model,\n\t\t\taudio: uint8ArrayToBase64(bytes),\n\t\t\tformat: format ?? \"mp3\",\n\t\t\tcontentType: `audio/${format ?? \"mp3\"}`,\n\t\t};\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a Workers AI text-to-speech adapter.\n *\n * Works with TanStack AI's `generateSpeech()` activity function:\n * ```ts\n * import { generateSpeech } from \"@tanstack/ai\";\n * import { createWorkersAiTts } from \"@cloudflare/tanstack-ai\";\n *\n * const adapter = createWorkersAiTts(\n *   \"@cf/deepgram/aura-1\",\n *   { binding: env.AI },\n * );\n *\n * const result = await generateSpeech({ adapter, text: \"Hello world\" });\n * // result.audio — base64-encoded audio\n * ```\n *\n * Note: Factory takes `(model, config)` for ergonomics — the class constructor\n * uses `(config, model)` to match TanStack AI's upstream convention.\n */\nexport function createWorkersAiTts(model: WorkersAiTTSModel, config: WorkersAiAdapterConfig) {\n\treturn new WorkersAiTTSAdapter(config, model);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,sBAAsB;AA+BxB,IAAM,sBAAN,cAAkC,eAAkC;AAAA,EAI1E,YAAY,QAAgC,OAA0B;AACrE,UAAM,CAAC,GAAG,KAAK;AAJhB,wBAAS,QAAO;AAChB,wBAAQ;AAIP,SAAK,gBAAgB;AAAA,EACtB;AAAA,EAEA,MAAM,eAAe,SAAyC;AAC7D,UAAM,EAAE,MAAM,OAAO,QAAQ,OAAO,aAAa,IAAI;AAGrD,UAAM,QAAiC,EAAE,GAAG,aAAa;AACzD,QAAI,MAAO,OAAM,QAAQ;AACzB,QAAI,SAAS,KAAM,OAAM,QAAQ;AAEjC,QAAI,sBAAsB,KAAK,aAAa,GAAG;AAC9C,aAAO,KAAK,mBAAmB,MAAM,QAAQ,KAAK;AAAA,IACnD;AAEA,QAAI,0BAA0B,KAAK,aAAa,GAAG;AAClD,aAAO,KAAK,gBAAgB,MAAM,QAAQ,KAAK;AAAA,IAChD;AAEA,WAAO,KAAK,mBAAmB,MAAM,QAAQ,KAAK;AAAA,EACnD;AAAA,EAEA,MAAc,mBACb,MACA,QACA,SACqB;AACrB,UAAM,KAAM,KAAK,cAA+C;AAChE,UAAM,SAAS,MAAM,GAAG,IAAI,KAAK,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;AAE5D,WAAO,KAAK,gBAAgB,QAAQ,MAAM;AAAA,EAC3C;AAAA,EAEA,MAAc,gBACb,MACA,QACA,SACqB;AACrB,UAAM,SAAS,KAAK;AACpB,UAAM,WAAW,MAAM;AAAA,MACtB;AAAA,MACA,KAAK;AAAA,MACL,EAAE,MAAM,GAAG,QAAQ;AAAA,MACnB,EAAE,OAAO,kBAAkB,QAAS,QAAqC,OAAO;AAAA,IACjF;AAGA,UAAM,SAAS,MAAM,SAAS,YAAY;AAC1C,WAAO,KAAK,gBAAgB,IAAI,WAAW,MAAM,GAAG,MAAM;AAAA,EAC3D;AAAA,EAEA,MAAc,mBACb,MACA,QACA,SACqB;AACrB,UAAM,gBAAgB,KAAK;AAC3B,UAAM,eAAe,mBAAmB,cAAc,aAAa;AAKnE,UAAM,WAAW,MAAM,aAAa,8CAA8C;AAAA,MACjF,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACpB,OAAO,KAAK;AAAA,QACZ;AAAA,QACA,GAAG;AAAA,MACJ,CAAC;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACjB,YAAM,YAAY,MAAM,SAAS,KAAK;AACtC,YAAM,IAAI;AAAA,QACT,0CAA0C,SAAS,MAAM,MAAM,SAAS;AAAA,MACzE;AAAA,IACD;AAEA,UAAM,SAAS,MAAM,SAAS,YAAY;AAC1C,WAAO,KAAK,gBAAgB,IAAI,WAAW,MAAM,GAAG,MAAM;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,gBAAgB,QAAiB,QAAgD;AAG9F,UAAM,MAAM,MAAM,eAAe,QAAQ,OAAO;AAChD,WAAO;AAAA,MACN,IAAI,KAAK,WAAW;AAAA,MACpB,OAAO,KAAK;AAAA,MACZ,OAAO;AAAA,MACP,QAAQ,UAAU;AAAA,MAClB,aAAa,SAAS,UAAU,KAAK;AAAA,IACtC;AAAA,EACD;AAAA,EAEQ,gBAAgB,OAAmB,QAAuC;AACjF,WAAO;AAAA,MACN,IAAI,KAAK,WAAW;AAAA,MACpB,OAAO,KAAK;AAAA,MACZ,OAAO,mBAAmB,KAAK;AAAA,MAC/B,QAAQ,UAAU;AAAA,MAClB,aAAa,SAAS,UAAU,KAAK;AAAA,IACtC;AAAA,EACD;AACD;AA0BO,SAAS,mBAAmB,OAA0B,QAAgC;AAC5F,SAAO,IAAI,oBAAoB,QAAQ,KAAK;AAC7C;","names":[]}

package/dist/chunk-XKSFDPDY.cjs

@@ -0,0 +1,216 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunk3VQDXJLWcjs = require('./chunk-3VQDXJLW.cjs');
+
+
+
+var _chunk7HSUHP63cjs = require('./chunk-7HSUHP63.cjs');
+
+
+
+
+var _chunkGOU66I5Tcjs = require('./chunk-GOU66I5T.cjs');
+
+
+var _chunk4DE2IREAcjs = require('./chunk-4DE2IREA.cjs');
+
+// src/adapters/workers-ai-transcription.ts
+var _adapters = require('@tanstack/ai/adapters');
+var WorkersAiTranscriptionAdapter = class extends _adapters.BaseTranscriptionAdapter {
+  constructor(config, model) {
+    super({}, model);
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "name", "workers-ai-transcription");
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "adapterConfig");
+    this.adapterConfig = config;
+  }
+  async transcribe(options) {
+    const { audio, language, prompt, modelOptions } = options;
+    const audioBytes = await normalizeAudioToBytes(audio);
+    const extra = { ...modelOptions };
+    if (language) extra.language = language;
+    if (prompt) extra.initial_prompt = prompt;
+    const audioPayload = this.buildAudioPayload(audioBytes, audio);
+    if (_chunkGOU66I5Tcjs.isDirectBindingConfig.call(void 0, this.adapterConfig)) {
+      return this.transcribeViaBinding(audioPayload, extra);
+    }
+    if (_chunkGOU66I5Tcjs.isDirectCredentialsConfig.call(void 0, this.adapterConfig)) {
+      if (this.model === "@cf/deepgram/nova-3") {
+        return this.transcribeViaRestBinary(audioBytes, audio, extra);
+      }
+      return this.transcribeViaRest(audioPayload, extra);
+    }
+    return this.transcribeViaGateway(audioPayload, extra);
+  }
+  /**
+   * Build the audio field for the request payload, handling model-specific formats.
+   *
+   * - `@cf/deepgram/nova-3` requires `{ body: base64, contentType: "audio/..." }`
+   * - `@cf/openai/whisper-large-v3-turbo` REST/gateway accepts a base64 string
+   * - Other Whisper models accept `number[]` (binding) or base64 (REST)
+   */
+  buildAudioPayload(audioBytes, originalAudio) {
+    if (this.model === "@cf/deepgram/nova-3") {
+      const b64 = _chunk3VQDXJLWcjs.uint8ArrayToBase64.call(void 0, new Uint8Array(audioBytes));
+      const contentType = detectAudioContentType(originalAudio);
+      return { audio: { body: b64, contentType } };
+    }
+    if (this.model === "@cf/openai/whisper-large-v3-turbo") {
+      return { audio: _chunk3VQDXJLWcjs.uint8ArrayToBase64.call(void 0, new Uint8Array(audioBytes)) };
+    }
+    return { audio: audioBytes };
+  }
+  async transcribeViaBinding(audioPayload, options) {
+    const ai = this.adapterConfig.binding;
+    const result = await ai.run(this.model, {
+      ...audioPayload,
+      ...options
+    });
+    return this.normalizeResult(result);
+  }
+  async transcribeViaRest(audioPayload, options) {
+    const config = this.adapterConfig;
+    const response = await _chunk7HSUHP63cjs.workersAiRestFetch.call(void 0, 
+      config,
+      this.model,
+      { ...audioPayload, ...options },
+      {
+        label: "Workers AI transcription",
+        signal: options.signal
+      }
+    );
+    const data = await response.json();
+    return this.normalizeResult(_nullishCoalesce(data.result, () => ( data)));
+  }
+  /**
+   * Transcribe via REST using raw binary audio.
+   * Required for models like Deepgram Nova-3 that expect raw audio bytes
+   * with a Content-Type header (e.g. "audio/wav") instead of JSON.
+   */
+  async transcribeViaRestBinary(audioBytes, originalAudio, options) {
+    const config = this.adapterConfig;
+    const contentType = detectAudioContentType(originalAudio);
+    const response = await _chunk7HSUHP63cjs.workersAiRestFetchBinary.call(void 0, 
+      config,
+      this.model,
+      new Uint8Array(audioBytes),
+      contentType,
+      {
+        label: "Workers AI transcription",
+        signal: options.signal
+      }
+    );
+    const data = await response.json();
+    return this.normalizeResult(_nullishCoalesce(data.result, () => ( data)));
+  }
+  async transcribeViaGateway(audioPayload, options) {
+    const gatewayConfig = this.adapterConfig;
+    const gatewayFetch = _chunkGOU66I5Tcjs.createGatewayFetch.call(void 0, "workers-ai", gatewayConfig);
+    const response = await gatewayFetch("https://api.cloudflare.com/v1/audio/transcriptions", {
+      method: "POST",
+      body: JSON.stringify({
+        model: this.model,
+        ...audioPayload,
+        ...options
+      })
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(
+        `Workers AI transcription gateway request failed (${response.status}): ${errorText}`
+      );
+    }
+    const data = await response.json();
+    return this.normalizeResult(data);
+  }
+  /**
+   * Normalize Workers AI transcription results into the standard
+   * TanStack AI TranscriptionResult shape.
+   *
+   * Handles three response formats:
+   * - Whisper: `{ text, words?, vtt? }`
+   * - Whisper v3-turbo: `{ text, segments?, transcription_info? }`
+   * - Deepgram Nova-3: `{ results: { channels: [{ alternatives: [{ transcript, words }] }] } }`
+   */
+  normalizeResult(raw) {
+    const results = raw.results;
+    if (_optionalChain([results, 'optionalAccess', _ => _.channels])) {
+      const channels = results.channels;
+      const alt = _optionalChain([channels, 'optionalAccess', _2 => _2[0], 'optionalAccess', _3 => _3.alternatives, 'optionalAccess', _4 => _4[0]]);
+      const text = _nullishCoalesce(_optionalChain([alt, 'optionalAccess', _5 => _5.transcript]), () => ( ""));
+      const result2 = {
+        id: this.generateId(),
+        model: this.model,
+        text
+      };
+      if (_optionalChain([alt, 'optionalAccess', _6 => _6.words]) && Array.isArray(alt.words)) {
+        result2.words = alt.words.map((w) => ({
+          word: _nullishCoalesce(w.word, () => ( "")),
+          start: _nullishCoalesce(w.start, () => ( 0)),
+          end: _nullishCoalesce(w.end, () => ( 0))
+        }));
+      }
+      return result2;
+    }
+    const result = {
+      id: this.generateId(),
+      model: this.model,
+      text: _nullishCoalesce(raw.text, () => ( ""))
+    };
+    const transcriptionInfo = raw.transcription_info;
+    if (_optionalChain([transcriptionInfo, 'optionalAccess', _7 => _7.language])) {
+      result.language = transcriptionInfo.language;
+    }
+    if (_optionalChain([transcriptionInfo, 'optionalAccess', _8 => _8.duration]) != null) {
+      result.duration = transcriptionInfo.duration;
+    }
+    if (raw.segments && Array.isArray(raw.segments)) {
+      result.segments = raw.segments.map((seg, idx) => ({
+        id: idx,
+        text: _nullishCoalesce(seg.text, () => ( "")),
+        start: _nullishCoalesce(seg.start, () => ( 0)),
+        end: _nullishCoalesce(seg.end, () => ( 0))
+      }));
+    }
+    if (raw.words && Array.isArray(raw.words)) {
+      result.words = raw.words.map((w) => ({
+        word: _nullishCoalesce(w.word, () => ( "")),
+        start: _nullishCoalesce(w.start, () => ( 0)),
+        end: _nullishCoalesce(w.end, () => ( 0))
+      }));
+    }
+    return result;
+  }
+};
+function createWorkersAiTranscription(model, config) {
+  return new WorkersAiTranscriptionAdapter(config, model);
+}
+async function normalizeAudioToBytes(audio) {
+  if (audio instanceof ArrayBuffer) {
+    return Array.from(new Uint8Array(audio));
+  }
+  if (audio instanceof Blob) {
+    const buffer = await audio.arrayBuffer();
+    return Array.from(new Uint8Array(buffer));
+  }
+  if (typeof audio === "string") {
+    const binary = atob(audio);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+    return Array.from(bytes);
+  }
+  throw new Error("Unsupported audio format. Expected string, File, Blob, or ArrayBuffer.");
+}
+function detectAudioContentType(audio) {
+  if (audio instanceof Blob && audio.type) {
+    return audio.type;
+  }
+  return "audio/wav";
+}
+
+
+
+
+exports.WorkersAiTranscriptionAdapter = WorkersAiTranscriptionAdapter; exports.createWorkersAiTranscription = createWorkersAiTranscription;
+//# sourceMappingURL=chunk-XKSFDPDY.cjs.map

package/dist/chunk-XKSFDPDY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-XKSFDPDY.cjs","../src/adapters/workers-ai-transcription.ts"],"names":[],"mappings":"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","file":"/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-XKSFDPDY.cjs","sourcesContent":[null,"import { BaseTranscriptionAdapter } from \"@tanstack/ai/adapters\";\nimport type { TranscriptionOptions, TranscriptionResult } from \"@tanstack/ai\";\nimport {\n\ttype WorkersAiAdapterConfig,\n\ttype WorkersAiDirectBindingConfig,\n\ttype WorkersAiDirectCredentialsConfig,\n\ttype AiGatewayAdapterConfig,\n\tcreateGatewayFetch,\n\tisDirectBindingConfig,\n\tisDirectCredentialsConfig,\n} from \"../utils/create-fetcher\";\nimport { workersAiRestFetch, workersAiRestFetchBinary } from \"../utils/workers-ai-rest\";\nimport { uint8ArrayToBase64 } from \"../utils/binary\";\n\n// ---------------------------------------------------------------------------\n// Model types\n// ---------------------------------------------------------------------------\n\n/**\n * Workers AI models that support speech-to-text transcription.\n *\n * Note: the typed `AiModels` interface in `@cloudflare/workers-types` may lag\n * behind what's deployed. We use a string union here that matches the known\n * models including Deepgram partner models.\n *\n * **Nova-3 note:** `@cf/deepgram/nova-3` uses a different input format than the\n * Whisper models. Via binding it accepts `{ audio: { body: base64, contentType } }`.\n * Via REST it requires multipart form data (not JSON). The adapter handles both.\n */\nexport type WorkersAiTranscriptionModel =\n\t| \"@cf/openai/whisper\"\n\t| \"@cf/openai/whisper-tiny-en\"\n\t| \"@cf/openai/whisper-large-v3-turbo\"\n\t| \"@cf/deepgram/nova-3\";\n\n// ---------------------------------------------------------------------------\n// WorkersAiTranscriptionAdapter\n// ---------------------------------------------------------------------------\n\nexport class WorkersAiTranscriptionAdapter extends BaseTranscriptionAdapter<WorkersAiTranscriptionModel> {\n\treadonly name = \"workers-ai-transcription\" as const;\n\tprivate adapterConfig: WorkersAiAdapterConfig;\n\n\tconstructor(config: WorkersAiAdapterConfig, model: WorkersAiTranscriptionModel) {\n\t\tsuper({}, model);\n\t\tthis.adapterConfig = config;\n\t}\n\n\tasync transcribe(options: TranscriptionOptions): Promise<TranscriptionResult> {\n\t\tconst { audio, language, prompt, modelOptions } = options;\n\n\t\t// Normalize audio to raw bytes\n\t\tconst audioBytes = await normalizeAudioToBytes(audio);\n\n\t\tconst extra: Record<string, unknown> = { ...modelOptions };\n\t\tif (language) extra.language = language;\n\t\tif (prompt) extra.initial_prompt = prompt;\n\n\t\t// Build the model-specific audio payload:\n\t\t// - Deepgram Nova-3 (binding): { audio: { body: base64, contentType: \"audio/...\" } }\n\t\t// - Deepgram Nova-3 (REST): multipart FormData (handled separately)\n\t\t// - Whisper Large v3 Turbo (REST/gateway): { audio: base64string }\n\t\t// - Other Whisper models (binding): { audio: number[] }\n\t\tconst audioPayload = this.buildAudioPayload(audioBytes, audio);\n\n\t\tif (isDirectBindingConfig(this.adapterConfig)) {\n\t\t\treturn this.transcribeViaBinding(audioPayload, extra);\n\t\t}\n\n\t\tif (isDirectCredentialsConfig(this.adapterConfig)) {\n\t\t\t// Nova-3 REST requires raw binary audio, not JSON\n\t\t\tif (this.model === \"@cf/deepgram/nova-3\") {\n\t\t\t\treturn this.transcribeViaRestBinary(audioBytes, audio, extra);\n\t\t\t}\n\t\t\treturn this.transcribeViaRest(audioPayload, extra);\n\t\t}\n\n\t\treturn this.transcribeViaGateway(audioPayload, extra);\n\t}\n\n\t/**\n\t * Build the audio field for the request payload, handling model-specific formats.\n\t *\n\t * - `@cf/deepgram/nova-3` requires `{ body: base64, contentType: \"audio/...\" }`\n\t * - `@cf/openai/whisper-large-v3-turbo` REST/gateway accepts a base64 string\n\t * - Other Whisper models accept `number[]` (binding) or base64 (REST)\n\t */\n\tprivate buildAudioPayload(\n\t\taudioBytes: number[],\n\t\toriginalAudio: string | File | Blob | ArrayBuffer,\n\t): Record<string, unknown> {\n\t\tif (this.model === \"@cf/deepgram/nova-3\") {\n\t\t\tconst b64 = uint8ArrayToBase64(new Uint8Array(audioBytes));\n\t\t\tconst contentType = detectAudioContentType(originalAudio);\n\t\t\treturn { audio: { body: b64, contentType } };\n\t\t}\n\n\t\tif (this.model === \"@cf/openai/whisper-large-v3-turbo\") {\n\t\t\treturn { audio: uint8ArrayToBase64(new Uint8Array(audioBytes)) };\n\t\t}\n\n\t\treturn { audio: audioBytes };\n\t}\n\n\tprivate async transcribeViaBinding(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst ai = (this.adapterConfig as WorkersAiDirectBindingConfig).binding;\n\t\tconst result = (await ai.run(this.model, {\n\t\t\t...audioPayload,\n\t\t\t...options,\n\t\t})) as Record<string, unknown>;\n\t\treturn this.normalizeResult(result);\n\t}\n\n\tprivate async transcribeViaRest(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\n\t\tconst response = await workersAiRestFetch(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\t{ ...audioPayload, ...options },\n\t\t\t{\n\t\t\t\tlabel: \"Workers AI transcription\",\n\t\t\t\tsignal: (options as { signal?: AbortSignal }).signal,\n\t\t\t},\n\t\t);\n\n\t\tconst data = (await response.json()) as {\n\t\t\tresult?: Record<string, unknown>;\n\t\t} & Record<string, unknown>;\n\n\t\t// Cloudflare REST API wraps responses in { success, result: {...} }.\n\t\t// Use `data.result` when present, fall back to `data` for direct responses.\n\t\treturn this.normalizeResult(data.result ?? data);\n\t}\n\n\t/**\n\t * Transcribe via REST using raw binary audio.\n\t * Required for models like Deepgram Nova-3 that expect raw audio bytes\n\t * with a Content-Type header (e.g. \"audio/wav\") instead of JSON.\n\t */\n\tprivate async transcribeViaRestBinary(\n\t\taudioBytes: number[],\n\t\toriginalAudio: string | File | Blob | ArrayBuffer,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\t\tconst contentType = detectAudioContentType(originalAudio);\n\n\t\tconst response = await workersAiRestFetchBinary(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\tnew Uint8Array(audioBytes),\n\t\t\tcontentType,\n\t\t\t{\n\t\t\t\tlabel: \"Workers AI transcription\",\n\t\t\t\tsignal: (options as { signal?: AbortSignal }).signal,\n\t\t\t},\n\t\t);\n\n\t\tconst data = (await response.json()) as {\n\t\t\tresult?: Record<string, unknown>;\n\t\t} & Record<string, unknown>;\n\n\t\treturn this.normalizeResult(data.result ?? data);\n\t}\n\n\tprivate async transcribeViaGateway(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst gatewayConfig = this.adapterConfig as AiGatewayAdapterConfig;\n\t\tconst gatewayFetch = createGatewayFetch(\"workers-ai\", gatewayConfig);\n\n\t\t// The URL here is a placeholder — createGatewayFetch for \"workers-ai\" extracts\n\t\t// the model from the body, sets it as the endpoint, and routes through the gateway.\n\t\t// The actual URL path is not used.\n\t\tconst response = await gatewayFetch(\"https://api.cloudflare.com/v1/audio/transcriptions\", {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmodel: this.model,\n\t\t\t\t...audioPayload,\n\t\t\t\t...options,\n\t\t\t}),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errorText = await response.text();\n\t\t\tthrow new Error(\n\t\t\t\t`Workers AI transcription gateway request failed (${response.status}): ${errorText}`,\n\t\t\t);\n\t\t}\n\n\t\tconst data = (await response.json()) as Record<string, unknown>;\n\t\treturn this.normalizeResult(data);\n\t}\n\n\t/**\n\t * Normalize Workers AI transcription results into the standard\n\t * TanStack AI TranscriptionResult shape.\n\t *\n\t * Handles three response formats:\n\t * - Whisper: `{ text, words?, vtt? }`\n\t * - Whisper v3-turbo: `{ text, segments?, transcription_info? }`\n\t * - Deepgram Nova-3: `{ results: { channels: [{ alternatives: [{ transcript, words }] }] } }`\n\t */\n\tprivate normalizeResult(raw: Record<string, unknown>): TranscriptionResult {\n\t\t// Deepgram Nova-3 format: { results: { channels: [{ alternatives: [{ transcript, words }] }] } }\n\t\tconst results = raw.results as Record<string, unknown> | undefined;\n\t\tif (results?.channels) {\n\t\t\tconst channels = results.channels as Array<{\n\t\t\t\talternatives?: Array<{\n\t\t\t\t\ttranscript?: string;\n\t\t\t\t\tconfidence?: number;\n\t\t\t\t\twords?: Array<{ word: string; start: number; end: number; confidence: number }>;\n\t\t\t\t}>;\n\t\t\t}>;\n\t\t\tconst alt = channels?.[0]?.alternatives?.[0];\n\t\t\tconst text = alt?.transcript ?? \"\";\n\t\t\tconst result: TranscriptionResult = {\n\t\t\t\tid: this.generateId(),\n\t\t\t\tmodel: this.model,\n\t\t\t\ttext,\n\t\t\t};\n\t\t\tif (alt?.words && Array.isArray(alt.words)) {\n\t\t\t\tresult.words = alt.words.map((w) => ({\n\t\t\t\t\tword: w.word ?? \"\",\n\t\t\t\t\tstart: w.start ?? 0,\n\t\t\t\t\tend: w.end ?? 0,\n\t\t\t\t}));\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\t// Whisper format: { text, words?, vtt? }\n\t\t// Whisper v3-turbo format: { text, segments?, transcription_info? }\n\t\tconst result: TranscriptionResult = {\n\t\t\tid: this.generateId(),\n\t\t\tmodel: this.model,\n\t\t\ttext: (raw.text as string) ?? \"\",\n\t\t};\n\n\t\t// Language from transcription_info (whisper-large-v3-turbo)\n\t\tconst transcriptionInfo = raw.transcription_info as Record<string, unknown> | undefined;\n\t\tif (transcriptionInfo?.language) {\n\t\t\tresult.language = transcriptionInfo.language as string;\n\t\t}\n\n\t\t// Duration\n\t\tif (transcriptionInfo?.duration != null) {\n\t\t\tresult.duration = transcriptionInfo.duration as number;\n\t\t}\n\n\t\t// Segments (whisper-large-v3-turbo returns these)\n\t\tif (raw.segments && Array.isArray(raw.segments)) {\n\t\t\tresult.segments = raw.segments.map((seg: Record<string, unknown>, idx: number) => ({\n\t\t\t\tid: idx,\n\t\t\t\ttext: (seg.text as string) ?? \"\",\n\t\t\t\tstart: (seg.start as number) ?? 0,\n\t\t\t\tend: (seg.end as number) ?? 0,\n\t\t\t}));\n\t\t}\n\n\t\t// Words — basic whisper returns top-level words[], v3-turbo nests them in segments\n\t\tif (raw.words && Array.isArray(raw.words)) {\n\t\t\tresult.words = raw.words.map((w: Record<string, unknown>) => ({\n\t\t\t\tword: (w.word as string) ?? \"\",\n\t\t\t\tstart: (w.start as number) ?? 0,\n\t\t\t\tend: (w.end as number) ?? 0,\n\t\t\t}));\n\t\t}\n\n\t\treturn result;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a Workers AI transcription adapter for speech-to-text.\n *\n * Works with TanStack AI's `generateTranscription()` activity function:\n * ```ts\n * import { generateTranscription } from \"@tanstack/ai\";\n * import { createWorkersAiTranscription } from \"@cloudflare/tanstack-ai\";\n *\n * const adapter = createWorkersAiTranscription(\n *   \"@cf/openai/whisper-large-v3-turbo\",\n *   { binding: env.AI },\n * );\n *\n * const result = await generateTranscription({ adapter, audio: audioData });\n * // result.text — the transcribed text\n * ```\n *\n * Note: Factory takes `(model, config)` for ergonomics — the class constructor\n * uses `(config, model)` to match TanStack AI's upstream convention.\n */\nexport function createWorkersAiTranscription(\n\tmodel: WorkersAiTranscriptionModel,\n\tconfig: WorkersAiAdapterConfig,\n) {\n\treturn new WorkersAiTranscriptionAdapter(config, model);\n}\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize various audio input formats into a number[] (raw bytes).\n *\n * Note: `File extends Blob`, so `File` instances are handled by the\n * `instanceof Blob` branch. `Blob.arrayBuffer()` always reads the full\n * contents regardless of any prior reads — there's no cursor to worry about.\n */\nasync function normalizeAudioToBytes(audio: string | File | Blob | ArrayBuffer): Promise<number[]> {\n\tif (audio instanceof ArrayBuffer) {\n\t\treturn Array.from(new Uint8Array(audio));\n\t}\n\n\tif (audio instanceof Blob) {\n\t\t// This also handles `File` (which extends Blob)\n\t\tconst buffer = await audio.arrayBuffer();\n\t\treturn Array.from(new Uint8Array(buffer));\n\t}\n\n\tif (typeof audio === \"string\") {\n\t\t// Assume base64 string — decode to bytes\n\t\tconst binary = atob(audio);\n\t\tconst bytes = new Uint8Array(binary.length);\n\t\tfor (let i = 0; i < binary.length; i++) {\n\t\t\tbytes[i] = binary.charCodeAt(i);\n\t\t}\n\t\treturn Array.from(bytes);\n\t}\n\n\tthrow new Error(\"Unsupported audio format. Expected string, File, Blob, or ArrayBuffer.\");\n}\n\n/**\n * Detect the MIME type of the audio input for models that require it\n * (e.g., Deepgram Nova-3).\n *\n * - `File` / `Blob`: use the `.type` property (e.g., \"audio/wav\")\n * - `ArrayBuffer` / `string`: defaults to \"audio/wav\"\n */\nfunction detectAudioContentType(audio: string | File | Blob | ArrayBuffer): string {\n\t// File and Blob carry their own MIME type\n\tif (audio instanceof Blob && audio.type) {\n\t\treturn audio.type;\n\t}\n\n\t// For raw bytes, default to audio/wav — this is the most common\n\t// format for transcription inputs and what the E2E tests use.\n\treturn \"audio/wav\";\n}\n"]}