@tanstack/ai-elevenlabs 0.2.34 → 0.2.36

package/dist/esm/utils/client.js

@@ -1,118 +1,139 @@
 import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
-import { getApiKeyFromEnv, generateId as generateId$1 } from "@tanstack/ai-utils";
+import { generateId, getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
 function getEnvironment() {
-  if (typeof globalThis !== "undefined") {
-    const win = globalThis.window;
-    if (win?.env) return win.env;
-  }
-  if (typeof process !== "undefined") {
-    return process.env;
-  }
-  return void 0;
+	if (typeof globalThis !== "undefined") {
+		const win = globalThis.window;
+		if (win?.env) return win.env;
+	}
+	if (typeof process !== "undefined") return process.env;
 }
 function getElevenLabsApiKeyFromEnv() {
-  return getApiKeyFromEnv("ELEVENLABS_API_KEY");
+	return getApiKeyFromEnv("ELEVENLABS_API_KEY");
 }
 function getElevenLabsAgentIdFromEnv() {
-  const id = getEnvironment()?.ELEVENLABS_AGENT_ID;
-  if (!id) {
-    throw new Error(
-      "ELEVENLABS_AGENT_ID is required. Please set it in your environment variables or pass `agentId` explicitly to elevenlabsRealtimeToken()."
-    );
-  }
-  return id;
+	const id = getEnvironment()?.ELEVENLABS_AGENT_ID;
+	if (!id) throw new Error("ELEVENLABS_AGENT_ID is required. Please set it in your environment variables or pass `agentId` explicitly to elevenlabsRealtimeToken().");
+	return id;
 }
+/**
+* Build an `ElevenLabsClient` with env-based or explicit credentials.
+* Each adapter calls this once at construction time so unit tests can
+* pass in an explicit key without needing `process.env`.
+*/
 function createElevenLabsClient(config) {
-  const apiKey = config?.apiKey ?? getElevenLabsApiKeyFromEnv();
-  return new ElevenLabsClient({
-    apiKey,
-    ...config?.baseUrl ? { baseUrl: config.baseUrl } : {},
-    ...config?.timeoutInSeconds != null ? { timeoutInSeconds: config.timeoutInSeconds } : {},
-    ...config?.maxRetries != null ? { maxRetries: config.maxRetries } : {},
-    ...config?.headers ? { headers: config.headers } : {}
-  });
+	return new ElevenLabsClient({
+		apiKey: config?.apiKey ?? getElevenLabsApiKeyFromEnv(),
+		...config?.baseUrl ? { baseUrl: config.baseUrl } : {},
+		...config?.timeoutInSeconds != null ? { timeoutInSeconds: config.timeoutInSeconds } : {},
+		...config?.maxRetries != null ? { maxRetries: config.maxRetries } : {},
+		...config?.headers ? { headers: config.headers } : {}
+	});
 }
-const generateId = generateId$1;
+var generateId$1 = generateId;
+/**
+* Convert an ArrayBuffer to base64 in a cross-runtime way.
+*
+* The naive `btoa(String.fromCharCode(...bytes))` form blows up V8's argument
+* limit (~65k) on realistic audio payloads, so we either use `Buffer`
+* (Node / Bun) or walk the byte array in a single loop (browser).
+*/
 function arrayBufferToBase64(buffer) {
-  if (typeof Buffer !== "undefined" && typeof Buffer.from === "function") {
-    return Buffer.from(buffer).toString("base64");
-  }
-  const view = new Uint8Array(buffer);
-  let binary = "";
-  for (const byte of view) {
-    binary += String.fromCharCode(byte);
-  }
-  return btoa(binary);
+	if (typeof Buffer !== "undefined" && typeof Buffer.from === "function") return Buffer.from(buffer).toString("base64");
+	const view = new Uint8Array(buffer);
+	let binary = "";
+	for (const byte of view) binary += String.fromCharCode(byte);
+	return btoa(binary);
 }
+/**
+* Drain a `ReadableStream<Uint8Array>` (what the ElevenLabs SDK returns for
+* audio endpoints) into a single `Uint8Array`, then expose it as an
+* `ArrayBuffer` slice. We concatenate ourselves rather than going through
+* `new Response(stream).arrayBuffer()` so we stay runtime-agnostic.
+*/
 async function readStreamToArrayBuffer(stream) {
-  const reader = stream.getReader();
-  const chunks = [];
-  let total = 0;
-  try {
-    let result = await reader.read();
-    while (!result.done) {
-      chunks.push(result.value);
-      total += result.value.byteLength;
-      result = await reader.read();
-    }
-  } finally {
-    reader.releaseLock();
-  }
-  const merged = new Uint8Array(total);
-  let offset = 0;
-  for (const chunk of chunks) {
-    merged.set(chunk, offset);
-    offset += chunk.byteLength;
-  }
-  return merged.buffer.slice(
-    merged.byteOffset,
-    merged.byteOffset + merged.byteLength
-  );
+	const reader = stream.getReader();
+	const chunks = [];
+	let total = 0;
+	try {
+		let result = await reader.read();
+		while (!result.done) {
+			chunks.push(result.value);
+			total += result.value.byteLength;
+			result = await reader.read();
+		}
+	} finally {
+		reader.releaseLock();
+	}
+	const merged = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		merged.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return merged.buffer.slice(merged.byteOffset, merged.byteOffset + merged.byteLength);
 }
+/**
+* Decode a `data:` URL into a Blob for upload to the ElevenLabs STT API
+* (which only accepts multipart files or https URLs). Supports base64 and
+* URL-encoded payloads. Returns `undefined` for non-data-URL strings so the
+* caller can fall through to treating the input as an https URL.
+*/
 function dataUrlToBlob(value) {
-  if (!value.startsWith("data:")) return void 0;
-  const commaIndex = value.indexOf(",");
-  if (commaIndex === -1) return void 0;
-  const header = value.slice(5, commaIndex);
-  const payload = value.slice(commaIndex + 1);
-  const isBase64 = /;base64$/i.test(header);
-  const mimeType = header.split(";")[0] || "application/octet-stream";
-  if (isBase64) {
-    const binary = atob(payload);
-    const bytes = new Uint8Array(binary.length);
-    for (let i = 0; i < binary.length; i += 1) {
-      bytes[i] = binary.charCodeAt(i);
-    }
-    return new Blob([bytes], { type: mimeType });
-  }
-  return new Blob([decodeURIComponent(payload)], { type: mimeType });
+	if (!value.startsWith("data:")) return void 0;
+	const commaIndex = value.indexOf(",");
+	if (commaIndex === -1) return void 0;
+	const header = value.slice(5, commaIndex);
+	const payload = value.slice(commaIndex + 1);
+	const isBase64 = /;base64$/i.test(header);
+	const mimeType = header.split(";")[0] || "application/octet-stream";
+	if (isBase64) {
+		const binary = atob(payload);
+		const bytes = new Uint8Array(binary.length);
+		for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
+		return new Blob([bytes], { type: mimeType });
+	}
+	return new Blob([decodeURIComponent(payload)], { type: mimeType });
 }
+/**
+* Break an ElevenLabs `output_format` string (`mp3_44100_128`,
+* `pcm_24000`, `opus_48000_64`, `ulaw_8000`, ...) into a file extension and
+* content-type suitable for `TTSResult` / `AudioGenerationResult` consumers.
+*
+* Unknown codecs fall back to `mp3` / `audio/mpeg` because the ElevenLabs
+* default is `mp3_44100_128` — mispredicting on an exotic format is safer
+* than throwing in the adapter.
+*/
 function parseOutputFormat(fmt) {
-  const codec = (fmt || "mp3_44100_128").split("_")[0]?.toLowerCase();
-  switch (codec) {
-    case "mp3":
-      return { format: "mp3", contentType: "audio/mpeg" };
-    case "pcm":
-      return { format: "pcm", contentType: "audio/pcm" };
-    case "opus":
-      return { format: "opus", contentType: "audio/opus" };
-    case "ulaw":
-      return { format: "ulaw", contentType: "audio/basic" };
-    case "alaw":
-      return { format: "alaw", contentType: "audio/x-alaw-basic" };
-    case void 0:
-    default:
-      return { format: "mp3", contentType: "audio/mpeg" };
-  }
+	switch ((fmt || "mp3_44100_128").split("_")[0]?.toLowerCase()) {
+		case "mp3": return {
+			format: "mp3",
+			contentType: "audio/mpeg"
+		};
+		case "pcm": return {
+			format: "pcm",
+			contentType: "audio/pcm"
+		};
+		case "opus": return {
+			format: "opus",
+			contentType: "audio/opus"
+		};
+		case "ulaw": return {
+			format: "ulaw",
+			contentType: "audio/basic"
+		};
+		case "alaw": return {
+			format: "alaw",
+			contentType: "audio/x-alaw-basic"
+		};
+		case void 0:
+		default: return {
+			format: "mp3",
+			contentType: "audio/mpeg"
+		};
+	}
 }
-export {
-  arrayBufferToBase64,
-  createElevenLabsClient,
-  dataUrlToBlob,
-  generateId,
-  getElevenLabsAgentIdFromEnv,
-  getElevenLabsApiKeyFromEnv,
-  parseOutputFormat,
-  readStreamToArrayBuffer
-};
-//# sourceMappingURL=client.js.map
+//#endregion
+export { arrayBufferToBase64, createElevenLabsClient, dataUrlToBlob, generateId$1 as generateId, getElevenLabsAgentIdFromEnv, getElevenLabsApiKeyFromEnv, parseOutputFormat, readStreamToArrayBuffer };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { ElevenLabsClient } from '@elevenlabs/elevenlabs-js'\nimport {\n  getApiKeyFromEnv,\n  generateId as sharedGenerateId,\n} from '@tanstack/ai-utils'\nimport type { ElevenLabsOutputFormat } from '../model-meta'\n\n/**\n * Configuration for any ElevenLabs adapter. When `apiKey` is omitted we read\n * `ELEVENLABS_API_KEY` from `process.env` / `window.env` to match the\n * pattern the realtime adapters already use.\n */\nexport interface ElevenLabsClientConfig {\n  apiKey?: string\n  /** Override the API base URL — handy for tests + self-hosted proxies. */\n  baseUrl?: string\n  /** Per-request timeout passed through to the SDK (ms). */\n  timeoutInSeconds?: number\n  /** Override the number of SDK-level retries. */\n  maxRetries?: number\n  /** Extra headers attached to every request (e.g. test multiplexing). */\n  headers?: Record<string, string>\n}\n\ninterface EnvObject {\n  ELEVENLABS_API_KEY?: string\n  ELEVENLABS_AGENT_ID?: string\n}\n\ninterface WindowWithEnv {\n  env?: EnvObject\n}\n\nfunction getEnvironment(): EnvObject | undefined {\n  if (typeof globalThis !== 'undefined') {\n    const win = (globalThis as { window?: WindowWithEnv }).window\n    if (win?.env) return win.env\n  }\n  if (typeof process !== 'undefined') {\n    return process.env as EnvObject\n  }\n  return undefined\n}\n\nexport function getElevenLabsApiKeyFromEnv(): string {\n  return getApiKeyFromEnv('ELEVENLABS_API_KEY')\n}\n\nexport function getElevenLabsAgentIdFromEnv(): string {\n  const id = getEnvironment()?.ELEVENLABS_AGENT_ID\n  if (!id) {\n    throw new Error(\n      'ELEVENLABS_AGENT_ID is required. Please set it in your environment ' +\n        'variables or pass `agentId` explicitly to elevenlabsRealtimeToken().',\n    )\n  }\n  return id\n}\n\n/**\n * Build an `ElevenLabsClient` with env-based or explicit credentials.\n * Each adapter calls this once at construction time so unit tests can\n * pass in an explicit key without needing `process.env`.\n */\nexport function createElevenLabsClient(\n  config?: ElevenLabsClientConfig,\n): ElevenLabsClient {\n  const apiKey = config?.apiKey ?? getElevenLabsApiKeyFromEnv()\n  return new ElevenLabsClient({\n    apiKey,\n    ...(config?.baseUrl ? { baseUrl: config.baseUrl } : {}),\n    ...(config?.timeoutInSeconds != null\n      ? { timeoutInSeconds: config.timeoutInSeconds }\n      : {}),\n    ...(config?.maxRetries != null ? { maxRetries: config.maxRetries } : {}),\n    ...(config?.headers ? { headers: config.headers } : {}),\n  })\n}\n\n// Re-exported from `@tanstack/ai-utils` so existing callers keep working\n// while the implementation stays deduped across provider packages.\nexport const generateId = sharedGenerateId\n\n/**\n * Convert an ArrayBuffer to base64 in a cross-runtime way.\n *\n * The naive `btoa(String.fromCharCode(...bytes))` form blows up V8's argument\n * limit (~65k) on realistic audio payloads, so we either use `Buffer`\n * (Node / Bun) or walk the byte array in a single loop (browser).\n */\nexport function arrayBufferToBase64(buffer: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\n    return Buffer.from(buffer).toString('base64')\n  }\n  const view = new Uint8Array(buffer)\n  let binary = ''\n  for (const byte of view) {\n    binary += String.fromCharCode(byte)\n  }\n  return btoa(binary)\n}\n\n/**\n * Drain a `ReadableStream<Uint8Array>` (what the ElevenLabs SDK returns for\n * audio endpoints) into a single `Uint8Array`, then expose it as an\n * `ArrayBuffer` slice. We concatenate ourselves rather than going through\n * `new Response(stream).arrayBuffer()` so we stay runtime-agnostic.\n */\nexport async function readStreamToArrayBuffer(\n  stream: ReadableStream<Uint8Array>,\n): Promise<ArrayBuffer> {\n  const reader = stream.getReader()\n  const chunks: Array<Uint8Array> = []\n  let total = 0\n  try {\n    let result = await reader.read()\n    while (!result.done) {\n      chunks.push(result.value)\n      total += result.value.byteLength\n      result = await reader.read()\n    }\n  } finally {\n    reader.releaseLock()\n  }\n  const merged = new Uint8Array(total)\n  let offset = 0\n  for (const chunk of chunks) {\n    merged.set(chunk, offset)\n    offset += chunk.byteLength\n  }\n  return merged.buffer.slice(\n    merged.byteOffset,\n    merged.byteOffset + merged.byteLength,\n  )\n}\n\n/**\n * Decode a `data:` URL into a Blob for upload to the ElevenLabs STT API\n * (which only accepts multipart files or https URLs). Supports base64 and\n * URL-encoded payloads. Returns `undefined` for non-data-URL strings so the\n * caller can fall through to treating the input as an https URL.\n */\nexport function dataUrlToBlob(value: string): Blob | undefined {\n  if (!value.startsWith('data:')) return undefined\n  const commaIndex = value.indexOf(',')\n  if (commaIndex === -1) return undefined\n\n  const header = value.slice(5, commaIndex)\n  const payload = value.slice(commaIndex + 1)\n  const isBase64 = /;base64$/i.test(header)\n  const mimeType = header.split(';')[0] || 'application/octet-stream'\n\n  if (isBase64) {\n    const binary = atob(payload)\n    const bytes = new Uint8Array(binary.length)\n    for (let i = 0; i < binary.length; i += 1) {\n      bytes[i] = binary.charCodeAt(i)\n    }\n    return new Blob([bytes], { type: mimeType })\n  }\n\n  return new Blob([decodeURIComponent(payload)], { type: mimeType })\n}\n\n/**\n * Break an ElevenLabs `output_format` string (`mp3_44100_128`,\n * `pcm_24000`, `opus_48000_64`, `ulaw_8000`, ...) into a file extension and\n * content-type suitable for `TTSResult` / `AudioGenerationResult` consumers.\n *\n * Unknown codecs fall back to `mp3` / `audio/mpeg` because the ElevenLabs\n * default is `mp3_44100_128` — mispredicting on an exotic format is safer\n * than throwing in the adapter.\n */\nexport function parseOutputFormat(fmt: ElevenLabsOutputFormat | undefined): {\n  format: string\n  contentType: string\n} {\n  const codec = (fmt || 'mp3_44100_128').split('_')[0]?.toLowerCase()\n  switch (codec) {\n    case 'mp3':\n      return { format: 'mp3', contentType: 'audio/mpeg' }\n    case 'pcm':\n      return { format: 'pcm', contentType: 'audio/pcm' }\n    case 'opus':\n      return { format: 'opus', contentType: 'audio/opus' }\n    case 'ulaw':\n      return { format: 'ulaw', contentType: 'audio/basic' }\n    case 'alaw':\n      return { format: 'alaw', contentType: 'audio/x-alaw-basic' }\n    case undefined:\n    default:\n      // `split('_')[0]?.toLowerCase()` can be `undefined` only if `fmt` is\n      // an empty string; any other unknown codec also falls back to mp3.\n      return { format: 'mp3', contentType: 'audio/mpeg' }\n  }\n}\n"],"names":["sharedGenerateId"],"mappings":"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"}
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { ElevenLabsClient } from '@elevenlabs/elevenlabs-js'\nimport {\n  getApiKeyFromEnv,\n  generateId as sharedGenerateId,\n} from '@tanstack/ai-utils'\nimport type { ElevenLabsOutputFormat } from '../model-meta'\n\n/**\n * Configuration for any ElevenLabs adapter. When `apiKey` is omitted we read\n * `ELEVENLABS_API_KEY` from `process.env` / `window.env` to match the\n * pattern the realtime adapters already use.\n */\nexport interface ElevenLabsClientConfig {\n  apiKey?: string\n  /** Override the API base URL — handy for tests + self-hosted proxies. */\n  baseUrl?: string\n  /** Per-request timeout passed through to the SDK (ms). */\n  timeoutInSeconds?: number\n  /** Override the number of SDK-level retries. */\n  maxRetries?: number\n  /** Extra headers attached to every request (e.g. test multiplexing). */\n  headers?: Record<string, string>\n}\n\ninterface EnvObject {\n  ELEVENLABS_API_KEY?: string\n  ELEVENLABS_AGENT_ID?: string\n}\n\ninterface WindowWithEnv {\n  env?: EnvObject\n}\n\nfunction getEnvironment(): EnvObject | undefined {\n  if (typeof globalThis !== 'undefined') {\n    const win = (globalThis as { window?: WindowWithEnv }).window\n    if (win?.env) return win.env\n  }\n  if (typeof process !== 'undefined') {\n    return process.env as EnvObject\n  }\n  return undefined\n}\n\nexport function getElevenLabsApiKeyFromEnv(): string {\n  return getApiKeyFromEnv('ELEVENLABS_API_KEY')\n}\n\nexport function getElevenLabsAgentIdFromEnv(): string {\n  const id = getEnvironment()?.ELEVENLABS_AGENT_ID\n  if (!id) {\n    throw new Error(\n      'ELEVENLABS_AGENT_ID is required. Please set it in your environment ' +\n        'variables or pass `agentId` explicitly to elevenlabsRealtimeToken().',\n    )\n  }\n  return id\n}\n\n/**\n * Build an `ElevenLabsClient` with env-based or explicit credentials.\n * Each adapter calls this once at construction time so unit tests can\n * pass in an explicit key without needing `process.env`.\n */\nexport function createElevenLabsClient(\n  config?: ElevenLabsClientConfig,\n): ElevenLabsClient {\n  const apiKey = config?.apiKey ?? getElevenLabsApiKeyFromEnv()\n  return new ElevenLabsClient({\n    apiKey,\n    ...(config?.baseUrl ? { baseUrl: config.baseUrl } : {}),\n    ...(config?.timeoutInSeconds != null\n      ? { timeoutInSeconds: config.timeoutInSeconds }\n      : {}),\n    ...(config?.maxRetries != null ? { maxRetries: config.maxRetries } : {}),\n    ...(config?.headers ? { headers: config.headers } : {}),\n  })\n}\n\n// Re-exported from `@tanstack/ai-utils` so existing callers keep working\n// while the implementation stays deduped across provider packages.\nexport const generateId = sharedGenerateId\n\n/**\n * Convert an ArrayBuffer to base64 in a cross-runtime way.\n *\n * The naive `btoa(String.fromCharCode(...bytes))` form blows up V8's argument\n * limit (~65k) on realistic audio payloads, so we either use `Buffer`\n * (Node / Bun) or walk the byte array in a single loop (browser).\n */\nexport function arrayBufferToBase64(buffer: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\n    return Buffer.from(buffer).toString('base64')\n  }\n  const view = new Uint8Array(buffer)\n  let binary = ''\n  for (const byte of view) {\n    binary += String.fromCharCode(byte)\n  }\n  return btoa(binary)\n}\n\n/**\n * Drain a `ReadableStream<Uint8Array>` (what the ElevenLabs SDK returns for\n * audio endpoints) into a single `Uint8Array`, then expose it as an\n * `ArrayBuffer` slice. We concatenate ourselves rather than going through\n * `new Response(stream).arrayBuffer()` so we stay runtime-agnostic.\n */\nexport async function readStreamToArrayBuffer(\n  stream: ReadableStream<Uint8Array>,\n): Promise<ArrayBuffer> {\n  const reader = stream.getReader()\n  const chunks: Array<Uint8Array> = []\n  let total = 0\n  try {\n    let result = await reader.read()\n    while (!result.done) {\n      chunks.push(result.value)\n      total += result.value.byteLength\n      result = await reader.read()\n    }\n  } finally {\n    reader.releaseLock()\n  }\n  const merged = new Uint8Array(total)\n  let offset = 0\n  for (const chunk of chunks) {\n    merged.set(chunk, offset)\n    offset += chunk.byteLength\n  }\n  return merged.buffer.slice(\n    merged.byteOffset,\n    merged.byteOffset + merged.byteLength,\n  )\n}\n\n/**\n * Decode a `data:` URL into a Blob for upload to the ElevenLabs STT API\n * (which only accepts multipart files or https URLs). Supports base64 and\n * URL-encoded payloads. Returns `undefined` for non-data-URL strings so the\n * caller can fall through to treating the input as an https URL.\n */\nexport function dataUrlToBlob(value: string): Blob | undefined {\n  if (!value.startsWith('data:')) return undefined\n  const commaIndex = value.indexOf(',')\n  if (commaIndex === -1) return undefined\n\n  const header = value.slice(5, commaIndex)\n  const payload = value.slice(commaIndex + 1)\n  const isBase64 = /;base64$/i.test(header)\n  const mimeType = header.split(';')[0] || 'application/octet-stream'\n\n  if (isBase64) {\n    const binary = atob(payload)\n    const bytes = new Uint8Array(binary.length)\n    for (let i = 0; i < binary.length; i += 1) {\n      bytes[i] = binary.charCodeAt(i)\n    }\n    return new Blob([bytes], { type: mimeType })\n  }\n\n  return new Blob([decodeURIComponent(payload)], { type: mimeType })\n}\n\n/**\n * Break an ElevenLabs `output_format` string (`mp3_44100_128`,\n * `pcm_24000`, `opus_48000_64`, `ulaw_8000`, ...) into a file extension and\n * content-type suitable for `TTSResult` / `AudioGenerationResult` consumers.\n *\n * Unknown codecs fall back to `mp3` / `audio/mpeg` because the ElevenLabs\n * default is `mp3_44100_128` — mispredicting on an exotic format is safer\n * than throwing in the adapter.\n */\nexport function parseOutputFormat(fmt: ElevenLabsOutputFormat | undefined): {\n  format: string\n  contentType: string\n} {\n  const codec = (fmt || 'mp3_44100_128').split('_')[0]?.toLowerCase()\n  switch (codec) {\n    case 'mp3':\n      return { format: 'mp3', contentType: 'audio/mpeg' }\n    case 'pcm':\n      return { format: 'pcm', contentType: 'audio/pcm' }\n    case 'opus':\n      return { format: 'opus', contentType: 'audio/opus' }\n    case 'ulaw':\n      return { format: 'ulaw', contentType: 'audio/basic' }\n    case 'alaw':\n      return { format: 'alaw', contentType: 'audio/x-alaw-basic' }\n    case undefined:\n    default:\n      // `split('_')[0]?.toLowerCase()` can be `undefined` only if `fmt` is\n      // an empty string; any other unknown codec also falls back to mp3.\n      return { format: 'mp3', contentType: 'audio/mpeg' }\n  }\n}\n"],"mappings":"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"}

package/dist/esm/utils/index.js

@@ -0,0 +1,2 @@
+import { getElevenLabsApiKeyFromEnv } from "./client.js";
+export { getElevenLabsApiKeyFromEnv };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-elevenlabs",
-  "version": "0.2.34",
+  "version": "0.2.36",
   "description": "ElevenLabs adapter for TanStack AI realtime voice, text-to-speech, transcription, music, and sound effects.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -50,21 +50,21 @@
   "dependencies": {
     "@elevenlabs/client": "^1.3.1",
     "@elevenlabs/elevenlabs-js": "^2.44.0",
-    "@tanstack/ai-utils": "0.3.1"
+    "@tanstack/ai-utils": "^0.4.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.42.0"
+    "@tanstack/ai": "^0.44.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
-    "@tanstack/ai": "0.42.0"
+    "@tanstack/ai": "0.44.0"
   },
   "scripts": {
     "build": "vite build",
     "clean": "premove ./build ./dist",
-    "lint:fix": "eslint ./src --fix",
+    "lint:fix": "oxlint src --type-aware --fix",
     "test:build": "publint --strict",
-    "test:eslint": "eslint ./src",
+    "test:oxlint": "oxlint src --type-aware",
     "test:lib": "vitest --passWithNoTests",
     "test:lib:dev": "pnpm test:lib --watch",
     "test:types": "tsc"

package/src/adapters/transcription.ts

@@ -165,7 +165,7 @@ export class ElevenLabsTranscriptionAdapter<
     // The SDK types this as a union of single- and multi-channel responses.
     // We treat multi-channel as "join the channel transcripts" — consumers
     // who care about per-channel detail can re-parse from `modelOptions`.
-    // eslint-disable-next-line no-restricted-syntax -- bridges SpeechToTextConvertResponse union (incl. webhook variant with no text/words/transcripts) to a flattened duck-typed shape we discriminate at runtime
+    // oxlint-disable-next-line eslint-js/no-restricted-syntax -- bridges SpeechToTextConvertResponse union (incl. webhook variant with no text/words/transcripts) to a flattened duck-typed shape we discriminate at runtime
     const data = response as unknown as {
       text?: string
       languageCode?: string

package/dist/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}