@poolse/react 2.25.0 → 2.27.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, ReadReceiptsState, RealtimeStatus, Uuid, callLogDisplayFor, describeCallLog, formatCallDuration, formatCallLogPreview, isCallLogMessage, isMessageVisibleTo, parseCallLog, parseCallLogBody } from '@poolse/sdk';
 import { ReactNode } from 'react';
 
 interface PoolseProviderProps {
@@ -766,4 +766,60 @@ 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;
+
+interface UseReadReceipts {
+    /**
+     * Whether this user sees other people's read state. False → show no
+     * check marks anywhere (the server withholds the data anyway).
+     */
+    visible: boolean;
+    /** `on`, `off`, or `user` (each user decides) — the workspace setting. */
+    mode: 'on' | 'off' | 'user';
+    /** Whether others see when this user reads. */
+    shared: boolean;
+    /** True only when the workspace lets users decide: offer a switch. */
+    canChange: boolean;
+    /**
+     * Turn this user's read receipts on or off (only where `canChange`).
+     * Reciprocal: off also hides other people's.
+     */
+    setShared: (share: boolean) => Promise<void>;
+}
+/** The workspace's read-receipt setting as it applies to the signed-in user. */
+declare function useReadReceipts(): UseReadReceipts;
+/** Read-receipt state from a `Me`; an older server without it means "on". */
+declare function receiptsOf(me: Me | null): Omit<UseReadReceipts, 'setShared'>;
+/** How long a message stays editable when read receipts are hidden. */
+declare const EDIT_WINDOW_MS: number;
+/**
+ * May the viewer edit their own message? With read receipts visible:
+ * until someone else has read it (`readState` is `read`), as in the
+ * messaging apps. With them hidden there is nothing to show why editing
+ * stopped, so it is a plain time window instead: 15 minutes from sending.
+ */
+declare function canEditOwnMessage(args: {
+    isSelf: boolean;
+    deleted: boolean;
+    receiptsVisible: boolean;
+    readState: 'sent' | 'read' | undefined;
+    insertedAt: string;
+    now?: number;
+}): boolean;
+
+export { type CallPhase, EDIT_WINDOW_MS, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseLiveCall, type UseReadReceipts, type UseUserState, type UseVoiceRoom, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, 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, ReadReceiptsState, RealtimeStatus, Uuid, callLogDisplayFor, describeCallLog, formatCallDuration, formatCallLogPreview, isCallLogMessage, isMessageVisibleTo, parseCallLog, parseCallLogBody } from '@poolse/sdk';
 import { ReactNode } from 'react';
 
 interface PoolseProviderProps {
@@ -766,4 +766,60 @@ 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;
+
+interface UseReadReceipts {
+    /**
+     * Whether this user sees other people's read state. False → show no
+     * check marks anywhere (the server withholds the data anyway).
+     */
+    visible: boolean;
+    /** `on`, `off`, or `user` (each user decides) — the workspace setting. */
+    mode: 'on' | 'off' | 'user';
+    /** Whether others see when this user reads. */
+    shared: boolean;
+    /** True only when the workspace lets users decide: offer a switch. */
+    canChange: boolean;
+    /**
+     * Turn this user's read receipts on or off (only where `canChange`).
+     * Reciprocal: off also hides other people's.
+     */
+    setShared: (share: boolean) => Promise<void>;
+}
+/** The workspace's read-receipt setting as it applies to the signed-in user. */
+declare function useReadReceipts(): UseReadReceipts;
+/** Read-receipt state from a `Me`; an older server without it means "on". */
+declare function receiptsOf(me: Me | null): Omit<UseReadReceipts, 'setShared'>;
+/** How long a message stays editable when read receipts are hidden. */
+declare const EDIT_WINDOW_MS: number;
+/**
+ * May the viewer edit their own message? With read receipts visible:
+ * until someone else has read it (`readState` is `read`), as in the
+ * messaging apps. With them hidden there is nothing to show why editing
+ * stopped, so it is a plain time window instead: 15 minutes from sending.
+ */
+declare function canEditOwnMessage(args: {
+    isSelf: boolean;
+    deleted: boolean;
+    receiptsVisible: boolean;
+    readState: 'sent' | 'read' | undefined;
+    insertedAt: string;
+    now?: number;
+}): boolean;
+
+export { type CallPhase, EDIT_WINDOW_MS, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseLiveCall, type UseReadReceipts, type UseUserState, type UseVoiceRoom, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };

package/dist/index.js

@@ -68,27 +68,30 @@ function usePoolse() {
 }
 function useMe() {
   const chat = usePoolse();
-  const [state, setState] = useState({
-    me: null,
-    loading: true,
-    error: null
+  const [state, setState] = useState(() => {
+    const known = chat.me.peek();
+    return { me: known, loading: known === null, error: null };
   });
   useEffect(() => {
     let cancelled = false;
     const controller = new AbortController();
+    const off = chat.me.onChange((me) => {
+      if (!cancelled) setState({ me, loading: false, error: null });
+    });
     chat.me.show(controller.signal).then((me) => {
       if (!cancelled) setState({ me, loading: false, error: null });
     }).catch((err) => {
       if (!cancelled) {
-        setState({
-          me: null,
+        setState((prev) => ({
+          me: prev.me,
           loading: false,
           error: err instanceof Error ? err : new Error(String(err))
-        });
+        }));
       }
     });
     return () => {
       cancelled = true;
+      off();
       controller.abort();
     };
   }, [chat]);
@@ -1612,7 +1615,86 @@ 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 };
+}
+function useReadReceipts() {
+  const chat = usePoolse();
+  const { me } = useMe();
+  const state = receiptsOf(me);
+  const setShared = useCallback(
+    async (share) => {
+      await chat.me.update({ read_receipts: share });
+    },
+    [chat]
+  );
+  return { ...state, setShared };
+}
+function receiptsOf(me) {
+  const r = me?.read_receipts;
+  return {
+    visible: r?.visible ?? true,
+    mode: r?.mode ?? "on",
+    shared: r?.shared ?? true,
+    canChange: r?.can_change ?? false
+  };
+}
+var EDIT_WINDOW_MS = 15 * 60 * 1e3;
+function canEditOwnMessage(args) {
+  if (!args.isSelf || args.deleted) return false;
+  if (args.receiptsVisible) return (args.readState ?? "sent") === "sent";
+  const sent = Date.parse(args.insertedAt);
+  return Number.isFinite(sent) && (args.now ?? Date.now()) - sent < EDIT_WINDOW_MS;
+}
 
-export { PoolseProvider, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+export { EDIT_WINDOW_MS, PoolseProvider, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map