@azure/ai-voicelive 1.0.0-alpha.20251117.2

package/dist/esm/websocket/connectionManager.js

@@ -0,0 +1,183 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { VoiceLiveConnectionError, VoiceLiveErrorCodes, classifyWebSocketClose, } from "../errors/index.js";
+import { logger } from "../logger.js";
+/**
+ * Connection state enumeration for lifecycle management
+ */
+export var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState["Disconnected"] = "disconnected";
+    ConnectionState["Connecting"] = "connecting";
+    ConnectionState["Connected"] = "connected";
+    ConnectionState["Disconnecting"] = "disconnecting";
+    // Removed: Reconnecting - no reconnection in fail-fast model
+})(ConnectionState || (ConnectionState = {}));
+/**
+ * Manages WebSocket connection lifecycle with fail-fast semantics
+ */
+export class ConnectionManager {
+    _websocketFactory;
+    _options;
+    _eventHandlers;
+    _state = ConnectionState.Disconnected;
+    _previousState = ConnectionState.Disconnected;
+    _websocket;
+    _abortController;
+    constructor(_websocketFactory, _options, _eventHandlers = {}) {
+        this._websocketFactory = _websocketFactory;
+        this._options = _options;
+        this._eventHandlers = _eventHandlers;
+        // No reconnection setup needed - fail fast model
+    }
+    /**
+     * Initiates a WebSocket connection
+     */
+    async connect(abortSignal) {
+        if (this._state === ConnectionState.Connected) {
+            return;
+        }
+        if (this._state === ConnectionState.Connecting) {
+            throw new VoiceLiveConnectionError("Connection attempt already in progress", VoiceLiveErrorCodes.InvalidState);
+        }
+        this._setState(ConnectionState.Connecting);
+        // Create new abort controller for this connection attempt
+        this._abortController = new AbortController();
+        // Chain with provided abort signal
+        if (abortSignal) {
+            if (abortSignal.aborted) {
+                this._abortController.abort();
+            }
+            else {
+                abortSignal.addEventListener("abort", () => {
+                    this._abortController?.abort();
+                });
+            }
+        }
+        try {
+            this._websocket = this._websocketFactory();
+            this._setupWebSocketHandlers();
+            await this._websocket.connect(this._options.endpoint, this._options.protocols, this._abortController.signal);
+            this._setState(ConnectionState.Connected);
+        }
+        catch (error) {
+            this._setState(ConnectionState.Disconnected);
+            if (error instanceof VoiceLiveConnectionError) {
+                throw error;
+            }
+            else {
+                throw new VoiceLiveConnectionError(`Failed to connect: ${error instanceof Error ? error.message : "Unknown error"}`, VoiceLiveErrorCodes.ConnectionFailed, "connection_attempt", true, error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    /**
+     * Disconnects the WebSocket connection
+     */
+    async disconnect(_abortSignal) {
+        if (this._state === ConnectionState.Disconnected) {
+            return;
+        }
+        // Abort any ongoing connection attempt
+        this._abortController?.abort();
+        this._setState(ConnectionState.Disconnecting);
+        try {
+            if (this._websocket) {
+                await this._websocket.disconnect(1000, "Client disconnect");
+            }
+        }
+        finally {
+            this._setState(ConnectionState.Disconnected);
+        }
+    }
+    /**
+     * Sends data through the WebSocket connection
+     */
+    async send(data, abortSignal) {
+        if (!this._websocket || this._state !== ConnectionState.Connected) {
+            throw new VoiceLiveConnectionError("Cannot send message: WebSocket not connected", VoiceLiveErrorCodes.NotConnected);
+        }
+        return this._websocket.send(data, abortSignal);
+    }
+    /**
+     * Sets up event handlers for the WebSocket instance
+     */
+    _setupWebSocketHandlers() {
+        if (!this._websocket)
+            return;
+        logger.info("Setting up WebSocket event handlers");
+        this._websocket.onOpen(() => {
+            logger.info("WebSocket connection opened");
+            // Connection opened - handled in connect() method
+        });
+        this._websocket.onClose((code, reason) => {
+            this._handleConnectionLost(code, reason);
+        });
+        this._websocket.onError((error) => {
+            this._handleConnectionError(error);
+        });
+        this._websocket.onMessage((data) => {
+            this._eventHandlers.onMessage?.(data);
+        });
+    }
+    /**
+     * Handles any connection loss - always fatal in fail-fast model
+     */
+    _handleConnectionLost(code, reason) {
+        // Check if this was an expected disconnection before changing state
+        if (this._state === ConnectionState.Disconnecting) {
+            // This was an expected disconnection, don't treat as error
+            this._setState(ConnectionState.Disconnected);
+            return;
+        }
+        this._setState(ConnectionState.Disconnected);
+        // In fail-fast model, ANY unexpected connection loss is fatal
+        let error;
+        if (code === 1000) {
+            // Normal close, but unexpected
+            error = new VoiceLiveConnectionError("WebSocket connection closed unexpectedly", VoiceLiveErrorCodes.ConnectionLost, "connection_lost");
+        }
+        else {
+            // Use classifier for other codes
+            error = classifyWebSocketClose(code, reason);
+        }
+        // Always notify of fatal error for unexpected disconnections
+        this._eventHandlers.onError?.(error);
+    }
+    /**
+     * Handles WebSocket errors
+     */
+    _handleConnectionError(error) {
+        const connectionError = new VoiceLiveConnectionError(`WebSocket error: ${error.message}`, VoiceLiveErrorCodes.WebSocketError, "websocket_error", true, error);
+        this._eventHandlers.onError?.(connectionError);
+    }
+    /**
+     * Updates the connection state and notifies handlers
+     */
+    _setState(state) {
+        if (this._state !== state) {
+            this._previousState = this._state;
+            this._state = state;
+            this._eventHandlers.onStateChange?.(state, this._previousState);
+        }
+    }
+    // Public properties and methods
+    /**
+     * Gets the current connection state
+     */
+    get state() {
+        return this._state;
+    }
+    /**
+     * Checks if the connection is currently established
+     */
+    get isConnected() {
+        return this._state === ConnectionState.Connected;
+    }
+    /**
+     * Updates the event handlers
+     */
+    updateEventHandlers(handlers) {
+        Object.assign(this._eventHandlers, handlers);
+    }
+}
+//# sourceMappingURL=connectionManager.js.map

package/dist/esm/websocket/connectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionManager.js","sourceRoot":"","sources":["../../../src/websocket/connectionManager.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { VoiceLiveWebSocketLike } from \"./websocketLike.js\";\nimport {\n  VoiceLiveConnectionError,\n  VoiceLiveErrorCodes,\n  classifyWebSocketClose,\n} from \"../errors/index.js\";\nimport { logger } from \"../logger.js\";\n\n/**\n * Connection state enumeration for lifecycle management\n */\nexport enum ConnectionState {\n  Disconnected = \"disconnected\",\n  Connecting = \"connecting\",\n  Connected = \"connected\",\n  Disconnecting = \"disconnecting\",\n  // Removed: Reconnecting - no reconnection in fail-fast model\n}\n\n/**\n * Configuration options for connection management\n */\nexport interface ConnectionOptions {\n  /** WebSocket endpoint URL */\n  endpoint: string;\n  /** WebSocket protocols to use */\n  protocols?: string[];\n  /** Connection timeout in milliseconds */\n  connectionTimeout?: number;\n  // Removed all reconnection options - fail fast model\n}\n\n/**\n * Event handlers for connection lifecycle events\n */\nexport interface ConnectionEventHandlers {\n  /** Called when connection state changes */\n  onStateChange?: (state: ConnectionState, previousState: ConnectionState) => void;\n  /** Called when a message is received */\n  onMessage?: (data: string | ArrayBuffer) => void;\n  /** Called when an error occurs or connection is lost */\n  onError?: (error: VoiceLiveConnectionError) => void;\n  // Removed: onReconnectAttempt - no reconnection in fail-fast model\n}\n\n/**\n * Manages WebSocket connection lifecycle with fail-fast semantics\n */\nexport class ConnectionManager {\n  private _state: ConnectionState = ConnectionState.Disconnected;\n  private _previousState: ConnectionState = ConnectionState.Disconnected;\n  private _websocket?: VoiceLiveWebSocketLike;\n  private _abortController?: AbortController;\n\n  constructor(\n    private _websocketFactory: () => VoiceLiveWebSocketLike,\n    private _options: ConnectionOptions,\n    private _eventHandlers: ConnectionEventHandlers = {},\n  ) {\n    // No reconnection setup needed - fail fast model\n  }\n\n  /**\n   * Initiates a WebSocket connection\n   */\n  async connect(abortSignal?: AbortSignalLike): Promise<void> {\n    if (this._state === ConnectionState.Connected) {\n      return;\n    }\n\n    if (this._state === ConnectionState.Connecting) {\n      throw new VoiceLiveConnectionError(\n        \"Connection attempt already in progress\",\n        VoiceLiveErrorCodes.InvalidState,\n      );\n    }\n\n    this._setState(ConnectionState.Connecting);\n\n    // Create new abort controller for this connection attempt\n    this._abortController = new AbortController();\n\n    // Chain with provided abort signal\n    if (abortSignal) {\n      if (abortSignal.aborted) {\n        this._abortController.abort();\n      } else {\n        abortSignal.addEventListener(\"abort\", () => {\n          this._abortController?.abort();\n        });\n      }\n    }\n\n    try {\n      this._websocket = this._websocketFactory();\n      this._setupWebSocketHandlers();\n\n      await this._websocket.connect(\n        this._options.endpoint,\n        this._options.protocols,\n        this._abortController.signal,\n      );\n\n      this._setState(ConnectionState.Connected);\n    } catch (error) {\n      this._setState(ConnectionState.Disconnected);\n\n      if (error instanceof VoiceLiveConnectionError) {\n        throw error;\n      } else {\n        throw new VoiceLiveConnectionError(\n          `Failed to connect: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n          VoiceLiveErrorCodes.ConnectionFailed,\n          \"connection_attempt\",\n          true,\n          error instanceof Error ? error : new Error(String(error)),\n        );\n      }\n    }\n  }\n\n  /**\n   * Disconnects the WebSocket connection\n   */\n  async disconnect(_abortSignal?: AbortSignalLike): Promise<void> {\n    if (this._state === ConnectionState.Disconnected) {\n      return;\n    }\n\n    // Abort any ongoing connection attempt\n    this._abortController?.abort();\n\n    this._setState(ConnectionState.Disconnecting);\n\n    try {\n      if (this._websocket) {\n        await this._websocket.disconnect(1000, \"Client disconnect\");\n      }\n    } finally {\n      this._setState(ConnectionState.Disconnected);\n    }\n  }\n\n  /**\n   * Sends data through the WebSocket connection\n   */\n  async send(data: string | ArrayBuffer, abortSignal?: AbortSignalLike): Promise<void> {\n    if (!this._websocket || this._state !== ConnectionState.Connected) {\n      throw new VoiceLiveConnectionError(\n        \"Cannot send message: WebSocket not connected\",\n        VoiceLiveErrorCodes.NotConnected,\n      );\n    }\n\n    return this._websocket.send(data, abortSignal);\n  }\n\n  /**\n   * Sets up event handlers for the WebSocket instance\n   */\n  private _setupWebSocketHandlers(): void {\n    if (!this._websocket) return;\n    logger.info(\"Setting up WebSocket event handlers\");\n    this._websocket.onOpen(() => {\n      logger.info(\"WebSocket connection opened\");\n      // Connection opened - handled in connect() method\n    });\n\n    this._websocket.onClose((code, reason) => {\n      this._handleConnectionLost(code, reason);\n    });\n\n    this._websocket.onError((error) => {\n      this._handleConnectionError(error);\n    });\n\n    this._websocket.onMessage((data) => {\n      this._eventHandlers.onMessage?.(data);\n    });\n  }\n\n  /**\n   * Handles any connection loss - always fatal in fail-fast model\n   */\n  private _handleConnectionLost(code: number, reason: string): void {\n    // Check if this was an expected disconnection before changing state\n    if (this._state === ConnectionState.Disconnecting) {\n      // This was an expected disconnection, don't treat as error\n      this._setState(ConnectionState.Disconnected);\n      return;\n    }\n\n    this._setState(ConnectionState.Disconnected);\n\n    // In fail-fast model, ANY unexpected connection loss is fatal\n    let error: VoiceLiveConnectionError;\n\n    if (code === 1000) {\n      // Normal close, but unexpected\n      error = new VoiceLiveConnectionError(\n        \"WebSocket connection closed unexpectedly\",\n        VoiceLiveErrorCodes.ConnectionLost,\n        \"connection_lost\",\n      );\n    } else {\n      // Use classifier for other codes\n      error = classifyWebSocketClose(code, reason);\n    }\n\n    // Always notify of fatal error for unexpected disconnections\n    this._eventHandlers.onError?.(error);\n  }\n\n  /**\n   * Handles WebSocket errors\n   */\n  private _handleConnectionError(error: Error): void {\n    const connectionError = new VoiceLiveConnectionError(\n      `WebSocket error: ${error.message}`,\n      VoiceLiveErrorCodes.WebSocketError,\n      \"websocket_error\",\n      true,\n      error,\n    );\n\n    this._eventHandlers.onError?.(connectionError);\n  }\n\n  /**\n   * Updates the connection state and notifies handlers\n   */\n  private _setState(state: ConnectionState): void {\n    if (this._state !== state) {\n      this._previousState = this._state;\n      this._state = state;\n      this._eventHandlers.onStateChange?.(state, this._previousState);\n    }\n  }\n\n  // Public properties and methods\n\n  /**\n   * Gets the current connection state\n   */\n  get state(): ConnectionState {\n    return this._state;\n  }\n\n  /**\n   * Checks if the connection is currently established\n   */\n  get isConnected(): boolean {\n    return this._state === ConnectionState.Connected;\n  }\n\n  /**\n   * Updates the event handlers\n   */\n  updateEventHandlers(handlers: Partial<ConnectionEventHandlers>): void {\n    Object.assign(this._eventHandlers, handlers);\n  }\n}\n"]}

package/dist/esm/websocket/websocketBrowser.d.ts

@@ -0,0 +1,26 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+import { WebSocketState, type VoiceLiveWebSocketLike, type WebSocketFactoryOptions } from "./websocketLike.js";
+/**
+ * Browser WebSocket implementation using native WebSocket API
+ */
+export declare class VoiceLiveWebSocketBrowser implements VoiceLiveWebSocketLike {
+    private _ws?;
+    private _url?;
+    private _options;
+    private _onOpen?;
+    private _onClose?;
+    private _onMessage?;
+    private _onError?;
+    constructor(options?: WebSocketFactoryOptions);
+    connect(url: string, protocols?: string[], abortSignal?: AbortSignalLike): Promise<void>;
+    disconnect(code?: number, reason?: string): Promise<void>;
+    send(data: string | ArrayBuffer, abortSignal?: AbortSignalLike): Promise<void>;
+    onOpen(handler: () => void): void;
+    onClose(handler: (code: number, reason: string) => void): void;
+    onMessage(handler: (data: string | ArrayBuffer) => void): void;
+    onError(handler: (error: Error) => void): void;
+    get isConnected(): boolean;
+    get readyState(): WebSocketState;
+    get url(): string | undefined;
+}
+//# sourceMappingURL=websocketBrowser.d.ts.map

package/dist/esm/websocket/websocketBrowser.js

@@ -0,0 +1,175 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { WebSocketState, } from "./websocketLike.js";
+import { VoiceLiveConnectionError, VoiceLiveErrorCodes } from "../errors/connectionErrors.js";
+/**
+ * Browser WebSocket implementation using native WebSocket API
+ */
+export class VoiceLiveWebSocketBrowser {
+    _ws;
+    _url;
+    _options;
+    _onOpen;
+    _onClose;
+    _onMessage;
+    _onError;
+    constructor(options = {}) {
+        this._options = {
+            connectionTimeoutInMs: 30000,
+            maxMessageSize: 1024 * 1024, // 1MB
+            ...options,
+        };
+    }
+    async connect(url, protocols, abortSignal) {
+        if (this._ws && this._ws.readyState !== WebSocket.CLOSED) {
+            throw new VoiceLiveConnectionError("WebSocket is already connected or connecting", VoiceLiveErrorCodes.AlreadyConnected);
+        }
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                reject(new VoiceLiveConnectionError(`WebSocket connection timeout after ${this._options.connectionTimeoutInMs}ms`, VoiceLiveErrorCodes.ConnectionTimeout));
+            }, this._options.connectionTimeoutInMs);
+            // Handle abort signal
+            const abortHandler = () => {
+                clearTimeout(timeoutId);
+                if (this._ws) {
+                    this._ws.close();
+                }
+                reject(new VoiceLiveConnectionError("WebSocket connection aborted", VoiceLiveErrorCodes.OperationCancelled));
+            };
+            if (abortSignal) {
+                if (abortSignal.aborted) {
+                    abortHandler();
+                    return;
+                }
+                abortSignal.addEventListener("abort", abortHandler);
+            }
+            try {
+                this._ws = new WebSocket(url, protocols);
+                this._ws.binaryType = "arraybuffer";
+                this._url = url;
+                this._ws.addEventListener("open", () => {
+                    clearTimeout(timeoutId);
+                    if (abortSignal) {
+                        abortSignal.removeEventListener("abort", abortHandler);
+                    }
+                    this._onOpen?.();
+                    resolve();
+                });
+                this._ws.addEventListener("close", (event) => {
+                    clearTimeout(timeoutId);
+                    if (abortSignal) {
+                        abortSignal.removeEventListener("abort", abortHandler);
+                    }
+                    this._onClose?.(event.code, event.reason);
+                });
+                this._ws.addEventListener("message", (event) => {
+                    if (typeof event.data === "string") {
+                        this._onMessage?.(event.data);
+                    }
+                    else if (event.data instanceof ArrayBuffer) {
+                        this._onMessage?.(event.data);
+                    }
+                    else if (event.data instanceof Blob) {
+                        // Convert Blob to ArrayBuffer
+                        const reader = new FileReader();
+                        reader.onload = () => {
+                            if (reader.result instanceof ArrayBuffer) {
+                                this._onMessage?.(reader.result);
+                            }
+                        };
+                        reader.onerror = () => {
+                            this._onError?.(new VoiceLiveConnectionError("Failed to read blob data", VoiceLiveErrorCodes.WebSocketError, "blob_read"));
+                        };
+                        reader.readAsArrayBuffer(event.data);
+                    }
+                });
+                this._ws.addEventListener("error", () => {
+                    clearTimeout(timeoutId);
+                    if (abortSignal) {
+                        abortSignal.removeEventListener("abort", abortHandler);
+                    }
+                    const error = new VoiceLiveConnectionError("WebSocket connection failed", VoiceLiveErrorCodes.WebSocketError, "websocket_connection", true);
+                    this._onError?.(error);
+                    reject(error);
+                });
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                if (abortSignal) {
+                    abortSignal.removeEventListener("abort", abortHandler);
+                }
+                reject(new VoiceLiveConnectionError(`Failed to create WebSocket: ${error instanceof Error ? error.message : "Unknown error"}`, VoiceLiveErrorCodes.ConnectionFailed, "websocket_creation", false, error instanceof Error ? error : new Error(String(error))));
+            }
+        });
+    }
+    async disconnect(code = 1000, reason) {
+        if (!this._ws || this._ws.readyState === WebSocket.CLOSED) {
+            return;
+        }
+        return new Promise((resolve) => {
+            const closeHandler = () => {
+                resolve();
+            };
+            if (this._ws.readyState === WebSocket.CLOSING) {
+                this._ws.addEventListener("close", closeHandler, { once: true });
+            }
+            else {
+                this._ws.addEventListener("close", closeHandler, { once: true });
+                this._ws.close(code, reason);
+            }
+        });
+    }
+    async send(data, abortSignal) {
+        if (!this._ws || this._ws.readyState !== WebSocket.OPEN) {
+            throw new VoiceLiveConnectionError("WebSocket is not connected", VoiceLiveErrorCodes.NotConnected);
+        }
+        if (abortSignal?.aborted) {
+            throw new VoiceLiveConnectionError("Send operation aborted", VoiceLiveErrorCodes.OperationCancelled);
+        }
+        return new Promise((resolve, reject) => {
+            const abortHandler = () => {
+                reject(new VoiceLiveConnectionError("Send operation aborted", VoiceLiveErrorCodes.OperationCancelled));
+            };
+            if (abortSignal) {
+                abortSignal.addEventListener("abort", abortHandler, { once: true });
+            }
+            try {
+                this._ws.send(data);
+                if (abortSignal) {
+                    abortSignal.removeEventListener("abort", abortHandler);
+                }
+                resolve();
+            }
+            catch (error) {
+                if (abortSignal) {
+                    abortSignal.removeEventListener("abort", abortHandler);
+                }
+                reject(new VoiceLiveConnectionError(`Failed to send WebSocket message: ${error instanceof Error ? error.message : "Unknown error"}`, VoiceLiveErrorCodes.WebSocketError, "message_send", true, error instanceof Error ? error : new Error(String(error))));
+            }
+        });
+    }
+    onOpen(handler) {
+        this._onOpen = handler;
+    }
+    onClose(handler) {
+        this._onClose = handler;
+    }
+    onMessage(handler) {
+        this._onMessage = handler;
+    }
+    onError(handler) {
+        this._onError = handler;
+    }
+    get isConnected() {
+        return this._ws?.readyState === WebSocket.OPEN;
+    }
+    get readyState() {
+        if (!this._ws)
+            return WebSocketState.Closed;
+        return this._ws.readyState;
+    }
+    get url() {
+        return this._url;
+    }
+}
+//# sourceMappingURL=websocketBrowser.js.map

