fabricjs-document-engine 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,7 +1,12 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.cjs";
+import { AssetManifest, FontAsset, ImageAsset } from "./assets/asset-manifest.cjs";
+import { FontLoader } from "./assets/font-check.cjs";
+import { AssetOptions, AssetReport, AssetWarning, AssetWarningCode, UploadRequest } from "./assets/asset-pipeline.cjs";
 import { NewDocumentOptions } from "./document/create-document.cjs";
 import { CustomObjectDefinition } from "./fabric/object-registry.cjs";
 import { HistoryOptions, HistoryState } from "./history/create-history.cjs";
+import { RecoveryStore } from "./recovery/recovery-store.cjs";
+import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.cjs";
 import { AutosaveOptions } from "./save/autosave-scheduler.cjs";
 import { RetryOptions } from "./save/retry.cjs";
 import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, createConflictError, isDocumentEngineError } from "./engine/errors.cjs";
@@ -12,4 +17,4 @@ import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, LoadOption
 import { validateDocument } from "./document/validate-document.cjs";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.cjs";
 import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.cjs";
-export { type AutosaveOptions, CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type HistoryOptions, type HistoryState, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };
+export { type AssetManifest, type AssetOptions, type AssetReport, type AssetWarning, type AssetWarningCode, type AutosaveOptions, CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, type InterruptedLoad, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, type UploadRequest, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/index.d.ts

@@ -1,7 +1,12 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.js";
+import { AssetManifest, FontAsset, ImageAsset } from "./assets/asset-manifest.js";
+import { FontLoader } from "./assets/font-check.js";
+import { AssetOptions, AssetReport, AssetWarning, AssetWarningCode, UploadRequest } from "./assets/asset-pipeline.js";
 import { NewDocumentOptions } from "./document/create-document.js";
 import { CustomObjectDefinition } from "./fabric/object-registry.js";
 import { HistoryOptions, HistoryState } from "./history/create-history.js";
+import { RecoveryStore } from "./recovery/recovery-store.js";
+import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.js";
 import { AutosaveOptions } from "./save/autosave-scheduler.js";
 import { RetryOptions } from "./save/retry.js";
 import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, createConflictError, isDocumentEngineError } from "./engine/errors.js";
@@ -12,4 +17,4 @@ import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, LoadOption
 import { validateDocument } from "./document/validate-document.js";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.js";
 import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.js";
