@dofe/infra-common 0.1.1

package/dist/decorators/rate-limit/rate-limit.decorator.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Rate Limit Decorator
+ *
+ * 限流装饰器，支持方法级别的细粒度限流控制
+ *
+ * @example
+ * // 基础用法: 每分钟 100 次
+ * @RateLimit({ limit: 100, window: 60 })
+ * async createPost() { ... }
+ *
+ * // 按用户限流
+ * @RateLimit({ limit: 50, window: 60, dimension: 'userId' })
+ * async submitFeedback() { ... }
+ *
+ * // 按租户限流 (适用于 SaaS)
+ * @RateLimit({ limit: 1000, window: 60, dimension: 'tenantId' })
+ * async batchExport() { ... }
+ *
+ * // 结合 Feature Flag 动态控制
+ * @RateLimit({ limit: 100, window: 60, featureFlag: 'rate-limit-export' })
+ * async postExport() { ... }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitStrict = exports.RateLimitSensitive = exports.RateLimitLow = exports.RateLimitStandard = exports.RateLimitHigh = exports.RateLimitPresets = void 0;
+exports.RateLimit = RateLimit;
+exports.SkipRateLimit = SkipRateLimit;
+const common_1 = require("@nestjs/common");
+const rate_limit_interceptor_1 = require("../../interceptor/rate-limit/rate-limit.interceptor");
+const rate_limit_constants_1 = require("./rate-limit.constants");
+// ============================================================================
+// Decorators
+// ============================================================================
+/**
+ * @RateLimit - 限流装饰器
+ *
+ * 对方法应用限流控制，支持多维度和动态配置
+ *
+ * @param options - 限流配置选项
+ * @returns MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * // 标准限流
+ * @RateLimit({ limit: 100, window: 60 })
+ * async createPost() { ... }
+ *
+ * // 按 API Key 限流
+ * @RateLimit({ limit: 500, window: 60, dimension: 'apiKey' })
+ * async externalApiCall() { ... }
+ *
+ * // 自定义错误消息
+ * @RateLimit({
+ *     limit: 10,
+ *     window: 60,
+ *     dimension: 'userId',
+ *     message: '发送消息过于频繁，请稍后再试',
+ * })
+ * async sendMessage() { ... }
+ * ```
+ */
+function RateLimit(options) {
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(rate_limit_constants_1.RATE_LIMIT_KEY, options), (0, common_1.UseInterceptors)(rate_limit_interceptor_1.RateLimitInterceptor));
+}
+/**
+ * @SkipRateLimit - 跳过限流
+ *
+ * 标记方法跳过业务层限流检查（入口限流仍然生效）
+ *
+ * @example
+ * ```typescript
+ * @SkipRateLimit()
+ * async healthCheck() { ... }
+ * ```
+ */
+function SkipRateLimit() {
+    return (0, common_1.SetMetadata)(rate_limit_constants_1.SKIP_RATE_LIMIT_KEY, true);
+}
+// ============================================================================
+// Preset Decorators
+// ============================================================================
+/**
+ * 预设限流策略
+ *
+ * 提供常用场景的快捷装饰器
+ */
+exports.RateLimitPresets = {
+    /**
+     * 高频接口: 每分钟 200 次
+     * 适用于: 列表查询、搜索
+     */
+    high: () => RateLimit({
+        limit: 200,
+        window: 60,
+    }),
+    /**
+     * 标准接口: 每分钟 100 次
+     * 适用于: 常规 CRUD 操作
+     */
+    standard: () => RateLimit({
+        limit: 100,
+        window: 60,
+    }),
+    /**
+     * 低频接口: 每分钟 20 次
+     * 适用于: 创建、更新操作
+     */
+    low: () => RateLimit({
+        limit: 20,
+        window: 60,
+    }),
+    /**
+     * 敏感操作: 每分钟 5 次
+     * 适用于: 密码修改、邮箱验证
+     */
+    sensitive: () => RateLimit({
+        limit: 5,
+        window: 60,
+        dimension: 'userId',
+        message: '操作过于频繁，请稍后再试',
+    }),
+    /**
+     * API Key 限流: 每分钟 1000 次
+     * 适用于: 开放 API
+     */
+    apiKey: (limit = 1000) => RateLimit({
+        limit,
+        window: 60,
+        dimension: 'apiKey',
+    }),
+    /**
+     * 租户限流: 每分钟 2000 次
+     * 适用于: SaaS 多租户场景
+     */
+    tenant: (limit = 2000) => RateLimit({
+        limit,
+        window: 60,
+        dimension: 'tenantId',
+    }),
+    /**
+     * 严格限流: 每小时 10 次
+     * 适用于: 注册、重置密码
+     */
+    strict: () => RateLimit({
+        limit: 10,
+        window: 3600,
+        dimension: 'ip',
+        message: '请求次数已达上限，请稍后再试',
+    }),
+    /**
+     * AI 生成限流: 每分钟 10 次
+     * 适用于: AI 内容生成
+     */
+    aiGeneration: () => RateLimit({
+        limit: 10,
+        window: 60,
+        dimension: 'userId',
+        featureFlag: 'rate-limit-ai-generation',
+        message: 'AI 生成次数已达上限，请稍后再试',
+    }),
+};
+// ============================================================================
+// Convenience Aliases
+// ============================================================================
+/**
+ * @RateLimitHigh - 高频接口限流 (200/分钟)
+ */
+exports.RateLimitHigh = exports.RateLimitPresets.high;
+/**
+ * @RateLimitStandard - 标准接口限流 (100/分钟)
+ */
+exports.RateLimitStandard = exports.RateLimitPresets.standard;
+/**
+ * @RateLimitLow - 低频接口限流 (20/分钟)
+ */
+exports.RateLimitLow = exports.RateLimitPresets.low;
+/**
+ * @RateLimitSensitive - 敏感操作限流 (5/分钟)
+ */
+exports.RateLimitSensitive = exports.RateLimitPresets.sensitive;
+/**
+ * @RateLimitStrict - 严格限流 (10/小时)
+ */
+exports.RateLimitStrict = exports.RateLimitPresets.strict;
+//# sourceMappingURL=rate-limit.decorator.js.map