package/dist/esm/websocket/websocketBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocketBrowser.js","sourceRoot":"","sources":["../../../src/websocket/websocketBrowser.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport {\n  WebSocketState,\n  type VoiceLiveWebSocketLike,\n  type WebSocketFactoryOptions,\n} from \"./websocketLike.js\";\nimport { VoiceLiveConnectionError, VoiceLiveErrorCodes } from \"../errors/connectionErrors.js\";\n\n/**\n * Browser WebSocket implementation using native WebSocket API\n */\nexport class VoiceLiveWebSocketBrowser implements VoiceLiveWebSocketLike {\n  private _ws?: WebSocket;\n  private _url?: string;\n  private _options: WebSocketFactoryOptions;\n\n  private _onOpen?: () => void;\n  private _onClose?: (code: number, reason: string) => void;\n  private _onMessage?: (data: string | ArrayBuffer) => void;\n  private _onError?: (error: Error) => void;\n\n  constructor(options: WebSocketFactoryOptions = {}) {\n    this._options = {\n      connectionTimeoutInMs: 30000,\n      maxMessageSize: 1024 * 1024, // 1MB\n      ...options,\n    };\n  }\n\n  async connect(url: string, protocols?: string[], abortSignal?: AbortSignalLike): Promise<void> {\n    if (this._ws && this._ws.readyState !== WebSocket.CLOSED) {\n      throw new VoiceLiveConnectionError(\n        \"WebSocket is already connected or connecting\",\n        VoiceLiveErrorCodes.AlreadyConnected,\n      );\n    }\n\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        reject(\n          new VoiceLiveConnectionError(\n            `WebSocket connection timeout after ${this._options.connectionTimeoutInMs}ms`,\n            VoiceLiveErrorCodes.ConnectionTimeout,\n          ),\n        );\n      }, this._options.connectionTimeoutInMs);\n      // Handle abort signal\n      const abortHandler = (): void => {\n        clearTimeout(timeoutId);\n        if (this._ws) {\n          this._ws.close();\n        }\n        reject(\n          new VoiceLiveConnectionError(\n            \"WebSocket connection aborted\",\n            VoiceLiveErrorCodes.OperationCancelled,\n          ),\n        );\n      };\n\n      if (abortSignal) {\n        if (abortSignal.aborted) {\n          abortHandler();\n          return;\n        }\n        abortSignal.addEventListener(\"abort\", abortHandler);\n      }\n\n      try {\n        this._ws = new WebSocket(url, protocols);\n        this._ws.binaryType = \"arraybuffer\";\n        this._url = url;\n\n        this._ws.addEventListener(\"open\", () => {\n          clearTimeout(timeoutId);\n          if (abortSignal) {\n            abortSignal.removeEventListener(\"abort\", abortHandler);\n          }\n          this._onOpen?.();\n          resolve();\n        });\n\n        this._ws.addEventListener(\"close\", (event: CloseEvent) => {\n          clearTimeout(timeoutId);\n          if (abortSignal) {\n            abortSignal.removeEventListener(\"abort\", abortHandler);\n          }\n          this._onClose?.(event.code, event.reason);\n        });\n\n        this._ws.addEventListener(\"message\", (event: MessageEvent) => {\n          if (typeof event.data === \"string\") {\n            this._onMessage?.(event.data);\n          } else if (event.data instanceof ArrayBuffer) {\n            this._onMessage?.(event.data);\n          } else if (event.data instanceof Blob) {\n            // Convert Blob to ArrayBuffer\n            const reader = new FileReader();\n            reader.onload = () => {\n              if (reader.result instanceof ArrayBuffer) {\n                this._onMessage?.(reader.result);\n              }\n            };\n            reader.onerror = () => {\n              this._onError?.(\n                new VoiceLiveConnectionError(\n                  \"Failed to read blob data\",\n                  VoiceLiveErrorCodes.WebSocketError,\n                  \"blob_read\",\n                ),\n              );\n            };\n            reader.readAsArrayBuffer(event.data);\n          }\n        });\n\n        this._ws.addEventListener(\"error\", () => {\n          clearTimeout(timeoutId);\n          if (abortSignal) {\n            abortSignal.removeEventListener(\"abort\", abortHandler);\n          }\n          const error = new VoiceLiveConnectionError(\n            \"WebSocket connection failed\",\n            VoiceLiveErrorCodes.WebSocketError,\n            \"websocket_connection\",\n            true,\n          );\n          this._onError?.(error);\n          reject(error);\n        });\n      } catch (error) {\n        clearTimeout(timeoutId);\n        if (abortSignal) {\n          abortSignal.removeEventListener(\"abort\", abortHandler);\n        }\n        reject(\n          new VoiceLiveConnectionError(\n            `Failed to create WebSocket: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n            VoiceLiveErrorCodes.ConnectionFailed,\n            \"websocket_creation\",\n            false,\n            error instanceof Error ? error : new Error(String(error)),\n          ),\n        );\n      }\n    });\n  }\n\n  async disconnect(code: number = 1000, reason?: string): Promise<void> {\n    if (!this._ws || this._ws.readyState === WebSocket.CLOSED) {\n      return;\n    }\n\n    return new Promise((resolve) => {\n      const closeHandler = (): void => {\n        resolve();\n      };\n\n      if (this._ws!.readyState === WebSocket.CLOSING) {\n        this._ws!.addEventListener(\"close\", closeHandler, { once: true });\n      } else {\n        this._ws!.addEventListener(\"close\", closeHandler, { once: true });\n        this._ws!.close(code, reason);\n      }\n    });\n  }\n\n  async send(data: string | ArrayBuffer, abortSignal?: AbortSignalLike): Promise<void> {\n    if (!this._ws || this._ws.readyState !== WebSocket.OPEN) {\n      throw new VoiceLiveConnectionError(\n        \"WebSocket is not connected\",\n        VoiceLiveErrorCodes.NotConnected,\n      );\n    }\n\n    if (abortSignal?.aborted) {\n      throw new VoiceLiveConnectionError(\n        \"Send operation aborted\",\n        VoiceLiveErrorCodes.OperationCancelled,\n      );\n    }\n\n    return new Promise((resolve, reject) => {\n      const abortHandler = (): void => {\n        reject(\n          new VoiceLiveConnectionError(\n            \"Send operation aborted\",\n            VoiceLiveErrorCodes.OperationCancelled,\n          ),\n        );\n      };\n\n      if (abortSignal) {\n        abortSignal.addEventListener(\"abort\", abortHandler, { once: true });\n      }\n\n      try {\n        this._ws!.send(data);\n        if (abortSignal) {\n          abortSignal.removeEventListener(\"abort\", abortHandler);\n        }\n        resolve();\n      } catch (error) {\n        if (abortSignal) {\n          abortSignal.removeEventListener(\"abort\", abortHandler);\n        }\n        reject(\n          new VoiceLiveConnectionError(\n            `Failed to send WebSocket message: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n            VoiceLiveErrorCodes.WebSocketError,\n            \"message_send\",\n            true,\n            error instanceof Error ? error : new Error(String(error)),\n          ),\n        );\n      }\n    });\n  }\n\n  onOpen(handler: () => void): void {\n    this._onOpen = handler;\n  }\n\n  onClose(handler: (code: number, reason: string) => void): void {\n    this._onClose = handler;\n  }\n\n  onMessage(handler: (data: string | ArrayBuffer) => void): void {\n    this._onMessage = handler;\n  }\n\n  onError(handler: (error: Error) => void): void {\n    this._onError = handler;\n  }\n\n  get isConnected(): boolean {\n    return this._ws?.readyState === WebSocket.OPEN;\n  }\n\n  get readyState(): WebSocketState {\n    if (!this._ws) return WebSocketState.Closed;\n    return this._ws.readyState as WebSocketState;\n  }\n\n  get url(): string | undefined {\n    return this._url;\n  }\n}\n"]}

package/dist/esm/websocket/websocketFactory.d.ts

@@ -0,0 +1,23 @@
+import type { VoiceLiveWebSocketLike, VoiceLiveWebSocketFactoryLike, WebSocketFactoryOptions } from "./websocketLike.js";
+/**
+ * Factory for creating platform-appropriate WebSocket instances
+ */
+export declare class VoiceLiveWebSocketFactory implements VoiceLiveWebSocketFactoryLike {
+    create(options?: WebSocketFactoryOptions): VoiceLiveWebSocketLike;
+    private _createBrowserWebSocket;
+    private _createNodeWebSocket;
+    private _detectPlatform;
+}
+/**
+ * Platform detection utility
+ */
+export declare function detectPlatform(): "browser" | "node" | "unknown";
+/**
+ * Check if platform supports WebSocket
+ */
+export declare function isWebSocketSupported(): boolean;
+/**
+ * Default factory instance
+ */
+export declare const defaultWebSocketFactory: VoiceLiveWebSocketFactory;
+//# sourceMappingURL=websocketFactory.d.ts.map

package/dist/esm/websocket/websocketFactory.js

@@ -0,0 +1,80 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Factory for creating platform-appropriate WebSocket instances
+ */
+export class VoiceLiveWebSocketFactory {
+    create(options) {
+        const platform = this._detectPlatform();
+        switch (platform) {
+            case "browser":
+                return this._createBrowserWebSocket(options);
+            case "node":
+                return this._createNodeWebSocket(options);
+            default:
+                throw new Error(`Unsupported environment for WebSocket: ${platform}`);
+        }
+    }
+    _createBrowserWebSocket(options) {
+        // Use dynamic require to avoid bundling Node.js specific code in browser builds
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { VoiceLiveWebSocketBrowser } = require("./websocketBrowser.js");
+        return new VoiceLiveWebSocketBrowser(options);
+    }
+    _createNodeWebSocket(options) {
+        // Use dynamic require to avoid bundling browser specific code in Node.js builds
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { VoiceLiveWebSocketNode } = require("./websocketNode.js");
+        return new VoiceLiveWebSocketNode(options);
+    }
+    _detectPlatform() {
+        // Check for browser environment
+        if (typeof self !== "undefined" && typeof self.WebSocket !== "undefined") {
+            return "browser";
+        }
+        // Check for Node.js environment
+        if (typeof process !== "undefined" &&
+            process.versions != null &&
+            process.versions.node != null) {
+            return "node";
+        }
+        // Check for global object (Node.js) vs window (browser)
+        if (typeof global !== "undefined" && typeof require !== "undefined") {
+            return "node";
+        }
+        return "unknown";
+    }
+}
+/**
+ * Platform detection utility
+ */
+export function detectPlatform() {
+    const factory = new VoiceLiveWebSocketFactory();
+    return factory._detectPlatform();
+}
+/**
+ * Check if platform supports WebSocket
+ */
+export function isWebSocketSupported() {
+    const platform = detectPlatform();
+    switch (platform) {
+        case "browser":
+            return typeof WebSocket !== "undefined";
+        case "node":
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                require("ws");
+                return true;
+            }
+            catch {
+                return false;
+            }
+        default:
+            return false;
+    }
+}
+/**
+ * Default factory instance
+ */
+export const defaultWebSocketFactory = new VoiceLiveWebSocketFactory();
+//# sourceMappingURL=websocketFactory.js.map

