@ubean/shared 0.5.0 → 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/dist/node.d.ts

@@ -37,4 +37,15 @@ export declare function sleep(ms: number): Promise<void>;
  * 返回找到的第一个文件的完整路径,如果都不存在则返回 null。
  */
 export declare function findUserViteConfig(cwd: string): string | null;
+//#endregion
+//#region src/network.d.ts
+/** 仅回环可达的 host（监听这些地址时局域网无法访问，不展示 Network 行）。 */
+export declare function isLoopbackHost(host: string): boolean;
+/** 通配绑定（监听所有网卡）。 */
+export declare function isWildcardHost(host: string): boolean;
+/**
+ * 本机局域网 IPv4 地址（`os.networkInterfaces()` 去掉 internal，按网卡名排序保证稳定输出）。
+ * 仅返回 IPv4 —— IPv6 全局地址通常携带临时/隐私扩展后缀，逐条展示噪音大于价值。
+ */
+export declare function getLanAddresses(): string[];
 //#endregion

package/dist/node.js

@@ -1,6 +1,7 @@
 import { createConnection, createServer } from "node:net";
 import { existsSync } from "node:fs";
 import { join } from "pathe";
+import { networkInterfaces } from "node:os";
 //#region src/port.ts
 /**
 * Tries to listen on `port` at `host`. If the port is already in use and
@@ -89,4 +90,27 @@ function findUserViteConfig(cwd) {
 	return null;
 }
 //#endregion
-export { findAvailablePort, findUserViteConfig, isPortReachable, sleep, waitForPort };
+//#region src/network.ts
+/** 仅回环可达的 host（监听这些地址时局域网无法访问，不展示 Network 行）。 */
+function isLoopbackHost(host) {
+	return host === "localhost" || host === "127.0.0.1" || host === "::1";
+}
+/** 通配绑定（监听所有网卡）。 */
+function isWildcardHost(host) {
+	return host === "0.0.0.0" || host === "::" || host === "";
+}
+/**
+* 本机局域网 IPv4 地址（`os.networkInterfaces()` 去掉 internal，按网卡名排序保证稳定输出）。
+* 仅返回 IPv4 —— IPv6 全局地址通常携带临时/隐私扩展后缀，逐条展示噪音大于价值。
+*/
+function getLanAddresses() {
+	const addresses = [];
+	const byInterface = networkInterfaces();
+	for (const name of Object.keys(byInterface).sort()) for (const net of byInterface[name] || []) {
+		if (net.internal || net.family !== "IPv4") continue;
+		if (!addresses.includes(net.address)) addresses.push(net.address);
+	}
+	return addresses;
+}
+//#endregion
+export { findAvailablePort, findUserViteConfig, getLanAddresses, isLoopbackHost, isPortReachable, isWildcardHost, sleep, waitForPort };

package/package.json

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