@poolse/react 2.25.0 → 2.26.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, CameraFacing, CallDeviceKind, CallDevice, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia } from '@poolse/sdk';
-export { ApiError, Attachment, AttachmentStatus, AttachmentUploadInput, AttachmentUploadRequest, AttachmentUploadResponse, AuthError, CallLog, CallLogDisplay, CallLogEntry, CallLogMedia, CallMissedEntry, Conversation, ConversationCreateRequest, Me, MemberRole, Membership, Message, MessageCreateRequest, MessageType, NetworkError, PoolseConfig, PoolseError, PoolseUserProfile, RateLimitedError, RealtimeStatus, Uuid, callLogDisplayFor, describeCallLog, formatCallDuration, formatCallLogPreview, isCallLogMessage, isMessageVisibleTo, parseCallLog, parseCallLogBody } from '@poolse/sdk';
+import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, CameraFacing, CallDeviceKind, CallDevice, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia, LiveCall } from '@poolse/sdk';
+export { ApiError, Attachment, AttachmentStatus, AttachmentUploadInput, AttachmentUploadRequest, AttachmentUploadResponse, AuthError, CallEndReason, CallLog, CallLogDisplay, CallLogEntry, CallLogMedia, CallMissedEntry, CallParticipantStatus, Conversation, ConversationCreateRequest, DeviceKind, LiveCall, LiveCallMember, Me, MemberRole, Membership, Message, MessageCreateRequest, MessageType, NetworkError, PoolseConfig, PoolseError, PoolseUserProfile, RateLimitedError, RealtimeStatus, Uuid, callLogDisplayFor, describeCallLog, formatCallDuration, formatCallLogPreview, isCallLogMessage, isMessageVisibleTo, parseCallLog, parseCallLogBody } from '@poolse/sdk';
 import { ReactNode } from 'react';
 
 interface PoolseProviderProps {
@@ -766,4 +766,21 @@ interface UseCalls {
  */
 declare function useCalls(userId: string | null, opts?: UseCallsOptions): UseCalls;
 
-export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+interface UseLiveCall {
+    /** The call running on the conversation right now, or null. */
+    call: LiveCall | null;
+    /** User ids in the call's room at this moment (kept live by `call:participants`). */
+    participantIds: string[];
+    /** Re-read from the server. */
+    refresh: () => void;
+}
+/**
+ * Whether a call is running on `conversationId` — what a "Call in
+ * progress · Join" banner needs. Reads once on mount (and after every
+ * reconnect, since events sent while the socket was down are gone),
+ * then follows the conversation's `call:started`, `call:participants`
+ * and `call:finished` events. `null` id → always idle.
+ */
+declare function useLiveCall(conversationId: string | null): UseLiveCall;
+
+export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseLiveCall, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, CameraFacing, CallDeviceKind, CallDevice, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia } from '@poolse/sdk';
-export { ApiError, Attachment, AttachmentStatus, AttachmentUploadInput, AttachmentUploadRequest, AttachmentUploadResponse, AuthError, CallLog, CallLogDisplay, CallLogEntry, CallLogMedia, CallMissedEntry, Conversation, ConversationCreateRequest, Me, MemberRole, Membership, Message, MessageCreateRequest, MessageType, NetworkError, PoolseConfig, PoolseError, PoolseUserProfile, RateLimitedError, RealtimeStatus, Uuid, callLogDisplayFor, describeCallLog, formatCallDuration, formatCallLogPreview, isCallLogMessage, isMessageVisibleTo, parseCallLog, parseCallLogBody } from '@poolse/sdk';
+import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, CameraFacing, CallDeviceKind, CallDevice, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia, LiveCall } from '@poolse/sdk';
+export { ApiError, Attachment, AttachmentStatus, AttachmentUploadInput, AttachmentUploadRequest, AttachmentUploadResponse, AuthError, CallEndReason, CallLog, CallLogDisplay, CallLogEntry, CallLogMedia, CallMissedEntry, CallParticipantStatus, Conversation, ConversationCreateRequest, DeviceKind, LiveCall, LiveCallMember, Me, MemberRole, Membership, Message, MessageCreateRequest, MessageType, NetworkError, PoolseConfig, PoolseError, PoolseUserProfile, RateLimitedError, RealtimeStatus, Uuid, callLogDisplayFor, describeCallLog, formatCallDuration, formatCallLogPreview, isCallLogMessage, isMessageVisibleTo, parseCallLog, parseCallLogBody } from '@poolse/sdk';
 import { ReactNode } from 'react';
 
 interface PoolseProviderProps {
@@ -766,4 +766,21 @@ interface UseCalls {
  */
 declare function useCalls(userId: string | null, opts?: UseCallsOptions): UseCalls;
 
-export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+interface UseLiveCall {
+    /** The call running on the conversation right now, or null. */
+    call: LiveCall | null;
+    /** User ids in the call's room at this moment (kept live by `call:participants`). */
+    participantIds: string[];
+    /** Re-read from the server. */
+    refresh: () => void;
+}
+/**
+ * Whether a call is running on `conversationId` — what a "Call in
+ * progress · Join" banner needs. Reads once on mount (and after every
+ * reconnect, since events sent while the socket was down are gone),
+ * then follows the conversation's `call:started`, `call:participants`
+ * and `call:finished` events. `null` id → always idle.
+ */
+declare function useLiveCall(conversationId: string | null): UseLiveCall;
+
+export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseLiveCall, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };

package/dist/index.js

@@ -1612,7 +1612,58 @@ function useCalls(userId, opts = {}) {
     reset
   };
 }
+function useLiveCall(conversationId) {
+  const chat = usePoolse();
+  const [call, setCall] = useState(null);
+  const [participantIds, setParticipantIds] = useState([]);
+  const callIdRef = useRef(null);
+  const seq = useRef(0);
+  const apply = useCallback((next) => {
+    callIdRef.current = next?.id ?? null;
+    setCall(next);
+    setParticipantIds(next ? next.participants.map((p) => p.user_id) : []);
+  }, []);
+  const refresh = useCallback(() => {
+    if (!conversationId) return;
+    const mine = ++seq.current;
+    chat.liveCalls.get(conversationId).then((c) => {
+      if (mine === seq.current) apply(c);
+    }).catch(() => {
+    });
+  }, [chat, conversationId, apply]);
+  useEffect(() => {
+    apply(null);
+    if (!conversationId) return;
+    refresh();
+    const conv = chat.realtime.conversation(conversationId);
+    const offStarted = conv.onCallStarted((evt) => {
+      seq.current++;
+      apply(evt.call);
+    });
+    const offParticipants = conv.onCallParticipants((evt) => {
+      if (evt.call_id === callIdRef.current) setParticipantIds(evt.participants);
+      else refresh();
+    });
+    const offFinished = conv.onCallFinished((evt) => {
+      if (evt.call_id !== callIdRef.current) return;
+      seq.current++;
+      apply(null);
+    });
+    let wasConnected = chat.realtime.getStatus() === "connected";
+    const offStatus = chat.realtime.onStatus((status) => {
+      if (status === "connected" && !wasConnected) refresh();
+      wasConnected = status === "connected";
+    });
+    return () => {
+      offStarted();
+      offParticipants();
+      offFinished();
+      offStatus();
+    };
+  }, [chat, conversationId, apply, refresh]);
+  return { call, participantIds, refresh };
+}
 
-export { PoolseProvider, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+export { PoolseProvider, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map