typekro 0.2.2 → 0.3.0

package/dist/core/expressions/magic-proxy-detector.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Magic Proxy Detection for Factory Integration
+ *
+ * This module provides enhanced detection capabilities for KubernetesRef objects
+ * that originate from TypeKro's magic proxy system (SchemaProxy and ResourcesProxy).
+ */
+import type { KubernetesRef } from '../types/index.js';
+/**
+ * Information about a detected KubernetesRef from magic proxy
+ */
+export interface MagicProxyRefInfo {
+    /** The KubernetesRef object */
+    ref: KubernetesRef<any>;
+    /** Path where the reference was found */
+    path: string;
+    /** Source of the reference (schema or resource) */
+    source: 'schema' | 'resource' | 'unknown';
+    /** Resource ID if from resource proxy */
+    resourceId?: string;
+    /** Field path within the resource/schema */
+    fieldPath: string;
+    /** Whether this is a nested reference */
+    isNested: boolean;
+    /** Depth of nesting */
+    nestingDepth: number;
+}
+/**
+ * Result of magic proxy detection
+ */
+export interface MagicProxyDetectionResult {
+    /** Whether any KubernetesRef objects were found */
+    hasKubernetesRefs: boolean;
+    /** List of detected references */
+    references: MagicProxyRefInfo[];
+    /** Statistics about the detection */
+    stats: {
+        totalReferences: number;
+        schemaReferences: number;
+        resourceReferences: number;
+        nestedReferences: number;
+        maxNestingDepth: number;
+    };
+    /** Performance metrics */
+    metrics: {
+        detectionTimeMs: number;
+        objectsScanned: number;
+        propertiesScanned: number;
+    };
+}
+/**
+ * Configuration for magic proxy detection
+ */
+export interface MagicProxyDetectionConfig {
+    /** Maximum depth to scan for nested references */
+    maxDepth?: number;
+    /** Whether to include detailed path information */
+    includeDetailedPaths?: boolean;
+    /** Whether to analyze reference sources */
+    analyzeReferenceSources?: boolean;
+    /** Whether to track performance metrics */
+    trackMetrics?: boolean;
+}
+/**
+ * Magic Proxy Detector
+ *
+ * Provides sophisticated detection of KubernetesRef objects that originate
+ * from TypeKro's magic proxy system, with detailed analysis of their sources
+ * and usage patterns.
+ */
+export declare class MagicProxyDetector {
+    /**
+     * Detect KubernetesRef objects in a value with detailed analysis
+     *
+     * @param value - Value to analyze
+     * @param config - Detection configuration
+     * @param basePath - Base path for reference tracking
+     * @returns Detection result
+     */
+    detectKubernetesRefs(value: any, config?: MagicProxyDetectionConfig, basePath?: string): MagicProxyDetectionResult;
+    /**
+     * Check if a value contains any KubernetesRef objects (fast check)
+     *
+     * @param value - Value to check
+     * @param maxDepth - Maximum depth to check
+     * @returns Whether KubernetesRef objects were found
+     */
+    containsKubernetesRefs(value: any, maxDepth?: number): boolean;
+    /**
+     * Extract all KubernetesRef objects from a value
+     *
+     * @param value - Value to extract from
+     * @param maxDepth - Maximum depth to extract
+     * @returns Array of KubernetesRef objects
+     */
+    extractKubernetesRefs(value: any, maxDepth?: number): KubernetesRef<any>[];
+    /**
+     * Analyze the source of a KubernetesRef object
+     *
+     * @param ref - KubernetesRef to analyze
+     * @returns Source analysis
+     */
+    analyzeReferenceSource(ref: KubernetesRef<any>): {
+        source: 'schema' | 'resource' | 'unknown';
+        isSchemaRef: boolean;
+        isResourceRef: boolean;
+        resourceId?: string;
+        fieldPath: string;
+    };
+    private scanValue;
+    private fastScanForRefs;
+    private extractRefs;
+}
+/**
+ * Global magic proxy detector instance
+ */
+export declare const magicProxyDetector: MagicProxyDetector;
+/**
+ * Utility function to detect KubernetesRef objects in a value
+ *
+ * @param value - Value to analyze
+ * @param config - Detection configuration
+ * @returns Detection result
+ */
+export declare function detectMagicProxyRefs(value: any, config?: MagicProxyDetectionConfig): MagicProxyDetectionResult;
+/**
+ * Utility function to check if a value contains KubernetesRef objects
+ *
+ * @param value - Value to check
+ * @param maxDepth - Maximum depth to check
+ * @returns Whether KubernetesRef objects were found
+ */
+export declare function containsMagicProxyRefs(value: any, maxDepth?: number): boolean;
+/**
+ * Utility function to extract all KubernetesRef objects from a value
+ *
+ * @param value - Value to extract from
+ * @param maxDepth - Maximum depth to extract
+ * @returns Array of KubernetesRef objects
+ */
+export declare function extractMagicProxyRefs(value: any, maxDepth?: number): KubernetesRef<any>[];
+/**
+ * Utility function to analyze the source of a KubernetesRef object
+ *
+ * @param ref - KubernetesRef to analyze
+ * @returns Source analysis
+ */
+export declare function analyzeMagicProxyRefSource(ref: KubernetesRef<any>): {
+    source: "schema" | "resource" | "unknown";
+    isSchemaRef: boolean;
+    isResourceRef: boolean;
+    resourceId?: string;
+    fieldPath: string;
+};
+//# sourceMappingURL=magic-proxy-detector.d.ts.map

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

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

