@ai-matrx/messaging 0.10.4 → 0.11.0

package/dist/react.cjs

@@ -34,6 +34,7 @@ __export(react_exports, {
   ConversationList: () => ConversationList,
   ConversationSkeleton: () => ConversationSkeleton,
   ConversationView: () => ConversationView,
+  DEFAULT_MESSAGING_ARCHIVE_FILTER: () => DEFAULT_MESSAGING_ARCHIVE_FILTER,
   DeliveryTick: () => DeliveryTick,
   DoubleCheckIcon: () => DoubleCheckIcon,
   EmptyState: () => EmptyState,
@@ -96,6 +97,7 @@ __export(react_exports, {
   resolveActor: () => resolveActor,
   splitText: () => splitText,
   summarizeText: () => summarizeText,
+  toMessagingArchiveFilter: () => toMessagingArchiveFilter,
   unreadCutoff: () => unreadCutoff,
   useComposer: () => useComposer,
   useConversation: () => useConversation,
@@ -914,6 +916,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;
@@ -944,6 +957,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();
@@ -956,7 +971,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;
   }
@@ -1003,6 +1020,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));
@@ -1208,10 +1237,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;
@@ -1238,7 +1278,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),
@@ -1253,7 +1299,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);
@@ -1269,7 +1315,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"));
             }
           }
         ],
@@ -1280,12 +1326,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);
@@ -1549,6 +1616,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,
@@ -1558,7 +1626,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
         )
@@ -1578,6 +1651,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(
@@ -1886,6 +1982,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;
@@ -2116,6 +2213,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.");
@@ -2687,9 +2789,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] = (0, import_react5.useState)("");
+  const showingArchive = archiveFilter === "archived";
+  const archiveReveal = (0, import_react5.useMemo)(() => {
+    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 = (0, import_react5.useMemo)(() => {
     const needle = query.trim().toLowerCase();
     if (needle.length === 0) return conversations;
@@ -2722,12 +2852,22 @@ function ConversationList(props) {
         }
       ) : null
     ] }),
+    archiveReveal !== null ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "mx-msg__list-archive", children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      "button",
+      {
+        type: "button",
+        className: "mx-msg__chip",
+        onClick: () => setArchiveFilter(archiveReveal.next),
+        "aria-label": archiveReveal.ariaLabel,
+        children: archiveReveal.label
+      }
+    ) }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "mx-msg__scroll", children: [
       isInitialLoading ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ConversationSkeleton, {}) : visible.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         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__ */ (0, import_jsx_runtime4.jsx)("ul", { className: "mx-msg__rows", children: visible.map((item) => {
         const row = /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
@@ -3222,11 +3362,4 @@ 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;
 //# sourceMappingURL=react.cjs.map