@choksheak/react-utils 0.3.8 → 0.4.0

package/sharedState.cjs

@@ -1,307 +1,18 @@
-"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/sharedState.ts
-var sharedState_exports = {};
-__export(sharedState_exports, {
-  SharedStateConfig: () => SharedStateConfig,
-  configureSharedState: () => configureSharedState,
-  sharedState: () => sharedState,
-  useSharedState: () => useSharedState,
-  useSharedStateSetter: () => useSharedStateSetter,
-  useSharedStateValue: () => useSharedStateValue
-});
-module.exports = __toCommonJS(sharedState_exports);
-var import_timeConstants = require("@choksheak/ts-utils/timeConstants");
-var import_react = require("react");
 
-// src/storage.ts
-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();
-    }
-  };
-}
 
-// 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 * import_timeConstants.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 = (0, import_react.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;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  SharedStateConfig,
-  configureSharedState,
-  sharedState,
-  useSharedState,
-  useSharedStateSetter,
-  useSharedStateValue
-});
+
+
+
+var _chunk3X25NN6Xcjs = require('./chunk-3X25NN6X.cjs');
+require('./chunk-5PDGU37E.cjs');
+require('./chunk-74BS2FAO.cjs');
+
+
+
+
+
+
+
+exports.SharedStateConfig = _chunk3X25NN6Xcjs.SharedStateConfig; exports.configureSharedState = _chunk3X25NN6Xcjs.configureSharedState; exports.sharedState = _chunk3X25NN6Xcjs.sharedState; exports.useSharedState = _chunk3X25NN6Xcjs.useSharedState; exports.useSharedStateSetter = _chunk3X25NN6Xcjs.useSharedStateSetter; exports.useSharedStateValue = _chunk3X25NN6Xcjs.useSharedStateValue;

package/sharedState.d.mts

@@ -108,12 +108,12 @@ declare function sharedState<T>(defaultValue: T, options?: SharedStateOptions<T>
      * Warning: If you want to set the value properly, you should use
      * `setValue()` instead which also updates the in-memory copy.
      */
-    readonly setInStore: (value: T) => Promise<void>;
+    readonly setInStore: (value: T) => Promise<void> | void;
     /**
      * Get a value directly from the store. Returns undefined if there is no
      * backing store.
      */
-    readonly getFromStore: () => Promise<T | undefined>;
+    readonly getFromStore: () => Promise<T | undefined> | T | undefined;
     /**
      * Get the value of the shared state.
      *  `getSnapshot` function — must return same ref if value unchanged.
@@ -127,9 +127,9 @@ declare function sharedState<T>(defaultValue: T, options?: SharedStateOptions<T>
      * Remove the value of the shared state. Actually this just sets the value
      * back to the given default value.
      */
-    readonly delete: () => void;
+    readonly delete: () => Promise<void> | void;
     /** Initial default handling. */
-    readonly initDefaultValueOnce: () => Promise<void>;
+    readonly initDefaultValueOnce: () => Promise<void> | void;
 };
 type SharedState<T> = ReturnType<typeof sharedState<T>>;
 /**

package/sharedState.d.ts

@@ -104,12 +104,12 @@ export declare function sharedState<T>(defaultValue: T, options?: SharedStateOpt
      * Warning: If you want to set the value properly, you should use
      * `setValue()` instead which also updates the in-memory copy.
      */
-    readonly setInStore: (value: T) => Promise<void>;
+    readonly setInStore: (value: T) => Promise<void> | void;
     /**
      * Get a value directly from the store. Returns undefined if there is no
      * backing store.
      */
-    readonly getFromStore: () => Promise<T | undefined>;
+    readonly getFromStore: () => Promise<T | undefined> | T | undefined;
     /**
      * Get the value of the shared state.
      *  `getSnapshot` function — must return same ref if value unchanged.
@@ -123,9 +123,9 @@ export declare function sharedState<T>(defaultValue: T, options?: SharedStateOpt
      * Remove the value of the shared state. Actually this just sets the value
      * back to the given default value.
      */
-    readonly delete: () => void;
+    readonly delete: () => Promise<void> | void;
     /** Initial default handling. */
