@poolse/react 2.26.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, 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';
+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 {
@@ -783,4 +783,43 @@ interface UseLiveCall {
  */
 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 };
+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, 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';
+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 {
@@ -783,4 +783,43 @@ interface UseLiveCall {
  */
 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 };
+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]);
@@ -1663,7 +1666,35 @@ function useLiveCall(conversationId) {
   }, [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, useLiveCall, 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