v1alpha1

type CRDMetadata struct {
	// Labels to apply to the generated CRD
	// +kubebuilder:validation:Optional
	Labels map[string]string `json:"labels,omitempty"`

	// Annotations to apply to the generated CRD
	// +kubebuilder:validation:Optional
	Annotations map[string]string `json:"annotations,omitempty"`
}

type Condition struct {
	// Type is the type of the Condition
	Type ConditionType `json:"type"`
	// Status of the condition, one of True, False, Unknown.
	Status metav1.ConditionStatus `json:"status"`
	// Last time the condition transitioned from one status to another.
	// +optional
	LastTransitionTime *metav1.Time `json:"lastTransitionTime,omitempty"`
	// The reason for the condition's last transition.
	// +optional
	Reason *string `json:"reason,omitempty"`
	// A human-readable message indicating details about the transition.
	// +optional
	Message *string `json:"message,omitempty"`
	// observedGeneration represents the .metadata.generation that the condition was set based upon.
	// For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
	// with respect to the current state of the instance.
	// +optional
	// +kubebuilder:validation:Minimum=0
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`
}

type ConditionType string

type Conditions []Condition

type Dependency struct {
	// ID is the unique identifier of the resource that this resource depends on.
	ID string `json:"id,omitempty"`
}

type ExternalRef struct {
	// APIVersion is the API version of the external resource.
	// Example: "v1" for core resources, "apps/v1" for Deployments.
	//
	// +kubebuilder:validation:Required
	APIVersion string `json:"apiVersion"`
	// Kind is the kind of the external resource.
	// Example: "Service", "ConfigMap", "Deployment".
	//
	// +kubebuilder:validation:Required
	Kind string `json:"kind"`
	// Metadata contains the name and optional namespace of the external resource.
	//
	// +kubebuilder:validation:Required
	Metadata ExternalRefMetadata `json:"metadata"`
}

type ExternalRefMetadata struct {
	// Name is the name of the external resource to reference.
	// Mutually exclusive with Selector.
	//
	// +kubebuilder:validation:Optional
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name,omitempty"`
	// Namespace is the namespace of the external resource.
	// For single external refs (Name), defaults to the instance's namespace.
	// For external collections (Selector), empty means list across all namespaces.
	//
	// +kubebuilder:validation:Optional
	Namespace string `json:"namespace,omitempty"`
	// Selector is a label selector for collection external references.
	// When set, all resources matching the selector are included.
	// Mutually exclusive with Name.
	//
	// +kubebuilder:validation:Optional
	Selector *metav1.LabelSelector `json:"selector,omitempty"`
}

type ForEachDimension map[string]string

type InstanceState string

type NodeState string

type Resource struct {
	// ID is a unique identifier for this resource within the ResourceGraphDefinition.
	// It is used to reference this resource in CEL expressions from other resources.
	// Example: "deployment", "service", "configmap".
	//
	// +kubebuilder:validation:Required
	ID string `json:"id,omitempty"`
	// Template is the Kubernetes resource manifest to create.
	// It can contain CEL expressions (using ${...} syntax) that reference other resources.
	// Exactly one of template or externalRef must be provided.
	//
	// +kubebuilder:validation:Optional
	Template runtime.RawExtension `json:"template,omitempty"`
	// ExternalRef references an existing resource in the cluster instead of creating one.
	// This is useful for reading existing resources and using their values in other resources.
	// Exactly one of template or externalRef must be provided.
	//
	// +kubebuilder:validation:Optional
	ExternalRef *ExternalRef `json:"externalRef,omitempty"`
	// ReadyWhen is a list of CEL expressions that determine when this resource is considered ready.
	// All expressions must evaluate to true for the resource to be ready.
	// If not specified, the resource is considered ready when it exists.
	// Examples:
	// - Single resource: ["database.status.phase == 'Running'", "database.status.readyReplicas > 0"]
	// - Collection: ["each.status.phase == 'Running'"]
	//
	// +kubebuilder:validation:Optional
	ReadyWhen []string `json:"readyWhen,omitempty"`
	// IncludeWhen is a list of CEL expressions that determine whether this resource should be created.
	// All expressions must evaluate to true for the resource to be included.
	// If not specified, the resource is always included.
	// Expressions may reference schema fields and/or fields in other resources in the RGD. They are
	// re-evaluated during reconciliation, so resources may be created later or
	// pruned later as conditions change.
	// Example: ["schema.spec.enableMonitoring == true", "network.status.ready == true"]
	//
	// +kubebuilder:validation:Optional
	IncludeWhen []string `json:"includeWhen,omitempty"`
	// ForEach expands this resource into a collection of resources.
	// Each entry binds a variable name to a CEL expression that evaluates to an array.
	// kro creates one resource instance for each element in the array.
	// With multiple entries, kro creates the cartesian product of all combinations.
	// Use the variable directly in template expressions (e.g., ${region}).
	// Example: [{"region": "${schema.spec.regions}"}, {"tier": "${schema.spec.tiers}"}]
	//
	// +kubebuilder:validation:Optional
	ForEach []ForEachDimension `json:"forEach,omitempty"`
}

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

	Spec   ResourceGraphDefinitionSpec   `json:"spec,omitempty"`
	Status ResourceGraphDefinitionStatus `json:"status,omitempty"`
}

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

