@abraca/dabra 1.0.16 → 1.0.18

package/dist/abracadabra-provider.cjs

@@ -2865,9 +2865,10 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 			owner: "owner",
 			editor: "editor",
 			viewer: "viewer",
+			observer: "observer",
 			"read-write": "editor",
 			readonly: "viewer"
-		}[scope] ?? "viewer";
+		}[scope] ?? "observer";
 		this.offlineStore?.savePermissionSnapshot(this.effectiveRole);
 	}
 	/**
@@ -2922,7 +2923,10 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 		if (role && !this.effectiveRole) this.effectiveRole = role;
 	}
 	get canWrite() {
-		return this.effectiveRole != null && this.effectiveRole !== "viewer";
+		return this.effectiveRole != null && this.effectiveRole !== "viewer" && this.effectiveRole !== "observer";
+	}
+	get canAwareness() {
+		return this.effectiveRole != null && this.effectiveRole !== "observer";
 	}
 	/** The AbracadabraClient instance for REST API access, if configured. */
 	get client() {
@@ -3096,8 +3100,11 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 	}
 	destroy() {
 		this.document.off("subdocs", this.boundHandleYSubdocsChange);
+		const childIds = [...this.childProviders.keys()];
 		for (const provider of this.childProviders.values()) provider.destroy();
 		this.childProviders.clear();
+		const wsProviderMap = this.configuration.websocketProvider?.configuration?.providerMap;
+		if (wsProviderMap) for (const childId of childIds) wsProviderMap.delete(childId);
 		this.offlineStore?.destroy();
 		this.offlineStore = null;
 		super.destroy();
@@ -3305,6 +3312,10 @@ var AbracadabraClient = class {
 	async createChild(docId, opts) {
 		return this.request("POST", `/docs/${encodeURIComponent(docId)}/children`, { body: opts ?? {} });
 	}
+	/** Broadcast a stateless message to all connected clients on a document (requires manage permission). */
+	async broadcast(docId, payload) {
+		await this.request("POST", `/docs/${encodeURIComponent(docId)}/broadcast`, { body: { payload } });
+	}
 	/** List all permissions for a document (requires read access). */
 	async listPermissions(docId) {
 		if (this.cache) {
@@ -3420,6 +3431,26 @@ var AbracadabraClient = class {
 	async deleteSpace(spaceId) {
 		await this.request("DELETE", `/spaces/${encodeURIComponent(spaceId)}`);
 	}
+	/** List all users (requires elevated role: admin or service). */
+	async adminListUsers() {
+		return this.request("GET", "/admin/users");
+	}
+	/** Promote a user to admin (requires service role). */
+	async adminPromote(userId) {
+		await this.request("POST", `/admin/users/${encodeURIComponent(userId)}/admin`);
+	}
+	/** Demote an admin user back to regular (requires service role). */
+	async adminDemote(userId) {
+		await this.request("DELETE", `/admin/users/${encodeURIComponent(userId)}/admin`);
+	}
+	/** Sweep orphaned file blobs from storage (requires elevated role). */
+	async adminStorageSweep() {
+		return this.request("POST", "/admin/storage/sweep");
+	}
+	/** Repair blob ref-counts and sweep orphans (requires elevated role). */
+	async adminStorageRepair() {
+		return this.request("POST", "/admin/storage/repair");
+	}
 	/** Health check — no auth required. */
 	async health() {
 		return this.request("GET", "/health", { auth: false });
@@ -8391,7 +8422,9 @@ var BackgroundSyncManager = class extends EventEmitter {
 		this.opts = {
 			concurrency: opts?.concurrency ?? 2,
 			syncTimeout: opts?.syncTimeout ?? 15e3,
-			prefetchFiles: opts?.prefetchFiles ?? true
+			prefetchFiles: opts?.prefetchFiles ?? true,
+			throttleMs: opts?.throttleMs ?? 50,
+			maxRetries: opts?.maxRetries ?? 2
 		};
 		let serverOrigin = "default";
 		try {
@@ -8425,7 +8458,38 @@ var BackgroundSyncManager = class extends EventEmitter {
 		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, updatedAtMap.get(docId) ?? 0)));
+		const failed = [];
+		let idx = 0;
+		const next = async () => {
+			while (idx < queue.length) {
+				if (this._destroyed) return;
+				const docId = queue[idx++];
+				const updatedAt = updatedAtMap.get(docId) ?? 0;
+				if (!await this._syncWithSemaphore(docId, updatedAt)) failed.push(docId);
+				if (this.opts.throttleMs > 0 && idx < queue.length) await new Promise((r) => setTimeout(r, this.opts.throttleMs));
+			}
+		};
+		const workers = Array.from({ length: this.opts.concurrency }, () => next());
+		await Promise.all(workers);
+		for (let retry = 0; retry < this.opts.maxRetries && failed.length > 0; retry++) {
+			if (this._destroyed) return;
+			const batch = failed.splice(0, failed.length);
+			const backoff = 2e3 * 2 ** retry;
+			await new Promise((r) => setTimeout(r, backoff));
+			idx = 0;
+			const retryQueue = batch;
+			const retryNext = async () => {
+				while (idx < retryQueue.length) {
+					if (this._destroyed) return;
+					const docId = retryQueue[idx++];
+					const updatedAt = updatedAtMap.get(docId) ?? 0;
+					if (!await this._syncWithSemaphore(docId, updatedAt)) failed.push(docId);
+					if (this.opts.throttleMs > 0 && idx < retryQueue.length) await new Promise((r) => setTimeout(r, this.opts.throttleMs));
+				}
+			};
+			const retryWorkers = Array.from({ length: this.opts.concurrency }, () => retryNext());
+			await Promise.all(retryWorkers);
+		}
 	}
 	/** Sync a single document by ID. */
 	async syncDoc(docId) {
@@ -8506,15 +8570,16 @@ var BackgroundSyncManager = class extends EventEmitter {
 		items.sort((a, b) => b.priority - a.priority);
 		return items.map((i) => i.docId);
 	}
+	/** Returns true on success (or skip), false on error. */
 	async _syncWithSemaphore(docId, updatedAt) {
-		if (this._destroyed) return;
+		if (this._destroyed) return true;
 		const existing = this.syncStates.get(docId);
 		if (existing && existing.status === "synced" && existing.lastSynced !== null && existing.lastSynced >= updatedAt) {
 			this.emit("stateChanged", {
 				docId,
 				state: existing
 			});
-			return;
+			return true;
 		}
 		await this.semaphore.acquire();
 		try {
@@ -8525,6 +8590,7 @@ var BackgroundSyncManager = class extends EventEmitter {
 				docId,
 				state
 			});
+			return state.status !== "error";
 		} finally {
 			this.semaphore.release();
 		}