typekro 0.2.2 → 0.3.1

package/dist/core/expressions/factory-pattern-handler.js

@@ -0,0 +1,336 @@
+/**
+ * Factory Pattern Handler for JavaScript to CEL Expression Conversion
+ *
+ * This module provides different expression handling strategies based on the factory pattern:
+ * - DirectFactoryExpressionHandler: For direct deployment evaluation
+ * - KroFactoryExpressionHandler: For CEL conversion and Kro deployment
+ *
+ * The factory pattern determines how expressions containing KubernetesRef objects
+ * are processed and converted.
+ */
+import { ConversionError } from '../errors.js';
+import { CEL_EXPRESSION_BRAND } from '../constants/brands.js';
+/**
+ * Expression handler for direct deployment pattern
+ *
+ * In direct deployment, expressions are evaluated at deployment time
+ * by resolving KubernetesRef objects to actual values from deployed resources.
+ */
+export class DirectFactoryExpressionHandler {
+    getPatternType() {
+        return 'direct';
+    }
+    handleExpression(expression, context) {
+        try {
+            // For direct deployment, we still need to generate CEL expressions
+            // but they will be evaluated by the direct deployment engine
+            // rather than by the Kro controller
+            if (typeof expression === 'string') {
+                // Handle string expressions that may contain KubernetesRef references
+                return this.handleStringExpression(expression, context);
+            }
+            if (this.isKubernetesRef(expression)) {
+                // Direct KubernetesRef object
+                const celExpression = this.convertKubernetesRef(expression, context);
+                return {
+                    valid: true,
+                    celExpression,
+                    dependencies: [expression],
+                    sourceMap: [],
+                    errors: [],
+                    warnings: [],
+                    requiresConversion: true
+                };
+            }
+            // For other types, check if they contain KubernetesRef objects
+            const dependencies = this.extractKubernetesRefs(expression);
+            if (dependencies.length === 0) {
+                // No KubernetesRef objects - no conversion needed
+                return {
+                    valid: true,
+                    celExpression: null,
+                    dependencies: [],
+                    sourceMap: [],
+                    errors: [],
+                    warnings: [],
+                    requiresConversion: false
+                };
+            }
+            // Complex expression with KubernetesRef objects
+            return this.handleComplexExpression(expression, dependencies, context);
+        }
+        catch (error) {
+            return {
+                valid: false,
+                celExpression: null,
+                dependencies: [],
+                sourceMap: [],
+                errors: [new ConversionError(`Direct factory expression handling failed: ${error instanceof Error ? error.message : String(error)}`, String(expression), 'javascript')],
+                warnings: [],
+                requiresConversion: true
+            };
+        }
+    }
+    convertKubernetesRef(ref, _context) {
+        // For direct deployment, generate CEL expressions that will be
+        // resolved by the direct deployment engine
+        if (ref.resourceId === '__schema__') {
+            // Schema references
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `schema.${ref.fieldPath}`,
+                _type: ref._type
+            };
+        }
+        else {
+            // Resource references
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `resources.${ref.resourceId}.${ref.fieldPath}`,
+                _type: ref._type
+            };
+        }
+    }
+    handleStringExpression(expression, _context) {
+        // For direct deployment, string expressions are typically
+        // JavaScript expressions that need to be converted to CEL
+        // This would integrate with the main analyzer
+        // For now, return a placeholder result
+        return {
+            valid: true,
+            celExpression: {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: expression,
+                _type: undefined
+            },
+            dependencies: [],
+            sourceMap: [],
+            errors: [],
+            warnings: [],
+            requiresConversion: true
+        };
+    }
+    handleComplexExpression(_expression, dependencies, _context) {
+        // Handle complex expressions containing KubernetesRef objects
+        // This would involve analyzing the structure and converting appropriately
+        return {
+            valid: true,
+            celExpression: {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `/* Complex expression with ${dependencies.length} dependencies */`,
+                _type: undefined
+            },
+            dependencies,
+            sourceMap: [],
+            errors: [],
+            warnings: [],
+            requiresConversion: true
+        };
+    }
+    isKubernetesRef(value) {
+        return value && typeof value === 'object' &&
+            typeof value.resourceId === 'string' &&
+            typeof value.fieldPath === 'string';
+    }
+    extractKubernetesRefs(value) {
+        const refs = [];
+        if (this.isKubernetesRef(value)) {
+            refs.push(value);
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                refs.push(...this.extractKubernetesRefs(item));
+            }
+        }
+        else if (value && typeof value === 'object') {
+            for (const key in value) {
+                if (Object.hasOwn(value, key)) {
+                    refs.push(...this.extractKubernetesRefs(value[key]));
+                }
+            }
+        }
+        return refs;
+    }
+}
+/**
+ * Expression handler for Kro deployment pattern
+ *
+ * In Kro deployment, expressions are converted to CEL and evaluated
+ * by the Kro controller at runtime.
+ */
+export class KroFactoryExpressionHandler {
+    getPatternType() {
+        return 'kro';
+    }
+    handleExpression(expression, context) {
+        try {
+            // For Kro deployment, we need to generate CEL expressions
+            // that will be evaluated by the Kro controller
+            if (typeof expression === 'string') {
+                // Handle string expressions that may contain KubernetesRef references
+                return this.handleStringExpression(expression, context);
+            }
+            if (this.isKubernetesRef(expression)) {
+                // Direct KubernetesRef object
+                const celExpression = this.convertKubernetesRef(expression, context);
+                return {
+                    valid: true,
+                    celExpression,
+                    dependencies: [expression],
+                    sourceMap: [],
+                    errors: [],
+                    warnings: [],
+                    requiresConversion: true
+                };
+            }
+            // For other types, check if they contain KubernetesRef objects
+            const dependencies = this.extractKubernetesRefs(expression);
+            if (dependencies.length === 0) {
+                // No KubernetesRef objects - no conversion needed
+                return {
+                    valid: true,
+                    celExpression: null,
+                    dependencies: [],
+                    sourceMap: [],
+                    errors: [],
+                    warnings: [],
+                    requiresConversion: false
+                };
+            }
+            // Complex expression with KubernetesRef objects
+            return this.handleComplexExpression(expression, dependencies, context);
+        }
+        catch (error) {
+            return {
+                valid: false,
+                celExpression: null,
+                dependencies: [],
+                sourceMap: [],
+                errors: [new ConversionError(`Kro factory expression handling failed: ${error instanceof Error ? error.message : String(error)}`, String(expression), 'javascript')],
+                warnings: [],
+                requiresConversion: true
+            };
+        }
+    }
+    convertKubernetesRef(ref, _context) {
+        // For Kro deployment, generate CEL expressions that will be
+        // evaluated by the Kro controller
+        if (ref.resourceId === '__schema__') {
+            // Schema references
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `schema.${ref.fieldPath}`,
+                _type: ref._type
+            };
+        }
+        else {
+            // Resource references
+            return {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `resources.${ref.resourceId}.${ref.fieldPath}`,
+                _type: ref._type
+            };
+        }
+    }
+    handleStringExpression(expression, _context) {
+        // For Kro deployment, string expressions need to be converted
+        // to CEL expressions that the Kro controller can evaluate
+        // For now, return a placeholder result
+        return {
+            valid: true,
+            celExpression: {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: expression,
+                _type: undefined
+            },
+            dependencies: [],
+            sourceMap: [],
+            errors: [],
+            warnings: [],
+            requiresConversion: true
+        };
+    }
+    handleComplexExpression(_expression, dependencies, _context) {
+        // Handle complex expressions containing KubernetesRef objects
+        // For Kro deployment, these need to be converted to CEL expressions
+        return {
+            valid: true,
+            celExpression: {
+                [CEL_EXPRESSION_BRAND]: true,
+                expression: `/* Complex Kro expression with ${dependencies.length} dependencies */`,
+                _type: undefined
+            },
+            dependencies,
+            sourceMap: [],
+            errors: [],
+            warnings: [],
+            requiresConversion: true
+        };
+    }
+    isKubernetesRef(value) {
+        return value && typeof value === 'object' &&
+            typeof value.resourceId === 'string' &&
+            typeof value.fieldPath === 'string';
+    }
+    extractKubernetesRefs(value) {
+        const refs = [];
+        if (this.isKubernetesRef(value)) {
+            refs.push(value);
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                refs.push(...this.extractKubernetesRefs(item));
+            }
+        }
+        else if (value && typeof value === 'object') {
+            for (const key in value) {
+                if (Object.hasOwn(value, key)) {
+                    refs.push(...this.extractKubernetesRefs(value[key]));
+                }
+            }
+        }
+        return refs;
+    }
+}
+/**
+ * Factory for creating appropriate expression handlers based on factory pattern
+ */
+export class FactoryPatternHandlerFactory {
+    /**
+     * Create an expression handler for the specified factory pattern
+     */
+    static createHandler(patternType) {
+        switch (patternType) {
+            case 'direct':
+                return new DirectFactoryExpressionHandler();
+            case 'kro':
+                return new KroFactoryExpressionHandler();
+            default:
+                throw new Error(`Unsupported factory pattern type: ${patternType}`);
+        }
+    }
+    /**
+     * Detect factory pattern from context
+     */
+    static detectFactoryPattern(context) {
+        return context.factoryType;
+    }
+    /**
+     * Create handler based on analysis context
+     */
+    static createHandlerFromContext(context) {
+        const patternType = FactoryPatternHandlerFactory.detectFactoryPattern(context);
+        return FactoryPatternHandlerFactory.createHandler(patternType);
+    }
+}
+/**
+ * Main factory pattern integration point
+ *
+ * This function provides the main integration point for factory pattern
+ * aware expression handling.
+ */
+export function handleExpressionWithFactoryPattern(expression, context) {
+    const handler = FactoryPatternHandlerFactory.createHandlerFromContext(context);
+    return handler.handleExpression(expression, context);
+}
+//# sourceMappingURL=factory-pattern-handler.js.map

