typekro 0.2.2 → 0.3.1

package/dist/core/expressions/custom-context-manager.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Custom Context Manager for Conditional Expressions
+ *
+ * This module provides functionality to define and manage custom CEL expression
+ * contexts that can contain KubernetesRef objects, enabling developers to create
+ * their own conditional expression types beyond includeWhen and readyWhen.
+ */
+import { type ConditionalExpressionConfig, type ConditionalExpressionResult } from './conditional-expression-processor.js';
+import type { FactoryExpressionContext } from './types.js';
+/**
+ * Configuration for a custom expression context
+ */
+export interface CustomContextConfig {
+    /** Name of the custom context */
+    name: string;
+    /** Description of what this context is used for */
+    description?: string;
+    /** Expected return type for expressions in this context */
+    expectedReturnType?: 'boolean' | 'string' | 'number' | 'object' | 'any';
+    /** Whether expressions in this context support async operations */
+    supportsAsync?: boolean;
+    /** Validation rules for expressions in this context */
+    validationRules?: CustomContextValidationRule[];
+    /** CEL generation strategy for this context */
+    celStrategy?: 'conditional-check' | 'resource-reference' | 'template-interpolation' | 'custom';
+    /** Custom CEL template for this context */
+    celTemplate?: string;
+    /** Whether to enable debug information for this context */
+    enableDebugInfo?: boolean;
+}
+/**
+ * Validation rule for custom context expressions
+ */
+export interface CustomContextValidationRule {
+    /** Rule identifier */
+    id: string;
+    /** Rule name */
+    name: string;
+    /** Rule description */
+    description: string;
+    /** Validation function */
+    validate: (expression: any, context: FactoryExpressionContext) => CustomContextValidationResult;
+    /** Severity level */
+    severity: 'error' | 'warning' | 'info';
+}
+/**
+ * Result of custom context validation
+ */
+export interface CustomContextValidationResult {
+    /** Whether validation passed */
+    isValid: boolean;
+    /** Validation message */
+    message?: string;
+    /** Suggestions for fixing validation issues */
+    suggestions?: string[];
+    /** Additional validation details */
+    details?: Record<string, any>;
+}
+/**
+ * Custom expression context definition
+ */
+export interface CustomExpressionContext {
+    /** Context configuration */
+    config: CustomContextConfig;
+    /** Processor function for expressions in this context */
+    processor: (expression: any, context: FactoryExpressionContext, config?: ConditionalExpressionConfig) => ConditionalExpressionResult;
+    /** Validator function for expressions in this context */
+    validator: (expression: any, context: FactoryExpressionContext) => CustomContextValidationResult[];
+}
+/**
+ * Result of custom context processing
+ */
+export interface CustomContextProcessingResult {
+    /** Name of the context that was used */
+    contextName: string;
+    /** Processing result */
+    result: ConditionalExpressionResult;
+    /** Validation results */
+    validationResults: CustomContextValidationResult[];
+    /** Performance metrics */
+    metrics: {
+        processingTimeMs: number;
+        validationTimeMs: number;
+    };
+}
+/**
+ * Custom Context Manager
+ *
+ * Manages custom CEL expression contexts and provides processing capabilities
+ * for expressions containing KubernetesRef objects in custom contexts.
+ */
+export declare class CustomContextManager {
+    private contexts;
+    private processor;
+    private contextDetector;
+    constructor();
+    /**
+     * Register a custom expression context
+     *
+     * @param contextConfig - Configuration for the custom context
+     * @returns The registered custom context
+     */
+    registerCustomContext(contextConfig: CustomContextConfig): CustomExpressionContext;
+    /**
+     * Unregister a custom expression context
+     *
+     * @param contextName - Name of the context to unregister
+     * @returns Whether the context was successfully unregistered
+     */
+    unregisterCustomContext(contextName: string): boolean;
+    /**
+     * Get a registered custom context
+     *
+     * @param contextName - Name of the context to retrieve
+     * @returns The custom context or undefined if not found
+     */
+    getCustomContext(contextName: string): CustomExpressionContext | undefined;
+    /**
+     * List all registered custom contexts
+     *
+     * @returns Array of context names
+     */
+    listCustomContexts(): string[];
+    /**
+     * Process an expression in a custom context
+     *
+     * @param contextName - Name of the custom context
+     * @param expression - Expression to process
+     * @param factoryContext - Factory context
+     * @param config - Processing configuration
+     * @returns Processing result
+     */
+    processInCustomContext(contextName: string, expression: any, factoryContext: FactoryExpressionContext, config?: ConditionalExpressionConfig): CustomContextProcessingResult;
+    /**
+     * Auto-detect and process expression in the most appropriate custom context
+     *
+     * @param expression - Expression to process
+     * @param factoryContext - Factory context
+     * @param config - Processing configuration
+     * @returns Processing result or null if no suitable context found
+     */
+    autoProcessInCustomContext(expression: any, factoryContext: FactoryExpressionContext, config?: ConditionalExpressionConfig): CustomContextProcessingResult | null;
+    /**
+     * Create a custom processor for a context configuration
+     */
+    private createCustomProcessor;
+    /**
+     * Create a custom validator for a context configuration
+     */
+    private createCustomValidator;
+    /**
+     * Validate expression against expected return type
+     */
+    private validateExpectedReturnType;
+    /**
+     * Check if a detection result matches a custom context
+     */
+    private isContextMatch;
+    /**
+     * Register built-in contexts
+     */
+    private registerBuiltInContexts;
+}
+/**
+ * Global custom context manager instance
+ */
+export declare const customContextManager: CustomContextManager;
+/**
+ * Utility function to register a custom context
+ *
+ * @param contextConfig - Configuration for the custom context
+ * @returns The registered custom context
+ */
+export declare function registerCustomContext(contextConfig: CustomContextConfig): CustomExpressionContext;
+/**
+ * Utility function to process expression in custom context
+ *
+ * @param contextName - Name of the custom context
+ * @param expression - Expression to process
+ * @param factoryContext - Factory context
+ * @param config - Processing configuration
+ * @returns Processing result
+ */
+export declare function processInCustomContext(contextName: string, expression: any, factoryContext: FactoryExpressionContext, config?: ConditionalExpressionConfig): CustomContextProcessingResult;
+/**
+ * Utility function to auto-process expression in custom context
+ *
+ * @param expression - Expression to process
+ * @param factoryContext - Factory context
+ * @param config - Processing configuration
+ * @returns Processing result or null if no suitable context found
+ */
+export declare function autoProcessInCustomContext(expression: any, factoryContext: FactoryExpressionContext, config?: ConditionalExpressionConfig): CustomContextProcessingResult | null;
+//# sourceMappingURL=custom-context-manager.d.ts.map

