typekro 0.1.0

package/dist/core/references/schema-proxy.js

@@ -0,0 +1,163 @@
+/**
+ * Schema Proxy Factory for Kro Factory Pattern
+ *
+ * This module provides functionality to create schema proxies that return
+ * KubernetesRef objects for field access, specifically marked as schema references.
+ */
+import { KUBERNETES_REF_BRAND } from '../constants/brands.js';
+/**
+ * Creates a KubernetesRef object specifically for schema references
+ * These are distinguished from external references by using a special resource ID prefix
+ */
+function createSchemaRefFactory(fieldPath) {
+    const proxyTarget = () => {
+        // Empty function used as proxy target
+    };
+    Object.defineProperty(proxyTarget, KUBERNETES_REF_BRAND, { value: true, enumerable: false });
+    Object.defineProperty(proxyTarget, 'resourceId', { value: '__schema__', enumerable: false });
+    Object.defineProperty(proxyTarget, 'fieldPath', { value: fieldPath, enumerable: false });
+    return new Proxy(proxyTarget, {
+        get(target, prop) {
+            // Check for our defined properties first
+            if (prop === KUBERNETES_REF_BRAND || prop === 'resourceId' || prop === 'fieldPath') {
+                return target[prop];
+            }
+            // Only preserve essential function properties, not 'name' or other properties
+            // that might conflict with field names
+            if (prop === 'toString' ||
+                prop === 'valueOf' ||
+                prop === 'call' ||
+                prop === 'apply' ||
+                prop === 'bind') {
+                return target[prop];
+            }
+            // Only preserve essential function properties, not 'name' or other properties
+            // that might conflict with field names
+            if (prop === 'call' ||
+                prop === 'apply' ||
+                prop === 'bind') {
+                return target[prop];
+            }
+            // For any other property, create a new nested reference
+            return createSchemaRefFactory(`${fieldPath}.${String(prop)}`);
+        },
+    });
+}
+/**
+ * Creates a MagicProxy for a specific schema section (spec or status)
+ * that returns KubernetesRef objects for any accessed property
+ */
+function createSchemaMagicProxy(basePath) {
+    // Create an empty target object that will serve as the proxy base
+    const target = {};
+    return new Proxy(target, {
+        get: (obj, prop) => {
+            if (typeof prop !== 'string') {
+                return obj[prop];
+            }
+            // Always return a schema reference for any string property access
+            return createSchemaRefFactory(`${basePath}.${prop}`);
+        },
+    });
+}
+/**
+ * Creates a schema proxy that provides type-safe access to spec and status fields
+ *
+ * @returns SchemaProxy with spec and status MagicProxy objects
+ *
+ * @example
+ * ```typescript
+ * interface MySpec { name: string; replicas: number; }
+ * interface MyStatus { ready: boolean; url: string; }
+ *
+ * const schema = createSchemaProxy<MySpec, MyStatus>();
+ *
+ * // These return KubernetesRef objects with schema marking
+ * const nameRef = schema.spec.name; // KubernetesRef with fieldPath: "spec.name"
+ * const readyRef = schema.status.ready; // KubernetesRef with fieldPath: "status.ready"
+ * ```
+ */
+export function createSchemaProxy() {
+    return {
+        spec: createSchemaMagicProxy('spec'),
+        status: createSchemaMagicProxy('status'),
+    };
+}
+/**
+ * Utility function to check if a KubernetesRef is a schema reference
+ *
+ * @param ref - The KubernetesRef to check
+ * @returns true if the reference is a schema reference, false otherwise
+ */
+export function isSchemaReference(ref) {
+    return ref.resourceId === '__schema__';
+}
+/**
+ * Create a magic proxy for resources in StatusBuilder
+ * This allows accessing resource.status.field as KubernetesRef objects while preserving types
+ */
+export function createResourcesProxy(resources) {
+    const proxiedResources = {};
+    for (const [resourceKey, resource] of Object.entries(resources)) {
+        // Create a proxy that preserves the Enhanced resource structure
+        // but converts field access to resource references instead of schema references
+        proxiedResources[resourceKey] = new Proxy(resource, {
+            get(target, prop) {
+                if (prop === 'metadata') {
+                    return resource.metadata;
+                }
+                if (prop === 'kind') {
+                    return resource.kind;
+                }
+                if (prop === 'apiVersion') {
+                    return resource.apiVersion;
+                }
+                if (prop === 'spec' || prop === 'status') {
+                    // Return a proxy that converts the MagicProxy field access to resource references
+                    return createResourceMagicProxy(resourceKey, prop, target[prop]);
+                }
+                // For all other properties, return the original value
+                return target[prop];
+            }
+        });
+    }
+    return proxiedResources;
+}
+/**
+ * Create a magic proxy that converts Enhanced MagicProxy field access to resource references
+ * Uses recursive proxy creation similar to createSchemaRefFactory for deep nesting support
+ */
+function createResourceMagicProxy(resourceId, fieldType, _originalProxy) {
+    return createResourceRefFactory(resourceId, fieldType);
+}
+/**
+ * Creates a KubernetesRef object for resource references with recursive nesting support
+ * Similar to createSchemaRefFactory but for resource references instead of schema references
+ */
+function createResourceRefFactory(resourceId, fieldPath) {
+    const proxyTarget = () => {
+        // Empty function used as proxy target
+    };
+    Object.defineProperty(proxyTarget, KUBERNETES_REF_BRAND, { value: true, enumerable: false });
+    Object.defineProperty(proxyTarget, 'resourceId', { value: resourceId, enumerable: false });
+    Object.defineProperty(proxyTarget, 'fieldPath', { value: fieldPath, enumerable: false });
+    return new Proxy(proxyTarget, {
+        get(target, prop) {
+            // Check for our defined properties first
+            if (prop === KUBERNETES_REF_BRAND || prop === 'resourceId' || prop === 'fieldPath') {
+                return target[prop];
+            }
+            // Preserve essential function properties
+            if (prop === 'toString' ||
+                prop === 'valueOf' ||
+                prop === 'call' ||
+                prop === 'apply' ||
+                prop === 'bind') {
+                return target[prop];
+            }
+            // For any other property, create a new nested reference
+            return createResourceRefFactory(resourceId, `${fieldPath}.${String(prop)}`);
+        },
+    });
+}
+//# sourceMappingURL=schema-proxy.js.map

