@telnyx/webrtc 2.26.4 → 2.27.0-beta.2

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

@@ -19,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;
 };
@@ -35,9 +36,10 @@ export declare const TELNYX_WARNING_CODES: {
     readonly PEER_CONNECTION_FAILED: 33004;
     readonly ONLY_HOST_ICE_CANDIDATES: 33005;
     readonly ANSWER_WHILE_PEER_ACTIVE: 33006;
+    readonly DUPLICATE_INBOUND_ANSWER: 33007;
     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, 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, 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 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, DUPLICATE_INBOUND_ANSWER: 33007, 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

@@ -139,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

@@ -96,6 +96,13 @@ export declare const SDK_WARNINGS: {
         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 33007: {
+        readonly name: "DUPLICATE_INBOUND_ANSWER";
+        readonly message: "Call answer ignored because another inbound call is already being answered";
+        readonly description: "answer() was called on an inbound call while another inbound call is already answering or active in this JavaScript runtime. Answering both legs can trigger SIP 486 USER_BUSY / LOSE_RACE when duplicate WebSocket registrations receive the same incoming call.";
+        readonly causes: readonly ["Multiple TelnyxRTC instances in the same page", "Application code recreating a client without disconnecting the previous instance", "Duplicate inbound call notifications produced by duplicate WebSocket registrations"];
+        readonly solutions: readonly ["Keep a single active TelnyxRTC instance for inbound call handling", "Call disconnect() before replacing an SDK client instance", "Only call answer() for one inbound call notification at a time"];
+    };
     readonly 34001: {
         readonly name: "TOKEN_EXPIRING_SOON";
         readonly message: "Authentication token expiring soon";

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;
@@ -115,6 +116,10 @@ export default abstract class BaseCall implements IWebRTCCall {
     private _dispatchConferenceUpdate;
     private _dispatchNotification;
     private _execute;
+    private _registerInboundAnswerAttempt;
+    private _getSessionInboundAnswerCalls;
+    private _isBlockingInboundAnswer;
+    private _hasUsablePeerConnection;
     private _init;
     protected _finalize(): void;
     private _flushIntermediateReport;

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/package.json

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