@tanstack/query-async-storage-persister 5.0.0-alpha.3 → 5.0.0-alpha.6

package/build/lib/index.d.ts

@@ -11,9 +11,10 @@ export declare type AsyncPersistRetryer = (props: {
 }) => Promisable<PersistedClient | undefined>;
 interface CreateAsyncStoragePersisterOptions {
     /** The storage client used for setting and retrieving items from cache.
-     * For SSR pass in `undefined`.
+     * For SSR pass in `undefined`. Note that window.localStorage can be
+     * `null` in Android WebViews depending on how they are configured.
      */
-    storage: AsyncStorage | undefined;
+    storage: AsyncStorage | undefined | null;
     /** The key to use when storing the cache */
     key?: string;
     /** To avoid spamming,

package/build/lib/index.esm.js

@@ -8,7 +8,7 @@ const createAsyncStoragePersister = ({
   deserialize = JSON.parse,
   retry
 }) => {
-  if (typeof storage !== 'undefined') {
+  if (storage) {
     const trySave = async persistedClient => {
       try {
         await storage.setItem(key, serialize(persistedClient));
@@ -24,11 +24,11 @@ const createAsyncStoragePersister = ({
         let errorCount = 0;
         while (error && client) {
           errorCount++;
-          client = await retry?.({
+          client = await (retry == null ? void 0 : retry({
             persistedClient: client,
             error,
             errorCount
-          });
+          }));
           if (client) {
             error = await trySave(client);
           }

package/build/lib/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../../src/index.ts"],"sourcesContent":["import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`.\n   */\n  storage: AsyncStorage | undefined\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (typeof storage !== 'undefined') {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","error","persistClient","asyncThrottle","client","errorCount","interval","restoreClient","cacheString","getItem","removeClient","removeItem","noop","Promise","resolve","undefined"],"mappings":";;AA2CO,MAAMA,2BAA2B,GAAG,CAAC;EAC1CC,OAAO;AACPC,EAAAA,GAAG,GAAI,CAA0B,yBAAA,CAAA;AACjCC,EAAAA,YAAY,GAAG,IAAI;EACnBC,SAAS,GAAGC,IAAI,CAACC,SAAS;EAC1BC,WAAW,GAAGF,IAAI,CAACG,KAAK;AACxBC,EAAAA,KAAAA;AACkC,CAAC,KAAgB;AACnD,EAAA,IAAI,OAAOR,OAAO,KAAK,WAAW,EAAE;AAClC,IAAA,MAAMS,OAAO,GAAG,MACdC,eAAgC,IACD;MAC/B,IAAI;QACF,MAAMV,OAAO,CAACW,OAAO,CAACV,GAAG,EAAEE,SAAS,CAACO,eAAe,CAAC,CAAC,CAAA;AACtD,QAAA,OAAA;OACD,CAAC,OAAOE,KAAK,EAAE;AACd,QAAA,OAAOA,KAAK,CAAA;AACd,OAAA;KACD,CAAA;IAED,OAAO;AACLC,MAAAA,aAAa,EAAEC,aAAa,CAC1B,MAAOJ,eAAe,IAAK;QACzB,IAAIK,MAAmC,GAAGL,eAAe,CAAA;AACzD,QAAA,IAAIE,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;QACjC,IAAIC,UAAU,GAAG,CAAC,CAAA;QAClB,OAAOJ,KAAK,IAAIG,MAAM,EAAE;AACtBC,UAAAA,UAAU,EAAE,CAAA;UACZD,MAAM,GAAG,MAAMP,KAAK,GAAG;AACrBE,YAAAA,eAAe,EAAEK,MAAM;YACvBH,KAAK;AACLI,YAAAA,UAAAA;AACF,WAAC,CAAC,CAAA;AAEF,UAAA,IAAID,MAAM,EAAE;AACVH,YAAAA,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;AAC/B,WAAA;AACF,SAAA;AACF,OAAC,EACD;AAAEE,QAAAA,QAAQ,EAAEf,YAAAA;AAAa,OAAC,CAC3B;AACDgB,MAAAA,aAAa,EAAE,YAAY;QACzB,MAAMC,WAAW,GAAG,MAAMnB,OAAO,CAACoB,OAAO,CAACnB,GAAG,CAAC,CAAA;QAE9C,IAAI,CAACkB,WAAW,EAAE;AAChB,UAAA,OAAA;AACF,SAAA;QAEA,OAAOb,WAAW,CAACa,WAAW,CAAC,CAAA;OAChC;AACDE,MAAAA,YAAY,EAAE,MAAMrB,OAAO,CAACsB,UAAU,CAACrB,GAAG,CAAA;KAC3C,CAAA;AACH,GAAA;EAEA,OAAO;AACLY,IAAAA,aAAa,EAAEU,IAAI;AACnBL,IAAAA,aAAa,EAAE,MAAMM,OAAO,CAACC,OAAO,CAACC,SAAS,CAAC;AAC/CL,IAAAA,YAAY,EAAEE,IAAAA;GACf,CAAA;AACH,EAAC;;AAED;AACA,SAASA,IAAI,GAAG;;;;"}
+{"version":3,"file":"index.esm.js","sources":["../../src/index.ts"],"sourcesContent":["import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`. Note that window.localStorage can be\n   * `null` in Android WebViews depending on how they are configured.\n   */\n  storage: AsyncStorage | undefined | null\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (storage) {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","error","persistClient","asyncThrottle","client","errorCount","interval","restoreClient","cacheString","getItem","removeClient","removeItem","noop","Promise","resolve","undefined"],"mappings":";;AA4CO,MAAMA,2BAA2B,GAAG,CAAC;EAC1CC,OAAO;AACPC,EAAAA,GAAG,GAAI,CAA0B,yBAAA,CAAA;AACjCC,EAAAA,YAAY,GAAG,IAAI;EACnBC,SAAS,GAAGC,IAAI,CAACC,SAAS;EAC1BC,WAAW,GAAGF,IAAI,CAACG,KAAK;AACxBC,EAAAA,KAAAA;AACkC,CAAC,KAAgB;AACnD,EAAA,IAAIR,OAAO,EAAE;AACX,IAAA,MAAMS,OAAO,GAAG,MACdC,eAAgC,IACD;MAC/B,IAAI;QACF,MAAMV,OAAO,CAACW,OAAO,CAACV,GAAG,EAAEE,SAAS,CAACO,eAAe,CAAC,CAAC,CAAA;AACtD,QAAA,OAAA;OACD,CAAC,OAAOE,KAAK,EAAE;AACd,QAAA,OAAOA,KAAK,CAAA;AACd,OAAA;KACD,CAAA;IAED,OAAO;AACLC,MAAAA,aAAa,EAAEC,aAAa,CAC1B,MAAOJ,eAAe,IAAK;QACzB,IAAIK,MAAmC,GAAGL,eAAe,CAAA;AACzD,QAAA,IAAIE,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;QACjC,IAAIC,UAAU,GAAG,CAAC,CAAA;QAClB,OAAOJ,KAAK,IAAIG,MAAM,EAAE;AACtBC,UAAAA,UAAU,EAAE,CAAA;AACZD,UAAAA,MAAM,GAAG,OAAMP,KAAK,IAAA,IAAA,GAAA,KAAA,CAAA,GAALA,KAAK,CAAG;AACrBE,YAAAA,eAAe,EAAEK,MAAM;YACvBH,KAAK;AACLI,YAAAA,UAAAA;AACF,WAAC,CAAC,CAAA,CAAA;AAEF,UAAA,IAAID,MAAM,EAAE;AACVH,YAAAA,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;AAC/B,WAAA;AACF,SAAA;AACF,OAAC,EACD;AAAEE,QAAAA,QAAQ,EAAEf,YAAAA;AAAa,OAAC,CAC3B;AACDgB,MAAAA,aAAa,EAAE,YAAY;QACzB,MAAMC,WAAW,GAAG,MAAMnB,OAAO,CAACoB,OAAO,CAACnB,GAAG,CAAC,CAAA;QAE9C,IAAI,CAACkB,WAAW,EAAE;AAChB,UAAA,OAAA;AACF,SAAA;QAEA,OAAOb,WAAW,CAACa,WAAW,CAAC,CAAA;OAChC;AACDE,MAAAA,YAAY,EAAE,MAAMrB,OAAO,CAACsB,UAAU,CAACrB,GAAG,CAAA;KAC3C,CAAA;AACH,GAAA;EAEA,OAAO;AACLY,IAAAA,aAAa,EAAEU,IAAI;AACnBL,IAAAA,aAAa,EAAE,MAAMM,OAAO,CAACC,OAAO,CAACC,SAAS,CAAC;AAC/CL,IAAAA,YAAY,EAAEE,IAAAA;GACf,CAAA;AACH,EAAC;;AAED;AACA,SAASA,IAAI,GAAG;;;;"}

package/build/lib/index.js

@@ -10,7 +10,7 @@ const createAsyncStoragePersister = ({
   deserialize = JSON.parse,
   retry
 }) => {
-  if (typeof storage !== 'undefined') {
+  if (storage) {
     const trySave = async persistedClient => {
       try {
         await storage.setItem(key, serialize(persistedClient));
@@ -26,11 +26,11 @@ const createAsyncStoragePersister = ({
         let errorCount = 0;
         while (error && client) {
           errorCount++;
-          client = await retry?.({
+          client = await (retry == null ? void 0 : retry({
             persistedClient: client,
             error,
             errorCount
-          });
+          }));
           if (client) {
             error = await trySave(client);
           }

package/build/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`.\n   */\n  storage: AsyncStorage | undefined\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (typeof storage !== 'undefined') {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","error","persistClient","asyncThrottle","client","errorCount","interval","restoreClient","cacheString","getItem","removeClient","removeItem","noop","Promise","resolve","undefined"],"mappings":";;;;AA2CO,MAAMA,2BAA2B,GAAG,CAAC;EAC1CC,OAAO;AACPC,EAAAA,GAAG,GAAI,CAA0B,yBAAA,CAAA;AACjCC,EAAAA,YAAY,GAAG,IAAI;EACnBC,SAAS,GAAGC,IAAI,CAACC,SAAS;EAC1BC,WAAW,GAAGF,IAAI,CAACG,KAAK;AACxBC,EAAAA,KAAAA;AACkC,CAAC,KAAgB;AACnD,EAAA,IAAI,OAAOR,OAAO,KAAK,WAAW,EAAE;AAClC,IAAA,MAAMS,OAAO,GAAG,MACdC,eAAgC,IACD;MAC/B,IAAI;QACF,MAAMV,OAAO,CAACW,OAAO,CAACV,GAAG,EAAEE,SAAS,CAACO,eAAe,CAAC,CAAC,CAAA;AACtD,QAAA,OAAA;OACD,CAAC,OAAOE,KAAK,EAAE;AACd,QAAA,OAAOA,KAAK,CAAA;AACd,OAAA;KACD,CAAA;IAED,OAAO;AACLC,MAAAA,aAAa,EAAEC,2BAAa,CAC1B,MAAOJ,eAAe,IAAK;QACzB,IAAIK,MAAmC,GAAGL,eAAe,CAAA;AACzD,QAAA,IAAIE,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;QACjC,IAAIC,UAAU,GAAG,CAAC,CAAA;QAClB,OAAOJ,KAAK,IAAIG,MAAM,EAAE;AACtBC,UAAAA,UAAU,EAAE,CAAA;UACZD,MAAM,GAAG,MAAMP,KAAK,GAAG;AACrBE,YAAAA,eAAe,EAAEK,MAAM;YACvBH,KAAK;AACLI,YAAAA,UAAAA;AACF,WAAC,CAAC,CAAA;AAEF,UAAA,IAAID,MAAM,EAAE;AACVH,YAAAA,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;AAC/B,WAAA;AACF,SAAA;AACF,OAAC,EACD;AAAEE,QAAAA,QAAQ,EAAEf,YAAAA;AAAa,OAAC,CAC3B;AACDgB,MAAAA,aAAa,EAAE,YAAY;QACzB,MAAMC,WAAW,GAAG,MAAMnB,OAAO,CAACoB,OAAO,CAACnB,GAAG,CAAC,CAAA;QAE9C,IAAI,CAACkB,WAAW,EAAE;AAChB,UAAA,OAAA;AACF,SAAA;QAEA,OAAOb,WAAW,CAACa,WAAW,CAAC,CAAA;OAChC;AACDE,MAAAA,YAAY,EAAE,MAAMrB,OAAO,CAACsB,UAAU,CAACrB,GAAG,CAAA;KAC3C,CAAA;AACH,GAAA;EAEA,OAAO;AACLY,IAAAA,aAAa,EAAEU,IAAI;AACnBL,IAAAA,aAAa,EAAE,MAAMM,OAAO,CAACC,OAAO,CAACC,SAAS,CAAC;AAC/CL,IAAAA,YAAY,EAAEE,IAAAA;GACf,CAAA;AACH,EAAC;;AAED;AACA,SAASA,IAAI,GAAG;;;;"}
+{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`. Note that window.localStorage can be\n   * `null` in Android WebViews depending on how they are configured.\n   */\n  storage: AsyncStorage | undefined | null\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (storage) {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","error","persistClient","asyncThrottle","client","errorCount","interval","restoreClient","cacheString","getItem","removeClient","removeItem","noop","Promise","resolve","undefined"],"mappings":";;;;AA4CO,MAAMA,2BAA2B,GAAG,CAAC;EAC1CC,OAAO;AACPC,EAAAA,GAAG,GAAI,CAA0B,yBAAA,CAAA;AACjCC,EAAAA,YAAY,GAAG,IAAI;EACnBC,SAAS,GAAGC,IAAI,CAACC,SAAS;EAC1BC,WAAW,GAAGF,IAAI,CAACG,KAAK;AACxBC,EAAAA,KAAAA;AACkC,CAAC,KAAgB;AACnD,EAAA,IAAIR,OAAO,EAAE;AACX,IAAA,MAAMS,OAAO,GAAG,MACdC,eAAgC,IACD;MAC/B,IAAI;QACF,MAAMV,OAAO,CAACW,OAAO,CAACV,GAAG,EAAEE,SAAS,CAACO,eAAe,CAAC,CAAC,CAAA;AACtD,QAAA,OAAA;OACD,CAAC,OAAOE,KAAK,EAAE;AACd,QAAA,OAAOA,KAAK,CAAA;AACd,OAAA;KACD,CAAA;IAED,OAAO;AACLC,MAAAA,aAAa,EAAEC,2BAAa,CAC1B,MAAOJ,eAAe,IAAK;QACzB,IAAIK,MAAmC,GAAGL,eAAe,CAAA;AACzD,QAAA,IAAIE,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;QACjC,IAAIC,UAAU,GAAG,CAAC,CAAA;QAClB,OAAOJ,KAAK,IAAIG,MAAM,EAAE;AACtBC,UAAAA,UAAU,EAAE,CAAA;AACZD,UAAAA,MAAM,GAAG,OAAMP,KAAK,IAAA,IAAA,GAAA,KAAA,CAAA,GAALA,KAAK,CAAG;AACrBE,YAAAA,eAAe,EAAEK,MAAM;YACvBH,KAAK;AACLI,YAAAA,UAAAA;AACF,WAAC,CAAC,CAAA,CAAA;AAEF,UAAA,IAAID,MAAM,EAAE;AACVH,YAAAA,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;AAC/B,WAAA;AACF,SAAA;AACF,OAAC,EACD;AAAEE,QAAAA,QAAQ,EAAEf,YAAAA;AAAa,OAAC,CAC3B;AACDgB,MAAAA,aAAa,EAAE,YAAY;QACzB,MAAMC,WAAW,GAAG,MAAMnB,OAAO,CAACoB,OAAO,CAACnB,GAAG,CAAC,CAAA;QAE9C,IAAI,CAACkB,WAAW,EAAE;AAChB,UAAA,OAAA;AACF,SAAA;QAEA,OAAOb,WAAW,CAACa,WAAW,CAAC,CAAA;OAChC;AACDE,MAAAA,YAAY,EAAE,MAAMrB,OAAO,CAACsB,UAAU,CAACrB,GAAG,CAAA;KAC3C,CAAA;AACH,GAAA;EAEA,OAAO;AACLY,IAAAA,aAAa,EAAEU,IAAI;AACnBL,IAAAA,aAAa,EAAE,MAAMM,OAAO,CAACC,OAAO,CAACC,SAAS,CAAC;AAC/CL,IAAAA,YAAY,EAAEE,IAAAA;GACf,CAAA;AACH,EAAC;;AAED;AACA,SAASA,IAAI,GAAG;;;;"}

package/build/lib/index.mjs

@@ -8,7 +8,7 @@ const createAsyncStoragePersister = ({
   deserialize = JSON.parse,
   retry
 }) => {
-  if (typeof storage !== 'undefined') {
+  if (storage) {
     const trySave = async persistedClient => {
       try {
         await storage.setItem(key, serialize(persistedClient));

package/build/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../src/index.ts"],"sourcesContent":["import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`.\n   */\n  storage: AsyncStorage | undefined\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (typeof storage !== 'undefined') {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","error","persistClient","asyncThrottle","client","errorCount","interval","restoreClient","cacheString","getItem","removeClient","removeItem","noop","Promise","resolve","undefined"],"mappings":";;AA2CO,MAAMA,2BAA2B,GAAG,CAAC;EAC1CC,OAAO;AACPC,EAAAA,GAAG,GAAI,CAA0B,yBAAA,CAAA;AACjCC,EAAAA,YAAY,GAAG,IAAI;EACnBC,SAAS,GAAGC,IAAI,CAACC,SAAS;EAC1BC,WAAW,GAAGF,IAAI,CAACG,KAAK;AACxBC,EAAAA,KAAAA;AACkC,CAAC,KAAgB;AACnD,EAAA,IAAI,OAAOR,OAAO,KAAK,WAAW,EAAE;AAClC,IAAA,MAAMS,OAAO,GAAG,MACdC,eAAgC,IACD;MAC/B,IAAI;QACF,MAAMV,OAAO,CAACW,OAAO,CAACV,GAAG,EAAEE,SAAS,CAACO,eAAe,CAAC,CAAC,CAAA;AACtD,QAAA,OAAA;OACD,CAAC,OAAOE,KAAK,EAAE;AACd,QAAA,OAAOA,KAAK,CAAA;AACd,OAAA;KACD,CAAA;IAED,OAAO;AACLC,MAAAA,aAAa,EAAEC,aAAa,CAC1B,MAAOJ,eAAe,IAAK;QACzB,IAAIK,MAAmC,GAAGL,eAAe,CAAA;AACzD,QAAA,IAAIE,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;QACjC,IAAIC,UAAU,GAAG,CAAC,CAAA;QAClB,OAAOJ,KAAK,IAAIG,MAAM,EAAE;AACtBC,UAAAA,UAAU,EAAE,CAAA;UACZD,MAAM,GAAG,MAAMP,KAAK,GAAG;AACrBE,YAAAA,eAAe,EAAEK,MAAM;YACvBH,KAAK;AACLI,YAAAA,UAAAA;AACF,WAAC,CAAC,CAAA;AAEF,UAAA,IAAID,MAAM,EAAE;AACVH,YAAAA,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;AAC/B,WAAA;AACF,SAAA;AACF,OAAC,EACD;AAAEE,QAAAA,QAAQ,EAAEf,YAAAA;AAAa,OAAC,CAC3B;AACDgB,MAAAA,aAAa,EAAE,YAAY;QACzB,MAAMC,WAAW,GAAG,MAAMnB,OAAO,CAACoB,OAAO,CAACnB,GAAG,CAAC,CAAA;QAE9C,IAAI,CAACkB,WAAW,EAAE;AAChB,UAAA,OAAA;AACF,SAAA;QAEA,OAAOb,WAAW,CAACa,WAAW,CAAC,CAAA;OAChC;AACDE,MAAAA,YAAY,EAAE,MAAMrB,OAAO,CAACsB,UAAU,CAACrB,GAAG,CAAA;KAC3C,CAAA;AACH,GAAA;EAEA,OAAO;AACLY,IAAAA,aAAa,EAAEU,IAAI;AACnBL,IAAAA,aAAa,EAAE,MAAMM,OAAO,CAACC,OAAO,CAACC,SAAS,CAAC;AAC/CL,IAAAA,YAAY,EAAEE,IAAAA;GACf,CAAA;AACH,EAAC;;AAED;AACA,SAASA,IAAI,GAAG;;;;"}
+{"version":3,"file":"index.mjs","sources":["../../src/index.ts"],"sourcesContent":["import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`. Note that window.localStorage can be\n   * `null` in Android WebViews depending on how they are configured.\n   */\n  storage: AsyncStorage | undefined | null\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (storage) {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","error","persistClient","asyncThrottle","client","errorCount","interval","restoreClient","cacheString","getItem","removeClient","removeItem","noop","Promise","resolve","undefined"],"mappings":";;AA4CO,MAAMA,2BAA2B,GAAG,CAAC;EAC1CC,OAAO;AACPC,EAAAA,GAAG,GAAI,CAA0B,yBAAA,CAAA;AACjCC,EAAAA,YAAY,GAAG,IAAI;EACnBC,SAAS,GAAGC,IAAI,CAACC,SAAS;EAC1BC,WAAW,GAAGF,IAAI,CAACG,KAAK;AACxBC,EAAAA,KAAAA;AACkC,CAAC,KAAgB;AACnD,EAAA,IAAIR,OAAO,EAAE;AACX,IAAA,MAAMS,OAAO,GAAG,MACdC,eAAgC,IACD;MAC/B,IAAI;QACF,MAAMV,OAAO,CAACW,OAAO,CAACV,GAAG,EAAEE,SAAS,CAACO,eAAe,CAAC,CAAC,CAAA;AACtD,QAAA,OAAA;OACD,CAAC,OAAOE,KAAK,EAAE;AACd,QAAA,OAAOA,KAAK,CAAA;AACd,OAAA;KACD,CAAA;IAED,OAAO;AACLC,MAAAA,aAAa,EAAEC,aAAa,CAC1B,MAAOJ,eAAe,IAAK;QACzB,IAAIK,MAAmC,GAAGL,eAAe,CAAA;AACzD,QAAA,IAAIE,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;QACjC,IAAIC,UAAU,GAAG,CAAC,CAAA;QAClB,OAAOJ,KAAK,IAAIG,MAAM,EAAE;AACtBC,UAAAA,UAAU,EAAE,CAAA;UACZD,MAAM,GAAG,MAAMP,KAAK,GAAG;AACrBE,YAAAA,eAAe,EAAEK,MAAM;YACvBH,KAAK;AACLI,YAAAA,UAAAA;AACF,WAAC,CAAC,CAAA;AAEF,UAAA,IAAID,MAAM,EAAE;AACVH,YAAAA,KAAK,GAAG,MAAMH,OAAO,CAACM,MAAM,CAAC,CAAA;AAC/B,WAAA;AACF,SAAA;AACF,OAAC,EACD;AAAEE,QAAAA,QAAQ,EAAEf,YAAAA;AAAa,OAAC,CAC3B;AACDgB,MAAAA,aAAa,EAAE,YAAY;QACzB,MAAMC,WAAW,GAAG,MAAMnB,OAAO,CAACoB,OAAO,CAACnB,GAAG,CAAC,CAAA;QAE9C,IAAI,CAACkB,WAAW,EAAE;AAChB,UAAA,OAAA;AACF,SAAA;QAEA,OAAOb,WAAW,CAACa,WAAW,CAAC,CAAA;OAChC;AACDE,MAAAA,YAAY,EAAE,MAAMrB,OAAO,CAACsB,UAAU,CAACrB,GAAG,CAAA;KAC3C,CAAA;AACH,GAAA;EAEA,OAAO;AACLY,IAAAA,aAAa,EAAEU,IAAI;AACnBL,IAAAA,aAAa,EAAE,MAAMM,OAAO,CAACC,OAAO,CAACC,SAAS,CAAC;AAC/CL,IAAAA,YAAY,EAAEE,IAAAA;GACf,CAAA;AACH,EAAC;;AAED;AACA,SAASA,IAAI,GAAG;;;;"}

package/build/umd/index.development.js

@@ -60,7 +60,7 @@
     deserialize = JSON.parse,
     retry
   }) => {
-    if (typeof storage !== 'undefined') {
+    if (storage) {
       const trySave = async persistedClient => {
         try {
           await storage.setItem(key, serialize(persistedClient));

package/build/umd/index.development.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.development.js","sources":["../../src/asyncThrottle.ts","../../src/index.ts"],"sourcesContent":["export interface AsyncThrottleOptions {\n  interval?: number\n  onError?: (error: unknown) => void\n}\n\nconst noop = () => {\n  /* do nothing */\n}\n\nexport function asyncThrottle<Args extends readonly unknown[]>(\n  func: (...args: Args) => Promise<void>,\n  { interval = 1000, onError = noop }: AsyncThrottleOptions = {},\n) {\n  if (typeof func !== 'function') throw new Error('argument is not function.')\n\n  let running = false\n  let lastTime = 0\n  let timeout: ReturnType<typeof setTimeout>\n  let currentArgs: Args | null = null\n\n  const execFunc = async () => {\n    if (currentArgs) {\n      const args = currentArgs\n      currentArgs = null\n      try {\n        running = true\n        await func(...args)\n      } catch (error) {\n        onError(error)\n      } finally {\n        lastTime = Date.now() // this line must after 'func' executed to avoid two 'func' running in concurrent.\n        running = false\n      }\n    }\n  }\n\n  const delayFunc = async () => {\n    clearTimeout(timeout)\n    timeout = setTimeout(() => {\n      if (running) {\n        delayFunc() // Will come here when 'func' execution time is greater than the interval.\n      } else {\n        execFunc()\n      }\n    }, interval)\n  }\n\n  return (...args: Args) => {\n    currentArgs = args\n\n    const tooSoon = Date.now() - lastTime < interval\n    if (running || tooSoon) {\n      delayFunc()\n    } else {\n      execFunc()\n    }\n  }\n}\n","import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`.\n   */\n  storage: AsyncStorage | undefined\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (typeof storage !== 'undefined') {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["noop","asyncThrottle","func","interval","onError","Error","running","lastTime","timeout","currentArgs","execFunc","args","error","Date","now","delayFunc","clearTimeout","setTimeout","tooSoon","createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","persistClient","client","errorCount","restoreClient","cacheString","getItem","removeClient","removeItem","Promise","resolve","undefined"],"mappings":"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"}
+{"version":3,"file":"index.development.js","sources":["../../src/asyncThrottle.ts","../../src/index.ts"],"sourcesContent":["export interface AsyncThrottleOptions {\n  interval?: number\n  onError?: (error: unknown) => void\n}\n\nconst noop = () => {\n  /* do nothing */\n}\n\nexport function asyncThrottle<Args extends readonly unknown[]>(\n  func: (...args: Args) => Promise<void>,\n  { interval = 1000, onError = noop }: AsyncThrottleOptions = {},\n) {\n  if (typeof func !== 'function') throw new Error('argument is not function.')\n\n  let running = false\n  let lastTime = 0\n  let timeout: ReturnType<typeof setTimeout>\n  let currentArgs: Args | null = null\n\n  const execFunc = async () => {\n    if (currentArgs) {\n      const args = currentArgs\n      currentArgs = null\n      try {\n        running = true\n        await func(...args)\n      } catch (error) {\n        onError(error)\n      } finally {\n        lastTime = Date.now() // this line must after 'func' executed to avoid two 'func' running in concurrent.\n        running = false\n      }\n    }\n  }\n\n  const delayFunc = async () => {\n    clearTimeout(timeout)\n    timeout = setTimeout(() => {\n      if (running) {\n        delayFunc() // Will come here when 'func' execution time is greater than the interval.\n      } else {\n        execFunc()\n      }\n    }, interval)\n  }\n\n  return (...args: Args) => {\n    currentArgs = args\n\n    const tooSoon = Date.now() - lastTime < interval\n    if (running || tooSoon) {\n      delayFunc()\n    } else {\n      execFunc()\n    }\n  }\n}\n","import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`. Note that window.localStorage can be\n   * `null` in Android WebViews depending on how they are configured.\n   */\n  storage: AsyncStorage | undefined | null\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (storage) {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["noop","asyncThrottle","func","interval","onError","Error","running","lastTime","timeout","currentArgs","execFunc","args","error","Date","now","delayFunc","clearTimeout","setTimeout","tooSoon","createAsyncStoragePersister","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","persistedClient","setItem","persistClient","client","errorCount","restoreClient","cacheString","getItem","removeClient","removeItem","Promise","resolve","undefined"],"mappings":"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"}

package/build/umd/index.production.js

@@ -1,2 +1,2 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).QueryAsyncStoragePersister={})}(this,(function(e){"use strict";const t=()=>{};function r(e,{interval:r=1e3,onError:n=t}={}){if("function"!=typeof e)throw new Error("argument is not function.");let i,o=!1,s=0,a=null;const c=async()=>{if(a){const t=a;a=null;try{o=!0,await e(...t)}catch(e){n(e)}finally{s=Date.now(),o=!1}}},l=async()=>{clearTimeout(i),i=setTimeout((()=>{o?l():c()}),r)};return(...e)=>{a=e;const t=Date.now()-s<r;o||t?l():c()}}function n(){}e.createAsyncStoragePersister=({storage:e,key:t="REACT_QUERY_OFFLINE_CACHE",throttleTime:i=1e3,serialize:o=JSON.stringify,deserialize:s=JSON.parse,retry:a})=>{if(void 0!==e){const n=async r=>{try{return void await e.setItem(t,o(r))}catch(e){return e}};return{persistClient:r((async e=>{let t=e,r=await n(t),i=0;for(;r&&t;)i++,t=await(a?.({persistedClient:t,error:r,errorCount:i})),t&&(r=await n(t))}),{interval:i}),restoreClient:async()=>{const r=await e.getItem(t);if(r)return s(r)},removeClient:()=>e.removeItem(t)}}return{persistClient:n,restoreClient:()=>Promise.resolve(void 0),removeClient:n}}}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).QueryAsyncStoragePersister={})}(this,(function(e){"use strict";const t=()=>{};function r(e,{interval:r=1e3,onError:n=t}={}){if("function"!=typeof e)throw new Error("argument is not function.");let i,o=!1,s=0,a=null;const c=async()=>{if(a){const t=a;a=null;try{o=!0,await e(...t)}catch(e){n(e)}finally{s=Date.now(),o=!1}}},l=async()=>{clearTimeout(i),i=setTimeout((()=>{o?l():c()}),r)};return(...e)=>{a=e;const t=Date.now()-s<r;o||t?l():c()}}function n(){}e.createAsyncStoragePersister=({storage:e,key:t="REACT_QUERY_OFFLINE_CACHE",throttleTime:i=1e3,serialize:o=JSON.stringify,deserialize:s=JSON.parse,retry:a})=>{if(e){const n=async r=>{try{return void await e.setItem(t,o(r))}catch(e){return e}};return{persistClient:r((async e=>{let t=e,r=await n(t),i=0;for(;r&&t;)i++,t=await(a?.({persistedClient:t,error:r,errorCount:i})),t&&(r=await n(t))}),{interval:i}),restoreClient:async()=>{const r=await e.getItem(t);if(r)return s(r)},removeClient:()=>e.removeItem(t)}}return{persistClient:n,restoreClient:()=>Promise.resolve(void 0),removeClient:n}}}));
 //# sourceMappingURL=index.production.js.map

package/build/umd/index.production.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.production.js","sources":["../../src/asyncThrottle.ts","../../src/index.ts"],"sourcesContent":["export interface AsyncThrottleOptions {\n  interval?: number\n  onError?: (error: unknown) => void\n}\n\nconst noop = () => {\n  /* do nothing */\n}\n\nexport function asyncThrottle<Args extends readonly unknown[]>(\n  func: (...args: Args) => Promise<void>,\n  { interval = 1000, onError = noop }: AsyncThrottleOptions = {},\n) {\n  if (typeof func !== 'function') throw new Error('argument is not function.')\n\n  let running = false\n  let lastTime = 0\n  let timeout: ReturnType<typeof setTimeout>\n  let currentArgs: Args | null = null\n\n  const execFunc = async () => {\n    if (currentArgs) {\n      const args = currentArgs\n      currentArgs = null\n      try {\n        running = true\n        await func(...args)\n      } catch (error) {\n        onError(error)\n      } finally {\n        lastTime = Date.now() // this line must after 'func' executed to avoid two 'func' running in concurrent.\n        running = false\n      }\n    }\n  }\n\n  const delayFunc = async () => {\n    clearTimeout(timeout)\n    timeout = setTimeout(() => {\n      if (running) {\n        delayFunc() // Will come here when 'func' execution time is greater than the interval.\n      } else {\n        execFunc()\n      }\n    }, interval)\n  }\n\n  return (...args: Args) => {\n    currentArgs = args\n\n    const tooSoon = Date.now() - lastTime < interval\n    if (running || tooSoon) {\n      delayFunc()\n    } else {\n      execFunc()\n    }\n  }\n}\n","import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`.\n   */\n  storage: AsyncStorage | undefined\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (typeof storage !== 'undefined') {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["noop","asyncThrottle","func","interval","onError","Error","timeout","running","lastTime","currentArgs","execFunc","async","args","error","Date","now","delayFunc","clearTimeout","setTimeout","tooSoon","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","setItem","persistedClient","persistClient","client","errorCount","restoreClient","cacheString","getItem","removeClient","removeItem","Promise","resolve","undefined"],"mappings":"kQAKA,MAAMA,EAAO,OAIN,SAASC,EACdC,GACAC,SAAEA,EAAW,IAAIC,QAAEA,EAAUJ,GAA+B,IAE5D,GAAoB,mBAATE,EAAqB,MAAM,IAAIG,MAAM,6BAEhD,IAEIC,EAFAC,GAAU,EACVC,EAAW,EAEXC,EAA2B,KAE/B,MAAMC,EAAWC,UACf,GAAIF,EAAa,CACf,MAAMG,EAAOH,EACbA,EAAc,KACd,IACEF,GAAU,QACJL,KAAQU,GACd,MAAOC,GACPT,EAAQS,GACA,QACRL,EAAWM,KAAKC,MAChBR,GAAU,KAKVS,EAAYL,UAChBM,aAAaX,GACbA,EAAUY,YAAW,KACfX,EACFS,IAEAN,MAEDP,IAGL,MAAO,IAAIS,KACTH,EAAcG,EAEd,MAAMO,EAAUL,KAAKC,MAAQP,EAAWL,EACpCI,GAAWY,EACbH,IAEAN,KCmDN,SAASV,mCA9DkC,EACzCoB,UACAC,MAAO,4BACPC,eAAe,IACfC,YAAYC,KAAKC,UACjBC,cAAcF,KAAKG,MACnBC,YAEA,QAAuB,IAAZR,EAAyB,CAClC,MAAMS,EAAUlB,UAGd,IAEE,kBADMS,EAAQU,QAAQT,EAAKE,EAAUQ,IAErC,MAAOlB,GACP,OAAOA,IAIX,MAAO,CACLmB,cAAe/B,GACbU,UACE,IAAIsB,EAAsCF,EACtClB,QAAcgB,EAAQI,GACtBC,EAAa,EACjB,KAAOrB,GAASoB,GACdC,IACAD,QAAeL,IAAQ,CACrBG,gBAAiBE,EACjBpB,QACAqB,gBAGED,IACFpB,QAAcgB,EAAQI,MAI5B,CAAE9B,SAAUmB,IAEda,cAAexB,UACb,MAAMyB,QAAoBhB,EAAQiB,QAAQhB,GAE1C,GAAKe,EAIL,OAAOV,EAAYU,IAErBE,aAAc,IAAMlB,EAAQmB,WAAWlB,IAI3C,MAAO,CACLW,cAAehC,EACfmC,cAAe,IAAMK,QAAQC,aAAQC,GACrCJ,aAActC"}
+{"version":3,"file":"index.production.js","sources":["../../src/asyncThrottle.ts","../../src/index.ts"],"sourcesContent":["export interface AsyncThrottleOptions {\n  interval?: number\n  onError?: (error: unknown) => void\n}\n\nconst noop = () => {\n  /* do nothing */\n}\n\nexport function asyncThrottle<Args extends readonly unknown[]>(\n  func: (...args: Args) => Promise<void>,\n  { interval = 1000, onError = noop }: AsyncThrottleOptions = {},\n) {\n  if (typeof func !== 'function') throw new Error('argument is not function.')\n\n  let running = false\n  let lastTime = 0\n  let timeout: ReturnType<typeof setTimeout>\n  let currentArgs: Args | null = null\n\n  const execFunc = async () => {\n    if (currentArgs) {\n      const args = currentArgs\n      currentArgs = null\n      try {\n        running = true\n        await func(...args)\n      } catch (error) {\n        onError(error)\n      } finally {\n        lastTime = Date.now() // this line must after 'func' executed to avoid two 'func' running in concurrent.\n        running = false\n      }\n    }\n  }\n\n  const delayFunc = async () => {\n    clearTimeout(timeout)\n    timeout = setTimeout(() => {\n      if (running) {\n        delayFunc() // Will come here when 'func' execution time is greater than the interval.\n      } else {\n        execFunc()\n      }\n    }, interval)\n  }\n\n  return (...args: Args) => {\n    currentArgs = args\n\n    const tooSoon = Date.now() - lastTime < interval\n    if (running || tooSoon) {\n      delayFunc()\n    } else {\n      execFunc()\n    }\n  }\n}\n","import type {\n  PersistedClient,\n  Persister,\n  Promisable,\n} from '@tanstack/query-persist-client-core'\nimport { asyncThrottle } from './asyncThrottle'\n\ninterface AsyncStorage {\n  getItem: (key: string) => Promise<string | null>\n  setItem: (key: string, value: string) => Promise<unknown>\n  removeItem: (key: string) => Promise<void>\n}\n\nexport type AsyncPersistRetryer = (props: {\n  persistedClient: PersistedClient\n  error: Error\n  errorCount: number\n}) => Promisable<PersistedClient | undefined>\n\ninterface CreateAsyncStoragePersisterOptions {\n  /** The storage client used for setting and retrieving items from cache.\n   * For SSR pass in `undefined`. Note that window.localStorage can be\n   * `null` in Android WebViews depending on how they are configured.\n   */\n  storage: AsyncStorage | undefined | null\n  /** The key to use when storing the cache */\n  key?: string\n  /** To avoid spamming,\n   * pass a time in ms to throttle saving the cache to disk */\n  throttleTime?: number\n  /**\n   * How to serialize the data to storage.\n   * @default `JSON.stringify`\n   */\n  serialize?: (client: PersistedClient) => string\n  /**\n   * How to deserialize the data from storage.\n   * @default `JSON.parse`\n   */\n  deserialize?: (cachedString: string) => PersistedClient\n\n  retry?: AsyncPersistRetryer\n}\n\nexport const createAsyncStoragePersister = ({\n  storage,\n  key = `REACT_QUERY_OFFLINE_CACHE`,\n  throttleTime = 1000,\n  serialize = JSON.stringify,\n  deserialize = JSON.parse,\n  retry,\n}: CreateAsyncStoragePersisterOptions): Persister => {\n  if (storage) {\n    const trySave = async (\n      persistedClient: PersistedClient,\n    ): Promise<Error | undefined> => {\n      try {\n        await storage.setItem(key, serialize(persistedClient))\n        return\n      } catch (error) {\n        return error as Error\n      }\n    }\n\n    return {\n      persistClient: asyncThrottle(\n        async (persistedClient) => {\n          let client: PersistedClient | undefined = persistedClient\n          let error = await trySave(client)\n          let errorCount = 0\n          while (error && client) {\n            errorCount++\n            client = await retry?.({\n              persistedClient: client,\n              error,\n              errorCount,\n            })\n\n            if (client) {\n              error = await trySave(client)\n            }\n          }\n        },\n        { interval: throttleTime },\n      ),\n      restoreClient: async () => {\n        const cacheString = await storage.getItem(key)\n\n        if (!cacheString) {\n          return\n        }\n\n        return deserialize(cacheString)\n      },\n      removeClient: () => storage.removeItem(key),\n    }\n  }\n\n  return {\n    persistClient: noop,\n    restoreClient: () => Promise.resolve(undefined),\n    removeClient: noop,\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\n"],"names":["noop","asyncThrottle","func","interval","onError","Error","timeout","running","lastTime","currentArgs","execFunc","async","args","error","Date","now","delayFunc","clearTimeout","setTimeout","tooSoon","storage","key","throttleTime","serialize","JSON","stringify","deserialize","parse","retry","trySave","setItem","persistedClient","persistClient","client","errorCount","restoreClient","cacheString","getItem","removeClient","removeItem","Promise","resolve","undefined"],"mappings":"kQAKA,MAAMA,EAAO,OAIN,SAASC,EACdC,GACAC,SAAEA,EAAW,IAAIC,QAAEA,EAAUJ,GAA+B,IAE5D,GAAoB,mBAATE,EAAqB,MAAM,IAAIG,MAAM,6BAEhD,IAEIC,EAFAC,GAAU,EACVC,EAAW,EAEXC,EAA2B,KAE/B,MAAMC,EAAWC,UACf,GAAIF,EAAa,CACf,MAAMG,EAAOH,EACbA,EAAc,KACd,IACEF,GAAU,QACJL,KAAQU,EAMhB,CALE,MAAOC,GACPT,EAAQS,EACV,CAAU,QACRL,EAAWM,KAAKC,MAChBR,GAAU,CACZ,CACF,GAGIS,EAAYL,UAChBM,aAAaX,GACbA,EAAUY,YAAW,KACfX,EACFS,IAEAN,GACF,GACCP,EAAS,EAGd,MAAO,IAAIS,KACTH,EAAcG,EAEd,MAAMO,EAAUL,KAAKC,MAAQP,EAAWL,EACpCI,GAAWY,EACbH,IAEAN,GACF,CAEJ,CCiDA,SAASV,IAAO,+BA9D2B,EACzCoB,UACAC,MAAO,4BACPC,eAAe,IACfC,YAAYC,KAAKC,UACjBC,cAAcF,KAAKG,MACnBC,YAEA,GAAIR,EAAS,CACX,MAAMS,EAAUlB,UAGd,IAEE,kBADMS,EAAQU,QAAQT,EAAKE,EAAUQ,GAIvC,CAFE,MAAOlB,GACP,OAAOA,CACT,GAGF,MAAO,CACLmB,cAAe/B,GACbU,UACE,IAAIsB,EAAsCF,EACtClB,QAAcgB,EAAQI,GACtBC,EAAa,EACjB,KAAOrB,GAASoB,GACdC,IACAD,QAAeL,IAAQ,CACrBG,gBAAiBE,EACjBpB,QACAqB,gBAGED,IACFpB,QAAcgB,EAAQI,GAE1B,GAEF,CAAE9B,SAAUmB,IAEda,cAAexB,UACb,MAAMyB,QAAoBhB,EAAQiB,QAAQhB,GAE1C,GAAKe,EAIL,OAAOV,EAAYU,EAAY,EAEjCE,aAAc,IAAMlB,EAAQmB,WAAWlB,GAE3C,CAEA,MAAO,CACLW,cAAehC,EACfmC,cAAe,IAAMK,QAAQC,aAAQC,GACrCJ,aAActC,EACf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/query-async-storage-persister",
-  "version": "5.0.0-alpha.3",
+  "version": "5.0.0-alpha.6",
   "description": "A persister for asynchronous storages, to be used with TanStack/Query",
   "author": "tannerlinsley",
   "license": "MIT",
@@ -28,13 +28,13 @@
     "src"
   ],
   "dependencies": {
-    "@tanstack/query-persist-client-core": "5.0.0-alpha.3"
+    "@tanstack/query-persist-client-core": "5.0.0-alpha.6"
   },
   "scripts": {
     "clean": "rimraf ./build",
     "test:eslint": "eslint --ext .ts,.tsx ./src",
     "test:types": "tsc",
-    "test:lib": "jest --config ./jest.config.ts",
+    "test:lib": "vitest run --coverage",
     "test:lib:dev": "pnpm run test:lib --watch",
     "build:types": "tsc --build"
   }

package/src/__tests__/asyncThrottle.test.ts

@@ -1,11 +1,12 @@
 import { asyncThrottle } from '../asyncThrottle'
 import { sleep as delay } from './utils'
+import { vi } from 'vitest'
 
 describe('asyncThrottle', () => {
   test('basic', async () => {
     const interval = 10
     const execTimeStamps: number[] = []
-    const mockFunc = jest.fn(
+    const mockFunc = vi.fn(
       async (id: number, complete?: (value?: unknown) => void) => {
         await delay(1)
         execTimeStamps.push(Date.now())
@@ -33,7 +34,7 @@ describe('asyncThrottle', () => {
   test('Bug #3331 case 1: Special timing', async () => {
     const interval = 1000
     const execTimeStamps: number[] = []
-    const mockFunc = jest.fn(
+    const mockFunc = vi.fn(
       async (id: number, complete?: (value?: unknown) => void) => {
         await delay(30)
         execTimeStamps.push(Date.now())
@@ -62,7 +63,7 @@ describe('asyncThrottle', () => {
   test('Bug #3331 case 2: "func" execution time is greater than the interval.', async () => {
     const interval = 1000
     const execTimeStamps: number[] = []
-    const mockFunc = jest.fn(
+    const mockFunc = vi.fn(
       async (id: number, complete?: (value?: unknown) => void) => {
         await delay(interval + 10)
         execTimeStamps.push(Date.now())
@@ -86,7 +87,7 @@ describe('asyncThrottle', () => {
   })
 
   test('"func" throw error not break next invoke', async () => {
-    const mockFunc = jest.fn(
+    const mockFunc = vi.fn(
       async (id: number, complete?: (value?: unknown) => void) => {
         if (id === 1) throw new Error('error')
         await delay(1)
@@ -105,11 +106,10 @@ describe('asyncThrottle', () => {
     expect(mockFunc.mock.calls[1]?.[0]).toBe(2)
   })
 
-  test('"onError" should be called when "func" throw error', (done) => {
+  test('"onError" should be called when "func" throw error', () => {
     const err = new Error('error')
     const handleError = (e: unknown) => {
       expect(e).toBe(err)
-      done()
     }
 
     const testFunc = asyncThrottle(

package/src/index.ts

@@ -19,9 +19,10 @@ export type AsyncPersistRetryer = (props: {
 
 interface CreateAsyncStoragePersisterOptions {
   /** The storage client used for setting and retrieving items from cache.
-   * For SSR pass in `undefined`.
+   * For SSR pass in `undefined`. Note that window.localStorage can be
+   * `null` in Android WebViews depending on how they are configured.
    */
-  storage: AsyncStorage | undefined
+  storage: AsyncStorage | undefined | null
   /** The key to use when storing the cache */
   key?: string
   /** To avoid spamming,
@@ -49,7 +50,7 @@ export const createAsyncStoragePersister = ({
   deserialize = JSON.parse,
   retry,
 }: CreateAsyncStoragePersisterOptions): Persister => {
-  if (typeof storage !== 'undefined') {
+  if (storage) {
     const trySave = async (
       persistedClient: PersistedClient,
     ): Promise<Error | undefined> => {