typekro 0.3.1 → 0.5.0

package/dist/factories/kubernetes/yaml/conflict-handler.js

@@ -0,0 +1,83 @@
+/**
+ * Shared conflict handling logic for YAML resource deployment.
+ *
+ * Both `yamlFile` and `yamlDirectory` need identical 409-conflict resolution
+ * when creating Kubernetes resources. This module extracts that pattern into
+ * a single reusable function.
+ */
+import { ensureError } from '../../../core/errors.js';
+import { getErrorStatusCode } from '../../../core/kubernetes/errors.js';
+import { getComponentLogger } from '../../../core/logging/index.js';
+const logger = getComponentLogger('yaml-conflict-handler');
+/**
+ * Build the {@link AppliedResource} record for a given manifest.
+ */
+function toAppliedResource(manifest) {
+    return {
+        kind: manifest.kind || 'Unknown',
+        name: manifest.metadata?.name || 'unknown',
+        namespace: manifest.metadata?.namespace || undefined,
+        apiVersion: manifest.apiVersion || 'v1',
+    };
+}
+/**
+ * Handle a 409 Conflict error according to the chosen deployment strategy.
+ *
+ * @param error - The original caught error (must have status code 409).
+ * @param manifest - The manifest that triggered the conflict.
+ * @param strategy - The deployment strategy to apply.
+ * @param deploymentContext - Provides access to the Kubernetes API client.
+ * @returns The {@link AppliedResource} if the conflict was resolved, or
+ *          re-throws if the strategy is `'fail'`.
+ */
+export async function handleConflict(error, manifest, strategy, deploymentContext) {
+    const resourceName = `${manifest.kind}/${manifest.metadata?.name}`;
+    if (strategy === 'skipIfExists') {
+        logger.info('Skipping existing resource (409 conflict)', { resourceName, strategy });
+        return toAppliedResource(manifest);
+    }
+    if (strategy === 'replace') {
+        logger.info('Replacing existing resource (409 conflict)', { resourceName, strategy });
+        try {
+            if (deploymentContext.kubernetesApi) {
+                // Check if resource exists first
+                let existing;
+                try {
+                    // In the new API, methods return objects directly (no .body wrapper)
+                    existing = await deploymentContext.kubernetesApi.read({
+                        apiVersion: manifest.apiVersion,
+                        kind: manifest.kind,
+                        metadata: {
+                            name: manifest.metadata?.name || '',
+                            namespace: manifest.metadata?.namespace || 'default',
+                        },
+                    });
+                }
+                catch (readError) {
+                    // If it's a 404, the resource doesn't exist
+                    if (getErrorStatusCode(readError) !== 404) {
+                        throw readError;
+                    }
+                }
+                if (existing) {
+                    // Resource exists, use patch for safer updates
+                    await deploymentContext.kubernetesApi.patch(manifest);
+                }
+                else {
+                    // Resource does not exist, create it
+                    await deploymentContext.kubernetesApi.create(manifest);
+                }
+            }
+            return toAppliedResource(manifest);
+        }
+        catch (replaceError) {
+            logger.error('Failed to replace resource', ensureError(replaceError), {
+                resourceName,
+            });
+            throw replaceError;
+        }
+    }
+    // strategy === 'fail' (default behavior)
+    throw error;
+}
+//# sourceMappingURL=conflict-handler.js.map

package/dist/factories/kubernetes/yaml/conflict-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-handler.js","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/conflict-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIpE,MAAM,MAAM,GAAG,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;AAK3D;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAA4B;IACrD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,SAAS;QAChC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS;QAC1C,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,SAAS;QACpD,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,IAAI;KACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAc,EACd,QAA4B,EAC5B,QAA0B,EAC1B,iBAAoC;IAEpC,MAAM,YAAY,GAAG,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAEnE,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrF,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC;YACH,IAAI,iBAAiB,CAAC,aAAa,EAAE,CAAC;gBACpC,iCAAiC;gBACjC,IAAI,QAAiB,CAAC;gBACtB,IAAI,CAAC;oBACH,qEAAqE;oBACrE,QAAQ,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC;wBACpD,UAAU,EAAE,QAAQ,CAAC,UAAU;wBAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE;4BACnC,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,SAAS;yBACrD;qBACF,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,SAAkB,EAAE,CAAC;oBAC5B,4CAA4C;oBAC5C,IAAI,kBAAkB,CAAC,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC;wBAC1C,MAAM,SAAS,CAAC;oBAClB,CAAC;gBACH,CAAC;gBAED,IAAI,QAAQ,EAAE,CAAC;oBACb,+CAA+C;oBAC/C,MAAM,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,qCAAqC;oBACrC,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,YAAqB,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE;gBACpE,YAAY;aACb,CAAC,CAAC;YACH,MAAM,YAAY,CAAC;QACrB,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,MAAM,KAAK,CAAC;AACd,CAAC"}

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

@@ -2,11 +2,17 @@ import type { KubernetesRef } from '../../../core/types/common.js';
 import type { AppliedResource, DeploymentClosure } from '../../../core/types/deployment.js';
 export interface YamlDirectoryConfig {
     name: string;
+    /** Resource graph identifier. Required when `name` is dynamic (e.g. from schema references). */
+    id?: string;
     path: string;
+    /** @default true */
     recursive?: boolean;
+    /** @default ['**\/*.yaml', '**\/*.yml'] */
     include?: string[];
+    /** @default [] */
     exclude?: string[];
     namespace?: string | KubernetesRef<string>;
+    /** @default 'replace' */
     deploymentStrategy?: 'replace' | 'skipIfExists' | 'fail';
 }
 /**
@@ -40,15 +46,4 @@ export interface YamlDirectoryConfig {
  * ```
  */
 export declare function yamlDirectory(config: YamlDirectoryConfig): DeploymentClosure<AppliedResource[]>;
-/**
- * Common Git repository paths for popular controllers
- */
-export declare const GitPaths: {
-    readonly fluxHelm: (version?: string) => string;
-    readonly fluxKustomize: (version?: string) => string;
-    readonly fluxSource: (version?: string) => string;
-    readonly kro: (version?: string) => string;
-    readonly argoCD: (version?: string) => string;
-    readonly istio: (version?: string) => string;
-};
 //# sourceMappingURL=yaml-directory.d.ts.map

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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAqB3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,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,CAkI/F;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;CAUX,CAAC"}
+{"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,CAkF/F"}

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

@@ -1,12 +1,15 @@
 import * as yaml from 'js-yaml';
-import { isKubernetesRef } from '../../../core/dependencies/type-guards.js';
+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';
 /**
  * Parse YAML content into Kubernetes manifests
  */
 function parseYamlManifests(yamlContent) {
-    const documents = yaml.loadAll(yamlContent);
+    const documents = yaml.loadAll(yamlContent, undefined, { schema: yaml.JSON_SCHEMA });
     const manifests = [];
     for (const doc of documents) {
         if (doc && typeof doc === 'object' && 'kind' in doc && 'apiVersion' in doc) {
@@ -78,14 +81,14 @@ export function yamlDirectory(config) {
                                 await deploymentContext.kubernetesApi.create(manifest);
                             }
                             else {
-                                throw new Error('No Kubernetes API available for YAML deployment');
+                                throw new ResourceGraphFactoryError('No Kubernetes API available for YAML deployment', config.name, 'deployment');
                             }
                         }
                         else if (deploymentContext.kubernetesApi) {
                             await deploymentContext.kubernetesApi.create(manifest);
                         }
                         else {
-                            throw new Error('No deployment method available: neither alchemyScope nor kubernetesApi provided');
+                            throw new ResourceGraphFactoryError('No deployment method available: neither alchemyScope nor kubernetesApi provided', config.name, 'deployment');
                         }
                         allResults.push({
                             kind: manifest.kind || 'Unknown',
@@ -96,66 +99,9 @@ export function yamlDirectory(config) {
                     }
                     catch (error) {
                         // Handle conflicts based on deployment strategy
-                        if (error?.response?.statusCode === 409 || error?.statusCode === 409) {
-                            const resourceName = `${manifest.kind}/${manifest.metadata?.name}`;
-                            if (strategy === 'skipIfExists') {
-                                console.log(`⚠️ Skipping existing resource: ${resourceName}`);
-                                allResults.push({
-                                    kind: manifest.kind || 'Unknown',
-                                    name: manifest.metadata?.name || 'unknown',
-                                    namespace: manifest.metadata?.namespace || undefined,
-                                    apiVersion: manifest.apiVersion || 'v1',
-                                });
-                            }
-                            else if (strategy === 'replace') {
-                                console.log(`🔄 Replacing existing resource: ${resourceName}`);
-                                // Try to update/replace the resource
-                                try {
-                                    if (deploymentContext.kubernetesApi) {
-                                        // Check if resource exists first
-                                        let existing;
-                                        try {
-                                            const readResult = await deploymentContext.kubernetesApi.read({
-                                                apiVersion: manifest.apiVersion,
-                                                kind: manifest.kind,
-                                                metadata: {
-                                                    name: manifest.metadata?.name || '',
-                                                    namespace: manifest.metadata?.namespace || 'default',
-                                                },
-                                            });
-                                            existing = readResult.body;
-                                        }
-                                        catch (error) {
-                                            // If it's a 404, the resource doesn't exist
-                                            if (error.statusCode !== 404) {
-                                                throw error;
-                                            }
-                                        }
-                                        if (existing) {
-                                            // Resource exists, use patch for safer updates
-                                            await deploymentContext.kubernetesApi.patch(manifest);
-                                        }
-                                        else {
-                                            // Resource does not exist, create it
-                                            await deploymentContext.kubernetesApi.create(manifest);
-                                        }
-                                    }
-                                    allResults.push({
-                                        kind: manifest.kind || 'Unknown',
-                                        name: manifest.metadata?.name || 'unknown',
-                                        namespace: manifest.metadata?.namespace || undefined,
-                                        apiVersion: manifest.apiVersion || 'v1',
-                                    });
-                                }
-                                catch (replaceError) {
-                                    console.error(`❌ Failed to replace resource ${resourceName}:`, replaceError);
-                                    throw replaceError;
-                                }
-                            }
-                            else {
-                                // strategy === 'fail' (default behavior)
-                                throw error;
-                            }
+                        if (getErrorStatusCode(error) === 409) {
+                            const result = await handleConflict(error, manifest, strategy, deploymentContext);
+                            allResults.push(result);
                         }
                         else {
                             // Non-conflict errors should always be thrown
@@ -169,15 +115,4 @@ export function yamlDirectory(config) {
         return closure;
     }, config.name);
 }
-/**
- * Common Git repository paths for popular controllers
- */
-export const GitPaths = {
-    fluxHelm: (version = 'main') => `git:github.com/fluxcd/helm-controller/config/default@${version}`,
-    fluxKustomize: (version = 'main') => `git:github.com/fluxcd/kustomize-controller/config/default@${version}`,
-    fluxSource: (version = 'main') => `git:github.com/fluxcd/source-controller/config/default@${version}`,
-    kro: (version = 'main') => `git:github.com/Azure/kro/config/default@${version}`,
-    argoCD: (version = 'stable') => `git:github.com/argoproj/argo-cd/manifests/install.yaml@${version}`,
-    istio: (version = 'master') => `git:github.com/istio/istio/manifests/charts/base@${version}`,
-};
 //# sourceMappingURL=yaml-directory.js.map

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":"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"}
+{"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,CAAC;wBACH,2EAA2E;wBAC3E,IAAI,iBAAiB,CAAC,YAAY,EAAE,CAAC;4BACnC,uEAAuE;4BACvE,gEAAgE;4BAChE,IAAI,iBAAiB,CAAC,aAAa,EAAE,CAAC;gCACpC,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;4BACzD,CAAC;iCAAM,CAAC;gCACN,MAAM,IAAI,yBAAyB,CACjC,iDAAiD,EACjD,MAAM,CAAC,IAAI,EACX,YAAY,CACb,CAAC;4BACJ,CAAC;wBACH,CAAC;6BAAM,IAAI,iBAAiB,CAAC,aAAa,EAAE,CAAC;4BAC3C,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;wBACzD,CAAC;6BAAM,CAAC;4BACN,MAAM,IAAI,yBAAyB,CACjC,iFAAiF,EACjF,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"}

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

@@ -1,10 +1,81 @@
+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';
 export interface YamlFileConfig {
     name: string;
+    /** Resource graph identifier. Required when `name` is dynamic (e.g. from schema references). */
+    id?: string;
     path: string;
     namespace?: string | KubernetesRef<string>;
-    deploymentStrategy?: 'replace' | 'skipIfExists' | 'fail';
+    /** @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,
+     * });
+     * ```
+     */
+    manifestTransform?: (manifest: KubernetesResource) => KubernetesResource;
+    /**
+     * Field manager name for server-side apply operations.
+     * Only used when deploymentStrategy is 'serverSideApply'.
+     * @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
+     */
+    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
+     */
+    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; }
+     *   },
+     * });
+     * ```
+     */
+    skipIfFetchFails?: (k8sApi: k8s.KubernetesObjectApi) => Promise<boolean>;
 }
 /**
  * Deploy a YAML file during deployment phase
@@ -42,16 +113,4 @@ export interface YamlFileConfig {
  * ```
  */
 export declare function yamlFile(config: YamlFileConfig): DeploymentClosure<AppliedResource[]>;
-/**
- * Simplified YAML file factory for quick usage
- * @example
- * ```typescript
- * simple.YamlFile('./manifests/configmap.yaml')
- * simple.YamlFile('git:github.com/fluxcd/flux2/manifests/install/flux-system.yaml@main', 'flux-system')
- * ```
- */
-/**
- * @deprecated Use simple.YamlFile() instead - import { simple } from 'typekro'; simple.YamlFile(...)
- */
-export declare function simpleYamlFile(path: string, namespace?: string): 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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAqB3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,kBAAkB,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAuHrF;AAED;;;;;;;GAOG;AACH;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAWtC"}
+{"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,CAoIrF"}