timonel 2.2.0 → 2.4.0

package/dist/lib/helm.js

@@ -1,24 +1,127 @@
 /**
- * Helpers to embed Helm template expressions while staying type-safe in TS.
+ * @fileoverview Helpers to embed Helm template expressions while staying type-safe in TypeScript.
  * We treat Helm placeholders as opaque strings that will be preserved in YAML.
+ * @since 0.1.0
+ */
+import { SecurityUtils } from './security.js';
+/**
+ * Creates a reference to a value in .Values of Helm
+ *
+ * Generates a Helm template expression that references a value
+ * in the chart's values.yaml file using dot notation.
+ *
+ * @param {string} path - Path to the value using dot notation (e.g., 'image.tag')
+ * @returns {string} Helm template expression (e.g., '{{ .Values.image.tag }}')
+ * @throws {Error} If the path is not valid for Helm templates
+ *
+ * @example
+ * ```typescript
+ * const imageTag = valuesRef('image.tag');
+ * // Returns: '{{ .Values.image.tag }}'
+ *
+ * const replicas = valuesRef('deployment.replicas');
+ * // Returns: '{{ .Values.deployment.replicas }}'
+ * ```
+ *
+ * @since 0.1.0
  */
-/** Create a .Values reference like {{ .Values.key }} */
 export function valuesRef(path) {
+    if (!isValidHelmPath(path)) {
+        throw new Error(`Invalid Helm template path: ${path}`);
+    }
     return `{{ .Values.${path} }}`;
 }
-/** Create a required .Values reference with default: {{ required msg .Values.key }} */
+/**
+ * Creates a required reference to a value in .Values of Helm
+ *
+ * Similar to valuesRef, but uses Helm's 'required' function to
+ * ensure the value is present, failing chart rendering if not provided.
+ *
+ * @param {string} path - Path to the value using dot notation
+ * @param {string} [message] - Custom error message if value is missing
+ * @returns {string} Helm template expression with required validation
+ * @throws {Error} If the path is not valid for Helm templates
+ *
+ * @example
+ * ```typescript
+ * const dbPassword = requiredValuesRef('database.password', 'Database password is required');
+ * // Returns: '{{ required "Database password is required" .Values.database.password }}'
+ *
+ * const apiKey = requiredValuesRef('api.key');
+ * // Returns: '{{ required "api.key is required" .Values.api.key }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function requiredValuesRef(path, message) {
+    if (!isValidHelmPath(path)) {
+        throw new Error(`Invalid Helm template path: ${path}`);
+    }
     const msg = message ?? `${path} is required`;
-    return `{{ required "${msg}" .Values.${path} }}`;
+    // Escape quotes and backslashes in message to prevent template injection
+    const escapedMsg = msg.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `{{ required "${escapedMsg}" .Values.${path} }}`;
+}
+/**
+ * Validates Helm template path syntax with enhanced security
+ *
+ * @private
+ * @param {string} path - Path to validate
+ * @returns {boolean} True if path is valid for Helm templates
+ * @since 0.1.0
+ */
+function isValidHelmPath(path) {
+    // Use centralized validation from SecurityUtils
+    return SecurityUtils.isValidHelmTemplatePath(path);
 }
-/** Built-in Helm references */
+/**
+ * Built-in Helm references for release and chart metadata
+ *
+ * Object containing the most common references to Helm's built-in
+ * variables for release and chart information.
+ *
+ * @namespace helm
+ * @since 0.1.0
+ *
+ * @example
+ * ```typescript
+ * const deploymentName = `${helm.releaseName}-deployment`;
+ * // Uses: '{{ .Release.Name }}-deployment'
+ *
+ * const version = helm.chartVersion;
+ * // Uses: '{{ .Chart.Version }}'
+ * ```
+ */
 export const helm = {
+    /** Release name: {{ .Release.Name }} */
     releaseName: '{{ .Release.Name }}',
+    /** Chart name: {{ .Chart.Name }} */
     chartName: '{{ .Chart.Name }}',
+    /** Chart version: {{ .Chart.Version }} */
     chartVersion: '{{ .Chart.Version }}',
+    /** Release namespace: {{ .Release.Namespace }} */
     namespace: '{{ .Release.Namespace }}',
 };
