vafast 0.4.24 → 0.5.2

package/dist/router-CgYfGB4J.mjs

@@ -1,98 +0,0 @@
-//#region src/router.ts
-/**
-* 扁平化嵌套路由
-*
-* 将嵌套路由结构转换为扁平数组，计算完整路径和中间件链
-*
-* @example
-* ```typescript
-* const routes = flattenNestedRoutes([
-*   {
-*     path: "/api",
-*     middleware: [authMiddleware],
-*     children: [
-*       { path: "/users", method: "GET", handler: getUsers },
-*       { path: "/users/:id", method: "GET", handler: getUser },
-*     ],
-*   },
-* ]);
-* // 结果:
-* // [
-* //   { fullPath: "/api/users", method: "GET", ... },
-* //   { fullPath: "/api/users/:id", method: "GET", ... },
-* // ]
-* ```
-*/
-/** 标准路由属性（不继承） */
-const STANDARD_ROUTE_PROPS = new Set([
-	"path",
-	"method",
-	"handler",
-	"middleware",
-	"children",
-	"name",
-	"description"
-]);
-/**
-* 提取路由的自定义属性（用于继承）
-* 排除标准属性，保留 log, webhook, auth 等自定义配置
-*/
-function extractCustomProps(route) {
-	const custom = {};
-	for (const key of Object.keys(route)) if (!STANDARD_ROUTE_PROPS.has(key)) custom[key] = route[key];
-	return custom;
-}
-/**
-* 合并自定义属性（子路由覆盖父路由）
-*/
-function mergeCustomProps(parentProps, childProps) {
-	return {
-		...parentProps,
-		...childProps
-	};
-}
-function flattenNestedRoutes(routes) {
-	const flattened = [];
-	function processRoute(route, parentPath = "", parentMiddleware = [], parentName, parentCustomProps = {}) {
-		const currentPath = normalizePath(parentPath + route.path);
-		const currentMiddleware = [...parentMiddleware, ...route.middleware || []];
-		const currentName = route.name || parentName;
-		const currentCustomProps = mergeCustomProps(parentCustomProps, extractCustomProps(route));
-		if ("method" in route && "handler" in route) {
-			const leafRoute = route;
-			flattened.push({
-				...currentCustomProps,
-				...leafRoute,
-				fullPath: currentPath,
-				middlewareChain: currentMiddleware,
-				parentName
-			});
-		} else if ("children" in route && route.children) for (const child of route.children) processRoute(child, currentPath, currentMiddleware, currentName, currentCustomProps);
-	}
-	for (const route of routes) processRoute(route);
-	return flattened;
-}
-/**
-* 标准化路径
-*
-* - 解码 URL 编码字符
-* - 去除重复斜杠
-* - 处理结尾斜杠
-*
-* @example
-* ```typescript
-* normalizePath("//api//users/")  // "/api/users"
-* normalizePath("/api/%20test")   // "/api/ test"
-* ```
-*/
-function normalizePath(path) {
-	let normalized = decodeURIComponent(path);
-	normalized = normalized.replace(/\/+/g, "/");
-	if (normalized === "") return "/";
-	if (normalized !== "/" && normalized.endsWith("/")) normalized = normalized.slice(0, -1);
-	return normalized;
-}
-
-//#endregion
-export { normalizePath as n, flattenNestedRoutes as t };
-//# sourceMappingURL=router-CgYfGB4J.mjs.map

