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 HookBinder interface {
	AnyReconcileHooks
	// BindToObjectHooks wraps each hook function in a closure that performs
	// a runtime obj.(T) assertion before delegating to the typed function.
	// OnNotFound is forwarded unchanged — it receives a string key, not an object.
	BindToObjectHooks() ObjectHooks
}

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 ObjectHooks struct {
	OnReconcile func(ctx context.Context, obj Object) error
	OnDelete    func(ctx context.Context, obj Object) error
	OnNotFound  func(ctx context.Context, key string) error
}

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 from the informer cache.
	// 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 proceeds with only finalizer removal.
	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 itself.
	// If nil, not-found events are 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
}