@ubean/shared 0.5.1 → 0.6.0-beta.1

package/dist/index.d.ts

@@ -399,6 +399,18 @@ export interface EnvValidationError {
 export declare function defineEnv<S extends EnvSchema>(config: EnvConfig<S>): DefineEnvResult<S>;
 export declare function setRuntimeEnv(env: Record<string, unknown>): void;
 export declare function useRuntimeEnv<T = string>(key: string, defaultValue?: T): T;
+/**
+ * 当前是否运行在 Node 系运行时（Node / Bun / Deno 的 node 兼容层）上。
+ *
+ * 用途：**把 Node 专用能力挡在动态 import 里**。Cloudflare Workers 这类运行时没有 `node:fs`
+ * （即使开 `nodejs_compat` 也不支持），而打包器会把「静态 import 的 node 内建」留在产物里 ——
+ * workerd 在**模块实例化**阶段就会失败（`No such module "node:fs/promises"`），根本轮不到分支
+ * 判断。因此判据必须是运行时的，且 `import()` 必须写在分支内部（动态 import 只在执行时才解析）。
+ *
+ * 判定用 `process.versions.node` 而不是 `typeof process`：bundler 常会把 `process` 替身注入浏览器
+ * 产物，只看 `process` 会在 worker/browser 里误判为真。
+ */
+export declare function isNodeRuntime(): boolean;
 //#endregion
 //#region src/path.d.ts
 /**

package/dist/index.js

@@ -252,6 +252,21 @@ function setRuntimeEnv(env) {
 function useRuntimeEnv(key, defaultValue) {
 	return _runtimeEnv[key] ?? defaultValue;
 }
+/**
+* 当前是否运行在 Node 系运行时（Node / Bun / Deno 的 node 兼容层）上。
+*
+* 用途：**把 Node 专用能力挡在动态 import 里**。Cloudflare Workers 这类运行时没有 `node:fs`
+* （即使开 `nodejs_compat` 也不支持），而打包器会把「静态 import 的 node 内建」留在产物里 ——
+* workerd 在**模块实例化**阶段就会失败（`No such module "node:fs/promises"`），根本轮不到分支
+* 判断。因此判据必须是运行时的，且 `import()` 必须写在分支内部（动态 import 只在执行时才解析）。
+*
+* 判定用 `process.versions.node` 而不是 `typeof process`：bundler 常会把 `process` 替身注入浏览器
+* 产物，只看 `process` 会在 worker/browser 里误判为真。
+*/
+function isNodeRuntime() {
+	const proc = globalThis.process;
+	return typeof proc?.versions?.node === "string" || typeof proc?.versions?.bun === "string";
+}
 //#endregion
 //#region src/string.ts
 /**
@@ -336,4 +351,4 @@ function matchAnyGlob(route, patterns) {
 	return patterns.some((p) => matchGlob(route, p));
 }
 //#endregion
-export { ACTION_BRAND, ActionError, UbeanError, capitalize, createError, defineEnv, errorToResponse, fail, getBasename, getDirname, getExtension, getStem, isActionFailure, isServerAction, isUbeanError, matchAnyGlob, matchGlob, normalizePath, pathToTitle, setRuntimeEnv, useRuntimeEnv };
+export { ACTION_BRAND, ActionError, UbeanError, capitalize, createError, defineEnv, errorToResponse, fail, getBasename, getDirname, getExtension, getStem, isActionFailure, isNodeRuntime, isServerAction, isUbeanError, matchAnyGlob, matchGlob, normalizePath, pathToTitle, setRuntimeEnv, useRuntimeEnv };

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.6.0-beta.1",
   "description": "Shared protocol types, errors, env and universal utilities for ubean",
   "files": [
     "dist"