@realtimexsco/live-chat 1.5.3 → 1.5.5

package/dist/index.d.mts

@@ -1921,7 +1921,7 @@ type AdminFeatureKey = "audioCall" | "videoCall" | "pushNotification" | "blockUs
  */
 declare function useAdminFeatureGate(feature: AdminFeatureKey): CallFeatureGate;
 
-declare const CallOverlay: () => React__default.ReactPortal | null;
+declare const CallOverlay: () => React__default.JSX.Element | null;
 
 interface IncomingCallDialogProps {
     /** Looped while the dialog is open. Omit for silent ringing. */
@@ -1989,6 +1989,16 @@ interface CallEndedPayload extends CallSummary {
 interface CallBusyPayload extends CallSummary {
     userId: string;
 }
+/**
+ * Group calls only (CALLS_API.md §3.1/§3.2): call_end from a group member
+ * is a *leave*, not a full hangup — the call keeps going for whoever's
+ * left. `activeParticipants` is the authoritative "who's still on this
+ * call" list; the call only becomes call_ended once that drops below two.
+ */
+interface CallParticipantLeftPayload extends CallSummary {
+    userId: string;
+    activeParticipants: string[];
+}
 interface CallHistoryEntry {
     _id: string;
     conversationId: string;
@@ -2027,19 +2037,22 @@ interface CallState {
     caller: CallParticipantSummary | null;
     participants: string[];
     error: string | null;
-    /** Caller side only — the channel being called, for the "Calling {name}" screen. */
-    callee: CallPeer | null;
+    /** Who/what to display for this call — the other person for a DM, the
+     * group for a group call. Set by startCall() (caller) or resolved from
+     * the conversation list on _receiveIncoming (callee). */
+    peer: CallPeer | null;
+    isGroupCall: boolean;
     /** Set on transition to in-call. Display-only (duration timer), not billing-accurate. */
     callStartedAt: number | null;
     /** Caller: create the room and start ringing everyone else. */
-    startCall: (conversationId: string, mode: CallMode, callee?: CallPeer) => Promise<void>;
+    startCall: (conversationId: string, mode: CallMode, peer?: CallPeer, isGroupCall?: boolean) => Promise<void>;
     /** Caller: stop ringing before anyone accepted. */
     cancelCall: () => void;
     /** Callee: accept the ringing call and fetch a join token. */
     acceptCall: () => Promise<void>;
     /** Callee: decline the ringing call. */
     rejectCall: (reason?: string) => void;
-    /** Either side: leave/end a live call. */
+    /** Either side: leave/end a live call (group calls: leave, others continue). */
     endCall: () => void;
     /** Drop back to idle without notifying anyone (e.g. after a fatal error). */
     reset: () => void;
@@ -2057,6 +2070,7 @@ interface CallState {
     _receiveRejected: (payload: CallRejectedPayload) => void;
     _receiveCancelled: (payload: CallCancelledPayload) => void;
     _receiveEnded: (payload: CallEndedPayload) => void;
+    _receiveParticipantLeft: (payload: CallParticipantLeftPayload) => void;
     _receiveBusy: (payload: CallBusyPayload) => void;
     _receiveMissed: (payload: CallSummary) => void;
 }

package/dist/index.d.ts

@@ -1921,7 +1921,7 @@ type AdminFeatureKey = "audioCall" | "videoCall" | "pushNotification" | "blockUs
  */
 declare function useAdminFeatureGate(feature: AdminFeatureKey): CallFeatureGate;
 
-declare const CallOverlay: () => React__default.ReactPortal | null;
+declare const CallOverlay: () => React__default.JSX.Element | null;
 
 interface IncomingCallDialogProps {
     /** Looped while the dialog is open. Omit for silent ringing. */
@@ -1989,6 +1989,16 @@ interface CallEndedPayload extends CallSummary {
 interface CallBusyPayload extends CallSummary {
     userId: string;
 }
+/**
+ * Group calls only (CALLS_API.md §3.1/§3.2): call_end from a group member
+ * is a *leave*, not a full hangup — the call keeps going for whoever's
+ * left. `activeParticipants` is the authoritative "who's still on this
+ * call" list; the call only becomes call_ended once that drops below two.
+ */
+interface CallParticipantLeftPayload extends CallSummary {
+    userId: string;
+    activeParticipants: string[];
+}
 interface CallHistoryEntry {
     _id: string;
     conversationId: string;
@@ -2027,19 +2037,22 @@ interface CallState {
     caller: CallParticipantSummary | null;
     participants: string[];
     error: string | null;
-    /** Caller side only — the channel being called, for the "Calling {name}" screen. */
-    callee: CallPeer | null;
+    /** Who/what to display for this call — the other person for a DM, the
+     * group for a group call. Set by startCall() (caller) or resolved from
+     * the conversation list on _receiveIncoming (callee). */
+    peer: CallPeer | null;
+    isGroupCall: boolean;
     /** Set on transition to in-call. Display-only (duration timer), not billing-accurate. */
     callStartedAt: number | null;
     /** Caller: create the room and start ringing everyone else. */
-    startCall: (conversationId: string, mode: CallMode, callee?: CallPeer) => Promise<void>;
+    startCall: (conversationId: string, mode: CallMode, peer?: CallPeer, isGroupCall?: boolean) => Promise<void>;
     /** Caller: stop ringing before anyone accepted. */
     cancelCall: () => void;
     /** Callee: accept the ringing call and fetch a join token. */
     acceptCall: () => Promise<void>;
     /** Callee: decline the ringing call. */
     rejectCall: (reason?: string) => void;
-    /** Either side: leave/end a live call. */
+    /** Either side: leave/end a live call (group calls: leave, others continue). */
     endCall: () => void;
     /** Drop back to idle without notifying anyone (e.g. after a fatal error). */
     reset: () => void;
@@ -2057,6 +2070,7 @@ interface CallState {
     _receiveRejected: (payload: CallRejectedPayload) => void;
     _receiveCancelled: (payload: CallCancelledPayload) => void;
     _receiveEnded: (payload: CallEndedPayload) => void;
+    _receiveParticipantLeft: (payload: CallParticipantLeftPayload) => void;
     _receiveBusy: (payload: CallBusyPayload) => void;
     _receiveMissed: (payload: CallSummary) => void;
 }