@opentok/client 2.35.0-alpha.22 → 2.35.0-alpha.24

package/dist/js/opentok.js

@@ -1,11 +1,11 @@
 /**
- * @license OpenTok.js 2.35.0 d34b5dbad
+ * @license OpenTok.js 2.35.0 6076fa4b4
  *
  * Copyright (c) 2010-2026 TokBox, Inc.
  * Subject to the applicable Software Development Kit (SDK) License Agreement:
  * https://www.vonage.com/legal/communications-apis/terms-of-use/
  *
- * Date: Wed, 13 May 2026 07:26:42 GMT
+ * Date: Mon, 18 May 2026 08:41:01 GMT
  */
 
 (function webpackUniversalModuleDefinition(root, factory) {
@@ -4628,43 +4628,58 @@ const _deviceHelpers = (0, _deviceHelpers2.default)(),
 
 /**
  * Enumerates the audio input devices (such as microphones) and video input devices
- * (cameras) available to the browser.
+ * (cameras) available to the browser. This returns a promise containing the array of
+ * devices. Each object has three properties: <code>kind</code>,
+ * <code>deviceId</code>, and <code>label</code>, each of which are strings.
  * <p>
- * The array of devices is passed in as the <code>devices</code> parameter of
- * the <code>callback</code> function passed into the method.
+ * The <code>kind</code> property is set to <code>"audioInput"</code> for audio input
+ * devices or <code>"videoInput"</code> for video input devices.
+ * <p>
+ * The <code>deviceId</code> property is a unique ID for the device. You can pass
+ * the <code>deviceId</code> in as the <code>audioSource</code> or <code>videoSource</code>
+ * property of the <code>options</code> parameter of the
+ * <a href="#initPublisher">OT.initPublisher()</a> method.
+ * <p>
+ * The <code>label</code> property identifies the device. The <code>label</code>
+ * property is set to an empty string if the user has not previously granted access to
+ * a camera and microphone.
  *
- * @param callback {Function} The callback function invoked when the list of devices
+ * @param callback {Function} Optional callback function invoked when the list of devices
  * devices is available. This function takes two parameters:
  * <ul>
  *   <li><code>error</code> &mdash; This is set to an error object when
  *   there is an error in calling this method; it is set to <code>null</code>
  *   when the call succeeds.</li>
- *
  *   <li><p><code>devices</code> &mdash; An array of objects corresponding to
- *   available microphones and cameras. Each object has three properties: <code>kind</code>,
- *   <code>deviceId</code>, and <code>label</code>, each of which are strings.
- *   <p>
- *   The <code>kind</code> property is set to <code>"audioInput"</code> for audio input
- *   devices or <code>"videoInput"</code> for video input devices.
- *   <p>
- *   The <code>deviceId</code> property is a unique ID for the device. You can pass
- *   the <code>deviceId</code> in as the <code>audioSource</code> or <code>videoSource</code>
- *   property of the <code>options</code> parameter of the
- *   <a href="#initPublisher">OT.initPublisher()</a> method.
- *   <p>
- *   The <code>label</code> property identifies the device. The <code>label</code>
- *   property is set to an empty string if the user has not previously granted access to
- *   a camera and microphone.</li>
+ *   available microphones and cameras.
+ *   </li>
  * </ul>
  * <i>Note:</i> The browser may limit the number of returned audio and video input devices
  * to one each before the user has granted access to a camera or microphone.
  *
+ * @returns {Promise<Device[]>} A promise containing the list of devices
+ *
  * @see <a href="#initPublisher">OT.initPublisher()</a>
  * @method OT.getDevices
  * @memberof OT
  */
 function getDevices(callback) {
-  getInputMediaDevices().then(devices => callback(undefined, devices), callback);
+  const hasCallback = typeof callback === 'function';
+  const promise = getInputMediaDevices().then(devices => {
+    if (hasCallback) {
+      callback(undefined, devices);
+    }
+    return devices;
+  }, err => {
+    if (hasCallback) {
+      callback(err);
+    }
+    throw err;
+  });
+  if (hasCallback) {
+    promise.catch(() => {});
+  }
+  return promise;
 }
 
 /***/ }),
@@ -5059,6 +5074,7 @@ function SinglePeerConnectionAdapterFactory(deps) {
     };
 
     // SPC events wrapper for PeerConnection
