kubeview-mcp 1.0.0

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

@@ -0,0 +1,137 @@
+/**
+ * Retry strategy for Kubernetes operations
+ */
+import { Logger } from 'winston';
+/**
+ * Retry configuration options
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Initial delay in milliseconds before first retry */
+    initialDelayMs: number;
+    /** Maximum delay in milliseconds between retries */
+    maxDelayMs: number;
+    /** Exponential backoff factor (e.g., 2 for doubling) */
+    backoffMultiplier: number;
+    /** Jitter factor (0-1) to randomize delays */
+    jitterFactor: number;
+    /** Timeout for entire retry operation in milliseconds */
+    timeoutMs?: number;
+    /** Custom function to determine if error is retryable */
+    isRetryable?: (error: any) => boolean;
+    /** Callback for retry events */
+    onRetry?: (attempt: number, error: any, nextDelayMs: number) => void;
+}
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Preset configurations for common scenarios
+ */
+export declare const RETRY_PRESETS: {
+    /** Fast retries for transient network issues */
+    readonly FAST: {
+        readonly maxAttempts: 3;
+        readonly initialDelayMs: 100;
+        readonly maxDelayMs: 1000;
+        readonly backoffMultiplier: 2;
+        readonly jitterFactor: 0.1;
+        readonly timeoutMs: 5000;
+    };
+    /** Standard retries for most operations */
+    readonly STANDARD: RetryConfig;
+    /** Aggressive retries for critical operations */
+    readonly AGGRESSIVE: {
+        readonly maxAttempts: 5;
+        readonly initialDelayMs: 500;
+        readonly maxDelayMs: 60000;
+        readonly backoffMultiplier: 2;
+        readonly jitterFactor: 0.2;
+        readonly timeoutMs: 300000;
+    };
+    /** No retries */
+    readonly NONE: {
+        readonly maxAttempts: 1;
+        readonly initialDelayMs: 0;
+        readonly maxDelayMs: 0;
+        readonly backoffMultiplier: 1;
+        readonly jitterFactor: 0;
+    };
+};
+/**
+ * Retry context for tracking state
+ */
+export interface RetryContext {
+    attempt: number;
+    totalDelay: number;
+    startTime: number;
+    errors: any[];
+}
+/**
+ * Result of a retry operation
+ */
+export interface RetryResult<T> {
+    success: boolean;
+    value?: T;
+    error?: any;
+    attempts: number;
+    totalDelayMs: number;
+    totalTimeMs: number;
+}
+/**
+ * Retry strategy implementation
+ */
+export declare class RetryStrategy {
+    private readonly config;
+    private readonly logger?;
+    constructor(config?: Partial<RetryConfig>, logger?: Logger);
+    /**
+     * Execute an operation with retry logic
+     */
+    execute<T>(operation: () => Promise<T>, operationName?: string): Promise<RetryResult<T>>;
+    /**
+     * Wrap a function with retry logic
+     */
+    wrap<T extends (...args: any[]) => Promise<any>>(fn: T, operationName?: string): T;
+    /**
+     * Determine if an error is retryable
+     */
+    private shouldRetry;
+    /**
+     * Calculate delay for next retry attempt with exponential backoff and jitter
+     */
+    private calculateDelay;
+    /**
+     * Delay execution for specified milliseconds
+     */
+    private delay;
+}
+/**
+ * Retry builder for fluent configuration
+ */
+export declare class RetryBuilder {
+    private config;
+    private logger?;
+    withMaxAttempts(attempts: number): this;
+    withInitialDelay(ms: number): this;
+    withMaxDelay(ms: number): this;
+    withBackoffMultiplier(multiplier: number): this;
+    withJitterFactor(factor: number): this;
+    withTimeout(ms: number): this;
+    withRetryableCheck(fn: (error: any) => boolean): this;
+    withRetryCallback(fn: (attempt: number, error: any, nextDelayMs: number) => void): this;
+    withLogger(logger: Logger): this;
+    withPreset(preset: keyof typeof RETRY_PRESETS): this;
+    build(): RetryStrategy;
+}
+/**
+ * Convenience function to create a retry strategy
+ */
+export declare function createRetryStrategy(config?: Partial<RetryConfig>, logger?: Logger): RetryStrategy;
+/**
+ * Decorator for adding retry logic to methods
+ */
+export declare function Retryable(config?: Partial<RetryConfig>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=RetryStrategy.d.ts.map

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

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

package/dist/src/kubernetes/RetryStrategy.js

@@ -0,0 +1,277 @@
+/**
+ * Retry strategy for Kubernetes operations
+ */
+import { KubernetesError } from './ErrorHandling.js';
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    jitterFactor: 0.1,
+    timeoutMs: 60000,
+};
+/**
+ * Preset configurations for common scenarios
+ */
+export const RETRY_PRESETS = {
+    /** Fast retries for transient network issues */
+    FAST: {
+        maxAttempts: 3,
+        initialDelayMs: 100,
+        maxDelayMs: 1000,
+        backoffMultiplier: 2,
+        jitterFactor: 0.1,
+        timeoutMs: 5000,
+    },
+    /** Standard retries for most operations */
+    STANDARD: DEFAULT_RETRY_CONFIG,
+    /** Aggressive retries for critical operations */
+    AGGRESSIVE: {
+        maxAttempts: 5,
+        initialDelayMs: 500,
+        maxDelayMs: 60000,
+        backoffMultiplier: 2,
+        jitterFactor: 0.2,
+        timeoutMs: 300000,
+    },
+    /** No retries */
+    NONE: {
+        maxAttempts: 1,
+        initialDelayMs: 0,
+        maxDelayMs: 0,
+        backoffMultiplier: 1,
+        jitterFactor: 0,
+    },
+};
+/**
+ * Retry strategy implementation
+ */
+export class RetryStrategy {
+    config;
+    logger;
+    constructor(config = {}, logger) {
+        // If config is a preset, merge with DEFAULT_RETRY_CONFIG, then user config
+        let baseConfig = {};
+        if (config &&
+            config.maxAttempts !== undefined &&
+            config.initialDelayMs !== undefined) {
+            baseConfig = config;
+        }
+        // If config is a preset object (from RETRY_PRESETS), merge with default
+        this.config = { ...DEFAULT_RETRY_CONFIG, ...baseConfig, ...config };
+        this.logger = logger;
+    }
+    /**
+     * Execute an operation with retry logic
+     */
+    async execute(operation, operationName) {
+        let timeoutId = null;
+        let timeoutPromise = null;
+        if (this.config.timeoutMs) {
+            timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => {
+                    reject(new Error(`Operation timed out after ${this.config.timeoutMs}ms`));
+                }, this.config.timeoutMs);
+            });
+        }
+        let lastError = undefined;
+        let totalDelay = 0;
+        const startTime = Date.now();
+        for (let i = 0; i < this.config.maxAttempts; i++) {
+            try {
+                const race = timeoutPromise ? Promise.race([operation(), timeoutPromise]) : operation();
+                const opResult = await race;
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                return {
+                    success: true,
+                    value: opResult,
+                    attempts: i + 1,
+                    totalDelayMs: totalDelay,
+                    totalTimeMs: Date.now() - startTime,
+                };
+            }
+            catch (error) {
+                lastError = error;
+                if (i < this.config.maxAttempts - 1 &&
+                    this.shouldRetry(error, { attempt: i, totalDelay, startTime, errors: [] })) {
+                    const delayMs = this.calculateDelay(i + 1);
+                    totalDelay += delayMs;
+                    this.logger?.warn(`Retry attempt ${i + 2}/${this.config.maxAttempts} for ${operationName || 'operation'}`, {
+                        error: error instanceof Error ? error.message : String(error),
+                        nextDelayMs: delayMs,
+                        totalDelayMs: totalDelay,
+                    });
+                    this.config.onRetry?.(i + 1, error, delayMs);
+                    await this.delay(delayMs);
+                }
+                else {
+                    if (timeoutId)
+                        clearTimeout(timeoutId);
+                    return {
+                        success: false,
+                        error,
+                        attempts: i + 1,
+                        totalDelayMs: totalDelay,
+                        totalTimeMs: Date.now() - startTime,
+                    };
+                }
+            }
+        }
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        return {
+            success: false,
+            error: lastError,
+            attempts: this.config.maxAttempts,
+            totalDelayMs: totalDelay,
+            totalTimeMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * Wrap a function with retry logic
+     */
+    wrap(fn, operationName) {
+        return (async (...args) => {
+            const result = await this.execute(() => fn(...args), operationName);
+            if (!result.success) {
+                throw result.error;
+            }
+            return result.value;
+        });
+    }
+    /**
+     * Determine if an error is retryable
+     */
+    shouldRetry(error, context) {
+        // Check if we have attempts remaining
+        if (context.attempt >= this.config.maxAttempts) {
+            return false;
+        }
+        // Check timeout
+        if (this.config.timeoutMs) {
+            const elapsed = Date.now() - context.startTime;
+            if (elapsed + this.calculateDelay(context.attempt) > this.config.timeoutMs) {
+                return false;
+            }
+        }
+        // Use custom retry logic if provided
+        if (this.config.isRetryable) {
+            return this.config.isRetryable(error);
+        }
+        // Default retry logic for Kubernetes errors
+        if (error instanceof KubernetesError) {
+            return error.retryable;
+        }
+        // Retry on specific error conditions
+        const errorMessage = error?.message?.toLowerCase() || '';
+        const retryableConditions = [
+            'econnrefused',
+            'enotfound',
+            'etimedout',
+            'econnreset',
+            'epipe',
+            'network',
+            'timeout',
+            'socket hang up',
+            'service unavailable',
+            'bad gateway',
+            'gateway timeout',
+        ];
+        return retryableConditions.some((condition) => errorMessage.includes(condition));
+    }
+    /**
+     * Calculate delay for next retry attempt with exponential backoff and jitter
+     */
+    calculateDelay(attempt) {
+        // Calculate base delay with exponential backoff
+        const baseDelay = Math.min(this.config.initialDelayMs * Math.pow(this.config.backoffMultiplier, attempt - 1), this.config.maxDelayMs);
+        // Add jitter to prevent thundering herd
+        const jitter = baseDelay * this.config.jitterFactor * (Math.random() * 2 - 1);
+        return Math.max(0, Math.floor(baseDelay + jitter));
+    }
+    /**
+     * Delay execution for specified milliseconds
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Retry builder for fluent configuration
+ */
+export class RetryBuilder {
+    config = {};
+    logger;
+    withMaxAttempts(attempts) {
+        this.config.maxAttempts = attempts;
+        return this;
+    }
+    withInitialDelay(ms) {
+        this.config.initialDelayMs = ms;
+        return this;
+    }
+    withMaxDelay(ms) {
+        this.config.maxDelayMs = ms;
+        return this;
+    }
+    withBackoffMultiplier(multiplier) {
+        this.config.backoffMultiplier = multiplier;
+        return this;
+    }
+    withJitterFactor(factor) {
+        this.config.jitterFactor = factor;
+        return this;
+    }
+    withTimeout(ms) {
+        this.config.timeoutMs = ms;
+        return this;
+    }
+    withRetryableCheck(fn) {
+        this.config.isRetryable = fn;
+        return this;
+    }
+    withRetryCallback(fn) {
+        this.config.onRetry = fn;
+        return this;
+    }
+    withLogger(logger) {
+        this.logger = logger;
+        return this;
+    }
+    withPreset(preset) {
+        // User overrides should take precedence
+        this.config = { ...RETRY_PRESETS[preset], ...this.config };
+        return this;
+    }
+    build() {
+        return new RetryStrategy(this.config, this.logger);
+    }
+}
+/**
+ * Convenience function to create a retry strategy
+ */
+export function createRetryStrategy(config, logger) {
+    return new RetryStrategy(config, logger);
+}
+/**
+ * Decorator for adding retry logic to methods
+ */
+export function Retryable(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const strategy = new RetryStrategy(config);
+        descriptor.value = async function (...args) {
+            const result = await strategy.execute(() => originalMethod.apply(this, args), `${target.constructor.name}.${propertyKey}`);
+            if (!result.success) {
+                throw result.error;
+            }
+            return result.value;
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=RetryStrategy.js.map

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

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

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

@@ -0,0 +1,118 @@
+/**
+ * Retryable Operation Module
+ *
+ * Combines retry logic and circuit breaker pattern into a single
+ * reusable component for Kubernetes operations.
+ */
+import { Logger } from 'winston';
+import { RetryConfig } from './RetryStrategy.js';
+import { CircuitBreakerConfig } from './CircuitBreaker.js';
+import { ErrorMonitor, ErrorContext } from './ErrorHandling.js';
+/**
+ * Configuration for retryable operations
+ */
+export interface RetryableOperationConfig {
+    /** Retry configuration */
+    retry?: Partial<RetryConfig>;
+    /** Circuit breaker configuration */
+    circuitBreaker?: Partial<Omit<CircuitBreakerConfig, 'name'>>;
+    /** Error monitor instance */
+    errorMonitor?: ErrorMonitor;
+    /** Logger instance */
+    logger?: Logger;
+}
+/**
+ * Result of a retryable operation
+ */
+export interface OperationResult<T> {
+    success: boolean;
+    value?: T;
+    error?: any;
+    attempts: number;
+    totalTimeMs: number;
+    circuitState?: string;
+}
+/**
+ * Retryable operation that combines retry and circuit breaker
+ */
+export declare class RetryableOperation<T> {
+    private readonly operationName;
+    private readonly retryStrategy;
+    private readonly circuitBreaker;
+    private readonly errorMonitor?;
+    private readonly logger?;
+    constructor(operationName: string, config?: RetryableOperationConfig);
+    /**
+     * Execute an operation with retry and circuit breaker protection
+     */
+    execute<R = T>(operation: () => Promise<R>, context?: ErrorContext): Promise<OperationResult<R>>;
+    /**
+     * Execute operation and throw on failure
+     */
+    executeOrThrow<R = T>(operation: () => Promise<R>, context?: ErrorContext): Promise<R>;
+    /**
+     * Get circuit breaker state
+     */
+    getCircuitState(): string;
+    /**
+     * Get circuit breaker statistics
+     */
+    getCircuitStats(): import("./CircuitBreaker.js").CircuitStats;
+    /**
+     * Manually reset the circuit breaker
+     */
+    resetCircuit(): void;
+    /**
+     * Force open the circuit breaker
+     */
+    openCircuit(): void;
+    /**
+     * Set up circuit breaker event listeners
+     */
+    private setupCircuitBreakerEvents;
+    /**
+     * Cleanup resources
+     */
+    dispose(): void;
+}
+/**
+ * Factory for creating retryable operations
+ */
+export declare class RetryableOperationFactory {
+    private readonly operations;
+    private readonly defaultConfig;
+    constructor(defaultConfig?: RetryableOperationConfig, logger?: Logger);
+    /**
+     * Create or get a retryable operation
+     */
+    create<T>(operationName: string, config?: RetryableOperationConfig): RetryableOperation<T>;
+    /**
+     * Get an existing operation
+     */
+    get<T>(operationName: string): RetryableOperation<T> | undefined;
+    /**
+     * Remove an operation
+     */
+    remove(operationName: string): boolean;
+    /**
+     * Get all operation names
+     */
+    getOperationNames(): string[];
+    /**
+     * Get statistics for all operations
+     */
+    getAllStats(): Record<string, any>;
+    /**
+     * Reset all circuit breakers
+     */
+    resetAllCircuits(): void;
+    /**
+     * Dispose all operations
+     */
+    dispose(): void;
+}
+/**
+ * Decorator for making methods retryable
+ */
+export declare function RetryableMethod(operationName?: string, config?: RetryableOperationConfig): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=RetryableOperation.d.ts.map

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

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