@cloudcome/utils-browser 1.2.15 → 1.2.17

package/README.md

@@ -117,7 +117,7 @@ UniApp 工具库，依赖 `@cloudcome/utils-core`、`@cloudcome/utils-vue`：
 
 ## 开发
 
-详见 [DEVELOPMENT.md](./DEVELOPMENT.md)。
+详见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
 
 ## 许可
 

package/dist/base64.cjs

@@ -1,15 +1,28 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/base64.ts
+/**
+* 【浏览器环境】将字符串编码为 Base64 格式
+* @param input 要编码的字符串
+* @returns 编码后的 Base64 字符串
+* @remarks
+* 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现
+*/
 function encodeBase64(input) {
-  const encoder = new TextEncoder();
-  const unit8Array = encoder.encode(input);
-  return btoa(String.fromCharCode(...unit8Array));
+	const unit8Array = new TextEncoder().encode(input);
+	return btoa(String.fromCharCode(...unit8Array));
 }
+/**
+* 【浏览器环境】 将 Base64 字符串解码为原始字符串
+* @param input 要解码的 Base64 字符串
+* @returns 解码后的原始字符串
+*/
 function decodeBase64(input) {
-  const decoder = new TextDecoder();
-  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));
-  return decoder.decode(unit8Array);
+	const decoder = new TextDecoder();
+	const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));
+	return decoder.decode(unit8Array);
 }
+//#endregion
 exports.decodeBase64 = decodeBase64;
 exports.encodeBase64 = encodeBase64;
-//# sourceMappingURL=base64.cjs.map
+
+//# sourceMappingURL=base64.cjs.map

package/dist/base64.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"base64.cjs","sources":["../src/base64.ts"],"sourcesContent":["// @ref https://blog.csdn.net/m0_72642319/article/details/139743196\n\n/**\n * 【浏览器环境】将字符串编码为 Base64 格式\n * @param input 要编码的字符串\n * @returns 编码后的 Base64 字符串\n * @remarks\n * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现\n */\nexport function encodeBase64(input: string) {\n  const encoder = new TextEncoder();\n  const unit8Array = encoder.encode(input);\n  return btoa(String.fromCharCode(...unit8Array));\n}\n\n/**\n * 【浏览器环境】 将 Base64 字符串解码为原始字符串\n * @param input 要解码的 Base64 字符串\n * @returns 解码后的原始字符串\n */\nexport function decodeBase64(input: string) {\n  const decoder = new TextDecoder();\n  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));\n  return decoder.decode(unit8Array);\n}\n"],"names":[],"mappings":";;AASO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,QAAQ,OAAO,KAAK;AACvC,SAAO,KAAK,OAAO,aAAa,GAAG,UAAU,CAAC;AAChD;AAOO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,WAAW,KAAK,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/D,SAAA,QAAQ,OAAO,UAAU;AAClC;;;"}
+{"version":3,"file":"base64.cjs","names":[],"sources":["../src/base64.ts"],"sourcesContent":["// @ref https://blog.csdn.net/m0_72642319/article/details/139743196\n\n/**\n * 【浏览器环境】将字符串编码为 Base64 格式\n * @param input 要编码的字符串\n * @returns 编码后的 Base64 字符串\n * @remarks\n * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现\n */\nexport function encodeBase64(input: string) {\n  const encoder = new TextEncoder();\n  const unit8Array = encoder.encode(input);\n  return btoa(String.fromCharCode(...unit8Array));\n}\n\n/**\n * 【浏览器环境】 将 Base64 字符串解码为原始字符串\n * @param input 要解码的 Base64 字符串\n * @returns 解码后的原始字符串\n */\nexport function decodeBase64(input: string) {\n  const decoder = new TextDecoder();\n  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));\n  return decoder.decode(unit8Array);\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,aAAa,OAAe;CAE1C,MAAM,aAAa,IADC,aACD,CAAQ,OAAO,MAAM;CACxC,OAAO,KAAK,OAAO,aAAa,GAAG,WAAW,CAAC;;;;;;;AAQjD,SAAgB,aAAa,OAAe;CAC1C,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,aAAa,WAAW,KAAK,KAAK,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;CACvE,OAAO,QAAQ,OAAO,WAAW"}

package/dist/base64.mjs

@@ -1,15 +1,26 @@
+//#region src/base64.ts
+/**
+* 【浏览器环境】将字符串编码为 Base64 格式
+* @param input 要编码的字符串
+* @returns 编码后的 Base64 字符串
+* @remarks
+* 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现
+*/
 function encodeBase64(input) {
-  const encoder = new TextEncoder();
-  const unit8Array = encoder.encode(input);
-  return btoa(String.fromCharCode(...unit8Array));
+	const unit8Array = new TextEncoder().encode(input);
+	return btoa(String.fromCharCode(...unit8Array));
 }
+/**
+* 【浏览器环境】 将 Base64 字符串解码为原始字符串
+* @param input 要解码的 Base64 字符串
+* @returns 解码后的原始字符串
+*/
 function decodeBase64(input) {
-  const decoder = new TextDecoder();
-  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));
-  return decoder.decode(unit8Array);
+	const decoder = new TextDecoder();
+	const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));
+	return decoder.decode(unit8Array);
 }
