typekro 0.28.0 → 0.29.0

package/dist/factories/kubernetes/yaml/yaml-artifact-applier.d.ts

@@ -0,0 +1,15 @@
+import type { ArtifactApplyPolicy } from '../../../core/planning/artifacts.js';
+import type { AppliedResource, DeploymentContext } from '../../../core/types/deployment.js';
+import type { KubernetesResource } from '../../../core/types/kubernetes.js';
+export type YamlDeploymentStrategy = 'replace' | 'skipIfExists' | 'fail' | 'serverSideApply';
+interface YamlApplyOptions {
+    readonly fieldManager?: string;
+    readonly forceConflicts?: boolean;
+}
+/** Translate compatibility YAML options into the canonical artifact policy vocabulary. */
+export declare function yamlDeploymentApplyPolicy(strategy: YamlDeploymentStrategy, options?: YamlApplyOptions): ArtifactApplyPolicy;
+export declare function yamlAppliedResource(manifest: KubernetesResource): AppliedResource;
+/** Apply one YAML-sourced manifest through the same artifact applier as direct resources. */
+export declare function applyYamlArtifact(manifest: KubernetesResource, strategy: YamlDeploymentStrategy, deploymentContext: DeploymentContext, factoryName: string, options?: YamlApplyOptions): Promise<AppliedResource>;
+export {};
+//# sourceMappingURL=yaml-artifact-applier.d.ts.map

package/dist/factories/kubernetes/yaml/yaml-artifact-applier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-artifact-applier.d.ts","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-artifact-applier.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE7F,UAAU,gBAAgB;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAID,0FAA0F;AAC1F,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE,gBAAqB,GAC7B,mBAAmB,CAyBrB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAOjF;AAED,6FAA6F;AAC7F,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,sBAAsB,EAChC,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAyC1B"}

package/dist/factories/kubernetes/yaml/yaml-artifact-applier.js

@@ -0,0 +1,69 @@
+import { ResourceApplier } from '../../../core/deployment/resource-applier.js';
+import { ResourceGraphFactoryError } from '../../../core/errors.js';
+import { getComponentLogger } from '../../../core/logging/index.js';
+const logger = getComponentLogger('yaml-artifact-applier');
+/** Translate compatibility YAML options into the canonical artifact policy vocabulary. */
+export function yamlDeploymentApplyPolicy(strategy, options = {}) {
+    switch (strategy) {
+        case 'serverSideApply':
+            return {
+                strategy: 'server-side-apply',
+                fieldManager: options.fieldManager ?? 'typekro',
+                fieldConflictPolicy: options.forceConflicts ? 'force-owned-fields' : 'fail',
+                immutableFieldPolicy: 'fail',
+            };
+        case 'fail':
+            return { strategy: 'create-only' };
+        case 'skipIfExists':
+            return {
+                strategy: 'create-or-patch',
+                existingResource: 'warn',
+                immutableFieldPolicy: 'fail',
+            };
+        case 'replace':
+            // Historical YAML "replace" behavior patched an existing object in place.
+            return {
+                strategy: 'create-or-patch',
+                existingResource: 'patch',
+                immutableFieldPolicy: 'fail',
+            };
+    }
+}
+export function yamlAppliedResource(manifest) {
+    return {
+        kind: manifest.kind || 'Unknown',
+        name: manifest.metadata?.name || 'unknown',
+        namespace: manifest.metadata?.namespace || undefined,
+        apiVersion: manifest.apiVersion || 'v1',
+    };
+}
+/** Apply one YAML-sourced manifest through the same artifact applier as direct resources. */
+export async function applyYamlArtifact(manifest, strategy, deploymentContext, factoryName, options = {}) {
+    const kubernetesApi = deploymentContext.kubernetesApi;
+    if (!kubernetesApi) {
+        throw new ResourceGraphFactoryError('No Kubernetes API available for YAML deployment', factoryName, 'deployment');
+    }
+    const resourceLogger = logger.child({
+        yamlResource: factoryName,
+        apiVersion: manifest.apiVersion,
+        kind: manifest.kind,
+        name: manifest.metadata?.name,
+        namespace: manifest.metadata?.namespace,
+    });
+    const applier = new ResourceApplier(kubernetesApi, undefined, resourceLogger);
+    await applier.applyArtifactResource(manifest, yamlDeploymentApplyPolicy(strategy, options), {
+        mode: 'direct',
+        waitForReady: false,
+        // A closure is already one parent-engine operation. Keep retries owned by
+        // that operation instead of adding a second nested retry schedule.
+        retryPolicy: {
+            maxRetries: 0,
+            backoffMultiplier: 1,
+            initialDelay: 0,
+            maxDelay: 0,
+        },
+        ...(deploymentContext.abortSignal ? { abortSignal: deploymentContext.abortSignal } : {}),
+    }, resourceLogger);
+    return yamlAppliedResource(manifest);
+}
+//# sourceMappingURL=yaml-artifact-applier.js.map

package/dist/factories/kubernetes/yaml/yaml-artifact-applier.js.map

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

package/dist/factories/kubernetes/yaml/yaml-directory.d.ts

@@ -1,5 +1,6 @@
 import type { KubernetesRef } from '../../../core/types/common.js';
 import type { AppliedResource, DeploymentClosure } from '../../../core/types/deployment.js';
+import { type YamlDeploymentStrategy } from './yaml-artifact-applier.js';
 export interface YamlDirectoryConfig {
     name: string;
     /** Resource graph identifier. Required when `name` is dynamic (e.g. from schema references). */
@@ -13,7 +14,7 @@ export interface YamlDirectoryConfig {
     exclude?: string[];
     namespace?: string | KubernetesRef<string>;
     /** @default 'replace' */
-    deploymentStrategy?: 'replace' | 'skipIfExists' | 'fail';
+    deploymentStrategy?: Exclude<YamlDeploymentStrategy, 'serverSideApply'>;
 }
 /**
  * Deploy YAML files from a directory during deployment phase

package/dist/factories/kubernetes/yaml/yaml-directory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-directory.d.ts","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-directory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAuB3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CA+E/F"}
+{"version":3,"file":"yaml-directory.d.ts","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-directory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,4BAA4B,CAAC;AAkBpC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAkD/F"}

package/dist/factories/kubernetes/yaml/yaml-directory.js

@@ -1,10 +1,8 @@
 import * as yaml from 'js-yaml';
-import { ResourceGraphFactoryError } from '../../../core/errors.js';
-import { getErrorStatusCode } from '../../../core/kubernetes/errors.js';
 import { PathResolver } from '../../../core/yaml/path-resolver.js';
 import { isKubernetesRef } from '../../../utils/type-guards.js';
 import { registerDeploymentClosure } from '../../shared.js';
-import { handleConflict } from './conflict-handler.js';
+import { applyYamlArtifact, yamlAppliedResource, } from './yaml-artifact-applier.js';
 /**
  * Parse YAML content into Kubernetes manifests
  */
@@ -73,39 +71,10 @@ export function yamlDirectory(config) {
                         manifest.metadata = { ...manifest.metadata, namespace: resolvedNamespace };
                     }
                     if (deploymentContext.validationOnly) {
-                        allResults.push({
-                            kind: manifest.kind || 'Unknown',
-                            name: manifest.metadata?.name || 'unknown',
-                            namespace: manifest.metadata?.namespace || undefined,
-                            apiVersion: manifest.apiVersion || 'v1',
-                        });
+                        allResults.push(yamlAppliedResource(manifest));
                         continue;
                     }
-                    try {
-                        if (deploymentContext.kubernetesApi) {
-                            await deploymentContext.kubernetesApi.create(manifest);
-                        }
-                        else {
-                            throw new ResourceGraphFactoryError('No Kubernetes API available for YAML deployment', config.name, 'deployment');
-                        }
-                        allResults.push({
-                            kind: manifest.kind || 'Unknown',
-                            name: manifest.metadata?.name || 'unknown',
-                            namespace: manifest.metadata?.namespace || undefined,
-                            apiVersion: manifest.apiVersion || 'v1',
-                        });
-                    }
-                    catch (error) {
-                        // Handle conflicts based on deployment strategy
-                        if (getErrorStatusCode(error) === 409) {
-                            const result = await handleConflict(error, manifest, strategy, deploymentContext);
-                            allResults.push(result);
-                        }
-                        else {
-                            // Non-conflict errors should always be thrown
-                            throw error;
-                        }
-                    }
+                    allResults.push(await applyYamlArtifact(manifest, strategy, deploymentContext, config.name));
                 }
             }
             return allResults;

package/dist/factories/kubernetes/yaml/yaml-directory.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-directory.js","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAQxE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,SAAS,kBAAkB,CAAC,WAAmB;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrF,MAAM,SAAS,GAAyB,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;YAC3E,SAAS,CAAC,IAAI,CAAC,GAAyB,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,8EAA8E;IAC9E,OAAO,yBAAyB,CAAC,GAAG,EAAE;QACpC,gCAAgC;QAChC,MAAM,OAAO,GAAG,KAAK,EAAE,iBAAoC,EAA8B,EAAE;YACzF,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,iBAAiB,CACpD,MAAM,CAAC,IAAI,EACX;gBACE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;gBACnC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;gBACpD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;aAC9B,EACD,MAAM,CAAC,IAAI,CACZ,CAAC;YAEF,MAAM,UAAU,GAAsB,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,IAAI,SAAS,CAAC;YAExD,KAAK,MAAM,cAAc,IAAI,SAAS,EAAE,CAAC;gBACvC,uDAAuD;gBACvD,MAAM,SAAS,GAAG,kBAAkB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;gBAE7D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,+BAA+B;oBAC/B,MAAM,iBAAiB,GACrB,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC;wBACnD,CAAC,CAAC,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC;wBAC5D,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;oBAEvB,IAAI,iBAAiB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;wBACvD,QAAQ,CAAC,QAAQ,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,iBAA2B,EAAE,CAAC;oBACvF,CAAC;oBAED,IAAI,iBAAiB,CAAC,cAAc,EAAE,CAAC;wBACrC,UAAU,CAAC,IAAI,CAAC;4BACd,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,SAAS;4BAChC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS;4BAC1C,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,SAAS;4BACpD,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,IAAI;yBACxC,CAAC,CAAC;wBACH,SAAS;oBACX,CAAC;oBAED,IAAI,CAAC;wBACH,IAAI,iBAAiB,CAAC,aAAa,EAAE,CAAC;4BACpC,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;wBACzD,CAAC;6BAAM,CAAC;4BACN,MAAM,IAAI,yBAAyB,CACjC,iDAAiD,EACjD,MAAM,CAAC,IAAI,EACX,YAAY,CACb,CAAC;wBACJ,CAAC;wBAED,UAAU,CAAC,IAAI,CAAC;4BACd,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,SAAS;4BAChC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS;4BAC1C,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,SAAS;4BACpD,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,IAAI;yBACxC,CAAC,CAAC;oBACL,CAAC;oBAAC,OAAO,KAAc,EAAE,CAAC;wBACxB,gDAAgD;wBAChD,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;4BACtC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;4BAClF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAC1B,CAAC;6BAAM,CAAC;4BACN,8CAA8C;4BAC9C,MAAM,KAAK,CAAC;wBACd,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"yaml-directory.js","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-directory.ts"],"names":[],"mappings":"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"}

package/dist/factories/kubernetes/yaml/yaml-file.d.ts

@@ -2,115 +2,37 @@ import type * as k8s from '@kubernetes/client-node';
 import type { KubernetesRef } from '../../../core/types/common.js';
 import type { AppliedResource, DeploymentClosure } from '../../../core/types/deployment.js';
 import type { KubernetesResource } from '../../../core/types/kubernetes.js';
+import { type YamlDeploymentStrategy } from './yaml-artifact-applier.js';
 export interface YamlFileConfig {
     name: string;
-    /** Resource graph identifier. Required when `name` is dynamic (e.g. from schema references). */
+    /** Resource graph identifier. Required when `name` is dynamic. */
     id?: string;
     path: string;
     namespace?: string | KubernetesRef<string>;
     /** @default 'replace' */
-    deploymentStrategy?: 'replace' | 'skipIfExists' | 'fail' | 'serverSideApply';
-    /**
-     * Optional transform function to apply to each manifest before deployment.
-     * Useful for applying fixes or modifications to external manifests.
-     *
-     * @example
-     * ```typescript
-     * import { fixCRDSchemaForK8s133 } from '../../../core/runtime-patches/crd-schema-fix.js';
-     *
-     * yamlFile({
-     *   name: 'flux-install',
-     *   path: 'https://github.com/fluxcd/flux2/releases/download/v2.7.5/install.yaml',
-     *   manifestTransform: fixCRDSchemaForK8s133,
-     * });
-     * ```
-     */
+    deploymentStrategy?: YamlDeploymentStrategy;
+    /** Transform each parsed desired manifest before artifact application. */
     manifestTransform?: (manifest: KubernetesResource) => KubernetesResource;
-    /**
-     * Field manager name for server-side apply operations.
-     * Only used when deploymentStrategy is 'serverSideApply'.
-     * @default 'typekro'
-     */
+    /** Field manager used by the `serverSideApply` compatibility option. @default 'typekro' */
     fieldManager?: string;
-    /**
-     * Force conflicts during server-side apply.
-     * When true, takes ownership of conflicting fields from other managers.
-     * Only used when deploymentStrategy is 'serverSideApply'.
-     * @default false
-     */
+    /** Take ownership of conflicting fields during server-side apply. @default false */
     forceConflicts?: boolean;
     /**
-     * Timeout in milliseconds for CRD JSON-patch operations.
-     * Only relevant when deploying CRD manifests with `serverSideApply` strategy,
-     * where a follow-up JSON patch is applied to ensure schema fields like
-     * `x-kubernetes-preserve-unknown-fields` are set correctly.
-     * @default 30000
+     * @deprecated CRDs now use the canonical artifact SSA operation. Transform
+     * the desired manifest with `manifestTransform` before applying it instead.
      */
     crdPatchTimeout?: number;
     /**
-     * Optional callback invoked when the YAML content cannot be fetched (e.g., HTTP error
-     * for remote URLs). If the callback returns `true`, the closure treats the failure as
-     * a no-op — meaning the resources are assumed to already exist on the cluster.
-     *
-     * This enables idempotent bootstrap patterns: if Flux is already installed and the
-     * download URL is temporarily unreachable, the deployment can proceed instead of
-     * failing the entire operation.
-     *
-     * The callback receives the Kubernetes API client so it can check for sentinel
-     * resources (e.g., CRDs, namespaces, deployments).
-     *
-     * @example
-     * ```typescript
-     * yamlFile({
-     *   name: 'flux-install',
-     *   path: 'https://github.com/fluxcd/flux2/releases/latest/download/install.yaml',
-     *   skipIfFetchFails: async (k8sApi) => {
-     *     // If Flux CRDs exist, the install is already done
-     *     try {
-     *       await k8sApi.read({ apiVersion: 'apiextensions.k8s.io/v1', kind: 'CustomResourceDefinition',
-     *         metadata: { name: 'helmreleases.helm.toolkit.fluxcd.io' } });
-     *       return true; // Already installed
-     *     } catch { return false; }
-     *   },
-     * });
-     * ```
+     * Called after content fetch failure. Returning true treats the closure as
+     * already satisfied by resources observed on the cluster.
      */
     skipIfFetchFails?: (k8sApi: k8s.KubernetesObjectApi) => Promise<boolean>;
 }
 /**
- * Deploy a YAML file during deployment phase
- *
- * This looks like a factory function but returns a closure that executes during
- * deployment. The closure receives deployment context (including alchemy scope)
- * and applies manifests directly to Kubernetes in parallel with Enhanced<> resources.
- *
- * @example
- * ```typescript
- * const graph = toResourceGraph(
- *   {
- *     name: 'my-app',
- *     apiVersion: 'example.com/v1alpha1',
- *     kind: 'MyApp',
- *     spec: type({ replicas: 'number' }),
- *     status: type({ ready: 'boolean' })
- *   },
- *   (schema) => ({
- *     // This returns a closure, stored in composition context
- *     crds: yamlFile({
- *       name: 'flux-crds',
- *       path: 'git:github.com/fluxcd/flux2/manifests/crds@main'
- *     }),
+ * Deploy one YAML document set as a compatibility closure.
  *
- *     // This is a normal Enhanced<> resource
- *     webapp: simple.Deployment({
- *       name: 'nginx',
- *       image: 'nginx',
- *       replicas: schema.spec.replicas
- *     })
- *   }),
- *   (_schema, resources) => ({ ready: true })
- * );
- * ```
+ * Fetching, transforms, and closure ordering remain closure responsibilities;
+ * Kubernetes write semantics are delegated to the canonical artifact applier.
  */
 export declare function yamlFile(config: YamlFileConfig): DeploymentClosure<AppliedResource[]>;
 //# sourceMappingURL=yaml-file.d.ts.map

package/dist/factories/kubernetes/yaml/yaml-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml-file.d.ts","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAUpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AA8RzF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,iBAAiB,CAAC;IAC7E;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IACzE;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAsHrF"}
+{"version":3,"file":"yaml-file.d.ts","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAI5E,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,4BAA4B,CAAC;AAoBpC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IAC5C,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IACzE,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CA0DrF"}