v1beta1

type APIEndpoint struct {
	// Host is the hostname on which the API server is serving.
	// +kubebuilder:validation:MinLength=1
	Host string `json:"host"`

	// Port is the port on which the API server is serving.
	// +kubebuilder:validation:Minimum=1
	Port int32 `json:"port"`
}

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

	Spec   NstanceClusterSpec   `json:"spec,omitempty"`
	Status NstanceClusterStatus `json:"status,omitempty"`
}

type NstanceClusterInitializationStatus struct {
	// Provisioned is true when cluster infrastructure is provisioned.
	// Always true for Nstance since there is no cluster-level infrastructure.
	// +optional
	Provisioned *bool `json:"provisioned,omitempty"`
}

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

type NstanceClusterSpec struct {
	// ControlPlaneEndpoint represents the endpoint for the cluster's API server.
	// Set to the management cluster's API server endpoint to satisfy the CAPI
	// infrastructure contract. Nstance does not provision control planes.
	// +optional
	ControlPlaneEndpoint APIEndpoint `json:"controlPlaneEndpoint,omitempty"`
}

type NstanceClusterStatus struct {
	// Initialization provides observations of the NstanceCluster initialization process.
	// +optional
	Initialization NstanceClusterInitializationStatus `json:"initialization,omitempty"`

	// Conditions represent the current state of the NstanceCluster.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

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

	Spec   NstanceMachineSpec   `json:"spec"`
	Status NstanceMachineStatus `json:"status,omitempty"`
}

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

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

	Spec   NstanceMachinePoolSpec   `json:"spec"`
	Status NstanceMachinePoolStatus `json:"status,omitempty"`
}

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

type NstanceMachinePoolSpec struct {
	// Group is the Nstance Group key. This can match a static group in
	// server config, or be a new key for a dynamic group.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Group string `json:"group"`

	// Shards is the list of zone shards this group should be distributed across.
	// Each shard will have a corresponding NstanceShardGroup created.
	// Replicas from the MachinePool are distributed across these shards.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinItems=1
	Shards []string `json:"shards"`

	// Template is the name of the Nstance template defined in server config.
	// Required when creating a new dynamic group (no static group with this key).
	// Must not be set for groups backed by static config (server will reject).
	// +optional
	Template string `json:"template,omitempty"`

	// InstanceType is an optional override (must be allowed by the Group)
	// +optional
	InstanceType *string `json:"instanceType,omitempty"`

	// SubnetPool specifies which subnet pool to use for new dynamic groups.
	// This is a subnet pool ID that references server.subnet_pools map key.
	// If not specified, uses the template's default.
	// Must not be set for groups backed by static config (server will reject).
	// +optional
	SubnetPool string `json:"subnetPool,omitempty"`

	// Vars are additional vars merged with Group vars (enables node labels, etc.)
	// +optional
	Vars map[string]string `json:"vars,omitempty"`

	// ProviderIDList is the list of provider IDs of running instances across all shards.
	// Required by the CAPI InfraMachinePool contract (spec.providerIDList).
	// +optional
	// +listType=atomic
	ProviderIDList []string `json:"providerIDList,omitempty"`
}

