release

type Artifact struct {
	Type     ArtifactType
	Version  string // Branch name (e.g., "main") or version tag
	Arch     string
	Platform string
}

type ArtifactInfo struct {
	Name     string `json:"name"`               // Artifact filename
	SHA256   string `json:"sha256"`             // SHA256 checksum
	Size     int64  `json:"size,omitempty"`     // File size in bytes (optional)
	Platform string `json:"platform,omitempty"` // Target platform (optional)
	Arch     string `json:"arch,omitempty"`     // Target architecture (optional)
}

type ArtifactType string

type DownloadOptions struct {
	// TargetDir is where to download the artifact
	TargetDir string
	// ProgressWriter receives progress updates (optional)
	ProgressWriter io.Writer
	// SkipChecksum skips checksum verification (not recommended)
	SkipChecksum bool
	// ExpectedChecksum allows providing a known checksum from metadata
	ExpectedChecksum string
}

type DownloadedArtifact struct {
	Artifact Artifact
	Path     string
	Checksum string
	Size     int64
}

type Downloader interface {
	Download(ctx context.Context, artifact Artifact, opts DownloadOptions) (*DownloadedArtifact, error)
	GetLatestVersion(ctx context.Context, artifactType ArtifactType) (string, error)
	GetVersionMetadata(ctx context.Context, version string) (*Metadata, error)
}

type HealthCheckOptions struct {
	// ServiceName is the systemd service name
	ServiceName string
	// HealthEndpoint is the HTTP health check endpoint
	HealthEndpoint string
	// MaxRetries is the maximum number of health check retries
	MaxRetries int
	// RetryDelay is the delay between retries
	RetryDelay time.Duration
}

type HealthVerifier interface {
	VerifyHealth(ctx context.Context, timeout time.Duration) error
}

type InstallOptions struct {
	// InstallPath is where to install the binary
	InstallPath string
	// BackupSuffix is the suffix for backup files
	BackupSuffix string
}

type Installer interface {
	Install(ctx context.Context, downloaded *DownloadedArtifact) error
	Backup(ctx context.Context) error
	Rollback(ctx context.Context) error
	GetCurrentVersion(ctx context.Context) (VersionInfo, error)
	HasBackup() bool
}

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

type ManagerOptions struct {
	// InstallPath is where to install binaries
	InstallPath string
	// TempDir is where to store temporary files
	TempDir string
	// ServiceName is the systemd service name
	ServiceName string
	// HealthTimeout is the timeout for health checks
	HealthTimeout time.Duration
	// SkipHealthCheck skips post-upgrade health verification
	SkipHealthCheck bool
	// AutoRollback enables automatic rollback on health check failure
	AutoRollback bool
}

type Metadata struct {
	Version   string         `json:"version"`    // Version string (e.g., "main:abc123")
	Commit    string         `json:"commit"`     // Full commit SHA
	Branch    string         `json:"branch"`     // Branch name
	BuildDate time.Time      `json:"build_date"` // Build timestamp
	Artifacts []ArtifactInfo `json:"artifacts"`  // List of available artifacts
}

type NoOpHealthVerifier struct{}

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

type SemVer struct {
	Major      int
	Minor      int
	Patch      int
	Prerelease string // e.g., "test.1", "rc.1"
	Original   string // Original version string
}

type VersionInfo struct {
	Version   string    `json:"version"`
	Commit    string    `json:"commit"`
	BuildDate time.Time `json:"build_date"`
}