@defcomm/meetingsdk 0.6.2 → 0.6.3

package/dist/index.d.mts

@@ -30,6 +30,7 @@ type Events = {
     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;
@@ -104,6 +105,7 @@ type Participant = {
     isLocal?: boolean;
     media?: ParticipantMedia;
     isPresenter?: boolean;
+    handRaised?: boolean;
     connectionState?: "connected" | "reconnecting" | "disconnected";
 };
 type ParticipantMedia = {
@@ -239,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;
 }
@@ -260,6 +263,7 @@ type LocalParticipantPatch = {
     name?: string;
     isHost?: boolean;
     isModerator?: boolean;
+    handRaised?: boolean;
     permissions?: any;
     media?: Partial<ParticipantMedia>;
 };
@@ -284,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;
@@ -359,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.
      *
@@ -417,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;
@@ -453,6 +462,7 @@ 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;
@@ -478,6 +488,7 @@ 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;
@@ -509,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;
@@ -545,6 +558,7 @@ 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;

package/dist/index.d.ts

@@ -30,6 +30,7 @@ type Events = {
     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;
@@ -104,6 +105,7 @@ type Participant = {
     isLocal?: boolean;
     media?: ParticipantMedia;
     isPresenter?: boolean;
+    handRaised?: boolean;
     connectionState?: "connected" | "reconnecting" | "disconnected";
 };
 type ParticipantMedia = {
@@ -239,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;
 }
@@ -260,6 +263,7 @@ type LocalParticipantPatch = {
     name?: string;
     isHost?: boolean;
     isModerator?: boolean;
+    handRaised?: boolean;
     permissions?: any;
     media?: Partial<ParticipantMedia>;
 };
@@ -284,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;
@@ -359,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.
      *
@@ -417,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;
@@ -453,6 +462,7 @@ 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;
@@ -478,6 +488,7 @@ 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;
@@ -509,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;
@@ -545,6 +558,7 @@ 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;

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: {
@@ -3145,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.
    *
@@ -3265,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()
   );
@@ -3368,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));
         },
@@ -3440,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,
@@ -3565,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);
@@ -3732,6 +3794,10 @@ var useMeeting = (handlers) => {
     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;
 };