plugins

type Catalog interface {
	// PluginNames lists the plugin names published in the catalog.
	PluginNames(ctx context.Context) ([]string, error)
	// PluginVersions lists a plugin's published stable versions, newest
	// first. Non-semver tags (werf build junk) and genuine pre-releases are
	// dropped - the same notion of "stable" that plugin install uses.
	PluginVersions(ctx context.Context, name string) ([]*semver.Version, error)
	// Contract returns the decoded contract of one plugin version. An image
	// without a contract annotation yields a degenerate {Name, Version}
	// contract, not an error.
	Contract(ctx context.Context, name string, version *semver.Version) (*internal.Plugin, error)
}

type ModuleInBundle struct {
	Name     string
	Versions []*semver.Version
}

type Options struct {
	// Filter carries --include-plugin expressions (whitelist, additive to the
	// module-driven auto-selection). May be nil.
	Filter *modules.Filter
	// Builtins are d8 built-in command names that satisfy a same-named plugin
	// dependency by presence (never pulled).
	Builtins map[string]struct{}
	// BundleDir is the directory to store the bundle.
	BundleDir string
	// BundleChunkSize is the max size of bundle chunks in bytes (0 = no chunking).
	BundleChunkSize int64
	// DryRun prints the pull plan without downloading any image blobs.
	DryRun bool
	// ProxyRegistry means the registry serves no catalog: auto-selection is
	// impossible, only explicit exact pins are resolved.
	ProxyRegistry bool
}

type PluginStat struct {
	Name   string
	Images int
	// Versions are the pulled versions, newest first. Filled at resolution
	// time, so available in dry-run too.
	Versions []PluginVersionStat
}

type PluginToMirror struct {
	Name string
	// Versions to pull, newest first. Several versions appear when different
	// bundled module versions need different plugin versions.
	Versions []SelectedVersion
}

type PluginVersionStat struct {
	Version string
	Reasons []Reason
}

type PluginsStats struct {
	Attempted   bool
	Plugins     []PluginStat
	Skipped     []SkippedPlugin
	Warnings    []string
	TotalImages int
}

type PullInput struct {
	// Modules are the mirrored modules with their bundled versions.
	Modules []ModuleInBundle
	// PlatformVersions are the mirrored Deckhouse platform versions.
	PlatformVersions []*semver.Version
}

type Reason struct {
	Kind    ReasonKind
	Subject string
	// Constraint is the requirement constraint that created the edge,
	// empty when none was declared.
	Constraint string
}

type ReasonKind int

type Resolution struct {
	// Plugins to mirror, sorted by name for deterministic output.
	Plugins []PluginToMirror
	Skipped []SkippedPlugin
	// Warnings are advisories that do not block the pull (e.g. an explicitly
	// included plugin whose required module is not in the bundle).
	Warnings []string
}

type ResolveInput struct {
	// Modules are the modules mirrored into this bundle with their versions.
	// Empty when modules were not mirrored: nothing is auto-selected then and
	// only explicit --include-plugin entries are resolved.
	Modules []ModuleInBundle
	// PlatformVersions are the mirrored Deckhouse platform versions. Empty
	// when the platform phase was skipped; the contract's deckhouse
	// constraint is then not checked.
	PlatformVersions []*semver.Version
	// Filter carries --include-plugin expressions. Explicit picks are
	// additive: they are pulled on top of the module-driven selection.
	Filter *modules.Filter
	// Builtins are d8 built-in command names (e.g. delivery-kit, package)
	// that satisfy a same-named plugin dependency by presence, so such a
	// dependency never blocks the bundle. The plugin is still mirrored when
	// the registry publishes it - once installed it takes the command over,
	// and an air-gapped cluster has no other way to obtain it.
	Builtins map[string]struct{}
	// NoCatalog means the registry serves no plugin version listing
	// (--proxy-registry). Dependencies then resolve only against versions
	// the user pinned explicitly; nothing is looked up.
	NoCatalog bool
}

type Resolver interface {
	Resolve(ctx context.Context, in ResolveInput) (*Resolution, error)
}

type SelectedVersion struct {
	Version  *semver.Version
	Contract *internal.Plugin
	Reasons  []Reason
}

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

type SkippedPlugin struct {
	Name   string
	Reason string
}