releasecatalog

type Candidate ¶

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

Candidate is one compatible checksum-verified manifest choice bound to its catalog.

func (c Candidate) AuraRevision() artifact.Revision

func (c Candidate) Channel() artifact.ReleaseChannel

func (c Candidate) InstallerMax() artifact.Version

func (c Candidate) InstallerMin() artifact.Version

func (c Candidate) ManifestDigest() artifact.Digest

func (c Candidate) PastureRevision() artifact.Revision

func (c Candidate) Version() artifact.Version

type Catalog ¶

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

func New(source *GitHubSource) (*Catalog, error)

func NewWithDiscoveryLimits(source *GitHubSource, limits DiscoveryLimits) (*Catalog, error)

func (c *Catalog) ListCompatible(ctx context.Context, installer artifact.Version, policy PrereleasePolicy) ([]Candidate, error)

func (c *Catalog) ResolveCandidate(ctx context.Context, candidate Candidate, maxAssetBytes int64) (artifact.VerifiedAggregate, error)

type DiscoveryLimits ¶

type DiscoveryLimits struct {
	MaxCandidates int
	MaxBytes      int64
}

Catalog owns compatible candidate discovery and exact immutable verification.

type Error ¶

type Error struct {
	Stage, Location, Reason, Impact, Fix string
	Cause                                error
}

Error provides stable actionable release-catalog failure fields.

func (e *Error) Error() string

func (e *Error) Unwrap() error

type GitHubLimits ¶

type GitHubLimits struct {
	MaxPages      int
	MaxCandidates int
	MaxBytes      int64
}

GitHubLimits bound complete catalog discovery across every page.

type GitHubSource ¶

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

GitHubSource is the production GitHub Releases API and asset boundary.

func NewGitHubSource(client *http.Client, releasesURL string, maxCatalogBytes int64) (*GitHubSource, error)

func NewGitHubSourceWithLimits(client *http.Client, releasesURL string, limits GitHubLimits) (*GitHubSource, error)

type PrereleasePolicy ¶

type PrereleasePolicy uint8

PrereleasePolicy controls whether release candidates may be selected.

const (
	FinalsOnly PrereleasePolicy = iota + 1
	IncludePrereleases
)