@cartesia/cartesia-js 3.0.0-b8 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,139 @@
 # Changelog
 
+## 3.0.0 (2026-03-02)
+
+Full Changelog: [v3.0.0-b17...v3.0.0](https://github.com/cartesia-ai/cartesia-js/compare/v3.0.0-b17...v3.0.0)
+
+### Features
+
+* **api:** add flush_id to chunks response and binary response to voice changer ([1d98580](https://github.com/cartesia-ai/cartesia-js/commit/1d98580ffe61be7a86d28bdf1ee5bb1d50df7382))
+* **api:** group infill output_format ([ac4ded7](https://github.com/cartesia-ai/cartesia-js/commit/ac4ded743720fedbc4517c9c94ed75e79bb2f18b))
+* **api:** infill output_format ([c3d3dac](https://github.com/cartesia-ai/cartesia-js/commit/c3d3dac2d3756038b2d199a75c204413c23a19d1))
+* **api:** infill response ([b9cbaa2](https://github.com/cartesia-ai/cartesia-js/commit/b9cbaa27c220db26462aee7c80692df89edeb8fe))
+* **api:** inline websocketresponse type definitions ([c5cbfbf](https://github.com/cartesia-ai/cartesia-js/commit/c5cbfbfeca17b0f799d791a9ba32c8d2fd18cda8))
+* **api:** move infill and websocket_connect ([a987ebd](https://github.com/cartesia-ai/cartesia-js/commit/a987ebdddc35712a26bbad443672ee45a78b4afc))
+* **api:** update headline example ([715db7e](https://github.com/cartesia-ai/cartesia-js/commit/715db7e02534a0e2254da61fc7342b240e7f251e))
+
+
+### Bug Fixes
+
+* **client:** avoid memory leak with abort signals ([fb63460](https://github.com/cartesia-ai/cartesia-js/commit/fb63460d3701ac1684f5385f7d882f5e71747f14))
+* **client:** avoid removing abort listener too early ([b89ee81](https://github.com/cartesia-ai/cartesia-js/commit/b89ee81caf0ae443eeac9898fb807c34545eb70b))
+* **docs/contributing:** correct pnpm link command ([d5830ae](https://github.com/cartesia-ai/cartesia-js/commit/d5830aed6fd927265bfdbbe875aed7093e0f24cc))
+* **internal:** skip tests that depend on mock server ([e55b44f](https://github.com/cartesia-ai/cartesia-js/commit/e55b44f8402a4f59f59e4780e06300260c9b8170))
+
+
+### Chores
+
+* **client:** do not parse responses with empty content-length ([ed0b69e](https://github.com/cartesia-ai/cartesia-js/commit/ed0b69e1c1d6d7854bccfb2d65ef273cc9564d93))
+* **client:** restructure abort controller binding ([e969433](https://github.com/cartesia-ai/cartesia-js/commit/e9694332f28915c81908a09bffc1d877befb848f))
+* **internal/client:** fix form-urlencoded requests ([80aceb7](https://github.com/cartesia-ai/cartesia-js/commit/80aceb72e17b1c6989e2ea9e53b83d29cdfe766e))
+* **internal:** avoid type checking errors with ts-reset ([3eb6f15](https://github.com/cartesia-ai/cartesia-js/commit/3eb6f15cb8faa30ab5b759599a0bf74243851a5b))
+* **internal:** fix pagination internals not accepting option promises ([822f34f](https://github.com/cartesia-ai/cartesia-js/commit/822f34fab79bd7274e15fe383798696e9ae3930b))
+* **internal:** move stringifyQuery implementation to internal function ([ec23288](https://github.com/cartesia-ai/cartesia-js/commit/ec23288564c1586c22e64581ff4d77763a00a268))
+* **internal:** remove mock server code ([2fe0e85](https://github.com/cartesia-ai/cartesia-js/commit/2fe0e85f5884a797b9bbbe80013e30f17f6ca5cb))
+* **internal:** upgrade pnpm ([948fa2d](https://github.com/cartesia-ai/cartesia-js/commit/948fa2dbdc13671eda76493bbac27976fb70649b))
+* **internal:** upgrade pnpm version ([9cc6aa2](https://github.com/cartesia-ai/cartesia-js/commit/9cc6aa2b033369cea8ade26c92bca06c3f6d4a79))
+* update mock server docs ([4f1e1c6](https://github.com/cartesia-ai/cartesia-js/commit/4f1e1c6f34149aa4a65d4d562e32d19f8c247ce9))
+
+## 3.0.0-b17 (2026-01-30)
+
+Full Changelog: [v3.0.0-b16...v3.0.0-b17](https://github.com/cartesia-ai/cartesia-js/compare/v3.0.0-b16...v3.0.0-b17)
+
+### Features
+
+* **api:** update api version ([e98298c](https://github.com/cartesia-ai/cartesia-js/commit/e98298c56b49f1bf1a8e494edfaafd78cc5ebd4c))
+
+## 3.0.0-b16 (2026-01-29)
+
+Full Changelog: [v3.0.0-b15...v3.0.0-b16](https://github.com/cartesia-ai/cartesia-js/compare/v3.0.0-b15...v3.0.0-b16)
+
+### Features
+
+* **api:** add jsr key to npm target ([5afbf2e](https://github.com/cartesia-ai/cartesia-js/commit/5afbf2e0bad2551e2dbaa0be31553f98fdeb9724))
+* **api:** update js target ([a39e957](https://github.com/cartesia-ai/cartesia-js/commit/a39e9571aa58fb6e1bbddeb523ce83527293a58b))
+
+## 3.0.0-b15 (2026-01-29)
+
+Full Changelog: [v3.0.0-b14...v3.0.0-b15](https://github.com/cartesia-ai/cartesia-js/compare/v3.0.0-b14...v3.0.0-b15)
+
+### Features
+
+* **api:** add release environment ([501864c](https://github.com/cartesia-ai/cartesia-js/commit/501864ca051ad7197b54bbb8c08039bb883ff4fd))
+* **api:** update release environment ([c148860](https://github.com/cartesia-ai/cartesia-js/commit/c148860eea503d0720b08e7d187272625491d918))
+* ws context helpers ([d1898fb](https://github.com/cartesia-ai/cartesia-js/commit/d1898fbe768daeb527282a4e7bcc53d4e4f7af51))
+
+
+### Bug Fixes
+
+* bytes returns arraybuffer ([#26](https://github.com/cartesia-ai/cartesia-js/issues/26)) ([229ea0f](https://github.com/cartesia-ai/cartesia-js/commit/229ea0f08c21d9a5fb56be8fac2a044368a33c34))
+* export correct client ([#21](https://github.com/cartesia-ai/cartesia-js/issues/21)) ([e8456dd](https://github.com/cartesia-ai/cartesia-js/commit/e8456dd39a91f55cb27cd038cef0dbcd1b1acf3e))
+* include message in `TimeoutError` for `.fernignore` clients. ([#41](https://github.com/cartesia-ai/cartesia-js/issues/41)) ([d50a5b9](https://github.com/cartesia-ai/cartesia-js/commit/d50a5b9a30a3c7001572d60314a6a3bb752ac28f))
+* upgrade qs from 6.11.2 to 6.13.0 ([#24](https://github.com/cartesia-ai/cartesia-js/issues/24)) ([fddd4ac](https://github.com/cartesia-ai/cartesia-js/commit/fddd4acef6bd20d3859712b25f8774c6d04c2031))
+
+
+### Chores
+
+* downgrade emittery for cjs compatiblity ([#23](https://github.com/cartesia-ai/cartesia-js/issues/23)) ([015d941](https://github.com/cartesia-ai/cartesia-js/commit/015d9414cff876e44adf776cecca73bc081c2b48))
+* export `WebPlayer` ([#31](https://github.com/cartesia-ai/cartesia-js/issues/31)) ([e31186e](https://github.com/cartesia-ai/cartesia-js/commit/e31186e75fbb22c5a79d82ddea5b160f3dd05e04))
+* fix compile ([#64](https://github.com/cartesia-ai/cartesia-js/issues/64)) ([1de7fd0](https://github.com/cartesia-ai/cartesia-js/commit/1de7fd0b7891e54a13a78699516e610886578681))
+* **internal:** codegen related update ([e44abc2](https://github.com/cartesia-ai/cartesia-js/commit/e44abc24b5c18735c74f1a9345b6f9d312aad338))
+* remove `ci.yml` branch ([#22](https://github.com/cartesia-ai/cartesia-js/issues/22)) ([6d2201a](https://github.com/cartesia-ai/cartesia-js/commit/6d2201a7d13172768b5d17c2e8dc5ebfd3d9bcd2))
+* remove fernignore on ArrayBuffer ([#55](https://github.com/cartesia-ai/cartesia-js/issues/55)) ([b10bbc7](https://github.com/cartesia-ai/cartesia-js/commit/b10bbc75335089004b38f4b547d92d789f15275c))
+* remove ignored `README.md` ([#56](https://github.com/cartesia-ai/cartesia-js/issues/56)) ([ee6d2dd](https://github.com/cartesia-ai/cartesia-js/commit/ee6d2dd17b0e392189e553affdc411fcde42d5ed))
+* remove STT .fernignore ([#65](https://github.com/cartesia-ai/cartesia-js/issues/65)) ([3c0ce3e](https://github.com/cartesia-ai/cartesia-js/commit/3c0ce3e0449166e3e7dc766eeeb90a991e12e401))
+* sync repo ([1ad7016](https://github.com/cartesia-ai/cartesia-js/commit/1ad7016dc4222eb858389a0eed7dcd0558713346))
+* update `apiKeyHeader` to `apiKey` ([#20](https://github.com/cartesia-ai/cartesia-js/issues/20)) ([0f54d2e](https://github.com/cartesia-ai/cartesia-js/commit/0f54d2ee812cd080c8722a55a157b63a37f885d5))
+* update README ([#58](https://github.com/cartesia-ai/cartesia-js/issues/58)) ([c24f0a6](https://github.com/cartesia-ai/cartesia-js/commit/c24f0a6bfb43647723e322215ffc59f3b307b700))
+* Update README.md ([#32](https://github.com/cartesia-ai/cartesia-js/issues/32)) ([8d36b88](https://github.com/cartesia-ai/cartesia-js/commit/8d36b88f76a56b470e57d16190f127d915e934e9))
+* update SDK settings ([e2be8ea](https://github.com/cartesia-ai/cartesia-js/commit/e2be8ea4b2dbc3891029efa3f40bec512622f78d))
+
+## 3.0.0-b14 (2026-01-23)
+
+Full Changelog: [v3.0.0-b13...v3.0.0-b14](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b13...v3.0.0-b14)
+
+## 3.0.0-b13 (2026-01-21)
+
+Full Changelog: [v3.0.0-b12...v3.0.0-b13](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b12...v3.0.0-b13)
+
+### Features
+
+* **api:** remove -> delete ([04c4d03](https://github.com/cartesia-ai/cartesia-js-internal/commit/04c4d03a3e3525ad0e8c72a6372602319cdedb56))
+* wrapper remove -> delete ([e856bda](https://github.com/cartesia-ai/cartesia-js-internal/commit/e856bda9d6bfb07c6df08839087de24380b336be))
+
+## 3.0.0-b12 (2026-01-21)
+
+Full Changelog: [v3.0.0-b11...v3.0.0-b12](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b11...v3.0.0-b12)
+
+### Features
+
+* **api:** delete -> remove ([d51a281](https://github.com/cartesia-ai/cartesia-js-internal/commit/d51a2812bb7e5be98d1aa4248e90acc3a4aae0d2))
+* update backcompat voices helpers ([ca4cc6a](https://github.com/cartesia-ai/cartesia-js-internal/commit/ca4cc6a98c2f9165689916e22afd784f56671948))
+
+## 3.0.0-b11 (2026-01-20)
+
+Full Changelog: [v3.0.0-b10...v3.0.0-b11](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b10...v3.0.0-b11)
+
+### Features
+
+* **api:** binary response types ([5bdf3e3](https://github.com/cartesia-ai/cartesia-js-internal/commit/5bdf3e3be2867099b8187c186745a509991df91e))
+
+## 3.0.0-b10 (2026-01-20)
+
+Full Changelog: [v3.0.0-b9...v3.0.0-b10](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b9...v3.0.0-b10)
+
+### Features
+
+* **api:** voice changer response ([5ca129b](https://github.com/cartesia-ai/cartesia-js-internal/commit/5ca129b1dfa59043560c7866a2cdd87fb03b42bf))
+
+## 3.0.0-b9 (2026-01-16)
+
+Full Changelog: [v3.0.0-b8...v3.0.0-b9](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b8...v3.0.0-b9)
+
+### Features
+
+* refine backcompat layer with strict Node stream return types ([0fc86b8](https://github.com/cartesia-ai/cartesia-js-internal/commit/0fc86b840a7b94fa6017aa454225ef6ee3a31d5f))
+
 ## 3.0.0-b8 (2026-01-16)
 
 Full Changelog: [v3.0.0-b7...v3.0.0-b8](https://github.com/cartesia-ai/cartesia-js-internal/compare/v3.0.0-b7...v3.0.0-b8)

package/README.md

@@ -2,6 +2,8 @@
 
 [![NPM version](<https://img.shields.io/npm/v/@cartesia/cartesia-js.svg?label=npm%20(stable)>)](https://npmjs.org/package/@cartesia/cartesia-js) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/@cartesia/cartesia-js)
 
+> **Note:** This README is for the 3.x beta. For the stable 2.x series, see the [`branch-2.x`](https://github.com/cartesia-ai/cartesia-js/tree/branch-2.x) branch.
+
 This library provides convenient access to the Cartesia REST API from server-side TypeScript or JavaScript.
 
 The full API of this library can be found in [api.md](api.md).
@@ -23,13 +25,22 @@ The full API of this library can be found in [api.md](api.md).
 import Cartesia from '@cartesia/cartesia-js';
 
 const client = new Cartesia({
-  apiKey: 'My API Key',
+  token: 'My Token',
 });
 
-const page = await client.voices.list();
-const voice = page.data[0];
+const response = await client.tts.generate({
+  model_id: 'sonic-3',
+  output_format: {
+    container: 'wav',
+    encoding: 'pcm_f32le',
+    sample_rate: 44100,
+  },
+  transcript: "I have to say that I'd rather stay awake when I'm asleep.",
+  voice: { mode: 'id', id: 'e07c00bc-4134-4eae-9ea4-1a55fb45746b' },
+});
 
-console.log(voice.id);
+const content = await response.blob();
+console.log(content);
 ```
 
 ### Request & Response types
@@ -185,7 +196,7 @@ while (page.hasNextPage()) {
 
 ## Default Headers
 
-We automatically send the `cartesia-version` header set to `2025-04-16`.
+We automatically send the `cartesia-version` header set to `2025-11-04`.
 
 If you need to, you can override it by setting default headers on a per-request basis.
 
@@ -300,7 +311,7 @@ parameter. This library doesn't validate at runtime that the request matches the
 send will be sent as-is.
 
 ```ts
-client.voices.list({
+client.tts.generate({
   // ...
   // @ts-expect-error baz is not yet public
   baz: 'undocumented option',
@@ -410,7 +421,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](https://www.github.com/cartesia-ai/cartesia-js-internal/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/cartesia-ai/cartesia-js/issues) with questions, bugs, or suggestions.
 
 ## Requirements
 

package/backcompat/errors.d.mts

@@ -2,7 +2,7 @@
 export declare class CartesiaClientError extends Error {
     readonly statusCode?: number;
     readonly body?: unknown;
-    constructor({ message, statusCode, body, }: {
+    constructor({ message, statusCode, body }: {
         message?: string;
         statusCode?: number;
         body?: unknown;
@@ -12,5 +12,4 @@ export declare class CartesiaClientError extends Error {
 export declare class CartesiaTimeoutError extends Error {
     constructor(message: string);
 }
-export declare function wrap<T>(promise: Promise<T>): Promise<T>;
 //# sourceMappingURL=errors.d.mts.map

package/backcompat/errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,EACX,OAAO,EACP,UAAU,EACV,IAAI,GACJ,EAAE;QACF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;KACf;CAUD;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI3B;AAED,wBAAsB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB7D"}
+{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAUrG;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/backcompat/errors.d.ts

@@ -2,7 +2,7 @@
 export declare class CartesiaClientError extends Error {
     readonly statusCode?: number;
     readonly body?: unknown;
-    constructor({ message, statusCode, body, }: {
+    constructor({ message, statusCode, body }: {
         message?: string;
         statusCode?: number;
         body?: unknown;
@@ -12,5 +12,4 @@ export declare class CartesiaClientError extends Error {
 export declare class CartesiaTimeoutError extends Error {
     constructor(message: string);
 }
-export declare function wrap<T>(promise: Promise<T>): Promise<T>;
 //# sourceMappingURL=errors.d.ts.map

package/backcompat/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,EACX,OAAO,EACP,UAAU,EACV,IAAI,GACJ,EAAE;QACF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;KACf;CAUD;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI3B;AAED,wBAAsB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB7D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAUrG;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/backcompat/errors.js

@@ -1,11 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CartesiaTimeoutError = exports.CartesiaClientError = void 0;
-exports.wrap = wrap;
-const error_1 = require("../core/error.js");
 /** @deprecated Use {@link CartesiaError} or specialized error classes from core/error instead. */
 class CartesiaClientError extends Error {
-    constructor({ message, statusCode, body, }) {
+    constructor({ message, statusCode, body }) {
         super(message);
         Object.setPrototypeOf(this, CartesiaClientError.prototype);
         if (statusCode != null) {
@@ -25,22 +23,4 @@ class CartesiaTimeoutError extends Error {
     }
 }
 exports.CartesiaTimeoutError = CartesiaTimeoutError;
-async function wrap(promise) {
-    try {
-        return await promise;
-    }
-    catch (e) {
-        if (e instanceof error_1.APIConnectionTimeoutError) {
-            throw new CartesiaTimeoutError(e.message);
-        }
-        if (e instanceof error_1.APIError) {
-            throw new CartesiaClientError({
-                message: e.message,
-                statusCode: e.status,
-                body: e.error,
-            });
-        }
-        throw e;
-    }
-}
 //# sourceMappingURL=errors.js.map

package/backcompat/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":";;;AAmCA,oBAgBC;AAnDD,4CAAoE;AAEpE,kGAAkG;AAClG,MAAa,mBAAoB,SAAQ,KAAK;IAI7C,YAAY,EACX,OAAO,EACP,UAAU,EACV,IAAI,GAKJ;QACA,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,CAAC;IACF,CAAC;CACD;AAtBD,kDAsBC;AAED,iEAAiE;AACjE,MAAa,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACD;AALD,oDAKC;AAEM,KAAK,UAAU,IAAI,CAAI,OAAmB;IAChD,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC;IACtB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,iCAAyB,EAAE,CAAC;YAC5C,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,YAAY,gBAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,mBAAmB,CAAC;gBAC7B,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,CAAC,CAAC,MAAM;gBACpB,IAAI,EAAE,CAAC,CAAC,KAAK;aACb,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,CAAC;IACT,CAAC;AACF,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":";;;AAAA,kGAAkG;AAClG,MAAa,mBAAoB,SAAQ,KAAK;IAI5C,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAA6D;QAClG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC/B,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAdD,kDAcC;AAED,iEAAiE;AACjE,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AALD,oDAKC"}

package/backcompat/errors.mjs

@@ -1,7 +1,6 @@
-import { APIConnectionTimeoutError, APIError } from "../core/error.mjs";
 /** @deprecated Use {@link CartesiaError} or specialized error classes from core/error instead. */
 export class CartesiaClientError extends Error {
-    constructor({ message, statusCode, body, }) {
+    constructor({ message, statusCode, body }) {
         super(message);
         Object.setPrototypeOf(this, CartesiaClientError.prototype);
         if (statusCode != null) {
@@ -19,22 +18,4 @@ export class CartesiaTimeoutError extends Error {
         Object.setPrototypeOf(this, CartesiaTimeoutError.prototype);
     }
 }
-export async function wrap(promise) {
-    try {
-        return await promise;
-    }
-    catch (e) {
-        if (e instanceof APIConnectionTimeoutError) {
-            throw new CartesiaTimeoutError(e.message);
-        }
-        if (e instanceof APIError) {
-            throw new CartesiaClientError({
-                message: e.message,
-                statusCode: e.status,
-                body: e.error,
-            });
-        }
-        throw e;
-    }
-}
 //# sourceMappingURL=errors.mjs.map

package/backcompat/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":"OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE;AAE9C,kGAAkG;AAClG,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAI7C,YAAY,EACX,OAAO,EACP,UAAU,EACV,IAAI,GAKJ;QACA,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,CAAC;IACF,CAAC;CACD;AAED,iEAAiE;AACjE,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACD;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAI,OAAmB;IAChD,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC;IACtB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,yBAAyB,EAAE,CAAC;YAC5C,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,mBAAmB,CAAC;gBAC7B,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,CAAC,CAAC,MAAM;gBACpB,IAAI,EAAE,CAAC,CAAC,KAAK;aACb,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,CAAC;IACT,CAAC;AACF,CAAC"}
+{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../src/backcompat/errors.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAI5C,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAA6D;QAClG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC/B,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/backcompat/index.d.mts

@@ -19,4 +19,5 @@ export * from "./voices-wrapper.mjs";
 export * from "./voice-changer-wrapper.mjs";
 export * from "./types.mjs";
 export * from "./errors.mjs";
+export * from "./utils.mjs";
 //# sourceMappingURL=index.d.mts.map

package/backcompat/index.d.mts.map

@@ -1 +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;AAErC;;;;GAIG;AACH,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"}
+{"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;OAEvB,KAAK,EAAE,qBAAqB,EAAY;AAuC/C;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAW;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;gBAE7B,OAAO,GAAE,qBAA0B;CAuBhD"}

package/backcompat/index.d.ts

@@ -19,4 +19,5 @@ export * from "./voices-wrapper.js";
 export * from "./voice-changer-wrapper.js";
 export * from "./types.js";
 export * from "./errors.js";
+export * from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

package/backcompat/index.d.ts.map

@@ -1 +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;AAErC;;;;GAIG;AACH,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"}
+{"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;OAEvB,KAAK,EAAE,qBAAqB,EAAY;AAuC/C;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAW;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;gBAE7B,OAAO,GAAE,qBAA0B;CAuBhD"}

package/backcompat/index.js

@@ -6,6 +6,38 @@ 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");
+const headers_1 = require("../internal/headers.js");
+async function resolveSupplier(supplier) {
+    if (typeof supplier === 'function') {
+        return supplier();
+    }
+    return supplier;
+}
+class DynamicCartesia extends client_1.Cartesia {
+    constructor(options) {
+        super(options);
+        this.apiKeySupplier = options.apiKeySupplier;
+    }
+    validateHeaders(_headers) {
+        // Skip validation if we have a dynamic API key supplier
+        // The key will be resolved and added in authHeaders
+        if (this.apiKeySupplier) {
+            return;
+        }
+        super.validateHeaders(_headers);
+    }
+    async authHeaders(opts) {
+        // If we have a dynamic supplier, resolve it and return the auth header
+        if (this.apiKeySupplier) {
+            const key = await resolveSupplier(this.apiKeySupplier);
+            if (key) {
+                return (0, headers_1.buildHeaders)([{ Authorization: `Bearer ${key}` }]);
+            }
+        }
+        // Otherwise, fall back to default behavior
+        return super.authHeaders(opts);
+    }
+}
 /**
  * @deprecated Use the {@link Cartesia} class directly instead.
  *
@@ -14,8 +46,14 @@ const voice_changer_wrapper_1 = require("./voice-changer-wrapper.js");
 class CartesiaClient {
     constructor(options = {}) {
         const newOptions = {};
+        let apiKeySupplier;
         if (options.apiKey) {
-            newOptions.apiKey = options.apiKey;
+            if (typeof options.apiKey === 'function') {
+                apiKeySupplier = options.apiKey;
+            }
+            else {
+                newOptions.apiKey = options.apiKey;
+            }
         }
         if (options.baseUrl) {
             newOptions.baseURL = options.baseUrl;
@@ -23,7 +61,7 @@ class CartesiaClient {
         else if (options.environment) {
             newOptions.baseURL = options.environment;
         }
-        this.client = new client_1.Cartesia(newOptions);
+        this.client = new DynamicCartesia({ ...newOptions, apiKeySupplier });
         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);
@@ -35,4 +73,5 @@ tslib_1.__exportStar(require("./voices-wrapper.js"), exports);
 tslib_1.__exportStar(require("./voice-changer-wrapper.js"), exports);
 tslib_1.__exportStar(require("./types.js"), exports);
 tslib_1.__exportStar(require("./errors.js"), exports);
+tslib_1.__exportStar(require("./utils.js"), exports);
 //# sourceMappingURL=index.js.map

package/backcompat/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/backcompat/index.ts"],"names":[],"mappings":";;;;AAAA,yCAAyD;AACzD,kDAA2C;AAC3C,wDAAiD;AACjD,sEAA8D;AAG9D;;;;GAIG;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;AACxB,sDAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/backcompat/index.ts"],"names":[],"mappings":";;;;AAAA,yCAAyD;AACzD,kDAA2C;AAC3C,wDAAiD;AACjD,sEAA8D;AAC9D,oDAAyE;AAGzE,KAAK,UAAU,eAAe,CAAI,QAAqB;IACrD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAQ,QAAiC,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,eAAgB,SAAQ,iBAAQ;IAGpC,YAAY,OAA0E;QACpF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAEkB,eAAe,CAAC,QAAyB;QAC1D,wDAAwD;QACxD,oDAAoD;QACpD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEkB,KAAK,CAAC,WAAW,CAAC,IAAS;QAC5C,uEAAuE;QACvE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACvD,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,IAAA,sBAAY,EAAC,CAAC,EAAE,aAAa,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,2CAA2C;QAC3C,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAa,cAAc;IAMzB,YAAY,UAAiC,EAAE;QAC7C,MAAM,UAAU,GAAkB,EAAE,CAAC;QACrC,IAAI,cAAwD,CAAC;QAE7D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACzC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAgB,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,OAAiB,CAAC;QACjD,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/B,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,WAAqB,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;QACrE,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;IAC3D,CAAC;CACF;AA7BD,wCA6BC;AAED,2DAA8B;AAC9B,8DAAiC;AACjC,qEAAwC;AACxC,qDAAwB;AACxB,sDAAyB;AACzB,qDAAwB"}

package/backcompat/index.mjs

@@ -2,6 +2,38 @@ import { Cartesia } from "../client.mjs";
 import { TTSWrapper } from "./tts-wrapper.mjs";
 import { VoicesWrapper } from "./voices-wrapper.mjs";
 import { VoiceChangerWrapper } from "./voice-changer-wrapper.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+async function resolveSupplier(supplier) {
+    if (typeof supplier === 'function') {
+        return supplier();
+    }
+    return supplier;
+}
+class DynamicCartesia extends Cartesia {
+    constructor(options) {
+        super(options);
+        this.apiKeySupplier = options.apiKeySupplier;
+    }
+    validateHeaders(_headers) {
+        // Skip validation if we have a dynamic API key supplier
+        // The key will be resolved and added in authHeaders
+        if (this.apiKeySupplier) {
+            return;
+        }
+        super.validateHeaders(_headers);
+    }
+    async authHeaders(opts) {
+        // If we have a dynamic supplier, resolve it and return the auth header
+        if (this.apiKeySupplier) {
+            const key = await resolveSupplier(this.apiKeySupplier);
+            if (key) {
+                return buildHeaders([{ Authorization: `Bearer ${key}` }]);
+            }
+        }
+        // Otherwise, fall back to default behavior
+        return super.authHeaders(opts);
+    }
+}
 /**
  * @deprecated Use the {@link Cartesia} class directly instead.
  *
@@ -10,8 +42,14 @@ import { VoiceChangerWrapper } from "./voice-changer-wrapper.mjs";
 export class CartesiaClient {
     constructor(options = {}) {
         const newOptions = {};
+        let apiKeySupplier;
         if (options.apiKey) {
-            newOptions.apiKey = options.apiKey;
+            if (typeof options.apiKey === 'function') {
+                apiKeySupplier = options.apiKey;
+            }
+            else {
+                newOptions.apiKey = options.apiKey;
+            }
         }
         if (options.baseUrl) {
             newOptions.baseURL = options.baseUrl;
@@ -19,7 +57,7 @@ export class CartesiaClient {
         else if (options.environment) {
             newOptions.baseURL = options.environment;
         }
-        this.client = new Cartesia(newOptions);
+        this.client = new DynamicCartesia({ ...newOptions, apiKeySupplier });
         this.tts = new TTSWrapper(this.client);
         this.voices = new VoicesWrapper(this.client);
         this.voiceChanger = new VoiceChangerWrapper(this.client);
@@ -30,4 +68,5 @@ export * from "./voices-wrapper.mjs";
 export * from "./voice-changer-wrapper.mjs";
 export * from "./types.mjs";
 export * from "./errors.mjs";
+export * from "./utils.mjs";
 //# sourceMappingURL=index.mjs.map

package/backcompat/index.mjs.map

@@ -1 +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;;;;GAIG;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"}
+{"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;OACvB,EAAE,YAAY,EAAwB;AAG7C,KAAK,UAAU,eAAe,CAAI,QAAqB;IACrD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAQ,QAAiC,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,eAAgB,SAAQ,QAAQ;IAGpC,YAAY,OAA0E;QACpF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAEkB,eAAe,CAAC,QAAyB;QAC1D,wDAAwD;QACxD,oDAAoD;QACpD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEkB,KAAK,CAAC,WAAW,CAAC,IAAS;QAC5C,uEAAuE;QACvE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACvD,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,2CAA2C;QAC3C,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAMzB,YAAY,UAAiC,EAAE;QAC7C,MAAM,UAAU,GAAkB,EAAE,CAAC;QACrC,IAAI,cAAwD,CAAC;QAE7D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACzC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAgB,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,OAAiB,CAAC;QACjD,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/B,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,WAAqB,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;QACrE,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;IAC3D,CAAC;CACF"}

package/backcompat/tts-wrapper.d.mts

@@ -1,15 +1,16 @@
 import { Cartesia } from "../client.mjs";
 import { BackCompatRequestOptions } from "./types.mjs";
+import { Readable } from 'stream';
 export interface BackCompatWebSocketOptions {
-    container?: "raw" | "wav" | "mp3";
-    encoding?: "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
+    container?: 'raw' | 'wav' | 'mp3';
+    encoding?: 'pcm_f32le' | 'pcm_s16le' | 'pcm_alaw' | 'pcm_mulaw';
     sampleRate: number;
 }
 export type BackCompatTtsRequestVoiceSpecifier = {
-    mode: "id";
+    mode: 'id';
     id: string;
 } | {
-    mode: "embedding";
+    mode: 'embedding';
     embedding: number[];
 };
 export interface BackCompatGenerationConfig {
@@ -23,8 +24,8 @@ export interface BackCompatWebSocketTtsRequest {
     voice: BackCompatTtsRequestVoiceSpecifier;
     generationConfig?: BackCompatGenerationConfig;
     outputFormat?: {
-        container?: "raw" | "wav" | "mp3";
-        encoding?: "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
+        container?: 'raw' | 'wav' | 'mp3';
+        encoding?: 'pcm_f32le' | 'pcm_s16le' | 'pcm_alaw' | 'pcm_mulaw';
         sampleRate?: number;
         bitRate?: number;
     };
@@ -34,6 +35,22 @@ export interface BackCompatWebSocketTtsRequest {
     addTimestamps?: boolean;
     addPhonemeTimestamps?: boolean;
 }
+export interface BackCompatTtsRequest {
+    modelId: string;
+    transcript: string;
+    voice: BackCompatTtsRequestVoiceSpecifier;
+    language?: string;
+    outputFormat: {
+        container: 'raw' | 'wav' | 'mp3';
+        encoding?: 'pcm_f32le' | 'pcm_s16le' | 'pcm_alaw' | 'pcm_mulaw';
+        sampleRate: number;
+        bitRate?: number;
+    };
+    generationConfig?: BackCompatGenerationConfig;
+    duration?: number;
+    speed?: 'slow' | 'normal' | 'fast';
+    pronunciationDictId?: string;
+}
 declare class AudioSource {
     private buffers;
     private waiter;
@@ -56,14 +73,37 @@ export declare class WebSocketWrapper {
     }>;
     disconnect(): void;
 }
+export interface BackCompatTtsGenerateOptions {
+    modelId?: string;
+    outputFormat?: {
+        container: 'raw' | 'wav' | 'mp3';
+        encoding?: 'pcm_f32le' | 'pcm_s16le' | 'pcm_alaw' | 'pcm_mulaw';
+        sampleRate: number;
+        bitRate?: number;
+    };
+    language?: string;
+    generationConfig?: BackCompatGenerationConfig;
+    speed?: 'slow' | 'normal' | 'fast';
+    pronunciationDictId?: string;
+}
 /** @deprecated Use the new SDK's tts methods on the {@link Cartesia} instance instead. */
 export declare class TTSWrapper {
     private client;
     constructor(client: Cartesia);
     /** @deprecated Use {@link Cartesia.tts.websocket} instead. */
     websocket(config: BackCompatWebSocketOptions): WebSocketWrapper;
-    /** @deprecated Use {@link Cartesia.tts.synthesizeBytes} instead. */
-    bytes(request: any, requestOptions?: BackCompatRequestOptions): Promise<unknown>;
+    /**
+     * Generate speech from text.
+     * @param transcript The text to convert to speech
+     * @param voiceId The voice ID to use
+     * @param options Generation options
+     * @param signal Optional abort signal
+     * @param _source Optional source identifier (e.g., "playground_tts") - for tracking purposes
+     * @deprecated Use {@link Cartesia.tts.generate} instead.
+     */
+    generate(transcript: string, voiceId: string, options?: BackCompatTtsGenerateOptions, signal?: AbortSignal, _source?: string): Promise<Readable>;
+    /** @deprecated Use {@link Cartesia.tts.generate} instead. */
+    bytes(request: BackCompatTtsRequest, requestOptions?: BackCompatRequestOptions): Promise<Readable>;
 }
 export {};
 //# sourceMappingURL=tts-wrapper.d.mts.map

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

@@ -1 +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;AAInC,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,0FAA0F;AAC1F,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAW;gBAEb,MAAM,EAAE,QAAQ;IAI5B,8DAA8D;IAC9D,SAAS,CAAC,MAAM,EAAE,0BAA0B;IAI5C,oEAAoE;IAC9D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,wBAAwB;CAmCnE"}
+{"version":3,"file":"tts-wrapper.d.mts","sourceRoot":"","sources":["../src/backcompat/tts-wrapper.ts"],"names":[],"mappings":"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"}