@cartesia/cartesia-js 2.2.4 → 2.2.7

package/dist/serialization/resources/tts/types/SseOutputFormat.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseOutputFormat = void 0;
+const core = __importStar(require("../../../../core"));
+const RawEncoding_1 = require("./RawEncoding");
+exports.SseOutputFormat = core.serialization.object({
+    container: core.serialization.stringLiteral("raw"),
+    encoding: RawEncoding_1.RawEncoding,
+    sampleRate: core.serialization.property("sample_rate", core.serialization.number()),
+});

package/dist/serialization/resources/tts/types/TtsRequest.d.ts

@@ -7,6 +7,7 @@ import * as core from "../../../../core";
 import { TtsRequestVoiceSpecifier } from "./TtsRequestVoiceSpecifier";
 import { SupportedLanguage } from "./SupportedLanguage";
 import { OutputFormat } from "./OutputFormat";
+import { GenerationConfig } from "./GenerationConfig";
 import { ModelSpeed } from "./ModelSpeed";
 export declare const TtsRequest: core.serialization.ObjectSchema<serializers.TtsRequest.Raw, Cartesia.TtsRequest>;
 export declare namespace TtsRequest {
@@ -16,6 +17,7 @@ export declare namespace TtsRequest {
         voice: TtsRequestVoiceSpecifier.Raw;
         language?: SupportedLanguage.Raw | null;
         output_format: OutputFormat.Raw;
+        generation_config?: GenerationConfig.Raw | null;
         duration?: number | null;
         speed?: ModelSpeed.Raw | null;
     }

package/dist/serialization/resources/tts/types/TtsRequest.js

@@ -41,6 +41,7 @@ const core = __importStar(require("../../../../core"));
 const TtsRequestVoiceSpecifier_1 = require("./TtsRequestVoiceSpecifier");
 const SupportedLanguage_1 = require("./SupportedLanguage");
 const OutputFormat_1 = require("./OutputFormat");
+const GenerationConfig_1 = require("./GenerationConfig");
 const ModelSpeed_1 = require("./ModelSpeed");
 exports.TtsRequest = core.serialization.object({
     modelId: core.serialization.property("model_id", core.serialization.string()),
@@ -48,6 +49,7 @@ exports.TtsRequest = core.serialization.object({
     voice: TtsRequestVoiceSpecifier_1.TtsRequestVoiceSpecifier,
     language: SupportedLanguage_1.SupportedLanguage.optional(),
     outputFormat: core.serialization.property("output_format", OutputFormat_1.OutputFormat),
+    generationConfig: core.serialization.property("generation_config", GenerationConfig_1.GenerationConfig.optional()),
     duration: core.serialization.number().optional(),
     speed: ModelSpeed_1.ModelSpeed.optional(),
 });

package/dist/serialization/resources/tts/types/TtssseRequest.d.ts

@@ -0,0 +1,29 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../../../index";
+import * as Cartesia from "../../../../api/index";
+import * as core from "../../../../core";
+import { TtsRequestVoiceSpecifier } from "./TtsRequestVoiceSpecifier";
+import { SupportedLanguage } from "./SupportedLanguage";
+import { SseOutputFormat } from "./SseOutputFormat";
+import { GenerationConfig } from "./GenerationConfig";
+import { ModelSpeed } from "./ModelSpeed";
+import { ContextId } from "./ContextId";
+export declare const TtssseRequest: core.serialization.ObjectSchema<serializers.TtssseRequest.Raw, Cartesia.TtssseRequest>;
+export declare namespace TtssseRequest {
+    interface Raw {
+        model_id: string;
+        transcript: string;
+        voice: TtsRequestVoiceSpecifier.Raw;
+        language?: SupportedLanguage.Raw | null;
+        output_format: SseOutputFormat.Raw;
+        generation_config?: GenerationConfig.Raw | null;
+        duration?: number | null;
+        speed?: ModelSpeed.Raw | null;
+        add_timestamps?: boolean | null;
+        add_phoneme_timestamps?: boolean | null;
+        use_normalized_timestamps?: boolean | null;
+        context_id?: ContextId.Raw | null;
+    }
+}

package/dist/serialization/resources/tts/types/TtssseRequest.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TtssseRequest = void 0;
+const core = __importStar(require("../../../../core"));
+const TtsRequestVoiceSpecifier_1 = require("./TtsRequestVoiceSpecifier");
+const SupportedLanguage_1 = require("./SupportedLanguage");
+const SseOutputFormat_1 = require("./SseOutputFormat");
+const GenerationConfig_1 = require("./GenerationConfig");
+const ModelSpeed_1 = require("./ModelSpeed");
+const ContextId_1 = require("./ContextId");
+exports.TtssseRequest = core.serialization.object({
+    modelId: core.serialization.property("model_id", core.serialization.string()),
+    transcript: core.serialization.string(),
+    voice: TtsRequestVoiceSpecifier_1.TtsRequestVoiceSpecifier,
+    language: SupportedLanguage_1.SupportedLanguage.optional(),
+    outputFormat: core.serialization.property("output_format", SseOutputFormat_1.SseOutputFormat),
+    generationConfig: core.serialization.property("generation_config", GenerationConfig_1.GenerationConfig.optional()),
+    duration: core.serialization.number().optional(),
+    speed: ModelSpeed_1.ModelSpeed.optional(),
+    addTimestamps: core.serialization.property("add_timestamps", core.serialization.boolean().optional()),
+    addPhonemeTimestamps: core.serialization.property("add_phoneme_timestamps", core.serialization.boolean().optional()),
+    useNormalizedTimestamps: core.serialization.property("use_normalized_timestamps", core.serialization.boolean().optional()),
+    contextId: core.serialization.property("context_id", ContextId_1.ContextId.optional()),
+});

package/dist/serialization/resources/tts/types/WebSocketTtsRequest.d.ts

@@ -5,6 +5,7 @@ import * as serializers from "../../../index";
 import * as Cartesia from "../../../../api/index";
 import * as core from "../../../../core";
 import { OutputFormat } from "./OutputFormat";
+import { GenerationConfig } from "./GenerationConfig";
 import { TtsRequestVoiceSpecifier } from "./TtsRequestVoiceSpecifier";
 import { ModelSpeed } from "./ModelSpeed";
 export declare const WebSocketTtsRequest: core.serialization.ObjectSchema<serializers.WebSocketTtsRequest.Raw, Cartesia.WebSocketTtsRequest>;
@@ -12,13 +13,14 @@ export declare namespace WebSocketTtsRequest {
     interface Raw {
         model_id: string;
         output_format?: OutputFormat.Raw | null;
+        generation_config?: GenerationConfig.Raw | null;
         transcript?: string | null;
         voice: TtsRequestVoiceSpecifier.Raw;
         duration?: number | null;
         language?: string | null;
         add_timestamps?: boolean | null;
         add_phoneme_timestamps?: boolean | null;
-        use_original_timestamps?: boolean | null;
+        use_normalized_timestamps?: boolean | null;
         continue?: boolean | null;
         context_id?: string | null;
         max_buffer_delay_ms?: number | null;

package/dist/serialization/resources/tts/types/WebSocketTtsRequest.js

@@ -39,18 +39,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebSocketTtsRequest = void 0;
 const core = __importStar(require("../../../../core"));
 const OutputFormat_1 = require("./OutputFormat");
+const GenerationConfig_1 = require("./GenerationConfig");
 const TtsRequestVoiceSpecifier_1 = require("./TtsRequestVoiceSpecifier");
 const ModelSpeed_1 = require("./ModelSpeed");
 exports.WebSocketTtsRequest = core.serialization.object({
     modelId: core.serialization.property("model_id", core.serialization.string()),
     outputFormat: core.serialization.property("output_format", OutputFormat_1.OutputFormat.optional()),
+    generationConfig: core.serialization.property("generation_config", GenerationConfig_1.GenerationConfig.optional()),
     transcript: core.serialization.string().optional(),
     voice: TtsRequestVoiceSpecifier_1.TtsRequestVoiceSpecifier,
     duration: core.serialization.number().optional(),
     language: core.serialization.string().optional(),
     addTimestamps: core.serialization.property("add_timestamps", core.serialization.boolean().optional()),
     addPhonemeTimestamps: core.serialization.property("add_phoneme_timestamps", core.serialization.boolean().optional()),
-    useOriginalTimestamps: core.serialization.property("use_original_timestamps", core.serialization.boolean().optional()),
+    useNormalizedTimestamps: core.serialization.property("use_normalized_timestamps", core.serialization.boolean().optional()),
     continue: core.serialization.boolean().optional(),
     contextId: core.serialization.property("context_id", core.serialization.string().optional()),
     maxBufferDelayMs: core.serialization.property("max_buffer_delay_ms", core.serialization.number().optional()),

package/dist/serialization/resources/tts/types/index.d.ts

@@ -19,9 +19,13 @@ export * from "./WebSocketRawOutputFormat";
 export * from "./WebSocketRequest";
 export * from "./WebSocketTtsRequest";
 export * from "./TtsRequest";
+export * from "./TtssseRequest";
 export * from "./SupportedLanguage";
+export * from "./GenerationConfig";
+export * from "./Emotion";
 export * from "./OutputFormat";
 export * from "./RawOutputFormat";
+export * from "./SseOutputFormat";
 export * from "./RawEncoding";
 export * from "./WavOutputFormat";
 export * from "./Mp3OutputFormat";
@@ -32,4 +36,4 @@ export * from "./Controls";
 export * from "./Speed";
 export * from "./NumericalSpecifier";
 export * from "./NaturalSpecifier";
-export * from "./Emotion";
+export * from "./EmotionDeprecated";

package/dist/serialization/resources/tts/types/index.js

@@ -35,9 +35,13 @@ __exportStar(require("./WebSocketRawOutputFormat"), exports);
 __exportStar(require("./WebSocketRequest"), exports);
 __exportStar(require("./WebSocketTtsRequest"), exports);
 __exportStar(require("./TtsRequest"), exports);
+__exportStar(require("./TtssseRequest"), exports);
 __exportStar(require("./SupportedLanguage"), exports);
+__exportStar(require("./GenerationConfig"), exports);
+__exportStar(require("./Emotion"), exports);
 __exportStar(require("./OutputFormat"), exports);
 __exportStar(require("./RawOutputFormat"), exports);
+__exportStar(require("./SseOutputFormat"), exports);
 __exportStar(require("./RawEncoding"), exports);
 __exportStar(require("./WavOutputFormat"), exports);
 __exportStar(require("./Mp3OutputFormat"), exports);
@@ -48,4 +52,4 @@ __exportStar(require("./Controls"), exports);
 __exportStar(require("./Speed"), exports);
 __exportStar(require("./NumericalSpecifier"), exports);
 __exportStar(require("./NaturalSpecifier"), exports);
-__exportStar(require("./Emotion"), exports);
+__exportStar(require("./EmotionDeprecated"), exports);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.2.4";
+export declare const SDK_VERSION = "2.2.7";

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "2.2.4";
+exports.SDK_VERSION = "2.2.7";

package/dist/wrapper/StreamingSTTClient.d.ts

@@ -1,6 +1,26 @@
 import { Stt } from "../api/resources/stt/client/Client";
-import SttWebsocket, { SttWebSocketOptions } from "./SttWebsocket";
+import SttWebsocket, { SttWebSocketOptions, TranscriptionResult } from "./SttWebsocket";
 export declare class StreamingSTTClient extends Stt {
     constructor(options?: Stt.Options);
-    websocket(options?: SttWebSocketOptions): SttWebsocket;
+    /**
+     * Create a WebSocket connection for real-time speech transcription.
+     *
+     * @param options - Configuration options for the STT WebSocket
+     * @param options.model - ID of the model to use for transcription (required)
+     * @param options.language - The language of the input audio in ISO-639-1 format (defaults to "en")
+     * @param options.encoding - The encoding format of the audio data (required). Must be one of: "pcm_s16le", "pcm_s32le", "pcm_f16le", "pcm_f32le", "pcm_mulaw", "pcm_alaw"
+     * @param options.sampleRate - The sample rate of the audio in Hz (required)
+     * @param options.minVolume - Volume threshold for voice activity detection (0.0-1.0)
+     * @param options.maxSilenceDurationSecs - Maximum duration of silence before endpointing
+     * @returns SttWebsocket instance for STT operations
+     */
+    websocket(options: SttWebSocketOptions): SttWebsocket;
+    /**
+     * Transcribe audio chunks using WebSocket with automatic connection management.
+     *
+     * @param audioChunks - Iterator of audio chunks as ArrayBuffer
+     * @param options - Configuration options for the STT WebSocket
+     * @returns AsyncGenerator yielding transcription results
+     */
+    transcribeChunks(audioChunks: AsyncIterable<ArrayBuffer>, options: SttWebSocketOptions): AsyncGenerator<TranscriptionResult, void, unknown>;
 }

package/dist/wrapper/StreamingSTTClient.js

@@ -1,4 +1,33 @@
 "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 __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -10,8 +39,102 @@ class StreamingSTTClient extends Client_1.Stt {
     constructor(options = {}) {
         super(options);
     }
-    websocket(options = {}) {
+    /**
+     * Create a WebSocket connection for real-time speech transcription.
+     *
+     * @param options - Configuration options for the STT WebSocket
+     * @param options.model - ID of the model to use for transcription (required)
+     * @param options.language - The language of the input audio in ISO-639-1 format (defaults to "en")
+     * @param options.encoding - The encoding format of the audio data (required). Must be one of: "pcm_s16le", "pcm_s32le", "pcm_f16le", "pcm_f32le", "pcm_mulaw", "pcm_alaw"
+     * @param options.sampleRate - The sample rate of the audio in Hz (required)
+     * @param options.minVolume - Volume threshold for voice activity detection (0.0-1.0)
+     * @param options.maxSilenceDurationSecs - Maximum duration of silence before endpointing
+     * @returns SttWebsocket instance for STT operations
+     */
+    websocket(options) {
         return new SttWebsocket_1.default(options, Object.assign({ cartesiaVersion: "2024-06-10" }, this._options));
     }
+    /**
+     * Transcribe audio chunks using WebSocket with automatic connection management.
+     *
+     * @param audioChunks - Iterator of audio chunks as ArrayBuffer
+     * @param options - Configuration options for the STT WebSocket
+     * @returns AsyncGenerator yielding transcription results
+     */
+    transcribeChunks(audioChunks, options) {
+        return __asyncGenerator(this, arguments, function* transcribeChunks_1() {
+            const ws = this.websocket(options);
+            try {
+                // Set up message handling
+                const resultQueue = [];
+                let isComplete = false;
+                let error = null;
+                yield __await(ws.onMessage((result) => {
+                    if (result.type === "error") {
+                        error = new Error(result.message || "STT error occurred");
+                    }
+                    else if (result.type === "done") {
+                        isComplete = true;
+                    }
+                    resultQueue.push(result);
+                }));
+                // Send audio chunks
+                const sendAudio = () => __awaiter(this, void 0, void 0, function* () {
+                    var _a, e_1, _b, _c;
+                    try {
+                        try {
+                            for (var _d = true, audioChunks_1 = __asyncValues(audioChunks), audioChunks_1_1; audioChunks_1_1 = yield audioChunks_1.next(), _a = audioChunks_1_1.done, !_a; _d = true) {
+                                _c = audioChunks_1_1.value;
+                                _d = false;
+                                const chunk = _c;
+                                yield ws.send(chunk);
+                            }
+                        }
+                        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                        finally {
+                            try {
+                                if (!_d && !_a && (_b = audioChunks_1.return)) yield _b.call(audioChunks_1);
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                        }
+                        // Finalize and close session
+                        yield ws.finalize();
+                        yield ws.done();
+                    }
+                    catch (e) {
+                        error = e instanceof Error ? e : new Error(String(e));
+                    }
+                });
+                // Start sending audio in background
+                const sendPromise = sendAudio();
+                // Yield results as they come in
+                while (!isComplete && !error) {
+                    if (resultQueue.length > 0) {
+                        const result = resultQueue.shift();
+                        yield yield __await(result);
+                        if (result.type === "done") {
+                            break;
+                        }
+                    }
+                    else {
+                        // Small delay to avoid busy waiting
+                        yield __await(new Promise(resolve => setTimeout(resolve, 10)));
+                    }
+                }
+                // Wait for sending to complete and handle any errors
+                yield __await(sendPromise);
+                if (error) {
+                    throw error;
+                }
+                // Yield any remaining results
+                while (resultQueue.length > 0) {
+                    yield yield __await(resultQueue.shift());
+                }
+            }
+            finally {
+                ws.disconnect();
+            }
+        });
+    }
 }
 exports.StreamingSTTClient = StreamingSTTClient;

package/dist/wrapper/SttWebsocket.d.ts

@@ -1,10 +1,14 @@
 import { ReconnectingWebSocket, Options } from "../core/websocket";
 import { Stt } from "../api/resources/stt/client/Client";
+import * as Cartesia from "../api/index";
+import { SttEncoding } from "../api/resources/stt/types/SttEncoding";
 export interface SttWebSocketOptions {
     model?: string;
     language?: string;
-    encoding?: string;
-    sampleRate?: number;
+    encoding: SttEncoding;
+    sampleRate: number;
+    minVolume?: number;
+    maxSilenceDurationSecs?: number;
 }
 export interface TranscriptionResult {
     type: "transcript" | "flush_done" | "done" | "error";
@@ -13,13 +17,14 @@ export interface TranscriptionResult {
     isFinal?: boolean;
     duration?: number;
     language?: string;
+    words?: Cartesia.TranscriptionWord[];
     message?: string;
 }
 export default class SttWebsocket {
     #private;
     private readonly options;
     socket?: ReconnectingWebSocket;
-    constructor({ model, language, encoding, sampleRate, }: SttWebSocketOptions, options: Stt.Options);
+    constructor({ model, language, encoding, sampleRate, minVolume, maxSilenceDurationSecs, }: SttWebSocketOptions, options: Stt.Options);
     send(audioData: ArrayBuffer): Promise<void>;
     finalize(): Promise<void>;
     done(): Promise<void>;

package/dist/wrapper/SttWebsocket.js

@@ -52,13 +52,13 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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_connectionPromise, _SttWebsocket_ensureConnected;
+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 = "pcm_s16le", sampleRate = 16000, }, options) {
+    constructor({ model = "ink-whisper", language = "en", encoding, sampleRate, minVolume, maxSilenceDurationSecs, }, options) {
         _SttWebsocket_instances.add(this);
         this.options = options;
         _SttWebsocket_isConnected.set(this, false);
@@ -66,11 +66,24 @@ class SttWebsocket {
         _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* () {
@@ -112,6 +125,10 @@ class SttWebsocket {
                         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
@@ -152,6 +169,10 @@ class SttWebsocket {
                 };
                 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;
@@ -185,7 +206,7 @@ class SttWebsocket {
         __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_connectionPromise = new WeakMap(), _SttWebsocket_instances = new WeakSet(), _SttWebsocket_ensureConnected = function _SttWebsocket_ensureConnected() {
+_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;

package/dist/wrapper/Websocket.js

@@ -180,7 +180,7 @@ class Websocket {
                 var _a;
                 const baseUrl = ((_a = (yield core.Supplier.get(this.options.environment))) !== null && _a !== void 0 ? _a : environments.CartesiaEnvironment.Production).replace(/^https?:\/\//, "");
                 const params = {
-                    cartesia_version: this.options.cartesiaVersion || "2024-06-10",
+                    cartesia_version: this.options.cartesiaVersion || "2025-04-16",
                 };
                 const apiKey = yield core.Supplier.get(this.options.apiKey);
                 if (apiKey) {

package/index.d.ts

@@ -1,5 +1,7 @@
 export * as Cartesia from "./api";
 export { CartesiaClient } from "./wrapper/Client";
 export { WebPlayer } from "./wrapper/WebPlayer";
+export { default as SttWebsocket } from "./wrapper/SttWebsocket";
+export { StreamingSTTClient } from "./wrapper/StreamingSTTClient";
 export { CartesiaEnvironment } from "./environments";
 export { CartesiaError, CartesiaTimeoutError } from "./errors";

package/index.js

@@ -32,13 +32,20 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CartesiaTimeoutError = exports.CartesiaError = exports.CartesiaEnvironment = exports.WebPlayer = exports.CartesiaClient = exports.Cartesia = void 0;
+exports.CartesiaTimeoutError = exports.CartesiaError = exports.CartesiaEnvironment = exports.StreamingSTTClient = exports.SttWebsocket = exports.WebPlayer = exports.CartesiaClient = exports.Cartesia = void 0;
 exports.Cartesia = __importStar(require("./api"));
 var Client_1 = require("./wrapper/Client");
 Object.defineProperty(exports, "CartesiaClient", { enumerable: true, get: function () { return Client_1.CartesiaClient; } });
 var WebPlayer_1 = require("./wrapper/WebPlayer");
 Object.defineProperty(exports, "WebPlayer", { enumerable: true, get: function () { return WebPlayer_1.WebPlayer; } });
+var SttWebsocket_1 = require("./wrapper/SttWebsocket");
+Object.defineProperty(exports, "SttWebsocket", { enumerable: true, get: function () { return __importDefault(SttWebsocket_1).default; } });
+var StreamingSTTClient_1 = require("./wrapper/StreamingSTTClient");
+Object.defineProperty(exports, "StreamingSTTClient", { enumerable: true, get: function () { return StreamingSTTClient_1.StreamingSTTClient; } });
 var environments_1 = require("./environments");
 Object.defineProperty(exports, "CartesiaEnvironment", { enumerable: true, get: function () { return environments_1.CartesiaEnvironment; } });
 var errors_1 = require("./errors");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cartesia/cartesia-js",
-    "version": "2.2.4",
+    "version": "2.2.7",
     "private": false,
     "repository": "https://github.com/cartesia-ai/cartesia-js",
     "main": "./index.js",