@cartesia/cartesia-js 1.3.0 → 2.0.0

package/dist/chunk-CJZSHIRI.js

@@ -1,274 +0,0 @@
-import {
-  Client
-} from "./chunk-FLWYXP5Z.js";
-import {
-  CARTESIA_VERSION,
-  constructApiUrl
-} from "./chunk-2BFEKY3F.js";
-import {
-  base64ToArray,
-  createMessageHandlerForContextId,
-  getEmitteryCallbacks,
-  isSentinel
-} from "./chunk-5SBAQNWQ.js";
-import {
-  Source
-} from "./chunk-I5YVYTNK.js";
-import {
-  __async,
-  __privateAdd,
-  __privateGet,
-  __privateMethod,
-  __privateSet,
-  __spreadProps,
-  __spreadValues
-} from "./chunk-NJDRWDQ3.js";
-
-// src/tts/websocket.ts
-import Emittery from "emittery";
-import { humanId } from "human-id";
-import { WebSocket as PartySocketWebSocket } from "partysocket";
-var _isConnected, _sampleRate, _container, _encoding, _WebSocket_instances, generateId_fn;
-var WebSocket = class extends Client {
-  /**
-   * Create a new WebSocket client.
-   *
-   * @param args - Arguments to pass to the Client constructor.
-   */
-  constructor({ sampleRate, container, encoding }, ...args) {
-    super(...args);
-    __privateAdd(this, _WebSocket_instances);
-    __privateAdd(this, _isConnected, false);
-    __privateAdd(this, _sampleRate);
-    __privateAdd(this, _container);
-    __privateAdd(this, _encoding);
-    __privateSet(this, _sampleRate, sampleRate);
-    __privateSet(this, _container, container != null ? container : "raw");
-    __privateSet(this, _encoding, encoding != null ? encoding : "pcm_f32le");
-  }
-  /**
-   * Send a message over the WebSocket to start a stream.
-   *
-   * @param inputs - Generation parameters. Defined in the StreamRequest type.
-   * @param options - Options for the stream.
-   * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
-   *                          If set to `0`, the stream will not time out.
-   * @returns A Source object that can be passed to a Player to play the audio.
-   * @returns An Emittery instance that emits messages from the WebSocket.
-   * @returns An abort function that can be called to cancel the stream.
-   */
-  send(inputs, { timeout = 0 } = {}) {
-    var _a, _b, _c, _d;
-    if (!__privateGet(this, _isConnected)) {
-      throw new Error("Not connected to WebSocket. Call .connect() first.");
-    }
-    if (!inputs.context_id) {
-      inputs.context_id = __privateMethod(this, _WebSocket_instances, generateId_fn).call(this);
-    }
-    if (!inputs.output_format) {
-      inputs.output_format = {
-        container: __privateGet(this, _container),
-        encoding: __privateGet(this, _encoding),
-        sample_rate: __privateGet(this, _sampleRate)
-      };
-    }
-    (_a = this.socket) == null ? void 0 : _a.send(
-      JSON.stringify(__spreadValues({}, inputs))
-    );
-    const emitter = new Emittery();
-    const source = new Source({
-      sampleRate: __privateGet(this, _sampleRate),
-      encoding: __privateGet(this, _encoding),
-      container: __privateGet(this, _container)
-    });
-    const streamCompleteController = new AbortController();
-    let timeoutId = null;
-    if (timeout > 0) {
-      timeoutId = setTimeout(streamCompleteController.abort, timeout);
-    }
-    const handleMessage = createMessageHandlerForContextId(
-      inputs.context_id,
-      (_0) => __async(this, [_0], function* ({ chunk, message, data }) {
-        emitter.emit("message", message);
-        if (data.type === "timestamps") {
-          emitter.emit("timestamps", data.word_timestamps);
-          return;
-        }
-        if (isSentinel(chunk)) {
-          yield source.close();
-          streamCompleteController.abort();
-          return;
-        }
-        if (timeoutId) {
-          clearTimeout(timeoutId);
-          timeoutId = setTimeout(streamCompleteController.abort, timeout);
-        }
-        if (!chunk) {
-          return;
-        }
-        yield source.enqueue(base64ToArray([chunk], __privateGet(this, _encoding)));
-      })
-    );
-    (_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,
-        signal: streamCompleteController.signal
-      }
-    );
-    (_d = this.socket) == null ? void 0 : _d.addEventListener(
-      "error",
-      () => {
-        streamCompleteController.abort();
-      },
-      {
-        once: true,
-        signal: streamCompleteController.signal
-      }
-    );
-    streamCompleteController.signal.addEventListener("abort", () => {
-      source.close();
-      if (timeoutId) {
-        clearTimeout(timeoutId);
-      }
-      emitter.clearListeners();
-    });
-    return __spreadProps(__spreadValues({
-      source
-    }, getEmitteryCallbacks(emitter)), {
-      stop: streamCompleteController.abort.bind(streamCompleteController)
-    });
-  }
-  /**
-   * Continue a stream.
-   *
-   * @param inputs - Generation parameters. Defined in the StreamRequest type, but must include a `context_id` field. `continue` is set to true by default.
-   */
-  continue(inputs) {
-    var _a;
-    if (!__privateGet(this, _isConnected)) {
-      throw new Error("Not connected to WebSocket. Call .connect() first.");
-    }
-    if (!inputs.context_id) {
-      throw new Error("context_id is required to continue a context.");
-    }
-    if (!inputs.output_format) {
-      inputs.output_format = {
-        container: __privateGet(this, _container),
-        encoding: __privateGet(this, _encoding),
-        sample_rate: __privateGet(this, _sampleRate)
-      };
-    }
-    (_a = this.socket) == null ? void 0 : _a.send(
-      JSON.stringify(__spreadValues({
-        continue: true
-      }, inputs))
-    );
-  }
-  /**
-   * 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() {
-    return __async(this, arguments, function* (options = {}) {
-      if (__privateGet(this, _isConnected)) {
-        throw new Error("WebSocket is already connected.");
-      }
-      const emitter = new Emittery();
-      this.socket = new PartySocketWebSocket(
-        () => __async(this, null, function* () {
-          const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-            websocket: true
-          });
-          url.searchParams.set("api_key", yield this.apiKey());
-          url.searchParams.set("cartesia_version", CARTESIA_VERSION);
-          return url.toString();
-        }),
-        void 0,
-        options
-      );
-      this.socket.binaryType = "arraybuffer";
-      this.socket.onopen = () => {
-        __privateSet(this, _isConnected, true);
-        emitter.emit("open");
-      };
-      this.socket.onclose = () => {
-        __privateSet(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(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.
-   */
-  disconnect() {
-    var _a;
-    (_a = this.socket) == null ? void 0 : _a.close();
-  }
-};
-_isConnected = new WeakMap();
-_sampleRate = new WeakMap();
-_container = new WeakMap();
-_encoding = new WeakMap();
-_WebSocket_instances = new WeakSet();
-/**
- * Generate a unique ID suitable for a streaming context.
- *
- * Not suitable for security purposes or as a primary key, since
- * it lacks the amount of entropy required for those use cases.
- *
- * @returns A unique ID.
- */
-generateId_fn = function() {
-  return humanId({
-    separator: "-",
-    capitalize: false
-  });
-};
-
-export {
-  WebSocket
-};

