@cartesia/cartesia-js 1.0.1 → 1.0.2

package/dist/tts/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,60 @@ 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.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.

package/dist/tts/index.js

@@ -1,8 +1,8 @@
 import {
   TTS
-} from "../chunk-2NA5SEML.js";
-import "../chunk-ASZKHN7Q.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-EDAAHENY.js";
+import "../chunk-IZBPLCGW.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-BHY7MNGT.js";
 import "../chunk-6YQ6KDIQ.js";

package/dist/tts/websocket.cjs

@@ -125,20 +125,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
+      }));
+    });
   }
 };
 
@@ -476,56 +481,60 @@ 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.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.

package/dist/tts/websocket.js

@@ -1,7 +1,7 @@
 import {
   WebSocket
-} from "../chunk-ASZKHN7Q.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-IZBPLCGW.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-BHY7MNGT.js";
 import "../chunk-6YQ6KDIQ.js";

package/dist/types/index.d.cts

@@ -1,7 +1,7 @@
 import emittery__default from 'emittery';
 
 interface ClientOptions {
-    apiKey?: string;
+    apiKey?: string | (() => Promise<string>);
     baseUrl?: string;
 }
 type Sentinel = null;
@@ -77,9 +77,11 @@ type EmitteryCallbacks<T> = {
 type CloneOptions = {
     mode: "url";
     link: string;
+    enhance?: boolean;
 } | {
     mode: "clip";
     clip: Blob;
+    enhance?: boolean;
 };
 type Voice = {
     id: string;
@@ -89,8 +91,10 @@ type Voice = {
     is_public: boolean;
     user_id: string;
     created_at: string;
+    language: string;
 };
 type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
+type UpdateVoice = Partial<Pick<Voice, "name" | "description" | "embedding">>;
 type CloneResponse = {
     embedding: number[];
 };
@@ -108,4 +112,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, Voice, VoiceOptions, VoiceSpecifier, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { 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 };

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 import emittery__default from 'emittery';
 
 interface ClientOptions {
-    apiKey?: string;
+    apiKey?: string | (() => Promise<string>);
     baseUrl?: string;
 }
 type Sentinel = null;
@@ -77,9 +77,11 @@ type EmitteryCallbacks<T> = {
 type CloneOptions = {
     mode: "url";
     link: string;
+    enhance?: boolean;
 } | {
     mode: "clip";
     clip: Blob;
+    enhance?: boolean;
 };
 type Voice = {
     id: string;
@@ -89,8 +91,10 @@ type Voice = {
     is_public: boolean;
     user_id: string;
     created_at: string;
+    language: string;
 };
 type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
+type UpdateVoice = Partial<Pick<Voice, "name" | "description" | "embedding">>;
 type CloneResponse = {
     embedding: number[];
 };
@@ -108,4 +112,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, Voice, VoiceOptions, VoiceSpecifier, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { 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 };

package/dist/voices/index.cjs

@@ -88,20 +88,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
+      }));
+    });
   }
 };
 
@@ -109,40 +114,43 @@ var Client = class {
 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
         });

package/dist/voices/index.d.cts

@@ -1,11 +1,12 @@
 import { Client } from '../lib/client.cjs';
-import { Voice, CreateVoice, CloneOptions, CloneResponse } from '../types/index.cjs';
+import { Voice, CreateVoice, UpdateVoice, CloneOptions, CloneResponse } from '../types/index.cjs';
 import 'emittery';
 
 declare class Voices extends Client {
     list(): Promise<Voice[]>;
     get(voiceId: string): Promise<Voice>;
     create(voice: CreateVoice): Promise<Voice>;
+    update(id: string, voice: UpdateVoice): Promise<Voice>;
     clone(options: CloneOptions): Promise<CloneResponse>;
 }
 

package/dist/voices/index.d.ts

@@ -1,11 +1,12 @@
 import { Client } from '../lib/client.js';
-import { Voice, CreateVoice, CloneOptions, CloneResponse } from '../types/index.js';
+import { Voice, CreateVoice, UpdateVoice, CloneOptions, CloneResponse } from '../types/index.js';
 import 'emittery';
 
 declare class Voices extends Client {
     list(): Promise<Voice[]>;
     get(voiceId: string): Promise<Voice>;
     create(voice: CreateVoice): Promise<Voice>;
+    update(id: string, voice: UpdateVoice): Promise<Voice>;
     clone(options: CloneOptions): Promise<CloneResponse>;
 }
 

