controller

type Context interface {
	// ClientSet for a subset of resource kinds. Must implement Get and List methods.
	ClientSet() client.Client
	// GetAttachment for a specific resource that any controller added during the Reconcile
	// invocation.
	GetAttachment(kind, namespace, name string) (any, bool)
	// GetResource with specific kind, namespace and name. Use this over ClientSet().Get(...) if the
	// ApiVersion of a resource is unknown or ambiguous. Returns the first resource matched in a resource tree.
	GetResource(kind, namespace, name string) (*Resource, bool)
}

type Controller interface {
	// Kinds this controller will accept. Only resources of this API kind will be handled, e.g. "Secret",
	// "Kustomization". Scope a controller as narrow as possible.
	Kinds() []string
	// Reconcile is invoked for each resource. Returns a list of resources to create
	// and an error. If error is ErrSkip, the controller is skipped for this invocation.
	Reconcile(Context, *Resource) (*Result, error)
}

type Resource struct {
	*resource.Resource
}

type Result struct {
	// Resources that are created based on the handled resource, e.g. ExternalSecret creates a Secret.
	Resources []*Resource
	// Attachment that should be stored alongside this resource node, or nil. Attachments can be retrieved
	// using Context.GetAttachment.
	Attachment any
}