quickblox 2.21.1 → 2.21.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "quickblox",
   "description": "QuickBlox JavaScript SDK",
-  "version": "2.21.1",
+  "version": "2.21.2",
   "homepage": "https://quickblox.com/developers/Javascript",
   "main": "src/qbMain.js",
   "types": "quickblox.d.ts",

package/quickblox.d.ts

@@ -116,6 +116,12 @@ export declare interface QBConfig {
      * Set the number of seconds for the statistical information to be received.
      */
     statsReportTimeInterval?: boolean
+    /**
+     * Transport policy for ICE candidate gathering.
+     * Mirrors RTCPeerConnection. Allowed: "all" | "relay".
+     * When "relay", only TURN-relayed candidates will be used.
+     */
+    iceTransportPolicy?: 'all' | 'relay'
     /**
      * You can customize a list of ICE servers. By default,
      * WebRTC module will use internal ICE servers that are usually enough,
@@ -268,7 +274,7 @@ export declare interface ChatMessageAttachment {
   duration?: string | number
   /* Custom parameters. Useful for storing metadata of attachment */
   data?: string
-  [key: string]: string | undefined
+  [key: string]: string | number | undefined
 }
 
 declare enum QBChatDialogType {
@@ -411,7 +417,7 @@ export declare interface QBChatXMPPMessage {
         date_sent: string
         save_to_history: string
         attachments?: ChatMessageAttachment[]
-        [custom_field_N: string]: string | ChatMessageAttachment[]
+        [custom_field_N: string]: string
     }
 }
 