package/dist/core/expressions/magic-proxy-detector.js

@@ -0,0 +1,242 @@
+/**
+ * Magic Proxy Detection for Factory Integration
+ *
+ * This module provides enhanced detection capabilities for KubernetesRef objects
+ * that originate from TypeKro's magic proxy system (SchemaProxy and ResourcesProxy).
+ */
+import { getComponentLogger } from '../logging/index.js';
+import { isKubernetesRef } from '../../utils/type-guards.js';
+const logger = getComponentLogger('magic-proxy-detector');
+/**
+ * Magic Proxy Detector
+ *
+ * Provides sophisticated detection of KubernetesRef objects that originate
+ * from TypeKro's magic proxy system, with detailed analysis of their sources
+ * and usage patterns.
+ */
+export class MagicProxyDetector {
+    /**
+     * Detect KubernetesRef objects in a value with detailed analysis
+     *
+     * @param value - Value to analyze
+     * @param config - Detection configuration
+     * @param basePath - Base path for reference tracking
+     * @returns Detection result
+     */
+    detectKubernetesRefs(value, config = {}, basePath = '') {
+        const startTime = performance.now();
+        const result = {
+            hasKubernetesRefs: false,
+            references: [],
+            stats: {
+                totalReferences: 0,
+                schemaReferences: 0,
+                resourceReferences: 0,
+                nestedReferences: 0,
+                maxNestingDepth: 0
+            },
+            metrics: {
+                detectionTimeMs: 0,
+                objectsScanned: 0,
+                propertiesScanned: 0
+            }
+        };
+        this.scanValue(value, result, config, basePath, 0);
+        result.hasKubernetesRefs = result.references.length > 0;
+        result.stats.totalReferences = result.references.length;
+        result.stats.schemaReferences = result.references.filter(r => r.source === 'schema').length;
+        result.stats.resourceReferences = result.references.filter(r => r.source === 'resource').length;
+        result.stats.nestedReferences = result.references.filter(r => r.isNested).length;
+        result.stats.maxNestingDepth = Math.max(...result.references.map(r => r.nestingDepth), 0);
+        result.metrics.detectionTimeMs = performance.now() - startTime;
+        if (config.trackMetrics !== false) {
+            logger.debug('Magic proxy detection completed', {
+                hasKubernetesRefs: result.hasKubernetesRefs,
+                totalReferences: result.stats.totalReferences,
+                detectionTimeMs: result.metrics.detectionTimeMs
+            });
+        }
+        return result;
+    }
+    /**
+     * Check if a value contains any KubernetesRef objects (fast check)
+     *
+     * @param value - Value to check
+     * @param maxDepth - Maximum depth to check
+     * @returns Whether KubernetesRef objects were found
+     */
+    containsKubernetesRefs(value, maxDepth = 10) {
+        return this.fastScanForRefs(value, 0, maxDepth);
+    }
+    /**
+     * Extract all KubernetesRef objects from a value
+     *
+     * @param value - Value to extract from
+     * @param maxDepth - Maximum depth to extract
+     * @returns Array of KubernetesRef objects
+     */
+    extractKubernetesRefs(value, maxDepth = 10) {
+        const refs = [];
+        this.extractRefs(value, refs, 0, maxDepth);
+        return refs;
+    }
+    /**
+     * Analyze the source of a KubernetesRef object
+     *
+     * @param ref - KubernetesRef to analyze
+     * @returns Source analysis
+     */
+    analyzeReferenceSource(ref) {
+        const resourceId = ref.resourceId;
+        const fieldPath = ref.fieldPath || '';
+        // Handle malformed refs gracefully
+        if (!resourceId || typeof resourceId !== 'string') {
+            return {
+                source: 'unknown',
+                isSchemaRef: false,
+                isResourceRef: false,
+                fieldPath
+            };
+        }
+        // Detect schema references (typically have __schema__ as resourceId)
+        const isSchemaRef = resourceId === '__schema__' || resourceId.startsWith('schema.');
+        // Detect resource references (have actual resource IDs)
+        const isResourceRef = !isSchemaRef && !!resourceId && resourceId !== '__schema__';
+        const source = isSchemaRef ? 'schema' :
+            isResourceRef ? 'resource' :
+                'unknown';
+        const result = {
+            source,
+            isSchemaRef,
+            isResourceRef,
+            fieldPath
+        };
+        if (isResourceRef && resourceId) {
+            result.resourceId = resourceId;
+        }
+        return result;
+    }
+    scanValue(value, result, config, currentPath, depth) {
+        const maxDepth = config.maxDepth || 10;
+        if (depth >= maxDepth) {
+            return;
+        }
+        result.metrics.objectsScanned++;
+        // Check if this value is a KubernetesRef
+        if (isKubernetesRef(value)) {
+            const sourceAnalysis = config.analyzeReferenceSources !== false
+                ? this.analyzeReferenceSource(value)
+                : { source: 'unknown', isSchemaRef: false, isResourceRef: false, fieldPath: value.fieldPath };
+            const refInfo = {
+                ref: value,
+                path: currentPath,
+                source: sourceAnalysis.source,
+                ...(sourceAnalysis.resourceId && { resourceId: sourceAnalysis.resourceId }),
+                fieldPath: sourceAnalysis.fieldPath,
+                isNested: depth > 1, // Only consider nested if depth > 1 (not just at object level)
+                nestingDepth: depth
+            };
+            result.references.push(refInfo);
+            return;
+        }
+        // Recursively scan objects and arrays
+        if (value && typeof value === 'object') {
+            if (Array.isArray(value)) {
+                value.forEach((item, index) => {
+                    result.metrics.propertiesScanned++;
+                    const itemPath = config.includeDetailedPaths !== false
+                        ? `${currentPath}[${index}]`
+                        : currentPath;
+                    this.scanValue(item, result, config, itemPath, depth + 1);
+                });
+            }
+            else {
+                for (const [key, val] of Object.entries(value)) {
+                    result.metrics.propertiesScanned++;
+                    const propPath = config.includeDetailedPaths !== false
+                        ? currentPath ? `${currentPath}.${key}` : key
+                        : currentPath;
+                    this.scanValue(val, result, config, propPath, depth + 1);
+                }
+            }
+        }
+    }
+    fastScanForRefs(value, depth, maxDepth) {
+        if (depth >= maxDepth) {
+            return false;
+        }
+        if (isKubernetesRef(value)) {
+            return true;
+        }
+        if (value && typeof value === 'object') {
+            if (Array.isArray(value)) {
+                return value.some(item => this.fastScanForRefs(item, depth + 1, maxDepth));
+            }
+            else {
+                return Object.values(value).some(val => this.fastScanForRefs(val, depth + 1, maxDepth));
+            }
+        }
+        return false;
+    }
+    extractRefs(value, refs, depth, maxDepth) {
+        if (depth >= maxDepth) {
+            return;
+        }
+        if (isKubernetesRef(value)) {
+            refs.push(value);
+            return;
+        }
+        if (value && typeof value === 'object') {
+            if (Array.isArray(value)) {
+                value.forEach(item => this.extractRefs(item, refs, depth + 1, maxDepth));
+            }
+            else {
+                Object.values(value).forEach(val => this.extractRefs(val, refs, depth + 1, maxDepth));
+            }
+        }
+    }
+}
+/**
+ * Global magic proxy detector instance
+ */
+export const magicProxyDetector = new MagicProxyDetector();
+/**
+ * Utility function to detect KubernetesRef objects in a value
+ *
+ * @param value - Value to analyze
+ * @param config - Detection configuration
+ * @returns Detection result
+ */
+export function detectMagicProxyRefs(value, config) {
+    return magicProxyDetector.detectKubernetesRefs(value, config);
+}
+/**
+ * Utility function to check if a value contains KubernetesRef objects
+ *
+ * @param value - Value to check
+ * @param maxDepth - Maximum depth to check
+ * @returns Whether KubernetesRef objects were found
+ */
+export function containsMagicProxyRefs(value, maxDepth) {
+    return magicProxyDetector.containsKubernetesRefs(value, maxDepth);
+}
+/**
+ * Utility function to extract all KubernetesRef objects from a value
+ *
+ * @param value - Value to extract from
+ * @param maxDepth - Maximum depth to extract
+ * @returns Array of KubernetesRef objects
+ */
+export function extractMagicProxyRefs(value, maxDepth) {
+    return magicProxyDetector.extractKubernetesRefs(value, maxDepth);
+}
+/**
+ * Utility function to analyze the source of a KubernetesRef object
+ *
+ * @param ref - KubernetesRef to analyze
+ * @returns Source analysis
+ */
+export function analyzeMagicProxyRefSource(ref) {
+    return magicProxyDetector.analyzeReferenceSource(ref);
+}
+//# sourceMappingURL=magic-proxy-detector.js.map

