@fieldnotes/core 0.44.0 → 0.45.0

package/dist/index.cjs

@@ -29,9 +29,12 @@ __export(index_exports, {
   HandTool: () => HandTool,
   HistoryStack: () => HistoryStack,
   ImageTool: () => ImageTool,
+  IndexedDBAdapter: () => IndexedDBAdapter,
   LaserTool: () => LaserTool,
   LayerManager: () => LayerManager,
+  LocalStorageAdapter: () => LocalStorageAdapter,
   MeasureTool: () => MeasureTool,
+  MemoryAdapter: () => MemoryAdapter,
   NoteTool: () => NoteTool,
   PencilTool: () => PencilTool,
   SelectTool: () => SelectTool,
@@ -368,6 +371,22 @@ function migrateElement(obj) {
   }
 }
 
+// src/core/storage/local-storage-adapter.ts
+var LocalStorageAdapter = class {
+  async load(key) {
+    if (typeof localStorage === "undefined") return null;
+    return localStorage.getItem(key);
+  }
+  async save(key, value) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(key, value);
+  }
+  async clear(key) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.removeItem(key);
+  }
+};
+
 // src/core/auto-save.ts
 var DEFAULT_KEY = "fieldnotes-autosave";
 var DEFAULT_DEBOUNCE_MS = 1e3;
@@ -378,14 +397,18 @@ var AutoSave = class {
     this.key = options.key ?? DEFAULT_KEY;
     this.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
     this.layerManager = options.layerManager;
+    this.adapter = options.adapter ?? new LocalStorageAdapter();
     this.onError = options.onError;
   }
   key;
   debounceMs;
   layerManager;
+  adapter;
   timerId = null;
   unsubscribers = [];
   onError;
+  saving = false;
+  pendingSave = false;
   start() {
     const schedule = () => this.scheduleSave();
     this.unsubscribers = [
@@ -403,9 +426,8 @@ var AutoSave = class {
     this.unsubscribers.forEach((fn) => fn());
     this.unsubscribers = [];
   }
-  load() {
-    if (typeof localStorage === "undefined") return null;
-    const json = localStorage.getItem(this.key);
+  async load() {
+    const json = await this.adapter.load(this.key);
     if (!json) return null;
     try {
       return parseState(json);
@@ -413,13 +435,12 @@ var AutoSave = class {
       return null;
     }
   }
-  clear() {
-    if (typeof localStorage === "undefined") return;
-    localStorage.removeItem(this.key);
+  async clear() {
+    await this.adapter.clear(this.key);
   }
   scheduleSave() {
     this.cancelPending();
-    this.timerId = setTimeout(() => this.save(), this.debounceMs);
+    this.timerId = setTimeout(() => void this.save(), this.debounceMs);
   }
   cancelPending() {
     if (this.timerId !== null) {
@@ -427,16 +448,105 @@ var AutoSave = class {
       this.timerId = null;
     }
   }
-  save() {
-    if (typeof localStorage === "undefined") return;
-    const layers = this.layerManager?.snapshot() ?? [];
-    const state = exportState(this.store.snapshot(), this.camera, layers);
+  async save() {
+    if (this.saving) {
+      this.pendingSave = true;
+      return;
+    }
+    this.saving = true;
     try {
-      localStorage.setItem(this.key, JSON.stringify(state));
+      const layers = this.layerManager?.snapshot() ?? [];
+      const state = exportState(this.store.snapshot(), this.camera, layers);
+      await this.adapter.save(this.key, JSON.stringify(state));
     } catch (e) {
-      console.warn("Auto-save failed: storage quota exceeded. State too large for localStorage.");
       this.onError?.(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      this.saving = false;
+      if (this.pendingSave) {
+        this.pendingSave = false;
+        void this.save();
+      }
+    }
+  }
+};
+
+// src/core/storage/memory-adapter.ts
+var MemoryAdapter = class {
+  store = /* @__PURE__ */ new Map();
+  async load(key) {
+    return this.store.get(key) ?? null;
+  }
+  async save(key, value) {
+    this.store.set(key, value);
+  }
+  async clear(key) {
+    this.store.delete(key);
+  }
+};
+
+// src/core/storage/indexeddb-adapter.ts
+var DEFAULT_DB = "fieldnotes";
+var DEFAULT_STORE = "state";
+var IndexedDBAdapter = class {
+  dbName;
+  storeName;
+  idb;
+  dbPromise = null;
+  constructor(options = {}) {
+    this.dbName = options.dbName ?? DEFAULT_DB;
+    this.storeName = options.storeName ?? DEFAULT_STORE;
+    this.idb = options.indexedDB ?? (typeof indexedDB !== "undefined" ? indexedDB : null);
+  }
+  open() {
+    const idb = this.idb;
+    if (!idb) return Promise.reject(new Error("IndexedDB unavailable"));
+    if (!this.dbPromise) {
+      const storeName = this.storeName;
+      this.dbPromise = new Promise((resolve, reject) => {
+        const req = idb.open(this.dbName, 1);
+        req.onupgradeneeded = () => {
+          const db = req.result;
+          if (!db.objectStoreNames.contains(storeName)) db.createObjectStore(storeName);
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error ?? new Error("IndexedDB open failed"));
+      });
     }
+    return this.dbPromise;
+  }
+  async load(key) {
+    if (!this.idb) return null;
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const req = db.transaction(this.storeName, "readonly").objectStore(this.storeName).get(key);
+      req.onsuccess = () => {
+        const v = req.result;
+        resolve(typeof v === "string" ? v : null);
+      };
+      req.onerror = () => reject(req.error ?? new Error("IndexedDB read failed"));
+    });
+  }
+  async save(key, value) {
+    if (!this.idb) return;
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).put(value, key);
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error ?? new Error("IndexedDB write failed"));
+      tx.onabort = () => reject(tx.error ?? new Error("IndexedDB write aborted"));
+    });
+  }
+  async clear(key) {
+    if (!this.idb) return;
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).delete(key);
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error ?? new Error("IndexedDB delete failed"));
+      tx.onabort = () => reject(tx.error ?? new Error("IndexedDB delete aborted"));
+    });
   }
 };
 
@@ -10057,7 +10167,7 @@ var LaserTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.44.0";
+var VERSION = "0.45.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArrowTool,
@@ -10069,9 +10179,12 @@ var VERSION = "0.44.0";
   HandTool,
   HistoryStack,
   ImageTool,
+  IndexedDBAdapter,
   LaserTool,
   LayerManager,
+  LocalStorageAdapter,
   MeasureTool,
+  MemoryAdapter,
   NoteTool,
   PencilTool,
   SelectTool,