@shihengtech/utils 0.0.5 → 0.0.6

package/es/index.js

@@ -108,6 +108,7 @@ function createQueryWithCache(key, fn, options) {
     remoteMemoryCache: false
   }, options);
   const cacheUpdateSubject = new ReplaySubject(1);
+  const resolveDeps = () => deps.map((dep) => typeof dep === "function" ? dep() : dep);
   const queryFnEnhancer = (fn2, options2) => ((args) => {
     const promiseResult = fn2(args);
     promiseResult.then((result) => {
@@ -121,7 +122,7 @@ function createQueryWithCache(key, fn, options) {
   });
   const getLocalCache = (args) => __async(null, null, function* () {
     const cache = yield db.getItem(key);
-    if (cache && (!version || cache.version === version) && (!cache.expires || cache.expires > Date.now()) && equals$1(cache.deps, args.concat(deps))) {
+    if (cache && (!version || cache.version === version) && (!cache.expires || cache.expires > Date.now()) && equals$1(cache.deps, args.concat(resolveDeps()))) {
       return cache.result;
     }
     throw new Error("Cache not found");
@@ -166,7 +167,7 @@ function createQueryWithCache(key, fn, options) {
       type === "remote" && (!cacheEnabled || (yield cacheEnabled(args))) && Promise.resolve().then(() => __async(null, null, function* () {
         const oldCache = yield getLocalCache(args).catch(() => null);
         const cacheData = __spreadValues(__spreadValues({
-          deps: args.concat(deps),
+          deps: args.concat(resolveDeps()),
           result
         }, version && { version }), maxAge && { expires: Date.now() + maxAge });
         db.setItem(key, cacheData);

package/es/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts"],"names":["equals","deepEquals","fn","options","result"],"mappings":"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","file":"index.js","sourcesContent":["class ReplaySubject<T> {\n  private maxBufferSize: number\n  private buffer: T[] = []\n\n  private subscriptions: ((data: T) => void)[] = []\n\n  constructor(maxBufferSize = 1) {\n    this.maxBufferSize = maxBufferSize\n  }\n\n  subscribe(fn: (data: T) => void) {\n    this.subscriptions.push(fn)\n    this.buffer.forEach(data => fn(data))\n    return () => this.unsubscribe(fn)\n  }\n\n  unsubscribe(fn: (data: T) => void) {\n    this.subscriptions = this.subscriptions.filter(f => f !== fn)\n  }\n\n  next(data: T) {\n    this.subscriptions.forEach(fn => fn(data))\n    this.buffer.push(data)\n    if (this.buffer.length > this.maxBufferSize) {\n      this.buffer = this.buffer.slice(1)\n    }\n  }\n}\n\nexport { ReplaySubject }\n","export async function fnRunner<T extends (...args: any[]) => Promise<any>>(fn: T, retryTimes: number = 0): Promise<Awaited<ReturnType<T>>> {\n  const times = (retryTimes || 0) + 1\n  for (let i = 0; i < times; i++) {\n    try {\n      return await fn()\n    }\n    catch (error) {\n      // Only throw if this was the last attempt\n      if (i === times - 1) {\n        throw error\n      }\n    }\n  }\n  // This line should never be reached, but it's required for type safety.\n  throw new Error('fnRunner: Unexpected error - all retries exhausted.')\n}\n","import localforage from 'localforage'\nimport { equals as deepEquals } from 'ramda'\nimport { ReplaySubject } from '../../class'\nimport { fnRunner } from '../fnRunner'\n\ntype DBType = Pick<\n  LocalForage,\n  'getItem' | 'setItem' | 'removeItem' | 'clear'\n  // 这些可以暂时不考虑\n  //  | 'clear' | 'keys' | 'length'\n>\n\nconst DB_NAME = 'sh-cache-common'\n\nlet db: DBType = localforage.createInstance({\n  name: DB_NAME,\n  storeName: 'main-store',\n  // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存参数 */\n  deps: any[]\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 缓存过期时间，为空表示永不过期 */\n  expires?: number\n  /** 缓存结果 */\n  result: Awaited<ReturnType<T>>\n}\n\ninterface CacheOptions<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存过期时间，为空表示永不过期 */\n  maxAge?: number\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 依赖项，用于缓存依赖项变更 */\n  deps?: unknown[];\n  /**\n   * 重试次数，为0表示不重试\n   * @default 0\n   */\n  retry?: number\n  /**\n   * 是否比较旧缓存与新缓存后再触发 onCacheUpdate\n   * 为 true 时，只有当新旧缓存不一致时才触发 onCacheUpdate\n   * 为 false 时，总是触发 onCacheUpdate\n   * @default R.equals\n   */\n  compareBeforeUpdate?:\n    | ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean)\n    | false\n  /**\n   * 是否启用远程内存缓存\n   * 为 true 时，启用远程内存缓存\n   * 为 false 时，不启用远程内存缓存\n   * @default false\n   */\n  remoteMemoryCache?: boolean\n  /**\n   * 比较依赖项（函数参数及 deps）是否相等\n   * @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index])\n   * */\n  equals?: (prev: any[], next: any[]) => boolean\n  /**\n   * 根据入参决定是否添加缓存\n   * 不传的话默认启用缓存\n   */\n  cacheEnabled?: (args: Parameters<T>) => Promise<boolean>\n  /** 请求前回调 */\n  beforeRequest?: () => Promise<void> | void\n  /** 请求成功回调 */\n  onSuccess?: (result: {\n    type: 'local' | 'remote'\n    result: Awaited<ReturnType<T>>\n  }) => void\n  /** 请求错误回调 */\n  onError?: (error: any) => void\n  /** 远程请求错误处理 */\n  errorHandler?: (error: any) => any\n  // /** 缓存更新回调 */\n  // onCacheUpdate?: (\n  //   result: Awaited<ReturnType<T>>,\n  //   cacheData: CacheItem<T>,\n  // ) => void;\n}\n\ninterface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {\n  result: Awaited<ReturnType<T>>\n  cacheData: CacheItem<T>\n  isCacheHit: boolean\n}\n\nfunction createQueryWithCache<T extends (...args: any[]) => Promise<any>>(key: string, fn: T, options?: CacheOptions<T>) {\n  const {\n    deps,\n    retry,\n    maxAge,\n    version,\n    compareBeforeUpdate,\n    remoteMemoryCache,\n    equals,\n    cacheEnabled,\n    beforeRequest,\n    onSuccess,\n    onError,\n    errorHandler,\n  } = {\n    deps: [],\n    retry: 0,\n    equals: (a, b) =>\n      a.length === b.length && a.every((item, index) => item === b[index]),\n    compareBeforeUpdate: deepEquals,\n    remoteMemoryCache: false,\n    ...options,\n  } satisfies CacheOptions<T>\n\n  const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\n\n  const queryFnEnhancer = (fn: (args: Parameters<T>) => Promise<ReturnType<T>>, options: Pick<CacheOptions<T>, 'onSuccess' | 'onError'> & { type: 'remote' | 'local' }) => (((args) => {\n    const promiseResult = fn(args);\n\n    promiseResult\n      .then(result => {\n        const res = { type: options.type, result: result as Awaited<ReturnType<T>> }\n        options.onSuccess?.(res)\n        return res\n      }, options.onError)\n      .catch(() => {})\n\n    return promiseResult\n  }) as typeof fn)\n\n  const getLocalCache = async (args: Parameters<T>) => {\n    const cache = await db.getItem<CacheItem<T>>(key)\n    if (\n      cache\n      && (!version || cache.version === version)\n      && (!cache.expires || cache.expires > Date.now())\n      && equals(cache.deps, args.concat(deps))\n    ) {\n      return cache.result\n    }\n\n    throw new Error('Cache not found')\n  }\n\n  const remoteResultCache: {\n    success: boolean\n    args: Parameters<T>\n    result: ReturnType<T> | null\n  } = {\n    success: false,\n    args: [] as any,\n    result: null,\n  }\n\n  const clearMemoryCache = () => {\n    remoteResultCache.success = false\n    remoteResultCache.result = null\n    remoteResultCache.args = [] as any\n  }\n\n  const queryWithMemoryCache = (args: Parameters<T>) => {\n    if (remoteResultCache.success && equals(remoteResultCache.args, args)) {\n      return {\n        type: 'memory' as const,\n        promiseResult: remoteResultCache.result!,\n      }\n    }\n\n    remoteResultCache.args = args\n    remoteResultCache.success = true\n    const result = (remoteResultCache.result = fnRunner(\n      () => fn(...args),\n      retry,\n    ) as ReturnType<T>)\n\n    Promise.resolve(result)\n      .then((result) => {\n        !remoteMemoryCache && clearMemoryCache()\n        return result\n      })\n      .catch(clearMemoryCache)\n\n    return { type: 'remote' as const, promiseResult: result }\n  }\n\n  const queryRemoteWithEnhancer = queryFnEnhancer(async (args: Parameters<T>) => {\n    const rs = {\n      type: 'remote' as const,\n      result: null as unknown as Awaited<ReturnType<T>>,\n    }\n\n    try {\n      const { type, promiseResult } = queryWithMemoryCache(args)\n      const result = (rs.result = await promiseResult)\n\n      // 设置缓存\n      type === 'remote'\n      && (!cacheEnabled || (await cacheEnabled(args)))\n      && Promise.resolve().then(async () => {\n        const oldCache = await getLocalCache(args).catch(() => null)\n\n        const cacheData: CacheItem<T> = {\n          deps: args.concat(deps),\n          result,\n          ...(version && { version }),\n          ...(maxAge && { expires: Date.now() + maxAge }),\n        }\n        db.setItem(key, cacheData)\n\n        // 如果配置了比较，且旧缓存存在且与新结果相等，则不触发 onCacheUpdate\n        if (\n          compareBeforeUpdate\n          && oldCache\n          && compareBeforeUpdate(oldCache, result)\n        ) {\n          return\n        }\n        cacheUpdateSubject.next({\n          result,\n          cacheData,\n          isCacheHit: !!oldCache,\n        })\n      })\n    }\n    catch (error) {\n      if (errorHandler) {\n        rs.result = (await errorHandler(error)) as Awaited<ReturnType<T>>\n      }\n      else {\n        throw error\n      }\n    }\n\n    return rs.result\n  }, { type: 'remote' as const, onSuccess, onError })\n\n  const _fn = async (...args: Parameters<T>) => {\n    await beforeRequest?.()\n\n    const [cacheResult, remoteResult] = [\n      queryFnEnhancer(getLocalCache, { type: 'local' as const, onSuccess })(args),\n      queryRemoteWithEnhancer(args),\n    ]\n    const result = await Promise.race([\n      cacheResult.catch(() => remoteResult),\n      remoteResult,\n    ])\n\n    return result\n  }\n\n  _fn.refresh = (...args: Parameters<T>) => queryRemoteWithEnhancer(args)\n\n  _fn.subscribeCacheUpdate = (fn: (data: CacheUpdateEvent<T>) => void) =>\n    cacheUpdateSubject.subscribe(fn)\n\n  _fn.clearCache = async () => {\n    clearMemoryCache()\n    await db.removeItem(key)\n  }\n\n  return _fn\n}\n\n/**\n * 使用自定义数据库实例\n * @param newDb 数据库实例或 storeName，如果为字符串，则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = <T extends string>(newDb: DBType | (T extends 'main-store' ? never : T)) => {\n  if (typeof newDb === 'string') {\n    db = localforage.createInstance({\n      name: DB_NAME,\n      storeName: newDb,\n    })\n  }\n  else {\n    db = newDb\n  }\n}\n\nexport { createQueryWithCache }\n"]}
+{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts"],"names":["equals","deepEquals","fn","options","result"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAM,gBAAN,MAAuB;AAAA,EAMrB,WAAA,CAAY,gBAAgB,CAAA,EAAG;AAJ/B,IAAA,IAAA,CAAQ,SAAc,EAAC;AAEvB,IAAA,IAAA,CAAQ,gBAAuC,EAAC;AAG9C,IAAA,IAAA,CAAK,aAAA,GAAgB,aAAA;AAAA,EACvB;AAAA,EAEA,UAAU,EAAA,EAAuB;AAC/B,IAAA,IAAA,CAAK,aAAA,CAAc,KAAK,EAAE,CAAA;AAC1B,IAAA,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,CAAA,IAAA,KAAQ,EAAA,CAAG,IAAI,CAAC,CAAA;AACpC,IAAA,OAAO,MAAM,IAAA,CAAK,WAAA,CAAY,EAAE,CAAA;AAAA,EAClC;AAAA,EAEA,YAAY,EAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,gBAAgB,IAAA,CAAK,aAAA,CAAc,MAAA,CAAO,CAAA,CAAA,KAAK,MAAM,EAAE,CAAA;AAAA,EAC9D;AAAA,EAEA,KAAK,IAAA,EAAS;AACZ,IAAA,IAAA,CAAK,aAAA,CAAc,OAAA,CAAQ,CAAA,EAAA,KAAM,EAAA,CAAG,IAAI,CAAC,CAAA;AACzC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,IAAI,CAAA;AACrB,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,MAAA,GAAS,IAAA,CAAK,aAAA,EAAe;AAC3C,MAAA,IAAA,CAAK,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,CAAC,CAAA;AAAA,IACnC;AAAA,EACF;AACF;;;AC3BA,SAAsB,QAAA,CAAqD,EAAA,EAAO,UAAA,GAAqB,CAAA,EAAoC;AAAA,EAAA,OAAA,OAAA,CAAA,IAAA,EAAA,IAAA,EAAA,aAAA;AACzI,IAAA,MAAM,KAAA,GAAA,CAAS,cAAc,CAAA,IAAK,CAAA;AAClC,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA,EAAA,EAAK;AAC9B,MAAA,IAAI;AACF,QAAA,OAAO,MAAM,EAAA,EAAG;AAAA,MAClB,SACO,KAAA,EAAO;AAEZ,QAAA,IAAI,CAAA,KAAM,QAAQ,CAAA,EAAG;AACnB,UAAA,MAAM,KAAA;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE,CAAA,CAAA;AAAA;;;ACHA,IAAM,OAAA,GAAU,iBAAA;AAEhB,IAAI,EAAA,GAAa,YAAY,cAAA,CAAe;AAAA,EAC1C,IAAA,EAAM,OAAA;AAAA,EACN,SAAA,EAAW;AAAA;AAEb,CAAC,CAAA;AA8ED,SAAS,oBAAA,CAAiE,GAAA,EAAa,EAAA,EAAO,OAAA,EAA2B;AACvH,EAAA,MAAM;AAAA,IACJ,IAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA,OAAA;AAAA,IACA,mBAAA;AAAA,IACA,iBAAA;AAAA,YACAA,QAAA;AAAA,IACA,YAAA;AAAA,IACA,aAAA;AAAA,IACA,SAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,GAAI,cAAA,CAAA;AAAA,IACF,MAAM,EAAC;AAAA,IACP,KAAA,EAAO,CAAA;AAAA,IACP,QAAQ,CAAC,CAAA,EAAG,CAAA,KACV,CAAA,CAAE,WAAW,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,KAAA,CAAM,CAAC,IAAA,EAAM,KAAA,KAAU,IAAA,KAAS,CAAA,CAAE,KAAK,CAAC,CAAA;AAAA,IACrE,mBAAA,EAAqBC,MAAA;AAAA,IACrB,iBAAA,EAAmB;AAAA,GAAA,EAChB,OAAA,CAAA;AAGL,EAAA,MAAM,kBAAA,GAAqB,IAAI,aAAA,CAAmC,CAAC,CAAA;AAGnE,EAAA,MAAM,WAAA,GAAc,MAAM,IAAA,CAAK,GAAA,CAAI,CAAA,GAAA,KAAO,OAAO,GAAA,KAAQ,UAAA,GAAa,GAAA,EAAI,GAAI,GAAG,CAAA;AAEjF,EAAA,MAAM,eAAA,GAAkB,CAACC,GAAAA,EAAqDC,QAAAA,MAA6F,CAAC,IAAA,KAAS;AACnL,IAAA,MAAM,aAAA,GAAgBD,IAAG,IAAI,CAAA;AAE7B,IAAA,aAAA,CACG,KAAK,CAAA,MAAA,KAAU;AAjItB,MAAA,IAAA,EAAA;AAkIQ,MAAA,MAAM,GAAA,GAAM,EAAE,IAAA,EAAMC,QAAAA,CAAQ,MAAM,MAAA,EAAyC;AAC3E,MAAA,CAAA,EAAA,GAAAA,QAAAA,CAAQ,SAAA,KAAR,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAAA,QAAAA,EAAoB,GAAA,CAAA;AACpB,MAAA,OAAO,GAAA;AAAA,IACT,CAAA,EAAGA,QAAAA,CAAQ,OAAO,CAAA,CACjB,MAAM,MAAM;AAAA,IAAC,CAAC,CAAA;AAEjB,IAAA,OAAO,aAAA;AAAA,EACT,CAAA,CAAA;AAEA,EAAA,MAAM,aAAA,GAAgB,CAAO,IAAA,KAAwB,OAAA,CAAA,IAAA,EAAA,IAAA,EAAA,aAAA;AACnD,IAAA,MAAM,KAAA,GAAQ,MAAM,EAAA,CAAG,OAAA,CAAsB,GAAG,CAAA;AAChD,IAAA,IACE,KAAA,KACI,CAAC,OAAA,IAAW,KAAA,CAAM,YAAY,OAAA,CAAA,KAC9B,CAAC,KAAA,CAAM,OAAA,IAAW,KAAA,CAAM,OAAA,GAAU,KAAK,GAAA,EAAI,CAAA,IAC5CH,SAAO,KAAA,CAAM,IAAA,EAAM,KAAK,MAAA,CAAO,WAAA,EAAa,CAAC,CAAA,EAChD;AACA,MAAA,OAAO,KAAA,CAAM,MAAA;AAAA,IACf;AAEA,IAAA,MAAM,IAAI,MAAM,iBAAiB,CAAA;AAAA,EACnC,CAAA,CAAA;AAEA,EAAA,MAAM,iBAAA,GAIF;AAAA,IACF,OAAA,EAAS,KAAA;AAAA,IACT,MAAM,EAAC;AAAA,IACP,MAAA,EAAQ;AAAA,GACV;AAEA,EAAA,MAAM,mBAAmB,MAAM;AAC7B,IAAA,iBAAA,CAAkB,OAAA,GAAU,KAAA;AAC5B,IAAA,iBAAA,CAAkB,MAAA,GAAS,IAAA;AAC3B,IAAA,iBAAA,CAAkB,OAAO,EAAC;AAAA,EAC5B,CAAA;AAEA,EAAA,MAAM,oBAAA,GAAuB,CAAC,IAAA,KAAwB;AACpD,IAAA,IAAI,kBAAkB,OAAA,IAAWA,QAAA,CAAO,iBAAA,CAAkB,IAAA,EAAM,IAAI,CAAA,EAAG;AACrE,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,QAAA;AAAA,QACN,eAAe,iBAAA,CAAkB;AAAA,OACnC;AAAA,IACF;AAEA,IAAA,iBAAA,CAAkB,IAAA,GAAO,IAAA;AACzB,IAAA,iBAAA,CAAkB,OAAA,GAAU,IAAA;AAC5B,IAAA,MAAM,MAAA,GAAU,kBAAkB,MAAA,GAAS,QAAA;AAAA,MACzC,MAAM,EAAA,CAAG,GAAG,IAAI,CAAA;AAAA,MAChB;AAAA,KACF;AAEA,IAAA,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA,CACnB,IAAA,CAAK,CAACI,OAAAA,KAAW;AAChB,MAAA,CAAC,qBAAqB,gBAAA,EAAiB;AACvC,MAAA,OAAOA,OAAAA;AAAA,IACT,CAAC,CAAA,CACA,KAAA,CAAM,gBAAgB,CAAA;AAEzB,IAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAmB,aAAA,EAAe,MAAA,EAAO;AAAA,EAC1D,CAAA;AAEA,EAAA,MAAM,uBAAA,GAA0B,eAAA,CAAgB,CAAO,IAAA,KAAwB,OAAA,CAAA,IAAA,EAAA,IAAA,EAAA,aAAA;AAC7E,IAAA,MAAM,EAAA,GAAK;AAAA,MACT,IAAA,EAAM,QAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,EAAE,IAAA,EAAM,aAAA,EAAc,GAAI,qBAAqB,IAAI,CAAA;AACzD,MAAA,MAAM,MAAA,GAAU,EAAA,CAAG,MAAA,GAAS,MAAM,aAAA;AAGlC,MAAA,IAAA,KAAS,QAAA,KACL,CAAC,YAAA,KAAiB,MAAM,YAAA,CAAa,IAAI,CAAA,CAAA,CAAA,IAC1C,OAAA,CAAQ,OAAA,EAAQ,CAAE,IAAA,CAAK,MAAY,OAAA,CAAA,IAAA,EAAA,IAAA,EAAA,aAAA;AACpC,QAAA,MAAM,WAAW,MAAM,aAAA,CAAc,IAAI,CAAA,CAAE,KAAA,CAAM,MAAM,IAAI,CAAA;AAE3D,QAAA,MAAM,SAAA,GAA0B,cAAA,CAAA,cAAA,CAAA;AAAA,UAC9B,IAAA,EAAM,IAAA,CAAK,MAAA,CAAO,WAAA,EAAa,CAAA;AAAA,UAC/B;AAAA,SAAA,EACI,OAAA,IAAW,EAAE,OAAA,EAAQ,CAAA,EACrB,MAAA,IAAU,EAAE,OAAA,EAAS,IAAA,CAAK,GAAA,EAAI,GAAI,MAAA,EAAO,CAAA;AAE/C,QAAA,EAAA,CAAG,OAAA,CAAQ,KAAK,SAAS,CAAA;AAGzB,QAAA,IACE,mBAAA,IACG,QAAA,IACA,mBAAA,CAAoB,QAAA,EAAU,MAAM,CAAA,EACvC;AACA,UAAA;AAAA,QACF;AACA,QAAA,kBAAA,CAAmB,IAAA,CAAK;AAAA,UACtB,MAAA;AAAA,UACA,SAAA;AAAA,UACA,UAAA,EAAY,CAAC,CAAC;AAAA,SACf,CAAA;AAAA,MACH,CAAA,CAAC,CAAA;AAAA,IACH,SACO,KAAA,EAAO;AACZ,MAAA,IAAI,YAAA,EAAc;AAChB,QAAA,EAAA,CAAG,MAAA,GAAU,MAAM,YAAA,CAAa,KAAK,CAAA;AAAA,MACvC,CAAA,MACK;AACH,QAAA,MAAM,KAAA;AAAA,MACR;AAAA,IACF;AAEA,IAAA,OAAO,EAAA,CAAG,MAAA;AAAA,EACZ,IAAG,EAAE,IAAA,EAAM,QAAA,EAAmB,SAAA,EAAW,SAAS,CAAA;AAElD,EAAA,MAAM,GAAA,GAAM,IAAU,IAAA,KAAwB,OAAA,CAAA,IAAA,EAAA,IAAA,EAAA,aAAA;AAC5C,IAAA,MAAM,aAAA,IAAA,IAAA,GAAA,MAAA,GAAA,aAAA,EAAA;AAEN,IAAA,MAAM,CAAC,WAAA,EAAa,YAAY,CAAA,GAAI;AAAA,MAClC,eAAA,CAAgB,eAAe,EAAE,IAAA,EAAM,SAAkB,SAAA,EAAW,EAAE,IAAI,CAAA;AAAA,MAC1E,wBAAwB,IAAI;AAAA,KAC9B;AACA,IAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,IAAA,CAAK;AAAA,MAChC,WAAA,CAAY,KAAA,CAAM,MAAM,YAAY,CAAA;AAAA,MACpC;AAAA,KACD,CAAA;AAED,IAAA,OAAO,MAAA;AAAA,EACT,CAAA,CAAA;AAEA,EAAA,GAAA,CAAI,OAAA,GAAU,CAAA,GAAI,IAAA,KAAwB,uBAAA,CAAwB,IAAI,CAAA;AAEtE,EAAA,GAAA,CAAI,oBAAA,GAAuB,CAACF,GAAAA,KAC1B,kBAAA,CAAmB,UAAUA,GAAE,CAAA;AAEjC,EAAA,GAAA,CAAI,aAAa,MAAY,OAAA,CAAA,IAAA,EAAA,IAAA,EAAA,aAAA;AAC3B,IAAA,gBAAA,EAAiB;AACjB,IAAA,MAAM,EAAA,CAAG,WAAW,GAAG,CAAA;AAAA,EACzB,CAAA,CAAA;AAEA,EAAA,OAAO,GAAA;AACT;AAMA,oBAAA,CAAqB,KAAA,GAAQ,CAAmB,KAAA,KAAyD;AACvG,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,EAAA,GAAK,YAAY,cAAA,CAAe;AAAA,MAC9B,IAAA,EAAM,OAAA;AAAA,MACN,SAAA,EAAW;AAAA,KACZ,CAAA;AAAA,EACH,CAAA,MACK;AACH,IAAA,EAAA,GAAK,KAAA;AAAA,EACP;AACF,CAAA","file":"index.js","sourcesContent":["class ReplaySubject<T> {\n  private maxBufferSize: number\n  private buffer: T[] = []\n\n  private subscriptions: ((data: T) => void)[] = []\n\n  constructor(maxBufferSize = 1) {\n    this.maxBufferSize = maxBufferSize\n  }\n\n  subscribe(fn: (data: T) => void) {\n    this.subscriptions.push(fn)\n    this.buffer.forEach(data => fn(data))\n    return () => this.unsubscribe(fn)\n  }\n\n  unsubscribe(fn: (data: T) => void) {\n    this.subscriptions = this.subscriptions.filter(f => f !== fn)\n  }\n\n  next(data: T) {\n    this.subscriptions.forEach(fn => fn(data))\n    this.buffer.push(data)\n    if (this.buffer.length > this.maxBufferSize) {\n      this.buffer = this.buffer.slice(1)\n    }\n  }\n}\n\nexport { ReplaySubject }\n","export async function fnRunner<T extends (...args: any[]) => Promise<any>>(fn: T, retryTimes: number = 0): Promise<Awaited<ReturnType<T>>> {\n  const times = (retryTimes || 0) + 1\n  for (let i = 0; i < times; i++) {\n    try {\n      return await fn()\n    }\n    catch (error) {\n      // Only throw if this was the last attempt\n      if (i === times - 1) {\n        throw error\n      }\n    }\n  }\n  // This line should never be reached, but it's required for type safety.\n  throw new Error('fnRunner: Unexpected error - all retries exhausted.')\n}\n","import localforage from 'localforage'\nimport { equals as deepEquals } from 'ramda'\nimport { ReplaySubject } from '../../class'\nimport { fnRunner } from '../fnRunner'\n\ntype DBType = Pick<\n  LocalForage,\n  'getItem' | 'setItem' | 'removeItem' | 'clear'\n  // 这些可以暂时不考虑\n  //  | 'clear' | 'keys' | 'length'\n>\n\nconst DB_NAME = 'sh-cache-common'\n\nlet db: DBType = localforage.createInstance({\n  name: DB_NAME,\n  storeName: 'main-store',\n  // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存参数 */\n  deps: any[]\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 缓存过期时间，为空表示永不过期 */\n  expires?: number\n  /** 缓存结果 */\n  result: Awaited<ReturnType<T>>\n}\n\n/** 依赖项类型，支持直接值或函数形式（运行时取值） */\ntype DepItem = unknown | (() => unknown)\n\ninterface CacheOptions<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存过期时间，为空表示永不过期 */\n  maxAge?: number\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 依赖项，用于缓存依赖项变更。支持函数形式，函数会在运行时调用取值 */\n  deps?: DepItem[];\n  /**\n   * 重试次数，为0表示不重试\n   * @default 0\n   */\n  retry?: number\n  /**\n   * 是否比较旧缓存与新缓存后再触发 onCacheUpdate\n   * 为 true 时，只有当新旧缓存不一致时才触发 onCacheUpdate\n   * 为 false 时，总是触发 onCacheUpdate\n   * @default R.equals\n   */\n  compareBeforeUpdate?:\n    | ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean)\n    | false\n  /**\n   * 是否启用远程内存缓存\n   * 为 true 时，启用远程内存缓存\n   * 为 false 时，不启用远程内存缓存\n   * @default false\n   */\n  remoteMemoryCache?: boolean\n  /**\n   * 比较依赖项（函数参数及 deps）是否相等\n   * @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index])\n   * */\n  equals?: (prev: any[], next: any[]) => boolean\n  /**\n   * 根据入参决定是否添加缓存\n   * 不传的话默认启用缓存\n   */\n  cacheEnabled?: (args: Parameters<T>) => Promise<boolean>\n  /** 请求前回调 */\n  beforeRequest?: () => Promise<void> | void\n  /** 请求成功回调 */\n  onSuccess?: (result: {\n    type: 'local' | 'remote'\n    result: Awaited<ReturnType<T>>\n  }) => void\n  /** 请求错误回调 */\n  onError?: (error: any) => void\n  /** 远程请求错误处理 */\n  errorHandler?: (error: any) => any\n  // /** 缓存更新回调 */\n  // onCacheUpdate?: (\n  //   result: Awaited<ReturnType<T>>,\n  //   cacheData: CacheItem<T>,\n  // ) => void;\n}\n\ninterface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {\n  result: Awaited<ReturnType<T>>\n  cacheData: CacheItem<T>\n  isCacheHit: boolean\n}\n\nfunction createQueryWithCache<T extends (...args: any[]) => Promise<any>>(key: string, fn: T, options?: CacheOptions<T>) {\n  const {\n    deps,\n    retry,\n    maxAge,\n    version,\n    compareBeforeUpdate,\n    remoteMemoryCache,\n    equals,\n    cacheEnabled,\n    beforeRequest,\n    onSuccess,\n    onError,\n    errorHandler,\n  } = {\n    deps: [],\n    retry: 0,\n    equals: (a, b) =>\n      a.length === b.length && a.every((item, index) => item === b[index]),\n    compareBeforeUpdate: deepEquals,\n    remoteMemoryCache: false,\n    ...options,\n  } satisfies CacheOptions<T>\n\n  const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\n\n  /** 解析 deps，如果元素是函数则调用获取值 */\n  const resolveDeps = () => deps.map(dep => typeof dep === 'function' ? dep() : dep)\n\n  const queryFnEnhancer = (fn: (args: Parameters<T>) => Promise<ReturnType<T>>, options: Pick<CacheOptions<T>, 'onSuccess' | 'onError'> & { type: 'remote' | 'local' }) => (((args) => {\n    const promiseResult = fn(args);\n\n    promiseResult\n      .then(result => {\n        const res = { type: options.type, result: result as Awaited<ReturnType<T>> }\n        options.onSuccess?.(res)\n        return res\n      }, options.onError)\n      .catch(() => {})\n\n    return promiseResult\n  }) as typeof fn)\n\n  const getLocalCache = async (args: Parameters<T>) => {\n    const cache = await db.getItem<CacheItem<T>>(key)\n    if (\n      cache\n      && (!version || cache.version === version)\n      && (!cache.expires || cache.expires > Date.now())\n      && equals(cache.deps, args.concat(resolveDeps()))\n    ) {\n      return cache.result\n    }\n\n    throw new Error('Cache not found')\n  }\n\n  const remoteResultCache: {\n    success: boolean\n    args: Parameters<T>\n    result: ReturnType<T> | null\n  } = {\n    success: false,\n    args: [] as any,\n    result: null,\n  }\n\n  const clearMemoryCache = () => {\n    remoteResultCache.success = false\n    remoteResultCache.result = null\n    remoteResultCache.args = [] as any\n  }\n\n  const queryWithMemoryCache = (args: Parameters<T>) => {\n    if (remoteResultCache.success && equals(remoteResultCache.args, args)) {\n      return {\n        type: 'memory' as const,\n        promiseResult: remoteResultCache.result!,\n      }\n    }\n\n    remoteResultCache.args = args\n    remoteResultCache.success = true\n    const result = (remoteResultCache.result = fnRunner(\n      () => fn(...args),\n      retry,\n    ) as ReturnType<T>)\n\n    Promise.resolve(result)\n      .then((result) => {\n        !remoteMemoryCache && clearMemoryCache()\n        return result\n      })\n      .catch(clearMemoryCache)\n\n    return { type: 'remote' as const, promiseResult: result }\n  }\n\n  const queryRemoteWithEnhancer = queryFnEnhancer(async (args: Parameters<T>) => {\n    const rs = {\n      type: 'remote' as const,\n      result: null as unknown as Awaited<ReturnType<T>>,\n    }\n\n    try {\n      const { type, promiseResult } = queryWithMemoryCache(args)\n      const result = (rs.result = await promiseResult)\n\n      // 设置缓存\n      type === 'remote'\n      && (!cacheEnabled || (await cacheEnabled(args)))\n      && Promise.resolve().then(async () => {\n        const oldCache = await getLocalCache(args).catch(() => null)\n\n        const cacheData: CacheItem<T> = {\n          deps: args.concat(resolveDeps()),\n          result,\n          ...(version && { version }),\n          ...(maxAge && { expires: Date.now() + maxAge }),\n        }\n        db.setItem(key, cacheData)\n\n        // 如果配置了比较，且旧缓存存在且与新结果相等，则不触发 onCacheUpdate\n        if (\n          compareBeforeUpdate\n          && oldCache\n          && compareBeforeUpdate(oldCache, result)\n        ) {\n          return\n        }\n        cacheUpdateSubject.next({\n          result,\n          cacheData,\n          isCacheHit: !!oldCache,\n        })\n      })\n    }\n    catch (error) {\n      if (errorHandler) {\n        rs.result = (await errorHandler(error)) as Awaited<ReturnType<T>>\n      }\n      else {\n        throw error\n      }\n    }\n\n    return rs.result\n  }, { type: 'remote' as const, onSuccess, onError })\n\n  const _fn = async (...args: Parameters<T>) => {\n    await beforeRequest?.()\n\n    const [cacheResult, remoteResult] = [\n      queryFnEnhancer(getLocalCache, { type: 'local' as const, onSuccess })(args),\n      queryRemoteWithEnhancer(args),\n    ]\n    const result = await Promise.race([\n      cacheResult.catch(() => remoteResult),\n      remoteResult,\n    ])\n\n    return result\n  }\n\n  _fn.refresh = (...args: Parameters<T>) => queryRemoteWithEnhancer(args)\n\n  _fn.subscribeCacheUpdate = (fn: (data: CacheUpdateEvent<T>) => void) =>\n    cacheUpdateSubject.subscribe(fn)\n\n  _fn.clearCache = async () => {\n    clearMemoryCache()\n    await db.removeItem(key)\n  }\n\n  return _fn\n}\n\n/**\n * 使用自定义数据库实例\n * @param newDb 数据库实例或 storeName，如果为字符串，则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = <T extends string>(newDb: DBType | (T extends 'main-store' ? never : T)) => {\n  if (typeof newDb === 'string') {\n    db = localforage.createInstance({\n      name: DB_NAME,\n      storeName: newDb,\n    })\n  }\n  else {\n    db = newDb\n  }\n}\n\nexport { createQueryWithCache }\n"]}

package/lib/index.d.ts

@@ -19,13 +19,15 @@ interface CacheItem<T extends (...args: any[]) => Promise<any>> {
     /** 缓存结果 */
     result: Awaited<ReturnType<T>>;
 }
+/** 依赖项类型，支持直接值或函数形式（运行时取值） */
+type DepItem = unknown | (() => unknown);
 interface CacheOptions<T extends (...args: any[]) => Promise<any>> {
     /** 缓存过期时间，为空表示永不过期 */
     maxAge?: number;
     /** 缓存版本，用于缓存数据结构变更 */
     version?: string;
-    /** 依赖项，用于缓存依赖项变更 */
-    deps?: unknown[];
+    /** 依赖项，用于缓存依赖项变更。支持函数形式，函数会在运行时调用取值 */
+    deps?: DepItem[];
     /**
      * 重试次数，为0表示不重试
      * @default 0

package/lib/index.js

@@ -114,6 +114,7 @@ function createQueryWithCache(key, fn, options) {
     remoteMemoryCache: false
   }, options);
   const cacheUpdateSubject = new ReplaySubject(1);
+  const resolveDeps = () => deps.map((dep) => typeof dep === "function" ? dep() : dep);
   const queryFnEnhancer = (fn2, options2) => ((args) => {
     const promiseResult = fn2(args);
     promiseResult.then((result) => {
@@ -127,7 +128,7 @@ function createQueryWithCache(key, fn, options) {
   });
   const getLocalCache = (args) => __async(null, null, function* () {
     const cache = yield db.getItem(key);
-    if (cache && (!version || cache.version === version) && (!cache.expires || cache.expires > Date.now()) && equals(cache.deps, args.concat(deps))) {
+    if (cache && (!version || cache.version === version) && (!cache.expires || cache.expires > Date.now()) && equals(cache.deps, args.concat(resolveDeps()))) {
       return cache.result;
     }
     throw new Error("Cache not found");
@@ -172,7 +173,7 @@ function createQueryWithCache(key, fn, options) {
       type === "remote" && (!cacheEnabled || (yield cacheEnabled(args))) && Promise.resolve().then(() => __async(null, null, function* () {
         const oldCache = yield getLocalCache(args).catch(() => null);
         const cacheData = __spreadValues(__spreadValues({
-          deps: args.concat(deps),
+          deps: args.concat(resolveDeps()),
           result
         }, version && { version }), maxAge && { expires: Date.now() + maxAge });
         db.setItem(key, cacheData);

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts"],"names":["localforage","deepEquals","fn","options","result"],"mappings":"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","file":"index.js","sourcesContent":["class ReplaySubject<T> {\n  private maxBufferSize: number\n  private buffer: T[] = []\n\n  private subscriptions: ((data: T) => void)[] = []\n\n  constructor(maxBufferSize = 1) {\n    this.maxBufferSize = maxBufferSize\n  }\n\n  subscribe(fn: (data: T) => void) {\n    this.subscriptions.push(fn)\n    this.buffer.forEach(data => fn(data))\n    return () => this.unsubscribe(fn)\n  }\n\n  unsubscribe(fn: (data: T) => void) {\n    this.subscriptions = this.subscriptions.filter(f => f !== fn)\n  }\n\n  next(data: T) {\n    this.subscriptions.forEach(fn => fn(data))\n    this.buffer.push(data)\n    if (this.buffer.length > this.maxBufferSize) {\n      this.buffer = this.buffer.slice(1)\n    }\n  }\n}\n\nexport { ReplaySubject }\n","export async function fnRunner<T extends (...args: any[]) => Promise<any>>(fn: T, retryTimes: number = 0): Promise<Awaited<ReturnType<T>>> {\n  const times = (retryTimes || 0) + 1\n  for (let i = 0; i < times; i++) {\n    try {\n      return await fn()\n    }\n    catch (error) {\n      // Only throw if this was the last attempt\n      if (i === times - 1) {\n        throw error\n      }\n    }\n  }\n  // This line should never be reached, but it's required for type safety.\n  throw new Error('fnRunner: Unexpected error - all retries exhausted.')\n}\n","import localforage from 'localforage'\nimport { equals as deepEquals } from 'ramda'\nimport { ReplaySubject } from '../../class'\nimport { fnRunner } from '../fnRunner'\n\ntype DBType = Pick<\n  LocalForage,\n  'getItem' | 'setItem' | 'removeItem' | 'clear'\n  // 这些可以暂时不考虑\n  //  | 'clear' | 'keys' | 'length'\n>\n\nconst DB_NAME = 'sh-cache-common'\n\nlet db: DBType = localforage.createInstance({\n  name: DB_NAME,\n  storeName: 'main-store',\n  // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存参数 */\n  deps: any[]\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 缓存过期时间，为空表示永不过期 */\n  expires?: number\n  /** 缓存结果 */\n  result: Awaited<ReturnType<T>>\n}\n\ninterface CacheOptions<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存过期时间，为空表示永不过期 */\n  maxAge?: number\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 依赖项，用于缓存依赖项变更 */\n  deps?: unknown[];\n  /**\n   * 重试次数，为0表示不重试\n   * @default 0\n   */\n  retry?: number\n  /**\n   * 是否比较旧缓存与新缓存后再触发 onCacheUpdate\n   * 为 true 时，只有当新旧缓存不一致时才触发 onCacheUpdate\n   * 为 false 时，总是触发 onCacheUpdate\n   * @default R.equals\n   */\n  compareBeforeUpdate?:\n    | ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean)\n    | false\n  /**\n   * 是否启用远程内存缓存\n   * 为 true 时，启用远程内存缓存\n   * 为 false 时，不启用远程内存缓存\n   * @default false\n   */\n  remoteMemoryCache?: boolean\n  /**\n   * 比较依赖项（函数参数及 deps）是否相等\n   * @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index])\n   * */\n  equals?: (prev: any[], next: any[]) => boolean\n  /**\n   * 根据入参决定是否添加缓存\n   * 不传的话默认启用缓存\n   */\n  cacheEnabled?: (args: Parameters<T>) => Promise<boolean>\n  /** 请求前回调 */\n  beforeRequest?: () => Promise<void> | void\n  /** 请求成功回调 */\n  onSuccess?: (result: {\n    type: 'local' | 'remote'\n    result: Awaited<ReturnType<T>>\n  }) => void\n  /** 请求错误回调 */\n  onError?: (error: any) => void\n  /** 远程请求错误处理 */\n  errorHandler?: (error: any) => any\n  // /** 缓存更新回调 */\n  // onCacheUpdate?: (\n  //   result: Awaited<ReturnType<T>>,\n  //   cacheData: CacheItem<T>,\n  // ) => void;\n}\n\ninterface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {\n  result: Awaited<ReturnType<T>>\n  cacheData: CacheItem<T>\n  isCacheHit: boolean\n}\n\nfunction createQueryWithCache<T extends (...args: any[]) => Promise<any>>(key: string, fn: T, options?: CacheOptions<T>) {\n  const {\n    deps,\n    retry,\n    maxAge,\n    version,\n    compareBeforeUpdate,\n    remoteMemoryCache,\n    equals,\n    cacheEnabled,\n    beforeRequest,\n    onSuccess,\n    onError,\n    errorHandler,\n  } = {\n    deps: [],\n    retry: 0,\n    equals: (a, b) =>\n      a.length === b.length && a.every((item, index) => item === b[index]),\n    compareBeforeUpdate: deepEquals,\n    remoteMemoryCache: false,\n    ...options,\n  } satisfies CacheOptions<T>\n\n  const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\n\n  const queryFnEnhancer = (fn: (args: Parameters<T>) => Promise<ReturnType<T>>, options: Pick<CacheOptions<T>, 'onSuccess' | 'onError'> & { type: 'remote' | 'local' }) => (((args) => {\n    const promiseResult = fn(args);\n\n    promiseResult\n      .then(result => {\n        const res = { type: options.type, result: result as Awaited<ReturnType<T>> }\n        options.onSuccess?.(res)\n        return res\n      }, options.onError)\n      .catch(() => {})\n\n    return promiseResult\n  }) as typeof fn)\n\n  const getLocalCache = async (args: Parameters<T>) => {\n    const cache = await db.getItem<CacheItem<T>>(key)\n    if (\n      cache\n      && (!version || cache.version === version)\n      && (!cache.expires || cache.expires > Date.now())\n      && equals(cache.deps, args.concat(deps))\n    ) {\n      return cache.result\n    }\n\n    throw new Error('Cache not found')\n  }\n\n  const remoteResultCache: {\n    success: boolean\n    args: Parameters<T>\n    result: ReturnType<T> | null\n  } = {\n    success: false,\n    args: [] as any,\n    result: null,\n  }\n\n  const clearMemoryCache = () => {\n    remoteResultCache.success = false\n    remoteResultCache.result = null\n    remoteResultCache.args = [] as any\n  }\n\n  const queryWithMemoryCache = (args: Parameters<T>) => {\n    if (remoteResultCache.success && equals(remoteResultCache.args, args)) {\n      return {\n        type: 'memory' as const,\n        promiseResult: remoteResultCache.result!,\n      }\n    }\n\n    remoteResultCache.args = args\n    remoteResultCache.success = true\n    const result = (remoteResultCache.result = fnRunner(\n      () => fn(...args),\n      retry,\n    ) as ReturnType<T>)\n\n    Promise.resolve(result)\n      .then((result) => {\n        !remoteMemoryCache && clearMemoryCache()\n        return result\n      })\n      .catch(clearMemoryCache)\n\n    return { type: 'remote' as const, promiseResult: result }\n  }\n\n  const queryRemoteWithEnhancer = queryFnEnhancer(async (args: Parameters<T>) => {\n    const rs = {\n      type: 'remote' as const,\n      result: null as unknown as Awaited<ReturnType<T>>,\n    }\n\n    try {\n      const { type, promiseResult } = queryWithMemoryCache(args)\n      const result = (rs.result = await promiseResult)\n\n      // 设置缓存\n      type === 'remote'\n      && (!cacheEnabled || (await cacheEnabled(args)))\n      && Promise.resolve().then(async () => {\n        const oldCache = await getLocalCache(args).catch(() => null)\n\n        const cacheData: CacheItem<T> = {\n          deps: args.concat(deps),\n          result,\n          ...(version && { version }),\n          ...(maxAge && { expires: Date.now() + maxAge }),\n        }\n        db.setItem(key, cacheData)\n\n        // 如果配置了比较，且旧缓存存在且与新结果相等，则不触发 onCacheUpdate\n        if (\n          compareBeforeUpdate\n          && oldCache\n          && compareBeforeUpdate(oldCache, result)\n        ) {\n          return\n        }\n        cacheUpdateSubject.next({\n          result,\n          cacheData,\n          isCacheHit: !!oldCache,\n        })\n      })\n    }\n    catch (error) {\n      if (errorHandler) {\n        rs.result = (await errorHandler(error)) as Awaited<ReturnType<T>>\n      }\n      else {\n        throw error\n      }\n    }\n\n    return rs.result\n  }, { type: 'remote' as const, onSuccess, onError })\n\n  const _fn = async (...args: Parameters<T>) => {\n    await beforeRequest?.()\n\n    const [cacheResult, remoteResult] = [\n      queryFnEnhancer(getLocalCache, { type: 'local' as const, onSuccess })(args),\n      queryRemoteWithEnhancer(args),\n    ]\n    const result = await Promise.race([\n      cacheResult.catch(() => remoteResult),\n      remoteResult,\n    ])\n\n    return result\n  }\n\n  _fn.refresh = (...args: Parameters<T>) => queryRemoteWithEnhancer(args)\n\n  _fn.subscribeCacheUpdate = (fn: (data: CacheUpdateEvent<T>) => void) =>\n    cacheUpdateSubject.subscribe(fn)\n\n  _fn.clearCache = async () => {\n    clearMemoryCache()\n    await db.removeItem(key)\n  }\n\n  return _fn\n}\n\n/**\n * 使用自定义数据库实例\n * @param newDb 数据库实例或 storeName，如果为字符串，则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = <T extends string>(newDb: DBType | (T extends 'main-store' ? never : T)) => {\n  if (typeof newDb === 'string') {\n    db = localforage.createInstance({\n      name: DB_NAME,\n      storeName: newDb,\n    })\n  }\n  else {\n    db = newDb\n  }\n}\n\nexport { createQueryWithCache }\n"]}
+{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts"],"names":["localforage","deepEquals","fn","options","result"],"mappings":"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","file":"index.js","sourcesContent":["class ReplaySubject<T> {\n  private maxBufferSize: number\n  private buffer: T[] = []\n\n  private subscriptions: ((data: T) => void)[] = []\n\n  constructor(maxBufferSize = 1) {\n    this.maxBufferSize = maxBufferSize\n  }\n\n  subscribe(fn: (data: T) => void) {\n    this.subscriptions.push(fn)\n    this.buffer.forEach(data => fn(data))\n    return () => this.unsubscribe(fn)\n  }\n\n  unsubscribe(fn: (data: T) => void) {\n    this.subscriptions = this.subscriptions.filter(f => f !== fn)\n  }\n\n  next(data: T) {\n    this.subscriptions.forEach(fn => fn(data))\n    this.buffer.push(data)\n    if (this.buffer.length > this.maxBufferSize) {\n      this.buffer = this.buffer.slice(1)\n    }\n  }\n}\n\nexport { ReplaySubject }\n","export async function fnRunner<T extends (...args: any[]) => Promise<any>>(fn: T, retryTimes: number = 0): Promise<Awaited<ReturnType<T>>> {\n  const times = (retryTimes || 0) + 1\n  for (let i = 0; i < times; i++) {\n    try {\n      return await fn()\n    }\n    catch (error) {\n      // Only throw if this was the last attempt\n      if (i === times - 1) {\n        throw error\n      }\n    }\n  }\n  // This line should never be reached, but it's required for type safety.\n  throw new Error('fnRunner: Unexpected error - all retries exhausted.')\n}\n","import localforage from 'localforage'\nimport { equals as deepEquals } from 'ramda'\nimport { ReplaySubject } from '../../class'\nimport { fnRunner } from '../fnRunner'\n\ntype DBType = Pick<\n  LocalForage,\n  'getItem' | 'setItem' | 'removeItem' | 'clear'\n  // 这些可以暂时不考虑\n  //  | 'clear' | 'keys' | 'length'\n>\n\nconst DB_NAME = 'sh-cache-common'\n\nlet db: DBType = localforage.createInstance({\n  name: DB_NAME,\n  storeName: 'main-store',\n  // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存参数 */\n  deps: any[]\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 缓存过期时间，为空表示永不过期 */\n  expires?: number\n  /** 缓存结果 */\n  result: Awaited<ReturnType<T>>\n}\n\n/** 依赖项类型，支持直接值或函数形式（运行时取值） */\ntype DepItem = unknown | (() => unknown)\n\ninterface CacheOptions<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存过期时间，为空表示永不过期 */\n  maxAge?: number\n  /** 缓存版本，用于缓存数据结构变更 */\n  version?: string\n  /** 依赖项，用于缓存依赖项变更。支持函数形式，函数会在运行时调用取值 */\n  deps?: DepItem[];\n  /**\n   * 重试次数，为0表示不重试\n   * @default 0\n   */\n  retry?: number\n  /**\n   * 是否比较旧缓存与新缓存后再触发 onCacheUpdate\n   * 为 true 时，只有当新旧缓存不一致时才触发 onCacheUpdate\n   * 为 false 时，总是触发 onCacheUpdate\n   * @default R.equals\n   */\n  compareBeforeUpdate?:\n    | ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean)\n    | false\n  /**\n   * 是否启用远程内存缓存\n   * 为 true 时，启用远程内存缓存\n   * 为 false 时，不启用远程内存缓存\n   * @default false\n   */\n  remoteMemoryCache?: boolean\n  /**\n   * 比较依赖项（函数参数及 deps）是否相等\n   * @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index])\n   * */\n  equals?: (prev: any[], next: any[]) => boolean\n  /**\n   * 根据入参决定是否添加缓存\n   * 不传的话默认启用缓存\n   */\n  cacheEnabled?: (args: Parameters<T>) => Promise<boolean>\n  /** 请求前回调 */\n  beforeRequest?: () => Promise<void> | void\n  /** 请求成功回调 */\n  onSuccess?: (result: {\n    type: 'local' | 'remote'\n    result: Awaited<ReturnType<T>>\n  }) => void\n  /** 请求错误回调 */\n  onError?: (error: any) => void\n  /** 远程请求错误处理 */\n  errorHandler?: (error: any) => any\n  // /** 缓存更新回调 */\n  // onCacheUpdate?: (\n  //   result: Awaited<ReturnType<T>>,\n  //   cacheData: CacheItem<T>,\n  // ) => void;\n}\n\ninterface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {\n  result: Awaited<ReturnType<T>>\n  cacheData: CacheItem<T>\n  isCacheHit: boolean\n}\n\nfunction createQueryWithCache<T extends (...args: any[]) => Promise<any>>(key: string, fn: T, options?: CacheOptions<T>) {\n  const {\n    deps,\n    retry,\n    maxAge,\n    version,\n    compareBeforeUpdate,\n    remoteMemoryCache,\n    equals,\n    cacheEnabled,\n    beforeRequest,\n    onSuccess,\n    onError,\n    errorHandler,\n  } = {\n    deps: [],\n    retry: 0,\n    equals: (a, b) =>\n      a.length === b.length && a.every((item, index) => item === b[index]),\n    compareBeforeUpdate: deepEquals,\n    remoteMemoryCache: false,\n    ...options,\n  } satisfies CacheOptions<T>\n\n  const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\n\n  /** 解析 deps，如果元素是函数则调用获取值 */\n  const resolveDeps = () => deps.map(dep => typeof dep === 'function' ? dep() : dep)\n\n  const queryFnEnhancer = (fn: (args: Parameters<T>) => Promise<ReturnType<T>>, options: Pick<CacheOptions<T>, 'onSuccess' | 'onError'> & { type: 'remote' | 'local' }) => (((args) => {\n    const promiseResult = fn(args);\n\n    promiseResult\n      .then(result => {\n        const res = { type: options.type, result: result as Awaited<ReturnType<T>> }\n        options.onSuccess?.(res)\n        return res\n      }, options.onError)\n      .catch(() => {})\n\n    return promiseResult\n  }) as typeof fn)\n\n  const getLocalCache = async (args: Parameters<T>) => {\n    const cache = await db.getItem<CacheItem<T>>(key)\n    if (\n      cache\n      && (!version || cache.version === version)\n      && (!cache.expires || cache.expires > Date.now())\n      && equals(cache.deps, args.concat(resolveDeps()))\n    ) {\n      return cache.result\n    }\n\n    throw new Error('Cache not found')\n  }\n\n  const remoteResultCache: {\n    success: boolean\n    args: Parameters<T>\n    result: ReturnType<T> | null\n  } = {\n    success: false,\n    args: [] as any,\n    result: null,\n  }\n\n  const clearMemoryCache = () => {\n    remoteResultCache.success = false\n    remoteResultCache.result = null\n    remoteResultCache.args = [] as any\n  }\n\n  const queryWithMemoryCache = (args: Parameters<T>) => {\n    if (remoteResultCache.success && equals(remoteResultCache.args, args)) {\n      return {\n        type: 'memory' as const,\n        promiseResult: remoteResultCache.result!,\n      }\n    }\n\n    remoteResultCache.args = args\n    remoteResultCache.success = true\n    const result = (remoteResultCache.result = fnRunner(\n      () => fn(...args),\n      retry,\n    ) as ReturnType<T>)\n\n    Promise.resolve(result)\n      .then((result) => {\n        !remoteMemoryCache && clearMemoryCache()\n        return result\n      })\n      .catch(clearMemoryCache)\n\n    return { type: 'remote' as const, promiseResult: result }\n  }\n\n  const queryRemoteWithEnhancer = queryFnEnhancer(async (args: Parameters<T>) => {\n    const rs = {\n      type: 'remote' as const,\n      result: null as unknown as Awaited<ReturnType<T>>,\n    }\n\n    try {\n      const { type, promiseResult } = queryWithMemoryCache(args)\n      const result = (rs.result = await promiseResult)\n\n      // 设置缓存\n      type === 'remote'\n      && (!cacheEnabled || (await cacheEnabled(args)))\n      && Promise.resolve().then(async () => {\n        const oldCache = await getLocalCache(args).catch(() => null)\n\n        const cacheData: CacheItem<T> = {\n          deps: args.concat(resolveDeps()),\n          result,\n          ...(version && { version }),\n          ...(maxAge && { expires: Date.now() + maxAge }),\n        }\n        db.setItem(key, cacheData)\n\n        // 如果配置了比较，且旧缓存存在且与新结果相等，则不触发 onCacheUpdate\n        if (\n          compareBeforeUpdate\n          && oldCache\n          && compareBeforeUpdate(oldCache, result)\n        ) {\n          return\n        }\n        cacheUpdateSubject.next({\n          result,\n          cacheData,\n          isCacheHit: !!oldCache,\n        })\n      })\n    }\n    catch (error) {\n      if (errorHandler) {\n        rs.result = (await errorHandler(error)) as Awaited<ReturnType<T>>\n      }\n      else {\n        throw error\n      }\n    }\n\n    return rs.result\n  }, { type: 'remote' as const, onSuccess, onError })\n\n  const _fn = async (...args: Parameters<T>) => {\n    await beforeRequest?.()\n\n    const [cacheResult, remoteResult] = [\n      queryFnEnhancer(getLocalCache, { type: 'local' as const, onSuccess })(args),\n      queryRemoteWithEnhancer(args),\n    ]\n    const result = await Promise.race([\n      cacheResult.catch(() => remoteResult),\n      remoteResult,\n    ])\n\n    return result\n  }\n\n  _fn.refresh = (...args: Parameters<T>) => queryRemoteWithEnhancer(args)\n\n  _fn.subscribeCacheUpdate = (fn: (data: CacheUpdateEvent<T>) => void) =>\n    cacheUpdateSubject.subscribe(fn)\n\n  _fn.clearCache = async () => {\n    clearMemoryCache()\n    await db.removeItem(key)\n  }\n\n  return _fn\n}\n\n/**\n * 使用自定义数据库实例\n * @param newDb 数据库实例或 storeName，如果为字符串，则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = <T extends string>(newDb: DBType | (T extends 'main-store' ? never : T)) => {\n  if (typeof newDb === 'string') {\n    db = localforage.createInstance({\n      name: DB_NAME,\n      storeName: newDb,\n    })\n  }\n  else {\n    db = newDb\n  }\n}\n\nexport { createQueryWithCache }\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shihengtech/utils",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "A collection of utility tools for frontend projects",
   "author": {
     "name": "asakura",