@cartesia/cartesia-js 1.0.0 → 1.0.2

package/dist/react/index.d.cts

@@ -1,11 +1,12 @@
 import Source from '../tts/source.cjs';
+import { StreamRequest } from '../types/index.cjs';
 import 'emittery';
-import '../types/index.cjs';
 
 type UseTTSOptions = {
-    apiKey: string | null;
+    apiKey: string | (() => Promise<string>) | null;
     baseUrl?: string;
     sampleRate: number;
+    onError?: (error: Error) => void;
 };
 type PlaybackStatus = "inactive" | "playing" | "paused" | "finished";
 type BufferStatus = "inactive" | "buffering" | "buffered";
@@ -13,7 +14,7 @@ type Metrics = {
     modelLatency: number | null;
 };
 interface UseTTSReturn {
-    buffer: (options: object) => Promise<void>;
+    buffer: (options: StreamRequest) => Promise<void>;
     play: (bufferDuration?: number) => Promise<void>;
     pause: () => Promise<void>;
     resume: () => Promise<void>;
@@ -28,6 +29,6 @@ interface UseTTSReturn {
 /**
  * React hook to use the Cartesia audio API.
  */
-declare function useTTS({ apiKey, baseUrl, sampleRate, }: UseTTSOptions): UseTTSReturn;
+declare function useTTS({ apiKey, baseUrl, sampleRate, onError, }: UseTTSOptions): UseTTSReturn;
 
 export { type BufferStatus, type Metrics, type PlaybackStatus, type UseTTSOptions, type UseTTSReturn, useTTS };

package/dist/react/index.d.ts

@@ -1,11 +1,12 @@
 import Source from '../tts/source.js';
+import { StreamRequest } from '../types/index.js';
 import 'emittery';
-import '../types/index.js';
 
 type UseTTSOptions = {
-    apiKey: string | null;
+    apiKey: string | (() => Promise<string>) | null;
     baseUrl?: string;
     sampleRate: number;
+    onError?: (error: Error) => void;
 };
 type PlaybackStatus = "inactive" | "playing" | "paused" | "finished";
 type BufferStatus = "inactive" | "buffering" | "buffered";
@@ -13,7 +14,7 @@ type Metrics = {
     modelLatency: number | null;
 };
 interface UseTTSReturn {
-    buffer: (options: object) => Promise<void>;
+    buffer: (options: StreamRequest) => Promise<void>;
     play: (bufferDuration?: number) => Promise<void>;
     pause: () => Promise<void>;
     resume: () => Promise<void>;
@@ -28,6 +29,6 @@ interface UseTTSReturn {
 /**
  * React hook to use the Cartesia audio API.
  */
-declare function useTTS({ apiKey, baseUrl, sampleRate, }: UseTTSOptions): UseTTSReturn;
+declare function useTTS({ apiKey, baseUrl, sampleRate, onError, }: UseTTSOptions): UseTTSReturn;
 
 export { type BufferStatus, type Metrics, type PlaybackStatus, type UseTTSOptions, type UseTTSReturn, useTTS };

package/dist/react/index.js

@@ -1,22 +1,22 @@
 import {
   Cartesia
-} from "../chunk-IEN4NCER.js";
-import "../chunk-SGXUEFII.js";
+} from "../chunk-NVOCUUOF.js";
+import "../chunk-UCYL2SOX.js";
 import {
   pingServer
-} from "../chunk-3FL2SNIR.js";
-import "../chunk-F4QWVJY3.js";
-import "../chunk-FN7BK4PS.js";
-import "../chunk-PQ6CIPFW.js";
-import "../chunk-PQ5EVEEH.js";
+} from "../chunk-NQVZNVOU.js";
+import "../chunk-EDAAHENY.js";
+import "../chunk-IZBPLCGW.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import {
   Player
-} from "../chunk-JYLAM6VU.js";
-import "../chunk-RO7TY474.js";
+} from "../chunk-LZO6K34D.js";
+import "../chunk-BHY7MNGT.js";
+import "../chunk-6YQ6KDIQ.js";
 import {
   __async
-} from "../chunk-WIFMLPT5.js";
+} from "../chunk-GHY2WEOK.js";
 
 // src/react/index.ts
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
@@ -25,7 +25,8 @@ var DEFAULT_BUFFER_DURATION = 0.01;
 function useTTS({
   apiKey,
   baseUrl,
-  sampleRate
+  sampleRate,
+  onError
 }) {
   var _a, _b;
   if (typeof window === "undefined") {
@@ -56,7 +57,11 @@ function useTTS({
     }
     const cartesia = new Cartesia({ apiKey, baseUrl });
     baseUrl = baseUrl != null ? baseUrl : cartesia.baseUrl;
-    return cartesia.tts.websocket({ sampleRate });
+    return cartesia.tts.websocket({
+      container: "raw",
+      encoding: "pcm_f32le",
+      sampleRate
+    });
   }, [apiKey, baseUrl, sampleRate]);
   const websocketReturn = useRef(null);
   const player = useRef(null);
@@ -70,20 +75,32 @@ function useTTS({
     (options) => __async(this, null, function* () {
       var _a2, _b2;
       (_a2 = websocketReturn.current) == null ? void 0 : _a2.stop();
-      setMessages([]);
-      setBufferStatus("buffering");
-      websocketReturn.current = (_b2 = websocket == null ? void 0 : websocket.send(options)) != null ? _b2 : null;
-      if (!websocketReturn.current) {
-        return;
+      try {
+        setMessages([]);
+        setBufferStatus("buffering");
+        websocketReturn.current = (_b2 = websocket == null ? void 0 : websocket.send(options)) != null ? _b2 : null;
+        if (!websocketReturn.current) {
+          return;
+        }
+        const unsubscribe = websocketReturn.current.on("message", (message) => {
+          const parsedMessage = JSON.parse(message);
+          setMessages((messages2) => [...messages2, parsedMessage]);
+          if (parsedMessage.error) {
+            onError == null ? void 0 : onError(new Error(parsedMessage.error));
+          }
+        });
+        yield websocketReturn.current.source.once("close");
+        setBufferStatus("buffered");
+        unsubscribe();
+      } catch (error) {
+        if (error instanceof Error) {
+          onError == null ? void 0 : onError(error);
+        } else {
+          console.error(error);
+        }
       }
-      const unsubscribe = websocketReturn.current.on("message", (message) => {
-        setMessages((messages2) => [...messages2, JSON.parse(message)]);
-      });
-      yield websocketReturn.current.source.once("close");
-      setBufferStatus("buffered");
-      unsubscribe();
     }),
-    [websocket]
+    [websocket, onError]
   );
   const metrics = useMemo(() => {
     var _a2;
@@ -152,56 +169,88 @@ function useTTS({
     return () => cleanup == null ? void 0 : cleanup();
   }, [websocket, baseUrl]);
   const play = useCallback(() => __async(this, null, function* () {
-    if (playbackStatus === "playing" || !websocketReturn.current) {
-      return;
-    }
-    if (player.current) {
-      yield player.current.stop();
-    }
-    setPlaybackStatus("playing");
-    const unsubscribes = [];
-    unsubscribes.push(
-      websocketReturn.current.source.on("wait", () => {
-        setIsWaiting(true);
-      })
-    );
-    unsubscribes.push(
-      websocketReturn.current.source.on("read", () => {
-        setIsWaiting(false);
-      })
-    );
-    player.current = new Player({
-      bufferDuration: bufferDuration != null ? bufferDuration : DEFAULT_BUFFER_DURATION
-    });
-    yield player.current.play(websocketReturn.current.source);
-    for (const unsubscribe of unsubscribes) {
-      unsubscribe();
+    try {
+      if (playbackStatus === "playing" || !websocketReturn.current) {
+        return;
+      }
+      if (player.current) {
+        yield player.current.stop();
+      }
+      setPlaybackStatus("playing");
+      const unsubscribes = [];
+      unsubscribes.push(
+        websocketReturn.current.source.on("wait", () => {
+          setIsWaiting(true);
+        })
+      );
+      unsubscribes.push(
+        websocketReturn.current.source.on("read", () => {
+          setIsWaiting(false);
+        })
+      );
+      player.current = new Player({
+        bufferDuration: bufferDuration != null ? bufferDuration : DEFAULT_BUFFER_DURATION
+      });
+      yield player.current.play(websocketReturn.current.source);
+      for (const unsubscribe of unsubscribes) {
+        unsubscribe();
+      }
+      setPlaybackStatus("finished");
+    } catch (error) {
+      if (error instanceof Error) {
+        onError == null ? void 0 : onError(error);
+      } else {
+        console.error(error);
+      }
     }
-    setPlaybackStatus("finished");
-  }), [playbackStatus, bufferDuration]);
+  }), [playbackStatus, bufferDuration, onError]);
   const pause = useCallback(() => __async(this, null, function* () {
     var _a2;
-    yield (_a2 = player.current) == null ? void 0 : _a2.pause();
-    setPlaybackStatus("paused");
-  }), []);
+    try {
+      yield (_a2 = player.current) == null ? void 0 : _a2.pause();
+      setPlaybackStatus("paused");
+    } catch (error) {
+      if (error instanceof Error) {
+        onError == null ? void 0 : onError(error);
+      } else {
+        console.error(error);
+      }
+    }
+  }), [onError]);
   const resume = useCallback(() => __async(this, null, function* () {
     var _a2;
-    yield (_a2 = player.current) == null ? void 0 : _a2.resume();
-    setPlaybackStatus("playing");
-  }), []);
+    try {
+      yield (_a2 = player.current) == null ? void 0 : _a2.resume();
+      setPlaybackStatus("playing");
+    } catch (error) {
+      if (error instanceof Error) {
+        onError == null ? void 0 : onError(error);
+      } else {
+        console.error(error);
+      }
+    }
+  }), [onError]);
   const toggle = useCallback(() => __async(this, null, function* () {
     var _a2;
-    yield (_a2 = player.current) == null ? void 0 : _a2.toggle();
-    setPlaybackStatus((status) => {
-      if (status === "playing") {
-        return "paused";
-      }
-      if (status === "paused") {
-        return "playing";
+    try {
+      yield (_a2 = player.current) == null ? void 0 : _a2.toggle();
+      setPlaybackStatus((status) => {
+        if (status === "playing") {
+          return "paused";
+        }
+        if (status === "paused") {
+          return "playing";
+        }
+        return status;
+      });
+    } catch (error) {
+      if (error instanceof Error) {
+        onError == null ? void 0 : onError(error);
+      } else {
+        console.error(error);
       }
-      return status;
-    });
-  }), []);
+    }
+  }), [onError]);
   return {
     buffer,
     play,

package/dist/react/utils.js

@@ -1,7 +1,7 @@
 import {
   pingServer
-} from "../chunk-3FL2SNIR.js";
-import "../chunk-WIFMLPT5.js";
+} from "../chunk-NQVZNVOU.js";
+import "../chunk-GHY2WEOK.js";
 export {
   pingServer
 };