@cartesia/cartesia-js 2.2.5 → 2.2.8

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.5";
+export declare const SDK_VERSION = "2.2.8";

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.5";
+exports.SDK_VERSION = "2.2.8";

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.5",
+    "version": "2.2.8",
     "private": false,
     "repository": "https://github.com/cartesia-ai/cartesia-js",
     "main": "./index.js",

package/reference.md

@@ -75,6 +75,7 @@ Generates a new Access Token for the client. These tokens are short-lived and sh
 await client.auth.accessToken({
     grants: {
         tts: true,
+        stt: true,
     },
     expiresIn: 60,
 });
@@ -217,6 +218,93 @@ await client.infill.bytes(fs.createReadStream("/path/to/your/file"), fs.createRe
 </dl>
 </details>
 
+## Stt
+
+<details><summary><code>client.stt.<a href="/src/api/resources/stt/client/Client.ts">transcribe</a>(file, { ...params }) -> Cartesia.TranscriptionResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Transcribes audio files into text using Cartesia's Speech-to-Text API.
+
+Upload an audio file and receive a complete transcription response. Supports arbitrarily long audio files with automatic intelligent chunking for longer audio.
+
+**Supported audio formats:** flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, wav, webm
+
+**Response format:** Returns JSON with transcribed text, duration, and language. Include `timestamp_granularities: ["word"]` to get word-level timestamps.
+
+**Pricing:** Batch transcription is priced at **1 credit per 2 seconds** of audio processed.
+
+<Note>
+For migrating from the OpenAI SDK, see our [OpenAI Whisper to Cartesia Ink Migration Guide](/api-reference/stt/migrate-from-open-ai).
+</Note>
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.stt.transcribe(fs.createReadStream("/path/to/your/file"), {
+    model: "ink-whisper",
+    language: "en",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**file:** `File | fs.ReadStream | Blob`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Cartesia.TranscriptionRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Stt.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Tts
 
 <details><summary><code>client.tts.<a href="/src/api/resources/tts/client/Client.ts">bytes</a>({ ...params }) -> stream.Readable</code></summary>
@@ -325,7 +413,7 @@ for await (const item of response) {
 <dl>
 <dd>
 
-**request:** `Cartesia.TtsRequest`
+**request:** `Cartesia.TtssseRequest`
 
 </dd>
 </dl>

package/serialization/resources/auth/types/TokenGrant.d.ts

@@ -7,6 +7,7 @@ import * as core from "../../../../core";
 export declare const TokenGrant: core.serialization.ObjectSchema<serializers.TokenGrant.Raw, Cartesia.TokenGrant>;
 export declare namespace TokenGrant {
     interface Raw {
-        tts: boolean;
+        tts?: boolean | null;
+        stt?: boolean | null;
     }
 }

package/serialization/resources/auth/types/TokenGrant.js

@@ -39,5 +39,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenGrant = void 0;
 const core = __importStar(require("../../../../core"));
 exports.TokenGrant = core.serialization.object({
-    tts: core.serialization.boolean(),
+    tts: core.serialization.boolean().optional(),
+    stt: core.serialization.boolean().optional(),
 });

package/serialization/resources/auth/types/TokenRequest.d.ts

@@ -8,7 +8,7 @@ import { TokenGrant } from "./TokenGrant";
 export declare const TokenRequest: core.serialization.ObjectSchema<serializers.TokenRequest.Raw, Cartesia.TokenRequest>;
 export declare namespace TokenRequest {
     interface Raw {
-        grants: TokenGrant.Raw;
+        grants?: TokenGrant.Raw | null;
         expires_in?: number | null;
     }
 }

package/serialization/resources/auth/types/TokenRequest.js

@@ -40,6 +40,6 @@ exports.TokenRequest = void 0;
 const core = __importStar(require("../../../../core"));
 const TokenGrant_1 = require("./TokenGrant");
 exports.TokenRequest = core.serialization.object({
-    grants: TokenGrant_1.TokenGrant,
+    grants: TokenGrant_1.TokenGrant.optional(),
     expiresIn: core.serialization.property("expires_in", core.serialization.number().optional()),
 });

package/serialization/resources/stt/types/TimestampGranularity.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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";
+export declare const TimestampGranularity: core.serialization.Schema<serializers.TimestampGranularity.Raw, Cartesia.TimestampGranularity>;
+export declare namespace TimestampGranularity {
+    type Raw = "word";
+}

package/serialization/resources/stt/types/TimestampGranularity.js

@@ -0,0 +1,41 @@
+"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.TimestampGranularity = void 0;
+const core = __importStar(require("../../../../core"));
+exports.TimestampGranularity = core.serialization.enum_(["word"]);

package/serialization/resources/stt/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./TimestampGranularity";
 export * from "./TranscriptionWord";
 export * from "./TranscriptionResponse";
 export * from "./StreamingTranscriptionResponse";

package/serialization/resources/stt/types/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./TimestampGranularity"), exports);
 __exportStar(require("./TranscriptionWord"), exports);
 __exportStar(require("./TranscriptionResponse"), exports);
 __exportStar(require("./StreamingTranscriptionResponse"), exports);

package/serialization/resources/tts/types/Controls.d.ts

@@ -5,11 +5,11 @@ import * as serializers from "../../../index";
 import * as Cartesia from "../../../../api/index";
 import * as core from "../../../../core";
 import { Speed } from "./Speed";
-import { Emotion } from "./Emotion";
+import { EmotionDeprecated } from "./EmotionDeprecated";
 export declare const Controls: core.serialization.ObjectSchema<serializers.Controls.Raw, Cartesia.Controls>;
 export declare namespace Controls {
     interface Raw {
         speed: Speed.Raw;
-        emotion: Emotion.Raw[];
+        emotion: EmotionDeprecated.Raw[];
     }
 }

package/serialization/resources/tts/types/Controls.js

@@ -39,8 +39,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Controls = void 0;
 const core = __importStar(require("../../../../core"));
 const Speed_1 = require("./Speed");
-const Emotion_1 = require("./Emotion");
+const EmotionDeprecated_1 = require("./EmotionDeprecated");
 exports.Controls = core.serialization.object({
     speed: Speed_1.Speed,
-    emotion: core.serialization.list(Emotion_1.Emotion),
+    emotion: core.serialization.list(EmotionDeprecated_1.EmotionDeprecated),
 });

package/serialization/resources/tts/types/Emotion.d.ts

@@ -6,5 +6,5 @@ import * as Cartesia from "../../../../api/index";
 import * as core from "../../../../core";
 export declare const Emotion: core.serialization.Schema<serializers.Emotion.Raw, Cartesia.Emotion>;
 export declare namespace Emotion {
-    type Raw = "anger:lowest" | "anger:low" | "anger" | "anger:high" | "anger:highest" | "positivity:lowest" | "positivity:low" | "positivity" | "positivity:high" | "positivity:highest" | "surprise:lowest" | "surprise:low" | "surprise" | "surprise:high" | "surprise:highest" | "sadness:lowest" | "sadness:low" | "sadness" | "sadness:high" | "sadness:highest" | "curiosity:lowest" | "curiosity:low" | "curiosity" | "curiosity:high" | "curiosity:highest";
+    type Raw = string;
 }