package/dist/router-CgYfGB4J.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"router-CgYfGB4J.mjs","names":[],"sources":["../src/router.ts"],"sourcesContent":["/**\n * 路由工具函数\n *\n * 提供路由处理的基础工具\n */\n\nimport type { Route, NestedRoute, FlattenedRoute, Middleware } from \"./types\";\n\n/**\n * 扁平化嵌套路由\n *\n * 将嵌套路由结构转换为扁平数组，计算完整路径和中间件链\n *\n * @example\n * ```typescript\n * const routes = flattenNestedRoutes([\n *   {\n *     path: \"/api\",\n *     middleware: [authMiddleware],\n *     children: [\n *       { path: \"/users\", method: \"GET\", handler: getUsers },\n *       { path: \"/users/:id\", method: \"GET\", handler: getUser },\n *     ],\n *   },\n * ]);\n * // 结果:\n * // [\n * //   { fullPath: \"/api/users\", method: \"GET\", ... },\n * //   { fullPath: \"/api/users/:id\", method: \"GET\", ... },\n * // ]\n * ```\n */\n/** 标准路由属性（不继承） */\nconst STANDARD_ROUTE_PROPS = new Set([\n  'path', 'method', 'handler', 'middleware', 'children', 'name', 'description',\n]);\n\n/**\n * 提取路由的自定义属性（用于继承）\n * 排除标准属性，保留 log, webhook, auth 等自定义配置\n */\nfunction extractCustomProps(route: Route | NestedRoute): Record<string, unknown> {\n  const custom: Record<string, unknown> = {};\n  for (const key of Object.keys(route)) {\n    if (!STANDARD_ROUTE_PROPS.has(key)) {\n      custom[key] = (route as Record<string, unknown>)[key];\n    }\n  }\n  return custom;\n}\n\n/**\n * 合并自定义属性（子路由覆盖父路由）\n */\nfunction mergeCustomProps(\n  parentProps: Record<string, unknown>,\n  childProps: Record<string, unknown>,\n): Record<string, unknown> {\n  return { ...parentProps, ...childProps };\n}\n\nexport function flattenNestedRoutes(\n  routes: (Route | NestedRoute)[],\n): FlattenedRoute[] {\n  const flattened: FlattenedRoute[] = [];\n\n  function processRoute(\n    route: Route | NestedRoute,\n    parentPath = \"\",\n    parentMiddleware: Middleware[] = [],\n    parentName?: string,\n    parentCustomProps: Record<string, unknown> = {},\n  ): void {\n    // 计算当前完整路径\n    const currentPath = normalizePath(parentPath + route.path);\n    // 合并中间件链\n    const currentMiddleware = [\n      ...parentMiddleware,\n      ...(route.middleware || []),\n    ];\n    // 当前路由的 name（用于传递给子路由）\n    const currentName = route.name || parentName;\n    // 合并自定义属性（子路由可覆盖父路由设置）\n    const currentCustomProps = mergeCustomProps(parentCustomProps, extractCustomProps(route));\n\n    if (\"method\" in route && \"handler\" in route) {\n      // 叶子路由（有处理函数）\n      const leafRoute = route as Route;\n      flattened.push({\n        ...currentCustomProps, // 继承的自定义属性放在前面\n        ...leafRoute,          // 叶子路由自身属性覆盖\n        fullPath: currentPath,\n        middlewareChain: currentMiddleware,\n        parentName: parentName,\n      });\n    } else if (\"children\" in route && route.children) {\n      // 分组路由，递归处理子路由\n      for (const child of route.children) {\n        processRoute(child, currentPath, currentMiddleware, currentName, currentCustomProps);\n      }\n    }\n  }\n\n  for (const route of routes) {\n    processRoute(route);\n  }\n\n  return flattened;\n}\n\n/**\n * 标准化路径\n *\n * - 解码 URL 编码字符\n * - 去除重复斜杠\n * - 处理结尾斜杠\n *\n * @example\n * ```typescript\n * normalizePath(\"//api//users/\")  // \"/api/users\"\n * normalizePath(\"/api/%20test\")   // \"/api/ test\"\n * ```\n */\nexport function normalizePath(path: string): string {\n  // 解码 URL 编码\n  let normalized = decodeURIComponent(path);\n\n  // 去除重复斜杠\n  normalized = normalized.replace(/\\/+/g, \"/\");\n\n  // 空路径转为根路径\n  if (normalized === \"\") return \"/\";\n\n  // 去除结尾斜杠（根路径除外）\n  if (normalized !== \"/\" && normalized.endsWith(\"/\")) {\n    normalized = normalized.slice(0, -1);\n  }\n\n  return normalized;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,uBAAuB,IAAI,IAAI;CACnC;CAAQ;CAAU;CAAW;CAAc;CAAY;CAAQ;CAChE,CAAC;;;;;AAMF,SAAS,mBAAmB,OAAqD;CAC/E,MAAM,SAAkC,EAAE;AAC1C,MAAK,MAAM,OAAO,OAAO,KAAK,MAAM,CAClC,KAAI,CAAC,qBAAqB,IAAI,IAAI,CAChC,QAAO,OAAQ,MAAkC;AAGrD,QAAO;;;;;AAMT,SAAS,iBACP,aACA,YACyB;AACzB,QAAO;EAAE,GAAG;EAAa,GAAG;EAAY;;AAG1C,SAAgB,oBACd,QACkB;CAClB,MAAM,YAA8B,EAAE;CAEtC,SAAS,aACP,OACA,aAAa,IACb,mBAAiC,EAAE,EACnC,YACA,oBAA6C,EAAE,EACzC;EAEN,MAAM,cAAc,cAAc,aAAa,MAAM,KAAK;EAE1D,MAAM,oBAAoB,CACxB,GAAG,kBACH,GAAI,MAAM,cAAc,EAAE,CAC3B;EAED,MAAM,cAAc,MAAM,QAAQ;EAElC,MAAM,qBAAqB,iBAAiB,mBAAmB,mBAAmB,MAAM,CAAC;AAEzF,MAAI,YAAY,SAAS,aAAa,OAAO;GAE3C,MAAM,YAAY;AAClB,aAAU,KAAK;IACb,GAAG;IACH,GAAG;IACH,UAAU;IACV,iBAAiB;IACL;IACb,CAAC;aACO,cAAc,SAAS,MAAM,SAEtC,MAAK,MAAM,SAAS,MAAM,SACxB,cAAa,OAAO,aAAa,mBAAmB,aAAa,mBAAmB;;AAK1F,MAAK,MAAM,SAAS,OAClB,cAAa,MAAM;AAGrB,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,cAAc,MAAsB;CAElD,IAAI,aAAa,mBAAmB,KAAK;AAGzC,cAAa,WAAW,QAAQ,QAAQ,IAAI;AAG5C,KAAI,eAAe,GAAI,QAAO;AAG9B,KAAI,eAAe,OAAO,WAAW,SAAS,IAAI,CAChD,cAAa,WAAW,MAAM,GAAG,GAAG;AAGtC,QAAO"}

