@cartesia/cartesia-js 2.1.3 → 2.1.5

package/dist/serialization/resources/voices/types/VoiceMetadata.js

@@ -18,13 +18,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VoiceMetadata = void 0;
 const core = __importStar(require("../../../../core"));

package/dist/serialization/resources/voices/types/Weight.js

@@ -18,13 +18,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Weight = void 0;
 const core = __importStar(require("../../../../core"));

package/dist/serialization/resources/voices/types/index.d.ts

@@ -6,6 +6,8 @@ export * from "./CreateVoiceRequest";
 export * from "./UpdateVoiceRequest";
 export * from "./LocalizeTargetLanguage";
 export * from "./LocalizeEnglishDialect";
+export * from "./LocalizeSpanishDialect";
+export * from "./LocalizePortugueseDialect";
 export * from "./LocalizeDialect";
 export * from "./Gender";
 export * from "./LocalizeVoiceRequest";

package/dist/serialization/resources/voices/types/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./CreateVoiceRequest"), exports);
 __exportStar(require("./UpdateVoiceRequest"), exports);
 __exportStar(require("./LocalizeTargetLanguage"), exports);
 __exportStar(require("./LocalizeEnglishDialect"), exports);
+__exportStar(require("./LocalizeSpanishDialect"), exports);
+__exportStar(require("./LocalizePortugueseDialect"), exports);
 __exportStar(require("./LocalizeDialect"), exports);
 __exportStar(require("./Gender"), exports);
 __exportStar(require("./LocalizeVoiceRequest"), exports);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.1.3";
+export declare const SDK_VERSION = "2.1.5";

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "2.1.3";
+exports.SDK_VERSION = "2.1.5";

package/dist/wrapper/WebPlayer.js

