@dangao/bun-server 1.3.0 → 1.5.0

package/dist/microservice/config-center/config-center-module.d.ts

@@ -0,0 +1,43 @@
+import type { NacosClientOptions } from '@dangao/nacos-client';
+/**
+ * 配置中心 Provider 类型
+ */
+export type ConfigCenterProvider = 'nacos' | 'consul' | 'etcd' | 'apollo';
+/**
+ * Nacos 配置中心选项
+ */
+export interface NacosConfigCenterOptions {
+    /**
+     * Nacos 客户端配置
+     */
+    client: NacosClientOptions;
+    /**
+     * 配置监听轮询间隔（毫秒）
+     * @default 3000
+     */
+    watchInterval?: number;
+}
+/**
+ * 配置中心模块选项
+ */
+export interface ConfigCenterModuleOptions {
+    /**
+     * Provider 类型
+     */
+    provider: ConfigCenterProvider;
+    /**
+     * Nacos 配置（当 provider 为 'nacos' 时使用）
+     */
+    nacos?: NacosConfigCenterOptions;
+}
+/**
+ * 配置中心模块
+ */
+export declare class ConfigCenterModule {
+    /**
+     * 创建配置中心模块
+     * @param options - 模块配置
+     */
+    static forRoot(options: ConfigCenterModuleOptions): typeof ConfigCenterModule;
+}
+//# sourceMappingURL=config-center-module.d.ts.map

package/dist/microservice/config-center/config-center-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-center-module.d.ts","sourceRoot":"","sources":["../../../src/microservice/config-center/config-center-module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAKlC;AAED;;GAEG;AACH,qBAGa,kBAAkB;IAC7B;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,kBAAkB;CAuCrF"}

package/dist/microservice/config-center/decorators.d.ts

@@ -0,0 +1,58 @@
+import 'reflect-metadata';
+import type { Constructor } from '../../core/types';
+/**
+ * 配置中心值元数据
+ */
+export interface ConfigCenterValueMetadata {
+    /**
+     * 配置 dataId
+     */
+    dataId: string;
+    /**
+     * 配置分组
+     */
+    groupName: string;
+    /**
+     * 命名空间（可选）
+     */
+    namespaceId?: string;
+    /**
+     * 默认值（可选）
+     */
+    defaultValue?: string;
+    /**
+     * 是否监听配置变更
+     */
+    watch?: boolean;
+}
+/**
+ * ConfigCenterValue 装饰器
+ * 用于自动注入配置中心的值
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   @ConfigCenterValue('my-config', 'DEFAULT_GROUP')
+ *   public configValue: string = '';
+ *
+ *   @ConfigCenterValue('app-name', 'DEFAULT_GROUP', { defaultValue: 'MyApp' })
+ *   public appName: string = '';
+ * }
+ * ```
+ */
+export declare function ConfigCenterValue(dataId: string, groupName?: string, options?: {
+    namespaceId?: string;
+    defaultValue?: string;
+    watch?: boolean;
+}): PropertyDecorator;
+/**
+ * 获取类的所有配置中心值元数据
+ */
+export declare function getConfigCenterValueMetadata(target: Constructor<unknown>): Map<string | symbol, ConfigCenterValueMetadata>;
+/**
+ * 初始化类的配置中心值
+ * 在类实例化后调用，自动加载配置值
+ */
+export declare function initializeConfigCenterValues(instance: object, target: Constructor<unknown>): Promise<void>;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/microservice/config-center/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/config-center/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAwB,EACnC,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,iBAAiB,CAsCnB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,yBAAyB,CAAC,CAIjD;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/microservice/config-center/index.d.ts

@@ -0,0 +1,9 @@
+export { ConfigCenterModule } from './config-center-module';
+export type { ConfigCenterModuleOptions, ConfigCenterProvider, NacosConfigCenterOptions } from './config-center-module';
+export { NacosConfigCenter } from './nacos-config-center';
+export { CONFIG_CENTER_TOKEN } from './types';
+export type { ConfigCenter, ConfigChangeListener, ConfigResult } from './types';
+export { ConfigCenterValue, getConfigCenterValueMetadata, initializeConfigCenterValues, } from './decorators';
+export { NacosValue } from './nacos-decorators';
+export type { ConfigCenterValueMetadata } from './decorators';
+//# sourceMappingURL=index.d.ts.map

package/dist/microservice/config-center/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/microservice/config-center/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/microservice/config-center/nacos-config-center.d.ts

