@getforma/core 0.9.1 → 1.0.1

package/dist/storage.js

@@ -0,0 +1,147 @@
+// src/storage/local.ts
+function createLocalStorage(key, options) {
+  const serialize = options?.serialize ?? JSON.stringify;
+  const deserialize = options?.deserialize ?? JSON.parse;
+  const validate = options?.validate;
+  return {
+    key,
+    get() {
+      try {
+        const raw = localStorage.getItem(key);
+        if (raw === null) return null;
+        const value = deserialize(raw);
+        if (validate && !validate(value)) return null;
+        return value;
+      } catch {
+        return null;
+      }
+    },
+    set(value) {
+      try {
+        const serialized = serialize(value);
+        localStorage.setItem(key, serialized);
+      } catch {
+      }
+    },
+    remove() {
+      localStorage.removeItem(key);
+    }
+  };
+}
+
+// src/storage/session.ts
+function createSessionStorage(key, options) {
+  const serialize = options?.serialize ?? JSON.stringify;
+  const deserialize = options?.deserialize ?? JSON.parse;
+  const validate = options?.validate;
+  return {
+    key,
+    get() {
+      try {
+        const raw = sessionStorage.getItem(key);
+        if (raw === null) return null;
+        const value = deserialize(raw);
+        if (validate && !validate(value)) return null;
+        return value;
+      } catch {
+        return null;
+      }
+    },
+    set(value) {
+      try {
+        const serialized = serialize(value);
+        sessionStorage.setItem(key, serialized);
+      } catch {
+      }
+    },
+    remove() {
+      sessionStorage.removeItem(key);
+    }
+  };
+}
+
+// src/storage/indexed.ts
+var dbCache = /* @__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 probe = indexedDB.open(dbName);
+    probe.onerror = () => reject(probe.error);
+    probe.onsuccess = () => {
+      const db = probe.result;
+      if (db.objectStoreNames.contains(storeName)) {
+        resolve(db);
+        return;
+      }
+      const nextVersion = db.version + 1;
+      db.close();
+      const upgrade = indexedDB.open(dbName, nextVersion);
+      upgrade.onerror = () => reject(upgrade.error);
+      upgrade.onupgradeneeded = () => {
+        const upgradedDB = upgrade.result;
+        if (!upgradedDB.objectStoreNames.contains(storeName)) {
+          upgradedDB.createObjectStore(storeName);
+        }
+      };
+      upgrade.onsuccess = () => resolve(upgrade.result);
+    };
+    probe.onupgradeneeded = () => {
+      const db = probe.result;
+      if (!db.objectStoreNames.contains(storeName)) {
+        db.createObjectStore(storeName);
+      }
+    };
+  });
+  dbCache.set(cacheKey, promise);
+  promise.catch(() => {
+    dbCache.delete(cacheKey);
+  });
+  return promise;
+}
+function createIndexedDB(dbName, storeName = "default") {
+  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);
+      })
+    );
+  }
+  return {
+    get(key) {
+      return withStore("readonly", (store) => store.get(key));
+    },
+    set(key, value) {
+      return withStore("readwrite", (store) => store.put(value, key)).then(
+        () => void 0
+      );
+    },
+    delete(key) {
+      return withStore("readwrite", (store) => store.delete(key)).then(
+        () => void 0
+      );
+    },
+    getAll() {
+      return withStore("readonly", (store) => store.getAll());
+    },
+    keys() {
+      return withStore("readonly", (store) => store.getAllKeys()).then(
+        (keys) => keys.map(String)
+      );
+    },
+    clear() {
+      return withStore("readwrite", (store) => store.clear()).then(
+        () => void 0
+      );
+    }
+  };
+}
+
+export { createIndexedDB, createLocalStorage, createSessionStorage };
+//# sourceMappingURL=storage.js.map
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/local.ts","../src/storage/session.ts","../src/storage/indexed.ts"],"names":[],"mappings":";AAmBO,SAAS,kBAAA,CACd,KACA,OAAA,EACiB;AACjB,EAAA,MAAM,SAAA,GAAY,OAAA,EAAS,SAAA,IAAa,IAAA,CAAK,SAAA;AAC7C,EAAA,MAAM,WAAA,GAAc,OAAA,EAAS,WAAA,IAAe,IAAA,CAAK,KAAA;AACjD,EAAA,MAAM,WAAW,OAAA,EAAS,QAAA;AAE1B,EAAA,OAAO;AAAA,IACL,GAAA;AAAA,IAEA,GAAA,GAAgB;AACd,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,YAAA,CAAa,OAAA,CAAQ,GAAG,CAAA;AACpC,QAAA,IAAI,GAAA,KAAQ,MAAM,OAAO,IAAA;AACzB,QAAA,MAAM,KAAA,GAAQ,YAAY,GAAG,CAAA;AAC7B,QAAA,IAAI,QAAA,IAAY,CAAC,QAAA,CAAS,KAAK,GAAG,OAAO,IAAA;AACzC,QAAA,OAAO,KAAA;AAAA,MACT,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,IAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,IAAI,KAAA,EAAgB;AAClB,MAAA,IAAI;AACF,QAAA,MAAM,UAAA,GAAa,UAAU,KAAK,CAAA;AAClC,QAAA,YAAA,CAAa,OAAA,CAAQ,KAAK,UAAU,CAAA;AAAA,MACtC,CAAA,CAAA,MAAQ;AAAA,MAAiE;AAAA,IAC3E,CAAA;AAAA,IAEA,MAAA,GAAe;AACb,MAAA,YAAA,CAAa,WAAW,GAAG,CAAA;AAAA,IAC7B;AAAA,GACF;AACF;;;AClCO,SAAS,oBAAA,CACd,KACA,OAAA,EACiB;AACjB,EAAA,MAAM,SAAA,GAAY,OAAA,EAAS,SAAA,IAAa,IAAA,CAAK,SAAA;AAC7C,EAAA,MAAM,WAAA,GAAc,OAAA,EAAS,WAAA,IAAe,IAAA,CAAK,KAAA;AACjD,EAAA,MAAM,WAAW,OAAA,EAAS,QAAA;AAE1B,EAAA,OAAO;AAAA,IACL,GAAA;AAAA,IAEA,GAAA,GAAgB;AACd,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,cAAA,CAAe,OAAA,CAAQ,GAAG,CAAA;AACtC,QAAA,IAAI,GAAA,KAAQ,MAAM,OAAO,IAAA;AACzB,QAAA,MAAM,KAAA,GAAQ,YAAY,GAAG,CAAA;AAC7B,QAAA,IAAI,QAAA,IAAY,CAAC,QAAA,CAAS,KAAK,GAAG,OAAO,IAAA;AACzC,QAAA,OAAO,KAAA;AAAA,MACT,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,IAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,IAAI,KAAA,EAAgB;AAClB,MAAA,IAAI;AACF,QAAA,MAAM,UAAA,GAAa,UAAU,KAAK,CAAA;AAClC,QAAA,cAAA,CAAe,OAAA,CAAQ,KAAK,UAAU,CAAA;AAAA,MACxC,CAAA,CAAA,MAAQ;AAAA,MAAiE;AAAA,IAC3E,CAAA;AAAA,IAEA,MAAA,GAAe;AACb,MAAA,cAAA,CAAe,WAAW,GAAG,CAAA;AAAA,IAC/B;AAAA,GACF;AACF;;;ACpCA,IAAM,OAAA,uBAAc,GAAA,EAAkC;AAMtD,SAAS,MAAA,CAAO,QAAgB,SAAA,EAAyC;AACvE,EAAA,MAAM,QAAA,GAAW,CAAA,EAAG,MAAM,CAAA,EAAA,EAAK,SAAS,CAAA,CAAA;AACxC,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,QAAQ,CAAA;AACnC,EAAA,IAAI,QAAQ,OAAO,MAAA;AAEnB,EAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAqB,CAAC,SAAS,MAAA,KAAW;AAE5D,IAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,IAAA,CAAK,MAAM,CAAA;AAEnC,IAAA,KAAA,CAAM,OAAA,GAAU,MAAM,MAAA,CAAO,KAAA,CAAM,KAAK,CAAA;AAExC,IAAA,KAAA,CAAM,YAAY,MAAM;AACtB,MAAA,MAAM,KAAK,KAAA,CAAM,MAAA;AACjB,MAAA,IAAI,EAAA,CAAG,gBAAA,CAAiB,QAAA,CAAS,SAAS,CAAA,EAAG;AAC3C,QAAA,OAAA,CAAQ,EAAE,CAAA;AACV,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,WAAA,GAAc,GAAG,OAAA,GAAU,CAAA;AACjC,MAAA,EAAA,CAAG,KAAA,EAAM;AAET,MAAA,MAAM,OAAA,GAAU,SAAA,CAAU,IAAA,CAAK,MAAA,EAAQ,WAAW,CAAA;AAClD,MAAA,OAAA,CAAQ,OAAA,GAAU,MAAM,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA;AAC5C,MAAA,OAAA,CAAQ,kBAAkB,MAAM;AAC9B,QAAA,MAAM,aAAa,OAAA,CAAQ,MAAA;AAC3B,QAAA,IAAI,CAAC,UAAA,CAAW,gBAAA,CAAiB,QAAA,CAAS,SAAS,CAAA,EAAG;AACpD,UAAA,UAAA,CAAW,kBAAkB,SAAS,CAAA;AAAA,QACxC;AAAA,MACF,CAAA;AACA,MAAA,OAAA,CAAQ,SAAA,GAAY,MAAM,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA;AAAA,IAClD,CAAA;AAEA,IAAA,KAAA,CAAM,kBAAkB,MAAM;AAC5B,MAAA,MAAM,KAAK,KAAA,CAAM,MAAA;AACjB,MAAA,IAAI,CAAC,EAAA,CAAG,gBAAA,CAAiB,QAAA,CAAS,SAAS,CAAA,EAAG;AAC5C,QAAA,EAAA,CAAG,kBAAkB,SAAS,CAAA;AAAA,MAChC;AAAA,IACF,CAAA;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAA,CAAQ,GAAA,CAAI,UAAU,OAAO,CAAA;AAG7B,EAAA,OAAA,CAAQ,MAAM,MAAM;AAClB,IAAA,OAAA,CAAQ,OAAO,QAAQ,CAAA;AAAA,EACzB,CAAC,CAAA;AAED,EAAA,OAAO,OAAA;AACT;AAWO,SAAS,eAAA,CACd,MAAA,EACA,SAAA,GAAoB,SAAA,EACP;AAEb,EAAA,SAAS,SAAA,CACP,MACA,EAAA,EACY;AACZ,IAAA,OAAO,MAAA,CAAO,MAAA,EAAQ,SAAS,CAAA,CAAE,IAAA;AAAA,MAC/B,CAAC,EAAA,KACC,IAAI,OAAA,CAAW,CAAC,SAAS,MAAA,KAAW;AAClC,QAAA,MAAM,EAAA,GAAK,EAAA,CAAG,WAAA,CAAY,SAAA,EAAW,IAAI,CAAA;AACzC,QAAA,MAAM,KAAA,GAAQ,EAAA,CAAG,WAAA,CAAY,SAAS,CAAA;AACtC,QAAA,MAAM,OAAA,GAAU,GAAG,KAAK,CAAA;AACxB,QAAA,OAAA,CAAQ,SAAA,GAAY,MAAM,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA;AAChD,QAAA,OAAA,CAAQ,OAAA,GAAU,MAAM,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA;AAAA,MAC9C,CAAC;AAAA,KACL;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,IAAI,GAAA,EAAqC;AACvC,MAAA,OAAO,UAAU,UAAA,EAAY,CAAC,UAAU,KAAA,CAAM,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,IACxD,CAAA;AAAA,IAEA,GAAA,CAAI,KAAa,KAAA,EAAyB;AACxC,MAAA,OAAO,SAAA,CAAU,aAAa,CAAC,KAAA,KAAU,MAAM,GAAA,CAAI,KAAA,EAAO,GAAG,CAAC,CAAA,CAAE,IAAA;AAAA,QAC9D,MAAM;AAAA,OACR;AAAA,IACF,CAAA;AAAA,IAEA,OAAO,GAAA,EAA4B;AACjC,MAAA,OAAO,SAAA,CAAU,aAAa,CAAC,KAAA,KAAU,MAAM,MAAA,CAAO,GAAG,CAAC,CAAA,CAAE,IAAA;AAAA,QAC1D,MAAM;AAAA,OACR;AAAA,IACF,CAAA;AAAA,IAEA,MAAA,GAAuB;AACrB,MAAA,OAAO,UAAU,UAAA,EAAY,CAAC,KAAA,KAAU,KAAA,CAAM,QAAQ,CAAA;AAAA,IACxD,CAAA;AAAA,IAEA,IAAA,GAA0B;AACxB,MAAA,OAAO,UAAU,UAAA,EAAY,CAAC,UAAU,KAAA,CAAM,UAAA,EAAY,CAAA,CAAE,IAAA;AAAA,QAC1D,CAAC,IAAA,KAAS,IAAA,CAAK,GAAA,CAAI,MAAM;AAAA,OAC3B;AAAA,IACF,CAAA;AAAA,IAEA,KAAA,GAAuB;AACrB,MAAA,OAAO,UAAU,WAAA,EAAa,CAAC,UAAU,KAAA,CAAM,KAAA,EAAO,CAAA,CAAE,IAAA;AAAA,QACtD,MAAM;AAAA,OACR;AAAA,IACF;AAAA,GACF;AACF","file":"storage.js","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"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@getforma/core",
   "author": "Forma <victor@getforma.dev>",
-  "version": "0.9.1",
+  "version": "1.0.1",
   "description": "Real DOM reactive library — fine-grained signals, islands architecture, SSR hydration. No virtual DOM, no diffing. ~15KB gzipped.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -73,6 +73,36 @@
         "types": "./dist/ssr/index.d.cts",
         "default": "./dist/ssr/index.cjs"
       }
+    },
+    "./http": {
+      "import": {
+        "types": "./dist/http.d.ts",
+        "default": "./dist/http.js"
+      },
+      "require": {
+        "types": "./dist/http.d.cts",
+        "default": "./dist/http.cjs"
+      }
+    },
+    "./storage": {
+      "import": {
+        "types": "./dist/storage.d.ts",
+        "default": "./dist/storage.js"
+      },
+      "require": {
+        "types": "./dist/storage.d.cts",
+        "default": "./dist/storage.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
     }
   },
   "files": [