@cartesia/cartesia-js 1.0.2 → 1.1.0

package/.turbo/turbo-build.log

@@ -5,49 +5,49 @@ $ tsup src/ --format cjs,esm --dts
 CLI Target: es6
 CJS Build start
 ESM Build start
-CJS dist/types/index.cjs   764.00 B
-CJS dist/voices/index.cjs  5.36 KB
-CJS dist/index.cjs         24.67 KB
-CJS dist/lib/client.cjs    4.07 KB
-CJS dist/lib/constants.cjs 1.43 KB
-CJS dist/lib/index.cjs     20.57 KB
-CJS dist/react/index.cjs   32.23 KB
-CJS dist/react/utils.cjs   1.80 KB
-CJS dist/tts/index.cjs     18.92 KB
-CJS dist/tts/player.cjs    6.96 KB
-CJS dist/tts/source.cjs    8.15 KB
-CJS dist/tts/utils.cjs     4.33 KB
-CJS dist/tts/websocket.cjs 18.61 KB
-CJS ⚡️ Build success in 75ms
 ESM dist/index.js          499.00 B
-ESM dist/lib/constants.js  183.00 B
 ESM dist/chunk-FXPGR372.js 0 B
-ESM dist/react/index.js    7.62 KB
+ESM dist/lib/client.js     132.00 B
+ESM dist/react/index.js    7.73 KB
 ESM dist/tts/index.js      261.00 B
+ESM dist/lib/constants.js  183.00 B
 ESM dist/lib/index.js      322.00 B
-ESM dist/chunk-NVOCUUOF.js 353.00 B
-ESM dist/chunk-UCYL2SOX.js 1.48 KB
+ESM dist/chunk-4GEDAGVY.js 353.00 B
 ESM dist/react/utils.js    109.00 B
-ESM dist/chunk-NQVZNVOU.js 337.00 B
-ESM dist/chunk-EDAAHENY.js 439.00 B
-ESM dist/chunk-IZBPLCGW.js 7.13 KB
-ESM dist/chunk-PISCPZK4.js 1.02 KB
+ESM dist/chunk-CWIJUBG6.js 1.95 KB
+ESM dist/chunk-3FL2SNIR.js 337.00 B
+ESM dist/chunk-MUPVAEL7.js 439.00 B
+ESM dist/chunk-L3OMQKWL.js 7.95 KB
+ESM dist/chunk-6PWLZAMS.js 1.02 KB
 ESM dist/chunk-2BFEKY3F.js 366.00 B
 ESM dist/tts/player.js     174.00 B
-ESM dist/chunk-LZO6K34D.js 3.76 KB
-ESM dist/chunk-BHY7MNGT.js 2.11 KB
-ESM dist/chunk-6YQ6KDIQ.js 5.32 KB
-ESM dist/chunk-GHY2WEOK.js 2.70 KB
+ESM dist/chunk-MNOPO7G6.js 3.76 KB
+ESM dist/chunk-VVDJR3OA.js 6.20 KB
+ESM dist/chunk-VCZESWYA.js 2.11 KB
+ESM dist/chunk-WIFMLPT5.js 2.27 KB
+ESM dist/types/index.js    31.00 B
+ESM dist/voices/index.js   174.00 B
 ESM dist/tts/source.js     144.00 B
 ESM dist/tts/utils.js      426.00 B
 ESM dist/tts/websocket.js  242.00 B
-ESM dist/types/index.js    31.00 B
-ESM dist/voices/index.js   174.00 B
-ESM dist/lib/client.js     132.00 B
-ESM ⚡️ Build success in 77ms
+ESM ⚡️ Build success in 134ms
+CJS dist/index.cjs         26.45 KB
+CJS dist/lib/client.cjs    4.07 KB
+CJS dist/lib/constants.cjs 1.43 KB
+CJS dist/lib/index.cjs     22.35 KB
+CJS dist/react/index.cjs   34.12 KB
+CJS dist/tts/index.cjs     20.23 KB
+CJS dist/tts/player.cjs    6.96 KB
+CJS dist/react/utils.cjs   1.80 KB
+CJS dist/tts/utils.cjs     4.33 KB
+CJS dist/tts/source.cjs    9.03 KB
+CJS dist/types/index.cjs   764.00 B
+CJS dist/tts/websocket.cjs 19.92 KB
+CJS dist/voices/index.cjs  5.83 KB
+CJS ⚡️ Build success in 142ms
 DTS Build start
