@ssml-builder-js/azure-tts-client 2.16.0 → 2.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssml-builder-js/azure-tts-client",
-  "version": "2.16.0",
+  "version": "2.18.0",
   "description": "Azure Text-to-Speech client using the Microsoft Speech SDK",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,7 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@ssml-builder-js/ssml-core": "^2.16.0",
+    "@ssml-builder-js/ssml-core": "^2.18.0",
     "microsoft-cognitiveservices-speech-sdk": "1.51.0"
   }
 }

package/src/client.ts

@@ -19,16 +19,25 @@ export class AzureTtsClient {
   }
 
   async synthesize(ssml: string): Promise<ArrayBuffer> {
-    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;
+    const { region, subscriptionKey, outputFormat, signal, timeoutMs, timeouts } = this.#options;
     const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace("{region}", region);
     this.#options.logger?.debug?.("Using Azure TTS endpoint:", endpoint);
 
-    const config = { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs };
+    const config = {
+      endpoint,
+      region,
+      subscriptionKey,
+      outputFormat,
+      signal,
+      timeoutMs,
+      timeouts,
+      retryOptions: this.#options.retryOptions,
+    };
     return synthesizeSpeech(ssml, config);
   }
 
   async synthesizeSsml(ssml: string, options: Partial<TtsConfig> = {}): Promise<SsmlSynthesisResult> {
-    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;
+    const { region, subscriptionKey, outputFormat, signal, timeoutMs, timeouts } = this.#options;
     const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace("{region}", region);
     this.#options.logger?.debug?.("Using Azure TTS endpoint:", endpoint);
 
@@ -39,9 +48,16 @@ export class AzureTtsClient {
       outputFormat: options.outputFormat ?? outputFormat,
       signal: options.signal ?? signal,
       timeoutMs: options.timeoutMs ?? timeoutMs,
+      timeouts: options.timeouts ?? timeouts,
       sourceNodePath: options.sourceNodePath,
       sourceTextSegments: options.sourceTextSegments,
       sourceMarkers: options.sourceMarkers,
+      retryOptions: options.retryOptions ?? this.#options.retryOptions,
+      cancelOnFailure: options.cancelOnFailure ?? this.#options.cancelOnFailure,
+      customMerger: options.customMerger ?? this.#options.customMerger,
+      outputMimeType: options.outputMimeType ?? this.#options.outputMimeType,
+      postMergeValidator: options.postMergeValidator ?? this.#options.postMergeValidator,
+      resumeValidation: options.resumeValidation ?? this.#options.resumeValidation,
     });
   }
 
