@shepherdjerred/helm-types 1.7.0 → 2.0.0

package/dist/yaml-preprocess.js

@@ -0,0 +1,170 @@
+/**
+ * Pre-process YAML to uncomment commented-out keys
+ * In Helm charts, commented-out keys are documentation of available options
+ * e.g., "## key: value" or "# key: value"
+ *
+ * This allows us to parse them as real keys and associate their comments
+ *
+ * Only uncomments keys that are:
+ * - At root level or similar indentation to real keys
+ * - Not part of "Example:" blocks
+ * - Not part of documentation prose (have their own dedicated comment block)
+ * - Not deeply nested (which would indicate example YAML)
+ */
+/**
+ * Check if a line is an "Example:" marker
+ */
+function isExampleMarker(trimmed) {
+    return /^##?\s*Example:?$/i.test(trimmed);
+}
+/**
+ * Check if an example block should end
+ */
+function shouldExitExampleBlock(trimmed) {
+    return (!trimmed ||
+        trimmed.startsWith("For more information") ||
+        trimmed.startsWith("Ref:"));
+}
+/**
+ * Check if the previous line had a block scalar indicator
+ */
+function prevLineHasBlockScalar(lines, i) {
+    if (i <= 0) {
+        return false;
+    }
+    const prevTrimmed = lines[i - 1]?.trim() ?? "";
+    return /^#+\s*[\w.-]+:\s*[|>]\s*$/.test(prevTrimmed);
+}
+/**
+ * Check if a line is still in a block scalar (indented content)
+ */
+function isBlockScalarContent(line, trimmed) {
+    if (trimmed.length === 0) {
+        return false;
+    }
+    return (line.startsWith("  ") || line.startsWith("\t") || /^#\s{2,}/.test(line));
+}
+/**
+ * Check if a commented key value looks like it should be excluded
+ */
+function isExcludedCommentedKey(keyValue) {
+    const isDocReference = /^ref:/i.test(keyValue) &&
+        (keyValue.includes("http://") || keyValue.includes("https://"));
+    const isURL = keyValue.trim().startsWith("http://") ||
+        keyValue.trim().startsWith("https://");
+    return isDocReference || isURL;
+}
+/**
+ * Determine if a commented key looks like a YAML example based on context
+ */
+function isLikelyExample(lines, i) {
+    const prevLine = i > 0 ? lines[i - 1] : "";
+    const prevTrimmed = prevLine?.trim() ?? "";
+    const prevIsCommentedKey = /^#+\s*[\w.-]+:\s/.test(prevTrimmed);
+    const prevIsBlank = !prevTrimmed;
+    const prevIsListItem = prevTrimmed.startsWith("#") && prevTrimmed.slice(1).trim().startsWith("-");
+    return ((!prevIsBlank && !prevIsCommentedKey && prevTrimmed.startsWith("#")) ||
+        prevIsListItem);
+}
+/**
+ * Update consecutive commented key count based on context
+ */
+function updateConsecutiveCount(lines, i, current) {
+    const prevLine = i > 0 ? lines[i - 1] : "";
+    const prevTrimmed = prevLine?.trim() ?? "";
+    const prevIsCommentedKey = /^#+\s*[\w.-]+:\s/.test(prevTrimmed);
+    const prevIsBlank = !prevTrimmed;
+    if (prevIsCommentedKey) {
+        return current + 1;
+    }
+    if (!prevIsBlank) {
+        return 0;
+    }
+    return current;
+}
+/**
+ * Try to uncomment a commented YAML key line. Returns the uncommented line or null.
+ */
+function tryUncommentLine(line, lines, i, state) {
+    const commentedKeyMatch = /^([ \t]*)#+\s*([\w.-]+:\s*(?:\S.*)?)$/.exec(line);
+    if (!commentedKeyMatch) {
+        return { uncommented: null, newConsecutive: 0 };
+    }
+    const [, indent, keyValue] = commentedKeyMatch;
+    if (keyValue === "" || indent === "" || keyValue == null || indent == null) {
+        return {
+            uncommented: null,
+            newConsecutive: state.consecutiveCommentedKeys,
+        };
+    }
+    const keyPart = keyValue.split(":")[0]?.trim() ?? "";
+    const isValidKey = /^[\w.-]+$/.test(keyPart);
+    if (!isValidKey || isExcludedCommentedKey(keyValue)) {
+        return {
+            uncommented: null,
+            newConsecutive: state.consecutiveCommentedKeys,
+        };
+    }
+    const keyIndent = indent.length;
+    const newConsecutive = updateConsecutiveCount(lines, i, state.consecutiveCommentedKeys);
+    const likelyExampleCtx = isLikelyExample(lines, i);
+    const shouldUncomment = !likelyExampleCtx &&
+        (state.lastRealKeyIndent === -1 ||
+            Math.abs(keyIndent - state.lastRealKeyIndent) <= 4 ||
+            newConsecutive >= 2);
+    if (shouldUncomment) {
+        return { uncommented: `${indent}${keyValue}`, newConsecutive };
+    }
+    return { uncommented: null, newConsecutive };
+}
+export function preprocessYAMLComments(yamlContent) {
+    const lines = yamlContent.split("\n");
+    const processedLines = [];
+    const state = {
+        inExampleBlock: false,
+        inBlockScalar: false,
+        lastRealKeyIndent: -1,
+        consecutiveCommentedKeys: 0,
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        if (isExampleMarker(trimmed)) {
+            state.inExampleBlock = true;
+            processedLines.push(line);
+            continue;
+        }
+        if (state.inExampleBlock && shouldExitExampleBlock(trimmed)) {
+            state.inExampleBlock = false;
+        }
+        if (prevLineHasBlockScalar(lines, i)) {
+            state.inBlockScalar = true;
+        }
+        if (state.inBlockScalar && !isBlockScalarContent(line, trimmed)) {
+            state.inBlockScalar = false;
+        }
+        if (!trimmed.startsWith("#") && /^[\w.-]+:/.test(trimmed)) {
+            state.lastRealKeyIndent = line.search(/\S/);
+            state.consecutiveCommentedKeys = 0;
+        }
+        if (state.inExampleBlock || state.inBlockScalar) {
+            processedLines.push(line);
+            state.consecutiveCommentedKeys = 0;
+            continue;
+        }
+        const { uncommented, newConsecutive } = tryUncommentLine(line, lines, i, state);
+        state.consecutiveCommentedKeys = newConsecutive;
+        if (uncommented != null) {
+            processedLines.push(uncommented);
+            continue;
+        }
+        // Reset consecutive count if not a commented key
+        const isCommentedKey = /^[ \t]*#+\s*[\w.-]+:\s*(?:\S.*)?$/.test(line);
+        if (!isCommentedKey) {
+            state.consecutiveCommentedKeys = 0;
+        }
+        processedLines.push(line);
+    }
+    return processedLines.join("\n");
+}
+//# sourceMappingURL=yaml-preprocess.js.map

package/dist/yaml-preprocess.js.map

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

package/examples/argo-cd/generate.mjs

@@ -0,0 +1,23 @@
+import {
+  convertToTypeScriptInterface,
+  fetchHelmChart,
+  generateTypeScriptCode,
+} from "@shepherdjerred/helm-types";
+
+const chart = {
+  name: "argo-cd",
+  chartName: "argo-cd",
+  repoUrl: "https://argoproj.github.io/argo-helm",
+  version: "7.7.16",
+};
+
+const { schema, values, yamlComments } = await fetchHelmChart(chart);
+const types = convertToTypeScriptInterface({
+  values,
+  interfaceName: "ArgoCdValues",
+  schema,
+  yamlComments,
+  chartName: chart.name,
+});
+
+process.stdout.write(generateTypeScriptCode(types, chart.name));

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@shepherdjerred/helm-types",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "description": "Generate TypeScript types from Helm chart values.yaml and values.schema.json",
   "type": "module",
   "main": "dist/index.js",
-  "types": "src/index.ts",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
@@ -16,12 +16,14 @@
   },
   "files": [
     "dist",
-    "src",
-    "!src/**/*.test.ts",
-    "!src/__snapshots__"
+    "examples",
+    "demos",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "bun build src/index.ts src/cli.ts --outdir dist --target node",
+    "build": "PATH=node_modules/@typescript/native/bin:$PATH tsc -p tsconfig.build.json",
     "test": "bun --no-install --bun vitest --config ../../../../vitest.config.ts run",
     "test:helm-types": "bun --no-install --bun vitest --config ../../../../vitest.config.ts run src/helm-types.test.ts",
     "test:cli": "bun --no-install --bun vitest --config ../../../../vitest.config.ts run src/cli.test.ts",
@@ -30,9 +32,9 @@
     "typecheck": "PATH=node_modules/@typescript/native/bin:$PATH tsc --noEmit",
     "prepublishOnly": "bun run build",
     "generate:live": "bun run src/cli.ts",
-    "publish:npm": "bun ../../../../scripts/publish-npm.ts .",
-    "test:ci": "bun ../../../../scripts/run-ci-test.ts",
-    "test:report": "CI_TEST_COVERAGE=1 bun ../../../../scripts/run-ci-test.ts"
+    "publish:npm": "bun ../../../../scripts/release/publish-npm.ts .",
+    "test:ci": "bun ../../../../scripts/ci/run-ci-test.ts",
+    "test:report": "CI_TEST_COVERAGE=1 bun ../../../../scripts/ci/run-ci-test.ts"
   },
   "keywords": [
     "helm",
@@ -43,7 +45,7 @@
     "k8s"
   ],
   "author": "Jerred Shepherd",
