@opentok/client 2.36.0-alpha.15 → 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 895d7e807
+ * @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:30:07 GMT
+ * Date: Wed, 29 Jul 2026 11:28:57 GMT
  */
 
 (function webpackUniversalModuleDefinition(root, factory) {
@@ -27523,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);
     };
@@ -39866,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":"895d7e807","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);
   /**
@@ -41516,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 */
@@ -41717,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;
@@ -44175,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
@@ -45045,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;
@@ -45587,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.
@@ -45602,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');
     };
 
     /**
@@ -46415,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) {
@@ -46437,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;
                 }
@@ -46462,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) {
@@ -46497,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);
         }