@faapi/faapi 6.21.1 → 6.23.0

package/dist/{routeTypes-gyz4PMh7.d.ts → routeTypes-CJV5M90s.d.ts}

@@ -762,7 +762,7 @@ type TaskFailedHandler = (info: TaskFailedInfo) => Promise<void> | void;
  *
  * 核心导出：
  * - `encodeSseEvent(event)`：把 SSE 事件对象编码为符合 HTML5 SSE 规范的字符串
- * - `createSseWriter()`：创建一个 SseWriter，封装 ReadableStream + Response，提供 send/close/sendError API
+ * - `createSseWriter()`：创建一个 SseWriter，封装 ReadableStream + Response，提供 send/close/onClose/sendError API
  * - `SseWriter`：writer 类型，ctx.sse() 返回此类型
  *
  * 设计要点：
@@ -803,6 +803,20 @@ interface SseEvent {
     /** 注释行（以 : 开头），用于 keep-alive 心跳 */
     comment?: string;
 }
+/**
+ * ctx.sse() 的选项
+ */
+interface SseOptions {
+    /**
+     * 声明流生命周期独立于 handler 返回（长连接订阅模式）
+     *
+     * `true` 时 handler 返回后框架不自动 close——handler 只负责把连接挂到推送源
+     * （事件总线、change stream），注册完立即返回，连接长存直到显式 close()、
+     * 客户端断开或 handler 抛错兜底。清理推送源用 `onClose(callback)`。
+     * 默认 false（handler 返回时框架自动 close 兜底）。
+     */
+    keepOpen?: boolean;
+}
 /**
  * SSE writer：封装流式推送 API
  *
@@ -827,10 +841,20 @@ interface SseWriter {
     sendError(error: unknown): void;
     /** 关闭流（多次调用安全） */
     close(): void;
+    /**
+     * 注册流结束回调
+     *
+     * 显式 close、框架兜底 close、客户端断开、sendError 任一路径结束流时恰好触发
+     * 一次（多个回调按注册顺序执行，回调自身抛错被忽略）；注册时流已结束则立即触发。
+     * keepOpen 模式下用于退订/清理推送源，防止客户端断开后订阅随重连累积泄漏。
+     */
+    onClose(callback: () => void): void;
     /** 流是否已关闭（handler 主动 close 或框架自动 close） */
     readonly closed: boolean;
     /** 客户端是否已断开（ReadableStream 被 cancel） */
     readonly aborted: boolean;
+    /** 创建时是否声明了 `{ keepOpen: true }`（handler 返回后框架不自动 close） */
+    readonly keepOpen: boolean;
     /**
      * 流缓冲背压状态（透传 controller.desiredSize）
      *
@@ -1001,6 +1025,14 @@ interface FaapiContext {
     cookies: Record<string, string>;
     /** 配置文件中的自定义业务配置（类型可通过 declare module '@faapi/faapi' 增强 FaapiContextConfig） */
     config: FaapiContextConfig;
+    /**
+     * 运行时资源根目录绝对路径（<rootDir>/<dist>/resources）
+     *
+     * `src/resources/` 经 dev/build 复制进产物后的位置，handler 读静态文件用：
+     * `await fs.readFile(path.join(ctx.resourcesDir, 'prompts/foo.md'))`。
+     * HTTP/WS 请求链路恒有值；testing 直调（createTestContext）未传时为 undefined。
+     */
+    resourcesDir?: string;
     /**
      * 设置响应状态码
      */