package/dist/voices/index.js

@@ -1,7 +1,7 @@
 import {
   Voices
-} from "../chunk-KUSVZXDT.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-UCYL2SOX.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-GHY2WEOK.js";
 export {

package/package.json

@@ -4,7 +4,7 @@
 		"name": "Cartesia",
 		"url": "https://cartesia.ai"
 	},
-	"version": "1.0.1",
+	"version": "1.0.2",
 	"description": "Client for the Cartesia API.",
 	"type": "module",
 	"module": "./dist/index.js",

package/src/lib/client.ts

@@ -3,29 +3,29 @@ import type { ClientOptions } from "../types";
 import { BASE_URL, CARTESIA_VERSION, constructApiUrl } from "./constants";
 
 export class Client {
-	apiKey: string;
+	apiKey: () => Promise<string>;
 	baseUrl: string;
 
 	constructor(options: ClientOptions = {}) {
-		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.");
 		}
 
-		// biome-ignore lint/style/noNonNullAssertion: Guaranteed to be defined by the check above.
-		this.apiKey = (options.apiKey || process.env.CARTESIA_API_KEY)!;
+		this.apiKey = typeof apiKey === "function" ? apiKey : async () => apiKey;
 		this.baseUrl = options.baseUrl || BASE_URL;
 	}
 
-	fetch(path: string, options: RequestInit = {}) {
+	protected async _fetch(path: string, options: RequestInit = {}) {
 		const url = constructApiUrl(this.baseUrl, path);
+		const headers = new Headers(options.headers);
+
+		headers.set("X-API-Key", await this.apiKey());
+		headers.set("Cartesia-Version", CARTESIA_VERSION);
 
 		return fetch(url.toString(), {
 			...options,
-			headers: {
-				"X-API-Key": this.apiKey,
-				"Cartesia-Version": CARTESIA_VERSION,
-				...options.headers,
-			},
+			headers,
 		});
 	}
 }

package/src/react/index.ts

@@ -8,7 +8,7 @@ import type { StreamRequest } from "../types";
 import { pingServer } from "./utils";
 
 export type UseTTSOptions = {
-	apiKey: string | null;
+	apiKey: string | (() => Promise<string>) | null;
 	baseUrl?: string;
 	sampleRate: number;
 	onError?: (error: Error) => void;

package/src/tts/websocket.ts

@@ -172,14 +172,16 @@ export default class WebSocket extends Client {
 	 * @returns A promise that resolves when the WebSocket is connected.
 	 * @throws {Error} If the WebSocket fails to connect.
 	 */
-	connect() {
-		const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-			websocket: true,
-		});
-		url.searchParams.set("api_key", this.apiKey);
-		url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+	async connect() {
 		const emitter = new Emittery<ConnectionEventData>();
-		this.socket = new PartySocketWebSocket(url.toString());
+		this.socket = new PartySocketWebSocket(async () => {
+			const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
+				websocket: true,
+			});
+			url.searchParams.set("api_key", await this.apiKey());
+			url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+			return url.toString();
+		});
 		this.socket.onopen = () => {
 			this.#isConnected = true;
 			emitter.emit("open");

package/src/types/index.ts

@@ -1,7 +1,7 @@
 import type Emittery from "emittery";
 
 export interface ClientOptions {
-	apiKey?: string;
+	apiKey?: string | (() => Promise<string>);
 	baseUrl?: string;
 }
 
@@ -104,10 +104,12 @@ export type CloneOptions =
 	| {
 			mode: "url";
 			link: string;
+			enhance?: boolean;
 	  }
 	| {
 			mode: "clip";
 			clip: Blob;
+			enhance?: boolean;
 	  };
 
 export type Voice = {
@@ -118,11 +120,16 @@ export type Voice = {
 	is_public: boolean;
 	user_id: string;
 	created_at: string;
+	language: string;
 };
 
 export type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> &
 	Partial<Omit<Voice, "name" | "description" | "embedding">>;
 
+export type UpdateVoice = Partial<
+	Pick<Voice, "name" | "description" | "embedding">
+>;
+
 export type CloneResponse = {
 	embedding: number[];
 };