@choksheak/react-utils 0.4.4 → 0.4.6

package/chunk-FXCYHS3L.mjs

@@ -1,577 +0,0 @@
-import {
-  sharedState,
-  useSharedState
-} from "./chunk-YHU4KW2D.mjs";
-import {
-  stringifyDeterministicForKeys
-} from "./chunk-4235I4VO.mjs";
-import {
-  useDeepMemo
-} from "./chunk-4J7TN5JN.mjs";
-
-// src/sharedQuery.ts
-import { http, retries } from "@choksheak/ts-utils/http";
-import { nonNil } from "@choksheak/ts-utils/nonNil";
-import getByteSize from "object-sizeof";
-import {
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-  useState
-} from "react";
-import XXH from "xxhashjs";
-var SharedQueryConfig = {
-  /** Refetch on every page load. */
-  staleMs: 0,
-  /** Keep in cache for a long time. */
-  expiryMs: 30 * 864e5,
-  /** Always refetch automatically if the data is stale. */
-  refetchOnStale: true,
-  /** No default persistence configured. */
-  persistTo: void 0,
-  /** 100 is not too large, but please tweak accordingly. */
-  maxSize: 100,
-  /** 100kb limit before discarding old records. */
-  maxBytes: 1e5,
-  /** Default to log to console. */
-  log: (...args) => console.log("[sharedQuery]", ...args)
-};
-function configureSharedQuery(config) {
-  Object.assign(SharedQueryConfig, config);
-}
-var seenQueryNames = /* @__PURE__ */ new Set();
-function sharedQuery(options) {
-  const url = options.url || "";
-  const queryName = options.queryName || url;
-  if (!queryName) {
-    throw new Error(`Either queryName or url must be specified.`);
-  }
-  if (seenQueryNames.has(queryName)) {
-    console.warn(`Duplicate shared query name "${queryName}"`);
-  }
-  seenQueryNames.add(queryName);
-  const inflightQueries = /* @__PURE__ */ new Map();
-  const mountedKeys = /* @__PURE__ */ new Map();
-  let queryFn;
-  if (options.queryFn) {
-    queryFn = options.queryFn;
-  } else if (url) {
-    const fetcher = http.use(retries());
-    queryFn = async (...args) => {
-      let params = "";
-      const firstArg = args?.[0];
-      if (firstArg) {
-        if (typeof firstArg === "string") {
-          params = firstArg;
-        } else if (typeof firstArg === "object") {
-          const entries = [];
-          for (const [k, v] of Object.entries(firstArg)) {
-            if (v === void 0) continue;
-            if (Array.isArray(v)) {
-              for (const item of v) {
-                if (item === void 0) continue;
-                entries.push([k, String(item)]);
-              }
-            } else {
-              entries.push([k, String(v)]);
-            }
-          }
-          params = new URLSearchParams(entries).toString();
-        }
-        if (params) {
-          if (url.includes("?")) {
-            params = "&" + params;
-          } else {
-            params = "?" + params;
-          }
-        }
-      }
-      const response = await fetcher.get(url + params);
-      return await response.json();
-    };
-  } else {
-    throw new Error(`Either queryFn or url must be specified`);
-  }
-  const refetchFn = options.refetchFn;
-  const staleMs = options?.staleMs ?? SharedQueryConfig.staleMs;
-  const expiryMs = options?.expiryMs ?? SharedQueryConfig.expiryMs;
-  const refetchOnStale = options?.refetchOnStale ?? SharedQueryConfig.refetchOnStale;
-  const store = options.store;
-  if (store) {
-    if ("persistTo" in store && store.isValid) {
-      const isValid = store.isValid;
-      options = {
-        ...options,
-        store: {
-          ...store,
-          isValid: (u) => {
-            if (!u || typeof u !== "object") {
-              return false;
-            }
-            for (const v of Object.values(u)) {
-              if (!v || typeof v !== "object" || !("data" in v) || !("dataUpdatedMs" in v) || !("lastUpdatedMs" in v) || typeof v.dataUpdatedMs !== "number" || typeof v.lastUpdatedMs !== "number" || !isValid(v.data)) {
-                return false;
-              }
-            }
-            return true;
-          }
-        }
-      };
-    }
-  } else {
-    const persistTo = options.persistTo ?? SharedQueryConfig.persistTo;
-    if (persistTo) {
-      options = {
-        ...options,
-        store: {
-          persistTo,
-          key: queryName,
-          expiryMs
-        }
-      };
-    }
-  }
-  const maxSize = options?.maxSize ?? SharedQueryConfig.maxSize;
-  const maxBytes = options?.maxBytes ?? SharedQueryConfig.maxBytes;
-  const keepLastNonEmptyData = Boolean(options?.keepLastNonEmptyData);
-  const log = options?.log ?? SharedQueryConfig.log;
-  const queryState = sharedState(
-    {},
-    // defaultValue
-    options
-  );
-  function isStale(dataUpdatedMs) {
-    if (staleMs === 0) return true;
-    const ageMs = Date.now() - dataUpdatedMs;
-    return ageMs > staleMs;
-  }
-  function isExpired(dataUpdatedMs) {
-    if (expiryMs === 0) return false;
-    const ageMs = Date.now() - dataUpdatedMs;
-    return ageMs > expiryMs;
-  }
-  function enforceSizeLimit() {
-    if (!maxSize && !maxBytes) {
-      return;
-    }
-    const oldState = queryState.getSnapshot();
-    const oldSize = Object.keys(oldState).length;
-    if (oldSize <= 1) {
-      return;
-    }
-    const oldByteSize = getByteSize(oldState);
-    let numToCut = maxSize ? oldSize - maxSize : 0;
-    let bytesToCut = maxBytes ? oldByteSize - maxBytes : 0;
-    if (numToCut <= 0 && bytesToCut <= 0) {
-      log(
-        `No need to trim data for ${queryName}: size=${oldSize} (limit=${maxSize}), byteSize=${oldByteSize.toLocaleString()} (limit=${maxBytes.toLocaleString()})`
-      );
-      return;
-    }
-    log(
-      `Need to trim ${queryName}: numToCut=${numToCut}, bytesToCut=${bytesToCut}`
-    );
-    const newState = { ...oldState };
-    let needUpdate = false;
-    const deleteKeyIfNotMounted = (key, expired) => {
-      if (mountedKeys.has(key)) {
-        log(`Cannot clean up ${key} as it is mounted`);
-        return;
-      }
-      const byteSize = getByteSize(key) + getByteSize(newState[key]);
-      log(
-        `Cleaning up unmounted${expired ? ", expired" : ""} ${key} (byteSize=${byteSize.toLocaleString()})`
-      );
-      numToCut--;
-      bytesToCut -= byteSize;
-      delete newState[key];
-      needUpdate = true;
-    };
-    let entriesByTimeAscending = Object.entries(newState).sort(
-      (entry1, entry2) => entry1[1].lastUpdatedMs - entry2[1].lastUpdatedMs
-    );
-    for (const [key] of entriesByTimeAscending) {
-      if (!isExpired(newState[key].lastUpdatedMs)) {
-        break;
-      }
-      deleteKeyIfNotMounted(key, true);
-    }
-    if (numToCut > 0 || bytesToCut > 0) {
-      if (needUpdate) {
-        entriesByTimeAscending = Object.entries(newState).sort(
-          (entry1, entry2) => entry1[1].lastUpdatedMs - entry2[1].lastUpdatedMs
-        );
-      }
-      for (const [key] of entriesByTimeAscending) {
-        deleteKeyIfNotMounted(key, false);
-        if (numToCut <= 0 && bytesToCut <= 0) {
-          break;
-        }
-      }
-    }
-    if (!needUpdate) {
-      log(
-        `No trimmable entries found for ${queryName}: size=${oldSize} (limit=${maxSize}), byteSize=${oldByteSize.toLocaleString()} (limit=${maxBytes.toLocaleString()})`
-      );
-      return;
-    }
-    queryState.setValue(newState);
-    log(
-      `Trimmed data for ${queryName}: size=[${oldSize} -> ${Object.keys(newState).length}] (limit=${maxSize}), byteSize=[${oldByteSize.toLocaleString()} -> ${getByteSize(newState).toLocaleString()}] (limit=${maxBytes.toLocaleString()})`
-    );
-  }
-  function setData(queryKey, data, dataUpdatedMs = Date.now()) {
-    const entry = {
-      lastUpdatedMs: Date.now(),
-      loading: false,
-      data,
-      dataUpdatedMs
-    };
-    queryState.setValue((prev) => ({ ...prev, [queryKey]: entry }));
-    enforceSizeLimit();
-  }
-  async function startFetching(queryKey, queryType, args) {
-    log(`Start fetching ${queryKey}, queryType=${queryType}`);
-    try {
-      const data = await (queryType === "refetch" && refetchFn ? refetchFn(...args) : queryFn(...args));
-      log(`Successfully fetched ${queryKey}`);
-      setData(queryKey, data, Date.now());
-      return data;
-    } catch (e) {
-      log(`Failed to fetch ${queryKey} for queryType=${queryType}: ${e}`);
-      throw e;
-    } finally {
-      inflightQueries.delete(queryKey);
-    }
-  }
-  function dedupedFetch(queryKey, queryType, ...args) {
-    const inflightQuery = inflightQueries.get(queryKey);
-    if (inflightQuery) {
-      log(
-        `Deduplicating inflight fetch for ${queryKey}, queryType=${queryType}`
-      );
-      return inflightQuery.promise;
-    }
-    const promise = startFetching(queryKey, queryType, args);
-    const abortController = new AbortController();
-    inflightQueries.set(queryKey, { promise, abortController });
-    return promise;
-  }
-  const obj = {
-    queryName,
-    queryFn,
-    refetchFn,
-    expiryMs,
-    staleMs,
-    refetchOnStale,
-    maxSize,
-    maxBytes,
-    keepLastNonEmptyData,
-    log,
-    queryState,
-    /** Returns a key to identify requests based on the given args. */
-    getQueryKey(args) {
-      let s = stringifyDeterministicForKeys(args);
-      if (s.length > 30) {
-        s = XXH.h32(s, 39406).toString(16).slice(2);
-      }
-      return queryName + ":" + s;
-    },
-    /**
-     * Get the AbortController to abort the inflight query (if any).
-     *
-     * Note that once you get the controller, you can also get the signal easily
-     * using `controller.signal`. So if you need both the controller and the
-     * signal, just use this function.
-     */
-    getAbortController(args) {
-      const queryKey = obj.getQueryKey(args);
-      return obj.getAbortControllerByKey(queryKey);
-    },
-    getAbortControllerByKey(queryKey) {
-      return inflightQueries.get(queryKey)?.abortController ?? null;
-    },
-    /**
-     * Get the AbortSignal to check for query abortions.
-     *
-     * Example using fetch:
-     * ```
-     *   const getUserQuery = sharedQuery({
-     *     queryName: "getUser",
-     *     queryFn: (userId: string) => {
-     *       // Get the signal for this current execution.
-     *       const signal = getUserQuery.getAbortSignal([userId]);
-     *
-     *       // Pass the signal to fetch so that it can be aborted.
-     *       const response = await fetch(`/users/${userId}`, { signal });
-     *
-     *       // Check for errors.
-     *       if (!response.ok) {
-     *         throw new Error(response.statusText);
-     *       }
-     *
-     *       // Return the data.
-     *       return await response.json();
-     *     },
-     *   });
-     * ```
-     *
-     * Example using `http.ts`:
-     * ```
-     *   const getUserQuery = sharedQuery({
-     *     queryName: "getUser",
-     *     queryFn: (userId: string) => {
-     *       // Get the signal for this current execution.
-     *       const signal = getUserQuery.getAbortSignal([userId]);
-     *
-     *       // Pass the signal to fetch so that it can be aborted.
-     *       const response = await http.get(`/users/${userId}`, { signal });
-     *       return await response.json();
-     *     },
-     *   });
-     * ```
-     */
-    getAbortSignal(args) {
-      const queryKey = obj.getQueryKey(args);
-      return obj.getAbortSignalByKey(queryKey);
-    },
-    getAbortSignalByKey(queryKey) {
-      return obj.getAbortControllerByKey(queryKey)?.signal ?? null;
-    },
-    /** For cached data, we need to return the correct timestamps as well. */
-    async getCachedOrFetch(...args) {
-      const startMs = Date.now();
-      await queryState.readyPromise;
-      const waitedMs = Date.now() - startMs;
-      const queryKey = obj.getQueryKey(args);
-      const cached = queryState.getSnapshot()?.[queryKey];
-      if (waitedMs) {
-        log(`${queryKey}: Waited for ${waitedMs}ms before data is ready`);
-      }
-      if (cached?.data && !isExpired(cached.dataUpdatedMs ?? 0)) {
-        if (!isStale(cached.dataUpdatedMs ?? 0)) {
-          log(`Return fresh data ${queryKey} from cache without fetching`);
-          return cached;
-        }
-        if (refetchOnStale) {
-          log(`refetchOnStale for ${queryKey}`);
-          void dedupedFetch(queryKey, "query", ...args);
-        }
-        log(`Returning stale data for ${queryKey}`);
-        return cached;
-      }
-      const data = await dedupedFetch(queryKey, "query", ...args);
-      const now = Date.now();
-      return {
-        // Don't keep old error.
-        lastUpdatedMs: now,
-        loading: false,
-        data,
-        dataUpdatedMs: now
-      };
-    },
-    /** Get the entire stored entry for a query key. */
-    getQueryValue(queryKey) {
-      return queryState.getSnapshot()?.[queryKey];
-    },
-    /** Get the current stored data for a query key. */
-    getData(queryKey) {
-      const stateValue = queryState.getSnapshot()?.[queryKey];
-      if (stateValue?.lastUpdatedMs) {
-        if (isExpired(stateValue.lastUpdatedMs)) {
-          obj.deleteData(queryKey);
-          return void 0;
-        }
-      }
-      return stateValue?.data;
-    },
-    /** Set the data directly if the user obtained it from somewhere else. */
-    setData,
-    /**
-     * Do a new fetch even when the data is already cached, but don't fetch if
-     * another fetch is already inflight.
-     */
-    async updateFromSource(...args) {
-      const key = obj.getQueryKey(args);
-      return await dedupedFetch(key, "query", ...args);
-    },
-    /**
-     * Perform an explicit refetch. If `options.refetchFn` was not specified,
-     * then this would be identical to calling `obj.updateFromSource()`.
-     */
-    async refetch(...args) {
-      const key = obj.getQueryKey(args);
-      return await dedupedFetch(key, "refetch", ...args);
-    },
-    /** Delete the cached data for one set of arguments. */
-    deleteData(queryKey) {
-      const record = queryState.getSnapshot();
-      const clone = { ...record };
-      delete clone[queryKey];
-      queryState.setValue(clone);
-      const inflight = inflightQueries.get(queryKey);
-      if (inflight) {
-        inflightQueries.delete(queryKey);
-        inflight.abortController.abort("Deleted");
-      }
-    },
-    /** Delete all currently cached data & all inflight promises. */
-    clear() {
-      queryState.delete();
-      for (const { abortController } of Array.from(inflightQueries.values())) {
-        abortController.abort("Cleared");
-      }
-      inflightQueries.clear();
-    },
-    /** Keep track of mounted keys. */
-    mount(queryKey) {
-      mountedKeys.set(queryKey, (mountedKeys.get(queryKey) ?? 0) + 1);
-    },
-    /** Clean up mounted keys. */
-    unmount(queryKey) {
-      const count = mountedKeys.get(queryKey);
-      if (count === 1) {
-        mountedKeys.delete(queryKey);
-      } else {
-        mountedKeys.set(queryKey, (count ?? 0) - 1);
-      }
-    },
-    /**
-     * Discard the oldest entries if the size exceeds the limit. The last
-     * remaining record cannot be deleted no matter what the limit is.
-     */
-    enforceSizeLimit
-  };
-  return obj;
-}
-var DEFAULT_QUERY_STATE_ENTRY = {
-  lastUpdatedMs: 0,
-  loading: true
-};
-function useSharedQuery(query, ...args) {
-  const stableArgs = useDeepMemo(args);
-  const [queryState, setQueryState] = useSharedState(query.queryState);
-  const isMounted = useRef(true);
-  const queryKey = useMemo(
-    () => query.getQueryKey(stableArgs),
-    [query, stableArgs]
-  );
-  const queryStateValue = queryState[queryKey] ?? DEFAULT_QUERY_STATE_ENTRY;
-  const setQueryStateValue = useCallback(
-    (next) => {
-      setQueryState((prev) => {
-        const clone = { ...prev };
-        clone[queryKey] = typeof next === "function" ? next(clone[queryKey] ?? DEFAULT_QUERY_STATE_ENTRY) : next;
-        return clone;
-      });
-    },
-    [queryKey, setQueryState]
-  );
-  const [lastNonEmptyData, setLastNonEmptyData] = useState();
-  useEffect(() => {
-    if (query.keepLastNonEmptyData && queryStateValue.data !== void 0) {
-      setLastNonEmptyData(queryStateValue.data);
-    }
-  }, [query.keepLastNonEmptyData, queryStateValue.data]);
-  const executeQuery = useCallback(
-    async (isRefetch) => {
-      query.log(
-        `Begin executing shared query ${queryKey}, isRefetch=${isRefetch}`
-      );
-      if (!isMounted.current) return;
-      setQueryStateValue((prev) => ({
-        // Keep old data and error.
-        ...prev,
-        lastUpdatedMs: Date.now(),
-        loading: true
-      }));
-      try {
-        let state;
-        if (isRefetch) {
-          const data = await query.refetch(...stableArgs);
-          const now = Date.now();
-          state = {
-            // Don't keep old error.
-            lastUpdatedMs: now,
-            loading: false,
-            data,
-            dataUpdatedMs: now
-          };
-        } else {
-          state = await query.getCachedOrFetch(...stableArgs);
-        }
-        if (!isMounted.current) return;
-        setQueryStateValue({ ...state, loading: false });
-        return state.data;
-      } catch (e) {
-        if (!isMounted.current) return;
-        const now = Date.now();
-        setQueryStateValue((prev) => ({
-          // Keep old data.
-          ...prev,
-          lastUpdatedMs: now,
-          loading: false,
-          error: e,
-          errorUpdatedMs: now
-        }));
-      }
-    },
-    [query, queryKey, setQueryStateValue, stableArgs]
-  );
-  useEffect(() => {
-    isMounted.current = true;
-    query.mount(queryKey);
-    void executeQuery(false);
-    return () => {
-      isMounted.current = false;
-      query.unmount(queryKey);
-    };
-  }, [executeQuery, query, queryKey]);
-  return useMemo(() => {
-    return {
-      ...queryStateValue,
-      // Fill with lastNonEmptyData when data is undefined.
-      data: queryStateValue.data !== void 0 ? queryStateValue.data : lastNonEmptyData,
-      latestData: queryStateValue.data,
-      // This works only if the user-given queryFn supports abort. If not,
-      // this function doesn't do anything, since we don't have any means to
-      // abort the running queryFn.
-      abortCurrentQuery: (reason) => {
-        const controller = query.getAbortControllerByKey(queryKey);
-        controller?.abort(reason);
-        return Boolean(controller);
-      },
-      getCachedOrFetch: async () => {
-        const data = await query.getCachedOrFetch(...stableArgs);
-        return nonNil(
-          data.data,
-          typeof data.error === "string" ? data.error : JSON.stringify(data.error)
-        );
-      },
-      refetch: () => {
-        return executeQuery(true);
-      },
-      setData: (data, dataUpdatedMs) => {
-        query.setData(queryKey, data, dataUpdatedMs);
-      },
-      deleteData: () => {
-        query.deleteData(queryKey);
-      }
-    };
-  }, [
-    executeQuery,
-    lastNonEmptyData,
-    query,
-    queryKey,
-    queryStateValue,
-    stableArgs
-  ]);
-}
-
-export {
-  SharedQueryConfig,
-  configureSharedQuery,
-  sharedQuery,
-  useSharedQuery
-};

