@cartesia/cartesia-js 0.0.1 → 0.0.2

package/.turbo/turbo-build.log

@@ -1,47 +1,45 @@
-
-$ tsup src/ --format cjs,esm --dts --clean
-CLI Building entry: src/audio/index.ts, src/audio/utils.ts, src/types/index.ts, src/lib/client.ts, src/lib/constants.ts, src/lib/index.ts, src/react/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.0.2
-CLI Target: es6
-CLI Cleaning output folder
-CJS Build start
-ESM Build start
-CJS dist/types/index.js   764.00 B
-CJS dist/lib/index.js     11.67 KB
-CJS dist/lib/constants.js 1.33 KB
-CJS dist/audio/utils.js   3.71 KB
-CJS dist/lib/client.js    1.40 KB
-CJS dist/react/index.js   13.52 KB
-CJS dist/audio/index.js   11.41 KB
-CJS ⚡️ Build success in 44ms
-ESM dist/types/index.mjs    0 B
-ESM dist/audio/utils.mjs    391.00 B
-ESM dist/lib/client.mjs     103.00 B
-ESM dist/lib/constants.mjs  155.00 B
-ESM dist/lib/index.mjs      355.00 B
-ESM dist/chunk-5RMUZJV7.mjs 7.01 KB
-ESM dist/chunk-BTFHUVNH.mjs 1.79 KB
-ESM dist/react/index.mjs    2.08 KB
-ESM dist/audio/index.mjs    192.00 B
-ESM dist/chunk-ERFCRIWU.mjs 386.00 B
-ESM dist/chunk-35HX6ML3.mjs 1.32 KB
-ESM ⚡️ Build success in 44ms
-DTS Build start
-DTS ⚡️ Build success in 3158ms
-DTS dist/lib/constants.d.ts   211.00 B
-DTS dist/lib/index.d.ts       302.00 B
-DTS dist/react/index.d.ts     587.00 B
-DTS dist/lib/client.d.ts      180.00 B
-DTS dist/types/index.d.ts     103.00 B
-DTS dist/audio/utils.d.ts     306.00 B
-DTS dist/audio/index.d.ts     161.00 B
-DTS dist/index-Ds4LDkmk.d.ts  5.28 KB
-DTS dist/lib/constants.d.mts  211.00 B
-DTS dist/lib/index.d.mts      305.00 B
-DTS dist/react/index.d.mts    590.00 B
-DTS dist/lib/client.d.mts     181.00 B
-DTS dist/types/index.d.mts    103.00 B
-DTS dist/audio/utils.d.mts    309.00 B
-DTS dist/audio/index.d.mts    164.00 B
-DTS dist/index-Dt9A_pEb.d.mts 5.29 KB
+$ tsup src/ --format cjs,esm --dts
+CLI Building entry: src/audio/index.ts, src/audio/utils.ts, src/lib/client.ts, src/lib/constants.ts, src/lib/index.ts, src/react/index.ts, src/types/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.0.2
+CLI Target: es6
+CJS Build start
+ESM Build start
+CJS dist/audio/index.js   12.63 KB
+CJS dist/lib/client.js    1.40 KB
+CJS dist/react/index.js   17.16 KB
+CJS dist/types/index.js   764.00 B
+CJS dist/audio/utils.js   5.23 KB
+CJS dist/lib/constants.js 1.35 KB
+CJS dist/lib/index.js     12.89 KB
+CJS ⚡️ Build success in 75ms
+ESM dist/types/index.mjs    0 B
+ESM dist/audio/index.mjs    192.00 B
+ESM dist/audio/utils.mjs    469.00 B
+ESM dist/lib/client.mjs     103.00 B
+ESM dist/lib/constants.mjs  155.00 B
+ESM dist/lib/index.mjs      355.00 B
+ESM dist/react/index.mjs    3.31 KB
+ESM dist/chunk-3CYTAFLF.mjs 7.43 KB
+ESM dist/chunk-FRIBQZPN.mjs 3.22 KB
+ESM dist/chunk-XSFPHPPG.mjs 386.00 B
+ESM dist/chunk-HNLIBHEN.mjs 2.02 KB
+ESM ⚡️ Build success in 80ms
+DTS Build start
+DTS ⚡️ Build success in 5605ms
+DTS dist/lib/constants.d.ts   211.00 B
+DTS dist/lib/index.d.ts       324.00 B
+DTS dist/react/index.d.ts     720.00 B
+DTS dist/lib/client.d.ts      180.00 B
+DTS dist/types/index.d.ts     103.00 B
+DTS dist/audio/utils.d.ts     397.00 B
+DTS dist/audio/index.d.ts     229.00 B
+DTS dist/index-qwAyxV5I.d.ts  6.49 KB
+DTS dist/lib/constants.d.mts  211.00 B
+DTS dist/lib/index.d.mts      327.00 B
+DTS dist/react/index.d.mts    723.00 B
+DTS dist/lib/client.d.mts     181.00 B
+DTS dist/types/index.d.mts    103.00 B
+DTS dist/audio/utils.d.mts    400.00 B
+DTS dist/audio/index.d.mts    232.00 B
+DTS dist/index-DSBmfK9-.d.mts 6.49 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @cartesia/cartesia-js
 