-export { type AutosaveOptions, CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type HistoryOptions, type HistoryState, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };
+export { type AssetManifest, type AssetOptions, type AssetReport, type AssetWarning, type AssetWarningCode, type AutosaveOptions, CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, type InterruptedLoad, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, type UploadRequest, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/index.js

@@ -1,6 +1,6 @@
+import { DocumentEngineError, createConflictError, isDocumentEngineError } from "./engine/errors.js";
 import { CURRENT_SCHEMA_VERSION } from "./document/document-format.js";
 import { validateDocument } from "./document/validate-document.js";
-import { DocumentEngineError, createConflictError, isDocumentEngineError } from "./engine/errors.js";
 import { createDocumentEngine } from "./engine/create-document-engine.js";
 import { bindKeyboardShortcuts } from "./history/keyboard-shortcuts.js";
 import { bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.js";

package/dist/recovery/indexed-db-recovery.cjs

@@ -0,0 +1,80 @@
+//#region src/recovery/indexed-db-recovery.ts
+function requestToPromise(request) {
+	return new Promise((resolve, reject) => {
+		request.onsuccess = () => resolve(request.result);
+		request.onerror = () => reject(request.error);
+	});
+}
+function browserStorage() {
+	try {
+		return globalThis.localStorage;
+	} catch {
+		return;
+	}
+}
+function createIndexedDbRecovery(options = {}) {
+	const databaseName = options.databaseName ?? "fabricjs-document-engine";
+	const storeName = options.storeName ?? "recovery";
+	let opening;
+	let database;
+	const emergencyPrefix = `${databaseName}/${storeName}:`;
+	const emergencyStorage = browserStorage();
+	function readEmergency(key) {
+		const json = emergencyStorage?.getItem(`${emergencyPrefix}${key}`);
+		return json === null || json === void 0 ? void 0 : JSON.parse(json);
+	}
+	function emergencyKeys() {
+		if (!emergencyStorage) return [];
+		return Array.from({ length: emergencyStorage.length }, (_, index) => emergencyStorage.key(index) ?? "").filter((key) => key.startsWith(emergencyPrefix)).map((key) => key.slice(emergencyPrefix.length));
+	}
+	function openDatabase() {
+		opening ?? (opening = new Promise((resolve, reject) => {
+			const request = indexedDB.open(databaseName, 1);
+			request.onupgradeneeded = () => {
+				if (!request.result.objectStoreNames.contains(storeName)) request.result.createObjectStore(storeName);
+			};
+			request.onsuccess = () => {
+				database = request.result;
+				resolve(request.result);
+			};
+			request.onerror = () => {
+				opening = void 0;
+				reject(request.error);
+			};
+		}));
+		return opening;
+	}
+	async function run(mode, work) {
+		const transaction = (database ?? await openDatabase()).transaction(storeName, mode);
+		const result = requestToPromise(work(transaction.objectStore(storeName)));
+		await new Promise((resolve, reject) => {
+			transaction.oncomplete = () => resolve();
+			transaction.onerror = () => reject(transaction.error);
+			transaction.onabort = () => reject(transaction.error);
+		});
+		return result;
+	}
+	return {
+		get: async (key) => await run("readonly", (store) => store.get(key)) ?? readEmergency(key),
+		set: async (key, value) => {
+			await run("readwrite", (store) => store.put(value, key));
+		},
+		setNow(key, value) {
+			try {
+				emergencyStorage?.setItem(`${emergencyPrefix}${key}`, JSON.stringify(value));
+			} catch {
+				return;
+			}
+		},
+		delete: async (key) => {
+			emergencyStorage?.removeItem(`${emergencyPrefix}${key}`);
+			await run("readwrite", (store) => store.delete(key));
+		},
+		keys: async () => {
+			const stored = (await run("readonly", (store) => store.getAllKeys())).map(String);
+			return [.../* @__PURE__ */ new Set([...stored, ...emergencyKeys()])];
+		}
+	};
+}
+//#endregion
+exports.createIndexedDbRecovery = createIndexedDbRecovery;

package/dist/recovery/indexed-db-recovery.d.cts

@@ -0,0 +1,8 @@
+import { RecoveryStore } from "./recovery-store.cjs";
+//#region src/recovery/indexed-db-recovery.d.ts
+export interface IndexedDbRecoveryOptions {
+  databaseName?: string;
+  storeName?: string;
+}
+export declare function createIndexedDbRecovery(options?: IndexedDbRecoveryOptions): RecoveryStore;
+//#endregion

package/dist/recovery/indexed-db-recovery.d.ts

@@ -0,0 +1,8 @@
+import { RecoveryStore } from "./recovery-store.js";
+//#region src/recovery/indexed-db-recovery.d.ts
+export interface IndexedDbRecoveryOptions {
+  databaseName?: string;
+  storeName?: string;
+}
+export declare function createIndexedDbRecovery(options?: IndexedDbRecoveryOptions): RecoveryStore;
+//#endregion

package/dist/recovery/indexed-db-recovery.js

@@ -0,0 +1,80 @@
+//#region src/recovery/indexed-db-recovery.ts
+function requestToPromise(request) {
+	return new Promise((resolve, reject) => {
+		request.onsuccess = () => resolve(request.result);
+		request.onerror = () => reject(request.error);
+	});
+}
+function browserStorage() {
+	try {
+		return globalThis.localStorage;
+	} catch {
+		return;
+	}
+}
+function createIndexedDbRecovery(options = {}) {
+	const databaseName = options.databaseName ?? "fabricjs-document-engine";
+	const storeName = options.storeName ?? "recovery";
+	let opening;
+	let database;
+	const emergencyPrefix = `${databaseName}/${storeName}:`;
+	const emergencyStorage = browserStorage();
+	function readEmergency(key) {
+		const json = emergencyStorage?.getItem(`${emergencyPrefix}${key}`);
+		return json === null || json === void 0 ? void 0 : JSON.parse(json);
+	}
+	function emergencyKeys() {
+		if (!emergencyStorage) return [];
+		return Array.from({ length: emergencyStorage.length }, (_, index) => emergencyStorage.key(index) ?? "").filter((key) => key.startsWith(emergencyPrefix)).map((key) => key.slice(emergencyPrefix.length));
+	}
+	function openDatabase() {
+		opening ?? (opening = new Promise((resolve, reject) => {
+			const request = indexedDB.open(databaseName, 1);
+			request.onupgradeneeded = () => {
+				if (!request.result.objectStoreNames.contains(storeName)) request.result.createObjectStore(storeName);
+			};
+			request.onsuccess = () => {
+				database = request.result;
+				resolve(request.result);
+			};
+			request.onerror = () => {
+				opening = void 0;
+				reject(request.error);
+			};
+		}));
+		return opening;
+	}
+	async function run(mode, work) {
+		const transaction = (database ?? await openDatabase()).transaction(storeName, mode);
+		const result = requestToPromise(work(transaction.objectStore(storeName)));
+		await new Promise((resolve, reject) => {
+			transaction.oncomplete = () => resolve();
+			transaction.onerror = () => reject(transaction.error);
+			transaction.onabort = () => reject(transaction.error);
+		});
+		return result;
+	}
+	return {
+		get: async (key) => await run("readonly", (store) => store.get(key)) ?? readEmergency(key),
+		set: async (key, value) => {
+			await run("readwrite", (store) => store.put(value, key));
+		},
+		setNow(key, value) {
+			try {
+				emergencyStorage?.setItem(`${emergencyPrefix}${key}`, JSON.stringify(value));
+			} catch {
+				return;
+			}
+		},
+		delete: async (key) => {
+			emergencyStorage?.removeItem(`${emergencyPrefix}${key}`);
+			await run("readwrite", (store) => store.delete(key));
+		},
+		keys: async () => {
+			const stored = (await run("readonly", (store) => store.getAllKeys())).map(String);
+			return [.../* @__PURE__ */ new Set([...stored, ...emergencyKeys()])];
+		}
+	};
+}
+//#endregion
+export { createIndexedDbRecovery };

package/dist/recovery/recovery-controller.cjs

@@ -0,0 +1,159 @@
+const require_asset_pipeline = require("../assets/asset-pipeline.cjs");
+//#region src/recovery/recovery-controller.ts
+const documentKeyPrefix = "document:";
+const unloadKeyPrefix = "unload:";
+const loadingKey = "loading";
+function documentKey(documentId) {
+	return `${documentKeyPrefix}${documentId}`;
+}
+function unloadKey(documentId) {
+	return `${unloadKeyPrefix}${documentId}`;
+}
+function newerRecord(checkpoint, unloadCopy) {
+	if (!unloadCopy) return checkpoint;
+	if (!checkpoint || unloadCopy.savedAt > checkpoint.savedAt) return {
+		...unloadCopy,
+		files: {
+			...checkpoint?.files,
+			...unloadCopy.files
+		}
+	};
+	return checkpoint;
+}
+function isRecoveryRecord(value) {
+	const record = value;
+	return typeof record?.documentId === "string" && typeof record.document === "object" && record.document !== null;
+}
+async function restoreRecordedFiles(record) {
+	const document = JSON.parse(JSON.stringify(record.document));
+	const recreatedUrls = /* @__PURE__ */ new Map();
+	await require_asset_pipeline.rewriteUrls(document, async (url) => {
+		const blob = record.files[url];
+		if (!blob) return url;
+		const recreated = recreatedUrls.get(url) ?? URL.createObjectURL(blob);
+		recreatedUrls.set(url, recreated);
+		return recreated;
+	});
+	return document;
+}
+function createRecoveryController(options) {
+	const { store } = options;
+	const interval = options.interval ?? 2e3;
+	const capturedFiles = /* @__PURE__ */ new Map();
+	const readyFiles = /* @__PURE__ */ new Map();
+	let timer;
+	let queue = Promise.resolve();
+	let checkpointWaiting;
+	function enqueue(task) {
+		const run = queue.then(task).catch(options.onError);
+		queue = run;
+		return run;
+	}
+	async function captureTabOnlyFiles(document) {
+		const files = {};
+		await require_asset_pipeline.rewriteUrls(document, async (url) => {
+			if (!url.startsWith("blob:")) return url;
+			let capturing = capturedFiles.get(url);
+			if (!capturing) {
+				capturing = fetch(url).then((response) => response.blob());
+				capturedFiles.set(url, capturing);
+				capturing.then((blob) => readyFiles.set(url, blob), () => void 0);
+				capturing.catch(() => capturedFiles.delete(url));
+			}
+			files[url] = await capturing;
+			return url;
+		});
+		return files;
+	}
+	function createRecord(document, files) {
+		return {
+			documentId: document.id,
+			savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			baseRevision: document.revision ?? 0,
+			document,
+			files
+		};
+	}
+	async function writeCheckpoint() {
+		checkpointWaiting = void 0;
+		if (!options.shouldWrite()) return;
+		const document = options.createDocument();
+		const record = createRecord(document, await captureTabOnlyFiles(document));
+		await store.set(documentKey(document.id), record);
+		options.onCheckpoint(record);
+	}
+	function writeCheckpointBeforeThePageCloses() {
+		cancel();
+		if (!options.shouldWrite()) return;
+		const document = options.createDocument();
+		if (store.setNow) {
+			store.setNow(unloadKey(document.id), createRecord(document, {}));
+			return;
+		}
+		const record = createRecord(document, Object.fromEntries(readyFiles));
+		store.set(documentKey(document.id), record).then(() => options.onCheckpoint(record), options.onError);
+	}
+	async function read(documentId) {
+		await queue;
+		const [checkpoint, unloadCopy] = await Promise.all([store.get(documentKey(documentId)), store.get(unloadKey(documentId))]);
+		return newerRecord(isRecoveryRecord(checkpoint) ? checkpoint : void 0, isRecoveryRecord(unloadCopy) ? unloadCopy : void 0);
+	}
+	function cancel() {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+	}
+	function flush() {
+		cancel();
+		checkpointWaiting ?? (checkpointWaiting = enqueue(writeCheckpoint));
+		return checkpointWaiting;
+	}
+	const handlePageHidden = () => writeCheckpointBeforeThePageCloses();
+	const handleVisibilityChange = () => {
+		if (document.visibilityState === "hidden") writeCheckpointBeforeThePageCloses();
+	};
+	const pageEvents = typeof window === "undefined" ? void 0 : window;
+	pageEvents?.addEventListener("pagehide", handlePageHidden);
+	pageEvents?.document.addEventListener("visibilitychange", handleVisibilityChange);
+	return {
+		schedule() {
+			if (timer !== void 0) return;
+			timer = setTimeout(() => {
+				timer = void 0;
+				flush();
+			}, interval);
+		},
+		flush,
+		cancel,
+		remove: (documentId) => enqueue(async () => {
+			await store.delete(unloadKey(documentId));
+			await store.delete(documentKey(documentId));
+		}),
+		read,
+		async list() {
+			await queue;
+			const documentIds = /* @__PURE__ */ new Set();
+			for (const key of await store.keys()) {
+				if (key.startsWith(documentKeyPrefix)) documentIds.add(key.slice(9));
+				if (key.startsWith(unloadKeyPrefix)) documentIds.add(key.slice(7));
+			}
+			return (await Promise.all([...documentIds].map(read))).filter((record) => record !== void 0).sort((first, second) => second.savedAt.localeCompare(first.savedAt));
+		},
+		markLoadStarted: (documentId) => store.set(loadingKey, {
+			documentId,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString()
+		}).catch(options.onError),
+		markLoadFinished: () => store.delete(loadingKey).catch(options.onError),
+		async interruptedLoad() {
+			const marker = await store.get(loadingKey);
+			return marker && typeof marker.startedAt === "string" ? marker : void 0;
+		},
+		destroy() {
+			cancel();
+			pageEvents?.removeEventListener("pagehide", handlePageHidden);
+			pageEvents?.document.removeEventListener("visibilitychange", handleVisibilityChange);
+		}
+	};
+}
+//#endregion
+exports.createRecoveryController = createRecoveryController;
+exports.restoreRecordedFiles = restoreRecordedFiles;

package/dist/recovery/recovery-controller.d.cts

@@ -0,0 +1,19 @@
+import { FabricDocument } from "../document/document-format.cjs";
+import { RecoveryStore } from "./recovery-store.cjs";
+//#region src/recovery/recovery-controller.d.ts
+export interface RecoveryOptions {
+  store: RecoveryStore;
+  interval?: number;
+}
+export interface RecoveryRecord {
+  documentId: string;
+  savedAt: string;
+  baseRevision: number;
+  document: FabricDocument;
+  files: Record<string, Blob>;
+}
+export interface InterruptedLoad {
+  documentId: string | undefined;
+  startedAt: string;
+}
+//#endregion

package/dist/recovery/recovery-controller.d.ts

@@ -0,0 +1,19 @@
+import { FabricDocument } from "../document/document-format.js";
+import { RecoveryStore } from "./recovery-store.js";
+//#region src/recovery/recovery-controller.d.ts
+export interface RecoveryOptions {
+  store: RecoveryStore;
+  interval?: number;
+}
+export interface RecoveryRecord {
+  documentId: string;
+  savedAt: string;
+  baseRevision: number;
+  document: FabricDocument;
+  files: Record<string, Blob>;
+}
+export interface InterruptedLoad {
+  documentId: string | undefined;
+  startedAt: string;
+}
+//#endregion

package/dist/recovery/recovery-controller.js

@@ -0,0 +1,158 @@
+import { rewriteUrls } from "../assets/asset-pipeline.js";
+//#region src/recovery/recovery-controller.ts
+const documentKeyPrefix = "document:";
+const unloadKeyPrefix = "unload:";
+const loadingKey = "loading";
+function documentKey(documentId) {
+	return `${documentKeyPrefix}${documentId}`;
+}
+function unloadKey(documentId) {
+	return `${unloadKeyPrefix}${documentId}`;
+}
+function newerRecord(checkpoint, unloadCopy) {
+	if (!unloadCopy) return checkpoint;
+	if (!checkpoint || unloadCopy.savedAt > checkpoint.savedAt) return {
+		...unloadCopy,
+		files: {
+			...checkpoint?.files,
+			...unloadCopy.files
+		}
+	};
+	return checkpoint;
+}
+function isRecoveryRecord(value) {
+	const record = value;
+	return typeof record?.documentId === "string" && typeof record.document === "object" && record.document !== null;
+}
+async function restoreRecordedFiles(record) {
+	const document = JSON.parse(JSON.stringify(record.document));
+	const recreatedUrls = /* @__PURE__ */ new Map();
+	await rewriteUrls(document, async (url) => {
+		const blob = record.files[url];
+		if (!blob) return url;
+		const recreated = recreatedUrls.get(url) ?? URL.createObjectURL(blob);
+		recreatedUrls.set(url, recreated);
+		return recreated;
+	});
+	return document;
+}
+function createRecoveryController(options) {
+	const { store } = options;
+	const interval = options.interval ?? 2e3;
+	const capturedFiles = /* @__PURE__ */ new Map();
+	const readyFiles = /* @__PURE__ */ new Map();
+	let timer;
+	let queue = Promise.resolve();
+	let checkpointWaiting;
+	function enqueue(task) {
+		const run = queue.then(task).catch(options.onError);
+		queue = run;
+		return run;
+	}
+	async function captureTabOnlyFiles(document) {
+		const files = {};
+		await rewriteUrls(document, async (url) => {
+			if (!url.startsWith("blob:")) return url;
+			let capturing = capturedFiles.get(url);
+			if (!capturing) {
+				capturing = fetch(url).then((response) => response.blob());
+				capturedFiles.set(url, capturing);
+				capturing.then((blob) => readyFiles.set(url, blob), () => void 0);
+				capturing.catch(() => capturedFiles.delete(url));
+			}
+			files[url] = await capturing;
+			return url;
+		});
+		return files;
+	}
+	function createRecord(document, files) {
+		return {
+			documentId: document.id,
+			savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			baseRevision: document.revision ?? 0,
+			document,
+			files
+		};
+	}
+	async function writeCheckpoint() {
+		checkpointWaiting = void 0;
+		if (!options.shouldWrite()) return;
+		const document = options.createDocument();
+		const record = createRecord(document, await captureTabOnlyFiles(document));
+		await store.set(documentKey(document.id), record);
+		options.onCheckpoint(record);
+	}
+	function writeCheckpointBeforeThePageCloses() {
+		cancel();
+		if (!options.shouldWrite()) return;
+		const document = options.createDocument();
+		if (store.setNow) {
+			store.setNow(unloadKey(document.id), createRecord(document, {}));
+			return;
+		}
+		const record = createRecord(document, Object.fromEntries(readyFiles));
+		store.set(documentKey(document.id), record).then(() => options.onCheckpoint(record), options.onError);
+	}
+	async function read(documentId) {
+		await queue;
+		const [checkpoint, unloadCopy] = await Promise.all([store.get(documentKey(documentId)), store.get(unloadKey(documentId))]);
+		return newerRecord(isRecoveryRecord(checkpoint) ? checkpoint : void 0, isRecoveryRecord(unloadCopy) ? unloadCopy : void 0);
+	}
+	function cancel() {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+	}
+	function flush() {
+		cancel();
+		checkpointWaiting ?? (checkpointWaiting = enqueue(writeCheckpoint));
+		return checkpointWaiting;
+	}
+	const handlePageHidden = () => writeCheckpointBeforeThePageCloses();
+	const handleVisibilityChange = () => {
+		if (document.visibilityState === "hidden") writeCheckpointBeforeThePageCloses();
+	};
+	const pageEvents = typeof window === "undefined" ? void 0 : window;
+	pageEvents?.addEventListener("pagehide", handlePageHidden);
+	pageEvents?.document.addEventListener("visibilitychange", handleVisibilityChange);
+	return {
+		schedule() {
+			if (timer !== void 0) return;
+			timer = setTimeout(() => {
+				timer = void 0;
+				flush();
+			}, interval);
+		},
+		flush,
+		cancel,
+		remove: (documentId) => enqueue(async () => {
+			await store.delete(unloadKey(documentId));
+			await store.delete(documentKey(documentId));
+		}),
+		read,
+		async list() {
+			await queue;
+			const documentIds = /* @__PURE__ */ new Set();
+			for (const key of await store.keys()) {
+				if (key.startsWith(documentKeyPrefix)) documentIds.add(key.slice(9));
+				if (key.startsWith(unloadKeyPrefix)) documentIds.add(key.slice(7));
+			}
+			return (await Promise.all([...documentIds].map(read))).filter((record) => record !== void 0).sort((first, second) => second.savedAt.localeCompare(first.savedAt));
+		},
+		markLoadStarted: (documentId) => store.set(loadingKey, {
+			documentId,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString()
+		}).catch(options.onError),
+		markLoadFinished: () => store.delete(loadingKey).catch(options.onError),
+		async interruptedLoad() {
+			const marker = await store.get(loadingKey);
+			return marker && typeof marker.startedAt === "string" ? marker : void 0;
+		},
+		destroy() {
+			cancel();
+			pageEvents?.removeEventListener("pagehide", handlePageHidden);
+			pageEvents?.document.removeEventListener("visibilitychange", handleVisibilityChange);
+		}
+	};
+}
+//#endregion
+export { createRecoveryController, restoreRecordedFiles };

package/dist/recovery/recovery-store.cjs

@@ -0,0 +1,19 @@
+//#region src/recovery/recovery-store.ts
+function createMemoryRecovery() {
+	const values = /* @__PURE__ */ new Map();
+	return {
+		get: async (key) => values.get(key),
+		set: async (key, value) => {
+			values.set(key, value);
+		},
+		setNow: (key, value) => {
+			values.set(key, value);
+		},
+		delete: async (key) => {
+			values.delete(key);
+		},
+		keys: async () => [...values.keys()]
+	};
+}
+//#endregion
+exports.createMemoryRecovery = createMemoryRecovery;

package/dist/recovery/recovery-store.d.cts

@@ -0,0 +1,10 @@
+//#region src/recovery/recovery-store.d.ts
+export interface RecoveryStore {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: unknown): Promise<void>;
+  setNow?(key: string, value: unknown): void;
+  delete(key: string): Promise<void>;
+  keys(): Promise<string[]>;
+}
+export declare function createMemoryRecovery(): RecoveryStore;
+//#endregion

package/dist/recovery/recovery-store.d.ts

@@ -0,0 +1,10 @@
+//#region src/recovery/recovery-store.d.ts
+export interface RecoveryStore {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: unknown): Promise<void>;
+  setNow?(key: string, value: unknown): void;
+  delete(key: string): Promise<void>;
+  keys(): Promise<string[]>;
+}
+export declare function createMemoryRecovery(): RecoveryStore;
+//#endregion

