@abraca/dabra 2.24.0 → 2.26.0

package/dist/index.d.ts

@@ -651,14 +651,20 @@ declare class AbracadabraClient {
     effective_public_access: string | null;
   }>;
   /**
-   * Update document metadata (label, description, kind, parent_id). Requires
-   * manage permission on the doc; reparenting additionally requires manage on
-   * the new parent (or admin if moving under the server root).
+   * Update document metadata (label, description, kind, doc_type, parent_id).
+   * Requires manage permission on the doc; reparenting additionally requires
+   * manage on the new parent (or admin if moving under the server root).
+   *
+   * `doc_type` is the renderer hint (`"kanban"`, `"graph"`, …) — orthogonal
+   * to `kind` (the structural role). Use it for post-create type changes;
+   * never write renderer strings into `kind`. Servers older than migration
+   * 0014 ignore the field (unknown JSON fields are dropped server-side).
    */
   updateDocumentMeta(docId: string, opts: {
     label?: string | null;
     description?: string | null;
     kind?: string | null;
+    doc_type?: string | null;
     parent_id?: string | null;
   }): Promise<void>;
   /**
@@ -3183,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.24.0",
+  "version": "2.26.0",
   "description": "abracadabra provider",
   "keywords": [
     "abracadabra",
@@ -41,7 +41,7 @@
     "yjs": "^13.6.8"
   },
   "devDependencies": {
-    "@abraca/schema": "2.24.0"
+    "@abraca/schema": "2.26.0"
   },
   "scripts": {
     "test": "node --no-warnings --conditions=source --experimental-transform-types --test 'tests/*.test.ts'"

package/src/AbracadabraClient.ts

@@ -932,9 +932,14 @@ export class AbracadabraClient {
 	}
 
 	/**
-	 * Update document metadata (label, description, kind, parent_id). Requires
-	 * manage permission on the doc; reparenting additionally requires manage on
-	 * the new parent (or admin if moving under the server root).
+	 * Update document metadata (label, description, kind, doc_type, parent_id).
+	 * Requires manage permission on the doc; reparenting additionally requires
+	 * manage on the new parent (or admin if moving under the server root).
+	 *
+	 * `doc_type` is the renderer hint (`"kanban"`, `"graph"`, …) — orthogonal
+	 * to `kind` (the structural role). Use it for post-create type changes;
+	 * never write renderer strings into `kind`. Servers older than migration
+	 * 0014 ignore the field (unknown JSON fields are dropped server-side).
 	 */
 	async updateDocumentMeta(
 		docId: string,
@@ -942,6 +947,7 @@ export class AbracadabraClient {
 			label?: string | null;
 			description?: string | null;
 			kind?: string | null;
+			doc_type?: string | null;
 			parent_id?: string | null;
 		},
 	): Promise<void> {

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();