-DTS ⚡️ Build success in 8516ms
-DTS dist/index.d.cts         817.00 B
+DTS ⚡️ Build success in 7238ms
+DTS dist/index.d.cts         928.00 B
 DTS dist/lib/constants.d.cts 564.00 B
 DTS dist/lib/index.d.cts     410.00 B
 DTS dist/react/index.d.cts   1.09 KB
@@ -55,12 +55,12 @@ $ tsup src/ --format cjs,esm --dts
 DTS dist/tts/index.d.cts     471.00 B
 DTS dist/tts/player.d.cts    1.20 KB
 DTS dist/tts/utils.d.cts     2.68 KB
-DTS dist/tts/websocket.d.cts 2.94 KB
-DTS dist/tts/source.d.cts    2.55 KB
-DTS dist/voices/index.d.cts  472.00 B
+DTS dist/tts/websocket.d.cts 3.21 KB
+DTS dist/tts/source.d.cts    2.86 KB
+DTS dist/voices/index.d.cts  675.00 B
 DTS dist/lib/client.d.cts    293.00 B
-DTS dist/types/index.d.cts   3.25 KB
-DTS dist/index.d.ts          809.00 B
+DTS dist/types/index.d.cts   3.96 KB
+DTS dist/index.d.ts          920.00 B
 DTS dist/lib/constants.d.ts  564.00 B
 DTS dist/lib/index.d.ts      404.00 B
 DTS dist/react/index.d.ts    1.09 KB
@@ -68,8 +68,8 @@ $ tsup src/ --format cjs,esm --dts
 DTS dist/tts/index.d.ts      467.00 B
 DTS dist/tts/player.d.ts     1.20 KB
 DTS dist/tts/utils.d.ts      2.68 KB
-DTS dist/tts/websocket.d.ts  2.94 KB
-DTS dist/tts/source.d.ts     2.55 KB
-DTS dist/voices/index.d.ts   470.00 B
+DTS dist/tts/websocket.d.ts  3.20 KB
+DTS dist/tts/source.d.ts     2.86 KB
+DTS dist/voices/index.d.ts   673.00 B
 DTS dist/lib/client.d.ts     292.00 B
-DTS dist/types/index.d.ts    3.25 KB
+DTS dist/types/index.d.ts    3.96 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @cartesia/cartesia-js
 
+## 1.1.0
+
+### Minor Changes
+
+- ed6be65: Add WebSocket continue method for input streaming with contexts
+
+## 1.0.3
+
+### Patch Changes
+
+- 9b157d6: Support Bun by adding socket binaryType
+
 ## 1.0.2
 
 ### Patch Changes

package/README.md

