loro-repo 0.5.0 → 0.5.2

package/dist/storage/indexeddb.cjs

@@ -0,0 +1,261 @@
+const require_chunk = require('../chunk.cjs');
+let __loro_dev_flock = require("@loro-dev/flock");
+__loro_dev_flock = require_chunk.__toESM(__loro_dev_flock);
+let loro_crdt = require("loro-crdt");
+loro_crdt = require_chunk.__toESM(loro_crdt);
+
+//#region src/storage/indexeddb.ts
+const DEFAULT_DB_NAME = "loro-repo";
+const DEFAULT_DB_VERSION = 1;
+const DEFAULT_DOC_STORE = "docs";
+const DEFAULT_META_STORE = "meta";
+const DEFAULT_ASSET_STORE = "assets";
+const DEFAULT_DOC_UPDATE_STORE = "doc-updates";
+const DEFAULT_META_KEY = "snapshot";
+const textDecoder = new TextDecoder();
+function describeUnknown(cause) {
+	if (typeof cause === "string") return cause;
+	if (typeof cause === "number" || typeof cause === "boolean") return String(cause);
+	if (typeof cause === "bigint") return cause.toString();
+	if (typeof cause === "symbol") return cause.description ?? cause.toString();
+	if (typeof cause === "function") return `[function ${cause.name ?? "anonymous"}]`;
+	if (cause && typeof cause === "object") try {
+		return JSON.stringify(cause);
+	} catch {
+		return "[object]";
+	}
+	return String(cause);
+}
+var IndexedDBStorageAdaptor = class {
+	idb;
+	dbName;
+	version;
+	docStore;
+	docUpdateStore;
+	metaStore;
+	assetStore;
+	metaKey;
+	dbPromise;
+	closed = false;
+	constructor(options = {}) {
+		const idbFactory = globalThis.indexedDB;
+		if (!idbFactory) throw new Error("IndexedDB is not available in this environment");
+		this.idb = idbFactory;
+		this.dbName = options.dbName ?? DEFAULT_DB_NAME;
+		this.version = options.version ?? DEFAULT_DB_VERSION;
+		this.docStore = options.docStoreName ?? DEFAULT_DOC_STORE;
+		this.docUpdateStore = options.docUpdateStoreName ?? DEFAULT_DOC_UPDATE_STORE;
+		this.metaStore = options.metaStoreName ?? DEFAULT_META_STORE;
+		this.assetStore = options.assetStoreName ?? DEFAULT_ASSET_STORE;
+		this.metaKey = options.metaKey ?? DEFAULT_META_KEY;
+	}
+	async save(payload) {
+		const db = await this.ensureDb();
+		switch (payload.type) {
+			case "doc-snapshot": {
+				const snapshot = payload.snapshot.slice();
+				await this.storeMergedSnapshot(db, payload.docId, snapshot);
+				break;
+			}
+			case "doc-update": {
+				const update = payload.update.slice();
+				await this.appendDocUpdate(db, payload.docId, update);
+				break;
+			}
+			case "asset": {
+				const bytes = payload.data.slice();
+				await this.putBinary(db, this.assetStore, payload.assetId, bytes);
+				break;
+			}
+			case "meta": {
+				const bytes = payload.update.slice();
+				await this.putBinary(db, this.metaStore, this.metaKey, bytes);
+				break;
+			}
+			default: throw new Error("Unsupported storage payload type");
+		}
+	}
+	async deleteAsset(assetId) {
+		const db = await this.ensureDb();
+		await this.deleteKey(db, this.assetStore, assetId);
+	}
+	async loadDoc(docId) {
+		const db = await this.ensureDb();
+		const snapshot = await this.getBinaryFromDb(db, this.docStore, docId);
+		const pendingUpdates = await this.getDocUpdates(db, docId);
+		if (!snapshot && pendingUpdates.length === 0) return;
+		let doc;
+		try {
+			doc = snapshot ? loro_crdt.LoroDoc.fromSnapshot(snapshot) : new loro_crdt.LoroDoc();
+		} catch (error) {
+			throw this.createError(`Failed to hydrate document snapshot for "${docId}"`, error);
+		}
+		let appliedUpdates = false;
+		for (const update of pendingUpdates) try {
+			doc.import(update);
+			appliedUpdates = true;
+		} catch (error) {
+			throw this.createError(`Failed to apply queued document update for "${docId}"`, error);
+		}
+		if (appliedUpdates) {
+			let consolidated;
+			try {
+				consolidated = doc.export({ mode: "snapshot" });
+			} catch (error) {
+				throw this.createError(`Failed to export consolidated snapshot for "${docId}"`, error);
+			}
+			await this.writeSnapshot(db, docId, consolidated);
+			await this.clearDocUpdates(db, docId);
+		}
+		return doc;
+	}
+	async loadMeta() {
+		const bytes = await this.getBinary(this.metaStore, this.metaKey);
+		if (!bytes) return void 0;
+		try {
+			const json = textDecoder.decode(bytes);
+			const bundle = JSON.parse(json);
+			const flock = new __loro_dev_flock.Flock();
+			flock.importJson(bundle);
+			return flock;
+		} catch (error) {
+			throw this.createError("Failed to hydrate metadata snapshot", error);
+		}
+	}
+	async loadAsset(assetId) {
+		return await this.getBinary(this.assetStore, assetId) ?? void 0;
+	}
+	async close() {
+		this.closed = true;
+		const db = await this.dbPromise;
+		if (db) db.close();
+		this.dbPromise = void 0;
+	}
+	async ensureDb() {
+		if (this.closed) throw new Error("IndexedDBStorageAdaptor has been closed");
+		if (!this.dbPromise) this.dbPromise = new Promise((resolve, reject) => {
+			const request = this.idb.open(this.dbName, this.version);
+			request.addEventListener("upgradeneeded", () => {
+				const db = request.result;
+				this.ensureStore(db, this.docStore);
+				this.ensureStore(db, this.docUpdateStore);
+				this.ensureStore(db, this.metaStore);
+				this.ensureStore(db, this.assetStore);
+			});
+			request.addEventListener("success", () => resolve(request.result), { once: true });
+			request.addEventListener("error", () => {
+				reject(this.createError(`Failed to open IndexedDB database "${this.dbName}"`, request.error));
+			}, { once: true });
+		});
+		return this.dbPromise;
+	}
+	ensureStore(db, storeName) {
+		const names = db.objectStoreNames;
+		if (this.storeExists(names, storeName)) return;
+		db.createObjectStore(storeName);
+	}
+	storeExists(names, storeName) {
+		if (typeof names.contains === "function") return names.contains(storeName);
+		const length = names.length ?? 0;
+		for (let index = 0; index < length; index += 1) if (names.item?.(index) === storeName) return true;
+		return false;
+	}
+	async storeMergedSnapshot(db, docId, incoming) {
+		await this.runInTransaction(db, this.docStore, "readwrite", async (store) => {
+			const existingRaw = await this.wrapRequest(store.get(docId), "read");
+			const existing = await this.normalizeBinary(existingRaw);
+			const merged = this.mergeSnapshots(docId, existing, incoming);
+			await this.wrapRequest(store.put(merged, docId), "write");
+		});
+	}
+	mergeSnapshots(docId, existing, incoming) {
+		try {
+			const doc = existing ? loro_crdt.LoroDoc.fromSnapshot(existing) : new loro_crdt.LoroDoc();
+			doc.import(incoming);
+			return doc.export({ mode: "snapshot" });
+		} catch (error) {
+			throw this.createError(`Failed to merge snapshot for "${docId}"`, error);
+		}
+	}
+	async appendDocUpdate(db, docId, update) {
+		await this.runInTransaction(db, this.docUpdateStore, "readwrite", async (store) => {
+			const raw = await this.wrapRequest(store.get(docId), "read");
+			const queue = await this.normalizeUpdateQueue(raw);
+			queue.push(update.slice());
+			await this.wrapRequest(store.put({ updates: queue }, docId), "write");
+		});
+	}
+	async getDocUpdates(db, docId) {
+		const raw = await this.runInTransaction(db, this.docUpdateStore, "readonly", (store) => this.wrapRequest(store.get(docId), "read"));
+		return this.normalizeUpdateQueue(raw);
+	}
+	async clearDocUpdates(db, docId) {
+		await this.runInTransaction(db, this.docUpdateStore, "readwrite", (store) => this.wrapRequest(store.delete(docId), "delete"));
+	}
+	async writeSnapshot(db, docId, snapshot) {
+		await this.putBinary(db, this.docStore, docId, snapshot.slice());
+	}
+	async getBinaryFromDb(db, storeName, key) {
+		const value = await this.runInTransaction(db, storeName, "readonly", (store) => this.wrapRequest(store.get(key), "read"));
+		return this.normalizeBinary(value);
+	}
+	async normalizeUpdateQueue(value) {
+		if (value == null) return [];
+		const list = Array.isArray(value) ? value : typeof value === "object" && value !== null ? value.updates : void 0;
+		if (!Array.isArray(list)) return [];
+		const queue = [];
+		for (const entry of list) {
+			const bytes = await this.normalizeBinary(entry);
+			if (bytes) queue.push(bytes);
+		}
+		return queue;
+	}
+	async putBinary(db, storeName, key, value) {
+		await this.runInTransaction(db, storeName, "readwrite", (store) => this.wrapRequest(store.put(value, key), "write"));
+	}
+	async deleteKey(db, storeName, key) {
+		await this.runInTransaction(db, storeName, "readwrite", (store) => this.wrapRequest(store.delete(key), "delete"));
+	}
+	async getBinary(storeName, key) {
+		const db = await this.ensureDb();
+		return this.getBinaryFromDb(db, storeName, key);
+	}
+	runInTransaction(db, storeName, mode, executor) {
+		const tx = db.transaction(storeName, mode);
+		const store = tx.objectStore(storeName);
+		const completion = new Promise((resolve, reject) => {
+			tx.addEventListener("complete", () => resolve(), { once: true });
+			tx.addEventListener("abort", () => reject(this.createError("IndexedDB transaction aborted", tx.error)), { once: true });
+			tx.addEventListener("error", () => reject(this.createError("IndexedDB transaction failed", tx.error)), { once: true });
+		});
+		return Promise.all([executor(store), completion]).then(([result]) => result);
+	}
+	wrapRequest(request, action) {
+		return new Promise((resolve, reject) => {
+			request.addEventListener("success", () => resolve(request.result), { once: true });
+			request.addEventListener("error", () => reject(this.createError(`IndexedDB request failed during ${action}`, request.error)), { once: true });
+		});
+	}
+	async normalizeBinary(value) {
+		if (value == null) return void 0;
+		if (value instanceof Uint8Array) return value.slice();
+		if (ArrayBuffer.isView(value)) return new Uint8Array(value.buffer, value.byteOffset, value.byteLength).slice();
+		if (value instanceof ArrayBuffer) return new Uint8Array(value.slice(0));
+		if (typeof value === "object" && value !== null && "arrayBuffer" in value) {
+			const candidate = value;
+			if (typeof candidate.arrayBuffer === "function") {
+				const buffer = await candidate.arrayBuffer();
+				return new Uint8Array(buffer);
+			}
+		}
+	}
+	createError(message, cause) {
+		if (cause instanceof Error) return new Error(`${message}: ${cause.message}`, { cause });
+		if (cause !== void 0 && cause !== null) return /* @__PURE__ */ new Error(`${message}: ${describeUnknown(cause)}`);
+		return new Error(message);
+	}
+};
+
+//#endregion
+exports.IndexedDBStorageAdaptor = IndexedDBStorageAdaptor;
+//# sourceMappingURL=indexeddb.cjs.map

