webhook

type WebhookController interface {
	// GetSupported returns a nested map structure that indicates the supported
	// Group-Version-Kind (GVK) combinations for the webhook controller.
	//
	// Returns:
	//   - map[string]map[string]map[string]metav1.Object: A nested map where the first
	//     key represents the API group, the second key represents the API version,
	//     and the third key represents the kind. The value is a metav1.Object
	//     representing the supported resource.
	GetSupported() map[string]map[string]map[string]metav1.Object

	// IsSupported checks whether a specific Group-Version-Kind (GVK)
	// combination is supported for GET operations by the webhook controller.
	//
	// Parameters:
	//   - g: The API group of the resource.
	//   - v: The API version of the resource.
	//   - k: The kind of the resource.
	//
	// Returns:
	//   - bool: True if the specified GVK combination is supported for GET operations,
	//     otherwise false.
	IsSupported(g, v, k string) bool

	// GetConfigurationAccessor retrieves the configuration accessor for a specific
	// Group-Version-Kind (GVK) combination, if it is registered.
	//
	// Parameters:
	//   - g: The API group of the resource.
	//   - v: The API version of the resource.
	//   - k: The kind of the resource.
	//
	// Returns:
	//   - config.ConfigAccessor: The configuration accessor for the specified GVK,
	//     or nil if the GVK is not registered.
	GetConfigurationAccessor(g, v, k string) config.ConfigAccessor

	// Review processes an AdmissionReview request and determines whether the request
	// should be allowed or denied. It dispatches the request to the appropriate handler
	// based on the resource's G/V/R or falls back to the default handler if no specific
	// handler is registered.
	//
	// Parameters:
	//   - ctx: The context for the request, used for cancellation and deadlines.
	//   - ar: The AdmissionReview containing details about the resource and operation.
	//
	// Returns:
	//   - *types.AdmissionResponse: The result of the admission process, indicating
	//     whether the request is allowed or denied.
	//   - error: Any error encountered during processing.
	Review(ctx context.Context, ar *types.AdmissionReview) (*types.AdmissionResponse, error)
}