@@ -1061,8 +1093,12 @@ interface FaapiContext {
      *   sse.close();
      * }
      * ```
+     *
+     * @param options `{ keepOpen: true }` 声明流生命周期独立于 handler 返回（长连接
+     *   订阅模式）：handler 返回后框架不自动 close，连接长存直到显式 close()、客户端
+     *   断开或 handler 抛错兜底；清理推送源用 `writer.onClose(callback)`。默认 false。
      */
-    sse(): SseWriter;
+    sse(options?: SseOptions): SseWriter;
     /**
      * 显式包装成功响应(返回 Response 对象)
      *
@@ -1313,4 +1349,4 @@ interface RouteInfo {
     output: RouteOutputSchema | null;
 }
 
-export { type ToolRegistry as $, type AppRegistries as A, type RouteOutputSchema as B, type CorsOptions as C, type RouteParamSchema as D, type SseEvent as E, type FaapiMiddleware as F, type SseWriter as G, type HelmetOptions as H, type InjectorMap as I, type TaskContext as J, type TaskDriverJob as K, type LogConfig as L, type TaskDriverProcess as M, type TaskDriverRecord as N, type TaskFailedInfo as O, type TaskJob as P, type TaskJobStatus as Q, type RouteManifest as R, type SkillRegistry as S, type TaskClient as T, type TaskMetadata as U, type TaskModule as V, type WsRouteManifest as W, type TaskRegistriesSnapshot as X, type TaskRegistriesView as Y, type ToolCore as Z, type ToolPathMeta as _, type FaapiContext as a, cors as a0, createAppRegistries as a1, createTaskRegistriesView as a2, createTaskRegistry as a3, helmet as a4, type TaskFailedHandler as b, type TaskQueueDeps as c, type TaskQueue as d, type TaskDriver as e, type TaskRegistry as f, type TaskManifest as g, type ToolMetadata as h, type AgentCore as i, type AgentMetadata as j, type CreateLoggerOptions as k, type Logger as l, type AgentHandleFactory as m, type AgentHandleStore as n, type AgentPathMeta as o, type AgentRegistry as p, type AgentToolDescriptor as q, type FaapiContextConfig as r, type FaapiTaskMeta as s, type FailOptions as t, type Injector as u, type LogEntry as v, type LogLevel as w, type LogSink as x, type RouteInfo as y, type RouteInputSchema as z };
+export { type ToolPathMeta as $, type AppRegistries as A, type RouteOutputSchema as B, type CorsOptions as C, type RouteParamSchema as D, type SseEvent as E, type FaapiMiddleware as F, type SseOptions as G, type HelmetOptions as H, type InjectorMap as I, type SseWriter as J, type TaskContext as K, type LogConfig as L, type TaskDriverJob as M, type TaskDriverProcess as N, type TaskDriverRecord as O, type TaskFailedInfo as P, type TaskJob as Q, type RouteManifest as R, type SkillRegistry as S, type TaskClient as T, type TaskJobStatus as U, type TaskMetadata as V, type WsRouteManifest as W, type TaskModule as X, type TaskRegistriesSnapshot as Y, type TaskRegistriesView as Z, type ToolCore as _, type FaapiContext as a, type ToolRegistry as a0, cors as a1, createAppRegistries as a2, createTaskRegistriesView as a3, createTaskRegistry as a4, helmet as a5, type TaskFailedHandler as b, type TaskQueueDeps as c, type TaskQueue as d, type TaskDriver as e, type TaskRegistry as f, type TaskManifest as g, type ToolMetadata as h, type AgentCore as i, type AgentMetadata as j, type CreateLoggerOptions as k, type Logger as l, type AgentHandleFactory as m, type AgentHandleStore as n, type AgentPathMeta as o, type AgentRegistry as p, type AgentToolDescriptor as q, type FaapiContextConfig as r, type FaapiTaskMeta as s, type FailOptions as t, type Injector as u, type LogEntry as v, type LogLevel as w, type LogSink as x, type RouteInfo as y, type RouteInputSchema as z };

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { a as FaapiContext, F as FaapiMiddleware, I as InjectorMap, R as RouteManifest, W as WsRouteManifest, C as CorsOptions, H as HelmetOptions } from './routeTypes-gyz4PMh7.js';
+import { a as FaapiContext, F as FaapiMiddleware, I as InjectorMap, R as RouteManifest, W as WsRouteManifest, C as CorsOptions, H as HelmetOptions } from './routeTypes-CJV5M90s.js';
 import { Server } from 'node:http';
 import { WebSocket } from 'ws';
 
@@ -25,6 +25,8 @@ declare function createTestContext(options: CreateTestContextOptions): FaapiCont
 interface CreateTestContextOptions {
     /** app 级注册表（测试 handler 声明 agent/agents 参数时注入用，可选） */
     registries?: FaapiContext['registries'];
+    /** 运行时资源根目录（测试 handler 读 ctx.resourcesDir 时传入，可选） */
+    resourcesDir?: string;
     /** 请求方法，默认 'GET' */
     method?: string;
     /** 请求路径，必填，如 '/api/user'（无需写 host） */

package/dist/testing.js

@@ -155,13 +155,28 @@ function encodeSseEvent(event) {
   return out;
 }
 function createSseWriter(options = {}) {
-  const { onFirstWrite } = options;
+  const { onFirstWrite, keepOpen = false } = options;
   const encoder = new TextEncoder();
   let controller = null;
   let closed = false;
   let aborted = false;
   let firstWriteTriggered = false;
   let drainWaiters = [];
+  let closeCallbacks = [];
+  let closeCallbacksFired = false;
+  const safeRunCallback = (callback) => {
+    try {
+      callback();
+    } catch {
+    }
+  };
+  const runCloseCallbacks = () => {
+    if (closeCallbacksFired) return;
+    closeCallbacksFired = true;
+    const callbacks = closeCallbacks;
+    closeCallbacks = [];
+    for (const callback of callbacks) safeRunCallback(callback);
+  };
   const resolveDrainWaiters = () => {
     const waiters = drainWaiters;
     drainWaiters = [];
@@ -185,6 +200,7 @@ function createSseWriter(options = {}) {
         aborted = true;
         closed = true;
         controller = null;
+        runCloseCallbacks();
         resolveDrainWaiters();
       }
     },
@@ -227,6 +243,7 @@ function createSseWriter(options = {}) {
     close() {
       if (closed) return;
       closed = true;
+      runCloseCallbacks();
       resolveDrainWaiters();
       if (controller) {
         try {
@@ -236,6 +253,13 @@ function createSseWriter(options = {}) {
         controller = null;
       }
     },
+    onClose(callback) {
+      if (closeCallbacksFired) {
+        safeRunCallback(callback);
+        return;
+      }
+      closeCallbacks.push(callback);
+    },
     get closed() {
       return closed;
     },
@@ -252,6 +276,9 @@ function createSseWriter(options = {}) {
     get aborted() {
       return aborted;
     },
+    get keepOpen() {
+      return keepOpen;
+    },
     get response() {
       return response;
     }
@@ -285,14 +312,14 @@ var ValidationError = class extends FaapiError {
   issues;
 };
 var RouteNotFoundError = class extends FaapiError {
-  constructor(path16) {
-    super("ROUTE_NOT_FOUND", `Route not found: ${path16}`, 404);
+  constructor(path17) {
+    super("ROUTE_NOT_FOUND", `Route not found: ${path17}`, 404);
     this.name = "RouteNotFoundError";
   }
 };
 var MethodNotAllowedError = class extends FaapiError {
-  constructor(method, path16, allowedMethods) {
-    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path16}`, 405);
+  constructor(method, path17, allowedMethods) {
+    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path17}`, 405);
     this.allowedMethods = allowedMethods;
     this.name = "MethodNotAllowedError";
   }
@@ -557,10 +584,18 @@ function formatSetCookie(name, value, options) {
   if (options?.sameSite) cookie += `; SameSite=${options.sameSite}`;
   return cookie;
 }
-function createContext(request, params, config = {}, ip = "", registries) {
-  return createContextFromUrl(request, new URL(request.url), params, config, ip, registries);
+function createContext(request, params, config = {}, ip = "", registries, resourcesDir) {
+  return createContextFromUrl(
+    request,
+    new URL(request.url),
+    params,
+    config,
+    ip,
+    registries,
+    resourcesDir
+  );
 }
-function createContextFromUrl(request, url, params, config = {}, ip = "", registries) {
+function createContextFromUrl(request, url, params, config = {}, ip = "", registries, resourcesDir) {
   const meta = { headers: {}, setCookies: [] };
   const parsedCookies = parseCookies(request.headers.get("cookie") ?? "");
   const cookiesObj = {};
@@ -588,6 +623,9 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
     ua: request.headers.get("user-agent") ?? "",
     cookies: cookiesObj,
     config,
+    // 运行时资源根目录（HTTP/WS 链路由 createServer/handleWsUpgrade 传入；
+    // testing 直调未传时为 undefined，见 contextTypes.resourcesDir 注释）
+    resourcesDir,
     meta,
     setStatus(status) {
       meta.status = status;
@@ -633,10 +671,15 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
      * 接入底层连接——流式期间字节即产即达（见 createServer.md「SSE 提前接管」）。
      * 无钩子场景（app.inject / 测试直调 invokeHandler）回落为 handler 返回后交出。
      *
+     * `{ keepOpen: true }` 声明流生命周期独立于 handler 返回：handler 返回后框架
+     * 不自动 close（长连接订阅模式，清理推送源用 writer.onClose）；handler 抛错
+     * 的兜底 close 不受影响。详见 runtime/sse.md「长连接订阅模式」。
+     *
      * 与 ctx.json / ctx.html 互斥：一个 handler 只能用一种响应方式。
      */
-    sse() {
+    sse(options) {
       const writer = createSseWriter({
+        keepOpen: options?.keepOpen,
         onFirstWrite: (response) => {
           ctx.__earlyRespond?.(response);
         }
@@ -688,15 +731,16 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
 function createTestContext(options) {
   const {
     method = "GET",
-    path: path16,
+    path: path17,
     query,
     headers,
     params = {},
     config = {},
     ip = "",
-    registries
+    registries,
+    resourcesDir
   } = options;
-  const url = new URL(`http://localhost${path16}`);
+  const url = new URL(`http://localhost${path17}`);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (Array.isArray(value)) {
@@ -712,7 +756,7 @@ function createTestContext(options) {
     method,
     headers
   });
