typekro 0.1.0

package/dist/core/kubernetes/api.js

@@ -0,0 +1,209 @@
+// kubernetes-api.ts
+import * as k8s from '@kubernetes/client-node';
+import { getComponentLogger } from '../logging/index.js';
+import { createKubernetesClientProvider } from './client-provider.js';
+/**
+ * A Kubernetes API client that reads configuration from environment variables.
+ * This client provides basic apply, get, and delete operations for Kubernetes resources.
+ */
+export class KubernetesApi {
+    kc;
+    k8sApi;
+    logger = getComponentLogger('kubernetes-api');
+    constructor() {
+        const config = this.loadConfigFromEnv();
+        // Use the centralized KubernetesClientProvider
+        const clientConfig = {
+            cluster: {
+                name: 'default-cluster',
+                server: config.apiServer,
+                skipTLSVerify: config.skipTLSVerify === true,
+                ...(config.caCert && { caData: config.caCert }),
+            },
+            user: {
+                name: 'default-user',
+                token: config.apiToken,
+            },
+            context: 'default-context',
+        };
+        const clientProvider = createKubernetesClientProvider(clientConfig);
+        this.kc = clientProvider.getKubeConfig();
+        this.k8sApi = clientProvider.getKubernetesApi();
+    }
+    /**
+     * Loads Kubernetes API configuration from environment variables.
+     * @throws Error if KUBERNETES_API_SERVER or KUBERNETES_API_TOKEN are not set.
+     */
+    loadConfigFromEnv() {
+        const apiServer = process.env.KUBERNETES_API_SERVER;
+        const apiToken = process.env.KUBERNETES_API_TOKEN;
+        const caCert = process.env.KUBERNETES_CA_CERT;
+        const skipTLSVerify = process.env.KUBERNETES_SKIP_TLS_VERIFY === 'true';
+        if (!apiServer) {
+            throw new Error('KUBERNETES_API_SERVER environment variable is not set.');
+        }
+        if (!apiToken) {
+            throw new Error('KUBERNETES_API_TOKEN environment variable is not set.');
+        }
+        // Log security warning when TLS is disabled
+        if (skipTLSVerify) {
+            this.logger.warn('TLS verification disabled via environment variable - this is insecure and should only be used in development', {
+                component: 'kubernetes-api',
+                security: 'tls-disabled',
+                envVar: 'KUBERNETES_SKIP_TLS_VERIFY'
+            });
+        }
+        // Validate TLS configuration
+        this.validateTLSConfiguration(apiServer, caCert, skipTLSVerify);
+        return {
+            apiServer,
+            apiToken,
+            ...(caCert && { caCert }),
+            skipTLSVerify,
+        };
+    }
+    /**
+     * Validate TLS configuration and provide actionable error messages
+     */
+    validateTLSConfiguration(apiServer, caCert, skipTLSVerify) {
+        // Check if connecting to HTTPS endpoint without proper TLS configuration
+        if (apiServer.startsWith('https://')) {
+            if (skipTLSVerify && !caCert) {
+                this.logger.warn('Connecting to HTTPS endpoint with TLS verification disabled and no CA certificate', {
+                    component: 'kubernetes-api',
+                    security: 'tls-configuration-warning',
+                    apiServer,
+                    recommendation: 'Provide KUBERNETES_CA_CERT environment variable for secure connections'
+                });
+            }
+            else if (!skipTLSVerify && !caCert) {
+                this.logger.info('Connecting to HTTPS endpoint without custom CA certificate - using system trust store', {
+                    component: 'kubernetes-api',
+                    security: 'tls-configuration-info',
+                    apiServer
+                });
+            }
+            else if (!skipTLSVerify && caCert) {
+                this.logger.info('Secure TLS connection configured with custom CA certificate', {
+                    component: 'kubernetes-api',
+                    security: 'tls-configuration-secure',
+                    apiServer
+                });
+            }
+        }
+        else if (apiServer.startsWith('http://')) {
+            this.logger.warn('Connecting to HTTP endpoint - connection is not encrypted', {
+                component: 'kubernetes-api',
+                security: 'insecure-connection',
+                apiServer,
+                recommendation: 'Use HTTPS endpoint for secure connections'
+            });
+        }
+    }
+    /**
+     * Applies a Kubernetes manifest (YAML or JSON string) to the cluster.
+     * This method handles both creation and updates of resources.
+     * @param manifestString The Kubernetes YAML or JSON manifest as a string.
+     */
+    async apply(manifestString) {
+        // Parse the manifest string as a KubernetesObject
+        const manifest = k8s.loadYaml(manifestString);
+        // Ensure metadata and name exist for proper application
+        if (!manifest.metadata || !manifest.metadata.name) {
+            throw new Error('Kubernetes manifest must have metadata.name defined.');
+        }
+        const resourceLogger = this.logger.child({
+            kind: manifest.kind,
+            name: manifest.metadata.name,
+            namespace: manifest.metadata.namespace || 'default'
+        });
+        try {
+            // V1ObjectMeta's namespace property is string, not string | undefined.
+            // We must provide a string. Use a default if not present.
+            const manifestNamespace = manifest.metadata.namespace || 'default';
+            let existing;
+            try {
+                // Correctly access the body property from the response
+                // The read method of KubernetesObjectApi expects KubernetesObjectHeader
+                // Ensure that name and namespace are explicitly non-optional in the header
+                const { body } = await this.k8sApi.read({
+                    metadata: { name: manifest.metadata.name, namespace: manifestNamespace },
+                });
+                existing = body;
+            }
+            catch (e) {
+                // If it's a 404, the resource doesn't exist, which is expected for creation
+                if (e.statusCode !== 404) {
+                    resourceLogger.error('Error checking resource existence', e);
+                    throw e;
+                }
+            }
+            if (existing) {
+                // Resource exists, apply update using patch for safety
+                // Patch only updates the fields we specify, preserving other fields
+                await this.k8sApi.patch(manifest);
+                resourceLogger.debug('Resource patched');
+            }
+            else {
+                // Resource does not exist, create it
+                await this.k8sApi.create(manifest);
+                resourceLogger.debug('Resource created');
+            }
+        }
+        catch (error) {
+            resourceLogger.error('Error applying Kubernetes manifest', error);
+            throw new Error(`Failed to apply Kubernetes manifest: ${error.message}`);
+        }
+    }
+    /**
+     * Retrieves a Kubernetes resource.
+     * @param apiVersion The apiVersion of the resource (e.g., "apps/v1").
+     * @param kind The kind of the resource (e.g., "Deployment").
+     * @param name The name of the resource.
+     * @param namespace The namespace of the resource.
+     * @returns The retrieved resource object.
+     */
+    async get(_apiVersion, kind, name, namespace = 'default') {
+        const getLogger = this.logger.child({ kind, name, namespace });
+        try {
+            const { body } = await this.k8sApi.read({
+                metadata: { name, namespace },
+            });
+            return body;
+        }
+        catch (error) {
+            getLogger.error('Error getting resource', error);
+            throw new Error(`Failed to get Kubernetes resource: ${error.message}`);
+        }
+    }
+    /**
+     * Deletes a Kubernetes resource.
+     * @param apiVersion The apiVersion of the resource (e.g., "apps/v1").
+     * @param kind The kind of the resource (e.g., "Deployment").
+     * @param name The name of the resource.
+     * @param namespace The namespace of the resource.
+     */
+    async delete(apiVersion, kind, name, namespace = 'default') {
+        const deleteLogger = this.logger.child({ kind, name, namespace });
+        try {
+            // The delete method of KubernetesObjectApi takes the object to delete first,
+            // then an optional V1DeleteOptions object.
+            await this.k8sApi.delete({
+                apiVersion,
+                kind,
+                metadata: { name, namespace },
+            });
+            deleteLogger.debug('Resource deleted');
+        }
+        catch (error) {
+            // Don't throw if resource is already not found during deletion
+            if (error.statusCode === 404) {
+                deleteLogger.warn('Resource not found during deletion attempt, assuming already deleted');
+                return;
+            }
+            deleteLogger.error('Error deleting resource', error);
+            throw new Error(`Failed to delete Kubernetes resource: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/core/kubernetes/api.js.map

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

package/dist/core/kubernetes/client-provider.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Kubernetes Client Provider
+ *
+ * Single source of truth for all Kubernetes API interactions.
+ * Manages KubeConfig loading and KubernetesObjectApi client instantiation
+ * with consistent configuration across the entire application.
+ *
+ * This provider implements the singleton pattern and serves as the central
+ * authority for all Kubernetes API client creation, ensuring consistent
+ * configuration, security settings, and lifecycle management.
+ */
+import * as k8s from '@kubernetes/client-node';
+/**
+ * Configuration options for the Kubernetes client provider
+ */
+export interface KubernetesClientConfig {
+    /**
+     * SECURITY WARNING: Only set to true in non-production environments.
+     * This disables TLS certificate verification and makes connections vulnerable
+     * to man-in-the-middle attacks.
+     *
+     * @default false (secure by default)
+     */
+    skipTLSVerify?: boolean;
+    /**
+     * Custom cluster server URL (optional)
+     */
+    server?: string;
+    /**
+     * Custom context name (optional)
+     */
+    context?: string;
+    /**
+     * Complete cluster configuration (optional)
+     */
+    cluster?: {
+        name: string;
+        server: string;
+        skipTLSVerify?: boolean;
+        caData?: string;
+        caFile?: string;
+    };
+    /**
+     * Complete user configuration (optional)
+     */
+    user?: {
+        name: string;
+        token?: string;
+        certData?: string;
+        certFile?: string;
+        keyData?: string;
+        keyFile?: string;
+    };
+    /**
+     * Whether to load from default kubeconfig if no complete cluster/user config provided
+     * @default true
+     */
+    loadFromDefault?: boolean;
+    /**
+     * Custom kubeconfig file path (optional)
+     */
+    kubeconfigPath?: string;
+}
+/**
+ * Interface for components that need Kubernetes API access
+ */
+export interface KubernetesApiConsumer {
+    /**
+     * Set the Kubernetes API client instance
+     */
+    setKubernetesApi(api: k8s.KubernetesObjectApi): void;
+}
+/**
+ * Interface for components that need KubeConfig access
+ */
+export interface KubeConfigConsumer {
+    /**
+     * Set the KubeConfig instance
+     */
+    setKubeConfig(config: k8s.KubeConfig): void;
+}
+/**
+ * Kubernetes Client Provider - Single source of truth for Kubernetes API access
+ *
+ * This class implements the singleton pattern and serves as the central authority
+ * for all Kubernetes API client creation. It ensures consistent configuration,
+ * security settings, and lifecycle management across the entire application.
+ */
+export declare class KubernetesClientProvider {
+    private static instance;
+    private kubeConfig;
+    private k8sApi;
+    private config;
+    private logger;
+    private initialized;
+    private constructor();
+    /**
+     * Get the singleton instance of KubernetesClientProvider
+     */
+    static getInstance(): KubernetesClientProvider;
+    /**
+     * Create a new instance for dependency injection (non-singleton)
+     * Useful for testing or when you need multiple configurations
+     */
+    static createInstance(config?: KubernetesClientConfig): KubernetesClientProvider;
+    /**
+     * Initialize the provider with configuration
+     * This method is idempotent - calling it multiple times with the same config is safe
+     */
+    initialize(config?: KubernetesClientConfig): void;
+    /**
+     * Initialize the provider with a pre-configured KubeConfig
+     * Useful when you already have a KubeConfig instance
+     */
+    initializeWithKubeConfig(kubeConfig: k8s.KubeConfig): void;
+    /**
+     * Get the configured KubeConfig instance
+     * @throws Error if provider is not initialized
+     */
+    getKubeConfig(): k8s.KubeConfig;
+    /**
+     * Get the configured KubernetesObjectApi instance
+     * @throws Error if provider is not initialized
+     */
+    getKubernetesApi(): k8s.KubernetesObjectApi;
+    /**
+     * Inject the Kubernetes API client into a consumer component
+     */
+    injectKubernetesApi(consumer: KubernetesApiConsumer): void;
+    /**
+     * Inject the KubeConfig into a consumer component
+     */
+    injectKubeConfig(consumer: KubeConfigConsumer): void;
+    /**
+     * Get current configuration (read-only)
+     */
+    getConfiguration(): Readonly<KubernetesClientConfig> | null;
+    /**
+     * Create a new KubeConfig with the provided configuration
+     */
+    private createKubeConfig;
+    /**
+     * Apply configuration modifications to an existing KubeConfig
+     */
+    private applyConfigModifications;
+    /**
+     * Validate and log security configuration
+     */
+    private validateAndLogSecurityConfiguration;
+    /**
+     * Check if two configurations are the same
+     */
+    private isSameConfig;
+    /**
+     * Ensure the provider is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Reset the provider instance (useful for testing)
+     */
+    private reset;
+    /**
+     * Reset the singleton instance (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Check if the provider is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get connection status information
+     */
+    getConnectionInfo(): {
+        initialized: boolean;
+        currentContext?: string;
+        server?: string;
+        skipTLSVerify?: boolean;
+        clusterName?: string;
+        userName?: string;
+    };
+}
+/**
+ * Convenience function to get the singleton instance
+ */
+export declare function getKubernetesClientProvider(): KubernetesClientProvider;
+/**
+ * Factory function to create and initialize a provider instance
+ */
+export declare function createKubernetesClientProvider(config?: KubernetesClientConfig): KubernetesClientProvider;
+/**
+ * Factory function to create a provider with a pre-configured KubeConfig
+ */
+export declare function createKubernetesClientProviderWithKubeConfig(kubeConfig: k8s.KubeConfig): KubernetesClientProvider;
+/**
+ * Convenience function to get a configured Kubernetes API client
+ * Uses the singleton provider and initializes it with default config if needed
+ */
+export declare function getKubernetesApi(config?: KubernetesClientConfig): k8s.KubernetesObjectApi;
+/**
+ * Convenience function to get a configured KubeConfig
+ * Uses the singleton provider and initializes it with default config if needed
+ */
+export declare function getKubeConfig(config?: KubernetesClientConfig): k8s.KubeConfig;
+//# sourceMappingURL=client-provider.d.ts.map

package/dist/core/kubernetes/client-provider.d.ts.map

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