@azure/ai-voicelive 1.0.0-alpha.20251117.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocketLike.js","sourceRoot":"","sources":["../../../src/websocket/websocketLike.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC;;GAEG;AACH,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,+DAAc,CAAA;IACd,mDAAQ,CAAA;IACR,yDAAW,CAAA;IACX,uDAAU,CAAA;AACZ,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\n\n/**\n * WebSocket ready state enumeration matching standard WebSocket values\n */\nexport enum WebSocketState {\n  Connecting = 0,\n  Open = 1,\n  Closing = 2,\n  Closed = 3,\n}\n\n/**\n * Options for WebSocket creation and connection\n */\nexport interface WebSocketFactoryOptions {\n  /** Connection timeout in milliseconds */\n  connectionTimeoutInMs?: number;\n  /** Maximum message size in bytes */\n  maxMessageSize?: number;\n  /** Enable compression if supported */\n  compression?: boolean;\n  /** Custom headers for connection (Node.js only) */\n  headers?: Record<string, string>;\n}\n\n/**\n * Platform-agnostic WebSocket interface for Voice Live connections\n */\nexport interface VoiceLiveWebSocketLike {\n  /**\n   * Establishes WebSocket connection to the specified URL\n   */\n  connect(url: string, protocols?: string[], abortSignal?: AbortSignalLike): Promise<void>;\n\n  /**\n   * Closes the WebSocket connection\n   */\n  disconnect(code?: number, reason?: string): Promise<void>;\n\n  /**\n   * Sends data through the WebSocket connection\n   */\n  send(data: string | ArrayBuffer, abortSignal?: AbortSignalLike): Promise<void>;\n\n  /**\n   * Registers handler for connection open event\n   */\n  onOpen(handler: () => void): void;\n\n  /**\n   * Registers handler for connection close event\n   */\n  onClose(handler: (code: number, reason: string) => void): void;\n\n  /**\n   * Registers handler for message reception\n   */\n  onMessage(handler: (data: string | ArrayBuffer) => void): void;\n\n  /**\n   * Registers handler for connection errors\n   */\n  onError(handler: (error: Error) => void): void;\n\n  /**\n   * Gets current connection state\n   */\n  readonly isConnected: boolean;\n\n  /**\n   * Gets current connection state enum\n   */\n  readonly readyState: WebSocketState;\n\n  /**\n   * Gets the connected URL if applicable\n   */\n  readonly url?: string;\n}\n\n/**\n * Factory interface for creating WebSocket instances\n */\nexport interface VoiceLiveWebSocketFactoryLike {\n  /**\n   * Creates a new WebSocket instance for the target platform\n   */\n  create(options?: WebSocketFactoryOptions): VoiceLiveWebSocketLike;\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+import { WebSocketState, type VoiceLiveWebSocketLike, type WebSocketFactoryOptions } from "./websocketLike.js";
+/**
+ * Node.js WebSocket implementation using 'ws' library
+ */
+export declare class VoiceLiveWebSocketNode 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=websocketNode.d.ts.map

package/dist/esm/websocket/websocketNode.js

@@ -0,0 +1,180 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import WebSocket from "ws";
+import { WebSocketState, } from "./websocketLike.js";
+import { VoiceLiveConnectionError, VoiceLiveErrorCodes } from "../errors/connectionErrors.js";
+/**
+ * Node.js WebSocket implementation using 'ws' library
+ */
+export class VoiceLiveWebSocketNode {
+    _ws;
+    _url;
+    _options;
+    _onOpen;
+    _onClose;
+    _onMessage;
+    _onError;
+    constructor(options = {}) {
+        this._options = {
+            connectionTimeoutInMs: 30000,
+            maxMessageSize: 1024 * 1024, // 1MB
+            compression: true,
+            ...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.terminate();
+                }
+                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, {
+                    headers: this._options.headers,
+                    maxPayload: this._options.maxMessageSize,
+                    perMessageDeflate: this._options.compression,
+                });
+                this._url = url;
+                this._ws.on("open", () => {
+                    clearTimeout(timeoutId);
+                    if (abortSignal) {
+                        abortSignal.removeEventListener("abort", abortHandler);
+                    }
+                    this._onOpen?.();
+                    resolve();
+                });
+                this._ws.on("close", (code, reason) => {
+                    clearTimeout(timeoutId);
+                    if (abortSignal) {
+                        abortSignal.removeEventListener("abort", abortHandler);
+                    }
+                    this._onClose?.(code, reason.toString());
+                });
+                this._ws.on("message", (data) => {
+                    if (typeof data === "string") {
+                        this._onMessage?.(data);
+                    }
+                    else if (data instanceof Buffer) {
+                        // Convert Buffer to ArrayBuffer
+                        const arrayBuffer = new ArrayBuffer(data.length);
+                        const view = new Uint8Array(arrayBuffer);
+                        view.set(data);
+                        this._onMessage?.(arrayBuffer);
+                    }
+                    else if (data instanceof ArrayBuffer) {
+                        this._onMessage?.(data);
+                    }
+                    else {
+                        // Handle other data types by converting to ArrayBuffer
+                        const buffer = Buffer.from(data);
+                        const arrayBuffer = new ArrayBuffer(buffer.length);
+                        const view = new Uint8Array(arrayBuffer);
+                        view.set(buffer);
+                        this._onMessage?.(arrayBuffer);
+                    }
+                });
+                this._ws.on("error", (error) => {
+                    clearTimeout(timeoutId);
+                    if (abortSignal) {
+                        abortSignal.removeEventListener("abort", abortHandler);
+                    }
+                    this._onError?.(error);
+                    reject(new VoiceLiveConnectionError(`WebSocket error: ${error.message}`, VoiceLiveErrorCodes.WebSocketError, "websocket_connection", true, // Potentially recoverable
+                    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.once("close", closeHandler);
+            }
+            else {
+                this._ws.once("close", closeHandler);
+                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);
+            }
+            this._ws.send(data, (error) => {
+                if (abortSignal) {
+                    abortSignal.removeEventListener("abort", abortHandler);
+                }
+                if (error) {
+                    reject(new VoiceLiveConnectionError(`Failed to send WebSocket message: ${error.message}`, VoiceLiveErrorCodes.WebSocketError, "message_send", true, error));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    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=websocketNode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocketNode.js","sourceRoot":"","sources":["../../../src/websocket/websocketNode.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 WebSocket from \"ws\";\nimport {\n  WebSocketState,\n  type VoiceLiveWebSocketLike,\n  type WebSocketFactoryOptions,\n} from \"./websocketLike.js\";\nimport { VoiceLiveConnectionError, VoiceLiveErrorCodes } from \"../errors/connectionErrors.js\";\n\n/**\n * Node.js WebSocket implementation using 'ws' library\n */\nexport class VoiceLiveWebSocketNode 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      compression: true,\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\n      // Handle abort signal\n      const abortHandler = (): void => {\n        clearTimeout(timeoutId);\n        if (this._ws) {\n          this._ws.terminate();\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          headers: this._options.headers,\n          maxPayload: this._options.maxMessageSize,\n          perMessageDeflate: this._options.compression,\n        });\n\n        this._url = url;\n\n        this._ws.on(\"open\", () => {\n          clearTimeout(timeoutId);\n          if (abortSignal) {\n            abortSignal.removeEventListener(\"abort\", abortHandler);\n          }\n          this._onOpen?.();\n          resolve();\n        });\n\n        this._ws.on(\"close\", (code: number, reason: Buffer) => {\n          clearTimeout(timeoutId);\n          if (abortSignal) {\n            abortSignal.removeEventListener(\"abort\", abortHandler);\n          }\n          this._onClose?.(code, reason.toString());\n        });\n\n        this._ws.on(\"message\", (data: WebSocket.Data) => {\n          if (typeof data === \"string\") {\n            this._onMessage?.(data);\n          } else if (data instanceof Buffer) {\n            // Convert Buffer to ArrayBuffer\n            const arrayBuffer = new ArrayBuffer(data.length);\n            const view = new Uint8Array(arrayBuffer);\n            view.set(data);\n            this._onMessage?.(arrayBuffer);\n          } else if (data instanceof ArrayBuffer) {\n            this._onMessage?.(data);\n          } else {\n            // Handle other data types by converting to ArrayBuffer\n            const buffer = Buffer.from(data as any);\n            const arrayBuffer = new ArrayBuffer(buffer.length);\n            const view = new Uint8Array(arrayBuffer);\n            view.set(buffer);\n            this._onMessage?.(arrayBuffer);\n          }\n        });\n\n        this._ws.on(\"error\", (error: Error) => {\n          clearTimeout(timeoutId);\n          if (abortSignal) {\n            abortSignal.removeEventListener(\"abort\", abortHandler);\n          }\n          this._onError?.(error);\n          reject(\n            new VoiceLiveConnectionError(\n              `WebSocket error: ${error.message}`,\n              VoiceLiveErrorCodes.WebSocketError,\n              \"websocket_connection\",\n              true, // Potentially recoverable\n              error,\n            ),\n          );\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!.once(\"close\", closeHandler);\n      } else {\n        this._ws!.once(\"close\", closeHandler);\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);\n      }\n\n      this._ws!.send(data, (error?: Error) => {\n        if (abortSignal) {\n          abortSignal.removeEventListener(\"abort\", abortHandler);\n        }\n\n        if (error) {\n          reject(\n            new VoiceLiveConnectionError(\n              `Failed to send WebSocket message: ${error.message}`,\n              VoiceLiveErrorCodes.WebSocketError,\n              \"message_send\",\n              true,\n              error,\n            ),\n          );\n        } else {\n          resolve();\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/react-native/auth/credentialHandler.d.ts

@@ -0,0 +1,43 @@
+import type { TokenCredential, KeyCredential } from "@azure/core-auth";
+/**
+ * Union type for supported credential types
+ */
+export type VoiceLiveCredential = TokenCredential | KeyCredential;
+/**
+ * Handles both Azure TokenCredential and KeyCredential authentication for Voice Live service
+ */
+export declare class CredentialHandler {
+    private _accessToken?;
+    private readonly _scope;
+    private readonly _tokenRefreshBuffer;
+    private readonly _credential;
+    private readonly _isApiKey;
+    constructor(credential: VoiceLiveCredential, scope?: string);
+    /**
+     * Gets a valid access token or API key, refreshing if necessary
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Builds the WebSocket URL with authentication
+     */
+    getWebSocketUrl(baseEndpoint: string, apiVersion: string, model?: string): Promise<string>;
+    /**
+     * Gets authentication headers for the WebSocket connection
+     */
+    getAuthHeaders(): Promise<Record<string, string>>;
+    /**
+     * Returns the type of credential being used
+     */
+    get credentialType(): "key" | "token";
+    /**
+     * Returns whether this is using an API key credential
+     */
+    get isApiKey(): boolean;
+    /**
+     * For API key credentials, allows updating the key
+     */
+    updateApiKey(newKey: string): void;
+    private _isTokenValid;
+    private _generateRequestId;
+}
+//# sourceMappingURL=credentialHandler.d.ts.map

package/dist/react-native/auth/credentialHandler.js

@@ -0,0 +1,147 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { VoiceLiveAuthenticationError, VoiceLiveErrorCodes } from "../errors/index.js";
+import { logger } from "../logger.js";
+/**
+ * Type guard to check if credential is a KeyCredential
+ */
+function isKeyCredential(credential) {
+    return "key" in credential && typeof credential.key === "string";
+}
+/**
+ * Handles both Azure TokenCredential and KeyCredential authentication for Voice Live service
+ */
+export class CredentialHandler {
+    _accessToken;
+    _scope;
+    _tokenRefreshBuffer = 5 * 60 * 1000; // 5 minutes
+    _credential;
+    _isApiKey;
+    constructor(credential, scope) {
+        this._credential = credential;
+        this._isApiKey = isKeyCredential(credential);
+        // Voice Live specific scope - may need adjustment based on actual service
+        this._scope = scope || "https://cognitiveservices.azure.com/.default";
+        logger.info("CredentialHandler initialized", {
+            credentialType: this._isApiKey ? "KeyCredential" : "TokenCredential",
+            scope: this._scope,
+        });
+    }
+    /**
+     * Gets a valid access token or API key, refreshing if necessary
+     */
+    async getAccessToken() {
+        // For API Key credentials, return the key directly
+        if (this._isApiKey) {
+            const keyCredential = this._credential;
+            logger.info("Using API key for authentication");
+            return keyCredential.key;
+        }
+        // For Token credentials, handle token lifecycle
+        const tokenCredential = this._credential;
+        // Check if current token is still valid
+        if (this._accessToken && this._isTokenValid(this._accessToken)) {
+            return this._accessToken.token;
+        }
+        try {
+            logger.info("Acquiring new access token", { scope: this._scope });
+            // Get new token from credential
+            const tokenResponse = await tokenCredential.getToken(this._scope);
+            if (!tokenResponse) {
+                throw new VoiceLiveAuthenticationError("Failed to acquire access token - credential returned null", VoiceLiveErrorCodes.AuthenticationFailed);
+            }
+            this._accessToken = tokenResponse;
+            logger.info("Successfully acquired access token", {
+                expiresAt: new Date(this._accessToken.expiresOnTimestamp),
+            });
+            return this._accessToken.token;
+        }
+        catch (error) {
+            logger.error("Failed to obtain access token", { error, scope: this._scope });
+            if (error instanceof VoiceLiveAuthenticationError) {
+                throw error;
+            }
+            throw new VoiceLiveAuthenticationError(`Failed to obtain access token: ${error instanceof Error ? error.message : "Unknown error"}`, VoiceLiveErrorCodes.AuthenticationFailed, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Builds the WebSocket URL with authentication
+     */
+    async getWebSocketUrl(baseEndpoint, apiVersion, model) {
+        const authValue = await this.getAccessToken();
+        const url = new URL(baseEndpoint);
+        url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+        url.pathname = "/voice-live/realtime"; // Voice Live WebSocket endpoint path
+        url.searchParams.set("api-version", apiVersion);
+        // Add model parameter if provided
+        if (model) {
+            url.searchParams.set("model", model);
+        }
+        // For API keys, add as query parameter
+        if (this._isApiKey) {
+            url.searchParams.set("api-key", authValue);
+        }
+        else {
+            // For tokens, we'll use headers instead of query params
+            // The token will be added in getAuthHeaders()
+        }
+        return url.toString();
+    }
+    /**
+     * Gets authentication headers for the WebSocket connection
+     */
+    async getAuthHeaders() {
+        const authValue = await this.getAccessToken();
+        const headers = {
+            "X-MS-Client-Request-ID": this._generateRequestId(),
+            "User-Agent": "Azure-Voice-Live-SDK-JS/1.0.0",
+        };
+        // Add appropriate authentication header based on credential type
+        if (this._isApiKey) {
+            // For API keys, use the X-API-Key header or similar
+            headers["api-key"] = authValue;
+        }
+        else {
+            // For tokens, use standard Bearer authorization
+            headers["Authorization"] = `Bearer ${authValue}`;
+        }
+        return headers;
+    }
+    /**
+     * Returns the type of credential being used
+     */
+    get credentialType() {
+        return this._isApiKey ? "key" : "token";
+    }
+    /**
+     * Returns whether this is using an API key credential
+     */
+    get isApiKey() {
+        return this._isApiKey;
+    }
+    /**
+     * For API key credentials, allows updating the key
+     */
+    updateApiKey(newKey) {
+        if (!this._isApiKey) {
+            throw new VoiceLiveAuthenticationError("Cannot update API key on TokenCredential", VoiceLiveErrorCodes.InvalidCredentials);
+        }
+        const keyCredential = this._credential;
+        if ("update" in keyCredential && typeof keyCredential.update === "function") {
+            keyCredential.update(newKey);
+            logger.info("API key updated");
+        }
+        else {
+            throw new VoiceLiveAuthenticationError("KeyCredential does not support key updates", VoiceLiveErrorCodes.InvalidCredentials);
+        }
+    }
+    _isTokenValid(token) {
+        const expiresAt = token.expiresOnTimestamp;
+        const now = Date.now();
+        return expiresAt > now + this._tokenRefreshBuffer;
+    }
+    _generateRequestId() {
+        return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+    }
+}
+//# sourceMappingURL=credentialHandler.js.map

package/dist/react-native/auth/credentialHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentialHandler.js","sourceRoot":"","sources":["../../../src/auth/credentialHandler.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { TokenCredential, KeyCredential, AccessToken } from \"@azure/core-auth\";\nimport { VoiceLiveAuthenticationError, VoiceLiveErrorCodes } from \"../errors/index.js\";\nimport { logger } from \"../logger.js\";\n\n/**\n * Union type for supported credential types\n */\nexport type VoiceLiveCredential = TokenCredential | KeyCredential;\n\n/**\n * Type guard to check if credential is a KeyCredential\n */\nfunction isKeyCredential(credential: VoiceLiveCredential): credential is KeyCredential {\n  return \"key\" in credential && typeof (credential as KeyCredential).key === \"string\";\n}\n\n/**\n * Handles both Azure TokenCredential and KeyCredential authentication for Voice Live service\n */\nexport class CredentialHandler {\n  private _accessToken?: AccessToken;\n  private readonly _scope: string;\n  private readonly _tokenRefreshBuffer = 5 * 60 * 1000; // 5 minutes\n  private readonly _credential: VoiceLiveCredential;\n  private readonly _isApiKey: boolean;\n\n  constructor(credential: VoiceLiveCredential, scope?: string) {\n    this._credential = credential;\n    this._isApiKey = isKeyCredential(credential);\n\n    // Voice Live specific scope - may need adjustment based on actual service\n    this._scope = scope || \"https://cognitiveservices.azure.com/.default\";\n\n    logger.info(\"CredentialHandler initialized\", {\n      credentialType: this._isApiKey ? \"KeyCredential\" : \"TokenCredential\",\n      scope: this._scope,\n    });\n  }\n\n  /**\n   * Gets a valid access token or API key, refreshing if necessary\n   */\n  async getAccessToken(): Promise<string> {\n    // For API Key credentials, return the key directly\n    if (this._isApiKey) {\n      const keyCredential = this._credential as KeyCredential;\n      logger.info(\"Using API key for authentication\");\n      return keyCredential.key;\n    }\n\n    // For Token credentials, handle token lifecycle\n    const tokenCredential = this._credential as TokenCredential;\n\n    // Check if current token is still valid\n    if (this._accessToken && this._isTokenValid(this._accessToken)) {\n      return this._accessToken.token;\n    }\n\n    try {\n      logger.info(\"Acquiring new access token\", { scope: this._scope });\n\n      // Get new token from credential\n      const tokenResponse = await tokenCredential.getToken(this._scope);\n\n      if (!tokenResponse) {\n        throw new VoiceLiveAuthenticationError(\n          \"Failed to acquire access token - credential returned null\",\n          VoiceLiveErrorCodes.AuthenticationFailed,\n        );\n      }\n\n      this._accessToken = tokenResponse;\n\n      logger.info(\"Successfully acquired access token\", {\n        expiresAt: new Date(this._accessToken.expiresOnTimestamp),\n      });\n\n      return this._accessToken.token;\n    } catch (error) {\n      logger.error(\"Failed to obtain access token\", { error, scope: this._scope });\n\n      if (error instanceof VoiceLiveAuthenticationError) {\n        throw error;\n      }\n\n      throw new VoiceLiveAuthenticationError(\n        `Failed to obtain access token: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        VoiceLiveErrorCodes.AuthenticationFailed,\n        error instanceof Error ? error : new Error(String(error)),\n      );\n    }\n  }\n\n  /**\n   * Builds the WebSocket URL with authentication\n   */\n  async getWebSocketUrl(baseEndpoint: string, apiVersion: string, model?: string): Promise<string> {\n    const authValue = await this.getAccessToken();\n\n    const url = new URL(baseEndpoint);\n    url.protocol = url.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n    url.pathname = \"/voice-live/realtime\"; // Voice Live WebSocket endpoint path\n    url.searchParams.set(\"api-version\", apiVersion);\n\n    // Add model parameter if provided\n    if (model) {\n      url.searchParams.set(\"model\", model);\n    }\n\n    // For API keys, add as query parameter\n    if (this._isApiKey) {\n      url.searchParams.set(\"api-key\", authValue);\n    } else {\n      // For tokens, we'll use headers instead of query params\n      // The token will be added in getAuthHeaders()\n    }\n\n    return url.toString();\n  }\n\n  /**\n   * Gets authentication headers for the WebSocket connection\n   */\n  async getAuthHeaders(): Promise<Record<string, string>> {\n    const authValue = await this.getAccessToken();\n\n    const headers: Record<string, string> = {\n      \"X-MS-Client-Request-ID\": this._generateRequestId(),\n      \"User-Agent\": \"Azure-Voice-Live-SDK-JS/1.0.0\",\n    };\n\n    // Add appropriate authentication header based on credential type\n    if (this._isApiKey) {\n      // For API keys, use the X-API-Key header or similar\n      headers[\"api-key\"] = authValue;\n    } else {\n      // For tokens, use standard Bearer authorization\n      headers[\"Authorization\"] = `Bearer ${authValue}`;\n    }\n\n    return headers;\n  }\n\n  /**\n   * Returns the type of credential being used\n   */\n  get credentialType(): \"key\" | \"token\" {\n    return this._isApiKey ? \"key\" : \"token\";\n  }\n\n  /**\n   * Returns whether this is using an API key credential\n   */\n  get isApiKey(): boolean {\n    return this._isApiKey;\n  }\n\n  /**\n   * For API key credentials, allows updating the key\n   */\n  updateApiKey(newKey: string): void {\n    if (!this._isApiKey) {\n      throw new VoiceLiveAuthenticationError(\n        \"Cannot update API key on TokenCredential\",\n        VoiceLiveErrorCodes.InvalidCredentials,\n      );\n    }\n\n    const keyCredential = this._credential as KeyCredential;\n    if (\"update\" in keyCredential && typeof keyCredential.update === \"function\") {\n      keyCredential.update(newKey);\n      logger.info(\"API key updated\");\n    } else {\n      throw new VoiceLiveAuthenticationError(\n        \"KeyCredential does not support key updates\",\n        VoiceLiveErrorCodes.InvalidCredentials,\n      );\n    }\n  }\n\n  private _isTokenValid(token: AccessToken): boolean {\n    const expiresAt = token.expiresOnTimestamp;\n    const now = Date.now();\n    return expiresAt > now + this._tokenRefreshBuffer;\n  }\n\n  private _generateRequestId(): string {\n    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n  }\n}\n"]}

package/dist/react-native/errors/connectionErrors.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Error codes for Voice Live WebSocket operations
+ */
+export declare enum VoiceLiveErrorCodes {
+    ConnectionFailed = "CONNECTION_FAILED",
+    ConnectionTimeout = "CONNECTION_TIMEOUT",
+    ConnectionLost = "CONNECTION_LOST",
+    AlreadyConnected = "ALREADY_CONNECTED",
+    NotConnected = "NOT_CONNECTED",
+    WebSocketError = "WEBSOCKET_ERROR",
+    AuthenticationFailed = "AUTHENTICATION_FAILED",
+    InvalidCredentials = "INVALID_CREDENTIALS",
+    Unauthorized = "UNAUTHORIZED",
+    Forbidden = "FORBIDDEN",
+    InvalidMessage = "INVALID_MESSAGE",
+    MessageTooLarge = "MESSAGE_TOO_LARGE",
+    ProtocolError = "PROTOCOL_ERROR",
+    BufferOverflow = "BUFFER_OVERFLOW",
+    OperationCancelled = "OPERATION_CANCELLED",
+    InvalidState = "INVALID_STATE"
+}
+/**
+ * Base error class for Voice Live WebSocket operations
+ */
+export declare class VoiceLiveConnectionError extends Error {
+    /** Error code identifying the specific error type */
+    readonly code: string;
+    /** Context information about where the error occurred */
+    readonly context: string;
+    /** Indicates whether this error is potentially recoverable */
+    readonly recoverable: boolean;
+    /** The original error that caused this error, if any */
+    readonly cause?: Error;
+    /** Timestamp when the error occurred */
+    readonly timestamp: Date;
+    constructor(message: string, code: string, context?: string, recoverable?: boolean, cause?: Error);
+}
+/**
+ * Authentication error class for Voice Live operations
+ */
+export declare class VoiceLiveAuthenticationError extends VoiceLiveConnectionError {
+    constructor(message: string, code: string, cause?: Error);
+}
+/**
+ * Protocol error class for Voice Live message operations
+ */
+export declare class VoiceLiveProtocolError extends VoiceLiveConnectionError {
+    constructor(message: string, code: string, cause?: Error);
+}
+/**
+ * General Voice Live error class
+ */
+export declare class VoiceLiveError extends VoiceLiveConnectionError {
+    constructor(message: string, code: string, context?: string, recoverable?: boolean, cause?: Error);
+}
+/**
+ * Classifies a WebSocket close event and returns appropriate error
+ */
+export declare function classifyWebSocketClose(code: number, reason: string): VoiceLiveConnectionError;
+/**
+ * Classifies connection errors
+ */
+export declare function classifyConnectionError(error: VoiceLiveConnectionError | Error | unknown): VoiceLiveConnectionError;
+/**
+ * Classifies protocol errors
+ */
+export declare function classifyProtocolError(error: Error, messageType: string): VoiceLiveProtocolError;
+//# sourceMappingURL=connectionErrors.d.ts.map