@wundr.io/mcp-registry 1.0.3

package/dist/health-monitor.d.ts

@@ -0,0 +1,304 @@
+/**
+ * @wundr.io/mcp-registry - Health Monitor
+ *
+ * Server health tracking, monitoring, and automatic recovery.
+ * Provides continuous health checks and status reporting.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { MCPServerRegistry } from './registry';
+import type { HealthStatus, HealthLevel, HealthCheckResult, HealthMonitorConfig, MCPServerRegistration } from './types';
+/**
+ * Error thrown when health check fails
+ */
+export declare class HealthCheckError extends Error {
+    readonly serverId: string;
+    readonly checkName: string;
+    constructor(serverId: string, checkName: string, message?: string);
+}
+/**
+ * Event map for health monitor events
+ */
+export interface HealthMonitorEvents {
+    'health:checked': (event: HealthCheckEvent) => void;
+    'health:changed': (event: HealthChangeEvent) => void;
+    'health:degraded': (event: HealthChangeEvent) => void;
+    'health:recovered': (event: HealthChangeEvent) => void;
+    'health:failed': (event: HealthChangeEvent) => void;
+    'server:connected': (event: ConnectionEvent) => void;
+    'server:disconnected': (event: ConnectionEvent) => void;
+    'monitor:started': () => void;
+    'monitor:stopped': () => void;
+}
+/**
+ * Health check event data
+ */
+export interface HealthCheckEvent {
+    readonly serverId: string;
+    readonly status: HealthStatus;
+    readonly checks: readonly HealthCheckResult[];
+    readonly timestamp: Date;
+}
+/**
+ * Health change event data
+ */
+export interface HealthChangeEvent {
+    readonly serverId: string;
+    readonly previousStatus: HealthLevel;
+    readonly newStatus: HealthLevel;
+    readonly reason?: string;
+    readonly timestamp: Date;
+}
+/**
+ * Connection event data
+ */
+export interface ConnectionEvent {
+    readonly serverId: string;
+    readonly connected: boolean;
+    readonly timestamp: Date;
+}
+/**
+ * Health check function type
+ */
+export type HealthCheckFn = (server: MCPServerRegistration) => Promise<HealthCheckResult>;
+/**
+ * Registered health check
+ */
+export interface RegisteredHealthCheck {
+    /** Check name */
+    readonly name: string;
+    /** Check function */
+    readonly check: HealthCheckFn;
+    /** Whether check is critical (affects overall status) */
+    readonly critical: boolean;
+    /** Check timeout in milliseconds */
+    readonly timeout: number;
+}
+/**
+ * Server Health Monitor
+ *
+ * Provides continuous health monitoring for registered MCP servers.
+ * Tracks connection status, latency, and custom health checks.
+ *
+ * @example
+ * ```typescript
+ * const monitor = new ServerHealthMonitor(registry, {
+ *   checkInterval: 10000,
+ *   pingTimeout: 5000,
+ *   failureThreshold: 3,
+ * });
+ *
+ * // Register custom health check
+ * monitor.registerCheck({
+ *   name: 'memory-usage',
+ *   check: async (server) => ({
+ *     name: 'memory-usage',
+ *     status: 'healthy',
+ *     durationMs: 10,
+ *     timestamp: new Date(),
+ *   }),
+ *   critical: false,
+ *   timeout: 5000,
+ * });
+ *
+ * // Start monitoring
+ * await monitor.start();
+ *
+ * // Get server health
+ * const health = monitor.getHealth('server-id');
+ * ```
+ */
+export declare class ServerHealthMonitor extends EventEmitter<HealthMonitorEvents> {
+    private readonly registry;
+    /** Configuration */
+    private readonly config;
+    /** Registered health checks */
+    private readonly healthChecks;
+    /** Latency history by server ID */
+    private readonly latencyHistory;
+    /** Consecutive failure counts by server ID */
+    private readonly failureCounts;
+    /** Consecutive success counts by server ID */
+    private readonly successCounts;
+    /** Monitoring interval handle */
+    private monitoringInterval?;
+    /** Whether monitoring is active */
+    private isMonitoring;
+    /** Request counts by server ID */
+    private readonly requestCounts;
+    /**
+     * Creates a new ServerHealthMonitor
+     *
+     * @param registry - The server registry
+     * @param config - Health monitor configuration
+     */
+    constructor(registry: MCPServerRegistry, config?: HealthMonitorConfig);
+    /**
+     * Start health monitoring
+     */
+    start(): Promise<void>;
+    /**
+     * Stop health monitoring
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if monitoring is active
+     *
+     * @returns True if monitoring is active
+     */
+    isActive(): boolean;
+    /**
+     * Register a custom health check
+     *
+     * @param check - Health check to register
+     */
+    registerCheck(check: RegisteredHealthCheck): void;
+    /**
+     * Unregister a health check
+     *
+     * @param name - Check name to unregister
+     */
+    unregisterCheck(name: string): void;
+    /**
+     * Get all registered checks
+     *
+     * @returns Array of registered health checks
+     */
+    getRegisteredChecks(): readonly RegisteredHealthCheck[];
+    /**
+     * Get health status for a server
+     *
+     * @param serverId - Server ID
+     * @returns Health status or undefined
+     */
+    getHealth(serverId: string): HealthStatus | undefined;
+    /**
+     * Get health statuses for all servers
+     *
+     * @returns Map of server ID to health status
+     */
+    getAllHealth(): ReadonlyMap<string, HealthStatus>;
+    /**
+     * Force a health check for a specific server
+     *
+     * @param serverId - Server ID
+     * @returns Health status after check
+     */
+    checkServer(serverId: string): Promise<HealthStatus>;
+    /**
+     * Check health of all servers
+     */
+    checkAllServers(): Promise<void>;
+    /**
+     * Record a request for a server
+     *
+     * @param serverId - Server ID
+     * @param success - Whether request was successful
+     * @param latencyMs - Request latency in milliseconds
+     */
+    recordRequest(serverId: string, success: boolean, latencyMs?: number): void;
+    /**
+     * Perform health check on a server
+     */
+    private performHealthCheck;
+    /**
+     * Run a health check with timeout
+     */
+    private runCheckWithTimeout;
+    /**
+     * Create the default ping check
+     */
+    private createPingCheck;
+    /**
+     * Record latency for a server
+     */
+    private recordLatency;
+    /**
+     * Calculate average latency for a server
+     */
+    private calculateAverageLatency;
+    /**
+     * Increment failure count for a server
+     */
+    private incrementFailureCount;
+    /**
+     * Reset failure count for a server
+     */
+    private resetFailureCount;
+    /**
+     * Increment success count for a server
+     */
+    private incrementSuccessCount;
+    /**
+     * Reset success count for a server
+     */
+    private resetSuccessCount;
+    /**
+     * Update health status from consecutive counts
+     */
+    private updateHealthFromCounts;
+    /**
+     * Emit health check event
+     */
+    private emitHealthCheckEvent;
+    /**
+     * Emit health change event
+     */
+    private emitHealthChangeEvent;
+    /**
+     * Get monitoring statistics
+     *
+     * @returns Health monitor statistics
+     */
+    getStats(): HealthMonitorStats;
+    /**
+     * Reset all monitoring state
+     */
+    reset(): void;
+    /**
+     * Get configuration
+     *
+     * @returns Current configuration
+     */
+    getConfig(): Readonly<Required<HealthMonitorConfig>>;
+}
+/**
+ * Health monitor statistics
+ */
+export interface HealthMonitorStats {
+    /** Whether monitoring is active */
+    readonly isMonitoring: boolean;
+    /** Check interval in milliseconds */
+    readonly checkInterval: number;
+    /** Total number of servers */
+    readonly totalServers: number;
+    /** Number of healthy servers */
+    readonly healthyServers: number;
+    /** Number of degraded servers */
+    readonly degradedServers: number;
+    /** Number of unhealthy servers */
+    readonly unhealthyServers: number;
+    /** Number of servers with unknown status */
+    readonly unknownServers: number;
+    /** Number of registered health checks */
+    readonly registeredChecks: number;
+}
+/**
+ * Create a new ServerHealthMonitor
+ *
+ * @param registry - The server registry
+ * @param config - Optional health monitor configuration
+ * @returns New health monitor instance
+ *
+ * @example
+ * ```typescript
+ * const monitor = createServerHealthMonitor(registry, {
+ *   checkInterval: 10000,
+ *   pingTimeout: 5000,
+ * });
+ * await monitor.start();
+ * ```
+ */
+export declare function createServerHealthMonitor(registry: MCPServerRegistry, config?: HealthMonitorConfig): ServerHealthMonitor;
+//# sourceMappingURL=health-monitor.d.ts.map

package/dist/health-monitor.d.ts.map

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