-export {
-  decodeBase64,
-  encodeBase64
-};
-//# sourceMappingURL=base64.mjs.map
+//#endregion
+export { decodeBase64, encodeBase64 };
+
+//# sourceMappingURL=base64.mjs.map

package/dist/base64.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"base64.mjs","sources":["../src/base64.ts"],"sourcesContent":["// @ref https://blog.csdn.net/m0_72642319/article/details/139743196\n\n/**\n * 【浏览器环境】将字符串编码为 Base64 格式\n * @param input 要编码的字符串\n * @returns 编码后的 Base64 字符串\n * @remarks\n * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现\n */\nexport function encodeBase64(input: string) {\n  const encoder = new TextEncoder();\n  const unit8Array = encoder.encode(input);\n  return btoa(String.fromCharCode(...unit8Array));\n}\n\n/**\n * 【浏览器环境】 将 Base64 字符串解码为原始字符串\n * @param input 要解码的 Base64 字符串\n * @returns 解码后的原始字符串\n */\nexport function decodeBase64(input: string) {\n  const decoder = new TextDecoder();\n  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));\n  return decoder.decode(unit8Array);\n}\n"],"names":[],"mappings":"AASO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,QAAQ,OAAO,KAAK;AACvC,SAAO,KAAK,OAAO,aAAa,GAAG,UAAU,CAAC;AAChD;AAOO,SAAS,aAAa,OAAe;AACpC,QAAA,UAAU,IAAI,YAAY;AAC1B,QAAA,aAAa,WAAW,KAAK,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/D,SAAA,QAAQ,OAAO,UAAU;AAClC;"}
+{"version":3,"file":"base64.mjs","names":[],"sources":["../src/base64.ts"],"sourcesContent":["// @ref https://blog.csdn.net/m0_72642319/article/details/139743196\n\n/**\n * 【浏览器环境】将字符串编码为 Base64 格式\n * @param input 要编码的字符串\n * @returns 编码后的 Base64 字符串\n * @remarks\n * 在 Node.js 环境中使用 Buffer 实现，在浏览器环境中使用 TextEncoder 和 btoa 实现\n */\nexport function encodeBase64(input: string) {\n  const encoder = new TextEncoder();\n  const unit8Array = encoder.encode(input);\n  return btoa(String.fromCharCode(...unit8Array));\n}\n\n/**\n * 【浏览器环境】 将 Base64 字符串解码为原始字符串\n * @param input 要解码的 Base64 字符串\n * @returns 解码后的原始字符串\n */\nexport function decodeBase64(input: string) {\n  const decoder = new TextDecoder();\n  const unit8Array = Uint8Array.from(atob(input), (c) => c.charCodeAt(0));\n  return decoder.decode(unit8Array);\n}\n"],"mappings":";;;;;;;;AASA,SAAgB,aAAa,OAAe;CAE1C,MAAM,aAAa,IADC,aACD,CAAQ,OAAO,MAAM;CACxC,OAAO,KAAK,OAAO,aAAa,GAAG,WAAW,CAAC;;;;;;;AAQjD,SAAgB,aAAa,OAAe;CAC1C,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,aAAa,WAAW,KAAK,KAAK,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;CACvE,OAAO,QAAQ,OAAO,WAAW"}

package/dist/cache.cjs

