typekro 0.3.1 → 0.5.0

package/dist/compositions/typekro-runtime/typekro-runtime.js.map

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

package/dist/compositions/typekro-runtime/types.d.ts

@@ -0,0 +1,45 @@
+import { type Type } from 'arktype';
+export interface TypeKroRuntimeSpecType {
+    namespace: string;
+}
+export interface TypeKroRuntimeStatusType {
+    phase: 'Pending' | 'Installing' | 'Ready' | 'Failed' | 'Upgrading';
+    components: {
+        fluxSystem: boolean;
+        kroSystem: boolean;
+    };
+}
+export declare const TypeKroRuntimeSpec: Type<TypeKroRuntimeSpecType>;
+export declare const TypeKroRuntimeStatus: Type<TypeKroRuntimeStatusType>;
+/**
+ * RBAC configuration for the TypeKro runtime bootstrap.
+ *
+ * - `'cluster-admin'` (default): Binds all Flux controllers to the built-in `cluster-admin`
+ *   ClusterRole. This is the simplest option and works with any Helm chart, but grants
+ *   unrestricted cluster access.
+ *
+ * - `'scoped'`: Creates a dedicated ClusterRole with the minimum permissions required by
+ *   Flux controllers (Helm, Kustomize, Source, Notification, Image). This is more secure
+ *   but may fail if a deployed Helm chart creates CRDs or cluster-scoped resources that
+ *   require additional permissions not covered by the scoped role.
+ *
+ * - `{ clusterRoleRef: string }`: Binds Flux controllers to a user-provided ClusterRole.
+ *   The ClusterRole must already exist in the cluster. Use this when you need precise
+ *   control over permissions.
+ */
+export type RbacMode = 'cluster-admin' | 'scoped' | {
+    clusterRoleRef: string;
+};
+export interface TypeKroRuntimeConfig {
+    namespace?: string;
+    fluxVersion?: string;
+    kroVersion?: string;
+    /**
+     * RBAC mode for Flux controller permissions.
+     *
+     * @default 'cluster-admin'
+     * @see {@link RbacMode} for details on each mode.
+     */
+    rbac?: RbacMode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/compositions/typekro-runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/compositions/typekro-runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnE,UAAU,EAAE;QACV,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED,eAAO,MAAM,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAE1D,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,IAAI,CAAC,wBAAwB,CAM9D,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,QAAQ,GAAG,eAAe,GAAG,QAAQ,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB"}

package/dist/compositions/typekro-runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/compositions/typekro-runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,IAAI,EAAE,MAAM,SAAS,CAAC;AAc1C,MAAM,CAAC,MAAM,kBAAkB,GAAiC,IAAI,CAAC;IACnE,SAAS,EAAE,QAAQ;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAmC,IAAI,CAAC;IACvE,KAAK,EAAE,6DAA6D;IACpE,UAAU,EAAE;QACV,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,SAAS;KACrB;CACF,CAAC,CAAC"}

package/dist/core/composition/context.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Composition Context Infrastructure
+ *
+ * This module owns the AsyncLocalStorage singletons that track the active
+ * composition and status-builder contexts. It was extracted from
+ * `src/factories/shared.ts` to fix an architectural inversion where
+ * `src/core/` depended on `src/factories/` for foundational infrastructure.
+ *
+ * **Singleton guarantee:** The AsyncLocalStorage instances are module-scoped
+ * constants. Every consumer (core and factories alike) must import from this
+ * single canonical location to avoid accidental duplication.
+ */
+import type { DeploymentClosure } from '../types/deployment.js';
+import type { Enhanced } from '../types.js';
+/**
+ * Context for imperative composition pattern.
+ * Tracks resources and deployment closures created during composition function execution.
+ */
+export interface CompositionContext {
+    /** Map of resource ID to Enhanced resource */
+    resources: Record<string, Enhanced<any, any>>;
+    /** Map of closure ID to deployment closure */
+    closures: Record<string, DeploymentClosure>;
+    /** Counter for generating unique resource IDs */
+    resourceCounter: number;
+    /** Counter for generating unique closure IDs */
+    closureCounter: number;
+    /** Counter for composition instances */
+    compositionInstanceCounter: number;
+    /** Map of variable names to resource IDs for CEL expression generation */
+    variableMappings: Record<string, string>;
+    /** Add a resource to the context */
+    addResource(id: string, resource: Enhanced<any, any>): void;
+    /** Add a deployment closure to the context */
+    addClosure(id: string, closure: DeploymentClosure): void;
+    /** Add a variable to resource ID mapping */
+    addVariableMapping(variableName: string, resourceId: string): void;
+    /** Generate a unique resource ID */
+    generateResourceId(kind: string, name?: string): string;
+    /** Generate a unique closure ID */
+    generateClosureId(name?: string): string;
+}
+/**
+ * Options for composition context creation.
+ */
+export interface CompositionContextOptions {
+    /**
+     * When true, duplicate resource IDs get a numeric suffix instead of overwriting.
+     * Used during direct-mode re-execution where forEach loops create multiple
+     * resources with the same id (e.g., 'regionDep' → 'regionDep', 'regionDep-1', 'regionDep-2').
+     */
+    deduplicateIds?: boolean;
+}
+/**
+ * Check if the current execution is within a status builder context.
+ */
+export declare function isInStatusBuilderContext(): boolean;
+/**
+ * Run a function within a status builder context where Enhanced resource
+ * proxies return KubernetesRef objects for all property access.
+ */
+export declare function runInStatusBuilderContext<T>(fn: () => T): T;
+/**
+ * Get the current composition context if one is active.
+ * @returns The active composition context or undefined if not in composition
+ */
+export declare function getCurrentCompositionContext(): CompositionContext | undefined;
+/**
+ * Run a function with a composition context.
+ * @param context The composition context to use
+ * @param fn The function to run with the context
+ * @returns The result of the function
+ */
+export declare function runWithCompositionContext<T>(context: CompositionContext, fn: () => T): T;
+/**
+ * Generic deployment closure registration wrapper.
+ * Automatically registers any deployment closure with the active composition context.
+ *
+ * @param closureFactory Function that creates the deployment closure
+ * @param name Optional name for the closure (used for ID generation)
+ * @returns The deployment closure, registered with context if active
+ */
+export declare function registerDeploymentClosure<T extends DeploymentClosure>(closureFactory: () => T, name?: string): T;
+/**
+ * Create a new composition context with default implementations.
+ * @param name Optional name for the composition (used in ID generation)
+ * @param contextOptions Options controlling context behavior
+ * @returns A new composition context
+ */
+export declare function createCompositionContext(name?: string, contextOptions?: CompositionContextOptions): CompositionContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/composition/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/core/composition/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,0BAA0B,EAAE,MAAM,CAAC;IACnC,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oCAAoC;IACpC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC5D,8CAA8C;IAC9C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzD,4CAA4C;IAC5C,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,oCAAoC;IACpC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxD,mCAAmC;IACnC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA4BD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE3D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,kBAAkB,GAAG,SAAS,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAExF;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EACnE,cAAc,EAAE,MAAM,CAAC,EACvB,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,CAYH;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,yBAAyB,GACzC,kBAAkB,CAkCpB"}

package/dist/core/composition/context.js

@@ -0,0 +1,125 @@
+/**
+ * Composition Context Infrastructure
+ *
+ * This module owns the AsyncLocalStorage singletons that track the active
+ * composition and status-builder contexts. It was extracted from
+ * `src/factories/shared.ts` to fix an architectural inversion where
+ * `src/core/` depended on `src/factories/` for foundational infrastructure.
+ *
+ * **Singleton guarantee:** The AsyncLocalStorage instances are module-scoped
+ * constants. Every consumer (core and factories alike) must import from this
+ * single canonical location to avoid accidental duplication.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+// =============================================================================
+// ASYNC-LOCAL-STORAGE SINGLETONS
+// =============================================================================
+/**
+ * AsyncLocalStorage for composition context.
+ * Enables context-aware resource registration across async boundaries.
+ */
+const COMPOSITION_CONTEXT = new AsyncLocalStorage();
+/**
+ * AsyncLocalStorage for status builder context.
+ *
+ * When active, property access on Enhanced resource proxies always returns
+ * KubernetesRef objects (instead of eager values), enabling JavaScript-to-CEL
+ * conversion in status builder functions.
+ *
+ * Replaces the previous `(globalThis as any).__TYPEKRO_STATUS_BUILDER_CONTEXT__`
+ * mutable global flag with a properly scoped, async-safe context.
+ */
+const STATUS_BUILDER_CONTEXT = new AsyncLocalStorage();
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+/**
+ * Check if the current execution is within a status builder context.
+ */
+export function isInStatusBuilderContext() {
+    return STATUS_BUILDER_CONTEXT.getStore() === true;
+}
+/**
+ * Run a function within a status builder context where Enhanced resource
+ * proxies return KubernetesRef objects for all property access.
+ */
+export function runInStatusBuilderContext(fn) {
+    return STATUS_BUILDER_CONTEXT.run(true, fn);
+}
+/**
+ * Get the current composition context if one is active.
+ * @returns The active composition context or undefined if not in composition
+ */
+export function getCurrentCompositionContext() {
+    return COMPOSITION_CONTEXT.getStore();
+}
+/**
+ * Run a function with a composition context.
+ * @param context The composition context to use
+ * @param fn The function to run with the context
+ * @returns The result of the function
+ */
+export function runWithCompositionContext(context, fn) {
+    return COMPOSITION_CONTEXT.run(context, fn);
+}
+/**
+ * Generic deployment closure registration wrapper.
+ * Automatically registers any deployment closure with the active composition context.
+ *
+ * @param closureFactory Function that creates the deployment closure
+ * @param name Optional name for the closure (used for ID generation)
+ * @returns The deployment closure, registered with context if active
+ */
+export function registerDeploymentClosure(closureFactory, name) {
+    const context = getCurrentCompositionContext();
+    if (context) {
+        const closure = closureFactory();
+        const closureId = context.generateClosureId(name);
+        context.addClosure(closureId, closure);
+        return closure;
+    }
+    // Outside composition context - return closure as-is
+    return closureFactory();
+}
+/**
+ * Create a new composition context with default implementations.
+ * @param name Optional name for the composition (used in ID generation)
+ * @param contextOptions Options controlling context behavior
+ * @returns A new composition context
+ */
+export function createCompositionContext(name, contextOptions) {
+    const idCounts = {};
+    return {
+        resources: {},
+        closures: {},
+        resourceCounter: 0,
+        closureCounter: 0,
+        compositionInstanceCounter: 0,
+        variableMappings: {},
+        addResource(id, resource) {
+            if (contextOptions?.deduplicateIds && id in this.resources) {
+                // Append numeric suffix to make the key unique
+                idCounts[id] = (idCounts[id] ?? 0) + 1;
+                const count = idCounts[id];
+                this.resources[`${id}-${count}`] = resource;
+            }
+            else {
+                this.resources[id] = resource;
+            }
+        },
+        addClosure(id, closure) {
+            this.closures[id] = closure;
+        },
+        addVariableMapping(variableName, resourceId) {
+            this.variableMappings[variableName] = resourceId;
+        },
+        generateResourceId(kind, resourceName) {
+            return resourceName || `${kind.toLowerCase()}-${++this.resourceCounter}`;
+        },
+        generateClosureId(closureName) {
+            const prefix = name ? `${name}-` : '';
+            return closureName ? `${prefix}${closureName}` : `${prefix}closure-${++this.closureCounter}`;
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/core/composition/context.js.map

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

package/dist/core/composition/imperative.d.ts

@@ -6,12 +6,8 @@
  * automatically generating the same robust, type-safe ResourceGraphDefinitions
  * as the existing toResourceGraph API.
  */
-import type { TypedResourceGraph } from '../types/deployment.js';
+import type { CallableComposition } from '../types/deployment.js';
 import type { KroCompatibleType, MagicAssignableShape, ResourceGraphDefinition, SerializationOptions } from '../types/serialization.js';
-/**
- * Enable debug mode for composition execution
- * This will log detailed information about resource registration, status building, and performance
- */
 export declare function enableCompositionDebugging(): void;
 /**
  * Disable debug mode for composition execution
@@ -27,13 +23,43 @@ export declare function getCompositionDebugLogs(): string[];
  */
 export declare function clearCompositionDebugLogs(): void;
 /**
- * Create an imperative composition that automatically captures resources
- * and returns status objects using MagicAssignableShape
+ * Create an imperative Kubernetes composition using natural TypeScript.
+ *
+ * Unlike {@link toResourceGraph} which uses separate resource/status builders,
+ * `kubernetesComposition` lets you write a single function that creates resources
+ * inline. Resources are automatically captured via the magic proxy system.
+ * The returned callable composition can be deployed directly or nested inside
+ * other compositions.
  *
- * @param definition - The resource graph definition with schemas
- * @param compositionFn - Synchronous function that takes spec and returns MagicAssignableShape<TStatus>
+ * @typeParam TSpec - The arktype schema for the custom resource's spec
+ * @typeParam TStatus - The arktype schema for the custom resource's status
+ *
+ * @param definition - The RGD metadata: name, apiVersion, kind, spec/status schemas
+ * @param compositionFn - Imperative function receiving the spec, creates resources
+ *   inline, and returns a status shape. Resources created with factory functions
+ *   (e.g., `Deployment()`, `Service()`) are automatically registered.
  * @param options - Optional serialization options
- * @returns TypedResourceGraph directly (not a factory)
+ * @returns A `CallableComposition` that can be deployed or nested inside other compositions
+ *
+ * @example
+ * ```typescript
+ * const webapp = kubernetesComposition(
+ *   {
+ *     name: 'webapp',
+ *     apiVersion: 'apps.example.com/v1alpha1',
+ *     kind: 'WebApp',
+ *     spec: type({ name: 'string', replicas: 'number' }),
+ *     status: type({ ready: 'boolean' }),
+ *   },
+ *   (spec) => {
+ *     const deploy = Deployment({ name: spec.name, replicas: spec.replicas });
+ *     const svc = Service({ name: spec.name });
+ *     return {
+ *       ready: Cel.expr<boolean>(deploy.status.readyReplicas, ' > 0'),
+ *     };
+ *   },
+ * );
+ * ```
  */
-export declare function kubernetesComposition<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType>(definition: ResourceGraphDefinition<TSpec, TStatus>, compositionFn: (spec: TSpec) => MagicAssignableShape<TStatus>, options?: SerializationOptions): TypedResourceGraph<TSpec, TStatus>;
+export declare function kubernetesComposition<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType>(definition: ResourceGraphDefinition<TSpec, TStatus>, compositionFn: (spec: TSpec) => MagicAssignableShape<TStatus>, options?: SerializationOptions): CallableComposition<TSpec, TStatus>;
 //# sourceMappingURL=imperative.d.ts.map

package/dist/core/composition/imperative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imperative.d.ts","sourceRoot":"","sources":["../../../src/core/composition/imperative.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAGnC;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AA6RD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,SAAS,iBAAiB,EAC/B,OAAO,SAAS,iBAAiB,EAEjC,UAAU,EAAE,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,EACnD,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,oBAAoB,CAAC,OAAO,CAAC,EAC7D,OAAO,CAAC,EAAE,oBAAoB,GAC7B,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CA6BpC"}
+{"version":3,"file":"imperative.d.ts","sourceRoot":"","sources":["../../../src/core/composition/imperative.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EACV,mBAAmB,EAIpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAgBnC,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AA8iBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,SAAS,iBAAiB,EAC/B,OAAO,SAAS,iBAAiB,EAEjC,UAAU,EAAE,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,EACnD,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,oBAAoB,CAAC,OAAO,CAAC,EAC7D,OAAO,CAAC,EAAE,oBAAoB,GAC7B,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAyOrC"}