kubeview-mcp 1.0.0

package/dist/src/kubernetes/ErrorHandling.js

@@ -0,0 +1,304 @@
+/**
+ * Kubernetes Client Error Handling Module
+ *
+ * This module provides a comprehensive error handling system for Kubernetes operations,
+ * including typed errors, monitoring, and conversion utilities.
+ */
+/**
+ * Base error class for all Kubernetes-related errors
+ */
+export class KubernetesError extends Error {
+    code;
+    statusCode;
+    details;
+    retryable;
+    timestamp;
+    constructor(message, code, statusCode, retryable = false, details) {
+        super(message);
+        this.name = 'KubernetesError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.retryable = retryable;
+        this.details = details || {};
+        this.timestamp = new Date();
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, KubernetesError.prototype);
+    }
+}
+/**
+ * Error thrown when authentication fails
+ */
+export class AuthenticationError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'AUTHENTICATION_ERROR', 401, false, details || {});
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}
+/**
+ * Error thrown when authorization fails
+ */
+export class AuthorizationError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'AUTHORIZATION_ERROR', 403, false, details || {});
+        this.name = 'AuthorizationError';
+        Object.setPrototypeOf(this, AuthorizationError.prototype);
+    }
+}
+/**
+ * Error thrown when a resource is not found
+ */
+export class ResourceNotFoundError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'RESOURCE_NOT_FOUND', 404, false, details || {});
+        this.name = 'ResourceNotFoundError';
+        Object.setPrototypeOf(this, ResourceNotFoundError.prototype);
+    }
+}
+/**
+ * Error thrown when a resource already exists (conflict)
+ */
+export class ResourceConflictError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'RESOURCE_CONFLICT', 409, false, details || {});
+        this.name = 'ResourceConflictError';
+        Object.setPrototypeOf(this, ResourceConflictError.prototype);
+    }
+}
+/**
+ * Error thrown when request validation fails
+ */
+export class ValidationError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, false, details || {});
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+/**
+ * Error thrown when the server is unavailable
+ */
+export class ServerUnavailableError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'SERVER_UNAVAILABLE', 503, true, details || {});
+        this.name = 'ServerUnavailableError';
+        Object.setPrototypeOf(this, ServerUnavailableError.prototype);
+    }
+}
+/**
+ * Error thrown when a timeout occurs
+ */
+export class TimeoutError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'TIMEOUT_ERROR', 408, true, details || {});
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+/**
+ * Error thrown when rate limiting is encountered
+ */
+export class RateLimitError extends KubernetesError {
+    constructor(message, retryAfter, details) {
+        super(message, 'RATE_LIMIT_ERROR', 429, true, { ...(details || {}), retryAfter });
+        this.name = 'RateLimitError';
+        Object.setPrototypeOf(this, RateLimitError.prototype);
+    }
+}
+/**
+ * Error thrown for network-related issues
+ */
+export class NetworkError extends KubernetesError {
+    constructor(message, details) {
+        super(message, 'NETWORK_ERROR', undefined, true, details || {});
+        this.name = 'NetworkError';
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+}
+/**
+ * Convert Kubernetes API errors to typed errors
+ */
+export function convertApiError(error) {
+    // Handle Kubernetes API response errors
+    if (error.response && error.response.body) {
+        const body = error.response.body;
+        const statusCode = error.response.statusCode || error.statusCode;
+        const message = body.message || body.reason || 'Unknown error';
+        const retryAfter = error.response.headers?.['retry-after'];
+        const details = {
+            kind: body.kind,
+            apiVersion: body.apiVersion,
+            reason: body.reason,
+            details: body.details,
+            code: body.code,
+        };
+        switch (statusCode) {
+            case 401:
+                return new AuthenticationError(message, details);
+            case 403:
+                return new AuthorizationError(message, details);
+            case 404:
+                return new ResourceNotFoundError(message, details);
+            case 409:
+                return new ResourceConflictError(message, details);
+            case 400:
+            case 422:
+                return new ValidationError(message, details);
+            case 429:
+                return new RateLimitError(message, retryAfter ? parseInt(retryAfter) : undefined, details);
+            case 408:
+                return new TimeoutError(message, details);
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                return new ServerUnavailableError(message, details);
+            default:
+                return new KubernetesError(message, 'API_ERROR', statusCode, statusCode >= 500, details);
+        }
+    }
+    // Handle network errors
+    if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND' || error.code === 'ETIMEDOUT') {
+        return new NetworkError(error.message, { code: error.code });
+    }
+    // Handle timeout errors
+    if (error.message && error.message.toLowerCase().includes('timeout')) {
+        return new TimeoutError(error.message);
+    }
+    // Default error
+    return new KubernetesError(error.message || 'Unknown error', 'UNKNOWN_ERROR', undefined, false, {
+        originalError: error.toString(),
+    });
+}
+/**
+ * Error monitor for tracking and analyzing errors
+ */
+export class ErrorMonitor {
+    logger;
+    stats = {
+        total: 0,
+        byType: {},
+        byStatusCode: {},
+        retryable: 0,
+        nonRetryable: 0,
+    };
+    errorLog = [];
+    maxLogSize = 1000;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Record an error
+     */
+    recordError(error, operation) {
+        this.stats.total++;
+        // Track by error type
+        this.stats.byType[error.name] = (this.stats.byType[error.name] || 0) + 1;
+        // Track by status code
+        if (error.statusCode) {
+            this.stats.byStatusCode[error.statusCode] =
+                (this.stats.byStatusCode[error.statusCode] || 0) + 1;
+        }
+        // Track retryable vs non-retryable
+        if (error.retryable) {
+            this.stats.retryable++;
+        }
+        else {
+            this.stats.nonRetryable++;
+        }
+        // Update last error
+        this.stats.lastError = {
+            message: error.message,
+            code: error.code,
+            timestamp: error.timestamp,
+        };
+        // Add to error log
+        this.errorLog.push({
+            error,
+            operation,
+            timestamp: new Date(),
+        });
+        // Trim log if it gets too large
+        if (this.errorLog.length > this.maxLogSize) {
+            this.errorLog = this.errorLog.slice(-this.maxLogSize);
+        }
+        // Log the error
+        this.logger?.error(`[${operation}] ${error.name}: ${error.message}`, {
+            code: error.code,
+            statusCode: error.statusCode,
+            retryable: error.retryable,
+            details: error.details,
+        });
+    }
+    /**
+     * Get error statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get recent errors
+     */
+    getRecentErrors(limit = 10) {
+        return this.errorLog.slice(-limit);
+    }
+    /**
+     * Clear statistics
+     */
+    clearStats() {
+        this.stats = {
+            total: 0,
+            byType: {},
+            byStatusCode: {},
+            retryable: 0,
+            nonRetryable: 0,
+        };
+        this.errorLog = [];
+    }
+    /**
+     * Get error rate for a specific time window
+     */
+    getErrorRate(windowMs = 60000) {
+        const cutoff = new Date(Date.now() - windowMs);
+        const recentErrors = this.errorLog.filter((entry) => entry.timestamp > cutoff);
+        return recentErrors.length;
+    }
+    /**
+     * Check if a specific error type is trending
+     */
+    isErrorTrending(errorType, threshold = 5, windowMs = 60000) {
+        const cutoff = new Date(Date.now() - windowMs);
+        const recentErrors = this.errorLog.filter((entry) => entry.timestamp > cutoff && entry.error.name === errorType);
+        return recentErrors.length >= threshold;
+    }
+}
+/**
+ * Enhanced error with context
+ */
+export function createContextualError(baseError, context) {
+    const mergedDetails = {
+        ...(baseError.details || {}),
+        ...context,
+    };
+    // Special handling for RateLimitError (constructor: message, retryAfter, details)
+    if (baseError instanceof RateLimitError) {
+        const retryAfter = baseError.details?.retryAfter;
+        return new RateLimitError(baseError.message, retryAfter, mergedDetails);
+    }
+    // For subclasses with (message, details) signature
+    if (baseError instanceof ValidationError ||
+        baseError instanceof AuthenticationError ||
+        baseError instanceof AuthorizationError ||
+        baseError instanceof ResourceNotFoundError ||
+        baseError instanceof ResourceConflictError ||
+        baseError instanceof ServerUnavailableError ||
+        baseError instanceof TimeoutError ||
+        baseError instanceof NetworkError) {
+        const ErrorClass = baseError.constructor;
+        return new ErrorClass(baseError.message, mergedDetails);
+    }
+    // For base KubernetesError (message, code, statusCode, retryable, details)
+    const ErrorClass = baseError.constructor;
+    return new ErrorClass(baseError.message, baseError.code, baseError.statusCode, baseError.retryable, mergedDetails);
+}
+//# sourceMappingURL=ErrorHandling.js.map

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

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

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