package/dist/decorators/rate-limit/rate-limit.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.decorator.js","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.decorator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAuCH,8BAKC;AAaD,sCAEC;AAzDD,2CAA+E;AAC/E,gGAA2F;AAE3F,iEAA6E;AAE7E,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,SAAS,CAAC,OAAyB;IACjD,OAAO,IAAA,wBAAe,EACpB,IAAA,oBAAW,EAAC,qCAAc,EAAE,OAAO,CAAC,EACpC,IAAA,wBAAe,EAAC,6CAAoB,CAAC,CACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,aAAa;IAC3B,OAAO,IAAA,oBAAW,EAAC,0CAAmB,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;GAIG;AACU,QAAA,gBAAgB,GAAG;IAC9B;;;OAGG;IACH,IAAI,EAAE,GAAG,EAAE,CACT,SAAS,CAAC;QACR,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IAEJ;;;OAGG;IACH,QAAQ,EAAE,GAAG,EAAE,CACb,SAAS,CAAC;QACR,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IAEJ;;;OAGG;IACH,GAAG,EAAE,GAAG,EAAE,CACR,SAAS,CAAC;QACR,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;KACX,CAAC;IAEJ;;;OAGG;IACH,SAAS,EAAE,GAAG,EAAE,CACd,SAAS,CAAC;QACR,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,cAAc;KACxB,CAAC;IAEJ;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,EAAE,CACvB,SAAS,CAAC;QACR,KAAK;QACL,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,QAAQ;KACpB,CAAC;IAEJ;;;OAGG;IACH,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,EAAE,CACvB,SAAS,CAAC;QACR,KAAK;QACL,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,UAAU;KACtB,CAAC;IAEJ;;;OAGG;IACH,MAAM,EAAE,GAAG,EAAE,CACX,SAAS,CAAC;QACR,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,gBAAgB;KAC1B,CAAC;IAEJ;;;OAGG;IACH,YAAY,EAAE,GAAG,EAAE,CACjB,SAAS,CAAC;QACR,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,mBAAmB;KAC7B,CAAC;CACL,CAAC;AAEF,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;GAEG;AACU,QAAA,aAAa,GAAG,wBAAgB,CAAC,IAAI,CAAC;AAEnD;;GAEG;AACU,QAAA,iBAAiB,GAAG,wBAAgB,CAAC,QAAQ,CAAC;AAE3D;;GAEG;AACU,QAAA,YAAY,GAAG,wBAAgB,CAAC,GAAG,CAAC;AAEjD;;GAEG;AACU,QAAA,kBAAkB,GAAG,wBAAgB,CAAC,SAAS,CAAC;AAE7D;;GAEG;AACU,QAAA,eAAe,GAAG,wBAAgB,CAAC,MAAM,CAAC"}

