vendoring

type DiffParams struct {
	// Source is the Git source URL of the component.
	Source string
	// From is the starting ref; defaults to the component's current pinned version.
	From string
	// To is the ending ref; when empty, the latest semver tag is used.
	To string
	// File optionally restricts the diff to a single path.
	File string
	// Lister resolves the latest tag when To is empty; defaults to version.DefaultLister.
	Lister version.RemoteLister
	// Differ performs the clone+diff; defaults to DefaultDiffer.
	Differ GitDiffer
}

type GitDiffer interface {
	Diff(ctx context.Context, gitURI, fromRef, toRef, file string) (string, error)
}

type GoGitDiffer struct{}

type SourceUpdateResult struct {
	File           string
	Component      string
	CurrentVersion string
	LatestVersion  string
	Status         UpdateStatus
	Reason         string // Populated for StatusSkipped and StatusFailed.
}

type UpdateParams struct {
	// VendorFiles are the physical manifest files to process (a vendor.yaml plus
	// any imported files). Edits are applied to the file that declares each source.
	VendorFiles []string
	// Component, when set, restricts updates to that component.
	Component string
	// Tags, when set, restricts updates to sources carrying any of these tags.
	Tags []string
	// Type, when set, restricts updates to sources targeting components of this type.
	Type string
	// DryRun reports what would change without writing files.
	DryRun bool
	// Lister lists remote tags; defaults to version.DefaultLister when nil.
	Lister version.RemoteLister
}

type UpdateReport struct {
	Results []SourceUpdateResult
}

type UpdateStatus string