@faapi/faapi 1.3.1 → 1.5.0

package/dist/index.d.ts

@@ -1451,6 +1451,31 @@ interface InjectResponse {
     headers: Headers;
     body: unknown;
 }
+/**
+ * 获取当前 faapi app 单例
+ *
+ * 用于在无法直接拿到 app 引用的场景（如 Next.js Server Component）中访问 app。
+ *
+ * @returns 当前 app 实例
+ * @throws 未初始化时抛错（需先调 `createProdApp()` / `createDevApp()`，或 `faapi dev` / `node dist/main` 启动）
+ *
+ * @example
+ * ```ts
+ * // Next.js RSC 中调用 faapi API（同进程，跳过 HTTP loopback）
+ * import { getApp } from '@faapi/faapi';
+ * import { headers } from 'next/headers';
+ *
+ * const app = getApp();
+ * const h = await headers();
+ * const res = await app.inject({
+ *   method: 'GET',
+ *   path: '/api/user',
+ *   headers: { cookie: h.get('cookie') ?? '', authorization: h.get('authorization') ?? '' },
+ * });
+ * const data = res.body;  // 已解析
+ * ```
+ */
+declare function getApp(): AppBase;
 interface CreateAppOptions {
     /** 项目根目录，默认 process.cwd() */
     rootDir?: string;
@@ -1476,8 +1501,11 @@ interface AppBase {
     /**
      * 无服务器测试注入
      *
-     * 构建一个模拟请求直接走完整请求链路，不绑定端口。
-     * 需要在 listen() 之前调用（server 未启动时）。
+     * 构建一个模拟请求直接走完整请求链路（CORS / helmet / logger / 全局中间件 / 路由匹配 /
+     * schema 校验 / 目录中间件 / handler），不绑定端口，返回已解析的 `{ status, headers, body }`。
+     *
+     * `listen()` 前后均可调用——`listen()` 后调用常用于 Next.js Server Component 等同进程场景
+     * （配合 `getApp()` 拿到 app 实例）。
      */
     inject(options?: InjectOptions): Promise<InjectResponse>;
 }
@@ -1532,4 +1560,4 @@ type ProdApp = AppBase;
  */
 declare function createProdApp(options?: CreateAppOptions): Promise<ProdApp>;
 
-export { type ProdApp as App, type CorsOptions, type CreateAppOptions, type DevApp, type FaapiConfig, type FaapiContext, type FaapiContextConfig, FaapiError, type FaapiMiddleware, type FaapiPlugin, type FailOptions, type HandlerTypeInfo, type HelmetOptions, type InjectOptions, type InjectResponse, type Injector, type InjectorMap, InternalError, type LifecycleContext, type LifecycleHooks, type LoggerOptions, MessageQueue, MethodNotAllowedError, ModuleLoadError, type PluginContext, type PluginDeclaration, type ProdApp, type PropertyType, type RequestHandler, type ResponseConfig, type RouteInfo, type RouteInputSchema, type RouteManifest, RouteNotFoundError, type RouteOutputSchema, type RouteParamSchema, type RouteSchemaSource, type RuntimeType, SchemaExtractionError, type SseEvent, type SseWriter, type TestServer, type TestServerOptions, type TypeConstraint, type UpgradeHandler, ValidationError, type ValidationErrorCode, type ValidationIssue, type WsContext, type WsEventHandlers, type WsHandler, type WsSocket, type WsTestClient, type WsTestClientOptions, collectRouteSchemaSources, connectWs, cors, createProdApp as createApp, createContext, createDevApp, createProdApp, createProgram, createTestServer, extractTypeInfo, getInputTypeForMethod, helmet, invalidateProgramCache, invokeHandler, loadConfig, loadEnv, logger, resolveTypeNode, waitForWsOpen };
+export { type ProdApp as App, type CorsOptions, type CreateAppOptions, type DevApp, type FaapiConfig, type FaapiContext, type FaapiContextConfig, FaapiError, type FaapiMiddleware, type FaapiPlugin, type FailOptions, type HandlerTypeInfo, type HelmetOptions, type InjectOptions, type InjectResponse, type Injector, type InjectorMap, InternalError, type LifecycleContext, type LifecycleHooks, type LoggerOptions, MessageQueue, MethodNotAllowedError, ModuleLoadError, type PluginContext, type PluginDeclaration, type ProdApp, type PropertyType, type RequestHandler, type ResponseConfig, type RouteInfo, type RouteInputSchema, type RouteManifest, RouteNotFoundError, type RouteOutputSchema, type RouteParamSchema, type RouteSchemaSource, type RuntimeType, SchemaExtractionError, type SseEvent, type SseWriter, type TestServer, type TestServerOptions, type TypeConstraint, type UpgradeHandler, ValidationError, type ValidationErrorCode, type ValidationIssue, type WsContext, type WsEventHandlers, type WsHandler, type WsSocket, type WsTestClient, type WsTestClientOptions, collectRouteSchemaSources, connectWs, cors, createProdApp as createApp, createContext, createDevApp, createProdApp, createProgram, createTestServer, extractTypeInfo, getApp, getInputTypeForMethod, helmet, invalidateProgramCache, invokeHandler, loadConfig, loadEnv, logger, resolveTypeNode, waitForWsOpen };

package/dist/index.js

@@ -3786,7 +3786,7 @@ async function connectWs(baseUrl, pathname, options = {}) {
 // src/cli/createAppCore.ts
 import fs13 from "fs";
 import path14 from "path";
-import { PassThrough } from "stream";
+import { PassThrough, Readable as Readable3 } from "stream";
 
 // src/router/detectRouteConflicts.ts
 function detectRouteConflicts(routes) {
@@ -3931,6 +3931,15 @@ var DEFAULT_DIST = "dist";
 var DEFAULT_PORT = 3e3;
 var ROUTES_FILE = "faapi-routes.js";
 var PATTERNS = ["src/api/**/*.ts"];
+var currentApp = null;
+function getApp() {
+  if (!currentApp) {
+    throw new Error(
+      "[faapi] No app instance. Call createProdApp() / createDevApp() first, or run `faapi dev` / `node dist/main`."
+    );
+  }
+  return currentApp;
+}
 var FAAPI_CONFIG_KEYS = /* @__PURE__ */ new Set([
   "cors",
   "lifecycle",
@@ -4088,11 +4097,7 @@ async function createAppBase(options) {
           reject(new Error("No request handler found"));
           return;
         }
-        const mockReq = new PassThrough({
-          read() {
-            this.push(null);
-          }
-        });
+        const mockReq = Readable3.from(body !== void 0 ? [Buffer.from(JSON.stringify(body))] : []);
         mockReq.method = method;
         mockReq.url = `${reqPath}${queryStr}`;
         mockReq.headers = {
@@ -4101,9 +4106,6 @@ async function createAppBase(options) {
           "content-type": body !== void 0 ? "application/json" : void 0
         };
         mockReq.socket = { remoteAddress: "127.0.0.1" };
-        if (body !== void 0) {
-          mockReq.push(JSON.stringify(body));
-        }
         handler(
           mockReq,
           mockRes
@@ -4125,17 +4127,20 @@ async function createAppBase(options) {
       }
       if (!server.listening) {
         app.server = null;
+        if (currentApp === app) currentApp = null;
         return;
       }
       return new Promise((resolve) => {
         server.close((err) => {
           if (err) console.error("Error closing server:", err);
           app.server = null;
+          if (currentApp === app) currentApp = null;
           resolve();
         });
       });
     }
   };
+  currentApp = app;
   const ctx = {
     rootDir,
     dist,
@@ -4204,6 +4209,7 @@ export {
   createProgram,
   createTestServer,
   extractTypeInfo,
+  getApp,
   getInputTypeForMethod,
   helmet,
   invalidateProgramCache,