@@ -115,8 +115,8 @@ class WebPlayer {
      * @returns A promise that resolves when the audio has been stopped.
      */
     stop() {
-        var _a;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             if (!__classPrivateFieldGet(this, _WebPlayer_context, "f")) {
                 throw new Error("AudioContext not initialized.");
             }

package/dist/wrapper/Websocket.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __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) {
@@ -58,8 +68,8 @@ 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);
+        this.options = options;
         _Websocket_isConnected.set(this, false);
         _Websocket_sampleRate.set(this, void 0);
         _Websocket_container.set(this, void 0);
@@ -78,9 +88,9 @@ class Websocket {
      * @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.
      */
-    send(inputs, { timeout = 0 } = {}) {
-        var _a, _b, _c, _d;
-        return __awaiter(this, void 0, void 0, function* () {
+    send(inputs_1) {
+        return __awaiter(this, arguments, void 0, function* (inputs, { timeout = 0 } = {}) {
+            var _a, _b, _c, _d;
             if (!__classPrivateFieldGet(this, _Websocket_isConnected, "f")) {
                 throw new Error("Not connected to WebSocket. Call .connect() first.");
             }
@@ -105,7 +115,7 @@ class Websocket {
             if (timeout > 0) {
                 timeoutId = setTimeout(streamCompleteController.abort, timeout);
             }
-            const handleMessage = (0, utils_1.createMessageHandlerForContextId)(inputs.contextId, ({ chunk, message, data }) => __awaiter(this, void 0, void 0, function* () {
+            const handleMessage = (0, utils_1.createMessageHandlerForContextId)(inputs.contextId, (_a) => __awaiter(this, [_a], void 0, function* ({ chunk, message, data }) {
                 emitter.emit("message", message);
                 if (data.type === "timestamps" && data.wordTimestamps) {
                     emitter.emit("timestamps", data.wordTimestamps);
@@ -161,8 +171,8 @@ class Websocket {
      * @returns A promise that resolves when the WebSocket is connected.
      * @throws {Error} If the WebSocket fails to connect.
      */
-    connect(options = {}) {
-        return __awaiter(this, void 0, void 0, function* () {
+    connect() {
+        return __awaiter(this, arguments, void 0, function* (options = {}) {
             if (__classPrivateFieldGet(this, _Websocket_isConnected, "f")) {
                 throw new Error("WebSocket is already connected.");
             }
@@ -210,10 +220,10 @@ 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 (0, human_id_1.humanId)({
         separator: "-",
         capitalize: false,
     });
 };
+exports.default = Websocket;

package/dist/wrapper/source.js

@@ -172,8 +172,8 @@ 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 } = utils_1.ENCODING_MAP[__classPrivateFieldGet(this, _Source_encoding, "f")];
     return new ArrayType(size);
 };
+exports.default = Source;

package/dist/wrapper/utils.d.ts

@@ -1,31 +1,31 @@
 import type Emittery from "emittery";
 import type { OutputFormat, RawEncoding, WebSocketResponse } from "../api";
-export declare type EmitteryCallbacks<T> = {
+export type EmitteryCallbacks<T> = {
     on: Emittery<T>["on"];
     off: Emittery<T>["off"];
     once: Emittery<T>["once"];
     events: Emittery<T>["events"];
 };
-export declare type ConnectionEventData = {
+export type ConnectionEventData = {
     open: never;
     close: never;
 };
-export declare type SourceEventData = {
+export type SourceEventData = {
     enqueue: never;
     close: never;
     wait: never;
     read: never;
 };
-export declare type TypedArray = Float32Array | Int16Array | Uint8Array;
-export declare type Sentinel = null;
-export declare type Chunk = string | Sentinel;
-export declare type WebSocketOptions = {
+export type TypedArray = Float32Array | Int16Array | Uint8Array;
+export type Sentinel = null;
+export type Chunk = string | Sentinel;
+export type WebSocketOptions = {
     container?: string;
     encoding?: string;
     sampleRate: number;
 };
-export declare type Language = "en" | "es" | "fr" | "de" | "ja" | "zh" | "pt" | (string & {});
-export declare type EncodingInfo = {
+export type Language = "en" | "es" | "fr" | "de" | "ja" | "zh" | "pt" | (string & {});
+export type EncodingInfo = {
     arrayType: Float32ArrayConstructor | Int16ArrayConstructor | Uint8ArrayConstructor;
     bytesPerElement: number;
 };

package/dist/wrapper/utils.js

@@ -3,7 +3,16 @@ 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;
+exports.ENCODING_MAP = void 0;
+exports.resolveOutputFormat = resolveOutputFormat;
+exports.base64ToArray = base64ToArray;
+exports.playAudioBuffer = playAudioBuffer;
+exports.createMessageHandlerForContextId = createMessageHandlerForContextId;
+exports.getSentinel = getSentinel;
+exports.isSentinel = isSentinel;
+exports.filterSentinel = filterSentinel;
+exports.isComplete = isComplete;
+exports.getEmitteryCallbacks = getEmitteryCallbacks;
 const base64_js_1 = __importDefault(require("base64-js"));
 exports.ENCODING_MAP = {
     pcm_f32le: { arrayType: Float32Array, bytesPerElement: 4 },
@@ -44,7 +53,6 @@ function resolveOutputFormat(container, encoding, sampleRate) {
             throw new Error(`Unsupported container type: ${container}`);
     }
 }
-exports.resolveOutputFormat = resolveOutputFormat;
 /**
  * Convert base64-encoded audio buffer(s) to a TypedArray.
  *
@@ -66,7 +74,6 @@ function base64ToArray(b64, encoding) {
     }
     return result;
 }
-exports.base64ToArray = base64ToArray;
 /**
  * Schedule an audio buffer to play at a given time in the passed context.
  *
@@ -89,7 +96,6 @@ 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.
@@ -118,7 +124,6 @@ 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.
@@ -126,7 +131,6 @@ exports.createMessageHandlerForContextId = createMessageHandlerForContextId;
 function getSentinel() {
     return null;
 }
-exports.getSentinel = getSentinel;
 /**
  * Check if a chunk is a sentinel value (i.e. null).
  *
@@ -136,7 +140,6 @@ exports.getSentinel = getSentinel;
 function isSentinel(x) {
     return x === getSentinel();
 }
-exports.isSentinel = isSentinel;
 /**
  * Filter out null values from a collection.
  *
@@ -146,7 +149,6 @@ exports.isSentinel = isSentinel;
 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).
@@ -156,7 +158,6 @@ exports.filterSentinel = filterSentinel;
 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.
@@ -170,4 +171,3 @@ function getEmitteryCallbacks(emitter) {
         events: emitter.events.bind(emitter),
     };
 }
-exports.getEmitteryCallbacks = getEmitteryCallbacks;

package/environments.d.ts

@@ -4,4 +4,4 @@
 export declare const CartesiaEnvironment: {
     readonly Production: "https://api.cartesia.ai";
 };
-export declare type CartesiaEnvironment = typeof CartesiaEnvironment.Production;
+export type CartesiaEnvironment = typeof CartesiaEnvironment.Production;

package/errors/CartesiaError.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CartesiaError = void 0;
+const json_1 = require("../core/json");
 class CartesiaError extends Error {
     constructor({ message, statusCode, body }) {
         super(buildMessage({ message, statusCode, body }));
@@ -26,7 +27,7 @@ function buildMessage({ message, statusCode, body, }) {
         lines.push(`Status code: ${statusCode.toString()}`);
     }
     if (body != null) {
-        lines.push(`Body: ${JSON.stringify(body, undefined, 2)}`);
+        lines.push(`Body: ${(0, json_1.toJson)(body, undefined, 2)}`);
     }
     return lines.join("\n");
 }

package/errors/CartesiaTimeoutError.d.ts

@@ -2,5 +2,5 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export declare class CartesiaTimeoutError extends Error {
-    constructor();
+    constructor(message: string);
 }

package/errors/CartesiaTimeoutError.js

@@ -5,8 +5,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CartesiaTimeoutError = void 0;
 class CartesiaTimeoutError extends Error {
-    constructor() {
-        super("Timeout");
+    constructor(message) {
+        super(message);
         Object.setPrototypeOf(this, CartesiaTimeoutError.prototype);
     }
 }

package/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CartesiaTimeoutError = exports.CartesiaError = exports.CartesiaEnvironment = exports.WebPlayer = exports.CartesiaClient = exports.Cartesia = void 0;
 exports.Cartesia = __importStar(require("./api"));

package/{jest.config.js → jest.config.mjs}

@@ -1,5 +1,8 @@
 /** @type {import('jest').Config} */
-module.exports = {
+export default {
     preset: "ts-jest",
     testEnvironment: "node",
+    moduleNameMapper: {
+        "(.+)\.js$": "$1",
+    },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cartesia/cartesia-js",
-    "version": "2.1.3",
+    "version": "2.1.5",
     "private": false,
     "repository": "https://github.com/cartesia-ai/cartesia-js",
     "main": "./index.js",
@@ -15,8 +15,8 @@
         "url-join": "4.0.1",
         "form-data": "^4.0.0",
         "formdata-node": "^6.0.3",
-        "node-fetch": "2.7.0",
-        "qs": "6.11.2",
+        "node-fetch": "^2.7.0",
+        "qs": "^6.13.1",
         "readable-stream": "^4.5.2",
         "form-data-encoder": "^4.0.2",
         "emittery": "^0.13.1",
@@ -25,19 +25,18 @@
     },
     "devDependencies": {
         "@types/url-join": "4.0.1",
-        "@types/qs": "6.9.8",
-        "@types/node-fetch": "2.6.9",
-        "@types/readable-stream": "^4.0.15",
-        "fetch-mock-jest": "^1.5.1",
-        "webpack": "^5.94.0",
-        "ts-loader": "^9.3.1",
-        "jest": "29.7.0",
-        "@types/jest": "29.5.5",
-        "ts-jest": "29.1.1",
-        "jest-environment-jsdom": "29.7.0",
-        "@types/node": "17.0.33",
-        "prettier": "2.7.1",
-        "typescript": "4.6.4",
+        "@types/qs": "^6.9.17",
+        "@types/node-fetch": "^2.6.12",
+        "@types/readable-stream": "^4.0.18",
+        "webpack": "^5.97.1",
+        "ts-loader": "^9.5.1",
+        "jest": "^29.7.0",
+        "@types/jest": "^29.5.14",
+        "ts-jest": "^29.1.1",
+        "jest-environment-jsdom": "^29.7.0",
+        "@types/node": "^18.19.70",
+        "prettier": "^3.4.2",
+        "typescript": "~5.7.2",
         "@types/ws": "^8.5.13"
     },
     "browser": {

package/reference.md

@@ -246,6 +246,103 @@ await client.datasets.uploadFile(fs.createReadStream("/path/to/your/file"), "str
 </dl>
 </details>
 
+## Infill
+
+<details><summary><code>client.infill.<a href="/src/api/resources/infill/client/Client.ts">bytes</a>(leftAudio, rightAudio, { ...params }) -> stream.Readable</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Generate audio that smoothly connects two existing audio segments. This is useful for inserting new speech between existing speech segments while maintaining natural transitions.
+
+The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.
+
+Only the `sonic-preview` model is supported for infill at this time.
+
+At least one of `left_audio` or `right_audio` must be provided.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.infill.bytes(fs.createReadStream("/path/to/your/file"), fs.createReadStream("/path/to/your/file"), {
+    modelId: "sonic-preview",
+    language: "en",
+    transcript: "middle segment",
+    voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+    outputFormatContainer: "mp3",
+    outputFormatSampleRate: 44100,
+    outputFormatBitRate: 128000,
+    voiceExperimentalControlsSpeed: "slowest",
+    voiceExperimentalControlsEmotion: ["surprise:high", "curiosity:high"],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**leftAudio:** `File | fs.ReadStream | Blob`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**rightAudio:** `File | fs.ReadStream | Blob`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Cartesia.InfillBytesRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Infill.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Tts
 
 <details><summary><code>client.tts.<a href="/src/api/resources/tts/client/Client.ts">bytes</a>({ ...params }) -> stream.Readable</code></summary>
@@ -584,7 +681,6 @@ await client.voices.create({
         1, 1, 1, 1, 1, 1, 1,
     ],
     language: "en",
-    baseVoiceId: "string",
 });
 ```