@faapi/faapi 6.19.0 → 6.21.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FaapiMiddleware, A as AppRegistries, R as RouteManifest, a as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LogConfig, I as InjectorMap, b as TaskFailedHandler, c as TaskQueueDeps, d as TaskQueue, e as TaskDriver, f as TaskRegistry, g as TaskManifest, h as ToolMetadata, i as AgentCore, j as AgentMetadata, k as CreateLoggerOptions, l as Logger, W as WsRouteManifest } from './routeTypes-DTqdo28V.js';
-export { m as AgentHandleFactory, n as AgentHandleStore, o as AgentPathMeta, p as AgentRegistry, q as AgentToolDescriptor, r as FaapiContextConfig, s as FaapiTaskMeta, t as FailOptions, u as Injector, v as LogEntry, w as LogLevel, x as LogSink, y as RouteInfo, z as RouteInputSchema, B as RouteOutputSchema, D as RouteParamSchema, S as SkillRegistry, E as SseEvent, G as SseWriter, J as TaskContext, K as TaskDriverJob, M as TaskDriverProcess, N as TaskDriverRecord, O as TaskFailedInfo, P as TaskJob, Q as TaskJobStatus, U as TaskMetadata, V as TaskModule, X as TaskRegistriesSnapshot, Y as TaskRegistriesView, Z as ToolCore, _ as ToolPathMeta, $ as ToolRegistry, a0 as cors, a1 as createAppRegistries, a2 as createTaskRegistriesView, a3 as createTaskRegistry, a4 as helmet } from './routeTypes-DTqdo28V.js';
+import { F as FaapiMiddleware, A as AppRegistries, R as RouteManifest, a as FaapiContext, C as CorsOptions, T as TaskClient, H as HelmetOptions, L as LogConfig, I as InjectorMap, b as TaskFailedHandler, W as WsRouteManifest, c as TaskQueueDeps, d as TaskQueue, e as TaskDriver, f as TaskRegistry, g as TaskManifest, h as ToolMetadata, i as AgentCore, j as AgentMetadata, k as CreateLoggerOptions, l as Logger } from './routeTypes-gyz4PMh7.js';
+export { m as AgentHandleFactory, n as AgentHandleStore, o as AgentPathMeta, p as AgentRegistry, q as AgentToolDescriptor, r as FaapiContextConfig, s as FaapiTaskMeta, t as FailOptions, u as Injector, v as LogEntry, w as LogLevel, x as LogSink, y as RouteInfo, z as RouteInputSchema, B as RouteOutputSchema, D as RouteParamSchema, S as SkillRegistry, E as SseEvent, G as SseWriter, J as TaskContext, K as TaskDriverJob, M as TaskDriverProcess, N as TaskDriverRecord, O as TaskFailedInfo, P as TaskJob, Q as TaskJobStatus, U as TaskMetadata, V as TaskModule, X as TaskRegistriesSnapshot, Y as TaskRegistriesView, Z as ToolCore, _ as ToolPathMeta, $ as ToolRegistry, a0 as cors, a1 as createAppRegistries, a2 as createTaskRegistriesView, a3 as createTaskRegistry, a4 as helmet } from './routeTypes-gyz4PMh7.js';
 import * as node_http from 'node:http';
 import { Server, IncomingMessage, ServerResponse } from 'node:http';
 import { Socket } from 'node:net';
@@ -824,12 +824,21 @@ interface WsEventHandlers {
  *
  * 与 HTTP FaapiContext 类似但精简，提供路由参数、查询参数、请求头、配置。
  * 可通过 declare module '@faapi/faapi' 增强自定义字段。
+ *
+ * 输入口径与 HTTP 一致（二分）：params/query 为校验转换后的值，rawParams/rawQuery
+ * 恒为原始值。声明来源是 handler.ts 的文件级约定——导出 `WS` 且同文件声明
+ * `export interface Query` / `export interface Params` 时，握手阶段按声明类型
+ * 校验并转换（失败拒绝握手）；未声明时 params/query 保持 URL 原始字符串。
  */
 interface WsContext {
-    /** 动态路由参数（如 [id] → params.id） */
-    params: Record<string, string>;
-    /** URL 查询参数 */
-    query: URLSearchParams;
+    /** 动态路由参数（声明 Params 时校验转换，未声明为 URL 原始字符串） */
+    params: Record<string, string | number | boolean>;
+    /** 动态路由参数的原始值（恒 URL 字符串，校验不触及） */
+    rawParams: Record<string, string>;
+    /** URL 查询参数（声明 Query 时校验转换，未声明为原始字符串对象） */
+    query: Record<string, unknown>;
+    /** URL 查询参数的原始值（恒 URLSearchParams） */
+    rawQuery: URLSearchParams;
     /** 请求头 */
     headers: Headers;
     /** 业务配置（来自 faapi.config.ts） */
@@ -1156,21 +1165,7 @@ interface RouteSchemaSource {
      */
     coerce?: boolean;
 }
-/**
- * 从路由清单收集 schema 提取所需的原始数据
- *
- * dev 和 prd 共享的核心提取流程：
- * 1. 按文件分组遍历路由
- * 2. 批量共享 Program（同一次提取只按文件组创建少量 Program）
- * 3. 对每个路由用 analyzeInjectionInSourceFile 定位入口参数类型，
- *    extractTypeInfo 解析入口类型（入口类型必须严格解析，失败抛 SchemaExtractionError）
- * 4. 返回按文件分组的惰性类型解析器——generateSchemaFiles 生成 zod.js 时
- *    遇到 ref（同文件循环引用）按需解析并缓存
- *
- * 惰性语义：与路由无关的类型（未被任何入口类型引用）不会被解析——文件里
- * 存在一个含不支持语法的无关类型不再拖垮整个 build/reload。
- */
-declare function collectRouteSchemaSources(routes: RouteManifest, rootDir?: string): {
+declare function collectRouteSchemaSources(routes: RouteManifest, rootDir?: string, wsRoutes?: WsRouteManifest): {
     sources: RouteSchemaSource[];
     /** 按文件分组的惰性类型解析器（generateSchemaFiles 解析 ref 用） */
     resolversByFile: Map<string, LazyTypeResolver>;