reconciler

type BaseStatefulReconciler[T StatefulResource] struct {
	Logger logr.Logger
}

type Dummy struct {
}

type Interface interface {
	Observe(ctx context.Context) error
	Reconcile(ctx context.Context) error
}

type Object interface {
	metav1.Object
	runtime.Object
}

type StateChangeOperations struct {
	// ItemsToAdd represents items that need to be added to the external system
	ItemsToAdd []interface{} `json:"itemsToAdd,omitempty"`

	// ItemsToRemove represents items that need to be removed from the external system
	ItemsToRemove []interface{} `json:"itemsToRemove,omitempty"`

	// ItemsToUpdate represents items that need to be updated in the external system
	ItemsToUpdate []interface{} `json:"itemsToUpdate,omitempty"`

	// ContextChanged indicates that the context (like resource type or name) has changed
	// and requires special handling like cleanup of old context
	ContextChanged bool `json:"contextChanged,omitempty"`

	// PreviousContext contains the previous context information for cleanup
	PreviousContext interface{} `json:"previousContext,omitempty"`
}

type StatefulReconciler[T StatefulResource] interface {
	// GetStateAnnotationKey returns the annotation key used to store the previous state
	GetStateAnnotationKey() string

	// ExtractCurrentState extracts the current desired state from the resource spec
	// that needs to be compared with the previous state for change detection
	ExtractCurrentState(resource T) (interface{}, error)

	// CompareStates compares the previous state with the current state and returns
	// the operations that need to be performed to reconcile the differences
	CompareStates(previous, current interface{}) (StateChangeOperations, error)

	// ApplyOperations applies the state change operations to the external system
	ApplyOperations(ctx context.Context, resource T, ops StateChangeOperations) error

	// UpdateStateAnnotation updates the annotation with the current state after
	// successful reconciliation
	UpdateStateAnnotation(resource T, currentState interface{}) error
}

type StatefulResource interface {
	runtime.Object
	metav1.Object
}