@cartesia/cartesia-js 0.0.1 → 0.0.2

package/dist/{chunk-5RMUZJV7.mjs → chunk-3CYTAFLF.mjs}

@@ -1,23 +1,26 @@
 import {
   createMessageHandlerForContextId,
   getBufferDuration,
+  getEmitteryCallbacks,
   isComplete,
   isSentinel,
   playAudioBuffer
-} from "./chunk-BTFHUVNH.mjs";
+} from "./chunk-FRIBQZPN.mjs";
 import {
   Client
-} from "./chunk-ERFCRIWU.mjs";
+} from "./chunk-XSFPHPPG.mjs";
 import {
   SAMPLE_RATE,
   __async,
   __forAwait,
+  __spreadValues,
   constructWebsocketUrl
-} from "./chunk-35HX6ML3.mjs";
+} from "./chunk-HNLIBHEN.mjs";
 
 // src/audio/index.ts
 import Emittery from "emittery";
 import { humanId } from "human-id";
+import { WebSocket } from "partysocket";
 var audio_default = class extends Client {
   constructor() {
     super(...arguments);
@@ -64,6 +67,9 @@ var audio_default = class extends Client {
         });
         yield emitter.emit("message", message);
         if (isSentinel(chunk)) {
+          yield emitter.emit("streamed", {
+            chunks
+          });
           streamCompleteController.abort();
         } else if (timeoutId) {
           clearTimeout(timeoutId);
@@ -74,13 +80,28 @@ var audio_default = class extends Client {
     (_b = this.socket) == null ? void 0 : _b.addEventListener("message", handleMessage, {
       signal: streamCompleteController.signal
     });
-    (_c = this.socket) == null ? void 0 : _c.addEventListener("close", streamCompleteController.abort, {
-      once: true
-    });
-    (_d = this.socket) == null ? void 0 : _d.addEventListener("error", streamCompleteController.abort, {
-      once: true
-    });
+    (_c = this.socket) == null ? void 0 : _c.addEventListener(
+      "close",
+      () => {
+        streamCompleteController.abort();
+      },
+      {
+        once: true
+      }
+    );
+    (_d = this.socket) == null ? void 0 : _d.addEventListener(
+      "error",
+      () => {
+        streamCompleteController.abort();
+      },
+      {
+        once: true
+      }
+    );
     streamCompleteController.signal.addEventListener("abort", () => {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
       emitter.clearListeners();
     });
     const play = (_0) => __async(this, [_0], function* ({ bufferDuration }) {
@@ -154,13 +175,9 @@ var audio_default = class extends Client {
         }
       }
     });
-    return {
-      play,
-      on: emitter.on.bind(emitter),
-      off: emitter.off.bind(emitter),
-      once: emitter.once.bind(emitter),
-      events: emitter.events.bind(emitter)
-    };
+    return __spreadValues({
+      play
+    }, getEmitteryCallbacks(emitter));
   }
   /**
    * Generate a unique ID suitable for a streaming context.
@@ -185,46 +202,51 @@ var audio_default = class extends Client {
   connect() {
     const url = constructWebsocketUrl(this.baseUrl);
     url.searchParams.set("api_key", this.apiKey);
-    this.socket = new WebSocket(url);
+    const emitter = new Emittery();
+    this.socket = new WebSocket(url.toString());
     this.socket.onopen = () => {
       this.isConnected = true;
+      emitter.emit("open");
     };
     this.socket.onclose = () => {
       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();
-        },
-        {
-          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
-        }
-      );
-    });
+    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/{chunk-BTFHUVNH.mjs → chunk-FRIBQZPN.mjs}

@@ -1,6 +1,6 @@
 import {
   SAMPLE_RATE
-} from "./chunk-35HX6ML3.mjs";
+} from "./chunk-HNLIBHEN.mjs";
 
 // src/audio/utils.ts
 import base64 from "base64-js";
@@ -58,6 +58,46 @@ function filterSentinel(collection) {
 function isComplete(chunks) {
   return isSentinel(chunks[chunks.length - 1]);
 }
+function getEmitteryCallbacks(emitter) {
+  return {
+    on: emitter.on.bind(emitter),
+    off: emitter.off.bind(emitter),
+    once: emitter.once.bind(emitter),
+    events: emitter.events.bind(emitter)
+  };
+}
+function bufferToWav(sampleRate, channelBuffers) {
+  const totalSamples = channelBuffers[0].length * channelBuffers.length;
+  const buffer = new ArrayBuffer(44 + totalSamples * 2);
+  const view = new DataView(buffer);
+  const writeString = (view2, offset2, string) => {
+    for (let i = 0; i < string.length; i++) {
+      view2.setUint8(offset2 + i, string.charCodeAt(i));
+    }
+  };
+  writeString(view, 0, "RIFF");
+  view.setUint32(4, 36 + totalSamples * 2, true);
+  writeString(view, 8, "WAVE");
+  writeString(view, 12, "fmt ");
+  view.setUint32(16, 16, true);
+  view.setUint16(20, 1, true);
+  view.setUint16(22, channelBuffers.length, true);
+  view.setUint32(24, sampleRate, true);
+  view.setUint32(28, sampleRate * 4, true);
+  view.setUint16(32, channelBuffers.length * 2, true);
+  view.setUint16(34, 16, true);
+  writeString(view, 36, "data");
+  view.setUint32(40, totalSamples * 2, true);
+  let offset = 44;
+  for (let i = 0; i < channelBuffers[0].length; i++) {
+    for (let channel = 0; channel < channelBuffers.length; channel++) {
+      const s = Math.max(-1, Math.min(1, channelBuffers[channel][i]));
+      view.setInt16(offset, s < 0 ? s * 32768 : s * 32767, true);
+      offset += 2;
+    }
+  }
+  return buffer;
+}
 
 export {
   getBufferDuration,
@@ -67,5 +107,7 @@ export {
   getSentinel,
   isSentinel,
   filterSentinel,
-  isComplete
+  isComplete,
+  getEmitteryCallbacks,
+  bufferToWav
 };

package/dist/{chunk-35HX6ML3.mjs → chunk-HNLIBHEN.mjs}

@@ -1,6 +1,22 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
 var __knownSymbol = (name, symbol) => {
   return (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
 };
+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 __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -27,10 +43,11 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
 var BASE_URL = "https://api.cartesia.ai/v0";
 var SAMPLE_RATE = 44100;
 var constructWebsocketUrl = (baseUrl) => {
-  return new URL(`${baseUrl.replace(/^http/, "ws")}/ws`);
+  return new URL(`${baseUrl.replace(/^http/, "ws")}/audio/websocket`);
 };
 
 export {
+  __spreadValues,
   __async,
   __forAwait,
   BASE_URL,

package/dist/{chunk-ERFCRIWU.mjs → chunk-XSFPHPPG.mjs}

@@ -1,6 +1,6 @@
 import {
   BASE_URL
-} from "./chunk-35HX6ML3.mjs";
+} from "./chunk-HNLIBHEN.mjs";
 
 // src/lib/client.ts
 var Client = class {

package/dist/{index-Dt9A_pEb.d.mts → index-DSBmfK9-.d.mts}

@@ -1,4 +1,6 @@
 import * as emittery from 'emittery';
+import emittery__default from 'emittery';
+import { WebSocket } from 'partysocket';
 import { Client } from './lib/client.mjs';
 
 /**
@@ -67,6 +69,24 @@ declare function filterSentinel<T>(collection: T[]): Exclude<T, Sentinel>[];
  * @returns Whether the array of chunks is complete.
  */
 declare function isComplete(chunks: Chunk[]): boolean;
+type EmitteryCallbacks<T> = {
+    on: emittery__default<T>["on"];
+    off: emittery__default<T>["off"];
+    once: emittery__default<T>["once"];
+    events: emittery__default<T>["events"];
+};
+/**
+ * Get user-facing emitter callbacks for an Emittery instance.
+ * @param emitter The Emittery instance to get callbacks for.
+ * @returns User-facing emitter callbacks.
+ */
+declare function getEmitteryCallbacks<T>(emitter: emittery__default<T>): EmitteryCallbacks<T>;
+/**
+ * Converts a base64-encoded audio buffer to a WAV file.
+ * Source: https://gist.github.com/Daninet/22edc59cf2aee0b9a90c18e553e49297
+ * @param b64 The base64-encoded audio buffer to convert to a WAV file.
+ */
+declare function bufferToWav(sampleRate: number, channelBuffers: Float32Array[]): ArrayBuffer;
 
 type Chunk = string | Sentinel;
 type StreamEventData = {
@@ -74,8 +94,21 @@ type StreamEventData = {
         chunk: Chunk;
         chunks: Chunk[];
     };
+    streamed: {
+        chunks: Chunk[];
+    };
     message: unknown;
 };
+type ConnectionEventData = {
+    open: never;
+    close: never;
+};
+type StreamRequest = {
+    inputs: object;
+    options: {
+        timeout?: number;
+    };
+};
 declare class export_default extends Client {
     socket?: WebSocket;
     isConnected: boolean;
@@ -91,16 +124,14 @@ declare class export_default extends Client {
      * that plays the audio as it arrives, with `bufferDuration` seconds of audio buffered before
      * starting playback.
      */
-    stream(inputs: object, { timeout }?: {
-        timeout?: number;
-    }): {
-        play: ({ bufferDuration }: {
-            bufferDuration: number;
-        }) => Promise<void>;
+    stream(inputs: StreamRequest["inputs"], { timeout }?: StreamRequest["options"]): {
         on: <Name extends keyof StreamEventData | keyof emittery.OmnipresentEventData>(eventName: Name | readonly Name[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
         off: <Name_1 extends keyof StreamEventData | keyof emittery.OmnipresentEventData>(eventName: Name_1 | readonly Name_1[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
         once: <Name_2 extends keyof StreamEventData | keyof emittery.OmnipresentEventData>(eventName: Name_2 | readonly Name_2[]) => emittery.EmitteryOncePromise<(StreamEventData & emittery.OmnipresentEventData)[Name_2]>;
         events: <Name_3 extends keyof StreamEventData>(eventName: Name_3 | readonly Name_3[]) => AsyncIterableIterator<StreamEventData[Name_3]>;
+        play: ({ bufferDuration }: {
+            bufferDuration: number;
+        }) => Promise<void>;
     };
     /**
      * Generate a unique ID suitable for a streaming context.
@@ -117,11 +148,11 @@ declare class export_default extends Client {
      * @returns A promise that resolves when the WebSocket is connected.
      * @throws {Error} If the WebSocket fails to connect.
      */
-    connect(): Promise<void>;
+    connect(): Promise<EmitteryCallbacks<ConnectionEventData>>;
     /**
      * Disconnect from the Cartesia streaming WebSocket.
      */
     disconnect(): void;
 }
 
-export { type Chunk as C, type StreamEventData as S, type Sentinel as a, base64ToArray as b, createMessageHandlerForContextId as c, getSentinel as d, export_default as e, filterSentinel as f, getBufferDuration as g, isComplete as h, isSentinel as i, playAudioBuffer as p };
+export { type Chunk as C, type EmitteryCallbacks as E, type StreamEventData as S, type Sentinel as a, base64ToArray as b, createMessageHandlerForContextId as c, getSentinel as d, export_default as e, filterSentinel as f, getBufferDuration as g, isComplete as h, isSentinel as i, getEmitteryCallbacks as j, bufferToWav as k, type ConnectionEventData as l, type StreamRequest as m, playAudioBuffer as p };

package/dist/{index-Ds4LDkmk.d.ts → index-qwAyxV5I.d.ts}

@@ -1,4 +1,6 @@
 import * as emittery from 'emittery';
+import emittery__default from 'emittery';
+import { WebSocket } from 'partysocket';
 import { Client } from './lib/client.js';
 
 /**
@@ -67,6 +69,24 @@ declare function filterSentinel<T>(collection: T[]): Exclude<T, Sentinel>[];
  * @returns Whether the array of chunks is complete.
  */
 declare function isComplete(chunks: Chunk[]): boolean;
+type EmitteryCallbacks<T> = {
+    on: emittery__default<T>["on"];
+    off: emittery__default<T>["off"];
+    once: emittery__default<T>["once"];
+    events: emittery__default<T>["events"];
+};
+/**
+ * Get user-facing emitter callbacks for an Emittery instance.
+ * @param emitter The Emittery instance to get callbacks for.
+ * @returns User-facing emitter callbacks.
+ */
+declare function getEmitteryCallbacks<T>(emitter: emittery__default<T>): EmitteryCallbacks<T>;
+/**
+ * Converts a base64-encoded audio buffer to a WAV file.
+ * Source: https://gist.github.com/Daninet/22edc59cf2aee0b9a90c18e553e49297
+ * @param b64 The base64-encoded audio buffer to convert to a WAV file.
+ */
+declare function bufferToWav(sampleRate: number, channelBuffers: Float32Array[]): ArrayBuffer;
 
 type Chunk = string | Sentinel;
 type StreamEventData = {
@@ -74,8 +94,21 @@ type StreamEventData = {
         chunk: Chunk;
         chunks: Chunk[];
     };
+    streamed: {
+        chunks: Chunk[];
+    };
     message: unknown;
 };
+type ConnectionEventData = {
+    open: never;
+    close: never;
+};
+type StreamRequest = {
+    inputs: object;
+    options: {
+        timeout?: number;
+    };
+};
 declare class export_default extends Client {
     socket?: WebSocket;
     isConnected: boolean;
@@ -91,16 +124,14 @@ declare class export_default extends Client {
      * that plays the audio as it arrives, with `bufferDuration` seconds of audio buffered before
      * starting playback.
      */
-    stream(inputs: object, { timeout }?: {
-        timeout?: number;
-    }): {
-        play: ({ bufferDuration }: {
-            bufferDuration: number;
-        }) => Promise<void>;
+    stream(inputs: StreamRequest["inputs"], { timeout }?: StreamRequest["options"]): {
         on: <Name extends keyof StreamEventData | keyof emittery.OmnipresentEventData>(eventName: Name | readonly Name[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
         off: <Name_1 extends keyof StreamEventData | keyof emittery.OmnipresentEventData>(eventName: Name_1 | readonly Name_1[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
         once: <Name_2 extends keyof StreamEventData | keyof emittery.OmnipresentEventData>(eventName: Name_2 | readonly Name_2[]) => emittery.EmitteryOncePromise<(StreamEventData & emittery.OmnipresentEventData)[Name_2]>;
         events: <Name_3 extends keyof StreamEventData>(eventName: Name_3 | readonly Name_3[]) => AsyncIterableIterator<StreamEventData[Name_3]>;
+        play: ({ bufferDuration }: {
+            bufferDuration: number;
+        }) => Promise<void>;
     };
     /**
      * Generate a unique ID suitable for a streaming context.
@@ -117,11 +148,11 @@ declare class export_default extends Client {
      * @returns A promise that resolves when the WebSocket is connected.
      * @throws {Error} If the WebSocket fails to connect.
      */
-    connect(): Promise<void>;
+    connect(): Promise<EmitteryCallbacks<ConnectionEventData>>;
     /**
      * Disconnect from the Cartesia streaming WebSocket.
      */
     disconnect(): void;
 }
 
-export { type Chunk as C, type StreamEventData as S, type Sentinel as a, base64ToArray as b, createMessageHandlerForContextId as c, getSentinel as d, export_default as e, filterSentinel as f, getBufferDuration as g, isComplete as h, isSentinel as i, playAudioBuffer as p };
+export { type Chunk as C, type EmitteryCallbacks as E, type StreamEventData as S, type Sentinel as a, base64ToArray as b, createMessageHandlerForContextId as c, getSentinel as d, export_default as e, filterSentinel as f, getBufferDuration as g, isComplete as h, isSentinel as i, getEmitteryCallbacks as j, bufferToWav as k, type ConnectionEventData as l, type StreamRequest as m, playAudioBuffer as p };

package/dist/lib/client.mjs

@@ -1,7 +1,7 @@
 import {
   Client
-} from "../chunk-ERFCRIWU.mjs";
-import "../chunk-35HX6ML3.mjs";
+} from "../chunk-XSFPHPPG.mjs";
+import "../chunk-HNLIBHEN.mjs";
 export {
   Client
 };

package/dist/lib/constants.js

@@ -28,7 +28,7 @@ module.exports = __toCommonJS(constants_exports);
 var BASE_URL = "https://api.cartesia.ai/v0";
 var SAMPLE_RATE = 44100;
 var constructWebsocketUrl = (baseUrl) => {
-  return new URL(`${baseUrl.replace(/^http/, "ws")}/ws`);
+  return new URL(`${baseUrl.replace(/^http/, "ws")}/audio/websocket`);
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/lib/constants.mjs

@@ -2,7 +2,7 @@ import {
   BASE_URL,
   SAMPLE_RATE,
   constructWebsocketUrl
-} from "../chunk-35HX6ML3.mjs";
+} from "../chunk-HNLIBHEN.mjs";
 export {
   BASE_URL,
   SAMPLE_RATE,

package/dist/lib/index.d.mts

@@ -1,7 +1,8 @@
-import { e as export_default } from '../index-Dt9A_pEb.mjs';
+import { e as export_default } from '../index-DSBmfK9-.mjs';
 import { ClientOptions } from '../types/index.mjs';
 import { Client } from './client.mjs';
 import 'emittery';
+import 'partysocket';
 
 declare class Cartesia extends Client {
     audio: export_default;

package/dist/lib/index.d.ts

@@ -1,7 +1,8 @@
-import { e as export_default } from '../index-Ds4LDkmk.js';
+import { e as export_default } from '../index-qwAyxV5I.js';
 import { ClientOptions } from '../types/index.js';
 import { Client } from './client.js';
 import 'emittery';
+import 'partysocket';
 
 declare class Cartesia extends Client {
     audio: export_default;