-  "license": "GPL-3.0",
+  "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/shepherdjerred/monorepo.git",
@@ -57,7 +59,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=24"
   },
   "dependencies": {
     "yaml": "^2.8.3",
@@ -65,7 +67,10 @@
   },
   "devDependencies": {
     "@shepherdjerred/eslint-config": "0.3.0",
+    "@tsconfig/node24": "^24.0.4",
+    "@tsconfig/strictest": "^2.0.8",
     "@types/bun": "1.4.0",
+    "@types/node": "^26.1.1",
     "eslint": "^10.3.0",
     "jiti": "^2.7.0",
     "@typescript/native": "npm:typescript@7.0.2",

package/src/__fixtures__/sample-chart/Chart.yaml

@@ -1,6 +0,0 @@
-apiVersion: v2
-name: sample-chart
-description: A minimal local chart fixture for helm-types CLI tests (no network)
-type: application
-version: "1.2.3"
-appVersion: "4.5.6"

package/src/__fixtures__/sample-chart/values.schema.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "replicaCount": {
-      "type": "integer",
-      "description": "Number of pod replicas to run."
-    },
-    "image": {
-      "type": "object",
-      "properties": {
-        "repository": { "type": "string" },
-        "pullPolicy": {
-          "type": "string",
-          "enum": ["Always", "IfNotPresent", "Never"]
-        },
-        "tag": { "type": "string" }
-      }
-    },
-    "serviceEnabled": {
-      "type": "boolean",
-      "description": "Whether the service is enabled."
-    },
-    "service": {
-      "type": "object",
-      "properties": {
-        "type": { "type": "string" },
-        "port": { "type": "integer" }
-      }
-    }
-  }
-}

