@choksheak/react-utils 0.3.9 → 0.4.0

package/sharedState.mjs

@@ -1,272 +1,13 @@
-// src/sharedState.ts
-import { MS_PER_DAY } from "@choksheak/ts-utils/timeConstants";
-import { useSyncExternalStore } from "react";
-
-// src/storage.ts
-import { kvStore } from "@choksheak/ts-utils/kvStore";
-import { createLocalStore } from "@choksheak/ts-utils/localStore";
-var IS_NOT_BROWSER = typeof window === "undefined";
-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;
-    const config = { ...store, expiryMs };
-    switch (store.persistTo) {
-      case "localStorage":
-        return localStoreAdapter(config);
-      case "indexedDb":
-        return kvStoreAdapter(config);
-      default:
-        store.persistTo;
-        throw new Error(`Unknown store.adapter ${store.persistTo}`);
-    }
-  }
-  return store;
-}
-function localStoreAdapter({
-  key,
-  expiryMs,
-  isValid
-}) {
-  const adapter = createLocalStore(key, { defaultExpiryMs: expiryMs });
-  return {
-    set: (key2, value) => {
-      if (IS_NOT_BROWSER) return;
-      adapter.set(key2, value);
-    },
-    get: (key2) => {
-      if (IS_NOT_BROWSER) return void 0;
-      const value = adapter.get(key2);
-      if (isValid && !isValid(value)) {
-        console.warn(
-          `localStorage adapter: Auto-discard invalid value for ${key2}: ${JSON.stringify(value)}`
-        );
-        adapter.delete(key2);
-        return void 0;
-      }
-      return value;
-    },
-    delete: (key2) => {
-      if (IS_NOT_BROWSER) return;
-      adapter.delete(key2);
-    },
-    clear: () => {
-      if (IS_NOT_BROWSER) return;
-      adapter.clear();
-    }
-  };
-}
-function kvStoreAdapter({
-  key,
-  expiryMs,
-  isValid
-}) {
-  const keyPrefix = key + ":";
-  return {
-    set: async (key2, value) => {
-      if (IS_NOT_BROWSER) return;
-      await kvStore.set(keyPrefix + key2, value, expiryMs);
-    },
-    get: async (key2) => {
-      if (IS_NOT_BROWSER) return void 0;
-      const fullKey = keyPrefix + key2;
-      const value = await kvStore.get(fullKey);
-      if (value !== void 0 && isValid && !isValid(value)) {
-        console.warn(
-          `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
-          value
-        );
-        await kvStore.delete(fullKey);
-        return void 0;
-      }
-      return value;
-    },
-    delete: async (key2) => {
-      if (IS_NOT_BROWSER) return;
-      await kvStore.delete(keyPrefix + key2);
-    },
-    clear: async () => {
-      if (IS_NOT_BROWSER) return;
-      await kvStore.clear();
-    }
-  };
-}
-
-// src/sharedState.ts
-var SharedStateConfig = {
-  /**
-   * Default duration for storage expiration in milliseconds. Initial value
-   * is 30 days, but can be changed to anything.
-   */
-  storeExpiryMs: 30 * MS_PER_DAY,
-  /**
-   * True to load from storage only on mount, false (default) to load in
-   * the top level scope when the shared state is defined.
-   */
-  lazyLoad: false
-};
-function configureSharedState(config) {
-  Object.assign(SharedStateConfig, config);
-}
-function createPubSubStore() {
-  const dataByKey = /* @__PURE__ */ new Map();
-  const subscribersByKey = /* @__PURE__ */ new Map();
-  function notify(key, next, prev) {
-    const subscribers = subscribersByKey.get(key);
-    if (!subscribers) return;
-    const copy = Array.from(subscribers.values());
-    for (const subscriber of copy) {
-      try {
-        subscriber(next, prev);
-      } catch (e) {
-        console.error(`Error invoking subscriber:`, e);
-      }
-    }
-  }
-  return {
-    // This could be undefined if T includes undefined, else it should never
-    // return undefined because the user has to always specify the default value.
-    get(key) {
-      return dataByKey.get(key);
-    },
-    set(key, value) {
-      const prev = dataByKey.get(key);
-      if (prev === value) return;
-      dataByKey.set(key, value);
-      notify(key, value, prev);
-    },
-    delete(key) {
-      dataByKey.delete(key);
-    },
-    setNoNotify(key, value) {
-      dataByKey.set(key, value);
-    },
-    // Subscribe to changes of a specific key
-    subscribe(key, subscriber) {
-      let subscribers = subscribersByKey.get(key);
-      if (!subscribers) {
-        subscribers = /* @__PURE__ */ new Set();
-        subscribersByKey.set(key, subscribers);
-      }
-      subscribers.add(subscriber);
-      return () => {
-        subscribers.delete(subscriber);
-        if (subscribers.size === 0) subscribersByKey.delete(key);
-      };
-    }
-  };
-}
-var pubSubStore = createPubSubStore();
-var STORAGE_KEY = "state";
-var stateKey = 0;
-function sharedState(defaultValue, options) {
-  let readyResolve = () => {
-  };
-  const readyPromise = new Promise((resolve) => {
-    readyResolve = resolve;
-  });
-  const resolveReadyPromise = readyResolve;
-  const pubSubKey = String(stateKey++);
-  const storageAdapter = getStorageAdapter(
-    options,
-    SharedStateConfig.storeExpiryMs
-  );
-  pubSubStore.setNoNotify(pubSubKey, defaultValue);
-  const lazyLoad = options?.lazyLoad;
-  const lazy = lazyLoad !== void 0 ? lazyLoad : SharedStateConfig.lazyLoad;
-  const obj = {
-    /** Allow users to await for the completion of data init. */
-    readyPromise,
-    lazy,
-    initStarted: false,
-    initDone: false,
-    /** `subscribe` function required by useSyncExternalStore. */
-    subscribe(subscriber) {
-      return pubSubStore.subscribe(pubSubKey, () => subscriber());
-    },
-    /** Returns true if there is a backing store. */
-    hasStore() {
-      return Boolean(storageAdapter);
-    },
-    /**
-     * Set a value directly into the store. Does nothing if there is no
-     * backing store.
-     *
-     * Warning: If you want to set the value properly, you should use
-     * `setValue()` instead which also updates the in-memory copy.
-     */
-    async setInStore(value) {
-      return await storageAdapter?.set(STORAGE_KEY, value);
-    },
-    /**
-     * Get a value directly from the store. Returns undefined if there is no
-     * backing store.
-     */
-    async getFromStore() {
-      return await storageAdapter?.get(STORAGE_KEY);
-    },
-    /**
-     * Get the value of the shared state.
-     *  `getSnapshot` function — must return same ref if value unchanged.
-     * Note that this would return the default value if data init from store is
-     * not completed yet.
-     */
-    getSnapshot() {
-      return pubSubStore.get(pubSubKey);
-    },
-    /** Set the value of the shared state. */
-    setValue(next) {
-      if (typeof next === "function") {
-        const prev = pubSubStore.get(pubSubKey);
-        next = next(prev);
-      }
-      pubSubStore.set(pubSubKey, next);
-      void obj.setInStore(next);
-    },
-    /**
-     * Remove the value of the shared state. Actually this just sets the value
-     * back to the given default value.
-     */
-    delete() {
-      pubSubStore.set(pubSubKey, defaultValue);
-      void storageAdapter?.set(STORAGE_KEY, defaultValue);
-    },
-    /** Initial default handling. */
-    async initDefaultValueOnce() {
-      if (obj.initDone || obj.initStarted) return;
-      obj.initStarted = true;
-      const stored = await obj.getFromStore();
-      const value = stored !== void 0 ? stored : defaultValue;
-      pubSubStore.set(pubSubKey, value);
-      obj.initDone = true;
-      resolveReadyPromise();
-    }
-  };
-  if (!lazy) {
-    void obj.initDefaultValueOnce();
-  }
-  return obj;
-}
-function useSharedState(state) {
-  void state.initDefaultValueOnce();
-  const value = useSyncExternalStore(
-    (onStoreChange) => state.subscribe(onStoreChange),
-    () => state.getSnapshot(),
-    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.
-    () => state.getSnapshot()
-  );
-  return [value, state.setValue];
-}
-function useSharedStateValue(state) {
-  return useSharedState(state)[0];
-}
-function useSharedStateSetter(state) {
-  void state.initDefaultValueOnce();
-  return state.setValue;
-}
+import {
+  SharedStateConfig,
+  configureSharedState,
+  sharedState,
+  useSharedState,
+  useSharedStateSetter,
+  useSharedStateValue
+} from "./chunk-KRXENFK3.mjs";
+import "./chunk-PHLY3LR4.mjs";
+import "./chunk-X6BYQHVC.mjs";
 export {
   SharedStateConfig,
   configureSharedState,

package/storage.cjs

@@ -1,124 +1,11 @@
-"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);
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-// src/storage.ts
-var storage_exports = {};
-__export(storage_exports, {
-  getStorageAdapter: () => getStorageAdapter,
-  kvStoreAdapter: () => kvStoreAdapter,
-  localStoreAdapter: () => localStoreAdapter
-});
-module.exports = __toCommonJS(storage_exports);
-var import_kvStore = require("@choksheak/ts-utils/kvStore");
-var import_localStore = require("@choksheak/ts-utils/localStore");
-var IS_NOT_BROWSER = typeof window === "undefined";
-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;
-    const config = { ...store, expiryMs };
-    switch (store.persistTo) {
-      case "localStorage":
-        return localStoreAdapter(config);
-      case "indexedDb":
-        return kvStoreAdapter(config);
-      default:
-        store.persistTo;
-        throw new Error(`Unknown store.adapter ${store.persistTo}`);
-    }
-  }
-  return store;
-}
-function localStoreAdapter({
-  key,
-  expiryMs,
-  isValid
-}) {
-  const adapter = (0, import_localStore.createLocalStore)(key, { defaultExpiryMs: expiryMs });
-  return {
-    set: (key2, value) => {
-      if (IS_NOT_BROWSER) return;
-      adapter.set(key2, value);
-    },
-    get: (key2) => {
-      if (IS_NOT_BROWSER) return void 0;
-      const value = adapter.get(key2);
-      if (isValid && !isValid(value)) {
-        console.warn(
-          `localStorage adapter: Auto-discard invalid value for ${key2}: ${JSON.stringify(value)}`
-        );
-        adapter.delete(key2);
-        return void 0;
-      }
-      return value;
-    },
-    delete: (key2) => {
-      if (IS_NOT_BROWSER) return;
-      adapter.delete(key2);
-    },
-    clear: () => {
-      if (IS_NOT_BROWSER) return;
-      adapter.clear();
-    }
-  };
-}
-function kvStoreAdapter({
-  key,
-  expiryMs,
-  isValid
-}) {
-  const keyPrefix = key + ":";
-  return {
-    set: async (key2, value) => {
-      if (IS_NOT_BROWSER) return;
-      await import_kvStore.kvStore.set(keyPrefix + key2, value, expiryMs);
-    },
-    get: async (key2) => {
-      if (IS_NOT_BROWSER) return void 0;
-      const fullKey = keyPrefix + key2;
-      const value = await import_kvStore.kvStore.get(fullKey);
-      if (value !== void 0 && isValid && !isValid(value)) {
-        console.warn(
-          `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
-          value
-        );
-        await import_kvStore.kvStore.delete(fullKey);
-        return void 0;
-      }
-      return value;
-    },
-    delete: async (key2) => {
-      if (IS_NOT_BROWSER) return;
-      await import_kvStore.kvStore.delete(keyPrefix + key2);
-    },
-    clear: async () => {
-      if (IS_NOT_BROWSER) return;
-      await import_kvStore.kvStore.clear();
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getStorageAdapter,
-  kvStoreAdapter,
-  localStoreAdapter
-});
+
+
+var _chunk5PDGU37Ecjs = require('./chunk-5PDGU37E.cjs');
+require('./chunk-74BS2FAO.cjs');
+
+
+
+
+exports.getStorageAdapter = _chunk5PDGU37Ecjs.getStorageAdapter; exports.kvStoreAdapter = _chunk5PDGU37Ecjs.kvStoreAdapter; exports.localStoreAdapter = _chunk5PDGU37Ecjs.localStoreAdapter;

package/storage.d.mts

@@ -47,6 +47,7 @@ declare function localStoreAdapter<T>({ key, expiryMs, isValid, }: StoreConstruc
     set: (key: string, value: T) => void;
     get: (key: string) => T | undefined;
     delete: (key: string) => void;
+    /** Note that this will clear all keys in all shared states. */
     clear: () => void;
 };
 /**

package/storage.d.ts

@@ -45,6 +45,7 @@ export declare function localStoreAdapter<T>({ key, expiryMs, isValid, }: StoreC
     set: (key: string, value: T) => void;
     get: (key: string) => T | undefined;
     delete: (key: string) => void;
+    /** Note that this will clear all keys in all shared states. */
     clear: () => void;
 };
 /**

package/storage.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var u=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var S=(n,r)=>{for(var t in r)u(n,t,{get:r[t],enumerable:!0})},y=(n,r,t,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of g(r))!T.call(n,e)&&e!==t&&u(n,e,{get:()=>r[e],enumerable:!(o=l(r,e))||o.enumerable});return n};var m=n=>y(u({},"__esModule",{value:!0}),n);var x={};S(x,{getStorageAdapter:()=>v,kvStoreAdapter:()=>c,localStoreAdapter:()=>f});module.exports=m(x);var a=require("@choksheak/ts-utils/kvStore"),p=require("@choksheak/ts-utils/localStore"),s=typeof window>"u";function v(n,r){let{store:t}=n??{};if(!t)return null;if("persistTo"in t&&typeof t.persistTo=="string"&&"key"in t&&typeof t.key=="string"){let o=t.expiryMs||r,e={...t,expiryMs:o};switch(t.persistTo){case"localStorage":return f(e);case"indexedDb":return c(e);default:throw t.persistTo,new Error(`Unknown store.adapter ${t.persistTo}`)}}return t}function f({key:n,expiryMs:r,isValid:t}){let o=(0,p.createLocalStore)(n,{defaultExpiryMs:r});return{set:(e,i)=>{s||o.set(e,i)},get:e=>{if(s)return;let i=o.get(e);if(t&&!t(i)){console.warn(`localStorage adapter: Auto-discard invalid value for ${e}: ${JSON.stringify(i)}`),o.delete(e);return}return i},delete:e=>{s||o.delete(e)},clear:()=>{s||o.clear()}}}function c({key:n,expiryMs:r,isValid:t}){let o=n+":";return{set:async(e,i)=>{s||await a.kvStore.set(o+e,i,r)},get:async e=>{if(s)return;let i=o+e,d=await a.kvStore.get(i);if(d!==void 0&&t&&!t(d)){console.warn(`indexedDb adapter: Auto-discard invalid value for ${e}:`,d),await a.kvStore.delete(i);return}return d},delete:async e=>{s||await a.kvStore.delete(o+e)},clear:async()=>{s||await a.kvStore.clear()}}}0&&(module.exports={getStorageAdapter,kvStoreAdapter,localStoreAdapter});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkUFJQLQFImincjs = require('./chunk-UFJQLQFI.min.cjs');require('./chunk-KE3RXVMS.min.cjs');exports.getStorageAdapter = _chunkUFJQLQFImincjs.a; exports.kvStoreAdapter = _chunkUFJQLQFImincjs.c; exports.localStoreAdapter = _chunkUFJQLQFImincjs.b;
 //# sourceMappingURL=storage.min.cjs.map

package/storage.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Backing storage implementation for the shared state. Note that this uses the\n * LocalStore and KvStore from package \"@choksheak/ts-utils\", but is customized\n * to be used for shared states.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\nimport { Duration } from \"@choksheak/ts-utils/duration\";\nimport { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { createLocalStore } 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\n/** Options to configure a pre-built store adapter. */\nexport type StoreOptions = {\n  /** Choose which pre-built store adapter to use. */\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 | Duration;\n\n  /** Returns true if the given value supposed to be of type T is valid. */\n  isValid?: (u: unknown) => boolean;\n};\n\nexport type StoreConstructorArgs = Omit<StoreOptions, \"persistTo\">;\n\n/** Either use a pre-built store, or a custom one you provide. */\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\n// In SSR (Server-Side Rendering) mode, we never want to use our storage\n// adapters for anything.\nconst IS_NOT_BROWSER = typeof window === \"undefined\";\n\n/**\n * Convert a StorageOptions<T> config object into an actual storage adapter, or\n * returns null if a storage adapter is not configured.\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    const config = { ...store, expiryMs };\n\n    switch (store.persistTo) {\n      case \"localStorage\":\n        return localStoreAdapter<T>(config);\n\n      case \"indexedDb\":\n        return kvStoreAdapter<T>(config);\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\n/**\n * Create a new SSR-safe local store adapter, which allows users to reuse the\n * same adapter in multiple shared states or shared queries.\n */\nexport function localStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  const adapter = createLocalStore(key, { defaultExpiryMs: expiryMs });\n\n  return {\n    set: (key: string, value: T): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      // Also apply the custom expiryMs on every item in this store.\n      adapter.set(key, value);\n    },\n\n    get: (key: string): T | undefined => {\n      if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const value = adapter.get<T>(key);\n\n      if (isValid && !isValid(value)) {\n        console.warn(\n          `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`,\n        );\n        adapter.delete(key);\n        return undefined;\n      }\n\n      return value;\n    },\n\n    delete: (key: string): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.delete(key);\n    },\n\n    clear: (): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.clear();\n    },\n  };\n}\n\n/**\n * Create a new SSR-safe indexed DB KV store adapter, which allows users to\n * reuse the same adapter in multiple shared states or shared queries.\n */\nexport function kvStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  // Use the key prefix as a unique namespace for this store.\n  const keyPrefix = 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 (IS_NOT_BROWSER) 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 (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const fullKey = keyPrefix + key;\n      const value = await kvStore.get<T>(fullKey);\n\n      // If there is no value, don't try to check for validatity.\n      if (value !== undefined && isValid && !isValid(value)) {\n        console.warn(\n          `indexedDb adapter: Auto-discard invalid value for ${key}:`,\n          value,\n        );\n        await kvStore.delete(fullKey);\n        return undefined;\n      }\n\n      return value;\n    },\n    delete: async (key: string): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.delete(keyPrefix + key);\n    },\n    clear: async (): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.clear();\n    },\n  };\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,EAAA,mBAAAC,EAAA,sBAAAC,IAAA,eAAAC,EAAAL,GAYA,IAAAM,EAAwB,uCACxBC,EAAiC,0CAkC3BC,EAAiB,OAAO,OAAW,IAMlC,SAASN,EACdO,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,EAC7BG,EAAS,CAAE,GAAGF,EAAO,SAAAC,CAAS,EAEpC,OAAQD,EAAM,UAAW,CACvB,IAAK,eACH,OAAOP,EAAqBS,CAAM,EAEpC,IAAK,YACH,OAAOV,EAAkBU,CAAM,EAEjC,QACE,MAAAF,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT,CAMO,SAASP,EAAqB,CACnC,IAAAU,EACA,SAAAF,EACA,QAAAG,CACF,EAAyB,CACvB,IAAMC,KAAU,oBAAiBF,EAAK,CAAE,gBAAiBF,CAAS,CAAC,EAEnE,MAAO,CACL,IAAK,CAACE,EAAaG,IAAmB,CAChCT,GAGJQ,EAAQ,IAAIF,EAAKG,CAAK,CACxB,EAEA,IAAMH,GAA+B,CACnC,GAAIN,EAAgB,OAEpB,IAAMS,EAAQD,EAAQ,IAAOF,CAAG,EAEhC,GAAIC,GAAW,CAACA,EAAQE,CAAK,EAAG,CAC9B,QAAQ,KACN,wDAAwDH,CAAG,KAAK,KAAK,UAAUG,CAAK,CAAC,EACvF,EACAD,EAAQ,OAAOF,CAAG,EAClB,MACF,CAEA,OAAOG,CACT,EAEA,OAASH,GAAsB,CACzBN,GAEJQ,EAAQ,OAAOF,CAAG,CACpB,EAEA,MAAO,IAAY,CACbN,GAEJQ,EAAQ,MAAM,CAChB,CACF,CACF,CAMO,SAASb,EAAkB,CAChC,IAAAW,EACA,SAAAF,EACA,QAAAG,CACF,EAAyB,CAEvB,IAAMG,EAAYJ,EAAM,IAKxB,MAAO,CACL,IAAK,MAAOA,EAAaG,IAA4B,CAC/CT,GAGJ,MAAM,UAAQ,IAAIU,EAAYJ,EAAKG,EAAOL,CAAQ,CACpD,EACA,IAAK,MAAOE,GAAwC,CAClD,GAAIN,EAAgB,OAEpB,IAAMW,EAAUD,EAAYJ,EACtBG,EAAQ,MAAM,UAAQ,IAAOE,CAAO,EAG1C,GAAIF,IAAU,QAAaF,GAAW,CAACA,EAAQE,CAAK,EAAG,CACrD,QAAQ,KACN,qDAAqDH,CAAG,IACxDG,CACF,EACA,MAAM,UAAQ,OAAOE,CAAO,EAC5B,MACF,CAEA,OAAOF,CACT,EACA,OAAQ,MAAOH,GAA+B,CACxCN,GAEJ,MAAM,UAAQ,OAAOU,EAAYJ,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5BN,GAEJ,MAAM,UAAQ,MAAM,CACtB,CACF,CACF","names":["storage_exports","__export","getStorageAdapter","kvStoreAdapter","localStoreAdapter","__toCommonJS","import_kvStore","import_localStore","IS_NOT_BROWSER","options","defaultStoreExpiryMs","store","expiryMs","config","key","isValid","adapter","value","keyPrefix","fullKey"]}
+{"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/storage.min.cjs"],"names":[],"mappings":"AAAA,wIAA2C,oCAAiC,wJAA0E","file":"/Users/choksheaklau/src/react-utils/dist/storage.min.cjs"}

