@cartesia/cartesia-js 2.2.8 → 3.0.0-b3

package/dist/wrapper/SttWebsocket.js

@@ -1,219 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _SttWebsocket_instances, _SttWebsocket_isConnected, _SttWebsocket_model, _SttWebsocket_language, _SttWebsocket_encoding, _SttWebsocket_sampleRate, _SttWebsocket_minVolume, _SttWebsocket_maxSilenceDurationSecs, _SttWebsocket_connectionPromise, _SttWebsocket_ensureConnected;
-Object.defineProperty(exports, "__esModule", { value: true });
-const core = __importStar(require("../core"));
-const environments = __importStar(require("../environments"));
-const websocket_1 = require("../core/websocket");
-class SttWebsocket {
-    constructor({ model = "ink-whisper", language = "en", encoding, sampleRate, minVolume, maxSilenceDurationSecs, }, options) {
-        _SttWebsocket_instances.add(this);
-        this.options = options;
-        _SttWebsocket_isConnected.set(this, false);
-        _SttWebsocket_model.set(this, void 0);
-        _SttWebsocket_language.set(this, void 0);
-        _SttWebsocket_encoding.set(this, void 0);
-        _SttWebsocket_sampleRate.set(this, void 0);
-        _SttWebsocket_minVolume.set(this, void 0);
-        _SttWebsocket_maxSilenceDurationSecs.set(this, void 0);
-        _SttWebsocket_connectionPromise.set(this, void 0);
-        if (!model) {
-            throw new Error("model parameter is required");
-        }
-        if (!encoding) {
-            throw new Error("encoding parameter is required");
-        }
-        if (!sampleRate) {
-            throw new Error("sampleRate parameter is required");
-        }
-        __classPrivateFieldSet(this, _SttWebsocket_model, model, "f");
-        __classPrivateFieldSet(this, _SttWebsocket_language, language, "f");
-        __classPrivateFieldSet(this, _SttWebsocket_encoding, encoding, "f");
-        __classPrivateFieldSet(this, _SttWebsocket_sampleRate, sampleRate, "f");
-        __classPrivateFieldSet(this, _SttWebsocket_minVolume, minVolume, "f");
-        __classPrivateFieldSet(this, _SttWebsocket_maxSilenceDurationSecs, maxSilenceDurationSecs, "f");
-    }
-    send(audioData) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            yield __classPrivateFieldGet(this, _SttWebsocket_instances, "m", _SttWebsocket_ensureConnected).call(this);
-            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send(audioData);
-        });
-    }
-    finalize() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            yield __classPrivateFieldGet(this, _SttWebsocket_instances, "m", _SttWebsocket_ensureConnected).call(this);
-            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send("finalize");
-        });
-    }
-    done() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            yield __classPrivateFieldGet(this, _SttWebsocket_instances, "m", _SttWebsocket_ensureConnected).call(this);
-            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send("done");
-        });
-    }
-    onMessage(callback) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield __classPrivateFieldGet(this, _SttWebsocket_instances, "m", _SttWebsocket_ensureConnected).call(this);
-            if (!this.socket) {
-                throw new Error("WebSocket failed to initialize after connection attempt.");
-            }
-            this.socket.addEventListener("message", (event) => {
-                try {
-                    const data = JSON.parse(event.data);
-                    const result = {
-                        type: data.type,
-                        requestId: data.request_id || "",
-                    };
-                    // Handle different message types according to stt.yml spec
-                    if (data.type === "transcript") {
-                        result.text = data.text || "";
-                        result.isFinal = data.is_final || false;
-                        result.duration = data.duration;
-                        result.language = data.language;
-                        // Include word-level timestamps if available
-                        if (data.words) {
-                            result.words = data.words;
-                        }
-                    }
-                    else if (data.type === "flush_done") {
-                        // Acknowledgment for finalize command
-                        // Only requestId is needed for flush_done
-                    }
-                    else if (data.type === "done") {
-                        // Acknowledgment for done command - session complete
-                        // Only requestId is needed for done
-                    }
-                    else if (data.type === "error") {
-                        result.message = data.message;
-                    }
-                    callback(result);
-                }
-                catch (error) {
-                    callback({
-                        type: "error",
-                        requestId: "",
-                        message: `Failed to parse message: ${error}`,
-                    });
-                }
-            });
-        });
-    }
-    connect() {
-        return __awaiter(this, arguments, void 0, function* (connectOptions = {}) {
-            if (__classPrivateFieldGet(this, _SttWebsocket_isConnected, "f")) {
-                throw new Error("WebSocket is already connected.");
-            }
-            this.socket = new websocket_1.ReconnectingWebSocket(() => __awaiter(this, void 0, void 0, function* () {
-                var _a;
-                const baseUrl = ((_a = (yield core.Supplier.get(this.options.environment))) !== null && _a !== void 0 ? _a : environments.CartesiaEnvironment.Production).replace(/^https?:\/\//, "");
-                const params = {
-                    model: __classPrivateFieldGet(this, _SttWebsocket_model, "f"),
-                    cartesia_version: this.options.cartesiaVersion || "2024-06-10",
-                    encoding: __classPrivateFieldGet(this, _SttWebsocket_encoding, "f"),
-                    sample_rate: __classPrivateFieldGet(this, _SttWebsocket_sampleRate, "f").toString(),
-                };
-                if (__classPrivateFieldGet(this, _SttWebsocket_language, "f"))
-                    params.language = __classPrivateFieldGet(this, _SttWebsocket_language, "f");
-                if (__classPrivateFieldGet(this, _SttWebsocket_minVolume, "f") !== undefined)
-                    params.min_volume = __classPrivateFieldGet(this, _SttWebsocket_minVolume, "f").toString();
-                if (__classPrivateFieldGet(this, _SttWebsocket_maxSilenceDurationSecs, "f") !== undefined)
-                    params.max_silence_duration_secs = __classPrivateFieldGet(this, _SttWebsocket_maxSilenceDurationSecs, "f").toString();
-                const apiKey = yield core.Supplier.get(this.options.apiKey);
-                if (apiKey) {
-                    params.api_key = apiKey;
-                }
-                else if (connectOptions.accessToken) {
-                    params.access_token = connectOptions.accessToken;
-                }
-                const queryString = Object.keys(params)
-                    .map(key => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`)
-                    .join('&');
-                return `wss://${baseUrl}/stt/websocket?${queryString}`;
-            }), undefined, connectOptions);
-            return new Promise((resolve, reject) => {
-                this.socket.onopen = () => {
-                    __classPrivateFieldSet(this, _SttWebsocket_isConnected, true, "f");
-                    resolve();
-                };
-                this.socket.onclose = () => {
-                    __classPrivateFieldSet(this, _SttWebsocket_isConnected, false, "f");
-                };
-                this.socket.onerror = () => {
-                    reject(new Error("WebSocket failed to connect."));
-                };
-                this.socket.reconnect();
-            });
-        });
-    }
-    disconnect() {
-        var _a;
-        (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();
-        __classPrivateFieldSet(this, _SttWebsocket_isConnected, false, "f");
-    }
-}
-_SttWebsocket_isConnected = new WeakMap(), _SttWebsocket_model = new WeakMap(), _SttWebsocket_language = new WeakMap(), _SttWebsocket_encoding = new WeakMap(), _SttWebsocket_sampleRate = new WeakMap(), _SttWebsocket_minVolume = new WeakMap(), _SttWebsocket_maxSilenceDurationSecs = new WeakMap(), _SttWebsocket_connectionPromise = new WeakMap(), _SttWebsocket_instances = new WeakSet(), _SttWebsocket_ensureConnected = function _SttWebsocket_ensureConnected() {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (__classPrivateFieldGet(this, _SttWebsocket_isConnected, "f"))
-            return;
-        if (!__classPrivateFieldGet(this, _SttWebsocket_connectionPromise, "f")) {
-            __classPrivateFieldSet(this, _SttWebsocket_connectionPromise, this.connect(), "f");
-        }
-        yield __classPrivateFieldGet(this, _SttWebsocket_connectionPromise, "f");
-    });
-};
-exports.default = SttWebsocket;