-    readonly initDefaultValueOnce: () => Promise<void>;
+    readonly initDefaultValueOnce: () => Promise<void> | void;
 };
 export type SharedState<T> = ReturnType<typeof sharedState<T>>;
 /**

package/sharedState.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var g=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var D=(e,i)=>{for(var n in i)g(e,n,{get:i[n],enumerable:!0})},P=(e,i,n,r)=>{if(i&&typeof i=="object"||typeof i=="function")for(let t of A(i))!O.call(e,t)&&t!==n&&g(e,t,{get:()=>i[t],enumerable:!(r=x(i,t))||r.enumerable});return e};var E=e=>P(g({},"__esModule",{value:!0}),e);var _={};D(_,{SharedStateConfig:()=>l,configureSharedState:()=>C,sharedState:()=>K,useSharedState:()=>w,useSharedStateSetter:()=>N,useSharedStateValue:()=>L});module.exports=E(_);var m=require("@choksheak/ts-utils/timeConstants"),h=require("react");var S=require("@choksheak/ts-utils/kvStore"),b=require("@choksheak/ts-utils/localStore"),d=typeof window>"u";function v(e,i){let{store:n}=e??{};if(!n)return null;if("persistTo"in n&&typeof n.persistTo=="string"&&"key"in n&&typeof n.key=="string"){let r=n.expiryMs||i,t={...n,expiryMs:r};switch(n.persistTo){case"localStorage":return M(t);case"indexedDb":return z(t);default:throw n.persistTo,new Error(`Unknown store.adapter ${n.persistTo}`)}}return n}function M({key:e,expiryMs:i,isValid:n}){let r=(0,b.createLocalStore)(e,{defaultExpiryMs:i});return{set:(t,o)=>{d||r.set(t,o)},get:t=>{if(d)return;let o=r.get(t);if(n&&!n(o)){console.warn(`localStorage adapter: Auto-discard invalid value for ${t}: ${JSON.stringify(o)}`),r.delete(t);return}return o},delete:t=>{d||r.delete(t)},clear:()=>{d||r.clear()}}}function z({key:e,expiryMs:i,isValid:n}){let r=e+":";return{set:async(t,o)=>{d||await S.kvStore.set(r+t,o,i)},get:async t=>{if(d)return;let o=r+t,a=await S.kvStore.get(o);if(a!==void 0&&n&&!n(a)){console.warn(`indexedDb adapter: Auto-discard invalid value for ${t}:`,a),await S.kvStore.delete(o);return}return a},delete:async t=>{d||await S.kvStore.delete(r+t)},clear:async()=>{d||await S.kvStore.clear()}}}var l={storeExpiryMs:30*m.MS_PER_DAY,lazyLoad:!1};function C(e){Object.assign(l,e)}function R(){let e=new Map,i=new Map;function n(r,t,o){let a=i.get(r);if(!a)return;let p=Array.from(a.values());for(let f of p)try{f(t,o)}catch(u){console.error("Error invoking subscriber:",u)}}return{get(r){return e.get(r)},set(r,t){let o=e.get(r);o!==t&&(e.set(r,t),n(r,t,o))},delete(r){e.delete(r)},setNoNotify(r,t){e.set(r,t)},subscribe(r,t){let o=i.get(r);return o||(o=new Set,i.set(r,o)),o.add(t),()=>{o.delete(t),o.size===0&&i.delete(r)}}}}var c=R(),y="state",k=0;function K(e,i){let n=()=>{},r=new Promise(s=>{n=s}),t=n,o=String(k++),a=v(i,l.storeExpiryMs);c.setNoNotify(o,e);let p=i?.lazyLoad,f=p!==void 0?p:l.lazyLoad,u={readyPromise:r,lazy:f,initStarted:!1,initDone:!1,subscribe(s){return c.subscribe(o,()=>s())},hasStore(){return!!a},async setInStore(s){return await a?.set(y,s)},async getFromStore(){return await a?.get(y)},getSnapshot(){return c.get(o)},setValue(s){if(typeof s=="function"){let T=c.get(o);s=s(T)}c.set(o,s),u.setInStore(s)},delete(){c.set(o,e),a?.set(y,e)},async initDefaultValueOnce(){if(u.initDone||u.initStarted)return;u.initStarted=!0;let s=await u.getFromStore(),T=s!==void 0?s:e;c.set(o,T),u.initDone=!0,t()}};return f||u.initDefaultValueOnce(),u}function w(e){return e.initDefaultValueOnce(),[(0,h.useSyncExternalStore)(n=>e.subscribe(n),()=>e.getSnapshot(),()=>e.getSnapshot()),e.setValue]}function L(e){return w(e)[0]}function N(e){return e.initDefaultValueOnce(),e.setValue}0&&(module.exports={SharedStateConfig,configureSharedState,sharedState,useSharedState,useSharedStateSetter,useSharedStateValue});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkNTFFK7ZHmincjs = require('./chunk-NTFFK7ZH.min.cjs');require('./chunk-UFJQLQFI.min.cjs');require('./chunk-KE3RXVMS.min.cjs');exports.SharedStateConfig = _chunkNTFFK7ZHmincjs.a; exports.configureSharedState = _chunkNTFFK7ZHmincjs.b; exports.sharedState = _chunkNTFFK7ZHmincjs.c; exports.useSharedState = _chunkNTFFK7ZHmincjs.d; exports.useSharedStateSetter = _chunkNTFFK7ZHmincjs.f; exports.useSharedStateValue = _chunkNTFFK7ZHmincjs.e;
 //# sourceMappingURL=sharedState.min.cjs.map

package/sharedState.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sharedState.ts","../src/storage.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * The \"shared state\" is a React state that shares the same value across the\n * entire app. Users declare a shared state constant that can be reused across\n * multiple components with the same underlying value.\n *\n * Shared states provide persistence to local storage and/or indexed DB out of\n * the box, by using \"@choksheak/ts-utils\". Note that no matter if the shared\n * state uses persistence or not, it will always maintain a copy of the state\n * in memory. Persisted values can be configured with an automatic expiration\n * duration.\n *\n * This module is largely similar to the open source \"jotai\" npm library. You\n * can use shared states to replace \"jotai\" in your code, and optionally make\n * use of the persistence mechanism. A quick migration guide from jotai is:\n *\n * ```\n *   atom()          -->  sharedState()\n *   useAtom()       -->  useSharedState()\n *   useAtomValue()  -->  useSharedStateValue()\n *   useSetAtom()    -->  useSharedStateSetter()\n * ```\n *\n * Example:\n * ```\n *   import { sharedState, useSharedState } from \"@choksheak/react-utils/sharedState\";\n *\n *   // Create a new shared state in the top level scope.\n *   // The first argument is the default value, which is required.\n *   // The second argument is an options object, and is optional (defaults\n *   // to storing in memory only without any persistence).\n *   const usersState = sharedState(\n *     [], { store: { persistTo: \"indexedDb\", key: \"users\" }}\n *   );\n *\n *   export const UsersComponent: React.FC = () => {\n *     // Get both the value and the setter.\n *     const [users, setUsers] = useSharedState(usersState);\n *     ...\n *   };\n *\n *   export const ReadOnlyComponent: React.FC = () => {\n *     // Get the value only.\n *     const users = useSharedStateValue(usersState);\n *     ...\n *   };\n *\n *   export const WriteOnlyComponent: React.FC = () => {\n *     // Get the setter only.\n *     const setUsers = useSharedStateSetter(usersState);\n *     ...\n *   };\n * ```\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport { Dispatch, SetStateAction, useSyncExternalStore } from \"react\";\n\nimport { getStorageAdapter, StorageOptions } from \"./storage\";\n\n/************************************************************************/\n/* Global config                                                        */\n/************************************************************************/\n\n/**\n * These values are configurable by the user at any time.\n */\nexport const SharedStateConfig = {\n  /**\n   * Default duration for storage expiration in milliseconds. Initial value\n   * is 30 days, but can be changed to anything.\n   */\n  storeExpiryMs: 30 * MS_PER_DAY,\n\n  /**\n   * True to load from storage only on mount, false (default) to load in\n   * the top level scope when the shared state is defined.\n   */\n  lazyLoad: false,\n};\n\nexport type SharedStateConfig = typeof SharedStateConfig;\n\n/** Convenience function to update global defaults. */\nexport function configureSharedState(config: Partial<SharedStateConfig>) {\n  Object.assign(SharedStateConfig, config);\n}\n\n/************************************************************************/\n/* Pub-sub store\n/************************************************************************/\n\ntype Subscriber<T> = (next: T, prev: T) => void;\n\nfunction createPubSubStore() {\n  const dataByKey = new Map<string, unknown>();\n  const subscribersByKey = new Map<string, Set<Subscriber<unknown>>>();\n\n  function notify<T>(key: string, next: T, prev: T): void {\n    const subscribers = subscribersByKey.get(key);\n    if (!subscribers) return;\n\n    // Make copy to protect against mutation during iteration.\n    const copy = Array.from(subscribers.values());\n    for (const subscriber of copy) {\n      try {\n        subscriber(next, prev);\n      } catch (e) {\n        console.error(`Error invoking subscriber:`, e);\n      }\n    }\n  }\n\n  return {\n    // This could be undefined if T includes undefined, else it should never\n    // return undefined because the user has to always specify the default value.\n    get<T>(key: string): T {\n      return dataByKey.get(key) as T;\n    },\n\n    set<T>(key: string, value: T): void {\n      const prev = dataByKey.get(key) as T;\n\n      // Do nothing if no change.\n      if (prev === value) return;\n\n      dataByKey.set(key, value);\n      notify(key, value, prev);\n    },\n\n    delete(key: string): void {\n      dataByKey.delete(key);\n    },\n\n    setNoNotify<T>(key: string, value: T): void {\n      dataByKey.set(key, value);\n    },\n\n    // Subscribe to changes of a specific key\n    subscribe<T>(key: string, subscriber: Subscriber<T>): () => void {\n      let subscribers = subscribersByKey.get(key);\n      if (!subscribers) {\n        subscribers = new Set();\n        subscribersByKey.set(key, subscribers);\n      }\n\n      // Type coercion: we store Subscriber<unknown>\n      subscribers.add(subscriber as Subscriber<unknown>);\n\n      // Return unsubscribe function\n      return () => {\n        subscribers.delete(subscriber as Subscriber<unknown>);\n        if (subscribers.size === 0) subscribersByKey.delete(key);\n      };\n    },\n  } as const;\n}\n\nconst pubSubStore = createPubSubStore();\n\n/************************************************************************/\n/* Shared state implementation                                          */\n/************************************************************************/\n\nconst STORAGE_KEY = \"state\";\n\n/** Options to configure a shared state. */\nexport type SharedStateOptions<T> = {\n  lazyLoad?: boolean;\n} & StorageOptions<T>;\n\nlet stateKey = 0;\n\n/**\n * Create a new shared state object. Put this code at the top level scope:\n *\n * Example:\n * ```\n *   const counterState = sharedState<number>(0);\n * ```\n */\nexport function sharedState<T>(\n  defaultValue: T,\n  options?: SharedStateOptions<T>,\n) {\n  let readyResolve: () => void = () => {};\n\n  const readyPromise = new Promise<void>((resolve) => {\n    readyResolve = resolve;\n  });\n\n  const resolveReadyPromise = readyResolve;\n\n  const pubSubKey = String(stateKey++);\n\n  // Use max of 1 storage adapter per shared state.\n  const storageAdapter = getStorageAdapter(\n    options,\n    SharedStateConfig.storeExpiryMs,\n  );\n\n  // Always set the default value first to avoid returning undefineds if that\n  // is not part of T.\n  pubSubStore.setNoNotify(pubSubKey, defaultValue);\n\n  const lazyLoad = options?.lazyLoad;\n  const lazy = lazyLoad !== undefined ? lazyLoad : SharedStateConfig.lazyLoad;\n\n  const obj = {\n    /** Allow users to await for the completion of data init. */\n    readyPromise,\n\n    lazy,\n\n    initStarted: false,\n    initDone: false,\n\n    /** `subscribe` function required by useSyncExternalStore. */\n    subscribe(subscriber: () => void): () => void {\n      return pubSubStore.subscribe(pubSubKey, () => subscriber());\n    },\n\n    /** Returns true if there is a backing store. */\n    hasStore(): boolean {\n      return Boolean(storageAdapter);\n    },\n\n    /**\n     * Set a value directly into the store. Does nothing if there is no\n     * backing store.\n     *\n     * Warning: If you want to set the value properly, you should use\n     * `setValue()` instead which also updates the in-memory copy.\n     */\n    async setInStore(value: T): Promise<void> {\n      return await storageAdapter?.set(STORAGE_KEY, value);\n    },\n\n    /**\n     * Get a value directly from the store. Returns undefined if there is no\n     * backing store.\n     */\n    async getFromStore(): Promise<T | undefined> {\n      return await storageAdapter?.get(STORAGE_KEY);\n    },\n\n    /**\n     * Get the value of the shared state.\n     *  `getSnapshot` function — must return same ref if value unchanged.\n     * Note that this would return the default value if data init from store is\n     * not completed yet.\n     */\n    getSnapshot(): T {\n      return pubSubStore.get(pubSubKey);\n    },\n\n    /** Set the value of the shared state. */\n    setValue(next: SetStateAction<T>): void {\n      if (typeof next === \"function\") {\n        const prev = pubSubStore.get<T>(pubSubKey);\n        next = (next as (p: T) => T)(prev);\n      }\n\n      pubSubStore.set(pubSubKey, next);\n      void obj.setInStore(next);\n    },\n\n    /**\n     * Remove the value of the shared state. Actually this just sets the value\n     * back to the given default value.\n     */\n    delete() {\n      pubSubStore.set(pubSubKey, defaultValue);\n      void storageAdapter?.set(STORAGE_KEY, defaultValue);\n    },\n\n    /** Initial default handling. */\n    async initDefaultValueOnce() {\n      if (obj.initDone || obj.initStarted) return;\n      // @ts-expect-error ts(2540) - Assign to readonly property.\n      obj.initStarted = true;\n\n      const stored = await obj.getFromStore();\n      const value = stored !== undefined ? stored : defaultValue;\n\n      pubSubStore.set(pubSubKey, value);\n\n      // @ts-expect-error ts(2540) - Assign to readonly property.\n      obj.initDone = true;\n      resolveReadyPromise();\n    },\n  } as const;\n\n  if (!lazy) {\n    void obj.initDefaultValueOnce();\n  }\n\n  return obj;\n}\n\nexport type SharedState<T> = ReturnType<typeof sharedState<T>>;\n\n/**\n * React hook for subscribing to a key in the global store.\n *\n * Example:\n * ```\n *   const [counter, setCounter] = useSharedState(counterState);\n * ```\n */\nexport function useSharedState<T>(\n  state: SharedState<T>,\n): [T, Dispatch<SetStateAction<T>>] {\n  void state.initDefaultValueOnce();\n\n  const value = useSyncExternalStore(\n    (onStoreChange) => state.subscribe(onStoreChange),\n    () => state.getSnapshot(),\n    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.\n    () => state.getSnapshot(),\n  );\n\n  return [value, state.setValue];\n}\n\n/**\n * Same as useSharedState(), but returns the value only.\n *\n * Example:\n * ```\n *   const counter = useSharedStateValue(counterState);\n * ```\n */\nexport function useSharedStateValue<T>(state: SharedState<T>) {\n  return useSharedState(state)[0];\n}\n\n/**\n * Same as useSharedState(), but returns the setter only.\n *\n * Example:\n * ```\n *   const setCounter = useSharedStateSetter(counterState);\n * ```\n */\nexport function useSharedStateSetter<T>(state: SharedState<T>) {\n  void state.initDefaultValueOnce();\n\n  return state.setValue;\n}\n","/**\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":"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","names":["sharedState_exports","__export","SharedStateConfig","configureSharedState","sharedState","useSharedState","useSharedStateSetter","useSharedStateValue","__toCommonJS","import_timeConstants","import_react","import_kvStore","import_localStore","IS_NOT_BROWSER","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","config","localStoreAdapter","kvStoreAdapter","key","isValid","adapter","value","keyPrefix","fullKey","SharedStateConfig","configureSharedState","config","createPubSubStore","dataByKey","subscribersByKey","notify","key","next","prev","subscribers","copy","subscriber","e","value","pubSubStore","STORAGE_KEY","stateKey","sharedState","defaultValue","options","readyResolve","readyPromise","resolve","resolveReadyPromise","pubSubKey","storageAdapter","getStorageAdapter","lazyLoad","lazy","obj","stored","useSharedState","state","onStoreChange","useSharedStateValue","useSharedStateSetter"]}
+{"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/sharedState.min.cjs"],"names":[],"mappings":"AAAA,wIAAiD,oCAAiC,oCAAiC,sTAAiJ","file":"/Users/choksheaklau/src/react-utils/dist/sharedState.min.cjs"}

package/sharedState.min.mjs

@@ -1,2 +1,2 @@
-import{MS_PER_DAY as h}from"@choksheak/ts-utils/timeConstants";import{useSyncExternalStore as w}from"react";import{kvStore as S}from"@choksheak/ts-utils/kvStore";import{createLocalStore as b}from"@choksheak/ts-utils/localStore";var d=typeof window>"u";function y(r,i){let{store:n}=r??{};if(!n)return null;if("persistTo"in n&&typeof n.persistTo=="string"&&"key"in n&&typeof n.key=="string"){let o=n.expiryMs||i,e={...n,expiryMs:o};switch(n.persistTo){case"localStorage":return v(e);case"indexedDb":return m(e);default:throw n.persistTo,new Error(`Unknown store.adapter ${n.persistTo}`)}}return n}function v({key:r,expiryMs:i,isValid:n}){let o=b(r,{defaultExpiryMs:i});return{set:(e,t)=>{d||o.set(e,t)},get:e=>{if(d)return;let t=o.get(e);if(n&&!n(t)){console.warn(`localStorage adapter: Auto-discard invalid value for ${e}: ${JSON.stringify(t)}`),o.delete(e);return}return t},delete:e=>{d||o.delete(e)},clear:()=>{d||o.clear()}}}function m({key:r,expiryMs:i,isValid:n}){let o=r+":";return{set:async(e,t)=>{d||await S.set(o+e,t,i)},get:async e=>{if(d)return;let t=o+e,a=await S.get(t);if(a!==void 0&&n&&!n(a)){console.warn(`indexedDb adapter: Auto-discard invalid value for ${e}:`,a),await S.delete(t);return}return a},delete:async e=>{d||await S.delete(o+e)},clear:async()=>{d||await S.clear()}}}var g={storeExpiryMs:30*h,lazyLoad:!1};function L(r){Object.assign(g,r)}function x(){let r=new Map,i=new Map;function n(o,e,t){let a=i.get(o);if(!a)return;let p=Array.from(a.values());for(let f of p)try{f(e,t)}catch(u){console.error("Error invoking subscriber:",u)}}return{get(o){return r.get(o)},set(o,e){let t=r.get(o);t!==e&&(r.set(o,e),n(o,e,t))},delete(o){r.delete(o)},setNoNotify(o,e){r.set(o,e)},subscribe(o,e){let t=i.get(o);return t||(t=new Set,i.set(o,t)),t.add(e),()=>{t.delete(e),t.size===0&&i.delete(o)}}}}var c=x(),T="state",A=0;function N(r,i){let n=()=>{},o=new Promise(s=>{n=s}),e=n,t=String(A++),a=y(i,g.storeExpiryMs);c.setNoNotify(t,r);let p=i?.lazyLoad,f=p!==void 0?p:g.lazyLoad,u={readyPromise:o,lazy:f,initStarted:!1,initDone:!1,subscribe(s){return c.subscribe(t,()=>s())},hasStore(){return!!a},async setInStore(s){return await a?.set(T,s)},async getFromStore(){return await a?.get(T)},getSnapshot(){return c.get(t)},setValue(s){if(typeof s=="function"){let l=c.get(t);s=s(l)}c.set(t,s),u.setInStore(s)},delete(){c.set(t,r),a?.set(T,r)},async initDefaultValueOnce(){if(u.initDone||u.initStarted)return;u.initStarted=!0;let s=await u.getFromStore(),l=s!==void 0?s:r;c.set(t,l),u.initDone=!0,e()}};return f||u.initDefaultValueOnce(),u}function O(r){return r.initDefaultValueOnce(),[w(n=>r.subscribe(n),()=>r.getSnapshot(),()=>r.getSnapshot()),r.setValue]}function _(r){return O(r)[0]}function B(r){return r.initDefaultValueOnce(),r.setValue}export{g as SharedStateConfig,L as configureSharedState,N as sharedState,O as useSharedState,B as useSharedStateSetter,_ as useSharedStateValue};
+import{a,b,c,d,e,f}from"./chunk-KILGR7YA.min.mjs";import"./chunk-VHMO75EY.min.mjs";import"./chunk-MWDH7YON.min.mjs";export{a as SharedStateConfig,b as configureSharedState,c as sharedState,d as useSharedState,f as useSharedStateSetter,e as useSharedStateValue};
 //# sourceMappingURL=sharedState.min.mjs.map

package/sharedState.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sharedState.ts","../src/storage.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * The \"shared state\" is a React state that shares the same value across the\n * entire app. Users declare a shared state constant that can be reused across\n * multiple components with the same underlying value.\n *\n * Shared states provide persistence to local storage and/or indexed DB out of\n * the box, by using \"@choksheak/ts-utils\". Note that no matter if the shared\n * state uses persistence or not, it will always maintain a copy of the state\n * in memory. Persisted values can be configured with an automatic expiration\n * duration.\n *\n * This module is largely similar to the open source \"jotai\" npm library. You\n * can use shared states to replace \"jotai\" in your code, and optionally make\n * use of the persistence mechanism. A quick migration guide from jotai is:\n *\n * ```\n *   atom()          -->  sharedState()\n *   useAtom()       -->  useSharedState()\n *   useAtomValue()  -->  useSharedStateValue()\n *   useSetAtom()    -->  useSharedStateSetter()\n * ```\n *\n * Example:\n * ```\n *   import { sharedState, useSharedState } from \"@choksheak/react-utils/sharedState\";\n *\n *   // Create a new shared state in the top level scope.\n *   // The first argument is the default value, which is required.\n *   // The second argument is an options object, and is optional (defaults\n *   // to storing in memory only without any persistence).\n *   const usersState = sharedState(\n *     [], { store: { persistTo: \"indexedDb\", key: \"users\" }}\n *   );\n *\n *   export const UsersComponent: React.FC = () => {\n *     // Get both the value and the setter.\n *     const [users, setUsers] = useSharedState(usersState);\n *     ...\n *   };\n *\n *   export const ReadOnlyComponent: React.FC = () => {\n *     // Get the value only.\n *     const users = useSharedStateValue(usersState);\n *     ...\n *   };\n *\n *   export const WriteOnlyComponent: React.FC = () => {\n *     // Get the setter only.\n *     const setUsers = useSharedStateSetter(usersState);\n *     ...\n *   };\n * ```\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport { Dispatch, SetStateAction, useSyncExternalStore } from \"react\";\n\nimport { getStorageAdapter, StorageOptions } from \"./storage\";\n\n/************************************************************************/\n/* Global config                                                        */\n/************************************************************************/\n\n/**\n * These values are configurable by the user at any time.\n */\nexport const SharedStateConfig = {\n  /**\n   * Default duration for storage expiration in milliseconds. Initial value\n   * is 30 days, but can be changed to anything.\n   */\n  storeExpiryMs: 30 * MS_PER_DAY,\n\n  /**\n   * True to load from storage only on mount, false (default) to load in\n   * the top level scope when the shared state is defined.\n   */\n  lazyLoad: false,\n};\n\nexport type SharedStateConfig = typeof SharedStateConfig;\n\n/** Convenience function to update global defaults. */\nexport function configureSharedState(config: Partial<SharedStateConfig>) {\n  Object.assign(SharedStateConfig, config);\n}\n\n/************************************************************************/\n/* Pub-sub store\n/************************************************************************/\n\ntype Subscriber<T> = (next: T, prev: T) => void;\n\nfunction createPubSubStore() {\n  const dataByKey = new Map<string, unknown>();\n  const subscribersByKey = new Map<string, Set<Subscriber<unknown>>>();\n\n  function notify<T>(key: string, next: T, prev: T): void {\n    const subscribers = subscribersByKey.get(key);\n    if (!subscribers) return;\n\n    // Make copy to protect against mutation during iteration.\n    const copy = Array.from(subscribers.values());\n    for (const subscriber of copy) {\n      try {\n        subscriber(next, prev);\n      } catch (e) {\n        console.error(`Error invoking subscriber:`, e);\n      }\n    }\n  }\n\n  return {\n    // This could be undefined if T includes undefined, else it should never\n    // return undefined because the user has to always specify the default value.\n    get<T>(key: string): T {\n      return dataByKey.get(key) as T;\n    },\n\n    set<T>(key: string, value: T): void {\n      const prev = dataByKey.get(key) as T;\n\n      // Do nothing if no change.\n      if (prev === value) return;\n\n      dataByKey.set(key, value);\n      notify(key, value, prev);\n    },\n\n    delete(key: string): void {\n      dataByKey.delete(key);\n    },\n\n    setNoNotify<T>(key: string, value: T): void {\n      dataByKey.set(key, value);\n    },\n\n    // Subscribe to changes of a specific key\n    subscribe<T>(key: string, subscriber: Subscriber<T>): () => void {\n      let subscribers = subscribersByKey.get(key);\n      if (!subscribers) {\n        subscribers = new Set();\n        subscribersByKey.set(key, subscribers);\n      }\n\n      // Type coercion: we store Subscriber<unknown>\n      subscribers.add(subscriber as Subscriber<unknown>);\n\n      // Return unsubscribe function\n      return () => {\n        subscribers.delete(subscriber as Subscriber<unknown>);\n        if (subscribers.size === 0) subscribersByKey.delete(key);\n      };\n    },\n  } as const;\n}\n\nconst pubSubStore = createPubSubStore();\n\n/************************************************************************/\n/* Shared state implementation                                          */\n/************************************************************************/\n\nconst STORAGE_KEY = \"state\";\n\n/** Options to configure a shared state. */\nexport type SharedStateOptions<T> = {\n  lazyLoad?: boolean;\n} & StorageOptions<T>;\n\nlet stateKey = 0;\n\n/**\n * Create a new shared state object. Put this code at the top level scope:\n *\n * Example:\n * ```\n *   const counterState = sharedState<number>(0);\n * ```\n */\nexport function sharedState<T>(\n  defaultValue: T,\n  options?: SharedStateOptions<T>,\n) {\n  let readyResolve: () => void = () => {};\n\n  const readyPromise = new Promise<void>((resolve) => {\n    readyResolve = resolve;\n  });\n\n  const resolveReadyPromise = readyResolve;\n\n  const pubSubKey = String(stateKey++);\n\n  // Use max of 1 storage adapter per shared state.\n  const storageAdapter = getStorageAdapter(\n    options,\n    SharedStateConfig.storeExpiryMs,\n  );\n\n  // Always set the default value first to avoid returning undefineds if that\n  // is not part of T.\n  pubSubStore.setNoNotify(pubSubKey, defaultValue);\n\n  const lazyLoad = options?.lazyLoad;\n  const lazy = lazyLoad !== undefined ? lazyLoad : SharedStateConfig.lazyLoad;\n\n  const obj = {\n    /** Allow users to await for the completion of data init. */\n    readyPromise,\n\n    lazy,\n\n    initStarted: false,\n    initDone: false,\n\n    /** `subscribe` function required by useSyncExternalStore. */\n    subscribe(subscriber: () => void): () => void {\n      return pubSubStore.subscribe(pubSubKey, () => subscriber());\n    },\n\n    /** Returns true if there is a backing store. */\n    hasStore(): boolean {\n      return Boolean(storageAdapter);\n    },\n\n    /**\n     * Set a value directly into the store. Does nothing if there is no\n     * backing store.\n     *\n     * Warning: If you want to set the value properly, you should use\n     * `setValue()` instead which also updates the in-memory copy.\n     */\n    async setInStore(value: T): Promise<void> {\n      return await storageAdapter?.set(STORAGE_KEY, value);\n    },\n\n    /**\n     * Get a value directly from the store. Returns undefined if there is no\n     * backing store.\n     */\n    async getFromStore(): Promise<T | undefined> {\n      return await storageAdapter?.get(STORAGE_KEY);\n    },\n\n    /**\n     * Get the value of the shared state.\n     *  `getSnapshot` function — must return same ref if value unchanged.\n     * Note that this would return the default value if data init from store is\n     * not completed yet.\n     */\n    getSnapshot(): T {\n      return pubSubStore.get(pubSubKey);\n    },\n\n    /** Set the value of the shared state. */\n    setValue(next: SetStateAction<T>): void {\n      if (typeof next === \"function\") {\n        const prev = pubSubStore.get<T>(pubSubKey);\n        next = (next as (p: T) => T)(prev);\n      }\n\n      pubSubStore.set(pubSubKey, next);\n      void obj.setInStore(next);\n    },\n\n    /**\n     * Remove the value of the shared state. Actually this just sets the value\n     * back to the given default value.\n     */\n    delete() {\n      pubSubStore.set(pubSubKey, defaultValue);\n      void storageAdapter?.set(STORAGE_KEY, defaultValue);\n    },\n\n    /** Initial default handling. */\n    async initDefaultValueOnce() {\n      if (obj.initDone || obj.initStarted) return;\n      // @ts-expect-error ts(2540) - Assign to readonly property.\n      obj.initStarted = true;\n\n      const stored = await obj.getFromStore();\n      const value = stored !== undefined ? stored : defaultValue;\n\n      pubSubStore.set(pubSubKey, value);\n\n      // @ts-expect-error ts(2540) - Assign to readonly property.\n      obj.initDone = true;\n      resolveReadyPromise();\n    },\n  } as const;\n\n  if (!lazy) {\n    void obj.initDefaultValueOnce();\n  }\n\n  return obj;\n}\n\nexport type SharedState<T> = ReturnType<typeof sharedState<T>>;\n\n/**\n * React hook for subscribing to a key in the global store.\n *\n * Example:\n * ```\n *   const [counter, setCounter] = useSharedState(counterState);\n * ```\n */\nexport function useSharedState<T>(\n  state: SharedState<T>,\n): [T, Dispatch<SetStateAction<T>>] {\n  void state.initDefaultValueOnce();\n\n  const value = useSyncExternalStore(\n    (onStoreChange) => state.subscribe(onStoreChange),\n    () => state.getSnapshot(),\n    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.\n    () => state.getSnapshot(),\n  );\n\n  return [value, state.setValue];\n}\n\n/**\n * Same as useSharedState(), but returns the value only.\n *\n * Example:\n * ```\n *   const counter = useSharedStateValue(counterState);\n * ```\n */\nexport function useSharedStateValue<T>(state: SharedState<T>) {\n  return useSharedState(state)[0];\n}\n\n/**\n * Same as useSharedState(), but returns the setter only.\n *\n * Example:\n * ```\n *   const setCounter = useSharedStateSetter(counterState);\n * ```\n */\nexport function useSharedStateSetter<T>(state: SharedState<T>) {\n  void state.initDefaultValueOnce();\n\n  return state.setValue;\n}\n","/**\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":"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","names":["MS_PER_DAY","useSyncExternalStore","kvStore","createLocalStore","IS_NOT_BROWSER","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","config","localStoreAdapter","kvStoreAdapter","key","isValid","adapter","value","keyPrefix","fullKey","SharedStateConfig","MS_PER_DAY","configureSharedState","config","createPubSubStore","dataByKey","subscribersByKey","notify","key","next","prev","subscribers","copy","subscriber","e","value","pubSubStore","STORAGE_KEY","stateKey","sharedState","defaultValue","options","readyResolve","readyPromise","resolve","resolveReadyPromise","pubSubKey","storageAdapter","getStorageAdapter","lazyLoad","lazy","obj","stored","useSharedState","state","useSyncExternalStore","onStoreChange","useSharedStateValue","useSharedStateSetter"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}