@opentok/client 2.36.0-alpha.14 → 2.36.0-alpha.16

package/dist/js/opentok.d.ts

@@ -488,6 +488,8 @@ declare namespace OT {
       promise: (value: boolean) => Promise<void>;
     }
     publishCaptions(value: boolean): Promise<void>;
+    setCaptionsInputLanguage(langCode: CaptionsLanguageCode | null): Promise<void>;
+    getCaptionsInputLanguage(): CaptionsLanguageCode | null;
     cycleVideo(): Promise<{ deviceId: string }>;
     setAudioSource(audioSource:string | MediaStreamTrack): Promise<undefined>;
     getAudioSource(): MediaStreamTrack;

package/dist/js/opentok.js

@@ -1,11 +1,11 @@
 /**
- * @license OpenTok.js 2.36.0 4ced01c04
+ * @license OpenTok.js 2.36.0 80ef11d29
  *
  * 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, 29 Jul 2026 10:18:19 GMT
+ * Date: Wed, 29 Jul 2026 11:28:57 GMT
  */
 
 (function webpackUniversalModuleDefinition(root, factory) {
@@ -9863,29 +9863,17 @@ var _interopRequireDefault = __webpack_require__(95709);
 exports.__esModule = true;
 exports["default"] = void 0;
 var _getProtocolFromPriority = _interopRequireDefault(__webpack_require__(85045));
-var _default = (selectedCandidatePairId, stats) => {
-  let localRelayProtocol = '';
-  if (!selectedCandidatePairId || !stats) {
-    return localRelayProtocol;
-  }
-  const activeCandidatePair = stats.get(selectedCandidatePairId);
-  if (activeCandidatePair) {
-    const localCandidateId = activeCandidatePair.localCandidateId;
-    if (localCandidateId) {
-      const localCandidate = stats.get(localCandidateId);
-      if (localCandidate) {
-        const relayProtocol = localCandidate.relayProtocol,
-          priority = localCandidate.priority;
-        if (relayProtocol) {
-          const RELAY_PROTOCOL = relayProtocol.toUpperCase();
-          localRelayProtocol = `TURN/${RELAY_PROTOCOL}`;
-        } else {
-          localRelayProtocol = (0, _getProtocolFromPriority.default)(priority);
-        }
-      }
+var _default = localCandidate => {
+  if (localCandidate) {
+    const relayProtocol = localCandidate.relayProtocol,
+      priority = localCandidate.priority;
+    if (relayProtocol) {
+      const RELAY_PROTOCOL = relayProtocol.toUpperCase();
+      return `TURN/${RELAY_PROTOCOL}`;
     }
+    return (0, _getProtocolFromPriority.default)(priority);
   }
-  return localRelayProtocol;
+  return '';
 };
 exports["default"] = _default;
 
@@ -14472,6 +14460,40 @@ const getAddress = res => {
   const ip = res.ipAddress || res.address || res.ip;
   return `${ip}:${port}`;
 };
+const getCandidatesInfo = (activeCandidatePair, stats) => {
+  let localRelayProtocol;
+  let localCandidateType;
+  let localAddress;
+  let transportType;
+  let remoteCandidateType;
+  let remoteAddress;
+  const localCandidateId = activeCandidatePair.localCandidateId,
+    remoteCandidateId = activeCandidatePair.remoteCandidateId;
+  if (localCandidateId) {
+    const localCandidate = stats.get(localCandidateId);
+    if (localCandidate) {
+      localRelayProtocol = (0, _getLocalRelayProtocol.default)(localCandidate);
+      localCandidateType = localCandidate.candidateType;
+      localAddress = getAddress(localCandidate);
+      transportType = localCandidate.protocol || localCandidate.transport;
+    }
+  }
+  if (remoteCandidateId) {
+    const remoteCandidate = stats.get(remoteCandidateId);
+    if (remoteCandidate) {
+      remoteCandidateType = remoteCandidate.candidateType;
+      remoteAddress = getAddress(remoteCandidate);
+    }
+  }
+  return {
+    localRelayProtocol,
+    localCandidateType,
+    localAddress,
+    transportType,
+    remoteCandidateType,
+    remoteAddress
+  };
+};
 
 // Get Stats using the older API. Used by Chrome up until v58.
 function parseStatsOldAPI(statsCache, prevStats, currentStats, isPublisher, completion) {
@@ -14791,15 +14813,27 @@ function parseStatsNewAPI(statsCache, prevStats, currentStats, isPublisher, comp
           srtpCipher = res.srtpCipher;
         currentStats.srtpCipher = srtpCipher;
         if (selectedCandidatePairId) {
-          localRelayProtocol = (0, _getLocalRelayProtocol.default)(selectedCandidatePairId, stats);
+          const activeCandidatePair = stats.get(selectedCandidatePairId);
+          if (activeCandidatePair) {
+            var _getCandidatesInfo = getCandidatesInfo(activeCandidatePair, stats);
+            localRelayProtocol = _getCandidatesInfo.localRelayProtocol;
+            localCandidateType = _getCandidatesInfo.localCandidateType;
+            localAddress = _getCandidatesInfo.localAddress;
+            transportType = _getCandidatesInfo.transportType;
+            remoteCandidateType = _getCandidatesInfo.remoteCandidateType;
+            remoteAddress = _getCandidatesInfo.remoteAddress;
+          }
         }
       } else if (strippedType === 'localcandidate') {
-        localCandidateType = res.candidateType;
-        localAddress = getAddress(res);
-        transportType = res.protocol || res.transport;
+        var _localRelayProtocol, _localCandidateType, _localAddress, _transportType;
+        (_localRelayProtocol = localRelayProtocol) != null ? _localRelayProtocol : localRelayProtocol = (0, _getLocalRelayProtocol.default)(res);
+        (_localCandidateType = localCandidateType) != null ? _localCandidateType : localCandidateType = res.candidateType;
+        (_localAddress = localAddress) != null ? _localAddress : localAddress = getAddress(res);
+        (_transportType = transportType) != null ? _transportType : transportType = res.protocol || res.transport;
       } else if (strippedType === 'remotecandidate') {
-        remoteCandidateType = res.candidateType;
-        remoteAddress = getAddress(res);
+        var _remoteCandidateType, _remoteAddress;
+        (_remoteCandidateType = remoteCandidateType) != null ? _remoteCandidateType : remoteCandidateType = res.candidateType;
+        (_remoteAddress = remoteAddress) != null ? _remoteAddress : remoteAddress = getAddress(res);
       } else if (strippedType === 'track' && lowercaseId.indexOf('video') !== 0) {
         frameWidth = res.frameWidth;
         frameHeight = res.frameHeight;
@@ -14819,6 +14853,15 @@ function parseStatsNewAPI(statsCache, prevStats, currentStats, isPublisher, comp
           const estimatedStat = `video${isPublisher ? 'Sent' : 'Recv'}EstimatedBandwidth`;
           currentStats[estimatedStat] = parseInt(res.availableOutgoingBitrate, 10);
         }
+        if (res.selected) {
+          var _getCandidatesInfo2 = getCandidatesInfo(res, stats);
+          localRelayProtocol = _getCandidatesInfo2.localRelayProtocol;
+          localCandidateType = _getCandidatesInfo2.localCandidateType;
+          localAddress = _getCandidatesInfo2.localAddress;
+          transportType = _getCandidatesInfo2.transportType;
+          remoteCandidateType = _getCandidatesInfo2.remoteCandidateType;
+          remoteAddress = _getCandidatesInfo2.remoteAddress;
+        }
       }
     };
 
@@ -27480,6 +27523,12 @@ function RaptorSocketFactory(deps) {
       }
       this.publish(RaptorMessage.streamChannels.update(_apiKey, _sessionId, streamId, channelId, attributes), {}, true, completion);
     };
+    this.publisherChannelUpdate = function (streamId, channelId, attributes, completion) {
+      if (completion === void 0) {
+        completion = () => {};
+      }
+      this.publish(RaptorMessage.streamChannels.update(_apiKey, _sessionId, streamId, channelId, attributes), {}, true, completion);
+    };
     this.streamChannelSendData = function (streamId, channelId, data, completion) {
       this.publish(RaptorMessage.streamChannels.data(_apiKey, _sessionId, streamId, channelId, data), {}, true, completion);
     };
@@ -39823,7 +39872,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.36.0","buildHash":"4ced01c04","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.36.0","buildHash":"80ef11d29","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);
   /**
@@ -41473,6 +41522,7 @@ var _getSpatialResolution = _interopRequireDefault(__webpack_require__(39841));
 var _VideoBitratePreset = _interopRequireDefault(__webpack_require__(51831));
 var _videoConstraints = _interopRequireDefault(__webpack_require__(49474));
 var _networkConditionConstants = __webpack_require__(46179);
+var _languageCodes = __webpack_require__(38891);
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 /* eslint-disable global-require, func-names, max-len */
@@ -41674,6 +41724,9 @@ function PublisherFactory(_ref) {
     let networkCondition = _networkConditionConstants.NETWORK_CONDITION.GOOD;
     let getStatsCalled = false;
     let filteredVideoTrackId;
+    let _captionsInputLanguage = null;
+    let _pendingSetCaptionsInputLanguageArgs;
+    let _setCaptionsInputLanguageInFlight = false;
 
     /** @type IntervalRunnerDefault | undefined */
     let connectivityAttemptPinger;
@@ -44132,6 +44185,102 @@ function PublisherFactory(_ref) {
         streamReadyJobs.add(() => finishPublishCaptions(value, resolve, reject));
       }
     });
+    const sendCaptionsInputLanguageUpdate = () => {
+      var _this$session22, _this$stream;
+      _setCaptionsInputLanguageInFlight = true;
+      const _pendingSetCaptionsIn = _pendingSetCaptionsInputLanguageArgs,
+        langCode = _pendingSetCaptionsIn.langCode,
+        resolve = _pendingSetCaptionsIn.resolve,
+        reject = _pendingSetCaptionsIn.reject;
+      _pendingSetCaptionsInputLanguageArgs = null;
+      const attributes = {
+        category: langCode === null ? '' : langCode
+      };
+      const socket = (_this$session22 = this.session) == null ? void 0 : _this$session22._.getSocket();
+      const streamId = ((_this$stream = this.stream) == null ? void 0 : _this$stream.id) || this.streamId;
+      socket.publisherChannelUpdate(streamId, 'caption1', attributes, err => {
+        _setCaptionsInputLanguageInFlight = false;
+        if (err) {
+          reject(err);
+        } else {
+          _captionsInputLanguage = langCode;
+          logAnalyticsEvent('setCaptionsInputLanguage', 'Event', {
+            captionsInputLanguage: langCode
+          });
+          resolve();
+        }
+        // If there's a pending call queued while we were in-flight, process it now
+        if (_pendingSetCaptionsInputLanguageArgs) {
+          if (_pendingSetCaptionsInputLanguageArgs.langCode === _captionsInputLanguage) {
+            // Same language as what just succeeded, resolve without another network call
+            _pendingSetCaptionsInputLanguageArgs.resolve();
+            _pendingSetCaptionsInputLanguageArgs = null;
+          } else {
+            sendCaptionsInputLanguageUpdate();
+          }
+        }
+      });
+    };
+
+    /**
+    * Sets the language used for captions input on the publisher. The language code
+    * is sent to the captions service to indicate the spoken language of the audio.
+    * Pass <code>null</code> to clear the captions input language.
+    *
+    * <p>
+    * If the publisher is not yet publishing to a session, the language will be applied
+    * once publishing begins.
+    *
+    * @param {String|null} langCode A BCP-47 language code (for example, <code>"en-US"</code>,
+    * <code>"es"</code>), or <code>null</code> to clear the captions input language.
+    *
+    * @see <a href="#getCaptionsInputLanguage">Publisher.getCaptionsInputLanguage()</a>
+    * @see <a href="#publishCaptions">Publisher.publishCaptions()</a>
+    * @returns {Promise<void>} A promise that resolves when the language has been set,
+    * or rejects with an error if the language code is invalid or the operation fails.
+    * @method #setCaptionsInputLanguage
+    * @memberOf Publisher
+    */
+    this.setCaptionsInputLanguage = langCode => new Promise((resolve, reject) => {
+      if (langCode !== null && !(0, _languageCodes.validateLanguageCode)(langCode)) {
+        const message = `Invalid captions input language ${langCode}`;
+        logging.warn(`setCaptionsInputLanguage: ${message}`);
+        reject(otError(Errors.INVALID_PARAMETER, new Error(`setCaptionsInputLanguage: ${message}`)));
+        return;
+      }
+      if (_pendingSetCaptionsInputLanguageArgs) {
+        streamReadyJobs.remove(sendCaptionsInputLanguageUpdate);
+        _pendingSetCaptionsInputLanguageArgs.reject(new Error('setCaptionsInputLanguage: call superseded by a newer setCaptionsInputLanguage call'));
+        _pendingSetCaptionsInputLanguageArgs = undefined;
+      }
+      if (langCode === _captionsInputLanguage && !_setCaptionsInputLanguageInFlight) {
+        resolve();
+        return;
+      }
+      _pendingSetCaptionsInputLanguageArgs = {
+        langCode,
+        resolve,
+        reject
+      };
+      if (this.stream) {
+        if (!_setCaptionsInputLanguageInFlight) {
+          sendCaptionsInputLanguageUpdate();
+        }
+      } else {
+        streamReadyJobs.add(sendCaptionsInputLanguageUpdate);
+      }
+    });
+
+    /**
+    * Returns the current captions input language set for the publisher.
+    *
+    * @return {String|null} The BCP-47 language code (for example, <code>"en-US"</code>)
+    * currently set for captions input, or <code>null</code> if no language has been set.
+    * @see <a href="#setCaptionsInputLanguage">Publisher.setCaptionsInputLanguage()</a>
+    * @method #getCaptionsInputLanguage
+    * @memberOf Publisher
+    */
+    this.getCaptionsInputLanguage = () => _captionsInputLanguage;
     let updateVideoSenderParametersSentinel;
 
     // keeps track of if the client has called mediaStreamTrack.stop(), so that we don't restart
@@ -45002,8 +45151,8 @@ function PublisherFactory(_ref) {
           break;
         default:
           if (!futurePeerConnection) {
-            var _this$session22, _this$session22$sessi;
-            if (!state.isMigrating() && (_this$session22 = this.session) != null && (_this$session22$sessi = _this$session22.sessionInfo) != null && _this$session22$sessi.isAdaptiveEnabled && getP2pPeerConnection()) {
+            var _this$session23, _this$session23$sessi;
+            if (!state.isMigrating() && (_this$session23 = this.session) != null && (_this$session23$sessi = _this$session23.sessionInfo) != null && _this$session23$sessi.isAdaptiveEnabled && getP2pPeerConnection()) {
               // In the case Rumor sends two generateOffers for the P2P leg,
               // we need to ignore the second one.
               return;
@@ -45544,7 +45693,7 @@ function PublisherFactory(_ref) {
       document.addEventListener('visibilitychange', visibilityHandler);
     };
     const handleBuggedUnMutedLocalAudioTrack = audioTrack => {
-      var _this$session23;
+      var _this$session24;
       if (hasAudio()) {
         if (!hasVideo()) {
           // We only need to reset the audio source when the publisher is audio only.
@@ -45559,7 +45708,7 @@ function PublisherFactory(_ref) {
           this.videoElement().pause();
         }
       }
-      this == null ? void 0 : (_this$session23 = this.session) == null ? void 0 : _this$session23.trigger('gsmCallEnded');
+      this == null ? void 0 : (_this$session24 = this.session) == null ? void 0 : _this$session24.trigger('gsmCallEnded');
     };
 
     /**
@@ -46372,7 +46521,7 @@ function PublisherFactory(_ref) {
       },
       startMigration: function () {
         var _startMigration = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee49() {
-          var _publisherSenderStats6, _this$session24, _this$session24$sessi;
+          var _publisherSenderStats6, _this$session25, _this$session25$sessi;
           var relayedPeerConnection, onCreateStreamError;
           return _regenerator.default.wrap(function _callee49$(_context49) {
             while (1) switch (_context49.prev = _context49.next) {
@@ -46394,7 +46543,7 @@ function PublisherFactory(_ref) {
                     throw new Error(error);
                   }
                 };
-                if (!((_this$session24 = _this.session) != null && (_this$session24$sessi = _this$session24.sessionInfo) != null && _this$session24$sessi.p2pEnabled)) {
+                if (!((_this$session25 = _this.session) != null && (_this$session25$sessi = _this$session25.sessionInfo) != null && _this$session25$sessi.p2pEnabled)) {
                   _context49.next = 13;
                   break;
                 }
@@ -46419,7 +46568,7 @@ function PublisherFactory(_ref) {
         return startMigration;
       }(),
       finishMigration: () => {
-        var _this$session25, _this$session25$sessi;
+        var _this$session26, _this$session26$sessi;
         clearTimeout(_migrationTimeoutId);
         const destroyPeerConnection = /*#__PURE__*/function () {
           var _ref61 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee50(pc) {
@@ -46454,7 +46603,7 @@ function PublisherFactory(_ref) {
         _previousPeerConnection = null;
 
         // In case we don't transition to P2P after migration, clear P2P leg.
-        if ((_this$session25 = this.session) != null && (_this$session25$sessi = _this$session25.sessionInfo) != null && _this$session25$sessi.isAdaptiveEnabled && activeSourceStreamId === 'MANTIS') {
+        if ((_this$session26 = this.session) != null && (_this$session26$sessi = _this$session26.sessionInfo) != null && _this$session26$sessi.isAdaptiveEnabled && activeSourceStreamId === 'MANTIS') {
           var _getP2pPeerConnection;
           (_getP2pPeerConnection = getP2pPeerConnection()) == null ? void 0 : _getP2pPeerConnection.then(destroyPeerConnection);
         }
@@ -94782,6 +94931,7 @@ module.exports = isString;
 exports.__esModule = true;
 exports["default"] = void 0;
 var _default = priority => {
+  if (typeof priority !== 'number') return '';
   switch (priority >> 24) {
     // eslint-disable-line no-bitwise
     case 0: