@dangao/bun-server 1.3.0 → 1.5.0

package/dist/microservice/service-client/load-balancer.d.ts

@@ -0,0 +1,59 @@
+import type { ServiceInstance } from '../service-registry/types';
+import type { LoadBalancer, LoadBalanceStrategy } from './types';
+/**
+ * 随机负载均衡器
+ */
+export declare class RandomLoadBalancer implements LoadBalancer {
+    select(instances: ServiceInstance[]): ServiceInstance | null;
+}
+/**
+ * 轮询负载均衡器
+ */
+export declare class RoundRobinLoadBalancer implements LoadBalancer {
+    private currentIndex;
+    select(instances: ServiceInstance[]): ServiceInstance | null;
+    /**
+     * 重置轮询索引
+     */
+    reset(): void;
+}
+/**
+ * 加权轮询负载均衡器
+ */
+export declare class WeightedRoundRobinLoadBalancer implements LoadBalancer {
+    private currentIndex;
+    private currentWeight;
+    private maxWeight;
+    select(instances: ServiceInstance[]): ServiceInstance | null;
+    /**
+     * 重置轮询状态
+     */
+    reset(): void;
+}
+/**
+ * 一致性哈希负载均衡器
+ */
+export declare class ConsistentHashLoadBalancer implements LoadBalancer {
+    private readonly virtualNodes;
+    select(instances: ServiceInstance[], key?: string): ServiceInstance | null;
+    /**
+     * 简单的字符串哈希函数（FNV-1a）
+     */
+    private hash;
+}
+/**
+ * 最少连接负载均衡器（简化版：使用权重和健康状态）
+ */
+export declare class LeastActiveLoadBalancer implements LoadBalancer {
+    select(instances: ServiceInstance[]): ServiceInstance | null;
+}
+/**
+ * 负载均衡器工厂
+ */
+export declare class LoadBalancerFactory {
+    /**
+     * 创建负载均衡器
+     */
+    static create(strategy: LoadBalanceStrategy): LoadBalancer;
+}
+//# sourceMappingURL=load-balancer.d.ts.map

package/dist/microservice/service-client/load-balancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-balancer.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-client/load-balancer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAC9C,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI;CAQpE;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IACzD,OAAO,CAAC,YAAY,CAAa;IAE1B,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI;IAUnE;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB;AAED;;GAEG;AACH,qBAAa,8BAA+B,YAAW,YAAY;IACjE,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAa;IAEvB,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI;IAiCnE;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB;AAED;;GAEG;AACH,qBAAa,0BAA2B,YAAW,YAAY;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAErC,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAwCjF;;OAEG;IACH,OAAO,CAAC,IAAI;CAQb;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IACnD,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI;CAuBpE;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;WACW,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,YAAY;CAgBlE"}

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

@@ -0,0 +1,74 @@
+import type { ServiceRegistry } from '../service-registry/types';
+import { type CircuitBreakerOptions, type RateLimiterOptions, type RetryStrategy } from '../governance';
+import { Tracer } from '../tracing';
+import { ServiceMetricsCollector } from '../monitoring';
+import { type ServiceCallOptions, type ServiceCallResponse, type ServiceRequestInterceptor, type ServiceResponseInterceptor } from './types';
+/**
+ * 服务调用客户端
+ * 依赖 ServiceRegistry 抽象接口，不依赖具体实现
+ */
+export declare class ServiceClient {
+    private readonly serviceRegistry;
+    private readonly requestInterceptors;
+    private readonly responseInterceptors;
+    private readonly loadBalancers;
+    private readonly circuitBreakers;
+    private readonly rateLimiters;
+    private defaultCircuitBreakerOptions?;
+    private defaultRateLimiterOptions?;
+    private defaultRetryStrategy?;
+    private tracer?;
+    private metricsCollector?;
+    constructor(serviceRegistry: ServiceRegistry);
+    /**
+     * 设置默认熔断器配置
+     */
+    setDefaultCircuitBreakerOptions(options: CircuitBreakerOptions): void;
+    /**
+     * 设置默认限流器配置
+     */
+    setDefaultRateLimiterOptions(options: RateLimiterOptions): void;
+    /**
+     * 设置默认重试策略
+     */
+    setDefaultRetryStrategy(strategy: RetryStrategy): void;
+    /**
+     * 设置追踪器
+     */
+    setTracer(tracer: Tracer): void;
+    /**
+     * 设置监控指标收集器
+     */
+    setMetricsCollector(collector: ServiceMetricsCollector): void;
+    /**
+     * 添加请求拦截器
+     */
+    addRequestInterceptor(interceptor: ServiceRequestInterceptor): void;
+    /**
+     * 添加响应拦截器
+     */
+    addResponseInterceptor(interceptor: ServiceResponseInterceptor): void;
+    /**
+     * 调用服务
+     */
+    call<T = unknown>(options: ServiceCallOptions): Promise<ServiceCallResponse<T>>;
+    /**
+     * 流式调用服务（返回 ReadableStream）
+     * @param options - 服务调用选项
+     * @returns ReadableStream
+     */
+    callStream(options: ServiceCallOptions): Promise<ReadableStream>;
+    /**
+     * 执行流式 HTTP 请求
+     */
+    private executeStreamRequest;
+    /**
+     * 执行 HTTP 请求
+     */
+    private executeRequest;
+    /**
+     * 休眠（用于重试延迟）
+     */
+    private sleep;
+}
+//# sourceMappingURL=service-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-client/service-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,2BAA2B,CAAC;AAElF,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,MAAM,EAKP,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EAExB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAEhC,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmC;IACvE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAoC;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,4BAA4B,CAAC,CAAwB;IAC7D,OAAO,CAAC,yBAAyB,CAAC,CAAqB;IACvD,OAAO,CAAC,oBAAoB,CAAC,CAAgB;IAC7C,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAC,CAA0B;gBAEhC,eAAe,EAAE,eAAe;IAInD;;OAEG;IACI,+BAA+B,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI5E;;OAEG;IACI,4BAA4B,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAItE;;OAEG;IACI,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI7D;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,mBAAmB,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAIpE;;OAEG;IACI,qBAAqB,CAAC,WAAW,EAAE,yBAAyB,GAAG,IAAI;IAI1E;;OAEG;IACI,sBAAsB,CAAC,WAAW,EAAE,0BAA0B,GAAG,IAAI;IAI5E;;OAEG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAmJ5F;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqC7E;;OAEG;YACW,oBAAoB;IA0ElC;;OAEG;YACW,cAAc;IA4G5B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

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

