timonel 2.3.0 → 2.5.0

package/dist/lib/security.d.ts

@@ -1,6 +1,13 @@
+/**
+ * @fileoverview Security utilities for input validation and sanitization
+ * Focused on CLI tool security concerns: path traversal, injection prevention
+ * @since 2.2.0
+ */
 /**
  * Security utilities for input validation and sanitization
  * Focused on CLI tool security concerns: path traversal, injection prevention
+ *
+ * @since 2.2.0
  */
 export declare class SecurityUtils {
     /**
@@ -9,12 +16,16 @@ export declare class SecurityUtils {
      * @param allowedBasePath - The base path that the input should be within
      * @returns Sanitized path if valid
      * @throws Error if path is invalid or contains traversal sequences
+     *
+     * @since 2.2.0
      */
     static validatePath(inputPath: string, allowedBasePath: string): string;
     /**
      * Sanitizes log messages to prevent log injection attacks
      * @param message - The message to sanitize
      * @returns Sanitized message with control characters removed
+     *
+     * @since 2.2.0
      */
     static sanitizeLogMessage(message: string): string;
     /**
@@ -22,30 +33,40 @@ export declare class SecurityUtils {
      * @param env - Environment name to sanitize
      * @returns Sanitized environment name
      * @throws Error if environment name is invalid
+     *
+     * @since 2.2.0
      */
     static sanitizeEnvironmentName(env: string): string;
     /**
      * Validates TypeScript file extensions for dynamic imports
      * @param filePath - The file path to validate
      * @returns True if the file has a valid TypeScript extension
+     *
+     * @since 2.2.0
      */
     static isValidTypeScriptFile(filePath: string): boolean;
     /**
      * Validates Helm template path syntax
      * @param templatePath - The template path to validate
      * @returns True if the path is valid for Helm templates
+     *
+     * @since 2.2.0
      */
     static isValidHelmTemplatePath(templatePath: string): boolean;
     /**
      * Validates chart names according to Helm conventions
      * @param chartName - Chart name to validate
      * @returns True if chart name follows Helm naming rules
+     *
+     * @since 2.2.0
      */
     static isValidChartName(chartName: string): boolean;
     /**
      * Validates subchart names according to Helm conventions
      * @param subchartName - Subchart name to validate
      * @returns True if subchart name is valid
+     *
+     * @since 2.2.0
      */
     static isValidSubchartName(subchartName: string): boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/lib/security.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM;IA2BvE;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgBlD;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAmBnD;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMvD;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAU7D;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWnD;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;CAG1D"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/lib/security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,qBAAa,aAAa;IACxB;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM;IA2BvE;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgBlD;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAmBnD;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMvD;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAU7D;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWnD;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;CAG1D"}

package/dist/lib/security.js

