@natoe/colab 0.1.14 → 0.1.16

package/dist/index.d.mts

@@ -380,6 +380,20 @@ type PresenceCallback = (presences: Record<string, {
     userId: string;
     isOnline: boolean;
 }>) => void;
+/**
+ * Server-pushed unread counts. The backend broadcasts BOTH keyings in
+ * one payload so consumers can render badges at either granularity (FAB
+ * + inbox row use `conversation`; table-row chat icons use `order`) off
+ * a single socket event. Legacy backends that send a flat
+ * `Record<string, number>` are normalised at the socket boundary into
+ * `{ conversation: <flat>, order: {} }` for forward compatibility.
+ */
+interface UnreadCounts {
+    /** keyed by conversation id */
+    conversation: Record<string, number>;
+    /** keyed by order id — used for table-row chat-icon badges */
+    order: Record<string, number>;
+}
 interface ConversationCallbacks {
     onMessage?: MessageCallback;
     onTyping?: TypingCallback;
@@ -433,8 +447,10 @@ declare class CollabSocket {
     connect(config: CollabConfig): void;
     /** Subscribe to user-level events (unread counts, notifications) */
     private joinUserChannel;
-    /** Register callback for unread count changes */
-    onUnreadCountUpdate(callback: (counts: Record<string, number>) => void): void;
+    /** Register callback for unread count changes. The callback receives
+     *  the normalised {@link UnreadCounts} shape regardless of which
+     *  payload format the backend pushed. */
+    onUnreadCountUpdate(callback: (counts: UnreadCounts) => void): void;
     /**
      * Join a conversation channel and subscribe to events.
      *
@@ -512,6 +528,13 @@ interface CollabContextValue {
      * mounting their own useConversation.
      */
     unreadCounts: Record<string, number>;
+    /**
+     * Same unread counts, but keyed by **order ID** instead of
+     * conversation ID. Useful for table-row chat-icon badges where the
+     * row only knows its order_id, not the conversation_id. Same socket
+     * push updates both maps in lock-step.
+     */
+    unreadCountsByOrder: Record<string, number>;
     /** Batched preview lookup — coalesces calls within a microtask */
     requestPreview: (orderId: string) => Promise<ConversationPreview | null>;
     /** Invalidate a cached preview (e.g. when a new message arrives) */

package/dist/index.d.ts

@@ -380,6 +380,20 @@ type PresenceCallback = (presences: Record<string, {
     userId: string;
     isOnline: boolean;
 }>) => void;
+/**
+ * Server-pushed unread counts. The backend broadcasts BOTH keyings in
+ * one payload so consumers can render badges at either granularity (FAB
+ * + inbox row use `conversation`; table-row chat icons use `order`) off
+ * a single socket event. Legacy backends that send a flat
+ * `Record<string, number>` are normalised at the socket boundary into
+ * `{ conversation: <flat>, order: {} }` for forward compatibility.
+ */
+interface UnreadCounts {
+    /** keyed by conversation id */
+    conversation: Record<string, number>;
+    /** keyed by order id — used for table-row chat-icon badges */
+    order: Record<string, number>;
+}
 interface ConversationCallbacks {
     onMessage?: MessageCallback;
     onTyping?: TypingCallback;
@@ -433,8 +447,10 @@ declare class CollabSocket {
     connect(config: CollabConfig): void;
     /** Subscribe to user-level events (unread counts, notifications) */
     private joinUserChannel;
-    /** Register callback for unread count changes */
-    onUnreadCountUpdate(callback: (counts: Record<string, number>) => void): void;
+    /** Register callback for unread count changes. The callback receives
+     *  the normalised {@link UnreadCounts} shape regardless of which
+     *  payload format the backend pushed. */
+    onUnreadCountUpdate(callback: (counts: UnreadCounts) => void): void;
     /**
      * Join a conversation channel and subscribe to events.
      *
@@ -512,6 +528,13 @@ interface CollabContextValue {
      * mounting their own useConversation.
      */
     unreadCounts: Record<string, number>;
+    /**
+     * Same unread counts, but keyed by **order ID** instead of
+     * conversation ID. Useful for table-row chat-icon badges where the
+     * row only knows its order_id, not the conversation_id. Same socket
+     * push updates both maps in lock-step.
+     */
+    unreadCountsByOrder: Record<string, number>;
     /** Batched preview lookup — coalesces calls within a microtask */
     requestPreview: (orderId: string) => Promise<ConversationPreview | null>;
     /** Invalidate a cached preview (e.g. when a new message arrives) */

package/dist/index.js

@@ -63,6 +63,19 @@ function toCamelKey(key) {
 }
 
 // src/core/socket.ts
+function normalizeUnreadPayload(payload) {
+  if (payload && typeof payload === "object") {
+    const obj = payload;
+    if (obj.conversation && typeof obj.conversation === "object") {
+      return {
+        conversation: obj.conversation,
+        order: obj.order && typeof obj.order === "object" ? obj.order : {}
+      };
+    }
+    return { conversation: payload, order: {} };
+  }
+  return { conversation: {}, order: {} };
+}
 var CollabSocket = class {
   constructor() {
     this.socket = null;
@@ -128,7 +141,7 @@ var CollabSocket = class {
     if (!this.socket || !this.config) return;
     this.userChannel = this.socket.channel("user_notifications", {});
     this.userChannel.on("unread_update", (payload) => {
-      this.onUnreadUpdate?.(payload);
+      this.onUnreadUpdate?.(normalizeUnreadPayload(payload));
     });
     this.userChannel.join().receive("ok", () => {
     }).receive("error", (reason) => {
@@ -139,7 +152,9 @@ var CollabSocket = class {
       });
     });
   }
-  /** Register callback for unread count changes */
+  /** Register callback for unread count changes. The callback receives
+   *  the normalised {@link UnreadCounts} shape regardless of which
+   *  payload format the backend pushed. */
   onUnreadCountUpdate(callback) {
     this.onUnreadUpdate = callback;
   }
@@ -583,6 +598,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
     return new CollabSocket();
   });
   const [unreadCounts, setUnreadCounts] = React4.useState({});
+  const [unreadCountsByOrder, setUnreadCountsByOrder] = React4.useState({});
   const pendingOrderIds = React4.useRef(/* @__PURE__ */ new Set());
   const pendingResolvers = React4.useRef(/* @__PURE__ */ new Map());
   const previewCache = React4.useRef(/* @__PURE__ */ new Map());
@@ -598,7 +614,8 @@ function CollabProvider({ config, apiBaseUrl, children }) {
       setSocket(s);
     }
     s.onUnreadCountUpdate((counts) => {
-      setUnreadCounts(counts);
+      setUnreadCounts(counts.conversation);
+      setUnreadCountsByOrder(counts.order);
       previewCache.current.clear();
     });
     if (!s.isConnected()) {
@@ -806,6 +823,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
         apiBaseUrl,
         totalUnread,
         unreadCounts,
+        unreadCountsByOrder,
         requestPreview,
         invalidatePreview,
         fetchMessages,
@@ -6327,7 +6345,7 @@ function useUnreadCount() {
   const [counts, setCounts] = React4.useState({});
   React4.useEffect(() => {
     socket.onUnreadCountUpdate((serverCounts) => {
-      setCounts(serverCounts);
+      setCounts(serverCounts.conversation);
     });
   }, [socket]);
   const getCountForConversation = React4.useCallback(