v1beta1

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

	// +kubebuilder:validation:Enum=Replace;MergeObjects;ForceMergeObjects;MergeObjectsAppendArrays;ForceMergeObjectsAppendArrays
	MergeStrategy MergeStrategy `json:"mergeStrategy,omitempty"`

	Target Target `json:"target"`

	// +kubebuilder:validation:MinItems=1
	Sources []Source `json:"sources"`

	// ParseEmbedded decodes string values that are YAML mappings so their
	// contents deep merge instead of being replaced wholesale.
	ParseEmbedded bool `json:"parseEmbedded,omitempty"`

	// AllowedSourceNamespaces lists the namespaces a source may be read from
	// besides the composite resource's own, when that source also sets
	// allowCrossNamespace. Ignored for a cluster scoped composite.
	AllowedSourceNamespaces []string `json:"allowedSourceNamespaces,omitempty"`

	Debug bool `json:"debug,omitempty"`
}

type MergeStrategy string

type ParseFormat string

type ParseSpec struct {
	// +kubebuilder:validation:Enum=Auto;YAML;JSON
	// Format defaults to Auto. It is a no-op for any target that is not a
	// ConfigMap or Secret: only those two targets re-encode the merged data to
	// strings, so a value parsed for an EnvironmentConfig or CRD target keeps
	// its native map shape regardless of Format.
	Format ParseFormat `json:"format,omitempty"`

	// Keys lists the data keys to parse. Empty means every key, which is what
	// the Input-level parseEmbedded does.
	Keys []string `json:"keys,omitempty"`
}

type Readiness string

type Resolution string

type ResourceRef struct {
	APIVersion string `json:"apiVersion"`
	Kind       string `json:"kind"`
	Name       string `json:"name,omitempty"`

	// NameFromCompositeFieldPath resolves Name from a field path on the
	// composite resource, for example "spec.tenant". Mutually exclusive with
	// Name.
	//
	// There is deliberately no namespace equivalent. Namespace stays a static
	// string chosen by the Composition author, which bounds what a source can
	// ever be steered at.
	NameFromCompositeFieldPath string `json:"nameFromCompositeFieldPath,omitempty"`

	// Namespace is empty for cluster scoped kinds such as EnvironmentConfig.
	Namespace string `json:"namespace,omitempty"`
}

type Source struct {
	// Name is unique across sources. It is the required resource key.
	Name string      `json:"name"`
	Ref  ResourceRef `json:"ref"`

	// +kubebuilder:validation:Enum=Required;Optional
	Resolution Resolution `json:"resolution,omitempty"`

	// FromFieldPath defaults to data.
	FromFieldPath string `json:"fromFieldPath,omitempty"`

	// AllowCrossNamespace permits this source to be read from a namespace other
	// than the composite resource's own. The namespace must also appear in
	// Merge.AllowedSourceNamespaces. Only meaningful when the composite is
	// namespaced; ignored when it is cluster scoped, where cross namespace
	// reads are already the norm.
	AllowCrossNamespace bool `json:"allowCrossNamespace,omitempty"`

	// ToFieldPath places this source's contribution under a subtree of the
	// merged result instead of at its root. Dotted, for example
	// "teams.payments". Empty means the root, which is the default.
	//
	// This is placement, not precedence: the fold order and Merge.MergeStrategy
	// are unchanged.
	//
	// For a ConfigMap or Secret target, data is map[string]string, so a nested
	// subtree is not representable. It is YAML-encoded into a single string
	// value at the top-level key of this path.
	ToFieldPath string `json:"toFieldPath,omitempty"`

	// Parse scopes and shapes embedded-blob parsing for this source,
	// overriding the Input-level parseEmbedded. A source with no Parse block
	// follows parseEmbedded.
	//
	// When ToFieldPath is also set, the nested subtree collapses to one blob,
	// so per-key format detection is meaningless: Auto always re-encodes the
	// whole subtree as YAML, and only an explicit Format overrides it.
	Parse *ParseSpec `json:"parse,omitempty"`
}

type Target struct {
	APIVersion string `json:"apiVersion"`
	Kind       string `json:"kind"`

	Name                       string `json:"name,omitempty"`
	NameFromCompositeFieldPath string `json:"nameFromCompositeFieldPath,omitempty"`

	Namespace                       string `json:"namespace,omitempty"`
	NamespaceFromCompositeFieldPath string `json:"namespaceFromCompositeFieldPath,omitempty"`

	// ToFieldPath defaults to data.
	ToFieldPath string          `json:"toFieldPath,omitempty"`
	Metadata    *TargetMetadata `json:"metadata,omitempty"`

	// StringifyScalars coerces a top-level non-string scalar to a string for a
	// ConfigMap or Secret target instead of failing. Off by default: the
	// coercion is one way, since an int written as "3" never returns as an int.
	// It exists for EnvironmentConfig and CR sources, whose data may legally
	// hold numbers. Every coerced key is named on the Merged condition.
	StringifyScalars bool `json:"stringifyScalars,omitempty"`

	// +kubebuilder:validation:Enum=True;False
	// Readiness defaults to True.
	Readiness Readiness `json:"readiness,omitempty"`

	// Context additionally writes the merged result into the Composition
	// context, for later pipeline steps. The composed resource is still
	// produced; this is an additional destination, not an alternative one.
	Context *TargetContext `json:"context,omitempty"`
}

type TargetContext struct {
	// Key is the context key the merged result is written to.
	Key string `json:"key"`
}

type TargetMetadata struct {
	Labels      map[string]string `json:"labels,omitempty"`
	Annotations map[string]string `json:"annotations,omitempty"`
}