package/dist/recovery/recovery-store.js

@@ -0,0 +1,19 @@
+//#region src/recovery/recovery-store.ts
+function createMemoryRecovery() {
+	const values = /* @__PURE__ */ new Map();
+	return {
+		get: async (key) => values.get(key),
+		set: async (key, value) => {
+			values.set(key, value);
+		},
+		setNow: (key, value) => {
+			values.set(key, value);
+		},
+		delete: async (key) => {
+			values.delete(key);
+		},
+		keys: async () => [...values.keys()]
+	};
+}
+//#endregion
+export { createMemoryRecovery };

package/dist/recovery.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_indexed_db_recovery = require("./recovery/indexed-db-recovery.cjs");
+const require_recovery_store = require("./recovery/recovery-store.cjs");
+exports.createIndexedDbRecovery = require_indexed_db_recovery.createIndexedDbRecovery;
+exports.createMemoryRecovery = require_recovery_store.createMemoryRecovery;

package/dist/recovery.d.cts

@@ -0,0 +1,4 @@
+import { RecoveryStore, createMemoryRecovery } from "./recovery/recovery-store.cjs";
+import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.cjs";
+import { IndexedDbRecoveryOptions, createIndexedDbRecovery } from "./recovery/indexed-db-recovery.cjs";
+export { type IndexedDbRecoveryOptions, type InterruptedLoad, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, createIndexedDbRecovery, createMemoryRecovery };

package/dist/recovery.d.ts

@@ -0,0 +1,4 @@
+import { RecoveryStore, createMemoryRecovery } from "./recovery/recovery-store.js";
+import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.js";
+import { IndexedDbRecoveryOptions, createIndexedDbRecovery } from "./recovery/indexed-db-recovery.js";
+export { type IndexedDbRecoveryOptions, type InterruptedLoad, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, createIndexedDbRecovery, createMemoryRecovery };