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

package/backcompat/voice-changer-wrapper.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceChangerWrapper = void 0;
+const stream_1 = require("stream");
+class VoiceChangerWrapper {
+    constructor(client) {
+        this.client = client;
+    }
+    async bytes(clip, request, requestOptions) {
+        const params = {
+            clip: clip,
+            "voice[id]": request.voiceId,
+            "output_format[container]": request.outputFormatContainer,
+            "output_format[sample_rate]": request.outputFormatSampleRate,
+        };
+        if (request.outputFormatEncoding) {
+            params["output_format[encoding]"] = request.outputFormatEncoding;
+        }
+        if (request.outputFormatBitRate) {
+            params["output_format[bit_rate]"] = request.outputFormatBitRate;
+        }
+        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;
+        }
+        const response = await this.client.voiceChanger.changeVoiceBytes(params, {
+            ...options,
+            __binaryResponse: true,
+        });
+        // @ts-ignore
+        if (response.body) {
+            // @ts-ignore
+            return stream_1.Readable.fromWeb(response.body);
+        }
+        return response;
+    }
+}
+exports.VoiceChangerWrapper = VoiceChangerWrapper;
+//# sourceMappingURL=voice-changer-wrapper.js.map

package/backcompat/voice-changer-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-changer-wrapper.js","sourceRoot":"","sources":["../src/backcompat/voice-changer-wrapper.ts"],"names":[],"mappings":";;;AAIA,mCAAkC;AAWlC,MAAa,mBAAmB;IAG/B,YAAY,MAAgB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK,CACV,IAAiC,EACjC,OAA2C,EAC3C,cAAyC;QAEzC,MAAM,MAAM,GAAQ;YACnB,IAAI,EAAE,IAAkB;YACxB,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,0BAA0B,EAAE,OAAO,CAAC,qBAAqB;YACzD,4BAA4B,EAAE,OAAO,CAAC,sBAAsB;SAC5D,CAAC;QAEF,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAClC,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YACjC,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACjE,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,cAAc,EAAE,CAAC;YACpB,IAAI,cAAc,CAAC,gBAAgB,EAAE,CAAC;gBACrC,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC1D,CAAC;YACD,IAAI,cAAc,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,CAAC,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC;YAChD,CAAC;YACD,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;YACzC,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC;QAC7C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,CAAC,MAAM,EAAE;YACxE,GAAG,OAAO;YACV,gBAAgB,EAAE,IAAI;SACf,CAAC,CAAC;QAEV,aAAa;QACb,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,aAAa;YACb,OAAO,iBAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD;AAnDD,kDAmDC"}

package/backcompat/voice-changer-wrapper.mjs

