vafast 0.5.15 → 0.5.17

package/dist/{defineRoute-D61MtjQB.d.mts → defineRoute-DyPa9FHa.d.mts}

@@ -89,6 +89,8 @@ interface ProcessedRoute {
   /** 允许任意扩展（兼容 Route 类型） */
   [key: string]: unknown;
 }
+/** Route 类型别名（便于用户使用） */
+type Route = ProcessedRoute;
 /**
  * 定义带类型的中间件（函数式风格）
  *
@@ -246,5 +248,5 @@ type InferableRoute<TMethod extends string = string, TPath extends string = stri
   readonly middleware?: ReadonlyArray<AnyMiddleware>;
 };
 //#endregion
-export { ProcessedRoute as a, TypedMiddleware as c, defineRoutes as d, withContext as f, NestedRouteConfig as i, defineMiddleware as l, InferableRoute as n, RouteSchema as o, LeafRouteConfig as r, RoutesWithSource as s, HandlerContext as t, defineRoute as u };
-//# sourceMappingURL=defineRoute-D61MtjQB.d.mts.map
+export { ProcessedRoute as a, RoutesWithSource as c, defineRoute as d, defineRoutes as f, NestedRouteConfig as i, TypedMiddleware as l, InferableRoute as n, Route as o, withContext as p, LeafRouteConfig as r, RouteSchema as s, HandlerContext as t, defineMiddleware as u };
+//# sourceMappingURL=defineRoute-DyPa9FHa.d.mts.map

package/dist/defineRoute.d.mts

@@ -1,2 +1,2 @@
-import { a as ProcessedRoute, c as TypedMiddleware, d as defineRoutes, f as withContext, i as NestedRouteConfig, l as defineMiddleware, n as InferableRoute, o as RouteSchema, r as LeafRouteConfig, s as RoutesWithSource, t as HandlerContext, u as defineRoute } from "./defineRoute-D61MtjQB.mjs";
-export { HandlerContext, InferableRoute, LeafRouteConfig, NestedRouteConfig, ProcessedRoute, RouteSchema, RoutesWithSource, TypedMiddleware, defineMiddleware, defineRoute, defineRoutes, withContext };
+import { a as ProcessedRoute, c as RoutesWithSource, d as defineRoute, f as defineRoutes, i as NestedRouteConfig, l as TypedMiddleware, n as InferableRoute, o as Route, p as withContext, r as LeafRouteConfig, s as RouteSchema, t as HandlerContext, u as defineMiddleware } from "./defineRoute-DyPa9FHa.mjs";
+export { HandlerContext, InferableRoute, LeafRouteConfig, NestedRouteConfig, ProcessedRoute, Route, RouteSchema, RoutesWithSource, TypedMiddleware, defineMiddleware, defineRoute, defineRoutes, withContext };

package/dist/defineRoute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"defineRoute.mjs","names":[],"sources":["../src/defineRoute.ts"],"sourcesContent":["/**\n * 路由定义 - Schema 在路由级别定义，支持嵌套路由和中间件类型推断\n *\n * @example\n * ```typescript\n * // 定义带类型的中间件（函数式风格，通过 next 传递上下文）\n * const authMiddleware = defineMiddleware<{ user: User }>((req, next) => {\n *   const user = getUser(req)\n *   return next({ user })  // 通过 next 参数传递上下文\n * })\n *\n * // 路由自动推断中间件注入的类型\n * const routes = defineRoutes([\n *   defineRoute({\n *     path: '/api',\n *     middleware: [authMiddleware],\n *     children: [\n *       defineRoute({\n *         method: 'GET',\n *         path: '/profile',\n *         handler: ({ user }) => ({ name: user.name })  // ✅ user 有类型\n *       })\n *     ]\n *   })\n * ])\n * ```\n */\n\nimport type { TSchema, Static } from \"@sinclair/typebox\";\nimport { parseBody, parseQuery, parseHeaders, parseCookies } from \"./utils/parsers\";\nimport { validateAllSchemas, precompileSchemas } from \"./utils/validators/validators\";\nimport { json } from \"./utils/response\";\nimport { VafastError } from \"./middleware\";\n\n// ============= Schema 类型 =============\n\n/** 路由 Schema 配置 */\nexport interface RouteSchema {\n  body?: TSchema;\n  query?: TSchema;\n  params?: TSchema;\n  headers?: TSchema;\n  cookies?: TSchema;\n  /** 响应类型 schema（用于类型同步，运行时不做校验） */\n  response?: TSchema;\n}\n\n/** 从 Schema 推断类型 */\ntype InferSchemaType<T extends RouteSchema> = {\n  body: T[\"body\"] extends TSchema ? Static<T[\"body\"]> : unknown;\n  query: T[\"query\"] extends TSchema ? Static<T[\"query\"]> : Record<string, string>;\n  params: T[\"params\"] extends TSchema ? Static<T[\"params\"]> : Record<string, string>;\n  headers: T[\"headers\"] extends TSchema ? Static<T[\"headers\"]> : Record<string, string>;\n  cookies: T[\"cookies\"] extends TSchema ? Static<T[\"cookies\"]> : Record<string, string>;\n};\n\n// ============= 中间件类型系统 =============\n\n/** 带类型标记的中间件 */\nexport interface TypedMiddleware<TContext extends object = object> {\n  (req: Request, next: (ctx?: TContext) => Promise<Response>): Response | Promise<Response>;\n  /** 类型标记（仅编译时使用） */\n  __context?: TContext;\n}\n\n/** 普通中间件（无类型注入） */\ntype PlainMiddleware = (req: Request, next: () => Promise<Response>) => Response | Promise<Response>;\n\n/** 任意中间件类型 */\ntype AnyMiddleware = TypedMiddleware<object> | PlainMiddleware;\n\n/** 从中间件提取上下文类型 */\ntype ExtractMiddlewareContext<T> = T extends TypedMiddleware<infer C> ? C : object;\n\n/** 合并中间件数组的上下文类型 */\ntype MergeMiddlewareContexts<T extends readonly unknown[]> =\n  T extends readonly [infer First, ...infer Rest]\n  ? ExtractMiddlewareContext<First> & MergeMiddlewareContexts<Rest>\n  : object;\n\n// ============= Handler 上下文 =============\n\n/** Handler 上下文（包含 schema 推断） */\nexport interface HandlerContext<TSchema extends RouteSchema = RouteSchema> {\n  req: Request;\n  body: InferSchemaType<TSchema>[\"body\"];\n  query: InferSchemaType<TSchema>[\"query\"];\n  params: InferSchemaType<TSchema>[\"params\"];\n  headers: InferSchemaType<TSchema>[\"headers\"];\n  cookies: InferSchemaType<TSchema>[\"cookies\"];\n}\n\n/** Handler 上下文（带中间件注入的额外类型） */\ntype HandlerContextWithExtra<TSchema extends RouteSchema, TExtra> =\n  HandlerContext<TSchema> & TExtra;\n\n// ============= 路由配置类型 =============\n\n/** HTTP 方法 */\ntype HTTPMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\" | \"OPTIONS\" | \"HEAD\";\n\n/** 叶子路由配置（有 method 和 handler） */\nexport interface LeafRouteConfig<\n  TMethod extends HTTPMethod = HTTPMethod,\n  TPath extends string = string,\n  TSchema extends RouteSchema = RouteSchema,\n  TReturn = unknown,\n  TMiddleware extends readonly AnyMiddleware[] = readonly AnyMiddleware[]\n> {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: TSchema;\n  readonly handler: (\n    ctx: HandlerContextWithExtra<TSchema, MergeMiddlewareContexts<TMiddleware>>\n  ) => TReturn | Promise<TReturn>;\n  readonly middleware?: TMiddleware;\n  readonly docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n}\n\n/** 嵌套路由配置（有 children，无 method 和 handler） */\nexport interface NestedRouteConfig<\n  TPath extends string = string,\n  TMiddleware extends readonly AnyMiddleware[] = readonly AnyMiddleware[]\n> {\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly middleware?: TMiddleware;\n  readonly children: ReadonlyArray<RouteConfigResult>;\n}\n\n/** defineRoute 返回的类型 */\ntype RouteConfigResult =\n  | LeafRouteConfig<HTTPMethod, string, RouteSchema, unknown, readonly AnyMiddleware[]>\n  | NestedRouteConfig<string, readonly AnyMiddleware[]>;\n\n/** 处理后的扁平路由 */\nexport interface ProcessedRoute {\n  method: HTTPMethod;\n  path: string;\n  name?: string;\n  description?: string;\n  schema?: RouteSchema;\n  handler: (req: Request) => Promise<Response>;\n  middleware?: readonly AnyMiddleware[];\n  docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n  /** 允许任意扩展（兼容 Route 类型） */\n  [key: string]: unknown;\n}\n\n// ============= defineMiddleware =============\n\n/**\n * 定义带类型的中间件（函数式风格）\n *\n * 通过 next() 参数传递上下文，更符合函数式编程风格\n *\n * @example\n * ```typescript\n * type AuthContext = { user: { id: string; name: string } }\n *\n * const authMiddleware = defineMiddleware<AuthContext>((req, next) => {\n *   const user = getUserFromToken(req)\n *   return next({ user })  // 通过 next 传递上下文\n * })\n * ```\n */\nexport function defineMiddleware<TContext extends object = object>(\n  handler: (\n    req: Request,\n    next: (ctx?: TContext) => Promise<Response>\n  ) => Promise<Response>\n): TypedMiddleware<TContext> {\n  // 包装成标准中间件签名\n  const middleware = ((req: Request, originalNext: () => Promise<Response>) => {\n    // 包装 next，接收上下文参数并存储到 req.__locals\n    const nextWithContext = (ctx?: TContext): Promise<Response> => {\n      if (ctx) {\n        const target = req as unknown as { __locals?: object };\n        target.__locals = { ...(target.__locals || {}), ...ctx };\n      }\n      return originalNext();\n    };\n    return handler(req, nextWithContext);\n  }) as TypedMiddleware<TContext>;\n\n  return middleware;\n}\n\n// ============= 响应处理 =============\n\n/** 自动转换返回值为 Response */\nfunction autoResponse(result: unknown): Response {\n  if (result instanceof Response) return result;\n  if (result === null || result === undefined) return new Response(null, { status: 204 });\n  if (typeof result === \"string\") {\n    return new Response(result, { headers: { \"Content-Type\": \"text/plain; charset=utf-8\" } });\n  }\n  if (typeof result === \"number\" || typeof result === \"boolean\") {\n    return new Response(String(result), { headers: { \"Content-Type\": \"text/plain; charset=utf-8\" } });\n  }\n  if (typeof result === \"object\") {\n    const obj = result as Record<string, unknown>;\n    if (\"data\" in obj && (\"status\" in obj || \"headers\" in obj)) {\n      const { data, status = 200, headers = {} } = obj;\n      if (data === null || data === undefined) {\n        return new Response(null, { status: status === 200 ? 204 : (status as number), headers: headers as HeadersInit });\n      }\n      return json(data, status as number, headers as Record<string, string>);\n    }\n    return json(result);\n  }\n  return new Response(null, { status: 204 });\n}\n\n/** 创建包装后的 handler */\nfunction wrapHandler<TSchema extends RouteSchema>(\n  schema: TSchema | undefined,\n  userHandler: (ctx: HandlerContext<TSchema>) => unknown | Promise<unknown>\n): (req: Request) => Promise<Response> {\n  if (schema && (schema.body || schema.query || schema.params || schema.headers || schema.cookies)) {\n    precompileSchemas(schema);\n  }\n\n  return async (req: Request): Promise<Response> => {\n    try {\n      const query = parseQuery(req);\n      const headers = parseHeaders(req);\n      const cookies = parseCookies(req);\n      const params = ((req as unknown as Record<string, unknown>).params as Record<string, string>) || {};\n\n      let body: unknown = undefined;\n      if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n        try {\n          body = await parseBody(req);\n        } catch {\n          // 忽略解析错误\n        }\n      }\n\n      const data = { body, query, params, headers, cookies };\n      if (schema && (schema.body || schema.query || schema.params || schema.headers || schema.cookies)) {\n        validateAllSchemas(schema, data);\n      }\n\n      // 获取中间件注入的上下文\n      const extraCtx = (req as unknown as { __locals?: unknown }).__locals || {};\n\n      const result = await userHandler({\n        req,\n        body: body as HandlerContext<TSchema>[\"body\"],\n        query: query as HandlerContext<TSchema>[\"query\"],\n        params: params as HandlerContext<TSchema>[\"params\"],\n        headers: headers as HandlerContext<TSchema>[\"headers\"],\n        cookies: cookies as HandlerContext<TSchema>[\"cookies\"],\n        ...extraCtx,\n      } as HandlerContext<TSchema>);\n\n      return autoResponse(result);\n    } catch (error) {\n      // 如果是 VafastError，重新抛出让错误处理中间件处理\n      if (error instanceof VafastError) {\n        throw error;\n      }\n      if (error instanceof Error && error.message.includes(\"验证失败\")) {\n        return json({ code: 400, message: error.message }, 400);\n      }\n      return json({ code: 500, message: error instanceof Error ? error.message : \"未知错误\" }, 500);\n    }\n  };\n}\n\n// ============= 判断路由类型 =============\n\n/** 判断是否为叶子路由 */\nfunction isLeafRoute(route: RouteConfigResult): route is LeafRouteConfig {\n  return \"method\" in route && \"handler\" in route;\n}\n\n/** 判断是否为嵌套路由 */\nfunction isNestedRoute(route: RouteConfigResult): route is NestedRouteConfig {\n  return \"children\" in route;\n}\n\n// ============= defineRoute 函数（支持重载） =============\n\n/**\n * 定义叶子路由（有 method 和 handler），支持中间件类型推断和显式上下文类型\n *\n * @example\n * ```typescript\n * // 方式1：通过中间件自动推断上下文\n * defineRoute({\n *   method: 'GET',\n *   path: '/profile',\n *   middleware: [authMiddleware],\n *   handler: ({ user }) => { ... }  // user 来自 authMiddleware\n * })\n *\n * // 方式2：显式声明上下文类型（用于父级中间件注入的场景）\n * defineRoute({\n *   method: 'GET',\n *   path: '/profile',\n *   context: {} as { userInfo: UserInfo },\n *   handler: ({ userInfo }) => { ... }  // userInfo 有类型\n * })\n * ```\n */\nexport function defineRoute<\n  const TSchema extends RouteSchema,\n  TReturn,\n  const TMiddleware extends readonly AnyMiddleware[],\n  TContext extends object = object,\n  TMethod extends HTTPMethod = HTTPMethod,\n  TPath extends string = string\n>(config: {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: TSchema;\n  /** 显式声明上下文类型（用于父级中间件注入的场景） */\n  readonly context?: TContext;\n  readonly handler: (\n    ctx: HandlerContextWithExtra<TSchema, TContext & MergeMiddlewareContexts<TMiddleware>>\n  ) => TReturn | Promise<TReturn>;\n  readonly middleware?: TMiddleware;\n  readonly docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n}): LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware>;\n\n/**\n * 定义嵌套路由（有 children），支持中间件类型推断\n */\nexport function defineRoute<\n  const TMiddleware extends readonly AnyMiddleware[],\n  TPath extends string = string\n>(config: {\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly middleware?: TMiddleware;\n  readonly children: ReadonlyArray<RouteConfigResult>;\n}): NestedRouteConfig<TPath, TMiddleware>;\n\n/**\n * defineRoute 实现\n */\nexport function defineRoute(config: {\n  readonly method?: HTTPMethod;\n  readonly path: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: RouteSchema;\n  readonly context?: object;\n  readonly handler?: (ctx: HandlerContext<RouteSchema>) => unknown | Promise<unknown>;\n  readonly middleware?: readonly AnyMiddleware[];\n  readonly children?: ReadonlyArray<RouteConfigResult>;\n  readonly docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n}): RouteConfigResult {\n  return config as RouteConfigResult;\n}\n\n// ============= withContext 工厂函数 =============\n\n/**\n * 创建带预设上下文类型的路由定义器\n *\n * 用于父级中间件注入上下文的场景，定义一次，多处复用\n *\n * @example\n * ```typescript\n * // 1. 在 middleware/index.ts 中定义\n * export const defineAuthRoute = withContext<{ userInfo: UserInfo }>()\n *\n * // 2. 在路由文件中使用\n * defineAuthRoute({\n *   method: 'GET',\n *   path: '/profile',\n *   handler: ({ userInfo }) => {\n *     // userInfo 自动有类型！\n *     return { id: userInfo.id }\n *   }\n * })\n * ```\n */\n/**\n * 带扩展类型的路由定义器\n *\n * @typeParam TContext - Handler 上下文类型（如 { userInfo: UserInfo }）\n * @typeParam TExtensions - 路由扩展字段类型（如 { webhook?: boolean }）\n *\n * @example\n * ```typescript\n * // 定义扩展类型\n * interface WebhookExtension {\n *   webhook?: boolean | { eventKey?: string }\n * }\n *\n * // 使用扩展\n * const defineRoute = withContext<MyContext, WebhookExtension>()\n * defineRoute({\n *   method: 'POST',\n *   path: '/create',\n *   webhook: true,  // TypeScript 严格检查\n *   handler: ...\n * })\n * ```\n */\nexport function withContext<\n  TContext extends object,\n  TExtensions extends object = object\n>() {\n  return <\n    const TSchema extends RouteSchema,\n    TReturn,\n    const TMiddleware extends readonly AnyMiddleware[],\n    TMethod extends HTTPMethod = HTTPMethod,\n    TPath extends string = string\n  >(config: {\n    readonly method: TMethod;\n    readonly path: TPath;\n    readonly name?: string;\n    readonly description?: string;\n    readonly schema?: TSchema;\n    readonly handler: (\n      ctx: HandlerContextWithExtra<TSchema, TContext & MergeMiddlewareContexts<TMiddleware>>\n    ) => TReturn | Promise<TReturn>;\n    readonly middleware?: TMiddleware;\n    readonly docs?: {\n      tags?: string[];\n      security?: unknown[];\n      responses?: Record<string, unknown>;\n    };\n  } & TExtensions): LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware> => {\n    return config as unknown as LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware>;\n  };\n}\n\n// ============= 扁平化嵌套路由 =============\n\n/** 父级路由信息 */\ninterface ParentRouteInfo {\n  /** 父级路由路径 */\n  path: string;\n  /** 父级路由名称 */\n  name?: string;\n  /** 父级路由描述 */\n  description?: string;\n}\n\n/**\n * 递归扁平化路由，合并路径和中间件\n */\nfunction flattenRoutes(\n  routes: ReadonlyArray<RouteConfigResult>,\n  parentPath: string = \"\",\n  parentMiddleware: readonly AnyMiddleware[] = [],\n  parent?: ParentRouteInfo\n): ProcessedRoute[] {\n  const result: ProcessedRoute[] = [];\n\n  for (const route of routes) {\n    const fullPath = parentPath + route.path;\n    const mergedMiddleware = [...parentMiddleware, ...(route.middleware || [])];\n\n    if (isLeafRoute(route)) {\n      // 基础属性\n      const processed: ProcessedRoute = {\n        method: route.method,\n        path: fullPath,\n        name: route.name,\n        description: route.description,\n        schema: route.schema,\n        handler: wrapHandler(route.schema, route.handler as (ctx: HandlerContext<RouteSchema>) => unknown),\n        middleware: mergedMiddleware.length > 0 ? mergedMiddleware : undefined,\n        docs: route.docs,\n      };\n      // 添加父级路由信息\n      if (parent) {\n        processed.parent = parent;\n      }\n      // 复制扩展属性（如 webhook, permission 等）\n      const knownKeys = ['method', 'path', 'name', 'description', 'schema', 'handler', 'middleware', 'docs'];\n      for (const key of Object.keys(route)) {\n        if (!knownKeys.includes(key)) {\n          processed[key] = (route as unknown as Record<string, unknown>)[key];\n        }\n      }\n      result.push(processed);\n    } else if (isNestedRoute(route)) {\n      // 传递当前路由信息作为子路由的 parent\n      const currentParent: ParentRouteInfo = {\n        path: fullPath,\n        name: route.name,\n        description: route.description,\n      };\n      result.push(...flattenRoutes(route.children, fullPath, mergedMiddleware, currentParent));\n    }\n  }\n\n  return result;\n}\n\n// ============= defineRoutes 函数 =============\n\n/** 带原始类型信息的路由数组 */\nexport type RoutesWithSource<T extends readonly RouteConfigResult[]> = ProcessedRoute[] & { __source: T };\n\n/**\n * 定义路由数组，支持嵌套路由\n *\n * 使用 `const T` 泛型自动保留字面量类型，无需手动添加 `as const`\n *\n * @example\n * ```typescript\n * const routes = defineRoutes([\n *   defineRoute({ method: 'GET', path: '/users', handler: ... }),\n *   defineRoute({ method: 'POST', path: '/users', handler: ... }),\n * ])\n *\n * // 类型推断自动工作，无需 as const\n * type Api = InferEden<typeof routes>\n * ```\n */\nexport function defineRoutes<const T extends readonly RouteConfigResult[]>(\n  routes: T\n): RoutesWithSource<T> {\n  const processed = flattenRoutes(routes);\n  // 附加原始类型信息（仅用于类型推断，运行时不使用）\n  return Object.assign(processed, { __source: routes }) as RoutesWithSource<T>;\n}\n\n// ============= 用于 API Client 的类型推断 =============\n\n/** 可推断的路由类型（供 vafast-api-client 使用） */\nexport type InferableRoute<\n  TMethod extends string = string,\n  TPath extends string = string,\n  TReturn = unknown,\n  TSchema extends RouteSchema = RouteSchema\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: TSchema;\n  readonly handler: {\n    __returnType: TReturn;\n    __schema: TSchema;\n  };\n  readonly middleware?: ReadonlyArray<AnyMiddleware>;\n};\n"],"mappings":"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"}
+{"version":3,"file":"defineRoute.mjs","names":[],"sources":["../src/defineRoute.ts"],"sourcesContent":["/**\n * 路由定义 - Schema 在路由级别定义，支持嵌套路由和中间件类型推断\n *\n * @example\n * ```typescript\n * // 定义带类型的中间件（函数式风格，通过 next 传递上下文）\n * const authMiddleware = defineMiddleware<{ user: User }>((req, next) => {\n *   const user = getUser(req)\n *   return next({ user })  // 通过 next 参数传递上下文\n * })\n *\n * // 路由自动推断中间件注入的类型\n * const routes = defineRoutes([\n *   defineRoute({\n *     path: '/api',\n *     middleware: [authMiddleware],\n *     children: [\n *       defineRoute({\n *         method: 'GET',\n *         path: '/profile',\n *         handler: ({ user }) => ({ name: user.name })  // ✅ user 有类型\n *       })\n *     ]\n *   })\n * ])\n * ```\n */\n\nimport type { TSchema, Static } from \"@sinclair/typebox\";\nimport { parseBody, parseQuery, parseHeaders, parseCookies } from \"./utils/parsers\";\nimport { validateAllSchemas, precompileSchemas } from \"./utils/validators/validators\";\nimport { json } from \"./utils/response\";\nimport { VafastError } from \"./middleware\";\n\n// ============= Schema 类型 =============\n\n/** 路由 Schema 配置 */\nexport interface RouteSchema {\n  body?: TSchema;\n  query?: TSchema;\n  params?: TSchema;\n  headers?: TSchema;\n  cookies?: TSchema;\n  /** 响应类型 schema（用于类型同步，运行时不做校验） */\n  response?: TSchema;\n}\n\n/** 从 Schema 推断类型 */\ntype InferSchemaType<T extends RouteSchema> = {\n  body: T[\"body\"] extends TSchema ? Static<T[\"body\"]> : unknown;\n  query: T[\"query\"] extends TSchema ? Static<T[\"query\"]> : Record<string, string>;\n  params: T[\"params\"] extends TSchema ? Static<T[\"params\"]> : Record<string, string>;\n  headers: T[\"headers\"] extends TSchema ? Static<T[\"headers\"]> : Record<string, string>;\n  cookies: T[\"cookies\"] extends TSchema ? Static<T[\"cookies\"]> : Record<string, string>;\n};\n\n// ============= 中间件类型系统 =============\n\n/** 带类型标记的中间件 */\nexport interface TypedMiddleware<TContext extends object = object> {\n  (req: Request, next: (ctx?: TContext) => Promise<Response>): Response | Promise<Response>;\n  /** 类型标记（仅编译时使用） */\n  __context?: TContext;\n}\n\n/** 普通中间件（无类型注入） */\ntype PlainMiddleware = (req: Request, next: () => Promise<Response>) => Response | Promise<Response>;\n\n/** 任意中间件类型 */\ntype AnyMiddleware = TypedMiddleware<object> | PlainMiddleware;\n\n/** 从中间件提取上下文类型 */\ntype ExtractMiddlewareContext<T> = T extends TypedMiddleware<infer C> ? C : object;\n\n/** 合并中间件数组的上下文类型 */\ntype MergeMiddlewareContexts<T extends readonly unknown[]> =\n  T extends readonly [infer First, ...infer Rest]\n  ? ExtractMiddlewareContext<First> & MergeMiddlewareContexts<Rest>\n  : object;\n\n// ============= Handler 上下文 =============\n\n/** Handler 上下文（包含 schema 推断） */\nexport interface HandlerContext<TSchema extends RouteSchema = RouteSchema> {\n  req: Request;\n  body: InferSchemaType<TSchema>[\"body\"];\n  query: InferSchemaType<TSchema>[\"query\"];\n  params: InferSchemaType<TSchema>[\"params\"];\n  headers: InferSchemaType<TSchema>[\"headers\"];\n  cookies: InferSchemaType<TSchema>[\"cookies\"];\n}\n\n/** Handler 上下文（带中间件注入的额外类型） */\ntype HandlerContextWithExtra<TSchema extends RouteSchema, TExtra> =\n  HandlerContext<TSchema> & TExtra;\n\n// ============= 路由配置类型 =============\n\n/** HTTP 方法 */\ntype HTTPMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\" | \"OPTIONS\" | \"HEAD\";\n\n/** 叶子路由配置（有 method 和 handler） */\nexport interface LeafRouteConfig<\n  TMethod extends HTTPMethod = HTTPMethod,\n  TPath extends string = string,\n  TSchema extends RouteSchema = RouteSchema,\n  TReturn = unknown,\n  TMiddleware extends readonly AnyMiddleware[] = readonly AnyMiddleware[]\n> {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: TSchema;\n  readonly handler: (\n    ctx: HandlerContextWithExtra<TSchema, MergeMiddlewareContexts<TMiddleware>>\n  ) => TReturn | Promise<TReturn>;\n  readonly middleware?: TMiddleware;\n  readonly docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n}\n\n/** 嵌套路由配置（有 children，无 method 和 handler） */\nexport interface NestedRouteConfig<\n  TPath extends string = string,\n  TMiddleware extends readonly AnyMiddleware[] = readonly AnyMiddleware[]\n> {\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly middleware?: TMiddleware;\n  readonly children: ReadonlyArray<RouteConfigResult>;\n}\n\n/** defineRoute 返回的类型 */\ntype RouteConfigResult =\n  | LeafRouteConfig<HTTPMethod, string, RouteSchema, unknown, readonly AnyMiddleware[]>\n  | NestedRouteConfig<string, readonly AnyMiddleware[]>;\n\n/** 处理后的扁平路由 */\nexport interface ProcessedRoute {\n  method: HTTPMethod;\n  path: string;\n  name?: string;\n  description?: string;\n  schema?: RouteSchema;\n  handler: (req: Request) => Promise<Response>;\n  middleware?: readonly AnyMiddleware[];\n  docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n  /** 允许任意扩展（兼容 Route 类型） */\n  [key: string]: unknown;\n}\n\n/** Route 类型别名（便于用户使用） */\nexport type Route = ProcessedRoute;\n\n// ============= defineMiddleware =============\n\n/**\n * 定义带类型的中间件（函数式风格）\n *\n * 通过 next() 参数传递上下文，更符合函数式编程风格\n *\n * @example\n * ```typescript\n * type AuthContext = { user: { id: string; name: string } }\n *\n * const authMiddleware = defineMiddleware<AuthContext>((req, next) => {\n *   const user = getUserFromToken(req)\n *   return next({ user })  // 通过 next 传递上下文\n * })\n * ```\n */\nexport function defineMiddleware<TContext extends object = object>(\n  handler: (\n    req: Request,\n    next: (ctx?: TContext) => Promise<Response>\n  ) => Promise<Response>\n): TypedMiddleware<TContext> {\n  // 包装成标准中间件签名\n  const middleware = ((req: Request, originalNext: () => Promise<Response>) => {\n    // 包装 next，接收上下文参数并存储到 req.__locals\n    const nextWithContext = (ctx?: TContext): Promise<Response> => {\n      if (ctx) {\n        const target = req as unknown as { __locals?: object };\n        target.__locals = { ...(target.__locals || {}), ...ctx };\n      }\n      return originalNext();\n    };\n    return handler(req, nextWithContext);\n  }) as TypedMiddleware<TContext>;\n\n  return middleware;\n}\n\n// ============= 响应处理 =============\n\n/** 自动转换返回值为 Response */\nfunction autoResponse(result: unknown): Response {\n  if (result instanceof Response) return result;\n  if (result === null || result === undefined) return new Response(null, { status: 204 });\n  if (typeof result === \"string\") {\n    return new Response(result, { headers: { \"Content-Type\": \"text/plain; charset=utf-8\" } });\n  }\n  if (typeof result === \"number\" || typeof result === \"boolean\") {\n    return new Response(String(result), { headers: { \"Content-Type\": \"text/plain; charset=utf-8\" } });\n  }\n  if (typeof result === \"object\") {\n    const obj = result as Record<string, unknown>;\n    if (\"data\" in obj && (\"status\" in obj || \"headers\" in obj)) {\n      const { data, status = 200, headers = {} } = obj;\n      if (data === null || data === undefined) {\n        return new Response(null, { status: status === 200 ? 204 : (status as number), headers: headers as HeadersInit });\n      }\n      return json(data, status as number, headers as Record<string, string>);\n    }\n    return json(result);\n  }\n  return new Response(null, { status: 204 });\n}\n\n/** 创建包装后的 handler */\nfunction wrapHandler<TSchema extends RouteSchema>(\n  schema: TSchema | undefined,\n  userHandler: (ctx: HandlerContext<TSchema>) => unknown | Promise<unknown>\n): (req: Request) => Promise<Response> {\n  if (schema && (schema.body || schema.query || schema.params || schema.headers || schema.cookies)) {\n    precompileSchemas(schema);\n  }\n\n  return async (req: Request): Promise<Response> => {\n    try {\n      const query = parseQuery(req);\n      const headers = parseHeaders(req);\n      const cookies = parseCookies(req);\n      const params = ((req as unknown as Record<string, unknown>).params as Record<string, string>) || {};\n\n      let body: unknown = undefined;\n      if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n        try {\n          body = await parseBody(req);\n        } catch {\n          // 忽略解析错误\n        }\n      }\n\n      const data = { body, query, params, headers, cookies };\n      if (schema && (schema.body || schema.query || schema.params || schema.headers || schema.cookies)) {\n        validateAllSchemas(schema, data);\n      }\n\n      // 获取中间件注入的上下文\n      const extraCtx = (req as unknown as { __locals?: unknown }).__locals || {};\n\n      const result = await userHandler({\n        req,\n        body: body as HandlerContext<TSchema>[\"body\"],\n        query: query as HandlerContext<TSchema>[\"query\"],\n        params: params as HandlerContext<TSchema>[\"params\"],\n        headers: headers as HandlerContext<TSchema>[\"headers\"],\n        cookies: cookies as HandlerContext<TSchema>[\"cookies\"],\n        ...extraCtx,\n      } as HandlerContext<TSchema>);\n\n      return autoResponse(result);\n    } catch (error) {\n      // 如果是 VafastError，重新抛出让错误处理中间件处理\n      if (error instanceof VafastError) {\n        throw error;\n      }\n      if (error instanceof Error && error.message.includes(\"验证失败\")) {\n        return json({ code: 400, message: error.message }, 400);\n      }\n      return json({ code: 500, message: error instanceof Error ? error.message : \"未知错误\" }, 500);\n    }\n  };\n}\n\n// ============= 判断路由类型 =============\n\n/** 判断是否为叶子路由 */\nfunction isLeafRoute(route: RouteConfigResult): route is LeafRouteConfig {\n  return \"method\" in route && \"handler\" in route;\n}\n\n/** 判断是否为嵌套路由 */\nfunction isNestedRoute(route: RouteConfigResult): route is NestedRouteConfig {\n  return \"children\" in route;\n}\n\n// ============= defineRoute 函数（支持重载） =============\n\n/**\n * 定义叶子路由（有 method 和 handler），支持中间件类型推断和显式上下文类型\n *\n * @example\n * ```typescript\n * // 方式1：通过中间件自动推断上下文\n * defineRoute({\n *   method: 'GET',\n *   path: '/profile',\n *   middleware: [authMiddleware],\n *   handler: ({ user }) => { ... }  // user 来自 authMiddleware\n * })\n *\n * // 方式2：显式声明上下文类型（用于父级中间件注入的场景）\n * defineRoute({\n *   method: 'GET',\n *   path: '/profile',\n *   context: {} as { userInfo: UserInfo },\n *   handler: ({ userInfo }) => { ... }  // userInfo 有类型\n * })\n * ```\n */\nexport function defineRoute<\n  const TSchema extends RouteSchema,\n  TReturn,\n  const TMiddleware extends readonly AnyMiddleware[],\n  TContext extends object = object,\n  TMethod extends HTTPMethod = HTTPMethod,\n  TPath extends string = string\n>(config: {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: TSchema;\n  /** 显式声明上下文类型（用于父级中间件注入的场景） */\n  readonly context?: TContext;\n  readonly handler: (\n    ctx: HandlerContextWithExtra<TSchema, TContext & MergeMiddlewareContexts<TMiddleware>>\n  ) => TReturn | Promise<TReturn>;\n  readonly middleware?: TMiddleware;\n  readonly docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n}): LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware>;\n\n/**\n * 定义嵌套路由（有 children），支持中间件类型推断\n */\nexport function defineRoute<\n  const TMiddleware extends readonly AnyMiddleware[],\n  TPath extends string = string\n>(config: {\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly middleware?: TMiddleware;\n  readonly children: ReadonlyArray<RouteConfigResult>;\n}): NestedRouteConfig<TPath, TMiddleware>;\n\n/**\n * defineRoute 实现\n */\nexport function defineRoute(config: {\n  readonly method?: HTTPMethod;\n  readonly path: string;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: RouteSchema;\n  readonly context?: object;\n  readonly handler?: (ctx: HandlerContext<RouteSchema>) => unknown | Promise<unknown>;\n  readonly middleware?: readonly AnyMiddleware[];\n  readonly children?: ReadonlyArray<RouteConfigResult>;\n  readonly docs?: {\n    tags?: string[];\n    security?: unknown[];\n    responses?: Record<string, unknown>;\n  };\n}): RouteConfigResult {\n  return config as RouteConfigResult;\n}\n\n// ============= withContext 工厂函数 =============\n\n/**\n * 创建带预设上下文类型的路由定义器\n *\n * 用于父级中间件注入上下文的场景，定义一次，多处复用\n *\n * @example\n * ```typescript\n * // 1. 在 middleware/index.ts 中定义\n * export const defineAuthRoute = withContext<{ userInfo: UserInfo }>()\n *\n * // 2. 在路由文件中使用\n * defineAuthRoute({\n *   method: 'GET',\n *   path: '/profile',\n *   handler: ({ userInfo }) => {\n *     // userInfo 自动有类型！\n *     return { id: userInfo.id }\n *   }\n * })\n * ```\n */\n/**\n * 带扩展类型的路由定义器\n *\n * @typeParam TContext - Handler 上下文类型（如 { userInfo: UserInfo }）\n * @typeParam TExtensions - 路由扩展字段类型（如 { webhook?: boolean }）\n *\n * @example\n * ```typescript\n * // 定义扩展类型\n * interface WebhookExtension {\n *   webhook?: boolean | { eventKey?: string }\n * }\n *\n * // 使用扩展\n * const defineRoute = withContext<MyContext, WebhookExtension>()\n * defineRoute({\n *   method: 'POST',\n *   path: '/create',\n *   webhook: true,  // TypeScript 严格检查\n *   handler: ...\n * })\n * ```\n */\nexport function withContext<\n  TContext extends object,\n  TExtensions extends object = object\n>() {\n  return <\n    const TSchema extends RouteSchema,\n    TReturn,\n    const TMiddleware extends readonly AnyMiddleware[],\n    TMethod extends HTTPMethod = HTTPMethod,\n    TPath extends string = string\n  >(config: {\n    readonly method: TMethod;\n    readonly path: TPath;\n    readonly name?: string;\n    readonly description?: string;\n    readonly schema?: TSchema;\n    readonly handler: (\n      ctx: HandlerContextWithExtra<TSchema, TContext & MergeMiddlewareContexts<TMiddleware>>\n    ) => TReturn | Promise<TReturn>;\n    readonly middleware?: TMiddleware;\n    readonly docs?: {\n      tags?: string[];\n      security?: unknown[];\n      responses?: Record<string, unknown>;\n    };\n  } & TExtensions): LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware> => {\n    return config as unknown as LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware>;\n  };\n}\n\n// ============= 扁平化嵌套路由 =============\n\n/** 父级路由信息 */\ninterface ParentRouteInfo {\n  /** 父级路由路径 */\n  path: string;\n  /** 父级路由名称 */\n  name?: string;\n  /** 父级路由描述 */\n  description?: string;\n}\n\n/**\n * 递归扁平化路由，合并路径和中间件\n */\nfunction flattenRoutes(\n  routes: ReadonlyArray<RouteConfigResult>,\n  parentPath: string = \"\",\n  parentMiddleware: readonly AnyMiddleware[] = [],\n  parent?: ParentRouteInfo\n): ProcessedRoute[] {\n  const result: ProcessedRoute[] = [];\n\n  for (const route of routes) {\n    const fullPath = parentPath + route.path;\n    const mergedMiddleware = [...parentMiddleware, ...(route.middleware || [])];\n\n    if (isLeafRoute(route)) {\n      // 基础属性\n      const processed: ProcessedRoute = {\n        method: route.method,\n        path: fullPath,\n        name: route.name,\n        description: route.description,\n        schema: route.schema,\n        handler: wrapHandler(route.schema, route.handler as (ctx: HandlerContext<RouteSchema>) => unknown),\n        middleware: mergedMiddleware.length > 0 ? mergedMiddleware : undefined,\n        docs: route.docs,\n      };\n      // 添加父级路由信息\n      if (parent) {\n        processed.parent = parent;\n      }\n      // 复制扩展属性（如 webhook, permission 等）\n      const knownKeys = ['method', 'path', 'name', 'description', 'schema', 'handler', 'middleware', 'docs'];\n      for (const key of Object.keys(route)) {\n        if (!knownKeys.includes(key)) {\n          processed[key] = (route as unknown as Record<string, unknown>)[key];\n        }\n      }\n      result.push(processed);\n    } else if (isNestedRoute(route)) {\n      // 传递当前路由信息作为子路由的 parent\n      const currentParent: ParentRouteInfo = {\n        path: fullPath,\n        name: route.name,\n        description: route.description,\n      };\n      result.push(...flattenRoutes(route.children, fullPath, mergedMiddleware, currentParent));\n    }\n  }\n\n  return result;\n}\n\n// ============= defineRoutes 函数 =============\n\n/** 带原始类型信息的路由数组 */\nexport type RoutesWithSource<T extends readonly RouteConfigResult[]> = ProcessedRoute[] & { __source: T };\n\n/**\n * 定义路由数组，支持嵌套路由\n *\n * 使用 `const T` 泛型自动保留字面量类型，无需手动添加 `as const`\n *\n * @example\n * ```typescript\n * const routes = defineRoutes([\n *   defineRoute({ method: 'GET', path: '/users', handler: ... }),\n *   defineRoute({ method: 'POST', path: '/users', handler: ... }),\n * ])\n *\n * // 类型推断自动工作，无需 as const\n * type Api = InferEden<typeof routes>\n * ```\n */\nexport function defineRoutes<const T extends readonly RouteConfigResult[]>(\n  routes: T\n): RoutesWithSource<T> {\n  const processed = flattenRoutes(routes);\n  // 附加原始类型信息（仅用于类型推断，运行时不使用）\n  return Object.assign(processed, { __source: routes }) as RoutesWithSource<T>;\n}\n\n// ============= 用于 API Client 的类型推断 =============\n\n/** 可推断的路由类型（供 vafast-api-client 使用） */\nexport type InferableRoute<\n  TMethod extends string = string,\n  TPath extends string = string,\n  TReturn = unknown,\n  TSchema extends RouteSchema = RouteSchema\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly name?: string;\n  readonly description?: string;\n  readonly schema?: TSchema;\n  readonly handler: {\n    __returnType: TReturn;\n    __schema: TSchema;\n  };\n  readonly middleware?: ReadonlyArray<AnyMiddleware>;\n};\n"],"mappings":"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"}

