deployer

type DeleteOptions struct {
	Getter   genericclioptions.RESTClientGetter
	Out      io.Writer
	HelmLog  io.Writer
	Timeout  time.Duration
	Progress progress.Reporter

	// Purge, when true, extends the delete pipeline AFTER helm
	// uninstall to remove the four CRDs, the operator namespace, and
	// the 'educates-secrets' namespace. Local <data-home>/config.yaml
	// + cached CA Secrets are intentionally preserved — they're user
	// authoring inputs and survive cluster reinstalls.
	Purge bool
}

type Options struct {
	// Getter is the kubectl-style RESTClientGetter — typically a
	// configured genericclioptions.ConfigFlags from cobra.
	Getter genericclioptions.RESTClientGetter

	// Out is where progress lines are written. Pass cmd.OutOrStdout()
	// from cobra; pass io.Discard from tests.
	Out io.Writer

	// HelmLog receives helm SDK debug output. io.Discard by default.
	HelmLog io.Writer

	// Timeout overrides DefaultTimeout per CR wait.
	Timeout time.Duration

	// SkipPrereqCheck bypasses the educates-custom-ca Secret existence
	// check. Set when the caller has already verified, or for advanced
	// users who manage the Secret asynchronously.
	SkipPrereqCheck bool

	// SkipCRDApply bypasses the operator CRD apply step. The default
	// is to push CRDs from the embedded chart before helm-install so a
	// CRD shape change reaches the cluster on re-deploy (helm itself
	// only installs CRDs on first install, never on upgrade). Set true
	// when the user manages CRDs out of band (GitOps, separate
	// kubectl apply, etc.).
	SkipCRDApply bool

	// SyncLocalSecrets, when true, copies <data-home>/secrets/*.yaml into
	// the cluster's 'educates-secrets' namespace before applying the
	// platform CRs. Matches the v3 laptop flow: cached CA/TLS material
	// is pushed at deploy time, ECC's caCertificateRef points there.
	// Only meaningful for EducatesLocalConfig deploys.
	SyncLocalSecrets bool

	// Progress is the structured progress reporter. When nil, plain
	// io.Discard-backed reporter is used (no progress output, but the
	// helpers still call into it so the call-site code is uniform).
	// Cmd code typically passes progress.NewForStdout(...) to render
	// to the user's terminal with TTY-aware overwriting.
	Progress progress.Reporter
}

type PlatformComponentStatus struct {
	Kind     string // e.g. "EducatesClusterConfig"
	Optional bool   // absent is acceptable (only LookupService)
	Present  bool   // the CR (and its CRD) exists in the cluster
	Ready    bool   // status.conditions[type=Ready].status == "True"
	Phase    string // status.phase, for extra detail when not Ready
}

type PurgeTargets struct {
	CRDs       []string
	Namespaces []string
}