befly 3.10.12 → 3.10.13

package/befly.config.ts

@@ -26,7 +26,9 @@ const defaultOptions: BeflyOptions = {
         excludeFields: ["password", "token", "secret"],
         dir: "./logs",
         console: 1,
-        maxSize: 10485760 // 10MB
+        maxSize: 10485760, // 10MB
+        maxStringLen: 100,
+        maxArrayItems: 100
     },
 
     // ========== 数据库配置 ==========

package/lib/dbHelper.ts

@@ -185,14 +185,13 @@ export class DbHelper {
             const duration = Date.now() - startTime;
 
             if (this.debug === 1) {
-                const sqlPreview = sqlStr.length > 500 ? sqlStr.substring(0, 500) + "..." : sqlStr;
-
-                Logger.info(
+                Logger.debug(
                     {
                         subsystem: "db",
-                        event: "query",
+                        event: "db_sql",
+                        dbEvent: "query",
                         duration: duration,
-                        sqlPreview: sqlPreview,
+                        sqlPreview: sqlStr,
                         paramsCount: (params || []).length,
                         params: params || []
                     },
@@ -205,7 +204,8 @@ export class DbHelper {
                 Logger.warn(
                     {
                         subsystem: "db",
-                        event: "slow",
+                        event: "db_sql",
+                        dbEvent: "slow",
                         duration: duration,
                         sqlPreview: sqlStr,
                         params: params || [],
@@ -218,12 +218,13 @@ export class DbHelper {
             return result;
         } catch (error: any) {
             const duration = Date.now() - startTime;
-
-            const sqlPreview = sqlStr.length > 200 ? sqlStr.substring(0, 200) + "..." : sqlStr;
             Logger.error(
                 {
+                    subsystem: "db",
+                    event: "db_sql",
+                    dbEvent: "error",
                     err: error,
-                    sqlPreview: sqlPreview,
+                    sqlPreview: sqlStr,
                     params: params || [],
                     duration: duration
                 },

package/lib/logger.ts

@@ -19,8 +19,11 @@ import { getCtx } from "./asyncContext.js";
 // 为避免相对路径的 logs 目录随着 cwd 变化，使用模块加载时的初始 cwd 作为锚点。
 const INITIAL_CWD = process.cwd();
 
-const MAX_LOG_STRING_LEN = 100;
-const MAX_LOG_ARRAY_ITEMS = 100;
+const DEFAULT_LOG_STRING_LEN = 100;
+const DEFAULT_LOG_ARRAY_ITEMS = 100;
+
+let maxLogStringLen = DEFAULT_LOG_STRING_LEN;
+let maxLogArrayItems = DEFAULT_LOG_ARRAY_ITEMS;
 
 // 为避免递归导致栈溢出/性能抖动：使用非递归遍历，并对深度/节点数做硬限制。
 // 说明：这不是业务数据结构的“真实深度”，而是日志清洗的最大深入层级（越大越重）。
@@ -145,6 +148,10 @@ export function configure(cfg: LoggerConfig): void {
     sanitizeNodesLimit = normalizePositiveInt(config.sanitizeNodes, DEFAULT_LOG_SANITIZE_NODES, 50, 20000);
     sanitizeObjectKeysLimit = normalizePositiveInt(config.sanitizeObjectKeys, DEFAULT_LOG_OBJECT_KEYS, 10, 5000);
 
+    // 运行时截断上限（可配置）
+    maxLogStringLen = normalizePositiveInt(config.maxStringLen, DEFAULT_LOG_STRING_LEN, 20, 200000);
+    maxLogArrayItems = normalizePositiveInt(config.maxArrayItems, DEFAULT_LOG_ARRAY_ITEMS, 10, 5000);
+
     // 仅支持数组配置：excludeFields?: string[]
     const userPatterns = Array.isArray(config.excludeFields) ? config.excludeFields : [];
     const patterns = [...BUILTIN_SENSITIVE_KEYS, ...userPatterns]
@@ -325,9 +332,9 @@ function getErrorLogger(): pino.Logger {
 }
 
 function truncateString(val: string, stats: Record<string, number>): string {
-    if (val.length <= MAX_LOG_STRING_LEN) return val;
+    if (val.length <= maxLogStringLen) return val;
     stats.truncatedStrings = (stats.truncatedStrings || 0) + 1;
-    return val.slice(0, MAX_LOG_STRING_LEN);
+    return val.slice(0, maxLogStringLen);
 }
 
 function isSensitiveKey(key: string): boolean {
@@ -518,15 +525,15 @@ function sanitizeValueLimited(val: any, visited: WeakSet<object>, stats: Record<
         if (Array.isArray(frame.src)) {
             const arr = frame.src as any[];
             const len = arr.length;
-            const limit = len > MAX_LOG_ARRAY_ITEMS ? MAX_LOG_ARRAY_ITEMS : len;
+            const limit = len > maxLogArrayItems ? maxLogArrayItems : len;
 
             for (let i = 0; i < limit; i++) {
                 tryAssign(frame.dst, i, arr[i], frame.depth);
             }
 
-            if (len > MAX_LOG_ARRAY_ITEMS) {
+            if (len > maxLogArrayItems) {
                 stats.arraysTruncated = (stats.arraysTruncated || 0) + 1;
-                stats.arrayItemsOmitted = (stats.arrayItemsOmitted || 0) + (len - MAX_LOG_ARRAY_ITEMS);
+                stats.arrayItemsOmitted = (stats.arrayItemsOmitted || 0) + (len - maxLogArrayItems);
             }
 
             continue;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly",
-    "version": "3.10.12",
-    "gitHead": "9c9fd0cd8165bb5b4025e538a3c5fb228acb39cd",
+    "version": "3.10.13",
+    "gitHead": "391e4e5cacb1d46cf37b5aa1179c9fe0a602337d",
     "private": false,
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "keywords": [

package/types/logger.d.ts

@@ -28,6 +28,21 @@ export interface LoggerConfig {
     /** 单个日志文件最大大小 (MB) @default 10 */
     maxSize?: number;
 
+    /**
+     * 字符串最大长度（超过会被截断）
+     * - 影响所有结构化字段中的 string（包括 db.debug 打印的 sqlPreview）
+     * - 生产环境建议保持较小值；需要更完整 SQL 时可在开发环境调大
+     * @default 100
+     */
+    maxStringLen?: number;
+
+    /**
+     * 数组最多保留的元素数量（超出部分丢弃）
+     * - 仅影响结构化日志清洗（数组裁剪）
+     * @default 100
+     */
+    maxArrayItems?: number;
+
     /**
      * 结构化日志清洗：最大清洗深度（非递归遍历的 depth 上限）
      * - 值越大，日志更“完整”，但 CPU/内存开销更高