@ai-matrx/messaging 0.10.4 → 0.11.0

package/dist/react.js

@@ -821,6 +821,17 @@ function projectConversationSummary(row, viewerId, fallbackOrganizationId) {
   };
 }
 
+// src/core/types.ts
+var asConversationId = (value) => value;
+var asMessageId = (value) => value;
+var asUserId = (value) => value;
+var asOrganizationId = (value) => value;
+var asClientMessageId = (value) => value;
+var DEFAULT_MESSAGING_ARCHIVE_FILTER = "active";
+function toMessagingArchiveFilter(value, fallback = DEFAULT_MESSAGING_ARCHIVE_FILTER) {
+  return value === "active" || value === "archived" || value === "all" ? value : fallback;
+}
+
 // src/core/store.ts
 function timeOf(message) {
   const stamp = message.editedAt ?? message.createdAt;
@@ -851,6 +862,8 @@ function createMessagingStore() {
   let conversations = [];
   let hasMoreConversations = false;
   let hasLoadedConversations = false;
+  let archiveFilter = DEFAULT_MESSAGING_ARCHIVE_FILTER;
+  let archivedCount = null;
   let threads = /* @__PURE__ */ new Map();
   let activeConversationId = null;
   const listeners = /* @__PURE__ */ new Set();
@@ -863,7 +876,9 @@ function createMessagingStore() {
       hasLoadedConversations,
       threads,
       activeConversationId,
-      totalUnreadConversations: conversations.filter((item) => item.unreadCount > 0).length
+      totalUnreadConversations: conversations.filter((item) => item.unreadCount > 0).length,
+      archiveFilter,
+      archivedCount
     };
     return cached;
   }
@@ -910,6 +925,18 @@ function createMessagingStore() {
       hasLoadedConversations = true;
       emit();
     },
+    setArchiveFilter(next) {
+      if (next === archiveFilter) return;
+      archiveFilter = next;
+      conversations = [];
+      hasMoreConversations = false;
+      hasLoadedConversations = false;
+      emit();
+    },
+    setArchivedCount(value) {
+      archivedCount = value;
+      emit();
+    },
     appendConversations(items, hasMore) {
       const byId = new Map(conversations.map((item) => [item.conversation.id, item]));
       items.forEach((item) => byId.set(item.conversation.id, item));
@@ -1115,10 +1142,21 @@ function createMessagingEngine(options) {
     openChannels.get(message.conversationId)?.send(MESSAGING_EVENTS.message, message);
   }
   async function reloadInbox() {
-    const page = await repository.listConversations({ limit: conversationPageSize });
+    if (disposed) return;
+    const page = await repository.listConversations({
+      limit: conversationPageSize,
+      archived: store.snapshot().archiveFilter
+    });
+    if (disposed) return;
     conversationCursor = page.nextCursor;
     store.setConversations(page.items, page.hasMore);
   }
+  async function reloadArchivedCount() {
+    if (disposed) return;
+    const value = await repository.countArchivedConversations();
+    if (disposed) return;
+    store.setArchivedCount(value);
+  }
   async function backfillConversation(id) {
     const thread = store.snapshot().threads.get(id);
     const since = thread?.latestAt ?? null;
@@ -1145,7 +1183,13 @@ function createMessagingEngine(options) {
     outbox,
     identity,
     async start() {
+      if (options.archiveFilter !== void 0) {
+        store.setArchiveFilter(options.archiveFilter);
+      }
       await reloadInbox();
+      void reloadArchivedCount().catch(
+        (error) => reportError(error, "refreshArchivedCount")
+      );
       if (disposed || inboxChannel !== null) return;
       inboxChannel = manager.open({
         topic: inboxTopic(identity.userId),
@@ -1160,7 +1204,7 @@ function createMessagingEngine(options) {
               const message = projectMessage(row, identity.organizationId);
               const known = store.snapshot().conversations.some((item) => item.conversation.id === message.conversationId);
               if (!known) {
-                void reloadInbox();
+                void reloadInbox().catch((error) => reportError(error, "inboxRefresh"));
                 return;
               }
               store.ingest(message);
@@ -1176,7 +1220,7 @@ function createMessagingEngine(options) {
             filter: `user_id=eq.${identity.userId}`,
             rowId: (row) => typeof row["id"] === "string" ? row["id"] : void 0,
             onChange: () => {
-              void reloadInbox();
+              void reloadInbox().catch((error) => reportError(error, "inboxRefresh"));
             }
           }
         ],
@@ -1187,12 +1231,33 @@ function createMessagingEngine(options) {
         }
       });
     },
+    async setArchiveFilter(next) {
+      if (next === store.snapshot().archiveFilter) return;
+      store.setArchiveFilter(next);
+      conversationCursor = null;
+      try {
+        await reloadInbox();
+      } catch (error) {
+        reportError(error, "setArchiveFilter");
+      }
+      await reloadArchivedCount().catch(
+        (error) => reportError(error, "refreshArchivedCount")
+      );
+    },
+    async refreshArchivedCount() {
+      try {
+        await reloadArchivedCount();
+      } catch (error) {
+        reportError(error, "refreshArchivedCount");
+      }
+    },
     async loadMoreConversations() {
       if (conversationCursor === null) return;
       try {
         const page = await repository.listConversations({
           limit: conversationPageSize,
-          cursor: conversationCursor
+          cursor: conversationCursor,
+          archived: store.snapshot().archiveFilter
         });
         conversationCursor = page.nextCursor;
         store.appendConversations(page.items, page.hasMore);
@@ -1456,6 +1521,7 @@ function createMessagingRepository(options) {
     identity,
     async listConversations(args = {}) {
       const limit = args.limit ?? 30;
+      const archived = args.archived ?? DEFAULT_MESSAGING_ARCHIVE_FILTER;
       const operation = "listConversations";
       const rows = await withSessionRetry(
         operation,
@@ -1465,7 +1531,12 @@ function createMessagingRepository(options) {
             p_user_id: identity.userId,
             p_limit: limit + 1,
             p_before_sort_at: args.cursor?.beforeSortAt ?? null,
-            p_before_conversation_id: args.cursor?.beforeConversationId ?? null
+            p_before_conversation_id: args.cursor?.beforeConversationId ?? null,
+            // THE ARCHIVED-ITEMS LAW, SERVER-side. `get_dm_conversations_with_details`
+            // used to hardcode `is_archived IS FALSE` with no parameter at all,
+            // so an archived conversation was not hidden — it was unreachable.
+            // The RPC gained `p_archived` on 2026-09-09 (register row R1).
+            p_archived: archived
           },
           operation
         )
@@ -1485,6 +1556,29 @@ function createMessagingRepository(options) {
         nextCursor: hasMore && last !== void 0 ? { beforeSortAt: last.sortAt, beforeConversationId: last.conversation.id } : null
       };
     },
+    async countArchivedConversations(args = {}) {
+      const limit = args.limit ?? 100;
+      const operation = "countArchivedConversations";
+      const rows = await withSessionRetry(
+        operation,
+        () => rpc(
+          RPCS.conversationsWithDetails,
+          {
+            p_user_id: identity.userId,
+            p_limit: limit + 1,
+            p_before_sort_at: null,
+            p_before_conversation_id: null,
+            p_archived: "archived"
+          },
+          operation
+        )
+      );
+      if (rows !== null && !Array.isArray(rows)) {
+        throw invalidResponse(operation, `${RPCS.conversationsWithDetails} did not return rows`);
+      }
+      const found = (rows ?? []).length;
+      return found > limit ? { count: limit, exact: false } : { count: found, exact: true };
+    },
     async getConversation(id) {
       const operation = "getConversation";
       const { data, error } = await withSessionRetry(
@@ -1793,6 +1887,7 @@ function MessagingRuntime(props) {
         onFallback: (message) => report({ level: "warn", message })
       }),
       onDiagnostic: report,
+      ...props.archiveFilter !== void 0 ? { archiveFilter: props.archiveFilter } : {},
       onIncoming: (message) => {
         const snapshot = built?.store.snapshot();
         if (snapshot === void 0) return;
@@ -2023,6 +2118,11 @@ function useConversations() {
     },
     select,
     activeConversationId: snapshot?.activeConversationId ?? null,
+    archiveFilter: snapshot?.archiveFilter ?? DEFAULT_MESSAGING_ARCHIVE_FILTER,
+    setArchiveFilter: (next) => {
+      void host?.engine.setArchiveFilter(next);
+    },
+    archivedCount: snapshot?.archivedCount ?? null,
     startDirect: async (otherUserId) => {
       if (host === null) {
         throw new Error("[@ai-matrx/messaging] startDirect called before the host was ready.");
@@ -2599,9 +2699,37 @@ var AI_LABELS = {
   draftReply: "Draft a reply"
 };
 function ConversationList(props) {
-  const { conversations, hasMore, isInitialLoading, loadMore, select, activeConversationId } = useConversations();
+  const {
+    conversations,
+    hasMore,
+    isInitialLoading,
+    loadMore,
+    select,
+    activeConversationId,
+    archiveFilter,
+    setArchiveFilter,
+    archivedCount
+  } = useConversations();
   const RowChrome = useMessagingHost()?.wrapConversationRow ?? null;
   const [query, setQuery] = useState2("");
+  const showingArchive = archiveFilter === "archived";
+  const archiveReveal = useMemo3(() => {
+    if (showingArchive) {
+      return {
+        next: "active",
+        label: "\u2190 Back to active conversations",
+        ariaLabel: "Hide archived conversations"
+      };
+    }
+    if (archivedCount === null) return null;
+    if (archivedCount.count === 0) return null;
+    const printed = archivedCount.exact ? `${archivedCount.count}` : `${archivedCount.count}+`;
+    return {
+      next: "archived",
+      label: `Archived (${printed})`,
+      ariaLabel: "Show archived conversations"
+    };
+  }, [showingArchive, archivedCount]);
   const visible = useMemo3(() => {
     const needle = query.trim().toLowerCase();
     if (needle.length === 0) return conversations;
@@ -2634,12 +2762,22 @@ function ConversationList(props) {
         }
       ) : null
     ] }),
+    archiveReveal !== null ? /* @__PURE__ */ jsx4("div", { className: "mx-msg__list-archive", children: /* @__PURE__ */ jsx4(
+      "button",
+      {
+        type: "button",
+        className: "mx-msg__chip",
+        onClick: () => setArchiveFilter(archiveReveal.next),
+        "aria-label": archiveReveal.ariaLabel,
+        children: archiveReveal.label
+      }
+    ) }) : null,
     /* @__PURE__ */ jsxs2("div", { className: "mx-msg__scroll", children: [
       isInitialLoading ? /* @__PURE__ */ jsx4(ConversationSkeleton, {}) : visible.length === 0 ? /* @__PURE__ */ jsx4(
         EmptyState,
         {
-          title: query.length > 0 ? "No matches" : "No conversations yet",
-          body: query.length > 0 ? "Try a different name or word." : "Start one and it will appear here."
+          title: query.length > 0 ? "No matches" : showingArchive ? "No archived conversations" : "No conversations yet",
+          body: query.length > 0 ? "Try a different name or word." : showingArchive ? "Archiving a conversation moves it here." : "Start one and it will appear here."
         }
       ) : /* @__PURE__ */ jsx4("ul", { className: "mx-msg__rows", children: visible.map((item) => {
         const row = /* @__PURE__ */ jsx4(
@@ -3134,13 +3272,6 @@ function MessagingInbox(props) {
     }
   );
 }
-
-// src/core/types.ts
-var asConversationId = (value) => value;
-var asMessageId = (value) => value;
-var asUserId = (value) => value;
-var asOrganizationId = (value) => value;
-var asClientMessageId = (value) => value;
 export {
   AgentTag,
   AlertIcon,
@@ -3154,6 +3285,7 @@ export {
   ConversationList,
   ConversationSkeleton,
   ConversationView,
+  DEFAULT_MESSAGING_ARCHIVE_FILTER,
   DeliveryTick,
   DoubleCheckIcon,
   EmptyState,
@@ -3216,6 +3348,7 @@ export {
   resolveActor,
   splitText,
   summarizeText,
+  toMessagingArchiveFilter,
   unreadCutoff,
   useComposer,
   useConversation,