typekro 0.1.0

package/dist/core/references/external-refs.js

@@ -0,0 +1,53 @@
+/**
+ * External reference support for Kro Factory Pattern
+ *
+ * This module provides functionality to create external references to CRD instances
+ * for composition between ResourceGraphDefinitions.
+ */
+import { createResource } from '../../factories/shared.js';
+/**
+ * Create external reference to CRD instance for composition between ResourceGraphDefinitions
+ *
+ * @param apiVersion - API version of the external CRD
+ * @param kind - Kind of the external CRD
+ * @param instanceName - Name of the CRD instance to reference
+ * @param namespace - Optional namespace of the CRD instance
+ * @returns Enhanced proxy that can be used in resource templates
+ *
+ * @example
+ * ```typescript
+ * // Reference an external database instance
+ * const database = externalRef<DatabaseSpec, DatabaseStatus>(
+ *   'v1alpha1',
+ *   'Database',
+ *   'production-db'
+ * );
+ *
+ * // Use in resource template
+ * const webapp = simpleDeployment({
+ *   name: 'webapp',
+ *   image: 'nginx',
+ *   env: {
+ *     DATABASE_URL: database.status.connectionString
+ *   }
+ * });
+ * ```
+ */
+export function externalRef(apiVersion, kind, instanceName, namespace) {
+    // Create a KubernetesResource marked as external reference
+    const resource = {
+        apiVersion,
+        kind,
+        metadata: {
+            name: instanceName,
+            ...(namespace && { namespace }),
+        },
+        spec: {},
+        status: {},
+        // Mark this as an external reference for serialization
+        __externalRef: true,
+    };
+    // Use existing createResource function to get Enhanced proxy
+    return createResource(resource);
+}
+//# sourceMappingURL=external-refs.js.map

package/dist/core/references/external-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-refs.js","sourceRoot":"","sources":["../../../src/core/references/external-refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,WAAW,CACzB,UAAkB,EAClB,IAAY,EACZ,YAAoB,EACpB,SAAkB;IAElB,2DAA2D;IAC3D,MAAM,QAAQ,GAAuC;QACnD,UAAU;QACV,IAAI;QACJ,QAAQ,EAAE;YACR,IAAI,EAAE,YAAY;YAClB,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;SAChC;QACD,IAAI,EAAE,EAAW;QACjB,MAAM,EAAE,EAAa;QACrB,uDAAuD;QACvD,aAAa,EAAE,IAAI;KACpB,CAAC;IAEF,6DAA6D;IAC7D,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * References module exports
+ */
+export type { ResolutionContext } from '../types/deployment.js';
+export type { CelEvaluationContext } from '../types/references.js';
+export { CelEvaluationError } from '../types/references.js';
+export * from './cel.js';
+export { CelEvaluator } from './cel-evaluator.js';
+export { optimizeCelExpression, optimizeStatusMappings } from '../evaluation/cel-optimizer.js';
+export { externalRef } from './external-refs.js';
+export { ReferenceResolver, DeploymentMode } from './resolver.js';
+export type { DeploymentMode as DeploymentModeType } from './resolver.js';
+export { createAlchemyReferenceResolver, isAlchemyPromise, hasMixedDependencies, resolveReferencesWithAlchemy, buildResourceGraphWithDeferredResolution, resolveAllReferencesInAlchemyContext, containsAlchemyPromises, extractAlchemyPromises } from '../../alchemy/resolver.js';
+export { createSchemaProxy, createResourcesProxy, isSchemaReference } from './schema-proxy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/references/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,wCAAwC,EAAE,oCAAoC,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAElR,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/references/index.js