package/dist/chunk-CSOXALSC.js

@@ -1,132 +0,0 @@
-import {
-  playAudioBuffer
-} from "./chunk-5SBAQNWQ.js";
-import {
-  __async,
-  __privateAdd,
-  __privateGet,
-  __privateMethod,
-  __privateSet
-} from "./chunk-NJDRWDQ3.js";
-
-// src/tts/player.ts
-var _context, _startNextPlaybackAt, _bufferDuration, _Player_instances, playBuffer_fn;
-var Player = class {
-  /**
-   * Create a new Player.
-   *
-   * @param options - Options for the Player.
-   * @param options.bufferDuration - The duration of the audio buffer to play.
-   */
-  constructor({ bufferDuration }) {
-    __privateAdd(this, _Player_instances);
-    __privateAdd(this, _context, null);
-    __privateAdd(this, _startNextPlaybackAt, 0);
-    __privateAdd(this, _bufferDuration);
-    __privateSet(this, _bufferDuration, bufferDuration);
-  }
-  /**
-   * Play audio from a source.
-   *
-   * @param source The source to play audio from.
-   * @returns A promise that resolves when the audio has finished playing.
-   */
-  play(source) {
-    return __async(this, null, function* () {
-      __privateSet(this, _startNextPlaybackAt, 0);
-      __privateSet(this, _context, new AudioContext({ sampleRate: source.sampleRate }));
-      const buffer = new Float32Array(
-        source.durationToSampleCount(__privateGet(this, _bufferDuration))
-      );
-      const plays = [];
-      while (true) {
-        const read = yield source.read(buffer);
-        const playableAudio = buffer.subarray(0, read);
-        plays.push(__privateMethod(this, _Player_instances, playBuffer_fn).call(this, playableAudio, source.sampleRate));
-        if (read < buffer.length) {
-          break;
-        }
-      }
-      yield Promise.all(plays);
-    });
-  }
-  /**
-   * Pause the audio.
-   *
-   * @returns A promise that resolves when the audio has been paused.
-   */
-  pause() {
-    return __async(this, null, function* () {
-      if (!__privateGet(this, _context)) {
-        throw new Error("AudioContext not initialized.");
-      }
-      yield __privateGet(this, _context).suspend();
-    });
-  }
-  /**
-   * Resume the audio.
-   *
-   * @returns A promise that resolves when the audio has been resumed.
-   */
-  resume() {
-    return __async(this, null, function* () {
-      if (!__privateGet(this, _context)) {
-        throw new Error("AudioContext not initialized.");
-      }
-      yield __privateGet(this, _context).resume();
-    });
-  }
-  /**
-   * Toggle the audio.
-   *
-   * @returns A promise that resolves when the audio has been toggled.
-   */
-  toggle() {
-    return __async(this, null, function* () {
-      if (!__privateGet(this, _context)) {
-        throw new Error("AudioContext not initialized.");
-      }
-      if (__privateGet(this, _context).state === "running") {
-        yield this.pause();
-      } else {
-        yield this.resume();
-      }
-    });
-  }
-  /**
-   * Stop the audio.
-   *
-   * @returns A promise that resolves when the audio has been stopped.
-   */
-  stop() {
-    return __async(this, null, function* () {
-      var _a;
-      if (!__privateGet(this, _context)) {
-        throw new Error("AudioContext not initialized.");
-      }
-      yield (_a = __privateGet(this, _context)) == null ? void 0 : _a.close();
-    });
-  }
-};
-_context = new WeakMap();
-_startNextPlaybackAt = new WeakMap();
-_bufferDuration = new WeakMap();
-_Player_instances = new WeakSet();
-playBuffer_fn = function(buf, sampleRate) {
-  return __async(this, null, function* () {
-    if (!__privateGet(this, _context)) {
-      throw new Error("AudioContext not initialized.");
-    }
-    if (buf.length === 0) {
-      return;
-    }
-    const startAt = __privateGet(this, _startNextPlaybackAt);
-    const duration = buf.length / sampleRate;
-    __privateSet(this, _startNextPlaybackAt, duration + Math.max(__privateGet(this, _context).currentTime, __privateGet(this, _startNextPlaybackAt)));
-    yield playAudioBuffer(buf, __privateGet(this, _context), startAt, sampleRate);
-  });
-};
-
-export {
-  Player
-};

