vafast 0.4.4 → 0.4.8

package/dist/middleware-KXEoefLX.d.mts

@@ -0,0 +1,23 @@
+import { o as Middleware, r as Handler } from "./types-D1PUFkda.mjs";
+
+//#region src/middleware.d.ts
+/** 中间件类型：使用 next() 传递给下一个处理 */
+/** Vafast 自定义错误类型 */
+declare class VafastError extends Error {
+  status: number;
+  type: string;
+  expose: boolean;
+  constructor(message: string, options?: {
+    status?: number;
+    type?: string;
+    expose?: boolean;
+    cause?: unknown;
+  });
+}
+/**
+ * 组合类型: 自动注入错误处理器进行中间件组合
+ */
+declare function composeMiddleware(middleware: Middleware[], finalHandler: Handler): (req: Request) => Promise<Response>;
+//#endregion
+export { composeMiddleware as n, VafastError as t };
+//# sourceMappingURL=middleware-KXEoefLX.d.mts.map

package/dist/middleware.d.mts

@@ -1,25 +1,4 @@
-import { o as Middleware, r as Handler } from "./types-DuTa8AVN.mjs";
-import "./schema-CPQudJpE.mjs";
-import "./index-CzItj62a.mjs";
-
-//#region src/middleware.d.ts
-/** 中间件类型：使用 next() 传递给下一个处理 */
-/** Vafast 自定义错误类型 */
-declare class VafastError extends Error {
-  status: number;
-  type: string;
-  expose: boolean;
-  constructor(message: string, options?: {
-    status?: number;
-    type?: string;
-    expose?: boolean;
-    cause?: unknown;
-  });
-}
-/**
- * 组合类型: 自动注入错误处理器进行中间件组合
- */
-declare function composeMiddleware(middleware: Middleware[], finalHandler: Handler): (req: Request) => Promise<Response>;
-//#endregion
-export { VafastError, composeMiddleware };
-//# sourceMappingURL=middleware.d.mts.map
+import "./schema-B6DFN5c2.mjs";
+import "./index-CREkvfw9.mjs";
+import { n as composeMiddleware, t as VafastError } from "./middleware-KXEoefLX.mjs";
+export { VafastError, composeMiddleware };

package/dist/middleware.mjs

@@ -1,4 +1,3 @@
-import { n as composeMiddleware, r as init_middleware, t as VafastError } from "./middleware-Byp3Hjae.mjs";
+import { n as composeMiddleware, t as VafastError } from "./middleware-CewKbtb4.mjs";
 
-init_middleware();
 export { VafastError, composeMiddleware };

package/dist/monitoring/index.d.mts

@@ -1,33 +1,8 @@
-import "../schema-CPQudJpE.mjs";
-import "../index-CzItj62a.mjs";
-import "../base-server-DvGS6ATg.mjs";
-import "../server-D9gjszHe.mjs";
-import "../component-server-CGzU4bss.mjs";
-import "../index-Ci52vt55.mjs";
-import { AggregatedMetrics, BaseMetrics, MonitoringConfig, MonitoringEvent, PerformanceMetrics, PerformanceReport } from "./types.mjs";
-import { MonitoredServer, NativeMonitoringConfig, NativeMonitoringMetrics, createMonitoredServer, withMonitoring } from "./native-monitor.mjs";
-
-//#region src/monitoring/index.d.ts
-declare const defaultMonitoringConfig: {
-  enabled: boolean;
-  console: boolean;
-  slowThreshold: number;
-  errorThreshold: number;
-  tags: {
-    framework: string;
-    version: string;
-  };
-};
-declare function createMonitoringConfig(config?: Partial<typeof defaultMonitoringConfig>): {
-  enabled: boolean;
-  console: boolean;
-  slowThreshold: number;
-  errorThreshold: number;
-  tags: {
-    framework: string;
-    version: string;
-  };
-};
-//#endregion
-export { AggregatedMetrics, BaseMetrics, MonitoredServer, MonitoringConfig, MonitoringEvent, NativeMonitoringConfig, NativeMonitoringMetrics, PerformanceMetrics, PerformanceReport, createMonitoredServer, createMonitoringConfig, defaultMonitoringConfig, withMonitoring };
-//# sourceMappingURL=index.d.mts.map
+import "../schema-B6DFN5c2.mjs";
+import "../index-CREkvfw9.mjs";
+import "../base-server-DLxtulAO.mjs";
+import "../server-DGA3dd5s.mjs";
+import "../component-server-JqpDC7wy.mjs";
+import "../index-CEfOqqvd.mjs";
+import { MemoryInfo, MonitoredServer, MonitoringConfig, MonitoringMetrics, MonitoringStatus, PathStats, StatusCodeDistribution, TimeWindowStats, createMonitoredServer, withMonitoring } from "./native-monitor.mjs";
+export { type MemoryInfo, type MonitoredServer, type MonitoringConfig, type MonitoringMetrics, type MonitoringStatus, type PathStats, type StatusCodeDistribution, type TimeWindowStats, createMonitoredServer, withMonitoring };

