@telnyx/webrtc 2.26.3 → 2.27.0-beta.1

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

@@ -11,6 +11,7 @@ export declare const TELNYX_ERROR_CODES: {
     readonly INVALID_CALL_PARAMETERS: 44002;
     readonly BYE_SEND_FAILED: 44003;
     readonly SUBSCRIBE_FAILED: 44004;
+    readonly PEER_CLOSED_DURING_INIT: 44005;
     readonly WEBSOCKET_CONNECTION_FAILED: 45001;
     readonly WEBSOCKET_ERROR: 45002;
     readonly RECONNECTION_EXHAUSTED: 45003;
@@ -18,6 +19,7 @@ export declare const TELNYX_ERROR_CODES: {
     readonly LOGIN_FAILED: 46001;
     readonly INVALID_CREDENTIALS: 46002;
     readonly AUTHENTICATION_REQUIRED: 46003;
+    readonly ICE_RESTART_FAILED: 47001;
     readonly NETWORK_OFFLINE: 48001;
     readonly UNEXPECTED_ERROR: 49001;
 };
@@ -33,9 +35,10 @@ export declare const TELNYX_WARNING_CODES: {
     readonly ICE_GATHERING_EMPTY: 33003;
     readonly PEER_CONNECTION_FAILED: 33004;
     readonly ONLY_HOST_ICE_CANDIDATES: 33005;
+    readonly ANSWER_WHILE_PEER_ACTIVE: 33006;
     readonly TOKEN_EXPIRING_SOON: 34001;
     readonly SESSION_NOT_REATTACHED: 35001;
 };
-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, WEBSOCKET_CONNECTION_FAILED: 45001, WEBSOCKET_ERROR: 45002, RECONNECTION_EXHAUSTED: 45003, GATEWAY_FAILED: 45004, LOGIN_FAILED: 46001, INVALID_CREDENTIALS: 46002, AUTHENTICATION_REQUIRED: 46003, NETWORK_OFFLINE: 48001, UNEXPECTED_ERROR: 49001;
-export declare const HIGH_RTT: 31001, HIGH_JITTER: 31002, HIGH_PACKET_LOSS: 31003, LOW_MOS: 31004, 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, TOKEN_EXPIRING_SOON: 34001, SESSION_NOT_REATTACHED: 35001;
+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_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, TOKEN_EXPIRING_SOON: 34001, SESSION_NOT_REATTACHED: 35001;
 export declare const HAS_NON_HOST_ICE_CANDIDATE_REGEX: RegExp;

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

@@ -55,6 +55,13 @@ export declare const SDK_ERRORS: {
         readonly causes: readonly ["Browser error", "Device in use by another application"];
         readonly solutions: readonly ["Close other applications using the microphone", "Retry"];
     };
+    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 44001: {
         readonly name: "HOLD_FAILED";
         readonly message: "Failed to hold the call";
@@ -132,6 +139,13 @@ export declare const SDK_ERRORS: {
         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 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 48001: {
         readonly name: "NETWORK_OFFLINE";
         readonly message: "Device is offline";

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

@@ -89,6 +89,13 @@ export declare const SDK_WARNINGS: {
         readonly causes: readonly ["STUN/TURN servers unreachable", "Firewall blocking UDP traffic to STUN/TURN servers", "Incorrect TURN server configuration or credentials", "Restrictive corporate network or VPN"];
         readonly solutions: readonly ["Verify STUN/TURN server URLs and credentials", "Ensure UDP traffic to STUN/TURN ports is not blocked", "Check firewall or VPN settings", "Try using TCP-based TURN as a fallback"];
     };
+    readonly 33006: {
+        readonly name: "ANSWER_WHILE_PEER_ACTIVE";
+        readonly message: "Call answer ignored because a peer connection is already active";
+        readonly description: "answer() was called on a call that already has an active or connecting peer connection. Creating a second peer connection for the same call would duplicate media negotiation, confuse the remote party, and break call reporting. This is typically caused by application code invoking answer() multiple times (e.g. from multiple event handlers).";
+        readonly causes: readonly ["Application called answer() twice on the same call object", "Multiple click handlers or event listeners triggering answer()"];
+        readonly solutions: readonly ["Ensure answer() is called only once per call", "Disable the answer button after the first click", "Check that answer() is not invoked from multiple event handlers"];
+    };
     readonly 34001: {
         readonly name: "TOKEN_EXPIRING_SOON";
         readonly message: "Authentication token expiring soon";

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

@@ -37,6 +37,7 @@ export interface IVertoOptions {
     callReportInterval?: number;
     debugLogLevel?: 'debug' | 'info' | 'warn' | 'error';
     debugLogMaxEntries?: number;
+    skipLastVoiceSdkId?: boolean;
     mediaPermissionsRecovery?: {
         enabled: boolean;
         timeout: number;

package/lib/src/Modules/Verto/webrtc/BaseCall.d.ts

@@ -31,7 +31,6 @@ export default abstract class BaseCall implements IWebRTCCall {
     private _lastSerno;
     private _targetNodeId;
     private _iceTimeout;
-    private _iceDone;
     private _ringtone;
     private _ringback;
     private _statsBindings;
@@ -43,6 +42,7 @@ export default abstract class BaseCall implements IWebRTCCall {
     private _firstCandidateSent;
     private _firstNonHostCandidateSent;
     private _isRecovering;
+    private _captureHangupCallerStack;
     constructor(session: BrowserSession, opts?: IVertoCallOptions);
     get nodeId(): string;
     set nodeId(what: string);
@@ -93,6 +93,8 @@ export default abstract class BaseCall implements IWebRTCCall {
     private _confControl;
     private _handleChangeHoldStateSuccess;
     private _handleChangeHoldStateError;
+    private _sendIceRestartModify;
+    private _onIceRestartFailed;
     private _onRemoteSdp;
     private _requestAnotherLocalDescription;
     private _onIceSdp;
@@ -107,7 +109,6 @@ export default abstract class BaseCall implements IWebRTCCall {
     private _resetTrickleIceCandidateState;
     private _flushPendingTrickleIceCandidates;
     private _registerPeerEvents;
-    private _registerTrickleIcePeerEvents;
     private _checkConferenceSerno;
     private _onMediaError;
     private _onPeerConnectionFailureError;

package/lib/src/Modules/Verto/webrtc/CallReportCollector.d.ts

@@ -1,5 +1,33 @@
 import { ILogEntry } from '../../../Modules/Verto/util/LogCollector';
 import { type ITelnyxWarning } from '../../../Modules/Verto/util/errors';
+export interface ILocalAudioTrackSnapshot {
+    id?: string;
+    label?: string;
+    enabled?: boolean;
+    muted?: boolean;
+    readyState?: MediaStreamTrackState;
+    contentHint?: string;
+    settings?: {
+        deviceId?: string;
+        groupId?: string;
+        channelCount?: number;
+        sampleRate?: number;
+        sampleSize?: number;
+        latency?: number;
+        echoCancellation?: boolean;
+        noiseSuppression?: boolean;
+        autoGainControl?: boolean;
+    };
+}
+export interface ILocalAudioSourceStats {
+    id?: string;
+    trackIdentifier?: string;
+    audioLevel?: number;
+    totalAudioEnergy?: number;
+    totalSamplesDuration?: number;
+    echoReturnLoss?: number;
+    echoReturnLossEnhancement?: number;
+}
 interface ICECandidateInfo {
     address?: string;
     port?: number;
@@ -42,6 +70,8 @@ export interface IStatsInterval {
             bytesSent?: number;
             audioLevelAvg?: number;
             bitrateAvg?: number;
+            localTrack?: ILocalAudioTrackSnapshot;
+            mediaSource?: ILocalAudioSourceStats;
         };
         inbound?: {
             packetsReceived?: number;
@@ -120,6 +150,7 @@ export declare class CallReportCollector {
     private static readonly WARNING_THROTTLE_MS;
     private _prevPacketsReceived;
     private _prevPacketsLost;
+    private _lastLocalAudioTrackSnapshotJson;
     private _segmentIndex;
     private _flushing;
     private static readonly RETRY_DELAY_MS;
@@ -138,6 +169,13 @@ export declare class CallReportCollector {
     private _trackBreach;
     private _createStatsEntry;
     private _resolveCandidate;
+    private _getOutboundMediaSource;
+    private _getLocalAudioTrackSnapshot;
+    private _getOutboundAudioSourceStats;
+    private _logLocalAudioTrackSnapshot;
+    private _withoutUndefined;
+    private _stableStringify;
+    private _sortObjectKeys;
     private _getOutboundAudioLevel;
     private _getInboundAudioLevel;
     private _computeAudioLevelFromEnergy;

package/lib/src/Modules/Verto/webrtc/Peer.d.ts

@@ -8,6 +8,8 @@ export default class Peer {
     instance: RTCPeerConnection;
     onSdpReadyTwice: ((data: RTCSessionDescription) => void) | null;
     statsReporter: WebRTCStatsReporter | null;
+    isIceRestarting: boolean;
+    iceDone: boolean;
     private _constraints;
     private _session;
     private _negotiating;
@@ -21,7 +23,12 @@ export default class Peer {
     private static readonly ICE_GATHERING_SAFETY_TIMEOUT_MS;
     private _firstMediaTrackMarked;
     private _timingsCollected;
+    private _iceRestartTimeoutId;
+    private static readonly ICE_RESTART_TIMEOUT_MS;
+    private _hadOfflineEvent;
+    private _offlineHandler;
     constructor(type: PeerType, options: IVertoCallOptions, session: BrowserSession, trickleIceSdpFn: (sdp: RTCSessionDescriptionInit) => void, registerPeerEvents: (instance: RTCPeerConnection) => void);
+    finishIceRestart(): void;
     get isOffer(): boolean;
     get isAnswer(): boolean;
     get isDebugEnabled(): boolean;

package/lib/src/Modules/Verto/webrtc/constants.d.ts

@@ -93,3 +93,9 @@ export declare enum GatewayStateType {
     EXPIRED = "EXPIRED",
     UNREGISTER = "UNREGISTER"
 }
+export declare enum VertoModifyAction {
+    Hold = "hold",
+    Unhold = "unhold",
+    ToggleHold = "toggleHold",
+    UpdateMedia = "updateMedia"
+}

package/lib/src/Modules/Verto/webrtc/interfaces.d.ts

@@ -16,6 +16,7 @@ export interface IHangupParams {
         }>;
     };
     isRecovering?: boolean;
+    initiator?: string;
 }
 export interface IVertoCallOptions {
     destinationNumber?: string;

package/lib/src/utils/interfaces.d.ts

@@ -31,6 +31,7 @@ export interface IClientOptions {
     rtcIp?: string;
     rtcPort?: number;
     useCanaryRtcServer?: boolean;
+    skipLastVoiceSdkId?: boolean;
     env?: Environment;
     iceServers?: RTCIceServer[];
     mutedMicOnStart?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/webrtc",
-  "version": "2.26.3",
+  "version": "2.27.0-beta.1",
   "description": "Telnyx WebRTC Client",
   "keywords": [
     "telnyx",