platform

type ChannelVersionTag struct {
	Channel string
	Tag     string
}

type ComponentStats struct {
	Attempted bool
	Images    int
	// Versions are the resolved Deckhouse release versions to mirror (e.g.
	// ["v1.69.0"]); Channels are the release channels mapped to them. Both are
	// resolved by findTagsToMirror before any download, so they are populated in
	// dry-run as well.
	Versions []string
	Channels []string
}

type ConcurrentWorker[T, R any] struct {
	// contains filtered or unexported fields
}

type ImageDownloadList struct {
	Deckhouse                  map[string]*puller.ImageMeta
	DeckhouseExtra             map[string]*puller.ImageMeta
	DeckhouseInstall           map[string]*puller.ImageMeta
	DeckhouseInstallStandalone map[string]*puller.ImageMeta
	DeckhouseReleaseChannel    map[string]*puller.ImageMeta
	// contains filtered or unexported fields
}

type ImageLayouts struct {
	Deckhouse                  *regimage.ImageLayout
	DeckhouseInstall           *regimage.ImageLayout
	DeckhouseInstallStandalone *regimage.ImageLayout
	DeckhouseReleaseChannel    *regimage.ImageLayout
	// contains filtered or unexported fields
}

type Options struct {
	// SinceVersion specifies the minimum version to start mirroring from (optional)
	SinceVersion *semver.Version
	// IncludeConstraint narrows platform release discovery to a user-supplied
	// semver constraint expression, mirroring the per-module constraint syntax
	// accepted by --include-module. When set it replaces the default discovery
	// window (rock-solid..alpha) — only registry tags matching the constraint
	// are pulled, latest-patch-per-(major, minor) collapsing applies and
	// release channels pointing outside the constraint are filtered out.
	//
	// IncludeConstraint is mutually exclusive with TargetTag: pinning one tag
	// and selecting a range simultaneously is contradictory and the CLI
	// rejects that combination before reaching this layer.
	IncludeConstraint modules.VersionConstraint
	// TargetTag specifies a specific tag to mirror instead of determining versions automatically
	// it can be:
	// semver f.e. vX.Y.Z
	// channel f.e. alpha/beta/stable
	// any other tag
	TargetTag string
	// 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
	// IgnoreSuspend allows mirroring even if release channels are suspended
	IgnoreSuspend bool
	// SkipVexImages allows skipping VEX images
	SkipVexImages bool
	// Timeout is the timeout for the platform access check
	Timeout time.Duration
	// DryRun prints the pull plan without downloading any image blobs
	DryRun bool
	// ProxyRegistry replaces catalog-based release discovery (ListTags
	// of the deckhouse release-channel repo) with a sequential probe of
	// individual version tags derived from IncludeConstraint. It exists
	// for proxy/caching registries that do not implement the registry
	// catalog API but DO serve manifests for tags they cache.
	//
	// The CLI requires IncludeConstraint when ProxyRegistry is set so
	// the probe has a defined starting point — without a lower bound
	// from the user the probe would have to start from 0.0.0 and would
	// never find anything.
	ProxyRegistry bool
}

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

type VersionsToMirrorResult struct {
	// Versions contains semver versions to mirror
	Versions []semver.Version
	// Channels contains release channels to mirror
	Channels []string
	// ChannelVersions pairs every channel in Channels with the version tag it
	// points at, so callers can re-tag the pulled images with channel aliases
	// without asking the registry again.
	ChannelVersions []ChannelVersionTag
	// CustomTags contains custom tags (non-semver, non-channel tags) to mirror
	CustomTags []string
}