@ssml-builder-js/azure-tts-client 2.11.0 → 2.13.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ssml-builder-js/azure-tts-client
 
+## 2.13.0
+
+### Minor Changes
+
+- Add structured SSML chunk metadata and background-audio replication policies, merged synthesis synchronization offsets, safe preflight synthesis with custom URL validation, chunk progress reporting, source tracking, and extensible Japanese-localized Visual Editor controls.
+
+### Patch Changes
+
+- Updated dependencies
+  - @ssml-builder-js/ssml-core@2.13.0
+
+## 2.12.0
+
+### Minor Changes
+
+- Add `synthesizeSsml` and `SsmlSynthesisResult` for word boundaries, visemes, bookmarks, and duration metadata.
+
 ## 2.11.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { SsmlDiagnostic, AzureValidationOptions } from '@ssml-builder-js/ssml-core';
+
 interface TtsConfig {
     signal?: AbortSignal;
     timeoutMs?: number;
@@ -5,6 +7,79 @@ interface TtsConfig {
     subscriptionKey: string;
     region: string;
     outputFormat?: string;
+    /** Original plain-text range represented by this synthesis request. */
+    sourceTextRange?: {
+        start: number;
+        end: number;
+    };
+    /** Reports completion of a chunk when using synthesizeSsmlChunks. */
+    onProgress?: (event: {
+        currentChunk: number;
+        totalChunks: number;
+        percent: number;
+    }) => void;
+}
+interface SsmlSynthesisBoundary {
+    text: string;
+    audioOffsetMs: number;
+    durationMs: number;
+    textRange?: {
+        start: number;
+        end: number;
+    };
+    requestId?: string;
+}
+interface SsmlSynthesisViseme {
+    visemeId: number;
+    audioOffsetMs: number;
+    textRange?: {
+        start: number;
+        end: number;
+    };
+    requestId?: string;
+}
+interface SsmlSynthesisBookmark {
+    name: string;
+    audioOffsetMs: number;
+    textRange?: {
+        start: number;
+        end: number;
+    };
+    requestId?: string;
+}
+/** Audio and Azure Speech synchronization events emitted for one SSML request. */
+interface SsmlSynthesisResult {
+    audioData: ArrayBuffer;
+    durationMs: number;
+    boundaries?: SsmlSynthesisBoundary[];
+    /** Alias matching the Azure Speech event name. */
+    wordBoundary?: SsmlSynthesisBoundary[];
+    /** Alias for consumers that use Azure's word-boundary terminology. */
+    wordBoundaries?: SsmlSynthesisBoundary[];
+    visemes?: SsmlSynthesisViseme[];
+    bookmarks?: SsmlSynthesisBookmark[];
+    /** Request identifier returned by Azure Speech, when available. */
+    requestId?: string;
+    /** Original plain-text range represented by the result. */
+    textRange?: {
+        start: number;
+        end: number;
+    };
+}
+interface SsmlSynthesisChunk {
+    ssml: string;
+    originalTextRange?: {
+        start: number;
+        end: number;
+    };
+}
+interface SynthesizeChunksOptions {
+    onProgress?: (event: SynthesisProgressEvent) => void;
+}
+interface SynthesisProgressEvent {
+    currentChunk: number;
+    totalChunks: number;
+    percent: number;
 }
 interface AzureTtsLogger {
     debug?: (...args: unknown[]) => void;
@@ -20,6 +95,7 @@ interface AzureTtsClientOptions {
     endpoint?: string;
     outputFormat?: string;
     logger?: AzureTtsLogger;
+    onProgress?: (event: SynthesisProgressEvent) => void;
 }
 
 declare class AzureTtsError extends Error {
@@ -34,12 +110,58 @@ declare class AzureTtsSdkError extends AzureTtsError {
     constructor(errorDetails: string);
 }
 
+interface SsmlValidationError {
+    readonly kind: "validation";
+    readonly message: string;
+    readonly diagnostics: readonly SsmlDiagnostic[];
+}
+type Result<T, E> = {
+    readonly ok: true;
+    readonly success: true;
+    readonly status: "success";
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly success: false;
+    readonly status: "validation-error" | "azure-api-error";
+    readonly error: E;
+};
+type SynthesisResult<T, E> = Result<T, E>;
+type Success<T> = Extract<Result<T, never>, {
+    readonly ok: true;
+}>;
+type ValidationErrorResult = Extract<Result<never, SsmlValidationError>, {
+    readonly status: "validation-error";
+}>;
+type AzureApiErrorResult = Extract<Result<never, AzureTtsError>, {
+    readonly status: "azure-api-error";
+}>;
+type SsmlSynthesisSafeResult = Result<SsmlSynthesisResult, never> | Result<never, SsmlValidationError> | Result<never, AzureTtsError>;
+interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
+    /** Optional nested form for callers that want to keep validation settings grouped. */
+    validation?: AzureValidationOptions;
+}
+interface SynthesisClient {
+    synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
+}
+/** Validates SSML before invoking Azure and converts validation/API failures to one result shape. */
+declare function synthesizeSsmlSafe(client: Pick<AzureTtsClient, "synthesizeSsml"> | SynthesisClient, ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
+
 declare class AzureTtsClient {
     #private;
     constructor(options: AzureTtsClientOptions);
     synthesize(ssml: string): Promise<ArrayBuffer>;
+    synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
+    synthesizeChunks(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
+    synthesizeSsmlSafe(ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
 }
 
+declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult>;
+/** Synthesizes chunks sequentially, annotates synchronization events, and merges the results. */
+declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
+/** Concatenates audio buffers and shifts all synchronization events by prior chunk durations. */
+declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[]): SsmlSynthesisResult;
+/** Backward-compatible audio-only synthesis helper. */
 declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
 
 interface FetchAzureVoiceCatalogOptions {
@@ -67,4 +189,4 @@ interface AzureVoiceCatalog {
 /** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */
 declare function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog>;
 
-export { AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type TtsConfig, fetchAzureVoiceCatalog, synthesizeSpeech };
+export { type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type Result, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, type SynthesisProgressEvent, type SynthesisResult, type SynthesizeChunksOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, type ValidationErrorResult, fetchAzureVoiceCatalog, mergeSynthesisResults, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlSafe };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { SsmlDiagnostic, AzureValidationOptions } from '@ssml-builder-js/ssml-core';
+
 interface TtsConfig {
     signal?: AbortSignal;
     timeoutMs?: number;
@@ -5,6 +7,79 @@ interface TtsConfig {
     subscriptionKey: string;
     region: string;
     outputFormat?: string;
+    /** Original plain-text range represented by this synthesis request. */
+    sourceTextRange?: {
+        start: number;
+        end: number;
+    };
+    /** Reports completion of a chunk when using synthesizeSsmlChunks. */
+    onProgress?: (event: {
+        currentChunk: number;
+        totalChunks: number;
+        percent: number;
+    }) => void;
+}
+interface SsmlSynthesisBoundary {
+    text: string;
+    audioOffsetMs: number;
+    durationMs: number;
+    textRange?: {
+        start: number;
+        end: number;
+    };
+    requestId?: string;
+}
+interface SsmlSynthesisViseme {
+    visemeId: number;
+    audioOffsetMs: number;
+    textRange?: {
+        start: number;
+        end: number;
+    };
+    requestId?: string;
+}
+interface SsmlSynthesisBookmark {
+    name: string;
+    audioOffsetMs: number;
+    textRange?: {
+        start: number;
+        end: number;
+    };
+    requestId?: string;
+}
+/** Audio and Azure Speech synchronization events emitted for one SSML request. */
+interface SsmlSynthesisResult {
+    audioData: ArrayBuffer;
+    durationMs: number;
+    boundaries?: SsmlSynthesisBoundary[];
+    /** Alias matching the Azure Speech event name. */
+    wordBoundary?: SsmlSynthesisBoundary[];
+    /** Alias for consumers that use Azure's word-boundary terminology. */
+    wordBoundaries?: SsmlSynthesisBoundary[];
+    visemes?: SsmlSynthesisViseme[];
+    bookmarks?: SsmlSynthesisBookmark[];
+    /** Request identifier returned by Azure Speech, when available. */
+    requestId?: string;
+    /** Original plain-text range represented by the result. */
+    textRange?: {
+        start: number;
+        end: number;
+    };
+}
+interface SsmlSynthesisChunk {
+    ssml: string;
+    originalTextRange?: {
+        start: number;
+        end: number;
+    };
+}
+interface SynthesizeChunksOptions {
+    onProgress?: (event: SynthesisProgressEvent) => void;
+}
+interface SynthesisProgressEvent {
+    currentChunk: number;
+    totalChunks: number;
+    percent: number;
 }
 interface AzureTtsLogger {
     debug?: (...args: unknown[]) => void;
@@ -20,6 +95,7 @@ interface AzureTtsClientOptions {
     endpoint?: string;
     outputFormat?: string;
     logger?: AzureTtsLogger;
+    onProgress?: (event: SynthesisProgressEvent) => void;
 }
 
 declare class AzureTtsError extends Error {
@@ -34,12 +110,58 @@ declare class AzureTtsSdkError extends AzureTtsError {
     constructor(errorDetails: string);
 }
 
+interface SsmlValidationError {
+    readonly kind: "validation";
+    readonly message: string;
+    readonly diagnostics: readonly SsmlDiagnostic[];
+}
+type Result<T, E> = {
+    readonly ok: true;
+    readonly success: true;
+    readonly status: "success";
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly success: false;
+    readonly status: "validation-error" | "azure-api-error";
+    readonly error: E;
+};
+type SynthesisResult<T, E> = Result<T, E>;
+type Success<T> = Extract<Result<T, never>, {
+    readonly ok: true;
+}>;
+type ValidationErrorResult = Extract<Result<never, SsmlValidationError>, {
+    readonly status: "validation-error";
+}>;
+type AzureApiErrorResult = Extract<Result<never, AzureTtsError>, {
+    readonly status: "azure-api-error";
+}>;
+type SsmlSynthesisSafeResult = Result<SsmlSynthesisResult, never> | Result<never, SsmlValidationError> | Result<never, AzureTtsError>;
+interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
+    /** Optional nested form for callers that want to keep validation settings grouped. */
+    validation?: AzureValidationOptions;
+}
+interface SynthesisClient {
+    synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
+}
+/** Validates SSML before invoking Azure and converts validation/API failures to one result shape. */
+declare function synthesizeSsmlSafe(client: Pick<AzureTtsClient, "synthesizeSsml"> | SynthesisClient, ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
+
 declare class AzureTtsClient {
     #private;
     constructor(options: AzureTtsClientOptions);
     synthesize(ssml: string): Promise<ArrayBuffer>;
+    synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
+    synthesizeChunks(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
+    synthesizeSsmlSafe(ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
 }
 
+declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult>;
+/** Synthesizes chunks sequentially, annotates synchronization events, and merges the results. */
+declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
+/** Concatenates audio buffers and shifts all synchronization events by prior chunk durations. */
+declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[]): SsmlSynthesisResult;
+/** Backward-compatible audio-only synthesis helper. */
 declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
 
 interface FetchAzureVoiceCatalogOptions {
@@ -67,4 +189,4 @@ interface AzureVoiceCatalog {
 /** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */
 declare function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog>;
 
-export { AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type TtsConfig, fetchAzureVoiceCatalog, synthesizeSpeech };
+export { type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type Result, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, type SynthesisProgressEvent, type SynthesisResult, type SynthesizeChunksOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, type ValidationErrorResult, fetchAzureVoiceCatalog, mergeSynthesisResults, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlSafe };

package/dist/index.js

@@ -41,7 +41,11 @@ __export(index_exports, {
   AzureTtsError: () => AzureTtsError,
   AzureTtsSdkError: () => AzureTtsSdkError,
   fetchAzureVoiceCatalog: () => fetchAzureVoiceCatalog,
-  synthesizeSpeech: () => synthesizeSpeech
+  mergeSynthesisResults: () => mergeSynthesisResults,
+  synthesizeSpeech: () => synthesizeSpeech,
+  synthesizeSsml: () => synthesizeSsml,
+  synthesizeSsmlChunks: () => synthesizeSsmlChunks,
+  synthesizeSsmlSafe: () => synthesizeSsmlSafe
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -151,7 +155,8 @@ function closeSpeechResources(speechConfig, synthesizer) {
   } catch {
   }
 }
-async function synthesizeSpeech(ssml, config) {
+var ticksToMilliseconds = (ticks) => Math.max(0, ticks) / 1e4;
+async function synthesizeSsml(ssml, config) {
   if (config.signal?.aborted) {
     throw createSpeechSdkError("Speech synthesis was cancelled.");
   }
@@ -178,6 +183,22 @@ async function synthesizeSpeech(ssml, config) {
       closeResources();
       reject(createSpeechSdkError(error));
     };
+    const boundaries = [];
+    const visemes = [];
+    const bookmarks = [];
+    synthesizer.wordBoundary = (_sender, event) => {
+      boundaries.push({
+        text: event.text,
+        audioOffsetMs: ticksToMilliseconds(event.audioOffset),
+        durationMs: ticksToMilliseconds(event.duration)
+      });
+    };
+    synthesizer.visemeReceived = (_sender, event) => {
+      visemes.push({ visemeId: event.visemeId, audioOffsetMs: ticksToMilliseconds(event.audioOffset) });
+    };
+    synthesizer.bookmarkReached = (_sender, event) => {
+      bookmarks.push({ name: event.text, audioOffsetMs: ticksToMilliseconds(event.audioOffset) });
+    };
     const cb = (result) => {
       if (settled) return;
       const { reason, errorDetails } = result;
@@ -189,7 +210,31 @@ async function synthesizeSpeech(ssml, config) {
       settled = true;
       cleanup();
       closeResources();
-      resolve(result.audioData);
+      const eventDurationMs = Math.max(
+        0,
+        ...(boundaries ?? []).map((boundary) => boundary.audioOffsetMs + boundary.durationMs),
+        ...(visemes ?? []).map((viseme) => viseme.audioOffsetMs),
+        ...(bookmarks ?? []).map((bookmark) => bookmark.audioOffsetMs)
+      );
+      const durationMs = result.audioDuration ? ticksToMilliseconds(result.audioDuration) : eventDurationMs;
+      const requestId = result.resultId;
+      const addSourceMetadata = (event) => ({
+        ...event,
+        ...config.sourceTextRange ? { textRange: { ...config.sourceTextRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+      const sourceBoundaries = boundaries.map((boundary) => addSourceMetadata(boundary));
+      const sourceVisemes = visemes.map((viseme) => addSourceMetadata(viseme));
+      const sourceBookmarks = bookmarks.map((bookmark) => addSourceMetadata(bookmark));
+      resolve({
+        audioData: result.audioData,
+        durationMs,
+        ...config.sourceTextRange ? { textRange: { ...config.sourceTextRange } } : {},
+        ...requestId ? { requestId } : {},
+        ...sourceBoundaries.length > 0 ? { boundaries: sourceBoundaries, wordBoundary: sourceBoundaries, wordBoundaries: sourceBoundaries } : {},
+        ...sourceVisemes.length > 0 ? { visemes: sourceVisemes } : {},
+        ...sourceBookmarks.length > 0 ? { bookmarks: sourceBookmarks } : {}
+      });
     };
     try {
       if (config.signal) {
@@ -208,6 +253,108 @@ async function synthesizeSpeech(ssml, config) {
     }
   });
 }
+async function synthesizeSsmlChunks(chunks, config) {
+  const results = [];
+  const totalChunks = chunks.length;
+  for (const [index, chunk] of chunks.entries()) {
+    const input = typeof chunk === "string" ? { ssml: chunk } : chunk;
+    const result = await synthesizeSsml(input.ssml, {
+      ...config,
+      ...input.originalTextRange ? { sourceTextRange: input.originalTextRange } : {},
+      onProgress: void 0
+    });
+    results.push(result);
+    config.onProgress?.({
+      currentChunk: index + 1,
+      totalChunks,
+      percent: totalChunks === 0 ? 100 : Math.round((index + 1) / totalChunks * 100)
+    });
+  }
+  return mergeSynthesisResults(results);
+}
+function mergeSynthesisResults(results) {
+  const audioLength = results.reduce((total, result) => total + result.audioData.byteLength, 0);
+  const audioData = new Uint8Array(audioLength);
+  const boundaries = [];
+  const visemes = [];
+  const bookmarks = [];
+  let byteOffset = 0;
+  let durationOffset = 0;
+  for (const result of results) {
+    audioData.set(new Uint8Array(result.audioData), byteOffset);
+    byteOffset += result.audioData.byteLength;
+    const chunkBoundaries = result.boundaries && result.boundaries.length > 0 ? result.boundaries : result.wordBoundary ?? result.wordBoundaries ?? [];
+    for (const boundary of chunkBoundaries) {
+      const textRange = boundary.textRange ?? result.textRange;
+      const requestId = boundary.requestId ?? result.requestId;
+      boundaries.push({
+        ...boundary,
+        audioOffsetMs: boundary.audioOffsetMs + durationOffset,
+        ...textRange ? { textRange: { ...textRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+    }
+    for (const viseme of result.visemes ?? []) {
+      const textRange = viseme.textRange ?? result.textRange;
+      const requestId = viseme.requestId ?? result.requestId;
+      visemes.push({
+        ...viseme,
+        audioOffsetMs: viseme.audioOffsetMs + durationOffset,
+        ...textRange ? { textRange: { ...textRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+    }
+    for (const bookmark of result.bookmarks ?? []) {
+      const textRange = bookmark.textRange ?? result.textRange;
+      const requestId = bookmark.requestId ?? result.requestId;
+      bookmarks.push({
+        ...bookmark,
+        audioOffsetMs: bookmark.audioOffsetMs + durationOffset,
+        ...textRange ? { textRange: { ...textRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+    }
+    durationOffset += Math.max(0, result.durationMs);
+  }
+  return {
+    audioData: audioData.buffer,
+    durationMs: durationOffset,
+    ...boundaries.length > 0 ? { boundaries, wordBoundary: boundaries, wordBoundaries: boundaries } : {},
+    ...visemes.length > 0 ? { visemes } : {},
+    ...bookmarks.length > 0 ? { bookmarks } : {},
+    ...results.length === 1 && results[0]?.requestId ? { requestId: results[0].requestId } : {},
+    ...results.length === 1 && results[0]?.textRange ? { textRange: { ...results[0].textRange } } : {}
+  };
+}
+async function synthesizeSpeech(ssml, config) {
+  return (await synthesizeSsml(ssml, config)).audioData;
+}
+
+// src/safe.ts
+var import_ssml_core = require("@ssml-builder-js/ssml-core");
+async function synthesizeSsmlSafe(client, ssml, options = {}) {
+  const validationOptions = options.validation ?? options;
+  const diagnostics = await Promise.resolve((0, import_ssml_core.validateAzureSsml)(ssml, validationOptions));
+  const errors = diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+  if (errors.length > 0) {
+    return {
+      ok: false,
+      success: false,
+      status: "validation-error",
+      error: {
+        kind: "validation",
+        message: "SSML validation failed; the Azure Speech API was not called.",
+        diagnostics: errors
+      }
+    };
+  }
+  try {
+    return { ok: true, success: true, status: "success", value: await client.synthesizeSsml(ssml) };
+  } catch (error) {
+    const azureError = error instanceof AzureTtsError ? error : createSpeechSdkError(error);
+    return { ok: false, success: false, status: "azure-api-error", error: azureError };
+  }
+}
 
 // src/client.ts
 var ENDPOINT_TEMPLATE = "https://{region}.tts.speech.microsoft.com/cognitiveservices/v1";
@@ -224,6 +371,28 @@ var AzureTtsClient = class {
     const config = { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs };
     return synthesizeSpeech(ssml, config);
   }
+  async synthesizeSsml(ssml) {
+    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = __privateGet(this, _options);
+    const endpoint = __privateGet(this, _options).endpoint?.trim() || ENDPOINT_TEMPLATE.replace("{region}", region);
+    __privateGet(this, _options).logger?.debug?.("Using Azure TTS endpoint:", endpoint);
+    return synthesizeSsml(ssml, { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs });
+  }
+  async synthesizeChunks(chunks, options = {}) {
+    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = __privateGet(this, _options);
+    const endpoint = __privateGet(this, _options).endpoint?.trim() || ENDPOINT_TEMPLATE.replace("{region}", region);
+    return synthesizeSsmlChunks(chunks, {
+      endpoint,
+      region,
+      subscriptionKey,
+      outputFormat,
+      signal,
+      timeoutMs,
+      onProgress: options.onProgress ?? __privateGet(this, _options).onProgress
+    });
+  }
+  async synthesizeSsmlSafe(ssml, options = {}) {
+    return synthesizeSsmlSafe(this, ssml, options);
+  }
 };
 _options = new WeakMap();
 
@@ -310,6 +479,10 @@ async function fetchAzureVoiceCatalog(options) {
   AzureTtsError,
   AzureTtsSdkError,
   fetchAzureVoiceCatalog,
-  synthesizeSpeech
+  mergeSynthesisResults,
+  synthesizeSpeech,
+  synthesizeSsml,
+  synthesizeSsmlChunks,
+  synthesizeSsmlSafe
 });
 //# sourceMappingURL=index.js.map