@@ -49,7 +65,7 @@ export class AzureTtsClient {
     chunks: readonly (SsmlSynthesisChunk | string)[],
     options: SynthesizeChunksOptions = {},
   ): Promise<SsmlSynthesisResult> {
-    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;
+    const { region, subscriptionKey, outputFormat, signal, timeoutMs, timeouts } = this.#options;
     const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace("{region}", region);
     return synthesizeSsmlChunks(chunks, {
       endpoint,
@@ -58,10 +74,18 @@ export class AzureTtsClient {
       outputFormat: options.outputFormat ?? outputFormat,
       signal: options.signal ?? signal,
       timeoutMs: options.timeoutMs ?? timeoutMs,
+      timeouts: options.timeouts ?? timeouts,
       sourceNodePath: options.sourceNodePath,
       onProgress: options.onProgress ?? this.#options.onProgress,
       concurrency: options.concurrency ?? this.#options.concurrency,
       retryOptions: options.retryOptions ?? this.#options.retryOptions,
+      cancelOnFailure: options.cancelOnFailure ?? this.#options.cancelOnFailure,
+      resumeChunks: options.resumeChunks,
+      resumeChunkIndices: options.resumeChunkIndices,
+      customMerger: options.customMerger ?? this.#options.customMerger,
+      outputMimeType: options.outputMimeType ?? this.#options.outputMimeType,
+      postMergeValidator: options.postMergeValidator ?? this.#options.postMergeValidator,
+      resumeValidation: options.resumeValidation ?? this.#options.resumeValidation,
     });
   }
 
@@ -78,6 +102,7 @@ export class AzureTtsClient {
       outputFormat: options.outputFormat ?? this.#options.outputFormat,
       signal: options.signal ?? this.#options.signal,
       timeoutMs: options.timeoutMs ?? this.#options.timeoutMs,
+      timeouts: options.timeouts ?? this.#options.timeouts,
       onProgress: options.onProgress ?? this.#options.onProgress,
       concurrency: options.concurrency ?? this.#options.concurrency,
       retryOptions: options.retryOptions ?? this.#options.retryOptions,

package/src/errors.ts

@@ -13,15 +13,57 @@ export class AzureTtsError extends Error {
   readonly statusText: string;
   readonly responseBody: string;
   readonly requestId: string | null;
-
-  constructor(status: number, statusText: string, responseBody: string, requestId: string | null) {
+  readonly retryAfterMs?: number;
+
+  constructor(
+    status: number,
+    statusText: string,
+    responseBody: string,
+    requestId: string | null,
+    responseHeaders?: Headers | Readonly<Record<string, string>>,
+  ) {
     super(`Azure TTS request failed: ${status} ${statusText}`);
     this.name = "AzureTtsError";
     this.status = status;
     this.statusText = statusText;
     this.responseBody = responseBody;
     this.requestId = requestId;
+    const value =
+      responseHeaders instanceof Headers
+        ? responseHeaders.get("retry-after")
+        : (responseHeaders?.["retry-after"] ?? responseHeaders?.["Retry-After"]);
+    const seconds = value ? Number(value.trim()) : NaN;
+    const date = value ? Date.parse(value) : NaN;
+    if (Number.isFinite(seconds) && seconds >= 0) this.retryAfterMs = seconds * 1000;
+    else if (Number.isFinite(date)) this.retryAfterMs = Math.max(0, date - Date.now());
+  }
+}
+
+/** Reads Retry-After from an error-like value, returning milliseconds when present. */
+export function getRetryAfterDelayMs(error: unknown): number | undefined {
+  if (error instanceof AzureTtsError && error.retryAfterMs !== undefined) return error.retryAfterMs;
+  if (!error || typeof error !== "object") return undefined;
+  const candidate = error as { retryAfterMs?: unknown; headers?: unknown; response?: unknown };
+  if (typeof candidate.retryAfterMs === "number" && candidate.retryAfterMs >= 0) return candidate.retryAfterMs;
+  const headers = candidate.headers ?? (candidate.response as { headers?: unknown } | undefined)?.headers;
+  if (headers instanceof Headers) {
+    const value = headers.get("retry-after");
+    if (!value) return undefined;
+    const seconds = Number(value.trim());
+    if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1000;
+    const date = Date.parse(value);
+    return Number.isFinite(date) ? Math.max(0, date - Date.now()) : undefined;
+  }
+  if (headers && typeof headers === "object") {
+    const value =
+      (headers as Record<string, unknown>)["retry-after"] ?? (headers as Record<string, unknown>)["Retry-After"];
+    if (typeof value !== "string") return undefined;
+    const seconds = Number(value.trim());
+    if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1000;
+    const date = Date.parse(value);
+    return Number.isFinite(date) ? Math.max(0, date - Date.now()) : undefined;
   }
+  return undefined;
 }
 
 export class AzureTtsSdkError extends AzureTtsError {

package/src/index.ts

@@ -17,6 +17,16 @@ export type {
   SynthesizeChunksOptions,
   SynthesisChunkStatus,
   RetryOptions,
+  SynthesisTimeouts,
+  SynthesizedChunk,
+  PartialChunkSynthesisResult,
+  PartialSynthesisResult,
+  ChunkExecutionState,
+  ChunkExecutionStatus,
+  ResumeValidationMode,
+  CustomMergerContext,
+  CustomAudioMerger,
+  PostMergeValidator,
   TtsConfig,
 } from "./types.ts";
 export {
@@ -27,6 +37,7 @@ export {
   SynthesisCancelledError,
   SynthesisTimeoutError,
   UnsupportedMergeFormatError,
+  getRetryAfterDelayMs,
 } from "./errors.ts";
 export type { AzureTtsSynthesisError, SynthesisErrorKind } from "./errors.ts";
 export { AzureTtsClient } from "./client.ts";
@@ -39,9 +50,9 @@ export {
   inspectAudioSpecification,
   resolveMergeAudioFormat,
   synthesizeSsmlChunks,
+  computeChunkFingerprint,
 } from "./synthesis.ts";
 export type {
-  CustomMergerContext,
   InputAudioSpecs,
   MergeAudioFormat,
   MergeAudioOptions,
@@ -49,7 +60,12 @@ export type {
 } from "./synthesis.ts";
 export { DEFAULT_OUTPUT_FORMAT, resolveMimeType } from "./outputFormats.ts";
 export type { AzureTtsOutputFormat } from "./outputFormats.ts";
-export { ChunkValidationError, synthesizeSsmlChunksSafe, synthesizeSsmlSafe } from "./safe.ts";
+export {
+  BatchChunkValidationError,
+  ChunkValidationError,
+  synthesizeSsmlChunksSafe,
+  synthesizeSsmlSafe,
+} from "./safe.ts";
 export type {
   AzureApiErrorResult,
   Result,
@@ -62,6 +78,7 @@ export type {
   SsmlSynthesisChunksSafeResult,
   SynthesizeSsmlChunksSafeOptions,
   ValidationErrorResult,
+  ChunkDiagnostics,
 } from "./safe.ts";
 export { fetchAzureVoiceCatalog } from "./voiceCatalog.ts";
 export type {

package/src/outputFormats.ts

@@ -49,6 +49,9 @@ export type AzureTtsOutputFormat = keyof typeof OUTPUT_FORMATS;
 export function resolveMimeType(outputFormat: string): string {
   if (/(?:wav|wave|riff)/i.test(outputFormat)) return "audio/wav";
   if (/(?:mp3|mpeg)/i.test(outputFormat)) return "audio/mpeg";
+  if (/mulaw|mu-law/i.test(outputFormat)) return "audio/basic";
+  if (/alaw|a-law/i.test(outputFormat)) return "audio/alaw";
+  if (/siren/i.test(outputFormat)) return "audio/siren";
   if (/ogg/i.test(outputFormat)) return "audio/ogg";
   if (/webm/i.test(outputFormat)) return "audio/webm";
   if (/raw/i.test(outputFormat)) return "audio/L16";