@effect-uai/elevenlabs 0.4.0

package/dist/codec.mjs

@@ -0,0 +1,120 @@
+import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
+import { Array, Effect, Encoding, Match, Option, Result } from "effect";
+import * as AiError from "@effect-uai/core/AiError";
+//#region src/codec.ts
+var codec_exports = /* @__PURE__ */ __exportAll({
+	audioToBlob: () => audioToBlob,
+	defaultFileName: () => defaultFileName,
+	defaultFormat: () => defaultFormat,
+	formatToOutputSlug: () => formatToOutputSlug,
+	httpStatusError: () => httpStatusError,
+	transportFailure: () => transportFailure,
+	wireVoiceSettings: () => wireVoiceSettings
+});
+const wireVoiceSettings = (v) => v === void 0 ? void 0 : {
+	...v.stability !== void 0 && { stability: v.stability },
+	...v.similarityBoost !== void 0 && { similarity_boost: v.similarityBoost },
+	...v.style !== void 0 && { style: v.style },
+	...v.useSpeakerBoost !== void 0 && { use_speaker_boost: v.useSpeakerBoost },
+	...v.speed !== void 0 && { speed: v.speed }
+};
+/**
+* ElevenLabs encodes container + sample rate + bitrate in a single
+* dot-less slug (`mp3_44100_128`, `pcm_16000`, `wav_48000`, `ulaw_8000`,
+* `opus_48000_128`, etc.). This helper inverts the common cases of our
+* `AudioFormat` shape into that slug.
+*
+* Only the formats that map cleanly are produced. Anything we can't
+* encode (mismatched bitrate, unsupported sample rate combination)
+* fails `Unsupported` with the requested format echoed so the user can
+* fix it.
+*/
+const formatToOutputSlug = (format) => Match.value(format).pipe(Match.when({ container: "mp3" }, (f) => Effect.succeed(`mp3_${f.sampleRate}_${f.bitRate ?? 128}`)), Match.when({ container: "opus" }, (f) => Effect.succeed(`opus_${f.sampleRate}_${f.bitRate ?? 128}`)), Match.when({ container: "wav" }, (f) => Effect.succeed(`wav_${f.sampleRate}`)), Match.when({
+	container: "raw",
+	encoding: "pcm_s16le"
+}, (f) => Effect.succeed(`pcm_${f.sampleRate}`)), Match.when({
+	container: "raw",
+	encoding: "pcm_mulaw"
+}, (f) => Effect.succeed(`ulaw_${f.sampleRate}`)), Match.when({
+	container: "raw",
+	encoding: "pcm_alaw"
+}, (f) => Effect.succeed(`alaw_${f.sampleRate}`)), Match.orElse((f) => Effect.fail(new AiError.Unsupported({
+	provider: "elevenlabs",
+	capability: "outputFormat",
+	reason: `Cannot encode ${JSON.stringify(f)} as ElevenLabs output_format. Supported: mp3 + (22050|44100), opus 48000, wav 48000, pcm/ulaw/alaw at any sample rate.`
+}))));
+/** Default output: 128 kbps MP3 at 44.1 kHz. */
+const defaultFormat = {
+	container: "mp3",
+	encoding: "mp3",
+	sampleRate: 44100,
+	bitRate: 128
+};
+const urlNotSupported = new AiError.InvalidRequest({
+	provider: "elevenlabs",
+	param: "audio",
+	raw: "ElevenLabs accepts URLs via the `cloud_storage_url` field, not the `file` field. Fetch the URL yourself and pass `{ _tag: \"bytes\", bytes, mimeType }` to use the inline path."
+});
+const decodeBase64ToBytes = (b64) => Result.match(Encoding.decodeBase64(b64), {
+	onSuccess: Effect.succeed,
+	onFailure: (cause) => Effect.fail(new AiError.InvalidRequest({
+		provider: "elevenlabs",
+		param: "audio",
+		raw: cause
+	}))
+});
+const bytesToBlob = (bytes, mimeType) => new Blob([bytes], { type: mimeType });
+const audioToBlob = Match.type().pipe(Match.tag("bytes", (a) => Effect.succeed(bytesToBlob(a.bytes, a.mimeType))), Match.tag("base64", (a) => decodeBase64ToBytes(a.base64).pipe(Effect.map((bytes) => bytesToBlob(bytes, a.mimeType)))), Match.tag("url", () => Effect.fail(urlNotSupported)), Match.exhaustive);
+const EXTENSION_BY_MIME = [
+	["mpeg", "mp3"],
+	["mp3", "mp3"],
+	["wav", "wav"],
+	["ogg", "ogg"],
+	["opus", "ogg"],
+	["flac", "flac"],
+	["aac", "aac"],
+	["mp4", "m4a"],
+	["m4a", "m4a"],
+	["webm", "webm"]
+];
+const defaultFileName = (mimeType) => Array.findFirst(EXTENSION_BY_MIME, ([pattern]) => mimeType.includes(pattern)).pipe(Option.match({
+	onNone: () => "audio",
+	onSome: ([, ext]) => `audio.${ext}`
+}));
+const httpStatusError = (status, body) => Match.value(status).pipe(Match.when(429, () => new AiError.RateLimited({
+	provider: "elevenlabs",
+	raw: body
+})), Match.whenOr(408, 504, () => new AiError.Timeout({
+	provider: "elevenlabs",
+	raw: body
+})), Match.when(401, () => new AiError.AuthFailed({
+	provider: "elevenlabs",
+	subtype: "auth",
+	raw: body
+})), Match.when(403, () => new AiError.AuthFailed({
+	provider: "elevenlabs",
+	subtype: "permission",
+	raw: body
+})), Match.when(402, () => new AiError.AuthFailed({
+	provider: "elevenlabs",
+	subtype: "billing",
+	raw: body
+})), Match.when(413, () => new AiError.ContextLengthExceeded({
+	provider: "elevenlabs",
+	raw: body
+})), Match.when((n) => n >= 500, (n) => new AiError.Unavailable({
+	provider: "elevenlabs",
+	status: n,
+	raw: body
+})), Match.orElse(() => new AiError.InvalidRequest({
+	provider: "elevenlabs",
+	raw: body
+})));
+const transportFailure = (cause) => new AiError.Unavailable({
+	provider: "elevenlabs",
+	raw: cause
+});
+//#endregion
+export { audioToBlob, defaultFileName, defaultFormat, formatToOutputSlug, httpStatusError, codec_exports as t, transportFailure, wireVoiceSettings };
+
+//# sourceMappingURL=codec.mjs.map

