@cartesia/cartesia-js 0.0.3 → 1.0.0-alpha.1

package/dist/tts/websocket.d.ts

@@ -0,0 +1,53 @@
+import * as emittery from 'emittery';
+import { WebSocket as WebSocket$1 } from 'partysocket';
+import { Client } from '../lib/client.js';
+import { WebSocketOptions, StreamRequest, EmitteryCallbacks, ConnectionEventData } from '../types/index.js';
+import Source from './source.js';
+
+declare class WebSocket extends Client {
+    #private;
+    socket?: WebSocket$1;
+    /**
+     * Create a new WebSocket client.
+     *
+     * @param args - Arguments to pass to the Client constructor.
+     */
+    constructor({ sampleRate }: WebSocketOptions, ...args: ConstructorParameters<typeof Client>);
+    /**
+     * Send a message over the WebSocket in order to start a stream.
+     *
+     * @param inputs - Stream options.
+     * @param options - Options for the stream.
+     * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
+     * If `0`, the stream will not time out.
+     * @returns A Source object that can be passed to a Player to play the audio.
+     */
+    send(inputs: StreamRequest["inputs"], { timeout }?: StreamRequest["options"]): {
+        on: <Name extends keyof emittery.OmnipresentEventData | "message">(eventName: Name | readonly Name[], listener: (eventData: ({
+            message: string;
+        } & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
+        off: <Name_1 extends keyof emittery.OmnipresentEventData | "message">(eventName: Name_1 | readonly Name_1[], listener: (eventData: ({
+            message: string;
+        } & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
+        once: <Name_2 extends keyof emittery.OmnipresentEventData | "message">(eventName: Name_2 | readonly Name_2[]) => emittery.EmitteryOncePromise<({
+            message: string;
+        } & emittery.OmnipresentEventData)[Name_2]>;
+        events: <Name_3 extends "message">(eventName: Name_3 | readonly Name_3[]) => AsyncIterableIterator<{
+            message: string;
+        }[Name_3]>;
+        source: Source;
+    };
+    /**
+     * Authenticate and connect to a Cartesia streaming WebSocket.
+     *
+     * @returns A promise that resolves when the WebSocket is connected.
+     * @throws {Error} If the WebSocket fails to connect.
+     */
+    connect(): Promise<EmitteryCallbacks<ConnectionEventData>>;
+    /**
+     * Disconnect from the Cartesia streaming WebSocket.
+     */
+    disconnect(): void;
+}
+
+export { WebSocket as default };

package/dist/tts/websocket.js

@@ -0,0 +1,11 @@
+import {
+  WebSocket
+} from "../chunk-NDNN326Q.js";
+import "../chunk-JOHSCOLW.js";
+import "../chunk-BCQ63627.js";
+import "../chunk-3GBZUGUD.js";
+import "../chunk-LYPTISWL.js";
+import "../chunk-WIFMLPT5.js";
+export {
+  WebSocket as default
+};

package/dist/types/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/types/index.d.cts

@@ -0,0 +1,55 @@
+import emittery__default from 'emittery';
+
+interface ClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+}
+type Sentinel = null;
+type Chunk = string | Sentinel;
+type ConnectionEventData = {
+    open: never;
+    close: never;
+};
+type StreamRequest = {
+    inputs: object;
+    options: {
+        timeout?: number;
+    };
+};
+type EmitteryCallbacks<T> = {
+    on: emittery__default<T>["on"];
+    off: emittery__default<T>["off"];
+    once: emittery__default<T>["once"];
+    events: emittery__default<T>["events"];
+};
+type CloneOptions = {
+    mode: "url";
+    link: string;
+} | {
+    mode: "clip";
+    clip: Blob;
+};
+type Voice = {
+    id: string;
+    name: string;
+    description: string;
+    embedding: number[];
+    is_public: boolean;
+    user_id: string;
+    created_at: string;
+};
+type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
+type CloneResponse = {
+    embedding: number[];
+};
+type WebSocketOptions = {
+    sampleRate: number;
+};
+type SourceEventData = {
+    enqueue: never;
+    close: never;
+    wait: never;
+    read: never;
+};
+
+export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Sentinel, SourceEventData, StreamRequest, Voice, WebSocketOptions };

package/dist/types/index.d.ts

@@ -1,6 +1,55 @@
+import emittery__default from 'emittery';
+
 interface ClientOptions {
     apiKey?: string;
     baseUrl?: string;
 }
+type Sentinel = null;
+type Chunk = string | Sentinel;
+type ConnectionEventData = {
+    open: never;
+    close: never;
+};
+type StreamRequest = {
+    inputs: object;
+    options: {
+        timeout?: number;
+    };
+};
+type EmitteryCallbacks<T> = {
+    on: emittery__default<T>["on"];
+    off: emittery__default<T>["off"];
+    once: emittery__default<T>["once"];
+    events: emittery__default<T>["events"];
+};
+type CloneOptions = {
+    mode: "url";
+    link: string;
+} | {
+    mode: "clip";
+    clip: Blob;
+};
+type Voice = {
+    id: string;
+    name: string;
+    description: string;
+    embedding: number[];
+    is_public: boolean;
+    user_id: string;
+    created_at: string;
+};
+type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
+type CloneResponse = {
+    embedding: number[];
+};
+type WebSocketOptions = {
+    sampleRate: number;
+};
+type SourceEventData = {
+    enqueue: never;
+    close: never;
+    wait: never;
+    read: never;
+};
 
-export type { ClientOptions };
+export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Sentinel, SourceEventData, StreamRequest, Voice, WebSocketOptions };

package/dist/types/index.js

@@ -1,18 +1 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/types/index.ts
-var types_exports = {};
-module.exports = __toCommonJS(types_exports);
+import "../chunk-FXPGR372.js";

package/dist/voices/index.cjs

@@ -0,0 +1,155 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  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/voices/index.ts
+var voices_exports = {};
+__export(voices_exports, {
+  default: () => Voices
+});
+module.exports = __toCommonJS(voices_exports);
+
+// src/lib/client.ts
+var import_cross_fetch = __toESM(require("cross-fetch"), 1);
+
+// src/lib/constants.ts
+var BASE_URL = "https://api.cartesia.ai/v0";
+var constructApiUrl = (baseUrl, path, protocol) => {
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  if (!protocol) {
+    return new URL(`${baseUrl}${normalizedPath}`);
+  }
+  if (!["http", "ws"].includes(protocol)) {
+    throw new Error(`Invalid protocol: ${protocol}`);
+  }
+  return new URL(`${baseUrl.replace(/^http/, protocol)}${normalizedPath}`);
+};
+
+// src/lib/client.ts
+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 (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+      headers: __spreadValues({
+        "X-API-KEY": this.apiKey
+      }, options.headers)
+    }));
+  }
+};
+
+// 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()");
+    });
+  }
+};