package/storage.min.mjs

@@ -1,2 +1,2 @@
-import{kvStore as a}from"@choksheak/ts-utils/kvStore";import{createLocalStore as u}from"@choksheak/ts-utils/localStore";var n=typeof window>"u";function g(i,s){let{store:e}=i??{};if(!e)return null;if("persistTo"in e&&typeof e.persistTo=="string"&&"key"in e&&typeof e.key=="string"){let r=e.expiryMs||s,t={...e,expiryMs:r};switch(e.persistTo){case"localStorage":return p(t);case"indexedDb":return f(t);default:throw e.persistTo,new Error(`Unknown store.adapter ${e.persistTo}`)}}return e}function p({key:i,expiryMs:s,isValid:e}){let r=u(i,{defaultExpiryMs:s});return{set:(t,o)=>{n||r.set(t,o)},get:t=>{if(n)return;let o=r.get(t);if(e&&!e(o)){console.warn(`localStorage adapter: Auto-discard invalid value for ${t}: ${JSON.stringify(o)}`),r.delete(t);return}return o},delete:t=>{n||r.delete(t)},clear:()=>{n||r.clear()}}}function f({key:i,expiryMs:s,isValid:e}){let r=i+":";return{set:async(t,o)=>{n||await a.set(r+t,o,s)},get:async t=>{if(n)return;let o=r+t,d=await a.get(o);if(d!==void 0&&e&&!e(d)){console.warn(`indexedDb adapter: Auto-discard invalid value for ${t}:`,d),await a.delete(o);return}return d},delete:async t=>{n||await a.delete(r+t)},clear:async()=>{n||await a.clear()}}}export{g as getStorageAdapter,f as kvStoreAdapter,p as localStoreAdapter};
+import{a,b,c}from"./chunk-VHMO75EY.min.mjs";import"./chunk-MWDH7YON.min.mjs";export{a as getStorageAdapter,c as kvStoreAdapter,b as localStoreAdapter};
 //# sourceMappingURL=storage.min.mjs.map