package/dist/{index-WHjhlID8.d.mts → index-j2oxSDgD.d.mts}

@@ -1,6 +1,6 @@
-import { a as ProcessedRoute } from "./defineRoute-D61MtjQB.mjs";
+import { a as ProcessedRoute } from "./defineRoute-DyPa9FHa.mjs";
 import { r as NestedComponentRoute, t as ComponentRoute } from "./component-route-Di7R40-2.mjs";
-import { t as Server } from "./server-3-gj9ULj.mjs";
+import { t as Server } from "./server-hNmt20PQ.mjs";
 import { t as ComponentServer } from "./component-server-fR4UV6Jq.mjs";
 
 //#region src/server/server-factory.d.ts
@@ -45,4 +45,4 @@ declare class ServerFactory {
 }
 //#endregion
 export { ServerFactory as t };
-//# sourceMappingURL=index-WHjhlID8.d.mts.map
+//# sourceMappingURL=index-j2oxSDgD.d.mts.map

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { a as ProcessedRoute, c as TypedMiddleware, d as defineRoutes, f as withContext, i as NestedRouteConfig, l as defineMiddleware, n as InferableRoute, o as RouteSchema, r as LeafRouteConfig, s as RoutesWithSource, t as HandlerContext, u as defineRoute } from "./defineRoute-D61MtjQB.mjs";
+import { a as ProcessedRoute, c as RoutesWithSource, d as defineRoute, f as defineRoutes, i as NestedRouteConfig, l as TypedMiddleware, n as InferableRoute, o as Route, p as withContext, r as LeafRouteConfig, s as RouteSchema, t as HandlerContext, u as defineMiddleware } from "./defineRoute-DyPa9FHa.mjs";
 import { i as ResponseBody, n as Method, r as Middleware, t as Handler } from "./types-B8Z3cMtZ.mjs";
 import { n as FlattenedComponentRoute, r as NestedComponentRoute, t as ComponentRoute } from "./component-route-Di7R40-2.mjs";
 import { t as BaseServer } from "./base-server-Contwrlf.mjs";