package/dist/esm/websocket/websocketFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocketFactory.js","sourceRoot":"","sources":["../../../src/websocket/websocketFactory.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAQlC;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC,MAAM,CAAC,OAAiC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAExC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;YAE/C,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAE5C;gBACE,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAEO,uBAAuB,CAAC,OAAiC;QAC/D,gFAAgF;QAChF,iEAAiE;QACjE,MAAM,EAAE,yBAAyB,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACvE,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAEO,oBAAoB,CAAC,OAAiC;QAC5D,gFAAgF;QAChF,iEAAiE;QACjE,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACjE,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEO,eAAe;QACrB,gCAAgC;QAChC,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,OAAQ,IAAY,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;YAClF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,gCAAgC;QAChC,IACE,OAAO,OAAO,KAAK,WAAW;YAC9B,OAAO,CAAC,QAAQ,IAAI,IAAI;YACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,EAC7B,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,wDAAwD;QACxD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,yBAAyB,EAAE,CAAC;IAChD,OAAQ,OAAe,CAAC,eAAe,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,OAAO,SAAS,KAAK,WAAW,CAAC;QAE1C,KAAK,MAAM;YACT,IAAI,CAAC;gBACH,iEAAiE;gBACjE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QAEH;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,yBAAyB,EAAE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  VoiceLiveWebSocketLike,\n  VoiceLiveWebSocketFactoryLike,\n  WebSocketFactoryOptions,\n} from \"./websocketLike.js\";\n\n/**\n * Factory for creating platform-appropriate WebSocket instances\n */\nexport class VoiceLiveWebSocketFactory implements VoiceLiveWebSocketFactoryLike {\n  create(options?: WebSocketFactoryOptions): VoiceLiveWebSocketLike {\n    const platform = this._detectPlatform();\n\n    switch (platform) {\n      case \"browser\":\n        return this._createBrowserWebSocket(options);\n\n      case \"node\":\n        return this._createNodeWebSocket(options);\n\n      default:\n        throw new Error(`Unsupported environment for WebSocket: ${platform}`);\n    }\n  }\n\n  private _createBrowserWebSocket(options?: WebSocketFactoryOptions): VoiceLiveWebSocketLike {\n    // Use dynamic require to avoid bundling Node.js specific code in browser builds\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const { VoiceLiveWebSocketBrowser } = require(\"./websocketBrowser.js\");\n    return new VoiceLiveWebSocketBrowser(options);\n  }\n\n  private _createNodeWebSocket(options?: WebSocketFactoryOptions): VoiceLiveWebSocketLike {\n    // Use dynamic require to avoid bundling browser specific code in Node.js builds\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const { VoiceLiveWebSocketNode } = require(\"./websocketNode.js\");\n    return new VoiceLiveWebSocketNode(options);\n  }\n\n  private _detectPlatform(): \"browser\" | \"node\" | \"unknown\" {\n    // Check for browser environment\n    if (typeof self !== \"undefined\" && typeof (self as any).WebSocket !== \"undefined\") {\n      return \"browser\";\n    }\n\n    // Check for Node.js environment\n    if (\n      typeof process !== \"undefined\" &&\n      process.versions != null &&\n      process.versions.node != null\n    ) {\n      return \"node\";\n    }\n\n    // Check for global object (Node.js) vs window (browser)\n    if (typeof global !== \"undefined\" && typeof require !== \"undefined\") {\n      return \"node\";\n    }\n\n    return \"unknown\";\n  }\n}\n\n/**\n * Platform detection utility\n */\nexport function detectPlatform(): \"browser\" | \"node\" | \"unknown\" {\n  const factory = new VoiceLiveWebSocketFactory();\n  return (factory as any)._detectPlatform();\n}\n\n/**\n * Check if platform supports WebSocket\n */\nexport function isWebSocketSupported(): boolean {\n  const platform = detectPlatform();\n\n  switch (platform) {\n    case \"browser\":\n      return typeof WebSocket !== \"undefined\";\n\n    case \"node\":\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-require-imports\n        require(\"ws\");\n        return true;\n      } catch {\n        return false;\n      }\n\n    default:\n      return false;\n  }\n}\n\n/**\n * Default factory instance\n */\nexport const defaultWebSocketFactory = new VoiceLiveWebSocketFactory();\n"]}