package/dist/core/expressions/magic-proxy-detector.js.map

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

package/dist/core/expressions/migration-helpers.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Migration Helpers for Converting CEL to JavaScript with Magic Proxy Support
+ *
+ * This module provides utilities to help developers migrate from manual CEL expressions
+ * to natural JavaScript expressions that work with TypeKro's magic proxy system.
+ *
+ * The helpers analyze existing CEL expressions and suggest equivalent JavaScript
+ * expressions that will be automatically converted back to CEL by the analyzer.
+ */
+/**
+ * Migration suggestion for converting CEL to JavaScript
+ */
+export interface MigrationSuggestion {
+    /** Original CEL expression */
+    originalCel: string;
+    /** Suggested JavaScript equivalent */
+    suggestedJavaScript: string;
+    /** Confidence level of the suggestion (0-1) */
+    confidence: number;
+    /** Migration category */
+    category: MigrationCategory;
+    /** Additional notes or warnings */
+    notes: string[];
+    /** Whether the migration is safe (no behavior change expected) */
+    isSafe: boolean;
+    /** Example usage in status builder context */
+    exampleUsage?: string;
+}
+/**
+ * Migration category
+ */
+export type MigrationCategory = 'simple-comparison' | 'template-string' | 'conditional-expression' | 'resource-reference' | 'schema-reference' | 'complex-expression' | 'unsupported';
+/**
+ * Migration analysis result
+ */
+export interface MigrationAnalysisResult {
+    /** All migration suggestions */
+    suggestions: MigrationSuggestion[];
+    /** Suggestions by category */
+    suggestionsByCategory: Map<MigrationCategory, MigrationSuggestion[]>;
+    /** Overall migration feasibility */
+    migrationFeasibility: {
+        totalExpressions: number;
+        migratableExpressions: number;
+        safeMigrations: number;
+        unsupportedExpressions: number;
+        overallConfidence: number;
+    };
+    /** Migration summary */
+    summary: string;
+}
+/**
+ * CEL to JavaScript Migration Helper
+ *
+ * Analyzes existing CEL expressions and provides suggestions for converting
+ * them to equivalent JavaScript expressions that work with magic proxy.
+ */
+export declare class CelToJavaScriptMigrationHelper {
+    private logger;
+    /**
+     * Analyze status mappings and provide migration suggestions
+     */
+    analyzeMigrationOpportunities(statusMappings: Record<string, any>): MigrationAnalysisResult;
+    /**
+     * Recursively analyze object for CEL expressions that can be migrated
+     */
+    private analyzeObjectForMigration;
+    /**
+     * Analyze a single CEL expression and provide migration suggestion
+     */
+    private analyzeCelExpression;
+    /**
+     * Try to migrate simple comparison expressions
+     */
+    private trySimpleComparison;
+    /**
+     * Try to migrate template string expressions
+     */
+    private tryTemplateString;
+    /**
+     * Try to migrate conditional expressions
+     */
+    private tryConditionalExpression;
+    /**
+     * Try to migrate resource reference expressions
+     */
+    private tryResourceReference;
+    /**
+     * Try to migrate schema reference expressions
+     */
+    private trySchemaReference;
+    /**
+     * Try to migrate complex expressions
+     */
+    private tryComplexExpression;
+    /**
+     * Convert CEL resource reference to JavaScript equivalent
+     */
+    private convertCelReferenceToJavaScript;
+    /**
+     * Convert CEL expression part to JavaScript equivalent
+     */
+    private convertCelExpressionToJavaScript;
+    /**
+     * Convert CEL value to JavaScript equivalent
+     */
+    private convertCelValueToJavaScript;
+    /**
+     * Generate migration summary
+     */
+    private generateMigrationSummary;
+    /**
+     * Generate migration guide for a specific status builder
+     */
+    generateMigrationGuide(statusMappings: Record<string, any>, options?: {
+        includeExamples?: boolean;
+        includeWarnings?: boolean;
+        format?: 'markdown' | 'text';
+    }): string;
+    /**
+     * Get human-readable category title
+     */
+    private getCategoryTitle;
+}
+/**
+ * Convenience function to analyze migration opportunities
+ */
+export declare function analyzeCelMigrationOpportunities(statusMappings: Record<string, any>): MigrationAnalysisResult;
+/**
+ * Convenience function to generate migration guide
+ */
+export declare function generateCelMigrationGuide(statusMappings: Record<string, any>, options?: Parameters<CelToJavaScriptMigrationHelper['generateMigrationGuide']>[1]): string;
+//# sourceMappingURL=migration-helpers.d.ts.map

package/dist/core/expressions/migration-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/expressions/migration-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,mCAAmC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC;IAEhB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,iBAAiB,GACjB,wBAAwB,GACxB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IAEnC,8BAA8B;IAC9B,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAErE,oCAAoC;IACpC,oBAAoB,EAAE;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,cAAc,EAAE,MAAM,CAAC;QACvB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IAEF,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,MAAM,CAA8C;IAE5D;;OAEG;IACH,6BAA6B,CAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,uBAAuB;IAgD1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuBjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsC5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsDzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAKvC;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAoBxC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAuBnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,sBAAsB,CACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnC,OAAO,GAAE;QACP,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;KACzB,GACL,MAAM;IA6CT;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAazB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,uBAAuB,CAGzB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnC,OAAO,CAAC,EAAE,UAAU,CAAC,8BAA8B,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,GAChF,MAAM,CAGR"}