@fast-china/utils 2.1.1 → 2.1.2

package/dist/index.mjs

@@ -10,7 +10,7 @@ import { detectRuntime, hasWebCrypto, isBrowser, isMobileUserAgent, isNode, isTa
 import { Local, Session, base64StorageCodec, configureStorage, isStorageConfigured } from "./storage/index.mjs";
 import { camelCase, copy, decodeURIComponentRepeatedly, escapeHtml, generateUuidV4, isUuidV4, isValidJson, kebabCase, lowerFirst, normalizeWhitespace, parseQueryString, pascalCase, randomString, splitWords, truncateGraphemes, upperFirst } from "./string/index.mjs";
 import { configureInstallationIdentity, getOrCreateInstallationId, installationIdentity } from "./identity/index.mjs";
-import { createLogger, logger } from "./logger/index.mjs";
+import { configureLogger, createLogger, logger } from "./logger/index.mjs";
 import { hasOwn, isPlainObject, mapValues, omit, pick, shallowEqual, toQueryString } from "./object/index.mjs";
 import { useEmits } from "./vue/emits.mjs";
 import { useExpose } from "./vue/expose.mjs";
@@ -20,4 +20,4 @@ import { definePropType, useProps } from "./vue/props.mjs";
 import { useRender } from "./vue/render.mjs";
 import { makeSlots } from "./vue/slots.mjs";
 import { withDefineType } from "./vue/with.mjs";
-export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, FixedTimeEquals, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, Local, MD5Encrypt, PBKDF2SHA256, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, Session, VerifyPasswordPBKDF2SHA256, addCssUnit, addDays, addMonths, addYears, allEqualBy, average, base64StorageCodec, callOptionalFunction, camelCase, chunk, clamp, configureInstallationIdentity, configureStorage, contrastRatio, copy, createDateRangeShortcuts, createDateShortcuts, createLogger, createOneMonthRangeFromToday, debounce, decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, decodeURIComponentRepeatedly, definePropType, detectRuntime, difference, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64, endOfDay, escapeHtml, formatBytes, formatChineseRelativeTime, formatHexColor, formatRelativeTime, generateUuidV4, getLocalDayBounds, getLocalTimeGreeting, getOrCreateInstallationId, getStartOfToday, groupBy, hasDuplicatesBy, hasOwn, hasWebCrypto, inRange, installationIdentity, intersection, isBrowser, isDateAfterNow, isFuture, isMobileUserAgent, isNode, isPlainObject, isSameDay, isStorageConfigured, isTabletUserAgent, isUniApp, isUuidV4, isValidDate, isValidJson, isWebWorker, isWithinInterval, kebabCase, lerp, logger, lowerFirst, makeSlots, mapConcurrent, mapValues, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, normalizeWhitespace, omit, parseHexColor, parseQueryString, partition, pascalCase, pick, pickHigherContrastColor, randomInt, randomString, relativeLuminance, removeNullishValues, retry, roundTo, serializeStyle, shallowEqual, sleep, splitWords, startOfDay, sum, throttle, toDate, toQueryString, truncateGraphemes, unique, uniqueBy, upperFirst, useEmits, useExpose, useProps, useRender, withDefineType, withInstall, withInstallDirective, withNoopInstall, withTimeout };
+export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, FixedTimeEquals, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, Local, MD5Encrypt, PBKDF2SHA256, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, Session, VerifyPasswordPBKDF2SHA256, addCssUnit, addDays, addMonths, addYears, allEqualBy, average, base64StorageCodec, callOptionalFunction, camelCase, chunk, clamp, configureInstallationIdentity, configureLogger, configureStorage, contrastRatio, copy, createDateRangeShortcuts, createDateShortcuts, createLogger, createOneMonthRangeFromToday, debounce, decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, decodeURIComponentRepeatedly, definePropType, detectRuntime, difference, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64, endOfDay, escapeHtml, formatBytes, formatChineseRelativeTime, formatHexColor, formatRelativeTime, generateUuidV4, getLocalDayBounds, getLocalTimeGreeting, getOrCreateInstallationId, getStartOfToday, groupBy, hasDuplicatesBy, hasOwn, hasWebCrypto, inRange, installationIdentity, intersection, isBrowser, isDateAfterNow, isFuture, isMobileUserAgent, isNode, isPlainObject, isSameDay, isStorageConfigured, isTabletUserAgent, isUniApp, isUuidV4, isValidDate, isValidJson, isWebWorker, isWithinInterval, kebabCase, lerp, logger, lowerFirst, makeSlots, mapConcurrent, mapValues, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, normalizeWhitespace, omit, parseHexColor, parseQueryString, partition, pascalCase, pick, pickHigherContrastColor, randomInt, randomString, relativeLuminance, removeNullishValues, retry, roundTo, serializeStyle, shallowEqual, sleep, splitWords, startOfDay, sum, throttle, toDate, toQueryString, truncateGraphemes, unique, uniqueBy, upperFirst, useEmits, useExpose, useProps, useRender, withDefineType, withInstall, withInstallDirective, withNoopInstall, withTimeout };

package/dist/internal/text.d.mts

@@ -0,0 +1,17 @@
+//#region src/internal/text.d.ts
+/** 解码或解密后的字符串扩展。 */
+interface DecodedTextExtension {
+  /**
+   * 显式把原始文本解析为 JSON 值。
+   *
+   * @remarks 泛型只描述调用方期望的类型，不验证实际 JSON 结构；不可信数据仍需执行运行时校验。
+   * @returns `JSON.parse` 生成的对象、数组、标量或 `null`。
+   * @throws `TypeError` 当原始文本不是合法 JSON。
+   */
+  parseJson: <Value = any>() => Value;
+}
+/** 可直接作为原始字符串使用，并支持显式 JSON 解析的解码或解密结果。 */
+type DecodedText = string & DecodedTextExtension;
+//#endregion
+export { DecodedText };
+//# sourceMappingURL=text.d.mts.map

package/dist/internal/text.mjs

