@elevenlabs/elevenlabs-js 2.46.0 → 2.48.0

package/wrapper/speech-engine/types.d.ts

@@ -0,0 +1,67 @@
+import type WebSocket from "ws";
+import type { SpeechEngineSession } from "./SpeechEngineSession";
+export interface InitMessage {
+    type: "init";
+    conversation_id: string;
+}
+export interface TranscriptMessage {
+    role: "user" | "agent";
+    content: string;
+}
+export interface UserTranscriptMessage {
+    type: "user_transcript";
+    user_transcript: TranscriptMessage[];
+    event_id?: number;
+}
+export interface PingMessage {
+    type: "ping";
+}
+export interface CloseMessage {
+    type: "close";
+}
+export interface ErrorMessage {
+    type: "error";
+    message: string;
+}
+export type IncomingMessage = InitMessage | UserTranscriptMessage | PingMessage | CloseMessage | ErrorMessage;
+export interface AgentResponseMessage {
+    type: "agent_response";
+    content: string;
+    event_id: number | undefined;
+    is_final: boolean;
+}
+export interface PongMessage {
+    type: "pong";
+}
+export type OutgoingMessage = AgentResponseMessage | PongMessage;
+export interface SpeechEngineEventMap {
+    user_transcript: [transcript: TranscriptMessage[], signal: AbortSignal];
+    init: [conversationId: string];
+    close: [];
+    error: [error: Error];
+    disconnected: [];
+}
+export type SpeechEngineEventName = keyof SpeechEngineEventMap;
+export interface SpeechEngineCallbacks {
+    /** Enable debug logging. */
+    debug?: boolean;
+    /** Fired once when the session is initialized with a conversation ID. */
+    onInit?(conversationId: string, session: SpeechEngineSession): void;
+    /** Fired each time the Speech Engine API sends a user transcript. */
+    onTranscript?(transcript: TranscriptMessage[], signal: AbortSignal, session: SpeechEngineSession): void;
+    /** Fired when ElevenLabs sends a clean close message ending the conversation. */
+    onClose?(session: SpeechEngineSession): void;
+    /** Fired when the underlying WebSocket drops unexpectedly. */
+    onDisconnect?(session: SpeechEngineSession): void;
+    /** Fired on protocol-level or WebSocket-level errors. */
+    onError?(error: Error, session: SpeechEngineSession): void;
+}
+export declare function isAbortError(err: unknown): boolean;
+export interface WebSocketLike {
+    on(event: "message", listener: (data: WebSocket.Data) => void): void;
+    on(event: "close", listener: (code: number, reason: Buffer) => void): void;
+    on(event: "error", listener: (err: Error) => void): void;
+    send(data: string): void;
+    close(): void;
+    readyState: number;
+}

package/wrapper/speech-engine/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAbortError = isAbortError;
+// ---------------------------------------------------------------------------
+// Abort detection
+// ---------------------------------------------------------------------------
+function isAbortError(err) {
+    if (err instanceof DOMException && err.name === "AbortError")
+        return true;
+    if (err instanceof Error && err.name === "AbortError")
+        return true;
+    if (err instanceof Error && /\babort/i.test(err.message))
+        return true;
+    return false;
+}