compose

type BuildOptions struct {
	// Services limits build to the selected services. Empty means all services.
	Services []string
	// Output receives streaming build output.
	Output io.Writer
}

type ClientOption func(*ComposeClient) error

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

type DownOptions struct {
	// Services selects services and their transitive dependents for teardown.
	// Empty means all services.
	Services []string
	// RemoveOrphans also removes project containers whose service is no longer
	// declared in the current Compose file.
	RemoveOrphans bool
	// Force forces container deletion when supported by the runtime.
	Force bool
	// Volumes removes eligible ACC-owned named and anonymous volumes. With
	// Services set, only volumes attached to containers removed by this invocation
	// are eligible, and volumes referenced by any remaining container are retained.
	// Without Services, detached project-owned named volumes are also eligible.
	Volumes bool
	// OnWarning receives non-fatal warnings. The SDK never renders warnings
	// itself; callers decide whether and how to present them.
	OnWarning func(string)
}

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

type LogsOptions struct {
	// Services limits logs to selected services. Empty means all services.
	Services []string
	// Follow keeps streaming logs until the context is cancelled or the process exits.
	Follow bool
	// Output receives the service logs.
	Output io.Writer
}

type ParseOptions struct {
	// WorkingDir is used for resolving relative paths and environment files.
	// Defaults to the compose file's directory when empty. It does not change
	// the default project name.
	WorkingDir string
	// ProjectName overrides the Compose project name. When empty, the top-level
	// Compose name is used when present; otherwise the compose file's parent
	// directory name is used.
	ProjectName string
	// Environment provides additional variables used during interpolation.
	Environment map[string]string
	// EnvFiles contains explicit environment files used during interpolation.
	// Files are loaded in the order provided.
	EnvFiles []string
	// DisableOSEnvironment prevents process environment variables from being
	// used during interpolation.
	DisableOSEnvironment bool
	// DisableDotEnv prevents the default .env file from being loaded.
	// Explicit EnvFiles are still honored.
	DisableDotEnv bool
}

type ServiceNetworkRuntime struct {
	// Name is the Compose-resolved runtime network name.
	Name string
	// Addresses contains assigned IP addresses without CIDR prefixes.
	Addresses []netip.Addr
	// Aliases contains aliases declared for this service on this network.
	Aliases []string
}

type ServiceRegistry interface {
	// Ensure prepares the registry before Compose mutates runtime resources.
	Ensure(context.Context) error
	// Upsert records a service after its container has been started and inspected.
	// Its errors are reported as warnings because the runtime has already changed.
	Upsert(context.Context, ServiceRuntime) error
	// Remove deletes records after the corresponding containers are removed. Its
	// errors are reported as warnings and do not interrupt runtime cleanup.
	Remove(context.Context, []string) error
}

type ServiceRuntime struct {
	// ProjectName is the resolved Compose project name.
	ProjectName string
	// ServiceName is the service's key in the Compose project.
	ServiceName string
	// ContainerID is the runtime container identifier.
	ContainerID string
	// Nameservers contains the service's resolved Compose dns values.
	Nameservers []string
	// Networks contains the container's inspected network attachments.
	Networks []ServiceNetworkRuntime
}

type ServiceStartOptions struct {
	// DNSByNetwork maps runtime network names to DNS server addresses. Every
	// network used by a service must have an entry when this is set.
	// With no entries, Compose dns values are passed directly to the runtime.
	DNSByNetwork map[string]netip.Addr
}

type UpOptions struct {
	// Services limits startup to the selected services. Empty means all services.
	Services []string
	// Build forces all buildable services to build before any containers start.
	// Without it, a buildable service is built only when its local image is absent.
	Build bool
	// RenewAnonymousVolumes creates fresh anonymous volumes when existing
	// service containers are recreated instead of reusing volumes by target.
	RenewAnonymousVolumes bool
	// RemoveOrphans removes ACC-owned containers for services that are no
	// longer declared by the loaded Compose project.
	RemoveOrphans bool
	// Output receives attached service logs and is the fallback for build and
	// runtime output.
	Output io.Writer
	// BuildOutput receives build output. When nil, Output is used.
	BuildOutput io.Writer
	// RuntimeOutput receives startup output, including automatic image-pull
	// progress, even when Attach is false. When nil, Output is used.
	RuntimeOutput io.Writer
	// Attach streams service logs until detached or context cancellation.
	Attach bool
	// Detach, when non-nil, detaches attached log streaming when signaled.
	// Canceling the context also detaches.
	Detach <-chan struct{}
	// OnWarning receives non-fatal Compose warnings. The SDK never renders
	// warnings itself; callers decide whether and how to present them.
	OnWarning func(string)
	// OnFatalWarning receives a diagnostic immediately before Up returns an
	// error for an unsupported Compose feature. The SDK never renders
	// diagnostics itself; callers decide whether and how to present them.
	OnFatalWarning func(string)
}

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