@effect-uai/elevenlabs 0.6.0 → 0.8.0

package/dist/ElevenLabsMusicGenerator.d.mts

@@ -0,0 +1,75 @@
+import { ElevenLabsMusicModel } from "./models.mjs";
+import { t as ElevenLabsCompositionPlan } from "./musicCodec-CZni1gAQ.mjs";
+import { ElevenLabsRegion } from "./region.mjs";
+import { Context, Duration, Effect, Layer, Redacted, Stream } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, GenerateResult, MusicSessionInput, MusicStreamEvent } from "@effect-uai/core/Music";
+import { MusicGenerator } from "@effect-uai/core/MusicGenerator";
+import * as AiError from "@effect-uai/core/AiError";
+import { AudioChunk } from "@effect-uai/core/Audio";
+
+//#region src/ElevenLabsMusicGenerator.d.ts
+declare namespace ElevenLabsMusicGenerator_d_exports {
+  export { Config, CreateCompositionPlanRequest, ElevenLabsMusicGenerateRequest, ElevenLabsMusicGenerator, ElevenLabsMusicGeneratorService, layer, make };
+}
+/**
+ * ElevenLabs-typed music request. Narrows `model` to
+ * `ElevenLabsMusicModel` and adds provider-specific extras:
+ *
+ * - `compositionPlan` — switch from prompt mode to plan mode. Mutually
+ *   exclusive with `prompt` on the wire.
+ * - `forceInstrumental` — skip vocals. ElevenLabs has no `instrumental`
+ *   on the cross-provider Common request (the field was removed in
+ *   v0.7 because it has wildly different semantics per provider); the
+ *   typed surface restores it.
+ * - `signWithC2pa` — opt-in C2PA Content Credentials, MP3 output only.
+ * - `respectSectionsDurations` — composition-plan mode only. False
+ *   trades section-duration accuracy for quality + latency.
+ *
+ * Setting `compositionPlan` with a non-empty `prompt`, or with
+ * `duration`, fails `InvalidRequest` at the codec layer.
+ */
+type ElevenLabsMusicGenerateRequest = Omit<CommonGenerateMusicRequest, "model"> & {
+  readonly model?: ElevenLabsMusicModel;
+  readonly compositionPlan?: ElevenLabsCompositionPlan;
+  readonly forceInstrumental?: boolean;
+  readonly signWithC2pa?: boolean;
+  readonly respectSectionsDurations?: boolean;
+};
+type CreateCompositionPlanRequest = {
+  readonly prompt: string;
+  readonly duration?: Duration.Duration;
+  readonly sourceCompositionPlan?: ElevenLabsCompositionPlan;
+  readonly model?: ElevenLabsMusicModel;
+};
+type ElevenLabsMusicGeneratorService = {
+  readonly generate: (request: ElevenLabsMusicGenerateRequest) => Effect.Effect<GenerateResult, AiError.AiError>;
+  readonly streamGeneration: (request: ElevenLabsMusicGenerateRequest) => Stream.Stream<AudioChunk, AiError.AiError>;
+  readonly streamGenerationFrom: <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest) => Stream.Stream<MusicStreamEvent, AiError.AiError | E, R>;
+  /**
+   * Free endpoint (rate-limited, no credit cost): turn a prompt into a
+   * structured `MusicPrompt` plan. Feed the result back into
+   * `generate` / `streamGeneration` via `compositionPlan`.
+   */
+  readonly createCompositionPlan: (request: CreateCompositionPlanRequest) => Effect.Effect<ElevenLabsCompositionPlan, AiError.AiError>;
+};
+declare const ElevenLabsMusicGenerator_base: Context.ServiceClass<ElevenLabsMusicGenerator, "@betalyra/effect-uai/providers/elevenlabs/ElevenLabsMusicGenerator", ElevenLabsMusicGeneratorService>;
+declare class ElevenLabsMusicGenerator extends ElevenLabsMusicGenerator_base {}
+type Config = {
+  readonly apiKey: Redacted.Redacted;
+  readonly baseUrl?: string;
+  readonly region?: ElevenLabsRegion;
+};
+declare const make: (cfg: Config) => Effect.Effect<ElevenLabsMusicGeneratorService, never, HttpClient.HttpClient>;
+/**
+ * Layer that registers the provider-specific `ElevenLabsMusicGenerator`
+ * tag and the generic `MusicGenerator` tag.
+ *
+ * Does NOT register `MusicInteractiveSession`. ElevenLabs music has no
+ * bidirectional wire endpoint; `streamGenerationFrom` against this
+ * Layer alone fails to typecheck.
+ */
+declare const layer: (cfg: Config) => Layer.Layer<ElevenLabsMusicGenerator | MusicGenerator, never, HttpClient.HttpClient>;
+//#endregion
+export { Config, CreateCompositionPlanRequest, ElevenLabsMusicGenerateRequest, ElevenLabsMusicGenerator, ElevenLabsMusicGeneratorService, layer, make, ElevenLabsMusicGenerator_d_exports as t };
+//# sourceMappingURL=ElevenLabsMusicGenerator.d.mts.map

package/dist/ElevenLabsMusicGenerator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsMusicGenerator.d.mts","names":[],"sources":["../src/ElevenLabsMusicGenerator.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA;;;;;KAAY,8BAAA,GAAiC,IAAA,CAAK,0BAAA;EAAA,SACvC,KAAA,GAAQ,oBAAA;EAAA,SACR,eAAA,GAAkB,yBAAA;EAAA,SAClB,iBAAA;EAAA,SACA,YAAA;EAAA,SACA,wBAAA;AAAA;AAAA,KAGC,4BAAA;EAAA,SACD,MAAA;EAAA,SACA,QAAA,GAAW,QAAA,CAAS,QAAA;EAAA,SACpB,qBAAA,GAAwB,yBAAA;EAAA,SACxB,KAAA,GAAQ,oBAAA;AAAA;AAAA,KAGP,+BAAA;EAAA,SACD,QAAA,GACP,OAAA,EAAS,8BAAA,KACN,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,OAAA,CAAQ,OAAA;EAAA,SAClC,gBAAA,GACP,OAAA,EAAS,8BAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA;EAAA,SAC9B,oBAAA,SACP,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,gBAAA,EAAkB,OAAA,CAAQ,OAAA,GAAU,CAAA,EAAG,CAAA;;;;;;WAMjD,qBAAA,GACP,OAAA,EAAS,4BAAA,KACN,MAAA,CAAO,MAAA,CAAO,yBAAA,EAA2B,OAAA,CAAQ,OAAA;AAAA;AAAA,cACvD,6BAAA;cAEY,wBAAA,SAAiC,6BAAA;AAAA,KAKlC,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;AAAA,cA8NP,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,+BAAA,SAAwC,UAAA,CAAW,UAAA;AA7PpE;;;;;;;;AAAA,cAkRa,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,wBAAA,GAA2B,cAAA,SAAuB,UAAA,CAAW,UAAA"}

