@cartesia/cartesia-js 2.0.2 → 2.0.4-alpha0

package/wrapper/Websocket.js

@@ -1,3 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -18,17 +42,21 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 var _Websocket_instances, _Websocket_isConnected, _Websocket_sampleRate, _Websocket_container, _Websocket_encoding, _Websocket_generateId;
-import * as core from "../core";
-import * as environments from "../environments";
-import * as serializers from "../serialization";
-import Emittery from "emittery";
-import { humanId } from "human-id";
-import { ReconnectingWebSocket } from "../core/websocket";
-import { base64ToArray, resolveOutputFormat, createMessageHandlerForContextId, getEmitteryCallbacks, isSentinel, } from "./utils";
-import Source from "./source";
-import qs from "qs";
-export default class Websocket {
+Object.defineProperty(exports, "__esModule", { value: true });
+const core = __importStar(require("../core"));
+const environments = __importStar(require("../environments"));
+const serializers = __importStar(require("../serialization"));
+const emittery_1 = __importDefault(require("emittery"));
+const human_id_1 = require("human-id");
+const websocket_1 = require("../core/websocket");
+const utils_1 = require("./utils");
+const source_1 = __importDefault(require("./source"));
+const qs_1 = __importDefault(require("qs"));
+class Websocket {
     constructor({ sampleRate, container, encoding }, options) {
         this.options = options;
         _Websocket_instances.add(this);
@@ -49,69 +77,70 @@ export default class Websocket {
      *                          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 (!__classPrivateFieldGet(this, _Websocket_isConnected, "f")) {
-            throw new Error("Not connected to WebSocket. Call .connect() first.");
-        }
-        if (!inputs.contextId) {
-            inputs.contextId = __classPrivateFieldGet(this, _Websocket_instances, "m", _Websocket_generateId).call(this);
-        }
-        if (!inputs.outputFormat) {
-            inputs.outputFormat = resolveOutputFormat(__classPrivateFieldGet(this, _Websocket_container, "f"), __classPrivateFieldGet(this, _Websocket_encoding, "f"), __classPrivateFieldGet(this, _Websocket_sampleRate, "f"));
-        }
-        (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send(JSON.stringify(serializers.WebSocketTtsRequest.jsonOrThrow(inputs, { unrecognizedObjectKeys: "strip" })));
-        const emitter = new Emittery();
-        const source = new Source({
-            sampleRate: __classPrivateFieldGet(this, _Websocket_sampleRate, "f"),
-            encoding: __classPrivateFieldGet(this, _Websocket_encoding, "f"),
-            container: __classPrivateFieldGet(this, _Websocket_container, "f"),
-        });
-        // Used to signal that the stream is complete, either because the
-        // WebSocket has closed, or because the stream has finished.
-        const streamCompleteController = new AbortController();
-        // Set a timeout.
-        let timeoutId = null;
-        if (timeout > 0) {
-            timeoutId = setTimeout(streamCompleteController.abort, timeout);
-        }
-        const handleMessage = createMessageHandlerForContextId(inputs.contextId, ({ chunk, message, data }) => __awaiter(this, void 0, void 0, function* () {
-            emitter.emit("message", message);
-            if (data.type === "timestamps" && data.wordTimestamps) {
-                emitter.emit("timestamps", data.wordTimestamps);
-                return;
-            }
-            if (isSentinel(chunk)) {
-                yield source.close();
-                streamCompleteController.abort();
-                return;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!__classPrivateFieldGet(this, _Websocket_isConnected, "f")) {
+                throw new Error("Not connected to WebSocket. Call .connect() first.");
             }
-            if (timeoutId) {
-                clearTimeout(timeoutId);
-                timeoutId = setTimeout(streamCompleteController.abort, timeout);
+            if (!inputs.contextId) {
+                inputs.contextId = __classPrivateFieldGet(this, _Websocket_instances, "m", _Websocket_generateId).call(this);
             }
-            if (!chunk) {
-                return;
+            if (!inputs.outputFormat) {
+                inputs.outputFormat = (0, utils_1.resolveOutputFormat)(__classPrivateFieldGet(this, _Websocket_container, "f"), __classPrivateFieldGet(this, _Websocket_encoding, "f"), __classPrivateFieldGet(this, _Websocket_sampleRate, "f"));
             }
-            yield source.enqueue(base64ToArray([chunk], __classPrivateFieldGet(this, _Websocket_encoding, "f")));
-        }));
-        (_b = this.socket) === null || _b === void 0 ? void 0 : _b.addEventListener("message", handleMessage);
-        (_c = this.socket) === null || _c === void 0 ? void 0 : _c.addEventListener("close", () => {
-            streamCompleteController.abort();
-        });
-        (_d = this.socket) === null || _d === void 0 ? void 0 : _d.addEventListener("error", () => {
-            streamCompleteController.abort();
-        });
-        streamCompleteController.signal.addEventListener("abort", () => {
-            source.close();
-            if (timeoutId) {
-                clearTimeout(timeoutId);
+            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send(JSON.stringify(serializers.WebSocketTtsRequest.jsonOrThrow(inputs, { unrecognizedObjectKeys: "strip" })));
+            const emitter = new emittery_1.default();
+            const source = new source_1.default({
+                sampleRate: __classPrivateFieldGet(this, _Websocket_sampleRate, "f"),
+                encoding: __classPrivateFieldGet(this, _Websocket_encoding, "f"),
+                container: __classPrivateFieldGet(this, _Websocket_container, "f"),
+            });
+            // Used to signal that the stream is complete, either because the
+            // WebSocket has closed, or because the stream has finished.
+            const streamCompleteController = new AbortController();
+            // Set a timeout.
+            let timeoutId = null;
+            if (timeout > 0) {
+                timeoutId = setTimeout(streamCompleteController.abort, timeout);
             }
-            emitter.clearListeners();
+            const handleMessage = (0, utils_1.createMessageHandlerForContextId)(inputs.contextId, ({ chunk, message, data }) => __awaiter(this, void 0, void 0, function* () {
+                emitter.emit("message", message);
+                if (data.type === "timestamps" && data.wordTimestamps) {
+                    emitter.emit("timestamps", data.wordTimestamps);
+                    return;
+                }
+                if ((0, utils_1.isSentinel)(chunk)) {
+                    yield source.close();
+                    streamCompleteController.abort();
+                    return;
+                }
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                    timeoutId = setTimeout(streamCompleteController.abort, timeout);
+                }
+                if (!chunk) {
+                    return;
+                }
+                yield source.enqueue((0, utils_1.base64ToArray)([chunk], __classPrivateFieldGet(this, _Websocket_encoding, "f")));
+            }));
+            (_b = this.socket) === null || _b === void 0 ? void 0 : _b.addEventListener("message", handleMessage);
+            (_c = this.socket) === null || _c === void 0 ? void 0 : _c.addEventListener("close", () => {
+                streamCompleteController.abort();
+            });
+            (_d = this.socket) === null || _d === void 0 ? void 0 : _d.addEventListener("error", () => {
+                streamCompleteController.abort();
+            });
+            streamCompleteController.signal.addEventListener("abort", () => {
+                source.close();
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                emitter.clearListeners();
+            });
+            return Object.assign(Object.assign({ source }, (0, utils_1.getEmitteryCallbacks)(emitter)), { stop: streamCompleteController.abort.bind(streamCompleteController) });
         });
-        return Object.assign(Object.assign({ source }, getEmitteryCallbacks(emitter)), { stop: streamCompleteController.abort.bind(streamCompleteController) });
     }
     continue(inputs) {
         var _a;
@@ -122,7 +151,7 @@ export default class Websocket {
             throw new Error("context_id is required to continue a context.");
         }
         if (!inputs.outputFormat) {
-            inputs.outputFormat = resolveOutputFormat(__classPrivateFieldGet(this, _Websocket_container, "f"), __classPrivateFieldGet(this, _Websocket_encoding, "f"), __classPrivateFieldGet(this, _Websocket_sampleRate, "f"));
+            inputs.outputFormat = (0, utils_1.resolveOutputFormat)(__classPrivateFieldGet(this, _Websocket_container, "f"), __classPrivateFieldGet(this, _Websocket_encoding, "f"), __classPrivateFieldGet(this, _Websocket_sampleRate, "f"));
         }
         (_a = this.socket) === null || _a === void 0 ? void 0 : _a.send(JSON.stringify(Object.assign({ continue: true }, serializers.WebSocketTtsRequest.jsonOrThrow(inputs, { unrecognizedObjectKeys: "strip" }))));
     }
@@ -137,15 +166,15 @@ export default class Websocket {
             if (__classPrivateFieldGet(this, _Websocket_isConnected, "f")) {
                 throw new Error("WebSocket is already connected.");
             }
-            const emitter = new Emittery();
-            this.socket = new ReconnectingWebSocket(() => __awaiter(this, void 0, void 0, function* () {
+            const emitter = new emittery_1.default();
+            this.socket = new websocket_1.ReconnectingWebSocket(() => __awaiter(this, void 0, void 0, function* () {
                 var _a;
                 const baseUrl = ((_a = (yield core.Supplier.get(this.options.environment))) !== null && _a !== void 0 ? _a : environments.CartesiaEnvironment.Production).replace(/^https?:\/\//, "");
                 const params = {
                     api_key: this.options.apiKey,
                     cartesia_version: this.options.cartesiaVersion,
                 };
-                return `wss://${baseUrl}/tts/websocket${qs.stringify(params, { addQueryPrefix: true })}`;
+                return `wss://${baseUrl}/tts/websocket${qs_1.default.stringify(params, { addQueryPrefix: true })}`;
             }), undefined, options);
             this.socket.reconnect();
             this.socket.onopen = () => {
@@ -159,7 +188,7 @@ export default class Websocket {
             return new Promise((resolve, reject) => {
                 var _a, _b, _c;
                 (_a = this.socket) === null || _a === void 0 ? void 0 : _a.addEventListener("open", () => {
-                    resolve(getEmitteryCallbacks(emitter));
+                    resolve((0, utils_1.getEmitteryCallbacks)(emitter));
                 });
                 const aborter = new AbortController();
                 (_b = this.socket) === null || _b === void 0 ? void 0 : _b.addEventListener("error", () => {
@@ -181,8 +210,9 @@ export default class Websocket {
         (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();
     }
 }
+exports.default = Websocket;
 _Websocket_isConnected = new WeakMap(), _Websocket_sampleRate = new WeakMap(), _Websocket_container = new WeakMap(), _Websocket_encoding = new WeakMap(), _Websocket_instances = new WeakSet(), _Websocket_generateId = function _Websocket_generateId() {
-    return humanId({
+    return (0, human_id_1.humanId)({
         separator: "-",
         capitalize: false,
     });

package/wrapper/source.d.ts

@@ -1,11 +1,12 @@
+import Emittery from "emittery";
 import { RawEncoding } from "../api";
 import { SourceEventData, TypedArray } from "./utils";
 export default class Source {
     #private;
-    on: <Name extends keyof import("emittery").OmnipresentEventData | keyof SourceEventData>(eventName: Name | readonly Name[], listener: (eventData: (SourceEventData & import("emittery").OmnipresentEventData)[Name]) => void | Promise<void>) => import("emittery").UnsubscribeFunction;
-    once: <Name extends keyof import("emittery").OmnipresentEventData | keyof SourceEventData>(eventName: Name | readonly Name[]) => import("emittery").EmitteryOncePromise<(SourceEventData & import("emittery").OmnipresentEventData)[Name]>;
-    events: <Name extends keyof SourceEventData>(eventName: Name | readonly Name[]) => AsyncIterableIterator<SourceEventData[Name]>;
-    off: <Name extends keyof import("emittery").OmnipresentEventData | keyof SourceEventData>(eventName: Name | readonly Name[], listener: (eventData: (SourceEventData & import("emittery").OmnipresentEventData)[Name]) => void | Promise<void>) => void;
+    on: Emittery<SourceEventData>["on"];
+    once: Emittery<SourceEventData>["once"];
+    events: Emittery<SourceEventData>["events"];
+    off: Emittery<SourceEventData>["off"];
     /**
      * Create a new Source.
      *

package/wrapper/source.js

@@ -1,3 +1,4 @@
+"use strict";
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -18,10 +19,14 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 var _Source_instances, _Source_emitter, _Source_buffer, _Source_readIndex, _Source_writeIndex, _Source_closed, _Source_sampleRate, _Source_encoding, _Source_container, _Source_createBuffer;
-import Emittery from "emittery";
-import { ENCODING_MAP } from "./utils";
-export default class Source {
+Object.defineProperty(exports, "__esModule", { value: true });
+const emittery_1 = __importDefault(require("emittery"));
+const utils_1 = require("./utils");
+class Source {
     /**
      * Create a new Source.
      *
@@ -30,7 +35,7 @@ export default class Source {
      */
     constructor({ sampleRate, encoding, container }) {
         _Source_instances.add(this);
-        _Source_emitter.set(this, new Emittery());
+        _Source_emitter.set(this, new emittery_1.default());
         _Source_buffer.set(this, void 0);
         _Source_readIndex.set(this, 0);
         _Source_writeIndex.set(this, 0);
@@ -41,7 +46,7 @@ export default class Source {
         this.on = __classPrivateFieldGet(this, _Source_emitter, "f").on.bind(__classPrivateFieldGet(this, _Source_emitter, "f"));
         this.once = __classPrivateFieldGet(this, _Source_emitter, "f").once.bind(__classPrivateFieldGet(this, _Source_emitter, "f"));
         this.events = __classPrivateFieldGet(this, _Source_emitter, "f").events.bind(__classPrivateFieldGet(this, _Source_emitter, "f"));
-        this.off = __classPrivateFieldGet(this, _Source_emitter, "f").off.bind(__classPrivateFieldGet(this, _Source_emitter, "f"));
+        this.off = __classPrivateFieldGet(this, _Source_emitter, "f").off.bind(__classPrivateFieldGet(this, _Source_emitter, "f").off);
         __classPrivateFieldSet(this, _Source_sampleRate, sampleRate, "f");
         __classPrivateFieldSet(this, _Source_encoding, encoding, "f");
         __classPrivateFieldSet(this, _Source_container, container, "f");
@@ -167,7 +172,8 @@ export default class Source {
         });
     }
 }
+exports.default = Source;
 _Source_emitter = new WeakMap(), _Source_buffer = new WeakMap(), _Source_readIndex = new WeakMap(), _Source_writeIndex = new WeakMap(), _Source_closed = new WeakMap(), _Source_sampleRate = new WeakMap(), _Source_encoding = new WeakMap(), _Source_container = new WeakMap(), _Source_instances = new WeakSet(), _Source_createBuffer = function _Source_createBuffer(size) {
-    const { arrayType: ArrayType } = ENCODING_MAP[__classPrivateFieldGet(this, _Source_encoding, "f")];
+    const { arrayType: ArrayType } = utils_1.ENCODING_MAP[__classPrivateFieldGet(this, _Source_encoding, "f")];
     return new ArrayType(size);
 };

package/wrapper/utils.js

@@ -1,5 +1,11 @@
-import base64 from "base64-js";
-export const ENCODING_MAP = {
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEmitteryCallbacks = exports.isComplete = exports.filterSentinel = exports.isSentinel = exports.getSentinel = exports.createMessageHandlerForContextId = exports.playAudioBuffer = exports.base64ToArray = exports.resolveOutputFormat = exports.ENCODING_MAP = void 0;
+const base64_js_1 = __importDefault(require("base64-js"));
+exports.ENCODING_MAP = {
     pcm_f32le: { arrayType: Float32Array, bytesPerElement: 4 },
     pcm_s16le: { arrayType: Int16Array, bytesPerElement: 2 },
     pcm_alaw: { arrayType: Uint8Array, bytesPerElement: 1 },
@@ -13,7 +19,7 @@ export const ENCODING_MAP = {
  * @param sampleRate - The sample rate of the audio.
  * @returns The output format for the WebSocket request.
  */
-export function resolveOutputFormat(container, encoding, sampleRate) {
+function resolveOutputFormat(container, encoding, sampleRate) {
     switch (container) {
         case "wav":
             return {
@@ -38,6 +44,7 @@ export function resolveOutputFormat(container, encoding, sampleRate) {
             throw new Error(`Unsupported container type: ${container}`);
     }
 }
+exports.resolveOutputFormat = resolveOutputFormat;
 /**
  * Convert base64-encoded audio buffer(s) to a TypedArray.
  *
@@ -46,9 +53,9 @@ export function resolveOutputFormat(container, encoding, sampleRate) {
  * @param encoding The encoding of the audio buffer(s).
  * @returns The audio buffer(s) as a TypedArray.
  */
-export function base64ToArray(b64, encoding) {
-    const byteArrays = filterSentinel(b64).map((b) => base64.toByteArray(b));
-    const { arrayType: ArrayType, bytesPerElement } = ENCODING_MAP[encoding];
+function base64ToArray(b64, encoding) {
+    const byteArrays = filterSentinel(b64).map((b) => base64_js_1.default.toByteArray(b));
+    const { arrayType: ArrayType, bytesPerElement } = exports.ENCODING_MAP[encoding];
     const totalLength = byteArrays.reduce((acc, arr) => acc + arr.length / bytesPerElement, 0);
     const result = new ArrayType(totalLength);
     let offset = 0;
@@ -59,6 +66,7 @@ export function base64ToArray(b64, encoding) {
     }
     return result;
 }
+exports.base64ToArray = base64ToArray;
 /**
  * Schedule an audio buffer to play at a given time in the passed context.
  *
@@ -68,7 +76,7 @@ export function base64ToArray(b64, encoding) {
  * @param sampleRate The sample rate of the audio.
  * @returns A promise that resolves when the audio has finished playing.
  */
-export function playAudioBuffer(floats, context, startAt, sampleRate) {
+function playAudioBuffer(floats, context, startAt, sampleRate) {
     const source = context.createBufferSource();
     const buffer = context.createBuffer(1, floats.length, sampleRate);
     buffer.getChannelData(0).set(floats);
@@ -81,6 +89,7 @@ export function playAudioBuffer(floats, context, startAt, sampleRate) {
         };
     });
 }
+exports.playAudioBuffer = playAudioBuffer;
 /**
  * Unwraps a chunk of audio data from a message event and calls the
  * handler with it if the context ID matches.
@@ -89,7 +98,7 @@ export function playAudioBuffer(floats, context, startAt, sampleRate) {
  * @param handler The handler to call with the chunk of audio data.
  * @returns A message event handler.
  */
-export function createMessageHandlerForContextId(contextId, handler) {
+function createMessageHandlerForContextId(contextId, handler) {
     return (event) => {
         if (typeof event.data !== "string") {
             return; // Ignore non-string messages.
@@ -109,46 +118,51 @@ export function createMessageHandlerForContextId(contextId, handler) {
         handler({ chunk, message: event.data, data: message });
     };
 }
+exports.createMessageHandlerForContextId = createMessageHandlerForContextId;
 /**
  * Get a sentinel value that indicates the end of a stream.
  * @returns A sentinel value to indicate the end of a stream.
  */
-export function getSentinel() {
+function getSentinel() {
     return null;
 }
+exports.getSentinel = getSentinel;
 /**
  * Check if a chunk is a sentinel value (i.e. null).
  *
  * @param chunk
  * @returns Whether the chunk is a sentinel value.
  */
-export function isSentinel(x) {
+function isSentinel(x) {
     return x === getSentinel();
 }
+exports.isSentinel = isSentinel;
 /**
  * Filter out null values from a collection.
  *
  * @param collection The collection to filter.
  * @returns The collection with null values removed.
  */
-export function filterSentinel(collection) {
+function filterSentinel(collection) {
     return collection.filter((x) => !isSentinel(x));
 }
+exports.filterSentinel = filterSentinel;
 /**
  * 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.
  */
-export function isComplete(chunks) {
+function isComplete(chunks) {
     return isSentinel(chunks[chunks.length - 1]);
 }
+exports.isComplete = isComplete;
 /**
  * Get user-facing emitter callbacks for an Emittery instance.
  * @param emitter The Emittery instance to get callbacks for.
  * @returns User-facing emitter callbacks.
  */
-export function getEmitteryCallbacks(emitter) {
+function getEmitteryCallbacks(emitter) {
     return {
         on: emitter.on.bind(emitter),
         off: emitter.off.bind(emitter),
@@ -156,3 +170,4 @@ export function getEmitteryCallbacks(emitter) {
         events: emitter.events.bind(emitter),
     };
 }
+exports.getEmitteryCallbacks = getEmitteryCallbacks;