v1beta1

type FromFieldPathPolicy string

type Input struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	// Spec is the input to this function.
	Spec InputSpec `json:"spec,omitempty"`
}

type InputSpec struct {
	// ExtraResources selects a list of `ExtraResource`s. The resolved
	// resources are stored in the composite resource at
	// `spec.extraResourceRefs` and is only updated if it is null.
	ExtraResources []ResourceSource `json:"extraResources"`

	// Policy represents the Resolution policies which apply to all
	// ResourceSourceReferences in ExtraResources list.
	// +optional
	Policy *Policy `json:"policy,omitempty"`
}

type PatchPolicy struct {
	// FromFieldPath specifies how to patch from a field path. The default is
	// 'Optional', which means the patch will be a no-op if the specified
	// fromFieldPath does not exist. Use 'Required' if the patch should fail if
	// the specified path does not exist.
	// +kubebuilder:validation:Enum=Optional;Required
	// +optional
	FromFieldPath *FromFieldPathPolicy `json:"fromFieldPath,omitempty"`
	MergeOptions  *xpv1.MergeOptions   `json:"mergeOptions,omitempty"`
}

type Policy struct {
	// Resolution specifies whether resolution of this reference is required.
	// The default is 'Required', which means the reconcile will fail if the
	// reference cannot be resolved. 'Optional' means this reference will be
	// a no-op if it cannot be resolved.
	// +optional
	// +kubebuilder:default=Required
	// +kubebuilder:validation:Enum=Required;Optional
	Resolution *xpv1.ResolutionPolicy `json:"resolution,omitempty"`
}

type ResourceSource struct {
	// Type specifies the way the ExtraResource is selected.
	// Default is `Reference`
	// +optional
	// +kubebuilder:validation:Enum=Reference;Selector
	// +kubebuilder:default=Reference
	Type ResourceSourceType `json:"type,omitempty"`

	// Ref is a named reference to a single ExtraResource.
	// Either Ref or Selector is required.
	// +optional
	Ref *ResourceSourceReference `json:"ref,omitempty"`

	// Selector selects ExtraResource(s) via labels.
	// +optional
	Selector *ResourceSourceSelector `json:"selector,omitempty"`

	// Kind is the kubernetes kind of the target extra resource(s).
	Kind string `json:"kind,omitempty"`

	// APIVersion is the kubernetes API Version of the target extra resource(s).
	APIVersion string `json:"apiVersion,omitempty"`

	// Namespace is the namespace in which to look for the ExtraResource.
	// If not set, the resource is assumed to be cluster-scoped.
	// +optional
	Namespace *string `json:"namespace,omitempty"`

	// Into is the key into which extra resources for this selector will be placed.
	Into string `json:"into"`
}

type ResourceSourceReference struct {
	// The name of the object.
	Name string `json:"name"`
}

type ResourceSourceSelector struct {
	// MaxMatch specifies the number of extracted ExtraResources in Multiple mode, extracts all if nil.
	MaxMatch *uint64 `json:"maxMatch,omitempty"`

	// MinMatch specifies the required minimum of extracted ExtraResources in Multiple mode.
	MinMatch *uint64 `json:"minMatch,omitempty"`

	// SortByFieldPath is the path to the field based on which list of ExtraResources is alphabetically sorted.
	// +kubebuilder:default="metadata.name"
	SortByFieldPath string `json:"sortByFieldPath,omitempty"`

	// MatchLabels ensures an object with matching labels is selected.
	MatchLabels []ResourceSourceSelectorLabelMatcher `json:"matchLabels,omitempty"`
}

type ResourceSourceSelectorLabelMatcher struct {
	// Type specifies where the value for a label comes from.
	// +optional
	// +kubebuilder:validation:Enum=FromCompositeFieldPath;Value
	// +kubebuilder:default=FromCompositeFieldPath
	Type ResourceSourceSelectorLabelMatcherType `json:"type,omitempty"`

	// Key of the label to match.
	Key string `json:"key"`

	// ValueFromFieldPath specifies the field path to look for the label value.
	ValueFromFieldPath *string `json:"valueFromFieldPath,omitempty"`

	// FromFieldPathPolicy specifies the policy for the valueFromFieldPath.
	// The default is Required, meaning that an error will be returned if the
	// field is not found in the composite resource.
	// Optional means that if the field is not found in the composite resource,
	// that label pair will just be skipped. N.B. other specified label
	// matchers will still be used to retrieve the desired
	// resource config, if any.
	// +kubebuilder:validation:Enum=Optional;Required
	// +kubebuilder:default=Required
	FromFieldPathPolicy *FromFieldPathPolicy `json:"fromFieldPathPolicy,omitempty"`

	// Value specifies a literal label value.
	Value *string `json:"value,omitempty"`
}

type ResourceSourceSelectorLabelMatcherType string

type ResourceSourceType string