befly 3.12.4 → 3.13.1

package/dist/hooks/parser.d.ts

@@ -1,3 +1,4 @@
+import type { Hook } from "../types/hook";
 /**
  * 请求参数解析钩子
  * - GET 请求：解析 URL 查询参数
@@ -5,10 +6,5 @@
  * - 根据 API 定义的 fields 过滤字段
  * - rawBody: true 时跳过解析，由 handler 自行处理原始请求
  */
-declare const _default: {
-    name: string;
-    enable: true;
-    deps: string[];
-    handler: (befly: import("../types/befly").BeflyContext, ctx: import("../types/context").RequestContext<Record<string, any>>) => Promise<void>;
-};
-export default _default;
+declare const parserHook: Hook;
+export default parserHook;

package/dist/hooks/parser.js

@@ -11,7 +11,7 @@ const xmlParser = new XMLParser();
  * - 根据 API 定义的 fields 过滤字段
  * - rawBody: true 时跳过解析，由 handler 自行处理原始请求
  */
-export default {
+const parserHook = {
     name: "parser",
     enable: true,
     deps: ["auth"],
@@ -90,3 +90,4 @@ export default {
         }
     }
 };
+export default parserHook;

package/dist/hooks/permission.d.ts

@@ -1,3 +1,4 @@
+import type { Hook } from "../types/hook";
 /**
  * 权限检查钩子
  * - 接口无需权限（auth=false）：直接通过
@@ -5,10 +6,5 @@
  * - 开发者角色（dev）：最高权限，直接通过
  * - 其他角色：检查 Redis 中的角色权限集合
  */
-declare const _default: {
-    name: string;
-    enable: true;
-    deps: string[];
-    handler: (befly: import("../types/befly").BeflyContext, ctx: import("../types/context").RequestContext<Record<string, any>>) => Promise<void>;
-};
-export default _default;
+declare const permissionHook: Hook;
+export default permissionHook;

package/dist/hooks/permission.js

@@ -9,7 +9,7 @@ import { ErrorResponse } from "../utils/response";
  * - 开发者角色（dev）：最高权限，直接通过
  * - 其他角色：检查 Redis 中的角色权限集合
  */
-export default {
+const permissionHook = {
     name: "permission",
     enable: true,
     deps: ["validator"],
@@ -46,8 +46,9 @@ export default {
                     event: "hook_permission_redis_error",
                     apiPath: apiPath,
                     roleCode: roleCode,
-                    err: err
-                }, "hook permission redis error");
+                    err: err,
+                    msg: "hook permission redis error"
+                });
                 hasPermission = false;
             }
         }
@@ -60,3 +61,4 @@ export default {
         }
     }
 };
+export default permissionHook;

package/dist/hooks/validator.d.ts

@@ -1,11 +1,7 @@
+import type { Hook } from "../types/hook";
 /**
  * 参数验证钩子
  * 根据 API 定义的 fields 和 required 验证请求参数
  */
-declare const _default: {
-    name: string;
-    enable: true;
-    deps: string[];
-    handler: (befly: import("../types/befly").BeflyContext, ctx: import("../types/context").RequestContext<Record<string, any>>) => Promise<void>;
-};
-export default _default;
+declare const validatorHook: Hook;
+export default validatorHook;

package/dist/hooks/validator.js

@@ -5,7 +5,7 @@ import { ErrorResponse } from "../utils/response";
  * 参数验证钩子
  * 根据 API 定义的 fields 和 required 验证请求参数
  */
-export default {
+const validatorHook = {
     name: "validator",
     enable: true,
     deps: ["parser"],
@@ -31,3 +31,4 @@ export default {
         }
     }
 };
+export default validatorHook;

package/dist/index.js