package/dist/monitoring/index.mjs

@@ -1,27 +1,3 @@
-import "../dependency-manager-Czg7Po2j.mjs";
-import "../component-server-DAbIyIPI.mjs";
-import "../server-Cbd3Ia51.mjs";
-import "./types.mjs";
 import { createMonitoredServer, withMonitoring } from "./native-monitor.mjs";
 
-//#region src/monitoring/index.ts
-const defaultMonitoringConfig = {
-	enabled: true,
-	console: true,
-	slowThreshold: 1e3,
-	errorThreshold: .05,
-	tags: {
-		framework: "vafast",
-		version: "2.0.0"
-	}
-};
-function createMonitoringConfig(config = {}) {
-	return {
-		...defaultMonitoringConfig,
-		...config
-	};
-}
-
-//#endregion
-export { createMonitoredServer, createMonitoringConfig, defaultMonitoringConfig, withMonitoring };
-//# sourceMappingURL=index.mjs.map
+export { createMonitoredServer, withMonitoring };

package/dist/monitoring/native-monitor.d.mts

@@ -1,48 +1,169 @@
-import "../schema-CPQudJpE.mjs";
-import "../index-CzItj62a.mjs";
-import "../base-server-DvGS6ATg.mjs";
-import { t as Server } from "../server-D9gjszHe.mjs";
-import "../component-server-CGzU4bss.mjs";
-import "../index-Ci52vt55.mjs";
+import "../schema-B6DFN5c2.mjs";
+import "../index-CREkvfw9.mjs";
+import "../base-server-DLxtulAO.mjs";
+import { t as Server } from "../server-DGA3dd5s.mjs";
+import "../component-server-JqpDC7wy.mjs";
+import "../index-CEfOqqvd.mjs";
 
 //#region src/monitoring/native-monitor.d.ts
