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

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 3.0.0-b6 (2026-01-09)
+
+Full Changelog: [v3.0.0-b5...v3.0.0-b6](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b5...v3.0.0-b6)
+
+## 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,16 @@
+import { TTSWrapper } from "./tts-wrapper.mjs";
+import { VoicesWrapper } from "./voices-wrapper.mjs";
+import { VoiceChangerWrapper } from "./voice-changer-wrapper.mjs";
+import type { CartesiaClientOptions } from "./types.mjs";
+export declare class CartesiaClient {
+    private client;
+    tts: TTSWrapper;
+    voices: VoicesWrapper;
+    voiceChanger: VoiceChangerWrapper;
+    constructor(options?: CartesiaClientOptions);
+}
+export * from "./tts-wrapper.mjs";
+export * from "./voices-wrapper.mjs";
+export * from "./voice-changer-wrapper.mjs";
+export * from "./types.mjs";
+//# 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,UAAU,EAAE;OACd,EAAE,aAAa,EAAE;OACjB,EAAE,mBAAmB,EAAE;OACvB,KAAK,EAAE,qBAAqB,EAAE;AAMrC,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAAW;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;gBAE7B,OAAO,GAAE,qBAA0B;CAkB/C"}

package/backcompat/index.d.ts

@@ -0,0 +1,16 @@
+import { TTSWrapper } from "./tts-wrapper.js";
+import { VoicesWrapper } from "./voices-wrapper.js";
+import { VoiceChangerWrapper } from "./voice-changer-wrapper.js";
+import type { CartesiaClientOptions } from "./types.js";
+export declare class CartesiaClient {
+    private client;
+    tts: TTSWrapper;
+    voices: VoicesWrapper;
+    voiceChanger: VoiceChangerWrapper;
+    constructor(options?: CartesiaClientOptions);
+}
+export * from "./tts-wrapper.js";
+export * from "./voices-wrapper.js";
+export * from "./voice-changer-wrapper.js";
+export * from "./types.js";
+//# 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,UAAU,EAAE;OACd,EAAE,aAAa,EAAE;OACjB,EAAE,mBAAmB,EAAE;OACvB,KAAK,EAAE,qBAAqB,EAAE;AAMrC,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAAW;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;gBAE7B,OAAO,GAAE,qBAA0B;CAkB/C"}

package/backcompat/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CartesiaClient = void 0;
+const tslib_1 = require("../internal/tslib.js");
+const client_1 = require("../client.js");
+const tts_wrapper_1 = require("./tts-wrapper.js");
+const voices_wrapper_1 = require("./voices-wrapper.js");
+const voice_changer_wrapper_1 = require("./voice-changer-wrapper.js");
+/*
+ * CartesiaClient - deprecated backcompat class.
+ * New code should use Cartesia class directly instead.
+ */
+class CartesiaClient {
+    constructor(options = {}) {
+        const newOptions = {};
+        if (options.apiKey) {
+            newOptions.apiKey = options.apiKey;
+        }
+        if (options.baseUrl) {
+            newOptions.baseURL = options.baseUrl;
+        }
+        else if (options.environment) {
+            newOptions.baseURL = options.environment;
+        }
+        this.client = new client_1.Cartesia(newOptions);
+        this.tts = new tts_wrapper_1.TTSWrapper(this.client);
+        this.voices = new voices_wrapper_1.VoicesWrapper(this.client);
+        this.voiceChanger = new voice_changer_wrapper_1.VoiceChangerWrapper(this.client);
+    }
+}
+exports.CartesiaClient = CartesiaClient;
+tslib_1.__exportStar(require("./tts-wrapper.js"), exports);
+tslib_1.__exportStar(require("./voices-wrapper.js"), exports);
+tslib_1.__exportStar(require("./voice-changer-wrapper.js"), exports);
+tslib_1.__exportStar(require("./types.js"), exports);
+//# 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":";;;;AAAA,yCAAyD;AACzD,kDAA2C;AAC3C,wDAAiD;AACjD,sEAA8D;AAG9D;;;GAGG;AACH,MAAa,cAAc;IAM1B,YAAY,UAAiC,EAAE;QAC9C,MAAM,UAAU,GAAkB,EAAE,CAAC;QAErC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAa,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,OAAc,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,WAAkB,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,IAAI,wBAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,IAAI,2CAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;CACD;AAxBD,wCAwBC;AAED,2DAA8B;AAC9B,8DAAiC;AACjC,qEAAwC;AACxC,qDAAwB"}

package/backcompat/index.mjs

