@dangao/bun-server 0.2.0 → 0.3.0

package/dist/core/context.d.ts

@@ -95,6 +95,12 @@ export declare class Context {
      * @returns 头值
      */
     getHeader(key: string): string | null;
+    /**
+     * 获取客户端 IP 地址
+     * 优先从 X-Forwarded-For 头获取（代理场景），否则从连接信息获取
+     * @returns 客户端 IP 地址
+     */
+    getClientIp(): string;
     /**
      * 设置响应头
      * @param key - 头名称

package/dist/core/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;;GAGG;AACH,qBAAa,OAAO;IAClB;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE3B;;OAEG;IACH,SAAgB,GAAG,EAAE,GAAG,CAAC;IAEzB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAE3C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,eAAe,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACI,UAAU,EAAE,MAAM,CAAO;IAEhC;;OAEG;IACI,KAAK,EAAE,gBAAgB,EAAE,CAAM;IAEtC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,CAAU;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAkB;gBAElB,OAAO,EAAE,OAAO;IAUnC;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQxC;;;OAGG;IACH,IAAW,IAAI,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,IAAW,IAAI,CAAC,IAAI,EAAE,OAAO,EAG5B;IAED;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI5C;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACI,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ;CA2BrE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;;GAGG;AACH,qBAAa,OAAO;IAClB;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE3B;;OAEG;IACH,SAAgB,GAAG,EAAE,GAAG,CAAC;IAEzB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAE3C;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACI,eAAe,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACI,UAAU,EAAE,MAAM,CAAO;IAEhC;;OAEG;IACI,KAAK,EAAE,gBAAgB,EAAE,CAAM;IAEtC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,CAAU;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAkB;gBAElB,OAAO,EAAE,OAAO;IAUnC;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQxC;;;OAGG;IACH,IAAW,IAAI,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,IAAW,IAAI,CAAC,IAAI,EAAE,OAAO,EAG5B;IAED;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAmB5B;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACI,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ;CA2BrE"}

package/dist/index.d.ts

@@ -12,9 +12,9 @@ export { Injectable, Inject } from './di/decorators';
 export { Lifecycle, type ProviderConfig, type DependencyMetadata } from './di/types';
 export { Module, type ModuleMetadata, type ModuleProvider, type ModuleClass, } from './di/module';
 export { ModuleRegistry } from './di/module-registry';
-export { UseMiddleware, MiddlewarePipeline } from './middleware';
+export { UseMiddleware, RateLimit, MiddlewarePipeline } from './middleware';
 export type { Middleware, NextFunction } from './middleware';
-export { createLoggerMiddleware, createRequestLoggingMiddleware, createErrorHandlingMiddleware, createCorsMiddleware, createFileUploadMiddleware, createStaticFileMiddleware, } from './middleware/builtin';
+export { createLoggerMiddleware, createRequestLoggingMiddleware, createErrorHandlingMiddleware, createCorsMiddleware, createFileUploadMiddleware, createStaticFileMiddleware, createRateLimitMiddleware, createTokenKeyGenerator, createUserKeyGenerator, type RateLimitOptions, type RateLimitStore, } from './middleware/builtin';
 export { Validate, IsString, IsNumber, IsEmail, IsOptional, MinLength, ValidationError, type ValidationIssue, } from './validation';
 export { HttpException, BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, InternalServerErrorException, ExceptionFilterRegistry, type ExceptionFilter, } from './error';
 export { WebSocketGateway, OnOpen, OnMessage, OnClose, WebSocketGatewayRegistry, type WebSocketConnectionData, } from './websocket';
@@ -23,6 +23,7 @@ export { SwaggerExtension, SwaggerModule, SwaggerGenerator, createSwaggerUIMiddl
 export { SecurityModule, SecurityContextHolder, AuthenticationManager, RoleBasedAccessDecisionManager, JwtAuthenticationProvider, OAuth2AuthenticationProvider, createSecurityFilter, type SecurityModuleConfig, type SecurityConfig, type SecurityContext, type Authentication, type AuthenticationProvider, type AuthenticationRequest, type Principal, type Credentials, type AccessDecisionManager, } from './security';
 export { ConfigModule, ConfigService, CONFIG_SERVICE_TOKEN, type ConfigModuleOptions, } from './config';
 export { HealthModule, type HealthIndicator, type HealthIndicatorResult, type HealthStatus, type HealthModuleOptions, HEALTH_INDICATORS_TOKEN, HEALTH_OPTIONS_TOKEN, } from './health';
+export { MetricsModule, MetricsCollector, PrometheusFormatter, createHttpMetricsMiddleware, METRICS_SERVICE_TOKEN, METRICS_OPTIONS_TOKEN, type MetricsModuleOptions, type MetricType, type MetricLabels, type MetricValue, type MetricDataPoint, type CustomMetric, } from './metrics';
 export { JWTUtil, OAuth2Service, OAuth2Controller, Auth, getAuthMetadata, requiresAuth, checkRoles, OAUTH2_SERVICE_TOKEN, JWT_UTIL_TOKEN, type JWTConfig, type JWTPayload, type OAuth2Client, type OAuth2AuthorizationRequest, type OAuth2TokenRequest, type OAuth2TokenResponse, type UserInfo, type AuthContext, type AuthConfig, } from './auth';
 export { PerformanceHarness, StressTester, type BenchmarkResult, type StressResult, } from './testing/harness';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -525,6 +525,17 @@ class Context {
   getHeader(key) {
     return this.headers.get(key);
   }
+  getClientIp() {
+    const forwardedFor = this.getHeader("X-Forwarded-For");
+    if (forwardedFor) {
+      return forwardedFor.split(",")[0].trim();
+    }
+    const realIp = this.getHeader("X-Real-IP");
+    if (realIp) {
+      return realIp.trim();
+    }
+    return "unknown";
+  }
   setHeader(key, value) {
     this.responseHeaders.set(key, value);
   }
@@ -1325,6 +1336,112 @@ function getRouteMetadata(target) {
 }
 // src/middleware/decorators.ts
 import"reflect-metadata";
+
+// src/middleware/builtin/rate-limit.ts
+class MemoryRateLimitStore {
+  store = new Map;
+  async get(key) {
+    const entry = this.store.get(key);
+    if (!entry) {
+      return 0;
+    }
+    if (Date.now() > entry.resetTime) {
+      this.store.delete(key);
+      return 0;
+    }
+    return entry.count;
+  }
+  async increment(key, windowMs) {
+    const now = Date.now();
+    const entry = this.store.get(key);
+    if (!entry || now > entry.resetTime) {
+      const resetTime = now + windowMs;
+      this.store.set(key, { count: 1, resetTime });
+      return 1;
+    }
+    entry.count++;
+    return entry.count;
+  }
+  async reset(key) {
+    this.store.delete(key);
+  }
+  cleanup() {
+    const now = Date.now();
+    for (const [key, entry] of this.store.entries()) {
+      if (now > entry.resetTime) {
+        this.store.delete(key);
+      }
+    }
+  }
+}
+function defaultKeyGenerator(context) {
+  return `rate-limit:${context.getClientIp()}`;
+}
+function createRateLimitMiddleware(options) {
+  const {
+    max,
+    windowMs = 60000,
+    store = new MemoryRateLimitStore,
+    keyGenerator = defaultKeyGenerator,
+    skipSuccessfulRequests = false,
+    skipFailedRequests = false,
+    message = "Too Many Requests",
+    statusCode = 429,
+    standardHeaders = true,
+    legacyHeaders = true
+  } = options;
+  return async (context, next) => {
+    const key = await keyGenerator(context);
+    const currentCount = await store.increment(key, windowMs);
+    const remaining = Math.max(0, max - currentCount);
+    const resetTime = Date.now() + windowMs;
+    if (standardHeaders) {
+      context.setHeader("RateLimit-Limit", max.toString());
+      context.setHeader("RateLimit-Remaining", remaining.toString());
+      context.setHeader("RateLimit-Reset", Math.ceil(resetTime / 1000).toString());
+    }
+    if (legacyHeaders) {
+      context.setHeader("X-RateLimit-Limit", max.toString());
+      context.setHeader("X-RateLimit-Remaining", remaining.toString());
+      context.setHeader("X-RateLimit-Reset", Math.ceil(resetTime / 1000).toString());
+    }
+    if (currentCount > max) {
+      context.setStatus(statusCode);
+      return context.createResponse({
+        error: message,
+        retryAfter: Math.ceil(windowMs / 1000)
+      });
+    }
+    const response = await next();
+    const shouldSkip = skipSuccessfulRequests && response.status >= 200 && response.status < 300 || skipFailedRequests && response.status >= 400;
+    if (shouldSkip) {
+      const current = await store.get(key);
+      if (current > 0) {}
+    }
+    return response;
+  };
+}
+function createTokenKeyGenerator(tokenHeader = "Authorization") {
+  return (context) => {
+    const token = context.getHeader(tokenHeader);
+    if (token) {
+      const tokenValue = token.startsWith("Bearer ") ? token.substring(7) : token;
+      return `rate-limit:token:${tokenValue}`;
+    }
+    return defaultKeyGenerator(context);
+  };
+}
+function createUserKeyGenerator(getUserId) {
+  return (context) => {
+    const userId = getUserId(context);
+    if (userId) {
+      return `rate-limit:user:${userId}`;
+    }
+    return defaultKeyGenerator(context);
+  };
+}
+
+// src/middleware/decorators.ts
 var CLASS_MIDDLEWARE_METADATA_KEY = Symbol("middleware:class");
 var METHOD_MIDDLEWARE_METADATA_KEY = Symbol("middleware:method");
 function appendMiddlewareMetadata(target, propertyKey, middlewares) {
@@ -1344,6 +1461,12 @@ function UseMiddleware(...middlewares) {
     appendMiddlewareMetadata(propertyKey === undefined ? target : target, propertyKey, middlewares);
   };
 }
+function RateLimit(options) {
+  return function(target, propertyKey) {
+    const middleware = createRateLimitMiddleware(options);
+    appendMiddlewareMetadata(target, propertyKey, [middleware]);
+  };
+}
 function getClassMiddlewares(constructor) {
   return Reflect.getMetadata(CLASS_MIDDLEWARE_METADATA_KEY, constructor) || [];
 }
@@ -3489,6 +3612,297 @@ HealthModule = __legacyDecorateClassTS([
     providers: []
   })
 ], HealthModule);
+// src/metrics/collector.ts
+class MetricsCollector {
+  counters = new Map;
+  gauges = new Map;
+  histograms = new Map;
+  customMetrics = [];
+  registerCustomMetric(metric) {
+    this.customMetrics.push(metric);
+  }
+  incrementCounter(name, labels, value = 1) {
+    const key = this.getKey(name, labels);
+    const counterMap = this.counters.get(name) || new Map;
+    const current = counterMap.get(key) || 0;
+    counterMap.set(key, current + value);
+    this.counters.set(name, counterMap);
+  }
+  setGauge(name, labels, value) {
+    const key = this.getKey(name, labels);
+    const gaugeMap = this.gauges.get(name) || new Map;
+    gaugeMap.set(key, value);
+    this.gauges.set(name, gaugeMap);
+  }
+  observeHistogram(name, labels, value) {
+    const key = this.getKey(name, labels);
+    const histogramMap = this.histograms.get(name) || new Map;
+    const values = histogramMap.get(key) || [];
+    values.push(value);
+    histogramMap.set(key, values);
+    this.histograms.set(name, histogramMap);
+  }
+  async getAllDataPoints() {
+    const dataPoints = [];
+    for (const [name, counterMap] of this.counters.entries()) {
+      for (const [key, value] of counterMap.entries()) {
+        const labels = this.parseKey(key);
+        dataPoints.push({
+          name,
+          type: "counter",
+          value,
+          labels: labels && Object.keys(labels).length > 0 ? labels : undefined
+        });
+      }
+    }
+    for (const [name, gaugeMap] of this.gauges.entries()) {
+      for (const [key, value] of gaugeMap.entries()) {
+        const labels = this.parseKey(key);
+        dataPoints.push({
+          name,
+          type: "gauge",
+          value,
+          labels: labels && Object.keys(labels).length > 0 ? labels : undefined
+        });
+      }
+    }
+    for (const [name, histogramMap] of this.histograms.entries()) {
+      for (const [key, values] of histogramMap.entries()) {
+        const labels = this.parseKey(key);
+        const sum = values.reduce((a, b) => a + b, 0);
+        const count = values.length;
+        const buckets = this.calculateBuckets(values);
+        dataPoints.push({
+          name: `${name}_sum`,
+          type: "histogram",
+          value: sum,
+          labels: labels && Object.keys(labels).length > 0 ? labels : undefined
+        });
+        dataPoints.push({
+          name: `${name}_count`,
+          type: "histogram",
+          value: count,
+          labels: labels && Object.keys(labels).length > 0 ? labels : undefined
+        });
+        for (const [bucket, bucketCount] of Object.entries(buckets)) {
+          dataPoints.push({
+            name: `${name}_bucket`,
+            type: "histogram",
+            value: bucketCount,
+            labels: {
+              ...labels,
+              le: bucket
+            }
+          });
+        }
+      }
+    }
+    for (const metric of this.customMetrics) {
+      try {
+        const value = await metric.getValue();
+        dataPoints.push({
+          name: metric.name,
+          type: metric.type,
+          value,
+          help: metric.help
+        });
+      } catch (error) {
+        console.error(`Failed to collect custom metric ${metric.name}:`, error);
+      }
+    }
+    return dataPoints;
+  }
+  reset() {
+    this.counters.clear();
+    this.gauges.clear();
+    this.histograms.clear();
+  }
+  getKey(name, labels) {
+    if (!labels || Object.keys(labels).length === 0) {
+      return "";
+    }
+    const sortedLabels = Object.keys(labels).sort().map((key) => `${key}="${labels[key]}"`).join(",");
+    return `{${sortedLabels}}`;
+  }
+  parseKey(key) {
+    if (!key || key === "") {
+      return;
+    }
+    const labels = {};
+    const match = key.match(/\{([^}]+)\}/);
+    if (match) {
+      const labelPairs = match[1].split(",");
+      for (const pair of labelPairs) {
+        const [k, v] = pair.split("=");
+        if (k && v) {
+          labels[k.trim()] = v.trim().replace(/^"|"$/g, "");
+        }
+      }
+    }
+    return Object.keys(labels).length > 0 ? labels : undefined;
+  }
+  calculateBuckets(values) {
+    const defaultBuckets = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+    const buckets = {};
+    for (const bucket of defaultBuckets) {
+      buckets[bucket.toString()] = values.filter((v) => v <= bucket).length;
+    }
+    buckets["+Inf"] = values.length;
+    return buckets;
+  }
+}
+
+// src/metrics/prometheus.ts
+class PrometheusFormatter {
+  format(dataPoints) {
+    const lines = [];
+    const metricGroups = this.groupByMetricName(dataPoints);
+    for (const [metricName, points] of metricGroups.entries()) {
+      const help = points[0]?.help;
+      if (help) {
+        lines.push(`# HELP ${metricName} ${help}`);
+      }
+      const type = points[0]?.type;
+      if (type) {
+        lines.push(`# TYPE ${metricName} ${type}`);
+      }
+      for (const point of points) {
+        const labelString = this.formatLabels(point.labels);
+        const line = labelString ? `${point.name}${labelString} ${point.value}` : `${point.name} ${point.value}`;
+        lines.push(line);
+      }
+      lines.push("");
+    }
+    return lines.join(`
+`);
+  }
+  groupByMetricName(dataPoints) {
+    const groups = new Map;
+    for (const point of dataPoints) {
+      const name = point.name;
+      const existing = groups.get(name) || [];
+      existing.push(point);
+      groups.set(name, existing);
+    }
+    return groups;
+  }
+  formatLabels(labels) {
+    if (!labels || Object.keys(labels).length === 0) {
+      return "";
+    }
+    const labelPairs = Object.keys(labels).sort().map((key) => `${key}="${this.escapeLabelValue(labels[key])}"`).join(",");
+    return `{${labelPairs}}`;
+  }
+  escapeLabelValue(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n");
+  }
+}
+
+// src/metrics/types.ts
+var METRICS_SERVICE_TOKEN = Symbol("@dangao/bun-server:metrics:service");
+var METRICS_OPTIONS_TOKEN = Symbol("@dangao/bun-server:metrics:options");
+
+// src/metrics/controller.ts
+class MetricsController {
+  collector;
+  options;
+  formatter;
+  constructor(collector, options) {
+    this.collector = collector;
+    this.options = options;
+    this.formatter = new PrometheusFormatter;
+  }
+  async metrics() {
+    const dataPoints = await this.collector.getAllDataPoints();
+    const prometheusText = this.formatter.format(dataPoints);
+    return new Response(prometheusText, {
+      headers: {
+        "Content-Type": "text/plain; version=0.0.4; charset=utf-8"
+      }
+    });
+  }
+}
+__legacyDecorateClassTS([
+  GET("/metrics"),
+  __legacyMetadataTS("design:type", Function),
+  __legacyMetadataTS("design:paramtypes", []),
+  __legacyMetadataTS("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+], MetricsController.prototype, "metrics", null);
+MetricsController = __legacyDecorateClassTS([
+  Controller("/"),
+  __legacyDecorateParamTS(0, Inject(METRICS_SERVICE_TOKEN)),
+  __legacyDecorateParamTS(1, Inject(METRICS_OPTIONS_TOKEN)),
+  __legacyMetadataTS("design:paramtypes", [
+    typeof MetricsCollector === "undefined" ? Object : MetricsCollector,
+    typeof MetricsModuleOptions === "undefined" ? Object : MetricsModuleOptions
+  ])
+], MetricsController);
+
+// src/metrics/metrics-module.ts
+class MetricsModule {
+  static forRoot(options = {}) {
+    const providers2 = [];
+    const collector = new MetricsCollector;
+    if (options.customMetrics) {
+      for (const metric of options.customMetrics) {
+        collector.registerCustomMetric(metric);
+      }
+    }
+    providers2.push({
+      provide: METRICS_SERVICE_TOKEN,
+      useValue: collector
+    }, {
+      provide: METRICS_OPTIONS_TOKEN,
+      useValue: options
+    }, MetricsCollector);
+    const existingMetadata = Reflect.getMetadata(MODULE_METADATA_KEY, MetricsModule) || {};
+    const metadata = {
+      ...existingMetadata,
+      controllers: [...existingMetadata.controllers || [], MetricsController],
+      providers: [...existingMetadata.providers || [], ...providers2],
+      exports: [
+        ...existingMetadata.exports || [],
+        METRICS_SERVICE_TOKEN,
+        MetricsCollector
+      ]
+    };
+    Reflect.defineMetadata(MODULE_METADATA_KEY, metadata, MetricsModule);
+    return MetricsModule;
+  }
+}
+MetricsModule = __legacyDecorateClassTS([
+  Module({
+    controllers: [MetricsController],
+    providers: []
+  })
+], MetricsModule);
+// src/metrics/middleware.ts
+function createHttpMetricsMiddleware(collector) {
+  return async (context2, next) => {
+    const startTime = Date.now();
+    const response = await next();
+    const duration = Date.now() - startTime;
+    const durationSeconds = duration / 1000;
+    const method = context2.method;
+    const path = context2.path;
+    const statusCode = response.status;
+    collector.incrementCounter("http_requests_total", {
+      method,
+      path,
+      status: statusCode.toString()
+    });
+    collector.observeHistogram("http_request_duration_seconds", {
+      method,
+      path,
+      status: statusCode.toString()
+    }, durationSeconds);
+    collector.observeHistogram("http_request_duration_seconds_summary", {
+      method,
+      path
+    }, durationSeconds);
+    return response;
+  };
+}
 // src/testing/harness.ts
 import { performance as performance2 } from "perf_hooks";
 
@@ -3552,11 +3966,15 @@ class StressTester {
 export {
   requiresAuth,
   getAuthMetadata,
+  createUserKeyGenerator,
+  createTokenKeyGenerator,
   createSwaggerUIMiddleware,
   createStaticFileMiddleware,
   createSecurityFilter,
   createRequestLoggingMiddleware,
+  createRateLimitMiddleware,
   createLoggerMiddleware,
+  createHttpMetricsMiddleware,
   createFileUploadMiddleware,
   createErrorHandlingMiddleware,
   createCorsMiddleware,
@@ -3579,7 +3997,9 @@ export {
   RoleBasedAccessDecisionManager,
   ResponseBuilder,
   RequestWrapper,
+  RateLimit,
   Query,
+  PrometheusFormatter,
   PerformanceHarness,
   ParamBinder,
   Param,
@@ -3598,6 +4018,10 @@ export {
   Module,
   MinLength,
   MiddlewarePipeline,
+  MetricsModule,
+  MetricsCollector,
+  METRICS_SERVICE_TOKEN,
+  METRICS_OPTIONS_TOKEN,
   LoggerModule,
   LoggerExtension,
   LogLevel2 as LogLevel,

package/dist/metrics/collector.d.ts

@@ -0,0 +1,47 @@
+import type { CustomMetric, MetricDataPoint, MetricLabels } from './types';
+/**
+ * 指标收集器
+ */
+export declare class MetricsCollector {
+    private counters;
+    private gauges;
+    private histograms;
+    private customMetrics;
+    /**
+     * 注册自定义指标
+     */
+    registerCustomMetric(metric: CustomMetric): void;
+    /**
+     * 增加计数器
+     */
+    incrementCounter(name: string, labels?: MetricLabels, value?: number): void;
+    /**
+     * 设置仪表值
+     */
+    setGauge(name: string, labels: MetricLabels | undefined, value: number): void;
+    /**
+     * 观察直方图值
+     */
+    observeHistogram(name: string, labels: MetricLabels | undefined, value: number): void;
+    /**
+     * 获取所有指标数据点
+     */
+    getAllDataPoints(): Promise<MetricDataPoint[]>;
+    /**
+     * 重置所有指标
+     */
+    reset(): void;
+    /**
+     * 生成标签键
+     */
+    private getKey;
+    /**
+     * 解析标签键
+     */
+    private parseKey;
+    /**
+     * 计算直方图桶
+     */
+    private calculateBuckets;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/metrics/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/metrics/collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EAGb,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,UAAU,CAAiD;IACnE,OAAO,CAAC,aAAa,CAAsB;IAE3C;;OAEG;IACI,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIvD;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAQrF;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOpF;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5F;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAuF3D;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACH,OAAO,CAAC,MAAM;IAYd;;OAEG;IACH,OAAO,CAAC,QAAQ;IAmBhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/metrics/controller.d.ts

@@ -0,0 +1,17 @@
+import { MetricsCollector } from './collector';
+import { type MetricsModuleOptions } from './types';
+/**
+ * Metrics 控制器
+ * 提供 `/metrics` 端点用于 Prometheus 指标导出
+ */
+export declare class MetricsController {
+    private readonly collector;
+    private readonly options?;
+    private readonly formatter;
+    constructor(collector: MetricsCollector, options?: MetricsModuleOptions | undefined);
+    /**
+     * 获取 Prometheus 格式的指标
+     */
+    metrics(): Promise<Response>;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/metrics/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/metrics/controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAgD,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAElG;;;GAGG;AACH,qBACa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAN3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAI7B,SAAS,EAAE,gBAAgB,EAE3B,OAAO,CAAC,EAAE,oBAAoB,YAAA;IAKjD;;OAEG;IAEU,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;CAU1C"}

package/dist/metrics/index.d.ts

@@ -0,0 +1,7 @@
+export { MetricsModule } from './metrics-module';
+export { MetricsCollector } from './collector';
+export { PrometheusFormatter } from './prometheus';
+export { MetricsController } from './controller';
+export { createHttpMetricsMiddleware } from './middleware';
+export { METRICS_SERVICE_TOKEN, METRICS_OPTIONS_TOKEN, type MetricsModuleOptions, type MetricType, type MetricLabels, type MetricValue, type MetricDataPoint, type CustomMetric, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/metrics/metrics-module.d.ts

@@ -0,0 +1,9 @@
+import type { MetricsModuleOptions } from './types';
+export declare class MetricsModule {
+    /**
+     * 创建指标监控模块
+     * @param options - 模块配置
+     */
+    static forRoot(options?: MetricsModuleOptions): typeof MetricsModule;
+}
+//# sourceMappingURL=metrics-module.d.ts.map

package/dist/metrics/metrics-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-module.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics-module.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD,qBAIa,aAAa;IACxB;;;OAGG;WACW,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,aAAa;CAyChF"}

package/dist/metrics/middleware.d.ts

@@ -0,0 +1,7 @@
+import type { Middleware } from '../middleware';
+import { MetricsCollector } from './collector';
+/**
+ * 创建 HTTP 请求指标收集中间件
+ */
+export declare function createHttpMetricsMiddleware(collector: MetricsCollector): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/metrics/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/metrics/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,GAAG,UAAU,CAsCnF"}

package/dist/metrics/prometheus.d.ts

@@ -0,0 +1,23 @@
+import type { MetricDataPoint } from './types';
+/**
+ * 将指标数据点转换为 Prometheus 格式
+ */
+export declare class PrometheusFormatter {
+    /**
+     * 格式化指标为 Prometheus 文本格式
+     */
+    format(dataPoints: MetricDataPoint[]): string;
+    /**
+     * 按指标名称分组
+     */
+    private groupByMetricName;
+    /**
+     * 格式化标签
+     */
+    private formatLabels;
+    /**
+     * 转义标签值
+     */
+    private escapeLabelValue;
+}
+//# sourceMappingURL=prometheus.d.ts.map

package/dist/metrics/prometheus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../../src/metrics/prometheus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACI,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM;IAgCpD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/metrics/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 指标类型
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';
+/**
+ * 指标标签
+ */
+export type MetricLabels = Record<string, string>;
+/**
+ * 指标值
+ */
+export type MetricValue = number;
+/**
+ * 指标数据点
+ */
+export interface MetricDataPoint {
+    /**
+     * 指标名称
+     */
+    name: string;
+    /**
+     * 指标类型
+     */
+    type: MetricType;
+    /**
+     * 指标值
+     */
+    value: MetricValue;
+    /**
+     * 标签
+     */
+    labels?: MetricLabels;
+    /**
+     * 帮助文本
+     */
+    help?: string;
+}
+/**
+ * 自定义指标
+ */
+export interface CustomMetric {
+    /**
+     * 指标名称
+     */
+    name: string;
+    /**
+     * 指标类型
+     */
+    type: MetricType;
+    /**
+     * 帮助文本
+     */
+    help?: string;
+    /**
+     * 获取当前值
+     * @param labels - 标签
+     * @returns 指标值
+     */
+    getValue(labels?: MetricLabels): MetricValue | Promise<MetricValue>;
+}
+/**
+ * MetricsModule 配置选项
+ */
+export interface MetricsModuleOptions {
+    /**
+     * 是否启用 HTTP 请求指标收集
+     * @default true
+     */
+    enableHttpMetrics?: boolean;
+    /**
+     * 自定义指标列表
+     */
+    customMetrics?: CustomMetric[];
+    /**
+     * Metrics 端点路径
+     * @default '/metrics'
+     */
+    path?: string;
+}
+/**
+ * Metrics 服务 Token
+ */
+export declare const METRICS_SERVICE_TOKEN: unique symbol;
+/**
+ * Metrics 选项 Token
+ */
+export declare const METRICS_OPTIONS_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/metrics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAE/B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAA+C,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAA+C,CAAC"}

package/dist/middleware/builtin/index.d.ts

@@ -3,4 +3,5 @@ export { createErrorHandlingMiddleware } from './error-handler';
 export { createCorsMiddleware } from './cors';
 export { createFileUploadMiddleware } from './file-upload';
 export { createStaticFileMiddleware } from './static-file';
+export { createRateLimitMiddleware, createTokenKeyGenerator, createUserKeyGenerator, type RateLimitOptions, type RateLimitStore, } from './rate-limit';
 //# sourceMappingURL=index.d.ts.map

package/dist/middleware/builtin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC"}

package/dist/middleware/builtin/rate-limit.d.ts

@@ -0,0 +1,104 @@
+import type { Context } from '../../core/context';
+import type { Middleware } from '../middleware';
+/**
+ * 速率限制存储接口
+ */
+export interface RateLimitStore {
+    /**
+     * 获取当前计数
+     * @param key - 存储键
+     * @returns 当前计数
+     */
+    get(key: string): Promise<number>;
+    /**
+     * 增加计数
+     * @param key - 存储键
+     * @param windowMs - 时间窗口（毫秒）
+     * @returns 增加后的计数
+     */
+    increment(key: string, windowMs: number): Promise<number>;
+    /**
+     * 重置计数
+     * @param key - 存储键
+     */
+    reset(key: string): Promise<void>;
+}
+/**
+ * 内存存储实现（使用 Map）
+ */
+export declare class MemoryRateLimitStore implements RateLimitStore {
+    private store;
+    get(key: string): Promise<number>;
+    increment(key: string, windowMs: number): Promise<number>;
+    reset(key: string): Promise<void>;
+    /**
+     * 清理过期条目（可选，用于内存管理）
+     */
+    cleanup(): void;
+}
+/**
+ * 速率限制选项
+ */
+export interface RateLimitOptions {
+    /**
+     * 时间窗口内的最大请求数
+     */
+    max: number;
+    /**
+     * 时间窗口（毫秒）
+     * @default 60000 (1 分钟)
+     */
+    windowMs?: number;
+    /**
+     * 存储实现（默认使用内存存储）
+     */
+    store?: RateLimitStore;
+    /**
+     * 获取限流键的函数
+     * @param context - 请求上下文
+     * @returns 限流键
+     */
+    keyGenerator?: (context: Context) => string | Promise<string>;
+    /**
+     * 是否跳过成功响应（只对错误响应计数）
+     * @default false
+     */
+    skipSuccessfulRequests?: boolean;
+    /**
+     * 是否跳过失败响应（只对成功响应计数）
+     * @default false
+     */
+    skipFailedRequests?: boolean;
+    /**
+     * 自定义错误消息
+     */
+    message?: string;
+    /**
+     * 自定义错误状态码
+     * @default 429
+     */
+    statusCode?: number;
+    /**
+     * 是否在响应头中包含限流信息
+     * @default true
+     */
+    standardHeaders?: boolean;
+    /**
+     * 是否启用 X-RateLimit-* 响应头
+     * @default true
+     */
+    legacyHeaders?: boolean;
+}
+/**
+ * 创建速率限制中间件
+ */
+export declare function createRateLimitMiddleware(options: RateLimitOptions): Middleware;
+/**
+ * 基于 Token/User 的键生成器
+ */
+export declare function createTokenKeyGenerator(tokenHeader?: string): (context: Context) => string;
+/**
+ * 基于用户 ID 的键生成器（需要从认证上下文获取）
+ */
+export declare function createUserKeyGenerator(getUserId: (context: Context) => string | null | undefined): (context: Context) => string;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/middleware/builtin/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/middleware/builtin/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1D;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,KAAK,CAAgE;IAEhE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAejC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBzD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACI,OAAO,IAAI,IAAI;CAQvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IAEvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9D;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AASD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAiE/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAW3G;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAS/H"}

package/dist/middleware/decorators.d.ts

@@ -1,11 +1,18 @@
 import 'reflect-metadata';
 import type { Middleware } from './middleware';
+import { type RateLimitOptions } from './builtin/rate-limit';
 /**
  * UseMiddleware 装饰器
  * 可用于控制器类或方法
  * @param middlewares - 中间件列表
  */
 export declare function UseMiddleware(...middlewares: Middleware[]): ClassDecorator & MethodDecorator;
+/**
+ * RateLimit 装饰器
+ * 用于在控制器方法上应用速率限制
+ * @param options - 速率限制选项
+ */
+export declare function RateLimit(options: RateLimitOptions): MethodDecorator;
 /**
  * 获取类级中间件
  * @param constructor - 控制器构造函数

package/dist/middleware/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/middleware/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoC/C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,GAAG,cAAc,GAAG,eAAe,CAQ5F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,UAAU,EAAE,CAIlG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,UAAU,EAAE,CAKd"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/middleware/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAoCxF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,GAAG,cAAc,GAAG,eAAe,CAQ5F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAKpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,UAAU,EAAE,CAIlG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,UAAU,EAAE,CAKd"}

package/dist/middleware/index.d.ts

@@ -1,5 +1,5 @@
 export type { Middleware, NextFunction } from './middleware';
 export { MiddlewarePipeline, runMiddlewares } from './pipeline';
-export { UseMiddleware, getClassMiddlewares, getMethodMiddlewares } from './decorators';
+export { UseMiddleware, RateLimit, getClassMiddlewares, getMethodMiddlewares } from './decorators';
 export { createLoggerMiddleware, createRequestLoggingMiddleware, createErrorHandlingMiddleware, createCorsMiddleware, } from './builtin';
 //# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,7 +13,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/dangaogit/@dangao/bun-server.git"
+    "url": "https://github.com/dangaogit/bun-server.git"
   },
   "keywords": [
     "bun",
@@ -46,7 +46,7 @@
     "dts": "tsc -p tsconfig.build.json",
     "build": "bun run clean && bun run bundle && bun run dts",
     "prepare": "bun run build",
-    "publish": "cp ../../readme.md ../../LICENSE . && bun publish --access public && rm -f ./readme.md ./LICENSE"
+    "publish:package": "cp ../../readme.md ../../LICENSE . && bun publish --access public && rm -f ./readme.md ./LICENSE"
   },
   "devDependencies": {
     "typescript": "5.9.3",

package/readme.md

@@ -166,7 +166,7 @@ bun benchmark/di.bench.ts
 
 ## 路线图
 
-详细路线图、阶段目标与完成情况请查阅 [`.roadmap.md`](./.roadmap.md)。
+详细路线图、阶段目标与完成情况请查阅 [`.roadmap/v0.3.0.md`](./.roadmap/v0.3.0.md)。
 
 ## 工程规范