/*
Backend Interface - Container runtime abstraction for Volt CLI.

All container backends (systemd-nspawn, proot, etc.) implement this interface
to provide a uniform API for the CLI command layer.
*/
package backend

import "time"

// ContainerInfo holds metadata about a container.
type ContainerInfo struct {
	Name      string
	Image     string
	Status    string // created, running, stopped
	PID       int
	RootFS    string
	Memory    string
	CPU       int
	CreatedAt time.Time
	StartedAt time.Time
	IPAddress string
	OS        string
}

// CreateOptions specifies parameters for container creation.
type CreateOptions struct {
	Name    string
	Image   string
	RootFS  string
	Memory  string
	CPU     int
	Network string
	Start   bool
	Env     []string
	Ports   []PortMapping
	Volumes []VolumeMount
}

// PortMapping maps a host port to a container port.
type PortMapping struct {
	HostPort      int
	ContainerPort int
	Protocol      string // tcp, udp
}

// VolumeMount binds a host path into a container.
type VolumeMount struct {
	HostPath      string
	ContainerPath string
	ReadOnly      bool
}

// ExecOptions specifies parameters for executing a command in a container.
type ExecOptions struct {
	Command []string
	TTY     bool
	Env     []string
}

// LogOptions specifies parameters for retrieving container logs.
type LogOptions struct {
	Tail   int
	Follow bool
}

// ContainerBackend defines the interface that all container runtimes must implement.
type ContainerBackend interface {
	// Name returns the backend name (e.g., "systemd", "proot")
	Name() string

	// Available returns true if this backend can run on the current system
	Available() bool

	// Init initializes the backend
	Init(dataDir string) error

	// Container lifecycle
	Create(opts CreateOptions) error
	Start(name string) error
	Stop(name string) error
	Delete(name string, force bool) error

	// Container interaction
	Exec(name string, opts ExecOptions) error
	Logs(name string, opts LogOptions) (string, error)
	CopyToContainer(name string, src string, dst string) error
	CopyFromContainer(name string, src string, dst string) error

	// Container info
	List() ([]ContainerInfo, error)
	Inspect(name string) (*ContainerInfo, error)

	// Platform capabilities
	SupportsVMs() bool
	SupportsServices() bool
	SupportsNetworking() bool
	SupportsTuning() bool
}