+## 0.0.2
+
+### Patch Changes
+
+- 9a31c66: Improve error handling logic, add connection info, make audio downloadable, add latency metrics, more robust reconnection handling, and misc. changes
+
 ## 0.0.1
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,19 @@
 # JavaScript Client for Cartesia
 
-Usage:
+## Installation
+
+```bash
+# NPM
+npm install @cartesia/cartesia-js
+# Yarn
+yarn add @cartesia/cartesia-js
+# PNPM
+pnpm add @cartesia/cartesia-js
+# Bun
+bun add @cartesia/cartesia-js
+```
+
+## Usage
 
 ```javascript
 import Cartesia from "@cartesia/cartesia-js";
@@ -14,7 +27,7 @@ try {
 }
 
 const stream = await cartesia.audio.stream({
-	model: "echo_tts_v0.0.6",
+	model: "upbeat-moon",
 	options: {
 		transcript: "Hello, world!",
 		chunk_time: 0.1,
@@ -25,6 +38,7 @@ console.log(`Created stream ${stream.id}.`);
 
 stream.on("chunk", ({ chunk, chunks }) => {
 	console.log("Received chunk:", chunk);
+	console.log("All chunks:", chunks);
 });
 
 stream.on("message", ({ message }) => {
@@ -32,6 +46,7 @@ stream.on("message", ({ message }) => {
 	console.log("Received message:", message);
 });
 
+// If you're using the client in the browser, you can play the stream like this:
 console.log("Playing stream...");
 await stream.play();
 console.log("Done playing.");

package/dist/audio/index.d.mts

@@ -1,4 +1,5 @@
 import 'emittery';
+import 'partysocket';
 import '../lib/client.mjs';
-export { C as Chunk, S as StreamEventData, e as default } from '../index-Dt9A_pEb.mjs';
+export { C as Chunk, l as ConnectionEventData, S as StreamEventData, m as StreamRequest, e as default } from '../index-DSBmfK9-.mjs';
 import '../types/index.mjs';

package/dist/audio/index.d.ts

@@ -1,4 +1,5 @@
 import 'emittery';
+import 'partysocket';
 import '../lib/client.js';
-export { C as Chunk, S as StreamEventData, e as default } from '../index-Ds4LDkmk.js';
+export { C as Chunk, l as ConnectionEventData, S as StreamEventData, m as StreamRequest, e as default } from '../index-qwAyxV5I.js';
 import '../types/index.js';

package/dist/audio/index.js

@@ -3,11 +3,25 @@ var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __getProtoOf = Object.getPrototypeOf;
 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 __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -59,12 +73,13 @@ __export(audio_exports, {
 module.exports = __toCommonJS(audio_exports);
 var import_emittery = __toESM(require("emittery"));
 var import_human_id = require("human-id");
+var import_partysocket = require("partysocket");
 
 // src/lib/constants.ts
 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`);
 };
 
 // src/lib/client.ts