package/dist/schema-1fwiv7cm.mjs

@@ -1 +0,0 @@
-export {  };

package/dist/schema-B6DFN5c2.d.mts

@@ -1,81 +0,0 @@
-import { Static, TSchema } from "@sinclair/typebox";
-
-//#region src/types/schema.d.ts
-/**
-* Schema 类型定义
-*
-* 使用 TSchema 约束替代 any，提供完整的类型安全
-*
-* @author Framework Team
-* @version 1.0.0
-* @license MIT
-*/
-
-/**
- * 路由 Schema 配置
- * 所有 schema 字段使用 TSchema 约束
- */
-interface RouteSchema {
-  body?: TSchema;
-  query?: TSchema;
-  params?: TSchema;
-  headers?: TSchema;
-  cookies?: TSchema;
-}
-/**
- * 从 Schema 配置推导出具体类型
- */
-type InferSchema<T extends RouteSchema> = {
-  body: T["body"] extends TSchema ? Static<T["body"]> : unknown;
-  query: T["query"] extends TSchema ? Static<T["query"]> : Record<string, string>;
-  params: T["params"] extends TSchema ? Static<T["params"]> : Record<string, string>;
-  headers: T["headers"] extends TSchema ? Static<T["headers"]> : Record<string, string>;
-  cookies: T["cookies"] extends TSchema ? Static<T["cookies"]> : Record<string, string>;
-};
-/**
- * Handler 上下文类型
- */
-interface HandlerContext<T extends RouteSchema = RouteSchema> {
-  /** 原始请求对象 */
-  req: Request;
-  /** 请求体 (经过 schema 验证) */
-  body: InferSchema<T>["body"];
-  /** 查询参数 (经过 schema 验证) */
-  query: InferSchema<T>["query"];
-  /** 路径参数 (经过 schema 验证) */
-  params: InferSchema<T>["params"];
-  /** 请求头 (经过 schema 验证) */
-  headers: InferSchema<T>["headers"];
-  /** Cookie (经过 schema 验证) */
-  cookies: InferSchema<T>["cookies"];
-}
-/**
- * 带额外上下文的 Handler 上下文类型
- * 用于中间件注入额外数据
- */
-type HandlerContextWithExtra<T extends RouteSchema = RouteSchema, TExtra extends Record<string, unknown> = Record<string, never>> = HandlerContext<T> & TExtra;
-/**
- * Handler 函数类型
- */
-type TypedHandler<T extends RouteSchema = RouteSchema, TExtra extends Record<string, unknown> = Record<string, never>, TReturn = unknown> = (ctx: HandlerContextWithExtra<T, TExtra>) => TReturn | Promise<TReturn>;
-/**
- * 扩展的路由配置 (包含 schema)
- */
-interface TypedRouteConfig<T extends RouteSchema = RouteSchema> {
-  method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD";
-  path: string;
-  schema?: T;
-  handler: (req: Request) => Response | Promise<Response>;
-  middleware?: Array<(req: Request, next: () => Promise<Response>) => Promise<Response>>;
-  docs?: {
-    description?: string;
-    tags?: string[];
-    security?: unknown[];
-    responses?: Record<string, unknown>;
-  };
-  timeout?: number;
-  maxBodySize?: string;
-}
-//#endregion
-export { TypedHandler as a, RouteSchema as i, HandlerContextWithExtra as n, TypedRouteConfig as o, InferSchema as r, HandlerContext as t };
-//# sourceMappingURL=schema-B6DFN5c2.d.mts.map

