testing

type DeleteOp struct{}

type DeployOp struct {
	Spec string   `json:"spec,omitempty"`
	Args []string `json:"args,omitempty"`
}

type E2EFixture struct {
	Env       string              `json:"env"`
	Parallel  *bool               `json:"parallel,omitempty"`
	Timeout   string              `json:"timeout,omitempty"`
	Resources []ResourceAssertion `json:"resources,omitempty"`
	Steps     []Step              `json:"steps,omitempty"`
}

type IntegrationTestSuite struct {
	// ScenariosDir is the root directory of test scenarios.
	ScenariosDir string
	// OutputDir is the temporary workspace for a test run.
	OutputDir string
}

type LogsOp struct {
	Component string `json:"component"`
	Contains  string `json:"contains"`
}

type PlanConfig struct {
	// FreshInstall selects an empty previous manifest instead of resolving
	// one from before.yaml or previous.yaml, for the fresh-install case
	// where neither file is expected to exist.
	FreshInstall bool `yaml:"freshInstall"`
	// Changes lists every expected change, in the exact order
	// [plan.ComputeDiff] returns them (sorted by Kind, then Name).
	Changes []PlanConfigChange `yaml:"changes"`
	// Summary is the expected change tally.
	Summary PlanConfigSummary `yaml:"summary"`
	// HooksChanged asserts [plan.Plan.HooksChanged]. True when hook tasks
	// are present on a fresh install (Helm reports hook manifests).
	HooksChanged bool `yaml:"hooksChanged"`
	// Masked lists field paths (as they appear in a Changes[].Fields[]
	// entry's Path) that [plan.ApplyMasking] must flag as masked. Every
	// masked path [RunPlanScenarioTest] finds in the computed plan must
	// appear here, and vice versa.
	Masked []string `yaml:"masked"`
	// Warning is documentary only: this offline harness has no live/faked
	// release store to compute a real warning from ([plan.LastSuccessfulRelease]
	// is covered separately in history_test.go), so the test runner just
	// sets Header.Warning to this value before checking it.
	Warning string `yaml:"warning"`
}

type PlanConfigChange struct {
	Action string            `yaml:"action"`
	Kind   string            `yaml:"kind"`
	Name   string            `yaml:"name"`
	Fields []PlanConfigField `yaml:"fields"`
}

type PlanConfigField struct {
	Path string `yaml:"path"`
	Old  string `yaml:"old"`
	New  string `yaml:"new"`
}

type PlanConfigSummary struct {
	Add     int `yaml:"add"`
	Change  int `yaml:"change"`
	Destroy int `yaml:"destroy"`
}

type PlanTestScenario struct {
	// Name is the scenario directory name (e.g. "plan-image-bump").
	Name string
	// Dir is the scenario's absolute directory path.
	Dir string
}

type ResourceAssertion struct {
	Match    map[string]any `json:"match"`
	MinCount *int           `json:"minCount,omitempty"`
}

type RunOp struct {
	Task string `json:"task"`
}

type Step struct {
	Deploy         *DeployOp           `json:"deploy,omitempty"`
	Run            *RunOp              `json:"run,omitempty"`
	Logs           *LogsOp             `json:"logs,omitempty"`
	Delete         *DeleteOp           `json:"delete,omitempty"`
	Timeout        string              `json:"timeout,omitempty"`
	StderrContains string              `json:"stderrContains,omitempty"`
	StdoutContains string              `json:"stdoutContains,omitempty"`
	Resources      []ResourceAssertion `json:"resources,omitempty"`
}

type TestScenario struct {
	// Name is the scenario directory name.
	Name string
	// ScenarioDir is the relative path under TestScenariosDir.
	ScenarioDir string
	// ManifestFile is the manifest filename within ScenarioDir.
	ManifestFile string
	// Environment selects the manifest environment for chart generation.
	Environment string
	// EnvFiles lists dotenv files to copy into the test workspace.
	EnvFiles []string
	// PlatformFile is the platform filename within ScenarioDir when present.
	PlatformFile string
	// ExpectedDir is the golden output directory, relative to TestScenariosDir.
	ExpectedDir string
	// ExpectError requires manifest loading or resolution to fail.
	ExpectError bool
	// ExpectedErrors requires specific substrings in the load/resolve error message.
	ExpectedErrors []string
	// HasE2EFixture is true when the scenario directory contains e2e.yaml.
	HasE2EFixture bool
	// E2EFixturePath is the absolute path to e2e.yaml when HasE2EFixture is true.
	E2EFixturePath string
}