v1beta2

type CloudscaleCluster struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitzero"`

	// spec defines the desired state of CloudscaleCluster
	// +required
	Spec CloudscaleClusterSpec `json:"spec"`

	// status defines the observed state of CloudscaleCluster
	// +optional
	Status CloudscaleClusterStatus `json:"status,omitzero"`
}

type CloudscaleClusterList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitzero"`
	Items           []CloudscaleCluster `json:"items"`
}

type CloudscaleClusterSpec struct {
	// Region is the cloudscale.ch region (e.g., "rma", "lpg").
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Enum=rma;lpg
	Region string `json:"region"`

	// Zone is the cloudscale.ch zone (e.g., "rma1", "lpg1").
	// Defaults to region + "1" if not specified.
	// +optional
	Zone string `json:"zone,omitempty"`

	// CredentialsRef references the Secret containing the cloudscale.ch API token.
	// +kubebuilder:validation:Required
	CredentialsRef CloudscaleCredentialsReference `json:"credentialsRef"`

	// ControlPlaneEndpoint represents the endpoint to communicate with the control plane.
	// This is set automatically from the load balancer's VIP address.
	// +optional
	ControlPlaneEndpoint clusterv1.APIEndpoint `json:"controlPlaneEndpoint,omitzero"`

	// Network contains network configuration for the cluster.
	// +optional
	Network NetworkSpec `json:"network,omitzero"`

	// ControlPlaneLoadBalancer configures the load balancer for the control plane.
	// +optional
	ControlPlaneLoadBalancer LoadBalancerSpec `json:"controlPlaneLoadBalancer,omitzero"`
}

type CloudscaleClusterStatus struct {
	// Initialization contains v1beta2 initialization tracking.
	// +optional
	Initialization *ClusterInitializationStatus `json:"initialization,omitempty"`

	// NetworkID is the cloudscale.ch network UUID.
	// +optional
	NetworkID string `json:"networkID,omitempty"`

	// SubnetID is the cloudscale.ch subnet UUID.
	// +optional
	SubnetID string `json:"subnetID,omitempty"`

	// LoadBalancerID is the cloudscale.ch load balancer UUID.
	// +optional
	LoadBalancerID string `json:"loadBalancerID,omitempty"`

	// LoadBalancerPoolID is the cloudscale.ch load balancer pool UUID for the API server.
	// +optional
	LoadBalancerPoolID string `json:"loadBalancerPoolID,omitempty"`

	// LoadBalancerListenerID is the cloudscale.ch load balancer listener UUID for the API server.
	// +optional
	LoadBalancerListenerID string `json:"loadBalancerListenerID,omitempty"`

	// LoadBalancerHealthMonitorID is the cloudscale.ch load balancer health monitor UUID.
	// +optional
	LoadBalancerHealthMonitorID string `json:"loadBalancerHealthMonitorID,omitempty"`

	// LoadBalancerMemberIDs are the list of nodes attached to the loadBalancer.
	// +optional
	LoadBalancerMemberIDs []string `json:"loadBalancerMemberIDs,omitempty"`

	// conditions represent the current state of the CloudscaleCluster resource.
	// Each condition has a unique type and reflects the status of a specific aspect of the resource.
	//
	// Standard condition types include:
	// - "Available": the resource is fully functional
	// - "Progressing": the resource is being created or updated
	// - "Degraded": the resource failed to reach or maintain its desired state
	//
	// The status of each condition is one of True, False, or Unknown.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type CloudscaleCredentialsReference struct {
	// Name is the name of the Secret.
	// +kubebuilder:validation:Required
	Name string `json:"name"`

	// Namespace is the namespace of the Secret. Defaults to the cluster namespace.
	// +optional
	Namespace string `json:"namespace,omitempty"`
}

type CloudscaleMachine struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitzero"`

	// spec defines the desired state of CloudscaleMachine
	// +required
	Spec CloudscaleMachineSpec `json:"spec"`

	// status defines the observed state of CloudscaleMachine
	// +optional
	Status CloudscaleMachineStatus `json:"status,omitzero"`
}

type CloudscaleMachineList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitzero"`
	Items           []CloudscaleMachine `json:"items"`
}

type CloudscaleMachineSpec struct {
	// ProviderID is the unique identifier as specified by the cloud provider.
	// Format: cloudscale://<server-uuid>
	// +optional
	ProviderID *string `json:"providerID,omitempty"`

	// Flavor is the cloudscale.ch server flavor (e.g., "flex-8-4").
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Flavor string `json:"flavor"`

	// Image is the OS image slug (e.g., "ubuntu-24.04"), custom image slug (e.g., "custom:ubuntu-foo"), or custom image UUID.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Image string `json:"image"`

	// RootVolumeSize is the root volume size in GB.
	// +kubebuilder:validation:Minimum=10
	// +optional
	RootVolumeSize int `json:"rootVolumeSize,omitempty"`

	// Tags are key-value pairs to apply to the server.
	// +optional
	Tags map[string]string `json:"tags,omitempty"`

	// ServerGroup configures anti-affinity placement.
	// When specified, machines in the same server group are placed on different physical hosts.
	// N.B.: Only **up to 4 machines** can be placed in the same server group.
	// +optional
	ServerGroup *ServerGroupSpec `json:"serverGroup,omitempty"`
}

