vafast 0.4.1 → 0.4.3

package/dist/response-CSKW5hsS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-CSKW5hsS.mjs","names":["stream"],"sources":["../src/utils/response.ts"],"sourcesContent":["// src/response.ts\n\n/** 生成 JSON 响应 */\nexport function json(\n  data: unknown,\n  status = 200,\n  headers: HeadersInit = {},\n): Response {\n  const body = JSON.stringify(data);\n\n  // 优化：只在有自定义 headers 时才创建 Headers 对象\n  if (Object.keys(headers).length === 0) {\n    return new Response(body, {\n      status,\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  }\n\n  // 有自定义 headers 时才创建 Headers 对象\n  const h = new Headers({\n    \"Content-Type\": \"application/json\",\n    ...headers,\n  });\n\n  return new Response(body, {\n    status,\n    headers: h,\n  });\n}\n\n// JSON 响应的预创建 headers（避免每次创建）\nconst JSON_HEADERS = { \"Content-Type\": \"application/json\" };\nconst TEXT_HEADERS = { \"Content-Type\": \"text/plain\" };\n\n/**\n * 类型特化的响应映射\n * 根据返回值类型直接生成 Response，避免不必要的检查\n */\nexport function mapResponse(response: unknown): Response {\n  // 快速路径：已经是 Response\n  if (response instanceof Response) return response;\n\n  // 使用 constructor.name 进行类型判断（比 instanceof 更快）\n  switch (response?.constructor?.name) {\n    case \"String\":\n      return new Response(response as string, { headers: TEXT_HEADERS });\n\n    case \"Object\":\n    case \"Array\":\n      return new Response(JSON.stringify(response), { headers: JSON_HEADERS });\n\n    case \"Number\":\n    case \"Boolean\":\n      return new Response(String(response), { headers: TEXT_HEADERS });\n\n    case undefined:\n      // null 或 undefined\n      return new Response(null, { status: 204 });\n\n    case \"ReadableStream\":\n      return new Response(response as ReadableStream);\n\n    case \"Blob\":\n      return new Response(response as Blob);\n\n    case \"ArrayBuffer\":\n      return new Response(response as ArrayBuffer);\n\n    case \"Uint8Array\":\n      return new Response(response as unknown as BodyInit);\n\n    default:\n      // Promise 处理\n      if (response instanceof Promise) {\n        return response.then(mapResponse) as unknown as Response;\n      }\n      // 其他情况使用 JSON 序列化\n      return new Response(JSON.stringify(response), { headers: JSON_HEADERS });\n  }\n}\n\n/** 生成重定向响应 */\nexport function redirect(location: string, status: 301 | 302 = 302): Response {\n  return new Response(null, {\n    status,\n    headers: {\n      Location: location,\n    },\n  });\n}\n\n/** 生成纯文本响应 */\nexport function text(\n  content: string,\n  status = 200,\n  headers: HeadersInit = {},\n): Response {\n  const h = new Headers({\n    \"Content-Type\": \"text/plain; charset=utf-8\",\n    ...headers,\n  });\n\n  return new Response(content, {\n    status,\n    headers: h,\n  });\n}\n\n/** 生成HTML响应 */\nexport function html(\n  content: string,\n  status = 200,\n  headers: HeadersInit = {},\n): Response {\n  const h = new Headers({\n    \"Content-Type\": \"text/html; charset=utf-8\",\n    ...headers,\n  });\n\n  return new Response(content, {\n    status,\n    headers: h,\n  });\n}\n\n/** 生成空响应（204 No Content） */\nexport function empty(status = 204, headers: HeadersInit = {}): Response {\n  return new Response(null, {\n    status,\n    headers,\n  });\n}\n\n/** 生成流式响应 */\nexport function stream(\n  stream: ReadableStream,\n  status = 200,\n  headers: HeadersInit = {},\n): Response {\n  const h = new Headers({\n    \"Content-Type\": \"application/octet-stream\",\n    ...headers,\n  });\n\n  return new Response(stream, {\n    status,\n    headers: h,\n  });\n}\n"],"mappings":";;;;AAGA,SAAgB,KACd,MACA,SAAS,KACT,UAAuB,EAAE,EACf;CACV,MAAM,OAAO,KAAK,UAAU,KAAK;AAGjC,KAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,QAAO,IAAI,SAAS,MAAM;EACxB;EACA,SAAS,EAAE,gBAAgB,oBAAoB;EAChD,CAAC;CAIJ,MAAM,IAAI,IAAI,QAAQ;EACpB,gBAAgB;EAChB,GAAG;EACJ,CAAC;AAEF,QAAO,IAAI,SAAS,MAAM;EACxB;EACA,SAAS;EACV,CAAC;;;;;;AAWJ,SAAgB,YAAY,UAA6B;AAEvD,KAAI,oBAAoB,SAAU,QAAO;AAGzC,SAAQ,UAAU,aAAa,MAA/B;EACE,KAAK,SACH,QAAO,IAAI,SAAS,UAAoB,EAAE,SAAS,cAAc,CAAC;EAEpE,KAAK;EACL,KAAK,QACH,QAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE,EAAE,SAAS,cAAc,CAAC;EAE1E,KAAK;EACL,KAAK,UACH,QAAO,IAAI,SAAS,OAAO,SAAS,EAAE,EAAE,SAAS,cAAc,CAAC;EAElE,KAAK,OAEH,QAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC;EAE5C,KAAK,iBACH,QAAO,IAAI,SAAS,SAA2B;EAEjD,KAAK,OACH,QAAO,IAAI,SAAS,SAAiB;EAEvC,KAAK,cACH,QAAO,IAAI,SAAS,SAAwB;EAE9C,KAAK,aACH,QAAO,IAAI,SAAS,SAAgC;EAEtD;AAEE,OAAI,oBAAoB,QACtB,QAAO,SAAS,KAAK,YAAY;AAGnC,UAAO,IAAI,SAAS,KAAK,UAAU,SAAS,EAAE,EAAE,SAAS,cAAc,CAAC;;;;AAK9E,SAAgB,SAAS,UAAkB,SAAoB,KAAe;AAC5E,QAAO,IAAI,SAAS,MAAM;EACxB;EACA,SAAS,EACP,UAAU,UACX;EACF,CAAC;;;AAIJ,SAAgB,KACd,SACA,SAAS,KACT,UAAuB,EAAE,EACf;CACV,MAAM,IAAI,IAAI,QAAQ;EACpB,gBAAgB;EAChB,GAAG;EACJ,CAAC;AAEF,QAAO,IAAI,SAAS,SAAS;EAC3B;EACA,SAAS;EACV,CAAC;;;AAIJ,SAAgB,KACd,SACA,SAAS,KACT,UAAuB,EAAE,EACf;CACV,MAAM,IAAI,IAAI,QAAQ;EACpB,gBAAgB;EAChB,GAAG;EACJ,CAAC;AAEF,QAAO,IAAI,SAAS,SAAS;EAC3B;EACA,SAAS;EACV,CAAC;;;AAIJ,SAAgB,MAAM,SAAS,KAAK,UAAuB,EAAE,EAAY;AACvE,QAAO,IAAI,SAAS,MAAM;EACxB;EACA;EACD,CAAC;;;AAIJ,SAAgB,OACd,UACA,SAAS,KACT,UAAuB,EAAE,EACf;CACV,MAAM,IAAI,IAAI,QAAQ;EACpB,gBAAgB;EAChB,GAAG;EACJ,CAAC;AAEF,QAAO,IAAI,SAASA,UAAQ;EAC1B;EACA,SAAS;EACV,CAAC;;;;CApHE,eAAe,EAAE,gBAAgB,oBAAoB;CACrD,eAAe,EAAE,gBAAgB,cAAc"}