package/dist/esm/websocket/websocketLike.d.ts

@@ -0,0 +1,78 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+/**
+ * WebSocket ready state enumeration matching standard WebSocket values
+ */
+export declare enum WebSocketState {
+    Connecting = 0,
+    Open = 1,
+    Closing = 2,
+    Closed = 3
+}
+/**
+ * Options for WebSocket creation and connection
+ */
+export interface WebSocketFactoryOptions {
+    /** Connection timeout in milliseconds */
+    connectionTimeoutInMs?: number;
+    /** Maximum message size in bytes */
+    maxMessageSize?: number;
+    /** Enable compression if supported */
+    compression?: boolean;
+    /** Custom headers for connection (Node.js only) */
+    headers?: Record<string, string>;
+}
+/**
+ * Platform-agnostic WebSocket interface for Voice Live connections
+ */
+export interface VoiceLiveWebSocketLike {
+    /**
+     * Establishes WebSocket connection to the specified URL
+     */
+    connect(url: string, protocols?: string[], abortSignal?: AbortSignalLike): Promise<void>;
+    /**
+     * Closes the WebSocket connection
+     */
+    disconnect(code?: number, reason?: string): Promise<void>;
+    /**
+     * Sends data through the WebSocket connection
+     */
+    send(data: string | ArrayBuffer, abortSignal?: AbortSignalLike): Promise<void>;
+    /**
+     * Registers handler for connection open event
+     */
+    onOpen(handler: () => void): void;
+    /**
+     * Registers handler for connection close event
+     */
+    onClose(handler: (code: number, reason: string) => void): void;
+    /**
+     * Registers handler for message reception
+     */
+    onMessage(handler: (data: string | ArrayBuffer) => void): void;
+    /**
+     * Registers handler for connection errors
+     */
+    onError(handler: (error: Error) => void): void;
+    /**
+     * Gets current connection state
+     */
+    readonly isConnected: boolean;
+    /**
+     * Gets current connection state enum
+     */
+    readonly readyState: WebSocketState;
+    /**
+     * Gets the connected URL if applicable
+     */
+    readonly url?: string;
+}
+/**
+ * Factory interface for creating WebSocket instances
+ */
+export interface VoiceLiveWebSocketFactoryLike {
+    /**
+     * Creates a new WebSocket instance for the target platform
+     */
+    create(options?: WebSocketFactoryOptions): VoiceLiveWebSocketLike;
+}
+//# sourceMappingURL=websocketLike.d.ts.map

package/dist/esm/websocket/websocketLike.js

@@ -0,0 +1,13 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * WebSocket ready state enumeration matching standard WebSocket values
+ */
+export var WebSocketState;
+(function (WebSocketState) {
+    WebSocketState[WebSocketState["Connecting"] = 0] = "Connecting";
+    WebSocketState[WebSocketState["Open"] = 1] = "Open";
+    WebSocketState[WebSocketState["Closing"] = 2] = "Closing";
+    WebSocketState[WebSocketState["Closed"] = 3] = "Closed";
+})(WebSocketState || (WebSocketState = {}));
+//# sourceMappingURL=websocketLike.js.map