package/dist/voices/index.d.cts

@@ -0,0 +1,12 @@
+import { Client } from '../lib/client.cjs';
+import { Voice, CreateVoice, 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>;
+    clone(options: CloneOptions): Promise<CloneResponse>;
+}
+
+export { Voices as default };

package/dist/voices/index.d.ts

@@ -0,0 +1,12 @@
+import { Client } from '../lib/client.js';
+import { Voice, CreateVoice, 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>;
+    clone(options: CloneOptions): Promise<CloneResponse>;
+}
+
+export { Voices as default };

package/dist/voices/index.js

@@ -0,0 +1,9 @@
+import {
+  Voices
+} from "../chunk-WBK6LLXX.js";
+import "../chunk-BCQ63627.js";
+import "../chunk-3GBZUGUD.js";
+import "../chunk-WIFMLPT5.js";
+export {
+  Voices as default
+};

package/package.json

@@ -4,23 +4,27 @@
 		"name": "Cartesia",
 		"url": "https://cartesia.ai"
 	},
-	"version": "0.0.3",
+	"version": "1.0.0-alpha.1",
 	"description": "Client for the Cartesia API.",
-	"main": "./dist/index.js",
-	"module": "./dist/index.mjs",
+	"type": "module",
+	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",
 	"exports": {
 		".": {
-			"import": "./dist/index.mjs",
-			"require": "./dist/index.js"
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
 		},
 		"./react": {
-			"import": "./dist/react/index.mjs",
-			"require": "./dist/react/index.js"
+			"import": "./dist/react/index.js",
+			"require": "./dist/react/index.cjs"
 		}
 	},
+	"engines": {
+		"node": ">=18"
+	},
 	"dependencies": {
 		"base64-js": "^1.5.1",
+		"cross-fetch": "^4.0.0",
 		"emittery": "^1.0.3",
 		"human-id": "^4.1.1",
 		"partysocket": "^1.0.1"

package/src/index.ts

@@ -0,0 +1,4 @@
+export { Cartesia as default } from "./lib";
+export * from "./lib";
+export * from "./types";
+export { default as WebPlayer } from "./tts/player";

package/src/lib/client.ts

@@ -1,5 +1,6 @@
+import fetch from "cross-fetch";
 import type { ClientOptions } from "../types";
-import { BASE_URL } from "./constants";
+import { BASE_URL, constructApiUrl } from "./constants";
 
 export class Client {
 	apiKey: string;
@@ -14,4 +15,16 @@ export class Client {
 		this.apiKey = (options.apiKey || process.env.CARTESIA_API_KEY)!;
 		this.baseUrl = options.baseUrl || BASE_URL;
 	}
+
+	fetch(path: string, options: RequestInit = {}) {
+		const url = constructApiUrl(this.baseUrl, path);
+
+		return fetch(url.toString(), {
+			...options,
+			headers: {
+				"X-API-KEY": this.apiKey,
+				...options.headers,
+			},
+		});
+	}
 }

package/src/lib/constants.ts

@@ -1,6 +1,16 @@
 export const BASE_URL = "https://api.cartesia.ai/v0";
-export const SAMPLE_RATE = 44100;
 
-export const constructWebsocketUrl = (baseUrl: string) => {
-	return new URL(`${baseUrl.replace(/^http/, "ws")}/audio/websocket`);
+export const constructApiUrl = (
+	baseUrl: string,
+	path: string,
+	protocol?: string,
+) => {
+	const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+	if (!protocol) {
+		return new URL(`${baseUrl}${normalizedPath}`);
+	}
+	if (!["http", "ws"].includes(protocol)) {
+		throw new Error(`Invalid protocol: ${protocol}`);
+	}
+	return new URL(`${baseUrl.replace(/^http/, protocol)}${normalizedPath}`);
 };

package/src/lib/index.ts

@@ -1,13 +1,16 @@
-import Audio from "../audio";
+import TTS from "../tts";
 import type { ClientOptions } from "../types";
+import Voices from "../voices";
 import { Client } from "./client";
 
 export class Cartesia extends Client {
-	audio: Audio;
+	tts: TTS;
+	voices: Voices;
 
 	constructor(options: ClientOptions = {}) {
 		super(options);
 
-		this.audio = new Audio(options);
+		this.tts = new TTS(options);
+		this.voices = new Voices(options);
 	}
 }