@choksheak/react-utils 0.2.8 → 0.3.0

package/storage.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { LocalStore } from \"@choksheak/ts-utils/localStore\";\nimport { StorageAdapter } from \"@choksheak/ts-utils/storageAdapter\";\n\n/** List of all available pre-built persistence options. */\nexport type PersistTo = \"localStorage\" | \"indexedDb\";\n\nexport type StoreOptions = {\n  persistTo: PersistTo;\n\n  // Storage key to act as a namespace to store the data.\n  key: string;\n\n  // How long to wait before the value is considered expired.\n  expiryMs?: number;\n};\n\nexport type StorageOptions<T> = {\n  /**\n   * You can either specify the storage adapter directly to use a custom\n   * store, or specify the properties to use the pre-built ones.\n   */\n  store?: StorageAdapter<T> | StoreOptions;\n};\n\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { store } = options ?? {};\n\n  if (!store) {\n    return null;\n  }\n\n  if (\n    \"persistTo\" in store &&\n    typeof store.persistTo === \"string\" &&\n    \"key\" in store &&\n    typeof store.key === \"string\"\n  ) {\n    const expiryMs = store.expiryMs || defaultStoreExpiryMs;\n\n    switch (store.persistTo) {\n      case \"localStorage\": {\n        const adapter = new LocalStore(store.key, {\n          defaultExpiryMs: expiryMs,\n        });\n\n        // Handle SSR.\n        return {\n          set: (key: string, value: T): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            // Also apply the custom expiryMs on every item in this store.\n            adapter.set(key, value);\n          },\n          get: (key: string): T | undefined => {\n            if (typeof window === \"undefined\") return undefined; // handle SSR\n\n            return adapter.get(key);\n          },\n          delete: (key: string): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            adapter.delete(key);\n          },\n          clear: (): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            adapter.clear();\n          },\n        };\n      }\n\n      case \"indexedDb\": {\n        // Use the key prefix as a unique namespace for this store.\n        const keyPrefix = store.key + \":\";\n\n        // Prefix all keys using `keyPrefix` so that we can keep all data in\n        // the same store in the same DB. If we keep the data in different\n        // DB stores, then GC will not be able to clean up abandoned stores.\n        return {\n          set: async (key: string, value: T): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            // Also apply the custom expiryMs on every item in this store.\n            await kvStore.set(keyPrefix + key, value, expiryMs);\n          },\n          get: async (key: string): Promise<T | undefined> => {\n            if (typeof window === \"undefined\") return undefined; // handle SSR\n\n            return await kvStore.get(keyPrefix + key);\n          },\n          delete: async (key: string): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            await kvStore.delete(keyPrefix + key);\n          },\n          clear: async (): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            await kvStore.clear();\n          },\n        };\n      }\n\n      default:\n        store.persistTo satisfies never;\n        throw new Error(`Unknown store.adapter ${store.persistTo}`);\n    }\n  }\n\n  return store as StorageAdapter<T>;\n}\n"],"mappings":"AAAA,OAAS,WAAAA,MAAe,8BACxB,OAAS,cAAAC,MAAkB,iCAwBpB,SAASC,EACdC,EACAC,EAC0B,CAC1B,GAAM,CAAE,MAAAC,CAAM,EAAIF,GAAW,CAAC,EAE9B,GAAI,CAACE,EACH,OAAO,KAGT,GACE,cAAeA,GACf,OAAOA,EAAM,WAAc,UAC3B,QAASA,GACT,OAAOA,EAAM,KAAQ,SACrB,CACA,IAAMC,EAAWD,EAAM,UAAYD,EAEnC,OAAQC,EAAM,UAAW,CACvB,IAAK,eAAgB,CACnB,IAAME,EAAU,IAAIN,EAAWI,EAAM,IAAK,CACxC,gBAAiBC,CACnB,CAAC,EAGD,MAAO,CACL,IAAK,CAACE,EAAaC,IAAmB,CAChC,OAAO,OAAW,KAGtBF,EAAQ,IAAIC,EAAKC,CAAK,CACxB,EACA,IAAMD,GAA+B,CACnC,GAAI,SAAO,OAAW,KAEtB,OAAOD,EAAQ,IAAIC,CAAG,CACxB,EACA,OAASA,GAAsB,CACzB,OAAO,OAAW,KAEtBD,EAAQ,OAAOC,CAAG,CACpB,EACA,MAAO,IAAY,CACb,OAAO,OAAW,KAEtBD,EAAQ,MAAM,CAChB,CACF,CACF,CAEA,IAAK,YAAa,CAEhB,IAAMG,EAAYL,EAAM,IAAM,IAK9B,MAAO,CACL,IAAK,MAAOG,EAAaC,IAA4B,CAC/C,OAAO,OAAW,KAGtB,MAAMT,EAAQ,IAAIU,EAAYF,EAAKC,EAAOH,CAAQ,CACpD,EACA,IAAK,MAAOE,GAAwC,CAClD,GAAI,SAAO,OAAW,KAEtB,OAAO,MAAMR,EAAQ,IAAIU,EAAYF,CAAG,CAC1C,EACA,OAAQ,MAAOA,GAA+B,CACxC,OAAO,OAAW,KAEtB,MAAMR,EAAQ,OAAOU,EAAYF,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5B,OAAO,OAAW,KAEtB,MAAMR,EAAQ,MAAM,CACtB,CACF,CACF,CAEA,QACE,MAAAK,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT","names":["kvStore","LocalStore","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","adapter","key","value","keyPrefix"]}

package/storage.mjs

@@ -0,0 +1,65 @@
+// src/storage.ts
+import { kvStore } from "@choksheak/ts-utils/kvStore";
+import { LocalStore } from "@choksheak/ts-utils/localStore";
+function getStorageAdapter(options, defaultStoreExpiryMs) {
+  const { store } = options ?? {};
+  if (!store) {
+    return null;
+  }
+  if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
+    const expiryMs = store.expiryMs || defaultStoreExpiryMs;
+    switch (store.persistTo) {
+      case "localStorage": {
+        const adapter = new LocalStore(store.key, {
+          defaultExpiryMs: expiryMs
+        });
+        return {
+          set: (key, value) => {
+            if (typeof window === "undefined") return;
+            adapter.set(key, value);
+          },
+          get: (key) => {
+            if (typeof window === "undefined") return void 0;
+            return adapter.get(key);
+          },
+          delete: (key) => {
+            if (typeof window === "undefined") return;
+            adapter.delete(key);
+          },
+          clear: () => {
+            if (typeof window === "undefined") return;
+            adapter.clear();
+          }
+        };
+      }
+      case "indexedDb": {
+        const keyPrefix = store.key + ":";
+        return {
+          set: async (key, value) => {
+            if (typeof window === "undefined") return;
+            await kvStore.set(keyPrefix + key, value, expiryMs);
+          },
+          get: async (key) => {
+            if (typeof window === "undefined") return void 0;
+            return await kvStore.get(keyPrefix + key);
+          },
+          delete: async (key) => {
+            if (typeof window === "undefined") return;
+            await kvStore.delete(keyPrefix + key);
+          },
+          clear: async () => {
+            if (typeof window === "undefined") return;
+            await kvStore.clear();
+          }
+        };
+      }
+      default:
+        store.persistTo;
+        throw new Error(`Unknown store.adapter ${store.persistTo}`);
+    }
+  }
+  return store;
+}
+export {
+  getStorageAdapter
+};