package/dist/server-BUom6ISO.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-BUom6ISO.mjs","names":[],"sources":["../src/server/server-factory.ts"],"sourcesContent":["import type { Route, NestedRoute } from \"../types\";\nimport type {\n  ComponentRoute,\n  NestedComponentRoute,\n} from \"../types/component-route\";\nimport { Server } from \"../server\";\nimport { ComponentServer } from \"./component-server\";\n\n/**\n * 服务器工厂类\n * 用于创建和管理不同类型的服务器\n */\nexport class ServerFactory {\n  private servers: Map<string, Server | ComponentServer> = new Map();\n\n  /**\n   * 创建标准REST API服务器\n   */\n  createRestServer(routes: (Route | NestedRoute)[]): Server {\n    const server = new Server(routes);\n    this.servers.set(\"rest\", server);\n    return server;\n  }\n\n  /**\n   * 创建组件服务器\n   */\n  createComponentServer(\n    routes: (ComponentRoute | NestedComponentRoute)[],\n  ): ComponentServer {\n    const server = new ComponentServer(routes);\n    this.servers.set(\"component\", server);\n    return server;\n  }\n\n  /**\n   * 获取指定类型的服务器\n   */\n  getServer(type: \"rest\" | \"component\"): Server | ComponentServer | undefined {\n    return this.servers.get(type);\n  }\n\n  /**\n   * 获取所有服务器\n   */\n  getAllServers(): Map<string, Server | ComponentServer> {\n    return this.servers;\n  }\n\n  /**\n   * 移除指定类型的服务器\n   */\n  removeServer(type: string): boolean {\n    return this.servers.delete(type);\n  }\n\n  /**\n   * 清除所有服务器\n   */\n  clearServers(): void {\n    this.servers.clear();\n  }\n\n  /**\n   * 获取服务器状态信息\n   */\n  getServerStatus(): Record<string, { type: string; routes: number }> {\n    const status: Record<string, { type: string; routes: number }> = {};\n\n    for (const [name, server] of this.servers) {\n      if (server instanceof Server) {\n        status[name] = {\n          type: \"REST API\",\n          routes: (server as any).routes?.length || 0,\n        };\n      } else if (server instanceof ComponentServer) {\n        status[name] = {\n          type: \"Component\",\n          routes: (server as any).routes?.length || 0,\n        };\n      }\n    }\n\n    return status;\n  }\n}\n"],"mappings":";;;;;;;;AAYA,IAAa,gBAAb,MAA2B;CACzB,AAAQ,0BAAiD,IAAI,KAAK;;;;CAKlE,iBAAiB,QAAyC;EACxD,MAAM,SAAS,IAAI,OAAO,OAAO;AACjC,OAAK,QAAQ,IAAI,QAAQ,OAAO;AAChC,SAAO;;;;;CAMT,sBACE,QACiB;EACjB,MAAM,SAAS,IAAI,gBAAgB,OAAO;AAC1C,OAAK,QAAQ,IAAI,aAAa,OAAO;AACrC,SAAO;;;;;CAMT,UAAU,MAAkE;AAC1E,SAAO,KAAK,QAAQ,IAAI,KAAK;;;;;CAM/B,gBAAuD;AACrD,SAAO,KAAK;;;;;CAMd,aAAa,MAAuB;AAClC,SAAO,KAAK,QAAQ,OAAO,KAAK;;;;;CAMlC,eAAqB;AACnB,OAAK,QAAQ,OAAO;;;;;CAMtB,kBAAoE;EAClE,MAAM,SAA2D,EAAE;AAEnE,OAAK,MAAM,CAAC,MAAM,WAAW,KAAK,QAChC,KAAI,kBAAkB,OACpB,QAAO,QAAQ;GACb,MAAM;GACN,QAAS,OAAe,QAAQ,UAAU;GAC3C;WACQ,kBAAkB,gBAC3B,QAAO,QAAQ;GACb,MAAM;GACN,QAAS,OAAe,QAAQ,UAAU;GAC3C;AAIL,SAAO"}

package/dist/server-C2RPKSvC.d.mts

@@ -1,51 +0,0 @@
-import { a as Method, l as Route, n as FlattenedRoute, s as NestedRoute } from "./types-D1PUFkda.mjs";
-import { t as BaseServer } from "./base-server-DLxtulAO.mjs";
-
-//#region src/server/server.d.ts
-
-/**
- * Vafast 服务器
- *
- * @example
- * ```typescript
- * const server = new Server([
- *   { method: "GET", path: "/", handler: () => new Response("Hello") },
- * ]);
- * export default { fetch: server.fetch };
- * ```
- */
-declare class Server extends BaseServer {
-  private router;
-  private routes;
-  constructor(routes?: readonly (Route | NestedRoute)[]);
-  private registerRoutes;
-  /** 快速提取 pathname */
-  private extractPathname;
-  /** 生成 404/405 响应 */
-  private createErrorResponse;
-  /** 处理请求 */
-  fetch: (req: Request) => Promise<Response>;
-  addRoute(route: Route): void;
-  addRoutes(routes: readonly (Route | NestedRoute)[]): void;
-  getRoutes(): Array<{
-    method: Method;
-    path: string;
-  }>;
-  /**
-   * 获取完整的路由元信息（不含 handler 和 middleware）
-   *
-   * 用于 API 文档生成、Webhook 事件注册、权限检查等场景
-   *
-   * @example
-   * ```typescript
-   * const routes = server.getRoutesWithMeta()
-   * for (const route of routes) {
-   *   console.log(route.fullPath, route.name, route.description)
-   * }
-   * ```
-   */
-  getRoutesWithMeta(): FlattenedRoute[];
-}
-//#endregion
-export { Server as t };
-//# sourceMappingURL=server-C2RPKSvC.d.mts.map

