package v1alpha1

import "cue.dev/x/k8s.io/apimachinery/pkg/apis/meta/v1"

// An API server instance reports the version it can decode and
// the version it encodes objects to when persisting objects in
// the backend.
#ServerStorageVersion: {
	// apiServerID is the ID of the reporting API server.
	"apiServerID"!: string

	// decodableVersions are the encoding versions the API server can
	// handle to decode. The API server can decode objects encoded in
	// these versions. The encodingVersion must be included in the
	// decodableVersions.
	"decodableVersions"!: [...string]

	// encodingVersion the API server encodes the object to when
	// persisting it in the backend (e.g., etcd).
	"encodingVersion"!: string

	// servedVersions lists all versions the API server can serve.
	// DecodableVersions must include all ServedVersions.
	"servedVersions"?: [...string]
}

// Storage version of a specific resource.
#StorageVersion: {
	// APIVersion defines the versioned schema of this representation
	// of an object. Servers should convert recognized schemas to the
	// latest internal value, and may reject unrecognized values.
	// More info:
	// https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
	"apiVersion": "internal.apiserver.k8s.io/v1alpha1"

	// Kind is a string value representing the REST resource this
	// object represents. Servers may infer this from the endpoint
	// the client submits requests to. Cannot be updated. In
	// CamelCase. More info:
	// https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
	"kind": "StorageVersion"

	// metadata is the standard object metadata. The name is
	// <group>.<resource>.
	"metadata"!: v1.#ObjectMeta

	// spec is an empty spec. It is here to comply with Kubernetes API
	// style.
	"spec"?: #StorageVersionSpec

	// status on the version the API server instance can decode from
	// and encode objects to when persisting objects in the backend.
	"status"?: #StorageVersionStatus
}

// Describes the state of the storageVersion at a certain point.
#StorageVersionCondition: {
	// lastTransitionTime is the last time the condition transitioned
	// from one status to another.
	"lastTransitionTime"?: v1.#Time

	// message is a human readable string indicating details about the
	// transition.
	"message"!: string

	// observedGeneration represents the .metadata.generation that the
	// condition was set based upon, if field is set.
	"observedGeneration"?: int64 & int

	// reason for the condition's last transition.
	"reason"!: string

	// status of the condition, one of True, False, Unknown.
	"status"!: string

	// type of the condition.
	"type"!: string
}

// A list of StorageVersions.
#StorageVersionList: {
	// APIVersion defines the versioned schema of this representation
	// of an object. Servers should convert recognized schemas to the
	// latest internal value, and may reject unrecognized values.
	// More info:
	// https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
	"apiVersion": "internal.apiserver.k8s.io/v1alpha1"

	// Items holds a list of StorageVersion
	"items"!: [...#StorageVersion]

	// Kind is a string value representing the REST resource this
	// object represents. Servers may infer this from the endpoint
	// the client submits requests to. Cannot be updated. In
	// CamelCase. More info:
	// https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
	"kind": "StorageVersionList"

	// Standard list metadata. More info:
	// https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	"metadata"?: v1.#ListMeta
}

// StorageVersionSpec is an empty spec.
#StorageVersionSpec: {}

// API server instances report the versions they can decode and
// the version they encode objects to when persisting objects in
// the backend.
#StorageVersionStatus: {
	// commonEncodingVersion is set to an encoding storage version if
	// all API server instances share that same version. If they
	// don't share one storage version, this field is left empty. API
	// servers should finish updating its storageVersionStatus entry
	// before serving write operations, so that this field will be in
	// sync with the reality.
	"commonEncodingVersion"?: string

	// conditions lists the latest available observations of the
	// storageVersion's state.
	"conditions"?: [...#StorageVersionCondition]

	// storageVersions lists the reported versions per API server
	// instance.
	"storageVersions"?: [...#ServerStorageVersion]
}