@opentok/client 2.28.5 → 2.29.0-alpha.1

package/dist/js/opentok.js

@@ -1,11 +1,11 @@
 /**
- * @license OpenTok.js 2.28.5 383b0af
+ * @license OpenTok.js 2.29.0 dc9a1e9
  *
  * Copyright (c) 2010-2024 TokBox, Inc.
  * Subject to the applicable Software Development Kit (SDK) License Agreement:
  * https://www.vonage.com/legal/communications-apis/terms-of-use/
  *
- * Date: Fri, 29 Nov 2024 16:39:33 GMT
+ * Date: Fri, 06 Dec 2024 15:12:26 GMT
  */
 
 (function webpackUniversalModuleDefinition(root, factory) {
@@ -3738,32 +3738,45 @@ function EventsFactory(deps) {
   };
 
   /**
-   * The Session object dispatches a cpuPerformanceChanged event when the CPU performance state has been changed
-   * The event will only be dispatched on Chromium browsers (Chrome 125+, Edge 125+, and Opera 111+).
-   * Events will not be dispatched after disconnecting from a Session, but will resume after reconnecting.
-   * This is a <b>beta</b> feature.
+   * The Session object dispatches a <code>cpuPerformanceChanged</code> event
+   * when the CPU performance state changes.
+   * The event is only dispatched on Chromium browsers (Chrome 125+, Edge 125+, and Opera 111+).
+   * Events are not dispatched after disconnecting from a session, but they resume after reconnecting.
+   * This is a <i>beta</i> feature.
    *
-   * @property {cpuPerformanceState} cpuPerformanceState The new cpuPerformanceState. The cpuPerformanceState can
-   * be one the following: "nominal", "fair", "serious", or "critical";
+   * @property {String} cpuPerformanceState The new CPU performance state. The CPU performance state can
+   * be one the following: "nominal", "fair", "serious", or "critical".
+   * (See <a href="https://w3c.github.io/compute-pressure/#pressure-states">this W3C specification</a>.)
    *
+   * @see <a href="Session.html#event:cpuPerformanceChanged">Session cpuPerformanceChanged event</a>
+   * @class CpuPerformanceChangedEvent
+   * @augments Event
    */
-  Events.CpuPerformanceChanged = function CpuPerformanceChanged(cpuPerformanceState) {
+  Events.CpuPerformanceChangedEvent = function CpuPerformanceChangedEvent(cpuPerformanceState) {
     return new _Event4.default('cpuPerformanceChanged', false, {
       cpuPerformanceState
     });
   };
 
   /**
-   * The Subscriber object dispatches a qualityScoreChanged event when either the audio or video quality
-   * score has changed. The scores are a heuristic value representing the expected subscriber experience. The values
-   * range from 5 to 1, with the integer values corresponding to Excellent | Good | Fair | Poor | Bad.
-   * This is a <b>beta</b> feature.
+   * The Subscriber object dispatches a <code>qualityScoreChanged</code>
+   * event when either the audio or video quality score changes for the subscriber.
+   * The scores are a heuristic value representing the expected subscriber experience.
+   * The values are integers ranging from 1 to 5, with the values corresponding to
+   * bad, poor, fair, good, and excellent.
+   * This is a <i>beta</i> feature.
+   *
+   * @class QualityScoreChangedEvent
+   * @augments Event
+   * @see <a href="Subscriber.html#event:qualityScoreChanged">Subscriber qualityScoreChanged event</a>
    *
-   * @property {QualityScore} qualityScore most recent quality score. The event contains
-   * a qualityScore object with optional audio and video properties.
+   * @property {Object} qualityScore The current quality score for the subscriber.
+   * The event contains two properties: <code>audioQualityScore</code>
+   * and <code>videoQualityScore</code>. These properties are undefined if there
+   * is either no audio or no video.
    *
    */
-  Events.QualityScoreChanged = function qualityScoreChanged(qualityScore) {
+  Events.QualityScoreChangedEvent = function qualityScoreChanged(qualityScore) {
     return new _Event4.default('qualityScoreChanged', false, {
       qualityScore
     });
@@ -3798,7 +3811,7 @@ function EventsFactory(deps) {
   };
 
   /**
-   * This is a <b>beta</b> feature.
+   * This is a <i>beta</i> feature.
    * Defines an event object for the <code>mediaStreamAvailable</code> event dispatched by both
    * the Publisher and Subscriber objects. The Publisher and Subscriber objects both dispatch a <code>mediaStreamAvailable</code>
    * event when the MediaStream is available to be used in custom video elements. The Publisher and Subscriber objects should still be used to
@@ -3812,9 +3825,10 @@ function EventsFactory(deps) {
    *   event</a>
    * @see <a href="Subscriber.html#event:mediaStreamAvailable">Subscriber mediaStreamAvailable
    *   event</a>
+   * @class MediaStreamAvailableEvent
    * @augments Event
    */
-  Events.MediaStreamAvailable = function MediaStreamAvailable(mediaStream) {
+  Events.MediaStreamAvailableEvent = function MediaStreamAvailableEvent(mediaStream) {
     return new _Event4.default('mediaStreamAvailable', false, {
       mediaStream
     });
@@ -3954,16 +3968,18 @@ function EventsFactory(deps) {
   };
 
   /**
-   * Dispatched when the audio input device is changed. This is a <b>beta</b> feature.
+   * Dispatched when the audio input device is changed. This is a <i>beta</i> feature.
    *
-   * @property {Object} device The audio input device. Contains a deviceId and label.
+   * <p> For more information, see <a href="https://tokbox.com/developer/guides/audio-video/js/#audioInputDeviceChanged">this documentation</a>.
+   * @property {Object} device The audio input device.
+   * This object has a <code>deviceId</code> property and a <code>label</code> property (both strings).
    *
    * @see <a href="Publisher.html#event:audioInputDeviceChanged">Publisher audioInputDeviceChanged event</a></p>
    * @see <a href="Publisher.html#setAudioSource">Publisher.setAudioSource()</a></p>
-   * @class AudioInputDeviceChanged
+   * @class AudioInputDeviceChangedEvent
    * @augments Event
    */
-  Events.AudioInputDeviceChanged = function AudioInputDeviceChanged(device) {
+  Events.AudioInputDeviceChangedEvent = function AudioInputDeviceChangedEvent(device) {
     return new _Event4.default(_eventNames.default.AUDIO_INPUT_DEVICE_CHANGED, false, {
       device
     });
@@ -8107,7 +8123,7 @@ const logging = (0, _log.default)('StaticConfig');
 */
 
 /** @type builtInConfig */
-const builtInConfig = (0, _cloneDeep.default)({"version":"v2.28.5","buildHash":"383b0af","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"});
+const builtInConfig = (0, _cloneDeep.default)({"version":"v2.29.0","buildHash":"dc9a1e9","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"});
 const whitelistAllowedRuntimeProperties = (0, _pick.default)(['apiURL', 'assetURL', 'cdnURL', 'sessionInfoOverrides', 'loggingURL']);
 const liveConfigMap = {
   apiUrl: 'apiURL',
@@ -18690,7 +18706,7 @@ function PublisherFactory(_ref) {
           }
         });
         widgetView.on('videoElementCreated', element => {
-          this.dispatchEvent(new Events.MediaStreamAvailable(webRTCStream));
+          this.dispatchEvent(new Events.MediaStreamAvailableEvent(webRTCStream));
           const event = new Events.VideoElementCreatedEvent(element);
           this.dispatchEvent(event);
         });
@@ -22490,7 +22506,7 @@ function PublisherFactory(_ref) {
   */
 
   /**
-  * This is a <b>beta</b> feature.
+  * This is a <i>beta</i> feature.
   * Dispatched when the MediaStream is available.
   * @see Event
   * @name mediaStreamAvailable
@@ -22514,7 +22530,7 @@ function PublisherFactory(_ref) {
    * This is a beta feature.
    *
    * @see Event
-   * @see AudioInputDeviceChanged
+   * @see AudioInputDeviceChangedEvent
    * @name audioInputDeviceChanged
    * @event
    * @memberof Publisher
@@ -34640,7 +34656,7 @@ function SubscriberFactory(_ref2) {
               _session2 = _session, sessionInfo = _session2.sessionInfo;
               if (!_exposedWebRTCStream) {
                 _exposedWebRTCStream = new MediaStream(webRTCStream);
-                _this.dispatchEvent(new Events.MediaStreamAvailable(_exposedWebRTCStream));
+                _this.dispatchEvent(new Events.MediaStreamAvailableEvent(_exposedWebRTCStream));
               }
               _webRTCStream = webRTCStream;
 
@@ -37419,7 +37435,7 @@ function SubscriberFactory(_ref2) {
     */
 
     /**
-    * This is a <b>beta</b> feature.
+    * This is a <i>beta</i> feature.
     * Dispatched when the MediaStream is available.
     * @see Event
     * @name mediaStreamAvailable
@@ -37571,11 +37587,11 @@ function SubscriberFactory(_ref2) {
     * Dispatched when either the audio or video quality
     * score has changed. The scores are a heuristic value representing the expected subscriber experience. The values
     * range from 5 to 1, with the integer values corresponding to Excellent | Good | Fair | Poor | Bad.
-    * This is a <b>beta</b> feature.
+    * This is a <i>beta</i> feature.
      * @name qualityScoreChanged
     * @event
     * @memberof Subscriber
-    * @see qualityScoreChangedEvent
+    * @see QualityScoreChangedEvent
     */
     return this;
   };
@@ -64422,7 +64438,7 @@ function SessionFactory(deps) {
       cpuPressureMonitor.initMonitoring(PressureObserver);
       cpuPressureMonitor.startMonitoring();
       cpuPressureMonitor.on('pressureMonitorEvent', newState => {
-        this.dispatchEvent(new Events.CpuPerformanceChanged(newState));
+        this.dispatchEvent(new Events.CpuPerformanceChangedEvent(newState));
       });
     }
 
@@ -67263,6 +67279,17 @@ function SessionFactory(deps) {
    * of streams in a session</a>
    */
 
+  /**
+   * The CPU performance state has changed. This can be set to
+   * one the following: "nominal", "fair", "serious", or "critical".
+   * This is a <i>beta</i> feature.
+   *
+   * @name cpuPerformanceChanged
+   * @event
+   * @memberof Session
+   * @see CpuPerformanceChangedEvent
+   */
+
   /**
    * The client has connected to a Vonage Video API session. This event is dispatched asynchronously
    * in response to a successful call to the <code>connect()</code> method of a Session
@@ -67280,7 +67307,7 @@ function SessionFactory(deps) {
   /**
    * The client has disconnected from the session. This event may be dispatched asynchronously
    * in response to a successful call to the <code>disconnect()</code> method of the Session object.
-   * The event may also be dispatched if a session connection is lost inadvertantly, as in the case
+   * The event may also be dispatched if a session connection is lost inadvertently, as in the case
    * of a lost network connection.
    * <p>
    * The default behavior is that all Subscriber objects are unsubscribed and removed from the
@@ -67429,7 +67456,7 @@ function SessionFactory(deps) {
    *   console.log("Signal data: " + event.data);
    * });
    * </pre>
-   * <p>You can register for signals of a specfied type by adding an event handler for the
+   * <p>You can register for signals of a specified type by adding an event handler for the
    * <code>signal:type</code> event (replacing <code>type</code> with the actual type string
    * to filter on).
    *
@@ -67453,7 +67480,7 @@ function SessionFactory(deps) {
    *   </li>
    * </ul>
    * <p>
-   * You can register for signals of a specfied type by adding an event handler for the
+   * You can register for signals of a specified type by adding an event handler for the
    * <code>signal:type</code> event (replacing <code>type</code> with the actual type string
    * to filter on). For example, the following code adds an event handler for signals of
    * type "foo":
@@ -69714,12 +69741,13 @@ OT.ArchiveEvent = Events.ArchiveEvent;
 OT.ArchiveUpdatedEvent = Events.ArchiveUpdatedEvent;
 OT.AudioLevelTransformer = _audio_level_transformer.default;
 OT.AudioLevelUpdatedEvent = Events.AudioLevelUpdatedEvent;
-OT.AudioInputDeviceChanged = Events.AudioInputDeviceChanged;
+OT.AudioInputDeviceChangedEvent = Events.AudioInputDeviceChangedEvent;
 OT.Capabilities = _capabilities.default;
 OT.Chrome = _chrome.default;
 OT.Connection = _connection.default;
 OT.ConnectionCapabilities = OT.Connection.Capabilities;
 OT.ConnectionEvent = Events.ConnectionEvent;
+OT.CpuPerformanceChangedEvent = Events.CpuPerformanceChangedEvent;
 Object.keys(_logLevels.default).forEach(name => {
   OT[name.toUpperCase()] = _logLevels.default[name].priority;
 });
@@ -69757,6 +69785,7 @@ OT.HAS_REQUIREMENTS = 1;
 OT.IntervalRunner = _interval_runner.default;
 OT.IssueReportedEvent = Events.IssueReportedEvent;
 OT.MediaStoppedEvent = Events.MediaStoppedEvent;
+OT.MediaStreamAvailableEvent = Events.MediaStreamAvailableEvent;
 OT.Microphone = Microphone;
 OT.NOT_HAS_REQUIREMENTS = 0;
 OT.PeerConnection = PeerConnection;
@@ -95416,7 +95445,7 @@ const createMOSScoreHelper = () => ({
               if (previousVideoScore !== currentVideoScore || previousAudioScore !== currentAudioScore) {
                 // Don't emit an empty object
                 if (Object.keys(qualityScore).length > 0) {
-                  subscriber.dispatchEvent(new Events.QualityScoreChanged(qualityScore));
+                  subscriber.dispatchEvent(new Events.QualityScoreChangedEvent(qualityScore));
                 }
               }
               previousAudioScore = currentAudioScore;
@@ -97805,7 +97834,7 @@ var _default = function _default(deps) {
               _context.next = 9;
               return publisher.setAudioSource(device.deviceId);
             case 9:
-              publisher.dispatchEvent(Events.AudioInputDeviceChanged(device));
+              publisher.dispatchEvent(Events.AudioInputDeviceChangedEvent(device));
             case 10:
             case "end":
               return _context.stop();