@cloudcome/utils-core/dist/cache.cjs.map

cloudcome core utils

{"version":3,"file":"cache.cjs","sources":["../src/cache.ts"],"sourcesContent":["import { type DateValue, dateParse } from './date';\nimport type { MaybePromise } from './types';\n\n/**\n * 缓存选项\n */\nexport type CacheOptions = {\n  /**\n   * 缓存的最大时长（毫秒），为 0 时表示永久缓存\n   */\n  maxAge?: number;\n\n  /**\n   * 缓存的过期时间（时间戳、日期字符串、日期对象等）\n   * 优先级比 maxAge 更高\n   */\n  expiredAt?: DateValue;\n};\n\n/**\n * 缓存项\n * @template T 缓存数据的类型\n */\nexport type Cached<T> = {\n  /**\n   * 缓存项的唯一标识\n   */\n  id: string;\n  /**\n   * 缓存的数据\n   */\n  data: T;\n  /**\n   * 缓存项的创建时间（时间戳）\n   */\n  createdAt: number;\n  /**\n   * 缓存项的过期时间（时间戳）\n   */\n  expiredAt: number;\n};\n\nexport type Cache<T> = {\n  get(id: string): MaybePromise<Cached<T> | null>;\n\n  set(id: string, data: T, options?: CacheOptions): MaybePromise<void>;\n\n  del(id: string): MaybePromise<void>;\n};\n\n/**\n * 缓存抽象类\n * @template T 缓存数据的类型\n */\nexport class AbstractCache<T> implements Cache<T> {\n  isExpired(cached: Cached<T>) {\n    return cached.expiredAt > 0 && Date.now() > cached.expiredAt;\n  }\n\n  normalizeCached(id: string, data: T, options?: CacheOptions): Cached<T> {\n    const { expiredAt = 0, maxAge = 0 } = options || {};\n    const now = Date.now();\n    return {\n      id,\n      data,\n      createdAt: now,\n      expiredAt: expiredAt ? dateParse(expiredAt).getTime() : maxAge > 0 ? now + maxAge : 0,\n    };\n  }\n\n  /**\n   * 获取缓存项\n   * @param id 缓存项的唯一标识\n   * @returns 返回缓存项或 null\n   */\n  get(id: string): MaybePromise<Cached<T> | null> {\n    return null;\n  }\n\n  /**\n   * 设置缓存项\n   * @param id 缓存项的唯一标识\n   * @param data 要缓存的数据\n   * @param options 缓存选项\n   */\n  set(id: string, data: T, options?: CacheOptions): MaybePromise<void> {\n    //\n  }\n\n  /**\n   * 删除缓存项\n   * @param id 缓存项的唯一标识\n   */\n  del(id: string): MaybePromise<void> {\n    //\n  }\n\n  /**\n   * 清空缓存\n   */\n  clear(): MaybePromise<void> {\n    //\n  }\n}\n\n/**\n * 内存缓存实现类\n * @template T 缓存数据的类型\n */\nexport class MemoryCache<T> extends AbstractCache<T> {\n  private cache: Map<string, Cached<T>> = new Map();\n\n  get(id: string) {\n    const cached = this.cache.get(id);\n\n    if (!cached) return null;\n\n    if (this.isExpired(cached)) {\n      this.del(id);\n      return null;\n    }\n\n    return cached;\n  }\n\n  set(id: string, data: T, options?: CacheOptions) {\n    this.cache.set(id, this.normalizeCached(id, data, options));\n  }\n\n  del(id: string) {\n    this.cache.delete(id);\n  }\n\n  clear() {\n    this.cache.clear();\n  }\n}\n\n/**\n * 创建一个新的内存缓存实例\n * @template T 缓存数据的类型\n * @returns 返回一个新的 MemoryCache 实例\n */\nexport function createMemCache<T>() {\n  return new MemoryCache<T>();\n}\n"],"names":["dateParse"],"mappings":";;;AAsDO,MAAM,cAAqC;AAAA,EAChD,UAAU,QAAmB;AAC3B,WAAO,OAAO,YAAY,KAAK,KAAK,IAAA,IAAQ,OAAO;AAAA,EAAA;AAAA,EAGrD,gBAAgB,IAAY,MAAS,SAAmC;AACtE,UAAM,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,WAAW,CAAC;AAC5C,UAAA,MAAM,KAAK,IAAI;AACd,WAAA;AAAA,MACL;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,WAAW,YAAYA,KAAA,UAAU,SAAS,EAAE,QAAY,IAAA,SAAS,IAAI,MAAM,SAAS;AAAA,IACtF;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,IAAI,IAA4C;AACvC,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,IAAI,IAAY,MAAS,SAA4C;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQrE,IAAI,IAAgC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAOpC,QAA4B;AAAA,EAAA;AAG9B;AAMO,MAAM,oBAAuB,cAAiB;AAAA,EAC3C,4BAAoC,IAAI;AAAA,EAEhD,IAAI,IAAY;AACd,UAAM,SAAS,KAAK,MAAM,IAAI,EAAE;AAE5B,QAAA,CAAC,OAAe,QAAA;AAEhB,QAAA,KAAK,UAAU,MAAM,GAAG;AAC1B,WAAK,IAAI,EAAE;AACJ,aAAA;AAAA,IAAA;AAGF,WAAA;AAAA,EAAA;AAAA,EAGT,IAAI,IAAY,MAAS,SAAwB;AAC1C,SAAA,MAAM,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,OAAO,CAAC;AAAA,EAAA;AAAA,EAG5D,IAAI,IAAY;AACT,SAAA,MAAM,OAAO,EAAE;AAAA,EAAA;AAAA,EAGtB,QAAQ;AACN,SAAK,MAAM,MAAM;AAAA,EAAA;AAErB;AAOO,SAAS,iBAAoB;AAClC,SAAO,IAAI,YAAe;AAC5B;;;;"}