@choksheak/react-utils 0.2.6 → 0.2.8

package/sharedQuery.d.ts

@@ -1,4 +1,6 @@
 /**
+ * @packageDocumentation
+ *
  * The "shared query" is a data fetching convenience library that helps users
  * to load data, check for staleness and expiration, cache in memory, local
  * storage or indexed db, and be able to manipulate the data anytime.
@@ -9,11 +11,81 @@
  * records and the total byte size of data can be limited so as to ensure the
  * query does not take up too much memory.
  *
- * @packageDocumentation
+ * Example:
+ * ```
+ *   import { sharedQuery, useSharedQuery } from "@choksheak/react-utils/sharedQuery";
+ *
+ *   // Create a new shared query in the top level scope.
+ *   // The query function `queryFn` here does not take any arguments.
+ *   //
+ *   // Only the queryName and queryFn are required and everything else is
+ *   // optional.
+ *   //
+ *   // The queryName must be unique, otherwise we will throw an
+ *   // error. This is because defining the same queryName for two different
+ *   // queries implies that the queries are the same, thus violating the idea
+ *   // of a "shared" query, and almost certainly points to a bug in the code.
+ *   export const usersQuery = sharedQuery({
+ *     queryName: "users",
+ *     queryFn: listUsers,
+ *     persistTo: "indexedDb",
+ *     staleMs: MS_PER_DAY,
+ *   });
+ *
+ *   // Note that the query will only start fetching on mount in React.
+ *   // But you can do `usersQuery.getCachedOrFetch()` here to prefetch the
+ *   // data if necessary.
+ *   usersQuery.getCachedOrFetch();
+ *
+ *   // Example of using a query function with arguments.
+ *   export const getUserQuery = sharedQuery({
+ *     queryName: "getUser",
+ *     queryFn: getUser, // getUser(userId: string) => User
+ *     persistTo: "indexedDb",
+ *     staleMs: MS_PER_DAY,
+ *   });
+ *
+ *   export const UsersComponent: React.FC = () => {
+ *     // Second argument is optional, and is an array of arguments to be
+ *     // passed to the `queryFn`.
+ *     const users = useSharedQuery(usersQuery);
+ *
+ *     return (
+ *       <>
+ *         <h1>List of Users</h1>
+ *
+ *         <button onclick={users.refetch}>Refresh</button>
+ *
+ *         {users.loading && <Loader />}
+ *
+ *         {users.error && !users.data && <p>Error: {String(users.error)}</p>}
+ *
+ *         <p>Data: {users.data ? JSON.stringify(users.data) : "-"}</p>
+ *       </>
+ *     );
+ *   };
+ *
+ *   export const AnotherComponent: React.FC = () => {
+ *      // This query will be deduped with the one above, sharing the same
+ *      // data and the same fetches.
+ *      const users = useSharedQuery(usersQuery);
+ *      ...
+ *   };
+ *
+ *   export const DisplayOneUser: React.FC<{userId: string}> = ({userId}) => {
+ *      // Example of using the query with an argument. Whenever the argument
+ *      // changes, the data will be fetched and updated automatically.
+ *      const user = useSharedQuery(getUserQuery, [userId]);
+ *
+ *      return <>User: {user.data ? JSON.stringify(user.data) : "-"}</>;
+ *   };
+ * ```
  */
 import { SharedState, SharedStateOptions } from "./sharedState";
+/** Type of the queryFn used to fetch the data from source. */
 export type QueryFn<TArgs extends unknown[], TData> = (...args: TArgs) => Promise<TData> | TData;