package/dist/codec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.mjs","names":["Arr"],"sources":["../src/codec.ts"],"sourcesContent":["import { Array as Arr, Effect, Encoding, Match, Option, Result } from \"effect\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioFormat, AudioSource } from \"@effect-uai/core/Audio\"\n\n// ---------------------------------------------------------------------------\n// Shared TTS voice-settings shape (sync + streaming use the same fields)\n// ---------------------------------------------------------------------------\n\nexport type VoiceSettings = {\n  readonly stability?: number\n  readonly similarityBoost?: number\n  readonly style?: number\n  readonly useSpeakerBoost?: boolean\n  readonly speed?: number\n}\n\nexport const wireVoiceSettings = (v: VoiceSettings | undefined) =>\n  v === undefined\n    ? undefined\n    : {\n        ...(v.stability !== undefined && { stability: v.stability }),\n        ...(v.similarityBoost !== undefined && { similarity_boost: v.similarityBoost }),\n        ...(v.style !== undefined && { style: v.style }),\n        ...(v.useSpeakerBoost !== undefined && { use_speaker_boost: v.useSpeakerBoost }),\n        ...(v.speed !== undefined && { speed: v.speed }),\n      }\n\n// ---------------------------------------------------------------------------\n// AudioFormat → ElevenLabs `output_format` query value\n// ---------------------------------------------------------------------------\n\n/**\n * ElevenLabs encodes container + sample rate + bitrate in a single\n * dot-less slug (`mp3_44100_128`, `pcm_16000`, `wav_48000`, `ulaw_8000`,\n * `opus_48000_128`, etc.). This helper inverts the common cases of our\n * `AudioFormat` shape into that slug.\n *\n * Only the formats that map cleanly are produced. Anything we can't\n * encode (mismatched bitrate, unsupported sample rate combination)\n * fails `Unsupported` with the requested format echoed so the user can\n * fix it.\n */\nexport const formatToOutputSlug: (format: AudioFormat) => Effect.Effect<string, AiError.AiError> = (\n  format,\n) =>\n  Match.value(format).pipe(\n    Match.when({ container: \"mp3\" }, (f) =>\n      Effect.succeed(`mp3_${f.sampleRate}_${f.bitRate ?? 128}`),\n    ),\n    Match.when({ container: \"opus\" }, (f) =>\n      Effect.succeed(`opus_${f.sampleRate}_${f.bitRate ?? 128}`),\n    ),\n    Match.when({ container: \"wav\" }, (f) => Effect.succeed(`wav_${f.sampleRate}`)),\n    Match.when({ container: \"raw\", encoding: \"pcm_s16le\" }, (f) =>\n      Effect.succeed(`pcm_${f.sampleRate}`),\n    ),\n    Match.when({ container: \"raw\", encoding: \"pcm_mulaw\" }, (f) =>\n      Effect.succeed(`ulaw_${f.sampleRate}`),\n    ),\n    Match.when({ container: \"raw\", encoding: \"pcm_alaw\" }, (f) =>\n      Effect.succeed(`alaw_${f.sampleRate}`),\n    ),\n    Match.orElse((f) =>\n      Effect.fail(\n        new AiError.Unsupported({\n          provider: \"elevenlabs\",\n          capability: \"outputFormat\",\n          reason: `Cannot encode ${JSON.stringify(f)} as ElevenLabs output_format. Supported: mp3 + (22050|44100), opus 48000, wav 48000, pcm/ulaw/alaw at any sample rate.`,\n        }),\n      ),\n    ),\n  )\n\n/** Default output: 128 kbps MP3 at 44.1 kHz. */\nexport const defaultFormat: AudioFormat = {\n  container: \"mp3\",\n  encoding: \"mp3\",\n  sampleRate: 44100,\n  bitRate: 128,\n}\n\n// ---------------------------------------------------------------------------\n// AudioSource → Blob (STT multipart upload)\n// ---------------------------------------------------------------------------\n\nconst urlNotSupported: AiError.AiError = new AiError.InvalidRequest({\n  provider: \"elevenlabs\",\n  param: \"audio\",\n  raw: 'ElevenLabs accepts URLs via the `cloud_storage_url` field, not the `file` field. Fetch the URL yourself and pass `{ _tag: \"bytes\", bytes, mimeType }` to use the inline path.',\n})\n\nconst decodeBase64ToBytes = (b64: string): Effect.Effect<Uint8Array, AiError.AiError> =>\n  Result.match(Encoding.decodeBase64(b64), {\n    onSuccess: Effect.succeed,\n    onFailure: (cause) =>\n      Effect.fail(\n        new AiError.InvalidRequest({ provider: \"elevenlabs\", param: \"audio\", raw: cause }),\n      ),\n  })\n\nconst bytesToBlob = (bytes: Uint8Array, mimeType: string): Blob =>\n  new Blob([bytes as Uint8Array<ArrayBuffer>], { type: mimeType })\n\nexport const audioToBlob: (audio: AudioSource) => Effect.Effect<Blob, AiError.AiError> =\n  Match.type<AudioSource>().pipe(\n    Match.tag(\"bytes\", (a) => Effect.succeed(bytesToBlob(a.bytes, a.mimeType))),\n    Match.tag(\"base64\", (a) =>\n      decodeBase64ToBytes(a.base64).pipe(Effect.map((bytes) => bytesToBlob(bytes, a.mimeType))),\n    ),\n    Match.tag(\"url\", () => Effect.fail(urlNotSupported)),\n    Match.exhaustive,\n  )\n\n// ---------------------------------------------------------------------------\n// MIME → file extension (for the multipart `filename` field)\n// ---------------------------------------------------------------------------\n\nconst EXTENSION_BY_MIME: ReadonlyArray<readonly [string, string]> = [\n  [\"mpeg\", \"mp3\"],\n  [\"mp3\", \"mp3\"],\n  [\"wav\", \"wav\"],\n  [\"ogg\", \"ogg\"],\n  [\"opus\", \"ogg\"],\n  [\"flac\", \"flac\"],\n  [\"aac\", \"aac\"],\n  [\"mp4\", \"m4a\"],\n  [\"m4a\", \"m4a\"],\n  [\"webm\", \"webm\"],\n]\n\nexport const defaultFileName = (mimeType: string): string =>\n  Arr.findFirst(EXTENSION_BY_MIME, ([pattern]) => mimeType.includes(pattern)).pipe(\n    Option.match({\n      onNone: () => \"audio\",\n      onSome: ([, ext]) => `audio.${ext}`,\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// HTTP errors\n// ---------------------------------------------------------------------------\n\nexport const httpStatusError: (status: number, body: string) => AiError.AiError = (status, body) =>\n  Match.value(status).pipe(\n    Match.when(\n      429,\n      (): AiError.AiError => new AiError.RateLimited({ provider: \"elevenlabs\", raw: body }),\n    ),\n    Match.whenOr(\n      408,\n      504,\n      (): AiError.AiError => new AiError.Timeout({ provider: \"elevenlabs\", raw: body }),\n    ),\n    Match.when(\n      401,\n      (): AiError.AiError =>\n        new AiError.AuthFailed({ provider: \"elevenlabs\", subtype: \"auth\", raw: body }),\n    ),\n    Match.when(\n      403,\n      (): AiError.AiError =>\n        new AiError.AuthFailed({ provider: \"elevenlabs\", subtype: \"permission\", raw: body }),\n    ),\n    Match.when(\n      402,\n      (): AiError.AiError =>\n        new AiError.AuthFailed({ provider: \"elevenlabs\", subtype: \"billing\", raw: body }),\n    ),\n    Match.when(\n      413,\n      (): AiError.AiError =>\n        new AiError.ContextLengthExceeded({ provider: \"elevenlabs\", raw: body }),\n    ),\n    Match.when(\n      (n) => n >= 500,\n      (n): AiError.AiError =>\n        new AiError.Unavailable({ provider: \"elevenlabs\", status: n, raw: body }),\n    ),\n    Match.orElse(\n      (): AiError.AiError => new AiError.InvalidRequest({ provider: \"elevenlabs\", raw: body }),\n    ),\n  )\n\nexport const transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"elevenlabs\", raw: cause })\n"],"mappings":"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"}