package/chunk-HRE7YPUJ.min.mjs

@@ -1,2 +0,0 @@
-var g=Object.create;var e=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var j=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var m=(b,a)=>()=>(a||b((a={exports:{}}).exports,a),a.exports),n=(b,a)=>{for(var c in a)e(b,c,{get:a[c],enumerable:!0})},l=(b,a,c,f)=>{if(a&&typeof a=="object"||typeof a=="function")for(let d of i(a))!k.call(b,d)&&d!==c&&e(b,d,{get:()=>a[d],enumerable:!(f=h(a,d))||f.enumerable});return b};var o=(b,a,c)=>(c=b!=null?g(j(b)):{},l(a||!b||!b.__esModule?e(c,"default",{value:b,enumerable:!0}):c,b));export{m as a,n as b,o as c};
-//# sourceMappingURL=chunk-HRE7YPUJ.min.mjs.map

package/chunk-HRE7YPUJ.min.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/chunk-IS3BZTWE.cjs

@@ -1,35 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-
-
-
-
-exports.__commonJS = __commonJS; exports.__export = __export; exports.__toESM = __toESM;

package/chunk-JOHZV3FD.min.cjs

@@ -1,2 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _lodashes = require('lodash-es');var _react = require('react');function f(t){let[e,r]=_react.useState.call(void 0, t);return _react.useMemo.call(void 0, ()=>_lodashes.isEqual.call(void 0, e,t)?e:(r(t),t),[e,t])}exports.a = f;
-//# sourceMappingURL=chunk-JOHZV3FD.min.cjs.map

