typekro 0.13.0 → 0.15.0

package/dist/core/containers/resolve.d.ts

@@ -1,14 +0,0 @@
-import { type ContainerImageRef } from './image.js';
-/**
- * Build + substitute every container image referenced by `resources`. Returns the resolved
- * `containerId → imageUri` map (also useful for logging/diagnostics). Mutates the resources in place.
- *
- * `build` defaults to the real {@link buildContainer}; it is injectable purely so tests can resolve
- * without a Docker daemon (avoids globally mocking the build module, which would leak across files).
- */
-export declare function resolveContainerImages(resources: readonly unknown[], build?: (options: ContainerImageRef['buildOptions']) => Promise<{
-    imageUri: string;
-}>): Promise<Map<string, string>>;
-/** Whether any resource in the set references a container image (cheap pre-check to skip resolution). */
-export declare function hasContainerImageRefs(resources: readonly unknown[]): boolean;
-//# sourceMappingURL=resolve.d.ts.map

package/dist/core/containers/resolve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/core/containers/resolve.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,YAAY,CAAC;AAgCzE;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,KAAK,GAAE,CACL,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,KACvC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAkB,GAClD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+B9B;AAED,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAS5E"}

package/dist/core/containers/resolve.js

@@ -1,88 +0,0 @@
-/**
- * Container Image Resolution
- *
- * Resolves every {@link ContainerImageRef} reachable from a set of resources to its literal image URI,
- * building each distinct container ONCE by delegating to the existing {@link buildContainer} (this
- * module adds NO build/push logic of its own). The refs are replaced in place with the URI string.
- *
- * Runs CLIENT-SIDE before apply (direct mode) / RGD serialization (kro mode), so a container image is
- * never a CEL expression and Kro only ever sees a literal image string.
- */
-import { getComponentLogger } from '../logging/index.js';
-import { buildContainer } from './build.js';
-import { isContainerImageRef } from './image.js';
-const logger = getComponentLogger('container-resolve');
-/** Deep-walk a value, invoking `onRef` for every ContainerImageRef found (cycle-safe). */
-function walk(value, seen, onRef, parent, key) {
-    if (isContainerImageRef(value)) {
-        if (parent !== undefined && key !== undefined)
-            onRef(value, parent, key);
-        return; // never descend into a ref's internals
-    }
-    if (value === null || typeof value !== 'object')
-        return;
-    if (seen.has(value))
-        return;
-    seen.add(value);
-    if (Array.isArray(value)) {
-        value.forEach((item, i) => walk(item, seen, onRef, value, i));
-    }
-    else {
-        for (const k of Object.keys(value)) {
-            walk(value[k], seen, onRef, value, k);
-        }
-    }
-}
-/**
- * Build + substitute every container image referenced by `resources`. Returns the resolved
- * `containerId → imageUri` map (also useful for logging/diagnostics). Mutates the resources in place.
- *
- * `build` defaults to the real {@link buildContainer}; it is injectable purely so tests can resolve
- * without a Docker daemon (avoids globally mocking the build module, which would leak across files).
- */
-export async function resolveContainerImages(resources, build = buildContainer) {
-    // 1. Collect the distinct containers referenced anywhere in the resource set.
-    const byId = new Map();
-    for (const resource of resources) {
-        walk(resource, new Set(), (ref) => {
-            if (!byId.has(ref.containerId))
-                byId.set(ref.containerId, ref);
-        });
-    }
-    if (byId.size === 0)
-        return new Map();
-    // 2. Build each distinct container ONCE (delegating to buildContainer — the existing push mechanics).
-    const uriByContainer = new Map();
-    for (const [containerId, ref] of byId) {
-        logger.info('Building container image for reference', {
-            containerId,
-            imageName: ref.buildOptions.imageName,
-        });
-        const { imageUri } = await build(ref.buildOptions);
-        uriByContainer.set(containerId, imageUri);
-        logger.info('Resolved container image', { containerId, imageUri });
-    }
-    // 3. Substitute every ref with its resolved literal URI, in place.
-    for (const resource of resources) {
-        walk(resource, new Set(), (ref, parent, key) => {
-            const uri = uriByContainer.get(ref.containerId);
-            if (uri === undefined)
-                return;
-            parent[key] = uri;
-        });
-    }
-    return uriByContainer;
-}
-/** Whether any resource in the set references a container image (cheap pre-check to skip resolution). */
-export function hasContainerImageRefs(resources) {
-    let found = false;
-    for (const resource of resources) {
-        walk(resource, new Set(), () => {
-            found = true;
-        });
-        if (found)
-            break;
-    }
-    return found;
-}
-//# sourceMappingURL=resolve.js.map

package/dist/core/containers/resolve.js.map

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

package/dist/core/deployment/strategies/alchemy-strategy.d.ts

@@ -1,109 +0,0 @@
-/**
- * Alchemy Deployment Strategy
- *
- * This module provides the alchemy deployment strategy that wraps deployments
- * in alchemy resources with individual resource registration.
- */
-import type { DeploymentResult, FactoryOptions } from '../../types/deployment.js';
-import type { KubernetesResource } from '../../types/kubernetes.js';
-import type { KroCompatibleType, SchemaDefinition, Scope, StatusBuilder } from '../../types/serialization.js';
-import { BaseDeploymentStrategy, type DeploymentStrategy } from './base-strategy.js';
-/**
- * Alchemy deployment strategy - wraps deployments in alchemy resources with individual resource registration
- *
- * This strategy implements individual resource registration for Direct mode Alchemy integration.
- * Unlike Kro mode which registers RGDs and instances, Direct mode registers each individual
- * Kubernetes resource (Deployment, Service, ConfigMap, etc.) as separate Alchemy resource types.
- *
- * ## Resource Registration Pattern
- *
- * **Direct Mode (this strategy):**
- * - Each individual Kubernetes resource gets its own Alchemy resource type registration
- * - Resource types are named using the pattern `kubernetes::{Kind}` (e.g., `kubernetes::Deployment`)
- * - Each instance of each resource gets a separate Alchemy resource registered
- * - Example: A webapp with Deployment + Service creates 2 Alchemy resource types and 2 resource instances
- *
- * **Kro Mode (for comparison):**
- * - Each RGD gets one Alchemy resource type registered (`kro::ResourceGraphDefinition`)
- * - Each instance of each RGD gets a separate Alchemy resource registered (`kro::{Kind}`)
- * - Example: A webapp RGD creates 1 RGD type + 1 instance type = 2 Alchemy resources total
- *
- * ## Error Handling
- *
- * The strategy implements robust error handling for individual resource failures:
- * - Continues processing remaining resources when individual resources fail
- * - Collects all errors and includes them in the final DeploymentResult
- * - Sets deployment status to 'partial' when some resources succeed and others fail
- * - Provides resource-specific error context including kind, name, namespace, and Alchemy resource type
- *
- * ## Integration with DirectTypeKroDeployer
- *
- * This strategy integrates with DirectTypeKroDeployer for actual resource deployment:
- * - Extracts DirectDeploymentEngine from the base DirectDeploymentStrategy
- * - Creates DirectTypeKroDeployer instance for individual resource deployments
- * - Passes deployer to each Alchemy resource provider for deployment execution
- *
- * @template TSpec - The specification type for the resource
- * @template TStatus - The status type for the resource
- */
-export declare class AlchemyDeploymentStrategy<TSpec extends KroCompatibleType, TStatus extends KroCompatibleType> extends BaseDeploymentStrategy<TSpec, TStatus> {
-    private alchemyScope;
-    private baseStrategy;
-    protected readonly alchemyLogger: import("../../logging/types.js").TypeKroLogger;
-    constructor(factoryName: string, namespace: string, schemaDefinition: SchemaDefinition<TSpec, TStatus>, statusBuilder: StatusBuilder<TSpec, TStatus, any> | undefined, resourceKeys: Record<string, KubernetesResource> | undefined, factoryOptions: FactoryOptions, alchemyScope: Scope, baseStrategy: DeploymentStrategy<TSpec, TStatus>);
-    /**
-     * Execute deployment with individual resource registration for Alchemy integration
-     *
-     * This method implements the core logic for Direct mode Alchemy integration:
-     *
-     * ## Process Overview
-     * 1. **Validation**: Validates the Alchemy scope is available and properly configured
-     * 2. **Resource Graph Creation**: Gets the resource graph from the base strategy using createResourceGraphForInstance
-     * 3. **Deployer Setup**: Creates DirectTypeKroDeployer instance using DirectDeploymentEngine from base strategy
-     * 4. **Individual Registration**: Processes each resource in the resource graph individually for Alchemy registration
-     * 5. **Error Collection**: Continues processing remaining resources when individual resources fail
-     * 6. **Result Creation**: Creates comprehensive DeploymentResult with individual resource tracking
-     *
-     * ## Individual Resource Processing
-     *
-     * For each resource in the resource graph:
-     * - **Type Inference**: Infers Alchemy resource type from Kubernetes kind (e.g., `kubernetes::Deployment`)
-     * - **Type Registration**: Calls ensureResourceTypeRegistered to register the resource type (shared across instances)
-     * - **ID Generation**: Creates unique resource ID using createAlchemyResourceId with namespace and resource info
-     * - **Deployment**: Deploys the resource through Alchemy using the resource provider and DirectTypeKroDeployer
-     * - **Tracking**: Tracks deployed resource with Alchemy metadata (resource ID, type, etc.)
-     *
-     * ## Error Handling Strategy
-     *
-     * The method implements robust error handling:
-     * - **Continue on Failure**: Individual resource failures don't stop processing of remaining resources
-     * - **Error Collection**: All errors are collected with detailed context about which resource failed
-     * - **Resource Context**: Error messages include resource kind, name, namespace, and Alchemy resource type
-     * - **Partial Status**: Deployment status is set to 'partial' when some resources succeed and others fail
-     *
-     * ## Resource Type Naming
-     *
-     * Resource types follow consistent naming patterns:
-     * - **Kubernetes Resources**: `kubernetes::{Kind}` (e.g., `kubernetes::Deployment`, `kubernetes::Service`)
-     * - **Shared Types**: Multiple instances of the same resource type share the same Alchemy resource type registration
-     * - **Unique IDs**: Each resource instance gets a unique Alchemy resource ID for individual tracking
-     *
-     * @param spec - The resource specification to deploy
-     * @param instanceName - The name of this specific instance
-     * @returns Promise<DeploymentResult> - Comprehensive deployment result with individual resource tracking
-     * @throws Error - If Alchemy scope validation fails or critical deployment errors occur
-     */
-    protected executeDeployment(spec: TSpec, instanceName: string, opts?: import('./base-strategy.js').DeployStrategyOptions): Promise<DeploymentResult>;
-    private executeBaseDirectDeployment;
-    private rollbackBaseDirectDeployment;
-    protected getStrategyMode(): 'direct' | 'kro';
-    /**
-     * Create resource graph for instance using base strategy logic
-     */
-    private createResourceGraphForInstance;
-    /**
-     * Extract serializable kubeConfig options from factory options
-     */
-    private extractKubeConfigOptions;
-}
-//# sourceMappingURL=alchemy-strategy.d.ts.map

package/dist/core/deployment/strategies/alchemy-strategy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alchemy-strategy.d.ts","sourceRoot":"","sources":["../../../../src/core/deployment/strategies/alchemy-strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,EACL,aAAa,EACd,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,yBAAyB,CACpC,KAAK,SAAS,iBAAiB,EAC/B,OAAO,SAAS,iBAAiB,CACjC,SAAQ,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC;IAW5C,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IAXtB,SAAS,CAAC,QAAQ,CAAC,aAAa,iDAAqD;gBAGnF,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAElD,aAAa,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,SAAS,EAC7D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,SAAS,EAC5D,cAAc,EAAE,cAAc,EACtB,YAAY,EAAE,KAAK,EACnB,YAAY,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC;IAK1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;cACa,iBAAiB,CAC/B,IAAI,EAAE,KAAK,EACX,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,OAAO,oBAAoB,EAAE,qBAAqB,GACxD,OAAO,CAAC,gBAAgB,CAAC;YA0Pd,2BAA2B;YAoB3B,4BAA4B;IA+B1C,SAAS,CAAC,eAAe,IAAI,QAAQ,GAAG,KAAK;IAI7C;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAuDtC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAwKjC"}