package/dist/core/expressions/custom-context-manager.d.ts.map

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

package/dist/core/expressions/custom-context-manager.js

@@ -0,0 +1,390 @@
+/**
+ * Custom Context Manager for Conditional Expressions
+ *
+ * This module provides functionality to define and manage custom CEL expression
+ * contexts that can contain KubernetesRef objects, enabling developers to create
+ * their own conditional expression types beyond includeWhen and readyWhen.
+ */
+import { getComponentLogger } from '../logging/index.js';
+import { ConditionalExpressionProcessor } from './conditional-expression-processor.js';
+import { ExpressionContextDetector, } from './context-detector.js';
+const logger = getComponentLogger('custom-context-manager');
+/**
+ * Custom Context Manager
+ *
+ * Manages custom CEL expression contexts and provides processing capabilities
+ * for expressions containing KubernetesRef objects in custom contexts.
+ */
+export class CustomContextManager {
+    contexts = new Map();
+    processor;
+    contextDetector;
+    constructor() {
+        this.processor = new ConditionalExpressionProcessor();
+        this.contextDetector = new ExpressionContextDetector();
+        // Register built-in contexts
+        this.registerBuiltInContexts();
+    }
+    /**
+     * Register a custom expression context
+     *
+     * @param contextConfig - Configuration for the custom context
+     * @returns The registered custom context
+     */
+    registerCustomContext(contextConfig) {
+        logger.debug('Registering custom expression context', {
+            contextName: contextConfig.name,
+            expectedReturnType: contextConfig.expectedReturnType
+        });
+        const customContext = {
+            config: contextConfig,
+            processor: this.createCustomProcessor(contextConfig),
+            validator: this.createCustomValidator(contextConfig)
+        };
+        this.contexts.set(contextConfig.name, customContext);
+        logger.info('Custom expression context registered', {
+            contextName: contextConfig.name,
+            totalContexts: this.contexts.size
+        });
+        return customContext;
+    }
+    /**
+     * Unregister a custom expression context
+     *
+     * @param contextName - Name of the context to unregister
+     * @returns Whether the context was successfully unregistered
+     */
+    unregisterCustomContext(contextName) {
+        const existed = this.contexts.has(contextName);
+        this.contexts.delete(contextName);
+        if (existed) {
+            logger.info('Custom expression context unregistered', {
+                contextName,
+                remainingContexts: this.contexts.size
+            });
+        }
+        return existed;
+    }
+    /**
+     * Get a registered custom context
+     *
+     * @param contextName - Name of the context to retrieve
+     * @returns The custom context or undefined if not found
+     */
+    getCustomContext(contextName) {
+        return this.contexts.get(contextName);
+    }
+    /**
+     * List all registered custom contexts
+     *
+     * @returns Array of context names
+     */
+    listCustomContexts() {
+        return Array.from(this.contexts.keys());
+    }
+    /**
+     * Process an expression in a custom context
+     *
+     * @param contextName - Name of the custom context
+     * @param expression - Expression to process
+     * @param factoryContext - Factory context
+     * @param config - Processing configuration
+     * @returns Processing result
+     */
+    processInCustomContext(contextName, expression, factoryContext, config = {}) {
+        const startTime = performance.now();
+        logger.debug('Processing expression in custom context', {
+            contextName,
+            factoryType: factoryContext.factoryType,
+            expressionType: typeof expression
+        });
+        const customContext = this.contexts.get(contextName);
+        if (!customContext) {
+            throw new Error(`Custom context '${contextName}' not found`);
+        }
+        // Validate the expression
+        const validationStartTime = performance.now();
+        const validationResults = customContext.validator(expression, factoryContext);
+        const validationTimeMs = performance.now() - validationStartTime;
+        // Check for validation errors
+        const hasErrors = validationResults.some(result => !result.isValid &&
+            customContext.config.validationRules?.find(rule => rule.severity === 'error'));
+        if (hasErrors && config.strictValidation) {
+            const errorMessages = validationResults
+                .filter(result => !result.isValid)
+                .map(result => result.message)
+                .join(', ');
+            throw new Error(`Validation failed for custom context '${contextName}': ${errorMessages}`);
+        }
+        // Process the expression
+        const result = customContext.processor(expression, factoryContext, config);
+        const processingTimeMs = performance.now() - startTime;
+        logger.debug('Custom context processing completed', {
+            contextName,
+            wasProcessed: result.wasProcessed,
+            validationResults: validationResults.length,
+            processingTimeMs
+        });
+        return {
+            contextName,
+            result,
+            validationResults,
+            metrics: {
+                processingTimeMs,
+                validationTimeMs
+            }
+        };
+    }
+    /**
+     * Auto-detect and process expression in the most appropriate custom context
+     *
+     * @param expression - Expression to process
+     * @param factoryContext - Factory context
+     * @param config - Processing configuration
+     * @returns Processing result or null if no suitable context found
+     */
+    autoProcessInCustomContext(expression, factoryContext, config = {}) {
+        logger.debug('Auto-detecting custom context for expression', {
+            factoryType: factoryContext.factoryType,
+            expressionType: typeof expression
+        });
+        // Try to detect context using the context detector
+        const detectionResult = this.contextDetector.detectContext(expression, {
+            factoryType: factoryContext.factoryType,
+            ...(factoryContext.availableResources && { availableResources: factoryContext.availableResources }),
+            ...(factoryContext.schemaProxy && { schemaProxy: factoryContext.schemaProxy })
+        });
+        // Look for a custom context that matches the detected context
+        for (const [contextName, customContext] of this.contexts.entries()) {
+            if (this.isContextMatch(detectionResult, customContext)) {
+                try {
+                    return this.processInCustomContext(contextName, expression, factoryContext, config);
+                }
+                catch (error) {
+                    logger.warn('Failed to process in detected custom context', {
+                        contextName,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+        }
+        logger.debug('No suitable custom context found for auto-processing');
+        return null;
+    }
+    /**
+     * Create a custom processor for a context configuration
+     */
+    createCustomProcessor(contextConfig) {
+        return (expression, context, config = {}) => {
+            // Use the conditional expression processor with custom context
+            return this.processor.processCustomConditionalExpression(expression, context, {
+                ...config,
+                includeDebugInfo: config.includeDebugInfo ?? contextConfig.enableDebugInfo ?? false
+            });
+        };
+    }
+    /**
+     * Create a custom validator for a context configuration
+     */
+    createCustomValidator(contextConfig) {
+        return (expression, context) => {
+            const results = [];
+            // Apply custom validation rules
+            if (contextConfig.validationRules) {
+                for (const rule of contextConfig.validationRules) {
+                    try {
+                        const result = rule.validate(expression, context);
+                        results.push(result);
+                    }
+                    catch (error) {
+                        results.push({
+                            isValid: false,
+                            message: `Validation rule '${rule.name}' failed: ${error}`,
+                            details: { ruleId: rule.id, error: String(error) }
+                        });
+                    }
+                }
+            }
+            // Apply default validation based on expected return type
+            if (contextConfig.expectedReturnType) {
+                const typeValidation = this.validateExpectedReturnType(expression, contextConfig.expectedReturnType);
+                results.push(typeValidation);
+            }
+            return results;
+        };
+    }
+    /**
+     * Validate expression against expected return type
+     */
+    validateExpectedReturnType(expression, expectedType) {
+        // This is a simplified validation - in a real implementation,
+        // we would need more sophisticated type analysis
+        switch (expectedType) {
+            case 'boolean':
+                if (typeof expression === 'boolean') {
+                    return { isValid: true };
+                }
+                if (typeof expression === 'string' && /[><=!]=?|&&|\|\||true|false/.test(expression)) {
+                    return { isValid: true };
+                }
+                return {
+                    isValid: false,
+                    message: `Expression should evaluate to boolean, but appears to be ${typeof expression}`,
+                    suggestions: ['Use comparison operators (>, <, ==, !=)', 'Use logical operators (&&, ||)', 'Use boolean literals (true, false)']
+                };
+            case 'string':
+                if (typeof expression === 'string') {
+                    return { isValid: true };
+                }
+                return {
+                    isValid: false,
+                    message: `Expression should evaluate to string, but appears to be ${typeof expression}`,
+                    suggestions: ['Use string literals', 'Use template literals', 'Use string concatenation']
+                };
+            case 'number':
+                if (typeof expression === 'number') {
+                    return { isValid: true };
+                }
+                if (typeof expression === 'string' && /^\d+(\.\d+)?$/.test(expression)) {
+                    return { isValid: true };
+                }
+                return {
+                    isValid: false,
+                    message: `Expression should evaluate to number, but appears to be ${typeof expression}`,
+                    suggestions: ['Use numeric literals', 'Use arithmetic operations']
+                };
+            default:
+                return { isValid: true }; // Accept any type for 'object' or 'any'
+        }
+    }
+    /**
+     * Check if a detection result matches a custom context
+     */
+    isContextMatch(detectionResult, _customContext) {
+        // Simple matching based on context name
+        // In a more sophisticated implementation, this could use more complex matching logic
+        return detectionResult.context === 'conditional' ||
+            detectionResult.context === 'unknown';
+    }
+    /**
+     * Register built-in contexts
+     */
+    registerBuiltInContexts() {
+        // Register includeWhen context
+        this.registerCustomContext({
+            name: 'includeWhen',
+            description: 'Conditional resource inclusion',
+            expectedReturnType: 'boolean',
+            supportsAsync: false,
+            celStrategy: 'conditional-check',
+            validationRules: [
+                {
+                    id: 'boolean-result',
+                    name: 'Boolean Result',
+                    description: 'includeWhen expressions should evaluate to boolean',
+                    severity: 'warning',
+                    validate: (expression) => {
+                        if (typeof expression === 'boolean') {
+                            return { isValid: true };
+                        }
+                        if (typeof expression === 'string' && /[><=!]=?|&&|\|\||true|false/.test(expression)) {
+                            return { isValid: true };
+                        }
+                        return {
+                            isValid: false,
+                            message: 'includeWhen expressions should evaluate to boolean values',
+                            suggestions: ['Add comparison operators', 'Use boolean literals']
+                        };
+                    }
+                }
+            ]
+        });
+        // Register readyWhen context
+        this.registerCustomContext({
+            name: 'readyWhen',
+            description: 'Resource readiness conditions',
+            expectedReturnType: 'boolean',
+            supportsAsync: false,
+            celStrategy: 'conditional-check',
+            validationRules: [
+                {
+                    id: 'boolean-result',
+                    name: 'Boolean Result',
+                    description: 'readyWhen expressions should evaluate to boolean',
+                    severity: 'warning',
+                    validate: (expression) => {
+                        if (typeof expression === 'boolean') {
+                            return { isValid: true };
+                        }
+                        if (typeof expression === 'string' && /[><=!]=?|&&|\|\||ready|available/.test(expression.toLowerCase())) {
+                            return { isValid: true };
+                        }
+                        return {
+                            isValid: false,
+                            message: 'readyWhen expressions should evaluate to boolean values',
+                            suggestions: ['Add comparison operators', 'Use readiness-related terms']
+                        };
+                    }
+                },
+                {
+                    id: 'status-reference',
+                    name: 'Status Reference',
+                    description: 'readyWhen expressions should typically reference status fields',
+                    severity: 'info',
+                    validate: (expression, _context) => {
+                        // This is a simplified check - in reality, we'd analyze the expression for status references
+                        const expressionString = String(expression);
+                        if (expressionString.includes('status')) {
+                            return { isValid: true };
+                        }
+                        return {
+                            isValid: false,
+                            message: 'readyWhen expressions typically reference resource status fields',
+                            suggestions: ['Reference .status fields', 'Use resource readiness indicators']
+                        };
+                    }
+                }
+            ]
+        });
+        logger.info('Built-in custom contexts registered', {
+            contexts: ['includeWhen', 'readyWhen']
+        });
+    }
+}
+/**
+ * Global custom context manager instance
+ */
+export const customContextManager = new CustomContextManager();
+/**
+ * Utility function to register a custom context
+ *
+ * @param contextConfig - Configuration for the custom context
+ * @returns The registered custom context
+ */
+export function registerCustomContext(contextConfig) {
+    return customContextManager.registerCustomContext(contextConfig);
+}
+/**
+ * Utility function to process expression in custom context
+ *
+ * @param contextName - Name of the custom context
+ * @param expression - Expression to process
+ * @param factoryContext - Factory context
+ * @param config - Processing configuration
+ * @returns Processing result
+ */
+export function processInCustomContext(contextName, expression, factoryContext, config) {
+    return customContextManager.processInCustomContext(contextName, expression, factoryContext, config);
+}
+/**
+ * Utility function to auto-process expression in custom context
+ *
+ * @param expression - Expression to process
+ * @param factoryContext - Factory context
+ * @param config - Processing configuration
+ * @returns Processing result or null if no suitable context found
+ */
+export function autoProcessInCustomContext(expression, factoryContext, config) {
+    return customContextManager.autoProcessInCustomContext(expression, factoryContext, config);
+}
+//# sourceMappingURL=custom-context-manager.js.map

package/dist/core/expressions/custom-context-manager.js.map

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