@opentok/client 2.35.0-alpha.55 → 2.35.0-alpha.57

package/dist/js/opentok.js

@@ -1,11 +1,11 @@
 /**
- * @license OpenTok.js 2.35.0 5b7d62ce7
+ * @license OpenTok.js 2.35.0 929017bbf
  *
  * 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: Tue, 16 Jun 2026 08:15:22 GMT
+ * Date: Fri, 19 Jun 2026 06:02:39 GMT
  */
 
 (function webpackUniversalModuleDefinition(root, factory) {
@@ -39202,7 +39202,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":"5b7d62ce7","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":"929017bbf","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);
   /**
@@ -41014,6 +41014,7 @@ function PublisherFactory(_ref) {
     let _preferredWidth;
     let _preferredHeight;
     let _preferredFrameRate;
+    let _suppressVideoDimensionsSignaling = false;
     let _targetScalabilityMode;
     let _peerId;
     let _raptorUri;
@@ -43018,7 +43019,7 @@ function PublisherFactory(_ref) {
             if (!properties.publishVideo) {
               return;
             }
-            if (_this.stream) {
+            if (_this.stream && !_suppressVideoDimensionsSignaling) {
               _this.stream.setVideoDimensions(newValue.width, newValue.height);
             }
             _this.dispatchEvent(new Events.VideoDimensionsChangedEvent(_this, oldValue, newValue));
@@ -45464,6 +45465,20 @@ function PublisherFactory(_ref) {
             this._setScalableVideoLayers(properties.scalableVideoLayers);
             configureScalabilityMode().catch(() => {});
 
+            // Propagate any preferred resolution/frameRate set before publish via signaling
+            if (this.stream && (_preferredWidth || _preferredHeight || _preferredFrameRate)) {
+              const _getPreferredVideoTra = getPreferredVideoTrackSettings(),
+                width = _getPreferredVideoTra.width,
+                height = _getPreferredVideoTra.height,
+                actualFrameRate = _getPreferredVideoTra.frameRate;
+              if (width && height && (_preferredWidth || _preferredHeight)) {
+                this.stream.setVideoDimensions(width, height);
+              }
+              if (actualFrameRate && _preferredFrameRate) {
+                this.stream.setVideoFrameRate(actualFrameRate);
+              }
+            }
+
             // See OPENTOK-45935
             // Some users reuse the publisher when disconnecting and reconnecting
             // to a session. This re-synchronizes the state of the stream channels.
@@ -47412,9 +47427,17 @@ function PublisherFactory(_ref) {
       };
       return (0, _videoConstraints.default)(track, constraints);
     };
+
+    // Returns the settings of the most authoritative video track, using the same
+    // priority order as applyVideoConstraints (original track before processed track).
+    const getPreferredVideoTrackSettings = () => {
+      var _videoMediaProcessorC, _webRTCStream, _webRTCStream$getVide6, _track$getSettings;
+      const track = typeof (mediaProcessor == null ? void 0 : mediaProcessor.getOriginalVideoTrack) === 'function' && mediaProcessor.getOriginalVideoTrack() || ((_videoMediaProcessorC = _videoMediaProcessorConnector) == null ? void 0 : _videoMediaProcessorC.originalTrack) || ((_webRTCStream = webRTCStream) == null ? void 0 : (_webRTCStream$getVide6 = _webRTCStream.getVideoTracks()) == null ? void 0 : _webRTCStream$getVide6[0]);
+      return (_track$getSettings = track == null ? void 0 : track.getSettings()) != null ? _track$getSettings : {};
+    };
     const applyVideoConstraints = () => {
-      var _videoMediaProcessorC;
-      const videoTracks = [mediaProcessor == null ? void 0 : mediaProcessor.getOriginalVideoTrack(), (_videoMediaProcessorC = _videoMediaProcessorConnector) == null ? void 0 : _videoMediaProcessorC.originalTrack, ...webRTCStream.getVideoTracks()].filter(track => {
+      var _videoMediaProcessorC2;
+      const videoTracks = [typeof (mediaProcessor == null ? void 0 : mediaProcessor.getOriginalVideoTrack) === 'function' && mediaProcessor.getOriginalVideoTrack(), (_videoMediaProcessorC2 = _videoMediaProcessorConnector) == null ? void 0 : _videoMediaProcessorC2.originalTrack, ...webRTCStream.getVideoTracks()].filter(track => {
         var _window$MediaStreamTr;
         return track && (
         // On Chrome both original and filtered track (instance of MediaStreamTrackGenerator) need to
@@ -47449,15 +47472,15 @@ function PublisherFactory(_ref) {
      */
     this.setPreferredResolution = /*#__PURE__*/function () {
       var _ref71 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee64(preferredResolution) {
-        var _webRTCStream, _webRTCStream$getVide6, _properties$videoDime3, _properties$videoDime4;
-        var message, startingWidth, startingHeight, startingArea, preferredArea, result;
+        var _webRTCStream2, _webRTCStream2$getVid, _properties$videoDime3, _properties$videoDime4;
+        var message, startingWidth, startingHeight, startingArea, preferredArea, result, _getPreferredVideoTra2, width, height;
         return _regenerator.default.wrap(function _callee64$(_context64) {
           while (1) switch (_context64.prev = _context64.next) {
             case 0:
               logAnalyticsEvent('setPreferredResolution', 'Attempt', {
                 preferredResolution
               });
-              if (!(!properties.publishVideo || !((_webRTCStream = webRTCStream) != null && (_webRTCStream$getVide6 = _webRTCStream.getVideoTracks()) != null && _webRTCStream$getVide6.length))) {
+              if (!(!properties.publishVideo || !((_webRTCStream2 = webRTCStream) != null && (_webRTCStream2$getVid = _webRTCStream2.getVideoTracks()) != null && _webRTCStream2$getVid.length))) {
                 _context64.next = 5;
                 break;
               }
@@ -47496,28 +47519,46 @@ function PublisherFactory(_ref) {
             case 17:
               _preferredWidth = preferredResolution.width;
               _preferredHeight = preferredResolution.height;
-              _context64.prev = 19;
-              _context64.next = 22;
+              // Suppress videoDimensionsChanged before applying constraints: the video element
+              // resize triggered by applyVideoConstraints() would otherwise cause a duplicate
+              // streamChannelUpdate. We do the signaling ourselves below with the actual track settings.
+              _suppressVideoDimensionsSignaling = true;
+              _context64.prev = 20;
+              _context64.prev = 21;
+              _context64.next = 24;
               return applyVideoConstraints();
-            case 22:
+            case 24:
               result = _context64.sent;
+              if (_this.stream) {
+                _getPreferredVideoTra2 = getPreferredVideoTrackSettings(), width = _getPreferredVideoTra2.width, height = _getPreferredVideoTra2.height;
+                if (width && height) {
+                  _this.stream.setVideoDimensions(width, height);
+                }
+              }
               logAnalyticsEvent('setPreferredResolution', 'Success', {
                 preferredResolution
               });
               return _context64.abrupt("return", result);
-            case 27:
-              _context64.prev = 27;
-              _context64.t0 = _context64["catch"](19);
+            case 28:
+              _context64.prev = 28;
+              _suppressVideoDimensionsSignaling = false;
+              return _context64.finish(28);
+            case 31:
+              _context64.next = 37;
+              break;
+            case 33:
+              _context64.prev = 33;
+              _context64.t0 = _context64["catch"](20);
               logAnalyticsEvent('setPreferredResolution', 'Failure', {
                 preferredResolution,
                 message: _context64.t0.message
               });
               throw _context64.t0;
-            case 31:
+            case 37:
             case "end":
               return _context64.stop();
           }
-        }, _callee64, null, [[19, 27]]);
+        }, _callee64, null, [[20, 33], [21,, 28, 31]]);
       }));
       return function (_x52) {
         return _ref71.apply(this, arguments);
@@ -47542,15 +47583,15 @@ function PublisherFactory(_ref) {
      */
     this.setPreferredFrameRate = /*#__PURE__*/function () {
       var _ref72 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee65(frameRate) {
-        var _webRTCStream2, _webRTCStream2$getVid;
-        var message, result;
+        var _webRTCStream3, _webRTCStream3$getVid;
+        var message, result, _getPreferredVideoTra3, actualFrameRate;
         return _regenerator.default.wrap(function _callee65$(_context65) {
           while (1) switch (_context65.prev = _context65.next) {
             case 0:
               logAnalyticsEvent('setPreferredFrameRate', 'Attempt', {
                 frameRate
               });
-              if (!(!properties.publishVideo || !((_webRTCStream2 = webRTCStream) != null && (_webRTCStream2$getVid = _webRTCStream2.getVideoTracks()) != null && _webRTCStream2$getVid.length))) {
+              if (!(!properties.publishVideo || !((_webRTCStream3 = webRTCStream) != null && (_webRTCStream3$getVid = _webRTCStream3.getVideoTracks()) != null && _webRTCStream3$getVid.length))) {
                 _context65.next = 5;
                 break;
               }
@@ -47578,23 +47619,29 @@ function PublisherFactory(_ref) {
               return applyVideoConstraints();
             case 13:
               result = _context65.sent;
+              if (_this.stream) {
+                _getPreferredVideoTra3 = getPreferredVideoTrackSettings(), actualFrameRate = _getPreferredVideoTra3.frameRate;
+                if (actualFrameRate) {
+                  _this.stream.setVideoFrameRate(actualFrameRate);
+                }
+              }
               logAnalyticsEvent('setPreferredFrameRate', 'Success', {
                 frameRate
               });
               return _context65.abrupt("return", result);
-            case 18:
-              _context65.prev = 18;
+            case 19:
+              _context65.prev = 19;
               _context65.t0 = _context65["catch"](10);
               logAnalyticsEvent('setPreferredFrameRate', 'Failure', {
                 frameRate,
                 message: _context65.t0.message
               });
               throw _context65.t0;
-            case 22:
+            case 23:
             case "end":
               return _context65.stop();
           }
-        }, _callee65, null, [[10, 18]]);
+        }, _callee65, null, [[10, 19]]);
       }));
       return function (_x53) {
         return _ref72.apply(this, arguments);
@@ -62427,7 +62474,6 @@ function PeerConnectionFactory(deps) {
       options
     });
     const sdpTransforms = sdpTransformDefaults;
-    const shouldFilterCandidate = candidate => iceConfig.transportPolicy === 'relay' && candidate != null && candidate.candidate.indexOf('typ relay') === -1;
     const config = (0, _omit.default)(options, ['isPublisher', 'logAnalyticsEvent', 'offerOverrides', 'answerOverrides', 'sendMessage']);
     let _peerConnection, _channels, _offer, _answer, _transitionToFailedTimeOut;
     let _peerConnectionCompletionHandlers = [];
@@ -62559,16 +62605,23 @@ function PeerConnectionFactory(deps) {
         }
       };
     })();
