@faapi/faapi 6.10.1 → 6.12.0

package/dist/index.d.ts

@@ -1622,6 +1622,11 @@ interface InjectOptions {
 interface InjectResponse {
     status: number;
     headers: Headers;
+    /**
+     * 响应字节按 JSON 反序列化的结果（非 JSON 回退字符串）——HTTP 语义，与真实客户端一致。
+     * 序列化契约（Date → 毫秒时间戳、BigInt → 字符串等，JSON 原生类型之外全部转换）
+     * 见 `src/utils/stringifyJson.md`，与真实 HTTP 响应完全相同
+     */
     body: unknown;
 }
 /**
@@ -1682,7 +1687,8 @@ interface AppBase {
      * 无服务器测试注入
      *
      * 构建一个模拟请求直接走完整请求链路（CORS / helmet / logger / 全局中间件 / 路由匹配 /
-     * schema 校验 / 目录中间件 / handler），不绑定端口，返回已解析的 `{ status, headers, body }`。
+     * schema 校验 / 目录中间件 / handler），不绑定端口，返回已解析的 `{ status, headers, body }`
+     * ——body 为 JSON 反序列化结果，与真实 HTTP 客户端拿到的一致（同一序列化契约）。
      *
      * `listen()` 前后均可调用——`listen()` 后调用常用于 Next.js Server Component 等同进程场景
      * （配合 `getApp()` 拿到 app 实例）。

package/dist/index.js

@@ -1388,7 +1388,7 @@ function baseExpression(type, ctx) {
     case "union":
       return generateUnionExpression(type.members, ctx);
     case "date":
-      return 'z.preprocess((v) => (typeof v === "string" ? new Date(v) : v), z.date())';
+      return 'z.preprocess((v) => (typeof v === "string" || typeof v === "number" ? new Date(v) : v), z.date())';
     case "record":
       return `z.record(${runtimeTypeToZodExpression(type.key, ctx)}, ${runtimeTypeToZodExpression(type.value, ctx)})`;
     case "map":
@@ -4508,6 +4508,74 @@ async function loadRouteModule(filePath, method, rootDir) {
   return { handler, method };
 }
 
+// src/utils/isPlainObject.ts
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  if (Array.isArray(value)) {
+    return false;
+  }
+  const proto = Object.getPrototypeOf(value);
+  return proto === null || proto === Object.prototype;
+}
+
+// src/utils/stringifyJson.ts
+function stringifyJson(value) {
+  return JSON.stringify(convertValue(value, /* @__PURE__ */ new Set()));
+}
+function convertValue(value, ancestors) {
+  if (value === null) return value;
+  const type = typeof value;
+  if (type === "bigint") return value.toString();
+  if (type === "number") return Number.isFinite(value) ? value : String(value);
+  if (type !== "object") return value;
+  const obj = value;
+  if (ancestors.has(obj)) {
+    throw new TypeError("[faapi] Converting circular structure to JSON");
+  }
+  if (obj instanceof Date) return obj.getTime();
+  if (obj instanceof Map) {
+    ancestors.add(obj);
+    const entries = Array.from(obj, ([k, v]) => [
+      convertValue(k, ancestors),
+      convertValue(v, ancestors)
+    ]);
+    ancestors.delete(obj);
+    return entries;
+  }
+  if (obj instanceof Set) {
+    ancestors.add(obj);
+    const values = Array.from(obj, (v) => convertValue(v, ancestors));
+    ancestors.delete(obj);
+    return values;
+  }
+  if (obj instanceof RegExp) return obj.toString();
+  const toJSON = obj.toJSON;
+  if (typeof toJSON === "function") {
+    ancestors.add(obj);
+    const result = convertValue(toJSON.call(obj), ancestors);
+    ancestors.delete(obj);
+    return result;
+  }
+  if (Array.isArray(obj)) {
+    ancestors.add(obj);
+    const arr = obj.map((item) => convertValue(item, ancestors));
+    ancestors.delete(obj);
+    return arr;
+  }
+  if (isPlainObject(obj)) {
+    ancestors.add(obj);
+    const out = {};
+    for (const [key, val] of Object.entries(obj)) {
+      out[key] = convertValue(val, ancestors);
+    }
+    ancestors.delete(obj);
+    return out;
+  }
+  return obj;
+}
+
 // src/runtime/sse.ts
 function encodeSseEvent(event) {
   let out = "";
@@ -4534,7 +4602,7 @@ function encodeSseEvent(event) {
     } else if (event.data === null) {
       dataStr = "null";
     } else {
-      dataStr = JSON.stringify(event.data);
+      dataStr = stringifyJson(event.data);
     }
     const lines = dataStr.split("\n");
     for (const line of lines) {
@@ -4640,7 +4708,7 @@ function jsonRaw(body, status, extraHeaders) {
     const extra = new Headers(extraHeaders);
     extra.forEach((value, key) => headers.set(key, value));
   }
-  return new Response(JSON.stringify(body), { status, headers });
+  return new Response(stringifyJson(body), { status, headers });
 }
 function wrapOkResult(result, config) {
   if (result instanceof Response) return result;
@@ -4966,18 +5034,6 @@ async function resolveBodyForQueryMethod(request) {
   return result.data;
 }
 
-// src/utils/isPlainObject.ts
-function isPlainObject(value) {
-  if (value === null || typeof value !== "object") {
-    return false;
-  }
-  if (Array.isArray(value)) {
-    return false;
-  }
-  const proto = Object.getPrototypeOf(value);
-  return proto === null || proto === Object.prototype;
-}
-
 // src/response/pendingMeta.ts
 var pending = /* @__PURE__ */ new WeakMap();
 function deferMetaHeaders(response, headers) {
@@ -5057,7 +5113,7 @@ async function toResponse(value, meta) {
     });
   }
   if (isPlainObject(value) || Array.isArray(value)) {
-    const body2 = JSON.stringify(value);
+    const body2 = stringifyJson(value);
     const headers2 = new Headers({ "Content-Type": "application/json" });
     applyMeta(headers2);
     return new Response(body2, {
@@ -5081,7 +5137,7 @@ async function toResponse(value, meta) {
       headers: headers2
     });
   }
-  const body = JSON.stringify(value);
+  const body = stringifyJson(value);
   const headers = new Headers({ "Content-Type": "application/json" });
   applyMeta(headers);
   return new Response(body, {
@@ -5679,7 +5735,7 @@ async function loadMergedMiddlewares(middlewarePaths) {
 function wrapWsSocket(rawSocket) {
   return {
     send(data) {
-      const payload = typeof data === "string" || Buffer.isBuffer(data) ? data : JSON.stringify(data);
+      const payload = typeof data === "string" || Buffer.isBuffer(data) ? data : stringifyJson(data);
       rawSocket.send(payload);
     },
     close(code, reason) {