// Package in defines input ports (interfaces) for use cases.
// These interfaces define the contract between driving adapters (HTTP, CLI)
// and the business logic (use cases).
package in

import (
	"context"

	"github.com/bnema/gordon/internal/domain"
)

// ContainerService defines the contract for container management operations.
type ContainerService interface {
	// Deploy creates and starts a container for the given route.
	Deploy(ctx context.Context, route domain.Route) (*domain.Container, error)

	// Stop stops a running container.
	Stop(ctx context.Context, containerID string) error

	// Remove removes a container, optionally forcing removal.
	Remove(ctx context.Context, containerID string, force bool) error

	// Get retrieves a container by domain name.
	Get(ctx context.Context, domain string) (*domain.Container, bool)

	// List returns all managed containers.
	List(ctx context.Context) map[string]*domain.Container

	// ListRoutesWithDetails returns routes with network and attachment info.
	ListRoutesWithDetails(ctx context.Context) []domain.RouteInfo

	// ListAttachments returns attachments for a domain.
	ListAttachments(ctx context.Context, domain string) []domain.Attachment

	// ListNetworks returns Gordon-managed networks.
	ListNetworks(ctx context.Context) ([]*domain.NetworkInfo, error)

	// HealthCheck performs health checks on all containers.
	HealthCheck(ctx context.Context) map[string]bool

	// SyncContainers synchronizes containers with configured routes.
	SyncContainers(ctx context.Context) error

	// AutoStart starts containers for the provided routes that aren't running.
	AutoStart(ctx context.Context, routes []domain.Route) error

	// Shutdown gracefully shuts down all managed containers.
	Shutdown(ctx context.Context) error
}