@speech-sdk/core 0.8.2-alpha → 0.8.2

package/dist/stream-speech.js

@@ -1,14 +1,20 @@
 import pRetry from "p-retry";
 import { detectAudioTags, stripAudioTags } from "./audio-tags.js";
-import { ApiError, NoSpeechGeneratedError, StreamingNotSupportedError, } from "./errors.js";
-import { isRetriableApiError } from "./provider-utils.js";
+import { assertGatewayForModerationRulesetId, NoSpeechGeneratedError, StreamingNotSupportedError, } from "./errors.js";
+import { mergeRules } from "./pronunciations/merge.js";
+import { substitute } from "./pronunciations/substitute.js";
+import { validatePronunciationsInput } from "./pronunciations/validate.js";
 import { resolveModel } from "./resolve-provider.js";
-import { FEATURES, hasFeature, } from "./speech-provider.js";
+import { buildRetryOptions } from "./retry-options.js";
+import { FEATURES, hasFeature, isSpeechGatewayModel, } from "./speech-provider.js";
 export async function streamSpeech(options) {
     const { model, voice, providerOptions, abortSignal, headers } = options;
     const maxRetries = options.maxRetries ?? 2;
     const resolved = resolveModel(model, { apiKey: options.apiKey });
     const modelIdentifier = `${resolved.provider.id}/${resolved.modelId}`;
+    const isGateway = isSpeechGatewayModel(resolved);
+    validatePronunciationsInput(options.pronunciations, isGateway);
+    assertGatewayForModerationRulesetId(options.moderationRulesetId, isGateway);
     const modelInfo = resolved.provider.models.find((m) => m.id === resolved.modelId);
     if (modelInfo && !hasFeature(modelInfo, FEATURES.STREAMING)) {
         throw new StreamingNotSupportedError(modelIdentifier);
@@ -36,30 +42,41 @@ export async function streamSpeech(options) {
             ? `Text is empty after removing unsupported audio tags for ${modelIdentifier}.`
             : "Text must not be empty.");
     }
+    let textToSend = processedText;
+    if (!isGateway && options.pronunciations?.rules?.length) {
+        const ruleMap = mergeRules(options.pronunciations.rules);
+        textToSend = substitute(processedText, ruleMap).text;
+    }
     const streamFn = resolved.provider.stream.bind(resolved.provider);
     const startTime = performance.now();
-    const result = await pRetry(() => streamFn({
-        modelId: resolved.modelId,
-        text: processedText,
-        voice,
-        providerOptions,
-        abortSignal,
-        headers,
-    }), {
-        retries: maxRetries,
-        signal: abortSignal,
-        shouldRetry: ({ error }) => {
-            if (error instanceof ApiError && !isRetriableApiError(error)) {
-                return false;
-            }
-            return true;
-        },
-    });
+    const result = await pRetry(() => {
+        if (isGateway) {
+            const gatewayProvider = resolved.provider;
+            return gatewayProvider.stream({
+                modelId: resolved.modelId,
+                text: textToSend,
+                voice: voice,
+                providerOptions,
+                abortSignal,
+                headers,
+                pronunciations: options.pronunciations,
+                moderationRulesetId: options.moderationRulesetId,
+            });
+        }
+        return streamFn({
+            modelId: resolved.modelId,
+            text: textToSend,
+            voice,
+            providerOptions,
+            abortSignal,
+            headers,
+        });
+    }, buildRetryOptions({ maxRetries, abortSignal }));
     const ttfbMs = Math.round(performance.now() - startTime);
     const metadata = {
         latencyMs: ttfbMs,
         ttfbMs,
-        inputChars: processedText.length,
+        inputChars: options.text.length,
         ...(result.audioDurationMs != null && {
             audioDurationMs: result.audioDurationMs,
         }),

package/dist/stream-speech.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-speech.js","sourceRoot":"","sources":["../src/stream-speech.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream-speech.js","sourceRoot":"","sources":["../src/stream-speech.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EACL,mCAAmC,EACnC,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EACL,QAAQ,EACR,UAAU,EACV,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAGhC,OAWD;IACC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACxE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,MAAM,eAAe,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtE,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACjD,2BAA2B,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC/D,mCAAmC,CAAC,OAAO,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAE5E,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,CACjC,CAAC;IACF,IAAI,SAAS,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,0BAA0B,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,0BAA0B,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,aAAqB,CAAC;IAC1B,IAAI,QAAkB,CAAC;IAEvB,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACvC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CACrE,OAAO,CAAC,IAAI,EACZ,QAAQ,CAAC,OAAO,CACjB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,cAAc,CACjD,OAAO,CAAC,IAAI,EACZ,eAAe,CAChB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAC7B,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,sBAAsB,CAC9B,QAAQ,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,2DAA2D,eAAe,GAAG;YAC/E,CAAC,CAAC,yBAAyB,CAC9B,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,GAAG,aAAa,CAAC;IAC/B,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzD,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAElE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE;QAC/B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAiC,CAAC;YACnE,OAAO,eAAe,CAAC,MAAM,CAAC;gBAC5B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,KAA0B;gBACjC,eAAe;gBACf,WAAW;gBACX,OAAO;gBACP,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;aACjD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;YACd,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,UAAU;YAChB,KAAK;YACL,eAAe;YACf,WAAW;YACX,OAAO;SACR,CAAC,CAAC;IACL,CAAC,EAAE,iBAAiB,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAmB;QAC/B,SAAS,EAAE,MAAM;QACjB,MAAM;QACN,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;QAC/B,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,IAAI,IAAI;YACpC,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;KACH,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ;QACR,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;AACJ,CAAC"}

package/dist/text-chunker.d.ts

@@ -0,0 +1,13 @@
+export interface MaxInputCharsResolution {
+    readonly providerMaxInputChars?: number;
+    readonly source?: "provider" | "user";
+    readonly userExceedsProvider: boolean;
+    readonly userMaxInputChars?: number;
+    readonly value?: number;
+}
+export declare function resolveMaxInputChars(args: {
+    providerMaxInputChars: number | undefined;
+    userMaxInputChars: number | undefined;
+}): MaxInputCharsResolution;
+export declare function splitTextByMaxChars(text: string, maxChars: number): string[];
+//# sourceMappingURL=text-chunker.d.ts.map

package/dist/text-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-chunker.d.ts","sourceRoot":"","sources":["../src/text-chunker.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,GAAG,uBAAuB,CA0B1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA4C5E"}

package/dist/text-chunker.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { SENTENCE_BOUNDARY_RE } from "./sentence-boundaries.js";
+const WHITESPACE_RE = /\s+/g;
+const LEADING_WHITESPACE_RE = /\s/;
+const WHITESPACE_BREAK_PENALTY = 512;
+const MAX_INPUT_CHARS_SCHEMA = z.number().finite().int().positive();
+const MAX_INPUT_CHARS_RESOLUTION_SCHEMA = z.object({
+    providerMaxInputChars: MAX_INPUT_CHARS_SCHEMA.optional(),
+    userMaxInputChars: MAX_INPUT_CHARS_SCHEMA.optional(),
+});
+const SPLIT_TEXT_OPTIONS_SCHEMA = z.object({
+    maxChars: MAX_INPUT_CHARS_SCHEMA,
+});
+export function resolveMaxInputChars(args) {
+    const { providerMaxInputChars, userMaxInputChars } = parseWithMessage(MAX_INPUT_CHARS_RESOLUTION_SCHEMA, args, "maxInputChars must be a positive integer.");
+    if (userMaxInputChars != null) {
+        return {
+            providerMaxInputChars,
+            source: "user",
+            userExceedsProvider: providerMaxInputChars != null &&
+                userMaxInputChars > providerMaxInputChars,
+            userMaxInputChars,
+            value: userMaxInputChars,
+        };
+    }
+    if (providerMaxInputChars != null) {
+        return {
+            providerMaxInputChars,
+            source: "provider",
+            userExceedsProvider: false,
+            value: providerMaxInputChars,
+        };
+    }
+    return { userExceedsProvider: false };
+}
+export function splitTextByMaxChars(text, maxChars) {
+    const { maxChars: resolvedMaxChars } = parseWithMessage(SPLIT_TEXT_OPTIONS_SCHEMA, { maxChars }, "splitTextByMaxChars: maxChars must be a positive integer.");
+    const trimmed = text.trim();
+    if (trimmed.length <= resolvedMaxChars) {
+        return trimmed.length > 0 ? [trimmed] : [];
+    }
+    const breakCandidates = collectBreakCandidates(trimmed);
+    const chunks = [];
+    const chunkCount = Math.ceil(trimmed.length / resolvedMaxChars);
+    let start = 0;
+    for (let chunkIndex = 1; chunkIndex < chunkCount; chunkIndex++) {
+        const remainingChunks = chunkCount - chunkIndex;
+        const remainingLength = trimmed.length - start;
+        const idealEnd = start + Math.round(remainingLength / (remainingChunks + 1));
+        const minEnd = Math.max(start + 1, trimmed.length - remainingChunks * resolvedMaxChars);
+        const maxEnd = Math.min(start + resolvedMaxChars, trimmed.length - remainingChunks);
+        const target = clamp(idealEnd, minEnd, maxEnd);
+        const splitIndex = findSplitIndex({ breakCandidates, target, minEnd, maxEnd }) ??
+            safeSplitIndex(trimmed, target, minEnd, maxEnd);
+        const chunk = trimmed.slice(start, splitIndex).trim();
+        if (chunk.length > 0) {
+            chunks.push(chunk);
+        }
+        start = skipLeadingWhitespace(trimmed, splitIndex);
+    }
+    const finalChunk = trimmed.slice(start).trim();
+    if (finalChunk.length > 0) {
+        chunks.push(finalChunk);
+    }
+    return chunks;
+}
+function parseWithMessage(schema, value, message) {
+    try {
+        return schema.parse(value);
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new Error(message);
+        }
+        throw err;
+    }
+}
+function safeSplitIndex(text, index, minEnd, maxEnd) {
+    if (!isSurrogateBoundary(text, index)) {
+        return index;
+    }
+    const candidates = [index + 1, index - 1];
+    for (const candidate of candidates) {
+        if (candidate >= minEnd &&
+            candidate <= maxEnd &&
+            !isSurrogateBoundary(text, candidate)) {
+            return candidate;
+        }
+    }
+    return (candidates.find((candidate) => !isSurrogateBoundary(text, candidate)) ??
+        index);
+}
+function isSurrogateBoundary(text, index) {
+    if (index <= 0 || index >= text.length) {
+        return false;
+    }
+    const before = text.charCodeAt(index - 1);
+    const after = text.charCodeAt(index);
+    return (before >= 0xd8_00 &&
+        before <= 0xdb_ff &&
+        after >= 0xdc_00 &&
+        after <= 0xdf_ff);
+}
+function collectBreakCandidates(text) {
+    return {
+        paragraph: collectLiteralBreaks(text, "\n\n"),
+        line: collectLiteralBreaks(text, "\n"),
+        sentence: collectRegexBreaks(text, SENTENCE_BOUNDARY_RE),
+        whitespace: collectRegexBreaks(text, WHITESPACE_RE),
+    };
+}
+function collectLiteralBreaks(text, literal) {
+    const breaks = [];
+    let index = text.indexOf(literal);
+    while (index !== -1) {
+        breaks.push(index + literal.length);
+        index = text.indexOf(literal, index + literal.length);
+    }
+    return breaks;
+}
+function collectRegexBreaks(text, regex) {
+    const breaks = [];
+    regex.lastIndex = 0;
+    let match = regex.exec(text);
+    while (match) {
+        breaks.push(match.index + match[0].length);
+        if (match[0].length === 0) {
+            regex.lastIndex++;
+        }
+        match = regex.exec(text);
+    }
+    return breaks;
+}
+function findSplitIndex(args) {
+    let best;
+    const candidateGroups = [
+        { breaks: args.breakCandidates.paragraph, penalty: 0 },
+        { breaks: args.breakCandidates.line, penalty: 16 },
+        { breaks: args.breakCandidates.sentence, penalty: 32 },
+        {
+            breaks: args.breakCandidates.whitespace,
+            penalty: WHITESPACE_BREAK_PENALTY,
+        },
+    ];
+    for (const group of candidateGroups) {
+        for (const index of nearestCandidates(group.breaks, args.target)) {
+            if (index < args.minEnd || index > args.maxEnd) {
+                continue;
+            }
+            const score = Math.abs(index - args.target) + group.penalty;
+            if (!best || score < best.score) {
+                best = { index, score };
+            }
+        }
+    }
+    return best?.index;
+}
+function nearestCandidates(breaks, target) {
+    const upper = lowerBound(breaks, target);
+    const candidates = [];
+    const lower = upper - 1;
+    if (lower >= 0) {
+        candidates.push(breaks[lower] ?? 0);
+    }
+    if (upper < breaks.length) {
+        candidates.push(breaks[upper] ?? 0);
+    }
+    return candidates;
+}
+function lowerBound(values, target) {
+    let low = 0;
+    let high = values.length;
+    while (low < high) {
+        const mid = Math.floor((low + high) / 2);
+        if ((values[mid] ?? 0) < target) {
+            low = mid + 1;
+        }
+        else {
+            high = mid;
+        }
+    }
+    return low;
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function skipLeadingWhitespace(text, index) {
+    let next = index;
+    while (next < text.length && LEADING_WHITESPACE_RE.test(text[next] ?? "")) {
+        next++;
+    }
+    return next;
+}
+//# sourceMappingURL=text-chunker.js.map

package/dist/text-chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-chunker.js","sourceRoot":"","sources":["../src/text-chunker.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,9 +1,11 @@
 import type { AudioOutput } from "./audio-output.js";
+import type { PronunciationsFor } from "./pronunciations/types.js";
 import type { ResolvedModel, Voice } from "./speech-provider.js";
 export type { AudioOutput, AudioOutputFormat } from "./audio-output.js";
 export type { CaptionFormat, CaptionsOptions } from "./captions.js";
 export type { ConversationTurn, GenerateConversationOptions, } from "./conversation/types.js";
 export type { SpeechMetadata } from "./metadata.js";
+export type { Pronunciation, PronunciationsInput, } from "./pronunciations/types.js";
 export type { CartesiaSpeechProviderConfig } from "./providers/cartesia/index.js";
 export type { DeepgramSpeechProviderConfig } from "./providers/deepgram/index.js";
 export type { ElevenLabsSpeechProviderConfig } from "./providers/elevenlabs/index.js";
@@ -24,13 +26,16 @@ export type { ResolvedSTTModel, SpeechToTextProvider, STTModelInfo, } from "./sp
 export type { StreamSpeechResult } from "./stream-speech-result.js";
 export type { ConversationWordTimestamp, WordTimestamp, } from "./timestamps.js";
 export type { TurnTimestamp } from "./turns.js";
-export interface GenerateSpeechOptions<V extends Voice = Voice> {
+export interface GenerateSpeechOptions<V extends Voice = Voice, M extends string | ResolvedModel<V> = string | ResolvedModel<V>> {
     abortSignal?: AbortSignal;
     apiKey?: string;
     headers?: Record<string, string>;
+    maxInputChars?: number;
     maxRetries?: number;
-    model: string | ResolvedModel<V>;
+    model: M;
+    moderationRulesetId?: string;
     output?: AudioOutput;
+    pronunciations?: PronunciationsFor<M>;
     providerOptions?: Record<string, unknown>;
     text: string;
     timestamps?: boolean;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEjE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EACV,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,YAAY,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,YAAY,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACtF,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AACrF,YAAY,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,YAAY,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,cAAc,EACd,KAAK,GACN,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GACb,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,yBAAyB,EACzB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/volume-adjust.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"volume-adjust.d.ts","sourceRoot":"","sources":["../src/volume-adjust.ts"],"names":[],"mappings":"AAOA,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,UAAU,CAAC,CAgBrB"}
+{"version":3,"file":"volume-adjust.d.ts","sourceRoot":"","sources":["../src/volume-adjust.ts"],"names":[],"mappings":"AAQA,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,UAAU,CAAC,CAgBrB"}

package/dist/volume-adjust.js

@@ -1,21 +1,15 @@
-import { concatPcmToWav, dbfsToInt16Rms, decodeToPcm16, normalizeRms, } from "./conversation/pcm-concat.js";
+import { decodeAudioToPcm16 } from "./audio-decode.js";
+import { base64ToUint8Array } from "./audio-utils.js";
+import { concatPcmToWav, dbfsToInt16Rms, normalizeRms, } from "./conversation/pcm-concat.js";
 export async function adjustVolume(input) {
     const bytes = input.audio instanceof Uint8Array
         ? input.audio
         : base64ToUint8Array(input.audio);
-    const segment = decodeToPcm16(bytes, input.mediaType);
+    const segment = await decodeAudioToPcm16(bytes, input.mediaType);
     const [normalized] = normalizeRms([segment], dbfsToInt16Rms(input.volumeDbfs));
     return await concatPcmToWav([normalized], {
         gapMs: 0,
         targetSampleRate: normalized.sampleRate,
     });
 }
-function base64ToUint8Array(b64) {
-    const binaryString = atob(b64);
-    const out = new Uint8Array(binaryString.length);
-    for (let i = 0; i < binaryString.length; i++) {
-        out[i] = binaryString.charCodeAt(i);
-    }
-    return out;
-}
 //# sourceMappingURL=volume-adjust.js.map

package/dist/volume-adjust.js.map

@@ -1 +1 @@
-{"version":3,"file":"volume-adjust.js","sourceRoot":"","sources":["../src/volume-adjust.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,8BAA8B,CAAC;AAQtC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB;IAExB,MAAM,KAAK,GACT,KAAK,CAAC,KAAK,YAAY,UAAU;QAC/B,CAAC,CAAC,KAAK,CAAC,KAAK;QACb,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,CAAC,UAAU,CAAC,GAAG,YAAY,CAC/B,CAAC,OAAO,CAAC,EACT,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CACjC,CAAC;IAEF,OAAO,MAAM,cAAc,CAAC,CAAC,UAAU,CAAC,EAAE;QACxC,KAAK,EAAE,CAAC;QACR,gBAAgB,EAAE,UAAU,CAAC,UAAU;KACxC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"volume-adjust.js","sourceRoot":"","sources":["../src/volume-adjust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,8BAA8B,CAAC;AAQtC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB;IAExB,MAAM,KAAK,GACT,KAAK,CAAC,KAAK,YAAY,UAAU;QAC/B,CAAC,CAAC,KAAK,CAAC,KAAK;QACb,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,CAAC,UAAU,CAAC,GAAG,YAAY,CAC/B,CAAC,OAAO,CAAC,EACT,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CACjC,CAAC;IAEF,OAAO,MAAM,cAAc,CAAC,CAAC,UAAU,CAAC,EAAE;QACxC,KAAK,EAAE,CAAC;QACR,gBAAgB,EAAE,UAAU,CAAC,UAAU;KACxC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speech-sdk/core",
-  "version": "0.8.2-alpha",
+  "version": "0.8.2",
   "description": "Universal, cross-platform text-to-speech SDK with multi-provider support.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,13 +17,17 @@
     "./types": {
       "types": "./dist/types.d.ts",
       "default": "./dist/types.js"
+    },
+    "./pronunciations": {
+      "types": "./dist/pronunciations/index.d.ts",
+      "default": "./dist/pronunciations/index.js"
     }
   },
   "files": [
     "dist",
-    "README.md",
-    "NOTICE"
+    "README.md"
   ],
+  "sideEffects": false,
   "keywords": [
     "tts",
     "text-to-speech",
@@ -39,13 +43,13 @@
     "url": "https://github.com/Jellypod-Inc/speech-sdk"
   },
   "dependencies": {
-    "@breezystack/lamejs": "^1.2.7",
+    "@mediabunny/mp3-encoder": "^1.42.0",
     "mediabunny": "^1.40.1",
     "p-retry": "^8.0.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.13",
+    "@biomejs/biome": "2.4.14",
     "@types/node": "^25.5.0",
     "dotenv": "^17.3.1",
     "typescript": "^5.8.0",

package/NOTICE

@@ -1,27 +0,0 @@
-@speech-sdk/core
-Copyright (c) Jellypod, Inc.
-
-This product is licensed under the Apache License, Version 2.0 (see LICENSE).
-
-It uses the following third-party software with separate license terms:
-
-================================================================================
-@breezystack/lamejs (LGPL-3.0-or-later)
-================================================================================
-
-MP3 encoding for `output: { format: "mp3" }` is performed by `@breezystack/lamejs`,
-a JavaScript port of the LAME MP3 encoder.
-
-  - Package:  https://www.npmjs.com/package/@breezystack/lamejs
-  - LAME:     https://lame.sourceforge.net/
-  - License:  GNU Lesser General Public License v3.0 or later
-              https://www.gnu.org/licenses/lgpl-3.0.html
-
-`@speech-sdk/core` does not bundle, statically link, or modify lamejs. It is
-declared as a regular npm dependency and loaded at runtime via dynamic
-`import()` only when the caller requests MP3 output. End users receive lamejs
-as a separate package in their `node_modules` tree and can substitute or
-upgrade it via standard npm overrides.
-
-If you modify the lamejs source you must release those modifications under the
-LGPL, per the upstream license terms.