package/dist/core/references/schema-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-proxy.js","sourceRoot":"","sources":["../../../src/core/references/schema-proxy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;GAGG;AACH,SAAS,sBAAsB,CAAc,SAAiB;IAC5D,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,sCAAsC;IACxC,CAAC,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAEzF,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE;QAC5B,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,yCAAyC;YACzC,IAAI,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBACnF,OAAO,MAAM,CAAC,IAA2B,CAAC,CAAC;YAC7C,CAAC;YAED,8EAA8E;YAC9E,uCAAuC;YACvC,IACE,IAAI,KAAK,UAAU;gBACnB,IAAI,KAAK,SAAS;gBAClB,IAAI,KAAK,MAAM;gBACf,IAAI,KAAK,OAAO;gBAChB,IAAI,KAAK,MAAM,EACf,CAAC;gBACD,OAAO,MAAM,CAAC,IAA2B,CAAC,CAAC;YAC7C,CAAC;YAED,8EAA8E;YAC9E,uCAAuC;YACvC,IACE,IAAI,KAAK,MAAM;gBACf,IAAI,KAAK,OAAO;gBAChB,IAAI,KAAK,MAAM,EACf,CAAC;gBACD,OAAO,MAAM,CAAC,IAA2B,CAAC,CAAC;YAC7C,CAAC;YAED,wDAAwD;YACxD,OAAO,sBAAsB,CAAC,GAAG,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;KACF,CAAiB,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAmB,QAAgB;IAChE,kEAAkE;IAClE,MAAM,MAAM,GAAG,EAAO,CAAC;IAEvB,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACjB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,GAAG,CAAC,IAAe,CAAC,CAAC;YAC9B,CAAC;YAED,kEAAkE;YAClE,OAAO,sBAAsB,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;KACF,CAAwB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB;IAI/B,OAAO;QACL,IAAI,EAAE,sBAAsB,CAAQ,MAAM,CAAC;QAC3C,MAAM,EAAE,sBAAsB,CAAU,QAAQ,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAA2B;IAC3D,OAAO,GAAG,CAAC,UAAU,KAAK,YAAY,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAqB;IAErB,MAAM,gBAAgB,GAAQ,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,gEAAgE;QAChE,gFAAgF;QAChF,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE;YAClD,GAAG,CAAC,MAAM,EAAE,IAAY;gBACtB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;oBACxB,OAAO,QAAQ,CAAC,QAAQ,CAAC;gBAC3B,CAAC;gBACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;oBACpB,OAAO,QAAQ,CAAC,IAAI,CAAC;gBACvB,CAAC;gBACD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC1B,OAAO,QAAQ,CAAC,UAAU,CAAC;gBAC7B,CAAC;gBACD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACzC,kFAAkF;oBAClF,OAAO,wBAAwB,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBACnE,CAAC;gBACD,sDAAsD;gBACtD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,gBAA8B,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,UAAkB,EAAE,SAAiB,EAAE,cAAmB;IAC1F,OAAO,wBAAwB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAc,UAAkB,EAAE,SAAiB;IAClF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,sCAAsC;IACxC,CAAC,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAEzF,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE;QAC5B,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,yCAAyC;YACzC,IAAI,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBACnF,OAAO,MAAM,CAAC,IAA2B,CAAC,CAAC;YAC7C,CAAC;YAED,yCAAyC;YACzC,IACE,IAAI,KAAK,UAAU;gBACnB,IAAI,KAAK,SAAS;gBAClB,IAAI,KAAK,MAAM;gBACf,IAAI,KAAK,OAAO;gBAChB,IAAI,KAAK,MAAM,EACf,CAAC;gBACD,OAAO,MAAM,CAAC,IAA2B,CAAC,CAAC;YAC7C,CAAC;YAED,wDAAwD;YACxD,OAAO,wBAAwB,CAAC,UAAU,EAAE,GAAG,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;KACF,CAAiB,CAAC;AACrB,CAAC"}