package/dist/wrapper/WebPlayer.d.ts

@@ -1,44 +0,0 @@
-import type Source from "./source";
-export declare class WebPlayer {
-    #private;
-    /**
-     * Create a new Player.
-     *
-     * @param options - Options for the Player.
-     * @param options.bufferDuration - The duration of the audio buffer to play.
-     */
-    constructor({ bufferDuration }: {
-        bufferDuration: number;
-    });
-    /**
-     * Play audio from a source.
-     *
-     * @param source The source to play audio from.
-     * @returns A promise that resolves when the audio has finished playing.
-     */
-    play(source: Source): Promise<void>;
-    /**
-     * Pause the audio.
-     *
-     * @returns A promise that resolves when the audio has been paused.
-     */
-    pause(): Promise<void>;
-    /**
-     * Resume the audio.
-     *
-     * @returns A promise that resolves when the audio has been resumed.
-     */
-    resume(): Promise<void>;
-    /**
-     * Toggle the audio.
-     *
-     * @returns A promise that resolves when the audio has been toggled.
-     */
-    toggle(): Promise<void>;
-    /**
-     * Stop the audio.
-     *
-     * @returns A promise that resolves when the audio has been stopped.
-     */
-    stop(): Promise<void>;
-}

package/dist/wrapper/WebPlayer.js