@@ -1,7 +1,7 @@
 # Cartesia JavaScript Client
 
 ![NPM Version](https://img.shields.io/npm/v/%40cartesia%2Fcartesia-js?logo=npm)
-[![Discord](https://badgen.net/badge/black/Cartesia/icon?icon=discord&label)](https://discord.gg/ZVxavqHB9X)
+[![Discord](https://badgen.net/badge/black/Cartesia/icon?icon=discord&label)](https://discord.gg/cartesia)
 
 This client provides convenient access to [Cartesia's TTS models](https://cartesia.ai/). Sonic is the fastest text-to-speech model around—it can generate a second of audio in just 650ms, and it can stream out the first audio chunk in just 135ms. Alongside Sonic, we also offer an extensive prebuilt voice library for a variety of use cases.
 
@@ -52,6 +52,24 @@ console.log(voices);
 const voice = await cartesia.voices.get("<voice-id>");
 console.log(voice);
 
+// Clone a voice from a file.
+const clonedVoiceEmbedding = await cartesia.voices.clone({
+	mode: "clip",
+	clip: myFile, // Pass a File object or a Blob.
+});
+
+// Mix voices together.
+const mixedVoiceEmbedding = await cartesia.voices.mix({
+	voices: [{ id: "<voice-id-1>", weight: 0.6 }, { id: "<voice-id-2>", weight: 0.4 }],
+});
+
+// Localize a voice.
+const localizedVoiceEmbedding = await cartesia.voices.localize({
+	embedding: Array(192).fill(1.0),
+	original_speaker_gender: "female",
+	language: "es",
+});
+
 // Create a voice.
 const newVoice = await cartesia.voices.create({
 	name: "Tim",
@@ -59,12 +77,6 @@ const newVoice = await cartesia.voices.create({
 	embedding: Array(192).fill(1.0),
 });
 console.log(newVoice);
-
-// Clone a voice from a file.
-const clonedVoice = await cartesia.voices.clone({
-	mode: "clip",
-	clip: myFile, // Pass a File object or a Blob.
-});
 ```
 
 ### TTS over WebSocket
@@ -115,9 +127,31 @@ for await (const message of response.events('message')) {
 
 #### Input Streaming with Contexts
 
-You can perform input streaming with contexts as described in the [docs](https://docs.cartesia.ai/api-reference/endpoints/stream-speech-websocket#input-streaming-with-contexts). The WebSocket's `send` method is just a wrapper around sending a message on the WebSocket, so the request format specified the docs can be used directly.
+```js
+const contextOptions = {
+	context_id: "my-context",
+	model_id: "sonic-english",
+	voice: {
+		mode: "id",
+		id: "a0e99841-438c-4a64-b679-ae501e7d6091",
+	},
+}
+
+// Initial request on the context uses websocket.send().
+// This response object will aggregate the results of all the inputs sent on the context.
+const response = await websocket.send({
+	...contextOptions,
+	transcript: "Hello, world!",
+});
+
+// Subsequent requests on the same context use websocket.continue().
+await websocket.continue({
+	...contextOptions,
+	transcript: " How are you today?",
+});
+```
 
-You should use the return from the first `send` call on a context to receive outputs and events for the entire context. You can ignore the return values of subsequent `send` calls.
+See the [input streaming docs](https://docs.cartesia.ai/reference/web-socket/stream-speech/working-with-web-sockets#input-streaming-with-contexts) for more information.
 
 #### Timestamps
 

package/dist/{chunk-NQVZNVOU.js → chunk-3FL2SNIR.js}

@@ -1,6 +1,6 @@
 import {
   __async
-} from "./chunk-GHY2WEOK.js";
+} from "./chunk-WIFMLPT5.js";
 
 // src/react/utils.ts
 function pingServer(url) {

package/dist/{chunk-NVOCUUOF.js → chunk-4GEDAGVY.js}

@@ -1,12 +1,12 @@
 import {
   Voices
-} from "./chunk-UCYL2SOX.js";
+} from "./chunk-CWIJUBG6.js";
 import {
   TTS
-} from "./chunk-EDAAHENY.js";
+} from "./chunk-MUPVAEL7.js";
 import {
   Client
-} from "./chunk-PISCPZK4.js";
+} from "./chunk-6PWLZAMS.js";
 
 // src/lib/index.ts
 var Cartesia = class extends Client {

package/dist/{chunk-PISCPZK4.js → chunk-6PWLZAMS.js}

@@ -7,7 +7,7 @@ import {
   __async,
   __spreadProps,
   __spreadValues
-} from "./chunk-GHY2WEOK.js";
+} from "./chunk-WIFMLPT5.js";
 
 // src/lib/client.ts
 import fetch from "cross-fetch";

package/dist/{chunk-UCYL2SOX.js → chunk-CWIJUBG6.js}

@@ -1,9 +1,9 @@
 import {
   Client
-} from "./chunk-PISCPZK4.js";
+} from "./chunk-6PWLZAMS.js";
 import {
   __async
-} from "./chunk-GHY2WEOK.js";
+} from "./chunk-WIFMLPT5.js";
 
 // src/voices/index.ts
 var Voices = class extends Client {
@@ -54,6 +54,24 @@ var Voices = class extends Client {
       throw new Error("Invalid mode for clone()");
     });
   }
+  mix(options) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch("/voices/mix", {
+        method: "POST",
+        body: JSON.stringify(options)
+      });
+      return response.json();
+    });
+  }
+  localize(options) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch("/voices/localize", {
+        method: "POST",
+        body: JSON.stringify(options)
+      });
+      return response.json();
+    });
+  }
 };
 
 export {

package/dist/{chunk-IZBPLCGW.js → chunk-L3OMQKWL.js}

@@ -1,6 +1,6 @@
 import {
   Client
-} from "./chunk-PISCPZK4.js";
+} from "./chunk-6PWLZAMS.js";
 import {
   CARTESIA_VERSION,
   constructApiUrl
@@ -10,20 +10,19 @@ import {
   createMessageHandlerForContextId,
   getEmitteryCallbacks,
   isSentinel
-} from "./chunk-BHY7MNGT.js";
+} from "./chunk-VCZESWYA.js";
 import {
   Source
-} from "./chunk-6YQ6KDIQ.js";
+} from "./chunk-VVDJR3OA.js";
 import {
   __async,
-  __objRest,
   __privateAdd,
   __privateGet,
   __privateMethod,
   __privateSet,
   __spreadProps,
   __spreadValues
-} from "./chunk-GHY2WEOK.js";
+} from "./chunk-WIFMLPT5.js";
 
 // src/tts/websocket.ts
 import Emittery from "emittery";
@@ -58,7 +57,7 @@ var WebSocket = class extends Client {
   /**
    * Send a message over the WebSocket to start a stream.
    *
-   * @param inputs - Stream options. Defined in the StreamRequest type.
+   * @param inputs - Generation parameters. Defined in the StreamRequest type.
    * @param options - Options for the stream.
    * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
    *                          If set to `0`, the stream will not time out.
@@ -66,9 +65,8 @@ var WebSocket = class extends Client {
    * @returns An Emittery instance that emits messages from the WebSocket.
    * @returns An abort function that can be called to cancel the stream.
    */
-  send(_a, { timeout = 0 } = {}) {
-    var inputs = __objRest(_a, []);
-    var _a2, _b, _c, _d;
+  send(inputs, { timeout = 0 } = {}) {
+    var _a, _b, _c, _d;
     if (!__privateGet(this, _isConnected)) {
       throw new Error("Not connected to WebSocket. Call .connect() first.");
     }
@@ -82,7 +80,7 @@ var WebSocket = class extends Client {
         sample_rate: __privateGet(this, _sampleRate)
       };
     }
-    (_a2 = this.socket) == null ? void 0 : _a2.send(
+    (_a = this.socket) == null ? void 0 : _a.send(
       JSON.stringify(__spreadValues({}, inputs))
     );
     const emitter = new Emittery();
@@ -152,6 +150,32 @@ var WebSocket = class extends Client {
       stop: streamCompleteController.abort.bind(streamCompleteController)
     });
   }
+  /**
+   * Continue a stream.
+   *
+   * @param inputs - Generation parameters. Defined in the StreamRequest type, but must include a `context_id` field. `continue` is set to true by default.
+   */
+  continue(inputs) {
+    var _a;
+    if (!__privateGet(this, _isConnected)) {
+      throw new Error("Not connected to WebSocket. Call .connect() first.");
+    }
+    if (!inputs.context_id) {
+      throw new Error("context_id is required to continue a context.");
+    }
+    if (!inputs.output_format) {
+      inputs.output_format = {
+        container: __privateGet(this, _container),
+        encoding: __privateGet(this, _encoding),
+        sample_rate: __privateGet(this, _sampleRate)
+      };
+    }
+    (_a = this.socket) == null ? void 0 : _a.send(
+      JSON.stringify(__spreadValues({
+        continue: true
+      }, inputs))
+    );
+  }
   /**
    * Authenticate and connect to a Cartesia streaming WebSocket.
    *
@@ -169,6 +193,7 @@ var WebSocket = class extends Client {
         url.searchParams.set("cartesia_version", CARTESIA_VERSION);
         return url.toString();
       }));
+      this.socket.binaryType = "arraybuffer";
       this.socket.onopen = () => {
         __privateSet(this, _isConnected, true);
         emitter.emit("open");

package/dist/{chunk-LZO6K34D.js → chunk-MNOPO7G6.js}

@@ -1,13 +1,13 @@
 import {
   playAudioBuffer
-} from "./chunk-BHY7MNGT.js";
+} from "./chunk-VCZESWYA.js";
 import {
   __async,
   __privateAdd,
   __privateGet,
   __privateMethod,
   __privateSet
-} from "./chunk-GHY2WEOK.js";
+} from "./chunk-WIFMLPT5.js";
 
 // src/tts/player.ts
 var _context, _startNextPlaybackAt, _bufferDuration, _playBuffer, playBuffer_fn;

package/dist/{chunk-EDAAHENY.js → chunk-MUPVAEL7.js}

@@ -1,9 +1,9 @@
 import {
   WebSocket
-} from "./chunk-IZBPLCGW.js";
+} from "./chunk-L3OMQKWL.js";
 import {
   Client
-} from "./chunk-PISCPZK4.js";
+} from "./chunk-6PWLZAMS.js";
 
 // src/tts/index.ts
 var TTS = class extends Client {

package/dist/{chunk-BHY7MNGT.js → chunk-VCZESWYA.js}

@@ -1,6 +1,6 @@
 import {
   ENCODING_MAP
-} from "./chunk-6YQ6KDIQ.js";
+} from "./chunk-VVDJR3OA.js";
 
 // src/tts/utils.ts
 import base64 from "base64-js";

package/dist/{chunk-6YQ6KDIQ.js → chunk-VVDJR3OA.js}

@@ -4,7 +4,7 @@ import {
   __privateGet,
   __privateMethod,
   __privateSet
-} from "./chunk-GHY2WEOK.js";
+} from "./chunk-WIFMLPT5.js";
 
 // src/tts/source.ts
 import Emittery from "emittery";
@@ -106,6 +106,37 @@ var Source = class {
       return read;
     });
   }
+  /**
+   * Seek in the buffer.
+   *
+   * @param offset The offset to seek to.
+   * @param whence The position to seek from.
+   * @returns The new position in the buffer.
+   * @throws {Error} If the seek is invalid.
+   */
+  seek(offset, whence) {
+    return __async(this, null, function* () {
+      let position = __privateGet(this, _readIndex);
+      switch (whence) {
+        case "start":
+          position = offset;
+          break;
+        case "current":
+          position += offset;
+          break;
+        case "end":
+          position = __privateGet(this, _writeIndex) + offset;
+          break;
+        default:
+          throw new Error(`Invalid seek mode: ${whence}`);
+      }
+      if (position < 0 || position > __privateGet(this, _writeIndex)) {
+        throw new Error("Seek out of bounds");
+      }
+      __privateSet(this, _readIndex, position);
+      return position;
+    });
+  }
   /**
    * Get the number of samples in a given duration.
    *

package/dist/{chunk-GHY2WEOK.js → chunk-WIFMLPT5.js}

@@ -17,18 +17,6 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
 var __accessCheck = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
@@ -75,7 +63,6 @@ var __async = (__this, __arguments, generator) => {
 export {
   __spreadValues,
   __spreadProps,
-  __objRest,
   __privateGet,
   __privateAdd,
   __privateSet,

package/dist/index.cjs

@@ -22,18 +22,6 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -253,6 +241,37 @@ var Source = class {
       return read;
     });
   }
+  /**
+   * Seek in the buffer.
+   *
+   * @param offset The offset to seek to.
+   * @param whence The position to seek from.
+   * @returns The new position in the buffer.
+   * @throws {Error} If the seek is invalid.
+   */
+  seek(offset, whence) {
+    return __async(this, null, function* () {
+      let position = __privateGet(this, _readIndex);
+      switch (whence) {
+        case "start":
+          position = offset;
+          break;
+        case "current":
+          position += offset;
+          break;
+        case "end":
+          position = __privateGet(this, _writeIndex) + offset;
+          break;
+        default:
+          throw new Error(`Invalid seek mode: ${whence}`);
+      }
+      if (position < 0 || position > __privateGet(this, _writeIndex)) {
+        throw new Error("Seek out of bounds");
+      }
+      __privateSet(this, _readIndex, position);
+      return position;
+    });
+  }
   /**
    * Get the number of samples in a given duration.
    *
@@ -399,7 +418,7 @@ var WebSocket = class extends Client {
   /**
    * Send a message over the WebSocket to start a stream.
    *
-   * @param inputs - Stream options. Defined in the StreamRequest type.
+   * @param inputs - Generation parameters. Defined in the StreamRequest type.
    * @param options - Options for the stream.
    * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
    *                          If set to `0`, the stream will not time out.
@@ -407,9 +426,8 @@ var WebSocket = class extends Client {
    * @returns An Emittery instance that emits messages from the WebSocket.
    * @returns An abort function that can be called to cancel the stream.
    */
-  send(_a, { timeout = 0 } = {}) {
-    var inputs = __objRest(_a, []);
-    var _a2, _b, _c, _d;
+  send(inputs, { timeout = 0 } = {}) {
+    var _a, _b, _c, _d;
     if (!__privateGet(this, _isConnected)) {
       throw new Error("Not connected to WebSocket. Call .connect() first.");
     }
@@ -423,7 +441,7 @@ var WebSocket = class extends Client {
         sample_rate: __privateGet(this, _sampleRate2)
       };
     }
-    (_a2 = this.socket) == null ? void 0 : _a2.send(
+    (_a = this.socket) == null ? void 0 : _a.send(
       JSON.stringify(__spreadValues({}, inputs))
     );
     const emitter = new import_emittery2.default();
@@ -493,6 +511,32 @@ var WebSocket = class extends Client {
       stop: streamCompleteController.abort.bind(streamCompleteController)
     });
   }
+  /**
+   * Continue a stream.
+   *
+   * @param inputs - Generation parameters. Defined in the StreamRequest type, but must include a `context_id` field. `continue` is set to true by default.
+   */
+  continue(inputs) {
+    var _a;
+    if (!__privateGet(this, _isConnected)) {
+      throw new Error("Not connected to WebSocket. Call .connect() first.");
+    }
+    if (!inputs.context_id) {
+      throw new Error("context_id is required to continue a context.");
+    }
+    if (!inputs.output_format) {
+      inputs.output_format = {
+        container: __privateGet(this, _container2),
+        encoding: __privateGet(this, _encoding2),
+        sample_rate: __privateGet(this, _sampleRate2)
+      };
+    }
+    (_a = this.socket) == null ? void 0 : _a.send(
+      JSON.stringify(__spreadValues({
+        continue: true
+      }, inputs))
+    );
+  }
   /**
    * Authenticate and connect to a Cartesia streaming WebSocket.
    *
@@ -510,6 +554,7 @@ var WebSocket = class extends Client {
         url.searchParams.set("cartesia_version", CARTESIA_VERSION);
         return url.toString();
       }));
+      this.socket.binaryType = "arraybuffer";
       this.socket.onopen = () => {
         __privateSet(this, _isConnected, true);
         emitter.emit("open");
@@ -639,6 +684,24 @@ var Voices = class extends Client {
       throw new Error("Invalid mode for clone()");
     });
   }
+  mix(options) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch("/voices/mix", {
+        method: "POST",
+        body: JSON.stringify(options)
+      });
+      return response.json();
+    });
+  }
+  localize(options) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch("/voices/localize", {
+        method: "POST",
+        body: JSON.stringify(options)
+      });
+      return response.json();
+    });
+  }
 };
 
 // src/lib/index.ts

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 export { Cartesia, Cartesia as default } from './lib/index.cjs';
-export { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.cjs';
+export { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.cjs';
 export { default as WebPlayer } from './tts/player.cjs';
 export { default as Source } from './tts/source.cjs';
 export { default as WebSocket } from './tts/websocket.cjs';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Cartesia, Cartesia as default } from './lib/index.js';
-export { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.js';
+export { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.js';
 export { default as WebPlayer } from './tts/player.js';
 export { default as Source } from './tts/source.js';
 export { default as WebSocket } from './tts/websocket.js';