toml

type Config struct {
	Organization string        `toml:"organization" json:"organization"`
	Project      string        `toml:"project"      json:"project"`
	Shards       []Shard       `toml:"shards"       json:"shards"`
	Services     []GameService `toml:"services"     json:"services"`
}

type GameService struct {
	ID          string            `toml:"id"                    json:"id"`
	Image       string            `toml:"image,omitempty"       json:"image,omitempty"`
	Path        string            `toml:"path,omitempty"        json:"path,omitempty"`
	Env         map[string]string `toml:"env,omitempty"         json:"env,omitempty"`
	Ports       []int             `toml:"ports,omitempty"       json:"ports,omitempty"`       // host port == container port
	Volume      string            `toml:"volume,omitempty"      json:"volume,omitempty"`      // container mount path for a named volume
	Healthcheck []string          `toml:"healthcheck,omitempty" json:"healthcheck,omitempty"` // docker healthcheck Test array

	// ConfigDB marks the config database shards read game config from; the docker
	// backend derives DB_DSN from it and injects it into every shard's env.
	ConfigDB bool `toml:"config_db,omitempty" json:"config_db,omitempty"`

	// DB opts this source-built service into the project database (one DB per
	// project, shared by all shards and services). The docker backend
	// auto-provisions a single "{project}-db" Postgres (unless a config_db service
	// already provides one) and injects its DSN as DB_DSN. An explicit env wins.
	DB bool `toml:"db,omitempty" json:"db,omitempty"`
}

type Shard struct {
	ID         string `toml:"id"                    json:"id"`
	LogLevel   string `toml:"log_level,omitempty"   json:"logLevel,omitempty"`
	EnableOTEL bool   `toml:"enable_otel,omitempty" json:"enableOtel,omitempty"`
	Path       string `toml:"path,omitempty"        json:"path,omitempty"`
	PoolSize   int    `toml:"pool_size,omitempty"   json:"poolSize,omitempty"`

	// TickRate is the game-loop frequency in Hz. Optional; k8s backend only.
	TickRate int32 `toml:"tick_rate,omitempty" json:"tickRate,omitempty"`

	// Mode is the shard mode (e.g. "LEADER"). Optional; k8s backend only.
	Mode string `toml:"mode,omitempty" json:"mode,omitempty"`

	// Resources is the per-instance CPU + memory request/limit pair.
	// Optional; k8s backend only. Nil means "use translator default."
	Resources *ShardResources `toml:"resources,omitempty" json:"resources,omitempty"`

	// InstanceID is the runtime shard instance ID after pool expansion. Pooled
	// replicas keep ID as the logical world.toml shard ID and get suffixed
	// InstanceIDs such as "game-2". Set during validation, not part of the schema.
	InstanceID string `toml:"-" json:"-"`
}

type ShardResourceValues struct {
	CPU    int32 `toml:"cpu"    json:"cpu"`
	Memory int32 `toml:"memory" json:"memory"`
}

type ShardResources struct {
	Requests ShardResourceValues `toml:"requests" json:"requests"`
	Limits   ShardResourceValues `toml:"limits"   json:"limits"`
}