@@ -29,7 +29,45 @@ const getTextEncoder = () => {
 * @throws `Error` 当当前平台没有提供 `TextEncoder`。
 */
 const encodeUtf8 = (value) => getTextEncoder().encode(value);
+const parseJsonMarker = Symbol.for("@fast-china/utils/parse-json");
+/** 把当前字符串解析为 JSON 值。 */
+const parseJson = function() {
+	try {
+		return JSON.parse(String(this));
+	} catch (cause) {
+		throw new TypeError("解码后的文本不是有效的 JSON。", { cause });
+	}
+};
+Object.defineProperty(parseJson, parseJsonMarker, { value: true });
+/** 按需安装不可枚举的字符串 JSON 解析扩展。 */
+const ensureParseJsonExtension = () => {
+	const descriptor = Object.getOwnPropertyDescriptor(String.prototype, "parseJson");
+	if (descriptor !== void 0) {
+		if (typeof descriptor.value === "function" && Reflect.get(descriptor.value, parseJsonMarker) === true) return;
+		throw new TypeError("String.prototype.parseJson 已被其他实现占用。");
+	}
+	try {
+		Object.defineProperty(String.prototype, "parseJson", {
+			configurable: true,
+			enumerable: false,
+			value: parseJson,
+			writable: true
+		});
+	} catch (cause) {
+		throw new TypeError("当前运行环境不允许安装 String.prototype.parseJson。", { cause });
+	}
+};
+/**
+* 创建可链式解析 JSON 的原始字符串。
+*
+* @param text - 解码或解密后的原始文本。
+* @returns 可直接作为字符串使用或显式调用 `.parseJson<Value>()` 的结果。
+*/
+const createDecodedText = (text) => {
+	ensureParseJsonExtension();
+	return text;
+};
 //#endregion
-export { encodeUtf8, getTextDecoder, getTextEncoder };
+export { createDecodedText, encodeUtf8, getTextDecoder, getTextEncoder };
 
 //# sourceMappingURL=text.mjs.map

package/dist/internal/text.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"text.mjs","names":[],"sources":["../../src/internal/text.ts"],"sourcesContent":["/**\n * 延迟解析 UTF-8 TextDecoder，确保模块导入阶段不依赖 Encoding API。\n *\n * @returns 启用 Fatal 模式的新解码器，非法 UTF-8 会直接失败。\n * @throws `Error` 当当前平台没有提供 `TextDecoder`。\n */\nexport const getTextDecoder = (): TextDecoder => {\n\tconst TextDecoderConstructor = globalThis.TextDecoder;\n\tif (typeof TextDecoderConstructor !== \"function\") {\n\t\tthrow new Error(\"当前运行环境不支持 TextDecoder。\");\n\t}\n\treturn new TextDecoderConstructor(\"utf-8\", { fatal: true });\n};\n\n/**\n * 延迟解析 TextEncoder，让纯字节 API 在缺少 Encoding API 的平台仍可导入。\n *\n * @returns 新建的 UTF-8 编码器。\n * @throws `Error` 当当前平台没有提供 `TextEncoder`。\n */\nexport const getTextEncoder = (): TextEncoder => {\n\tconst TextEncoderConstructor = globalThis.TextEncoder;\n\tif (typeof TextEncoderConstructor !== \"function\") {\n\t\tthrow new Error(\"当前运行环境不支持 TextEncoder。\");\n\t}\n\treturn new TextEncoderConstructor();\n};\n\n/**\n * 在确认平台能力后把 JavaScript 字符串编码为 UTF-8。\n *\n * @param value - 待编码文本。\n * @returns 使用独立 ArrayBuffer 的 UTF-8 字节数组。\n * @throws `Error` 当当前平台没有提供 `TextEncoder`。\n */\nexport const encodeUtf8 = (value: string): Uint8Array<ArrayBuffer> => getTextEncoder().encode(value);\n"],"mappings":";;;;;;;AAMA,MAAa,uBAAoC;CAChD,MAAM,yBAAyB,WAAW;CAC1C,IAAI,OAAO,2BAA2B,YACrC,MAAM,IAAI,MAAM,wBAAwB;CAEzC,OAAO,IAAI,uBAAuB,SAAS,EAAE,OAAO,KAAK,CAAC;AAC3D;;;;;;;AAQA,MAAa,uBAAoC;CAChD,MAAM,yBAAyB,WAAW;CAC1C,IAAI,OAAO,2BAA2B,YACrC,MAAM,IAAI,MAAM,wBAAwB;CAEzC,OAAO,IAAI,uBAAuB;AACnC;;;;;;;;AASA,MAAa,cAAc,UAA2C,eAAe,CAAC,CAAC,OAAO,KAAK"}
+{"version":3,"file":"text.mjs","names":[],"sources":["../../src/internal/text.ts"],"sourcesContent":["/**\n * 延迟解析 UTF-8 TextDecoder，确保模块导入阶段不依赖 Encoding API。\n *\n * @returns 启用 Fatal 模式的新解码器，非法 UTF-8 会直接失败。\n * @throws `Error` 当当前平台没有提供 `TextDecoder`。\n */\nexport const getTextDecoder = (): TextDecoder => {\n\tconst TextDecoderConstructor = globalThis.TextDecoder;\n\tif (typeof TextDecoderConstructor !== \"function\") {\n\t\tthrow new Error(\"当前运行环境不支持 TextDecoder。\");\n\t}\n\treturn new TextDecoderConstructor(\"utf-8\", { fatal: true });\n};\n\n/**\n * 延迟解析 TextEncoder，让纯字节 API 在缺少 Encoding API 的平台仍可导入。\n *\n * @returns 新建的 UTF-8 编码器。\n * @throws `Error` 当当前平台没有提供 `TextEncoder`。\n */\nexport const getTextEncoder = (): TextEncoder => {\n\tconst TextEncoderConstructor = globalThis.TextEncoder;\n\tif (typeof TextEncoderConstructor !== \"function\") {\n\t\tthrow new Error(\"当前运行环境不支持 TextEncoder。\");\n\t}\n\treturn new TextEncoderConstructor();\n};\n\n/**\n * 在确认平台能力后把 JavaScript 字符串编码为 UTF-8。\n *\n * @param value - 待编码文本。\n * @returns 使用独立 ArrayBuffer 的 UTF-8 字节数组。\n * @throws `Error` 当当前平台没有提供 `TextEncoder`。\n */\nexport const encodeUtf8 = (value: string): Uint8Array<ArrayBuffer> => getTextEncoder().encode(value);\n\n/** 解码或解密后的字符串扩展。 */\ninterface DecodedTextExtension {\n\t/**\n\t * 显式把原始文本解析为 JSON 值。\n\t *\n\t * @remarks 泛型只描述调用方期望的类型，不验证实际 JSON 结构；不可信数据仍需执行运行时校验。\n\t * @returns `JSON.parse` 生成的对象、数组、标量或 `null`。\n\t * @throws `TypeError` 当原始文本不是合法 JSON。\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any -- 未传泛型时按公共 API 约定保留 JSON.parse 的 any 返回类型。\n\tparseJson: <Value = any>() => Value;\n}\n\n/** 可直接作为原始字符串使用，并支持显式 JSON 解析的解码或解密结果。 */\nexport type DecodedText = string & DecodedTextExtension;\n\nconst parseJsonMarker = Symbol.for(\"@fast-china/utils/parse-json\");\n\n/** 把当前字符串解析为 JSON 值。 */\nconst parseJson = function <Value = ReturnType<typeof JSON.parse>>(this: string): Value {\n\ttry {\n\t\treturn JSON.parse(String(this)) as Value;\n\t} catch (cause) {\n\t\tthrow new TypeError(\"解码后的文本不是有效的 JSON。\", { cause });\n\t}\n};\n\nObject.defineProperty(parseJson, parseJsonMarker, { value: true });\n\n/** 按需安装不可枚举的字符串 JSON 解析扩展。 */\nconst ensureParseJsonExtension = (): void => {\n\tconst descriptor = Object.getOwnPropertyDescriptor(String.prototype, \"parseJson\");\n\tif (descriptor !== undefined) {\n\t\tif (typeof descriptor.value === \"function\" && Reflect.get(descriptor.value, parseJsonMarker) === true) return;\n\t\tthrow new TypeError(\"String.prototype.parseJson 已被其他实现占用。\");\n\t}\n\n\ttry {\n\t\tObject.defineProperty(String.prototype, \"parseJson\", {\n\t\t\tconfigurable: true,\n\t\t\tenumerable: false,\n\t\t\tvalue: parseJson,\n\t\t\twritable: true,\n\t\t});\n\t} catch (cause) {\n\t\tthrow new TypeError(\"当前运行环境不允许安装 String.prototype.parseJson。\", { cause });\n\t}\n};\n\n/**\n * 创建可链式解析 JSON 的原始字符串。\n *\n * @param text - 解码或解密后的原始文本。\n * @returns 可直接作为字符串使用或显式调用 `.parseJson<Value>()` 的结果。\n */\nexport const createDecodedText = (text: string): DecodedText => {\n\tensureParseJsonExtension();\n\treturn text as DecodedText;\n};\n"],"mappings":";;;;;;;AAMA,MAAa,uBAAoC;CAChD,MAAM,yBAAyB,WAAW;CAC1C,IAAI,OAAO,2BAA2B,YACrC,MAAM,IAAI,MAAM,wBAAwB;CAEzC,OAAO,IAAI,uBAAuB,SAAS,EAAE,OAAO,KAAK,CAAC;AAC3D;;;;;;;AAQA,MAAa,uBAAoC;CAChD,MAAM,yBAAyB,WAAW;CAC1C,IAAI,OAAO,2BAA2B,YACrC,MAAM,IAAI,MAAM,wBAAwB;CAEzC,OAAO,IAAI,uBAAuB;AACnC;;;;;;;;AASA,MAAa,cAAc,UAA2C,eAAe,CAAC,CAAC,OAAO,KAAK;AAkBnG,MAAM,kBAAkB,OAAO,IAAI,8BAA8B;;AAGjE,MAAM,YAAY,WAAsE;CACvF,IAAI;EACH,OAAO,KAAK,MAAM,OAAO,IAAI,CAAC;CAC/B,SAAS,OAAO;EACf,MAAM,IAAI,UAAU,qBAAqB,EAAE,MAAM,CAAC;CACnD;AACD;AAEA,OAAO,eAAe,WAAW,iBAAiB,EAAE,OAAO,KAAK,CAAC;;AAGjE,MAAM,iCAAuC;CAC5C,MAAM,aAAa,OAAO,yBAAyB,OAAO,WAAW,WAAW;CAChF,IAAI,eAAe,KAAA,GAAW;EAC7B,IAAI,OAAO,WAAW,UAAU,cAAc,QAAQ,IAAI,WAAW,OAAO,eAAe,MAAM,MAAM;EACvG,MAAM,IAAI,UAAU,sCAAsC;CAC3D;CAEA,IAAI;EACH,OAAO,eAAe,OAAO,WAAW,aAAa;GACpD,cAAc;GACd,YAAY;GACZ,OAAO;GACP,UAAU;EACX,CAAC;CACF,SAAS,OAAO;EACf,MAAM,IAAI,UAAU,2CAA2C,EAAE,MAAM,CAAC;CACzE;AACD;;;;;;;AAQA,MAAa,qBAAqB,SAA8B;CAC/D,yBAAyB;CACzB,OAAO;AACR"}

