target

type ArtifactMetadata struct {
	// Component is the Atmos component instance name.
	Component string
	// Stack is the Atmos stack the artifact was rendered for.
	Stack string
	// Target is the name of the selected provision target.
	Target string
	// SourcePaths are the component source paths the artifact was rendered from.
	SourcePaths []string
	// RenderHash is a deterministic digest of Files, used for change detection.
	RenderHash string
}

type DeliverInput struct {
	// AtmosConfig is the fully merged Atmos configuration.
	AtmosConfig *schema.AtmosConfiguration
	// TargetName is the configured name of the selected target.
	TargetName string
	// TargetConfig is the merged provision.targets.<name> block.
	TargetConfig map[string]any
	// Artifact is the rendered, producer-agnostic artifact to deliver.
	Artifact ProvisionArtifact
	// AuthContext is the resolved auth context for the component, if any.
	AuthContext *schema.AuthContext
	// EnvProvider composes the identity environment for targets that authenticate
	// via Atmos Auth (e.g. the git target's GitHub STS credentials). May be nil,
	// in which case ambient credentials apply.
	EnvProvider IdentityEnvironmentProvider
}

type FetchInput struct {
	// AtmosConfig is the fully merged Atmos configuration.
	AtmosConfig *schema.AtmosConfiguration
	// TargetName is the configured name of the selected target.
	TargetName string
	// TargetConfig is the merged provision.targets.<name> block.
	TargetConfig map[string]any
	// AuthContext is the resolved auth context for the component, if any.
	AuthContext *schema.AuthContext
	// EnvProvider composes the identity environment for targets that authenticate
	// via Atmos Auth. May be nil, in which case ambient credentials apply.
	EnvProvider IdentityEnvironmentProvider
}

type Fetcher interface {
	// Fetch returns the artifact currently published at the destination. A
	// destination that holds nothing yet returns an artifact with no Files (not an
	// error), so the caller treats it as an empty baseline.
	Fetch(ctx context.Context, in *FetchInput) (ProvisionArtifact, error)
}

type IdentityEnvironmentProvider interface {
	EnsureIdentityEnvironment(ctx context.Context, identityName string) (map[string]string, error)
}

type ProvisionArtifact struct {
	// Kind identifies what was rendered (e.g. ArtifactKindKubernetesManifests).
	Kind string
	// Format describes how Files content is encoded (e.g. FormatYAML).
	Format string
	// Files maps deterministic repo-relative paths to their content.
	Files map[string][]byte
	// Metadata carries provenance for commit messages, trailers, and change detection.
	Metadata ArtifactMetadata
}

type Provisioner interface {
	// Deliver publishes the artifact to the destination described by the input.
	Deliver(ctx context.Context, in *DeliverInput) error
}

type SelectedTarget struct {
	// Name is the configured (or implicit) target name.
	Name string
	// Kind is the registered target kind (e.g. "git", "kubernetes").
	Kind string
	// Config is the merged provision.targets.<name> block (nil for the implicit cluster).
	Config map[string]any
}