loro-repo 0.6.0 → 0.7.0

package/README.md

@@ -44,6 +44,8 @@ await repo.unloadDoc("note:welcome");
 ## Using the API
 
 - **Create a repo** with `await LoroRepo.create<Meta>({ transportAdapter?, storageAdapter?, assetTransportAdapter?, docFrontierDebounceMs? })`; metadata is hydrated automatically.
+- **Swap or attach a transport later** by calling `await repo.setTransportAdapter(adapter)` (useful when booting offline, then enabling realtime once connectivity/auth is ready).
+- **Check adapter availability** with `repo.hasTransport()` / `repo.hasStorage()` before calling `joinMetaRoom` / `joinDocRoom`.
 - **Define your metadata contract** once via the generic `Meta`. All metadata helpers (`upsertDocMeta`, `getDocMeta`, `listDoc`, `watch`) stay type-safe.
 - **Choose sync lanes** with `repo.sync({ scope: "meta" | "doc" | "full", docIds?: string[] })` to pull remote changes on demand.
 - **Work with documents** using `openPersistedDoc(docId)` for repo-managed docs (persisted snapshots + frontier tracking) and `openDetachedDoc(docId)` for isolated snapshots; call `joinDocRoom`/`handle.joinRoom` for live sync, or `unloadDoc`/`flush` to persist and drop cached docs.

package/dist/index.cjs

@@ -1585,6 +1585,11 @@ var SyncRunner = class {
 		this.getMetaFlock = options.getMetaFlock;
 		this.replaceMetaFlock = options.mergeFlock;
 	}
+	setTransport(transport) {
+		if (this.transport === transport) return;
+		this.leaveRooms();
+		this.transport = transport;
+	}
 	async ready() {
 		if (!this.readyPromise) this.readyPromise = this.initialize();
 		await this.readyPromise;
@@ -1754,6 +1759,16 @@ var SyncRunner = class {
 	get metaFlock() {
 		return this.getMetaFlock();
 	}
+	leaveRooms() {
+		if (this.metaRoomSubscription) {
+			this.metaRoomSubscription.base.unsubscribe();
+			this.metaRoomSubscription = void 0;
+		}
+		for (const record of this.docSubscriptions.values()) record.base.unsubscribe();
+		this.docSubscriptions.clear();
+		this.unsubscribeMetaFlock?.();
+		this.unsubscribeMetaFlock = void 0;
+	}
 };
 
 //#endregion
@@ -1916,7 +1931,6 @@ var MetaPersister = class {
 const DEFAULT_DOC_FRONTIER_DEBOUNCE_MS = 1e3;
 const DEFAULT_DELETED_DOC_KEEP_MS = 720 * 60 * 60 * 1e3;
 var LoroRepo = class LoroRepo {
-	options;
 	_destroyed = false;
 	transport;
 	storage;
@@ -1933,7 +1947,6 @@ var LoroRepo = class LoroRepo {
 	deletedDocKeepMs;
 	purgeWatchHandle;
 	constructor(options) {
-		this.options = options;
 		this.transport = options.transportAdapter;
 		this.storage = options.storageAdapter;
 		this.assetTransport = options.assetTransportAdapter;
@@ -2026,6 +2039,25 @@ var LoroRepo = class LoroRepo {
 		await this.syncRunner.sync(options);
 	}
 	/**
+	* Sets (or replaces) the transport adapter used for syncing and realtime rooms.
+	*
+	* Swapping transports will leave any joined meta/doc rooms managed by the repo.
+	*/
+	async setTransportAdapter(transport) {
+		if (this._destroyed) throw new Error("Repo has been destroyed");
+		if (this.transport === transport) return;
+		const previous = this.transport;
+		this.transport = transport;
+		this.syncRunner.setTransport(transport);
+		await previous?.close();
+	}
+	hasTransport() {
+		return Boolean(this.transport);
+	}
+	hasStorage() {
+		return Boolean(this.storage);
+	}
+	/**
 	* Start syncing the metadata (Flock) room. It will establish a realtime connection to the transport adaptor.
 	* All changes on the room will be synced to the Flock, and all changes on the Flock will be synced to the room.
 	*