@cartesia/cartesia-js 1.0.2 → 1.1.0

package/dist/index.js

@@ -1,22 +1,22 @@
 import "./chunk-FXPGR372.js";
 import {
   Cartesia
-} from "./chunk-NVOCUUOF.js";
-import "./chunk-UCYL2SOX.js";
-import "./chunk-EDAAHENY.js";
+} from "./chunk-4GEDAGVY.js";
+import "./chunk-CWIJUBG6.js";
+import "./chunk-MUPVAEL7.js";
 import {
   WebSocket
-} from "./chunk-IZBPLCGW.js";
-import "./chunk-PISCPZK4.js";
+} from "./chunk-L3OMQKWL.js";
+import "./chunk-6PWLZAMS.js";
 import "./chunk-2BFEKY3F.js";
 import {
   Player
-} from "./chunk-LZO6K34D.js";
-import "./chunk-BHY7MNGT.js";
+} from "./chunk-MNOPO7G6.js";
+import "./chunk-VCZESWYA.js";
 import {
   Source
-} from "./chunk-6YQ6KDIQ.js";
-import "./chunk-GHY2WEOK.js";
+} from "./chunk-VVDJR3OA.js";
+import "./chunk-WIFMLPT5.js";
 export {
   Cartesia,
   Source,

package/dist/lib/client.js

@@ -1,8 +1,8 @@
 import {
   Client
-} from "../chunk-PISCPZK4.js";
+} from "../chunk-6PWLZAMS.js";
 import "../chunk-2BFEKY3F.js";
-import "../chunk-GHY2WEOK.js";
+import "../chunk-WIFMLPT5.js";
 export {
   Client
 };

package/dist/lib/constants.js

@@ -3,7 +3,7 @@ import {
   CARTESIA_VERSION,
   constructApiUrl
 } from "../chunk-2BFEKY3F.js";
-import "../chunk-GHY2WEOK.js";
+import "../chunk-WIFMLPT5.js";
 export {
   BASE_URL,
   CARTESIA_VERSION,

package/dist/lib/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 });
@@ -249,6 +237,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.
    *
@@ -382,7 +401,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.
@@ -390,9 +409,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.");
     }
@@ -406,7 +424,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();
@@ -476,6 +494,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.
    *
@@ -493,6 +537,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");
@@ -622,6 +667,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/lib/index.js

@@ -1,14 +1,14 @@
 import {
   Cartesia
-} from "../chunk-NVOCUUOF.js";
-import "../chunk-UCYL2SOX.js";
-import "../chunk-EDAAHENY.js";
-import "../chunk-IZBPLCGW.js";
-import "../chunk-PISCPZK4.js";
+} from "../chunk-4GEDAGVY.js";
+import "../chunk-CWIJUBG6.js";
+import "../chunk-MUPVAEL7.js";
+import "../chunk-L3OMQKWL.js";
+import "../chunk-6PWLZAMS.js";
 import "../chunk-2BFEKY3F.js";
-import "../chunk-BHY7MNGT.js";
-import "../chunk-6YQ6KDIQ.js";
-import "../chunk-GHY2WEOK.js";
+import "../chunk-VCZESWYA.js";
+import "../chunk-VVDJR3OA.js";
+import "../chunk-WIFMLPT5.js";
 export {
   Cartesia
 };

package/dist/react/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 });
@@ -250,6 +238,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.
    *
@@ -396,7 +415,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.
@@ -404,9 +423,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.");
     }
@@ -420,7 +438,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();
@@ -490,6 +508,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.
    *