package/dist/storage/indexeddb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.cjs","names":["doc: LoroDoc","LoroDoc","consolidated: Uint8Array","Flock","queue: Uint8Array[]"],"sources":["../../src/storage/indexeddb.ts"],"sourcesContent":["import { Flock } from \"@loro-dev/flock\";\nimport { LoroDoc } from \"loro-crdt\";\n\nimport type {\n  AssetId,\n  StorageAdapter,\n  StorageSavePayload,\n} from \"../types\";\nimport type { ExportBundle } from \"@loro-dev/flock\";\n\nconst DEFAULT_DB_NAME = \"loro-repo\";\nconst DEFAULT_DB_VERSION = 1;\nconst DEFAULT_DOC_STORE = \"docs\";\nconst DEFAULT_META_STORE = \"meta\";\nconst DEFAULT_ASSET_STORE = \"assets\";\nconst DEFAULT_DOC_UPDATE_STORE = \"doc-updates\";\nconst DEFAULT_META_KEY = \"snapshot\";\n\ntype EventListenerOptions = {\n  once?: boolean;\n};\n\ntype IDBFactory = {\n  open(name: string, version?: number): IDBOpenDBRequest;\n};\n\ntype IDBOpenDBRequest = {\n  result: IDBDatabase;\n  error: unknown;\n  onupgradeneeded: ((event: unknown) => void) | null;\n  onsuccess: ((event: unknown) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  addEventListener(\n    type: string,\n    listener: (event: unknown) => void,\n    options?: EventListenerOptions,\n  ): void;\n};\n\ntype ObjectStoreNames = {\n  contains?(name: string): boolean;\n  length?: number;\n  item?(index: number): string | null;\n};\n\ntype IDBDatabase = {\n  close(): void;\n  createObjectStore(name: string): IDBObjectStore;\n  transaction(\n    storeName: string,\n    mode?: IDBTransactionMode,\n  ): IDBTransaction;\n  objectStoreNames: ObjectStoreNames;\n};\n\ntype IDBTransactionMode = \"readonly\" | \"readwrite\";\n\ntype IDBTransaction = {\n  objectStore(name: string): IDBObjectStore;\n  oncomplete: ((event: unknown) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  onabort: ((event: unknown) => void) | null;\n  error: unknown;\n  addEventListener(\n    type: string,\n    listener: (event: unknown) => void,\n    options?: EventListenerOptions,\n  ): void;\n};\n\ntype IDBObjectStore = {\n  put(value: unknown, key?: unknown): IDBRequest<unknown>;\n  get(key: unknown): IDBRequest<unknown>;\n  delete(key: unknown): IDBRequest<unknown>;\n};\n\ntype IDBRequest<T> = {\n  onsuccess: ((event: unknown) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  result: T;\n  error: unknown;\n  addEventListener(\n    type: string,\n    listener: (event: unknown) => void,\n    options?: EventListenerOptions,\n  ): void;\n};\n\nconst textDecoder = new TextDecoder();\n\nfunction describeUnknown(cause: unknown): string {\n  if (typeof cause === \"string\") return cause;\n  if (typeof cause === \"number\" || typeof cause === \"boolean\") {\n    return String(cause);\n  }\n  if (typeof cause === \"bigint\") {\n    return cause.toString();\n  }\n  if (typeof cause === \"symbol\") {\n    return cause.description ?? cause.toString();\n  }\n  if (typeof cause === \"function\") {\n    return `[function ${cause.name ?? \"anonymous\"}]`;\n  }\n  if (cause && typeof cause === \"object\") {\n    try {\n      return JSON.stringify(cause);\n    } catch {\n      return \"[object]\";\n    }\n  }\n  return String(cause);\n}\n\nexport interface IndexedDBStorageAdaptorOptions {\n  readonly dbName?: string;\n  readonly version?: number;\n  readonly docStoreName?: string;\n  readonly docUpdateStoreName?: string;\n  readonly metaStoreName?: string;\n  readonly assetStoreName?: string;\n  readonly metaKey?: string;\n}\n\nexport class IndexedDBStorageAdaptor implements StorageAdapter {\n  private readonly idb: IDBFactory;\n  private readonly dbName: string;\n  private readonly version: number;\n  private readonly docStore: string;\n  private readonly docUpdateStore: string;\n  private readonly metaStore: string;\n  private readonly assetStore: string;\n  private readonly metaKey: string;\n  private dbPromise?: Promise<IDBDatabase>;\n  private closed = false;\n\n  constructor(options: IndexedDBStorageAdaptorOptions = {}) {\n    const idbFactory = (globalThis as { indexedDB?: IDBFactory }).indexedDB;\n    if (!idbFactory) {\n      throw new Error(\"IndexedDB is not available in this environment\");\n    }\n    this.idb = idbFactory;\n    this.dbName = options.dbName ?? DEFAULT_DB_NAME;\n    this.version = options.version ?? DEFAULT_DB_VERSION;\n    this.docStore = options.docStoreName ?? DEFAULT_DOC_STORE;\n    this.docUpdateStore = options.docUpdateStoreName ?? DEFAULT_DOC_UPDATE_STORE;\n    this.metaStore = options.metaStoreName ?? DEFAULT_META_STORE;\n    this.assetStore = options.assetStoreName ?? DEFAULT_ASSET_STORE;\n    this.metaKey = options.metaKey ?? DEFAULT_META_KEY;\n  }\n\n  async save(payload: StorageSavePayload): Promise<void> {\n    const db = await this.ensureDb();\n    switch (payload.type) {\n      case \"doc-snapshot\": {\n        const snapshot = payload.snapshot.slice();\n        await this.storeMergedSnapshot(db, payload.docId, snapshot);\n        break;\n      }\n      case \"doc-update\": {\n        const update = payload.update.slice();\n        await this.appendDocUpdate(db, payload.docId, update);\n        break;\n      }\n      case \"asset\": {\n        const bytes = payload.data.slice();\n        await this.putBinary(db, this.assetStore, payload.assetId, bytes);\n        break;\n      }\n      case \"meta\": {\n        const bytes = payload.update.slice();\n        await this.putBinary(db, this.metaStore, this.metaKey, bytes);\n        break;\n      }\n      default:\n        throw new Error(\"Unsupported storage payload type\");\n    }\n  }\n\n  async deleteAsset(assetId: AssetId): Promise<void> {\n    const db = await this.ensureDb();\n    await this.deleteKey(db, this.assetStore, assetId);\n  }\n\n  async loadDoc(docId: string): Promise<LoroDoc | undefined> {\n    const db = await this.ensureDb();\n    const snapshot = await this.getBinaryFromDb(db, this.docStore, docId);\n    const pendingUpdates = await this.getDocUpdates(db, docId);\n\n    if (!snapshot && pendingUpdates.length === 0) {\n      return undefined;\n    }\n\n    let doc: LoroDoc;\n    try {\n      doc = snapshot ? LoroDoc.fromSnapshot(snapshot) : new LoroDoc();\n    } catch (error) {\n      throw this.createError(\n        `Failed to hydrate document snapshot for \"${docId}\"`,\n        error,\n      );\n    }\n\n    let appliedUpdates = false;\n    for (const update of pendingUpdates) {\n      try {\n        doc.import(update);\n        appliedUpdates = true;\n      } catch (error) {\n        throw this.createError(\n          `Failed to apply queued document update for \"${docId}\"`,\n          error,\n        );\n      }\n    }\n\n    if (appliedUpdates) {\n      let consolidated: Uint8Array;\n      try {\n        consolidated = doc.export({ mode: \"snapshot\" });\n      } catch (error) {\n        throw this.createError(\n          `Failed to export consolidated snapshot for \"${docId}\"`,\n          error,\n        );\n      }\n      await this.writeSnapshot(db, docId, consolidated);\n      await this.clearDocUpdates(db, docId);\n    }\n\n    return doc;\n  }\n\n  async loadMeta(): Promise<Flock | undefined> {\n    const bytes = await this.getBinary(this.metaStore, this.metaKey);\n    if (!bytes) return undefined;\n    try {\n      const json = textDecoder.decode(bytes);\n      const bundle = JSON.parse(json) as ExportBundle;\n      const flock = new Flock();\n      flock.importJson(bundle);\n      return flock;\n    } catch (error) {\n      throw this.createError(\"Failed to hydrate metadata snapshot\", error);\n    }\n  }\n\n  async loadAsset(assetId: AssetId): Promise<Uint8Array | undefined> {\n    const bytes = await this.getBinary(this.assetStore, assetId);\n    return bytes ?? undefined;\n  }\n\n  async close(): Promise<void> {\n    this.closed = true;\n    const db = await this.dbPromise;\n    if (db) {\n      db.close();\n    }\n    this.dbPromise = undefined;\n  }\n\n  private async ensureDb(): Promise<IDBDatabase> {\n    if (this.closed) {\n      throw new Error(\"IndexedDBStorageAdaptor has been closed\");\n    }\n    if (!this.dbPromise) {\n      this.dbPromise = new Promise((resolve, reject) => {\n        const request = this.idb.open(this.dbName, this.version);\n        request.addEventListener(\"upgradeneeded\", () => {\n          const db = request.result;\n          this.ensureStore(db, this.docStore);\n          this.ensureStore(db, this.docUpdateStore);\n          this.ensureStore(db, this.metaStore);\n          this.ensureStore(db, this.assetStore);\n        });\n        request.addEventListener(\n          \"success\",\n          () => resolve(request.result),\n          { once: true },\n        );\n        request.addEventListener(\n          \"error\",\n          () => {\n            reject(\n              this.createError(\n                `Failed to open IndexedDB database \"${this.dbName}\"`,\n                request.error,\n              ),\n            );\n          },\n          { once: true },\n        );\n      });\n    }\n    return this.dbPromise;\n  }\n\n  private ensureStore(db: IDBDatabase, storeName: string): void {\n    const names = db.objectStoreNames;\n    if (this.storeExists(names, storeName)) return;\n    db.createObjectStore(storeName);\n  }\n\n  private storeExists(names: ObjectStoreNames, storeName: string): boolean {\n    if (typeof names.contains === \"function\") {\n      return names.contains(storeName);\n    }\n    const length = names.length ?? 0;\n    for (let index = 0; index < length; index += 1) {\n      const value = names.item?.(index);\n      if (value === storeName) return true;\n    }\n    return false;\n  }\n\n  private async storeMergedSnapshot(\n    db: IDBDatabase,\n    docId: string,\n    incoming: Uint8Array,\n  ): Promise<void> {\n    await this.runInTransaction(db, this.docStore, \"readwrite\", async (store) => {\n      const existingRaw = await this.wrapRequest(store.get(docId), \"read\");\n      const existing = await this.normalizeBinary(existingRaw);\n      const merged = this.mergeSnapshots(docId, existing, incoming);\n      await this.wrapRequest(store.put(merged, docId), \"write\");\n    });\n  }\n\n  private mergeSnapshots(\n    docId: string,\n    existing: Uint8Array | undefined,\n    incoming: Uint8Array,\n  ): Uint8Array {\n    try {\n      const doc = existing ? LoroDoc.fromSnapshot(existing) : new LoroDoc();\n      doc.import(incoming);\n      return doc.export({ mode: \"snapshot\" });\n    } catch (error) {\n      throw this.createError(`Failed to merge snapshot for \"${docId}\"`, error);\n    }\n  }\n\n  private async appendDocUpdate(\n    db: IDBDatabase,\n    docId: string,\n    update: Uint8Array,\n  ): Promise<void> {\n    await this.runInTransaction(\n      db,\n      this.docUpdateStore,\n      \"readwrite\",\n      async (store) => {\n        const raw = await this.wrapRequest(store.get(docId), \"read\");\n        const queue = await this.normalizeUpdateQueue(raw);\n        queue.push(update.slice());\n        await this.wrapRequest(store.put({ updates: queue }, docId), \"write\");\n      },\n    );\n  }\n\n  private async getDocUpdates(\n    db: IDBDatabase,\n    docId: string,\n  ): Promise<Uint8Array[]> {\n    const raw = await this.runInTransaction(\n      db,\n      this.docUpdateStore,\n      \"readonly\",\n      (store) => this.wrapRequest(store.get(docId), \"read\"),\n    );\n    return this.normalizeUpdateQueue(raw);\n  }\n\n  private async clearDocUpdates(\n    db: IDBDatabase,\n    docId: string,\n  ): Promise<void> {\n    await this.runInTransaction(\n      db,\n      this.docUpdateStore,\n      \"readwrite\",\n      (store) => this.wrapRequest(store.delete(docId), \"delete\"),\n    );\n  }\n\n  private async writeSnapshot(\n    db: IDBDatabase,\n    docId: string,\n    snapshot: Uint8Array,\n  ): Promise<void> {\n    await this.putBinary(db, this.docStore, docId, snapshot.slice());\n  }\n\n  private async getBinaryFromDb(\n    db: IDBDatabase,\n    storeName: string,\n    key: string,\n  ): Promise<Uint8Array | undefined> {\n    const value = await this.runInTransaction(\n      db,\n      storeName,\n      \"readonly\",\n      (store) => this.wrapRequest(store.get(key), \"read\"),\n    );\n    return this.normalizeBinary(value);\n  }\n\n  private async normalizeUpdateQueue(value: unknown): Promise<Uint8Array[]> {\n    if (value == null) return [];\n    const list = Array.isArray(value)\n      ? value\n      : typeof value === \"object\" && value !== null\n        ? (value as { updates?: unknown }).updates\n        : undefined;\n\n    if (!Array.isArray(list)) return [];\n\n    const queue: Uint8Array[] = [];\n    for (const entry of list) {\n      const bytes = await this.normalizeBinary(entry);\n      if (bytes) {\n        queue.push(bytes);\n      }\n    }\n    return queue;\n  }\n\n  private async putBinary(\n    db: IDBDatabase,\n    storeName: string,\n    key: string,\n    value: Uint8Array,\n  ): Promise<void> {\n    await this.runInTransaction(db, storeName, \"readwrite\", (store) =>\n      this.wrapRequest(store.put(value, key), \"write\"),\n    );\n  }\n\n  private async deleteKey(\n    db: IDBDatabase,\n    storeName: string,\n    key: string,\n  ): Promise<void> {\n    await this.runInTransaction(db, storeName, \"readwrite\", (store) =>\n      this.wrapRequest(store.delete(key), \"delete\"),\n    );\n  }\n\n  private async getBinary(\n    storeName: string,\n    key: string,\n  ): Promise<Uint8Array | undefined> {\n    const db = await this.ensureDb();\n    return this.getBinaryFromDb(db, storeName, key);\n  }\n\n  private runInTransaction<T>(\n    db: IDBDatabase,\n    storeName: string,\n    mode: IDBTransactionMode,\n    executor: (store: IDBObjectStore) => Promise<T>,\n  ): Promise<T> {\n    const tx = db.transaction(storeName, mode);\n    const store = tx.objectStore(storeName);\n    const completion = new Promise<void>((resolve, reject) => {\n      tx.addEventListener(\n        \"complete\",\n        () => resolve(),\n        { once: true },\n      );\n      tx.addEventListener(\n        \"abort\",\n        () =>\n          reject(\n            this.createError(\"IndexedDB transaction aborted\", tx.error),\n          ),\n        { once: true },\n      );\n      tx.addEventListener(\n        \"error\",\n        () =>\n          reject(\n            this.createError(\"IndexedDB transaction failed\", tx.error),\n          ),\n        { once: true },\n      );\n    });\n    return Promise.all([executor(store), completion]).then(([result]) => result);\n  }\n\n  private wrapRequest<T>(\n    request: IDBRequest<T>,\n    action: string,\n  ): Promise<T> {\n    return new Promise<T>((resolve, reject) => {\n      request.addEventListener(\n        \"success\",\n        () => resolve(request.result),\n        { once: true },\n      );\n      request.addEventListener(\n        \"error\",\n        () =>\n          reject(\n            this.createError(\n              `IndexedDB request failed during ${action}`,\n              request.error,\n            ),\n          ),\n        { once: true },\n      );\n    });\n  }\n\n  private async normalizeBinary(value: unknown): Promise<Uint8Array | undefined> {\n    if (value == null) return undefined;\n    if (value instanceof Uint8Array) {\n      return value.slice();\n    }\n    if (ArrayBuffer.isView(value)) {\n      return new Uint8Array(\n        value.buffer,\n        value.byteOffset,\n        value.byteLength,\n      ).slice();\n    }\n    if (value instanceof ArrayBuffer) {\n      return new Uint8Array(value.slice(0));\n    }\n    if (\n      typeof value === \"object\" &&\n      value !== null &&\n      \"arrayBuffer\" in value\n    ) {\n      const candidate = value as {\n        arrayBuffer?: unknown;\n      };\n      if (typeof candidate.arrayBuffer === \"function\") {\n        const buffer = await candidate.arrayBuffer();\n        return new Uint8Array(buffer);\n      }\n    }\n    return undefined;\n  }\n\n  private createError(message: string, cause: unknown): Error {\n    if (cause instanceof Error) {\n      return new Error(`${message}: ${cause.message}`, { cause });\n    }\n    if (cause !== undefined && cause !== null) {\n      return new Error(`${message}: ${describeUnknown(cause)}`);\n    }\n    return new Error(message);\n  }\n}\n"],"mappings":";;;;;;;AAUA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB;AAC3B,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAC5B,MAAM,2BAA2B;AACjC,MAAM,mBAAmB;AAwEzB,MAAM,cAAc,IAAI,aAAa;AAErC,SAAS,gBAAgB,OAAwB;AAC/C,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAChD,QAAO,OAAO,MAAM;AAEtB,KAAI,OAAO,UAAU,SACnB,QAAO,MAAM,UAAU;AAEzB,KAAI,OAAO,UAAU,SACnB,QAAO,MAAM,eAAe,MAAM,UAAU;AAE9C,KAAI,OAAO,UAAU,WACnB,QAAO,aAAa,MAAM,QAAQ,YAAY;AAEhD,KAAI,SAAS,OAAO,UAAU,SAC5B,KAAI;AACF,SAAO,KAAK,UAAU,MAAM;SACtB;AACN,SAAO;;AAGX,QAAO,OAAO,MAAM;;AAatB,IAAa,0BAAb,MAA+D;CAC7D,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAQ;CACR,AAAQ,SAAS;CAEjB,YAAY,UAA0C,EAAE,EAAE;EACxD,MAAM,aAAc,WAA0C;AAC9D,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,iDAAiD;AAEnE,OAAK,MAAM;AACX,OAAK,SAAS,QAAQ,UAAU;AAChC,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,WAAW,QAAQ,gBAAgB;AACxC,OAAK,iBAAiB,QAAQ,sBAAsB;AACpD,OAAK,YAAY,QAAQ,iBAAiB;AAC1C,OAAK,aAAa,QAAQ,kBAAkB;AAC5C,OAAK,UAAU,QAAQ,WAAW;;CAGpC,MAAM,KAAK,SAA4C;EACrD,MAAM,KAAK,MAAM,KAAK,UAAU;AAChC,UAAQ,QAAQ,MAAhB;GACE,KAAK,gBAAgB;IACnB,MAAM,WAAW,QAAQ,SAAS,OAAO;AACzC,UAAM,KAAK,oBAAoB,IAAI,QAAQ,OAAO,SAAS;AAC3D;;GAEF,KAAK,cAAc;IACjB,MAAM,SAAS,QAAQ,OAAO,OAAO;AACrC,UAAM,KAAK,gBAAgB,IAAI,QAAQ,OAAO,OAAO;AACrD;;GAEF,KAAK,SAAS;IACZ,MAAM,QAAQ,QAAQ,KAAK,OAAO;AAClC,UAAM,KAAK,UAAU,IAAI,KAAK,YAAY,QAAQ,SAAS,MAAM;AACjE;;GAEF,KAAK,QAAQ;IACX,MAAM,QAAQ,QAAQ,OAAO,OAAO;AACpC,UAAM,KAAK,UAAU,IAAI,KAAK,WAAW,KAAK,SAAS,MAAM;AAC7D;;GAEF,QACE,OAAM,IAAI,MAAM,mCAAmC;;;CAIzD,MAAM,YAAY,SAAiC;EACjD,MAAM,KAAK,MAAM,KAAK,UAAU;AAChC,QAAM,KAAK,UAAU,IAAI,KAAK,YAAY,QAAQ;;CAGpD,MAAM,QAAQ,OAA6C;EACzD,MAAM,KAAK,MAAM,KAAK,UAAU;EAChC,MAAM,WAAW,MAAM,KAAK,gBAAgB,IAAI,KAAK,UAAU,MAAM;EACrE,MAAM,iBAAiB,MAAM,KAAK,cAAc,IAAI,MAAM;AAE1D,MAAI,CAAC,YAAY,eAAe,WAAW,EACzC;EAGF,IAAIA;AACJ,MAAI;AACF,SAAM,WAAWC,kBAAQ,aAAa,SAAS,GAAG,IAAIA,mBAAS;WACxD,OAAO;AACd,SAAM,KAAK,YACT,4CAA4C,MAAM,IAClD,MACD;;EAGH,IAAI,iBAAiB;AACrB,OAAK,MAAM,UAAU,eACnB,KAAI;AACF,OAAI,OAAO,OAAO;AAClB,oBAAiB;WACV,OAAO;AACd,SAAM,KAAK,YACT,+CAA+C,MAAM,IACrD,MACD;;AAIL,MAAI,gBAAgB;GAClB,IAAIC;AACJ,OAAI;AACF,mBAAe,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;YACxC,OAAO;AACd,UAAM,KAAK,YACT,+CAA+C,MAAM,IACrD,MACD;;AAEH,SAAM,KAAK,cAAc,IAAI,OAAO,aAAa;AACjD,SAAM,KAAK,gBAAgB,IAAI,MAAM;;AAGvC,SAAO;;CAGT,MAAM,WAAuC;EAC3C,MAAM,QAAQ,MAAM,KAAK,UAAU,KAAK,WAAW,KAAK,QAAQ;AAChE,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI;GACF,MAAM,OAAO,YAAY,OAAO,MAAM;GACtC,MAAM,SAAS,KAAK,MAAM,KAAK;GAC/B,MAAM,QAAQ,IAAIC,wBAAO;AACzB,SAAM,WAAW,OAAO;AACxB,UAAO;WACA,OAAO;AACd,SAAM,KAAK,YAAY,uCAAuC,MAAM;;;CAIxE,MAAM,UAAU,SAAmD;AAEjE,SADc,MAAM,KAAK,UAAU,KAAK,YAAY,QAAQ,IAC5C;;CAGlB,MAAM,QAAuB;AAC3B,OAAK,SAAS;EACd,MAAM,KAAK,MAAM,KAAK;AACtB,MAAI,GACF,IAAG,OAAO;AAEZ,OAAK,YAAY;;CAGnB,MAAc,WAAiC;AAC7C,MAAI,KAAK,OACP,OAAM,IAAI,MAAM,0CAA0C;AAE5D,MAAI,CAAC,KAAK,UACR,MAAK,YAAY,IAAI,SAAS,SAAS,WAAW;GAChD,MAAM,UAAU,KAAK,IAAI,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACxD,WAAQ,iBAAiB,uBAAuB;IAC9C,MAAM,KAAK,QAAQ;AACnB,SAAK,YAAY,IAAI,KAAK,SAAS;AACnC,SAAK,YAAY,IAAI,KAAK,eAAe;AACzC,SAAK,YAAY,IAAI,KAAK,UAAU;AACpC,SAAK,YAAY,IAAI,KAAK,WAAW;KACrC;AACF,WAAQ,iBACN,iBACM,QAAQ,QAAQ,OAAO,EAC7B,EAAE,MAAM,MAAM,CACf;AACD,WAAQ,iBACN,eACM;AACJ,WACE,KAAK,YACH,sCAAsC,KAAK,OAAO,IAClD,QAAQ,MACT,CACF;MAEH,EAAE,MAAM,MAAM,CACf;IACD;AAEJ,SAAO,KAAK;;CAGd,AAAQ,YAAY,IAAiB,WAAyB;EAC5D,MAAM,QAAQ,GAAG;AACjB,MAAI,KAAK,YAAY,OAAO,UAAU,CAAE;AACxC,KAAG,kBAAkB,UAAU;;CAGjC,AAAQ,YAAY,OAAyB,WAA4B;AACvE,MAAI,OAAO,MAAM,aAAa,WAC5B,QAAO,MAAM,SAAS,UAAU;EAElC,MAAM,SAAS,MAAM,UAAU;AAC/B,OAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,SAAS,EAE3C,KADc,MAAM,OAAO,MAAM,KACnB,UAAW,QAAO;AAElC,SAAO;;CAGT,MAAc,oBACZ,IACA,OACA,UACe;AACf,QAAM,KAAK,iBAAiB,IAAI,KAAK,UAAU,aAAa,OAAO,UAAU;GAC3E,MAAM,cAAc,MAAM,KAAK,YAAY,MAAM,IAAI,MAAM,EAAE,OAAO;GACpE,MAAM,WAAW,MAAM,KAAK,gBAAgB,YAAY;GACxD,MAAM,SAAS,KAAK,eAAe,OAAO,UAAU,SAAS;AAC7D,SAAM,KAAK,YAAY,MAAM,IAAI,QAAQ,MAAM,EAAE,QAAQ;IACzD;;CAGJ,AAAQ,eACN,OACA,UACA,UACY;AACZ,MAAI;GACF,MAAM,MAAM,WAAWF,kBAAQ,aAAa,SAAS,GAAG,IAAIA,mBAAS;AACrE,OAAI,OAAO,SAAS;AACpB,UAAO,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;WAChC,OAAO;AACd,SAAM,KAAK,YAAY,iCAAiC,MAAM,IAAI,MAAM;;;CAI5E,MAAc,gBACZ,IACA,OACA,QACe;AACf,QAAM,KAAK,iBACT,IACA,KAAK,gBACL,aACA,OAAO,UAAU;GACf,MAAM,MAAM,MAAM,KAAK,YAAY,MAAM,IAAI,MAAM,EAAE,OAAO;GAC5D,MAAM,QAAQ,MAAM,KAAK,qBAAqB,IAAI;AAClD,SAAM,KAAK,OAAO,OAAO,CAAC;AAC1B,SAAM,KAAK,YAAY,MAAM,IAAI,EAAE,SAAS,OAAO,EAAE,MAAM,EAAE,QAAQ;IAExE;;CAGH,MAAc,cACZ,IACA,OACuB;EACvB,MAAM,MAAM,MAAM,KAAK,iBACrB,IACA,KAAK,gBACL,aACC,UAAU,KAAK,YAAY,MAAM,IAAI,MAAM,EAAE,OAAO,CACtD;AACD,SAAO,KAAK,qBAAqB,IAAI;;CAGvC,MAAc,gBACZ,IACA,OACe;AACf,QAAM,KAAK,iBACT,IACA,KAAK,gBACL,cACC,UAAU,KAAK,YAAY,MAAM,OAAO,MAAM,EAAE,SAAS,CAC3D;;CAGH,MAAc,cACZ,IACA,OACA,UACe;AACf,QAAM,KAAK,UAAU,IAAI,KAAK,UAAU,OAAO,SAAS,OAAO,CAAC;;CAGlE,MAAc,gBACZ,IACA,WACA,KACiC;EACjC,MAAM,QAAQ,MAAM,KAAK,iBACvB,IACA,WACA,aACC,UAAU,KAAK,YAAY,MAAM,IAAI,IAAI,EAAE,OAAO,CACpD;AACD,SAAO,KAAK,gBAAgB,MAAM;;CAGpC,MAAc,qBAAqB,OAAuC;AACxE,MAAI,SAAS,KAAM,QAAO,EAAE;EAC5B,MAAM,OAAO,MAAM,QAAQ,MAAM,GAC7B,QACA,OAAO,UAAU,YAAY,UAAU,OACpC,MAAgC,UACjC;AAEN,MAAI,CAAC,MAAM,QAAQ,KAAK,CAAE,QAAO,EAAE;EAEnC,MAAMG,QAAsB,EAAE;AAC9B,OAAK,MAAM,SAAS,MAAM;GACxB,MAAM,QAAQ,MAAM,KAAK,gBAAgB,MAAM;AAC/C,OAAI,MACF,OAAM,KAAK,MAAM;;AAGrB,SAAO;;CAGT,MAAc,UACZ,IACA,WACA,KACA,OACe;AACf,QAAM,KAAK,iBAAiB,IAAI,WAAW,cAAc,UACvD,KAAK,YAAY,MAAM,IAAI,OAAO,IAAI,EAAE,QAAQ,CACjD;;CAGH,MAAc,UACZ,IACA,WACA,KACe;AACf,QAAM,KAAK,iBAAiB,IAAI,WAAW,cAAc,UACvD,KAAK,YAAY,MAAM,OAAO,IAAI,EAAE,SAAS,CAC9C;;CAGH,MAAc,UACZ,WACA,KACiC;EACjC,MAAM,KAAK,MAAM,KAAK,UAAU;AAChC,SAAO,KAAK,gBAAgB,IAAI,WAAW,IAAI;;CAGjD,AAAQ,iBACN,IACA,WACA,MACA,UACY;EACZ,MAAM,KAAK,GAAG,YAAY,WAAW,KAAK;EAC1C,MAAM,QAAQ,GAAG,YAAY,UAAU;EACvC,MAAM,aAAa,IAAI,SAAe,SAAS,WAAW;AACxD,MAAG,iBACD,kBACM,SAAS,EACf,EAAE,MAAM,MAAM,CACf;AACD,MAAG,iBACD,eAEE,OACE,KAAK,YAAY,iCAAiC,GAAG,MAAM,CAC5D,EACH,EAAE,MAAM,MAAM,CACf;AACD,MAAG,iBACD,eAEE,OACE,KAAK,YAAY,gCAAgC,GAAG,MAAM,CAC3D,EACH,EAAE,MAAM,MAAM,CACf;IACD;AACF,SAAO,QAAQ,IAAI,CAAC,SAAS,MAAM,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,YAAY,OAAO;;CAG9E,AAAQ,YACN,SACA,QACY;AACZ,SAAO,IAAI,SAAY,SAAS,WAAW;AACzC,WAAQ,iBACN,iBACM,QAAQ,QAAQ,OAAO,EAC7B,EAAE,MAAM,MAAM,CACf;AACD,WAAQ,iBACN,eAEE,OACE,KAAK,YACH,mCAAmC,UACnC,QAAQ,MACT,CACF,EACH,EAAE,MAAM,MAAM,CACf;IACD;;CAGJ,MAAc,gBAAgB,OAAiD;AAC7E,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,iBAAiB,WACnB,QAAO,MAAM,OAAO;AAEtB,MAAI,YAAY,OAAO,MAAM,CAC3B,QAAO,IAAI,WACT,MAAM,QACN,MAAM,YACN,MAAM,WACP,CAAC,OAAO;AAEX,MAAI,iBAAiB,YACnB,QAAO,IAAI,WAAW,MAAM,MAAM,EAAE,CAAC;AAEvC,MACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,OACjB;GACA,MAAM,YAAY;AAGlB,OAAI,OAAO,UAAU,gBAAgB,YAAY;IAC/C,MAAM,SAAS,MAAM,UAAU,aAAa;AAC5C,WAAO,IAAI,WAAW,OAAO;;;;CAMnC,AAAQ,YAAY,SAAiB,OAAuB;AAC1D,MAAI,iBAAiB,MACnB,QAAO,IAAI,MAAM,GAAG,QAAQ,IAAI,MAAM,WAAW,EAAE,OAAO,CAAC;AAE7D,MAAI,UAAU,UAAa,UAAU,KACnC,wBAAO,IAAI,MAAM,GAAG,QAAQ,IAAI,gBAAgB,MAAM,GAAG;AAE3D,SAAO,IAAI,MAAM,QAAQ"}