@@ -0,0 +1,162 @@
+import * as k8s from '@kubernetes/client-node';
+import { Logger } from 'winston';
+import { ResourceOperations } from './ResourceOperations.js';
+import type { ApiType, Configuration } from '@kubernetes/client-node';
+/**
+ * Configuration options for KubernetesClient
+ */
+export interface KubernetesClientConfig {
+    /**
+     * Path to kubeconfig file. If not specified, will try default locations
+     */
+    kubeConfigPath?: string;
+    /**
+     * Specific context to use from kubeconfig. If not specified, uses current context
+     */
+    context?: string;
+    /**
+     * Whether to use in-cluster configuration (for pods running inside k8s)
+     */
+    inCluster?: boolean;
+    /**
+     * Bearer token for authentication
+     */
+    bearerToken?: string;
+    /**
+     * Kubernetes API server URL (used with bearerToken)
+     */
+    apiServerUrl?: string;
+    /**
+     * Skip TLS verification (not recommended for production)
+     */
+    skipTlsVerify?: boolean;
+    /**
+     * Logger instance for debug output
+     */
+    logger?: Logger;
+}
+/**
+ * Authentication method types
+ */
+export declare enum AuthMethod {
+    KUBECONFIG = "kubeconfig",
+    IN_CLUSTER = "in-cluster",
+    TOKEN = "token"
+}
+/**
+ * KubernetesClient provides a high-level interface for interacting with Kubernetes clusters
+ */
+export declare class KubernetesClient {
+    private config;
+    private kc;
+    private coreV1Api;
+    private appsV1Api;
+    private batchV1Api;
+    private networkingV1Api;
+    private authMethod;
+    private logger?;
+    private _resources;
+    private _customObjectsApi?;
+    constructor(config?: KubernetesClientConfig);
+    /**
+     * Detect which authentication method to use based on configuration
+     */
+    private detectAuthMethod;
+    /**
+     * Initialize the Kubernetes client based on the detected auth method
+     */
+    private initializeClient;
+    /**
+     * Initialize using kubeconfig file
+     */
+    private initializeKubeConfig;
+    /**
+     * Initialize using in-cluster configuration
+     */
+    private initializeInClusterConfig;
+    /**
+     * Initialize using bearer token
+     */
+    private initializeTokenConfig;
+    /**
+     * Get the path to the kubeconfig file
+     */
+    private getKubeConfigPath;
+    /**
+     * Initialize API clients for different Kubernetes resources
+     */
+    private initializeApiClients;
+    /**
+     * Get the current cluster information
+     */
+    getCurrentCluster(): k8s.Cluster | null;
+    /**
+     * Get the current context name
+     */
+    getCurrentContext(): string;
+    /**
+     * Get all available contexts
+     */
+    getContexts(): string[];
+    /**
+     * Refresh the current context by reloading the kubeconfig file
+     * This ensures we always use the latest context when executing operations
+     */
+    refreshCurrentContext(): Promise<void>;
+    /**
+     * Switch to a different context
+     */
+    switchContext(contextName: string): Promise<void>;
+    /**
+     * Get the authentication method being used
+     */
+    getAuthMethod(): AuthMethod;
+    /**
+     * Test the connection to the Kubernetes API server
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Factory method to create a KubernetesClient from a kubeconfig file
+     */
+    static fromKubeConfig(kubeConfigPath?: string, context?: string, logger?: Logger): KubernetesClient;
+    /**
+     * Factory method to create a KubernetesClient for in-cluster use
+     */
+    static fromInCluster(logger?: Logger): KubernetesClient;
+    /**
+     * Factory method to create a KubernetesClient using a bearer token
+     */
+    static fromToken(apiServerUrl: string, bearerToken: string, skipTlsVerify?: boolean, logger?: Logger): KubernetesClient;
+    get core(): k8s.CoreV1Api;
+    get apps(): k8s.AppsV1Api;
+    get batch(): k8s.BatchV1Api;
+    get networking(): k8s.NetworkingV1Api;
+    get kubeConfig(): k8s.KubeConfig;
+    /**
+     * Get resource operations for working with Kubernetes resources
+     */
+    get resources(): ResourceOperations;
+    /**
+     * Returns a Kubernetes API client for the specified API constructor.
+     * This allows for accessing various Kubernetes APIs in a type-safe manner.
+     * @param apiClientConstructor The constructor of the API client to instantiate (e.g., k8s.CoreV1Api).
+     *                           It should conform to `new (config: Configuration) => T`.
+     * @returns An instance of the requested API client.
+     */
+    getGenericApiClient<T extends ApiType>(apiClientConstructor: new (config: Configuration) => T): T;
+    /**
+     * Makes a generic GET request to the Kubernetes API server.
+     * This is useful for accessing API endpoints not covered by specific client APIs (e.g., custom resources or aggregated APIs like metrics.k8s.io).
+     * @param path The API path to request (e.g., '/apis/metrics.k8s.io/v1beta1/nodes').
+     * @returns A promise that resolves with the API response.
+     * @throws Will throw an error if the request fails.
+     */
+    getRaw<T = any>(path: string): Promise<T>;
+    get customObjects(): k8s.CustomObjectsApi;
+    /**
+     * Sets whether to skip TLS verification for API requests
+     * @param skip True to skip TLS verification, false otherwise
+     */
+    setSkipTlsVerify(skip: boolean): void;
+}
+//# sourceMappingURL=KubernetesClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KubernetesClient.d.ts","sourceRoot":"","sources":["../../../src/kubernetes/KubernetesClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAWf,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,iBAAiB,CAAC,CAAuB;gBAE7B,MAAM,GAAE,sBAA2B;IAavD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAKjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACI,iBAAiB,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI;IAa9C;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,WAAW,IAAI,MAAM,EAAE;IAI9B;;;OAGG;IACU,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCnD;;OAEG;IACU,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;OAEG;IACI,aAAa,IAAI,UAAU;IAIlC;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAW/C;;OAEG;WACW,cAAc,CAC1B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB;IAQnB;;OAEG;WACW,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAO9D;;OAEG;WACW,SAAS,CACrB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,UAAQ,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB;IAUnB,IAAW,IAAI,IAAI,GAAG,CAAC,SAAS,CAE/B;IAED,IAAW,IAAI,IAAI,GAAG,CAAC,SAAS,CAE/B;IAED,IAAW,KAAK,IAAI,GAAG,CAAC,UAAU,CAEjC;IAED,IAAW,UAAU,IAAI,GAAG,CAAC,eAAe,CAE3C;IAED,IAAW,UAAU,IAAI,GAAG,CAAC,UAAU,CAEtC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,kBAAkB,CAEzC;IAED;;;;;;OAMG;IACI,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAC1C,oBAAoB,EAAE,KAAK,MAAM,EAAE,aAAa,KAAK,CAAC,GACrD,CAAC;IAIJ;;;;;;OAMG;IACU,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA0DtD,IAAW,aAAa,IAAI,GAAG,CAAC,gBAAgB,CAK/C;IAED;;;OAGG;IACI,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAI7C"}