@defcomm/meetingsdk 0.4.2 → 0.4.4

package/dist/index.d.mts

@@ -59,6 +59,14 @@ type ChatMessage = {
     } | null;
     target?: string | null;
 };
+type PubSubMessage<T = unknown> = {
+    id: string;
+    topic: PubSubTopic;
+    sender_id: string;
+    sender_name?: string | null;
+    timestamp: number;
+    data: T;
+};
 type Participant = {
     id: string;
     name?: string;
@@ -97,7 +105,11 @@ type MeetingConfig = {
     videoMuted?: boolean;
     token?: string;
 };
-type PubSubTopic = "SECURE_CHAT";
+type PubSubTopic = "SECURE_CHAT" | "REACTION";
+type PubSubHandle<T = unknown> = {
+    messages: PubSubMessage<T>[];
+    publish: (data: T) => void;
+};
 type RecordingInfo = {
     recording_id: string;
     started_at?: string;
@@ -145,6 +157,12 @@ interface VideoSDKCoreOptions {
     onMuteStateChanged?: (peerId: string, kind: "audio" | "video", muted: boolean) => void;
 }
 type SFUConnectionState = "idle" | "connecting" | "joining" | "waiting_approval" | "connected" | "reconnecting" | "leaving" | "disconnected";
+type JoinState = {
+    status: "ready";
+    reason: "admitted" | "open" | "moderator";
+} | {
+    status: "approval_required";
+};
 
 declare const useLocalParticipant: () => {
     participant: Participant | null;
@@ -212,6 +230,7 @@ declare class VideoSDKCore {
         is_private?: boolean;
     }): Promise<any>;
     getRoom(roomCode: string): Promise<any>;
+    getJoinState(roomCode: string): Promise<JoinState>;
     deleteRoom(roomCode: string): Promise<any>;
     joinMeeting(config: Omit<MeetingConfig, "participantId">): Promise<void>;
     private connect;
@@ -239,15 +258,6 @@ declare class VideoSDKCore {
     private performDisconnect;
 }
 
-/**
- * DefComm SFU client.
- *
- * Signaling is authoritative for admission/session state.
- * WebRTC peer connections are transport state and are recreated only after a
- * successful join/resume. A transient WebSocket close therefore does NOT
- * destroy the local MediaStream or immediately declare the participant gone.
- */
-
 interface TrackInfo {
     track_id: string;
     participant_id: string;
@@ -265,13 +275,10 @@ interface ParticipantInfo {
     [key: string]: any;
 }
 
-type PubSubHandle = {
-    messages: ChatMessage[];
-    publish: (input: ChatInput) => void;
-};
 type MeetingContextValue = {
     sdk: VideoSDKCore;
     join: (config?: Omit<MeetingConfig, "participantId">) => Promise<void>;
+    getJoinState: (roomCode: string) => Promise<JoinState>;
     leave: () => void;
     createRoom: (input: {
         name: string;
@@ -297,7 +304,8 @@ type MeetingContextValue = {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => PubSubHandle;
+    usePubSub: <T = unknown>(topic: PubSubTopic) => PubSubHandle<T>;
+    onPubSubMessage: <T = unknown>(topic: PubSubTopic, cb: (message: PubSubMessage<T>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -333,6 +341,7 @@ declare const useMeeting: (handlers?: {
     onConnectionStateChanged?: (state: SFUConnectionState) => void;
 }) => {
     join: (config?: Omit<MeetingConfig, "participantId">) => Promise<void>;
+    getJoinState: (roomCode: string) => Promise<JoinState>;
     leave: () => void;
     createRoom: (input: {
         name: string;
@@ -358,10 +367,8 @@ declare const useMeeting: (handlers?: {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => {
-        messages: ChatMessage[];
-        publish: (input: ChatInput) => void;
-    };
+    usePubSub: <T = unknown>(topic: PubSubTopic) => PubSubHandle<T>;
+    onPubSubMessage: <T = unknown>(topic: PubSubTopic, cb: (message: PubSubMessage<T>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -456,4 +463,8 @@ declare class ActiveSpeakerDetector {
     destroy(): Promise<void>;
 }
 
-export { ActiveSpeakerDetector, type ChatInput, type MeetingConfig, MeetingProvider, MeetingState, type Participant, type ParticipantInfo, type Reaction, type RecordingInfo, type SFUConnectionState, type TrackInfo, VideoSDKCore, useLocalParticipant, useMeeting, useMeetingContext, useMeetingPreview, useParticipants, useRemoteMedia };
+declare function usePubSub<T = unknown>(topic: PubSubTopic, options?: {
+    onMessageReceived?: (message: PubSubMessage<T>) => void;
+}): PubSubHandle<T>;
+
+export { ActiveSpeakerDetector, type ChatInput, type MeetingConfig, MeetingProvider, MeetingState, type Participant, type ParticipantInfo, type Reaction, type RecordingInfo, type SFUConnectionState, type TrackInfo, VideoSDKCore, useLocalParticipant, useMeeting, useMeetingContext, useMeetingPreview, useParticipants, usePubSub, useRemoteMedia };

package/dist/index.d.ts

@@ -59,6 +59,14 @@ type ChatMessage = {
     } | null;
     target?: string | null;
 };
+type PubSubMessage<T = unknown> = {
+    id: string;
+    topic: PubSubTopic;
+    sender_id: string;
+    sender_name?: string | null;
+    timestamp: number;
+    data: T;
+};
 type Participant = {
     id: string;
     name?: string;
@@ -97,7 +105,11 @@ type MeetingConfig = {
     videoMuted?: boolean;
     token?: string;
 };
-type PubSubTopic = "SECURE_CHAT";
+type PubSubTopic = "SECURE_CHAT" | "REACTION";
+type PubSubHandle<T = unknown> = {
+    messages: PubSubMessage<T>[];
+    publish: (data: T) => void;
+};
 type RecordingInfo = {
     recording_id: string;
     started_at?: string;
@@ -145,6 +157,12 @@ interface VideoSDKCoreOptions {
     onMuteStateChanged?: (peerId: string, kind: "audio" | "video", muted: boolean) => void;
 }
 type SFUConnectionState = "idle" | "connecting" | "joining" | "waiting_approval" | "connected" | "reconnecting" | "leaving" | "disconnected";
+type JoinState = {
+    status: "ready";
+    reason: "admitted" | "open" | "moderator";
+} | {
+    status: "approval_required";
+};
 
 declare const useLocalParticipant: () => {
     participant: Participant | null;
@@ -212,6 +230,7 @@ declare class VideoSDKCore {
         is_private?: boolean;
     }): Promise<any>;
     getRoom(roomCode: string): Promise<any>;
+    getJoinState(roomCode: string): Promise<JoinState>;
     deleteRoom(roomCode: string): Promise<any>;
     joinMeeting(config: Omit<MeetingConfig, "participantId">): Promise<void>;
     private connect;
@@ -239,15 +258,6 @@ declare class VideoSDKCore {
     private performDisconnect;
 }
 
-/**
- * DefComm SFU client.
- *
- * Signaling is authoritative for admission/session state.
- * WebRTC peer connections are transport state and are recreated only after a
- * successful join/resume. A transient WebSocket close therefore does NOT
- * destroy the local MediaStream or immediately declare the participant gone.
- */
-
 interface TrackInfo {
     track_id: string;
     participant_id: string;
@@ -265,13 +275,10 @@ interface ParticipantInfo {
     [key: string]: any;
 }
 
-type PubSubHandle = {
-    messages: ChatMessage[];
-    publish: (input: ChatInput) => void;
-};
 type MeetingContextValue = {
     sdk: VideoSDKCore;
     join: (config?: Omit<MeetingConfig, "participantId">) => Promise<void>;
+    getJoinState: (roomCode: string) => Promise<JoinState>;
     leave: () => void;
     createRoom: (input: {
         name: string;
@@ -297,7 +304,8 @@ type MeetingContextValue = {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => PubSubHandle;
+    usePubSub: <T = unknown>(topic: PubSubTopic) => PubSubHandle<T>;
+    onPubSubMessage: <T = unknown>(topic: PubSubTopic, cb: (message: PubSubMessage<T>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -333,6 +341,7 @@ declare const useMeeting: (handlers?: {
     onConnectionStateChanged?: (state: SFUConnectionState) => void;
 }) => {
     join: (config?: Omit<MeetingConfig, "participantId">) => Promise<void>;
+    getJoinState: (roomCode: string) => Promise<JoinState>;
     leave: () => void;
     createRoom: (input: {
         name: string;
@@ -358,10 +367,8 @@ declare const useMeeting: (handlers?: {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => {
-        messages: ChatMessage[];
-        publish: (input: ChatInput) => void;
-    };
+    usePubSub: <T = unknown>(topic: PubSubTopic) => PubSubHandle<T>;
+    onPubSubMessage: <T = unknown>(topic: PubSubTopic, cb: (message: PubSubMessage<T>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -456,4 +463,8 @@ declare class ActiveSpeakerDetector {
     destroy(): Promise<void>;
 }
 
-export { ActiveSpeakerDetector, type ChatInput, type MeetingConfig, MeetingProvider, MeetingState, type Participant, type ParticipantInfo, type Reaction, type RecordingInfo, type SFUConnectionState, type TrackInfo, VideoSDKCore, useLocalParticipant, useMeeting, useMeetingContext, useMeetingPreview, useParticipants, useRemoteMedia };
+declare function usePubSub<T = unknown>(topic: PubSubTopic, options?: {
+    onMessageReceived?: (message: PubSubMessage<T>) => void;
+}): PubSubHandle<T>;
+
+export { ActiveSpeakerDetector, type ChatInput, type MeetingConfig, MeetingProvider, MeetingState, type Participant, type ParticipantInfo, type Reaction, type RecordingInfo, type SFUConnectionState, type TrackInfo, VideoSDKCore, useLocalParticipant, useMeeting, useMeetingContext, useMeetingPreview, useParticipants, usePubSub, useRemoteMedia };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   useMeetingContext: () => useMeetingContext,
   useMeetingPreview: () => useMeetingPreview,
   useParticipants: () => useParticipants,
+  usePubSub: () => usePubSub,
   useRemoteMedia: () => useRemoteMedia
 });
 module.exports = __toCommonJS(index_exports);
@@ -596,6 +597,11 @@ var SFUClient = class {
       `${this.apiBase}/rooms/${encodeURIComponent(roomCode)}`
     );
   }
+  async getJoinState(roomCode) {
+    return this.request(
+      `${this.apiBase}/rooms/${encodeURIComponent(roomCode)}/join-state`
+    );
+  }
   async deleteRoom(roomCode) {
     return this.request(
       `${this.apiBase}/rooms/${encodeURIComponent(roomCode)}`,
@@ -2054,6 +2060,14 @@ var VideoSDKCore = class {
     });
     return client.getRoom(roomCode);
   }
+  async getJoinState(roomCode) {
+    const client = this.sfuClient ?? new SFUClient({
+      apiBase: this.apiBase,
+      wsBase: this.wsBase,
+      participantId: this.myId
+    });
+    return client.getJoinState(roomCode);
+  }
   async deleteRoom(roomCode) {
     const client = this.sfuClient ?? new SFUClient({
       apiBase: this.apiBase,
@@ -2812,6 +2826,9 @@ var MeetingProvider = ({
   const recordingStartedListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
   const recordingStoppedListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
   const reactionListeners = (0, import_react2.useRef)(/* @__PURE__ */ new Set());
+  const pubSubListeners = (0, import_react2.useRef)(
+    /* @__PURE__ */ new Map()
+  );
   const activeSpeakerListeners = (0, import_react2.useRef)(
     /* @__PURE__ */ new Set()
   );
@@ -2847,6 +2864,19 @@ var MeetingProvider = ({
         },
         onReaction: (reaction) => {
           reactionListeners.current.forEach((fn) => fn(reaction));
+          const listeners = pubSubListeners.current.get("REACTION");
+          if (!listeners) return;
+          const message = {
+            id: reaction.id,
+            topic: "REACTION",
+            sender_id: reaction.participant_id,
+            sender_name: reaction.sender_name,
+            timestamp: typeof reaction.timestamp === "number" ? reaction.timestamp : Date.parse(reaction.timestamp),
+            data: {
+              emoji: reaction.emoji
+            }
+          };
+          listeners.forEach((fn) => fn(message));
         },
         onConnectionStateChanged: (state) => {
           connectionStateListeners.current.forEach(
@@ -2890,6 +2920,7 @@ var MeetingProvider = ({
         ...config,
         ...joinConfig
       }),
+      getJoinState: (roomCode) => sdk.getJoinState(roomCode),
       leave: () => sdk.disconnect(),
       createRoom: sdk.createRoom.bind(sdk),
       getRoom: sdk.getRoom.bind(sdk),
@@ -2908,12 +2939,48 @@ var MeetingProvider = ({
       activeSpeakerIds,
       recording,
       usePubSub: (topic) => {
-        if (topic !== "SECURE_CHAT") {
-          throw new Error(`Unsupported PubSub argument: "${topic}"`);
+        if (topic === "REACTION") {
+          return {
+            messages: [],
+            publish: (data) => {
+              const reaction = data;
+              if (!reaction?.emoji) {
+                console.warn("[PubSub] REACTION requires an emoji");
+                return;
+              }
+              sdk.sendReaction(reaction.emoji);
+            }
+          };
+        }
+        if (topic === "SECURE_CHAT") {
+          return {
+            messages: sdk.state.getChatMessages().map((message) => ({
+              id: message.id,
+              topic: "SECURE_CHAT",
+              sender_id: message.sender_id,
+              sender_name: message.sender_name,
+              timestamp: message.timestamp,
+              data: message
+            })),
+            publish: (data) => {
+              sdk.sendChatMessage(data);
+            }
+          };
+        }
+        throw new Error(`Unsupported PubSub topic: "${topic}"`);
+      },
+      onPubSubMessage: (topic, cb) => {
+        let listeners = pubSubListeners.current.get(topic);
+        if (!listeners) {
+          listeners = /* @__PURE__ */ new Set();
+          pubSubListeners.current.set(topic, listeners);
         }
-        return {
-          messages: sdk.state.getChatMessages(),
-          publish: sdk.sendChatMessage.bind(sdk)
+        listeners.add(cb);
+        return () => {
+          listeners?.delete(cb);
+          if (listeners?.size === 0) {
+            pubSubListeners.current.delete(topic);
+          }
         };
       },
       approveJoinRequest: sdk.approveJoinRequest.bind(sdk),
@@ -3212,6 +3279,17 @@ function useMeetingPreview(roomId, participantId) {
     error
   };
 }
+
+// src/react/usePubSub.ts
+var import_react8 = require("react");
+function usePubSub(topic, options) {
+  const ctx = useMeetingContext();
+  (0, import_react8.useEffect)(() => {
+    if (!options?.onMessageReceived) return;
+    return ctx.onPubSubMessage(topic, options.onMessageReceived);
+  }, [ctx, topic, options?.onMessageReceived]);
+  return ctx.usePubSub(topic);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActiveSpeakerDetector,
@@ -3223,6 +3301,7 @@ function useMeetingPreview(roomId, participantId) {
   useMeetingContext,
   useMeetingPreview,
   useParticipants,
+  usePubSub,
   useRemoteMedia
 });
 //# sourceMappingURL=index.js.map