upload

type AppConfigManifest struct {
	// ManifestPath is the absolute path to the rendered ConfigMap YAML.
	// The file itself is not uploaded as a Kubernetes/YAML Unit — the
	// renderer Target re-derives the ConfigMap at apply time.
	ManifestPath string
	// CarrierName is metadata.name of the rendered ConfigMap.
	CarrierName string
	// CarrierNamespace is metadata.namespace (may be empty for
	// cluster-scope ConfigMaps, but the kustomize default sets it).
	CarrierNamespace string
	// Toolchain is the value of installer.confighub.com/toolchain on
	// the ConfigMap (e.g., AppConfig/Properties, AppConfig/Env).
	Toolchain string
	// Mode is appconfig-mode (file|env). Set by the transformer's
	// pre-pass; this code reads it verbatim.
	Mode string
	// SourceKey is the data: key whose value is the raw file body
	// (file mode only). Empty in env mode.
	SourceKey string
	// Mutable reflects appconfig-mutable: when true, the render-configmap
	// Invocation is created with `--immutable=false`, producing a single
	// mutable ConfigMap with a stable name (updates in place; workloads
	// roll via the hash annotation on the pod template). When false (the
	// kustomize default for configMapGenerator), `--immutable=true`
	// produces immutable ConfigMaps with hashed names.
	Mutable bool
	// Content is the raw AppConfig file body. file mode reads
	// data[SourceKey] verbatim; env mode emits a `.env`-shaped doc
	// from data: in sorted key order.
	Content []byte
}

type CrossSpaceLink struct {
	// Slug is the link's deterministic slug, derived from the dep name.
	Slug string
	// Package is the parent package name, used as the value of the
	// "Package" label on the created link.
	Package string
	// FromSpace is the parent's Space; FromUnit is the parent's
	// installer-record Unit slug.
	FromSpace string
	FromUnit  string
	// ToSpace is the dep's Space; ToUnit is the dep's installer-record
	// Unit slug.
	ToSpace string
	ToUnit  string
	// Reason is the human-readable why (the dep's Name from the lock).
	Reason string
}

type DiscoverInput struct {
	WorkDir       string
	SpacePattern  string
	ParentPackage *api.Package
	Lock          *api.Lock // nil when the parent declares no Dependencies
}

type LinkEdge struct {
	FromUnit string
	ToUnit   string
	// Reason is human-readable; surfaced in upload/update logs.
	Reason string
}

type Package struct {
	// Name is metadata.name from installer.yaml.
	Name string
	// Version is installerMetadata.version from installer.yaml.
	Version string
	// LocalHandle is the name the parent used for this dep in its
	// installer.yaml + lock. Empty for the parent itself. Used to derive
	// link slugs and to match dep packages back to lock entries.
	LocalHandle string
	// PackageDir is the directory containing installer.yaml.
	PackageDir string
	// ManifestsDir is where rendered per-resource YAML lives.
	ManifestsDir string
	// SpecDir is where this package's spec docs live (selection.yaml etc.).
	SpecDir string
	// SecretsDir is where rendered Secret YAML lives (never uploaded).
	SecretsDir string
	// SpaceSlug is the ConfigHub Space this package's Units land in.
	SpaceSlug string
	// IsParent is true for the root package; false for every dep.
	IsParent bool
}

type RecordContents struct {
	Package   *api.Package
	Selection *api.Selection
	Inputs    *api.Inputs
	Facts     *api.Facts
	Lock      *api.Lock
	Upload    *api.Upload
}

type UnmatchedReference struct {
	FromUnit   string
	TargetType string
	TargetName string
}

type Vars struct {
	PackageName    string
	PackageVersion string
	// Variant is reserved for the variant work (Phase 9+). Empty in v1.
	Variant string
}