@cartesia/cartesia-js 0.0.3 → 0.0.4-alpha.0

package/dist/audio/utils.js

@@ -1,149 +1,4 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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);
-
-// src/audio/utils.ts
-var utils_exports = {};
-__export(utils_exports, {
-  base64ToArray: () => base64ToArray,
-  bufferToWav: () => bufferToWav,
-  createMessageHandlerForContextId: () => createMessageHandlerForContextId,
-  filterSentinel: () => filterSentinel,
-  getBufferDuration: () => getBufferDuration,
-  getEmitteryCallbacks: () => getEmitteryCallbacks,
-  getSentinel: () => getSentinel,
-  isComplete: () => isComplete,
-  isSentinel: () => isSentinel,
-  playAudioBuffer: () => playAudioBuffer
-});
-module.exports = __toCommonJS(utils_exports);
-var import_base64_js = __toESM(require("base64-js"));
-
-// src/lib/constants.ts
-var SAMPLE_RATE = 44100;
-
-// src/audio/utils.ts
-function getBufferDuration(b64) {
-  const floats = base64ToArray(b64);
-  return floats.length / SAMPLE_RATE;
-}
-function base64ToArray(b64) {
-  return filterSentinel(b64).reduce((acc, b) => {
-    const floats = new Float32Array(import_base64_js.default.toByteArray(b).buffer);
-    const newAcc = new Float32Array(acc.length + floats.length);
-    newAcc.set(acc, 0);
-    newAcc.set(floats, acc.length);
-    return newAcc;
-  }, new Float32Array(0));
-}
-function playAudioBuffer(b64, context, maybeStartAt = null, onEnded = null) {
-  const startAt = maybeStartAt != null ? maybeStartAt : context.currentTime;
-  const floats = base64ToArray(b64);
-  const source = context.createBufferSource();
-  const buffer = context.createBuffer(1, floats.length, SAMPLE_RATE);
-  buffer.getChannelData(0).set(floats);
-  source.buffer = buffer;
-  source.connect(context.destination);
-  source.start(startAt);
-  source.onended = onEnded;
-  return buffer.duration;
-}
-function createMessageHandlerForContextId(contextId, handler) {
-  return (event) => {
-    const message = JSON.parse(event.data);
-    if (message.context_id !== contextId) {
-      return;
-    }
-    let chunk;
-    if (message.done) {
-      chunk = getSentinel();
-    } else {
-      chunk = message.data;
-    }
-    handler({ chunk, message });
-  };
-}
-function getSentinel() {
-  return null;
-}
-function isSentinel(x) {
-  return x === getSentinel();
-}
-function filterSentinel(collection) {
-  return collection.filter(
-    (x) => !isSentinel(x)
-  );
-}
-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 = {
+import {
   base64ToArray,
   bufferToWav,
   createMessageHandlerForContextId,
@@ -154,4 +9,18 @@ function bufferToWav(sampleRate, channelBuffers) {
   isComplete,
   isSentinel,
   playAudioBuffer
-});
+} from "../chunk-5TSWLYOW.js";
+import "../chunk-OVI3W3GG.js";
+import "../chunk-R4P7LWVZ.js";
+export {
+  base64ToArray,
+  bufferToWav,
+  createMessageHandlerForContextId,
+  filterSentinel,
+  getBufferDuration,
+  getEmitteryCallbacks,
+  getSentinel,
+  isComplete,
+  isSentinel,
+  playAudioBuffer
+};

package/dist/{chunk-3CYTAFLF.mjs → chunk-4MHF74A7.js}

@@ -5,17 +5,19 @@ import {
   isComplete,
   isSentinel,
   playAudioBuffer
-} from "./chunk-FRIBQZPN.mjs";
+} from "./chunk-5TSWLYOW.js";
 import {
   Client
-} from "./chunk-XSFPHPPG.mjs";
+} from "./chunk-MJIFZWHS.js";
 import {
   SAMPLE_RATE,
+  constructWebsocketUrl
+} from "./chunk-OVI3W3GG.js";
+import {
   __async,
   __forAwait,
-  __spreadValues,
-  constructWebsocketUrl
-} from "./chunk-HNLIBHEN.mjs";
+  __spreadValues
+} from "./chunk-R4P7LWVZ.js";
 
 // src/audio/index.ts
 import Emittery from "emittery";
