@abraca/dabra 2.25.0 → 2.26.0

package/dist/index.d.ts

@@ -3189,7 +3189,7 @@ declare function makeEncryptedYText(ydoc: Y.Doc, fieldName: string, docKey: Cryp
 //#region packages/provider/src/TreeTimestamps.d.ts
 /**
  * Attach an observer that writes `updatedAt` to the root doc-tree entry for
- * `childDocId` whenever the child doc receives a non-offline update.
+ * `childDocId` whenever the child doc receives a local edit.
  *
  * @param treeMap       The root doc's "doc-tree" Y.Map.
  * @param childDocId    The child document's UUID (key in treeMap).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abraca/dabra",
-  "version": "2.25.0",
+  "version": "2.26.0",
   "description": "abracadabra provider",
   "keywords": [
     "abracadabra",
@@ -41,7 +41,7 @@
     "yjs": "^13.6.8"
   },
   "devDependencies": {
-    "@abraca/schema": "2.25.0"
+    "@abraca/schema": "2.26.0"
   },
   "scripts": {
     "test": "node --no-warnings --conditions=source --experimental-transform-types --test 'tests/*.test.ts'"

package/src/TreeTimestamps.ts

@@ -1,9 +1,9 @@
 /**
  * TreeTimestamps
  *
- * Attaches an afterUpdate observer on a child Y.Doc so that whenever a
- * non-offline update is applied, the `updatedAt` timestamp on the
- * corresponding entry in the root doc's `doc-tree` map is written.
+ * Attaches an afterTransaction observer on a child Y.Doc so that whenever a
+ * LOCAL edit is made, the `updatedAt` timestamp on the corresponding entry
+ * in the root doc's `doc-tree` map is written.
  *
  * This propagates "last edited" timestamps to all peers via the root CRDT,
  * without requiring any server-side changes.
@@ -20,7 +20,7 @@ import type { OfflineStore } from "./OfflineStore.ts";
 
 /**
  * Attach an observer that writes `updatedAt` to the root doc-tree entry for
- * `childDocId` whenever the child doc receives a non-offline update.
+ * `childDocId` whenever the child doc receives a local edit.
  *
  * @param treeMap       The root doc's "doc-tree" Y.Map.
  * @param childDocId    The child document's UUID (key in treeMap).
@@ -64,8 +64,17 @@ export function attachUpdatedAtObserver(
 		writeTs(ts);
 	}
 
-	function handler(_update: Uint8Array, origin: unknown): void {
-		if (offlineStore !== null && origin === offlineStore) return;
+	function handler(tr: Y.Transaction): void {
+		// Only LOCAL edits stamp updatedAt. Remote updates (tr.local === false:
+		// initial sync replay, other peers' edits, offline-store replay,
+		// cross-tab broadcast) are stamped by the client that made them and the
+		// timestamp propagates through the root CRDT — counting them here
+		// turned "last edited" into "last synced on this client": merely
+		// opening a doc bumped its updatedAt to now.
+		if (!tr.local) return;
+		if (offlineStore !== null && tr.origin === offlineStore) return;
+		// No-op transactions (nothing actually changed) don't count as edits.
+		if (tr.changed.size === 0) return;
 
 		const now = Date.now();
 		if (now - lastFlushedAt >= throttleMs) {
@@ -80,10 +89,10 @@ export function attachUpdatedAtObserver(
 		}
 	}
 
-	childDoc.on("update", handler);
+	childDoc.on("afterTransaction", handler);
 
 	return () => {
-		childDoc.off("update", handler);
+		childDoc.off("afterTransaction", handler);
 		if (timer !== null) {
 			clearTimeout(timer);
 			flushPending();