@choksheak/react-utils 0.4.6 → 0.4.8

package/NoSSR.cjs

@@ -1,37 +1,14 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-IS3BZTWE.cjs');
 
 // src/NoSSR.tsx
-var NoSSR_exports = {};
-__export(NoSSR_exports, {
-  NoSSR: () => NoSSR
-});
-module.exports = __toCommonJS(NoSSR_exports);
-var import_react = require("react");
+var _react = require('react');
 var NoSSR = ({ children, fallback }) => {
-  const [isClient, setIsClient] = (0, import_react.useState)(false);
-  (0, import_react.useEffect)(() => {
+  const [isClient, setIsClient] = _react.useState.call(void 0, false);
+  _react.useEffect.call(void 0, () => {
     setIsClient(true);
   }, []);
   return isClient ? children : fallback;
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  NoSSR
-});
+
+
+exports.NoSSR = NoSSR;

package/{NoSSR.mjs → NoSSR.js}

@@ -1,3 +1,5 @@
+import "./chunk-U67V476Y.js";
+
 // src/NoSSR.tsx
 import { useEffect, useState } from "react";
 var NoSSR = ({ children, fallback }) => {

package/NoSSR.min.cjs

@@ -1,2 +1,15 @@
-"use strict";var a=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var n=(t,e)=>{for(var o in e)a(t,o,{get:e[o],enumerable:!0})},p=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of S(e))!l.call(t,c)&&c!==o&&a(t,c,{get:()=>e[c],enumerable:!(r=R(e,c))||r.enumerable});return t};var N=t=>p(a({},"__esModule",{value:!0}),t);var i={};n(i,{NoSSR:()=>f});module.exports=N(i);var s=require("react"),f=({children:t,fallback:e})=>{let[o,r]=(0,s.useState)(!1);return(0,s.useEffect)(()=>{r(!0)},[]),o?t:e};0&&(module.exports={NoSSR});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-TST6JKQ5.min.cjs');
+
+// src/NoSSR.tsx
+var _react = require('react');
+var NoSSR = ({ children, fallback }) => {
+  const [isClient, setIsClient] = _react.useState.call(void 0, false);
+  _react.useEffect.call(void 0, () => {
+    setIsClient(true);
+  }, []);
+  return isClient ? children : fallback;
+};
+
+
+exports.NoSSR = NoSSR;
 //# sourceMappingURL=NoSSR.min.cjs.map

package/NoSSR.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/NoSSR.tsx"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Wraps components in <NoSSR>...</NoSSR> to make sure they only render on the\n * client side, and not on the server side.\n */\n\nimport React, { ReactNode, useEffect, useState } from \"react\";\n\n/** Props for the NoSSR component. */\nexport type NoSSRProps = {\n  /** The content to render only on the client side. */\n  children: ReactNode;\n\n  /** A component to render during SSR or initial load. */\n  fallback?: ReactNode;\n};\n\n/**\n * A component that prevents its children from being rendered during\n * Server-Side Rendering (SSR). It renders a optional fallback during SSR, and\n * only renders its children after the component has mounted on the client.\n */\nexport const NoSSR: React.FC<NoSSRProps> = ({ children, fallback }) => {\n  const [isClient, setIsClient] = useState(false);\n\n  // 2. useEffect runs ONLY on the client after the initial hydration is complete.\n  useEffect(() => {\n    // This forces the component to render a second time.\n    // eslint-disable-next-line react-hooks/set-state-in-effect\n    setIsClient(true);\n  }, []);\n\n  return isClient ? children : fallback;\n};\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,WAAAE,IAAA,eAAAC,EAAAH,GAOA,IAAAI,EAAsD,iBAgBzCF,EAA8B,CAAC,CAAE,SAAAG,EAAU,SAAAC,CAAS,IAAM,CACrE,GAAM,CAACC,EAAUC,CAAW,KAAI,YAAS,EAAK,EAG9C,sBAAU,IAAM,CAGdA,EAAY,EAAI,CAClB,EAAG,CAAC,CAAC,EAEED,EAAWF,EAAWC,CAC/B","names":["NoSSR_exports","__export","NoSSR","__toCommonJS","import_react","children","fallback","isClient","setIsClient"]}
+{"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/NoSSR.min.cjs","../src/NoSSR.tsx"],"names":[],"mappings":"AAAA,6GAAiC;AACjC;AACA;ACKA,8BAAsD;AAgB/C,IAAM,MAAA,EAA8B,CAAC,EAAE,QAAA,EAAU,SAAS,CAAA,EAAA,GAAM;AACrE,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,EAAA,EAAI,6BAAA,KAAc,CAAA;AAG9C,EAAA,8BAAA,CAAU,EAAA,GAAM;AAGd,IAAA,WAAA,CAAY,IAAI,CAAA;AAAA,EAClB,CAAA,EAAG,CAAC,CAAC,CAAA;AAEL,EAAA,OAAO,SAAA,EAAW,SAAA,EAAW,QAAA;AAC/B,CAAA;ADvBA;AACE;AACF,sBAAC","file":"/Users/choksheaklau/src/react-utils/dist/NoSSR.min.cjs","sourcesContent":[null,"/**\n * @packageDocumentation\n *\n * Wraps components in <NoSSR>...</NoSSR> to make sure they only render on the\n * client side, and not on the server side.\n */\n\nimport React, { ReactNode, useEffect, useState } from \"react\";\n\n/** Props for the NoSSR component. */\nexport type NoSSRProps = {\n  /** The content to render only on the client side. */\n  children: ReactNode;\n\n  /** A component to render during SSR or initial load. */\n  fallback?: ReactNode;\n};\n\n/**\n * A component that prevents its children from being rendered during\n * Server-Side Rendering (SSR). It renders a optional fallback during SSR, and\n * only renders its children after the component has mounted on the client.\n */\nexport const NoSSR: React.FC<NoSSRProps> = ({ children, fallback }) => {\n  const [isClient, setIsClient] = useState(false);\n\n  // 2. useEffect runs ONLY on the client after the initial hydration is complete.\n  useEffect(() => {\n    // This forces the component to render a second time.\n    // eslint-disable-next-line react-hooks/set-state-in-effect\n    setIsClient(true);\n  }, []);\n\n  return isClient ? children : fallback;\n};\n"]}

