@sayna-ai/node-sdk 0.0.2

package/dist/sayna-client.d.ts

@@ -0,0 +1,303 @@
+import type { STTConfig, TTSConfig, LiveKitConfig, STTResultMessage, ErrorMessage, SaynaMessage, Participant, VoicesResponse, HealthResponse, LiveKitTokenResponse } from "./types";
+/**
+ * Event handler for speech-to-text results.
+ */
+export type STTResultHandler = (result: STTResultMessage) => void | Promise<void>;
+/**
+ * Event handler for text-to-speech audio data.
+ */
+export type TTSAudioHandler = (audio: ArrayBuffer) => void | Promise<void>;
+/**
+ * Event handler for error messages.
+ */
+export type ErrorHandler = (error: ErrorMessage) => void | Promise<void>;
+/**
+ * Event handler for participant messages.
+ */
+export type MessageHandler = (message: SaynaMessage) => void | Promise<void>;
+/**
+ * Event handler for participant disconnections.
+ */
+export type ParticipantDisconnectedHandler = (participant: Participant) => void | Promise<void>;
+/**
+ * Event handler for TTS playback completion.
+ */
+export type TTSPlaybackCompleteHandler = (timestamp: number) => void | Promise<void>;
+/**
+ * Client for connecting to Sayna WebSocket server for real-time voice interactions.
+ *
+ * @example
+ * ```typescript
+ * const client = await saynaConnect(
+ *   "https://api.sayna.ai",
+ *   sttConfig,
+ *   ttsConfig
+ * );
+ *
+ * client.registerOnSttResult((result) => {
+ *   console.log("Transcription:", result.transcript);
+ * });
+ *
+ * await client.speak("Hello, world!");
+ * ```
+ */
+export declare class SaynaClient {
+    private url;
+    private sttConfig;
+    private ttsConfig;
+    private livekitConfig?;
+    private withoutAudio;
+    private websocket?;
+    private isConnected;
+    private isReady;
+    private _livekitRoomName?;
+    private _livekitUrl?;
+    private _saynaParticipantIdentity?;
+    private _saynaParticipantName?;
+    private sttCallback?;
+    private ttsCallback?;
+    private errorCallback?;
+    private messageCallback?;
+    private participantDisconnectedCallback?;
+    private ttsPlaybackCompleteCallback?;
+    private readyPromiseResolve?;
+    private readyPromiseReject?;
+    /**
+     * Creates a new SaynaClient instance.
+     *
+     * @param url - The Sayna server URL (e.g., "https://api.sayna.ai")
+     * @param sttConfig - Speech-to-text configuration
+     * @param ttsConfig - Text-to-speech configuration
+     * @param livekitConfig - Optional LiveKit room configuration
+     * @param withoutAudio - If true, disables audio streaming (default: false)
+     *
+     * @throws {SaynaValidationError} If URL or configurations are invalid
+     */
+    constructor(url: string, sttConfig: STTConfig, ttsConfig: TTSConfig, livekitConfig?: LiveKitConfig, withoutAudio?: boolean);
+    /**
+     * Establishes connection to the Sayna WebSocket server.
+     *
+     * @throws {SaynaConnectionError} If connection fails
+     * @returns Promise that resolves when the connection is ready
+     */
+    connect(): Promise<void>;
+    /**
+     * Handles incoming JSON messages from the WebSocket.
+     * @internal
+     */
+    private handleJsonMessage;
+    /**
+     * Cleans up internal state.
+     * @internal
+     */
+    private cleanup;
+    /**
+     * Converts WebSocket URL to HTTP URL for REST API calls.
+     * @internal
+     */
+    private getHttpUrl;
+    /**
+     * Generic fetch helper for making REST API calls to Sayna server.
+     * Handles URL construction, headers, error responses, and type conversion.
+     * @internal
+     *
+     * @param endpoint - API endpoint path (e.g., "/voices", "/speak")
+     * @param options - Fetch options including method, body, headers, etc.
+     * @param responseType - Expected response type: "json" or "arrayBuffer"
+     * @returns Promise resolving to the parsed response
+     * @throws {SaynaConnectionError} If the network request fails
+     * @throws {SaynaServerError} If the server returns an error response
+     */
+    private fetchFromSayna;
+    /**
+     * Disconnects from the Sayna WebSocket server and cleans up resources.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Sends audio data to the server for speech recognition.
+     *
+     * @param audioData - Raw audio data as ArrayBuffer
+     * @throws {SaynaNotConnectedError} If not connected
+     * @throws {SaynaNotReadyError} If connection is not ready
+     */
+    onAudioInput(audioData: ArrayBuffer): Promise<void>;
+    /**
+     * Registers a callback for speech-to-text results.
+     *
+     * @param callback - Function to call when STT results are received
+     */
+    registerOnSttResult(callback: STTResultHandler): void;
+    /**
+     * Registers a callback for text-to-speech audio data.
+     *
+     * @param callback - Function to call when TTS audio is received
+     */
+    registerOnTtsAudio(callback: TTSAudioHandler): void;
+    /**
+     * Registers a callback for error messages.
+     *
+     * @param callback - Function to call when errors occur
+     */
+    registerOnError(callback: ErrorHandler): void;
+    /**
+     * Registers a callback for participant messages.
+     *
+     * @param callback - Function to call when messages are received
+     */
+    registerOnMessage(callback: MessageHandler): void;
+    /**
+     * Registers a callback for participant disconnection events.
+     *
+     * @param callback - Function to call when a participant disconnects
+     */
+    registerOnParticipantDisconnected(callback: ParticipantDisconnectedHandler): void;
+    /**
+     * Registers a callback for TTS playback completion.
+     *
+     * @param callback - Function to call when TTS playback is complete
+     */
+    registerOnTtsPlaybackComplete(callback: TTSPlaybackCompleteHandler): void;
+    /**
+     * Sends text to be synthesized as speech.
+     *
+     * @param text - Text to synthesize
+     * @param flush - Whether to flush the TTS queue before speaking (default: true)
+     * @param allowInterruption - Whether this speech can be interrupted (default: true)
+     * @throws {SaynaNotConnectedError} If not connected
+     * @throws {SaynaNotReadyError} If connection is not ready
+     * @throws {SaynaValidationError} If text is not a string
+     */
+    speak(text: string, flush?: boolean, allowInterruption?: boolean): Promise<void>;
+    /**
+     * Clears the text-to-speech queue.
+     *
+     * @throws {SaynaNotConnectedError} If not connected
+     * @throws {SaynaNotReadyError} If connection is not ready
+     */
+    clear(): Promise<void>;
+    /**
+     * Flushes the TTS queue by sending an empty speak command.
+     *
+     * @param allowInterruption - Whether the flush can be interrupted (default: true)
+     * @throws {SaynaNotConnectedError} If not connected
+     * @throws {SaynaNotReadyError} If connection is not ready
+     */
+    ttsFlush(allowInterruption?: boolean): Promise<void>;
+    /**
+     * Sends a message to the Sayna session.
+     *
+     * @param message - Message content
+     * @param role - Message role (e.g., "user", "assistant")
+     * @param topic - Optional topic identifier
+     * @param debug - Optional debug metadata
+     * @throws {SaynaNotConnectedError} If not connected
+     * @throws {SaynaNotReadyError} If connection is not ready
+     * @throws {SaynaValidationError} If parameters are invalid
+     */
+    sendMessage(message: string, role: string, topic?: string, debug?: Record<string, unknown>): Promise<void>;
+    /**
+     * Performs a health check on the Sayna server.
+     *
+     * @returns Promise that resolves with the health status
+     * @throws {SaynaConnectionError} If the request fails
+     * @throws {SaynaServerError} If server returns an error
+     *
+     * @example
+     * ```typescript
+     * const health = await client.health();
+     * console.log(health.status); // "OK"
+     * ```
+     */
+    health(): Promise<HealthResponse>;
+    /**
+     * Retrieves the catalogue of text-to-speech voices grouped by provider.
+     *
+     * @returns Promise that resolves with voices organized by provider
+     * @throws {SaynaConnectionError} If the request fails
+     * @throws {SaynaServerError} If server returns an error
+     *
+     * @example
+     * ```typescript
+     * const voices = await client.getVoices();
+     * for (const [provider, voiceList] of Object.entries(voices)) {
+     *   console.log(`${provider}:`, voiceList.map(v => v.name));
+     * }
+     * ```
+     */
+    getVoices(): Promise<VoicesResponse>;
+    /**
+     * Synthesizes text into audio using the REST API endpoint.
+     * This is a standalone synthesis method that doesn't require an active WebSocket connection.
+     *
+     * @param text - Text to synthesize
+     * @param ttsConfig - Text-to-speech configuration
+     * @returns Promise that resolves with the audio data as ArrayBuffer
+     * @throws {SaynaValidationError} If text is empty
+     * @throws {SaynaConnectionError} If the request fails
+     * @throws {SaynaServerError} If server returns an error
+     *
+     * @example
+     * ```typescript
+     * const audioBuffer = await client.speakRest("Hello, world!", {
+     *   provider: "elevenlabs",
+     *   voice_id: "21m00Tcm4TlvDq8ikWAM",
+     *   model: "eleven_turbo_v2",
+     *   speaking_rate: 1.0,
+     *   audio_format: "mp3",
+     *   sample_rate: 24000,
+     *   connection_timeout: 30,
+     *   request_timeout: 60,
+     *   pronunciations: []
+     * });
+     * ```
+     */
+    speakRest(text: string, ttsConfig: TTSConfig): Promise<ArrayBuffer>;
+    /**
+     * Issues a LiveKit access token for a participant.
+     *
+     * @param roomName - LiveKit room to join or create
+     * @param participantName - Display name assigned to the participant
+     * @param participantIdentity - Unique identifier for the participant
+     * @returns Promise that resolves with the LiveKit token and connection details
+     * @throws {SaynaValidationError} If any parameter is empty
+     * @throws {SaynaConnectionError} If the request fails
+     * @throws {SaynaServerError} If server returns an error
+     *
+     * @example
+     * ```typescript
+     * const tokenInfo = await client.getLiveKitToken(
+     *   "my-room",
+     *   "John Doe",
+     *   "user-123"
+     * );
+     * console.log("Token:", tokenInfo.token);
+     * console.log("LiveKit URL:", tokenInfo.livekit_url);
+     * ```
+     */
+    getLiveKitToken(roomName: string, participantName: string, participantIdentity: string): Promise<LiveKitTokenResponse>;
+    /**
+     * Whether the client is ready to send/receive data.
+     */
+    get ready(): boolean;
+    /**
+     * Whether the client is connected to the WebSocket.
+     */
+    get connected(): boolean;
+    /**
+     * LiveKit room name acknowledged by the server, if available.
+     */
+    get livekitRoomName(): string | undefined;
+    /**
+     * LiveKit WebSocket URL configured on the server, if available.
+     */
+    get livekitUrl(): string | undefined;
+    /**
+     * Identity assigned to the agent participant when LiveKit is enabled, if available.
+     */
+    get saynaParticipantIdentity(): string | undefined;
+    /**
+     * Display name assigned to the agent participant when LiveKit is enabled, if available.
+     */
+    get saynaParticipantName(): string | undefined;
+}
+//# sourceMappingURL=sayna-client.d.ts.map