@@ -0,0 +1,31 @@
+import { Cartesia } from "../client.mjs";
+import { TTSWrapper } from "./tts-wrapper.mjs";
+import { VoicesWrapper } from "./voices-wrapper.mjs";
+import { VoiceChangerWrapper } from "./voice-changer-wrapper.mjs";
+/*
+ * CartesiaClient - deprecated backcompat class.
+ * New code should use Cartesia class directly instead.
+ */
+export class CartesiaClient {
+    constructor(options = {}) {
+        const newOptions = {};
+        if (options.apiKey) {
+            newOptions.apiKey = options.apiKey;
+        }
+        if (options.baseUrl) {
+            newOptions.baseURL = options.baseUrl;
+        }
+        else if (options.environment) {
+            newOptions.baseURL = options.environment;
+        }
+        this.client = new Cartesia(newOptions);
+        this.tts = new TTSWrapper(this.client);
+        this.voices = new VoicesWrapper(this.client);
+        this.voiceChanger = new VoiceChangerWrapper(this.client);
+    }
+}
+export * from "./tts-wrapper.mjs";
+export * from "./voices-wrapper.mjs";
+export * from "./voice-changer-wrapper.mjs";
+export * from "./types.mjs";
+//# 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":"OAAO,EAAE,QAAQ,EAAsB;OAChC,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE;OACjB,EAAE,mBAAmB,EAAE;AAG9B;;;GAGG;AACH,MAAM,OAAO,cAAc;IAM1B,YAAY,UAAiC,EAAE;QAC9C,MAAM,UAAU,GAAkB,EAAE,CAAC;QAErC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAa,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,OAAc,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,WAAkB,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;CACD"}

package/backcompat/tts-wrapper.d.mts

@@ -0,0 +1,66 @@
+import { Cartesia } from "../client.mjs";
+import { BackCompatRequestOptions } from "./types.mjs";
+export interface BackCompatWebSocketOptions {
+    container?: "raw" | "wav" | "mp3";
+    encoding?: "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
+    sampleRate: number;
+}
+export type BackCompatTtsRequestVoiceSpecifier = {
+    mode: "id";
+    id: string;
+} | {
+    mode: "embedding";
+    embedding: number[];
+};
+export interface BackCompatGenerationConfig {
+    volume?: number;
+    speed?: number;
+    emotion?: string[];
+}
+export interface BackCompatWebSocketTtsRequest {
+    modelId: string;
+    transcript: string;
+    voice: BackCompatTtsRequestVoiceSpecifier;
+    generationConfig?: BackCompatGenerationConfig;
+    outputFormat?: {
+        container?: "raw" | "wav" | "mp3";
+        encoding?: "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
+        sampleRate?: number;
+        bitRate?: number;
+    };
+    contextId?: string;
+    continue?: boolean;
+    duration?: number;
+    addTimestamps?: boolean;
+    addPhonemeTimestamps?: boolean;
+}
+declare class AudioSource {
+    private buffers;
+    private waiter;
+    isDone: boolean;
+    push(data: Buffer): void;
+    markDone(): void;
+    read(outBuffer: Float32Array): Promise<number>;
+}
+export declare class WebSocketWrapper {
+    private client;
+    private config;
+    private socket;
+    private sources;
+    private defaultSource;
+    constructor(client: Cartesia, config: BackCompatWebSocketOptions);
+    connect(): Promise<void>;
+    private handleMessage;
+    send(request: BackCompatWebSocketTtsRequest): Promise<{
+        source: AudioSource;
+    }>;
+    disconnect(): void;
+}
+export declare class TTSWrapper {
+    private client;
+    constructor(client: Cartesia);
+    websocket(config: BackCompatWebSocketOptions): WebSocketWrapper;
+    bytes(request: any, requestOptions?: BackCompatRequestOptions): Promise<any>;
+}
+export {};
+//# sourceMappingURL=tts-wrapper.d.mts.map

package/backcompat/tts-wrapper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-wrapper.d.mts","sourceRoot":"","sources":["../src/backcompat/tts-wrapper.ts"],"names":[],"mappings":"OACO,EAAE,QAAQ,EAAE;OAEZ,EAAE,wBAAwB,EAAE;AAGnC,MAAM,WAAW,0BAA0B;IAC1C,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAChE,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kCAAkC,GAC3C;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,0BAA0B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,kCAAkC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,YAAY,CAAC,EAAE;QACd,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;QAClC,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;QAChE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAUD,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,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAuC;IAItD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,0BAA0B;IAK1D,OAAO;IAiDb,OAAO,CAAC,aAAa;IA2Bf,IAAI,CAAC,OAAO,EAAE,6BAA6B;;;IAyDjD,UAAU;CAKV;AAED,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAI5B,SAAS,CAAC,MAAM,EAAE,0BAA0B;IAItC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,wBAAwB;CAmCnE"}

package/backcompat/tts-wrapper.d.ts

