timonel 2.10.2 → 2.11.0

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

@@ -0,0 +1,221 @@
+export const OBSERVABILITY_HELPERS = [
+    {
+        name: 'monitoring.serviceMonitor',
+        template: `{{- if and .Values.serviceMonitor.enabled .Values.metrics.enabled -}}
+apiVersion: monitoring.coreos.com/v1
+kind: ServiceMonitor
+metadata:
+  name: {{ include "chart.fullname" . }}
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "chart.labels" . | nindent 4 }}
+    {{- with .Values.serviceMonitor.labels }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
+  {{- with .Values.serviceMonitor.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  selector:
+    matchLabels:
+      {{- include "chart.selectorLabels" . | nindent 6 }}
+      {{- with .Values.serviceMonitor.selector }}
+      {{- toYaml . | nindent 6 }}
+      {{- end }}
+  endpoints:
+    - port: {{ .Values.metrics.port | default "metrics" }}
+      path: {{ .Values.metrics.path | default "/metrics" }}
+      interval: {{ .Values.serviceMonitor.interval | default "30s" }}
+      scrapeTimeout: {{ .Values.serviceMonitor.scrapeTimeout | default "10s" }}
+      {{- with .Values.serviceMonitor.metricRelabelings }}
+      metricRelabelings:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.serviceMonitor.relabelings }}
+      relabelings:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+{{- end }}`,
+    },
+    {
+        name: 'monitoring.prometheusRule',
+        template: `{{- if .Values.prometheusRule.enabled -}}
+apiVersion: monitoring.coreos.com/v1
+kind: PrometheusRule
+metadata:
+  name: {{ include "chart.fullname" . }}
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "chart.labels" . | nindent 4 }}
+    {{- with .Values.prometheusRule.labels }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
+spec:
+  groups:
+    - name: {{ include "chart.fullname" . }}
+      rules:
+        {{- with .Values.prometheusRule.rules }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+{{- end }}`,
+    },
+    {
+        name: 'tracing.jaegerConfig',
+        template: `{{- if .Values.tracing.enabled -}}
+JAEGER_AGENT_HOST: {{ .Values.tracing.jaeger.agent.host | default "jaeger-agent" }}
+JAEGER_AGENT_PORT: {{ .Values.tracing.jaeger.agent.port | default "6831" }}
+JAEGER_ENDPOINT: {{ .Values.tracing.jaeger.endpoint | default "" }}
+JAEGER_SERVICE_NAME: {{ include "chart.fullname" . }}
+JAEGER_SAMPLER_TYPE: {{ .Values.tracing.jaeger.sampler.type | default "const" }}
+JAEGER_SAMPLER_PARAM: {{ .Values.tracing.jaeger.sampler.param | default "1" }}
+JAEGER_REPORTER_MAX_QUEUE_SIZE: {{ .Values.tracing.jaeger.reporter.maxQueueSize | default "100" }}
+JAEGER_REPORTER_FLUSH_INTERVAL: {{ .Values.tracing.jaeger.reporter.flushInterval | default "1s" }}
+{{- with .Values.tracing.jaeger.tags }}
+JAEGER_TAGS: {{ . | join "," }}
+{{- end }}
+{{- end }}`,
+    },
+    {
+        name: 'tracing.otlpConfig',
+        template: `{{- if .Values.tracing.enabled -}}
+OTEL_SERVICE_NAME: {{ include "chart.fullname" . }}
+OTEL_SERVICE_VERSION: {{ .Chart.AppVersion }}
+OTEL_RESOURCE_ATTRIBUTES: service.name={{ include "chart.fullname" . }},service.version={{ .Chart.AppVersion }},deployment.environment={{ .Values.environment | default "development" }}
+{{- if .Values.tracing.otlp.endpoint }}
+OTEL_EXPORTER_OTLP_ENDPOINT: {{ .Values.tracing.otlp.endpoint }}
+{{- end }}
+{{- if .Values.tracing.otlp.headers }}
+OTEL_EXPORTER_OTLP_HEADERS: {{ .Values.tracing.otlp.headers | join "," }}
+{{- end }}
+OTEL_TRACES_SAMPLER: {{ .Values.tracing.otlp.sampler | default "parentbased_traceidratio" }}
+OTEL_TRACES_SAMPLER_ARG: {{ .Values.tracing.otlp.samplerArg | default "1.0" }}
+{{- end }}`,
+    },
+    {
+        name: 'logging.structured',
+        template: `LOG_LEVEL: {{ .Values.logging.level | default "info" }}
+LOG_FORMAT: {{ .Values.logging.format | default "json" }}
+{{- if .Values.logging.correlation.enabled }}
+LOG_CORRELATION_ENABLED: "true"
+LOG_CORRELATION_HEADER: {{ .Values.logging.correlation.header | default "X-Correlation-ID" }}
+{{- end }}
+{{- if .Values.logging.sampling.enabled }}
+LOG_SAMPLING_ENABLED: "true"
+LOG_SAMPLING_RATE: {{ .Values.logging.sampling.rate | default "0.1" }}
+{{- end }}`,
+    },
+    {
+        name: 'logging.fluentdConfig',
+        template: `{{- if .Values.logging.fluentd.enabled -}}
+FLUENTD_HOST: {{ .Values.logging.fluentd.host | default "fluentd" }}
+FLUENTD_PORT: {{ .Values.logging.fluentd.port | default "24224" }}
+FLUENTD_TAG: {{ .Values.logging.fluentd.tag | default (include "chart.fullname" .) }}
+FLUENTD_BUFFER_LIMIT: {{ .Values.logging.fluentd.bufferLimit | default "8MB" }}
+FLUENTD_TIMEOUT: {{ .Values.logging.fluentd.timeout | default "3.0" }}
+{{- end }}`,
+    },
+    {
+        name: 'metrics.annotations',
+        template: `{{- if .Values.metrics.enabled -}}
+prometheus.io/scrape: "true"
+prometheus.io/port: "{{ .Values.metrics.port | default 9090 }}"
+prometheus.io/path: "{{ .Values.metrics.path | default "/metrics" }}"
+{{- if .Values.metrics.scheme }}
+prometheus.io/scheme: "{{ .Values.metrics.scheme }}"
+{{- end }}
+{{- end }}`,
+    },
+    {
+        name: 'health.probes',
+        template: `{{- $healthPath := .Values.health.path | default "/health" -}}
+{{- $readyPath := .Values.health.readiness.path | default "/ready" -}}
+{{- $port := .Values.service.port | default 8080 -}}
+livenessProbe:
+  httpGet:
+    path: {{ $healthPath }}
+    port: {{ $port }}
+    {{- if .Values.health.liveness.httpHeaders }}
+    httpHeaders:
+      {{- toYaml .Values.health.liveness.httpHeaders | nindent 6 }}
+    {{- end }}
+  initialDelaySeconds: {{ .Values.health.liveness.initialDelaySeconds | default 30 }}
+  periodSeconds: {{ .Values.health.liveness.periodSeconds | default 10 }}
+  timeoutSeconds: {{ .Values.health.liveness.timeoutSeconds | default 5 }}
+  successThreshold: {{ .Values.health.liveness.successThreshold | default 1 }}
+  failureThreshold: {{ .Values.health.liveness.failureThreshold | default 3 }}
+readinessProbe:
+  httpGet:
+    path: {{ $readyPath }}
+    port: {{ $port }}
+    {{- if .Values.health.readiness.httpHeaders }}
+    httpHeaders:
+      {{- toYaml .Values.health.readiness.httpHeaders | nindent 6 }}
+    {{- end }}
+  initialDelaySeconds: {{ .Values.health.readiness.initialDelaySeconds | default 5 }}
+  periodSeconds: {{ .Values.health.readiness.periodSeconds | default 5 }}
+  timeoutSeconds: {{ .Values.health.readiness.timeoutSeconds | default 3 }}
+  successThreshold: {{ .Values.health.readiness.successThreshold | default 1 }}
+  failureThreshold: {{ .Values.health.readiness.failureThreshold | default 3 }}`,
+    },
+    {
+        name: 'health.startupProbe',
+        template: `{{- if .Values.health.startup.enabled -}}
+{{- $startupPath := .Values.health.startup.path | default "/health" -}}
+{{- $port := .Values.service.port | default 8080 -}}
+startupProbe:
+  httpGet:
+    path: {{ $startupPath }}
+    port: {{ $port }}
+    {{- if .Values.health.startup.httpHeaders }}
+    httpHeaders:
+      {{- toYaml .Values.health.startup.httpHeaders | nindent 6 }}
+    {{- end }}
+  initialDelaySeconds: {{ .Values.health.startup.initialDelaySeconds | default 10 }}
+  periodSeconds: {{ .Values.health.startup.periodSeconds | default 10 }}
+  timeoutSeconds: {{ .Values.health.startup.timeoutSeconds | default 5 }}
+  successThreshold: {{ .Values.health.startup.successThreshold | default 1 }}
+  failureThreshold: {{ .Values.health.startup.failureThreshold | default 30 }}
+{{- end }}`,
+    },
+    {
+        name: 'alerting.rules',
+        template: `{{- $serviceName := include "chart.fullname" . -}}
+- alert: {{ $serviceName }}HighErrorRate
+  expr: rate(http_requests_total{job="{{ $serviceName }}", status=~"5.."}[5m]) > 0.1
+  for: 5m
+  labels:
+    severity: critical
+    service: {{ $serviceName }}
+  annotations:
+    summary: "High error rate detected"
+    description: "{{ $serviceName }} has error rate above 10% for more than 5 minutes"
+
+- alert: {{ $serviceName }}HighLatency
+  expr: histogram_quantile(0.95, rate(http_request_duration_seconds_bucket{job="{{ $serviceName }}"}[5m])) > 0.5
+  for: 5m
+  labels:
+    severity: warning
+    service: {{ $serviceName }}
+  annotations:
+    summary: "High latency detected"
+    description: "{{ $serviceName }} 95th percentile latency is above 500ms"
+
+- alert: {{ $serviceName }}LowAvailability
+  expr: avg_over_time(up{job="{{ $serviceName }}"}[5m]) < 0.9
+  for: 2m
+  labels:
+    severity: critical
+    service: {{ $serviceName }}
+  annotations:
+    summary: "Service availability is low"
+    description: "{{ $serviceName }} availability is below 90%"`,
+    },
+    {
+        name: 'dashboard.annotations',
+        template: `{{- if .Values.grafana.dashboard.enabled -}}
+grafana.io/dashboard: "{{ .Values.grafana.dashboard.id | default (include "chart.fullname" .) }}"
+grafana.io/folder: "{{ .Values.grafana.dashboard.folder | default "applications" }}"
+{{- end }}`,
+    },
+];

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