package/dist/decorators/rate-limit/rate-limit.exception.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Rate Limit Exception
+ *
+ * 限流异常类，当请求超过限制时抛出
+ * 响应格式与 HttpExceptionFilter 保持一致
+ */
+import { HttpException } from '@nestjs/common';
+import { RateLimitInfo } from './dto/rate-limit.dto';
+/**
+ * 限流异常
+ *
+ * @example
+ * throw new RateLimitException({
+ *   limit: 100,
+ *   remaining: 0,
+ *   resetTime: 1703577600,
+ *   retryAfter: 60,
+ *   dimension: 'userId',
+ *   identifier: 'user-123',
+ *   endpoint: '/api/export',
+ * });
+ */
+export declare class RateLimitException extends HttpException {
+    readonly rateLimitInfo: RateLimitInfo;
+    constructor(info: RateLimitInfo, message?: string);
+    /**
+     * 获取限流详情
+     */
+    getRateLimitInfo(): RateLimitInfo;
+    /**
+     * 获取重试等待时间（秒）
+     */
+    getRetryAfter(): number;
+    /**
+     * 获取响应头
+     */
+    getHeaders(): Record<string, string>;
+}
+//# sourceMappingURL=rate-limit.exception.d.ts.map

package/dist/decorators/rate-limit/rate-limit.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.exception.d.ts","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.exception.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,SAAgB,aAAa,EAAE,aAAa,CAAC;gBAEjC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM;IAqBjD;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAQrC"}

package/dist/decorators/rate-limit/rate-limit.exception.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Rate Limit Exception
+ *
+ * 限流异常类，当请求超过限制时抛出
+ * 响应格式与 HttpExceptionFilter 保持一致
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitException = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 限流异常
+ *
+ * @example
+ * throw new RateLimitException({
+ *   limit: 100,
+ *   remaining: 0,
+ *   resetTime: 1703577600,
+ *   retryAfter: 60,
+ *   dimension: 'userId',
+ *   identifier: 'user-123',
+ *   endpoint: '/api/export',
+ * });
+ */
+class RateLimitException extends common_1.HttpException {
+    rateLimitInfo;
+    constructor(info, message) {
+        const errorMessage = message || 'Too many requests, please try again later';
+        super({
+            code: 925429,
+            msg: errorMessage,
+            error: {
+                limit: info.limit,
+                remaining: info.remaining,
+                resetTime: info.resetTime,
+                retryAfter: info.retryAfter,
+                dimension: info.dimension,
+            },
+        }, common_1.HttpStatus.TOO_MANY_REQUESTS);
+        this.rateLimitInfo = info;
+    }
+    /**
+     * 获取限流详情
+     */
+    getRateLimitInfo() {
+        return this.rateLimitInfo;
+    }
+    /**
+     * 获取重试等待时间（秒）
+     */
+    getRetryAfter() {
+        return this.rateLimitInfo.retryAfter;
+    }
+    /**
+     * 获取响应头
+     */
+    getHeaders() {
+        return {
+            'X-RateLimit-Limit': this.rateLimitInfo.limit.toString(),
+            'X-RateLimit-Remaining': this.rateLimitInfo.remaining.toString(),
+            'X-RateLimit-Reset': this.rateLimitInfo.resetTime.toString(),
+            'Retry-After': this.rateLimitInfo.retryAfter.toString(),
+        };
+    }
+}
+exports.RateLimitException = RateLimitException;
+//# sourceMappingURL=rate-limit.exception.js.map

