vafast 0.4.24 → 0.5.2

package/dist/response-CQ1IgWei.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-CQ1IgWei.mjs","names":["err","stream"],"sources":["../src/middleware.ts","../src/utils/response.ts"],"sourcesContent":["// src/middleware.ts\n\nimport { json, mapResponse } from \"./utils/response\";\n\nimport type { Handler, Middleware } from \"./types\";\n/** 中间件类型：使用 next() 传递给下一个处理 */\n\n/** Vafast 自定义错误类型 */\nexport class VafastError extends Error {\n  status: number;\n  type: string;\n  expose: boolean;\n\n  constructor(\n    message: string,\n    options: {\n      status?: number;\n      type?: string;\n      expose?: boolean;\n      cause?: unknown;\n    } = {},\n  ) {\n    super(message);\n    this.name = \"VafastError\";\n    this.status = options.status ?? 500;\n    this.type = options.type ?? \"internal_error\";\n    this.expose = options.expose ?? false;\n    if (options.cause) (this as any).cause = options.cause;\n  }\n}\n\n/**\n * 组合类型: 自动注入错误处理器进行中间件组合\n */\nexport function composeMiddleware(\n  middleware: Middleware[],\n  finalHandler: Handler,\n): (req: Request) => Promise<Response> {\n  const all = [errorHandler, ...middleware];\n\n  return function composedHandler(req: Request): Promise<Response> {\n    let i = -1;\n\n    const dispatch = (index: number): Promise<Response> => {\n      if (index <= i)\n        return Promise.reject(new Error(\"next() called multiple times\"));\n      i = index;\n\n      // 中间件阶段\n      if (index < all.length) {\n        const mw = all[index];\n        return Promise.resolve(mw(req, () => dispatch(index + 1)));\n      }\n\n      // 最终 handler - 使用 mapResponse 转换返回值\n      return Promise.resolve(finalHandler(req)).then(mapResponse);\n    };\n\n    return dispatch(0);\n  };\n}\n\n/** 默认包含的全局错误处理器 */\nconst errorHandler: Middleware = async (req, next) => {\n  try {\n    return await next();\n  } catch (err) {\n    console.error(\"未处理的错误:\", err);\n\n    if (err instanceof VafastError) {\n      return json(\n        {\n          error: err.type,\n          message: err.expose ? err.message : \"发生了一个错误\",\n        },\n        err.status,\n      );\n    }\n\n    return json({ error: \"internal_error\", message: \"出现了一些问题\" }, 500);\n  }\n};\n","// src/response.ts\n\nimport { VafastError } from \"../middleware\";\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\n// ==================== 错误响应工具 ====================\n\n/**\n * 创建错误响应\n *\n * @example\n * ```typescript\n * // 自定义错误\n * throw err('用户不存在', 404, 'NOT_FOUND')\n *\n * // 预定义错误\n * throw err.notFound('用户不存在')\n * throw err.badRequest('参数错误')\n * throw err.unauthorized('请先登录')\n * ```\n */\nexport function err(message: string, status = 500, type = \"ERROR\") {\n  return new VafastError(message, { status, type, expose: true });\n}\n\n/** 400 Bad Request */\nerr.badRequest = (message = \"请求参数错误\") =>\n  err(message, 400, \"BAD_REQUEST\");\n\n/** 401 Unauthorized */\nerr.unauthorized = (message = \"未授权\") =>\n  err(message, 401, \"UNAUTHORIZED\");\n\n/** 403 Forbidden */\nerr.forbidden = (message = \"禁止访问\") =>\n  err(message, 403, \"FORBIDDEN\");\n\n/** 404 Not Found */\nerr.notFound = (message = \"资源不存在\") =>\n  err(message, 404, \"NOT_FOUND\");\n\n/** 409 Conflict */\nerr.conflict = (message = \"资源冲突\") =>\n  err(message, 409, \"CONFLICT\");\n\n/** 422 Unprocessable Entity */\nerr.unprocessable = (message = \"无法处理的实体\") =>\n  err(message, 422, \"UNPROCESSABLE_ENTITY\");\n\n/** 429 Too Many Requests */\nerr.tooMany = (message = \"请求过于频繁\") =>\n  err(message, 429, \"TOO_MANY_REQUESTS\");\n\n/** 500 Internal Server Error */\nerr.internal = (message = \"服务器内部错误\") =>\n  err(message, 500, \"INTERNAL_ERROR\");\n"],"mappings":"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"}

package/dist/{response-BnkYA4pj.mjs → response-DNdvtn-K.mjs}

