@dofe/infra-common 0.1.1

package/dist/decorators/feature-flag/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Feature Flag Module Exports
+ */
+export { FeatureEnabled, FeatureFlags, IfFeatureEnabled, BetaFeature, GradualRollout, FEATURE_FLAG_METADATA_KEY, FEATURE_FLAGS_METADATA_KEY, FeatureFlagStrategy, FeatureFlagOptions, FeatureFlagContext, } from './feature-flag.decorator';
+export { FeatureFlagService, FeatureFlagProvider, FeatureFlagConfig, } from './feature-flag.service';
+export { FeatureFlagInterceptor } from './feature-flag.interceptor';
+export { FeatureFlagModule } from './feature-flag.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/feature-flag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/feature-flag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EAEd,yBAAyB,EACzB,0BAA0B,EAE1B,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/decorators/feature-flag/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Feature Flag Module Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagModule = exports.FeatureFlagInterceptor = exports.FeatureFlagService = exports.FEATURE_FLAGS_METADATA_KEY = exports.FEATURE_FLAG_METADATA_KEY = exports.GradualRollout = exports.BetaFeature = exports.IfFeatureEnabled = exports.FeatureFlags = exports.FeatureEnabled = void 0;
+var feature_flag_decorator_1 = require("./feature-flag.decorator");
+// Decorators
+Object.defineProperty(exports, "FeatureEnabled", { enumerable: true, get: function () { return feature_flag_decorator_1.FeatureEnabled; } });
+Object.defineProperty(exports, "FeatureFlags", { enumerable: true, get: function () { return feature_flag_decorator_1.FeatureFlags; } });
+Object.defineProperty(exports, "IfFeatureEnabled", { enumerable: true, get: function () { return feature_flag_decorator_1.IfFeatureEnabled; } });
+Object.defineProperty(exports, "BetaFeature", { enumerable: true, get: function () { return feature_flag_decorator_1.BetaFeature; } });
+Object.defineProperty(exports, "GradualRollout", { enumerable: true, get: function () { return feature_flag_decorator_1.GradualRollout; } });
+// Constants
+Object.defineProperty(exports, "FEATURE_FLAG_METADATA_KEY", { enumerable: true, get: function () { return feature_flag_decorator_1.FEATURE_FLAG_METADATA_KEY; } });
+Object.defineProperty(exports, "FEATURE_FLAGS_METADATA_KEY", { enumerable: true, get: function () { return feature_flag_decorator_1.FEATURE_FLAGS_METADATA_KEY; } });
+var feature_flag_service_1 = require("./feature-flag.service");
+Object.defineProperty(exports, "FeatureFlagService", { enumerable: true, get: function () { return feature_flag_service_1.FeatureFlagService; } });
+var feature_flag_interceptor_1 = require("./feature-flag.interceptor");
+Object.defineProperty(exports, "FeatureFlagInterceptor", { enumerable: true, get: function () { return feature_flag_interceptor_1.FeatureFlagInterceptor; } });
+var feature_flag_module_1 = require("./feature-flag.module");
+Object.defineProperty(exports, "FeatureFlagModule", { enumerable: true, get: function () { return feature_flag_module_1.FeatureFlagModule; } });
+//# sourceMappingURL=index.js.map

package/dist/decorators/feature-flag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/feature-flag/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mEAckC;AAbhC,aAAa;AACb,wHAAA,cAAc,OAAA;AACd,sHAAA,YAAY,OAAA;AACZ,0HAAA,gBAAgB,OAAA;AAChB,qHAAA,WAAW,OAAA;AACX,wHAAA,cAAc,OAAA;AACd,YAAY;AACZ,mIAAA,yBAAyB,OAAA;AACzB,oIAAA,0BAA0B,OAAA;AAO5B,+DAIgC;AAH9B,0HAAA,kBAAkB,OAAA;AAKpB,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAC/B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA"}

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

