upgrade

type Catalog struct {
	Current     *version.Version
	Options     []VersionOption
	Recommended int // index into Options, -1 when empty
	LatestPatch int // index of the newest patch of the current minor, -1 when none
}

type ChangelogEntry struct {
	Version string
	// Date is the release date (yyyy-mm-dd), "" when the Store has none.
	Date string
	// Text is the release note as plain text (the Store serves HTML).
	Text string
}

type CheckState int

type ExtStatus int

type ExtensionChangelog struct {
	// Extension is the technical name, e.g. SwagPayPal.
	Extension string
	// From is the installed version, To the update's target version.
	From string
	To   string
	// StoreLink is the Shopware Store listing URL when the Store knows the
	// extension, "" otherwise.
	StoreLink string
	// Entries are ordered newest first.
	Entries []ChangelogEntry
}

type ExtensionResult struct {
	Extension InstalledExtension
	Status    ExtStatus
	// Available is the lowest extension release compatible with the target
	// version ("" when none exists).
	Available string
	// StoreLabel is the compatibility label reported by the Shopware Store
	// ("" when the extension is unknown to the Store).
	StoreLabel string
	// Replacement names a successor extension when Status is ExtDeprecated.
	Replacement string
	// ChangelogURL points at the Shopware Store listing when the extension
	// is known there, otherwise at the providing Composer repository page.
	ChangelogURL string
	// Detail is a one-line explanation shown in the detail overlay.
	Detail string
}

type HeadlessOptions struct {
	// Target is the version to upgrade to: an exact version from the
	// supported catalog, or the keywords "recommended" / "latest-patch".
	Target string
	// DryRun stops after the read-only preflight (readiness, extension
	// compatibility, Composer dry-run) without modifying any file.
	DryRun bool
	// NoAudit continues when dependencies are blocked by security advisories
	// (config.audit.block-insecure = false, like project create's --no-audit).
	NoAudit bool
	// Out receives the progress output.
	Out io.Writer
}

type InstalledExtension struct {
	Name            string // technical name, e.g. SwagPayPal
	Package         string // composer package name, e.g. swag/paypal
	Path            string
	Version         string
	ComposerManaged bool
	// PathInstalled is true when Composer installed the package from a path
	// repository (composer.lock dist.type == "path"). The installed files are
	// the local project copy — typically under custom/static-plugins — not a
	// published release that can be version-bumped independently.
	PathInstalled bool
	// Require is the package's composer.json/lock require map when known.
	// Used to classify path and other unpublished packages against the
	// target Shopware version.
	Require map[string]string
}

type PackageChange struct {
	Name string
	// From is empty for new installs; To is empty for removals.
	From string
	To   string
	// Op is "install", "upgrade", "downgrade", or "remove".
	Op string
}

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

type Readiness struct {
	Checks         []ReadinessCheck
	CurrentVersion *version.Version
	Extensions     []InstalledExtension
}

type ReadinessCheck struct {
	ID       string
	Label    string
	Value    string // short right-aligned value, e.g. "yes" or "14"
	Detail   string // dimmed sub-line, e.g. the repository path
	State    CheckState
	Blocking bool // a failed blocking check prevents continuing
}

type ReportData struct {
	ProjectName    string
	Current        string
	Target         string
	GeneratedAt    time.Time
	Checks         []ReadinessCheck
	Extensions     []ExtensionResult
	PlannedChanges []string
	// PHPRequirement is the PHP constraint of the target shopware/core
	// release; PHPInstalled the locally detected version.
	PHPRequirement string
	PHPInstalled   string
	// ComposerReport is the raw Composer output attached when dependency
	// resolution failed.
	ComposerReport string
	// ResolvedChanges are the lock-file operations the dry run predicted.
	ResolvedChanges []PackageChange
	// Changelogs are the Store release notes of the extension updates the
	// upgrade applies.
	Changelogs []ExtensionChangelog
	// Failed marks a report written for an upgrade that was rolled back;
	// Error carries the failing step's message.
	Failed bool
	Error  string
}

type ResolveResult struct {
	OK bool
	// Report is Composer's raw output; when the resolution fails it is the
	// diagnostic to attach to the upgrade report and support tickets.
	Report string
	// Changes are the lock-file differences of a successful resolution — the
	// exact versions Composer will install.
	Changes []PackageChange
}

type RunOptions struct {
	// Target is the Shopware version to upgrade to.
	Target string
	// ResolvedVersions maps packages to the version the preflight resolution
	// picked; extensions are pinned to these in composer.json.
	ResolvedVersions map[string]string
	// Report is the pre-assembled report data; the run fills in the Composer
	// changes it makes and writes the report file at the end.
	Report ReportData
}

type StepEvent struct {
	Step  StepID
	State CheckState
	Line  string
	Err   error
}

type StepID int

type VersionOption struct {
	Version         *version.Version
	Tag             string // e.g. "recommended", "latest 6.6 patch"
	SupportType     string // "active", "security", "eol" or "" when unknown
	SupportUntil    time.Time
	ReleaseNotesURL string
}