package/dist/server-OUUug5DR.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-OUUug5DR.mjs","names":[],"sources":["../src/server/server.ts"],"sourcesContent":["/**\n * Vafast 核心服务器\n *\n * 基于 Radix Tree 的高性能路由匹配\n * 时间复杂度: O(k)，k 为路径段数\n */\n\nimport type { Route, NestedRoute, FlattenedRoute, Method } from \"../types\";\nimport { flattenNestedRoutes } from \"../router\";\nimport { composeMiddleware } from \"../middleware\";\nimport { json } from \"../utils/response\";\nimport { BaseServer } from \"./base-server\";\nimport { RadixRouter } from \"../router/radix-tree\";\nimport { RouteRegistry, setGlobalRegistry } from \"../utils/route-registry\";\n\n/**\n * Vafast 服务器\n *\n * @example\n * ```typescript\n * const server = new Server([\n *   { method: \"GET\", path: \"/\", handler: () => new Response(\"Hello\") },\n * ]);\n * export default { fetch: server.fetch };\n * ```\n */\nexport class Server extends BaseServer {\n  private router: RadixRouter;\n  private routes: FlattenedRoute[];\n\n  constructor(routes: readonly (Route | NestedRoute)[] = []) {\n    super();\n    this.router = new RadixRouter();\n    this.routes = [];\n\n    if (routes.length > 0) {\n      this.registerRoutes([...routes]);\n    }\n  }\n\n  private registerRoutes(routes: (Route | NestedRoute)[]): void {\n    const flattened = flattenNestedRoutes(routes);\n    this.routes.push(...flattened);\n\n    for (const route of flattened) {\n      this.router.register(\n        route.method as Method,\n        route.fullPath,\n        route.handler,\n        route.middlewareChain || [],\n      );\n    }\n\n    this.detectRouteConflicts(flattened);\n    this.logFlattenedRoutes(flattened);\n\n    // 自动设置全局 RouteRegistry（支持在任意位置通过 getRouteRegistry() 访问）\n    setGlobalRegistry(new RouteRegistry(this.routes));\n  }\n\n  /** 快速提取 pathname */\n  private extractPathname(url: string): string {\n    let start = url.indexOf(\"://\");\n    start = start === -1 ? 0 : start + 3;\n\n    const pathStart = url.indexOf(\"/\", start);\n    if (pathStart === -1) return \"/\";\n\n    let end = url.indexOf(\"?\", pathStart);\n    if (end === -1) end = url.indexOf(\"#\", pathStart);\n    if (end === -1) end = url.length;\n\n    return url.substring(pathStart, end) || \"/\";\n  }\n\n  /** 生成 404/405 响应 */\n  private createErrorResponse(method: string, pathname: string): Response {\n    const allowedMethods = this.router.getAllowedMethods(pathname);\n    if (allowedMethods.length > 0) {\n      return json(\n        {\n          success: false,\n          error: \"Method Not Allowed\",\n          message: `Method ${method} not allowed for this endpoint`,\n          allowedMethods,\n        },\n        405,\n        { Allow: allowedMethods.join(\", \") },\n      );\n    }\n    return json({ success: false, error: \"Not Found\" }, 404);\n  }\n\n  /** 处理请求 */\n  fetch = async (req: Request): Promise<Response> => {\n    const pathname = this.extractPathname(req.url);\n    const method = req.method as Method;\n\n    const match = this.router.match(method, pathname);\n\n    if (match) {\n      (req as unknown as Record<string, unknown>).params = match.params;\n\n      // 运行时组合中间件\n      const allMiddleware = [...this.globalMiddleware, ...match.middleware];\n      const handler = composeMiddleware(allMiddleware, match.handler);\n\n      return handler(req);\n    }\n\n    // OPTIONS 预检请求特殊处理：查找同路径其他方法的路由，使用其中间件\n    // 这允许路由级 CORS 中间件正常工作\n    if (method === \"OPTIONS\") {\n      const allowedMethods = this.router.getAllowedMethods(pathname);\n      if (allowedMethods.length > 0) {\n        // 尝试获取该路径任意方法的路由中间件\n        const anyMatch = this.router.match(\n          allowedMethods[0] as Method,\n          pathname,\n        );\n        const routeMiddleware = anyMatch?.middleware || [];\n        const allMiddleware = [...this.globalMiddleware, ...routeMiddleware];\n\n        // OPTIONS 请求默认返回 204（中间件如 CORS 可能会提前响应）\n        const optionsHandler = () =>\n          new Response(null, {\n            status: 204,\n            headers: { Allow: allowedMethods.join(\", \") },\n          });\n\n        const handler = composeMiddleware(allMiddleware, optionsHandler);\n        return handler(req);\n      }\n    }\n\n    // 未匹配路由时，仍执行全局中间件（如 CORS 处理 OPTIONS 预检）\n    if (this.globalMiddleware.length > 0) {\n      const handler = composeMiddleware(this.globalMiddleware, () =>\n        this.createErrorResponse(method, pathname),\n      );\n      return handler(req);\n    }\n\n    return this.createErrorResponse(method, pathname);\n  };\n\n  addRoute(route: Route): void {\n    const flattenedRoute: FlattenedRoute = {\n      ...route,\n      fullPath: route.path,\n      middlewareChain: route.middleware || [],\n    };\n\n    this.routes.push(flattenedRoute);\n    this.router.register(\n      route.method as Method,\n      route.path,\n      route.handler,\n      route.middleware || [],\n    );\n  }\n\n  addRoutes(routes: readonly (Route | NestedRoute)[]): void {\n    this.registerRoutes([...routes]);\n  }\n\n  getRoutes(): Array<{ method: Method; path: string }> {\n    return this.router.getRoutes();\n  }\n\n  /**\n   * 获取完整的路由元信息（不含 handler 和 middleware）\n   *\n   * 用于 API 文档生成、Webhook 事件注册、权限检查等场景\n   *\n   * @example\n   * ```typescript\n   * const routes = server.getRoutesWithMeta()\n   * for (const route of routes) {\n   *   console.log(route.fullPath, route.name, route.description)\n   * }\n   * ```\n   */\n  getRoutesWithMeta(): FlattenedRoute[] {\n    return this.routes;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA0BA,IAAa,SAAb,cAA4B,WAAW;CACrC,AAAQ;CACR,AAAQ;CAER,YAAY,SAA2C,EAAE,EAAE;AACzD,SAAO;AACP,OAAK,SAAS,IAAI,aAAa;AAC/B,OAAK,SAAS,EAAE;AAEhB,MAAI,OAAO,SAAS,EAClB,MAAK,eAAe,CAAC,GAAG,OAAO,CAAC;;CAIpC,AAAQ,eAAe,QAAuC;EAC5D,MAAM,YAAY,oBAAoB,OAAO;AAC7C,OAAK,OAAO,KAAK,GAAG,UAAU;AAE9B,OAAK,MAAM,SAAS,UAClB,MAAK,OAAO,SACV,MAAM,QACN,MAAM,UACN,MAAM,SACN,MAAM,mBAAmB,EAAE,CAC5B;AAGH,OAAK,qBAAqB,UAAU;AACpC,OAAK,mBAAmB,UAAU;AAGlC,oBAAkB,IAAI,cAAc,KAAK,OAAO,CAAC;;;CAInD,AAAQ,gBAAgB,KAAqB;EAC3C,IAAI,QAAQ,IAAI,QAAQ,MAAM;AAC9B,UAAQ,UAAU,KAAK,IAAI,QAAQ;EAEnC,MAAM,YAAY,IAAI,QAAQ,KAAK,MAAM;AACzC,MAAI,cAAc,GAAI,QAAO;EAE7B,IAAI,MAAM,IAAI,QAAQ,KAAK,UAAU;AACrC,MAAI,QAAQ,GAAI,OAAM,IAAI,QAAQ,KAAK,UAAU;AACjD,MAAI,QAAQ,GAAI,OAAM,IAAI;AAE1B,SAAO,IAAI,UAAU,WAAW,IAAI,IAAI;;;CAI1C,AAAQ,oBAAoB,QAAgB,UAA4B;EACtE,MAAM,iBAAiB,KAAK,OAAO,kBAAkB,SAAS;AAC9D,MAAI,eAAe,SAAS,EAC1B,QAAO,KACL;GACE,SAAS;GACT,OAAO;GACP,SAAS,UAAU,OAAO;GAC1B;GACD,EACD,KACA,EAAE,OAAO,eAAe,KAAK,KAAK,EAAE,CACrC;AAEH,SAAO,KAAK;GAAE,SAAS;GAAO,OAAO;GAAa,EAAE,IAAI;;;CAI1D,QAAQ,OAAO,QAAoC;EACjD,MAAM,WAAW,KAAK,gBAAgB,IAAI,IAAI;EAC9C,MAAM,SAAS,IAAI;EAEnB,MAAM,QAAQ,KAAK,OAAO,MAAM,QAAQ,SAAS;AAEjD,MAAI,OAAO;AACT,GAAC,IAA2C,SAAS,MAAM;AAM3D,UAFgB,kBADM,CAAC,GAAG,KAAK,kBAAkB,GAAG,MAAM,WAAW,EACpB,MAAM,QAAQ,CAEhD,IAAI;;AAKrB,MAAI,WAAW,WAAW;GACxB,MAAM,iBAAiB,KAAK,OAAO,kBAAkB,SAAS;AAC9D,OAAI,eAAe,SAAS,GAAG;IAM7B,MAAM,kBAJW,KAAK,OAAO,MAC3B,eAAe,IACf,SACD,EACiC,cAAc,EAAE;IAClD,MAAM,gBAAgB,CAAC,GAAG,KAAK,kBAAkB,GAAG,gBAAgB;IAGpE,MAAM,uBACJ,IAAI,SAAS,MAAM;KACjB,QAAQ;KACR,SAAS,EAAE,OAAO,eAAe,KAAK,KAAK,EAAE;KAC9C,CAAC;AAGJ,WADgB,kBAAkB,eAAe,eAAe,CACjD,IAAI;;;AAKvB,MAAI,KAAK,iBAAiB,SAAS,EAIjC,QAHgB,kBAAkB,KAAK,wBACrC,KAAK,oBAAoB,QAAQ,SAAS,CAC3C,CACc,IAAI;AAGrB,SAAO,KAAK,oBAAoB,QAAQ,SAAS;;CAGnD,SAAS,OAAoB;EAC3B,MAAM,iBAAiC;GACrC,GAAG;GACH,UAAU,MAAM;GAChB,iBAAiB,MAAM,cAAc,EAAE;GACxC;AAED,OAAK,OAAO,KAAK,eAAe;AAChC,OAAK,OAAO,SACV,MAAM,QACN,MAAM,MACN,MAAM,SACN,MAAM,cAAc,EAAE,CACvB;;CAGH,UAAU,QAAgD;AACxD,OAAK,eAAe,CAAC,GAAG,OAAO,CAAC;;CAGlC,YAAqD;AACnD,SAAO,KAAK,OAAO,WAAW;;;;;;;;;;;;;;;CAgBhC,oBAAsC;AACpC,SAAO,KAAK"}

