@ai4b-team/fsaos-gateway-sdk 3.1.0 → 3.2.0

package/dist/index.d.cts

@@ -717,6 +717,10 @@ declare function fetchChannelMessagesWithCards(channelPath: string, parentMessag
 /** Response shape from fetchChannelMessagesPage. */
 interface ChannelMessagesPage {
     messages: ChannelMessage[];
+    /** Cards grouped by parent message path (child cards of messages in this page). */
+    messageCards: Map<string, ChannelCard[]>;
+    /** Cards that are direct siblings of the channel (not nested under a message). */
+    siblingCards: ChannelCard[];
     /** Mode returned by kernel: 'top_level' or 'thread'. */
     mode: 'top_level' | 'thread';
 }
@@ -1571,6 +1575,10 @@ interface InfiniteChannelMessagesOptions {
  */
 declare function useInfiniteChannelMessages(options: InfiniteChannelMessagesOptions): {
     messages: ChannelMessage[];
+    /** Cards grouped by parent message path (child cards of messages). */
+    messageCards: Map<string, ChannelCard[]>;
+    /** Cards that are direct siblings of the channel (not nested under a message). */
+    siblingCards: ChannelCard[];
     threads: ChannelMessage[];
     isLoading: boolean;
     isFetching: boolean;

package/dist/index.d.ts

@@ -717,6 +717,10 @@ declare function fetchChannelMessagesWithCards(channelPath: string, parentMessag
 /** Response shape from fetchChannelMessagesPage. */
 interface ChannelMessagesPage {
     messages: ChannelMessage[];
+    /** Cards grouped by parent message path (child cards of messages in this page). */
+    messageCards: Map<string, ChannelCard[]>;
+    /** Cards that are direct siblings of the channel (not nested under a message). */
+    siblingCards: ChannelCard[];
     /** Mode returned by kernel: 'top_level' or 'thread'. */
     mode: 'top_level' | 'thread';
 }
@@ -1571,6 +1575,10 @@ interface InfiniteChannelMessagesOptions {
  */
 declare function useInfiniteChannelMessages(options: InfiniteChannelMessagesOptions): {
     messages: ChannelMessage[];
+    /** Cards grouped by parent message path (child cards of messages). */
+    messageCards: Map<string, ChannelCard[]>;
+    /** Cards that are direct siblings of the channel (not nested under a message). */
+    siblingCards: ChannelCard[];
     threads: ChannelMessage[];
     isLoading: boolean;
     isFetching: boolean;

package/dist/index.js

@@ -868,8 +868,22 @@ async function fetchChannelMessagesPage(channelPath, options) {
     const response = await gatewayCall("get-channel-messages", params);
     const raw = response;
     const items = raw.messages || [];
+    const cards = parseChannelCards(items);
+    const messageCards = /* @__PURE__ */ new Map();
+    const siblingCards = [];
+    for (const card of cards) {
+      if (card.parentMessagePath) {
+        const existing = messageCards.get(card.parentMessagePath) || [];
+        existing.push(card);
+        messageCards.set(card.parentMessagePath, existing);
+      } else {
+        siblingCards.push(card);
+      }
+    }
     return {
       messages: parseChannelMessages(items),
+      messageCards,
+      siblingCards,
       mode: raw.mode || "top_level"
     };
   } catch (err) {
@@ -877,7 +891,7 @@ async function fetchChannelMessagesPage(channelPath, options) {
       `[gateway] Failed to fetch channel messages page for ${channelPath}:`,
       err
     );
-    return { messages: [], mode: "top_level" };
+    return { messages: [], messageCards: /* @__PURE__ */ new Map(), siblingCards: [], mode: "top_level" };
   }
 }
 function invalidateChildren(path) {
@@ -2400,17 +2414,60 @@ function useInfiniteChannelMessages(options) {
     }
     return flat.sort((a, b) => a.seq - b.seq);
   }, [query.data?.pages]);
+  const { messageCards, siblingCards } = useMemo(() => {
+    const mc = /* @__PURE__ */ new Map();
+    const sc = [];
+    if (!query.data?.pages) return { messageCards: mc, siblingCards: sc };
+    const seenCards = /* @__PURE__ */ new Set();
+    for (const page of query.data.pages) {
+      for (const [path, cards] of page.messageCards) {
+        for (const card of cards) {
+          if (seenCards.has(card.id)) continue;
+          seenCards.add(card.id);
+          const existing = mc.get(path) || [];
+          existing.push(card);
+          mc.set(path, existing);
+        }
+      }
+      for (const card of page.siblingCards) {
+        if (seenCards.has(card.id)) continue;
+        seenCards.add(card.id);
+        sc.push(card);
+      }
+    }
+    return { messageCards: mc, siblingCards: sc };
+  }, [query.data?.pages]);
+  const qc = useQueryClient();
+  const debounceRef = useRef(null);
+  const stableKey = useMemo(
+    () => [...vfsKeys.channelMessages(channelPath || "", parentMessageId), "infinite", limit],
+    [channelPath, parentMessageId, limit]
+  );
   useEffect(() => {
     if (!realtime || !channelPath || !queryEnabled) return;
-    const unsub = subscribeToEvents(channelPath, (event) => {
-      if (event.event_type === "vfs_change") {
-        query.refetch();
+    const unsub = subscribeToEvents(
+      "vfs_change",
+      () => {
+        if (debounceRef.current) clearTimeout(debounceRef.current);
+        debounceRef.current = setTimeout(() => {
+          qc.invalidateQueries({ queryKey: stableKey });
+        }, 500);
+      },
+      (data) => {
+        return (data.item_type === "message" || data.item_type === "card") && typeof data.path === "string" && data.path.startsWith(channelPath);
       }
-    });
-    return unsub;
-  }, [realtime, channelPath, queryEnabled]);
+    );
+    return () => {
+      unsub();
+      if (debounceRef.current) clearTimeout(debounceRef.current);
+    };
+  }, [realtime, channelPath, queryEnabled, stableKey, qc]);
   return {
     messages,
+    /** Cards grouped by parent message path (child cards of messages). */
+    messageCards,
+    /** Cards that are direct siblings of the channel (not nested under a message). */
+    siblingCards,
     threads: messages.filter((m) => m.reply_count > 0),
     isLoading: query.isLoading,
     isFetching: query.isFetching,