@getforma/core 1.4.0 → 1.5.0

package/dist/{resource-D6HfVgiA.d.cts → resource-CBTcorBJ.d.ts}

@@ -1,4 +1,4 @@
-import { S as SignalGetter } from './signal-CRBJYQ6B.cjs';
+import { S as SignalGetter } from './signal-CIXTR4Qz.js';
 
 /**
  * Forma Reactive - Resource
@@ -66,4 +66,4 @@ interface ResourceOptions<T> {
  */
 declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S, info: ResourceFetcherInfo) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
 
-export { type Resource as R, type ResourceOptions as a, createResource as c };
+export { type Resource as R, type ResourceFetcherInfo as a, type ResourceOptions as b, createResource as c };

package/dist/{resource-ljs2X5NM.d.ts → resource-CaFfIB5i.d.cts}

@@ -1,4 +1,4 @@
-import { S as SignalGetter } from './signal-CRBJYQ6B.js';
+import { S as SignalGetter } from './signal-CIXTR4Qz.cjs';
 
 /**
  * Forma Reactive - Resource
@@ -66,4 +66,4 @@ interface ResourceOptions<T> {
  */
 declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S, info: ResourceFetcherInfo) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
 
-export { type Resource as R, type ResourceOptions as a, createResource as c };
+export { type Resource as R, type ResourceFetcherInfo as a, type ResourceOptions as b, createResource as c };

package/dist/runtime.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkFBM7V4NE_cjs = require('./chunk-FBM7V4NE.cjs');
+var chunkD46EJ3VS_cjs = require('./chunk-D46EJ3VS.cjs');
 var chunk263HW3KN_cjs = require('./chunk-263HW3KN.cjs');