package/dist/storage/indexeddb.d.cts

@@ -0,0 +1,54 @@
+import { C as StorageAdapter, r as AssetId, w as StorageSavePayload } from "../types.cjs";
+import { Flock } from "@loro-dev/flock";
+import { LoroDoc } from "loro-crdt";
+
+//#region src/storage/indexeddb.d.ts
+interface IndexedDBStorageAdaptorOptions {
+  readonly dbName?: string;
+  readonly version?: number;
+  readonly docStoreName?: string;
+  readonly docUpdateStoreName?: string;
+  readonly metaStoreName?: string;
+  readonly assetStoreName?: string;
+  readonly metaKey?: string;
+}
+declare class IndexedDBStorageAdaptor implements StorageAdapter {
+  private readonly idb;
+  private readonly dbName;
+  private readonly version;
+  private readonly docStore;
+  private readonly docUpdateStore;
+  private readonly metaStore;
+  private readonly assetStore;
+  private readonly metaKey;
+  private dbPromise?;
+  private closed;
+  constructor(options?: IndexedDBStorageAdaptorOptions);
+  save(payload: StorageSavePayload): Promise<void>;
+  deleteAsset(assetId: AssetId): Promise<void>;
+  loadDoc(docId: string): Promise<LoroDoc | undefined>;
+  loadMeta(): Promise<Flock | undefined>;
+  loadAsset(assetId: AssetId): Promise<Uint8Array | undefined>;
+  close(): Promise<void>;
+  private ensureDb;
+  private ensureStore;
+  private storeExists;
+  private storeMergedSnapshot;
+  private mergeSnapshots;
+  private appendDocUpdate;
+  private getDocUpdates;
+  private clearDocUpdates;
+  private writeSnapshot;
+  private getBinaryFromDb;
+  private normalizeUpdateQueue;
+  private putBinary;
+  private deleteKey;
+  private getBinary;
+  private runInTransaction;
+  private wrapRequest;
+  private normalizeBinary;
+  private createError;
+}
+//#endregion
+export { IndexedDBStorageAdaptor, IndexedDBStorageAdaptorOptions };
+//# sourceMappingURL=indexeddb.d.cts.map

