artifact

type Artifact struct {
	Name     string // e.g., "myapp_1.0.0_darwin_arm64.tar.gz"
	Path     string // local path to the file
	OS       string // "darwin", "linux"
	Arch     string // "amd64", "arm64"
	Checksum string // SHA256
}

type BuildTarget struct {
	OS   string
	Arch string
}

type GitHubSource struct {
	// contains filtered or unexported fields
}

type GitHubSourceConfig struct {
	Owner string // GitHub repository owner
	Repo  string // GitHub repository name
	Tag   string // Release tag (e.g., "v1.0.0")
	Token string // GitHub token (optional, for private repos or rate limiting)
}

type GoSource struct {
	// contains filtered or unexported fields
}

type GoSourceConfig struct {
	// Packages to build (e.g., ["./cmd/myapp"])
	Packages []string

	// Ldflags template (supports {{.Version}}, {{.Commit}}, {{.ShortCommit}},
	// {{.Date}}, {{.Tag}})
	Ldflags string

	// Build tags, passed as a single -tags argument
	Tags []string

	// Extra environment variables for go build, as KEY=value strings
	Env []string

	// Enable CGO (default: false for portable static binaries)
	CGOEnabled bool

	// Use -trimpath for reproducible builds. There is no default here: the
	// caller decides (config.BuildConfig.TrimpathEnabled defaults it to true).
	Trimpath bool

	// Extra go build flags
	Flags []string

	// Path to go.mod directory (default: ".")
	ModDir string

	// Number of parallel builds (default: GOMAXPROCS)
	Parallel int

	// Version string for ldflags template
	Version string

	// Git commit SHA for ldflags template
	Commit string

	// Git tag for ldflags template
	Tag string

	// Build date for ldflags template (default: now or SOURCE_DATE_EPOCH)
	Date time.Time

	// Binary names to use (defaults to package base name)
	Binaries []string

	// Targets restricts the GOOS/GOARCH combinations to build
	// (default: all Homebrew-supported targets)
	Targets []BuildTarget
}

type LocalSource struct {
	// contains filtered or unexported fields
}

type Source interface {
	// List returns all available artifacts
	List(ctx context.Context) ([]Artifact, error)
	// Fetch downloads/copies an artifact to the target directory
	Fetch(ctx context.Context, artifact Artifact, targetDir string) (string, error)
	// Close releases any resources
	Close() error
}