vafast 0.5.1 → 0.5.3

package/README.md

@@ -447,6 +447,36 @@ const routes = defineRoutes([
 ]);
 ```
 
+### 父级中间件类型注入 (withContext)
+
+当中间件在父级定义，子路由需要使用 `withContext` 获得类型推断：
+
+```typescript
+import { defineRoute, defineRoutes, withContext } from 'vafast'
+
+// 创建带 UserInfo 上下文的路由定义器
+const defineAuthRoute = withContext<{ userInfo: UserInfo }>()
+
+const routes = defineRoutes([
+  defineRoute({
+    path: '/api',
+    middleware: [authMiddleware],  // 父级中间件注入 userInfo
+    children: [
+      defineAuthRoute({  // ← 使用 defineAuthRoute
+        method: 'GET',
+        path: '/profile',
+        handler: ({ userInfo }) => {
+          // ✅ userInfo 自动有类型！
+          return { id: userInfo.id }
+        }
+      })
+    ]
+  })
+])
+```
+
+> 📖 详细文档：[withContext 使用指南](./docs/with-context.md)
+
 ### JIT 编译验证器
 
 Vafast 内置验证器 JIT 编译，自动缓存编译后的验证器：
@@ -762,7 +792,9 @@ export default { port: 3000, fetch: server.fetch };
 - [快速开始](./docs/getting-started/quickstart.md)
 - [示例代码](./examples/)
 
-### 架构设计
+
+### 核心概念
+- [withContext 使用指南](./docs/with-context.md) - 父级中间件类型注入，解决跨路由类型推断
 - [路由设计与网关架构](./docs/router-design.md) - 声明式路由的设计哲学、AI 时代能力、网关优势
 - [本地工具模式](./docs/local-tools-mode.md) - 声明式路由作为 AI Tools，无需 HTTP 服务
 

package/dist/{defineRoute-BjLBWeSj.d.mts → defineRoute-zjOfHyZA.d.mts}

@@ -104,15 +104,36 @@ interface ProcessedRoute {
  */
 declare function defineMiddleware<TContext extends object = object>(handler: (req: Request, next: (ctx?: TContext) => Promise<Response>) => Promise<Response>): TypedMiddleware<TContext>;
 /**
- * 定义叶子路由（有 method 和 handler），支持中间件类型推断
+ * 定义叶子路由（有 method 和 handler），支持中间件类型推断和显式上下文类型
+ *
+ * @example
+ * ```typescript
+ * // 方式1：通过中间件自动推断上下文
+ * defineRoute({
+ *   method: 'GET',
+ *   path: '/profile',
+ *   middleware: [authMiddleware],
+ *   handler: ({ user }) => { ... }  // user 来自 authMiddleware
+ * })
+ *
+ * // 方式2：显式声明上下文类型（用于父级中间件注入的场景）
+ * defineRoute({
+ *   method: 'GET',
+ *   path: '/profile',
+ *   context: {} as { userInfo: UserInfo },
+ *   handler: ({ userInfo }) => { ... }  // userInfo 有类型
+ * })
+ * ```
  */
-declare function defineRoute<const TSchema$1 extends RouteSchema, TReturn, const TMiddleware extends readonly AnyMiddleware[], TMethod extends HTTPMethod = HTTPMethod, TPath extends string = string>(config: {
+declare function defineRoute<const TSchema$1 extends RouteSchema, TReturn, const TMiddleware extends readonly AnyMiddleware[], TContext extends object = object, TMethod extends HTTPMethod = HTTPMethod, TPath extends string = string>(config: {
   readonly method: TMethod;
   readonly path: TPath;
   readonly name?: string;
   readonly description?: string;
   readonly schema?: TSchema$1;
-  readonly handler: (ctx: HandlerContextWithExtra<TSchema$1, MergeMiddlewareContexts<TMiddleware>>) => TReturn | Promise<TReturn>;
+  /** 显式声明上下文类型（用于父级中间件注入的场景） */
+  readonly context?: TContext;
+  readonly handler: (ctx: HandlerContextWithExtra<TSchema$1, TContext & MergeMiddlewareContexts<TMiddleware>>) => TReturn | Promise<TReturn>;
   readonly middleware?: TMiddleware;
   readonly docs?: {
     tags?: string[];
@@ -130,6 +151,41 @@ declare function defineRoute<const TMiddleware extends readonly AnyMiddleware[],
   readonly middleware?: TMiddleware;
   readonly children: ReadonlyArray<RouteConfigResult>;
 }): NestedRouteConfig<TPath, TMiddleware>;
+/**
+ * 创建带预设上下文类型的路由定义器
+ *
+ * 用于父级中间件注入上下文的场景，定义一次，多处复用
+ *
+ * @example
+ * ```typescript
+ * // 1. 在 middleware/index.ts 中定义
+ * export const defineAuthRoute = withContext<{ userInfo: UserInfo }>()
+ *
+ * // 2. 在路由文件中使用
+ * defineAuthRoute({
+ *   method: 'GET',
+ *   path: '/profile',
+ *   handler: ({ userInfo }) => {
+ *     // userInfo 自动有类型！
+ *     return { id: userInfo.id }
+ *   }
+ * })
+ * ```
+ */
+declare function withContext<TContext extends object>(): <const TSchema$1 extends RouteSchema, TReturn, const TMiddleware extends readonly AnyMiddleware[], TMethod extends HTTPMethod = HTTPMethod, TPath extends string = string>(config: {
+  readonly method: TMethod;
+  readonly path: TPath;
+  readonly name?: string;
+  readonly description?: string;
+  readonly schema?: TSchema$1;
+  readonly handler: (ctx: HandlerContextWithExtra<TSchema$1, TContext & MergeMiddlewareContexts<TMiddleware>>) => TReturn | Promise<TReturn>;
+  readonly middleware?: TMiddleware;
+  readonly docs?: {
+    tags?: string[];
+    security?: unknown[];
+    responses?: Record<string, unknown>;
+  };
+}) => LeafRouteConfig<TMethod, TPath, TSchema$1, TReturn, TMiddleware>;
 /**
  * 定义路由数组，支持嵌套路由
  */
@@ -148,5 +204,5 @@ type InferableRoute<TMethod extends string = string, TPath extends string = stri
   readonly middleware?: ReadonlyArray<AnyMiddleware>;
 };
 //#endregion
-export { TypedMiddleware as a, defineRoutes as c, RouteSchema as i, InferableRoute as n, defineMiddleware as o, ProcessedRoute as r, defineRoute as s, HandlerContext as t };
-//# sourceMappingURL=defineRoute-BjLBWeSj.d.mts.map
+export { TypedMiddleware as a, defineRoutes as c, RouteSchema as i, withContext as l, InferableRoute as n, defineMiddleware as o, ProcessedRoute as r, defineRoute as s, HandlerContext as t };
+//# sourceMappingURL=defineRoute-zjOfHyZA.d.mts.map

package/dist/defineRoute.d.mts

@@ -1,2 +1,2 @@
-import { a as TypedMiddleware, c as defineRoutes, i as RouteSchema, n as InferableRoute, o as defineMiddleware, r as ProcessedRoute, s as defineRoute, t as HandlerContext } from "./defineRoute-BjLBWeSj.mjs";
-export { HandlerContext, InferableRoute, ProcessedRoute, RouteSchema, TypedMiddleware, defineMiddleware, defineRoute, defineRoutes };
+import { a as TypedMiddleware, c as defineRoutes, i as RouteSchema, l as withContext, n as InferableRoute, o as defineMiddleware, r as ProcessedRoute, s as defineRoute, t as HandlerContext } from "./defineRoute-zjOfHyZA.mjs";
+export { HandlerContext, InferableRoute, ProcessedRoute, RouteSchema, TypedMiddleware, defineMiddleware, defineRoute, defineRoutes, withContext };

package/dist/defineRoute.mjs

@@ -115,6 +115,32 @@ function defineRoute(config) {
 	return config;
 }
 /**
+* 创建带预设上下文类型的路由定义器
+*
+* 用于父级中间件注入上下文的场景，定义一次，多处复用
+*
+* @example
+* ```typescript
+* // 1. 在 middleware/index.ts 中定义
+* export const defineAuthRoute = withContext<{ userInfo: UserInfo }>()
+*
+* // 2. 在路由文件中使用
+* defineAuthRoute({
+*   method: 'GET',
+*   path: '/profile',
+*   handler: ({ userInfo }) => {
+*     // userInfo 自动有类型！
+*     return { id: userInfo.id }
+*   }
+* })
+* ```
+*/
+function withContext() {
+	return (config) => {
+		return config;
+	};
+}
+/**
 * 递归扁平化路由，合并路径和中间件
 */
 function flattenRoutes(routes, parentPath = "", parentMiddleware = []) {
@@ -144,5 +170,5 @@ function defineRoutes(routes) {
 }
 
 //#endregion
-export { defineMiddleware, defineRoute, defineRoutes };
+export { defineMiddleware, defineRoute, defineRoutes, withContext };
 //# sourceMappingURL=defineRoute.mjs.map

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}\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） */\ninterface 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） */\ninterface 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({ success: false, error: \"Validation Error\", message: error.message }, 400);\n      }\n      return json({ success: false, error: \"Internal Error\", 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 */\nexport function defineRoute<\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, 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 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// ============= 扁平化嵌套路由 =============\n\n/**\n * 递归扁平化路由，合并路径和中间件\n */\nfunction flattenRoutes(\n  routes: ReadonlyArray<RouteConfigResult>,\n  parentPath: string = \"\",\n  parentMiddleware: readonly AnyMiddleware[] = []\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      result.push({\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    } else if (isNestedRoute(route)) {\n      result.push(...flattenRoutes(route.children, fullPath, mergedMiddleware));\n    }\n  }\n\n  return result;\n}\n\n// ============= defineRoutes 函数 =============\n\n/**\n * 定义路由数组，支持嵌套路由\n */\nexport function defineRoutes(routes: ReadonlyArray<RouteConfigResult>): ProcessedRoute[] {\n  return flattenRoutes(routes);\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}\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） */\ninterface 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） */\ninterface 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({ success: false, error: \"Validation Error\", message: error.message }, 400);\n      }\n      return json({ success: false, error: \"Internal Error\", 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 */\nexport function withContext<TContext extends object>() {\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  }): LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware> => {\n    return config as LeafRouteConfig<TMethod, TPath, TSchema, TReturn, TMiddleware>;\n  };\n}\n\n// ============= 扁平化嵌套路由 =============\n\n/**\n * 递归扁平化路由，合并路径和中间件\n */\nfunction flattenRoutes(\n  routes: ReadonlyArray<RouteConfigResult>,\n  parentPath: string = \"\",\n  parentMiddleware: readonly AnyMiddleware[] = []\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      result.push({\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    } else if (isNestedRoute(route)) {\n      result.push(...flattenRoutes(route.children, fullPath, mergedMiddleware));\n    }\n  }\n\n  return result;\n}\n\n// ============= defineRoutes 函数 =============\n\n/**\n * 定义路由数组，支持嵌套路由\n */\nexport function defineRoutes(routes: ReadonlyArray<RouteConfigResult>): ProcessedRoute[] {\n  return flattenRoutes(routes);\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-DCloGU_g.d.mts → index-B8iPRxj1.d.mts}

@@ -1,6 +1,6 @@
-import { r as ProcessedRoute } from "./defineRoute-BjLBWeSj.mjs";
+import { r as ProcessedRoute } from "./defineRoute-zjOfHyZA.mjs";
 import { r as NestedComponentRoute, t as ComponentRoute } from "./component-route-Di7R40-2.mjs";
-import { t as Server } from "./server-CW1cdqGD.mjs";
+import { t as Server } from "./server-CpKaM0Kq.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-DCloGU_g.d.mts.map
+//# sourceMappingURL=index-B8iPRxj1.d.mts.map

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { a as TypedMiddleware, c as defineRoutes, i as RouteSchema, n as InferableRoute, o as defineMiddleware, r as ProcessedRoute, s as defineRoute, t as HandlerContext } from "./defineRoute-BjLBWeSj.mjs";
+import { a as TypedMiddleware, c as defineRoutes, i as RouteSchema, l as withContext, n as InferableRoute, o as defineMiddleware, r as ProcessedRoute, s as defineRoute, t as HandlerContext } from "./defineRoute-zjOfHyZA.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-CW1cdqGD.mjs";
+import { t as Server } from "./server-CpKaM0Kq.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-DCloGU_g.mjs";
+import { t as ServerFactory } from "./index-B8iPRxj1.mjs";
 import { n as composeMiddleware, t as VafastError } from "./middleware-BR-R4p0M.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-BNLzz4Tq.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-5HykEmSm.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-CDBB0GI1.mjs";
+import { a as createSSEHandler, i as SSEMarker, r as SSEHandler, t as SSEEvent } from "./sse-CsjEeJNP.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-BQKQ0qZp.mjs";
 import { n as getApiSpec, t as generateAITools } from "./contract-BL3JflJ7.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 { BaseServer, ComponentRoute, ComponentServer, DependencyManager, type FetchHandler, FlattenedComponentRoute, FormatRegistry, Handler, HandlerContext, HtmlRenderer, InferableRoute, Method, Middleware, NestedComponentRoute, Patterns, ProcessedRoute, ResponseBody, RouteMeta, RouteRegistry, RouteSchema, 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 };
+export { BaseServer, ComponentRoute, ComponentServer, DependencyManager, type FetchHandler, FlattenedComponentRoute, FormatRegistry, Handler, HandlerContext, HtmlRenderer, InferableRoute, Method, Middleware, NestedComponentRoute, Patterns, ProcessedRoute, ResponseBody, RouteMeta, RouteRegistry, RouteSchema, 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/index.mjs

@@ -1,7 +1,7 @@
 import { a as parseCookies, d as parseQueryFast, l as parseHeaders, n as getHeader, o as parseCookiesFast, r as parseBody, t as getCookie, u as parseQuery } from "./parsers-BrG_mRLq.mjs";
 import { a as validateAllSchemas, c as validateSchemaOrThrow, i as precompileSchemas, n as createValidator, o as validateFast, r as getValidatorCacheStats, s as validateSchema } from "./validators-CkfvNBbK.mjs";
 import { c as text, i as json, l as VafastError, n as err, o as redirect, r as html, s as stream, t as empty, u as composeMiddleware } from "./response-CQ1IgWei.mjs";
-import { defineMiddleware, defineRoute, defineRoutes } from "./defineRoute.mjs";
+import { defineMiddleware, defineRoute, defineRoutes, withContext } from "./defineRoute.mjs";
 import { t as BaseServer } from "./base-server-CE0mfqPY.mjs";
 import { a as getRoute, i as getAllRoutes, n as createRouteRegistry, o as getRouteRegistry, r as filterRoutes, s as getRoutesByMethod, t as RouteRegistry } from "./route-registry-BzExlM2t.mjs";
 import { t as Server } from "./server-Bm0BGm01.mjs";
@@ -26,5 +26,5 @@ import { FormatRegistry, Type } from "@sinclair/typebox";
 registerFormats();
 
 //#endregion
-export { BaseServer, ComponentServer, DependencyManager, FormatRegistry, HtmlRenderer, Patterns, RouteRegistry, Server, ServerFactory, Type, VafastError, 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 };
+export { BaseServer, ComponentServer, DependencyManager, FormatRegistry, HtmlRenderer, Patterns, RouteRegistry, Server, ServerFactory, Type, VafastError, 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 };
 //# sourceMappingURL=index.mjs.map

package/dist/monitoring/index.d.mts

@@ -1,5 +1,5 @@
-import "../defineRoute-BjLBWeSj.mjs";
-import "../server-CW1cdqGD.mjs";
-import "../index-DCloGU_g.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import "../server-CpKaM0Kq.mjs";
+import "../index-B8iPRxj1.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-BjLBWeSj.mjs";
-import { t as Server } from "../server-CW1cdqGD.mjs";
-import "../index-DCloGU_g.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import { t as Server } from "../server-CpKaM0Kq.mjs";
+import "../index-B8iPRxj1.mjs";
 
 //#region src/monitoring/native-monitor.d.ts
 

package/dist/{route-registry-CDBB0GI1.d.mts → route-registry-BQKQ0qZp.d.mts}

@@ -1,4 +1,4 @@
-import { i as RouteSchema, r as ProcessedRoute } from "./defineRoute-BjLBWeSj.mjs";
+import { i as RouteSchema, r as ProcessedRoute } from "./defineRoute-zjOfHyZA.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-CDBB0GI1.d.mts.map
+//# sourceMappingURL=route-registry-BQKQ0qZp.d.mts.map

package/dist/server/index.d.mts

@@ -1,6 +1,6 @@
-import "../defineRoute-BjLBWeSj.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
 import { t as BaseServer } from "../base-server-Contwrlf.mjs";
-import { t as Server } from "../server-CW1cdqGD.mjs";
+import { t as Server } from "../server-CpKaM0Kq.mjs";
 import { t as ComponentServer } from "../component-server-fR4UV6Jq.mjs";
-import { t as ServerFactory } from "../index-DCloGU_g.mjs";
+import { t as ServerFactory } from "../index-B8iPRxj1.mjs";
 export { BaseServer, ComponentServer, Server, ServerFactory };

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

@@ -1,4 +1,4 @@
-import "../defineRoute-BjLBWeSj.mjs";
-import "../server-CW1cdqGD.mjs";
-import { t as ServerFactory } from "../index-DCloGU_g.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import "../server-CpKaM0Kq.mjs";
+import { t as ServerFactory } from "../index-B8iPRxj1.mjs";
 export { ServerFactory };

package/dist/server/server.d.mts

@@ -1,3 +1,3 @@
-import "../defineRoute-BjLBWeSj.mjs";
-import { t as Server } from "../server-CW1cdqGD.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import { t as Server } from "../server-CpKaM0Kq.mjs";
 export { Server };

package/dist/{server-CW1cdqGD.d.mts → server-CpKaM0Kq.d.mts}

@@ -1,4 +1,4 @@
-import { r as ProcessedRoute } from "./defineRoute-BjLBWeSj.mjs";
+import { r as ProcessedRoute } from "./defineRoute-zjOfHyZA.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-CW1cdqGD.d.mts.map
+//# sourceMappingURL=server-CpKaM0Kq.d.mts.map

package/dist/{sse-5HykEmSm.d.mts → sse-CsjEeJNP.d.mts}

@@ -1,4 +1,4 @@
-import { i as RouteSchema, t as HandlerContext } from "./defineRoute-BjLBWeSj.mjs";
+import { i as RouteSchema, t as HandlerContext } from "./defineRoute-zjOfHyZA.mjs";
 
 //#region src/utils/sse.d.ts
 
@@ -60,4 +60,4 @@ declare function createSSEHandler<const T extends RouteSchema>(schema: T, genera
 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-5HykEmSm.d.mts.map
+//# sourceMappingURL=sse-CsjEeJNP.d.mts.map

package/dist/utils/index.d.mts

@@ -1,4 +1,4 @@
-import "../defineRoute-BjLBWeSj.mjs";
+import "../defineRoute-zjOfHyZA.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-BNLzz4Tq.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-5HykEmSm.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-CDBB0GI1.mjs";
+import { a as createSSEHandler, i as SSEMarker, r as SSEHandler, t as SSEEvent } from "../sse-CsjEeJNP.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-BQKQ0qZp.mjs";
 import { n as getApiSpec, t as generateAITools } from "../contract-BL3JflJ7.mjs";
 export { 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-BjLBWeSj.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-CDBB0GI1.mjs";
+import "../defineRoute-zjOfHyZA.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-BQKQ0qZp.mjs";
 export { RouteMeta, RouteRegistry, createRouteRegistry, filterRoutes, getAllRoutes, getRoute, getRouteRegistry, getRoutesByMethod, setGlobalRegistry };

package/dist/utils/sse.d.mts

@@ -1,3 +1,3 @@
-import "../defineRoute-BjLBWeSj.mjs";
-import { a as createSSEHandler, i as SSEMarker, n as SSEGenerator, r as SSEHandler, t as SSEEvent } from "../sse-5HykEmSm.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import { a as createSSEHandler, i as SSEMarker, n as SSEGenerator, r as SSEHandler, t as SSEEvent } from "../sse-CsjEeJNP.mjs";
 export { SSEEvent, SSEGenerator, SSEHandler, SSEMarker, createSSEHandler };

package/package.json

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