@@ -0,0 +1,174 @@
+/**
+ * Rate Limit DTO
+ *
+ * 限流模块类型定义
+ */
+import { FastifyRequest } from 'fastify';
+/**
+ * 限流维度
+ * - ip: 基于 IP 地址
+ * - userId: 基于用户 ID
+ * - tenantId: 基于租户/团队 ID
+ * - apiKey: 基于 API Key
+ * - composite: 复合维度 (自定义)
+ */
+export type RateLimitDimension = 'ip' | 'userId' | 'tenantId' | 'apiKey' | 'composite';
+/**
+ * 限流上下文
+ * 包含请求相关的所有维度信息
+ */
+export interface RateLimitContext {
+    /** 客户端 IP 地址 */
+    ip: string;
+    /** 用户 ID (已认证用户) */
+    userId?: string;
+    /** 租户/团队 ID */
+    tenantId?: string;
+    /** API Key (用于外部 API 调用) */
+    apiKey?: string;
+    /** 请求路径 */
+    path: string;
+    /** HTTP 方法 */
+    method: string;
+    /** 追踪 ID */
+    traceId: string;
+    /** 原始请求对象 */
+    request: FastifyRequest;
+}
+/**
+ * 限流选项
+ * 用于 @RateLimit 装饰器配置
+ */
+export interface RateLimitOptions {
+    /** 时间窗口内允许的最大请求数 */
+    limit: number;
+    /** 时间窗口 (秒) */
+    window: number;
+    /** 限流维度，默认自动选择最佳维度 */
+    dimension?: RateLimitDimension;
+    /** 自定义 key 生成器 */
+    keyGenerator?: (context: RateLimitContext) => string;
+    /** 自定义错误消息 */
+    message?: string;
+    /** 关联的 Feature Flag，用于动态开关 */
+    featureFlag?: string;
+    /** 跳过限流的条件判断函数 */
+    skip?: (context: RateLimitContext) => boolean | Promise<boolean>;
+    /** 是否在限流时抛出异常 (默认 true) */
+    throwOnLimit?: boolean;
+}
+/**
+ * 限流检查结果
+ */
+export interface RateLimitResult {
+    /** 请求是否被允许 */
+    allowed: boolean;
+    /** 时间窗口内的请求限制数 */
+    limit: number;
+    /** 剩余请求数 */
+    remaining: number;
+    /** 限流重置时间 (Unix 时间戳，秒) */
+    resetTime: number;
+    /** 需要等待的秒数 */
+    retryAfter: number;
+    /** 使用的限流维度 */
+    dimension: RateLimitDimension;
+    /** 维度标识符 */
+    identifier: string;
+}
+/**
+ * 限流信息 (用于异常响应)
+ */
+export interface RateLimitInfo {
+    /** 时间窗口内的请求限制数 */
+    limit: number;
+    /** 剩余请求数 */
+    remaining: number;
+    /** 限流重置时间 (Unix 时间戳，秒) */
+    resetTime: number;
+    /** 需要等待的秒数 */
+    retryAfter: number;
+    /** 使用的限流维度 */
+    dimension: RateLimitDimension;
+    /** 维度标识符 */
+    identifier: string;
+    /** 触发限流的端点 */
+    endpoint?: string;
+}
+/**
+ * 维度限流配置
+ */
+export interface RateLimitDimensionConfig {
+    /** 请求限制数 */
+    limit: number;
+    /** 时间窗口 (秒) */
+    window: number;
+}
+/**
+ * 白名单配置
+ */
+export interface RateLimitWhitelist {
+    /** IP 白名单 */
+    ips: string[];
+    /** 用户 ID 白名单 */
+    userIds: string[];
+    /** API Key 白名单 */
+    apiKeys: string[];
+}
+/**
+ * Redis 配置
+ */
+export interface RateLimitRedisConfig {
+    /** Redis key 前缀 */
+    keyPrefix: string;
+}
+/**
+ * 限流配置 (从 YAML 加载)
+ */
+export interface RateLimitConfig {
+    /** 是否启用限流 */
+    enabled: boolean;
+    /** 全局 Feature Flag */
+    featureFlag?: string;
+    /** 默认限流配置 */
+    default: RateLimitDimensionConfig;
+    /** 各维度的默认配置 */
+    dimensions: {
+        ip: RateLimitDimensionConfig;
+        userId: RateLimitDimensionConfig;
+        tenantId: RateLimitDimensionConfig;
+        apiKey: RateLimitDimensionConfig;
+    };
+    /** Redis 配置 */
+    redis: RateLimitRedisConfig;
+    /** 白名单 */
+    whitelist: RateLimitWhitelist;
+}
+/**
+ * 限流事件 (用于日志和监控)
+ */
+export interface RateLimitEvent {
+    /** 事件类型 */
+    type: 'allowed' | 'blocked';
+    /** 追踪 ID */
+    traceId: string;
+    /** 限流维度 */
+    dimension: RateLimitDimension;
+    /** 维度标识符 */
+    identifier: string;
+    /** 请求路径 */
+    path: string;
+    /** HTTP 方法 */
+    method: string;
+    /** 当前计数 */
+    currentCount: number;
+    /** 限制数 */
+    limit: number;
+    /** 用户 ID (如有) */
+    userId?: string;
+    /** IP 地址 */
+    ip: string;
+    /** 时间戳 */
+    timestamp: Date;
+}
+//# sourceMappingURL=rate-limit.dto.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Rate Limit DTO
+ *
+ * 限流模块类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rate-limit.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.dto.js","sourceRoot":"","sources":["../../../../src/decorators/rate-limit/dto/rate-limit.dto.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

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

