@cartesia/cartesia-js 1.0.1 → 1.0.3

package/dist/lib/client.cjs

@@ -43,6 +43,26 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 
 // src/lib/client.ts
 var client_exports = {};
@@ -66,20 +86,25 @@ var constructApiUrl = (baseUrl, path, { websocket = false } = {}) => {
 // src/lib/client.ts
 var Client = class {
   constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    if (!apiKey) {
       throw new Error("Missing Cartesia API key.");
     }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
+      return apiKey;
+    });
     this.baseUrl = options.baseUrl || BASE_URL;
   }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
+  _fetch(_0) {
+    return __async(this, arguments, function* (path, options = {}) {
+      const url = constructApiUrl(this.baseUrl, path);
+      const headers = new Headers(options.headers);
+      headers.set("X-API-Key", yield this.apiKey());
+      headers.set("Cartesia-Version", CARTESIA_VERSION);
+      return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+        headers
+      }));
+    });
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/lib/client.d.cts

@@ -2,10 +2,10 @@ import { ClientOptions } from '../types/index.cjs';
 import 'emittery';
 
 declare class Client {
-    apiKey: string;
+    apiKey: () => Promise<string>;
     baseUrl: string;
     constructor(options?: ClientOptions);
-    fetch(path: string, options?: RequestInit): Promise<Response>;
+    protected _fetch(path: string, options?: RequestInit): Promise<Response>;
 }
 
 export { Client };

package/dist/lib/client.d.ts

@@ -2,10 +2,10 @@ import { ClientOptions } from '../types/index.js';
 import 'emittery';
 
 declare class Client {
-    apiKey: string;
+    apiKey: () => Promise<string>;
     baseUrl: string;
     constructor(options?: ClientOptions);
-    fetch(path: string, options?: RequestInit): Promise<Response>;
+    protected _fetch(path: string, options?: RequestInit): Promise<Response>;
 }
 
 export { Client };

package/dist/lib/client.js

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

package/dist/lib/index.cjs

@@ -122,20 +122,25 @@ var constructApiUrl = (baseUrl, path, { websocket = false } = {}) => {
 // src/lib/client.ts
 var Client = class {
   constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    if (!apiKey) {
       throw new Error("Missing Cartesia API key.");
     }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
+      return apiKey;
+    });
     this.baseUrl = options.baseUrl || BASE_URL;
   }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
+  _fetch(_0) {
+    return __async(this, arguments, function* (path, options = {}) {
+      const url = constructApiUrl(this.baseUrl, path);
+      const headers = new Headers(options.headers);
+      headers.set("X-API-Key", yield this.apiKey());
+      headers.set("Cartesia-Version", CARTESIA_VERSION);
+      return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+        headers
+      }));
+    });
   }
 };
 
@@ -478,56 +483,61 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-      websocket: true
+    return __async(this, null, function* () {
+      const emitter = new import_emittery2.default();
+      this.socket = new import_partysocket.WebSocket(() => __async(this, null, function* () {
+        const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
+          websocket: true
+        });
+        url.searchParams.set("api_key", yield this.apiKey());
+        url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+        return url.toString();
+      }));
+      this.socket.binaryType = "arraybuffer";
+      this.socket.onopen = () => {
+        __privateSet(this, _isConnected, true);
+        emitter.emit("open");
+      };
+      this.socket.onclose = () => {
+        __privateSet(this, _isConnected, false);
+        emitter.emit("close");
+      };
+      return new Promise(
+        (resolve, reject) => {
+          var _a, _b, _c;
+          (_a = this.socket) == null ? void 0 : _a.addEventListener(
+            "open",
+            () => {
+              resolve(getEmitteryCallbacks(emitter));
+            },
+            {
+              once: true
+            }
+          );
+          const aborter = new AbortController();
+          (_b = this.socket) == null ? void 0 : _b.addEventListener(
+            "error",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket failed to connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+          (_c = this.socket) == null ? void 0 : _c.addEventListener(
+            "close",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket closed before it could connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+        }
+      );
     });
