typekro 0.3.1 → 0.5.0

package/dist/core/expressions/magic-proxy/optionality-handler.js

@@ -0,0 +1,321 @@
+/**
+ * Enhanced Type Optionality Handler for JavaScript to CEL Expression Conversion
+ *
+ * This module handles the mismatch between Enhanced type compile-time non-optionality
+ * and runtime optionality during field hydration. Enhanced types show fields as
+ * non-optional at compile time, but KubernetesRef objects might resolve to undefined
+ * during field hydration.
+ *
+ * Key Features:
+ * - Automatic null-safety detection for Enhanced type KubernetesRef objects
+ * - CEL expression generation with has() checks for potentially undefined fields
+ * - Support for optional chaining with Enhanced types that appear non-optional
+ * - Integration with field hydration timing to handle undefined-to-defined transitions
+ * - Context-aware optionality handling based on field hydration state
+ */
+import { DEFAULT_MAX_OPTIONALITY_DEPTH } from '../../config/defaults.js';
+import { ConversionError, ensureError } from '../../errors.js';
+import { getComponentLogger } from '../../logging/index.js';
+import { analyzeKubernetesRefOptionality, extractKubernetesRefsFromExpression, } from './optionality-analysis.js';
+import { convertToBasicCel, generateCelWithHasChecksImpl, generateNullSafeExpression, generateSourceMapping, } from './optionality-cel-generation.js';
+import { analyzeHydrationStates, createTransitionPlan, extractPotentialKubernetesRefsFromEnhanced, generateEnhancedTypeNullSafetyPattern, generateFallbackExpressions, generateHydrationDependentExpression, generateHydrationTransitionHandlers, generatePhaseExpressions, generatePostHydrationExpression, generatePreHydrationExpression, generateWatchExpressions, } from './optionality-hydration.js';
+import { analyzeOptionalChainingPatterns, generateOptionalChainingCelExpression, } from './optionality-optional-chaining.js';
+/**
+ * Default optionality handling options
+ */
+const DEFAULT_OPTIONALITY_OPTIONS = {
+    deepAnalysis: true,
+    conservative: true,
+    useKroConditionals: true,
+    generateHasChecks: true,
+    maxDepth: DEFAULT_MAX_OPTIONALITY_DEPTH,
+    includeReasoning: true,
+};
+/**
+ * Enhanced Type Optionality Handler
+ *
+ * Handles the complexity of Enhanced types that appear non-optional at compile time
+ * but may be undefined at runtime during field hydration.
+ */
+export class EnhancedTypeOptionalityHandler {
+    options;
+    logger = getComponentLogger('optionality-handler');
+    constructor(options) {
+        this.options = { ...DEFAULT_OPTIONALITY_OPTIONS, ...options };
+    }
+    /**
+     * Analyze KubernetesRef objects for optionality requirements
+     *
+     * This method determines whether KubernetesRef objects in expressions require
+     * null-safety handling based on Enhanced type behavior and field hydration timing.
+     */
+    analyzeOptionalityRequirements(expression, context) {
+        const results = [];
+        try {
+            // Extract all KubernetesRef objects from the expression
+            const kubernetesRefs = extractKubernetesRefsFromExpression(expression);
+            this.logger.debug('Analyzing optionality requirements', {
+                expressionType: typeof expression,
+                kubernetesRefCount: kubernetesRefs.length,
+                contextType: context.type,
+            });
+            for (const ref of kubernetesRefs) {
+                const analysis = analyzeKubernetesRefOptionality(ref, context);
+                results.push(analysis);
+            }
+            return results;
+        }
+        catch (error) {
+            this.logger.error('Failed to analyze optionality requirements', ensureError(error));
+            return [];
+        }
+    }
+    /**
+     * Generate CEL expressions with appropriate null-safety checks
+     *
+     * This method takes the optionality analysis results and generates CEL expressions
+     * that include proper null-safety handling for potentially undefined fields.
+     */
+    generateNullSafeCelExpression(originalExpression, optionalityResults, context) {
+        try {
+            // Determine if any KubernetesRef objects require null-safety
+            const requiresNullSafety = optionalityResults.some((result) => result.requiresNullSafety);
+            if (!requiresNullSafety) {
+                // No null-safety required, return as-is
+                return {
+                    valid: true,
+                    celExpression: convertToBasicCel(originalExpression, context),
+                    dependencies: optionalityResults.map((r) => r.kubernetesRef),
+                    sourceMap: [],
+                    errors: [],
+                    warnings: [],
+                    requiresConversion: optionalityResults.length > 0,
+                };
+            }
+            // Generate null-safe CEL expression
+            const nullSafeCel = generateNullSafeExpression(originalExpression, optionalityResults, context, this.logger);
+            return {
+                valid: true,
+                celExpression: nullSafeCel,
+                dependencies: optionalityResults.map((r) => r.kubernetesRef),
+                sourceMap: generateSourceMapping(originalExpression, nullSafeCel, context),
+                errors: [],
+                warnings: [],
+                requiresConversion: true,
+            };
+        }
+        catch (error) {
+            const conversionError = new ConversionError(`Failed to generate null-safe CEL expression: ${ensureError(error).message}`, String(originalExpression), 'unknown');
+            return {
+                valid: false,
+                celExpression: null,
+                dependencies: optionalityResults.map((r) => r.kubernetesRef),
+                sourceMap: [],
+                errors: [conversionError],
+                warnings: [],
+                requiresConversion: true,
+            };
+        }
+    }
+    /**
+     * Handle optional chaining with Enhanced types
+     *
+     * This method specifically handles cases where optional chaining is used with
+     * Enhanced types that appear non-optional at compile time.
+     */
+    handleOptionalChainingWithEnhancedTypes(expression, context) {
+        try {
+            // Detect optional chaining patterns in the expression
+            const optionalChainingAnalysis = analyzeOptionalChainingPatterns(expression, context);
+            if (optionalChainingAnalysis.patterns.length === 0) {
+                // No optional chaining detected - analyze for regular optionality
+                const optionalityResults = this.analyzeOptionalityRequirements(expression, context);
+                return this.generateNullSafeCelExpression(expression, optionalityResults, context);
+            }
+            // Generate appropriate CEL expressions for optional chaining with Enhanced types
+            const celResult = generateOptionalChainingCelExpression(expression, optionalChainingAnalysis, context, (expr, ctx) => {
+                const optionalityResults = this.analyzeOptionalityRequirements(expr, ctx);
+                return this.generateNullSafeCelExpression(expr, optionalityResults, ctx);
+            });
+            return celResult;
+        }
+        catch (error) {
+            const conversionError = new ConversionError(`Failed to handle optional chaining: ${ensureError(error).message}`, String(expression), 'optional-chaining');
+            return {
+                valid: false,
+                celExpression: null,
+                dependencies: extractKubernetesRefsFromExpression(expression),
+                sourceMap: [],
+                errors: [conversionError],
+                warnings: [],
+                requiresConversion: true,
+            };
+        }
+    }
+    /**
+     * Automatically detect null-safety requirements for Enhanced type KubernetesRef objects
+     *
+     * This method analyzes Enhanced types and their KubernetesRef objects to determine
+     * which fields require null-safety checks despite appearing non-optional at compile time.
+     */
+    detectNullSafetyRequirements(enhancedResources, context) {
+        const nullSafetyMap = new Map();
+        try {
+            this.logger.debug('Detecting null-safety requirements for Enhanced types', {
+                resourceCount: Object.keys(enhancedResources).length,
+                contextType: context.type,
+            });
+            for (const [resourceId, enhancedResource] of Object.entries(enhancedResources)) {
+                const resourceAnalysis = [];
+                // Analyze the Enhanced resource for potential KubernetesRef objects
+                const potentialRefs = extractPotentialKubernetesRefsFromEnhanced(enhancedResource, resourceId);
+                for (const ref of potentialRefs) {
+                    const analysis = analyzeKubernetesRefOptionality(ref, context);
+                    // Enhanced types require special handling
+                    if (analysis.potentiallyUndefined) {
+                        analysis.reason = `Enhanced type field '${analysis.fieldPath}' appears non-optional at compile time but may be undefined at runtime during field hydration`;
+                        analysis.requiresNullSafety = true;
+                        analysis.suggestedCelPattern = generateEnhancedTypeNullSafetyPattern(ref, context);
+                    }
+                    resourceAnalysis.push(analysis);
+                }
+                if (resourceAnalysis.length > 0) {
+                    nullSafetyMap.set(resourceId, resourceAnalysis);
+                }
+            }
+            this.logger.debug('Null-safety detection complete', {
+                resourcesWithNullSafety: nullSafetyMap.size,
+                totalAnalysisResults: Array.from(nullSafetyMap.values()).reduce((sum, arr) => sum + arr.length, 0),
+            });
+            return nullSafetyMap;
+        }
+        catch (error) {
+            this.logger.error('Failed to detect null-safety requirements', ensureError(error));
+            return new Map();
+        }
+    }
+    /**
+     * Integrate with field hydration timing
+     *
+     * This method provides integration with TypeKro's field hydration system to
+     * handle the transition from undefined to defined values during hydration.
+     */
+    integrateWithFieldHydrationTiming(expression, hydrationStates, context) {
+        try {
+            const kubernetesRefs = extractKubernetesRefsFromExpression(expression);
+            // Analyze hydration states for all references
+            const hydrationAnalysis = analyzeHydrationStates(kubernetesRefs, hydrationStates);
+            // Generate expressions for different hydration phases
+            const preHydrationExpr = generatePreHydrationExpression(expression, hydrationAnalysis.unhydratedRefs, context);
+            const postHydrationExpr = generatePostHydrationExpression(expression, hydrationAnalysis.hydratedRefs, context);
+            const hydrationDependentExpr = generateHydrationDependentExpression(expression, hydrationAnalysis.hydratingRefs, context);
+            // Generate transition handlers for undefined-to-defined transitions
+            const transitionHandlers = generateHydrationTransitionHandlers(expression, hydrationAnalysis, context);
+            return {
+                preHydrationExpression: preHydrationExpr,
+                postHydrationExpression: postHydrationExpr,
+                hydrationDependentExpression: hydrationDependentExpr,
+                transitionHandlers,
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to integrate with field hydration timing', ensureError(error));
+            return {
+                preHydrationExpression: null,
+                postHydrationExpression: null,
+                hydrationDependentExpression: null,
+                transitionHandlers: [],
+            };
+        }
+    }
+    /**
+     * Handle undefined-to-defined transitions during field hydration
+     *
+     * This method creates handlers for the transition from undefined to defined
+     * values as fields are hydrated over time.
+     */
+    handleUndefinedToDefinedTransitions(expression, hydrationStates, context) {
+        try {
+            const kubernetesRefs = extractKubernetesRefsFromExpression(expression);
+            const transitionPlan = createTransitionPlan(kubernetesRefs, hydrationStates, context);
+            return {
+                transitionPlan,
+                phaseExpressions: generatePhaseExpressions(expression, transitionPlan, context, this.logger),
+                watchExpressions: generateWatchExpressions(transitionPlan, context),
+                fallbackExpressions: generateFallbackExpressions(expression, transitionPlan, context),
+                valid: true,
+                errors: [],
+            };
+        }
+        catch (error) {
+            const transitionError = new ConversionError(`Failed to handle undefined-to-defined transitions: ${ensureError(error).message}`, String(expression), 'unknown');
+            return {
+                transitionPlan: { phases: [], totalDuration: 0, criticalFields: [] },
+                phaseExpressions: new Map(),
+                watchExpressions: [],
+                fallbackExpressions: new Map(),
+                valid: false,
+                errors: [transitionError],
+            };
+        }
+    }
+    /**
+     * Generate CEL expressions with has() checks for potentially undefined fields
+     *
+     * This method creates comprehensive CEL expressions that include has() checks
+     * for all potentially undefined fields in the expression.
+     */
+    generateCelWithHasChecks(expression, optionalityResults, context) {
+        return generateCelWithHasChecksImpl(expression, optionalityResults, context, this.logger);
+    }
+}
+/**
+ * Convenience function to analyze optionality requirements
+ */
+export function analyzeOptionalityRequirements(expression, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.analyzeOptionalityRequirements(expression, context);
+}
+/**
+ * Convenience function to generate null-safe CEL expressions
+ */
+export function generateNullSafeCelExpression(expression, optionalityResults, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.generateNullSafeCelExpression(expression, optionalityResults, context);
+}
+/**
+ * Convenience function to handle optional chaining with Enhanced types
+ */
+export function handleOptionalChainingWithEnhancedTypes(expression, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.handleOptionalChainingWithEnhancedTypes(expression, context);
+}
+/**
+ * Convenience function to generate CEL expressions with has() checks
+ */
+export function generateCelWithHasChecks(expression, optionalityResults, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.generateCelWithHasChecks(expression, optionalityResults, context);
+}
+/**
+ * Convenience function to detect null-safety requirements for Enhanced types
+ */
+export function detectNullSafetyRequirements(enhancedResources, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.detectNullSafetyRequirements(enhancedResources, context);
+}
+/**
+ * Convenience function to integrate with field hydration timing
+ */
+export function integrateWithFieldHydrationTiming(expression, hydrationStates, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.integrateWithFieldHydrationTiming(expression, hydrationStates, context);
+}
+/**
+ * Convenience function to handle undefined-to-defined transitions
+ */
+export function handleUndefinedToDefinedTransitions(expression, hydrationStates, context, options) {
+    const handler = new EnhancedTypeOptionalityHandler(options);
+    return handler.handleUndefinedToDefinedTransitions(expression, hydrationStates, context);
+}
+//# sourceMappingURL=optionality-handler.js.map

package/dist/core/expressions/magic-proxy/optionality-handler.js.map

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

package/dist/core/expressions/magic-proxy/optionality-hydration.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Field hydration timing and undefined-to-defined transition handling
+ * for the Enhanced Type Optionality Handler.
+ *
+ * These standalone functions handle analyzing hydration states, creating
+ * transition plans, and generating expressions for different hydration phases.
+ */
+import type { TypeKroLogger } from '../../logging/types.js';
+import type { CelExpression, KubernetesRef } from '../../types/common.js';
+import type { Enhanced } from '../../types/kubernetes.js';
+import type { FieldHydrationState, HydrationPhase, HydrationStateAnalysis, HydrationTransitionHandler, HydrationTransitionPlan, OptionalityContext } from './optionality-types.js';
+/**
+ * Analyze hydration states for KubernetesRef objects
+ */
+export declare function analyzeHydrationStates(kubernetesRefs: KubernetesRef<unknown>[], hydrationStates: Map<string, FieldHydrationState>): HydrationStateAnalysis;
+/**
+ * Create transition plan for hydration phases
+ */
+export declare function createTransitionPlan(kubernetesRefs: KubernetesRef<unknown>[], _hydrationStates: Map<string, FieldHydrationState>, _context: OptionalityContext): HydrationTransitionPlan;
+/**
+ * Generate hydration transition handlers
+ */
+export declare function generateHydrationTransitionHandlers(expression: unknown, hydrationAnalysis: HydrationStateAnalysis, context: OptionalityContext): HydrationTransitionHandler[];
+/**
+ * Generate phase expressions for different hydration phases
+ */
+export declare function generatePhaseExpressions(expression: unknown, transitionPlan: HydrationTransitionPlan, context: OptionalityContext, logger: TypeKroLogger): Map<string, CelExpression>;
+/**
+ * Generate watch expressions for monitoring hydration progress
+ */
+export declare function generateWatchExpressions(transitionPlan: HydrationTransitionPlan, _context: OptionalityContext): CelExpression[];
+/**
+ * Generate fallback expressions for hydration failures
+ */
+export declare function generateFallbackExpressions(_expression: unknown, transitionPlan: HydrationTransitionPlan, _context: OptionalityContext): Map<string, CelExpression>;
+/**
+ * Generate phase-specific expression
+ */
+export declare function generatePhaseSpecificExpression(_expression: unknown, phase: HydrationPhase, _context: OptionalityContext): CelExpression;
+/**
+ * Generate condition for hydration start
+ */
+export declare function generateHydrationStartCondition(refs: KubernetesRef<unknown>[]): string;
+/**
+ * Generate expression for hydration start
+ */
+export declare function generateHydrationStartExpression(_expression: unknown, _refs: KubernetesRef<unknown>[], _context: OptionalityContext): CelExpression;
+/**
+ * Generate condition for hydration complete
+ */
+export declare function generateHydrationCompleteCondition(refs: KubernetesRef<unknown>[]): string;
+/**
+ * Generate expression for hydration complete
+ */
+export declare function generateHydrationCompleteExpression(expression: unknown, _refs: KubernetesRef<unknown>[], context: OptionalityContext): CelExpression;
+/**
+ * Generate condition for hydration failure
+ */
+export declare function generateHydrationFailureCondition(_refs: KubernetesRef<unknown>[]): string;
+/**
+ * Generate expression for hydration failure
+ */
+export declare function generateHydrationFailureExpression(_expression: unknown, _refs: KubernetesRef<unknown>[], _context: OptionalityContext): CelExpression;
+/**
+ * Generate pre-hydration expression (for unhydrated fields)
+ */
+export declare function generatePreHydrationExpression(_expression: unknown, _unhydratedRefs: KubernetesRef<unknown>[], _context: OptionalityContext): CelExpression;
+/**
+ * Generate post-hydration expression (for hydrated fields)
+ */
+export declare function generatePostHydrationExpression(expression: unknown, _hydratedRefs: KubernetesRef<unknown>[], context: OptionalityContext): CelExpression;
+/**
+ * Generate hydration-dependent expression (for fields being hydrated)
+ */
+export declare function generateHydrationDependentExpression(_expression: unknown, hydratingRefs: KubernetesRef<unknown>[], _context: OptionalityContext): CelExpression;
+/**
+ * Extract potential KubernetesRef objects from Enhanced resources
+ */
+export declare function extractPotentialKubernetesRefsFromEnhanced(_enhancedResource: Enhanced<unknown, unknown>, resourceId: string): KubernetesRef<unknown>[];
+/**
+ * Generate Enhanced type-specific null-safety patterns
+ */
+export declare function generateEnhancedTypeNullSafetyPattern(kubernetesRef: KubernetesRef<unknown>, context: OptionalityContext): string;
+//# sourceMappingURL=optionality-hydration.d.ts.map

package/dist/core/expressions/magic-proxy/optionality-hydration.d.ts.map

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