@cloudcome/utils-browser/dist/cache.mjs.map

cloudcome utils for browser

{"version":3,"file":"cache.mjs","sources":["../src/cache.ts"],"sourcesContent":["import { AbstractCache, type CacheOptions, type Cached } from '@cloudcome/utils-core/cache';\nimport type { MaybePromise } from '@cloudcome/utils-core/types';\n\n/**\n * 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类\n * @template T - 缓存数据的类型\n */\nexport class StorageCache<T> extends AbstractCache<T> {\n  /**\n   * 创建一个新的 StorageCache 实例\n   * @param storage - 使用的存储实现（localStorage 或 sessionStorage）\n   * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n   */\n  constructor(\n    readonly storage: Storage,\n    readonly namespace = '',\n  ) {\n    super();\n  }\n\n  /**\n   * 通过ID获取缓存数据\n   * @param id - 要获取的缓存键\n   * @returns 如果找到且未过期则返回缓存数据，否则返回null\n   */\n  get(id: string): Cached<T> | null {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      const cachedString = storage.getItem(fullId);\n      if (!cachedString) return null;\n\n      const cached = JSON.parse(cachedString);\n\n      if (cached.createdAt + cached.maxAge < Date.now()) {\n        this.del(id);\n        return null;\n      }\n\n      return cached;\n    } catch (e) {\n      return null;\n    }\n  }\n\n  /**\n   * 将数据存储到缓存中\n   * @param id - 存储数据使用的缓存键\n   * @param data - 要缓存的数据\n   * @param options - 可选的缓存配置\n   * @returns 成功返回true，存储失败返回false\n   */\n  set(id: string, data: T, options?: CacheOptions) {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      storage.setItem(\n        fullId,\n        JSON.stringify({\n          id,\n          data,\n          createdAt: Date.now(),\n          maxAge: options?.maxAge || 0,\n        }),\n      );\n    } catch (cause) {\n      //\n    }\n  }\n\n  /**\n   * 通过ID删除缓存数据\n   * @param id - 要删除的缓存键\n   */\n  del(id: string) {\n    const { storage, namespace } = this;\n    const fullId = namespace ? `${namespace}:${id}` : id;\n\n    try {\n      storage.removeItem(fullId);\n    } catch (cause) {\n      //\n    }\n  }\n\n  clear() {\n    try {\n      this.storage.clear();\n    } catch (err) {\n      //\n    }\n  }\n}\n\n/**\n * 创建一个使用 localStorage 的缓存实例\n * @template T - 缓存数据的类型\n * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n * @returns 使用 localStorage 的新 StorageCache 实例\n */\nexport function createLocalCache<T>(namespace?: string): AbstractCache<T> {\n  return new StorageCache<T>(localStorage, namespace);\n}\n\n/**\n * 创建一个使用 sessionStorage 的缓存实例\n * @template T - 缓存数据的类型\n * @param namespace - 可选，用于为缓存键添加前缀的命名空间\n * @returns 使用 sessionStorage 的新 StorageCache 实例\n */\nexport function createSessionCache<T>(namespace?: string): AbstractCache<T> {\n  return new StorageCache<T>(sessionStorage, namespace);\n}\n"],"names":[],"mappings":";AAOO,MAAM,qBAAwB,cAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpD,YACW,SACA,YAAY,IACrB;AACM,UAAA;AAHG,SAAA,UAAA;AACA,SAAA,YAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUX,IAAI,IAA8B;AAC1B,UAAA,EAAE,SAAS,UAAA,IAAc;AAC/B,UAAM,SAAS,YAAY,GAAG,SAAS,IAAI,EAAE,KAAK;AAE9C,QAAA;AACI,YAAA,eAAe,QAAQ,QAAQ,MAAM;AACvC,UAAA,CAAC,aAAqB,QAAA;AAEpB,YAAA,SAAS,KAAK,MAAM,YAAY;AAEtC,UAAI,OAAO,YAAY,OAAO,SAAS,KAAK,OAAO;AACjD,aAAK,IAAI,EAAE;AACJ,eAAA;AAAA,MAAA;AAGF,aAAA;AAAA,aACA,GAAG;AACH,aAAA;AAAA,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUF,IAAI,IAAY,MAAS,SAAwB;AACzC,UAAA,EAAE,SAAS,UAAA,IAAc;AAC/B,UAAM,SAAS,YAAY,GAAG,SAAS,IAAI,EAAE,KAAK;AAE9C,QAAA;AACM,cAAA;AAAA,QACN;AAAA,QACA,KAAK,UAAU;AAAA,UACb;AAAA,UACA;AAAA,UACA,WAAW,KAAK,IAAI;AAAA,UACpB,QAAQ,SAAS,UAAU;AAAA,QAC5B,CAAA;AAAA,MACH;AAAA,aACO,OAAO;AAAA,IAAA;AAAA,EAEhB;AAAA;AAAA;AAAA;AAAA;AAAA,EAOF,IAAI,IAAY;AACR,UAAA,EAAE,SAAS,UAAA,IAAc;AAC/B,UAAM,SAAS,YAAY,GAAG,SAAS,IAAI,EAAE,KAAK;AAE9C,QAAA;AACF,cAAQ,WAAW,MAAM;AAAA,aAClB,OAAO;AAAA,IAAA;AAAA,EAEhB;AAAA,EAGF,QAAQ;AACF,QAAA;AACF,WAAK,QAAQ,MAAM;AAAA,aACZ,KAAK;AAAA,IAAA;AAAA,EAEd;AAEJ;AAQO,SAAS,iBAAoB,WAAsC;AACjE,SAAA,IAAI,aAAgB,cAAc,SAAS;AACpD;AAQO,SAAS,mBAAsB,WAAsC;AACnE,SAAA,IAAI,aAAgB,gBAAgB,SAAS;AACtD;"}