package/src/__fixtures__/sample-chart/values.yaml

@@ -1,22 +0,0 @@
-# -- Number of pod replicas to run.
-replicaCount: 2
-
-image:
-  # -- Container image repository.
-  repository: nginx
-  # -- Image pull policy.
-  pullPolicy: IfNotPresent
-  # -- Image tag; defaults to the chart appVersion when empty.
-  tag: "@sha256:5a88c9c45479443d7be2eadc894b4ed0a9801bae03d97a5760ae13b5c2005942"
-
-# -- Whether the service is enabled.
-serviceEnabled: true
-
-service:
-  # -- Kubernetes service type.
-  type: ClusterIP
-  # -- Service port.
-  port: 80
-
-# -- Extra environment variables passed to the container.
-extraEnv: []

package/src/chart-fetcher.ts

@@ -1,221 +0,0 @@
-// Using Bun.$ for path operations instead of node:path
-import { parse as yamlParse } from "yaml";
-import type { ChartInfo, JSONSchemaProperty } from "./types.ts";
-import { HelmValueSchema, RecordSchema, ErrorSchema } from "./schemas.ts";
-import type { HelmValue } from "./schemas.ts";
-import { parseYAMLComments } from "./yaml-comments.ts";
-
-/**
- * Load JSON schema if it exists in the chart
- */
-async function loadJSONSchema(
-  chartPath: string,
-): Promise<JSONSchemaProperty | null> {
-  try {
-    const schemaPath = `${chartPath}/values.schema.json`;
-    const schemaContent = await Bun.file(schemaPath).text();
-    const parsed: unknown = JSON.parse(schemaContent);
-    // Validate that parsed is an object
-    const recordCheck = RecordSchema.safeParse(parsed);
-    if (!recordCheck.success) {
-      return null;
-    }
-    // Note: JSONSchemaProperty is a structural type
-    const schema: JSONSchemaProperty = recordCheck.data;
-    console.log(`  📋 Loaded values.schema.json`);
-    return schema;
-  } catch {
-    // Schema doesn't exist or couldn't be parsed - that's okay
-    return null;
-  }
-}
-
-/**
- * Run a command and return its output using Bun
- */
-async function runCommand(command: string, args: string[]): Promise<string> {
-  try {
-    const proc = Bun.spawn([command, ...args], {
-      stdout: "pipe",
-      stderr: "inherit",
-    });
-
-    const output = await new Response(proc.stdout).text();
-    const exitCode = await proc.exited;
-
-    if (exitCode === 0) {
-      return output;
-    } else {
-      throw new Error(
-        `Command "${command} ${args.join(" ")}" failed with code ${exitCode.toString()}`,
-      );
-    }
-  } catch (error) {
-    const parseResult = ErrorSchema.safeParse(error);
-    const errorMessage = parseResult.success
-      ? parseResult.data.message
-      : String(error);
-    throw new Error(
-      `Failed to spawn command "${command} ${args.join(" ")}": ${errorMessage}`,
-      { cause: error },
-    );
-  }
-}
-
-/**
- * Locate the directory `helm pull --untar` created. helm names it after the
- * Chart.yaml `name`, which can differ from the OCI artifact path (e.g.
- * a chart at `foo/charts/foo` untars to `foo/`), so prefer the version-key fallback
- * but fall back to scanning for the extracted Chart.yaml.
- */
-async function resolveUntarredChartDir(
-  tempDir: string,
-  fallbackName: string,
-): Promise<string> {
-  const fallback = `${tempDir}/${fallbackName}`;
-  if (await Bun.file(`${fallback}/Chart.yaml`).exists()) {
-    return fallback;
-  }
-  const lsOutput = await runCommand("ls", ["-1", tempDir]);
-  for (const entry of lsOutput.split("\n").map((s) => s.trim())) {
-    if (entry === "") {
-      continue;
-    }
-    if (await Bun.file(`${tempDir}/${entry}/Chart.yaml`).exists()) {
-      return `${tempDir}/${entry}`;
-    }
-  }
-  return fallback;
-}
-
-/**
- * Fetch a Helm chart and extract its values.yaml and optional schema
- */
-export async function fetchHelmChart(chart: ChartInfo): Promise<{
-  values: HelmValue;
-  schema: JSONSchemaProperty | null;
-  yamlComments: Map<string, string>;
-}> {
-  const pwd = Bun.env["PWD"] ?? process.cwd();
-  const tempDir = `${pwd}/temp/helm-${chart.name}`;
-  const repoName = `temp-repo-${chart.name}-${String(Date.now())}`;
-
-  try {
-    // Ensure temp directory exists
-    await Bun.$`mkdir -p ${tempDir}`.quiet();
-
-    let chartDir: string;
-    if (chart.oci === true) {
-      // OCI registry: pull directly, no `helm repo add` needed.
-      const ociRef = `oci://${chart.repoUrl}/${chart.chartName}`;
-      console.log(`  ⬇️  Pulling OCI chart ${ociRef}:${chart.version}...`);
-      await runCommand("helm", [
-        "pull",
-        ociRef,
-        "--version",
-        chart.version,
-        "--destination",
-        tempDir,
-        "--untar",
-      ]);
-      chartDir = await resolveUntarredChartDir(tempDir, chart.name);
-    } else {
-      console.log(`  📦 Adding Helm repo: ${chart.repoUrl}`);
-      // Add the helm repo
-      await runCommand("helm", ["repo", "add", repoName, chart.repoUrl]);
-
-      console.log(`  🔄 Updating Helm repo ${repoName}...`);
-      // Update ONLY the repo we just added. `helm repo update` with no args
-      // refreshes every repo in the local helm config — including unrelated
-      // stale entries (e.g. the retired public bitnami repo) whose failure
-      // would abort an otherwise-fine fetch.
-      await runCommand("helm", ["repo", "update", repoName]);
-
-      console.log(`  ⬇️  Pulling chart ${chart.chartName}:${chart.version}...`);
-      // Pull the chart
-      await runCommand("helm", [
-        "pull",
-        `${repoName}/${chart.chartName}`,
-        "--version",
-        chart.version,
-        "--destination",
-        tempDir,
-        "--untar",
-      ]);
-      chartDir = `${tempDir}/${chart.chartName}`;
-    }
-
-    // Read values.yaml
-    const valuesPath = `${chartDir}/values.yaml`;
-    console.log(`  📖 Reading values.yaml from ${valuesPath}`);
-
-    try {
-      const valuesContent = await Bun.file(valuesPath).text();
-
-      // Parse YAML comments
-      const yamlComments = parseYAMLComments(valuesContent);
-      console.log(
-        `  💬 Extracted ${String(yamlComments.size)} comments from values.yaml`,
-      );
-
-      // Parse YAML using yaml package
-      const parsedValues = yamlParse(valuesContent) as unknown;
-      console.log(`  ✅ Successfully parsed values.yaml`);
-      const recordParseResult = RecordSchema.safeParse(parsedValues);
-      if (recordParseResult.success) {
-        console.log(
-          `  🔍 Parsed values keys: ${Object.keys(recordParseResult.data)
-            .slice(0, 10)
-            .join(
-              ", ",
-            )}${Object.keys(recordParseResult.data).length > 10 ? "..." : ""}`,
-        );
-      }
-
-      // Check if parsedValues is a valid object using Zod before validation
-      if (!recordParseResult.success) {
-        console.warn(
-          `  ⚠️  Parsed values is not a valid record object: ${String(parsedValues)}`,
-        );
-        return { values: {}, schema: null, yamlComments: new Map() };
-      }
-
-      // Validate and parse with Zod for runtime type safety
-      const parseResult = HelmValueSchema.safeParse(recordParseResult.data);
-
-      // Try to load JSON schema
-      const schema = await loadJSONSchema(chartDir);
-
-      if (parseResult.success) {
-        console.log(`  ✅ Zod validation successful`);
-        return { values: parseResult.data, schema, yamlComments };
-      } else {
-        console.warn(`  ⚠️  Zod validation failed for ${chart.name}:`);
-        console.warn(
-          `    First few errors:`,
-          parseResult.error.issues.slice(0, 3),
-        );
-        console.warn(
-          `  ⚠️  Falling back to unvalidated object for type generation`,
-        );
-        // Return the validated record data from the successful parse result
-        return { values: recordParseResult.data, schema, yamlComments };
-      }
-    } catch (error) {
-      console.warn(`  ⚠️  Failed to read/parse values.yaml: ${String(error)}`);
-      return { values: {}, schema: null, yamlComments: new Map() };
-    }
-  } finally {
-    // Cleanup
-    try {
-      console.log(`  🧹 Cleaning up...`);
-      // OCI charts never added a named repo, so only remove for HTTP repos.
-      if (chart.oci !== true) {
-        await runCommand("helm", ["repo", "remove", repoName]);
-      }
-      await Bun.$`rm -rf ${tempDir}`.quiet();
-    } catch (cleanupError) {
-      console.warn(`Cleanup failed for ${chart.name}:`, String(cleanupError));
-    }
-  }
-}