type ResourceGraphDefinitionSpec struct {
	// Schema defines the structure of instances created from this ResourceGraphDefinition.
	// It specifies the API version, kind, and fields (spec/status) for the generated CRD.
	// Use SimpleSchema syntax to define the instance schema concisely.
	//
	// +kubebuilder:validation:Required
	Schema *Schema `json:"schema,omitempty"`
	// Resources is the list of Kubernetes resources that will be created and managed
	// for each instance. Resources can reference each other using CEL expressions,
	// creating a dependency graph that determines creation order.
	//
	// +kubebuilder:validation:Optional
	Resources []*Resource `json:"resources,omitempty"`
}

type ResourceGraphDefinitionState string

type ResourceGraphDefinitionStatus struct {
	// State indicates whether the ResourceGraphDefinition is Active or Inactive.
	// Active means the graph is accepted and the generated CRD and dynamic controller
	// are currently serving.
	// Inactive means the current graph is not accepted or the RGD is not currently serving.
	State ResourceGraphDefinitionState `json:"state,omitempty"`
	// TopologicalOrder is the ordered list of resource IDs based on their dependencies.
	// Resources are created in this order to ensure dependencies are satisfied.
	// Example: ["configmap", "deployment", "service"]
	TopologicalOrder []string `json:"topologicalOrder,omitempty"`
	// Conditions represent the latest available observations of the ResourceGraphDefinition's state.
	// Common condition types include "Ready", "GraphRevisionsResolved", "GraphAccepted",
	// "KindReady", and "ControllerReady".
	Conditions Conditions `json:"conditions,omitempty"`
	// Resources provides detailed information about each resource in the graph,
	// including their dependencies.
	Resources []ResourceInformation `json:"resources,omitempty"`
	// LastIssuedRevision is the highest GraphRevision revision number ever issued for this RGD.
	// It is a persisted high-water mark used to keep revision allocation monotonic across GC.
	LastIssuedRevision int64 `json:"lastIssuedRevision,omitempty"`
}

type ResourceInformation struct {
	// ID is the unique identifier of the resource as defined in the resources list.
	ID string `json:"id,omitempty"`
	// Dependencies lists all resources that this resource depends on.
	// A resource depends on another if it references it in a CEL expression.
	// These dependencies determine the order of resource creation.
	Dependencies []Dependency `json:"dependencies,omitempty"`
}

type ResourceScope string

type Schema struct {
	// Kind is the name of the custom resource type that will be created.
	// This becomes the kind field of the generated CRD and must be a valid Kubernetes kind name
	// (PascalCase, starting with a capital letter). This field is immutable after creation.
	// Example: "WebApplication", "Database", "MicroService"
	//
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Pattern=`^[A-Z][a-zA-Z0-9]{0,62}$`
	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="kind is immutable"
	Kind string `json:"kind,omitempty"`
	// APIVersion is the version identifier for the generated CRD.
	// Must follow Kubernetes versioning conventions (v1, v1alpha1, v1beta1, etc.).
	// This field is immutable after creation.
	// Example: "v1alpha1", "v1", "v2beta1"
	//
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Pattern=`^v[0-9]+(alpha[0-9]+|beta[0-9]+)?$`
	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="apiVersion is immutable"
	APIVersion string `json:"apiVersion,omitempty"`
	// Group is the API group for the generated CRD. Together with APIVersion and Kind,
	// it forms the complete GVK (Group-Version-Kind) identifier.
	// If omitted, defaults to "kro.run". This field is immutable after creation.
	// Example: "mycompany.io", "databases.example.com"
	//
	// +kubebuilder:validation:Optional
	// +kubebuilder:default="kro.run"
	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="group is immutable"
	Group string `json:"group,omitempty"`
	// Spec defines the schema for the instance's spec section using SimpleSchema syntax.
	// This becomes the OpenAPI schema for instances of the generated CRD.
	// Use SimpleSchema's concise syntax to define fields, types, defaults, and validations.
	// Example: {"replicas": "integer | default=1 | min=1 | max=10"}
	Spec runtime.RawExtension `json:"spec,omitempty"`

	// Types is a map of custom type definitions that can be referenced in the Spec.
	// This allows you to define reusable complex types using SimpleSchema syntax.
	// Reference custom types in Spec using the type name.
	// Example: {"Server": {"host": "string", "port": "integer"}}
	Types runtime.RawExtension `json:"types,omitempty"`

	// Status defines the schema for the instance's status section using SimpleSchema syntax.
	// Unlike spec, status fields use CEL expressions to project values from underlying resources.
	// This allows you to surface important information from managed resources at the instance level.
	// Example: {"connectionName": "${database.status.connectionName}", "endpoint": "${service.status.loadBalancer.ingress[0].hostname}"}
	Status runtime.RawExtension `json:"status,omitempty"`

	// Scope determines whether the generated instance CRD is Namespaced or Cluster scoped.
	// Defaults to Namespaced to preserve existing behaviour. This field is immutable after creation.
	//
	// +kubebuilder:validation:Required
	// +kubebuilder:default="Namespaced"
	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="scope is immutable"
	Scope ResourceScope `json:"scope,omitempty"`

	// AdditionalPrinterColumns defines additional printer columns
	// that will be passed down to the created CRD. If set, no
	// default printer columns will be added to the created CRD,
	// and if default printer columns need to be retained, they
	// need to be added explicitly.
	//
	// +kubebuilder:validation:Optional
	AdditionalPrinterColumns []extv1.CustomResourceColumnDefinition `json:"additionalPrinterColumns,omitempty"`

	// Metadata to apply to the generated CRD
	// +kubebuilder:validation:Optional
	Metadata *CRDMetadata `json:"metadata,omitempty"`
}