package/dist/decorators/rate-limit/rate-limit.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.exception.js","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.exception.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2CAA2D;AAG3D;;;;;;;;;;;;;GAaG;AACH,MAAa,kBAAmB,SAAQ,sBAAa;IACnC,aAAa,CAAgB;IAE7C,YAAY,IAAmB,EAAE,OAAgB;QAC/C,MAAM,YAAY,GAAG,OAAO,IAAI,2CAA2C,CAAC;QAE5E,KAAK,CACH;YACE,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,YAAY;YACjB,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B;SACF,EACD,mBAAU,CAAC,iBAAiB,CAC7B,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO;YACL,mBAAmB,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE;YACxD,uBAAuB,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,EAAE;YAChE,mBAAmB,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,EAAE;YAC5D,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;SACxD,CAAC;IACJ,CAAC;CACF;AAjDD,gDAiDC"}

package/dist/decorators/rate-limit/rate-limit.module.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Rate Limit Module
+ *
+ * 限流模块，提供依赖注入支持
+ *
+ * @example
+ * ```typescript
+ * // 在 AppModule 或功能模块中导入
+ * @Module({
+ *     imports: [RateLimitModule],
+ * })
+ * export class AppModule {}
+ *
+ * // 在 Controller 中使用
+ * @Controller('export')
+ * export class ExportController {
+ *     @Post()
+ *     @RateLimit({ limit: 50, window: 60, dimension: 'userId' })
+ *     async create() { ... }
+ * }
+ * ```
+ */
+export declare class RateLimitModule {
+}
+//# sourceMappingURL=rate-limit.module.d.ts.map

package/dist/decorators/rate-limit/rate-limit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.module.d.ts","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,qBAMa,eAAe;CAAG"}

package/dist/decorators/rate-limit/rate-limit.module.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Rate Limit Module
+ *
+ * 限流模块，提供依赖注入支持
+ *
+ * @example
+ * ```typescript
+ * // 在 AppModule 或功能模块中导入
+ * @Module({
+ *     imports: [RateLimitModule],
+ * })
+ * export class AppModule {}
+ *
+ * // 在 Controller 中使用
+ * @Controller('export')
+ * export class ExportController {
+ *     @Post()
+ *     @RateLimit({ limit: 50, window: 60, dimension: 'userId' })
+ *     async create() { ... }
+ * }
+ * ```
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const rate_limit_service_1 = require("./rate-limit.service");
+const rate_limit_interceptor_1 = require("../../interceptor/rate-limit/rate-limit.interceptor");
+const feature_flag_module_1 = require("../feature-flag/feature-flag.module");
+let RateLimitModule = class RateLimitModule {
+};
+exports.RateLimitModule = RateLimitModule;
+exports.RateLimitModule = RateLimitModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule, feature_flag_module_1.FeatureFlagModule],
+        providers: [rate_limit_service_1.RateLimitService, rate_limit_interceptor_1.RateLimitInterceptor],
+        exports: [rate_limit_service_1.RateLimitService, rate_limit_interceptor_1.RateLimitInterceptor],
+    })
+], RateLimitModule);
+//# sourceMappingURL=rate-limit.module.js.map

package/dist/decorators/rate-limit/rate-limit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.module.js","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.module.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;AAEH,2CAAgD;AAChD,2CAA8C;AAE9C,6DAAwD;AACxD,gGAA2F;AAC3F,6EAAwE;AAQjE,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAN3B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,EAAE,uCAAiB,CAAC;QAC1C,SAAS,EAAE,CAAC,qCAAgB,EAAE,6CAAoB,CAAC;QACnD,OAAO,EAAE,CAAC,qCAAgB,EAAE,6CAAoB,CAAC;KAClD,CAAC;GACW,eAAe,CAAG"}

