typekro 0.3.1 → 0.5.0

package/dist/core/expressions/{imperative-analyzer.js → composition/imperative-analyzer.js}

@@ -6,8 +6,9 @@
  */
 import { Parser } from 'acorn';
 import * as estraverse from 'estraverse';
-import { Cel } from '../references/cel.js';
-import { getComponentLogger } from '../logging/index.js';
+import { ensureError } from '../../errors.js';
+import { getComponentLogger } from '../../logging/index.js';
+import { Cel } from '../../references/cel.js';
 const logger = getComponentLogger('imperative-analyzer');
 /**
  * Analyze an imperative composition function to detect JavaScript expressions
@@ -17,20 +18,20 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
     logger.debug('Analyzing imperative composition function', {
         resourceCount: Object.keys(resources).length,
         factoryType: options.factoryType,
-        resourceIds: Object.keys(resources)
+        resourceIds: Object.keys(resources),
     });
     try {
         // Parse the composition function source code
         const functionSource = compositionFn.toString();
         logger.debug('Parsing composition function source', {
             sourceLength: functionSource.length,
-            functionSource: functionSource.substring(0, 500) + (functionSource.length > 500 ? '...' : '')
+            functionSource: functionSource.substring(0, 500) + (functionSource.length > 500 ? '...' : ''),
         });
         const ast = Parser.parse(functionSource, {
             ecmaVersion: 2022,
             sourceType: 'script',
             locations: true,
-            ranges: true
+            ranges: true,
         });
         // Find the return statement in the composition function
         const returnStatement = findReturnStatement(ast);
@@ -39,7 +40,7 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
             return {
                 statusMappings: {},
                 hasJavaScriptExpressions: false,
-                errors: ['No return statement found in composition function']
+                errors: ['No return statement found in composition function'],
             };
         }
         // Check if the return statement returns an object literal
@@ -48,7 +49,7 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
             return {
                 statusMappings: {},
                 hasJavaScriptExpressions: false,
-                errors: ['Return statement must return an object literal']
+                errors: ['Return statement must return an object literal'],
             };
         }
         // Analyze each property in the returned object
@@ -91,18 +92,22 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
                         logger.debug('Analyzing property', {
                             fieldName,
                             fullFieldName,
-                            propertySource: propertySource.substring(0, 100) + (propertySource.length > 100 ? '...' : '')
+                            propertySource: propertySource.substring(0, 100) + (propertySource.length > 100 ? '...' : ''),
                         });
                         // Check if this expression contains resource references
                         if (containsResourceReferences(propertySource)) {
-                            logger.debug('Found resource references in property', { fieldName, fullFieldName, propertySource });
+                            logger.debug('Found resource references in property', {
+                                fieldName,
+                                fullFieldName,
+                                propertySource,
+                            });
                             // Convert resource references to proper format for CEL
                             const convertedSource = convertResourceReferencesToCel(propertySource, resources);
                             logger.debug('Converted resource references', {
                                 fieldName,
                                 fullFieldName,
                                 originalSource: propertySource.substring(0, 100),
-                                convertedSource: convertedSource.substring(0, 100)
+                                convertedSource: convertedSource.substring(0, 100),
                             });
                             // For imperative compositions, create CEL expressions directly from the converted source
                             const celExpression = Cel.expr(convertedSource);
@@ -124,7 +129,7 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
                             logger.debug('Created direct CEL expression for property', {
                                 fieldName,
                                 fullFieldName,
-                                expression: convertedSource
+                                expression: convertedSource,
                             });
                         }
                         else {
@@ -144,13 +149,20 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
                             else {
                                 statusMappings[fieldName] = staticValue;
                             }
-                            logger.debug('Property has no resource references, keeping as static', { fieldName, fullFieldName });
+                            logger.debug('Property has no resource references, keeping as static', {
+                                fieldName,
+                                fullFieldName,
+                            });
                         }
                     }
                     catch (error) {
-                        const errorMessage = `Failed to analyze property '${fullFieldName}': ${error instanceof Error ? error.message : String(error)}`;
+                        const errorMessage = `Failed to analyze property '${fullFieldName}': ${ensureError(error).message}`;
                         errors.push(errorMessage);
-                        logger.debug('Property analysis failed', { fieldName, fullFieldName, error: errorMessage });
+                        logger.debug('Property analysis failed', {
+                            fieldName,
+                            fullFieldName,
+                            error: errorMessage,
+                        });
                         // Fallback to static evaluation
                         try {
                             const staticValue = evaluateStaticExpression(property.value);
@@ -192,21 +204,21 @@ export function analyzeImperativeComposition(compositionFn, resources, options)
         logger.debug('Imperative composition analysis complete', {
             statusFieldCount: Object.keys(statusMappings).length,
             hasJavaScriptExpressions,
-            errorCount: errors.length
+            errorCount: errors.length,
         });
         return {
             statusMappings,
             hasJavaScriptExpressions,
-            errors
+            errors,
         };
     }
     catch (error) {
-        const errorMessage = `Failed to analyze imperative composition: ${error instanceof Error ? error.message : String(error)}`;
-        logger.error('Imperative composition analysis failed', error);
+        const errorMessage = `Failed to analyze imperative composition: ${ensureError(error).message}`;
+        logger.error('Imperative composition analysis failed', ensureError(error));
         return {
             statusMappings: {},
             hasJavaScriptExpressions: false,
-            errors: [errorMessage]
+            errors: [errorMessage],
         };
     }
 }
@@ -223,7 +235,7 @@ function findReturnStatement(ast) {
             }
             // Continue normal traversal
             return undefined;
-        }
+        },
     });
     return returnStatement;
 }
@@ -248,15 +260,19 @@ function getNodeSource(node, fullSource) {
             return `${getNodeSource(node.left, fullSource)} ${node.operator} ${getNodeSource(node.right, fullSource)}`;
         case 'MemberExpression': {
             const object = getNodeSource(node.object, fullSource);
-            const property = node.computed ? `[${getNodeSource(node.property, fullSource)}]` : `.${node.property.name}`;
+            const property = node.computed
+                ? `[${getNodeSource(node.property, fullSource)}]`
+                : `.${node.property.name}`;
             return object + property;
         }
         case 'ObjectExpression': {
-            const properties = node.properties.map((prop) => {
+            const properties = node.properties
+                .map((prop) => {
                 const key = prop.key.name || prop.key.value;
                 const value = getNodeSource(prop.value, fullSource);
                 return `${key}: ${value}`;
-            }).join(', ');
+            })
+                .join(', ');
             return `{ ${properties} }`;
         }
         default:
@@ -279,9 +295,9 @@ function containsResourceReferences(source) {
         /\w+\.metadata\./,
         /\w+\.spec\./,
         /\w+\.data\./,
-        /\bspec\./ // Schema references
+        /\bspec\./, // Schema references
     ];
-    return referencePatterns.some(pattern => pattern.test(source));
+    return referencePatterns.some((pattern) => pattern.test(source));
 }
 /**
  * Convert resource references and schema references in source code to proper CEL format
@@ -306,7 +322,7 @@ function convertResourceReferencesToCel(source, resources) {
 /**
  * Convert a JavaScript template literal to CEL string concatenation
  */
