@faapi/faapi 6.10.1 → 6.11.0

package/dist/index.d.ts

@@ -1622,7 +1622,18 @@ interface InjectOptions {
 interface InjectResponse {
     status: number;
     headers: Headers;
+    /** 响应字节按 JSON 反序列化的结果（非 JSON 回退字符串）——HTTP 语义，与真实客户端一致 */
     body: unknown;
+    /**
+     * handler 原始返回值（自动包裹与 JSON 序列化之前，Date 等富类型不丢）
+     *
+     * 仅当响应体由 handler 数据返回值自动包裹产生时捕获（同进程取数类型保真，
+     * 快路径判断用 `res.raw !== undefined`）；handler 返回 Response 形态
+     * （ctx.ok/ctx.fail/ctx.json）、抛错、中间件拦截、SSE、404/405/校验失败等
+     * handler 未产生数据返回值的场景为 undefined。语义详见 createAppCore.md
+     * 「inject 的 raw 字段」节。
+     */
+    raw?: unknown;
 }
 /**
  * 获取当前 faapi app 单例
@@ -1682,7 +1693,9 @@ interface AppBase {
      * 无服务器测试注入
      *
      * 构建一个模拟请求直接走完整请求链路（CORS / helmet / logger / 全局中间件 / 路由匹配 /
-     * schema 校验 / 目录中间件 / handler），不绑定端口，返回已解析的 `{ status, headers, body }`。
+     * schema 校验 / 目录中间件 / handler），不绑定端口，返回已解析的
+     * `{ status, headers, body, raw }`——body 为 JSON 反序列化结果（HTTP 语义），
+     * raw 为 handler 原始返回值（同进程取数类型保真，语义见 InjectResponse.raw）。
      *
      * `listen()` 前后均可调用——`listen()` 后调用常用于 Next.js Server Component 等同进程场景
      * （配合 `getApp()` 拿到 app 实例）。

package/dist/index.js

@@ -5164,6 +5164,9 @@ async function injectParamsAsync(handler, ctx, body, injectors) {
 function wrapResult(result, ctx) {
   return wrapOkResult(result, ctx.config);
 }
+function stashHandlerResult(ctx, result) {
+  ctx.__faapiHandlerResult = result;
+}
 function mergeMeta(response, meta) {
   const hasMeta = meta.status !== void 0 || Object.keys(meta.headers).length > 0 || meta.setCookies.length > 0;
   if (!hasMeta) return response;
@@ -5232,7 +5235,9 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
       const result = await injectParamsAsync(handler, ctx, body, injectors);
       const sseResponse = pickSseAndAutoClose();
       if (sseResponse) return sseResponse;
-      return toResponse(wrapResult(result, ctx), meta);
+      const response = await toResponse(wrapResult(result, ctx), meta);
+      if (!(result instanceof Response)) stashHandlerResult(ctx, result);
+      return response;
     } catch (err) {
       autoCloseSseOnError();
       throw err;
@@ -5243,7 +5248,9 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
       const result = await injectParamsAsync(handler, ctx, body, injectors);
       const sseResponse = pickSseAndAutoClose();
       if (sseResponse) return sseResponse;
-      return toResponse(wrapResult(result, ctx), meta);
+      const response = await toResponse(wrapResult(result, ctx), meta);
+      if (!(result instanceof Response)) stashHandlerResult(ctx, result);
+      return response;
     } catch (err) {
       autoCloseSseOnError();
       throw err;
@@ -6153,6 +6160,7 @@ async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares,
       globalInjectors
     });
     const response = outerMiddlewares.length > 0 ? await compose(outerMiddlewares, ctx, routePipeline) : await routePipeline();
+    res.__faapiHandlerResult = ctx.__faapiHandlerResult;
     await sendSuccessResponse(response, res);
   } catch (err) {
     if (res.destroyed || res.writableEnded) return;
@@ -7196,7 +7204,10 @@ async function createAppBase(options) {
           resolve({
             status: mockRes.statusCode,
             headers: new Headers(mockRes._headers),
-            body: parsed
+            body: parsed,
+            // inject raw 捕获桥（第三跳）：handler 原始返回值（handleRequest 从 ctx
+            // 桥接到 res；未捕获时 undefined——语义见 InjectResponse.raw 注释）
+            raw: mockRes.__faapiHandlerResult
           });
         });
         const listeners = server.listeners("request");