@stream-io/video-client 1.26.0 → 1.27.0

package/dist/src/Call.d.ts

@@ -2,7 +2,7 @@ import { Publisher, Subscriber } from './rtc';
 import { CallState } from './store';
 import type { AcceptCallResponse, BlockUserResponse, CallRingEvent, CallSettingsResponse, CollectUserFeedbackRequest, CollectUserFeedbackResponse, DeleteCallRequest, DeleteCallResponse, EndCallResponse, GetCallReportResponse, GetCallResponse, GetOrCreateCallRequest, GetOrCreateCallResponse, GoLiveRequest, GoLiveResponse, JoinCallResponse, ListRecordingsResponse, ListTranscriptionsResponse, MuteUsersResponse, PinRequest, PinResponse, QueryCallMembersRequest, QueryCallMembersResponse, RejectCallResponse, RequestPermissionRequest, RequestPermissionResponse, SendCallEventResponse, SendReactionRequest, SendReactionResponse, StartClosedCaptionsRequest, StartClosedCaptionsResponse, StartFrameRecordingRequest, StartFrameRecordingResponse, StartHLSBroadcastingResponse, StartRecordingRequest, StartRecordingResponse, StartRTMPBroadcastsRequest, StartRTMPBroadcastsResponse, StartTranscriptionRequest, StartTranscriptionResponse, StopAllRTMPBroadcastsResponse, StopClosedCaptionsRequest, StopClosedCaptionsResponse, StopFrameRecordingResponse, StopHLSBroadcastingResponse, StopLiveRequest, StopLiveResponse, StopRecordingResponse, StopRTMPBroadcastsResponse, StopTranscriptionResponse, UnblockUserResponse, UnpinRequest, UnpinResponse, UpdateCallMembersRequest, UpdateCallMembersResponse, UpdateCallRequest, UpdateCallResponse, UpdateUserPermissionsRequest, UpdateUserPermissionsResponse } from './gen/coordinator';
 import { AudioTrackType, CallConstructor, CallLeaveOptions, ClientPublishOptions, ClosedCaptionsSettings, JoinCallData, TrackMuteType, VideoTrackType } from './types';
-import { TrackType, VideoDimension } from './gen/video/sfu/models/models';
+import { ClientCapability, TrackType, VideoDimension } from './gen/video/sfu/models/models';
 import { Tracer } from './stats';
 import { DynascaleManager } from './helpers/DynascaleManager';
 import { PermissionsContext } from './permissions';
@@ -106,6 +106,10 @@ export declare class Call {
     private readonly leaveCallHooks;
     private readonly streamClientBasePath;
     private streamClientEventHandlers;
+    /**
+     * A list of capabilities that the client supports and are enabled.
+     */
+    private clientCapabilities;
     /**
      * Constructs a new `Call` instance.
      *
@@ -229,7 +233,7 @@ export declare class Call {
      *
      * @returns a promise which resolves once the call join-flow has finished.
      */
-    doJoin: (data?: JoinCallData) => Promise<void>;
+    private doJoin;
     /**
      * Prepares Reconnect Details object.
      * @internal
@@ -759,4 +763,12 @@ export declare class Call {
      * @param timeoutSeconds Timeout in seconds, or 0 to keep reconnecting indefinetely
      */
     setDisconnectionTimeout: (timeoutSeconds: number) => void;
+    /**
+     * Enables the provided client capabilities.
+     */
+    enableClientCapabilities: (...capabilities: ClientCapability[]) => void;
+    /**
+     * Disables the provided client capabilities.
+     */
+    disableClientCapabilities: (...capabilities: ClientCapability[]) => void;
 }

package/dist/src/StreamSfuClient.d.ts