package/{utils/stringify.cjs → stringify.cjs}

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/utils/stringify.ts
+// src/stringify.ts
 var stringify_exports = {};
 __export(stringify_exports, {
   stringifyDeterministicForKeys: () => stringifyDeterministicForKeys

package/stringify.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stringify.ts"],"sourcesContent":["/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,mCAAAE,IAAA,eAAAC,EAAAH,GASO,SAASE,EAA8BE,EAAyB,CACrE,IAAMC,EAAQ,IAAI,IAElB,OAAO,KAAK,UAAUD,EAAQ,CAACE,EAAGC,IAAU,CAC1C,GAAI,OAAOA,GAAU,WACnB,MAAM,IAAI,MAAM,sDAAsD,EAGxE,GAAI,CAACA,GAAS,OAAOA,GAAU,UAAY,MAAM,QAAQA,CAAK,EAC5D,OAAOA,EAGT,GAAIF,EAAM,IAAIE,CAAK,EAEjB,MAAO,aAOT,GAJAF,EAAM,IAAIE,CAAK,EAIXA,IAAUH,EACZ,GAAI,CACF,KAAK,UAAUG,CAAK,CACtB,MAAQ,CACN,MAAO,kBACT,CAGF,OAAO,OAAO,KAAKA,CAAK,EACrB,KAAK,EACL,OACC,CAACC,EAAiCC,KAChCD,EAAOC,CAAG,EAAIF,EAAME,CAAG,EAChBD,GAET,CAAC,CACH,CACJ,CAAC,CACH","names":["stringify_exports","__export","stringifyDeterministicForKeys","__toCommonJS","params","cache","_","value","result","key"]}

package/stringify.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stringify.ts"],"sourcesContent":["/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n"],"mappings":"AASO,SAASA,EAA8BC,EAAyB,CACrE,IAAMC,EAAQ,IAAI,IAElB,OAAO,KAAK,UAAUD,EAAQ,CAACE,EAAGC,IAAU,CAC1C,GAAI,OAAOA,GAAU,WACnB,MAAM,IAAI,MAAM,sDAAsD,EAGxE,GAAI,CAACA,GAAS,OAAOA,GAAU,UAAY,MAAM,QAAQA,CAAK,EAC5D,OAAOA,EAGT,GAAIF,EAAM,IAAIE,CAAK,EAEjB,MAAO,aAOT,GAJAF,EAAM,IAAIE,CAAK,EAIXA,IAAUH,EACZ,GAAI,CACF,KAAK,UAAUG,CAAK,CACtB,MAAQ,CACN,MAAO,kBACT,CAGF,OAAO,OAAO,KAAKA,CAAK,EACrB,KAAK,EACL,OACC,CAACC,EAAiCC,KAChCD,EAAOC,CAAG,EAAIF,EAAME,CAAG,EAChBD,GAET,CAAC,CACH,CACJ,CAAC,CACH","names":["stringifyDeterministicForKeys","params","cache","_","value","result","key"]}

package/{utils/stringify.mjs → stringify.mjs}

@@ -1,4 +1,4 @@
-// src/utils/stringify.ts
+// src/stringify.ts
 function stringifyDeterministicForKeys(params) {
   const cache = /* @__PURE__ */ new Set();
   return JSON.stringify(params, (_, value) => {

package/{utils/useDeepMemo.cjs → useDeepMemo.cjs}

@@ -27,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/utils/useDeepMemo.ts
+// src/useDeepMemo.ts
 var useDeepMemo_exports = {};
 __export(useDeepMemo_exports, {
   useDeepMemo: () => useDeepMemo

package/useDeepMemo.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Provides a stable value for T based on deep equality. The deep equality is
+ * determined by the `isEqual()` function in lodash.
+ */
+declare function useDeepMemo<T>(value: T): T;
+
+export { useDeepMemo };

package/useDeepMemo.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Provides a stable value for T based on deep equality. The deep equality is
+ * determined by the `isEqual()` function in lodash.
+ */
+export declare function useDeepMemo<T>(value: T): T;

package/useDeepMemo.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useDeepMemo.ts"],"sourcesContent":["import isEqual from \"lodash/isEqual\";\nimport { useMemo, useState } from \"react\";\n\n/**\n * Provides a stable value for T based on deep equality. The deep equality is\n * determined by the `isEqual()` function in lodash.\n */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (state === value || isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"0jBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAoB,6BACpBC,EAAkC,iBAM3B,SAASH,EAAeI,EAAa,CAC1C,GAAM,CAACC,EAAOC,CAAQ,KAAI,YAAYF,CAAK,EAE3C,SAAO,WAAQ,IACTC,IAAUD,MAAS,EAAAG,SAAQF,EAAOD,CAAK,EAClCC,GAKTC,EAASF,CAAK,EAEPA,GACN,CAACC,EAAOD,CAAK,CAAC,CACnB","names":["useDeepMemo_exports","__export","useDeepMemo","__toCommonJS","import_isEqual","import_react","value","state","setState","isEqual"]}

package/useDeepMemo.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useDeepMemo.ts"],"sourcesContent":["import isEqual from \"lodash/isEqual\";\nimport { useMemo, useState } from \"react\";\n\n/**\n * Provides a stable value for T based on deep equality. The deep equality is\n * determined by the `isEqual()` function in lodash.\n */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (state === value || isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"AAAA,OAAOA,MAAa,iBACpB,OAAS,WAAAC,EAAS,YAAAC,MAAgB,QAM3B,SAASC,EAAeC,EAAa,CAC1C,GAAM,CAACC,EAAOC,CAAQ,EAAIJ,EAAYE,CAAK,EAE3C,OAAOH,EAAQ,IACTI,IAAUD,GAASJ,EAAQK,EAAOD,CAAK,EAClCC,GAKTC,EAASF,CAAK,EAEPA,GACN,CAACC,EAAOD,CAAK,CAAC,CACnB","names":["isEqual","useMemo","useState","useDeepMemo","value","state","setState"]}

package/{utils/useDeepMemo.mjs → useDeepMemo.mjs}

@@ -1,4 +1,4 @@
-// src/utils/useDeepMemo.ts
+// src/useDeepMemo.ts
 import isEqual from "lodash/isEqual";
 import { useMemo, useState } from "react";
 function useDeepMemo(value) {

package/utils/storage.cjs

@@ -1,162 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/utils/storage.ts
-var storage_exports = {};
-__export(storage_exports, {
-  InMemoryStorageAdapter: () => InMemoryStorageAdapter,
-  IndexedDbAdapter: () => IndexedDbAdapter,
-  LocalStorageAdapter: () => LocalStorageAdapter,
-  getStorageAdapter: () => getStorageAdapter
-});
-module.exports = __toCommonJS(storage_exports);
-var import_kvStore = require("@choksheak/ts-utils/kvStore");
-function getStorageAdapter(options, defaultStoreExpiryMs) {
-  const { localStorageKey, indexedDbKey, storeExpiryMs, store } = options ?? {};
-  if (store) {
-    return store;
-  }
-  const expiryMs = storeExpiryMs || defaultStoreExpiryMs;
-  if (localStorageKey) {
-    return new LocalStorageAdapter(localStorageKey, expiryMs);
-  }
-  if (indexedDbKey) {
-    return new IndexedDbAdapter(indexedDbKey, expiryMs);
-  }
-  return null;
-}
-var InMemoryStorageAdapter = class {
-  constructor(keyPrefix, expiryMs) {
-    this.keyPrefix = keyPrefix;
-    this.expiryMs = expiryMs;
-  }
-  cache = /* @__PURE__ */ new Map();
-  save(key, value) {
-    const fullKey = this.keyPrefix + ":" + key;
-    this.cache.set(fullKey, {
-      value,
-      expiresAt: Date.now() + this.expiryMs
-    });
-  }
-  load(key) {
-    const fullKey = this.keyPrefix + ":" + key;
-    const cached = this.cache.get(fullKey);
-    if (cached && Date.now() < cached.expiresAt) {
-      return cached.value;
-    }
-    return void 0;
-  }
-  delete(key) {
-    const fullKey = this.keyPrefix + ":" + key;
-    this.cache.delete(fullKey);
-  }
-  clear() {
-    this.cache.clear();
-  }
-};
-var LocalStorageAdapter = class {
-  constructor(keyPrefix, expiryMs) {
-    this.keyPrefix = keyPrefix;
-    this.expiryMs = expiryMs;
-  }
-  save(key, value) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    window.localStorage.setItem(
-      fullKey,
-      JSON.stringify({
-        value,
-        expiresAt: this.expiryMs ? Date.now() + this.expiryMs : 0
-      })
-    );
-  }
-  load(key) {
-    if (typeof window === "undefined") return void 0;
-    const fullKey = this.keyPrefix + ":" + key;
-    const raw = window.localStorage.getItem(fullKey);
-    if (!raw) return void 0;
-    try {
-      const box = JSON.parse(raw);
-      if (!box || box.expiresAt && Date.now() >= box.expiresAt) {
-        window.localStorage.removeItem(fullKey);
-        return void 0;
-      }
-      return box.value;
-    } catch {
-      window.localStorage.removeItem(fullKey);
-      return void 0;
-    }
-  }
-  delete(key) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    window.localStorage.removeItem(fullKey);
-  }
-  clear() {
-    if (typeof window === "undefined") return;
-    for (const key of Object.keys(window.localStorage)) {
-      if (key.startsWith(this.keyPrefix)) {
-        window.localStorage.removeItem(key);
-      }
-    }
-  }
-};
-var IndexedDbAdapter = class {
-  constructor(keyPrefix, expiryMs) {
-    this.keyPrefix = keyPrefix;
-    this.expiryMs = expiryMs;
-  }
-  async save(key, value) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    await import_kvStore.kvStore.set(fullKey, JSON.stringify(value), this.expiryMs);
-  }
-  async load(key) {
-    if (typeof window === "undefined") return void 0;
-    const fullKey = this.keyPrefix + ":" + key;
-    const raw = await import_kvStore.kvStore.get(fullKey);
-    if (raw === void 0) return void 0;
-    try {
-      return JSON.parse(raw);
-    } catch {
-      await import_kvStore.kvStore.delete(fullKey);
-      return void 0;
-    }
-  }
-  async delete(key) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    await import_kvStore.kvStore.delete(fullKey);
-  }
-  async clear() {
-    if (typeof window === "undefined") return;
-    await import_kvStore.kvStore.forEach(async (k) => {
-      if (k.startsWith(this.keyPrefix)) {
-        await import_kvStore.kvStore.delete(k);
-      }
-    });
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  InMemoryStorageAdapter,
-  IndexedDbAdapter,
-  LocalStorageAdapter,
-  getStorageAdapter
-});

package/utils/storage.d.mts

@@ -1,46 +0,0 @@
-type StorageAdapter<T> = {
-    save: (key: string, value: T) => Promise<void> | void;
-    load: (key: string) => Promise<T | undefined> | T | undefined;
-    delete: (key: string) => Promise<void> | void;
-    clear: () => Promise<void> | void;
-};
-type StorageOptions<T> = {
-    store?: StorageAdapter<T>;
-    localStorageKey?: string;
-    indexedDbKey?: string;
-    storeExpiryMs?: number;
-};
-declare function getStorageAdapter<T>(options: StorageOptions<T> | undefined, defaultStoreExpiryMs: number): StorageAdapter<T> | null;
-/** Save state to memory only - not persisted. */
-declare class InMemoryStorageAdapter<T> implements StorageAdapter<T> {
-    readonly keyPrefix: string;
-    readonly expiryMs: number;
-    private readonly cache;
-    constructor(keyPrefix: string, expiryMs: number);
-    save(key: string, value: T): void;
-    load(key: string): T | undefined;
-    delete(key: string): void;
-    clear(): void;
-}
-/** Save state to local storage. */
-declare class LocalStorageAdapter<T> implements StorageAdapter<T> {
-    readonly keyPrefix: string;
-    readonly expiryMs: number;
-    constructor(keyPrefix: string, expiryMs: number);
-    save(key: string, value: T): void;
-    load(key: string): T | undefined;
-    delete(key: string): void;
-    clear(): void;
-}
-/** Save state to indexed db. */
-declare class IndexedDbAdapter<T> implements StorageAdapter<T> {
-    readonly keyPrefix: string;
-    readonly expiryMs: number;
-    constructor(keyPrefix: string, expiryMs: number);
-    save(key: string, value: T): Promise<void>;
-    load(key: string): Promise<T | undefined>;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
-}
-
-export { InMemoryStorageAdapter, IndexedDbAdapter, LocalStorageAdapter, type StorageAdapter, type StorageOptions, getStorageAdapter };

package/utils/storage.d.ts

@@ -1,44 +0,0 @@
-export type StorageAdapter<T> = {
-    save: (key: string, value: T) => Promise<void> | void;
-    load: (key: string) => Promise<T | undefined> | T | undefined;
-    delete: (key: string) => Promise<void> | void;
-    clear: () => Promise<void> | void;
-};
-export type StorageOptions<T> = {
-    store?: StorageAdapter<T>;
-    localStorageKey?: string;
-    indexedDbKey?: string;
-    storeExpiryMs?: number;
-};
-export declare function getStorageAdapter<T>(options: StorageOptions<T> | undefined, defaultStoreExpiryMs: number): StorageAdapter<T> | null;
-/** Save state to memory only - not persisted. */
-export declare class InMemoryStorageAdapter<T> implements StorageAdapter<T> {
-    readonly keyPrefix: string;
-    readonly expiryMs: number;
-    private readonly cache;
-    constructor(keyPrefix: string, expiryMs: number);
-    save(key: string, value: T): void;
-    load(key: string): T | undefined;
-    delete(key: string): void;
-    clear(): void;
-}
-/** Save state to local storage. */
-export declare class LocalStorageAdapter<T> implements StorageAdapter<T> {
-    readonly keyPrefix: string;
-    readonly expiryMs: number;
-    constructor(keyPrefix: string, expiryMs: number);
-    save(key: string, value: T): void;
-    load(key: string): T | undefined;
-    delete(key: string): void;
-    clear(): void;
-}
-/** Save state to indexed db. */
-export declare class IndexedDbAdapter<T> implements StorageAdapter<T> {
-    readonly keyPrefix: string;
-    readonly expiryMs: number;
-    constructor(keyPrefix: string, expiryMs: number);
-    save(key: string, value: T): Promise<void>;
-    load(key: string): Promise<T | undefined>;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
-}

package/utils/storage.min.cjs

@@ -1,2 +0,0 @@
-"use strict";var d=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var w=(r,e)=>{for(var i in e)d(r,i,{get:e[i],enumerable:!0})},x=(r,e,i,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of p(e))!y.call(r,n)&&n!==i&&d(r,n,{get:()=>e[n],enumerable:!(t=f(e,n))||t.enumerable});return r};var g=r=>x(d({},"__esModule",{value:!0}),r);var m={};w(m,{InMemoryStorageAdapter:()=>l,IndexedDbAdapter:()=>a,LocalStorageAdapter:()=>s,getStorageAdapter:()=>h});module.exports=g(m);var o=require("@choksheak/ts-utils/kvStore");function h(r,e){let{localStorageKey:i,indexedDbKey:t,storeExpiryMs:n,store:u}=r??{};if(u)return u;let c=n||e;return i?new s(i,c):t?new a(t,c):null}var l=class{constructor(e,i){this.keyPrefix=e;this.expiryMs=i}cache=new Map;save(e,i){let t=this.keyPrefix+":"+e;this.cache.set(t,{value:i,expiresAt:Date.now()+this.expiryMs})}load(e){let i=this.keyPrefix+":"+e,t=this.cache.get(i);if(t&&Date.now()<t.expiresAt)return t.value}delete(e){let i=this.keyPrefix+":"+e;this.cache.delete(i)}clear(){this.cache.clear()}},s=class{constructor(e,i){this.keyPrefix=e;this.expiryMs=i}save(e,i){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;window.localStorage.setItem(t,JSON.stringify({value:i,expiresAt:this.expiryMs?Date.now()+this.expiryMs:0}))}load(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e,t=window.localStorage.getItem(i);if(t)try{let n=JSON.parse(t);if(!n||n.expiresAt&&Date.now()>=n.expiresAt){window.localStorage.removeItem(i);return}return n.value}catch{window.localStorage.removeItem(i);return}}delete(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e;window.localStorage.removeItem(i)}clear(){if(!(typeof window>"u"))for(let e of Object.keys(window.localStorage))e.startsWith(this.keyPrefix)&&window.localStorage.removeItem(e)}},a=class{constructor(e,i){this.keyPrefix=e;this.expiryMs=i}async save(e,i){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;await o.kvStore.set(t,JSON.stringify(i),this.expiryMs)}async load(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e,t=await o.kvStore.get(i);if(t!==void 0)try{return JSON.parse(t)}catch{await o.kvStore.delete(i);return}}async delete(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e;await o.kvStore.delete(i)}async clear(){typeof window>"u"||await o.kvStore.forEach(async e=>{e.startsWith(this.keyPrefix)&&await o.kvStore.delete(e)})}};0&&(module.exports={InMemoryStorageAdapter,IndexedDbAdapter,LocalStorageAdapter,getStorageAdapter});
-//# sourceMappingURL=storage.min.cjs.map

package/utils/storage.min.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\n\nexport type StorageAdapter<T> = {\n  save: (key: string, value: T) => Promise<void> | void;\n  load: (key: string) => Promise<T | undefined> | T | undefined;\n  delete: (key: string) => Promise<void> | void;\n  clear: () => Promise<void> | void;\n};\n\nexport type StorageOptions<T> = {\n  // If specified, this will be used and all other fields will be ignored.\n  store?: StorageAdapter<T>;\n\n  // Storage key in local storage for this data.\n  localStorageKey?: string;\n\n  // Storage key in indexed db for this data.\n  indexedDbKey?: string;\n\n  // How long to wait before the value is considered expired.\n  storeExpiryMs?: number;\n};\n\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { localStorageKey, indexedDbKey, storeExpiryMs, store } = options ?? {};\n\n  if (store) {\n    return store;\n  }\n\n  const expiryMs = storeExpiryMs || defaultStoreExpiryMs;\n\n  if (localStorageKey) {\n    return new LocalStorageAdapter<T>(localStorageKey, expiryMs);\n  }\n\n  if (indexedDbKey) {\n    return new IndexedDbAdapter<T>(indexedDbKey, expiryMs);\n  }\n\n  return null;\n}\n\n/************************************************************************/\n/* Storage adapters                                                     */\n/************************************************************************/\n\ntype ValueWithExpiration<T> = { value: T; expiresAt: number };\n\n/** Save state to memory only - not persisted. */\nexport class InMemoryStorageAdapter<T> implements StorageAdapter<T> {\n  private readonly cache = new Map<string, ValueWithExpiration<T>>();\n\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.set(fullKey, {\n      value,\n      expiresAt: Date.now() + this.expiryMs,\n    });\n  }\n\n  public load(key: string): T | undefined {\n    const fullKey = this.keyPrefix + \":\" + key;\n    const cached = this.cache.get(fullKey);\n\n    if (cached && Date.now() < cached.expiresAt) {\n      return cached.value;\n    }\n\n    return undefined;\n  }\n\n  public delete(key: string): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.delete(fullKey);\n  }\n\n  public clear(): void {\n    this.cache.clear();\n  }\n}\n\n/** Save state to local storage. */\nexport class LocalStorageAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.setItem(\n      fullKey,\n      JSON.stringify({\n        value,\n        expiresAt: this.expiryMs ? Date.now() + this.expiryMs : 0,\n      } satisfies ValueWithExpiration<T>),\n    );\n  }\n\n  public load(key: string): T | undefined {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = window.localStorage.getItem(fullKey);\n    if (!raw) return undefined;\n\n    try {\n      const box = JSON.parse(raw) as ValueWithExpiration<T>;\n      if (!box || (box.expiresAt && Date.now() >= box.expiresAt)) {\n        window.localStorage.removeItem(fullKey);\n        return undefined;\n      }\n\n      return box.value;\n    } catch {\n      // Ignore error.\n      window.localStorage.removeItem(fullKey);\n      return undefined;\n    }\n  }\n\n  public delete(key: string): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.removeItem(fullKey);\n  }\n\n  public clear(): void {\n    if (typeof window === \"undefined\") return;\n\n    for (const key of Object.keys(window.localStorage)) {\n      if (key.startsWith(this.keyPrefix)) {\n        window.localStorage.removeItem(key);\n      }\n    }\n  }\n}\n\n/** Save state to indexed db. */\nexport class IndexedDbAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public async save(key: string, value: T): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.set(fullKey, JSON.stringify(value), this.expiryMs);\n  }\n\n  public async load(key: string): Promise<T | undefined> {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = await kvStore.get<string>(fullKey);\n    if (raw === undefined) return undefined;\n\n    try {\n      return JSON.parse(raw);\n    } catch {\n      // Ignore error.\n      await kvStore.delete(fullKey);\n      return undefined;\n    }\n  }\n\n  public async delete(key: string): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.delete(fullKey);\n  }\n\n  public async clear(): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    await kvStore.forEach(async (k) => {\n      if (k.startsWith(this.keyPrefix)) {\n        await kvStore.delete(k);\n      }\n    });\n  }\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,4BAAAE,EAAA,qBAAAC,EAAA,wBAAAC,EAAA,sBAAAC,IAAA,eAAAC,EAAAN,GAAA,IAAAO,EAAwB,uCAuBjB,SAASF,EACdG,EACAC,EAC0B,CAC1B,GAAM,CAAE,gBAAAC,EAAiB,aAAAC,EAAc,cAAAC,EAAe,MAAAC,CAAM,EAAIL,GAAW,CAAC,EAE5E,GAAIK,EACF,OAAOA,EAGT,IAAMC,EAAWF,GAAiBH,EAElC,OAAIC,EACK,IAAIN,EAAuBM,EAAiBI,CAAQ,EAGzDH,EACK,IAAIR,EAAoBQ,EAAcG,CAAQ,EAGhD,IACT,CASO,IAAMZ,EAAN,KAA6D,CAG3D,YACWa,EACAD,EAChB,CAFgB,eAAAC,EACA,cAAAD,CACf,CALc,MAAQ,IAAI,IAOtB,KAAKE,EAAaC,EAAgB,CACvC,IAAMC,EAAU,KAAK,UAAY,IAAMF,EACvC,KAAK,MAAM,IAAIE,EAAS,CACtB,MAAAD,EACA,UAAW,KAAK,IAAI,EAAI,KAAK,QAC/B,CAAC,CACH,CAEO,KAAKD,EAA4B,CACtC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACjCG,EAAS,KAAK,MAAM,IAAID,CAAO,EAErC,GAAIC,GAAU,KAAK,IAAI,EAAIA,EAAO,UAChC,OAAOA,EAAO,KAIlB,CAEO,OAAOH,EAAmB,CAC/B,IAAME,EAAU,KAAK,UAAY,IAAMF,EACvC,KAAK,MAAM,OAAOE,CAAO,CAC3B,CAEO,OAAc,CACnB,KAAK,MAAM,MAAM,CACnB,CACF,EAGad,EAAN,KAA0D,CACxD,YACWW,EACAD,EAChB,CAFgB,eAAAC,EACA,cAAAD,CACf,CAEI,KAAKE,EAAaC,EAAgB,CACvC,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAMC,EAAU,KAAK,UAAY,IAAMF,EACvC,OAAO,aAAa,QAClBE,EACA,KAAK,UAAU,CACb,MAAAD,EACA,UAAW,KAAK,SAAW,KAAK,IAAI,EAAI,KAAK,SAAW,CAC1D,CAAkC,CACpC,CACF,CAEO,KAAKD,EAA4B,CACtC,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACjCI,EAAM,OAAO,aAAa,QAAQF,CAAO,EAC/C,GAAKE,EAEL,GAAI,CACF,IAAMC,EAAM,KAAK,MAAMD,CAAG,EAC1B,GAAI,CAACC,GAAQA,EAAI,WAAa,KAAK,IAAI,GAAKA,EAAI,UAAY,CAC1D,OAAO,aAAa,WAAWH,CAAO,EACtC,MACF,CAEA,OAAOG,EAAI,KACb,MAAQ,CAEN,OAAO,aAAa,WAAWH,CAAO,EACtC,MACF,CACF,CAEO,OAAOF,EAAmB,CAC/B,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACvC,OAAO,aAAa,WAAWE,CAAO,CACxC,CAEO,OAAc,CACnB,GAAI,SAAO,OAAW,KAEtB,QAAWF,KAAO,OAAO,KAAK,OAAO,YAAY,EAC3CA,EAAI,WAAW,KAAK,SAAS,GAC/B,OAAO,aAAa,WAAWA,CAAG,CAGxC,CACF,EAGab,EAAN,KAAuD,CACrD,YACWY,EACAD,EAChB,CAFgB,eAAAC,EACA,cAAAD,CACf,CAEH,MAAa,KAAKE,EAAaC,EAAyB,CACtD,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAMC,EAAU,KAAK,UAAY,IAAMF,EACvC,MAAM,UAAQ,IAAIE,EAAS,KAAK,UAAUD,CAAK,EAAG,KAAK,QAAQ,CACjE,CAEA,MAAa,KAAKD,EAAqC,CACrD,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACjCI,EAAM,MAAM,UAAQ,IAAYF,CAAO,EAC7C,GAAIE,IAAQ,OAEZ,GAAI,CACF,OAAO,KAAK,MAAMA,CAAG,CACvB,MAAQ,CAEN,MAAM,UAAQ,OAAOF,CAAO,EAC5B,MACF,CACF,CAEA,MAAa,OAAOF,EAA4B,CAC9C,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACvC,MAAM,UAAQ,OAAOE,CAAO,CAC9B,CAEA,MAAa,OAAuB,CAC9B,OAAO,OAAW,KAEtB,MAAM,UAAQ,QAAQ,MAAOI,GAAM,CAC7BA,EAAE,WAAW,KAAK,SAAS,GAC7B,MAAM,UAAQ,OAAOA,CAAC,CAE1B,CAAC,CACH,CACF","names":["storage_exports","__export","InMemoryStorageAdapter","IndexedDbAdapter","LocalStorageAdapter","getStorageAdapter","__toCommonJS","import_kvStore","options","defaultStoreExpiryMs","localStorageKey","indexedDbKey","storeExpiryMs","store","expiryMs","keyPrefix","key","value","fullKey","cached","raw","box","k"]}

package/utils/storage.min.mjs

@@ -1,2 +0,0 @@
-import{kvStore as n}from"@choksheak/ts-utils/kvStore";function f(o,e){let{localStorageKey:i,indexedDbKey:t,storeExpiryMs:r,store:d}=o??{};if(d)return d;let l=r||e;return i?new s(i,l):t?new a(t,l):null}var u=class{constructor(e,i){this.keyPrefix=e;this.expiryMs=i}cache=new Map;save(e,i){let t=this.keyPrefix+":"+e;this.cache.set(t,{value:i,expiresAt:Date.now()+this.expiryMs})}load(e){let i=this.keyPrefix+":"+e,t=this.cache.get(i);if(t&&Date.now()<t.expiresAt)return t.value}delete(e){let i=this.keyPrefix+":"+e;this.cache.delete(i)}clear(){this.cache.clear()}},s=class{constructor(e,i){this.keyPrefix=e;this.expiryMs=i}save(e,i){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;window.localStorage.setItem(t,JSON.stringify({value:i,expiresAt:this.expiryMs?Date.now()+this.expiryMs:0}))}load(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e,t=window.localStorage.getItem(i);if(t)try{let r=JSON.parse(t);if(!r||r.expiresAt&&Date.now()>=r.expiresAt){window.localStorage.removeItem(i);return}return r.value}catch{window.localStorage.removeItem(i);return}}delete(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e;window.localStorage.removeItem(i)}clear(){if(!(typeof window>"u"))for(let e of Object.keys(window.localStorage))e.startsWith(this.keyPrefix)&&window.localStorage.removeItem(e)}},a=class{constructor(e,i){this.keyPrefix=e;this.expiryMs=i}async save(e,i){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;await n.set(t,JSON.stringify(i),this.expiryMs)}async load(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e,t=await n.get(i);if(t!==void 0)try{return JSON.parse(t)}catch{await n.delete(i);return}}async delete(e){if(typeof window>"u")return;let i=this.keyPrefix+":"+e;await n.delete(i)}async clear(){typeof window>"u"||await n.forEach(async e=>{e.startsWith(this.keyPrefix)&&await n.delete(e)})}};export{u as InMemoryStorageAdapter,a as IndexedDbAdapter,s as LocalStorageAdapter,f as getStorageAdapter};
-//# sourceMappingURL=storage.min.mjs.map

package/utils/storage.min.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\n\nexport type StorageAdapter<T> = {\n  save: (key: string, value: T) => Promise<void> | void;\n  load: (key: string) => Promise<T | undefined> | T | undefined;\n  delete: (key: string) => Promise<void> | void;\n  clear: () => Promise<void> | void;\n};\n\nexport type StorageOptions<T> = {\n  // If specified, this will be used and all other fields will be ignored.\n  store?: StorageAdapter<T>;\n\n  // Storage key in local storage for this data.\n  localStorageKey?: string;\n\n  // Storage key in indexed db for this data.\n  indexedDbKey?: string;\n\n  // How long to wait before the value is considered expired.\n  storeExpiryMs?: number;\n};\n\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { localStorageKey, indexedDbKey, storeExpiryMs, store } = options ?? {};\n\n  if (store) {\n    return store;\n  }\n\n  const expiryMs = storeExpiryMs || defaultStoreExpiryMs;\n\n  if (localStorageKey) {\n    return new LocalStorageAdapter<T>(localStorageKey, expiryMs);\n  }\n\n  if (indexedDbKey) {\n    return new IndexedDbAdapter<T>(indexedDbKey, expiryMs);\n  }\n\n  return null;\n}\n\n/************************************************************************/\n/* Storage adapters                                                     */\n/************************************************************************/\n\ntype ValueWithExpiration<T> = { value: T; expiresAt: number };\n\n/** Save state to memory only - not persisted. */\nexport class InMemoryStorageAdapter<T> implements StorageAdapter<T> {\n  private readonly cache = new Map<string, ValueWithExpiration<T>>();\n\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.set(fullKey, {\n      value,\n      expiresAt: Date.now() + this.expiryMs,\n    });\n  }\n\n  public load(key: string): T | undefined {\n    const fullKey = this.keyPrefix + \":\" + key;\n    const cached = this.cache.get(fullKey);\n\n    if (cached && Date.now() < cached.expiresAt) {\n      return cached.value;\n    }\n\n    return undefined;\n  }\n\n  public delete(key: string): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.delete(fullKey);\n  }\n\n  public clear(): void {\n    this.cache.clear();\n  }\n}\n\n/** Save state to local storage. */\nexport class LocalStorageAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.setItem(\n      fullKey,\n      JSON.stringify({\n        value,\n        expiresAt: this.expiryMs ? Date.now() + this.expiryMs : 0,\n      } satisfies ValueWithExpiration<T>),\n    );\n  }\n\n  public load(key: string): T | undefined {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = window.localStorage.getItem(fullKey);\n    if (!raw) return undefined;\n\n    try {\n      const box = JSON.parse(raw) as ValueWithExpiration<T>;\n      if (!box || (box.expiresAt && Date.now() >= box.expiresAt)) {\n        window.localStorage.removeItem(fullKey);\n        return undefined;\n      }\n\n      return box.value;\n    } catch {\n      // Ignore error.\n      window.localStorage.removeItem(fullKey);\n      return undefined;\n    }\n  }\n\n  public delete(key: string): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.removeItem(fullKey);\n  }\n\n  public clear(): void {\n    if (typeof window === \"undefined\") return;\n\n    for (const key of Object.keys(window.localStorage)) {\n      if (key.startsWith(this.keyPrefix)) {\n        window.localStorage.removeItem(key);\n      }\n    }\n  }\n}\n\n/** Save state to indexed db. */\nexport class IndexedDbAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public async save(key: string, value: T): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.set(fullKey, JSON.stringify(value), this.expiryMs);\n  }\n\n  public async load(key: string): Promise<T | undefined> {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = await kvStore.get<string>(fullKey);\n    if (raw === undefined) return undefined;\n\n    try {\n      return JSON.parse(raw);\n    } catch {\n      // Ignore error.\n      await kvStore.delete(fullKey);\n      return undefined;\n    }\n  }\n\n  public async delete(key: string): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.delete(fullKey);\n  }\n\n  public async clear(): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    await kvStore.forEach(async (k) => {\n      if (k.startsWith(this.keyPrefix)) {\n        await kvStore.delete(k);\n      }\n    });\n  }\n}\n"],"mappings":"AAAA,OAAS,WAAAA,MAAe,8BAuBjB,SAASC,EACdC,EACAC,EAC0B,CAC1B,GAAM,CAAE,gBAAAC,EAAiB,aAAAC,EAAc,cAAAC,EAAe,MAAAC,CAAM,EAAIL,GAAW,CAAC,EAE5E,GAAIK,EACF,OAAOA,EAGT,IAAMC,EAAWF,GAAiBH,EAElC,OAAIC,EACK,IAAIK,EAAuBL,EAAiBI,CAAQ,EAGzDH,EACK,IAAIK,EAAoBL,EAAcG,CAAQ,EAGhD,IACT,CASO,IAAMG,EAAN,KAA6D,CAG3D,YACWC,EACAJ,EAChB,CAFgB,eAAAI,EACA,cAAAJ,CACf,CALc,MAAQ,IAAI,IAOtB,KAAKK,EAAaC,EAAgB,CACvC,IAAMC,EAAU,KAAK,UAAY,IAAMF,EACvC,KAAK,MAAM,IAAIE,EAAS,CACtB,MAAAD,EACA,UAAW,KAAK,IAAI,EAAI,KAAK,QAC/B,CAAC,CACH,CAEO,KAAKD,EAA4B,CACtC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACjCG,EAAS,KAAK,MAAM,IAAID,CAAO,EAErC,GAAIC,GAAU,KAAK,IAAI,EAAIA,EAAO,UAChC,OAAOA,EAAO,KAIlB,CAEO,OAAOH,EAAmB,CAC/B,IAAME,EAAU,KAAK,UAAY,IAAMF,EACvC,KAAK,MAAM,OAAOE,CAAO,CAC3B,CAEO,OAAc,CACnB,KAAK,MAAM,MAAM,CACnB,CACF,EAGaN,EAAN,KAA0D,CACxD,YACWG,EACAJ,EAChB,CAFgB,eAAAI,EACA,cAAAJ,CACf,CAEI,KAAKK,EAAaC,EAAgB,CACvC,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAMC,EAAU,KAAK,UAAY,IAAMF,EACvC,OAAO,aAAa,QAClBE,EACA,KAAK,UAAU,CACb,MAAAD,EACA,UAAW,KAAK,SAAW,KAAK,IAAI,EAAI,KAAK,SAAW,CAC1D,CAAkC,CACpC,CACF,CAEO,KAAKD,EAA4B,CACtC,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACjCI,EAAM,OAAO,aAAa,QAAQF,CAAO,EAC/C,GAAKE,EAEL,GAAI,CACF,IAAMC,EAAM,KAAK,MAAMD,CAAG,EAC1B,GAAI,CAACC,GAAQA,EAAI,WAAa,KAAK,IAAI,GAAKA,EAAI,UAAY,CAC1D,OAAO,aAAa,WAAWH,CAAO,EACtC,MACF,CAEA,OAAOG,EAAI,KACb,MAAQ,CAEN,OAAO,aAAa,WAAWH,CAAO,EACtC,MACF,CACF,CAEO,OAAOF,EAAmB,CAC/B,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACvC,OAAO,aAAa,WAAWE,CAAO,CACxC,CAEO,OAAc,CACnB,GAAI,SAAO,OAAW,KAEtB,QAAWF,KAAO,OAAO,KAAK,OAAO,YAAY,EAC3CA,EAAI,WAAW,KAAK,SAAS,GAC/B,OAAO,aAAa,WAAWA,CAAG,CAGxC,CACF,EAGaH,EAAN,KAAuD,CACrD,YACWE,EACAJ,EAChB,CAFgB,eAAAI,EACA,cAAAJ,CACf,CAEH,MAAa,KAAKK,EAAaC,EAAyB,CACtD,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAMC,EAAU,KAAK,UAAY,IAAMF,EACvC,MAAMb,EAAQ,IAAIe,EAAS,KAAK,UAAUD,CAAK,EAAG,KAAK,QAAQ,CACjE,CAEA,MAAa,KAAKD,EAAqC,CACrD,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACjCI,EAAM,MAAMjB,EAAQ,IAAYe,CAAO,EAC7C,GAAIE,IAAQ,OAEZ,GAAI,CACF,OAAO,KAAK,MAAMA,CAAG,CACvB,MAAQ,CAEN,MAAMjB,EAAQ,OAAOe,CAAO,EAC5B,MACF,CACF,CAEA,MAAa,OAAOF,EAA4B,CAC9C,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAME,EAAU,KAAK,UAAY,IAAMF,EACvC,MAAMb,EAAQ,OAAOe,CAAO,CAC9B,CAEA,MAAa,OAAuB,CAC9B,OAAO,OAAW,KAEtB,MAAMf,EAAQ,QAAQ,MAAOmB,GAAM,CAC7BA,EAAE,WAAW,KAAK,SAAS,GAC7B,MAAMnB,EAAQ,OAAOmB,CAAC,CAE1B,CAAC,CACH,CACF","names":["kvStore","getStorageAdapter","options","defaultStoreExpiryMs","localStorageKey","indexedDbKey","storeExpiryMs","store","expiryMs","LocalStorageAdapter","IndexedDbAdapter","InMemoryStorageAdapter","keyPrefix","key","value","fullKey","cached","raw","box","k"]}

package/utils/storage.mjs

@@ -1,134 +0,0 @@
-// src/utils/storage.ts
-import { kvStore } from "@choksheak/ts-utils/kvStore";
-function getStorageAdapter(options, defaultStoreExpiryMs) {
-  const { localStorageKey, indexedDbKey, storeExpiryMs, store } = options ?? {};
-  if (store) {
-    return store;
-  }
-  const expiryMs = storeExpiryMs || defaultStoreExpiryMs;
-  if (localStorageKey) {
-    return new LocalStorageAdapter(localStorageKey, expiryMs);
-  }
-  if (indexedDbKey) {
-    return new IndexedDbAdapter(indexedDbKey, expiryMs);
-  }
-  return null;
-}
-var InMemoryStorageAdapter = class {
-  constructor(keyPrefix, expiryMs) {
-    this.keyPrefix = keyPrefix;
-    this.expiryMs = expiryMs;
-  }
-  cache = /* @__PURE__ */ new Map();
-  save(key, value) {
-    const fullKey = this.keyPrefix + ":" + key;
-    this.cache.set(fullKey, {
-      value,
-      expiresAt: Date.now() + this.expiryMs
-    });
-  }
-  load(key) {
-    const fullKey = this.keyPrefix + ":" + key;
-    const cached = this.cache.get(fullKey);
-    if (cached && Date.now() < cached.expiresAt) {
-      return cached.value;
-    }
-    return void 0;
-  }
-  delete(key) {
-    const fullKey = this.keyPrefix + ":" + key;
-    this.cache.delete(fullKey);
-  }
-  clear() {
-    this.cache.clear();
-  }
-};
-var LocalStorageAdapter = class {
-  constructor(keyPrefix, expiryMs) {
-    this.keyPrefix = keyPrefix;
-    this.expiryMs = expiryMs;
-  }
-  save(key, value) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    window.localStorage.setItem(
-      fullKey,
-      JSON.stringify({
-        value,
-        expiresAt: this.expiryMs ? Date.now() + this.expiryMs : 0
-      })
-    );
-  }
-  load(key) {
-    if (typeof window === "undefined") return void 0;
-    const fullKey = this.keyPrefix + ":" + key;
-    const raw = window.localStorage.getItem(fullKey);
-    if (!raw) return void 0;
-    try {
-      const box = JSON.parse(raw);
-      if (!box || box.expiresAt && Date.now() >= box.expiresAt) {
-        window.localStorage.removeItem(fullKey);
-        return void 0;
-      }
-      return box.value;
-    } catch {
-      window.localStorage.removeItem(fullKey);
-      return void 0;
-    }
-  }
-  delete(key) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    window.localStorage.removeItem(fullKey);
-  }
-  clear() {
-    if (typeof window === "undefined") return;
-    for (const key of Object.keys(window.localStorage)) {
-      if (key.startsWith(this.keyPrefix)) {
-        window.localStorage.removeItem(key);
-      }
-    }
-  }
-};
-var IndexedDbAdapter = class {
-  constructor(keyPrefix, expiryMs) {
-    this.keyPrefix = keyPrefix;
-    this.expiryMs = expiryMs;
-  }
-  async save(key, value) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    await kvStore.set(fullKey, JSON.stringify(value), this.expiryMs);
-  }
-  async load(key) {
-    if (typeof window === "undefined") return void 0;
-    const fullKey = this.keyPrefix + ":" + key;
-    const raw = await kvStore.get(fullKey);
-    if (raw === void 0) return void 0;
-    try {
-      return JSON.parse(raw);
-    } catch {
-      await kvStore.delete(fullKey);
-      return void 0;
-    }
-  }
-  async delete(key) {
-    if (typeof window === "undefined") return;
-    const fullKey = this.keyPrefix + ":" + key;
-    await kvStore.delete(fullKey);
-  }
-  async clear() {
-    if (typeof window === "undefined") return;
-    await kvStore.forEach(async (k) => {
-      if (k.startsWith(this.keyPrefix)) {
-        await kvStore.delete(k);
-      }
-    });
-  }
-};
-export {
-  InMemoryStorageAdapter,
-  IndexedDbAdapter,
-  LocalStorageAdapter,
-  getStorageAdapter
-};

package/utils/stringify.min.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/stringify.ts"],"sourcesContent":["/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,mCAAAE,IAAA,eAAAC,EAAAH,GASO,SAASE,EAA8BE,EAAyB,CACrE,IAAMC,EAAQ,IAAI,IAElB,OAAO,KAAK,UAAUD,EAAQ,CAACE,EAAGC,IAAU,CAC1C,GAAI,OAAOA,GAAU,WACnB,MAAM,IAAI,MAAM,sDAAsD,EAGxE,GAAI,CAACA,GAAS,OAAOA,GAAU,UAAY,MAAM,QAAQA,CAAK,EAC5D,OAAOA,EAGT,GAAIF,EAAM,IAAIE,CAAK,EAEjB,MAAO,aAOT,GAJAF,EAAM,IAAIE,CAAK,EAIXA,IAAUH,EACZ,GAAI,CACF,KAAK,UAAUG,CAAK,CACtB,MAAQ,CACN,MAAO,kBACT,CAGF,OAAO,OAAO,KAAKA,CAAK,EACrB,KAAK,EACL,OACC,CAACC,EAAiCC,KAChCD,EAAOC,CAAG,EAAIF,EAAME,CAAG,EAChBD,GAET,CAAC,CACH,CACJ,CAAC,CACH","names":["stringify_exports","__export","stringifyDeterministicForKeys","__toCommonJS","params","cache","_","value","result","key"]}

package/utils/stringify.min.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/stringify.ts"],"sourcesContent":["/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n"],"mappings":"AASO,SAASA,EAA8BC,EAAyB,CACrE,IAAMC,EAAQ,IAAI,IAElB,OAAO,KAAK,UAAUD,EAAQ,CAACE,EAAGC,IAAU,CAC1C,GAAI,OAAOA,GAAU,WACnB,MAAM,IAAI,MAAM,sDAAsD,EAGxE,GAAI,CAACA,GAAS,OAAOA,GAAU,UAAY,MAAM,QAAQA,CAAK,EAC5D,OAAOA,EAGT,GAAIF,EAAM,IAAIE,CAAK,EAEjB,MAAO,aAOT,GAJAF,EAAM,IAAIE,CAAK,EAIXA,IAAUH,EACZ,GAAI,CACF,KAAK,UAAUG,CAAK,CACtB,MAAQ,CACN,MAAO,kBACT,CAGF,OAAO,OAAO,KAAKA,CAAK,EACrB,KAAK,EACL,OACC,CAACC,EAAiCC,KAChCD,EAAOC,CAAG,EAAIF,EAAME,CAAG,EAChBD,GAET,CAAC,CACH,CACJ,CAAC,CACH","names":["stringifyDeterministicForKeys","params","cache","_","value","result","key"]}

package/utils/useDeepMemo.d.mts

@@ -1,4 +0,0 @@
-/** Provides a stable value for T based on deep equality. */
-declare function useDeepMemo<T>(value: T): T;
-
-export { useDeepMemo };

package/utils/useDeepMemo.d.ts

@@ -1,2 +0,0 @@
-/** Provides a stable value for T based on deep equality. */
-export declare function useDeepMemo<T>(value: T): T;

package/utils/useDeepMemo.min.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/useDeepMemo.ts"],"sourcesContent":["import isEqual from \"lodash/isEqual\";\nimport { useMemo, useState } from \"react\";\n\n/** Provides a stable value for T based on deep equality. */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (state === value || isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"0jBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,iBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAoB,6BACpBC,EAAkC,iBAG3B,SAASH,EAAeI,EAAa,CAC1C,GAAM,CAACC,EAAOC,CAAQ,KAAI,YAAYF,CAAK,EAE3C,SAAO,WAAQ,IACTC,IAAUD,MAAS,EAAAG,SAAQF,EAAOD,CAAK,EAClCC,GAKTC,EAASF,CAAK,EAEPA,GACN,CAACC,EAAOD,CAAK,CAAC,CACnB","names":["useDeepMemo_exports","__export","useDeepMemo","__toCommonJS","import_isEqual","import_react","value","state","setState","isEqual"]}

package/utils/useDeepMemo.min.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/useDeepMemo.ts"],"sourcesContent":["import isEqual from \"lodash/isEqual\";\nimport { useMemo, useState } from \"react\";\n\n/** Provides a stable value for T based on deep equality. */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (state === value || isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"AAAA,OAAOA,MAAa,iBACpB,OAAS,WAAAC,EAAS,YAAAC,MAAgB,QAG3B,SAASC,EAAeC,EAAa,CAC1C,GAAM,CAACC,EAAOC,CAAQ,EAAIJ,EAAYE,CAAK,EAE3C,OAAOH,EAAQ,IACTI,IAAUD,GAASJ,EAAQK,EAAOD,CAAK,EAClCC,GAKTC,EAASF,CAAK,EAEPA,GACN,CAACC,EAAOD,CAAK,CAAC,CACnB","names":["isEqual","useMemo","useState","useDeepMemo","value","state","setState"]}