v1alpha1

type AdoptKonnectOptions struct {
	// ID is the Konnect ID of the entity.
	// +required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=36
	ID string `json:"id,omitempty"`
}

type AdoptMode string

type AdoptOptions struct {
	// From is the source of the entity to adopt from.
	// Now 'konnect' is supported.
	// +required
	// +kubebuilder:validation:Enum=konnect
	From AdoptSource `json:"from,omitempty"`
	// Mode selects how the operator adopts an already-existing entity (for example,
	// a Konnect resource) instead of creating a new one.
	//
	// Supported values:
	// - "match": the operator retrieves the remote entity referenced by the
	//   corresponding Adopt* options (for example, adopt.konnect.id) and performs a
	//   field-by-field comparison against this CR's spec (ignoring server-assigned
	//   metadata). If the specification matches the remote state, the operator
	//   adopts the entity: it sets the status identifier and marks the resource as
	//   ready/programmed without issuing any write operation to the remote system.
	//   If the specification does not match the remote state, adoption fails: the
	//   operator does not modify the remote entity and surfaces a failure
	//   condition, allowing the user to align the spec with the existing entity if
	//   adoption is desired.
	//
	// - "override": the operator overrides the remote entity by the CR's spec.
	//   If the entity with the ID and type exists, and it is not managed
	//   by another CR (matching by the metadata.uid of the CR and the "k8s-uid"
	//   label or tag of the Konnect entity), the operator updates the remote entity
	//   by the CR's spec.
	// +optional
	// +kubebuilder:validation:Enum=match;override
	Mode AdoptMode `json:"mode,omitempty"`
	// Konnect is the options for adopting the entity from Konnect.
	// Required when from == 'konnect'.
	// +optional
	Konnect *AdoptKonnectOptions `json:"konnect,omitempty"`
}

type AdoptSource string

type ControlPlaneRef struct {
	// Type indicates the type of the control plane being referenced. Allowed values:
	// - konnectNamespacedRef
	// - kic
	//
	// The default is kic, which implies that the Control Plane is KIC.
	//
	// +optional
	// +kubebuilder:validation:Enum=konnectNamespacedRef;kic
	// +kubebuilder:default:=kic
	Type string `json:"type,omitempty"`

	// KonnectNamespacedRef is a reference to a Konnect Control Plane entity inside the cluster.
	// It contains the name of the Konnect Control Plane.
	// This field is required when the Type is konnectNamespacedRef.
	// +optional
	KonnectNamespacedRef *KonnectNamespacedRef `json:"konnectNamespacedRef,omitempty"`
}

type EntitySource string

type ExtensionRef struct {
	// Group is the group of the extension resource.
	//
	// +optional
	// +kubebuilder:default=gateway-operator.konghq.com
	// +kubebuilder:validation:MaxLength=253
	Group string `json:"group"`

	// Kind is kind of the extension resource.
	//
	// +required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=253
	Kind string `json:"kind,omitempty"`

	// NamespacedRef is a reference to the extension resource.
	NamespacedRef `json:",inline"`
}

type KonnectExtensionControlPlaneRef struct {
	// Type indicates the type of the control plane being referenced. Allowed values:
	// - konnectNamespacedRef
	//
	// +optional
	// +kubebuilder:validation:Enum=konnectNamespacedRef
	// +kubebuilder:default:=konnectNamespacedRef
	Type string `json:"type,omitempty"`

	// KonnectNamespacedRef is a reference to a Konnect Control Plane entity inside the cluster.
	// It contains the name of the Konnect Control Plane.
	// This field is required when the Type is konnectNamespacedRef.
	// +optional
	KonnectNamespacedRef *KonnectNamespacedRef `json:"konnectNamespacedRef,omitempty"`
}

type KonnectIDType string

type KonnectNamespacedRef struct {
	// Name is the name of the Konnect Control Plane.
	//
	// +required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name,omitempty"`

	// Namespace is the namespace where the Konnect Control Plane is in.
	// Currently the following resources are allowed to set this:
	// - cluster scoped resources (KongVault)
	// - KongService
	// - KongCertificate
	// - KongCACertificate
	// - KongConsumerGroup
	// - KongUpstream
	// - KongKeySet
	// - KongDataPlaneClientCertificate
	//
	// +optional
	// +kubebuilder:validation:MaxLength=253
	Namespace string `json:"namespace,omitempty"`
}

type NameRef struct {
	// Name is the name of the entity.
	//
	// +required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name,omitempty"`
}

type NamespacedRef struct {
	// Name is the name of the referred resource.
	//
	// +required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name,omitempty"`

	// Namespace is the namespace of the referred resource.
	//
	// For namespace-scoped resources if no Namespace is provided then the
	// namespace of the parent object MUST be used.
	//
	// This field MUST not be set when referring to cluster-scoped resources.
	//
	// +optional
	// +kubebuilder:validation:MaxLength=253
	Namespace *string `json:"namespace,omitempty"`
}

type ObjectRef struct {
	// Type defines type of the object which is referenced. It can be one of:
	//
	// - konnectID
	// - namespacedRef
	//
	// +required
	Type ObjectRefType `json:"type,omitempty"`

	// KonnectID is the schema for the KonnectID type.
	// This field is required when the Type is konnectID.
	//
	// +optional
	// +kubebuilder:validation:MaxLength=36
	KonnectID *string `json:"konnectID,omitempty"`

	// NamespacedRef is a reference to a KeySet entity inside the cluster.
	// This field is required when the Type is namespacedRef.
	//
	// +optional
	NamespacedRef *NamespacedRef `json:"namespacedRef,omitempty"`
}

type ObjectRefType string

type Tags []string