@@ -0,0 +1,42 @@
+import { Readable } from "stream";
+export class VoiceChangerWrapper {
+    constructor(client) {
+        this.client = client;
+    }
+    async bytes(clip, request, requestOptions) {
+        const params = {
+            clip: clip,
+            "voice[id]": request.voiceId,
+            "output_format[container]": request.outputFormatContainer,
+            "output_format[sample_rate]": request.outputFormatSampleRate,
+        };
+        if (request.outputFormatEncoding) {
+            params["output_format[encoding]"] = request.outputFormatEncoding;
+        }
+        if (request.outputFormatBitRate) {
+            params["output_format[bit_rate]"] = request.outputFormatBitRate;
+        }
+        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;
+        }
+        const response = await this.client.voiceChanger.changeVoiceBytes(params, {
+            ...options,
+            __binaryResponse: true,
+        });
+        // @ts-ignore
+        if (response.body) {
+            // @ts-ignore
+            return Readable.fromWeb(response.body);
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=voice-changer-wrapper.mjs.map

package/backcompat/voice-changer-wrapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-changer-wrapper.mjs","sourceRoot":"","sources":["../src/backcompat/voice-changer-wrapper.ts"],"names":[],"mappings":"OAIO,EAAE,QAAQ,EAAE,MAAM,QAAQ;AAWjC,MAAM,OAAO,mBAAmB;IAG/B,YAAY,MAAgB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK,CACV,IAAiC,EACjC,OAA2C,EAC3C,cAAyC;QAEzC,MAAM,MAAM,GAAQ;YACnB,IAAI,EAAE,IAAkB;YACxB,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,0BAA0B,EAAE,OAAO,CAAC,qBAAqB;YACzD,4BAA4B,EAAE,OAAO,CAAC,sBAAsB;SAC5D,CAAC;QAEF,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAClC,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YACjC,MAAM,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACjE,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,cAAc,EAAE,CAAC;YACpB,IAAI,cAAc,CAAC,gBAAgB,EAAE,CAAC;gBACrC,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC1D,CAAC;YACD,IAAI,cAAc,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,CAAC,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC;YAChD,CAAC;YACD,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;YACzC,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC;QAC7C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,CAAC,MAAM,EAAE;YACxE,GAAG,OAAO;YACV,gBAAgB,EAAE,IAAI;SACf,CAAC,CAAC;QAEV,aAAa;QACb,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,aAAa;YACb,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}

package/backcompat/voices-wrapper.d.mts

@@ -0,0 +1,32 @@
+import * as fs from "fs";
+import { Cartesia } from "../client.mjs";
+import { type VoiceMetadata, type Voice } from "../resources/voices.mjs";
+import { BackCompatRequestOptions } from "./types.mjs";
+export interface BackCompatCloneVoiceRequest {
+    name: string;
+    description?: string;
+    language: string;
+    mode: "similarity" | "stability";
+    enhance?: boolean;
+    baseVoiceId?: string;
+}
+export interface BackCompatUpdateVoiceRequest {
+    name: string;
+    description: string;
+}
+export interface BackCompatLocalizeVoiceRequest {
+    voiceId: string;
+    name: string;
+    description: string;
+    language: "en" | "de" | "es" | "fr" | "ja" | "pt" | "zh" | "hi" | "it" | "ko" | "nl" | "pl" | "ru" | "sv" | "tr";
+    originalSpeakerGender: "male" | "female";
+    dialect?: "au" | "in" | "so" | "uk" | "us" | "mx" | "pe" | "br" | "eu" | "ca";
+}
+export declare class VoicesWrapper {
+    private client;
+    constructor(client: Cartesia);
+    clone(clip: File | fs.ReadStream | Blob, request: BackCompatCloneVoiceRequest, requestOptions?: BackCompatRequestOptions): Promise<VoiceMetadata>;
+    update(id: string, request: BackCompatUpdateVoiceRequest, requestOptions?: BackCompatRequestOptions): Promise<Voice>;
+    localize(request: BackCompatLocalizeVoiceRequest, requestOptions?: BackCompatRequestOptions): Promise<VoiceMetadata>;
+}
+//# sourceMappingURL=voices-wrapper.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voices-wrapper.d.mts","sourceRoot":"","sources":["../src/backcompat/voices-wrapper.ts"],"names":[],"mappings":"OAAO,KAAK,EAAE,MAAM,IAAI;OACjB,EAAE,QAAQ,EAAE;OAEZ,EAEN,KAAK,aAAa,EAGlB,KAAK,KAAK,EAEV;OAEM,EAAE,wBAAwB,EAAE;AAEnC,MAAM,WAAW,2BAA2B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,WAAW,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;IACR,qBAAqB,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzC,OAAO,CAAC,EACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;CACR;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAItB,KAAK,CACV,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,UAAU,GAAG,IAAI,EACjC,OAAO,EAAE,2BAA2B,EACpC,cAAc,CAAC,EAAE,wBAAwB,GACvC,OAAO,CAAC,aAAa,CAAC;IA6BnB,MAAM,CACX,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,4BAA4B,EACrC,cAAc,CAAC,EAAE,wBAAwB,GACvC,OAAO,CAAC,KAAK,CAAC;IAqBX,QAAQ,CACb,OAAO,EAAE,8BAA8B,EACvC,cAAc,CAAC,EAAE,wBAAwB,GACvC,OAAO,CAAC,aAAa,CAAC;CA2BzB"}

package/backcompat/voices-wrapper.d.ts

@@ -0,0 +1,32 @@
+import * as fs from "fs";
+import { Cartesia } from "../client.js";
+import { type VoiceMetadata, type Voice } from "../resources/voices.js";
+import { BackCompatRequestOptions } from "./types.js";
+export interface BackCompatCloneVoiceRequest {
+    name: string;
+    description?: string;
+    language: string;
+    mode: "similarity" | "stability";
+    enhance?: boolean;
+    baseVoiceId?: string;
+}
+export interface BackCompatUpdateVoiceRequest {
+    name: string;
+    description: string;
+}
+export interface BackCompatLocalizeVoiceRequest {
+    voiceId: string;
+    name: string;
+    description: string;
+    language: "en" | "de" | "es" | "fr" | "ja" | "pt" | "zh" | "hi" | "it" | "ko" | "nl" | "pl" | "ru" | "sv" | "tr";
+    originalSpeakerGender: "male" | "female";
+    dialect?: "au" | "in" | "so" | "uk" | "us" | "mx" | "pe" | "br" | "eu" | "ca";
+}
+export declare class VoicesWrapper {
+    private client;
+    constructor(client: Cartesia);
+    clone(clip: File | fs.ReadStream | Blob, request: BackCompatCloneVoiceRequest, requestOptions?: BackCompatRequestOptions): Promise<VoiceMetadata>;
+    update(id: string, request: BackCompatUpdateVoiceRequest, requestOptions?: BackCompatRequestOptions): Promise<Voice>;
+    localize(request: BackCompatLocalizeVoiceRequest, requestOptions?: BackCompatRequestOptions): Promise<VoiceMetadata>;
+}
+//# sourceMappingURL=voices-wrapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voices-wrapper.d.ts","sourceRoot":"","sources":["../src/backcompat/voices-wrapper.ts"],"names":[],"mappings":"OAAO,KAAK,EAAE,MAAM,IAAI;OACjB,EAAE,QAAQ,EAAE;OAEZ,EAEN,KAAK,aAAa,EAGlB,KAAK,KAAK,EAEV;OAEM,EAAE,wBAAwB,EAAE;AAEnC,MAAM,WAAW,2BAA2B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,WAAW,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;IACR,qBAAqB,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzC,OAAO,CAAC,EACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;CACR;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAItB,KAAK,CACV,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,UAAU,GAAG,IAAI,EACjC,OAAO,EAAE,2BAA2B,EACpC,cAAc,CAAC,EAAE,wBAAwB,GACvC,OAAO,CAAC,aAAa,CAAC;IA6BnB,MAAM,CACX,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,4BAA4B,EACrC,cAAc,CAAC,EAAE,wBAAwB,GACvC,OAAO,CAAC,KAAK,CAAC;IAqBX,QAAQ,CACb,OAAO,EAAE,8BAA8B,EACvC,cAAc,CAAC,EAAE,wBAAwB,GACvC,OAAO,CAAC,aAAa,CAAC;CA2BzB"}

package/backcompat/voices-wrapper.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoicesWrapper = void 0;
+class VoicesWrapper {
+    constructor(client) {
+        this.client = client;
+    }
+    async clone(clip, request, requestOptions) {
+        const params = {
+            clip: clip,
+            name: request.name,
+            language: request.language,
+        };
+        if (request.description !== undefined) {
+            params.description = request.description;
+        }
+        if (request.baseVoiceId !== undefined) {
+            params.base_voice_id = request.baseVoiceId;
+        }
+        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;
+        }
+        return this.client.voices.clone(params, options);
+    }
+    async update(id, request, requestOptions) {
+        const params = {
+            name: request.name,
+            description: request.description,
+        };
+        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;
+        }
+        return this.client.voices.update(id, params, options);
+    }
+    async localize(request, requestOptions) {
+        const params = {
+            voice_id: request.voiceId,
+            name: request.name,
+            description: request.description,
+            language: request.language,
+            original_speaker_gender: request.originalSpeakerGender,
+        };
+        if (request.dialect) {
+            params.dialect = request.dialect; // Cast dialect as list might vary slightly or be strict
+        }
+        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;
+        }
+        return this.client.voices.localize(params, options);
+    }
+}
+exports.VoicesWrapper = VoicesWrapper;
+//# sourceMappingURL=voices-wrapper.js.map