-import { t as Server } from "./server-3-gj9ULj.mjs";
+import { t as Server } from "./server-hNmt20PQ.mjs";
 import { t as DependencyManager } from "./dependency-manager-DIN9X0Gj.mjs";
 import { t as ComponentServer } from "./component-server-fR4UV6Jq.mjs";
-import { t as ServerFactory } from "./index-WHjhlID8.mjs";
+import { t as ServerFactory } from "./index-j2oxSDgD.mjs";
 import { n as composeMiddleware, t as VafastError } from "./middleware-CrD2gfzt.mjs";
 import { a as parseBody, c as parseCookiesFast, d as parseHeaders, f as parseQuery, i as getHeader, p as parseQueryFast, r as getCookie, s as parseCookies } from "./parsers-8hIAx0OV.mjs";
 import { c as text, i as json, n as err, o as redirect, r as html, s as stream, t as empty } from "./response-CJcO5s7Q.mjs";
@@ -14,12 +14,12 @@ import { n as base64urlEncode, t as base64urlDecode } from "./base64url-DNUGwekK
 import { t as HtmlRenderer } from "./html-renderer-DhQxRuyi.mjs";
 import { a as ValidationError, c as getValidatorCacheStats, d as validateFast, f as validateSchema, l as precompileSchemas, o as ValidationResult, p as validateSchemaOrThrow, s as createValidator, t as SchemaConfig, u as validateAllSchemas } from "./validators-BFC6S_fr.mjs";
 import { i as registerFormats, n as hasFormat, r as registerFormat, t as Patterns } from "./formats-DDDSFWP0.mjs";
