compose

type Command []string

type DependsOn []string

type Deploy struct {
	Resources struct {
		Reservations struct {
			Devices []Device `yaml:"devices"`
		} `yaml:"reservations"`
	} `yaml:"resources"`
	// Replicas maps onto the same store.DesiredService.Replicas /
	// spec.Service.Replicas field a service's own top-level replicas:
	// (app.yaml) already resolves through. Zero means unset.
	Replicas int `yaml:"replicas"`
	// contains filtered or unexported fields
}

type Device struct {
	Driver       string           `yaml:"driver"`
	Count        yamlScalarString `yaml:"count"`
	DeviceIDs    []string         `yaml:"device_ids"`
	Capabilities []string         `yaml:"capabilities"`
}

type Environment map[string]string

type File struct {
	Version  string
	Services map[string]Service
	// Domains maps a service key to the real domain it should be
	// reachable at, from the top-level x-levelrail-domains extension
	// (Compose's own reserved x- prefix for tool-specific keys). Used
	// both to set that service's own store.DesiredService.Domains (real
	// ingress routing) and to resolve any ${SERVICE_FQDN_*} reference
	// within that same service's environment (ResolveMagicVars).
	Domains map[string]string
	// Networks lists this file's own top-level networks: names, sorted.
	// Only used by Notices to detect that custom networks were declared
	// at all; Levelrail doesn't create per-network isolation from this.
	Networks []string
	// HasSecrets/HasConfigs record whether this file declares a top-level
	// secrets: or configs: block: neither has a translation onto this
	// platform's own env-var/Levelrail-secrets model, so validate rejects
	// either outright (unlike restart:/networks:/depends_on:, which parse
	// and are merely non-blocking Notices) rather than silently dropping
	// values an operator would reasonably expect to reach a container.
	HasSecrets bool
	HasConfigs bool
}

type Healthcheck struct {
	Test        healthcheckTest `yaml:"test"`
	Interval    string          `yaml:"interval"`
	Timeout     string          `yaml:"timeout"`
	Retries     int             `yaml:"retries"`
	StartPeriod string          `yaml:"start_period"`
}

type HostAccess struct {
	Privileged  bool     `yaml:"privileged"`
	NetworkMode string   `yaml:"network_mode"`
	Pid         string   `yaml:"pid"`
	Ipc         string   `yaml:"ipc"`
	Uts         string   `yaml:"uts"`
	UsernsMode  string   `yaml:"userns_mode"`
	Cgroup      string   `yaml:"cgroup"`
	CapAdd      []string `yaml:"cap_add"`
	Devices     []any    `yaml:"devices"`
	SecurityOpt []string `yaml:"security_opt"`
	VolumesFrom []string `yaml:"volumes_from"`
}

type MagicVar struct {
	Token       string
	Kind        string
	Key         string
	Length      int
	Default     string
	HasDefault  bool
	Generatable bool
}

type Networks []string

type Notice struct {
	Level   NoticeLevel
	Message string
}

type NoticeLevel string

type Port struct {
	HostPort      int
	ContainerPort int
}

type Service struct {
	Image       string
	Build       *rawBuild
	Environment Environment
	Ports       []Port
	Volumes     []Volume
	Labels      map[string]string
	Networks    Networks
	Restart     string
	Healthcheck *Healthcheck
	// DependsOn is depends_on:, enforced by the reconciler as a start-
	// order guarantee (see this file's own doc comment and Notices).
	DependsOn DependsOn
	// Command overrides the image's own default CMD
	// (store.DesiredService.Command), parsed from command:'s own
	// string-or-list union (Command's own UnmarshalYAML in yaml.go): a
	// plain string is shell-wrapped as ["/bin/sh", "-c", "<string>"],
	// matching Compose's own documented behavior for that form.
	Command Command
	// Entrypoint overrides the image's own default ENTRYPOINT
	// (store.DesiredService.Entrypoint), parsed with the same
	// string-or-list union as Command.
	Entrypoint Command
	// PullPolicy is pull_policy:, normalized by normalizePullPolicy into
	// exactly the two states store.DesiredService.PullPolicy
	// distinguishes: PullPolicyAlways forces a fresh pull even when the
	// image is already present locally, empty means today's existing
	// pull-if-absent behavior. Real Compose's other recognized spellings
	// ("missing", "if_not_present", an unset field) all normalize to
	// empty too; "never" and "build" are rejected, see
	// normalizePullPolicy.
	PullPolicy string
	// Deploy carries the GPU device reservation and replicas count
	// (gpu.go).
	Deploy *Deploy
	// Secrets/Configs are this service's own secrets:/configs: references
	// (short string form or long {source, target,...} map form, either
	// decodes fine into []any since only their presence matters here),
	// the per-service counterpart to File.HasSecrets/HasConfigs; same
	// rejection reasoning, see validateComposeServices.
	Secrets []any
	Configs []any
	// Profiles gates the service behind compose profiles (ApplyProfiles).
	Profiles   []string
	HostAccess HostAccess
	// DependsOnHealthy lists the DependsOn entries declared with
	// condition: service_healthy, which wait for readiness, not just start.
	DependsOnHealthy []string
}

type UnresolvedVar struct {
	Service string
	EnvKey  string
	Token   string
}

type Volume struct {
	Name          string
	HostPath      string
	ContainerPath string
	// ReadOnly mounts read-only inside the container, from an optional
	// trailing ":ro" on the short-form entry.
	ReadOnly bool
}