-var chunkKUXNZ5MG_cjs = require('./chunk-KUXNZ5MG.cjs');
-var chunkH7MDUHS5_cjs = require('./chunk-H7MDUHS5.cjs');
+var chunkPAKPQRVE_cjs = require('./chunk-PAKPQRVE.cjs');
+var chunkHAULTMNX_cjs = require('./chunk-HAULTMNX.cjs');
 
 // src/dom/reconcile.ts
 function getBindTargets(el) {
@@ -1062,7 +1062,7 @@ function parseIfHandler(expr, scope) {
   }
   if (rest.length > 0) return null;
   return (e) => {
-    chunkKUXNZ5MG_cjs.batch(() => {
+    chunkPAKPQRVE_cjs.batch(() => {
       if (condExpr()) thenHandler(e);
       else elseHandler?.(e);
     });
@@ -1816,7 +1816,7 @@ function parseHandler(expr, scope) {
     const handlers = stmts.map((s) => parseHandler(s, scope));
     if (handlers.every((h) => h !== null)) {
       return (e) => {
-        chunkKUXNZ5MG_cjs.batch(() => {
+        chunkPAKPQRVE_cjs.batch(() => {
           for (const h of handlers) h(e);
         });
       };
@@ -1829,7 +1829,7 @@ function parseHandler(expr, scope) {
     const name = incrMatch[1];
     const op = incrMatch[2];
     return () => {
-      chunkKUXNZ5MG_cjs.batch(() => {
+      chunkPAKPQRVE_cjs.batch(() => {
         const val = scope.getters[name]?.() ?? 0;
         scope.setters[name]?.(op === "++" ? val + 1 : val - 1);
       });
@@ -1840,7 +1840,7 @@ function parseHandler(expr, scope) {
     const op = preIncrMatch[1];
     const name = preIncrMatch[2];
     return () => {
-      chunkKUXNZ5MG_cjs.batch(() => {
+      chunkPAKPQRVE_cjs.batch(() => {
         const val = scope.getters[name]?.() ?? 0;
         scope.setters[name]?.(op === "++" ? val + 1 : val - 1);
       });
@@ -1850,7 +1850,7 @@ function parseHandler(expr, scope) {
   if (toggleMatch && toggleMatch[1] === toggleMatch[2]) {
     const name = toggleMatch[1];
     return () => {
-      chunkKUXNZ5MG_cjs.batch(() => {
+      chunkPAKPQRVE_cjs.batch(() => {
         scope.setters[name]?.(!scope.getters[name]?.());
       });
     };
@@ -1862,7 +1862,7 @@ function parseHandler(expr, scope) {
     if (valExpr) {
       if (_debug) dbg(`parseHandler: assignment "${name} = ..." \u2014 setter exists:`, !!scope.setters[name], ", getter exists:", !!scope.getters[name]);
       return () => {
-        chunkKUXNZ5MG_cjs.batch(() => {
+        chunkPAKPQRVE_cjs.batch(() => {
           const val = valExpr();
           if (_debug) dbg(`SETTER: ${name} = ${val} (was: ${scope.getters[name]?.()})`);
           scope.setters[name]?.(val);
@@ -1877,7 +1877,7 @@ function parseHandler(expr, scope) {
     const valExpr = parseExpression(compoundMatch[3].trim(), scope);
     if (valExpr) {
       return () => {
-        chunkKUXNZ5MG_cjs.batch(() => {
+        chunkPAKPQRVE_cjs.batch(() => {
           const current = scope.getters[name]?.() ?? 0;
           const val = valExpr();
           switch (op) {
@@ -1958,7 +1958,7 @@ function buildHandler(expr, scope) {
       }
     });
     const unsafeHandler = (e) => {
-      chunkKUXNZ5MG_cjs.batch(() => fn(proxy, e, e));
+      chunkPAKPQRVE_cjs.batch(() => fn(proxy, e, e));
     };
     const result = {
       handler: unsafeHandler,
@@ -2006,7 +2006,7 @@ function initScope(stateEl) {
   const getters = {};
   const setters = {};
   for (const [key, initial] of Object.entries(state)) {
-    const [get, set] = chunkH7MDUHS5_cjs.createSignal(initial);
+    const [get, set] = chunkHAULTMNX_cjs.createSignal(initial);
     getters[key] = get;
     setters[key] = set;
   }
@@ -2118,7 +2118,7 @@ function bindElement(el, scope, disposers) {
         const prevGetter = scope.getters[name];
         delete scope.getters[name];
         const evaluate = buildEvaluator(`{${expr}}`, scope);
-        const getter = chunkH7MDUHS5_cjs.createComputed(evaluate);
+        const getter = chunkHAULTMNX_cjs.createComputed(evaluate);
         scope.getters[name] = getter;
         if (!prevGetter) {
           delete scope.setters[name];
@@ -2129,7 +2129,7 @@ function bindElement(el, scope, disposers) {
   const textExpr = !known || known.has("data-text") ? el.getAttribute("data-text") : null;
   if (textExpr) {
     const evaluate = buildEvaluator(textExpr, scope);
-    const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+    const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
       setElementTextFast(el, toTextValue(evaluate()));
     });
     disposers.push(dispose);
@@ -2144,7 +2144,7 @@ function bindElement(el, scope, disposers) {
       dbg(`bindElement: data-show="${showExpr}" on <${tag}${cls}>`);
     }
     let initialized = false;
-    const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+    const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
       const visible = !!evaluate();
       if (_debug) dbg(`data-show effect: "${showExpr}" \u2192 ${visible}`);
       applyShowVisibility(el, visible, transition, !initialized);
@@ -2163,7 +2163,7 @@ function bindElement(el, scope, disposers) {
     const parent = el.parentNode;
     let inserted = true;
     let initialized = false;
-    const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+    const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
       const show = !!evaluate();
       if (show && !inserted) {
         clearTransitionState(el);
@@ -2214,7 +2214,7 @@ function bindElement(el, scope, disposers) {
     if (getter && setter) {
       const input = el;
       const tag = input.tagName;
-      const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+      const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
         const val = getter();
         const type = input.type;
         if (type === "checkbox") {
@@ -2302,14 +2302,14 @@ function bindElement(el, scope, disposers) {
     } else if (name.startsWith("data-class:")) {
       const cls = name.slice(11);
       const evaluate = buildEvaluator(attr.value, scope);
-      const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+      const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
         el.classList.toggle(cls, !!evaluate());
       });
       disposers.push(dispose);
     } else if (name.startsWith("data-bind:")) {
       const attrName = name.slice(10);
       const evaluate = buildEvaluator(attr.value, scope);
-      const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+      const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
         const val = evaluate();
         if (val == null || val === false) {
           el.removeAttribute(attrName);
@@ -2337,7 +2337,7 @@ function bindElement(el, scope, disposers) {
         if (saved !== null) setter(JSON.parse(saved));
       } catch {
       }
-      const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+      const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
         try {
           localStorage.setItem(key, JSON.stringify(getter()));
         } catch {
@@ -2424,7 +2424,7 @@ function bindElement(el, scope, disposers) {
           });
         }
       } : void 0;
-      const dispose = chunkKUXNZ5MG_cjs.internalEffect(() => {
+      const dispose = chunkPAKPQRVE_cjs.internalEffect(() => {
         const rawItems = evaluate();
         if (!Array.isArray(rawItems)) {
           for (const n of oldNodes) {
@@ -2447,7 +2447,7 @@ function bindElement(el, scope, disposers) {
         const wrapped = rawItems.map((item, i) => ({ __idx: i, __item: item }));
         const oldWrapped = oldItems;
         const keyFn = keyProp ? (w) => String(w.__item?.[keyProp] ?? "") : (w) => w.__idx;
-        const result = chunkFBM7V4NE_cjs.reconcileList(
+        const result = chunkD46EJ3VS_cjs.reconcileList(
           el,
           oldWrapped,
           wrapped,
@@ -2495,16 +2495,16 @@ function bindElement(el, scope, disposers) {
         else if (k === "error") errorTarget = v;
         else if (k === "poll") interval = parseInt(v ?? "0", 10);
       }
-      const [getTarget, setTarget] = chunkH7MDUHS5_cjs.createSignal(null);
+      const [getTarget, setTarget] = chunkHAULTMNX_cjs.createSignal(null);
       scope.getters[target] = getTarget;
       scope.setters[target] = setTarget;
       if (loadingTarget) {
-        const [gl, sl] = chunkH7MDUHS5_cjs.createSignal(false);
+        const [gl, sl] = chunkHAULTMNX_cjs.createSignal(false);
         scope.getters[loadingTarget] = gl;
         scope.setters[loadingTarget] = sl;
       }
       if (errorTarget) {
-        const [ge, se] = chunkH7MDUHS5_cjs.createSignal(null);
+        const [ge, se] = chunkHAULTMNX_cjs.createSignal(null);
         scope.getters[errorTarget] = ge;
         scope.setters[errorTarget] = se;
       }
@@ -2833,7 +2833,7 @@ function getScopes() {
 function setScopeValue(element, key, value) {
   const scope = element.__formaScope;
   if (!scope?.setters[key]) return;
-  chunkKUXNZ5MG_cjs.batch(() => {
+  chunkPAKPQRVE_cjs.batch(() => {
     scope.setters[key](value);
   });
 }
@@ -2842,7 +2842,7 @@ function resetScope(element) {
   const initialJSON = element.__formaInitialState;
   if (!scope || !initialJSON) return;
   const initial = parseState(initialJSON);
-  chunkKUXNZ5MG_cjs.batch(() => {
+  chunkPAKPQRVE_cjs.batch(() => {
     for (const [key, val] of Object.entries(initial)) {
       scope.setters[key]?.(val);
     }
@@ -2872,7 +2872,7 @@ function getReconciler() {
           }
         }
       },
-      batch: chunkKUXNZ5MG_cjs.batch
+      batch: chunkPAKPQRVE_cjs.batch
     });
   }
   return _reconciler;

package/dist/runtime.js

@@ -1,7 +1,7 @@
-import { reconcileList } from './chunk-AJP4OVCN.js';
+import { reconcileList } from './chunk-3U2IQIKB.js';
 import { isEventHandlerAttr, isUrlAttr, isDangerousUrl } from './chunk-2QQBKQIF.js';
-import { internalEffect, batch } from './chunk-Y3A2EVVS.js';
-import { createSignal, createComputed } from './chunk-ETPJTPYD.js';
+import { internalEffect, batch } from './chunk-F5QUU76U.js';
+import { createSignal, createComputed } from './chunk-FAIWRZKJ.js';
 
 // src/dom/reconcile.ts
 function getBindTargets(el) {

package/dist/server.cjs

@@ -1,25 +1,25 @@
 'use strict';
 
-var chunkKUXNZ5MG_cjs = require('./chunk-KUXNZ5MG.cjs');
-var chunkH7MDUHS5_cjs = require('./chunk-H7MDUHS5.cjs');
+var chunkPAKPQRVE_cjs = require('./chunk-PAKPQRVE.cjs');
+var chunkHAULTMNX_cjs = require('./chunk-HAULTMNX.cjs');
 
 // src/server/action.ts
 function createAction(serverFn, options) {
-  const [pending, setPending] = chunkH7MDUHS5_cjs.createSignal(false);
-  const [error, setError] = chunkH7MDUHS5_cjs.createSignal(void 0);
+  const [pending, setPending] = chunkHAULTMNX_cjs.createSignal(false);
+  const [error, setError] = chunkHAULTMNX_cjs.createSignal(void 0);
   const action = async (...args) => {
     setPending(true);
     setError(void 0);
     if (options?.optimistic) {
       try {
-        chunkKUXNZ5MG_cjs.batch(() => options.optimistic(...args));
+        chunkPAKPQRVE_cjs.batch(() => options.optimistic(...args));
       } catch {
       }
     }
     try {
       const result = await serverFn(...args);
       if (options?.onSuccess) {
-        chunkKUXNZ5MG_cjs.batch(() => options.onSuccess(result, ...args));
+        chunkPAKPQRVE_cjs.batch(() => options.onSuccess(result, ...args));
       }
       if (options?.invalidates) {
         for (const resource of options.invalidates) {
@@ -31,7 +31,7 @@ function createAction(serverFn, options) {
     } catch (err) {
       if (options?.onError) {
         try {
-          chunkKUXNZ5MG_cjs.batch(() => options.onError(err, ...args));
+          chunkPAKPQRVE_cjs.batch(() => options.onError(err, ...args));
         } catch {
         }
       }

package/dist/server.d.cts

@@ -1,5 +1,5 @@
-import { R as Resource } from './resource-D6HfVgiA.cjs';
-import './signal-CRBJYQ6B.cjs';
+import { R as Resource } from './resource-CaFfIB5i.cjs';
+import './signal-CIXTR4Qz.cjs';
 
 /**
  * FormaJS Server - Action

package/dist/server.d.ts

@@ -1,5 +1,5 @@
-import { R as Resource } from './resource-ljs2X5NM.js';
-import './signal-CRBJYQ6B.js';
+import { R as Resource } from './resource-CBTcorBJ.js';
+import './signal-CIXTR4Qz.js';
 
 /**
  * FormaJS Server - Action

package/dist/server.js

@@ -1,5 +1,5 @@
-import { batch } from './chunk-Y3A2EVVS.js';
-import { createSignal } from './chunk-ETPJTPYD.js';
+import { batch } from './chunk-F5QUU76U.js';
+import { createSignal } from './chunk-FAIWRZKJ.js';
 
 // src/server/action.ts
 function createAction(serverFn, options) {

package/dist/{signal-CRBJYQ6B.d.cts → signal-CIXTR4Qz.d.cts}

@@ -1,3 +1,13 @@
+/**
+ * Forma Reactive - Signal
+ *
+ * Fine-grained reactive primitive backed by alien-signals.
+ * API: createSignal returns [getter, setter] tuple following SolidJS conventions.
+ *
+ * TC39 Signals equivalent: Signal.State
+ */
+/** Debug name of a signal getter, if one was provided (dev-only). */
+declare function getSignalName(fn: unknown): string | undefined;
 /** A function that reads the current value of a signal. */
 type SignalGetter<T> = () => T;
 /** A function that updates a signal — accepts a value or an updater function. */
@@ -23,6 +33,24 @@ interface SignalOptions<T> {
      */
     equals?: (prev: T, next: T) => boolean;
 }
+/**
+ * Wrap a value so the setter treats it as a literal value, not a functional updater.
+ *
+ * When `T` is itself a function type, passing a function to the setter is
+ * ambiguous -- it looks like a functional update (`prev => next`). Use
+ * `value()` to disambiguate:
+ *
+ * ```ts
+ * const [getFn, setFn] = createSignal<() => void>(() => console.log('a'));
+ *
+ * // BUG: interpreted as a functional update -- calls the arrow with prev
+ * // setFn(() => console.log('b'));
+ *
+ * // Correct: wraps in a thunk so the setter stores it as-is
+ * setFn(value(() => console.log('b')));
+ * ```
+ */
+declare function value<T>(v: T): () => T;
 /**
  * Create a reactive signal.
  *
@@ -44,4 +72,4 @@ interface SignalOptions<T> {
  */
 declare function createSignal<T>(initialValue: T, options?: SignalOptions<T>): [get: SignalGetter<T>, set: SignalSetter<T>];
 
-export { type SignalGetter as S, type SignalOptions as a, type SignalSetter as b, createSignal as c };
+export { type SignalGetter as S, type SignalOptions as a, type SignalSetter as b, createSignal as c, getSignalName as g, value as v };

package/dist/{signal-CRBJYQ6B.d.ts → signal-CIXTR4Qz.d.ts}

@@ -1,3 +1,13 @@
+/**
+ * Forma Reactive - Signal
+ *
+ * Fine-grained reactive primitive backed by alien-signals.
+ * API: createSignal returns [getter, setter] tuple following SolidJS conventions.
+ *
+ * TC39 Signals equivalent: Signal.State
+ */
+/** Debug name of a signal getter, if one was provided (dev-only). */
+declare function getSignalName(fn: unknown): string | undefined;
 /** A function that reads the current value of a signal. */
 type SignalGetter<T> = () => T;
 /** A function that updates a signal — accepts a value or an updater function. */
@@ -23,6 +33,24 @@ interface SignalOptions<T> {
      */
     equals?: (prev: T, next: T) => boolean;
 }
+/**
+ * Wrap a value so the setter treats it as a literal value, not a functional updater.
+ *
+ * When `T` is itself a function type, passing a function to the setter is
+ * ambiguous -- it looks like a functional update (`prev => next`). Use
+ * `value()` to disambiguate:
+ *
+ * ```ts
+ * const [getFn, setFn] = createSignal<() => void>(() => console.log('a'));
+ *
+ * // BUG: interpreted as a functional update -- calls the arrow with prev
+ * // setFn(() => console.log('b'));
+ *
+ * // Correct: wraps in a thunk so the setter stores it as-is
+ * setFn(value(() => console.log('b')));
+ * ```
+ */
+declare function value<T>(v: T): () => T;
 /**
  * Create a reactive signal.
  *
@@ -44,4 +72,4 @@ interface SignalOptions<T> {
  */
 declare function createSignal<T>(initialValue: T, options?: SignalOptions<T>): [get: SignalGetter<T>, set: SignalSetter<T>];
 
-export { type SignalGetter as S, type SignalOptions as a, type SignalSetter as b, createSignal as c };
+export { type SignalGetter as S, type SignalOptions as a, type SignalSetter as b, createSignal as c, getSignalName as g, value as v };

package/dist/storage.cjs

@@ -26,7 +26,10 @@ function createLocalStorage(key, options) {
       }
     },
     remove() {
-      localStorage.removeItem(key);
+      try {
+        localStorage.removeItem(key);
+      } catch {
+      }
     }
   };
 }
@@ -57,37 +60,70 @@ function createSessionStorage(key, options) {
       }
     },
     remove() {
-      sessionStorage.removeItem(key);
+      try {
+        sessionStorage.removeItem(key);
+      } catch {
+      }
     }
   };
 }
 
 // src/storage/indexed.ts
 var dbCache = /* @__PURE__ */ new Map();
+var openLocks = /* @__PURE__ */ new Map();
 function openDB(dbName, storeName) {
   const cacheKey = `${dbName}::${storeName}`;
   const cached = dbCache.get(cacheKey);
   if (cached) return cached;
-  const promise = new Promise((resolve, reject) => {
+  const prevLock = openLocks.get(dbName) ?? Promise.resolve();
+  const promise = prevLock.then(() => doOpen(dbName, storeName, cacheKey), () => doOpen(dbName, storeName, cacheKey));
+  dbCache.set(cacheKey, promise);
+  openLocks.set(dbName, promise.then(() => void 0, () => void 0));
+  promise.catch(() => {
+    dbCache.delete(cacheKey);
+  });
+  return promise;
+}
+function doOpen(dbName, storeName, cacheKey) {
+  return new Promise((resolve, reject) => {
+    const wire = (db) => {
+      db.onversionchange = () => {
+        db.close();
+        dbCache.delete(cacheKey);
+      };
+      db.onclose = () => {
+        dbCache.delete(cacheKey);
+      };
+      resolve(db);
+    };
     const probe = indexedDB.open(dbName);
     probe.onerror = () => reject(probe.error);
     probe.onsuccess = () => {
       const db = probe.result;
       if (db.objectStoreNames.contains(storeName)) {
-        resolve(db);
+        wire(db);
         return;
       }
       const nextVersion = db.version + 1;
       db.close();
       const upgrade = indexedDB.open(dbName, nextVersion);
       upgrade.onerror = () => reject(upgrade.error);
+      upgrade.onblocked = () => reject(upgrade.error ?? new DOMException("Upgrade blocked: another connection is open", "AbortError"));
       upgrade.onupgradeneeded = () => {
         const upgradedDB = upgrade.result;
         if (!upgradedDB.objectStoreNames.contains(storeName)) {
           upgradedDB.createObjectStore(storeName);
         }
       };
-      upgrade.onsuccess = () => resolve(upgrade.result);
+      upgrade.onsuccess = () => {
+        const upgradedDB = upgrade.result;
+        if (!upgradedDB.objectStoreNames.contains(storeName)) {
+          upgradedDB.close();
+          reject(new DOMException(`Object store "${storeName}" was not created`, "NotFoundError"));
+          return;
+        }
+        wire(upgradedDB);
+      };
     };
     probe.onupgradeneeded = () => {
       const db = probe.result;
@@ -96,23 +132,37 @@ function openDB(dbName, storeName) {
       }
     };
   });
-  dbCache.set(cacheKey, promise);
-  promise.catch(() => {
-    dbCache.delete(cacheKey);
-  });
-  return promise;
 }
 function createIndexedDB(dbName, storeName = "default") {
+  const cacheKey = `${dbName}::${storeName}`;
   function withStore(mode, fn) {
     return openDB(dbName, storeName).then(
       (db) => new Promise((resolve, reject) => {
-        const tx = db.transaction(storeName, mode);
-        const store = tx.objectStore(storeName);
-        const request = fn(store);
-        request.onsuccess = () => resolve(request.result);
-        request.onerror = () => reject(request.error);
+        let request;
+        let tx;
+        try {
+          tx = db.transaction(storeName, mode);
+          request = fn(tx.objectStore(storeName));
+        } catch (err) {
+          reject(err);
+          return;
+        }
+        let result;
+        request.onsuccess = () => {
+          result = request.result;
+          if (mode === "readonly") resolve(result);
+        };
+        tx.oncomplete = () => resolve(result);
+        tx.onerror = () => reject(tx.error ?? request.error);
+        tx.onabort = () => reject(tx.error ?? request.error ?? new DOMException("Transaction aborted", "AbortError"));
       })
-    );
+    ).catch((err) => {
+      const name = err?.name;
+      if (name === "InvalidStateError" || name === "AbortError" || name === "NotFoundError") {
+        dbCache.delete(cacheKey);
+      }
+      throw err;
+    });
   }
   return {
     get(key) {

package/dist/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage/local.ts","../src/storage/session.ts","../src/storage/indexed.ts"],"names":[],"mappings":"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","file":"storage.cjs","sourcesContent":["/**\n * Forma Storage - Local\n *\n * Typed localStorage wrapper with graceful error handling.\n * Zero dependencies — native browser APIs only.\n */\n\nimport { TypedStorage, StorageOptions } from './types.js';\n\n/**\n * Create a typed localStorage wrapper for the given key.\n *\n * ```ts\n * const store = createLocalStorage<{ name: string }>('user');\n * store.set({ name: 'Alice' });\n * store.get(); // { name: 'Alice' }\n * store.remove();\n * ```\n */\nexport function createLocalStorage<T>(\n  key: string,\n  options?: StorageOptions<T>,\n): TypedStorage<T> {\n  const serialize = options?.serialize ?? JSON.stringify;\n  const deserialize = options?.deserialize ?? JSON.parse;\n  const validate = options?.validate;\n\n  return {\n    key,\n\n    get(): T | null {\n      try {\n        const raw = localStorage.getItem(key);\n        if (raw === null) return null;\n        const value = deserialize(raw);\n        if (validate && !validate(value)) return null;\n        return value as T;\n      } catch {\n        return null;\n      }\n    },\n\n    set(value: T): void {\n      try {\n        const serialized = serialize(value);\n        localStorage.setItem(key, serialized);\n      } catch { /* QuotaExceededError or storage disabled — silently ignore */ }\n    },\n\n    remove(): void {\n      localStorage.removeItem(key);\n    },\n  };\n}\n","/**\n * Forma Storage - Session\n *\n * Typed sessionStorage wrapper with graceful error handling.\n * Zero dependencies — native browser APIs only.\n */\n\nimport { TypedStorage, StorageOptions } from './types.js';\n\n/**\n * Create a typed sessionStorage wrapper for the given key.\n *\n * ```ts\n * const store = createSessionStorage<{ token: string }>('auth');\n * store.set({ token: 'abc123' });\n * store.get(); // { token: 'abc123' }\n * store.remove();\n * ```\n */\nexport function createSessionStorage<T>(\n  key: string,\n  options?: StorageOptions<T>,\n): TypedStorage<T> {\n  const serialize = options?.serialize ?? JSON.stringify;\n  const deserialize = options?.deserialize ?? JSON.parse;\n  const validate = options?.validate;\n\n  return {\n    key,\n\n    get(): T | null {\n      try {\n        const raw = sessionStorage.getItem(key);\n        if (raw === null) return null;\n        const value = deserialize(raw);\n        if (validate && !validate(value)) return null;\n        return value as T;\n      } catch {\n        return null;\n      }\n    },\n\n    set(value: T): void {\n      try {\n        const serialized = serialize(value);\n        sessionStorage.setItem(key, serialized);\n      } catch { /* QuotaExceededError or storage disabled — silently ignore */ }\n    },\n\n    remove(): void {\n      sessionStorage.removeItem(key);\n    },\n  };\n}\n","/**\n * Forma Storage - IndexedDB\n *\n * Simplified IndexedDB wrapper with lazy connection and promise-based API.\n * Zero dependencies — native browser APIs only.\n */\n\nexport interface IDBStore<T> {\n  get(key: string): Promise<T | undefined>;\n  set(key: string, value: T): Promise<void>;\n  delete(key: string): Promise<void>;\n  getAll(): Promise<T[]>;\n  keys(): Promise<string[]>;\n  clear(): Promise<void>;\n}\n\n/** Cached database connections keyed by \"dbName::storeName\". */\nconst dbCache = new Map<string, Promise<IDBDatabase>>();\n\n/**\n * Open (or retrieve a cached) IndexedDB database, ensuring the\n * requested object store exists.\n */\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  const cacheKey = `${dbName}::${storeName}`;\n  const cached = dbCache.get(cacheKey);\n  if (cached) return cached;\n\n  const promise = new Promise<IDBDatabase>((resolve, reject) => {\n    // First, try opening at the current (or default) version.\n    const probe = indexedDB.open(dbName);\n\n    probe.onerror = () => reject(probe.error);\n\n    probe.onsuccess = () => {\n      const db = probe.result;\n      if (db.objectStoreNames.contains(storeName)) {\n        resolve(db);\n        return;\n      }\n      // Store doesn't exist yet — close and reopen with a version bump.\n      const nextVersion = db.version + 1;\n      db.close();\n\n      const upgrade = indexedDB.open(dbName, nextVersion);\n      upgrade.onerror = () => reject(upgrade.error);\n      upgrade.onupgradeneeded = () => {\n        const upgradedDB = upgrade.result;\n        if (!upgradedDB.objectStoreNames.contains(storeName)) {\n          upgradedDB.createObjectStore(storeName);\n        }\n      };\n      upgrade.onsuccess = () => resolve(upgrade.result);\n    };\n\n    probe.onupgradeneeded = () => {\n      const db = probe.result;\n      if (!db.objectStoreNames.contains(storeName)) {\n        db.createObjectStore(storeName);\n      }\n    };\n  });\n\n  dbCache.set(cacheKey, promise);\n\n  // If the open fails, remove from cache so the next call retries.\n  promise.catch(() => {\n    dbCache.delete(cacheKey);\n  });\n\n  return promise;\n}\n\n/**\n * Create a simplified IndexedDB store.\n *\n * ```ts\n * const store = createIndexedDB<User>('myApp', 'users');\n * await store.set('u1', { name: 'Alice' });\n * const user = await store.get('u1'); // { name: 'Alice' }\n * ```\n */\nexport function createIndexedDB<T>(\n  dbName: string,\n  storeName: string = 'default',\n): IDBStore<T> {\n  /** Helper: run a single read/write transaction and return the request result. */\n  function withStore<R>(\n    mode: IDBTransactionMode,\n    fn: (store: IDBObjectStore) => IDBRequest<R>,\n  ): Promise<R> {\n    return openDB(dbName, storeName).then(\n      (db) =>\n        new Promise<R>((resolve, reject) => {\n          const tx = db.transaction(storeName, mode);\n          const store = tx.objectStore(storeName);\n          const request = fn(store);\n          request.onsuccess = () => resolve(request.result);\n          request.onerror = () => reject(request.error);\n        }),\n    );\n  }\n\n  return {\n    get(key: string): Promise<T | undefined> {\n      return withStore('readonly', (store) => store.get(key)) as Promise<T | undefined>;\n    },\n\n    set(key: string, value: T): Promise<void> {\n      return withStore('readwrite', (store) => store.put(value, key)).then(\n        () => undefined,\n      );\n    },\n\n    delete(key: string): Promise<void> {\n      return withStore('readwrite', (store) => store.delete(key)).then(\n        () => undefined,\n      );\n    },\n\n    getAll(): Promise<T[]> {\n      return withStore('readonly', (store) => store.getAll()) as Promise<T[]>;\n    },\n\n    keys(): Promise<string[]> {\n      return withStore('readonly', (store) => store.getAllKeys()).then(\n        (keys) => keys.map(String),\n      );\n    },\n\n    clear(): Promise<void> {\n      return withStore('readwrite', (store) => store.clear()).then(\n        () => undefined,\n      );\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../src/storage/local.ts","../src/storage/session.ts","../src/storage/indexed.ts"],"names":[],"mappings":"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","file":"storage.cjs","sourcesContent":["/**\n * Forma Storage - Local\n *\n * Typed localStorage wrapper with graceful error handling.\n * Zero dependencies — native browser APIs only.\n */\n\nimport { TypedStorage, StorageOptions } from './types.js';\n\n/**\n * Create a typed localStorage wrapper for the given key.\n *\n * ```ts\n * const store = createLocalStorage<{ name: string }>('user');\n * store.set({ name: 'Alice' });\n * store.get(); // { name: 'Alice' }\n * store.remove();\n * ```\n */\nexport function createLocalStorage<T>(\n  key: string,\n  options?: StorageOptions<T>,\n): TypedStorage<T> {\n  const serialize = options?.serialize ?? JSON.stringify;\n  const deserialize = options?.deserialize ?? JSON.parse;\n  const validate = options?.validate;\n\n  return {\n    key,\n\n    get(): T | null {\n      try {\n        const raw = localStorage.getItem(key);\n        if (raw === null) return null;\n        const value = deserialize(raw);\n        if (validate && !validate(value)) return null;\n        return value as T;\n      } catch {\n        return null;\n      }\n    },\n\n    set(value: T): void {\n      try {\n        const serialized = serialize(value);\n        localStorage.setItem(key, serialized);\n      } catch { /* QuotaExceededError or storage disabled — silently ignore */ }\n    },\n\n    remove(): void {\n      try {\n        localStorage.removeItem(key);\n      } catch { /* storage disabled — silently ignore, matching get/set */ }\n    },\n  };\n}\n","/**\n * Forma Storage - Session\n *\n * Typed sessionStorage wrapper with graceful error handling.\n * Zero dependencies — native browser APIs only.\n */\n\nimport { TypedStorage, StorageOptions } from './types.js';\n\n/**\n * Create a typed sessionStorage wrapper for the given key.\n *\n * ```ts\n * const store = createSessionStorage<{ token: string }>('auth');\n * store.set({ token: 'abc123' });\n * store.get(); // { token: 'abc123' }\n * store.remove();\n * ```\n */\nexport function createSessionStorage<T>(\n  key: string,\n  options?: StorageOptions<T>,\n): TypedStorage<T> {\n  const serialize = options?.serialize ?? JSON.stringify;\n  const deserialize = options?.deserialize ?? JSON.parse;\n  const validate = options?.validate;\n\n  return {\n    key,\n\n    get(): T | null {\n      try {\n        const raw = sessionStorage.getItem(key);\n        if (raw === null) return null;\n        const value = deserialize(raw);\n        if (validate && !validate(value)) return null;\n        return value as T;\n      } catch {\n        return null;\n      }\n    },\n\n    set(value: T): void {\n      try {\n        const serialized = serialize(value);\n        sessionStorage.setItem(key, serialized);\n      } catch { /* QuotaExceededError or storage disabled — silently ignore */ }\n    },\n\n    remove(): void {\n      try {\n        sessionStorage.removeItem(key);\n      } catch { /* storage disabled — silently ignore, matching get/set */ }\n    },\n  };\n}\n","/**\n * Forma Storage - IndexedDB\n *\n * Simplified IndexedDB wrapper with lazy connection and promise-based API.\n * Zero dependencies — native browser APIs only.\n */\n\nexport interface IDBStore<T> {\n  get(key: string): Promise<T | undefined>;\n  set(key: string, value: T): Promise<void>;\n  delete(key: string): Promise<void>;\n  getAll(): Promise<T[]>;\n  keys(): Promise<string[]>;\n  clear(): Promise<void>;\n}\n\n/** Cached database connections keyed by \"dbName::storeName\". */\nconst dbCache = new Map<string, Promise<IDBDatabase>>();\n\n/**\n * Per-database open serialization. Concurrent createIndexedDB(db, storeA/B/...)\n * calls each bump db.version+1; without serialization they compute the version\n * from a stale probe and race, so some stores are never created and their\n * connections are permanently wedged. Chaining opens for the same db name makes\n * each see the previous open's committed version.\n */\nconst openLocks = new Map<string, Promise<unknown>>();\n\n/**\n * Open (or retrieve a cached) IndexedDB database, ensuring the\n * requested object store exists.\n */\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  const cacheKey = `${dbName}::${storeName}`;\n  const cached = dbCache.get(cacheKey);\n  if (cached) return cached;\n\n  // Serialize this open behind any in-flight open for the same db name.\n  const prevLock = openLocks.get(dbName) ?? Promise.resolve();\n  const promise = prevLock.then(() => doOpen(dbName, storeName, cacheKey), () => doOpen(dbName, storeName, cacheKey));\n\n  dbCache.set(cacheKey, promise);\n  // Advance the lock (never rejects, so the chain keeps flowing).\n  openLocks.set(dbName, promise.then(() => undefined, () => undefined));\n\n  // If the open fails, remove from cache so the next call retries.\n  promise.catch(() => {\n    dbCache.delete(cacheKey);\n  });\n\n  return promise;\n}\n\nfunction doOpen(dbName: string, storeName: string, cacheKey: string): Promise<IDBDatabase> {\n  return new Promise<IDBDatabase>((resolve, reject) => {\n    // Wire a resolved connection so it closes + evicts on a version change\n    // (another tab/store bumping the version) or a forced close. Without this a\n    // later bump blocks forever and a stale connection is never dropped.\n    const wire = (db: IDBDatabase) => {\n      db.onversionchange = () => { db.close(); dbCache.delete(cacheKey); };\n      db.onclose = () => { dbCache.delete(cacheKey); };\n      resolve(db);\n    };\n\n    // First, try opening at the current (or default) version.\n    const probe = indexedDB.open(dbName);\n\n    probe.onerror = () => reject(probe.error);\n\n    probe.onsuccess = () => {\n      const db = probe.result;\n      if (db.objectStoreNames.contains(storeName)) {\n        wire(db);\n        return;\n      }\n      // Store doesn't exist yet — close and reopen with a version bump. Opens\n      // are serialized per db, so this version is current, not stale.\n      const nextVersion = db.version + 1;\n      db.close();\n\n      const upgrade = indexedDB.open(dbName, nextVersion);\n      upgrade.onerror = () => reject(upgrade.error);\n      // Backstop: if another connection blocks the bump, settle (reject) so the\n      // promise does not leak; the next call retries.\n      upgrade.onblocked = () =>\n        reject(upgrade.error ?? new DOMException('Upgrade blocked: another connection is open', 'AbortError'));\n      upgrade.onupgradeneeded = () => {\n        const upgradedDB = upgrade.result;\n        if (!upgradedDB.objectStoreNames.contains(storeName)) {\n          upgradedDB.createObjectStore(storeName);\n        }\n      };\n      upgrade.onsuccess = () => {\n        const upgradedDB = upgrade.result;\n        if (!upgradedDB.objectStoreNames.contains(storeName)) {\n          // Should not happen with serialized opens; reject (do not cache a\n          // store-less connection) so the next call retries cleanly.\n          upgradedDB.close();\n          reject(new DOMException(`Object store \"${storeName}\" was not created`, 'NotFoundError'));\n          return;\n        }\n        wire(upgradedDB);\n      };\n    };\n\n    probe.onupgradeneeded = () => {\n      const db = probe.result;\n      if (!db.objectStoreNames.contains(storeName)) {\n        db.createObjectStore(storeName);\n      }\n    };\n  });\n}\n\n/**\n * Create a simplified IndexedDB store.\n *\n * ```ts\n * const store = createIndexedDB<User>('myApp', 'users');\n * await store.set('u1', { name: 'Alice' });\n * const user = await store.get('u1'); // { name: 'Alice' }\n * ```\n */\nexport function createIndexedDB<T>(\n  dbName: string,\n  storeName: string = 'default',\n): IDBStore<T> {\n  const cacheKey = `${dbName}::${storeName}`;\n\n  /** Helper: run a single read/write transaction and return the request result. */\n  function withStore<R>(\n    mode: IDBTransactionMode,\n    fn: (store: IDBObjectStore) => IDBRequest<R>,\n  ): Promise<R> {\n    return openDB(dbName, storeName).then(\n      (db) =>\n        new Promise<R>((resolve, reject) => {\n          let request: IDBRequest<R>;\n          let tx: IDBTransaction;\n          try {\n            tx = db.transaction(storeName, mode);\n            request = fn(tx.objectStore(storeName));\n          } catch (err) {\n            // A transaction on a closing connection throws synchronously.\n            reject(err);\n            return;\n          }\n          let result: R;\n          request.onsuccess = () => {\n            result = request.result;\n            // Reads are durable at request success; writes only at commit.\n            if (mode === 'readonly') resolve(result);\n          };\n          // A readwrite value is only durable once the transaction COMMITS —\n          // resolving on request.onsuccess would falsely report success for a\n          // write that later aborts (e.g. QuotaExceededError at commit).\n          tx.oncomplete = () => resolve(result);\n          tx.onerror = () => reject(tx.error ?? request.error);\n          tx.onabort = () => reject(tx.error ?? request.error ?? new DOMException('Transaction aborted', 'AbortError'));\n        }),\n    ).catch((err: unknown) => {\n      // Evict a broken/closing/store-less connection so the next call reopens\n      // cleanly (NotFoundError = the cached connection lacks the store).\n      const name = (err as { name?: string } | null)?.name;\n      if (name === 'InvalidStateError' || name === 'AbortError' || name === 'NotFoundError') {\n        dbCache.delete(cacheKey);\n      }\n      throw err;\n    });\n  }\n\n  return {\n    get(key: string): Promise<T | undefined> {\n      return withStore('readonly', (store) => store.get(key)) as Promise<T | undefined>;\n    },\n\n    set(key: string, value: T): Promise<void> {\n      return withStore('readwrite', (store) => store.put(value, key)).then(\n        () => undefined,\n      );\n    },\n\n    delete(key: string): Promise<void> {\n      return withStore('readwrite', (store) => store.delete(key)).then(\n        () => undefined,\n      );\n    },\n\n    getAll(): Promise<T[]> {\n      return withStore('readonly', (store) => store.getAll()) as Promise<T[]>;\n    },\n\n    keys(): Promise<string[]> {\n      return withStore('readonly', (store) => store.getAllKeys()).then(\n        (keys) => keys.map(String),\n      );\n    },\n\n    clear(): Promise<void> {\n      return withStore('readwrite', (store) => store.clear()).then(\n        () => undefined,\n      );\n    },\n  };\n}\n"]}