package/backcompat/voices-wrapper.js.map

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

package/backcompat/voices-wrapper.mjs

@@ -0,0 +1,73 @@
+export class VoicesWrapper {
+    constructor(client) {
+        this.client = client;
+    }
+    async clone(clip, request, requestOptions) {
+        const params = {
+            clip: clip,
+            name: request.name,
+            language: request.language,
+        };
+        if (request.description !== undefined) {
+            params.description = request.description;
+        }
+        if (request.baseVoiceId !== undefined) {
+            params.base_voice_id = request.baseVoiceId;
+        }
+        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;
+        }
+        return this.client.voices.clone(params, options);
+    }
+    async update(id, request, requestOptions) {
+        const params = {
+            name: request.name,
+            description: request.description,
+        };
+        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;
+        }
+        return this.client.voices.update(id, params, options);
+    }
+    async localize(request, requestOptions) {
+        const params = {
+            voice_id: request.voiceId,
+            name: request.name,
+            description: request.description,
+            language: request.language,
+            original_speaker_gender: request.originalSpeakerGender,
+        };
+        if (request.dialect) {
+            params.dialect = request.dialect; // Cast dialect as list might vary slightly or be strict
+        }
+        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;
+        }
+        return this.client.voices.localize(params, options);
+    }
+}
+//# sourceMappingURL=voices-wrapper.mjs.map