@@ -0,0 +1,24 @@
+/**
+ * Rate Limit Module Exports
+ *
+ * 统一导出限流模块的所有组件
+ *
+ * @example
+ * ```typescript
+ * import {
+ *     RateLimit,
+ *     RateLimitPresets,
+ *     SkipRateLimit,
+ *     RateLimitService,
+ *     RateLimitException,
+ *     RateLimitModule,
+ * } from '@/decorators/rate-limit';
+ * ```
+ */
+export { RateLimit, SkipRateLimit, RateLimitPresets, RateLimitHigh, RateLimitStandard, RateLimitLow, RateLimitSensitive, RateLimitStrict, } from './rate-limit.decorator';
+export { RATE_LIMIT_KEY, SKIP_RATE_LIMIT_KEY } from './rate-limit.constants';
+export { RateLimitService } from './rate-limit.service';
+export { RateLimitException } from './rate-limit.exception';
+export { RateLimitModule } from './rate-limit.module';
+export type { RateLimitOptions, RateLimitContext, RateLimitResult, RateLimitInfo, RateLimitDimension, RateLimitConfig, RateLimitDimensionConfig, RateLimitWhitelist, RateLimitRedisConfig, RateLimitEvent, } from './dto/rate-limit.dto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/rate-limit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Rate Limit Module Exports
+ *
+ * 统一导出限流模块的所有组件
+ *
+ * @example
+ * ```typescript
+ * import {
+ *     RateLimit,
+ *     RateLimitPresets,
+ *     SkipRateLimit,
+ *     RateLimitService,
+ *     RateLimitException,
+ *     RateLimitModule,
+ * } from '@/decorators/rate-limit';
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitModule = exports.RateLimitException = exports.RateLimitService = exports.SKIP_RATE_LIMIT_KEY = exports.RATE_LIMIT_KEY = exports.RateLimitStrict = exports.RateLimitSensitive = exports.RateLimitLow = exports.RateLimitStandard = exports.RateLimitHigh = exports.RateLimitPresets = exports.SkipRateLimit = exports.RateLimit = void 0;
+// Decorators
+var rate_limit_decorator_1 = require("./rate-limit.decorator");
+Object.defineProperty(exports, "RateLimit", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimit; } });
+Object.defineProperty(exports, "SkipRateLimit", { enumerable: true, get: function () { return rate_limit_decorator_1.SkipRateLimit; } });
+Object.defineProperty(exports, "RateLimitPresets", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimitPresets; } });
+Object.defineProperty(exports, "RateLimitHigh", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimitHigh; } });
+Object.defineProperty(exports, "RateLimitStandard", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimitStandard; } });
+Object.defineProperty(exports, "RateLimitLow", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimitLow; } });
+Object.defineProperty(exports, "RateLimitSensitive", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimitSensitive; } });
+Object.defineProperty(exports, "RateLimitStrict", { enumerable: true, get: function () { return rate_limit_decorator_1.RateLimitStrict; } });
+// Constants
+var rate_limit_constants_1 = require("./rate-limit.constants");
+Object.defineProperty(exports, "RATE_LIMIT_KEY", { enumerable: true, get: function () { return rate_limit_constants_1.RATE_LIMIT_KEY; } });
+Object.defineProperty(exports, "SKIP_RATE_LIMIT_KEY", { enumerable: true, get: function () { return rate_limit_constants_1.SKIP_RATE_LIMIT_KEY; } });
+// Service
+var rate_limit_service_1 = require("./rate-limit.service");
+Object.defineProperty(exports, "RateLimitService", { enumerable: true, get: function () { return rate_limit_service_1.RateLimitService; } });
+// Exception
+var rate_limit_exception_1 = require("./rate-limit.exception");
+Object.defineProperty(exports, "RateLimitException", { enumerable: true, get: function () { return rate_limit_exception_1.RateLimitException; } });
+// Module
+var rate_limit_module_1 = require("./rate-limit.module");
+Object.defineProperty(exports, "RateLimitModule", { enumerable: true, get: function () { return rate_limit_module_1.RateLimitModule; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/rate-limit/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,aAAa;AACb,+DASgC;AAR9B,iHAAA,SAAS,OAAA;AACT,qHAAA,aAAa,OAAA;AACb,wHAAA,gBAAgB,OAAA;AAChB,qHAAA,aAAa,OAAA;AACb,yHAAA,iBAAiB,OAAA;AACjB,oHAAA,YAAY,OAAA;AACZ,0HAAA,kBAAkB,OAAA;AAClB,uHAAA,eAAe,OAAA;AAGjB,YAAY;AACZ,+DAA6E;AAApE,sHAAA,cAAc,OAAA;AAAE,2HAAA,mBAAmB,OAAA;AAE5C,UAAU;AACV,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AAEzB,YAAY;AACZ,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAE3B,SAAS;AACT,yDAAsD;AAA7C,oHAAA,eAAe,OAAA"}

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

@@ -0,0 +1,16 @@
+/**
+ * Rate Limit Constants
+ *
+ * 限流相关的常量定义
+ *
+ * 注意：此文件独立于 decorator 和 interceptor，避免循环依赖
+ */
+/**
+ * 限流配置的元数据 key
+ */
+export declare const RATE_LIMIT_KEY = "rate_limit";
+/**
+ * 跳过限流的元数据 key
+ */
+export declare const SKIP_RATE_LIMIT_KEY = "skip_rate_limit";
+//# sourceMappingURL=rate-limit.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.constants.d.ts","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC"}

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

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Rate Limit Constants
+ *
+ * 限流相关的常量定义
+ *
+ * 注意：此文件独立于 decorator 和 interceptor，避免循环依赖
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKIP_RATE_LIMIT_KEY = exports.RATE_LIMIT_KEY = void 0;
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * 限流配置的元数据 key
+ */
+exports.RATE_LIMIT_KEY = 'rate_limit';
+/**
+ * 跳过限流的元数据 key
+ */
+exports.SKIP_RATE_LIMIT_KEY = 'skip_rate_limit';
+//# sourceMappingURL=rate-limit.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.constants.js","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.constants.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACU,QAAA,cAAc,GAAG,YAAY,CAAC;AAE3C;;GAEG;AACU,QAAA,mBAAmB,GAAG,iBAAiB,CAAC"}

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

@@ -0,0 +1,132 @@
+/**
+ * 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() { ... }
+ */
+import { RateLimitOptions } from './dto/rate-limit.dto';
+/**
+ * @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() { ... }
+ * ```
+ */
+export declare function RateLimit(options: RateLimitOptions): MethodDecorator;
+/**
+ * @SkipRateLimit - 跳过限流
+ *
+ * 标记方法跳过业务层限流检查（入口限流仍然生效）
+ *
+ * @example
+ * ```typescript
+ * @SkipRateLimit()
+ * async healthCheck() { ... }
+ * ```
+ */
+export declare function SkipRateLimit(): MethodDecorator;
+/**
+ * 预设限流策略
+ *
+ * 提供常用场景的快捷装饰器
+ */
+export declare const RateLimitPresets: {
+    /**
+     * 高频接口: 每分钟 200 次
+     * 适用于: 列表查询、搜索
+     */
+    high: () => MethodDecorator;
+    /**
+     * 标准接口: 每分钟 100 次
+     * 适用于: 常规 CRUD 操作
+     */
+    standard: () => MethodDecorator;
+    /**
+     * 低频接口: 每分钟 20 次
+     * 适用于: 创建、更新操作
+     */
+    low: () => MethodDecorator;
+    /**
+     * 敏感操作: 每分钟 5 次
+     * 适用于: 密码修改、邮箱验证
+     */
+    sensitive: () => MethodDecorator;
+    /**
+     * API Key 限流: 每分钟 1000 次
+     * 适用于: 开放 API
+     */
+    apiKey: (limit?: number) => MethodDecorator;
+    /**
+     * 租户限流: 每分钟 2000 次
+     * 适用于: SaaS 多租户场景
+     */
+    tenant: (limit?: number) => MethodDecorator;
+    /**
+     * 严格限流: 每小时 10 次
+     * 适用于: 注册、重置密码
+     */
+    strict: () => MethodDecorator;
+    /**
+     * AI 生成限流: 每分钟 10 次
+     * 适用于: AI 内容生成
+     */
+    aiGeneration: () => MethodDecorator;
+};
+/**
+ * @RateLimitHigh - 高频接口限流 (200/分钟)
+ */
+export declare const RateLimitHigh: () => MethodDecorator;
+/**
+ * @RateLimitStandard - 标准接口限流 (100/分钟)
+ */
+export declare const RateLimitStandard: () => MethodDecorator;
+/**
+ * @RateLimitLow - 低频接口限流 (20/分钟)
+ */
+export declare const RateLimitLow: () => MethodDecorator;
+/**
+ * @RateLimitSensitive - 敏感操作限流 (5/分钟)
+ */
+export declare const RateLimitSensitive: () => MethodDecorator;
+/**
+ * @RateLimitStrict - 严格限流 (10/小时)
+ */
+export declare const RateLimitStrict: () => MethodDecorator;
+//# sourceMappingURL=rate-limit.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/rate-limit/rate-limit.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAOxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAKpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAMD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;OAGG;;IAOH;;;OAGG;;IAOH;;;OAGG;;IAOH;;;OAGG;;IASH;;;OAGG;;IAQH;;;OAGG;;IAQH;;;OAGG;;IASH;;;OAGG;;CASJ,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,aAAa,uBAAwB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,iBAAiB,uBAA4B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,YAAY,uBAAuB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,kBAAkB,uBAA6B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,eAAe,uBAA0B,CAAC"}