context

type ComponentContext struct {
	// Metadata provides structured naming and labeling information.
	// Accessed via ${metadata.name}, ${metadata.namespace}, ${metadata.componentName}, etc.
	Metadata MetadataContext `json:"metadata"`

	// DataPlane provides data plane configuration.
	// Accessed via ${dataplane.secretStore}, ${dataplane.gateway.ingress.external.https.host}, etc.
	DataPlane DataPlaneData `json:"dataplane"`

	// Environment provides environment-specific gateway configuration.
	// Accessed via ${environment.gateway.ingress.external.https.host}, etc.
	// Falls back to DataPlane gateway values if Environment.Gateway is not configured.
	Environment EnvironmentData `json:"environment"`

	// Gateway provides the effective gateway configuration for this deployment.
	// Uses environment gateway if configured, falls back to DataPlane gateway.
	// Accessed via ${gateway.ingress.external.https.host}, etc.
	Gateway *GatewayData `json:"gateway,omitempty"`

	// Parameters from Component.Spec.Parameters, pruned to ComponentType.Spec.Parameters schema.
	// Accessed via ${parameters.*}
	Parameters map[string]any `json:"parameters"`

	// EnvironmentConfigs from ReleaseBinding.Spec.ComponentTypeEnvironmentConfigs, pruned to ComponentType.Spec.EnvironmentConfigs schema.
	// Accessed via ${environmentConfigs.*}
	EnvironmentConfigs map[string]any `json:"environmentConfigs"`

	// Workload contains workload specification (container, endpoints, connections).
	// Accessed via ${workload.container}, ${workload.endpoints}, etc.
	Workload WorkloadData `json:"workload"`

	// Configurations are extracted configuration items from workload.
	// Contains configs and secrets for the single container.
	// Accessed via ${configurations.configs.envs}, ${configurations.secrets.files}, etc.
	Configurations ContainerConfigurations `json:"configurations"`

	// Dependencies contains dependency metadata and merged env vars for templates.
	// Accessed via ${dependencies.items} and ${dependencies.envVars}.
	Dependencies ConnectionsContextData `json:"dependencies"`
}

type ComponentContextInput struct {
	// Component is the component definition.
	Component *v1alpha1.Component `validate:"required"`

	// ComponentType is the type definition for the component.
	ComponentType *v1alpha1.ComponentType `validate:"required"`

	// ReleaseBinding contains release reference and environment-specific overrides.
	ReleaseBinding *v1alpha1.ReleaseBinding

	// DataPlane contains the data plane configuration.
	// Required - controller must provide this.
	DataPlane *v1alpha1.DataPlane `validate:"required"`

	// Environment contains the environment configuration.
	// Required - controller must provide this.
	Environment *v1alpha1.Environment `validate:"required"`

	// WorkloadData is the pre-computed workload data (containers, endpoints).
	// Should be computed once by the caller using ExtractWorkloadData and shared.
	WorkloadData WorkloadData

	// Configurations is the pre-computed configurations from workload.
	// Should be computed once by the caller using ExtractConfigurationsFromWorkload
	// and shared across ComponentContext and all TraitContexts.
	Configurations ContainerConfigurations

	// Metadata provides structured naming and labeling information.
	// Required - controller must provide this.
	Metadata MetadataContext `validate:"required"`

	// Dependencies contains pre-computed dependency environment variables.
	// Optional - if not provided, dependencies context will be empty.
	Dependencies ConnectionsData

	// DefaultNotificationChannel is the default notification channel name for the environment.
	// Optional - if not provided, the defaultNotificationChannel field in EnvironmentData will be empty.
	DefaultNotificationChannel string
}

type ConfigFileListEntry struct {
	Name         string         `json:"name"`
	MountPath    string         `json:"mountPath"`
	Value        string         `json:"value"`
	ResourceName string         `json:"resourceName"`
	RemoteRef    *RemoteRefData `json:"remoteRef,omitempty"`
}

type ConfigMapVolume struct {
	Name string `json:"name"`
}

type ConfigurationItems struct {
	Envs  []EnvConfiguration  `json:"envs"`
	Files []FileConfiguration `json:"files"`
}

type ConnectionEnvVar struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type ConnectionItem struct {
	Namespace  string             `json:"namespace"`
	Project    string             `json:"project"`
	Component  string             `json:"component"`
	Endpoint   string             `json:"endpoint"`
	Visibility string             `json:"visibility"`
	EnvVars    []ConnectionEnvVar `json:"envVars"`
}

type ConnectionsContextData struct {
	Items   []ConnectionItem   `json:"items"`
	EnvVars []ConnectionEnvVar `json:"envVars"`
}

