docker

type BackgroundProcess struct {
	Name    string
	Running bool
}

type DiscoveredService struct {
	Name     string
	URL      string
	Username string
	Password string
}

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

type Link struct {
	Label string
	URL   string
}

type Options struct {
	// PHP configures the docker-dev image and its profiler.
	PHP PHP
	// Services are the per-service settings from docker.services.
	Services Settings
	// Proxy, when set, serves the project through the shared proxy: routed
	// services publish no host ports and instead join the proxy network with
	// Traefik routing labels. Nil keeps fixed-port mode.
	Proxy *Proxy
	// User is the "uid:gid" the PHP containers run as so that writes to the
	// bind-mounted project are owned by the host user. Empty resolves the
	// host user of the project folder.
	User string
}

type PHP struct {
	// Version is the PHP version (e.g. "8.3"); empty means the default.
	Version string
	// Profiler is one of the Profiler* names; empty means none.
	Profiler             string
	BlackfireServerID    string
	BlackfireServerToken string
	TidewaysAPIKey       string
}

type Port int

type PortConflict struct {
	// Service is the compose service publishing the port.
	Service string
	// Endpoint is the ports key of the busy endpoint.
	Endpoint string
	// Label is the human-readable name of the endpoint.
	Label string
	// HostPort is the effective (configured or default) port that is busy.
	HostPort int
}

type PortOverride struct {
	Service  string
	Endpoint string
	HostPort int
}

type Ports map[string]Port

type Proxy struct {
	// Hostname is the project's resolved root hostname, e.g.
	// "my-shop.shopware.local". Every other route is a subdomain of it (e.g.
	// "admin-watch.my-shop.shopware.local").
	Hostname string
	// NetworkName is the external Docker network shared with Traefik.
	NetworkName string
	// CABundlePath is the host path of a CA bundle that combines the image's
	// system CAs with the proxy's root CA. When set, it is mounted read-only
	// over the container's system trust store so everything there — PHP, curl
	// (e.g. Shopware's own APP_URL reachability self-call) and Node — trusts the
	// proxy's HTTPS certificates while still trusting the public internet.
	// Mounting the bare CA under /usr/local/share/ca-certificates is not enough:
	// the image runs as www-data and never runs update-ca-certificates.
	CABundlePath string
	// AdminWatchPort is the container port the admin watcher's dev server binds:
	// Vite (5173) on Shopware 6.7+, webpack-dev-server (8080) before, decided by
	// the ADMIN_VITE feature flag. The caller computes it (via
	// extension.AdminDevServerPort) and passes it in, so this package needs no
	// Shopware-version logic of its own.
	AdminWatchPort int
}

type RunningEnvironment struct {
	// Services are the auxiliary services reachable from the host.
	Services []DiscoveredService
	// Background are the long-running console processes.
	Background []BackgroundProcess
	// WebPort is the host port the shop is published on, 0 when it cannot be
	// determined (environment down, web container not publishing).
	WebPort int
}

type ServiceSettings struct {
	// Implementation to run, for services that offer more than one (database: mariadb or mysql, queue: lavinmq or rabbitmq).
	Type string `yaml:"type,omitempty"`
	// Image version (tag) to run. Defaults per implementation.
	Version string `yaml:"version,omitempty"`
	// Host ports the service's endpoints are published on, keyed by endpoint name. false disables publishing an endpoint.
	Ports Ports `yaml:"ports,omitempty"`
}

type Settings map[string]*ServiceSettings