package/dist/storage/indexeddb.d.ts

@@ -0,0 +1,54 @@
+import { C as StorageAdapter, r as AssetId, w as StorageSavePayload } from "../types.js";
+import { Flock } from "@loro-dev/flock";
+import { LoroDoc } from "loro-crdt";
+
+//#region src/storage/indexeddb.d.ts
+interface IndexedDBStorageAdaptorOptions {
+  readonly dbName?: string;
+  readonly version?: number;
+  readonly docStoreName?: string;
+  readonly docUpdateStoreName?: string;
+  readonly metaStoreName?: string;
+  readonly assetStoreName?: string;
+  readonly metaKey?: string;
+}
+declare class IndexedDBStorageAdaptor implements StorageAdapter {
+  private readonly idb;
+  private readonly dbName;
+  private readonly version;
+  private readonly docStore;
+  private readonly docUpdateStore;
+  private readonly metaStore;
+  private readonly assetStore;
+  private readonly metaKey;
+  private dbPromise?;
+  private closed;
+  constructor(options?: IndexedDBStorageAdaptorOptions);
+  save(payload: StorageSavePayload): Promise<void>;
+  deleteAsset(assetId: AssetId): Promise<void>;
+  loadDoc(docId: string): Promise<LoroDoc | undefined>;
+  loadMeta(): Promise<Flock | undefined>;
+  loadAsset(assetId: AssetId): Promise<Uint8Array | undefined>;
+  close(): Promise<void>;
+  private ensureDb;
+  private ensureStore;
+  private storeExists;
+  private storeMergedSnapshot;
+  private mergeSnapshots;
+  private appendDocUpdate;
+  private getDocUpdates;
+  private clearDocUpdates;
+  private writeSnapshot;
+  private getBinaryFromDb;
+  private normalizeUpdateQueue;
+  private putBinary;
+  private deleteKey;
+  private getBinary;
+  private runInTransaction;
+  private wrapRequest;
+  private normalizeBinary;
+  private createError;
+}
+//#endregion
+export { IndexedDBStorageAdaptor, IndexedDBStorageAdaptorOptions };
+//# sourceMappingURL=indexeddb.d.ts.map

