config

type CLIConfig struct {
	// Pointer so an unset key is distinguishable from an explicit false.
	CheckForUpdateOnStartup *bool `mapstructure:"check_for_update_on_startup"`
}

type Config struct {
	Containers []ContainerConfig            `mapstructure:"containers"`
	Env        map[string]map[string]string `mapstructure:"env"`
	CLI        CLIConfig                    `mapstructure:"cli"`
}

type ContainerConfig struct {
	Type EmulatorType `mapstructure:"type"`
	Tag  string       `mapstructure:"tag"`
	Port string       `mapstructure:"port"`
	// CustomImage overrides the default Docker image for this emulator. Set it to use an
	// image from an internal registry or a locally loaded offline image instead of pulling
	// the default localstack image from Docker Hub. If it carries no tag, Tag (or "latest")
	// is appended; if it already carries a tag, Tag is dropped.
	CustomImage string `mapstructure:"image"`
	// CustomName overrides the derived container name (see Name). It is also exported into
	// the container as MAIN_CONTAINER_NAME, which the emulator uses to introspect itself over
	// the Docker socket and to name the containers it spawns (e.g. Lambda, as
	// <main-container-name>-lambda-<fn>-<id>). Set it when something outside lstk has to
	// address the emulator by a fixed name, such as a sidecar proxy on a CI agent.
	//
	// The key is container_name rather than a bare name because the block already carries an
	// image and a type name, against which an unqualified name reads ambiguously; the field is
	// CustomName because Name is already a method (the same pairing as CustomImage/Image).
	CustomName string `mapstructure:"container_name"`
	// Volume is the legacy single-host-directory knob for the persistence mount
	// (target /var/lib/localstack). It is still honored; new configs can express the
	// same mount as a Volumes entry targeting persistenceTarget instead.
	Volume string `mapstructure:"volume"`
	// Volumes is the umbrella list of "host:container[:ro]" bind specs. It covers
	// arbitrary mounts (e.g. Snowflake init hooks) and may also contain the persistence
	// mount (the entry targeting /var/lib/localstack).
	Volumes []string `mapstructure:"volumes"`
	// ExposePorts publishes additional container ports on the host, beyond the gateway
	// and service ports lstk publishes by default — e.g. port 53 so the emulator's DNS
	// server can be used as the host's resolver. Each entry is a bare port number
	// (published on the same host port) or a Docker-style "[host:]container[/proto]"
	// string. See ExposedPorts for the protocol rules.
	//
	// This replaces the v1 CLI's --host-dns flag; there is deliberately no CLI flag, since
	// every consumer of the value is the start path. TOML integers are accepted alongside
	// strings (expose_ports = [53, "5354:5353/udp"]) because viper's decoder is
	// WeaklyTypedInput.
	ExposePorts []string `mapstructure:"expose_ports"`
	// Env is a list of named environment references defined in the top-level [env.*] config sections.
	Env []string `mapstructure:"env"`
	// Snapshot is an optional snapshot REF (e.g. "pod:my-baseline" or a local path)
	// auto-loaded after the emulator starts. AWS emulator only. Never written by lstk:
	// `snapshot save` does not persist its destination here.
	Snapshot string `mapstructure:"snapshot"`
}

type EmulatorType string

type PortSpec struct {
	HostPort      string
	ContainerPort string
	Protocol      string // "tcp" or "udp"
}

type VolumeMount struct {
	Source   string
	Target   string
	ReadOnly bool
}