@@ -1,7 +1,14 @@
+/**
+ * @fileoverview Security utilities for input validation and sanitization
+ * Focused on CLI tool security concerns: path traversal, injection prevention
+ * @since 2.2.0
+ */
 import * as path from 'path';
 /**
  * Security utilities for input validation and sanitization
  * Focused on CLI tool security concerns: path traversal, injection prevention
+ *
+ * @since 2.2.0
  */
 export class SecurityUtils {
     /**
@@ -10,6 +17,8 @@ export class SecurityUtils {
      * @param allowedBasePath - The base path that the input should be within
      * @returns Sanitized path if valid
      * @throws Error if path is invalid or contains traversal sequences
+     *
+     * @since 2.2.0
      */
     static validatePath(inputPath, allowedBasePath) {
         if (!inputPath || typeof inputPath !== 'string') {
@@ -35,6 +44,8 @@ export class SecurityUtils {
      * Sanitizes log messages to prevent log injection attacks
      * @param message - The message to sanitize
      * @returns Sanitized message with control characters removed
+     *
+     * @since 2.2.0
      */
     static sanitizeLogMessage(message) {
         if (typeof message !== 'string') {
@@ -53,6 +64,8 @@ export class SecurityUtils {
      * @param env - Environment name to sanitize
      * @returns Sanitized environment name
      * @throws Error if environment name is invalid
+     *
+     * @since 2.2.0
      */
     static sanitizeEnvironmentName(env) {
         if (!env || typeof env !== 'string') {
@@ -72,6 +85,8 @@ export class SecurityUtils {
      * Validates TypeScript file extensions for dynamic imports
      * @param filePath - The file path to validate
      * @returns True if the file has a valid TypeScript extension
+     *
+     * @since 2.2.0
      */
     static isValidTypeScriptFile(filePath) {
         const allowedExtensions = ['.ts', '.tsx'];
@@ -82,6 +97,8 @@ export class SecurityUtils {
      * Validates Helm template path syntax
      * @param templatePath - The template path to validate
      * @returns True if the path is valid for Helm templates
+     *
+     * @since 2.2.0
      */
     static isValidHelmTemplatePath(templatePath) {
         if (!templatePath || typeof templatePath !== 'string') {
@@ -95,6 +112,8 @@ export class SecurityUtils {
      * Validates chart names according to Helm conventions
      * @param chartName - Chart name to validate
      * @returns True if chart name follows Helm naming rules
+     *
+     * @since 2.2.0
      */
     static isValidChartName(chartName) {
         if (!chartName || typeof chartName !== 'string') {
@@ -109,6 +128,8 @@ export class SecurityUtils {
      * Validates subchart names according to Helm conventions
      * @param subchartName - Subchart name to validate
      * @returns True if subchart name is valid
+     *
+     * @since 2.2.0
      */
     static isValidSubchartName(subchartName) {
         return this.isValidChartName(subchartName);

package/dist/lib/security.js.map

@@ -1 +1 @@
-{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/lib/security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,SAAiB,EAAE,eAAuB;QAC5D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,qCAAqC;QACrC,IACE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzB,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC1B,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/B,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC/B,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,8BAA8B;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAEnD,2DAA2D;QAC3D,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;YACzF,MAAM,IAAI,KAAK,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAe;QACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,4EAA4E;QAC5E,OAAO,CACL,OAAO;YACL,sGAAsG;aACrG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,4BAA4B;aAC5D,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,0BAA0B;aAChD,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,qCAAqC;aAC7D,IAAI,EAAE,CACV,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAAC,GAAW;QACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,oDAAoD;QACpD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAErD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAgB;QAC3C,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAoB;QACjD,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,oFAAoF;QACpF,MAAM,aAAa,GAAG,2BAA2B,CAAC;QAClD,OAAO,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAiB;QACvC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,+DAA+D;QAC/D,gGAAgG;QAChG,MAAM,cAAc,GAAG,iCAAiC,CAAC;QACzD,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAoB;QAC7C,OAAO,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/lib/security.ts"],"names":[],"mappings":"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"}

package/dist/lib/umbrella.d.ts

@@ -1,7 +1,27 @@
-import type { UmbrellaRutter, UmbrellaRutterProps } from './UmbrellaRutter.js';
+/**
+ * @fileoverview Umbrella chart utilities for managing multiple subcharts as a single unit
+ * @since 0.2.0
+ */
+import type { UmbrellaRutter, UmbrellaRutterProps } from './umbrellaRutter.js';
 /**
  * Create an umbrella chart from multiple Rutter instances
+ *
+ * @param props - Umbrella chart configuration
+ * @returns UmbrellaRutter instance for managing subcharts
+ *
+ * @example
+ * ```typescript
+ * const umbrella = createUmbrella({
+ *   meta: { name: 'my-umbrella', version: '1.0.0' },
+ *   subcharts: [
+ *     { name: 'frontend', rutter: frontendChart },
+ *     { name: 'backend', rutter: backendChart }
+ *   ]
+ * });
+ * ```
+ *
+ * @since 0.2.0
  */
 export declare function createUmbrella(props: UmbrellaRutterProps): UmbrellaRutter;
-export type { UmbrellaRutterProps, SubchartSpec } from './UmbrellaRutter.js';
+export type { UmbrellaRutterProps, SubchartSpec } from './umbrellaRutter.js';
 //# sourceMappingURL=umbrella.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"umbrella.d.ts","sourceRoot":"","sources":["../../src/lib/umbrella.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/E;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAEzE;AAGD,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"umbrella.d.ts","sourceRoot":"","sources":["../../src/lib/umbrella.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAEzE;AAGD,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/umbrella.js

@@ -1,6 +1,26 @@
-import { UmbrellaRutter as UmbrellaRutterClass } from './UmbrellaRutter.js';
+/**
+ * @fileoverview Umbrella chart utilities for managing multiple subcharts as a single unit
+ * @since 0.2.0
+ */
+import { UmbrellaRutter as UmbrellaRutterClass } from './umbrellaRutter.js';
 /**
  * Create an umbrella chart from multiple Rutter instances
+ *
+ * @param props - Umbrella chart configuration
+ * @returns UmbrellaRutter instance for managing subcharts
+ *
+ * @example
+ * ```typescript
+ * const umbrella = createUmbrella({
+ *   meta: { name: 'my-umbrella', version: '1.0.0' },
+ *   subcharts: [
+ *     { name: 'frontend', rutter: frontendChart },
+ *     { name: 'backend', rutter: backendChart }
+ *   ]
+ * });
+ * ```
+ *
+ * @since 0.2.0
  */
 export function createUmbrella(props) {
     return new UmbrellaRutterClass(props);

package/dist/lib/umbrella.js.map

@@ -1 +1 @@
-{"version":3,"file":"umbrella.js","sourceRoot":"","sources":["../../src/lib/umbrella.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,OAAO,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"umbrella.js","sourceRoot":"","sources":["../../src/lib/umbrella.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,OAAO,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/lib/umbrellaRutter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview UmbrellaRutter class for managing Helm umbrella charts with multiple subcharts
+ * @since 0.2.0
+ */
+import type { Rutter } from './rutter.js';
+import type { HelmChartMeta } from './helmChartWriter.js';
+/**
+ * Configuration for a subchart within an umbrella chart
+ *
+ * @since 0.2.0
+ */
+export interface SubchartSpec {
+    /** Name of the subchart */
+    name: string;
+    /** Rutter instance that generates the subchart */
+    rutter: Rutter;
+    /** Version of the subchart (optional) */
+    version?: string;
+    /** Helm condition for enabling/disabling the subchart */
+    condition?: string;
+    /** Tags for grouping subcharts */
+    tags?: string[];
+    /** Repository URL for the subchart */
+    repository?: string;
+}
+/**
+ * Configuration properties for UmbrellaRutter
+ *
+ * @since 0.2.0
+ */
+export interface UmbrellaRutterProps {
+    /** Metadata for the umbrella chart */
+    meta: HelmChartMeta;
+    /** Array of subchart specifications */
+    subcharts: SubchartSpec[];
+    /** Default values for the umbrella chart */
+    defaultValues?: Record<string, unknown>;
+    /** Environment-specific values */
+    envValues?: Record<string, Record<string, unknown>>;
+}
+/**
+ * UmbrellaRutter manages multiple Rutter instances as subcharts
+ * to create Helm umbrella charts with dependencies.
+ *
+ * @example
+ * ```typescript
+ * const umbrella = new UmbrellaRutter({
+ *   meta: { name: 'my-app', version: '1.0.0' },
+ *   subcharts: [
+ *     { name: 'frontend', rutter: frontendChart },
+ *     { name: 'backend', rutter: backendChart }
+ *   ]
+ * });
+ *
+ * umbrella.write('./charts/my-app');
+ * ```
+ *
+ * @since 0.2.0
+ */
+export declare class UmbrellaRutter {
+    private readonly props;
+    /**
+     * Creates a new UmbrellaRutter instance
+     *
+     * @param props - Configuration properties for the umbrella chart
+     * @throws {Error} If chart metadata is invalid
+     *
+     * @since 0.2.0
+     */
+    constructor(props: UmbrellaRutterProps);
+    private validateMetadata;
+    /**
+     * Write the umbrella chart with all subcharts to the output directory
+     *
+     * Creates the complete umbrella chart structure including:
+     * - Parent Chart.yaml with dependencies
+     * - Parent values.yaml with global and subchart values
+     * - Individual subchart directories under charts/
+     * - NOTES.txt template
+     *
+     * @param outDir - Output directory path for the umbrella chart
+     * @throws {Error} If output directory path is invalid
+     *
+     * @example
+     * ```typescript
+     * umbrella.write('./dist/my-umbrella-chart');
+     * ```
+     *
+     * @since 0.2.0
+     */
+    write(outDir: string): void;
+    private writeParentChart;
+    private writeParentValues;
+    private deepMerge;
+    private generateNotesTemplate;
+}
+//# sourceMappingURL=umbrellaRutter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"umbrellaRutter.d.ts","sourceRoot":"","sources":["../../src/lib/umbrellaRutter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAE5C;;;;;;;OAOG;gBACS,KAAK,EAAE,mBAAmB;IAMtC,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAoC3B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,qBAAqB;CAe9B"}

package/dist/lib/{UmbrellaRutter.js → umbrellaRutter.js}

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview UmbrellaRutter class for managing Helm umbrella charts with multiple subcharts
+ * @since 0.2.0
+ */
 import { writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import YAML from 'yaml';
@@ -5,8 +9,31 @@ import { SecurityUtils } from './security.js';
 /**
  * UmbrellaRutter manages multiple Rutter instances as subcharts
  * to create Helm umbrella charts with dependencies.
+ *
+ * @example
+ * ```typescript
+ * const umbrella = new UmbrellaRutter({
+ *   meta: { name: 'my-app', version: '1.0.0' },
+ *   subcharts: [
+ *     { name: 'frontend', rutter: frontendChart },
+ *     { name: 'backend', rutter: backendChart }
+ *   ]
+ * });
+ *
+ * umbrella.write('./charts/my-app');
+ * ```
+ *
+ * @since 0.2.0
  */
 export class UmbrellaRutter {
+    /**
+     * Creates a new UmbrellaRutter instance
+     *
+     * @param props - Configuration properties for the umbrella chart
+     * @throws {Error} If chart metadata is invalid
+     *
+     * @since 0.2.0
+     */
     constructor(props) {
         // Validate chart metadata
         this.validateMetadata(props.meta);
@@ -26,6 +53,22 @@ export class UmbrellaRutter {
     }
     /**
      * Write the umbrella chart with all subcharts to the output directory
+     *
+     * Creates the complete umbrella chart structure including:
+     * - Parent Chart.yaml with dependencies
+     * - Parent values.yaml with global and subchart values
+     * - Individual subchart directories under charts/
+     * - NOTES.txt template
+     *
+     * @param outDir - Output directory path for the umbrella chart
+     * @throws {Error} If output directory path is invalid
+     *
+     * @example
+     * ```typescript
+     * umbrella.write('./dist/my-umbrella-chart');
+     * ```
+     *
+     * @since 0.2.0
      */
     write(outDir) {
         // Validate output directory path
@@ -141,4 +184,4 @@ ${this.props.subcharts.map((s) => `  - charts/${s.name}/README.md`).join('\n')}
 `;
     }
 }
-//# sourceMappingURL=UmbrellaRutter.js.map
+//# sourceMappingURL=umbrellaRutter.js.map

package/dist/lib/umbrellaRutter.js.map

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

package/dist/lib/utils/helmHelpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Helm chart helpers and templates
+ * @since 2.5.0
+ */
+/**
+ * Helper definition for Helm templates
+ * @interface HelperDefinition
+ * @since 2.5.0
+ */
+export interface HelperDefinition {
+    /** Helper name (without quotes or hyphens) */
+    name: string;
+    /** Helper template content */
+    template: string;
+}
+/**
+ * Standard Helm chart helpers following best practices
+ * @since 2.5.0
+ */
+export declare const STANDARD_HELPERS: HelperDefinition[];
+/**
+ * AWS-specific Helm helpers
+ * @since 2.5.0
+ */
+export declare const AWS_HELPERS: HelperDefinition[];
+/**
+ * Azure-specific Helm helpers
+ * @since 2.5.0
+ */
+export declare const AZURE_HELPERS: HelperDefinition[];
+/**
+ * GCP-specific Helm helpers
+ * @since 2.5.0
+ */
+export declare const GCP_HELPERS: HelperDefinition[];
+/**
+ * Converts helper definitions to Helm template format
+ * @param helpers - Array of helper definitions
+ * @returns Formatted Helm template string
+ * @since 2.5.0
+ */
+export declare function formatHelpers(helpers: HelperDefinition[]): string;
+/**
+ * Gets default helpers based on cloud provider
+ * @param cloudProvider - Target cloud provider
+ * @returns Combined standard and cloud-specific helpers
+ * @since 2.5.0
+ */
+export declare function getDefaultHelpers(cloudProvider?: 'aws' | 'azure' | 'gcp'): HelperDefinition[];
+/**
+ * Generates complete _helpers.tpl content
+ * @param cloudProvider - Optional cloud provider for specific helpers
+ * @param customHelpers - Additional custom helpers
+ * @returns Complete helpers template content
+ * @since 2.5.0
+ */
+export declare function generateHelpersTemplate(cloudProvider?: 'aws' | 'azure' | 'gcp', customHelpers?: HelperDefinition[]): string;
+//# sourceMappingURL=helmHelpers.d.ts.map

package/dist/lib/utils/helmHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helmHelpers.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/helmHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAAgB,EAoC9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,EAiBzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,gBAAgB,EAa3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,EAazC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAWjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,gBAAgB,EAAE,CAgB7F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,KAAK,EACvC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GACjC,MAAM,CAQR"}

package/dist/lib/utils/helmHelpers.js

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview Helm chart helpers and templates
+ * @since 2.5.0
+ */
+/**
+ * Standard Helm chart helpers following best practices
+ * @since 2.5.0
+ */
+export const STANDARD_HELPERS = [
+    {
+        name: 'chart.name',
+        template: `{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}`,
+    },
+    {
+        name: 'chart.fullname',
+        template: `{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}`,
+    },
+    {
+        name: 'chart.chart',
+        template: `{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}`,
+    },
+    {
+        name: 'chart.labels',
+        template: `helm.sh/chart: {{ include "chart.chart" . }}
+{{ include "chart.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}`,
+    },
+    {
+        name: 'chart.selectorLabels',
+        template: `app.kubernetes.io/name: {{ include "chart.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}`,
+    },
+];
+/**
+ * AWS-specific Helm helpers
+ * @since 2.5.0
+ */
+export const AWS_HELPERS = [
+    {
+        name: 'aws.region',
+        template: `{{- .Values.aws.region | default "us-east-1" }}`,
+    },
+    {
+        name: 'aws.accountId',
+        template: `{{- required "AWS Account ID is required" .Values.aws.accountId }}`,
+    },
+    {
+        name: 'aws.irsaRoleArn',
+        template: `{{- printf "arn:aws:iam::%s:role/%s" (include "aws.accountId" .) .Values.aws.irsaRoleName }}`,
+    },
+    {
+        name: 'aws.ecrRepository',
+        template: `{{- printf "%s.dkr.ecr.%s.amazonaws.com/%s" (include "aws.accountId" .) (include "aws.region" .) .Values.aws.ecrRepositoryName }}`,
+    },
+];
+/**
+ * Azure-specific Helm helpers
+ * @since 2.5.0
+ */
+export const AZURE_HELPERS = [
+    {
+        name: 'azure.resourceGroup',
+        template: `{{- required "Azure Resource Group is required" .Values.azure.resourceGroup }}`,
+    },
+    {
+        name: 'azure.subscriptionId',
+        template: `{{- required "Azure Subscription ID is required" .Values.azure.subscriptionId }}`,
+    },
+    {
+        name: 'azure.acrLoginServer',
+        template: `{{- printf "%s.azurecr.io" .Values.azure.acrName }}`,
+    },
+];
+/**
+ * GCP-specific Helm helpers
+ * @since 2.5.0
+ */
+export const GCP_HELPERS = [
+    {
+        name: 'gcp.projectId',
+        template: `{{- required "GCP Project ID is required" .Values.gcp.projectId }}`,
+    },
+    {
+        name: 'gcp.region',
+        template: `{{- .Values.gcp.region | default "us-central1" }}`,
+    },
+    {
+        name: 'gcp.garRepository',
+        template: `{{- printf "%s-docker.pkg.dev/%s/%s" (include "gcp.region" .) (include "gcp.projectId" .) .Values.gcp.repositoryName }}`,
+    },
+];
+/**
+ * Converts helper definitions to Helm template format
+ * @param helpers - Array of helper definitions
+ * @returns Formatted Helm template string
+ * @since 2.5.0
+ */
+export function formatHelpers(helpers) {
+    return helpers
+        .map((helper) => `{{/*
+${helper.name}
+*/}}
+{{- define "${helper.name}" -}}
+${helper.template}
+{{- end }}`)
+        .join('\n\n');
+}
+/**
+ * Gets default helpers based on cloud provider
+ * @param cloudProvider - Target cloud provider
+ * @returns Combined standard and cloud-specific helpers
+ * @since 2.5.0
+ */
+export function getDefaultHelpers(cloudProvider) {
+    const helpers = [...STANDARD_HELPERS];
+    switch (cloudProvider) {
+        case 'aws':
+            helpers.push(...AWS_HELPERS);
+            break;
+        case 'azure':
+            helpers.push(...AZURE_HELPERS);
+            break;
+        case 'gcp':
+            helpers.push(...GCP_HELPERS);
+            break;
+    }
+    return helpers;
+}
+/**
+ * Generates complete _helpers.tpl content
+ * @param cloudProvider - Optional cloud provider for specific helpers
+ * @param customHelpers - Additional custom helpers
+ * @returns Complete helpers template content
+ * @since 2.5.0
+ */
+export function generateHelpersTemplate(cloudProvider, customHelpers) {
+    const helpers = getDefaultHelpers(cloudProvider);
+    if (customHelpers) {
+        helpers.push(...customHelpers);
+    }
+    return formatHelpers(helpers);
+}
+//# sourceMappingURL=helmHelpers.js.map

package/dist/lib/utils/helmHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helmHelpers.js","sourceRoot":"","sources":["../../../src/lib/utils/helmHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB;IAClD;QACE,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,6EAA6E;KACxF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE;;;;;;;;;WASH;KACR;IACD;QACE,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,gGAAgG;KAC3G;IACD;QACE,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE;;;;;qDAKuC;KAClD;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE;gDACkC;KAC7C;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC7C;QACE,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,iDAAiD;KAC5D;IACD;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,oEAAoE;KAC/E;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,8FAA8F;KACzG;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,mIAAmI;KAC9I;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C;QACE,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,gFAAgF;KAC3F;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,kFAAkF;KAC7F;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,qDAAqD;KAChE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC7C;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,oEAAoE;KAC/E;IACD;QACE,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,mDAAmD;KAC9D;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,yHAAyH;KACpI;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,OAAO,OAAO;SACX,GAAG,CACF,CAAC,MAAM,EAAE,EAAE,CAAC;EAChB,MAAM,CAAC,IAAI;;cAEC,MAAM,CAAC,IAAI;EACvB,MAAM,CAAC,QAAQ;WACN,CACN;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAuC;IACvE,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAEtC,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC7B,MAAM;QACR,KAAK,OAAO;YACV,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;YAC/B,MAAM;QACR,KAAK,KAAK;YACR,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC7B,MAAM;IACV,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAAuC,EACvC,aAAkC;IAElC,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAEjD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}