@abraca/dabra 1.3.3 → 1.5.0

package/dist/abracadabra-provider.esm.js

@@ -3520,6 +3520,34 @@ var AbracadabraClient = class {
 	async adminStorageRepair() {
 		return this.request("POST", "/admin/storage/repair");
 	}
+	/** List snapshot metadata for a document. */
+	async listSnapshots(docId, opts) {
+		const params = new URLSearchParams();
+		if (opts?.limit != null) params.set("limit", String(opts.limit));
+		if (opts?.offset != null) params.set("offset", String(opts.offset));
+		const qs = params.toString();
+		return (await this.request("GET", `/docs/${encodeURIComponent(docId)}/snapshots${qs ? `?${qs}` : ""}`)).snapshots;
+	}
+	/** Fetch a single snapshot including its base64-encoded data blob. */
+	async getSnapshot(docId, version) {
+		return this.request("GET", `/docs/${encodeURIComponent(docId)}/snapshots/${version}`);
+	}
+	/** Create a manual snapshot of the current document state. */
+	async createSnapshot(docId, opts) {
+		return this.request("POST", `/docs/${encodeURIComponent(docId)}/snapshots`, { body: opts ?? {} });
+	}
+	/** Delete a specific snapshot version. Requires manage permission. */
+	async deleteSnapshot(docId, version) {
+		await this.request("DELETE", `/docs/${encodeURIComponent(docId)}/snapshots/${version}`);
+	}
+	/** Restore a snapshot by merging it forward into the current document state. */
+	async restoreSnapshot(docId, version) {
+		return this.request("POST", `/docs/${encodeURIComponent(docId)}/snapshots/${version}/restore`, { body: {} });
+	}
+	/** Fork a snapshot into a new document. */
+	async forkSnapshot(docId, version) {
+		return this.request("POST", `/docs/${encodeURIComponent(docId)}/snapshots/${version}/fork`, { body: {} });
+	}
 	/** Health check — no auth required. */
 	async health() {
 		return this.request("GET", "/health", { auth: false });
@@ -10830,6 +10858,19 @@ var E2EAbracadabraProvider = class E2EAbracadabraProvider extends AbracadabraPro
 //#endregion
 //#region packages/provider/src/TreeTimestamps.ts
 /**
+* 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.
+*
+* This propagates "last edited" timestamps to all peers via the root CRDT,
+* without requiring any server-side changes.
+*
+* Limitation: at least one client must have the child doc open after an edit
+* for the timestamp to propagate (eventually consistent).
+*/
+/**
 * Attach an observer that writes `updatedAt: Date.now()` to the root
 * doc-tree entry for `childDocId` whenever the child doc receives a
 * non-offline update.
@@ -10845,8 +10886,9 @@ var E2EAbracadabraProvider = class E2EAbracadabraProvider extends AbracadabraPro
 function attachUpdatedAtObserver(treeMap, childDocId, childDoc, offlineStore) {
 	function handler(update, origin) {
 		if (offlineStore !== null && origin === offlineStore) return;
-		const entry = treeMap.get(childDocId);
-		if (!entry) return;
+		const raw = treeMap.get(childDocId);
+		if (!raw) return;
+		const entry = raw instanceof Y.Map ? raw.toJSON() : raw;
 		treeMap.set(childDocId, {
 			...entry,
 			updatedAt: Date.now()