@poolse/react 3.0.0 → 3.2.0-dev.0

package/dist/index.d.cts

@@ -324,6 +324,28 @@ interface UseTypingState {
  */
 declare function useTyping(conversationId: string): UseTypingState;
 
+/** An AI agent's reply that's still being written. */
+interface MessageStream {
+    /** Becomes the finished message's id. */
+    id: Uuid;
+    conversation_id: Uuid;
+    sender_id: Uuid;
+    sender_external_id: string | null;
+    /** The text so far; empty until the first delta. */
+    text: string;
+    status: 'streaming' | 'failed';
+    error?: string;
+}
+/**
+ * AI agent replies being written in `conversationId`, oldest first.
+ *
+ * Built from `message:stream` events: `started` adds a stream, each
+ * `delta` appends text, `failed` marks it failed (removed after a few
+ * seconds). When the finished reply arrives as `message:new` with the
+ * same id, the stream is removed — `useMessages` shows the message.
+ */
+declare function useMessageStreams(conversationId: string): MessageStream[];
+
 interface UsePresenceState {
     /**
      * Set of `external_id`s currently online in this conversation —
@@ -438,7 +460,7 @@ interface UseAttachmentUrlState {
  * re-keys on a timer.
  *
  * ```tsx
- * const { url } = useAttachmentUrl(message.custom_data?.attachment_id ?? null);
+ * const { url } = useAttachmentUrl(message.attachments?.[0]?.id ?? null);
  * return url ? <img src={url} /> : <Spinner />;
  * ```
  */
@@ -525,7 +547,7 @@ interface UseCallRoom {
      * earpiece, but it does have several microphones and a pair of
      * headphones, and choosing between them is the same job. Sparse on
      * React Native, where routing goes through the platform audio session
-     * instead (see `useCallAudio` in `@poolse/react-native`).
+     * instead (`setAudioOutput` in `@poolse/native`).
      */
     devices: Record<CallDeviceKind, CallDevice[]>;
     /** Device id in use per kind, where the platform reports one. */
@@ -692,4 +714,4 @@ declare function canEditOwnMessage(args: {
     now?: number;
 }): boolean;
 
-export { EDIT_WINDOW_MS, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
+export { EDIT_WINDOW_MS, type GroupPosition, type MessageStream, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessageStreams, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };

package/dist/index.d.ts

@@ -324,6 +324,28 @@ interface UseTypingState {
  */
 declare function useTyping(conversationId: string): UseTypingState;
 
+/** An AI agent's reply that's still being written. */
+interface MessageStream {
+    /** Becomes the finished message's id. */
+    id: Uuid;
+    conversation_id: Uuid;
+    sender_id: Uuid;
+    sender_external_id: string | null;
+    /** The text so far; empty until the first delta. */
+    text: string;
+    status: 'streaming' | 'failed';
+    error?: string;
+}
+/**
+ * AI agent replies being written in `conversationId`, oldest first.
+ *
+ * Built from `message:stream` events: `started` adds a stream, each
+ * `delta` appends text, `failed` marks it failed (removed after a few
+ * seconds). When the finished reply arrives as `message:new` with the
+ * same id, the stream is removed — `useMessages` shows the message.
+ */
+declare function useMessageStreams(conversationId: string): MessageStream[];
+
 interface UsePresenceState {
     /**
      * Set of `external_id`s currently online in this conversation —
@@ -438,7 +460,7 @@ interface UseAttachmentUrlState {
  * re-keys on a timer.
  *
  * ```tsx
- * const { url } = useAttachmentUrl(message.custom_data?.attachment_id ?? null);
+ * const { url } = useAttachmentUrl(message.attachments?.[0]?.id ?? null);
  * return url ? <img src={url} /> : <Spinner />;
  * ```
  */
@@ -525,7 +547,7 @@ interface UseCallRoom {
      * earpiece, but it does have several microphones and a pair of
      * headphones, and choosing between them is the same job. Sparse on
      * React Native, where routing goes through the platform audio session
-     * instead (see `useCallAudio` in `@poolse/react-native`).
+     * instead (`setAudioOutput` in `@poolse/native`).
      */
     devices: Record<CallDeviceKind, CallDevice[]>;
     /** Device id in use per kind, where the platform reports one. */
@@ -692,4 +714,4 @@ declare function canEditOwnMessage(args: {
     now?: number;
 }): boolean;
 
-export { EDIT_WINDOW_MS, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
+export { EDIT_WINDOW_MS, type GroupPosition, type MessageStream, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessageStreams, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };

package/dist/index.js

@@ -172,9 +172,21 @@ function useConversations() {
       const fromMe = by_user_id === me.id;
       setConversations((prev) => mergeUpdated(prev, conversation, fromMe));
     });
+    let wasConnected = chat.realtime.getStatus() === "connected";
+    let connectedBefore = wasConnected;
+    const offStatus = chat.realtime.onStatus((status) => {
+      const reconnected = status === "connected" && !wasConnected && connectedBefore;
+      connectedBefore ||= status === "connected";
+      if (reconnected) {
+        chat.conversations.list().then((list) => setConversations(list.data)).catch(() => {
+        });
+      }
+      wasConnected = status === "connected";
+    });
     return () => {
       offCreated();
       offUpdated();
+      offStatus();
     };
   }, [chat, me]);
   const markConversationRead = useCallback((conversationId) => {
@@ -381,11 +393,24 @@ function useMessages(conversationId) {
         return updated;
       });
     });
+    let wasConnected = chat.realtime.getStatus() === "connected";
+    let connectedBefore = wasConnected;
+    const offStatus = chat.realtime.onStatus((status) => {
+      const reconnected = status === "connected" && !wasConnected && connectedBefore;
+      wasConnected = status === "connected";
+      connectedBefore ||= wasConnected;
+      if (!reconnected || cancelled) return;
+      handle.list({ limit: PAGE_SIZE }).then((page) => {
+        if (!cancelled) setMessages((prev) => mergeLatest(prev, page.data));
+      }).catch(() => {
+      });
+    });
     return () => {
       cancelled = true;
       offNew();
       offUpdated();
       offDeleted();
+      offStatus();
     };
   }, [chat, conversationId]);
   const loadMore = useCallback(async () => {
@@ -526,6 +551,11 @@ function upsertById(prev, msg) {
   next[idx] = msg;
   return next;
 }
+function mergeLatest(prev, page) {
+  let next = prev;
+  for (const msg of page) next = upsertById(next, msg);
+  return next === prev ? prev : [...next].sort((a, b) => a.sequence - b.sequence);
+}
 function useReactions(messageId, opts) {
   const chat = usePoolse();
   const [reactions, setReactions] = useState(opts.initialReactions ?? {});
@@ -823,6 +853,62 @@ function useTyping(conversationId) {
   }, [chat, conversationId]);
   return { typing, signalTyping };
 }
+var FAILED_TTL_MS = 8e3;
+var STALE_MS = 9e4;
+function useMessageStreams(conversationId) {
+  const chat = usePoolse();
+  const [streams, setStreams] = useState([]);
+  useEffect(() => {
+    setStreams([]);
+    const timers = /* @__PURE__ */ new Map();
+    const remove = (id) => {
+      const t = timers.get(id);
+      if (t) clearTimeout(t);
+      timers.delete(id);
+      setStreams(
+        (prev) => prev.some((s) => s.id === id) ? prev.filter((s) => s.id !== id) : prev
+      );
+    };
+    const arm = (id, ms) => {
+      const t = timers.get(id);
+      if (t) clearTimeout(t);
+      timers.set(
+        id,
+        setTimeout(() => remove(id), ms)
+      );
+    };
+    const conv = chat.realtime.conversation(conversationId);
+    const offStream = conv.onMessageStream((evt) => {
+      setStreams((prev) => {
+        const existing = prev.find((s) => s.id === evt.id);
+        const base = existing ?? {
+          id: evt.id,
+          conversation_id: evt.conversation_id,
+          sender_id: evt.sender_id,
+          sender_external_id: evt.sender_external_id ?? null,
+          text: "",
+          status: "streaming"
+        };
+        let next;
+        if (evt.status === "delta") next = { ...base, text: base.text + (evt.delta ?? "") };
+        else if (evt.status === "failed")
+          next = { ...base, status: "failed", ...evt.error ? { error: evt.error } : {} };
+        else
+          next = { ...base, sender_external_id: evt.sender_external_id ?? base.sender_external_id };
+        return existing ? prev.map((s) => s.id === evt.id ? next : s) : [...prev, next];
+      });
+      arm(evt.id, evt.status === "failed" ? FAILED_TTL_MS : STALE_MS);
+    });
+    const offMessage = conv.onMessage((msg) => remove(msg.id));
+    return () => {
+      offStream();
+      offMessage();
+      timers.forEach((t) => clearTimeout(t));
+      timers.clear();
+    };
+  }, [chat, conversationId]);
+  return streams;
+}
 function externalIdsFrom(state) {
   const out = [];
   for (const presence of Object.values(state)) {
@@ -1275,9 +1361,11 @@ function useLiveCall(conversationId) {
       apply(null);
     });
     let wasConnected = chat.realtime.getStatus() === "connected";
+    let connectedBefore = wasConnected;
     const offStatus = chat.realtime.onStatus((status) => {
-      if (status === "connected" && !wasConnected) refresh();
+      if (status === "connected" && !wasConnected && connectedBefore) refresh();
       wasConnected = status === "connected";
+      connectedBefore ||= wasConnected;
     });
     return () => {
       offStarted();
@@ -1366,6 +1454,6 @@ function canEditOwnMessage(args) {
   return Number.isFinite(sent) && (args.now ?? Date.now()) - sent < EDIT_WINDOW_MS;
 }
 
-export { EDIT_WINDOW_MS, PoolseProvider, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
+export { EDIT_WINDOW_MS, PoolseProvider, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessageStreams, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map