@@ -129,10 +131,12 @@ var audio_default = class extends Client {
       const tryStart = (chunks2) => __async(this, null, function* () {
         startNextPlaybackAt = context.currentTime;
         if (isComplete(chunks2) || streamCompleteController.signal.aborted) {
+          emitter.emit("buffered");
           playChunks(chunks2);
           return true;
         }
         if (getBufferDuration(chunks2) > bufferDuration) {
+          emitter.emit("buffered");
           playChunks(chunks2);
           try {
             for (var iter2 = __forAwait(emitter.events("chunk")), more2, temp2, error2; more2 = !(temp2 = yield iter2.next()).done; more2 = false) {
@@ -153,6 +157,7 @@ var audio_default = class extends Client {
           }
           return true;
         }
+        emitter.emit("buffering");
         return false;
       });
       if (!(yield tryStart(chunks))) {
@@ -160,6 +165,8 @@ var audio_default = class extends Client {
           for (var iter = __forAwait(emitter.events("chunk")), more, temp, error; more = !(temp = yield iter.next()).done; more = false) {
             const { chunks: chunks2 } = temp.value;
             if (yield tryStart(chunks2)) {
+              const playbackEndsIn = Math.max(0, startNextPlaybackAt - context.currentTime) * 1e3;
+              emitter.emit("scheduled", { playbackEndsIn });
               break;
             }
           }
@@ -173,6 +180,9 @@ var audio_default = class extends Client {
               throw error[0];
           }
         }
+      } else {
+        const playbackEndsIn = Math.max(0, startNextPlaybackAt - context.currentTime) * 1e3;
+        emitter.emit("scheduled", { playbackEndsIn });
       }
     });
     return __spreadValues({

package/dist/{chunk-FRIBQZPN.mjs → chunk-5TSWLYOW.js}

@@ -1,6 +1,6 @@
 import {
   SAMPLE_RATE
-} from "./chunk-HNLIBHEN.mjs";
+} from "./chunk-OVI3W3GG.js";
 
 // src/audio/utils.ts
 import base64 from "base64-js";

package/dist/{chunk-XSFPHPPG.mjs → chunk-MJIFZWHS.js}

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

package/dist/chunk-OVI3W3GG.js

@@ -0,0 +1,12 @@
+// 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")}/audio/websocket`);
+};
+
+export {
+  BASE_URL,
+  SAMPLE_RATE,
+  constructWebsocketUrl
+};

package/dist/{chunk-HNLIBHEN.mjs → chunk-R4P7LWVZ.js}

@@ -39,18 +39,8 @@ var __async = (__this, __arguments, generator) => {
 };
 var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")]) ? it.call(obj) : (obj = obj[__knownSymbol("iterator")](), it = {}, method = (key, fn) => (fn = obj[key]) && (it[key] = (arg) => new Promise((yes, no, done) => (arg = fn.call(obj, arg), done = arg.done, Promise.resolve(arg.value).then((value) => yes({ value, done }), no)))), method("next"), method("return"), it);
 
-// 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")}/audio/websocket`);
-};
-
 export {
   __spreadValues,
   __async,
-  __forAwait,
-  BASE_URL,
-  SAMPLE_RATE,
-  constructWebsocketUrl
+  __forAwait
 };

package/dist/{lib/index.mjs → chunk-S6A27RQL.js}

@@ -1,11 +1,9 @@
 import {
   audio_default
-} from "../chunk-3CYTAFLF.mjs";
-import "../chunk-FRIBQZPN.mjs";
+} from "./chunk-4MHF74A7.js";
 import {
   Client
-} from "../chunk-XSFPHPPG.mjs";
-import "../chunk-HNLIBHEN.mjs";
+} from "./chunk-MJIFZWHS.js";
 
 // src/lib/index.ts
 var Cartesia = class extends Client {
@@ -14,6 +12,7 @@ var Cartesia = class extends Client {
     this.audio = new audio_default(options);
   }
 };
+
 export {
   Cartesia
 };

package/dist/chunk-XPIMIAAE.js

@@ -0,0 +1,17 @@
+import {
+  __async
+} from "./chunk-R4P7LWVZ.js";
+
+// src/react/utils.ts
+function pingServer(url) {
+  return __async(this, null, function* () {
+    const start = (/* @__PURE__ */ new Date()).getTime();
+    yield fetch(url);
+    const end = (/* @__PURE__ */ new Date()).getTime();
+    return end - start;
+  });
+}
+
+export {
+  pingServer
+};

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

@@ -1,7 +1,7 @@
 import * as emittery from 'emittery';
 import emittery__default from 'emittery';
 import { WebSocket } from 'partysocket';
-import { Client } from './lib/client.mjs';
+import { Client } from './lib/client.cjs';
 
 /**
  * Get the duration of base64-encoded audio buffer(s) in seconds.
@@ -98,6 +98,11 @@ type StreamEventData = {
         chunks: Chunk[];
     };
     message: unknown;
+    buffering: never;
+    buffered: never;
+    scheduled: {
+        playbackEndsIn: number;
+    };
 };
 type ConnectionEventData = {
     open: never;
@@ -125,9 +130,9 @@ declare class export_default extends Client {
      * starting playback.
      */
     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]>;
+        on: <Name extends keyof emittery.OmnipresentEventData | keyof StreamEventData>(eventName: Name | readonly Name[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
+        off: <Name_1 extends keyof emittery.OmnipresentEventData | keyof StreamEventData>(eventName: Name_1 | readonly Name_1[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
+        once: <Name_2 extends keyof emittery.OmnipresentEventData | keyof StreamEventData>(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;

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

@@ -98,6 +98,11 @@ type StreamEventData = {
         chunks: Chunk[];
     };
     message: unknown;
+    buffering: never;
+    buffered: never;
+    scheduled: {
+        playbackEndsIn: number;
+    };
 };
 type ConnectionEventData = {
     open: never;
@@ -125,9 +130,9 @@ declare class export_default extends Client {
      * starting playback.
      */
     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]>;
+        on: <Name extends keyof emittery.OmnipresentEventData | keyof StreamEventData>(eventName: Name | readonly Name[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
+        off: <Name_1 extends keyof emittery.OmnipresentEventData | keyof StreamEventData>(eventName: Name_1 | readonly Name_1[], listener: (eventData: (StreamEventData & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
+        once: <Name_2 extends keyof emittery.OmnipresentEventData | keyof StreamEventData>(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;