api

type BuildParams struct {
	ForcePull bool
}

type BuilderAPI interface {
	Build(ctx context.Context, v Vertex, vars []Var, secretsSrc []SecretSrc, params BuildParams) error
}

type Cache struct {
	ID   string
	Path string
}

type CacheAPI interface {
	ClearCache(ctx context.Context, params ClearParams) error
}

type ClearParams struct {
	All bool
}

type Copy struct {
	From maybe.Maybe[either.Either[*Vertex, string]]
	Src  string
	Dst  string
}

type CopyVar struct {
	From maybe.Maybe[string]
	Src  string
	Dst  string
}

type Image struct {
	From       string
	Dockerfile string
}

type Network struct {
	Network string // It may be Host and other docker networks
}

type Output struct {
	Artifact string
	Local    string
}

type SSH struct{}

type Secret struct {
	ID        string
	MountPath string
}

type SecretSrc struct {
	ID         string
	SourcePath string
}

type Stage struct {
	From     string               // From for stage
	Platform maybe.Maybe[string]  // Platform for image
	WorkDir  string               // Working directory for stage
	Env      map[string]string    // Stage env
	Cache    []Cache              // Pluggable cache for build systems
	Copy     []Copy               // Copy local or build stages artifacts
	Network  maybe.Maybe[Network] // Network options
	SSH      maybe.Maybe[SSH]     // SSH access options
	Secrets  []Secret
	Command  maybe.Maybe[string] // Command for stage
	Output   maybe.Maybe[Output] // Output artifacts from builder
}

type Var struct {
	Name     string // Unique Var name
	From     string
	Platform maybe.Maybe[string]
	WorkDir  string
	Env      map[string]string
	Cache    []Cache
	Copy     []CopyVar
	Secrets  []Secret
	Network  maybe.Maybe[Network]
	SSH      maybe.Maybe[SSH]
	Command  string
}

type Vertex struct {
	Name string // Unique Vertex name

	Stage maybe.Maybe[Stage]

	From      maybe.Maybe[*Vertex] // Parent vertex
	DependsOn []Vertex
}