befly 3.9.11 → 3.9.12

package/hooks/parser.ts

@@ -25,31 +25,52 @@ const hook: Hook = {
         // GET 请求：解析查询参数
         if (ctx.req.method === 'GET') {
             const url = new URL(ctx.req.url);
-            if (isPlainObject(ctx.api.fields) && !isEmpty(ctx.api.fields)) {
-                ctx.body = pickFields(Object.fromEntries(url.searchParams), Object.keys(ctx.api.fields));
+            const params = Object.fromEntries(url.searchParams);
+            // rawBody 模式：保留完整请求参数，不过滤字段
+            if (ctx.api.rawBody) {
+                ctx.body = params;
+            } else if (isPlainObject(ctx.api.fields) && !isEmpty(ctx.api.fields)) {
+                ctx.body = pickFields(params, Object.keys(ctx.api.fields));
             } else {
-                ctx.body = Object.fromEntries(url.searchParams);
+                ctx.body = params;
             }
         } else if (ctx.req.method === 'POST') {
             // POST 请求：解析请求体
             const contentType = ctx.req.headers.get('content-type') || '';
+            // 获取 URL 查询参数（POST 请求也可能带参数，如微信回调）
+            const url = new URL(ctx.req.url);
+            const queryParams = Object.fromEntries(url.searchParams);
+
             try {
                 // JSON 格式
                 if (contentType.includes('application/json')) {
                     const body = (await ctx.req.json()) as Record<string, any>;
-                    if (isPlainObject(ctx.api.fields) && !isEmpty(ctx.api.fields)) {
-                        ctx.body = pickFields(body, Object.keys(ctx.api.fields));
+                    // 合并 URL 参数和请求体（请求体优先）
+                    const merged = { ...queryParams, ...body };
+                    // rawBody 模式：保留完整请求体，不过滤字段
+                    if (ctx.api.rawBody) {
+                        ctx.body = merged;
+                    } else if (isPlainObject(ctx.api.fields) && !isEmpty(ctx.api.fields)) {
+                        ctx.body = pickFields(merged, Object.keys(ctx.api.fields));
                     } else {
-                        ctx.body = body;
+                        ctx.body = merged;
                     }
                 } else if (contentType.includes('application/xml') || contentType.includes('text/xml')) {
                     // XML 格式
                     const text = await ctx.req.text();
-                    const body = xmlParser.parse(text) as Record<string, any>;
-                    if (isPlainObject(ctx.api.fields) && !isEmpty(ctx.api.fields)) {
-                        ctx.body = pickFields(body, Object.keys(ctx.api.fields));
+                    const parsed = xmlParser.parse(text) as Record<string, any>;
+                    // 提取根节点内容（如 xml），使 body 扁平化
+                    const rootKey = Object.keys(parsed)[0];
+                    const body = rootKey && typeof parsed[rootKey] === 'object' ? parsed[rootKey] : parsed;
+                    // 合并 URL 参数和请求体（请求体优先）
+                    const merged = { ...queryParams, ...body };
+                    // rawBody 模式：保留完整请求体，不过滤字段
+                    if (ctx.api.rawBody) {
+                        ctx.body = merged;
+                    } else if (isPlainObject(ctx.api.fields) && !isEmpty(ctx.api.fields)) {
+                        ctx.body = pickFields(merged, Object.keys(ctx.api.fields));
                     } else {
-                        ctx.body = body;
+                        ctx.body = merged;
                     }
                 } else {
                     // 不支持的 Content-Type

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.9.11",
+    "version": "3.9.12",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -74,7 +74,7 @@
         "pino": "^10.1.0",
         "pino-roll": "^4.0.0"
     },
-    "gitHead": "7efd464153a6813d2eabbed638bc7475ec558e5e",
+    "gitHead": "1065d8c11e32a4d9cf6177ad484500c4c98b1e2f",
     "devDependencies": {
         "typescript": "^5.9.3"
     }

package/router/api.ts

@@ -61,7 +61,16 @@ export function apiHandler(apis: Map<string, ApiRoute>, hooks: Hook[], context:
                 }
             }
 
-            // 5. 执行 API handler
+            // 5. 执行 preprocess 预处理（如果有）
+            if (ctx.api?.preprocess) {
+                await ctx.api.preprocess(context, ctx);
+                // 如果 preprocess 设置了 response，停止执行
+                if (ctx.response) {
+                    return ctx.response;
+                }
+            }
+
+            // 6. 执行 API handler
             if (!ctx.api) {
                 if (req.method !== 'OPTIONS') {
                     ctx.response = Response.json(
@@ -84,7 +93,7 @@ export function apiHandler(apis: Map<string, ApiRoute>, hooks: Hook[], context:
                 }
             }
 
-            // 6. 返回响应（自动处理 response/result/日志）
+            // 7. 返回响应（自动处理 response/result/日志）
             return FinalResponse(ctx);
         } catch (err: any) {
             // 全局错误处理

package/types/api.d.ts

@@ -85,6 +85,18 @@ export interface ApiRoute<T = any, R = any> {
     /** 必填字段（可选，默认 []） */
     required?: string[];
 
+    /** 是否保留原始请求体（可选，默认 false）
+     * - true: 不过滤字段，保留完整请求体（适用于微信回调、webhook 等场景）
+     * - false: 根据 fields 定义过滤字段
+     */
+    rawBody?: boolean;
+
+    /** 请求预处理函数（可选，在 handler 之前执行）
+     * 用于解密、转换请求数据等场景
+     * 可以修改 ctx.body
+     */
+    preprocess?: ApiHandler<T, void>;
+
     /** 缓存配置（可选，单位：秒） */
     cache?: number;