domain

type AnyReconcileHooks interface {
	// contains filtered or unexported methods
}

type Health interface {
	// SetReady marks the component as initialised and ready to process work.
	// Called once by the component after successful startup.
	// Implies the component is also healthy.
	SetReady()

	// Degraded marks the component as alive but not ready to process work.
	// Used when a recoverable error condition is detected — for example,
	// when a CRD's consecutive failure threshold is exceeded.
	// The component remains running but is removed from the ready pool.
	// Distinct from Unhealthy: the process does not need to be restarted.
	Degraded()

	// Unhealthy marks the component as neither healthy nor ready.
	// Called during shutdown or when an unrecoverable error is detected.
	// A Kubernetes liveness probe failing on this state will trigger a restart.
	Unhealthy()

	// Healthy returns true if the component is in a healthy state.
	// Maps to the Kubernetes liveness probe — false triggers a pod restart.
	Healthy() bool

	// Ready returns true if the component is initialised and ready to process work.
	// Maps to the Kubernetes readiness probe — false removes the pod from service endpoints.
	Ready() bool

	// Started returns true if the component has been started at least once.
	// Used by the manager to guard against double-start and to sequence
	// post-start hooks correctly.
	Started() bool
}

type Komponent interface {

	// Start() starts the komponents
	Start(context.Context) error

	// Shutdown() shuts down the komponent gracefully
	Shutdown(context.Context)

	// Name() returns the name of the komponent
	Name() string

	// Started() is set when manager starts a komponent
	Started() bool
}

type Object interface {
	metav1.Object
	runtime.Object
}

type ObjectList interface {
	metav1.ListInterface
	runtime.Object
}

type ReconcileHooks[T Object] struct {
	// OnReconcile is called for every create/update event.
	// obj is already type-asserted and deep-copied.
	// Return an error to requeue with backoff.
	OnReconcile func(ctx context.Context, obj T) error

	// OnDelete is called when the object's DeletionTimestamp is set.
	// Use this to clean up external resources before the finalizer is removed.
	// If nil, deletion is a no-op (finalizer removed automatically).
	OnDelete func(ctx context.Context, obj T) error

	// OnNotFound is called when the object no longer exists in the store.
	// Use this for cleanup that depends on the key but not the object.
	// If nil, not-found is a no-op.
	OnNotFound func(ctx context.Context, key string) error
}

type Reconciler interface {
	// Reconcile handles the actual business logic for a resource
	Reconcile(ctx context.Context, key string) error
}