@choksheak/react-utils 0.3.1 → 0.3.3

package/sharedState.mjs

@@ -5,6 +5,7 @@ import { useSyncExternalStore } from "react";
 // src/storage.ts
 import { kvStore } from "@choksheak/ts-utils/kvStore";
 import { LocalStore } from "@choksheak/ts-utils/localStore";
+var IS_NOT_BROWSER = typeof window === "undefined";
 function getStorageAdapter(options, defaultStoreExpiryMs) {
   const { store } = options ?? {};
   if (!store) {
@@ -12,6 +13,7 @@ function getStorageAdapter(options, defaultStoreExpiryMs) {
   }
   if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
     const expiryMs = store.expiryMs || defaultStoreExpiryMs;
+    const isValid = store.isValid;
     switch (store.persistTo) {
       case "localStorage": {
         const adapter = new LocalStore(store.key, {
@@ -19,40 +21,58 @@ function getStorageAdapter(options, defaultStoreExpiryMs) {
         });
         return {
           set: (key, value) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.set(key, value);
           },
           get: (key) => {
-            if (typeof window === "undefined") return void 0;
-            return adapter.get(key);
+            if (IS_NOT_BROWSER) return void 0;
+            const value = adapter.get(key);
+            if (isValid && !isValid(value)) {
+              console.warn(
+                `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`
+              );
+              adapter.delete(key);
+              return void 0;
+            }
+            return value;
           },
           delete: (key) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.delete(key);
           },
           clear: () => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.clear();
           }
         };
       }
       case "indexedDb": {
         const keyPrefix = store.key + ":";
+        const isValid2 = store.isValid;
         return {
           set: async (key, value) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await kvStore.set(keyPrefix + key, value, expiryMs);
           },
           get: async (key) => {
-            if (typeof window === "undefined") return void 0;
-            return await kvStore.get(keyPrefix + key);
+            if (IS_NOT_BROWSER) return void 0;
+            const fullKey = keyPrefix + key;
+            const value = await kvStore.get(fullKey);
+            if (isValid2 && !isValid2(value)) {
+              console.warn(
+                `indexedDb adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`
+              );
+              await kvStore.delete(fullKey);
+              return void 0;
+            }
+            return value;
           },
           delete: async (key) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await kvStore.delete(keyPrefix + key);
           },
           clear: async () => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await kvStore.clear();
           }
         };
