@ai-matrx/messaging 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog — `@ai-matrx/messaging`
 
+## 0.15.0
+
+### Fixed
+
+- **A failed inbox read is never a skeleton forever, and never "empty"** (RC-B12
+  round 11). When the first conversation-list read failed,
+  `hasLoadedConversations` stayed false and the list showed its skeleton for as
+  long as it was open. The store now carries `conversationsLoadError`; the list
+  resolves to "Couldn't load your conversations" with a **Try again**
+  (`useConversations().retry`, `engine.refreshInbox()`), and "No conversations
+  yet" only follows a read that succeeded.
+- **Read failures render through the design-system error slot.** "Couldn't load
+  this conversation" and the inbox failure are drawn with `ErrorBox` from
+  `@ai-matrx/design-system` (new dependency), so the host fills them with its
+  error actions — in AI Matrx, the Alchemy Menu. They were `EmptyState`s before,
+  in the same grey as "No messages yet".
+
+### Added
+
+- `MessagingSnapshot.conversationsLoadError`, `MessagingStore.setConversationsLoadError`,
+  `MessagingEngine.refreshInbox()`, `useConversations().loadError` / `.retry`.
+
+## 0.14.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/messaging/v0.14.0..npm/messaging/v0.14.1 -- apps/shared/messaging`).
+No source changes intended and no consumer action required.
+
 ## 0.14.0
 
 ### Changed
@@ -811,3 +839,4 @@ consumer):
   sign-in reports `session-unavailable` instead of recovering.
 - This package supersedes host code that talks to `communication.dm_*` directly. Anything still
   reading those tables outside the package should be moved onto it or deleted.
+

package/dist/index.cjs

@@ -1045,6 +1045,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() {
@@ -1058,7 +1059,8 @@ function createMessagingStore() {
       totalUnreadConversations: conversations.filter((item) => item.unreadCount > 0).length,
       archiveFilter,
       archivedCount,
-      conversationReadFailures
+      conversationReadFailures,
+      conversationsLoadError
     };
     return cached;
   }
@@ -1103,6 +1105,12 @@ function createMessagingStore() {
       conversations = normalizeConversations(items);
       hasMoreConversations = hasMore;
       hasLoadedConversations = true;
+      conversationsLoadError = null;
+      emit();
+    },
+    setConversationsLoadError(message) {
+      if (message === conversationsLoadError) return;
+      conversationsLoadError = message;
       emit();
     },
     setArchiveFilter(next) {
@@ -1335,10 +1343,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);
@@ -1423,6 +1441,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);