package/dist/chunk-FLWYXP5Z.js

@@ -1,40 +0,0 @@
-import {
-  BASE_URL,
-  CARTESIA_VERSION,
-  constructApiUrl
-} from "./chunk-2BFEKY3F.js";
-import {
-  __async,
-  __spreadProps,
-  __spreadValues
-} from "./chunk-NJDRWDQ3.js";
-
-// src/lib/client.ts
-import fetch from "cross-fetch";
-var Client = class {
-  constructor(options = {}) {
-    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
-    if (!apiKey) {
-      throw new Error("Missing Cartesia API key.");
-    }
-    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
-      return apiKey;
-    });
-    this.baseUrl = options.baseUrl || BASE_URL;
-  }
-  _fetch(_0) {
-    return __async(this, arguments, function* (path, options = {}) {
-      const url = constructApiUrl(this.baseUrl, path);
-      const headers = new Headers(options.headers);
-      headers.set("X-API-Key", yield this.apiKey());
-      headers.set("Cartesia-Version", CARTESIA_VERSION);
-      return fetch(url.toString(), __spreadProps(__spreadValues({}, options), {
-        headers
-      }));
-    });
-  }
-};
-
-export {
-  Client
-};

package/dist/chunk-I5YVYTNK.js

@@ -1,190 +0,0 @@
-import {
-  __async,
-  __privateAdd,
-  __privateGet,
-  __privateMethod,
-  __privateSet
-} from "./chunk-NJDRWDQ3.js";
-
-// src/tts/source.ts
-import Emittery from "emittery";
-var ENCODING_MAP = {
-  pcm_f32le: { arrayType: Float32Array, bytesPerElement: 4 },
-  pcm_s16le: { arrayType: Int16Array, bytesPerElement: 2 },
-  pcm_alaw: { arrayType: Uint8Array, bytesPerElement: 1 },
-  pcm_mulaw: { arrayType: Uint8Array, bytesPerElement: 1 }
-};
-var _emitter, _buffer, _readIndex, _writeIndex, _closed, _sampleRate, _encoding, _container, _Source_instances, createBuffer_fn;
-var Source = class {
-  /**
-   * Create a new Source.
-   *
-   * @param options - Options for the Source.
-   * @param options.sampleRate - The sample rate of the audio.
-   */
-  constructor({
-    sampleRate,
-    encoding,
-    container
-  }) {
-    __privateAdd(this, _Source_instances);
-    __privateAdd(this, _emitter, new Emittery());
-    __privateAdd(this, _buffer);
-    __privateAdd(this, _readIndex, 0);
-    __privateAdd(this, _writeIndex, 0);
-    __privateAdd(this, _closed, false);
-    __privateAdd(this, _sampleRate);
-    __privateAdd(this, _encoding);
-    __privateAdd(this, _container);
-    this.on = __privateGet(this, _emitter).on.bind(__privateGet(this, _emitter));
-    this.once = __privateGet(this, _emitter).once.bind(__privateGet(this, _emitter));
-    this.events = __privateGet(this, _emitter).events.bind(__privateGet(this, _emitter));
-    this.off = __privateGet(this, _emitter).off.bind(__privateGet(this, _emitter));
-    __privateSet(this, _sampleRate, sampleRate);
-    __privateSet(this, _encoding, encoding);
-    __privateSet(this, _container, container);
-    __privateSet(this, _buffer, __privateMethod(this, _Source_instances, createBuffer_fn).call(this, 1024));
-  }
-  get sampleRate() {
-    return __privateGet(this, _sampleRate);
-  }
-  get encoding() {
-    return __privateGet(this, _encoding);
-  }
-  get container() {
-    return __privateGet(this, _container);
-  }
-  /**
-   * Append audio to the buffer.
-   *
-   * @param src The audio to append.
-   */
-  enqueue(src) {
-    return __async(this, null, function* () {
-      const requiredCapacity = __privateGet(this, _writeIndex) + src.length;
-      if (requiredCapacity > __privateGet(this, _buffer).length) {
-        let newCapacity = __privateGet(this, _buffer).length;
-        while (newCapacity < requiredCapacity) {
-          newCapacity *= 2;
-        }
-        const newBuffer = __privateMethod(this, _Source_instances, createBuffer_fn).call(this, newCapacity);
-        newBuffer.set(__privateGet(this, _buffer));
-        __privateSet(this, _buffer, newBuffer);
-      }
-      __privateGet(this, _buffer).set(src, __privateGet(this, _writeIndex));
-      __privateSet(this, _writeIndex, __privateGet(this, _writeIndex) + src.length);
-      yield __privateGet(this, _emitter).emit("enqueue");
-    });
-  }
-  /**
-   * Read audio from the buffer.
-   *
-   * @param dst The buffer to read the audio into.
-   * @returns The number of samples read. If the source is closed, this will be
-   * less than the length of the provided buffer.
-   */
-  read(dst) {
-    return __async(this, null, function* () {
-      const targetReadIndex = __privateGet(this, _readIndex) + dst.length;
-      while (!__privateGet(this, _closed) && targetReadIndex > __privateGet(this, _writeIndex)) {
-        yield __privateGet(this, _emitter).emit("wait");
-        yield Promise.race([
-          __privateGet(this, _emitter).once("enqueue"),
-          __privateGet(this, _emitter).once("close")
-        ]);
-        yield __privateGet(this, _emitter).emit("read");
-      }
-      const read = Math.min(dst.length, __privateGet(this, _writeIndex) - __privateGet(this, _readIndex));
-      dst.set(__privateGet(this, _buffer).subarray(__privateGet(this, _readIndex), __privateGet(this, _readIndex) + read));
-      __privateSet(this, _readIndex, __privateGet(this, _readIndex) + read);
-      return read;
-    });
-  }
-  /**
-   * Seek in the buffer.
-   *
-   * @param offset The offset to seek to.
-   * @param whence The position to seek from.
-   * @returns The new position in the buffer.
-   * @throws {Error} If the seek is invalid.
-   */
-  seek(offset, whence) {
-    return __async(this, null, function* () {
-      let position = __privateGet(this, _readIndex);
-      switch (whence) {
-        case "start":
-          position = offset;
-          break;
-        case "current":
-          position += offset;
-          break;
-        case "end":
-          position = __privateGet(this, _writeIndex) + offset;
-          break;
-        default:
-          throw new Error(`Invalid seek mode: ${whence}`);
-      }
-      if (position < 0 || position > __privateGet(this, _writeIndex)) {
-        throw new Error("Seek out of bounds");
-      }
-      __privateSet(this, _readIndex, position);
-      return position;
-    });
-  }
-  /**
-   * Get the number of samples in a given duration.
-   *
-   * @param durationSecs The duration in seconds.
-   * @returns The number of samples.
-   */
-  durationToSampleCount(durationSecs) {
-    return Math.trunc(durationSecs * __privateGet(this, _sampleRate));
-  }
-  get buffer() {
-    return __privateGet(this, _buffer);
-  }
-  get readIndex() {
-    return __privateGet(this, _readIndex);
-  }
-  get writeIndex() {
-    return __privateGet(this, _writeIndex);
-  }
-  /**
-   * Close the source. This signals that no more audio will be enqueued.
-   *
-   * This will emit a "close" event.
-   *
-   * @returns A promise that resolves when the source is closed.
-   */
-  close() {
-    return __async(this, null, function* () {
-      __privateSet(this, _closed, true);
-      yield __privateGet(this, _emitter).emit("close");
-      __privateGet(this, _emitter).clearListeners();
-    });
-  }
-};
-_emitter = new WeakMap();
-_buffer = new WeakMap();
-_readIndex = new WeakMap();
-_writeIndex = new WeakMap();
-_closed = new WeakMap();
-_sampleRate = new WeakMap();
-_encoding = new WeakMap();
-_container = new WeakMap();
-_Source_instances = new WeakSet();
-/**
- * Create a new buffer for the source.
- *
- * @param size - The size of the buffer to create.
- * @returns The new buffer as a TypedArray based on the encoding.
- */
-createBuffer_fn = function(size) {
-  const { arrayType: ArrayType } = ENCODING_MAP[__privateGet(this, _encoding)];
-  return new ArrayType(size);
-};
-
-export {
-  ENCODING_MAP,
-  Source
-};

package/dist/chunk-LKKWJLUG.js

@@ -1,17 +0,0 @@
-import {
-  __async
-} from "./chunk-NJDRWDQ3.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
-};