@telnyx/webrtc 2.27.0-beta.2 → 2.27.0-beta.3

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

@@ -30,6 +30,7 @@ export default abstract class BaseSession {
     protected _reconnectTimeout: any;
     protected _autoReconnect: boolean;
     protected _idle: boolean;
+    protected _reconnectAttempts: number;
     private _tokenExpiryTimeout;
     private static readonly TOKEN_EXPIRY_WARNING_SECONDS;
     private _executeQueue;
@@ -54,6 +55,7 @@ export default abstract class BaseSession {
     off(eventName: SwEvent.Notification | 'telnyx.notification', callback?: (event: INotification) => void): this;
     off(eventName: string, callback?: Function): this;
     connect(): Promise<void>;
+    resetReconnectAttempts(): void;
     protected _handleLoginError(error: any): void;
     clearReconnectToken(): void;
     private _checkTokenExpiry;

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

@@ -28,6 +28,7 @@ export declare const TELNYX_WARNING_CODES: {
     readonly HIGH_JITTER: 31002;
     readonly HIGH_PACKET_LOSS: 31003;
     readonly LOW_MOS: 31004;
+    readonly LOW_LOCAL_AUDIO: 31005;
     readonly LOW_BYTES_RECEIVED: 32001;
     readonly LOW_BYTES_SENT: 32002;
     readonly ICE_CONNECTIVITY_LOST: 33001;
@@ -41,5 +42,5 @@ export declare const TELNYX_WARNING_CODES: {
     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, 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 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, 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/warnings.d.ts

@@ -40,6 +40,13 @@ export declare const SDK_WARNINGS: {
         readonly causes: readonly ["Combination of high latency, jitter, and/or packet loss", "Poor network conditions"];
         readonly solutions: readonly ["Check network connectivity", "Use a wired connection", "Close bandwidth-heavy applications"];
     };
+    readonly 31005: {
+        readonly name: "LOW_LOCAL_AUDIO";
+        readonly message: "Low local microphone audio detected";
+        readonly description: "Local outbound audio level stayed below the acceptable threshold before the microphone produced real audio, or stayed silent for a long continuous window after audio was confirmed. This may indicate that the microphone is not capturing enough audio even while RTP is being sent.";
+        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 32001: {
         readonly name: "LOW_BYTES_RECEIVED";
         readonly message: "No audio data received";

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

@@ -33,6 +33,7 @@ export interface IVertoOptions {
     rtcIp?: string;
     rtcPort?: number;
     mutedMicOnStart?: boolean;
+    maxReconnectAttempts?: number;
     enableCallReports?: boolean;
     callReportInterval?: number;
     debugLogLevel?: 'debug' | 'info' | 'warn' | 'error';

package/lib/src/Modules/Verto/util/webrtc/index.d.ts

@@ -9,7 +9,7 @@ declare const streamIsValid: (stream: MediaStream) => boolean;
 declare const audioIsMediaTrackConstraints: (audio: boolean | MediaTrackConstraints) => boolean;
 declare const videoIsMediaTrackConstraints: (video: boolean | MediaTrackConstraints) => boolean;
 declare const attachMediaStream: (tag: any, stream: MediaStream) => void;
-declare const detachMediaStream: (tag: any) => void;
+declare const detachMediaStream: (tag: any, stream?: MediaStream) => void;
 declare const muteMediaElement: (tag: any) => void;
 declare const unmuteMediaElement: (tag: any) => void;
 declare const toggleMuteMediaElement: (tag: any) => void;

package/lib/src/Modules/Verto/util/webrtc/index.native.d.ts

@@ -5,7 +5,7 @@ declare const _enumerateDevices: () => any;
 declare const streamIsValid: (stream: MediaStream) => boolean;
 declare const getSupportedConstraints: () => {};
 declare const attachMediaStream: (htmlElementId: string, stream: MediaStream) => any;
-declare const detachMediaStream: (htmlElementId: string) => any;
+declare const detachMediaStream: (htmlElementId: string, _stream?: MediaStream) => any;
 declare const muteMediaElement: (htmlElementId: string) => any;
 declare const unmuteMediaElement: (htmlElementId: string) => any;
 declare const toggleMuteMediaElement: (htmlElementId: string) => any;

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

@@ -7,6 +7,7 @@ export interface ICallEstablishmentTimings {
         delta: number;
     }>;
 }
-export declare function collectCallEstablishmentTimings(mode: 'trickle' | 'non-trickle', direction: 'outbound' | 'inbound'): ICallEstablishmentTimings;
+export declare function callMarkName(callId: string, suffix: string): string;
+export declare function collectCallEstablishmentTimings(callId: string, mode: 'trickle' | 'non-trickle', direction: 'outbound' | 'inbound'): ICallEstablishmentTimings;
 export declare function logCallEstablishmentTimings(timings: ICallEstablishmentTimings): void;
-export declare function clearCallMarks(): void;
+export declare function clearCallMarks(callId: string): void;

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

@@ -134,6 +134,8 @@ export declare class CallReportCollector {
     private intervalBitrates;
     private previousStats;
     private previousCandidatePairId;
+    private static readonly INITIAL_COLLECTION_INTERVAL_MS;
+    private static readonly INITIAL_COLLECTION_DURATION_MS;
     private readonly MAX_BUFFER_SIZE;
     private static readonly STATS_FLUSH_THRESHOLD;
     private static readonly LOGS_FLUSH_THRESHOLD;
@@ -144,6 +146,8 @@ export declare class CallReportCollector {
     private static readonly THRESHOLD_JITTER_MS;
     private static readonly THRESHOLD_PACKET_LOSS_PCT;
     private static readonly THRESHOLD_MOS;
+    private static readonly THRESHOLD_LOCAL_AUDIO_LEVEL;
+    private static readonly CONFIRMED_LOCAL_AUDIO_SILENCE_MS;
     private _breachCounters;
     private _activeWarnings;
     private _lastWarningEmitted;
@@ -151,8 +155,11 @@ export declare class CallReportCollector {
     private _prevPacketsReceived;
     private _prevPacketsLost;
     private _lastLocalAudioTrackSnapshotJson;
+    private _hasConfirmedLocalAudio;
+    private _confirmedLocalAudioSilenceMs;
     private _segmentIndex;
     private _flushing;
+    private _stopped;
     private static readonly RETRY_DELAY_MS;
     constructor(options: ICallReportOptions, logCollectorOptions?: ILogCollectorOptions);
     start(peerConnection: RTCPeerConnection): void;
@@ -164,9 +171,17 @@ export declare class CallReportCollector {
     getStatsBuffer(): IStatsInterval[];
     getLogs(): ILogEntry[];
     cleanup(): void;
+    private _scheduleNextCollection;
+    private _collectionIntervalFor;
+    private _positiveInterval;
     private _collectStats;
     private _checkQualityWarnings;
+    private _trackLowLocalAudio;
+    private _resetLowLocalAudioWarning;
+    private _getStatsIntervalDurationMs;
     private _trackBreach;
+    private _emitWarningOncePerEpisode;
+    private _emitWarning;
     private _createStatsEntry;
     private _resolveCandidate;
     private _getOutboundMediaSource;

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

@@ -35,6 +35,7 @@ export interface IClientOptions {
     env?: Environment;
     iceServers?: RTCIceServer[];
     mutedMicOnStart?: boolean;
+    maxReconnectAttempts?: number;
     enableCallReports?: boolean;
     callReportInterval?: number;
     mediaPermissionsRecovery?: {

package/package.json

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