livekit-client 1.6.9 → 1.7.1

package/dist/livekit-client.esm.mjs

@@ -12916,6 +12916,13 @@ var RoomEvent;
    * args: ([[LocalTrackPublication]], [[LocalParticipant]])
    */
   RoomEvent["LocalTrackUnpublished"] = "localTrackUnpublished";
+  /**
+   * When a local audio track is published the SDK checks whether there is complete silence
+   * on that track and emits the LocalAudioSilenceDetected event in that case.
+   * This allows for applications to show UI informing users that they might have to
+   * reset their audio hardware or check for proper device connectivity.
+   */
+  RoomEvent["LocalAudioSilenceDetected"] = "localAudioSilenceDetected";
   /**
    * Active speakers changed. List of speakers are ordered by their audio level.
    * loudest speakers first. This will include the LocalParticipant too.
@@ -13940,7 +13947,7 @@ var uaParser = {
 })(uaParser, uaParserExports);
 var UAParser = uaParserExports;
 
-var version$1 = "1.6.9";
+var version$1 = "1.7.1";
 
 const version = version$1;
 const protocolVersion = 9;
@@ -14026,8 +14033,9 @@ async function detectSilence(track) {
  * @internal
  */
 function getNewAudioContext() {
+  const AudioContext =
   // @ts-ignore
-  const AudioContext = window.AudioContext || window.webkitAudioContext;
+  typeof window !== 'undefined' && (window.AudioContext || window.webkitAudioContext);
   if (AudioContext) {
     return new AudioContext({
       latencyHint: 'interactive'
@@ -15569,6 +15577,7 @@ class LocalAudioTrack extends LocalTrack {
       }
       this.emit(TrackEvent.AudioSilenceDetected);
     }
+    return trackIsSilent;
   }
 }
 
@@ -16401,7 +16410,8 @@ class RemoteVideoTrack extends RemoteTrack {
     const lastVisibilityChange = this.elementInfos.reduce((prev, info) => Math.max(prev, info.visibilityChangedAt || 0), 0);
     const backgroundPause = ((_b = (_a = this.adaptiveStreamSettings) === null || _a === void 0 ? void 0 : _a.pauseVideoInBackground) !== null && _b !== void 0 ? _b : true // default to true
     ) ? this.isInBackground : false;
-    const isVisible = this.elementInfos.some(info => info.visible) && !backgroundPause;
+    const isPiPMode = this.elementInfos.some(info => info.pictureInPicture);
+    const isVisible = this.elementInfos.some(info => info.visible) && !backgroundPause || isPiPMode;
     if (this.lastVisible === isVisible) {
       return;
     }
@@ -16440,6 +16450,12 @@ class RemoteVideoTrack extends RemoteTrack {
   }
 }
 class HTMLElementInfo {
+  get visible() {
+    return this.isPiP || this.isIntersecting;
+  }
+  get pictureInPicture() {
+    return this.isPiP;
+  }
   constructor(element, visible) {
     this.onVisibilityChanged = entry => {
       var _a;
@@ -16448,13 +16464,24 @@ class HTMLElementInfo {
         isIntersecting
       } = entry;
       if (target === this.element) {
-        this.visible = isIntersecting;
+        this.isIntersecting = isIntersecting;
         this.visibilityChangedAt = Date.now();
         (_a = this.handleVisibilityChanged) === null || _a === void 0 ? void 0 : _a.call(this);
       }
     };
+    this.onEnterPiP = () => {
+      var _a;
+      this.isPiP = true;
+      (_a = this.handleVisibilityChanged) === null || _a === void 0 ? void 0 : _a.call(this);
+    };
+    this.onLeavePiP = () => {
+      var _a;
+      this.isPiP = false;
+      (_a = this.handleVisibilityChanged) === null || _a === void 0 ? void 0 : _a.call(this);
+    };
     this.element = element;
-    this.visible = visible !== null && visible !== void 0 ? visible : isElementInViewport(element);
+    this.isIntersecting = visible !== null && visible !== void 0 ? visible : isElementInViewport(element);
+    this.isPiP = isWeb() && document.pictureInPictureElement === element;
     this.visibilityChangedAt = 0;
   }
   width() {
@@ -16464,6 +16491,9 @@ class HTMLElementInfo {
     return this.element.clientHeight;
   }
   observe() {
+    // make sure we update the current visible state once we start to observe
+    this.isIntersecting = isElementInViewport(this.element);
+    this.isPiP = document.pictureInPictureElement === this.element;
     this.element.handleResize = () => {
       var _a;
       (_a = this.handleResize) === null || _a === void 0 ? void 0 : _a.call(this);
@@ -16471,11 +16501,15 @@ class HTMLElementInfo {
     this.element.handleVisibilityChanged = this.onVisibilityChanged;
     getIntersectionObserver().observe(this.element);
     getResizeObserver().observe(this.element);
+    this.element.addEventListener('enterpictureinpicture', this.onEnterPiP);
+    this.element.addEventListener('leavepictureinpicture', this.onLeavePiP);
   }
   stopObserving() {
     var _a, _b;
     (_a = getIntersectionObserver()) === null || _a === void 0 ? void 0 : _a.unobserve(this.element);
     (_b = getResizeObserver()) === null || _b === void 0 ? void 0 : _b.unobserve(this.element);
+    this.element.removeEventListener('enterpictureinpicture', this.onEnterPiP);
+    this.element.removeEventListener('leavepictureinpicture', this.onLeavePiP);
   }
 }
 // does not account for occlusion by other elements
@@ -16778,9 +16812,6 @@ class Participant extends eventsExports.EventEmitter {
    * @returns
    */
   getTrack(source) {
-    if (source === Track.Source.Unknown) {
-      return;
-    }
     for (const [, pub] of this.tracks) {
       if (pub.source === source) {
         return pub;
@@ -17343,10 +17374,14 @@ class RemoteTrackPublication extends TrackPublication {
   }
   /** @internal */
   updateInfo(info) {
-    var _a;
     super.updateInfo(info);
+    const prevMetadataMuted = this.metadataMuted;
     this.metadataMuted = info.muted;
-    (_a = this.track) === null || _a === void 0 ? void 0 : _a.setMuted(info.muted);
+    if (this.track) {
+      this.track.setMuted(info.muted);
+    } else if (prevMetadataMuted !== info.muted) {
+      this.emit(info.muted ? TrackEvent.Muted : TrackEvent.Unmuted);
+    }
   }
   emitSubscriptionUpdateIfChanged(previousStatus) {
     const currentStatus = this.subscriptionStatus;
@@ -19113,6 +19148,7 @@ const roomOptionDefaults = {
   dynacast: false,
   stopLocalTrackOnUnpublish: true,
   reconnectPolicy: new DefaultReconnectPolicy(),
+  disconnectOnPageLeave: true,
   expWebAudioMix: false
 };
 const roomConnectOptionDefaults = {
@@ -20105,22 +20141,28 @@ class RTCEngine extends eventsExports.EventEmitter {
     };
     this.handleDataMessage = async message => {
       var _a, _b;
-      // decode
-      let buffer;
-      if (message.data instanceof ArrayBuffer) {
-        buffer = message.data;
-      } else if (message.data instanceof Blob) {
-        buffer = await message.data.arrayBuffer();
-      } else {
-        livekitLogger.error('unsupported data type', message.data);
-        return;
-      }
-      const dp = DataPacket.decode(new Uint8Array(buffer));
-      if (((_a = dp.value) === null || _a === void 0 ? void 0 : _a.$case) === 'speaker') {
-        // dispatch speaker updates
-        this.emit(EngineEvent.ActiveSpeakersUpdate, dp.value.speaker.speakers);
-      } else if (((_b = dp.value) === null || _b === void 0 ? void 0 : _b.$case) === 'user') {
-        this.emit(EngineEvent.DataPacketReceived, dp.value.user, dp.kind);
+      // make sure to respect incoming data message order by processing message events one after the other
+      const unlock = await this.dataProcessLock.lock();
+      try {
+        // decode
+        let buffer;
+        if (message.data instanceof ArrayBuffer) {
+          buffer = message.data;
+        } else if (message.data instanceof Blob) {
+          buffer = await message.data.arrayBuffer();
+        } else {
+          livekitLogger.error('unsupported data type', message.data);
+          return;
+        }
+        const dp = DataPacket.decode(new Uint8Array(buffer));
+        if (((_a = dp.value) === null || _a === void 0 ? void 0 : _a.$case) === 'speaker') {
+          // dispatch speaker updates
+          this.emit(EngineEvent.ActiveSpeakersUpdate, dp.value.speaker.speakers);
+        } else if (((_b = dp.value) === null || _b === void 0 ? void 0 : _b.$case) === 'user') {
+          this.emit(EngineEvent.DataPacketReceived, dp.value.user, dp.kind);
+        }
+      } finally {
+        unlock();
       }
     };
     this.handleDataError = event => {
@@ -20180,6 +20222,7 @@ class RTCEngine extends eventsExports.EventEmitter {
     this.reconnectPolicy = this.options.reconnectPolicy;
     this.registerOnLineListener();
     this.closingLock = new Mutex();
+    this.dataProcessLock = new Mutex();
   }
   async join(url, token, opts, abortSignal) {
     this.url = url;
@@ -21100,8 +21143,10 @@ class Room extends eventsExports.EventEmitter {
           CriticalTimers.clearTimeout(connectTimeout);
           (_a = this.abortController) === null || _a === void 0 ? void 0 : _a.signal.removeEventListener('abort', abortHandler);
           // also hook unload event
-          if (isWeb()) {
-            window.addEventListener('beforeunload', this.onBeforeUnload);
+          if (isWeb() && this.options.disconnectOnPageLeave) {
+            // capturing both 'pagehide' and 'beforeunload' to capture broadest set of browser behaviors
+            window.addEventListener('pagehide', this.onPageLeave);
+            window.addEventListener('beforeunload', this.onPageLeave);
             (_b = navigator.mediaDevices) === null || _b === void 0 ? void 0 : _b.addEventListener('devicechange', this.handleDeviceChange);
           }
           this.setAndEmitConnectionState(ConnectionState.Connected);
@@ -21152,7 +21197,7 @@ class Room extends eventsExports.EventEmitter {
         unlock();
       }
     };
-    this.onBeforeUnload = async () => {
+    this.onPageLeave = async () => {
       await this.disconnect();
     };
     this.handleRestarting = () => {
@@ -21379,8 +21424,14 @@ class Room extends eventsExports.EventEmitter {
     this.onLocalTrackUnmuted = pub => {
       this.emit(RoomEvent.TrackUnmuted, pub, this.localParticipant);
     };
-    this.onLocalTrackPublished = pub => {
+    this.onLocalTrackPublished = async pub => {
       this.emit(RoomEvent.LocalTrackPublished, pub, this.localParticipant);
+      if (pub.track instanceof LocalAudioTrack) {
+        const trackIsSilent = await pub.track.checkForSilence();
+        if (trackIsSilent) {
+          this.emit(RoomEvent.LocalAudioSilenceDetected, pub);
+        }
+      }
     };
     this.onLocalTrackUnpublished = pub => {
       this.emit(RoomEvent.LocalTrackUnpublished, pub, this.localParticipant);
@@ -21759,7 +21810,8 @@ class Room extends eventsExports.EventEmitter {
       this.audioContext = undefined;
     }
     if (isWeb()) {
-      window.removeEventListener('beforeunload', this.onBeforeUnload);
+      window.removeEventListener('beforeunload', this.onPageLeave);
+      window.removeEventListener('pagehide', this.onPageLeave);
       (_a = navigator.mediaDevices) === null || _a === void 0 ? void 0 : _a.removeEventListener('devicechange', this.handleDeviceChange);
     }
     this.setAndEmitConnectionState(ConnectionState.Disconnected);