-function convertTemplateLiteralToCel(templateLiteral, resources) {
+function convertTemplateLiteralToCel(templateLiteral, _resources) {
     // Remove the backticks
     let content = templateLiteral.slice(1, -1);
     // First, convert any special KubernetesRef strings in the content
@@ -361,7 +377,15 @@ function convertTemplateLiteralToCel(templateLiteral, resources) {
 function convertExpressionToCel(expression) {
     // Convert schema references: spec.hostname -> schema.spec.hostname
     if (expression.startsWith('spec.')) {
-        return `schema.${expression}`;
+        expression = `schema.${expression}`;
+    }
+    // Convert JavaScript operators to CEL operators
+    expression = expression.replace(/===/g, '=='); // Convert strict equality to CEL equality
+    expression = expression.replace(/!==/g, '!='); // Convert strict inequality to CEL inequality
+    // Wrap expressions containing || or && operators in parentheses to preserve precedence
+    // when they're part of string concatenation in template literals
+    if (expression.includes('||') || expression.includes('&&')) {
+        expression = `(${expression})`;
     }
     // Resource references are already in correct format
     return expression;
@@ -371,7 +395,10 @@ function convertExpressionToCel(expression) {
  */
 function convertTemplateLiteralContent(content) {
     // Replace special KubernetesRef strings with proper CEL expressions
-    return content.replace(/__KUBERNETES_REF_([^_]+)_([^_]+)__/g, (match, resourceId, fieldPath) => {
+    // Pattern handles both regular resource IDs and __schema__ (which has underscores)
+    // Format: __KUBERNETES_REF_{resourceId}_{fieldPath}__
+    // For schema: __KUBERNETES_REF___schema___{fieldPath}__
+    return content.replace(/__KUBERNETES_REF_(__schema__|[^_]+)_(.+?)__/g, (_match, resourceId, fieldPath) => {
         if (resourceId === '__schema__') {
             return `schema.${fieldPath}`;
         }
@@ -386,12 +413,16 @@ function convertTemplateLiteralContent(content) {
 function convertStringWithKubernetesRefs(source) {
     // Remove quotes if present
     let content = source;
-    if ((content.startsWith('"') && content.endsWith('"')) || (content.startsWith("'") && content.endsWith("'"))) {
+    if ((content.startsWith('"') && content.endsWith('"')) ||
+        (content.startsWith("'") && content.endsWith("'"))) {
         content = content.slice(1, -1);
     }
     // Split the string by KubernetesRef placeholders
+    // Pattern handles both regular resource IDs and __schema__ (which has underscores)
+    // Format: __KUBERNETES_REF_{resourceId}_{fieldPath}__
+    // For schema: __KUBERNETES_REF___schema___{fieldPath}__
     const parts = [];
-    const refPattern = /__KUBERNETES_REF_([^_]+)_([^_]+)__/g;
+    const refPattern = /__KUBERNETES_REF_(__schema__|[^_]+)_(.+?)__/g;
     let lastIndex = 0;
     let match = refPattern.exec(content);
     while (match !== null) {
@@ -433,6 +464,13 @@ function evaluateStaticExpression(node) {
         case 'Identifier':
             // For identifiers, we can't evaluate them statically
             return node.name;
+        case 'UnaryExpression':
+            // Bun minifies `true` → `!0` and `false` → `!1` (UnaryExpression with operator '!')
+            // Handle these so boolean literals work correctly regardless of Bun minification.
+            if (node.operator === '!' && node.argument?.type === 'Literal') {
+                return !node.argument.value;
+            }
+            return null;
         case 'BinaryExpression':
             // For binary expressions with literals, we could evaluate them
             // But for safety, just return a placeholder

package/dist/core/expressions/composition/imperative-analyzer.js.map

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

package/dist/core/expressions/composition/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Composition Integration for JavaScript to CEL Expression Conversion
+ *
+ * Re-exports from the decomposed composition integration modules:
+ * - types.ts: Pure type definitions (CompositionAnalysisResult, CompositionPattern, etc.)
+ * - scope-manager.ts: MagicProxyScopeManager and NestedCompositionScope
+ * - context-tracker.ts: CompositionContextTracker
+ * - expression-analyzer.ts: CompositionExpressionAnalyzer
+ * - integration-hooks.ts: CompositionIntegrationHooks and compositionUsesKubernetesRefs
+ */
+export { CompositionContextTracker } from './context-tracker.js';
+export { CompositionExpressionAnalyzer } from './expression-analyzer.js';
+export { CompositionIntegrationHooks, compositionUsesKubernetesRefs } from './integration-hooks.js';
+export type { NestedCompositionScope } from './scope-manager.js';
+export { MagicProxyScopeManager } from './scope-manager.js';
+export type { CompositionAnalysisResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/expressions/composition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/composition/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEpG,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/expressions/composition/index.js

@@ -0,0 +1,18 @@
+/**
+ * Composition Integration for JavaScript to CEL Expression Conversion
+ *
+ * Re-exports from the decomposed composition integration modules:
+ * - types.ts: Pure type definitions (CompositionAnalysisResult, CompositionPattern, etc.)
+ * - scope-manager.ts: MagicProxyScopeManager and NestedCompositionScope
+ * - context-tracker.ts: CompositionContextTracker
+ * - expression-analyzer.ts: CompositionExpressionAnalyzer
+ * - integration-hooks.ts: CompositionIntegrationHooks and compositionUsesKubernetesRefs
+ */
+// Context Tracking
+export { CompositionContextTracker } from './context-tracker.js';
+// Expression Analysis
+export { CompositionExpressionAnalyzer } from './expression-analyzer.js';
+// Integration Hooks
+export { CompositionIntegrationHooks, compositionUsesKubernetesRefs } from './integration-hooks.js';
+export { MagicProxyScopeManager } from './scope-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/core/expressions/composition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/expressions/composition/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mBAAmB;AACnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,sBAAsB;AACtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,oBAAoB;AACpB,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAGpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/expressions/composition/integration-hooks.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Integration Hooks for kubernetesComposition API
+ *
+ * Provides lifecycle hooks for composition execution, integrating expression analysis,
+ * context tracking, scope management, and KubernetesRef validation.
+ */
+import type { CompositionContext } from '../../composition/context.js';
+import type { KroCompatibleType, MagicAssignableShape, SchemaProxy } from '../../types/serialization.js';
+import type { Enhanced } from '../../types.js';
+import { CompositionContextTracker } from './context-tracker.js';
+import { MagicProxyScopeManager } from './scope-manager.js';
+/**
+ * Integration hooks for kubernetesComposition API
+ */
+export declare class CompositionIntegrationHooks {
+    private analyzer;
+    private contextTracker;
+    private scopeManager;
+    private logger;
+    constructor();
+    /**
+     * Hook called before composition execution to set up expression analysis
+     */
+    beforeCompositionExecution<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType>(compositionFn: (spec: TSpec) => MagicAssignableShape<TStatus>, schemaProxy: SchemaProxy<TSpec, TStatus>, contextId: string): void;
+    /**
+     * Hook called after composition execution to process results
+     */
+    afterCompositionExecution<TStatus extends KroCompatibleType>(statusShape: MagicAssignableShape<TStatus>, factoryType?: 'direct' | 'kro', context?: CompositionContext): MagicAssignableShape<TStatus>;
+    /**
+     * Hook called during resource creation to analyze KubernetesRef usage
+     */
+    onResourceCreation(resourceId: string, resource: Enhanced<unknown, unknown>, _context?: CompositionContext): void;
+    /**
+     * Get the current magic proxy scope manager
+     */
+    getScopeManager(): MagicProxyScopeManager;
+    /**
+     * Get the context tracker
+     */
+    getContextTracker(): CompositionContextTracker;
+    /**
+     * Handle auto-registration of resources with KubernetesRef tracking
+     */
+    handleAutoRegistration(resourceId: string, resource: Enhanced<unknown, unknown>, context: CompositionContext): void;
+    /**
+     * Handle side-effect based resource creation with magic proxy integration
+     */
+    handleSideEffectCreation<T extends Enhanced<unknown, unknown>>(resourceFactory: () => T, resourceId?: string, context?: CompositionContext): T;
+    /**
+     * Track magic proxy usage during composition execution
+     */
+    trackMagicProxyUsage(proxyAccess: {
+        resourceId: string;
+        fieldPath: string;
+        accessType: 'read' | 'write';
+        value?: unknown;
+    }): void;
+    /**
+     * Ensure compatibility with existing factory functions
+     */
+    ensureFactoryCompatibility<T extends Enhanced<unknown, unknown>>(factoryFn: () => T, factoryName: string): T;
+    /**
+     * Generate a resource ID from a resource object
+     */
+    private generateResourceIdFromResource;
+}
+/**
+ * Utility function to check if a composition function uses KubernetesRef objects
+ */
+export declare function compositionUsesKubernetesRefs<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType>(compositionFn: (spec: TSpec) => MagicAssignableShape<TStatus>, schemaProxy: SchemaProxy<TSpec, TStatus>): boolean;
+//# sourceMappingURL=integration-hooks.d.ts.map

package/dist/core/expressions/composition/integration-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-hooks.d.ts","sourceRoot":"","sources":["../../../../src/core/expressions/composition/integration-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAMvE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;GAEG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,MAAM,CAAiD;;IAQ/D;;OAEG;IACH,0BAA0B,CAAC,KAAK,SAAS,iBAAiB,EAAE,OAAO,SAAS,iBAAiB,EAC3F,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,oBAAoB,CAAC,OAAO,CAAC,EAC7D,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EACxC,SAAS,EAAE,MAAM,GAChB,IAAI;IAuBP;;OAEG;IACH,yBAAyB,CAAC,OAAO,SAAS,iBAAiB,EACzD,WAAW,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAC1C,WAAW,GAAE,QAAQ,GAAG,KAAa,EACrC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,oBAAoB,CAAC,OAAO,CAAC;IAuBhC;;OAEG;IACH,kBAAkB,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EACpC,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,IAAI;IA4BP;;OAEG;IACH,eAAe,IAAI,sBAAsB;IAIzC;;OAEG;IACH,iBAAiB,IAAI,yBAAyB;IAI9C;;OAEG;IACH,sBAAsB,CACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EACpC,OAAO,EAAE,kBAAkB,GAC1B,IAAI;IA4BP;;OAEG;IACH,wBAAwB,CAAC,CAAC,SAAS,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAC3D,eAAe,EAAE,MAAM,CAAC,EACxB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC;IAqCJ;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,IAAI;IA8BR;;OAEG;IACH,0BAA0B,CAAC,CAAC,SAAS,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAC7D,SAAS,EAAE,MAAM,CAAC,EAClB,WAAW,EAAE,MAAM,GAClB,CAAC;IAmBJ;;OAEG;IACH,OAAO,CAAC,8BAA8B;CAkBvC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,SAAS,iBAAiB,EAC/B,OAAO,SAAS,iBAAiB,EAEjC,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,oBAAoB,CAAC,OAAO,CAAC,EAC7D,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,GACvC,OAAO,CAYT"}

package/dist/core/expressions/composition/integration-hooks.js

@@ -0,0 +1,248 @@
+/**
+ * Integration Hooks for kubernetesComposition API
+ *
+ * Provides lifecycle hooks for composition execution, integrating expression analysis,
+ * context tracking, scope management, and KubernetesRef validation.
+ */
+import { isKubernetesRef } from '../../../utils/type-guards.js';
+import { getCurrentCompositionContext } from '../../composition/context.js';
+import { ensureError } from '../../errors.js';
+import { getComponentLogger } from '../../logging/index.js';
+import { getResourceId } from '../../metadata/index.js';
+import { CompositionContextTracker } from './context-tracker.js';
+import { CompositionExpressionAnalyzer } from './expression-analyzer.js';
+import { MagicProxyScopeManager } from './scope-manager.js';
+/**
+ * Integration hooks for kubernetesComposition API
+ */
+export class CompositionIntegrationHooks {
+    analyzer;
+    contextTracker;
+    scopeManager;
+    logger = getComponentLogger('composition-integration');
+    constructor() {
+        this.analyzer = new CompositionExpressionAnalyzer();
+        this.contextTracker = new CompositionContextTracker();
+        this.scopeManager = new MagicProxyScopeManager();
+    }
+    /**
+     * Hook called before composition execution to set up expression analysis
+     */
+    beforeCompositionExecution(compositionFn, schemaProxy, contextId) {
+        // Enter the composition scope
+        this.scopeManager.enterScope(contextId, schemaProxy);
+        // Pre-analyze the composition for optimization opportunities
+        try {
+            const analysisResult = this.analyzer.analyzeCompositionFunction(compositionFn, schemaProxy);
+            // Store analysis result for later use during serialization
+            if (analysisResult.requiresCelConversion) {
+                this.logger.debug(`Composition requires CEL conversion`, {
+                    contextId,
+                    kubernetesRefsDetected: analysisResult.conversionMetadata.kubernetesRefsDetected,
+                });
+            }
+        }
+        catch (error) {
+            // Non-fatal error - composition can continue without pre-analysis
+            this.logger.warn('Composition pre-analysis failed (non-fatal)', {
+                error: ensureError(error).message,
+            });
+        }
+    }
+    /**
+     * Hook called after composition execution to process results
+     */
+    afterCompositionExecution(statusShape, factoryType = 'kro', context) {
+        try {
+            // Track the composition context if provided
+            if (context) {
+                const trackingResult = this.contextTracker.trackCompositionContext(context);
+                if (trackingResult.crossResourceReferences.length > 0) {
+                    this.logger.debug('Cross-resource references detected', {
+                        count: trackingResult.crossResourceReferences.length,
+                    });
+                }
+            }
+            // Process the status shape
+            const processedStatus = this.analyzer.processCompositionStatus(statusShape, factoryType);
+            return processedStatus;
+        }
+        finally {
+            // Exit the composition scope
+            this.scopeManager.exitScope();
+        }
+    }
+    /**
+     * Hook called during resource creation to analyze KubernetesRef usage
+     */
+    onResourceCreation(resourceId, resource, _context) {
+        // Register the resource in the current scope
+        this.scopeManager.registerResource(resourceId);
+        // Analyze KubernetesRef usage
+        const refs = this.contextTracker.getCachedResourceKubernetesRefs(resourceId) ||
+            this.contextTracker.extractKubernetesRefsFromResource(resource);
+        if (refs.length > 0) {
+            this.logger.debug('Resource contains KubernetesRef objects', {
+                resourceId,
+                refCount: refs.length,
+            });
+            // Validate scope for each KubernetesRef
+            for (const ref of refs) {
+                const validation = this.scopeManager.validateKubernetesRefScope(ref);
+                if (!validation.isValid) {
+                    this.logger.warn('KubernetesRef validation failed', {
+                        resourceId,
+                        error: validation.error,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Get the current magic proxy scope manager
+     */
+    getScopeManager() {
+        return this.scopeManager;
+    }
+    /**
+     * Get the context tracker
+     */
+    getContextTracker() {
+        return this.contextTracker;
+    }
+    /**
+     * Handle auto-registration of resources with KubernetesRef tracking
+     */
+    handleAutoRegistration(resourceId, resource, context) {
+        // Register the resource in the current scope
+        this.scopeManager.registerResource(resourceId);
+        // Track KubernetesRef objects in the auto-registered resource
+        const refs = this.contextTracker.extractKubernetesRefsFromResource(resource);
+        if (refs.length > 0) {
+            // Validate that all referenced resources are accessible
+            for (const ref of refs) {
+                const validation = this.scopeManager.validateKubernetesRefScope(ref);
+                if (!validation.isValid) {
+                    this.logger.warn('Auto-registered resource contains invalid KubernetesRef', {
+                        resourceId,
+                        error: validation.error,
+                    });
+                }
+            }
+            // Cache the KubernetesRef objects for later use
+            this.contextTracker.resourceKubernetesRefCache.set(resourceId, refs);
+        }
+        // Update the composition context
+        context.addResource(resourceId, resource);
+    }
+    /**
+     * Handle side-effect based resource creation with magic proxy integration
+     */
+    handleSideEffectCreation(resourceFactory, resourceId, context) {
+        const activeContext = context || getCurrentCompositionContext();
+        if (!activeContext) {
+            // No active composition context - create resource normally
+            return resourceFactory();
+        }
+        // Track resources before creation
+        const resourcesBefore = new Set(Object.keys(activeContext.resources));
+        // Create the resource
+        const resource = resourceFactory();
+        // Determine the actual resource ID
+        const actualResourceId = resourceId || this.generateResourceIdFromResource(resource);
+        // Check if new resources were created as side effects
+        const resourcesAfter = Object.keys(activeContext.resources);
+        const newResources = resourcesAfter.filter((id) => !resourcesBefore.has(id));
+        // Handle each new resource
+        for (const newResourceId of newResources) {
+            const newResource = activeContext.resources[newResourceId];
+            if (newResource) {
+                this.handleAutoRegistration(newResourceId, newResource, activeContext);
+            }
+        }
+        // Handle the main resource if it wasn't already registered
+        if (!activeContext.resources[actualResourceId]) {
+            this.handleAutoRegistration(actualResourceId, resource, activeContext);
+        }
+        return resource;
+    }
+    /**
+     * Track magic proxy usage during composition execution
+     */
+    trackMagicProxyUsage(proxyAccess) {
+        const currentScope = this.scopeManager.getCurrentScope();
+        if (!currentScope) {
+            return;
+        }
+        // Validate that the accessed resource is in scope
+        if (proxyAccess.resourceId !== '__schema__' &&
+            !this.scopeManager.isResourceAccessible(proxyAccess.resourceId)) {
+            this.logger.warn('Magic proxy access to out-of-scope resource', {
+                resourceId: proxyAccess.resourceId,
+                fieldPath: proxyAccess.fieldPath,
+            });
+        }
+        // Track KubernetesRef creation from magic proxy access
+        if (proxyAccess.accessType === 'read' && isKubernetesRef(proxyAccess.value)) {
+            const validation = this.scopeManager.validateKubernetesRefScope(proxyAccess.value);
+            if (!validation.isValid) {
+                this.logger.warn('Magic proxy created invalid KubernetesRef', { error: validation.error });
+            }
+        }
+    }
+    /**
+     * Ensure compatibility with existing factory functions
+     */
+    ensureFactoryCompatibility(factoryFn, factoryName) {
+        const currentScope = this.scopeManager.getCurrentScope();
+        if (!currentScope) {
+            // No active composition - use factory normally
+            return factoryFn();
+        }
+        try {
+            // Execute factory with side-effect tracking
+            return this.handleSideEffectCreation(factoryFn, undefined, getCurrentCompositionContext());
+        }
+        catch (error) {
+            this.logger.error('Factory function failed in composition context', ensureError(error), {
+                factoryName,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Generate a resource ID from a resource object
+     */
+    generateResourceIdFromResource(resource) {
+        // Try to extract ID from common resource properties
+        const resourceId = getResourceId(resource);
+        if (resourceId) {
+            return resourceId;
+        }
+        if (resource.metadata?.name) {
+            const kind = resource.kind || 'resource';
+            return `${kind.toLowerCase()}-${String(resource.metadata.name)}`;
+        }
+        if (resource.kind) {
+            return `${String(resource.kind).toLowerCase()}-${Date.now()}`;
+        }
+        return `resource-${Date.now()}`;
+    }
+}
+/**
+ * Utility function to check if a composition function uses KubernetesRef objects
+ */
+export function compositionUsesKubernetesRefs(compositionFn, schemaProxy) {
+    const analyzer = new CompositionExpressionAnalyzer();
+    try {
+        const result = analyzer.analyzeCompositionFunction(compositionFn, schemaProxy);
+        return result.requiresCelConversion;
+    }
+    catch (error) {
+        // If analysis fails, assume it might use KubernetesRef objects to be safe
+        const logger = getComponentLogger('composition-integration');
+        logger.debug('Composition analysis failed, assuming KubernetesRef usage', { err: error });
+        return true;
+    }
+}
+//# sourceMappingURL=integration-hooks.js.map