type ConnectionsData struct {
	Items []ConnectionItem `json:"items"`
}

type ContainerConfigurations struct {
	Configs ConfigurationItems `json:"configs"`
	Secrets ConfigurationItems `json:"secrets"`
}

type ContainerData struct {
	Image   string   `json:"image,omitempty"`
	Command []string `json:"command,omitempty"`
	Args    []string `json:"args,omitempty"`
}

type DataPlaneData struct {
	SecretStore           string                     `json:"secretStore,omitempty"`
	Gateway               *GatewayData               `json:"gateway,omitempty"`
	ObservabilityPlaneRef *ObservabilityPlaneRefData `json:"observabilityPlaneRef,omitempty"`
}

type EmbeddedTraitContextInput struct {
	// Trait is the trait definition.
	Trait *v1alpha1.Trait `validate:"required"`

	// InstanceName is the unique instance name for this embedded trait.
	InstanceName string `validate:"required"`

	// ResolvedParameters contains the CEL-resolved parameters from the embedded binding.
	// These are already concrete values (CEL expressions have been evaluated).
	ResolvedParameters map[string]any

	// ResolvedEnvironmentConfigs contains the CEL-resolved environmentConfig defaults from the embedded binding.
	ResolvedEnvironmentConfigs map[string]any

	// Component is the component this trait is being applied to.
	Component *v1alpha1.Component `validate:"required"`

	// WorkloadData is the pre-computed workload data.
	WorkloadData WorkloadData

	// Configurations is the pre-computed configurations from workload.
	Configurations ContainerConfigurations

	// Dependencies contains pre-computed dependency environment variables.
	Dependencies ConnectionsData

	// Metadata provides structured naming and labeling information.
	Metadata MetadataContext `validate:"required"`

	// SchemaCache is an optional cache for schema bundles.
	SchemaCache map[string]*SchemaBundle

	// DataPlane contains the data plane configuration.
	DataPlane *v1alpha1.DataPlane `validate:"required"`

	// Environment contains the environment configuration.
	Environment *v1alpha1.Environment `validate:"required"`

	// DefaultNotificationChannel is the default notification channel name for the environment.
	// Optional - if not provided, the defaultNotificationChannel field in EnvironmentData will be empty.
	DefaultNotificationChannel string
}

type EndpointData struct {
	DisplayName string   `json:"displayName,omitempty"`
	Port        int32    `json:"port"`
	TargetPort  int32    `json:"targetPort"`
	Type        string   `json:"type"`
	BasePath    string   `json:"basePath,omitempty"`
	Visibility  []string `json:"visibility"`
}

type EnvConfiguration struct {
	Name      string         `json:"name"`
	Value     string         `json:"value,omitempty"`
	RemoteRef *RemoteRefData `json:"remoteRef,omitempty"`
}

type EnvFromEntry struct {
	ConfigMapRef *NameRef `json:"configMapRef,omitempty"`
	SecretRef    *NameRef `json:"secretRef,omitempty"`
}

type EnvironmentData struct {
	Gateway                    *GatewayData `json:"gateway,omitempty"`
	DefaultNotificationChannel string       `json:"defaultNotificationChannel,omitempty"`
}

type EnvsByContainerEntry struct {
	ResourceName string             `json:"resourceName"`
	Envs         []EnvConfiguration `json:"envs"`
}

type FileConfiguration struct {
	Name      string         `json:"name"`
	MountPath string         `json:"mountPath"`
	Value     string         `json:"value,omitempty"`
	RemoteRef *RemoteRefData `json:"remoteRef,omitempty"`
}

type GatewayData struct {
	Ingress *GatewayNetworkData `json:"ingress,omitempty"`
	Egress  *GatewayNetworkData `json:"egress,omitempty"`
}

type GatewayEndpointData struct {
	Name      string               `json:"name,omitempty"`
	Namespace string               `json:"namespace,omitempty"`
	HTTP      *GatewayListenerData `json:"http,omitempty"`
	HTTPS     *GatewayListenerData `json:"https,omitempty"`
	TLS       *GatewayListenerData `json:"tls,omitempty"`
}

type GatewayListenerData struct {
	ListenerName string `json:"listenerName,omitempty"`
	Port         int32  `json:"port,omitempty"`
	Host         string `json:"host,omitempty"`
}

type GatewayNetworkData struct {
	External *GatewayEndpointData `json:"external,omitempty"`
	Internal *GatewayEndpointData `json:"internal,omitempty"`
}

