provider

type AvailableProvider interface {
	NodeLister
	// IsAvailable returns true if the provider is ready for use.
	IsAvailable() bool
}

type ClusterStatus struct {
	// Phase is the high-level lifecycle phase (e.g., "running", "RUNNING", "initializing").
	Phase string

	// Ready indicates whether the cluster is considered healthy by the provider.
	Ready bool

	// NodesTotal is the total number of nodes (machines, servers, containers) in the cluster.
	NodesTotal int

	// NodesReady is the number of nodes that are in a healthy/ready state.
	NodesReady int

	// Nodes lists individual node details.
	Nodes []NodeInfo

	// Endpoint is the provider API endpoint URL (populated by cloud providers like Omni).
	Endpoint string
}

type MockProvider struct {
	mock.Mock
}

type NodeInfo struct {
	// Name is the unique identifier of the node (container name, VM ID, etc.)
	Name string

	// ClusterName is the name of the cluster this node belongs to.
	ClusterName string

	// Role is the role of the node (control-plane, worker).
	Role string

	// State is the current state of the node (running, stopped, etc.)
	State string
}

type NodeLister interface {
	ListNodes(ctx context.Context, clusterName string) ([]NodeInfo, error)
}

type Provider interface {
	// StartNodes starts the nodes for a cluster.
	// If no nodes exist, returns ErrNoNodes.
	StartNodes(ctx context.Context, clusterName string) error

	// StopNodes stops the nodes for a cluster.
	// If no nodes exist, returns ErrNoNodes.
	StopNodes(ctx context.Context, clusterName string) error

	// ListNodes returns all nodes for a specific cluster.
	ListNodes(ctx context.Context, clusterName string) ([]NodeInfo, error)

	// ListAllClusters returns the names of all clusters managed by this provider.
	ListAllClusters(ctx context.Context) ([]string, error)

	// NodesExist returns true if nodes exist for the given cluster name.
	NodesExist(ctx context.Context, clusterName string) (bool, error)

	// DeleteNodes removes all nodes for a cluster.
	// Note: Most provisioners handle node deletion through their SDK,
	// so this is primarily used for cleanup scenarios.
	DeleteNodes(ctx context.Context, clusterName string) error

	// GetClusterStatus returns the provider-level status of a cluster.
	// Returns nil and no error if the cluster does not exist in the provider.
	GetClusterStatus(ctx context.Context, clusterName string) (*ClusterStatus, error)
}