@azure/ai-voicelive 1.0.0-alpha.20251117.2

package/dist/commonjs/voiceLiveSession.js

@@ -0,0 +1,433 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceLiveSession = void 0;
+const connectionManager_js_1 = require("./websocket/connectionManager.js");
+const websocketFactory_js_1 = require("./websocket/websocketFactory.js");
+const messageParser_js_1 = require("./protocol/messageParser.js");
+const credentialHandler_js_1 = require("./auth/credentialHandler.js");
+const index_js_1 = require("./errors/index.js");
+const logger_js_1 = require("./logger.js");
+const subscriptionManager_js_1 = require("./handlers/subscriptionManager.js");
+/**
+ * Represents a WebSocket-based session for real-time voice communication with the Azure VoiceLive service.
+ *
+ * This class manages the connection, handles real-time communication, and provides access to all
+ * interactive features including audio streaming, conversation management, and avatar control.
+ */
+class VoiceLiveSession {
+    _endpoint;
+    _credentialHandler;
+    _options;
+    _messageParser;
+    _model;
+    _connectionManager;
+    _sessionId;
+    _activeTurnId;
+    _disposed = false;
+    // Handler-based subscription management
+    _subscriptionManager;
+    /**
+     * Creates an instance of VoiceLiveSession.
+     *
+     * @param endpoint - The Voice Live service endpoint URL
+     * @param credential - Azure TokenCredential or KeyCredential for authentication
+     * @param apiVersion - API version to use for the Voice Live service
+     * @param model - The model name to use for the session
+     * @param options - Optional configuration for the session
+     */
+    constructor(endpoint, credential, apiVersion, model, options = {}) {
+        this._endpoint = this._normalizeEndpoint(endpoint);
+        this._credentialHandler = new credentialHandler_js_1.CredentialHandler(credential);
+        this._options = this._buildDefaultOptions(options);
+        this._messageParser = new messageParser_js_1.VoiceLiveMessageParser();
+        this._model = model;
+        // Initialize handler-based subscription management
+        this._subscriptionManager = new subscriptionManager_js_1.SubscriptionManager();
+        logger_js_1.logger.info("VoiceLiveSession created", {
+            endpoint: this._endpoint,
+            model: this._model,
+            apiVersion: apiVersion,
+            enableDebugLogging: this._options.enableDebugLogging,
+        });
+    }
+    /**
+     * Establishes connection to the Voice Live service with authentication.
+     */
+    async connect(options = {}) {
+        this._ensureNotDisposed();
+        if (this.isConnected) {
+            logger_js_1.logger.info("VoiceLiveSession already connected");
+            return;
+        }
+        try {
+            logger_js_1.logger.info("Connecting to Voice Live service", {
+                endpoint: this._endpoint,
+                model: this._model,
+            });
+            // Get WebSocket URL with authentication and model
+            const wsUrl = await this._credentialHandler.getWebSocketUrl(this._endpoint, "2025-10-01", // TODO: make this configurable through constructor
+            this._model);
+            const authHeaders = await this._credentialHandler.getAuthHeaders();
+            // Create connection manager
+            const websocketFactory = new websocketFactory_js_1.VoiceLiveWebSocketFactory();
+            this._connectionManager = new connectionManager_js_1.ConnectionManager(() => websocketFactory.create({
+                headers: { ...authHeaders },
+                connectionTimeoutInMs: this._options.connectionTimeoutInMs,
+                compression: true,
+            }), {
+                endpoint: wsUrl,
+                connectionTimeout: options.timeoutInMs || this._options.connectionTimeoutInMs,
+            });
+            // Setup connection event handlers
+            this._setupConnectionEventHandlers();
+            // Connect with proper error handling
+            await this._connectionManager.connect(options.abortSignal);
+            logger_js_1.logger.info("Successfully connected to Voice Live service");
+        }
+        catch (error) {
+            logger_js_1.logger.error("Failed to connect to Voice Live service", { error });
+            // Use error classification
+            if (error instanceof index_js_1.VoiceLiveConnectionError) {
+                throw error;
+            }
+            else {
+                throw (0, index_js_1.classifyConnectionError)(error);
+            }
+        }
+    }
+    /**
+     * Disconnects from the Voice Live service and cleans up resources.
+     */
+    async disconnect() {
+        if (!this._connectionManager) {
+            return;
+        }
+        logger_js_1.logger.info("Disconnecting from Voice Live service");
+        try {
+            await this._connectionManager.disconnect();
+        }
+        catch (error) {
+            logger_js_1.logger.error("Error during disconnect", { error });
+        }
+        finally {
+            this._connectionManager = undefined;
+            this._sessionId = undefined;
+            this._activeTurnId = undefined;
+            logger_js_1.logger.info("Disconnected from Voice Live service");
+        }
+    }
+    /**
+     * Subscribe to VoiceLive session events using strongly-typed handlers.
+     * This follows the Azure SDK pattern used by EventHub, Service Bus, etc.
+     *
+     * @param handlers - Handler functions for different types of events
+     * @returns A subscription object that can be used to stop receiving events
+     */
+    subscribe(handlers) {
+        this._ensureNotDisposed();
+        logger_js_1.logger.info("Creating VoiceLive session subscription");
+        return this._subscriptionManager.createSubscription(handlers);
+    }
+    /**
+     * Sends a custom client event to the service.
+     */
+    async sendEvent(event, options = {}) {
+        this._ensureConnected();
+        await this._sendEvent(event, options);
+    }
+    /**
+     * Updates the session configuration with the service.
+     */
+    async updateSession(session, options = {}) {
+        this._ensureConnected();
+        const updateEvent = {
+            type: "session.update",
+            session: session,
+            eventId: this._generateEventId(),
+        };
+        await this._sendEvent(updateEvent, options);
+    }
+    /**
+     * Sends audio data to the service using turn-based or buffer-based approach.
+     */
+    async sendAudio(audioData, options = {}) {
+        this._ensureConnected();
+        const audioBase64 = this._arrayBufferToBase64(audioData);
+        if (options.turnId) {
+            // Turn-based audio
+            const appendEvent = {
+                type: "input_audio.turn.append",
+                audio: audioBase64,
+                turnId: options.turnId,
+                eventId: this._generateEventId(),
+            };
+            await this._sendEvent(appendEvent, options);
+        }
+        else {
+            // Buffer-based audio (VAD mode)
+            const bufferEvent = {
+                type: "input_audio_buffer.append",
+                audio: audioBase64,
+                eventId: this._generateEventId(),
+            };
+            await this._sendEvent(bufferEvent, options);
+        }
+    }
+    /**
+     * Starts a new audio turn for turn-based audio input.
+     */
+    async startAudioTurn(options = {}) {
+        this._ensureConnected();
+        const turnId = options.turnId || this._generateTurnId();
+        this._activeTurnId = turnId;
+        const startEvent = {
+            type: "input_audio.turn.start",
+            turnId: turnId,
+            eventId: this._generateEventId(),
+        };
+        await this._sendEvent(startEvent, options);
+        return turnId;
+    }
+    /**
+     * Ends the current audio turn.
+     */
+    async endAudioTurn(turnId, options = {}) {
+        this._ensureConnected();
+        const targetTurnId = turnId || this._activeTurnId;
+        if (!targetTurnId) {
+            throw new index_js_1.VoiceLiveConnectionError("No active audio turn to end", "INVALID_STATE");
+        }
+        const endEvent = {
+            type: "input_audio.turn.end",
+            turnId: targetTurnId,
+            eventId: this._generateEventId(),
+        };
+        await this._sendEvent(endEvent, options);
+        if (targetTurnId === this._activeTurnId) {
+            this._activeTurnId = undefined;
+        }
+    }
+    /**
+     * Adds a conversation item (message) to the conversation.
+     */
+    async addConversationItem(item, options = {}) {
+        this._ensureConnected();
+        const createEvent = {
+            type: "conversation.item.create",
+            item: item,
+            eventId: this._generateEventId(),
+        };
+        await this._sendEvent(createEvent, options);
+    }
+    /**
+     * Indicates whether the session is currently connected to the Voice Live service.
+     */
+    get isConnected() {
+        return this._connectionManager?.isConnected || false;
+    }
+    /**
+     * Gets the current connection state of the session.
+     */
+    get connectionState() {
+        return this._connectionManager?.state || connectionManager_js_1.ConnectionState.Disconnected;
+    }
+    /**
+     * Gets the current session ID.
+     */
+    get sessionId() {
+        return this._sessionId;
+    }
+    /**
+     * Gets the current active audio turn ID.
+     */
+    get activeTurnId() {
+        return this._activeTurnId;
+    }
+    /**
+     * Disposes the session and cleans up resources.
+     */
+    async dispose() {
+        if (this._disposed) {
+            return;
+        }
+        logger_js_1.logger.info("Disposing VoiceLiveSession");
+        try {
+            // Close all subscriptions first
+            await this._subscriptionManager.closeAll();
+            // Then disconnect
+            await this.disconnect();
+        }
+        catch (error) {
+            logger_js_1.logger.error("Error during session disposal", { error });
+        }
+        finally {
+            this._disposed = true;
+            logger_js_1.logger.info("VoiceLiveSession disposed");
+        }
+    }
+    // Private methods
+    _buildDefaultOptions(options) {
+        return {
+            connectionTimeoutInMs: options.connectionTimeoutInMs || 30000,
+            enableDebugLogging: options.enableDebugLogging ?? false,
+        };
+    }
+    _normalizeEndpoint(endpoint) {
+        // Ensure endpoint has proper protocol
+        if (!endpoint.startsWith("http://") && !endpoint.startsWith("https://")) {
+            endpoint = `https://${endpoint}`;
+        }
+        // Remove trailing slash
+        return endpoint.replace(/\/$/, "");
+    }
+    _setupConnectionEventHandlers() {
+        if (!this._connectionManager)
+            return;
+        this._connectionManager.updateEventHandlers({
+            onStateChange: (state, previousState) => {
+                logger_js_1.logger.info("Connection state changed", { state, previousState });
+                // Handle connection state changes for handler-based subscriptions
+                if (state === connectionManager_js_1.ConnectionState.Connected && previousState === connectionManager_js_1.ConnectionState.Connecting) {
+                    this._notifyConnectionEvent("connected", {
+                        connectionId: `conn_${Date.now()}`,
+                        timestamp: new Date(),
+                    });
+                }
+                else if (state === connectionManager_js_1.ConnectionState.Disconnected &&
+                    previousState === connectionManager_js_1.ConnectionState.Connected) {
+                    this._notifyConnectionEvent("disconnected", {
+                        code: 1006, // Abnormal closure
+                        reason: "Connection lost during session",
+                        wasClean: false,
+                        timestamp: new Date(),
+                    });
+                    this._markSessionAsDead("Connection lost during session - session is permanently unusable");
+                }
+            },
+            onMessage: (data) => {
+                this._handleIncomingMessage(data);
+            },
+            onError: (error) => {
+                logger_js_1.logger.error("Connection error - marking session as dead", { error });
+                this._notifyConnectionEvent("error", {
+                    error: error,
+                    context: "WebSocket connection error",
+                    recoverable: false,
+                    timestamp: new Date(),
+                });
+                this._markSessionAsDead(`Connection error: ${error.message}`);
+            },
+        });
+    }
+    _markSessionAsDead(reason) {
+        if (this._disposed)
+            return;
+        logger_js_1.logger.error("Session marked as permanently dead", { reason });
+        // Mark as disposed to prevent further use
+        this._disposed = true;
+        // Clean up connection manager
+        this._connectionManager = undefined;
+        this._sessionId = undefined;
+        this._activeTurnId = undefined;
+    }
+    _handleIncomingMessage(data) {
+        try {
+            logger_js_1.logger.info("Message received", {
+                type: typeof data,
+                size: typeof data === "string" ? data.length : data.byteLength,
+            });
+            // Parse and process the message
+            const parsed = this._messageParser.parseIncomingMessage(data);
+            if (parsed && parsed.type === "server") {
+                // Handle server events
+                this._handleServerEvent(parsed.event);
+            }
+        }
+        catch (error) {
+            logger_js_1.logger.error("Error handling incoming message", { error });
+        }
+    }
+    _handleServerEvent(event) {
+        // Extract session information from events
+        if (event.type === "session.created" && event.session?.id) {
+            this._sessionId = event.session.id;
+            logger_js_1.logger.info("Session created", { sessionId: this._sessionId });
+        }
+        // Notify handler-based subscriptions
+        this._notifyServerEvent(event);
+    }
+    _notifyConnectionEvent(eventType, args) {
+        const context = {
+            endpoint: this._endpoint,
+            sessionId: this._sessionId,
+            timestamp: new Date(),
+            model: this._model,
+        };
+        // Fire and forget - don't await to avoid blocking
+        this._subscriptionManager.processConnectionEvent(eventType, args, context).catch((error) => {
+            logger_js_1.logger.error("Error processing connection event in handlers", { eventType, error });
+        });
+    }
+    _notifyServerEvent(event) {
+        if (!this._sessionId) {
+            // Can't notify server events without a session ID
+            return;
+        }
+        const context = {
+            endpoint: this._endpoint,
+            sessionId: this._sessionId,
+            timestamp: new Date(),
+            model: this._model,
+            conversationId: undefined, // Could extract from event if available
+        };
+        // Fire and forget - don't await to avoid blocking
+        this._subscriptionManager.processServerEvent(event, context).catch((error) => {
+            logger_js_1.logger.error("Error processing server event in handlers", { eventType: event.type, error });
+        });
+    }
+    async _sendEvent(event, options) {
+        if (!this._connectionManager?.isConnected) {
+            throw new index_js_1.VoiceLiveConnectionError("Not connected to Voice Live service", "NOT_CONNECTED");
+        }
+        try {
+            const serialized = this._messageParser.serializeOutgoingMessage(event);
+            await this._connectionManager.send(serialized, options.abortSignal);
+            logger_js_1.logger.info("Sent event", { type: event.type, eventId: event.eventId });
+        }
+        catch (error) {
+            if (error instanceof index_js_1.VoiceLiveConnectionError) {
+                throw error;
+            }
+            throw (0, index_js_1.classifyConnectionError)(error);
+        }
+    }
+    _ensureConnected() {
+        this._ensureNotDisposed();
+        if (!this.isConnected) {
+            throw new index_js_1.VoiceLiveConnectionError("Must be connected to Voice Live service", "NOT_CONNECTED");
+        }
+    }
+    _ensureNotDisposed() {
+        if (this._disposed) {
+            throw new index_js_1.VoiceLiveConnectionError("Session is permanently dead and cannot be used. Create a new session to continue.", "SESSION_DEAD");
+        }
+    }
+    _generateEventId() {
+        return `evt_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+    }
+    _generateTurnId() {
+        return `turn_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+    }
+    _arrayBufferToBase64(buffer) {
+        const bytes = buffer instanceof ArrayBuffer ? new Uint8Array(buffer) : buffer;
+        let binary = "";
+        for (let i = 0; i < bytes.byteLength; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return btoa(binary);
+    }
+}
+exports.VoiceLiveSession = VoiceLiveSession;
+//# sourceMappingURL=voiceLiveSession.js.map

package/dist/commonjs/voiceLiveSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceLiveSession.js","sourceRoot":"","sources":["../../src/voiceLiveSession.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { KeyCredential, TokenCredential } from \"@azure/core-auth\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type {\n  RequestSession,\n  ClientEventSessionUpdate,\n  ClientEventUnion,\n  ClientEventInputAudioBufferAppend,\n  ClientEventInputAudioTurnStart,\n  ClientEventInputAudioTurnAppend,\n  ClientEventInputAudioTurnEnd,\n  ConversationRequestItem,\n  ClientEventConversationItemCreate,\n  ServerEventUnion,\n} from \"./models/index.js\";\nimport { ConnectionManager, ConnectionState } from \"./websocket/connectionManager.js\";\nimport { VoiceLiveWebSocketFactory } from \"./websocket/websocketFactory.js\";\nimport { VoiceLiveMessageParser } from \"./protocol/messageParser.js\";\nimport { CredentialHandler } from \"./auth/credentialHandler.js\";\nimport { VoiceLiveConnectionError, classifyConnectionError } from \"./errors/index.js\";\nimport { logger } from \"./logger.js\";\nimport type {\n  VoiceLiveSessionHandlers,\n  VoiceLiveSubscription,\n  ConnectionContext,\n  SessionContext,\n  ConnectedEventArgs,\n  DisconnectedEventArgs,\n  ErrorEventArgs,\n} from \"./handlers/sessionHandlers.js\";\nimport { SubscriptionManager } from \"./handlers/subscriptionManager.js\";\n\nexport interface VoiceLiveSessionOptions {\n  /** Connection timeout in milliseconds */\n  connectionTimeoutInMs?: number;\n  /** Enable debug logging for development */\n  enableDebugLogging?: boolean;\n}\n\nexport interface CreateSessionOptions extends VoiceLiveSessionOptions {}\n\nexport interface StartSessionOptions extends VoiceLiveSessionOptions {}\nexport interface ConnectOptions {\n  /** Abort signal to cancel connection attempt */\n  abortSignal?: AbortSignalLike;\n  /** Override connection timeout for this operation */\n  timeoutInMs?: number;\n}\n\nexport interface SendEventOptions {\n  /** Abort signal to cancel send operation */\n  abortSignal?: AbortSignalLike;\n  /** Timeout for send operation */\n  timeoutInMs?: number;\n}\n\nexport interface AudioStreamOptions extends SendEventOptions {\n  /** Turn ID for turn-based audio (if not provided, uses buffer mode) */\n  turnId?: string;\n}\n\nexport interface TurnOptions extends SendEventOptions {\n  /** Custom turn ID (if not provided, one will be generated) */\n  turnId?: string;\n}\n\n/**\n * Represents a WebSocket-based session for real-time voice communication with the Azure VoiceLive service.\n *\n * This class manages the connection, handles real-time communication, and provides access to all\n * interactive features including audio streaming, conversation management, and avatar control.\n */\nexport class VoiceLiveSession {\n  private readonly _endpoint: string;\n  private readonly _credentialHandler: CredentialHandler;\n  private readonly _options: Required<VoiceLiveSessionOptions>;\n  private readonly _messageParser: VoiceLiveMessageParser;\n  private readonly _model: string;\n  private _connectionManager?: ConnectionManager;\n  private _sessionId?: string;\n  private _activeTurnId?: string;\n  private _disposed = false;\n\n  // Handler-based subscription management\n  private readonly _subscriptionManager: SubscriptionManager;\n\n  /**\n   * Creates an instance of VoiceLiveSession.\n   *\n   * @param endpoint - The Voice Live service endpoint URL\n   * @param credential - Azure TokenCredential or KeyCredential for authentication\n   * @param apiVersion - API version to use for the Voice Live service\n   * @param model - The model name to use for the session\n   * @param options - Optional configuration for the session\n   */\n  constructor(\n    endpoint: string,\n    credential: TokenCredential | KeyCredential,\n    apiVersion: string,\n    model: string,\n    options: VoiceLiveSessionOptions = {},\n  ) {\n    this._endpoint = this._normalizeEndpoint(endpoint);\n    this._credentialHandler = new CredentialHandler(credential);\n    this._options = this._buildDefaultOptions(options);\n    this._messageParser = new VoiceLiveMessageParser();\n    this._model = model;\n\n    // Initialize handler-based subscription management\n    this._subscriptionManager = new SubscriptionManager();\n\n    logger.info(\"VoiceLiveSession created\", {\n      endpoint: this._endpoint,\n      model: this._model,\n      apiVersion: apiVersion,\n      enableDebugLogging: this._options.enableDebugLogging,\n    });\n  }\n\n  /**\n   * Establishes connection to the Voice Live service with authentication.\n   */\n  async connect(options: ConnectOptions = {}): Promise<void> {\n    this._ensureNotDisposed();\n\n    if (this.isConnected) {\n      logger.info(\"VoiceLiveSession already connected\");\n      return;\n    }\n\n    try {\n      logger.info(\"Connecting to Voice Live service\", {\n        endpoint: this._endpoint,\n        model: this._model,\n      });\n\n      // Get WebSocket URL with authentication and model\n      const wsUrl = await this._credentialHandler.getWebSocketUrl(\n        this._endpoint,\n        \"2025-10-01\", // TODO: make this configurable through constructor\n        this._model,\n      );\n      const authHeaders = await this._credentialHandler.getAuthHeaders();\n\n      // Create connection manager\n      const websocketFactory = new VoiceLiveWebSocketFactory();\n      this._connectionManager = new ConnectionManager(\n        () =>\n          websocketFactory.create({\n            headers: { ...authHeaders },\n            connectionTimeoutInMs: this._options.connectionTimeoutInMs,\n            compression: true,\n          }),\n        {\n          endpoint: wsUrl,\n          connectionTimeout: options.timeoutInMs || this._options.connectionTimeoutInMs,\n        },\n      );\n\n      // Setup connection event handlers\n      this._setupConnectionEventHandlers();\n\n      // Connect with proper error handling\n      await this._connectionManager.connect(options.abortSignal);\n\n      logger.info(\"Successfully connected to Voice Live service\");\n    } catch (error) {\n      logger.error(\"Failed to connect to Voice Live service\", { error });\n\n      // Use error classification\n      if (error instanceof VoiceLiveConnectionError) {\n        throw error;\n      } else {\n        throw classifyConnectionError(error);\n      }\n    }\n  }\n\n  /**\n   * Disconnects from the Voice Live service and cleans up resources.\n   */\n  async disconnect(): Promise<void> {\n    if (!this._connectionManager) {\n      return;\n    }\n\n    logger.info(\"Disconnecting from Voice Live service\");\n\n    try {\n      await this._connectionManager.disconnect();\n    } catch (error) {\n      logger.error(\"Error during disconnect\", { error });\n    } finally {\n      this._connectionManager = undefined;\n      this._sessionId = undefined;\n      this._activeTurnId = undefined;\n      logger.info(\"Disconnected from Voice Live service\");\n    }\n  }\n\n  /**\n   * Subscribe to VoiceLive session events using strongly-typed handlers.\n   * This follows the Azure SDK pattern used by EventHub, Service Bus, etc.\n   *\n   * @param handlers - Handler functions for different types of events\n   * @returns A subscription object that can be used to stop receiving events\n   */\n  subscribe(handlers: VoiceLiveSessionHandlers): VoiceLiveSubscription {\n    this._ensureNotDisposed();\n\n    logger.info(\"Creating VoiceLive session subscription\");\n    return this._subscriptionManager.createSubscription(handlers);\n  }\n\n  /**\n   * Sends a custom client event to the service.\n   */\n  async sendEvent(event: ClientEventUnion, options: SendEventOptions = {}): Promise<void> {\n    this._ensureConnected();\n    await this._sendEvent(event, options);\n  }\n\n  /**\n   * Updates the session configuration with the service.\n   */\n  async updateSession(session: RequestSession, options: SendEventOptions = {}): Promise<void> {\n    this._ensureConnected();\n\n    const updateEvent: ClientEventSessionUpdate = {\n      type: \"session.update\",\n      session: session,\n      eventId: this._generateEventId(),\n    };\n\n    await this._sendEvent(updateEvent, options);\n  }\n\n  /**\n   * Sends audio data to the service using turn-based or buffer-based approach.\n   */\n  async sendAudio(\n    audioData: ArrayBuffer | Uint8Array,\n    options: AudioStreamOptions = {},\n  ): Promise<void> {\n    this._ensureConnected();\n\n    const audioBase64 = this._arrayBufferToBase64(audioData);\n\n    if (options.turnId) {\n      // Turn-based audio\n      const appendEvent: ClientEventInputAudioTurnAppend = {\n        type: \"input_audio.turn.append\",\n        audio: audioBase64,\n        turnId: options.turnId,\n        eventId: this._generateEventId(),\n      };\n      await this._sendEvent(appendEvent, options);\n    } else {\n      // Buffer-based audio (VAD mode)\n      const bufferEvent: ClientEventInputAudioBufferAppend = {\n        type: \"input_audio_buffer.append\",\n        audio: audioBase64,\n        eventId: this._generateEventId(),\n      };\n      await this._sendEvent(bufferEvent, options);\n    }\n  }\n\n  /**\n   * Starts a new audio turn for turn-based audio input.\n   */\n  async startAudioTurn(options: TurnOptions = {}): Promise<string> {\n    this._ensureConnected();\n\n    const turnId = options.turnId || this._generateTurnId();\n    this._activeTurnId = turnId;\n\n    const startEvent: ClientEventInputAudioTurnStart = {\n      type: \"input_audio.turn.start\",\n      turnId: turnId,\n      eventId: this._generateEventId(),\n    };\n\n    await this._sendEvent(startEvent, options);\n    return turnId;\n  }\n\n  /**\n   * Ends the current audio turn.\n   */\n  async endAudioTurn(turnId?: string, options: SendEventOptions = {}): Promise<void> {\n    this._ensureConnected();\n\n    const targetTurnId = turnId || this._activeTurnId;\n    if (!targetTurnId) {\n      throw new VoiceLiveConnectionError(\"No active audio turn to end\", \"INVALID_STATE\");\n    }\n\n    const endEvent: ClientEventInputAudioTurnEnd = {\n      type: \"input_audio.turn.end\",\n      turnId: targetTurnId,\n      eventId: this._generateEventId(),\n    };\n\n    await this._sendEvent(endEvent, options);\n\n    if (targetTurnId === this._activeTurnId) {\n      this._activeTurnId = undefined;\n    }\n  }\n\n  /**\n   * Adds a conversation item (message) to the conversation.\n   */\n  async addConversationItem(\n    item: ConversationRequestItem,\n    options: SendEventOptions = {},\n  ): Promise<void> {\n    this._ensureConnected();\n\n    const createEvent: ClientEventConversationItemCreate = {\n      type: \"conversation.item.create\",\n      item: item,\n      eventId: this._generateEventId(),\n    };\n\n    await this._sendEvent(createEvent, options);\n  }\n\n  /**\n   * Indicates whether the session is currently connected to the Voice Live service.\n   */\n  get isConnected(): boolean {\n    return this._connectionManager?.isConnected || false;\n  }\n\n  /**\n   * Gets the current connection state of the session.\n   */\n  get connectionState(): ConnectionState {\n    return this._connectionManager?.state || ConnectionState.Disconnected;\n  }\n\n  /**\n   * Gets the current session ID.\n   */\n  get sessionId(): string | undefined {\n    return this._sessionId;\n  }\n\n  /**\n   * Gets the current active audio turn ID.\n   */\n  get activeTurnId(): string | undefined {\n    return this._activeTurnId;\n  }\n\n  /**\n   * Disposes the session and cleans up resources.\n   */\n  async dispose(): Promise<void> {\n    if (this._disposed) {\n      return;\n    }\n\n    logger.info(\"Disposing VoiceLiveSession\");\n\n    try {\n      // Close all subscriptions first\n      await this._subscriptionManager.closeAll();\n\n      // Then disconnect\n      await this.disconnect();\n    } catch (error) {\n      logger.error(\"Error during session disposal\", { error });\n    } finally {\n      this._disposed = true;\n      logger.info(\"VoiceLiveSession disposed\");\n    }\n  }\n\n  // Private methods\n\n  private _buildDefaultOptions(\n    options: VoiceLiveSessionOptions,\n  ): Required<VoiceLiveSessionOptions> {\n    return {\n      connectionTimeoutInMs: options.connectionTimeoutInMs || 30000,\n      enableDebugLogging: options.enableDebugLogging ?? false,\n    };\n  }\n\n  private _normalizeEndpoint(endpoint: string): string {\n    // Ensure endpoint has proper protocol\n    if (!endpoint.startsWith(\"http://\") && !endpoint.startsWith(\"https://\")) {\n      endpoint = `https://${endpoint}`;\n    }\n\n    // Remove trailing slash\n    return endpoint.replace(/\\/$/, \"\");\n  }\n\n  private _setupConnectionEventHandlers(): void {\n    if (!this._connectionManager) return;\n\n    this._connectionManager.updateEventHandlers({\n      onStateChange: (state, previousState) => {\n        logger.info(\"Connection state changed\", { state, previousState });\n\n        // Handle connection state changes for handler-based subscriptions\n        if (state === ConnectionState.Connected && previousState === ConnectionState.Connecting) {\n          this._notifyConnectionEvent(\"connected\", {\n            connectionId: `conn_${Date.now()}`,\n            timestamp: new Date(),\n          });\n        } else if (\n          state === ConnectionState.Disconnected &&\n          previousState === ConnectionState.Connected\n        ) {\n          this._notifyConnectionEvent(\"disconnected\", {\n            code: 1006, // Abnormal closure\n            reason: \"Connection lost during session\",\n            wasClean: false,\n            timestamp: new Date(),\n          });\n          this._markSessionAsDead(\n            \"Connection lost during session - session is permanently unusable\",\n          );\n        }\n      },\n      onMessage: (data) => {\n        this._handleIncomingMessage(data);\n      },\n      onError: (error) => {\n        logger.error(\"Connection error - marking session as dead\", { error });\n        this._notifyConnectionEvent(\"error\", {\n          error: error,\n          context: \"WebSocket connection error\",\n          recoverable: false,\n          timestamp: new Date(),\n        });\n        this._markSessionAsDead(`Connection error: ${error.message}`);\n      },\n    });\n  }\n\n  private _markSessionAsDead(reason: string): void {\n    if (this._disposed) return;\n\n    logger.error(\"Session marked as permanently dead\", { reason });\n\n    // Mark as disposed to prevent further use\n    this._disposed = true;\n\n    // Clean up connection manager\n    this._connectionManager = undefined;\n    this._sessionId = undefined;\n    this._activeTurnId = undefined;\n  }\n\n  private _handleIncomingMessage(data: string | ArrayBuffer): void {\n    try {\n      logger.info(\"Message received\", {\n        type: typeof data,\n        size: typeof data === \"string\" ? data.length : data.byteLength,\n      });\n\n      // Parse and process the message\n      const parsed = this._messageParser.parseIncomingMessage(data);\n      if (parsed && parsed.type === \"server\") {\n        // Handle server events\n        this._handleServerEvent(parsed.event);\n      }\n    } catch (error) {\n      logger.error(\"Error handling incoming message\", { error });\n    }\n  }\n\n  private _handleServerEvent(event: any): void {\n    // Extract session information from events\n    if (event.type === \"session.created\" && event.session?.id) {\n      this._sessionId = event.session.id;\n      logger.info(\"Session created\", { sessionId: this._sessionId });\n    }\n\n    // Notify handler-based subscriptions\n    this._notifyServerEvent(event);\n  }\n\n  private _notifyConnectionEvent(\n    eventType: \"connected\" | \"disconnected\" | \"error\",\n    args: ConnectedEventArgs | DisconnectedEventArgs | ErrorEventArgs,\n  ): void {\n    const context: ConnectionContext = {\n      endpoint: this._endpoint,\n      sessionId: this._sessionId,\n      timestamp: new Date(),\n      model: this._model,\n    };\n\n    // Fire and forget - don't await to avoid blocking\n    this._subscriptionManager.processConnectionEvent(eventType, args, context).catch((error) => {\n      logger.error(\"Error processing connection event in handlers\", { eventType, error });\n    });\n  }\n\n  private _notifyServerEvent(event: ServerEventUnion): void {\n    if (!this._sessionId) {\n      // Can't notify server events without a session ID\n      return;\n    }\n\n    const context: SessionContext = {\n      endpoint: this._endpoint,\n      sessionId: this._sessionId,\n      timestamp: new Date(),\n      model: this._model,\n      conversationId: undefined, // Could extract from event if available\n    };\n\n    // Fire and forget - don't await to avoid blocking\n    this._subscriptionManager.processServerEvent(event, context).catch((error) => {\n      logger.error(\"Error processing server event in handlers\", { eventType: event.type, error });\n    });\n  }\n\n  private async _sendEvent(event: ClientEventUnion, options: SendEventOptions): Promise<void> {\n    if (!this._connectionManager?.isConnected) {\n      throw new VoiceLiveConnectionError(\"Not connected to Voice Live service\", \"NOT_CONNECTED\");\n    }\n\n    try {\n      const serialized = this._messageParser.serializeOutgoingMessage(event);\n      await this._connectionManager.send(serialized, options.abortSignal);\n\n      logger.info(\"Sent event\", { type: event.type, eventId: (event as any).eventId });\n    } catch (error) {\n      if (error instanceof VoiceLiveConnectionError) {\n        throw error;\n      }\n\n      throw classifyConnectionError(error);\n    }\n  }\n\n  private _ensureConnected(): void {\n    this._ensureNotDisposed();\n    if (!this.isConnected) {\n      throw new VoiceLiveConnectionError(\n        \"Must be connected to Voice Live service\",\n        \"NOT_CONNECTED\",\n      );\n    }\n  }\n\n  private _ensureNotDisposed(): void {\n    if (this._disposed) {\n      throw new VoiceLiveConnectionError(\n        \"Session is permanently dead and cannot be used. Create a new session to continue.\",\n        \"SESSION_DEAD\",\n      );\n    }\n  }\n\n  private _generateEventId(): string {\n    return `evt_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;\n  }\n\n  private _generateTurnId(): string {\n    return `turn_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;\n  }\n\n  private _arrayBufferToBase64(buffer: ArrayBuffer | Uint8Array): string {\n    const bytes = buffer instanceof ArrayBuffer ? new Uint8Array(buffer) : buffer;\n    let binary = \"\";\n    for (let i = 0; i < bytes.byteLength; i++) {\n      binary += String.fromCharCode(bytes[i]);\n    }\n    return btoa(binary);\n  }\n}\n"]}