@@ -14,6 +14,10 @@ export type StreamSfuClientConstructor = {
      * The credentials to use for the connection.
      */
     credentials: Credentials;
+    /**
+     * The `cid` (call ID) to use for the connection.
+     */
+    cid: string;
     /**
      * `sessionId` to use for the connection.
      */
@@ -21,7 +25,7 @@ export type StreamSfuClientConstructor = {
     /**
      * A log tag to use for logging. Useful for debugging multiple instances.
      */
-    logTag: string;
+    tag: string;
     /**
      * The timeout in milliseconds for waiting for the `joinResponse`.
      * Defaults to 5000ms.
@@ -90,7 +94,7 @@ export declare class StreamSfuClient {
     private readonly unsubscribeNetworkChanged;
     private readonly onSignalClose;
     private readonly logger;
-    private readonly logTag;
+    readonly tag: string;
     private readonly credentials;
     private readonly dispatcher;
     private readonly joinResponseTimeout;
@@ -133,7 +137,7 @@ export declare class StreamSfuClient {
     /**
      * Constructs a new SFU client.
      */
-    constructor({ dispatcher, credentials, sessionId, logTag, joinResponseTimeout, onSignalClose, streamClient, enableTracing, }: StreamSfuClientConstructor);
+    constructor({ dispatcher, credentials, sessionId, cid, tag, joinResponseTimeout, onSignalClose, streamClient, enableTracing, }: StreamSfuClientConstructor);
     private createWebSocket;
     private cleanUpWebSocket;
     get isHealthy(): boolean;

package/dist/src/events/internal.d.ts

@@ -1,7 +1,7 @@
 import { Dispatcher } from '../rtc';
 import { Call } from '../Call';
 import { CallState } from '../store';
-import type { PinsChanged } from '../gen/video/sfu/event/events';
+import type { InboundStateNotification, PinsChanged } from '../gen/video/sfu/event/events';
 export declare const watchConnectionQualityChanged: (dispatcher: Dispatcher, state: CallState) => () => void;
 /**
  * Updates the approximate number of participants in the call by peeking at the
@@ -18,3 +18,9 @@ export declare const watchSfuErrorReports: (dispatcher: Dispatcher) => () => voi
  * in the call.
  */
 export declare const watchPinsUpdated: (state: CallState) => (e: PinsChanged) => void;
+/**
+ * Watches for inbound state notifications and updates the paused tracks
+ *
+ * @param state the call state to update.
+ */
+export declare const watchInboundStateNotification: (state: CallState) => (e: InboundStateNotification) => void;

package/dist/src/gen/video/sfu/event/events.d.ts

@@ -1,5 +1,5 @@
 import { MessageType } from '@protobuf-ts/runtime';
-import { CallEndedReason, CallGrants, CallState, ClientDetails, Codec, ConnectionQuality, Error as Error$, GoAwayReason, ICETrickle as ICETrickle$, Participant, ParticipantCount, PeerType, Pin, PublishOption, SubscribeOption, TrackInfo, TrackType, TrackUnpublishReason, WebsocketReconnectStrategy } from '../models/models';
+import { CallEndedReason, CallGrants, CallState, ClientCapability, ClientDetails, Codec, ConnectionQuality, Error as Error$, GoAwayReason, ICETrickle as ICETrickle$, Participant, ParticipantCount, PeerType, Pin, PublishOption, SubscribeOption, TrackInfo, TrackType, TrackUnpublishReason, WebsocketReconnectStrategy } from '../models/models';
 import { TrackSubscriptionDetails } from '../signal_rpc/signal';
 /**
  * SFUEvent is a message that is sent from the SFU to the client.
@@ -208,6 +208,14 @@ export interface SfuEvent {
          * @generated from protobuf field: stream.video.sfu.event.ChangePublishOptions change_publish_options = 27;
          */
         changePublishOptions: ChangePublishOptions;
+    } | {
+        oneofKind: 'inboundStateNotification';
+        /**
+         * InboundStateNotification
+         *
+         * @generated from protobuf field: stream.video.sfu.event.InboundStateNotification inbound_state_notification = 28;
+         */
+        inboundStateNotification: InboundStateNotification;
     } | {
         oneofKind: undefined;
     };
@@ -460,6 +468,10 @@ export interface JoinRequest {
      * @generated from protobuf field: repeated stream.video.sfu.models.SubscribeOption preferred_subscribe_options = 10;
      */
     preferredSubscribeOptions: SubscribeOption[];
+    /**
+     * @generated from protobuf field: repeated stream.video.sfu.models.ClientCapability capabilities = 11;
+     */
+    capabilities: ClientCapability[];
 }
 /**
  * @generated from protobuf message stream.video.sfu.event.ReconnectDetails
@@ -827,6 +839,36 @@ export interface CallEnded {
      */
     reason: CallEndedReason;
 }