@@ -69,4 +69,4 @@ async function writeResponseSimple(response, outgoing) {
 
 //#endregion
 export { writeResponseSimple as n, writeResponse as t };
-//# sourceMappingURL=response-BnkYA4pj.mjs.map
+//# sourceMappingURL=response-DNdvtn-K.mjs.map

package/dist/{response-BnkYA4pj.mjs.map → response-DNdvtn-K.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"response-BnkYA4pj.mjs","names":[],"sources":["../src/node-server/response.ts"],"sourcesContent":["/**\n * 优化的 Response 写入\n * 流式写入，避免内存拷贝\n */\n\nimport type { ServerResponse } from \"node:http\";\n\n/**\n * 构建 Node.js 响应头\n * 处理 set-cookie 多值情况\n */\nfunction buildOutgoingHeaders(\n  headers: Headers,\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n  const cookies: string[] = [];\n\n  headers.forEach((value, key) => {\n    if (key === \"set-cookie\") {\n      cookies.push(value);\n    } else {\n      result[key] = value;\n    }\n  });\n\n  if (cookies.length > 0) {\n    result[\"set-cookie\"] = cookies;\n  }\n\n  return result;\n}\n\n/**\n * 流式写入 Response body 到 ServerResponse\n * 支持背压处理，避免内存溢出\n */\nasync function writeBodyStream(\n  body: ReadableStream<Uint8Array>,\n  outgoing: ServerResponse,\n): Promise<void> {\n  const reader = body.getReader();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\n      if (done) {\n        break;\n      }\n\n      // 背压处理：如果写入返回 false，等待 drain 事件\n      const canContinue = outgoing.write(value);\n      if (!canContinue) {\n        await new Promise<void>((resolve) => {\n          outgoing.once(\"drain\", resolve);\n        });\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * 将 Web Response 写入 Node.js ServerResponse\n * 流式写入，零拷贝\n */\nexport async function writeResponse(\n  response: Response,\n  outgoing: ServerResponse,\n): Promise<void> {\n  // 设置状态码\n  outgoing.statusCode = response.status;\n\n  // 设置响应头\n  const headers = buildOutgoingHeaders(response.headers);\n  for (const [key, value] of Object.entries(headers)) {\n    outgoing.setHeader(key, value);\n  }\n\n  const body = response.body;\n\n  // 无 body 的情况\n  if (!body) {\n    outgoing.end();\n    return;\n  }\n\n  // 流式写入 body\n  try {\n    await writeBodyStream(body, outgoing);\n    outgoing.end();\n  } catch (error) {\n    // 处理客户端提前断开等情况\n    if (!outgoing.destroyed) {\n      outgoing.destroy(\n        error instanceof Error ? error : new Error(String(error)),\n      );\n    }\n  }\n}\n\n/**\n * 简化版写入（用于已知小体积响应）\n * 直接 arrayBuffer 转换，适用于确定的小响应\n */\nexport async function writeResponseSimple(\n  response: Response,\n  outgoing: ServerResponse,\n): Promise<void> {\n  outgoing.statusCode = response.status;\n\n  const headers = buildOutgoingHeaders(response.headers);\n  for (const [key, value] of Object.entries(headers)) {\n    outgoing.setHeader(key, value);\n  }\n\n  const body = response.body;\n  if (!body) {\n    outgoing.end();\n    return;\n  }\n\n  // 对于小响应，直接读取全部内容\n  const buffer = await response.arrayBuffer();\n  outgoing.end(Buffer.from(buffer));\n}\n"],"mappings":";;;;;AAWA,SAAS,qBACP,SACmC;CACnC,MAAM,SAA4C,EAAE;CACpD,MAAM,UAAoB,EAAE;AAE5B,SAAQ,SAAS,OAAO,QAAQ;AAC9B,MAAI,QAAQ,aACV,SAAQ,KAAK,MAAM;MAEnB,QAAO,OAAO;GAEhB;AAEF,KAAI,QAAQ,SAAS,EACnB,QAAO,gBAAgB;AAGzB,QAAO;;;;;;AAOT,eAAe,gBACb,MACA,UACe;CACf,MAAM,SAAS,KAAK,WAAW;AAE/B,KAAI;AACF,SAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAE3C,OAAI,KACF;AAKF,OAAI,CADgB,SAAS,MAAM,MAAM,CAEvC,OAAM,IAAI,SAAe,YAAY;AACnC,aAAS,KAAK,SAAS,QAAQ;KAC/B;;WAGE;AACR,SAAO,aAAa;;;;;;;AAQxB,eAAsB,cACpB,UACA,UACe;AAEf,UAAS,aAAa,SAAS;CAG/B,MAAM,UAAU,qBAAqB,SAAS,QAAQ;AACtD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,UAAS,UAAU,KAAK,MAAM;CAGhC,MAAM,OAAO,SAAS;AAGtB,KAAI,CAAC,MAAM;AACT,WAAS,KAAK;AACd;;AAIF,KAAI;AACF,QAAM,gBAAgB,MAAM,SAAS;AACrC,WAAS,KAAK;UACP,OAAO;AAEd,MAAI,CAAC,SAAS,UACZ,UAAS,QACP,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC,CAC1D;;;;;;;AASP,eAAsB,oBACpB,UACA,UACe;AACf,UAAS,aAAa,SAAS;CAE/B,MAAM,UAAU,qBAAqB,SAAS,QAAQ;AACtD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,UAAS,UAAU,KAAK,MAAM;AAIhC,KAAI,CADS,SAAS,MACX;AACT,WAAS,KAAK;AACd;;CAIF,MAAM,SAAS,MAAM,SAAS,aAAa;AAC3C,UAAS,IAAI,OAAO,KAAK,OAAO,CAAC"}
+{"version":3,"file":"response-DNdvtn-K.mjs","names":[],"sources":["../src/node-server/response.ts"],"sourcesContent":["/**\n * 优化的 Response 写入\n * 流式写入，避免内存拷贝\n */\n\nimport type { ServerResponse } from \"node:http\";\n\n/**\n * 构建 Node.js 响应头\n * 处理 set-cookie 多值情况\n */\nfunction buildOutgoingHeaders(\n  headers: Headers,\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n  const cookies: string[] = [];\n\n  headers.forEach((value, key) => {\n    if (key === \"set-cookie\") {\n      cookies.push(value);\n    } else {\n      result[key] = value;\n    }\n  });\n\n  if (cookies.length > 0) {\n    result[\"set-cookie\"] = cookies;\n  }\n\n  return result;\n}\n\n/**\n * 流式写入 Response body 到 ServerResponse\n * 支持背压处理，避免内存溢出\n */\nasync function writeBodyStream(\n  body: ReadableStream<Uint8Array>,\n  outgoing: ServerResponse,\n): Promise<void> {\n  const reader = body.getReader();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\n      if (done) {\n        break;\n      }\n\n      // 背压处理：如果写入返回 false，等待 drain 事件\n      const canContinue = outgoing.write(value);\n      if (!canContinue) {\n        await new Promise<void>((resolve) => {\n          outgoing.once(\"drain\", resolve);\n        });\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * 将 Web Response 写入 Node.js ServerResponse\n * 流式写入，零拷贝\n */\nexport async function writeResponse(\n  response: Response,\n  outgoing: ServerResponse,\n): Promise<void> {\n  // 设置状态码\n  outgoing.statusCode = response.status;\n\n  // 设置响应头\n  const headers = buildOutgoingHeaders(response.headers);\n  for (const [key, value] of Object.entries(headers)) {\n    outgoing.setHeader(key, value);\n  }\n\n  const body = response.body;\n\n  // 无 body 的情况\n  if (!body) {\n    outgoing.end();\n    return;\n  }\n\n  // 流式写入 body\n  try {\n    await writeBodyStream(body, outgoing);\n    outgoing.end();\n  } catch (error) {\n    // 处理客户端提前断开等情况\n    if (!outgoing.destroyed) {\n      outgoing.destroy(\n        error instanceof Error ? error : new Error(String(error)),\n      );\n    }\n  }\n}\n\n/**\n * 简化版写入（用于已知小体积响应）\n * 直接 arrayBuffer 转换，适用于确定的小响应\n */\nexport async function writeResponseSimple(\n  response: Response,\n  outgoing: ServerResponse,\n): Promise<void> {\n  outgoing.statusCode = response.status;\n\n  const headers = buildOutgoingHeaders(response.headers);\n  for (const [key, value] of Object.entries(headers)) {\n    outgoing.setHeader(key, value);\n  }\n\n  const body = response.body;\n  if (!body) {\n    outgoing.end();\n    return;\n  }\n\n  // 对于小响应，直接读取全部内容\n  const buffer = await response.arrayBuffer();\n  outgoing.end(Buffer.from(buffer));\n}\n"],"mappings":";;;;;AAWA,SAAS,qBACP,SACmC;CACnC,MAAM,SAA4C,EAAE;CACpD,MAAM,UAAoB,EAAE;AAE5B,SAAQ,SAAS,OAAO,QAAQ;AAC9B,MAAI,QAAQ,aACV,SAAQ,KAAK,MAAM;MAEnB,QAAO,OAAO;GAEhB;AAEF,KAAI,QAAQ,SAAS,EACnB,QAAO,gBAAgB;AAGzB,QAAO;;;;;;AAOT,eAAe,gBACb,MACA,UACe;CACf,MAAM,SAAS,KAAK,WAAW;AAE/B,KAAI;AACF,SAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAE3C,OAAI,KACF;AAKF,OAAI,CADgB,SAAS,MAAM,MAAM,CAEvC,OAAM,IAAI,SAAe,YAAY;AACnC,aAAS,KAAK,SAAS,QAAQ;KAC/B;;WAGE;AACR,SAAO,aAAa;;;;;;;AAQxB,eAAsB,cACpB,UACA,UACe;AAEf,UAAS,aAAa,SAAS;CAG/B,MAAM,UAAU,qBAAqB,SAAS,QAAQ;AACtD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,UAAS,UAAU,KAAK,MAAM;CAGhC,MAAM,OAAO,SAAS;AAGtB,KAAI,CAAC,MAAM;AACT,WAAS,KAAK;AACd;;AAIF,KAAI;AACF,QAAM,gBAAgB,MAAM,SAAS;AACrC,WAAS,KAAK;UACP,OAAO;AAEd,MAAI,CAAC,SAAS,UACZ,UAAS,QACP,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC,CAC1D;;;;;;;AASP,eAAsB,oBACpB,UACA,UACe;AACf,UAAS,aAAa,SAAS;CAE/B,MAAM,UAAU,qBAAqB,SAAS,QAAQ;AACtD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,UAAS,UAAU,KAAK,MAAM;AAIhC,KAAI,CADS,SAAS,MACX;AACT,WAAS,KAAK;AACd;;CAIF,MAAM,SAAS,MAAM,SAAS,aAAa;AAC3C,UAAS,IAAI,OAAO,KAAK,OAAO,CAAC"}

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

@@ -1,4 +1,5 @@
-import { a as Method, n as FlattenedRoute } from "./types-D1PUFkda.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
 
@@ -8,9 +9,10 @@ import { a as Method, n as FlattenedRoute } from "./types-D1PUFkda.mjs";
 interface RouteMeta {
   method: Method;
   path: string;
-  fullPath: string;
   name?: string;
   description?: string;
+  /** Schema 定义（用于契约生成） */
+  schema?: RouteSchema;
   /** 扩展字段 */
   [key: string]: unknown;
 }
@@ -22,11 +24,11 @@ interface RouteMeta {
 declare class RouteRegistry<T extends Record<string, unknown> = Record<string, unknown>> {
   /** 所有路由元信息 */
   private routes;
-  /** 路由映射表：METHOD:fullPath -> RouteMeta */
+  /** 路由映射表：METHOD:path -> RouteMeta */
   private routeMap;
   /** 分类映射表：category -> RouteMeta[] */
   private categoryMap;
-  constructor(routes: FlattenedRoute[]);
+  constructor(routes: ProcessedRoute[]);
   /**
    * 构建注册表
    */
@@ -109,7 +111,7 @@ declare class RouteRegistry<T extends Record<string, unknown> = Record<string, u
  * }
  * ```
  */
-declare function createRouteRegistry<T extends Record<string, unknown> = Record<string, unknown>>(routes: FlattenedRoute[]): RouteRegistry<T>;
+declare function createRouteRegistry<T extends Record<string, unknown> = Record<string, unknown>>(routes: ProcessedRoute[]): RouteRegistry<T>;
 /**
  * 设置全局 registry（框架内部使用）
  * @internal
@@ -171,6 +173,18 @@ declare function getAllRoutes(): RouteMeta[];
  * ```
  */
 declare function filterRoutes<K extends string>(field: K): (RouteMeta & Record<K, unknown>)[];
+/**
+ * 按 HTTP 方法获取路由
+ *
+ * @example
+ * ```typescript
+ * import { getRoutesByMethod } from 'vafast'
+ *
+ * const getRoutes = getRoutesByMethod('GET')
+ * const postRoutes = getRoutesByMethod('POST')
+ * ```
+ */
+declare function getRoutesByMethod(method: string): RouteMeta[];
 //#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-CmABJA2V.d.mts.map
+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-BQKQ0qZp.d.mts.map

package/dist/{route-registry-emTmRrWQ.mjs → route-registry-BzExlM2t.mjs}

@@ -7,7 +7,7 @@
 var RouteRegistry = class {
 	/** 所有路由元信息 */
 	routes = [];
-	/** 路由映射表：METHOD:fullPath -> RouteMeta */
+	/** 路由映射表：METHOD:path -> RouteMeta */
 	routeMap = /* @__PURE__ */ new Map();
 	/** 分类映射表：category -> RouteMeta[] */
 	categoryMap = /* @__PURE__ */ new Map();
@@ -22,23 +22,23 @@ var RouteRegistry = class {
 			const meta = {
 				method: route.method,
 				path: route.path,
-				fullPath: route.fullPath,
 				name: route.name,
-				description: route.description
+				description: route.description,
+				schema: route.schema
 			};
 			for (const key of Object.keys(route)) if (![
 				"method",
 				"path",
-				"fullPath",
 				"name",
 				"description",
 				"handler",
 				"middleware",
-				"middlewareChain"
+				"schema",
+				"docs"
 			].includes(key)) meta[key] = route[key];
 			this.routes.push(meta);
-			this.routeMap.set(`${route.method}:${route.fullPath}`, meta);
-			const category = this.extractCategory(route.fullPath);
+			this.routeMap.set(`${route.method}:${route.path}`, meta);
+			const category = this.extractCategory(route.path);
 			if (!this.categoryMap.has(category)) this.categoryMap.set(category, []);
 			this.categoryMap.get(category).push(meta);
 		}
@@ -220,7 +220,21 @@ function getAllRoutes() {
 function filterRoutes(field) {
 	return getRouteRegistry().filter(field);
 }
+/**
+* 按 HTTP 方法获取路由
+*
+* @example
+* ```typescript
+* import { getRoutesByMethod } from 'vafast'
+*
+* const getRoutes = getRoutesByMethod('GET')
+* const postRoutes = getRoutesByMethod('POST')
+* ```
+*/
+function getRoutesByMethod(method) {
+	return getRouteRegistry().filterBy((r) => r.method === method);
+}
 
 //#endregion
-export { getRoute as a, getAllRoutes as i, createRouteRegistry as n, getRouteRegistry as o, filterRoutes as r, setGlobalRegistry as s, RouteRegistry as t };
-//# sourceMappingURL=route-registry-emTmRrWQ.mjs.map
+export { getRoute as a, setGlobalRegistry as c, getAllRoutes as i, createRouteRegistry as n, getRouteRegistry as o, filterRoutes as r, getRoutesByMethod as s, RouteRegistry as t };
+//# sourceMappingURL=route-registry-BzExlM2t.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route-registry-BzExlM2t.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 { Method } from '../types'\nimport type { ProcessedRoute, RouteSchema } from '../defineRoute'\n\n/**\n * 路由元信息（不含 handler 和 middleware）\n */\nexport interface RouteMeta {\n  method: Method\n  path: string\n  name?: string\n  description?: string\n  /** Schema 定义（用于契约生成） */\n  schema?: RouteSchema\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:path -> RouteMeta */\n  private routeMap = new Map<string, RouteMeta>()\n\n  /** 分类映射表：category -> RouteMeta[] */\n  private categoryMap = new Map<string, RouteMeta[]>()\n\n  constructor(routes: ProcessedRoute[]) {\n    this.buildRegistry(routes)\n  }\n\n  /**\n   * 构建注册表\n   */\n  private buildRegistry(routes: ProcessedRoute[]): void {\n    for (const route of routes) {\n      // 提取元信息（排除 handler 和 middleware）\n      const meta: RouteMeta = {\n        method: route.method as Method,\n        path: route.path,\n        name: route.name,\n        description: route.description,\n        schema: route.schema,  // 保留 schema 用于契约生成\n      }\n\n      // 复制扩展字段\n      for (const key of Object.keys(route)) {\n        if (!['method', 'path', 'name', 'description', 'handler', 'middleware', 'schema', 'docs'].includes(key)) {\n          meta[key] = route[key]\n        }\n      }\n\n      this.routes.push(meta)\n      this.routeMap.set(`${route.method}:${route.path}`, meta)\n\n      // 按分类索引\n      const category = this.extractCategory(route.path)\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: ProcessedRoute[]\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/**\n * 按 HTTP 方法获取路由\n *\n * @example\n * ```typescript\n * import { getRoutesByMethod } from 'vafast'\n *\n * const getRoutes = getRoutesByMethod('GET')\n * const postRoutes = getRoutesByMethod('POST')\n * ```\n */\nexport function getRoutesByMethod(method: string): RouteMeta[] {\n  return getRouteRegistry().filterBy(r => r.method === method)\n}\n\n"],"mappings":";;;;;;AA4CA,IAAa,gBAAb,MAAwF;;CAEtF,AAAQ,SAAsB,EAAE;;CAGhC,AAAQ,2BAAW,IAAI,KAAwB;;CAG/C,AAAQ,8BAAc,IAAI,KAA0B;CAEpD,YAAY,QAA0B;AACpC,OAAK,cAAc,OAAO;;;;;CAM5B,AAAQ,cAAc,QAAgC;AACpD,OAAK,MAAM,SAAS,QAAQ;GAE1B,MAAM,OAAkB;IACtB,QAAQ,MAAM;IACd,MAAM,MAAM;IACZ,MAAM,MAAM;IACZ,aAAa,MAAM;IACnB,QAAQ,MAAM;IACf;AAGD,QAAK,MAAM,OAAO,OAAO,KAAK,MAAM,CAClC,KAAI,CAAC;IAAC;IAAU;IAAQ;IAAQ;IAAe;IAAW;IAAc;IAAU;IAAO,CAAC,SAAS,IAAI,CACrG,MAAK,OAAO,MAAM;AAItB,QAAK,OAAO,KAAK,KAAK;AACtB,QAAK,SAAS,IAAI,GAAG,MAAM,OAAO,GAAG,MAAM,QAAQ,KAAK;GAGxD,MAAM,WAAW,KAAK,gBAAgB,MAAM,KAAK;AACjD,OAAI,CAAC,KAAK,YAAY,IAAI,SAAS,CACjC,MAAK,YAAY,IAAI,UAAU,EAAE,CAAC;AAEpC,QAAK,YAAY,IAAI,SAAS,CAAE,KAAK,KAAK;;;;;;CAO9C,AAAQ,gBAAgB,MAAsB;AAE5C,SADiB,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAChC,MAAM;;;;;CAUxB,SAAsB;AACpB,SAAO,CAAC,GAAG,KAAK,OAAO;;;;;CAMzB,IAAI,QAAgB,MAA2C;AAC7D,SAAO,KAAK,SAAS,IAAI,GAAG,OAAO,GAAG,OAAO;;;;;CAM/C,IAAI,QAAgB,MAAuB;AACzC,SAAO,KAAK,SAAS,IAAI,GAAG,OAAO,GAAG,OAAO;;;;;CAM/C,cAAc,UAA+B;AAC3C,SAAO,KAAK,YAAY,IAAI,SAAS,IAAI,EAAE;;;;;CAM7C,gBAA0B;AACxB,SAAO,MAAM,KAAK,KAAK,YAAY,MAAM,CAAC,CAAC,MAAM;;;;;;;;;;;CAYnD,OAAyB,OAA8C;AACrE,SAAO,KAAK,OAAO,QAAQ,MAAM,SAAS,KAAK,EAAE,WAAW,OAAU;;;;;;;;;;;CAYxE,SAAS,WAAuD;AAC9D,SAAO,KAAK,OAAO,OAAO,UAAU;;;;;CAMtC,IAAI,OAAe;AACjB,SAAO,KAAK,OAAO;;;;;CAMrB,QAAQ,UAA2D;AACjE,OAAK,OAAO,QAAQ,SAAS;;;;;CAM/B,IAAO,UAAuD;AAC5D,SAAO,KAAK,OAAO,IAAI,SAAS;;;;;;;;;;;;;;;;;;;;;;;;AAyBpC,SAAgB,oBACd,QACkB;AAClB,QAAO,IAAI,cAAiB,OAAO;;;AAQrC,IAAI,iBAAuC;;;;;AAM3C,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;;;;;;;;;;;;;AAczC,SAAgB,kBAAkB,QAA6B;AAC7D,QAAO,kBAAkB,CAAC,UAAS,MAAK,EAAE,WAAW,OAAO"}

package/dist/router/index.d.mts

@@ -1,5 +1,3 @@
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
-import { flattenNestedRoutes, normalizePath } from "../router.mjs";
+import { normalizePath } from "../router.mjs";
 import { RadixRouter } from "./radix-tree.mjs";
-export { RadixRouter, flattenNestedRoutes, normalizePath };
+export { RadixRouter, normalizePath };

package/dist/router/index.mjs

@@ -1,4 +1,4 @@
-import { n as normalizePath, t as flattenNestedRoutes } from "../router-CgYfGB4J.mjs";
-import { t as RadixRouter } from "../radix-tree-qqSjnVXF.mjs";
+import { t as RadixRouter } from "../radix-tree-CccjvyTP.mjs";
+import { normalizePath } from "../router.mjs";
 
-export { RadixRouter, flattenNestedRoutes, normalizePath };
+export { RadixRouter, normalizePath };

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

@@ -1,6 +1,4 @@
-import { a as Method, o as Middleware, r as Handler } from "../types-D1PUFkda.mjs";
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
+import { n as Method, r as Middleware, t as Handler } from "../types-B8Z3cMtZ.mjs";
 
 //#region src/router/radix-tree.d.ts
 

package/dist/router/radix-tree.mjs

@@ -1,3 +1,3 @@
-import { t as RadixRouter } from "../radix-tree-qqSjnVXF.mjs";
+import { t as RadixRouter } from "../radix-tree-CccjvyTP.mjs";
 
 export { RadixRouter };

package/dist/router.d.mts

@@ -1,10 +1,7 @@
-import { l as Route, n as FlattenedRoute, s as NestedRoute } from "./types-D1PUFkda.mjs";
-import "./schema-B6DFN5c2.mjs";
-import "./index-CREkvfw9.mjs";
-
 //#region src/router.d.ts
-
-declare function flattenNestedRoutes(routes: (Route | NestedRoute)[]): FlattenedRoute[];
+/**
+ * 路由工具函数
+ */
 /**
  * 标准化路径
  *
@@ -20,5 +17,5 @@ declare function flattenNestedRoutes(routes: (Route | NestedRoute)[]): Flattened
  */
 declare function normalizePath(path: string): string;
 //#endregion
-export { flattenNestedRoutes, normalizePath };
+export { normalizePath };
 //# sourceMappingURL=router.d.mts.map

package/dist/router.mjs

@@ -1,3 +1,28 @@
-import { n as normalizePath, t as flattenNestedRoutes } from "./router-CgYfGB4J.mjs";
+//#region src/router.ts
+/**
+* 路由工具函数
+*/
+/**
+* 标准化路径
+*
+* - 解码 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;
+}
 
-export { flattenNestedRoutes, normalizePath };
+//#endregion
+export { normalizePath };
+//# sourceMappingURL=router.mjs.map

package/dist/router.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.mjs","names":[],"sources":["../src/router.ts"],"sourcesContent":["/**\n * 路由工具函数\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":";;;;;;;;;;;;;;;;;AAiBA,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/{serve-48LEIkPa.mjs → serve-Df3HzwZM.mjs}

@@ -1,5 +1,5 @@
-import { t as createProxyRequest } from "./request-B-Nct5f7.mjs";
-import { t as writeResponse } from "./response-BnkYA4pj.mjs";
+import { t as createProxyRequest } from "./request-CppAFyqX.mjs";
+import { t as writeResponse } from "./response-DNdvtn-K.mjs";
 import { createServer } from "node:http";
 
 //#region src/node-server/serve.ts
@@ -104,4 +104,4 @@ function createAdaptorServer(fetch, onError) {
 
 //#endregion
 export { serve as n, createAdaptorServer as t };
-//# sourceMappingURL=serve-48LEIkPa.mjs.map
+//# sourceMappingURL=serve-Df3HzwZM.mjs.map

package/dist/{serve-48LEIkPa.mjs.map → serve-Df3HzwZM.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"serve-48LEIkPa.mjs","names":[],"sources":["../src/node-server/serve.ts"],"sourcesContent":["/**\n * Node.js 服务器适配器\n * 提供类似 Bun.serve 的 API\n */\n\nimport {\n  createServer,\n  type Server as HttpServer,\n  type IncomingMessage,\n  type ServerResponse,\n} from \"node:http\";\nimport { createProxyRequest } from \"./request\";\nimport { writeResponse } from \"./response\";\n\n/** fetch 函数类型 */\nexport type FetchHandler = (request: Request) => Response | Promise<Response>;\n\n/** 优雅关闭配置 */\nexport interface GracefulShutdownOptions {\n  /** 关闭超时时间（毫秒），默认 30000 */\n  timeout?: number;\n  /** 关闭前回调 */\n  onShutdown?: () => void | Promise<void>;\n  /** 关闭完成回调 */\n  onShutdownComplete?: () => void;\n  /** 监听的信号，默认 ['SIGINT', 'SIGTERM'] */\n  signals?: NodeJS.Signals[];\n}\n\n/** serve 配置选项 */\nexport interface ServeOptions {\n  /** fetch 处理函数 */\n  fetch: FetchHandler;\n  /** 端口号，默认 3000 */\n  port?: number;\n  /** 主机名，默认 0.0.0.0 */\n  hostname?: string;\n  /** 错误处理函数 */\n  onError?: (error: Error) => Response | Promise<Response>;\n  /** 优雅关闭配置，设置为 true 使用默认配置 */\n  gracefulShutdown?: boolean | GracefulShutdownOptions;\n}\n\n/** serve 返回的服务器信息 */\nexport interface ServeResult {\n  /** Node.js HTTP Server 实例 */\n  server: HttpServer;\n  /** 服务器端口 */\n  port: number;\n  /** 服务器主机名 */\n  hostname: string;\n  /** 关闭服务器 */\n  stop: () => Promise<void>;\n  /** 优雅关闭（等待现有请求完成） */\n  shutdown: () => Promise<void>;\n}\n\n/**\n * 创建请求处理函数\n */\nfunction createRequestHandler(\n  fetch: FetchHandler,\n  defaultHost: string,\n  onError?: (error: Error) => Response | Promise<Response>,\n) {\n  return async (incoming: IncomingMessage, outgoing: ServerResponse) => {\n    try {\n      // 创建代理 Request（延迟创建真实 Request）\n      const request = createProxyRequest(incoming, defaultHost);\n\n      // 调用 fetch handler\n      const response = await fetch(request);\n\n      // 流式写入 Response\n      await writeResponse(response, outgoing);\n    } catch (error) {\n      // 错误处理\n      const err = error instanceof Error ? error : new Error(String(error));\n\n      if (onError) {\n        try {\n          const errorResponse = await onError(err);\n          await writeResponse(errorResponse, outgoing);\n          return;\n        } catch {\n          // onError 也失败了，返回 500\n        }\n      }\n\n      // 默认错误响应\n      if (!outgoing.headersSent) {\n        outgoing.statusCode = 500;\n        outgoing.setHeader(\"Content-Type\", \"text/plain\");\n        outgoing.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/**\n * 启动 HTTP 服务器\n *\n * @example\n * ```ts\n * import { serve } from \"@vafast/node-server\";\n * import { Server } from \"vafast\";\n *\n * const app = new Server([\n *   { method: \"GET\", path: \"/\", handler: () => \"Hello World\" },\n * ]);\n *\n * serve({ fetch: app.fetch, port: 3000 }, () => {\n *   console.log(\"Server running on http://localhost:3000\");\n * });\n * ```\n */\nexport function serve(\n  options: ServeOptions,\n  callback?: () => void,\n): ServeResult {\n  const { fetch, port = 3000, hostname = \"0.0.0.0\", onError, gracefulShutdown } = options;\n\n  const defaultHost = `${hostname === \"0.0.0.0\" ? \"localhost\" : hostname}:${port}`;\n  const handler = createRequestHandler(fetch, defaultHost, onError);\n\n  const server = createServer(handler);\n\n  // 追踪活跃连接\n  const connections = new Set<import(\"node:net\").Socket>();\n\n  server.on(\"connection\", (socket) => {\n    connections.add(socket);\n    socket.on(\"close\", () => connections.delete(socket));\n  });\n\n  // 优雅关闭函数\n  let isShuttingDown = false;\n\n  const shutdown = async (): Promise<void> => {\n    if (isShuttingDown) return;\n    isShuttingDown = true;\n\n    const shutdownOptions: GracefulShutdownOptions =\n      typeof gracefulShutdown === \"object\" ? gracefulShutdown : {};\n\n    const timeout = shutdownOptions.timeout ?? 30000;\n\n    // 执行关闭前回调\n    if (shutdownOptions.onShutdown) {\n      await shutdownOptions.onShutdown();\n    }\n\n    return new Promise<void>((resolve) => {\n      // 设置超时强制关闭\n      const forceCloseTimer = setTimeout(() => {\n        // 强制关闭所有连接\n        for (const socket of connections) {\n          socket.destroy();\n        }\n        connections.clear();\n        resolve();\n      }, timeout);\n\n      // 停止接受新连接\n      server.close(() => {\n        clearTimeout(forceCloseTimer);\n        shutdownOptions.onShutdownComplete?.();\n        resolve();\n      });\n\n      // 关闭空闲连接\n      for (const socket of connections) {\n        // 如果连接空闲，立即关闭\n        if (!socket.writableLength) {\n          socket.end();\n        }\n      }\n    });\n  };\n\n  // 注册信号处理\n  if (gracefulShutdown) {\n    const shutdownOptions: GracefulShutdownOptions =\n      typeof gracefulShutdown === \"object\" ? gracefulShutdown : {};\n\n    const signals = shutdownOptions.signals ?? [\"SIGINT\", \"SIGTERM\"];\n\n    for (const signal of signals) {\n      process.on(signal, () => {\n        shutdown().then(() => process.exit(0));\n      });\n    }\n  }\n\n  // 启动服务器\n  server.listen(port, hostname, callback);\n\n  return {\n    server,\n    port,\n    hostname,\n    stop: () =>\n      new Promise<void>((resolve, reject) => {\n        server.close((err) => {\n          if (err) reject(err);\n          else resolve();\n        });\n      }),\n    shutdown,\n  };\n}\n\n/**\n * 创建适配器服务器（不自动启动）\n * 用于需要更多控制的场景\n */\nexport function createAdaptorServer(\n  fetch: FetchHandler,\n  onError?: (error: Error) => Response | Promise<Response>,\n): HttpServer {\n  const handler = createRequestHandler(fetch, \"localhost\", onError);\n  return createServer(handler);\n}\n"],"mappings":";;;;;;;;;;;;AA4DA,SAAS,qBACP,OACA,aACA,SACA;AACA,QAAO,OAAO,UAA2B,aAA6B;AACpE,MAAI;AAQF,SAAM,cAHW,MAAM,MAHP,mBAAmB,UAAU,YAAY,CAGpB,EAGP,SAAS;WAChC,OAAO;GAEd,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AAErE,OAAI,QACF,KAAI;AAEF,UAAM,cADgB,MAAM,QAAQ,IAAI,EACL,SAAS;AAC5C;WACM;AAMV,OAAI,CAAC,SAAS,aAAa;AACzB,aAAS,aAAa;AACtB,aAAS,UAAU,gBAAgB,aAAa;AAChD,aAAS,IAAI,wBAAwB;;;;;;;;;;;;;;;;;;;;;;AAuB7C,SAAgB,MACd,SACA,UACa;CACb,MAAM,EAAE,OAAO,OAAO,KAAM,WAAW,WAAW,SAAS,qBAAqB;CAKhF,MAAM,SAAS,aAFC,qBAAqB,OADjB,GAAG,aAAa,YAAY,cAAc,SAAS,GAAG,QACjB,QAAQ,CAE7B;CAGpC,MAAM,8BAAc,IAAI,KAAgC;AAExD,QAAO,GAAG,eAAe,WAAW;AAClC,cAAY,IAAI,OAAO;AACvB,SAAO,GAAG,eAAe,YAAY,OAAO,OAAO,CAAC;GACpD;CAGF,IAAI,iBAAiB;CAErB,MAAM,WAAW,YAA2B;AAC1C,MAAI,eAAgB;AACpB,mBAAiB;EAEjB,MAAM,kBACJ,OAAO,qBAAqB,WAAW,mBAAmB,EAAE;EAE9D,MAAM,UAAU,gBAAgB,WAAW;AAG3C,MAAI,gBAAgB,WAClB,OAAM,gBAAgB,YAAY;AAGpC,SAAO,IAAI,SAAe,YAAY;GAEpC,MAAM,kBAAkB,iBAAiB;AAEvC,SAAK,MAAM,UAAU,YACnB,QAAO,SAAS;AAElB,gBAAY,OAAO;AACnB,aAAS;MACR,QAAQ;AAGX,UAAO,YAAY;AACjB,iBAAa,gBAAgB;AAC7B,oBAAgB,sBAAsB;AACtC,aAAS;KACT;AAGF,QAAK,MAAM,UAAU,YAEnB,KAAI,CAAC,OAAO,eACV,QAAO,KAAK;IAGhB;;AAIJ,KAAI,kBAAkB;EAIpB,MAAM,WAFJ,OAAO,qBAAqB,WAAW,mBAAmB,EAAE,EAE9B,WAAW,CAAC,UAAU,UAAU;AAEhE,OAAK,MAAM,UAAU,QACnB,SAAQ,GAAG,cAAc;AACvB,aAAU,CAAC,WAAW,QAAQ,KAAK,EAAE,CAAC;IACtC;;AAKN,QAAO,OAAO,MAAM,UAAU,SAAS;AAEvC,QAAO;EACL;EACA;EACA;EACA,YACE,IAAI,SAAe,SAAS,WAAW;AACrC,UAAO,OAAO,QAAQ;AACpB,QAAI,IAAK,QAAO,IAAI;QACf,UAAS;KACd;IACF;EACJ;EACD;;;;;;AAOH,SAAgB,oBACd,OACA,SACY;AAEZ,QAAO,aADS,qBAAqB,OAAO,aAAa,QAAQ,CACrC"}
+{"version":3,"file":"serve-Df3HzwZM.mjs","names":[],"sources":["../src/node-server/serve.ts"],"sourcesContent":["/**\n * Node.js 服务器适配器\n * 提供类似 Bun.serve 的 API\n */\n\nimport {\n  createServer,\n  type Server as HttpServer,\n  type IncomingMessage,\n  type ServerResponse,\n} from \"node:http\";\nimport { createProxyRequest } from \"./request\";\nimport { writeResponse } from \"./response\";\n\n/** fetch 函数类型 */\nexport type FetchHandler = (request: Request) => Response | Promise<Response>;\n\n/** 优雅关闭配置 */\nexport interface GracefulShutdownOptions {\n  /** 关闭超时时间（毫秒），默认 30000 */\n  timeout?: number;\n  /** 关闭前回调 */\n  onShutdown?: () => void | Promise<void>;\n  /** 关闭完成回调 */\n  onShutdownComplete?: () => void;\n  /** 监听的信号，默认 ['SIGINT', 'SIGTERM'] */\n  signals?: NodeJS.Signals[];\n}\n\n/** serve 配置选项 */\nexport interface ServeOptions {\n  /** fetch 处理函数 */\n  fetch: FetchHandler;\n  /** 端口号，默认 3000 */\n  port?: number;\n  /** 主机名，默认 0.0.0.0 */\n  hostname?: string;\n  /** 错误处理函数 */\n  onError?: (error: Error) => Response | Promise<Response>;\n  /** 优雅关闭配置，设置为 true 使用默认配置 */\n  gracefulShutdown?: boolean | GracefulShutdownOptions;\n}\n\n/** serve 返回的服务器信息 */\nexport interface ServeResult {\n  /** Node.js HTTP Server 实例 */\n  server: HttpServer;\n  /** 服务器端口 */\n  port: number;\n  /** 服务器主机名 */\n  hostname: string;\n  /** 关闭服务器 */\n  stop: () => Promise<void>;\n  /** 优雅关闭（等待现有请求完成） */\n  shutdown: () => Promise<void>;\n}\n\n/**\n * 创建请求处理函数\n */\nfunction createRequestHandler(\n  fetch: FetchHandler,\n  defaultHost: string,\n  onError?: (error: Error) => Response | Promise<Response>,\n) {\n  return async (incoming: IncomingMessage, outgoing: ServerResponse) => {\n    try {\n      // 创建代理 Request（延迟创建真实 Request）\n      const request = createProxyRequest(incoming, defaultHost);\n\n      // 调用 fetch handler\n      const response = await fetch(request);\n\n      // 流式写入 Response\n      await writeResponse(response, outgoing);\n    } catch (error) {\n      // 错误处理\n      const err = error instanceof Error ? error : new Error(String(error));\n\n      if (onError) {\n        try {\n          const errorResponse = await onError(err);\n          await writeResponse(errorResponse, outgoing);\n          return;\n        } catch {\n          // onError 也失败了，返回 500\n        }\n      }\n\n      // 默认错误响应\n      if (!outgoing.headersSent) {\n        outgoing.statusCode = 500;\n        outgoing.setHeader(\"Content-Type\", \"text/plain\");\n        outgoing.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/**\n * 启动 HTTP 服务器\n *\n * @example\n * ```ts\n * import { serve } from \"@vafast/node-server\";\n * import { Server } from \"vafast\";\n *\n * const app = new Server([\n *   { method: \"GET\", path: \"/\", handler: () => \"Hello World\" },\n * ]);\n *\n * serve({ fetch: app.fetch, port: 3000 }, () => {\n *   console.log(\"Server running on http://localhost:3000\");\n * });\n * ```\n */\nexport function serve(\n  options: ServeOptions,\n  callback?: () => void,\n): ServeResult {\n  const { fetch, port = 3000, hostname = \"0.0.0.0\", onError, gracefulShutdown } = options;\n\n  const defaultHost = `${hostname === \"0.0.0.0\" ? \"localhost\" : hostname}:${port}`;\n  const handler = createRequestHandler(fetch, defaultHost, onError);\n\n  const server = createServer(handler);\n\n  // 追踪活跃连接\n  const connections = new Set<import(\"node:net\").Socket>();\n\n  server.on(\"connection\", (socket) => {\n    connections.add(socket);\n    socket.on(\"close\", () => connections.delete(socket));\n  });\n\n  // 优雅关闭函数\n  let isShuttingDown = false;\n\n  const shutdown = async (): Promise<void> => {\n    if (isShuttingDown) return;\n    isShuttingDown = true;\n\n    const shutdownOptions: GracefulShutdownOptions =\n      typeof gracefulShutdown === \"object\" ? gracefulShutdown : {};\n\n    const timeout = shutdownOptions.timeout ?? 30000;\n\n    // 执行关闭前回调\n    if (shutdownOptions.onShutdown) {\n      await shutdownOptions.onShutdown();\n    }\n\n    return new Promise<void>((resolve) => {\n      // 设置超时强制关闭\n      const forceCloseTimer = setTimeout(() => {\n        // 强制关闭所有连接\n        for (const socket of connections) {\n          socket.destroy();\n        }\n        connections.clear();\n        resolve();\n      }, timeout);\n\n      // 停止接受新连接\n      server.close(() => {\n        clearTimeout(forceCloseTimer);\n        shutdownOptions.onShutdownComplete?.();\n        resolve();\n      });\n\n      // 关闭空闲连接\n      for (const socket of connections) {\n        // 如果连接空闲，立即关闭\n        if (!socket.writableLength) {\n          socket.end();\n        }\n      }\n    });\n  };\n\n  // 注册信号处理\n  if (gracefulShutdown) {\n    const shutdownOptions: GracefulShutdownOptions =\n      typeof gracefulShutdown === \"object\" ? gracefulShutdown : {};\n\n    const signals = shutdownOptions.signals ?? [\"SIGINT\", \"SIGTERM\"];\n\n    for (const signal of signals) {\n      process.on(signal, () => {\n        shutdown().then(() => process.exit(0));\n      });\n    }\n  }\n\n  // 启动服务器\n  server.listen(port, hostname, callback);\n\n  return {\n    server,\n    port,\n    hostname,\n    stop: () =>\n      new Promise<void>((resolve, reject) => {\n        server.close((err) => {\n          if (err) reject(err);\n          else resolve();\n        });\n      }),\n    shutdown,\n  };\n}\n\n/**\n * 创建适配器服务器（不自动启动）\n * 用于需要更多控制的场景\n */\nexport function createAdaptorServer(\n  fetch: FetchHandler,\n  onError?: (error: Error) => Response | Promise<Response>,\n): HttpServer {\n  const handler = createRequestHandler(fetch, \"localhost\", onError);\n  return createServer(handler);\n}\n"],"mappings":";;;;;;;;;;;;AA4DA,SAAS,qBACP,OACA,aACA,SACA;AACA,QAAO,OAAO,UAA2B,aAA6B;AACpE,MAAI;AAQF,SAAM,cAHW,MAAM,MAHP,mBAAmB,UAAU,YAAY,CAGpB,EAGP,SAAS;WAChC,OAAO;GAEd,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AAErE,OAAI,QACF,KAAI;AAEF,UAAM,cADgB,MAAM,QAAQ,IAAI,EACL,SAAS;AAC5C;WACM;AAMV,OAAI,CAAC,SAAS,aAAa;AACzB,aAAS,aAAa;AACtB,aAAS,UAAU,gBAAgB,aAAa;AAChD,aAAS,IAAI,wBAAwB;;;;;;;;;;;;;;;;;;;;;;AAuB7C,SAAgB,MACd,SACA,UACa;CACb,MAAM,EAAE,OAAO,OAAO,KAAM,WAAW,WAAW,SAAS,qBAAqB;CAKhF,MAAM,SAAS,aAFC,qBAAqB,OADjB,GAAG,aAAa,YAAY,cAAc,SAAS,GAAG,QACjB,QAAQ,CAE7B;CAGpC,MAAM,8BAAc,IAAI,KAAgC;AAExD,QAAO,GAAG,eAAe,WAAW;AAClC,cAAY,IAAI,OAAO;AACvB,SAAO,GAAG,eAAe,YAAY,OAAO,OAAO,CAAC;GACpD;CAGF,IAAI,iBAAiB;CAErB,MAAM,WAAW,YAA2B;AAC1C,MAAI,eAAgB;AACpB,mBAAiB;EAEjB,MAAM,kBACJ,OAAO,qBAAqB,WAAW,mBAAmB,EAAE;EAE9D,MAAM,UAAU,gBAAgB,WAAW;AAG3C,MAAI,gBAAgB,WAClB,OAAM,gBAAgB,YAAY;AAGpC,SAAO,IAAI,SAAe,YAAY;GAEpC,MAAM,kBAAkB,iBAAiB;AAEvC,SAAK,MAAM,UAAU,YACnB,QAAO,SAAS;AAElB,gBAAY,OAAO;AACnB,aAAS;MACR,QAAQ;AAGX,UAAO,YAAY;AACjB,iBAAa,gBAAgB;AAC7B,oBAAgB,sBAAsB;AACtC,aAAS;KACT;AAGF,QAAK,MAAM,UAAU,YAEnB,KAAI,CAAC,OAAO,eACV,QAAO,KAAK;IAGhB;;AAIJ,KAAI,kBAAkB;EAIpB,MAAM,WAFJ,OAAO,qBAAqB,WAAW,mBAAmB,EAAE,EAE9B,WAAW,CAAC,UAAU,UAAU;AAEhE,OAAK,MAAM,UAAU,QACnB,SAAQ,GAAG,cAAc;AACvB,aAAU,CAAC,WAAW,QAAQ,KAAK,EAAE,CAAC;IACtC;;AAKN,QAAO,OAAO,MAAM,UAAU,SAAS;AAEvC,QAAO;EACL;EACA;EACA;EACA,YACE,IAAI,SAAe,SAAS,WAAW;AACrC,UAAO,OAAO,QAAQ;AACpB,QAAI,IAAK,QAAO,IAAI;QACf,UAAS;KACd;IACF;EACJ;EACD;;;;;;AAOH,SAAgB,oBACd,OACA,SACY;AAEZ,QAAO,aADS,qBAAqB,OAAO,aAAa,QAAQ,CACrC"}

package/dist/{serve-AG80VaIr.d.mts → serve-DlzxgOhz.d.mts}

@@ -66,4 +66,4 @@ declare function serve(options: ServeOptions, callback?: () => void): ServeResul
 declare function createAdaptorServer(fetch: FetchHandler, onError?: (error: Error) => Response | Promise<Response>): Server;
 //#endregion
 export { createAdaptorServer as a, ServeResult as i, GracefulShutdownOptions as n, serve as o, ServeOptions as r, FetchHandler as t };
-//# sourceMappingURL=serve-AG80VaIr.d.mts.map
+//# sourceMappingURL=serve-DlzxgOhz.d.mts.map

package/dist/serve.d.mts

@@ -1,2 +1,2 @@
-import { a as createAdaptorServer, i as ServeResult, o as serve, r as ServeOptions, t as FetchHandler } from "./serve-AG80VaIr.mjs";
+import { a as createAdaptorServer, i as ServeResult, o as serve, r as ServeOptions, t as FetchHandler } from "./serve-DlzxgOhz.mjs";
 export { type FetchHandler, type ServeOptions, type ServeResult, createAdaptorServer, serve };

package/dist/serve.mjs

@@ -1,4 +1,4 @@
-import "./request-B-Nct5f7.mjs";
-import { n as serve, t as createAdaptorServer } from "./serve-48LEIkPa.mjs";
+import "./request-CppAFyqX.mjs";
+import { n as serve, t as createAdaptorServer } from "./serve-Df3HzwZM.mjs";
 
 export { createAdaptorServer, serve };

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

@@ -1,4 +1,2 @@
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
-import { t as BaseServer } from "../base-server-DLxtulAO.mjs";
+import { t as BaseServer } from "../base-server-Contwrlf.mjs";
 export { BaseServer };

package/dist/server/base-server.mjs

@@ -1,3 +1,3 @@
-import { t as BaseServer } from "../base-server-B7MYJNsl.mjs";
+import { t as BaseServer } from "../base-server-CE0mfqPY.mjs";
 
 export { BaseServer };

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

@@ -1,5 +1,2 @@
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
-import "../base-server-DLxtulAO.mjs";
-import { t as ComponentServer } from "../component-server-JqpDC7wy.mjs";
+import { t as ComponentServer } from "../component-server-fR4UV6Jq.mjs";
 export { ComponentServer };

package/dist/server/component-server.mjs

@@ -1,4 +1,4 @@
-import "../dependency-manager-DCmh7xFc.mjs";
-import { t as ComponentServer } from "../component-server-DomPJ_7S.mjs";
+import "../dependency-manager-CGMZJTer.mjs";
+import { t as ComponentServer } from "../component-server-Cya46YN3.mjs";
 
 export { ComponentServer };

package/dist/server/index.d.mts

@@ -1,7 +1,6 @@
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
-import { t as BaseServer } from "../base-server-DLxtulAO.mjs";
-import { t as Server } from "../server-C2RPKSvC.mjs";
-import { t as ComponentServer } from "../component-server-JqpDC7wy.mjs";
-import { t as ServerFactory } from "../index-Bj3SWrMU.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import { t as BaseServer } from "../base-server-Contwrlf.mjs";
+import { t as Server } from "../server-CpKaM0Kq.mjs";
+import { t as ComponentServer } from "../component-server-fR4UV6Jq.mjs";
+import { t as ServerFactory } from "../index-B8iPRxj1.mjs";
 export { BaseServer, ComponentServer, Server, ServerFactory };

package/dist/server/index.mjs

@@ -1,8 +1,8 @@
-import "../middleware-CewKbtb4.mjs";
-import { t as BaseServer } from "../base-server-B7MYJNsl.mjs";
-import { t as Server } from "../server-OUUug5DR.mjs";
-import "../dependency-manager-DCmh7xFc.mjs";
-import { t as ComponentServer } from "../component-server-DomPJ_7S.mjs";
-import { t as ServerFactory } from "../server-BUom6ISO.mjs";
+import "../response-CQ1IgWei.mjs";
+import { t as BaseServer } from "../base-server-CE0mfqPY.mjs";
+import { t as Server } from "../server-Bm0BGm01.mjs";
+import "../dependency-manager-CGMZJTer.mjs";
+import { t as ComponentServer } from "../component-server-Cya46YN3.mjs";
+import { t as ServerFactory } from "../server-CZLmrJSk.mjs";
 
 export { BaseServer, ComponentServer, Server, ServerFactory };

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

@@ -1,7 +1,4 @@
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
-import "../base-server-DLxtulAO.mjs";
-import "../server-C2RPKSvC.mjs";
-import "../component-server-JqpDC7wy.mjs";
-import { t as ServerFactory } from "../index-Bj3SWrMU.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import "../server-CpKaM0Kq.mjs";
+import { t as ServerFactory } from "../index-B8iPRxj1.mjs";
 export { ServerFactory };

package/dist/server/server-factory.mjs

@@ -1,7 +1,7 @@
-import "../middleware-CewKbtb4.mjs";
-import "../server-OUUug5DR.mjs";
-import "../dependency-manager-DCmh7xFc.mjs";
-import "../component-server-DomPJ_7S.mjs";
-import { t as ServerFactory } from "../server-BUom6ISO.mjs";
+import "../response-CQ1IgWei.mjs";
+import "../server-Bm0BGm01.mjs";
+import "../dependency-manager-CGMZJTer.mjs";
+import "../component-server-Cya46YN3.mjs";
+import { t as ServerFactory } from "../server-CZLmrJSk.mjs";
 
 export { ServerFactory };

package/dist/server/server.d.mts

@@ -1,5 +1,3 @@
-import "../schema-B6DFN5c2.mjs";
-import "../index-CREkvfw9.mjs";
-import "../base-server-DLxtulAO.mjs";
-import { t as Server } from "../server-C2RPKSvC.mjs";
+import "../defineRoute-zjOfHyZA.mjs";
+import { t as Server } from "../server-CpKaM0Kq.mjs";
 export { Server };

package/dist/server/server.mjs

@@ -1,4 +1,4 @@
-import "../middleware-CewKbtb4.mjs";
-import { t as Server } from "../server-OUUug5DR.mjs";
+import "../response-CQ1IgWei.mjs";
+import { t as Server } from "../server-Bm0BGm01.mjs";
 
 export { Server };

package/dist/{server-OUUug5DR.mjs → server-Bm0BGm01.mjs}

@@ -1,8 +1,7 @@
-import { t as flattenNestedRoutes } from "./router-CgYfGB4J.mjs";
-import { n as composeMiddleware, o as json } from "./middleware-CewKbtb4.mjs";
-import { t as BaseServer } from "./base-server-B7MYJNsl.mjs";
-import { t as RadixRouter } from "./radix-tree-qqSjnVXF.mjs";
-import { s as setGlobalRegistry, t as RouteRegistry } from "./route-registry-emTmRrWQ.mjs";
+import { i as json, u as composeMiddleware } from "./response-CQ1IgWei.mjs";
+import { t as BaseServer } from "./base-server-CE0mfqPY.mjs";
+import { t as RadixRouter } from "./radix-tree-CccjvyTP.mjs";
+import { c as setGlobalRegistry, t as RouteRegistry } from "./route-registry-BzExlM2t.mjs";
 
 //#region src/server/server.ts
 /**
@@ -10,10 +9,11 @@ import { s as setGlobalRegistry, t as RouteRegistry } from "./route-registry-emT
 *
 * @example
 * ```typescript
-* const server = new Server([
-*   { method: "GET", path: "/", handler: () => new Response("Hello") },
-* ]);
-* export default { fetch: server.fetch };
+* const routes = defineRoutes([
+*   defineRoute({ method: "GET", path: "/", handler: () => "Hello" }),
+* ])
+* const server = new Server(routes)
+* export default { fetch: server.fetch }
 * ```
 */
 var Server = class extends BaseServer {
@@ -26,11 +26,10 @@ var Server = class extends BaseServer {
 		if (routes.length > 0) this.registerRoutes([...routes]);
 	}
 	registerRoutes(routes) {
-		const flattened = flattenNestedRoutes(routes);
-		this.routes.push(...flattened);
-		for (const route of flattened) this.router.register(route.method, route.fullPath, route.handler, route.middlewareChain || []);
-		this.detectRouteConflicts(flattened);
-		this.logFlattenedRoutes(flattened);
+		this.routes.push(...routes);
+		for (const route of routes) this.router.register(route.method, route.path, route.handler, route.middleware || []);
+		this.detectRouteConflicts(routes);
+		this.logRoutes(routes);
 		setGlobalRegistry(new RouteRegistry(this.routes));
 	}
 	/** 快速提取 pathname */
@@ -82,33 +81,23 @@ var Server = class extends BaseServer {
 		if (this.globalMiddleware.length > 0) return composeMiddleware(this.globalMiddleware, () => this.createErrorResponse(method, pathname))(req);
 		return this.createErrorResponse(method, pathname);
 	};
+	/** 动态添加单个路由 */
 	addRoute(route) {
-		const flattenedRoute = {
-			...route,
-			fullPath: route.path,
-			middlewareChain: route.middleware || []
-		};
-		this.routes.push(flattenedRoute);
+		this.routes.push(route);
 		this.router.register(route.method, route.path, route.handler, route.middleware || []);
 	}
+	/** 动态添加多个路由 */
 	addRoutes(routes) {
 		this.registerRoutes([...routes]);
 	}
+	/** 获取路由列表 */
 	getRoutes() {
 		return this.router.getRoutes();
 	}
 	/**
-	* 获取完整的路由元信息（不含 handler 和 middleware）
+	* 获取完整的路由元信息
 	*
 	* 用于 API 文档生成、Webhook 事件注册、权限检查等场景
-	*
-	* @example
-	* ```typescript
-	* const routes = server.getRoutesWithMeta()
-	* for (const route of routes) {
-	*   console.log(route.fullPath, route.name, route.description)
-	* }
-	* ```
 	*/
 	getRoutesWithMeta() {
 		return this.routes;
@@ -117,4 +106,4 @@ var Server = class extends BaseServer {
 
 //#endregion
 export { Server as t };
-//# sourceMappingURL=server-OUUug5DR.mjs.map
+//# sourceMappingURL=server-Bm0BGm01.mjs.map

package/dist/server-Bm0BGm01.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-Bm0BGm01.mjs","names":[],"sources":["../src/server/server.ts"],"sourcesContent":["/**\n * Vafast 核心服务器\n *\n * 基于 Radix Tree 的高性能路由匹配\n * 时间复杂度: O(k)，k 为路径段数\n */\n\nimport type { Method, Middleware } from \"../types\";\nimport type { ProcessedRoute } from \"../defineRoute\";\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 routes = defineRoutes([\n *   defineRoute({ method: \"GET\", path: \"/\", handler: () => \"Hello\" }),\n * ])\n * const server = new Server(routes)\n * export default { fetch: server.fetch }\n * ```\n */\nexport class Server extends BaseServer {\n  private router: RadixRouter;\n  private routes: ProcessedRoute[];\n\n  constructor(routes: readonly ProcessedRoute[] = []) {\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: ProcessedRoute[]): void {\n    this.routes.push(...routes);\n\n    for (const route of routes) {\n      this.router.register(\n        route.method as Method,\n        route.path,\n        route.handler,\n        (route.middleware || []) as Middleware[],\n      );\n    }\n\n    this.detectRouteConflicts(routes);\n    this.logRoutes(routes);\n\n    // 自动设置全局 RouteRegistry\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  /** 动态添加单个路由 */\n  addRoute(route: ProcessedRoute): void {\n    this.routes.push(route);\n    this.router.register(\n      route.method as Method,\n      route.path,\n      route.handler,\n      (route.middleware || []) as Middleware[],\n    );\n  }\n\n  /** 动态添加多个路由 */\n  addRoutes(routes: readonly ProcessedRoute[]): void {\n    this.registerRoutes([...routes]);\n  }\n\n  /** 获取路由列表 */\n  getRoutes(): Array<{ method: Method; path: string }> {\n    return this.router.getRoutes();\n  }\n\n  /**\n   * 获取完整的路由元信息\n   *\n   * 用于 API 文档生成、Webhook 事件注册、权限检查等场景\n   */\n  getRoutesWithMeta(): ProcessedRoute[] {\n    return this.routes;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA2BA,IAAa,SAAb,cAA4B,WAAW;CACrC,AAAQ;CACR,AAAQ;CAER,YAAY,SAAoC,EAAE,EAAE;AAClD,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,QAAgC;AACrD,OAAK,OAAO,KAAK,GAAG,OAAO;AAE3B,OAAK,MAAM,SAAS,OAClB,MAAK,OAAO,SACV,MAAM,QACN,MAAM,MACN,MAAM,SACL,MAAM,cAAc,EAAE,CACxB;AAGH,OAAK,qBAAqB,OAAO;AACjC,OAAK,UAAU,OAAO;AAGtB,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;;;CAInD,SAAS,OAA6B;AACpC,OAAK,OAAO,KAAK,MAAM;AACvB,OAAK,OAAO,SACV,MAAM,QACN,MAAM,MACN,MAAM,SACL,MAAM,cAAc,EAAE,CACxB;;;CAIH,UAAU,QAAyC;AACjD,OAAK,eAAe,CAAC,GAAG,OAAO,CAAC;;;CAIlC,YAAqD;AACnD,SAAO,KAAK,OAAO,WAAW;;;;;;;CAQhC,oBAAsC;AACpC,SAAO,KAAK"}

package/dist/{server-BUom6ISO.mjs → server-CZLmrJSk.mjs}

@@ -1,5 +1,5 @@
-import { t as Server } from "./server-OUUug5DR.mjs";
-import { t as ComponentServer } from "./component-server-DomPJ_7S.mjs";
+import { t as Server } from "./server-Bm0BGm01.mjs";
+import { t as ComponentServer } from "./component-server-Cya46YN3.mjs";
 
 //#region src/server/server-factory.ts
 /**
@@ -67,4 +67,4 @@ var ServerFactory = class {
 
 //#endregion
 export { ServerFactory as t };
-//# sourceMappingURL=server-BUom6ISO.mjs.map
+//# sourceMappingURL=server-CZLmrJSk.mjs.map