@@ -0,0 +1,37 @@
+import { NacosClient } from '@dangao/nacos-client';
+import type { ConfigResult, ConfigChangeListener, ConfigCenter } from './types';
+/**
+ * Nacos 配置中心实现
+ * 实现 ConfigCenter 接口，内部使用 @dangao/nacos-client
+ */
+export declare class NacosConfigCenter implements ConfigCenter {
+    private readonly client;
+    private readonly configClient;
+    private readonly watchers;
+    private readonly watchInterval;
+    constructor(client: NacosClient, options?: {
+        /**
+         * 配置监听轮询间隔（毫秒）
+         * @default 3000
+         */
+        watchInterval?: number;
+    });
+    /**
+     * 获取配置
+     */
+    getConfig(dataId: string, groupName: string, namespaceId?: string): Promise<ConfigResult>;
+    /**
+     * 监听配置变更
+     * 通过轮询和 md5 比对实现配置热更新
+     */
+    watchConfig(dataId: string, groupName: string, listener: ConfigChangeListener, namespaceId?: string): () => void;
+    /**
+     * 关闭配置中心连接
+     */
+    close(): Promise<void>;
+    /**
+     * 生成监听器 key
+     */
+    private getWatchKey;
+}
+//# sourceMappingURL=nacos-config-center.d.ts.map

package/dist/microservice/config-center/nacos-config-center.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos-config-center.d.ts","sourceRoot":"","sources":["../../../src/microservice/config-center/nacos-config-center.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEhF;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkF;IAC3G,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAG5C,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;QACR;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAOH;;OAEG;IACU,SAAS,CACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC;IAexB;;;OAGG;IACI,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,IAAI;IAgDb;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/microservice/config-center/nacos-decorators.d.ts

@@ -0,0 +1,24 @@
+import 'reflect-metadata';
+/**
+ * NacosValue 装饰器
+ * Nacos 特定的配置值注入装饰器
+ * 这是 @ConfigCenterValue 的便捷别名，专门用于 Nacos
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   @NacosValue('my-config', 'DEFAULT_GROUP')
+ *   public configValue: string = '';
+ *
+ *   @NacosValue('app-name', 'DEFAULT_GROUP', { defaultValue: 'MyApp' })
+ *   public appName: string = '';
+ * }
+ * ```
+ */
+export declare function NacosValue(dataId: string, groupName?: string, options?: {
+    namespaceId?: string;
+    defaultValue?: string;
+    watch?: boolean;
+}): PropertyDecorator;
+//# sourceMappingURL=nacos-decorators.d.ts.map

package/dist/microservice/config-center/nacos-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos-decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/config-center/nacos-decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAwB,EACnC,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,iBAAiB,CAGnB"}

package/dist/microservice/config-center/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 配置中心抽象接口
+ * 定义配置中心的核心能力，不依赖具体实现
+ */
+export interface ConfigCenter {
+    /**
+     * 获取配置
+     * @param dataId - 配置 ID
+     * @param groupName - 配置分组
+     * @param namespaceId - 命名空间
+     * @returns 配置内容
+     */
+    getConfig(dataId: string, groupName: string, namespaceId?: string): Promise<ConfigResult>;
+    /**
+     * 监听配置变更
+     * @param dataId - 配置 ID
+     * @param groupName - 配置分组
+     * @param listener - 变更监听器
+     * @param namespaceId - 命名空间（可选）
+     * @returns 取消监听的函数
+     */
+    watchConfig(dataId: string, groupName: string, listener: ConfigChangeListener, namespaceId?: string): () => void;
+    /**
+     * 关闭配置中心连接
+     */
+    close(): Promise<void>;
+}
+/**
+ * 配置查询结果
+ */
+export interface ConfigResult {
+    /**
+     * 配置内容
+     */
+    content: string;
+    /**
+     * 配置 MD5 值（用于判断配置是否变更）
+     */
+    md5: string;
+    /**
+     * 最后修改时间（时间戳）
+     */
+    lastModified: number;
+    /**
+     * 内容类型
+     */
+    contentType: string;
+}
+/**
+ * 配置变更监听器
+ */
+export interface ConfigChangeListener {
+    /**
+     * 配置变更回调
+     * @param result - 新的配置结果
+     */
+    (result: ConfigResult): void;
+}
+/**
+ * ConfigCenter Token（用于依赖注入）
+ */
+export declare const CONFIG_CENTER_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/microservice/config-center/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/microservice/config-center/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;OAOG;IACH,WAAW,CACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,IAAI,CAAC;IAEd;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC"}