@@ -1,141 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _WebPlayer_instances, _WebPlayer_context, _WebPlayer_startNextPlaybackAt, _WebPlayer_bufferDuration, _WebPlayer_playBuffer;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebPlayer = void 0;
-const utils_1 = require("./utils");
-class WebPlayer {
-    /**
-     * Create a new Player.
-     *
-     * @param options - Options for the Player.
-     * @param options.bufferDuration - The duration of the audio buffer to play.
-     */
-    constructor({ bufferDuration }) {
-        _WebPlayer_instances.add(this);
-        _WebPlayer_context.set(this, null);
-        _WebPlayer_startNextPlaybackAt.set(this, 0);
-        _WebPlayer_bufferDuration.set(this, void 0);
-        __classPrivateFieldSet(this, _WebPlayer_bufferDuration, bufferDuration, "f");
-    }
-    /**
-     * Play audio from a source.
-     *
-     * @param source The source to play audio from.
-     * @returns A promise that resolves when the audio has finished playing.
-     */
-    play(source) {
-        return __awaiter(this, void 0, void 0, function* () {
-            __classPrivateFieldSet(this, _WebPlayer_startNextPlaybackAt, 0, "f");
-            __classPrivateFieldSet(this, _WebPlayer_context, new AudioContext({ sampleRate: source.sampleRate }), "f");
-            const buffer = new Float32Array(source.durationToSampleCount(__classPrivateFieldGet(this, _WebPlayer_bufferDuration, "f")));
-            const plays = [];
-            while (true) {
-                const read = yield source.read(buffer);
-                // If we've reached the end of the source, then read < buffer.length.
-                // In that case, we don't want to play the entire buffer, as that
-                // will cause repeated audio.
-                // So we set the buffer to the correct length.
-                const playableAudio = buffer.subarray(0, read);
-                plays.push(__classPrivateFieldGet(this, _WebPlayer_instances, "m", _WebPlayer_playBuffer).call(this, playableAudio, source.sampleRate));
-                if (read < buffer.length) {
-                    // No more audio to read.
-                    break;
-                }
-            }
-            yield Promise.all(plays);
-        });
-    }
-    /**
-     * Pause the audio.
-     *
-     * @returns A promise that resolves when the audio has been paused.
-     */
-    pause() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!__classPrivateFieldGet(this, _WebPlayer_context, "f")) {
-                throw new Error("AudioContext not initialized.");
-            }
-            yield __classPrivateFieldGet(this, _WebPlayer_context, "f").suspend();
-        });
-    }
-    /**
-     * Resume the audio.
-     *
-     * @returns A promise that resolves when the audio has been resumed.
-     */
-    resume() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!__classPrivateFieldGet(this, _WebPlayer_context, "f")) {
-                throw new Error("AudioContext not initialized.");
-            }
-            yield __classPrivateFieldGet(this, _WebPlayer_context, "f").resume();
-        });
-    }
-    /**
-     * Toggle the audio.
-     *
-     * @returns A promise that resolves when the audio has been toggled.
-     */
-    toggle() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!__classPrivateFieldGet(this, _WebPlayer_context, "f")) {
-                throw new Error("AudioContext not initialized.");
-            }
-            if (__classPrivateFieldGet(this, _WebPlayer_context, "f").state === "running") {
-                yield this.pause();
-            }
-            else {
-                yield this.resume();
-            }
-        });
-    }
-    /**
-     * Stop the audio.
-     *
-     * @returns A promise that resolves when the audio has been stopped.
-     */
-    stop() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            if (!__classPrivateFieldGet(this, _WebPlayer_context, "f")) {
-                throw new Error("AudioContext not initialized.");
-            }
-            yield ((_a = __classPrivateFieldGet(this, _WebPlayer_context, "f")) === null || _a === void 0 ? void 0 : _a.close());
-        });
-    }
-}
-exports.WebPlayer = WebPlayer;
-_WebPlayer_context = new WeakMap(), _WebPlayer_startNextPlaybackAt = new WeakMap(), _WebPlayer_bufferDuration = new WeakMap(), _WebPlayer_instances = new WeakSet(), _WebPlayer_playBuffer = function _WebPlayer_playBuffer(buf, sampleRate) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!__classPrivateFieldGet(this, _WebPlayer_context, "f")) {
-            throw new Error("AudioContext not initialized.");
-        }
-        if (buf.length === 0) {
-            return;
-        }
-        const startAt = __classPrivateFieldGet(this, _WebPlayer_startNextPlaybackAt, "f");
-        const duration = buf.length / sampleRate;
-        __classPrivateFieldSet(this, _WebPlayer_startNextPlaybackAt, duration + Math.max(__classPrivateFieldGet(this, _WebPlayer_context, "f").currentTime, __classPrivateFieldGet(this, _WebPlayer_startNextPlaybackAt, "f")), "f");
-        yield (0, utils_1.playAudioBuffer)(buf, __classPrivateFieldGet(this, _WebPlayer_context, "f"), startAt, sampleRate);
-    });
-};

