gitlab

type Adapter interface {
	Operation
	Features
	Status
	resource.CustomResourceWrapper
	resource.ValueProvider
	resource.ChartConsumer
}

type Component string

type Components []Component

type ConditionType string

type FeatureCheck func(values support.Values) bool

type Features interface {
	// WantsFeature queries this GitLab resource for the specified feature.
	// Returns true if the instance has the feature in its specification.
	//
	// Note that this function only checks the specification of the GitLab
	// resource and does not verify the state of the GitLab instance.
	WantsFeature(check FeatureCheck) bool

	// WantsComponent is a shorthand for checking if a specific GitLab component
	// is enabled in the specification of this GitLab resource.
	//
	// Note that this function only checks the specification of the GitLab
	// resource and does not verify the state of the GitLab instance.
	WantsComponent(component Component) bool
}

type Operation interface {
	// IsInstall indicates if this GitLab resource needs to be installed. This
	// occurs when the GitLab instance with the specified name and version does
	// not exist.
	//
	// This function relies on both the specification and status of the GitLab
	// resource to make the decision.
	IsInstall() bool

	// IsUpgrade indicates if this GitLab resource needs upgrade. This occurs
	// when the GitLab instance already exists but its version is lower than
	// the specified version in GitLab resource specification.
	//
	// This function relies on both the specification and status of the GitLab
	// resource to make the decision.
	IsUpgrade() bool

	// IsDowngrade indicates if this GitLab resource needs downgrade. This
	// occurs when the GitLab instance already exists but its version is higher
	// than the specified version in GitLab resource specification.
	//
	// This function relies on both the specification and status of the GitLab
	// resource to make the decision.
	IsDowngrade() bool

	// CurrentVersion returns the current version of the GitLab instance or
	// an empty string when this is a new instance.
	//
	// This function uses the status of the GitLab resource.
	CurrentVersion() string

	// DesiredVersion returns the expected version of GitLab instance that is
	// specified.
	DesiredVersion() string
}

type Status interface {
	// SetCondition updates the provided condition with the details of
	// the underlying GitLab resource, including the observed generation,
	// and adds it to the resource conditions.
	SetCondition(condition metav1.Condition)

	// RecordVersion sets the status version to the specified (desired) version.
	RecordVersion()
}