package/dist/commonjs/websocket/connectionManager.d.ts

@@ -0,0 +1,88 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+import type { VoiceLiveWebSocketLike } from "./websocketLike.js";
+import { VoiceLiveConnectionError } from "../errors/index.js";
+/**
+ * Connection state enumeration for lifecycle management
+ */
+export declare enum ConnectionState {
+    Disconnected = "disconnected",
+    Connecting = "connecting",
+    Connected = "connected",
+    Disconnecting = "disconnecting"
+}
+/**
+ * Configuration options for connection management
+ */
+export interface ConnectionOptions {
+    /** WebSocket endpoint URL */
+    endpoint: string;
+    /** WebSocket protocols to use */
+    protocols?: string[];
+    /** Connection timeout in milliseconds */
+    connectionTimeout?: number;
+}
+/**
+ * Event handlers for connection lifecycle events
+ */
+export interface ConnectionEventHandlers {
+    /** Called when connection state changes */
+    onStateChange?: (state: ConnectionState, previousState: ConnectionState) => void;
+    /** Called when a message is received */
+    onMessage?: (data: string | ArrayBuffer) => void;
+    /** Called when an error occurs or connection is lost */
+    onError?: (error: VoiceLiveConnectionError) => void;
+}
+/**
+ * Manages WebSocket connection lifecycle with fail-fast semantics
+ */
+export declare class ConnectionManager {
+    private _websocketFactory;
+    private _options;
+    private _eventHandlers;
+    private _state;
+    private _previousState;
+    private _websocket?;
+    private _abortController?;
+    constructor(_websocketFactory: () => VoiceLiveWebSocketLike, _options: ConnectionOptions, _eventHandlers?: ConnectionEventHandlers);
+    /**
+     * Initiates a WebSocket connection
+     */
+    connect(abortSignal?: AbortSignalLike): Promise<void>;
+    /**
+     * Disconnects the WebSocket connection
+     */
+    disconnect(_abortSignal?: AbortSignalLike): Promise<void>;
+    /**
+     * Sends data through the WebSocket connection
+     */
+    send(data: string | ArrayBuffer, abortSignal?: AbortSignalLike): Promise<void>;
+    /**
+     * Sets up event handlers for the WebSocket instance
+     */
+    private _setupWebSocketHandlers;
+    /**
+     * Handles any connection loss - always fatal in fail-fast model
+     */
+    private _handleConnectionLost;
+    /**
+     * Handles WebSocket errors
+     */
+    private _handleConnectionError;
+    /**
+     * Updates the connection state and notifies handlers
+     */
+    private _setState;
+    /**
+     * Gets the current connection state
+     */
+    get state(): ConnectionState;
+    /**
+     * Checks if the connection is currently established
+     */
+    get isConnected(): boolean;
+    /**
+     * Updates the event handlers
+     */
+    updateEventHandlers(handlers: Partial<ConnectionEventHandlers>): void;
+}
+//# sourceMappingURL=connectionManager.d.ts.map