-import { a as createSSEHandler, i as SSEMarker, r as SSEHandler, t as SSEEvent } from "./sse-BVNHu5J4.mjs";
-import { a as getAllRoutes, c as getRoutesByMethod, i as filterRoutes, n as RouteRegistry, o as getRoute, r as createRouteRegistry, s as getRouteRegistry, t as RouteMeta } from "./route-registry-Dh8CSDDh.mjs";
+import { a as createSSEHandler, i as SSEMarker, r as SSEHandler, t as SSEEvent } from "./sse-CjIH9WjQ.mjs";
+import { a as getAllRoutes, c as getRoutesByMethod, i as filterRoutes, n as RouteRegistry, o as getRoute, r as createRouteRegistry, s as getRouteRegistry, t as RouteMeta } from "./route-registry-QBYYbUGm.mjs";
 import { n as generateAITools, r as getApiSpec, t as ApiSpec } from "./contract-C9wzCRMW.mjs";
 import "./utils/index.mjs";
 import { normalizePath } from "./router.mjs";
 import { i as ServeResult, o as serve, r as ServeOptions, t as FetchHandler } from "./serve-DlzxgOhz.mjs";
 import "./serve.mjs";
 import { FormatRegistry, Type } from "@sinclair/typebox";
-export { ApiSpec, BaseServer, ComponentRoute, ComponentServer, DependencyManager, type FetchHandler, FlattenedComponentRoute, FormatRegistry, Handler, HandlerContext, HtmlRenderer, InferableRoute, LeafRouteConfig, Method, Middleware, NestedComponentRoute, NestedRouteConfig, Patterns, ProcessedRoute, ResponseBody, RouteMeta, RouteRegistry, RouteSchema, RoutesWithSource, SSEEvent, SSEHandler, SSEMarker, SchemaConfig, type ServeOptions, type ServeResult, Server, ServerFactory, Type, TypedMiddleware, VafastError, ValidationError, ValidationResult, base64urlDecode, base64urlEncode, composeMiddleware, createRouteRegistry, createSSEHandler, createValidator, defineMiddleware, defineRoute, defineRoutes, empty, err, filterRoutes, generateAITools, getAllRoutes, getApiSpec, getCookie, getHeader, getRoute, getRouteRegistry, getRoutesByMethod, getValidatorCacheStats, goAwait, hasFormat, html, json, normalizePath, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, precompileSchemas, redirect, registerFormat, registerFormats, serve, stream, text, validateAllSchemas, validateFast, validateSchema, validateSchemaOrThrow, withContext };
+export { ApiSpec, BaseServer, ComponentRoute, ComponentServer, DependencyManager, type FetchHandler, FlattenedComponentRoute, FormatRegistry, Handler, HandlerContext, HtmlRenderer, InferableRoute, LeafRouteConfig, Method, Middleware, NestedComponentRoute, NestedRouteConfig, Patterns, ProcessedRoute, ResponseBody, Route, RouteMeta, RouteRegistry, RouteSchema, RoutesWithSource, SSEEvent, SSEHandler, SSEMarker, SchemaConfig, type ServeOptions, type ServeResult, Server, ServerFactory, Type, TypedMiddleware, VafastError, ValidationError, ValidationResult, base64urlDecode, base64urlEncode, composeMiddleware, createRouteRegistry, createSSEHandler, createValidator, defineMiddleware, defineRoute, defineRoutes, empty, err, filterRoutes, generateAITools, getAllRoutes, getApiSpec, getCookie, getHeader, getRoute, getRouteRegistry, getRoutesByMethod, getValidatorCacheStats, goAwait, hasFormat, html, json, normalizePath, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, precompileSchemas, redirect, registerFormat, registerFormats, serve, stream, text, validateAllSchemas, validateFast, validateSchema, validateSchemaOrThrow, withContext };