package/dist/codec.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/codec.test.mjs

@@ -0,0 +1,142 @@
+import { i as it, n as globalExpect, r as describe } from "./dist-DMsg8YLb.mjs";
+import { audioToBlob, defaultFileName, formatToOutputSlug, httpStatusError } from "./codec.mjs";
+import { Effect, Encoding } from "effect";
+//#region src/codec.test.ts
+describe("formatToOutputSlug", () => {
+	it("encodes mp3 with default bitrate when omitted", async () => {
+		globalExpect(await Effect.runPromise(formatToOutputSlug({
+			container: "mp3",
+			encoding: "mp3",
+			sampleRate: 44100
+		}))).toBe("mp3_44100_128");
+	});
+	it("honours an explicit mp3 bitrate", async () => {
+		globalExpect(await Effect.runPromise(formatToOutputSlug({
+			container: "mp3",
+			encoding: "mp3",
+			sampleRate: 22050,
+			bitRate: 32
+		}))).toBe("mp3_22050_32");
+	});
+	it("encodes raw pcm_s16le as `pcm_<sampleRate>`", async () => {
+		globalExpect(await Effect.runPromise(formatToOutputSlug({
+			container: "raw",
+			encoding: "pcm_s16le",
+			sampleRate: 16e3
+		}))).toBe("pcm_16000");
+	});
+	it("encodes mu-law as `ulaw_<sampleRate>`", async () => {
+		globalExpect(await Effect.runPromise(formatToOutputSlug({
+			container: "raw",
+			encoding: "pcm_mulaw",
+			sampleRate: 8e3
+		}))).toBe("ulaw_8000");
+	});
+	it("encodes opus with default bitrate", async () => {
+		globalExpect(await Effect.runPromise(formatToOutputSlug({
+			container: "opus",
+			encoding: "opus",
+			sampleRate: 48e3
+		}))).toBe("opus_48000_128");
+	});
+	it("encodes wav as `wav_<sampleRate>`", async () => {
+		globalExpect(await Effect.runPromise(formatToOutputSlug({
+			container: "wav",
+			encoding: "pcm_s16le",
+			sampleRate: 48e3
+		}))).toBe("wav_48000");
+	});
+	it("fails Unsupported for flac / aac / webm / ogg", async () => {
+		const exit = await Effect.runPromiseExit(formatToOutputSlug({
+			container: "flac",
+			encoding: "flac",
+			sampleRate: 44100
+		}));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("Unsupported");
+			globalExpect(JSON.stringify(exit.cause)).toContain("outputFormat");
+		}
+	});
+});
+describe("audioToBlob", () => {
+	it("wraps bytes into a Blob with the right MIME type", async () => {
+		const source = {
+			_tag: "bytes",
+			bytes: new Uint8Array([
+				1,
+				2,
+				3,
+				4
+			]),
+			mimeType: "audio/wav"
+		};
+		const blob = await Effect.runPromise(audioToBlob(source));
+		globalExpect(blob.type).toBe("audio/wav");
+		globalExpect(blob.size).toBe(4);
+	});
+	it("decodes a base64 source into bytes", async () => {
+		const original = new Uint8Array([
+			222,
+			173,
+			190,
+			239
+		]);
+		const source = {
+			_tag: "base64",
+			base64: Encoding.encodeBase64(original),
+			mimeType: "audio/mpeg"
+		};
+		const blob = await Effect.runPromise(audioToBlob(source));
+		globalExpect(blob.type).toBe("audio/mpeg");
+		globalExpect(blob.size).toBe(4);
+	});
+	it("fails InvalidRequest for url sources", async () => {
+		const exit = await Effect.runPromiseExit(audioToBlob({
+			_tag: "url",
+			url: "https://x/y.mp3",
+			mimeType: "audio/mpeg"
+		}));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("InvalidRequest");
+			globalExpect(JSON.stringify(exit.cause)).toContain("cloud_storage_url");
+		}
+	});
+});
+describe("defaultFileName", () => {
+	it("maps audio/mpeg → audio.mp3", () => {
+		globalExpect(defaultFileName("audio/mpeg")).toBe("audio.mp3");
+	});
+	it("maps audio/wav → audio.wav", () => {
+		globalExpect(defaultFileName("audio/wav")).toBe("audio.wav");
+	});
+	it("falls back to audio (no extension) for unknown MIME", () => {
+		globalExpect(defaultFileName("application/octet-stream")).toBe("audio");
+	});
+});
+describe("httpStatusError", () => {
+	const tags = (status) => JSON.parse(JSON.stringify(httpStatusError(status, "body")))._tag;
+	it("maps 429 to RateLimited", () => globalExpect(tags(429)).toBe("RateLimited"));
+	it("maps 408/504 to Timeout", () => {
+		globalExpect(tags(408)).toBe("Timeout");
+		globalExpect(tags(504)).toBe("Timeout");
+	});
+	it("maps 401/402/403 to AuthFailed", () => {
+		globalExpect(tags(401)).toBe("AuthFailed");
+		globalExpect(tags(402)).toBe("AuthFailed");
+		globalExpect(tags(403)).toBe("AuthFailed");
+	});
+	it("maps 5xx to Unavailable", () => {
+		globalExpect(tags(500)).toBe("Unavailable");
+		globalExpect(tags(503)).toBe("Unavailable");
+	});
+	it("maps other 4xx to InvalidRequest", () => {
+		globalExpect(tags(400)).toBe("InvalidRequest");
+		globalExpect(tags(404)).toBe("InvalidRequest");
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=codec.test.mjs.map

package/dist/codec.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.test.mjs","names":["expect"],"sources":["../src/codec.test.ts"],"sourcesContent":["import { Effect, Encoding } from \"effect\"\nimport { describe, expect, it } from \"vitest\"\nimport type { AudioSource } from \"@effect-uai/core/Audio\"\nimport { audioToBlob, defaultFileName, formatToOutputSlug, httpStatusError } from \"./codec.js\"\n\ndescribe(\"formatToOutputSlug\", () => {\n  it(\"encodes mp3 with default bitrate when omitted\", async () => {\n    const slug = await Effect.runPromise(\n      formatToOutputSlug({ container: \"mp3\", encoding: \"mp3\", sampleRate: 44100 }),\n    )\n    expect(slug).toBe(\"mp3_44100_128\")\n  })\n\n  it(\"honours an explicit mp3 bitrate\", async () => {\n    const slug = await Effect.runPromise(\n      formatToOutputSlug({ container: \"mp3\", encoding: \"mp3\", sampleRate: 22050, bitRate: 32 }),\n    )\n    expect(slug).toBe(\"mp3_22050_32\")\n  })\n\n  it(\"encodes raw pcm_s16le as `pcm_<sampleRate>`\", async () => {\n    const slug = await Effect.runPromise(\n      formatToOutputSlug({ container: \"raw\", encoding: \"pcm_s16le\", sampleRate: 16000 }),\n    )\n    expect(slug).toBe(\"pcm_16000\")\n  })\n\n  it(\"encodes mu-law as `ulaw_<sampleRate>`\", async () => {\n    const slug = await Effect.runPromise(\n      formatToOutputSlug({ container: \"raw\", encoding: \"pcm_mulaw\", sampleRate: 8000 }),\n    )\n    expect(slug).toBe(\"ulaw_8000\")\n  })\n\n  it(\"encodes opus with default bitrate\", async () => {\n    const slug = await Effect.runPromise(\n      formatToOutputSlug({ container: \"opus\", encoding: \"opus\", sampleRate: 48000 }),\n    )\n    expect(slug).toBe(\"opus_48000_128\")\n  })\n\n  it(\"encodes wav as `wav_<sampleRate>`\", async () => {\n    const slug = await Effect.runPromise(\n      formatToOutputSlug({ container: \"wav\", encoding: \"pcm_s16le\", sampleRate: 48000 }),\n    )\n    expect(slug).toBe(\"wav_48000\")\n  })\n\n  it(\"fails Unsupported for flac / aac / webm / ogg\", async () => {\n    const exit = await Effect.runPromiseExit(\n      formatToOutputSlug({ container: \"flac\", encoding: \"flac\", sampleRate: 44100 }),\n    )\n    expect(exit._tag).toBe(\"Failure\")\n    if (exit._tag === \"Failure\") {\n      expect(JSON.stringify(exit.cause)).toContain(\"Unsupported\")\n      expect(JSON.stringify(exit.cause)).toContain(\"outputFormat\")\n    }\n  })\n})\n\ndescribe(\"audioToBlob\", () => {\n  it(\"wraps bytes into a Blob with the right MIME type\", async () => {\n    const source: AudioSource = {\n      _tag: \"bytes\",\n      bytes: new Uint8Array([1, 2, 3, 4]),\n      mimeType: \"audio/wav\",\n    }\n    const blob = await Effect.runPromise(audioToBlob(source))\n    expect(blob.type).toBe(\"audio/wav\")\n    expect(blob.size).toBe(4)\n  })\n\n  it(\"decodes a base64 source into bytes\", async () => {\n    const original = new Uint8Array([0xde, 0xad, 0xbe, 0xef])\n    const source: AudioSource = {\n      _tag: \"base64\",\n      base64: Encoding.encodeBase64(original),\n      mimeType: \"audio/mpeg\",\n    }\n    const blob = await Effect.runPromise(audioToBlob(source))\n    expect(blob.type).toBe(\"audio/mpeg\")\n    expect(blob.size).toBe(4)\n  })\n\n  it(\"fails InvalidRequest for url sources\", async () => {\n    const source: AudioSource = { _tag: \"url\", url: \"https://x/y.mp3\", mimeType: \"audio/mpeg\" }\n    const exit = await Effect.runPromiseExit(audioToBlob(source))\n    expect(exit._tag).toBe(\"Failure\")\n    if (exit._tag === \"Failure\") {\n      expect(JSON.stringify(exit.cause)).toContain(\"InvalidRequest\")\n      expect(JSON.stringify(exit.cause)).toContain(\"cloud_storage_url\")\n    }\n  })\n})\n\ndescribe(\"defaultFileName\", () => {\n  it(\"maps audio/mpeg → audio.mp3\", () => {\n    expect(defaultFileName(\"audio/mpeg\")).toBe(\"audio.mp3\")\n  })\n  it(\"maps audio/wav → audio.wav\", () => {\n    expect(defaultFileName(\"audio/wav\")).toBe(\"audio.wav\")\n  })\n  it(\"falls back to audio (no extension) for unknown MIME\", () => {\n    expect(defaultFileName(\"application/octet-stream\")).toBe(\"audio\")\n  })\n})\n\ndescribe(\"httpStatusError\", () => {\n  const tags = (status: number) => JSON.parse(JSON.stringify(httpStatusError(status, \"body\")))._tag\n  it(\"maps 429 to RateLimited\", () => expect(tags(429)).toBe(\"RateLimited\"))\n  it(\"maps 408/504 to Timeout\", () => {\n    expect(tags(408)).toBe(\"Timeout\")\n    expect(tags(504)).toBe(\"Timeout\")\n  })\n  it(\"maps 401/402/403 to AuthFailed\", () => {\n    expect(tags(401)).toBe(\"AuthFailed\")\n    expect(tags(402)).toBe(\"AuthFailed\")\n    expect(tags(403)).toBe(\"AuthFailed\")\n  })\n  it(\"maps 5xx to Unavailable\", () => {\n    expect(tags(500)).toBe(\"Unavailable\")\n    expect(tags(503)).toBe(\"Unavailable\")\n  })\n  it(\"maps other 4xx to InvalidRequest\", () => {\n    expect(tags(400)).toBe(\"InvalidRequest\")\n    expect(tags(404)).toBe(\"InvalidRequest\")\n  })\n})\n"],"mappings":"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"}