typekro 0.1.0

package/dist/factories/shared.js

@@ -0,0 +1,364 @@
+/**
+ * Shared utilities for factory functions
+ *
+ * This module contains common utilities and helper functions that are used
+ * across all factory modules for creating Kubernetes resources.
+ */
+import { getComponentLogger } from '../core/logging/index.js';
+import { KUBERNETES_REF_BRAND } from '../core/constants/brands.js';
+import { isCelExpression } from '../utils/type-guards.js';
+import { generateDeterministicResourceId, isKubernetesRef } from '../utils/index.js';
+import { ReadinessEvaluatorRegistry } from '../core/readiness/index.js';
+import { validateResourceId } from '../core/validation/cel-validator.js';
+// Check for the debug environment variable
+const IS_DEBUG_MODE = process.env.TYPEKRO_DEBUG === 'true';
+// Logger for debug mode
+const debugLogger = getComponentLogger('factory-proxy');
+// =============================================================================
+// PROXY ENGINE & BASE FACTORY
+// =============================================================================
+function createRefFactory(resourceId, basePath) {
+    const proxyTarget = () => {
+        // Empty function used as proxy target
+    };
+    Object.defineProperty(proxyTarget, KUBERNETES_REF_BRAND, { value: true });
+    Object.defineProperty(proxyTarget, 'resourceId', { value: resourceId });
+    Object.defineProperty(proxyTarget, 'fieldPath', { value: basePath });
+    // Make the proxy compatible with string, number, and boolean types
+    Object.defineProperty(proxyTarget, 'valueOf', {
+        value: () => basePath, // Return a string representation
+        enumerable: false,
+    });
+    Object.defineProperty(proxyTarget, 'toString', {
+        value: () => basePath, // Return a string representation
+        enumerable: false,
+    });
+    return new Proxy(proxyTarget, {
+        get(target, prop) {
+            if (prop in target)
+                return target[prop];
+            return createRefFactory(resourceId, `${basePath}.${String(prop)}`);
+        },
+    }); // Force TypeScript to see this as compatible with any type
+}
+function createPropertyProxy(resourceId, basePath, target) {
+    if (IS_DEBUG_MODE) {
+        debugLogger.debug('Proxy created', { resourceId, basePath });
+    }
+    return new Proxy(target, {
+        get: (obj, prop) => {
+            // Handle toJSON specially to ensure proper serialization
+            if (prop === 'toJSON') {
+                return () => {
+                    const result = {};
+                    for (const key of Object.keys(obj)) {
+                        result[key] = obj[key];
+                    }
+                    return result;
+                };
+            }
+            // 1. Immediately handle non-string properties.
+            if (typeof prop !== 'string') {
+                return obj[prop];
+            }
+            // 2. Check if the user is explicitly requesting a reference with the '$' prefix.
+            if (prop.startsWith('$')) {
+                const actualProp = prop.substring(1);
+                // Return the KubernetesRef for the underlying property.
+                return createRefFactory(resourceId, `${basePath}.${actualProp}`);
+            }
+            // 3. For any other access, default to the "eager value" or "implicit ref for unknown" logic.
+            if (prop in obj) {
+                // If it's a known property, return its value.
+                return obj[prop];
+            }
+            else {
+                // If it's an unknown property (like from a schema), create the reference implicitly.
+                return createRefFactory(resourceId, `${basePath}.${String(prop)}`);
+            }
+        },
+        set: (obj, prop, value) => {
+            if (IS_DEBUG_MODE) {
+                debugLogger.debug('Proxy property set', { basePath, prop: String(prop), value });
+            }
+            // Transparently accept KubernetesRef and CelExpression objects
+            // The serialization system will handle converting them to CEL expressions
+            return Reflect.set(obj, prop, value);
+        },
+    });
+}
+function createGenericProxyResource(resourceId, resource) {
+    Object.defineProperty(resource, '__resourceId', {
+        value: resourceId,
+        enumerable: false,
+        configurable: true,
+    });
+    // Cache proxies to ensure the same proxy is returned each time
+    let specProxy;
+    let statusProxy;
+    return new Proxy(resource, {
+        /**
+         * Trap for Object.keys, JSON.stringify, etc.
+         * This is crucial for making the proxy serializable. It ensures that
+         * when something tries to get the keys of the proxy, it gets the keys
+         * of the underlying resource object.
+         */
+        ownKeys(target) {
+            return Reflect.ownKeys(target);
+        },
+        get(target, prop, receiver) {
+            // Handle toJSON specially to ensure proper serialization
+            if (prop === 'toJSON') {
+                return () => {
+                    // Create a plain object with all enumerable properties
+                    const result = {};
+                    const targetObj = target;
+                    for (const key of Object.keys(target)) {
+                        if (key !== '__resourceId' &&
+                            key !== 'withReadinessEvaluator' &&
+                            key !== 'readinessEvaluator') {
+                            result[key] = targetObj[key];
+                        }
+                    }
+                    return result;
+                };
+            }
+            if (prop === 'spec') {
+                if (!specProxy) {
+                    const spec = target.spec ?? {};
+                    specProxy = createPropertyProxy(resourceId, 'spec', spec);
+                }
+                return specProxy;
+            }
+            if (prop === 'status') {
+                if (!statusProxy) {
+                    const status = target.status ?? {};
+                    statusProxy = createPropertyProxy(resourceId, 'status', status);
+                }
+                return statusProxy;
+            }
+            if (prop === 'metadata') {
+                // For metadata, we need to ensure it's serializable while still providing proxy functionality
+                const metadata = target.metadata || {};
+                const metadataProxy = createPropertyProxy(resourceId, 'metadata', metadata);
+                // Add enumerable properties to make it JSON serializable
+                // This ensures that JSON.stringify can access the metadata fields
+                if (metadata && typeof metadata === 'object') {
+                    for (const [key, value] of Object.entries(metadata)) {
+                        if (!Object.hasOwn(metadataProxy, key)) {
+                            Object.defineProperty(metadataProxy, key, {
+                                value: value,
+                                enumerable: true,
+                                configurable: true,
+                                writable: true,
+                            });
+                        }
+                    }
+                }
+                return metadataProxy;
+            }
+            if (prop === 'id') {
+                return resourceId; // Return the resource ID directly
+            }
+            // Handle common Kubernetes resource fields as magic proxies
+            if (prop === 'data' && 'data' in target) {
+                const data = target.data ?? {};
+                return createPropertyProxy(resourceId, 'data', data);
+            }
+            if (prop === 'stringData' && 'stringData' in target) {
+                const stringData = target.stringData ?? {};
+                return createPropertyProxy(resourceId, 'stringData', stringData);
+            }
+            if (prop === 'rules' && 'rules' in target) {
+                const rules = target.rules ?? [];
+                return createPropertyProxy(resourceId, 'rules', rules);
+            }
+            if (prop === 'roleRef' && 'roleRef' in target) {
+                const roleRef = target.roleRef ?? {};
+                return createPropertyProxy(resourceId, 'roleRef', roleRef);
+            }
+            if (prop === 'subjects' && 'subjects' in target) {
+                const subjects = target.subjects ?? [];
+                return createPropertyProxy(resourceId, 'subjects', subjects);
+            }
+            if (prop === 'provisioner' && 'provisioner' in target) {
+                const provisioner = target.provisioner;
+                if (provisioner !== undefined) {
+                    return provisioner; // Return the actual string value
+                }
+                return createRefFactory(resourceId, 'provisioner'); // Create reference if not set
+            }
+            if (prop === 'parameters' && 'parameters' in target) {
+                const parameters = target.parameters ?? {};
+                return createPropertyProxy(resourceId, 'parameters', parameters);
+            }
+            if (prop === 'subsets' && 'subsets' in target) {
+                const subsets = target.subsets ?? [];
+                return createPropertyProxy(resourceId, 'subsets', subsets);
+            }
+            if (typeof prop === 'string' && prop.startsWith('$')) {
+                return createRefFactory(resourceId, prop.substring(1));
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+        set(target, prop, value, receiver) {
+            // Transparently accept KubernetesRef and CelExpression objects
+            // The serialization system will handle converting them to CEL expressions
+            return Reflect.set(target, prop, value, receiver);
+        },
+    });
+}
+/**
+ * Default readiness evaluator for resources that don't have custom logic
+ */
+function createDefaultReadinessEvaluator(kind) {
+    return (liveResource) => {
+        try {
+            // For resources that are immediately ready when they exist
+            const immediatelyReadyKinds = [
+                'ConfigMap',
+                'Secret',
+                'Role',
+                'ClusterRole',
+                'RoleBinding',
+                'ClusterRoleBinding',
+                'ServiceAccount',
+                'StorageClass',
+                'NetworkPolicy',
+                'LimitRange',
+                'CSIDriver',
+                'CSINode',
+                'IngressClass',
+                'RuntimeClass',
+                'Lease',
+                'ComponentStatus',
+            ];
+            if (immediatelyReadyKinds.includes(kind)) {
+                return {
+                    ready: true,
+                    message: `${kind} is ready when it exists`,
+                };
+            }
+            // For resources with status conditions, check for common readiness patterns
+            const status = liveResource.status;
+            if (!status) {
+                return {
+                    ready: false,
+                    reason: 'StatusMissing',
+                    message: `${kind} status not available yet`,
+                };
+            }
+            // Check for common readiness conditions
+            if (status.conditions && Array.isArray(status.conditions)) {
+                const readyCondition = status.conditions.find((c) => c.type === 'Ready');
+                if (readyCondition) {
+                    return {
+                        ready: readyCondition.status === 'True',
+                        reason: readyCondition.reason,
+                        message: readyCondition.message || `${kind} readiness: ${readyCondition.status}`,
+                    };
+                }
+                const availableCondition = status.conditions.find((c) => c.type === 'Available');
+                if (availableCondition) {
+                    return {
+                        ready: availableCondition.status === 'True',
+                        reason: availableCondition.reason,
+                        message: availableCondition.message || `${kind} availability: ${availableCondition.status}`,
+                    };
+                }
+            }
+            // For resources with phase, check if it's active/bound/running
+            if (status.phase) {
+                const readyPhases = ['Active', 'Bound', 'Running', 'Succeeded'];
+                const ready = readyPhases.includes(status.phase);
+                return {
+                    ready,
+                    reason: ready ? 'PhaseReady' : 'PhaseNotReady',
+                    message: `${kind} phase: ${status.phase}`,
+                };
+            }
+            // Default: assume ready if status exists
+            return {
+                ready: true,
+                message: `${kind} has status, assuming ready`,
+            };
+        }
+        catch (error) {
+            return {
+                ready: false,
+                reason: 'EvaluationError',
+                message: `Error evaluating ${kind} readiness: ${error}`,
+            };
+        }
+    };
+}
+export function createResource(resource) {
+    let resourceId;
+    // Check for id field on the resource itself
+    if (resource.id) {
+        resourceId = resource.id;
+        // Validate that the ID follows camelCase convention
+        const validation = validateResourceId(resourceId);
+        if (!validation.isValid) {
+            throw new Error(`Invalid resource ID: ${validation.error}`);
+        }
+    }
+    else {
+        // Use deterministic ID generation by default
+        const name = resource.metadata?.name || resource.kind.toLowerCase();
+        const namespace = resource.metadata?.namespace;
+        resourceId = generateDeterministicResourceId(resource.kind, name, namespace);
+    }
+    const enhanced = createGenericProxyResource(resourceId, resource);
+    // Always provide a readiness evaluator for factory-created resources
+    const defaultEvaluator = createDefaultReadinessEvaluator(resource.kind);
+    Object.defineProperty(enhanced, 'readinessEvaluator', {
+        value: defaultEvaluator,
+        enumerable: false, // Prevents serialization - key requirement
+        configurable: true, // Allow withReadinessEvaluator to override
+        writable: false, // Cannot be overwritten directly
+    });
+    // Add fluent builder method for readiness evaluator with serialization protection
+    Object.defineProperty(enhanced, 'withReadinessEvaluator', {
+        value: function (evaluator) {
+            // Register in global registry by KIND when factory defines evaluator
+            ReadinessEvaluatorRegistry.getInstance().registerForKind(this.kind, evaluator, 'factory-defined');
+            // Still attach to individual resource instance (existing behavior)
+            Object.defineProperty(this, 'readinessEvaluator', {
+                value: evaluator,
+                enumerable: false, // Prevents serialization - key requirement
+                configurable: true, // Allow reconfiguration for withReadinessEvaluator
+                writable: false, // Cannot be overwritten directly
+            });
+            return this;
+        },
+        enumerable: false, // Prevents withReadinessEvaluator from being serialized
+        configurable: false, // Cannot be modified
+        writable: false, // Cannot be overwritten
+    });
+    return enhanced;
+}
+export function processPodSpec(podSpec) {
+    if (!podSpec?.containers)
+        return podSpec;
+    podSpec.containers = podSpec.containers.map((container) => {
+        if (!container.env)
+            return container;
+        const processedEnv = container.env.map((envVar) => {
+            if (isKubernetesRef(envVar.value)) {
+                return { name: envVar.name, value: envVar.value };
+            }
+            // Check if it's a CelExpression - preserve it as-is
+            if (isCelExpression(envVar.value)) {
+                return { name: envVar.name, value: envVar.value };
+            }
+            if (envVar.value !== undefined) {
+                return { name: envVar.name, value: String(envVar.value) };
+            }
+            return envVar;
+        });
+        return { ...container, env: processedEnv };
+    });
+    return podSpec;
+}
+//# sourceMappingURL=shared.js.map

package/dist/factories/shared.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * typekro - Define Kro resource graphs with full TypeScript safety.
+ */
+export { Cel, type CelExpression, CircularDependencyError, createSchemaProxy, DependencyGraph, DependencyResolver, DirectDeploymentEngine, type Enhanced, externalRef, generateKroSchema, isCelExpression, isKubernetesRef, isSchemaReference, type KroCompatibleType, type KubernetesRef, type KubernetesResource, createContextLogger, createLogger, getComponentLogger, getDeploymentLogger, getResourceLogger, logger, type LoggerConfig, type LoggerContext, type MagicProxy, type TypeKroLogger, ReferenceResolver, type RefOrValue, type ResourceBuilder, type ResourceGraphDefinition, type SchemaProxy, type StatusBuilder, type MagicAssignableShape, serializeResourceGraphToYaml, simpleConfigMap, simpleDeployment, simpleHpa, simpleIngress, simpleJob, simpleNetworkPolicy, simplePvc, simpleSecret, simpleService, type TypedKroResourceGraphDefinition, type TypedResourceGraphFactory, TypeKroError, toResourceGraph, validateResourceGraph, } from './core.js';
+export { ensureResourceTypeRegistered, DirectTypeKroDeployer, KroTypeKroDeployer, createAlchemyResourceId, } from './alchemy/deployment.js';
+export {} from './alchemy/index.js';
+export * from './factories/index.js';
+export { typeKroRuntimeBootstrap, type TypeKroRuntimeConfig, } from './core/composition/typekro-runtime/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EACL,GAAG,EACH,KAAK,aAAa,EAElB,uBAAuB,EAIvB,iBAAiB,EACjB,eAAe,EAEf,kBAAkB,EAElB,sBAAsB,EAEtB,KAAK,QAAQ,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EAEf,eAAe,EACf,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAEvB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAElB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAEzB,4BAA4B,EAC5B,eAAe,EAEf,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAMnB,OAAO,EAQL,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,MAYT,oBAAoB,CAAC;AAMrB,cAAc,sBAAsB,CAAC;AAMrC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+/**
+ * typekro - Define Kro resource graphs with full TypeScript safety.
+ */
+// =============================================================================
+// CORE FUNCTIONALITY
+// =============================================================================
+// Export all core functionality (excluding createResource to avoid conflicts with factories)
+export { Cel, 
+// Error types
+CircularDependencyError, 
+// Alchemy integration - dynamic registration approach (exported below)
+// Schema proxy functions
+createSchemaProxy, DependencyGraph, 
+// Dependency resolution
+DependencyResolver, 
+// Direct deployment functionality
+DirectDeploymentEngine, externalRef, generateKroSchema, isCelExpression, 
+// Utility functions
+isKubernetesRef, isSchemaReference, 
+// Logging functionality
+createContextLogger, createLogger, getComponentLogger, getDeploymentLogger, getResourceLogger, logger, 
+// Reference resolution and CEL
+ReferenceResolver, 
+// Serialization and YAML generation
+serializeResourceGraphToYaml, simpleConfigMap, 
+// Composition functions
+simpleDeployment, simpleHpa, simpleIngress, simpleJob, simpleNetworkPolicy, simplePvc, simpleSecret, simpleService, TypeKroError, toResourceGraph, validateResourceGraph, } from './core.js';
+// =============================================================================
+// ALCHEMY INTEGRATION
+// =============================================================================
+// Alchemy resource conversion and wrapper utilities
+export { 
+// Resource conversion utilities
+// Alchemy conversion utilities removed - using dynamic registration approach
+// Utility functions (non-conflicting)
+// generateDeterministicResourceId is exported from utils
+// Alchemy dynamic registration exports
+ensureResourceTypeRegistered, DirectTypeKroDeployer, KroTypeKroDeployer, createAlchemyResourceId, } from './alchemy/deployment.js';
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+// Factory functions organized by ecosystem and resource type
+export * from './factories/index.js';
+// =============================================================================
+// BOOTSTRAP COMPOSITIONS
+// =============================================================================
+// Pre-built compositions for infrastructure bootstrap
+export { typeKroRuntimeBootstrap, } from './core/composition/typekro-runtime/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,6FAA6F;AAC7F,OAAO,EACL,GAAG;AAEH,cAAc;AACd,uBAAuB;AACvB,uEAAuE;AAEvE,yBAAyB;AACzB,iBAAiB,EACjB,eAAe;AACf,wBAAwB;AACxB,kBAAkB;AAClB,kCAAkC;AAClC,sBAAsB,EAGtB,WAAW,EACX,iBAAiB,EACjB,eAAe;AACf,oBAAoB;AACpB,eAAe,EACf,iBAAiB;AAIjB,wBAAwB;AACxB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM;AAKN,+BAA+B;AAC/B,iBAAiB;AAOjB,oCAAoC;AACpC,4BAA4B,EAC5B,eAAe;AACf,wBAAwB;AACxB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,aAAa,EAGb,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAChF,oDAAoD;AACpD,OAAO;AACL,gCAAgC;AAChC,6EAA6E;AAE7E,sCAAsC;AACtC,yDAAyD;AAEzD,uCAAuC;AACvC,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAmBjC,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAChF,6DAA6D;AAC7D,cAAc,sBAAsB,CAAC;AAErC,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAChF,sDAAsD;AACtD,OAAO,EACL,uBAAuB,GAExB,MAAM,6CAA6C,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,69 @@
+/**
+ * General utility functions for TypeKro
+ *
+ * This module contains helper functions that are used across the codebase
+ * for common operations like string manipulation, ID generation, and
+ * data processing.
+ */
+import type { Type } from 'arktype';
+import type { CelExpression, KubernetesRef } from '../core/types/common.js';
+import type { KroSimpleSchema, SerializationContext } from '../core/types/serialization.js';
+import type { Enhanced, KubernetesResource } from '../core/types/kubernetes.js';
+/**
+ * Generate deterministic resource ID based on resource metadata
+ * This ensures stable IDs across multiple applications for GitOps workflows
+ */
+export declare function generateDeterministicResourceId(kind: string, name: string | KubernetesRef<unknown> | CelExpression<unknown>, _namespace?: string): string;
+/**
+ * Converts a kebab-case or snake_case string to camelCase
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Generates a unique resource ID (legacy random version for development)
+ */
+export declare function generateResourceId(name?: string): string;
+/**
+ * Converts a string to PascalCase.
+ */
+export declare function pascalCase(str: string): string;
+/**
+ * Generate inner CEL reference without ${} wrapper for building expressions
+ */
+export declare function generateCelReference(ref: KubernetesRef<unknown>): string;
+/**
+ * Gets the inner CEL path for a KubernetesRef, handling special cases like schema refs.
+ * This is the new, authoritative function.
+ */
+export declare function getInnerCelPath(ref: KubernetesRef<unknown>): string;
+/**
+ * Recursively replaces all KubernetesRef objects with CEL expressions for Kro.
+ * This is the ONLY function that should perform this transformation.
+ */
+export declare function processResourceReferences(obj: unknown, context?: SerializationContext): unknown;
+/**
+ * Convert kebab-case or snake_case to camelCase and ensure a readiness evaluator by using the appropriate factory function
+ * This leverages existing factory functions that already have readiness evaluators defined
+ */
+export declare function ensureReadinessEvaluator<T extends Enhanced<any, any>>(resource: T): T;
+/**
+ * Recursively converts an Enhanced resource proxy into a plain JavaScript object.
+ * This is a safe way to serialize the object for the Kubernetes client, preserving
+ * all nested properties and stripping any remaining proxy logic.
+ * @param obj The object to convert.
+ * @param visited A set to track circular references.
+ * @returns A plain JavaScript object.
+ */
+export declare function toPlainObject<T>(obj: T, visited?: Set<any>): T;
+/**
+ * Converts an Arktype schema to a Kro-compatible schema definition
+ *
+ * IMPORTANT: Status fields in Kro now use user-defined mappings from the StatusBuilder function
+ * instead of auto-generated CEL expressions.
+ */
+export declare function arktypeToKroSchema(name: string, schemaDefinition: {
+    apiVersion: string;
+    kind: string;
+    spec: Type;
+    status: Type;
+}, _resources?: Record<string, KubernetesResource>, statusMappings?: any): KroSimpleSchema;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGhF;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9D,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA4CR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C;AAeD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAGxE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CA6C/F;AAiLD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA0BrF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,WAAiB,GAAG,CAAC,CAqCpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,IAAI,CAAC;CACd,EACD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC/C,cAAc,CAAC,EAAE,GAAG,GACnB,eAAe,CAgCjB"}