+    const _onIceRestartAttempt = ev => this.trigger('iceRestartAttempt', ev);
     const _onClosed = () => this.trigger('close');
     const _onRemoteVideoSupported = supported => this.trigger('remoteVideoSupported', supported);
     const _onPeerError = _ref => {
@@ -5100,6 +5116,7 @@ function SinglePeerConnectionAdapterFactory(deps) {
       error: _onPeerError,
       qos: _onQoS,
       iceConnectionStateChange: _onIceConnectionStateChanged,
+      iceRestartAttempt: _onIceRestartAttempt,
       remoteVideoSupported: _onRemoteVideoSupported,
       decryptFailed: _onDecryptFailed,
       decryptRestored: _onDecryptRestored
@@ -5210,7 +5227,7 @@ function SinglePeerConnectionAdapterFactory(deps) {
     };
     this.remoteStreams = () => _peerConnection.remoteStreams();
     this.hasRelayCandidates = () => _peerConnection.hasRelayCandidates();
-    this.iceRestart = () => _peerConnection.iceRestart();
+    this.iceRestart = (reason, forcedRestart) => _peerConnection.iceRestart(reason, forcedRestart);
     this.iceConnectionStateIsConnected = () => _peerConnection.iceConnectionStateIsConnected();
     this.startDecryption = (connectionId, transceiver) => _peerConnection.startDecryption(connectionId, transceiver);
   };
@@ -6437,6 +6454,10 @@ function PublisherPeerConnectionFactory(deps) {
     const statsHelpers = getStatsHelpers();
 
     // Private
+    const _onIceRestartAttempt = ev => {
+      _awaitingIceRestart = true;
+      this.trigger('iceRestartAttempt', ev);
+    };
     const _onPeerClosed = function _onPeerClosed() {
       this.destroy();
       if (_awaitingIceRestart) {
@@ -6622,7 +6643,8 @@ function PublisherPeerConnectionFactory(deps) {
           close: _onPeerClosed,
           error: _onPeerError,
           qos: _qos => this.trigger('qos', _qos),
-          iceConnectionStateChange: _onIceConnectionStateChange
+          iceConnectionStateChange: _onIceConnectionStateChange,
+          iceRestartAttempt: _onIceRestartAttempt
         }, this);
         _peerConnection.addLocalStream(webRTCStream).then(() => {
           completion(undefined);
@@ -6638,11 +6660,9 @@ function PublisherPeerConnectionFactory(deps) {
     this.getSenders = function () {
       return _peerConnection.getSenders();
     };
-    this.iceRestart = function () {
-      if (_peerConnection) {
-        _awaitingIceRestart = true;
-        _peerConnection.iceRestart();
-      }
+    this.iceRestart = function (reason, forcedRestart) {
+      var _peerConnection2;
+      (_peerConnection2 = _peerConnection) == null ? void 0 : _peerConnection2.iceRestart(reason, forcedRestart);
     };
     this.hasRelayCandidates = () => _peerConnection.hasRelayCandidates();
     this.iceConnectionStateIsConnected = function () {
@@ -20048,6 +20068,10 @@ function SubscriberPeerConnectionFactory(deps) {
     const _audioTracks = [];
 
     // Private
+    const _onIceRestartAttempt = ev => {
+      _awaitingIceRestart = true;
+      this.trigger('iceRestartAttempt', ev);
+    };
     const _onPeerClosed = function _onPeerClosed() {
       this.destroy();
       if (_awaitingIceRestart) {
@@ -20239,9 +20263,8 @@ function SubscriberPeerConnectionFactory(deps) {
     this.hasRelayCandidates = function () {
       return _peerConnection.hasRelayCandidates();
     };
-    this.iceRestart = function () {
-      _awaitingIceRestart = true;
-      return _peerConnection.iceRestart();
+    this.iceRestart = function (reason, forcedRestart) {
+      return _peerConnection.iceRestart(reason, forcedRestart);
     };
     this.iceConnectionStateIsConnected = function () {
       return _peerConnection.iceConnectionStateIsConnected();
@@ -20292,6 +20315,7 @@ function SubscriberPeerConnectionFactory(deps) {
           error: _onPeerError,
           qos: _qos => this.trigger('qos', _qos),
           iceConnectionStateChange: _onIceConnectionStateChange,
+          iceRestartAttempt: _onIceRestartAttempt,
           remoteVideoSupported: _onRemoteVideoSupported,
           decryptFailed: _onDecryptFailed,
           decryptRestored: _onDecryptRestored
@@ -24498,8 +24522,8 @@ function SubscriberFactory(_ref2) {
         logAnalyticsEvent('Subscribe', variation, payload, options);
       }
     };
-    const logResubscribe = (variation, payload) => {
-      logAnalyticsEvent('ICERestart', variation, payload);
+    const logResubscribe = (variation, payload, options) => {
+      logAnalyticsEvent('ICERestart', variation, payload, options);
     };
     const recordQOS = _ref13 => {
       var _session$connection$c, _session8, _session8$connection, _properties$preferred, _properties$preferred2, _socket;
@@ -25223,13 +25247,17 @@ function SubscriberFactory(_ref2) {
         _subscriberConnectionState = currentConnectionState;
       }
     };
-    const onIceRestartSuccess = () => {
-      logResubscribe('Success');
-    };
-    const onIceRestartFailure = () => {
-      logResubscribe('Failure', {
-        reason: 'ICEWorkflow',
-        message: 'OT.Subscriber PeerConnection Error: ' + 'The stream was unable to connect due to a network error.' + ' Make sure your connection isn\'t blocked by a firewall.'
+    const onIceRestartAction = (ev, variation, peerConnection, peerId) => {
+      const sourceStreamId = peerConnection.getSourceStreamId();
+      const payload = {
+        isActive: sourceStreamId === _activeSourceStreamId
+      };
+      if (variation === 'Attempt' && ev != null && ev.reason) {
+        payload.reason = ev.reason;
+      }
+      logResubscribe(variation, payload, {
+        peerId,
+        sourceStreamId
       });
     };
     const streamUpdated = event => {
@@ -25518,7 +25546,7 @@ function SubscriberFactory(_ref2) {
         return _ref22.apply(this, arguments);
       };
     }();
-    const setPeerConnectionEvents = (peerConnection, sourceStreamId) => {
+    const setPeerConnectionEvents = (peerConnection, sourceStreamId, peerId) => {
       if (_peerConnectionEvents[sourceStreamId]) {
         _peerConnectionEvents[sourceStreamId].removeAll();
         const onDisconnected = () => {
@@ -25576,8 +25604,9 @@ function SubscriberFactory(_ref2) {
         }, _callee13);
       })));
       peerConnectionEvents.on('iceConnectionStateChange', state => onIceConnectionStateChange(state, peerConnection));
-      peerConnectionEvents.on('iceRestartSuccess', onIceRestartSuccess);
-      peerConnectionEvents.on('iceRestartFailure', onIceRestartFailure);
+      peerConnectionEvents.on('iceRestartAttempt', ev => onIceRestartAction(ev, 'Attempt', peerConnection, peerId));
+      peerConnectionEvents.on('iceRestartSuccess', ev => onIceRestartAction(ev, 'Success', peerConnection, peerId));
+      peerConnectionEvents.on('iceRestartFailure', ev => onIceRestartAction(ev, 'Failure', peerConnection, peerId));
       peerConnectionEvents.on('remoteVideoSupported', onRemoteVideoSupported);
       peerConnectionEvents.on('decryptFailed', () => {
         this.trigger('encryptionSecretMismatch');
@@ -25877,7 +25906,8 @@ function SubscriberFactory(_ref2) {
                 send,
                 log,
                 logQoS,
-                sourceStreamId
+                sourceStreamId,
+                peerId
               }));
             case 6:
             case "end":
@@ -26735,11 +26765,11 @@ function SubscriberFactory(_ref2) {
     };
     this._setupPeerConnection = /*#__PURE__*/function () {
       var _ref35 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee19(_ref34) {
-        var send, log, logQoS, sourceStreamId;
+        var send, log, logQoS, sourceStreamId, peerId;
         return _regenerator.default.wrap(function _callee19$(_context19) {
           while (1) switch (_context19.prev = _context19.next) {
             case 0:
-              send = _ref34.send, log = _ref34.log, logQoS = _ref34.logQoS, sourceStreamId = _ref34.sourceStreamId;
+              send = _ref34.send, log = _ref34.log, logQoS = _ref34.logQoS, sourceStreamId = _ref34.sourceStreamId, peerId = _ref34.peerId;
               if (_properties.testNetwork) {
                 _this.setAudioVolume(0);
               }
@@ -26779,7 +26809,7 @@ function SubscriberFactory(_ref2) {
                   peerConnection.once('iceConnected', _pcConnected.resolve);
                   peerConnection.once('error', _pcConnected.reject);
                   peerConnection.on('qos', logQoS);
-                  setPeerConnectionEvents(peerConnection, sourceStreamId);
+                  setPeerConnectionEvents(peerConnection, sourceStreamId, peerId);
 
                   // initialize the peer connection AFTER we've added the event listeners
                   peerConnection.init(err => {
@@ -26911,15 +26941,9 @@ function SubscriberFactory(_ref2) {
                 logging.debug('Subscriber: Skipping ice restart, we have no peer connection');
                 return _context21.abrupt("return");
               case 12:
-                logResubscribe('Attempt', {
-                  reason
-                });
                 logging.debug('Subscriber: iceRestart attempt');
-                peerConnection.iceRestart();
-                if (forcedRestart) {
-                  peerConnection.generateOffer();
-                }
-              case 16:
+                peerConnection.iceRestart(reason, forcedRestart);
+              case 14:
               case "end":
                 return _context21.stop();
             }
@@ -29209,6 +29233,8 @@ function RaptorSocketFactory(deps) {
 var _interopRequireDefault = __webpack_require__(95709);
 exports.__esModule = true;
 exports["default"] = getUserMediaFactory;
+var _regenerator = _interopRequireDefault(__webpack_require__(92207));
+var _asyncToGenerator2 = _interopRequireDefault(__webpack_require__(79092));
 var _assign = _interopRequireDefault(__webpack_require__(86139));
 var _isObject = _interopRequireDefault(__webpack_require__(23805));
 var _eventing = _interopRequireDefault(__webpack_require__(12607));
@@ -29496,23 +29522,41 @@ function getUserMediaFactory(deps) {
       // it when creating `finalized` above.
       const error = parseErrorEvent(browserError);
       if (error.name === Errors.UNABLE_TO_CAPTURE_SCREEN) {
-        return new Promise((resolve, reject) => {
-          screenSharing.checkCapability(response => {
-            if (response.extensionRequired === 'chrome') {
-              if (response.extensionRegistered && !response.extensionInstalled) {
-                const newErr = otError(Errors.SCREEN_SHARING_EXTENSION_NOT_INSTALLED, error);
-                newErr.message = 'Screen sharing extension not installed see https://tokbox.com/developer/guides/screen-sharing/js/#chrome-extension';
-                reject(newErr);
-              } else if (!response.extensionRegistered) {
-                const newErr = otError(Errors.SCREEN_SHARING_EXTENSION_NOT_REGISTERED, error);
-                newErr.message = 'Screen sharing extension not registered see https://tokbox.com/developer/guides/screen-sharing/js/#chrome-extension';
-                reject(newErr);
+        return new Promise( /*#__PURE__*/function () {
+          var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_, reject) {
+            var response, newErr;
+            return _regenerator.default.wrap(function _callee$(_context2) {
+              while (1) switch (_context2.prev = _context2.next) {
+                case 0:
+                  _context2.next = 2;
+                  return screenSharing.checkCapability();
+                case 2:
+                  response = _context2.sent;
+                  if (response.extensionRequired === 'chrome') {
+                    if (response.extensionRegistered && !response.extensionInstalled) {
+                      newErr = otError(Errors.SCREEN_SHARING_EXTENSION_NOT_INSTALLED, error);
+                      newErr.message = 'Screen sharing extension not installed see https://tokbox.com/developer/guides/screen-sharing/js/#chrome-extension';
+                      reject(newErr);
+                    } else if (!response.extensionRegistered) {
+                      newErr = otError(Errors.SCREEN_SHARING_EXTENSION_NOT_REGISTERED, error);
+                      newErr.message = 'Screen sharing extension not registered see https://tokbox.com/developer/guides/screen-sharing/js/#chrome-extension';
+                      reject(newErr);
+                    } else {
+                      reject(error);
+                    }
+                  } else {
+                    reject(error);
+                  }
+                case 4:
+                case "end":
+                  return _context2.stop();
               }
-            } else {
-              reject(error);
-            }
-          });
-        });
+            }, _callee);
+          }));
+          return function (_x, _x2) {
+            return _ref.apply(this, arguments);
+          };
+        }());
       }
       throw error;
     }).then(stream => {
@@ -41649,7 +41693,7 @@ function staticConfigFactory(_temp) {
     _ref$axios = _ref.axios,
     axios = _ref$axios === void 0 ? _axios.default : _ref$axios,
     _ref$properties = _ref.properties,
-    properties = _ref$properties === void 0 ? {"version":"v2.35.0","buildHash":"d34b5dbad","minimumVersion":{"firefox":52,"chrome":49},"debug":false,"websiteURL":"http://www.tokbox.com","configURL":"https://config.opentok.com","ipWhitelistConfigURL":"","cdnURL":"","loggingURL":"https://hlg.tokbox.com/prod","apiURL":"https://anvil.opentok.com","vonageApiURL":""} : _ref$properties;
+    properties = _ref$properties === void 0 ? {"version":"v2.35.0","buildHash":"6076fa4b4","minimumVersion":{"firefox":52,"chrome":49},"debug":false,"websiteURL":"http://www.tokbox.com","configURL":"https://config.opentok.com","ipWhitelistConfigURL":"","cdnURL":"","loggingURL":"https://hlg.tokbox.com/prod","apiURL":"https://anvil.opentok.com","vonageApiURL":""} : _ref$properties;
   /** @type builtInConfig */
   const builtInConfig = (0, _cloneDeep.default)(properties);
   /**
@@ -43878,8 +43922,8 @@ function PublisherFactory(_ref) {
         logAnalyticsEvent('Publish', variation, payload, logOptions);
       }
     };
-    const logRepublish = (variation, payload) => {
-      logAnalyticsEvent('ICERestart', variation, payload);
+    const logRepublish = (variation, payload, logOptions) => {
+      logAnalyticsEvent('ICERestart', variation, payload, logOptions);
     };
     const logHybridSessionTransition = (action, variation, payload) => {
       if (variation === 'Attempt') {
@@ -44398,34 +44442,29 @@ function PublisherFactory(_ref) {
       var _this$session8, _this$session8$sessio;
       return ((_this$session8 = this.session) == null ? void 0 : (_this$session8$sessio = _this$session8.sessionInfo) == null ? void 0 : _this$session8$sessio.isAdaptiveEnabled) && peerConnection.getSourceStreamId() === 'P2P';
     };
-    const onIceRestartSuccess = peerConnection => {
+    const onIceRestartAction = (ev, variation, peerConnection) => {
       const _getPeerConnectionMet4 = getPeerConnectionMeta(peerConnection),
+        peerId = _getPeerConnectionMet4.peerId,
         remoteConnectionId = _getPeerConnectionMet4.remoteConnectionId,
         sourceStreamId = _getPeerConnectionMet4.sourceStreamId;
-      logRepublish('Success', {
-        remoteConnectionId
-      });
-      if (sourceStreamId === 'MANTIS' && activeSourceStreamId === 'P2P') {
+      if (variation === 'Success' && sourceStreamId === 'MANTIS' && activeSourceStreamId === 'P2P') {
         _keepSendingRtcpToMantis(true);
       }
-    };
-    const onIceRestartFailure = peerConnection => {
-      const _getPeerConnectionMet5 = getPeerConnectionMeta(peerConnection),
-        remoteConnectionId = _getPeerConnectionMet5.remoteConnectionId;
-      logRepublish('Failure', {
-        reason: 'ICEWorkflow',
-        message: 'OT.Publisher PeerConnection Error: ' + 'The stream was unable to connect due to a network error.' + ' Make sure your connection isn\'t blocked by a firewall.',
-        remoteConnectionId
+      const payload = {
+        remoteConnectionId,
+        isActive: sourceStreamId === activeSourceStreamId
+      };
+      if (variation === 'Attempt' && ev != null && ev.reason) {
+        payload.reason = ev.reason;
+      }
+      logRepublish(variation, payload, {
+        peerId,
+        sourceStreamId
       });
     };
     const handleDisconnect = peerConnection => {
       if (_session._.isSocketConnected()) {
-        const _getPeerConnectionMet6 = getPeerConnectionMeta(peerConnection),
-          remoteConnectionId = _getPeerConnectionMet6.remoteConnectionId;
-        logRepublish('Attempt', {
-          remoteConnectionId
-        });
-        peerConnection.iceRestart();
+        peerConnection.iceRestart('peer connection disconnected');
       }
     };
     const handleConnect = /*#__PURE__*/function () {
@@ -44564,9 +44603,9 @@ function PublisherFactory(_ref) {
       if (isRoutedToRelayedTransitionComplete(peerConnection)) {
         logRoutedToRelayedTransition('Success');
       }
-      const _getPeerConnectionMet7 = getPeerConnectionMeta(peerConnection),
-        peerConnectionId = _getPeerConnectionMet7.peerConnectionId,
-        remoteSubscriberId = _getPeerConnectionMet7.remoteSubscriberId;
+      const _getPeerConnectionMet5 = getPeerConnectionMeta(peerConnection),
+        peerConnectionId = _getPeerConnectionMet5.peerConnectionId,
+        remoteSubscriberId = _getPeerConnectionMet5.remoteSubscriberId;
       (_publisherSenderStats2 = publisherSenderStats) == null ? void 0 : _publisherSenderStats2.addConnection(peerConnection, peerConnectionId, remoteSubscriberId);
       if (properties.publishVideo) {
         if (videoQualityChangedListenersCount > 0) {
@@ -44704,8 +44743,9 @@ function PublisherFactory(_ref) {
             });
           },
           qos: logQoS,
-          iceRestartSuccess: () => onIceRestartSuccess(peerConnection),
-          iceRestartFailure: () => onIceRestartFailure(peerConnection),
+          iceRestartAttempt: ev => onIceRestartAction(ev, 'Attempt', peerConnection),
+          iceRestartSuccess: ev => onIceRestartAction(ev, 'Success', peerConnection),
+          iceRestartFailure: ev => onIceRestartAction(ev, 'Failure', peerConnection),
           iceConnectionStateChange: newState => onIceConnectionStateChange(newState, peerConnection),
           audioAcquisitionProblem: () => {
             audioAcquisitionProblemDetected = true;
@@ -44726,9 +44766,9 @@ function PublisherFactory(_ref) {
             peerId: getPeerConnectionMeta(peerConnection).peerId
           })),
           videoQualityChanged: ev => {
-            const _getPeerConnectionMet8 = getPeerConnectionMeta(peerConnection),
-              remoteConnectionId = _getPeerConnectionMet8.remoteConnectionId,
-              remoteSubscriberId = _getPeerConnectionMet8.remoteSubscriberId;
+            const _getPeerConnectionMet6 = getPeerConnectionMeta(peerConnection),
+              remoteConnectionId = _getPeerConnectionMet6.remoteConnectionId,
+              remoteSubscriberId = _getPeerConnectionMet6.remoteSubscriberId;
             const statsContainer = (0, _assign.default)(remoteConnectionId.match(/^symphony\./) ? {} : {
               subscriberId: remoteSubscriberId,
               connectionId: remoteConnectionId
@@ -44957,9 +44997,9 @@ function PublisherFactory(_ref) {
               results = pcsAndStats.map(_ref22 => {
                 let pc = _ref22.pc,
                   stats = _ref22.stats;
-                const _getPeerConnectionMet9 = getPeerConnectionMeta(pc),
-                  remoteConnectionId = _getPeerConnectionMet9.remoteConnectionId,
-                  remoteSubscriberId = _getPeerConnectionMet9.remoteSubscriberId;
+                const _getPeerConnectionMet7 = getPeerConnectionMeta(pc),
+                  remoteConnectionId = _getPeerConnectionMet7.remoteConnectionId,
+                  remoteSubscriberId = _getPeerConnectionMet7.remoteSubscriberId;
                 return (0, _assign.default)(remoteConnectionId.match(/^symphony\./) ? {} : {
                   subscriberId: remoteSubscriberId,
                   connectionId: remoteConnectionId
@@ -47879,7 +47919,7 @@ function PublisherFactory(_ref) {
         clearTimeout(_migrationTimeoutId);
         const destroyPeerConnection = /*#__PURE__*/function () {
           var _ref59 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee49(pc) {
-            var _getPeerConnectionMet10, peerConnectionId;
+            var _getPeerConnectionMet8, peerConnectionId;
             return _regenerator.default.wrap(function _callee49$(_context49) {
               while (1) switch (_context49.prev = _context49.next) {
                 case 0:
@@ -47890,7 +47930,7 @@ function PublisherFactory(_ref) {
                   _context49.next = 3;
                   return _publisherStatsHelper.removePeerConnection(pc);
                 case 3:
-                  _getPeerConnectionMet10 = getPeerConnectionMeta(pc), peerConnectionId = _getPeerConnectionMet10.peerConnectionId;
+                  _getPeerConnectionMet8 = getPeerConnectionMeta(pc), peerConnectionId = _getPeerConnectionMet8.peerConnectionId;
                   delete peerConnectionsAsync[peerConnectionId];
                   pc.off('iceConnectionStateChange');
                   pc.destroy();
@@ -48005,22 +48045,14 @@ function PublisherFactory(_ref) {
           peerConnection.getDataChannel(label, getOptions, completion);
         });
       },
-      iceRestart(forcedRestart) {
+      iceRestart(reason, forcedRestart) {
         if (forcedRestart === void 0) {
           forcedRestart = false;
         }
         getAllPeerConnections().then(peerConnections => {
           peerConnections.forEach(peerConnection => {
-            const _getPeerConnectionMet11 = getPeerConnectionMeta(peerConnection),
-              remoteConnectionId = _getPeerConnectionMet11.remoteConnectionId;
-            logRepublish('Attempt', {
-              remoteConnectionId
-            });
             logging.debug('Publisher: ice restart attempt');
-            peerConnection.iceRestart();
-            if (forcedRestart) {
-              peerConnection.generateOffer();
-            }
+            peerConnection.iceRestart(reason, forcedRestart);
           });
         });
       },
@@ -59403,42 +59435,24 @@ function screenSharingFactory(deps) {
   screenSharing.pickHelper = () => screenSharingPickHelper();
 
   /**
-   * Checks for support for publishing screen-sharing streams on the client browser. The object
-   * passed to the callback function defines whether screen sharing is supported, as well as
+   * Checks for support for publishing screen-sharing streams on the client browser. The returned
+   * object in the promise defines whether screen sharing is supported, as well as
    * which screen-sharing sources (application, screen, or window) are supported. It also indicates
    * whether an extension is required, installed, and registered (if needed).
    * <p>
    * <pre>
-   * OT.checkScreenSharingCapability(function(response) {
-   *   if (!response.supported || response.extensionRegistered === false) {
-   *     // This browser does not support screen sharing
-   *   } else if (response.extensionInstalled === false) {
-   *     // Prompt to install the extension
-   *   } else {
-   *     // Screen sharing is available.
-   *   }
-   * });
+   * const response = await OT.checkScreenSharingCapability();
+   * if (!response.supported || response.extensionRegistered === false) {
+   * // This browser does not support screen sharing
+   * } else if (response.extensionInstalled === false) {
+   *   // Prompt to install the extension
+   * } else {
+   *   // Screen sharing is available.
+   * }
    * </pre>
    * <p>
-   * Chrome 72+, Firefox 52+, Safari 13+, Edge 79+, and Opera 59+ have screen-sharing
-   * support built-in, with no extension required. (Note that support for the Vonage Video API
-   * plugin for Internet Explorer is removed in Vonage Video API 2.17.) Screen sharing is
-   * <i>not</i> supported in mobile browsers. In Electron, screen sharing is supported if
-   * the <code>webPreferences.contextIsolation</code> option of the Electron BrowserWindow is
-   * set to <code>false</code> or if the app uses a preload script to access the desktop capturer.
-   * (The default value of <code>webPreferences.contextIsolation</code> option is <code>true</code>
-   * in Electron 12 and <code>false</code> in previous versions). To publish a screen-sharing video
-   * in older versions of Chrome or Opera, the client adds an extension that enables publishing a
-   * screen-sharing video stream on your domain. The Vonage Video API
-   * <a href="https://github.com/opentok/screensharing-extensions">screensharing-extensions</a>
-   * sample includes code for creating an extension for screen-sharing support in
-   * older versions of Chrome and Opera.
-   * <p>
-   * For more information, see the <a href="https://tokbox.com/developer/guides/screen-sharing/js/">
-   * Vonage Video API Screen Sharing</a> developer guide.
    *
-   * @param {function} callback The callback invoked with the support options object passed as
-   * the parameter. This object has the following properties that indicate support for publishing
+   * This object has the following properties that indicate support for publishing
    * screen-sharing streams in the client:
    * <p>
    * <ul>
@@ -59485,47 +59499,80 @@ function screenSharingFactory(deps) {
    *   </li>
    * </ul>
    *
+   * Chrome 72+, Firefox 52+, Safari 13+, Edge 79+, and Opera 59+ have screen-sharing
+   * support built-in, with no extension required. (Note that support for the Vonage Video API
+   * plugin for Internet Explorer is removed in Vonage Video API 2.17.) Screen sharing is
+   * <i>not</i> supported in mobile browsers. In Electron, screen sharing is supported if
+   * the <code>webPreferences.contextIsolation</code> option of the Electron BrowserWindow is
+   * set to <code>false</code> or if the app uses a preload script to access the desktop capturer.
+   * (The default value of <code>webPreferences.contextIsolation</code> option is <code>true</code>
+   * in Electron 12 and <code>false</code> in previous versions). To publish a screen-sharing video
+   * in older versions of Chrome or Opera, the client adds an extension that enables publishing a
+   * screen-sharing video stream on your domain. The Vonage Video API
+   * <a href="https://github.com/opentok/screensharing-extensions">screensharing-extensions</a>
+   * sample includes code for creating an extension for screen-sharing support in
+   * older versions of Chrome and Opera.
+   * <p>
+   * For more information, see the <a href="https://tokbox.com/developer/guides/screen-sharing/js/">
+   * Vonage Video API Screen Sharing</a> developer guide.
+   *
+   * @param {function} callback Optional callback invoked with the support options object passed as
+   * the parameter.
+   *
+   * @returns {Promise<ScreenSharingCapabilityResponse>} A promise with the capability
+   *
    * @see <a href="OT.html#initPublisher">OT.initPublisher()</a>
    * @see <a href="OT.html#registerScreenSharingExtension">OT.registerScreenSharingExtension()</a>
    * @method OT.checkScreenSharingCapability
    * @memberof OT
    */
-  screenSharing.checkCapability = callback => {
-    const response = {
-      supported: false,
-      extensionRequired: undefined,
-      extensionRegistered: undefined,
-      extensionInstalled: undefined,
-      supportedSources: {}
-    };
-
-    // find a supported browser
+  screenSharing.checkCapability = function (callback) {
+    if (callback === void 0) {
+      callback = () => {};
+    }
+    return new Promise(resolve => {
+      const response = {
+        supported: false,
+        extensionRequired: undefined,
+        extensionRegistered: undefined,
+        extensionInstalled: undefined,
+        supportedSources: {}
+      };
 
-    const helper = screenSharingPickHelper();
-    if (helper.name === undefined) {
-      setTimeout(callback.bind(null, response));
-      return;
-    }
-    response.supported = true;
-    response.extensionRequired = helper.proto.extensionRequired ? helper.name : undefined;
-    response.supportedSources = {
-      screen: helper.proto.sources.screen,
-      application: helper.proto.sources.application,
-      window: helper.proto.sources.window,
-      browser: helper.proto.sources.browser
-    };
-    if (!helper.instance) {
-      response.extensionRegistered = false;
-      if (response.extensionRequired) {
-        response.extensionInstalled = false;
+      // find a supported browser
+      const helper = screenSharingPickHelper();
+      if (helper.name === undefined) {
+        setTimeout(() => {
+          callback(response);
+        });
+        resolve(response);
+        return;
       }
-      setTimeout(callback.bind(null, response));
-      return;
-    }
-    response.extensionRegistered = response.extensionRequired ? true : undefined;
-    helper.instance.isInstalled(installed => {
-      response.extensionInstalled = response.extensionRequired || OTHelpers.env.name === 'Firefox' ? installed : undefined;
-      callback(response);
+      response.supported = true;
+      response.extensionRequired = helper.proto.extensionRequired ? helper.name : undefined;
+      response.supportedSources = {
+        screen: helper.proto.sources.screen,
+        application: helper.proto.sources.application,
+        window: helper.proto.sources.window,
+        browser: helper.proto.sources.browser
+      };
+      if (!helper.instance) {
+        response.extensionRegistered = false;
+        if (response.extensionRequired) {
+          response.extensionInstalled = false;
+        }
+        setTimeout(() => {
+          callback(response);
+        });
+        resolve(response);
+        return;
+      }
+      response.extensionRegistered = response.extensionRequired ? true : undefined;
+      helper.instance.isInstalled(installed => {
+        response.extensionInstalled = response.extensionRequired || OTHelpers.env.name === 'Firefox' ? installed : undefined;
+        callback(response);
+        resolve(response);
+      });
     });
   };
   screenSharing.registerExtensionHelper('electron', electronExtensionHelper);
@@ -59541,7 +59588,7 @@ function screenSharingFactory(deps) {
       videoSource = opt.videoSource,
       constraints = opt.constraints;
     return new Promise((resolve, reject) => {
-      screenSharing.checkCapability(response => {
+      screenSharing.checkCapability().then(response => {
         if (!response.supported) {
           let errorMessage = 'Screen Sharing is not supported in this browser';
           if (OTHelpers.env.isElectron) {
@@ -61742,41 +61789,51 @@ function reportIssueFactory(deps) {
   * <a href="https://tokbox.com/developer/tools/inspector/">Inspector</a> or when discussing
   * an issue with the Vonage API support team.
   *
-  * @param completionHandler {Function} A function that is called when the call to this method
+  * @param completionHandler {Function} Optional Function that is called when the call to this method
   * succeeds or fails. This function has two parameters. The first parameter is an
   * <a href="Error.html">Error</a> object that is set when the call to the
   * <code>reportIssue()</code> method fails (for example, if the client is not connected to the
   * network) or <code>null</code> when the call to the <code>reportIssue()</code> method succeeds.
   * The second parameter is set to the report ID (a unique string) when the call succeeds.
   *
+  * @returns {Promise<string>} A promise resolving to the report ID
+  *
   * @method OT.reportIssue
   * @memberof OT
   */
   return function reportIssue(completionHandler) {
-    if (completionHandler === void 0) {
-      completionHandler = () => {};
-    }
-    const reportIssueId = uuid();
-    function onDone(err) {
-      if (err) {
-        completionHandler(otError(errors.REPORT_ISSUE_FAILED, new Error('Error calling OT.reportIssue(). Check the client\'s network connection.'), ExceptionCodes.REPORT_ISSUE_ERROR));
+    const hasCompletionHandler = typeof completionHandler === 'function';
+    const callback = hasCompletionHandler ? completionHandler : () => {};
+    const promise = new Promise((resolve, reject) => {
+      const reportIssueId = uuid();
+      function onDone(err) {
+        if (err) {
+          const error = otError(errors.REPORT_ISSUE_FAILED, new Error('Error calling OT.reportIssue(). Check the client\'s network connection.'), ExceptionCodes.REPORT_ISSUE_ERROR);
+          callback(error);
+          reject(error);
+        } else {
+          callback(null, reportIssueId);
+          resolve(reportIssueId);
+        }
+      }
+      if (sessionObjects.sessions.length() === 0) {
+        analytics.logEvent({
+          action: 'ReportIssue',
+          variation: 'Event',
+          payload: {
+            reportIssueId
+          }
+        }, null, onDone);
       } else {
-        completionHandler(null, reportIssueId);
+        Promise.all(sessionObjects.sessions.map(session => session.reportIssue({
+          id: reportIssueId
+        }))).then(() => onDone(), err => onDone(err));
       }
+    });
+    if (hasCompletionHandler) {
+      promise.catch(() => {});
     }
-    if (sessionObjects.sessions.length() === 0) {
-      analytics.logEvent({
-        action: 'ReportIssue',
-        variation: 'Event',
-        payload: {
-          reportIssueId
-        }
-      }, null, onDone);
-    } else {
-      Promise.all(sessionObjects.sessions.map(session => session.reportIssue({
-        id: reportIssueId
-      }))).then(() => onDone(), err => onDone(err));
-    }
+    return promise;
   };
 }
 
@@ -65924,13 +65981,16 @@ function PeerConnectionFactory(deps) {
         iceRestartTimeout = null;
       }
     };
-    const _createOfferWithIceRestart = force => {
+    const _createOfferWithIceRestart = (reason, forcedRestart, recentlyIceRestartNeeded) => {
       clearIceRestartTimeout();
-      if (!api.iceConnectionStateIsConnected()) {
-        if (force) {
+      if (forcedRestart || !api.iceConnectionStateIsConnected()) {
+        if (forcedRestart || recentlyIceRestartNeeded) {
+          api.trigger('iceRestartAttempt', {
+            reason
+          });
           api.generateOfferAndSend();
         } else {
-          debouncedGenerateOfferAndSend();
+          debouncedGenerateOfferAndSend(reason);
         }
       } else {
         logging.debug('iceRestart is going to wait until we disconnect or negotiationNeeded' + ' and then restart ice');
@@ -65941,20 +66001,25 @@ function PeerConnectionFactory(deps) {
     };
     const _iceRestartNeeded = (() => {
       let value = false;
+      let reason;
       let lastIceRestartNeededTime = 0;
       return {
         get() {
           return value;
         },
-        set(newValueParam) {
+        set(newValueParam, iceRestartReason, forcedRestart) {
+          if (forcedRestart === void 0) {
+            forcedRestart = false;
+          }
           const newValue = Boolean(newValueParam);
           if (newValue !== value) {
             value = newValue;
+            reason = iceRestartReason;
             if (value) {
               const prevIceRestartNeededTime = lastIceRestartNeededTime;
               lastIceRestartNeededTime = Date.now();
               const recentlyIceRestartNeeded = lastIceRestartNeededTime - prevIceRestartNeededTime < 10000;
-              _createOfferWithIceRestart(recentlyIceRestartNeeded);
+              _createOfferWithIceRestart(reason, forcedRestart, recentlyIceRestartNeeded);
             } else {
               clearIceRestartTimeout();
               debouncedGenerateOfferAndSend.cancel();
@@ -65964,7 +66029,7 @@ function PeerConnectionFactory(deps) {
         run() {
           if (value) {
             clearIceRestartTimeout();
-            debouncedGenerateOfferAndSend();
+            debouncedGenerateOfferAndSend(reason);
           }
           return value;
         }
@@ -66665,7 +66730,12 @@ function PeerConnectionFactory(deps) {
       };
       api.generateOffer(offerSender);
     };
-    const debouncedGenerateOfferAndSend = debounce(api.generateOfferAndSend, 2000);
+    const debouncedGenerateOfferAndSend = debounce(reason => {
+      api.trigger('iceRestartAttempt', {
+        reason
+      });
+      api.generateOfferAndSend();
+    }, 2000);
     api.generateOffer = debounce(function (onOfferCreated) {
       if (onOfferCreated === void 0) {
         onOfferCreated = () => {};
@@ -66834,7 +66904,7 @@ function PeerConnectionFactory(deps) {
         setTimeout(tearDownPeerConnection);
       }
     };
-    api.iceRestart = () => _iceRestartNeeded.set(true);
+    api.iceRestart = (reason, forcedRestart) => _iceRestartNeeded.set(true, reason, forcedRestart);
     api.clearFailedTimeout = () => {
       if (_transitionToFailedTimeOut) {
         clearTimeout(_transitionToFailedTimeOut);
@@ -67244,6 +67314,7 @@ exports["default"] = _default;
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var Promise = __webpack_require__(86964);
 
 
 var _interopRequireDefault = __webpack_require__(95709);
@@ -67948,7 +68019,7 @@ function initPublisherFactory(deps) {
   * @method OT.initPublisher
   * @memberof OT
   */
-  return function initPublisher(targetElement, properties, completionHandler) {
+  function initPublisher(targetElement, properties, completionHandler) {
     logging.debug(`OT.initPublisher(${targetElement})`);
 
     // To support legacy (apikey, targetElement, properties) users
@@ -68005,7 +68076,6 @@ function initPublisherFactory(deps) {
     };
     let removeHandlersAndCallComplete = function removeHandlersAndCallComplete(err) {
       publisher.off('initSuccess', removeInitSuccessAndCallComplete);
-
       // We're only handling the error case here as we're just
       // initing the publisher, not actually attempting to publish.
       if (err) {
@@ -68016,7 +68086,24 @@ function initPublisherFactory(deps) {
     publisher.once('publishComplete', removeHandlersAndCallComplete);
     publisher.publish(targetElement);
     return publisher;
-  };
+  }
+
+  /**
+  * The <code>initPublisher</code> function is also available in a promisifed flavour.
+  * Note that this function will only resolve to a publisher object if there were no
+  * errors involved in its creation.
+  */
+  initPublisher.promise = (targetElement, properties) => new Promise((resolve, reject) => {
+    const args = [targetElement, properties].filter(arg => arg !== undefined);
+    const publisher = initPublisher(...args, error => {
+      if (error) {
+        reject(error);
+      } else {
+        resolve(publisher);
+      }
+    });
+  });
+  return initPublisher;
 }
 
 /***/ }),
@@ -68166,6 +68253,7 @@ module.exports = baseRest;
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
+/* provided dependency */ var Promise = __webpack_require__(86964);
 
 
 var _interopRequireDefault = __webpack_require__(95709);
@@ -68175,13 +68263,24 @@ var _get_rtc_stats_report_adapter = _interopRequireDefault(__webpack_require__(5
 var _createRtcStatsReportParser = _interopRequireDefault(__webpack_require__(14848));
 // This returns the array-ified list of stats our users are accustomed to
 var _default = (peerConnection, track, completion) => {
-  (0, _get_rtc_stats_report_adapter.default)(peerConnection, track, (err, rtcStatsReport) => {
-    if (err) {
-      completion(err);
-      return;
-    }
-    completion(null, (0, _createRtcStatsReportParser.default)()(rtcStatsReport));
+  const hasCompletion = typeof completion === 'function';
+  const callback = hasCompletion ? completion : () => {};
+  const promise = new Promise((resolve, reject) => {
+    (0, _get_rtc_stats_report_adapter.default)(peerConnection, track, (err, rtcStatsReport) => {
+      if (err) {
+        callback(err);
+        reject(err);
+        return;
+      }
+      const parsedReport = (0, _createRtcStatsReportParser.default)()(rtcStatsReport);
+      callback(null, parsedReport);
+      resolve(parsedReport);
+    });
   });
+  if (hasCompletion) {
+    promise.catch(() => {});
+  }
+  return promise;
 };
 exports["default"] = _default;
 
@@ -71083,7 +71182,7 @@ function SessionFactory(deps) {
           sessionObjects.publishers.where({
             session: this
           }).forEach(publisher => {
-            publisher._.iceRestart();
+            publisher._.iceRestart('socket reconnected');
           });
           if (!((_this$session = this.session) != null && (_this$session$session = _this$session.sessionInfo) != null && _this$session$session.p2pEnabled)) {
             sessionObjects.subscribers.where({