@@ -0,0 +1,66 @@
+import { Cartesia } from "../client.js";
+import { BackCompatRequestOptions } from "./types.js";
+export interface BackCompatWebSocketOptions {
+    container?: "raw" | "wav" | "mp3";
+    encoding?: "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
+    sampleRate: number;
+}
+export type BackCompatTtsRequestVoiceSpecifier = {
+    mode: "id";
+    id: string;
+} | {
+    mode: "embedding";
+    embedding: number[];
+};
+export interface BackCompatGenerationConfig {
+    volume?: number;
+    speed?: number;
+    emotion?: string[];
+}
+export interface BackCompatWebSocketTtsRequest {
+    modelId: string;
+    transcript: string;
+    voice: BackCompatTtsRequestVoiceSpecifier;
+    generationConfig?: BackCompatGenerationConfig;
+    outputFormat?: {
+        container?: "raw" | "wav" | "mp3";
+        encoding?: "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
+        sampleRate?: number;
+        bitRate?: number;
+    };
+    contextId?: string;
+    continue?: boolean;
+    duration?: number;
+    addTimestamps?: boolean;
+    addPhonemeTimestamps?: boolean;
+}
+declare class AudioSource {
+    private buffers;
+    private waiter;
+    isDone: boolean;
+    push(data: Buffer): void;
+    markDone(): void;
+    read(outBuffer: Float32Array): Promise<number>;
+}
+export declare class WebSocketWrapper {
+    private client;
+    private config;
+    private socket;
+    private sources;
+    private defaultSource;
+    constructor(client: Cartesia, config: BackCompatWebSocketOptions);
+    connect(): Promise<void>;
+    private handleMessage;
+    send(request: BackCompatWebSocketTtsRequest): Promise<{
+        source: AudioSource;
+    }>;
+    disconnect(): void;
+}
+export declare class TTSWrapper {
+    private client;
+    constructor(client: Cartesia);
+    websocket(config: BackCompatWebSocketOptions): WebSocketWrapper;
+    bytes(request: any, requestOptions?: BackCompatRequestOptions): Promise<any>;
+}
+export {};
+//# sourceMappingURL=tts-wrapper.d.ts.map

package/backcompat/tts-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-wrapper.d.ts","sourceRoot":"","sources":["../src/backcompat/tts-wrapper.ts"],"names":[],"mappings":"OACO,EAAE,QAAQ,EAAE;OAEZ,EAAE,wBAAwB,EAAE;AAGnC,MAAM,WAAW,0BAA0B;IAC1C,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAChE,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kCAAkC,GAC3C;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,0BAA0B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,kCAAkC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,YAAY,CAAC,EAAE;QACd,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;QAClC,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;QAChE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAUD,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,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAuC;IAItD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,0BAA0B;IAK1D,OAAO;IAiDb,OAAO,CAAC,aAAa;IA2Bf,IAAI,CAAC,OAAO,EAAE,6BAA6B;;;IAyDjD,UAAU;CAKV;AAED,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAI5B,SAAS,CAAC,MAAM,EAAE,0BAA0B;IAItC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,wBAAwB;CAmCnE"}

package/backcompat/tts-wrapper.js

@@ -0,0 +1,260 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TTSWrapper = exports.WebSocketWrapper = void 0;
+const tslib_1 = require("../internal/tslib.js");
+const ws_1 = tslib_1.__importDefault(require("ws"));
+// 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);
+    });
+}
+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
+        const contextId = request.contextId || uuidv4();
+        const source = new AudioSource();
+        this.sources.set(contextId, source);
+        // Also set as default source if none exists, for compatibility with simple tests
+        if (!this.defaultSource) {
+            this.defaultSource = source;
+        }
+        // Construct payload
+        const payload = {
+            model_id: request.modelId,
+            transcript: request.transcript,
+            voice: request.voice,
+            context_id: contextId,
+        };
+        // Output Format
+        if (request.outputFormat) {
+            payload.output_format = {
+                container: request.outputFormat.container,
+                encoding: request.outputFormat.encoding,
+                sample_rate: request.outputFormat.sampleRate,
+                bit_rate: request.outputFormat.bitRate,
+            };
+        }
+        else if (this.config) {
+            payload.output_format = {
+                container: this.config.container,
+                encoding: this.config.encoding,
+                sample_rate: this.config.sampleRate,
+            };
+        }
+        // Generation Config
+        if (request.generationConfig) {
+            payload.generation_config = request.generationConfig;
+        }
+        // Other fields
+        if (request.continue !== undefined)
+            payload.continue = request.continue;
+        if (request.duration !== undefined)
+            payload.duration = request.duration;
+        if (request.addTimestamps !== undefined)
+            payload.add_timestamps = request.addTimestamps;
+        if (request.addPhonemeTimestamps !== undefined)
+            payload.add_phoneme_timestamps = request.addPhonemeTimestamps;
+        this.socket.send(JSON.stringify(payload));
+        return {
+            source: source
+        };
+    }
+    disconnect() {
+        if (this.socket) {
+            this.socket.close();
+        }
+    }
+}
+exports.WebSocketWrapper = WebSocketWrapper;
+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;
+            }
+            if (requestOptions.maxRetries !== undefined) {
+                options.maxRetries = requestOptions.maxRetries;
+            }
+            options.headers = requestOptions.headers;
+            options.signal = requestOptions.abortSignal;
+        }
+        // @ts-ignore
+        return this.client.tts.synthesizeBytes(params, options);
+    }
+}
+exports.TTSWrapper = TTSWrapper;
+//# sourceMappingURL=tts-wrapper.js.map