-/** Quote a Helm template expression for safe YAML embedding */
+/**
+ * Quotes a Helm template expression for safe YAML embedding
+ *
+ * Ensures Helm template expressions are properly quoted to avoid
+ * YAML parsing issues when the expression contains special characters.
+ *
+ * @param {string} expr - Helm template expression to quote
+ * @returns {string} Quoted expression if it's a Helm template, otherwise unchanged
+ *
+ * @example
+ * ```typescript
+ * const quoted = quote('{{ .Values.image.tag }}');
+ * // Returns: "'{{ .Values.image.tag }}'"
+ *
+ * const normal = quote('nginx:1.21');
+ * // Returns: "nginx:1.21"
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function quote(expr) {
     // ensure Helm templates are quoted to avoid YAML parsing issues
     if (expr.startsWith('{{') && expr.endsWith('}}')) {
@@ -26,7 +129,24 @@ export function quote(expr) {
     }
     return expr;
 }
-/** Indent helper matching Helm indent fn: {{- n indent -}} */
+/**
+ * Indents text by specified number of spaces
+ *
+ * Helper function that matches Helm's indent function behavior,
+ * adding the specified number of spaces to each non-empty line.
+ *
+ * @param {number} n - Number of spaces to indent
+ * @param {string} expr - Text to indent
+ * @returns {string} Indented text
+ *
+ * @example
+ * ```typescript
+ * const indented = indent(4, 'line1\nline2');
+ * // Returns: "    line1\n    line2"
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function indent(n, expr) {
     const spaces = ' '.repeat(n);
     return expr
@@ -34,28 +154,129 @@ export function indent(n, expr) {
         .map((l) => (l.trim().length ? spaces + l : l))
         .join('\n');
 }
-/** Insert a call to a named Helm template: {{ template "name" . }} */
+/**
+ * Inserts a call to a named Helm template using template function
+ *
+ * @param {string} name - Name of the template to call
+ * @param {string} [context='.'] - Context to pass to the template
+ * @returns {string} Helm template expression
+ *
+ * @example
+ * ```typescript
+ * const tmpl = template('myapp.labels');
+ * // Returns: '{{ template "myapp.labels" . }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function template(name, context = '.') {
     return `{{ template "${name}" ${context} }}`;
 }
-/** Insert a call to a named Helm template using include: {{ include "name" . }} */
+/**
+ * Inserts a call to a named Helm template using include function
+ *
+ * Preferred over template() as include allows piping and better error handling.
+ *
+ * @param {string} name - Name of the template to include
+ * @param {string} [context='.'] - Context to pass to the template
+ * @returns {string} Helm template expression
+ *
+ * @example
+ * ```typescript
+ * const tmpl = include('myapp.labels');
+ * // Returns: '{{ include "myapp.labels" . }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function include(name, context = '.') {
     return `{{ include "${name}" ${context} }}`;
 }
-/** Numeric value from .Values with int cast: {{ .Values.path | int }} */
+/**
+ * Creates a numeric reference from .Values with int cast
+ *
+ * Generates a Helm template expression that casts the value to integer,
+ * truncating any decimal places.
+ *
+ * @param {string} path - Path to the value using dot notation
+ * @returns {string} Helm template expression with int cast
+ * @throws {Error} If the path is not valid for Helm templates
+ *
+ * @example
+ * ```typescript
+ * const replicas = numberRef('deployment.replicas');
+ * // Returns: '{{ .Values.deployment.replicas | int }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function numberRef(path) {
+    if (!isValidHelmPath(path)) {
+        throw new Error(`Invalid Helm template path: ${path}`);
+    }
     return `{{ .Values.${path} | int }}`;
 }
-/** Boolean value from .Values with toBool cast: {{ .Values.path | toBool }} */
+/**
+ * Creates a boolean reference from .Values with toBool cast
+ *
+ * @param {string} path - Path to the value using dot notation
+ * @returns {string} Helm template expression with toBool cast
+ * @throws {Error} If the path is not valid for Helm templates
+ *
+ * @example
+ * ```typescript
+ * const enabled = boolRef('feature.enabled');
+ * // Returns: '{{ .Values.feature.enabled | toBool }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function boolRef(path) {
+    if (!isValidHelmPath(path)) {
+        throw new Error(`Invalid Helm template path: ${path}`);
+    }
     return `{{ .Values.${path} | toBool }}`;
 }
-/** String value from .Values with toString cast: {{ .Values.path | toString }} */
+/**
+ * Creates a string reference from .Values with toString cast
+ *
+ * @param {string} path - Path to the value using dot notation
+ * @returns {string} Helm template expression with toString cast
+ * @throws {Error} If the path is not valid for Helm templates
+ *
+ * @example
+ * ```typescript
+ * const version = stringRef('app.version');
+ * // Returns: '{{ .Values.app.version | toString }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function stringRef(path) {
+    if (!isValidHelmPath(path)) {
+        throw new Error(`Invalid Helm template path: ${path}`);
+    }
     return `{{ .Values.${path} | toString }}`;
 }
-/** Float value from .Values with float64 cast: {{ .Values.path | float64 }} */
+/**
+ * Creates a float reference from .Values with float64 cast
+ *
+ * @param {string} path - Path to the value using dot notation
+ * @returns {string} Helm template expression with float64 cast
+ * @throws {Error} If the path is not valid for Helm templates
+ *
+ * @example
+ * ```typescript
+ * const ratio = floatRef('scaling.ratio');
+ * // Returns: '{{ .Values.scaling.ratio | float64 }}'
+ * ```
+ *
+ * @since 0.1.0
+ */
 export function floatRef(path) {
+    if (!isValidHelmPath(path)) {
+        throw new Error(`Invalid Helm template path: ${path}`);
+    }
     return `{{ .Values.${path} | float64 }}`;
 }
 //# sourceMappingURL=helm.js.map

