@cartesia/cartesia-js 1.2.1 → 1.3.0

package/README.md

@@ -92,11 +92,15 @@ const cartesia = new Cartesia({
 const websocket = cartesia.tts.websocket({
 	container: "raw",
 	encoding: "pcm_f32le",
-	sampleRate: 44100
+	sampleRate: 44100,
 });
 
 try {
-	await websocket.connect();
+	await websocket.connect({
+		// If using Node.js, you can pass a custom WebSocket constructor, such as from `ws`.
+		// This is not needed for browser usage, so you can call connect() without any arguments.
+		WebSocket: WS,
+	});
 } catch (error) {
 	console.error(`Failed to connect to Cartesia: ${error}`);
 }

package/dist/{chunk-HQOC2S6C.js → chunk-CJZSHIRI.js}

@@ -1,3 +1,10 @@
+import {
+  Client
+} from "./chunk-FLWYXP5Z.js";
+import {
+  CARTESIA_VERSION,
+  constructApiUrl
+} from "./chunk-2BFEKY3F.js";
 import {
   base64ToArray,
   createMessageHandlerForContextId,
@@ -7,13 +14,6 @@ import {
 import {
   Source
 } from "./chunk-I5YVYTNK.js";
-import {
-  Client
-} from "./chunk-FLWYXP5Z.js";
-import {
-  CARTESIA_VERSION,
-  constructApiUrl
-} from "./chunk-2BFEKY3F.js";
 import {
   __async,
   __privateAdd,
@@ -118,7 +118,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     (_d = this.socket) == null ? void 0 : _d.addEventListener(
@@ -127,7 +128,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     streamCompleteController.signal.addEventListener("abort", () => {
@@ -135,6 +137,7 @@ var WebSocket = class extends Client {
       if (timeoutId) {
         clearTimeout(timeoutId);
       }
+      emitter.clearListeners();
     });
     return __spreadProps(__spreadValues({
       source
@@ -175,16 +178,23 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    return __async(this, null, function* () {
+    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();
-      }));
+      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);

package/dist/{chunk-EYRYHK3X.js → chunk-QT5LHJ3D.js}

@@ -1,6 +1,6 @@
 import {
   WebSocket
-} from "./chunk-HQOC2S6C.js";
+} from "./chunk-CJZSHIRI.js";
 import {
   Client
 } from "./chunk-FLWYXP5Z.js";

package/dist/{chunk-YUGIYUMT.js → chunk-RYHHRY64.js}

@@ -1,12 +1,12 @@
-import {
-  TTS
-} from "./chunk-EYRYHK3X.js";
 import {
   Voices
 } from "./chunk-RJICGVPL.js";
 import {
   VoiceChanger
 } from "./chunk-WLEVU3HN.js";
+import {
+  TTS
+} from "./chunk-QT5LHJ3D.js";
 import {
   Client
 } from "./chunk-FLWYXP5Z.js";

package/dist/index.cjs

@@ -465,7 +465,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     (_d = this.socket) == null ? void 0 : _d.addEventListener(
@@ -474,7 +475,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     streamCompleteController.signal.addEventListener("abort", () => {
@@ -482,6 +484,7 @@ var WebSocket = class extends Client {
       if (timeoutId) {
         clearTimeout(timeoutId);
       }
+      emitter.clearListeners();
     });
     return __spreadProps(__spreadValues({
       source
@@ -522,16 +525,23 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    return __async(this, null, function* () {
+    return __async(this, arguments, function* (options = {}) {
+      if (__privateGet(this, _isConnected)) {
+        throw new Error("WebSocket is already connected.");
+      }
       const emitter = new import_emittery2.default();
-      this.socket = new import_partysocket.WebSocket(() => __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();
-      }));
+      this.socket = new import_partysocket.WebSocket(
+        () => __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);

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 export { Cartesia, Cartesia as default } from './lib/index.cjs';
-export { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.cjs';
+export { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectOptions, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.cjs';
 export { default as WebPlayer } from './tts/player.cjs';
 export { default as Source } from './tts/source.cjs';
 export { default as WebSocket } from './tts/websocket.cjs';
@@ -8,4 +8,5 @@ import './lib/client.cjs';
 import './voice-changer/index.cjs';
 import './voices/index.cjs';
 import 'emittery';
+import 'partysocket/ws';
 import 'partysocket';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Cartesia, Cartesia as default } from './lib/index.js';
-export { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.js';
+export { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectOptions, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps } from './types/index.js';
 export { default as WebPlayer } from './tts/player.js';
 export { default as Source } from './tts/source.js';
 export { default as WebSocket } from './tts/websocket.js';
@@ -8,4 +8,5 @@ import './lib/client.js';
 import './voice-changer/index.js';
 import './voices/index.js';
 import 'emittery';
+import 'partysocket/ws';
 import 'partysocket';

package/dist/index.js

@@ -1,22 +1,22 @@
-import {
-  Player
-} from "./chunk-CSOXALSC.js";
+import "./chunk-FXPGR372.js";
 import {
   Cartesia
-} from "./chunk-YUGIYUMT.js";
-import "./chunk-EYRYHK3X.js";
+} from "./chunk-RYHHRY64.js";
+import "./chunk-RJICGVPL.js";
+import "./chunk-WLEVU3HN.js";
+import "./chunk-QT5LHJ3D.js";
 import {
   WebSocket
-} from "./chunk-HQOC2S6C.js";
+} from "./chunk-CJZSHIRI.js";
+import "./chunk-FLWYXP5Z.js";
+import "./chunk-2BFEKY3F.js";
+import {
+  Player
+} from "./chunk-CSOXALSC.js";
 import "./chunk-5SBAQNWQ.js";
 import {
   Source
 } from "./chunk-I5YVYTNK.js";
-import "./chunk-RJICGVPL.js";
-import "./chunk-FXPGR372.js";
-import "./chunk-WLEVU3HN.js";
-import "./chunk-FLWYXP5Z.js";
-import "./chunk-2BFEKY3F.js";
 import "./chunk-NJDRWDQ3.js";
 export {
   Cartesia,

package/dist/lib/client.d.cts

@@ -1,5 +1,6 @@
 import { ClientOptions } from '../types/index.cjs';
 import 'emittery';
+import 'partysocket/ws';
 
 declare class Client {
     apiKey: () => Promise<string>;

package/dist/lib/client.d.ts

@@ -1,5 +1,6 @@
 import { ClientOptions } from '../types/index.js';
 import 'emittery';
+import 'partysocket/ws';
 
 declare class Client {
     apiKey: () => Promise<string>;

package/dist/lib/index.cjs

@@ -448,7 +448,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     (_d = this.socket) == null ? void 0 : _d.addEventListener(
@@ -457,7 +458,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     streamCompleteController.signal.addEventListener("abort", () => {
@@ -465,6 +467,7 @@ var WebSocket = class extends Client {
       if (timeoutId) {
         clearTimeout(timeoutId);
       }
+      emitter.clearListeners();
     });
     return __spreadProps(__spreadValues({
       source
@@ -505,16 +508,23 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    return __async(this, null, function* () {
+    return __async(this, arguments, function* (options = {}) {
+      if (__privateGet(this, _isConnected)) {
+        throw new Error("WebSocket is already connected.");
+      }
       const emitter = new import_emittery2.default();
-      this.socket = new import_partysocket.WebSocket(() => __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();
-      }));
+      this.socket = new import_partysocket.WebSocket(
+        () => __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);

package/dist/lib/index.d.cts

@@ -7,6 +7,7 @@ import '../tts/websocket.cjs';
 import 'emittery';
 import 'partysocket';
 import '../tts/source.cjs';
+import 'partysocket/ws';
 
 declare class Cartesia extends Client {
     tts: TTS;

package/dist/lib/index.d.ts

@@ -7,6 +7,7 @@ import '../tts/websocket.js';
 import 'emittery';
 import 'partysocket';
 import '../tts/source.js';
+import 'partysocket/ws';
 
 declare class Cartesia extends Client {
     tts: TTS;

package/dist/lib/index.js

@@ -1,14 +1,14 @@
 import {
   Cartesia
-} from "../chunk-YUGIYUMT.js";
-import "../chunk-EYRYHK3X.js";
-import "../chunk-HQOC2S6C.js";
-import "../chunk-5SBAQNWQ.js";
-import "../chunk-I5YVYTNK.js";
+} from "../chunk-RYHHRY64.js";
 import "../chunk-RJICGVPL.js";
 import "../chunk-WLEVU3HN.js";
+import "../chunk-QT5LHJ3D.js";
+import "../chunk-CJZSHIRI.js";
 import "../chunk-FLWYXP5Z.js";
 import "../chunk-2BFEKY3F.js";
+import "../chunk-5SBAQNWQ.js";
+import "../chunk-I5YVYTNK.js";
 import "../chunk-NJDRWDQ3.js";
 export {
   Cartesia

package/dist/react/index.cjs

@@ -462,7 +462,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     (_d = this.socket) == null ? void 0 : _d.addEventListener(
@@ -471,7 +472,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     streamCompleteController.signal.addEventListener("abort", () => {
@@ -479,6 +481,7 @@ var WebSocket = class extends Client {
       if (timeoutId) {
         clearTimeout(timeoutId);
       }
+      emitter.clearListeners();
     });
     return __spreadProps(__spreadValues({
       source
@@ -519,16 +522,23 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    return __async(this, null, function* () {
+    return __async(this, arguments, function* (options = {}) {
+      if (__privateGet(this, _isConnected)) {
+        throw new Error("WebSocket is already connected.");
+      }
       const emitter = new import_emittery2.default();
-      this.socket = new import_partysocket.WebSocket(() => __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();
-      }));
+      this.socket = new import_partysocket.WebSocket(
+        () => __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);

package/dist/react/index.d.cts

@@ -1,6 +1,7 @@
 import Source from '../tts/source.cjs';
 import { StreamRequest } from '../types/index.cjs';
 import 'emittery';
+import 'partysocket/ws';
 
 type UseTTSOptions = {
     apiKey: string | (() => Promise<string>) | null;

package/dist/react/index.d.ts

@@ -1,6 +1,7 @@
 import Source from '../tts/source.js';
 import { StreamRequest } from '../types/index.js';
 import 'emittery';
+import 'partysocket/ws';
 
 type UseTTSOptions = {
     apiKey: string | (() => Promise<string>) | null;

package/dist/react/index.js

@@ -1,20 +1,20 @@
-import {
-  Player
-} from "../chunk-CSOXALSC.js";
 import {
   Cartesia
-} from "../chunk-YUGIYUMT.js";
-import "../chunk-EYRYHK3X.js";
-import "../chunk-HQOC2S6C.js";
-import "../chunk-5SBAQNWQ.js";
-import "../chunk-I5YVYTNK.js";
+} from "../chunk-RYHHRY64.js";
 import "../chunk-RJICGVPL.js";
+import "../chunk-WLEVU3HN.js";
 import {
   pingServer
 } from "../chunk-LKKWJLUG.js";
-import "../chunk-WLEVU3HN.js";
+import "../chunk-QT5LHJ3D.js";
+import "../chunk-CJZSHIRI.js";
 import "../chunk-FLWYXP5Z.js";
 import "../chunk-2BFEKY3F.js";
+import {
+  Player
+} from "../chunk-CSOXALSC.js";
+import "../chunk-5SBAQNWQ.js";
+import "../chunk-I5YVYTNK.js";
 import {
   __async
 } from "../chunk-NJDRWDQ3.js";

package/dist/tts/index.cjs

@@ -448,7 +448,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     (_d = this.socket) == null ? void 0 : _d.addEventListener(
@@ -457,7 +458,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     streamCompleteController.signal.addEventListener("abort", () => {
@@ -465,6 +467,7 @@ var WebSocket = class extends Client {
       if (timeoutId) {
         clearTimeout(timeoutId);
       }
+      emitter.clearListeners();
     });
     return __spreadProps(__spreadValues({
       source
@@ -505,16 +508,23 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    return __async(this, null, function* () {
+    return __async(this, arguments, function* (options = {}) {
+      if (__privateGet(this, _isConnected)) {
+        throw new Error("WebSocket is already connected.");
+      }
       const emitter = new import_emittery2.default();
-      this.socket = new import_partysocket.WebSocket(() => __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();
-      }));
+      this.socket = new import_partysocket.WebSocket(
+        () => __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);

package/dist/tts/index.d.cts

@@ -2,6 +2,7 @@ import { Client } from '../lib/client.cjs';
 import { WebSocketOptions, BytesRequest } from '../types/index.cjs';
 import WebSocket from './websocket.cjs';
 import 'emittery';
+import 'partysocket/ws';
 import 'partysocket';
 import './source.cjs';
 

package/dist/tts/index.d.ts

@@ -2,6 +2,7 @@ import { Client } from '../lib/client.js';
 import { WebSocketOptions, BytesRequest } from '../types/index.js';
 import WebSocket from './websocket.js';
 import 'emittery';
+import 'partysocket/ws';
 import 'partysocket';
 import './source.js';
 

package/dist/tts/index.js

@@ -1,11 +1,11 @@
 import {
   TTS
-} from "../chunk-EYRYHK3X.js";
-import "../chunk-HQOC2S6C.js";
-import "../chunk-5SBAQNWQ.js";
-import "../chunk-I5YVYTNK.js";
+} from "../chunk-QT5LHJ3D.js";
+import "../chunk-CJZSHIRI.js";
 import "../chunk-FLWYXP5Z.js";
 import "../chunk-2BFEKY3F.js";
+import "../chunk-5SBAQNWQ.js";
+import "../chunk-I5YVYTNK.js";
 import "../chunk-NJDRWDQ3.js";
 export {
   TTS as default

package/dist/tts/player.d.cts

@@ -1,6 +1,7 @@
 import Source from './source.cjs';
 import 'emittery';
 import '../types/index.cjs';
+import 'partysocket/ws';
 
 declare class Player {
     #private;

package/dist/tts/player.d.ts

@@ -1,6 +1,7 @@
 import Source from './source.js';
 import 'emittery';
 import '../types/index.js';
+import 'partysocket/ws';
 
 declare class Player {
     #private;

package/dist/tts/source.d.cts

@@ -1,5 +1,6 @@
 import * as emittery from 'emittery';
 import { Encoding, SourceEventData, TypedArray } from '../types/index.cjs';
+import 'partysocket/ws';
 
 type EncodingInfo = {
     arrayType: Float32ArrayConstructor | Int16ArrayConstructor | Uint8ArrayConstructor;

package/dist/tts/source.d.ts

@@ -1,5 +1,6 @@
 import * as emittery from 'emittery';
 import { Encoding, SourceEventData, TypedArray } from '../types/index.js';
+import 'partysocket/ws';
 
 type EncodingInfo = {
     arrayType: Float32ArrayConstructor | Int16ArrayConstructor | Uint8ArrayConstructor;

package/dist/tts/utils.d.cts

@@ -1,5 +1,6 @@
 import emittery__default from 'emittery';
 import { Chunk, TypedArray, WebSocketResponse, Sentinel, EmitteryCallbacks } from '../types/index.cjs';
+import 'partysocket/ws';
 
 /**
  * Convert base64-encoded audio buffer(s) to a TypedArray.

package/dist/tts/utils.d.ts

@@ -1,5 +1,6 @@
 import emittery__default from 'emittery';
 import { Chunk, TypedArray, WebSocketResponse, Sentinel, EmitteryCallbacks } from '../types/index.js';
+import 'partysocket/ws';
 
 /**
  * Convert base64-encoded audio buffer(s) to a TypedArray.

package/dist/tts/websocket.cjs

@@ -446,7 +446,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     (_d = this.socket) == null ? void 0 : _d.addEventListener(
@@ -455,7 +456,8 @@ var WebSocket = class extends Client {
         streamCompleteController.abort();
       },
       {
-        once: true
+        once: true,
+        signal: streamCompleteController.signal
       }
     );
     streamCompleteController.signal.addEventListener("abort", () => {
@@ -463,6 +465,7 @@ var WebSocket = class extends Client {
       if (timeoutId) {
         clearTimeout(timeoutId);
       }
+      emitter.clearListeners();
     });
     return __spreadProps(__spreadValues({
       source
@@ -503,16 +506,23 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    return __async(this, null, function* () {
+    return __async(this, arguments, function* (options = {}) {
+      if (__privateGet(this, _isConnected)) {
+        throw new Error("WebSocket is already connected.");
+      }
       const emitter = new import_emittery2.default();
-      this.socket = new import_partysocket.WebSocket(() => __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();
-      }));
+      this.socket = new import_partysocket.WebSocket(
+        () => __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);

package/dist/tts/websocket.d.cts

@@ -1,8 +1,9 @@
 import * as emittery from 'emittery';
 import { WebSocket as WebSocket$1 } from 'partysocket';
 import { Client } from '../lib/client.cjs';
-import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, ContinueRequest, EmitteryCallbacks, ConnectionEventData } from '../types/index.cjs';
+import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, ContinueRequest, ConnectOptions, EmitteryCallbacks, ConnectionEventData } from '../types/index.cjs';
 import Source from './source.cjs';
+import 'partysocket/ws';
 
 declare class WebSocket extends Client {
     #private;
@@ -59,7 +60,7 @@ declare class WebSocket extends Client {
      * @returns A promise that resolves when the WebSocket is connected.
      * @throws {Error} If the WebSocket fails to connect.
      */
-    connect(): Promise<EmitteryCallbacks<ConnectionEventData>>;
+    connect(options?: ConnectOptions): Promise<EmitteryCallbacks<ConnectionEventData>>;
     /**
      * Disconnect from the Cartesia streaming WebSocket.
      */

package/dist/tts/websocket.d.ts

@@ -1,8 +1,9 @@
 import * as emittery from 'emittery';
 import { WebSocket as WebSocket$1 } from 'partysocket';
 import { Client } from '../lib/client.js';
-import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, ContinueRequest, EmitteryCallbacks, ConnectionEventData } from '../types/index.js';
+import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, ContinueRequest, ConnectOptions, EmitteryCallbacks, ConnectionEventData } from '../types/index.js';
 import Source from './source.js';
+import 'partysocket/ws';
 
 declare class WebSocket extends Client {
     #private;
@@ -59,7 +60,7 @@ declare class WebSocket extends Client {
      * @returns A promise that resolves when the WebSocket is connected.
      * @throws {Error} If the WebSocket fails to connect.
      */
-    connect(): Promise<EmitteryCallbacks<ConnectionEventData>>;
+    connect(options?: ConnectOptions): Promise<EmitteryCallbacks<ConnectionEventData>>;
     /**
      * Disconnect from the Cartesia streaming WebSocket.
      */

package/dist/tts/websocket.js

@@ -1,10 +1,10 @@
 import {
   WebSocket
-} from "../chunk-HQOC2S6C.js";
-import "../chunk-5SBAQNWQ.js";
-import "../chunk-I5YVYTNK.js";
+} from "../chunk-CJZSHIRI.js";
 import "../chunk-FLWYXP5Z.js";
 import "../chunk-2BFEKY3F.js";
+import "../chunk-5SBAQNWQ.js";
+import "../chunk-I5YVYTNK.js";
 import "../chunk-NJDRWDQ3.js";
 export {
   WebSocket as default

package/dist/types/index.d.cts

@@ -1,4 +1,5 @@
 import emittery__default from 'emittery';
+import { Options } from 'partysocket/ws';
 
 interface ClientOptions {
     apiKey?: string | (() => Promise<string>);
@@ -153,6 +154,7 @@ type WebSocketOptions = {
     encoding?: string;
     sampleRate: number;
 };
+type ConnectOptions = Pick<Options, "WebSocket">;
 type SourceEventData = {
     enqueue: never;
     close: never;
@@ -162,4 +164,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectOptions, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 import emittery__default from 'emittery';
+import { Options } from 'partysocket/ws';
 
 interface ClientOptions {
     apiKey?: string | (() => Promise<string>);
@@ -153,6 +154,7 @@ type WebSocketOptions = {
     encoding?: string;
     sampleRate: number;
 };
+type ConnectOptions = Pick<Options, "WebSocket">;
 type SourceEventData = {
     enqueue: never;
     close: never;
@@ -162,4 +164,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectOptions, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };

package/dist/voice-changer/index.d.cts

@@ -1,6 +1,7 @@
 import { Client } from '../lib/client.cjs';
 import { VoiceChangerOptions, VoiceChangerBytesResponse } from '../types/index.cjs';
 import 'emittery';
+import 'partysocket/ws';
 
 declare class VoiceChanger extends Client {
     bytes(options: VoiceChangerOptions): Promise<VoiceChangerBytesResponse>;

package/dist/voice-changer/index.d.ts

@@ -1,6 +1,7 @@
 import { Client } from '../lib/client.js';
 import { VoiceChangerOptions, VoiceChangerBytesResponse } from '../types/index.js';
 import 'emittery';
+import 'partysocket/ws';
 
 declare class VoiceChanger extends Client {
     bytes(options: VoiceChangerOptions): Promise<VoiceChangerBytesResponse>;

package/dist/voices/index.d.cts

@@ -1,6 +1,7 @@
 import { Client } from '../lib/client.cjs';
 import { Voice, CreateVoice, UpdateVoice, CloneOptions, CloneResponse, MixVoicesOptions, MixVoicesResponse, LocalizeOptions, LocalizeResponse } from '../types/index.cjs';
 import 'emittery';
+import 'partysocket/ws';
 
 declare class Voices extends Client {
     list(): Promise<Voice[]>;

package/dist/voices/index.d.ts

@@ -1,6 +1,7 @@
 import { Client } from '../lib/client.js';
 import { Voice, CreateVoice, UpdateVoice, CloneOptions, CloneResponse, MixVoicesOptions, MixVoicesResponse, LocalizeOptions, LocalizeResponse } from '../types/index.js';
 import 'emittery';
+import 'partysocket/ws';
 
 declare class Voices extends Client {
     list(): Promise<Voice[]>;

package/package.json

@@ -4,7 +4,7 @@
 		"name": "Cartesia",
 		"url": "https://cartesia.ai"
 	},
-	"version": "1.2.1",
+	"version": "1.3.0",
 	"description": "Client for the Cartesia API.",
 	"type": "module",
 	"module": "./dist/index.js",

package/src/tts/websocket.ts

@@ -5,6 +5,7 @@ import { Client } from "../lib/client";
 import { CARTESIA_VERSION, constructApiUrl } from "../lib/constants";
 import type {
 	ConnectionEventData,
+	ConnectOptions,
 	ContinueRequest,
 	EmitteryCallbacks,
 	StreamOptions,
@@ -127,6 +128,7 @@ export default class WebSocket extends Client {
 			},
 			{
 				once: true,
+				signal: streamCompleteController.signal,
 			},
 		);
 		this.socket?.addEventListener(
@@ -136,6 +138,7 @@ export default class WebSocket extends Client {
 			},
 			{
 				once: true,
+				signal: streamCompleteController.signal,
 			},
 		);
 		streamCompleteController.signal.addEventListener("abort", () => {
@@ -143,6 +146,7 @@ export default class WebSocket extends Client {
 			if (timeoutId) {
 				clearTimeout(timeoutId);
 			}
+			emitter.clearListeners();
 		});
 
 		return {
@@ -203,16 +207,24 @@ export default class WebSocket extends Client {
 	 * @returns A promise that resolves when the WebSocket is connected.
 	 * @throws {Error} If the WebSocket fails to connect.
 	 */
-	async connect() {
+	async connect(options: ConnectOptions = {}) {
+		if (this.#isConnected) {
+			throw new Error("WebSocket is already connected.");
+		}
+
 		const emitter = new Emittery<ConnectionEventData>();
-		this.socket = new PartySocketWebSocket(async () => {
-			const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-				websocket: true,
-			});
-			url.searchParams.set("api_key", await this.apiKey());
-			url.searchParams.set("cartesia_version", CARTESIA_VERSION);
-			return url.toString();
-		});
+		this.socket = new PartySocketWebSocket(
+			async () => {
+				const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
+					websocket: true,
+				});
+				url.searchParams.set("api_key", await this.apiKey());
+				url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+				return url.toString();
+			},
+			undefined,
+			options,
+		);
 		this.socket.binaryType = "arraybuffer";
 
 		this.socket.onopen = () => {

package/src/types/index.ts

@@ -1,4 +1,5 @@
 import type Emittery from "emittery";
+import type { Options } from "partysocket/ws";
 
 export interface ClientOptions {
 	apiKey?: string | (() => Promise<string>);
@@ -212,6 +213,8 @@ export type WebSocketOptions = {
 	sampleRate: number;
 };
 
+export type ConnectOptions = Pick<Options, "WebSocket">;
+
 export type SourceEventData = {
 	enqueue: never;
 	close: never;