package/dist/sse-CBl-szg1.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse-CBl-szg1.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 \"../types/schema\";\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 */\nexport interface SSEHandler<TSchema extends RouteSchema = RouteSchema> {\n  (req: Request): Promise<Response>;\n  /** 返回类型标记 - SSE 流的数据类型 */\n  readonly __returnType: unknown;\n  /** Schema 类型标记 */\n  readonly __schema: TSchema;\n  /** SSE 标记 - 使用品牌类型确保不被扩展 */\n  readonly __sse: SSEMarker;\n}\n\n/**\n * 创建 SSE 流式响应处理器\n *\n * @example\n * ```typescript\n * // 基础用法\n * const streamChat = createSSEHandler(\n *   { query: Type.Object({ message: Type.String() }) },\n *   async function* ({ query }) {\n *     const response = await ai.chat(query.message);\n *\n *     for await (const chunk of response) {\n *       yield { data: { text: chunk } };\n *     }\n *   }\n * );\n *\n * // 使用路由\n * route('GET', '/chat/stream', streamChat)\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  const handlerFn = async (req: Request): Promise<Response> => {\n    try {\n      // 解析请求数据\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      // 验证 schema\n      const data = { body: undefined, query, params, headers, cookies };\n      if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {\n        validateAllSchemas(schema, data);\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: undefined 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          success: false,\n          error: 'Validation Error',\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 { __schema: T }).__schema = schema;\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;;AAmD5B,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;CAG3B,MAAM,YAAY,OAAO,QAAoC;AAC3D,MAAI;GAEF,MAAM,QAAQ,WAAW,IAAI;GAC7B,MAAM,UAAU,aAAa,IAAI;GACjC,MAAM,UAAU,aAAa,IAAI;GACjC,MAAM,SAAW,IAA2C,UAAqC,EAAE;GAGnG,MAAM,OAAO;IAAE,MAAM;IAAW;IAAO;IAAQ;IAAS;IAAS;AACjE,OAAI,OAAO,QAAQ,OAAO,SAAS,OAAO,UAAU,OAAO,WAAW,OAAO,QAC3E,oBAAmB,QAAQ,KAAK;GAIlC,MAAM,SAAS,IAAI,eAAe,EAChC,MAAM,MAAM,YAAY;IACtB,MAAM,UAAU,IAAI,aAAa;AAEjC,QAAI;KACF,MAAM,MAAM,UAAU;MACpB;MACA,MAAM;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,SAAS;IACT,OAAO;IACP,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,QAAuC,WAAW;AACnD,CAAC,QAAiD,eAAe;AACjE,QAAO"}