@@ -0,0 +1,16 @@
+export interface HelperDefinition {
+    name: string;
+    template: string;
+}
+export type HelperCategory = 'standard' | 'fileAccess' | 'templateFunction' | 'sprig' | 'kubernetes' | 'aws' | 'env' | 'gitops' | 'observability' | 'validation';
+export type CloudProvider = 'aws' | 'azure' | 'gcp';
+export interface HelperOptions {
+    includeFileAccess?: boolean;
+    includeTemplateFunction?: boolean;
+    includeSprig?: boolean;
+    includeKubernetes?: boolean;
+    includeEnv?: boolean;
+    includeGitops?: boolean;
+    includeObservability?: boolean;
+    includeValidation?: boolean;
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+import type { HelperDefinition } from './types.js';
+export declare const VALIDATION_HELPERS: HelperDefinition[];

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

@@ -0,0 +1,201 @@
+export const VALIDATION_HELPERS = [
+    {
+        name: 'validation.semver',
+        template: `{{- $version := . -}}
+{{- if not (regexMatch "^(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)(?:-((?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\\\.(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\\\+([0-9a-zA-Z-]+(?:\\\\.[0-9a-zA-Z-]+)*))?$" $version) -}}
+{{- fail (printf "Invalid semantic version: %s. Must follow semver format (e.g., 1.2.3, 1.0.0-alpha.1)" $version) -}}
+{{- end -}}
+{{- $version }}`,
+    },
+    {
+        name: 'validation.k8sName',
+        template: `{{- $name := . -}}
+{{- if not (regexMatch "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$" $name) -}}
+{{- fail (printf "Invalid Kubernetes resource name: %s. Must be lowercase alphanumeric with hyphens, starting and ending with alphanumeric characters" $name) -}}
+{{- end -}}
+{{- if gt (len $name) 63 -}}
+{{- fail (printf "Kubernetes resource name too long: %s. Maximum 63 characters allowed" $name) -}}
+{{- end -}}
+{{- $name }}`,
+    },
+    {
+        name: 'validation.dnsLabel',
+        template: `{{- $label := . -}}
+{{- if not (regexMatch "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$" $label) -}}
+{{- fail (printf "Invalid DNS label: %s. Must be lowercase alphanumeric with hyphens" $label) -}}
+{{- end -}}
+{{- if gt (len $label) 63 -}}
+{{- fail (printf "DNS label too long: %s. Maximum 63 characters allowed" $label) -}}
+{{- end -}}
+{{- $label }}`,
+    },
+    {
+        name: 'validation.email',
+        template: `{{- $email := . -}}
+{{- if not (regexMatch "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,}$" $email) -}}
+{{- fail (printf "Invalid email address: %s" $email) -}}
+{{- end -}}
+{{- $email }}`,
+    },
+    {
+        name: 'validation.url',
+        template: `{{- $url := . -}}
+{{- if not (regexMatch "^https?://[a-zA-Z0-9.-]+(?:[:/][^\\\\s]*)?$" $url) -}}
+{{- fail (printf "Invalid URL: %s. Must be a valid HTTP or HTTPS URL" $url) -}}
+{{- end -}}
+{{- $url }}`,
+    },
+    {
+        name: 'validation.port',
+        template: `{{- $port := . | int -}}
+{{- if or (lt $port 1) (gt $port 65535) -}}
+{{- fail (printf "Invalid port number: %d. Must be between 1 and 65535" $port) -}}
+{{- end -}}
+{{- $port }}`,
+    },
+    {
+        name: 'validation.memorySize',
+        template: `{{- $size := . -}}
+{{- if not (regexMatch "^[0-9]+(\\\\.[0-9]+)?(Ki|Mi|Gi|Ti|Pi|Ei|K|M|G|T|P|E)?$" $size) -}}
+{{- fail (printf "Invalid memory size: %s. Use format like '512Mi', '2Gi', '1.5Gi'" $size) -}}
+{{- end -}}
+{{- $size }}`,
+    },
+    {
+        name: 'validation.cpuSize',
+        template: `{{- $cpu := . -}}
+{{- if not (regexMatch "^[0-9]+(\\\\.[0-9]+)?m?$" $cpu) -}}
+{{- fail (printf "Invalid CPU size: %s. Use format like '500m', '1', '1.5', '2000m'" $cpu) -}}
+{{- end -}}
+{{- $cpu }}`,
+    },
+    {
+        name: 'validation.duration',
+        template: `{{- $duration := . -}}
+{{- if not (regexMatch "^[0-9]+(\\\\.[0-9]+)?(ns|us|µs|ms|s|m|h)$" $duration) -}}
+{{- fail (printf "Invalid duration: %s. Use format like '30s', '5m', '2h', '100ms'" $duration) -}}
+{{- end -}}
+{{- $duration }}`,
+    },
+    {
+        name: 'validation.percentage',
+        template: `{{- $percentage := . -}}
+{{- if regexMatch "^[0-9]+%$" ($percentage | toString) -}}
+{{- $num := $percentage | toString | trimSuffix "%" | int -}}
+{{- if or (lt $num 0) (gt $num 100) -}}
+{{- fail (printf "Invalid percentage: %s. Must be between 0%% and 100%%" $percentage) -}}
+{{- end -}}
+{{- else -}}
+{{- $num := $percentage | int -}}
+{{- if or (lt $num 0) (gt $num 100) -}}
+{{- fail (printf "Invalid percentage: %d. Must be between 0 and 100" $num) -}}
+{{- end -}}
+{{- end -}}
+{{- $percentage }}`,
+    },
+    {
+        name: 'validation.ipAddress',
+        template: `{{- $ip := . -}}
+{{- if not (regexMatch "^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\\\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$" $ip) -}}
+{{- fail (printf "Invalid IP address: %s. Must be a valid IPv4 address" $ip) -}}
+{{- end -}}
+{{- $ip }}`,
+    },
+    {
+        name: 'validation.cidr',
+        template: `{{- $cidr := . -}}
+{{- if not (regexMatch "^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\\\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)/([0-9]|[1-2][0-9]|3[0-2])$" $cidr) -}}
+{{- fail (printf "Invalid CIDR notation: %s. Must be a valid IPv4 CIDR (e.g., 192.168.1.0/24)" $cidr) -}}
+{{- end -}}
+{{- $cidr }}`,
+    },
+    {
+        name: 'validation.base64',
+        template: `{{- $value := . -}}
+{{- if not (regexMatch "^[A-Za-z0-9+/]*={0,2}$" $value) -}}
+{{- fail (printf "Invalid base64 string: %s" $value) -}}
+{{- end -}}
+{{- $value }}`,
+    },
+    {
+        name: 'validation.uuid',
+        template: `{{- $uuid := . -}}
+{{- if not (regexMatch "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" ($uuid | lower)) -}}
+{{- fail (printf "Invalid UUID: %s. Must be a valid UUID format" $uuid) -}}
+{{- end -}}
+{{- $uuid }}`,
+    },
+    {
+        name: 'validation.cronSchedule',
+        template: `{{- $cron := . -}}
+{{- $parts := regexSplit "\\\\s+" $cron -1 -}}
+{{- if ne (len $parts) 5 -}}
+{{- fail (printf "Invalid cron schedule: %s. Must have 5 parts (minute hour day month weekday)" $cron) -}}
+{{- end -}}
+{{- range $part := $parts -}}
+{{- if not (regexMatch "^(\\\\*|[0-9,-/]+|\\\\*\\\\/[0-9]+)$" $part) -}}
+{{- fail (printf "Invalid cron part: %s in schedule %s" $part $cron) -}}
+{{- end -}}
+{{- end -}}
+{{- $cron }}`,
+    },
+    {
+        name: 'validation.imagePullPolicy',
+        template: `{{- $policy := . -}}
+{{- if not (has $policy (list "Always" "IfNotPresent" "Never")) -}}
+{{- fail (printf "Invalid image pull policy: %s. Must be one of: Always, IfNotPresent, Never" $policy) -}}
+{{- end -}}
+{{- $policy }}`,
+    },
+    {
+        name: 'validation.logLevel',
+        template: `{{- $level := . | lower -}}
+{{- if not (has $level (list "trace" "debug" "info" "warn" "warning" "error" "fatal" "panic")) -}}
+{{- fail (printf "Invalid log level: %s. Must be one of: trace, debug, info, warn, error, fatal, panic" .) -}}
+{{- end -}}
+{{- $level }}`,
+    },
+    {
+        name: 'validation.serviceType',
+        template: `{{- $type := . -}}
+{{- if not (has $type (list "ClusterIP" "NodePort" "LoadBalancer" "ExternalName")) -}}
+{{- fail (printf "Invalid service type: %s. Must be one of: ClusterIP, NodePort, LoadBalancer, ExternalName" $type) -}}
+{{- end -}}
+{{- $type }}`,
+    },
+    {
+        name: 'validation.storageAccessMode',
+        template: `{{- $mode := . -}}
+{{- if not (has $mode (list "ReadWriteOnce" "ReadOnlyMany" "ReadWriteMany" "ReadWriteOncePod")) -}}
+{{- fail (printf "Invalid storage access mode: %s. Must be one of: ReadWriteOnce, ReadOnlyMany, ReadWriteMany, ReadWriteOncePod" $mode) -}}
+{{- end -}}
+{{- $mode }}`,
+    },
+    {
+        name: 'validation.required',
+        template: `{{- $value := .value -}}
+{{- $fieldName := .field | default "field" -}}
+{{- if or (not $value) (and (kindIs "string" $value) (eq (trim $value) "")) -}}
+{{- fail (printf "Required field '%s' is missing or empty" $fieldName) -}}
+{{- end -}}
+{{- $value }}`,
+    },
+    {
+        name: 'validation.nonEmpty',
+        template: `{{- $list := . -}}
+{{- if not (and $list (gt (len $list) 0)) -}}
+{{- fail "List cannot be empty" -}}
+{{- end -}}
+{{- $list }}`,
+    },
+    {
+        name: 'validation.range',
+        template: `{{- $value := .value | int -}}
+{{- $min := .min | int -}}
+{{- $max := .max | int -}}
+{{- if or (lt $value $min) (gt $value $max) -}}
+{{- fail (printf "Value %d is out of range [%d, %d]" $value $min $max) -}}
+{{- end -}}
+{{- $value }}`,
+    },
+];

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

@@ -14,12 +14,22 @@ export declare function getDefaultHelpers(cloudProvider?: 'aws', options?: {
     includeTemplateFunction?: boolean;
     includeSprig?: boolean;
     includeKubernetes?: boolean;
+    includeEnv?: boolean;
+    includeGitops?: boolean;
+    includeObservability?: boolean;
+    includeValidation?: boolean;
 }): HelperDefinition[];
 export declare function generateHelpersTemplate(cloudProvider?: 'aws', customHelpers?: HelperDefinition[], options?: {
     includeFileAccess?: boolean;
     includeTemplateFunction?: boolean;
     includeSprig?: boolean;
     includeKubernetes?: boolean;
+    includeEnv?: boolean;
+    includeGitops?: boolean;
+    includeObservability?: boolean;
+    includeValidation?: boolean;
 }): string;
-export declare function getHelpersByCategory(category: 'standard' | 'fileAccess' | 'templateFunction' | 'sprig' | 'kubernetes' | 'aws'): HelperDefinition[];
+export declare function getHelpersByCategory(category: 'standard' | 'fileAccess' | 'templateFunction' | 'sprig' | 'kubernetes' | 'aws' | 'env' | 'gitops' | 'observability' | 'validation'): HelperDefinition[];
 export declare function createHelper(name: string, template: string): HelperDefinition;
+export { getNewHelpersByCategory, getAvailableHelperCategories, getHelpersByCategories, getHelpersByOptions, formatNewHelpers, generateNewHelpersTemplate, getCachedNewHelpersTemplate, createNewHelper, validateHelperNames, filterHelpersByPattern, getHelperStatistics, } from './helmHelpers/index.js';
+export { ENV_HELPERS, GITOPS_HELPERS, OBSERVABILITY_HELPERS, VALIDATION_HELPERS, } from './helmHelpers/index.js';

package/dist/lib/utils/helmHelpers.js

@@ -1,3 +1,4 @@
+import { ENV_HELPERS, GITOPS_HELPERS, OBSERVABILITY_HELPERS, VALIDATION_HELPERS, getNewHelpersByCategory, } from './helmHelpers/index.js';
 export const STANDARD_HELPERS = [
     {
         name: 'chart.name',
@@ -87,12 +88,6 @@ export const TEMPLATE_FUNCTION_HELPERS = [
 {{- $values := .values | default dict -}}
 {{- $context := merge $values . -}}
 {{- tpl $template $context -}}`,
-    },
-    {
-        name: 'validation.required',
-        template: `{{- $value := .value -}}
-{{- $message := .message | default (printf "Value %s is required" .key) -}}
-{{- required $message $value -}}`,
     },
     {
         name: 'validation.requireAny',
@@ -131,7 +126,8 @@ export const SPRIG_HELPERS = [
         name: 'env.getOrDefault',
         template: `{{- $key := .key -}}
 {{- $default := .default | default "" -}}
-{{- $default }}`,
+{{- $value := index .Values.env $key -}}
+{{- $value | default $default }}`,
     },
     {
         name: 'list.compact',
@@ -287,6 +283,18 @@ export function getDefaultHelpers(cloudProvider, options) {
     if (options?.includeKubernetes !== false) {
         helpers.push(...KUBERNETES_HELPERS);
     }
+    if (options?.includeEnv !== false) {
+        helpers.push(...ENV_HELPERS);
+    }
+    if (options?.includeGitops !== false) {
+        helpers.push(...GITOPS_HELPERS);
+    }
+    if (options?.includeObservability !== false) {
+        helpers.push(...OBSERVABILITY_HELPERS);
+    }
+    if (options?.includeValidation !== false) {
+        helpers.push(...VALIDATION_HELPERS);
+    }
     if (cloudProvider === 'aws') {
         helpers.push(...AWS_HELPERS);
     }
@@ -300,6 +308,9 @@ export function generateHelpersTemplate(cloudProvider, customHelpers, options) {
     return formatHelpers(helpers);
 }
 export function getHelpersByCategory(category) {
+    if (['env', 'gitops', 'observability', 'validation'].includes(category)) {
+        return getNewHelpersByCategory(category);
+    }
     switch (category) {
         case 'standard':
             return [...STANDARD_HELPERS];
@@ -320,3 +331,5 @@ export function getHelpersByCategory(category) {
 export function createHelper(name, template) {
     return { name, template };
 }
+export { getNewHelpersByCategory, getAvailableHelperCategories, getHelpersByCategories, getHelpersByOptions, formatNewHelpers, generateNewHelpersTemplate, getCachedNewHelpersTemplate, createNewHelper, validateHelperNames, filterHelpersByPattern, getHelperStatistics, } from './helmHelpers/index.js';
+export { ENV_HELPERS, GITOPS_HELPERS, OBSERVABILITY_HELPERS, VALIDATION_HELPERS, } from './helmHelpers/index.js';

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

@@ -1,8 +1,60 @@
 import * as jsYaml from 'js-yaml';
+type HelmExpressionType = 'block' | 'nested' | 'comment' | 'action-trimmed' | 'raw' | 'include-context' | 'generic';
+interface HelmExpressionMatch {
+    type: HelmExpressionType;
+    expression: string;
+    start: number;
+    end: number;
+}
+interface HelmExpression {
+    __helmExpression: true;
+    value: string;
+}
+declare function createHelmExpression(value: string): HelmExpression;
+declare function isHelmExpression(value: unknown): value is HelmExpression;
+declare function detectHelmExpressions(str: string): HelmExpressionMatch[];
+declare function preprocessHelmExpressions(obj: unknown, depth?: number): unknown;
+declare function postProcessHelmExpressions(yaml: string): string;
 export declare function dumpHelmAwareYaml(obj: unknown, options?: jsYaml.DumpOptions): string;
 export declare function stringify(obj: unknown, options?: {
     lineWidth?: number;
     doubleQuotedAsJSON?: boolean;
     simpleKeys?: boolean;
 }): string;
-export declare function validateHelmExpressions(yaml: string): boolean;
+export interface HelmValidationError {
+    type: 'syntax' | 'semantic' | 'reference' | 'type';
+    message: string;
+    line?: number;
+    column?: number;
+    expression?: string;
+    suggestion?: string;
+}
+export interface HelmValidationResult {
+    isValid: boolean;
+    errors: HelmValidationError[];
+    warnings: HelmValidationError[];
+    statistics: {
+        totalExpressions: number;
+        expressionsByType: Record<string, number>;
+        complexity: number;
+    };
+}
+export declare function validateHelmYaml(yaml: string): HelmValidationResult;
+export declare function parseHelmExpressions(content: string): Array<{
+    type: HelmExpressionType;
+    expression: string;
+    startLine: number;
+    startCol: number;
+    endLine: number;
+    endCol: number;
+}>;
+export interface PrettifyOptions {
+    indentSize?: number;
+    alignExpressions?: boolean;
+    preserveComments?: boolean;
+    maxLineWidth?: number;
+    sortKeys?: boolean;
+    groupHelpers?: boolean;
+}
+export declare function prettifyHelmTemplate(yaml: string, options?: PrettifyOptions): string;
+export { createHelmExpression, isHelmExpression, detectHelmExpressions, preprocessHelmExpressions, postProcessHelmExpressions, };