helm

type DeployChartOptions struct {
	ValueOpts       *values.Options
	Atomic          bool
	Wait            bool
	Timeout         time.Duration
	CreateNamespace bool
	ReuseValues     bool
	Labels          map[string]string
}

type InstallChartOptions struct {
	ValueOpts       *values.Options
	Atomic          bool
	Wait            bool
	Timeout         time.Duration
	CreateNamespace bool
	Labels          map[string]string
}

type Manager interface {
	// AddRepo adds a Helm chart repository with the given options and updates it.
	AddRepo(name, url string, o RepoAddOptions) (*repo.ChartRepository, error)

	// PullAndVerify pulls a Helm chart into destDir and verifies its integrity
	// against the expected checksum recorded in the infrastructure catalog.
	// destDir is created on demand. For classic charts (chartRef without an
	// "oci://" scheme) the local .tgz is SHA256-hashed; for OCI charts the
	// manifest digest reported by the registry client is compared. The returned
	// path points at the local .tgz so callers can hand it to InstallChart /
	// UpgradeChart / DeployChart without a second pull. algorithm currently
	// must be "sha256"; any other value is a configuration error.
	//
	// ctx is accepted for API symmetry but is not propagated into the pull:
	// the Helm SDK version we vendor exposes no context-aware Pull entrypoint
	// (neither action.Pull.Run nor registry.Client.Pull take a context). An
	// in-flight pull therefore runs to completion regardless of cancellation;
	// a slow pull will block the step until the underlying HTTP transport's
	// own deadlines fire.
	PullAndVerify(ctx context.Context, destDir, chartRef, version, algorithm, expectedChecksum string) (string, error)

	// InstallChart installs a Helm chart with the given options
	InstallChart(ctx context.Context, releaseName, chartRef, chartVersion, namespace string, o InstallChartOptions) (*release.Release, error)

	// UninstallChart uninstalls a Helm release by name in the specified namespace
	UninstallChart(releaseName, namespace string) error

	// UpgradeChart upgrades a Helm chart with the given options
	UpgradeChart(ctx context.Context, releaseName, chartRef, chartVersion, namespace string, o UpgradeChartOptions) (*release.Release, error)

	// DeployChart installs or upgrades a Helm chart with the given options
	// This is equivalent to "helm upgrade --install"
	DeployChart(ctx context.Context, releaseName, chartRef, chartVersion, namespace string, o DeployChartOptions) (*release.Release, error)

	// List lists Helm releases in the specified namespace, in every state
	// (deployed, failed, pending-*, superseded, uninstalling).
	List(namespace string, allNamespaces bool) ([]*release.Release, error)

	// ListAll lists Helm releases in all namespaces, in every state. Unlike
	// IsInstalled, which counts only deployed releases, this sees a stalled one.
	ListAll() ([]*release.Release, error)

	// GetRelease retrieves a Helm release by name in the specified namespace
	GetRelease(releaseName, namespace string) (*release.Release, error)

	// IsInstalled checks if a Helm release is installed in the specified namespace
	// It considers only releases in deployed state as "installed"
	IsInstalled(releaseName, namespace string) (bool, error)

	// WaitFor waits until the Helm release reaches the desired status or the timeout is reached
	WaitFor(rel *release.Release, status Status, timeout time.Duration) error
}

type Option func(*helmManager)

type RepoAddOptions struct {
	RepoFile  string
	RepoCache string
}

type Status string

type UpgradeChartOptions struct {
	ValueOpts   *values.Options
	Atomic      bool
	Wait        bool
	Timeout     time.Duration
	ReuseValues bool
	Labels      map[string]string
}