package/dist/microservice/governance/circuit-breaker.d.ts

@@ -0,0 +1,54 @@
+import { CircuitBreakerState, type CircuitBreakerOptions, type CircuitBreakerStats } from './types';
+export { CircuitBreakerState, type CircuitBreakerOptions, type CircuitBreakerStats } from './types';
+/**
+ * 熔断器实现
+ */
+export declare class CircuitBreaker {
+    private state;
+    private readonly options;
+    private readonly records;
+    private openTime?;
+    private halfOpenTestCount;
+    constructor(options?: CircuitBreakerOptions);
+    /**
+     * 执行请求（带熔断保护）
+     */
+    execute<T>(fn: () => Promise<T>, fallback?: () => Promise<T> | T): Promise<T>;
+    /**
+     * 记录请求
+     */
+    private recordRequest;
+    /**
+     * 清理过期记录
+     */
+    private cleanupRecords;
+    /**
+     * 更新熔断器状态
+     */
+    private updateState;
+    /**
+     * 判断是否应该开启熔断
+     */
+    private shouldOpen;
+    /**
+     * 判断是否应该关闭熔断（半开状态下）
+     */
+    private shouldClose;
+    /**
+     * 创建超时 Promise
+     */
+    private createTimeoutPromise;
+    /**
+     * 获取当前状态
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * 获取统计信息
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * 重置熔断器
+     */
+    reset(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/microservice/governance/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/microservice/governance/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEpG,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAUpG;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAa;gBAEnB,OAAO,GAAE,qBAA0B;IAWtD;;OAEG;IACU,OAAO,CAAC,CAAC,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC;IA8Cb;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmCnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACI,QAAQ,IAAI,mBAAmB;IAKtC;;OAEG;IACI,QAAQ,IAAI,mBAAmB;IAsBtC;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}

package/dist/microservice/governance/decorators.d.ts

@@ -0,0 +1,51 @@
+import 'reflect-metadata';
+import type { CircuitBreakerOptions } from './types';
+import type { Constructor } from '../../core/types';
+/**
+ * 熔断器元数据
+ */
+export interface CircuitBreakerMetadata {
+    /**
+     * 熔断器选项
+     */
+    options?: CircuitBreakerOptions;
+    /**
+     * 降级处理函数名（可选）
+     */
+    fallbackMethod?: string;
+}
+/**
+ * CircuitBreaker 装饰器
+ * 用于在方法上自动应用熔断保护
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   @CircuitBreaker({
+ *     failureThreshold: 5,
+ *     resetTimeout: 60000,
+ *   })
+ *   public async callExternalService() {
+ *     // 自动应用熔断保护
+ *   }
+ *
+ *   @CircuitBreaker({
+ *     failureThreshold: 5,
+ *   }, 'fallbackMethod')
+ *   public async callWithFallback() {
+ *     // 自动应用熔断保护，失败时调用 fallbackMethod
+ *   }
+ *
+ *   private async fallbackMethod() {
+ *     return { message: 'Fallback response' };
+ *   }
+ * }
+ * ```
+ */
+export declare function CircuitBreaker(options?: CircuitBreakerOptions, fallbackMethod?: string): MethodDecorator;
+/**
+ * 获取方法的熔断器元数据
+ */
+export declare function getCircuitBreakerMetadata(target: Constructor<unknown>): Map<string | symbol, CircuitBreakerMetadata>;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/microservice/governance/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/governance/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,eAAe,CA4CjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,sBAAsB,CAAC,CAI9C"}

package/dist/microservice/governance/index.d.ts

@@ -0,0 +1,9 @@
+export { CircuitBreaker } from './circuit-breaker';
+export { CircuitBreakerState } from './types';
+export { RateLimiter } from './rate-limiter';
+export { RedisRateLimiter } from './redis-rate-limiter';
+export { RetryStrategyImpl } from './retry-strategy';
+export { CircuitBreaker as CircuitBreakerDecorator, getCircuitBreakerMetadata, } from './decorators';
+export type { CircuitBreakerMetadata } from './decorators';
+export type { CircuitBreakerOptions, CircuitBreakerStats, RateLimiterOptions, RetryStrategy, RedisRateLimiterOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/microservice/governance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/microservice/governance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,cAAc,IAAI,uBAAuB,EACzC,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,SAAS,CAAC"}

package/dist/microservice/governance/rate-limiter.d.ts

@@ -0,0 +1,26 @@
+import type { RateLimiterOptions } from './types';
+/**
+ * 限流器实现（内存版）
+ */
+export declare class RateLimiter {
+    private readonly options;
+    private readonly requests;
+    constructor(options?: RateLimiterOptions);
+    /**
+     * 检查是否允许请求
+     * @param key - 限流键（如服务名、IP 等）
+     * @returns 是否允许请求
+     */
+    allow(key: string): Promise<boolean>;
+    /**
+     * 获取剩余请求数
+     * @param key - 限流键
+     * @returns 剩余请求数
+     */
+    getRemaining(key: string): number;
+    /**
+     * 重置限流器
+     */
+    reset(key?: string): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/microservice/governance/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/microservice/governance/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyE;IACjG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAE1C,OAAO,GAAE,kBAAuB;IAOnD;;;;OAIG;IACU,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBjD;;;;OAIG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUxC;;OAEG;IACI,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;CAOjC"}

package/dist/microservice/governance/redis-rate-limiter.d.ts

@@ -0,0 +1,76 @@
+import type { RateLimiterOptions } from './types';
+/**
+ * Redis 限流器选项
+ */
+export interface RedisRateLimiterOptions {
+    /**
+     * Redis 客户端（需要用户提供）
+     * 支持任何兼容的 Redis 客户端接口
+     */
+    client: {
+        /**
+         * 获取键值
+         */
+        get(key: string): Promise<string | null>;
+        /**
+         * 设置键值（带过期时间）
+         */
+        set(key: string, value: string, options?: {
+            PX?: number;
+            EX?: number;
+        }): Promise<void>;
+        /**
+         * 删除键
+         */
+        del(key: string): Promise<void>;
+        /**
+         * 递增键值（原子操作）
+         */
+        incr(key: string): Promise<number>;
+        /**
+         * 设置键的过期时间
+         */
+        expire(key: string, seconds: number): Promise<void>;
+        /**
+         * 检查键是否存在
+         */
+        exists(key: string): Promise<number>;
+    };
+    /**
+     * 键前缀
+     * @default 'ratelimit:'
+     */
+    keyPrefix?: string;
+}
+/**
+ * Redis 限流器实现（分布式限流）
+ * 支持多个服务实例共享限流状态
+ */
+export declare class RedisRateLimiter {
+    private readonly client;
+    private readonly keyPrefix;
+    private readonly options;
+    constructor(redisOptions: RedisRateLimiterOptions, rateLimiterOptions?: RateLimiterOptions);
+    /**
+     * 检查是否允许请求
+     * @param key - 限流键（如服务名、IP 等）
+     * @returns 是否允许请求
+     */
+    allow(key: string): Promise<boolean>;
+    /**
+     * 获取剩余请求数
+     * @param key - 限流键
+     * @returns 剩余请求数
+     */
+    getRemaining(key: string): Promise<number>;
+    /**
+     * 重置限流器
+     * @param key - 限流键（可选，如果不提供则重置所有）
+     */
+    reset(key?: string): Promise<void>;
+    /**
+     * 生成 Redis 键
+     */
+    private getKey;
+}
+//# sourceMappingURL=redis-rate-limiter.d.ts.map

package/dist/microservice/governance/redis-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/microservice/governance/redis-rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAEzC;;WAEG;QACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjB;;WAEG;QACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEhC;;WAEG;QACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAEnC;;WAEG;QACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpD;;WAEG;QACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;gBAGA,YAAY,EAAE,uBAAuB,EACrC,kBAAkB,GAAE,kBAAuB;IAU7C;;;;OAIG;IACU,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBjD;;;;OAIG;IACU,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBvD;;;OAGG;IACU,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C;;OAEG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/microservice/governance/retry-strategy.d.ts

@@ -0,0 +1,21 @@
+import type { RetryStrategy } from './types';
+/**
+ * 重试策略实现
+ */
+export declare class RetryStrategyImpl {
+    private readonly options;
+    constructor(options?: RetryStrategy);
+    /**
+     * 执行带重试的请求
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * 计算重试延迟
+     */
+    private calculateDelay;
+    /**
+     * 休眠
+     */
+    private sleep;
+}
+//# sourceMappingURL=retry-strategy.d.ts.map

package/dist/microservice/governance/retry-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-strategy.d.ts","sourceRoot":"","sources":["../../../src/microservice/governance/retry-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;gBAEiB,OAAO,GAAE,aAAkB;IAW9C;;OAEG;IACU,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BzD;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}