@@ -0,0 +1,155 @@
+import type { ServiceInstance } from '../service-registry/types';
+/**
+ * 负载均衡策略类型
+ */
+export type LoadBalanceStrategy = 'random' | 'roundRobin' | 'weightedRoundRobin' | 'consistentHash' | 'leastActive';
+/**
+ * 负载均衡器接口
+ */
+export interface LoadBalancer {
+    /**
+     * 选择服务实例
+     * @param instances - 服务实例列表
+     * @param key - 用于一致性哈希的键（可选）
+     * @returns 选中的服务实例
+     */
+    select(instances: ServiceInstance[], key?: string): ServiceInstance | null;
+}
+/**
+ * 服务调用选项
+ */
+export interface ServiceCallOptions {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * HTTP 方法
+     */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /**
+     * 请求路径
+     */
+    path: string;
+    /**
+     * 请求头（可选）
+     */
+    headers?: Record<string, string>;
+    /**
+     * 请求体（可选）
+     */
+    body?: string | object;
+    /**
+     * 查询参数（可选）
+     */
+    query?: Record<string, string | number | boolean>;
+    /**
+     * 超时时间（毫秒）
+     * @default 5000
+     */
+    timeout?: number;
+    /**
+     * 重试次数
+     * @default 0
+     */
+    retryCount?: number;
+    /**
+     * 重试延迟（毫秒）
+     * @default 1000
+     */
+    retryDelay?: number;
+    /**
+     * 负载均衡策略
+     * @default 'roundRobin'
+     */
+    loadBalanceStrategy?: LoadBalanceStrategy;
+    /**
+     * 用于一致性哈希的键（可选）
+     */
+    consistentHashKey?: string;
+    /**
+     * 服务实例查询选项（可选）
+     */
+    instanceOptions?: {
+        namespaceId?: string;
+        groupName?: string;
+        clusterName?: string;
+        healthyOnly?: boolean;
+    };
+    /**
+     * 是否启用熔断器（可选）
+     * @default false
+     */
+    enableCircuitBreaker?: boolean;
+    /**
+     * 熔断器降级处理函数（可选）
+     */
+    fallback?: () => Promise<unknown> | unknown;
+    /**
+     * 是否启用限流（可选）
+     * @default false
+     */
+    enableRateLimit?: boolean;
+    /**
+     * 限流键（可选，默认使用服务名）
+     */
+    rateLimitKey?: string;
+    /**
+     * 是否流式响应（用于 Server-Sent Events 等）
+     * @default false
+     */
+    stream?: boolean;
+}
+/**
+ * 服务调用响应
+ */
+export interface ServiceCallResponse<T = unknown> {
+    /**
+     * HTTP 状态码
+     */
+    status: number;
+    /**
+     * 响应头
+     */
+    headers: Record<string, string>;
+    /**
+     * 响应体
+     */
+    data: T;
+    /**
+     * 使用的服务实例
+     */
+    instance: ServiceInstance;
+}
+/**
+ * 服务请求拦截器接口
+ */
+export interface ServiceRequestInterceptor {
+    /**
+     * 拦截请求
+     * @param options - 服务调用选项
+     * @returns 修改后的选项或 Promise
+     */
+    intercept(options: ServiceCallOptions): ServiceCallOptions | Promise<ServiceCallOptions>;
+}
+/**
+ * 服务响应拦截器接口
+ */
+export interface ServiceResponseInterceptor {
+    /**
+     * 拦截响应
+     * @param response - 服务调用响应
+     * @returns 修改后的响应或 Promise
+     */
+    intercept<T>(response: ServiceCallResponse<T>): ServiceCallResponse<T> | Promise<ServiceCallResponse<T>>;
+}
+/**
+ * 服务调用错误
+ */
+export declare class ServiceCallError extends Error {
+    readonly status?: number | undefined;
+    readonly response?: unknown | undefined;
+    readonly instance?: ServiceInstance | undefined;
+    constructor(message: string, status?: number | undefined, response?: unknown | undefined, instance?: ServiceInstance | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,84 @@
+import 'reflect-metadata';
+import type { Constructor } from '../../core/types';
+/**
+ * 服务注册元数据
+ */
+export interface ServiceRegistryMetadata {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * 服务 IP（可选，默认从 Application 获取）
+     */
+    ip?: string;
+    /**
+     * 服务端口（可选，默认从 Application 获取）
+     */
+    port?: number;
+    /**
+     * 服务权重（可选）
+     */
+    weight?: number;
+    /**
+     * 是否启用（可选）
+     */
+    enabled?: boolean;
+    /**
+     * 元数据（可选）
+     */
+    metadata?: Record<string, string>;
+    /**
+     * 集群名（可选）
+     */
+    clusterName?: string;
+    /**
+     * 命名空间（可选）
+     */
+    namespaceId?: string;
+    /**
+     * 分组名（可选）
+     */
+    groupName?: string;
+    /**
+     * 是否健康（可选）
+     */
+    healthy?: boolean;
+}
+/**
+ * ServiceRegistry 装饰器
+ * 用于自动注册服务到注册中心
+ *
+ * @example
+ * ```typescript
+ * @ServiceRegistry('my-service', { port: 3000 })
+ * @Controller('/api')
+ * class MyController {
+ *   // 服务会在应用启动时自动注册
+ * }
+ * ```
+ */
+export declare function ServiceRegistry(serviceName: string, options?: {
+    ip?: string;
+    port?: number;
+    weight?: number;
+    enabled?: boolean;
+    metadata?: Record<string, string>;
+    clusterName?: string;
+    namespaceId?: string;
+    groupName?: string;
+    healthy?: boolean;
+}): ClassDecorator;
+/**
+ * 获取服务注册元数据
+ */
+export declare function getServiceRegistryMetadata(target: Constructor<unknown>): ServiceRegistryMetadata | undefined;
+/**
+ * 注册服务实例
+ */
+export declare function registerServiceInstance(target: Constructor<unknown>, appPort?: number, appHost?: string): Promise<void>;
+/**
+ * 注销服务实例
+ */
+export declare function deregisterServiceInstance(target: Constructor<unknown>, appPort?: number, appHost?: string): Promise<void>;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,uBAAuB,GAAG,SAAS,CAErC;AAKD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAwDf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/microservice/service-registry/discovery-decorators.d.ts

@@ -0,0 +1,58 @@
+import 'reflect-metadata';
+import type { Constructor } from '../../core/types';
+/**
+ * 服务发现元数据
+ */
+export interface ServiceDiscoveryMetadata {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * 服务实例查询选项
+     */
+    options?: {
+        namespaceId?: string;
+        groupName?: string;
+        clusterName?: string;
+        healthyOnly?: boolean;
+    };
+    /**
+     * 属性名（用于注入服务实例列表）
+     */
+    propertyKey?: string | symbol;
+}
+/**
+ * ServiceDiscovery 装饰器
+ * 用于自动注入服务实例列表
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class MyService {
+ *   @ServiceDiscovery('my-service')
+ *   public instances: ServiceInstance[] = [];
+ *
+ *   public async getServiceInstances() {
+ *     // instances 会自动更新
+ *     return this.instances;
+ *   }
+ * }
+ * ```
+ */
+export declare function ServiceDiscovery(serviceName: string, options?: {
+    namespaceId?: string;
+    groupName?: string;
+    clusterName?: string;
+    healthyOnly?: boolean;
+}): PropertyDecorator;
+/**
+ * 获取类的所有服务发现元数据
+ */
+export declare function getServiceDiscoveryMetadata(target: Constructor<unknown>): Map<string | symbol, ServiceDiscoveryMetadata>;
+/**
+ * 初始化类的服务发现属性
+ * 在类实例化后调用，自动加载服务实例列表
+ */
+export declare function initializeServiceDiscovery(instance: object, target: Constructor<unknown>): Promise<void>;
+//# sourceMappingURL=discovery-decorators.d.ts.map

package/dist/microservice/service-registry/discovery-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-decorators.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/discovery-decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,iBAAiB,CAoCnB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,wBAAwB,CAAC,CAIhD;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/microservice/service-registry/health-integration.d.ts

@@ -0,0 +1,32 @@
+import type { ServiceInstance } from './types';
+/**
+ * 健康检查与服务注册集成器
+ * 根据健康检查状态自动更新服务注册的健康状态
+ */
+export declare class ServiceRegistryHealthIntegration {
+    private serviceRegistry?;
+    private healthIndicators;
+    private updateInterval?;
+    private registeredInstances;
+    /**
+     * 注册服务实例并启动健康检查集成
+     */
+    registerWithHealthCheck(instance: ServiceInstance): Promise<void>;
+    /**
+     * 启动健康检查更新
+     */
+    private startHealthCheckUpdates;
+    /**
+     * 更新所有注册服务的健康状态
+     */
+    private updateHealthStatus;
+    /**
+     * 检查应用健康状态
+     */
+    private checkHealth;
+    /**
+     * 停止健康检查更新
+     */
+    stop(): void;
+}
+//# sourceMappingURL=health-integration.d.ts.map

package/dist/microservice/service-registry/health-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-integration.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/health-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,SAAS,CAAC;AAMhE;;;GAGG;AACH,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,cAAc,CAAC,CAAiC;IACxD,OAAO,CAAC,mBAAmB,CAA2C;IAEtE;;OAEG;IACU,uBAAuB,CAClC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;IAiChB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;YACW,kBAAkB;IAkChC;;OAEG;YACW,WAAW;IAqBzB;;OAEG;IACI,IAAI,IAAI,IAAI;CAMpB"}

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

@@ -0,0 +1,10 @@
+export { ServiceRegistryModule } from './service-registry-module';
+export type { ServiceRegistryModuleOptions, ServiceRegistryProvider, NacosServiceRegistryOptions } from './service-registry-module';
+export { NacosServiceRegistry } from './nacos-service-registry';
+export { SERVICE_REGISTRY_TOKEN } from './types';
+export type { GetInstancesOptions, InstancesChangeListener, ServiceInstance, ServiceRegistry } from './types';
+export { ServiceRegistry as ServiceRegistryDecorator, getServiceRegistryMetadata, registerServiceInstance, deregisterServiceInstance, } from './decorators';
+export { ServiceDiscovery, getServiceDiscoveryMetadata, initializeServiceDiscovery, type ServiceDiscoveryMetadata, } from './discovery-decorators';
+export { ServiceRegistryHealthIntegration } from './health-integration';
+export type { ServiceRegistryMetadata } from './decorators';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACpI,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EACL,eAAe,IAAI,wBAAwB,EAC3C,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/microservice/service-registry/nacos-service-registry.d.ts

@@ -0,0 +1,68 @@
+import { NacosClient } from '@dangao/nacos-client';
+import type { ServiceInstance, GetInstancesOptions, InstancesChangeListener, ServiceRegistry } from './types';
+/**
+ * Nacos 服务注册中心实现
+ * 实现 ServiceRegistry 接口，内部使用 @dangao/nacos-client
+ */
+export declare class NacosServiceRegistry implements ServiceRegistry {
+    private readonly client;
+    private readonly serviceClient;
+    private readonly watchers;
+    private readonly watchInterval;
+    private readonly heartbeatInterval;
+    private heartbeatTimers;
+    constructor(client: NacosClient, options?: {
+        /**
+         * 服务实例变更监听轮询间隔（毫秒）
+         * @default 5000
+         */
+        watchInterval?: number;
+        /**
+         * 心跳间隔（毫秒）
+         * @default 5000
+         */
+        heartbeatInterval?: number;
+    });
+    /**
+     * 注册服务实例
+     */
+    register(instance: ServiceInstance): Promise<void>;
+    /**
+     * 注销服务实例
+     */
+    deregister(instance: ServiceInstance): Promise<void>;
+    /**
+     * 续约服务实例（心跳）
+     */
+    renew(instance: ServiceInstance): Promise<void>;
+    /**
+     * 查询服务实例列表
+     */
+    getInstances(serviceName: string, options?: GetInstancesOptions): Promise<ServiceInstance[]>;
+    /**
+     * 监听服务实例变更
+     * 通过轮询实现服务实例变更监听（Nacos 3.X 移除 UDP 推送）
+     */
+    watchInstances(serviceName: string, listener: InstancesChangeListener, options?: GetInstancesOptions): () => void;
+    /**
+     * 关闭注册中心连接
+     */
+    close(): Promise<void>;
+    /**
+     * 启动心跳机制
+     */
+    private startHeartbeat;
+    /**
+     * 停止心跳机制
+     */
+    private stopHeartbeat;
+    /**
+     * 生成监听器 key
+     */
+    private getWatchKey;
+    /**
+     * 生成实例 key
+     */
+    private getInstanceKey;
+}
+//# sourceMappingURL=nacos-service-registry.d.ts.map

package/dist/microservice/service-registry/nacos-service-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nacos-service-registry.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/nacos-service-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqF;IAC9G,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;IAClD,OAAO,CAAC,eAAe,CAAkC;gBAGvD,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;QACR;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;;WAGG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;IAQH;;OAEG;IACU,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/D;;OAEG;IACU,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE;;OAEG;IACU,KAAK,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D;;OAEG;IACU,YAAY,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC;IAuB7B;;;OAGG;IACI,cAAc,CACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,IAAI;IAwCb;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAcnC;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,cAAc;CAWvB"}

package/dist/microservice/service-registry/service-registry-module.d.ts

@@ -0,0 +1,48 @@
+import type { NacosClientOptions } from '@dangao/nacos-client';
+/**
+ * 服务注册中心 Provider 类型
+ */
+export type ServiceRegistryProvider = 'nacos' | 'consul' | 'eureka' | 'etcd';
+/**
+ * Nacos 服务注册中心选项
+ */
+export interface NacosServiceRegistryOptions {
+    /**
+     * Nacos 客户端配置
+     */
+    client: NacosClientOptions;
+    /**
+     * 服务实例变更监听轮询间隔（毫秒）
+     * @default 5000
+     */
+    watchInterval?: number;
+    /**
+     * 心跳间隔（毫秒）
+     * @default 5000
+     */
+    heartbeatInterval?: number;
+}
+/**
+ * 服务注册中心模块选项
+ */
+export interface ServiceRegistryModuleOptions {
+    /**
+     * Provider 类型
+     */
+    provider: ServiceRegistryProvider;
+    /**
+     * Nacos 配置（当 provider 为 'nacos' 时使用）
+     */
+    nacos?: NacosServiceRegistryOptions;
+}
+/**
+ * 服务注册中心模块
+ */
+export declare class ServiceRegistryModule {
+    /**
+     * 创建服务注册中心模块
+     * @param options - 模块配置
+     */
+    static forRoot(options: ServiceRegistryModuleOptions): typeof ServiceRegistryModule;
+}
+//# sourceMappingURL=service-registry-module.d.ts.map

package/dist/microservice/service-registry/service-registry-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry-module.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/service-registry-module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,uBAAuB,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,2BAA2B,CAAC;CAKrC;AAED;;GAEG;AACH,qBAGa,qBAAqB;IAChC;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,qBAAqB;CAwC3F"}