-    const _readyToCompleteOffer = {
+    let candidateReadyTimer;
+    let candidatesReadyResolved = false;
+    const _candidatesReady = {
       clean() {
+        if (candidateReadyTimer) {
+          clearTimeout(candidateReadyTimer);
+          candidateReadyTimer = null;
+        }
+        candidatesReadyResolved = true;
         delete this.promise;
         delete this.resolve;
         delete this.reject;
       }
     };
-    _readyToCompleteOffer.promise = new Promise((resolve, reject) => {
-      _readyToCompleteOffer.resolve = resolve;
-      _readyToCompleteOffer.reject = reject;
+    _candidatesReady.promise = new Promise((resolve, reject) => {
+      _candidatesReady.resolve = resolve;
+      _candidatesReady.reject = reject;
     });
     let _iceProcessor = new IceCandidateProcessor();
     let _state = 'new';
@@ -62733,7 +62786,6 @@ function PeerConnectionFactory(deps) {
         return _ref6.apply(this, arguments);
       };
     }();
-    _readyToCompleteOffer.resolve();
     const getOrCreateSFrameReceiverClient = /*#__PURE__*/function () {
       var _ref7 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee6(sFrameSenderId) {
         return _regenerator.default.wrap(function _callee6$(_context6) {
@@ -62903,12 +62955,45 @@ function PeerConnectionFactory(deps) {
         logging,
         logAnalyticsEvent
       });
+
+      // Wait for a relay candidate before completing the offer so that relay
+      // candidates are available as fallback when iceTransportPolicy is 'all'.
+      const CANDIDATE_READY_TIMEOUT = 2000;
+      const resolveCandidatesReady = function resolveCandidatesReady(timeoutReached) {
+        if (timeoutReached === void 0) {
+          timeoutReached = false;
+        }
+        if (candidateReadyTimer) {
+          clearTimeout(candidateReadyTimer);
+          candidateReadyTimer = null;
+        }
+        if (candidatesReadyResolved) return;
+        candidatesReadyResolved = true;
+        _candidatesReady.resolve();
+        if (timeoutReached) {
+          const msg = `In ${CANDIDATE_READY_TIMEOUT}ms the ICE gathering didn't finish and no relay candidate was received`;
+          logging.warn(msg);
+          logAnalyticsEvent('iceCandidatesReady', 'Event', {
+            msg
+          });
+        }
+      };
+      if (candidateReadyTimer) {
+        clearTimeout(candidateReadyTimer);
+      }
+      candidateReadyTimer = setTimeout(resolveCandidatesReady, CANDIDATE_READY_TIMEOUT, true);
       const onIceCandidate = event => {
-        _readyToCompleteOffer.resolve();
-        if (shouldFilterCandidate(event.candidate)) {
-          logging.debug('Ignore candidate', event.candidate.candidate);
+        var _candidate$candidate;
+        const candidate = event.candidate;
+        const isRelayCandidate = candidate == null ? void 0 : (_candidate$candidate = candidate.candidate) == null ? void 0 : _candidate$candidate.includes('typ relay');
+        if (candidate !== null && iceConfig.transportPolicy === 'relay' && !isRelayCandidate) {
           return;
         }
+        if (isRelayCandidate || candidate === null) {
+          // If we have a relay candidate or the gathering is completed (candidate === null),
+          // resolve immediately
+          resolveCandidatesReady();
+        }
         forwarder(event);
       };
       const onTrackAdded = /*#__PURE__*/function () {
@@ -62982,11 +63067,18 @@ function PeerConnectionFactory(deps) {
         }
         api.trigger('negotiationNeeded');
       };
+      const onIceGatheringStateChange = () => {
+        if (_peerConnection.iceGatheringState === 'complete') {
+          // Gathering is done — resolve even if no relay candidate arrived
+          resolveCandidatesReady();
+        }
+      };
       _peerConnection.addEventListener('track', onTrackAdded);
       _peerConnection.addEventListener('icecandidate', onIceCandidate);
       _peerConnection.addEventListener('signalingstatechange', routeStateChanged);
       _peerConnection.addEventListener('negotiationneeded', onNegotiationNeeded);
       _peerConnection.addEventListener('iceconnectionstatechange', onIceConnectionStateChanged);
+      _peerConnection.addEventListener('icegatheringstatechange', onIceGatheringStateChange);
       cleanupJobs.add(() => {
         if (!_peerConnection) {
           return;
@@ -62996,6 +63088,7 @@ function PeerConnectionFactory(deps) {
         _peerConnection.removeEventListener('signalingstatechange', routeStateChanged);
         _peerConnection.removeEventListener('negotiationneeded', onNegotiationNeeded);
         _peerConnection.removeEventListener('iceconnectionstatechange', onIceConnectionStateChanged);
+        _peerConnection.removeEventListener('icegatheringstatechange', onIceGatheringStateChange);
       });
       triggerPeerConnectionCompletion(null);
     };
@@ -63017,7 +63110,7 @@ function PeerConnectionFactory(deps) {
       _peerConnectionCompletionHandlers = [];
       qos.stopCollecting();
       cleanupJobs.releaseAll();
-      _readyToCompleteOffer.clean();
+      _candidatesReady.clean();
       statsCache.destroy();
       if (_peerConnection !== null) {
         if (_peerConnection.destroy) {
@@ -63140,7 +63233,7 @@ function PeerConnectionFactory(deps) {
       };
       const onRemoteVideoSupported = supported => api.trigger('remoteVideoSupported', supported);
       internalCreatePeerConnection(() => {
-        offerProcessor(_peerConnection, windowMock.RTCPeerConnection, windowMock.RTCSessionDescription, NativeRTCSessionDescription, sdpTransforms, offer, codecFlags, p2p, relayAnswer, reportError, onRemoteVideoSupported, replaceBaselineProfile, sourceStreamId);
+        offerProcessor(_peerConnection, windowMock.RTCPeerConnection, windowMock.RTCSessionDescription, NativeRTCSessionDescription, sdpTransforms, offer, codecFlags, p2p, (answer, modifiedOffer) => _candidatesReady.promise.then(() => relayAnswer(answer, modifiedOffer)), reportError, onRemoteVideoSupported, replaceBaselineProfile, sourceStreamId);
       });
     };
     const processAnswer = message => {
@@ -63221,7 +63314,7 @@ function PeerConnectionFactory(deps) {
         }).then(offer => {
           logging.debug('processSubscribe: got offer, waiting for ' + '_readyToCompleteOffer');
           _offer = offer;
-          _readyToCompleteOffer.promise.then(() => onOfferCreated(_offer));
+          _candidatesReady.promise.then(() => onOfferCreated(_offer));
           logAnalyticsEvent('peerConnection:processSubscribe', 'Success', {
             sdp: _offer.sdp
           });
@@ -106050,6 +106143,9 @@ function Stream(id, name, creationTime, connection, session, channel, initials,
       case 'videoDimensions':
         self.videoDimensions = newValue;
         break;
+      case 'frameRate':
+        self.frameRate = newValue;
+        break;
       case 'orientation':
       case 'width':
       case 'height':
@@ -106154,6 +106250,11 @@ function Stream(id, name, creationTime, connection, session, channel, initials,
       orientation: 0
     });
   };
+  this.setVideoFrameRate = function setVideoFrameRate(frameRate) {
+    updateChannelsOfType('video', {
+      frameRate
+    });
+  };
   this.setRestrictFrameRate = function setRestrictFrameRate(restrict, completion) {
     if (completion === void 0) {
       completion = () => {};