typekro 0.2.2 → 0.3.0

package/dist/core/expressions/cache.js

@@ -0,0 +1,347 @@
+/**
+ * Advanced caching system for JavaScript to CEL expression conversion
+ * Provides multi-level caching with performance monitoring and memory management
+ */
+/**
+ * Advanced multi-level cache for expression conversion results
+ */
+export class ExpressionCache {
+    cache = new Map();
+    astCache = new Map();
+    options;
+    cleanupTimer;
+    stats = {
+        totalRequests: 0,
+        cacheHits: 0,
+        cacheMisses: 0,
+        hitRatio: 0,
+        totalMemoryUsage: 0,
+        maxMemoryUsage: 0,
+        entryCount: 0,
+        averageRetrievalTime: 0,
+        totalRetrievalTime: 0,
+        astCacheHits: 0,
+        astCacheMisses: 0,
+        astEntryCount: 0,
+        astMemoryUsage: 0,
+        totalEvictions: 0,
+        lastCleanupTime: Date.now()
+    };
+    constructor(options = {}) {
+        this.options = {
+            maxEntries: options.maxEntries ?? 1000,
+            maxMemoryMB: options.maxMemoryMB ?? 50,
+            ttlMs: options.ttlMs ?? 5 * 60 * 1000, // 5 minutes
+            cleanupIntervalMs: options.cleanupIntervalMs ?? 0, // Disable by default to prevent hanging
+            enableASTCache: options.enableASTCache ?? true,
+            enableMetrics: options.enableMetrics ?? true
+        };
+        if (this.options.cleanupIntervalMs > 0) {
+            this.startCleanupTimer();
+        }
+    }
+    /**
+     * Get cached conversion result
+     */
+    get(expression, context) {
+        const startTime = this.options.enableMetrics ? performance.now() : 0;
+        try {
+            this.stats.totalRequests++;
+            const key = this.createCacheKey(expression, context);
+            const entry = this.cache.get(key);
+            if (!entry) {
+                this.stats.cacheMisses++;
+                return null;
+            }
+            // Check TTL
+            if (this.isExpired(entry)) {
+                this.cache.delete(key);
+                this.updateMemoryUsage();
+                this.stats.cacheMisses++;
+                return null;
+            }
+            // Update access metadata
+            entry.accessCount++;
+            entry.lastAccessed = Date.now();
+            this.stats.cacheHits++;
+            this.updateHitRatio();
+            return entry.result;
+        }
+        finally {
+            if (this.options.enableMetrics) {
+                const duration = performance.now() - startTime;
+                this.stats.totalRetrievalTime += duration;
+                this.stats.averageRetrievalTime = this.stats.totalRetrievalTime / this.stats.totalRequests;
+            }
+        }
+    }
+    /**
+     * Store conversion result in cache
+     */
+    set(expression, context, result) {
+        const key = this.createCacheKey(expression, context);
+        const size = this.estimateSize(result);
+        const entry = {
+            result,
+            timestamp: Date.now(),
+            accessCount: 1,
+            lastAccessed: Date.now(),
+            size
+        };
+        // Check if we need to evict entries before adding
+        this.ensureCapacity(size);
+        this.cache.set(key, entry);
+        this.updateMemoryUsage();
+        this.stats.entryCount = this.cache.size;
+    }
+    /**
+     * Get cached AST
+     */
+    getAST(expression) {
+        if (!this.options.enableASTCache) {
+            return null;
+        }
+        const entry = this.astCache.get(expression);
+        if (!entry) {
+            this.stats.astCacheMisses++;
+            return null;
+        }
+        // Check TTL
+        if (this.isExpired(entry)) {
+            this.astCache.delete(expression);
+            this.updateASTMemoryUsage();
+            this.stats.astCacheMisses++;
+            return null;
+        }
+        // Update access metadata
+        entry.accessCount++;
+        entry.lastAccessed = Date.now();
+        this.stats.astCacheHits++;
+        return entry.ast;
+    }
+    /**
+     * Store AST in cache
+     */
+    setAST(expression, ast) {
+        if (!this.options.enableASTCache) {
+            return;
+        }
+        const size = this.estimateASTSize(ast);
+        const entry = {
+            ast,
+            timestamp: Date.now(),
+            accessCount: 1,
+            lastAccessed: Date.now(),
+            size
+        };
+        this.astCache.set(expression, entry);
+        this.updateASTMemoryUsage();
+        this.stats.astEntryCount = this.astCache.size;
+    }
+    /**
+     * Clear all caches
+     */
+    clear() {
+        this.cache.clear();
+        this.astCache.clear();
+        this.resetStats();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Force cleanup of expired entries
+     */
+    cleanup() {
+        const _startTime = Date.now();
+        let evicted = 0;
+        // Cleanup main cache
+        for (const [key, entry] of this.cache.entries()) {
+            if (this.isExpired(entry)) {
+                this.cache.delete(key);
+                evicted++;
+            }
+        }
+        // Cleanup AST cache
+        for (const [key, entry] of this.astCache.entries()) {
+            if (this.isExpired(entry)) {
+                this.astCache.delete(key);
+                evicted++;
+            }
+        }
+        this.updateMemoryUsage();
+        this.updateASTMemoryUsage();
+        this.stats.totalEvictions += evicted;
+        this.stats.lastCleanupTime = Date.now();
+        this.stats.entryCount = this.cache.size;
+        this.stats.astEntryCount = this.astCache.size;
+        return evicted;
+    }
+    /**
+     * Destroy cache and cleanup resources
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.clear();
+    }
+    /**
+     * Create cache key from expression and context
+     */
+    createCacheKey(expression, context) {
+        const contextHash = this.hashContext(context);
+        return `${expression}:${contextHash}`;
+    }
+    /**
+     * Create hash of analysis context for cache key
+     */
+    hashContext(context) {
+        // Create a deterministic hash of the context
+        const contextData = {
+            type: context.type,
+            availableReferences: Object.keys(context.availableReferences || {}).sort(),
+            factoryType: context.factoryType || 'direct'
+        };
+        return this.simpleHash(JSON.stringify(contextData));
+    }
+    /**
+     * Simple hash function for strings
+     */
+    simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return hash.toString(36);
+    }
+    /**
+     * Check if cache entry is expired
+     */
+    isExpired(entry) {
+        return Date.now() - entry.timestamp > this.options.ttlMs;
+    }
+    /**
+     * Estimate memory size of conversion result
+     */
+    estimateSize(result) {
+        // Rough estimation of memory usage
+        let size = 0;
+        if (result.celExpression) {
+            size += result.celExpression.expression.length * 2; // UTF-16
+        }
+        size += result.dependencies.reduce((acc, dep) => acc + (dep.resourceId?.length || 0) * 2 + (dep.fieldPath?.length || 0) * 2 + 50, 0);
+        size += result.sourceMap.length * 100; // Rough estimate for source map entries
+        size += result.errors.length * 200; // Rough estimate for error objects
+        return size;
+    }
+    /**
+     * Estimate memory size of AST
+     */
+    estimateASTSize(ast) {
+        // Very rough estimation - could be improved with recursive traversal
+        return JSON.stringify(ast).length * 2;
+    }
+    /**
+     * Ensure cache has capacity for new entry
+     */
+    ensureCapacity(newEntrySize) {
+        const maxMemoryBytes = this.options.maxMemoryMB * 1024 * 1024;
+        // Check memory limit
+        while (this.stats.totalMemoryUsage + newEntrySize > maxMemoryBytes && this.cache.size > 0) {
+            this.evictLRU();
+        }
+        // Check entry count limit
+        while (this.cache.size >= this.options.maxEntries) {
+            this.evictLRU();
+        }
+    }
+    /**
+     * Evict least recently used entry
+     */
+    evictLRU() {
+        let oldestKey = null;
+        let oldestTime = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.lastAccessed < oldestTime) {
+                oldestTime = entry.lastAccessed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            this.stats.totalEvictions++;
+            this.updateMemoryUsage();
+        }
+    }
+    /**
+     * Update memory usage statistics
+     */
+    updateMemoryUsage() {
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += entry.size;
+        }
+        this.stats.totalMemoryUsage = totalSize;
+        this.stats.maxMemoryUsage = Math.max(this.stats.maxMemoryUsage, totalSize);
+    }
+    /**
+     * Update AST memory usage statistics
+     */
+    updateASTMemoryUsage() {
+        let totalSize = 0;
+        for (const entry of this.astCache.values()) {
+            totalSize += entry.size;
+        }
+        this.stats.astMemoryUsage = totalSize;
+    }
+    /**
+     * Update hit ratio statistics
+     */
+    updateHitRatio() {
+        this.stats.hitRatio = this.stats.totalRequests > 0
+            ? this.stats.cacheHits / this.stats.totalRequests
+            : 0;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalRequests: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            hitRatio: 0,
+            totalMemoryUsage: 0,
+            maxMemoryUsage: 0,
+            entryCount: 0,
+            averageRetrievalTime: 0,
+            totalRetrievalTime: 0,
+            astCacheHits: 0,
+            astCacheMisses: 0,
+            astEntryCount: 0,
+            astMemoryUsage: 0,
+            totalEvictions: 0,
+            lastCleanupTime: Date.now()
+        };
+    }
+    /**
+     * Start automatic cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.options.cleanupIntervalMs);
+    }
+}
+/**
+ * Global cache instance for expression conversion
+ */
+export const globalExpressionCache = new ExpressionCache();
+//# sourceMappingURL=cache.js.map