package/dist/decorators/rate-limit/rate-limit.service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Rate Limit Service
+ *
+ * 限流服务，使用 Redis Sorted Set 实现滑动窗口算法
+ *
+ * 特性:
+ * - 多维度限流 (IP, userId, tenantId, apiKey)
+ * - Redis 分布式存储
+ * - Feature Flag 动态开关
+ * - 白名单支持
+ * - 结构化日志和监控
+ *
+ * 配置项 (config.local.yaml):
+ * ```yaml
+ * rateLimit:
+ *   enabled: true
+ *   featureFlag: 'rate-limit-enabled'
+ *   default:
+ *     limit: 100
+ *     window: 60
+ *   dimensions:
+ *     ip: { limit: 200, window: 60 }
+ *     userId: { limit: 500, window: 60 }
+ *     tenantId: { limit: 2000, window: 60 }
+ *     apiKey: { limit: 1000, window: 60 }
+ *   redis:
+ *     keyPrefix: 'pardx:ratelimit:'
+ *   whitelist:
+ *     ips: ['127.0.0.1', '::1']
+ *     userIds: []
+ *     apiKeys: []
+ * ```
+ */
+import { OnModuleInit } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { Logger } from 'winston';
+import { RedisService } from '@dofe/infra-redis';
+import { FeatureFlagService } from '../feature-flag/feature-flag.service';
+import { RateLimitContext, RateLimitOptions, RateLimitResult } from './dto/rate-limit.dto';
+export declare class RateLimitService implements OnModuleInit {
+    private readonly configService;
+    private readonly redis;
+    private readonly featureFlagService;
+    private readonly logger;
+    private config;
+    private keyPrefix;
+    constructor(configService: ConfigService, redis: RedisService, featureFlagService: FeatureFlagService, logger: Logger);
+    onModuleInit(): Promise<void>;
+    /**
+     * 检查限流是否启用
+     */
+    isEnabled(): Promise<boolean>;
+    /**
+     * 检查特定 Feature Flag 是否启用
+     */
+    isFeatureEnabled(flagName: string): Promise<boolean>;
+    /**
+     * 检查是否在白名单中
+     */
+    isWhitelisted(context: RateLimitContext): boolean;
+    /**
+     * 执行限流检查
+     *
+     * @param context 限流上下文
+     * @param options 限流选项
+     * @returns 限流检查结果
+     */
+    checkRateLimit(context: RateLimitContext, options: RateLimitOptions): Promise<RateLimitResult>;
+    /**
+     * 获取当前的限流状态 (不增加计数)
+     */
+    getRateLimitStatus(context: RateLimitContext, options: RateLimitOptions): Promise<RateLimitResult>;
+    /**
+     * 重置限流计数
+     */
+    resetRateLimit(context: RateLimitContext, options: RateLimitOptions): Promise<void>;
+    /**
+     * 自动选择最佳限流维度
+     * 优先级: apiKey > userId > tenantId > ip
+     */
+    private selectBestDimension;
+    /**
+     * 获取维度的标识符值
+     */
+    private getIdentifier;
+    /**
+     * 生成 Redis key
+     *
+     * 格式: {prefix}{dimension}:{identifier}:{normalizedPath}
+     * 例如: pardx:ratelimit:userId:user-123:/api/export
+     */
+    private generateKey;
+    /**
+     * 获取维度配置
+     */
+    private getDimensionConfig;
+    /**
+     * 记录限流事件
+     */
+    private logEvent;
+}
+//# sourceMappingURL=rate-limit.service.d.ts.map

package/dist/decorators/rate-limit/rate-limit.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.service.d.ts","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAsB,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,EAEL,gBAAgB,EAIhB,gBAAgB,EAChB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAyB9B,qBACa,gBAAiB,YAAW,YAAY;IAKjD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACV,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP1D,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,SAAS,CAA8B;gBAG5B,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,YAAY,EACP,kBAAkB,EAAE,kBAAkB,EACjB,MAAM,EAAE,MAAM;IAG5D,YAAY;IAgClB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAanC;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO1D;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAkBjD;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAgF3B;;OAEG;IACG,kBAAkB,CACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IA2C3B;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAwBhB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,QAAQ;CAuBjB"}