@shihengtech/utils 0.0.2 → 0.0.3

package/dist/index.d.cts

@@ -1,87 +0,0 @@
-declare class ReplaySubject<T> {
-    private maxBufferSize;
-    private buffer;
-    private subscriptions;
-    constructor(maxBufferSize?: number);
-    subscribe(fn: (data: T) => void): () => void;
-    unsubscribe(fn: (data: T) => void): void;
-    next(data: T): void;
-}
-
-type DBType = Pick<LocalForage, 'getItem' | 'setItem' | 'removeItem' | 'clear'>;
-interface CacheItem<T extends (...args: any[]) => Promise<any>> {
-    /** 缓存参数 */
-    args: Parameters<T>;
-    /** 缓存版本，用于缓存数据结构变更 */
-    version?: string;
-    /** 缓存过期时间，为空表示永不过期 */
-    expires?: number;
-    /** 缓存结果 */
-    result: Awaited<ReturnType<T>>;
-}
-interface CacheOptions<T extends (...args: any[]) => Promise<any>> {
-    /** 缓存过期时间，为空表示永不过期 */
-    maxAge?: number;
-    /** 缓存版本，用于缓存数据结构变更 */
-    version?: string;
-    /**
-     * 重试次数，为0表示不重试
-     * @default 0
-     */
-    retry?: number;
-    /**
-     * 是否比较旧缓存与新缓存后再触发 onCacheUpdate
-     * 为 true 时，只有当新旧缓存不一致时才触发 onCacheUpdate
-     * 为 false 时，总是触发 onCacheUpdate
-     * @default R.equals
-     */
-    compareBeforeUpdate?: ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean) | false;
-    /**
-     * 是否启用远程内存缓存
-     * 为 true 时，启用远程内存缓存
-     * 为 false 时，不启用远程内存缓存
-     * @default false
-     */
-    remoteMemoryCache?: boolean;
-    /** @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index]) */
-    equals?: (prev: Parameters<T>, next: Parameters<T>) => boolean;
-    /**
-     * 根据入参决定是否添加缓存
-     * 不传的话默认启用缓存
-     */
-    cacheEnabled?: (args: Parameters<T>) => Promise<boolean>;
-    /** 请求前回调 */
-    beforeRequest?: () => Promise<void> | void;
-    /** 请求成功回调 */
-    onSuccess?: (result: {
-        type: 'local' | 'remote';
-        result: Awaited<ReturnType<T>>;
-    }) => void;
-    /** 请求错误回调 */
-    onError?: (error: any) => void;
-    /** 远程请求错误处理 */
-    errorHandler?: (error: any) => any;
-}
-interface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {
-    result: Awaited<ReturnType<T>>;
-    cacheData: CacheItem<T>;
-    isCacheHit: boolean;
-}
-declare function createQueryWithCache<T extends (...args: any[]) => Promise<any>>(key: string, fn: T, options?: CacheOptions<T>): {
-    (...args: Parameters<T>): Promise<ReturnType<T>>;
-    subscribeCacheUpdate(fn: (data: CacheUpdateEvent<T>) => void): () => void;
-    clearCache(): Promise<void>;
-};
-declare namespace createQueryWithCache {
-    var useDb: (newDb: DBType | string) => void;
-}
-
-declare function fnRunner<T>(fn: () => Promise<T>, retryTimes?: number): Promise<T>;
-
-/**
- * @shihengtech/utils - A collection of utility functions
- */
-
-declare const version = "0.0.2";
-
-export { ReplaySubject, createQueryWithCache, fnRunner, version };

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts","../src/index.ts"],"names":["version","equals","deepEquals","result","fn"],"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>(fn: () => Promise<T>, retryTimes: number = 0): Promise<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\n// TODO:\n// 1. 是否需要增加 reload 方法，只请求远程并刷新缓存\n\ntype DBType = Pick<\n  LocalForage,\n  'getItem' | 'setItem' | 'removeItem' | 'clear'\n  // 这些可以暂时不考虑\n  //  | 'clear' | 'keys' | 'length'\n>\n\nlet db: DBType = localforage.createInstance({\n  name: 'sh-common-cache',\n  // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n  /** 缓存参数 */\n  args: Parameters<T>\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   * 重试次数，为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  /** @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index]) */\n  equals?: (prev: Parameters<T>, next: Parameters<T>) => 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    retry,\n    maxAge,\n    version,\n    compareBeforeUpdate,\n    remoteMemoryCache,\n    equals,\n    cacheEnabled,\n    beforeRequest,\n    onSuccess,\n    onError,\n    errorHandler,\n  } = {\n    equals: (a, b) =>\n      a.length === b.length && a.every((item, index) => item === b[index]),\n    retry: 0,\n    compareBeforeUpdate: deepEquals,\n    remoteMemoryCache: false,\n    ...options,\n  } as CacheOptions<T>\n\n  const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\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.args, args)\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! as ReturnType<T>,\n      }\n    }\n\n    remoteResultCache.args = args\n    remoteResultCache.success = true\n    const result: ReturnType<T> = (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 as ReturnType<T> }\n  }\n\n  const queryRemote = 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 = {\n          args,\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, 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  }\n\n  const _fn = async (...args: Parameters<T>) => {\n    await beforeRequest?.()\n\n    const [cacheResult, remoteResult] = [\n      getLocalCache(args),\n      queryRemote(args),\n    ]\n    cacheResult\n      .then(result =>\n        onSuccess?.({\n          type: 'local' as const,\n          result: result as Awaited<ReturnType<T>>,\n        }),\n      )\n      .catch(() => {})\n    remoteResult\n      .then(result =>\n        onSuccess?.({\n          type: 'remote' as const,\n          result: result as Awaited<ReturnType<T>>,\n        }),\n      )\n      .catch(error => onError?.(error))\n      .catch(() => {})\n    const result = await Promise.race([\n      cacheResult.catch(() => remoteResult),\n      remoteResult,\n    ])\n\n    return result\n  }\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 数据库实例或数据库名称，如果为字符串，则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = (newDb: DBType | string) => {\n  if (typeof newDb === 'string') {\n    db = localforage.createInstance({\n      name: newDb,\n    })\n  }\n  else {\n    db = newDb\n  }\n}\n\nexport { createQueryWithCache }\n","/**\n * @shihengtech/utils - A collection of utility functions\n */\n\n// Type checking utilities\nexport * from './class'\nexport * from './utils'\n// Version\nexport const version = '0.0.2'\n"]}