@fast-china/utils 2.1.9 → 2.1.11

package/dist/storage/index.mjs

@@ -1,26 +1,22 @@
-import { getRuntimeUni, runtimeGlobals } from "../internal/runtime.mjs";
 import { decodeSecureBase64, encodeSecureBase64 } from "../base64/index.mjs";
 //#region src/storage/index.ts
 /**
 * 读取并校验当前运行时的全局 uni-app 同步 Storage。
 *
-* @returns 检测到 uni-app 时返回同步 Storage；普通浏览器环境返回 `undefined`。
+* @returns 检测到可用的 uni-app 同步 Storage 时返回 `true`。
 * @throws `TypeError` 当全局 `uni` 存在但缺少本库需要的同步 Storage 方法。
 */
-const getGlobalUniStorage = () => {
-	const value = getRuntimeUni();
-	if (value === void 0) return void 0;
-	if (typeof value !== "object" && typeof value !== "function" || value === null) throw new TypeError("全局 uni 对象未提供同步 Storage API。");
-	const storage = value;
-	if (typeof storage.getStorageSync !== "function" || typeof storage.getStorageInfoSync !== "function" || typeof storage.removeStorageSync !== "function" || typeof storage.setStorageSync !== "function") throw new TypeError("全局 uni 对象未提供同步 Storage API。");
-	return storage;
+const hasGlobalUniStorage = () => {
+	if (typeof uni === "undefined") return false;
+	if (uni === null || typeof uni.getStorageSync !== "function" || typeof uni.getStorageInfoSync !== "function" || typeof uni.removeStorageSync !== "function" || typeof uni.setStorageSync !== "function") throw new TypeError("The global uni object does not provide synchronous Storage APIs.");
+	return true;
 };
 /** 默认 JSON Codec；显式拒绝会被 JSON.stringify 静默丢弃的顶层值。 */
 const jsonCodec = {
 	decode: (value) => JSON.parse(value),
 	encode: (value) => {
 		const encoded = JSON.stringify(value);
-		if (typeof encoded !== "string") throw new TypeError("存储值无法序列化为 JSON。");
+		if (typeof encoded !== "string") throw new TypeError("The storage value cannot be serialized as JSON.");
 		return encoded;
 	}
 };
@@ -29,7 +25,7 @@ const base64StorageCodec = {
 	decode: (value) => JSON.parse(decodeSecureBase64(value)),
 	encode: (value) => {
 		const encoded = JSON.stringify(value);
-		if (typeof encoded !== "string") throw new TypeError("存储值无法序列化为 JSON。");
+		if (typeof encoded !== "string") throw new TypeError("The storage value cannot be serialized as JSON.");
 		return encodeSecureBase64(encoded);
 	}
 };
@@ -38,30 +34,30 @@ let activeConfiguration;
 /**
 * 判断未知值是否为非数组对象记录。
 *
-* @param value - JSON.parse 返回的未知值。
+* @param value - JSON.parse 返回的未知值
 * @returns 值为非空、非数组对象时返回 `true`。
 */
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
 * 校验 Storage 业务键。
 *
-* @param key - 不含全局 Prefix 的业务键或业务键前缀。
+* @param key - 不含全局 Prefix 的业务键或业务键前缀
 * @throws `TypeError` 当值不是非空字符串。
 */
 const assertKey = (key) => {
-	if (typeof key !== "string" || key.length === 0) throw new TypeError("Storage 键必须是非空字符串。");
+	if (typeof key !== "string" || key.length === 0) throw new TypeError("Storage keys must be nonempty strings.");
 };
 /**
 * 创建浏览器 Storage 后端。
 *
 * @remarks 平台对象在调用阶段读取，因此导入模块不会访问浏览器全局对象。
 * @param kind - 选择 `localStorage` 或 `sessionStorage`。
-* @returns 统一的内部同步后端。
+* @returns 统一的内部同步后端
 * @throws `Error` 当所选 Storage 在当前环境不可用。
 */
 const createWebStorageBackend = (kind) => {
-	const storage = kind === "local" ? runtimeGlobals.localStorage : runtimeGlobals.sessionStorage;
-	if (storage === void 0) throw new Error(`当前运行环境不支持 ${kind}Storage。`);
+	const storage = kind === "local" ? typeof localStorage === "undefined" ? void 0 : localStorage : typeof sessionStorage === "undefined" ? void 0 : sessionStorage;
+	if (storage === void 0) throw new Error(`The current runtime does not support ${kind}Storage.`);
 	return {
 		getItem: (key) => storage.getItem(key),
 		keys: () => {
@@ -84,91 +80,90 @@ const createWebStorageBackend = (kind) => {
 * 把 uni-app 同步 Storage 适配为内部后端。
 *
 * @remarks uni-app 以空字符串同时表示“键缺失”和“真实空值”，因此空字符串需要结合键清单消除歧义。
-* @param storage - 已从全局 `uni` 读取并校验的同步 API。
-* @returns 统一的内部同步后端。
+* @returns 统一的内部同步后端
 */
-const createUniStorageBackend = (storage) => ({
+const createUniStorageBackend = () => ({
 	getItem: (key) => {
-		const value = storage.getStorageSync(key);
+		const value = uni.getStorageSync(key);
 		if (value !== "") return value;
-		return storage.getStorageInfoSync().keys.includes(key) ? value : void 0;
+		return uni.getStorageInfoSync().keys.includes(key) ? value : void 0;
 	},
-	keys: () => [...storage.getStorageInfoSync().keys],
+	keys: () => [...uni.getStorageInfoSync().keys],
 	removeItem: (key) => {
-		storage.removeStorageSync(key);
+		uni.removeStorageSync(key);
 	},
 	setItem: (key, value) => {
-		storage.setStorageSync(key, value);
+		uni.setStorageSync(key, value);
 	}
 });
 /**
 * 解析并校验版本化 Storage 包络。
 *
-* @param rawValue - 后端返回的原始值。
-* @param key - 用于错误定位的完整物理键。
-* @returns 当前 v3 包络。
+* @param rawValue - 后端返回的原始值
+* @param key - 用于错误定位的完整物理键
+* @returns 当前 v3 包络
 * @throws `TypeError` 当原始值不是字符串、JSON 损坏、版本不支持或字段类型非法。
 */
 const parseStoredEnvelope = (rawValue, key) => {
-	if (typeof rawValue !== "string") throw new TypeError(`Storage 条目“${key}”不是字符串。`);
+	if (typeof rawValue !== "string") throw new TypeError(`Storage entry "${key}" is not a string.`);
 	try {
 		const parsed = JSON.parse(rawValue);
-		if (!isRecord(parsed) || parsed["version"] !== 3 || typeof parsed["data"] !== "string" || !(parsed["expiresAt"] === null || typeof parsed["expiresAt"] === "number" && Number.isFinite(parsed["expiresAt"]))) throw new TypeError("不支持该存储包络。");
+		if (!isRecord(parsed) || parsed["version"] !== 3 || typeof parsed["data"] !== "string" || !(parsed["expiresAt"] === null || typeof parsed["expiresAt"] === "number" && Number.isFinite(parsed["expiresAt"]))) throw new TypeError("Unsupported storage envelope.");
 		return {
 			data: parsed["data"],
 			expiresAt: parsed["expiresAt"],
 			version: 3
 		};
 	} catch (cause) {
-		throw new TypeError(`Storage 条目“${key}”已损坏或不受支持。`, { cause });
+		throw new TypeError(`Storage entry "${key}" is corrupted or unsupported.`, { cause });
 	}
 };
 /**
 * 创建绑定命名空间、Codec 与时钟的 Storage Area。
 *
 * @param backendFactory - 每次操作时解析平台后端的工厂，保证导入安全并反映平台可用性。
-* @param prefix - 已校验的全局物理键前缀。
-* @param codec - 业务值与包络文本之间的 Codec。
-* @param now - TTL 计算使用的可注入时钟。
-* @returns 完整的命名空间 Storage 操作集合。
+* @param prefix - 已校验的全局物理键前缀
+* @param codec - 业务值与包络文本之间的 Codec
+* @param now - TTL 计算使用的可注入时钟
+* @returns 完整的命名空间 Storage 操作集合
 */
 const createStorageArea = (backendFactory, prefix, codec, now) => {
 	/**
 	* 拼接物理键。
 	*
-	* @param key - 已校验业务键。
-	* @returns 带当前命名空间前缀的物理键。
+	* @param key - 已校验业务键
+	* @returns 带当前命名空间前缀的物理键
 	*/
 	const toStorageKey = (key) => `${prefix}${key}`;
 	/**
 	* 解析本次读写实际使用的 Codec。
 	*
 	* @param crypto - 单次 Base64 混淆开关；省略时沿用 Area 全局 Codec。
-	* @returns 本次操作使用的全局、JSON 或 Base64 Codec。
+	* @returns 本次操作使用的全局、JSON 或 Base64 Codec
 	* @throws `TypeError` 当 JavaScript 调用方传入非布尔值。
 	*/
 	const resolveOperationCodec = (crypto) => {
 		if (crypto === void 0) return codec;
-		if (typeof crypto !== "boolean") throw new TypeError("Storage 单次 `crypto` 选项必须是布尔值。");
+		if (typeof crypto !== "boolean") throw new TypeError("The per-operation Storage `crypto` option must be a boolean.");
 		return crypto ? base64StorageCodec : jsonCodec;
 	};
 	/**
 	* 枚举当前命名空间中的业务键。
 	*
-	* @param backend - 本次操作使用的后端。
-	* @returns 已移除物理前缀、去重并排序的业务键。
+	* @param backend - 本次操作使用的后端
+	* @returns 已移除物理前缀、去重并排序的业务键
 	* @throws `TypeError` 当后端返回非字符串键。
 	*/
 	const listBusinessKeys = (backend) => {
 		const keys = backend.keys();
-		if (!Array.isArray(keys) || !keys.every((key) => typeof key === "string")) throw new TypeError("Storage 后端返回的键必须是字符串。");
+		if (!Array.isArray(keys) || !keys.every((key) => typeof key === "string")) throw new TypeError("Keys returned by the Storage backend must be strings.");
 		return [...new Set(keys.filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length)))].sort();
 	};
 	/**
 	* 读取并处理单个包络。
 	*
-	* @param backend - 本次操作使用的后端。
-	* @param key - 业务键。
+	* @param backend - 本次操作使用的后端
+	* @param key - 业务键
 	* @returns 未过期包络；键缺失或已经过期时返回 `undefined`。
 	* @throws `TypeError` 当键或包络非法。
 	* @throws `RangeError` 当注入时钟返回非有限时间戳。
@@ -181,7 +176,7 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 		const envelope = parseStoredEnvelope(rawValue, storageKey);
 		if (envelope.expiresAt === null) return envelope;
 		const timestamp = now();
-		if (!Number.isFinite(timestamp)) throw new RangeError("Storage 时钟必须返回有限时间戳。");
+		if (!Number.isFinite(timestamp)) throw new RangeError("The Storage clock must return a finite timestamp.");
 		if (timestamp < envelope.expiresAt) return envelope;
 		backend.removeItem(storageKey);
 	};
@@ -197,7 +192,7 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 			try {
 				return resolveOperationCodec(options.crypto).decode(envelope.data);
 			} catch (cause) {
-				throw new TypeError(`无法解码 Storage 条目“${toStorageKey(key)}”。`, { cause });
+				throw new TypeError(`Unable to decode Storage entry "${toStorageKey(key)}".`, { cause });
 			}
 		},
 		has: (key) => readStoredEnvelope(backendFactory(), key) !== void 0,
@@ -222,20 +217,20 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 		},
 		set(key, value, options = {}) {
 			assertKey(key);
-			if (value === void 0) throw new TypeError("不能存储顶层 `undefined`，请改为移除对应的键。");
+			if (value === void 0) throw new TypeError("Cannot store top-level `undefined`; remove the key instead.");
 			let expiresAt = null;
 			if (options.ttlMs !== void 0) {
-				if (!Number.isFinite(options.ttlMs) || options.ttlMs <= 0) throw new RangeError("`ttlMs` 必须是大于 0 的有限数。");
+				if (!Number.isFinite(options.ttlMs) || options.ttlMs <= 0) throw new RangeError("`ttlMs` must be a finite number greater than 0.");
 				const timestamp = now();
-				if (!Number.isFinite(timestamp) || !Number.isFinite(timestamp + options.ttlMs)) throw new RangeError("Storage 过期时间超出支持的时间戳范围。");
+				if (!Number.isFinite(timestamp) || !Number.isFinite(timestamp + options.ttlMs)) throw new RangeError("The Storage expiration time exceeds the supported timestamp range.");
 				expiresAt = timestamp + options.ttlMs;
 			}
 			let data;
 			try {
 				data = resolveOperationCodec(options.crypto).encode(value);
-				if (typeof data !== "string") throw new TypeError("Storage Codec 必须返回字符串。");
+				if (typeof data !== "string") throw new TypeError("The Storage codec must return a string.");
 			} catch (cause) {
-				throw new TypeError("无法编码存储值。", { cause });
+				throw new TypeError("Unable to encode the storage value.", { cause });
 			}
 			backendFactory().setItem(toStorageKey(key), JSON.stringify({
 				data,
@@ -248,30 +243,30 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 /**
 * 获取已激活的全局 Storage 配置。
 *
-* @returns 显式配置或首次 Storage 操作创建的默认配置。
+* @returns 显式配置或首次 Storage 操作创建的默认配置
 */
 const requireStorageConfiguration = () => {
 	if (activeConfiguration === void 0) configureStorage();
-	if (activeConfiguration === void 0) throw new Error("无法初始化 Storage 配置。");
+	if (activeConfiguration === void 0) throw new Error("Unable to initialize the Storage configuration.");
 	return activeConfiguration;
 };
 /**
 * 创建稳定的公开 Storage 门面。
 *
-* @param select - 从激活配置选择 Local 或 Session 的函数。
-* @param name - 用于不可用错误的公开门面名称。
+* @param select - 从激活配置选择 Local 或 Session 的函数
+* @param name - 用于不可用错误的公开门面名称
 * @returns 可安全导入、并在首次调用时解析默认或显式配置的稳定对象。
 */
 const createStorageAreaProxy = (select, name) => {
 	/**
 	* 解析当前实际 Area。
 	*
-	* @returns 配置中的 Local 或 Session Area。
+	* @returns 配置中的 Local 或 Session Area
 	* @throws `Error` 当 uni-app 模式请求 Session。
 	*/
 	const getArea = () => {
 		const area = select(requireStorageConfiguration());
-		if (area === void 0) throw new Error(`uni-app 中不支持 ${name}。`);
+		if (area === void 0) throw new Error(`${name} is not supported in uni-app.`);
 		return area;
 	};
 	return {
@@ -311,22 +306,22 @@ const Session = createStorageAreaProxy((configuration) => configuration.session,
 */
 function configureStorage(options = {}) {
 	const prefix = options.prefix ?? "fast__";
-	if (typeof prefix !== "string" || prefix.length === 0) throw new TypeError("Storage 前缀必须是非空字符串。");
-	if (options.codec !== void 0 && options.crypto === true) throw new TypeError("Storage 的 Codec 和加密选项不能同时使用。");
+	if (typeof prefix !== "string" || prefix.length === 0) throw new TypeError("The Storage prefix must be a nonempty string.");
+	if (options.codec !== void 0 && options.crypto === true) throw new TypeError("Storage codec and crypto options cannot be used together.");
 	const codec = options.codec ?? (options.crypto === true ? base64StorageCodec : jsonCodec);
 	const now = options.now ?? Date.now;
 	if (activeConfiguration !== void 0) {
 		if (activeConfiguration.prefix === prefix && activeConfiguration.codec === codec && activeConfiguration.now === now) return;
-		throw new Error("Storage 已使用其他选项完成配置。");
+		throw new Error("Storage is already configured with different options.");
 	}
-	const uni = getGlobalUniStorage();
+	const usesUniStorage = hasGlobalUniStorage();
 	const configuration = {
 		codec,
-		local: createStorageArea(uni === void 0 ? () => createWebStorageBackend("local") : () => createUniStorageBackend(uni), prefix, codec, now),
+		local: createStorageArea(usesUniStorage ? () => createUniStorageBackend() : () => createWebStorageBackend("local"), prefix, codec, now),
 		now,
 		prefix
 	};
-	if (uni === void 0) configuration.session = createStorageArea(() => createWebStorageBackend("session"), prefix, codec, now);
+	if (!usesUniStorage) configuration.session = createStorageArea(() => createWebStorageBackend("session"), prefix, codec, now);
 	activeConfiguration = configuration;
 }
 /** 返回 Storage 是否已经显式配置，或由首次 Storage 操作激活默认配置。 */

package/dist/storage/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/storage/index.ts"],"sourcesContent":["import { decodeSecureBase64, encodeSecureBase64 } from \"../base64/index\";\nimport { getRuntimeUni, runtimeGlobals } from \"../internal/runtime\";\n\n/** uni-app 同步存储信息中本库实际读取的字段。 */\ninterface UniStorageInfo {\n\t/** 当前平台可见的物理键快照。 */\n\tkeys: readonly string[];\n}\n\n/** 全局 `uni` 必须提供的同步存储 API 最小结构。 */\ninterface UniStorageLike {\n\t/**\n\t * 同步读取一个物理键的原始值。\n\t * @param key - 已包含全局命名空间前缀的物理键。\n\t * @returns 平台保存的值；键缺失时应返回 `undefined`、`null` 或空字符串。\n\t */\n\tgetStorageSync: (key: string) => unknown;\n\t/**\n\t * 同步读取平台当前可见的全部物理键。\n\t * @returns 至少包含只读 `keys` 数组的快照对象。\n\t */\n\tgetStorageInfoSync: () => UniStorageInfo;\n\t/**\n\t * 同步删除一个物理键；键不存在时应保持幂等。\n\t * @param key - 已包含全局命名空间前缀的物理键。\n\t */\n\tremoveStorageSync: (key: string) => void;\n\t/**\n\t * 同步写入已经序列化的包络文本。\n\t * @param key - 已包含全局命名空间前缀的物理键。\n\t * @param value - JSON 包络字符串，不是未经编码的业务值。\n\t */\n\tsetStorageSync: (key: string, value: string) => void;\n}\n\n/** Storage 业务值编码器。 */\nexport interface StorageCodec {\n\t/**\n\t * 把已编码文本恢复为业务值。\n\t * @param value - 由同一 Codec 的 `encode` 生成并持久化的文本。\n\t * @returns 解码后的业务值。\n\t * @throws 当文本损坏、格式不受支持或无法反序列化时应抛出错误。\n\t */\n\tdecode: (value: string) => unknown;\n\t/**\n\t * 把业务值编码为可持久化字符串。\n\t * @param value - 调用方传入的业务值。\n\t * @returns 可由同一 Codec 的 `decode` 无损恢复的文本。\n\t * @throws 当值不受支持或无法序列化时应抛出错误。\n\t */\n\tencode: (value: unknown) => string;\n}\n\n/** 程序入口调用 {@link configureStorage} 时使用的全局配置。 */\nexport interface StorageConfiguration {\n\t/** 自定义值编码器；默认使用严格 JSON Codec，同一应用生命周期内必须保持同一引用。 */\n\tcodec?: StorageCodec;\n\t/** 启用 Base64 可逆混淆；不提供加密、完整性或认证，不能与 `codec` 同时使用。 */\n\tcrypto?: boolean;\n\t/** 返回 Unix 毫秒时间戳的时钟；默认使用 `Date.now`，主要用于 TTL 测试与受控时间源。 */\n\tnow?: () => number;\n\t/** 所有物理键使用的非空命名空间前缀，默认 `fast__`。 */\n\tprefix?: string;\n}\n\n/** 单次 Storage 读取配置。 */\nexport interface StorageReadOptions {\n\t/**\n\t * 仅覆盖本次读取使用的 Codec；`true` 使用 Base64 混淆，`false` 使用 JSON，省略时使用全局配置。\n\t * 必须与写入该条目时使用的单次设置一致。\n\t */\n\tcrypto?: boolean;\n}\n\n/** 单次 Storage 写入配置。 */\nexport interface StorageWriteOptions extends StorageReadOptions {\n\t/** 从写入时刻开始的有效毫秒数；必须是大于 0 的有限数，省略时永久有效。 */\n\tttlMs?: number;\n}\n\n/** `Local` 与 `Session` 的统一操作接口。 */\nexport interface StorageArea {\n\t/** 当前全局 Storage 配置的物理键前缀；首次读取会激活默认配置。 */\n\treadonly prefix: string;\n\t/**\n\t * 删除当前命名空间内的全部键，不影响同一后端中的其他应用键。\n\t * @throws `Error` 当当前平台后端不可用。\n\t */\n\tclear: () => void;\n\t/**\n\t * 获取并解码业务值；已过期记录会在读取时删除。\n\t * @param key - 不含全局前缀的非空业务键。\n\t * @param options - 可选的单次 Base64 混淆开关；必须与写入时一致。\n\t * @returns 解码后的值；未传泛型时静态类型默认为 `string`，键缺失或过期时返回 `undefined`。\n\t * @throws 当键非法、包络损坏、Codec 解码失败或后端不可用时抛出错误。\n\t */\n\tget: <Value = string>(key: string, options?: StorageReadOptions) => Value | undefined;\n\t/**\n\t * 判断业务键是否具有有效且未过期的包络；不解码业务值。\n\t * @param key - 不含全局前缀的非空业务键。\n\t * @returns 键存在且包络有效时返回 `true`。\n\t */\n\thas: (key: string) => boolean;\n\t/**\n\t * 返回当前命名空间内的业务键快照。\n\t * @returns 已移除全局前缀并按字典序排列的新数组；不会自动清理过期项。\n\t */\n\tkeys: () => string[];\n\t/**\n\t * 扫描当前命名空间并删除全部过期记录。\n\t * @returns 本次实际删除的记录数量。\n\t * @throws 当发现损坏包络或后端不可用时抛出错误。\n\t */\n\tpruneExpired: () => number;\n\t/**\n\t * 删除单个业务键；键不存在时保持幂等。\n\t * @param key - 不含全局前缀的非空业务键。\n\t */\n\tremove: (key: string) => void;\n\t/**\n\t * 删除业务键以指定文本开头的全部条目，范围仍受全局命名空间限制。\n\t * @param keyPrefix - 不含全局前缀的非空业务键前缀。\n\t */\n\tremoveByPrefix: (keyPrefix: string) => void;\n\t/**\n\t * 编码并写入业务值，可附加惰性清理的 TTL。\n\t * @param key - 不含全局前缀的非空业务键。\n\t * @param value - 必须受当前 Codec 支持的业务值。\n\t * @param options - 可选的单次写入 TTL 与 Base64 混淆开关。\n\t * @throws 当键、TTL、业务值或后端写入无效时抛出错误。\n\t */\n\tset: <Value>(key: string, value: Value, options?: StorageWriteOptions) => void;\n}\n\n/** 浏览器 Storage 与 uni-app Storage 适配后的最小内部协议。 */\ninterface StorageBackend {\n\t/** 读取物理键原始值；缺失约定由上层统一规范为 `undefined`。 */\n\tgetItem: (key: string) => unknown;\n\t/** 枚举后端可见的全部物理键；返回值必须是不会随枚举过程变化的快照。 */\n\tkeys: () => readonly string[];\n\t/** 删除单个物理键；实现必须允许重复删除。 */\n\tremoveItem: (key: string) => void;\n\t/** 写入已经序列化的包络文本；配额和平台错误保持原样传播。 */\n\tsetItem: (key: string, value: string) => void;\n}\n\n/** 物理存储中的版本化包络；业务值始终先经 Codec 转为文本。 */\ninterface StoredEnvelope {\n\t/** Codec 编码后的业务文本；只有在包络结构校验通过后才能交给 Codec。 */\n\tdata: string;\n\t/** Unix 毫秒绝对过期时间戳；`null` 表示永久有效。 */\n\texpiresAt: number | null;\n\t/** 当前持久化协议版本；读取其他版本必须明确失败，不能猜测迁移。 */\n\tversion: 3;\n}\n\n/** 首次配置后冻结使用的解析结果和两个稳定门面。 */\ninterface ActiveStorageConfiguration {\n\t/** 首次配置后锁定的业务值 Codec 引用。 */\n\tcodec: StorageCodec;\n\t/** 已绑定 Local 后端、命名空间、Codec 与时钟的实际 Area。 */\n\tlocal: StorageArea;\n\t/** 首次配置后锁定的 TTL 时钟引用。 */\n\tnow: () => number;\n\t/** 所有 Area 共享的物理键命名空间前缀。 */\n\tprefix: string;\n\t/** 仅浏览器模式存在的 Session Area；uni-app 模式必须保持缺失。 */\n\tsession?: StorageArea;\n}\n\n/**\n * 读取并校验当前运行时的全局 uni-app 同步 Storage。\n *\n * @returns 检测到 uni-app 时返回同步 Storage；普通浏览器环境返回 `undefined`。\n * @throws `TypeError` 当全局 `uni` 存在但缺少本库需要的同步 Storage 方法。\n */\nconst getGlobalUniStorage = (): UniStorageLike | undefined => {\n\tconst value = getRuntimeUni();\n\tif (value === undefined) return undefined;\n\tif ((typeof value !== \"object\" && typeof value !== \"function\") || value === null) {\n\t\tthrow new TypeError(\"全局 uni 对象未提供同步 Storage API。\");\n\t}\n\tconst storage = value as Partial<UniStorageLike>;\n\tif (\n\t\ttypeof storage.getStorageSync !== \"function\" ||\n\t\ttypeof storage.getStorageInfoSync !== \"function\" ||\n\t\ttypeof storage.removeStorageSync !== \"function\" ||\n\t\ttypeof storage.setStorageSync !== \"function\"\n\t) {\n\t\tthrow new TypeError(\"全局 uni 对象未提供同步 Storage API。\");\n\t}\n\treturn storage as UniStorageLike;\n};\n\n/** 默认 JSON Codec；显式拒绝会被 JSON.stringify 静默丢弃的顶层值。 */\nconst jsonCodec: StorageCodec = {\n\tdecode: (value) => JSON.parse(value) as unknown,\n\tencode: (value) => {\n\t\tconst encoded = JSON.stringify(value);\n\t\tif (typeof encoded !== \"string\") throw new TypeError(\"存储值无法序列化为 JSON。\");\n\t\treturn encoded;\n\t},\n};\n\n/** Base64 混淆 Codec；只隐藏明文外观，不提供加密、完整性或认证。 */\nexport const base64StorageCodec: StorageCodec = {\n\tdecode: (value) => JSON.parse(decodeSecureBase64(value)) as unknown,\n\tencode: (value) => {\n\t\tconst encoded = JSON.stringify(value);\n\t\tif (typeof encoded !== \"string\") throw new TypeError(\"存储值无法序列化为 JSON。\");\n\t\treturn encodeSecureBase64(encoded);\n\t},\n};\n\n/** 页面级唯一配置；只允许幂等重复配置，避免模块加载顺序改变行为。 */\nlet activeConfiguration: ActiveStorageConfiguration | undefined;\n\n/**\n * 判断未知值是否为非数组对象记录。\n *\n * @param value - JSON.parse 返回的未知值。\n * @returns 值为非空、非数组对象时返回 `true`。\n */\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === \"object\" && value !== null && !Array.isArray(value);\n\n/**\n * 校验 Storage 业务键。\n *\n * @param key - 不含全局 Prefix 的业务键或业务键前缀。\n * @throws `TypeError` 当值不是非空字符串。\n */\nconst assertKey = (key: string): void => {\n\tif (typeof key !== \"string\" || key.length === 0) throw new TypeError(\"Storage 键必须是非空字符串。\");\n};\n\n/**\n * 创建浏览器 Storage 后端。\n *\n * @remarks 平台对象在调用阶段读取，因此导入模块不会访问浏览器全局对象。\n * @param kind - 选择 `localStorage` 或 `sessionStorage`。\n * @returns 统一的内部同步后端。\n * @throws `Error` 当所选 Storage 在当前环境不可用。\n */\nconst createWebStorageBackend = (kind: \"local\" | \"session\"): StorageBackend => {\n\tconst storage = kind === \"local\" ? runtimeGlobals.localStorage : runtimeGlobals.sessionStorage;\n\tif (storage === undefined) throw new Error(`当前运行环境不支持 ${kind}Storage。`);\n\treturn {\n\t\tgetItem: (key) => storage.getItem(key),\n\t\tkeys: () => {\n\t\t\tconst keys: string[] = [];\n\t\t\tfor (let index = 0; index < storage.length; index += 1) {\n\t\t\t\tconst key = storage.key(index);\n\t\t\t\tif (key !== null) keys.push(key);\n\t\t\t}\n\t\t\treturn keys;\n\t\t},\n\t\tremoveItem: (key) => {\n\t\t\tstorage.removeItem(key);\n\t\t},\n\t\tsetItem: (key, value) => {\n\t\t\tstorage.setItem(key, value);\n\t\t},\n\t};\n};\n\n/**\n * 把 uni-app 同步 Storage 适配为内部后端。\n *\n * @remarks uni-app 以空字符串同时表示“键缺失”和“真实空值”，因此空字符串需要结合键清单消除歧义。\n * @param storage - 已从全局 `uni` 读取并校验的同步 API。\n * @returns 统一的内部同步后端。\n */\nconst createUniStorageBackend = (storage: UniStorageLike): StorageBackend => ({\n\tgetItem: (key) => {\n\t\tconst value = storage.getStorageSync(key);\n\t\tif (value !== \"\") return value;\n\t\treturn storage.getStorageInfoSync().keys.includes(key) ? value : undefined;\n\t},\n\tkeys: () => [...storage.getStorageInfoSync().keys],\n\tremoveItem: (key) => {\n\t\tstorage.removeStorageSync(key);\n\t},\n\tsetItem: (key, value) => {\n\t\tstorage.setStorageSync(key, value);\n\t},\n});\n\n/**\n * 解析并校验版本化 Storage 包络。\n *\n * @param rawValue - 后端返回的原始值。\n * @param key - 用于错误定位的完整物理键。\n * @returns 当前 v3 包络。\n * @throws `TypeError` 当原始值不是字符串、JSON 损坏、版本不支持或字段类型非法。\n */\nconst parseStoredEnvelope = (rawValue: unknown, key: string): StoredEnvelope => {\n\tif (typeof rawValue !== \"string\") throw new TypeError(`Storage 条目“${key}”不是字符串。`);\n\ttry {\n\t\tconst parsed = JSON.parse(rawValue) as unknown;\n\t\tif (\n\t\t\t!isRecord(parsed) ||\n\t\t\tparsed[\"version\"] !== 3 ||\n\t\t\ttypeof parsed[\"data\"] !== \"string\" ||\n\t\t\t!(parsed[\"expiresAt\"] === null || (typeof parsed[\"expiresAt\"] === \"number\" && Number.isFinite(parsed[\"expiresAt\"])))\n\t\t) {\n\t\t\tthrow new TypeError(\"不支持该存储包络。\");\n\t\t}\n\t\treturn { data: parsed[\"data\"], expiresAt: parsed[\"expiresAt\"], version: 3 };\n\t} catch (cause) {\n\t\tthrow new TypeError(`Storage 条目“${key}”已损坏或不受支持。`, { cause });\n\t}\n};\n\n/**\n * 创建绑定命名空间、Codec 与时钟的 Storage Area。\n *\n * @param backendFactory - 每次操作时解析平台后端的工厂，保证导入安全并反映平台可用性。\n * @param prefix - 已校验的全局物理键前缀。\n * @param codec - 业务值与包络文本之间的 Codec。\n * @param now - TTL 计算使用的可注入时钟。\n * @returns 完整的命名空间 Storage 操作集合。\n */\nconst createStorageArea = (backendFactory: () => StorageBackend, prefix: string, codec: StorageCodec, now: () => number): StorageArea => {\n\t/**\n\t * 拼接物理键。\n\t *\n\t * @param key - 已校验业务键。\n\t * @returns 带当前命名空间前缀的物理键。\n\t */\n\tconst toStorageKey = (key: string) => `${prefix}${key}`;\n\t/**\n\t * 解析本次读写实际使用的 Codec。\n\t *\n\t * @param crypto - 单次 Base64 混淆开关；省略时沿用 Area 全局 Codec。\n\t * @returns 本次操作使用的全局、JSON 或 Base64 Codec。\n\t * @throws `TypeError` 当 JavaScript 调用方传入非布尔值。\n\t */\n\tconst resolveOperationCodec = (crypto: boolean | undefined) => {\n\t\tif (crypto === undefined) return codec;\n\t\tif (typeof crypto !== \"boolean\") throw new TypeError(\"Storage 单次 `crypto` 选项必须是布尔值。\");\n\t\treturn crypto ? base64StorageCodec : jsonCodec;\n\t};\n\t/**\n\t * 枚举当前命名空间中的业务键。\n\t *\n\t * @param backend - 本次操作使用的后端。\n\t * @returns 已移除物理前缀、去重并排序的业务键。\n\t * @throws `TypeError` 当后端返回非字符串键。\n\t */\n\tconst listBusinessKeys = (backend: StorageBackend) => {\n\t\tconst keys = backend.keys();\n\t\tif (!Array.isArray(keys) || !keys.every((key) => typeof key === \"string\")) {\n\t\t\tthrow new TypeError(\"Storage 后端返回的键必须是字符串。\");\n\t\t}\n\t\treturn [...new Set(keys.filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length)))].sort();\n\t};\n\t/**\n\t * 读取并处理单个包络。\n\t *\n\t * @param backend - 本次操作使用的后端。\n\t * @param key - 业务键。\n\t * @returns 未过期包络；键缺失或已经过期时返回 `undefined`。\n\t * @throws `TypeError` 当键或包络非法。\n\t * @throws `RangeError` 当注入时钟返回非有限时间戳。\n\t */\n\tconst readStoredEnvelope = (backend: StorageBackend, key: string): StoredEnvelope | undefined => {\n\t\tassertKey(key);\n\t\tconst storageKey = toStorageKey(key);\n\t\tconst rawValue = backend.getItem(storageKey);\n\t\tif (rawValue === null || rawValue === undefined) return undefined;\n\t\tconst envelope = parseStoredEnvelope(rawValue, storageKey);\n\t\tif (envelope.expiresAt === null) return envelope;\n\t\tconst timestamp = now();\n\t\tif (!Number.isFinite(timestamp)) throw new RangeError(\"Storage 时钟必须返回有限时间戳。\");\n\t\tif (timestamp < envelope.expiresAt) return envelope;\n\t\t// 过期项在读取时立即删除，后续 has/keys/pruneExpired 观察到一致状态。\n\t\tbackend.removeItem(storageKey);\n\t\treturn undefined;\n\t};\n\n\treturn {\n\t\tprefix,\n\t\tclear() {\n\t\t\tconst backend = backendFactory();\n\t\t\tfor (const key of listBusinessKeys(backend)) backend.removeItem(toStorageKey(key));\n\t\t},\n\t\tget<Value>(key: string, options: StorageReadOptions = {}): Value | undefined {\n\t\t\tconst envelope = readStoredEnvelope(backendFactory(), key);\n\t\t\tif (envelope === undefined) return undefined;\n\t\t\ttry {\n\t\t\t\treturn resolveOperationCodec(options.crypto).decode(envelope.data) as Value;\n\t\t\t} catch (cause) {\n\t\t\t\tthrow new TypeError(`无法解码 Storage 条目“${toStorageKey(key)}”。`, { cause });\n\t\t\t}\n\t\t},\n\t\thas: (key) => readStoredEnvelope(backendFactory(), key) !== undefined,\n\t\tkeys: () => listBusinessKeys(backendFactory()),\n\t\tpruneExpired() {\n\t\t\tconst backend = backendFactory();\n\t\t\tlet removed = 0;\n\t\t\tfor (const key of listBusinessKeys(backend)) {\n\t\t\t\t// read 同时处理删除；先读取一次用于区分“原本缺失”和“本轮因过期删除”。\n\t\t\t\tconst before = backend.getItem(toStorageKey(key));\n\t\t\t\tif (before !== null && before !== undefined && readStoredEnvelope(backend, key) === undefined) removed += 1;\n\t\t\t}\n\t\t\treturn removed;\n\t\t},\n\t\tremove(key: string) {\n\t\t\tassertKey(key);\n\t\t\tbackendFactory().removeItem(toStorageKey(key));\n\t\t},\n\t\tremoveByPrefix(keyPrefix: string) {\n\t\t\tassertKey(keyPrefix);\n\t\t\tconst backend = backendFactory();\n\t\t\tfor (const key of listBusinessKeys(backend)) if (key.startsWith(keyPrefix)) backend.removeItem(toStorageKey(key));\n\t\t},\n\t\tset<Value>(key: string, value: Value, options: StorageWriteOptions = {}) {\n\t\t\tassertKey(key);\n\t\t\tif (value === undefined) throw new TypeError(\"不能存储顶层 `undefined`，请改为移除对应的键。\");\n\t\t\tlet expiresAt: number | null = null;\n\t\t\tif (options.ttlMs !== undefined) {\n\t\t\t\tif (!Number.isFinite(options.ttlMs) || options.ttlMs <= 0) throw new RangeError(\"`ttlMs` 必须是大于 0 的有限数。\");\n\t\t\t\tconst timestamp = now();\n\t\t\t\tif (!Number.isFinite(timestamp) || !Number.isFinite(timestamp + options.ttlMs)) {\n\t\t\t\t\tthrow new RangeError(\"Storage 过期时间超出支持的时间戳范围。\");\n\t\t\t\t}\n\t\t\t\texpiresAt = timestamp + options.ttlMs;\n\t\t\t}\n\t\t\tlet data: string;\n\t\t\ttry {\n\t\t\t\tdata = resolveOperationCodec(options.crypto).encode(value);\n\t\t\t\tif (typeof data !== \"string\") throw new TypeError(\"Storage Codec 必须返回字符串。\");\n\t\t\t} catch (cause) {\n\t\t\t\tthrow new TypeError(\"无法编码存储值。\", { cause });\n\t\t\t}\n\t\t\tbackendFactory().setItem(toStorageKey(key), JSON.stringify({ data, expiresAt, version: 3 } satisfies StoredEnvelope));\n\t\t},\n\t};\n};\n\n/**\n * 获取已激活的全局 Storage 配置。\n *\n * @returns 显式配置或首次 Storage 操作创建的默认配置。\n */\nconst requireStorageConfiguration = (): ActiveStorageConfiguration => {\n\tif (activeConfiguration === undefined) configureStorage();\n\tif (activeConfiguration === undefined) throw new Error(\"无法初始化 Storage 配置。\");\n\treturn activeConfiguration;\n};\n\n/**\n * 创建稳定的公开 Storage 门面。\n *\n * @param select - 从激活配置选择 Local 或 Session 的函数。\n * @param name - 用于不可用错误的公开门面名称。\n * @returns 可安全导入、并在首次调用时解析默认或显式配置的稳定对象。\n */\nconst createStorageAreaProxy = (select: (configuration: ActiveStorageConfiguration) => StorageArea | undefined, name: string): StorageArea => {\n\t/**\n\t * 解析当前实际 Area。\n\t *\n\t * @returns 配置中的 Local 或 Session Area。\n\t * @throws `Error` 当 uni-app 模式请求 Session。\n\t */\n\tconst getArea = () => {\n\t\tconst area = select(requireStorageConfiguration());\n\t\tif (area === undefined) throw new Error(`uni-app 中不支持 ${name}。`);\n\t\treturn area;\n\t};\n\treturn {\n\t\tget prefix() {\n\t\t\treturn getArea().prefix;\n\t\t},\n\t\tclear: () => {\n\t\t\tgetArea().clear();\n\t\t},\n\t\tget: <Value>(key: string, options?: StorageReadOptions): Value | undefined => getArea().get<Value>(key, options),\n\t\thas: (key) => getArea().has(key),\n\t\tkeys: () => getArea().keys(),\n\t\tpruneExpired: () => getArea().pruneExpired(),\n\t\tremove: (key) => {\n\t\t\tgetArea().remove(key);\n\t\t},\n\t\tremoveByPrefix: (keyPrefix) => {\n\t\t\tgetArea().removeByPrefix(keyPrefix);\n\t\t},\n\t\tset: <Value>(key: string, value: Value, options?: StorageWriteOptions) => {\n\t\t\tgetArea().set(key, value, options);\n\t\t},\n\t};\n};\n\n/** 浏览器 localStorage 或自动检测的 uni-app Storage 全局业务入口。 */\nexport const Local: StorageArea = createStorageAreaProxy((configuration) => configuration.local, \"Local\");\n\n/** 浏览器 sessionStorage 的全局业务入口；uni-app 不提供会话存储。 */\nexport const Session: StorageArea = createStorageAreaProxy((configuration) => configuration.session, \"Session\");\n\n/**\n * 在首次 Storage 操作前可选配置 `Local` 与 `Session`。\n *\n * @remarks 不调用时在首次操作上使用 `fast__`、JSON Codec 与 `Date.now`。首次激活后只允许以完全相同的值和引用重复调用。若检测到\n * 全局 `uni`，则自动使用其同步 Storage 且只启用 `Local`，否则使用浏览器 `localStorage` 与 `sessionStorage`。\n * `crypto: true` 仅执行可逆 Base64 混淆，不能保护敏感数据。\n * @param options - 可选的全局键前缀、Codec、Base64 混淆选项与时钟。\n * @throws 配置非法、重复配置冲突或目标平台 Storage 不可用时抛出错误。\n */\nexport function configureStorage(options: StorageConfiguration = {}): void {\n\tconst prefix = options.prefix ?? \"fast__\";\n\tif (typeof prefix !== \"string\" || prefix.length === 0) {\n\t\tthrow new TypeError(\"Storage 前缀必须是非空字符串。\");\n\t}\n\tif (options.codec !== undefined && options.crypto === true) {\n\t\tthrow new TypeError(\"Storage 的 Codec 和加密选项不能同时使用。\");\n\t}\n\tconst codec = options.codec ?? (options.crypto === true ? base64StorageCodec : jsonCodec);\n\tconst now = options.now ?? Date.now;\n\tif (activeConfiguration !== undefined) {\n\t\t// 相同配置允许多个入口模块幂等调用；任何引用或值变化都视为冲突。\n\t\tif (activeConfiguration.prefix === prefix && activeConfiguration.codec === codec && activeConfiguration.now === now) {\n\t\t\treturn;\n\t\t}\n\t\tthrow new Error(\"Storage 已使用其他选项完成配置。\");\n\t}\n\tconst uni = getGlobalUniStorage();\n\tconst localBackend = uni === undefined ? () => createWebStorageBackend(\"local\") : () => createUniStorageBackend(uni);\n\tconst local = createStorageArea(localBackend, prefix, codec, now);\n\tconst configuration: ActiveStorageConfiguration = { codec, local, now, prefix };\n\tif (uni === undefined) {\n\t\tconfiguration.session = createStorageArea(() => createWebStorageBackend(\"session\"), prefix, codec, now);\n\t}\n\tactiveConfiguration = configuration;\n}\n\n/** 返回 Storage 是否已经显式配置，或由首次 Storage 操作激活默认配置。 */\nexport function isStorageConfigured(): boolean {\n\treturn activeConfiguration !== undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/storage/index.ts"],"sourcesContent":["import { decodeSecureBase64, encodeSecureBase64 } from \"../base64/index\";\n\n/** Storage 业务值编码器 */\nexport interface StorageCodec {\n\t/**\n\t * 把已编码文本恢复为业务值。\n\t * @param value - 由同一 Codec 的 `encode` 生成并持久化的文本\n\t * @returns 解码后的业务值\n\t * @throws 当文本损坏、格式不受支持或无法反序列化时应抛出错误。\n\t */\n\tdecode: (value: string) => unknown;\n\t/**\n\t * 把业务值编码为可持久化字符串。\n\t * @param value - 调用方传入的业务值\n\t * @returns 可由同一 Codec 的 `decode` 无损恢复的文本\n\t * @throws 当值不受支持或无法序列化时应抛出错误。\n\t */\n\tencode: (value: unknown) => string;\n}\n\n/** 程序入口调用 {@link configureStorage} 时使用的全局配置。 */\nexport interface StorageConfiguration {\n\t/** 自定义值编码器；默认使用严格 JSON Codec，同一应用生命周期内必须保持同一引用。 */\n\tcodec?: StorageCodec;\n\t/** 启用 Base64 可逆混淆；不提供加密、完整性或认证，不能与 `codec` 同时使用。 */\n\tcrypto?: boolean;\n\t/** 返回 Unix 毫秒时间戳的时钟；默认使用 `Date.now`，主要用于 TTL 测试与受控时间源。 */\n\tnow?: () => number;\n\t/** 所有物理键使用的非空命名空间前缀，默认 `fast__`。 */\n\tprefix?: string;\n}\n\n/** 单次 Storage 读取配置 */\nexport interface StorageReadOptions {\n\t/**\n\t * 仅覆盖本次读取使用的 Codec；`true` 使用 Base64 混淆，`false` 使用 JSON，省略时使用全局配置。\n\t * 必须与写入该条目时使用的单次设置一致。\n\t */\n\tcrypto?: boolean;\n}\n\n/** 单次 Storage 写入配置 */\nexport interface StorageWriteOptions extends StorageReadOptions {\n\t/** 从写入时刻开始的有效毫秒数；必须是大于 0 的有限数，省略时永久有效。 */\n\tttlMs?: number;\n}\n\n/** `Local` 与 `Session` 的统一操作接口 */\nexport interface StorageArea {\n\t/** 当前全局 Storage 配置的物理键前缀；首次读取会激活默认配置。 */\n\treadonly prefix: string;\n\t/**\n\t * 删除当前命名空间内的全部键，不影响同一后端中的其他应用键。\n\t * @throws `Error` 当当前平台后端不可用。\n\t */\n\tclear: () => void;\n\t/**\n\t * 获取并解码业务值；已过期记录会在读取时删除。\n\t * @param key - 不含全局前缀的非空业务键\n\t * @param options - 可选的单次 Base64 混淆开关；必须与写入时一致。\n\t * @returns 解码后的值；未传泛型时静态类型默认为 `string`，键缺失或过期时返回 `undefined`。\n\t * @throws 当键非法、包络损坏、Codec 解码失败或后端不可用时抛出错误。\n\t */\n\tget: <Value = string>(key: string, options?: StorageReadOptions) => Value | undefined;\n\t/**\n\t * 判断业务键是否具有有效且未过期的包络；不解码业务值。\n\t * @param key - 不含全局前缀的非空业务键\n\t * @returns 键存在且包络有效时返回 `true`。\n\t */\n\thas: (key: string) => boolean;\n\t/**\n\t * 返回当前命名空间内的业务键快照。\n\t * @returns 已移除全局前缀并按字典序排列的新数组；不会自动清理过期项。\n\t */\n\tkeys: () => string[];\n\t/**\n\t * 扫描当前命名空间并删除全部过期记录。\n\t * @returns 本次实际删除的记录数量\n\t * @throws 当发现损坏包络或后端不可用时抛出错误。\n\t */\n\tpruneExpired: () => number;\n\t/**\n\t * 删除单个业务键；键不存在时保持幂等。\n\t * @param key - 不含全局前缀的非空业务键\n\t */\n\tremove: (key: string) => void;\n\t/**\n\t * 删除业务键以指定文本开头的全部条目，范围仍受全局命名空间限制。\n\t * @param keyPrefix - 不含全局前缀的非空业务键前缀\n\t */\n\tremoveByPrefix: (keyPrefix: string) => void;\n\t/**\n\t * 编码并写入业务值，可附加惰性清理的 TTL。\n\t * @param key - 不含全局前缀的非空业务键\n\t * @param value - 必须受当前 Codec 支持的业务值\n\t * @param options - 可选的单次写入 TTL 与 Base64 混淆开关\n\t * @throws 当键、TTL、业务值或后端写入无效时抛出错误。\n\t */\n\tset: <Value>(key: string, value: Value, options?: StorageWriteOptions) => void;\n}\n\n/** 浏览器 Storage 与 uni-app Storage 适配后的最小内部协议 */\ninterface StorageBackend {\n\t/** 读取物理键原始值；缺失约定由上层统一规范为 `undefined`。 */\n\tgetItem: (key: string) => unknown;\n\t/** 枚举后端可见的全部物理键；返回值必须是不会随枚举过程变化的快照。 */\n\tkeys: () => readonly string[];\n\t/** 删除单个物理键；实现必须允许重复删除。 */\n\tremoveItem: (key: string) => void;\n\t/** 写入已经序列化的包络文本；配额和平台错误保持原样传播。 */\n\tsetItem: (key: string, value: string) => void;\n}\n\n/** 物理存储中的版本化包络；业务值始终先经 Codec 转为文本。 */\ninterface StoredEnvelope {\n\t/** Codec 编码后的业务文本；只有在包络结构校验通过后才能交给 Codec。 */\n\tdata: string;\n\t/** Unix 毫秒绝对过期时间戳；`null` 表示永久有效。 */\n\texpiresAt: number | null;\n\t/** 当前持久化协议版本；读取其他版本必须明确失败，不能猜测迁移。 */\n\tversion: 3;\n}\n\n/** 首次配置后冻结使用的解析结果和两个稳定门面。 */\ninterface ActiveStorageConfiguration {\n\t/** 首次配置后锁定的业务值 Codec 引用。 */\n\tcodec: StorageCodec;\n\t/** 已绑定 Local 后端、命名空间、Codec 与时钟的实际 Area。 */\n\tlocal: StorageArea;\n\t/** 首次配置后锁定的 TTL 时钟引用。 */\n\tnow: () => number;\n\t/** 所有 Area 共享的物理键命名空间前缀。 */\n\tprefix: string;\n\t/** 仅浏览器模式存在的 Session Area；uni-app 模式必须保持缺失。 */\n\tsession?: StorageArea;\n}\n\n/**\n * 读取并校验当前运行时的全局 uni-app 同步 Storage。\n *\n * @returns 检测到可用的 uni-app 同步 Storage 时返回 `true`。\n * @throws `TypeError` 当全局 `uni` 存在但缺少本库需要的同步 Storage 方法。\n */\nconst hasGlobalUniStorage = (): boolean => {\n\tif (typeof uni === \"undefined\") return false;\n\tif (\n\t\tuni === null ||\n\t\ttypeof uni.getStorageSync !== \"function\" ||\n\t\ttypeof uni.getStorageInfoSync !== \"function\" ||\n\t\ttypeof uni.removeStorageSync !== \"function\" ||\n\t\ttypeof uni.setStorageSync !== \"function\"\n\t) {\n\t\tthrow new TypeError(\"The global uni object does not provide synchronous Storage APIs.\");\n\t}\n\treturn true;\n};\n\n/** 默认 JSON Codec；显式拒绝会被 JSON.stringify 静默丢弃的顶层值。 */\nconst jsonCodec: StorageCodec = {\n\tdecode: (value) => JSON.parse(value) as unknown,\n\tencode: (value) => {\n\t\tconst encoded = JSON.stringify(value);\n\t\tif (typeof encoded !== \"string\") throw new TypeError(\"The storage value cannot be serialized as JSON.\");\n\t\treturn encoded;\n\t},\n};\n\n/** Base64 混淆 Codec；只隐藏明文外观，不提供加密、完整性或认证。 */\nexport const base64StorageCodec: StorageCodec = {\n\tdecode: (value) => JSON.parse(decodeSecureBase64(value)) as unknown,\n\tencode: (value) => {\n\t\tconst encoded = JSON.stringify(value);\n\t\tif (typeof encoded !== \"string\") throw new TypeError(\"The storage value cannot be serialized as JSON.\");\n\t\treturn encodeSecureBase64(encoded);\n\t},\n};\n\n/** 页面级唯一配置；只允许幂等重复配置，避免模块加载顺序改变行为。 */\nlet activeConfiguration: ActiveStorageConfiguration | undefined;\n\n/**\n * 判断未知值是否为非数组对象记录。\n *\n * @param value - JSON.parse 返回的未知值\n * @returns 值为非空、非数组对象时返回 `true`。\n */\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === \"object\" && value !== null && !Array.isArray(value);\n\n/**\n * 校验 Storage 业务键。\n *\n * @param key - 不含全局 Prefix 的业务键或业务键前缀\n * @throws `TypeError` 当值不是非空字符串。\n */\nconst assertKey = (key: string): void => {\n\tif (typeof key !== \"string\" || key.length === 0) throw new TypeError(\"Storage keys must be nonempty strings.\");\n};\n\n/**\n * 创建浏览器 Storage 后端。\n *\n * @remarks 平台对象在调用阶段读取，因此导入模块不会访问浏览器全局对象。\n * @param kind - 选择 `localStorage` 或 `sessionStorage`。\n * @returns 统一的内部同步后端\n * @throws `Error` 当所选 Storage 在当前环境不可用。\n */\nconst createWebStorageBackend = (kind: \"local\" | \"session\"): StorageBackend => {\n\tconst storage =\n\t\tkind === \"local\"\n\t\t\t? typeof localStorage === \"undefined\"\n\t\t\t\t? undefined\n\t\t\t\t: localStorage\n\t\t\t: typeof sessionStorage === \"undefined\"\n\t\t\t\t? undefined\n\t\t\t\t: sessionStorage;\n\tif (storage === undefined) throw new Error(`The current runtime does not support ${kind}Storage.`);\n\treturn {\n\t\tgetItem: (key) => storage.getItem(key),\n\t\tkeys: () => {\n\t\t\tconst keys: string[] = [];\n\t\t\tfor (let index = 0; index < storage.length; index += 1) {\n\t\t\t\tconst key = storage.key(index);\n\t\t\t\tif (key !== null) keys.push(key);\n\t\t\t}\n\t\t\treturn keys;\n\t\t},\n\t\tremoveItem: (key) => {\n\t\t\tstorage.removeItem(key);\n\t\t},\n\t\tsetItem: (key, value) => {\n\t\t\tstorage.setItem(key, value);\n\t\t},\n\t};\n};\n\n/**\n * 把 uni-app 同步 Storage 适配为内部后端。\n *\n * @remarks uni-app 以空字符串同时表示“键缺失”和“真实空值”，因此空字符串需要结合键清单消除歧义。\n * @returns 统一的内部同步后端\n */\nconst createUniStorageBackend = (): StorageBackend => ({\n\tgetItem: (key) => {\n\t\tconst value: unknown = uni.getStorageSync(key);\n\t\tif (value !== \"\") return value;\n\t\treturn uni.getStorageInfoSync().keys.includes(key) ? value : undefined;\n\t},\n\tkeys: () => [...uni.getStorageInfoSync().keys],\n\tremoveItem: (key) => {\n\t\tuni.removeStorageSync(key);\n\t},\n\tsetItem: (key, value) => {\n\t\tuni.setStorageSync(key, value);\n\t},\n});\n\n/**\n * 解析并校验版本化 Storage 包络。\n *\n * @param rawValue - 后端返回的原始值\n * @param key - 用于错误定位的完整物理键\n * @returns 当前 v3 包络\n * @throws `TypeError` 当原始值不是字符串、JSON 损坏、版本不支持或字段类型非法。\n */\nconst parseStoredEnvelope = (rawValue: unknown, key: string): StoredEnvelope => {\n\tif (typeof rawValue !== \"string\") throw new TypeError(`Storage entry \"${key}\" is not a string.`);\n\ttry {\n\t\tconst parsed = JSON.parse(rawValue) as unknown;\n\t\tif (\n\t\t\t!isRecord(parsed) ||\n\t\t\tparsed[\"version\"] !== 3 ||\n\t\t\ttypeof parsed[\"data\"] !== \"string\" ||\n\t\t\t!(parsed[\"expiresAt\"] === null || (typeof parsed[\"expiresAt\"] === \"number\" && Number.isFinite(parsed[\"expiresAt\"])))\n\t\t) {\n\t\t\tthrow new TypeError(\"Unsupported storage envelope.\");\n\t\t}\n\t\treturn { data: parsed[\"data\"], expiresAt: parsed[\"expiresAt\"], version: 3 };\n\t} catch (cause) {\n\t\tthrow new TypeError(`Storage entry \"${key}\" is corrupted or unsupported.`, { cause });\n\t}\n};\n\n/**\n * 创建绑定命名空间、Codec 与时钟的 Storage Area。\n *\n * @param backendFactory - 每次操作时解析平台后端的工厂，保证导入安全并反映平台可用性。\n * @param prefix - 已校验的全局物理键前缀\n * @param codec - 业务值与包络文本之间的 Codec\n * @param now - TTL 计算使用的可注入时钟\n * @returns 完整的命名空间 Storage 操作集合\n */\nconst createStorageArea = (backendFactory: () => StorageBackend, prefix: string, codec: StorageCodec, now: () => number): StorageArea => {\n\t/**\n\t * 拼接物理键。\n\t *\n\t * @param key - 已校验业务键\n\t * @returns 带当前命名空间前缀的物理键\n\t */\n\tconst toStorageKey = (key: string) => `${prefix}${key}`;\n\t/**\n\t * 解析本次读写实际使用的 Codec。\n\t *\n\t * @param crypto - 单次 Base64 混淆开关；省略时沿用 Area 全局 Codec。\n\t * @returns 本次操作使用的全局、JSON 或 Base64 Codec\n\t * @throws `TypeError` 当 JavaScript 调用方传入非布尔值。\n\t */\n\tconst resolveOperationCodec = (crypto: boolean | undefined) => {\n\t\tif (crypto === undefined) return codec;\n\t\tif (typeof crypto !== \"boolean\") throw new TypeError(\"The per-operation Storage `crypto` option must be a boolean.\");\n\t\treturn crypto ? base64StorageCodec : jsonCodec;\n\t};\n\t/**\n\t * 枚举当前命名空间中的业务键。\n\t *\n\t * @param backend - 本次操作使用的后端\n\t * @returns 已移除物理前缀、去重并排序的业务键\n\t * @throws `TypeError` 当后端返回非字符串键。\n\t */\n\tconst listBusinessKeys = (backend: StorageBackend) => {\n\t\tconst keys = backend.keys();\n\t\tif (!Array.isArray(keys) || !keys.every((key) => typeof key === \"string\")) {\n\t\t\tthrow new TypeError(\"Keys returned by the Storage backend must be strings.\");\n\t\t}\n\t\treturn [...new Set(keys.filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length)))].sort();\n\t};\n\t/**\n\t * 读取并处理单个包络。\n\t *\n\t * @param backend - 本次操作使用的后端\n\t * @param key - 业务键\n\t * @returns 未过期包络；键缺失或已经过期时返回 `undefined`。\n\t * @throws `TypeError` 当键或包络非法。\n\t * @throws `RangeError` 当注入时钟返回非有限时间戳。\n\t */\n\tconst readStoredEnvelope = (backend: StorageBackend, key: string): StoredEnvelope | undefined => {\n\t\tassertKey(key);\n\t\tconst storageKey = toStorageKey(key);\n\t\tconst rawValue = backend.getItem(storageKey);\n\t\tif (rawValue === null || rawValue === undefined) return undefined;\n\t\tconst envelope = parseStoredEnvelope(rawValue, storageKey);\n\t\tif (envelope.expiresAt === null) return envelope;\n\t\tconst timestamp = now();\n\t\tif (!Number.isFinite(timestamp)) throw new RangeError(\"The Storage clock must return a finite timestamp.\");\n\t\tif (timestamp < envelope.expiresAt) return envelope;\n\t\t// 过期项在读取时立即删除，后续 has/keys/pruneExpired 观察到一致状态。\n\t\tbackend.removeItem(storageKey);\n\t\treturn undefined;\n\t};\n\n\treturn {\n\t\tprefix,\n\t\tclear() {\n\t\t\tconst backend = backendFactory();\n\t\t\tfor (const key of listBusinessKeys(backend)) backend.removeItem(toStorageKey(key));\n\t\t},\n\t\tget<Value>(key: string, options: StorageReadOptions = {}): Value | undefined {\n\t\t\tconst envelope = readStoredEnvelope(backendFactory(), key);\n\t\t\tif (envelope === undefined) return undefined;\n\t\t\ttry {\n\t\t\t\treturn resolveOperationCodec(options.crypto).decode(envelope.data) as Value;\n\t\t\t} catch (cause) {\n\t\t\t\tthrow new TypeError(`Unable to decode Storage entry \"${toStorageKey(key)}\".`, { cause });\n\t\t\t}\n\t\t},\n\t\thas: (key) => readStoredEnvelope(backendFactory(), key) !== undefined,\n\t\tkeys: () => listBusinessKeys(backendFactory()),\n\t\tpruneExpired() {\n\t\t\tconst backend = backendFactory();\n\t\t\tlet removed = 0;\n\t\t\tfor (const key of listBusinessKeys(backend)) {\n\t\t\t\t// read 同时处理删除；先读取一次用于区分“原本缺失”和“本轮因过期删除”。\n\t\t\t\tconst before = backend.getItem(toStorageKey(key));\n\t\t\t\tif (before !== null && before !== undefined && readStoredEnvelope(backend, key) === undefined) removed += 1;\n\t\t\t}\n\t\t\treturn removed;\n\t\t},\n\t\tremove(key: string) {\n\t\t\tassertKey(key);\n\t\t\tbackendFactory().removeItem(toStorageKey(key));\n\t\t},\n\t\tremoveByPrefix(keyPrefix: string) {\n\t\t\tassertKey(keyPrefix);\n\t\t\tconst backend = backendFactory();\n\t\t\tfor (const key of listBusinessKeys(backend)) if (key.startsWith(keyPrefix)) backend.removeItem(toStorageKey(key));\n\t\t},\n\t\tset<Value>(key: string, value: Value, options: StorageWriteOptions = {}) {\n\t\t\tassertKey(key);\n\t\t\tif (value === undefined) throw new TypeError(\"Cannot store top-level `undefined`; remove the key instead.\");\n\t\t\tlet expiresAt: number | null = null;\n\t\t\tif (options.ttlMs !== undefined) {\n\t\t\t\tif (!Number.isFinite(options.ttlMs) || options.ttlMs <= 0) throw new RangeError(\"`ttlMs` must be a finite number greater than 0.\");\n\t\t\t\tconst timestamp = now();\n\t\t\t\tif (!Number.isFinite(timestamp) || !Number.isFinite(timestamp + options.ttlMs)) {\n\t\t\t\t\tthrow new RangeError(\"The Storage expiration time exceeds the supported timestamp range.\");\n\t\t\t\t}\n\t\t\t\texpiresAt = timestamp + options.ttlMs;\n\t\t\t}\n\t\t\tlet data: string;\n\t\t\ttry {\n\t\t\t\tdata = resolveOperationCodec(options.crypto).encode(value);\n\t\t\t\tif (typeof data !== \"string\") throw new TypeError(\"The Storage codec must return a string.\");\n\t\t\t} catch (cause) {\n\t\t\t\tthrow new TypeError(\"Unable to encode the storage value.\", { cause });\n\t\t\t}\n\t\t\tbackendFactory().setItem(toStorageKey(key), JSON.stringify({ data, expiresAt, version: 3 } satisfies StoredEnvelope));\n\t\t},\n\t};\n};\n\n/**\n * 获取已激活的全局 Storage 配置。\n *\n * @returns 显式配置或首次 Storage 操作创建的默认配置\n */\nconst requireStorageConfiguration = (): ActiveStorageConfiguration => {\n\tif (activeConfiguration === undefined) configureStorage();\n\tif (activeConfiguration === undefined) throw new Error(\"Unable to initialize the Storage configuration.\");\n\treturn activeConfiguration;\n};\n\n/**\n * 创建稳定的公开 Storage 门面。\n *\n * @param select - 从激活配置选择 Local 或 Session 的函数\n * @param name - 用于不可用错误的公开门面名称\n * @returns 可安全导入、并在首次调用时解析默认或显式配置的稳定对象。\n */\nconst createStorageAreaProxy = (select: (configuration: ActiveStorageConfiguration) => StorageArea | undefined, name: string): StorageArea => {\n\t/**\n\t * 解析当前实际 Area。\n\t *\n\t * @returns 配置中的 Local 或 Session Area\n\t * @throws `Error` 当 uni-app 模式请求 Session。\n\t */\n\tconst getArea = () => {\n\t\tconst area = select(requireStorageConfiguration());\n\t\tif (area === undefined) throw new Error(`${name} is not supported in uni-app.`);\n\t\treturn area;\n\t};\n\treturn {\n\t\tget prefix() {\n\t\t\treturn getArea().prefix;\n\t\t},\n\t\tclear: () => {\n\t\t\tgetArea().clear();\n\t\t},\n\t\tget: <Value>(key: string, options?: StorageReadOptions): Value | undefined => getArea().get<Value>(key, options),\n\t\thas: (key) => getArea().has(key),\n\t\tkeys: () => getArea().keys(),\n\t\tpruneExpired: () => getArea().pruneExpired(),\n\t\tremove: (key) => {\n\t\t\tgetArea().remove(key);\n\t\t},\n\t\tremoveByPrefix: (keyPrefix) => {\n\t\t\tgetArea().removeByPrefix(keyPrefix);\n\t\t},\n\t\tset: <Value>(key: string, value: Value, options?: StorageWriteOptions) => {\n\t\t\tgetArea().set(key, value, options);\n\t\t},\n\t};\n};\n\n/** 浏览器 localStorage 或自动检测的 uni-app Storage 全局业务入口。 */\nexport const Local: StorageArea = createStorageAreaProxy((configuration) => configuration.local, \"Local\");\n\n/** 浏览器 sessionStorage 的全局业务入口；uni-app 不提供会话存储。 */\nexport const Session: StorageArea = createStorageAreaProxy((configuration) => configuration.session, \"Session\");\n\n/**\n * 在首次 Storage 操作前可选配置 `Local` 与 `Session`。\n *\n * @remarks 不调用时在首次操作上使用 `fast__`、JSON Codec 与 `Date.now`。首次激活后只允许以完全相同的值和引用重复调用。若检测到\n * 全局 `uni`，则自动使用其同步 Storage 且只启用 `Local`，否则使用浏览器 `localStorage` 与 `sessionStorage`。\n * `crypto: true` 仅执行可逆 Base64 混淆，不能保护敏感数据。\n * @param options - 可选的全局键前缀、Codec、Base64 混淆选项与时钟。\n * @throws 配置非法、重复配置冲突或目标平台 Storage 不可用时抛出错误。\n */\nexport function configureStorage(options: StorageConfiguration = {}): void {\n\tconst prefix = options.prefix ?? \"fast__\";\n\tif (typeof prefix !== \"string\" || prefix.length === 0) {\n\t\tthrow new TypeError(\"The Storage prefix must be a nonempty string.\");\n\t}\n\tif (options.codec !== undefined && options.crypto === true) {\n\t\tthrow new TypeError(\"Storage codec and crypto options cannot be used together.\");\n\t}\n\tconst codec = options.codec ?? (options.crypto === true ? base64StorageCodec : jsonCodec);\n\tconst now = options.now ?? Date.now;\n\tif (activeConfiguration !== undefined) {\n\t\t// 相同配置允许多个入口模块幂等调用；任何引用或值变化都视为冲突。\n\t\tif (activeConfiguration.prefix === prefix && activeConfiguration.codec === codec && activeConfiguration.now === now) {\n\t\t\treturn;\n\t\t}\n\t\tthrow new Error(\"Storage is already configured with different options.\");\n\t}\n\tconst usesUniStorage = hasGlobalUniStorage();\n\tconst localBackend = usesUniStorage ? () => createUniStorageBackend() : () => createWebStorageBackend(\"local\");\n\tconst local = createStorageArea(localBackend, prefix, codec, now);\n\tconst configuration: ActiveStorageConfiguration = { codec, local, now, prefix };\n\tif (!usesUniStorage) {\n\t\tconfiguration.session = createStorageArea(() => createWebStorageBackend(\"session\"), prefix, codec, now);\n\t}\n\tactiveConfiguration = configuration;\n}\n\n/** 返回 Storage 是否已经显式配置，或由首次 Storage 操作激活默认配置。 */\nexport function isStorageConfigured(): boolean {\n\treturn activeConfiguration !== undefined;\n}\n"],"mappings":"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"}