flux

type ArtifactGeneratorData struct {
	Name          string // ArtifactGenerator CR name
	Namespace     string // Flux install namespace (e.g. "flux-system")
	OCISourceName string // outer OCIRepository name (e.g. "aicr-bundle")
	ArtifactName  string // ExternalArtifact name that source-watcher will create
	ChartPath     string // sub-directory within the OCI artifact (e.g. "gpu-operator-pre")
}

type ChartData struct {
	Name string
	// AICRVersion is the AICR build that produced the chart; it lands in
	// `version:` and the aicr.run/generated-by annotation. Set it through
	// deployer.NormalizeChartVersion — Helm validates `version:` as SemVer 2
	// and rejects the "dev" an unstamped build reports.
	AICRVersion string
	// ComponentVersion is the free-form version of the payload the chart
	// carries; it lands in `appVersion:` and the aicr.run/component-version
	// annotation. See ADR-021 Decision 7 for why the two are separate.
	ComponentVersion string
}

type ChartRefHelmReleaseData struct {
	Name            string
	Namespace       string // Flux install namespace (e.g. "flux-system")
	TargetNamespace string
	ChartRefName    string // ExternalArtifact name for spec.chartRef
	DependsOn       []DependsOnRef
	ValuesFrom      []ValuesFromRef // ConfigMap references for dynamic values
	ValuesYAML      string          // Pre-rendered, indented YAML for spec.values
	// UpgradeCRDs emits spec.upgrade.crds: CreateReplace. Set only for
	// components the registry marks ownsCRDs. See NVIDIA/aicr#2264.
	UpgradeCRDs bool
	// DisableWait emits spec.install.disableWait and spec.upgrade.disableWait.
	// Set only for charts generated from recipe manifests. See NVIDIA/aicr#2585.
	DisableWait bool
}

type ComponentSummary struct {
	Name         string
	Type         string
	Version      string
	Namespace    string
	DependsOnStr string
}

type ConfigMapData struct {
	Name       string
	Namespace  string // Flux install namespace (e.g. "flux-system")
	ValuesYAML string // Indented YAML for the data.values.yaml field
}

type DependsOnRef struct {
	Name string
}

type Generator struct {
	// RecipeResult contains the recipe metadata and component references.
	RecipeResult *recipe.RecipeResult

	// ComponentValues maps component names to their values.
	ComponentValues map[string]map[string]any

	// Version is the generator version.
	Version string

	// RepoURL is the Git repository URL for GitRepository source CRs.
	// If empty, a placeholder URL will be used.
	RepoURL string

	// TargetRevision is the target revision for GitRepository refs (default: "main").
	TargetRevision string

	// IncludeChecksums indicates whether to generate a checksums.txt file.
	IncludeChecksums bool

	// DataFiles lists additional file paths (relative to output dir) to include
	// in checksum generation. Used for external data files copied into the bundle.
	DataFiles []string

	// ComponentManifests maps component name → manifest path → rendered bytes.
	// Drives generation of local Helm charts for manifest-only and mixed
	// components. Components without manifests do not appear in the map.
	ComponentManifests map[string]map[string][]byte

	// ComponentPreManifests maps component name → manifest path → rendered bytes.
	// Emitted as a <name>-pre HelmRelease that the primary HelmRelease
	// dependsOn, ensuring pre-phase manifests reconcile before the chart.
	// Wired by the bundler from ComponentRef.PreManifestFiles and the
	// synthesized GKE critical-priority ResourceQuota (see issue #915).
	// Components without pre-manifests do not appear in the map.
	ComponentPreManifests map[string]map[string][]byte

	// DynamicValues maps component names to their dynamic value paths.
	// When non-empty, dynamic paths are split from inline values into a
	// ConfigMap and referenced via spec.valuesFrom in the HelmRelease.
	DynamicValues map[string][]string

	// Namespace is the Kubernetes namespace where Flux CRs (HelmRelease,
	// sources, ArtifactGenerator) are deployed. Defaults to
	// config.DefaultFluxNamespace ("flux-system") via resolveNamespace().
	Namespace string

	// OCISourceName is the name of the outer OCIRepository that Flux pulls
	// the bundle from. When non-empty, local-chart components emit an
	// ArtifactGenerator + ExternalArtifact pair and reference the
	// ExternalArtifact via spec.chartRef in the HelmRelease (instead of
	// spec.chart.spec with a GitRepository source). This eliminates the
	// placeholder GitRepository URL that stalls helm-controller under OCI
	// consumption.
	// When empty, the generator falls back to the existing GitRepository path.
	OCISourceName string

	// VendorCharts pulls upstream Helm chart bytes into the bundle at
	// bundle time so the resulting artifact is air-gap deployable.
	// Off by default. With the flag set, vendorable Helm-typed components
	// emit a local wrapper chart (Chart.yaml + charts/<chart>-<ver>.tgz)
	// and HelmRelease CRs reference the GitRepository source instead of
	// HelmRepository.
	VendorCharts bool

	// Puller fetches upstream chart bytes when VendorCharts is set. nil
	// resolves to a default *CLIChartPuller; tests inject a stub here
	// without touching package state. Ignored when VendorCharts is false.
	Puller localformat.ChartPuller

	// Serial chains each component's dependsOn to the previous component in
	// deployment order (a linear release chain) instead of projecting the
	// declared dependencyRefs onto the DAG, so components reconcile strictly
	// one at a time. Off by default (native DAG). Operator escape hatch wired
	// from --serial; see config.Serial and serialDependsOn.
	Serial bool

	// UpgradeNotice is upgrade.WriteNotice output, inserted verbatim before the
	// first deployment heading of README.md. Empty adds nothing.
	UpgradeNotice string
	// contains filtered or unexported fields
}

type GitRepoSourceData struct {
	Name      string
	Namespace string // Flux install namespace (e.g. "flux-system")
	URL       string
	Branch    string
}

type HelmReleaseData struct {
	Name            string
	Namespace       string // Flux install namespace (e.g. "flux-system")
	TargetNamespace string
	Chart           string
	Version         string
	SourceKind      string // "HelmRepository" or "GitRepository"
	SourceName      string
	DependsOn       []DependsOnRef
	ValuesFrom      []ValuesFromRef // ConfigMap references for dynamic values
	ValuesYAML      string          // Pre-rendered, indented YAML for spec.values
	// UpgradeCRDs emits spec.upgrade.crds: CreateReplace. Set only for
	// components the registry marks ownsCRDs. See NVIDIA/aicr#2264.
	UpgradeCRDs bool
	// DisableWait emits spec.install.disableWait and spec.upgrade.disableWait.
	// Set only for charts generated from recipe manifests. See NVIDIA/aicr#2585.
	DisableWait bool
}

type HelmRepoSourceData struct {
	Name      string
	Namespace string // Flux install namespace (e.g. "flux-system")
	URL       string
	IsOCI     bool
}

type ReadmeData struct {
	Namespace      string // Flux install namespace (e.g. "flux-system")
	BundlerVersion string
	Components     []ComponentSummary
	UpgradeNotice  string
}

type RootKustomizationData struct {
	Resources []string
}

type ValuesFromRef struct {
	Name string
}