@stream-io/video-client 1.48.0 → 1.50.0

package/src/store/rxUtils.ts

@@ -3,6 +3,7 @@ import { withoutConcurrency } from '../helpers/concurrency';
 import { videoLoggerSystem } from '../logger';
 
 type FunctionPatch<T> = (currentValue: T) => T;
+type AsyncFunctionPatch<T> = (currentValue: T) => Promise<T>;
 
 /**
  * A value or a function which takes the current value and returns a new value.
@@ -59,6 +60,24 @@ export const setCurrentValue = <T>(subject: Subject<T>, update: Patch<T>) => {
   return next;
 };
 
+/**
+ * Updates the value of the provided Subject asynchronously.
+ * Locks the subject to prevent concurrent updates.
+ *
+ * @param subject the subject to update.
+ * @param update the update to apply to the subject.
+ */
+export const setCurrentValueAsync = async <T>(
+  subject: Subject<T>,
+  update: AsyncFunctionPatch<T>,
+) => {
+  return withoutConcurrency(subject, async () => {
+    const next = await update(getCurrentValue(subject));
+    subject.next(next);
+    return next;
+  });
+};
+
 /**
  * Updates the value of the provided Subject and returns the previous value
  * and a function to roll back the update.

package/src/types.ts

@@ -90,6 +90,25 @@ export interface StreamVideoParticipant extends Participant {
    */
   pausedTracks?: TrackType[];
 
+  /**
+   * The list of tracks that are currently not producing media.
+   *
+   * For remote participants this is currently surfaced for `TrackType.AUDIO`
+   * only and reflects the receiver-side `RTCRtpReceiver` track `mute`/`unmute`
+   * state, so it covers system mute on the sender (OS audio session
+   * interruption, etc.), the sender pausing its track, sustained RTP stalls,
+   * and SFU drops. Remote video and screen-share interruption is not tracked.
+   *
+   * For the local participant it reflects the local track `mute`/`unmute`
+   * events surfaced by the browser (e.g. bluetooth disconnect, OS-level
+   * mic/camera kill switch, iOS audio session interruption).
+   *
+   * Orthogonal to `publishedTracks`: a track can be in `publishedTracks`
+   * AND in `interruptedTracks` (the participant intends to publish, but
+   * no media is flowing right now).
+   */
+  interruptedTracks?: TrackType[];
+
   /**
    * True if the participant is the local participant.
    */