v1alpha1

type ClaimReference struct {
	// Name is the name of the SubnetClaim that requested this allocation
	// +optional
	Name string `json:"name,omitempty"`

	// UID is the UID of the SubnetClaim that requested this allocation
	// +optional
	UID string `json:"uid,omitempty"`
}

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

	Spec   SubnetSpec   `json:"spec,omitempty"`
	Status SubnetStatus `json:"status,omitempty"`
}

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

	Spec   SubnetClaimSpec   `json:"spec,omitempty"`
	Status SubnetClaimStatus `json:"status,omitempty"`
}

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

type SubnetClaimPhase string

type SubnetClaimSpec struct {
	// PoolRef is the name of the SubnetPool to allocate from
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	PoolRef string `json:"poolRef"`

	// ClusterID is the unique identifier for the cluster
	// Used as the idempotency key for allocation
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:Pattern="^[a-z0-9.-]{1,63}$"
	ClusterID string `json:"clusterID"`

	// BlockSize is the desired prefix length for the allocated subnet
	// +kubebuilder:validation:Minimum=16
	// +kubebuilder:validation:Maximum=28
	// +optional
	BlockSize int `json:"blockSize,omitempty"`

	// RequestedCIDR is a specific CIDR that is being requested
	// If provided, the allocator will try to allocate this exact CIDR
	// +kubebuilder:validation:Format=cidr
	// +optional
	RequestedCIDR string `json:"requestedCIDR,omitempty"`
}

type SubnetClaimStatus struct {
	// ObservedGeneration はコントローラが最後に処理した世代を記録
	// これにより、Spec変更のない状態更新では再処理を回避できる
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Phase indicates the current phase of the claim
	// +optional
	Phase SubnetClaimPhase `json:"phase,omitempty"`

	// AllocatedCIDR is the CIDR that was allocated for this claim
	// +optional
	AllocatedCIDR string `json:"allocatedCIDR,omitempty"`

	// Message provides additional information about the current phase
	// +optional
	Message string `json:"message,omitempty"`

	// Conditions represents the latest available observations of the claim's state
	// +optional
	// +patchMergeKey=type
	// +patchStrategy=merge
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

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

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

	Spec   SubnetPoolSpec   `json:"spec,omitempty"`
	Status SubnetPoolStatus `json:"status,omitempty"`
}

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

	Spec   SubnetPoolClaimSpec   `json:"spec,omitempty"`
	Status SubnetPoolClaimStatus `json:"status,omitempty"`
}

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

type SubnetPoolClaimPhase string

type SubnetPoolClaimSpec struct {
	// ParentPoolRef is the name of the parent SubnetPool to allocate from
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	ParentPoolRef string `json:"parentPoolRef"`

	// DesiredBlockSize is the desired prefix length for the allocated subnet pool
	// +kubebuilder:validation:Minimum=16
	// +kubebuilder:validation:Maximum=28
	// +kubebuilder:validation:Required
	DesiredBlockSize int `json:"desiredBlockSize"`
}

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

	// Phase indicates the current phase of the claim
	// +optional
	Phase SubnetPoolClaimPhase `json:"phase,omitempty"`

	// BoundPoolName is the name of the SubnetPool that was created for this claim
	// +optional
	BoundPoolName string `json:"boundPoolName,omitempty"`

	// Message provides additional information about the current phase
	// +optional
	Message string `json:"message,omitempty"`

	// Conditions represents the latest available observations of the claim's state
	// +optional
	// +patchMergeKey=type
	// +patchStrategy=merge
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

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

type SubnetPoolSpec struct {
	// CIDR is the overall CIDR range for this pool
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Format=cidr
	CIDR string `json:"cidr"`

	// DefaultBlockSize is the default prefix length to use when a SubnetClaim doesn't specify a blockSize
	// +kubebuilder:validation:Minimum=16
	// +kubebuilder:validation:Maximum=28
	// +kubebuilder:default=24
	// +optional
	DefaultBlockSize int `json:"defaultBlockSize,omitempty"`

	// MinBlockSize is the minimum prefix length that can be requested from this pool
	// +kubebuilder:validation:Minimum=16
	// +kubebuilder:validation:Maximum=28
	// +optional
	MinBlockSize int `json:"minBlockSize,omitempty"`

	// MaxBlockSize is the maximum prefix length that can be requested from this pool
	// +kubebuilder:validation:Minimum=16
	// +kubebuilder:validation:Maximum=28
	// +optional
	MaxBlockSize int `json:"maxBlockSize,omitempty"`

	// Strategy defines the allocation strategy to use
	// +kubebuilder:default=Linear
	// +optional
	Strategy SubnetPoolStrategy `json:"strategy,omitempty"`
}

type SubnetPoolStatus struct {
	// ObservedGeneration はコントローラが最後に処理した世代を記録
	// これにより、Spec変更のない状態更新では再計算を回避できる
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// AllocatedCount is the number of allocated subnet blocks
	// +optional
	AllocatedCount int `json:"allocatedCount,omitempty"`

	// FreeCountBySize is a map of prefix length to number of free blocks
	// +optional
	FreeCountBySize map[string]int `json:"freeCountBySize,omitempty"`

	// AllocatedCIDRs is a map of allocated CIDRs to cluster IDs
	// This serves as the source of truth for subnet allocation
	// +optional
	AllocatedCIDRs map[string]string `json:"allocatedCIDRs,omitempty"`

	// Conditions represents the latest available observations of the pool's state
	// +optional
	// +patchMergeKey=type
	// +patchStrategy=merge
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type SubnetPoolStrategy string

type SubnetSpec struct {
	// PoolRef is the name of the SubnetPool this allocation belongs to
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	PoolRef string `json:"poolRef"`

	// CIDR is the allocated CIDR block
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Format=cidr
	CIDR string `json:"cidr"`

	// ClusterID is the unique identifier for the cluster
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:Pattern="^[a-z0-9.-]{1,63}$"
	ClusterID string `json:"clusterID"`

	// ClaimRef references the SubnetClaim that led to this allocation
	// +optional
	ClaimRef ClaimReference `json:"claimRef,omitempty"`
}

type SubnetStatus struct {
	// Phase represents the current state of the Subnet
	// +optional
	Phase string `json:"phase,omitempty"`

	// AllocatedAt is the timestamp when the CIDR was successfully allocated
	// +optional
	AllocatedAt *metav1.Time `json:"allocatedAt,omitempty"`
}