@@ -0,0 +1,19 @@
+/**
+ * References module exports
+ */
+export { CelEvaluationError } from '../types/references.js';
+// CEL utilities
+export * from './cel.js';
+// CEL evaluation
+export { CelEvaluator } from './cel-evaluator.js';
+// Compile-time CEL optimization
+export { optimizeCelExpression, optimizeStatusMappings } from '../evaluation/cel-optimizer.js';
+// External references
+export { externalRef } from './external-refs.js';
+// Reference resolution
+export { ReferenceResolver, DeploymentMode } from './resolver.js';
+// Alchemy-aware reference resolution
+export { createAlchemyReferenceResolver, isAlchemyPromise, hasMixedDependencies, resolveReferencesWithAlchemy, buildResourceGraphWithDeferredResolution, resolveAllReferencesInAlchemyContext, containsAlchemyPromises, extractAlchemyPromises } from '../../alchemy/resolver.js';
+// Schema proxy
+export { createSchemaProxy, createResourcesProxy, isSchemaReference } from './schema-proxy.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/references/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,gBAAgB;AAChB,cAAc,UAAU,CAAC;AACzB,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,gCAAgC;AAChC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElE,qCAAqC;AACrC,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,wCAAwC,EAAE,oCAAoC,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAClR,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/references/resolver.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Reference Resolution System
+ *
+ * Resolves KubernetesRef and CelExpression objects by querying the Kubernetes API
+ * and evaluating expressions against the current resource state.
+ */
+import * as k8s from '@kubernetes/client-node';
+import type { ResolutionContext } from '../types/deployment.js';
+import type { CelExpression, KubernetesRef } from '../types.js';
+/**
+ * Cache statistics interface
+ */
+interface CacheStatistics {
+    readonly size: number;
+    readonly keys: readonly string[];
+}
+export declare const DeploymentMode: {
+    readonly KRO: "kro";
+    readonly DIRECT: "direct";
+};
+export type DeploymentMode = typeof DeploymentMode[keyof typeof DeploymentMode];
+export declare class ReferenceResolver {
+    private cache;
+    private celEvaluator;
+    private logger;
+    private kubeClient;
+    private k8sApi;
+    private deploymentMode;
+    constructor(kubeClient: k8s.KubeConfig, deploymentMode?: DeploymentMode, k8sApi?: k8s.KubernetesObjectApi);
+    /**
+     * Resolve all references in a resource
+     */
+    resolveReferences(resource: any, context: ResolutionContext): Promise<any>;
+    /**
+     * Quick check if a resource has any references
+     */
+    private hasReferences;
+    /**
+     * Restore Symbol brands that were lost during JSON serialization
+     */
+    private restoreBrands;
+    /**
+     * Recursively traverse and resolve references
+     */
+    private traverseAndResolve;
+    /**
+     * Resolve a KubernetesRef to its actual value or CEL string based on deployment mode
+     */
+    private resolveKubernetesRef;
+    /**
+     * Convert a KubernetesRef to a CEL string for Kro controller evaluation
+     */
+    private convertKubernetesRefToString;
+    /**
+     * Convert a CEL expression to a CEL string for Kro controller evaluation
+     */
+    private convertCelExpressionToString;
+    /**
+     * Evaluate a CEL expression using runtime CEL evaluation
+     *
+     * This method performs ACTUAL CEL expression evaluation using the cel-js library.
+     * It's only used in Direct mode deployment where TypeKro must resolve CEL expressions
+     * to concrete values before creating Kubernetes manifests.
+     *
+     * In Kro mode, CEL expressions are converted to strings and evaluated by the Kro operator.
+     */
+    private evaluateCelExpression;
+    /**
+     * Find a deployed resource by ID
+     */
+    private findDeployedResource;
+    /**
+     * Query a resource from the Kubernetes cluster
+     */
+    private queryResourceFromCluster;
+    /**
+     * Parse a resource ID to extract Kubernetes resource information
+     * Supports formats like:
+     * - "my-deployment" (assumes Deployment in apps/v1)
+     * - "my-service" (assumes Service in v1)
+     * - "my-configmap" (assumes ConfigMap in v1)
+     * - Custom format: "kind:apiVersion:name" or "kind:name"
+     */
+    private parseResourceId;
+    /**
+     * Infer Kubernetes resource type from resource name patterns
+     */
+    private inferResourceTypeFromName;
+    /**
+     * Get default API version for a given Kubernetes kind
+     */
+    private getDefaultApiVersion;
+    /**
+     * Extract a field value from an object using dot notation
+     */
+    private extractFieldValue;
+    /**
+     * Wait for a resource to be ready
+     */
+    waitForResourceReady<T = unknown>(resourceRef: KubernetesRef<T>, timeout?: number): Promise<boolean>;
+    /**
+     * Clear the resolution cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): CacheStatistics;
+}
+export declare class ReferenceResolutionError extends Error {
+    constructor(ref: KubernetesRef, cause: Error);
+}
+export declare class CelExpressionError extends Error {
+    constructor(expr: CelExpression, cause: Error);
+}
+export {};
+//# sourceMappingURL=resolver.d.ts.map

package/dist/core/references/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/core/references/resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EAGd,MAAM,aAAa,CAAC;AAiCrB;;GAEG;AACH,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,cAAc,CAAiB;gBAGrC,UAAU,EAAE,GAAG,CAAC,UAAU,EAC1B,cAAc,GAAE,cAAsC,EACtD,MAAM,CAAC,EAAE,GAAG,CAAC,mBAAmB;IAQlC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC;IA6BhF;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsCrB;;OAEG;YACW,kBAAkB;IAmDhC;;OAEG;YACW,oBAAoB;IAmClC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAepC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAcpC;;;;;;;;OAQG;YACW,qBAAqB;IAoCnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;YACW,wBAAwB;IAwEtC;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA+BjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyCzB;;OAEG;IACG,oBAAoB,CAAC,CAAC,GAAG,OAAO,EACpC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,EAC7B,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,OAAO,CAAC;IA0EnB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI,eAAe;CAMjC;AAGD,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK;CAK7C;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK;CAK9C"}