type NstanceMachinePoolStatus struct {
	// Ready indicates whether the machine pool is ready
	// +optional
	Ready bool `json:"ready,omitempty"`

	// Replicas is the most recently observed number of running instances across all shards.
	// Required by the CAPI InfraMachinePool contract (status.replicas).
	// +optional
	Replicas int32 `json:"replicas"`

	// IsStatic indicates this group is backed by static server config.
	// When true, spec.template and spec.subnetPool cannot be modified.
	// +optional
	IsStatic bool `json:"isStatic,omitempty"`

	// ObservedGeneration is the generation of the spec that was last observed
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// ObservedOwnerGeneration is the generation of the owner MachinePool that was last observed
	// +optional
	ObservedOwnerGeneration int64 `json:"observedOwnerGeneration,omitempty"`

	// Conditions represent the current state of the NstanceMachinePool
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type NstanceMachineSpec struct {
	// Group is the name of the Nstance Group
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Group string `json:"group"`

	// InstanceType is an optional override
	// +optional
	InstanceType *string `json:"instanceType,omitempty"`

	// Vars are additional vars
	// +optional
	Vars map[string]string `json:"vars,omitempty"`
}

type NstanceMachineStatus struct {
	// InstanceID is the Nstance instance ID (server-generated)
	// +optional
	InstanceID string `json:"instanceID,omitempty"`

	// Shard identifies which zone shard this instance is in
	// +optional
	Shard string `json:"shard,omitempty"`

	// ProviderID is the cloud provider instance ID
	// +optional
	ProviderID string `json:"providerID,omitempty"`

	// Ready indicates whether the instance is ready
	// +optional
	Ready bool `json:"ready,omitempty"`

	// Conditions represent the current state of the NstanceMachine
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

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

	Spec NstanceMachineTemplateSpec `json:"spec"`
}

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

type NstanceMachineTemplateResource struct {
	// Spec is the specification of the desired behavior of the machine
	// +required
	Spec NstanceMachineSpec `json:"spec"`
}

type NstanceMachineTemplateSpec struct {
	// Template defines the machines that will be created from this template
	// +required
	Template NstanceMachineTemplateResource `json:"template"`
}

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

	Spec   NstanceShardGroupSpec   `json:"spec"`
	Status NstanceShardGroupStatus `json:"status,omitempty"`
}

type NstanceShardGroupConfig struct {
	// Template is the instance template being used
	// +optional
	Template string `json:"template,omitempty"`

	// SubnetPool is the ID of the subnet pool used by this group
	// +optional
	SubnetPool string `json:"subnetPool,omitempty"`

	// InstanceType is the instance type being used
	// +optional
	InstanceType string `json:"instanceType,omitempty"`

	// Vars are the merged vars being used
	// +optional
	Vars map[string]string `json:"vars,omitempty"`
}

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

type NstanceShardGroupSpec struct {
	// Group is the name of the Nstance Group
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Group string `json:"group"`

	// Shard identifies which zone shard this group is on
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	Shard string `json:"shard"`

	// Size is the desired number of instances for THIS shard
	// +kubebuilder:validation:Minimum=0
	Size int32 `json:"size"`

	// Template is the name of the Nstance template defined in server config.
	// Required when creating a new dynamic group (no static group with this key).
	// +optional
	Template string `json:"template,omitempty"`

	// InstanceType is an optional instance type override
	// +optional
	InstanceType string `json:"instanceType,omitempty"`

	// SubnetPool specifies which subnet pool to use for new dynamic groups.
	// This is a subnet pool ID that references server.subnet_pools map key.
	// +optional
	SubnetPool string `json:"subnetPool,omitempty"`

	// Vars are additional vars merged with template vars
	// +optional
	Vars map[string]string `json:"vars,omitempty"`
}

type NstanceShardGroupStatus struct {
	// ObservedGeneration is the generation most recently observed by the controller
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Replicas is the number of running instances on this shard for this group
	// +optional
	Replicas int32 `json:"replicas"`

	// ProviderIDs is the list of provider IDs of running instances on this shard (sorted)
	// +optional
	// +listType=atomic
	ProviderIDs []string `json:"providerIDs,omitempty"`

	// IsStatic indicates this group is backed by static server config on this shard.
	// When true, template and subnet pool are defined by server config and cannot be overridden.
	// +optional
	IsStatic bool `json:"isStatic,omitempty"`

	// Config is the merged configuration from the server
	// +optional
	Config *NstanceShardGroupConfig `json:"config,omitempty"`

	// LastSyncTime is when the status was last synced from the server
	// +optional
	LastSyncTime *metav1.Time `json:"lastSyncTime,omitempty"`

	// Conditions represent the current state of the NstanceShardGroup
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}