packages

type ComponentDef struct {
	// Version of this specific component
	Version string `yaml:"version"`

	// File is the relative path to the firmware file within the firmware directory
	File string `yaml:"file"`

	// Checksum for integrity verification (optional, format: "sha256:abc123...")
	Checksum string `yaml:"checksum,omitempty"`

	// Strategy specifies how this component is updated: "redfish", "ssh", or "script"
	Strategy string `yaml:"strategy"`

	// Script is the path to the update script (required when strategy is "script")
	// Can be absolute or relative to the scripts directory
	Script string `yaml:"script,omitempty"`

	// ScriptArgs specifies which arguments to pass to the script (when strategy is "script")
	// Each item is a token that resolves to a value at runtime.
	// Valid tokens:
	//   - bmc_ip, bmc_user, bmc_password
	//   - nvos_ip, nvos_user, nvos_password
	//   - fw_file (path to firmware file)
	// Example: [nvos_ip, nvos_user, nvos_password, fw_file]
	ScriptArgs []string `yaml:"script_args,omitempty"`
}

type FirmwarePackage struct {
	// Version is the unique identifier for this bundle (e.g., "1.0.0", "2024.01.15")
	Version string `yaml:"version"`

	// Description provides human-readable info about this bundle
	Description string `yaml:"description,omitempty"`

	// ComponentOrder defines the update sequence for components in this bundle.
	// Components are updated in the order listed. If not specified, uses DefaultComponentOrder.
	// e.g., ["bmc", "cpld", "bios", "nvos"]
	ComponentOrder []string `yaml:"component_order,omitempty"`

	// Components maps component name (lowercase) to its definition
	// e.g., "bmc", "cpld", "bios", "nvos"
	Components map[string]ComponentDef `yaml:"components"`

	// StrategyConfig contains configuration for each update strategy
	StrategyConfig StrategyConfig `yaml:"strategy_config,omitempty"`
}

type RedfishConfig struct {
	// PollIntervalSeconds is how often to poll task status
	PollIntervalSeconds int `yaml:"poll_interval_seconds,omitempty"`

	// PollTimeoutSeconds is max time to wait for task completion
	PollTimeoutSeconds int `yaml:"poll_timeout_seconds,omitempty"`
}

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

type SSHConfig struct {
	// RemoteDir is the directory on the switch where files are copied
	RemoteDir string `yaml:"remote_dir,omitempty"`

	// RebootTimeoutSeconds is how long to wait for reboot (NVOS updates)
	RebootTimeoutSeconds int `yaml:"reboot_timeout_seconds,omitempty"`
}

type ScriptConfig struct {
	// ScriptDir is the directory containing update scripts
	ScriptDir string `yaml:"script_dir"`

	// Timeout for script execution in seconds
	TimeoutSeconds int `yaml:"timeout_seconds,omitempty"`
}

type StrategyConfig struct {
	Script  *ScriptConfig  `yaml:"script,omitempty"`
	SSH     *SSHConfig     `yaml:"ssh,omitempty"`
	Redfish *RedfishConfig `yaml:"redfish,omitempty"`
}

type ValidationError struct {
	Field   string
	Message string
}