@cartesia/cartesia-js 3.0.0-b4 → 3.0.0-b5

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.0.0-b5 (2026-01-07)
+
+Full Changelog: [v3.0.0-b4...v3.0.0-b5](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b4...v3.0.0-b5)
+
+### Features
+
+* **api:** fix readme ([91bd83c](https://github.com/cartesia-ai/cartesia-js-internal/commit/91bd83cb75d8b92778928cf7aebab908f7723b79))
+
 ## 3.0.0-b4 (2026-01-07)
 
 Full Changelog: [v3.0.0-b3...v3.0.0-b4](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b3...v3.0.0-b4)

package/README.md

@@ -23,12 +23,13 @@ The full API of this library can be found in [api.md](api.md).
 import Cartesia from '@cartesia/cartesia-js';
 
 const client = new Cartesia({
-  token: 'My Token',
+  apiKey: 'My API Key',
 });
 
-const response = await client.getStatus();
+const page = await client.voices.list();
+const voice = page.data[0];
 
-console.log(response.ok);
+console.log(voice.id);
 ```
 
 ### Request & Response types
@@ -40,10 +41,10 @@ This library includes TypeScript definitions for all request params and response
 import Cartesia from '@cartesia/cartesia-js';
 
 const client = new Cartesia({
-  token: 'My Token',
+  apiKey: 'My API Key',
 });
 
-const response: Cartesia.GetStatusResponse = await client.getStatus();
+const [voice]: [Cartesia.Voice] = await client.voices.list();
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -85,7 +86,7 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const response = await client.getStatus().catch(async (err) => {
+const page = await client.voices.list().catch(async (err) => {
   if (err instanceof Cartesia.APIError) {
     console.log(err.status); // 400
     console.log(err.name); // BadRequestError
@@ -125,7 +126,7 @@ const client = new Cartesia({
 });
 
 // Or, configure per-request:
-await client.getStatus({
+await client.voices.list({
   maxRetries: 5,
 });
 ```
@@ -142,7 +143,7 @@ const client = new Cartesia({
 });
 
 // Override per-request:
-await client.getStatus({
+await client.voices.list({
   timeout: 5 * 1000,
 });
 ```
@@ -157,22 +158,22 @@ List methods in the Cartesia API are paginated.
 You can use the `for await … of` syntax to iterate through items across all pages:
 
 ```ts
-async function fetchAllAgentCalls(params) {
-  const allAgentCalls = [];
+async function fetchAllVoices(params) {
+  const allVoices = [];
   // Automatically fetches more pages as needed.
-  for await (const agentCall of client.agents.calls.list({ agent_id: 'agent_id' })) {
-    allAgentCalls.push(agentCall);
+  for await (const voice of client.voices.list()) {
+    allVoices.push(voice);
   }
-  return allAgentCalls;
+  return allVoices;
 }
 ```
 
 Alternatively, you can request a single page at a time:
 
 ```ts
-let page = await client.agents.calls.list({ agent_id: 'agent_id' });
-for (const agentCall of page.data) {
-  console.log(agentCall);
+let page = await client.voices.list();
+for (const voice of page.data) {
+  console.log(voice);
 }
 
 // Convenience methods are provided for manually paginating:
@@ -193,7 +194,8 @@ import Cartesia from '@cartesia/cartesia-js';
 
 const client = new Cartesia();
 
-const response = await client.getStatus({ headers: { 'cartesia-version': 'My-Custom-Value' } });
+const page = await client.voices.list({ headers: { 'cartesia-version': 'My-Custom-Value' } });
+const voice = page.data[0];
 ```
 
 ## Advanced Usage
@@ -210,13 +212,15 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Cartesia();
 
-const response = await client.getStatus().asResponse();
+const response = await client.voices.list().asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: response, response: raw } = await client.getStatus().withResponse();
+const { data: page, response: raw } = await client.voices.list().withResponse();
 console.log(raw.headers.get('X-My-Header'));
-console.log(response.ok);
+for await (const voice of page) {
+  console.log(voice.id);
+}
 ```
 
 ### Logging
@@ -296,7 +300,7 @@ parameter. This library doesn't validate at runtime that the request matches the
 send will be sent as-is.
 
 ```ts
-client.getStatus({
+client.voices.list({
   // ...
   // @ts-expect-error baz is not yet public
   baz: 'undocumented option',

package/backcompat/index.d.mts

@@ -0,0 +1,36 @@
+import { Cartesia } from "../client.mjs";
+declare class AudioSource {
+    private buffers;
+    private waiter;
+    isDone: boolean;
+    push(data: Buffer): void;
+    markDone(): void;
+    read(outBuffer: Float32Array): Promise<number>;
+}
+declare class WebSocketWrapper {
+    private client;
+    private config;
+    private socket;
+    private sources;
+    private defaultSource;
+    constructor(client: Cartesia, config: any);
+    connect(): Promise<void>;
+    private handleMessage;
+    send(request: any): Promise<{
+        source: AudioSource;
+    }>;
+    disconnect(): void;
+}
+declare class TTSWrapper {
+    private client;
+    constructor(client: Cartesia);
+    websocket(config: any): WebSocketWrapper;
+    bytes(request: any, requestOptions?: any): Promise<any>;
+}
+export declare class CartesiaClient {
+    private client;
+    tts: TTSWrapper;
+    constructor(options: any);
+}
+export {};
+//# sourceMappingURL=index.d.mts.map

package/backcompat/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/backcompat/index.ts"],"names":[],"mappings":"OACO,EAAE,QAAQ,EAAE;AAEnB,cAAM,WAAW;IAChB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAsC;IAC7C,MAAM,UAAS;IAEtB,IAAI,CAAC,IAAI,EAAE,MAAM;IAQjB,QAAQ;IAQF,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAkDpD;AAED,cAAM,gBAAgB;IACrB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAuC;IAItD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAKnC,OAAO;IAiDb,OAAO,CAAC,aAAa;IA2Bf,IAAI,CAAC,OAAO,EAAE,GAAG;;;IA4DvB,UAAU;CAKV;AAED,cAAM,UAAU;IACf,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAI5B,SAAS,CAAC,MAAM,EAAE,GAAG;IAIf,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,GAAG;CAiC9C;AAMD,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAAW;IAClB,GAAG,EAAE,UAAU,CAAC;gBAEX,OAAO,EAAE,GAAG;CAIxB"}

package/backcompat/index.d.ts

@@ -0,0 +1,36 @@
+import { Cartesia } from "../client.js";
+declare class AudioSource {
+    private buffers;
+    private waiter;
+    isDone: boolean;
+    push(data: Buffer): void;
+    markDone(): void;
+    read(outBuffer: Float32Array): Promise<number>;
+}
+declare class WebSocketWrapper {
+    private client;
+    private config;
+    private socket;
+    private sources;
+    private defaultSource;
+    constructor(client: Cartesia, config: any);
+    connect(): Promise<void>;
+    private handleMessage;
+    send(request: any): Promise<{
+        source: AudioSource;
+    }>;
+    disconnect(): void;
+}
+declare class TTSWrapper {
+    private client;
+    constructor(client: Cartesia);
+    websocket(config: any): WebSocketWrapper;
+    bytes(request: any, requestOptions?: any): Promise<any>;
+}
+export declare class CartesiaClient {
+    private client;
+    tts: TTSWrapper;
+    constructor(options: any);
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/backcompat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/backcompat/index.ts"],"names":[],"mappings":"OACO,EAAE,QAAQ,EAAE;AAEnB,cAAM,WAAW;IAChB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAsC;IAC7C,MAAM,UAAS;IAEtB,IAAI,CAAC,IAAI,EAAE,MAAM;IAQjB,QAAQ;IAQF,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAkDpD;AAED,cAAM,gBAAgB;IACrB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAuC;IAItD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAKnC,OAAO;IAiDb,OAAO,CAAC,aAAa;IA2Bf,IAAI,CAAC,OAAO,EAAE,GAAG;;;IA4DvB,UAAU;CAKV;AAED,cAAM,UAAU;IACf,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAI5B,SAAS,CAAC,MAAM,EAAE,GAAG;IAIf,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,GAAG;CAiC9C;AAMD,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAAW;IAClB,GAAG,EAAE,UAAU,CAAC;gBAEX,OAAO,EAAE,GAAG;CAIxB"}

package/backcompat/index.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CartesiaClient = void 0;
+const tslib_1 = require("../internal/tslib.js");
+const ws_1 = tslib_1.__importDefault(require("ws"));
+const client_1 = require("../client.js");
+class AudioSource {
+    constructor() {
+        this.buffers = [];
+        this.waiter = null;
+        this.isDone = false;
+    }
+    push(data) {
+        this.buffers.push(data);
+        if (this.waiter) {
+            this.waiter();
+            this.waiter = null;
+        }
+    }
+    markDone() {
+        this.isDone = true;
+        if (this.waiter) {
+            this.waiter();
+            this.waiter = null;
+        }
+    }
+    async read(outBuffer) {
+        if (this.buffers.length === 0 && !this.isDone) {
+            await new Promise((resolve) => { this.waiter = resolve; });
+        }
+        if (this.buffers.length === 0 && this.isDone) {
+            return 0;
+        }
+        let totalFloatsRead = 0;
+        let outOffset = 0;
+        const maxFloats = outBuffer.length;
+        while (this.buffers.length > 0 && totalFloatsRead < maxFloats) {
+            const buf = this.buffers[0]; // ts not smart enough to check loop condition
+            const floatsInBuf = buf.length / 4;
+            const floatsNeeded = maxFloats - totalFloatsRead;
+            const floatsToCopy = Math.min(floatsInBuf, floatsNeeded);
+            const bytesToCopy = floatsToCopy * 4;
+            // Copy to outBuffer.
+            // Create a view on the buffer to read floats.
+            // We need to ensure byteOffset is a multiple of 4.
+            // If not, we must copy the buffer to a new one.
+            let srcFloats;
+            if (buf.byteOffset % 4 === 0) {
+                srcFloats = new Float32Array(buf.buffer, buf.byteOffset, floatsInBuf);
+            }
+            else {
+                const alignedBuf = new Uint8Array(buf);
+                srcFloats = new Float32Array(alignedBuf.buffer, alignedBuf.byteOffset, floatsInBuf);
+            }
+            outBuffer.set(srcFloats.subarray(0, floatsToCopy), outOffset);
+            totalFloatsRead += floatsToCopy;
+            outOffset += floatsToCopy;
+            if (floatsToCopy < floatsInBuf) {
+                // We didn't use the whole buffer. Update it.
+                this.buffers[0] = buf.subarray(bytesToCopy);
+            }
+            else {
+                // We used the whole buffer. Remove it.
+                this.buffers.shift();
+            }
+        }
+        return totalFloatsRead;
+    }
+}
+class WebSocketWrapper {
+    constructor(client, config) {
+        this.socket = null;
+        this.sources = new Map();
+        // Fallback source for messages without context_id or if we just want to capture everything (legacy behavior?)
+        // The original test didn't use context_id explicitly in send() but expected a response source.
+        // We'll map context_id to source.
+        this.defaultSource = null;
+        this.client = client;
+        this.config = config;
+    }
+    async connect() {
+        const baseURL = this.client.baseURL;
+        // Construct WebSocket URL
+        // baseURL is like https://api.cartesia.ai
+        let urlStr = baseURL.replace(/^http/, "ws");
+        if (!urlStr.includes("/tts/websocket")) {
+            if (urlStr.endsWith("/")) {
+                urlStr += "tts/websocket";
+            }
+            else {
+                urlStr += "/tts/websocket";
+            }
+        }
+        const url = new URL(urlStr);
+        const headers = {
+            "cartesia-version": "2025-04-16",
+        };
+        if (this.client.apiKey) {
+            headers["Authorization"] = `Bearer ${this.client.apiKey}`;
+        }
+        this.socket = new ws_1.default(url.toString(), {
+            headers: headers,
+        });
+        return new Promise((resolve, reject) => {
+            this.socket.on("open", () => {
+                console.log("WebSocket connected.");
+                resolve();
+            });
+            this.socket.on("error", (err) => {
+                console.error("WebSocket error:", err);
+                reject(err);
+            });
+            this.socket.on("message", (data) => {
+                this.handleMessage(data);
+            });
+            this.socket.on("close", () => {
+                console.log("WebSocket closed.");
+                this.sources.forEach((s) => { s.markDone(); });
+                if (this.defaultSource)
+                    this.defaultSource.markDone();
+            });
+        });
+    }
+    handleMessage(data) {
+        try {
+            const str = data.toString();
+            const msg = JSON.parse(str);
+            const contextId = msg.context_id;
+            let source = contextId ? this.sources.get(contextId) : this.defaultSource;
+            // If we received a message for a context we don't know about, and we have a default source, use it
+            if (!source && this.defaultSource) {
+                source = this.defaultSource;
+            }
+            if (msg.type === "chunk" && msg.data) {
+                const audioData = Buffer.from(msg.data, "base64");
+                if (source)
+                    source.push(audioData);
+            }
+            else if (msg.type === "done") {
+                if (source)
+                    source.markDone();
+            }
+            else if (msg.type === "error") {
+                console.error("Server error:", msg);
+                if (source)
+                    source.markDone(); // Fail the stream?
+            }
+        }
+        catch (e) {
+            console.error("Error parsing message:", e);
+        }
+    }
+    async send(request) {
+        if (!this.socket) {
+            throw new Error("WebSocket not connected");
+        }
+        // Ensure request has a context_id so we can route the response
+        if (!request.context_id) {
+            request.context_id = uuidv4();
+        }
+        const source = new AudioSource();
+        this.sources.set(request.context_id, source);
+        // Also set as default source if none exists, for compatibility with simple tests
+        if (!this.defaultSource) {
+            this.defaultSource = source;
+        }
+        // Add output format from config if not present
+        if (!request.output_format && this.config) {
+            request.output_format = {
+                container: this.config.container,
+                encoding: this.config.encoding,
+                sample_rate: this.config.sampleRate,
+            };
+        }
+        // Fix camelCase to snake_case for output_format if needed
+        // The new API expects snake_case keys in JSON usually, but let's check.
+        // The GenerationRequest interface has `output_format`.
+        // The config passed to .websocket() uses `sampleRate`.
+        // We might need to map it.
+        if (request.output_format) {
+            // Ensure sample_rate is set (mapping from sampleRate)
+            if (request.output_format.sampleRate && !request.output_format.sample_rate) {
+                request.output_format.sample_rate = request.output_format.sampleRate;
+                delete request.output_format.sampleRate;
+            }
+        }
+        // Map camelCase request fields to snake_case if necessary?
+        // The old test uses `modelId`, `generationConfig`.
+        // The new API expects `model_id`, `generation_config`.
+        const payload = {
+            ...request,
+            model_id: request.modelId || request.model_id,
+            generation_config: request.generationConfig || request.generation_config,
+            context_id: request.context_id,
+        };
+        // Remove camelCase keys if they persist?
+        // JSON.stringify handles it, but we should clean up if we want to be strict.
+        // Also `voice` object. Old test: `voice: { mode: 'id', id: ... }`. New API: same.
+        this.socket.send(JSON.stringify(payload));
+        return {
+            source: source
+        };
+    }
+    disconnect() {
+        if (this.socket) {
+            this.socket.close();
+        }
+    }
+}
+class TTSWrapper {
+    constructor(client) {
+        this.client = client;
+    }
+    websocket(config) {
+        return new WebSocketWrapper(this.client, config);
+    }
+    async bytes(request, requestOptions) {
+        const params = {
+            model_id: request.modelId,
+            transcript: request.transcript,
+            voice: request.voice,
+            generation_config: request.generationConfig,
+            context_id: request.contextId,
+        };
+        if (request.outputFormat) {
+            params.output_format = {
+                ...request.outputFormat,
+                sample_rate: request.outputFormat.sampleRate,
+                bit_rate: request.outputFormat.bitRate,
+            };
+            // Remove camelCase keys
+            delete params.output_format.sampleRate;
+            delete params.output_format.bitRate;
+        }
+        const options = {};
+        if (requestOptions) {
+            if (requestOptions.timeoutInSeconds) {
+                options.timeout = requestOptions.timeoutInSeconds * 1000;
+            }
+            options.maxRetries = requestOptions.maxRetries;
+            options.headers = requestOptions.headers;
+            options.signal = requestOptions.abortSignal;
+        }
+        // @ts-ignore
+        return this.client.tts.synthesizeBytes(params, options);
+    }
+}
+/*
+ * CartesiaClient - deprecated backcompat class.
+ * New code should use Cartesia class directly instead.
+ */
+class CartesiaClient {
+    constructor(options) {
+        this.client = new client_1.Cartesia(options);
+        this.tts = new TTSWrapper(this.client);
+    }
+}
+exports.CartesiaClient = CartesiaClient;
+// Helper for generating UUIDs. Not cryptographically secure.
+function uuidv4() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=index.js.map

package/backcompat/index.js.map

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

package/backcompat/index.mjs

@@ -0,0 +1,261 @@
+import WebSocket from "ws";
+import { Cartesia } from "../client.mjs";
+class AudioSource {
+    constructor() {
+        this.buffers = [];
+        this.waiter = null;
+        this.isDone = false;
+    }
+    push(data) {
+        this.buffers.push(data);
+        if (this.waiter) {
+            this.waiter();
+            this.waiter = null;
+        }
+    }
+    markDone() {
+        this.isDone = true;
+        if (this.waiter) {
+            this.waiter();
+            this.waiter = null;
+        }
+    }
+    async read(outBuffer) {
+        if (this.buffers.length === 0 && !this.isDone) {
+            await new Promise((resolve) => { this.waiter = resolve; });
+        }
+        if (this.buffers.length === 0 && this.isDone) {
+            return 0;
+        }
+        let totalFloatsRead = 0;
+        let outOffset = 0;
+        const maxFloats = outBuffer.length;
+        while (this.buffers.length > 0 && totalFloatsRead < maxFloats) {
+            const buf = this.buffers[0]; // ts not smart enough to check loop condition
+            const floatsInBuf = buf.length / 4;
+            const floatsNeeded = maxFloats - totalFloatsRead;
+            const floatsToCopy = Math.min(floatsInBuf, floatsNeeded);
+            const bytesToCopy = floatsToCopy * 4;
+            // Copy to outBuffer.
+            // Create a view on the buffer to read floats.
+            // We need to ensure byteOffset is a multiple of 4.
+            // If not, we must copy the buffer to a new one.
+            let srcFloats;
+            if (buf.byteOffset % 4 === 0) {
+                srcFloats = new Float32Array(buf.buffer, buf.byteOffset, floatsInBuf);
+            }
+            else {
+                const alignedBuf = new Uint8Array(buf);
+                srcFloats = new Float32Array(alignedBuf.buffer, alignedBuf.byteOffset, floatsInBuf);
+            }
+            outBuffer.set(srcFloats.subarray(0, floatsToCopy), outOffset);
+            totalFloatsRead += floatsToCopy;
+            outOffset += floatsToCopy;
+            if (floatsToCopy < floatsInBuf) {
+                // We didn't use the whole buffer. Update it.
+                this.buffers[0] = buf.subarray(bytesToCopy);
+            }
+            else {
+                // We used the whole buffer. Remove it.
+                this.buffers.shift();
+            }
+        }
+        return totalFloatsRead;
+    }
+}
+class WebSocketWrapper {
+    constructor(client, config) {
+        this.socket = null;
+        this.sources = new Map();
+        // Fallback source for messages without context_id or if we just want to capture everything (legacy behavior?)
+        // The original test didn't use context_id explicitly in send() but expected a response source.
+        // We'll map context_id to source.
+        this.defaultSource = null;
+        this.client = client;
+        this.config = config;
+    }
+    async connect() {
+        const baseURL = this.client.baseURL;
+        // Construct WebSocket URL
+        // baseURL is like https://api.cartesia.ai
+        let urlStr = baseURL.replace(/^http/, "ws");
+        if (!urlStr.includes("/tts/websocket")) {
+            if (urlStr.endsWith("/")) {
+                urlStr += "tts/websocket";
+            }
+            else {
+                urlStr += "/tts/websocket";
+            }
+        }
+        const url = new URL(urlStr);
+        const headers = {
+            "cartesia-version": "2025-04-16",
+        };
+        if (this.client.apiKey) {
+            headers["Authorization"] = `Bearer ${this.client.apiKey}`;
+        }
+        this.socket = new WebSocket(url.toString(), {
+            headers: headers,
+        });
+        return new Promise((resolve, reject) => {
+            this.socket.on("open", () => {
+                console.log("WebSocket connected.");
+                resolve();
+            });
+            this.socket.on("error", (err) => {
+                console.error("WebSocket error:", err);
+                reject(err);
+            });
+            this.socket.on("message", (data) => {
+                this.handleMessage(data);
+            });
+            this.socket.on("close", () => {
+                console.log("WebSocket closed.");
+                this.sources.forEach((s) => { s.markDone(); });
+                if (this.defaultSource)
+                    this.defaultSource.markDone();
+            });
+        });
+    }
+    handleMessage(data) {
+        try {
+            const str = data.toString();
+            const msg = JSON.parse(str);
+            const contextId = msg.context_id;
+            let source = contextId ? this.sources.get(contextId) : this.defaultSource;
+            // If we received a message for a context we don't know about, and we have a default source, use it
+            if (!source && this.defaultSource) {
+                source = this.defaultSource;
+            }
+            if (msg.type === "chunk" && msg.data) {
+                const audioData = Buffer.from(msg.data, "base64");
+                if (source)
+                    source.push(audioData);
+            }
+            else if (msg.type === "done") {
+                if (source)
+                    source.markDone();
+            }
+            else if (msg.type === "error") {
+                console.error("Server error:", msg);
+                if (source)
+                    source.markDone(); // Fail the stream?
+            }
+        }
+        catch (e) {
+            console.error("Error parsing message:", e);
+        }
+    }
+    async send(request) {
+        if (!this.socket) {
+            throw new Error("WebSocket not connected");
+        }
+        // Ensure request has a context_id so we can route the response
+        if (!request.context_id) {
+            request.context_id = uuidv4();
+        }
+        const source = new AudioSource();
+        this.sources.set(request.context_id, source);
+        // Also set as default source if none exists, for compatibility with simple tests
+        if (!this.defaultSource) {
+            this.defaultSource = source;
+        }
+        // Add output format from config if not present
+        if (!request.output_format && this.config) {
+            request.output_format = {
+                container: this.config.container,
+                encoding: this.config.encoding,
+                sample_rate: this.config.sampleRate,
+            };
+        }
+        // Fix camelCase to snake_case for output_format if needed
+        // The new API expects snake_case keys in JSON usually, but let's check.
+        // The GenerationRequest interface has `output_format`.
+        // The config passed to .websocket() uses `sampleRate`.
+        // We might need to map it.
+        if (request.output_format) {
+            // Ensure sample_rate is set (mapping from sampleRate)
+            if (request.output_format.sampleRate && !request.output_format.sample_rate) {
+                request.output_format.sample_rate = request.output_format.sampleRate;
+                delete request.output_format.sampleRate;
+            }
+        }
+        // Map camelCase request fields to snake_case if necessary?
+        // The old test uses `modelId`, `generationConfig`.
+        // The new API expects `model_id`, `generation_config`.
+        const payload = {
+            ...request,
+            model_id: request.modelId || request.model_id,
+            generation_config: request.generationConfig || request.generation_config,
+            context_id: request.context_id,
+        };
+        // Remove camelCase keys if they persist?
+        // JSON.stringify handles it, but we should clean up if we want to be strict.
+        // Also `voice` object. Old test: `voice: { mode: 'id', id: ... }`. New API: same.
+        this.socket.send(JSON.stringify(payload));
+        return {
+            source: source
+        };
+    }
+    disconnect() {
+        if (this.socket) {
+            this.socket.close();
+        }
+    }
+}
+class TTSWrapper {
+    constructor(client) {
+        this.client = client;
+    }
+    websocket(config) {
+        return new WebSocketWrapper(this.client, config);
+    }
+    async bytes(request, requestOptions) {
+        const params = {
+            model_id: request.modelId,
+            transcript: request.transcript,
+            voice: request.voice,
+            generation_config: request.generationConfig,
+            context_id: request.contextId,
+        };
+        if (request.outputFormat) {
+            params.output_format = {
+                ...request.outputFormat,
+                sample_rate: request.outputFormat.sampleRate,
+                bit_rate: request.outputFormat.bitRate,
+            };
+            // Remove camelCase keys
+            delete params.output_format.sampleRate;
+            delete params.output_format.bitRate;
+        }
+        const options = {};
+        if (requestOptions) {
+            if (requestOptions.timeoutInSeconds) {
+                options.timeout = requestOptions.timeoutInSeconds * 1000;
+            }
+            options.maxRetries = requestOptions.maxRetries;
+            options.headers = requestOptions.headers;
+            options.signal = requestOptions.abortSignal;
+        }
+        // @ts-ignore
+        return this.client.tts.synthesizeBytes(params, options);
+    }
+}
+/*
+ * CartesiaClient - deprecated backcompat class.
+ * New code should use Cartesia class directly instead.
+ */
+export class CartesiaClient {
+    constructor(options) {
+        this.client = new Cartesia(options);
+        this.tts = new TTSWrapper(this.client);
+    }
+}
+// Helper for generating UUIDs. Not cryptographically secure.
+function uuidv4() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=index.mjs.map

package/backcompat/index.mjs.map

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

package/index.d.mts

@@ -2,6 +2,7 @@ export { Cartesia as default } from "./client.mjs";
 export { type Uploadable, toFile } from "./core/uploads.mjs";
 export { APIPromise } from "./core/api-promise.mjs";
 export { Cartesia, type ClientOptions } from "./client.mjs";
+export { CartesiaClient } from "./backcompat/index.mjs";
 export { PagePromise } from "./core/pagination.mjs";
 export { CartesiaError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, NotFoundError, ConflictError, RateLimitError, BadRequestError, AuthenticationError, InternalServerError, PermissionDeniedError, UnprocessableEntityError, } from "./core/error.mjs";
 //# sourceMappingURL=index.d.mts.map

package/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,IAAI,OAAO,EAAE;OAEvB,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE;OAChC,EAAE,WAAW,EAAE;OACf,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,IAAI,OAAO,EAAE;OAEvB,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE;OAChC,EAAE,cAAc,EAAE;OAClB,EAAE,WAAW,EAAE;OACf,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB"}

package/index.d.ts

@@ -2,6 +2,7 @@ export { Cartesia as default } from "./client.js";
 export { type Uploadable, toFile } from "./core/uploads.js";
 export { APIPromise } from "./core/api-promise.js";
 export { Cartesia, type ClientOptions } from "./client.js";
+export { CartesiaClient } from "./backcompat/index.js";
 export { PagePromise } from "./core/pagination.js";
 export { CartesiaError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, NotFoundError, ConflictError, RateLimitError, BadRequestError, AuthenticationError, InternalServerError, PermissionDeniedError, UnprocessableEntityError, } from "./core/error.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,IAAI,OAAO,EAAE;OAEvB,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE;OAChC,EAAE,WAAW,EAAE;OACf,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,IAAI,OAAO,EAAE;OAEvB,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE;OAChC,EAAE,cAAc,EAAE;OAClB,EAAE,WAAW,EAAE;OACf,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB"}

package/index.js

@@ -4,7 +4,7 @@ exports = module.exports = function (...args) {
   return new exports.default(...args)
 }
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnprocessableEntityError = exports.PermissionDeniedError = exports.InternalServerError = exports.AuthenticationError = exports.BadRequestError = exports.RateLimitError = exports.ConflictError = exports.NotFoundError = exports.APIUserAbortError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIError = exports.CartesiaError = exports.PagePromise = exports.Cartesia = exports.APIPromise = exports.toFile = exports.default = void 0;
+exports.UnprocessableEntityError = exports.PermissionDeniedError = exports.InternalServerError = exports.AuthenticationError = exports.BadRequestError = exports.RateLimitError = exports.ConflictError = exports.NotFoundError = exports.APIUserAbortError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIError = exports.CartesiaError = exports.PagePromise = exports.CartesiaClient = exports.Cartesia = exports.APIPromise = exports.toFile = exports.default = void 0;
 var client_1 = require("./client.js");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_1.Cartesia; } });
 var uploads_1 = require("./core/uploads.js");
@@ -13,6 +13,8 @@ var api_promise_1 = require("./core/api-promise.js");
 Object.defineProperty(exports, "APIPromise", { enumerable: true, get: function () { return api_promise_1.APIPromise; } });
 var client_2 = require("./client.js");
 Object.defineProperty(exports, "Cartesia", { enumerable: true, get: function () { return client_2.Cartesia; } });
+var backcompat_1 = require("./backcompat/index.js");
+Object.defineProperty(exports, "CartesiaClient", { enumerable: true, get: function () { return backcompat_1.CartesiaClient; } });
 var pagination_1 = require("./core/pagination.js");
 Object.defineProperty(exports, "PagePromise", { enumerable: true, get: function () { return pagination_1.PagePromise; } });
 var error_1 = require("./core/error.js");

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAA+C;AAAtC,iGAAA,QAAQ,OAAW;AAE5B,6CAAyD;AAA/B,iGAAA,MAAM,OAAA;AAChC,qDAAgD;AAAvC,yGAAA,UAAU,OAAA;AACnB,sCAAwD;AAA/C,kGAAA,QAAQ,OAAA;AACjB,mDAAgD;AAAvC,yGAAA,WAAW,OAAA;AACpB,yCAcsB;AAbpB,sGAAA,aAAa,OAAA;AACb,iGAAA,QAAQ,OAAA;AACR,2GAAA,kBAAkB,OAAA;AAClB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,iHAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAA+C;AAAtC,iGAAA,QAAQ,OAAW;AAE5B,6CAAyD;AAA/B,iGAAA,MAAM,OAAA;AAChC,qDAAgD;AAAvC,yGAAA,UAAU,OAAA;AACnB,sCAAwD;AAA/C,kGAAA,QAAQ,OAAA;AACjB,oDAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,mDAAgD;AAAvC,yGAAA,WAAW,OAAA;AACpB,yCAcsB;AAbpB,sGAAA,aAAa,OAAA;AACb,iGAAA,QAAQ,OAAA;AACR,2GAAA,kBAAkB,OAAA;AAClB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,iHAAA,wBAAwB,OAAA"}

package/index.mjs

@@ -3,6 +3,7 @@ export { Cartesia as default } from "./client.mjs";
 export { toFile } from "./core/uploads.mjs";
 export { APIPromise } from "./core/api-promise.mjs";
 export { Cartesia } from "./client.mjs";
+export { CartesiaClient } from "./backcompat/index.mjs";
 export { PagePromise } from "./core/pagination.mjs";
 export { CartesiaError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, NotFoundError, ConflictError, RateLimitError, BadRequestError, AuthenticationError, InternalServerError, PermissionDeniedError, UnprocessableEntityError, } from "./core/error.mjs";
 //# sourceMappingURL=index.mjs.map

package/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,QAAQ,IAAI,OAAO,EAAE;OAEvB,EAAmB,MAAM,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAsB;OAChC,EAAE,WAAW,EAAE;OACf,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,QAAQ,IAAI,OAAO,EAAE;OAEvB,EAAmB,MAAM,EAAE;OAC3B,EAAE,UAAU,EAAE;OACd,EAAE,QAAQ,EAAsB;OAChC,EAAE,cAAc,EAAE;OAClB,EAAE,WAAW,EAAE;OACf,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB"}

package/internal/tslib.js

@@ -5,6 +5,7 @@ exports.__classPrivateFieldSet = __classPrivateFieldSet;
 exports.__classPrivateFieldGet = __classPrivateFieldGet;
 exports.__importStar = __importStar;
 exports.__exportStar = __exportStar;
+exports.__importDefault = __importDefault;
 function __classPrivateFieldSet(receiver, state, value, kind, f) {
     if (kind === "m")
         throw new TypeError("Private method is not writable");
@@ -79,3 +80,6 @@ function __exportStar(m, o) {
         if (p !== "default" && !Object.prototype.hasOwnProperty.call(o, p))
             __createBinding(o, m, p);
 }
+function __importDefault(mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartesia/cartesia-js",
-  "version": "3.0.0-b4",
+  "version": "3.0.0-b5",
   "description": "The official TypeScript library for the Cartesia API",
   "author": "Cartesia <>",
   "types": "./index.d.ts",
@@ -52,6 +52,16 @@
     "./api-promise.mjs": {
       "default": "./api-promise.mjs"
     },
+    "./backcompat/*.mjs": {
+      "default": "./backcompat/*.mjs"
+    },
+    "./backcompat/*.js": {
+      "default": "./backcompat/*.js"
+    },
+    "./backcompat/*": {
+      "import": "./backcompat/*.mjs",
+      "require": "./backcompat/*.js"
+    },
     "./client": {
       "import": "./client.mjs",
       "require": "./client.js"

package/src/backcompat/index.ts

@@ -0,0 +1,302 @@
+import WebSocket from "ws";
+import { Cartesia } from "../client";
+
+class AudioSource {
+	private buffers: Buffer[] = [];
+	private waiter: ((val?: any) => void) | null = null;
+	public isDone = false;
+
+	push(data: Buffer) {
+		this.buffers.push(data);
+		if (this.waiter) {
+			this.waiter();
+			this.waiter = null;
+		}
+	}
+
+	markDone() {
+		this.isDone = true;
+		if (this.waiter) {
+			this.waiter();
+			this.waiter = null;
+		}
+	}
+
+	async read(outBuffer: Float32Array): Promise<number> {
+		if (this.buffers.length === 0 && !this.isDone) {
+			await new Promise<void>((resolve) => { this.waiter = resolve; });
+		}
+
+		if (this.buffers.length === 0 && this.isDone) {
+			return 0;
+		}
+
+		let totalFloatsRead = 0;
+		let outOffset = 0;
+		const maxFloats = outBuffer.length;
+
+		while (this.buffers.length > 0 && totalFloatsRead < maxFloats) {
+			const buf = this.buffers[0] as Buffer; // ts not smart enough to check loop condition
+			const floatsInBuf = buf.length / 4;
+			const floatsNeeded = maxFloats - totalFloatsRead;
+
+			const floatsToCopy = Math.min(floatsInBuf, floatsNeeded);
+			const bytesToCopy = floatsToCopy * 4;
+
+			// Copy to outBuffer.
+			// Create a view on the buffer to read floats.
+
+			// We need to ensure byteOffset is a multiple of 4.
+			// If not, we must copy the buffer to a new one.
+			let srcFloats: Float32Array;
+			if (buf.byteOffset % 4 === 0) {
+				srcFloats = new Float32Array(buf.buffer, buf.byteOffset, floatsInBuf);
+			} else {
+				const alignedBuf = new Uint8Array(buf);
+				srcFloats = new Float32Array(alignedBuf.buffer, alignedBuf.byteOffset, floatsInBuf);
+			}
+
+			outBuffer.set(srcFloats.subarray(0, floatsToCopy), outOffset);
+
+			totalFloatsRead += floatsToCopy;
+			outOffset += floatsToCopy;
+
+			if (floatsToCopy < floatsInBuf) {
+				// We didn't use the whole buffer. Update it.
+				this.buffers[0] = buf.subarray(bytesToCopy);
+			} else {
+				// We used the whole buffer. Remove it.
+				this.buffers.shift();
+			}
+		}
+
+		return totalFloatsRead;
+	}
+}
+
+class WebSocketWrapper {
+	private client: Cartesia;
+	private config: any;
+	private socket: WebSocket | null = null;
+	private sources: Map<string, AudioSource> = new Map();
+	// Fallback source for messages without context_id or if we just want to capture everything (legacy behavior?)
+	// The original test didn't use context_id explicitly in send() but expected a response source.
+	// We'll map context_id to source.
+	private defaultSource: AudioSource | null = null;
+
+	constructor(client: Cartesia, config: any) {
+		this.client = client;
+		this.config = config;
+	}
+
+	async connect() {
+		const baseURL = this.client.baseURL;
+		// Construct WebSocket URL
+		// baseURL is like https://api.cartesia.ai
+		let urlStr = baseURL.replace(/^http/, "ws");
+		if (!urlStr.includes("/tts/websocket")) {
+			if (urlStr.endsWith("/")) {
+				urlStr += "tts/websocket";
+			} else {
+				urlStr += "/tts/websocket";
+			}
+		}
+
+		const url = new URL(urlStr);
+
+		const headers: any = {
+			"cartesia-version": "2025-04-16",
+		};
+		if (this.client.apiKey) {
+			headers["Authorization"] = `Bearer ${this.client.apiKey}`;
+		}
+
+		this.socket = new WebSocket(url.toString(), {
+			headers: headers,
+		});
+
+		return new Promise<void>((resolve, reject) => {
+			this.socket!.on("open", () => {
+				console.log("WebSocket connected.");
+				resolve();
+			});
+
+			this.socket!.on("error", (err) => {
+				console.error("WebSocket error:", err);
+				reject(err);
+			});
+
+			this.socket!.on("message", (data) => {
+				this.handleMessage(data);
+			});
+
+			this.socket!.on("close", () => {
+				console.log("WebSocket closed.");
+				this.sources.forEach((s) => { s.markDone(); });
+				if (this.defaultSource) this.defaultSource.markDone();
+			});
+		});
+	}
+
+	private handleMessage(data: WebSocket.Data) {
+		try {
+			const str = data.toString();
+			const msg = JSON.parse(str);
+
+			const contextId = msg.context_id;
+			let source = contextId ? this.sources.get(contextId) : this.defaultSource;
+
+			// If we received a message for a context we don't know about, and we have a default source, use it
+			if (!source && this.defaultSource) {
+				source = this.defaultSource;
+			}
+
+			if (msg.type === "chunk" && msg.data) {
+				const audioData = Buffer.from(msg.data, "base64");
+				if (source) source.push(audioData);
+			} else if (msg.type === "done") {
+				if (source) source.markDone();
+			} else if (msg.type === "error") {
+				console.error("Server error:", msg);
+				if (source) source.markDone(); // Fail the stream?
+			}
+		} catch (e) {
+			console.error("Error parsing message:", e);
+		}
+	}
+
+	async send(request: any) {
+		if (!this.socket) {
+			throw new Error("WebSocket not connected");
+		}
+
+		// Ensure request has a context_id so we can route the response
+		if (!request.context_id) {
+			request.context_id = uuidv4();
+		}
+
+		const source = new AudioSource();
+		this.sources.set(request.context_id, source);
+		// Also set as default source if none exists, for compatibility with simple tests
+		if (!this.defaultSource) {
+			this.defaultSource = source;
+		}
+
+		// Add output format from config if not present
+		if (!request.output_format && this.config) {
+			request.output_format = {
+				container: this.config.container,
+				encoding: this.config.encoding,
+				sample_rate: this.config.sampleRate,
+			};
+		}
+		// Fix camelCase to snake_case for output_format if needed
+		// The new API expects snake_case keys in JSON usually, but let's check.
+		// The GenerationRequest interface has `output_format`.
+		// The config passed to .websocket() uses `sampleRate`.
+		// We might need to map it.
+
+		if (request.output_format) {
+			// Ensure sample_rate is set (mapping from sampleRate)
+			if (request.output_format.sampleRate && !request.output_format.sample_rate) {
+				request.output_format.sample_rate = request.output_format.sampleRate;
+				delete request.output_format.sampleRate;
+			}
+		}
+
+		// Map camelCase request fields to snake_case if necessary?
+		// The old test uses `modelId`, `generationConfig`.
+		// The new API expects `model_id`, `generation_config`.
+		const payload = {
+			...request,
+			model_id: request.modelId || request.model_id,
+			generation_config: request.generationConfig || request.generation_config,
+			context_id: request.context_id,
+		};
+		// Remove camelCase keys if they persist?
+		// JSON.stringify handles it, but we should clean up if we want to be strict.
+
+		// Also `voice` object. Old test: `voice: { mode: 'id', id: ... }`. New API: same.
+
+		this.socket.send(JSON.stringify(payload));
+
+		return {
+			source: source
+		};
+	}
+
+	disconnect() {
+		if (this.socket) {
+			this.socket.close();
+		}
+	}
+}
+
+class TTSWrapper {
+	private client: Cartesia;
+
+	constructor(client: Cartesia) {
+		this.client = client;
+	}
+
+	websocket(config: any) {
+		return new WebSocketWrapper(this.client, config);
+	}
+
+	async bytes(request: any, requestOptions?: any) {
+		const params: any = {
+			model_id: request.modelId,
+			transcript: request.transcript,
+			voice: request.voice,
+			generation_config: request.generationConfig,
+			context_id: request.contextId,
+		};
+
+		if (request.outputFormat) {
+			params.output_format = {
+				...request.outputFormat,
+				sample_rate: request.outputFormat.sampleRate,
+				bit_rate: request.outputFormat.bitRate,
+			};
+			// Remove camelCase keys
+			delete params.output_format.sampleRate;
+			delete params.output_format.bitRate;
+		}
+
+		const options: any = {};
+		if (requestOptions) {
+			if (requestOptions.timeoutInSeconds) {
+				options.timeout = requestOptions.timeoutInSeconds * 1000;
+			}
+			options.maxRetries = requestOptions.maxRetries;
+			options.headers = requestOptions.headers;
+			options.signal = requestOptions.abortSignal;
+		}
+
+		// @ts-ignore
+		return this.client.tts.synthesizeBytes(params, options);
+	}
+}
+
+/*
+ * CartesiaClient - deprecated backcompat class.
+ * New code should use Cartesia class directly instead.
+ */
+export class CartesiaClient {
+	private client: Cartesia;
+	public tts: TTSWrapper;
+
+	constructor(options: any) {
+		this.client = new Cartesia(options);
+		this.tts = new TTSWrapper(this.client);
+	}
+}
+
+
+// Helper for generating UUIDs. Not cryptographically secure.
+function uuidv4() {
+	return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
+		var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
+		return v.toString(16);
+	});
+}

package/src/index.ts

@@ -5,6 +5,7 @@ export { Cartesia as default } from './client';
 export { type Uploadable, toFile } from './core/uploads';
 export { APIPromise } from './core/api-promise';
 export { Cartesia, type ClientOptions } from './client';
+export { CartesiaClient } from './backcompat';
 export { PagePromise } from './core/pagination';
 export {
   CartesiaError,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '3.0.0-b4'; // x-release-please-version
+export const VERSION = '3.0.0-b5'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "3.0.0-b4";
+export declare const VERSION = "3.0.0-b5";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "3.0.0-b4";
+export declare const VERSION = "3.0.0-b5";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '3.0.0-b4'; // x-release-please-version
+exports.VERSION = '3.0.0-b5'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '3.0.0-b4'; // x-release-please-version
+export const VERSION = '3.0.0-b5'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map