@@ -134,6 +149,14 @@ 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)
+  };
+}
 
 // src/audio/index.ts
 var audio_default = class extends Client {
@@ -182,6 +205,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);
@@ -192,13 +218,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 }) {
@@ -272,13 +313,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.
@@ -303,46 +340,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 import_emittery.default();
+    this.socket = new import_partysocket.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/audio/index.mjs

@@ -1,9 +1,9 @@
 import {
   audio_default
-} from "../chunk-5RMUZJV7.mjs";
-import "../chunk-BTFHUVNH.mjs";
-import "../chunk-ERFCRIWU.mjs";
-import "../chunk-35HX6ML3.mjs";
+} from "../chunk-3CYTAFLF.mjs";
+import "../chunk-FRIBQZPN.mjs";
+import "../chunk-XSFPHPPG.mjs";
+import "../chunk-HNLIBHEN.mjs";
 export {
   audio_default as default
 };

package/dist/audio/utils.d.mts

@@ -1,4 +1,5 @@
-export { a as Sentinel, b as base64ToArray, c as createMessageHandlerForContextId, f as filterSentinel, g as getBufferDuration, d as getSentinel, h as isComplete, i as isSentinel, p as playAudioBuffer } from '../index-Dt9A_pEb.mjs';
 import 'emittery';
+export { E as EmitteryCallbacks, a as Sentinel, b as base64ToArray, k as bufferToWav, c as createMessageHandlerForContextId, f as filterSentinel, g as getBufferDuration, j as getEmitteryCallbacks, d as getSentinel, h as isComplete, i as isSentinel, p as playAudioBuffer } from '../index-DSBmfK9-.mjs';
+import 'partysocket';
 import '../lib/client.mjs';
 import '../types/index.mjs';

package/dist/audio/utils.d.ts

@@ -1,4 +1,5 @@
-export { a as Sentinel, b as base64ToArray, c as createMessageHandlerForContextId, f as filterSentinel, g as getBufferDuration, d as getSentinel, h as isComplete, i as isSentinel, p as playAudioBuffer } from '../index-Ds4LDkmk.js';
 import 'emittery';
+export { E as EmitteryCallbacks, a as Sentinel, b as base64ToArray, k as bufferToWav, c as createMessageHandlerForContextId, f as filterSentinel, g as getBufferDuration, j as getEmitteryCallbacks, d as getSentinel, h as isComplete, i as isSentinel, p as playAudioBuffer } from '../index-qwAyxV5I.js';
+import 'partysocket';
 import '../lib/client.js';
 import '../types/index.js';

package/dist/audio/utils.js

@@ -31,9 +31,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var utils_exports = {};
 __export(utils_exports, {
   base64ToArray: () => base64ToArray,
+  bufferToWav: () => bufferToWav,
   createMessageHandlerForContextId: () => createMessageHandlerForContextId,
   filterSentinel: () => filterSentinel,
   getBufferDuration: () => getBufferDuration,
+  getEmitteryCallbacks: () => getEmitteryCallbacks,
   getSentinel: () => getSentinel,
   isComplete: () => isComplete,
   isSentinel: () => isSentinel,
@@ -100,12 +102,54 @@ 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;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   base64ToArray,
+  bufferToWav,
   createMessageHandlerForContextId,
   filterSentinel,
   getBufferDuration,
+  getEmitteryCallbacks,
   getSentinel,
   isComplete,
   isSentinel,

package/dist/audio/utils.mjs

@@ -1,19 +1,23 @@
 import {
   base64ToArray,
+  bufferToWav,
   createMessageHandlerForContextId,
   filterSentinel,
   getBufferDuration,
+  getEmitteryCallbacks,
   getSentinel,
   isComplete,
   isSentinel,
   playAudioBuffer
-} from "../chunk-BTFHUVNH.mjs";
-import "../chunk-35HX6ML3.mjs";
+} from "../chunk-FRIBQZPN.mjs";
+import "../chunk-HNLIBHEN.mjs";
 export {
   base64ToArray,
+  bufferToWav,
   createMessageHandlerForContextId,
   filterSentinel,
   getBufferDuration,
+  getEmitteryCallbacks,
   getSentinel,
   isComplete,
   isSentinel,