package/src/chart-info-parser.ts

@@ -1,64 +0,0 @@
-import type { ChartInfo } from "./types.ts";
-
-/**
- * Parse chart information from versions.ts comments and values
- */
-export async function parseChartInfoFromVersions(
-  versionsPath = "src/versions.ts",
-): Promise<ChartInfo[]> {
-  const content = await Bun.file(versionsPath).text();
-  const lines = content.split("\n");
-  const charts: ChartInfo[] = [];
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const nextLine = lines[i + 1];
-
-    // Look for renovate comments that indicate Helm charts
-    if (
-      line == null ||
-      nextLine == null ||
-      nextLine === "" ||
-      !line.includes("renovate: datasource=helm")
-    ) {
-      continue;
-    }
-
-    const repoUrlMatch = /registryUrl=(\S+)/.exec(line);
-    const versionKeyMatch = /^\s*"?([^":\s]+)"?:/.exec(nextLine);
-    if (!repoUrlMatch || !versionKeyMatch) {
-      continue;
-    }
-
-    const repoUrl = repoUrlMatch[1];
-    const versionKey = versionKeyMatch[1];
-    if (
-      repoUrl === "" ||
-      versionKey === "" ||
-      repoUrl == null ||
-      versionKey == null
-    ) {
-      continue;
-    }
-
-    // Extract version value
-    const versionMatch = /:\s*"([^"]+)"/.exec(nextLine);
-    if (!versionMatch) {
-      continue;
-    }
-
-    const version = versionMatch[1];
-    if (version === "" || version == null) {
-      continue;
-    }
-
-    charts.push({
-      name: versionKey,
-      repoUrl: repoUrl.replace(/\/$/, ""), // Remove trailing slash
-      version,
-      chartName: versionKey,
-    });
-  }
-
-  return charts;
-}