@speech-sdk/core 0.2.0 → 0.4.0

package/dist/sse-stream.js

@@ -0,0 +1,101 @@
+const LEADING_SPACE = /^ /;
+function base64ToBytes(b64) {
+    const binaryString = atob(b64);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+function parseEventData(rawEvent) {
+    const dataLines = [];
+    for (const rawLine of rawEvent.split("\n")) {
+        const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+        if (line.startsWith("data:")) {
+            dataLines.push(line.slice(5).replace(LEADING_SPACE, ""));
+        }
+    }
+    if (dataLines.length === 0) {
+        return null;
+    }
+    return dataLines.join("\n");
+}
+function processEvent(eventData, options, controller, setMetadata) {
+    const b64 = options.extractBase64(eventData);
+    if (b64) {
+        controller.enqueue(base64ToBytes(b64));
+    }
+    if (options.extractMetadata) {
+        const m = options.extractMetadata(eventData);
+        if (m) {
+            setMetadata(m);
+        }
+    }
+}
+function drainBuffer(state, options, controller, setMetadata) {
+    for (;;) {
+        const lfIndex = state.buffer.indexOf("\n\n");
+        const crlfIndex = state.buffer.indexOf("\r\n\r\n");
+        let sepIndex;
+        let sepLength;
+        if (crlfIndex !== -1 && (lfIndex === -1 || crlfIndex < lfIndex)) {
+            sepIndex = crlfIndex;
+            sepLength = 4;
+        }
+        else if (lfIndex === -1) {
+            break;
+        }
+        else {
+            sepIndex = lfIndex;
+            sepLength = 2;
+        }
+        const rawEvent = state.buffer.slice(0, sepIndex);
+        state.buffer = state.buffer.slice(sepIndex + sepLength);
+        const eventData = parseEventData(rawEvent);
+        if (eventData === null) {
+            continue;
+        }
+        processEvent(eventData, options, controller, setMetadata);
+    }
+}
+export function parseSseBase64Stream(source, options) {
+    let resolveMetadata;
+    const metadata = new Promise((res) => {
+        resolveMetadata = res;
+    });
+    let metadataResolved = false;
+    const setMetadata = (m) => {
+        if (metadataResolved) {
+            return;
+        }
+        metadataResolved = true;
+        resolveMetadata(m);
+    };
+    const decoder = new TextDecoder();
+    const state = { buffer: "" };
+    const stream = new ReadableStream({
+        async start(controller) {
+            const reader = source.getReader();
+            try {
+                while (true) {
+                    const { value, done } = await reader.read();
+                    if (done) {
+                        state.buffer += decoder.decode();
+                        drainBuffer(state, options, controller, setMetadata);
+                        break;
+                    }
+                    state.buffer += decoder.decode(value, { stream: true });
+                    drainBuffer(state, options, controller, setMetadata);
+                }
+                controller.close();
+                setMetadata(undefined);
+            }
+            catch (err) {
+                controller.error(err);
+                setMetadata(undefined);
+            }
+        },
+    });
+    return { stream, metadata };
+}
+//# sourceMappingURL=sse-stream.js.map

package/dist/sse-stream.js.map

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

package/dist/stream-speech-result.d.ts

@@ -0,0 +1,7 @@
+export interface StreamSpeechResult {
+    readonly audio: ReadableStream<Uint8Array>;
+    readonly mediaType: string;
+    readonly providerMetadata?: Record<string, unknown>;
+    readonly warnings?: string[];
+}
+//# sourceMappingURL=stream-speech-result.d.ts.map

package/dist/stream-speech-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-speech-result.d.ts","sourceRoot":"","sources":["../src/stream-speech-result.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B"}

package/dist/stream-speech-result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stream-speech-result.js.map

package/dist/stream-speech-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-speech-result.js","sourceRoot":"","sources":["../src/stream-speech-result.ts"],"names":[],"mappings":""}

package/dist/stream-speech.d.ts

@@ -0,0 +1,12 @@
+import { type ResolvedModel, type Voice } from "./speech-provider.js";
+import type { StreamSpeechResult } from "./stream-speech-result.js";
+export declare function streamSpeech<V extends Voice = Voice>(options: {
+    model: string | ResolvedModel<V>;
+    text: string;
+    voice: V;
+    providerOptions?: Record<string, unknown>;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+}): Promise<StreamSpeechResult>;
+//# sourceMappingURL=stream-speech.d.ts.map

package/dist/stream-speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-speech.d.ts","sourceRoot":"","sources":["../src/stream-speech.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,wBAAsB,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,OAAO,EAAE;IACnE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;IACT,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4E9B"}

package/dist/stream-speech.js

@@ -0,0 +1,63 @@
+import pRetry from "p-retry";
+import { detectAudioTags, stripAudioTags } from "./audio-tags.js";
+import { ApiError, NoSpeechGeneratedError, StreamingNotSupportedError, } from "./errors.js";
+import { resolveModel } from "./resolve-provider.js";
+import { FEATURES, hasFeature, } 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);
+    const modelIdentifier = `${resolved.provider.id}/${resolved.modelId}`;
+    const modelInfo = resolved.provider.models.find((m) => m.id === resolved.modelId);
+    if (modelInfo && !hasFeature(modelInfo, FEATURES.STREAMING)) {
+        throw new StreamingNotSupportedError(modelIdentifier);
+    }
+    if (typeof resolved.provider.stream !== "function") {
+        throw new StreamingNotSupportedError(modelIdentifier);
+    }
+    let processedText;
+    let warnings;
+    if (resolved.provider.processAudioTags) {
+        ({ text: processedText, warnings } = resolved.provider.processAudioTags(options.text, resolved.modelId));
+    }
+    else {
+        const tags = detectAudioTags(options.text);
+        if (tags.length > 0) {
+            ({ text: processedText, warnings } = stripAudioTags(options.text, modelIdentifier));
+        }
+        else {
+            processedText = options.text;
+            warnings = [];
+        }
+    }
+    if (processedText.trim().length === 0) {
+        throw new NoSpeechGeneratedError(warnings.length > 0
+            ? `Text is empty after removing unsupported audio tags for ${modelIdentifier}.`
+            : "Text must not be empty.");
+    }
+    const streamFn = resolved.provider.stream.bind(resolved.provider);
+    const result = await pRetry(() => streamFn({
+        modelId: resolved.modelId,
+        text: processedText,
+        voice,
+        providerOptions,
+        abortSignal,
+        headers,
+    }), {
+        retries: maxRetries,
+        signal: abortSignal,
+        shouldRetry: ({ error }) => {
+            if (error instanceof ApiError && error.statusCode < 500) {
+                return false;
+            }
+            return true;
+        },
+    });
+    return {
+        audio: result.stream,
+        mediaType: result.mediaType,
+        providerMetadata: result.providerMetadata,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+//# sourceMappingURL=stream-speech.js.map

package/dist/stream-speech.js.map

@@ -0,0 +1 @@
+{"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,QAAQ,EACR,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,QAAQ,EACR,UAAU,GAGX,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAA0B,OAQ3D;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,CAAC,CAAC;IACrC,MAAM,eAAe,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEtE,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,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAElE,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,GAAG,EAAE,CACH,QAAQ,CAAC;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,aAAa;QACnB,KAAK;QACL,eAAe;QACf,WAAW;QACX,OAAO;KACR,CAAC,EACJ;QACE,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;YACzB,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBACxD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CACF,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speech-sdk/core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Universal, cross-platform text-to-speech SDK with multi-provider support.",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,6 +57,10 @@
     "./mistral": {
       "types": "./dist/providers/mistral/index.d.ts",
       "default": "./dist/providers/mistral/index.js"
+    },
+    "./xai": {
+      "types": "./dist/providers/xai/index.d.ts",
+      "default": "./dist/providers/xai/index.js"
     }
   },
   "files": [