@abraca/dabra 1.0.21 → 1.0.22

package/dist/abracadabra-provider.cjs

@@ -2822,7 +2822,7 @@ var AbracadabraProvider = class AbracadabraProvider extends AbracadabraBaseProvi
 		this._client = client;
 		this.abracadabraConfig = configuration;
 		this.subdocLoading = configuration.subdocLoading ?? "lazy";
-		const serverOrigin = AbracadabraProvider.deriveServerOrigin(configuration, client);
+		const serverOrigin = configuration.serverAgnostic ? void 0 : AbracadabraProvider.deriveServerOrigin(configuration, client);
 		this.offlineStore = configuration.disableOfflineStore ? null : new OfflineStore(configuration.name, serverOrigin);
 		this.on("subdocRegistered", configuration.onSubdocRegistered ?? (() => null));
 		this.on("subdocLoaded", configuration.onSubdocLoaded ?? (() => null));
@@ -10747,6 +10747,305 @@ var BroadcastChannelSync = class BroadcastChannelSync extends EventEmitter {
 	}
 };
 
+//#endregion
+//#region packages/provider/src/IdentityDoc.ts
+/**
+* Derives a deterministic UUID from an Ed25519 account-level public key.
+*
+* The result is a valid UUID v5-style string that any device sharing the
+* same identity can independently compute.  The `abracadabra:identity:`
+* prefix prevents collisions with randomly generated doc UUIDs.
+*
+* @param publicKeyB64 Base64url-encoded Ed25519 public key (32 bytes).
+*/
+function deriveIdentityDocId(publicKeyB64) {
+	const hash = sha256(new TextEncoder().encode(`abracadabra:identity:${publicKeyB64}`));
+	const bytes = new Uint8Array(hash.buffer, hash.byteOffset, 16);
+	bytes[6] = bytes[6] & 15 | 80;
+	bytes[8] = bytes[8] & 63 | 128;
+	const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+/**
+* Manages a Y.Doc dedicated to user identity that syncs across trusted
+* targets only: a designated sync server, a local Tauri server, and/or
+* WebRTC P2P.
+*
+* The Y.Doc contains cross-device settings (profile, servers, spaces,
+* plugins, preferences).  Each sync target gets its own
+* AbracadabraProvider sharing the same Y.Doc, with `serverAgnostic: true`
+* so they all use one IndexedDB store.
+*/
+var IdentityDocProvider = class extends EventEmitter {
+	constructor(configuration) {
+		super();
+		this.providers = /* @__PURE__ */ new Map();
+		this.websockets = /* @__PURE__ */ new Map();
+		this.webrtc = null;
+		this._destroyed = false;
+		this.config = configuration;
+		this.docId = deriveIdentityDocId(configuration.publicKey);
+		this.document = new yjs.Doc({ guid: this.docId });
+		if (configuration.autoConnect !== false) this.connect();
+	}
+	connect() {
+		if (this._destroyed) return;
+		const targets = [];
+		if (this.config.localServerUrl) targets.push({
+			url: this.config.localServerUrl,
+			key: "local"
+		});
+		if (this.config.syncServerUrl) targets.push({
+			url: this.config.syncServerUrl,
+			key: "sync"
+		});
+		for (const { url, key } of targets) {
+			if (this.providers.has(key)) continue;
+			this._connectToServer(key, url);
+		}
+		if (this.config.webrtc && !this.webrtc) this._connectWebRTC();
+	}
+	_connectToServer(key, serverUrl) {
+		const token = this.config.tokens?.[serverUrl] ?? this.config.token ?? "";
+		const ws = new AbracadabraWS({
+			url: serverUrl.replace(/^http/, "ws").replace(/\/$/, "").concat("/ws"),
+			WebSocketPolyfill: void 0
+		});
+		this.websockets.set(key, ws);
+		const provider = new AbracadabraProvider({
+			name: this.docId,
+			document: this.document,
+			websocketProvider: ws,
+			token,
+			serverAgnostic: true,
+			disableOfflineStore: key !== "local" && key !== "sync" ? true : this.config.disableOfflineStore ?? false,
+			...this.config.providerDefaults
+		});
+		provider.on("synced", () => this.emit("synced", { server: key }));
+		provider.on("status", (data) => this.emit("status", {
+			server: key,
+			...data
+		}));
+		this.providers.set(key, provider);
+	}
+	_connectWebRTC() {
+		const rtcConfig = this.config.webrtc;
+		if (!rtcConfig) return;
+		this.webrtc = new AbracadabraWebRTC({
+			docId: this.docId,
+			url: rtcConfig.signalingServerUrl,
+			token: rtcConfig.token,
+			document: this.document,
+			enableDocSync: true,
+			enableAwarenessSync: false,
+			enableFileTransfer: false,
+			e2ee: rtcConfig.e2ee,
+			iceServers: rtcConfig.iceServers
+		});
+	}
+	get profileMap() {
+		return this.document.getMap("profile");
+	}
+	get serversMap() {
+		return this.document.getMap("servers");
+	}
+	get spacesArray() {
+		return this.document.getArray("spaces");
+	}
+	get pluginsMap() {
+		return this.document.getMap("plugins");
+	}
+	get preferencesMap() {
+		return this.document.getMap("preferences");
+	}
+	getProfile() {
+		const m = this.profileMap;
+		return {
+			username: m.get("username"),
+			displayName: m.get("displayName"),
+			colorName: m.get("colorName"),
+			neutralColorName: m.get("neutralColorName"),
+			locale: m.get("locale"),
+			avatarUrl: m.get("avatarUrl")
+		};
+	}
+	setProfile(profile) {
+		const m = this.profileMap;
+		this.document.transact(() => {
+			for (const [key, value] of Object.entries(profile)) if (value !== void 0) m.set(key, value);
+		});
+	}
+	getServer(url) {
+		const entry = this.serversMap.get(url);
+		if (!entry) return void 0;
+		return {
+			label: entry.get("label") ?? url,
+			hubDocId: entry.get("hubDocId"),
+			entryDocId: entry.get("entryDocId"),
+			defaultRole: entry.get("defaultRole"),
+			spacesEnabled: entry.get("spacesEnabled"),
+			addedAt: entry.get("addedAt") ?? 0
+		};
+	}
+	setServer(url, entry) {
+		const m = this.serversMap;
+		this.document.transact(() => {
+			let yEntry = m.get(url);
+			if (!yEntry) {
+				yEntry = new yjs.Map();
+				m.set(url, yEntry);
+			}
+			for (const [key, value] of Object.entries(entry)) if (value !== void 0) yEntry.set(key, value);
+		});
+	}
+	removeServer(url) {
+		this.serversMap.delete(url);
+	}
+	getServers() {
+		const result = /* @__PURE__ */ new Map();
+		this.serversMap.forEach((entry, url) => {
+			result.set(url, {
+				label: entry.get("label") ?? url,
+				hubDocId: entry.get("hubDocId"),
+				entryDocId: entry.get("entryDocId"),
+				defaultRole: entry.get("defaultRole"),
+				spacesEnabled: entry.get("spacesEnabled"),
+				addedAt: entry.get("addedAt") ?? 0
+			});
+		});
+		return result;
+	}
+	getSpaces() {
+		const result = [];
+		this.spacesArray.forEach((yMap) => {
+			result.push({
+				id: yMap.get("id"),
+				name: yMap.get("name"),
+				type: yMap.get("type") ?? "remote",
+				serverUrl: yMap.get("serverUrl") ?? null,
+				docId: yMap.get("docId"),
+				remoteSpaceId: yMap.get("remoteSpaceId"),
+				visibility: yMap.get("visibility") ?? "private",
+				isHub: yMap.get("isHub") ?? false,
+				order: yMap.get("order") ?? 0,
+				lastSyncedAt: yMap.get("lastSyncedAt"),
+				createdAt: yMap.get("createdAt") ?? 0
+			});
+		});
+		return result;
+	}
+	addSpace(space) {
+		const yMap = new yjs.Map();
+		this.document.transact(() => {
+			for (const [key, value] of Object.entries(space)) if (value !== void 0) yMap.set(key, value);
+			this.spacesArray.push([yMap]);
+		});
+	}
+	removeSpace(spaceId) {
+		const arr = this.spacesArray;
+		for (let i = 0; i < arr.length; i++) if (arr.get(i).get("id") === spaceId) {
+			arr.delete(i, 1);
+			return;
+		}
+	}
+	updateSpace(spaceId, updates) {
+		const arr = this.spacesArray;
+		for (let i = 0; i < arr.length; i++) {
+			const yMap = arr.get(i);
+			if (yMap.get("id") === spaceId) {
+				this.document.transact(() => {
+					for (const [key, value] of Object.entries(updates)) if (value !== void 0) yMap.set(key, value);
+				});
+				return;
+			}
+		}
+	}
+	getExternalPlugins() {
+		let arr = this.pluginsMap.get("external");
+		if (!arr) {
+			arr = new yjs.Array();
+			this.pluginsMap.set("external", arr);
+		}
+		return arr;
+	}
+	getDisabledBuiltins() {
+		let arr = this.pluginsMap.get("disabledBuiltins");
+		if (!arr) {
+			arr = new yjs.Array();
+			this.pluginsMap.set("disabledBuiltins", arr);
+		}
+		return arr;
+	}
+	getPreference(key) {
+		return this.preferencesMap.get(key);
+	}
+	setPreference(key, value) {
+		this.preferencesMap.set(key, value);
+	}
+	/**
+	* Observe deep changes on a specific top-level map.
+	* Returns an unsubscribe function.
+	*/
+	observe(mapName, callback) {
+		const map = this.document.getMap(mapName);
+		map.observeDeep(callback);
+		return () => map.unobserveDeep(callback);
+	}
+	/**
+	* Observe changes to the spaces array.
+	* Returns an unsubscribe function.
+	*/
+	observeSpaces(callback) {
+		const arr = this.spacesArray;
+		arr.observe(callback);
+		return () => arr.unobserve(callback);
+	}
+	/**
+	* Returns true if the identity doc has no profile data yet (first use).
+	* Call this to decide whether to run migration from localStorage.
+	*/
+	isEmpty() {
+		return this.profileMap.size === 0 && this.serversMap.size === 0;
+	}
+	/**
+	* Update the sync server URL at runtime (e.g. when user changes their
+	* designated sync server in settings).
+	*/
+	setSyncServer(url) {
+		const existing = this.providers.get("sync");
+		if (existing) {
+			existing.destroy();
+			this.providers.delete("sync");
+		}
+		const existingWs = this.websockets.get("sync");
+		if (existingWs) {
+			existingWs.destroy();
+			this.websockets.delete("sync");
+		}
+		if (url) {
+			this.config = {
+				...this.config,
+				syncServerUrl: url
+			};
+			this._connectToServer("sync", url);
+		}
+	}
+	getProvider(key) {
+		return this.providers.get(key);
+	}
+	destroy() {
+		if (this._destroyed) return;
+		this._destroyed = true;
+		for (const [, provider] of this.providers) provider.destroy();
+		for (const [, ws] of this.websockets) ws.destroy();
+		if (this.webrtc) this.webrtc.disconnect?.();
+		this.providers.clear();
+		this.websockets.clear();
+		this.webrtc = null;
+		this.document.destroy();
+	}
+};
+
 //#endregion
 exports.AbracadabraBaseProvider = AbracadabraBaseProvider;
 exports.AbracadabraClient = AbracadabraClient;
@@ -10778,6 +11077,7 @@ exports.FileTransferHandle = FileTransferHandle;
 exports.Forbidden = Forbidden;
 exports.HocuspocusProvider = HocuspocusProvider;
 exports.HocuspocusProviderWebsocket = HocuspocusProviderWebsocket;
+exports.IdentityDocProvider = IdentityDocProvider;
 exports.KEY_EXCHANGE_CHANNEL = KEY_EXCHANGE_CHANNEL;
 exports.ManualSignaling = ManualSignaling;
 exports.MessageTooBig = MessageTooBig;
@@ -10795,6 +11095,7 @@ exports.YjsDataChannel = YjsDataChannel;
 exports.attachUpdatedAtObserver = attachUpdatedAtObserver;
 exports.awarenessStatesToArray = awarenessStatesToArray;
 exports.decryptField = decryptField;
+exports.deriveIdentityDocId = deriveIdentityDocId;
 exports.encryptField = encryptField;
 exports.makeEncryptedYMap = makeEncryptedYMap;
 exports.makeEncryptedYText = makeEncryptedYText;