-export type QueryStateValue<TData> = {
+/** An entry for a persisted state corresponding to one query key. */
+export type QueryStateValue<TData> = Readonly<{
     /**
      * When this record was last updated. Used for LRU determination. If you want
      * the data age, please use `dataUpdatedMs` instead.
@@ -29,8 +101,14 @@ export type QueryStateValue<TData> = {
      */
     error?: unknown;
     errorUpdatedMs?: number;
-};
-export type UseQueryResult<TData> = QueryStateValue<TData> & {
+}>;
+/** Return type for useSharedQuery(). */
+export type UseQueryResult<TData> = QueryStateValue<TData> & Readonly<{
+    /**
+     * Return the last non-empty data if you want to display the last loaded data
+     * while waiting for the new data to load.
+     */
+    lastNonEmptyData: TData | undefined;
     /**
      * Cancels the inflight query (if any). Returns true if canceled.
      */
@@ -45,37 +123,93 @@ export type UseQueryResult<TData> = QueryStateValue<TData> & {
      */
     setData: (data: TData, dataUpdatedMs?: number) => void;
     deleteData: () => void;
-};
+}>;
+/** List of all available persistence options. */
 export type PersistTo = "localStorage" | "indexedDb";
 /**
  * The full query state is a record of all the fetch states mapped by
  * query key to the state entry.
  */
 export type SharedQueryState<TData> = Record<string, QueryStateValue<TData>>;
+/** Options to configure a shared query. */
 export type SharedQueryOptions<TArgs extends unknown[], TData> = {
+    /**
+     * The name could have been auto-generated, but we let the user give us a
+     * human-readable name that can be identified quickly in the logs.
+     * Note that the queryKey is a string formed by the queryName plus the query
+     * arguments.
+     */
     queryName: string;
+    /**
+     * Function to fetch data.
+     */
     queryFn: QueryFn<TArgs, TData>;
+    /**
+     * ms before data considered stale; 0 means always stale.
+     */
     staleMs?: number;
+    /**
+     * ms before data is removed from cache; 0 means never expire.
+     */
     expiryMs?: number;
+    /**
+     * Trigger background re-fetch if stale.
+     */
     refetchOnStale?: boolean;
+    /**
+     * Shortcut to set the localStorageKey or indexedDbKey automatically from
+     * queryName. This is important because it avoids requiring the user to
+     * specify the same queryName twice everytime.
+     */
     persistTo?: PersistTo;
+    /**
+     * Max number of entries to keep. The oldest entries will be discarded.
+     * The last record cannot be discarded. 0 means no limit.
+     */
     maxSize?: number;
+    /**
+     * Max number of bytes to keep. The oldest entries will be discarded.
+     * The last record cannot be discarded. 0 means no limit.
+     */
     maxBytes?: number;
+    /**
+     * Keep a copy of the last non-empty data so that when you change the
+     * query arguments, you can still display the old data while waiting for the
+     * new data to load.
+     */
+    keepLastNonEmptyData?: boolean;
+    /**
+     * Customize the logger.
+     */
     log?: (...args: unknown[]) => void;
 } & SharedStateOptions<SharedQueryState<TData>>;
 /** Users can override these values globally. */
 export declare const SharedQueryDefaults: {
+    /** Refetch on every page load. */
     staleMs: number;
+    /** Keep in cache for a long time. */
     expiryMs: number;
+    /** Always refetch automatically if the data is stale. */
     refetchOnStale: boolean;
+    /** No default persistence configured. */
     persistTo: PersistTo | undefined;
+    /** 100 is not too large, but please tweak accordingly. */
     maxSize: number;
+    /** 100kb limit before discarding old records. */
     maxBytes: number;
+    /** Default to log to console. */
     log: (...args: unknown[]) => void;
 };
+/** Please use sharedQuery() instead. */
 export declare class SharedQuery<TArgs extends unknown[], TData> {
     private readonly inflightQueries;
     readonly queryState: SharedState<SharedQueryState<TData>>;
+    /**
+     * Keep track of the mounted query keys. This handles the case where an
+     * earlier-started query returns later, and when it returns, it was already
+     * unmounted, thus making it eligible for clean up right after fetch.
+     */
+    private readonly mountedKeys;
     readonly queryName: string;
     private readonly queryFn;
     readonly expiryMs: number;
@@ -83,6 +217,7 @@ export declare class SharedQuery<TArgs extends unknown[], TData> {
     readonly refetchOnStale: boolean;
     readonly maxSize: number;
     readonly maxBytes: number;
+    readonly keepLastNonEmptyData: boolean;
     readonly log: (...args: unknown[]) => void;
     constructor(options: SharedQueryOptions<TArgs, TData>);
     /** Returns a key to identify requests based on the given args. */
@@ -143,6 +278,10 @@ export declare class SharedQuery<TArgs extends unknown[], TData> {
     deleteData(queryKey: string): void;
     /** Delete all currently cached data & all inflight promises. */
     clear(): void;
+    /** Keep track of mounted keys. */
+    mount(queryKey: string): void;
+    /** Clean up mounted keys. */
+    unmount(queryKey: string): void;
     /**
      * Discard the oldest entries if the size exceeds the limit. The last
      * remaining record cannot be deleted no matter what the limit is.

package/sharedQuery.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var F=Object.create;var T=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var _=Object.getPrototypeOf,j=Object.prototype.hasOwnProperty;var J=(i,e)=>{for(var t in e)T(i,t,{get:e[t],enumerable:!0})},Q=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of R(e))!j.call(i,a)&&a!==t&&T(i,a,{get:()=>e[a],enumerable:!(r=L(e,a))||r.enumerable});return i};var K=(i,e,t)=>(t=i!=null?F(_(i)):{},Q(e||!i||!i.__esModule?T(t,"default",{value:i,enumerable:!0}):t,i)),W=i=>Q(T({},"__esModule",{value:!0}),i);var X={};J(X,{SharedQuery:()=>x,SharedQueryDefaults:()=>h,sharedQuery:()=>I,useSharedQuery:()=>H});module.exports=W(X);var q=require("@choksheak/ts-utils/timeConstants"),S=K(require("object-sizeof")),p=require("react");var B=require("@choksheak/ts-utils/timeConstants"),z=require("react");var f=require("@choksheak/ts-utils/kvStore");function k(i,e){let{localStorageKey:t,indexedDbKey:r,storeExpiryMs:a,store:s}=i??{};if(s)return s;let n=a||e;return t?new w(t,n):r?new D(r,n):null}var w=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;window.localStorage.setItem(r,JSON.stringify({value:t,expiresAt:this.expiryMs?Date.now()+this.expiryMs:0}))}load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=window.localStorage.getItem(t);if(r)try{let a=JSON.parse(r);if(!a||a.expiresAt&&Date.now()>=a.expiresAt){window.localStorage.removeItem(t);return}return a.value}catch{window.localStorage.removeItem(t);return}}delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;window.localStorage.removeItem(t)}clear(){if(!(typeof window>"u"))for(let e of Object.keys(window.localStorage))e.startsWith(this.keyPrefix)&&window.localStorage.removeItem(e)}},D=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}async save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;await f.kvStore.set(r,JSON.stringify(t),this.expiryMs)}async load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=await f.kvStore.get(t);if(r!==void 0)try{return JSON.parse(r)}catch{await f.kvStore.delete(t);return}}async delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;await f.kvStore.delete(t)}async clear(){typeof window>"u"||await f.kvStore.forEach(async e=>{e.startsWith(this.keyPrefix)&&await f.kvStore.delete(e)})}};var O={storeExpiryMs:30*B.MS_PER_DAY,lazyLoad:!1},A=class{dataByKey=new Map;subscribersByKey=new Map;get(e){return this.dataByKey.get(e)}set(e,t){let r=this.dataByKey.get(e);r!==t&&(this.dataByKey.set(e,t),this.notify(e,t,r))}delete(e){this.dataByKey.delete(e)}setNoNotify(e,t){this.dataByKey.set(e,t)}subscribe(e,t){let r=this.subscribersByKey.get(e);return r||(r=new Set,this.subscribersByKey.set(e,r)),r.add(t),()=>{r.delete(t),r.size===0&&this.subscribersByKey.delete(e)}}notify(e,t,r){let a=this.subscribersByKey.get(e);if(!a)return;let s=Array.from(a.values());for(let n of s)try{n(t,r)}catch(l){console.error("Error invoking subscriber:",l)}}},g=new A,v="state",Y=0,M=class{constructor(e,t){this.defaultValue=e;this.pubSubKey=String(Y++),this.storageAdapter=k(t,O.storeExpiryMs),this.setValueBounded=s=>this.setValue(s),g.setNoNotify(this.pubSubKey,e);let r=t?.lazyLoad;(r!==void 0?r:O.lazyLoad)||this.initDefaultValueOnce()}pubSubKey;storageAdapter;setValueBounded;initDone=!1;subscribe(e){return g.subscribe(this.pubSubKey,()=>e())}getSnapshot(){return g.get(this.pubSubKey)}setValue(e){if(typeof e=="function"){let t=g.get(this.pubSubKey);e=e(t)}g.set(this.pubSubKey,e),this.storageAdapter?.save(v,e)}delete(){g.set(this.pubSubKey,this.defaultValue),this.storageAdapter?.save(v,this.defaultValue)}async initDefaultValueOnce(){if(this.initDone)return;this.initDone=!0;let e=await this.storageAdapter?.load(v);g.set(this.pubSubKey,e!==void 0?e:this.defaultValue)}};function V(i,e){return new M(i,e)}function P(i){return i.initDefaultValueOnce(),[(0,z.useSyncExternalStore)(t=>i.subscribe(t),()=>i.getSnapshot(),()=>i.getSnapshot()),i.setValueBounded]}function E(i){let e=new Set;return JSON.stringify(i,(t,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(e.has(r))return"[Circular]";if(e.add(r),r!==i)try{JSON.stringify(r)}catch{return"[Unserializable]"}return Object.keys(r).sort().reduce((a,s)=>(a[s]=r[s],a),{})})}var $=K(require("lodash/isEqual")),m=require("react");function N(i){let[e,t]=(0,m.useState)(i);return(0,m.useMemo)(()=>e===i||(0,$.default)(e,i)?e:(t(i),i),[e,i])}var h={staleMs:0,expiryMs:30*q.MS_PER_DAY,refetchOnStale:!0,persistTo:void 0,maxSize:100,maxBytes:1e5,log:(...i)=>console.log("[sharedQuery]",...i)},x=class{inflightQueries=new Map;queryState;queryName;queryFn;expiryMs;staleMs;refetchOnStale;maxSize;maxBytes;log;constructor(e){if(this.queryName=e.queryName,this.queryFn=e.queryFn,this.staleMs=e?.staleMs??h.staleMs,this.expiryMs=e?.expiryMs??h.expiryMs,this.refetchOnStale=e?.refetchOnStale??h.refetchOnStale,!e.localStorageKey&&!e.indexedDbKey){let t=e.persistTo??h.persistTo;t==="localStorage"?e.localStorageKey=e.queryName:t==="indexedDb"&&(e.indexedDbKey=e.queryName)}this.maxSize=e?.maxSize??h.maxSize,this.maxBytes=e?.maxBytes??h.maxBytes,this.log=e?.log??h.log,this.queryState=V({},{...e,storeExpiryMs:e?.storeExpiryMs||this.expiryMs})}getQueryKey(e){return this.queryName+":"+E(e)}getAbortController(e){let t=this.getQueryKey(e);return this.getAbortControllerByKey(t)}getAbortControllerByKey(e){return this.inflightQueries.get(e)?.abortController??null}getAbortSignal(e){let t=this.getQueryKey(e);return this.getAbortSignalByKey(t)}getAbortSignalByKey(e){return this.getAbortControllerByKey(e)?.signal??null}isStale(e){return this.staleMs===0?!0:Date.now()-e>this.staleMs}isExpired(e){return this.expiryMs===0?!1:Date.now()-e>this.expiryMs}async getCachedOrFetch(...e){let t=this.getQueryKey(e),r=this.queryState.getSnapshot()?.[t];return r?.data&&!this.isExpired(r.dataUpdatedMs??0)?this.isStale(r.dataUpdatedMs??0)?(this.refetchOnStale&&(this.log(`refetchOnStale for ${t}`),this.dedupedFetch(t,...e)),this.log(`Returning stale data for ${t}`),r.data):(this.log(`Return fresh data ${t} from cache without fetching`),r.data):await this.dedupedFetch(t,...e)}dedupedFetch(e,...t){let r=this.inflightQueries.get(e);if(r)return this.log(`Deduplicating inflight fetch for ${e}`),r.promise;let a=this.startFetching(e,t),s=new AbortController;return this.inflightQueries.set(e,{promise:a,abortController:s}),a}async startFetching(e,t){this.log(`Start fetching ${e}`);try{let r=await this.queryFn(...t);return this.log(`Successfully fetched ${e}`),this.setData(e,r,Date.now()),r}catch(r){throw this.log(`Failed to fetch ${e}: ${r}`),r}finally{this.inflightQueries.delete(e)}}getQueryValue(e){return this.queryState.getSnapshot()?.[e]}getData(e){return this.queryState.getSnapshot()?.[e]?.data}setData(e,t,r=Date.now()){let a={lastUpdatedMs:Date.now(),loading:!1,data:t,dataUpdatedMs:r};this.queryState.setValue(s=>({...s,[e]:a})),this.enforceSizeLimit()}async updateFromSource(...e){let t=this.getQueryKey(e);return await this.dedupedFetch(t,...e)}deleteData(e){let r={...this.queryState.getSnapshot()};delete r[e],this.queryState.setValue(r);let a=this.inflightQueries.get(e);a&&(this.inflightQueries.delete(e),a.abortController.abort("Deleted"))}clear(){this.queryState.delete();for(let{abortController:e}of Array.from(this.inflightQueries.values()))e.abort("Cleared");this.inflightQueries.clear()}enforceSizeLimit(){if(!this.maxSize&&!this.maxBytes)return;let e=this.queryState.getSnapshot(),t=Object.keys(e).length;if(t<=1)return;let r=(0,S.default)(e),a=e,s=!1;if(this.maxSize){let n=t-this.maxSize;n>0&&(this.log(`enforceSizeLimit for ${this.queryName} needed due to size ${t} > ${this.maxSize}`),a={...a},s=!0,Object.entries(a).sort((l,c)=>c[1].lastUpdatedMs-l[1].lastUpdatedMs).slice(-n).forEach(([l])=>{delete a[l]}))}if(this.maxBytes&&Object.keys(a).length>1){let n=s?(0,S.default)(a):r,l=n-this.maxBytes;if(l>0){this.log(`enforceSizeLimit for ${this.queryName} needed due to byte size ${n.toLocaleString()} > ${this.maxBytes.toLocaleString()}`),s||(a={...a},s=!0);let c=Object.entries(a).sort((y,d)=>y[1].lastUpdatedMs-d[1].lastUpdatedMs);for(let y=0;y<c.length-1&&l>0;y++){let d=c[y][0],u=(0,S.default)(d)+(0,S.default)(a[d]);delete a[d],l-=u}}}if(s){this.queryState.setValue(a),this.log(`Trimmed data for ${this.queryName}: size=(${t} -> ${Object.keys(a).length}) (limit=${this.maxSize}), byteSize=(${r.toLocaleString()} -> ${(0,S.default)(a).toLocaleString()}) (limit=${this.maxBytes.toLocaleString()})`);return}this.log(`No need to trim data for ${this.queryName}: size=${t} (limit=${this.maxSize}), byteSize=${r.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`)}},U=new Set;function I(i){if(U.has(i.queryName))throw new Error(`Duplicate shared query "${i.queryName}"`);return U.add(i.queryName),new x(i)}var G={lastUpdatedMs:0,loading:!0};function H(i,e=[]){let t=N(e),[r,a]=P(i.queryState),s=(0,p.useRef)(!0),n=(0,p.useMemo)(()=>i.getQueryKey(t),[i,t]),l=r[n],c=(0,p.useCallback)(d=>{a(u=>{let o={...u};return o[n]=typeof d=="function"?d(o[n]):d,o})},[n,a]),y=(0,p.useCallback)(async d=>{i.log(`Begin executing shared query ${n}`),c(u=>({...u??{},lastUpdatedMs:Date.now(),loading:!0}));try{let u=await(d?i.updateFromSource(...t):i.getCachedOrFetch(...t));if(s.current){let o=Date.now();c({lastUpdatedMs:o,loading:!1,data:u,dataUpdatedMs:o})}}catch(u){if(s.current){let o=Date.now();c(b=>({...b??{},lastUpdatedMs:o,loading:!1,error:u,errorUpdatedMs:o}))}}},[i,n,c,t]);return(0,p.useEffect)(()=>(s.current=!0,y(!1),()=>{s.current=!1}),[y]),(0,p.useMemo)(()=>({...l??G,abortCurrentQuery:u=>{let o=i.getAbortControllerByKey(n);return o?.abort(u),!!o},refetch:()=>{y(!0)},setData:(u,o)=>{let b=Date.now();c(C=>({...C??{},data:u,dataUpdatedMs:o??b,lastUpdatedMs:b,loading:!1}))},deleteData:()=>{a(u=>{let o={...u};return delete o[n],o})}}),[y,i,n,l,a,c])}0&&(module.exports={SharedQuery,SharedQueryDefaults,sharedQuery,useSharedQuery});
+"use strict";var q=Object.create;var T=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var J=Object.getPrototypeOf,W=Object.prototype.hasOwnProperty;var Y=(i,e)=>{for(var t in e)T(i,t,{get:e[t],enumerable:!0})},k=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of j(e))!W.call(i,a)&&a!==t&&T(i,a,{get:()=>e[a],enumerable:!(r=_(e,a))||r.enumerable});return i};var B=(i,e,t)=>(t=i!=null?q(J(i)):{},k(e||!i||!i.__esModule?T(t,"default",{value:i,enumerable:!0}):t,i)),I=i=>k(T({},"__esModule",{value:!0}),i);var Z={};Y(Z,{SharedQuery:()=>w,SharedQueryDefaults:()=>h,sharedQuery:()=>H,useSharedQuery:()=>X});module.exports=I(Z);var R=require("@choksheak/ts-utils/timeConstants"),b=B(require("object-sizeof")),u=require("react");var E=require("@choksheak/ts-utils/timeConstants"),z=require("react");var f=require("@choksheak/ts-utils/kvStore");function N(i,e){let{localStorageKey:t,indexedDbKey:r,storeExpiryMs:a,store:n}=i??{};if(n)return n;let s=a||e;return t?new A(t,s):r?new M(r,s):null}var A=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;window.localStorage.setItem(r,JSON.stringify({value:t,expiresAt:this.expiryMs?Date.now()+this.expiryMs:0}))}load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=window.localStorage.getItem(t);if(r)try{let a=JSON.parse(r);if(!a||a.expiresAt&&Date.now()>=a.expiresAt){window.localStorage.removeItem(t);return}return a.value}catch{window.localStorage.removeItem(t);return}}delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;window.localStorage.removeItem(t)}clear(){if(!(typeof window>"u"))for(let e of Object.keys(window.localStorage))e.startsWith(this.keyPrefix)&&window.localStorage.removeItem(e)}},M=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}async save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;await f.kvStore.set(r,JSON.stringify(t),this.expiryMs)}async load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=await f.kvStore.get(t);if(r!==void 0)try{return JSON.parse(r)}catch{await f.kvStore.delete(t);return}}async delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;await f.kvStore.delete(t)}async clear(){typeof window>"u"||await f.kvStore.forEach(async e=>{e.startsWith(this.keyPrefix)&&await f.kvStore.delete(e)})}};var O={storeExpiryMs:30*E.MS_PER_DAY,lazyLoad:!1},K=class{dataByKey=new Map;subscribersByKey=new Map;get(e){return this.dataByKey.get(e)}set(e,t){let r=this.dataByKey.get(e);r!==t&&(this.dataByKey.set(e,t),this.notify(e,t,r))}delete(e){this.dataByKey.delete(e)}setNoNotify(e,t){this.dataByKey.set(e,t)}subscribe(e,t){let r=this.subscribersByKey.get(e);return r||(r=new Set,this.subscribersByKey.set(e,r)),r.add(t),()=>{r.delete(t),r.size===0&&this.subscribersByKey.delete(e)}}notify(e,t,r){let a=this.subscribersByKey.get(e);if(!a)return;let n=Array.from(a.values());for(let s of n)try{s(t,r)}catch(y){console.error("Error invoking subscriber:",y)}}},g=new K,v="state",G=0,Q=class{constructor(e,t){this.defaultValue=e;this.pubSubKey=String(G++),this.storageAdapter=N(t,O.storeExpiryMs),this.setValueBounded=n=>{this.setValue(n)},g.setNoNotify(this.pubSubKey,e);let r=t?.lazyLoad;(r!==void 0?r:O.lazyLoad)||this.initDefaultValueOnce()}pubSubKey;storageAdapter;setValueBounded;initDone=!1;subscribe(e){return g.subscribe(this.pubSubKey,()=>e())}getSnapshot(){return g.get(this.pubSubKey)}setValue(e){if(typeof e=="function"){let t=g.get(this.pubSubKey);e=e(t)}g.set(this.pubSubKey,e),this.storageAdapter?.save(v,e)}delete(){g.set(this.pubSubKey,this.defaultValue),this.storageAdapter?.save(v,this.defaultValue)}async initDefaultValueOnce(){if(this.initDone)return;this.initDone=!0;let e=await this.storageAdapter?.load(v);g.set(this.pubSubKey,e!==void 0?e:this.defaultValue)}};function $(i,e){return new Q(i,e)}function P(i){return i.initDefaultValueOnce(),[(0,z.useSyncExternalStore)(t=>i.subscribe(t),()=>i.getSnapshot(),()=>i.getSnapshot()),i.setValueBounded]}function V(i){let e=new Set;return JSON.stringify(i,(t,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(e.has(r))return"[Circular]";if(e.add(r),r!==i)try{JSON.stringify(r)}catch{return"[Unserializable]"}return Object.keys(r).sort().reduce((a,n)=>(a[n]=r[n],a),{})})}var C=B(require("lodash/isEqual")),x=require("react");function U(i){let[e,t]=(0,x.useState)(i);return(0,x.useMemo)(()=>e===i||(0,C.default)(e,i)?e:(t(i),i),[e,i])}var h={staleMs:0,expiryMs:30*R.MS_PER_DAY,refetchOnStale:!0,persistTo:void 0,maxSize:100,maxBytes:1e5,log:(...i)=>console.log("[sharedQuery]",...i)},w=class{inflightQueries=new Map;queryState;mountedKeys=new Map;queryName;queryFn;expiryMs;staleMs;refetchOnStale;maxSize;maxBytes;keepLastNonEmptyData;log;constructor(e){if(this.queryName=e.queryName,this.queryFn=e.queryFn,this.staleMs=e?.staleMs??h.staleMs,this.expiryMs=e?.expiryMs??h.expiryMs,this.refetchOnStale=e?.refetchOnStale??h.refetchOnStale,!e.localStorageKey&&!e.indexedDbKey){let t=e.persistTo??h.persistTo;t==="localStorage"?e.localStorageKey=e.queryName:t==="indexedDb"&&(e.indexedDbKey=e.queryName)}this.maxSize=e?.maxSize??h.maxSize,this.maxBytes=e?.maxBytes??h.maxBytes,this.keepLastNonEmptyData=!!e?.keepLastNonEmptyData,this.log=e?.log??h.log,this.queryState=$({},{...e,storeExpiryMs:e?.storeExpiryMs||this.expiryMs})}getQueryKey(e){return this.queryName+":"+V(e)}getAbortController(e){let t=this.getQueryKey(e);return this.getAbortControllerByKey(t)}getAbortControllerByKey(e){return this.inflightQueries.get(e)?.abortController??null}getAbortSignal(e){let t=this.getQueryKey(e);return this.getAbortSignalByKey(t)}getAbortSignalByKey(e){return this.getAbortControllerByKey(e)?.signal??null}isStale(e){return this.staleMs===0?!0:Date.now()-e>this.staleMs}isExpired(e){return this.expiryMs===0?!1:Date.now()-e>this.expiryMs}async getCachedOrFetch(...e){let t=this.getQueryKey(e),r=this.queryState.getSnapshot()?.[t];return r?.data&&!this.isExpired(r.dataUpdatedMs??0)?this.isStale(r.dataUpdatedMs??0)?(this.refetchOnStale&&(this.log(`refetchOnStale for ${t}`),this.dedupedFetch(t,...e)),this.log(`Returning stale data for ${t}`),r.data):(this.log(`Return fresh data ${t} from cache without fetching`),r.data):await this.dedupedFetch(t,...e)}dedupedFetch(e,...t){let r=this.inflightQueries.get(e);if(r)return this.log(`Deduplicating inflight fetch for ${e}`),r.promise;let a=this.startFetching(e,t),n=new AbortController;return this.inflightQueries.set(e,{promise:a,abortController:n}),a}async startFetching(e,t){this.log(`Start fetching ${e}`);try{let r=await this.queryFn(...t);return this.log(`Successfully fetched ${e}`),this.setData(e,r,Date.now()),r}catch(r){throw this.log(`Failed to fetch ${e}: ${r}`),r}finally{this.inflightQueries.delete(e)}}getQueryValue(e){return this.queryState.getSnapshot()?.[e]}getData(e){return this.queryState.getSnapshot()?.[e]?.data}setData(e,t,r=Date.now()){let a={lastUpdatedMs:Date.now(),loading:!1,data:t,dataUpdatedMs:r};this.queryState.setValue(n=>({...n,[e]:a})),this.enforceSizeLimit()}async updateFromSource(...e){let t=this.getQueryKey(e);return await this.dedupedFetch(t,...e)}deleteData(e){let r={...this.queryState.getSnapshot()};delete r[e],this.queryState.setValue(r);let a=this.inflightQueries.get(e);a&&(this.inflightQueries.delete(e),a.abortController.abort("Deleted"))}clear(){this.queryState.delete();for(let{abortController:e}of Array.from(this.inflightQueries.values()))e.abort("Cleared");this.inflightQueries.clear()}mount(e){this.mountedKeys.set(e,(this.mountedKeys.get(e)??0)+1)}unmount(e){let t=this.mountedKeys.get(e);t===1?this.mountedKeys.delete(e):this.mountedKeys.set(e,(t??0)-1)}enforceSizeLimit(){if(!this.maxSize&&!this.maxBytes)return;let e=this.queryState.getSnapshot(),t=Object.keys(e).length;if(t<=1)return;let r=(0,b.default)(e),a=this.maxSize?t-this.maxSize:0,n=this.maxBytes?r-this.maxBytes:0;if(a<=0&&n<=0){this.log(`No need to trim data for ${this.queryName}: size=${t} (limit=${this.maxSize}), byteSize=${r.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`);return}this.log(`Need to trim ${this.queryName}: numToCut=${a}, bytesToCut=${n}`);let s={...e},y=!1,p=Object.entries(s).sort((d,S)=>d[1].lastUpdatedMs-S[1].lastUpdatedMs);for(let[d]of p){if(this.mountedKeys.has(d)){this.log(`Cannot clean up ${d} as it is mounted`);continue}let S=(0,b.default)(d)+(0,b.default)(s[d]);if(this.log(`Cleaning up unmounted ${d} (byteSize=${S.toLocaleString()})`),a--,n-=S,delete s[d],y=!0,a<=0&&n<=0)break}if(!y){this.log(`No trimmable entries found for ${this.queryName}: size=${t} (limit=${this.maxSize}), byteSize=${r.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`);return}this.queryState.setValue(s),this.log(`Trimmed data for ${this.queryName}: size=[${t} -> ${Object.keys(s).length}] (limit=${this.maxSize}), byteSize=[${r.toLocaleString()} -> ${(0,b.default)(s).toLocaleString()}] (limit=${this.maxBytes.toLocaleString()})`)}},F=new Set;function H(i){if(F.has(i.queryName))throw new Error(`Duplicate shared query "${i.queryName}"`);return F.add(i.queryName),new w(i)}var L={lastUpdatedMs:0,loading:!0};function X(i,e=[]){let t=U(e),[r,a]=P(i.queryState),n=(0,u.useRef)(!0),s=(0,u.useMemo)(()=>i.getQueryKey(t),[i,t]),y=r[s]??L,p=(0,u.useCallback)(c=>{a(o=>{let l={...o};return l[s]=typeof c=="function"?c(l[s]??L):c,l})},[s,a]),[d,S]=(0,u.useState)();(0,u.useEffect)(()=>{i.keepLastNonEmptyData&&y.data!==void 0&&S(y.data)},[i.keepLastNonEmptyData,y.data]);let m=(0,u.useCallback)(async c=>{i.log(`Begin executing shared query ${s}`),p(o=>({...o,lastUpdatedMs:Date.now(),loading:!0}));try{let o=await(c?i.updateFromSource(...t):i.getCachedOrFetch(...t));if(n.current){let l=Date.now();p({lastUpdatedMs:l,loading:!1,data:o,dataUpdatedMs:l})}}catch(o){if(n.current){let l=Date.now();p(D=>({...D,lastUpdatedMs:l,loading:!1,error:o,errorUpdatedMs:l}))}}},[i,s,p,t]);return(0,u.useEffect)(()=>(n.current=!0,i.mount(s),m(!1),()=>{n.current=!1,i.unmount(s)}),[m,i,s]),(0,u.useMemo)(()=>({...y,lastNonEmptyData:d,abortCurrentQuery:c=>{let o=i.getAbortControllerByKey(s);return o?.abort(c),!!o},refetch:()=>{m(!0)},setData:(c,o)=>{let l=Date.now();p(D=>({...D,data:c,dataUpdatedMs:o??l,lastUpdatedMs:l,loading:!1}))},deleteData:()=>{a(c=>{let o={...c};return delete o[s],o})}}),[m,d,i,s,y,a,p])}0&&(module.exports={SharedQuery,SharedQueryDefaults,sharedQuery,useSharedQuery});
 //# sourceMappingURL=sharedQuery.min.cjs.map

package/sharedQuery.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sharedQuery.ts","../src/sharedState.ts","../src/utils/storage.ts","../src/utils/stringify.ts","../src/utils/useDeepMemo.ts"],"sourcesContent":["/**\n * The \"shared query\" is a data fetching convenience library that helps users\n * to load data, check for staleness and expiration, cache in memory, local\n * storage or indexed db, and be able to manipulate the data anytime.\n *\n * Each shared query creates a new private shared state that handles the data\n * storage. This shared state contains the records for all queries, where each\n * query is a unique set of arguments used to make the query. The number of\n * records and the total byte size of data can be limited so as to ensure the\n * query does not take up too much memory.\n *\n * @packageDocumentation\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport getByteSize from \"object-sizeof\";\nimport { useCallback, useEffect, useMemo, useRef } from \"react\";\n\nimport {\n  SharedState,\n  sharedState,\n  SharedStateOptions,\n  useSharedState,\n} from \"./sharedState\";\nimport { stringifyDeterministicForKeys } from \"./utils/stringify\";\nimport { useDeepMemo } from \"./utils/useDeepMemo\";\n\nexport type QueryFn<TArgs extends unknown[], TData> = (\n  ...args: TArgs\n) => Promise<TData> | TData;\n\nexport type QueryStateValue<TData> = {\n  /**\n   * When this record was last updated. Used for LRU determination. If you want\n   * the data age, please use `dataUpdatedMs` instead.\n   */\n  lastUpdatedMs: number;\n\n  loading: boolean;\n  data?: TData;\n  dataUpdatedMs?: number;\n\n  /**\n   * Use unknown type for error because we can't assume what type of variable\n   * will be thrown from the query function. We also don't want to add this\n   * type to QueryStateValue<TError> as it adds complexity to the type.\n   */\n  error?: unknown;\n\n  errorUpdatedMs?: number;\n};\n\nexport type UseQueryResult<TData> = QueryStateValue<TData> & {\n  /**\n   * Cancels the inflight query (if any). Returns true if canceled.\n   */\n  abortCurrentQuery: (reason?: unknown) => boolean;\n\n  /**\n   * Manually refresh the data by doing a new query.\n   */\n  refetch: () => void;\n\n  /**\n   * If you got the data from somewhere else (e.g. an in-memory data update),\n   * just set it directly.\n   */\n  setData: (data: TData, dataUpdatedMs?: number) => void;\n\n  deleteData: () => void;\n};\n\nexport type PersistTo = \"localStorage\" | \"indexedDb\";\n\n/**\n * The full query state is a record of all the fetch states mapped by\n * query key to the state entry.\n */\nexport type SharedQueryState<TData> = Record<string, QueryStateValue<TData>>;\n\nexport type SharedQueryOptions<TArgs extends unknown[], TData> = {\n  // The name could have been auto-generated, but we let the user give us a\n  // human-readable name that can be identified quickly in the logs.\n  queryName: string;\n\n  // Function to fetch data.\n  queryFn: QueryFn<TArgs, TData>;\n\n  // ms before data considered stale; 0 means always stale.\n  staleMs?: number;\n\n  // ms before data is removed from cache; 0 means never expire.\n  expiryMs?: number;\n\n  // Trigger background re-fetch if stale.\n  refetchOnStale?: boolean;\n\n  // Shortcut to set the localStorageKey or indexedDbKey automatically from\n  // queryName. This is important because it avoids requiring the user to\n  // specify the same queryName twice everytime.\n  persistTo?: PersistTo;\n\n  // Max number of entries to keep. The oldest entries will be discarded.\n  // The last record cannot be discarded. 0 means no limit.\n  maxSize?: number;\n\n  // Max number of bytes to keep. The oldest entries will be discarded.\n  // The last record cannot be discarded. 0 means no limit.\n  maxBytes?: number;\n\n  // Customize the logger.\n  log?: (...args: unknown[]) => void;\n} & SharedStateOptions<SharedQueryState<TData>>;\n\n/** Users can override these values globally. */\nexport const SharedQueryDefaults = {\n  // Refetch on every page load.\n  staleMs: 0,\n\n  // Keep in cache for a long time.\n  expiryMs: 30 * MS_PER_DAY,\n\n  // Always refetch automatically if the data is stale.\n  refetchOnStale: true,\n\n  // No default persistence configured.\n  persistTo: undefined as PersistTo | undefined,\n\n  // 100 is not too large, but please tweak accordingly.\n  maxSize: 100,\n\n  // 100kb limit before discarding old records.\n  maxBytes: 100_000,\n\n  // Default to log to console.\n  log: (...args: unknown[]) => console.log(\"[sharedQuery]\", ...args),\n};\n\nexport class SharedQuery<TArgs extends unknown[], TData> {\n  private readonly inflightQueries = new Map<\n    string,\n    { promise: Promise<TData>; abortController: AbortController }\n  >();\n\n  public readonly queryState: SharedState<SharedQueryState<TData>>;\n\n  public readonly queryName: string;\n  private readonly queryFn: QueryFn<TArgs, TData>;\n  public readonly expiryMs: number;\n  public readonly staleMs: number;\n  public readonly refetchOnStale: boolean;\n  public readonly maxSize: number;\n  public readonly maxBytes: number;\n  public readonly log: (...args: unknown[]) => void;\n\n  public constructor(options: SharedQueryOptions<TArgs, TData>) {\n    this.queryName = options.queryName;\n    this.queryFn = options.queryFn;\n\n    this.staleMs = options?.staleMs ?? SharedQueryDefaults.staleMs;\n    this.expiryMs = options?.expiryMs ?? SharedQueryDefaults.expiryMs;\n\n    this.refetchOnStale =\n      options?.refetchOnStale ?? SharedQueryDefaults.refetchOnStale;\n\n    // Apply shortcut when using `persistTo`.\n    // Specifying the storage keys will take precedence over `persistTo`.\n    if (!options.localStorageKey && !options.indexedDbKey) {\n      const persistTo = options.persistTo ?? SharedQueryDefaults.persistTo;\n\n      if (persistTo === \"localStorage\") {\n        options.localStorageKey = options.queryName;\n      } else if (persistTo === \"indexedDb\") {\n        options.indexedDbKey = options.queryName;\n      }\n    }\n\n    this.maxSize = options?.maxSize ?? SharedQueryDefaults.maxSize;\n    this.maxBytes = options?.maxBytes ?? SharedQueryDefaults.maxBytes;\n\n    this.log = options?.log ?? SharedQueryDefaults.log;\n\n    this.queryState = sharedState<SharedQueryState<TData>>(\n      {}, // defaultValue\n      {\n        ...options,\n        // Fallback to use expiryMs for the storeExpiryMs.\n        storeExpiryMs: options?.storeExpiryMs || this.expiryMs,\n      },\n    );\n  }\n\n  /** Returns a key to identify requests based on the given args. */\n  public getQueryKey(args: TArgs): string {\n    return this.queryName + \":\" + stringifyDeterministicForKeys(args);\n  }\n\n  /**\n   * Get the AbortController to abort the inflight query (if any).\n   *\n   * Note that once you get the controller, you can also get the signal easily\n   * using `controller.signal`. So if you need both the controller and the\n   * signal, just use this function.\n   */\n  public getAbortController(args: TArgs): AbortController | null {\n    const queryKey = this.getQueryKey(args);\n    return this.getAbortControllerByKey(queryKey);\n  }\n\n  public getAbortControllerByKey(queryKey: string): AbortController | null {\n    return this.inflightQueries.get(queryKey)?.abortController ?? null;\n  }\n\n  /**\n   * Get the AbortSignal to check for query abortions.\n   *\n   * Example:\n   * ```\n   *   const getUserQuery = sharedQuery({\n   *     queryName: \"getUser\",\n   *     queryFn: (userId: string) => {\n   *       // Get the signal for this current execution.\n   *       const signal = getUserQuery.getAbortSignal([userId]);\n   *\n   *       // Pass the signal to fetch so that it can be aborted.\n   *       const response = await fetch(`/users/${userId}`, { signal });\n   *\n   *       // Check for errors.\n   *       if (!response.ok) {\n   *         throw new Error(response.statusText);\n   *       }\n   *\n   *       // Return the data.\n   *       return await response.json();\n   *     },\n   *   });\n   * ```\n   */\n  public getAbortSignal(args: TArgs): AbortSignal | null {\n    const queryKey = this.getQueryKey(args);\n    return this.getAbortSignalByKey(queryKey);\n  }\n\n  public getAbortSignalByKey(queryKey: string): AbortSignal | null {\n    return this.getAbortControllerByKey(queryKey)?.signal ?? null;\n  }\n\n  private isStale(dataUpdatedMs: number): boolean {\n    if (this.staleMs === 0) return true; // always stale\n\n    const ageMs = Date.now() - dataUpdatedMs;\n    return ageMs > this.staleMs;\n  }\n\n  private isExpired(dataUpdatedMs: number): boolean {\n    if (this.expiryMs === 0) return false; // never expire\n\n    const ageMs = Date.now() - dataUpdatedMs;\n    return ageMs > this.expiryMs;\n  }\n\n  public async getCachedOrFetch(...args: TArgs): Promise<TData> {\n    const queryKey = this.getQueryKey(args);\n    const cached = this.queryState.getSnapshot()?.[queryKey];\n\n    if (cached?.data && !this.isExpired(cached.dataUpdatedMs ?? 0)) {\n      // Return cached value if not stale.\n      if (!this.isStale(cached.dataUpdatedMs ?? 0)) {\n        this.log(`Return fresh data ${queryKey} from cache without fetching`);\n        return cached.data;\n      }\n\n      // If stale, optionally update the data in the background.\n      if (this.refetchOnStale) {\n        this.log(`refetchOnStale for ${queryKey}`);\n        void this.dedupedFetch(queryKey, ...args);\n      }\n\n      // Still return stale data immediately.\n      this.log(`Returning stale data for ${queryKey}`);\n      return cached.data;\n    }\n\n    return await this.dedupedFetch(queryKey, ...args);\n  }\n\n  private dedupedFetch(queryKey: string, ...args: TArgs): Promise<TData> {\n    const inflightQuery = this.inflightQueries.get(queryKey);\n\n    // De-duplicate in-flight requests\n    if (inflightQuery) {\n      this.log(`Deduplicating inflight fetch for ${queryKey}`);\n      return inflightQuery.promise;\n    }\n\n    // Fetch new data\n    const promise = this.startFetching(queryKey, args);\n    const abortController = new AbortController();\n\n    this.inflightQueries.set(queryKey, { promise, abortController });\n\n    return promise;\n  }\n\n  private async startFetching(queryKey: string, args: TArgs) {\n    this.log(`Start fetching ${queryKey}`);\n\n    try {\n      const data = await this.queryFn(...args);\n\n      this.log(`Successfully fetched ${queryKey}`);\n      this.setData(queryKey, data, Date.now());\n      return data;\n    } catch (e) {\n      this.log(`Failed to fetch ${queryKey}: ${e}`);\n      throw e;\n    } finally {\n      this.inflightQueries.delete(queryKey);\n    }\n  }\n\n  /** Get the entire stored entry for a query key. */\n  public getQueryValue(queryKey: string): QueryStateValue<TData> | undefined {\n    return this.queryState.getSnapshot()?.[queryKey];\n  }\n\n  /** Get the current stored data for a query key. */\n  public getData(queryKey: string): TData | undefined {\n    return this.queryState.getSnapshot()?.[queryKey]?.data;\n  }\n\n  /** Set the data directly if the user obtained it from somewhere else. */\n  public setData(\n    queryKey: string,\n    data: TData,\n    dataUpdatedMs = Date.now(),\n  ): void {\n    const entry: QueryStateValue<TData> = {\n      lastUpdatedMs: Date.now(),\n      loading: false,\n      data,\n      dataUpdatedMs,\n    };\n\n    this.queryState.setValue((prev) => ({ ...prev, [queryKey]: entry }));\n\n    this.enforceSizeLimit();\n  }\n\n  /**\n   * Do a new fetch even when the data is already cached, but don't fetch if\n   * another fetch is already inflight.\n   */\n  public async updateFromSource(...args: TArgs): Promise<TData> {\n    const key = this.getQueryKey(args);\n    return await this.dedupedFetch(key, ...args);\n  }\n\n  /** Delete the cached data for one set of arguments. */\n  public deleteData(queryKey: string): void {\n    const record = this.queryState.getSnapshot();\n    const clone = { ...record };\n    delete clone[queryKey];\n    this.queryState.setValue(clone);\n\n    const inflight = this.inflightQueries.get(queryKey);\n    if (inflight) {\n      this.inflightQueries.delete(queryKey);\n      inflight.abortController.abort(\"Deleted\");\n    }\n  }\n\n  /** Delete all currently cached data & all inflight promises. */\n  public clear(): void {\n    this.queryState.delete();\n\n    for (const { abortController } of Array.from(\n      this.inflightQueries.values(),\n    )) {\n      abortController.abort(\"Cleared\");\n    }\n\n    this.inflightQueries.clear();\n  }\n\n  /**\n   * Discard the oldest entries if the size exceeds the limit. The last\n   * remaining record cannot be deleted no matter what the limit is.\n   */\n  public enforceSizeLimit(): void {\n    // Skip if there are no limits.\n    if (!this.maxSize && !this.maxBytes) {\n      return;\n    }\n\n    const oldState = this.queryState.getSnapshot();\n    const oldSize = Object.keys(oldState).length;\n\n    // Cannot do GC if size is 1 or less.\n    if (oldSize <= 1) {\n      return;\n    }\n\n    const oldByteSize = getByteSize(oldState);\n\n    let newState = oldState;\n    let needUpdate = false;\n\n    // Limit by number of records.\n    if (this.maxSize) {\n      const numToCut = oldSize - this.maxSize;\n\n      if (numToCut > 0) {\n        this.log(\n          `enforceSizeLimit for ${this.queryName} needed due to size ${oldSize} > ${this.maxSize}`,\n        );\n\n        newState = { ...newState }; // shallow clone\n        needUpdate = true;\n\n        Object.entries(newState)\n          .sort(\n            (entry1, entry2) =>\n              // Sort descending.\n              entry2[1].lastUpdatedMs - entry1[1].lastUpdatedMs,\n          )\n          .slice(-numToCut)\n          .forEach(([key]) => {\n            delete newState[key];\n          });\n      }\n    }\n\n    // Limit by byte size.\n    if (this.maxBytes && Object.keys(newState).length > 1) {\n      // Recompute only if changed by above code.\n      const currentByteSize = needUpdate ? getByteSize(newState) : oldByteSize;\n\n      let bytesToCut = currentByteSize - this.maxBytes;\n\n      if (bytesToCut > 0) {\n        this.log(\n          `enforceSizeLimit for ${this.queryName} needed due to byte size ${currentByteSize.toLocaleString()} > ${this.maxBytes.toLocaleString()}`,\n        );\n\n        // Shallow clone only if not already cloned above.\n        if (!needUpdate) {\n          newState = { ...newState };\n          needUpdate = true;\n        }\n\n        const entriesByTimeAscending = Object.entries(newState).sort(\n          (entry1, entry2) => entry1[1].lastUpdatedMs - entry2[1].lastUpdatedMs,\n        );\n\n        for (\n          let i = 0;\n          // Leave the last record entriesByTimeAscending[len-1] untouched.\n          i < entriesByTimeAscending.length - 1 && bytesToCut > 0;\n          i++\n        ) {\n          const key = entriesByTimeAscending[i][0];\n          const thisSize = getByteSize(key) + getByteSize(newState[key]);\n          delete newState[key];\n          bytesToCut -= thisSize;\n        }\n      }\n    }\n\n    // Update the state.\n    if (needUpdate) {\n      this.queryState.setValue(newState);\n\n      // Log to inform user that the data was trimmed.\n      this.log(\n        `Trimmed data for ${this.queryName}: size=(${oldSize} -> ${Object.keys(newState).length}) (limit=${this.maxSize}), byteSize=(${oldByteSize.toLocaleString()} -> ${getByteSize(newState).toLocaleString()}) (limit=${this.maxBytes.toLocaleString()})`,\n      );\n\n      return;\n    }\n\n    // Log to indicate why trimming was not needed.\n    this.log(\n      `No need to trim data for ${this.queryName}: size=${oldSize} (limit=${this.maxSize}), byteSize=${oldByteSize.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`,\n    );\n  }\n}\n\nconst seenQueryNames = new Set<string>();\n\n/**\n * Create a reusable shared query object that can be used to auto de-duplicate\n * and cache all data fetches, with auto-expiration and staleness checks.\n *\n * Each `queryName` must be unique, and can only be declared once, most often\n * in the top level scope. The queryName is used for logging only.\n *\n * Example:\n * ```\n *   export const usersQuery = sharedQuery({\n *     queryName: \"users\",\n *     queryFn: listUsers,\n *     persistTo: \"indexedDb\",\n *     staleMs: MS_PER_DAY,\n *   });\n * ```\n */\nexport function sharedQuery<TArgs extends unknown[], TData>(\n  // The name could have been auto-generated, but we let the user give us a\n  // human-readable name that can be identified quickly in the logs.\n  options: SharedQueryOptions<TArgs, TData>,\n): SharedQuery<TArgs, TData> {\n  if (seenQueryNames.has(options.queryName)) {\n    throw new Error(`Duplicate shared query \"${options.queryName}\"`);\n  }\n  seenQueryNames.add(options.queryName);\n\n  return new SharedQuery(options);\n}\n\nconst DEFAULT_QUERY_STATE_ENTRY: QueryStateValue<unknown> = {\n  lastUpdatedMs: 0,\n  loading: true,\n};\n\n/**\n * React hook to make use of a shared query inside any React component.\n *\n * Example:\n * ```\n *   const users = useSharedQuery(usersQuery, [\"123\"]);\n * ```\n */\nexport function useSharedQuery<TArgs extends unknown[], TData>(\n  query: SharedQuery<TArgs, TData>,\n  // Default to use no arguments.\n  args: TArgs = [] as unknown as TArgs,\n): UseQueryResult<TData> {\n  // We don't expect users to provide a stable `args`, so stabilize it here.\n  const stableArgs = useDeepMemo(args);\n\n  const [queryState, setQueryState] = useSharedState(query.queryState);\n\n  const isMounted = useRef(true);\n\n  const queryKey = useMemo(\n    () => query.getQueryKey(stableArgs),\n    [query, stableArgs],\n  );\n\n  // Make sure typechecker knows this could be undefined.\n  const queryStateValue = queryState[queryKey] as\n    | QueryStateValue<TData>\n    | undefined;\n\n  const setQueryStateValue = useCallback(\n    (\n      arg:\n        | QueryStateValue<TData>\n        | ((\n            prev: QueryStateValue<TData> | undefined,\n          ) => QueryStateValue<TData>),\n    ) => {\n      setQueryState((prev) => {\n        const clone = { ...prev };\n        clone[queryKey] =\n          typeof arg === \"function\" ? arg(clone[queryKey]) : arg;\n        return clone;\n      });\n    },\n    [queryKey, setQueryState],\n  );\n\n  // The fetch logic wrapped in useCallback to be stable for useEffect\n  const execute = useCallback(\n    async (forceRefresh: boolean) => {\n      query.log(`Begin executing shared query ${queryKey}`);\n\n      setQueryStateValue((prev) => ({\n        // Keep old data and error.\n        ...(prev ?? {}),\n        lastUpdatedMs: Date.now(),\n        loading: true,\n      }));\n\n      try {\n        const data = await (forceRefresh\n          ? query.updateFromSource(...stableArgs)\n          : query.getCachedOrFetch(...stableArgs));\n\n        if (isMounted.current) {\n          const now = Date.now();\n\n          setQueryStateValue({\n            // Don't keep old error.\n            lastUpdatedMs: now,\n            loading: false,\n            data,\n            dataUpdatedMs: now,\n          });\n        }\n      } catch (e) {\n        if (isMounted.current) {\n          const now = Date.now();\n\n          setQueryStateValue((prev) => ({\n            // Keep old data.\n            ...(prev ?? {}),\n            lastUpdatedMs: now,\n            loading: false,\n            error: e,\n            errorUpdatedMs: now,\n          }));\n        }\n      }\n    },\n    [query, queryKey, setQueryStateValue, stableArgs],\n  );\n\n  useEffect(() => {\n    isMounted.current = true;\n\n    void execute(false);\n\n    return () => {\n      isMounted.current = false;\n    };\n  }, [execute]);\n\n  return useMemo(() => {\n    const state =\n      queryStateValue ?? (DEFAULT_QUERY_STATE_ENTRY as QueryStateValue<TData>);\n\n    return {\n      ...state,\n      // This works only if the user-given queryFn supports abort. If not,\n      // this function doesn't do anything, since we don't have any means to\n      // abort the running queryFn.\n      abortCurrentQuery: (reason?: unknown) => {\n        const controller = query.getAbortControllerByKey(queryKey);\n        controller?.abort(reason);\n        return Boolean(controller);\n      },\n      refetch: () => {\n        void execute(true);\n      },\n      setData: (data: TData, dataUpdatedMs?: number) => {\n        const now = Date.now();\n        setQueryStateValue((prev) => ({\n          ...(prev ?? {}),\n          data,\n          dataUpdatedMs: dataUpdatedMs ?? now,\n          lastUpdatedMs: now,\n          loading: false,\n        }));\n      },\n      deleteData: () => {\n        setQueryState((prev) => {\n          const clone = { ...prev };\n          delete clone[queryKey];\n          return clone;\n        });\n      },\n    };\n  }, [\n    execute,\n    query,\n    queryKey,\n    queryStateValue,\n    setQueryState,\n    setQueryStateValue,\n  ]);\n}\n","/**\n * The \"shared state\" is a React state that shares the same value across the\n * entire app. It is largely similar to the jotai library, but is much smaller\n * and much easier to work with when used for persisting in local storage or\n * indexed db, with an automatic expiration for persisted values.\n *\n * This library aims to be the shortest, simplest, easiest to use, and most\n * efficient implementation of shared global React states with seamless support\n * for client persistence.\n *\n * @packageDocumentation\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport { useSyncExternalStore } from \"react\";\n\nimport {\n  getStorageAdapter,\n  StorageAdapter,\n  StorageOptions,\n} from \"./utils/storage\";\n\n/************************************************************************/\n/* Global config                                                        */\n/************************************************************************/\n\n/**\n * These values are configurable by the user at any time.\n */\nexport const SharedStateDefaults = {\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\n/************************************************************************/\n/* Shared state implementation                                          */\n/************************************************************************/\n\ntype Subscriber<T> = (next: T, prev: T) => void;\n\nclass PubSubStore {\n  private dataByKey = new Map<string, unknown>();\n  private subscribersByKey = new Map<string, Set<Subscriber<unknown>>>();\n\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  public get<T>(key: string): T {\n    return this.dataByKey.get(key) as T;\n  }\n\n  public set<T>(key: string, value: T): void {\n    const prev = this.dataByKey.get(key) as T;\n\n    // Do nothing if no change.\n    if (prev === value) return;\n\n    this.dataByKey.set(key, value);\n    this.notify(key, value, prev);\n  }\n\n  public delete(key: string): void {\n    this.dataByKey.delete(key);\n  }\n\n  public setNoNotify<T>(key: string, value: T): void {\n    this.dataByKey.set(key, value);\n  }\n\n  // Subscribe to changes of a specific key\n  public subscribe<T>(key: string, subscriber: Subscriber<T>): () => void {\n    let subscribers = this.subscribersByKey.get(key);\n    if (!subscribers) {\n      subscribers = new Set();\n      this.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) this.subscribersByKey.delete(key);\n    };\n  }\n\n  private notify<T>(key: string, next: T, prev: T): void {\n    const subscribers = this.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\nconst pubSubStore = new PubSubStore();\n\nconst STORAGE_KEY = \"state\";\n\nexport type SharedStateOptions<T> = {\n  lazyLoad?: boolean;\n} & StorageOptions<T>;\n\nlet stateKey = 0;\n\nexport class SharedState<T> {\n  private readonly pubSubKey: string;\n  private readonly storageAdapter: StorageAdapter<T> | null;\n  public readonly setValueBounded: (next: T | ((prev: T) => T)) => void;\n  public initDone = false;\n\n  public constructor(\n    private readonly defaultValue: T,\n    options?: SharedStateOptions<T>,\n  ) {\n    this.pubSubKey = String(stateKey++);\n\n    // Use max of 1 storage adapter per shared state.\n    this.storageAdapter = getStorageAdapter(\n      options,\n      SharedStateDefaults.storeExpiryMs,\n    );\n\n    // Same as this.setValue, but binding the `this` reference.\n    this.setValueBounded = (arg) => this.setValue(arg);\n\n    // Always set the default value first to avoid returning undefineds if that\n    // is not part of T.\n    pubSubStore.setNoNotify(this.pubSubKey, defaultValue);\n\n    const lazyLoad = options?.lazyLoad;\n    const lazy =\n      lazyLoad !== undefined ? lazyLoad : SharedStateDefaults.lazyLoad;\n\n    if (!lazy) {\n      void this.initDefaultValueOnce();\n    }\n  }\n\n  // `subscribe` function required by useSyncExternalStore\n  public subscribe(subscriber: () => void): () => void {\n    return pubSubStore.subscribe(this.pubSubKey, () => subscriber());\n  }\n\n  // Get the value of the shared state.\n  // `getSnapshot` function — must return same ref if value unchanged\n  public getSnapshot(): T {\n    return pubSubStore.get(this.pubSubKey);\n  }\n\n  // Set the value of the shared state.\n  public setValue(next: T | ((prev: T) => T)): void {\n    if (typeof next === \"function\") {\n      const prev = pubSubStore.get<T>(this.pubSubKey);\n      next = (next as (p: T) => T)(prev);\n    }\n\n    pubSubStore.set(this.pubSubKey, next);\n    void this.storageAdapter?.save(STORAGE_KEY, next);\n  }\n\n  // Remove the value of the shared state. Actually this just sets the value\n  // back to the given default value.\n  public delete() {\n    pubSubStore.set(this.pubSubKey, this.defaultValue);\n    void this.storageAdapter?.save(STORAGE_KEY, this.defaultValue);\n  }\n\n  // Initial default handling\n  public async initDefaultValueOnce() {\n    if (this.initDone) return;\n    this.initDone = true;\n\n    const v = await this.storageAdapter?.load(STORAGE_KEY);\n    pubSubStore.set(this.pubSubKey, v !== undefined ? v : this.defaultValue);\n  }\n}\n\n/**\n * Create a new shared state object. Put this code at the top level scope:\n *\n *   const myState = sharedState<number>(0);\n */\nexport function sharedState<T>(\n  defaultValue: T,\n  options?: SharedStateOptions<T>,\n): SharedState<T> {\n  return new SharedState(defaultValue, options);\n}\n\n/**\n * React hook for subscribing to a key in the global store.\n *   const [my, setMy] = useSharedState(myState);\n */\nexport function useSharedState<T>(\n  state: SharedState<T>,\n): [T, (next: T | ((prev: T) => T)) => void] {\n  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.setValueBounded];\n}\n\n/** E.g. const my = useSharedStateValue(myState) */\nexport function useSharedStateValue<T>(state: SharedState<T>) {\n  return useSharedState(state)[0];\n}\n\n/** E.g. const setMy = useSharedStateSetter(myState) */\nexport function useSharedStateSetter<T>(state: SharedState<T>) {\n  return useSharedState(state)[1];\n}\n","import { kvStore } from \"@choksheak/ts-utils/kvStore\";\n\nexport type StorageAdapter<T> = {\n  save: (key: string, value: T) => Promise<void> | void;\n  load: (key: string) => Promise<T | undefined> | T | undefined;\n  delete: (key: string) => Promise<void> | void;\n  clear: () => Promise<void> | void;\n};\n\nexport type StorageOptions<T> = {\n  // If specified, this will be used and all other fields will be ignored.\n  store?: StorageAdapter<T>;\n\n  // Storage key in local storage for this data.\n  localStorageKey?: string;\n\n  // Storage key in indexed db for this data.\n  indexedDbKey?: string;\n\n  // How long to wait before the value is considered expired.\n  storeExpiryMs?: number;\n};\n\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { localStorageKey, indexedDbKey, storeExpiryMs, store } = options ?? {};\n\n  if (store) {\n    return store;\n  }\n\n  const expiryMs = storeExpiryMs || defaultStoreExpiryMs;\n\n  if (localStorageKey) {\n    return new LocalStorageAdapter<T>(localStorageKey, expiryMs);\n  }\n\n  if (indexedDbKey) {\n    return new IndexedDbAdapter<T>(indexedDbKey, expiryMs);\n  }\n\n  return null;\n}\n\n/************************************************************************/\n/* Storage adapters                                                     */\n/************************************************************************/\n\ntype ValueWithExpiration<T> = { value: T; expiresAt: number };\n\n/** Save state to memory only - not persisted. */\nexport class InMemoryStorageAdapter<T> implements StorageAdapter<T> {\n  private readonly cache = new Map<string, ValueWithExpiration<T>>();\n\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.set(fullKey, {\n      value,\n      expiresAt: Date.now() + this.expiryMs,\n    });\n  }\n\n  public load(key: string): T | undefined {\n    const fullKey = this.keyPrefix + \":\" + key;\n    const cached = this.cache.get(fullKey);\n\n    if (cached && Date.now() < cached.expiresAt) {\n      return cached.value;\n    }\n\n    return undefined;\n  }\n\n  public delete(key: string): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.delete(fullKey);\n  }\n\n  public clear(): void {\n    this.cache.clear();\n  }\n}\n\n/** Save state to local storage. */\nexport class LocalStorageAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.setItem(\n      fullKey,\n      JSON.stringify({\n        value,\n        expiresAt: this.expiryMs ? Date.now() + this.expiryMs : 0,\n      } satisfies ValueWithExpiration<T>),\n    );\n  }\n\n  public load(key: string): T | undefined {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = window.localStorage.getItem(fullKey);\n    if (!raw) return undefined;\n\n    try {\n      const box = JSON.parse(raw) as ValueWithExpiration<T>;\n      if (!box || (box.expiresAt && Date.now() >= box.expiresAt)) {\n        window.localStorage.removeItem(fullKey);\n        return undefined;\n      }\n\n      return box.value;\n    } catch {\n      // Ignore error.\n      window.localStorage.removeItem(fullKey);\n      return undefined;\n    }\n  }\n\n  public delete(key: string): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.removeItem(fullKey);\n  }\n\n  public clear(): void {\n    if (typeof window === \"undefined\") return;\n\n    for (const key of Object.keys(window.localStorage)) {\n      if (key.startsWith(this.keyPrefix)) {\n        window.localStorage.removeItem(key);\n      }\n    }\n  }\n}\n\n/** Save state to indexed db. */\nexport class IndexedDbAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public async save(key: string, value: T): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.set(fullKey, JSON.stringify(value), this.expiryMs);\n  }\n\n  public async load(key: string): Promise<T | undefined> {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = await kvStore.get<string>(fullKey);\n    if (raw === undefined) return undefined;\n\n    try {\n      return JSON.parse(raw);\n    } catch {\n      // Ignore error.\n      await kvStore.delete(fullKey);\n      return undefined;\n    }\n  }\n\n  public async delete(key: string): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.delete(fullKey);\n  }\n\n  public async clear(): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    await kvStore.forEach(async (k) => {\n      if (k.startsWith(this.keyPrefix)) {\n        await kvStore.delete(k);\n      }\n    });\n  }\n}\n","/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n","import isEqual from \"lodash/isEqual\";\nimport { useMemo, useState } from \"react\";\n\n/** Provides a stable value for T based on deep equality. */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (state === value || isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"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","names":["sharedQuery_exports","__export","SharedQuery","SharedQueryDefaults","sharedQuery","useSharedQuery","__toCommonJS","import_timeConstants","import_object_sizeof","import_react","import_timeConstants","import_react","import_kvStore","getStorageAdapter","options","defaultStoreExpiryMs","localStorageKey","indexedDbKey","storeExpiryMs","store","expiryMs","LocalStorageAdapter","IndexedDbAdapter","LocalStorageAdapter","keyPrefix","expiryMs","key","value","fullKey","raw","box","IndexedDbAdapter","k","SharedStateDefaults","PubSubStore","key","value","prev","subscriber","subscribers","next","copy","e","pubSubStore","STORAGE_KEY","stateKey","SharedState","defaultValue","options","getStorageAdapter","arg","lazyLoad","v","sharedState","useSharedState","state","onStoreChange","stringifyDeterministicForKeys","params","cache","_","value","result","key","import_isEqual","import_react","useDeepMemo","value","state","setState","isEqual","SharedQueryDefaults","args","SharedQuery","options","persistTo","sharedState","stringifyDeterministicForKeys","queryKey","dataUpdatedMs","cached","inflightQuery","promise","abortController","data","e","entry","prev","key","clone","inflight","oldState","oldSize","oldByteSize","getByteSize","newState","needUpdate","numToCut","entry1","entry2","currentByteSize","bytesToCut","entriesByTimeAscending","i","thisSize","seenQueryNames","sharedQuery","DEFAULT_QUERY_STATE_ENTRY","useSharedQuery","query","stableArgs","useDeepMemo","queryState","setQueryState","useSharedState","isMounted","queryStateValue","setQueryStateValue","arg","execute","forceRefresh","now","reason","controller"]}
+{"version":3,"sources":["../src/sharedQuery.ts","../src/sharedState.ts","../src/utils/storage.ts","../src/utils/stringify.ts","../src/utils/useDeepMemo.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * The \"shared query\" is a data fetching convenience library that helps users\n * to load data, check for staleness and expiration, cache in memory, local\n * storage or indexed db, and be able to manipulate the data anytime.\n *\n * Each shared query creates a new private shared state that handles the data\n * storage. This shared state contains the records for all queries, where each\n * query is a unique set of arguments used to make the query. The number of\n * records and the total byte size of data can be limited so as to ensure the\n * query does not take up too much memory.\n *\n * Example:\n * ```\n *   import { sharedQuery, useSharedQuery } from \"@choksheak/react-utils/sharedQuery\";\n *\n *   // Create a new shared query in the top level scope.\n *   // The query function `queryFn` here does not take any arguments.\n *   //\n *   // Only the queryName and queryFn are required and everything else is\n *   // optional.\n *   //\n *   // The queryName must be unique, otherwise we will throw an\n *   // error. This is because defining the same queryName for two different\n *   // queries implies that the queries are the same, thus violating the idea\n *   // of a \"shared\" query, and almost certainly points to a bug in the code.\n *   export const usersQuery = sharedQuery({\n *     queryName: \"users\",\n *     queryFn: listUsers,\n *     persistTo: \"indexedDb\",\n *     staleMs: MS_PER_DAY,\n *   });\n *\n *   // Note that the query will only start fetching on mount in React.\n *   // But you can do `usersQuery.getCachedOrFetch()` here to prefetch the\n *   // data if necessary.\n *   usersQuery.getCachedOrFetch();\n *\n *   // Example of using a query function with arguments.\n *   export const getUserQuery = sharedQuery({\n *     queryName: \"getUser\",\n *     queryFn: getUser, // getUser(userId: string) => User\n *     persistTo: \"indexedDb\",\n *     staleMs: MS_PER_DAY,\n *   });\n *\n *   export const UsersComponent: React.FC = () => {\n *     // Second argument is optional, and is an array of arguments to be\n *     // passed to the `queryFn`.\n *     const users = useSharedQuery(usersQuery);\n *\n *     return (\n *       <>\n *         <h1>List of Users</h1>\n *\n *         <button onclick={users.refetch}>Refresh</button>\n *\n *         {users.loading && <Loader />}\n *\n *         {users.error && !users.data && <p>Error: {String(users.error)}</p>}\n *\n *         <p>Data: {users.data ? JSON.stringify(users.data) : \"-\"}</p>\n *       </>\n *     );\n *   };\n *\n *   export const AnotherComponent: React.FC = () => {\n *      // This query will be deduped with the one above, sharing the same\n *      // data and the same fetches.\n *      const users = useSharedQuery(usersQuery);\n *      ...\n *   };\n *\n *   export const DisplayOneUser: React.FC<{userId: string}> = ({userId}) => {\n *      // Example of using the query with an argument. Whenever the argument\n *      // changes, the data will be fetched and updated automatically.\n *      const user = useSharedQuery(getUserQuery, [userId]);\n *\n *      return <>User: {user.data ? JSON.stringify(user.data) : \"-\"}</>;\n *   };\n * ```\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport getByteSize from \"object-sizeof\";\nimport {\n  SetStateAction,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\n\nimport {\n  SharedState,\n  sharedState,\n  SharedStateOptions,\n  useSharedState,\n} from \"./sharedState\";\nimport { stringifyDeterministicForKeys } from \"./utils/stringify\";\nimport { useDeepMemo } from \"./utils/useDeepMemo\";\n\n/** Type of the queryFn used to fetch the data from source. */\nexport type QueryFn<TArgs extends unknown[], TData> = (\n  ...args: TArgs\n) => Promise<TData> | TData;\n\n/** An entry for a persisted state corresponding to one query key. */\nexport type QueryStateValue<TData> = Readonly<{\n  /**\n   * When this record was last updated. Used for LRU determination. If you want\n   * the data age, please use `dataUpdatedMs` instead.\n   */\n  lastUpdatedMs: number;\n\n  loading: boolean;\n  data?: TData;\n  dataUpdatedMs?: number;\n\n  /**\n   * Use unknown type for error because we can't assume what type of variable\n   * will be thrown from the query function. We also don't want to add this\n   * type to QueryStateValue<TError> as it adds complexity to the type.\n   */\n  error?: unknown;\n\n  errorUpdatedMs?: number;\n}>;\n\n/** Return type for useSharedQuery(). */\nexport type UseQueryResult<TData> = QueryStateValue<TData> &\n  Readonly<{\n    /**\n     * Return the last non-empty data if you want to display the last loaded data\n     * while waiting for the new data to load.\n     */\n    lastNonEmptyData: TData | undefined;\n\n    /**\n     * Cancels the inflight query (if any). Returns true if canceled.\n     */\n    abortCurrentQuery: (reason?: unknown) => boolean;\n\n    /**\n     * Manually refresh the data by doing a new query.\n     */\n    refetch: () => void;\n\n    /**\n     * If you got the data from somewhere else (e.g. an in-memory data update),\n     * just set it directly.\n     */\n    setData: (data: TData, dataUpdatedMs?: number) => void;\n\n    deleteData: () => void;\n  }>;\n\n/** List of all available persistence options. */\nexport type PersistTo = \"localStorage\" | \"indexedDb\";\n\n/**\n * The full query state is a record of all the fetch states mapped by\n * query key to the state entry.\n */\nexport type SharedQueryState<TData> = Record<string, QueryStateValue<TData>>;\n\n/** Options to configure a shared query. */\nexport type SharedQueryOptions<TArgs extends unknown[], TData> = {\n  /**\n   * The name could have been auto-generated, but we let the user give us a\n   * human-readable name that can be identified quickly in the logs.\n   * Note that the queryKey is a string formed by the queryName plus the query\n   * arguments.\n   */\n  queryName: string;\n\n  /**\n   * Function to fetch data.\n   */\n  queryFn: QueryFn<TArgs, TData>;\n\n  /**\n   * ms before data considered stale; 0 means always stale.\n   */\n  staleMs?: number;\n\n  /**\n   * ms before data is removed from cache; 0 means never expire.\n   */\n  expiryMs?: number;\n\n  /**\n   * Trigger background re-fetch if stale.\n   */\n  refetchOnStale?: boolean;\n\n  /**\n   * Shortcut to set the localStorageKey or indexedDbKey automatically from\n   * queryName. This is important because it avoids requiring the user to\n   * specify the same queryName twice everytime.\n   */\n  persistTo?: PersistTo;\n\n  /**\n   * Max number of entries to keep. The oldest entries will be discarded.\n   * The last record cannot be discarded. 0 means no limit.\n   */\n  maxSize?: number;\n\n  /**\n   * Max number of bytes to keep. The oldest entries will be discarded.\n   * The last record cannot be discarded. 0 means no limit.\n   */\n  maxBytes?: number;\n\n  /**\n   * Keep a copy of the last non-empty data so that when you change the\n   * query arguments, you can still display the old data while waiting for the\n   * new data to load.\n   */\n  keepLastNonEmptyData?: boolean;\n\n  /**\n   * Customize the logger.\n   */\n  log?: (...args: unknown[]) => void;\n} & SharedStateOptions<SharedQueryState<TData>>;\n\n/** Users can override these values globally. */\nexport const SharedQueryDefaults = {\n  /** Refetch on every page load. */\n  staleMs: 0,\n\n  /** Keep in cache for a long time. */\n  expiryMs: 30 * MS_PER_DAY,\n\n  /** Always refetch automatically if the data is stale. */\n  refetchOnStale: true,\n\n  /** No default persistence configured. */\n  persistTo: undefined as PersistTo | undefined,\n\n  /** 100 is not too large, but please tweak accordingly. */\n  maxSize: 100,\n\n  /** 100kb limit before discarding old records. */\n  maxBytes: 100_000,\n\n  /** Default to log to console. */\n  log: (...args: unknown[]) => console.log(\"[sharedQuery]\", ...args),\n};\n\n/** Please use sharedQuery() instead. */\nexport class SharedQuery<TArgs extends unknown[], TData> {\n  private readonly inflightQueries = new Map<\n    string,\n    { promise: Promise<TData>; abortController: AbortController }\n  >();\n\n  public readonly queryState: SharedState<SharedQueryState<TData>>;\n\n  /**\n   * Keep track of the mounted query keys. This handles the case where an\n   * earlier-started query returns later, and when it returns, it was already\n   * unmounted, thus making it eligible for clean up right after fetch.\n   */\n  private readonly mountedKeys = new Map<string, number>();\n\n  public readonly queryName: string;\n  private readonly queryFn: QueryFn<TArgs, TData>;\n  public readonly expiryMs: number;\n  public readonly staleMs: number;\n  public readonly refetchOnStale: boolean;\n  public readonly maxSize: number;\n  public readonly maxBytes: number;\n  public readonly keepLastNonEmptyData: boolean;\n  public readonly log: (...args: unknown[]) => void;\n\n  public constructor(options: SharedQueryOptions<TArgs, TData>) {\n    this.queryName = options.queryName;\n    this.queryFn = options.queryFn;\n\n    this.staleMs = options?.staleMs ?? SharedQueryDefaults.staleMs;\n    this.expiryMs = options?.expiryMs ?? SharedQueryDefaults.expiryMs;\n\n    this.refetchOnStale =\n      options?.refetchOnStale ?? SharedQueryDefaults.refetchOnStale;\n\n    // Apply shortcut when using `persistTo`.\n    // Specifying the storage keys will take precedence over `persistTo`.\n    if (!options.localStorageKey && !options.indexedDbKey) {\n      const persistTo = options.persistTo ?? SharedQueryDefaults.persistTo;\n\n      if (persistTo === \"localStorage\") {\n        options.localStorageKey = options.queryName;\n      } else if (persistTo === \"indexedDb\") {\n        options.indexedDbKey = options.queryName;\n      }\n    }\n\n    this.maxSize = options?.maxSize ?? SharedQueryDefaults.maxSize;\n    this.maxBytes = options?.maxBytes ?? SharedQueryDefaults.maxBytes;\n\n    this.keepLastNonEmptyData = Boolean(options?.keepLastNonEmptyData);\n\n    this.log = options?.log ?? SharedQueryDefaults.log;\n\n    this.queryState = sharedState<SharedQueryState<TData>>(\n      {}, // defaultValue\n      {\n        ...options,\n        // Fallback to use expiryMs for the storeExpiryMs.\n        storeExpiryMs: options?.storeExpiryMs || this.expiryMs,\n      },\n    );\n  }\n\n  /** Returns a key to identify requests based on the given args. */\n  public getQueryKey(args: TArgs): string {\n    return this.queryName + \":\" + stringifyDeterministicForKeys(args);\n  }\n\n  /**\n   * Get the AbortController to abort the inflight query (if any).\n   *\n   * Note that once you get the controller, you can also get the signal easily\n   * using `controller.signal`. So if you need both the controller and the\n   * signal, just use this function.\n   */\n  public getAbortController(args: TArgs): AbortController | null {\n    const queryKey = this.getQueryKey(args);\n    return this.getAbortControllerByKey(queryKey);\n  }\n\n  public getAbortControllerByKey(queryKey: string): AbortController | null {\n    return this.inflightQueries.get(queryKey)?.abortController ?? null;\n  }\n\n  /**\n   * Get the AbortSignal to check for query abortions.\n   *\n   * Example:\n   * ```\n   *   const getUserQuery = sharedQuery({\n   *     queryName: \"getUser\",\n   *     queryFn: (userId: string) => {\n   *       // Get the signal for this current execution.\n   *       const signal = getUserQuery.getAbortSignal([userId]);\n   *\n   *       // Pass the signal to fetch so that it can be aborted.\n   *       const response = await fetch(`/users/${userId}`, { signal });\n   *\n   *       // Check for errors.\n   *       if (!response.ok) {\n   *         throw new Error(response.statusText);\n   *       }\n   *\n   *       // Return the data.\n   *       return await response.json();\n   *     },\n   *   });\n   * ```\n   */\n  public getAbortSignal(args: TArgs): AbortSignal | null {\n    const queryKey = this.getQueryKey(args);\n    return this.getAbortSignalByKey(queryKey);\n  }\n\n  public getAbortSignalByKey(queryKey: string): AbortSignal | null {\n    return this.getAbortControllerByKey(queryKey)?.signal ?? null;\n  }\n\n  private isStale(dataUpdatedMs: number): boolean {\n    if (this.staleMs === 0) return true; // always stale\n\n    const ageMs = Date.now() - dataUpdatedMs;\n    return ageMs > this.staleMs;\n  }\n\n  private isExpired(dataUpdatedMs: number): boolean {\n    if (this.expiryMs === 0) return false; // never expire\n\n    const ageMs = Date.now() - dataUpdatedMs;\n    return ageMs > this.expiryMs;\n  }\n\n  public async getCachedOrFetch(...args: TArgs): Promise<TData> {\n    const queryKey = this.getQueryKey(args);\n    const cached = this.queryState.getSnapshot()?.[queryKey];\n\n    if (cached?.data && !this.isExpired(cached.dataUpdatedMs ?? 0)) {\n      // Return cached value if not stale.\n      if (!this.isStale(cached.dataUpdatedMs ?? 0)) {\n        this.log(`Return fresh data ${queryKey} from cache without fetching`);\n        return cached.data;\n      }\n\n      // If stale, optionally update the data in the background.\n      if (this.refetchOnStale) {\n        this.log(`refetchOnStale for ${queryKey}`);\n        void this.dedupedFetch(queryKey, ...args);\n      }\n\n      // Still return stale data immediately.\n      this.log(`Returning stale data for ${queryKey}`);\n      return cached.data;\n    }\n\n    return await this.dedupedFetch(queryKey, ...args);\n  }\n\n  private dedupedFetch(queryKey: string, ...args: TArgs): Promise<TData> {\n    const inflightQuery = this.inflightQueries.get(queryKey);\n\n    // De-duplicate in-flight requests\n    if (inflightQuery) {\n      this.log(`Deduplicating inflight fetch for ${queryKey}`);\n      return inflightQuery.promise;\n    }\n\n    // Fetch new data\n    const promise = this.startFetching(queryKey, args);\n    const abortController = new AbortController();\n\n    this.inflightQueries.set(queryKey, { promise, abortController });\n\n    return promise;\n  }\n\n  private async startFetching(queryKey: string, args: TArgs) {\n    this.log(`Start fetching ${queryKey}`);\n\n    try {\n      const data = await this.queryFn(...args);\n\n      this.log(`Successfully fetched ${queryKey}`);\n      this.setData(queryKey, data, Date.now());\n      return data;\n    } catch (e) {\n      this.log(`Failed to fetch ${queryKey}: ${e}`);\n      throw e;\n    } finally {\n      this.inflightQueries.delete(queryKey);\n    }\n  }\n\n  /** Get the entire stored entry for a query key. */\n  public getQueryValue(queryKey: string): QueryStateValue<TData> | undefined {\n    return this.queryState.getSnapshot()?.[queryKey];\n  }\n\n  /** Get the current stored data for a query key. */\n  public getData(queryKey: string): TData | undefined {\n    return this.queryState.getSnapshot()?.[queryKey]?.data;\n  }\n\n  /** Set the data directly if the user obtained it from somewhere else. */\n  public setData(\n    queryKey: string,\n    data: TData,\n    dataUpdatedMs = Date.now(),\n  ): void {\n    const entry: QueryStateValue<TData> = {\n      lastUpdatedMs: Date.now(),\n      loading: false,\n      data,\n      dataUpdatedMs,\n    };\n\n    this.queryState.setValue((prev) => ({ ...prev, [queryKey]: entry }));\n\n    this.enforceSizeLimit();\n  }\n\n  /**\n   * Do a new fetch even when the data is already cached, but don't fetch if\n   * another fetch is already inflight.\n   */\n  public async updateFromSource(...args: TArgs): Promise<TData> {\n    const key = this.getQueryKey(args);\n    return await this.dedupedFetch(key, ...args);\n  }\n\n  /** Delete the cached data for one set of arguments. */\n  public deleteData(queryKey: string): void {\n    const record = this.queryState.getSnapshot();\n    const clone = { ...record };\n    delete clone[queryKey];\n    this.queryState.setValue(clone);\n\n    const inflight = this.inflightQueries.get(queryKey);\n    if (inflight) {\n      this.inflightQueries.delete(queryKey);\n      inflight.abortController.abort(\"Deleted\");\n    }\n  }\n\n  /** Delete all currently cached data & all inflight promises. */\n  public clear(): void {\n    this.queryState.delete();\n\n    for (const { abortController } of Array.from(\n      this.inflightQueries.values(),\n    )) {\n      abortController.abort(\"Cleared\");\n    }\n\n    this.inflightQueries.clear();\n  }\n\n  /** Keep track of mounted keys. */\n  public mount(queryKey: string): void {\n    this.mountedKeys.set(queryKey, (this.mountedKeys.get(queryKey) ?? 0) + 1);\n  }\n\n  /** Clean up mounted keys. */\n  public unmount(queryKey: string): void {\n    const count = this.mountedKeys.get(queryKey);\n    if (count === 1) {\n      this.mountedKeys.delete(queryKey);\n    } else {\n      this.mountedKeys.set(queryKey, (count ?? 0) - 1);\n    }\n  }\n\n  /**\n   * Discard the oldest entries if the size exceeds the limit. The last\n   * remaining record cannot be deleted no matter what the limit is.\n   */\n  public enforceSizeLimit(): void {\n    // Skip if there are no limits.\n    if (!this.maxSize && !this.maxBytes) {\n      return;\n    }\n\n    const oldState = this.queryState.getSnapshot();\n    const oldSize = Object.keys(oldState).length;\n\n    // Cannot do GC if size is 1 or less.\n    if (oldSize <= 1) {\n      return;\n    }\n\n    const oldByteSize = getByteSize(oldState);\n\n    let numToCut = this.maxSize ? oldSize - this.maxSize : 0;\n    let bytesToCut = this.maxBytes ? oldByteSize - this.maxBytes : 0;\n\n    // Log to indicate why trimming was not needed.\n    if (numToCut <= 0 && bytesToCut <= 0) {\n      this.log(\n        `No need to trim data for ${this.queryName}: size=${oldSize} (limit=${this.maxSize}), byteSize=${oldByteSize.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`,\n      );\n      return;\n    }\n\n    // Log to inform user that trimming is needed.\n    this.log(\n      `Need to trim ${this.queryName}: numToCut=${numToCut}, bytesToCut=${bytesToCut}`,\n    );\n\n    const newState = { ...oldState }; // shallow clone\n    let needUpdate = false;\n\n    const entriesByTimeAscending = Object.entries(newState).sort(\n      (entry1, entry2) => entry1[1].lastUpdatedMs - entry2[1].lastUpdatedMs,\n    );\n\n    for (const [key] of entriesByTimeAscending) {\n      // Mounted keys cannot be cleaned up as they are visible in the UI.\n      if (this.mountedKeys.has(key)) {\n        this.log(`Cannot clean up ${key} as it is mounted`);\n        continue;\n      }\n\n      const byteSize = getByteSize(key) + getByteSize(newState[key]);\n      this.log(\n        `Cleaning up unmounted ${key} (byteSize=${byteSize.toLocaleString()})`,\n      );\n\n      numToCut--;\n      bytesToCut -= byteSize;\n\n      delete newState[key];\n      needUpdate = true;\n\n      if (numToCut <= 0 && bytesToCut <= 0) {\n        break;\n      }\n    }\n\n    // Log to indicate why trimming was not needed.\n    if (!needUpdate) {\n      this.log(\n        `No trimmable entries found for ${this.queryName}: size=${oldSize} (limit=${this.maxSize}), byteSize=${oldByteSize.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`,\n      );\n      return;\n    }\n\n    // Update the state.\n    this.queryState.setValue(newState);\n\n    // Log to inform user that the data was trimmed.\n    this.log(\n      `Trimmed data for ${this.queryName}: size=[${oldSize} -> ${Object.keys(newState).length}] (limit=${this.maxSize}), byteSize=[${oldByteSize.toLocaleString()} -> ${getByteSize(newState).toLocaleString()}] (limit=${this.maxBytes.toLocaleString()})`,\n    );\n  }\n}\n\n// Disallow duplicate query names.\nconst seenQueryNames = new Set<string>();\n\n/**\n * Create a reusable shared query object that can be used to auto de-duplicate\n * and cache all data fetches, with auto-expiration and staleness checks.\n *\n * Each `queryName` must be unique, and can only be declared once, most often\n * in the top level scope. The queryName is used for logging only.\n *\n * Example:\n * ```\n *   export const usersQuery = sharedQuery({\n *     queryName: \"users\",\n *     queryFn: listUsers,\n *     persistTo: \"indexedDb\",\n *     staleMs: MS_PER_DAY,\n *   });\n * ```\n */\nexport function sharedQuery<TArgs extends unknown[], TData>(\n  // The name could have been auto-generated, but we let the user give us a\n  // human-readable name that can be identified quickly in the logs.\n  options: SharedQueryOptions<TArgs, TData>,\n): SharedQuery<TArgs, TData> {\n  if (seenQueryNames.has(options.queryName)) {\n    throw new Error(`Duplicate shared query \"${options.queryName}\"`);\n  }\n  seenQueryNames.add(options.queryName);\n\n  return new SharedQuery(options);\n}\n\n// Using any so that we don't need to typecast later.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst DEFAULT_QUERY_STATE_ENTRY: Readonly<QueryStateValue<any>> = {\n  lastUpdatedMs: 0,\n  loading: true,\n};\n\n/**\n * React hook to make use of a shared query inside any React component.\n *\n * Example:\n * ```\n *   const users = useSharedQuery(usersQuery, [\"123\"]);\n * ```\n */\nexport function useSharedQuery<TArgs extends unknown[], TData>(\n  query: SharedQuery<TArgs, TData>,\n  // Default to use no arguments.\n  args: TArgs = [] as unknown as TArgs,\n): UseQueryResult<TData> {\n  // We don't expect users to provide a stable `args`, so stabilize it here.\n  const stableArgs = useDeepMemo(args);\n\n  const [queryState, setQueryState] = useSharedState(query.queryState);\n\n  const isMounted = useRef(true);\n\n  const queryKey = useMemo(\n    () => query.getQueryKey(stableArgs),\n    [query, stableArgs],\n  );\n\n  // Init with empty object.\n  const queryStateValue: QueryStateValue<TData> =\n    queryState[queryKey] ?? DEFAULT_QUERY_STATE_ENTRY;\n\n  const setQueryStateValue = useCallback(\n    (next: SetStateAction<QueryStateValue<TData>>) => {\n      setQueryState((prev) => {\n        const clone = { ...prev };\n        clone[queryKey] =\n          typeof next === \"function\"\n            ? next(clone[queryKey] ?? DEFAULT_QUERY_STATE_ENTRY)\n            : next;\n        return clone;\n      });\n    },\n    [queryKey, setQueryState],\n  );\n\n  // Keep the last non-empty data loaded in case you want to show a placeholder\n  // during new loads.\n  const [lastNonEmptyData, setLastNonEmptyData] = useState<TData | undefined>();\n\n  useEffect(() => {\n    if (query.keepLastNonEmptyData && queryStateValue.data !== undefined) {\n      setLastNonEmptyData(queryStateValue.data);\n    }\n  }, [query.keepLastNonEmptyData, queryStateValue.data]);\n\n  // The fetch logic wrapped in useCallback to be stable for useEffect\n  const execute = useCallback(\n    async (forceRefresh: boolean) => {\n      query.log(`Begin executing shared query ${queryKey}`);\n\n      setQueryStateValue((prev) => ({\n        // Keep old data and error.\n        ...prev,\n        lastUpdatedMs: Date.now(),\n        loading: true,\n      }));\n\n      try {\n        const data = await (forceRefresh\n          ? query.updateFromSource(...stableArgs)\n          : query.getCachedOrFetch(...stableArgs));\n\n        if (isMounted.current) {\n          const now = Date.now();\n\n          setQueryStateValue({\n            // Don't keep old error.\n            lastUpdatedMs: now,\n            loading: false,\n            data,\n            dataUpdatedMs: now,\n          });\n        }\n      } catch (e) {\n        if (isMounted.current) {\n          const now = Date.now();\n\n          setQueryStateValue((prev) => ({\n            // Keep old data.\n            ...prev,\n            lastUpdatedMs: now,\n            loading: false,\n            error: e,\n            errorUpdatedMs: now,\n          }));\n        }\n      }\n    },\n    [query, queryKey, setQueryStateValue, stableArgs],\n  );\n\n  useEffect(() => {\n    isMounted.current = true;\n    query.mount(queryKey);\n\n    void execute(false);\n\n    return () => {\n      isMounted.current = false;\n      query.unmount(queryKey);\n    };\n  }, [execute, query, queryKey]);\n\n  return useMemo(() => {\n    return {\n      ...queryStateValue,\n      lastNonEmptyData,\n      // This works only if the user-given queryFn supports abort. If not,\n      // this function doesn't do anything, since we don't have any means to\n      // abort the running queryFn.\n      abortCurrentQuery: (reason?: unknown) => {\n        const controller = query.getAbortControllerByKey(queryKey);\n        controller?.abort(reason);\n        return Boolean(controller);\n      },\n      refetch: () => {\n        void execute(true);\n      },\n      setData: (data: TData, dataUpdatedMs?: number) => {\n        const now = Date.now();\n        setQueryStateValue((prev) => ({\n          ...prev,\n          data,\n          dataUpdatedMs: dataUpdatedMs ?? now,\n          lastUpdatedMs: now,\n          loading: false,\n        }));\n      },\n      deleteData: () => {\n        setQueryState((prev) => {\n          const clone = { ...prev };\n          delete clone[queryKey];\n          return clone;\n        });\n      },\n    } satisfies UseQueryResult<TData>;\n  }, [\n    execute,\n    lastNonEmptyData,\n    query,\n    queryKey,\n    queryStateValue,\n    setQueryState,\n    setQueryStateValue,\n  ]);\n}\n","/**\n * @packageDocumentation\n *\n * The \"shared state\" is a React state that shares the same value across the\n * entire app. It is largely similar to the jotai library, but is much smaller\n * and much easier to work with when used for persisting in local storage or\n * indexed db, with an automatic expiration for persisted values.\n *\n * This library aims to be the shortest, simplest, easiest to use, and most\n * efficient implementation of shared global React states with seamless support\n * for client persistence.\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([], { indexedDbKey: \"users\" });\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 {\n  getStorageAdapter,\n  StorageAdapter,\n  StorageOptions,\n} from \"./utils/storage\";\n\n/************************************************************************/\n/* Global config                                                        */\n/************************************************************************/\n\n/**\n * These values are configurable by the user at any time.\n */\nexport const SharedStateDefaults = {\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\n/************************************************************************/\n/* Shared state implementation                                          */\n/************************************************************************/\n\ntype Subscriber<T> = (next: T, prev: T) => void;\n\nclass PubSubStore {\n  private dataByKey = new Map<string, unknown>();\n  private subscribersByKey = new Map<string, Set<Subscriber<unknown>>>();\n\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  public get<T>(key: string): T {\n    return this.dataByKey.get(key) as T;\n  }\n\n  public set<T>(key: string, value: T): void {\n    const prev = this.dataByKey.get(key) as T;\n\n    // Do nothing if no change.\n    if (prev === value) return;\n\n    this.dataByKey.set(key, value);\n    this.notify(key, value, prev);\n  }\n\n  public delete(key: string): void {\n    this.dataByKey.delete(key);\n  }\n\n  public setNoNotify<T>(key: string, value: T): void {\n    this.dataByKey.set(key, value);\n  }\n\n  // Subscribe to changes of a specific key\n  public subscribe<T>(key: string, subscriber: Subscriber<T>): () => void {\n    let subscribers = this.subscribersByKey.get(key);\n    if (!subscribers) {\n      subscribers = new Set();\n      this.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) this.subscribersByKey.delete(key);\n    };\n  }\n\n  private notify<T>(key: string, next: T, prev: T): void {\n    const subscribers = this.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\nconst pubSubStore = new PubSubStore();\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/** Please use sharedState() instead. */\nexport class SharedState<T> {\n  private readonly pubSubKey: string;\n  private readonly storageAdapter: StorageAdapter<T> | null;\n  public readonly setValueBounded: Dispatch<SetStateAction<T>>;\n  public initDone = false;\n\n  public constructor(\n    private readonly defaultValue: T,\n    options?: SharedStateOptions<T>,\n  ) {\n    this.pubSubKey = String(stateKey++);\n\n    // Use max of 1 storage adapter per shared state.\n    this.storageAdapter = getStorageAdapter(\n      options,\n      SharedStateDefaults.storeExpiryMs,\n    );\n\n    // Same as this.setValue, but binding the `this` reference.\n    this.setValueBounded = (next: SetStateAction<T>) => {\n      this.setValue(next);\n    };\n\n    // Always set the default value first to avoid returning undefineds if that\n    // is not part of T.\n    pubSubStore.setNoNotify(this.pubSubKey, defaultValue);\n\n    const lazyLoad = options?.lazyLoad;\n    const lazy =\n      lazyLoad !== undefined ? lazyLoad : SharedStateDefaults.lazyLoad;\n\n    if (!lazy) {\n      void this.initDefaultValueOnce();\n    }\n  }\n\n  // `subscribe` function required by useSyncExternalStore\n  public subscribe(subscriber: () => void): () => void {\n    return pubSubStore.subscribe(this.pubSubKey, () => subscriber());\n  }\n\n  // Get the value of the shared state.\n  // `getSnapshot` function — must return same ref if value unchanged\n  public getSnapshot(): T {\n    return pubSubStore.get(this.pubSubKey);\n  }\n\n  // Set the value of the shared state.\n  public setValue(next: SetStateAction<T>): void {\n    if (typeof next === \"function\") {\n      const prev = pubSubStore.get<T>(this.pubSubKey);\n      next = (next as (p: T) => T)(prev);\n    }\n\n    pubSubStore.set(this.pubSubKey, next);\n    void this.storageAdapter?.save(STORAGE_KEY, next);\n  }\n\n  // Remove the value of the shared state. Actually this just sets the value\n  // back to the given default value.\n  public delete() {\n    pubSubStore.set(this.pubSubKey, this.defaultValue);\n    void this.storageAdapter?.save(STORAGE_KEY, this.defaultValue);\n  }\n\n  // Initial default handling\n  public async initDefaultValueOnce() {\n    if (this.initDone) return;\n    this.initDone = true;\n\n    const v = await this.storageAdapter?.load(STORAGE_KEY);\n    pubSubStore.set(this.pubSubKey, v !== undefined ? v : this.defaultValue);\n  }\n}\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): SharedState<T> {\n  return new SharedState(defaultValue, options);\n}\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  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.setValueBounded];\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  return useSharedState(state)[1];\n}\n","import { kvStore } from \"@choksheak/ts-utils/kvStore\";\n\nexport type StorageAdapter<T> = {\n  save: (key: string, value: T) => Promise<void> | void;\n  load: (key: string) => Promise<T | undefined> | T | undefined;\n  delete: (key: string) => Promise<void> | void;\n  clear: () => Promise<void> | void;\n};\n\nexport type StorageOptions<T> = {\n  // If specified, this will be used and all other fields will be ignored.\n  store?: StorageAdapter<T>;\n\n  // Storage key in local storage for this data.\n  localStorageKey?: string;\n\n  // Storage key in indexed db for this data.\n  indexedDbKey?: string;\n\n  // How long to wait before the value is considered expired.\n  storeExpiryMs?: number;\n};\n\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { localStorageKey, indexedDbKey, storeExpiryMs, store } = options ?? {};\n\n  if (store) {\n    return store;\n  }\n\n  const expiryMs = storeExpiryMs || defaultStoreExpiryMs;\n\n  if (localStorageKey) {\n    return new LocalStorageAdapter<T>(localStorageKey, expiryMs);\n  }\n\n  if (indexedDbKey) {\n    return new IndexedDbAdapter<T>(indexedDbKey, expiryMs);\n  }\n\n  return null;\n}\n\n/************************************************************************/\n/* Storage adapters                                                     */\n/************************************************************************/\n\ntype ValueWithExpiration<T> = { value: T; expiresAt: number };\n\n/** Save state to memory only - not persisted. */\nexport class InMemoryStorageAdapter<T> implements StorageAdapter<T> {\n  private readonly cache = new Map<string, ValueWithExpiration<T>>();\n\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.set(fullKey, {\n      value,\n      expiresAt: Date.now() + this.expiryMs,\n    });\n  }\n\n  public load(key: string): T | undefined {\n    const fullKey = this.keyPrefix + \":\" + key;\n    const cached = this.cache.get(fullKey);\n\n    if (cached && Date.now() < cached.expiresAt) {\n      return cached.value;\n    }\n\n    return undefined;\n  }\n\n  public delete(key: string): void {\n    const fullKey = this.keyPrefix + \":\" + key;\n    this.cache.delete(fullKey);\n  }\n\n  public clear(): void {\n    this.cache.clear();\n  }\n}\n\n/** Save state to local storage. */\nexport class LocalStorageAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public save(key: string, value: T): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.setItem(\n      fullKey,\n      JSON.stringify({\n        value,\n        expiresAt: this.expiryMs ? Date.now() + this.expiryMs : 0,\n      } satisfies ValueWithExpiration<T>),\n    );\n  }\n\n  public load(key: string): T | undefined {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = window.localStorage.getItem(fullKey);\n    if (!raw) return undefined;\n\n    try {\n      const box = JSON.parse(raw) as ValueWithExpiration<T>;\n      if (!box || (box.expiresAt && Date.now() >= box.expiresAt)) {\n        window.localStorage.removeItem(fullKey);\n        return undefined;\n      }\n\n      return box.value;\n    } catch {\n      // Ignore error.\n      window.localStorage.removeItem(fullKey);\n      return undefined;\n    }\n  }\n\n  public delete(key: string): void {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    window.localStorage.removeItem(fullKey);\n  }\n\n  public clear(): void {\n    if (typeof window === \"undefined\") return;\n\n    for (const key of Object.keys(window.localStorage)) {\n      if (key.startsWith(this.keyPrefix)) {\n        window.localStorage.removeItem(key);\n      }\n    }\n  }\n}\n\n/** Save state to indexed db. */\nexport class IndexedDbAdapter<T> implements StorageAdapter<T> {\n  public constructor(\n    public readonly keyPrefix: string,\n    public readonly expiryMs: number,\n  ) {}\n\n  public async save(key: string, value: T): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.set(fullKey, JSON.stringify(value), this.expiryMs);\n  }\n\n  public async load(key: string): Promise<T | undefined> {\n    if (typeof window === \"undefined\") return undefined;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    const raw = await kvStore.get<string>(fullKey);\n    if (raw === undefined) return undefined;\n\n    try {\n      return JSON.parse(raw);\n    } catch {\n      // Ignore error.\n      await kvStore.delete(fullKey);\n      return undefined;\n    }\n  }\n\n  public async delete(key: string): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    const fullKey = this.keyPrefix + \":\" + key;\n    await kvStore.delete(fullKey);\n  }\n\n  public async clear(): Promise<void> {\n    if (typeof window === \"undefined\") return;\n\n    await kvStore.forEach(async (k) => {\n      if (k.startsWith(this.keyPrefix)) {\n        await kvStore.delete(k);\n      }\n    });\n  }\n}\n","/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n","import isEqual from \"lodash/isEqual\";\nimport { useMemo, useState } from \"react\";\n\n/** Provides a stable value for T based on deep equality. */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (state === value || isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"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","names":["sharedQuery_exports","__export","SharedQuery","SharedQueryDefaults","sharedQuery","useSharedQuery","__toCommonJS","import_timeConstants","import_object_sizeof","import_react","import_timeConstants","import_react","import_kvStore","getStorageAdapter","options","defaultStoreExpiryMs","localStorageKey","indexedDbKey","storeExpiryMs","store","expiryMs","LocalStorageAdapter","IndexedDbAdapter","LocalStorageAdapter","keyPrefix","expiryMs","key","value","fullKey","raw","box","IndexedDbAdapter","k","SharedStateDefaults","PubSubStore","key","value","prev","subscriber","subscribers","next","copy","e","pubSubStore","STORAGE_KEY","stateKey","SharedState","defaultValue","options","getStorageAdapter","lazyLoad","v","sharedState","useSharedState","state","onStoreChange","stringifyDeterministicForKeys","params","cache","_","value","result","key","import_isEqual","import_react","useDeepMemo","value","state","setState","isEqual","SharedQueryDefaults","args","SharedQuery","options","persistTo","sharedState","stringifyDeterministicForKeys","queryKey","dataUpdatedMs","cached","inflightQuery","promise","abortController","data","e","entry","prev","key","clone","inflight","count","oldState","oldSize","oldByteSize","getByteSize","numToCut","bytesToCut","newState","needUpdate","entriesByTimeAscending","entry1","entry2","byteSize","seenQueryNames","sharedQuery","DEFAULT_QUERY_STATE_ENTRY","useSharedQuery","query","stableArgs","useDeepMemo","queryState","setQueryState","useSharedState","isMounted","queryStateValue","setQueryStateValue","next","lastNonEmptyData","setLastNonEmptyData","execute","forceRefresh","now","reason","controller"]}

package/sharedQuery.min.mjs

@@ -1,2 +1,2 @@
-import{MS_PER_DAY as C}from"@choksheak/ts-utils/timeConstants";import g from"object-sizeof";import{useCallback as O,useEffect as F,useMemo as B,useRef as L}from"react";import{MS_PER_DAY as P}from"@choksheak/ts-utils/timeConstants";import{useSyncExternalStore as E}from"react";import{kvStore as f}from"@choksheak/ts-utils/kvStore";function v(i,e){let{localStorageKey:t,indexedDbKey:r,storeExpiryMs:a,store:s}=i??{};if(s)return s;let n=a||e;return t?new b(t,n):r?new T(r,n):null}var b=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;window.localStorage.setItem(r,JSON.stringify({value:t,expiresAt:this.expiryMs?Date.now()+this.expiryMs:0}))}load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=window.localStorage.getItem(t);if(r)try{let a=JSON.parse(r);if(!a||a.expiresAt&&Date.now()>=a.expiresAt){window.localStorage.removeItem(t);return}return a.value}catch{window.localStorage.removeItem(t);return}}delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;window.localStorage.removeItem(t)}clear(){if(!(typeof window>"u"))for(let e of Object.keys(window.localStorage))e.startsWith(this.keyPrefix)&&window.localStorage.removeItem(e)}},T=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}async save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;await f.set(r,JSON.stringify(t),this.expiryMs)}async load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=await f.get(t);if(r!==void 0)try{return JSON.parse(r)}catch{await f.delete(t);return}}async delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;await f.delete(t)}async clear(){typeof window>"u"||await f.forEach(async e=>{e.startsWith(this.keyPrefix)&&await f.delete(e)})}};var A={storeExpiryMs:30*P,lazyLoad:!1},x=class{dataByKey=new Map;subscribersByKey=new Map;get(e){return this.dataByKey.get(e)}set(e,t){let r=this.dataByKey.get(e);r!==t&&(this.dataByKey.set(e,t),this.notify(e,t,r))}delete(e){this.dataByKey.delete(e)}setNoNotify(e,t){this.dataByKey.set(e,t)}subscribe(e,t){let r=this.subscribersByKey.get(e);return r||(r=new Set,this.subscribersByKey.set(e,r)),r.add(t),()=>{r.delete(t),r.size===0&&this.subscribersByKey.delete(e)}}notify(e,t,r){let a=this.subscribersByKey.get(e);if(!a)return;let s=Array.from(a.values());for(let n of s)try{n(t,r)}catch(l){console.error("Error invoking subscriber:",l)}}},p=new x,m="state",$=0,w=class{constructor(e,t){this.defaultValue=e;this.pubSubKey=String($++),this.storageAdapter=v(t,A.storeExpiryMs),this.setValueBounded=s=>this.setValue(s),p.setNoNotify(this.pubSubKey,e);let r=t?.lazyLoad;(r!==void 0?r:A.lazyLoad)||this.initDefaultValueOnce()}pubSubKey;storageAdapter;setValueBounded;initDone=!1;subscribe(e){return p.subscribe(this.pubSubKey,()=>e())}getSnapshot(){return p.get(this.pubSubKey)}setValue(e){if(typeof e=="function"){let t=p.get(this.pubSubKey);e=e(t)}p.set(this.pubSubKey,e),this.storageAdapter?.save(m,e)}delete(){p.set(this.pubSubKey,this.defaultValue),this.storageAdapter?.save(m,this.defaultValue)}async initDefaultValueOnce(){if(this.initDone)return;this.initDone=!0;let e=await this.storageAdapter?.load(m);p.set(this.pubSubKey,e!==void 0?e:this.defaultValue)}};function M(i,e){return new w(i,e)}function Q(i){return i.initDefaultValueOnce(),[E(t=>i.subscribe(t),()=>i.getSnapshot(),()=>i.getSnapshot()),i.setValueBounded]}function K(i){let e=new Set;return JSON.stringify(i,(t,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(e.has(r))return"[Circular]";if(e.add(r),r!==i)try{JSON.stringify(r)}catch{return"[Unserializable]"}return Object.keys(r).sort().reduce((a,s)=>(a[s]=r[s],a),{})})}import N from"lodash/isEqual";import{useMemo as U,useState as q}from"react";function k(i){let[e,t]=q(i);return U(()=>e===i||N(e,i)?e:(t(i),i),[e,i])}var h={staleMs:0,expiryMs:30*C,refetchOnStale:!0,persistTo:void 0,maxSize:100,maxBytes:1e5,log:(...i)=>console.log("[sharedQuery]",...i)},D=class{inflightQueries=new Map;queryState;queryName;queryFn;expiryMs;staleMs;refetchOnStale;maxSize;maxBytes;log;constructor(e){if(this.queryName=e.queryName,this.queryFn=e.queryFn,this.staleMs=e?.staleMs??h.staleMs,this.expiryMs=e?.expiryMs??h.expiryMs,this.refetchOnStale=e?.refetchOnStale??h.refetchOnStale,!e.localStorageKey&&!e.indexedDbKey){let t=e.persistTo??h.persistTo;t==="localStorage"?e.localStorageKey=e.queryName:t==="indexedDb"&&(e.indexedDbKey=e.queryName)}this.maxSize=e?.maxSize??h.maxSize,this.maxBytes=e?.maxBytes??h.maxBytes,this.log=e?.log??h.log,this.queryState=M({},{...e,storeExpiryMs:e?.storeExpiryMs||this.expiryMs})}getQueryKey(e){return this.queryName+":"+K(e)}getAbortController(e){let t=this.getQueryKey(e);return this.getAbortControllerByKey(t)}getAbortControllerByKey(e){return this.inflightQueries.get(e)?.abortController??null}getAbortSignal(e){let t=this.getQueryKey(e);return this.getAbortSignalByKey(t)}getAbortSignalByKey(e){return this.getAbortControllerByKey(e)?.signal??null}isStale(e){return this.staleMs===0?!0:Date.now()-e>this.staleMs}isExpired(e){return this.expiryMs===0?!1:Date.now()-e>this.expiryMs}async getCachedOrFetch(...e){let t=this.getQueryKey(e),r=this.queryState.getSnapshot()?.[t];return r?.data&&!this.isExpired(r.dataUpdatedMs??0)?this.isStale(r.dataUpdatedMs??0)?(this.refetchOnStale&&(this.log(`refetchOnStale for ${t}`),this.dedupedFetch(t,...e)),this.log(`Returning stale data for ${t}`),r.data):(this.log(`Return fresh data ${t} from cache without fetching`),r.data):await this.dedupedFetch(t,...e)}dedupedFetch(e,...t){let r=this.inflightQueries.get(e);if(r)return this.log(`Deduplicating inflight fetch for ${e}`),r.promise;let a=this.startFetching(e,t),s=new AbortController;return this.inflightQueries.set(e,{promise:a,abortController:s}),a}async startFetching(e,t){this.log(`Start fetching ${e}`);try{let r=await this.queryFn(...t);return this.log(`Successfully fetched ${e}`),this.setData(e,r,Date.now()),r}catch(r){throw this.log(`Failed to fetch ${e}: ${r}`),r}finally{this.inflightQueries.delete(e)}}getQueryValue(e){return this.queryState.getSnapshot()?.[e]}getData(e){return this.queryState.getSnapshot()?.[e]?.data}setData(e,t,r=Date.now()){let a={lastUpdatedMs:Date.now(),loading:!1,data:t,dataUpdatedMs:r};this.queryState.setValue(s=>({...s,[e]:a})),this.enforceSizeLimit()}async updateFromSource(...e){let t=this.getQueryKey(e);return await this.dedupedFetch(t,...e)}deleteData(e){let r={...this.queryState.getSnapshot()};delete r[e],this.queryState.setValue(r);let a=this.inflightQueries.get(e);a&&(this.inflightQueries.delete(e),a.abortController.abort("Deleted"))}clear(){this.queryState.delete();for(let{abortController:e}of Array.from(this.inflightQueries.values()))e.abort("Cleared");this.inflightQueries.clear()}enforceSizeLimit(){if(!this.maxSize&&!this.maxBytes)return;let e=this.queryState.getSnapshot(),t=Object.keys(e).length;if(t<=1)return;let r=g(e),a=e,s=!1;if(this.maxSize){let n=t-this.maxSize;n>0&&(this.log(`enforceSizeLimit for ${this.queryName} needed due to size ${t} > ${this.maxSize}`),a={...a},s=!0,Object.entries(a).sort((l,c)=>c[1].lastUpdatedMs-l[1].lastUpdatedMs).slice(-n).forEach(([l])=>{delete a[l]}))}if(this.maxBytes&&Object.keys(a).length>1){let n=s?g(a):r,l=n-this.maxBytes;if(l>0){this.log(`enforceSizeLimit for ${this.queryName} needed due to byte size ${n.toLocaleString()} > ${this.maxBytes.toLocaleString()}`),s||(a={...a},s=!0);let c=Object.entries(a).sort((y,d)=>y[1].lastUpdatedMs-d[1].lastUpdatedMs);for(let y=0;y<c.length-1&&l>0;y++){let d=c[y][0],u=g(d)+g(a[d]);delete a[d],l-=u}}}if(s){this.queryState.setValue(a),this.log(`Trimmed data for ${this.queryName}: size=(${t} -> ${Object.keys(a).length}) (limit=${this.maxSize}), byteSize=(${r.toLocaleString()} -> ${g(a).toLocaleString()}) (limit=${this.maxBytes.toLocaleString()})`);return}this.log(`No need to trim data for ${this.queryName}: size=${t} (limit=${this.maxSize}), byteSize=${r.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`)}},z=new Set;function de(i){if(z.has(i.queryName))throw new Error(`Duplicate shared query "${i.queryName}"`);return z.add(i.queryName),new D(i)}var R={lastUpdatedMs:0,loading:!0};function ce(i,e=[]){let t=k(e),[r,a]=Q(i.queryState),s=L(!0),n=B(()=>i.getQueryKey(t),[i,t]),l=r[n],c=O(d=>{a(u=>{let o={...u};return o[n]=typeof d=="function"?d(o[n]):d,o})},[n,a]),y=O(async d=>{i.log(`Begin executing shared query ${n}`),c(u=>({...u??{},lastUpdatedMs:Date.now(),loading:!0}));try{let u=await(d?i.updateFromSource(...t):i.getCachedOrFetch(...t));if(s.current){let o=Date.now();c({lastUpdatedMs:o,loading:!1,data:u,dataUpdatedMs:o})}}catch(u){if(s.current){let o=Date.now();c(S=>({...S??{},lastUpdatedMs:o,loading:!1,error:u,errorUpdatedMs:o}))}}},[i,n,c,t]);return F(()=>(s.current=!0,y(!1),()=>{s.current=!1}),[y]),B(()=>({...l??R,abortCurrentQuery:u=>{let o=i.getAbortControllerByKey(n);return o?.abort(u),!!o},refetch:()=>{y(!0)},setData:(u,o)=>{let S=Date.now();c(V=>({...V??{},data:u,dataUpdatedMs:o??S,lastUpdatedMs:S,loading:!1}))},deleteData:()=>{a(u=>{let o={...u};return delete o[n],o})}}),[y,i,n,l,a,c])}export{D as SharedQuery,h as SharedQueryDefaults,de as sharedQuery,ce as useSharedQuery};
+import{MS_PER_DAY as q}from"@choksheak/ts-utils/timeConstants";import b from"object-sizeof";import{useCallback as O,useEffect as E,useMemo as z,useRef as _,useState as j}from"react";import{MS_PER_DAY as V}from"@choksheak/ts-utils/timeConstants";import{useSyncExternalStore as C}from"react";import{kvStore as g}from"@choksheak/ts-utils/kvStore";function v(i,e){let{localStorageKey:t,indexedDbKey:r,storeExpiryMs:a,store:n}=i??{};if(n)return n;let s=a||e;return t?new T(t,s):r?new x(r,s):null}var T=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;window.localStorage.setItem(r,JSON.stringify({value:t,expiresAt:this.expiryMs?Date.now()+this.expiryMs:0}))}load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=window.localStorage.getItem(t);if(r)try{let a=JSON.parse(r);if(!a||a.expiresAt&&Date.now()>=a.expiresAt){window.localStorage.removeItem(t);return}return a.value}catch{window.localStorage.removeItem(t);return}}delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;window.localStorage.removeItem(t)}clear(){if(!(typeof window>"u"))for(let e of Object.keys(window.localStorage))e.startsWith(this.keyPrefix)&&window.localStorage.removeItem(e)}},x=class{constructor(e,t){this.keyPrefix=e;this.expiryMs=t}async save(e,t){if(typeof window>"u")return;let r=this.keyPrefix+":"+e;await g.set(r,JSON.stringify(t),this.expiryMs)}async load(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e,r=await g.get(t);if(r!==void 0)try{return JSON.parse(r)}catch{await g.delete(t);return}}async delete(e){if(typeof window>"u")return;let t=this.keyPrefix+":"+e;await g.delete(t)}async clear(){typeof window>"u"||await g.forEach(async e=>{e.startsWith(this.keyPrefix)&&await g.delete(e)})}};var K={storeExpiryMs:30*V,lazyLoad:!1},D=class{dataByKey=new Map;subscribersByKey=new Map;get(e){return this.dataByKey.get(e)}set(e,t){let r=this.dataByKey.get(e);r!==t&&(this.dataByKey.set(e,t),this.notify(e,t,r))}delete(e){this.dataByKey.delete(e)}setNoNotify(e,t){this.dataByKey.set(e,t)}subscribe(e,t){let r=this.subscribersByKey.get(e);return r||(r=new Set,this.subscribersByKey.set(e,r)),r.add(t),()=>{r.delete(t),r.size===0&&this.subscribersByKey.delete(e)}}notify(e,t,r){let a=this.subscribersByKey.get(e);if(!a)return;let n=Array.from(a.values());for(let s of n)try{s(t,r)}catch(c){console.error("Error invoking subscriber:",c)}}},p=new D,w="state",U=0,A=class{constructor(e,t){this.defaultValue=e;this.pubSubKey=String(U++),this.storageAdapter=v(t,K.storeExpiryMs),this.setValueBounded=n=>{this.setValue(n)},p.setNoNotify(this.pubSubKey,e);let r=t?.lazyLoad;(r!==void 0?r:K.lazyLoad)||this.initDefaultValueOnce()}pubSubKey;storageAdapter;setValueBounded;initDone=!1;subscribe(e){return p.subscribe(this.pubSubKey,()=>e())}getSnapshot(){return p.get(this.pubSubKey)}setValue(e){if(typeof e=="function"){let t=p.get(this.pubSubKey);e=e(t)}p.set(this.pubSubKey,e),this.storageAdapter?.save(w,e)}delete(){p.set(this.pubSubKey,this.defaultValue),this.storageAdapter?.save(w,this.defaultValue)}async initDefaultValueOnce(){if(this.initDone)return;this.initDone=!0;let e=await this.storageAdapter?.load(w);p.set(this.pubSubKey,e!==void 0?e:this.defaultValue)}};function Q(i,e){return new A(i,e)}function k(i){return i.initDefaultValueOnce(),[C(t=>i.subscribe(t),()=>i.getSnapshot(),()=>i.getSnapshot()),i.setValueBounded]}function B(i){let e=new Set;return JSON.stringify(i,(t,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(e.has(r))return"[Circular]";if(e.add(r),r!==i)try{JSON.stringify(r)}catch{return"[Unserializable]"}return Object.keys(r).sort().reduce((a,n)=>(a[n]=r[n],a),{})})}import F from"lodash/isEqual";import{useMemo as L,useState as R}from"react";function N(i){let[e,t]=R(i);return L(()=>e===i||F(e,i)?e:(t(i),i),[e,i])}var h={staleMs:0,expiryMs:30*q,refetchOnStale:!0,persistTo:void 0,maxSize:100,maxBytes:1e5,log:(...i)=>console.log("[sharedQuery]",...i)},M=class{inflightQueries=new Map;queryState;mountedKeys=new Map;queryName;queryFn;expiryMs;staleMs;refetchOnStale;maxSize;maxBytes;keepLastNonEmptyData;log;constructor(e){if(this.queryName=e.queryName,this.queryFn=e.queryFn,this.staleMs=e?.staleMs??h.staleMs,this.expiryMs=e?.expiryMs??h.expiryMs,this.refetchOnStale=e?.refetchOnStale??h.refetchOnStale,!e.localStorageKey&&!e.indexedDbKey){let t=e.persistTo??h.persistTo;t==="localStorage"?e.localStorageKey=e.queryName:t==="indexedDb"&&(e.indexedDbKey=e.queryName)}this.maxSize=e?.maxSize??h.maxSize,this.maxBytes=e?.maxBytes??h.maxBytes,this.keepLastNonEmptyData=!!e?.keepLastNonEmptyData,this.log=e?.log??h.log,this.queryState=Q({},{...e,storeExpiryMs:e?.storeExpiryMs||this.expiryMs})}getQueryKey(e){return this.queryName+":"+B(e)}getAbortController(e){let t=this.getQueryKey(e);return this.getAbortControllerByKey(t)}getAbortControllerByKey(e){return this.inflightQueries.get(e)?.abortController??null}getAbortSignal(e){let t=this.getQueryKey(e);return this.getAbortSignalByKey(t)}getAbortSignalByKey(e){return this.getAbortControllerByKey(e)?.signal??null}isStale(e){return this.staleMs===0?!0:Date.now()-e>this.staleMs}isExpired(e){return this.expiryMs===0?!1:Date.now()-e>this.expiryMs}async getCachedOrFetch(...e){let t=this.getQueryKey(e),r=this.queryState.getSnapshot()?.[t];return r?.data&&!this.isExpired(r.dataUpdatedMs??0)?this.isStale(r.dataUpdatedMs??0)?(this.refetchOnStale&&(this.log(`refetchOnStale for ${t}`),this.dedupedFetch(t,...e)),this.log(`Returning stale data for ${t}`),r.data):(this.log(`Return fresh data ${t} from cache without fetching`),r.data):await this.dedupedFetch(t,...e)}dedupedFetch(e,...t){let r=this.inflightQueries.get(e);if(r)return this.log(`Deduplicating inflight fetch for ${e}`),r.promise;let a=this.startFetching(e,t),n=new AbortController;return this.inflightQueries.set(e,{promise:a,abortController:n}),a}async startFetching(e,t){this.log(`Start fetching ${e}`);try{let r=await this.queryFn(...t);return this.log(`Successfully fetched ${e}`),this.setData(e,r,Date.now()),r}catch(r){throw this.log(`Failed to fetch ${e}: ${r}`),r}finally{this.inflightQueries.delete(e)}}getQueryValue(e){return this.queryState.getSnapshot()?.[e]}getData(e){return this.queryState.getSnapshot()?.[e]?.data}setData(e,t,r=Date.now()){let a={lastUpdatedMs:Date.now(),loading:!1,data:t,dataUpdatedMs:r};this.queryState.setValue(n=>({...n,[e]:a})),this.enforceSizeLimit()}async updateFromSource(...e){let t=this.getQueryKey(e);return await this.dedupedFetch(t,...e)}deleteData(e){let r={...this.queryState.getSnapshot()};delete r[e],this.queryState.setValue(r);let a=this.inflightQueries.get(e);a&&(this.inflightQueries.delete(e),a.abortController.abort("Deleted"))}clear(){this.queryState.delete();for(let{abortController:e}of Array.from(this.inflightQueries.values()))e.abort("Cleared");this.inflightQueries.clear()}mount(e){this.mountedKeys.set(e,(this.mountedKeys.get(e)??0)+1)}unmount(e){let t=this.mountedKeys.get(e);t===1?this.mountedKeys.delete(e):this.mountedKeys.set(e,(t??0)-1)}enforceSizeLimit(){if(!this.maxSize&&!this.maxBytes)return;let e=this.queryState.getSnapshot(),t=Object.keys(e).length;if(t<=1)return;let r=b(e),a=this.maxSize?t-this.maxSize:0,n=this.maxBytes?r-this.maxBytes:0;if(a<=0&&n<=0){this.log(`No need to trim data for ${this.queryName}: size=${t} (limit=${this.maxSize}), byteSize=${r.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`);return}this.log(`Need to trim ${this.queryName}: numToCut=${a}, bytesToCut=${n}`);let s={...e},c=!1,y=Object.entries(s).sort((l,f)=>l[1].lastUpdatedMs-f[1].lastUpdatedMs);for(let[l]of y){if(this.mountedKeys.has(l)){this.log(`Cannot clean up ${l} as it is mounted`);continue}let f=b(l)+b(s[l]);if(this.log(`Cleaning up unmounted ${l} (byteSize=${f.toLocaleString()})`),a--,n-=f,delete s[l],c=!0,a<=0&&n<=0)break}if(!c){this.log(`No trimmable entries found for ${this.queryName}: size=${t} (limit=${this.maxSize}), byteSize=${r.toLocaleString()} (limit=${this.maxBytes.toLocaleString()})`);return}this.queryState.setValue(s),this.log(`Trimmed data for ${this.queryName}: size=[${t} -> ${Object.keys(s).length}] (limit=${this.maxSize}), byteSize=[${r.toLocaleString()} -> ${b(s).toLocaleString()}] (limit=${this.maxBytes.toLocaleString()})`)}},$=new Set;function fe(i){if($.has(i.queryName))throw new Error(`Duplicate shared query "${i.queryName}"`);return $.add(i.queryName),new M(i)}var P={lastUpdatedMs:0,loading:!0};function ge(i,e=[]){let t=N(e),[r,a]=k(i.queryState),n=_(!0),s=z(()=>i.getQueryKey(t),[i,t]),c=r[s]??P,y=O(d=>{a(o=>{let u={...o};return u[s]=typeof d=="function"?d(u[s]??P):d,u})},[s,a]),[l,f]=j();E(()=>{i.keepLastNonEmptyData&&c.data!==void 0&&f(c.data)},[i.keepLastNonEmptyData,c.data]);let S=O(async d=>{i.log(`Begin executing shared query ${s}`),y(o=>({...o,lastUpdatedMs:Date.now(),loading:!0}));try{let o=await(d?i.updateFromSource(...t):i.getCachedOrFetch(...t));if(n.current){let u=Date.now();y({lastUpdatedMs:u,loading:!1,data:o,dataUpdatedMs:u})}}catch(o){if(n.current){let u=Date.now();y(m=>({...m,lastUpdatedMs:u,loading:!1,error:o,errorUpdatedMs:u}))}}},[i,s,y,t]);return E(()=>(n.current=!0,i.mount(s),S(!1),()=>{n.current=!1,i.unmount(s)}),[S,i,s]),z(()=>({...c,lastNonEmptyData:l,abortCurrentQuery:d=>{let o=i.getAbortControllerByKey(s);return o?.abort(d),!!o},refetch:()=>{S(!0)},setData:(d,o)=>{let u=Date.now();y(m=>({...m,data:d,dataUpdatedMs:o??u,lastUpdatedMs:u,loading:!1}))},deleteData:()=>{a(d=>{let o={...d};return delete o[s],o})}}),[S,l,i,s,c,a,y])}export{M as SharedQuery,h as SharedQueryDefaults,fe as sharedQuery,ge as useSharedQuery};
 //# sourceMappingURL=sharedQuery.min.mjs.map