package/dist/{utils/response.d.ts → response-CUyV5FIm.d.mts}

@@ -1,3 +1,4 @@
+//#region src/utils/response.d.ts
 /** 生成 JSON 响应 */
 declare function json(data: unknown, status?: number, headers?: HeadersInit): Response;
 /**
@@ -15,5 +16,6 @@ declare function html(content: string, status?: number, headers?: HeadersInit):
 declare function empty(status?: number, headers?: HeadersInit): Response;
 /** 生成流式响应 */
 declare function stream(stream: ReadableStream, status?: number, headers?: HeadersInit): Response;
-
-export { empty, html, json, mapResponse, redirect, stream, text };
+//#endregion
+export { redirect as a, mapResponse as i, html as n, stream as o, json as r, text as s, empty as t };
+//# sourceMappingURL=response-CUyV5FIm.d.mts.map

package/dist/route-BRR15b-p.mjs

@@ -0,0 +1,11 @@
+//#region src/types/route.ts
+function createTypedRoute(config) {
+	return config;
+}
+function isTypedRoute(route) {
+	return route && typeof route === "object" && "method" in route && "path" in route && "handler" in route;
+}
+
+//#endregion
+export { isTypedRoute as n, createTypedRoute as t };
+//# sourceMappingURL=route-BRR15b-p.mjs.map

package/dist/route-BRR15b-p.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-BRR15b-p.mjs","names":[],"sources":["../src/types/route.ts"],"sourcesContent":["import { Route, ResponseBody } from \"./types\";\n\n// 定义中间件类型\nexport interface Middleware {\n  (req: Request, next: () => Promise<Response>): Promise<Response>;\n}\n\n// 基础路由配置\nexport interface BaseRouteConfig {\n  method: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\" | \"OPTIONS\" | \"HEAD\";\n  path: string;\n  handler: (req: Request) => ResponseBody | Promise<ResponseBody>;\n}\n\n// 扩展的路由配置 - 只保留Schema验证和中间件\nexport interface ExtendedRouteConfig extends BaseRouteConfig {\n  // Tirne 中间件系统\n  middleware?: Middleware[];\n\n  // Schema验证配置\n  body?: any;\n  query?: any;\n  params?: any;\n  headers?: any;\n  cookies?: any;\n\n  // 其他配置\n  docs?: {\n    description?: string;\n    tags?: string[];\n    security?: any[];\n    responses?: Record<string, any>;\n  };\n  timeout?: number;\n  maxBodySize?: string;\n\n  // 允许任意扩展\n  [key: string]: any;\n}\n\n// 嵌套路由配置\nexport interface NestedRouteConfig {\n  path: string;\n  middleware?: Middleware[];\n  children?: (NestedRouteConfig | ExtendedRouteConfig)[];\n}\n\n// 类型安全的路由\nexport type TypedRoute = ExtendedRouteConfig;\n\n// 兼容类型：可以接受Route或TypedRoute\nexport type CompatibleRoute = Route | TypedRoute;\n\n// 扁平化后的路由，包含完整的中间件链\nexport interface FlattenedRoute extends ExtendedRouteConfig {\n  fullPath: string;\n  middlewareChain: Middleware[];\n}\n\n// 导出一些实际的函数，确保 JavaScript 代码生成\nexport function createTypedRoute(\n  config: ExtendedRouteConfig,\n): ExtendedRouteConfig {\n  return config;\n}\n\nexport function isTypedRoute(route: any): route is TypedRoute {\n  return (\n    route &&\n    typeof route === \"object\" &&\n    \"method\" in route &&\n    \"path\" in route &&\n    \"handler\" in route\n  );\n}\n"],"mappings":";AA4DA,SAAgB,iBACd,QACqB;AACrB,QAAO;;AAGT,SAAgB,aAAa,OAAiC;AAC5D,QACE,SACA,OAAO,UAAU,YACjB,YAAY,SACZ,UAAU,SACV,aAAa"}