package/dist/core/serialization/core.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core serialization functionality for TypeKro
+ *
+ * This module provides the main serialization functions to convert
+ * TypeScript resource definitions to Kro ResourceGraphDefinition YAML manifests.
+ */
+import type { TypedResourceGraph, DeploymentClosure } from '../types/deployment.js';
+import type { MagicAssignableShape, ResourceGraphDefinition, SchemaProxy, SerializationOptions } from '../types/serialization.js';
+import type { Enhanced, KroCompatibleType } from '../types.js';
+/**
+ * Create a new typed resource graph with factory pattern support
+ * This is the new API with definition-first parameter and separate builder functions
+ */
+export declare function toResourceGraph<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType, TResources extends Record<string, Enhanced<any, any> | DeploymentClosure>>(definition: ResourceGraphDefinition<TSpec, TStatus>, resourceBuilder: (schema: SchemaProxy<TSpec, TStatus>) => TResources, statusBuilder: (schema: SchemaProxy<TSpec, TStatus>, resources: TResources) => MagicAssignableShape<TStatus>, options?: SerializationOptions): TypedResourceGraph<TSpec, TStatus>;
+//# sourceMappingURL=core.d.ts.map

package/dist/core/serialization/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAKV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EAEvB,WAAW,EACX,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAEV,QAAQ,EACR,iBAAiB,EAElB,MAAM,aAAa,CAAC;AA+DrB;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,SAAS,iBAAiB,EAC/B,OAAO,SAAS,iBAAiB,EAEjC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,EAEzE,UAAU,EAAE,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,EAEnD,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,UAAU,EAEpE,aAAa,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,UAAU,KAAK,oBAAoB,CAAC,OAAO,CAAC,EAC5G,OAAO,CAAC,EAAE,oBAAoB,GAC7B,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAGpC"}

package/dist/core/serialization/core.js

