doover-js 0.9.0 → 0.9.1

package/dist/react/messageRangeStore.d.ts

@@ -65,6 +65,12 @@ export declare class ChannelRangeStore {
      * between them, and claiming coverage across it would hide messages forever.
      */
     recordLive(message: MessageStructure): void;
+    /**
+     * Replace a message already held by one or more proven ranges. MessageUpdate
+     * carries the complete server representation, so both data and attachments
+     * supersede the cached create-time copy without changing range coverage.
+     */
+    recordUpdate(message: MessageStructure): void;
     /**
      * Stop trusting the live feed to extend coverage — call when the socket drops.
      * Messages sent while disconnected would leave a hole, so segments go back to

package/dist/react/messageRangeStore.js

@@ -69,6 +69,18 @@ class ChannelRangeStore {
         if (id >= tip.hi)
             tip.hi = id + 1n;
     }
+    /**
+     * Replace a message already held by one or more proven ranges. MessageUpdate
+     * carries the complete server representation, so both data and attachments
+     * supersede the cached create-time copy without changing range coverage.
+     */
+    recordUpdate(message) {
+        for (const segment of this.segments) {
+            const index = segment.messages.findIndex((item) => item.id === message.id);
+            if (index >= 0)
+                segment.messages[index] = message;
+        }
+    }
     /**
      * Stop trusting the live feed to extend coverage — call when the socket drops.
      * Messages sent while disconnected would leave a hole, so segments go back to

package/dist/react/useChannelMessages.d.ts

@@ -75,8 +75,9 @@ export interface UseChannelMessagesResult<TData> extends Omit<UseInfiniteQueryRe
 }
 /**
  * Paginated infinite query over `DooverDataProvider.getMessages`, with live
- * `messageCreate` pushes prepended/appended to the newest page. The "next"
- * page fetches older messages (cursor = oldest-loaded message id).
+ * `messageCreate` pushes are appended to the newest page and `messageUpdate`
+ * pushes replace matching cached messages. The "next" page fetches older
+ * messages (cursor = oldest-loaded message id).
  */
 export declare function useChannelMessages<TData = unknown>(identifier: ChannelIdentifier, options?: UseChannelMessagesOptions): UseChannelMessagesResult<TData>;
 export {};

package/dist/react/useChannelMessages.js

@@ -33,8 +33,9 @@ function channelMessagesQueryKey(agentId, channelName, fields, sources, anchor)
 const DEFAULT_PAGE_LIMIT = 10;
 /**
  * Paginated infinite query over `DooverDataProvider.getMessages`, with live
- * `messageCreate` pushes prepended/appended to the newest page. The "next"
- * page fetches older messages (cursor = oldest-loaded message id).
+ * `messageCreate` pushes are appended to the newest page and `messageUpdate`
+ * pushes replace matching cached messages. The "next" page fetches older
+ * messages (cursor = oldest-loaded message id).
  */
 function useChannelMessages(identifier, options) {
     const client = (0, context_1.useDooverClient)();
@@ -94,7 +95,40 @@ function useChannelMessages(identifier, options) {
     }, 
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [queryClient, agentId, channelName, fields?.join(","), sources?.join(",")]);
-    (0, useChannelSubscription_1.useChannelSubscription)(liveUpdates ? identifier : undefined, { onMessage });
+    const onMessageUpdate = (0, react_1.useCallback)((message) => {
+        // A filtered stream must not accept an update that does not belong to it.
+        // Newly qualifying messages are left for a refetch because inserting one
+        // into an arbitrary cursor page could invalidate that page's boundaries.
+        if (fields && fields.length > 0) {
+            const data = message.data;
+            if (!data ||
+                typeof data !== "object" ||
+                !fields.some((field) => field in data)) {
+                return;
+            }
+        }
+        if (rangeCacheable)
+            store.recordUpdate(message);
+        queryClient.setQueryData(key, (current) => {
+            if (!current)
+                return current;
+            let changed = false;
+            const typed = message;
+            const pages = current.pages.map((page) => page.map((item) => {
+                if (item.id !== typed.id)
+                    return item;
+                changed = true;
+                return typed;
+            }));
+            return changed ? { ...current, pages } : current;
+        });
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [queryClient, agentId, channelName, fields?.join(","), sources?.join(",")]);
+    (0, useChannelSubscription_1.useChannelSubscription)(liveUpdates ? identifier : undefined, {
+        onMessage,
+        onMessageUpdate,
+    });
     const query = (0, react_query_1.useInfiniteQuery)({
         queryKey: key,
         enabled: !!agentId && !!channelName,

package/dist/test/message-range-store.test.js

@@ -95,6 +95,22 @@ const ids = (messages) => (messages ?? []).map((m) => m.id);
         (0, chai_1.expect)(store.snapshot()).to.have.length(1);
         (0, chai_1.expect)(ids(store.read(idAt(0), 10))).to.deep.equal(ids(page));
     });
+    (0, mocha_1.it)("replaces an updated message without changing range coverage", () => {
+        const page = makeMessages(5, 20);
+        store.record({ before: idAt(0), limit: 5, page });
+        const before = store.snapshot();
+        const updated = {
+            ...page[2],
+            data: { i: 2, analysed_by: "detector" },
+            attachments: [{ id: "updated-image" }],
+        };
+        store.recordUpdate(updated);
+        const read = store.read(idAt(0), 5);
+        (0, chai_1.expect)(read[2]).to.equal(updated);
+        (0, chai_1.expect)(ids(read)).to.deep.equal(ids(page));
+        (0, chai_1.expect)(store.snapshot().map(({ lo, hi, atStart }) => ({ lo, hi, atStart })))
+            .to.deep.equal(before.map(({ lo, hi, atStart }) => ({ lo, hi, atStart })));
+    });
     (0, mocha_1.it)("keeps disjoint ranges apart rather than claiming the gap", () => {
         const ancient = makeMessages(5, 500);
         const recent = makeMessages(5, 20);

package/dist/test/react.test.js

@@ -208,7 +208,7 @@ function wrapper(client) {
         const cached = queryClient.getQueryData((0, react_2.channelAggregateQueryKey)("a1", "ui_cmds"));
         (0, chai_1.expect)(cached).to.deep.include({ data: { y: 2 }, attachments: [] });
     });
-    (0, mocha_1.it)("useChannelMessages paginates and prepends on live messageCreate", async () => {
+    (0, mocha_1.it)("useChannelMessages applies live creates and updates", async () => {
         const oldId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2025-12-31T23:59:00.000Z"));
         const newId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-01-01T00:00:01.000Z"));
         const liveId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-01-01T00:00:02.000Z"));
@@ -269,6 +269,28 @@ function wrapper(client) {
             newId,
             liveId,
         ]));
+        await (0, react_1.act)(async () => {
+            helpers_1.MockWebSocket.instances[0].receive({
+                op: 0,
+                t: "MessageUpdate",
+                d: {
+                    message: {
+                        id: newId,
+                        author_id: "u1",
+                        channel: { agent_id: "a1", name: "notes" },
+                        data: { v: 22, analysed_by: "detector" },
+                        attachments: [{ id: "analysed-image" }],
+                    },
+                    request_data: {},
+                },
+            });
+        });
+        await (0, react_1.waitFor)(() => {
+            const updated = result.current.messages.find((message) => message.id === newId);
+            (0, chai_1.expect)(updated?.data).to.deep.equal({ v: 22, analysed_by: "detector" });
+            (0, chai_1.expect)(updated?.attachments).to.have.length(1);
+            (0, chai_1.expect)(updated?.attachments?.[0]).to.deep.include({ id: "analysed-image" });
+        });
     });
     (0, mocha_1.it)("useChannelMessage seeds via REST and patches on MessageUpdate", async () => {
         const messageId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-01-01T00:00:00.000Z"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doover-js",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "TypeScript client for Doover.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",