package/dist/route-BqmWCG4e.d.mts

@@ -0,0 +1,44 @@
+import { c as ResponseBody, l as Route } from "./types-Cb7_2VSt.mjs";
+
+//#region src/types/route.d.ts
+interface Middleware {
+  (req: Request, next: () => Promise<Response>): Promise<Response>;
+}
+interface BaseRouteConfig {
+  method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD";
+  path: string;
+  handler: (req: Request) => ResponseBody | Promise<ResponseBody>;
+}
+interface ExtendedRouteConfig extends BaseRouteConfig {
+  middleware?: Middleware[];
+  body?: any;
+  query?: any;
+  params?: any;
+  headers?: any;
+  cookies?: any;
+  docs?: {
+    description?: string;
+    tags?: string[];
+    security?: any[];
+    responses?: Record<string, any>;
+  };
+  timeout?: number;
+  maxBodySize?: string;
+  [key: string]: any;
+}
+interface NestedRouteConfig {
+  path: string;
+  middleware?: Middleware[];
+  children?: (NestedRouteConfig | ExtendedRouteConfig)[];
+}
+type TypedRoute = ExtendedRouteConfig;
+type CompatibleRoute = Route | TypedRoute;
+interface FlattenedRoute extends ExtendedRouteConfig {
+  fullPath: string;
+  middlewareChain: Middleware[];
+}
+declare function createTypedRoute(config: ExtendedRouteConfig): ExtendedRouteConfig;
+declare function isTypedRoute(route: any): route is TypedRoute;
+//#endregion
+export { Middleware as a, createTypedRoute as c, FlattenedRoute as i, isTypedRoute as l, CompatibleRoute as n, NestedRouteConfig as o, ExtendedRouteConfig as r, TypedRoute as s, BaseRouteConfig as t };
+//# sourceMappingURL=route-BqmWCG4e.d.mts.map

package/dist/route-registry-AlkDgbcE.mjs