package/dist/core/expressions/factory-pattern-handler.js.map

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

package/dist/core/expressions/field-hydration-processor.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Field Hydration Integration for JavaScript to CEL Expression Conversion
+ *
+ * This module provides integration between the JavaScript to CEL expression conversion system
+ * and TypeKro's field hydration strategy. It processes status expressions containing KubernetesRef
+ * objects and tracks dependencies to ensure proper hydration ordering.
+ *
+ * Key Features:
+ * - Uses AST parsing to analyze status builder functions
+ * - Processes status builder expressions with KubernetesRef dependency tracking
+ * - Extracts dependencies from KubernetesRef objects in expressions
+ * - Integrates with existing field hydration strategy for proper ordering
+ * - Handles both direct and Kro factory patterns
+ * - Provides dependency analysis for status field population
+ */
+import type { CelExpression, KubernetesRef } from '../types/common.js';
+import type { Enhanced } from '../types/kubernetes.js';
+import type { SchemaProxy } from '../types/serialization.js';
+import { ConversionError } from '../errors.js';
+import type { DeploymentPlan } from '../dependencies/resolver.js';
+import { JavaScriptToCelAnalyzer, type CelConversionResult } from './analyzer.js';
+import { type SourceMapEntry } from './source-map.js';
+/**
+ * Status builder function type for analysis
+ */
+export type StatusBuilderFunction<TSpec extends Record<string, any> = any, TStatus = any> = (schema: SchemaProxy<TSpec, any>, resources: Record<string, Enhanced<any, any>>) => TStatus;
+/**
+ * Resource reference for dependency tracking
+ */
+export interface ResourceReference {
+    /** Resource ID being referenced */
+    resourceId: string;
+    /** Type of reference (resource or schema) */
+    type: 'resource' | 'schema';
+    /** Field path being accessed */
+    fieldPath?: string;
+    /** Whether this reference is optional (uses optional chaining) */
+    optional?: boolean;
+}
+/**
+ * Field hydration strategy interface
+ */
+export interface FieldHydrationStrategy {
+    /**
+     * Calculate the order in which status fields should be hydrated based on dependencies
+     */
+    calculateHydrationOrder(dependencies: Map<string, ResourceReference[]>): string[];
+    /**
+     * Determine if a field can be hydrated in parallel with others
+     */
+    canHydrateInParallel(fieldName: string, dependencies: ResourceReference[]): boolean;
+    /**
+     * Get the priority of a field for hydration ordering
+     */
+    getFieldPriority(fieldName: string, dependencies: ResourceReference[]): number;
+}
+/**
+ * Default field hydration strategy implementation
+ */
+export declare class DefaultFieldHydrationStrategy implements FieldHydrationStrategy {
+    calculateHydrationOrder(dependencies: Map<string, ResourceReference[]>): string[];
+    canHydrateInParallel(_fieldName: string, dependencies: ResourceReference[]): boolean;
+    getFieldPriority(_fieldName: string, dependencies: ResourceReference[]): number;
+}
+/**
+ * Result of processing status expressions
+ */
+export interface ProcessedStatusBuilder {
+    /** Processed status field mappings with CEL expressions */
+    statusMappings: Record<string, CelExpression>;
+    /** Recommended hydration order for status fields */
+    hydrationOrder: string[];
+    /** Dependencies for each status field */
+    dependencies: Map<string, ResourceReference[]>;
+    /** Source mapping entries for debugging */
+    sourceMap: SourceMapEntry[];
+    /** Processing errors encountered */
+    errors: ConversionError[];
+    /** Whether processing was successful */
+    valid: boolean;
+    /** Analysis results for each field */
+    fieldAnalysis: Map<string, CelConversionResult>;
+    /** Resource references found across all fields */
+    allResourceReferences: ResourceReference[];
+    /** Schema references found across all fields */
+    allSchemaReferences: ResourceReference[];
+}
+/**
+ * Options for field hydration expression processing
+ */
+export interface FieldHydrationProcessingOptions {
+    /** Field hydration strategy to use */
+    hydrationStrategy?: FieldHydrationStrategy;
+    /** Whether to perform deep analysis of expressions */
+    deepAnalysis?: boolean;
+    /** Whether to validate resource references */
+    validateReferences?: boolean;
+    /** Whether to include source mapping */
+    includeSourceMapping?: boolean;
+    /** Maximum depth for expression analysis */
+    maxAnalysisDepth?: number;
+    /** Factory type for CEL generation strategy */
+    factoryType?: 'direct' | 'kro';
+}
+/**
+ * Field Hydration Expression Processor
+ *
+ * Processes status builder functions to extract KubernetesRef dependencies
+ * and integrate with TypeKro's field hydration strategy.
+ */
+export declare class FieldHydrationExpressionProcessor {
+    private expressionAnalyzer;
+    private magicProxyAnalyzer;
+    private dependencyResolver;
+    private options;
+    private logger;
+    constructor(expressionAnalyzer?: JavaScriptToCelAnalyzer, options?: FieldHydrationProcessingOptions);
+    /**
+     * Process status expressions with KubernetesRef dependency tracking
+     *
+     * This is the main method that analyzes a status builder function and extracts
+     * dependencies for proper field hydration ordering.
+     */
+    processStatusExpressions<TSpec extends Record<string, any>, TStatus>(statusBuilder: StatusBuilderFunction<TSpec, TStatus>, resources: Record<string, Enhanced<any, any>>, schemaProxy?: SchemaProxy<TSpec, any>): ProcessedStatusBuilder;
+    /**
+     * Extract dependencies from KubernetesRef objects in expressions
+     *
+     * This method analyzes the KubernetesRef objects found in expressions and
+     * converts them to ResourceReference objects for dependency tracking.
+     */
+    extractDependenciesFromKubernetesRefs(kubernetesRefs: KubernetesRef<any>[]): ResourceReference[];
+    /**
+     * Integrate with existing field hydration strategy
+     *
+     * This method provides integration points with TypeKro's existing field hydration
+     * system by providing dependency information and hydration ordering.
+     */
+    integrateWithFieldHydrationStrategy(processedStatus: ProcessedStatusBuilder, existingStrategy?: FieldHydrationStrategy): {
+        enhancedStrategy: FieldHydrationStrategy;
+        hydrationPlan: DeploymentPlan;
+        parallelizableFields: string[][];
+    };
+    /**
+     * Strip TypeScript syntax that esprima cannot parse
+     */
+    private stripTypeScriptSyntax;
+    /**
+     * Extract field expressions from a status builder function using AST parsing
+     */
+    private extractFieldExpressions;
+    /**
+     * Find the return statement or arrow function body in a function AST
+     */
+    private findReturnStatement;
+    /**
+     * Extract field expressions from a return statement or arrow function body
+     */
+    private extractFieldExpressionsFromReturnStatement;
+    /**
+     * Create mock resources for fallback field extraction
+     */
+    private createMockResources;
+    /**
+     * Analyze a single field expression for KubernetesRef objects
+     */
+    private analyzeFieldExpression;
+    /**
+     * Extract KubernetesRef objects from a value (recursively)
+     */
+    private extractKubernetesRefsFromValue;
+    /**
+     * Extract dependencies from analysis result
+     */
+    private extractDependenciesFromAnalysis;
+    /**
+     * Categorize all references into resource and schema references
+     */
+    private categorizeAllReferences;
+}
+/**
+ * Convenience function to process status expressions
+ */
+export declare function processStatusExpressions<TSpec extends Record<string, any>, TStatus>(statusBuilder: StatusBuilderFunction<TSpec, TStatus>, resources: Record<string, Enhanced<any, any>>, schemaProxy?: SchemaProxy<TSpec, any>, options?: FieldHydrationProcessingOptions): ProcessedStatusBuilder;
+/**
+ * Convenience function to extract dependencies from KubernetesRef objects
+ */
+export declare function extractDependenciesFromKubernetesRefs(kubernetesRefs: KubernetesRef<any>[]): ResourceReference[];
+//# sourceMappingURL=field-hydration-processor.d.ts.map

package/dist/core/expressions/field-hydration-processor.d.ts.map

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