@cartesia/cartesia-js 0.0.4-alpha.0 → 1.0.0-alpha.2

package/dist/chunk-4MHF74A7.js

@@ -1,272 +0,0 @@
-import {
-  createMessageHandlerForContextId,
-  getBufferDuration,
-  getEmitteryCallbacks,
-  isComplete,
-  isSentinel,
-  playAudioBuffer
-} from "./chunk-5TSWLYOW.js";
-import {
-  Client
-} from "./chunk-MJIFZWHS.js";
-import {
-  SAMPLE_RATE,
-  constructWebsocketUrl
-} from "./chunk-OVI3W3GG.js";
-import {
-  __async,
-  __forAwait,
-  __spreadValues
-} from "./chunk-R4P7LWVZ.js";
-
-// 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);
-    this.isConnected = false;
-  }
-  /**
-   * Stream audio from a model.
-   *
-   * @param inputs - Stream options. Includes a `model` key and some `parameters`, which
-   * are model-specific and can be found in the model's documentation.
-   * @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 An object with a method `play` of type `(bufferDuration: number) => Promise<void>`
-   * that plays the audio as it arrives, with `bufferDuration` seconds of audio buffered before
-   * starting playback.
-   */
-  stream(inputs, { timeout = 0 } = {}) {
-    var _a, _b, _c, _d;
-    if (!this.isConnected) {
-      throw new Error("Not connected to WebSocket. Call .connect() first.");
-    }
-    const contextId = this.generateId();
-    (_a = this.socket) == null ? void 0 : _a.send(
-      JSON.stringify({
-        data: inputs,
-        context_id: contextId
-      })
-    );
-    const streamCompleteController = new AbortController();
-    let timeoutId = null;
-    if (timeout > 0) {
-      timeoutId = setTimeout(streamCompleteController.abort, timeout);
-    }
-    const chunks = [];
-    const emitter = new Emittery();
-    const handleMessage = createMessageHandlerForContextId(
-      contextId,
-      (_0) => __async(this, [_0], function* ({ chunk, message }) {
-        chunks.push(chunk);
-        yield emitter.emit("chunk", {
-          chunk,
-          chunks
-        });
-        yield emitter.emit("message", message);
-        if (isSentinel(chunk)) {
-          yield emitter.emit("streamed", {
-            chunks
-          });
-          streamCompleteController.abort();
-        } else if (timeoutId) {
-          clearTimeout(timeoutId);
-          timeoutId = setTimeout(streamCompleteController.abort, timeout);
-        }
-      })
-    );
-    (_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
-      }
-    );
-    streamCompleteController.signal.addEventListener("abort", () => {
-      if (timeoutId) {
-        clearTimeout(timeoutId);
-      }
-      emitter.clearListeners();
-    });
-    const play = (_0) => __async(this, [_0], function* ({ bufferDuration }) {
-      const context = new AudioContext({
-        sampleRate: SAMPLE_RATE
-      });
-      let startNextPlaybackAt = 0;
-      const playLatestChunk = (chunk) => {
-        if (isSentinel(chunk)) {
-          return true;
-        }
-        startNextPlaybackAt = playAudioBuffer([chunk], context, startNextPlaybackAt) + Math.max(context.currentTime, startNextPlaybackAt);
-        return false;
-      };
-      const playChunks = (chunks2) => {
-        startNextPlaybackAt += playAudioBuffer(
-          chunks2,
-          context,
-          startNextPlaybackAt
-        );
-        if (isComplete(chunks2)) {
-          return;
-        }
-      };
-      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) {
-              const { chunk } = temp2.value;
-              if (playLatestChunk(chunk)) {
-                break;
-              }
-            }
-          } catch (temp2) {
-            error2 = [temp2];
-          } finally {
-            try {
-              more2 && (temp2 = iter2.return) && (yield temp2.call(iter2));
-            } finally {
-              if (error2)
-                throw error2[0];
-            }
-          }
-          return true;
-        }
-        emitter.emit("buffering");
-        return false;
-      });
-      if (!(yield tryStart(chunks))) {
-        try {
-          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;
-            }
-          }
-        } catch (temp) {
-          error = [temp];
-        } finally {
-          try {
-            more && (temp = iter.return) && (yield temp.call(iter));
-          } finally {
-            if (error)
-              throw error[0];
-          }
-        }
-      } else {
-        const playbackEndsIn = Math.max(0, startNextPlaybackAt - context.currentTime) * 1e3;
-        emitter.emit("scheduled", { playbackEndsIn });
-      }
-    });
-    return __spreadValues({
-      play
-    }, getEmitteryCallbacks(emitter));
-  }
-  /**
-   * 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() {
-    return humanId({
-      separator: "-",
-      capitalize: false
-    });
-  }
-  /**
-   * 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() {
-    const url = constructWebsocketUrl(this.baseUrl);
-    url.searchParams.set("api_key", this.apiKey);
-    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(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();
-  }
-};
-
-export {
-  audio_default
-};

package/dist/chunk-5TSWLYOW.js

@@ -1,113 +0,0 @@
-import {
-  SAMPLE_RATE
-} from "./chunk-OVI3W3GG.js";
-
-// src/audio/utils.ts
-import base64 from "base64-js";
-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(base64.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;
-}
-
-export {
-  getBufferDuration,
-  base64ToArray,
-  playAudioBuffer,
-  createMessageHandlerForContextId,
-  getSentinel,
-  isSentinel,
-  filterSentinel,
-  isComplete,
-  getEmitteryCallbacks,
-  bufferToWav
-};

package/dist/chunk-MJIFZWHS.js

@@ -1,18 +0,0 @@
-import {
-  BASE_URL
-} from "./chunk-OVI3W3GG.js";
-
-// 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;
-  }
-};
-
-export {
-  Client
-};

package/dist/chunk-OVI3W3GG.js

@@ -1,12 +0,0 @@
-// 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-S6A27RQL.js

@@ -1,18 +0,0 @@
-import {
-  audio_default
-} from "./chunk-4MHF74A7.js";
-import {
-  Client
-} from "./chunk-MJIFZWHS.js";
-
-// src/lib/index.ts
-var Cartesia = class extends Client {
-  constructor(options = {}) {
-    super(options);
-    this.audio = new audio_default(options);
-  }
-};
-
-export {
-  Cartesia
-};

package/dist/index-C2_3XFxn.d.cts

@@ -1,163 +0,0 @@
-import * as emittery from 'emittery';
-import emittery__default from 'emittery';
-import { WebSocket } from 'partysocket';
-import { Client } from './lib/client.cjs';
-
-/**
- * Get the duration of base64-encoded audio buffer(s) in seconds.
- *
- * @param b64 The base64-encoded audio buffer, or an array of base64-encoded
- * audio buffers.
- * @returns The duration of the buffer(s) in seconds.
- */
-declare function getBufferDuration(b64: Chunk[]): number;
-/**
- * Convert base64-encoded audio buffer(s) to a Float32Array.
- *
- * @param b64 The base64-encoded audio buffer, or an array of base64-encoded
- * audio buffers.
- * @returns The audio buffer(s) as a Float32Array.
- */
-declare function base64ToArray(b64: Chunk[]): Float32Array;
-/**
- * Schedule an audio buffer to play at a given time in the passed context.
- *
- * @param b64 The base64-encoded audio buffer to play.
- * @param context The audio context to play the buffer in.
- * @param maybeStartAt The time to start playing the buffer at, or null to play
- * immediately.
- * @param onEnded The callback to call when the buffer has finished playing.
- * @returns The duration of the buffer in seconds.
- */
-declare function playAudioBuffer(b64: Chunk[], context: AudioContext, maybeStartAt?: number | null, onEnded?: AudioScheduledSourceNode["onended"]): number;
-/**
- * Unwraps a chunk of audio data from a message event and calls the
- * handler with it if the context ID matches.
- *
- * @param contextId The context ID to listen for.
- * @param handler The handler to call with the chunk of audio data.
- * @returns A message event handler.
- */
-declare function createMessageHandlerForContextId(contextId: string, handler: ({ chunk, message, }: {
-    chunk: Chunk;
-    message: StreamEventData["message"];
-}) => void): (event: MessageEvent) => void;
-type Sentinel = null;
-/**
- * Get a sentinel value that indicates the end of a stream.
- * @returns A sentinel value to indicate the end of a stream.
- */
-declare function getSentinel(): Sentinel;
-/**
- * Check if a chunk is a sentinel value (i.e. null).
- *
- * @param chunk
- * @returns Whether the chunk is a sentinel value.
- */
-declare function isSentinel(x: unknown): x is Sentinel;
-/**
- * Filter out null values from a collection.
- *
- * @param collection The collection to filter.
- * @returns The collection with null values removed.
- */
-declare function filterSentinel<T>(collection: T[]): Exclude<T, Sentinel>[];
-/**
- * Check if an array of chunks is complete by testing if the last chunk is a sentinel
- * value (i.e. null).
- * @param chunk
- * @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 = {
-    chunk: {
-        chunk: Chunk;
-        chunks: Chunk[];
-    };
-    streamed: {
-        chunks: Chunk[];
-    };
-    message: unknown;
-    buffering: never;
-    buffered: never;
-    scheduled: {
-        playbackEndsIn: number;
-    };
-};
-type ConnectionEventData = {
-    open: never;
-    close: never;
-};
-type StreamRequest = {
-    inputs: object;
-    options: {
-        timeout?: number;
-    };
-};
-declare class export_default extends Client {
-    socket?: WebSocket;
-    isConnected: boolean;
-    /**
-     * Stream audio from a model.
-     *
-     * @param inputs - Stream options. Includes a `model` key and some `parameters`, which
-     * are model-specific and can be found in the model's documentation.
-     * @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 An object with a method `play` of type `(bufferDuration: number) => Promise<void>`
-     * that plays the audio as it arrives, with `bufferDuration` seconds of audio buffered before
-     * starting playback.
-     */
-    stream(inputs: StreamRequest["inputs"], { timeout }?: StreamRequest["options"]): {
-        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;
-        }) => Promise<void>;
-    };
-    /**
-     * 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(): string;
-    /**
-     * 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 { 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 };