@ai-matrx/messaging 0.14.0 → 0.15.0

package/dist/react.cjs

@@ -983,6 +983,7 @@ function createMessagingStore() {
   let threads = /* @__PURE__ */ new Map();
   let activeConversationId = null;
   let conversationReadFailures = /* @__PURE__ */ new Map();
+  let conversationsLoadError = null;
   const listeners = /* @__PURE__ */ new Set();
   let cached = null;
   function snapshot() {
@@ -996,7 +997,8 @@ function createMessagingStore() {
       totalUnreadConversations: conversations.filter((item) => item.unreadCount > 0).length,
       archiveFilter,
       archivedCount,
-      conversationReadFailures
+      conversationReadFailures,
+      conversationsLoadError
     };
     return cached;
   }
@@ -1041,6 +1043,12 @@ function createMessagingStore() {
       conversations = normalizeConversations(items);
       hasMoreConversations = hasMore;
       hasLoadedConversations = true;
+      conversationsLoadError = null;
+      emit();
+    },
+    setConversationsLoadError(message) {
+      if (message === conversationsLoadError) return;
+      conversationsLoadError = message;
       emit();
     },
     setArchiveFilter(next) {
@@ -1273,10 +1281,20 @@ function createMessagingEngine(options) {
   }
   async function reloadInbox() {
     if (disposed) return;
-    const page = await repository.listConversations({
-      limit: conversationPageSize,
-      archived: store.snapshot().archiveFilter
-    });
+    let page;
+    try {
+      page = await repository.listConversations({
+        limit: conversationPageSize,
+        archived: store.snapshot().archiveFilter
+      });
+    } catch (error) {
+      if (!disposed) {
+        store.setConversationsLoadError(
+          error instanceof Error ? error.message : typeof error === "string" ? error : "The conversation list could not be read."
+        );
+      }
+      throw error;
+    }
     if (disposed) return;
     conversationCursor = page.nextCursor;
     store.setConversations(page.items, page.hasMore);
@@ -1361,6 +1379,13 @@ function createMessagingEngine(options) {
         }
       });
     },
+    async refreshInbox() {
+      try {
+        await reloadInbox();
+      } catch (error) {
+        reportError(error, "inboxRefresh");
+      }
+    },
     async setArchiveFilter(next) {
       if (next === store.snapshot().archiveFilter) return;
       store.setArchiveFilter(next);
@@ -2504,7 +2529,11 @@ function useConversations() {
     hasMore: snapshot?.hasMoreConversations ?? false,
     // "Not loaded yet" is a FACT from the store, never a guess. Showing
     // "No conversations yet" before the first read is a screen telling a lie.
-    isInitialLoading: snapshot === null || !snapshot.hasLoadedConversations,
+    isInitialLoading: snapshot === null || !snapshot.hasLoadedConversations && snapshot.conversationsLoadError === null,
+    loadError: snapshot?.conversationsLoadError ?? null,
+    retry: () => {
+      void host?.engine.refreshInbox();
+    },
     totalUnreadConversations: snapshot?.totalUnreadConversations ?? 0,
     loadMore: () => {
       void host?.engine.loadMoreConversations();
@@ -3086,6 +3115,7 @@ function EmptyState(props) {
 }
 
 // src/react/components.tsx
+var import_design_system = require("@ai-matrx/design-system");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var AI_LABELS = {
   catchUp: "Catch me up",
@@ -3103,7 +3133,9 @@ function ConversationList(props) {
     activeConversationId,
     archiveFilter,
     setArchiveFilter,
-    archivedCount
+    archivedCount,
+    loadError,
+    retry
   } = useConversations();
   const RowChrome = useMessagingHost()?.wrapConversationRow ?? null;
   const [query, setQuery] = (0, import_react5.useState)("");
@@ -3168,7 +3200,20 @@ function ConversationList(props) {
       }
     ) }) : 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)(
+      isInitialLoading ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ConversationSkeleton, {}) : loadError !== null && visible.length === 0 ? (
+        // A failed read resolves to the failure — never a skeleton forever,
+        // never "No conversations yet" (RC-B12 round 11). ErrorBox is the
+        // design-system error slot: the host fills it with its menu.
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          ReadFailureBox,
+          {
+            title: "Couldn't load your conversations",
+            message: loadError,
+            operation: "List your conversations",
+            onRetry: retry
+          }
+        )
+      ) : visible.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         EmptyState,
         {
           title: query.length > 0 ? "No matches" : showingArchive ? "No archived conversations" : "No conversations yet",
@@ -3345,10 +3390,11 @@ function ConversationView(props) {
         body: "It doesn't exist, or you aren't a member of it."
       }
     ) : conversation.error !== null && messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-      EmptyState,
+      ReadFailureBox,
       {
         title: "Couldn't load this conversation",
-        body: "Check your connection, then open it again."
+        message: conversation.error.message || "Check your connection, then open it again.",
+        operation: "Open this conversation"
       }
     ) : messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(EmptyState, { title: "No messages yet", body: "Say something to get started." }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "mx-msg__messages", children: [
       conversation.hasMoreOlder ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
@@ -3679,4 +3725,27 @@ function MessagingInbox(props) {
     }
   );
 }
+function ReadFailureBox({
+  title,
+  message,
+  operation,
+  onRetry
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "mx-msg__empty", role: "alert", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      import_design_system.ErrorBox,
+      {
+        as: "div",
+        title,
+        message,
+        operation,
+        origin: "messaging",
+        style: { color: "var(--mx-msg-danger)", fontWeight: 600 },
+        children: title
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { children: message }),
+    onRetry ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("button", { type: "button", className: "mx-msg__button mx-msg__button--ghost", onClick: onRetry, children: "Try again" }) : null
+  ] });
+}
 //# sourceMappingURL=react.cjs.map