@@ -1,87 +1,99 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const cache = require("@cloudcome/utils-core/cache");
-class StorageCache extends cache.AbstractCache {
-  /**
-   * 创建一个新的 StorageCache 实例
-   * @param storage - 使用的存储实现（localStorage 或 sessionStorage）
-   * @param namespace - 可选，用于为缓存键添加前缀的命名空间
-   */
-  constructor(storage, namespace = "") {
-    super();
-    this.storage = storage;
-    this.namespace = namespace;
-  }
-  /**
-   * 通过ID获取缓存数据
-   * @param id - 要获取的缓存键
-   * @returns 如果找到且未过期则返回缓存数据，否则返回null
-   */
-  get(id) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      const cachedString = storage.getItem(fullId);
-      if (!cachedString) return null;
-      const cached = JSON.parse(cachedString);
-      if (cached.createdAt + cached.maxAge < Date.now()) {
-        this.del(id);
-        return null;
-      }
-      return cached;
-    } catch (e) {
-      return null;
-    }
-  }
-  /**
-   * 将数据存储到缓存中
-   * @param id - 存储数据使用的缓存键
-   * @param data - 要缓存的数据
-   * @param options - 可选的缓存配置
-   * @returns 成功返回true，存储失败返回false
-   */
-  set(id, data, options) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      storage.setItem(
-        fullId,
-        JSON.stringify({
-          id,
-          data,
-          createdAt: Date.now(),
-          maxAge: options?.maxAge || 0
-        })
-      );
-    } catch (cause) {
-    }
-  }
-  /**
-   * 通过ID删除缓存数据
-   * @param id - 要删除的缓存键
-   */
-  del(id) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      storage.removeItem(fullId);
-    } catch (cause) {
-    }
-  }
-  clear() {
-    try {
-      this.storage.clear();
-    } catch (err) {
-    }
-  }
-}
+let _cloudcome_utils_core_cache = require("@cloudcome/utils-core/cache");
+//#region src/cache.ts
+/**
+* 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类
+* @template T - 缓存数据的类型
+*/
+var StorageCache = class extends _cloudcome_utils_core_cache.AbstractCache {
+	/**
+	* 创建一个新的 StorageCache 实例
+	* @param storage - 使用的存储实现（localStorage 或 sessionStorage）
+	* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+	*/
+	constructor(storage, namespace = "") {
+		super();
+		this.storage = storage;
+		this.namespace = namespace;
+	}
+	/**
+	* 通过ID获取缓存数据
+	* @param id - 要获取的缓存键
+	* @returns 如果找到且未过期则返回缓存数据，否则返回null
+	*/
+	get(id) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			const cachedString = storage.getItem(fullId);
+			if (!cachedString) return null;
+			const cached = JSON.parse(cachedString);
+			if (cached.createdAt + cached.maxAge < Date.now()) {
+				this.del(id);
+				return null;
+			}
+			return cached;
+		} catch (_e) {
+			return null;
+		}
+	}
+	/**
+	* 将数据存储到缓存中
+	* @param id - 存储数据使用的缓存键
+	* @param data - 要缓存的数据
+	* @param options - 可选的缓存配置
+	* @returns 成功返回true，存储失败返回false
+	*/
+	set(id, data, options) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			storage.setItem(fullId, JSON.stringify({
+				id,
+				data,
+				createdAt: Date.now(),
+				maxAge: options?.maxAge || 0
+			}));
+		} catch (_cause) {}
+	}
+	/**
+	* 通过ID删除缓存数据
+	* @param id - 要删除的缓存键
+	*/
+	del(id) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			storage.removeItem(fullId);
+		} catch (_cause) {}
+	}
+	clear() {
+		try {
+			this.storage.clear();
+		} catch (_err) {}
+	}
+};
+/**
+* 创建一个使用 localStorage 的缓存实例
+* @template T - 缓存数据的类型
+* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+* @returns 使用 localStorage 的新 StorageCache 实例
+*/
 function createLocalCache(namespace) {
-  return new StorageCache(localStorage, namespace);
+	return new StorageCache(localStorage, namespace);
 }
+/**
+* 创建一个使用 sessionStorage 的缓存实例
+* @template T - 缓存数据的类型
+* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+* @returns 使用 sessionStorage 的新 StorageCache 实例
+*/
 function createSessionCache(namespace) {
-  return new StorageCache(sessionStorage, namespace);
+	return new StorageCache(sessionStorage, namespace);
 }
+//#endregion
 exports.StorageCache = StorageCache;
 exports.createLocalCache = createLocalCache;
 exports.createSessionCache = createSessionCache;
-//# sourceMappingURL=cache.cjs.map
+
+//# sourceMappingURL=cache.cjs.map