@@ -0,0 +1,225 @@
+import { t as __esmMin } from "./chunk-67U6L5Jh.mjs";
+
+//#region src/utils/route-registry.ts
+/**
+* 创建路由注册表
+*
+* @example
+* ```typescript
+* // 定义扩展字段类型
+* interface MyRouteMeta {
+*   webhook?: { eventKey: string }
+*   permission?: string
+* }
+*
+* // 创建带类型的注册表
+* const registry = createRouteRegistry<MyRouteMeta>(server.getRoutes())
+*
+* // 类型安全的查询
+* const route = registry.get('POST', '/auth/signIn')
+* if (route?.webhook) {
+*   console.log(route.webhook.eventKey)
+* }
+* ```
+*/
+function createRouteRegistry(routes) {
+	return new RouteRegistry(routes);
+}
+/**
+* 设置全局 registry（框架内部使用）
+* @internal
+*/
+function setGlobalRegistry(registry) {
+	globalRegistry = registry;
+}
+/**
+* 获取全局路由注册表
+*
+* @example
+* ```typescript
+* // 在任意文件中
+* import { getRouteRegistry } from 'vafast'
+*
+* const registry = getRouteRegistry()
+* const webhookRoutes = registry.filter('webhook')
+* ```
+*
+* @throws 如果 Server 尚未创建
+*/
+function getRouteRegistry() {
+	if (!globalRegistry) throw new Error("RouteRegistry not initialized. Make sure Server is created first.");
+	return globalRegistry;
+}
+/**
+* 按 method + path 获取单个路由
+*
+* 便捷函数，无需先获取 registry
+*
+* @example
+* ```typescript
+* // 在中间件或接口中
+* import { getRoute } from 'vafast'
+*
+* const route = getRoute('POST', '/auth/signIn')
+* if (route?.webhook) {
+*   console.log('This route has webhook:', route.webhook)
+* }
+* ```
+*/
+function getRoute(method, path) {
+	return getRouteRegistry().get(method, path);
+}
+/**
+* 获取所有路由
+*
+* @example
+* ```typescript
+* import { getAllRoutes } from 'vafast'
+*
+* const routes = getAllRoutes()
+* console.log(`Total ${routes.length} routes`)
+* ```
+*/
+function getAllRoutes() {
+	return getRouteRegistry().getAll();
+}
+/**
+* 筛选有特定字段的路由
+*
+* @example
+* ```typescript
+* import { filterRoutes } from 'vafast'
+*
+* // 获取所有配置了 webhook 的路由
+* const webhookRoutes = filterRoutes('webhook')
+* ```
+*/
+function filterRoutes(field) {
+	return getRouteRegistry().filter(field);
+}
+var RouteRegistry, globalRegistry;
+var init_route_registry = __esmMin((() => {
+	RouteRegistry = class {
+		/** 所有路由元信息 */
+		routes = [];
+		/** 路由映射表：METHOD:fullPath -> RouteMeta */
+		routeMap = /* @__PURE__ */ new Map();
+		/** 分类映射表：category -> RouteMeta[] */
+		categoryMap = /* @__PURE__ */ new Map();
+		constructor(routes) {
+			this.buildRegistry(routes);
+		}
+		/**
+		* 构建注册表
+		*/
+		buildRegistry(routes) {
+			for (const route of routes) {
+				const meta = {
+					method: route.method,
+					path: route.path,
+					fullPath: route.fullPath,
+					name: route.name,
+					description: route.description
+				};
+				for (const key of Object.keys(route)) if (![
+					"method",
+					"path",
+					"fullPath",
+					"name",
+					"description",
+					"handler",
+					"middleware",
+					"middlewareChain"
+				].includes(key)) meta[key] = route[key];
+				this.routes.push(meta);
+				this.routeMap.set(`${route.method}:${route.fullPath}`, meta);
+				const category = this.extractCategory(route.fullPath);
+				if (!this.categoryMap.has(category)) this.categoryMap.set(category, []);
+				this.categoryMap.get(category).push(meta);
+			}
+		}
+		/**
+		* 提取分类（第一段路径）
+		*/
+		extractCategory(path) {
+			return path.split("/").filter(Boolean)[0] || "root";
+		}
+		/**
+		* 获取所有路由元信息
+		*/
+		getAll() {
+			return [...this.routes];
+		}
+		/**
+		* 按 method + path 查询路由
+		*/
+		get(method, path) {
+			return this.routeMap.get(`${method}:${path}`);
+		}
+		/**
+		* 检查路由是否存在
+		*/
+		has(method, path) {
+			return this.routeMap.has(`${method}:${path}`);
+		}
+		/**
+		* 按分类获取路由
+		*/
+		getByCategory(category) {
+			return this.categoryMap.get(category) || [];
+		}
+		/**
+		* 获取所有分类
+		*/
+		getCategories() {
+			return Array.from(this.categoryMap.keys()).sort();
+		}
+		/**
+		* 筛选有特定字段的路由
+		*
+		* @example
+		* ```typescript
+		* // 获取所有配置了 webhook 的路由
+		* const webhookRoutes = registry.filter('webhook')
+		* ```
+		*/
+		filter(field) {
+			return this.routes.filter((r) => field in r && r[field] !== void 0);
+		}
+		/**
+		* 按条件筛选路由
+		*
+		* @example
+		* ```typescript
+		* // 获取所有 POST 请求
+		* const postRoutes = registry.filterBy(r => r.method === 'POST')
+		* ```
+		*/
+		filterBy(predicate) {
+			return this.routes.filter(predicate);
+		}
+		/**
+		* 获取路由数量
+		*/
+		get size() {
+			return this.routes.length;
+		}
+		/**
+		* 遍历所有路由
+		*/
+		forEach(callback) {
+			this.routes.forEach(callback);
+		}
+		/**
+		* 映射所有路由
+		*/
+		map(callback) {
+			return this.routes.map(callback);
+		}
+	};
+	globalRegistry = null;
+}));
+
+//#endregion
+export { getRoute as a, setGlobalRegistry as c, getAllRoutes as i, createRouteRegistry as n, getRouteRegistry as o, filterRoutes as r, init_route_registry as s, RouteRegistry as t };
+//# sourceMappingURL=route-registry-AlkDgbcE.mjs.map

