@kustodian/generator 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,72 @@
+# @kustodian/generator
+
+Template processing and Flux CD resource generation for Kustodian.
+
+## Installation
+
+```bash
+bun add @kustodian/generator
+```
+
+## Overview
+
+This package provides the core generation engine for transforming Kustodian templates into Flux CD resources. It handles template resolution, variable substitution, dependency validation, and output serialization.
+
+## API
+
+### Generator
+
+```typescript
+import { create_generator } from '@kustodian/generator';
+
+const generator = create_generator({
+  flux_namespace: 'flux-system',
+  git_repository_name: 'flux-system',
+});
+
+// Generate Flux resources for a cluster
+const result = await generator.generate(cluster, templates, {
+  output_dir: './output',
+});
+
+// Write generated resources to disk
+await generator.write(result.value);
+```
+
+### Flux Resource Generation
+
+- `generate_flux_kustomization()` - Creates Flux Kustomization resources
+- `generate_flux_oci_repository()` - Creates OCI Repository sources
+- `generate_depends_on()` - Resolves dependency references
+- `generate_health_checks()` - Configures health checks
+
+### Substitution Processing
+
+- `substitute_string()` / `substitute_object()` - Apply variable substitutions
+- `validate_substitutions()` - Validate required values are provided
+- `extract_external_substitutions()` - Extract 1Password/Doppler references
+
+### Namespace Management
+
+- `generate_namespace_resources()` - Generate Namespace resources
+- `collect_namespaces()` - Collect all namespaces from templates
+- `filter_system_namespaces()` - Filter out system namespaces
+
+### Dependency Validation
+
+- `validate_dependencies()` - Validate dependency graph
+- `validate_dependency_graph()` - Full graph validation with cycle detection
+- `build_dependency_graph()` - Build dependency graph from templates
+
+### Output Serialization
+
+- `serialize_resource()` / `serialize_resources()` - Serialize to YAML/JSON
+- `write_generation_result()` - Write all generated resources to disk
+
+## License
+
+MIT
+
+## Repository
+
+[github.com/lucasilverentand/kustodian](https://github.com/lucasilverentand/kustodian)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kustodian/generator",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Template processing and Flux generation for Kustodian",
   "type": "module",
   "main": "./src/index.ts",
@@ -35,10 +35,10 @@
     "registry": "https://npm.pkg.github.com"
   },
   "dependencies": {
-    "@kustodian/core": "workspace:*",
-    "@kustodian/loader": "workspace:*",
-    "@kustodian/plugins": "workspace:*",
-    "@kustodian/schema": "workspace:*",
+    "@kustodian/core": "1.0.0",
+    "@kustodian/loader": "1.0.0",
+    "@kustodian/plugins": "1.0.0",
+    "@kustodian/schema": "1.0.0",
     "yaml": "^2.8.2"
   },
   "devDependencies": {}

package/src/external-substitutions.ts

@@ -4,10 +4,7 @@ import type {
   SubstitutionType,
   TemplateType,
 } from '@kustodian/schema';
-import {
-  is_doppler_substitution,
-  is_onepassword_substitution,
-} from '@kustodian/schema';
+import { is_doppler_substitution, is_onepassword_substitution } from '@kustodian/schema';
 
 /**
  * Extracts 1Password substitutions from templates.
@@ -54,9 +51,10 @@ export function extract_doppler_substitutions(
 /**
  * Extracts all external substitutions (1Password and Doppler) from templates.
  */
-export function extract_external_substitutions(
-  templates: TemplateType[],
-): { onepassword: OnePasswordSubstitutionType[]; doppler: DopplerSubstitutionType[] } {
+export function extract_external_substitutions(templates: TemplateType[]): {
+  onepassword: OnePasswordSubstitutionType[];
+  doppler: DopplerSubstitutionType[];
+} {
   return {
     onepassword: extract_onepassword_substitutions(templates),
     doppler: extract_doppler_substitutions(templates),

package/src/flux.ts

@@ -80,13 +80,49 @@ export function generate_health_checks(
   }
 
   return kustomization.health_checks.map((check) => ({
-    apiVersion: 'apps/v1',
+    apiVersion: check.api_version ?? 'apps/v1',
     kind: check.kind,
     name: check.name,
     namespace: check.namespace ?? namespace,
   }));
 }
 
+/**
+ * Generates custom health checks with CEL expressions for a Flux Kustomization.
+ */
+export function generate_custom_health_checks(
+  kustomization: KustomizationType,
+  namespace: string,
+): FluxKustomizationType['spec']['customHealthChecks'] {
+  if (!kustomization.health_check_exprs || kustomization.health_check_exprs.length === 0) {
+    return undefined;
+  }
+
+  return kustomization.health_check_exprs.map((check) => {
+    const healthCheck: {
+      apiVersion: string;
+      kind: string;
+      namespace?: string;
+      current?: string;
+      failed?: string;
+    } = {
+      apiVersion: check.api_version,
+      kind: check.kind,
+      namespace: check.namespace ?? namespace,
+    };
+
+    if (check.current !== undefined) {
+      healthCheck.current = check.current;
+    }
+
+    if (check.failed !== undefined) {
+      healthCheck.failed = check.failed;
+    }
+
+    return healthCheck;
+  });
+}
+
 /**
  * Generates a Flux OCIRepository resource.
  */
@@ -191,6 +227,12 @@ export function generate_flux_kustomization(
     spec.healthChecks = health_checks;
   }
 
+  // Add custom health checks with CEL expressions
+  const custom_health_checks = generate_custom_health_checks(kustomization, namespace);
+  if (custom_health_checks) {
+    spec.customHealthChecks = custom_health_checks;
+  }
+
   return {
     apiVersion: 'kustomize.toolkit.fluxcd.io/v1',
     kind: 'Kustomization',

package/src/output.ts

@@ -150,7 +150,10 @@ export async function write_generation_result(
   // Write each kustomization to templates/{template-name}/{kustomization-name}.yaml
   for (const generated of result.kustomizations) {
     const template_dir = path.join(templates_dir, generated.template);
-    const file_path = path.join(template_dir, `${generated.flux_kustomization.metadata.name}.${ext}`);
+    const file_path = path.join(
+      template_dir,
+      `${generated.flux_kustomization.metadata.name}.${ext}`,
+    );
 
     const content = serialize_resource(generated.flux_kustomization, format);
     const file_result = await write_file(file_path, content, options);

package/src/types.ts

@@ -116,5 +116,14 @@ export interface FluxKustomizationType {
       name: string;
       namespace: string;
     }>;
+    customHealthChecks?: Array<{
+      apiVersion: string;
+      kind: string;
+      namespace?: string;
+      /** CEL expression for when resource is healthy/current */
+      current?: string;
+      /** CEL expression for when resource has failed */
+      failed?: string;
+    }>;
   };
 }