@defcomm/meetingsdk 0.6.1 → 0.6.3

package/dist/index.d.mts

@@ -9,6 +9,8 @@ type Events = {
     onTrack?: (stream: MediaStream, peerId: string) => void;
     onScreenTrack?: (stream: MediaStream, peerId: string) => void;
     onUserJoined?: (p: Participant) => void;
+    /** Fired when a remote participant permanently joins the meeting. */
+    onParticipantJoined?: (p: Participant) => void;
     onEntryRequested?: (req: EntryRequest) => void;
     onEntryResponded?: (payload: {
         participantId: string;
@@ -23,9 +25,12 @@ type Events = {
     onConnectionStateChanged?: (state: string) => void;
     onRoomUpdate?: (data: any) => void;
     onUserLeft?: (id: string) => void;
+    /** Fired when a remote participant permanently leaves the meeting. */
+    onParticipantLeft?: (p: Participant) => void;
     onMeetingLeft?: () => void;
     onChatMessage?: (msg: ChatMessage) => void;
     onReaction?: (reaction: Reaction) => void;
+    onHandRaised?: (participantId: string, raised: boolean) => void;
     onNetworkQuality?: (quality: NetworkQuality) => void;
     onScreenShareStarted?: (peerId: string, stream: MediaStream) => void;
     onScreenShareStopped?: (peerId: string) => void;
@@ -100,6 +105,7 @@ type Participant = {
     isLocal?: boolean;
     media?: ParticipantMedia;
     isPresenter?: boolean;
+    handRaised?: boolean;
     connectionState?: "connected" | "reconnecting" | "disconnected";
 };
 type ParticipantMedia = {
@@ -235,6 +241,7 @@ interface VideoSDKCoreOptions {
     onRoomUpdate?: (data: any) => void;
     onChatMessage?: (message: ChatMessage) => void;
     onReaction?: (reaction: Reaction) => void;
+    onHandRaised?: (participantId: string, raised: boolean) => void;
     onNetworkQuality?: (quality: NetworkQuality) => void;
     onMuteStateChanged?: (peerId: string, kind: "audio" | "video", muted: boolean) => void;
 }
@@ -256,6 +263,7 @@ type LocalParticipantPatch = {
     name?: string;
     isHost?: boolean;
     isModerator?: boolean;
+    handRaised?: boolean;
     permissions?: any;
     media?: Partial<ParticipantMedia>;
 };
@@ -280,6 +288,7 @@ declare class MeetingState {
     removeParticipant(id: string): void;
     updateParticipantMedia(id: string, patch: Partial<NonNullable<Participant["media"]>>): void;
     updateLocalParticipant(patch: LocalParticipantPatch): void;
+    setParticipantHandRaised(id: string, raised: boolean): void;
     addChatMessage(msg: ChatMessage): void;
     getChatMessages(): ChatMessage[];
     clearChat(): void;
@@ -355,6 +364,8 @@ declare class VideoSDKCore {
     }>;
     sendChatMessage(payload: ChatInput): void;
     sendReaction(reaction: string): void;
+    setHandRaised(raised: boolean): void;
+    toggleHandRaised(): void;
     /**
      * Generic PubSub publishing entry point.
      *
@@ -413,6 +424,8 @@ type MeetingContextValue = {
     stopScreenShare: () => void;
     sendMessage: (input: ChatInput) => void;
     sendReaction: (emoji: string) => void;
+    setHandRaised: (raised: boolean) => void;
+    toggleHandRaised: () => void;
     room: {
         id: string | null;
         name: string | null;
@@ -449,9 +462,13 @@ type MeetingContextValue = {
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
     onReaction: (cb: (reaction: Reaction) => void) => () => void;
+    onHandRaised: (cb: (participantId: string, raised: boolean) => void) => () => void;
     onConnectionStateChanged: (cb: (state: SFUConnectionState) => void) => () => void;
     onActiveSpeakersChanged: (cb: (participantIds: string[]) => void) => () => void;
     onNetworkQuality: (cb: (quality: NetworkQuality) => void) => () => void;
+    onChatMessage: (cb: (message: ChatMessage) => void) => () => void;
+    onParticipantJoined: (cb: (participant: Participant) => void) => () => void;
+    onParticipantLeft: (cb: (participant: Participant) => void) => () => void;
 };
 declare const MeetingProvider: ({ config, children, }: {
     config: MeetingConfig;
@@ -471,9 +488,13 @@ declare const useMeeting: (handlers?: {
     onRecordingStarted?: (recording: any) => void;
     onRecordingStopped?: (recording: any) => void;
     onReaction?: (reaction: any) => void;
+    onHandRaised?: (participantId: string, raised: boolean) => void;
     onActiveSpeakersChanged?: (participantIds: string[]) => void;
     onConnectionStateChanged?: (state: SFUConnectionState) => void;
     onNetworkQuality?: (quality: NetworkQuality) => void;
+    onParticipantJoined?: (participant: Participant) => void;
+    onParticipantLeft?: (participant: Participant) => void;
+    onChatMessage?: (message: ChatMessage) => void;
 }) => {
     join: (config?: Omit<MeetingConfig, "participantId" | "token">) => Promise<void>;
     getJoinState: (roomCode: string) => Promise<JoinState>;
@@ -499,6 +520,8 @@ declare const useMeeting: (handlers?: {
     stopScreenShare: () => void;
     sendMessage: (input: ChatInput) => void;
     sendReaction: (emoji: string) => void;
+    setHandRaised: (raised: boolean) => void;
+    toggleHandRaised: () => void;
     room: {
         id: string | null;
         name: string | null;
@@ -535,9 +558,13 @@ declare const useMeeting: (handlers?: {
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
     onReaction: (cb: (reaction: Reaction) => void) => () => void;
+    onHandRaised: (cb: (participantId: string, raised: boolean) => void) => () => void;
     onConnectionStateChanged: (cb: (state: SFUConnectionState) => void) => () => void;
     onActiveSpeakersChanged: (cb: (participantIds: string[]) => void) => () => void;
     onNetworkQuality: (cb: (quality: NetworkQuality) => void) => () => void;
+    onChatMessage: (cb: (message: ChatMessage) => void) => () => void;
+    onParticipantJoined: (cb: (participant: Participant) => void) => () => void;
+    onParticipantLeft: (cb: (participant: Participant) => void) => () => void;
 };
 
 declare const useParticipants: () => Participant[];

package/dist/index.d.ts

@@ -9,6 +9,8 @@ type Events = {
     onTrack?: (stream: MediaStream, peerId: string) => void;
     onScreenTrack?: (stream: MediaStream, peerId: string) => void;
     onUserJoined?: (p: Participant) => void;
+    /** Fired when a remote participant permanently joins the meeting. */
+    onParticipantJoined?: (p: Participant) => void;
     onEntryRequested?: (req: EntryRequest) => void;
     onEntryResponded?: (payload: {
         participantId: string;
@@ -23,9 +25,12 @@ type Events = {
     onConnectionStateChanged?: (state: string) => void;
     onRoomUpdate?: (data: any) => void;
     onUserLeft?: (id: string) => void;
+    /** Fired when a remote participant permanently leaves the meeting. */
+    onParticipantLeft?: (p: Participant) => void;
     onMeetingLeft?: () => void;
     onChatMessage?: (msg: ChatMessage) => void;
     onReaction?: (reaction: Reaction) => void;
+    onHandRaised?: (participantId: string, raised: boolean) => void;
     onNetworkQuality?: (quality: NetworkQuality) => void;
     onScreenShareStarted?: (peerId: string, stream: MediaStream) => void;
     onScreenShareStopped?: (peerId: string) => void;
@@ -100,6 +105,7 @@ type Participant = {
     isLocal?: boolean;
     media?: ParticipantMedia;
     isPresenter?: boolean;
+    handRaised?: boolean;
     connectionState?: "connected" | "reconnecting" | "disconnected";
 };
 type ParticipantMedia = {
@@ -235,6 +241,7 @@ interface VideoSDKCoreOptions {
     onRoomUpdate?: (data: any) => void;
     onChatMessage?: (message: ChatMessage) => void;
     onReaction?: (reaction: Reaction) => void;
+    onHandRaised?: (participantId: string, raised: boolean) => void;
     onNetworkQuality?: (quality: NetworkQuality) => void;
     onMuteStateChanged?: (peerId: string, kind: "audio" | "video", muted: boolean) => void;
 }
@@ -256,6 +263,7 @@ type LocalParticipantPatch = {
     name?: string;
     isHost?: boolean;
     isModerator?: boolean;
+    handRaised?: boolean;
     permissions?: any;
     media?: Partial<ParticipantMedia>;
 };
@@ -280,6 +288,7 @@ declare class MeetingState {
     removeParticipant(id: string): void;
     updateParticipantMedia(id: string, patch: Partial<NonNullable<Participant["media"]>>): void;
     updateLocalParticipant(patch: LocalParticipantPatch): void;
+    setParticipantHandRaised(id: string, raised: boolean): void;
     addChatMessage(msg: ChatMessage): void;
     getChatMessages(): ChatMessage[];
     clearChat(): void;
@@ -355,6 +364,8 @@ declare class VideoSDKCore {
     }>;
     sendChatMessage(payload: ChatInput): void;
     sendReaction(reaction: string): void;
+    setHandRaised(raised: boolean): void;
+    toggleHandRaised(): void;
     /**
      * Generic PubSub publishing entry point.
      *
@@ -413,6 +424,8 @@ type MeetingContextValue = {
     stopScreenShare: () => void;
     sendMessage: (input: ChatInput) => void;
     sendReaction: (emoji: string) => void;
+    setHandRaised: (raised: boolean) => void;
+    toggleHandRaised: () => void;
     room: {
         id: string | null;
         name: string | null;
@@ -449,9 +462,13 @@ type MeetingContextValue = {
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
     onReaction: (cb: (reaction: Reaction) => void) => () => void;
+    onHandRaised: (cb: (participantId: string, raised: boolean) => void) => () => void;
     onConnectionStateChanged: (cb: (state: SFUConnectionState) => void) => () => void;
     onActiveSpeakersChanged: (cb: (participantIds: string[]) => void) => () => void;
     onNetworkQuality: (cb: (quality: NetworkQuality) => void) => () => void;
+    onChatMessage: (cb: (message: ChatMessage) => void) => () => void;
+    onParticipantJoined: (cb: (participant: Participant) => void) => () => void;
+    onParticipantLeft: (cb: (participant: Participant) => void) => () => void;
 };
 declare const MeetingProvider: ({ config, children, }: {
     config: MeetingConfig;
@@ -471,9 +488,13 @@ declare const useMeeting: (handlers?: {
     onRecordingStarted?: (recording: any) => void;
     onRecordingStopped?: (recording: any) => void;
     onReaction?: (reaction: any) => void;
+    onHandRaised?: (participantId: string, raised: boolean) => void;
     onActiveSpeakersChanged?: (participantIds: string[]) => void;
     onConnectionStateChanged?: (state: SFUConnectionState) => void;
     onNetworkQuality?: (quality: NetworkQuality) => void;
+    onParticipantJoined?: (participant: Participant) => void;
+    onParticipantLeft?: (participant: Participant) => void;
+    onChatMessage?: (message: ChatMessage) => void;
 }) => {
     join: (config?: Omit<MeetingConfig, "participantId" | "token">) => Promise<void>;
     getJoinState: (roomCode: string) => Promise<JoinState>;
@@ -499,6 +520,8 @@ declare const useMeeting: (handlers?: {
     stopScreenShare: () => void;
     sendMessage: (input: ChatInput) => void;
     sendReaction: (emoji: string) => void;
+    setHandRaised: (raised: boolean) => void;
+    toggleHandRaised: () => void;
     room: {
         id: string | null;
         name: string | null;
@@ -535,9 +558,13 @@ declare const useMeeting: (handlers?: {
     onRecordingStarted: (cb: (recording: Recording) => void) => () => void;
     onRecordingStopped: (cb: (recording: any) => void) => () => void;
     onReaction: (cb: (reaction: Reaction) => void) => () => void;
+    onHandRaised: (cb: (participantId: string, raised: boolean) => void) => () => void;
     onConnectionStateChanged: (cb: (state: SFUConnectionState) => void) => () => void;
     onActiveSpeakersChanged: (cb: (participantIds: string[]) => void) => () => void;
     onNetworkQuality: (cb: (quality: NetworkQuality) => void) => () => void;
+    onChatMessage: (cb: (message: ChatMessage) => void) => () => void;
+    onParticipantJoined: (cb: (participant: Participant) => void) => () => void;
+    onParticipantLeft: (cb: (participant: Participant) => void) => () => void;
 };
 
 declare const useParticipants: () => Participant[];

package/dist/index.js

@@ -317,6 +317,7 @@ var MeetingState = class {
         name: patch.name ?? "",
         isHost: patch.isHost ?? false,
         isModerator: patch.isModerator ?? false,
+        handRaised: patch.handRaised ?? false,
         permissions: patch.permissions,
         media: {
           stream: patch.media?.stream ?? null,
@@ -364,6 +365,21 @@ var MeetingState = class {
     };
     this.notify("localParticipant");
   }
+  setParticipantHandRaised(id, raised) {
+    const p = id === this.localParticipant?.id ? this.localParticipant : this.participants.get(id);
+    if (!p || p.handRaised === raised) return;
+    const updated = { ...p, handRaised: raised };
+    if (id === this.localParticipant?.id) {
+      this.localParticipant = updated;
+      this.notify("localParticipant");
+    } else {
+      const next = new Map(this.participants);
+      next.set(id, updated);
+      this.participants = next;
+      this.notify(`participant:${id}`);
+      this.notify("participants");
+    }
+  }
   // ---- chat ----
   addChatMessage(msg) {
     this.chatMessages.set(msg.id, msg);
@@ -512,6 +528,8 @@ var SFUClient = class {
     });
     this.onReaction = options.onReaction || (() => {
     });
+    this.onHandRaised = options.onHandRaised || (() => {
+    });
     this.onRoomUpdate = options.onRoomUpdate || (() => {
     });
     this.onNetworkQuality = options.onNetworkQuality || (() => {
@@ -1110,6 +1128,12 @@ var SFUClient = class {
         if (reaction?.id && reaction?.emoji) this.onReaction(reaction);
         break;
       }
+      case "hand_raised": {
+        const participantId = String(payload.participant_id ?? payload.participantId ?? "");
+        const raised = Boolean(payload.raised);
+        if (participantId) this.onHandRaised(participantId, raised);
+        break;
+      }
       case "network_quality": {
         const raw = payload.quality || payload;
         const quality = {
@@ -2035,6 +2059,14 @@ var SFUClient = class {
       }
     });
   }
+  setHandRaised(raised) {
+    this.send({
+      type: "set_hand_raised",
+      payload: {
+        raised
+      }
+    });
+  }
   removeRemoteParticipant(participantId) {
     const stream = this.remoteStreams.get(participantId);
     if (stream) {
@@ -2469,6 +2501,7 @@ var VideoSDKCore = class {
           isHost,
           isModerator,
           permissions,
+          handRaised: Boolean(local?.hand_raised),
           media: {
             micEnabled: !Boolean(local?.audio_muted),
             camEnabled: !Boolean(local?.video_muted)
@@ -2496,6 +2529,7 @@ var VideoSDKCore = class {
           this.state.updateLocalParticipant({
             id: this.myId,
             name: this.participantName,
+            handRaised: Boolean(local.hand_raised),
             media: {
               micEnabled: !Boolean(local.audio_muted),
               camEnabled: !Boolean(local.video_muted),
@@ -2574,6 +2608,10 @@ var VideoSDKCore = class {
       onReaction: (reaction) => {
         this.events.onReaction?.(reaction);
       },
+      onHandRaised: (participantId, raised) => {
+        this.state.setParticipantHandRaised(participantId, raised);
+        this.events.onHandRaised?.(participantId, raised);
+      },
       onJoinRequestCanceled: (requestId) => {
         this.events.onJoinRequestCanceled?.(requestId);
       },
@@ -2599,6 +2637,7 @@ var VideoSDKCore = class {
             id: this.myId,
             name: this.participantName,
             isHost: current?.isHost,
+            handRaised: current?.handRaised,
             isModerator: Boolean(permissions?.moderate),
             permissions
           });
@@ -2628,6 +2667,7 @@ var VideoSDKCore = class {
           id: pid,
           name: pname,
           isModerator: Boolean(participant?.permissions?.moderate),
+          handRaised: Boolean(participant?.hand_raised),
           permissions: participant?.permissions,
           connectionState: "connected",
           media: {
@@ -2637,10 +2677,12 @@ var VideoSDKCore = class {
             stream: null
           }
         });
-        this.events.onUserJoined?.({
+        const joinedParticipant = this.state.getParticipant(pid) ?? {
           id: pid,
           name: pname
-        });
+        };
+        this.events.onUserJoined?.(joinedParticipant);
+        this.events.onParticipantJoined?.(joinedParticipant);
       },
       onParticipantPresence: (participantId, presence) => {
         if (participantId === this.myId) {
@@ -2669,9 +2711,11 @@ var VideoSDKCore = class {
           return;
         }
         console.log("[SFU] Participant permanently left", pid);
+        const leavingParticipant = this.state.getParticipant(pid) ?? { id: pid };
         this.cleanupRemoteParticipant(pid);
         this.state.removeParticipant(pid);
         this.events.onUserLeft?.(pid);
+        this.events.onParticipantLeft?.(leavingParticipant);
       },
       // TRACKS
       onParticipantMediaState: (participantId, audioMuted, videoMuted) => {
@@ -3141,6 +3185,16 @@ var VideoSDKCore = class {
     }
     this.sfuClient.sendReaction(reaction);
   }
+  setHandRaised(raised) {
+    if (!this.sfuClient) {
+      console.warn("SFU Client not connected");
+      return;
+    }
+    this.sfuClient.setHandRaised(raised);
+  }
+  toggleHandRaised() {
+    this.setHandRaised(!Boolean(this.state.localParticipant?.handRaised));
+  }
   /**
    * Generic PubSub publishing entry point.
    *
@@ -3261,6 +3315,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 handRaisedListeners = (0, import_react2.useRef)(
+    /* @__PURE__ */ new Set()
+  );
   const pubSubListeners = (0, import_react2.useRef)(
     /* @__PURE__ */ new Map()
   );
@@ -3274,6 +3331,15 @@ var MeetingProvider = ({
   const connectionStateListeners = (0, import_react2.useRef)(
     /* @__PURE__ */ new Set()
   );
+  const participantJoinedListeners = (0, import_react2.useRef)(
+    /* @__PURE__ */ new Set()
+  );
+  const participantLeftListeners = (0, import_react2.useRef)(
+    /* @__PURE__ */ new Set()
+  );
+  const chatMessageListeners = (0, import_react2.useRef)(
+    /* @__PURE__ */ new Set()
+  );
   if (!sdkRef.current) {
     sdkRef.current = new VideoSDKCore(
       {
@@ -3334,6 +3400,7 @@ var MeetingProvider = ({
             data: msg
           };
           pubSubListeners.current.get("SECURE_CHAT")?.forEach((fn) => fn(pubSubMessage));
+          chatMessageListeners.current.forEach((fn) => fn(msg));
         },
         onReaction: (reaction) => {
           reactionListeners.current.forEach((fn) => fn(reaction));
@@ -3354,6 +3421,9 @@ var MeetingProvider = ({
           );
           pubSubListeners.current.get("REACTION")?.forEach((fn) => fn(message));
         },
+        onHandRaised: (participantId, raised) => {
+          handRaisedListeners.current.forEach((fn) => fn(participantId, raised));
+        },
         onNetworkQuality: (quality) => {
           networkQualityListeners.current.forEach((fn) => fn(quality));
         },
@@ -3361,6 +3431,12 @@ var MeetingProvider = ({
           connectionStateListeners.current.forEach(
             (fn) => fn(state)
           );
+        },
+        onParticipantJoined: (participant) => {
+          participantJoinedListeners.current.forEach((fn) => fn(participant));
+        },
+        onParticipantLeft: (participant) => {
+          participantLeftListeners.current.forEach((fn) => fn(participant));
         }
       }
     );
@@ -3420,6 +3496,8 @@ var MeetingProvider = ({
       stopScreenShare: sdk.stopScreenShare.bind(sdk),
       sendMessage: sdk.sendChatMessage.bind(sdk),
       sendReaction: sdk.sendReaction.bind(sdk),
+      setHandRaised: sdk.setHandRaised.bind(sdk),
+      toggleHandRaised: sdk.toggleHandRaised.bind(sdk),
       room: sdk.getMeeting(),
       localParticipant,
       participants,
@@ -3545,6 +3623,10 @@ var MeetingProvider = ({
         reactionListeners.current.add(cb);
         return () => reactionListeners.current.delete(cb);
       },
+      onHandRaised: (cb) => {
+        handRaisedListeners.current.add(cb);
+        return () => handRaisedListeners.current.delete(cb);
+      },
       onNetworkQuality: (cb) => {
         networkQualityListeners.current.add(cb);
         return () => networkQualityListeners.current.delete(cb);
@@ -3560,6 +3642,18 @@ var MeetingProvider = ({
         return () => {
           activeSpeakerListeners.current.delete(cb);
         };
+      },
+      onParticipantJoined: (cb) => {
+        participantJoinedListeners.current.add(cb);
+        return () => participantJoinedListeners.current.delete(cb);
+      },
+      onChatMessage: (cb) => {
+        chatMessageListeners.current.add(cb);
+        return () => chatMessageListeners.current.delete(cb);
+      },
+      onParticipantLeft: (cb) => {
+        participantLeftListeners.current.add(cb);
+        return () => participantLeftListeners.current.delete(cb);
       }
     };
   }, [
@@ -3684,10 +3778,26 @@ var useMeeting = (handlers) => {
     if (!handlers?.onNetworkQuality) return;
     return ctx.onNetworkQuality(handlers.onNetworkQuality);
   }, [handlers?.onNetworkQuality]);
+  (0, import_react4.useEffect)(() => {
+    if (!handlers?.onParticipantJoined) return;
+    return ctx.onParticipantJoined(handlers.onParticipantJoined);
+  }, [handlers?.onParticipantJoined]);
+  (0, import_react4.useEffect)(() => {
+    if (!handlers?.onParticipantLeft) return;
+    return ctx.onParticipantLeft(handlers.onParticipantLeft);
+  }, [handlers?.onParticipantLeft]);
+  (0, import_react4.useEffect)(() => {
+    if (!handlers?.onChatMessage) return;
+    return ctx.onChatMessage(handlers.onChatMessage);
+  }, [handlers?.onChatMessage]);
   (0, import_react4.useEffect)(() => {
     if (!handlers?.onReaction) return;
     return ctx.onReaction(handlers.onReaction);
   }, [handlers?.onReaction]);
+  (0, import_react4.useEffect)(() => {
+    if (!handlers?.onHandRaised) return;
+    return ctx.onHandRaised(handlers.onHandRaised);
+  }, [handlers?.onHandRaised]);
   const { sdk: _, ...publicApi } = ctx;
   return publicApi;
 };