package/NoSSR.min.js

@@ -0,0 +1,15 @@
+import "./chunk-PHITDXZT.min.js";
+
+// src/NoSSR.tsx
+import { useEffect, useState } from "react";
+var NoSSR = ({ children, fallback }) => {
+  const [isClient, setIsClient] = useState(false);
+  useEffect(() => {
+    setIsClient(true);
+  }, []);
+  return isClient ? children : fallback;
+};
+export {
+  NoSSR
+};
+//# sourceMappingURL=NoSSR.min.js.map

package/{NoSSR.min.mjs.map → NoSSR.min.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/NoSSR.tsx"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Wraps components in <NoSSR>...</NoSSR> to make sure they only render on the\n * client side, and not on the server side.\n */\n\nimport React, { ReactNode, useEffect, useState } from \"react\";\n\n/** Props for the NoSSR component. */\nexport type NoSSRProps = {\n  /** The content to render only on the client side. */\n  children: ReactNode;\n\n  /** A component to render during SSR or initial load. */\n  fallback?: ReactNode;\n};\n\n/**\n * A component that prevents its children from being rendered during\n * Server-Side Rendering (SSR). It renders a optional fallback during SSR, and\n * only renders its children after the component has mounted on the client.\n */\nexport const NoSSR: React.FC<NoSSRProps> = ({ children, fallback }) => {\n  const [isClient, setIsClient] = useState(false);\n\n  // 2. useEffect runs ONLY on the client after the initial hydration is complete.\n  useEffect(() => {\n    // This forces the component to render a second time.\n    // eslint-disable-next-line react-hooks/set-state-in-effect\n    setIsClient(true);\n  }, []);\n\n  return isClient ? children : fallback;\n};\n"],"mappings":"AAOA,OAA2B,aAAAA,EAAW,YAAAC,MAAgB,QAgB/C,IAAMC,EAA8B,CAAC,CAAE,SAAAC,EAAU,SAAAC,CAAS,IAAM,CACrE,GAAM,CAACC,EAAUC,CAAW,EAAIL,EAAS,EAAK,EAG9C,OAAAD,EAAU,IAAM,CAGdM,EAAY,EAAI,CAClB,EAAG,CAAC,CAAC,EAEED,EAAWF,EAAWC,CAC/B","names":["useEffect","useState","NoSSR","children","fallback","isClient","setIsClient"]}
+{"version":3,"sources":["../src/NoSSR.tsx"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Wraps components in <NoSSR>...</NoSSR> to make sure they only render on the\n * client side, and not on the server side.\n */\n\nimport React, { ReactNode, useEffect, useState } from \"react\";\n\n/** Props for the NoSSR component. */\nexport type NoSSRProps = {\n  /** The content to render only on the client side. */\n  children: ReactNode;\n\n  /** A component to render during SSR or initial load. */\n  fallback?: ReactNode;\n};\n\n/**\n * A component that prevents its children from being rendered during\n * Server-Side Rendering (SSR). It renders a optional fallback during SSR, and\n * only renders its children after the component has mounted on the client.\n */\nexport const NoSSR: React.FC<NoSSRProps> = ({ children, fallback }) => {\n  const [isClient, setIsClient] = useState(false);\n\n  // 2. useEffect runs ONLY on the client after the initial hydration is complete.\n  useEffect(() => {\n    // This forces the component to render a second time.\n    // eslint-disable-next-line react-hooks/set-state-in-effect\n    setIsClient(true);\n  }, []);\n\n  return isClient ? children : fallback;\n};\n"],"mappings":";;;AAOA,SAA2B,WAAW,gBAAgB;AAgB/C,IAAM,QAA8B,CAAC,EAAE,UAAU,SAAS,MAAM;AACrE,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,KAAK;AAG9C,YAAU,MAAM;AAGd,gBAAY,IAAI;AAAA,EAClB,GAAG,CAAC,CAAC;AAEL,SAAO,WAAW,WAAW;AAC/B;","names":[]}