package/dist/lib/helm.js.map

@@ -1 +1 @@
-{"version":3,"file":"helm.js","sourceRoot":"","sources":["../../src/lib/helm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wDAAwD;AACxD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,cAAc,IAAI,KAAK,CAAC;AACjC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAgB;IAC9D,MAAM,GAAG,GAAG,OAAO,IAAI,GAAG,IAAI,cAAc,CAAC;IAC7C,OAAO,gBAAgB,GAAG,aAAa,IAAI,KAAK,CAAC;AACnD,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,WAAW,EAAE,qBAAqB;IAClC,SAAS,EAAE,mBAAmB;IAC9B,YAAY,EAAE,sBAAsB;IACpC,SAAS,EAAE,0BAA0B;CACtC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,gEAAgE;IAChE,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,IAAY;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAO,GAAG,GAAG;IAClD,OAAO,gBAAgB,IAAI,KAAK,OAAO,KAAK,CAAC;AAC/C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAO,GAAG,GAAG;IACjD,OAAO,eAAe,IAAI,KAAK,OAAO,KAAK,CAAC;AAC9C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,cAAc,IAAI,WAAW,CAAC;AACvC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,cAAc,IAAI,cAAc,CAAC;AAC1C,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,cAAc,IAAI,gBAAgB,CAAC;AAC5C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,cAAc,IAAI,eAAe,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"helm.js","sourceRoot":"","sources":["../../src/lib/helm.ts"],"names":[],"mappings":"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"}

package/dist/lib/helmChartWriter.d.ts

@@ -0,0 +1,238 @@
+/**
+ * @fileoverview Helm chart writer for generating complete Helm chart structures
+ * @since 1.0.0
+ */
+/**
+ * Metadata for a Helm chart
+ *
+ * Contains all the information needed for Chart.yaml file generation
+ * following Helm chart specification.
+ *
+ * @interface HelmChartMeta
+ * @since 1.0.0
+ */
+export interface HelmChartMeta {
+    /** Chart name */
+    name: string;
+    /** SemVer chart version */
+    version: string;
+    /** Chart description */
+    description?: string;
+    /** Underlying application version */
+    appVersion?: string;
+    /** Chart type */
+    type?: 'application' | 'library';
+    /** Kubernetes version constraint */
+    kubeVersion?: string;
+    /** Chart keywords for searchability */
+    keywords?: string[];
+    /** Chart home page URL */
+    home?: string;
+    /** Source code URLs */
+    sources?: string[];
+    /** Chart maintainers */
+    maintainers?: {
+        name: string;
+        email?: string;
+        url?: string;
+    }[];
+    /** Chart icon URL */
+    icon?: string;
+    /** Chart dependencies */
+    dependencies?: Array<{
+        name: string;
+        version: string;
+        repository: string;
+        alias?: string;
+        condition?: string | string[];
+        tags?: string[];
+        importValues?: unknown;
+    }>;
+}
+/**
+ * Environment-specific values mapping
+ *
+ * @interface EnvValuesMap
+ * @since 1.0.0
+ */
+export interface EnvValuesMap {
+    [env: string]: Record<string, unknown>;
+}
+/**
+ * Synthesized Kubernetes asset for Helm chart
+ *
+ * Represents a Kubernetes manifest that will be written to the chart's
+ * templates or crds directory.
+ *
+ * @interface SynthAsset
+ * @since 1.0.0
+ */
+export interface SynthAsset {
+    /** Filename or logical identifier */
+    id: string;
+    /** YAML content, may contain multiple documents separated by --- */
+    yaml: string;
+    /** Target directory inside chart */
+    target?: 'templates' | 'crds';
+    /** If true, don't split into multiple files even with multiple docs */
+    singleFile?: boolean;
+}
+/**
+ * Options for writing a complete Helm chart
+ *
+ * @interface HelmChartWriteOptions
+ * @since 1.0.0
+ */
+export interface HelmChartWriteOptions {
+    /** Output directory path (e.g., dist/charts/my-chart) */
+    outDir: string;
+    /** Chart metadata */
+    meta: HelmChartMeta;
+    /** Default values for values.yaml */
+    defaultValues?: Record<string, unknown> | undefined;
+    /** Environment-specific values (e.g., { dev: {...}, prod: {...} }) */
+    envValues?: EnvValuesMap | undefined;
+    /** Kubernetes manifests to place under templates/ */
+    assets: SynthAsset[];
+    /** Helm helpers content for templates/_helpers.tpl */
+    helpersTpl?: string | HelperDefinition[];
+    /** NOTES.txt content under templates/ */
+    notesTpl?: string;
+    /** JSON schema for values validation */
+    valuesSchema?: Record<string, unknown>;
+}
+/**
+ * Helm template helper definition
+ *
+ * @interface HelperDefinition
+ * @since 1.0.0
+ */
+export interface HelperDefinition {
+    /** Template name */
+    name: string;
+    /** Template body content */
+    body: string;
+}
+/**
+ * Helm chart writer for generating complete chart structures
+ *
+ * This class provides static methods to generate a complete Helm chart
+ * including Chart.yaml, values.yaml, templates, and auxiliary files.
+ *
+ * @class HelmChartWriter
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * HelmChartWriter.write({
+ *   outDir: './dist/my-chart',
+ *   meta: { name: 'my-app', version: '1.0.0' },
+ *   assets: []
+ * });
+ * ```
+ */
+export declare class HelmChartWriter {
+    /**
+     * Writes a complete Helm chart to the specified directory
+     *
+     * Creates the full directory structure and writes all necessary files
+     * for a valid Helm chart including Chart.yaml, values files, templates,
+     * and auxiliary files.
+     *
+     * @param {HelmChartWriteOptions} opts - Chart configuration options
+     * @throws {Error} If output directory path is invalid
+     * @throws {Error} If chart metadata is invalid
+     *
+     * @example
+     * ```typescript
+     * HelmChartWriter.write({
+     *   outDir: './charts/my-app',
+     *   meta: {
+     *     name: 'my-app',
+     *     version: '1.0.0',
+     *     description: 'My application'
+     *   },
+     *   defaultValues: { replicas: 3 },
+     *   assets: []
+     * });
+     * ```
+     *
+     * @since 1.0.0
+     */
+    static write(opts: HelmChartWriteOptions): void;
+    /**
+     * Creates the necessary directory structure for the chart
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @throws {Error} If directories cannot be created
+     * @since 1.0.0
+     */
+    private static createDirectories;
+    /**
+     * Writes the Chart.yaml file with chart metadata
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {HelmChartMeta} meta - Chart metadata
+     * @throws {Error} If Chart.yaml cannot be written
+     * @since 1.0.0
+     */
+    private static writeChartYaml;
+    /**
+     * Writes values.yaml and environment-specific values files
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {Record<string, unknown>} defaultValues - Default values
+     * @param {EnvValuesMap} envValues - Environment-specific values
+     * @throws {Error} If values files cannot be written
+     * @since 1.0.0
+     */
+    private static writeValuesFiles;
+    /**
+     * Writes Kubernetes manifest assets to templates directory
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {SynthAsset[]} assets - Kubernetes manifests to write
+     * @since 1.0.0
+     */
+    private static writeAssets;
+    /**
+     * Writes Helm template helpers to _helpers.tpl file
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {string | HelperDefinition[]} [helpersTpl] - Helpers content
+     * @since 1.0.0
+     */
+    private static writeHelpers;
+    /**
+     * Writes NOTES.txt file for post-install instructions
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {string} [notesTpl] - Notes content
+     * @since 1.0.0
+     */
+    private static writeNotes;
+    /**
+     * Writes values.schema.json for values validation
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {Record<string, unknown>} [valuesSchema] - JSON schema
+     * @since 1.0.0
+     */
+    private static writeSchema;
+    /**
+     * Writes .helmignore file with common ignore patterns
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @since 1.0.0
+     */
+    private static writeHelmIgnore;
+}
+//# sourceMappingURL=helmChartWriter.d.ts.map

package/dist/lib/helmChartWriter.d.ts.map

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