@@ -153,39 +173,65 @@ var SharedState = class {
   setValueBounded;
   initStarted = false;
   initDone = false;
-  // `subscribe` function required by useSyncExternalStore
+  /** `subscribe` function required by useSyncExternalStore. */
   subscribe(subscriber) {
     return pubSubStore.subscribe(this.pubSubKey, () => subscriber());
   }
-  // Get the value of the shared state.
-  // `getSnapshot` function — must return same ref if value unchanged
+  /** Returns true if there is a backing store. */
+  hasStore() {
+    return Boolean(this.storageAdapter);
+  }
+  /**
+   * Set a value directly into the store. Does nothing if there is no
+   * backing store.
+   *
+   * Warning: If you want to set the value properly, you should use
+   * `setValue()` instead which also updates the in-memory copy.
+   */
+  async setInStore(value) {
+    return await this.storageAdapter?.set(STORAGE_KEY, value);
+  }
+  /**
+   * Get a value directly from the store. Returns undefined if there is no
+   * backing store.
+   */
+  async getFromStore() {
+    return await this.storageAdapter?.get(STORAGE_KEY);
+  }
+  /**
+   * Get the value of the shared state.
+   *  `getSnapshot` function — must return same ref if value unchanged.
+   * Note that this would return the default value if data init from store is
+   * not completed yet.
+   */
   getSnapshot() {
     return pubSubStore.get(this.pubSubKey);
   }
-  // Set the value of the shared state.
+  /** Set the value of the shared state. */
   setValue(next) {
     if (typeof next === "function") {
       const prev = pubSubStore.get(this.pubSubKey);
       next = next(prev);
     }
     pubSubStore.set(this.pubSubKey, next);
-    void this.storageAdapter?.set(STORAGE_KEY, next);
+    void this.setInStore(next);
   }
-  // Remove the value of the shared state. Actually this just sets the value
-  // back to the given default value.
+  /**
+   * Remove the value of the shared state. Actually this just sets the value
+   * back to the given default value.
+   */
   delete() {
     pubSubStore.set(this.pubSubKey, this.defaultValue);
     void this.storageAdapter?.set(STORAGE_KEY, this.defaultValue);
   }
-  // Initial default handling
+  /** Initial default handling. */
   async initDefaultValueOnce() {
     if (this.initDone || this.initStarted) return;
     this.initStarted = true;
-    const v = await this.storageAdapter?.get(STORAGE_KEY);
-    const value = v !== void 0 ? v : this.defaultValue;
+    const stored = await this.getFromStore();
+    const value = stored !== void 0 ? stored : this.defaultValue;
     pubSubStore.set(this.pubSubKey, value);
     this.initDone = true;
-    pubSubStore.set(this.pubSubKey, value);
   }
 };
 function sharedState(defaultValue, options) {

package/storage.cjs

@@ -25,6 +25,7 @@ __export(storage_exports, {
 module.exports = __toCommonJS(storage_exports);
 var import_kvStore = require("@choksheak/ts-utils/kvStore");
 var import_localStore = require("@choksheak/ts-utils/localStore");
+var IS_NOT_BROWSER = typeof window === "undefined";
 function getStorageAdapter(options, defaultStoreExpiryMs) {
   const { store } = options ?? {};
   if (!store) {
@@ -32,6 +33,7 @@ function getStorageAdapter(options, defaultStoreExpiryMs) {
   }
   if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
     const expiryMs = store.expiryMs || defaultStoreExpiryMs;
+    const isValid = store.isValid;
     switch (store.persistTo) {
       case "localStorage": {
         const adapter = new import_localStore.LocalStore(store.key, {
@@ -39,40 +41,58 @@ function getStorageAdapter(options, defaultStoreExpiryMs) {
         });
         return {
           set: (key, value) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.set(key, value);
           },
           get: (key) => {
-            if (typeof window === "undefined") return void 0;
-            return adapter.get(key);
+            if (IS_NOT_BROWSER) return void 0;
+            const value = adapter.get(key);
+            if (isValid && !isValid(value)) {
+              console.warn(
+                `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`
+              );
+              adapter.delete(key);
+              return void 0;
+            }
+            return value;
           },
           delete: (key) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.delete(key);
           },
           clear: () => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.clear();
           }
         };
       }
       case "indexedDb": {
         const keyPrefix = store.key + ":";
+        const isValid2 = store.isValid;
         return {
           set: async (key, value) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await import_kvStore.kvStore.set(keyPrefix + key, value, expiryMs);
           },
           get: async (key) => {
-            if (typeof window === "undefined") return void 0;
-            return await import_kvStore.kvStore.get(keyPrefix + key);
+            if (IS_NOT_BROWSER) return void 0;
+            const fullKey = keyPrefix + key;
+            const value = await import_kvStore.kvStore.get(fullKey);
+            if (isValid2 && !isValid2(value)) {
+              console.warn(
+                `indexedDb adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`
+              );
+              await import_kvStore.kvStore.delete(fullKey);
+              return void 0;
+            }
+            return value;
           },
           delete: async (key) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await import_kvStore.kvStore.delete(keyPrefix + key);
           },
           clear: async () => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await import_kvStore.kvStore.clear();
           }
         };

package/storage.d.mts

@@ -2,11 +2,18 @@ import { StorageAdapter } from '@choksheak/ts-utils/storageAdapter';
 
 /** List of all available pre-built persistence options. */
 type PersistTo = "localStorage" | "indexedDb";
+/** Options to configure a pre-built store adapter. */
 type StoreOptions = {
+    /** Choose which pre-built store adapter to use. */
     persistTo: PersistTo;
+    /** Storage key to act as a namespace to store the data. */
     key: string;
+    /** How long to wait before the value is considered expired. */
     expiryMs?: number;
+    /** Returns true if the given value supposed to be of type T is valid. */
+    isValid?: (u: unknown) => boolean;
 };
+/** Either use a pre-built store, or a custom one you provide. */
 type StorageOptions<T> = {
     /**
      * You can either specify the storage adapter directly to use a custom

package/storage.d.ts

@@ -1,11 +1,18 @@
 import { StorageAdapter } from "@choksheak/ts-utils/storageAdapter";
 /** List of all available pre-built persistence options. */
 export type PersistTo = "localStorage" | "indexedDb";
+/** Options to configure a pre-built store adapter. */
 export type StoreOptions = {
+    /** Choose which pre-built store adapter to use. */
     persistTo: PersistTo;
+    /** Storage key to act as a namespace to store the data. */
     key: string;
+    /** How long to wait before the value is considered expired. */
     expiryMs?: number;
+    /** Returns true if the given value supposed to be of type T is valid. */
+    isValid?: (u: unknown) => boolean;
 };
+/** Either use a pre-built store, or a custom one you provide. */
 export type StorageOptions<T> = {
     /**
      * You can either specify the storage adapter directly to use a custom

package/storage.min.cjs

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

package/storage.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { LocalStore } 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\nexport type StoreOptions = {\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;\n};\n\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\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\n    switch (store.persistTo) {\n      case \"localStorage\": {\n        const adapter = new LocalStore(store.key, {\n          defaultExpiryMs: expiryMs,\n        });\n\n        // Handle SSR.\n        return {\n          set: (key: string, value: T): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            // Also apply the custom expiryMs on every item in this store.\n            adapter.set(key, value);\n          },\n          get: (key: string): T | undefined => {\n            if (typeof window === \"undefined\") return undefined; // handle SSR\n\n            return adapter.get(key);\n          },\n          delete: (key: string): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            adapter.delete(key);\n          },\n          clear: (): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            adapter.clear();\n          },\n        };\n      }\n\n      case \"indexedDb\": {\n        // Use the key prefix as a unique namespace for this store.\n        const keyPrefix = store.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 (typeof window === \"undefined\") 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 (typeof window === \"undefined\") return undefined; // handle SSR\n\n            return await kvStore.get(keyPrefix + key);\n          },\n          delete: async (key: string): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            await kvStore.delete(keyPrefix + key);\n          },\n          clear: async (): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            await kvStore.clear();\n          },\n        };\n      }\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"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAwB,uCACxBC,EAA2B,0CAwBpB,SAASH,EACdI,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,EAEnC,OAAQC,EAAM,UAAW,CACvB,IAAK,eAAgB,CACnB,IAAME,EAAU,IAAI,aAAWF,EAAM,IAAK,CACxC,gBAAiBC,CACnB,CAAC,EAGD,MAAO,CACL,IAAK,CAACE,EAAaC,IAAmB,CAChC,OAAO,OAAW,KAGtBF,EAAQ,IAAIC,EAAKC,CAAK,CACxB,EACA,IAAMD,GAA+B,CACnC,GAAI,SAAO,OAAW,KAEtB,OAAOD,EAAQ,IAAIC,CAAG,CACxB,EACA,OAASA,GAAsB,CACzB,OAAO,OAAW,KAEtBD,EAAQ,OAAOC,CAAG,CACpB,EACA,MAAO,IAAY,CACb,OAAO,OAAW,KAEtBD,EAAQ,MAAM,CAChB,CACF,CACF,CAEA,IAAK,YAAa,CAEhB,IAAMG,EAAYL,EAAM,IAAM,IAK9B,MAAO,CACL,IAAK,MAAOG,EAAaC,IAA4B,CAC/C,OAAO,OAAW,KAGtB,MAAM,UAAQ,IAAIC,EAAYF,EAAKC,EAAOH,CAAQ,CACpD,EACA,IAAK,MAAOE,GAAwC,CAClD,GAAI,SAAO,OAAW,KAEtB,OAAO,MAAM,UAAQ,IAAIE,EAAYF,CAAG,CAC1C,EACA,OAAQ,MAAOA,GAA+B,CACxC,OAAO,OAAW,KAEtB,MAAM,UAAQ,OAAOE,EAAYF,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5B,OAAO,OAAW,KAEtB,MAAM,UAAQ,MAAM,CACtB,CACF,CACF,CAEA,QACE,MAAAH,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT","names":["storage_exports","__export","getStorageAdapter","__toCommonJS","import_kvStore","import_localStore","options","defaultStoreExpiryMs","store","expiryMs","adapter","key","value","keyPrefix"]}
+{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { LocalStore } 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;\n\n  /** Returns true if the given value supposed to be of type T is valid. */\n  isValid?: (u: unknown) => boolean;\n};\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\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 isValid = store.isValid;\n\n    switch (store.persistTo) {\n      case \"localStorage\": {\n        const adapter = new LocalStore(store.key, {\n          defaultExpiryMs: expiryMs,\n        });\n\n        // Handle SSR.\n        return {\n          set: (key: string, value: T): void => {\n            if (IS_NOT_BROWSER) return; // handle SSR\n\n            // Also apply the custom expiryMs on every item in this store.\n            adapter.set(key, value);\n          },\n          get: (key: string): T | undefined => {\n            if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n            const value = adapter.get<T>(key);\n\n            if (isValid && !isValid(value)) {\n              console.warn(\n                `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`,\n              );\n              adapter.delete(key);\n              return undefined;\n            }\n\n            return value;\n          },\n          delete: (key: string): void => {\n            if (IS_NOT_BROWSER) return; // handle SSR\n\n            adapter.delete(key);\n          },\n          clear: (): void => {\n            if (IS_NOT_BROWSER) return; // handle SSR\n\n            adapter.clear();\n          },\n        };\n      }\n\n      case \"indexedDb\": {\n        // Use the key prefix as a unique namespace for this store.\n        const keyPrefix = store.key + \":\";\n        const isValid = store.isValid;\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 (isValid && !isValid(value)) {\n              console.warn(\n                `indexedDb adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(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\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"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAwB,uCACxBC,EAA2B,0CAgCrBC,EAAiB,OAAO,OAAW,IAElC,SAASJ,EACdK,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,EAAUF,EAAM,QAEtB,OAAQA,EAAM,UAAW,CACvB,IAAK,eAAgB,CACnB,IAAMG,EAAU,IAAI,aAAWH,EAAM,IAAK,CACxC,gBAAiBC,CACnB,CAAC,EAGD,MAAO,CACL,IAAK,CAACG,EAAaC,IAAmB,CAChCR,GAGJM,EAAQ,IAAIC,EAAKC,CAAK,CACxB,EACA,IAAMD,GAA+B,CACnC,GAAIP,EAAgB,OAEpB,IAAMQ,EAAQF,EAAQ,IAAOC,CAAG,EAEhC,GAAIF,GAAW,CAACA,EAAQG,CAAK,EAAG,CAC9B,QAAQ,KACN,wDAAwDD,CAAG,KAAK,KAAK,UAAUC,CAAK,CAAC,EACvF,EACAF,EAAQ,OAAOC,CAAG,EAClB,MACF,CAEA,OAAOC,CACT,EACA,OAASD,GAAsB,CACzBP,GAEJM,EAAQ,OAAOC,CAAG,CACpB,EACA,MAAO,IAAY,CACbP,GAEJM,EAAQ,MAAM,CAChB,CACF,CACF,CAEA,IAAK,YAAa,CAEhB,IAAMG,EAAYN,EAAM,IAAM,IACxBE,EAAUF,EAAM,QAKtB,MAAO,CACL,IAAK,MAAOI,EAAaC,IAA4B,CAC/CR,GAGJ,MAAM,UAAQ,IAAIS,EAAYF,EAAKC,EAAOJ,CAAQ,CACpD,EACA,IAAK,MAAOG,GAAwC,CAClD,GAAIP,EAAgB,OAEpB,IAAMU,EAAUD,EAAYF,EACtBC,EAAQ,MAAM,UAAQ,IAAOE,CAAO,EAE1C,GAAIL,GAAW,CAACA,EAAQG,CAAK,EAAG,CAC9B,QAAQ,KACN,qDAAqDD,CAAG,KAAK,KAAK,UAAUC,CAAK,CAAC,EACpF,EACA,MAAM,UAAQ,OAAOE,CAAO,EAC5B,MACF,CAEA,OAAOF,CACT,EACA,OAAQ,MAAOD,GAA+B,CACxCP,GAEJ,MAAM,UAAQ,OAAOS,EAAYF,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5BP,GAEJ,MAAM,UAAQ,MAAM,CACtB,CACF,CACF,CAEA,QACE,MAAAG,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT","names":["storage_exports","__export","getStorageAdapter","__toCommonJS","import_kvStore","import_localStore","IS_NOT_BROWSER","options","defaultStoreExpiryMs","store","expiryMs","isValid","adapter","key","value","keyPrefix","fullKey"]}

package/storage.min.mjs

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

package/storage.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { LocalStore } 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\nexport type StoreOptions = {\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;\n};\n\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\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\n    switch (store.persistTo) {\n      case \"localStorage\": {\n        const adapter = new LocalStore(store.key, {\n          defaultExpiryMs: expiryMs,\n        });\n\n        // Handle SSR.\n        return {\n          set: (key: string, value: T): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            // Also apply the custom expiryMs on every item in this store.\n            adapter.set(key, value);\n          },\n          get: (key: string): T | undefined => {\n            if (typeof window === \"undefined\") return undefined; // handle SSR\n\n            return adapter.get(key);\n          },\n          delete: (key: string): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            adapter.delete(key);\n          },\n          clear: (): void => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            adapter.clear();\n          },\n        };\n      }\n\n      case \"indexedDb\": {\n        // Use the key prefix as a unique namespace for this store.\n        const keyPrefix = store.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 (typeof window === \"undefined\") 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 (typeof window === \"undefined\") return undefined; // handle SSR\n\n            return await kvStore.get(keyPrefix + key);\n          },\n          delete: async (key: string): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            await kvStore.delete(keyPrefix + key);\n          },\n          clear: async (): Promise<void> => {\n            if (typeof window === \"undefined\") return; // handle SSR\n\n            await kvStore.clear();\n          },\n        };\n      }\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"],"mappings":"AAAA,OAAS,WAAAA,MAAe,8BACxB,OAAS,cAAAC,MAAkB,iCAwBpB,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,EAEnC,OAAQC,EAAM,UAAW,CACvB,IAAK,eAAgB,CACnB,IAAME,EAAU,IAAIN,EAAWI,EAAM,IAAK,CACxC,gBAAiBC,CACnB,CAAC,EAGD,MAAO,CACL,IAAK,CAACE,EAAaC,IAAmB,CAChC,OAAO,OAAW,KAGtBF,EAAQ,IAAIC,EAAKC,CAAK,CACxB,EACA,IAAMD,GAA+B,CACnC,GAAI,SAAO,OAAW,KAEtB,OAAOD,EAAQ,IAAIC,CAAG,CACxB,EACA,OAASA,GAAsB,CACzB,OAAO,OAAW,KAEtBD,EAAQ,OAAOC,CAAG,CACpB,EACA,MAAO,IAAY,CACb,OAAO,OAAW,KAEtBD,EAAQ,MAAM,CAChB,CACF,CACF,CAEA,IAAK,YAAa,CAEhB,IAAMG,EAAYL,EAAM,IAAM,IAK9B,MAAO,CACL,IAAK,MAAOG,EAAaC,IAA4B,CAC/C,OAAO,OAAW,KAGtB,MAAMT,EAAQ,IAAIU,EAAYF,EAAKC,EAAOH,CAAQ,CACpD,EACA,IAAK,MAAOE,GAAwC,CAClD,GAAI,SAAO,OAAW,KAEtB,OAAO,MAAMR,EAAQ,IAAIU,EAAYF,CAAG,CAC1C,EACA,OAAQ,MAAOA,GAA+B,CACxC,OAAO,OAAW,KAEtB,MAAMR,EAAQ,OAAOU,EAAYF,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5B,OAAO,OAAW,KAEtB,MAAMR,EAAQ,MAAM,CACtB,CACF,CACF,CAEA,QACE,MAAAK,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT","names":["kvStore","LocalStore","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","adapter","key","value","keyPrefix"]}
+{"version":3,"sources":["../src/storage.ts"],"sourcesContent":["import { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { LocalStore } 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;\n\n  /** Returns true if the given value supposed to be of type T is valid. */\n  isValid?: (u: unknown) => boolean;\n};\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\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 isValid = store.isValid;\n\n    switch (store.persistTo) {\n      case \"localStorage\": {\n        const adapter = new LocalStore(store.key, {\n          defaultExpiryMs: expiryMs,\n        });\n\n        // Handle SSR.\n        return {\n          set: (key: string, value: T): void => {\n            if (IS_NOT_BROWSER) return; // handle SSR\n\n            // Also apply the custom expiryMs on every item in this store.\n            adapter.set(key, value);\n          },\n          get: (key: string): T | undefined => {\n            if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n            const value = adapter.get<T>(key);\n\n            if (isValid && !isValid(value)) {\n              console.warn(\n                `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`,\n              );\n              adapter.delete(key);\n              return undefined;\n            }\n\n            return value;\n          },\n          delete: (key: string): void => {\n            if (IS_NOT_BROWSER) return; // handle SSR\n\n            adapter.delete(key);\n          },\n          clear: (): void => {\n            if (IS_NOT_BROWSER) return; // handle SSR\n\n            adapter.clear();\n          },\n        };\n      }\n\n      case \"indexedDb\": {\n        // Use the key prefix as a unique namespace for this store.\n        const keyPrefix = store.key + \":\";\n        const isValid = store.isValid;\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 (isValid && !isValid(value)) {\n              console.warn(\n                `indexedDb adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(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\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"],"mappings":"AAAA,OAAS,WAAAA,MAAe,8BACxB,OAAS,cAAAC,MAAkB,iCAgC3B,IAAMC,EAAiB,OAAO,OAAW,IAElC,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,EAAUF,EAAM,QAEtB,OAAQA,EAAM,UAAW,CACvB,IAAK,eAAgB,CACnB,IAAMG,EAAU,IAAIR,EAAWK,EAAM,IAAK,CACxC,gBAAiBC,CACnB,CAAC,EAGD,MAAO,CACL,IAAK,CAACG,EAAaC,IAAmB,CAChCT,GAGJO,EAAQ,IAAIC,EAAKC,CAAK,CACxB,EACA,IAAMD,GAA+B,CACnC,GAAIR,EAAgB,OAEpB,IAAMS,EAAQF,EAAQ,IAAOC,CAAG,EAEhC,GAAIF,GAAW,CAACA,EAAQG,CAAK,EAAG,CAC9B,QAAQ,KACN,wDAAwDD,CAAG,KAAK,KAAK,UAAUC,CAAK,CAAC,EACvF,EACAF,EAAQ,OAAOC,CAAG,EAClB,MACF,CAEA,OAAOC,CACT,EACA,OAASD,GAAsB,CACzBR,GAEJO,EAAQ,OAAOC,CAAG,CACpB,EACA,MAAO,IAAY,CACbR,GAEJO,EAAQ,MAAM,CAChB,CACF,CACF,CAEA,IAAK,YAAa,CAEhB,IAAMG,EAAYN,EAAM,IAAM,IACxBE,EAAUF,EAAM,QAKtB,MAAO,CACL,IAAK,MAAOI,EAAaC,IAA4B,CAC/CT,GAGJ,MAAMF,EAAQ,IAAIY,EAAYF,EAAKC,EAAOJ,CAAQ,CACpD,EACA,IAAK,MAAOG,GAAwC,CAClD,GAAIR,EAAgB,OAEpB,IAAMW,EAAUD,EAAYF,EACtBC,EAAQ,MAAMX,EAAQ,IAAOa,CAAO,EAE1C,GAAIL,GAAW,CAACA,EAAQG,CAAK,EAAG,CAC9B,QAAQ,KACN,qDAAqDD,CAAG,KAAK,KAAK,UAAUC,CAAK,CAAC,EACpF,EACA,MAAMX,EAAQ,OAAOa,CAAO,EAC5B,MACF,CAEA,OAAOF,CACT,EACA,OAAQ,MAAOD,GAA+B,CACxCR,GAEJ,MAAMF,EAAQ,OAAOY,EAAYF,CAAG,CACtC,EACA,MAAO,SAA2B,CAC5BR,GAEJ,MAAMF,EAAQ,MAAM,CACtB,CACF,CACF,CAEA,QACE,MAAAM,EAAM,UACA,IAAI,MAAM,yBAAyBA,EAAM,SAAS,EAAE,CAC9D,CACF,CAEA,OAAOA,CACT","names":["kvStore","LocalStore","IS_NOT_BROWSER","getStorageAdapter","options","defaultStoreExpiryMs","store","expiryMs","isValid","adapter","key","value","keyPrefix","fullKey"]}

package/storage.mjs

@@ -1,6 +1,7 @@
 // src/storage.ts
 import { kvStore } from "@choksheak/ts-utils/kvStore";
 import { LocalStore } from "@choksheak/ts-utils/localStore";
+var IS_NOT_BROWSER = typeof window === "undefined";
 function getStorageAdapter(options, defaultStoreExpiryMs) {
   const { store } = options ?? {};
   if (!store) {
@@ -8,6 +9,7 @@ function getStorageAdapter(options, defaultStoreExpiryMs) {
   }
   if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
     const expiryMs = store.expiryMs || defaultStoreExpiryMs;
+    const isValid = store.isValid;
     switch (store.persistTo) {
       case "localStorage": {
         const adapter = new LocalStore(store.key, {
@@ -15,40 +17,58 @@ function getStorageAdapter(options, defaultStoreExpiryMs) {
         });
         return {
           set: (key, value) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.set(key, value);
           },
           get: (key) => {
-            if (typeof window === "undefined") return void 0;
-            return adapter.get(key);
+            if (IS_NOT_BROWSER) return void 0;
+            const value = adapter.get(key);
+            if (isValid && !isValid(value)) {
+              console.warn(
+                `localStorage adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`
+              );
+              adapter.delete(key);
+              return void 0;
+            }
+            return value;
           },
           delete: (key) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.delete(key);
           },
           clear: () => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             adapter.clear();
           }
         };
       }
       case "indexedDb": {
         const keyPrefix = store.key + ":";
+        const isValid2 = store.isValid;
         return {
           set: async (key, value) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await kvStore.set(keyPrefix + key, value, expiryMs);
           },
           get: async (key) => {
-            if (typeof window === "undefined") return void 0;
-            return await kvStore.get(keyPrefix + key);
+            if (IS_NOT_BROWSER) return void 0;
+            const fullKey = keyPrefix + key;
+            const value = await kvStore.get(fullKey);
+            if (isValid2 && !isValid2(value)) {
+              console.warn(
+                `indexedDb adapter: Auto-discard invalid value for ${key}: ${JSON.stringify(value)}`
+              );
+              await kvStore.delete(fullKey);
+              return void 0;
+            }
+            return value;
           },
           delete: async (key) => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await kvStore.delete(keyPrefix + key);
           },
           clear: async () => {
-            if (typeof window === "undefined") return;
+            if (IS_NOT_BROWSER) return;
             await kvStore.clear();
           }
         };