@abraca/dabra 0.9.0 → 1.0.1

package/src/TreeTimestamps.ts

@@ -0,0 +1,51 @@
+/**
+ * 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).
+ */
+
+import * as Y from "yjs";
+import type { OfflineStore } from "./OfflineStore.ts";
+
+/**
+ * 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.
+ *
+ * @param treeMap     The root doc's "doc-tree" Y.Map.
+ * @param childDocId  The child document's UUID (key in treeMap).
+ * @param childDoc    The child Y.Doc to observe.
+ * @param offlineStore  The child provider's OfflineStore (used to detect
+ *                      offline-replay origins and skip them). Pass null when
+ *                      the offline store is disabled.
+ * @returns           Cleanup function — call on provider destroy.
+ */
+export function attachUpdatedAtObserver(
+	treeMap: Y.Map<any>,
+	childDocId: string,
+	childDoc: Y.Doc,
+	offlineStore: OfflineStore | null,
+): () => void {
+	function handler(update: Uint8Array, origin: unknown): void {
+		// Skip updates replayed from the local offline store — they represent
+		// content that was already "seen" and shouldn't advance updatedAt.
+		if (offlineStore !== null && origin === offlineStore) return;
+
+		// Update the root tree entry (no-op if the entry doesn't exist).
+		const entry = treeMap.get(childDocId);
+		if (!entry) return;
+
+		treeMap.set(childDocId, { ...entry, updatedAt: Date.now() });
+	}
+
+	childDoc.on("update", handler);
+	return () => childDoc.off("update", handler);
+}

package/src/index.ts

@@ -13,3 +13,13 @@ export { DocumentCache } from "./DocumentCache.ts";
 export type { DocumentCacheOptions } from "./DocumentCache.ts";
 export { SearchIndex } from "./SearchIndex.ts";
 export { FileBlobStore } from "./FileBlobStore.ts";
+export { DocKeyManager } from "./DocKeyManager.ts";
+export { E2EAbracadabraProvider } from "./E2EAbracadabraProvider.ts";
+export { E2EOfflineStore } from "./E2EOfflineStore.ts";
+export * from "./EncryptedY.ts";
+export type { DocEncryptionInfo } from "./types.ts";
+export { attachUpdatedAtObserver } from "./TreeTimestamps.ts";
+export { BackgroundSyncManager } from "./BackgroundSyncManager.ts";
+export type { BackgroundSyncManagerOptions } from "./BackgroundSyncManager.ts";
+export { BackgroundSyncPersistence } from "./BackgroundSyncPersistence.ts";
+export type { DocSyncState } from "./BackgroundSyncPersistence.ts";

package/src/types.ts

@@ -252,3 +252,9 @@ export interface UploadQueueEntry {
   createdAt: number;
   error?: string;
 }
+
+export interface DocEncryptionInfo {
+  mode: "none" | "cse" | "e2e";
+  effective_mode: "none" | "cse" | "e2e";
+  inherited_from?: string;
+}