package/dist/cache.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache.cjs","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":["AbstractCache"],"mappings":";;;AAOO,MAAM,qBAAwBA,MAAAA,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;;;;"}
+{"version":3,"file":"cache.cjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import {\n  AbstractCache,\n  type Cached,\n  type CacheOptions,\n} from '@cloudcome/utils-core/cache';\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"],"mappings":";;;;;;;AAUA,IAAa,eAAb,cAAqC,4BAAA,cAAiB;;;;;;CAMpD,YACE,SACA,YAAqB,IACrB;EACA,OAAO;EAHE,KAAA,UAAA;EACA,KAAA,YAAA;;;;;;;CAUX,IAAI,IAA8B;EAChC,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,MAAM,eAAe,QAAQ,QAAQ,OAAO;GAC5C,IAAI,CAAC,cAAc,OAAO;GAE1B,MAAM,SAAS,KAAK,MAAM,aAAa;GAEvC,IAAI,OAAO,YAAY,OAAO,SAAS,KAAK,KAAK,EAAE;IACjD,KAAK,IAAI,GAAG;IACZ,OAAO;;GAGT,OAAO;WACA,IAAI;GACX,OAAO;;;;;;;;;;CAWX,IAAI,IAAY,MAAS,SAAwB;EAC/C,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,QAAQ,QACN,QACA,KAAK,UAAU;IACb;IACA;IACA,WAAW,KAAK,KAAK;IACrB,QAAQ,SAAS,UAAU;IAC5B,CAAC,CACH;WACM,QAAQ;;;;;;CASnB,IAAI,IAAY;EACd,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,QAAQ,WAAW,OAAO;WACnB,QAAQ;;CAKnB,QAAQ;EACN,IAAI;GACF,KAAK,QAAQ,OAAO;WACb,MAAM;;;;;;;;;AAYnB,SAAgB,iBAAoB,WAAsC;CACxE,OAAO,IAAI,aAAgB,cAAc,UAAU;;;;;;;;AASrD,SAAgB,mBAAsB,WAAsC;CAC1E,OAAO,IAAI,aAAgB,gBAAgB,UAAU"}

package/dist/cache.d.ts

@@ -1,4 +1,4 @@
-import { AbstractCache, CacheOptions, Cached } from '@cloudcome/utils-core/cache';
+import { AbstractCache, Cached, CacheOptions } from '@cloudcome/utils-core/cache';
 /**
  * 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类
  * @template T - 缓存数据的类型

package/dist/cache.mjs

@@ -1,87 +1,96 @@
 import { AbstractCache } from "@cloudcome/utils-core/cache";
-class StorageCache extends AbstractCache {
-  /**
-   * 创建一个新的 StorageCache 实例
-   * @param storage - 使用的存储实现（localStorage 或 sessionStorage）
-   * @param namespace - 可选，用于为缓存键添加前缀的命名空间
-   */
-  constructor(storage, namespace = "") {
-    super();
-    this.storage = storage;
-    this.namespace = namespace;
-  }
-  /**
-   * 通过ID获取缓存数据
-   * @param id - 要获取的缓存键
-   * @returns 如果找到且未过期则返回缓存数据，否则返回null
-   */
-  get(id) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      const cachedString = storage.getItem(fullId);
-      if (!cachedString) return null;
-      const cached = JSON.parse(cachedString);
-      if (cached.createdAt + cached.maxAge < Date.now()) {
-        this.del(id);
-        return null;
-      }
-      return cached;
-    } catch (e) {
-      return null;
-    }
-  }
-  /**
-   * 将数据存储到缓存中
-   * @param id - 存储数据使用的缓存键
-   * @param data - 要缓存的数据
-   * @param options - 可选的缓存配置
-   * @returns 成功返回true，存储失败返回false
-   */
-  set(id, data, options) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      storage.setItem(
-        fullId,
-        JSON.stringify({
-          id,
-          data,
-          createdAt: Date.now(),
-          maxAge: options?.maxAge || 0
-        })
-      );
-    } catch (cause) {
-    }
-  }
-  /**
-   * 通过ID删除缓存数据
-   * @param id - 要删除的缓存键
-   */
-  del(id) {
-    const { storage, namespace } = this;
-    const fullId = namespace ? `${namespace}:${id}` : id;
-    try {
-      storage.removeItem(fullId);
-    } catch (cause) {
-    }
-  }
-  clear() {
-    try {
-      this.storage.clear();
-    } catch (err) {
-    }
-  }
-}
+//#region src/cache.ts
+/**
+* 使用浏览器存储（localStorage 或 sessionStorage）实现的缓存类
+* @template T - 缓存数据的类型
+*/
+var StorageCache = class extends AbstractCache {
+	/**
+	* 创建一个新的 StorageCache 实例
+	* @param storage - 使用的存储实现（localStorage 或 sessionStorage）
+	* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+	*/
+	constructor(storage, namespace = "") {
+		super();
+		this.storage = storage;
+		this.namespace = namespace;
+	}
+	/**
+	* 通过ID获取缓存数据
+	* @param id - 要获取的缓存键
+	* @returns 如果找到且未过期则返回缓存数据，否则返回null
+	*/
+	get(id) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			const cachedString = storage.getItem(fullId);
+			if (!cachedString) return null;
+			const cached = JSON.parse(cachedString);
+			if (cached.createdAt + cached.maxAge < Date.now()) {
+				this.del(id);
+				return null;
+			}
+			return cached;
+		} catch (_e) {
+			return null;
+		}
+	}
+	/**
+	* 将数据存储到缓存中
+	* @param id - 存储数据使用的缓存键
+	* @param data - 要缓存的数据
+	* @param options - 可选的缓存配置
+	* @returns 成功返回true，存储失败返回false
+	*/
+	set(id, data, options) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			storage.setItem(fullId, JSON.stringify({
+				id,
+				data,
+				createdAt: Date.now(),
+				maxAge: options?.maxAge || 0
+			}));
+		} catch (_cause) {}
+	}
+	/**
+	* 通过ID删除缓存数据
+	* @param id - 要删除的缓存键
+	*/
+	del(id) {
+		const { storage, namespace } = this;
+		const fullId = namespace ? `${namespace}:${id}` : id;
+		try {
+			storage.removeItem(fullId);
+		} catch (_cause) {}
+	}
+	clear() {
+		try {
+			this.storage.clear();
+		} catch (_err) {}
+	}
+};
+/**
+* 创建一个使用 localStorage 的缓存实例
+* @template T - 缓存数据的类型
+* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+* @returns 使用 localStorage 的新 StorageCache 实例
+*/
 function createLocalCache(namespace) {
-  return new StorageCache(localStorage, namespace);
+	return new StorageCache(localStorage, namespace);
 }
