typekro 0.2.2 → 0.3.0

package/dist/core/expressions/conditional-integration.js

@@ -0,0 +1,293 @@
+/**
+ * Conditional Expression Integration for Factory Functions
+ *
+ * This module provides integration points for conditional expressions like
+ * includeWhen and readyWhen in factory functions, enabling automatic
+ * KubernetesRef detection and CEL conversion.
+ */
+import { getComponentLogger } from '../logging/index.js';
+import { ConditionalExpressionProcessor } from './conditional-expression-processor.js';
+import { getCurrentCompositionContext } from '../../factories/shared.js';
+const logger = getComponentLogger('conditional-integration');
+/**
+ * Conditional Expression Integrator
+ *
+ * Integrates conditional expression processing with factory functions
+ * and Enhanced resources.
+ */
+export class ConditionalExpressionIntegrator {
+    processor;
+    constructor() {
+        this.processor = new ConditionalExpressionProcessor();
+    }
+    /**
+     * Add conditional expression support to an Enhanced resource
+     *
+     * @param resource - Enhanced resource to augment
+     * @param config - Integration configuration
+     * @returns Enhanced resource with conditional expression support
+     */
+    addConditionalSupport(resource, config = {}) {
+        const enhanced = resource;
+        // Add conditional expression properties
+        Object.defineProperty(enhanced, 'includeWhen', {
+            value: undefined,
+            writable: true,
+            enumerable: false, // Don't serialize by default
+            configurable: true
+        });
+        Object.defineProperty(enhanced, 'readyWhen', {
+            value: undefined,
+            writable: true,
+            enumerable: false, // Don't serialize by default
+            configurable: true
+        });
+        Object.defineProperty(enhanced, 'conditionals', {
+            value: {},
+            writable: true,
+            enumerable: false, // Don't serialize by default
+            configurable: true
+        });
+        // Add fluent builder methods
+        Object.defineProperty(enhanced, 'withIncludeWhen', {
+            value: (condition) => {
+                const context = enhanced.createFactoryContext();
+                if (config.autoProcess) {
+                    const result = this.processor.processIncludeWhenExpression(condition, context, config);
+                    enhanced.includeWhen = result.expression;
+                    if (result.validationErrors.length > 0) {
+                        logger.warn('includeWhen validation warnings', {
+                            resourceId: enhanced.__resourceId,
+                            errors: result.validationErrors
+                        });
+                    }
+                }
+                else {
+                    enhanced.includeWhen = condition;
+                }
+                return enhanced;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(enhanced, 'withReadyWhen', {
+            value: (condition) => {
+                const context = enhanced.createFactoryContext();
+                if (config.autoProcess) {
+                    const result = this.processor.processReadyWhenExpression(condition, context, config);
+                    enhanced.readyWhen = result.expression;
+                    if (result.validationErrors.length > 0) {
+                        logger.warn('readyWhen validation warnings', {
+                            resourceId: enhanced.__resourceId,
+                            errors: result.validationErrors
+                        });
+                    }
+                }
+                else {
+                    enhanced.readyWhen = condition;
+                }
+                return enhanced;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        Object.defineProperty(enhanced, 'withConditional', {
+            value: (name, condition) => {
+                const context = enhanced.createFactoryContext();
+                if (config.autoProcess) {
+                    const result = this.processor.processCustomConditionalExpression(condition, context, config);
+                    if (!enhanced.conditionals) {
+                        enhanced.conditionals = {};
+                    }
+                    enhanced.conditionals[name] = result.expression;
+                    if (result.validationErrors.length > 0) {
+                        logger.warn('Custom conditional validation warnings', {
+                            resourceId: enhanced.__resourceId,
+                            conditionalName: name,
+                            errors: result.validationErrors
+                        });
+                    }
+                }
+                else {
+                    if (!enhanced.conditionals) {
+                        enhanced.conditionals = {};
+                    }
+                    enhanced.conditionals[name] = condition;
+                }
+                return enhanced;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        // Add helper method to create factory context
+        Object.defineProperty(enhanced, 'createFactoryContext', {
+            value: () => {
+                const compositionContext = getCurrentCompositionContext();
+                return {
+                    factoryType: 'kro', // Default to Kro, can be overridden
+                    factoryName: enhanced.kind || 'unknown',
+                    analysisEnabled: true,
+                    availableResources: compositionContext?.resources || {},
+                    schemaProxy: undefined, // Will be set by toResourceGraph if available
+                    resourceId: enhanced.__resourceId || 'unknown'
+                };
+            },
+            enumerable: false,
+            configurable: true
+        });
+        return enhanced;
+    }
+    /**
+     * Process all conditional expressions on an Enhanced resource
+     *
+     * @param resource - Enhanced resource with conditional expressions
+     * @param context - Factory context
+     * @param config - Integration configuration
+     * @returns Processing results
+     */
+    processResourceConditionals(resource, context, config = {}) {
+        const startTime = performance.now();
+        const results = {};
+        const warnings = [];
+        let hasConditionals = false;
+        logger.debug('Processing resource conditional expressions', {
+            resourceId: context.resourceId,
+            factoryType: context.factoryType
+        });
+        // Process includeWhen expression
+        if (resource.includeWhen !== undefined) {
+            hasConditionals = true;
+            results.includeWhen = this.processor.processIncludeWhenExpression(resource.includeWhen, context, config);
+            if (results.includeWhen.validationErrors.length > 0) {
+                warnings.push(...results.includeWhen.validationErrors.map(err => `includeWhen: ${err}`));
+            }
+            // Update the resource with processed expression
+            resource.includeWhen = results.includeWhen.expression;
+        }
+        // Process readyWhen expression
+        if (resource.readyWhen !== undefined) {
+            hasConditionals = true;
+            results.readyWhen = this.processor.processReadyWhenExpression(resource.readyWhen, context, config);
+            if (results.readyWhen.validationErrors.length > 0) {
+                warnings.push(...results.readyWhen.validationErrors.map(err => `readyWhen: ${err}`));
+            }
+            // Update the resource with processed expression
+            resource.readyWhen = results.readyWhen.expression;
+        }
+        // Process custom conditional expressions
+        if (resource.conditionals && Object.keys(resource.conditionals).length > 0) {
+            hasConditionals = true;
+            results.conditionals = {};
+            for (const [name, condition] of Object.entries(resource.conditionals)) {
+                results.conditionals[name] = this.processor.processCustomConditionalExpression(condition, context, config);
+                if (results.conditionals[name].validationErrors.length > 0) {
+                    warnings.push(...results.conditionals[name].validationErrors.map(err => `${name}: ${err}`));
+                }
+                // Update the resource with processed expression
+                resource.conditionals[name] = results.conditionals[name].expression;
+            }
+        }
+        const totalProcessingTimeMs = performance.now() - startTime;
+        logger.debug('Resource conditional expressions processing completed', {
+            resourceId: context.resourceId,
+            hasConditionals,
+            totalProcessingTimeMs,
+            warningsCount: warnings.length
+        });
+        return {
+            hasConditionals,
+            results,
+            totalProcessingTimeMs,
+            warnings
+        };
+    }
+    /**
+     * Extract conditional expressions from a resource for serialization
+     *
+     * @param resource - Enhanced resource with conditional expressions
+     * @returns Conditional expressions ready for serialization
+     */
+    extractConditionalsForSerialization(resource) {
+        const conditionals = {};
+        if (resource.includeWhen !== undefined) {
+            conditionals.includeWhen = resource.includeWhen;
+        }
+        if (resource.readyWhen !== undefined) {
+            conditionals.readyWhen = resource.readyWhen;
+        }
+        if (resource.conditionals && Object.keys(resource.conditionals).length > 0) {
+            Object.assign(conditionals, resource.conditionals);
+        }
+        return conditionals;
+    }
+    /**
+     * Validate that conditional expressions are appropriate for the factory type
+     *
+     * @param resource - Enhanced resource with conditional expressions
+     * @param factoryType - Target factory type
+     * @returns Validation results
+     */
+    validateConditionalsForFactory(resource, factoryType) {
+        const errors = [];
+        const warnings = [];
+        // Direct factory limitations
+        if (factoryType === 'direct') {
+            if (resource.includeWhen !== undefined) {
+                warnings.push('includeWhen expressions have limited support in direct factory mode');
+            }
+            if (resource.readyWhen !== undefined) {
+                warnings.push('readyWhen expressions have limited support in direct factory mode');
+            }
+        }
+        // Kro factory requirements
+        if (factoryType === 'kro') {
+            // All conditional expressions should be convertible to CEL
+            if (resource.includeWhen !== undefined && typeof resource.includeWhen === 'function') {
+                errors.push('includeWhen expressions cannot be functions in Kro factory mode');
+            }
+            if (resource.readyWhen !== undefined && typeof resource.readyWhen === 'function') {
+                errors.push('readyWhen expressions cannot be functions in Kro factory mode');
+            }
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+}
+/**
+ * Global conditional expression integrator instance
+ */
+export const conditionalExpressionIntegrator = new ConditionalExpressionIntegrator();
+/**
+ * Utility function to add conditional support to an Enhanced resource
+ *
+ * @param resource - Enhanced resource to augment
+ * @param config - Integration configuration
+ * @returns Enhanced resource with conditional expression support
+ */
+export function withConditionalSupport(resource, config) {
+    return conditionalExpressionIntegrator.addConditionalSupport(resource, config);
+}
+/**
+ * Utility function to process conditional expressions on a resource
+ *
+ * @param resource - Enhanced resource with conditional expressions
+ * @param context - Factory context
+ * @param config - Integration configuration
+ * @returns Processing results
+ */
+export function processResourceConditionals(resource, context, config) {
+    return conditionalExpressionIntegrator.processResourceConditionals(resource, context, config);
+}
+/**
+ * Utility function to extract conditionals for serialization
+ *
+ * @param resource - Enhanced resource with conditional expressions
+ * @returns Conditional expressions ready for serialization
+ */
+export function extractConditionalsForSerialization(resource) {
+    return conditionalExpressionIntegrator.extractConditionalsForSerialization(resource);
+}
+//# sourceMappingURL=conditional-integration.js.map

package/dist/core/expressions/conditional-integration.js.map

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

package/dist/core/expressions/conditional-validation.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Conditional Expression Validation
+ *
+ * This module provides comprehensive validation for conditional expressions
+ * containing KubernetesRef objects, ensuring they are well-formed and
+ * appropriate for their intended contexts.
+ */
+import { type MagicProxyDetectionResult } from './magic-proxy-detector.js';
+import type { FactoryExpressionContext } from './types.js';
+import { type ContextDetectionResult } from './context-detector.js';
+/**
+ * Validation severity levels
+ */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/**
+ * Validation rule configuration
+ */
+export interface ValidationRule {
+    /** Unique identifier for the rule */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what the rule validates */
+    description: string;
+    /** Severity level */
+    severity: ValidationSeverity;
+    /** Contexts where this rule applies */
+    applicableContexts: string[];
+    /** Whether this rule is enabled by default */
+    enabled: boolean;
+    /** Validation function */
+    validate: (expression: any, context: FactoryExpressionContext, detection: MagicProxyDetectionResult) => ValidationResult;
+}
+/**
+ * Result of a single validation rule
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation message */
+    message?: string;
+    /** Suggestions for fixing issues */
+    suggestions?: string[];
+    /** Additional details */
+    details?: Record<string, any>;
+    /** Location information if available */
+    location?: {
+        line?: number;
+        column?: number;
+        length?: number;
+    };
+}
+/**
+ * Comprehensive validation result
+ */
+export interface ConditionalValidationResult {
+    /** Overall validation status */
+    isValid: boolean;
+    /** Results from individual rules */
+    ruleResults: Map<string, ValidationResult>;
+    /** All validation messages grouped by severity */
+    messages: {
+        errors: string[];
+        warnings: string[];
+        info: string[];
+    };
+    /** Context detection result */
+    contextResult: ContextDetectionResult;
+    /** KubernetesRef detection result */
+    detectionResult: MagicProxyDetectionResult;
+    /** Performance metrics */
+    metrics: {
+        validationTimeMs: number;
+        rulesEvaluated: number;
+        referencesValidated: number;
+    };
+    /** Summary statistics */
+    summary: {
+        totalRules: number;
+        passedRules: number;
+        failedRules: number;
+        errorCount: number;
+        warningCount: number;
+        infoCount: number;
+    };
+}
+/**
+ * Validation configuration
+ */
+export interface ValidationConfig {
+    /** Whether to enable strict validation (fail on warnings) */
+    strictMode?: boolean;
+    /** Maximum validation time in milliseconds */
+    timeoutMs?: number;
+    /** Whether to include detailed location information */
+    includeLocationInfo?: boolean;
+    /** Custom validation rules to add */
+    customRules?: ValidationRule[];
+    /** Rule IDs to disable */
+    disabledRules?: string[];
+    /** Whether to validate KubernetesRef objects deeply */
+    deepReferenceValidation?: boolean;
+}
+/**
+ * Conditional Expression Validator
+ *
+ * Provides comprehensive validation for conditional expressions containing
+ * KubernetesRef objects, ensuring they are well-formed and contextually appropriate.
+ */
+export declare class ConditionalExpressionValidator {
+    private rules;
+    private magicProxyDetector;
+    private contextDetector;
+    constructor();
+    /**
+     * Validate a conditional expression
+     *
+     * @param expression - Expression to validate
+     * @param context - Factory context
+     * @param config - Validation configuration
+     * @returns Comprehensive validation result
+     */
+    validateExpression(expression: any, context: FactoryExpressionContext, config?: ValidationConfig): ConditionalValidationResult;
+    /**
+     * Register a custom validation rule
+     *
+     * @param rule - Validation rule to register
+     */
+    registerRule(rule: ValidationRule): void;
+    /**
+     * Unregister a validation rule
+     *
+     * @param ruleId - ID of the rule to unregister
+     * @returns Whether the rule was successfully unregistered
+     */
+    unregisterRule(ruleId: string): boolean;
+    /**
+     * Get all registered validation rules
+     *
+     * @returns Array of validation rules
+     */
+    getRules(): ValidationRule[];
+    /**
+     * Get applicable rules for a specific context
+     */
+    private getApplicableRules;
+    /**
+     * Register built-in validation rules
+     */
+    private registerBuiltInRules;
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    private levenshteinDistance;
+}
+/**
+ * Global conditional expression validator instance
+ */
+export declare const conditionalExpressionValidator: ConditionalExpressionValidator;
+/**
+ * Utility function to validate a conditional expression
+ *
+ * @param expression - Expression to validate
+ * @param context - Factory context
+ * @param config - Validation configuration
+ * @returns Validation result
+ */
+export declare function validateConditionalExpression(expression: any, context: FactoryExpressionContext, config?: ValidationConfig): ConditionalValidationResult;
+/**
+ * Utility function to register a custom validation rule
+ *
+ * @param rule - Validation rule to register
+ */
+export declare function registerValidationRule(rule: ValidationRule): void;
+/**
+ * Utility function to get all validation rules
+ *
+ * @returns Array of validation rules
+ */
+export declare function getValidationRules(): ValidationRule[];
+//# sourceMappingURL=conditional-validation.d.ts.map

package/dist/core/expressions/conditional-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-validation.d.ts","sourceRoot":"","sources":["../../../src/core/expressions/conditional-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAI/B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uCAAuC;IACvC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,CACR,UAAU,EAAE,GAAG,EACf,OAAO,EAAE,wBAAwB,EACjC,SAAS,EAAE,yBAAyB,KACjC,gBAAgB,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,kDAAkD;IAClD,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,+BAA+B;IAC/B,aAAa,EAAE,sBAAsB,CAAC;IACtC,qCAAqC;IACrC,eAAe,EAAE,yBAAyB,CAAC;IAC3C,0BAA0B;IAC1B,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,yBAAyB;IACzB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qCAAqC;IACrC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,eAAe,CAA4B;;IAUnD;;;;;;;OAOG;IACH,kBAAkB,CAChB,UAAU,EAAE,GAAG,EACf,OAAO,EAAE,wBAAwB,EACjC,MAAM,GAAE,gBAAqB,GAC5B,2BAA2B;IAkH9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAUxC;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAWvC;;;;OAIG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkP5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAmB5B;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,gCAAuC,CAAC;AAEnF;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,GAAG,EACf,OAAO,EAAE,wBAAwB,EACjC,MAAM,CAAC,EAAE,gBAAgB,GACxB,2BAA2B,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD"}