package/backcompat/voices-wrapper.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartesia/cartesia-js",
-  "version": "3.0.0-b5",
+  "version": "3.0.0-b6",
   "description": "The official TypeScript library for the Cartesia API",
   "author": "Cartesia <>",
   "types": "./index.d.ts",

package/src/backcompat/index.ts

@@ -1,282 +1,8 @@
-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);
-	}
-}
+import { Cartesia, type ClientOptions } from "../client";
+import { TTSWrapper } from "./tts-wrapper";
+import { VoicesWrapper } from "./voices-wrapper";
+import { VoiceChangerWrapper } from "./voice-changer-wrapper";
+import type { CartesiaClientOptions } from "./types";
 
 /*
  * CartesiaClient - deprecated backcompat class.
@@ -285,18 +11,30 @@ class TTSWrapper {
 export class CartesiaClient {
 	private client: Cartesia;
 	public tts: TTSWrapper;
+	public voices: VoicesWrapper;
+	public voiceChanger: VoiceChangerWrapper;
+
+	constructor(options: CartesiaClientOptions = {}) {
+		const newOptions: ClientOptions = {};
+
+		if (options.apiKey) {
+			newOptions.apiKey = options.apiKey as any;
+		}
+
+		if (options.baseUrl) {
+			newOptions.baseURL = options.baseUrl as any;
+		} else if (options.environment) {
+			newOptions.baseURL = options.environment as any;
+		}
 
-	constructor(options: any) {
-		this.client = new Cartesia(options);
+		this.client = new Cartesia(newOptions);
 		this.tts = new TTSWrapper(this.client);
+		this.voices = new VoicesWrapper(this.client);
+		this.voiceChanger = new VoiceChangerWrapper(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);
-	});
-}
+export * from "./tts-wrapper";
+export * from "./voices-wrapper";
+export * from "./voice-changer-wrapper";
+export * from "./types";