@defcomm/meetingsdk 0.2.1 → 0.2.3

package/dist/index.d.mts

@@ -280,6 +280,8 @@ interface SFUClientOptions {
         recording_id: string;
         stopped_at: string;
     }) => void;
+    /** Authoritative room snapshot received after join/reconnect/resync. */
+    onRoomState?: (state: any) => void;
     onError?: (error: any) => void;
     autoSubscribe?: boolean;
 }
@@ -333,6 +335,8 @@ declare class SFUClient {
     private trackToSource;
     private localTrackIds;
     private subscriberStatsTimer;
+    private roomSyncTimer;
+    private roomSyncInFlight;
     private onStateChange;
     private onParticipantJoined;
     private onParticipantLeft;
@@ -352,12 +356,16 @@ declare class SFUClient {
     private onTrackStateChanged;
     private onRecordingStarted;
     private onRecordingStopped;
+    private onRoomState;
     private onError;
     private autoSubscribe;
     constructor(options?: SFUClientOptions);
     private heartbeatTimer;
     private startHeartbeat;
     private stopHeartbeat;
+    private startRoomStateSync;
+    private stopRoomStateSync;
+    private syncRoomState;
     private createId;
     private resumeStorageKey;
     private loadResumeToken;
@@ -392,6 +400,7 @@ declare class SFUClient {
     private failJoin;
     private resolveJoin;
     private handleServerMessage;
+    private applyRoomState;
     private rememberTrack;
     private handleJoined;
     private initializePeerConnections;
@@ -469,6 +478,7 @@ type MeetingContextValue = {
     onEntryRequested: (cb: (req: any) => void) => () => void;
     onEntryResponded: (cb: (payload: any, decision?: any) => void) => () => void;
     onMeetingLeft: (cb: () => void) => () => void;
+    onRoomUpdate: (cb: (data: any) => void) => () => void;
     onTrackStateChanged: (cb: (track: any) => void) => () => void;
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
@@ -527,6 +537,7 @@ declare const useMeeting: (handlers?: {
     onEntryRequested: (cb: (req: any) => void) => () => void;
     onEntryResponded: (cb: (payload: any, decision?: any) => void) => () => void;
     onMeetingLeft: (cb: () => void) => () => void;
+    onRoomUpdate: (cb: (data: any) => void) => () => void;
     onTrackStateChanged: (cb: (track: any) => void) => () => void;
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
@@ -540,6 +551,7 @@ declare const useRemoteMedia: (participantId: string) => {
     audioRef: react.RefObject<HTMLAudioElement | null>;
     isCamActive: boolean;
     isMicEnabled: boolean;
+    connectionState: "connected" | "reconnecting" | "disconnected" | undefined;
 };
 
 type LiveRoomState = {

package/dist/index.d.ts

@@ -280,6 +280,8 @@ interface SFUClientOptions {
         recording_id: string;
         stopped_at: string;
     }) => void;
+    /** Authoritative room snapshot received after join/reconnect/resync. */
+    onRoomState?: (state: any) => void;
     onError?: (error: any) => void;
     autoSubscribe?: boolean;
 }
@@ -333,6 +335,8 @@ declare class SFUClient {
     private trackToSource;
     private localTrackIds;
     private subscriberStatsTimer;
+    private roomSyncTimer;
+    private roomSyncInFlight;
     private onStateChange;
     private onParticipantJoined;
     private onParticipantLeft;
@@ -352,12 +356,16 @@ declare class SFUClient {
     private onTrackStateChanged;
     private onRecordingStarted;
     private onRecordingStopped;
+    private onRoomState;
     private onError;
     private autoSubscribe;
     constructor(options?: SFUClientOptions);
     private heartbeatTimer;
     private startHeartbeat;
     private stopHeartbeat;
+    private startRoomStateSync;
+    private stopRoomStateSync;
+    private syncRoomState;
     private createId;
     private resumeStorageKey;
     private loadResumeToken;
@@ -392,6 +400,7 @@ declare class SFUClient {
     private failJoin;
     private resolveJoin;
     private handleServerMessage;
+    private applyRoomState;
     private rememberTrack;
     private handleJoined;
     private initializePeerConnections;
@@ -469,6 +478,7 @@ type MeetingContextValue = {
     onEntryRequested: (cb: (req: any) => void) => () => void;
     onEntryResponded: (cb: (payload: any, decision?: any) => void) => () => void;
     onMeetingLeft: (cb: () => void) => () => void;
+    onRoomUpdate: (cb: (data: any) => void) => () => void;
     onTrackStateChanged: (cb: (track: any) => void) => () => void;
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
@@ -527,6 +537,7 @@ declare const useMeeting: (handlers?: {
     onEntryRequested: (cb: (req: any) => void) => () => void;
     onEntryResponded: (cb: (payload: any, decision?: any) => void) => () => void;
     onMeetingLeft: (cb: () => void) => () => void;
+    onRoomUpdate: (cb: (data: any) => void) => () => void;
     onTrackStateChanged: (cb: (track: any) => void) => () => void;
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
@@ -540,6 +551,7 @@ declare const useRemoteMedia: (participantId: string) => {
     audioRef: react.RefObject<HTMLAudioElement | null>;
     isCamActive: boolean;
     isMicEnabled: boolean;
+    connectionState: "connected" | "reconnecting" | "disconnected" | undefined;
 };
 
 type LiveRoomState = {

package/dist/index.js

@@ -428,6 +428,8 @@ var SFUClient = class {
     this.trackToSource = /* @__PURE__ */ new Map();
     this.localTrackIds = /* @__PURE__ */ new Map();
     this.subscriberStatsTimer = null;
+    this.roomSyncTimer = null;
+    this.roomSyncInFlight = false;
     this.heartbeatTimer = null;
     this.apiBase = options.apiBase || "https://api.example.com/api";
     this.wsBase = options.wsBase || "wss://api.example.com/ws";
@@ -470,6 +472,8 @@ var SFUClient = class {
     });
     this.onRecordingStopped = options.onRecordingStopped || (() => {
     });
+    this.onRoomState = options.onRoomState || (() => {
+    });
     this.onError = options.onError || console.error;
     this.autoSubscribe = options.autoSubscribe !== false;
   }
@@ -491,6 +495,29 @@ var SFUClient = class {
       this.heartbeatTimer = null;
     }
   }
+  startRoomStateSync() {
+    this.stopRoomStateSync();
+    this.roomSyncTimer = setInterval(() => {
+      if (this.state !== "connected") return;
+      void this.syncRoomState();
+    }, 5e3);
+  }
+  stopRoomStateSync() {
+    if (this.roomSyncTimer) {
+      clearInterval(this.roomSyncTimer);
+      this.roomSyncTimer = null;
+    }
+    this.roomSyncInFlight = false;
+  }
+  async syncRoomState() {
+    if (this.roomSyncInFlight || !this.isSocketOpen()) return;
+    this.roomSyncInFlight = true;
+    try {
+      this.send({ type: "sync_room_state" });
+    } finally {
+      this.roomSyncInFlight = false;
+    }
+  }
   createId() {
     return typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : `id_${Math.random().toString(36).slice(2)}_${Date.now()}`;
   }
@@ -913,6 +940,10 @@ var SFUClient = class {
       case "subscription_updated": {
         break;
       }
+      case "room_state": {
+        await this.applyRoomState(payload);
+        break;
+      }
       case "recording_started": {
         this.onRecordingStarted({
           recording_id: payload.recording_id,
@@ -978,6 +1009,72 @@ var SFUClient = class {
         console.debug("[SFU] Ignoring unknown server message", message);
     }
   }
+  async applyRoomState(payload) {
+    const nextParticipants = /* @__PURE__ */ new Map();
+    for (const participant of payload.participants || []) {
+      const id = participant?.participant_id;
+      if (!id) continue;
+      nextParticipants.set(id, participant);
+    }
+    for (const [id] of this.participants) {
+      if (id === this.currentParticipantId) continue;
+      if (!nextParticipants.has(id)) {
+        this.participants.delete(id);
+        this.removeRemoteParticipant(id);
+        this.onParticipantLeft(id);
+      }
+    }
+    for (const [id, participant] of nextParticipants) {
+      if (id === this.currentParticipantId) continue;
+      const existed = this.participants.has(id);
+      this.participants.set(id, participant);
+      if (!existed) {
+        this.onParticipantJoined(participant);
+      }
+      const sharing = Boolean(participant.screen_sharing);
+      const screenTrackId = participant.screen_track_id ? String(participant.screen_track_id) : void 0;
+      if (sharing) {
+        const track = screenTrackId ? (payload.tracks || []).find(
+          (candidate) => String(candidate.track_id) === screenTrackId
+        ) : void 0;
+        this.onScreenShareStarted(id, track);
+      } else if (this.remoteScreenStreams.has(id)) {
+        this.remoteScreenStreams.get(id)?.getTracks().forEach((track) => track.stop());
+        this.remoteScreenStreams.delete(id);
+        this.onScreenShareStopped(id, screenTrackId);
+      }
+    }
+    const nextTracks = /* @__PURE__ */ new Map();
+    for (const track of payload.tracks || []) {
+      if (track?.track_id) nextTracks.set(String(track.track_id), track);
+    }
+    for (const [trackId, existing] of this.trackMetadata) {
+      if (!nextTracks.has(trackId)) {
+        this.trackMetadata.delete(trackId);
+        this.trackToParticipant.delete(trackId);
+        this.trackToSource.delete(trackId);
+        this.subscribedTracks.delete(trackId);
+        for (const [source, localId] of this.localTrackIds) {
+          if (localId === trackId) this.localTrackIds.delete(source);
+        }
+        if (existing.participant_id !== this.currentParticipantId) {
+          this.onTrackUnpublished(existing);
+        }
+      }
+    }
+    for (const track of nextTracks.values()) {
+      this.rememberTrack(track);
+    }
+    if (this.autoSubscribe) {
+      const missing = [...nextTracks.values()].filter(
+        (track) => track.participant_id !== this.currentParticipantId && !this.subscribedTracks.has(track.track_id)
+      ).map((track) => track.track_id);
+      if (missing.length) {
+        await this.subscribeMultiple(missing);
+      }
+    }
+    this.onRoomState(payload);
+  }
   rememberTrack(track) {
     this.trackMetadata.set(track.track_id, track);
     this.trackToParticipant.set(track.track_id, track.participant_id);
@@ -1007,8 +1104,15 @@ var SFUClient = class {
     for (const track of payload.tracks || []) {
       if (track?.track_id) this.rememberTrack(track);
     }
+    if (payload.recording) {
+      this.onRecordingStarted({
+        recording_id: payload.recording.recording_id,
+        started_at: payload.recording.started_at
+      });
+    }
     await this.initializePeerConnections();
     this.setState("connected");
+    this.startRoomStateSync();
     this.onConnected(payload, resumed);
     for (const participant of this.participants.values()) {
       if (participant.participant_id !== this.currentParticipantId) {
@@ -1563,6 +1667,7 @@ var SFUClient = class {
   }
   async leave() {
     this.stopHeartbeat();
+    this.stopRoomStateSync();
     this.intentionalClose = true;
     this.setState("leaving");
     if (this.reconnectTimer) {
@@ -1950,6 +2055,30 @@ var VideoSDKCore = class {
           name: this.participantName
         });
       },
+      onRoomState: (roomState) => {
+        for (const participant of roomState?.participants || []) {
+          const pid = participant?.participant_id;
+          if (!pid || pid === this.myId) continue;
+          const current = this.state.getParticipant(pid);
+          if (!current) continue;
+          if (participant.screen_sharing) {
+            this.state.updateParticipantMedia(pid, {
+              isScreenSharing: true,
+              screenStream: current.media?.screenStream ?? null
+            });
+          } else if (current.media?.isScreenSharing) {
+            const screen = this.remoteScreenStreams.get(pid);
+            screen?.getTracks().forEach((track) => track.stop());
+            this.remoteScreenStreams.delete(pid);
+            this.state.updateParticipantMedia(pid, {
+              isScreenSharing: false,
+              screenStream: null,
+              screenTrack: void 0
+            });
+          }
+        }
+        this.events.onRoomUpdate?.(roomState);
+      },
       onDisconnected: () => {
         console.log("[SFU] Signaling WebSocket disconnected; reconnecting");
       },
@@ -2509,6 +2638,7 @@ var MeetingProvider = ({
     /* @__PURE__ */ new Set()
   );
   const meetingLeftListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
+  const roomUpdateListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
   const trackStateListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
   const recordingStartedListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
   const recordingStoppedListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
@@ -2533,6 +2663,9 @@ var MeetingProvider = ({
         onMeetingLeft: () => {
           meetingLeftListeners.current.forEach((fn) => fn());
         },
+        onRoomUpdate: (data) => {
+          roomUpdateListeners.current.forEach((fn) => fn(data));
+        },
         onTrackStateChanged: (track) => {
           trackStateListeners.current.forEach((fn) => fn(track));
         },
@@ -2631,6 +2764,10 @@ var MeetingProvider = ({
           meetingLeftListeners.current.delete(cb);
         };
       },
+      onRoomUpdate: (cb) => {
+        roomUpdateListeners.current.add(cb);
+        return () => roomUpdateListeners.current.delete(cb);
+      },
       onTrackStateChanged: (cb) => {
         trackStateListeners.current.add(cb);
         return () => trackStateListeners.current.delete(cb);
@@ -2797,7 +2934,8 @@ var useRemoteMedia = (participantId) => {
     videoRef,
     audioRef,
     isCamActive: !!participant?.media?.camEnabled,
-    isMicEnabled: !!participant?.media?.micEnabled
+    isMicEnabled: !!participant?.media?.micEnabled,
+    connectionState: participant?.connectionState
   };
 };