+/**
+ * @generated from protobuf message stream.video.sfu.event.InboundStateNotification
+ */
+export interface InboundStateNotification {
+    /**
+     * @generated from protobuf field: repeated stream.video.sfu.event.InboundVideoState inbound_video_states = 1;
+     */
+    inboundVideoStates: InboundVideoState[];
+}
+/**
+ * @generated from protobuf message stream.video.sfu.event.InboundVideoState
+ */
+export interface InboundVideoState {
+    /**
+     * @generated from protobuf field: string user_id = 1;
+     */
+    userId: string;
+    /**
+     * @generated from protobuf field: string session_id = 2;
+     */
+    sessionId: string;
+    /**
+     * @generated from protobuf field: stream.video.sfu.models.TrackType track_type = 3;
+     */
+    trackType: TrackType;
+    /**
+     * @generated from protobuf field: bool paused = 4;
+     */
+    paused: boolean;
+}
 declare class SfuEvent$Type extends MessageType<SfuEvent> {
     constructor();
 }
@@ -1072,4 +1114,18 @@ declare class CallEnded$Type extends MessageType<CallEnded> {
  * @generated MessageType for protobuf message stream.video.sfu.event.CallEnded
  */
 export declare const CallEnded: CallEnded$Type;
+declare class InboundStateNotification$Type extends MessageType<InboundStateNotification> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.event.InboundStateNotification
+ */
+export declare const InboundStateNotification: InboundStateNotification$Type;
+declare class InboundVideoState$Type extends MessageType<InboundVideoState> {
+    constructor();
+}
+/**
+ * @generated MessageType for protobuf message stream.video.sfu.event.InboundVideoState
+ */
+export declare const InboundVideoState: InboundVideoState$Type;
 export {};

package/dist/src/gen/video/sfu/models/models.d.ts

@@ -815,6 +815,10 @@ export declare enum ErrorCode {
      * @generated from protobuf enum value: ERROR_CODE_CALL_NOT_FOUND = 300;
      */
     CALL_NOT_FOUND = 300,
+    /**
+     * @generated from protobuf enum value: ERROR_CODE_CALL_PARTICIPANT_LIMIT_REACHED = 301;
+     */
+    CALL_PARTICIPANT_LIMIT_REACHED = 301,
     /**
      * @generated from protobuf enum value: ERROR_CODE_REQUEST_VALIDATION_FAILED = 400;
      */
@@ -1076,6 +1080,23 @@ export declare enum AppleThermalState {
      */
     CRITICAL = 4
 }
+/**
+ * ClientCapability defines a feature that client supports
+ *
+ * @generated from protobuf enum stream.video.sfu.models.ClientCapability
+ */
+export declare enum ClientCapability {
+    /**
+     * @generated from protobuf enum value: CLIENT_CAPABILITY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Enables SFU pausing inbound video
+     *
+     * @generated from protobuf enum value: CLIENT_CAPABILITY_SUBSCRIBER_VIDEO_PAUSE = 1;
+     */
+    SUBSCRIBER_VIDEO_PAUSE = 1
+}
 declare class CallState$Type extends MessageType<CallState> {
     constructor();
 }

package/dist/src/helpers/array.d.ts

@@ -5,3 +5,10 @@
  * @param values the values to add.
  */
 export declare const pushToIfMissing: <T>(arr: T[], ...values: T[]) => T[];
+/**
+ * Removes values from an array if they are present.
+ *
+ * @param arr the array to remove from.
+ * @param values the values to remove.
+ */
+export declare const removeFromIfPresent: <T>(arr: T[], ...values: T[]) => T[];

package/dist/src/helpers/participantUtils.d.ts

@@ -1,4 +1,4 @@
-import { StreamVideoParticipant } from '../types';
+import { StreamVideoParticipant, VideoTrackType } from '../types';
 /**
  * Check if a participant has a video.
  *
@@ -29,3 +29,10 @@ export declare const hasScreenShareAudio: (p: StreamVideoParticipant) => boolean
  * @param p the participant.
  */
 export declare const isPinned: (p: StreamVideoParticipant) => boolean;
+/**
+ * Check if a participant has a paused track of the specified type.
+ *
+ * @param p the participant to check.
+ * @param videoTrackType the type of video track to check for ('videoTrack' or 'screenShareTrack').
+ */
+export declare const hasPausedTrack: (p: StreamVideoParticipant, videoTrackType: VideoTrackType) => boolean;

package/dist/src/rtc/BasePeerConnection.d.ts

@@ -11,7 +11,7 @@ export type BasePeerConnectionOpts = {
     connectionConfig?: RTCConfiguration;
     dispatcher: Dispatcher;
     onReconnectionNeeded?: OnReconnectionNeeded;
-    logTag: string;
+    tag: string;
     enableTracing: boolean;
     iceRestartDelay?: number;
 };
@@ -40,7 +40,7 @@ export declare abstract class BasePeerConnection {
     /**
      * Constructs a new `BasePeerConnection` instance.
      */
-    protected constructor(peerType: PeerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, logTag, enableTracing, iceRestartDelay, }: BasePeerConnectionOpts);
+    protected constructor(peerType: PeerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, tag, enableTracing, iceRestartDelay, }: BasePeerConnectionOpts);
     private createPeerConnection;
     /**
      * Disposes the `RTCPeerConnection` instance.

package/dist/src/rtc/Dispatcher.d.ts

@@ -19,7 +19,7 @@ export declare const isSfuEvent: (eventName: SfuEventKinds | EventTypes) => even
 export declare class Dispatcher {
     private readonly logger;
     private subscribers;
-    dispatch: <K extends SfuEventKinds>(message: DispatchableMessage<K>, logTag?: string) => void;
+    dispatch: <K extends SfuEventKinds>(message: DispatchableMessage<K>, tag?: string) => void;
     on: <E extends keyof AllSfuEvents>(eventName: E, fn: CallEventListener<E>) => () => void;
     off: <E extends keyof AllSfuEvents>(eventName: E, fn: CallEventListener<E>) => void;
 }

package/dist/src/rtc/signal.d.ts

@@ -2,5 +2,5 @@ import { DispatchableMessage, SfuEventKinds } from './Dispatcher';
 export declare const createWebSocketSignalChannel: (opts: {
     endpoint: string;
     onMessage: <K extends SfuEventKinds>(message: DispatchableMessage<K>) => void;
-    logTag: string;
+    tag: string;
 }) => WebSocket;

package/dist/src/store/CallState.d.ts

@@ -480,8 +480,9 @@ export declare class CallState {
      *
      * @param sessionId the session ID of the participant to update.
      * @param participant the participant to update or add.
+     * @param patch an optional patch to apply to the participant.
      */
-    updateOrAddParticipant: (sessionId: string, participant: StreamVideoParticipant) => StreamVideoParticipant[];
+    updateOrAddParticipant: (sessionId: string, participant: StreamVideoParticipant, patch?: StreamVideoParticipantPatch | ((p: StreamVideoParticipant) => StreamVideoParticipantPatch)) => StreamVideoParticipant[];
     /**
      * Updates all participants in the current call whose session ID is in the given `sessionIds`.
      * If no patches are provided, this operation is no-op.

package/dist/src/types.d.ts

@@ -1,4 +1,4 @@
-import type { Participant, VideoDimension } from './gen/video/sfu/models/models';
+import type { Participant, TrackType, VideoDimension } from './gen/video/sfu/models/models';
 import type { JoinCallRequest, MemberResponse, OwnCapability, ReactionResponse } from './gen/coordinator';
 import type { StreamClient } from './coordinator/connection/client';
 import type { Comparator } from './sorting';
@@ -48,6 +48,15 @@ export interface StreamVideoParticipant extends Participant {
      * Set it to `undefined` to unsubscribe from this participant's screen share.
      */
     screenShareDimension?: VideoDimension;
+    /**
+     * A list of tracks that are currently paused by our servers.
+     * Typically, a server-side pause happens when the local participant doesn't
+     * have enough bandwidth to receive all tracks. In this case, the server
+     * will pause some tracks to optimize the bandwidth usage.
+     * Once the bandwidth is restored, the server will resume the paused tracks.
+     * This is useful to avoid any unwanted video and audio artifacts.
+     */
+    pausedTracks?: TrackType[];
     /**
      * True if the participant is the local participant.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stream-io/video-client",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "browser": "dist/index.browser.es.js",

package/src/Call.ts

@@ -107,6 +107,7 @@ import {
 import { BehaviorSubject, Subject, takeWhile } from 'rxjs';
 import { ReconnectDetails } from './gen/video/sfu/event/events';
 import {
+  ClientCapability,
   ClientDetails,
   Codec,
   PublishOption,
@@ -271,6 +272,13 @@ export class Call {
   private readonly streamClientBasePath: string;
   private streamClientEventHandlers = new Map<Function, () => void>();
 
+  /**
+   * A list of capabilities that the client supports and are enabled.
+   */
+  private clientCapabilities = new Set<ClientCapability>([
+    ClientCapability.SUBSCRIBER_VIDEO_PAUSE,
+  ]);
+
   /**
    * Constructs a new `Call` instance.
    *
@@ -854,13 +862,28 @@ export class Call {
 
     this.state.setCallingState(CallingState.JOINING);
 
+    // we will count the number of join failures per SFU.
+    // once the number of failures reaches 2, we will piggyback on the `migrating_from`
+    // field to force the coordinator to provide us another SFU
+    const sfuJoinFailures = new Map<string, number>();
+    const joinData: JoinCallData = data;
     maxJoinRetries = Math.max(maxJoinRetries, 1);
     for (let attempt = 0; attempt < maxJoinRetries; attempt++) {
       try {
         this.logger('trace', `Joining call (${attempt})`, this.cid);
-        return await this.doJoin(data);
+        await this.doJoin(data);
+        delete joinData.migrating_from;
+        break;
       } catch (err) {
         this.logger('warn', `Failed to join call (${attempt})`, this.cid);
+
+        const sfuId = this.credentials?.server.edge_name || '';
+        const failures = (sfuJoinFailures.get(sfuId) || 0) + 1;
+        sfuJoinFailures.set(sfuId, failures);
+        if (failures >= 2) {
+          joinData.migrating_from = sfuId;
+        }
+
         if (attempt === maxJoinRetries - 1) {
           // restore the previous call state if the join-flow fails
           this.state.setCallingState(callingState);
@@ -878,7 +901,7 @@ export class Call {
    *
    * @returns a promise which resolves once the call join-flow has finished.
    */
-  doJoin = async (data?: JoinCallData): Promise<void> => {
+  private doJoin = async (data?: JoinCallData): Promise<void> => {
     const connectStartTime = Date.now();
     const callingState = this.state.callingState;
 
@@ -924,7 +947,8 @@ export class Call {
     const sfuClient =
       performingRejoin || performingMigration || !isWsHealthy
         ? new StreamSfuClient({
-            logTag: String(++this.sfuClientTag),
+            tag: String(this.sfuClientTag++),
+            cid: this.cid,
             dispatcher: this.dispatcher,
             credentials: this.credentials,
             streamClient: this.streamClient,
@@ -971,6 +995,7 @@ export class Call {
             reconnectDetails,
             preferredPublishOptions,
             preferredSubscribeOptions,
+            capabilities: Array.from(this.clientCapabilities),
           });
 
         this.currentPublishOptions = publishOptions;
@@ -1194,7 +1219,7 @@ export class Call {
       dispatcher: this.dispatcher,
       state: this.state,
       connectionConfig,
-      logTag: String(this.sfuClientTag),
+      tag: sfuClient.tag,
       enableTracing,
       onReconnectionNeeded: (kind, reason) => {
         this.reconnect(kind, reason).catch((err) => {
@@ -1217,7 +1242,7 @@ export class Call {
         state: this.state,
         connectionConfig,
         publishOptions,
-        logTag: String(this.sfuClientTag),
+        tag: sfuClient.tag,
         enableTracing,
         onReconnectionNeeded: (kind, reason) => {
           this.reconnect(kind, reason).catch((err) => {
@@ -2730,4 +2755,22 @@ export class Call {
   setDisconnectionTimeout = (timeoutSeconds: number) => {
     this.disconnectionTimeoutSeconds = timeoutSeconds;
   };
+
+  /**
+   * Enables the provided client capabilities.
+   */
+  enableClientCapabilities = (...capabilities: ClientCapability[]) => {
+    for (const capability of capabilities) {
+      this.clientCapabilities.add(capability);
+    }
+  };
+
+  /**
+   * Disables the provided client capabilities.
+   */
+  disableClientCapabilities = (...capabilities: ClientCapability[]) => {
+    for (const capability of capabilities) {
+      this.clientCapabilities.delete(capability);
+    }
+  };
 }

package/src/StreamSfuClient.ts

@@ -51,6 +51,11 @@ export type StreamSfuClientConstructor = {
    */
   credentials: Credentials;
 
+  /**
+   * The `cid` (call ID) to use for the connection.
+   */
+  cid: string;
+
   /**
    * `sessionId` to use for the connection.
    */
@@ -59,7 +64,7 @@ export type StreamSfuClientConstructor = {
   /**
    * A log tag to use for logging. Useful for debugging multiple instances.
    */
-  logTag: string;
+  tag: string;
 
   /**
    * The timeout in milliseconds for waiting for the `joinResponse`.
@@ -83,6 +88,14 @@ export type StreamSfuClientConstructor = {
   enableTracing: boolean;
 };
 
+type SfuWebSocketParams = {
+  attempt: string; // the reconnect attempt, start with 0
+  user_id: string;
+  api_key: string;
+  user_session_id: string;
+  cid: string;
+};
+
 /**
  * The client used for exchanging information with the SFU.
  */
@@ -140,7 +153,7 @@ export class StreamSfuClient {
   private readonly unsubscribeNetworkChanged: () => void;
   private readonly onSignalClose: ((reason: string) => void) | undefined;
   private readonly logger: Logger;
-  private readonly logTag: string;
+  readonly tag: string;
   private readonly credentials: Credentials;
   private readonly dispatcher: Dispatcher;
   private readonly joinResponseTimeout: number;
@@ -191,7 +204,8 @@ export class StreamSfuClient {
     dispatcher,
     credentials,
     sessionId,
-    logTag,
+    cid,
+    tag,
     joinResponseTimeout = 5000,
     onSignalClose,
     streamClient,
@@ -204,10 +218,10 @@ export class StreamSfuClient {
     const { server, token } = credentials;
     this.edgeName = server.edge_name;
     this.joinResponseTimeout = joinResponseTimeout;
-    this.logTag = logTag;
-    this.logger = getLogger(['SfuClient', logTag]);
+    this.tag = tag;
+    this.logger = getLogger(['SfuClient', tag]);
     this.tracer = enableTracing
-      ? new Tracer(`${logTag}-${this.edgeName}`)
+      ? new Tracer(`${tag}-${this.edgeName}`)
       : undefined;
     this.rpc = createSignalClient({
       baseUrl: server.url,
@@ -238,10 +252,16 @@ export class StreamSfuClient {
       }
     });
 
-    this.createWebSocket();
+    this.createWebSocket({
+      attempt: tag,
+      user_id: streamClient.user?.id || '',
+      api_key: streamClient.key,
+      user_session_id: this.sessionId,
+      cid,
+    });
   }
 
-  private createWebSocket = () => {
+  private createWebSocket = (params: SfuWebSocketParams) => {
     const eventsToTrace: Partial<Record<SfuEventKinds, boolean>> = {
       callEnded: true,
       changePublishQuality: true,
@@ -249,10 +269,11 @@ export class StreamSfuClient {
       connectionQualityChanged: true,
       error: true,
       goAway: true,
+      inboundStateNotification: true,
     };
     this.signalWs = createWebSocketSignalChannel({
-      logTag: this.logTag,
-      endpoint: `${this.credentials.server.ws_endpoint}?tag=${this.logTag}`,
+      tag: this.tag,
+      endpoint: `${this.credentials.server.ws_endpoint}?${new URLSearchParams(params).toString()}`,
       onMessage: (message) => {
         this.lastMessageTimestamp = new Date();
         this.scheduleConnectionCheck();
@@ -260,7 +281,7 @@ export class StreamSfuClient {
         if (eventsToTrace[eventKind]) {
           this.tracer?.trace(eventKind, message);
         }
-        this.dispatcher.dispatch(message, this.logTag);
+        this.dispatcher.dispatch(message, this.tag);
       },
     });
 
@@ -443,9 +464,7 @@ export class StreamSfuClient {
     this.migrateAwayTimeout = setTimeout(() => {
       unsubscribe();
       task.reject(
-        new Error(
-          `Migration (${this.logTag}) failed to complete in ${timeout}ms`,
-        ),
+        new Error(`Migration (${this.tag}) failed to complete in ${timeout}ms`),
       );
     }, timeout);
 

package/src/coordinator/connection/connection.ts

@@ -471,7 +471,6 @@ export class StableWSConnection {
   onmessage = (wsID: number, event: MessageEvent) => {
     if (this.wsID !== wsID) return;
 
-    this._log('onmessage() - onmessage callback', { event, wsID });
     const data =
       typeof event.data === 'string'
         ? (JSON.parse(event.data) as StreamVideoEvent)

package/src/events/__tests__/internal.test.ts

@@ -2,8 +2,10 @@ import { describe, expect, it, vi } from 'vitest';
 import { Call } from '../../Call';
 import { Dispatcher } from '../../rtc';
 import { CallState } from '../../store';
+import { noopComparator } from '../../sorting';
 import {
   watchConnectionQualityChanged,
+  watchInboundStateNotification,
   watchLiveEnded,
   watchParticipantCountChanged,
   watchPinsUpdated,
@@ -11,6 +13,7 @@ import {
 import {
   ConnectionQuality,
   ErrorCode,
+  TrackType,
 } from '../../gen/video/sfu/models/models';
 
 describe('internal events', () => {
@@ -131,4 +134,79 @@ describe('internal events', () => {
       { userId: 'u2', sessionId: 'session-2', pin: undefined },
     ]);
   });
+
+  it('handles InboundStateNotification', () => {
+    const state = new CallState();
+    state.setSortParticipantsBy(noopComparator());
+    state.setParticipants([
+      // @ts-expect-error incomplete data
+      { sessionId: 'session-1' },
+      // @ts-expect-error incomplete data
+      { sessionId: 'session-2' },
+    ]);
+
+    const update = watchInboundStateNotification(state);
+    update({
+      inboundVideoStates: [
+        {
+          userId: '1',
+          sessionId: 'session-1',
+          trackType: TrackType.VIDEO,
+          paused: true,
+        },
+        {
+          userId: '2',
+          sessionId: 'session-2',
+          trackType: TrackType.VIDEO,
+          paused: false,
+        },
+      ],
+    });
+    expect(
+      state.findParticipantBySessionId('session-1')?.pausedTracks,
+    ).toContain(TrackType.VIDEO);
+    expect(
+      state.findParticipantBySessionId('session-2')?.pausedTracks,
+    ).not.toContain(TrackType.VIDEO);
+
+    update({
+      inboundVideoStates: [
+        {
+          userId: '2',
+          sessionId: 'session-2',
+          trackType: TrackType.VIDEO,
+          paused: true,
+        },
+      ],
+    });
+    expect(
+      state.findParticipantBySessionId('session-1')?.pausedTracks,
+    ).toContain(TrackType.VIDEO);
+    expect(
+      state.findParticipantBySessionId('session-2')?.pausedTracks,
+    ).toContain(TrackType.VIDEO);
+
+    update({
+      inboundVideoStates: [
+        {
+          userId: '1',
+          sessionId: 'session-1',
+          trackType: TrackType.VIDEO,
+          paused: false,
+        },
+        {
+          userId: '2',
+          sessionId: 'session-2',
+          trackType: TrackType.VIDEO,
+          paused: false,
+        },
+      ],
+    });
+    expect(
+      state.findParticipantBySessionId('session-1')?.pausedTracks,
+    ).not.toContain(TrackType.VIDEO);
+    expect(
+      state.findParticipantBySessionId('session-2')?.pausedTracks,
+    ).not.toContain(TrackType.VIDEO);
+  });
 });