@telnyx/webrtc 2.27.1 → 2.27.2-beta.1

package/lib/src/Modules/Verto/BaseSession.d.ts

@@ -33,6 +33,8 @@ export default abstract class BaseSession {
     protected _autoReconnect: boolean;
     protected _idle: boolean;
     protected _reconnectAttempts: number;
+    private _reconnectCountedGeneration;
+    protected _intentionalClose: boolean;
     private _tokenExpiryTimeout;
     private static readonly TOKEN_EXPIRY_WARNING_SECONDS;
     private static readonly CALL_REPORT_UPLOAD_DRAIN_TIMEOUT_MS;
@@ -84,6 +86,7 @@ export default abstract class BaseSession {
         reason?: string;
         wasClean?: boolean;
         error?: unknown;
+        socketGeneration?: number;
     }): void;
     protected _onSocketMessage(_response: any): void;
     protected _removeSubscription(protocol: string, channel?: string): void;
@@ -98,12 +101,14 @@ export default abstract class BaseSession {
     setPingReceived(): void;
     private _onSocketActivity;
     hasActiveCall(): boolean;
+    _terminateActiveCallsLocally(): void;
     startSignalingHealthMonitor(): void;
     stopSignalingHealthMonitor(): void;
     triggerIceRestart(callId: string): TriggerIceRestartResult;
     onSignalingRequestTimeout(requestId: string, timeoutMs: number, method?: string): void;
     reportPeerFailure(callId: string, evidence: PeerFailureEvidence): void;
     reportNoRtp(callId: string, direction: 'inbound' | 'outbound'): void;
+    reportIceRestartFailed(callId: string): void;
     static on(eventName: string, callback: any): void;
     static off(eventName: string): void;
     static uuid(): string;

package/lib/src/Modules/Verto/BrowserSession.d.ts

@@ -6,6 +6,10 @@ export default abstract class BrowserSession extends BaseSession {
     calls: {
         [callId: string]: IWebRTCCall;
     };
+    private static readonly ACTIVE_CALL_STATE_NAMES;
+    getActiveCalls(): IWebRTCCall[];
+    private _extractSafeCallIdentifiers;
+    emitMultipleActiveCallsWarning(newCallId: string): void;
     micId: string;
     micLabel: string;
     camId: string;
@@ -25,7 +29,6 @@ export default abstract class BrowserSession extends BaseSession {
     private _offlineHandler;
     private _wasOffline;
     constructor(options: IVertoOptions);
-    get reconnectDelay(): number;
     getIsRegistered(): Promise<boolean>;
     connect(): Promise<void>;
     checkPermissions(audio?: boolean, video?: boolean): Promise<boolean>;

package/lib/src/Modules/Verto/messages/WebRTCStats.d.ts

@@ -6,5 +6,5 @@ export declare class DebugReportStopMessage extends BaseMessage {
     constructor(id: string, callID: string);
 }
 export declare class DebugReportDataMessage extends BaseMessage {
-    constructor(id: string, data: any);
+    constructor(id: string, callID: string, data: unknown);
 }

package/lib/src/Modules/Verto/services/SignalingHealthMonitor.d.ts

@@ -19,6 +19,7 @@ export default class SignalingHealthMonitor {
     onRequestTimeout(requestId: string, timeoutMs: number, method?: string): void;
     onPeerFailure(callId: string, evidence: PeerFailureEvidence): void;
     onNoRtp(callId: string, direction: 'inbound' | 'outbound'): void;
+    onIceRestartFailed(callId: string): void;
     private _check;
     private _sendProbe;
     private _recoverMediaOrSignaling;

package/lib/src/Modules/Verto/util/constants/errorCodes.d.ts

@@ -21,6 +21,7 @@ export declare const TELNYX_ERROR_CODES: {
     readonly AUTHENTICATION_REQUIRED: 46003;
     readonly ICE_RESTART_FAILED: 47001;
     readonly NETWORK_OFFLINE: 48001;
+    readonly SESSION_NOT_REATTACHED: 48501;
     readonly UNEXPECTED_ERROR: 49001;
 };
 export declare const TELNYX_WARNING_CODES: {
@@ -29,6 +30,7 @@ export declare const TELNYX_WARNING_CODES: {
     readonly HIGH_PACKET_LOSS: 31003;
     readonly LOW_MOS: 31004;
     readonly LOW_LOCAL_AUDIO: 31005;
+    readonly LOW_INBOUND_AUDIO: 31006;
     readonly LOW_BYTES_RECEIVED: 32001;
     readonly LOW_BYTES_SENT: 32002;
     readonly ICE_CONNECTIVITY_LOST: 33001;
@@ -38,14 +40,15 @@ export declare const TELNYX_WARNING_CODES: {
     readonly ONLY_HOST_ICE_CANDIDATES: 33005;
     readonly ANSWER_WHILE_PEER_ACTIVE: 33006;
     readonly ICE_CANDIDATE_PAIR_CHANGED: 33008;
+    readonly AUDIO_INPUT_DEVICE_CHANGE_SKIPPED: 33009;
+    readonly MULTIPLE_ACTIVE_CALLS_DETECTED: 33010;
     readonly DUPLICATE_INBOUND_ANSWER: 33007;
     readonly TOKEN_EXPIRING_SOON: 34001;
-    readonly SESSION_NOT_REATTACHED: 35001;
-    readonly SIGNALING_HEALTH_PROBE_TIMEOUT: 36001;
-    readonly SIGNALING_REQUEST_TIMEOUT: 36002;
+    readonly UNKNOWN_REATTACHED_SESSION: 35002;
     readonly SIGNALING_RECOVERY_REQUIRED: 36003;
     readonly MEDIA_RECOVERY_REQUIRED: 36004;
+    readonly RECONNECTION_FAILED_WITH_NO_AUTO_RECONNECT: 36005;
 };
-export declare const SDP_CREATE_OFFER_FAILED: 40001, SDP_CREATE_ANSWER_FAILED: 40002, SDP_SET_LOCAL_DESCRIPTION_FAILED: 40003, SDP_SET_REMOTE_DESCRIPTION_FAILED: 40004, SDP_SEND_FAILED: 40005, MEDIA_MICROPHONE_PERMISSION_DENIED: 42001, MEDIA_DEVICE_NOT_FOUND: 42002, MEDIA_GET_USER_MEDIA_FAILED: 42003, HOLD_FAILED: 44001, INVALID_CALL_PARAMETERS: 44002, BYE_SEND_FAILED: 44003, SUBSCRIBE_FAILED: 44004, PEER_CLOSED_DURING_INIT: 44005, WEBSOCKET_CONNECTION_FAILED: 45001, WEBSOCKET_ERROR: 45002, RECONNECTION_EXHAUSTED: 45003, GATEWAY_FAILED: 45004, LOGIN_FAILED: 46001, INVALID_CREDENTIALS: 46002, AUTHENTICATION_REQUIRED: 46003, ICE_RESTART_FAILED: 47001, NETWORK_OFFLINE: 48001, UNEXPECTED_ERROR: 49001;
-export declare const HIGH_RTT: 31001, HIGH_JITTER: 31002, HIGH_PACKET_LOSS: 31003, LOW_MOS: 31004, LOW_LOCAL_AUDIO: 31005, LOW_BYTES_RECEIVED: 32001, LOW_BYTES_SENT: 32002, ICE_CONNECTIVITY_LOST: 33001, ICE_GATHERING_TIMEOUT: 33002, ICE_GATHERING_EMPTY: 33003, PEER_CONNECTION_FAILED: 33004, ONLY_HOST_ICE_CANDIDATES: 33005, ANSWER_WHILE_PEER_ACTIVE: 33006, ICE_CANDIDATE_PAIR_CHANGED: 33008, DUPLICATE_INBOUND_ANSWER: 33007, TOKEN_EXPIRING_SOON: 34001, SESSION_NOT_REATTACHED: 35001, SIGNALING_HEALTH_PROBE_TIMEOUT: 36001, SIGNALING_REQUEST_TIMEOUT: 36002, SIGNALING_RECOVERY_REQUIRED: 36003, MEDIA_RECOVERY_REQUIRED: 36004;
+export declare const SDP_CREATE_OFFER_FAILED: 40001, SDP_CREATE_ANSWER_FAILED: 40002, SDP_SET_LOCAL_DESCRIPTION_FAILED: 40003, SDP_SET_REMOTE_DESCRIPTION_FAILED: 40004, SDP_SEND_FAILED: 40005, MEDIA_MICROPHONE_PERMISSION_DENIED: 42001, MEDIA_DEVICE_NOT_FOUND: 42002, MEDIA_GET_USER_MEDIA_FAILED: 42003, HOLD_FAILED: 44001, INVALID_CALL_PARAMETERS: 44002, BYE_SEND_FAILED: 44003, SUBSCRIBE_FAILED: 44004, PEER_CLOSED_DURING_INIT: 44005, WEBSOCKET_CONNECTION_FAILED: 45001, WEBSOCKET_ERROR: 45002, RECONNECTION_EXHAUSTED: 45003, GATEWAY_FAILED: 45004, LOGIN_FAILED: 46001, INVALID_CREDENTIALS: 46002, AUTHENTICATION_REQUIRED: 46003, ICE_RESTART_FAILED: 47001, NETWORK_OFFLINE: 48001, SESSION_NOT_REATTACHED: 48501, UNEXPECTED_ERROR: 49001;
+export declare const HIGH_RTT: 31001, HIGH_JITTER: 31002, HIGH_PACKET_LOSS: 31003, LOW_MOS: 31004, LOW_LOCAL_AUDIO: 31005, LOW_INBOUND_AUDIO: 31006, LOW_BYTES_RECEIVED: 32001, LOW_BYTES_SENT: 32002, ICE_CONNECTIVITY_LOST: 33001, ICE_GATHERING_TIMEOUT: 33002, ICE_GATHERING_EMPTY: 33003, PEER_CONNECTION_FAILED: 33004, ONLY_HOST_ICE_CANDIDATES: 33005, ANSWER_WHILE_PEER_ACTIVE: 33006, ICE_CANDIDATE_PAIR_CHANGED: 33008, AUDIO_INPUT_DEVICE_CHANGE_SKIPPED: 33009, MULTIPLE_ACTIVE_CALLS_DETECTED: 33010, DUPLICATE_INBOUND_ANSWER: 33007, TOKEN_EXPIRING_SOON: 34001, UNKNOWN_REATTACHED_SESSION: 35002, SIGNALING_RECOVERY_REQUIRED: 36003, MEDIA_RECOVERY_REQUIRED: 36004, RECONNECTION_FAILED_WITH_NO_AUTO_RECONNECT: 36005;
 export declare const HAS_NON_HOST_ICE_CANDIDATE_REGEX: RegExp;

package/lib/src/Modules/Verto/util/constants/errors.d.ts

@@ -1,10 +1,11 @@
-export declare const SDK_ERRORS: {
+export declare const _SDK_ERRORS: {
     readonly 40001: {
         readonly name: "SDP_CREATE_OFFER_FAILED";
         readonly message: "Failed to create call offer";
         readonly description: "The browser was unable to generate a local SDP offer. This typically indicates a WebRTC API error or invalid media constraints.";
         readonly causes: readonly ["Browser WebRTC API error", "Missing or invalid media constraints"];
         readonly solutions: readonly ["Check getUserMedia permissions", "Verify ICE server configuration"];
+        readonly fatal: true;
     };
     readonly 40002: {
         readonly name: "SDP_CREATE_ANSWER_FAILED";
@@ -12,6 +13,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The browser was unable to generate a local SDP answer. The remote offer may be invalid or the browser state inconsistent.";
         readonly causes: readonly ["Browser WebRTC API error", "Invalid remote SDP offer"];
         readonly solutions: readonly ["Retry the call", "Check browser WebRTC compatibility"];
+        readonly fatal: true;
     };
     readonly 40003: {
         readonly name: "SDP_SET_LOCAL_DESCRIPTION_FAILED";
@@ -19,6 +21,7 @@ export declare const SDK_ERRORS: {
         readonly description: "setLocalDescription() was rejected by the browser. The generated SDP may be malformed or the browser state may be inconsistent.";
         readonly causes: readonly ["Malformed SDP", "Browser state inconsistency"];
         readonly solutions: readonly ["Retry the call"];
+        readonly fatal: true;
     };
     readonly 40004: {
         readonly name: "SDP_SET_REMOTE_DESCRIPTION_FAILED";
@@ -26,6 +29,7 @@ export declare const SDK_ERRORS: {
         readonly description: "setRemoteDescription() was rejected by the browser. The remote SDP may be malformed or contain unsupported codecs.";
         readonly causes: readonly ["Malformed remote SDP", "Browser codec mismatch"];
         readonly solutions: readonly ["Retry the call", "Check codec configuration"];
+        readonly fatal: true;
     };
     readonly 40005: {
         readonly name: "SDP_SEND_FAILED";
@@ -33,6 +37,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The Invite or Answer message could not be delivered via the signaling WebSocket. The connection may have been lost.";
         readonly causes: readonly ["WebSocket connection lost", "Server error"];
         readonly solutions: readonly ["Check network connectivity", "Retry the call"];
+        readonly fatal: true;
     };
     readonly 42001: {
         readonly name: "MEDIA_MICROPHONE_PERMISSION_DENIED";
@@ -40,6 +45,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The user or operating system denied microphone permission. The browser permission prompt was dismissed or OS-level access is disabled.";
         readonly causes: readonly ["User denied browser permission prompt", "OS-level microphone access disabled"];
         readonly solutions: readonly ["Ask user to grant microphone permission in browser settings"];
+        readonly fatal: true;
     };
     readonly 42002: {
         readonly name: "MEDIA_DEVICE_NOT_FOUND";
@@ -47,6 +53,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The requested audio input device is not available. No microphone is connected, the device was disconnected, or an invalid deviceId was specified.";
         readonly causes: readonly ["No microphone connected", "Device was disconnected", "Invalid deviceId"];
         readonly solutions: readonly ["Check that a microphone is connected", "Select a valid audio input device"];
+        readonly fatal: true;
     };
     readonly 42003: {
         readonly name: "MEDIA_GET_USER_MEDIA_FAILED";
@@ -54,6 +61,39 @@ export declare const SDK_ERRORS: {
         readonly description: "getUserMedia() was rejected for an unexpected reason. The device may be in use by another application or the browser encountered an internal error.";
         readonly causes: readonly ["Browser error", "Device in use by another application"];
         readonly solutions: readonly ["Close other applications using the microphone", "Retry"];
+        readonly fatal: true;
+    };
+    readonly 44001: {
+        readonly name: "HOLD_FAILED";
+        readonly message: "Failed to hold the call";
+        readonly description: "The server rejected or did not respond to the hold request. The WebSocket connection may have been lost during the operation.";
+        readonly causes: readonly ["Server error", "WebSocket connection lost during hold"];
+        readonly solutions: readonly ["Retry the hold operation", "Check network connectivity"];
+        readonly fatal: false;
+    };
+    readonly 44002: {
+        readonly name: "INVALID_CALL_PARAMETERS";
+        readonly message: "Invalid call parameters";
+        readonly description: "The call could not be initiated because required parameters are missing or invalid. For example, no destination number was provided to newCall().";
+        readonly causes: readonly ["Missing destinationNumber in call options", "Invalid or empty call parameters"];
+        readonly solutions: readonly ["Provide a valid destinationNumber when calling newCall()", "Check the call options object for required fields"];
+        readonly fatal: true;
+    };
+    readonly 44003: {
+        readonly name: "BYE_SEND_FAILED";
+        readonly message: "Failed to hang up cleanly";
+        readonly description: "The hangup signal could not be delivered to the server. The call was terminated locally but the server may not be aware.";
+        readonly causes: readonly ["WebSocket connection lost before BYE sent"];
+        readonly solutions: readonly ["No action needed — call is terminated locally", "Check network connectivity"];
+        readonly fatal: false;
+    };
+    readonly 44004: {
+        readonly name: "SUBSCRIBE_FAILED";
+        readonly message: "Failed to subscribe to call events";
+        readonly description: "The Verto subscribe request for the call channel failed. This may prevent receiving call state updates from the server.";
+        readonly causes: readonly ["WebSocket connection lost during subscribe", "Server rejected the subscription request"];
+        readonly solutions: readonly ["Check network connectivity", "Retry the call"];
+        readonly fatal: false;
     };
     readonly 44005: {
         readonly name: "PEER_CLOSED_DURING_INIT";
@@ -61,6 +101,161 @@ export declare const SDK_ERRORS: {
         readonly description: "The PeerConnection was closed (e.g. by hangup()) while peer.init() was still running. This is a race condition: an async operation such as setRemoteDescription, getUserMedia, or the media recovery flow yielded control, and close() ran during that gap. The init() cannot continue because the underlying RTCPeerConnection has been destroyed.";
         readonly causes: readonly ["call.hangup() or call.close() was called while the call was still setting up", "A WebSocket Bye message arrived during getUserMedia prompt or SDP negotiation", "User clicked hangup/decline before media permissions were granted"];
         readonly solutions: readonly ["This is expected if the user intentionally hung up during setup — no action needed", "If this happens frequently without user action, check for automatic hangup triggers that may fire too early"];
+        readonly fatal: true;
+    };
+    readonly 45001: {
+        readonly name: "WEBSOCKET_CONNECTION_FAILED";
+        readonly message: "Unable to connect to server";
+        readonly description: "The WebSocket connection to the signaling server could not be established. The server may be unreachable, the URL may be incorrect, or a firewall may be blocking the connection.";
+        readonly causes: readonly ["Server unreachable", "Incorrect WebSocket URL", "Firewall blocking WebSocket connections", "Network interruption"];
+        readonly solutions: readonly ["Check network connectivity", "Verify the signaling server URL", "Ensure WebSocket connections are not blocked by a firewall"];
+        readonly fatal: true;
+    };
+    readonly 45002: {
+        readonly name: "WEBSOCKET_ERROR";
+        readonly message: "Connection to server lost";
+        readonly description: "An error occurred on the WebSocket connection after it was established. The connection may have been dropped due to network issues or server-side closure.";
+        readonly causes: readonly ["Network interruption", "Server closed the connection", "Idle timeout"];
+        readonly solutions: readonly ["Check network connectivity", "SDK will attempt automatic reconnection if configured"];
+        readonly fatal: false;
+    };
+    readonly 45003: {
+        readonly name: "RECONNECTION_EXHAUSTED";
+        readonly message: "Unable to reconnect to server";
+        readonly description: "All automatic reconnection attempts have been exhausted. The SDK tried to re-establish the WebSocket connection multiple times but failed on every attempt.";
+        readonly causes: readonly ["Prolonged network outage", "Server unreachable", "Firewall or proxy blocking reconnection"];
+        readonly solutions: readonly ["Check network connectivity", "Call client.disconnect() and client.connect() to manually retry", "Notify the user that the connection was lost"];
+        readonly fatal: true;
+    };
+    readonly 45004: {
+        readonly name: "GATEWAY_FAILED";
+        readonly message: "Gateway connection failed";
+        readonly description: "The upstream gateway reported a FAILED, FAIL_WAIT, or TIMEOUT state. The signaling server could not establish or maintain a connection to the gateway. When autoReconnect is disabled, this is immediately fatal. When enabled, the SDK will retry until RECONNECTION_EXHAUSTED.";
+        readonly causes: readonly ["Gateway down or unreachable", "Server-side infrastructure issue", "Network partition between signaling server and gateway"];
+        readonly solutions: readonly ["Wait for automatic reconnection (if autoReconnect is enabled)", "Call client.disconnect() and client.connect() to manually retry", "Check Telnyx service status"];
+        readonly fatal: false;
+    };
+    readonly 46001: {
+        readonly name: "LOGIN_FAILED";
+        readonly message: "Authentication failed";
+        readonly description: "The login request was rejected by the server. The credentials may be invalid, expired, or the account may be suspended.";
+        readonly causes: readonly ["Invalid credentials (username/password or token)", "Expired authentication token", "Account suspended or disabled"];
+        readonly solutions: readonly ["Verify credentials", "Generate a new authentication token", "Check account status"];
+        readonly fatal: true;
+    };
+    readonly 46002: {
+        readonly name: "INVALID_CREDENTIALS";
+        readonly message: "Invalid credential parameters";
+        readonly description: "The SDK rejected the login options before sending any request to the server. This is an internal client-side validation guard — the credentials object is missing required fields or has an invalid structure. No network request was made.";
+        readonly causes: readonly ["Missing login and password fields", "Missing or malformed authentication token", "Invalid combination of credential fields in the options object"];
+        readonly solutions: readonly ["Provide valid login/password or a valid authentication token", "Check the TelnyxRTC constructor options against the documentation", "Ensure the credential object matches one of the supported auth modes (credentials, token, or anonymous)"];
+        readonly fatal: true;
+    };
+    readonly 46003: {
+        readonly name: "AUTHENTICATION_REQUIRED";
+        readonly message: "Authentication required";
+        readonly description: "The server rejected a request because the session is not authenticated. This can happen when the client sends a message (e.g. Invite, Subscribe, or Ping) before login completes, after a token expires mid-session, or after the server drops the authenticated state for any reason.";
+        readonly causes: readonly ["Message sent before login completed", "Authentication token expired during the session", "Server-side session was invalidated", "WebSocket reconnected but re-authentication did not complete"];
+        readonly solutions: readonly ["Ensure the client is fully logged in before sending messages", "Re-authenticate using client.login() with fresh credentials", "Listen for telnyx.ready before making calls or sending requests"];
+        readonly fatal: false;
+    };
+    readonly 47001: {
+        readonly name: "ICE_RESTART_FAILED";
+        readonly message: "ICE restart failed";
+        readonly description: "The ICE restart Modify request could not be sent or the server returned an error. The media path could not be recovered via ICE restart.";
+        readonly causes: readonly ["WebSocket connection lost during ICE restart", "Server rejected the Modify request", "Timeout waiting for server response"];
+        readonly solutions: readonly ["The call may recover via WebSocket reconnect + Attach", "If the call does not recover, hang up and retry"];
+        readonly fatal: false;
+    };
+    readonly 48001: {
+        readonly name: "NETWORK_OFFLINE";
+        readonly message: "Device is offline";
+        readonly description: "The browser reported that the device has lost network connectivity (navigator.onLine === false). All WebSocket and media connections will fail until the network is restored.";
+        readonly causes: readonly ["Wi-Fi or ethernet disconnected", "Airplane mode enabled", "Network interface went down"];
+        readonly solutions: readonly ["Check network connectivity", "Reconnect to Wi-Fi or ethernet", "Disable airplane mode"];
+        readonly fatal: false;
+    };
+    readonly 48501: {
+        readonly name: "SESSION_NOT_REATTACHED";
+        readonly message: "Active call lost after reconnect";
+        readonly description: "The WebSocket reconnected successfully but the server did not reattach the active call session. The server no longer knows about the call, so any subsequent call-control operation (hangup, hold, etc.) will fail with CALL_DOES_NOT_EXIST. The call is unrecoverable and must be terminated locally.";
+        readonly causes: readonly ["Server-side session expired during the disconnection window", "Reconnect token was invalidated", "Backend restarted or lost in-memory call state"];
+        readonly solutions: readonly ["Terminate the local call and notify the user", "Start a new call", "Investigate why the session was not preserved on the server"];
+        readonly fatal: true;
+    };
+    readonly 49001: {
+        readonly name: "UNEXPECTED_ERROR";
+        readonly message: "An unexpected error occurred";
+        readonly description: "An error was thrown that does not match any known SDK error category. This is a catch-all for unclassified failures.";
+        readonly causes: readonly ["Unknown or unhandled error condition"];
+        readonly solutions: readonly ["Check the originalError property for the underlying cause", "Report the issue if it persists"];
+        readonly fatal: true;
+    };
+};
+export declare const SDK_ERRORS: {
+    readonly 40001: {
+        readonly name: "SDP_CREATE_OFFER_FAILED";
+        readonly message: "Failed to create call offer";
+        readonly description: "The browser was unable to generate a local SDP offer. This typically indicates a WebRTC API error or invalid media constraints.";
+        readonly causes: readonly ["Browser WebRTC API error", "Missing or invalid media constraints"];
+        readonly solutions: readonly ["Check getUserMedia permissions", "Verify ICE server configuration"];
+        readonly fatal: true;
+    };
+    readonly 40002: {
+        readonly name: "SDP_CREATE_ANSWER_FAILED";
+        readonly message: "Failed to answer the call";
+        readonly description: "The browser was unable to generate a local SDP answer. The remote offer may be invalid or the browser state inconsistent.";
+        readonly causes: readonly ["Browser WebRTC API error", "Invalid remote SDP offer"];
+        readonly solutions: readonly ["Retry the call", "Check browser WebRTC compatibility"];
+        readonly fatal: true;
+    };
+    readonly 40003: {
+        readonly name: "SDP_SET_LOCAL_DESCRIPTION_FAILED";
+        readonly message: "Failed to apply local call settings";
+        readonly description: "setLocalDescription() was rejected by the browser. The generated SDP may be malformed or the browser state may be inconsistent.";
+        readonly causes: readonly ["Malformed SDP", "Browser state inconsistency"];
+        readonly solutions: readonly ["Retry the call"];
+        readonly fatal: true;
+    };
+    readonly 40004: {
+        readonly name: "SDP_SET_REMOTE_DESCRIPTION_FAILED";
+        readonly message: "Failed to apply remote call settings";
+        readonly description: "setRemoteDescription() was rejected by the browser. The remote SDP may be malformed or contain unsupported codecs.";
+        readonly causes: readonly ["Malformed remote SDP", "Browser codec mismatch"];
+        readonly solutions: readonly ["Retry the call", "Check codec configuration"];
+        readonly fatal: true;
+    };
+    readonly 40005: {
+        readonly name: "SDP_SEND_FAILED";
+        readonly message: "Failed to send call data to server";
+        readonly description: "The Invite or Answer message could not be delivered via the signaling WebSocket. The connection may have been lost.";
+        readonly causes: readonly ["WebSocket connection lost", "Server error"];
+        readonly solutions: readonly ["Check network connectivity", "Retry the call"];
+        readonly fatal: true;
+    };
+    readonly 42001: {
+        readonly name: "MEDIA_MICROPHONE_PERMISSION_DENIED";
+        readonly message: "Microphone access denied";
+        readonly description: "The user or operating system denied microphone permission. The browser permission prompt was dismissed or OS-level access is disabled.";
+        readonly causes: readonly ["User denied browser permission prompt", "OS-level microphone access disabled"];
+        readonly solutions: readonly ["Ask user to grant microphone permission in browser settings"];
+        readonly fatal: true;
+    };
+    readonly 42002: {
+        readonly name: "MEDIA_DEVICE_NOT_FOUND";
+        readonly message: "No microphone found";
+        readonly description: "The requested audio input device is not available. No microphone is connected, the device was disconnected, or an invalid deviceId was specified.";
+        readonly causes: readonly ["No microphone connected", "Device was disconnected", "Invalid deviceId"];
+        readonly solutions: readonly ["Check that a microphone is connected", "Select a valid audio input device"];
+        readonly fatal: true;
+    };
+    readonly 42003: {
+        readonly name: "MEDIA_GET_USER_MEDIA_FAILED";
+        readonly message: "Failed to access microphone";
+        readonly description: "getUserMedia() was rejected for an unexpected reason. The device may be in use by another application or the browser encountered an internal error.";
+        readonly causes: readonly ["Browser error", "Device in use by another application"];
+        readonly solutions: readonly ["Close other applications using the microphone", "Retry"];
+        readonly fatal: true;
     };
     readonly 44001: {
         readonly name: "HOLD_FAILED";
@@ -68,6 +263,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The server rejected or did not respond to the hold request. The WebSocket connection may have been lost during the operation.";
         readonly causes: readonly ["Server error", "WebSocket connection lost during hold"];
         readonly solutions: readonly ["Retry the hold operation", "Check network connectivity"];
+        readonly fatal: false;
     };
     readonly 44002: {
         readonly name: "INVALID_CALL_PARAMETERS";
@@ -75,6 +271,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The call could not be initiated because required parameters are missing or invalid. For example, no destination number was provided to newCall().";
         readonly causes: readonly ["Missing destinationNumber in call options", "Invalid or empty call parameters"];
         readonly solutions: readonly ["Provide a valid destinationNumber when calling newCall()", "Check the call options object for required fields"];
+        readonly fatal: true;
     };
     readonly 44003: {
         readonly name: "BYE_SEND_FAILED";
@@ -82,6 +279,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The hangup signal could not be delivered to the server. The call was terminated locally but the server may not be aware.";
         readonly causes: readonly ["WebSocket connection lost before BYE sent"];
         readonly solutions: readonly ["No action needed — call is terminated locally", "Check network connectivity"];
+        readonly fatal: false;
     };
     readonly 44004: {
         readonly name: "SUBSCRIBE_FAILED";
@@ -89,6 +287,15 @@ export declare const SDK_ERRORS: {
         readonly description: "The Verto subscribe request for the call channel failed. This may prevent receiving call state updates from the server.";
         readonly causes: readonly ["WebSocket connection lost during subscribe", "Server rejected the subscription request"];
         readonly solutions: readonly ["Check network connectivity", "Retry the call"];
+        readonly fatal: false;
+    };
+    readonly 44005: {
+        readonly name: "PEER_CLOSED_DURING_INIT";
+        readonly message: "Call was closed during setup";
+        readonly description: "The PeerConnection was closed (e.g. by hangup()) while peer.init() was still running. This is a race condition: an async operation such as setRemoteDescription, getUserMedia, or the media recovery flow yielded control, and close() ran during that gap. The init() cannot continue because the underlying RTCPeerConnection has been destroyed.";
+        readonly causes: readonly ["call.hangup() or call.close() was called while the call was still setting up", "A WebSocket Bye message arrived during getUserMedia prompt or SDP negotiation", "User clicked hangup/decline before media permissions were granted"];
+        readonly solutions: readonly ["This is expected if the user intentionally hung up during setup — no action needed", "If this happens frequently without user action, check for automatic hangup triggers that may fire too early"];
+        readonly fatal: true;
     };
     readonly 45001: {
         readonly name: "WEBSOCKET_CONNECTION_FAILED";
@@ -96,6 +303,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The WebSocket connection to the signaling server could not be established. The server may be unreachable, the URL may be incorrect, or a firewall may be blocking the connection.";
         readonly causes: readonly ["Server unreachable", "Incorrect WebSocket URL", "Firewall blocking WebSocket connections", "Network interruption"];
         readonly solutions: readonly ["Check network connectivity", "Verify the signaling server URL", "Ensure WebSocket connections are not blocked by a firewall"];
+        readonly fatal: true;
     };
     readonly 45002: {
         readonly name: "WEBSOCKET_ERROR";
@@ -103,6 +311,7 @@ export declare const SDK_ERRORS: {
         readonly description: "An error occurred on the WebSocket connection after it was established. The connection may have been dropped due to network issues or server-side closure.";
         readonly causes: readonly ["Network interruption", "Server closed the connection", "Idle timeout"];
         readonly solutions: readonly ["Check network connectivity", "SDK will attempt automatic reconnection if configured"];
+        readonly fatal: false;
     };
     readonly 45003: {
         readonly name: "RECONNECTION_EXHAUSTED";
@@ -110,13 +319,15 @@ export declare const SDK_ERRORS: {
         readonly description: "All automatic reconnection attempts have been exhausted. The SDK tried to re-establish the WebSocket connection multiple times but failed on every attempt.";
         readonly causes: readonly ["Prolonged network outage", "Server unreachable", "Firewall or proxy blocking reconnection"];
         readonly solutions: readonly ["Check network connectivity", "Call client.disconnect() and client.connect() to manually retry", "Notify the user that the connection was lost"];
+        readonly fatal: true;
     };
     readonly 45004: {
         readonly name: "GATEWAY_FAILED";
         readonly message: "Gateway connection failed";
-        readonly description: "The upstream gateway reported a FAILED or FAIL_WAIT state. The signaling server could not establish or maintain a connection to the gateway. When autoReconnect is disabled, this is immediately fatal. When enabled, the SDK will retry until RECONNECTION_EXHAUSTED.";
+        readonly description: "The upstream gateway reported a FAILED, FAIL_WAIT, or TIMEOUT state. The signaling server could not establish or maintain a connection to the gateway. When autoReconnect is disabled, this is immediately fatal. When enabled, the SDK will retry until RECONNECTION_EXHAUSTED.";
         readonly causes: readonly ["Gateway down or unreachable", "Server-side infrastructure issue", "Network partition between signaling server and gateway"];
         readonly solutions: readonly ["Wait for automatic reconnection (if autoReconnect is enabled)", "Call client.disconnect() and client.connect() to manually retry", "Check Telnyx service status"];
+        readonly fatal: false;
     };
     readonly 46001: {
         readonly name: "LOGIN_FAILED";
@@ -124,6 +335,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The login request was rejected by the server. The credentials may be invalid, expired, or the account may be suspended.";
         readonly causes: readonly ["Invalid credentials (username/password or token)", "Expired authentication token", "Account suspended or disabled"];
         readonly solutions: readonly ["Verify credentials", "Generate a new authentication token", "Check account status"];
+        readonly fatal: true;
     };
     readonly 46002: {
         readonly name: "INVALID_CREDENTIALS";
@@ -131,6 +343,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The SDK rejected the login options before sending any request to the server. This is an internal client-side validation guard — the credentials object is missing required fields or has an invalid structure. No network request was made.";
         readonly causes: readonly ["Missing login and password fields", "Missing or malformed authentication token", "Invalid combination of credential fields in the options object"];
         readonly solutions: readonly ["Provide valid login/password or a valid authentication token", "Check the TelnyxRTC constructor options against the documentation", "Ensure the credential object matches one of the supported auth modes (credentials, token, or anonymous)"];
+        readonly fatal: true;
     };
     readonly 46003: {
         readonly name: "AUTHENTICATION_REQUIRED";
@@ -138,6 +351,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The server rejected a request because the session is not authenticated. This can happen when the client sends a message (e.g. Invite, Subscribe, or Ping) before login completes, after a token expires mid-session, or after the server drops the authenticated state for any reason.";
         readonly causes: readonly ["Message sent before login completed", "Authentication token expired during the session", "Server-side session was invalidated", "WebSocket reconnected but re-authentication did not complete"];
         readonly solutions: readonly ["Ensure the client is fully logged in before sending messages", "Re-authenticate using client.login() with fresh credentials", "Listen for telnyx.ready before making calls or sending requests"];
+        readonly fatal: false;
     };
     readonly 47001: {
         readonly name: "ICE_RESTART_FAILED";
@@ -145,6 +359,7 @@ export declare const SDK_ERRORS: {
         readonly description: "The ICE restart Modify request could not be sent or the server returned an error. The media path could not be recovered via ICE restart.";
         readonly causes: readonly ["WebSocket connection lost during ICE restart", "Server rejected the Modify request", "Timeout waiting for server response"];
         readonly solutions: readonly ["The call may recover via WebSocket reconnect + Attach", "If the call does not recover, hang up and retry"];
+        readonly fatal: false;
     };
     readonly 48001: {
         readonly name: "NETWORK_OFFLINE";
@@ -152,6 +367,15 @@ export declare const SDK_ERRORS: {
         readonly description: "The browser reported that the device has lost network connectivity (navigator.onLine === false). All WebSocket and media connections will fail until the network is restored.";
         readonly causes: readonly ["Wi-Fi or ethernet disconnected", "Airplane mode enabled", "Network interface went down"];
         readonly solutions: readonly ["Check network connectivity", "Reconnect to Wi-Fi or ethernet", "Disable airplane mode"];
+        readonly fatal: false;
+    };
+    readonly 48501: {
+        readonly name: "SESSION_NOT_REATTACHED";
+        readonly message: "Active call lost after reconnect";
+        readonly description: "The WebSocket reconnected successfully but the server did not reattach the active call session. The server no longer knows about the call, so any subsequent call-control operation (hangup, hold, etc.) will fail with CALL_DOES_NOT_EXIST. The call is unrecoverable and must be terminated locally.";
+        readonly causes: readonly ["Server-side session expired during the disconnection window", "Reconnect token was invalidated", "Backend restarted or lost in-memory call state"];
+        readonly solutions: readonly ["Terminate the local call and notify the user", "Start a new call", "Investigate why the session was not preserved on the server"];
+        readonly fatal: true;
     };
     readonly 49001: {
         readonly name: "UNEXPECTED_ERROR";
@@ -159,6 +383,7 @@ export declare const SDK_ERRORS: {
         readonly description: "An error was thrown that does not match any known SDK error category. This is a catch-all for unclassified failures.";
         readonly causes: readonly ["Unknown or unhandled error condition"];
         readonly solutions: readonly ["Check the originalError property for the underlying cause", "Report the issue if it persists"];
+        readonly fatal: true;
     };
 };
 export declare type SdkErrorCode = keyof typeof SDK_ERRORS;

package/lib/src/Modules/Verto/util/constants/warnings.d.ts

@@ -47,6 +47,13 @@ export declare const SDK_WARNINGS: {
         readonly causes: readonly ["Microphone input level is too low", "Wrong microphone selected", "Microphone is obstructed or too far from the speaker", "Operating system input gain is muted or very low"];
         readonly solutions: readonly ["Check the selected microphone", "Increase microphone input gain", "Move closer to the microphone", "Verify the microphone is not muted at the operating system or hardware level"];
     };
+    readonly 31006: {
+        readonly name: "LOW_INBOUND_AUDIO";
+        readonly message: "Low inbound audio detected";
+        readonly description: "Inbound (remote) audio level stayed below the acceptable threshold for multiple consecutive stats intervals while RTP packets continued to flow. This may indicate the remote party is sending silence or comfort-noise (e.g. one-way audio caused by a media bridge issue), as opposed to LOW_BYTES_RECEIVED which fires when no bytes arrive at all.";
+        readonly causes: readonly ["Remote party microphone is muted or capturing very low audio", "Media bridge or PBX is injecting comfort-noise/silence instead of forwarding real audio", "One-way audio where RTP flows but content is silent (server-side media issue)", "Remote party is on hold or not speaking"];
+        readonly solutions: readonly ["Verify the remote party is not muted and is actively speaking", "Check the media bridge / PBX for comfort-noise injection or transcoding issues", "Inspect PCAP RTP payload uniqueness to distinguish real audio from comfort-noise", "If the issue persists, report the call for server-side media investigation"];
+    };
     readonly 32001: {
         readonly name: "LOW_BYTES_RECEIVED";
         readonly message: "No audio data received";
@@ -124,24 +131,10 @@ export declare const SDK_WARNINGS: {
         readonly causes: readonly ["Token was issued with a limited lifetime"];
         readonly solutions: readonly ["Generate a new authentication token", "Reconnect with fresh credentials before the token expires"];
     };
-    readonly 36001: {
-        readonly name: "SIGNALING_HEALTH_PROBE_TIMEOUT";
-        readonly message: "Signaling health probe timed out";
-        readonly description: "A signaling liveness probe (Ping) was sent during an active call but no response was received within the timeout window. This indicates the WebSocket may be half-dead — the browser reports it as OPEN but data is not flowing. The SDK will force-close the socket to trigger reconnection.";
-        readonly causes: readonly ["Network interface removed mid-call while another interface remains", "TCP connection bound to a removed IP/route became half-dead", "Firewall or NAT state expired silently", "WebSocket proxy or load balancer dropped the connection without a close frame"];
-        readonly solutions: readonly ["The SDK will automatically force-close the socket and reconnect", "Check for network interface changes during the call", "Verify firewall/NAT timeout settings"];
-    };
-    readonly 36002: {
-        readonly name: "SIGNALING_REQUEST_TIMEOUT";
-        readonly message: "Signaling request timed out";
-        readonly description: "A signaling-critical JSON-RPC request (e.g. ICE restart Modify) did not receive a response within the timeout window while the socket reports OPEN. This may indicate the WebSocket is half-dead or the server is unresponsive. The SDK will mark signaling as unhealthy and force reconnection.";
-        readonly causes: readonly ["Half-dead WebSocket (browser reports OPEN but data does not flow)", "Server unresponsive or overloaded", "Network path interruption without TCP RST"];
-        readonly solutions: readonly ["The SDK will automatically force-close the socket and reconnect", "Check server health and response times", "Check for network path issues"];
-    };
     readonly 36003: {
         readonly name: "SIGNALING_RECOVERY_REQUIRED";
         readonly message: "Signaling recovery required";
-        readonly description: "The signaling (WebSocket) path has been detected as unhealthy and the SDK will force-close the socket and reconnect. If media was still flowing, the reconnect is delayed briefly to allow the application to notify the user about a short interruption. Active calls will be recovered via reattach after reconnection.";
+        readonly description: "The signaling (WebSocket) path has been detected as unhealthy and the SDK will force-close the socket and reconnect. The source field in the warning payload indicates what triggered the recovery (probe, request, peer_failure, or no_rtp). Active calls will be recovered via reattach after reconnection.";
         readonly causes: readonly ["WebSocket probe timed out with no response", "Critical signaling request timed out", "Peer/media failure detected while signaling is also unhealthy"];
         readonly solutions: readonly ["The SDK will automatically reconnect and recover the call", "Check for network interface changes or interruptions", "Verify firewall/NAT timeout settings"];
     };
@@ -152,12 +145,33 @@ export declare const SDK_WARNINGS: {
         readonly causes: readonly ["ICE connection state changed to failed", "RTCPeerConnection state changed to failed", "No RTP packets/bytes received while media should be active"];
         readonly solutions: readonly ["The SDK will automatically attempt ICE restart", "Check network connectivity and ICE candidate availability", "Verify TURN server configuration"];
     };
-    readonly 35001: {
-        readonly name: "SESSION_NOT_REATTACHED";
-        readonly message: "Active call lost after reconnect";
-        readonly description: "The WebSocket reconnected successfully but the server returned an empty reattached_sessions list while the SDK still has an active call. The server no longer knows about the call, so any subsequent call-control operation (hangup, hold, etc.) will fail with CALL_DOES_NOT_EXIST.";
-        readonly causes: readonly ["Server-side session expired during the disconnection window", "Reconnect token was invalidated", "Backend restarted or lost in-memory call state"];
-        readonly solutions: readonly ["Terminate the local call and notify the user", "Start a new call", "Investigate why the session was not preserved on the server"];
+    readonly 36005: {
+        readonly name: "RECONNECTION_FAILED_WITH_NO_AUTO_RECONNECT";
+        readonly message: "Reconnection failed — auto-reconnect disabled";
+        readonly description: "The WebSocket was closed and auto-reconnect is disabled, so the SDK will not attempt to reconnect. This typically occurs after the user called disconnect() or after reconnection attempts were exhausted.";
+        readonly causes: readonly ["Auto-reconnect was disabled by the application", "Reconnection attempts were previously exhausted", "The session was intentionally disconnected"];
+        readonly solutions: readonly ["Call connect() manually to re-establish the session", "Check if disconnect() was called intentionally", "Review maxReconnectAttempts configuration"];
+    };
+    readonly 33009: {
+        readonly name: "AUDIO_INPUT_DEVICE_CHANGE_SKIPPED";
+        readonly message: "Audio input device change skipped";
+        readonly description: "The SDK could not change the microphone because the active peer connection has no audio RTP sender to replace. The existing local media and mute state were left unchanged.";
+        readonly causes: readonly ["The call was created without an audio sender", "The peer connection was not ready when setAudioInDevice was called", "The call is already ending or the local media sender was removed"];
+        readonly solutions: readonly ["Retry after the call is active and local media is attached", "Verify the call was started with audio enabled", "Inspect call state and peer connection sender availability"];
+    };
+    readonly 33010: {
+        readonly name: "MULTIPLE_ACTIVE_CALLS_DETECTED";
+        readonly message: "Multiple active calls detected in one SDK session";
+        readonly description: "A new call was created or received while another call is still active (ringing, answering, active, held, or recovering) in the same SDK session. This may be intentional for some applications (e.g. call waiting, transfer) but is often abnormal and makes call reports and application behavior harder to reason about. The new call proceeds normally — this warning is diagnostic only.";
+        readonly causes: readonly ["Application created an outbound call while another call is active", "An inbound call arrived while another call is already active", "Application did not hang up the previous call before starting a new one", "Call waiting or multi-call scenario (may be intentional)"];
+        readonly solutions: readonly ["Verify this is the expected behavior for your application", "Ensure the previous call is hung up before creating a new one if only one call is expected", "Use call.hold() before starting a new call if needed", "Check the warning payload for call IDs to correlate which calls are involved"];
+    };
+    readonly 35002: {
+        readonly name: "UNKNOWN_REATTACHED_SESSION";
+        readonly message: "Unknown reattach session after reconnect";
+        readonly description: "The WebSocket reconnected successfully and the server sent an Attach message for a session that does not match any active SDK call. The unknown Attach is ACK'd and ignored.";
+        readonly causes: readonly ["Server sent an Attach for a call that no longer exists in the SDK", "Multiple Attach messages arrived and only the first was recovered", "Race condition between reconnection and new inbound call"];
+        readonly solutions: readonly ["Check application logic for multiple simultaneous calls", "Inspect the Attach callID in the warning payload for details", "If a call should be active, start a new call manually"];
     };
 };
 export declare type SdkWarningCode = keyof typeof SDK_WARNINGS;

package/lib/src/Modules/Verto/util/errors.d.ts

@@ -12,6 +12,7 @@ export interface ITelnyxError {
     causes: string[];
     solutions: string[];
     originalError?: unknown;
+    fatal: boolean;
 }
 export interface ITelnyxMediaError extends Omit<ITelnyxError, 'code'> {
     code: TelnyxMediaErrorCode;
@@ -38,6 +39,7 @@ export declare class TelnyxError extends Error implements ITelnyxError {
     readonly causes: string[];
     readonly solutions: string[];
     readonly originalError?: unknown;
+    readonly fatal: boolean;
     constructor(params: Omit<ITelnyxError, 'message'> & {
         message?: string;
     });
@@ -45,7 +47,7 @@ export declare class TelnyxError extends Error implements ITelnyxError {
 }
 export declare function isMediaRecoveryErrorEvent(event: ITelnyxErrorEvent): event is ITelnyxMediaRecoveryErrorEvent;
 export declare function classifyMediaErrorCode(error: unknown): typeof MEDIA_MICROPHONE_PERMISSION_DENIED | typeof MEDIA_DEVICE_NOT_FOUND | typeof MEDIA_GET_USER_MEDIA_FAILED;
-export declare function createTelnyxError(code: SdkErrorCode, originalError?: unknown, message?: string): TelnyxError;
+export declare function createTelnyxError(code: SdkErrorCode, originalError?: unknown, message?: string, fatal?: boolean): TelnyxError;
 export declare class RequestTimeoutError extends Error {
     readonly requestId: string;
     readonly timeoutMs: number;

package/lib/src/Modules/Verto/util/interfaces/SignalingHealth.d.ts

@@ -3,7 +3,6 @@ export declare type PeerFailureEvidence = 'ice_failed' | 'connection_failed';
 export declare type TriggerIceRestartResult = {
     started: boolean;
     reason?: string;
-    recoverSignaling?: boolean;
 };
 export interface ISignalingHealthSession {
     uuid: string;