@faapi/faapi 6.31.0 → 6.33.0

package/dist/testing.d.ts

@@ -1,7 +1,7 @@
-import { F as FaapiContext } from './contextTypes-BKQsSVMv.js';
-import { F as FaapiMiddleware, I as InjectorMap, R as RouteManifest, W as WsRouteManifest, C as CorsOptions, H as HelmetOptions } from './routeTypes-Cc0P3CcU.js';
+import { g as FaapiContext, F as FaapiMiddleware, w as InjectorMap, R as RouteManifest, W as WsRouteManifest, r as CorsOptions, H as HelmetOptions } from './contextTypes-D1ORxB1P.js';
 import { Server } from 'node:http';
 import { WebSocket } from 'ws';
+import 'node:net';
 
 /**
  * 测试专用：从选项对象创建 FaapiContext，免去手写 `new Request(url)` 的样板代码

package/dist/testing.js

@@ -429,11 +429,7 @@ function formatEntry(entry) {
     const plain = Object.fromEntries(
       Object.entries(entry.fields).map(([k, v]) => [k, serializeFieldValue(v)])
     );
-    try {
-      line += ` ${JSON.stringify(plain)}`;
-    } catch (err) {
-      line += ` [unserializable fields: ${err instanceof Error ? err.message : String(err)}]`;
-    }
+    line += ` ${stringifyJson(plain)}`;
   }
   return line;
 }
@@ -947,6 +943,8 @@ var PARAM_TYPE_MAP = {
   // 任务子系统：TaskClient（入队/查询）
   log: "log",
   // 请求级日志器（ctx.log 同一实例：scope http，自动带 requestId 等字段）
+  llm: "llm",
+  // 轻量 LLM 补全通道（@faapi/agent 插件注册到 registries.llm；未加载时 undefined）
   // raw 系：恒原始输入（无 schema、无校验、管线永不转换），与 query/params/body
   // 的「校验转换后」口径二分互补
   rawQuery: "rawQuery",
@@ -1190,6 +1188,20 @@ function createAgentHandleStore() {
     }
   };
 }
+function createLlmChannelStore() {
+  let current = null;
+  return {
+    register(channel) {
+      current = channel;
+    },
+    get() {
+      return current ?? void 0;
+    },
+    clear() {
+      current = null;
+    }
+  };
+}
 function createTaskHandleStore() {
   let currentFactory = null;
   return {
@@ -1212,7 +1224,8 @@ function createAppRegistries() {
   const task = createTaskRegistry();
   const agentHandle = createAgentHandleStore();
   const taskHandle = createTaskHandleStore();
-  return { tool, agent, skill, task, agentHandle, taskHandle };
+  const llm = createLlmChannelStore();
+  return { tool, agent, skill, task, agentHandle, taskHandle, llm };
 }
 var defaultRegistries = createAppRegistries();
 
@@ -1276,6 +1289,10 @@ function getBuiltinInjectionValue(type, ctx, body) {
     // 任务子系统：注入 TaskClient（入队/查询）；未注册工厂（无 app 编排）时 undefined
     case "tasks":
       return ctx.registries ? ctx.registries.taskHandle.get(ctx) : void 0;
+    // 轻量 LLM 补全通道：@faapi/agent 插件注册到 registries.llm；与请求上下文无关，
+    // get 无参。插件未加载（或编程式直调 ctx 无 registries）时 undefined
+    case "llm":
+      return ctx.registries ? ctx.registries.llm.get() : void 0;
     // 请求级日志器：与 ctx.log 同一实例（scope http，自动带 requestId/method/path 字段）
     case "log":
       return ctx.log;
@@ -1499,38 +1516,30 @@ function setCachedMiddlewares(absPath, bundle) {
   middlewareCache.set(absPath, bundle);
 }
 async function loadMiddlewaresFile(filePath) {
-  let module;
-  try {
-    module = await importWithCacheBust(filePath);
-  } catch (err) {
-    console.error(
-      `[faapi] Failed to load middlewares from ${filePath}:`,
-      err instanceof Error ? err.stack ?? err.message : err
-    );
-    return { middlewares: [], injectors: {} };
-  }
+  const module = await importWithCacheBust(filePath);
   const middlewares = module.default ?? module.middlewares ?? [];
   if (!Array.isArray(middlewares)) {
-    console.warn(`[faapi] middlewares.ts \u5E94\u5BFC\u51FA\u6570\u7EC4\uFF0C\u5DF2\u5FFD\u7565: ${filePath}`);
-    return { middlewares: [], injectors: {} };
+    throw new TypeError(
+      `[faapi] middlewares.ts must export an array (default or named "middlewares"): ${filePath}`
+    );
   }
-  const validMiddlewares = middlewares.filter((m) => {
+  const validMiddlewares = [];
+  for (const m of middlewares) {
     if (typeof m !== "function") {
-      console.warn(`[faapi] \u65E0\u6548\u7684\u4E2D\u95F4\u4EF6\u9879\uFF08\u5E94\u4E3A\u51FD\u6570\uFF09\uFF0C\u5DF2\u5FFD\u7565: ${typeof m}`);
-      return false;
+      throw new TypeError(
+        `[faapi] every middleware must be a function, got ${typeof m}: ${filePath}`
+      );
     }
-    return true;
-  });
+    validMiddlewares.push(m);
+  }
   const injectors = module.injectors ?? {};
   if (typeof injectors !== "object" || injectors === null) {
-    console.warn(`[faapi] injectors \u5E94\u5BFC\u51FA\u5BF9\u8C61\uFF0C\u5DF2\u5FFD\u7565: ${filePath}`);
-    return { middlewares: validMiddlewares, injectors: {} };
+    throw new TypeError(`[faapi] "injectors" export must be an object: ${filePath}`);
   }
   const validInjectors = {};
   for (const [name, injector] of Object.entries(injectors)) {
     if (typeof injector !== "function") {
-      console.warn(`[faapi] \u6CE8\u5165\u5668 ${name} \u5E94\u4E3A\u51FD\u6570\uFF0C\u5DF2\u5FFD\u7565`);
-      continue;
+      throw new TypeError(`[faapi] injector "${name}" must be a function: ${filePath}`);
     }
     validInjectors[name] = injector;
   }
@@ -1545,10 +1554,16 @@ async function loadMergedMiddlewares(middlewarePaths) {
     if (bundle === void 0) {
       let loading = inFlight.get(absMwPath);
       if (!loading) {
-        loading = loadMiddlewaresFile(absMwPath).then((result) => {
-          setCachedMiddlewares(absMwPath, result);
-          return result;
-        });
+        loading = loadMiddlewaresFile(absMwPath).then(
+          (result) => {
+            setCachedMiddlewares(absMwPath, result);
+            return result;
+          },
+          (err) => {
+            inFlight.delete(absMwPath);
+            throw err;
+          }
+        );
         inFlight.set(absMwPath, loading);
       }
       bundle = await loading;
@@ -3732,11 +3747,7 @@ async function ensureMiddlewaresCompiled(middlewarePaths, rootDir) {
   if (!dist) return;
   for (const mwPath of middlewarePaths) {
     const sourcePath = prodPathToSourcePath(mwPath, rootDir, dist);
-    try {
-      await ensureCompiled(sourcePath, rootDir, dist);
-    } catch (err) {
-      console.error(`[faapi] Failed to compile middleware source ${sourcePath}:`, err);
-    }
+    await ensureCompiled(sourcePath, rootDir, dist);
   }
 }
 function prodSourcePathToProductPath(sourceAbsPath, rootDir, dist) {
@@ -5256,7 +5267,8 @@ async function sendErrorResponse(err, meta, res, onError, ctx) {
   if (onError && ctx) {
     try {
       await onError(err, ctx);
-    } catch {
+    } catch (hookErr) {
+      console.error("[faapi] lifecycle onError hook threw:", hookErr);
     }
   }
 }