+/**
+* 创建一个使用 sessionStorage 的缓存实例
+* @template T - 缓存数据的类型
+* @param namespace - 可选，用于为缓存键添加前缀的命名空间
+* @returns 使用 sessionStorage 的新 StorageCache 实例
+*/
 function createSessionCache(namespace) {
-  return new StorageCache(sessionStorage, namespace);
+	return new StorageCache(sessionStorage, namespace);
 }
-export {
-  StorageCache,
-  createLocalCache,
-  createSessionCache
-};
-//# sourceMappingURL=cache.mjs.map
+//#endregion
+export { StorageCache, createLocalCache, createSessionCache };
+
+//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -1 +1 @@
-{"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;"}
+{"version":3,"file":"cache.mjs","names":[],"sources":["../src/cache.ts"],"sourcesContent":["import {\n  AbstractCache,\n  type Cached,\n  type CacheOptions,\n} from '@cloudcome/utils-core/cache';\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"],"mappings":";;;;;;AAUA,IAAa,eAAb,cAAqC,cAAiB;;;;;;CAMpD,YACE,SACA,YAAqB,IACrB;EACA,OAAO;EAHE,KAAA,UAAA;EACA,KAAA,YAAA;;;;;;;CAUX,IAAI,IAA8B;EAChC,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,MAAM,eAAe,QAAQ,QAAQ,OAAO;GAC5C,IAAI,CAAC,cAAc,OAAO;GAE1B,MAAM,SAAS,KAAK,MAAM,aAAa;GAEvC,IAAI,OAAO,YAAY,OAAO,SAAS,KAAK,KAAK,EAAE;IACjD,KAAK,IAAI,GAAG;IACZ,OAAO;;GAGT,OAAO;WACA,IAAI;GACX,OAAO;;;;;;;;;;CAWX,IAAI,IAAY,MAAS,SAAwB;EAC/C,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,QAAQ,QACN,QACA,KAAK,UAAU;IACb;IACA;IACA,WAAW,KAAK,KAAK;IACrB,QAAQ,SAAS,UAAU;IAC5B,CAAC,CACH;WACM,QAAQ;;;;;;CASnB,IAAI,IAAY;EACd,MAAM,EAAE,SAAS,cAAc;EAC/B,MAAM,SAAS,YAAY,GAAG,UAAU,GAAG,OAAO;EAElD,IAAI;GACF,QAAQ,WAAW,OAAO;WACnB,QAAQ;;CAKnB,QAAQ;EACN,IAAI;GACF,KAAK,QAAQ,OAAO;WACb,MAAM;;;;;;;;;AAYnB,SAAgB,iBAAoB,WAAsC;CACxE,OAAO,IAAI,aAAgB,cAAc,UAAU;;;;;;;;AASrD,SAAgB,mBAAsB,WAAsC;CAC1E,OAAO,IAAI,aAAgB,gBAAgB,UAAU"}