@ubean/shared 0.5.1 → 0.5.2

package/dist/logger/hono.js

@@ -1,4 +1,4 @@
-import { n as getLogger } from "../logger-C9j4b6yh.js";
+import { n as getLogger } from "../logger-NMOHjTCB.js";
 //#region src/logger/hono.ts
 /**
 * 判断路径是否应被跳过。

package/dist/logger/index.d.ts

@@ -1,4 +1,5 @@
 import { i as UbeanLoggerOptions, n as RequestLoggerOptions, r as UbeanLogger, t as LogLevelName } from "../types-CFy62PZV.js";
+import { TLogLevel } from "tslog";
 //#region src/logger/logger.d.ts
 /**
  * 创建一个 ubean 命名的 tslog logger(默认 name 为 `ubean`)。
@@ -45,5 +46,22 @@ export declare function getLogger(scope?: string, options?: UbeanLoggerOptions):
  * ```
  */
 export declare function setDebugLogging(enabled: boolean): void;
+/**
+ * 设置全局日志级别(对已创建与后续创建的所有 logger 实例生效)。
+ *
+ * 供 CLI 在加载 `logging.level` 配置后调用,覆盖 `LOG_LEVEL`/`TSLOG_LEVEL` 环境
+ * 变量的既有效果。传入 `undefined` 为空操作(不覆盖环境变量语义)。
+ *
+ * 注意:必须走 tslog 实例的 `setMinLevel()` 方法 —— 它会把级别名归一化为数字 id
+ * (`tslog` 内部用数值比较过滤);直接改写 `settings.minLevel` 字符串会让比较失真。
+ * tslog 的级别名解析大小写不敏感,这里统一大写仅为通过其类型签名。
+ *
+ * @example
+ * ```ts
+ * const config = await loadUbeanConfig(cwd);
+ * if (config.logging.level) setMinLevel(config.logging.level);
+ * ```
+ */
+export declare function setMinLevel(level: LogLevelName | TLogLevel | undefined): void;
 //#endregion
 export type { LogLevelName, RequestLoggerOptions, UbeanLogger, UbeanLoggerOptions };

package/dist/logger/index.js

@@ -1,2 +1,2 @@
-import { i as setDebugLogging, n as getLogger, r as logger, t as createUbeanLogger } from "../logger-C9j4b6yh.js";
-export { createUbeanLogger, getLogger, logger, setDebugLogging };
+import { a as setMinLevel, i as setDebugLogging, n as getLogger, r as logger, t as createUbeanLogger } from "../logger-NMOHjTCB.js";
+export { createUbeanLogger, getLogger, logger, setDebugLogging, setMinLevel };

package/dist/{logger-C9j4b6yh.js → logger-NMOHjTCB.js}

@@ -15,6 +15,11 @@ const DEBUG_PRETTY_TEMPLATE = "{{yyyy}}.{{mm}}.{{dd}} {{hh}}:{{MM}}:{{ss}}	{{log
 const DEFAULT_MIN_LEVEL = "INFO";
 /** 是否处于 debug 模式(输出详细模板) */
 let debugMode = false;
+/**
+* 配置文件显式指定的日志级别(`logging.level`,归一化为大写)。
+* 优先级:logger 显式 `minLevel` > 此配置 > `LOG_LEVEL`/`TSLOG_LEVEL` 环境变量 > `info`。
+*/
+let configuredMinLevel;
 /** 已创建的 logger 实例注册表,`setDebugLogging` 切换模板时统一更新(含子 logger) */
 const instances = /* @__PURE__ */ new Set();
 function registerInstance(instance) {
@@ -79,7 +84,7 @@ function getLogLevelFromEnv() {
 * ```
 */
 function createUbeanLogger(options = {}) {
-	const minLevel = options.minLevel ?? getLogLevelFromEnv() ?? DEFAULT_MIN_LEVEL;
+	const minLevel = options.minLevel ?? configuredMinLevel ?? getLogLevelFromEnv() ?? DEFAULT_MIN_LEVEL;
 	return registerInstance(new Logger({
 		name: DEFAULT_NAME,
 		...options,
@@ -130,5 +135,27 @@ function setDebugLogging(enabled) {
 	debugMode = enabled;
 	for (const instance of instances) applyDebugMode(instance);
 }
+/**
+* 设置全局日志级别(对已创建与后续创建的所有 logger 实例生效)。
+*
+* 供 CLI 在加载 `logging.level` 配置后调用,覆盖 `LOG_LEVEL`/`TSLOG_LEVEL` 环境
+* 变量的既有效果。传入 `undefined` 为空操作(不覆盖环境变量语义)。
+*
+* 注意:必须走 tslog 实例的 `setMinLevel()` 方法 —— 它会把级别名归一化为数字 id
+* (`tslog` 内部用数值比较过滤);直接改写 `settings.minLevel` 字符串会让比较失真。
+* tslog 的级别名解析大小写不敏感,这里统一大写仅为通过其类型签名。
+*
+* @example
+* ```ts
+* const config = await loadUbeanConfig(cwd);
+* if (config.logging.level) setMinLevel(config.logging.level);
+* ```
+*/
+function setMinLevel(level) {
+	if (!level || typeof level !== "string") return;
+	configuredMinLevel = level.toUpperCase();
+	const name = level.toUpperCase();
+	for (const instance of instances) instance.setMinLevel(name);
+}
 //#endregion
-export { setDebugLogging as i, getLogger as n, logger as r, createUbeanLogger as t };
+export { setMinLevel as a, setDebugLogging as i, getLogger as n, logger as r, createUbeanLogger as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/shared",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Shared protocol types, errors, env and universal utilities for ubean",
   "files": [
     "dist"