@defcomm/meetingsdk 0.4.3 → 0.4.5

package/dist/index.d.mts

@@ -59,6 +59,34 @@ 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 PubSubTopicConfig = {
+    SECURE_CHAT: {
+        publish: ChatInput;
+        message: ChatMessage;
+    };
+    REACTION: {
+        publish: {
+            emoji: string;
+        };
+        message: {
+            emoji: string;
+        };
+    };
+};
+type PubSubTopic = keyof PubSubTopicConfig;
+type PubSubHandle<TPublish = unknown, TMessage = TPublish> = {
+    messages: PubSubMessage<TMessage>[];
+    publish: (data: TPublish) => void;
+};
+type PubSubHandleForTopic<T extends PubSubTopic> = PubSubHandle<PubSubTopicConfig[T]["publish"], PubSubTopicConfig[T]["message"]>;
 type Participant = {
     id: string;
     name?: string;
@@ -97,7 +125,6 @@ type MeetingConfig = {
     videoMuted?: boolean;
     token?: string;
 };
-type PubSubTopic = "SECURE_CHAT" | "REACTION";
 type RecordingInfo = {
     recording_id: string;
     started_at?: string;
@@ -241,6 +268,15 @@ declare class VideoSDKCore {
     }>;
     sendChatMessage(payload: ChatInput): void;
     sendReaction(reaction: string): void;
+    /**
+     * Generic PubSub publishing entry point.
+     *
+     * The public SDK exposes one PubSub API for all topics. The current SFU
+     * protocol still has dedicated wire messages for chat and reactions, so
+     * this method is the compatibility bridge. The application does not need
+     * to know about those wire-level message types.
+     */
+    publishPubSub<T extends PubSubTopic>(topic: T, data: PubSubTopicConfig[T]["publish"]): void;
     private cleanupRemoteParticipant;
     disconnect(): Promise<void>;
     private performDisconnect;
@@ -263,10 +299,6 @@ interface ParticipantInfo {
     [key: string]: any;
 }
 
-type PubSubHandle = {
-    messages: ChatMessage[];
-    publish: (input: ChatInput) => void;
-};
 type MeetingContextValue = {
     sdk: VideoSDKCore;
     join: (config?: Omit<MeetingConfig, "participantId">) => Promise<void>;
@@ -296,7 +328,8 @@ type MeetingContextValue = {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => PubSubHandle;
+    usePubSub: <T extends PubSubTopic>(topic: T) => PubSubHandleForTopic<T>;
+    onPubSubMessage: <T extends PubSubTopic>(topic: T, cb: (message: PubSubMessage<PubSubTopicConfig[T]["message"]>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -358,10 +391,8 @@ declare const useMeeting: (handlers?: {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => {
-        messages: ChatMessage[];
-        publish: (input: ChatInput) => void;
-    };
+    usePubSub: <T extends PubSubTopic>(topic: T) => PubSubHandleForTopic<T>;
+    onPubSubMessage: <T extends PubSubTopic>(topic: T, cb: (message: PubSubMessage<PubSubTopicConfig[T]["message"]>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -456,4 +487,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 extends PubSubTopic>(topic: T, options?: {
+    onMessageReceived?: (message: PubSubMessage<PubSubTopicConfig[T]["message"]>) => void;
+}): PubSubHandleForTopic<T>;
+
+export { ActiveSpeakerDetector, type ChatInput, type MeetingConfig, MeetingProvider, MeetingState, type Participant, type ParticipantInfo, type PubSubHandle, type PubSubHandleForTopic, type PubSubMessage, type PubSubTopic, type PubSubTopicConfig, type Reaction, type RecordingInfo, type SFUConnectionState, type TrackInfo, VideoSDKCore, useLocalParticipant, useMeeting, useMeetingContext, useMeetingPreview, useParticipants, usePubSub, useRemoteMedia };

package/dist/index.d.ts

@@ -59,6 +59,34 @@ 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 PubSubTopicConfig = {
+    SECURE_CHAT: {
+        publish: ChatInput;
+        message: ChatMessage;
+    };
+    REACTION: {
+        publish: {
+            emoji: string;
+        };
+        message: {
+            emoji: string;
+        };
+    };
+};
+type PubSubTopic = keyof PubSubTopicConfig;
+type PubSubHandle<TPublish = unknown, TMessage = TPublish> = {
+    messages: PubSubMessage<TMessage>[];
+    publish: (data: TPublish) => void;
+};
+type PubSubHandleForTopic<T extends PubSubTopic> = PubSubHandle<PubSubTopicConfig[T]["publish"], PubSubTopicConfig[T]["message"]>;
 type Participant = {
     id: string;
     name?: string;
@@ -97,7 +125,6 @@ type MeetingConfig = {
     videoMuted?: boolean;
     token?: string;
 };
-type PubSubTopic = "SECURE_CHAT" | "REACTION";
 type RecordingInfo = {
     recording_id: string;
     started_at?: string;
@@ -241,6 +268,15 @@ declare class VideoSDKCore {
     }>;
     sendChatMessage(payload: ChatInput): void;
     sendReaction(reaction: string): void;
+    /**
+     * Generic PubSub publishing entry point.
+     *
+     * The public SDK exposes one PubSub API for all topics. The current SFU
+     * protocol still has dedicated wire messages for chat and reactions, so
+     * this method is the compatibility bridge. The application does not need
+     * to know about those wire-level message types.
+     */
+    publishPubSub<T extends PubSubTopic>(topic: T, data: PubSubTopicConfig[T]["publish"]): void;
     private cleanupRemoteParticipant;
     disconnect(): Promise<void>;
     private performDisconnect;
@@ -263,10 +299,6 @@ interface ParticipantInfo {
     [key: string]: any;
 }
 
-type PubSubHandle = {
-    messages: ChatMessage[];
-    publish: (input: ChatInput) => void;
-};
 type MeetingContextValue = {
     sdk: VideoSDKCore;
     join: (config?: Omit<MeetingConfig, "participantId">) => Promise<void>;
@@ -296,7 +328,8 @@ type MeetingContextValue = {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => PubSubHandle;
+    usePubSub: <T extends PubSubTopic>(topic: T) => PubSubHandleForTopic<T>;
+    onPubSubMessage: <T extends PubSubTopic>(topic: T, cb: (message: PubSubMessage<PubSubTopicConfig[T]["message"]>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -358,10 +391,8 @@ declare const useMeeting: (handlers?: {
     presenterId: string | null;
     activeSpeakerIds: string[];
     recording: RecordingInfo | null;
-    usePubSub: (topic: PubSubTopic) => {
-        messages: ChatMessage[];
-        publish: (input: ChatInput) => void;
-    };
+    usePubSub: <T extends PubSubTopic>(topic: T) => PubSubHandleForTopic<T>;
+    onPubSubMessage: <T extends PubSubTopic>(topic: T, cb: (message: PubSubMessage<PubSubTopicConfig[T]["message"]>) => void) => () => void;
     approveJoinRequest: (requestId: string) => void;
     rejectJoinRequest: (requestId: string) => void;
     startRecording: () => Promise<void>;
@@ -456,4 +487,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 extends PubSubTopic>(topic: T, options?: {
+    onMessageReceived?: (message: PubSubMessage<PubSubTopicConfig[T]["message"]>) => void;
+}): PubSubHandleForTopic<T>;
+
+export { ActiveSpeakerDetector, type ChatInput, type MeetingConfig, MeetingProvider, MeetingState, type Participant, type ParticipantInfo, type PubSubHandle, type PubSubHandleForTopic, type PubSubMessage, type PubSubTopic, type PubSubTopicConfig, 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);
@@ -2738,6 +2739,28 @@ var VideoSDKCore = class {
     }
     this.sfuClient.sendReaction(reaction);
   }
+  /**
+   * Generic PubSub publishing entry point.
+   *
+   * The public SDK exposes one PubSub API for all topics. The current SFU
+   * protocol still has dedicated wire messages for chat and reactions, so
+   * this method is the compatibility bridge. The application does not need
+   * to know about those wire-level message types.
+   */
+  publishPubSub(topic, data) {
+    switch (topic) {
+      case "SECURE_CHAT":
+        this.sendChatMessage(data);
+        return;
+      case "REACTION":
+        this.sendReaction(data.emoji);
+        return;
+      default: {
+        const exhaustive = topic;
+        throw new Error(`Unsupported PubSub topic: ${exhaustive}`);
+      }
+    }
+  }
   // CLEANUP
   cleanupRemoteParticipant(participantId) {
     this.activeSpeakerDetector.removeParticipant(participantId);
@@ -2825,6 +2848,10 @@ 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 [reactionPubSubMessages, setReactionPubSubMessages] = (0, import_react2.useState)([]);
   const activeSpeakerListeners = (0, import_react2.useRef)(
     /* @__PURE__ */ new Set()
   );
@@ -2858,8 +2885,43 @@ var MeetingProvider = ({
         onRecordingStopped: (recording2) => {
           recordingStoppedListeners.current.forEach((fn) => fn(recording2));
         },
+        onChatMessage: (message) => {
+          const msg = {
+            id: message.id,
+            text: message.text,
+            sender_id: message.sender_id,
+            sender_name: message.sender_name,
+            timestamp: Number(message.timestamp),
+            reply_to: message.reply_to ?? null,
+            target: message.target ?? null
+          };
+          const pubSubMessage = {
+            id: msg.id,
+            topic: "SECURE_CHAT",
+            sender_id: msg.sender_id,
+            sender_name: msg.sender_name,
+            timestamp: msg.timestamp,
+            data: msg
+          };
+          pubSubListeners.current.get("SECURE_CHAT")?.forEach((fn) => fn(pubSubMessage));
+        },
         onReaction: (reaction) => {
           reactionListeners.current.forEach((fn) => fn(reaction));
+          const timestamp = typeof reaction.timestamp === "number" ? reaction.timestamp : Date.parse(reaction.timestamp);
+          const message = {
+            id: reaction.id,
+            topic: "REACTION",
+            sender_id: reaction.participant_id,
+            sender_name: reaction.sender_name,
+            timestamp,
+            data: {
+              emoji: reaction.emoji
+            }
+          };
+          setReactionPubSubMessages(
+            (previous) => [...previous, message].slice(-50)
+          );
+          pubSubListeners.current.get("REACTION")?.forEach((fn) => fn(message));
         },
         onConnectionStateChanged: (state) => {
           connectionStateListeners.current.forEach(
@@ -2922,12 +2984,48 @@ var MeetingProvider = ({
       activeSpeakerIds,
       recording,
       usePubSub: (topic) => {
-        if (topic !== "SECURE_CHAT") {
-          throw new Error(`Unsupported PubSub argument: "${topic}"`);
+        if (topic === "SECURE_CHAT") {
+          const chatMessages = messages.map((message) => ({
+            id: message.id,
+            topic: "SECURE_CHAT",
+            sender_id: message.sender_id,
+            sender_name: message.sender_name,
+            timestamp: message.timestamp,
+            data: message
+          }));
+          return {
+            messages: chatMessages,
+            publish: ((data) => {
+              sdk.publishPubSub("SECURE_CHAT", data);
+            })
+          };
         }
-        return {
-          messages: sdk.state.getChatMessages(),
-          publish: sdk.sendChatMessage.bind(sdk)
+        if (topic === "REACTION") {
+          return {
+            messages: reactionPubSubMessages,
+            publish: ((data) => {
+              if (!data?.emoji) {
+                console.warn("[PubSub] REACTION requires an emoji");
+                return;
+              }
+              sdk.publishPubSub("REACTION", 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);
+        }
+        listeners.add(cb);
+        return () => {
+          listeners?.delete(cb);
+          if (listeners?.size === 0) {
+            pubSubListeners.current.delete(topic);
+          }
         };
       },
       approveJoinRequest: sdk.approveJoinRequest.bind(sdk),
@@ -2996,7 +3094,8 @@ var MeetingProvider = ({
     messages,
     presenterId,
     recording,
-    activeSpeakerIds
+    activeSpeakerIds,
+    reactionPubSubMessages
   ]);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MeetingContext.Provider, { value, children });
 };
@@ -3226,6 +3325,20 @@ 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,
@@ -3237,6 +3350,7 @@ function useMeetingPreview(roomId, participantId) {
   useMeetingContext,
   useMeetingPreview,
   useParticipants,
+  usePubSub,
   useRemoteMedia
 });
 //# sourceMappingURL=index.js.map