api

type Action struct {
	Silent           *bool
	MaxTotalSeconds  *int
	Retries          *int
	Dir              *string
	Env              []string
	Cmd              string
	Shell            *Shell
	SetVariables     []Variable
	SetValues        []SetValue
	Description      string
	Wait             *ActionWait
	EnableTemplating bool
}

type ActionDefaults struct {
	Silent          bool
	MaxTotalSeconds int
	Retries         int
	Dir             string
	Env             []string
	Shell           Shell
}

type ActionSet struct {
	Defaults  ActionDefaults
	Before    []Action
	After     []Action
	OnSuccess []Action
	OnFailure []Action
}

type ActionWait struct {
	Cluster *ActionWaitCluster
	Network *ActionWaitNetwork
}

type ActionWaitCluster struct {
	Kind      string
	Name      string
	Namespace string
	Condition WaitCondition
}

type ActionWaitNetwork struct {
	Protocol string
	Address  string
	Code     int
}

type BuildData struct {
	// Hostname is the v1beta1 name (v1alpha1: Terminal).
	Hostname                   string
	User                       string
	Architecture               string
	Timestamp                  string
	Version                    string
	Migrations                 []string
	RegistryOverrides          map[string]string
	Differential               bool
	DifferentialPackageVersion string
	Flavor                     string
	Signed                     *bool
	VersionRequirements        []VersionRequirement
	ProvenanceFiles            []string
	AggregateChecksum          string

	// v1alpha1-only build fields.
	DifferentialMissing []string
}

type Chart struct {
	Name string
	// LegacyVersion is kept for existing v1alpha1 packages so that we can track the chart's archive and values files.
	// The version of the chart is separately tracked in OCI source, HelmRepository, or GitSource
	LegacyVersion        string
	Namespace            string
	ReleaseName          string
	ValuesFiles          []ValuesFile
	Values               []ChartValue
	SkipSchemaValidation bool
	ServerSideApply      ServerSideApplyMode
	SkipWait             bool

	HelmRepository *HelmRepositorySource
	Git            *GitSource
	Local          *LocalSource
	OCI            *OCISource

	// Variables are required to run v1alpha1 chart actions.
	Variables []ZarfChartVariable
}

type ChartValue struct {
	SourcePath   string
	TargetPath   string
	ExcludePaths []string
}

type Component struct {
	Name          string
	Description   string
	Optional      bool
	Selector      ComponentSelector
	Target        ComponentTarget
	Import        ComponentImport
	Service       Service
	Manifests     []Manifest
	Charts        []Chart
	Files         []File
	Images        []Image
	ImageArchives []ImageArchive
	Repositories  []Repository
	StateAccess   []StateAccessKey
	Actions       ComponentActions

	Default        bool
	Group          string
	DataInjections []ZarfDataInjection
	HealthChecks   []NamespacedObjectKindReference
	Distros        []string
}

type ComponentActions struct {
	OnCreate ActionSet
	OnDeploy ActionSet
	OnRemove ActionSet
}

type ComponentImport struct {
	// Local and Remote support the multiple imports accepted by v1beta1.
	Local  []ComponentImportLocal
	Remote []ComponentImportRemote

	// Name identifies a v1alpha1 imported component. Path and URL are projected onto
	// Local and Remote by the v1alpha1 converter.
	Name string
}

type ComponentImportLocal struct {
	Path string
}

type ComponentImportRemote struct {
	URL string
}

type ComponentSelector struct {
	Architecture string
	Flavor       string
}

type ComponentTarget struct {
	OS string
}

type Constant struct {
	Name        string
	Value       string
	Description string
	AutoIndent  bool
	Pattern     string
}

type File struct {
	Source           string
	Checksum         string
	Destination      string
	Executable       bool
	Symlinks         []string
	ExtractPath      string
	EnableTemplating bool
}

type GitRef struct {
	Tag    string
	Branch string
	Commit string
}

type GitSource struct {
	URL  string
	Path string
	Ref  *GitRef
}

type HelmRepositorySource struct {
	Name    string
	URL     string
	Version string
}

type Image struct {
	Name   string
	Source string
}

type ImageArchive struct {
	Path   string
	Images []string
}

type InteractiveVariable struct {
	Variable
	Description string
	Default     string
	Prompt      bool
}

type KustomizeManifest struct {
	Files             []string
	AllowAnyDirectory bool
	EnablePlugins     bool
}

type LocalSource struct {
	Path string
}

type Manifest struct {
	Name             string
	Namespace        string
	Files            []string
	Kustomize        KustomizeManifest
	SkipWait         bool
	ServerSideApply  ServerSideApplyMode
	EnableTemplating bool
}

type NamespacedObjectKindReference struct {
	APIVersion string
	Kind       string
	Namespace  string
	Name       string
}

type OCIRef struct {
	Tag    string
	Digest string
}

type OCISource struct {
	URL string
	Ref *OCIRef
}

type Package struct {
	// APIVersion identifies the source package schema. An empty value is the legacy v1alpha1 form.
	APIVersion    string
	Kind          PackageKind
	Metadata      PackageMetadata
	Build         BuildData
	Components    []Component
	Values        Values
	Documentation map[string]string

	// v1alpha1-only fields
	Variables []InteractiveVariable
	Constants []Constant
}

type PackageKind string

type PackageMetadata struct {
	Name                     string
	Description              string
	Version                  string
	Uncompressed             bool
	Architecture             string
	Annotations              map[string]string
	PreventNamespaceOverride bool

	// v1alpha1-only metadata fields.
	URL           string
	Image         string
	YOLO          bool
	Authors       string
	Documentation string
	Source        string
	Vendor        string
}

type Repository struct {
	URL string
	Ref *GitRef
	// LegacyURL retains the original v1alpha1 URL, including an inline ref, so
	// repositories retain the directory names used by existing package layouts
	// For instance, GitRef can't express ref/tags/v1.0 vs only v1.0
	// Will be deleted with v1alpha1 is no longer support
	LegacyURL string
}

type ServerSideApplyMode string

type Service string

type SetValue struct {
	Key   string
	Value any
	Type  SetValueType
}

type SetValueType string

type Shell struct {
	Windows string
	Linux   string
	Darwin  string
}

type StateAccessKey string

type Values struct {
	Files  []string
	Schema string
}

type ValuesFile struct {
	Path             string
	EnableTemplating bool
}

type Variable struct {
	Name       string
	Sensitive  bool
	AutoIndent bool
	Pattern    string
	Type       VariableType
}

type VariableType string

type VersionRequirement struct {
	Version string
	Reason  string
}

type WaitCondition struct {
	Expression string
	Default    WaitDefault
}

type WaitDefault string

type ZarfChartVariable struct {
	Name        string
	Description string
	Path        string
}

type ZarfContainerTarget struct {
	Namespace string
	Selector  string
	Container string
	Path      string
}

type ZarfDataInjection struct {
	Source   string
	Target   ZarfContainerTarget
	Compress bool
}