package/dist/core/expressions/cache.js.map

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

package/dist/core/expressions/cel-conversion-engine.d.ts

@@ -0,0 +1,126 @@
+/**
+ * CEL Conversion Engine for Factory Integration
+ *
+ * This module provides automatic conversion of JavaScript expressions containing
+ * KubernetesRef objects to appropriate CEL expressions for different deployment
+ * strategies.
+ */
+import type { KubernetesRef, CelExpression } from '../types/index.js';
+import { type MagicProxyRefInfo } from './magic-proxy-detector.js';
+import type { FactoryExpressionContext } from './types.js';
+/**
+ * Configuration for CEL conversion
+ */
+export interface CelConversionConfig {
+    /** Factory type for context-aware conversion */
+    factoryType?: 'direct' | 'kro';
+    /** Whether to enable optimization */
+    enableOptimization?: boolean;
+    /** Whether to preserve static values */
+    preserveStatic?: boolean;
+    /** Whether to include debug information */
+    includeDebugInfo?: boolean;
+    /** Maximum depth for recursive conversion */
+    maxDepth?: number;
+}
+/**
+ * Result of CEL conversion
+ */
+export interface CelConversionResult<T = any> {
+    /** Converted value */
+    converted: T;
+    /** Whether conversion was performed */
+    wasConverted: boolean;
+    /** Original value before conversion */
+    original: any;
+    /** Conversion strategy used */
+    strategy: 'direct' | 'cel-expression' | 'template-literal' | 'static';
+    /** Performance metrics */
+    metrics: {
+        conversionTimeMs: number;
+        referencesConverted: number;
+        expressionsGenerated: number;
+    };
+    /** Warnings generated during conversion */
+    warnings: string[];
+    /** Debug information if enabled */
+    debugInfo?: {
+        detectedReferences: MagicProxyRefInfo[];
+        conversionSteps: string[];
+    };
+}
+/**
+ * CEL Conversion Engine
+ *
+ * Automatically converts JavaScript expressions containing KubernetesRef objects
+ * to appropriate CEL expressions based on the factory type and usage context.
+ */
+export declare class CelConversionEngine {
+    private magicProxyDetector;
+    constructor();
+    /**
+     * Convert a value containing KubernetesRef objects to appropriate format
+     *
+     * @param value - Value to convert
+     * @param context - Factory context
+     * @param config - Conversion configuration
+     * @returns Conversion result
+     */
+    convertValue<T>(value: T, context: FactoryExpressionContext, config?: CelConversionConfig): CelConversionResult<T>;
+    /**
+     * Convert a simple KubernetesRef to CEL expression
+     *
+     * @param ref - KubernetesRef to convert
+     * @param context - Factory context
+     * @returns CEL expression
+     */
+    convertKubernetesRefToCel<T>(ref: KubernetesRef<T>, context: FactoryExpressionContext): CelExpression<T>;
+    /**
+     * Check if a value needs CEL conversion
+     *
+     * @param value - Value to check
+     * @param maxDepth - Maximum depth to check
+     * @returns Whether conversion is needed
+     */
+    needsConversion(value: any, maxDepth?: number): boolean;
+    private performConversion;
+    /**
+     * Check if a KubernetesRef comes from an external reference
+     * External references are not registered in the current composition context
+     */
+    private isExternalReference;
+    private generateCelFromRef;
+    private isTemplateLiteralWithRefs;
+    private convertTemplateLiteral;
+    private convertObjectWithRefs;
+}
+/**
+ * Global CEL conversion engine instance
+ */
+export declare const celConversionEngine: CelConversionEngine;
+/**
+ * Utility function to convert a value with KubernetesRef objects
+ *
+ * @param value - Value to convert
+ * @param context - Factory context
+ * @param config - Conversion configuration
+ * @returns Conversion result
+ */
+export declare function convertToCel<T>(value: T, context: FactoryExpressionContext, config?: CelConversionConfig): CelConversionResult<T>;
+/**
+ * Utility function to convert a KubernetesRef to CEL expression
+ *
+ * @param ref - KubernetesRef to convert
+ * @param context - Factory context
+ * @returns CEL expression
+ */
+export declare function kubernetesRefToCel<T>(ref: KubernetesRef<T>, context: FactoryExpressionContext): CelExpression<T>;
+/**
+ * Utility function to check if a value needs CEL conversion
+ *
+ * @param value - Value to check
+ * @param maxDepth - Maximum depth to check
+ * @returns Whether conversion is needed
+ */
+export declare function needsCelConversion(value: any, maxDepth?: number): boolean;
+//# sourceMappingURL=cel-conversion-engine.d.ts.map

package/dist/core/expressions/cel-conversion-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cel-conversion-engine.d.ts","sourceRoot":"","sources":["../../../src/core/expressions/cel-conversion-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC/B,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IAC1C,sBAAsB;IACtB,SAAS,EAAE,CAAC,CAAC;IACb,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,GAAG,CAAC;IACd,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IACtE,0BAA0B;IAC1B,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE;QACV,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;QACxC,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,kBAAkB,CAAqB;;IAM/C;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EACZ,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,wBAAwB,EACjC,MAAM,GAAE,mBAAwB,GAC/B,mBAAmB,CAAC,CAAC,CAAC;IAgEzB;;;;;;OAMG;IACH,yBAAyB,CAAC,CAAC,EACzB,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,wBAAwB,GAChC,aAAa,CAAC,CAAC,CAAC;IAUnB;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,SAAK,GAAG,OAAO;IAInD,OAAO,CAAC,iBAAiB;IA0DzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,qBAAqB;CAkE9B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,wBAAwB,EACjC,MAAM,CAAC,EAAE,mBAAmB,GAC3B,mBAAmB,CAAC,CAAC,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,wBAAwB,GAChC,aAAa,CAAC,CAAC,CAAC,CAElB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzE"}