typekro 0.1.0

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

@@ -0,0 +1,178 @@
+import * as yaml from 'js-yaml';
+import { PathResolver } from '../../../core/yaml/path-resolver.js';
+import { isKubernetesRef } from '../../../core/dependencies/type-guards.js';
+/**
+ * Parse YAML content into Kubernetes manifests
+ */
+function parseYamlManifests(yamlContent) {
+    const documents = yaml.loadAll(yamlContent);
+    const manifests = [];
+    for (const doc of documents) {
+        if (doc && typeof doc === 'object' && 'kind' in doc && 'apiVersion' in doc) {
+            manifests.push(doc);
+        }
+    }
+    return manifests;
+}
+/**
+ * Deploy YAML files from a directory during deployment phase
+ * @example
+ * ```typescript
+ * const graph = toResourceGraph(
+ *   {
+ *     name: 'bootstrap',
+ *     apiVersion: 'example.com/v1alpha1',
+ *     kind: 'Bootstrap',
+ *     spec: type({ namespace: 'string' }),
+ *     status: type({ ready: 'boolean' })
+ *   },
+ *   (schema) => ({
+ *     // Returns closure for deployment-time execution
+ *     controllers: yamlDirectory({
+ *       name: 'flux-controllers',
+ *       path: 'git:github.com/fluxcd/flux2/manifests/install@main',
+ *       namespace: 'flux-system'
+ *     }),
+ *
+ *     // Enhanced<> resources deploy in parallel
+ *     app: simpleDeployment({
+ *       name: 'my-app',
+ *       image: 'nginx'
+ *     })
+ *   }),
+ *   (_schema, resources) => ({ ready: true })
+ * );
+ * ```
+ */
+export function yamlDirectory(config) {
+    // Return closure that will be executed during deployment
+    return async (deploymentContext) => {
+        const pathResolver = new PathResolver();
+        const yamlFiles = await pathResolver.discoverYamlFiles(config.path, {
+            recursive: config.recursive ?? true,
+            include: config.include ?? ['**/*.yaml', '**/*.yml'],
+            exclude: config.exclude ?? []
+        }, config.name);
+        const allResults = [];
+        const strategy = config.deploymentStrategy || 'replace';
+        for (const discoveredFile of yamlFiles) {
+            // Use the pre-fetched content from the discovered file
+            const manifests = parseYamlManifests(discoveredFile.content);
+            for (const manifest of manifests) {
+                // Resolve namespace references
+                const resolvedNamespace = config.namespace && isKubernetesRef(config.namespace)
+                    ? await deploymentContext.resolveReference(config.namespace)
+                    : config.namespace;
+                if (resolvedNamespace && !manifest.metadata?.namespace) {
+                    manifest.metadata = { ...manifest.metadata, namespace: resolvedNamespace };
+                }
+                try {
+                    // Apply via alchemy if scope is configured, otherwise direct to Kubernetes
+                    if (deploymentContext.alchemyScope) {
+                        // For now, use the Kubernetes API even when alchemy scope is available
+                        // TODO: Implement proper alchemy integration for YAML resources
+                        if (deploymentContext.kubernetesApi) {
+                            await deploymentContext.kubernetesApi.create(manifest);
+                        }
+                        else {
+                            throw new Error('No Kubernetes API available for YAML deployment');
+                        }
+                    }
+                    else if (deploymentContext.kubernetesApi) {
+                        await deploymentContext.kubernetesApi.create(manifest);
+                    }
+                    else {
+                        throw new Error('No deployment method available: neither alchemyScope nor kubernetesApi provided');
+                    }
+                    allResults.push({
+                        kind: manifest.kind || 'Unknown',
+                        name: manifest.metadata?.name || 'unknown',
+                        namespace: manifest.metadata?.namespace || undefined,
+                        apiVersion: manifest.apiVersion || 'v1'
+                    });
+                }
+                catch (error) {
+                    // Handle conflicts based on deployment strategy
+                    if (error?.response?.statusCode === 409 || error?.statusCode === 409) {
+                        const resourceName = `${manifest.kind}/${manifest.metadata?.name}`;
+                        if (strategy === 'skipIfExists') {
+                            console.log(`⚠️ Skipping existing resource: ${resourceName}`);
+                            allResults.push({
+                                kind: manifest.kind || 'Unknown',
+                                name: manifest.metadata?.name || 'unknown',
+                                namespace: manifest.metadata?.namespace || undefined,
+                                apiVersion: manifest.apiVersion || 'v1'
+                            });
+                        }
+                        else if (strategy === 'replace') {
+                            console.log(`🔄 Replacing existing resource: ${resourceName}`);
+                            // Try to update/replace the resource
+                            try {
+                                if (deploymentContext.kubernetesApi) {
+                                    // Check if resource exists first
+                                    let existing;
+                                    try {
+                                        const readResult = await deploymentContext.kubernetesApi.read({
+                                            apiVersion: manifest.apiVersion,
+                                            kind: manifest.kind,
+                                            metadata: {
+                                                name: manifest.metadata?.name || '',
+                                                namespace: manifest.metadata?.namespace || 'default',
+                                            },
+                                        });
+                                        existing = readResult.body;
+                                    }
+                                    catch (error) {
+                                        // If it's a 404, the resource doesn't exist
+                                        if (error.statusCode !== 404) {
+                                            throw error;
+                                        }
+                                    }
+                                    if (existing) {
+                                        // Resource exists, use patch for safer updates
+                                        await deploymentContext.kubernetesApi.patch(manifest);
+                                    }
+                                    else {
+                                        // Resource does not exist, create it
+                                        await deploymentContext.kubernetesApi.create(manifest);
+                                    }
+                                }
+                                allResults.push({
+                                    kind: manifest.kind || 'Unknown',
+                                    name: manifest.metadata?.name || 'unknown',
+                                    namespace: manifest.metadata?.namespace || undefined,
+                                    apiVersion: manifest.apiVersion || 'v1'
+                                });
+                            }
+                            catch (replaceError) {
+                                console.error(`❌ Failed to replace resource ${resourceName}:`, replaceError);
+                                throw replaceError;
+                            }
+                        }
+                        else {
+                            // strategy === 'fail' (default behavior)
+                            throw error;
+                        }
+                    }
+                    else {
+                        // Non-conflict errors should always be thrown
+                        throw error;
+                    }
+                }
+            }
+        }
+        return allResults;
+    };
+}
+/**
+ * Common Git repository paths for popular controllers
+ */
+export const GitPaths = {
+    fluxHelm: (version = 'main') => `git:github.com/fluxcd/helm-controller/config/default@${version}`,
+    fluxKustomize: (version = 'main') => `git:github.com/fluxcd/kustomize-controller/config/default@${version}`,
+    fluxSource: (version = 'main') => `git:github.com/fluxcd/source-controller/config/default@${version}`,
+    kro: (version = 'main') => `git:github.com/Azure/kro/config/default@${version}`,
+    argoCD: (version = 'stable') => `git:github.com/argoproj/argo-cd/manifests/install.yaml@${version}`,
+    istio: (version = 'master') => `git:github.com/istio/istio/manifests/charts/base@${version}`,
+};
+//# sourceMappingURL=yaml-directory.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { DeploymentClosure, AppliedResource } from '../../../core/types/deployment.js';
+import type { KubernetesRef } from '../../../core/types/common.js';
+export interface YamlFileConfig {
+    name: string;
+    path: string;
+    namespace?: string | KubernetesRef<string>;
+    deploymentStrategy?: 'replace' | 'skipIfExists' | 'fail';
+}
+/**
+ * Deploy a YAML file during deployment phase
+ *
+ * This looks like a factory function but returns a closure that executes during
+ * deployment. The closure receives deployment context (including alchemy scope)
+ * and applies manifests directly to Kubernetes in parallel with Enhanced<> resources.
+ *
+ * @example
+ * ```typescript
+ * const graph = toResourceGraph(
+ *   {
+ *     name: 'my-app',
+ *     apiVersion: 'example.com/v1alpha1',
+ *     kind: 'MyApp',
+ *     spec: type({ replicas: 'number' }),
+ *     status: type({ ready: 'boolean' })
+ *   },
+ *   (schema) => ({
+ *     // This returns a closure, stored in composition context
+ *     crds: yamlFile({
+ *       name: 'flux-crds',
+ *       path: 'git:github.com/fluxcd/flux2/manifests/crds@main'
+ *     }),
+ *
+ *     // This is a normal Enhanced<> resource
+ *     webapp: simpleDeployment({
+ *       name: 'nginx',
+ *       image: 'nginx',
+ *       replicas: schema.spec.replicas
+ *     })
+ *   }),
+ *   (_schema, resources) => ({ ready: true })
+ * );
+ * ```
+ */
+export declare function yamlFile(config: YamlFileConfig): DeploymentClosure<AppliedResource[]>;
+/**
+ * Simplified YAML file factory for quick usage
+ * @example
+ * ```typescript
+ * simpleYamlFile('./manifests/configmap.yaml')
+ * simpleYamlFile('git:github.com/fluxcd/flux2/manifests/install/flux-system.yaml@main', 'flux-system')
+ * ```
+ */
+export declare function simpleYamlFile(path: string, namespace?: string): DeploymentClosure<AppliedResource[]>;
+//# sourceMappingURL=yaml-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-file.d.ts","sourceRoot":"","sources":["../../../../src/factories/kubernetes/yaml/yaml-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAC/G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAoBnE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,kBAAkB,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CA+GrF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAOrG"}

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

