v1alpha1

type APIInfo struct {
	// Name is the name of the API (usually same as deployment name)
	Name string `json:"name"`

	// URL is the full URL where the OpenAPI spec can be accessed
	URL string `json:"url"`

	// LastUpdated is when the spec was last successfully collected
	LastUpdated string `json:"lastUpdated"`

	// Error is set if there was an error collecting the spec
	Error string `json:"error,omitempty"`

	// ResourceType is the type of the kubernetes resource (Deployment)
	ResourceType string `json:"resourceType"`

	// ResourceName is the name of the kubernetes resource
	ResourceName string `json:"resourceName"`

	// Namespace is the namespace of the kubernetes resource
	Namespace string `json:"namespace"`

	// Path is the OpenAPI spec path for this service
	Path string `json:"path"`

	// Port is the port for this service's OpenAPI spec
	Port string `json:"port"`

	// Annotations stores relevant annotations from the resource
	Annotations map[string]string `json:"annotations,omitempty"`

	// AllowedMethods stores the allowed HTTP methods for Swagger UI
	AllowedMethods []string `json:"allowedMethods,omitempty"`
}

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

	Spec   OpenAPIAggregatorSpec   `json:"spec,omitempty"`
	Status OpenAPIAggregatorStatus `json:"status,omitempty"`
}

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

type OpenAPIAggregatorSpec struct {
	// LabelSelector selects target deployments to collect OpenAPI specs from
	// This field is currently not used if WatchNamespaces is implemented as primary.
	// Consider removing or marking as deprecated if WatchNamespaces becomes the sole method.
	LabelSelector map[string]string `json:"labelSelector,omitempty"`

	// WatchNamespaces specifies a list of namespaces to watch for services.
	// If empty or not provided, the controller will watch services in the same namespace as the OpenAPIAggregator CR.
	// If set to [""] (a list containing a single empty string), the controller will watch services in all namespaces.
	// Requires appropriate RBAC permissions for watching services in the specified namespaces (e.g., ClusterRole for all namespaces).
	// +optional
	WatchNamespaces []string `json:"watchNamespaces,omitempty"`

	// DefaultPath is the default path for OpenAPI documentation
	// +kubebuilder:default="/v2/api-docs"
	DefaultPath string `json:"defaultPath,omitempty"`

	// DefaultPort is the default port for OpenAPI documentation
	// +kubebuilder:default="8080"
	DefaultPort string `json:"defaultPort,omitempty"`

	// SwaggerAnnotation is the annotation key that indicates if the Service should be included
	// +kubebuilder:default="openapi.aggregator.io/swagger"
	SwaggerAnnotation string `json:"swaggerAnnotation,omitempty"`

	// PathAnnotation is the annotation key for OpenAPI path
	// +kubebuilder:default="openapi.aggregator.io/path"
	PathAnnotation string `json:"pathAnnotation,omitempty"`

	// PortAnnotation is the annotation key for OpenAPI port
	// +kubebuilder:default="openapi.aggregator.io/port"
	PortAnnotation string `json:"portAnnotation,omitempty"`

	// AllowedMethodsAnnotation is the annotation key for allowed HTTP methods in Swagger UI
	// +kubebuilder:default="openapi.aggregator.io/allowed-methods"
	AllowedMethodsAnnotation string `json:"allowedMethodsAnnotation,omitempty"`
}

type OpenAPIAggregatorStatus struct {
	// CollectedAPIs contains information about the OpenAPI specs that have been collected
	CollectedAPIs []APIInfo `json:"collectedAPIs,omitempty"`
}

type ResourceList map[string]string

type ResourceRequirements struct {
	// Limits describes the maximum amount of compute resources allowed
	// +optional
	Limits ResourceList `json:"limits,omitempty"`

	// Requests describes the minimum amount of compute resources required
	// +optional
	Requests ResourceList `json:"requests,omitempty"`
}

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

	Spec   SwaggerServerSpec   `json:"spec,omitempty"`
	Status SwaggerServerStatus `json:"status,omitempty"`
}

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

type SwaggerServerSpec struct {

	// ConfigMapName is the name of the ConfigMap containing the OpenAPI specifications.
	// +kubebuilder:validation:Required
	ConfigMapName string `json:"configMapName"`

	// Port is the port number on which the Swagger UI will be exposed.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=65535
	Port int32 `json:"port"`

	// Image is the Docker image to use for the Swagger UI server.
	// If not specified, defaults to "ghcr.io/hellices/openapi-multi-swagger:latest".
	// +optional
	Image string `json:"image,omitempty"`

	// ImagePullPolicy defines the policy for pulling the Docker image.
	// Defaults to "IfNotPresent".
	// +optional
	// +kubebuilder:validation:Enum=Always;Never;IfNotPresent
	ImagePullPolicy string `json:"imagePullPolicy,omitempty"`

	// Resources defines the CPU and memory resources for the Swagger UI server.
	// +optional
	Resources ResourceRequirements `json:"resources,omitempty"`

	// WatchIntervalSeconds is the interval in seconds for the server to check for updates to the ConfigMap.
	// Defaults to "10".
	// +optional
	WatchIntervalSeconds string `json:"watchIntervalSeconds,omitempty"`

	// LogLevel is the logging level for the Swagger UI server.
	// Valid values are: "trace", "debug", "info", "warn", "error", "fatal", "panic".
	// Defaults to "info".
	// +optional
	// +kubebuilder:validation:Enum=trace;debug;info;warn;error;fatal;panic
	LogLevel string `json:"logLevel,omitempty"`

	// DevMode enables or disables development mode for the Swagger UI server, which provides more verbose logging.
	// Valid values are: "true", "false".
	// Defaults to "false".
	// +optional
	// +kubebuilder:validation:Enum="true";"false"
	DevMode string `json:"devMode,omitempty"`
}

type SwaggerServerStatus struct {
	// Ready indicates whether the Swagger UI server is ready to serve requests
	Ready bool `json:"ready"`

	// URL is the URL where the Swagger UI is accessible
	URL string `json:"url,omitempty"`

	// Conditions represent the latest available observations of an object's state
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}