-    url.searchParams.set("api_key", this.apiKey);
-    url.searchParams.set("cartesia_version", CARTESIA_VERSION);
-    const emitter = new import_emittery2.default();
-    this.socket = new import_partysocket.WebSocket(url.toString());
-    this.socket.onopen = () => {
-      __privateSet(this, _isConnected, true);
-      emitter.emit("open");
-    };
-    this.socket.onclose = () => {
-      __privateSet(this, _isConnected, false);
-      emitter.emit("close");
-    };
-    return new Promise(
-      (resolve, reject) => {
-        var _a, _b, _c;
-        (_a = this.socket) == null ? void 0 : _a.addEventListener(
-          "open",
-          () => {
-            resolve(getEmitteryCallbacks(emitter));
-          },
-          {
-            once: true
-          }
-        );
-        const aborter = new AbortController();
-        (_b = this.socket) == null ? void 0 : _b.addEventListener(
-          "error",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket failed to connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-        (_c = this.socket) == null ? void 0 : _c.addEventListener(
-          "close",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket closed before it could connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-      }
-    );
   }
   /**
    * Disconnect from the Cartesia streaming WebSocket.
@@ -568,40 +578,43 @@ var TTS = class extends Client {
 var Voices = class extends Client {
   list() {
     return __async(this, null, function* () {
-      const response = yield this.fetch("/voices");
+      const response = yield this._fetch("/voices");
       return response.json();
     });
   }
   get(voiceId) {
     return __async(this, null, function* () {
-      const response = yield this.fetch(`/voices/${voiceId}`);
+      const response = yield this._fetch(`/voices/${voiceId}`);
       return response.json();
     });
   }
   create(voice) {
     return __async(this, null, function* () {
-      const response = yield this.fetch("/voices", {
+      const response = yield this._fetch("/voices", {
         method: "POST",
         body: JSON.stringify(voice)
       });
       return response.json();
     });
   }
+  update(id, voice) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch(`/voices/${id}`, {
+        method: "PATCH",
+        body: JSON.stringify(voice)
+      });
+      return response.json();
+    });
+  }
   clone(options) {
     return __async(this, null, function* () {
-      if (options.mode === "url") {
-        const response = yield this.fetch(
-          `/voices/clone/url?link=${options.link}`,
-          {
-            method: "POST"
-          }
-        );
-        return response.json();
-      }
       if (options.mode === "clip") {
         const formData = new FormData();
         formData.append("clip", options.clip);
-        const response = yield this.fetch("/voices/clone/clip", {
+        if (options.enhance !== void 0) {
+          formData.append("enhance", options.enhance.toString());
+        }
+        const response = yield this._fetch("/voices/clone/clip", {
           method: "POST",
           body: formData
         });
@@ -610,6 +623,16 @@ var Voices = class extends Client {
       throw new Error("Invalid mode for clone()");
     });
   }
+  mix(options) {
+    return __async(this, null, function* () {
+      const request = options;
+      const response = yield this._fetch("/voices/mix", {
+        method: "POST",
+        body: JSON.stringify(request)
+      });
+      return response.json();
+    });
+  }
 };
 
 // src/lib/index.ts

package/dist/lib/index.js

@@ -1,10 +1,10 @@
 import {
   Cartesia
-} from "../chunk-OFH3ML4L.js";
-import "../chunk-KUSVZXDT.js";
-import "../chunk-2NA5SEML.js";
-import "../chunk-ASZKHN7Q.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-ZF6HASZT.js";
+import "../chunk-YFN6TFR4.js";
+import "../chunk-NWCW6C7H.js";
+import "../chunk-EUW2435M.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-BHY7MNGT.js";
 import "../chunk-6YQ6KDIQ.js";

package/dist/react/index.cjs

@@ -123,20 +123,25 @@ var constructApiUrl = (baseUrl, path, { websocket = false } = {}) => {
 // src/lib/client.ts
 var Client = class {
   constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    if (!apiKey) {
       throw new Error("Missing Cartesia API key.");
     }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
+      return apiKey;
+    });
     this.baseUrl = options.baseUrl || BASE_URL;
   }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
+  _fetch(_0) {
+    return __async(this, arguments, function* (path, options = {}) {
+      const url = constructApiUrl(this.baseUrl, path);
+      const headers = new Headers(options.headers);
+      headers.set("X-API-Key", yield this.apiKey());
+      headers.set("Cartesia-Version", CARTESIA_VERSION);
+      return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+        headers
+      }));
+    });
   }
 };
 
@@ -492,56 +497,61 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-      websocket: true
+    return __async(this, null, function* () {
+      const emitter = new import_emittery2.default();
+      this.socket = new import_partysocket.WebSocket(() => __async(this, null, function* () {
+        const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
+          websocket: true
+        });
+        url.searchParams.set("api_key", yield this.apiKey());
+        url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+        return url.toString();
+      }));
+      this.socket.binaryType = "arraybuffer";
+      this.socket.onopen = () => {
+        __privateSet(this, _isConnected, true);
+        emitter.emit("open");
+      };
+      this.socket.onclose = () => {
+        __privateSet(this, _isConnected, false);
+        emitter.emit("close");
+      };
+      return new Promise(
+        (resolve, reject) => {
+          var _a, _b, _c;
+          (_a = this.socket) == null ? void 0 : _a.addEventListener(
+            "open",
+            () => {
+              resolve(getEmitteryCallbacks(emitter));
+            },
+            {
+              once: true
+            }
+          );
+          const aborter = new AbortController();
+          (_b = this.socket) == null ? void 0 : _b.addEventListener(
+            "error",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket failed to connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+          (_c = this.socket) == null ? void 0 : _c.addEventListener(
+            "close",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket closed before it could connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+        }
+      );
     });
-    url.searchParams.set("api_key", this.apiKey);
-    url.searchParams.set("cartesia_version", CARTESIA_VERSION);
-    const emitter = new import_emittery2.default();
-    this.socket = new import_partysocket.WebSocket(url.toString());
-    this.socket.onopen = () => {
-      __privateSet(this, _isConnected, true);
-      emitter.emit("open");
-    };
-    this.socket.onclose = () => {
-      __privateSet(this, _isConnected, false);
-      emitter.emit("close");
-    };
-    return new Promise(
-      (resolve, reject) => {
-        var _a, _b, _c;
-        (_a = this.socket) == null ? void 0 : _a.addEventListener(
-          "open",
-          () => {
-            resolve(getEmitteryCallbacks(emitter));
-          },
-          {
-            once: true
-          }
-        );
-        const aborter = new AbortController();
-        (_b = this.socket) == null ? void 0 : _b.addEventListener(
-          "error",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket failed to connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-        (_c = this.socket) == null ? void 0 : _c.addEventListener(
-          "close",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket closed before it could connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-      }
-    );
   }
   /**
    * Disconnect from the Cartesia streaming WebSocket.
@@ -582,40 +592,43 @@ var TTS = class extends Client {
 var Voices = class extends Client {
   list() {
     return __async(this, null, function* () {
-      const response = yield this.fetch("/voices");
+      const response = yield this._fetch("/voices");
       return response.json();
     });
   }
   get(voiceId) {
     return __async(this, null, function* () {
-      const response = yield this.fetch(`/voices/${voiceId}`);
+      const response = yield this._fetch(`/voices/${voiceId}`);
       return response.json();
     });
   }
   create(voice) {
     return __async(this, null, function* () {
-      const response = yield this.fetch("/voices", {
+      const response = yield this._fetch("/voices", {
         method: "POST",
         body: JSON.stringify(voice)
       });
       return response.json();
     });
   }
+  update(id, voice) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch(`/voices/${id}`, {
+        method: "PATCH",
+        body: JSON.stringify(voice)
+      });
+      return response.json();
+    });
+  }
   clone(options) {
     return __async(this, null, function* () {
-      if (options.mode === "url") {
-        const response = yield this.fetch(
-          `/voices/clone/url?link=${options.link}`,
-          {
-            method: "POST"
-          }
-        );
-        return response.json();
-      }
       if (options.mode === "clip") {
         const formData = new FormData();
         formData.append("clip", options.clip);
-        const response = yield this.fetch("/voices/clone/clip", {
+        if (options.enhance !== void 0) {
+          formData.append("enhance", options.enhance.toString());
+        }
+        const response = yield this._fetch("/voices/clone/clip", {
           method: "POST",
           body: formData
         });
@@ -624,6 +637,16 @@ var Voices = class extends Client {
       throw new Error("Invalid mode for clone()");
     });
   }
+  mix(options) {
+    return __async(this, null, function* () {
+      const request = options;
+      const response = yield this._fetch("/voices/mix", {
+        method: "POST",
+        body: JSON.stringify(request)
+      });
+      return response.json();
+    });
+  }
 };
 
 // src/lib/index.ts

package/dist/react/index.d.cts

@@ -3,7 +3,7 @@ import { StreamRequest } from '../types/index.cjs';
 import 'emittery';
 
 type UseTTSOptions = {
-    apiKey: string | null;
+    apiKey: string | (() => Promise<string>) | null;
     baseUrl?: string;
     sampleRate: number;
     onError?: (error: Error) => void;

package/dist/react/index.d.ts

@@ -3,7 +3,7 @@ import { StreamRequest } from '../types/index.js';
 import 'emittery';
 
 type UseTTSOptions = {
-    apiKey: string | null;
+    apiKey: string | (() => Promise<string>) | null;
     baseUrl?: string;
     sampleRate: number;
     onError?: (error: Error) => void;

package/dist/react/index.js

@@ -1,13 +1,13 @@
 import {
   Cartesia
-} from "../chunk-OFH3ML4L.js";
-import "../chunk-KUSVZXDT.js";
+} from "../chunk-ZF6HASZT.js";
+import "../chunk-YFN6TFR4.js";
 import {
   pingServer
 } from "../chunk-NQVZNVOU.js";
-import "../chunk-2NA5SEML.js";
-import "../chunk-ASZKHN7Q.js";
-import "../chunk-5M33ZF3Y.js";
+import "../chunk-NWCW6C7H.js";
+import "../chunk-EUW2435M.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import {
   Player