stack_processor_process_stacks_helpers.go

package exec

import (
	"github.com/cloudposse/atmos/pkg/perf"
	"github.com/cloudposse/atmos/pkg/schema"
)

// Map capacity hints for component processing to reduce reallocation overhead.
const (
	componentVarsCapacity      = 32 // Typical component has 10-50 variables.
	componentSettingsCapacity  = 16 // Typical component has 5-20 settings.
	componentSmallMapCapacity  = 8  // For env, auth, providers, hooks, backend sections (5-15 items).
	componentOverridesCapacity = 4  // Overrides are typically sparse (0-10 items).
)

// ComponentProcessorOptions contains configuration for processing a component.
type ComponentProcessorOptions struct {
	ComponentType            string
	Component                string
	Stack                    string
	StackName                string
	ComponentMap             map[string]any
	AllComponentsMap         map[string]any
	ComponentsBasePath       string
	CheckBaseComponentExists bool

	// Global configurations.
	GlobalVars         map[string]any
	GlobalSettings     map[string]any
	GlobalEnv          map[string]any
	GlobalAuth         map[string]any
	GlobalSecrets      map[string]any
	GlobalDependencies map[string]any
	GlobalMetadata     map[string]any
	GlobalCommand      string
	AtmosGlobalAuthMap map[string]any // Pre-converted atmosConfig.Auth to prevent race conditions

	// Terraform-specific options.
	TerraformProviders              map[string]any
	TerraformRequiredProviders      map[string]any
	TerraformRequiredVersion        string
	GlobalAndTerraformHooks         map[string]any
	GlobalAndTerraformGenerate      map[string]any
	GlobalBackendType               string
	GlobalBackendSection            map[string]any
	GlobalRemoteStateBackendType    string
	GlobalRemoteStateBackendSection map[string]any
	GlobalSourceSection             map[string]any
	GlobalProvisionSection          map[string]any

	// Kubernetes-specific global defaults (lowest precedence in the final merge).
	GlobalKubernetesProvider  string
	GlobalKubernetesPaths     any
	GlobalKubernetesManifests any
	GlobalKubernetesRender    map[string]any
	GlobalKubernetesValidate  any

	// Atmos configuration.
	AtmosConfig *schema.AtmosConfiguration
}

// ComponentProcessorResult contains the processed component data.
type ComponentProcessorResult struct {
	ComponentVars         map[string]any
	ComponentSettings     map[string]any
	ComponentEnv          map[string]any
	ComponentMetadata     map[string]any
	ComponentDependencies map[string]any
	ComponentLocals       map[string]any // Component-level locals for template processing.
	ComponentCommand      string
	ComponentProvider     string
	ComponentPaths        any
	ComponentManifests    any
	ComponentValidate     any
	// ComponentPlugins holds the Helm CLI plugins list (helm/helmfile components).
	ComponentPlugins any
	ComponentRender  map[string]any
	// ComponentHelm holds native Helm component fields (chart, values, values_files,
	// repositories, version, repository, namespace, name, render) as a single bag.
	ComponentHelm              map[string]any
	ComponentOverrides         map[string]any
	ComponentOverridesVars     map[string]any
	ComponentOverridesSettings map[string]any
	ComponentOverridesEnv      map[string]any
	ComponentOverridesAuth     map[string]any
	ComponentOverridesCommand  string
	BaseComponentName          string
	BaseComponentVars          map[string]any
	BaseComponentSettings      map[string]any
	BaseComponentEnv           map[string]any
	BaseComponentAuth          map[string]any
	BaseComponentMetadata      map[string]any
	BaseComponentDependencies  map[string]any
	BaseComponentLocals        map[string]any // Base component locals for inheritance.
	BaseComponentCommand       string
	BaseComponentProvider      string
	BaseComponentPaths         any
	BaseComponentManifests     any
	BaseComponentValidate      any
	// BaseComponentPlugins holds the inherited Helm CLI plugins list from base components.
	BaseComponentPlugins any
	BaseComponentRender  map[string]any
	// BaseComponentHelm holds the inherited native Helm fields from base components.
	BaseComponentHelm         map[string]any
	ComponentInheritanceChain []string
	BaseComponents            []string

	// Terraform-specific fields.
	ComponentProviders         map[string]any
	ComponentRequiredProviders map[string]any
	ComponentRequiredVersion   string
	ComponentHooks             map[string]any
	ComponentTest              map[string]any
	ComponentMocks             map[string]any
	// ComponentSecrets holds the component-level `secrets:` declaration section.
	ComponentSecrets          map[string]any
	ComponentOverridesSecrets map[string]any
	BaseComponentSecrets      map[string]any
	ComponentGenerate         map[string]any
	ComponentAuth             map[string]any
	// ComponentProvision holds provisioning configuration for the component (e.g., workdir settings).
	ComponentProvision                     map[string]any
	ComponentBackendType                   string
	ComponentBackendSection                map[string]any
	ComponentRemoteStateBackendType        string
	ComponentRemoteStateBackendSection     map[string]any
	ComponentOverridesProviders            map[string]any
	ComponentOverridesRequiredProviders    map[string]any
	ComponentOverridesRequiredVersion      string
	ComponentOverridesHooks                map[string]any
	ComponentOverridesGenerate             map[string]any
	BaseComponentProviders                 map[string]any
	BaseComponentRequiredProviders         map[string]any
	BaseComponentRequiredVersion           string
	BaseComponentHooks                     map[string]any
	BaseComponentTest                      map[string]any
	BaseComponentMocks                     map[string]any
	BaseComponentGenerate                  map[string]any
	BaseComponentBackendType               string
	BaseComponentBackendSection            map[string]any
	BaseComponentRemoteStateBackendType    string
	BaseComponentRemoteStateBackendSection map[string]any
	ComponentSourceSection                 map[string]any
	BaseComponentSourceSection             map[string]any
	BaseComponentProvisionSection          map[string]any
	// ComponentRetry holds the raw retry configuration from the concrete component
	// (decoded to a typed *schema.RetryConfig only after deep-merge with base + overrides).
	ComponentRetry map[string]any
	// ComponentOverridesRetry holds the retry section from the component's `overrides:`
	// block, which wins over both base and concrete component retry config.
	ComponentOverridesRetry map[string]any
	// BaseComponentRetry holds the retry configuration inherited from base components
	// (deep-merged across the full inheritance chain by ProcessBaseComponentConfig).
	BaseComponentRetry map[string]any
}

// processComponent processes a component extracting common configuration sections.
func processComponent(opts *ComponentProcessorOptions) (*ComponentProcessorResult, error) {
	defer perf.Track(opts.AtmosConfig, "exec.processComponent")()

	result := &ComponentProcessorResult{
		ComponentVars:     make(map[string]any, componentVarsCapacity),
		ComponentSettings: make(map[string]any, componentSettingsCapacity),
		ComponentEnv:      make(map[string]any, componentSmallMapCapacity),
		ComponentMetadata: make(map[string]any, componentSettingsCapacity),
		BaseComponents:    []string{},
	}

	// Extract component sections.
	if err := extractComponentSections(opts, result); err != nil {
		return nil, err
	}

	// Process overrides.
	if err := processComponentOverrides(opts, result); err != nil {
		return nil, err
	}

	// Process component inheritance.
	if err := processComponentInheritance(opts, result); err != nil {
		return nil, err
	}

	return result, nil
}