package/dist/types/route.d.mts

@@ -1,2 +0,0 @@
-import { a as Middleware, c as createTypedRoute, i as FlattenedRoute, l as isTypedRoute, n as CompatibleRoute, o as NestedRouteConfig, r as ExtendedRouteConfig, s as TypedRoute, t as BaseRouteConfig } from "../route-6A7umH7b.mjs";
-export { BaseRouteConfig, CompatibleRoute, ExtendedRouteConfig, FlattenedRoute, Middleware, NestedRouteConfig, TypedRoute, createTypedRoute, isTypedRoute };

package/dist/types/route.mjs

@@ -1,3 +0,0 @@
-import { n as isTypedRoute, t as createTypedRoute } from "../route-Ds53PR4M.mjs";
-
-export { createTypedRoute, isTypedRoute };

package/dist/types/schema.d.mts

@@ -1,2 +0,0 @@
-import { a as TypedHandler, i as RouteSchema, n as HandlerContextWithExtra, o as TypedRouteConfig, r as InferSchema, t as HandlerContext } from "../schema-B6DFN5c2.mjs";
-export { HandlerContext, HandlerContextWithExtra, InferSchema, RouteSchema, TypedHandler, TypedRouteConfig };

package/dist/types/schema.mjs

@@ -1 +0,0 @@
-export {  };

