v1beta2

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

	Spec   AppWrapperSpec   `json:"spec,omitempty"`
	Status AppWrapperStatus `json:"status,omitempty"`
}

type AppWrapperComponent struct {
	// Annotations is an unstructured key value map that may be used to store and retrieve
	// arbitrary metadata about the Component to customize its treatment by the AppWrapper controller.
	//+optional
	Annotations map[string]string `json:"annotations,omitempty"`

	// PodSets contained in the Component
	//+optional
	PodSets []AppWrapperPodSet `json:"podSets,omitempty"`

	// PodSetInfos assigned to the Component's PodSets by Kueue
	//+optional
	PodSetInfos []AppWrapperPodSetInfo `json:"podSetInfos,omitempty"`

	// +kubebuilder:pruning:PreserveUnknownFields
	// +kubebuilder:validation:EmbeddedResource
	// Template defines the Kubernetes resource for the Component
	Template runtime.RawExtension `json:"template"`
}

type AppWrapperComponentStatus struct {
	// Name is the name of the Component
	Name string `json:"name"`

	// Kind is the Kind of the Component
	Kind string `json:"kind"`

	// APIVersion is the APIVersion of the Component
	APIVersion string `json:"apiVersion"`

	// Conditions hold the latest available observations of the Component's current state.
	//
	// The type of the condition could be:
	//
	// - ResourcesDeployed: The component is deployed on the cluster
	//
	//+optional
	//+patchMergeKey=type
	//+patchStrategy=merge
	//+listType=map
	//+listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type AppWrapperCondition string

type AppWrapperList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []AppWrapper `json:"items"`
}

type AppWrapperPhase string

type AppWrapperPodSet struct {
	// Replicas is the number of pods in this PodSet
	//+optional
	Replicas *int32 `json:"replicas,omitempty"`

	// Path is the path Component.Template to the PodTemplateSpec for this PodSet
	Path string `json:"path"`
}

type AppWrapperPodSetInfo struct {
	// Annotations to be added to the PodSpecTemplate
	//+optional
	Annotations map[string]string `json:"annotations,omitempty"`
	// Labels to be added to the PodSepcTemplate
	//+optional
	Labels map[string]string `json:"labels,omitempty"`
	// NodeSelectors to be added to the PodSpecTemplate
	//+optional
	NodeSelector map[string]string `json:"nodeSelector,omitempty"`
	// Tolerations to be added to the PodSpecTemplate
	//+optional
	Tolerations []corev1.Toleration `json:"tolerations,omitempty"`
}

type AppWrapperSpec struct {
	// Components lists the components contained in the AppWrapper
	Components []AppWrapperComponent `json:"components"`

	// Suspend suspends the AppWrapper when set to true
	//+optional
	Suspend bool `json:"suspend,omitempty"`
}

type AppWrapperStatus struct {
	// Phase of the AppWrapper object
	//+optional
	Phase AppWrapperPhase `json:"phase,omitempty"`

	// Retries counts the number of times the AppWrapper has entered the Resetting Phase
	//+optional
	Retries int32 `json:"resettingCount,omitempty"`

	// Conditions hold the latest available observations of the AppWrapper current state.
	//
	// The type of the condition could be:
	//
	// - QuotaReserved: The AppWrapper was admitted by Kueue and has quota allocated to it
	// - ResourcesDeployed: The contained resources are deployed (or being deployed) on the cluster
	// - PodsReady: All pods of the contained resources are in the Ready or Succeeded state
	// - Unhealthy: One or more of the contained resources is unhealthy
	// - DeletingResources: The contained resources are in the process of being deleted from the cluster
	//
	//+optional
	//+patchMergeKey=type
	//+patchStrategy=merge
	//+listType=map
	//+listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`

	// ComponentStatus parallels the Components array in the Spec and tracks the actually deployed resources
	ComponentStatus []AppWrapperComponentStatus `json:"componentStatus,omitempty"`
}