package/dist/monitoring/index.d.mts

@@ -1,5 +1,5 @@
-import "../defineRoute-D61MtjQB.mjs";
-import "../server-3-gj9ULj.mjs";
-import "../index-WHjhlID8.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
+import "../server-hNmt20PQ.mjs";
+import "../index-j2oxSDgD.mjs";
 import { MemoryInfo, MonitoredServer, MonitoringConfig, MonitoringMetrics, MonitoringStatus, PathStats, StatusCodeDistribution, TimeWindowStats, createMonitoredServer, withMonitoring } from "./native-monitor.mjs";
 export { type MemoryInfo, type MonitoredServer, type MonitoringConfig, type MonitoringMetrics, type MonitoringStatus, type PathStats, type StatusCodeDistribution, type TimeWindowStats, createMonitoredServer, withMonitoring };

package/dist/monitoring/native-monitor.d.mts

@@ -1,6 +1,6 @@
-import "../defineRoute-D61MtjQB.mjs";
-import { t as Server } from "../server-3-gj9ULj.mjs";
-import "../index-WHjhlID8.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
+import { t as Server } from "../server-hNmt20PQ.mjs";
+import "../index-j2oxSDgD.mjs";
 
 //#region src/monitoring/native-monitor.d.ts
 

package/dist/{route-registry-Dh8CSDDh.d.mts → route-registry-QBYYbUGm.d.mts}

@@ -1,4 +1,4 @@
-import { a as ProcessedRoute, o as RouteSchema } from "./defineRoute-D61MtjQB.mjs";
+import { a as ProcessedRoute, s as RouteSchema } from "./defineRoute-DyPa9FHa.mjs";
 import { n as Method } from "./types-B8Z3cMtZ.mjs";
 
 //#region src/utils/route-registry.d.ts
