@stream-io/video-client 1.52.0 → 1.53.0

package/src/rtc/Subscriber.ts

@@ -94,6 +94,7 @@ export class Subscriber extends BasePeerConnection {
     track.addEventListener('unmute', () => {
       this.logger.info(`[onTrack]: Track unmuted: ${trackDebugInfo}`);
       this.setRemoteTrackInterrupted(trackId, trackType, false);
+      this.onRemoteTrackUnmute?.(trackType, track.id);
     });
     track.addEventListener('ended', () => {
       this.logger.info(`[onTrack]: Track ended: ${trackDebugInfo}`);

package/src/rtc/__tests__/Call.reconnect.test.ts

@@ -3,6 +3,7 @@ import './mocks/webrtc.mocks';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { Call } from '../../Call';
 import { StreamClient } from '../../coordinator/connection/client';
+import { ClientEventReporter } from '../../reporting';
 import { StreamVideoWriteableStateStore } from '../../store';
 import { CallingState } from '../../store';
 import { NegotiationError } from '../NegotiationError';
@@ -30,6 +31,7 @@ const makeCall = () => {
     type: 'default',
     id: 'test-call',
     streamClient,
+    clientEventReporter: new ClientEventReporter({ streamClient }),
     clientStore,
     ringing: false,
     watching: false,
@@ -585,6 +587,7 @@ describe('Call reconnect wiring (PC event → leave)', () => {
       type: 'default',
       id: 'test-call',
       streamClient,
+      clientEventReporter: new ClientEventReporter({ streamClient }),
       clientStore,
       ringing: false,
       watching: false,

package/src/rtc/types.ts

@@ -2,6 +2,7 @@ import {
   AudioBitrateProfile,
   PeerType,
   PublishOption,
+  TrackType,
   WebsocketReconnectStrategy,
 } from '../gen/video/sfu/models/models';
 import { StreamSfuClient } from '../StreamSfuClient';
@@ -53,6 +54,37 @@ export type OnReconnectionNeeded = (
  */
 export type OnIceConnected = (peerType: PeerType) => void;
 
+/**
+ * Snapshot of the peer connection's ICE and DTLS state surfaced to telemetry
+ * consumers (e.g. `ClientEventReporter`). Fired on every transition of
+ * either `iceConnectionState` or `peerConnectionState`.
+ */
+export type PeerConnectionStateChangeEvent =
+  | {
+      peerType: PeerType;
+      stateType: 'ice';
+      state: RTCIceConnectionState;
+    }
+  | {
+      peerType: PeerType;
+      stateType: 'peerConnection';
+      state: RTCPeerConnectionState;
+    };
+
+export type OnPeerConnectionStateChange = (
+  event: PeerConnectionStateChangeEvent,
+) => void;
+
+/**
+ * Fired when a remote track starts receiving media (`unmute`). Used by
+ * telemetry to report the `FirstVideoFrame` / `FirstAudioFrame` stage; the
+ * consumer decides which track types are relevant.
+ */
+export type OnRemoteTrackUnmute = (
+  trackType: TrackType,
+  trackId: string,
+) => void;
+
 export type BasePeerConnectionOpts = {
   sfuClient: StreamSfuClient;
   state: CallState;
@@ -60,6 +92,8 @@ export type BasePeerConnectionOpts = {
   dispatcher: Dispatcher;
   onReconnectionNeeded?: OnReconnectionNeeded;
   onIceConnected?: OnIceConnected;
+  onPeerConnectionStateChange?: OnPeerConnectionStateChange;
+  onRemoteTrackUnmute?: OnRemoteTrackUnmute;
   tag: string;
   enableTracing: boolean;
   iceRestartDelay?: number;

package/src/types.ts

@@ -14,6 +14,7 @@ import type {
   StartRecordingResponse,
 } from './gen/coordinator';
 import type { StreamClient } from './coordinator/connection/client';
+import type { ClientEventReporter } from './reporting';
 import type {
   RejectReason,
   StreamClientOptions,
@@ -311,6 +312,11 @@ export type CallConstructor = {
    */
   streamClient: StreamClient;
 
+  /**
+   * The shared client event reporter, owned by `StreamVideoClient`.
+   */
+  clientEventReporter: ClientEventReporter;
+
   /**
    * The Call type.
    */