@@ -1326,6 +1332,7 @@ export declare interface QBWebRTCModule {
     session: QBWebRTCSession,
     userId: QBUser['id'],
     stats: any,
+    error?: unknown,
   ) => void
   onRejectCallListener?: (
     session: QBWebRTCSession,

package/quickblox.js

@@ -54154,9 +54154,14 @@ WebRTCSession.prototype._createPeer = function (userId, polite) {
 
     this.startCallTime = new Date();
 
-    var pcConfig = {
-        iceServers: config.webrtc.iceServers,
-    };
+    // var pcConfig = {
+    //     iceServers: config.webrtc.iceServers,
+    // };
+    const base = { iceServers: config.webrtc.iceServers };
+    const extra = (typeof config.webrtc.iceTransportPolicy === 'undefined') ? {}
+        : { iceTransportPolicy: config.webrtc.iceTransportPolicy };
+
+    const pcConfig = Object.assign({}, base, extra);
 
     Helpers.trace("_createPeer configuration: " + JSON.stringify(pcConfig));
 
@@ -54321,9 +54326,14 @@ WebRTCSession.prototype._reconnect = function (peerConnection, negotiate) {
 
     peerConnection.release();
 
-    var pcConfig = {
-        iceServers: config.webrtc.iceServers,
-    };
+    // var pcConfig = {
+    //     iceServers: config.webrtc.iceServers,
+    // };
+    const base = { iceServers: config.webrtc.iceServers };
+    const extra = (typeof config.webrtc.iceTransportPolicy === 'undefined') ? {}
+        : { iceTransportPolicy: config.webrtc.iceTransportPolicy };
+
+    const pcConfig = Object.assign({}, base, extra);
 
     Helpers.trace("_reconnect peer configuration: " + JSON.stringify(pcConfig));
 
@@ -55118,8 +55128,8 @@ module.exports = StreamManagement;
  */
 
 var config = {
-  version: '2.21.1-alpha.1',
-  buildNumber: '1168',
+  version: '2.21.2',
+  buildNumber: '1169',
   creds: {
     'appId': 0,
     'authKey': '',
@@ -55153,6 +55163,12 @@ var config = {
     dialingTimeInterval: 5,
     disconnectTimeInterval: 30,
     statsReportTimeInterval: false,
+    /**
+     * ICE transport policy.
+     * If undefined -> do not pass this option into RTCPeerConnection.
+     * Allowed values when set: "all" | "relay".
+     */
+    iceTransportPolicy: undefined,
     iceServers: [
       {
         urls: ['turn:turn.quickblox.com', 'stun:turn.quickblox.com'],
@@ -55191,33 +55207,49 @@ var config = {
   callBackInterval: 30,
 };
 
-config.set = function(options) {
-  if (typeof options.endpoints === 'object' && options.endpoints.chat) {
-    config.endpoints.muc = 'muc.'+options.endpoints.chat;
-    config.chatProtocol.bosh = 'https://'+options.endpoints.chat+':5281';
-    config.chatProtocol.websocket = 'wss://'+options.endpoints.chat+':5291';
-  }
-
-  Object.keys(options).forEach(function(key) {
-    if(key !== 'set' && config.hasOwnProperty(key)) {
-      if(typeof options[key] !== 'object') {
-        config[key] = options[key];
-      } else {
-        Object.keys(options[key]).forEach(function(nextkey) {
-          if(config[key].hasOwnProperty(nextkey)){
-            config[key][nextkey] = options[key][nextkey];
-          }
-        });
-      }
+config.set = function (options) {
+    // Update chat endpoints (same behavior as before)
+    if (typeof options.endpoints === 'object' && options.endpoints.chat) {
+        config.endpoints.muc = 'muc.' + options.endpoints.chat;
+        config.chatProtocol.bosh = 'https://' + options.endpoints.chat + ':5281';
+        config.chatProtocol.websocket = 'wss://' + options.endpoints.chat + ':5291';
     }
 
-    // backward compatibility: for config.iceServers
-    if(key === 'iceServers') {
-      config.webrtc.iceServers = options[key];
-    }
-  });
+    // Shallow merge: copy only known keys; skip undefined values
+    Object.keys(options).forEach(function (key) {
+        if (key !== 'set' && Object.prototype.hasOwnProperty.call(config, key)) {
+            if (typeof options[key] !== 'object' || options[key] === null) {
+                // Primitive or null: assign as is
+                if (typeof options[key] !== 'undefined') {
+                    config[key] = options[key];
+                }
+            } else {
+                // Object: copy only known subkeys; skip undefined values
+                Object.keys(options[key]).forEach(function (nextkey) {
+                    if (
+                        Object.prototype.hasOwnProperty.call(config[key], nextkey) &&
+                        typeof options[key][nextkey] !== 'undefined'
+                    ) {
+                        config[key][nextkey] = options[key][nextkey];
+                    }
+                });
+            }
+        }
+
+        // Backward compatibility: allow top-level iceServers
+        if (key === 'iceServers' && typeof options[key] !== 'undefined') {
+            config.webrtc.iceServers = options[key];
+        }
+
+        // Backward compatibility: allow top-level iceTransportPolicy
+        if (key === 'iceTransportPolicy' && typeof options[key] !== 'undefined') {
+            // Allowed values when set: "all" | "relay"
+            config.webrtc.iceTransportPolicy = options[key];
+        }
+    });
 };
 
+
 config.updateSessionExpirationDate = function (tokenExpirationDate, headerHasToken = false) {
   var connectionTimeLag = 1; // minute
   var newDate;

package/src/modules/webrtc/qbWebRTCSession.js

@@ -901,9 +901,14 @@ WebRTCSession.prototype._createPeer = function (userId, polite) {
 
     this.startCallTime = new Date();
 
-    var pcConfig = {
-        iceServers: config.webrtc.iceServers,
-    };
+    // var pcConfig = {
+    //     iceServers: config.webrtc.iceServers,
+    // };
+    const base = { iceServers: config.webrtc.iceServers };
+    const extra = (typeof config.webrtc.iceTransportPolicy === 'undefined') ? {}
+        : { iceTransportPolicy: config.webrtc.iceTransportPolicy };
+
+    const pcConfig = Object.assign({}, base, extra);
 
     Helpers.trace("_createPeer configuration: " + JSON.stringify(pcConfig));
 
@@ -1068,9 +1073,14 @@ WebRTCSession.prototype._reconnect = function (peerConnection, negotiate) {
 
     peerConnection.release();
 
-    var pcConfig = {
-        iceServers: config.webrtc.iceServers,
-    };
+    // var pcConfig = {
+    //     iceServers: config.webrtc.iceServers,
+    // };
+    const base = { iceServers: config.webrtc.iceServers };
+    const extra = (typeof config.webrtc.iceTransportPolicy === 'undefined') ? {}
+        : { iceTransportPolicy: config.webrtc.iceTransportPolicy };
+
+    const pcConfig = Object.assign({}, base, extra);
 
     Helpers.trace("_reconnect peer configuration: " + JSON.stringify(pcConfig));
 

package/src/qbConfig.js

@@ -12,8 +12,8 @@
  */
 
 var config = {
-  version: '2.21.1-alpha.1',
-  buildNumber: '1168',
+  version: '2.21.2',
+  buildNumber: '1169',
   creds: {
     'appId': 0,
     'authKey': '',
@@ -47,6 +47,12 @@ var config = {
     dialingTimeInterval: 5,
     disconnectTimeInterval: 30,
     statsReportTimeInterval: false,
+    /**
+     * ICE transport policy.
+     * If undefined -> do not pass this option into RTCPeerConnection.
+     * Allowed values when set: "all" | "relay".
+     */
+    iceTransportPolicy: undefined,
     iceServers: [
       {
         urls: ['turn:turn.quickblox.com', 'stun:turn.quickblox.com'],
@@ -85,33 +91,49 @@ var config = {
   callBackInterval: 30,
 };
 
-config.set = function(options) {
-  if (typeof options.endpoints === 'object' && options.endpoints.chat) {
-    config.endpoints.muc = 'muc.'+options.endpoints.chat;
-    config.chatProtocol.bosh = 'https://'+options.endpoints.chat+':5281';
-    config.chatProtocol.websocket = 'wss://'+options.endpoints.chat+':5291';
-  }
-
-  Object.keys(options).forEach(function(key) {
-    if(key !== 'set' && config.hasOwnProperty(key)) {
-      if(typeof options[key] !== 'object') {
-        config[key] = options[key];
-      } else {
-        Object.keys(options[key]).forEach(function(nextkey) {
-          if(config[key].hasOwnProperty(nextkey)){
-            config[key][nextkey] = options[key][nextkey];
-          }
-        });
-      }
+config.set = function (options) {
+    // Update chat endpoints (same behavior as before)
+    if (typeof options.endpoints === 'object' && options.endpoints.chat) {
+        config.endpoints.muc = 'muc.' + options.endpoints.chat;
+        config.chatProtocol.bosh = 'https://' + options.endpoints.chat + ':5281';
+        config.chatProtocol.websocket = 'wss://' + options.endpoints.chat + ':5291';
     }
 
-    // backward compatibility: for config.iceServers
-    if(key === 'iceServers') {
-      config.webrtc.iceServers = options[key];
-    }
-  });
+    // Shallow merge: copy only known keys; skip undefined values
+    Object.keys(options).forEach(function (key) {
+        if (key !== 'set' && Object.prototype.hasOwnProperty.call(config, key)) {
+            if (typeof options[key] !== 'object' || options[key] === null) {
+                // Primitive or null: assign as is
+                if (typeof options[key] !== 'undefined') {
+                    config[key] = options[key];
+                }
+            } else {
+                // Object: copy only known subkeys; skip undefined values
+                Object.keys(options[key]).forEach(function (nextkey) {
+                    if (
+                        Object.prototype.hasOwnProperty.call(config[key], nextkey) &&
+                        typeof options[key][nextkey] !== 'undefined'
+                    ) {
+                        config[key][nextkey] = options[key][nextkey];
+                    }
+                });
+            }
+        }
+
+        // Backward compatibility: allow top-level iceServers
+        if (key === 'iceServers' && typeof options[key] !== 'undefined') {
+            config.webrtc.iceServers = options[key];
+        }
+
+        // Backward compatibility: allow top-level iceTransportPolicy
+        if (key === 'iceTransportPolicy' && typeof options[key] !== 'undefined') {
+            // Allowed values when set: "all" | "relay"
+            config.webrtc.iceTransportPolicy = options[key];
+        }
+    });
 };
 
+
 config.updateSessionExpirationDate = function (tokenExpirationDate, headerHasToken = false) {
   var connectionTimeLag = 1; // minute
   var newDate;