package/dist/logger/index.d.mts

@@ -1,6 +1,6 @@
 //#region src/logger/index.d.ts
 /** 日志严重级别，按从低到高排列。 */
-type LogLevel = "debug" | "info" | "warn" | "error";
+type LogLevel = "debug" | "log" | "warn" | "error";
 /** 日志输出目标需要实现的最小控制台接口。 */
 interface LoggerSink {
   /**
@@ -9,7 +9,7 @@ interface LoggerSink {
    */
   debug: (...data: unknown[]) => void;
   /**
-   * 接收通过级别过滤后的普通信息参数；对应 Logger 的 `info` 级别。
+   * 接收通过级别过滤后的普通日志参数；对应 Logger 的 `log` 级别。
    * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
    */
   log: (...data: unknown[]) => void;
@@ -26,7 +26,7 @@ interface LoggerSink {
 }
 /** {@link createLogger} 的不可变配置。 */
 interface LoggerOptions {
-  /** 最低输出级别，默认 `info`；低于该优先级的消息不会传给 Sink。 */
+  /** 最低输出级别，默认 `debug`；低于该优先级的消息不会传给 Sink。 */
   level?: LogLevel;
   /** 日志品牌前缀，默认 `Fast`；必须是无外围空白的非空字符串。 */
   prefix?: string;
@@ -35,40 +35,36 @@ interface LoggerOptions {
   /** uni-app App-Plus/HBuilderX 中把附加参数逐条转成单行文本输出，默认 `false`；其他平台忽略。 */
   uniAppPlusSplit?: boolean;
 }
-/** 配置隔离、无全局可变状态的轻量日志器。 */
+/** 配置隔离的轻量日志器。 */
 interface Logger {
   /**
-   * 输出指定作用域的调试信息。
+   * 输出指定作用域的调试信息或数据。
    * @param scope - 模块、组件或业务来源名称。
-   * @param message - 主消息文本。
-   * @param data - 保持原始类型的附加值。
+   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
    * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
    */
-  debug: (scope: string, message: string, ...data: unknown[]) => void;
+  debug: (scope: string, ...content: unknown[]) => void;
   /**
-   * 输出指定作用域的普通信息。
+   * 输出指定作用域的普通信息或数据。
    * @param scope - 模块、组件或业务来源名称。
-   * @param message - 主消息文本。
-   * @param data - 保持原始类型的附加值。
+   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
    * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
    */
-  info: (scope: string, message: string, ...data: unknown[]) => void;
+  log: (scope: string, ...content: unknown[]) => void;
   /**
-   * 输出指定作用域的警告信息。
+   * 输出指定作用域的警告信息或数据。
    * @param scope - 模块、组件或业务来源名称。
-   * @param message - 主消息文本。
-   * @param data - 保持原始类型的附加值。
+   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
    * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
    */
-  warn: (scope: string, message: string, ...data: unknown[]) => void;
+  warn: (scope: string, ...content: unknown[]) => void;
   /**
-   * 输出指定作用域的错误信息。
+   * 输出指定作用域的错误信息或数据。
    * @param scope - 模块、组件或业务来源名称。
-   * @param message - 主消息文本。
-   * @param data - 保持原始类型的附加值。
+   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
    * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
    */
-  error: (scope: string, message: string, ...data: unknown[]) => void;
+  error: (scope: string, ...content: unknown[]) => void;
 }
 /**
  * 创建独立日志器。
@@ -80,8 +76,16 @@ interface Logger {
  * @throws `RangeError` 当级别未知，或前缀、作用域不是有效的非空字符串。
  */
 declare function createLogger(options?: LoggerOptions): Logger;
-/** 默认使用 `Fast` 前缀和 `info` 级别的便捷日志器。 */
+/**
+ * 替换默认 {@link logger} 的完整配置。
+ *
+ * @remarks 已创建的独立 Logger 不受影响；默认 Logger 对象引用保持稳定，并立即转发到新配置。
+ * 省略选项会恢复 `createLogger()` 的全部默认值。
+ * @param options - 默认 Logger 使用的级别、前缀、输出目标和 uni-app App-Plus 拆分选项。
+ */
+declare function configureLogger(options?: LoggerOptions): void;
+/** 默认使用 `Fast` 前缀和 `debug` 级别、可通过 {@link configureLogger} 配置的便捷日志器。 */
 declare const logger: Logger;
 //#endregion
-export { LogLevel, Logger, LoggerOptions, LoggerSink, createLogger, logger };
+export { LogLevel, Logger, LoggerOptions, LoggerSink, configureLogger, createLogger, logger };
 //# sourceMappingURL=index.d.mts.map

package/dist/logger/index.mjs

@@ -1,7 +1,7 @@
 //#region src/logger/index.ts
 const levelPriority = {
 	debug: 10,
-	info: 20,
+	log: 20,
 	warn: 30,
 	error: 40
 };
@@ -9,7 +9,7 @@ const levelPriority = {
 * 判断未知值是否为受支持日志级别。
 *
 * @param value - 待检查配置值。
-* @returns 值是 `debug`、`info`、`warn` 或 `error` 时返回 `true`。
+* @returns 值是 `debug`、`log`、`warn` 或 `error` 时返回 `true`。
 */
 const isLogLevel = (value) => typeof value === "string" && Object.hasOwn(levelPriority, value);
 /**
@@ -70,7 +70,7 @@ const defaultConsoleSink = {
 * @throws `RangeError` 当级别未知，或前缀、作用域不是有效的非空字符串。
 */
 function createLogger(options = {}) {
-	const requestedLevel = options.level ?? "info";
+	const requestedLevel = options.level ?? "debug";
 	const requestedPrefix = options.prefix ?? "Fast";
 	const sink = options.sink ?? defaultConsoleSink;
 	if (!isLogLevel(requestedLevel)) throw new RangeError(`未知的日志级别：${String(requestedLevel)}。`);
@@ -83,41 +83,70 @@ function createLogger(options = {}) {
 	*
 	* @param messageLevel - 本条消息的严重级别。
 	* @param scope - 模块、组件或业务来源名称。
-	* @param message - 主消息文本。
-	* @param data - 保持原始类型的附加值。
+	* @param content - 可选的消息与保持原始类型的附加值。
 	* @throws `RangeError` 当作用域不是非空字符串或包含外围空白。
 	*/
-	const write = (messageLevel, scope, message, data) => {
+	const write = (messageLevel, scope, content) => {
 		if (typeof scope !== "string") throw new TypeError("日志作用域必须是字符串。");
 		if (scope.length === 0 || scope.trim() !== scope) throw new RangeError("日志作用域必须是无外围空白的非空字符串。");
 		if (levelPriority[messageLevel] < levelPriority[level]) return;
 		const heading = `[${prefix}:${scope}]`;
-		const sinkMethod = messageLevel === "info" ? "log" : messageLevel;
+		const sinkMethod = messageLevel;
 		if (uniAppPlusSplit && isUniAppPlus()) {
-			sink[sinkMethod](`${heading} ${message}`);
-			for (const item of data) sink[sinkMethod](formatSplitValue(item));
+			const [first, ...remaining] = content;
+			if (typeof first === "string") {
+				sink[sinkMethod](`${heading} ${first}`);
+				for (const item of remaining) sink[sinkMethod](formatSplitValue(item));
+			} else {
+				sink[sinkMethod](heading);
+				for (const item of content) sink[sinkMethod](formatSplitValue(item));
+			}
 			return;
 		}
-		sink[sinkMethod](heading, message, ...data);
+		sink[sinkMethod](heading, ...content);
 	};
 	return {
-		debug: (scope, message, ...data) => {
-			write("debug", scope, message, data);
+		debug: (scope, ...content) => {
+			write("debug", scope, content);
 		},
-		info: (scope, message, ...data) => {
-			write("info", scope, message, data);
+		log: (scope, ...content) => {
+			write("log", scope, content);
 		},
-		warn: (scope, message, ...data) => {
-			write("warn", scope, message, data);
+		warn: (scope, ...content) => {
+			write("warn", scope, content);
 		},
-		error: (scope, message, ...data) => {
-			write("error", scope, message, data);
+		error: (scope, ...content) => {
+			write("error", scope, content);
 		}
 	};
 }
-/** 默认使用 `Fast` 前缀和 `info` 级别的便捷日志器。 */
-const logger = createLogger();
+let activeDefaultLogger = createLogger();
+/**
+* 替换默认 {@link logger} 的完整配置。
+*
+* @remarks 已创建的独立 Logger 不受影响；默认 Logger 对象引用保持稳定，并立即转发到新配置。
+* 省略选项会恢复 `createLogger()` 的全部默认值。
+* @param options - 默认 Logger 使用的级别、前缀、输出目标和 uni-app App-Plus 拆分选项。
+*/
+function configureLogger(options = {}) {
+	activeDefaultLogger = createLogger(options);
+}
+/** 默认使用 `Fast` 前缀和 `debug` 级别、可通过 {@link configureLogger} 配置的便捷日志器。 */
+const logger = {
+	debug: (scope, ...content) => {
+		activeDefaultLogger.debug(scope, ...content);
+	},
+	log: (scope, ...content) => {
+		activeDefaultLogger.log(scope, ...content);
+	},
+	warn: (scope, ...content) => {
+		activeDefaultLogger.warn(scope, ...content);
+	},
+	error: (scope, ...content) => {
+		activeDefaultLogger.error(scope, ...content);
+	}
+};
 //#endregion
-export { createLogger, logger };
+export { configureLogger, createLogger, logger };
 
 //# sourceMappingURL=index.mjs.map

package/dist/logger/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/logger/index.ts"],"sourcesContent":["/** 日志严重级别，按从低到高排列。 */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\n/** 日志输出目标需要实现的最小控制台接口。 */\nexport interface LoggerSink {\n\t/**\n\t * 接收通过级别过滤后的调试参数。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\tdebug: (...data: unknown[]) => void;\n\t/**\n\t * 接收通过级别过滤后的普通信息参数；对应 Logger 的 `info` 级别。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\tlog: (...data: unknown[]) => void;\n\t/**\n\t * 接收通过级别过滤后的警告参数。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\twarn: (...data: unknown[]) => void;\n\t/**\n\t * 接收通过级别过滤后的错误参数。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\terror: (...data: unknown[]) => void;\n}\n\n/** {@link createLogger} 的不可变配置。 */\nexport interface LoggerOptions {\n\t/** 最低输出级别，默认 `info`；低于该优先级的消息不会传给 Sink。 */\n\tlevel?: LogLevel;\n\t/** 日志品牌前缀，默认 `Fast`；必须是无外围空白的非空字符串。 */\n\tprefix?: string;\n\t/** 可注入输出目标，默认当前运行时的 `console`；Logger 不会修改该对象。 */\n\tsink?: LoggerSink;\n\t/** uni-app App-Plus/HBuilderX 中把附加参数逐条转成单行文本输出，默认 `false`；其他平台忽略。 */\n\tuniAppPlusSplit?: boolean;\n}\n\n/** 配置隔离、无全局可变状态的轻量日志器。 */\nexport interface Logger {\n\t/**\n\t * 输出指定作用域的调试信息。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param message - 主消息文本。\n\t * @param data - 保持原始类型的附加值。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\tdebug: (scope: string, message: string, ...data: unknown[]) => void;\n\t/**\n\t * 输出指定作用域的普通信息。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param message - 主消息文本。\n\t * @param data - 保持原始类型的附加值。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\tinfo: (scope: string, message: string, ...data: unknown[]) => void;\n\t/**\n\t * 输出指定作用域的警告信息。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param message - 主消息文本。\n\t * @param data - 保持原始类型的附加值。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\twarn: (scope: string, message: string, ...data: unknown[]) => void;\n\t/**\n\t * 输出指定作用域的错误信息。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param message - 主消息文本。\n\t * @param data - 保持原始类型的附加值。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\terror: (scope: string, message: string, ...data: unknown[]) => void;\n}\n\nconst levelPriority: Readonly<Record<LogLevel, number>> = {\n\tdebug: 10,\n\tinfo: 20,\n\twarn: 30,\n\terror: 40,\n};\n\n/**\n * 判断未知值是否为受支持日志级别。\n *\n * @param value - 待检查配置值。\n * @returns 值是 `debug`、`info`、`warn` 或 `error` 时返回 `true`。\n */\nconst isLogLevel = (value: unknown): value is LogLevel => typeof value === \"string\" && Object.hasOwn(levelPriority, value);\n\n/**\n * 检测 uni-app App-Plus 日志环境。\n *\n * @returns 全局 `uni` 与 `plus` 同时存在时返回 `true`。\n */\nconst isUniAppPlus = (): boolean => {\n\treturn Reflect.get(globalThis, \"uni\") !== undefined && Reflect.get(globalThis, \"plus\") !== undefined;\n};\n\n/**\n * 把日志附加值转换为适合 HBuilderX 单行输出的文本。\n *\n * @remarks 循环引用会替换为 `[Circular]`，BigInt 保留 `n` 后缀，Error 优先输出堆栈。\n * @param value - 任意日志附加值。\n * @returns 不会因 JSON 序列化失败而中断日志调用的文本。\n */\nconst formatSplitValue = (value: unknown): string => {\n\tif (typeof value === \"string\") return value;\n\tif (typeof value === \"bigint\") return `${value.toString()}n`;\n\tif (value instanceof Error) return value.stack ?? `${value.name}: ${value.message}`;\n\tconst visited = new WeakSet();\n\ttry {\n\t\tconst serialized: unknown = JSON.stringify(\n\t\t\tvalue,\n\t\t\t(_key, item: unknown): unknown => {\n\t\t\t\tif (typeof item === \"bigint\") return `${item.toString()}n`;\n\t\t\t\tif (typeof item !== \"object\" || item === null) return item;\n\t\t\t\tif (visited.has(item)) return \"[Circular]\";\n\t\t\t\tvisited.add(item);\n\t\t\t\treturn item;\n\t\t\t},\n\t\t\t2\n\t\t);\n\t\treturn typeof serialized === \"string\" ? serialized : String(value);\n\t} catch {\n\t\treturn String(value);\n\t}\n};\n\nconst defaultConsoleSink: LoggerSink = {\n\tdebug: (...data): void => {\n\t\tif (typeof console.debug === \"function\") console.debug(...data);\n\t\telse console.log(...data);\n\t},\n\tlog: (...data): void => {\n\t\tconsole.log(...data);\n\t},\n\twarn: (...data): void => {\n\t\tconsole.warn(...data);\n\t},\n\terror: (...data): void => {\n\t\tconsole.error(...data);\n\t},\n};\n\n/**\n * 创建独立日志器。\n *\n * @remarks 本库其他模块不会自动记录、吞掉或转换异常。日志内容可能进入持久化平台，\n * 调用方不得传入密码、令牌、密钥或完整个人数据。\n * @param options - 级别、前缀、输出目标和 uni-app App-Plus 拆分选项。\n * @returns 不会修改全局控制台或其他日志器配置的新实例。\n * @throws `RangeError` 当级别未知，或前缀、作用域不是有效的非空字符串。\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n\tconst requestedLevel: unknown = options.level ?? \"info\";\n\tconst requestedPrefix: unknown = options.prefix ?? \"Fast\";\n\tconst sink = options.sink ?? defaultConsoleSink;\n\tif (!isLogLevel(requestedLevel)) throw new RangeError(`未知的日志级别：${String(requestedLevel)}。`);\n\tif (typeof requestedPrefix !== \"string\" || requestedPrefix.length === 0) {\n\t\tthrow new RangeError(\"日志前缀必须是非空字符串。\");\n\t}\n\tconst level = requestedLevel;\n\tconst prefix = requestedPrefix;\n\tconst uniAppPlusSplit = options.uniAppPlusSplit ?? false;\n\n\t/**\n\t * 应用级别过滤、标题格式和平台输出策略。\n\t *\n\t * @param messageLevel - 本条消息的严重级别。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param message - 主消息文本。\n\t * @param data - 保持原始类型的附加值。\n\t * @throws `RangeError` 当作用域不是非空字符串或包含外围空白。\n\t */\n\tconst write = (messageLevel: LogLevel, scope: string, message: string, data: readonly unknown[]): void => {\n\t\tif (typeof scope !== \"string\") throw new TypeError(\"日志作用域必须是字符串。\");\n\t\tif (scope.length === 0 || scope.trim() !== scope) {\n\t\t\tthrow new RangeError(\"日志作用域必须是无外围空白的非空字符串。\");\n\t\t}\n\t\tif (levelPriority[messageLevel] < levelPriority[level]) return;\n\t\tconst heading = `[${prefix}:${scope}]`;\n\t\tconst sinkMethod: keyof LoggerSink = messageLevel === \"info\" ? \"log\" : messageLevel;\n\t\tif (uniAppPlusSplit && isUniAppPlus()) {\n\t\t\tsink[sinkMethod](`${heading} ${message}`);\n\t\t\tfor (const item of data) sink[sinkMethod](formatSplitValue(item));\n\t\t\treturn;\n\t\t}\n\t\tsink[sinkMethod](heading, message, ...data);\n\t};\n\n\treturn {\n\t\tdebug: (scope, message, ...data): void => {\n\t\t\twrite(\"debug\", scope, message, data);\n\t\t},\n\t\tinfo: (scope, message, ...data): void => {\n\t\t\twrite(\"info\", scope, message, data);\n\t\t},\n\t\twarn: (scope, message, ...data): void => {\n\t\t\twrite(\"warn\", scope, message, data);\n\t\t},\n\t\terror: (scope, message, ...data): void => {\n\t\t\twrite(\"error\", scope, message, data);\n\t\t},\n\t};\n}\n\n/** 默认使用 `Fast` 前缀和 `info` 级别的便捷日志器。 */\nexport const logger: Logger = createLogger();\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/logger/index.ts"],"sourcesContent":["/** 日志严重级别，按从低到高排列。 */\nexport type LogLevel = \"debug\" | \"log\" | \"warn\" | \"error\";\n\n/** 日志输出目标需要实现的最小控制台接口。 */\nexport interface LoggerSink {\n\t/**\n\t * 接收通过级别过滤后的调试参数。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\tdebug: (...data: unknown[]) => void;\n\t/**\n\t * 接收通过级别过滤后的普通日志参数；对应 Logger 的 `log` 级别。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\tlog: (...data: unknown[]) => void;\n\t/**\n\t * 接收通过级别过滤后的警告参数。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\twarn: (...data: unknown[]) => void;\n\t/**\n\t * 接收通过级别过滤后的错误参数。\n\t * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。\n\t */\n\terror: (...data: unknown[]) => void;\n}\n\n/** {@link createLogger} 的不可变配置。 */\nexport interface LoggerOptions {\n\t/** 最低输出级别，默认 `debug`；低于该优先级的消息不会传给 Sink。 */\n\tlevel?: LogLevel;\n\t/** 日志品牌前缀，默认 `Fast`；必须是无外围空白的非空字符串。 */\n\tprefix?: string;\n\t/** 可注入输出目标，默认当前运行时的 `console`；Logger 不会修改该对象。 */\n\tsink?: LoggerSink;\n\t/** uni-app App-Plus/HBuilderX 中把附加参数逐条转成单行文本输出，默认 `false`；其他平台忽略。 */\n\tuniAppPlusSplit?: boolean;\n}\n\n/** 配置隔离的轻量日志器。 */\nexport interface Logger {\n\t/**\n\t * 输出指定作用域的调试信息或数据。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param content - 可选的消息与附加值；非字符串值保持原始类型。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\tdebug: (scope: string, ...content: unknown[]) => void;\n\t/**\n\t * 输出指定作用域的普通信息或数据。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param content - 可选的消息与附加值；非字符串值保持原始类型。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\tlog: (scope: string, ...content: unknown[]) => void;\n\t/**\n\t * 输出指定作用域的警告信息或数据。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param content - 可选的消息与附加值；非字符串值保持原始类型。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\twarn: (scope: string, ...content: unknown[]) => void;\n\t/**\n\t * 输出指定作用域的错误信息或数据。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param content - 可选的消息与附加值；非字符串值保持原始类型。\n\t * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。\n\t */\n\terror: (scope: string, ...content: unknown[]) => void;\n}\n\nconst levelPriority: Readonly<Record<LogLevel, number>> = {\n\tdebug: 10,\n\tlog: 20,\n\twarn: 30,\n\terror: 40,\n};\n\n/**\n * 判断未知值是否为受支持日志级别。\n *\n * @param value - 待检查配置值。\n * @returns 值是 `debug`、`log`、`warn` 或 `error` 时返回 `true`。\n */\nconst isLogLevel = (value: unknown): value is LogLevel => typeof value === \"string\" && Object.hasOwn(levelPriority, value);\n\n/**\n * 检测 uni-app App-Plus 日志环境。\n *\n * @returns 全局 `uni` 与 `plus` 同时存在时返回 `true`。\n */\nconst isUniAppPlus = (): boolean => {\n\treturn Reflect.get(globalThis, \"uni\") !== undefined && Reflect.get(globalThis, \"plus\") !== undefined;\n};\n\n/**\n * 把日志附加值转换为适合 HBuilderX 单行输出的文本。\n *\n * @remarks 循环引用会替换为 `[Circular]`，BigInt 保留 `n` 后缀，Error 优先输出堆栈。\n * @param value - 任意日志附加值。\n * @returns 不会因 JSON 序列化失败而中断日志调用的文本。\n */\nconst formatSplitValue = (value: unknown): string => {\n\tif (typeof value === \"string\") return value;\n\tif (typeof value === \"bigint\") return `${value.toString()}n`;\n\tif (value instanceof Error) return value.stack ?? `${value.name}: ${value.message}`;\n\tconst visited = new WeakSet();\n\ttry {\n\t\tconst serialized: unknown = JSON.stringify(\n\t\t\tvalue,\n\t\t\t(_key, item: unknown): unknown => {\n\t\t\t\tif (typeof item === \"bigint\") return `${item.toString()}n`;\n\t\t\t\tif (typeof item !== \"object\" || item === null) return item;\n\t\t\t\tif (visited.has(item)) return \"[Circular]\";\n\t\t\t\tvisited.add(item);\n\t\t\t\treturn item;\n\t\t\t},\n\t\t\t2\n\t\t);\n\t\treturn typeof serialized === \"string\" ? serialized : String(value);\n\t} catch {\n\t\treturn String(value);\n\t}\n};\n\nconst defaultConsoleSink: LoggerSink = {\n\tdebug: (...data): void => {\n\t\tif (typeof console.debug === \"function\") console.debug(...data);\n\t\telse console.log(...data);\n\t},\n\tlog: (...data): void => {\n\t\tconsole.log(...data);\n\t},\n\twarn: (...data): void => {\n\t\tconsole.warn(...data);\n\t},\n\terror: (...data): void => {\n\t\tconsole.error(...data);\n\t},\n};\n\n/**\n * 创建独立日志器。\n *\n * @remarks 本库其他模块不会自动记录、吞掉或转换异常。日志内容可能进入持久化平台，\n * 调用方不得传入密码、令牌、密钥或完整个人数据。\n * @param options - 级别、前缀、输出目标和 uni-app App-Plus 拆分选项。\n * @returns 不会修改全局控制台或其他日志器配置的新实例。\n * @throws `RangeError` 当级别未知，或前缀、作用域不是有效的非空字符串。\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n\tconst requestedLevel: unknown = options.level ?? \"debug\";\n\tconst requestedPrefix: unknown = options.prefix ?? \"Fast\";\n\tconst sink = options.sink ?? defaultConsoleSink;\n\tif (!isLogLevel(requestedLevel)) throw new RangeError(`未知的日志级别：${String(requestedLevel)}。`);\n\tif (typeof requestedPrefix !== \"string\" || requestedPrefix.length === 0) {\n\t\tthrow new RangeError(\"日志前缀必须是非空字符串。\");\n\t}\n\tconst level = requestedLevel;\n\tconst prefix = requestedPrefix;\n\tconst uniAppPlusSplit = options.uniAppPlusSplit ?? false;\n\n\t/**\n\t * 应用级别过滤、标题格式和平台输出策略。\n\t *\n\t * @param messageLevel - 本条消息的严重级别。\n\t * @param scope - 模块、组件或业务来源名称。\n\t * @param content - 可选的消息与保持原始类型的附加值。\n\t * @throws `RangeError` 当作用域不是非空字符串或包含外围空白。\n\t */\n\tconst write = (messageLevel: LogLevel, scope: string, content: readonly unknown[]): void => {\n\t\tif (typeof scope !== \"string\") throw new TypeError(\"日志作用域必须是字符串。\");\n\t\tif (scope.length === 0 || scope.trim() !== scope) {\n\t\t\tthrow new RangeError(\"日志作用域必须是无外围空白的非空字符串。\");\n\t\t}\n\t\tif (levelPriority[messageLevel] < levelPriority[level]) return;\n\t\tconst heading = `[${prefix}:${scope}]`;\n\t\tconst sinkMethod: keyof LoggerSink = messageLevel;\n\t\tif (uniAppPlusSplit && isUniAppPlus()) {\n\t\t\tconst [first, ...remaining] = content;\n\t\t\tif (typeof first === \"string\") {\n\t\t\t\tsink[sinkMethod](`${heading} ${first}`);\n\t\t\t\tfor (const item of remaining) sink[sinkMethod](formatSplitValue(item));\n\t\t\t} else {\n\t\t\t\tsink[sinkMethod](heading);\n\t\t\t\tfor (const item of content) sink[sinkMethod](formatSplitValue(item));\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tsink[sinkMethod](heading, ...content);\n\t};\n\n\treturn {\n\t\tdebug: (scope, ...content): void => {\n\t\t\twrite(\"debug\", scope, content);\n\t\t},\n\t\tlog: (scope, ...content): void => {\n\t\t\twrite(\"log\", scope, content);\n\t\t},\n\t\twarn: (scope, ...content): void => {\n\t\t\twrite(\"warn\", scope, content);\n\t\t},\n\t\terror: (scope, ...content): void => {\n\t\t\twrite(\"error\", scope, content);\n\t\t},\n\t};\n}\n\nlet activeDefaultLogger: Logger = createLogger();\n\n/**\n * 替换默认 {@link logger} 的完整配置。\n *\n * @remarks 已创建的独立 Logger 不受影响；默认 Logger 对象引用保持稳定，并立即转发到新配置。\n * 省略选项会恢复 `createLogger()` 的全部默认值。\n * @param options - 默认 Logger 使用的级别、前缀、输出目标和 uni-app App-Plus 拆分选项。\n */\nexport function configureLogger(options: LoggerOptions = {}): void {\n\tactiveDefaultLogger = createLogger(options);\n}\n\n/** 默认使用 `Fast` 前缀和 `debug` 级别、可通过 {@link configureLogger} 配置的便捷日志器。 */\nexport const logger: Logger = {\n\tdebug: (scope, ...content): void => {\n\t\tactiveDefaultLogger.debug(scope, ...content);\n\t},\n\tlog: (scope, ...content): void => {\n\t\tactiveDefaultLogger.log(scope, ...content);\n\t},\n\twarn: (scope, ...content): void => {\n\t\tactiveDefaultLogger.warn(scope, ...content);\n\t},\n\terror: (scope, ...content): void => {\n\t\tactiveDefaultLogger.error(scope, ...content);\n\t},\n};\n"],"mappings":"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"}

package/dist/storage/index.d.mts

@@ -27,8 +27,16 @@ interface StorageConfiguration {
   /** 所有物理键使用的非空命名空间前缀； */
   prefix?: string;
 }
+/** 单次 Storage 读取配置。 */
+interface StorageReadOptions {
+  /**
+   * 仅覆盖本次读取使用的 Codec；`true` 使用 Base64 混淆，`false` 使用 JSON，省略时使用全局配置。
+   * 必须与写入该条目时使用的单次设置一致。
+   */
+  crypto?: boolean;
+}
 /** 单次 Storage 写入配置。 */
-interface StorageWriteOptions {
+interface StorageWriteOptions extends StorageReadOptions {
   /** 从写入时刻开始的有效毫秒数；必须是大于 0 的有限数，省略时永久有效。 */
   ttlMs?: number;
 }
@@ -44,10 +52,11 @@ interface StorageArea {
   /**
    * 获取并解码业务值；已过期记录会在读取时删除。
    * @param key - 不含全局前缀的非空业务键。
-   * @returns 解码后的值；键缺失或过期时返回 `undefined`。
+   * @param options - 可选的单次 Base64 混淆开关；必须与写入时一致。
+   * @returns 解码后的值；未传泛型时静态类型默认为 `string`，键缺失或过期时返回 `undefined`。
    * @throws 当键非法、包络损坏、Codec 解码失败或后端不可用时抛出错误。
    */
-  get: <Value = unknown>(key: string) => Value | undefined;
+  get: <Value = string>(key: string, options?: StorageReadOptions) => Value | undefined;
   /**
    * 判断一个可成功读取且未过期的业务键是否存在。
    * @param key - 不含全局前缀的非空业务键。
@@ -79,7 +88,7 @@ interface StorageArea {
    * 编码并写入业务值，可附加惰性清理的 TTL。
    * @param key - 不含全局前缀的非空业务键。
    * @param value - 必须受当前 Codec 支持的业务值。
-   * @param options - 可选的单次写入 TTL。
+   * @param options - 可选的单次写入 TTL 与 Base64 混淆开关。
    * @throws 当键、TTL、业务值或后端写入无效时抛出错误。
    */
   set: <Value>(key: string, value: Value, options?: StorageWriteOptions) => void;
@@ -103,5 +112,5 @@ declare function configureStorage(options?: StorageConfiguration): void;
 /** 返回全局 Storage 是否已经由应用入口配置。 */
 declare function isStorageConfigured(): boolean;
 //#endregion
-export { Local, Session, StorageArea, StorageCodec, StorageConfiguration, StorageWriteOptions, base64StorageCodec, configureStorage, isStorageConfigured };
+export { Local, Session, StorageArea, StorageCodec, StorageConfiguration, StorageReadOptions, StorageWriteOptions, base64StorageCodec, configureStorage, isStorageConfigured };
 //# sourceMappingURL=index.d.mts.map

package/dist/storage/index.mjs

@@ -25,7 +25,7 @@ const jsonCodec = {
 };
 /** Base64 混淆 Codec；只隐藏明文外观，不提供加密、完整性或认证。 */
 const base64StorageCodec = {
-	decode: (value) => JSON.parse(decodeSecureBase64(value)),
+	decode: (value) => decodeSecureBase64(value).parseJson(),
 	encode: (value) => {
 		const encoded = JSON.stringify(value);
 		if (typeof encoded !== "string") throw new TypeError("存储值无法序列化为 JSON。");
@@ -140,6 +140,18 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 	*/
 	const toStorageKey = (key) => `${prefix}${key}`;
 	/**
+	* 解析本次读写实际使用的 Codec。
+	*
+	* @param crypto - 单次 Base64 混淆开关；省略时沿用 Area 全局 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` 选项必须是布尔值。");
+		return crypto ? base64StorageCodec : jsonCodec;
+	};
+	/**
 	* 枚举当前命名空间中的业务键。
 	*
 	* @param backend - 本次操作使用的后端。
@@ -178,11 +190,11 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 			const backend = backendFactory();
 			for (const key of listBusinessKeys(backend)) backend.removeItem(toStorageKey(key));
 		},
-		get(key) {
+		get(key, options = {}) {
 			const envelope = readStoredEnvelope(backendFactory(), key);
 			if (envelope === void 0) return void 0;
 			try {
-				return codec.decode(envelope.data);
+				return resolveOperationCodec(options.crypto).decode(envelope.data);
 			} catch (cause) {
 				throw new TypeError(`无法解码 Storage 条目“${toStorageKey(key)}”。`, { cause });
 			}
@@ -219,7 +231,7 @@ const createStorageArea = (backendFactory, prefix, codec, now) => {
 			}
 			let data;
 			try {
-				data = codec.encode(value);
+				data = resolveOperationCodec(options.crypto).encode(value);
 				if (typeof data !== "string") throw new TypeError("Storage Codec 必须返回字符串。");
 			} catch (cause) {
 				throw new TypeError("无法编码存储值。", { cause });
@@ -268,7 +280,7 @@ const createStorageAreaProxy = (select, name) => {
 		clear: () => {
 			getArea().clear();
 		},
-		get: (key) => getArea().get(key),
+		get: (key, options) => getArea().get(key, options),
 		has: (key) => getArea().has(key),
 		keys: () => getArea().keys(),
 		pruneExpired: () => getArea().pruneExpired(),