package/dist/storage/indexeddb.js

@@ -0,0 +1,258 @@
+import { Flock } from "@loro-dev/flock";
+import { LoroDoc } from "loro-crdt";
+
+//#region src/storage/indexeddb.ts
+const DEFAULT_DB_NAME = "loro-repo";
+const DEFAULT_DB_VERSION = 1;
+const DEFAULT_DOC_STORE = "docs";
+const DEFAULT_META_STORE = "meta";
+const DEFAULT_ASSET_STORE = "assets";
+const DEFAULT_DOC_UPDATE_STORE = "doc-updates";
+const DEFAULT_META_KEY = "snapshot";
+const textDecoder = new TextDecoder();
+function describeUnknown(cause) {
+	if (typeof cause === "string") return cause;
+	if (typeof cause === "number" || typeof cause === "boolean") return String(cause);
+	if (typeof cause === "bigint") return cause.toString();
+	if (typeof cause === "symbol") return cause.description ?? cause.toString();
+	if (typeof cause === "function") return `[function ${cause.name ?? "anonymous"}]`;
+	if (cause && typeof cause === "object") try {
+		return JSON.stringify(cause);
+	} catch {
+		return "[object]";
+	}
+	return String(cause);
+}
+var IndexedDBStorageAdaptor = class {
+	idb;
+	dbName;
+	version;
+	docStore;
+	docUpdateStore;
+	metaStore;
+	assetStore;
+	metaKey;
+	dbPromise;
+	closed = false;
+	constructor(options = {}) {
+		const idbFactory = globalThis.indexedDB;
+		if (!idbFactory) throw new Error("IndexedDB is not available in this environment");
+		this.idb = idbFactory;
+		this.dbName = options.dbName ?? DEFAULT_DB_NAME;
+		this.version = options.version ?? DEFAULT_DB_VERSION;
+		this.docStore = options.docStoreName ?? DEFAULT_DOC_STORE;
+		this.docUpdateStore = options.docUpdateStoreName ?? DEFAULT_DOC_UPDATE_STORE;
+		this.metaStore = options.metaStoreName ?? DEFAULT_META_STORE;
+		this.assetStore = options.assetStoreName ?? DEFAULT_ASSET_STORE;
+		this.metaKey = options.metaKey ?? DEFAULT_META_KEY;
+	}
+	async save(payload) {
+		const db = await this.ensureDb();
+		switch (payload.type) {
+			case "doc-snapshot": {
+				const snapshot = payload.snapshot.slice();
+				await this.storeMergedSnapshot(db, payload.docId, snapshot);
+				break;
+			}
+			case "doc-update": {
+				const update = payload.update.slice();
+				await this.appendDocUpdate(db, payload.docId, update);
+				break;
+			}
+			case "asset": {
+				const bytes = payload.data.slice();
+				await this.putBinary(db, this.assetStore, payload.assetId, bytes);
+				break;
+			}
+			case "meta": {
+				const bytes = payload.update.slice();
+				await this.putBinary(db, this.metaStore, this.metaKey, bytes);
+				break;
+			}
+			default: throw new Error("Unsupported storage payload type");
+		}
+	}
+	async deleteAsset(assetId) {
+		const db = await this.ensureDb();
+		await this.deleteKey(db, this.assetStore, assetId);
+	}
+	async loadDoc(docId) {
+		const db = await this.ensureDb();
+		const snapshot = await this.getBinaryFromDb(db, this.docStore, docId);
+		const pendingUpdates = await this.getDocUpdates(db, docId);
+		if (!snapshot && pendingUpdates.length === 0) return;
+		let doc;
+		try {
+			doc = snapshot ? LoroDoc.fromSnapshot(snapshot) : new LoroDoc();
+		} catch (error) {
+			throw this.createError(`Failed to hydrate document snapshot for "${docId}"`, error);
+		}
+		let appliedUpdates = false;
+		for (const update of pendingUpdates) try {
+			doc.import(update);
+			appliedUpdates = true;
+		} catch (error) {
+			throw this.createError(`Failed to apply queued document update for "${docId}"`, error);
+		}
+		if (appliedUpdates) {
+			let consolidated;
+			try {
+				consolidated = doc.export({ mode: "snapshot" });
+			} catch (error) {
+				throw this.createError(`Failed to export consolidated snapshot for "${docId}"`, error);
+			}
+			await this.writeSnapshot(db, docId, consolidated);
+			await this.clearDocUpdates(db, docId);
+		}
+		return doc;
+	}
+	async loadMeta() {
+		const bytes = await this.getBinary(this.metaStore, this.metaKey);
+		if (!bytes) return void 0;
+		try {
+			const json = textDecoder.decode(bytes);
+			const bundle = JSON.parse(json);
+			const flock = new Flock();
+			flock.importJson(bundle);
+			return flock;
+		} catch (error) {
+			throw this.createError("Failed to hydrate metadata snapshot", error);
+		}
+	}
+	async loadAsset(assetId) {
+		return await this.getBinary(this.assetStore, assetId) ?? void 0;
+	}
+	async close() {
+		this.closed = true;
+		const db = await this.dbPromise;
+		if (db) db.close();
+		this.dbPromise = void 0;
+	}
+	async ensureDb() {
+		if (this.closed) throw new Error("IndexedDBStorageAdaptor has been closed");
+		if (!this.dbPromise) this.dbPromise = new Promise((resolve, reject) => {
+			const request = this.idb.open(this.dbName, this.version);
+			request.addEventListener("upgradeneeded", () => {
+				const db = request.result;
+				this.ensureStore(db, this.docStore);
+				this.ensureStore(db, this.docUpdateStore);
+				this.ensureStore(db, this.metaStore);
+				this.ensureStore(db, this.assetStore);
+			});
+			request.addEventListener("success", () => resolve(request.result), { once: true });
+			request.addEventListener("error", () => {
+				reject(this.createError(`Failed to open IndexedDB database "${this.dbName}"`, request.error));
+			}, { once: true });
+		});
+		return this.dbPromise;
+	}
+	ensureStore(db, storeName) {
+		const names = db.objectStoreNames;
+		if (this.storeExists(names, storeName)) return;
+		db.createObjectStore(storeName);
+	}
+	storeExists(names, storeName) {
+		if (typeof names.contains === "function") return names.contains(storeName);
+		const length = names.length ?? 0;
+		for (let index = 0; index < length; index += 1) if (names.item?.(index) === storeName) return true;
+		return false;
+	}
+	async storeMergedSnapshot(db, docId, incoming) {
+		await this.runInTransaction(db, this.docStore, "readwrite", async (store) => {
+			const existingRaw = await this.wrapRequest(store.get(docId), "read");
+			const existing = await this.normalizeBinary(existingRaw);
+			const merged = this.mergeSnapshots(docId, existing, incoming);
+			await this.wrapRequest(store.put(merged, docId), "write");
+		});
+	}
+	mergeSnapshots(docId, existing, incoming) {
+		try {
+			const doc = existing ? LoroDoc.fromSnapshot(existing) : new LoroDoc();
+			doc.import(incoming);
+			return doc.export({ mode: "snapshot" });
+		} catch (error) {
+			throw this.createError(`Failed to merge snapshot for "${docId}"`, error);
+		}
+	}
+	async appendDocUpdate(db, docId, update) {
+		await this.runInTransaction(db, this.docUpdateStore, "readwrite", async (store) => {
+			const raw = await this.wrapRequest(store.get(docId), "read");
+			const queue = await this.normalizeUpdateQueue(raw);
+			queue.push(update.slice());
+			await this.wrapRequest(store.put({ updates: queue }, docId), "write");
+		});
+	}
+	async getDocUpdates(db, docId) {
+		const raw = await this.runInTransaction(db, this.docUpdateStore, "readonly", (store) => this.wrapRequest(store.get(docId), "read"));
+		return this.normalizeUpdateQueue(raw);
+	}
+	async clearDocUpdates(db, docId) {
+		await this.runInTransaction(db, this.docUpdateStore, "readwrite", (store) => this.wrapRequest(store.delete(docId), "delete"));
+	}
+	async writeSnapshot(db, docId, snapshot) {
+		await this.putBinary(db, this.docStore, docId, snapshot.slice());
+	}
+	async getBinaryFromDb(db, storeName, key) {
+		const value = await this.runInTransaction(db, storeName, "readonly", (store) => this.wrapRequest(store.get(key), "read"));
+		return this.normalizeBinary(value);
+	}
+	async normalizeUpdateQueue(value) {
+		if (value == null) return [];
+		const list = Array.isArray(value) ? value : typeof value === "object" && value !== null ? value.updates : void 0;
+		if (!Array.isArray(list)) return [];
+		const queue = [];
+		for (const entry of list) {
+			const bytes = await this.normalizeBinary(entry);
+			if (bytes) queue.push(bytes);
+		}
+		return queue;
+	}
+	async putBinary(db, storeName, key, value) {
+		await this.runInTransaction(db, storeName, "readwrite", (store) => this.wrapRequest(store.put(value, key), "write"));
+	}
+	async deleteKey(db, storeName, key) {
+		await this.runInTransaction(db, storeName, "readwrite", (store) => this.wrapRequest(store.delete(key), "delete"));
+	}
+	async getBinary(storeName, key) {
+		const db = await this.ensureDb();
+		return this.getBinaryFromDb(db, storeName, key);
+	}
+	runInTransaction(db, storeName, mode, executor) {
+		const tx = db.transaction(storeName, mode);
+		const store = tx.objectStore(storeName);
+		const completion = new Promise((resolve, reject) => {
+			tx.addEventListener("complete", () => resolve(), { once: true });
+			tx.addEventListener("abort", () => reject(this.createError("IndexedDB transaction aborted", tx.error)), { once: true });
+			tx.addEventListener("error", () => reject(this.createError("IndexedDB transaction failed", tx.error)), { once: true });
+		});
+		return Promise.all([executor(store), completion]).then(([result]) => result);
+	}
+	wrapRequest(request, action) {
+		return new Promise((resolve, reject) => {
+			request.addEventListener("success", () => resolve(request.result), { once: true });
+			request.addEventListener("error", () => reject(this.createError(`IndexedDB request failed during ${action}`, request.error)), { once: true });
+		});
+	}
+	async normalizeBinary(value) {
+		if (value == null) return void 0;
+		if (value instanceof Uint8Array) return value.slice();
+		if (ArrayBuffer.isView(value)) return new Uint8Array(value.buffer, value.byteOffset, value.byteLength).slice();
+		if (value instanceof ArrayBuffer) return new Uint8Array(value.slice(0));
+		if (typeof value === "object" && value !== null && "arrayBuffer" in value) {
+			const candidate = value;
+			if (typeof candidate.arrayBuffer === "function") {
+				const buffer = await candidate.arrayBuffer();
+				return new Uint8Array(buffer);
+			}
+		}
+	}
+	createError(message, cause) {
+		if (cause instanceof Error) return new Error(`${message}: ${cause.message}`, { cause });
+		if (cause !== void 0 && cause !== null) return /* @__PURE__ */ new Error(`${message}: ${describeUnknown(cause)}`);
+		return new Error(message);
+	}
+};
+
+//#endregion
+export { IndexedDBStorageAdaptor };
+//# sourceMappingURL=indexeddb.js.map