package/dist/sayna-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sayna-client.d.ts","sourceRoot":"","sources":["../src/sayna-client.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Speech-to-Text (STT) configuration options.
+ */
+export interface STTConfig {
+    /** The STT provider to use (e.g., "deepgram", "google") */
+    provider: string;
+    /** Language code for speech recognition (e.g., "en-US", "es-ES") */
+    language: string;
+    /** Audio sample rate in Hz (e.g., 16000, 44100) */
+    sample_rate: number;
+    /** Number of audio channels (1 for mono, 2 for stereo) */
+    channels: number;
+    /** Whether to include punctuation in transcriptions */
+    punctuation: boolean;
+    /** Audio encoding format (e.g., "linear16", "opus") */
+    encoding: string;
+    /** STT model identifier to use */
+    model: string;
+}
+/**
+ * Word pronunciation override for text-to-speech.
+ */
+export interface Pronunciation {
+    /** The word to be pronounced differently */
+    word: string;
+    /** Phonetic pronunciation or alternative spelling */
+    pronunciation: string;
+}
+/**
+ * Text-to-Speech (TTS) configuration options.
+ */
+export interface TTSConfig {
+    /** The TTS provider to use (e.g., "elevenlabs", "google") */
+    provider: string;
+    /** Voice identifier for the selected provider */
+    voice_id: string;
+    /** Speech rate multiplier (e.g., 1.0 for normal, 1.5 for faster) */
+    speaking_rate: number;
+    /** Audio format for TTS output (e.g., "mp3", "pcm") */
+    audio_format: string;
+    /** Audio sample rate in Hz (e.g., 16000, 44100) */
+    sample_rate: number;
+    /** Connection timeout in milliseconds */
+    connection_timeout: number;
+    /** Request timeout in milliseconds */
+    request_timeout: number;
+    /** TTS model identifier to use */
+    model: string;
+    /** Custom pronunciation overrides */
+    pronunciations: Pronunciation[];
+}
+/**
+ * LiveKit room configuration for real-time communication.
+ */
+export interface LiveKitConfig {
+    /** LiveKit room name to join */
+    room_name: string;
+    /** Whether to enable session recording */
+    enable_recording?: boolean;
+    /** Storage key for the recording file (required when enable_recording is true) */
+    recording_file_key?: string;
+    /** Identity assigned to the agent participant (defaults to "sayna-ai") */
+    sayna_participant_identity?: string;
+    /** Display name for the agent participant (defaults to "Sayna AI") */
+    sayna_participant_name?: string;
+    /** Optional list of participant identities to monitor; empty list means "all participants" */
+    listen_participants?: string[];
+}
+/**
+ * Configuration message sent to initialize the Sayna WebSocket connection.
+ * @internal
+ */
+export interface ConfigMessage {
+    type: "config";
+    /** Whether audio streaming is enabled */
+    audio?: boolean;
+    /** Speech-to-text configuration */
+    stt_config: STTConfig;
+    /** Text-to-speech configuration */
+    tts_config: TTSConfig;
+    /** Optional LiveKit room configuration */
+    livekit?: LiveKitConfig;
+}
+/**
+ * Message to request text-to-speech synthesis.
+ * @internal
+ */
+export interface SpeakMessage {
+    type: "speak";
+    /** Text to synthesize */
+    text: string;
+    /** Whether to flush the TTS queue before speaking */
+    flush?: boolean;
+    /** Whether this speech can be interrupted */
+    allow_interruption?: boolean;
+}
+/**
+ * Message to clear the TTS queue.
+ * @internal
+ */
+export interface ClearMessage {
+    type: "clear";
+}
+/**
+ * Message to send data to the Sayna session.
+ * @internal
+ */
+export interface SendMessageMessage {
+    type: "send_message";
+    /** Message content */
+    message: string;
+    /** Message role (e.g., "user", "assistant") */
+    role: string;
+    /** Optional topic identifier */
+    topic?: string;
+    /** Optional debug metadata */
+    debug?: Record<string, unknown>;
+}
+/**
+ * Message received when the Sayna connection is ready.
+ */
+export interface ReadyMessage {
+    type: "ready";
+    /** LiveKit room name acknowledged by the server (present only when LiveKit is enabled) */
+    livekit_room_name?: string;
+    /** LiveKit WebSocket URL configured on the server */
+    livekit_url: string;
+    /** Identity assigned to the agent participant when LiveKit is enabled */
+    sayna_participant_identity?: string;
+    /** Display name assigned to the agent participant when LiveKit is enabled */
+    sayna_participant_name?: string;
+}
+/**
+ * Speech-to-text transcription result.
+ */
+export interface STTResultMessage {
+    type: "stt_result";
+    /** Transcribed text */
+    transcript: string;
+    /** Whether this is a final transcription */
+    is_final: boolean;
+    /** Whether speech has concluded */
+    is_speech_final: boolean;
+    /** Transcription confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Error message from the Sayna server.
+ */
+export interface ErrorMessage {
+    type: "error";
+    /** Error description */
+    message: string;
+}
+/**
+ * Message data from a Sayna session participant.
+ */
+export interface SaynaMessage {
+    /** Message content */
+    message?: string;
+    /** Additional data payload */
+    data?: string;
+    /** Participant identity */
+    identity: string;
+    /** Message topic */
+    topic: string;
+    /** Room identifier */
+    room: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+}
+/**
+ * Wrapper for participant messages.
+ */
+export interface MessageMessage {
+    type: "message";
+    /** The message data */
+    message: SaynaMessage;
+}
+/**
+ * Information about a session participant.
+ */
+export interface Participant {
+    /** Unique participant identity */
+    identity: string;
+    /** Optional display name */
+    name?: string;
+    /** Room identifier */
+    room: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+}
+/**
+ * Message received when a participant disconnects.
+ */
+export interface ParticipantDisconnectedMessage {
+    type: "participant_disconnected";
+    /** The disconnected participant */
+    participant: Participant;
+}
+/**
+ * Message received when the TTS playback is complete.
+ */
+export interface TTSPlaybackCompleteMessage {
+    type: "tts_playback_complete";
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+}
+/**
+ * Union type of all possible messages received from the Sayna server.
+ */
+export type OutgoingMessage = ReadyMessage | STTResultMessage | ErrorMessage | MessageMessage | ParticipantDisconnectedMessage | TTSPlaybackCompleteMessage;
+/**
+ * Voice descriptor returned by the GET /voices endpoint.
+ */
+export interface Voice {
+    /** Provider-specific identifier for the voice profile */
+    id: string;
+    /** URL to a preview audio sample (may be empty) */
+    sample: string;
+    /** Human-readable name supplied by the provider */
+    name: string;
+    /** Detected accent associated with the voice */
+    accent: string;
+    /** Inferred gender label from provider metadata */
+    gender: string;
+    /** Primary language for synthesis */
+    language: string;
+}
+/**
+ * Response from the GET /voices endpoint.
+ * Keys are provider identifiers, values are arrays of voice descriptors.
+ */
+export type VoicesResponse = Record<string, Voice[]>;
+/**
+ * Response from the GET / health check endpoint.
+ */
+export interface HealthResponse {
+    /** Status indicator, always "OK" when successful */
+    status: string;
+}
+/**
+ * Response from the POST /livekit/token endpoint.
+ */
+export interface LiveKitTokenResponse {
+    /** JWT granting LiveKit permissions for the specified participant */
+    token: string;
+    /** Echo of the requested room */
+    room_name: string;
+    /** Echo of the requested identity */
+    participant_identity: string;
+    /** WebSocket endpoint for the LiveKit server */
+    livekit_url: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@sayna-ai/node-sdk",
+  "version": "0.0.2",
+  "description": "Node.js SDK for Sayna.ai server-side WebSocket connections",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "bun run typecheck && bun run lint && bun run build",
+    "prepack": "bun run build"
+  },
+  "keywords": [
+    "sayna",
+    "websocket",
+    "sdk",
+    "server"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@typescript-eslint/eslint-plugin": "^8.46.0",
+    "@typescript-eslint/parser": "^8.46.0",
+    "eslint": "^9.37.0",
+    "prettier": "^3.6.2"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}