package/dist/wrapper/Websocket.d.ts

@@ -1,40 +0,0 @@
-import { ReconnectingWebSocket, Options } from "../core/websocket";
-import type { WebSocketStreamOptions, WebSocketTtsRequest, WordTimestamps } from "../api";
-import { ConnectionEventData, WebSocketOptions, EmitteryCallbacks } from "./utils";
-import { Tts } from "../api/resources/tts/client/Client";
-import Source from "./source";
-export default class Websocket {
-    #private;
-    private readonly options;
-    socket?: ReconnectingWebSocket;
-    constructor({ sampleRate, container, encoding }: WebSocketOptions, options: Tts.Options);
-    /**
-     * Send a message over the WebSocket to start a stream.
-     *
-     * @param inputs - Generation parameters. Defined in the StreamRequest type.
-     * @param options - Options for the stream.
-     * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
-     *                          If set to `0`, the stream will not time out.
-     * @returns A Source object that can be passed to a Player to play the audio.
-     * @returns An Emittery instance that emits messages from the WebSocket.
-     */
-    send(inputs: WebSocketTtsRequest, { timeout }?: WebSocketStreamOptions): Promise<EmitteryCallbacks<{
-        message: string;
-        timestamps: WordTimestamps;
-    }> & {
-        source: Source;
-        stop: unknown;
-    }>;
-    continue(inputs: WebSocketTtsRequest): Promise<void>;
-    /**
-     * Authenticate and connect to a Cartesia streaming WebSocket.
-     *
-     * @returns A promise that resolves when the WebSocket is connected.
-     * @throws {Error} If the WebSocket fails to connect.
-     */
-    connect(options?: Options): Promise<EmitteryCallbacks<ConnectionEventData>>;
-    /**
-     * Disconnect from the Cartesia streaming WebSocket.
-     */
-    disconnect(): void;
-}