package/chunk-4YV72T4D.min.js

@@ -0,0 +1,105 @@
+// src/storage.ts
+import { kvStore } from "@choksheak/ts-utils/kvStore";
+import { createLocalStore } from "@choksheak/ts-utils/localStore";
+var IS_NOT_BROWSER = typeof window === "undefined";
+function getStorageAdapter(options, defaultStoreExpiryMs) {
+  const { store } = options ?? {};
+  if (!store) {
+    return null;
+  }
+  if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
+    const expiryMs = store.expiryMs || defaultStoreExpiryMs;
+    const config = { ...store, expiryMs };
+    switch (store.persistTo) {
+      case "localStorage":
+        return localStoreAdapter(config);
+      case "indexedDb":
+        return kvStoreAdapter(config);
+      default:
+        store.persistTo;
+        throw new Error(`Unknown store.adapter ${store.persistTo}`);
+    }
+  }
+  return store;
+}
+function localStoreAdapter({
+  key,
+  expiryMs,
+  isValid
+}) {
+  const STORE_NAME = "react-utils";
+  const adapter = createLocalStore(STORE_NAME, {
+    defaultExpiryMs: expiryMs
+  });
+  const keyPrefix = key + ":";
+  return {
+    set: (key2, value) => {
+      if (IS_NOT_BROWSER) return;
+      adapter.set(keyPrefix + key2, value);
+    },
+    get: (key2) => {
+      if (IS_NOT_BROWSER) return void 0;
+      const fullKey = keyPrefix + key2;
+      const value = adapter.get(fullKey);
+      if (value !== void 0 && isValid && !isValid(value)) {
+        console.warn(
+          `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`
+        );
+        adapter.delete(fullKey);
+        return void 0;
+      }
+      return value;
+    },
+    delete: (key2) => {
+      if (IS_NOT_BROWSER) return;
+      adapter.delete(keyPrefix + key2);
+    },
+    /** Note that this will clear all keys in all shared states. */
+    clear: () => {
+      if (IS_NOT_BROWSER) return;
+      adapter.clear();
+    }
+  };
+}
+function kvStoreAdapter({
+  key,
+  expiryMs,
+  isValid
+}) {
+  const keyPrefix = key + ":";
+  return {
+    set: async (key2, value) => {
+      if (IS_NOT_BROWSER) return;
+      await kvStore.set(keyPrefix + key2, value, expiryMs);
+    },
+    get: async (key2) => {
+      if (IS_NOT_BROWSER) return void 0;
+      const fullKey = keyPrefix + key2;
+      const value = await kvStore.get(fullKey);
+      if (value !== void 0 && isValid && !isValid(value)) {
+        console.warn(
+          `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
+          value
+        );
+        await kvStore.delete(fullKey);
+        return void 0;
+      }
+      return value;
+    },
+    delete: async (key2) => {
+      if (IS_NOT_BROWSER) return;
+      await kvStore.delete(keyPrefix + key2);
+    },
+    clear: async () => {
+      if (IS_NOT_BROWSER) return;
+      await kvStore.clear();
+    }
+  };
+}
+
+export {
+  getStorageAdapter,
+  localStoreAdapter,
+  kvStoreAdapter
+};
+//# sourceMappingURL=chunk-4YV72T4D.min.js.map

package/{storage.min.mjs.map → chunk-4YV72T4D.min.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Backing storage implementation for the shared state. Note that this uses the\n * LocalStore and KvStore from package \"@choksheak/ts-utils\", but is customized\n * to be used for shared states.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\nimport { Duration } from \"@choksheak/ts-utils/duration\";\nimport { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { createLocalStore } from \"@choksheak/ts-utils/localStore\";\nimport { StorageAdapter } from \"@choksheak/ts-utils/storageAdapter\";\n\n/** List of all available pre-built persistence options. */\nexport type PersistTo = \"localStorage\" | \"indexedDb\";\n\n/** Options to configure a pre-built store adapter. */\nexport type StoreOptions = {\n  /** Choose which pre-built store adapter to use. */\n  persistTo: PersistTo;\n\n  /** Storage key to act as a namespace to store the data. */\n  key: string;\n\n  /** How long to wait before the value is considered expired. */\n  expiryMs?: number | Duration;\n\n  /** Returns true if the given value supposed to be of type T is valid. */\n  isValid?: (u: unknown) => boolean;\n};\n\nexport type StoreConstructorArgs = Omit<StoreOptions, \"persistTo\">;\n\n/** Either use a pre-built store, or a custom one you provide. */\nexport type StorageOptions<T> = {\n  /**\n   * You can either specify the storage adapter directly to use a custom\n   * store, or specify the properties to use the pre-built ones.\n   */\n  store?: StorageAdapter<T> | StoreOptions;\n};\n\n// In SSR (Server-Side Rendering) mode, we never want to use our storage\n// adapters for anything.\nconst IS_NOT_BROWSER = typeof window === \"undefined\";\n\n/**\n * Convert a StorageOptions<T> config object into an actual storage adapter, or\n * returns null if a storage adapter is not configured.\n */\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { store } = options ?? {};\n\n  if (!store) {\n    return null;\n  }\n\n  if (\n    \"persistTo\" in store &&\n    typeof store.persistTo === \"string\" &&\n    \"key\" in store &&\n    typeof store.key === \"string\"\n  ) {\n    const expiryMs = store.expiryMs || defaultStoreExpiryMs;\n    const config = { ...store, expiryMs };\n\n    switch (store.persistTo) {\n      case \"localStorage\":\n        return localStoreAdapter<T>(config);\n\n      case \"indexedDb\":\n        return kvStoreAdapter<T>(config);\n\n      default:\n        store.persistTo satisfies never;\n        throw new Error(`Unknown store.adapter ${store.persistTo}`);\n    }\n  }\n\n  return store as StorageAdapter<T>;\n}\n\n/**\n * Create a new SSR-safe local store adapter, which allows users to reuse the\n * same adapter in multiple shared states or shared queries.\n */\nexport function localStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  // Put everything in the same store so that we can GC properly.\n  const STORE_NAME = \"react-utils\";\n\n  const adapter = createLocalStore(STORE_NAME, {\n    defaultExpiryMs: expiryMs,\n  });\n\n  // Use the key prefix as a unique namespace for this store.\n  const keyPrefix = key + \":\";\n\n  return {\n    set: (key: string, value: T): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      // Also apply the custom expiryMs on every item in this store.\n      adapter.set(keyPrefix + key, value);\n    },\n\n    get: (key: string): T | undefined => {\n      if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const fullKey = keyPrefix + key;\n      const value = adapter.get<T>(fullKey);\n\n      // If there is no value, don't try to check for validatity.\n      if (value !== undefined && isValid && !isValid(value)) {\n        console.warn(\n          `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`,\n        );\n        adapter.delete(fullKey);\n        return undefined;\n      }\n\n      return value;\n    },\n\n    delete: (key: string): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.delete(keyPrefix + key);\n    },\n\n    /** Note that this will clear all keys in all shared states. */\n    clear: (): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.clear();\n    },\n  };\n}\n\n/**\n * Create a new SSR-safe indexed DB KV store adapter, which allows users to\n * reuse the same adapter in multiple shared states or shared queries.\n */\nexport function kvStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  // Use the key prefix as a unique namespace for this store.\n  const keyPrefix = key + \":\";\n\n  // Prefix all keys using `keyPrefix` so that we can keep all data in\n  // the same store in the same DB. If we keep the data in different\n  // DB stores, then GC will not be able to clean up abandoned stores.\n  return {\n    set: async (key: string, value: T): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      // Also apply the custom expiryMs on every item in this store.\n      await kvStore.set(keyPrefix + key, value, expiryMs);\n    },\n    get: async (key: string): Promise<T | undefined> => {\n      if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const fullKey = keyPrefix + key;\n      const value = await kvStore.get<T>(fullKey);\n\n      // If there is no value, don't try to check for validatity.\n      if (value !== undefined && isValid && !isValid(value)) {\n        console.warn(\n          `indexedDb adapter: Auto-discard invalid value for ${key}:`,\n          value,\n        );\n        await kvStore.delete(fullKey);\n        return undefined;\n      }\n\n      return value;\n    },\n    delete: async (key: string): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.delete(keyPrefix + key);\n    },\n    clear: async (): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.clear();\n    },\n  };\n}\n"],"mappings":"AAYA,OAAS,WAAAA,MAAe,8BACxB,OAAS,oBAAAC,MAAwB,iCAkCjC,IAAMC,EAAiB,OAAO,OAAW,IAMlC,SAASC,EACdC,EACAC,EAC0B,CAC1B,GAAM,CAAE,MAAAC,CAAM,EAAIF,GAAW,CAAC,EAE9B,GAAI,CAACE,EACH,OAAO,KAGT,GACE,cAAeA,GACf,OAAOA,EAAM,WAAc,UAC3B,QAASA,GACT,OAAOA,EAAM,KAAQ,SACrB,CACA,IAAMC,EAAWD,EAAM,UAAYD,EAC7BG,EAAS,CAAE,GAAGF,EAAO,SAAAC,CAAS,EAEpC,OAAQD,EAAM,UAAW,CACvB,IAAK,eACH,OAAOG,EAAqBD,CAAM,EAEpC,IAAK,YACH,OAAOE,EAAkBF,CAAM,EAEjC,QACE,MAAAF,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT,CAMO,SAASG,EAAqB,CACnC,IAAAE,EACA,SAAAJ,EACA,QAAAK,CACF,EAAyB,CAIvB,IAAMC,EAAUZ,EAFG,cAE0B,CAC3C,gBAAiBM,CACnB,CAAC,EAGKO,EAAYH,EAAM,IAExB,MAAO,CACL,IAAK,CAACA,EAAaI,IAAmB,CAChCb,GAGJW,EAAQ,IAAIC,EAAYH,EAAKI,CAAK,CACpC,EAEA,IAAMJ,GAA+B,CACnC,GAAIT,EAAgB,OAEpB,IAAMc,EAAUF,EAAYH,EACtBI,EAAQF,EAAQ,IAAOG,CAAO,EAGpC,GAAID,IAAU,QAAaH,GAAW,CAACA,EAAQG,CAAK,EAAG,CACrD,QAAQ,KACN,wDAAwDC,CAAO,KAAK,KAAK,UAAUD,CAAK,CAAC,EAC3F,EACAF,EAAQ,OAAOG,CAAO,EACtB,MACF,CAEA,OAAOD,CACT,EAEA,OAASJ,GAAsB,CACzBT,GAEJW,EAAQ,OAAOC,EAAYH,CAAG,CAChC,EAGA,MAAO,IAAY,CACbT,GAEJW,EAAQ,MAAM,CAChB,CACF,CACF,CAMO,SAASH,EAAkB,CAChC,IAAAC,EACA,SAAAJ,EACA,QAAAK,CACF,EAAyB,CAEvB,IAAME,EAAYH,EAAM,IAKxB,MAAO,CACL,IAAK,MAAOA,EAAaI,IAA4B,CAC/Cb,GAGJ,MAAMF,EAAQ,IAAIc,EAAYH,EAAKI,EAAOR,CAAQ,CACpD,EACA,IAAK,MAAOI,GAAwC,CAClD,GAAIT,EAAgB,OAEpB,IAAMc,EAAUF,EAAYH,EACtBI,EAAQ,MAAMf,EAAQ,IAAOgB,CAAO,EAG1C,GAAID,IAAU,QAAaH,GAAW,CAACA,EAAQG,CAAK,EAAG,CACrD,QAAQ,KACN,qDAAqDJ,CAAG,IACxDI,CACF,EACA,MAAMf,EAAQ,OAAOgB,CAAO,EAC5B,MACF,CAEA,OAAOD,CACT,EACA,OAAQ,MAAOJ,GAA+B,CACxCT,GAEJ,MAAMF,EAAQ,OAAOc,EAAYH,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5BT,GAEJ,MAAMF,EAAQ,MAAM,CACtB,CACF,CACF","names":["kvStore","createLocalStore","IS_NOT_BROWSER","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","config","localStoreAdapter","kvStoreAdapter","key","isValid","adapter","keyPrefix","value","fullKey"]}
+{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Backing storage implementation for the shared state. Note that this uses the\n * LocalStore and KvStore from package \"@choksheak/ts-utils\", but is customized\n * to be used for shared states.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\nimport { Duration } from \"@choksheak/ts-utils/duration\";\nimport { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { createLocalStore } from \"@choksheak/ts-utils/localStore\";\nimport { StorageAdapter } from \"@choksheak/ts-utils/storageAdapter\";\n\n/** List of all available pre-built persistence options. */\nexport type PersistTo = \"localStorage\" | \"indexedDb\";\n\n/** Options to configure a pre-built store adapter. */\nexport type StoreOptions = {\n  /** Choose which pre-built store adapter to use. */\n  persistTo: PersistTo;\n\n  /** Storage key to act as a namespace to store the data. */\n  key: string;\n\n  /** How long to wait before the value is considered expired. */\n  expiryMs?: number | Duration;\n\n  /** Returns true if the given value supposed to be of type T is valid. */\n  isValid?: (u: unknown) => boolean;\n};\n\nexport type StoreConstructorArgs = Omit<StoreOptions, \"persistTo\">;\n\n/** Either use a pre-built store, or a custom one you provide. */\nexport type StorageOptions<T> = {\n  /**\n   * You can either specify the storage adapter directly to use a custom\n   * store, or specify the properties to use the pre-built ones.\n   */\n  store?: StorageAdapter<T> | StoreOptions;\n};\n\n// In SSR (Server-Side Rendering) mode, we never want to use our storage\n// adapters for anything.\nconst IS_NOT_BROWSER = typeof window === \"undefined\";\n\n/**\n * Convert a StorageOptions<T> config object into an actual storage adapter, or\n * returns null if a storage adapter is not configured.\n */\nexport function getStorageAdapter<T>(\n  options: StorageOptions<T> | undefined,\n  defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n  const { store } = options ?? {};\n\n  if (!store) {\n    return null;\n  }\n\n  if (\n    \"persistTo\" in store &&\n    typeof store.persistTo === \"string\" &&\n    \"key\" in store &&\n    typeof store.key === \"string\"\n  ) {\n    const expiryMs = store.expiryMs || defaultStoreExpiryMs;\n    const config = { ...store, expiryMs };\n\n    switch (store.persistTo) {\n      case \"localStorage\":\n        return localStoreAdapter<T>(config);\n\n      case \"indexedDb\":\n        return kvStoreAdapter<T>(config);\n\n      default:\n        store.persistTo satisfies never;\n        throw new Error(`Unknown store.adapter ${store.persistTo}`);\n    }\n  }\n\n  return store as StorageAdapter<T>;\n}\n\n/**\n * Create a new SSR-safe local store adapter, which allows users to reuse the\n * same adapter in multiple shared states or shared queries.\n */\nexport function localStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  // Put everything in the same store so that we can GC properly.\n  const STORE_NAME = \"react-utils\";\n\n  const adapter = createLocalStore(STORE_NAME, {\n    defaultExpiryMs: expiryMs,\n  });\n\n  // Use the key prefix as a unique namespace for this store.\n  const keyPrefix = key + \":\";\n\n  return {\n    set: (key: string, value: T): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      // Also apply the custom expiryMs on every item in this store.\n      adapter.set(keyPrefix + key, value);\n    },\n\n    get: (key: string): T | undefined => {\n      if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const fullKey = keyPrefix + key;\n      const value = adapter.get<T>(fullKey);\n\n      // If there is no value, don't try to check for validatity.\n      if (value !== undefined && isValid && !isValid(value)) {\n        console.warn(\n          `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`,\n        );\n        adapter.delete(fullKey);\n        return undefined;\n      }\n\n      return value;\n    },\n\n    delete: (key: string): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.delete(keyPrefix + key);\n    },\n\n    /** Note that this will clear all keys in all shared states. */\n    clear: (): void => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      adapter.clear();\n    },\n  };\n}\n\n/**\n * Create a new SSR-safe indexed DB KV store adapter, which allows users to\n * reuse the same adapter in multiple shared states or shared queries.\n */\nexport function kvStoreAdapter<T>({\n  key,\n  expiryMs,\n  isValid,\n}: StoreConstructorArgs) {\n  // Use the key prefix as a unique namespace for this store.\n  const keyPrefix = key + \":\";\n\n  // Prefix all keys using `keyPrefix` so that we can keep all data in\n  // the same store in the same DB. If we keep the data in different\n  // DB stores, then GC will not be able to clean up abandoned stores.\n  return {\n    set: async (key: string, value: T): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      // Also apply the custom expiryMs on every item in this store.\n      await kvStore.set(keyPrefix + key, value, expiryMs);\n    },\n    get: async (key: string): Promise<T | undefined> => {\n      if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n      const fullKey = keyPrefix + key;\n      const value = await kvStore.get<T>(fullKey);\n\n      // If there is no value, don't try to check for validatity.\n      if (value !== undefined && isValid && !isValid(value)) {\n        console.warn(\n          `indexedDb adapter: Auto-discard invalid value for ${key}:`,\n          value,\n        );\n        await kvStore.delete(fullKey);\n        return undefined;\n      }\n\n      return value;\n    },\n    delete: async (key: string): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.delete(keyPrefix + key);\n    },\n    clear: async (): Promise<void> => {\n      if (IS_NOT_BROWSER) return; // handle SSR\n\n      await kvStore.clear();\n    },\n  };\n}\n"],"mappings":";AAYA,SAAS,eAAe;AACxB,SAAS,wBAAwB;AAkCjC,IAAM,iBAAiB,OAAO,WAAW;AAMlC,SAAS,kBACd,SACA,sBAC0B;AAC1B,QAAM,EAAE,MAAM,IAAI,WAAW,CAAC;AAE9B,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,MACE,eAAe,SACf,OAAO,MAAM,cAAc,YAC3B,SAAS,SACT,OAAO,MAAM,QAAQ,UACrB;AACA,UAAM,WAAW,MAAM,YAAY;AACnC,UAAM,SAAS,EAAE,GAAG,OAAO,SAAS;AAEpC,YAAQ,MAAM,WAAW;AAAA,MACvB,KAAK;AACH,eAAO,kBAAqB,MAAM;AAAA,MAEpC,KAAK;AACH,eAAO,eAAkB,MAAM;AAAA,MAEjC;AACE,cAAM;AACN,cAAM,IAAI,MAAM,yBAAyB,MAAM,SAAS,EAAE;AAAA,IAC9D;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,kBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AAEvB,QAAM,aAAa;AAEnB,QAAM,UAAU,iBAAiB,YAAY;AAAA,IAC3C,iBAAiB;AAAA,EACnB,CAAC;AAGD,QAAM,YAAY,MAAM;AAExB,SAAO;AAAA,IACL,KAAK,CAACA,MAAa,UAAmB;AACpC,UAAI,eAAgB;AAGpB,cAAQ,IAAI,YAAYA,MAAK,KAAK;AAAA,IACpC;AAAA,IAEA,KAAK,CAACA,SAA+B;AACnC,UAAI,eAAgB,QAAO;AAE3B,YAAM,UAAU,YAAYA;AAC5B,YAAM,QAAQ,QAAQ,IAAO,OAAO;AAGpC,UAAI,UAAU,UAAa,WAAW,CAAC,QAAQ,KAAK,GAAG;AACrD,gBAAQ;AAAA,UACN,wDAAwD,OAAO,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,QAC3F;AACA,gBAAQ,OAAO,OAAO;AACtB,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT;AAAA,IAEA,QAAQ,CAACA,SAAsB;AAC7B,UAAI,eAAgB;AAEpB,cAAQ,OAAO,YAAYA,IAAG;AAAA,IAChC;AAAA;AAAA,IAGA,OAAO,MAAY;AACjB,UAAI,eAAgB;AAEpB,cAAQ,MAAM;AAAA,IAChB;AAAA,EACF;AACF;AAMO,SAAS,eAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AAEvB,QAAM,YAAY,MAAM;AAKxB,SAAO;AAAA,IACL,KAAK,OAAOA,MAAa,UAA4B;AACnD,UAAI,eAAgB;AAGpB,YAAM,QAAQ,IAAI,YAAYA,MAAK,OAAO,QAAQ;AAAA,IACpD;AAAA,IACA,KAAK,OAAOA,SAAwC;AAClD,UAAI,eAAgB,QAAO;AAE3B,YAAM,UAAU,YAAYA;AAC5B,YAAM,QAAQ,MAAM,QAAQ,IAAO,OAAO;AAG1C,UAAI,UAAU,UAAa,WAAW,CAAC,QAAQ,KAAK,GAAG;AACrD,gBAAQ;AAAA,UACN,qDAAqDA,IAAG;AAAA,UACxD;AAAA,QACF;AACA,cAAM,QAAQ,OAAO,OAAO;AAC5B,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,OAAOA,SAA+B;AAC5C,UAAI,eAAgB;AAEpB,YAAM,QAAQ,OAAO,YAAYA,IAAG;AAAA,IACtC;AAAA,IACA,OAAO,YAA2B;AAChC,UAAI,eAAgB;AAEpB,YAAM,QAAQ,MAAM;AAAA,IACtB;AAAA,EACF;AACF;","names":["key"]}

package/chunk-5PDGU37E.cjs

@@ -0,0 +1,104 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/storage.ts
+var _kvStore = require('@choksheak/ts-utils/kvStore');
+var _localStore = require('@choksheak/ts-utils/localStore');
+var IS_NOT_BROWSER = typeof window === "undefined";
+function getStorageAdapter(options, defaultStoreExpiryMs) {
+  const { store } = _nullishCoalesce(options, () => ( {}));
+  if (!store) {
+    return null;
+  }
+  if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
+    const expiryMs = store.expiryMs || defaultStoreExpiryMs;
+    const config = { ...store, expiryMs };
+    switch (store.persistTo) {
+      case "localStorage":
+        return localStoreAdapter(config);
+      case "indexedDb":
+        return kvStoreAdapter(config);
+      default:
+        store.persistTo;
+        throw new Error(`Unknown store.adapter ${store.persistTo}`);
+    }
+  }
+  return store;
+}
+function localStoreAdapter({
+  key,
+  expiryMs,
+  isValid
+}) {
+  const STORE_NAME = "react-utils";
+  const adapter = _localStore.createLocalStore.call(void 0, STORE_NAME, {
+    defaultExpiryMs: expiryMs
+  });
+  const keyPrefix = key + ":";
+  return {
+    set: (key2, value) => {
+      if (IS_NOT_BROWSER) return;
+      adapter.set(keyPrefix + key2, value);
+    },
+    get: (key2) => {
+      if (IS_NOT_BROWSER) return void 0;
+      const fullKey = keyPrefix + key2;
+      const value = adapter.get(fullKey);
+      if (value !== void 0 && isValid && !isValid(value)) {
+        console.warn(
+          `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`
+        );
+        adapter.delete(fullKey);
+        return void 0;
+      }
+      return value;
+    },
+    delete: (key2) => {
+      if (IS_NOT_BROWSER) return;
+      adapter.delete(keyPrefix + key2);
+    },
+    /** Note that this will clear all keys in all shared states. */
+    clear: () => {
+      if (IS_NOT_BROWSER) return;
+      adapter.clear();
+    }
+  };
+}
+function kvStoreAdapter({
+  key,
+  expiryMs,
+  isValid
+}) {
+  const keyPrefix = key + ":";
+  return {
+    set: async (key2, value) => {
+      if (IS_NOT_BROWSER) return;
+      await _kvStore.kvStore.set(keyPrefix + key2, value, expiryMs);
+    },
+    get: async (key2) => {
+      if (IS_NOT_BROWSER) return void 0;
+      const fullKey = keyPrefix + key2;
+      const value = await _kvStore.kvStore.get(fullKey);
+      if (value !== void 0 && isValid && !isValid(value)) {
+        console.warn(
+          `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
+          value
+        );
+        await _kvStore.kvStore.delete(fullKey);
+        return void 0;
+      }
+      return value;
+    },
+    delete: async (key2) => {
+      if (IS_NOT_BROWSER) return;
+      await _kvStore.kvStore.delete(keyPrefix + key2);
+    },
+    clear: async () => {
+      if (IS_NOT_BROWSER) return;
+      await _kvStore.kvStore.clear();
+    }
+  };
+}
+
+
+
+
+
+exports.getStorageAdapter = getStorageAdapter; exports.localStoreAdapter = localStoreAdapter; exports.kvStoreAdapter = kvStoreAdapter;