type MetadataContext struct {
	// ComponentName is the name of the component.
	// Example: "my-service"
	ComponentName string `json:"componentName" validate:"required"`

	// ComponentUID is the unique identifier of the component.
	// Example: "a1b2c3d4-5678-90ab-cdef-1234567890ab"
	ComponentUID string `json:"componentUID" validate:"required"`

	// ProjectName is the name of the project.
	// Example: "my-project"
	ProjectName string `json:"projectName" validate:"required"`

	// ProjectUID is the unique identifier of the project.
	// Example: "b2c3d4e5-6789-01bc-def0-234567890abc"
	ProjectUID string `json:"projectUID" validate:"required"`

	// DataPlaneName is the name of the data plane.
	// Example: "my-dataplane"
	DataPlaneName string `json:"dataPlaneName" validate:"required"`

	// DataPlaneUID is the unique identifier of the data plane.
	// Example: "c3d4e5f6-7890-12cd-ef01-34567890abcd"
	DataPlaneUID string `json:"dataPlaneUID" validate:"required"`

	// EnvironmentName is the name of the environment.
	// Example: "production"
	EnvironmentName string `json:"environmentName" validate:"required"`

	// EnvironmentUID is the unique identifier of the environment.
	// Example: "d4e5f6g7-8901-23de-f012-4567890abcde"
	EnvironmentUID string `json:"environmentUID" validate:"required"`

	// Name is the base name to use for generated resources.
	// Example: "my-service-dev-a1b2c3d4"
	Name string `json:"name" validate:"required"`

	// Namespace is the target namespace for the resources.
	// Example: "dp-acme-corp-payment-dev-x1y2z3w4"
	Namespace string `json:"namespace" validate:"required"`

	// ComponentNamespace is the namespace on which the component is created.
	// Example: "cp-acme-corp"
	ComponentNamespace string `json:"componentNamespace" validate:"required"`

	// Labels are common labels to add to all resources.
	// Example: {"openchoreo.dev/component": "my-service", ...}
	Labels map[string]string `json:"labels" validate:"required"`

	// Annotations are common annotations to add to all resources.
	Annotations map[string]string `json:"annotations" validate:"required"`

	// PodSelectors are platform-injected selectors for pod identity.
	// Used in Deployment selectors, Service selectors, etc.
	// Example: {
	//   "openchoreo.dev/namespace": "dp-acme-corp-payment-dev-x1y2z3w4",
	//   "openchoreo.dev/project": "acme-corp",
	//   "openchoreo.dev/component": "payment",
	//   "openchoreo.dev/environment": "dev",
	//   "openchoreo.dev/component-uid": "abc123",
	//   "openchoreo.dev/environment-uid": "dev",
	//   "openchoreo.dev/project-uid": "xyz789",
	// }
	PodSelectors map[string]string `json:"podSelectors" validate:"required,min=1"`
}

type NameRef struct {
	Name string `json:"name"`
}

type ObservabilityPlaneRefData struct {
	Kind string `json:"kind,omitempty"`
	Name string `json:"name,omitempty"`
}

type RemoteRefData struct {
	Key      string `json:"key"`
	Property string `json:"property,omitempty"`
	Version  string `json:"version,omitempty"`
}

type SchemaBundle struct {
	Structural *apiextschema.Structural
	JSONSchema *extv1.JSONSchemaProps
}

type SchemaInput struct {
	// ParametersSchema is the parameters schema section.
	ParametersSchema *v1alpha1.SchemaSection

	// EnvironmentConfigsSchema is the environmentConfigs schema section.
	EnvironmentConfigsSchema *v1alpha1.SchemaSection
}

type SecretFileListEntry struct {
	Name         string         `json:"name"`
	MountPath    string         `json:"mountPath"`
	ResourceName string         `json:"resourceName"`
	RemoteRef    *RemoteRefData `json:"remoteRef,omitempty"`
}

type SecretVolume struct {
	SecretName string `json:"secretName"`
}

type ServicePortEntry struct {
	Name       string `json:"name"`
	Port       int64  `json:"port"`
	TargetPort int64  `json:"targetPort"`
	Protocol   string `json:"protocol"`
}

