feat: add option to allow ice candidate prefetching

packages/js/src/Modules/Verto/util/interfaces.ts

@@ -23,6 +23,7 @@ export interface IVertoOptions {
 
   debug?: boolean;
   debugOutput?: 'socket' | 'file';
+  prefetchIceCandidates?: boolean;
 }
 export interface SubscribeParams {
   channels?: string[];

packages/js/src/Modules/Verto/webrtc/Peer.ts

@@ -463,10 +463,11 @@ export default class Peer {
   }
 
   private _config(): RTCConfiguration {
-    const { iceServers = [] } = this.options;
+    const { iceServers = [], prefetchIceCandidates } = this.options;
 
     const config: RTCConfiguration = {
       bundlePolicy: 'max-compat',
+      iceCandidatePoolSize: prefetchIceCandidates ? 10 : 0,
       iceServers,
     };
 

packages/js/src/Modules/Verto/webrtc/VertoHandler.ts

@@ -83,6 +83,7 @@ class VertoHandler {
         mediaSettings: params.mediaSettings,
         debug: session.options.debug ?? false,
         debugOutput: session.options.debugOutput ?? 'socket',
+        prefetchIceCandidates: session.options.prefetchIceCandidates ?? false,
       };
 
       if (params.telnyx_call_control_id) {

packages/js/src/Modules/Verto/webrtc/interfaces.ts

@@ -48,6 +48,7 @@ export interface IVertoCallOptions {
   debug?: boolean;
   debugOutput?: 'socket' | 'file';
   preferred_codecs?: RTCRtpCodecCapability[];
+  prefetchIceCandidates?: boolean;
 }
 
 export interface IStatsBinding {

packages/js/src/utils/interfaces.ts

@@ -52,6 +52,22 @@ export interface IClientOptions {
    * "Generate Ringback Tone" in your SIP Connection.
    */
   ringbackFile?: string;
+
+  /**
+   * Enable debug mode for this client.
+   * This will gather WebRTC debugging information.
+   */
+  debug?: boolean;
+
+  /**
+   * Debug output option
+   */
+  debugOutput?: 'socket' | 'file';
+
+  /**
+   * Enable or disable prefetching ICE candidates.
+   */
+  prefetchIceCandidates?: boolean;
 }
 
 export interface ISIPCallOptions {
@@ -201,6 +217,11 @@ export interface ICallOptions {
    * Preferred codecs for the call.
    */
   preferred_codecs?: RTCRtpCodecCapability[];
+
+  /**
+   * ICE Candidate Prefetching.
+   */
+  prefetchIceCandidates?: boolean;
 }
 
 /**

packages/react-client/src/useTelnyxRTC.ts

@@ -4,13 +4,13 @@ import { TelnyxRTC, IClientOptions } from '@telnyx/webrtc';
 
 type TokenCredential = {
   login_token: string;
-  debug?: boolean
+  debug?: boolean;
 };
 
 type UsernameCredential = {
   login: string;
   password: string;
-  debug?: boolean
+  debug?: boolean;
 };
 
 export type CredentialOptions = TokenCredential | UsernameCredential;