@@ -0,0 +1,181 @@
+import * as yaml from 'js-yaml';
+import { PathResolver } from '../../../core/yaml/path-resolver.js';
+import { isKubernetesRef } from '../../../core/dependencies/type-guards.js';
+/**
+ * Parse YAML content into Kubernetes manifests
+ */
+function parseYamlManifests(yamlContent) {
+    const documents = yaml.loadAll(yamlContent);
+    const manifests = [];
+    for (const doc of documents) {
+        if (doc && typeof doc === 'object' && 'kind' in doc && 'apiVersion' in doc) {
+            manifests.push(doc);
+        }
+    }
+    return manifests;
+}
+/**
+ * Deploy a YAML file during deployment phase
+ *
+ * This looks like a factory function but returns a closure that executes during
+ * deployment. The closure receives deployment context (including alchemy scope)
+ * and applies manifests directly to Kubernetes in parallel with Enhanced<> resources.
+ *
+ * @example
+ * ```typescript
+ * const graph = toResourceGraph(
+ *   {
+ *     name: 'my-app',
+ *     apiVersion: 'example.com/v1alpha1',
+ *     kind: 'MyApp',
+ *     spec: type({ replicas: 'number' }),
+ *     status: type({ ready: 'boolean' })
+ *   },
+ *   (schema) => ({
+ *     // This returns a closure, stored in composition context
+ *     crds: yamlFile({
+ *       name: 'flux-crds',
+ *       path: 'git:github.com/fluxcd/flux2/manifests/crds@main'
+ *     }),
+ *
+ *     // This is a normal Enhanced<> resource
+ *     webapp: simpleDeployment({
+ *       name: 'nginx',
+ *       image: 'nginx',
+ *       replicas: schema.spec.replicas
+ *     })
+ *   }),
+ *   (_schema, resources) => ({ ready: true })
+ * );
+ * ```
+ */
+export function yamlFile(config) {
+    // Return a closure that will be executed during deployment when dependencies are ready
+    return async (deploymentContext) => {
+        const pathResolver = new PathResolver();
+        // Resolve any references in the config (e.g., namespace could reference another resource)
+        const resolvedNamespace = config.namespace && isKubernetesRef(config.namespace)
+            ? await deploymentContext.resolveReference(config.namespace)
+            : config.namespace;
+        const resolvedContent = await pathResolver.resolveContent(config.path, config.name);
+        const manifests = parseYamlManifests(resolvedContent.content);
+        const results = [];
+        const strategy = config.deploymentStrategy || 'replace';
+        for (const manifest of manifests) {
+            if (resolvedNamespace && !manifest.metadata?.namespace) {
+                manifest.metadata = { ...manifest.metadata, namespace: resolvedNamespace };
+            }
+            try {
+                // Apply via alchemy if scope is configured, otherwise direct to Kubernetes
+                if (deploymentContext.alchemyScope) {
+                    // For now, use the Kubernetes API even when alchemy scope is available
+                    // TODO: Implement proper alchemy integration for YAML resources
+                    if (deploymentContext.kubernetesApi) {
+                        await deploymentContext.kubernetesApi.create(manifest);
+                    }
+                    else {
+                        throw new Error('No Kubernetes API available for YAML deployment');
+                    }
+                }
+                else if (deploymentContext.kubernetesApi) {
+                    await deploymentContext.kubernetesApi.create(manifest);
+                }
+                else {
+                    throw new Error('No deployment method available: neither alchemyScope nor kubernetesApi provided');
+                }
+                results.push({
+                    kind: manifest.kind || 'Unknown',
+                    name: manifest.metadata?.name || 'unknown',
+                    namespace: manifest.metadata?.namespace || undefined,
+                    apiVersion: manifest.apiVersion || 'v1'
+                });
+            }
+            catch (error) {
+                // Handle conflicts based on deployment strategy
+                if (error?.response?.statusCode === 409 || error?.statusCode === 409) {
+                    const resourceName = `${manifest.kind}/${manifest.metadata?.name}`;
+                    if (strategy === 'skipIfExists') {
+                        console.log(`⚠️ Skipping existing resource: ${resourceName}`);
+                        results.push({
+                            kind: manifest.kind || 'Unknown',
+                            name: manifest.metadata?.name || 'unknown',
+                            namespace: manifest.metadata?.namespace || undefined,
+                            apiVersion: manifest.apiVersion || 'v1'
+                        });
+                    }
+                    else if (strategy === 'replace') {
+                        console.log(`🔄 Replacing existing resource: ${resourceName}`);
+                        // Try to update/replace the resource
+                        try {
+                            if (deploymentContext.kubernetesApi) {
+                                // Check if resource exists first
+                                let existing;
+                                try {
+                                    const readResult = await deploymentContext.kubernetesApi.read({
+                                        apiVersion: manifest.apiVersion,
+                                        kind: manifest.kind,
+                                        metadata: {
+                                            name: manifest.metadata?.name || '',
+                                            namespace: manifest.metadata?.namespace || 'default',
+                                        },
+                                    });
+                                    existing = readResult.body;
+                                }
+                                catch (error) {
+                                    // If it's a 404, the resource doesn't exist
+                                    if (error.statusCode !== 404) {
+                                        throw error;
+                                    }
+                                }
+                                if (existing) {
+                                    // Resource exists, use patch for safer updates
+                                    await deploymentContext.kubernetesApi.patch(manifest);
+                                }
+                                else {
+                                    // Resource does not exist, create it
+                                    await deploymentContext.kubernetesApi.create(manifest);
+                                }
+                            }
+                            results.push({
+                                kind: manifest.kind || 'Unknown',
+                                name: manifest.metadata?.name || 'unknown',
+                                namespace: manifest.metadata?.namespace || undefined,
+                                apiVersion: manifest.apiVersion || 'v1'
+                            });
+                        }
+                        catch (replaceError) {
+                            console.error(`❌ Failed to replace resource ${resourceName}:`, replaceError);
+                            throw replaceError;
+                        }
+                    }
+                    else {
+                        // strategy === 'fail' (default behavior)
+                        throw error;
+                    }
+                }
+                else {
+                    // Non-conflict errors should always be thrown
+                    throw error;
+                }
+            }
+        }
+        return results;
+    };
+}
+/**
+ * Simplified YAML file factory for quick usage
+ * @example
+ * ```typescript
+ * simpleYamlFile('./manifests/configmap.yaml')
+ * simpleYamlFile('git:github.com/fluxcd/flux2/manifests/install/flux-system.yaml@main', 'flux-system')
+ * ```
+ */
+export function simpleYamlFile(path, namespace) {
+    const name = path.split('/').pop()?.replace(/\.(yaml|yml)$/, '') || 'yaml-file';
+    return yamlFile({
+        name,
+        path,
+        ...(namespace && { namespace })
+    });
+}
+//# sourceMappingURL=yaml-file.js.map

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

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

package/dist/factories/shared.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared utilities for factory functions
+ *
+ * This module contains common utilities and helper functions that are used
+ * across all factory modules for creating Kubernetes resources.
+ */
+import type { V1PodSpec } from '@kubernetes/client-node';
+import type { Enhanced, KubernetesResource } from '../core/types.js';
+export declare function createResource<TSpec extends object, TStatus extends object>(resource: KubernetesResource<TSpec, TStatus>): Enhanced<TSpec, TStatus>;
+export declare function processPodSpec(podSpec?: V1PodSpec): V1PodSpec | undefined;
+//# sourceMappingURL=shared.d.ts.map

package/dist/factories/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/factories/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAInE,OAAO,KAAK,EACV,QAAQ,EACR,kBAAkB,EAGnB,MAAM,kBAAkB,CAAC;AA6T1B,wBAAgB,cAAc,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EACzE,QAAQ,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAwD1B;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAoBzE"}