@@ -114,7 +114,7 @@ export class Befly {
                     return staticFetch(req);
                 },
                 error: (error) => {
-                    Logger.error({ err: error }, "服务启动时发生错误");
+                    Logger.error({ err: error, msg: "服务启动时发生错误" });
                     // 开发模式下返回详细错误信息
                     if (this.config.nodeEnv === "development") {
                         return Response.json({
@@ -142,7 +142,7 @@ export class Befly {
             // 注意：这里不能直接 process.exit(1)
             // - Logger 是异步缓冲写入，exit 会导致日志来不及 flush（实际项目里表现为“完全没打印”）
             // - 作为库代码，也不应该强行终止宿主进程
-            Logger.error({ err: error }, "项目启动失败");
+            Logger.error({ err: error, msg: "项目启动失败" });
             // 尽力把错误日志落盘/输出后再把异常抛给上层。
             try {
                 await Logger.flush();

package/dist/lib/cacheHelper.js

@@ -85,7 +85,7 @@ export class CacheHelper {
             }
         }
         catch (error) {
-            Logger.error({ err: error }, "⚠️ 接口缓存异常");
+            Logger.error({ err: error, msg: "⚠️ 接口缓存异常" });
         }
     }
     /**
@@ -110,7 +110,7 @@ export class CacheHelper {
             }
         }
         catch (error) {
-            Logger.warn({ err: error }, "⚠️ 菜单缓存异常");
+            Logger.warn({ err: error, msg: "⚠️ 菜单缓存异常" });
         }
     }
     /**
@@ -161,7 +161,7 @@ export class CacheHelper {
             // 极简方案不做版本/ready/meta：重建完成即生效
         }
         catch (error) {
-            Logger.error({ err: error }, "⚠️ 角色权限缓存异常（将阻断启动）");
+            Logger.error({ err: error, msg: "⚠️ 角色权限缓存异常（将阻断启动）" });
             throw error;
         }
     }
@@ -211,7 +211,7 @@ export class CacheHelper {
             return apis || [];
         }
         catch (error) {
-            Logger.error({ err: error }, "获取接口缓存失败");
+            Logger.error({ err: error, msg: "获取接口缓存失败" });
             return [];
         }
     }
@@ -225,7 +225,7 @@ export class CacheHelper {
             return menus || [];
         }
         catch (error) {
-            Logger.error({ err: error }, "获取菜单缓存失败");
+            Logger.error({ err: error, msg: "获取菜单缓存失败" });
             return [];
         }
     }
@@ -240,7 +240,7 @@ export class CacheHelper {
             return permissions || [];
         }
         catch (error) {
-            Logger.error({ err: error, roleCode: roleCode }, "获取角色权限缓存失败");
+            Logger.error({ err: error, roleCode: roleCode, msg: "获取角色权限缓存失败" });
             return [];
         }
     }
@@ -256,7 +256,7 @@ export class CacheHelper {
             return await this.redis.sismember(CacheKeys.roleApis(roleCode), pathname);
         }
         catch (error) {
-            Logger.error({ err: error, roleCode: roleCode }, "检查角色权限失败");
+            Logger.error({ err: error, roleCode: roleCode, msg: "检查角色权限失败" });
             return false;
         }
     }
@@ -275,7 +275,7 @@ export class CacheHelper {
             return false;
         }
         catch (error) {
-            Logger.error({ err: error, roleCode: roleCode }, "删除角色权限缓存失败");
+            Logger.error({ err: error, roleCode: roleCode, msg: "删除角色权限缓存失败" });
             return false;
         }
     }

package/dist/lib/connect.js

@@ -82,7 +82,7 @@ export class Connect {
             return sql;
         }
         catch (error) {
-            Logger.error({ err: error }, "[Connect] SQL 连接失败");
+            Logger.error({ err: error, msg: "[Connect] SQL 连接失败" });
             try {
                 await sql?.close();
             }
@@ -99,7 +99,7 @@ export class Connect {
                 await this.sqlClient.close();
             }
             catch (error) {
-                Logger.error({ err: error }, "[Connect] 关闭 SQL 连接时出错");
+                Logger.error({ err: error, msg: "[Connect] 关闭 SQL 连接时出错" });
             }
             this.sqlClient = null;
             this.sqlConnectedAt = null;
@@ -153,7 +153,7 @@ export class Connect {
             return redis;
         }
         catch (error) {
-            Logger.error({ err: error }, "[Connect] Redis 连接失败");
+            Logger.error({ err: error, msg: "[Connect] Redis 连接失败" });
             throw new Error(`Redis 连接失败: ${error.message}`);
         }
     }
@@ -167,7 +167,7 @@ export class Connect {
                 this.redisConnectedAt = null;
             }
             catch (error) {
-                Logger.error({ err: error }, "[Connect] 关闭 Redis 连接时出错");
+                Logger.error({ err: error, msg: "[Connect] 关闭 Redis 连接时出错" });
             }
             this.redisClient = null;
         }
@@ -196,7 +196,7 @@ export class Connect {
             await this.connectRedis(config.redis || {});
         }
         catch (error) {
-            Logger.error({ err: error }, "数据库初始化失败");
+            Logger.error({ err: error, msg: "数据库初始化失败" });
             await this.disconnect();
             throw error;
         }

package/dist/lib/dbHelper.js

@@ -58,7 +58,7 @@ export class DbHelper {
         // 3. 写入 Redis 缓存
         const cacheRes = await this.redis.setObject(cacheKey, columnNames, TABLE_COLUMNS_CACHE_TTL_SECONDS);
         if (cacheRes === null) {
-            Logger.warn({ table: table, cacheKey: cacheKey }, "表字段缓存写入 Redis 失败");
+            Logger.warn({ table: table, cacheKey: cacheKey, msg: "表字段缓存写入 Redis 失败" });
         }
         return columnNames;
     }
@@ -422,11 +422,11 @@ export class DbHelper {
         const result = dataExecRes.data || [];
         // 警告日志：返回数据超过警告阈值
         if (result.length >= WARNING_LIMIT) {
-            Logger.warn({ table: options.table, count: result.length, total: total }, "getAll 返回数据过多，建议使用 getList 分页查询");
+            Logger.warn({ table: options.table, count: result.length, total: total, msg: "getAll 返回数据过多，建议使用 getList 分页查询" });
         }
         // 如果达到上限，额外警告
         if (result.length >= MAX_LIMIT) {
-            Logger.warn({ table: options.table, limit: MAX_LIMIT, total: total }, `getAll 达到最大限制 ${MAX_LIMIT}，实际总数 ${total}，只返回前 ${MAX_LIMIT} 条`);
+            Logger.warn({ table: options.table, limit: MAX_LIMIT, total: total, msg: `getAll 达到最大限制 ${MAX_LIMIT}，实际总数 ${total}，只返回前 ${MAX_LIMIT} 条` });
         }
         // 字段名转换：下划线 → 小驼峰
         const camelResult = arrayKeysToCamel(result);
@@ -525,8 +525,9 @@ export class DbHelper {
                 table: table,
                 snakeTable: snakeTable,
                 count: dataList.length,
-                fields: insertFields
-            }, "批量插入失败");
+                fields: insertFields,
+                msg: "批量插入失败"
+            });
             throw error;
         }
     }

package/dist/lib/logger.d.ts

@@ -2,12 +2,11 @@
  * 日志系统 - Bun 环境自定义实现（替换 pino / pino-roll）
  */
 import type { LoggerConfig } from "../types/logger";
-export declare function escapeRegExp(input: string): string;
 type SinkLogger = {
-    info(...args: any[]): any;
-    warn(...args: any[]): any;
-    error(...args: any[]): any;
-    debug(...args: any[]): any;
+    info(record: unknown): any;
+    warn(record: unknown): any;
+    error(record: unknown): any;
+    debug(record: unknown): any;
 };
 export declare function flush(): Promise<void>;
 export declare function shutdown(): Promise<void>;
@@ -24,19 +23,19 @@ export declare function setMockLogger(mock: SinkLogger | null): void;
  * 获取 Logger 实例（延迟初始化）
  */
 export declare function getLogger(): SinkLogger;
-type LoggerObject = Record<string, any>;
-type LoggerCallArgs = [] | [msg: string, ...args: unknown[]] | [obj: LoggerObject, msg?: string, ...args: unknown[]] | [err: Error, msg?: string, ...args: unknown[]] | [msg: string, err: Error, ...args: unknown[]];
+declare class LoggerFacade {
+    private maybeSanitizeForMock;
+    info(input: unknown): any;
+    warn(input: unknown): any;
+    error(input: unknown): any;
+    debug(input: unknown): any;
+    flush(): Promise<void>;
+    configure(cfg: LoggerConfig): void;
+    setMock(mock: SinkLogger | null): void;
+    shutdown(): Promise<void>;
+}
 /**
  * 日志实例（延迟初始化）
  */
-export declare const Logger: {
-    info(...args: LoggerCallArgs): any;
-    warn(...args: LoggerCallArgs): any;
-    error(...args: LoggerCallArgs): any;
-    debug(...args: LoggerCallArgs): any;
-    flush(): Promise<void>;
-    configure: typeof configure;
-    setMock: typeof setMockLogger;
-    shutdown: typeof shutdown;
-};
+export declare const Logger: LoggerFacade;
 export {};