kubeview-mcp 1.0.0

package/dist/src/kubernetes/CircuitBreaker.js

@@ -0,0 +1,369 @@
+/**
+ * Circuit Breaker Module
+ *
+ * Implements the circuit breaker pattern for fault tolerance in distributed systems.
+ * Prevents cascading failures by temporarily blocking requests to failing services.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Circuit breaker states
+ */
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+/**
+ * Default circuit breaker configuration
+ */
+export const DEFAULT_CIRCUIT_CONFIG = {
+    failureThreshold: 5,
+    successThreshold: 2,
+    failureCountWindow: 60000, // 1 minute
+    resetTimeout: 30000, // 30 seconds
+    failureRateThreshold: 50, // 50%
+    volumeThreshold: 10,
+    operationTimeout: 10000, // 10 seconds
+};
+/**
+ * Circuit breaker implementation
+ */
+export class CircuitBreaker extends EventEmitter {
+    state = CircuitState.CLOSED;
+    config;
+    logger;
+    stats;
+    resetTimer;
+    requestHistory = [];
+    lastStateChangeTime = new Date();
+    constructor(config, logger) {
+        super();
+        this.config = { ...DEFAULT_CIRCUIT_CONFIG, ...config };
+        this.logger = logger;
+        this.stats = this.initializeStats();
+    }
+    /**
+     * Execute an operation through the circuit breaker
+     */
+    async execute(operation) {
+        // Check if circuit is open
+        if (this.state === CircuitState.OPEN) {
+            this.logger?.warn(`Circuit breaker '${this.config.name}' is OPEN, rejecting request`);
+            this.emit('fallback');
+            if (this.config.fallback) {
+                return this.config.fallback();
+            }
+            throw new Error(`Circuit breaker '${this.config.name}' is OPEN`);
+        }
+        // Record attempt
+        this.stats.totalCalls++;
+        try {
+            // Execute with timeout if configured
+            const result = await this.executeWithTimeout(operation);
+            // Record success
+            this.recordSuccess();
+            this.emit('success', result);
+            return result;
+        }
+        catch (error) {
+            // Check if error should be counted as failure
+            if (this.shouldCountAsFailure(error)) {
+                this.recordFailure();
+                this.emit('failure', error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get current circuit statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            state: this.state,
+            failureRate: this.calculateFailureRate(),
+        };
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset() {
+        this.logger?.info(`Manually resetting circuit breaker '${this.config.name}'`);
+        this.transition(CircuitState.CLOSED);
+        this.stats = this.initializeStats();
+        this.requestHistory.length = 0;
+        this.clearResetTimer();
+    }
+    /**
+     * Force open the circuit
+     */
+    open() {
+        this.logger?.warn(`Manually opening circuit breaker '${this.config.name}'`);
+        this.transition(CircuitState.OPEN);
+    }
+    /**
+     * Initialize statistics
+     */
+    initializeStats() {
+        return {
+            state: this.state,
+            failures: 0,
+            successes: 0,
+            totalCalls: 0,
+            lastStateChange: new Date(),
+            consecutiveSuccesses: 0,
+            consecutiveFailures: 0,
+            failureRate: 0,
+        };
+    }
+    /**
+     * Execute operation with timeout
+     */
+    async executeWithTimeout(operation) {
+        if (!this.config.operationTimeout) {
+            return operation();
+        }
+        return Promise.race([
+            operation(),
+            new Promise((_, reject) => {
+                setTimeout(() => {
+                    this.emit('timeout');
+                    reject(new Error(`Operation timed out after ${this.config.operationTimeout}ms`));
+                }, this.config.operationTimeout);
+            }),
+        ]);
+    }
+    /**
+     * Record successful operation
+     */
+    recordSuccess() {
+        this.stats.successes++;
+        this.stats.consecutiveSuccesses++;
+        this.stats.consecutiveFailures = 0;
+        this.stats.lastSuccessTime = new Date();
+        // Add to history
+        this.addToHistory(true);
+        // Handle state transitions
+        if (this.state === CircuitState.HALF_OPEN) {
+            if (this.stats.consecutiveSuccesses >= this.config.successThreshold) {
+                this.logger?.info(`Circuit breaker '${this.config.name}' closing after ${this.stats.consecutiveSuccesses} successful attempts`);
+                this.transition(CircuitState.CLOSED);
+            }
+        }
+    }
+    /**
+     * Record failed operation
+     */
+    recordFailure() {
+        this.stats.failures++;
+        this.stats.consecutiveFailures++;
+        this.stats.consecutiveSuccesses = 0;
+        this.stats.lastFailureTime = new Date();
+        // Add to history
+        this.addToHistory(false);
+        // Check if we should open the circuit
+        if (this.state === CircuitState.CLOSED || this.state === CircuitState.HALF_OPEN) {
+            if (this.shouldOpenCircuit()) {
+                this.logger?.warn(`Circuit breaker '${this.config.name}' opening after ${this.stats.consecutiveFailures} failures`);
+                this.transition(CircuitState.OPEN);
+                this.scheduleReset();
+            }
+        }
+    }
+    /**
+     * Check if circuit should open based on failure conditions
+     */
+    shouldOpenCircuit() {
+        // Check consecutive failure threshold
+        if (this.stats.consecutiveFailures >= this.config.failureThreshold) {
+            return true;
+        }
+        // Check failure rate if configured
+        if (this.config.failureRateThreshold && this.config.volumeThreshold) {
+            const recentRequests = this.getRecentRequests();
+            if (recentRequests.length >= this.config.volumeThreshold) {
+                const failureRate = this.calculateFailureRate();
+                if (failureRate >= this.config.failureRateThreshold) {
+                    this.logger?.warn(`Circuit breaker '${this.config.name}' failure rate ${failureRate.toFixed(1)}% exceeds threshold`);
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Add request to history
+     */
+    addToHistory(success) {
+        const now = Date.now();
+        this.requestHistory.push({ timestamp: now, success });
+        // Clean old entries
+        const cutoff = now - this.config.failureCountWindow;
+        while (this.requestHistory.length > 0 && this.requestHistory[0].timestamp < cutoff) {
+            this.requestHistory.shift();
+        }
+    }
+    /**
+     * Get recent requests within the time window
+     */
+    getRecentRequests() {
+        const cutoff = Date.now() - this.config.failureCountWindow;
+        return this.requestHistory.filter((r) => r.timestamp >= cutoff);
+    }
+    /**
+     * Calculate current failure rate
+     */
+    calculateFailureRate() {
+        const recent = this.getRecentRequests();
+        if (recent.length === 0)
+            return 0;
+        const failures = recent.filter((r) => !r.success).length;
+        return (failures / recent.length) * 100;
+    }
+    /**
+     * Determine if error should count as failure
+     */
+    shouldCountAsFailure(error) {
+        if (this.config.isFailure) {
+            return this.config.isFailure(error);
+        }
+        // Default: all errors count as failures
+        return true;
+    }
+    /**
+     * Transition to new state
+     */
+    transition(newState) {
+        const oldState = this.state;
+        if (oldState === newState)
+            return;
+        this.state = newState;
+        this.lastStateChangeTime = new Date();
+        this.stats.lastStateChange = this.lastStateChangeTime;
+        // Reset consecutive counters on state change
+        if (newState === CircuitState.CLOSED) {
+            this.stats.consecutiveFailures = 0;
+            this.emit('circuit-close', this.getStats());
+        }
+        else if (newState === CircuitState.OPEN) {
+            this.stats.consecutiveSuccesses = 0;
+            this.emit('circuit-open', this.getStats());
+        }
+        else if (newState === CircuitState.HALF_OPEN) {
+            this.stats.consecutiveSuccesses = 0;
+            this.stats.consecutiveFailures = 0;
+            this.emit('circuit-half-open');
+        }
+        this.emit('state-change', oldState, newState);
+        this.logger?.info(`Circuit breaker '${this.config.name}' state changed: ${oldState} -> ${newState}`);
+    }
+    /**
+     * Schedule circuit reset attempt
+     */
+    scheduleReset() {
+        this.clearResetTimer();
+        this.resetTimer = setTimeout(() => {
+            this.logger?.info(`Circuit breaker '${this.config.name}' attempting reset to HALF_OPEN`);
+            this.transition(CircuitState.HALF_OPEN);
+        }, this.config.resetTimeout);
+    }
+    /**
+     * Clear reset timer
+     */
+    clearResetTimer() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = undefined;
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    dispose() {
+        this.clearResetTimer();
+        this.removeAllListeners();
+    }
+}
+/**
+ * Circuit breaker factory for managing multiple circuits
+ */
+export class CircuitBreakerFactory {
+    circuits = new Map();
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Get or create a circuit breaker
+     */
+    getOrCreate(config) {
+        let circuit = this.circuits.get(config.name);
+        if (!circuit) {
+            circuit = new CircuitBreaker(config, this.logger);
+            this.circuits.set(config.name, circuit);
+            this.logger?.debug(`Created new circuit breaker: ${config.name}`);
+        }
+        return circuit;
+    }
+    /**
+     * Get existing circuit breaker
+     */
+    get(name) {
+        return this.circuits.get(name);
+    }
+    /**
+     * Get all circuit breakers
+     */
+    getAll() {
+        return new Map(this.circuits);
+    }
+    /**
+     * Get statistics for all circuits
+     */
+    getAllStats() {
+        const stats = {};
+        for (const [name, circuit] of this.circuits) {
+            stats[name] = circuit.getStats();
+        }
+        return stats;
+    }
+    /**
+     * Reset all circuits
+     */
+    resetAll() {
+        for (const circuit of this.circuits.values()) {
+            circuit.reset();
+        }
+    }
+    /**
+     * Dispose all circuits
+     */
+    dispose() {
+        for (const circuit of this.circuits.values()) {
+            circuit.dispose();
+        }
+        this.circuits.clear();
+    }
+}
+/**
+ * Decorator for adding circuit breaker to methods
+ */
+export function WithCircuitBreaker(config) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const circuitName = `${target.constructor.name}.${propertyKey}`;
+        const circuit = new CircuitBreaker({ ...config, name: circuitName });
+        descriptor.value = async function (...args) {
+            return circuit.execute(() => originalMethod.apply(this, args));
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=CircuitBreaker.js.map

package/dist/src/kubernetes/CircuitBreaker.js.map

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

package/dist/src/kubernetes/ConnectionManager.d.ts

@@ -0,0 +1,60 @@
+import * as k8s from '@kubernetes/client-node';
+import { Logger } from 'winston';
+import { EventEmitter } from 'events';
+import { ConnectionPoolConfig, ConnectionEntry } from './ConnectionPool.js';
+/**
+ * Configuration for SingleClusterConnectionManager
+ */
+export interface ConnectionManagerConfig {
+    /**
+     * Connection pool configuration
+     */
+    poolConfig?: ConnectionPoolConfig;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+}
+/**
+ * Statistics for the managed cluster
+ */
+export interface ClusterStats {
+    healthy: boolean;
+    poolStats: {
+        total: number;
+        idle: number;
+        inUse: number;
+        unhealthy: number;
+        waitQueueLength: number;
+    };
+}
+/**
+ * Connection manager for handling a single Kubernetes cluster
+ */
+export declare class ConnectionManager extends EventEmitter {
+    private readonly pool;
+    private readonly logger?;
+    private disposed;
+    constructor(kubeConfigFactory: () => k8s.KubeConfig, config?: ConnectionManagerConfig);
+    /**
+     * Acquire a connection from the pool
+     */
+    acquire(): Promise<ConnectionEntry>;
+    /**
+     * Release a connection back to the pool
+     */
+    release(connection: ConnectionEntry): void;
+    /**
+     * Get statistics for the cluster
+     */
+    getStats(): ClusterStats;
+    /**
+     * Check if the cluster is healthy
+     */
+    private isClusterHealthy;
+    /**
+     * Dispose of the connection manager
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=ConnectionManager.d.ts.map

package/dist/src/kubernetes/ConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionManager.d.ts","sourceRoot":"","sources":["../../../src/kubernetes/ConnectionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAkB,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAElC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAS;gBAEb,iBAAiB,EAAE,MAAM,GAAG,CAAC,UAAU,EAAE,MAAM,GAAE,uBAA4B;IAsBzF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAOzC;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAI1C;;OAEG;IACH,QAAQ,IAAI,YAAY;IAOxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B"}

package/dist/src/kubernetes/ConnectionManager.js

@@ -0,0 +1,77 @@
+import { EventEmitter } from 'events';
+import { ConnectionPool } from './ConnectionPool.js';
+/**
+ * Connection manager for handling a single Kubernetes cluster
+ */
+export class ConnectionManager extends EventEmitter {
+    pool;
+    logger;
+    disposed = false;
+    constructor(kubeConfigFactory, config = {}) {
+        super();
+        this.logger = config.logger;
+        this.pool = new ConnectionPool('default', kubeConfigFactory, {
+            ...config.poolConfig,
+            logger: this.logger,
+        });
+        // Forward pool events
+        this.pool.on('connectionCreated', (conn) => {
+            this.emit('connectionCreated', { connection: conn });
+        });
+        this.pool.on('connectionRemoved', (conn) => {
+            this.emit('connectionRemoved', { connection: conn });
+        });
+        this.pool.on('connectionAcquired', (conn) => {
+            this.emit('connectionAcquired', { connection: conn });
+        });
+        this.pool.on('connectionReleased', (conn) => {
+            this.emit('connectionReleased', { connection: conn });
+        });
+    }
+    /**
+     * Acquire a connection from the pool
+     */
+    async acquire() {
+        if (this.disposed) {
+            throw new Error('Connection manager has been disposed');
+        }
+        return this.pool.acquire();
+    }
+    /**
+     * Release a connection back to the pool
+     */
+    release(connection) {
+        this.pool.release(connection);
+    }
+    /**
+     * Get statistics for the cluster
+     */
+    getStats() {
+        return {
+            healthy: this.isClusterHealthy(),
+            poolStats: this.pool.stats,
+        };
+    }
+    /**
+     * Check if the cluster is healthy
+     */
+    isClusterHealthy() {
+        const stats = this.pool.stats;
+        // Consider healthy if at least one available connection
+        return stats.total > 0 && (stats.idle > 0 || stats.inUse > 0);
+    }
+    /**
+     * Dispose of the connection manager
+     */
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.logger?.info('Disposing connection manager');
+        await this.pool.dispose();
+        this.emit('disposed');
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=ConnectionManager.js.map

package/dist/src/kubernetes/ConnectionManager.js.map

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