package/dist/types-D1PUFkda.d.mts

@@ -1,45 +0,0 @@
-//#region src/types/types.d.ts
-type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD";
-/** 支持的响应类型 - 由 mapResponse 自动转换 */
-type ResponseBody = Response | string | number | boolean | object | null | undefined | ReadableStream | Blob | ArrayBuffer;
-/** Handler 返回值（支持同步/异步，任意类型） */
-/** 传统 Handler 类型 */
-type LegacyHandler = (req: Request, params?: Record<string, string>, user?: Record<string, any>) => ResponseBody | Promise<ResponseBody>;
-/** createHandler 返回的类型 */
-type FactoryHandler = (req: Request) => Promise<Response>;
-/** Handler 联合类型（支持两种风格） */
-type Handler = LegacyHandler | FactoryHandler;
-/** 中间件（返回值必须是 Response 或 Promise<Response>） */
-type Middleware = (req: Request, next: () => Promise<Response>) => Response | Promise<Response>;
-interface Route {
-  method: Method;
-  path: string;
-  handler: Handler;
-  middleware?: Middleware[];
-  /** 路由名称（用于文档、事件等） */
-  name?: string;
-  /** 路由描述 */
-  description?: string;
-  /** 允许任意扩展（支持 Webhook、权限等插件） */
-  [key: string]: unknown;
-}
-interface NestedRoute {
-  path: string;
-  middleware?: Middleware[];
-  children?: (NestedRoute | Route)[];
-  /** 路由组名称 */
-  name?: string;
-  /** 路由组描述 */
-  description?: string;
-  /** 允许任意扩展 */
-  [key: string]: unknown;
-}
-interface FlattenedRoute extends Route {
-  fullPath: string;
-  middlewareChain: Middleware[];
-  /** 父级路由的名称（用于分类显示） */
-  parentName?: string;
-}
-//#endregion
-export { Method as a, ResponseBody as c, LegacyHandler as i, Route as l, FlattenedRoute as n, Middleware as o, Handler as r, NestedRoute as s, FactoryHandler as t };
-//# sourceMappingURL=types-D1PUFkda.d.mts.map

package/dist/utils/create-handler.d.mts

@@ -1,3 +0,0 @@
-import "../schema-B6DFN5c2.mjs";
-import { i as simpleHandler, n as createHandler, r as createHandlerWithExtra, t as InferableHandler } from "../create-handler-DKw-sQOV.mjs";
-export { InferableHandler, createHandler, createHandlerWithExtra, simpleHandler };

package/dist/utils/create-handler.mjs

@@ -1,6 +0,0 @@
-import "../middleware-CewKbtb4.mjs";
-import "../parsers-DpH_mD0H.mjs";
-import "../validators-DBkyw6BG.mjs";
-import { n as createHandlerWithExtra, r as simpleHandler, t as createHandler } from "../create-handler-RconAcAB.mjs";
-
-export { createHandler, createHandlerWithExtra, simpleHandler };

package/dist/utils/request-validator.d.mts

@@ -1,3 +0,0 @@
-import "../validators-Ch71zkT8.mjs";
-import { a as parseAndValidateRequest, i as createRequestValidator, n as ValidatedRequestData, o as parseRequest, r as ValidationResult, s as validateRequest, t as RequestData } from "../request-validator-Coo8dI-p.mjs";
-export { RequestData, ValidatedRequestData, ValidationResult, createRequestValidator, parseAndValidateRequest, parseRequest, validateRequest };

package/dist/utils/request-validator.mjs

@@ -1,5 +0,0 @@
-import "../parsers-DpH_mD0H.mjs";
-import "../validators-DBkyw6BG.mjs";
-import { i as validateRequest, n as parseAndValidateRequest, r as parseRequest, t as createRequestValidator } from "../request-validator-Bz9X48FX.mjs";
-
-export { createRequestValidator, parseAndValidateRequest, parseRequest, validateRequest };