@dangao/bun-server 1.3.0 → 1.5.0

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

@@ -0,0 +1,212 @@
+/**
+ * 熔断器状态
+ */
+export declare enum CircuitBreakerState {
+    /**
+     * 关闭状态：正常处理请求
+     */
+    CLOSED = "CLOSED",
+    /**
+     * 开启状态：拒绝请求，直接返回错误
+     */
+    OPEN = "OPEN",
+    /**
+     * 半开状态：允许少量请求通过，用于测试服务是否恢复
+     */
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * 熔断器配置选项
+ */
+export interface CircuitBreakerOptions {
+    /**
+     * 失败率阈值（0-1）
+     * 当失败率超过此值时，熔断器开启
+     * @default 0.5
+     */
+    failureThreshold?: number;
+    /**
+     * 时间窗口（毫秒）
+     * 在此时间窗口内统计失败率
+     * @default 60000
+     */
+    timeWindow?: number;
+    /**
+     * 最小请求数
+     * 在时间窗口内至少需要这么多请求才会触发熔断
+     * @default 10
+     */
+    minimumRequests?: number;
+    /**
+     * 熔断持续时间（毫秒）
+     * 熔断器开启后，持续多长时间才进入半开状态
+     * @default 60000
+     */
+    openDuration?: number;
+    /**
+     * 半开状态下的测试请求数
+     * 在半开状态下允许通过的请求数
+     * @default 3
+     */
+    halfOpenRequests?: number;
+    /**
+     * 超时时间（毫秒）
+     * 请求超过此时间视为失败
+     * @default 5000
+     */
+    timeout?: number;
+}
+/**
+ * 熔断器统计信息
+ */
+export interface CircuitBreakerStats {
+    /**
+     * 当前状态
+     */
+    state: CircuitBreakerState;
+    /**
+     * 总请求数
+     */
+    totalRequests: number;
+    /**
+     * 成功请求数
+     */
+    successRequests: number;
+    /**
+     * 失败请求数
+     */
+    failureRequests: number;
+    /**
+     * 当前失败率
+     */
+    failureRate: number;
+    /**
+     * 最后失败时间
+     */
+    lastFailureTime?: number;
+    /**
+     * 熔断开启时间
+     */
+    openTime?: number;
+}
+/**
+ * 限流器配置选项
+ */
+export interface RateLimiterOptions {
+    /**
+     * 每秒允许的请求数
+     * @default 100
+     */
+    requestsPerSecond?: number;
+    /**
+     * 时间窗口（毫秒）
+     * @default 1000
+     */
+    timeWindow?: number;
+    /**
+     * 是否使用分布式限流（需要 Redis）
+     * @default false
+     */
+    distributed?: boolean;
+    /**
+     * Redis 配置（分布式限流时使用）
+     */
+    redis?: {
+        host: string;
+        port: number;
+        password?: string;
+    };
+}
+/**
+ * 重试策略配置
+ */
+export interface RetryStrategy {
+    /**
+     * 最大重试次数
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * 重试延迟（毫秒）
+     * @default 1000
+     */
+    retryDelay?: number;
+    /**
+     * 是否使用指数退避
+     * @default false
+     */
+    exponentialBackoff?: boolean;
+    /**
+     * 指数退避的基础延迟（毫秒）
+     * @default 1000
+     */
+    baseDelay?: number;
+    /**
+     * 指数退避的最大延迟（毫秒）
+     * @default 30000
+     */
+    maxDelay?: number;
+    /**
+     * 重试条件：哪些错误应该重试
+     * @param error - 错误对象
+     * @returns 是否应该重试
+     */
+    shouldRetry?: (error: Error) => boolean;
+}
+/**
+ * 重试决策
+ */
+export interface RetryDecision {
+    /**
+     * 是否重试
+     */
+    retry: boolean;
+    /**
+     * 延迟时间（毫秒）
+     */
+    delay: number;
+}
+/**
+ * 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;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/microservice/index.d.ts

@@ -0,0 +1,10 @@
+export * from './config-center';
+export * from './service-registry';
+export * from './service-client';
+export * from './governance';
+export * from './tracing';
+export * from './monitoring';
+export { NacosValue } from './config-center';
+export { ServiceDiscovery, type ServiceDiscoveryMetadata } from './service-registry';
+export { ServiceCall, type ServiceCallMetadata } from './service-client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/microservice/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { ServiceMetricsCollector } from './metrics-collector';
+export { ServiceMetricsIntegration } from './metrics-integration';
+export type { ServiceCallMetrics, ServiceInstanceHealth, MonitoringOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/microservice/monitoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/microservice/monitoring/metrics-collector.d.ts

@@ -0,0 +1,54 @@
+import type { ServiceCallMetrics, ServiceInstanceHealth, MonitoringOptions } from './types';
+/**
+ * 服务监控指标收集器
+ */
+export declare class ServiceMetricsCollector {
+    private readonly options;
+    private readonly metrics;
+    private readonly healthStatus;
+    private readonly requestRecords;
+    private readonly maxRecordsPerInstance;
+    private metricsIntegration?;
+    constructor(options?: MonitoringOptions);
+    /**
+     * 记录服务调用
+     */
+    recordCall(serviceName: string, instance: string, success: boolean, latency: number): void;
+    /**
+     * 获取服务指标
+     */
+    getMetrics(serviceName: string, instance?: string): ServiceCallMetrics[];
+    /**
+     * 获取所有指标
+     */
+    getAllMetrics(): ServiceCallMetrics[];
+    /**
+     * 获取服务实例健康状态
+     */
+    getHealthStatus(serviceName: string, instance?: string): ServiceInstanceHealth[];
+    /**
+     * 获取所有健康状态
+     */
+    getAllHealthStatus(): ServiceInstanceHealth[];
+    /**
+     * 更新指标
+     */
+    private updateMetrics;
+    /**
+     * 更新健康状态
+     */
+    private updateHealthStatus;
+    /**
+     * 生成键
+     */
+    private getKey;
+    /**
+     * 重置指标
+     */
+    reset(serviceName?: string, instance?: string): void;
+    /**
+     * 停止指标收集和上报
+     */
+    stop(): void;
+}
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/microservice/monitoring/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../../../src/microservice/monitoring/metrics-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAY5F;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiD;IAC9E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2C;IAC1E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgB;IACtD,OAAO,CAAC,kBAAkB,CAAC,CAA4B;gBAEpC,OAAO,GAAE,iBAAsB;IAiBlD;;OAEG;IACI,UAAU,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,IAAI;IA4BP;;OAEG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAY/E;;OAEG;IACI,aAAa,IAAI,kBAAkB,EAAE;IAI5C;;OAEG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAYvF;;OAEG;IACI,kBAAkB,IAAI,qBAAqB,EAAE;IAIpD;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACI,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAa3D;;OAEG;IACI,IAAI,IAAI,IAAI;CAGpB"}

package/dist/microservice/monitoring/metrics-integration.d.ts

@@ -0,0 +1,24 @@
+import { ServiceMetricsCollector } from './metrics-collector';
+/**
+ * 服务监控指标集成器
+ * 将 ServiceMetricsCollector 的指标自动上报到 MetricsModule
+ */
+export declare class ServiceMetricsIntegration {
+    private metricsCollector?;
+    private serviceMetricsCollector;
+    private updateInterval?;
+    constructor(serviceMetricsCollector: ServiceMetricsCollector);
+    /**
+     * 启动指标上报
+     */
+    start(intervalMs?: number): void;
+    /**
+     * 停止指标上报
+     */
+    stop(): void;
+    /**
+     * 上报指标到 MetricsCollector
+     */
+    private reportMetrics;
+}
+//# sourceMappingURL=metrics-integration.d.ts.map

package/dist/microservice/monitoring/metrics-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-integration.d.ts","sourceRoot":"","sources":["../../../src/microservice/monitoring/metrics-integration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,uBAAuB,CAA0B;IACzD,OAAO,CAAC,cAAc,CAAC,CAAiC;gBAErC,uBAAuB,EAAE,uBAAuB;IAInE;;OAEG;IACI,KAAK,CAAC,UAAU,GAAE,MAAc,GAAG,IAAI;IA2B9C;;OAEG;IACI,IAAI,IAAI,IAAI;IAOnB;;OAEG;IACH,OAAO,CAAC,aAAa;CA2FtB"}

package/dist/microservice/monitoring/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 服务调用指标
+ */
+export interface ServiceCallMetrics {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * 实例标识（IP:Port）
+     */
+    instance: string;
+    /**
+     * 总请求数
+     */
+    totalRequests: number;
+    /**
+     * 成功请求数
+     */
+    successRequests: number;
+    /**
+     * 失败请求数
+     */
+    failureRequests: number;
+    /**
+     * 平均延迟（毫秒）
+     */
+    averageLatency: number;
+    /**
+     * 最小延迟（毫秒）
+     */
+    minLatency: number;
+    /**
+     * 最大延迟（毫秒）
+     */
+    maxLatency: number;
+    /**
+     * 错误率（0-1）
+     */
+    errorRate: number;
+    /**
+     * 最后更新时间（时间戳）
+     */
+    lastUpdateTime: number;
+}
+/**
+ * 服务实例健康状态
+ */
+export interface ServiceInstanceHealth {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * 实例标识（IP:Port）
+     */
+    instance: string;
+    /**
+     * 是否健康
+     */
+    healthy: boolean;
+    /**
+     * 健康检查时间（时间戳）
+     */
+    checkTime: number;
+    /**
+     * 连续失败次数
+     */
+    consecutiveFailures: number;
+    /**
+     * 最后成功时间（时间戳）
+     */
+    lastSuccessTime?: number;
+    /**
+     * 最后失败时间（时间戳）
+     */
+    lastFailureTime?: number;
+}
+/**
+ * 监控配置选项
+ */
+export interface MonitoringOptions {
+    /**
+     * 是否启用监控
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 指标收集间隔（毫秒）
+     * @default 60000
+     */
+    collectionInterval?: number;
+    /**
+     * 是否自动上报到 MetricsModule
+     * @default true
+     */
+    autoReportToMetrics?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/microservice/monitoring/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/microservice/monitoring/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/microservice/service-client/call-decorators.d.ts

@@ -0,0 +1,52 @@
+import 'reflect-metadata';
+import type { ServiceCallOptions } from './types';
+import type { Constructor } from '../../core/types';
+/**
+ * 服务调用元数据
+ */
+export interface ServiceCallMetadata {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * HTTP 方法
+     */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /**
+     * 请求路径
+     */
+    path: string;
+    /**
+     * 服务调用选项
+     */
+    options?: Partial<ServiceCallOptions>;
+}
+/**
+ * ServiceCall 装饰器
+ * 用于标记服务调用方法，自动注入 ServiceClient 调用逻辑
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   public constructor(
+ *     @ServiceClient() private readonly serviceClient: ServiceClient,
+ *   ) {}
+ *
+ *   @ServiceCall('user-service', 'GET', '/api/users/:id')
+ *   public async getUser(id: string): Promise<User> {
+ *     // 自动调用 user-service 的 /api/users/:id 接口
+ *     // 需要手动调用 serviceClient.call()，装饰器只提供元数据
+ *   }
+ * }
+ * ```
+ *
+ * 注意：此装饰器主要用于标记和提供元数据，实际调用仍需要通过 ServiceClient
+ */
+export declare function ServiceCall(serviceName: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', path: string, options?: Partial<ServiceCallOptions>): MethodDecorator;
+/**
+ * 获取方法的服务调用元数据
+ */
+export declare function getServiceCallMetadata(target: Constructor<unknown>): Map<string | symbol, ServiceCallMetadata>;
+//# sourceMappingURL=call-decorators.d.ts.map

package/dist/microservice/service-client/call-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-client/call-decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,SAAS,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEpD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,EACnD,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,eAAe,CAmCjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,mBAAmB,CAAC,CAE3C"}

package/dist/microservice/service-client/decorators.d.ts

@@ -0,0 +1,35 @@
+import 'reflect-metadata';
+import { ServiceClient as ServiceClientImpl } from './service-client';
+import type { Constructor } from '../../core/types';
+/**
+ * ServiceClient 装饰器
+ * 用于在类中注入 ServiceClient 实例
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   public constructor(
+ *     @ServiceClient() private readonly serviceClient: ServiceClient,
+ *   ) {}
+ *
+ *   public async callOtherService() {
+ *     return await this.serviceClient.call({
+ *       serviceName: 'other-service',
+ *       path: '/api/data',
+ *       method: 'GET',
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare function ServiceClient(): ParameterDecorator;
+/**
+ * 创建 ServiceClient 实例
+ */
+export declare function createServiceClient(): ServiceClientImpl;
+/**
+ * 获取需要注入 ServiceClient 的参数索引列表
+ */
+export declare function getServiceClientParameterIndices(target: Constructor<unknown>): number[];
+//# sourceMappingURL=decorators.d.ts.map

package/dist/microservice/service-client/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-client/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAItE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,CAwBlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CAavD;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,MAAM,EAAE,CAEV"}

package/dist/microservice/service-client/index.d.ts

@@ -0,0 +1,7 @@
+export { ServiceClient } from './service-client';
+export { LoadBalancerFactory, RandomLoadBalancer, RoundRobinLoadBalancer, WeightedRoundRobinLoadBalancer, ConsistentHashLoadBalancer, LeastActiveLoadBalancer, } from './load-balancer';
+export { TraceIdRequestInterceptor, UserInfoRequestInterceptor, RequestLogInterceptor, ResponseLogInterceptor, ResponseTransformInterceptor, ErrorHandlerInterceptor, } from './interceptors';
+export { ServiceClient as ServiceClientDecorator, createServiceClient, getServiceClientParameterIndices, } from './decorators';
+export { ServiceCall, getServiceCallMetadata, type ServiceCallMetadata, } from './call-decorators';
+export type { LoadBalanceStrategy, LoadBalancer, ServiceCallOptions, ServiceCallResponse, ServiceRequestInterceptor, ServiceResponseInterceptor, ServiceCallError, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/microservice/service-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,IAAI,sBAAsB,EACvC,mBAAmB,EACnB,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/microservice/service-client/interceptors.d.ts

@@ -0,0 +1,96 @@
+import type { ServiceCallOptions, ServiceCallResponse, ServiceRequestInterceptor, ServiceResponseInterceptor } from './types';
+/**
+ * 追踪 ID 请求拦截器
+ * 自动在请求头中添加追踪 ID
+ */
+export declare class TraceIdRequestInterceptor implements ServiceRequestInterceptor {
+    private readonly headerName;
+    private readonly traceIdGenerator;
+    constructor(options?: {
+        /**
+         * 追踪 ID 请求头名称
+         * @default 'X-Trace-Id'
+         */
+        headerName?: string;
+        /**
+         * 追踪 ID 生成器
+         * @default 生成 UUID v4
+         */
+        traceIdGenerator?: () => string;
+    });
+    intercept(options: ServiceCallOptions): ServiceCallOptions;
+    /**
+     * 生成追踪 ID（UUID v4 简化版）
+     */
+    private generateTraceId;
+}
+/**
+ * 用户信息请求拦截器
+ * 自动在请求头中添加用户信息
+ */
+export declare class UserInfoRequestInterceptor implements ServiceRequestInterceptor {
+    private readonly headerName;
+    private readonly userInfoProvider;
+    constructor(options: {
+        /**
+         * 用户信息请求头名称
+         * @default 'X-User-Info'
+         */
+        headerName?: string;
+        /**
+         * 用户信息提供者
+         */
+        userInfoProvider: () => string | undefined;
+    });
+    intercept(options: ServiceCallOptions): ServiceCallOptions;
+}
+/**
+ * 请求日志拦截器
+ * 记录请求日志
+ */
+export declare class RequestLogInterceptor implements ServiceRequestInterceptor {
+    private readonly logger?;
+    constructor(options?: {
+        /**
+         * 日志记录器
+         */
+        logger?: (message: string) => void;
+    });
+    intercept(options: ServiceCallOptions): ServiceCallOptions;
+}
+/**
+ * 响应日志拦截器
+ * 记录响应日志
+ */
+export declare class ResponseLogInterceptor implements ServiceResponseInterceptor {
+    private readonly logger?;
+    constructor(options?: {
+        /**
+         * 日志记录器
+         */
+        logger?: (message: string) => void;
+    });
+    intercept<T>(response: ServiceCallResponse<T>): ServiceCallResponse<T>;
+}
+/**
+ * 响应数据转换拦截器
+ * 转换响应数据格式
+ *
+ * 注意：这个拦截器会改变响应数据的类型，因此需要类型断言
+ */
+export declare class ResponseTransformInterceptor<TInput = unknown, TOutput = unknown> {
+    private readonly transformer;
+    constructor(transformer: (data: TInput) => TOutput);
+    /**
+     * 拦截响应并转换数据
+     */
+    intercept<T>(response: ServiceCallResponse<T>): ServiceCallResponse<TOutput>;
+}
+/**
+ * 错误处理拦截器
+ * 统一处理错误响应
+ */
+export declare class ErrorHandlerInterceptor implements ServiceResponseInterceptor {
+    intercept<T>(response: ServiceCallResponse<T>): ServiceCallResponse<T>;
+}
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/microservice/service-client/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-client/interceptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,yBAAyB;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAe;gBAE7B,OAAO,CAAC,EAAE;QAC3B;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB;;;WAGG;QACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;KACjC;IAKM,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB;IAWjE;;OAEG;IACH,OAAO,CAAC,eAAe;CAGxB;AAED;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,yBAAyB;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;gBAEzC,OAAO,EAAE;QAC1B;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,gBAAgB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;KAC5C;IAKM,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB;CAclE;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,yBAAyB;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA4B;gBAEjC,OAAO,CAAC,EAAE;QAC3B;;WAEG;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KACpC;IAIM,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB;CAQlE;AAED;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,0BAA0B;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA4B;gBAEjC,OAAO,CAAC,EAAE;QAC3B;;WAEG;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KACpC;IAIM,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAQ9E;AAED;;;;;GAKG;AACH,qBAAa,4BAA4B,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC3E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;gBAErC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO;IAIzD;;OAEG;IACI,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC;CAMpF;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,0BAA0B;IACjE,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAQ9E"}