@ssml-builder-js/azure-tts-client 2.19.0 → 2.19.1

package/dist/index.d.mts

@@ -1,538 +0,0 @@
-import { SsmlTextRange, SsmlSourceTextSegment, SsmlSourceMarker, SsmlDiagnostic, AzureValidationOptions } from '@ssml-builder-js/ssml-core';
-import * as SpeechSDK from 'microsoft-cognitiveservices-speech-sdk';
-
-declare const DEFAULT_OUTPUT_FORMAT = "audio-16khz-128kbitrate-mono-mp3";
-declare const OUTPUT_FORMATS: {
-    "raw-8khz-8bit-mono-mulaw": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz8BitMonoMULaw;
-    "riff-16khz-16kbps-mono-siren": SpeechSDK.SpeechSynthesisOutputFormat.Riff16Khz16KbpsMonoSiren;
-    "audio-16khz-16kbps-mono-siren": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz16KbpsMonoSiren;
-    "audio-16khz-32kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz32KBitRateMonoMp3;
-    "audio-16khz-128kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz128KBitRateMonoMp3;
-    "audio-16khz-64kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz64KBitRateMonoMp3;
-    "audio-24khz-48kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz48KBitRateMonoMp3;
-    "audio-24khz-96kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz96KBitRateMonoMp3;
-    "audio-24khz-160kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz160KBitRateMonoMp3;
-    "raw-16khz-16bit-mono-truesilk": SpeechSDK.SpeechSynthesisOutputFormat.Raw16Khz16BitMonoTrueSilk;
-    "riff-16khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Riff16Khz16BitMonoPcm;
-    "riff-8khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz16BitMonoPcm;
-    "riff-24khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Riff24Khz16BitMonoPcm;
-    "riff-8khz-8bit-mono-mulaw": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz8BitMonoMULaw;
-    "raw-16khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Raw16Khz16BitMonoPcm;
-    "raw-24khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Raw24Khz16BitMonoPcm;
-    "raw-8khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz16BitMonoPcm;
-    "ogg-16khz-16bit-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Ogg16Khz16BitMonoOpus;
-    "ogg-24khz-16bit-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Ogg24Khz16BitMonoOpus;
-    "raw-48khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Raw48Khz16BitMonoPcm;
-    "riff-48khz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Riff48Khz16BitMonoPcm;
-    "audio-48khz-96kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio48Khz96KBitRateMonoMp3;
-    "audio-48khz-192kbitrate-mono-mp3": SpeechSDK.SpeechSynthesisOutputFormat.Audio48Khz192KBitRateMonoMp3;
-    "ogg-48khz-16bit-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Ogg48Khz16BitMonoOpus;
-    "webm-16khz-16bit-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Webm16Khz16BitMonoOpus;
-    "webm-24khz-16bit-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Webm24Khz16BitMonoOpus;
-    "webm-24khz-16bit-24kbps-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Webm24Khz16Bit24KbpsMonoOpus;
-    "raw-24khz-16bit-mono-truesilk": SpeechSDK.SpeechSynthesisOutputFormat.Raw24Khz16BitMonoTrueSilk;
-    "raw-8khz-8bit-mono-alaw": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz8BitMonoALaw;
-    "riff-8khz-8bit-mono-alaw": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz8BitMonoALaw;
-    "audio-16khz-16bit-32kbps-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz16Bit32KbpsMonoOpus;
-    "audio-24khz-16bit-48kbps-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz16Bit48KbpsMonoOpus;
-    "audio-24khz-16bit-24kbps-mono-opus": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz16Bit24KbpsMonoOpus;
-    "raw-22050hz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Raw22050Hz16BitMonoPcm;
-    "riff-22050hz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Riff22050Hz16BitMonoPcm;
-    "raw-44100hz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Raw44100Hz16BitMonoPcm;
-    "riff-44100hz-16bit-mono-pcm": SpeechSDK.SpeechSynthesisOutputFormat.Riff44100Hz16BitMonoPcm;
-    "amr-wb-16000hz": SpeechSDK.SpeechSynthesisOutputFormat.AmrWb16000Hz;
-    "g722-16khz-64kbps": SpeechSDK.SpeechSynthesisOutputFormat.G72216Khz64Kbps;
-};
-type AzureTtsOutputFormat = keyof typeof OUTPUT_FORMATS;
-declare function resolveMimeType(outputFormat: string): string;
-
-type SynthesisErrorKind = "validation-error" | "azure-api-error" | "merge-error" | "audio-format-mismatch" | "unsupported-format-error" | "cancelled" | "timeout" | "incomplete-chunk-set";
-type SerializedChunkErrorCode = "VALIDATION_ERROR" | "AZURE_API_ERROR" | "TIMEOUT" | "CANCELLED" | "MERGE_ERROR" | "FORMAT_MISMATCH";
-interface SerializedChunkError {
-    code: SerializedChunkErrorCode;
-    phase: "url-validation" | "synthesis" | "merge";
-    message: string;
-    isOriginalFailure: boolean;
-    isRetryable: boolean;
-    httpStatus?: number;
-    details?: Record<string, unknown>;
-}
-/** Backward-compatible name used by persisted execution-state consumers. */
-type SerializedExecutionError = SerializedChunkError;
-declare class AzureTtsError extends Error {
-    readonly kind: "azure-api-error";
-    readonly status: number;
-    readonly statusText: string;
-    readonly responseBody: string;
-    readonly requestId: string | null;
-    readonly retryAfterMs?: number;
-    constructor(status: number, statusText: string, responseBody: string, requestId: string | null, responseHeaders?: Headers | Readonly<Record<string, string>>);
-}
-/** Reads Retry-After from an error-like value, returning milliseconds when present. */
-declare function getRetryAfterDelayMs(error: unknown): number | undefined;
-declare class AzureTtsSdkError extends AzureTtsError {
-    readonly errorDetails: string;
-    constructor(errorDetails: string);
-}
-declare class SynthesisCancelledError extends Error {
-    readonly kind: "cancelled";
-    constructor(message?: string);
-}
-declare class SynthesisTimeoutError extends Error {
-    readonly kind: "timeout";
-    constructor(message: string);
-}
-declare class IncompleteChunkSetError extends Error {
-    readonly kind: "incomplete-chunk-set";
-    readonly totalChunks: number;
-    readonly missingChunkIndices: readonly number[];
-    constructor(totalChunks: number, missingChunkIndices: readonly number[]);
-}
-declare class MergeError extends Error {
-    readonly kind: "merge-error";
-    readonly cause: unknown;
-    constructor(message: string, cause?: unknown);
-}
-/** Thrown when chunk headers describe incompatible audio streams. */
-declare class AudioFormatMismatchError extends Error {
-    readonly kind: "audio-format-mismatch";
-    readonly inputSpecs: readonly AudioSpecification[];
-    constructor(message: string, inputSpecs?: readonly AudioSpecification[]);
-}
-/** Thrown when audio buffers require container re-multiplexing before they can be merged. */
-declare class UnsupportedMergeFormatError extends Error {
-    readonly kind: "unsupported-format-error";
-    readonly format: string;
-    constructor(format: string);
-}
-type AzureTtsSynthesisError = AzureTtsError | MergeError | AudioFormatMismatchError | UnsupportedMergeFormatError | SynthesisCancelledError | SynthesisTimeoutError | IncompleteChunkSetError;
-declare function serializeChunkError(error: unknown, phase: SerializedChunkError["phase"], isOriginalFailure: boolean): SerializedChunkError;
-
-interface TtsConfig {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    timeouts?: SynthesisTimeouts;
-    endpoint?: string;
-    subscriptionKey: string;
-    region: string;
-    outputFormat?: string;
-    customHeaders?: Readonly<Record<string, string>>;
-    fingerprintSchemaVersion?: string;
-    /** Original plain-text range represented by this synthesis request. */
-    sourceTextRange?: {
-        start: number;
-        end: number;
-    };
-    /** Reports chunk lifecycle events when using chunk synthesis. */
-    onProgress?: (event: SynthesisProgressEvent) => void;
-    /** Metadata used to map synchronization events back to the source document. */
-    chunkIndex?: number;
-    sourceNodePath?: string[];
-    /** Exact source text segments used to map individual Azure events. */
-    sourceTextSegments?: SsmlSourceTextSegment[];
-    sourceMarkers?: SsmlSourceMarker[];
-    concurrency?: number;
-    retryOptions?: RetryOptions;
-    cancelOnFailure?: boolean;
-    resumeChunks?: readonly SynthesizedChunk[];
-    resumeChunkIndices?: readonly number[];
-    customMerger?: CustomAudioMerger;
-    outputMimeType?: string;
-    postMergeValidator?: PostMergeValidator;
-    resumeValidation?: ResumeValidationMode;
-}
-type MappingStatus = "exact" | "fallback" | "unmapped";
-interface AudioSpecification {
-    format: string;
-    mimeType: string;
-    codec: "pcm" | "mulaw" | "alaw" | "siren" | "mp3" | "opus" | "silk" | "unknown";
-    sampleRate: number;
-    channels: number;
-    bitrate?: number;
-    bitDepth?: number;
-    container?: string;
-    isVbr?: boolean;
-    isCompressed: boolean;
-}
-type ResumeValidationMode = "strict" | "disabled";
-interface SynthesisTimeouts {
-    urlValidationMs?: number;
-    perChunkMs?: number;
-    chunkWithRetriesMs?: number;
-    totalJobMs?: number;
-}
-interface RetryOptions {
-    maxRetries: number;
-    initialDelayMs: number;
-    maxDelayMs: number;
-    shouldRetry?: (error: unknown, attempt: number) => boolean;
-}
-type SynthesisChunkStatus = "pending" | "synthesizing" | "success" | "failed";
-interface SsmlSynthesisBoundary {
-    text: string;
-    audioOffsetMs: number;
-    durationMs: number;
-    textRange?: {
-        start: number;
-        end: number;
-    };
-    /** Chunk that produced this event. */
-    chunkIndex?: number;
-    /** Path of the source SSML node, when available. */
-    sourceNodePath?: string[];
-    /** Original text range represented by this event. */
-    originalTextRange?: SsmlTextRange;
-    /** Audio offset within the originating chunk before merge. */
-    chunkAudioOffsetMs?: number;
-    requestId?: string;
-    mappingStatus: MappingStatus;
-}
-interface SsmlSynthesisViseme {
-    visemeId: number;
-    audioOffsetMs: number;
-    textRange?: {
-        start: number;
-        end: number;
-    };
-    chunkIndex?: number;
-    sourceNodePath?: string[];
-    originalTextRange?: SsmlTextRange;
-    chunkAudioOffsetMs?: number;
-    requestId?: string;
-    mappingStatus: MappingStatus;
-}
-interface SsmlSynthesisBookmark {
-    name: string;
-    audioOffsetMs: number;
-    textRange?: {
-        start: number;
-        end: number;
-    };
-    chunkIndex?: number;
-    sourceNodePath?: string[];
-    originalTextRange?: SsmlTextRange;
-    chunkAudioOffsetMs?: number;
-    requestId?: string;
-    mappingStatus: MappingStatus;
-}
-/** 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;
-    };
-    /** MIME type of a result produced by an explicit merge operation. */
-    mimeType?: string;
-    audioSpec?: AudioSpecification;
-}
-interface MergedSynthesisResult extends SsmlSynthesisResult {
-    mimeType: string;
-}
-interface SsmlSynthesisChunk {
-    ssml: string;
-    originalTextRange?: {
-        start: number;
-        end: number;
-    };
-    sourceNodePath?: string[];
-    sourceTextSegments?: SsmlSourceTextSegment[];
-    sourceMarkers?: SsmlSourceMarker[];
-}
-interface SynthesizeChunksOptions {
-    onProgress?: (event: SynthesisProgressEvent) => void;
-    outputFormat?: AzureTtsOutputFormat | string;
-    customHeaders?: Readonly<Record<string, string>>;
-    fingerprintSchemaVersion?: string;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    timeouts?: SynthesisTimeouts;
-    sourceNodePath?: string[];
-    concurrency?: number;
-    retryOptions?: RetryOptions;
-    cancelOnFailure?: boolean;
-    resumeChunks?: readonly SynthesizedChunk[];
-    resumeChunkIndices?: readonly number[];
-    customMerger?: CustomAudioMerger;
-    outputMimeType?: string;
-    postMergeValidator?: PostMergeValidator;
-    resumeValidation?: ResumeValidationMode;
-}
-interface CustomMergerContext {
-    format: string;
-    outputMimeType: string;
-    inputSpecs: readonly AudioSpecification[];
-    signal: AbortSignal;
-}
-type CustomAudioMerger = (buffers: ArrayBuffer[], context: CustomMergerContext) => Promise<ArrayBuffer> | ArrayBuffer;
-type PostMergeValidator = (result: MergedSynthesisResult, context: CustomMergerContext) => boolean | undefined | Promise<boolean | undefined>;
-interface SynthesizedChunk extends SsmlSynthesisResult {
-    chunkIndex: number;
-    /** Fingerprint of the SSML and synthesis settings used to create this chunk. */
-    fingerprint: string;
-}
-type ChunkExecutionStatus = "succeeded" | "failed" | "cancelled" | "pending";
-interface ChunkExecutionState {
-    chunkIndex: number;
-    status: ChunkExecutionStatus;
-    error?: SerializedChunkError;
-    isOriginalFailure?: boolean;
-    canResume: boolean;
-    result?: SsmlSynthesisResult;
-}
-interface PartialChunkSynthesisResult {
-    synthesizedChunks: readonly SynthesizedChunk[];
-    completedChunks: readonly SynthesizedChunk[];
-    pendingChunkIndices: readonly number[];
-    failedChunkIndices: readonly number[];
-    cancelledChunkIndices: readonly number[];
-    chunkStates: readonly ChunkExecutionState[];
-    totalChunks: number;
-}
-/** Alias for applications that use the shorter result name. */
-type PartialSynthesisResult = PartialChunkSynthesisResult;
-interface SynthesisProgressEvent {
-    /** 1-based completed chunk count retained for backward compatibility. */
-    currentChunk: number;
-    totalChunks: number;
-    percent: number;
-    chunkIndex: number;
-    originalTextRange?: SsmlTextRange;
-    status: SynthesisChunkStatus;
-    durationMs: number;
-    error?: unknown;
-    retryAttempt?: number;
-    nextRetryDelayMs?: number;
-    isRetrying?: boolean;
-}
-interface AzureTtsLogger {
-    debug?: (...args: unknown[]) => void;
-    info?: (...args: unknown[]) => void;
-    warn?: (...args: unknown[]) => void;
-    error?: (...args: unknown[]) => void;
-}
-interface AzureTtsClientOptions {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    timeouts?: SynthesisTimeouts;
-    subscriptionKey: string;
-    region: string;
-    endpoint?: string;
-    outputFormat?: string;
-    customHeaders?: Readonly<Record<string, string>>;
-    fingerprintSchemaVersion?: string;
-    logger?: AzureTtsLogger;
-    onProgress?: (event: SynthesisProgressEvent) => void;
-    concurrency?: number;
-    retryOptions?: RetryOptions;
-    cancelOnFailure?: boolean;
-    customMerger?: CustomAudioMerger;
-    outputMimeType?: string;
-    postMergeValidator?: PostMergeValidator;
-    resumeValidation?: ResumeValidationMode;
-}
-
-/** Coordinates one absolute deadline across validation, synthesis, retries, and merging. */
-declare class DeadlineController {
-    #private;
-    readonly deadlineAtMs: number | undefined;
-    readonly signal: AbortSignal;
-    constructor(totalJobMs: number | undefined, parent?: AbortSignal);
-    get timedOut(): boolean;
-    get remainingMs(): number;
-    throwIfExpired(): void;
-    abort(): void;
-    dispose(): void;
-}
-
-interface SsmlValidationError {
-    readonly kind: "validation-error";
-    readonly message: string;
-    readonly diagnostics: readonly SsmlDiagnostic[];
-}
-type SsmlSynthesisError = SsmlValidationError | AzureTtsSynthesisError;
-declare class ChunkValidationError extends Error {
-    readonly kind: "validation-error";
-    readonly chunkIndex: number;
-    readonly diagnostics: readonly SsmlDiagnostic[];
-    constructor(chunkIndex: number, diagnostics: readonly SsmlDiagnostic[]);
-}
-interface ChunkDiagnostics {
-    readonly chunkIndex: number;
-    readonly diagnostics: readonly SsmlDiagnostic[];
-}
-declare class BatchChunkValidationError extends ChunkValidationError {
-    readonly chunkDiagnostics: readonly ChunkDiagnostics[];
-    readonly totalErrorCount: number;
-    readonly errorCount: number;
-    readonly totalErrors: number;
-    constructor(chunkDiagnostics: readonly ChunkDiagnostics[]);
-}
-type Result<T, E> = {
-    readonly ok: true;
-    readonly success: true;
-    readonly status: "success";
-    readonly value: T;
-} | (E extends {
-    readonly kind: infer Kind extends SynthesisErrorKind;
-} ? {
-    readonly ok: false;
-    readonly success: false;
-    readonly status: Kind;
-    readonly error: E;
-    readonly partialResult?: PartialChunkSynthesisResult;
-} : {
-    readonly ok: false;
-    readonly success: false;
-    readonly status: SynthesisErrorKind;
-    readonly error: E;
-    readonly partialResult?: PartialChunkSynthesisResult;
-});
-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, SsmlSynthesisError>;
-interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
-    /** Optional nested form for callers that want to keep validation settings grouped. */
-    validation?: AzureValidationOptions;
-    signal?: AbortSignal;
-    timeouts?: SynthesisTimeouts;
-}
-interface SynthesizeSsmlChunksSafeOptions extends AzureValidationOptions {
-    validation?: AzureValidationOptions;
-    outputFormat?: string;
-    customHeaders?: Readonly<Record<string, string>>;
-    fingerprintSchemaVersion?: string;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    timeouts?: SynthesisTimeouts;
-    sourceNodePath?: string[];
-    onProgress?: (event: SynthesisProgressEvent) => void;
-    concurrency?: number;
-    retryOptions?: RetryOptions;
-    cancelOnFailure?: boolean;
-    resumeChunks?: readonly SynthesizedChunk[];
-    resumeChunkIndices?: readonly number[];
-    customMerger?: CustomAudioMerger;
-    outputMimeType?: string;
-    postMergeValidator?: PostMergeValidator;
-    resumeValidation?: ResumeValidationMode;
-}
-type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, BatchChunkValidationError> | Result<never, SsmlSynthesisError | ChunkValidationError>;
-interface SynthesisClient {
-    synthesizeSsml(ssml: string, options?: Partial<SynthesizeChunksOptions>): Promise<SsmlSynthesisResult>;
-    synthesizeChunks?(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): 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>;
-/** Validates every chunk before synthesis and returns a chunk-addressable result. */
-declare function synthesizeSsmlChunksSafe(client: Pick<AzureTtsClient, "synthesizeSsml" | "synthesizeChunks"> | SynthesisClient, chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
-
-declare class AzureTtsClient {
-    #private;
-    constructor(options: AzureTtsClientOptions);
-    synthesize(ssml: string): Promise<ArrayBuffer>;
-    synthesizeSsml(ssml: string, options?: Partial<TtsConfig>): Promise<SsmlSynthesisResult>;
-    synthesizeChunks(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
-    synthesizeSsmlSafe(ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
-    synthesizeChunksSafe(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
-    synthesizeSsmlChunksSafe(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
-}
-
-type MergeAudioFormat = "wav" | "mp3" | "raw";
-interface MergeAudioOptions {
-    format: AzureTtsOutputFormat;
-    signal?: AbortSignal;
-    outputMimeType?: string;
-}
-type InputAudioSpecs = AudioSpecification[];
-/**
- * Creates a deterministic, runtime-independent fingerprint for a synthesis chunk.
- * The complete SSML is included so changes to voice, language, prosody, or text
- * invalidate a cached result even when those settings are nested in the markup.
- */
-interface ChunkFingerprintOptions {
-    outputFormat?: string;
-    region?: string;
-    endpoint?: string;
-    voice?: string;
-    lang?: string;
-    schemaVersion?: string;
-    fingerprintSchemaVersion?: string;
-    customHeaders?: Readonly<Record<string, string>>;
-}
-declare function computeChunkFingerprint(ssml: string, outputFormat?: string, options?: Omit<ChunkFingerprintOptions, "outputFormat">): string;
-interface MergeSynthesisOptions extends MergeAudioOptions {
-    customMerger?: CustomAudioMerger;
-    postMergeValidator?: PostMergeValidator;
-    deadline?: DeadlineController;
-}
-type AsyncMergeSynthesisOptions = MergeSynthesisOptions & {
-    customMerger: NonNullable<MergeSynthesisOptions["customMerger"]>;
-};
-/** Extracts the stream specification from a WAV/MP3 header and output-format fallback. */
-declare function inspectAudioSpecification(buffer: ArrayBuffer, format: string): AudioSpecification;
-/** Returns whether the named output format can be safely concatenated without re-multiplexing. */
-declare function resolveMergeAudioFormat(format: string): MergeAudioFormat | undefined;
-declare function canMergeAudioFormat(format: string): boolean;
-/** Merges audio buffers while preserving the invariants of supported containers. */
-declare function mergeAudioBuffers(buffers: readonly ArrayBuffer[], options: MergeAudioOptions): ArrayBuffer;
-/** Synthesizes one SSML document, optionally retrying transient failures within the job deadline. */
-declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult>;
-/** Synthesizes chunks with bounded concurrency, retries transient failures, and merges in chunk order. */
-declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
-declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: AsyncMergeSynthesisOptions): Promise<MergedSynthesisResult>;
-declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: MergeSynthesisOptions): MergedSynthesisResult | Promise<MergedSynthesisResult>;
-declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: MergeAudioOptions): MergedSynthesisResult;
-/** Backward-compatible audio-only synthesis helper. */
-declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
-
-interface FetchAzureVoiceCatalogOptions {
-    apiKey: string;
-    region: string | string[];
-}
-interface AzureVoiceCatalogVoice {
-    name: string;
-    locale: string;
-    secondaryLocales?: readonly string[];
-    styles?: readonly string[];
-    supportedTags?: readonly string[];
-    unsupportedTags?: readonly string[];
-    models?: readonly string[];
-    regions: readonly string[];
-    status?: "ga" | "preview" | "deprecated";
-}
-interface FetchedAzureVoiceCatalogMetadata {
-    voiceCount: number;
-    generatedAt: string;
-    apiVersion: string;
-    regions: readonly string[];
-    expiresAt?: string;
-    regionDiffs?: Readonly<Record<string, readonly string[]>>;
-}
-interface AzureVoiceCatalog {
-    voices: readonly AzureVoiceCatalogVoice[];
-    metadata: FetchedAzureVoiceCatalogMetadata;
-}
-/** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */
-declare function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog>;
-
-export { AudioFormatMismatchError, type AudioSpecification, type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, type AzureTtsOutputFormat, AzureTtsSdkError, type AzureTtsSynthesisError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, BatchChunkValidationError, type ChunkDiagnostics, type ChunkExecutionState, type ChunkExecutionStatus, type ChunkFingerprintOptions, ChunkValidationError, type CustomAudioMerger, type CustomMergerContext, DEFAULT_OUTPUT_FORMAT, DeadlineController, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, IncompleteChunkSetError, type InputAudioSpecs, type MappingStatus, type MergeAudioFormat, type MergeAudioOptions, MergeError, type MergeSynthesisOptions, type MergedSynthesisResult, type PartialChunkSynthesisResult, type PartialSynthesisResult, type PostMergeValidator, type Result, type ResumeValidationMode, type RetryOptions, type SerializedChunkError, type SerializedChunkErrorCode, type SerializedExecutionError, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisError, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, SynthesisCancelledError, type SynthesisChunkStatus, type SynthesisErrorKind, type SynthesisProgressEvent, type SynthesisResult, SynthesisTimeoutError, type SynthesisTimeouts, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type SynthesizedChunk, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, computeChunkFingerprint, fetchAzureVoiceCatalog, getRetryAfterDelayMs, inspectAudioSpecification, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, resolveMimeType, serializeChunkError, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };