timonel 2.3.0 → 2.4.0

package/dist/lib/Rutter.js

@@ -1,2863 +0,0 @@
-/**
- * @fileoverview Rutter - Main class for building Kubernetes manifests and Helm charts
- * @since 1.0.0
- */
-import { App, Chart, Testing, ApiObject } from 'cdk8s';
-import YAML from 'yaml';
-import { include, helm } from './helm.js';
-import { HelmChartWriter } from './HelmChartWriter.js';
-import { SecurityUtils } from './security.js';
-/**
- * Rutter - Main class for building Kubernetes manifests and Helm charts
- *
- * Rutter (maritime pilot) guides the generation of Kubernetes resources
- * using cdk8s and outputs complete Helm charts with proper templating.
- *
- * @class Rutter
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * const rutter = new Rutter({
- *   meta: { name: 'my-app', version: '1.0.0' },
- *   defaultValues: { replicas: 3 }
- * });
- *
- * rutter.addDeployment({
- *   name: 'web',
- *   image: 'nginx:1.21',
- *   replicas: 3
- * });
- *
- * rutter.write('./charts/my-app');
- * ```
- */
-export class Rutter {
-    /**
-     * Creates a new Rutter instance
-     *
-     * @param {RutterProps} props - Configuration properties
-     * @since 1.0.0
-     */
-    constructor(props) {
-        this.assets = [];
-        this.valueOverrides = {};
-        this.props = props;
-        this.app = new App();
-        this.chart = new Chart(this.app, props.manifestName ?? props.meta.name);
-    }
-    /**
-     * Sets dynamic value overrides for Helm values
-     *
-     * Used by CLI --set flags to override default values at runtime.
-     *
-     * @param {Record<string, string>} overrides - Key-value pairs to override
-     *
-     * @example
-     * ```typescript
-     * rutter.setValues({
-     *   'image.tag': 'v2.0.0',
-     *   'replicas': '5'
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    setValues(overrides) {
-        this.valueOverrides = { ...this.valueOverrides, ...overrides };
-    }
-    /**
-     * Apply value overrides to nested object using dot notation
-     */
-    applyOverrides(values) {
-        const result = JSON.parse(JSON.stringify(values)); // Deep clone
-        for (const [key, value] of Object.entries(this.valueOverrides)) {
-            this.setNestedValue(result, key, this.parseValue(value));
-        }
-        return result;
-    }
-    setNestedValue(obj, path, value) {
-        /* eslint-disable security/detect-object-injection */
-        const keys = path.split('.').filter(Boolean);
-        if (keys.length === 0)
-            return;
-        let current = obj;
-        for (let i = 0; i < keys.length - 1; i++) {
-            const key = keys[i];
-            if (!key)
-                continue;
-            if (!(key in current) || typeof current[key] !== 'object' || current[key] === null) {
-                current[key] = {};
-            }
-            current = current[key];
-        }
-        const finalKey = keys[keys.length - 1];
-        if (finalKey) {
-            current[finalKey] = value;
-        }
-        /* eslint-enable security/detect-object-injection */
-    }
-    parseValue(value) {
-        // Try to parse as JSON first (for objects, arrays, booleans, numbers)
-        try {
-            return JSON.parse(value);
-        }
-        catch (error) {
-            // Log parsing error for debugging purposes
-            console.debug(`Failed to parse value as JSON: ${value}`, error);
-            // If not valid JSON, treat as string
-            return value;
-        }
-    }
-    /**
-     * Adds a Kubernetes Deployment to the chart
-     *
-     * @param {DeploymentSpec} spec - Deployment specification
-     * @returns {ApiObject} The created Deployment object
-     *
-     * @example
-     * ```typescript
-     * rutter.addDeployment({
-     *   name: 'web-app',
-     *   image: 'nginx:1.21',
-     *   replicas: 3,
-     *   containerPort: 80,
-     *   env: { NODE_ENV: 'production' }
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addDeployment(spec) {
-        const match = spec.matchLabels ?? {
-            [Rutter.LABEL_NAME]: include(Rutter.HELPER_NAME),
-            [Rutter.LABEL_INSTANCE]: helm.releaseName,
-        };
-        const envEntries = spec.env
-            ? Object.entries(spec.env).map(([name, value]) => ({ name, value }))
-            : undefined;
-        const envFromEntries = spec.envFrom
-            ? spec.envFrom.map((s) => ({
-                configMapRef: s.configMapRef ? { name: s.configMapRef } : undefined,
-                secretRef: s.secretRef ? { name: s.secretRef } : undefined,
-            }))
-            : undefined;
-        const volumeDefs = spec.volumes
-            ? spec.volumes.map((v) => ({
-                name: v.name,
-                configMap: v.configMap ? { name: v.configMap } : undefined,
-                secret: v.secret ? { secretName: v.secret } : undefined,
-                persistentVolumeClaim: v.persistentVolumeClaim
-                    ? { claimName: v.persistentVolumeClaim }
-                    : undefined,
-            }))
-            : undefined;
-        const volumeMountDefs = spec.volumeMounts
-            ? spec.volumeMounts.map((m) => ({
-                name: m.name,
-                mountPath: m.mountPath,
-                readOnly: m.readOnly,
-                subPath: m.subPath,
-            }))
-            : undefined;
-        const templateLabels = { ...match, ...(spec.podLabels ?? {}) };
-        const dep = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'apps/v1',
-            kind: 'Deployment',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                replicas: spec.replicas ?? 1,
-                selector: { matchLabels: match },
-                template: {
-                    metadata: {
-                        labels: templateLabels,
-                        ...(spec.podAnnotations ? { annotations: spec.podAnnotations } : {}),
-                    },
-                    spec: {
-                        serviceAccountName: spec.serviceAccountName,
-                        volumes: volumeDefs,
-                        containers: [
-                            {
-                                name: spec.name,
-                                image: spec.image,
-                                imagePullPolicy: spec.imagePullPolicy,
-                                ports: spec.containerPort ? [{ containerPort: spec.containerPort }] : undefined,
-                                env: envEntries,
-                                envFrom: envFromEntries,
-                                volumeMounts: volumeMountDefs,
-                                resources: spec.resources,
-                                livenessProbe: spec.livenessProbe,
-                                readinessProbe: spec.readinessProbe,
-                            },
-                        ],
-                    },
-                },
-            },
-        });
-        this.capture(dep, `${spec.name}-deployment`);
-        return dep;
-    }
-    /**
-     * Adds a Kubernetes Service to the chart
-     *
-     * @param {ServiceSpec} spec - Service specification
-     * @returns {ApiObject} The created Service object
-     *
-     * @example
-     * ```typescript
-     * rutter.addService({
-     *   name: 'web-service',
-     *   ports: [{ port: 80, targetPort: 8080 }],
-     *   type: 'LoadBalancer'
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addService(spec) {
-        const svc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'Service',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                type: spec.type ?? 'ClusterIP',
-                selector: spec.selector,
-                ports: spec.ports.map((p) => ({
-                    port: p.port,
-                    targetPort: p.targetPort ?? p.port,
-                    protocol: p.protocol ?? 'TCP',
-                    name: p.name,
-                    nodePort: p.nodePort,
-                })),
-                clusterIP: spec.clusterIP,
-                externalName: spec.externalName,
-                sessionAffinity: spec.sessionAffinity,
-                loadBalancerIP: spec.loadBalancerIP,
-                loadBalancerSourceRanges: spec.loadBalancerSourceRanges,
-                loadBalancerClass: spec.loadBalancerClass,
-                externalTrafficPolicy: spec.externalTrafficPolicy,
-                internalTrafficPolicy: spec.internalTrafficPolicy,
-                ipFamilyPolicy: spec.ipFamilyPolicy,
-                ipFamilies: spec.ipFamilies,
-            },
-        });
-        this.capture(svc, `${spec.name}-service`);
-        return svc;
-    }
-    addReplicaSet(spec) {
-        const match = spec.matchLabels ?? {
-            [Rutter.LABEL_NAME]: include(Rutter.HELPER_NAME),
-            [Rutter.LABEL_INSTANCE]: helm.releaseName,
-        };
-        const envEntries = spec.env
-            ? Object.entries(spec.env).map(([name, value]) => ({ name, value }))
-            : undefined;
-        const envFromEntries = spec.envFrom
-            ? spec.envFrom.map((s) => ({
-                configMapRef: s.configMapRef ? { name: s.configMapRef } : undefined,
-                secretRef: s.secretRef ? { name: s.secretRef } : undefined,
-            }))
-            : undefined;
-        const volumeDefs = spec.volumes
-            ? spec.volumes.map((v) => ({
-                name: v.name,
-                configMap: v.configMap ? { name: v.configMap } : undefined,
-                secret: v.secret ? { secretName: v.secret } : undefined,
-                persistentVolumeClaim: v.persistentVolumeClaim
-                    ? { claimName: v.persistentVolumeClaim }
-                    : undefined,
-            }))
-            : undefined;
-        const volumeMountDefs = spec.volumeMounts
-            ? spec.volumeMounts.map((m) => ({
-                name: m.name,
-                mountPath: m.mountPath,
-                readOnly: m.readOnly,
-                subPath: m.subPath,
-            }))
-            : undefined;
-        const templateLabels = { ...match, ...(spec.podLabels ?? {}) };
-        const rs = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'apps/v1',
-            kind: 'ReplicaSet',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                replicas: spec.replicas ?? 1,
-                selector: { matchLabels: match },
-                template: {
-                    metadata: {
-                        labels: templateLabels,
-                        ...(spec.podAnnotations ? { annotations: spec.podAnnotations } : {}),
-                    },
-                    spec: {
-                        serviceAccountName: spec.serviceAccountName,
-                        volumes: volumeDefs,
-                        containers: [
-                            {
-                                name: spec.name,
-                                image: spec.image,
-                                imagePullPolicy: spec.imagePullPolicy,
-                                ports: spec.containerPort ? [{ containerPort: spec.containerPort }] : undefined,
-                                env: envEntries,
-                                envFrom: envFromEntries,
-                                volumeMounts: volumeMountDefs,
-                                resources: spec.resources,
-                                livenessProbe: spec.livenessProbe,
-                                readinessProbe: spec.readinessProbe,
-                            },
-                        ],
-                    },
-                },
-            },
-        });
-        this.capture(rs, `${spec.name}-replicaset`);
-        return rs;
-    }
-    /**
-     * Adds a Kubernetes Job to the chart
-     *
-     * @param {JobSpec} spec - Job specification
-     * @returns {ApiObject} The created Job object
-     *
-     * @example
-     * ```typescript
-     * rutter.addJob({
-     *   name: 'data-migration',
-     *   image: 'migrate:latest',
-     *   command: ['./migrate.sh'],
-     *   backoffLimit: 3
-     * });
-     * ```
-     *
-     * @since 2.1.0
-     */
-    addJob(spec) {
-        // Validate Job specification
-        this.validateJobSpec(spec);
-        const { envEntries, envFromEntries, volumeDefs, volumeMountDefs } = this.buildPodEnvironment(spec);
-        const jobSpec = this.buildJobSpec(spec);
-        const podTemplate = this.buildJobPodTemplate(spec, envEntries, envFromEntries, volumeDefs, volumeMountDefs);
-        const job = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'batch/v1',
-            kind: 'Job',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                ...jobSpec,
-                template: podTemplate,
-            },
-        });
-        this.capture(job, `${spec.name}-job`);
-        return job;
-    }
-    /**
-     * Adds a Kubernetes CronJob to the chart
-     *
-     * @param {CronJobSpec} spec - CronJob specification
-     * @returns {ApiObject} The created CronJob object
-     *
-     * @example
-     * ```typescript
-     * rutter.addCronJob({
-     *   name: 'backup-job',
-     *   schedule: '0 2 * * *',
-     *   image: 'backup:latest',
-     *   command: ['./backup.sh']
-     * });
-     * ```
-     *
-     * @since 2.1.0
-     */
-    addCronJob(spec) {
-        // Validate CronJob specification
-        this.validateCronJobSpec(spec);
-        const { envEntries, envFromEntries, volumeDefs, volumeMountDefs } = this.buildPodEnvironment(spec);
-        const cronJobSpec = this.buildCronJobSpec(spec);
-        const jobTemplate = this.buildCronJobTemplate(spec, envEntries, envFromEntries, volumeDefs, volumeMountDefs);
-        const cronJob = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'batch/v1',
-            kind: 'CronJob',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                ...cronJobSpec,
-                jobTemplate,
-            },
-        });
-        this.capture(cronJob, `${spec.name}-cronjob`);
-        return cronJob;
-    }
-    /**
-     * Adds a Kubernetes Ingress to the chart
-     *
-     * @param {IngressSpec} spec - Ingress specification
-     * @returns {ApiObject} The created Ingress object
-     *
-     * @example
-     * ```typescript
-     * rutter.addIngress({
-     *   name: 'web-ingress',
-     *   rules: [{
-     *     host: 'example.com',
-     *     paths: [{
-     *       path: '/',
-     *       pathType: 'Prefix',
-     *       backend: { service: { name: 'web-service', port: { number: 80 } } }
-     *     }]
-     *   }]
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addIngress(spec) {
-        const ing = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.NETWORKING_API_VERSION,
-            kind: 'Ingress',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                ingressClassName: spec.ingressClassName,
-                defaultBackend: spec.defaultBackend,
-                tls: spec.tls,
-                rules: spec.rules.map((rule) => ({
-                    host: rule.host,
-                    http: {
-                        paths: rule.paths.map((path) => ({
-                            path: path.path,
-                            pathType: path.pathType,
-                            backend: path.backend,
-                        })),
-                    },
-                })),
-            },
-        });
-        this.capture(ing, `${spec.name}-ingress`);
-        return ing;
-    }
-    addPersistentVolume(spec) {
-        // Apply cloud provider optimizations
-        const optimizedSpec = this.optimizePVForCloud(spec);
-        const pvSpec = {
-            capacity: { storage: optimizedSpec.capacity },
-            accessModes: optimizedSpec.accessModes,
-            storageClassName: optimizedSpec.storageClassName,
-            volumeMode: optimizedSpec.volumeMode,
-            persistentVolumeReclaimPolicy: optimizedSpec.reclaimPolicy,
-            mountOptions: optimizedSpec.mountOptions,
-            nodeAffinity: optimizedSpec.nodeAffinity,
-            claimRef: optimizedSpec.claimRef,
-        };
-        // Handle known volume sources with validation
-        const knownSources = [
-            'csi',
-            'nfs',
-            'awsElasticBlockStore',
-            'hostPath',
-            'azureDisk',
-            'azureFile',
-            'gcePersistentDisk',
-        ];
-        let sourceCount = 0;
-        for (const sourceType of knownSources) {
-            // eslint-disable-next-line security/detect-object-injection -- Safe: sourceType is from known const array
-            const sourceValue = optimizedSpec.source[sourceType];
-            if (sourceValue) {
-                // eslint-disable-next-line security/detect-object-injection -- Safe: sourceType is from known const array
-                pvSpec[sourceType] = sourceValue;
-                sourceCount++;
-            }
-        }
-        // Validate single volume source
-        if (sourceCount === 0) {
-            throw new Error(`PersistentVolume ${spec.name}: No volume source specified`);
-        }
-        if (sourceCount > 1) {
-            throw new Error(`PersistentVolume ${spec.name}: Multiple volume sources specified, only one allowed`);
-        }
-        // Handle custom volume sources
-        for (const [key, value] of Object.entries(optimizedSpec.source)) {
-            if (!knownSources.includes(key) && value !== undefined) {
-                // eslint-disable-next-line security/detect-object-injection -- Safe: controlled object construction
-                pvSpec[key] = value;
-            }
-        }
-        const pv = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolume',
-            metadata: {
-                name: spec.name,
-                ...(optimizedSpec.labels ? { labels: optimizedSpec.labels } : {}),
-                ...(optimizedSpec.annotations ? { annotations: optimizedSpec.annotations } : {}),
-            },
-            spec: pvSpec,
-        });
-        this.capture(pv, `${spec.name}-pv`);
-        return pv;
-    }
-    optimizePVForCloud(spec) {
-        const optimized = { ...spec };
-        const EBS_CSI_DRIVER = 'ebs.csi.aws.com';
-        // Apply cloud-specific optimizations
-        if (spec.cloudProvider === 'aws') {
-            optimized.annotations = {
-                ...optimized.annotations,
-                'volume.beta.kubernetes.io/storage-provisioner': EBS_CSI_DRIVER,
-            };
-            // Default to gp3 for better performance/cost
-            if (spec.source.csi?.driver === EBS_CSI_DRIVER && optimized.source.csi) {
-                optimized.source.csi.volumeAttributes = {
-                    type: 'gp3',
-                    ...spec.source.csi.volumeAttributes,
-                };
-            }
-        }
-        else if (spec.cloudProvider === 'azure') {
-            optimized.annotations = {
-                ...optimized.annotations,
-                [Rutter.AZURE_DISK_PROVISIONER_ANNOTATION]: Rutter.AZURE_DISK_CSI_DRIVER,
-            };
-            // Default to Premium_ZRS for multi-zone clusters
-            if (spec.source.csi?.driver === Rutter.AZURE_DISK_CSI_DRIVER && optimized.source.csi) {
-                optimized.source.csi.volumeAttributes = {
-                    skuName: 'Premium_ZRS',
-                    ...spec.source.csi.volumeAttributes,
-                };
-            }
-        }
-        else if (spec.cloudProvider === 'gcp') {
-            optimized.annotations = {
-                ...optimized.annotations,
-                'volume.beta.kubernetes.io/storage-provisioner': 'pd.csi.storage.gke.io',
-            };
-        }
-        // Set sensible defaults
-        optimized.reclaimPolicy = optimized.reclaimPolicy ?? 'Delete';
-        optimized.volumeMode = optimized.volumeMode ?? 'Filesystem';
-        return optimized;
-    }
-    addPersistentVolumeClaim(spec) {
-        // Validate access modes compatibility
-        this.validatePVCAccessModes(spec);
-        const pvc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolumeClaim',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                accessModes: spec.accessModes,
-                resources: spec.resources,
-                storageClassName: spec.storageClassName,
-                volumeMode: spec.volumeMode ?? 'Filesystem',
-                selector: spec.selector,
-                volumeName: spec.volumeName,
-            },
-        });
-        this.capture(pvc, `${spec.name}-pvc`);
-        return pvc;
-    }
-    validatePVCAccessModes(spec) {
-        const { accessModes, storageClassName } = spec;
-        // Validate ReadWriteOncePod (K8s 1.22+)
-        if (accessModes.includes('ReadWriteOncePod') && accessModes.length > 1) {
-            throw new Error(`PVC ${spec.name}: ReadWriteOncePod cannot be combined with other access modes`);
-        }
-        // Warn about common misconfigurations
-        if (storageClassName?.includes('azure-disk') && accessModes.includes('ReadWriteMany')) {
-            console.warn(SecurityUtils.sanitizeLogMessage(`PVC ${spec.name}: Azure Disk does not support ReadWriteMany, consider Azure Files`));
-        }
-        if (storageClassName?.includes('ebs') && accessModes.includes('ReadWriteMany')) {
-            console.warn(SecurityUtils.sanitizeLogMessage(`PVC ${spec.name}: EBS does not support ReadWriteMany, consider EFS`));
-        }
-    }
-    /**
-     * Adds a Kubernetes ConfigMap to the chart
-     *
-     * @param {ConfigMapSpec} spec - ConfigMap specification
-     * @returns {ApiObject} The created ConfigMap object
-     *
-     * @example
-     * ```typescript
-     * rutter.addConfigMap({
-     *   name: 'app-config',
-     *   data: {
-     *     'config.yaml': 'key: value',
-     *     'app.properties': 'debug=true'
-     *   }
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addConfigMap(spec) {
-        const cm = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'ConfigMap',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            data: spec.data,
-            binaryData: spec.binaryData,
-            immutable: spec.immutable,
-        });
-        this.capture(cm, `${spec.name}-configmap`);
-        return cm;
-    }
-    /**
-     * Adds a Kubernetes Secret to the chart
-     *
-     * @param {SecretSpec} spec - Secret specification
-     * @returns {ApiObject} The created Secret object
-     *
-     * @example
-     * ```typescript
-     * rutter.addSecret({
-     *   name: 'app-secrets',
-     *   stringData: {
-     *     'username': 'admin',
-     *     'password': 'secret123'
-     *   }
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addSecret(spec) {
-        const sec = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'Secret',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            type: spec.type ?? 'Opaque',
-            stringData: spec.stringData,
-            data: spec.data,
-            immutable: spec.immutable,
-        });
-        this.capture(sec, `${spec.name}-secret`);
-        return sec;
-    }
-    /**
-     * Adds a Kubernetes ServiceAccount to the chart
-     *
-     * @param {ServiceAccountSpec} spec - ServiceAccount specification
-     * @returns {ApiObject} The created ServiceAccount object
-     *
-     * @example
-     * ```typescript
-     * rutter.addServiceAccount({
-     *   name: 'app-sa',
-     *   awsRoleArn: 'arn:aws:iam::123456789012:role/MyRole',
-     *   automountServiceAccountToken: true
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addServiceAccount(spec) {
-        const annotations = this.buildServiceAccountAnnotations(spec);
-        const sa = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'ServiceAccount',
-            metadata: {
-                name: spec.name,
-                ...(Object.keys(annotations).length ? { annotations } : {}),
-                ...(spec.labels ? { labels: spec.labels } : {}),
-            },
-            automountServiceAccountToken: spec.automountServiceAccountToken,
-            imagePullSecrets: spec.imagePullSecrets?.map((n) => ({ name: n })),
-            secrets: spec.secrets?.map((n) => ({ name: n })),
-        });
-        this.capture(sa, `${spec.name}-serviceaccount`);
-        return sa;
-    }
-    buildServiceAccountAnnotations(spec) {
-        const annotations = {
-            ...(spec.annotations ?? {}),
-        };
-        this.addAWSIRSAAnnotations(annotations, spec);
-        this.addAzureWorkloadIdentityAnnotations(annotations, spec);
-        this.addGCPWorkloadIdentityAnnotations(annotations, spec);
-        return annotations;
-    }
-    addAWSIRSAAnnotations(annotations, spec) {
-        if (spec.awsRoleArn) {
-            annotations['eks.amazonaws.com/role-arn'] = spec.awsRoleArn;
-        }
-        if (spec.awsAudience) {
-            annotations['eks.amazonaws.com/audience'] = spec.awsAudience;
-        }
-        if (spec.awsStsEndpointType) {
-            annotations['eks.amazonaws.com/sts-regional-endpoints'] = spec.awsStsEndpointType;
-        }
-        if (spec.awsTokenExpiration !== undefined) {
-            annotations['eks.amazonaws.com/token-expiration'] = String(spec.awsTokenExpiration);
-        }
-    }
-    addAzureWorkloadIdentityAnnotations(annotations, spec) {
-        if (spec.azureClientId) {
-            annotations['azure.workload.identity/client-id'] = spec.azureClientId;
-        }
-        if (spec.azureTenantId) {
-            annotations['azure.workload.identity/tenant-id'] = spec.azureTenantId;
-        }
-        if (spec.azureServiceAccountTokenExpiration !== undefined) {
-            annotations['azure.workload.identity/service-account-token-expiration'] = String(spec.azureServiceAccountTokenExpiration);
-        }
-    }
-    addGCPWorkloadIdentityAnnotations(annotations, spec) {
-        if (spec.gcpServiceAccountEmail) {
-            annotations['iam.gke.io/gcp-service-account'] = spec.gcpServiceAccountEmail;
-        }
-    }
-    /**
-     * Adds a Kubernetes HorizontalPodAutoscaler to the chart
-     *
-     * @param {HorizontalPodAutoscalerSpec} spec - HPA specification
-     * @returns {ApiObject} The created HPA object
-     *
-     * @example
-     * ```typescript
-     * rutter.addHorizontalPodAutoscaler({
-     *   name: 'web-hpa',
-     *   scaleTargetRef: {
-     *     apiVersion: 'apps/v1',
-     *     kind: 'Deployment',
-     *     name: 'web-app'
-     *   },
-     *   minReplicas: 2,
-     *   maxReplicas: 10
-     * });
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addHorizontalPodAutoscaler(spec) {
-        // Default metrics if none provided (CPU utilization at 80%)
-        const defaultMetrics = [
-            {
-                type: 'Resource',
-                resource: {
-                    name: 'cpu',
-                    target: {
-                        type: 'Utilization',
-                        averageUtilization: 80,
-                    },
-                },
-            },
-        ];
-        const hpa = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'autoscaling/v2',
-            kind: 'HorizontalPodAutoscaler',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                scaleTargetRef: spec.scaleTargetRef,
-                minReplicas: spec.minReplicas ?? 1,
-                maxReplicas: spec.maxReplicas,
-                metrics: spec.metrics ?? defaultMetrics,
-                ...(spec.behavior ? { behavior: spec.behavior } : {}),
-            },
-        });
-        this.capture(hpa, `${spec.name}-hpa`);
-        return hpa;
-    }
-    addVerticalPodAutoscaler(spec) {
-        const vpa = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'autoscaling.k8s.io/v1',
-            kind: 'VerticalPodAutoscaler',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                targetRef: spec.targetRef,
-                updatePolicy: spec.updatePolicy ?? { updateMode: 'Auto' },
-                ...(spec.resourcePolicy ? { resourcePolicy: spec.resourcePolicy } : {}),
-                ...(spec.recommenders ? { recommenders: spec.recommenders } : {}),
-            },
-        });
-        this.capture(vpa, `${spec.name}-vpa`);
-        return vpa;
-    }
-    addPodDisruptionBudget(spec) {
-        const pdb = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'policy/v1',
-            kind: 'PodDisruptionBudget',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                ...(spec.minAvailable !== undefined ? { minAvailable: spec.minAvailable } : {}),
-                ...(spec.maxUnavailable !== undefined ? { maxUnavailable: spec.maxUnavailable } : {}),
-                selector: spec.selector,
-            },
-        });
-        this.capture(pdb, `${spec.name}-pdb`);
-        return pdb;
-    }
-    addAWSEBSStorageClass(spec) {
-        const DEFAULT_VOLUME_TYPE = 'gp3';
-        const parameters = {
-            type: spec.volumeType ?? DEFAULT_VOLUME_TYPE,
-            fsType: spec.fsType ?? 'ext4',
-            encrypted: String(spec.encrypted ?? true),
-        };
-        if (spec.kmsKeyId) {
-            parameters['kmsKeyId'] = spec.kmsKeyId;
-        }
-        const IOPS_SUPPORTED_TYPES = ['gp3', 'io1', 'io2'];
-        if (spec.iops && IOPS_SUPPORTED_TYPES.includes(spec.volumeType ?? DEFAULT_VOLUME_TYPE)) {
-            parameters['iops'] = String(spec.iops);
-        }
-        if (spec.throughput && spec.volumeType === DEFAULT_VOLUME_TYPE) {
-            parameters['throughput'] = String(spec.throughput);
-        }
-        const sc = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.STORAGE_API_VERSION,
-            kind: 'StorageClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            provisioner: 'ebs.csi.aws.com',
-            parameters,
-            reclaimPolicy: spec.reclaimPolicy ?? 'Delete',
-            allowVolumeExpansion: spec.allowVolumeExpansion ?? true,
-            volumeBindingMode: spec.volumeBindingMode ?? 'WaitForFirstConsumer',
-        });
-        this.capture(sc, `${spec.name}-storageclass`);
-        return sc;
-    }
-    addAWSEBSPersistentVolumeClaim(spec) {
-        const pvc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolumeClaim',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                accessModes: spec.accessModes ?? ['ReadWriteOnce'],
-                storageClassName: spec.storageClassName,
-                resources: {
-                    requests: {
-                        storage: spec.size,
-                    },
-                },
-            },
-        });
-        this.capture(pvc, `${spec.name}-pvc`);
-        return pvc;
-    }
-    addAWSEFSStorageClass(spec) {
-        const sc = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.STORAGE_API_VERSION,
-            kind: 'StorageClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            provisioner: 'efs.csi.aws.com',
-            reclaimPolicy: spec.reclaimPolicy ?? 'Delete',
-            volumeBindingMode: spec.volumeBindingMode ?? 'Immediate',
-        });
-        this.capture(sc, `${spec.name}-storageclass`);
-        return sc;
-    }
-    addAWSEFSPersistentVolume(spec) {
-        const csiSpec = {
-            driver: 'efs.csi.aws.com',
-            volumeHandle: spec.fileSystemId,
-        };
-        if (spec.accessPoint) {
-            csiSpec['volumeHandle'] = `${spec.fileSystemId}::${spec.accessPoint}`;
-        }
-        const volumeAttributes = {};
-        if (spec.directoryPerms) {
-            volumeAttributes['directoryPerms'] = spec.directoryPerms;
-        }
-        if (spec.gidRangeStart !== undefined) {
-            volumeAttributes['gidRangeStart'] = String(spec.gidRangeStart);
-        }
-        if (spec.gidRangeEnd !== undefined) {
-            volumeAttributes['gidRangeEnd'] = String(spec.gidRangeEnd);
-        }
-        if (spec.basePath) {
-            volumeAttributes['basePath'] = spec.basePath;
-        }
-        if (spec.subPath) {
-            volumeAttributes['subPath'] = spec.subPath;
-        }
-        // Only add volumeAttributes if it has properties (more efficient than Object.keys().length)
-        for (const key in volumeAttributes) {
-            if (Object.prototype.hasOwnProperty.call(volumeAttributes, key)) {
-                csiSpec['volumeAttributes'] = volumeAttributes;
-                break;
-            }
-        }
-        const pv = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolume',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                capacity: {
-                    storage: spec.capacity ?? '5Gi',
-                },
-                accessModes: spec.accessModes ?? ['ReadWriteMany'],
-                persistentVolumeReclaimPolicy: 'Retain',
-                storageClassName: spec.storageClassName,
-                csi: csiSpec,
-            },
-        });
-        this.capture(pv, `${spec.name}-pv`);
-        return pv;
-    }
-    addAWSEFSPersistentVolumeClaim(spec) {
-        const pvc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolumeClaim',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                accessModes: spec.accessModes ?? ['ReadWriteMany'],
-                storageClassName: spec.storageClassName,
-                resources: {
-                    requests: {
-                        storage: spec.size ?? '5Gi',
-                    },
-                },
-            },
-        });
-        this.capture(pvc, `${spec.name}-pvc`);
-        return pvc;
-    }
-    addAWSALBIngress(spec) {
-        const annotations = this.buildALBAnnotations(spec);
-        const ingress = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.NETWORKING_API_VERSION,
-            kind: 'Ingress',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                annotations,
-            },
-            spec: {
-                tls: spec.tls,
-                rules: spec.rules.map((rule) => ({
-                    host: rule.host,
-                    http: {
-                        paths: rule.paths.map((path) => ({
-                            path: path.path,
-                            pathType: path.pathType,
-                            backend: path.backend,
-                        })),
-                    },
-                })),
-            },
-        });
-        this.capture(ingress, `${spec.name}-ingress`);
-        return ingress;
-    }
-    buildALBAnnotations(spec) {
-        const annotations = {
-            'kubernetes.io/ingress.class': 'alb',
-            'alb.ingress.kubernetes.io/scheme': spec.scheme ?? 'internet-facing',
-            'alb.ingress.kubernetes.io/target-type': spec.targetType ?? 'ip',
-            ...(spec.annotations ?? {}),
-        };
-        this.addOptionalALBAnnotations(annotations, spec);
-        this.addHealthCheckAnnotations(annotations, spec);
-        this.addTagsAnnotation(annotations, spec);
-        return annotations;
-    }
-    addOptionalALBAnnotations(annotations, spec) {
-        if (spec.ipAddressType) {
-            annotations['alb.ingress.kubernetes.io/ip-address-type'] = spec.ipAddressType;
-        }
-        if (spec.groupName) {
-            annotations['alb.ingress.kubernetes.io/group.name'] = spec.groupName;
-        }
-        if (spec.groupOrder !== undefined) {
-            annotations['alb.ingress.kubernetes.io/group.order'] = String(spec.groupOrder);
-        }
-        if (spec.subnets && spec.subnets.length > 0) {
-            annotations['alb.ingress.kubernetes.io/subnets'] = spec.subnets.join(',');
-        }
-        if (spec.securityGroups && spec.securityGroups.length > 0) {
-            annotations['alb.ingress.kubernetes.io/security-groups'] = spec.securityGroups.join(',');
-        }
-        if (spec.certificateArn) {
-            annotations['alb.ingress.kubernetes.io/certificate-arn'] = spec.certificateArn;
-        }
-        if (spec.sslRedirect) {
-            annotations['alb.ingress.kubernetes.io/ssl-redirect'] = '443';
-        }
-    }
-    addHealthCheckAnnotations(annotations, spec) {
-        if (spec.healthCheckPath) {
-            annotations['alb.ingress.kubernetes.io/healthcheck-path'] = spec.healthCheckPath;
-        }
-        if (spec.healthCheckIntervalSeconds !== undefined) {
-            annotations['alb.ingress.kubernetes.io/healthcheck-interval-seconds'] = String(spec.healthCheckIntervalSeconds);
-        }
-        if (spec.healthCheckTimeoutSeconds !== undefined) {
-            annotations['alb.ingress.kubernetes.io/healthcheck-timeout-seconds'] = String(spec.healthCheckTimeoutSeconds);
-        }
-        if (spec.healthyThresholdCount !== undefined) {
-            annotations['alb.ingress.kubernetes.io/healthy-threshold-count'] = String(spec.healthyThresholdCount);
-        }
-        if (spec.unhealthyThresholdCount !== undefined) {
-            annotations['alb.ingress.kubernetes.io/unhealthy-threshold-count'] = String(spec.unhealthyThresholdCount);
-        }
-    }
-    addTagsAnnotation(annotations, spec) {
-        if (spec.tags && Object.keys(spec.tags).length > 0) {
-            const tagString = this.formatCloudResourceTags(spec.tags);
-            annotations['alb.ingress.kubernetes.io/tags'] = tagString;
-        }
-    }
-    /**
-     * Add Azure Application Gateway Ingress Controller (AGIC) Ingress.
-     * Creates an Ingress resource with AGIC-specific annotations for AKS deployments.
-     *
-     * @param spec - AGIC Ingress specification
-     * @returns The created Ingress ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addAzureAGICIngress({
-     *   name: 'app-ingress',
-     *   rules: [{
-     *     host: 'app.example.com',
-     *     paths: [{
-     *       path: '/',
-     *       pathType: 'Prefix',
-     *       backend: { service: { name: 'app-service', port: { number: 80 } } }
-     *     }]
-     *   }],
-     *   sslRedirect: true,
-     *   backendProtocol: 'https',
-     *   healthProbePath: '/health'
-     * });
-     * ```
-     */
-    addAzureAGICIngress(spec) {
-        this.validateAGICHealthProbeParams(spec);
-        this.validateAGICSecurityParams(spec);
-        this.validateAGICAnnotationConsistency(spec);
-        const annotations = this.buildAGICAnnotations(spec);
-        const ingress = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.NETWORKING_API_VERSION,
-            kind: 'Ingress',
-            metadata: {
-                name: spec.name,
-                annotations,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-            },
-            spec: {
-                tls: spec.tls,
-                rules: spec.rules.map((rule) => ({
-                    host: rule.host,
-                    http: {
-                        paths: rule.paths.map((path) => ({
-                            path: path.path,
-                            pathType: path.pathType,
-                            backend: path.backend,
-                        })),
-                    },
-                })),
-            },
-        });
-        this.capture(ingress, `${spec.name}-ingress`);
-        return ingress;
-    }
-    buildAGICAnnotations(spec) {
-        const annotations = {
-            'kubernetes.io/ingress.class': 'azure/application-gateway',
-            ...(spec.annotations ?? {}),
-        };
-        this.addAGICPathAnnotations(annotations, spec);
-        this.addAGICProtocolAnnotations(annotations, spec);
-        this.addAGICHealthProbeAnnotations(annotations, spec);
-        this.addAGICConnectionAnnotations(annotations, spec);
-        this.addAGICSecurityAnnotations(annotations, spec);
-        this.addAGICAdvancedAnnotations(annotations, spec);
-        return annotations;
-    }
-    addAGICPathAnnotations(annotations, spec) {
-        if (spec.backendPathPrefix) {
-            annotations['appgw.ingress.kubernetes.io/backend-path-prefix'] = spec.backendPathPrefix;
-        }
-        if (spec.backendHostname) {
-            annotations['appgw.ingress.kubernetes.io/backend-hostname'] = spec.backendHostname;
-        }
-    }
-    addAGICProtocolAnnotations(annotations, spec) {
-        if (spec.backendProtocol) {
-            annotations['appgw.ingress.kubernetes.io/backend-protocol'] = spec.backendProtocol;
-        }
-        if (spec.sslRedirect) {
-            annotations['appgw.ingress.kubernetes.io/ssl-redirect'] = 'true';
-        }
-        if (spec.usePrivateIp) {
-            annotations['appgw.ingress.kubernetes.io/use-private-ip'] = 'true';
-        }
-        if (spec.overrideFrontendPort !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/override-frontend-port'] = String(spec.overrideFrontendPort);
-        }
-    }
-    addAGICHealthProbeAnnotations(annotations, spec) {
-        if (spec.healthProbeHostname) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-hostname'] = spec.healthProbeHostname;
-        }
-        if (spec.healthProbePort !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-port'] = String(spec.healthProbePort);
-        }
-        if (spec.healthProbePath) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-path'] = spec.healthProbePath;
-        }
-        if (spec.healthProbeStatusCodes) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-status-codes'] =
-                spec.healthProbeStatusCodes;
-        }
-        if (spec.healthProbeInterval !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-interval'] = String(spec.healthProbeInterval);
-        }
-        if (spec.healthProbeTimeout !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-timeout'] = String(spec.healthProbeTimeout);
-        }
-        if (spec.healthProbeUnhealthyThreshold !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/health-probe-unhealthy-threshold'] = String(spec.healthProbeUnhealthyThreshold);
-        }
-    }
-    addAGICConnectionAnnotations(annotations, spec) {
-        if (spec.cookieBasedAffinity) {
-            annotations['appgw.ingress.kubernetes.io/cookie-based-affinity'] = 'true';
-        }
-        if (spec.requestTimeout !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/request-timeout'] = String(spec.requestTimeout);
-        }
-        if (spec.connectionDraining) {
-            annotations['appgw.ingress.kubernetes.io/connection-draining'] = 'true';
-        }
-        if (spec.connectionDrainingTimeout !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/connection-draining-timeout'] = String(spec.connectionDrainingTimeout);
-        }
-    }
-    addAGICSecurityAnnotations(annotations, spec) {
-        if (spec.appgwSslCertificate) {
-            annotations['appgw.ingress.kubernetes.io/appgw-ssl-certificate'] = spec.appgwSslCertificate;
-        }
-        if (spec.appgwSslProfile) {
-            annotations['appgw.ingress.kubernetes.io/appgw-ssl-profile'] = spec.appgwSslProfile;
-        }
-        if (spec.appgwTrustedRootCertificate && spec.appgwTrustedRootCertificate.length > 0) {
-            annotations['appgw.ingress.kubernetes.io/appgw-trusted-root-certificate'] =
-                spec.appgwTrustedRootCertificate.join(',');
-        }
-        if (spec.wafPolicyForPath) {
-            annotations['appgw.ingress.kubernetes.io/waf-policy-for-path'] = spec.wafPolicyForPath;
-        }
-    }
-    addAGICAdvancedAnnotations(annotations, spec) {
-        if (spec.hostnameExtension && spec.hostnameExtension.length > 0) {
-            annotations['appgw.ingress.kubernetes.io/hostname-extension'] =
-                spec.hostnameExtension.join(', ');
-        }
-        if (spec.rewriteRuleSet) {
-            annotations['appgw.ingress.kubernetes.io/rewrite-rule-set'] = spec.rewriteRuleSet;
-        }
-        if (spec.rulePriority !== undefined) {
-            annotations['appgw.ingress.kubernetes.io/rule-priority'] = String(spec.rulePriority);
-        }
-    }
-    addAWSIRSAServiceAccount(spec) {
-        const annotations = {
-            'eks.amazonaws.com/role-arn': spec.roleArn,
-            ...(spec.audience ? { 'eks.amazonaws.com/audience': spec.audience } : {}),
-            ...(spec.stsEndpointType
-                ? { 'eks.amazonaws.com/sts-regional-endpoints': spec.stsEndpointType }
-                : { 'eks.amazonaws.com/sts-regional-endpoints': 'regional' }),
-            ...(spec.tokenExpiration !== undefined
-                ? { 'eks.amazonaws.com/token-expiration': String(spec.tokenExpiration) }
-                : {}),
-            ...(spec.annotations ?? {}),
-        };
-        const sa = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'ServiceAccount',
-            metadata: {
-                name: spec.name,
-                annotations,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-            },
-            automountServiceAccountToken: spec.automountServiceAccountToken,
-            imagePullSecrets: spec.imagePullSecrets?.map((n) => ({ name: n })),
-            secrets: spec.secrets?.map((n) => ({ name: n })),
-        });
-        this.capture(sa, `${spec.name}-serviceaccount`);
-        return sa;
-    }
-    addAWSSecretProviderClass(spec) {
-        const objects = spec.objects.map((obj) => {
-            const baseObj = {
-                objectName: obj.objectName,
-                objectType: obj.objectType,
-            };
-            if ('objectAlias' in obj && obj.objectAlias) {
-                baseObj['objectAlias'] = obj.objectAlias;
-            }
-            if ('jmesPath' in obj && obj.jmesPath) {
-                baseObj['jmesPath'] = obj.jmesPath;
-            }
-            return baseObj;
-        });
-        const objectsYaml = YAML.stringify(objects, { indent: 2 }).trim();
-        const parameters = {
-            objects: `|\n  ${objectsYaml.split('\n').join('\n  ')}`,
-        };
-        if (spec.region) {
-            parameters['region'] = spec.region;
-        }
-        const spc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'secrets-store.csi.x-k8s.io/v1',
-            kind: 'SecretProviderClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                provider: 'aws',
-                parameters,
-            },
-        });
-        this.capture(spc, `${spec.name}-secretproviderclass`);
-        return spc;
-    }
-    /**
-     * Add Azure Workload Identity ServiceAccount.
-     * Creates a ServiceAccount with Azure Workload Identity annotations for secure authentication.
-     *
-     * @param spec - Azure Workload Identity ServiceAccount specification
-     * @returns The created ServiceAccount ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addAzureWorkloadIdentityServiceAccount({
-     *   name: 'workload-identity-sa',
-     *   clientId: '12345678-1234-1234-1234-123456789012',
-     *   tenantId: '87654321-4321-4321-4321-210987654321',
-     *   tokenExpiration: 3600
-     * });
-     * ```
-     */
-    addAzureWorkloadIdentityServiceAccount(spec) {
-        // Validate all inputs first for security
-        if (spec.tokenExpiration !== undefined &&
-            (spec.tokenExpiration < 3600 || spec.tokenExpiration > 86400)) {
-            throw new Error(`Azure Workload Identity ${spec.name}: tokenExpiration must be between 3600 and 86400 seconds`);
-        }
-        if (!spec.clientId?.match(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)) {
-            throw new Error(`Azure Workload Identity ${spec.name}: Invalid client ID format`);
-        }
-        if (!spec.tenantId?.match(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)) {
-            throw new Error(`Azure Workload Identity ${spec.name}: Invalid tenant ID format`);
-        }
-        const annotations = {
-            'azure.workload.identity/client-id': spec.clientId,
-            'azure.workload.identity/tenant-id': spec.tenantId,
-            ...(spec.tokenExpiration !== undefined
-                ? {
-                    'azure.workload.identity/service-account-token-expiration': String(spec.tokenExpiration),
-                }
-                : {}),
-            ...(spec.annotations ?? {}),
-        };
-        const sa = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'ServiceAccount',
-            metadata: {
-                name: spec.name,
-                annotations,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-            },
-            automountServiceAccountToken: spec.automountServiceAccountToken,
-            imagePullSecrets: spec.imagePullSecrets?.map((n) => ({ name: n })),
-            secrets: spec.secrets?.map((n) => ({ name: n })),
-        });
-        this.capture(sa, `${spec.name}-serviceaccount`);
-        return sa;
-    }
-    /**
-     * Add Azure Key Vault SecretProviderClass.
-     * Creates a SecretProviderClass for mounting secrets from Azure Key Vault using CSI driver.
-     *
-     * @param spec - Azure Key Vault SecretProviderClass specification
-     * @returns The created SecretProviderClass ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addAzureKeyVaultSecretProviderClass({
-     *   name: 'app-secrets',
-     *   keyVaultName: 'my-keyvault',
-     *   tenantId: '87654321-4321-4321-4321-210987654321',
-     *   objects: [
-     *     { objectName: 'database-password', objectType: 'secret' },
-     *     { objectName: 'api-key', objectType: 'secret', objectAlias: 'API_KEY' }
-     *   ],
-     *   userAssignedIdentityID: '12345678-1234-1234-1234-123456789012'
-     * });
-     * ```
-     */
-    addAzureKeyVaultSecretProviderClass(spec) {
-        // Validate object names for security - prevent path traversal attacks
-        spec.objects.forEach((obj) => {
-            if (obj.objectName.includes('../') || obj.objectName.includes('..\\')) {
-                throw new Error(`Azure Key Vault ${spec.name}: Object name '${obj.objectName}' contains invalid path traversal sequences`);
-            }
-        });
-        const objects = spec.objects.map((obj) => {
-            const baseObj = {
-                objectName: obj.objectName,
-                objectType: obj.objectType,
-            };
-            if (obj.objectAlias) {
-                baseObj['objectAlias'] = obj.objectAlias;
-            }
-            if (obj.objectVersion) {
-                baseObj['objectVersion'] = obj.objectVersion;
-            }
-            return baseObj;
-        });
-        const objectsYaml = YAML.stringify(objects, { indent: 2 }).trim();
-        const parameters = {
-            keyvaultName: spec.keyVaultName,
-            tenantId: spec.tenantId,
-            objects: `|\n  ${objectsYaml.split('\n').join('\n  ')}`,
-        };
-        if (spec.userAssignedIdentityID) {
-            parameters['userAssignedIdentityID'] = spec.userAssignedIdentityID;
-        }
-        if (spec.cloudName) {
-            parameters['cloudName'] = spec.cloudName;
-        }
-        const spc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'secrets-store.csi.x-k8s.io/v1',
-            kind: 'SecretProviderClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                provider: 'azure',
-                parameters,
-            },
-        });
-        this.capture(spc, `${spec.name}-secretproviderclass`);
-        return spc;
-    }
-    /**
-     * Add Azure Files StorageClass.
-     * Creates a StorageClass for dynamic provisioning of Azure Files volumes.
-     *
-     * @param spec - Azure Files StorageClass specification
-     * @returns The created StorageClass ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addAzureFilesStorageClass({
-     *   name: 'azure-files-premium',
-     *   skuName: 'Premium_LRS',
-     *   protocol: 'smb',
-     *   allowSharedAccess: true
-     * });
-     * ```
-     */
-    addAzureFilesStorageClass(spec) {
-        // Validate Azure Files parameters for security and compliance
-        this.validateAzureFilesParameters(spec);
-        const parameters = this.buildAzureFilesParameters(spec);
-        const sc = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.STORAGE_API_VERSION,
-            kind: 'StorageClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            provisioner: Rutter.AZURE_FILES_CSI_DRIVER,
-            parameters,
-            reclaimPolicy: spec.reclaimPolicy ?? 'Delete',
-            allowVolumeExpansion: spec.allowVolumeExpansion ?? true,
-            volumeBindingMode: spec.volumeBindingMode ?? 'Immediate',
-            ...(spec.mountOptions ? { mountOptions: spec.mountOptions } : {}),
-        });
-        this.capture(sc, `${spec.name}-storageclass`);
-        return sc;
-    }
-    /**
-     * Add Azure Files PersistentVolume.
-     * Creates a PersistentVolume for static Azure Files volume provisioning.
-     *
-     * @param spec - Azure Files PersistentVolume specification
-     * @returns The created PersistentVolume ApiObject
-     */
-    addAzureFilesPersistentVolume(spec) {
-        const csiSpec = this.buildAzureFilesPVCSISpec(spec);
-        const pv = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolume',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                capacity: { storage: spec.capacity },
-                accessModes: spec.accessModes ?? ['ReadWriteMany'],
-                persistentVolumeReclaimPolicy: spec.reclaimPolicy ?? 'Retain',
-                storageClassName: spec.storageClassName,
-                ...(spec.mountOptions ? { mountOptions: spec.mountOptions } : {}),
-                csi: csiSpec,
-            },
-        });
-        this.capture(pv, `${spec.name}-pv`);
-        return pv;
-    }
-    /**
-     * Add Azure Files PersistentVolumeClaim.
-     * Creates a PersistentVolumeClaim for Azure Files storage.
-     *
-     * @param spec - Azure Files PersistentVolumeClaim specification
-     * @returns The created PersistentVolumeClaim ApiObject
-     */
-    addAzureFilesPersistentVolumeClaim(spec) {
-        const pvc = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'PersistentVolumeClaim',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                accessModes: spec.accessModes ?? ['ReadWriteMany'],
-                storageClassName: spec.storageClassName,
-                resources: {
-                    requests: { storage: spec.size },
-                },
-            },
-        });
-        this.capture(pvc, `${spec.name}-pvc`);
-        return pvc;
-    }
-    /**
-     * Add Azure Container Registry ServiceAccount.
-     * Creates a ServiceAccount configured for ACR access.
-     *
-     * @param spec - Azure ACR ServiceAccount specification
-     * @returns The created ServiceAccount ApiObject
-     */
-    addAzureACRServiceAccount(spec) {
-        const annotations = {
-            ...(spec.annotations ?? {}),
-        };
-        // Add Workload Identity annotations if provided
-        if (spec.clientId) {
-            annotations['azure.workload.identity/client-id'] = spec.clientId;
-        }
-        if (spec.tenantId) {
-            annotations['azure.workload.identity/tenant-id'] = spec.tenantId;
-        }
-        const sa = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'v1',
-            kind: 'ServiceAccount',
-            metadata: {
-                name: spec.name,
-                ...(Object.keys(annotations).length ? { annotations } : {}),
-                ...(spec.labels ? { labels: spec.labels } : {}),
-            },
-            automountServiceAccountToken: spec.automountServiceAccountToken,
-            imagePullSecrets: spec.imagePullSecrets?.map((n) => ({ name: n })),
-            secrets: spec.secrets?.map((n) => ({ name: n })),
-        });
-        this.capture(sa, `${spec.name}-serviceaccount`);
-        return sa;
-    }
-    addAzureDiskStorageClass(spec) {
-        // Validate numeric parameters to prevent runtime errors
-        this.validateAzureDiskNumericParameters(spec);
-        const parameters = this.buildAzureDiskParameters(spec);
-        const sc = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.STORAGE_API_VERSION,
-            kind: 'StorageClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            provisioner: Rutter.AZURE_DISK_CSI_DRIVER,
-            parameters,
-            reclaimPolicy: spec.reclaimPolicy ?? 'Delete',
-            allowVolumeExpansion: spec.allowVolumeExpansion ?? true,
-            volumeBindingMode: spec.volumeBindingMode ?? 'WaitForFirstConsumer',
-        });
-        this.capture(sc, `${spec.name}-storageclass`);
-        return sc;
-    }
-    buildAzureDiskParameters(spec) {
-        const parameters = {
-            skuName: spec.skuName ?? 'StandardSSD_LRS',
-            fsType: spec.fsType ?? 'ext4',
-            // Security best practices: default to private network access and encryption
-            networkAccessPolicy: spec.networkAccessPolicy ?? 'AllowPrivate',
-        };
-        this.addOptionalAzureDiskParameters(parameters, spec);
-        this.addAzureDiskEncryptionParameters(parameters, spec);
-        this.addAzureDiskPerformanceParameters(parameters, spec);
-        return parameters;
-    }
-    addOptionalAzureDiskParameters(parameters, spec) {
-        if (spec.cachingMode) {
-            parameters['cachingMode'] = spec.cachingMode;
-        }
-        if (spec.resourceGroup) {
-            parameters['resourceGroup'] = spec.resourceGroup;
-        }
-        if (spec.logicalSectorSize !== undefined) {
-            parameters['LogicalSectorSize'] = String(spec.logicalSectorSize);
-        }
-        if (spec.tags && Object.keys(spec.tags).length > 0) {
-            const tagString = this.formatCloudResourceTags(spec.tags);
-            parameters['tags'] = tagString;
-        }
-        // networkAccessPolicy is now set as default in buildAzureDiskParameters
-        if (spec.networkAccessPolicy && spec.networkAccessPolicy !== 'AllowPrivate') {
-            parameters['networkAccessPolicy'] = spec.networkAccessPolicy;
-        }
-        if (spec.diskAccessID) {
-            parameters['diskAccessID'] = spec.diskAccessID;
-        }
-        if (spec.maxShares !== undefined) {
-            parameters['maxShares'] = String(spec.maxShares);
-        }
-    }
-    addAzureDiskEncryptionParameters(parameters, spec) {
-        if (spec.diskEncryptionSetID) {
-            parameters['diskEncryptionSetID'] = spec.diskEncryptionSetID;
-        }
-        if (spec.diskEncryptionType) {
-            parameters['diskEncryptionType'] = spec.diskEncryptionType;
-        }
-    }
-    addAzureDiskPerformanceParameters(parameters, spec) {
-        if (spec.diskIOPSReadWrite !== undefined) {
-            parameters['DiskIOPSReadWrite'] = String(spec.diskIOPSReadWrite);
-        }
-        if (spec.diskMBpsReadWrite !== undefined) {
-            parameters['DiskMBpsReadWrite'] = String(spec.diskMBpsReadWrite);
-        }
-        if (spec.writeAcceleratorEnabled !== undefined) {
-            parameters['writeAcceleratorEnabled'] = String(spec.writeAcceleratorEnabled);
-        }
-        if (spec.enableBursting !== undefined) {
-            parameters['enableBursting'] = String(spec.enableBursting);
-        }
-    }
-    validateAzureDiskNumericParameters(spec) {
-        this.validateAzureDiskIOPS(spec);
-        this.validateAzureDiskThroughput(spec);
-        this.validateAzureDiskShares(spec);
-        this.validateAzureDiskSectorSize(spec);
-    }
-    validateAzureDiskIOPS(spec) {
-        if (spec.diskIOPSReadWrite === undefined)
-            return;
-        if (spec.diskIOPSReadWrite < 100) {
-            throw new Error(`Azure Disk ${spec.name}: diskIOPSReadWrite must be at least 100 IOPS`);
-        }
-        if (spec.diskIOPSReadWrite > 400000) {
-            throw new Error(`Azure Disk ${spec.name}: diskIOPSReadWrite cannot exceed 400,000 IOPS`);
-        }
-    }
-    validateAzureDiskThroughput(spec) {
-        if (spec.diskMBpsReadWrite === undefined)
-            return;
-        if (spec.diskMBpsReadWrite < 1) {
-            throw new Error(`Azure Disk ${spec.name}: diskMBpsReadWrite must be at least 1 MB/s`);
-        }
-        if (spec.diskMBpsReadWrite > 10000) {
-            throw new Error(`Azure Disk ${spec.name}: diskMBpsReadWrite cannot exceed 10,000 MB/s`);
-        }
-    }
-    validateAzureDiskShares(spec) {
-        if (spec.maxShares === undefined)
-            return;
-        if (spec.maxShares < 1) {
-            throw new Error(`Azure Disk ${spec.name}: maxShares must be at least 1`);
-        }
-        if (spec.maxShares > 5) {
-            throw new Error(`Azure Disk ${spec.name}: maxShares cannot exceed 5`);
-        }
-    }
-    validateAzureDiskSectorSize(spec) {
-        if (spec.logicalSectorSize === undefined)
-            return;
-        if (spec.logicalSectorSize !== 512 && spec.logicalSectorSize !== 4096) {
-            throw new Error(`Azure Disk ${spec.name}: logicalSectorSize must be either 512 or 4096 bytes`);
-        }
-    }
-    /**
-     * Format cloud resource tags for provider-specific string format.
-     * Provides basic validation and consistent formatting across cloud providers.
-     */
-    formatCloudResourceTags(tags) {
-        this.validateCloudResourceTags(tags);
-        return Object.entries(tags)
-            .map(([key, value]) => `${key}=${value}`)
-            .join(',');
-    }
-    /**
-     * Validate cloud resource tags with basic rules.
-     * Each cloud provider has specific validation, but these are common basics.
-     */
-    validateCloudResourceTags(tags) {
-        for (const [key, value] of Object.entries(tags)) {
-            if (!key || key.trim() === '') {
-                throw new Error('Tag key cannot be empty');
-            }
-            if (value === undefined || value === null) {
-                throw new Error(`Tag value for key '${key}' cannot be null or undefined`);
-            }
-        }
-    }
-    addNetworkPolicy(spec) {
-        // Validate policy types
-        this.validateNetworkPolicyTypes(spec);
-        // Validate CIDR blocks if present
-        this.validateNetworkPolicyCIDRs(spec);
-        const np = new ApiObject(this.chart, spec.name, {
-            apiVersion: Rutter.NETWORKING_API_VERSION,
-            kind: 'NetworkPolicy',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                podSelector: spec.podSelector ?? {},
-                policyTypes: spec.policyTypes,
-                ...(spec.ingress ? { ingress: spec.ingress } : {}),
-                ...(spec.egress ? { egress: spec.egress } : {}),
-            },
-        });
-        this.capture(np, `${spec.name}-networkpolicy`);
-        return np;
-    }
-    /**
-     * Create a deny-all ingress NetworkPolicy for the current namespace
-     */
-    addDenyAllIngressNetworkPolicy(name = 'deny-all-ingress') {
-        return this.addNetworkPolicy({
-            name,
-            podSelector: Rutter.EMPTY_POD_SELECTOR,
-            policyTypes: ['Ingress'],
-        });
-    }
-    /**
-     * Create a deny-all egress NetworkPolicy for the current namespace
-     */
-    addDenyAllEgressNetworkPolicy(name = 'deny-all-egress') {
-        return this.addNetworkPolicy({
-            name,
-            podSelector: Rutter.EMPTY_POD_SELECTOR,
-            policyTypes: ['Egress'],
-        });
-    }
-    /**
-     * Create a deny-all NetworkPolicy for both ingress and egress
-     */
-    addDenyAllNetworkPolicy(name = 'deny-all') {
-        return this.addNetworkPolicy({
-            name,
-            podSelector: Rutter.EMPTY_POD_SELECTOR,
-            policyTypes: ['Ingress', 'Egress'],
-        });
-    }
-    /**
-     * Allow traffic from specific pods to target pods on specific ports
-     */
-    addAllowFromPodsNetworkPolicy(spec) {
-        return this.addNetworkPolicy({
-            name: spec.name,
-            podSelector: { matchLabels: spec.targetPodSelector },
-            policyTypes: ['Ingress'],
-            ingress: [
-                {
-                    from: [{ podSelector: { matchLabels: spec.sourcePodSelector } }],
-                    ...(spec.ports ? { ports: spec.ports } : {}),
-                },
-            ],
-            ...(spec.labels ? { labels: spec.labels } : {}),
-            ...(spec.annotations ? { annotations: spec.annotations } : {}),
-        });
-    }
-    /**
-     * Allow traffic from specific namespace to target pods
-     */
-    addAllowFromNamespaceNetworkPolicy(spec) {
-        return this.addNetworkPolicy({
-            name: spec.name,
-            podSelector: { matchLabels: spec.targetPodSelector },
-            policyTypes: ['Ingress'],
-            ingress: [
-                {
-                    from: [{ namespaceSelector: { matchLabels: spec.sourceNamespaceSelector } }],
-                    ...(spec.ports ? { ports: spec.ports } : {}),
-                },
-            ],
-            ...(spec.labels ? { labels: spec.labels } : {}),
-            ...(spec.annotations ? { annotations: spec.annotations } : {}),
-        });
-    }
-    validateNetworkPolicyTypes(spec) {
-        if (!spec.policyTypes || spec.policyTypes.length === 0) {
-            throw new Error(`NetworkPolicy ${spec.name}: policyTypes must be specified`);
-        }
-        this.validatePolicyTypeValues(spec);
-        this.validatePolicyTypeRules(spec);
-    }
-    validatePolicyTypeValues(spec) {
-        const validTypes = ['Ingress', 'Egress'];
-        for (const type of spec.policyTypes) {
-            if (!validTypes.includes(type)) {
-                throw new Error(`NetworkPolicy ${spec.name}: invalid policyType '${type}', must be 'Ingress' or 'Egress'`);
-            }
-        }
-    }
-    validatePolicyTypeRules(spec) {
-        if (spec.policyTypes.includes('Ingress') && spec.ingress === undefined) {
-            console.warn(`NetworkPolicy ${spec.name}: policyType 'Ingress' specified but no ingress rules defined (will deny all ingress)`);
-        }
-        if (spec.policyTypes.includes('Egress') && spec.egress === undefined) {
-            console.warn(`NetworkPolicy ${spec.name}: policyType 'Egress' specified but no egress rules defined (will deny all egress)`);
-        }
-    }
-    validateNetworkPolicyCIDRs(spec) {
-        const validateCIDR = (cidr, context) => {
-            if (!this.isValidCIDR(cidr)) {
-                throw new Error(`NetworkPolicy ${spec.name}: invalid CIDR '${cidr}' in ${context}`);
-            }
-        };
-        this.validateIngressCIDRs(spec, validateCIDR);
-        this.validateEgressCIDRs(spec, validateCIDR);
-    }
-    isValidCIDR(cidr) {
-        // IPv4 CIDR validation
-        const ipv4Parts = cidr.split('/');
-        if (ipv4Parts.length === 2) {
-            const [ip, prefix] = ipv4Parts;
-            if (ip && prefix && this.isValidIPv4(ip) && this.isValidPrefix(prefix, 32)) {
-                return true;
-            }
-        }
-        // IPv6 CIDR validation (basic)
-        if (cidr.includes(':') && ipv4Parts.length === 2) {
-            const [, prefix] = ipv4Parts;
-            if (prefix) {
-                return this.isValidPrefix(prefix, 128);
-            }
-        }
-        return false;
-    }
-    isValidIPv4(ip) {
-        const parts = ip.split('.');
-        if (parts.length !== 4)
-            return false;
-        return parts.every((part) => {
-            const num = parseInt(part, 10);
-            return !isNaN(num) && num >= 0 && num <= 255 && String(num) === part;
-        });
-    }
-    isValidPrefix(prefix, maxPrefix) {
-        const num = parseInt(prefix, 10);
-        return !isNaN(num) && num >= 0 && num <= maxPrefix && String(num) === prefix;
-    }
-    validateIngressCIDRs(spec, validateCIDR) {
-        if (!spec.ingress)
-            return;
-        for (const rule of spec.ingress) {
-            if (rule.from) {
-                for (const peer of rule.from) {
-                    this.validatePeerCIDRs(peer, validateCIDR, 'ingress rule');
-                }
-            }
-        }
-    }
-    validateEgressCIDRs(spec, validateCIDR) {
-        if (!spec.egress)
-            return;
-        for (const rule of spec.egress) {
-            if (rule.to) {
-                for (const peer of rule.to) {
-                    this.validatePeerCIDRs(peer, validateCIDR, 'egress rule');
-                }
-            }
-        }
-    }
-    validatePeerCIDRs(peer, validateCIDR, context) {
-        if (peer.ipBlock?.cidr) {
-            validateCIDR(peer.ipBlock.cidr, context);
-            if (peer.ipBlock.except) {
-                for (const except of peer.ipBlock.except) {
-                    validateCIDR(except, `${context} except block`);
-                }
-            }
-        }
-    }
-    validateAGICHealthProbeParams(spec) {
-        if (spec.healthProbeInterval !== undefined &&
-            (spec.healthProbeInterval < 1 || spec.healthProbeInterval > 86400)) {
-            throw new Error('Health probe interval must be between 1 and 86400 seconds');
-        }
-        if (spec.healthProbeTimeout !== undefined &&
-            (spec.healthProbeTimeout < 1 || spec.healthProbeTimeout > 86400)) {
-            throw new Error('Health probe timeout must be between 1 and 86400 seconds');
-        }
-        if (spec.healthProbeUnhealthyThreshold !== undefined &&
-            (spec.healthProbeUnhealthyThreshold < 1 || spec.healthProbeUnhealthyThreshold > 20)) {
-            throw new Error('Health probe unhealthy threshold must be between 1 and 20');
-        }
-    }
-    validateAGICSecurityParams(spec) {
-        if (spec.wafPolicyForPath &&
-            !/^\/subscriptions\/[^/]+\/resourceGroups\/[^/]+\/providers\/Microsoft\.Network\/applicationGatewayWebApplicationFirewallPolicies\/[^/]+$/.test(spec.wafPolicyForPath)) {
-            throw new Error('Invalid WAF policy resource ID format');
-        }
-        if (spec.hostnameExtension?.some((hostname) => !this.isValidHostname(hostname))) {
-            throw new Error('Invalid hostname format in hostnameExtension');
-        }
-    }
-    isValidHostname(hostname) {
-        // Basic hostname validation without complex regex to prevent ReDoS
-        if (!hostname || hostname.length > 253)
-            return false;
-        if (hostname.startsWith('.') || hostname.endsWith('.'))
-            return false;
-        const labels = hostname.split('.');
-        return labels.every((label) => {
-            if (!label || label.length > 63)
-                return false;
-            if (label.startsWith('-') || label.endsWith('-'))
-                return false;
-            return /^[a-zA-Z0-9-]+$/.test(label);
-        });
-    }
-    validateAGICAnnotationConsistency(spec) {
-        if (spec.sslRedirect && !spec.appgwSslCertificate) {
-            throw new Error('SSL redirect requires an SSL certificate to be specified');
-        }
-        if (spec.backendProtocol === 'https' && !spec.appgwTrustedRootCertificate?.length) {
-            throw new Error('HTTPS backend protocol requires trusted root certificates');
-        }
-        if (spec.overrideFrontendPort === 443 && !spec.appgwSslCertificate) {
-            throw new Error('Port 443 requires an SSL certificate to be specified');
-        }
-    }
-    buildAzureFilesParameters(spec) {
-        const parameters = {
-            skuName: spec.skuName ?? 'Standard_LRS',
-        };
-        if (spec.protocol) {
-            parameters['protocol'] = spec.protocol;
-        }
-        if (spec.allowSharedAccess !== undefined) {
-            parameters['allowSharedAccess'] = String(spec.allowSharedAccess);
-        }
-        if (spec.resourceGroup) {
-            parameters['resourceGroup'] = spec.resourceGroup;
-        }
-        if (spec.storageAccount) {
-            parameters['storageAccount'] = spec.storageAccount;
-        }
-        if (spec.location) {
-            parameters['location'] = spec.location;
-        }
-        if (spec.networkEndpointType) {
-            parameters['networkEndpointType'] = spec.networkEndpointType;
-        }
-        // NFS-specific parameters
-        if (spec.protocol === 'nfs' && spec.mountPermissions) {
-            parameters['mountPermissions'] = spec.mountPermissions;
-        }
-        if (spec.protocol === 'nfs' && spec.rootSquashType) {
-            parameters['rootSquashType'] = spec.rootSquashType;
-        }
-        return parameters;
-    }
-    buildAzureFilesPVCSISpec(spec) {
-        // Validate protocol and secret configuration
-        if (spec.protocol === 'nfs' && spec.secretName) {
-            throw new Error(`Azure Files PV ${spec.name}: NFS protocol does not use secrets for authentication`);
-        }
-        const volumeHandle = this.sanitizeVolumeHandle(spec.storageAccount, spec.shareName);
-        const volumeAttributes = {
-            storageAccount: spec.storageAccount,
-            shareName: spec.shareName,
-        };
-        if (spec.resourceGroup) {
-            volumeAttributes['resourceGroup'] = spec.resourceGroup;
-        }
-        if (spec.protocol) {
-            volumeAttributes['protocol'] = spec.protocol;
-        }
-        if (spec.server) {
-            volumeAttributes['server'] = spec.server;
-        }
-        if (spec.folderName) {
-            volumeAttributes['folderName'] = spec.folderName;
-        }
-        if (spec.mountPermissions) {
-            volumeAttributes['mountPermissions'] = spec.mountPermissions;
-        }
-        const csiSpec = {
-            driver: Rutter.AZURE_FILES_CSI_DRIVER,
-            volumeHandle,
-            volumeAttributes,
-        };
-        // Add secret reference for SMB protocol
-        if (spec.protocol !== 'nfs' && spec.secretName) {
-            csiSpec['nodeStageSecretRef'] = {
-                name: spec.secretName,
-                namespace: spec.secretNamespace ?? 'default',
-            };
-        }
-        return csiSpec;
-    }
-    buildPodEnvironment(spec) {
-        const envEntries = spec.env
-            ? Object.entries(spec.env).map(([name, value]) => this.sanitizeEnvVar(name, value))
-            : undefined;
-        const envFromEntries = spec.envFrom
-            ? spec.envFrom
-                .map((s) => {
-                const entry = {};
-                if (s.configMapRef) {
-                    entry.configMapRef = { name: s.configMapRef };
-                }
-                if (s.secretRef) {
-                    entry.secretRef = { name: s.secretRef };
-                }
-                return entry;
-            })
-                .filter((entry) => entry.configMapRef || entry.secretRef)
-            : undefined;
-        const volumeDefs = spec.volumes
-            ? spec.volumes.map((v) => ({
-                name: v.name,
-                configMap: v.configMap ? { name: v.configMap } : undefined,
-                secret: v.secret ? { secretName: v.secret } : undefined,
-                persistentVolumeClaim: v.persistentVolumeClaim
-                    ? { claimName: v.persistentVolumeClaim }
-                    : undefined,
-            }))
-            : undefined;
-        const volumeMountDefs = spec.volumeMounts
-            ? spec.volumeMounts.map((m) => ({
-                name: m.name,
-                mountPath: m.mountPath,
-                readOnly: m.readOnly,
-                subPath: m.subPath,
-            }))
-            : undefined;
-        return { envEntries, envFromEntries, volumeDefs, volumeMountDefs };
-    }
-    buildJobSpec(spec) {
-        return {
-            ...(spec.backoffLimit !== undefined ? { backoffLimit: spec.backoffLimit } : {}),
-            ...(spec.activeDeadlineSeconds !== undefined
-                ? { activeDeadlineSeconds: spec.activeDeadlineSeconds }
-                : {}),
-            ...(spec.ttlSecondsAfterFinished !== undefined
-                ? { ttlSecondsAfterFinished: spec.ttlSecondsAfterFinished }
-                : {}),
-            ...(spec.completions !== undefined ? { completions: spec.completions } : {}),
-            ...(spec.parallelism !== undefined ? { parallelism: spec.parallelism } : {}),
-            ...(spec.completionMode !== undefined ? { completionMode: spec.completionMode } : {}),
-            ...(spec.suspend !== undefined ? { suspend: spec.suspend } : {}),
-        };
-    }
-    buildJobPodTemplate(spec, envEntries, envFromEntries, volumeDefs, volumeMountDefs) {
-        return {
-            metadata: {
-                ...(spec.podLabels ? { labels: spec.podLabels } : {}),
-                ...(spec.podAnnotations ? { annotations: spec.podAnnotations } : {}),
-            },
-            spec: {
-                restartPolicy: spec.restartPolicy ?? 'Never',
-                serviceAccountName: spec.serviceAccountName,
-                volumes: volumeDefs,
-                containers: [
-                    {
-                        name: spec.name,
-                        image: spec.image,
-                        imagePullPolicy: spec.imagePullPolicy,
-                        ...(spec.command ? { command: spec.command } : {}),
-                        ...(spec.args ? { args: spec.args } : {}),
-                        env: envEntries,
-                        envFrom: envFromEntries,
-                        volumeMounts: volumeMountDefs,
-                        resources: spec.resources ?? this.getDefaultResources(),
-                    },
-                ],
-            },
-        };
-    }
-    buildCronJobSpec(spec) {
-        return {
-            schedule: spec.schedule,
-            ...(spec.startingDeadlineSeconds !== undefined
-                ? { startingDeadlineSeconds: spec.startingDeadlineSeconds }
-                : {}),
-            ...(spec.concurrencyPolicy !== undefined
-                ? { concurrencyPolicy: spec.concurrencyPolicy }
-                : {}),
-            ...(spec.suspend !== undefined ? { suspend: spec.suspend } : {}),
-            ...(spec.successfulJobsHistoryLimit !== undefined
-                ? { successfulJobsHistoryLimit: spec.successfulJobsHistoryLimit }
-                : {}),
-            ...(spec.failedJobsHistoryLimit !== undefined
-                ? { failedJobsHistoryLimit: spec.failedJobsHistoryLimit }
-                : {}),
-            ...(spec.timeZone !== undefined ? { timeZone: spec.timeZone } : {}),
-        };
-    }
-    buildCronJobTemplate(spec, envEntries, envFromEntries, volumeDefs, volumeMountDefs) {
-        return {
-            spec: {
-                ...(spec.backoffLimit !== undefined ? { backoffLimit: spec.backoffLimit } : {}),
-                ...(spec.activeDeadlineSeconds !== undefined
-                    ? { activeDeadlineSeconds: spec.activeDeadlineSeconds }
-                    : {}),
-                ...(spec.ttlSecondsAfterFinished !== undefined
-                    ? { ttlSecondsAfterFinished: spec.ttlSecondsAfterFinished }
-                    : {}),
-                ...(spec.completions !== undefined ? { completions: spec.completions } : {}),
-                ...(spec.parallelism !== undefined ? { parallelism: spec.parallelism } : {}),
-                ...(spec.completionMode !== undefined ? { completionMode: spec.completionMode } : {}),
-                template: {
-                    metadata: {
-                        ...(spec.podLabels ? { labels: spec.podLabels } : {}),
-                        ...(spec.podAnnotations ? { annotations: spec.podAnnotations } : {}),
-                    },
-                    spec: {
-                        restartPolicy: spec.restartPolicy ?? 'Never',
-                        serviceAccountName: spec.serviceAccountName,
-                        volumes: volumeDefs,
-                        containers: [
-                            {
-                                name: spec.name,
-                                image: spec.image,
-                                imagePullPolicy: spec.imagePullPolicy,
-                                ...(spec.command ? { command: spec.command } : {}),
-                                ...(spec.args ? { args: spec.args } : {}),
-                                env: envEntries,
-                                envFrom: envFromEntries,
-                                volumeMounts: volumeMountDefs,
-                                resources: spec.resources ?? this.getDefaultResources(),
-                            },
-                        ],
-                    },
-                },
-            },
-        };
-    }
-    /**
-     * Validate Job specification for security and best practices
-     */
-    validateJobSpec(spec) {
-        if (spec.activeDeadlineSeconds !== undefined && spec.activeDeadlineSeconds <= 0) {
-            throw new Error('activeDeadlineSeconds must be a positive integer');
-        }
-        if (spec.ttlSecondsAfterFinished !== undefined && spec.ttlSecondsAfterFinished < 0) {
-            throw new Error('ttlSecondsAfterFinished must be a non-negative integer');
-        }
-    }
-    /**
-     * Validate CronJob specification for security and best practices
-     */
-    validateCronJobSpec(spec) {
-        this.validateCronSchedule(spec.schedule);
-        if (spec.suspend && spec.startingDeadlineSeconds !== undefined) {
-            throw new Error('startingDeadlineSeconds should not be set when job is suspended');
-        }
-        if (spec.successfulJobsHistoryLimit !== undefined && spec.successfulJobsHistoryLimit < 0) {
-            throw new Error('successfulJobsHistoryLimit must be non-negative');
-        }
-        if (spec.failedJobsHistoryLimit !== undefined && spec.failedJobsHistoryLimit < 0) {
-            throw new Error('failedJobsHistoryLimit must be non-negative');
-        }
-        if (spec.activeDeadlineSeconds !== undefined && spec.activeDeadlineSeconds <= 0) {
-            throw new Error('activeDeadlineSeconds must be a positive integer');
-        }
-        if (spec.ttlSecondsAfterFinished !== undefined && spec.ttlSecondsAfterFinished < 0) {
-            throw new Error('ttlSecondsAfterFinished must be a non-negative integer');
-        }
-    }
-    /**
-     * Validate cron schedule expression
-     */
-    validateCronSchedule(schedule) {
-        const cronRegex = /^(\*|([0-9]|1[0-9]|2[0-9]|3[0-9]|4[0-9]|5[0-9])|\*\/([0-9]|1[0-9]|2[0-9]|3[0-9]|4[0-9]|5[0-9])) (\*|([0-9]|1[0-9]|2[0-3])|\*\/([0-9]|1[0-9]|2[0-3])) (\*|([1-9]|1[0-9]|2[0-9]|3[0-1])|\*\/([1-9]|1[0-9]|2[0-9]|3[0-1])) (\*|([1-9]|1[0-2])|\*\/([1-9]|1[0-2])) (\*|([0-6])|\*\/([0-6]))$/;
-        if (!cronRegex.test(schedule)) {
-            throw new Error('Invalid cron schedule expression');
-        }
-    }
-    /**
-     * Sanitize environment variable names and values
-     */
-    sanitizeEnvVar(name, value) {
-        const nameRegex = /^[A-Za-z_][A-Za-z0-9_]*$/;
-        if (!nameRegex.test(name)) {
-            throw new Error(`Invalid environment variable name: ${name}`);
-        }
-        // Remove control characters from value (ASCII 0-31 and 127)
-        const sanitizedValue = value.replace(/[\cA-\c_\x7F]/g, '');
-        return { name, value: sanitizedValue };
-    }
-    /**
-     * Get default resource limits for Jobs and CronJobs
-     */
-    getDefaultResources() {
-        return {
-            limits: {
-                cpu: '1',
-                memory: '512Mi',
-            },
-            requests: {
-                cpu: '100m',
-                memory: '128Mi',
-            },
-        };
-    }
-    /**
-     * Validate Azure Files parameters for security and compliance
-     */
-    validateAzureFilesParameters(spec) {
-        const validSkuNames = [
-            'Standard_LRS',
-            'Standard_GRS',
-            'Standard_RAGRS',
-            'Standard_ZRS',
-            'Premium_LRS',
-            'Premium_ZRS',
-        ];
-        if (spec.skuName && !validSkuNames.includes(spec.skuName)) {
-            throw new Error(`Invalid skuName: ${spec.skuName}. Must be one of: ${validSkuNames.join(', ')}`);
-        }
-        if (spec.protocol === 'nfs' && spec.mountPermissions) {
-            const permRegex = /^[0-7]{3,4}$/;
-            if (!permRegex.test(spec.mountPermissions)) {
-                throw new Error('mountPermissions must be a valid octal permission string (e.g., "0777")');
-            }
-        }
-    }
-    /**
-     * Sanitize volume handle to ensure valid format for CSI driver
-     */
-    sanitizeVolumeHandle(account, share) {
-        // Remove special characters and ensure valid format
-        const sanitizedAccount = account.replace(/[^a-z0-9]/gi, '').toLowerCase();
-        const sanitizedShare = share.replace(/[^a-z0-9-]/gi, '').toLowerCase();
-        return `${sanitizedAccount}#${sanitizedShare}`;
-    }
-    /**
-     * Capture the YAML of an ApiObject or Construct into assets.
-     */
-    capture(_obj, id) {
-        // Ensure the app can synth
-        // We defer synth until write(), but we can capture logical ids now
-        this.assets.push({ id, yaml: `# captured:${id}` });
-    }
-    /**
-     * Extract a meaningful name from a Kubernetes resource object
-     */
-    getResourceName(obj) {
-        if (obj && typeof obj === 'object') {
-            const resource = obj;
-            if (resource.kind && resource.metadata?.name) {
-                return `${resource.kind.toLowerCase()}-${resource.metadata.name}`;
-            }
-            if (resource.kind) {
-                return resource.kind.toLowerCase();
-            }
-        }
-        return 'resource';
-    }
-    /**
-     * Adds a raw CRD manifest to the chart
-     *
-     * @param {string} yaml - YAML content of the CRD
-     * @param {string} [id='crd'] - Asset identifier
-     *
-     * @example
-     * ```typescript
-     * const crdYaml = `
-     * apiVersion: apiextensions.k8s.io/v1
-     * kind: CustomResourceDefinition
-     * metadata:
-     *   name: myresources.example.com
-     * `;
-     * rutter.addCrd(crdYaml, 'myresource-crd');
-     * ```
-     *
-     * @since 1.0.0
-     */
-    addCrd(yaml, id = 'crd') {
-        this.assets.push({ id, yaml, target: 'crds' });
-    }
-    /**
-     * Add Karpenter NodePool for intelligent node provisioning.
-     * Creates a NodePool resource that defines compute requirements and lifecycle policies.
-     *
-     * @param spec - Karpenter NodePool specification
-     * @returns The created NodePool ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addKarpenterNodePool({
-     *   name: 'general-purpose',
-     *   requirements: [
-     *     { key: 'eks.amazonaws.com/instance-category', operator: 'In', values: ['c', 'm', 'r'] },
-     *     { key: 'kubernetes.io/arch', operator: 'In', values: ['amd64'] }
-     *   ],
-     *   limits: { cpu: '1000', memory: '1000Gi' },
-     *   nodeClassRef: { name: 'default' }
-     * });
-     * ```
-     *
-     * @since 2.3.0
-     */
-    addKarpenterNodePool(spec) {
-        // Validate NodePool specification
-        this.validateKarpenterNodePoolSpec(spec);
-        const nodePool = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'karpenter.sh/v1',
-            kind: 'NodePool',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                template: {
-                    metadata: {
-                        ...(spec.labels ? { labels: spec.labels } : {}),
-                    },
-                    spec: {
-                        nodeClassRef: {
-                            group: spec.nodeClassRef.group ?? 'eks.amazonaws.com',
-                            kind: spec.nodeClassRef.kind ?? 'NodeClass',
-                            name: spec.nodeClassRef.name,
-                        },
-                        ...(spec.requirements ? { requirements: spec.requirements } : {}),
-                        ...(spec.taints ? { taints: spec.taints } : {}),
-                    },
-                },
-                ...(spec.limits ? { limits: spec.limits } : {}),
-                ...(spec.disruption ? { disruption: spec.disruption } : {}),
-            },
-        });
-        this.capture(nodePool, `${spec.name}-nodepool`);
-        return nodePool;
-    }
-    /**
-     * Add Karpenter EC2 NodeClass for AWS-specific node configuration.
-     * Creates a NodeClass resource that defines EC2 instance settings and networking.
-     *
-     * @param spec - Karpenter EC2 NodeClass specification
-     * @returns The created NodeClass ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addKarpenterEC2NodeClass({
-     *   name: 'default',
-     *   amiFamily: 'AL2023',
-     *   subnetSelectorTerms: [{ tags: { 'karpenter.sh/discovery': 'my-cluster' } }],
-     *   securityGroupSelectorTerms: [{ tags: { 'karpenter.sh/discovery': 'my-cluster' } }],
-     *   role: 'KarpenterNodeInstanceProfile'
-     * });
-     * ```
-     *
-     * @since 2.3.0
-     */
-    addKarpenterEC2NodeClass(spec) {
-        // Validate EC2 NodeClass specification
-        this.validateKarpenterEC2NodeClassSpec(spec);
-        const nodeClass = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'eks.amazonaws.com/v1',
-            kind: 'NodeClass',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                ...(spec.amiFamily ? { amiFamily: spec.amiFamily } : {}),
-                ...(spec.instanceStorePolicy ? { instanceStorePolicy: spec.instanceStorePolicy } : {}),
-                ...(spec.userData ? { userData: spec.userData } : {}),
-                ...(spec.subnetSelectorTerms ? { subnetSelectorTerms: spec.subnetSelectorTerms } : {}),
-                ...(spec.securityGroupSelectorTerms
-                    ? { securityGroupSelectorTerms: spec.securityGroupSelectorTerms }
-                    : {}),
-                ...(spec.role ? { role: spec.role } : {}),
-                ...(spec.instanceProfile ? { instanceProfile: spec.instanceProfile } : {}),
-                ...(spec.metadataOptions ? { metadataOptions: spec.metadataOptions } : {}),
-                ...(spec.blockDeviceMappings ? { blockDeviceMappings: spec.blockDeviceMappings } : {}),
-                ...(spec.tags ? { tags: spec.tags } : {}),
-            },
-        });
-        this.capture(nodeClass, `${spec.name}-nodeclass`);
-        return nodeClass;
-    }
-    /**
-     * Validate Karpenter NodePool specification
-     */
-    validateKarpenterNodePoolSpec(spec) {
-        this.validateNodeClassRef(spec);
-        this.validateNodePoolRequirements(spec);
-        this.validateNodePoolLimits(spec);
-        this.validateNodePoolDisruption(spec);
-    }
-    validateNodeClassRef(spec) {
-        if (!spec.nodeClassRef.name) {
-            throw new Error(`Karpenter NodePool ${spec.name}: nodeClassRef.name is required`);
-        }
-    }
-    validateNodePoolRequirements(spec) {
-        if (!spec.requirements)
-            return;
-        const operatorsRequiringValues = ['In', 'NotIn', 'Gt', 'Lt'];
-        for (const req of spec.requirements) {
-            if (operatorsRequiringValues.includes(req.operator) && !req.values?.length) {
-                throw new Error(`Karpenter NodePool ${spec.name}: requirement with operator '${req.operator}' must have values`);
-            }
-        }
-    }
-    validateNodePoolLimits(spec) {
-        if (!spec.limits)
-            return;
-        if (spec.limits.cpu && !this.isValidResourceQuantity(spec.limits.cpu)) {
-            throw new Error(`Karpenter NodePool ${spec.name}: invalid CPU limit format`);
-        }
-        if (spec.limits.memory && !this.isValidResourceQuantity(spec.limits.memory)) {
-            throw new Error(`Karpenter NodePool ${spec.name}: invalid memory limit format`);
-        }
-    }
-    validateNodePoolDisruption(spec) {
-        if (!spec.disruption)
-            return;
-        if (spec.disruption.consolidateAfter &&
-            !this.isValidDuration(spec.disruption.consolidateAfter)) {
-            throw new Error(`Karpenter NodePool ${spec.name}: invalid consolidateAfter duration format`);
-        }
-        if (spec.disruption.expireAfter && !this.isValidDuration(spec.disruption.expireAfter)) {
-            throw new Error(`Karpenter NodePool ${spec.name}: invalid expireAfter duration format`);
-        }
-    }
-    /**
-     * Validate Karpenter EC2 NodeClass specification
-     */
-    validateKarpenterEC2NodeClassSpec(spec) {
-        this.validateNodeClassSelectors(spec);
-        this.validateNodeClassBlockDevices(spec);
-        this.validateNodeClassMetadataOptions(spec);
-    }
-    validateNodeClassSelectors(spec) {
-        if (!spec.subnetSelectorTerms?.length && !spec.securityGroupSelectorTerms?.length) {
-            console.warn(`Karpenter EC2 NodeClass ${spec.name}: Consider specifying subnet and security group selectors for better control`);
-        }
-    }
-    validateNodeClassBlockDevices(spec) {
-        if (!spec.blockDeviceMappings)
-            return;
-        for (const mapping of spec.blockDeviceMappings) {
-            if (mapping.ebs?.volumeSize && !this.isValidStorageSize(mapping.ebs.volumeSize)) {
-                throw new Error(`Karpenter EC2 NodeClass ${spec.name}: invalid volume size format in block device mapping`);
-            }
-            if (mapping.ebs?.iops !== undefined && mapping.ebs.iops < 100) {
-                throw new Error(`Karpenter EC2 NodeClass ${spec.name}: IOPS must be at least 100 for block device mapping`);
-            }
-        }
-    }
-    validateNodeClassMetadataOptions(spec) {
-        if (spec.metadataOptions?.httpPutResponseHopLimit === undefined)
-            return;
-        const hopLimit = spec.metadataOptions.httpPutResponseHopLimit;
-        if (hopLimit < 1 || hopLimit > 64) {
-            throw new Error(`Karpenter EC2 NodeClass ${spec.name}: httpPutResponseHopLimit must be between 1 and 64`);
-        }
-    }
-    /**
-     * Validate Kubernetes resource quantity format (e.g., "100m", "1Gi")
-     */
-    isValidResourceQuantity(quantity) {
-        // Safe validation without regex to prevent ReDoS
-        const validUnits = ['m', 'k', 'M', 'G', 'T', 'P', 'E', 'Ki', 'Mi', 'Gi', 'Ti', 'Pi', 'Ei'];
-        // Find the unit suffix
-        let numberPart = quantity;
-        let hasValidUnit = false;
-        for (const unit of validUnits) {
-            if (quantity.endsWith(unit)) {
-                numberPart = quantity.slice(0, -unit.length);
-                hasValidUnit = true;
-                break;
-            }
-        }
-        // If no unit found, that's also valid (plain number)
-        if (!hasValidUnit && quantity.length > 0) {
-            numberPart = quantity;
-        }
-        // Validate the number part
-        const num = parseFloat(numberPart);
-        return !isNaN(num) && num >= 0 && numberPart === String(num);
-    }
-    /**
-     * Validate duration format (e.g., "30s", "5m", "1h")
-     */
-    isValidDuration(duration) {
-        // Safe validation without regex to prevent ReDoS
-        const validUnits = ['ns', 'us', 'µs', 'ms', 's', 'm', 'h'];
-        // Find the unit suffix
-        let numberPart = duration;
-        let hasValidUnit = false;
-        for (const unit of validUnits) {
-            if (duration.endsWith(unit)) {
-                numberPart = duration.slice(0, -unit.length);
-                hasValidUnit = true;
-                break;
-            }
-        }
-        // Duration must have a unit
-        if (!hasValidUnit)
-            return false;
-        // Validate the number part
-        const num = parseFloat(numberPart);
-        return !isNaN(num) && num >= 0 && numberPart === String(num);
-    }
-    /**
-     * Validate storage size format (e.g., "20", "100Gi")
-     */
-    isValidStorageSize(size) {
-        // Safe validation without regex to prevent ReDoS
-        const validUnits = ['Gi', 'G', 'Ti', 'T'];
-        // Find the unit suffix
-        let numberPart = size;
-        let hasValidUnit = false;
-        for (const unit of validUnits) {
-            if (size.endsWith(unit)) {
-                numberPart = size.slice(0, -unit.length);
-                hasValidUnit = true;
-                break;
-            }
-        }
-        // If no unit found, that's also valid (plain number)
-        if (!hasValidUnit && size.length > 0) {
-            numberPart = size;
-        }
-        // Validate the number part
-        const num = parseFloat(numberPart);
-        return !isNaN(num) && num >= 0 && numberPart === String(num);
-    }
-    /**
-     * Add Karpenter NodeClaim for individual node provisioning.
-     * Creates a NodeClaim resource that represents a request for a single node.
-     *
-     * @param spec - Karpenter NodeClaim specification
-     * @returns The created NodeClaim ApiObject
-     *
-     * @example
-     * ```typescript
-     * rutter.addKarpenterNodeClaim({
-     *   name: 'high-memory-node',
-     *   requirements: [
-     *     { key: 'eks.amazonaws.com/instance-category', operator: 'In', values: ['r'] },
-     *     { key: 'eks.amazonaws.com/instance-cpu', operator: 'In', values: ['16', '32'] }
-     *   ],
-     *   nodeClassRef: { name: 'memory-optimized' },
-     *   expireAfter: '24h'
-     * });
-     * ```
-     *
-     * @since 2.3.0
-     */
-    addKarpenterNodeClaim(spec) {
-        // Validate NodeClaim specification
-        this.validateKarpenterNodeClaimSpec(spec);
-        const nodeClaim = new ApiObject(this.chart, spec.name, {
-            apiVersion: 'karpenter.sh/v1',
-            kind: 'NodeClaim',
-            metadata: {
-                name: spec.name,
-                ...(spec.labels ? { labels: spec.labels } : {}),
-                ...(spec.annotations ? { annotations: spec.annotations } : {}),
-            },
-            spec: {
-                nodeClassRef: {
-                    group: spec.nodeClassRef.group ?? 'eks.amazonaws.com',
-                    kind: spec.nodeClassRef.kind ?? 'NodeClass',
-                    name: spec.nodeClassRef.name,
-                },
-                ...(spec.requirements ? { requirements: spec.requirements } : {}),
-                ...(spec.taints ? { taints: spec.taints } : {}),
-                ...(spec.startupTaints ? { startupTaints: spec.startupTaints } : {}),
-                ...(spec.expireAfter ? { expireAfter: spec.expireAfter } : {}),
-                ...(spec.terminationGracePeriod
-                    ? { terminationGracePeriod: spec.terminationGracePeriod }
-                    : {}),
-            },
-        });
-        this.capture(nodeClaim, `${spec.name}-nodeclaim`);
-        return nodeClaim;
-    }
-    /**
-     * Add advanced Karpenter scheduling configuration.
-     * Creates scheduling constraints for fine-grained pod placement control.
-     *
-     * @param spec - Karpenter scheduling specification
-     * @returns Configuration object for use in pod specs
-     *
-     * @example
-     * ```typescript
-     * const schedulingConfig = rutter.addKarpenterScheduling({
-     *   name: 'zone-spread-scheduling',
-     *   topologySpreadConstraints: [{
-     *     maxSkew: 1,
-     *     topologyKey: 'topology.kubernetes.io/zone',
-     *     whenUnsatisfiable: 'DoNotSchedule',
-     *     labelSelector: { matchLabels: { app: 'web' } }
-     *   }],
-     *   nodeAffinity: {
-     *     requiredDuringSchedulingIgnoredDuringExecution: {
-     *       nodeSelectorTerms: [{
-     *         matchExpressions: [{
-     *           key: 'eks.amazonaws.com/instance-category',
-     *           operator: 'In',
-     *           values: ['c', 'm']
-     *         }]
-     *       }]
-     *     }
-     *   }
-     * });
-     * ```
-     *
-     * @since 2.3.0
-     */
-    addKarpenterScheduling(spec) {
-        // Validate scheduling specification
-        this.validateKarpenterSchedulingSpec(spec);
-        // Return scheduling configuration for use in pod specs
-        return {
-            ...(spec.nodeSelector ? { nodeSelector: spec.nodeSelector } : {}),
-            ...(spec.nodeAffinity ? { affinity: { nodeAffinity: spec.nodeAffinity } } : {}),
-            ...(spec.topologySpreadConstraints
-                ? { topologySpreadConstraints: spec.topologySpreadConstraints }
-                : {}),
-            ...(spec.tolerations ? { tolerations: spec.tolerations } : {}),
-            ...(spec.priorityClassName ? { priorityClassName: spec.priorityClassName } : {}),
-            ...(spec.schedulerName ? { schedulerName: spec.schedulerName } : {}),
-        };
-    }
-    /**
-     * Create advanced disruption configuration for NodePools.
-     * Provides fine-grained control over when and how nodes are disrupted.
-     *
-     * @param spec - Advanced disruption specification
-     * @returns Disruption configuration object
-     *
-     * @example
-     * ```typescript
-     * const disruptionConfig = rutter.createKarpenterDisruption({
-     *   consolidationPolicy: 'WhenEmptyOrUnderutilized',
-     *   consolidateAfter: '30s',
-     *   expireAfter: '2160h', // 90 days
-     *   budgets: [{
-     *     schedule: '0 9 * * mon-fri', // Business hours
-     *     duration: '8h',
-     *     nodes: '0', // No disruption during business hours
-     *     reasons: ['Underutilized', 'Empty']
-     *   }]
-     * });
-     * ```
-     *
-     * @since 2.3.0
-     */
-    createKarpenterDisruption(spec) {
-        // Validate disruption specification
-        this.validateKarpenterDisruptionSpec(spec);
-        return {
-            ...(spec.consolidationPolicy ? { consolidationPolicy: spec.consolidationPolicy } : {}),
-            ...(spec.consolidateAfter ? { consolidateAfter: spec.consolidateAfter } : {}),
-            ...(spec.expireAfter ? { expireAfter: spec.expireAfter } : {}),
-            ...(spec.budgets ? { budgets: spec.budgets } : {}),
-        };
-    }
-    /**
-     * Validate Karpenter NodeClaim specification
-     */
-    validateKarpenterNodeClaimSpec(spec) {
-        // Validate NodeClass reference
-        if (!spec.nodeClassRef.name) {
-            throw new Error(`Karpenter NodeClaim ${spec.name}: nodeClassRef.name is required`);
-        }
-        // Validate expiration format
-        if (spec.expireAfter && !this.isValidDuration(spec.expireAfter)) {
-            throw new Error(`Karpenter NodeClaim ${spec.name}: invalid expireAfter duration format`);
-        }
-        // Validate termination grace period
-        if (spec.terminationGracePeriod && !this.isValidDuration(spec.terminationGracePeriod)) {
-            throw new Error(`Karpenter NodeClaim ${spec.name}: invalid terminationGracePeriod duration format`);
-        }
-        // Validate requirements
-        if (spec.requirements) {
-            for (const req of spec.requirements) {
-                if (['In', 'NotIn', 'Gt', 'Lt'].includes(req.operator) && !req.values?.length) {
-                    throw new Error(`Karpenter NodeClaim ${spec.name}: requirement with operator '${req.operator}' must have values`);
-                }
-            }
-        }
-    }
-    /**
-     * Validate Karpenter scheduling specification
-     */
-    validateKarpenterSchedulingSpec(spec) {
-        this.validateTopologySpreadConstraints(spec);
-        this.validateSchedulingTolerations(spec);
-    }
-    validateTopologySpreadConstraints(spec) {
-        if (!spec.topologySpreadConstraints)
-            return;
-        for (const constraint of spec.topologySpreadConstraints) {
-            if (constraint.maxSkew < 1) {
-                throw new Error(`Karpenter Scheduling ${spec.name}: maxSkew must be at least 1 in topology spread constraint`);
-            }
-            if (!constraint.topologyKey) {
-                throw new Error(`Karpenter Scheduling ${spec.name}: topologyKey is required in topology spread constraint`);
-            }
-        }
-    }
-    validateSchedulingTolerations(spec) {
-        if (!spec.tolerations)
-            return;
-        for (const toleration of spec.tolerations) {
-            if (toleration.operator === 'Equal' && !toleration.value) {
-                throw new Error(`Karpenter Scheduling ${spec.name}: value is required when operator is 'Equal' in toleration`);
-            }
-        }
-    }
-    /**
-     * Validate Karpenter disruption specification
-     */
-    validateKarpenterDisruptionSpec(spec) {
-        this.validateDisruptionDurations(spec);
-        this.validateDisruptionBudgets(spec);
-    }
-    validateDisruptionDurations(spec) {
-        if (spec.consolidateAfter && !this.isValidDuration(spec.consolidateAfter)) {
-            throw new Error('Invalid consolidateAfter duration format');
-        }
-        if (spec.expireAfter && !this.isValidDuration(spec.expireAfter)) {
-            throw new Error('Invalid expireAfter duration format');
-        }
-    }
-    validateDisruptionBudgets(spec) {
-        if (!spec.budgets)
-            return;
-        for (const budget of spec.budgets) {
-            if (budget.schedule && budget.duration) {
-                // Basic cron validation - should have 5 parts
-                const cronParts = budget.schedule.split(' ');
-                if (cronParts.length !== 5) {
-                    throw new Error('Budget schedule must be a valid cron expression with 5 parts');
-                }
-            }
-            if (budget.duration && !this.isValidDuration(budget.duration)) {
-                throw new Error('Invalid budget duration format');
-            }
-        }
-    }
-    /**
-     * Synthesizes the cdk8s app and writes a complete Helm chart
-     *
-     * Generates all Kubernetes manifests, applies Helm templating,
-     * and writes the complete chart structure to the output directory.
-     *
-     * @param {string} outDir - Output directory for the Helm chart
-     * @throws {Error} If synthesis or writing fails
-     *
-     * @example
-     * ```typescript
-     * rutter.write('./charts/my-app');
-     * // Creates: ./charts/my-app/Chart.yaml, values.yaml, templates/, etc.
-     * ```
-     *
-     * @since 1.0.0
-     */
-    write(outDir) {
-        // Use cdk8s Testing.synth to obtain manifest objects
-        const manifestObjs = Testing.synth(this.chart);
-        // Enforce common labels best-practice on all rendered objects
-        const enriched = manifestObjs.map((obj) => {
-            if (obj && typeof obj === 'object') {
-                const o = obj;
-                o.metadata = o.metadata ?? {};
-                o.metadata.labels = o.metadata.labels ?? {};
-                const labels = o.metadata.labels;
-                const defaults = {
-                    'helm.sh/chart': '{{ .Chart.Name }}-{{ .Chart.Version }}',
-                    'app.kubernetes.io/name': include(Rutter.HELPER_NAME),
-                    'app.kubernetes.io/instance': helm.releaseName,
-                    'app.kubernetes.io/version': helm.chartVersion,
-                    'app.kubernetes.io/managed-by': '{{ .Release.Service }}',
-                    'app.kubernetes.io/part-of': helm.chartName,
-                };
-                for (const [k, v] of Object.entries(defaults)) {
-                    if (!(k in labels)) {
-                        // eslint-disable-next-line security/detect-object-injection -- Safe: controlled label assignment
-                        labels[k] = v;
-                    }
-                }
-            }
-            return obj;
-        });
-        if (this.props.singleManifestFile) {
-            // Combine all resources into a single manifest file
-            const combinedYaml = enriched
-                .map((obj) => YAML.stringify(obj).trim())
-                .filter(Boolean)
-                .join('\n---\n');
-            this.assets.length = 0;
-            const manifestId = this.props.manifestName ?? 'manifests';
-            this.assets.push({ id: manifestId, yaml: combinedYaml, singleFile: true });
-        }
-        else {
-            // Create separate files for each resource (default behavior)
-            this.assets.length = 0;
-            enriched.forEach((obj, _index) => {
-                const yaml = YAML.stringify(obj).trim();
-                if (yaml) {
-                    const resourceName = this.getResourceName(obj);
-                    const manifestId = this.props.manifestName
-                        ? `${this.props.manifestName}-${resourceName}`
-                        : resourceName;
-                    this.assets.push({ id: manifestId, yaml });
-                }
-            });
-        }
-        const options = {
-            outDir,
-            meta: this.props.meta,
-            defaultValues: this.props.defaultValues
-                ? this.applyOverrides(this.props.defaultValues)
-                : undefined,
-            envValues: this.props.envValues,
-            assets: this.assets,
-            ...(this.props.helpersTpl !== undefined
-                ? { helpersTpl: this.props.helpersTpl }
-                : {
-                    helpersTpl: [
-                        {
-                            name: 'timonel.name',
-                            body: '{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}',
-                        },
-                        {
-                            name: 'timonel.fullname',
-                            body: '{{- if .Values.fullnameOverride -}}\n' +
-                                '{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}\n' +
-                                '{{- else -}}\n' +
-                                '{{- printf "%s-%s" .Chart.Name .Release.Name | trunc 63 | trimSuffix "-" -}}\n' +
-                                '{{- end -}}',
-                        },
-                        {
-                            name: 'timonel.chart',
-                            body: '{{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}',
-                        },
-                        {
-                            name: 'timonel.labels',
-                            body: 'helm.sh/chart: {{ include "timonel.chart" . }}\n' +
-                                'app.kubernetes.io/name: {{ include "timonel.name" . }}\n' +
-                                'app.kubernetes.io/instance: {{ .Release.Name }}\n' +
-                                'app.kubernetes.io/version: {{ .Chart.Version }}\n' +
-                                'app.kubernetes.io/managed-by: {{ .Release.Service }}\n' +
-                                'app.kubernetes.io/part-of: {{ .Chart.Name }}',
-                        },
-                        {
-                            name: 'timonel.selectorLabels',
-                            body: 'app.kubernetes.io/name: {{ include "timonel.name" . }}\n' +
-                                'app.kubernetes.io/instance: {{ .Release.Name }}',
-                        },
-                    ],
-                }),
-            ...(this.props.notesTpl !== undefined ? { notesTpl: this.props.notesTpl } : {}),
-            ...(this.props.valuesSchema !== undefined ? { valuesSchema: this.props.valuesSchema } : {}),
-        };
-        HelmChartWriter.write(options);
-    }
-}
-Rutter.LABEL_NAME = 'app.kubernetes.io/name';
-Rutter.LABEL_INSTANCE = 'app.kubernetes.io/instance';
-Rutter.HELPER_NAME = 'timonel.name';
-Rutter.NETWORKING_API_VERSION = 'networking.k8s.io/v1';
-Rutter.STORAGE_API_VERSION = 'storage.k8s.io/v1';
-Rutter.AZURE_DISK_CSI_DRIVER = 'disk.csi.azure.com';
-Rutter.AZURE_DISK_PROVISIONER_ANNOTATION = 'volume.beta.kubernetes.io/storage-provisioner';
-Rutter.AZURE_FILES_CSI_DRIVER = 'file.csi.azure.com';
-Rutter.EMPTY_POD_SELECTOR = {};
-//# sourceMappingURL=Rutter.js.map