@@ -187,4 +187,4 @@ declare function filterRoutes<K extends string>(field: K): (RouteMeta & Record<K
 declare function getRoutesByMethod(method: string): RouteMeta[];
 //#endregion
 export { getAllRoutes as a, getRoutesByMethod as c, filterRoutes as i, setGlobalRegistry as l, RouteRegistry as n, getRoute as o, createRouteRegistry as r, getRouteRegistry as s, RouteMeta as t };
-//# sourceMappingURL=route-registry-Dh8CSDDh.d.mts.map
+//# sourceMappingURL=route-registry-QBYYbUGm.d.mts.map

package/dist/server/index.d.mts

@@ -1,6 +1,6 @@
-import "../defineRoute-D61MtjQB.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
 import { t as BaseServer } from "../base-server-Contwrlf.mjs";
-import { t as Server } from "../server-3-gj9ULj.mjs";
+import { t as Server } from "../server-hNmt20PQ.mjs";
 import { t as ComponentServer } from "../component-server-fR4UV6Jq.mjs";
-import { t as ServerFactory } from "../index-WHjhlID8.mjs";
+import { t as ServerFactory } from "../index-j2oxSDgD.mjs";
 export { BaseServer, ComponentServer, Server, ServerFactory };

package/dist/server/server-factory.d.mts

@@ -1,4 +1,4 @@
-import "../defineRoute-D61MtjQB.mjs";
-import "../server-3-gj9ULj.mjs";
-import { t as ServerFactory } from "../index-WHjhlID8.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
+import "../server-hNmt20PQ.mjs";
+import { t as ServerFactory } from "../index-j2oxSDgD.mjs";
 export { ServerFactory };

package/dist/server/server.d.mts

@@ -1,3 +1,3 @@
-import "../defineRoute-D61MtjQB.mjs";
-import { t as Server } from "../server-3-gj9ULj.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
+import { t as Server } from "../server-hNmt20PQ.mjs";
 export { Server };

package/dist/{server-3-gj9ULj.d.mts → server-hNmt20PQ.d.mts}

@@ -1,4 +1,4 @@
-import { a as ProcessedRoute } from "./defineRoute-D61MtjQB.mjs";
+import { a as ProcessedRoute } from "./defineRoute-DyPa9FHa.mjs";
 import { n as Method } from "./types-B8Z3cMtZ.mjs";
 import { t as BaseServer } from "./base-server-Contwrlf.mjs";
 
@@ -45,4 +45,4 @@ declare class Server extends BaseServer {
 }
 //#endregion
 export { Server as t };
-//# sourceMappingURL=server-3-gj9ULj.d.mts.map
+//# sourceMappingURL=server-hNmt20PQ.d.mts.map

package/dist/{sse-BVNHu5J4.d.mts → sse-CjIH9WjQ.d.mts}

@@ -1,4 +1,4 @@
-import { o as RouteSchema, t as HandlerContext } from "./defineRoute-D61MtjQB.mjs";
+import { s as RouteSchema, t as HandlerContext } from "./defineRoute-DyPa9FHa.mjs";
 
 //#region src/utils/sse.d.ts
 
@@ -26,17 +26,19 @@ type SSEMarker = {
   readonly __brand: 'SSE';
 };
 /**
- * SSE Handler 类型标记
+ * SSE Handler 类型
  * 支持两种调用方式：
  * 1. route('GET', '/path', handler) - 传入 Request
  * 2. defineRoute({ handler }) - 传入 HandlerContext
+ *
+ * 泛型默认为 RouteSchema，避免复杂类型传播
  */
 interface SSEHandler<TSchema extends RouteSchema = RouteSchema> {
   (reqOrCtx: Request | HandlerContext<TSchema>): Promise<Response>;
   /** 返回类型标记 - SSE 流的数据类型 */
-  readonly __returnType: unknown;
+  readonly __returnType?: unknown;
   /** SSE 标记 - 使用品牌类型确保不被扩展 */
-  readonly __sse: SSEMarker;
+  readonly __sse?: SSEMarker;
 }
 /**
  * 创建 SSE 流式响应处理器
@@ -65,8 +67,15 @@ interface SSEHandler<TSchema extends RouteSchema = RouteSchema> {
  * })
  * ```
  */
-declare function createSSEHandler<const T extends RouteSchema>(schema: T, generator: SSEGenerator<T>): SSEHandler<T>;
+/**
+ * 带 schema 的 SSE handler
+ * 泛型 T 用于内部类型检查，返回基础类型避免复杂推断
+ */
+declare function createSSEHandler<const T extends RouteSchema>(schema: T, generator: SSEGenerator<T>): SSEHandler<RouteSchema>;
+/**
+ * 无 schema 的 SSE handler
+ */
 declare function createSSEHandler(generator: SSEGenerator<RouteSchema>): SSEHandler<RouteSchema>;
 //#endregion
 export { createSSEHandler as a, SSEMarker as i, SSEGenerator as n, SSEHandler as r, SSEEvent as t };
-//# sourceMappingURL=sse-BVNHu5J4.d.mts.map
+//# sourceMappingURL=sse-CjIH9WjQ.d.mts.map

package/dist/sse-Dws4pJi8.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sse-Dws4pJi8.mjs","names":[],"sources":["../src/utils/sse.ts"],"sourcesContent":["/**\n * Server-Sent Events (SSE) 支持\n *\n * 用于实现流式响应，如 AI 聊天、实时通知等\n *\n * @example\n * ```typescript\n * import { createSSEHandler, Type } from 'vafast'\n *\n * const streamHandler = createSSEHandler(\n *   { query: Type.Object({ prompt: Type.String() }) },\n *   async function* ({ query }) {\n *     yield { event: 'start', data: { message: 'Starting...' } }\n *\n *     for await (const chunk of aiStream(query.prompt)) {\n *       yield { data: chunk }\n *     }\n *\n *     yield { event: 'end', data: { message: 'Done!' } }\n *   }\n * )\n * ```\n */\n\nimport type { RouteSchema, HandlerContext } from \"../defineRoute\";\nimport { parseQuery, parseHeaders, parseCookies } from \"./parsers\";\nimport { precompileSchemas, validateAllSchemas } from \"./validators/validators\";\n\n/**\n * SSE 事件类型\n */\nexport interface SSEEvent<T = unknown> {\n  /** 事件名称（可选，默认为 message） */\n  event?: string;\n  /** 事件数据 */\n  data: T;\n  /** 事件 ID（可选） */\n  id?: string;\n  /** 重试间隔（毫秒，可选） */\n  retry?: number;\n}\n\n/**\n * SSE 生成器函数类型\n */\nexport type SSEGenerator<T extends RouteSchema = RouteSchema> = (\n  ctx: HandlerContext<T>\n) => AsyncGenerator<SSEEvent<unknown>, void, unknown>;\n\n/**\n * 格式化 SSE 事件为字符串\n */\nfunction formatSSEEvent(event: SSEEvent): string {\n  const lines: string[] = [];\n\n  if (event.id !== undefined) {\n    lines.push(`id: ${event.id}`);\n  }\n\n  if (event.event !== undefined) {\n    lines.push(`event: ${event.event}`);\n  }\n\n  if (event.retry !== undefined) {\n    lines.push(`retry: ${event.retry}`);\n  }\n\n  // 数据可能是多行的，需要分行处理\n  const dataStr = typeof event.data === 'string'\n    ? event.data\n    : JSON.stringify(event.data);\n\n  const dataLines = dataStr.split('\\n');\n  for (const line of dataLines) {\n    lines.push(`data: ${line}`);\n  }\n\n  return lines.join('\\n') + '\\n\\n';\n}\n\n/**\n * SSE 标记类型 - 使用字面量品牌类型\n */\nexport type SSEMarker = { readonly __brand: 'SSE' }\n\n/**\n * SSE Handler 类型标记\n * 支持两种调用方式：\n * 1. route('GET', '/path', handler) - 传入 Request\n * 2. defineRoute({ handler }) - 传入 HandlerContext\n */\nexport interface SSEHandler<TSchema extends RouteSchema = RouteSchema> {\n  (reqOrCtx: Request | HandlerContext<TSchema>): Promise<Response>;\n  /** 返回类型标记 - SSE 流的数据类型 */\n  readonly __returnType: unknown;\n  /** SSE 标记 - 使用品牌类型确保不被扩展 */\n  readonly __sse: SSEMarker;\n}\n\n/**\n * 创建 SSE 流式响应处理器\n *\n * 支持两种使用方式：\n *\n * @example\n * ```typescript\n * const streamHandler = createSSEHandler(\n *   { params: Type.Object({ id: Type.String() }) },\n *   async function* ({ params }) {\n *     yield { data: { status: 'started' } };\n *     // ... 业务逻辑\n *     yield { data: { status: 'done' } };\n *   }\n * );\n *\n * // 方式 1: 低层 API（route 函数）\n * route('GET', '/stream/:id', streamHandler)\n *\n * // 方式 2: 高层 API（defineRoute 函数）✅ 现在也支持\n * defineRoute({\n *   method: 'GET',\n *   path: '/stream/:id',\n *   handler: streamHandler,\n * })\n * ```\n */\nexport function createSSEHandler<const T extends RouteSchema>(\n  schema: T,\n  generator: SSEGenerator<T>\n): SSEHandler<T>;\n\nexport function createSSEHandler(\n  generator: SSEGenerator<RouteSchema>\n): SSEHandler<RouteSchema>;\n\nexport function createSSEHandler<const T extends RouteSchema>(\n  schemaOrGenerator: T | SSEGenerator<T>,\n  maybeGenerator?: SSEGenerator<T>\n): SSEHandler<T> {\n  // 判断调用方式\n  const hasSchema = typeof schemaOrGenerator !== 'function';\n  const schema = hasSchema ? (schemaOrGenerator as T) : ({} as T);\n  const generator = hasSchema\n    ? maybeGenerator!\n    : (schemaOrGenerator as SSEGenerator<T>);\n\n  // 预编译 schema\n  if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {\n    precompileSchemas(schema);\n  }\n\n  /**\n   * 检测是否是 HandlerContext（来自 defineRoute）\n   * HandlerContext 有 req 属性，而 Request 没有\n   */\n  const isHandlerContext = (arg: unknown): arg is HandlerContext<T> => {\n    return arg !== null &&\n      typeof arg === 'object' &&\n      'req' in arg &&\n      'params' in arg;\n  };\n\n  const handlerFn = async (reqOrCtx: Request | HandlerContext<T>): Promise<Response> => {\n    try {\n      let req: Request;\n      let query: Record<string, string>;\n      let headers: Record<string, string>;\n      let cookies: Record<string, string>;\n      let params: Record<string, string>;\n      let body: unknown;\n\n      // 检测调用方式\n      if (isHandlerContext(reqOrCtx)) {\n        // 方式 2: defineRoute 传入的 HandlerContext\n        req = reqOrCtx.req;\n        query = reqOrCtx.query as Record<string, string>;\n        headers = reqOrCtx.headers as Record<string, string>;\n        cookies = reqOrCtx.cookies as Record<string, string>;\n        params = reqOrCtx.params as Record<string, string>;\n        body = reqOrCtx.body;\n      } else {\n        // 方式 1: route() 传入的 Request\n        req = reqOrCtx;\n        query = parseQuery(req) as Record<string, string>;\n        headers = parseHeaders(req) as Record<string, string>;\n        cookies = parseCookies(req) as Record<string, string>;\n        params = ((req as unknown as Record<string, unknown>).params as Record<string, string>) || {};\n        body = undefined;\n      }\n\n      // 验证 schema（仅在方式 1 时需要，方式 2 已由 defineRoute 验证）\n      if (!isHandlerContext(reqOrCtx)) {\n        const data = { body, query, params, headers, cookies };\n        if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {\n          validateAllSchemas(schema, data);\n        }\n      }\n\n      // 创建 SSE 流\n      const stream = new ReadableStream({\n        async start(controller) {\n          const encoder = new TextEncoder();\n\n          try {\n            const gen = generator({\n              req,\n              body: body as HandlerContext<T>['body'],\n              query: query as HandlerContext<T>['query'],\n              params: params as HandlerContext<T>['params'],\n              headers: headers as HandlerContext<T>['headers'],\n              cookies: cookies as HandlerContext<T>['cookies'],\n            });\n\n            for await (const event of gen) {\n              const formatted = formatSSEEvent(event);\n              controller.enqueue(encoder.encode(formatted));\n            }\n          } catch (error) {\n            // 发送错误事件\n            const errorEvent = formatSSEEvent({\n              event: 'error',\n              data: {\n                message: error instanceof Error ? error.message : 'Unknown error'\n              }\n            });\n            controller.enqueue(encoder.encode(errorEvent));\n          } finally {\n            controller.close();\n          }\n        }\n      });\n\n      return new Response(stream, {\n        headers: {\n          'Content-Type': 'text/event-stream',\n          'Cache-Control': 'no-cache',\n          'Connection': 'keep-alive',\n          'X-Accel-Buffering': 'no', // Nginx 禁用缓冲\n        }\n      });\n    } catch (error) {\n      // 验证错误等\n      return new Response(\n        JSON.stringify({\n          code: 400,\n          message: error instanceof Error ? error.message : 'Unknown error'\n        }),\n        {\n          status: 400,\n          headers: { 'Content-Type': 'application/json' }\n        }\n      );\n    }\n  };\n\n  // 添加类型标记\n  const handler = handlerFn as SSEHandler<T>;\n  (handler as unknown as { __sse: SSEMarker }).__sse = { __brand: 'SSE' } as const;\n  (handler as unknown as { __returnType: unknown }).__returnType = undefined;\n  return handler;\n}\n\n\n"],"mappings":";;;;;;;AAoDA,SAAS,eAAe,OAAyB;CAC/C,MAAM,QAAkB,EAAE;AAE1B,KAAI,MAAM,OAAO,OACf,OAAM,KAAK,OAAO,MAAM,KAAK;AAG/B,KAAI,MAAM,UAAU,OAClB,OAAM,KAAK,UAAU,MAAM,QAAQ;AAGrC,KAAI,MAAM,UAAU,OAClB,OAAM,KAAK,UAAU,MAAM,QAAQ;CAQrC,MAAM,aAJU,OAAO,MAAM,SAAS,WAClC,MAAM,OACN,KAAK,UAAU,MAAM,KAAK,EAEJ,MAAM,KAAK;AACrC,MAAK,MAAM,QAAQ,UACjB,OAAM,KAAK,SAAS,OAAO;AAG7B,QAAO,MAAM,KAAK,KAAK,GAAG;;AA0D5B,SAAgB,iBACd,mBACA,gBACe;CAEf,MAAM,YAAY,OAAO,sBAAsB;CAC/C,MAAM,SAAS,YAAa,oBAA2B,EAAE;CACzD,MAAM,YAAY,YACd,iBACC;AAGL,KAAI,OAAO,QAAQ,OAAO,SAAS,OAAO,UAAU,OAAO,WAAW,OAAO,QAC3E,mBAAkB,OAAO;;;;;CAO3B,MAAM,oBAAoB,QAA2C;AACnE,SAAO,QAAQ,QACb,OAAO,QAAQ,YACf,SAAS,OACT,YAAY;;CAGhB,MAAM,YAAY,OAAO,aAA6D;AACpF,MAAI;GACF,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;AAGJ,OAAI,iBAAiB,SAAS,EAAE;AAE9B,UAAM,SAAS;AACf,YAAQ,SAAS;AACjB,cAAU,SAAS;AACnB,cAAU,SAAS;AACnB,aAAS,SAAS;AAClB,WAAO,SAAS;UACX;AAEL,UAAM;AACN,YAAQ,WAAW,IAAI;AACvB,cAAU,aAAa,IAAI;AAC3B,cAAU,aAAa,IAAI;AAC3B,aAAW,IAA2C,UAAqC,EAAE;AAC7F,WAAO;;AAIT,OAAI,CAAC,iBAAiB,SAAS,EAAE;IAC/B,MAAM,OAAO;KAAE;KAAM;KAAO;KAAQ;KAAS;KAAS;AACtD,QAAI,OAAO,QAAQ,OAAO,SAAS,OAAO,UAAU,OAAO,WAAW,OAAO,QAC3E,oBAAmB,QAAQ,KAAK;;GAKpC,MAAM,SAAS,IAAI,eAAe,EAChC,MAAM,MAAM,YAAY;IACtB,MAAM,UAAU,IAAI,aAAa;AAEjC,QAAI;KACF,MAAM,MAAM,UAAU;MACpB;MACM;MACC;MACC;MACC;MACA;MACV,CAAC;AAEF,gBAAW,MAAM,SAAS,KAAK;MAC7B,MAAM,YAAY,eAAe,MAAM;AACvC,iBAAW,QAAQ,QAAQ,OAAO,UAAU,CAAC;;aAExC,OAAO;KAEd,MAAM,aAAa,eAAe;MAChC,OAAO;MACP,MAAM,EACJ,SAAS,iBAAiB,QAAQ,MAAM,UAAU,iBACnD;MACF,CAAC;AACF,gBAAW,QAAQ,QAAQ,OAAO,WAAW,CAAC;cACtC;AACR,gBAAW,OAAO;;MAGvB,CAAC;AAEF,UAAO,IAAI,SAAS,QAAQ,EAC1B,SAAS;IACP,gBAAgB;IAChB,iBAAiB;IACjB,cAAc;IACd,qBAAqB;IACtB,EACF,CAAC;WACK,OAAO;AAEd,UAAO,IAAI,SACT,KAAK,UAAU;IACb,MAAM;IACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU;IACnD,CAAC,EACF;IACE,QAAQ;IACR,SAAS,EAAE,gBAAgB,oBAAoB;IAChD,CACF;;;CAKL,MAAM,UAAU;AAChB,CAAC,QAA4C,QAAQ,EAAE,SAAS,OAAO;AACvE,CAAC,QAAiD,eAAe;AACjE,QAAO"}
+{"version":3,"file":"sse-Dws4pJi8.mjs","names":[],"sources":["../src/utils/sse.ts"],"sourcesContent":["/**\n * Server-Sent Events (SSE) 支持\n *\n * 用于实现流式响应，如 AI 聊天、实时通知等\n *\n * @example\n * ```typescript\n * import { createSSEHandler, Type } from 'vafast'\n *\n * const streamHandler = createSSEHandler(\n *   { query: Type.Object({ prompt: Type.String() }) },\n *   async function* ({ query }) {\n *     yield { event: 'start', data: { message: 'Starting...' } }\n *\n *     for await (const chunk of aiStream(query.prompt)) {\n *       yield { data: chunk }\n *     }\n *\n *     yield { event: 'end', data: { message: 'Done!' } }\n *   }\n * )\n * ```\n */\n\nimport type { RouteSchema, HandlerContext } from \"../defineRoute\";\nimport { parseQuery, parseHeaders, parseCookies } from \"./parsers\";\nimport { precompileSchemas, validateAllSchemas } from \"./validators/validators\";\n\n/**\n * SSE 事件类型\n */\nexport interface SSEEvent<T = unknown> {\n  /** 事件名称（可选，默认为 message） */\n  event?: string;\n  /** 事件数据 */\n  data: T;\n  /** 事件 ID（可选） */\n  id?: string;\n  /** 重试间隔（毫秒，可选） */\n  retry?: number;\n}\n\n/**\n * SSE 生成器函数类型\n */\nexport type SSEGenerator<T extends RouteSchema = RouteSchema> = (\n  ctx: HandlerContext<T>\n) => AsyncGenerator<SSEEvent<unknown>, void, unknown>;\n\n/**\n * 格式化 SSE 事件为字符串\n */\nfunction formatSSEEvent(event: SSEEvent): string {\n  const lines: string[] = [];\n\n  if (event.id !== undefined) {\n    lines.push(`id: ${event.id}`);\n  }\n\n  if (event.event !== undefined) {\n    lines.push(`event: ${event.event}`);\n  }\n\n  if (event.retry !== undefined) {\n    lines.push(`retry: ${event.retry}`);\n  }\n\n  // 数据可能是多行的，需要分行处理\n  const dataStr = typeof event.data === 'string'\n    ? event.data\n    : JSON.stringify(event.data);\n\n  const dataLines = dataStr.split('\\n');\n  for (const line of dataLines) {\n    lines.push(`data: ${line}`);\n  }\n\n  return lines.join('\\n') + '\\n\\n';\n}\n\n/**\n * SSE 标记类型 - 使用字面量品牌类型\n */\nexport type SSEMarker = { readonly __brand: 'SSE' }\n\n/**\n * SSE Handler 类型\n * 支持两种调用方式：\n * 1. route('GET', '/path', handler) - 传入 Request\n * 2. defineRoute({ handler }) - 传入 HandlerContext\n *\n * 泛型默认为 RouteSchema，避免复杂类型传播\n */\nexport interface SSEHandler<TSchema extends RouteSchema = RouteSchema> {\n  (reqOrCtx: Request | HandlerContext<TSchema>): Promise<Response>;\n  /** 返回类型标记 - SSE 流的数据类型 */\n  readonly __returnType?: unknown;\n  /** SSE 标记 - 使用品牌类型确保不被扩展 */\n  readonly __sse?: SSEMarker;\n}\n\n/**\n * 创建 SSE 流式响应处理器\n *\n * 支持两种使用方式：\n *\n * @example\n * ```typescript\n * const streamHandler = createSSEHandler(\n *   { params: Type.Object({ id: Type.String() }) },\n *   async function* ({ params }) {\n *     yield { data: { status: 'started' } };\n *     // ... 业务逻辑\n *     yield { data: { status: 'done' } };\n *   }\n * );\n *\n * // 方式 1: 低层 API（route 函数）\n * route('GET', '/stream/:id', streamHandler)\n *\n * // 方式 2: 高层 API（defineRoute 函数）✅ 现在也支持\n * defineRoute({\n *   method: 'GET',\n *   path: '/stream/:id',\n *   handler: streamHandler,\n * })\n * ```\n */\n/**\n * 带 schema 的 SSE handler\n * 泛型 T 用于内部类型检查，返回基础类型避免复杂推断\n */\nexport function createSSEHandler<const T extends RouteSchema>(\n  schema: T,\n  generator: SSEGenerator<T>\n): SSEHandler<RouteSchema>;\n\n/**\n * 无 schema 的 SSE handler\n */\nexport function createSSEHandler(\n  generator: SSEGenerator<RouteSchema>\n): SSEHandler<RouteSchema>;\n\nexport function createSSEHandler<const T extends RouteSchema>(\n  schemaOrGenerator: T | SSEGenerator<T>,\n  maybeGenerator?: SSEGenerator<T>\n): SSEHandler<RouteSchema> {\n  // 判断调用方式\n  const hasSchema = typeof schemaOrGenerator !== 'function';\n  const schema = hasSchema ? (schemaOrGenerator as T) : ({} as T);\n  const generator = hasSchema\n    ? maybeGenerator!\n    : (schemaOrGenerator as SSEGenerator<T>);\n\n  // 预编译 schema\n  if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {\n    precompileSchemas(schema);\n  }\n\n  /**\n   * 检测是否是 HandlerContext（来自 defineRoute）\n   * HandlerContext 有 req 属性，而 Request 没有\n   */\n  const isHandlerContext = (arg: unknown): arg is HandlerContext<T> => {\n    return arg !== null &&\n      typeof arg === 'object' &&\n      'req' in arg &&\n      'params' in arg;\n  };\n\n  const handlerFn = async (reqOrCtx: Request | HandlerContext<T>): Promise<Response> => {\n    try {\n      let req: Request;\n      let query: Record<string, string>;\n      let headers: Record<string, string>;\n      let cookies: Record<string, string>;\n      let params: Record<string, string>;\n      let body: unknown;\n\n      // 检测调用方式\n      if (isHandlerContext(reqOrCtx)) {\n        // 方式 2: defineRoute 传入的 HandlerContext\n        req = reqOrCtx.req;\n        query = reqOrCtx.query as Record<string, string>;\n        headers = reqOrCtx.headers as Record<string, string>;\n        cookies = reqOrCtx.cookies as Record<string, string>;\n        params = reqOrCtx.params as Record<string, string>;\n        body = reqOrCtx.body;\n      } else {\n        // 方式 1: route() 传入的 Request\n        req = reqOrCtx;\n        query = parseQuery(req) as Record<string, string>;\n        headers = parseHeaders(req) as Record<string, string>;\n        cookies = parseCookies(req) as Record<string, string>;\n        params = ((req as unknown as Record<string, unknown>).params as Record<string, string>) || {};\n        body = undefined;\n      }\n\n      // 验证 schema（仅在方式 1 时需要，方式 2 已由 defineRoute 验证）\n      if (!isHandlerContext(reqOrCtx)) {\n        const data = { body, query, params, headers, cookies };\n        if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {\n          validateAllSchemas(schema, data);\n        }\n      }\n\n      // 创建 SSE 流\n      const stream = new ReadableStream({\n        async start(controller) {\n          const encoder = new TextEncoder();\n\n          try {\n            const gen = generator({\n              req,\n              body: body as HandlerContext<T>['body'],\n              query: query as HandlerContext<T>['query'],\n              params: params as HandlerContext<T>['params'],\n              headers: headers as HandlerContext<T>['headers'],\n              cookies: cookies as HandlerContext<T>['cookies'],\n            });\n\n            for await (const event of gen) {\n              const formatted = formatSSEEvent(event);\n              controller.enqueue(encoder.encode(formatted));\n            }\n          } catch (error) {\n            // 发送错误事件\n            const errorEvent = formatSSEEvent({\n              event: 'error',\n              data: {\n                message: error instanceof Error ? error.message : 'Unknown error'\n              }\n            });\n            controller.enqueue(encoder.encode(errorEvent));\n          } finally {\n            controller.close();\n          }\n        }\n      });\n\n      return new Response(stream, {\n        headers: {\n          'Content-Type': 'text/event-stream',\n          'Cache-Control': 'no-cache',\n          'Connection': 'keep-alive',\n          'X-Accel-Buffering': 'no', // Nginx 禁用缓冲\n        }\n      });\n    } catch (error) {\n      // 验证错误等\n      return new Response(\n        JSON.stringify({\n          code: 400,\n          message: error instanceof Error ? error.message : 'Unknown error'\n        }),\n        {\n          status: 400,\n          headers: { 'Content-Type': 'application/json' }\n        }\n      );\n    }\n  };\n\n  // 添加类型标记\n  const handler = handlerFn as SSEHandler<T>;\n  (handler as unknown as { __sse: SSEMarker }).__sse = { __brand: 'SSE' } as const;\n  (handler as unknown as { __returnType: unknown }).__returnType = undefined;\n  return handler;\n}\n\n\n"],"mappings":";;;;;;;AAoDA,SAAS,eAAe,OAAyB;CAC/C,MAAM,QAAkB,EAAE;AAE1B,KAAI,MAAM,OAAO,OACf,OAAM,KAAK,OAAO,MAAM,KAAK;AAG/B,KAAI,MAAM,UAAU,OAClB,OAAM,KAAK,UAAU,MAAM,QAAQ;AAGrC,KAAI,MAAM,UAAU,OAClB,OAAM,KAAK,UAAU,MAAM,QAAQ;CAQrC,MAAM,aAJU,OAAO,MAAM,SAAS,WAClC,MAAM,OACN,KAAK,UAAU,MAAM,KAAK,EAEJ,MAAM,KAAK;AACrC,MAAK,MAAM,QAAQ,UACjB,OAAM,KAAK,SAAS,OAAO;AAG7B,QAAO,MAAM,KAAK,KAAK,GAAG;;AAmE5B,SAAgB,iBACd,mBACA,gBACyB;CAEzB,MAAM,YAAY,OAAO,sBAAsB;CAC/C,MAAM,SAAS,YAAa,oBAA2B,EAAE;CACzD,MAAM,YAAY,YACd,iBACC;AAGL,KAAI,OAAO,QAAQ,OAAO,SAAS,OAAO,UAAU,OAAO,WAAW,OAAO,QAC3E,mBAAkB,OAAO;;;;;CAO3B,MAAM,oBAAoB,QAA2C;AACnE,SAAO,QAAQ,QACb,OAAO,QAAQ,YACf,SAAS,OACT,YAAY;;CAGhB,MAAM,YAAY,OAAO,aAA6D;AACpF,MAAI;GACF,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;AAGJ,OAAI,iBAAiB,SAAS,EAAE;AAE9B,UAAM,SAAS;AACf,YAAQ,SAAS;AACjB,cAAU,SAAS;AACnB,cAAU,SAAS;AACnB,aAAS,SAAS;AAClB,WAAO,SAAS;UACX;AAEL,UAAM;AACN,YAAQ,WAAW,IAAI;AACvB,cAAU,aAAa,IAAI;AAC3B,cAAU,aAAa,IAAI;AAC3B,aAAW,IAA2C,UAAqC,EAAE;AAC7F,WAAO;;AAIT,OAAI,CAAC,iBAAiB,SAAS,EAAE;IAC/B,MAAM,OAAO;KAAE;KAAM;KAAO;KAAQ;KAAS;KAAS;AACtD,QAAI,OAAO,QAAQ,OAAO,SAAS,OAAO,UAAU,OAAO,WAAW,OAAO,QAC3E,oBAAmB,QAAQ,KAAK;;GAKpC,MAAM,SAAS,IAAI,eAAe,EAChC,MAAM,MAAM,YAAY;IACtB,MAAM,UAAU,IAAI,aAAa;AAEjC,QAAI;KACF,MAAM,MAAM,UAAU;MACpB;MACM;MACC;MACC;MACC;MACA;MACV,CAAC;AAEF,gBAAW,MAAM,SAAS,KAAK;MAC7B,MAAM,YAAY,eAAe,MAAM;AACvC,iBAAW,QAAQ,QAAQ,OAAO,UAAU,CAAC;;aAExC,OAAO;KAEd,MAAM,aAAa,eAAe;MAChC,OAAO;MACP,MAAM,EACJ,SAAS,iBAAiB,QAAQ,MAAM,UAAU,iBACnD;MACF,CAAC;AACF,gBAAW,QAAQ,QAAQ,OAAO,WAAW,CAAC;cACtC;AACR,gBAAW,OAAO;;MAGvB,CAAC;AAEF,UAAO,IAAI,SAAS,QAAQ,EAC1B,SAAS;IACP,gBAAgB;IAChB,iBAAiB;IACjB,cAAc;IACd,qBAAqB;IACtB,EACF,CAAC;WACK,OAAO;AAEd,UAAO,IAAI,SACT,KAAK,UAAU;IACb,MAAM;IACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU;IACnD,CAAC,EACF;IACE,QAAQ;IACR,SAAS,EAAE,gBAAgB,oBAAoB;IAChD,CACF;;;CAKL,MAAM,UAAU;AAChB,CAAC,QAA4C,QAAQ,EAAE,SAAS,OAAO;AACvE,CAAC,QAAiD,eAAe;AACjE,QAAO"}