-/**
-* 原生监控装饰器
-*
-* 通过装饰器模式为 Server 添加监控能力，完全不入侵原类
-*
-* @author Framework Team
-* @version 2.0.0
-* @license MIT
-*/
-interface NativeMonitoringConfig {
+
+/** 监控配置 */
+interface MonitoringConfig {
+  /** 是否启用监控，默认 true */
   enabled?: boolean;
+  /** 是否输出到控制台，默认 true */
   console?: boolean;
+  /** 慢请求阈值（毫秒），默认 1000 */
   slowThreshold?: number;
-  errorThreshold?: number;
+  /** 最大记录数，默认 1000 */
+  maxRecords?: number;
+  /** 采样率 0-1，默认 1（全部记录） */
+  samplingRate?: number;
+  /** 排除的路径（不记录） */
+  excludePaths?: string[];
+  /** 自定义标签 */
   tags?: Record<string, string>;
+  /** 请求完成回调 */
+  onRequest?: (metrics: MonitoringMetrics) => void;
+  /** 慢请求回调 */
+  onSlowRequest?: (metrics: MonitoringMetrics) => void;
 }
-interface NativeMonitoringMetrics {
+/** 监控指标 */
+interface MonitoringMetrics {
   requestId: string;
   method: string;
   path: string;
   statusCode: number;
   totalTime: number;
   timestamp: number;
+  memoryUsage: MemoryInfo;
+}
+/** 内存信息 */
+interface MemoryInfo {
+  heapUsed: number;
+  heapTotal: number;
+}
+/** 路径统计 */
+interface PathStats {
+  count: number;
+  totalTime: number;
+  avgTime: number;
+  minTime: number;
+  maxTime: number;
+  errorCount: number;
+}
+/** 时间窗口统计 */
+interface TimeWindowStats {
+  /** 请求数 */
+  requests: number;
+  /** 成功数 */
+  successful: number;
+  /** 失败数 */
+  failed: number;
+  /** 错误率 */
+  errorRate: number;
+  /** 平均响应时间 */
+  avgTime: number;
+  /** RPS（每秒请求数） */
+  rps: number;
+}
+/** 状态码分布 */
+interface StatusCodeDistribution {
+  /** 2xx 成功 */
+  "2xx": number;
+  /** 3xx 重定向 */
+  "3xx": number;
+  /** 4xx 客户端错误 */
+  "4xx": number;
+  /** 5xx 服务器错误 */
+  "5xx": number;
+  /** 详细分布 */
+  detail: Record<number, number>;
+}
+/** 监控状态 */
+interface MonitoringStatus {
+  enabled: boolean;
+  /** 服务运行时间（毫秒） */
+  uptime: number;
+  totalRequests: number;
+  successfulRequests: number;
+  failedRequests: number;
+  errorRate: number;
+  /** 平均响应时间（毫秒） */
+  avgResponseTime: number;
+  /** P50 响应时间（毫秒） */
+  p50: number;
+  /** P95 响应时间（毫秒） */
+  p95: number;
+  /** P99 响应时间（毫秒） */
+  p99: number;
+  /** 最小响应时间 */
+  minTime: number;
+  /** 最大响应时间 */
+  maxTime: number;
+  /** 当前 RPS */
+  rps: number;
+  /** 状态码分布 */
+  statusCodes: StatusCodeDistribution;
+  /** 时间窗口统计 */
+  timeWindows: {
+    /** 最近 1 分钟 */
+    last1min: TimeWindowStats;
+    /** 最近 5 分钟 */
+    last5min: TimeWindowStats;
+    /** 最近 1 小时 */
+    last1hour: TimeWindowStats;
+  };
+  /** 按路径统计 */
+  byPath: Record<string, PathStats>;
+  /** 内存使用 */
   memoryUsage: {
-    heapUsed: number;
-    heapTotal: number;
+    heapUsed: string;
+    heapTotal: string;
   };
+  /** 最近请求 */
+  recentRequests: MonitoringMetrics[];
 }
+/** 带监控的 Server */
 interface MonitoredServer extends Server {
-  getMonitoringStatus(): any;
-  getMonitoringMetrics(): NativeMonitoringMetrics[];
+  getMonitoringStatus(): MonitoringStatus;
+  getMonitoringMetrics(): MonitoringMetrics[];
+  getPathStats(path: string): PathStats | undefined;
+  getTimeWindowStats(windowMs: number): TimeWindowStats;
+  getRPS(): number;
+  getStatusCodeDistribution(): StatusCodeDistribution;
   resetMonitoring(): void;
-  fetch: (req: Request) => Promise<Response>;
-  use: (mw: any) => void;
 }
-declare function withMonitoring(server: Server, config?: NativeMonitoringConfig): MonitoredServer;
-declare function createMonitoredServer(routes: any[], config?: NativeMonitoringConfig): MonitoredServer;
+/**
+ * 为 Server 添加监控能力
+ *
+ * @example
+ * ```ts
+ * const server = new Server(routes)
+ * const monitored = withMonitoring(server, {
+ *   slowThreshold: 500,
+ *   excludePaths: ['/health'],
+ *   onSlowRequest: (m) => console.warn('Slow!', m.path)
+ * })
+ *
+ * // 获取完整状态
+ * const status = monitored.getMonitoringStatus()
+ * console.log(`P99: ${status.p99}ms`)
+ * console.log(`RPS: ${status.rps}`)
+ * console.log(`Last 1min errors: ${status.timeWindows.last1min.errorRate}`)
+ *
+ * // 单独获取 RPS
+ * console.log(`Current RPS: ${monitored.getRPS()}`)
+ *
+ * // 自定义时间窗口
+ * const last30sec = monitored.getTimeWindowStats(30000)
+ * ```
+ */
+declare function withMonitoring(server: Server, config?: MonitoringConfig): MonitoredServer;
+/**
+ * 创建带监控的 Server（便捷函数）
+ */
+declare function createMonitoredServer(ServerClass: typeof Server, routes: ConstructorParameters<typeof Server>[0], config?: MonitoringConfig): MonitoredServer;
 //#endregion
-export { MonitoredServer, NativeMonitoringConfig, NativeMonitoringMetrics, createMonitoredServer, withMonitoring };
+export { MemoryInfo, MonitoredServer, MonitoringConfig, MonitoringMetrics, MonitoringStatus, PathStats, StatusCodeDistribution, TimeWindowStats, createMonitoredServer, withMonitoring };
 //# sourceMappingURL=native-monitor.d.mts.map