@abraca/dabra 1.0.14 → 1.0.16

package/dist/abracadabra-provider.cjs

@@ -1005,9 +1005,20 @@ var EventEmitter = class {
 		this.callbacks[event].push(fn);
 		return this;
 	}
+	once(event, fn) {
+		const wrapper = (...args) => {
+			this.off(event, wrapper);
+			fn.apply(this, args);
+		};
+		return this.on(event, wrapper);
+	}
 	emit(event, ...args) {
 		const callbacks = this.callbacks[event];
-		if (callbacks) callbacks.forEach((callback) => callback.apply(this, args));
+		if (callbacks) for (const callback of callbacks) try {
+			callback.apply(this, args);
+		} catch (err) {
+			console.error(`[EventEmitter] Error in "${event}" listener:`, err);
+		}
 		return this;
 	}
 	off(event, fn) {
@@ -1847,7 +1858,11 @@ var AbracadabraWS = class extends EventEmitter {
 		this.resolveConnectionAttempt();
 		this.lastMessageReceived = getUnixTime();
 		const documentName = new IncomingMessage(event.data).peekVarString();
-		this.configuration.providerMap.get(documentName)?.onMessage(event);
+		try {
+			this.configuration.providerMap.get(documentName)?.onMessage(event);
+		} catch (err) {
+			console.error(`[AbracadabraWS] Provider onMessage error for "${documentName}":`, err);
+		}
 	}
 	resolveConnectionAttempt() {
 		if (this.connectionAttempt) {
@@ -2274,6 +2289,10 @@ var AwarenessError = class extends Error {
 	}
 };
 var AbracadabraBaseProvider = class extends EventEmitter {
+	/** Current WebSocket connection status. */
+	get connectionStatus() {
+		return this.configuration.websocketProvider.status;
+	}
 	constructor(configuration) {
 		super();
 		this.configuration = {
@@ -2707,6 +2726,22 @@ var OfflineStore = class {
 		const tx = db.transaction("meta", "readwrite");
 		await txPromise$2(tx.objectStore("meta"), tx.objectStore("meta").put(value, `meta:${key}`));
 	}
+	/**
+	* Clear all stored data (updates, snapshots, state vectors, subdoc queue).
+	* The database itself is kept but emptied.
+	*/
+	async clearAll() {
+		const db = await this.getDb();
+		if (!db) return;
+		const storeNames = Array.from(db.objectStoreNames);
+		if (storeNames.length === 0) return;
+		const tx = db.transaction(storeNames, "readwrite");
+		await Promise.all(storeNames.map((name) => new Promise((resolve, reject) => {
+			const req = tx.objectStore(name).clear();
+			req.onsuccess = () => resolve();
+			req.onerror = () => reject(req.error);
+		})));
+	}
 	destroy() {
 		this._destroyed = true;
 		this.db = null;
@@ -2792,7 +2827,9 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 		this.document.on("subdocs", this.boundHandleYSubdocsChange);
 		this.on("synced", () => this.flushPendingUpdates());
 		this.restorePermissionSnapshot();
-		this.ready = this._initFromOfflineStore();
+		this.ready = Promise.race([this._initFromOfflineStore(), new Promise((resolve) => setTimeout(resolve, 5e3))]).catch((err) => {
+			this.emit("error", { message: `Offline store init failed: ${err?.message ?? err}` });
+		});
 	}
 	/**
 	* Extract the server hostname from the provider configuration.
@@ -2910,7 +2947,9 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 		}
 		const msg = parsed;
 		if (msg.type === "auth_challenge" && msg.challenge && msg.expiresAt) {
-			this.handleAuthChallenge(msg.challenge, msg.expiresAt).catch(() => null);
+			this.handleAuthChallenge(msg.challenge, msg.expiresAt).catch((err) => {
+				this.emit("authenticationFailed", { reason: `Auth challenge error: ${err?.message ?? err}` });
+			});
 			return;
 		}
 		if (msg.type === "subdoc_registered" && msg.child_id && msg.parent_id) {
@@ -2952,6 +2991,14 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 			createdAt: Date.now()
 		});
 	}
+	/** Get a loaded child provider by ID, or null if not yet loaded. */
+	getChild(childId) {
+		return this.childProviders.get(childId) ?? null;
+	}
+	/** Check if a child provider is already loaded. */
+	hasChild(childId) {
+		return this.childProviders.has(childId);
+	}
 	/**
 	* Create (or return cached) a child AbracadabraProvider for a given
 	* child document id.  Each child opens its own WebSocket connection because
@@ -3082,6 +3129,17 @@ var AbracadabraClient = class {
 	get isAuthenticated() {
 		return this._token !== null;
 	}
+	/** Check if the current JWT token is present and not expired. */
+	isTokenValid() {
+		if (!this._token) return false;
+		try {
+			const [, payload] = this._token.split(".");
+			const { exp } = JSON.parse(atob(payload));
+			return typeof exp === "number" && exp * 1e3 > Date.now();
+		} catch {
+			return false;
+		}
+	}
 	/** Derives ws:// or wss:// URL from the http(s) base URL. */
 	get wsUrl() {
 		return this.baseUrl.replace(/^https:\/\//, "wss://").replace(/^http:\/\//, "ws://") + "/ws";
@@ -3175,12 +3233,7 @@ var AbracadabraClient = class {
 	}
 	/** Get the caller's key envelope for a document (for decrypting the DocKey). */
 	async getMyKeyEnvelope(docId) {
-		try {
-			return await this.request("GET", `/docs/${encodeURIComponent(docId)}/key-envelope`);
-		} catch (e) {
-			if (typeof e === "object" && e !== null && "status" in e && e.status === 404) return null;
-			throw e;
-		}
+		return this.requestOrNull("GET", `/docs/${encodeURIComponent(docId)}/key-envelope`);
 	}
 	/** Upload key envelopes for a document (Owner only). */
 	async uploadKeyEnvelopes(docId, opts) {
@@ -3188,12 +3241,7 @@ var AbracadabraClient = class {
 	}
 	/** Get the X25519 public key for a user. */
 	async getUserX25519Key(userId) {
-		try {
-			return (await this.request("GET", `/users/${encodeURIComponent(userId)}/x25519-key`)).x25519_key;
-		} catch (e) {
-			if (typeof e === "object" && e !== null && "status" in e && e.status === 404) return null;
-			throw e;
-		}
+		return (await this.requestOrNull("GET", `/users/${encodeURIComponent(userId)}/x25519-key`))?.x25519_key ?? null;
 	}
 	/** List all non-revoked keys for a user (Owner/Admin or self). */
 	async listUserKeys(userId) {
@@ -3271,14 +3319,15 @@ var AbracadabraClient = class {
 	async listEffectivePermissions(docId) {
 		try {
 			return await this.request("GET", `/docs/${encodeURIComponent(docId)}/effective-permissions`);
-		} catch {
-			return {
+		} catch (e) {
+			if (typeof e === "object" && e !== null && "status" in e && e.status === 404) return {
 				permissions: (await this.listPermissions(docId)).map((p) => ({
 					...p,
 					source: "direct"
 				})),
 				default_role: "viewer"
 			};
+			throw e;
 		}
 	}
 	/** Grant or change a user's role on a document (requires Owner). */
@@ -3357,12 +3406,7 @@ var AbracadabraClient = class {
 	}
 	/** Get the hub space, or null if none is configured. */
 	async getHubSpace() {
-		try {
-			return await this.request("GET", "/spaces/hub", { auth: false });
-		} catch (e) {
-			if (typeof e === "object" && e !== null && "status" in e && e.status === 404) return null;
-			throw e;
-		}
+		return this.requestOrNull("GET", "/spaces/hub", { auth: false });
 	}
 	/** Create a new space (auth required). */
 	async createSpace(opts) {
@@ -3405,25 +3449,35 @@ var AbracadabraClient = class {
 		if (auth && this._token) headers["Authorization"] = `Bearer ${this._token}`;
 		const init = {
 			method,
-			headers
+			headers,
+			signal: AbortSignal.timeout(3e4)
 		};
 		if (opts?.body !== void 0) {
 			headers["Content-Type"] = "application/json";
 			init.body = JSON.stringify(opts.body);
 		}
 		const res = await this._fetch(`${this.baseUrl}${path}`, init);
-		if (!res.ok) throw await this.toError(res);
+		if (!res.ok) throw await this.toError(res, method, path);
 		if (res.status === 204) return;
 		return res.json();
 	}
-	async toError(res) {
+	async requestOrNull(method, path, opts) {
+		try {
+			return await this.request(method, path, opts);
+		} catch (e) {
+			if (typeof e === "object" && e !== null && "status" in e && e.status === 404) return null;
+			throw e;
+		}
+	}
+	async toError(res, method, path) {
 		let message;
 		try {
 			message = (await res.json()).error ?? res.statusText;
 		} catch {
 			message = res.statusText;
 		}
-		const err = new Error(message);
+		const prefix = method && path ? `${method} ${path}: ` : "";
+		const err = /* @__PURE__ */ new Error(`${prefix}${message} (${res.status})`);
 		err.status = res.status;
 		return err;
 	}
@@ -7442,6 +7496,7 @@ var SearchIndex = class {
 		if (!db) return [];
 		const queryTrigrams = [...extractTrigrams(query)];
 		if (queryTrigrams.length === 0) return [];
+		const maxScoreEntries = limit * 10;
 		return new Promise((resolve, reject) => {
 			const tx = db.transaction("postings", "readonly");
 			const postings = tx.objectStore("postings");
@@ -7451,7 +7506,10 @@ var SearchIndex = class {
 				const req = postings.get(trigram);
 				req.onsuccess = () => {
 					const docIds = req.result ?? [];
-					for (const docId of docIds) scores.set(docId, (scores.get(docId) ?? 0) + 1);
+					for (const docId of docIds) {
+						scores.set(docId, (scores.get(docId) ?? 0) + 1);
+						if (scores.size >= maxScoreEntries) break;
+					}
 					remaining--;
 					if (remaining === 0) resolve([...scores.entries()].map(([docId, score]) => ({
 						docId,
@@ -7509,7 +7567,7 @@ var FileBlobStore = class FileBlobStore extends EventEmitter {
 		this.db = null;
 		this.objectUrls = /* @__PURE__ */ new Map();
 		this._notFound = /* @__PURE__ */ new Map();
-		this._flushing = false;
+		this._flushPromise = null;
 		this.origin = serverOrigin;
 		this.client = client ?? null;
 		this._onlineHandler = () => {
@@ -7651,6 +7709,20 @@ var FileBlobStore = class FileBlobStore extends EventEmitter {
 			req.onerror = () => reject(req.error);
 		});
 	}
+	/**
+	* Revoke the in-memory object URL without touching the IDB cache.
+	* The next call to getBlobUrl() will re-create a fresh URL from IDB.
+	* Use this when an <img> @error fires — the blob data is fine, only
+	* the object URL reference is stale.
+	*/
+	invalidateUrl(docId, uploadId) {
+		const key = this.blobKey(docId, uploadId);
+		const url = this.objectUrls.get(key);
+		if (url) {
+			URL.revokeObjectURL(url);
+			this.objectUrls.delete(key);
+		}
+	}
 	/** Revoke the object URL and remove the blob from cache. */
 	async evictBlob(docId, uploadId) {
 		const key = this.blobKey(docId, uploadId);
@@ -7703,38 +7775,42 @@ var FileBlobStore = class FileBlobStore extends EventEmitter {
 	* Entries that fail are marked with status "error" and left in the queue.
 	*/
 	async flushQueue() {
-		if (this._flushing || !this.client) return;
-		this._flushing = true;
+		if (this._flushPromise || !this.client) return;
+		this._flushPromise = this._doFlush();
 		try {
-			const pending = (await this.getQueue()).filter((e) => e.status === "pending");
-			for (const entry of pending) {
-				await this._updateQueueEntry(entry.id, { status: "uploading" });
-				this.emit("upload:started", {
+			await this._flushPromise;
+		} finally {
+			this._flushPromise = null;
+		}
+	}
+	async _doFlush() {
+		if (!this.client) return;
+		const pending = (await this.getQueue()).filter((e) => e.status === "pending");
+		for (const entry of pending) {
+			await this._updateQueueEntry(entry.id, { status: "uploading" });
+			this.emit("upload:started", {
+				...entry,
+				status: "uploading"
+			});
+			try {
+				await this.client.upload(entry.docId, entry.file, entry.filename);
+				await this._updateQueueEntry(entry.id, { status: "done" });
+				this.emit("upload:done", {
 					...entry,
-					status: "uploading"
+					status: "done"
+				});
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				await this._updateQueueEntry(entry.id, {
+					status: "error",
+					error: message
+				});
+				this.emit("upload:error", {
+					...entry,
+					status: "error",
+					error: message
 				});
-				try {
-					await this.client.upload(entry.docId, entry.file, entry.filename);
-					await this._updateQueueEntry(entry.id, { status: "done" });
-					this.emit("upload:done", {
-						...entry,
-						status: "done"
-					});
-				} catch (err) {
-					const message = err instanceof Error ? err.message : String(err);
-					await this._updateQueueEntry(entry.id, {
-						status: "error",
-						error: message
-					});
-					this.emit("upload:error", {
-						...entry,
-						status: "error",
-						error: message
-					});
-				}
 			}
-		} finally {
-			this._flushing = false;
 		}
 	}
 	async _updateQueueEntry(id, patch) {
@@ -7782,10 +7858,13 @@ const HKDF_INFO$1 = new TextEncoder().encode("abracadabra-dockey-v1");
 function fromBase64$1(b64) {
 	return Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
 }
-var DocKeyManager = class {
+var DocKeyManager = class DocKeyManager {
 	constructor() {
 		this.cache = /* @__PURE__ */ new Map();
 	}
+	static {
+		this.CACHE_TTL = 600 * 1e3;
+	}
 	/** Generate a new random AES-256-GCM document key. */
 	static async generateDocKey() {
 		return crypto.subtle.generateKey({
@@ -7799,7 +7878,7 @@ var DocKeyManager = class {
 	*/
 	async getDocKey(docId, client, keystore) {
 		const cached = this.cache.get(docId);
-		if (cached) return cached.key;
+		if (cached && Date.now() - cached.fetchedAt < DocKeyManager.CACHE_TTL) return cached.key;
 		const envelope = await client.getMyKeyEnvelope(docId);
 		if (!envelope) return null;
 		const x25519PrivKey = await keystore.getX25519PrivateKey();
@@ -7808,7 +7887,8 @@ var DocKeyManager = class {
 			const docKey = await this._unwrapKey(wrapped, x25519PrivKey, docId);
 			this.cache.set(docId, {
 				key: docKey,
-				epoch: envelope.key_epoch
+				epoch: envelope.key_epoch,
+				fetchedAt: Date.now()
 			});
 			return docKey;
 		} finally {
@@ -8304,6 +8384,7 @@ var BackgroundSyncManager = class extends EventEmitter {
 		super();
 		this.syncStates = /* @__PURE__ */ new Map();
 		this._destroyed = false;
+		this._initPromise = null;
 		this.rootProvider = rootProvider;
 		this.client = client;
 		this.fileBlobStore = fileBlobStore ?? null;
@@ -8319,18 +8400,36 @@ var BackgroundSyncManager = class extends EventEmitter {
 		this.persistence = new BackgroundSyncPersistence(serverOrigin);
 		this.semaphore = new Semaphore(this.opts.concurrency);
 	}
+	/**
+	* Load persisted sync states from IndexedDB into the in-memory map.
+	* Called automatically by syncAll() / syncDoc(); safe to call concurrently.
+	*/
+	async init() {
+		if (!this._initPromise) this._initPromise = this._loadPersistedStates();
+		return this._initPromise;
+	}
+	async _loadPersistedStates() {
+		try {
+			const states = await this.persistence.getAllStates();
+			for (const state of states) this.syncStates.set(state.docId, state);
+		} catch {}
+	}
 	/** Sync all documents in the root tree. */
 	async syncAll() {
 		if (this._destroyed) return;
+		await this.init();
 		const treeMap = this.rootProvider.document.getMap("doc-tree");
 		const entries = Array.from(treeMap.entries());
 		if (entries.length === 0) return;
+		const updatedAtMap = /* @__PURE__ */ new Map();
+		for (const [docId, v] of entries) updatedAtMap.set(docId, v?.updatedAt ?? v?.createdAt ?? 0);
 		this._prefetchCovers(entries).catch(() => null);
 		const queue = this._buildQueue(entries);
-		await Promise.all(queue.map((docId) => this._syncWithSemaphore(docId)));
+		await Promise.all(queue.map((docId) => this._syncWithSemaphore(docId, updatedAtMap.get(docId) ?? 0)));
 	}
 	/** Sync a single document by ID. */
 	async syncDoc(docId) {
+		await this.init();
 		const state = await this._doSyncDoc(docId);
 		this.syncStates.set(docId, state);
 		await this.persistence.setState(state).catch(() => null);
@@ -8355,6 +8454,32 @@ var BackgroundSyncManager = class extends EventEmitter {
 		}, intervalMs);
 		return () => clearInterval(handle);
 	}
+	/**
+	* Clear all offline document data and sync state.
+	* Opens each document's OfflineStore and clears its contents, then
+	* resets the background sync persistence. After calling this, all
+	* documents will need to be re-synced.
+	*/
+	async clearAllSyncedData() {
+		const docIds = new Set(this.syncStates.keys());
+		const treeMap = this.rootProvider.document.getMap("doc-tree");
+		for (const docId of treeMap.keys()) docIds.add(docId);
+		let serverOrigin;
+		try {
+			serverOrigin = new URL(this.client.baseUrl ?? "").hostname;
+		} catch {}
+		const clearPromises = Array.from(docIds).map(async (docId) => {
+			try {
+				const store = new OfflineStore(docId, serverOrigin);
+				await store.clearAll();
+				store.destroy();
+			} catch {}
+		});
+		await Promise.all(clearPromises);
+		for (const docId of docIds) await this.persistence.deleteState(docId).catch(() => null);
+		this.syncStates.clear();
+		this._initPromise = null;
+	}
 	destroy() {
 		this._destroyed = true;
 		this.removeAllListeners();
@@ -8381,8 +8506,16 @@ var BackgroundSyncManager = class extends EventEmitter {
 		items.sort((a, b) => b.priority - a.priority);
 		return items.map((i) => i.docId);
 	}
-	async _syncWithSemaphore(docId) {
+	async _syncWithSemaphore(docId, updatedAt) {
 		if (this._destroyed) return;
+		const existing = this.syncStates.get(docId);
+		if (existing && existing.status === "synced" && existing.lastSynced !== null && existing.lastSynced >= updatedAt) {
+			this.emit("stateChanged", {
+				docId,
+				state: existing
+			});
+			return;
+		}
 		await this.semaphore.acquire();
 		try {
 			const state = await this._doSyncDoc(docId);
@@ -8408,8 +8541,8 @@ var BackgroundSyncManager = class extends EventEmitter {
 			docId,
 			state: syncing
 		});
+		let isE2E = false;
 		try {
-			let isE2E = false;
 			try {
 				isE2E = (await this.client.getDocEncryption(docId)).mode === "e2e";
 			} catch {}
@@ -8422,7 +8555,7 @@ var BackgroundSyncManager = class extends EventEmitter {
 				status: "error",
 				lastSynced: this.syncStates.get(docId)?.lastSynced ?? null,
 				error,
-				isE2E: false
+				isE2E
 			};
 		}
 	}
@@ -8555,6 +8688,7 @@ var SignalingSocket = class extends EventEmitter {
 		this.connectionAttempt = null;
 		this.localPeerId = null;
 		this.isConnected = false;
+		this._connectPromise = null;
 		this.config = {
 			url: configuration.url,
 			token: configuration.token,
@@ -8574,6 +8708,15 @@ var SignalingSocket = class extends EventEmitter {
 	}
 	async connect() {
 		if (this.isConnected) return;
+		if (this._connectPromise) return this._connectPromise;
+		this._connectPromise = this._doConnect();
+		try {
+			await this._connectPromise;
+		} finally {
+			this._connectPromise = null;
+		}
+	}
+	async _doConnect() {
 		if (this.cancelRetry) {
 			this.cancelRetry();
 			this.cancelRetry = void 0;
@@ -8887,11 +9030,12 @@ var DataChannelRouter = class extends EventEmitter {
 	*/
 	async send(name, data) {
 		const channel = this.channels.get(name);
-		if (!channel || channel.readyState !== "open") return;
+		if (!channel || channel.readyState !== "open") return false;
 		if (this.encryptor?.isEstablished && !this.plaintextChannels.has(name)) {
 			const encrypted = await this.encryptor.encrypt(data);
 			channel.send(encrypted);
 		} else channel.send(data);
+		return true;
 	}
 	registerChannel(channel) {
 		channel.binaryType = "arraybuffer";
@@ -9059,6 +9203,7 @@ var YjsDataChannel = class {
 		this.document = document;
 		this.awareness = awareness;
 		this.router = router;
+		this.isSynced = false;
 		this.docUpdateHandler = null;
 		this.awarenessUpdateHandler = null;
 		this.channelOpenHandler = null;
@@ -9295,6 +9440,10 @@ var FileTransferChannel = class extends EventEmitter {
 		try {
 			meta = JSON.parse(json);
 		} catch {
+			this.emit("receiveError", {
+				transferId: "unknown",
+				error: "Malformed START message: invalid JSON"
+			});
 			return;
 		}
 		this.receives.set(meta.transferId, {
@@ -10001,7 +10150,9 @@ var ManualSignaling = class extends EventEmitter {
 			type: "offer",
 			sdp: offerBlob.sdp
 		}));
-		for (const c of offerBlob.candidates) await this.pc.addIceCandidate(new RTCIceCandidate(JSON.parse(c)));
+		for (const c of offerBlob.candidates) try {
+			await this.pc.addIceCandidate(new RTCIceCandidate(JSON.parse(c)));
+		} catch {}
 		const answer = await this.pc.createAnswer();
 		await this.pc.setLocalDescription(answer);
 		await gatheringComplete;