@@ -0,0 +1,169 @@
+/**
+ * Core serialization functionality for TypeKro
+ *
+ * This module provides the main serialization functions to convert
+ * TypeScript resource definitions to Kro ResourceGraphDefinition YAML manifests.
+ */
+import { DependencyResolver } from '../dependencies/index.js';
+import { createDirectResourceFactory } from '../deployment/direct-factory.js';
+import { createKroResourceFactory } from '../deployment/kro-factory.js';
+import { getComponentLogger } from '../logging/index.js';
+import { createSchemaProxy } from '../references/index.js';
+import { generateKroSchemaFromArktype } from './schema.js';
+import { serializeResourceGraphToYaml } from './yaml.js';
+import { validateResourceGraphDefinition } from '../validation/cel-validator.js';
+import { optimizeStatusMappings } from '../evaluation/cel-optimizer.js';
+/**
+ * Separate Enhanced<> resources from deployment closures in the builder result
+ */
+function separateResourcesAndClosures(builderResult) {
+    const resources = {};
+    const closures = {};
+    for (const [key, value] of Object.entries(builderResult)) {
+        if (typeof value === 'function') {
+            // This is a deployment closure
+            closures[key] = value;
+        }
+        else if (value && typeof value === 'object' && 'kind' in value && 'apiVersion' in value) {
+            // This is an Enhanced<> resource
+            resources[key] = value;
+        }
+        else {
+            // Unknown type, treat as resource for backward compatibility
+            resources[key] = value;
+        }
+    }
+    return { resources, closures };
+}
+/**
+ * Create a ResourceGraph from resources for deployment
+ */
+function _createResourceGraph(name, resources) {
+    const dependencyResolver = new DependencyResolver();
+    const resourceArray = Object.values(resources).map(resource => ({
+        ...resource,
+        id: resource.id || resource.metadata?.name || 'unknown',
+    }));
+    // Type assertion needed because we're converting KubernetesResource to DeployableK8sResource
+    // This is safe because the deployment engine handles the conversion internally
+    const deployableResources = resourceArray;
+    const dependencyGraph = dependencyResolver.buildDependencyGraph(deployableResources);
+    // Convert to ResourceGraphResource format
+    const resourceGraphResources = deployableResources.map(resource => ({
+        id: resource.id,
+        manifest: resource,
+    }));
+    return {
+        name,
+        resources: resourceGraphResources,
+        dependencyGraph,
+    };
+}
+// =============================================================================
+// NEW FACTORY PATTERN API
+// =============================================================================
+/**
+ * Create a new typed resource graph with factory pattern support
+ * This is the new API with definition-first parameter and separate builder functions
+ */
+export function toResourceGraph(definition, 
+// The resourceBuilder is now defined as returning that specific shape
+resourceBuilder, 
+// The statusBuilder is now defined as ACCEPTING that specific shape
+statusBuilder, options) {
+    // The implementation in createTypedResourceGraph must also be updated to match this signature.
+    return createTypedResourceGraph(definition, resourceBuilder, statusBuilder, options);
+}
+/**
+ * Create a typed resource graph implementation
+ */
+function createTypedResourceGraph(definition, resourceBuilder, statusBuilder, options) {
+    const serializationLogger = getComponentLogger('resource-graph-serialization').child({
+        name: definition.name
+    });
+    // Validate resource graph name early
+    if (!definition.name || typeof definition.name !== 'string') {
+        throw new Error(`Invalid resource graph name: ${JSON.stringify(definition.name)}. Resource graph name must be a non-empty string.`);
+    }
+    const trimmedName = definition.name.trim();
+    if (trimmedName.length === 0) {
+        throw new Error(`Invalid resource graph name: Resource graph name cannot be empty or whitespace-only.`);
+    }
+    // Validate that the name will convert to a valid Kubernetes resource name
+    const kubernetesName = trimmedName
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase();
+    if (!/^[a-z0-9]([-a-z0-9]*[a-z0-9])?$/.test(kubernetesName)) {
+        throw new Error(`Invalid resource graph name: "${definition.name}" converts to "${kubernetesName}" which is not a valid Kubernetes resource name. Names must consist of lowercase alphanumeric characters or '-', and must start and end with an alphanumeric character.`);
+    }
+    if (kubernetesName.length > 253) {
+        throw new Error(`Invalid resource graph name: "${definition.name}" converts to "${kubernetesName}" which exceeds the 253 character limit for Kubernetes resource names.`);
+    }
+    // Apply default apiVersion if not specified
+    // Note: This should be just the version part (e.g., 'v1alpha1'), not the full API version
+    // The full API version (kro.run/v1alpha1) is constructed when creating instances
+    const schemaDefinition = {
+        apiVersion: definition.apiVersion || 'v1alpha1',
+        kind: definition.kind,
+        spec: definition.spec,
+        status: definition.status,
+    };
+    const schema = createSchemaProxy();
+    const builderResult = resourceBuilder(schema);
+    // Separate Enhanced<> resources from deployment closures
+    const { resources: resourcesWithKeys, closures } = separateResourcesAndClosures(builderResult);
+    // Pass Enhanced resources directly to StatusBuilder - they already have proper MagicProxy types
+    const statusMappings = statusBuilder(schema, resourcesWithKeys);
+    // Validate resource IDs and CEL expressions
+    const validation = validateResourceGraphDefinition(resourcesWithKeys, statusMappings);
+    if (!validation.isValid) {
+        const errorMessages = validation.errors.map(err => `${err.field}: ${err.error}`).join('\n');
+        throw new Error(`ResourceGraphDefinition validation failed:\n${errorMessages}`);
+    }
+    // Log warnings if any
+    if (validation.warnings.length > 0) {
+        serializationLogger.warn('ResourceGraphDefinition validation warnings', {
+            warnings: validation.warnings.map(w => ({
+                field: w.field,
+                error: w.error,
+                suggestion: w.suggestion
+            }))
+        });
+    }
+    // Evaluate and optimize CEL expressions
+    const evaluationContext = { resources: resourcesWithKeys, schema };
+    const { mappings: optimizedStatusMappings, optimizations } = optimizeStatusMappings(statusMappings, evaluationContext);
+    // Log optimizations if any
+    if (optimizations.length > 0) {
+        serializationLogger.info('CEL expression optimizations applied', { optimizations });
+    }
+    // schemaDefinition is already created above with default apiVersion handling
+    return {
+        name: definition.name,
+        resources: Object.values(resourcesWithKeys),
+        schema,
+        // Store closures for access during factory creation
+        closures,
+        async factory(mode, factoryOptions) {
+            if (mode === 'direct') {
+                const directFactory = createDirectResourceFactory(definition.name, resourcesWithKeys, schemaDefinition, { ...factoryOptions, closures } // Pass closures to factory
+                );
+                return directFactory;
+            }
+            else if (mode === 'kro') {
+                const kroFactory = createKroResourceFactory(definition.name, resourcesWithKeys, schemaDefinition, statusMappings, { ...factoryOptions, closures } // Pass closures to Kro factory for validation and execution
+                );
+                return kroFactory;
+            }
+            else {
+                throw new Error(`Unsupported factory mode: ${mode}`);
+            }
+        },
+        toYaml() {
+            // Generate ResourceGraphDefinition YAML with user-defined status mappings
+            const kroSchema = generateKroSchemaFromArktype(definition.name, schemaDefinition, resourcesWithKeys, optimizedStatusMappings);
+            return serializeResourceGraphToYaml(definition.name, resourcesWithKeys, options, kroSchema);
+        },
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/core/serialization/core.js.map

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

package/dist/core/serialization/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Serialization module exports
+ */
+export type { ResourceBuilder, ResourceDependency, SchemaDefinition, SerializationContext, SerializationOptions, ValidationResult, } from '../types/serialization.js';
+export { toResourceGraph } from './core.js';
+export { generateKroSchema, generateKroSchemaFromArktype } from './schema.js';
+export { getDependencyOrder, validateResourceGraph, visualizeDependencies, } from './validation.js';
+export { serializeResourceGraphToYaml } from './yaml.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/serialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/serialization/index.js

@@ -0,0 +1,12 @@
+/**
+ * Serialization module exports
+ */
+// Core serialization functions
+export { toResourceGraph } from './core.js';
+// Schema generation
+export { generateKroSchema, generateKroSchemaFromArktype } from './schema.js';
+// Validation and dependency analysis
+export { getDependencyOrder, validateResourceGraph, visualizeDependencies, } from './validation.js';
+// YAML generation
+export { serializeResourceGraphToYaml } from './yaml.js';
+//# sourceMappingURL=index.js.map

package/dist/core/serialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/serialization/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAE9E,qCAAqC;AACrC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,kBAAkB;AAClB,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/serialization/schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Schema generation functionality for Kro ResourceGraphDefinitions
+ */
+import type { SchemaDefinition } from '../types/serialization.js';
+import type { KroCompatibleType, KroSimpleSchema, KubernetesResource } from '../types.js';
+/**
+ * Generate Kro schema from resources
+ */
+export declare function generateKroSchema(name: string, _resources: Record<string, KubernetesResource>): KroSimpleSchema;
+/**
+ * Generate Kro schema from Arktype definition
+ */
+export declare function generateKroSchemaFromArktype<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType>(name: string, schemaDefinition: SchemaDefinition<TSpec, TStatus>, resources?: Record<string, KubernetesResource>, statusMappings?: any): KroSimpleSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/serialization/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE1F;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC7C,eAAe,CAoBjB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,SAAS,iBAAiB,EAC/B,OAAO,SAAS,iBAAiB,EAEjC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAClD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC9C,cAAc,CAAC,EAAE,GAAG,GACnB,eAAe,CAEjB"}

package/dist/core/serialization/schema.js

@@ -0,0 +1,33 @@
+/**
+ * Schema generation functionality for Kro ResourceGraphDefinitions
+ */
+import { arktypeToKroSchema, pascalCase } from '../../utils/index.js';
+/**
+ * Generate Kro schema from resources
+ */
+export function generateKroSchema(name, _resources) {
+    const pascalName = pascalCase(name);
+    // Generate spec fields based on resource names
+    // For now, we'll create a simple schema that doesn't require input parameters
+    // since our resources are fully defined in the ResourceGraphDefinition
+    const spec = {
+        // Add a simple name field that can be used for identification
+        name: `string | default="${name}"`,
+    };
+    return {
+        apiVersion: `v1alpha1`,
+        kind: pascalName,
+        spec,
+        status: {
+        // Empty status - Kro will automatically inject default fields
+        // (phase, message, observedGeneration, conditions, state)
+        },
+    };
+}
+/**
+ * Generate Kro schema from Arktype definition
+ */
+export function generateKroSchemaFromArktype(name, schemaDefinition, resources, statusMappings) {
+    return arktypeToKroSchema(name, schemaDefinition, resources, statusMappings);
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/serialization/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/core/serialization/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAItE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,UAA8C;IAE9C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAEpC,+CAA+C;IAC/C,8EAA8E;IAC9E,uEAAuE;IACvE,MAAM,IAAI,GAA2B;QACnC,8DAA8D;QAC9D,IAAI,EAAE,qBAAqB,IAAI,GAAG;KACnC,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,IAAI,EAAE,UAAU;QAChB,IAAI;QACJ,MAAM,EAAE;QACN,8DAA8D;QAC9D,0DAA0D;SAC3D;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAI1C,IAAY,EACZ,gBAAkD,EAClD,SAA8C,EAC9C,cAAoB;IAEpB,OAAO,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AAC/E,CAAC"}

package/dist/core/serialization/validation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Resource graph validation and dependency analysis
+ */
+import type { ValidationResult } from '../types/serialization.js';
+import type { KubernetesResource } from '../types.js';
+/**
+ * Validate resource graph for cycles and missing dependencies
+ */
+export declare function validateResourceGraph(resources: Record<string, KubernetesResource>): ValidationResult;
+/**
+ * Get dependency order for resources (topological sort)
+ */
+export declare function getDependencyOrder(resources: Record<string, KubernetesResource>): string[];
+/**
+ * Debug utility to visualize resource dependencies
+ */
+export declare function visualizeDependencies(resources: Record<string, KubernetesResource>): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/serialization/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC5C,gBAAgB,CA8ElB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,EAAE,CA8E1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CA2B3F"}

package/dist/core/serialization/validation.js

@@ -0,0 +1,165 @@
+/**
+ * Resource graph validation and dependency analysis
+ */
+import { extractResourceReferences, generateDeterministicResourceId } from '../../utils/index.js';
+import { formatReferenceError } from '../errors.js';
+/**
+ * Validate resource graph for cycles and missing dependencies
+ */
+export function validateResourceGraph(resources) {
+    const errors = [];
+    // Extract all references and check for missing targets
+    const resourceIds = new Set();
+    const allReferences = [];
+    for (const [resourceName, resource] of Object.entries(resources)) {
+        // Use the embedded resource ID if available, otherwise generate deterministic one
+        const resourceId = resource.__resourceId ||
+            generateDeterministicResourceId(resource.kind, resource.metadata?.name || resourceName, resource.metadata?.namespace);
+        resourceIds.add(resourceId);
+        const refs = extractResourceReferences(resource);
+        for (const ref of refs) {
+            allReferences.push({
+                from: resourceId,
+                to: ref.resourceId,
+                field: ref.fieldPath,
+            });
+        }
+    }
+    // Check for missing dependencies with enhanced error messages
+    for (const ref of allReferences) {
+        if (!resourceIds.has(ref.to)) {
+            const availableResources = Array.from(resourceIds);
+            const referenceError = formatReferenceError(ref.from, ref.to, ref.field, availableResources);
+            errors.push(referenceError.message);
+            if (referenceError.suggestions) {
+                errors.push(...referenceError.suggestions.map((s) => `  Suggestion: ${s}`));
+            }
+        }
+    }
+    // Check for cycles using DFS
+    const visited = new Set();
+    const recursionStack = new Set();
+    function hasCycle(nodeId) {
+        if (recursionStack.has(nodeId)) {
+            return true;
+        }
+        if (visited.has(nodeId)) {
+            return false;
+        }
+        visited.add(nodeId);
+        recursionStack.add(nodeId);
+        // Find all dependencies of this node
+        const dependencies = allReferences.filter((ref) => ref.from === nodeId);
+        for (const dep of dependencies) {
+            if (hasCycle(dep.to)) {
+                return true;
+            }
+        }
+        recursionStack.delete(nodeId);
+        return false;
+    }
+    for (const resourceId of resourceIds) {
+        if (!visited.has(resourceId) && hasCycle(resourceId)) {
+            errors.push(`Circular dependency detected involving resource '${resourceId}'`);
+            break;
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Get dependency order for resources (topological sort)
+ */
+export function getDependencyOrder(resources) {
+    const resourceIds = new Map();
+    const dependencies = [];
+    // Build dependency graph
+    for (const [resourceName, resource] of Object.entries(resources)) {
+        // Use the embedded resource ID if available, otherwise generate deterministic one
+        const resourceId = resource.__resourceId ||
+            generateDeterministicResourceId(resource.kind, resource.metadata?.name || resourceName, resource.metadata?.namespace);
+        resourceIds.set(resourceName, resourceId);
+        const refs = extractResourceReferences(resource);
+        for (const ref of refs) {
+            dependencies.push({
+                from: resourceId,
+                to: ref.resourceId,
+            });
+        }
+    }
+    // Topological sort using Kahn's algorithm
+    const inDegree = new Map();
+    const adjList = new Map();
+    // Initialize
+    for (const [resourceName] of Object.entries(resources)) {
+        const resourceId = resourceIds.get(resourceName);
+        if (resourceId) {
+            inDegree.set(resourceId, 0);
+            adjList.set(resourceId, []);
+        }
+    }
+    // Build adjacency list and calculate in-degrees
+    for (const dep of dependencies) {
+        adjList.get(dep.from)?.push(dep.to);
+        inDegree.set(dep.to, (inDegree.get(dep.to) || 0) + 1);
+    }
+    // Process nodes with no incoming edges
+    const queue = [];
+    const result = [];
+    for (const [resourceId, degree] of inDegree.entries()) {
+        if (degree === 0) {
+            queue.push(resourceId);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (current) {
+            result.push(current);
+            const neighbors = adjList.get(current) || [];
+            for (const neighbor of neighbors) {
+                const newDegree = (inDegree.get(neighbor) || 0) - 1;
+                inDegree.set(neighbor, newDegree);
+                if (newDegree === 0) {
+                    queue.push(neighbor);
+                }
+            }
+        }
+    }
+    // Convert back to resource names
+    const idToName = new Map();
+    for (const [name, id] of resourceIds.entries()) {
+        idToName.set(id, name);
+    }
+    return result.map((id) => idToName.get(id)).filter((name) => name !== undefined);
+}
+/**
+ * Debug utility to visualize resource dependencies
+ */
+export function visualizeDependencies(resources) {
+    const lines = [];
+    lines.push('Resource Dependency Graph:');
+    lines.push('========================');
+    for (const [resourceName, resource] of Object.entries(resources)) {
+        const refs = extractResourceReferences(resource);
+        if (refs.length === 0) {
+            lines.push(`${resourceName} (no dependencies)`);
+        }
+        else {
+            lines.push(`${resourceName} depends on:`);
+            for (const ref of refs) {
+                lines.push(`  - ${ref.resourceId}.${ref.fieldPath}`);
+            }
+        }
+        lines.push('');
+    }
+    const order = getDependencyOrder(resources);
+    lines.push('Deployment Order:');
+    lines.push('-----------------');
+    order.forEach((name, index) => {
+        lines.push(`${index + 1}. ${name}`);
+    });
+    return lines.join('\n');
+}
+//# sourceMappingURL=validation.js.map