vafast 0.4.21 → 0.4.22

package/README.md

@@ -20,7 +20,6 @@ export default { port: 3000, fetch: server.fetch };
 
 ```bash
 # 启动服务器
-bun run index.ts   # 或
 npx tsx index.ts
 ```
 
@@ -39,11 +38,7 @@ npx tsx index.ts
 ## 📦 安装
 
 ```bash
-# npm
 npm install vafast
-
-# bun
-bun add vafast
 ```
 
 ## 💡 设计哲学
@@ -504,7 +499,7 @@ const handler = createHandler({ body: UserSchema }, ({ body }) => {
 
 | 分类 | Format | 说明 |
 |------|--------|------|
-| **标识符** | `email`, `uuid`, `cuid`, `cuid2`, `ulid`, `nanoid`, `objectid`, `slug` | 各种 ID 格式 |
+| **标识符** | `email`, `uuid`, `uuid-any`, `cuid`, `cuid2`, `ulid`, `nanoid`, `objectid`, `slug` | 各种 ID 格式 |
 | **网络** | `url`, `uri`, `ipv4`, `ipv6`, `ip`, `cidr`, `hostname` | 网络地址 |
 | **日期时间** | `date`, `time`, `date-time`, `datetime`, `duration` | ISO 8601 格式 |
 | **手机号** | `phone` (中国), `phone-cn`, `phone-e164` (国际) | 电话号码 |
@@ -512,6 +507,8 @@ const handler = createHandler({ body: UserSchema }, ({ body }) => {
 | **颜色** | `hex-color`, `rgb-color`, `color` | 颜色值 |
 | **其他** | `emoji`, `semver`, `credit-card` | 特殊格式 |
 
+> **源码位置：** `src/utils/formats.ts` - 框架启动时自动注册所有 format 验证器
+
 **自定义 Format：**
 
 ```typescript
@@ -666,8 +663,8 @@ export default { port: 3000, fetch: server.fetch };
 ```bash
 git clone https://github.com/vafast/vafast.git
 cd vafast
-npm install  # 或 bun install
-npm test     # 或 bun test
+npm install
+npm test
 ```
 
 ## 🚀 发布流程

package/dist/defineRoute.d.mts

@@ -19,82 +19,36 @@ type InferableRoute<TMethod extends string = string, TPath extends string = stri
  */
 type Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;
 /**
- * 路由定义类型（保留完整 handler 类型）
- */
-type RouteDefinition<TMethod extends string = string, TPath extends string = string, THandler = unknown> = {
-  readonly method: TMethod;
-  readonly path: TPath;
-  readonly handler: THandler;
-  readonly middleware?: ReadonlyArray<Middleware>;
-};
-/**
- * 创建单个路由定义（自动保留字面量类型，无需 as const）
+ * 定义路由数组（自动保留字面量类型，支持端到端类型推断）
  *
  * @example
  * ```typescript
- * import { route, defineRoutes, createHandler, Type } from 'vafast'
+ * import { defineRoutes, createHandler, Type } from 'vafast'
+ * import type { InferEden } from 'vafast-api-client'
  *
  * const routes = defineRoutes([
- *   route('GET', '/users', createHandler(
- *     { query: Type.Object({ page: Type.Number() }) },
- *     async ({ query }) => ({ users: [], total: 0 })
- *   )),
- *   route('POST', '/users', createHandler(
- *     { body: Type.Object({ name: Type.String() }) },
- *     async ({ body }) => ({ id: '1', name: body.name })
- *   )),
- *   route('GET', '/users/:id', createHandler(
- *     { params: Type.Object({ id: Type.String() }) },
- *     async ({ params }) => ({ id: params.id, name: 'User' })
- *   ))
+ *   {
+ *     method: 'GET',
+ *     path: '/users',
+ *     handler: createHandler(
+ *       { query: Type.Object({ page: Type.Number() }) },
+ *       async ({ query }) => ({ users: [], total: 0 })
+ *     )
+ *   },
+ *   {
+ *     method: 'POST',
+ *     path: '/users',
+ *     handler: createHandler(
+ *       { body: Type.Object({ name: Type.String() }) },
+ *       async ({ body }) => ({ id: '1', name: body.name })
+ *     )
+ *   }
  * ])
  *
- * // 无需 as const！类型自动推断
+ * // ✅ 自动推断字面量类型，支持端到端类型推断
  * type Api = InferEden<typeof routes>
  * ```
  */
-declare function route<TMethod extends string, TPath extends string, THandler>(method: TMethod, path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<TMethod, TPath, THandler>;
-/**
- * GET 路由快捷方法
- */
-declare function get<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'GET', TPath, THandler>;
-/**
- * POST 路由快捷方法
- */
-declare function post<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'POST', TPath, THandler>;
-/**
- * PUT 路由快捷方法
- */
-declare function put<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'PUT', TPath, THandler>;
-/**
- * DELETE 路由快捷方法
- */
-declare function del<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'DELETE', TPath, THandler>;
-/**
- * PATCH 路由快捷方法
- */
-declare function patch<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'PATCH', TPath, THandler>;
-/**
- * 定义路由数组（保留完整类型信息）
- *
- * 推荐配合 route() 函数使用，无需 as const
- *
- * @example
- * ```typescript
- * import { defineRoutes, route, createHandler, Type } from 'vafast'
- *
- * // ✨ 新方式：使用 route() 函数，无需 as const
- * const routes = defineRoutes([
- *   route('GET', '/users', createHandler(...)),
- *   route('POST', '/users', createHandler(...))
- * ])
- *
- * // 🔙 旧方式：需要 as const（仍然支持）
- * const routes = defineRoutes([
- *   { method: 'GET', path: '/users', handler: createHandler(...) }
- * ] as const)
- * ```
- */
 declare function defineRoutes<const T extends readonly {
   readonly method: string;
   readonly path: string;
@@ -102,5 +56,5 @@ declare function defineRoutes<const T extends readonly {
   readonly middleware?: ReadonlyArray<Middleware>;
 }[]>(routes: T): T;
 //#endregion
-export { InferableRoute, RouteDefinition, defineRoutes, del, get, patch, post, put, route };
+export { InferableRoute, defineRoutes };
 //# sourceMappingURL=defineRoute.d.mts.map

package/dist/defineRoute.mjs

@@ -1,93 +1,39 @@
 //#region src/defineRoute.ts
 /**
-* 创建单个路由定义（自动保留字面量类型，无需 as const）
-* 
+* 定义路由数组（自动保留字面量类型，支持端到端类型推断）
+*
 * @example
 * ```typescript
-* import { route, defineRoutes, createHandler, Type } from 'vafast'
-* 
+* import { defineRoutes, createHandler, Type } from 'vafast'
+* import type { InferEden } from 'vafast-api-client'
+*
 * const routes = defineRoutes([
-*   route('GET', '/users', createHandler(
-*     { query: Type.Object({ page: Type.Number() }) },
-*     async ({ query }) => ({ users: [], total: 0 })
-*   )),
-*   route('POST', '/users', createHandler(
-*     { body: Type.Object({ name: Type.String() }) },
-*     async ({ body }) => ({ id: '1', name: body.name })
-*   )),
-*   route('GET', '/users/:id', createHandler(
-*     { params: Type.Object({ id: Type.String() }) },
-*     async ({ params }) => ({ id: params.id, name: 'User' })
-*   ))
+*   {
+*     method: 'GET',
+*     path: '/users',
+*     handler: createHandler(
+*       { query: Type.Object({ page: Type.Number() }) },
+*       async ({ query }) => ({ users: [], total: 0 })
+*     )
+*   },
+*   {
+*     method: 'POST',
+*     path: '/users',
+*     handler: createHandler(
+*       { body: Type.Object({ name: Type.String() }) },
+*       async ({ body }) => ({ id: '1', name: body.name })
+*     )
+*   }
 * ])
-* 
-* // 无需 as const！类型自动推断
+*
+* // ✅ 自动推断字面量类型，支持端到端类型推断
 * type Api = InferEden<typeof routes>
 * ```
 */
-function route(method, path, handler, middleware) {
-	return {
-		method,
-		path,
-		handler,
-		middleware
-	};
-}
-/**
-* GET 路由快捷方法
-*/
-function get(path, handler, middleware) {
-	return route("GET", path, handler, middleware);
-}
-/**
-* POST 路由快捷方法
-*/
-function post(path, handler, middleware) {
-	return route("POST", path, handler, middleware);
-}
-/**
-* PUT 路由快捷方法
-*/
-function put(path, handler, middleware) {
-	return route("PUT", path, handler, middleware);
-}
-/**
-* DELETE 路由快捷方法
-*/
-function del(path, handler, middleware) {
-	return route("DELETE", path, handler, middleware);
-}
-/**
-* PATCH 路由快捷方法
-*/
-function patch(path, handler, middleware) {
-	return route("PATCH", path, handler, middleware);
-}
-/**
-* 定义路由数组（保留完整类型信息）
-* 
-* 推荐配合 route() 函数使用，无需 as const
-* 
-* @example
-* ```typescript
-* import { defineRoutes, route, createHandler, Type } from 'vafast'
-* 
-* // ✨ 新方式：使用 route() 函数，无需 as const
-* const routes = defineRoutes([
-*   route('GET', '/users', createHandler(...)),
-*   route('POST', '/users', createHandler(...))
-* ])
-* 
-* // 🔙 旧方式：需要 as const（仍然支持）
-* const routes = defineRoutes([
-*   { method: 'GET', path: '/users', handler: createHandler(...) }
-* ] as const)
-* ```
-*/
 function defineRoutes(routes) {
 	return routes;
 }
 
 //#endregion
-export { defineRoutes, del, get, patch, post, put, route };
+export { defineRoutes };
 //# sourceMappingURL=defineRoute.mjs.map

package/dist/defineRoute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"defineRoute.mjs","names":[],"sources":["../src/defineRoute.ts"],"sourcesContent":["import type { RouteSchema } from \"./types\";\nimport type { InferableHandler } from \"./utils/create-handler\";\n\n/**\n * 可推断的路由类型（用于类型推断）\n * 供 vafast-api-client 使用，保留完整的类型信息\n */\nexport type InferableRoute<\n  TMethod extends string = string,\n  TPath extends string = string,\n  TReturn = unknown,\n  TSchema extends RouteSchema = RouteSchema\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: InferableHandler<TReturn, TSchema>;\n  readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;\n}\n\n/**\n * 中间件类型\n */\ntype Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;\n\n/**\n * 路由定义类型（保留完整 handler 类型）\n */\nexport type RouteDefinition<\n  TMethod extends string = string,\n  TPath extends string = string,\n  THandler = unknown\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: THandler;\n  readonly middleware?: ReadonlyArray<Middleware>;\n}\n\n/**\n * 创建单个路由定义（自动保留字面量类型，无需 as const）\n * \n * @example\n * ```typescript\n * import { route, defineRoutes, createHandler, Type } from 'vafast'\n * \n * const routes = defineRoutes([\n *   route('GET', '/users', createHandler(\n *     { query: Type.Object({ page: Type.Number() }) },\n *     async ({ query }) => ({ users: [], total: 0 })\n *   )),\n *   route('POST', '/users', createHandler(\n *     { body: Type.Object({ name: Type.String() }) },\n *     async ({ body }) => ({ id: '1', name: body.name })\n *   )),\n *   route('GET', '/users/:id', createHandler(\n *     { params: Type.Object({ id: Type.String() }) },\n *     async ({ params }) => ({ id: params.id, name: 'User' })\n *   ))\n * ])\n * \n * // 无需 as const！类型自动推断\n * type Api = InferEden<typeof routes>\n * ```\n */\nexport function route<\n  TMethod extends string,\n  TPath extends string,\n  THandler\n>(\n  method: TMethod,\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<TMethod, TPath, THandler> {\n  return {\n    method,\n    path,\n    handler,\n    middleware\n  };\n}\n\n/**\n * GET 路由快捷方法\n */\nexport function get<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'GET', TPath, THandler> {\n  return route('GET', path, handler, middleware);\n}\n\n/**\n * POST 路由快捷方法\n */\nexport function post<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'POST', TPath, THandler> {\n  return route('POST', path, handler, middleware);\n}\n\n/**\n * PUT 路由快捷方法\n */\nexport function put<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'PUT', TPath, THandler> {\n  return route('PUT', path, handler, middleware);\n}\n\n/**\n * DELETE 路由快捷方法\n */\nexport function del<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'DELETE', TPath, THandler> {\n  return route('DELETE', path, handler, middleware);\n}\n\n/**\n * PATCH 路由快捷方法\n */\nexport function patch<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'PATCH', TPath, THandler> {\n  return route('PATCH', path, handler, middleware);\n}\n\n/**\n * 定义路由数组（保留完整类型信息）\n * \n * 推荐配合 route() 函数使用，无需 as const\n * \n * @example\n * ```typescript\n * import { defineRoutes, route, createHandler, Type } from 'vafast'\n * \n * // ✨ 新方式：使用 route() 函数，无需 as const\n * const routes = defineRoutes([\n *   route('GET', '/users', createHandler(...)),\n *   route('POST', '/users', createHandler(...))\n * ])\n * \n * // 🔙 旧方式：需要 as const（仍然支持）\n * const routes = defineRoutes([\n *   { method: 'GET', path: '/users', handler: createHandler(...) }\n * ] as const)\n * ```\n */\nexport function defineRoutes<\n  const T extends readonly {\n    readonly method: string\n    readonly path: string\n    readonly handler: unknown\n    readonly middleware?: ReadonlyArray<Middleware>\n  }[]\n>(routes: T): T {\n  return routes;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,SAAgB,MAKd,QACA,MACA,SACA,YAC2C;AAC3C,QAAO;EACL;EACA;EACA;EACA;EACD;;;;;AAMH,SAAgB,IACd,MACA,SACA,YACyC;AACzC,QAAO,MAAM,OAAO,MAAM,SAAS,WAAW;;;;;AAMhD,SAAgB,KACd,MACA,SACA,YAC0C;AAC1C,QAAO,MAAM,QAAQ,MAAM,SAAS,WAAW;;;;;AAMjD,SAAgB,IACd,MACA,SACA,YACyC;AACzC,QAAO,MAAM,OAAO,MAAM,SAAS,WAAW;;;;;AAMhD,SAAgB,IACd,MACA,SACA,YAC4C;AAC5C,QAAO,MAAM,UAAU,MAAM,SAAS,WAAW;;;;;AAMnD,SAAgB,MACd,MACA,SACA,YAC2C;AAC3C,QAAO,MAAM,SAAS,MAAM,SAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;AAwBlD,SAAgB,aAOd,QAAc;AACd,QAAO"}
+{"version":3,"file":"defineRoute.mjs","names":[],"sources":["../src/defineRoute.ts"],"sourcesContent":["import type { RouteSchema } from \"./types\";\nimport type { InferableHandler } from \"./utils/create-handler\";\n\n/**\n * 可推断的路由类型（用于类型推断）\n * 供 vafast-api-client 使用，保留完整的类型信息\n */\nexport type InferableRoute<\n  TMethod extends string = string,\n  TPath extends string = string,\n  TReturn = unknown,\n  TSchema extends RouteSchema = RouteSchema\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: InferableHandler<TReturn, TSchema>;\n  readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;\n}\n\n/**\n * 中间件类型\n */\ntype Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;\n\n/**\n * 定义路由数组（自动保留字面量类型，支持端到端类型推断）\n *\n * @example\n * ```typescript\n * import { defineRoutes, createHandler, Type } from 'vafast'\n * import type { InferEden } from 'vafast-api-client'\n *\n * const routes = defineRoutes([\n *   {\n *     method: 'GET',\n *     path: '/users',\n *     handler: createHandler(\n *       { query: Type.Object({ page: Type.Number() }) },\n *       async ({ query }) => ({ users: [], total: 0 })\n *     )\n *   },\n *   {\n *     method: 'POST',\n *     path: '/users',\n *     handler: createHandler(\n *       { body: Type.Object({ name: Type.String() }) },\n *       async ({ body }) => ({ id: '1', name: body.name })\n *     )\n *   }\n * ])\n *\n * // ✅ 自动推断字面量类型，支持端到端类型推断\n * type Api = InferEden<typeof routes>\n * ```\n */\nexport function defineRoutes<\n  const T extends readonly {\n    readonly method: string\n    readonly path: string\n    readonly handler: unknown\n    readonly middleware?: ReadonlyArray<Middleware>\n  }[]\n>(routes: T): T {\n  return routes;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,SAAgB,aAOd,QAAc;AACd,QAAO"}

package/dist/index.d.mts

@@ -4,7 +4,7 @@ import { n as FlattenedComponentRoute, r as NestedComponentRoute, t as Component
 import { a as TypedHandler, i as RouteSchema, n as HandlerContextWithExtra, o as TypedRouteConfig, r as InferSchema, t as HandlerContext } from "./schema-B6DFN5c2.mjs";
 import "./index-CREkvfw9.mjs";
 import { i as simpleHandler, n as createHandler, r as createHandlerWithExtra, t as InferableHandler } from "./create-handler-DKw-sQOV.mjs";
-import { InferableRoute, RouteDefinition, defineRoutes, del, get, patch, post, put, route } from "./defineRoute.mjs";
+import { InferableRoute, defineRoutes } from "./defineRoute.mjs";
 import { t as BaseServer } from "./base-server-DLxtulAO.mjs";
 import { t as Server } from "./server-DGA3dd5s.mjs";
 import { t as DependencyManager } from "./dependency-manager-C3_7ic4h.mjs";
@@ -27,4 +27,4 @@ import { flattenNestedRoutes, normalizePath } from "./router.mjs";
 import { i as ServeResult, o as serve, r as ServeOptions, t as FetchHandler } from "./serve-AG80VaIr.mjs";
 import "./serve.mjs";
 import { FormatRegistry, Type } from "@sinclair/typebox";
-export { BaseRouteConfig, BaseServer, CompatibleRoute, ComponentRoute, ComponentServer, DependencyManager, ExtendedRouteConfig, type FetchHandler, FlattenedComponentRoute, FlattenedRoute, FormatRegistry, Handler, HandlerContext, HandlerContextWithExtra, HtmlRenderer, InferSchema, InferableHandler, InferableRoute, Method, Middleware, NestedComponentRoute, NestedRoute, NestedRouteConfig, Patterns, ResponseBody, Route, RouteDefinition, RouteMeta, RouteRegistry, RouteSchema, SSEEvent, SSEHandler, SSEMarker, SchemaConfig, type ServeOptions, type ServeResult, Server, ServerFactory, Type, TypedHandler, TypedRoute, TypedRouteConfig, VafastError, ValidationError, ValidationResult, base64urlDecode, base64urlEncode, composeMiddleware, createHandler, createHandlerWithExtra, createRequestValidator, createRouteRegistry, createSSEHandler, createTypedRoute, createValidator, defineRoutes, del, empty, err, filterRoutes, flattenNestedRoutes, get, getAllRoutes, getCookie, getHeader, getLocals, getRoute, getRouteRegistry, getValidatorCacheStats, goAwait, hasFormat, html, isTypedRoute, json, normalizePath, parseAndValidateRequest, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, parseRequest, patch, post, precompileSchemas, put, redirect, registerFormat, registerFormats, route, serve, setLocals, simpleHandler, stream, text, validateAllSchemas, validateFast, validateRequest, validateSchema, validateSchemaOrThrow };
+export { BaseRouteConfig, BaseServer, CompatibleRoute, ComponentRoute, ComponentServer, DependencyManager, ExtendedRouteConfig, type FetchHandler, FlattenedComponentRoute, FlattenedRoute, FormatRegistry, Handler, HandlerContext, HandlerContextWithExtra, HtmlRenderer, InferSchema, InferableHandler, InferableRoute, Method, Middleware, NestedComponentRoute, NestedRoute, NestedRouteConfig, Patterns, ResponseBody, Route, RouteMeta, RouteRegistry, RouteSchema, SSEEvent, SSEHandler, SSEMarker, SchemaConfig, type ServeOptions, type ServeResult, Server, ServerFactory, Type, TypedHandler, TypedRoute, TypedRouteConfig, VafastError, ValidationError, ValidationResult, base64urlDecode, base64urlEncode, composeMiddleware, createHandler, createHandlerWithExtra, createRequestValidator, createRouteRegistry, createSSEHandler, createTypedRoute, createValidator, defineRoutes, empty, err, filterRoutes, flattenNestedRoutes, getAllRoutes, getCookie, getHeader, getLocals, getRoute, getRouteRegistry, getValidatorCacheStats, goAwait, hasFormat, html, isTypedRoute, json, normalizePath, parseAndValidateRequest, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, parseRequest, precompileSchemas, redirect, registerFormat, registerFormats, serve, setLocals, simpleHandler, stream, text, validateAllSchemas, validateFast, validateRequest, validateSchema, validateSchemaOrThrow };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { defineRoutes, del, get, patch, post, put, route } from "./defineRoute.mjs";
+import { defineRoutes } from "./defineRoute.mjs";
 import { n as normalizePath, t as flattenNestedRoutes } from "./router-xWzwz_1a.mjs";
 import { a as html, c as redirect, i as err, l as stream, n as composeMiddleware, o as json, r as empty, t as VafastError, u as text } from "./middleware-CewKbtb4.mjs";
 import { t as BaseServer } from "./base-server-B7MYJNsl.mjs";
@@ -29,5 +29,5 @@ import { FormatRegistry, Type } from "@sinclair/typebox";
 registerFormats();
 
 //#endregion
-export { BaseServer, ComponentServer, DependencyManager, FormatRegistry, HtmlRenderer, Patterns, RouteRegistry, Server, ServerFactory, Type, VafastError, base64urlDecode, base64urlEncode, composeMiddleware, createHandler, createHandlerWithExtra, createRequestValidator, createRouteRegistry, createSSEHandler, createTypedRoute, createValidator, defineRoutes, del, empty, err, filterRoutes, flattenNestedRoutes, get, getAllRoutes, getCookie, getHeader, getLocals, getRoute, getRouteRegistry, getValidatorCacheStats, goAwait, hasFormat, html, isTypedRoute, json, normalizePath, parseAndValidateRequest, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, parseRequest, patch, post, precompileSchemas, put, redirect, registerFormat, registerFormats, route, serve, setLocals, simpleHandler, stream, text, validateAllSchemas, validateFast, validateRequest, validateSchema, validateSchemaOrThrow };
+export { BaseServer, ComponentServer, DependencyManager, FormatRegistry, HtmlRenderer, Patterns, RouteRegistry, Server, ServerFactory, Type, VafastError, base64urlDecode, base64urlEncode, composeMiddleware, createHandler, createHandlerWithExtra, createRequestValidator, createRouteRegistry, createSSEHandler, createTypedRoute, createValidator, defineRoutes, empty, err, filterRoutes, flattenNestedRoutes, getAllRoutes, getCookie, getHeader, getLocals, getRoute, getRouteRegistry, getValidatorCacheStats, goAwait, hasFormat, html, isTypedRoute, json, normalizePath, parseAndValidateRequest, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast, parseRequest, precompileSchemas, redirect, registerFormat, registerFormats, serve, setLocals, simpleHandler, stream, text, validateAllSchemas, validateFast, validateRequest, validateSchema, validateSchemaOrThrow };
 //# sourceMappingURL=index.mjs.map

package/dist/monitoring/native-monitor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"native-monitor.mjs","names":[],"sources":["../../src/monitoring/native-monitor.ts"],"sourcesContent":["/**\n * 原生监控模块（零外部依赖）\n *\n * 特性：\n * - P50/P95/P99 百分位数统计\n * - 按路径分组统计\n * - 时间窗口统计（1分钟/5分钟/1小时）\n * - RPS 计算（每秒请求数）\n * - 状态码分布\n * - 环形缓冲区（内存友好）\n * - 采样率控制\n * - 路径排除\n * - 自定义回调\n */\n\nimport type { Server } from \"../server\";\n\n// ========== 类型定义 ==========\n\n/** 监控配置 */\nexport interface MonitoringConfig {\n  /** 是否启用监控，默认 true */\n  enabled?: boolean;\n  /** 是否输出到控制台，默认 true */\n  console?: boolean;\n  /** 慢请求阈值（毫秒），默认 1000 */\n  slowThreshold?: number;\n  /** 最大记录数，默认 1000 */\n  maxRecords?: number;\n  /** 采样率 0-1，默认 1（全部记录） */\n  samplingRate?: number;\n  /** 排除的路径（不记录） */\n  excludePaths?: string[];\n  /** 自定义标签 */\n  tags?: Record<string, string>;\n  /** 请求完成回调 */\n  onRequest?: (metrics: MonitoringMetrics) => void;\n  /** 慢请求回调 */\n  onSlowRequest?: (metrics: MonitoringMetrics) => void;\n}\n\n/** 监控指标 */\nexport interface MonitoringMetrics {\n  requestId: string;\n  method: string;\n  path: string;\n  statusCode: number;\n  totalTime: number;\n  timestamp: number;\n  memoryUsage: MemoryInfo;\n}\n\n/** 内存信息 */\nexport interface MemoryInfo {\n  heapUsed: number;\n  heapTotal: number;\n}\n\n/** 路径统计 */\nexport interface PathStats {\n  count: number;\n  totalTime: number;\n  avgTime: number;\n  minTime: number;\n  maxTime: number;\n  errorCount: number;\n}\n\n/** 时间窗口统计 */\nexport interface TimeWindowStats {\n  /** 请求数 */\n  requests: number;\n  /** 成功数 */\n  successful: number;\n  /** 失败数 */\n  failed: number;\n  /** 错误率 */\n  errorRate: number;\n  /** 平均响应时间 */\n  avgTime: number;\n  /** RPS（每秒请求数） */\n  rps: number;\n}\n\n/** 状态码分布 */\nexport interface StatusCodeDistribution {\n  /** 2xx 成功 */\n  \"2xx\": number;\n  /** 3xx 重定向 */\n  \"3xx\": number;\n  /** 4xx 客户端错误 */\n  \"4xx\": number;\n  /** 5xx 服务器错误 */\n  \"5xx\": number;\n  /** 详细分布 */\n  detail: Record<number, number>;\n}\n\n/** 监控状态 */\nexport interface MonitoringStatus {\n  enabled: boolean;\n  /** 服务运行时间（毫秒） */\n  uptime: number;\n  totalRequests: number;\n  successfulRequests: number;\n  failedRequests: number;\n  errorRate: number;\n  /** 平均响应时间（毫秒） */\n  avgResponseTime: number;\n  /** P50 响应时间（毫秒） */\n  p50: number;\n  /** P95 响应时间（毫秒） */\n  p95: number;\n  /** P99 响应时间（毫秒） */\n  p99: number;\n  /** 最小响应时间 */\n  minTime: number;\n  /** 最大响应时间 */\n  maxTime: number;\n  /** 当前 RPS */\n  rps: number;\n  /** 状态码分布 */\n  statusCodes: StatusCodeDistribution;\n  /** 时间窗口统计 */\n  timeWindows: {\n    /** 最近 1 分钟 */\n    last1min: TimeWindowStats;\n    /** 最近 5 分钟 */\n    last5min: TimeWindowStats;\n    /** 最近 1 小时 */\n    last1hour: TimeWindowStats;\n  };\n  /** 按路径统计 */\n  byPath: Record<string, PathStats>;\n  /** 内存使用 */\n  memoryUsage: {\n    heapUsed: string;\n    heapTotal: string;\n  };\n  /** 最近请求 */\n  recentRequests: MonitoringMetrics[];\n}\n\n/** 带监控的 Server */\nexport interface MonitoredServer extends Server {\n  getMonitoringStatus(): MonitoringStatus;\n  getMonitoringMetrics(): MonitoringMetrics[];\n  getPathStats(path: string): PathStats | undefined;\n  getTimeWindowStats(windowMs: number): TimeWindowStats;\n  getRPS(): number;\n  getStatusCodeDistribution(): StatusCodeDistribution;\n  resetMonitoring(): void;\n}\n\n// ========== 常量 ==========\n\nconst ONE_MINUTE = 60 * 1000;\nconst FIVE_MINUTES = 5 * 60 * 1000;\nconst ONE_HOUR = 60 * 60 * 1000;\n\n// ========== 环形缓冲区 ==========\n\nfunction createRingBuffer<T>(capacity: number) {\n  const buffer: T[] = new Array(capacity);\n  let head = 0;\n  let size = 0;\n\n  return {\n    push(item: T) {\n      buffer[head % capacity] = item;\n      head++;\n      if (size < capacity) size++;\n    },\n\n    toArray(): T[] {\n      if (size === 0) return [];\n      if (size < capacity) {\n        return buffer.slice(0, size);\n      }\n      const start = head % capacity;\n      return [...buffer.slice(start), ...buffer.slice(0, start)];\n    },\n\n    getSize: () => size,\n\n    clear() {\n      head = 0;\n      size = 0;\n    },\n\n    recent(n: number): T[] {\n      const arr = this.toArray();\n      return arr.slice(-n);\n    },\n  };\n}\n\n// ========== 工具函数 ==========\n\nfunction generateRequestId(): string {\n  return `req_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;\n}\n\nfunction getMemoryInfo(): MemoryInfo {\n  if (typeof process !== \"undefined\" && process.memoryUsage) {\n    const mem = process.memoryUsage();\n    return { heapUsed: mem.heapUsed, heapTotal: mem.heapTotal };\n  }\n  return { heapUsed: 0, heapTotal: 0 };\n}\n\nfunction formatMemory(bytes: number): string {\n  return (bytes / 1024 / 1024).toFixed(2) + \"MB\";\n}\n\nfunction percentile(sorted: number[], p: number): number {\n  if (sorted.length === 0) return 0;\n  const index = Math.ceil((p / 100) * sorted.length) - 1;\n  return sorted[Math.max(0, index)];\n}\n\nfunction shouldExclude(path: string, excludePaths: string[]): boolean {\n  return excludePaths.some(\n    (p) =>\n      path === p ||\n      path.startsWith(p + \"/\") ||\n      (p.endsWith(\"*\") && path.startsWith(p.slice(0, -1)))\n  );\n}\n\nfunction getStatusCodeCategory(code: number): \"2xx\" | \"3xx\" | \"4xx\" | \"5xx\" {\n  if (code >= 200 && code < 300) return \"2xx\";\n  if (code >= 300 && code < 400) return \"3xx\";\n  if (code >= 400 && code < 500) return \"4xx\";\n  return \"5xx\";\n}\n\n// ========== 监控状态管理 ==========\n\nfunction createMonitorState(config: Required<MonitoringConfig>) {\n  const buffer = createRingBuffer<MonitoringMetrics>(config.maxRecords);\n  const pathStats = new Map<string, PathStats>();\n  const startTime = Date.now();\n\n  /** 获取时间窗口内的指标 */\n  function getMetricsInWindow(windowMs: number): MonitoringMetrics[] {\n    const now = Date.now();\n    const cutoff = now - windowMs;\n    return buffer.toArray().filter((m) => m.timestamp >= cutoff);\n  }\n\n  /** 计算时间窗口统计 */\n  function calcTimeWindowStats(windowMs: number): TimeWindowStats {\n    const metrics = getMetricsInWindow(windowMs);\n    const count = metrics.length;\n\n    if (count === 0) {\n      return {\n        requests: 0,\n        successful: 0,\n        failed: 0,\n        errorRate: 0,\n        avgTime: 0,\n        rps: 0,\n      };\n    }\n\n    const successful = metrics.filter((m) => m.statusCode < 400).length;\n    const failed = count - successful;\n    const avgTime = metrics.reduce((sum, m) => sum + m.totalTime, 0) / count;\n\n    // 计算实际时间跨度（用于 RPS）\n    const timestamps = metrics.map((m) => m.timestamp);\n    const actualWindow = Math.max(...timestamps) - Math.min(...timestamps);\n    const effectiveWindow = Math.max(actualWindow, 1000); // 至少 1 秒\n    const rps = (count / effectiveWindow) * 1000;\n\n    return {\n      requests: count,\n      successful,\n      failed,\n      errorRate: failed / count,\n      avgTime: Number(avgTime.toFixed(2)),\n      rps: Number(rps.toFixed(2)),\n    };\n  }\n\n  /** 计算状态码分布 */\n  function calcStatusCodeDistribution(): StatusCodeDistribution {\n    const metrics = buffer.toArray();\n    const dist: StatusCodeDistribution = {\n      \"2xx\": 0,\n      \"3xx\": 0,\n      \"4xx\": 0,\n      \"5xx\": 0,\n      detail: {},\n    };\n\n    for (const m of metrics) {\n      const category = getStatusCodeCategory(m.statusCode);\n      dist[category]++;\n      dist.detail[m.statusCode] = (dist.detail[m.statusCode] || 0) + 1;\n    }\n\n    return dist;\n  }\n\n  /** 计算当前 RPS（基于最近 10 秒） */\n  function calcCurrentRPS(): number {\n    const metrics = getMetricsInWindow(10000); // 最近 10 秒\n    if (metrics.length === 0) return 0;\n    return Number((metrics.length / 10).toFixed(2));\n  }\n\n  return {\n    addMetrics(m: MonitoringMetrics) {\n      buffer.push(m);\n\n      // 更新路径统计\n      const stats = pathStats.get(m.path) || {\n        count: 0,\n        totalTime: 0,\n        avgTime: 0,\n        minTime: Infinity,\n        maxTime: 0,\n        errorCount: 0,\n      };\n\n      stats.count++;\n      stats.totalTime += m.totalTime;\n      stats.avgTime = stats.totalTime / stats.count;\n      stats.minTime = Math.min(stats.minTime, m.totalTime);\n      stats.maxTime = Math.max(stats.maxTime, m.totalTime);\n      if (m.statusCode >= 400) stats.errorCount++;\n\n      pathStats.set(m.path, stats);\n    },\n\n    getMetrics: () => buffer.toArray(),\n\n    getPathStats: (path: string) => pathStats.get(path),\n\n    getTimeWindowStats: calcTimeWindowStats,\n\n    getRPS: calcCurrentRPS,\n\n    getStatusCodeDistribution: calcStatusCodeDistribution,\n\n    reset() {\n      buffer.clear();\n      pathStats.clear();\n    },\n\n    getStatus(): MonitoringStatus {\n      const metrics = buffer.toArray();\n      const total = metrics.length;\n\n      if (total === 0) {\n        return {\n          enabled: config.enabled,\n          uptime: Date.now() - startTime,\n          totalRequests: 0,\n          successfulRequests: 0,\n          failedRequests: 0,\n          errorRate: 0,\n          avgResponseTime: 0,\n          p50: 0,\n          p95: 0,\n          p99: 0,\n          minTime: 0,\n          maxTime: 0,\n          rps: 0,\n          statusCodes: { \"2xx\": 0, \"3xx\": 0, \"4xx\": 0, \"5xx\": 0, detail: {} },\n          timeWindows: {\n            last1min: { requests: 0, successful: 0, failed: 0, errorRate: 0, avgTime: 0, rps: 0 },\n            last5min: { requests: 0, successful: 0, failed: 0, errorRate: 0, avgTime: 0, rps: 0 },\n            last1hour: { requests: 0, successful: 0, failed: 0, errorRate: 0, avgTime: 0, rps: 0 },\n          },\n          byPath: {},\n          memoryUsage: { heapUsed: formatMemory(0), heapTotal: formatMemory(0) },\n          recentRequests: [],\n        };\n      }\n\n      const successful = metrics.filter((m) => m.statusCode < 400).length;\n      const failed = total - successful;\n\n      const times = metrics.map((m) => m.totalTime);\n      const sortedTimes = [...times].sort((a, b) => a - b);\n      const avgTime = times.reduce((a, b) => a + b, 0) / total;\n\n      const mem = getMemoryInfo();\n\n      const byPath: Record<string, PathStats> = {};\n      pathStats.forEach((stats, path) => {\n        byPath[path] = { ...stats, minTime: stats.minTime === Infinity ? 0 : stats.minTime };\n      });\n\n      return {\n        enabled: config.enabled,\n        uptime: Date.now() - startTime,\n        totalRequests: total,\n        successfulRequests: successful,\n        failedRequests: failed,\n        errorRate: Number((failed / total).toFixed(4)),\n        avgResponseTime: Number(avgTime.toFixed(2)),\n        p50: Number(percentile(sortedTimes, 50).toFixed(2)),\n        p95: Number(percentile(sortedTimes, 95).toFixed(2)),\n        p99: Number(percentile(sortedTimes, 99).toFixed(2)),\n        minTime: Number(sortedTimes[0].toFixed(2)),\n        maxTime: Number(sortedTimes[sortedTimes.length - 1].toFixed(2)),\n        rps: calcCurrentRPS(),\n        statusCodes: calcStatusCodeDistribution(),\n        timeWindows: {\n          last1min: calcTimeWindowStats(ONE_MINUTE),\n          last5min: calcTimeWindowStats(FIVE_MINUTES),\n          last1hour: calcTimeWindowStats(ONE_HOUR),\n        },\n        byPath,\n        memoryUsage: {\n          heapUsed: formatMemory(mem.heapUsed),\n          heapTotal: formatMemory(mem.heapTotal),\n        },\n        recentRequests: buffer.recent(5),\n      };\n    },\n  };\n}\n\n// ========== 日志输出 ==========\n\nfunction logRequest(\n  metrics: MonitoringMetrics,\n  slowThreshold: number,\n  enabled: boolean\n) {\n  if (!enabled) return;\n\n  const status = metrics.statusCode < 400 ? \"✅\" : \"❌\";\n  const speed = metrics.totalTime > slowThreshold ? \"🐌\" : \"⚡\";\n\n  console.log(\n    `${status} ${metrics.method} ${metrics.path} - ${metrics.statusCode} (${speed} ${metrics.totalTime.toFixed(2)}ms)`\n  );\n}\n\n// ========== 主函数 ==========\n\nconst defaultConfig: Required<MonitoringConfig> = {\n  enabled: true,\n  console: true,\n  slowThreshold: 1000,\n  maxRecords: 1000,\n  samplingRate: 1,\n  excludePaths: [],\n  tags: { framework: \"vafast\" },\n  onRequest: () => {},\n  onSlowRequest: () => {},\n};\n\n/**\n * 为 Server 添加监控能力\n *\n * @example\n * ```ts\n * const server = new Server(routes)\n * const monitored = withMonitoring(server, {\n *   slowThreshold: 500,\n *   excludePaths: ['/health'],\n *   onSlowRequest: (m) => console.warn('Slow!', m.path)\n * })\n *\n * // 获取完整状态\n * const status = monitored.getMonitoringStatus()\n * console.log(`P99: ${status.p99}ms`)\n * console.log(`RPS: ${status.rps}`)\n * console.log(`Last 1min errors: ${status.timeWindows.last1min.errorRate}`)\n *\n * // 单独获取 RPS\n * console.log(`Current RPS: ${monitored.getRPS()}`)\n *\n * // 自定义时间窗口\n * const last30sec = monitored.getTimeWindowStats(30000)\n * ```\n */\nexport function withMonitoring(\n  server: Server,\n  config: MonitoringConfig = {}\n): MonitoredServer {\n  const finalConfig = { ...defaultConfig, ...config };\n  const state = createMonitorState(finalConfig);\n  const originalFetch = server.fetch.bind(server);\n\n  if (finalConfig.enabled && finalConfig.console) {\n    console.log(\"✅ Monitoring enabled\");\n    console.log(`📊 Config:`, {\n      slowThreshold: `${finalConfig.slowThreshold}ms`,\n      maxRecords: finalConfig.maxRecords,\n      samplingRate: finalConfig.samplingRate,\n      excludePaths: finalConfig.excludePaths,\n    });\n  }\n\n  const monitoredFetch = async (req: Request): Promise<Response> => {\n    if (!finalConfig.enabled) {\n      return originalFetch(req);\n    }\n\n    const { pathname } = new URL(req.url);\n\n    if (shouldExclude(pathname, finalConfig.excludePaths)) {\n      return originalFetch(req);\n    }\n\n    if (finalConfig.samplingRate < 1 && Math.random() > finalConfig.samplingRate) {\n      return originalFetch(req);\n    }\n\n    const startTime = performance.now();\n    const requestId = generateRequestId();\n    const method = req.method;\n\n    let statusCode = 500;\n    try {\n      const response = await originalFetch(req);\n      statusCode = response.status;\n      return response;\n    } finally {\n      const totalTime = performance.now() - startTime;\n      const metrics: MonitoringMetrics = {\n        requestId,\n        method,\n        path: pathname,\n        statusCode,\n        totalTime,\n        timestamp: Date.now(),\n        memoryUsage: getMemoryInfo(),\n      };\n\n      state.addMetrics(metrics);\n      logRequest(metrics, finalConfig.slowThreshold, finalConfig.console);\n\n      finalConfig.onRequest(metrics);\n      if (totalTime > finalConfig.slowThreshold) {\n        finalConfig.onSlowRequest(metrics);\n      }\n    }\n  };\n\n  return {\n    ...server,\n    fetch: monitoredFetch,\n    getMonitoringStatus: state.getStatus,\n    getMonitoringMetrics: state.getMetrics,\n    getPathStats: state.getPathStats,\n    getTimeWindowStats: state.getTimeWindowStats,\n    getRPS: state.getRPS,\n    getStatusCodeDistribution: state.getStatusCodeDistribution,\n    resetMonitoring: state.reset,\n  } as MonitoredServer;\n}\n\n/**\n * 创建带监控的 Server（便捷函数）\n */\nexport function createMonitoredServer(\n  ServerClass: typeof Server,\n  routes: ConstructorParameters<typeof Server>[0],\n  config?: MonitoringConfig\n): MonitoredServer {\n  const server = new ServerClass(routes);\n  return withMonitoring(server, config);\n}\n"],"mappings":"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"}
+{"version":3,"file":"native-monitor.mjs","names":[],"sources":["../../src/monitoring/native-monitor.ts"],"sourcesContent":["/**\n * 原生监控模块（零外部依赖）\n *\n * 特性：\n * - P50/P95/P99 百分位数统计\n * - 按路径分组统计\n * - 时间窗口统计（1分钟/5分钟/1小时）\n * - RPS 计算（每秒请求数）\n * - 状态码分布\n * - 环形缓冲区（内存友好）\n * - 采样率控制\n * - 路径排除\n * - 自定义回调\n */\n\nimport type { Server } from \"../server\";\n\n// ========== 类型定义 ==========\n\n/** 监控配置 */\nexport interface MonitoringConfig {\n  /** 是否启用监控，默认 true */\n  enabled?: boolean;\n  /** 是否输出到控制台，默认 true */\n  console?: boolean;\n  /** 慢请求阈值（毫秒），默认 1000 */\n  slowThreshold?: number;\n  /** 最大记录数，默认 1000 */\n  maxRecords?: number;\n  /** 采样率 0-1，默认 1（全部记录） */\n  samplingRate?: number;\n  /** 排除的路径（不记录） */\n  excludePaths?: string[];\n  /** 自定义标签 */\n  tags?: Record<string, string>;\n  /** 请求完成回调 */\n  onRequest?: (metrics: MonitoringMetrics) => void;\n  /** 慢请求回调 */\n  onSlowRequest?: (metrics: MonitoringMetrics) => void;\n}\n\n/** 监控指标 */\nexport interface MonitoringMetrics {\n  requestId: string;\n  method: string;\n  path: string;\n  statusCode: number;\n  totalTime: number;\n  timestamp: number;\n  memoryUsage: MemoryInfo;\n}\n\n/** 内存信息 */\nexport interface MemoryInfo {\n  heapUsed: number;\n  heapTotal: number;\n}\n\n/** 路径统计 */\nexport interface PathStats {\n  count: number;\n  totalTime: number;\n  avgTime: number;\n  minTime: number;\n  maxTime: number;\n  errorCount: number;\n}\n\n/** 时间窗口统计 */\nexport interface TimeWindowStats {\n  /** 请求数 */\n  requests: number;\n  /** 成功数 */\n  successful: number;\n  /** 失败数 */\n  failed: number;\n  /** 错误率 */\n  errorRate: number;\n  /** 平均响应时间 */\n  avgTime: number;\n  /** RPS（每秒请求数） */\n  rps: number;\n}\n\n/** 状态码分布 */\nexport interface StatusCodeDistribution {\n  /** 2xx 成功 */\n  \"2xx\": number;\n  /** 3xx 重定向 */\n  \"3xx\": number;\n  /** 4xx 客户端错误 */\n  \"4xx\": number;\n  /** 5xx 服务器错误 */\n  \"5xx\": number;\n  /** 详细分布 */\n  detail: Record<number, number>;\n}\n\n/** 监控状态 */\nexport interface MonitoringStatus {\n  enabled: boolean;\n  /** 服务运行时间（毫秒） */\n  uptime: number;\n  totalRequests: number;\n  successfulRequests: number;\n  failedRequests: number;\n  errorRate: number;\n  /** 平均响应时间（毫秒） */\n  avgResponseTime: number;\n  /** P50 响应时间（毫秒） */\n  p50: number;\n  /** P95 响应时间（毫秒） */\n  p95: number;\n  /** P99 响应时间（毫秒） */\n  p99: number;\n  /** 最小响应时间 */\n  minTime: number;\n  /** 最大响应时间 */\n  maxTime: number;\n  /** 当前 RPS */\n  rps: number;\n  /** 状态码分布 */\n  statusCodes: StatusCodeDistribution;\n  /** 时间窗口统计 */\n  timeWindows: {\n    /** 最近 1 分钟 */\n    last1min: TimeWindowStats;\n    /** 最近 5 分钟 */\n    last5min: TimeWindowStats;\n    /** 最近 1 小时 */\n    last1hour: TimeWindowStats;\n  };\n  /** 按路径统计 */\n  byPath: Record<string, PathStats>;\n  /** 内存使用 */\n  memoryUsage: {\n    heapUsed: string;\n    heapTotal: string;\n  };\n  /** 最近请求 */\n  recentRequests: MonitoringMetrics[];\n}\n\n/** 带监控的 Server */\nexport interface MonitoredServer extends Server {\n  getMonitoringStatus(): MonitoringStatus;\n  getMonitoringMetrics(): MonitoringMetrics[];\n  getPathStats(path: string): PathStats | undefined;\n  getTimeWindowStats(windowMs: number): TimeWindowStats;\n  getRPS(): number;\n  getStatusCodeDistribution(): StatusCodeDistribution;\n  resetMonitoring(): void;\n}\n\n// ========== 常量 ==========\n\nconst ONE_MINUTE = 60 * 1000;\nconst FIVE_MINUTES = 5 * 60 * 1000;\nconst ONE_HOUR = 60 * 60 * 1000;\n\n// ========== 环形缓冲区 ==========\n\nfunction createRingBuffer<T>(capacity: number) {\n  const buffer: T[] = new Array(capacity);\n  let head = 0;\n  let size = 0;\n\n  return {\n    push(item: T) {\n      buffer[head % capacity] = item;\n      head++;\n      if (size < capacity) size++;\n    },\n\n    toArray(): T[] {\n      if (size === 0) return [];\n      if (size < capacity) {\n        return buffer.slice(0, size);\n      }\n      const start = head % capacity;\n      return [...buffer.slice(start), ...buffer.slice(0, start)];\n    },\n\n    getSize: () => size,\n\n    clear() {\n      head = 0;\n      size = 0;\n    },\n\n    recent(n: number): T[] {\n      const arr = this.toArray();\n      return arr.slice(-n);\n    },\n    };\n}\n\n// ========== 工具函数 ==========\n\nfunction generateRequestId(): string {\n  return `req_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;\n}\n\nfunction getMemoryInfo(): MemoryInfo {\n  if (typeof process !== \"undefined\" && process.memoryUsage) {\n    const mem = process.memoryUsage();\n    return { heapUsed: mem.heapUsed, heapTotal: mem.heapTotal };\n  }\n  return { heapUsed: 0, heapTotal: 0 };\n}\n\nfunction formatMemory(bytes: number): string {\n  return (bytes / 1024 / 1024).toFixed(2) + \"MB\";\n    }\n\nfunction percentile(sorted: number[], p: number): number {\n  if (sorted.length === 0) return 0;\n  const index = Math.ceil((p / 100) * sorted.length) - 1;\n  return sorted[Math.max(0, index)];\n}\n\nfunction shouldExclude(path: string, excludePaths: string[]): boolean {\n  return excludePaths.some(\n    (p) =>\n      path === p ||\n      path.startsWith(p + \"/\") ||\n      (p.endsWith(\"*\") && path.startsWith(p.slice(0, -1)))\n  );\n    }\n\nfunction getStatusCodeCategory(code: number): \"2xx\" | \"3xx\" | \"4xx\" | \"5xx\" {\n  if (code >= 200 && code < 300) return \"2xx\";\n  if (code >= 300 && code < 400) return \"3xx\";\n  if (code >= 400 && code < 500) return \"4xx\";\n  return \"5xx\";\n}\n\n// ========== 监控状态管理 ==========\n\nfunction createMonitorState(config: Required<MonitoringConfig>) {\n  const buffer = createRingBuffer<MonitoringMetrics>(config.maxRecords);\n  const pathStats = new Map<string, PathStats>();\n  const startTime = Date.now();\n\n  /** 获取时间窗口内的指标 */\n  function getMetricsInWindow(windowMs: number): MonitoringMetrics[] {\n    const now = Date.now();\n    const cutoff = now - windowMs;\n    return buffer.toArray().filter((m) => m.timestamp >= cutoff);\n  }\n\n  /** 计算时间窗口统计 */\n  function calcTimeWindowStats(windowMs: number): TimeWindowStats {\n    const metrics = getMetricsInWindow(windowMs);\n    const count = metrics.length;\n\n    if (count === 0) {\n      return {\n        requests: 0,\n        successful: 0,\n        failed: 0,\n        errorRate: 0,\n        avgTime: 0,\n        rps: 0,\n      };\n    }\n\n    const successful = metrics.filter((m) => m.statusCode < 400).length;\n    const failed = count - successful;\n    const avgTime = metrics.reduce((sum, m) => sum + m.totalTime, 0) / count;\n\n    // 计算实际时间跨度（用于 RPS）\n    const timestamps = metrics.map((m) => m.timestamp);\n    const actualWindow = Math.max(...timestamps) - Math.min(...timestamps);\n    const effectiveWindow = Math.max(actualWindow, 1000); // 至少 1 秒\n    const rps = (count / effectiveWindow) * 1000;\n\n    return {\n      requests: count,\n      successful,\n      failed,\n      errorRate: failed / count,\n      avgTime: Number(avgTime.toFixed(2)),\n      rps: Number(rps.toFixed(2)),\n    };\n  }\n\n  /** 计算状态码分布 */\n  function calcStatusCodeDistribution(): StatusCodeDistribution {\n    const metrics = buffer.toArray();\n    const dist: StatusCodeDistribution = {\n      \"2xx\": 0,\n      \"3xx\": 0,\n      \"4xx\": 0,\n      \"5xx\": 0,\n      detail: {},\n    };\n\n    for (const m of metrics) {\n      const category = getStatusCodeCategory(m.statusCode);\n      dist[category]++;\n      dist.detail[m.statusCode] = (dist.detail[m.statusCode] || 0) + 1;\n    }\n\n    return dist;\n  }\n\n  /** 计算当前 RPS（基于最近 10 秒） */\n  function calcCurrentRPS(): number {\n    const metrics = getMetricsInWindow(10000); // 最近 10 秒\n    if (metrics.length === 0) return 0;\n    return Number((metrics.length / 10).toFixed(2));\n  }\n\n  return {\n    addMetrics(m: MonitoringMetrics) {\n      buffer.push(m);\n\n      // 更新路径统计\n      const stats = pathStats.get(m.path) || {\n        count: 0,\n        totalTime: 0,\n        avgTime: 0,\n        minTime: Infinity,\n        maxTime: 0,\n        errorCount: 0,\n      };\n\n      stats.count++;\n      stats.totalTime += m.totalTime;\n      stats.avgTime = stats.totalTime / stats.count;\n      stats.minTime = Math.min(stats.minTime, m.totalTime);\n      stats.maxTime = Math.max(stats.maxTime, m.totalTime);\n      if (m.statusCode >= 400) stats.errorCount++;\n\n      pathStats.set(m.path, stats);\n    },\n\n    getMetrics: () => buffer.toArray(),\n\n    getPathStats: (path: string) => pathStats.get(path),\n\n    getTimeWindowStats: calcTimeWindowStats,\n\n    getRPS: calcCurrentRPS,\n\n    getStatusCodeDistribution: calcStatusCodeDistribution,\n\n    reset() {\n      buffer.clear();\n      pathStats.clear();\n    },\n\n    getStatus(): MonitoringStatus {\n      const metrics = buffer.toArray();\n      const total = metrics.length;\n\n      if (total === 0) {\n        return {\n          enabled: config.enabled,\n          uptime: Date.now() - startTime,\n          totalRequests: 0,\n          successfulRequests: 0,\n          failedRequests: 0,\n          errorRate: 0,\n          avgResponseTime: 0,\n          p50: 0,\n          p95: 0,\n          p99: 0,\n          minTime: 0,\n          maxTime: 0,\n          rps: 0,\n          statusCodes: { \"2xx\": 0, \"3xx\": 0, \"4xx\": 0, \"5xx\": 0, detail: {} },\n          timeWindows: {\n            last1min: { requests: 0, successful: 0, failed: 0, errorRate: 0, avgTime: 0, rps: 0 },\n            last5min: { requests: 0, successful: 0, failed: 0, errorRate: 0, avgTime: 0, rps: 0 },\n            last1hour: { requests: 0, successful: 0, failed: 0, errorRate: 0, avgTime: 0, rps: 0 },\n          },\n          byPath: {},\n          memoryUsage: { heapUsed: formatMemory(0), heapTotal: formatMemory(0) },\n          recentRequests: [],\n        };\n      }\n\n      const successful = metrics.filter((m) => m.statusCode < 400).length;\n      const failed = total - successful;\n\n      const times = metrics.map((m) => m.totalTime);\n      const sortedTimes = [...times].sort((a, b) => a - b);\n      const avgTime = times.reduce((a, b) => a + b, 0) / total;\n\n      const mem = getMemoryInfo();\n\n      const byPath: Record<string, PathStats> = {};\n      pathStats.forEach((stats, path) => {\n        byPath[path] = { ...stats, minTime: stats.minTime === Infinity ? 0 : stats.minTime };\n      });\n\n      return {\n        enabled: config.enabled,\n        uptime: Date.now() - startTime,\n        totalRequests: total,\n        successfulRequests: successful,\n        failedRequests: failed,\n        errorRate: Number((failed / total).toFixed(4)),\n        avgResponseTime: Number(avgTime.toFixed(2)),\n        p50: Number(percentile(sortedTimes, 50).toFixed(2)),\n        p95: Number(percentile(sortedTimes, 95).toFixed(2)),\n        p99: Number(percentile(sortedTimes, 99).toFixed(2)),\n        minTime: Number(sortedTimes[0].toFixed(2)),\n        maxTime: Number(sortedTimes[sortedTimes.length - 1].toFixed(2)),\n        rps: calcCurrentRPS(),\n        statusCodes: calcStatusCodeDistribution(),\n        timeWindows: {\n          last1min: calcTimeWindowStats(ONE_MINUTE),\n          last5min: calcTimeWindowStats(FIVE_MINUTES),\n          last1hour: calcTimeWindowStats(ONE_HOUR),\n        },\n        byPath,\n        memoryUsage: {\n          heapUsed: formatMemory(mem.heapUsed),\n          heapTotal: formatMemory(mem.heapTotal),\n        },\n        recentRequests: buffer.recent(5),\n      };\n    },\n  };\n}\n\n// ========== 日志输出 ==========\n\nfunction logRequest(\n  metrics: MonitoringMetrics,\n  slowThreshold: number,\n  enabled: boolean\n) {\n  if (!enabled) return;\n\n  const status = metrics.statusCode < 400 ? \"✅\" : \"❌\";\n  const speed = metrics.totalTime > slowThreshold ? \"🐌\" : \"⚡\";\n\n  console.log(\n    `${status} ${metrics.method} ${metrics.path} - ${metrics.statusCode} (${speed} ${metrics.totalTime.toFixed(2)}ms)`\n  );\n    }\n\n// ========== 主函数 ==========\n\nconst defaultConfig: Required<MonitoringConfig> = {\n  enabled: true,\n  console: true,\n  slowThreshold: 1000,\n  maxRecords: 1000,\n  samplingRate: 1,\n  excludePaths: [],\n  tags: { framework: \"vafast\" },\n  onRequest: () => {},\n  onSlowRequest: () => {},\n};\n\n/**\n * 为 Server 添加监控能力\n *\n * @example\n * ```ts\n * const server = new Server(routes)\n * const monitored = withMonitoring(server, {\n *   slowThreshold: 500,\n *   excludePaths: ['/health'],\n *   onSlowRequest: (m) => console.warn('Slow!', m.path)\n * })\n *\n * // 获取完整状态\n * const status = monitored.getMonitoringStatus()\n * console.log(`P99: ${status.p99}ms`)\n * console.log(`RPS: ${status.rps}`)\n * console.log(`Last 1min errors: ${status.timeWindows.last1min.errorRate}`)\n *\n * // 单独获取 RPS\n * console.log(`Current RPS: ${monitored.getRPS()}`)\n *\n * // 自定义时间窗口\n * const last30sec = monitored.getTimeWindowStats(30000)\n * ```\n */\nexport function withMonitoring(\n  server: Server,\n  config: MonitoringConfig = {}\n): MonitoredServer {\n  const finalConfig = { ...defaultConfig, ...config };\n  const state = createMonitorState(finalConfig);\n  const originalFetch = server.fetch.bind(server);\n\n  if (finalConfig.enabled && finalConfig.console) {\n    console.log(\"✅ Monitoring enabled\");\n    console.log(`📊 Config:`, {\n      slowThreshold: `${finalConfig.slowThreshold}ms`,\n      maxRecords: finalConfig.maxRecords,\n      samplingRate: finalConfig.samplingRate,\n      excludePaths: finalConfig.excludePaths,\n    });\n  }\n\n  const monitoredFetch = async (req: Request): Promise<Response> => {\n    if (!finalConfig.enabled) {\n      return originalFetch(req);\n    }\n\n    const { pathname } = new URL(req.url);\n\n    if (shouldExclude(pathname, finalConfig.excludePaths)) {\n      return originalFetch(req);\n    }\n\n    if (finalConfig.samplingRate < 1 && Math.random() > finalConfig.samplingRate) {\n      return originalFetch(req);\n    }\n\n    const startTime = performance.now();\n    const requestId = generateRequestId();\n    const method = req.method;\n\n    let statusCode = 500;\n    try {\n      const response = await originalFetch(req);\n      statusCode = response.status;\n      return response;\n    } finally {\n      const totalTime = performance.now() - startTime;\n      const metrics: MonitoringMetrics = {\n        requestId,\n        method,\n        path: pathname,\n        statusCode,\n        totalTime,\n        timestamp: Date.now(),\n        memoryUsage: getMemoryInfo(),\n      };\n\n      state.addMetrics(metrics);\n      logRequest(metrics, finalConfig.slowThreshold, finalConfig.console);\n\n      finalConfig.onRequest(metrics);\n      if (totalTime > finalConfig.slowThreshold) {\n        finalConfig.onSlowRequest(metrics);\n      }\n    }\n  };\n\n  return {\n    ...server,\n    fetch: monitoredFetch,\n    getMonitoringStatus: state.getStatus,\n    getMonitoringMetrics: state.getMetrics,\n    getPathStats: state.getPathStats,\n    getTimeWindowStats: state.getTimeWindowStats,\n    getRPS: state.getRPS,\n    getStatusCodeDistribution: state.getStatusCodeDistribution,\n    resetMonitoring: state.reset,\n  } as MonitoredServer;\n}\n\n/**\n * 创建带监控的 Server（便捷函数）\n */\nexport function createMonitoredServer(\n  ServerClass: typeof Server,\n  routes: ConstructorParameters<typeof Server>[0],\n  config?: MonitoringConfig\n): MonitoredServer {\n  const server = new ServerClass(routes);\n  return withMonitoring(server, config);\n}\n"],"mappings":"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"}

package/package.json

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