@@ -507,6 +551,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");
@@ -636,6 +681,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
@@ -932,6 +995,9 @@ function useTTS({
       if (player.current) {
         yield player.current.stop();
       }
+      if (playbackStatus === "finished") {
+        websocketReturn.current.source.seek(0, "start");
+      }
       setPlaybackStatus("playing");
       const unsubscribes = [];
       unsubscribes.push(

package/dist/react/index.js

@@ -1,22 +1,22 @@
 import {
   Cartesia
-} from "../chunk-NVOCUUOF.js";
-import "../chunk-UCYL2SOX.js";
+} from "../chunk-4GEDAGVY.js";
+import "../chunk-CWIJUBG6.js";
 import {
   pingServer
-} from "../chunk-NQVZNVOU.js";
-import "../chunk-EDAAHENY.js";
-import "../chunk-IZBPLCGW.js";
-import "../chunk-PISCPZK4.js";
+} from "../chunk-3FL2SNIR.js";
+import "../chunk-MUPVAEL7.js";
+import "../chunk-L3OMQKWL.js";
+import "../chunk-6PWLZAMS.js";
 import "../chunk-2BFEKY3F.js";
 import {
   Player
-} from "../chunk-LZO6K34D.js";
-import "../chunk-BHY7MNGT.js";
-import "../chunk-6YQ6KDIQ.js";
+} from "../chunk-MNOPO7G6.js";
+import "../chunk-VCZESWYA.js";
+import "../chunk-VVDJR3OA.js";
 import {
   __async
-} from "../chunk-GHY2WEOK.js";
+} from "../chunk-WIFMLPT5.js";
 
 // src/react/index.ts
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
@@ -176,6 +176,9 @@ function useTTS({
       if (player.current) {
         yield player.current.stop();
       }
+      if (playbackStatus === "finished") {
+        websocketReturn.current.source.seek(0, "start");
+      }
       setPlaybackStatus("playing");
       const unsubscribes = [];
       unsubscribes.push(

package/dist/react/utils.js

@@ -1,7 +1,7 @@
 import {
   pingServer
-} from "../chunk-NQVZNVOU.js";
-import "../chunk-GHY2WEOK.js";
+} from "../chunk-3FL2SNIR.js";
+import "../chunk-WIFMLPT5.js";
 export {
   pingServer
 };

package/dist/tts/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 });
@@ -249,6 +237,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.
    *
@@ -382,7 +401,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.
@@ -390,9 +409,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.");
     }
@@ -406,7 +424,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();
@@ -476,6 +494,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.
    *
@@ -493,6 +537,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/tts/index.js

@@ -1,12 +1,12 @@
 import {
   TTS
-} from "../chunk-EDAAHENY.js";
-import "../chunk-IZBPLCGW.js";
-import "../chunk-PISCPZK4.js";
+} from "../chunk-MUPVAEL7.js";
+import "../chunk-L3OMQKWL.js";
+import "../chunk-6PWLZAMS.js";
 import "../chunk-2BFEKY3F.js";
-import "../chunk-BHY7MNGT.js";
-import "../chunk-6YQ6KDIQ.js";
-import "../chunk-GHY2WEOK.js";
+import "../chunk-VCZESWYA.js";
+import "../chunk-VVDJR3OA.js";
+import "../chunk-WIFMLPT5.js";
 export {
   TTS as default
 };

package/dist/tts/player.js

@@ -1,9 +1,9 @@
 import {
   Player
-} from "../chunk-LZO6K34D.js";
-import "../chunk-BHY7MNGT.js";
-import "../chunk-6YQ6KDIQ.js";
-import "../chunk-GHY2WEOK.js";
+} from "../chunk-MNOPO7G6.js";
+import "../chunk-VCZESWYA.js";
+import "../chunk-VVDJR3OA.js";
+import "../chunk-WIFMLPT5.js";
 export {
   Player as default
 };

package/dist/tts/source.cjs

@@ -175,6 +175,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/tts/source.d.cts

@@ -40,6 +40,15 @@ declare class Source {
      * less than the length of the provided buffer.
      */
     read(dst: TypedArray): Promise<number>;
+    /**
+     * 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: number, whence: "start" | "current" | "end"): Promise<number>;
     /**
      * Get the number of samples in a given duration.
      *

package/dist/tts/source.d.ts

@@ -40,6 +40,15 @@ declare class Source {
      * less than the length of the provided buffer.
      */
     read(dst: TypedArray): Promise<number>;
+    /**
+     * 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: number, whence: "start" | "current" | "end"): Promise<number>;
     /**
      * Get the number of samples in a given duration.
      *

package/dist/tts/source.js

@@ -1,8 +1,8 @@
 import {
   ENCODING_MAP,
   Source
-} from "../chunk-6YQ6KDIQ.js";
-import "../chunk-GHY2WEOK.js";
+} from "../chunk-VVDJR3OA.js";
+import "../chunk-WIFMLPT5.js";
 export {
   ENCODING_MAP,
   Source as default