package/dist/route-registry-AlkDgbcE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-registry-AlkDgbcE.mjs","names":[],"sources":["../src/utils/route-registry.ts"],"sourcesContent":["/**\n * 路由注册表\n *\n * 提供路由元信息的收集和查询能力\n * 可用于：API 文档生成、Webhook 事件注册、权限检查、审计日志等\n *\n * @example\n * ```typescript\n * // 创建注册表\n * const registry = createRouteRegistry(server.getRoutes())\n *\n * // 查询路由\n * const route = registry.get('POST', '/auth/signIn')\n *\n * // 筛选有 webhook 配置的路由\n * const webhookRoutes = registry.filter('webhook')\n *\n * // 按分类获取\n * const authRoutes = registry.getByCategory('auth')\n * ```\n */\n\nimport type { FlattenedRoute, Method } from '../types'\n\n/**\n * 路由元信息（不含 handler 和 middleware）\n */\nexport interface RouteMeta {\n  method: Method\n  path: string\n  fullPath: string\n  name?: string\n  description?: string\n  /** 扩展字段 */\n  [key: string]: unknown\n}\n\n/**\n * 路由注册表\n *\n * 泛型 T 用于定义扩展字段的类型\n */\nexport class RouteRegistry<T extends Record<string, unknown> = Record<string, unknown>> {\n  /** 所有路由元信息 */\n  private routes: RouteMeta[] = []\n\n  /** 路由映射表：METHOD:fullPath -> RouteMeta */\n  private routeMap = new Map<string, RouteMeta>()\n\n  /** 分类映射表：category -> RouteMeta[] */\n  private categoryMap = new Map<string, RouteMeta[]>()\n\n  constructor(routes: FlattenedRoute[]) {\n    this.buildRegistry(routes)\n  }\n\n  /**\n   * 构建注册表\n   */\n  private buildRegistry(routes: FlattenedRoute[]): void {\n    for (const route of routes) {\n      // 提取元信息（排除 handler 和 middleware）\n      const meta: RouteMeta = {\n        method: route.method,\n        path: route.path,\n        fullPath: route.fullPath,\n        name: route.name,\n        description: route.description,\n      }\n\n      // 复制扩展字段\n      for (const key of Object.keys(route)) {\n        if (!['method', 'path', 'fullPath', 'name', 'description', 'handler', 'middleware', 'middlewareChain'].includes(key)) {\n          meta[key] = route[key as keyof FlattenedRoute]\n        }\n      }\n\n      this.routes.push(meta)\n      this.routeMap.set(`${route.method}:${route.fullPath}`, meta)\n\n      // 按分类索引\n      const category = this.extractCategory(route.fullPath)\n      if (!this.categoryMap.has(category)) {\n        this.categoryMap.set(category, [])\n      }\n      this.categoryMap.get(category)!.push(meta)\n    }\n  }\n\n  /**\n   * 提取分类（第一段路径）\n   */\n  private extractCategory(path: string): string {\n    const segments = path.split('/').filter(Boolean)\n    return segments[0] || 'root'\n  }\n\n  // ============================================\n  // 查询接口\n  // ============================================\n\n  /**\n   * 获取所有路由元信息\n   */\n  getAll(): RouteMeta[] {\n    return [...this.routes]\n  }\n\n  /**\n   * 按 method + path 查询路由\n   */\n  get(method: string, path: string): (RouteMeta & T) | undefined {\n    return this.routeMap.get(`${method}:${path}`) as (RouteMeta & T) | undefined\n  }\n\n  /**\n   * 检查路由是否存在\n   */\n  has(method: string, path: string): boolean {\n    return this.routeMap.has(`${method}:${path}`)\n  }\n\n  /**\n   * 按分类获取路由\n   */\n  getByCategory(category: string): RouteMeta[] {\n    return this.categoryMap.get(category) || []\n  }\n\n  /**\n   * 获取所有分类\n   */\n  getCategories(): string[] {\n    return Array.from(this.categoryMap.keys()).sort()\n  }\n\n  /**\n   * 筛选有特定字段的路由\n   *\n   * @example\n   * ```typescript\n   * // 获取所有配置了 webhook 的路由\n   * const webhookRoutes = registry.filter('webhook')\n   * ```\n   */\n  filter<K extends string>(field: K): (RouteMeta & Record<K, unknown>)[] {\n    return this.routes.filter((r) => field in r && r[field] !== undefined) as (RouteMeta & Record<K, unknown>)[]\n  }\n\n  /**\n   * 按条件筛选路由\n   *\n   * @example\n   * ```typescript\n   * // 获取所有 POST 请求\n   * const postRoutes = registry.filterBy(r => r.method === 'POST')\n   * ```\n   */\n  filterBy(predicate: (route: RouteMeta) => boolean): RouteMeta[] {\n    return this.routes.filter(predicate)\n  }\n\n  /**\n   * 获取路由数量\n   */\n  get size(): number {\n    return this.routes.length\n  }\n\n  /**\n   * 遍历所有路由\n   */\n  forEach(callback: (route: RouteMeta, index: number) => void): void {\n    this.routes.forEach(callback)\n  }\n\n  /**\n   * 映射所有路由\n   */\n  map<R>(callback: (route: RouteMeta, index: number) => R): R[] {\n    return this.routes.map(callback)\n  }\n}\n\n/**\n * 创建路由注册表\n *\n * @example\n * ```typescript\n * // 定义扩展字段类型\n * interface MyRouteMeta {\n *   webhook?: { eventKey: string }\n *   permission?: string\n * }\n *\n * // 创建带类型的注册表\n * const registry = createRouteRegistry<MyRouteMeta>(server.getRoutes())\n *\n * // 类型安全的查询\n * const route = registry.get('POST', '/auth/signIn')\n * if (route?.webhook) {\n *   console.log(route.webhook.eventKey)\n * }\n * ```\n */\nexport function createRouteRegistry<T extends Record<string, unknown> = Record<string, unknown>>(\n  routes: FlattenedRoute[]\n): RouteRegistry<T> {\n  return new RouteRegistry<T>(routes)\n}\n\n// ============================================\n// 全局 Registry（单例模式）\n// ============================================\n\n/** 全局 registry 实例 */\nlet globalRegistry: RouteRegistry | null = null\n\n/**\n * 设置全局 registry（框架内部使用）\n * @internal\n */\nexport function setGlobalRegistry(registry: RouteRegistry): void {\n  globalRegistry = registry\n}\n\n/**\n * 获取全局路由注册表\n *\n * @example\n * ```typescript\n * // 在任意文件中\n * import { getRouteRegistry } from 'vafast'\n *\n * const registry = getRouteRegistry()\n * const webhookRoutes = registry.filter('webhook')\n * ```\n *\n * @throws 如果 Server 尚未创建\n */\nexport function getRouteRegistry<T extends Record<string, unknown> = Record<string, unknown>>(): RouteRegistry<T> {\n  if (!globalRegistry) {\n    throw new Error('RouteRegistry not initialized. Make sure Server is created first.')\n  }\n  return globalRegistry as RouteRegistry<T>\n}\n\n/**\n * 按 method + path 获取单个路由\n *\n * 便捷函数，无需先获取 registry\n *\n * @example\n * ```typescript\n * // 在中间件或接口中\n * import { getRoute } from 'vafast'\n *\n * const route = getRoute('POST', '/auth/signIn')\n * if (route?.webhook) {\n *   console.log('This route has webhook:', route.webhook)\n * }\n * ```\n */\nexport function getRoute<T extends Record<string, unknown> = Record<string, unknown>>(\n  method: string,\n  path: string\n): (RouteMeta & T) | undefined {\n  return getRouteRegistry<T>().get(method, path)\n}\n\n/**\n * 获取所有路由\n *\n * @example\n * ```typescript\n * import { getAllRoutes } from 'vafast'\n *\n * const routes = getAllRoutes()\n * console.log(`Total ${routes.length} routes`)\n * ```\n */\nexport function getAllRoutes(): RouteMeta[] {\n  return getRouteRegistry().getAll()\n}\n\n/**\n * 筛选有特定字段的路由\n *\n * @example\n * ```typescript\n * import { filterRoutes } from 'vafast'\n *\n * // 获取所有配置了 webhook 的路由\n * const webhookRoutes = filterRoutes('webhook')\n * ```\n */\nexport function filterRoutes<K extends string>(field: K): (RouteMeta & Record<K, unknown>)[] {\n  return getRouteRegistry().filter(field)\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA6MA,SAAgB,oBACd,QACkB;AAClB,QAAO,IAAI,cAAiB,OAAO;;;;;;AAcrC,SAAgB,kBAAkB,UAA+B;AAC/D,kBAAiB;;;;;;;;;;;;;;;;AAiBnB,SAAgB,mBAAkG;AAChH,KAAI,CAAC,eACH,OAAM,IAAI,MAAM,oEAAoE;AAEtF,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,SACd,QACA,MAC6B;AAC7B,QAAO,kBAAqB,CAAC,IAAI,QAAQ,KAAK;;;;;;;;;;;;;AAchD,SAAgB,eAA4B;AAC1C,QAAO,kBAAkB,CAAC,QAAQ;;;;;;;;;;;;;AAcpC,SAAgB,aAA+B,OAA8C;AAC3F,QAAO,kBAAkB,CAAC,OAAO,MAAM;;;;CA/P5B,gBAAb,MAAwF;;EAEtF,AAAQ,SAAsB,EAAE;;EAGhC,AAAQ,2BAAW,IAAI,KAAwB;;EAG/C,AAAQ,8BAAc,IAAI,KAA0B;EAEpD,YAAY,QAA0B;AACpC,QAAK,cAAc,OAAO;;;;;EAM5B,AAAQ,cAAc,QAAgC;AACpD,QAAK,MAAM,SAAS,QAAQ;IAE1B,MAAM,OAAkB;KACtB,QAAQ,MAAM;KACd,MAAM,MAAM;KACZ,UAAU,MAAM;KAChB,MAAM,MAAM;KACZ,aAAa,MAAM;KACpB;AAGD,SAAK,MAAM,OAAO,OAAO,KAAK,MAAM,CAClC,KAAI,CAAC;KAAC;KAAU;KAAQ;KAAY;KAAQ;KAAe;KAAW;KAAc;KAAkB,CAAC,SAAS,IAAI,CAClH,MAAK,OAAO,MAAM;AAItB,SAAK,OAAO,KAAK,KAAK;AACtB,SAAK,SAAS,IAAI,GAAG,MAAM,OAAO,GAAG,MAAM,YAAY,KAAK;IAG5D,MAAM,WAAW,KAAK,gBAAgB,MAAM,SAAS;AACrD,QAAI,CAAC,KAAK,YAAY,IAAI,SAAS,CACjC,MAAK,YAAY,IAAI,UAAU,EAAE,CAAC;AAEpC,SAAK,YAAY,IAAI,SAAS,CAAE,KAAK,KAAK;;;;;;EAO9C,AAAQ,gBAAgB,MAAsB;AAE5C,UADiB,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAChC,MAAM;;;;;EAUxB,SAAsB;AACpB,UAAO,CAAC,GAAG,KAAK,OAAO;;;;;EAMzB,IAAI,QAAgB,MAA2C;AAC7D,UAAO,KAAK,SAAS,IAAI,GAAG,OAAO,GAAG,OAAO;;;;;EAM/C,IAAI,QAAgB,MAAuB;AACzC,UAAO,KAAK,SAAS,IAAI,GAAG,OAAO,GAAG,OAAO;;;;;EAM/C,cAAc,UAA+B;AAC3C,UAAO,KAAK,YAAY,IAAI,SAAS,IAAI,EAAE;;;;;EAM7C,gBAA0B;AACxB,UAAO,MAAM,KAAK,KAAK,YAAY,MAAM,CAAC,CAAC,MAAM;;;;;;;;;;;EAYnD,OAAyB,OAA8C;AACrE,UAAO,KAAK,OAAO,QAAQ,MAAM,SAAS,KAAK,EAAE,WAAW,OAAU;;;;;;;;;;;EAYxE,SAAS,WAAuD;AAC9D,UAAO,KAAK,OAAO,OAAO,UAAU;;;;;EAMtC,IAAI,OAAe;AACjB,UAAO,KAAK,OAAO;;;;;EAMrB,QAAQ,UAA2D;AACjE,QAAK,OAAO,QAAQ,SAAS;;;;;EAM/B,IAAO,UAAuD;AAC5D,UAAO,KAAK,OAAO,IAAI,SAAS;;;CAoChC,iBAAuC"}

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

@@ -0,0 +1,176 @@
+import { a as Method, n as FlattenedRoute } from "./types-Cb7_2VSt.mjs";
+
+//#region src/utils/route-registry.d.ts
+
+/**
+ * 路由元信息（不含 handler 和 middleware）
+ */
+interface RouteMeta {
+  method: Method;
+  path: string;
+  fullPath: string;
+  name?: string;
+  description?: string;
+  /** 扩展字段 */
+  [key: string]: unknown;
+}
+/**
+ * 路由注册表
+ *
+ * 泛型 T 用于定义扩展字段的类型
+ */
+declare class RouteRegistry<T extends Record<string, unknown> = Record<string, unknown>> {
+  /** 所有路由元信息 */
+  private routes;
+  /** 路由映射表：METHOD:fullPath -> RouteMeta */
+  private routeMap;
+  /** 分类映射表：category -> RouteMeta[] */
+  private categoryMap;
+  constructor(routes: FlattenedRoute[]);
+  /**
+   * 构建注册表
+   */
+  private buildRegistry;
+  /**
+   * 提取分类（第一段路径）
+   */
+  private extractCategory;
+  /**
+   * 获取所有路由元信息
+   */
+  getAll(): RouteMeta[];
+  /**
+   * 按 method + path 查询路由
+   */
+  get(method: string, path: string): (RouteMeta & T) | undefined;
+  /**
+   * 检查路由是否存在
+   */
+  has(method: string, path: string): boolean;
+  /**
+   * 按分类获取路由
+   */
+  getByCategory(category: string): RouteMeta[];
+  /**
+   * 获取所有分类
+   */
+  getCategories(): string[];
+  /**
+   * 筛选有特定字段的路由
+   *
+   * @example
+   * ```typescript
+   * // 获取所有配置了 webhook 的路由
+   * const webhookRoutes = registry.filter('webhook')
+   * ```
+   */
+  filter<K extends string>(field: K): (RouteMeta & Record<K, unknown>)[];
+  /**
+   * 按条件筛选路由
+   *
+   * @example
+   * ```typescript
+   * // 获取所有 POST 请求
+   * const postRoutes = registry.filterBy(r => r.method === 'POST')
+   * ```
+   */
+  filterBy(predicate: (route: RouteMeta) => boolean): RouteMeta[];
+  /**
+   * 获取路由数量
+   */
+  get size(): number;
+  /**
+   * 遍历所有路由
+   */
+  forEach(callback: (route: RouteMeta, index: number) => void): void;
+  /**
+   * 映射所有路由
+   */
+  map<R>(callback: (route: RouteMeta, index: number) => R): R[];
+}
+/**
+ * 创建路由注册表
+ *
+ * @example
+ * ```typescript
+ * // 定义扩展字段类型
+ * interface MyRouteMeta {
+ *   webhook?: { eventKey: string }
+ *   permission?: string
+ * }
+ *
+ * // 创建带类型的注册表
+ * const registry = createRouteRegistry<MyRouteMeta>(server.getRoutes())
+ *
+ * // 类型安全的查询
+ * const route = registry.get('POST', '/auth/signIn')
+ * if (route?.webhook) {
+ *   console.log(route.webhook.eventKey)
+ * }
+ * ```
+ */
+declare function createRouteRegistry<T extends Record<string, unknown> = Record<string, unknown>>(routes: FlattenedRoute[]): RouteRegistry<T>;
+/**
+ * 设置全局 registry（框架内部使用）
+ * @internal
+ */
+declare function setGlobalRegistry(registry: RouteRegistry): void;
+/**
+ * 获取全局路由注册表
+ *
+ * @example
+ * ```typescript
+ * // 在任意文件中
+ * import { getRouteRegistry } from 'vafast'
+ *
+ * const registry = getRouteRegistry()
+ * const webhookRoutes = registry.filter('webhook')
+ * ```
+ *
+ * @throws 如果 Server 尚未创建
+ */
+declare function getRouteRegistry<T extends Record<string, unknown> = Record<string, unknown>>(): RouteRegistry<T>;
+/**
+ * 按 method + path 获取单个路由
+ *
+ * 便捷函数，无需先获取 registry
+ *
+ * @example
+ * ```typescript
+ * // 在中间件或接口中
+ * import { getRoute } from 'vafast'
+ *
+ * const route = getRoute('POST', '/auth/signIn')
+ * if (route?.webhook) {
+ *   console.log('This route has webhook:', route.webhook)
+ * }
+ * ```
+ */
+declare function getRoute<T extends Record<string, unknown> = Record<string, unknown>>(method: string, path: string): (RouteMeta & T) | undefined;
+/**
+ * 获取所有路由
+ *
+ * @example
+ * ```typescript
+ * import { getAllRoutes } from 'vafast'
+ *
+ * const routes = getAllRoutes()
+ * console.log(`Total ${routes.length} routes`)
+ * ```
+ */
+declare function getAllRoutes(): RouteMeta[];
+/**
+ * 筛选有特定字段的路由
+ *
+ * @example
+ * ```typescript
+ * import { filterRoutes } from 'vafast'
+ *
+ * // 获取所有配置了 webhook 的路由
+ * const webhookRoutes = filterRoutes('webhook')
+ * ```
+ */
+declare function filterRoutes<K extends string>(field: K): (RouteMeta & Record<K, unknown>)[];
+//#endregion
+export { getAllRoutes as a, setGlobalRegistry as c, filterRoutes as i, RouteRegistry as n, getRoute as o, createRouteRegistry as r, getRouteRegistry as s, RouteMeta as t };
+//# sourceMappingURL=route-registry-ykzRmaHB.d.mts.map

package/dist/router/index.d.mts

@@ -0,0 +1,5 @@
+import "../schema-CVuttFSw.mjs";
+import "../index-DXJd7-2Z.mjs";
+import { flattenNestedRoutes, normalizePath } from "../router.mjs";
+import { RadixRouter } from "./radix-tree.mjs";
+export { RadixRouter, flattenNestedRoutes, normalizePath };

package/dist/router/index.mjs

@@ -0,0 +1,10 @@
+import { n as init_router, r as normalizePath, t as flattenNestedRoutes } from "../router-BOeVQrjz.mjs";
+import { n as init_radix_tree, t as RadixRouter } from "../radix-tree-BWmhTLhT.mjs";
+
+//#region src/router/index.ts
+init_radix_tree();
+init_router();
+
+//#endregion
+export { RadixRouter, flattenNestedRoutes, normalizePath };
+//# sourceMappingURL=index.mjs.map

package/dist/router/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/router/index.ts"],"sourcesContent":["/**\n * 路由模块导出\n */\n\n// Radix Tree 路由器\nexport { RadixRouter } from \"./radix-tree\";\n\n// 路由工具函数\nexport { flattenNestedRoutes, normalizePath } from \"../router\";\n"],"mappings":";;;;iBAK2C;aAGoB"}

package/dist/router/radix-tree.d.mts

@@ -0,0 +1,60 @@
+import { a as Method, o as Middleware, r as Handler } from "../types-Cb7_2VSt.mjs";
+import "../schema-CVuttFSw.mjs";
+import "../index-DXJd7-2Z.mjs";
+
+//#region src/router/radix-tree.d.ts
+
+/** 预编译的处理器类型 */
+type CompiledHandler = (req: Request) => Promise<Response>;
+/** 路由匹配结果 */
+interface MatchResult {
+  handler: Handler;
+  middleware: Middleware[];
+  params: Record<string, string>;
+  /** 预编译后的完整处理链 */
+  compiled?: CompiledHandler;
+}
+/**
+ * Radix Tree 路由器
+ *
+ * @example
+ * ```typescript
+ * const router = new RadixRouter();
+ * router.register("GET", "/users/:id", handler);
+ * const result = router.match("GET", "/users/123");
+ * // result.params = { id: "123" }
+ * ```
+ */
+declare class RadixRouter {
+  private root;
+  constructor();
+  private createNode;
+  /** 分割路径 */
+  private splitPath;
+  /** 编译器函数 - 用于预编译中间件链 */
+  private compiler?;
+  /** 设置中间件编译器 */
+  setCompiler(compiler: (middleware: Middleware[], handler: Handler) => CompiledHandler): void;
+  /** 注册路由 */
+  register(method: Method, pattern: string, handler: Handler, middleware?: Middleware[]): void;
+  /** 预编译所有路由（在添加全局中间件后调用） */
+  precompileAll(globalMiddleware: Middleware[]): void;
+  private precompileNode;
+  /** 匹配路由 */
+  match(method: Method, path: string): MatchResult | null;
+  /** 递归匹配节点 (优先级: 静态 > 动态参数 > 通配符) */
+  private matchNode;
+  /** 获取路径允许的 HTTP 方法 */
+  getAllowedMethods(path: string): Method[];
+  /** 查找节点（不提取参数） */
+  private findNode;
+  /** 获取所有已注册的路由 */
+  getRoutes(): Array<{
+    method: Method;
+    path: string;
+  }>;
+  private collectRoutes;
+}
+//#endregion
+export { MatchResult, RadixRouter };
+//# sourceMappingURL=radix-tree.d.mts.map

package/dist/router/radix-tree.mjs

@@ -0,0 +1,4 @@
+import { n as init_radix_tree, t as RadixRouter } from "../radix-tree-BWmhTLhT.mjs";
+
+init_radix_tree();
+export { RadixRouter };

package/dist/router-BOeVQrjz.mjs

@@ -0,0 +1,71 @@
+import { t as __esmMin } from "./chunk-67U6L5Jh.mjs";
+
+//#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", ... },
+* // ]
+* ```
+*/
+function flattenNestedRoutes(routes) {
+	const flattened = [];
+	function processRoute(route, parentPath = "", parentMiddleware = [], parentName) {
+		const currentPath = normalizePath(parentPath + route.path);
+		const currentMiddleware = [...parentMiddleware, ...route.middleware || []];
+		const currentName = route.name || parentName;
+		if ("method" in route && "handler" in route) {
+			const leafRoute = route;
+			flattened.push({
+				...leafRoute,
+				fullPath: currentPath,
+				middlewareChain: currentMiddleware,
+				parentName
+			});
+		} else if ("children" in route && route.children) for (const child of route.children) processRoute(child, currentPath, currentMiddleware, currentName);
+	}
+	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;
+}
+var init_router = __esmMin((() => {}));
+
+//#endregion
+export { init_router as n, normalizePath as r, flattenNestedRoutes as t };
+//# sourceMappingURL=router-BOeVQrjz.mjs.map