@choksheak/react-utils 0.2.7 → 0.2.9

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":"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","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"]}