package/chunk-JOHZV3FD.min.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useDeepMemo.ts"],"names":["useDeepMemo","value","state","setState","useState","useMemo","isEqual"],"mappings":"AAYA,8GAAwB,8BACU,SAMlBA,CAAAA,CAAeC,CAAAA,CAAa,CAC1C,GAAM,CAACC,CAAAA,CAAOC,CAAQ,CAAA,CAAIC,6BAAAA,CAAiB,CAAA,CAE3C,OAAOC,4BAAAA,CAAQ,CAAA,EACTC,+BAAAA,CAAQJ,CAAOD,CAAK,CAAA,CACfC,CAAAA,CAAAA,CAKTC,CAAAA,CAASF,CAAK,CAAA,CAEPA,CAAAA,CAAAA,CACN,CAACC,CAAAA,CAAOD,CAAK,CAAC,CACnB,CAAA,cAAA","file":"/Users/choksheaklau/src/react-utils/dist/chunk-JOHZV3FD.min.cjs","sourcesContent":["/**\n * @packageDocumentation\n *\n * Provides a memoized value in React where the value is checked for deep\n * equality. If the value has changed, but is deeply equal to the previous\n * value, then useDeepMemo will return the same reference to the previous\n * value and ignore the latest value.\n *\n * This is mainly used in shared queries to check for changes in the query\n * arguments, but it might be useful for your own use cases.\n */\n\nimport { isEqual } from \"lodash-es\";\nimport { useMemo, useState } from \"react\";\n\n/**\n * Provides a stable value for T based on deep equality. The deep equality is\n * determined by the `isEqual()` function in lodash.\n */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (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"]}