type CloudscaleMachineStatus struct {
	// Initialization contains v1beta2 initialization tracking.
	// +optional
	Initialization *MachineInitializationStatus `json:"initialization,omitempty"`

	// ServerID is the cloudscale.ch server UUID.
	// +optional
	ServerID string `json:"serverID,omitempty"`

	// Addresses contains the machine's addresses.
	// +optional
	Addresses []clusterv1.MachineAddress `json:"addresses,omitempty"`

	// ServerGroupID is the cloudscale.ch server group UUID.
	// +optional
	ServerGroupID string `json:"serverGroupID,omitempty"`

	// conditions represent the current state of the CloudscaleMachine resource.
	// Each condition has a unique type and reflects the status of a specific aspect of the resource.
	//
	// Standard condition types include:
	// - "Available": the resource is fully functional
	// - "Progressing": the resource is being created or updated
	// - "Degraded": the resource failed to reach or maintain its desired state
	//
	// The status of each condition is one of True, False, or Unknown.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type CloudscaleMachineTemplate struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitzero"`

	// spec defines the desired state of CloudscaleMachineTemplate
	// +required
	Spec CloudscaleMachineTemplateSpec `json:"spec"`

	// status defines the observed state of CloudscaleMachineTemplate
	// +optional
	Status CloudscaleMachineTemplateStatus `json:"status,omitzero"`
}

type CloudscaleMachineTemplateList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitzero"`
	Items           []CloudscaleMachineTemplate `json:"items"`
}

type CloudscaleMachineTemplateResource struct {
	// Spec is the specification of the desired behavior of the machine.
	Spec CloudscaleMachineSpec `json:"spec"`
}

type CloudscaleMachineTemplateSpec struct {
	// Template contains the machine template specification.
	Template CloudscaleMachineTemplateResource `json:"template"`
}

type CloudscaleMachineTemplateStatus struct {
	// Capacity defines the resource capacity for nodes created from this template.
	// This value is used for autoscaling from zero operations as defined in:
	// https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/proposals/20210310-opt-in-autoscaling-from-zero.md
	// +optional
	Capacity corev1.ResourceList `json:"capacity,omitempty"`

	// conditions represent the current state of the CloudscaleMachineTemplate resource.
	// Each condition has a unique type and reflects the status of a specific aspect of the resource.
	//
	// Standard condition types include:
	// - "Available": the resource is fully functional
	// - "Progressing": the resource is being created or updated
	// - "Degraded": the resource failed to reach or maintain its desired state
	//
	// The status of each condition is one of True, False, or Unknown.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type ClusterInitializationStatus struct {
	// Provisioned indicates that all cluster infrastructure has been provisioned.
	// True when Network, Subnet, Load Balancer, and Control Plane Endpoint are ready.
	// +optional
	Provisioned *bool `json:"provisioned,omitempty"`
}

type HealthMonitorSpec struct {
	// DelayS is the interval between health checks in seconds.
	// +kubebuilder:default=5
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=300
	// +optional
	DelayS int `json:"delayS,omitempty"`

	// TimeoutS is the health check timeout in seconds.
	// +kubebuilder:default=3
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=300
	// +optional
	TimeoutS int `json:"timeoutS,omitempty"`

	// UpThreshold is the number of successful checks to mark healthy.
	// +kubebuilder:default=2
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=10
	// +optional
	UpThreshold int `json:"upThreshold,omitempty"`

	// DownThreshold is the number of failed checks to mark unhealthy.
	// +kubebuilder:default=3
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=10
	// +optional
	DownThreshold int `json:"downThreshold,omitempty"`
}

type LoadBalancerSpec struct {
	// Enabled controls whether a load balancer is created for the control plane.
	// Set to false for external control planes (e.g., hosted control plane) where the endpoint
	// is provided externally.
	// +kubebuilder:default=true
	// +optional
	Enabled *bool `json:"enabled,omitempty"`

	// Algorithm is the load balancing algorithm.
	// +kubebuilder:validation:Enum=round_robin;least_connections;source_ip
	// +kubebuilder:default="round_robin"
	// +optional
	Algorithm string `json:"algorithm,omitempty"`

	// Flavor is the load balancer flavor (size).
	// +kubebuilder:default="lb-standard"
	// +optional
	Flavor string `json:"flavor,omitempty"`

	// APIServerPort is the port for the Kubernetes API server.
	// +kubebuilder:default=6443
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=65535
	// +optional
	APIServerPort int32 `json:"apiServerPort,omitempty"`

	// HealthMonitor configures the load balancer health monitor.
	// +optional
	HealthMonitor HealthMonitorSpec `json:"healthMonitor,omitempty"`
}

type MachineInitializationStatus struct {
	// Provisioned indicates that the machine infrastructure has been provisioned.
	// True when the server is running and ready.
	// +optional
	Provisioned *bool `json:"provisioned,omitempty"`
}

type NetworkSpec struct {
	// CIDR is the CIDR block for the private network subnet.
	// +kubebuilder:default="10.0.0.0/24"
	// +optional
	CIDR string `json:"cidr,omitempty"`

	// GatewayAddress is the gateway IP address for the subnet.
	// By default, no gateway is configured on the private network subnet. This ensures
	// that outbound internet traffic uses the public network interface, which is required
	// for the Cloud Controller Manager to reach the cloudscale.ch API.
	// Set this to a specific IP address (e.g., "10.0.0.1") only if you have configured
	// a NAT gateway or similar infrastructure on the private network.
	// +optional
	GatewayAddress *string `json:"gatewayAddress,omitempty"`
}

type NodeInfo struct {
	// Architecture is the CPU architecture (e.g., "amd64", "arm64").
	// +optional
	Architecture string `json:"architecture,omitempty"`

	// OperatingSystem is the operating system (e.g., "linux").
	// +optional
	OperatingSystem string `json:"operatingSystem,omitempty"`
}

type ResourceLifecycle string

type ServerGroupSpec struct {
	// Name is the server group name. Machines with the same server group name
	// in the same zone will be placed on different physical hosts.
	// The server group is created automatically if it doesn't exist.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name"`
}