package/storage.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Backing storage implementation for the shared state. Note that this uses the\n * LocalStore and KvStore from package \"@choksheak/ts-utils\", but is customized\n * to be used for shared states.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\nimport { Duration } from \"@choksheak/ts-utils/duration\";\nimport { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { createLocalStore } 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\n/** Options to configure a pre-built store adapter. */\nexport type StoreOptions = {\n  /** Choose which pre-built store adapter to use. */\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 | Duration;\n\n  /** Returns true if the given value supposed to be of type T is valid. */\n  isValid?: (u: unknown) => boolean;\n};\n\nexport type StoreConstructorArgs = Omit<StoreOptions, \"persistTo\">;\n\n/** Either use a pre-built store, or a custom one you provide. */\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\n// In SSR (Server-Side Rendering) mode, we never want to use our storage\n// adapters for anything.\nconst IS_NOT_BROWSER = typeof window === \"undefined\";\n\n/**\n * Convert a StorageOptions<T> config object into an actual storage adapter, or\n * returns null if a storage adapter is not configured.\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    const config = { ...store, expiryMs };\n\n    switch (store.persistTo) {\n      case \"localStorage\":\n        return localStoreAdapter<T>(config);\n\n      case \"indexedDb\":\n        return kvStoreAdapter<T>(config);\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\n/**\n * Create a new SSR-safe local store adapter, which allows users to reuse the\n * same adapter in multiple shared states or shared queries.\n */\nexport function localStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  const adapter = createLocalStore(key, { defaultExpiryMs: expiryMs });\n\n  return {\n    set: (key: string, value: T): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      // Also apply the custom expiryMs on every item in this store.\n      adapter.set(key, value);\n    },\n\n    get: (key: string): T | undefined => {\n      if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const value = adapter.get<T>(key);\n\n      if (isValid && !isValid(value)) {\n        console.warn(\n          `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`,\n        );\n        adapter.delete(key);\n        return undefined;\n      }\n\n      return value;\n    },\n\n    delete: (key: string): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.delete(key);\n    },\n\n    clear: (): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.clear();\n    },\n  };\n}\n\n/**\n * Create a new SSR-safe indexed DB KV store adapter, which allows users to\n * reuse the same adapter in multiple shared states or shared queries.\n */\nexport function kvStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  // Use the key prefix as a unique namespace for this store.\n  const keyPrefix = 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 (IS_NOT_BROWSER) 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 (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const fullKey = keyPrefix + key;\n      const value = await kvStore.get<T>(fullKey);\n\n      // If there is no value, don't try to check for validatity.\n      if (value !== undefined && isValid && !isValid(value)) {\n        console.warn(\n          `indexedDb adapter: Auto-discard invalid value for ${key}:`,\n          value,\n        );\n        await kvStore.delete(fullKey);\n        return undefined;\n      }\n\n      return value;\n    },\n    delete: async (key: string): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.delete(keyPrefix + key);\n    },\n    clear: async (): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.clear();\n    },\n  };\n}\n"],"mappings":"AAYA,OAAS,WAAAA,MAAe,8BACxB,OAAS,oBAAAC,MAAwB,iCAkCjC,IAAMC,EAAiB,OAAO,OAAW,IAMlC,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,EAC7BG,EAAS,CAAE,GAAGF,EAAO,SAAAC,CAAS,EAEpC,OAAQD,EAAM,UAAW,CACvB,IAAK,eACH,OAAOG,EAAqBD,CAAM,EAEpC,IAAK,YACH,OAAOE,EAAkBF,CAAM,EAEjC,QACE,MAAAF,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT,CAMO,SAASG,EAAqB,CACnC,IAAAE,EACA,SAAAJ,EACA,QAAAK,CACF,EAAyB,CACvB,IAAMC,EAAUZ,EAAiBU,EAAK,CAAE,gBAAiBJ,CAAS,CAAC,EAEnE,MAAO,CACL,IAAK,CAACI,EAAaG,IAAmB,CAChCZ,GAGJW,EAAQ,IAAIF,EAAKG,CAAK,CACxB,EAEA,IAAMH,GAA+B,CACnC,GAAIT,EAAgB,OAEpB,IAAMY,EAAQD,EAAQ,IAAOF,CAAG,EAEhC,GAAIC,GAAW,CAACA,EAAQE,CAAK,EAAG,CAC9B,QAAQ,KACN,wDAAwDH,CAAG,KAAK,KAAK,UAAUG,CAAK,CAAC,EACvF,EACAD,EAAQ,OAAOF,CAAG,EAClB,MACF,CAEA,OAAOG,CACT,EAEA,OAASH,GAAsB,CACzBT,GAEJW,EAAQ,OAAOF,CAAG,CACpB,EAEA,MAAO,IAAY,CACbT,GAEJW,EAAQ,MAAM,CAChB,CACF,CACF,CAMO,SAASH,EAAkB,CAChC,IAAAC,EACA,SAAAJ,EACA,QAAAK,CACF,EAAyB,CAEvB,IAAMG,EAAYJ,EAAM,IAKxB,MAAO,CACL,IAAK,MAAOA,EAAaG,IAA4B,CAC/CZ,GAGJ,MAAMF,EAAQ,IAAIe,EAAYJ,EAAKG,EAAOP,CAAQ,CACpD,EACA,IAAK,MAAOI,GAAwC,CAClD,GAAIT,EAAgB,OAEpB,IAAMc,EAAUD,EAAYJ,EACtBG,EAAQ,MAAMd,EAAQ,IAAOgB,CAAO,EAG1C,GAAIF,IAAU,QAAaF,GAAW,CAACA,EAAQE,CAAK,EAAG,CACrD,QAAQ,KACN,qDAAqDH,CAAG,IACxDG,CACF,EACA,MAAMd,EAAQ,OAAOgB,CAAO,EAC5B,MACF,CAEA,OAAOF,CACT,EACA,OAAQ,MAAOH,GAA+B,CACxCT,GAEJ,MAAMF,EAAQ,OAAOe,EAAYJ,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5BT,GAEJ,MAAMF,EAAQ,MAAM,CACtB,CACF,CACF","names":["kvStore","createLocalStore","IS_NOT_BROWSER","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","config","localStoreAdapter","kvStoreAdapter","key","isValid","adapter","value","keyPrefix","fullKey"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/storage.mjs

@@ -1,95 +1,9 @@
-// src/storage.ts
-import { kvStore } from "@choksheak/ts-utils/kvStore";
-import { createLocalStore } from "@choksheak/ts-utils/localStore";
-var IS_NOT_BROWSER = typeof window === "undefined";
-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;
-    const config = { ...store, expiryMs };
-    switch (store.persistTo) {
-      case "localStorage":
-        return localStoreAdapter(config);
-      case "indexedDb":
-        return kvStoreAdapter(config);
-      default:
-        store.persistTo;
-        throw new Error(`Unknown store.adapter ${store.persistTo}`);
-    }
-  }
-  return store;
-}
-function localStoreAdapter({
-  key,
-  expiryMs,
-  isValid
-}) {
-  const adapter = createLocalStore(key, { defaultExpiryMs: expiryMs });
-  return {
-    set: (key2, value) => {
-      if (IS_NOT_BROWSER) return;
-      adapter.set(key2, value);
-    },
-    get: (key2) => {
-      if (IS_NOT_BROWSER) return void 0;
-      const value = adapter.get(key2);
-      if (isValid && !isValid(value)) {
-        console.warn(
-          `localStorage adapter: Auto-discard invalid value for ${key2}: ${JSON.stringify(value)}`
-        );
-        adapter.delete(key2);
-        return void 0;
-      }
-      return value;
-    },
-    delete: (key2) => {
-      if (IS_NOT_BROWSER) return;
-      adapter.delete(key2);
-    },
-    clear: () => {
-      if (IS_NOT_BROWSER) return;
-      adapter.clear();
-    }
-  };
-}
-function kvStoreAdapter({
-  key,
-  expiryMs,
-  isValid
-}) {
-  const keyPrefix = key + ":";
-  return {
-    set: async (key2, value) => {
-      if (IS_NOT_BROWSER) return;
-      await kvStore.set(keyPrefix + key2, value, expiryMs);
-    },
-    get: async (key2) => {
-      if (IS_NOT_BROWSER) return void 0;
-      const fullKey = keyPrefix + key2;
-      const value = await kvStore.get(fullKey);
-      if (value !== void 0 && isValid && !isValid(value)) {
-        console.warn(
-          `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
-          value
-        );
-        await kvStore.delete(fullKey);
-        return void 0;
-      }
-      return value;
-    },
-    delete: async (key2) => {
-      if (IS_NOT_BROWSER) return;
-      await kvStore.delete(keyPrefix + key2);
-    },
-    clear: async () => {
-      if (IS_NOT_BROWSER) return;
-      await kvStore.clear();
-    }
-  };
-}
+import {
+  getStorageAdapter,
+  kvStoreAdapter,
+  localStoreAdapter
+} from "./chunk-PHLY3LR4.mjs";
+import "./chunk-X6BYQHVC.mjs";
 export {
   getStorageAdapter,
   kvStoreAdapter,

package/stringify.cjs

@@ -1,58 +1,9 @@
-"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);
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-// src/stringify.ts
-var stringify_exports = {};
-__export(stringify_exports, {
-  stringifyDeterministicForKeys: () => stringifyDeterministicForKeys
-});
-module.exports = __toCommonJS(stringify_exports);
-function stringifyDeterministicForKeys(params) {
-  const cache = /* @__PURE__ */ new Set();
-  return JSON.stringify(params, (_, value) => {
-    if (typeof value === "function") {
-      throw new Error(`Functions should not be passed into query parameters`);
-    }
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-      return value;
-    }
-    if (cache.has(value)) {
-      return "[Circular]";
-    }
-    cache.add(value);
-    if (value !== params) {
-      try {
-        JSON.stringify(value);
-      } catch {
-        return "[Unserializable]";
-      }
-    }
-    return Object.keys(value).sort().reduce(
-      (result, key) => {
-        result[key] = value[key];
-        return result;
-      },
-      {}
-    );
-  });
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  stringifyDeterministicForKeys
-});
+
+var _chunk5DO7KC3Lcjs = require('./chunk-5DO7KC3L.cjs');
+require('./chunk-74BS2FAO.cjs');
+_chunk5DO7KC3Lcjs.init_stringify.call(void 0, );
+
+
+exports.stringifyDeterministicForKeys = _chunk5DO7KC3Lcjs.stringifyDeterministicForKeys;

package/stringify.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var d=(t,n)=>{for(var o in n)s(t,o,{get:n[o],enumerable:!0})},g=(t,n,o,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of f(n))!y.call(t,i)&&i!==o&&s(t,i,{get:()=>n[i],enumerable:!(r=c(n,i))||r.enumerable});return t};var w=t=>g(s({},"__esModule",{value:!0}),t);var u={};d(u,{stringifyDeterministicForKeys:()=>h});module.exports=w(u);function h(t){let n=new Set;return JSON.stringify(t,(o,r)=>{if(typeof r=="function")throw new Error("Functions should not be passed into query parameters");if(!r||typeof r!="object"||Array.isArray(r))return r;if(n.has(r))return"[Circular]";if(n.add(r),r!==t)try{JSON.stringify(r)}catch{return"[Unserializable]"}return Object.keys(r).sort().reduce((i,e)=>(i[e]=r[e],i),{})})}0&&(module.exports={stringifyDeterministicForKeys});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkTEZPF6BGmincjs = require('./chunk-TEZPF6BG.min.cjs');require('./chunk-KE3RXVMS.min.cjs');_chunkTEZPF6BGmincjs.b.call(void 0, );exports.stringifyDeterministicForKeys = _chunkTEZPF6BGmincjs.a;
 //# sourceMappingURL=stringify.min.cjs.map