package/dist/utils/index.d.mts

@@ -1,4 +1,4 @@
-import "../defineRoute-D61MtjQB.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
 import { t as DependencyManager } from "../dependency-manager-DIN9X0Gj.mjs";
 import { a as parseBody, c as parseCookiesFast, d as parseHeaders, f as parseQuery, i as getHeader, p as parseQueryFast, r as getCookie, s as parseCookies } from "../parsers-8hIAx0OV.mjs";
 import { c as text, i as json, n as err, o as redirect, r as html, s as stream, t as empty } from "../response-CJcO5s7Q.mjs";
@@ -7,7 +7,7 @@ import { n as base64urlEncode, t as base64urlDecode } from "../base64url-DNUGwek
 import { t as HtmlRenderer } from "../html-renderer-DhQxRuyi.mjs";
 import { a as ValidationError, c as getValidatorCacheStats, d as validateFast, f as validateSchema, l as precompileSchemas, o as ValidationResult, p as validateSchemaOrThrow, s as createValidator, t as SchemaConfig, u as validateAllSchemas } from "../validators-BFC6S_fr.mjs";
 import { i as registerFormats, n as hasFormat, r as registerFormat, t as Patterns } from "../formats-DDDSFWP0.mjs";
-import { a as createSSEHandler, i as SSEMarker, r as SSEHandler, t as SSEEvent } from "../sse-BVNHu5J4.mjs";
-import { a as getAllRoutes, c as getRoutesByMethod, i as filterRoutes, n as RouteRegistry, o as getRoute, r as createRouteRegistry, s as getRouteRegistry, t as RouteMeta } from "../route-registry-Dh8CSDDh.mjs";
+import { a as createSSEHandler, i as SSEMarker, r as SSEHandler, t as SSEEvent } from "../sse-CjIH9WjQ.mjs";
+import { a as getAllRoutes, c as getRoutesByMethod, i as filterRoutes, n as RouteRegistry, o as getRoute, r as createRouteRegistry, s as getRouteRegistry, t as RouteMeta } from "../route-registry-QBYYbUGm.mjs";
 import { n as generateAITools, r as getApiSpec, t as ApiSpec } from "../contract-C9wzCRMW.mjs";
 export { type ApiSpec, DependencyManager, HtmlRenderer, Patterns, type RouteMeta, RouteRegistry, type SSEEvent, type SSEHandler, type SSEMarker, type SchemaConfig, type ValidationError, type ValidationResult, base64urlDecode, base64urlEncode, createRouteRegistry, createSSEHandler, createValidator, empty, err, filterRoutes, generateAITools, getAllRoutes, getApiSpec, getCookie, getHeader, getRoute, getRouteRegistry, getRoutesByMethod, getValidatorCacheStats, goAwait, hasFormat, html, json, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, precompileSchemas, redirect, registerFormat, registerFormats, stream, text, validateAllSchemas, validateFast, validateSchema, validateSchemaOrThrow };