type TraitContext struct {
	// Metadata provides structured naming and labeling information.
	// Accessed via ${metadata.name}, ${metadata.namespace}, ${metadata.componentName}, etc.
	Metadata MetadataContext `json:"metadata"`

	// Trait contains trait-specific metadata.
	// Accessed via ${trait.name}, ${trait.instanceName}
	Trait TraitMetadata `json:"trait"`

	// Parameters from TraitInstance.Parameters, pruned to Trait.Spec.Parameters schema.
	// Accessed via ${parameters.*}
	Parameters map[string]any `json:"parameters"`

	// EnvironmentConfigs from ReleaseBinding.Spec.TraitEnvironmentConfigs[instanceName], pruned to Trait.Spec.EnvironmentConfigs schema.
	// Accessed via ${environmentConfigs.*}
	EnvironmentConfigs map[string]any `json:"environmentConfigs"`

	// DataPlane provides data plane configuration.
	// Accessed via ${dataplane.secretStore}, ${dataplane.gateway.ingress.external.https.host}, etc.
	DataPlane DataPlaneData `json:"dataplane"`

	// Environment provides environment-specific gateway configuration.
	// Accessed via ${environment.gateway.ingress.external.https.host}, etc.
	// Falls back to DataPlane gateway values if Environment.Gateway is not configured.
	Environment EnvironmentData `json:"environment"`

	// Gateway provides the effective gateway configuration for this deployment.
	// Uses environment gateway if configured, falls back to DataPlane gateway.
	// Accessed via ${gateway.ingress.external.https.host}, etc.
	Gateway *GatewayData `json:"gateway,omitempty"`

	// Workload contains workload specification (container, endpoints).
	// Accessed via ${workload.container}, ${workload.endpoints}
	Workload WorkloadData `json:"workload"`

	// Configurations are extracted configuration items from workload.
	// Contains configs and secrets for the single container.
	// Accessed via ${configurations.configs.envs}, ${configurations.secrets.files}, etc.
	Configurations ContainerConfigurations `json:"configurations"`

	// Dependencies contains dependency metadata and merged env vars for templates.
	// Accessed via ${dependencies.items} and ${dependencies.envVars}.
	Dependencies ConnectionsContextData `json:"dependencies"`
}

type TraitContextInput struct {
	// Trait is the trait definition.
	Trait *v1alpha1.Trait `validate:"required"`

	// Instance contains the specific instance configuration.
	Instance v1alpha1.ComponentTrait `validate:"required"`

	// Component is the component this trait is being applied to.
	Component *v1alpha1.Component `validate:"required"`

	// ReleaseBinding contains release reference and environment-specific overrides.
	// Can be nil if no overrides are needed.
	ReleaseBinding *v1alpha1.ReleaseBinding

	// WorkloadData is the pre-computed workload data (containers, endpoints).
	// Should be computed once by the caller using ExtractWorkloadData and shared.
	WorkloadData WorkloadData

	// Configurations is the pre-computed configurations from workload.
	// Should be computed once by the caller using ExtractConfigurationsFromWorkload
	// and shared across ComponentContext and all TraitContexts.
	Configurations ContainerConfigurations

	// Metadata provides structured naming and labeling information.
	// Required - controller must provide this.
	Metadata MetadataContext `validate:"required"`

	// Dependencies contains pre-computed dependency environment variables.
	// Optional - if not provided, dependencies context will be empty.
	Dependencies ConnectionsData

	// SchemaCache is an optional cache for schema bundles, keyed by trait kind+name with suffix.
	// Used to avoid rebuilding schemas for the same trait used multiple times.
	// BuildTraitContext will check this cache before building and populate it after.
	// Cache keys use format "{kind}:{traitName}:parameters" and "{kind}:{traitName}:environmentConfigs".
	SchemaCache map[string]*SchemaBundle

	// DataPlane contains the data plane configuration.
	// Required - controller must provide this.
	DataPlane *v1alpha1.DataPlane `validate:"required"`

	// Environment contains the environment configuration.
	// Required - controller must provide this.
	Environment *v1alpha1.Environment `validate:"required"`

	// DefaultNotificationChannel is the default notification channel name for the environment.
	// Optional - if not provided, the defaultNotificationChannel field in EnvironmentData will be empty.
	DefaultNotificationChannel string
}

type TraitMetadata struct {
	// Name is the name of the trait.
	// Example: "storage"
	Name string `json:"name"`

	// InstanceName is the unique instance name within the component.
	// Example: "my-storage"
	InstanceName string `json:"instanceName"`
}

type VolumeEntry struct {
	Name      string           `json:"name"`
	ConfigMap *ConfigMapVolume `json:"configMap,omitempty"`
	Secret    *SecretVolume    `json:"secret,omitempty"`
}

type VolumeMountEntry struct {
	Name      string `json:"name"`
	MountPath string `json:"mountPath"`
	SubPath   string `json:"subPath"`
}

type WorkloadData struct {
	Container ContainerData           `json:"container"`
	Endpoints map[string]EndpointData `json:"endpoints"`
}