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

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

@@ -22,6 +22,7 @@ export default abstract class BaseSession {
     invalidMethodErrorCode: number;
     authenticationRequiredErrorCode: number;
     callReportId: string | null;
+    callReportVoiceSdkId: string | null;
     dc: string | null;
     region: string | null;
     connection: Connection;
@@ -33,6 +34,8 @@ export default abstract class BaseSession {
     protected _reconnectAttempts: number;
     private _tokenExpiryTimeout;
     private static readonly TOKEN_EXPIRY_WARNING_SECONDS;
+    private static readonly CALL_REPORT_UPLOAD_DRAIN_TIMEOUT_MS;
+    private _pendingCallReportUploads;
     private _executeQueue;
     private _pong;
     private registerAgent;
@@ -43,6 +46,8 @@ export default abstract class BaseSession {
     get reconnectDelay(): number;
     execute(msg: BaseMessage): Promise<any>;
     executeRaw(text: string): void;
+    trackCallReportUpload(upload: Promise<void>): void;
+    private _drainCallReportUploads;
     validateOptions(): boolean;
     broadcast(_params: BroadcastParams): void;
     disconnect(): Promise<void>;
@@ -68,7 +73,16 @@ export default abstract class BaseSession {
     }): Promise<void>;
     private _login;
     protected _onSocketOpen(): Promise<void>;
-    onNetworkClose(): void;
+    private _flushIntermediateCallReports;
+    private _getSocketCloseCodeName;
+    private _getSocketCloseError;
+    private _createSocketCloseFlushReason;
+    onNetworkClose(event?: {
+        code?: number;
+        reason?: string;
+        wasClean?: boolean;
+        error?: unknown;
+    }): void;
     protected _onSocketMessage(_response: any): void;
     protected _removeSubscription(protocol: string, channel?: string): void;
     protected _addSubscription(protocol: string, handler: Function, channel: string): void;

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

@@ -36,6 +36,7 @@ export interface IVertoOptions {
     maxReconnectAttempts?: number;
     enableCallReports?: boolean;
     callReportInterval?: number;
+    callReportFlushInterval?: number;
     debugLogLevel?: 'debug' | 'info' | 'warn' | 'error';
     debugLogMaxEntries?: number;
     skipLastVoiceSdkId?: boolean;

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

@@ -1,4 +1,5 @@
 import BrowserSession from '../BrowserSession';
+import { type ICallReportFlushReason } from './CallReportCollector';
 import Call from './Call';
 import Peer from './Peer';
 import { Direction, State } from './constants';
@@ -56,6 +57,7 @@ export default abstract class BaseCall implements IWebRTCCall {
     get remoteStream(): MediaStream;
     get memberChannel(): string;
     get isAudioMuted(): boolean;
+    shouldForceRelayCandidateForRecovery(): boolean;
     invite(): Promise<void>;
     answer(params?: AnswerParams): Promise<void>;
     playRingtone(): void;
@@ -83,6 +85,7 @@ export default abstract class BaseCall implements IWebRTCCall {
     setBandwidthEncodingsMaxBps(max: number, _kind: string): Promise<void>;
     setAudioBandwidthEncodingsMaxBps(max: number): void;
     setVideoBandwidthEncodingsMaxBps(max: number): void;
+    private _isTerminatingOrTerminated;
     getStats(callback: Function, constraints: any): void;
     setState(state: State): void;
     handleMessage(msg: any): void;
@@ -122,6 +125,8 @@ export default abstract class BaseCall implements IWebRTCCall {
     private _hasUsablePeerConnection;
     private _init;
     protected _finalize(): void;
+    private _getCallReportVoiceSdkId;
+    flushIntermediateCallReport(flushReason?: ICallReportFlushReason): void;
     private _flushIntermediateReport;
     private _postCallReport;
     private _startStats;

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

@@ -55,6 +55,7 @@ export interface ITransportStats {
 export interface ICallReportOptions {
     enabled: boolean;
     interval: number;
+    intermediateReportInterval?: number;
 }
 export interface ILogCollectorOptions {
     enabled: boolean;
@@ -112,11 +113,22 @@ export interface ICallSummary {
     startTimestamp?: string;
     endTimestamp?: string;
 }
+export interface ICallReportFlushReason {
+    type: 'buffer-limit' | 'manual' | 'socket-close' | 'socket-error';
+    socketClose?: {
+        code?: number;
+        codeName?: string;
+        reason?: string;
+        wasClean?: boolean;
+        error?: string;
+    };
+}
 export interface ICallReportPayload {
     summary: ICallSummary;
     stats: IStatsInterval[];
     logs?: ILogEntry[];
     segment?: number;
+    flushReason?: ICallReportFlushReason;
 }
 export declare class CallReportCollector {
     private options;
@@ -139,6 +151,7 @@ export declare class CallReportCollector {
     private readonly MAX_BUFFER_SIZE;
     private static readonly STATS_FLUSH_THRESHOLD;
     private static readonly LOGS_FLUSH_THRESHOLD;
+    private static readonly DEFAULT_INTERMEDIATE_REPORT_INTERVAL_MS;
     onFlushNeeded: (() => void) | null;
     onWarning: ((warning: ITelnyxWarning) => void) | null;
     private static readonly CONSECUTIVE_BREACHES_REQUIRED;
@@ -158,23 +171,29 @@ export declare class CallReportCollector {
     private _hasConfirmedLocalAudio;
     private _confirmedLocalAudioSilenceMs;
     private _segmentIndex;
+    private _lastIntermediateFlushTime;
     private _flushing;
     private _stopped;
-    private static readonly RETRY_DELAY_MS;
+    private static readonly RETRY_DELAYS_MS;
+    private static readonly KEEPALIVE_BODY_LIMIT_BYTES;
     constructor(options: ICallReportOptions, logCollectorOptions?: ILogCollectorOptions);
     start(peerConnection: RTCPeerConnection): void;
     stop(): Promise<void>;
-    flush(summary: ICallSummary): ICallReportPayload | null;
+    flush(summary: ICallSummary, flushReason?: ICallReportFlushReason): ICallReportPayload | null;
     postReport(summary: ICallSummary, callReportId: string, host: string, voiceSdkId?: string): Promise<void>;
     sendPayload(payload: ICallReportPayload, callReportId: string, host: string, voiceSdkId?: string): Promise<void>;
     private _sendPayload;
     getStatsBuffer(): IStatsInterval[];
+    shouldForceRelayCandidateForRecovery(): boolean;
     getLogs(): ILogEntry[];
+    private _positiveDelta;
     cleanup(): void;
     private _scheduleNextCollection;
     private _collectionIntervalFor;
     private _positiveInterval;
     private _collectStats;
+    private _getIntermediateReportInterval;
+    private _requestIntermediateFlushIfNeeded;
     private _checkQualityWarnings;
     private _trackLowLocalAudio;
     private _resetLowLocalAudioWarning;

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

@@ -1,3 +1,4 @@
+import type { ICallReportFlushReason } from './CallReportCollector';
 import { State } from './constants';
 export interface IMediaSettings {
     useSdpASBandwidthKbps?: boolean;
@@ -109,6 +110,7 @@ export interface IWebRTCCall {
     invite: () => void;
     answer: (params: AnswerParams) => void;
     hangup: (params?: IHangupParams, execute?: boolean) => Promise<void>;
+    flushIntermediateCallReport?: (reason?: ICallReportFlushReason) => void;
     hold: () => void;
     unhold: () => void;
     toggleHold: () => void;
@@ -128,6 +130,7 @@ export interface IWebRTCCall {
     setAudioBandwidthEncodingsMaxBps: (max: number) => void;
     setVideoBandwidthEncodingsMaxBps: (max: number) => void;
     getStats: (callback: Function, constraints: any) => void;
+    shouldForceRelayCandidateForRecovery?: () => boolean;
     setState: (state: State) => void;
     handleMessage: (msg: any) => void;
     _addChannel: (laChannel: any) => void;

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

@@ -38,6 +38,7 @@ export interface IClientOptions {
     maxReconnectAttempts?: number;
     enableCallReports?: boolean;
     callReportInterval?: number;
+    callReportFlushInterval?: number;
     mediaPermissionsRecovery?: {
         enabled: boolean;
         timeout: number;

package/package.json

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