@cartesia/cartesia-js 1.0.1 → 1.0.3

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,18 @@ 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.binaryType = "arraybuffer";
+
 		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;
 }
 
@@ -16,11 +16,11 @@ export type ConnectionEventData = {
 
 export type VoiceSpecifier =
 	| {
-			mode: "id";
+			mode?: "id";
 			id: string;
 	  }
 	| {
-			mode: "embedding";
+			mode?: "embedding";
 			embedding: number[];
 	  };
 
@@ -35,7 +35,7 @@ export type EmotionControl = Emotion | `${Emotion}:${Intensity}`;
 
 export type VoiceOptions = VoiceSpecifier & {
 	__experimental_controls?: {
-		speed?: "slowest" | "slow" | "normal" | "fast" | "fastest";
+		speed?: "slowest" | "slow" | "normal" | "fast" | "fastest" | number;
 		emotion?: EmotionControl[];
 	};
 };
@@ -104,12 +104,24 @@ export type CloneOptions =
 	| {
 			mode: "url";
 			link: string;
+			enhance?: boolean;
 	  }
 	| {
 			mode: "clip";
 			clip: Blob;
+			enhance?: boolean;
 	  };
 
+export interface VoiceToMix {
+	id?: string;
+	embedding?: number[];
+	weight: number;
+}
+
+export interface MixVoicesOptions {
+	voices: VoiceToMix[];
+}
+
 export type Voice = {
 	id: string;
 	name: string;
@@ -118,15 +130,24 @@ 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[];
 };
 
+export type MixVoicesResponse = {
+	embedding: number[];
+};
+
 export type WebSocketOptions = {
 	container?: string;
 	encoding?: string;

package/src/voices/index.ts

@@ -1,41 +1,50 @@
 import { Client } from "../lib/client";
-import type { CloneOptions, CloneResponse, CreateVoice, Voice } from "../types";
+import type {
+	CloneOptions,
+	CloneResponse,
+	CreateVoice,
+	MixVoicesOptions,
+	MixVoicesResponse,
+	UpdateVoice,
+	Voice,
+} from "../types";
 
 export default class Voices extends Client {
 	async list(): Promise<Voice[]> {
-		const response = await this.fetch("/voices");
+		const response = await this._fetch("/voices");
 		return response.json();
 	}
 
 	async get(voiceId: string): Promise<Voice> {
-		const response = await this.fetch(`/voices/${voiceId}`);
+		const response = await this._fetch(`/voices/${voiceId}`);
 		return response.json();
 	}
 
 	async create(voice: CreateVoice): Promise<Voice> {
-		const response = await this.fetch("/voices", {
+		const response = await this._fetch("/voices", {
 			method: "POST",
 			body: JSON.stringify(voice),
 		});
 		return response.json() as Promise<Voice>;
 	}
 
-	async clone(options: CloneOptions): Promise<CloneResponse> {
-		if (options.mode === "url") {
-			const response = await this.fetch(
-				`/voices/clone/url?link=${options.link}`,
-				{
-					method: "POST",
-				},
-			);
-			return response.json();
-		}
+	async update(id: string, voice: UpdateVoice): Promise<Voice> {
+		const response = await this._fetch(`/voices/${id}`, {
+			method: "PATCH",
+			body: JSON.stringify(voice),
+		});
+		return response.json() as Promise<Voice>;
+	}
 
+	async clone(options: CloneOptions): Promise<CloneResponse> {
 		if (options.mode === "clip") {
 			const formData = new FormData();
 			formData.append("clip", options.clip);
+			if (options.enhance !== undefined) {
+				formData.append("enhance", options.enhance.toString());
+			}
 
-			const response = await this.fetch("/voices/clone/clip", {
+			const response = await this._fetch("/voices/clone/clip", {
 				method: "POST",
 				body: formData,
 			});
@@ -44,4 +53,15 @@ export default class Voices extends Client {
 
 		throw new Error("Invalid mode for clone()");
 	}
+
+	async mix(options: MixVoicesOptions): Promise<MixVoicesResponse> {
+		const request: MixVoicesOptions = options;
+
+		const response = await this._fetch("/voices/mix", {
+			method: "POST",
+			body: JSON.stringify(request),
+		});
+
+		return response.json() as Promise<MixVoicesResponse>;
+	}
 }

package/dist/chunk-5M33ZF3Y.js

@@ -1,34 +0,0 @@
-import {
-  BASE_URL,
-  CARTESIA_VERSION,
-  constructApiUrl
-} from "./chunk-2BFEKY3F.js";
-import {
-  __spreadProps,
-  __spreadValues
-} from "./chunk-GHY2WEOK.js";
-
-// src/lib/client.ts
-import fetch from "cross-fetch";
-var Client = class {
-  constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
-      throw new Error("Missing Cartesia API key.");
-    }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
-    this.baseUrl = options.baseUrl || BASE_URL;
-  }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return fetch(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
-  }
-};
-
-export {
-  Client
-};

package/dist/chunk-KUSVZXDT.js

@@ -1,58 +0,0 @@
-import {
-  Client
-} from "./chunk-5M33ZF3Y.js";
-import {
-  __async
-} from "./chunk-GHY2WEOK.js";
-
-// src/voices/index.ts
-var Voices = class extends Client {
-  list() {
-    return __async(this, null, function* () {
-      const response = yield this.fetch("/voices");
-      return response.json();
-    });
-  }
-  get(voiceId) {
-    return __async(this, null, function* () {
-      const response = yield this.fetch(`/voices/${voiceId}`);
-      return response.json();
-    });
-  }
-  create(voice) {
-    return __async(this, null, function* () {
-      const response = yield this.fetch("/voices", {
-        method: "POST",
-        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", {
-          method: "POST",
-          body: formData
-        });
-        return response.json();
-      }
-      throw new Error("Invalid mode for clone()");
-    });
-  }
-};
-
-export {
-  Voices
-};