-  return createContext(request, params, config, ip, registries);
+  return createContext(request, params, config, ip, registries, resourcesDir);
 }
 
 // src/response/pendingMeta.ts
@@ -1265,7 +1309,7 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
   const pickSseAndAutoClose = () => {
     const sseWriter = ctx.__sseWriter;
     if (!sseWriter) return null;
-    if (!sseWriter.closed && !sseWriter.aborted) {
+    if (!sseWriter.keepOpen && !sseWriter.closed && !sseWriter.aborted) {
       sseWriter.close();
     }
     return mergeMeta(sseWriter.response, meta);
@@ -1295,9 +1339,9 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
 }
 
 // src/testServer.ts
-import path15 from "path";
+import path16 from "path";
 import os from "os";
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 
 // src/router/scanRoutes.ts
 import fg from "fast-glob";
@@ -1309,9 +1353,9 @@ var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 var HTTP_METHOD_SET = new Set(HTTP_METHODS);
 
 // src/utils/normalizePath.ts
-function normalizePath(path16) {
-  if (!path16) return "";
-  let result = path16.replace(/\\/g, "/");
+function normalizePath(path17) {
+  if (!path17) return "";
+  let result = path17.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -3479,13 +3523,14 @@ function buildAliasPlugins(rootDir) {
 }
 
 // src/cli/compileSourceFiles.ts
+var SOURCE_IGNORE = ["**/*.test.ts", "**/*.e2e.test.ts", "**/*.d.ts", `${APP_DIR}/resources/**`];
 async function compileSourceFiles(options) {
   const { rootDir, dist, files, logLevel = "silent", production, atomicWrite } = options;
   const entryPoints = files ?? await fg2([`${APP_DIR}/**/*.ts`], {
     cwd: rootDir,
     onlyFiles: true,
     absolute: true,
-    ignore: ["**/*.test.ts", "**/*.e2e.test.ts", "**/*.d.ts"]
+    ignore: SOURCE_IGNORE
   });
   if (entryPoints.length === 0) {
     return { compiledFiles: [] };
@@ -3789,9 +3834,9 @@ async function validateInput(schemaPath, method, inputType, input) {
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
     const code = mapZodCode(issue);
-    const path16 = issue.path.map(String).join(".") || "";
+    const path17 = issue.path.map(String).join(".") || "";
     return {
-      path: path16,
+      path: path17,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -3841,7 +3886,7 @@ import {
 import { createSecureServer as createHttp2SecureServer } from "http2";
 import { readFileSync } from "fs";
 import { Readable as Readable2 } from "stream";
-import path14 from "path";
+import path15 from "path";
 
 // src/router/matchRoute.ts
 var httpIndexCache = /* @__PURE__ */ new WeakMap();
@@ -3883,25 +3928,25 @@ function getWsIndex(routes) {
   wsIndexCache.set(routes, index);
   return index;
 }
-function matchRoute(routes, method, path16) {
+function matchRoute(routes, method, path17) {
   const index = getHttpIndex(routes);
   const upper = method.toUpperCase();
-  const hit = matchByMethod(index, upper, path16);
+  const hit = matchByMethod(index, upper, path17);
   if (hit) return hit;
   if (upper === "HEAD") {
-    return matchByMethod(index, "GET", path16);
+    return matchByMethod(index, "GET", path17);
   }
   return null;
 }
-function matchByMethod(index, method, path16) {
-  const staticHit = index.static.get(`${method}|${path16}`);
+function matchByMethod(index, method, path17) {
+  const staticHit = index.static.get(`${method}|${path17}`);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   if (index.dynamics.length === 0) {
     return null;
   }
-  const pathSegments = path16.split("/").filter(Boolean);
+  const pathSegments = path17.split("/").filter(Boolean);
   for (const entry of index.dynamics) {
     const route = entry.route;
     if (route.method !== method) {
@@ -3914,31 +3959,31 @@ function matchByMethod(index, method, path16) {
   }
   return null;
 }
-function matchWsRoute(wsRoutes, path16) {
+function matchWsRoute(wsRoutes, path17) {
   const index = getWsIndex(wsRoutes);
-  const staticHit = index.static.get(path16);
+  const staticHit = index.static.get(path17);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   for (const route of index.dynamics) {
-    const params = matchDynamicPath(route.urlPath, path16, route.paramNames, route.isCatchAll);
+    const params = matchDynamicPath(route.urlPath, path17, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function findAllowedMethods(routes, path16) {
+function findAllowedMethods(routes, path17) {
   const index = getHttpIndex(routes);
   const methods = /* @__PURE__ */ new Set();
-  const staticMethods = index.methodsByStaticPath.get(path16);
+  const staticMethods = index.methodsByStaticPath.get(path17);
   if (staticMethods) {
     for (const method of staticMethods) {
       methods.add(method);
     }
   }
   if (index.dynamics.length > 0) {
-    const pathSegments = path16.split("/").filter(Boolean);
+    const pathSegments = path17.split("/").filter(Boolean);
     for (const entry of index.dynamics) {
       const params = matchSegments(
         entry.segments,
@@ -3956,10 +4001,10 @@ function findAllowedMethods(routes, path16) {
   }
   return Array.from(methods);
 }
-function matchDynamicPath(pattern, path16, paramNames, isCatchAll) {
+function matchDynamicPath(pattern, path17, paramNames, isCatchAll) {
   return matchSegments(
     pattern.split("/").filter(Boolean),
-    path16.split("/").filter(Boolean),
+    path17.split("/").filter(Boolean),
     paramNames,
     isCatchAll
   );
@@ -4581,9 +4626,17 @@ function logger(options = {}) {
 }
 
 // src/server/handleWsUpgrade.ts
-import fs11 from "fs";
+import fs12 from "fs";
 import { WebSocketServer, WebSocket } from "ws";
+import path14 from "path";
+
+// src/cli/copyResources.ts
 import path13 from "path";
+import fs11 from "fs";
+var RESOURCES_OUTPUT_DIR = "resources";
+function resolveResourcesDir(rootDir, dist) {
+  return path13.resolve(rootDir, dist, RESOURCES_OUTPUT_DIR);
+}
 
 // src/server/serverUtils.ts
 function nodeHttpToWebHeaders(req) {
@@ -4641,7 +4694,7 @@ async function loadWsHandler(filePath, ctx, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs11.existsSync(sourcePath)) {
+      if (sourcePath && fs12.existsSync(sourcePath)) {
         await ensureCompiled(sourcePath, rootDir, dist);
       }
     }
@@ -4739,6 +4792,7 @@ function attachWebSocket(options) {
     trustedProxy = false,
     registries
   } = options;
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const wss = new WebSocketServer({ noServer: true });
   server.on("upgrade", async (req, socket, head) => {
     try {
@@ -4770,12 +4824,19 @@ function attachWebSocket(options) {
     const host = req.headers.host ?? "localhost";
     const fullUrl = new URL(`http://${host}${req.url ?? "/"}`);
     const request = new Request(fullUrl.toString(), { method: "GET", headers });
-    const ctx = createContext(request, params, config, getClientIp(req, trustedProxy), registries);
+    const ctx = createContext(
+      request,
+      params,
+      config,
+      getClientIp(req, trustedProxy),
+      registries,
+      resourcesDir
+    );
     const meta = ctx.meta;
     let upgraded = false;
     const finalHandler = async () => {
       const schemaPath = getRuntimeSchemaPath(route.filePath, dist, rootDir);
-      if (fs11.existsSync(schemaPath)) {
+      if (fs12.existsSync(schemaPath)) {
         if (isDevOnDemandEnabled()) {
           const devDist = getDevDist();
           if (devDist) {
@@ -4814,7 +4875,7 @@ function attachWebSocket(options) {
       }
       let handlers;
       try {
-        const absoluteFilePath = path13.resolve(rootDir, route.filePath);
+        const absoluteFilePath = path14.resolve(rootDir, route.filePath);
         handlers = await loadWsHandler(absoluteFilePath, ctx, rootDir);
       } catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -4973,6 +5034,7 @@ function createServer(options) {
     trustedProxy = false
   } = options;
   const routesRef = { current: routes, wsCurrent: wsRoutes ?? [] };
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const configMiddlewares = [];
   if (compressionOption) {
     const compOpts = typeof compressionOption === "object" ? compressionOption : {};
@@ -5019,7 +5081,8 @@ function createServer(options) {
       bodyLimit,
       trustedProxy,
       registries,
-      routesRef.wsCurrent
+      routesRef.wsCurrent,
+      resourcesDir
     ).catch((err) => {
       console.error("[faapi] Request pipeline failed after error response attempt:", err);
       try {
@@ -5045,7 +5108,7 @@ function createServer(options) {
   });
   return { server, routesRef };
 }
-function prepareRequest(req, request, url, config, trustedProxy, registries, preMatched) {
+function prepareRequest(req, request, url, config, trustedProxy, registries, preMatched, resourcesDir) {
   const method = request.method.toUpperCase();
   const urlPath = url.pathname;
   const ctx = createContextFromUrl(
@@ -5054,7 +5117,8 @@ function prepareRequest(req, request, url, config, trustedProxy, registries, pre
     preMatched?.params ?? {},
     config,
     getClientIp(req, trustedProxy),
-    registries
+    registries,
+    resourcesDir
   );
   const meta = ctx.meta;
   return { request, url, ctx, meta, method, urlPath };
@@ -5073,7 +5137,7 @@ function getRoutePaths(route, rootDir, dist) {
   let cached = routePathCache.get(route);
   if (!cached) {
     cached = {
-      absFilePath: path14.resolve(rootDir, route.filePath),
+      absFilePath: path15.resolve(rootDir, route.filePath),
       schemaPath: getRuntimeSchemaPath(route.filePath, dist, rootDir)
     };
     routePathCache.set(route, cached);
@@ -5196,7 +5260,7 @@ async function sendErrorResponse(err, meta, res, onError, ctx) {
     }
   }
 }
-async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries, wsRoutes) {
+async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries, wsRoutes, resourcesDir) {
   let meta = { headers: {}, setCookies: [] };
   let ctx;
   let sseEarlySent = false;
@@ -5216,7 +5280,8 @@ async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares,
       config,
       trustedProxy,
       registries,
-      preMatched
+      preMatched,
+      resourcesDir
     );
     ctx = prepared.ctx;
     meta = prepared.meta;
@@ -5281,7 +5346,7 @@ async function createTestServer(options) {
   } = options;
   const { routes, wsRoutes } = await scanRoutes(rootDir, patterns);
   const sorted = sortRoutes(routes);
-  const schemaDist = dist ? path15.isAbsolute(dist) ? dist : path15.resolve(rootDir, dist) : await fs12.mkdtemp(path15.join(os.tmpdir(), "faapi-test-schema-"));
+  const schemaDist = dist ? path16.isAbsolute(dist) ? dist : path16.resolve(rootDir, dist) : await fs13.mkdtemp(path16.join(os.tmpdir(), "faapi-test-schema-"));
   await generateSchemaFiles(sorted, rootDir, schemaDist);
   const { server } = createServer({
     routes: sorted,
@@ -5313,7 +5378,7 @@ async function createTestServer(options) {
       await new Promise((resolve) => {
         server.close(() => resolve());
       });
-      await fs12.rm(schemaDist, { recursive: true, force: true }).catch(() => {
+      await fs13.rm(schemaDist, { recursive: true, force: true }).catch(() => {
       });
       invalidateSchemaCache();
     }