@opentok/client 2.33.0-alpha.12 → 2.33.0-alpha.13

package/dist/js/opentok.js

@@ -1,11 +1,11 @@
 /**
- * @license OpenTok.js 2.33.0 df40cebc8
+ * @license OpenTok.js 2.33.0 3921385fd
  *
  * Copyright (c) 2010-2025 TokBox, Inc.
  * Subject to the applicable Software Development Kit (SDK) License Agreement:
  * https://www.vonage.com/legal/communications-apis/terms-of-use/
  *
- * Date: Fri, 28 Nov 2025 08:06:01 GMT
+ * Date: Fri, 28 Nov 2025 13:46:00 GMT
  */
 
 (function webpackUniversalModuleDefinition(root, factory) {
@@ -8570,7 +8570,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.33.0","buildHash":"df40cebc8","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.33.0","buildHash":"3921385fd","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);
   /**
@@ -41921,10 +41921,26 @@ function SubscriberFactory(_ref2) {
     *   <li><code>"publishVideo"</code> &mdash; The publisher stopped publishing video by calling
     *   <code>publishVideo(false)</code>.</li>
     *
-    *   <li><code>"quality"</code> &mdash; The Vonage Video API Media Router stopped sending video
-    *   to the subscriber based on stream quality changes. This feature of the Vonage Video API Media
-    *   Router has a subscriber drop the video stream when connectivity degrades. (The subscriber
-    *   continues to receive the audio stream, if there is one.)
+    *   <li><code>"quality"</code> &mdash; The Vonage Video API Media Router or the publishing client
+    *   stopped sending video to the subscriber based on stream quality changes due to connectivity
+    *   degradation.
+    *   <p>
+    *   In routed sessions, the source of this event can be the Vonage Video API Media Router
+    *   (Subscriber Audio Fallback) or the publishing client (Publisher Audio Fallback). In both
+    *   cases, the video stream is dropped specifically for the affected subscriber, while the audio
+    *   stream (if present) continues uninterrupted. When the source is the publishing client, the
+    *   event is followed by a <code>streamPropertyChanged</code> event dispatched by the session
+    *   object, indicating that the subscribed video channel is no longer active. In general, this
+    *   additional event indicates network degradation on the publisher’s side; however,
+    *   subscriber-reported metrics can influence the publisher’s fallback decisions, which may
+    *   complicate determining the exact source of the degradation.
+    *   <p>
+    *   In relayed sessions, the <code>"quality"</code> event is triggered exclusively due to the
+    *   publisher’s internal audio-fallback logic (Publisher Audio Fallback). This event is not
+    *   followed by a <code>streamPropertyChanged</code> event indicating that the video is inactive,
+    *   as the stream may still be received by other subscribers with better network conditions.
+    *   Note that in relayed sessions, although audio fallback events originate from the publisher,
+    *   network degradation may be occuring on either the publisher or subscriber side.
     *   <p>
     *   Before sending this event, when the Subscriber's stream quality deteriorates to a level
     *   that is low enough that the video stream is at risk of being disabled, the Subscriber
@@ -41941,17 +41957,14 @@ function SubscriberFactory(_ref2) {
     *   calling the <code>Session.subscribe()</code> method, setting the <code>style</code> property
     *   of the <code>properties</code> parameter).
     *   <p>
-    *   This feature is only available in sessions that use the Vonage Video API Media Router (sessions with
-    *   the <a href="https://tokbox.com/developer/guides/create-session/#media-mode">media mode</a>
-    *   set to routed), not in sessions with the media mode set to relayed.
-    *   <p>
-    *   You can disable this audio-only fallback feature by setting the
-    *   <code>audioFallback.subscriber</code> property to <code>false</code>
-    *   in the options you pass to the <code>OT.initPublisher()</code>
-    *   method on the publishing client. (See
-    *   <a href="OT.html#initPublisher">OT.initPublisher()</a>.)
+    *   You can control audio-only fallback behavior by setting the <code>audioFallback</code>
+    *   property in the object passed to <code>OT.initPublisher()</code> on the publishing
+    *   client. By default, subscriber audio fallback is enabled (except when using screen share,
+    *   where it is disabled by default) and publisher audio fallback is disabled. To change this,
+    *   set <code>audioFallback.subscriber</code> to <code>false</code> to disable subscriber fallback,
+    *   or set <code>audioFallback.publisher</code> to <code>true</code> to enable publisher fallback.
+    *   (See <a href="OT.html#initPublisher">OT.initPublisher()</a>.)
     *   </li>
-    *
     *   <li><code>"subscribeToVideo"</code> &mdash; The subscriber started or stopped subscribing to
     *   video, by calling <code>subscribeToVideo(false)</code>.
     *   </li>