package/{storage.mjs → chunk-7CPBZFDV.js}

@@ -96,8 +96,9 @@ function kvStoreAdapter({
     }
   };
 }
+
 export {
   getStorageAdapter,
-  kvStoreAdapter,
-  localStoreAdapter
+  localStoreAdapter,
+  kvStoreAdapter
 };

package/{stringify.mjs → chunk-7XC6EVMX.js}

@@ -28,6 +28,7 @@ function stringifyDeterministicForKeys(params) {
     );
   });
 }
+
 export {
   stringifyDeterministicForKeys
 };

package/chunk-AXDXFCZV.min.js

@@ -0,0 +1,35 @@
+// src/stringify.ts
+function stringifyDeterministicForKeys(params) {
+  const cache = /* @__PURE__ */ new Set();
+  return JSON.stringify(params, (_, value) => {
+    if (typeof value === "function") {
+      throw new Error(`Functions should not be passed into query parameters`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      return value;
+    }
+    if (cache.has(value)) {
+      return "[Circular]";
+    }
+    cache.add(value);
+    if (value !== params) {
+      try {
+        JSON.stringify(value);
+      } catch {
+        return "[Unserializable]";
+      }
+    }
+    return Object.keys(value).sort().reduce(
+      (result, key) => {
+        result[key] = value[key];
+        return result;
+      },
+      {}
+    );
+  });
+}
+
+export {
+  stringifyDeterministicForKeys
+};
+//# sourceMappingURL=chunk-AXDXFCZV.min.js.map

package/{stringify.min.mjs.map → chunk-AXDXFCZV.min.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/stringify.ts"],"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"],"mappings":"AAmBO,SAASA,EAA8BC,EAAyB,CACrE,IAAMC,EAAQ,IAAI,IAElB,OAAO,KAAK,UAAUD,EAAQ,CAACE,EAAGC,IAAU,CAC1C,GAAI,OAAOA,GAAU,WACnB,MAAM,IAAI,MAAM,sDAAsD,EAGxE,GAAI,CAACA,GAAS,OAAOA,GAAU,UAAY,MAAM,QAAQA,CAAK,EAC5D,OAAOA,EAGT,GAAIF,EAAM,IAAIE,CAAK,EAEjB,MAAO,aAOT,GAJAF,EAAM,IAAIE,CAAK,EAIXA,IAAUH,EACZ,GAAI,CACF,KAAK,UAAUG,CAAK,CACtB,MAAQ,CACN,MAAO,kBACT,CAGF,OAAO,OAAO,KAAKA,CAAK,EACrB,KAAK,EACL,OACC,CAACC,EAAiCC,KAChCD,EAAOC,CAAG,EAAIF,EAAME,CAAG,EAChBD,GAET,CAAC,CACH,CACJ,CAAC,CACH","names":["stringifyDeterministicForKeys","params","cache","_","value","result","key"]}
+{"version":3,"sources":["../src/stringify.ts"],"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"],"mappings":";AAmBO,SAAS,8BAA8B,QAAyB;AACrE,QAAM,QAAQ,oBAAI,IAAI;AAEtB,SAAO,KAAK,UAAU,QAAQ,CAAC,GAAG,UAAU;AAC1C,QAAI,OAAO,UAAU,YAAY;AAC/B,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AAEA,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AAC/D,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,IAAI,KAAK,GAAG;AAEpB,aAAO;AAAA,IACT;AAEA,UAAM,IAAI,KAAK;AAIf,QAAI,UAAU,QAAQ;AACpB,UAAI;AACF,aAAK,UAAU,KAAK;AAAA,MACtB,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO,OAAO,KAAK,KAAK,EACrB,KAAK,EACL;AAAA,MACC,CAAC,QAAiC,QAAgB;AAChD,eAAO,GAAG,IAAI,MAAM,GAAG;AACvB,eAAO;AAAA,MACT;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EACJ,CAAC;AACH;","names":[]}