package/dist/ElevenLabsMusicGenerator.mjs

@@ -0,0 +1,191 @@
+import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
+import { defaultFormat, formatToOutputSlug } from "./codec.mjs";
+import { decodeCompositionPlan, warnDroppedPromptModeHints, wireCompositionPlan } from "./musicCodec.mjs";
+import { resolveHost } from "./region.mjs";
+import { Context, Duration, Effect, Layer, Redacted, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import { singleVariant } from "@effect-uai/core/Music";
+import { MusicGenerator } from "@effect-uai/core/MusicGenerator";
+import * as AiError from "@effect-uai/core/AiError";
+//#region src/ElevenLabsMusicGenerator.ts
+var ElevenLabsMusicGenerator_exports = /* @__PURE__ */ __exportAll({
+	ElevenLabsMusicGenerator: () => ElevenLabsMusicGenerator,
+	layer: () => layer,
+	make: () => make
+});
+var ElevenLabsMusicGenerator = class extends Context.Service()("@betalyra/effect-uai/providers/elevenlabs/ElevenLabsMusicGenerator") {};
+const DEFAULT_MODEL = "music_v1";
+const musicTransportFailure = (cause) => new AiError.Unavailable({
+	provider: "elevenlabs-music",
+	raw: cause
+});
+const musicHttpStatusError = (status, body) => {
+	if (status === 429) return new AiError.RateLimited({
+		provider: "elevenlabs-music",
+		raw: body
+	});
+	if (status === 408 || status === 504) return new AiError.Timeout({
+		provider: "elevenlabs-music",
+		raw: body
+	});
+	if (status === 401) return new AiError.AuthFailed({
+		provider: "elevenlabs-music",
+		subtype: "auth",
+		raw: body
+	});
+	if (status === 403) return new AiError.AuthFailed({
+		provider: "elevenlabs-music",
+		subtype: "permission",
+		raw: body
+	});
+	if (status === 402) return new AiError.AuthFailed({
+		provider: "elevenlabs-music",
+		subtype: "billing",
+		raw: body
+	});
+	if (status >= 500) return new AiError.Unavailable({
+		provider: "elevenlabs-music",
+		status,
+		raw: body
+	});
+	return new AiError.InvalidRequest({
+		provider: "elevenlabs-music",
+		raw: body
+	});
+};
+/**
+* Build the JSON body for `/v1/music` (sync + stream share the body).
+*
+* Mutual exclusion: `compositionPlan` and prompt-mode fields cannot
+* coexist. When `compositionPlan` is set, `prompt` must be empty and
+* `duration` must be unset (section durations live on the plan).
+*/
+const buildBody = (request) => Effect.gen(function* () {
+	const model = request.model ?? DEFAULT_MODEL;
+	if (request.compositionPlan !== void 0) {
+		if (request.prompt.length > 0) return yield* Effect.fail(new AiError.InvalidRequest({
+			provider: "elevenlabs-music",
+			param: "prompt",
+			raw: "`prompt` and `compositionPlan` are mutually exclusive. Pass one or the other (compositionPlan carries its own per-section lyrics and styles)."
+		}));
+		if (request.duration !== void 0) return yield* Effect.fail(new AiError.InvalidRequest({
+			provider: "elevenlabs-music",
+			param: "duration",
+			raw: "`duration` is ignored when `compositionPlan` is set; section durations live on the plan. Remove `duration`."
+		}));
+		return {
+			composition_plan: wireCompositionPlan(request.compositionPlan),
+			model_id: model,
+			...request.seed !== void 0 && { seed: request.seed },
+			...request.forceInstrumental !== void 0 && { force_instrumental: request.forceInstrumental },
+			...request.respectSectionsDurations !== void 0 && { respect_sections_durations: request.respectSectionsDurations },
+			...request.signWithC2pa !== void 0 && { sign_with_c2pa: request.signWithC2pa }
+		};
+	}
+	yield* warnDroppedPromptModeHints(request);
+	return {
+		prompt: request.prompt,
+		model_id: model,
+		...request.duration !== void 0 && { music_length_ms: Duration.toMillis(request.duration) },
+		...request.seed !== void 0 && { seed: request.seed },
+		...request.forceInstrumental !== void 0 && { force_instrumental: request.forceInstrumental },
+		...request.signWithC2pa !== void 0 && { sign_with_c2pa: request.signWithC2pa }
+	};
+});
+const buildMusicHttpRequest = (cfg, request, path) => Effect.gen(function* () {
+	const format = request.outputFormat ?? defaultFormat;
+	const slug = yield* formatToOutputSlug(format);
+	const body = yield* buildBody(request);
+	const url = `${resolveHost(cfg)}/music${path}?output_format=${slug}`;
+	return {
+		httpRequest: HttpClientRequest.post(url).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyJsonUnsafe(body)),
+		format
+	};
+});
+const generateImpl = (cfg) => (request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const { httpRequest, format } = yield* buildMusicHttpRequest(cfg, request, "");
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(musicTransportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return yield* Effect.fail(musicHttpStatusError(response.status, text));
+	}
+	const buffer = yield* response.arrayBuffer.pipe(Effect.mapError(musicTransportFailure));
+	const bytes = new Uint8Array(buffer);
+	const songId = response.headers["song_id"] ?? response.headers["x-song-id"];
+	return singleVariant({
+		audio: {
+			format,
+			bytes
+		},
+		provider: "elevenlabs-music",
+		...typeof songId === "string" && { songId },
+		...request.signWithC2pa === true && { watermark: "c2pa" }
+	});
+});
+const streamGenerationImpl = (cfg) => (request) => Stream.unwrap(Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const { httpRequest } = yield* buildMusicHttpRequest(cfg, request, "/stream");
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(musicTransportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return Stream.fail(musicHttpStatusError(response.status, text));
+	}
+	return response.stream.pipe(Stream.mapError(musicTransportFailure), Stream.map((bytes) => ({ bytes })));
+}));
+/**
+* ElevenLabs music has no bidirectional session at the wire level.
+* Layer does not register `MusicInteractiveSession`, so callers using
+* `MusicGenerator.streamGenerationFrom` get a compile-time error
+* before this runtime fallback fires.
+*/
+const streamGenerationFromUnsupported = (_input, _request) => Stream.fail(new AiError.Unsupported({
+	provider: "elevenlabs-music",
+	capability: "streamGenerationFrom",
+	reason: "ElevenLabs music has no bidirectional session. Use `streamGeneration` for chunked output, or `createCompositionPlan` + `generate` for structured plans."
+}));
+const createCompositionPlanImpl = (cfg) => (request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const body = {
+		prompt: request.prompt,
+		model_id: request.model ?? DEFAULT_MODEL,
+		...request.duration !== void 0 && { music_length_ms: Duration.toMillis(request.duration) },
+		...request.sourceCompositionPlan !== void 0 && { source_composition_plan: wireCompositionPlan(request.sourceCompositionPlan) }
+	};
+	const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/music/plan`).pipe(HttpClientRequest.setHeader("xi-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyJsonUnsafe(body));
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(musicTransportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return yield* Effect.fail(musicHttpStatusError(response.status, text));
+	}
+	return decodeCompositionPlan(yield* response.json.pipe(Effect.mapError(musicTransportFailure)));
+});
+const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({
+	generate: (request) => generateImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),
+	streamGeneration: (request) => streamGenerationImpl(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client)),
+	streamGenerationFrom: streamGenerationFromUnsupported,
+	createCompositionPlan: (request) => createCompositionPlanImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client))
+}));
+/**
+* Layer that registers the provider-specific `ElevenLabsMusicGenerator`
+* tag and the generic `MusicGenerator` tag.
+*
+* Does NOT register `MusicInteractiveSession`. ElevenLabs music has no
+* bidirectional wire endpoint; `streamGenerationFrom` against this
+* Layer alone fails to typecheck.
+*/
+const layer = (cfg) => Layer.merge(Layer.effect(ElevenLabsMusicGenerator, make(cfg)), Layer.effect(MusicGenerator, Effect.map(make(cfg), (s) => ({
+	generate: (req) => s.generate({
+		...req,
+		model: req.model
+	}),
+	streamGeneration: (req) => s.streamGeneration({
+		...req,
+		model: req.model
+	}),
+	streamGenerationFrom: s.streamGenerationFrom
+}))));
+//#endregion
+export { ElevenLabsMusicGenerator, layer, make, ElevenLabsMusicGenerator_exports as t };
+
+//# sourceMappingURL=ElevenLabsMusicGenerator.mjs.map

package/dist/ElevenLabsMusicGenerator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsMusicGenerator.mjs","names":[],"sources":["../src/ElevenLabsMusicGenerator.ts"],"sourcesContent":["import { Context, Duration, Effect, Layer, Redacted, Stream } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioChunk, AudioFormat } from \"@effect-uai/core/Audio\"\nimport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  GenerateResult,\n  MusicResult,\n  MusicSessionInput,\n  MusicStreamEvent,\n} from \"@effect-uai/core/Music\"\nimport { singleVariant } from \"@effect-uai/core/Music\"\nimport { MusicGenerator, type MusicGeneratorService } from \"@effect-uai/core/MusicGenerator\"\nimport { defaultFormat, formatToOutputSlug } from \"./codec.js\"\nimport type { ElevenLabsMusicModel } from \"./models.js\"\nimport {\n  decodeCompositionPlan,\n  type ElevenLabsCompositionPlan,\n  warnDroppedPromptModeHints,\n  wireCompositionPlan,\n} from \"./musicCodec.js\"\nimport { type ElevenLabsRegion, resolveHost } from \"./region.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * ElevenLabs-typed music request. Narrows `model` to\n * `ElevenLabsMusicModel` and adds provider-specific extras:\n *\n * - `compositionPlan` — switch from prompt mode to plan mode. Mutually\n *   exclusive with `prompt` on the wire.\n * - `forceInstrumental` — skip vocals. ElevenLabs has no `instrumental`\n *   on the cross-provider Common request (the field was removed in\n *   v0.7 because it has wildly different semantics per provider); the\n *   typed surface restores it.\n * - `signWithC2pa` — opt-in C2PA Content Credentials, MP3 output only.\n * - `respectSectionsDurations` — composition-plan mode only. False\n *   trades section-duration accuracy for quality + latency.\n *\n * Setting `compositionPlan` with a non-empty `prompt`, or with\n * `duration`, fails `InvalidRequest` at the codec layer.\n */\nexport type ElevenLabsMusicGenerateRequest = Omit<CommonGenerateMusicRequest, \"model\"> & {\n  readonly model?: ElevenLabsMusicModel\n  readonly compositionPlan?: ElevenLabsCompositionPlan\n  readonly forceInstrumental?: boolean\n  readonly signWithC2pa?: boolean\n  readonly respectSectionsDurations?: boolean\n}\n\nexport type CreateCompositionPlanRequest = {\n  readonly prompt: string\n  readonly duration?: Duration.Duration\n  readonly sourceCompositionPlan?: ElevenLabsCompositionPlan\n  readonly model?: ElevenLabsMusicModel\n}\n\nexport type ElevenLabsMusicGeneratorService = {\n  readonly generate: (\n    request: ElevenLabsMusicGenerateRequest,\n  ) => Effect.Effect<GenerateResult, AiError.AiError>\n  readonly streamGeneration: (\n    request: ElevenLabsMusicGenerateRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\n  readonly streamGenerationFrom: <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<MusicStreamEvent, AiError.AiError | E, R>\n  /**\n   * Free endpoint (rate-limited, no credit cost): turn a prompt into a\n   * structured `MusicPrompt` plan. Feed the result back into\n   * `generate` / `streamGeneration` via `compositionPlan`.\n   */\n  readonly createCompositionPlan: (\n    request: CreateCompositionPlanRequest,\n  ) => Effect.Effect<ElevenLabsCompositionPlan, AiError.AiError>\n}\n\nexport class ElevenLabsMusicGenerator extends Context.Service<\n  ElevenLabsMusicGenerator,\n  ElevenLabsMusicGeneratorService\n>()(\"@betalyra/effect-uai/providers/elevenlabs/ElevenLabsMusicGenerator\") {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  readonly region?: ElevenLabsRegion\n}\n\nconst DEFAULT_MODEL: ElevenLabsMusicModel = \"music_v1\"\n\n// ---------------------------------------------------------------------------\n// HTTP errors (music namespace; reuses the same status taxonomy)\n// ---------------------------------------------------------------------------\n\nconst musicTransportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"elevenlabs-music\", raw: cause })\n\nconst musicHttpStatusError = (status: number, body: string): AiError.AiError => {\n  if (status === 429) return new AiError.RateLimited({ provider: \"elevenlabs-music\", raw: body })\n  if (status === 408 || status === 504)\n    return new AiError.Timeout({ provider: \"elevenlabs-music\", raw: body })\n  if (status === 401)\n    return new AiError.AuthFailed({ provider: \"elevenlabs-music\", subtype: \"auth\", raw: body })\n  if (status === 403)\n    return new AiError.AuthFailed({\n      provider: \"elevenlabs-music\",\n      subtype: \"permission\",\n      raw: body,\n    })\n  if (status === 402)\n    return new AiError.AuthFailed({\n      provider: \"elevenlabs-music\",\n      subtype: \"billing\",\n      raw: body,\n    })\n  if (status >= 500)\n    return new AiError.Unavailable({ provider: \"elevenlabs-music\", status, raw: body })\n  return new AiError.InvalidRequest({ provider: \"elevenlabs-music\", raw: body })\n}\n\n// ---------------------------------------------------------------------------\n// Wire body\n// ---------------------------------------------------------------------------\n\n/**\n * Build the JSON body for `/v1/music` (sync + stream share the body).\n *\n * Mutual exclusion: `compositionPlan` and prompt-mode fields cannot\n * coexist. When `compositionPlan` is set, `prompt` must be empty and\n * `duration` must be unset (section durations live on the plan).\n */\nconst buildBody = (request: ElevenLabsMusicGenerateRequest) =>\n  Effect.gen(function* () {\n    const model = request.model ?? DEFAULT_MODEL\n    if (request.compositionPlan !== undefined) {\n      if (request.prompt.length > 0) {\n        return yield* Effect.fail(\n          new AiError.InvalidRequest({\n            provider: \"elevenlabs-music\",\n            param: \"prompt\",\n            raw: \"`prompt` and `compositionPlan` are mutually exclusive. Pass one or the other (compositionPlan carries its own per-section lyrics and styles).\",\n          }),\n        )\n      }\n      if (request.duration !== undefined) {\n        return yield* Effect.fail(\n          new AiError.InvalidRequest({\n            provider: \"elevenlabs-music\",\n            param: \"duration\",\n            raw: \"`duration` is ignored when `compositionPlan` is set; section durations live on the plan. Remove `duration`.\",\n          }),\n        )\n      }\n      return {\n        composition_plan: wireCompositionPlan(request.compositionPlan),\n        model_id: model,\n        ...(request.seed !== undefined && { seed: request.seed }),\n        ...(request.forceInstrumental !== undefined && {\n          force_instrumental: request.forceInstrumental,\n        }),\n        ...(request.respectSectionsDurations !== undefined && {\n          respect_sections_durations: request.respectSectionsDurations,\n        }),\n        ...(request.signWithC2pa !== undefined && { sign_with_c2pa: request.signWithC2pa }),\n      }\n    }\n    yield* warnDroppedPromptModeHints(request as CommonGenerateMusicRequest)\n    return {\n      prompt: request.prompt,\n      model_id: model,\n      ...(request.duration !== undefined && {\n        music_length_ms: Duration.toMillis(request.duration),\n      }),\n      ...(request.seed !== undefined && { seed: request.seed }),\n      ...(request.forceInstrumental !== undefined && {\n        force_instrumental: request.forceInstrumental,\n      }),\n      ...(request.signWithC2pa !== undefined && { sign_with_c2pa: request.signWithC2pa }),\n    }\n  })\n\nconst buildMusicHttpRequest = (\n  cfg: Config,\n  request: ElevenLabsMusicGenerateRequest,\n  path: \"\" | \"/stream\",\n) =>\n  Effect.gen(function* () {\n    const format: AudioFormat = request.outputFormat ?? defaultFormat\n    const slug = yield* formatToOutputSlug(format)\n    const body = yield* buildBody(request)\n    const url = `${resolveHost(cfg)}/music${path}?output_format=${slug}`\n    const httpRequest = HttpClientRequest.post(url).pipe(\n      HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    return { httpRequest, format }\n  })\n\n// ---------------------------------------------------------------------------\n// Service implementation\n// ---------------------------------------------------------------------------\n\nconst generateImpl =\n  (cfg: Config) =>\n  (\n    request: ElevenLabsMusicGenerateRequest,\n  ): Effect.Effect<GenerateResult, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const { httpRequest, format } = yield* buildMusicHttpRequest(cfg, request, \"\")\n      const response = yield* client\n        .execute(httpRequest)\n        .pipe(Effect.mapError(musicTransportFailure))\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return yield* Effect.fail(musicHttpStatusError(response.status, text))\n      }\n      const buffer = yield* response.arrayBuffer.pipe(Effect.mapError(musicTransportFailure))\n      const bytes = new Uint8Array(buffer)\n      const songId = response.headers[\"song_id\"] ?? response.headers[\"x-song-id\"]\n      const result: MusicResult = {\n        audio: { format, bytes },\n        provider: \"elevenlabs-music\",\n        ...(typeof songId === \"string\" && { songId }),\n        ...(request.signWithC2pa === true && { watermark: \"c2pa\" as const }),\n      }\n      return singleVariant(result)\n    })\n\nconst streamGenerationImpl =\n  (cfg: Config) =>\n  (\n    request: ElevenLabsMusicGenerateRequest,\n  ): Stream.Stream<AudioChunk, AiError.AiError, HttpClient.HttpClient> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const client = yield* HttpClient.HttpClient\n        const { httpRequest } = yield* buildMusicHttpRequest(cfg, request, \"/stream\")\n        const response = yield* client\n          .execute(httpRequest)\n          .pipe(Effect.mapError(musicTransportFailure))\n        if (response.status >= 400) {\n          const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n          return Stream.fail(musicHttpStatusError(response.status, text))\n        }\n        return response.stream.pipe(\n          Stream.mapError(musicTransportFailure),\n          Stream.map((bytes): AudioChunk => ({ bytes })),\n        )\n      }),\n    )\n\n/**\n * ElevenLabs music has no bidirectional session at the wire level.\n * Layer does not register `MusicInteractiveSession`, so callers using\n * `MusicGenerator.streamGenerationFrom` get a compile-time error\n * before this runtime fallback fires.\n */\nconst streamGenerationFromUnsupported = <E, R>(\n  _input: Stream.Stream<MusicSessionInput, E, R>,\n  _request: CommonStreamGenerateMusicRequest,\n): Stream.Stream<MusicStreamEvent, AiError.AiError | E, R> =>\n  Stream.fail(\n    new AiError.Unsupported({\n      provider: \"elevenlabs-music\",\n      capability: \"streamGenerationFrom\",\n      reason:\n        \"ElevenLabs music has no bidirectional session. Use `streamGeneration` for chunked output, or `createCompositionPlan` + `generate` for structured plans.\",\n    }),\n  )\n\nconst createCompositionPlanImpl =\n  (cfg: Config) =>\n  (\n    request: CreateCompositionPlanRequest,\n  ): Effect.Effect<ElevenLabsCompositionPlan, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const body = {\n        prompt: request.prompt,\n        model_id: request.model ?? DEFAULT_MODEL,\n        ...(request.duration !== undefined && {\n          music_length_ms: Duration.toMillis(request.duration),\n        }),\n        ...(request.sourceCompositionPlan !== undefined && {\n          source_composition_plan: wireCompositionPlan(request.sourceCompositionPlan),\n        }),\n      }\n      const httpRequest = HttpClientRequest.post(`${resolveHost(cfg)}/music/plan`).pipe(\n        HttpClientRequest.setHeader(\"xi-api-key\", Redacted.value(cfg.apiKey)),\n        HttpClientRequest.bodyJsonUnsafe(body),\n      )\n      const response = yield* client\n        .execute(httpRequest)\n        .pipe(Effect.mapError(musicTransportFailure))\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return yield* Effect.fail(musicHttpStatusError(response.status, text))\n      }\n      const json = yield* response.json.pipe(Effect.mapError(musicTransportFailure))\n      return decodeCompositionPlan(json)\n    })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport const make = (\n  cfg: Config,\n): Effect.Effect<ElevenLabsMusicGeneratorService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({\n    generate: (request) =>\n      generateImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n    streamGeneration: (request) =>\n      streamGenerationImpl(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client)),\n    streamGenerationFrom: streamGenerationFromUnsupported,\n    createCompositionPlan: (request) =>\n      createCompositionPlanImpl(cfg)(request).pipe(\n        Effect.provideService(HttpClient.HttpClient, client),\n      ),\n  }))\n\n/**\n * Layer that registers the provider-specific `ElevenLabsMusicGenerator`\n * tag and the generic `MusicGenerator` tag.\n *\n * Does NOT register `MusicInteractiveSession`. ElevenLabs music has no\n * bidirectional wire endpoint; `streamGenerationFrom` against this\n * Layer alone fails to typecheck.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<ElevenLabsMusicGenerator | MusicGenerator, never, HttpClient.HttpClient> =>\n  Layer.merge(\n    Layer.effect(ElevenLabsMusicGenerator, make(cfg)),\n    Layer.effect(\n      MusicGenerator,\n      Effect.map(\n        make(cfg),\n        (s): MusicGeneratorService => ({\n          generate: (req: CommonGenerateMusicRequest) =>\n            s.generate({ ...req, model: req.model as ElevenLabsMusicModel }),\n          streamGeneration: (req: CommonStreamGenerateMusicRequest) =>\n            s.streamGeneration({ ...req, model: req.model as ElevenLabsMusicModel }),\n          streamGenerationFrom: s.streamGenerationFrom,\n        }),\n      ),\n    ),\n  )\n"],"mappings":"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"}

package/dist/ElevenLabsMusicGenerator.test.mjs

@@ -0,0 +1,98 @@
+import { i as it, n as globalExpect, r as describe, t as import_dist } from "./dist-DMsg8YLb.mjs";
+import { ElevenLabsMusicGenerator, layer } from "./ElevenLabsMusicGenerator.mjs";
+import { Duration, Effect, Layer, Redacted, Stream } from "effect";
+import { FetchHttpClient } from "effect/unstable/http";
+import { promptsInput } from "@effect-uai/core/Music";
+import * as MusicGenerator$1 from "@effect-uai/core/MusicGenerator";
+//#region src/ElevenLabsMusicGenerator.test.ts
+const cfg = { apiKey: Redacted.make("test-key") };
+const live = Layer.provide(layer(cfg), FetchHttpClient.layer);
+describe("ElevenLabsMusicGenerator capability guards (runtime)", () => {
+	it("streamGenerationFrom returns an Unsupported stream", async () => {
+		const program = ElevenLabsMusicGenerator.use((s) => Stream.runDrain(s.streamGenerationFrom(Stream.fromIterable([promptsInput([{ text: "x" }])]), {
+			model: "music_v1",
+			prompt: ""
+		})));
+		const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("Unsupported");
+			globalExpect(JSON.stringify(exit.cause)).toContain("streamGenerationFrom");
+		}
+	});
+});
+describe("ElevenLabsMusicGenerator Layer (compile-time)", () => {
+	it("leaves `MusicInteractiveSession` unsatisfied via the generic surface", () => {
+		const events = Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(MusicGenerator$1.streamGenerationFrom({
+			model: "music_v1",
+			prompt: ""
+		}));
+		(0, import_dist.expectTypeOf)(Stream.runDrain(events).pipe(Effect.provide(live))).toEqualTypeOf();
+	});
+	it("sync `generate` returns GenerateResult and requires no marker", () => {
+		(0, import_dist.expectTypeOf)(MusicGenerator$1.generate({
+			model: "music_v1",
+			prompt: "house"
+		}).pipe(Effect.provide(live))).toEqualTypeOf();
+	});
+	it("typed request accepts compositionPlan, forceInstrumental, signWithC2pa", () => {
+		globalExpect({
+			model: "music_v1",
+			prompt: "",
+			compositionPlan: {
+				positiveGlobalStyles: ["lo-fi", "warm"],
+				negativeGlobalStyles: ["distorted"],
+				sections: [{
+					sectionName: "Intro",
+					positiveLocalStyles: ["piano"],
+					negativeLocalStyles: [],
+					duration: Duration.seconds(15),
+					lines: []
+				}]
+			},
+			forceInstrumental: true,
+			signWithC2pa: true
+		}).toBeDefined();
+	});
+});
+describe("ElevenLabsMusicGenerator codec validation (runtime, no HTTP)", () => {
+	it("rejects compositionPlan + non-empty prompt", async () => {
+		const program = ElevenLabsMusicGenerator.use((s) => s.generate({
+			model: "music_v1",
+			prompt: "house",
+			compositionPlan: {
+				positiveGlobalStyles: [],
+				negativeGlobalStyles: [],
+				sections: []
+			}
+		}));
+		const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("InvalidRequest");
+			globalExpect(JSON.stringify(exit.cause)).toContain("mutually exclusive");
+		}
+	});
+	it("rejects compositionPlan + duration", async () => {
+		const program = ElevenLabsMusicGenerator.use((s) => s.generate({
+			model: "music_v1",
+			prompt: "",
+			duration: Duration.seconds(30),
+			compositionPlan: {
+				positiveGlobalStyles: [],
+				negativeGlobalStyles: [],
+				sections: []
+			}
+		}));
+		const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("InvalidRequest");
+			globalExpect(JSON.stringify(exit.cause)).toContain("`duration` is ignored");
+		}
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=ElevenLabsMusicGenerator.test.mjs.map

package/dist/ElevenLabsMusicGenerator.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsMusicGenerator.test.mjs","names":["ElevenLabsMusicGenerator.layer","MusicGenerator"],"sources":["../src/ElevenLabsMusicGenerator.test.ts"],"sourcesContent":["import { Duration, Effect, Layer, Redacted, Stream } from \"effect\"\nimport { FetchHttpClient } from \"effect/unstable/http\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport type * as AiError from \"@effect-uai/core/AiError\"\nimport type { GenerateResult } from \"@effect-uai/core/Music\"\nimport { promptsInput } from \"@effect-uai/core/Music\"\nimport * as MusicGenerator from \"@effect-uai/core/MusicGenerator\"\nimport * as ElevenLabsMusicGenerator from \"./ElevenLabsMusicGenerator.js\"\n\nconst cfg: ElevenLabsMusicGenerator.Config = { apiKey: Redacted.make(\"test-key\") }\nconst live = Layer.provide(ElevenLabsMusicGenerator.layer(cfg), FetchHttpClient.layer)\n\ndescribe(\"ElevenLabsMusicGenerator capability guards (runtime)\", () => {\n  it(\"streamGenerationFrom returns an Unsupported stream\", async () => {\n    const program = ElevenLabsMusicGenerator.ElevenLabsMusicGenerator.use((s) =>\n      Stream.runDrain(\n        s.streamGenerationFrom(Stream.fromIterable([promptsInput([{ text: \"x\" }])]), {\n          model: \"music_v1\",\n          prompt: \"\",\n        }),\n      ),\n    )\n    const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)))\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(\"streamGenerationFrom\")\n    }\n  })\n})\n\ndescribe(\"ElevenLabsMusicGenerator Layer (compile-time)\", () => {\n  it(\"leaves `MusicInteractiveSession` unsatisfied via the generic surface\", () => {\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(\n      MusicGenerator.streamGenerationFrom({ model: \"music_v1\", prompt: \"\" }),\n    )\n    const provided = Stream.runDrain(events).pipe(Effect.provide(live))\n    expectTypeOf(provided).toEqualTypeOf<\n      Effect.Effect<void, AiError.AiError, MusicGenerator.MusicInteractiveSession>\n    >()\n  })\n\n  it(\"sync `generate` returns GenerateResult and requires no marker\", () => {\n    const gen = MusicGenerator.generate({ model: \"music_v1\", prompt: \"house\" }).pipe(\n      Effect.provide(live),\n    )\n    expectTypeOf(gen).toEqualTypeOf<Effect.Effect<GenerateResult, AiError.AiError, never>>()\n  })\n\n  it(\"typed request accepts compositionPlan, forceInstrumental, signWithC2pa\", () => {\n    const _req: ElevenLabsMusicGenerator.ElevenLabsMusicGenerateRequest = {\n      model: \"music_v1\",\n      prompt: \"\",\n      compositionPlan: {\n        positiveGlobalStyles: [\"lo-fi\", \"warm\"],\n        negativeGlobalStyles: [\"distorted\"],\n        sections: [\n          {\n            sectionName: \"Intro\",\n            positiveLocalStyles: [\"piano\"],\n            negativeLocalStyles: [],\n            duration: Duration.seconds(15),\n            lines: [],\n          },\n        ],\n      },\n      forceInstrumental: true,\n      signWithC2pa: true,\n    }\n    expect(_req).toBeDefined()\n  })\n})\n\ndescribe(\"ElevenLabsMusicGenerator codec validation (runtime, no HTTP)\", () => {\n  it(\"rejects compositionPlan + non-empty prompt\", async () => {\n    const program = ElevenLabsMusicGenerator.ElevenLabsMusicGenerator.use((s) =>\n      s.generate({\n        model: \"music_v1\",\n        prompt: \"house\",\n        compositionPlan: {\n          positiveGlobalStyles: [],\n          negativeGlobalStyles: [],\n          sections: [],\n        },\n      }),\n    )\n    const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)))\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(\"mutually exclusive\")\n    }\n  })\n\n  it(\"rejects compositionPlan + duration\", async () => {\n    const program = ElevenLabsMusicGenerator.ElevenLabsMusicGenerator.use((s) =>\n      s.generate({\n        model: \"music_v1\",\n        prompt: \"\",\n        duration: Duration.seconds(30),\n        compositionPlan: {\n          positiveGlobalStyles: [],\n          negativeGlobalStyles: [],\n          sections: [],\n        },\n      }),\n    )\n    const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)))\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(\"`duration` is ignored\")\n    }\n  })\n})\n"],"mappings":"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"}

package/dist/ElevenLabsSynthesizer.d.mts

@@ -1,11 +1,11 @@
-import { VoiceSettings } from "./codec.mjs";
 import { ElevenLabsTtsModel, ElevenLabsVoiceId } from "./models.mjs";
 import { ElevenLabsRegion } from "./region.mjs";
+import { PronunciationDictionaryLocator, VoiceSettings } from "./codec.mjs";
 import { Context, Effect, Layer, Redacted, Stream } from "effect";
 import { HttpClient } from "effect/unstable/http";
+import * as AiError from "@effect-uai/core/AiError";
 import * as Socket from "effect/unstable/socket/Socket";
 import { CommonSynthesizeRequest, SpeechSynthesizerService } from "@effect-uai/core/SpeechSynthesizer";
-import * as AiError from "@effect-uai/core/AiError";
 import { AudioBlob, AudioChunk } from "@effect-uai/core/Audio";
 
 //#region src/ElevenLabsSynthesizer.d.ts
@@ -17,6 +17,11 @@ declare namespace ElevenLabsSynthesizer_d_exports {
  * provider's prosody/timbre controls; `seed` makes generation
  * deterministic; `previousText` / `nextText` thread context across
  * sequential calls for natural prosody.
+ *
+ * `pronunciationDictionaryLocators` references pre-provisioned
+ * pronunciation dictionaries by ID. Inline `pronunciations` (IPA) on
+ * the Common request are not supported by ElevenLabs and fail
+ * `Unsupported`; use a dictionary for phonetic control.
  */
 type ElevenLabsSynthesizeRequest = Omit<CommonSynthesizeRequest, "model" | "voiceId"> & {
   readonly model: ElevenLabsTtsModel;
@@ -25,6 +30,7 @@ type ElevenLabsSynthesizeRequest = Omit<CommonSynthesizeRequest, "model" | "voic
   readonly seed?: number;
   readonly previousText?: string;
   readonly nextText?: string;
+  readonly pronunciationDictionaryLocators?: ReadonlyArray<PronunciationDictionaryLocator>;
 };
 type ElevenLabsSynthesizerService = {
   readonly synthesize: (r: ElevenLabsSynthesizeRequest) => Effect.Effect<AudioBlob, AiError.AiError>;
@@ -46,7 +52,7 @@ declare const make: (cfg: Config) => Effect.Effect<{
   streamSynthesisFrom: (textIn: any, request: any) => Stream.Stream<AudioChunk, any, unknown>;
   synthesizeDialogue: (request: any) => Effect.Effect<any, any, never>;
   streamSynthesizeDialogue: (request: any) => Stream.Stream<AudioChunk, any, never>;
-}, never, Socket.WebSocketConstructor | HttpClient.HttpClient>;
+}, never, HttpClient.HttpClient | Socket.WebSocketConstructor>;
 /**
  * Layer registers `ElevenLabsSynthesizer`, the generic
  * `SpeechSynthesizer`, the `TtsIncrementalText` marker (incremental
@@ -56,7 +62,7 @@ declare const make: (cfg: Config) => Effect.Effect<{
  * `Socket.layerWebSocketConstructorGlobal` and an `HttpClient` Layer
  * at the call site.
  */
-declare const layer: (cfg: Config) => Layer.Layer<unknown, never, Socket.WebSocketConstructor | HttpClient.HttpClient>;
+declare const layer: (cfg: Config) => Layer.Layer<unknown, never, HttpClient.HttpClient | Socket.WebSocketConstructor>;
 //#endregion
 export { Config, ElevenLabsSynthesizeRequest, ElevenLabsSynthesizer, ElevenLabsSynthesizerService, layer, make, ElevenLabsSynthesizer_d_exports as t };
 //# sourceMappingURL=ElevenLabsSynthesizer.d.mts.map

package/dist/ElevenLabsSynthesizer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ElevenLabsSynthesizer.d.mts","names":[],"sources":["../src/ElevenLabsSynthesizer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;KAqCY,2BAAA,GAA8B,IAAA,CAAK,uBAAA;EAAA,SACpC,KAAA,EAAO,kBAAA;EAAA,SACP,OAAA,EAAS,iBAAA;EAAA,SACT,aAAA,GAAgB,aAAA;EAAA,SAChB,IAAA;EAAA,SACA,YAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGC,4BAAA;EAAA,SACD,UAAA,GAAa,CAAA,EAAG,2BAAA,KAAgC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EAAA,SACjF,eAAA,GACP,CAAA,EAAG,2BAAA,KACA,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA;EAAA,SAC9B,mBAAA,EAAqB,wBAAA;EAAA,SACrB,kBAAA,EAAoB,wBAAA;EAAA,SACpB,wBAAA,EAA0B,wBAAA;AAAA;AAAA,cACpC,0BAAA;cAEY,qBAAA,SAA8B,0BAAA;AAAA,KAK/B,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;AAAA,cA+KP,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;cAiCnB,KAAA,GAAS,GAAA,EAAK,MAAA,KAAM,KAAA,CAAA,KAAA,iBAAA,MAAA,CAAA,oBAAA,GAAA,UAAA,CAAA,UAAA"}
+{"version":3,"file":"ElevenLabsSynthesizer.d.mts","names":[],"sources":["../src/ElevenLabsSynthesizer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;KA4CY,2BAAA,GAA8B,IAAA,CAAK,uBAAA;EAAA,SACpC,KAAA,EAAO,kBAAA;EAAA,SACP,OAAA,EAAS,iBAAA;EAAA,SACT,aAAA,GAAgB,aAAA;EAAA,SAChB,IAAA;EAAA,SACA,YAAA;EAAA,SACA,QAAA;EAAA,SACA,+BAAA,GAAkC,aAAA,CAAc,8BAAA;AAAA;AAAA,KAG/C,4BAAA;EAAA,SACD,UAAA,GAAa,CAAA,EAAG,2BAAA,KAAgC,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,OAAA,CAAQ,OAAA;EAAA,SACjF,eAAA,GACP,CAAA,EAAG,2BAAA,KACA,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA;EAAA,SAC9B,mBAAA,EAAqB,wBAAA;EAAA,SACrB,kBAAA,EAAoB,wBAAA;EAAA,SACpB,wBAAA,EAA0B,wBAAA;AAAA;AAAA,cACpC,0BAAA;cAEY,qBAAA,SAA8B,0BAAA;AAAA,KAK/B,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;EAAA,SACA,MAAA,GAAS,gBAAA;AAAA;AAAA,cAqIP,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAM,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;;cAiCnB,KAAA,GAAS,GAAA,EAAK,MAAA,KAAM,KAAA,CAAA,KAAA,iBAAA,UAAA,CAAA,UAAA,GAAA,MAAA,CAAA,oBAAA"}

package/dist/ElevenLabsSynthesizer.mjs

@@ -1,8 +1,8 @@
 import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
-import { defaultFormat, formatToOutputSlug, httpStatusError, transportFailure, wireVoiceSettings } from "./codec.mjs";
+import { defaultFormat, formatToOutputSlug, httpStatusError, rejectInlinePronunciations, transportFailure, wirePronunciationLocators, wireVoiceSettings } from "./codec.mjs";
 import { resolveHost } from "./region.mjs";
 import { streamSynthesis } from "./realtimeTts.mjs";
-import { Array, Context, Effect, Layer, Redacted, Stream } from "effect";
+import { Context, Effect, Layer, Redacted, Stream } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as Socket from "effect/unstable/socket/Socket";
 import { MultiSpeakerTts, SpeechSynthesizer, TtsIncrementalText } from "@effect-uai/core/SpeechSynthesizer";
@@ -13,49 +13,21 @@ var ElevenLabsSynthesizer_exports = /* @__PURE__ */ __exportAll({
 	make: () => make
 });
 var ElevenLabsSynthesizer = class extends Context.Service()("@betalyra/effect-uai/providers/elevenlabs/ElevenLabsSynthesizer") {};
-/**
-* Models that honor inline `<phoneme>` SSML tags. Other models silently
-* drop the tags server-side, so we don't bother rewriting the text for
-* them — the pronunciation overrides are silently ignored.
-*
-* Reference: https://elevenlabs.io/docs/best-practices/prompting/controls
-*/
-const PHONEME_SUPPORTED_MODELS = new Set([
-	"eleven_flash_v2",
-	"eleven_english_v1",
-	"eleven_monolingual_v1"
-]);
-const wireAlphabet = (encoding) => encoding === "ipa" ? "ipa" : encoding === "cmu-arpabet" ? "cmu-arpabet" : void 0;
-const phonemeTag = (phrase, pronunciation, alphabet) => `<phoneme alphabet="${alphabet}" ph="${pronunciation}">${phrase}</phoneme>`;
-const escapeForRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-/**
-* Apply pronunciation overrides to a text string. Only applies for
-* phoneme-supported models; only IPA and CMU Arpabet are honored
-* (x-sampa is silently dropped). Whole-word, case-insensitive
-* replacement.
-*/
-const applyPronunciations = (text, model, pronunciations) => {
-	if (pronunciations === void 0 || !PHONEME_SUPPORTED_MODELS.has(model)) return text;
-	return Array.reduce(pronunciations, text, (acc, p) => {
-		const alphabet = wireAlphabet(p.encoding);
-		if (alphabet === void 0) return acc;
-		return acc.replace(new RegExp(`\\b${escapeForRegex(p.phrase)}\\b`, "i"), phonemeTag(p.phrase, p.pronunciation, alphabet));
-	});
-};
 const buildBody = (r) => ({
-	text: applyPronunciations(r.text, r.model, r.pronunciations),
+	text: r.text,
 	model_id: r.model,
 	...r.languageCode !== void 0 && { language_code: r.languageCode },
 	...r.seed !== void 0 && { seed: r.seed },
 	...r.previousText !== void 0 && { previous_text: r.previousText },
 	...r.nextText !== void 0 && { next_text: r.nextText },
+	...wirePronunciationLocators(r.pronunciationDictionaryLocators),
 	...r.voiceSettings !== void 0 && { voice_settings: wireVoiceSettings(r.voiceSettings) }
 });
 const DEFAULT_DIALOGUE_MODEL = "eleven_v3";
 const buildDialogueBody = (r) => ({
 	inputs: r.turns.map((t) => ({
 		voice_id: t.voiceId,
-		text: applyPronunciations(t.text, r.model, r.pronunciations)
+		text: t.text
 	})),
 	model_id: r.model ?? DEFAULT_DIALOGUE_MODEL,
 	...r.languageCode !== void 0 && { language_code: r.languageCode }
@@ -70,6 +42,7 @@ const buildDialogueHttpRequest = (cfg, r, path) => Effect.gen(function* () {
 	};
 });
 const synthesizeDialogueImpl = (cfg) => (request) => Effect.gen(function* () {
+	yield* rejectInlinePronunciations(request.pronunciations);
 	const client = yield* HttpClient.HttpClient;
 	const { httpRequest, format } = yield* buildDialogueHttpRequest(cfg, request, "");
 	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
@@ -84,6 +57,7 @@ const synthesizeDialogueImpl = (cfg) => (request) => Effect.gen(function* () {
 	};
 });
 const streamSynthesizeDialogueImpl = (cfg) => (request) => Stream.unwrap(Effect.gen(function* () {
+	yield* rejectInlinePronunciations(request.pronunciations);
 	const client = yield* HttpClient.HttpClient;
 	const { httpRequest } = yield* buildDialogueHttpRequest(cfg, request, "/stream");
 	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
@@ -103,6 +77,7 @@ const buildHttpRequest = (cfg, r, path) => Effect.gen(function* () {
 	};
 });
 const synthesizeImpl = (cfg) => (request) => Effect.gen(function* () {
+	yield* rejectInlinePronunciations(request.pronunciations);
 	const client = yield* HttpClient.HttpClient;
 	const { httpRequest, format } = yield* buildHttpRequest(cfg, request, "");
 	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
@@ -117,6 +92,7 @@ const synthesizeImpl = (cfg) => (request) => Effect.gen(function* () {
 	};
 });
 const streamSynthesisImpl = (cfg) => (request) => Stream.unwrap(Effect.gen(function* () {
+	yield* rejectInlinePronunciations(request.pronunciations);
 	const client = yield* HttpClient.HttpClient;
 	const { httpRequest } = yield* buildHttpRequest(cfg, request, "/stream");
 	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));