package/chunk-KGN4HQPP.min.cjs

@@ -1,2 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});function e(n){let t=new Set;return JSON.stringify(n,(s,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(t.has(r))return"[Circular]";if(t.add(r),r!==n)try{JSON.stringify(r)}catch (e2){return"[Unserializable]"}return Object.keys(r).sort().reduce((i,o)=>(i[o]=r[o],i),{})})}exports.a = e;
-//# sourceMappingURL=chunk-KGN4HQPP.min.cjs.map

package/chunk-KGN4HQPP.min.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/stringify.ts"],"names":["stringifyDeterministicForKeys","params","cache","_","value","result","key"],"mappings":"AAmBO,kFAASA,CAAAA,CAA8BC,CAAAA,CAAyB,CACrE,IAAMC,CAAAA,CAAQ,IAAI,GAAA,CAElB,OAAO,IAAA,CAAK,SAAA,CAAUD,CAAAA,CAAQ,CAACE,CAAAA,CAAGC,CAAAA,CAAAA,EAAU,CAC1C,EAAA,CAAI,OAAOA,CAAAA,EAAU,UAAA,CACnB,MAAM,IAAI,KAAA,CAAM,sDAAsD,CAAA,CAGxE,EAAA,CAAI,CAACA,CAAAA,EAAS,OAAOA,CAAAA,EAAU,QAAA,EAAY,KAAA,CAAM,OAAA,CAAQA,CAAK,CAAA,CAC5D,OAAOA,CAAAA,CAGT,EAAA,CAAIF,CAAAA,CAAM,GAAA,CAAIE,CAAK,CAAA,CAEjB,MAAO,YAAA,CAOT,EAAA,CAJAF,CAAAA,CAAM,GAAA,CAAIE,CAAK,CAAA,CAIXA,CAAAA,GAAUH,CAAAA,CACZ,GAAI,CACF,IAAA,CAAK,SAAA,CAAUG,CAAK,CACtB,CAAA,UAAQ,CACN,MAAO,kBACT,CAGF,OAAO,MAAA,CAAO,IAAA,CAAKA,CAAK,CAAA,CACrB,IAAA,CAAK,CAAA,CACL,MAAA,CACC,CAACC,CAAAA,CAAiCC,CAAAA,CAAAA,EAAAA,CAChCD,CAAAA,CAAOC,CAAG,CAAA,CAAIF,CAAAA,CAAME,CAAG,CAAA,CAChBD,CAAAA,CAAAA,CAET,CAAC,CACH,CACJ,CAAC,CACH,CAAA,cAAA","file":"/Users/choksheaklau/src/react-utils/dist/chunk-KGN4HQPP.min.cjs","sourcesContent":["/**\n * @packageDocumentation\n *\n * Implements special stringify for use in the shared queries. This will likely\n * not be reusable for your own use cases.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\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"]}