package/dist/utils/route-registry.d.mts

@@ -1,3 +1,3 @@
-import "../defineRoute-D61MtjQB.mjs";
-import { a as getAllRoutes, c as getRoutesByMethod, i as filterRoutes, l as setGlobalRegistry, n as RouteRegistry, o as getRoute, r as createRouteRegistry, s as getRouteRegistry, t as RouteMeta } from "../route-registry-Dh8CSDDh.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
+import { a as getAllRoutes, c as getRoutesByMethod, i as filterRoutes, l as setGlobalRegistry, n as RouteRegistry, o as getRoute, r as createRouteRegistry, s as getRouteRegistry, t as RouteMeta } from "../route-registry-QBYYbUGm.mjs";
 export { RouteMeta, RouteRegistry, createRouteRegistry, filterRoutes, getAllRoutes, getRoute, getRouteRegistry, getRoutesByMethod, setGlobalRegistry };

package/dist/utils/sse.d.mts

@@ -1,3 +1,3 @@
-import "../defineRoute-D61MtjQB.mjs";
-import { a as createSSEHandler, i as SSEMarker, n as SSEGenerator, r as SSEHandler, t as SSEEvent } from "../sse-BVNHu5J4.mjs";
+import "../defineRoute-DyPa9FHa.mjs";
+import { a as createSSEHandler, i as SSEMarker, n as SSEGenerator, r as SSEHandler, t as SSEEvent } from "../sse-CjIH9WjQ.mjs";
 export { SSEEvent, SSEGenerator, SSEHandler, SSEMarker, createSSEHandler };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vafast",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "极简结构化Web框架，支持 Bun 和 Node.js。Go风格，函数优先。",
   "type": "module",
   "repository": {