config

type Auth struct {
	OperatorKey string `yaml:"operator_key" env:"WH_AUTH_OPERATOR_KEY"`
}

type Cache struct {
	Backend   CacheBackend     `yaml:"backend" env:"WH_CACHE_BACKEND"`
	L1MaxCost int64            `yaml:"l1_max_cost" env:"WH_CACHE_L1_MAX_COST"`
	Redis     CacheRedisConfig `yaml:"redis"`
}

type CacheBackend string

type CacheRedisConfig struct {
	// Addrs are host:port pairs: the server, or seeds for a cluster.
	Addrs    []string      `yaml:"addrs" env:"WH_CACHE_REDIS_ADDRS"`
	Mode     string        `yaml:"mode" env:"WH_CACHE_REDIS_MODE"`
	Username string        `yaml:"username" env:"WH_CACHE_REDIS_USERNAME"`
	Password string        `yaml:"password" env:"WH_CACHE_REDIS_PASSWORD"`
	DB       int           `yaml:"db" env:"WH_CACHE_REDIS_DB"`
	TLS      CacheRedisTLS `yaml:"tls"`
	// KeyPrefix leads every key, so deployments can share one server.
	KeyPrefix   string        `yaml:"key_prefix" env:"WH_CACHE_REDIS_KEY_PREFIX"`
	Timeout     time.Duration `yaml:"timeout" env:"WH_CACHE_REDIS_TIMEOUT"`
	DialTimeout time.Duration `yaml:"dial_timeout" env:"WH_CACHE_REDIS_DIAL_TIMEOUT"`
	// MaxValueBytes is the largest value stored, after compression.
	MaxValueBytes int `yaml:"max_value_bytes" env:"WH_CACHE_REDIS_MAX_VALUE_BYTES"`
	// CompressMinBytes is the smallest value zstd-compressed; 0 never
	// compresses.
	CompressMinBytes int `yaml:"compress_min_bytes" env:"WH_CACHE_REDIS_COMPRESS_MIN_BYTES"`
	// VersionTTL is how long a version token outlives its last bump.
	VersionTTL time.Duration `yaml:"version_ttl" env:"WH_CACHE_REDIS_VERSION_TTL"`
}

type CacheRedisTLS struct {
	Enabled            bool   `yaml:"enabled" env:"WH_CACHE_REDIS_TLS_ENABLED"`
	CAFile             string `yaml:"ca_file" env:"WH_CACHE_REDIS_TLS_CA_FILE"`
	CertFile           string `yaml:"cert_file" env:"WH_CACHE_REDIS_TLS_CERT_FILE"`
	KeyFile            string `yaml:"key_file" env:"WH_CACHE_REDIS_TLS_KEY_FILE"`
	ServerName         string `yaml:"server_name" env:"WH_CACHE_REDIS_TLS_SERVER_NAME"`
	InsecureSkipVerify bool   `yaml:"insecure_skip_verify" env:"WH_CACHE_REDIS_TLS_INSECURE_SKIP_VERIFY"`
}

type ClickHouse struct {
	// MaxTotalConns caps the native connections the process may hold open
	// across its pools: the settings directory's clickhouse.max_open_conns
	// must not exceed it. 0, the default, is no ceiling.
	MaxTotalConns int `yaml:"max_total_conns" env:"WH_CH_MAX_TOTAL_CONNS"`
}

type Config struct {
	// DataDir is the root for embedded state. NATS JetStream lives at
	// `<DataDir>/nats`; Pebble, holding every tenant's dedupe store while any
	// tenant has dedupe enabled, at `<DataDir>/pebble`.
	// Subdirectory names are conventions, not config — one knob, one mount.
	// In a container this MUST resolve to a host-backed volume; the relative
	// `./data` default is fine for local binary use only.
	DataDir string `yaml:"data_dir" env:"WH_DATA_DIR"`
	// Roles are the components this process runs (every role by default);
	// a Deployment per role differs only in this. See Role.
	Roles []Role `yaml:"roles" env:"WH_ROLES"`
	// InstanceID names this process: logged at boot, and the holder a
	// coord.backend=nats lease names. Empty resolves to <hostname>-<8 hex> at
	// Load.
	InstanceID string     `yaml:"instance_id" env:"WH_INSTANCE_ID"`
	Server     Server     `yaml:"server"`
	ClickHouse ClickHouse `yaml:"clickhouse"`
	MQ         MQ         `yaml:"mq"`
	Cache      Cache      `yaml:"cache"`
	Dedupe     Dedupe     `yaml:"dedupe"`
	Coord      Coord      `yaml:"coord"`
	Auth       Auth       `yaml:"auth"`
	OTel       OTel       `yaml:"otel"`
	Prometheus Prometheus `yaml:"prometheus"`
	Settings   Settings   `yaml:"settings"`
}

type Coord struct {
	Backend CoordBackend `yaml:"backend" env:"WH_COORD_BACKEND"`
	// NATS is read only when Backend is nats.
	NATS CoordNATSConfig `yaml:"nats"`
}

type CoordBackend string

type CoordNATSConfig struct {
	// Bucket is the KV bucket the leases live in; empty is
	// <mq.nats.subject_prefix>_coord, the name the generated manifests give it.
	Bucket string `yaml:"bucket" env:"WH_COORD_NATS_BUCKET"`
}

type Dedupe struct {
	Backend DedupeBackend `yaml:"backend" env:"WH_DEDUPE_BACKEND"`
	// Lease is how long a claimed id stays pending while its record is
	// published; a claim its request never settles lapses after it.
	Lease time.Duration `yaml:"lease" env:"WH_DEDUPE_LEASE"`
	// ReserveConcurrency bounds the parallel calls one Reserve, Commit or
	// Release makes to a remote backend, and sizes its idle connection pool
	// to match. Pebble ignores it.
	ReserveConcurrency int                  `yaml:"reserve_concurrency" env:"WH_DEDUPE_RESERVE_CONCURRENCY"`
	DynamoDB           DedupeDynamoDBConfig `yaml:"dynamodb"`
}

type DedupeBackend string

type DedupeDynamoDBConfig struct {
	// Table is the shared table; WaveHouse never creates it outside
	// dynamodb-local. Required.
	Table string `yaml:"table" env:"WH_DEDUPE_DYNAMODB_TABLE"`
	// Region overrides the SDK chain's (AWS_REGION).
	Region string `yaml:"region" env:"WH_DEDUPE_DYNAMODB_REGION"`
	// Endpoint points the client at dynamodb-local.
	Endpoint    string        `yaml:"endpoint" env:"WH_DEDUPE_DYNAMODB_ENDPOINT"`
	Timeout     time.Duration `yaml:"timeout" env:"WH_DEDUPE_DYNAMODB_TIMEOUT"`
	MaxAttempts int           `yaml:"max_attempts" env:"WH_DEDUPE_DYNAMODB_MAX_ATTEMPTS"`
	RetryMode   string        `yaml:"retry_mode" env:"WH_DEDUPE_DYNAMODB_RETRY_MODE"`
	// CreateTable creates the table at boot if it is missing. Development
	// only: refused unless Endpoint is set.
	CreateTable bool `yaml:"create_table" env:"WH_DEDUPE_DYNAMODB_CREATE_TABLE"`
}

type MQ struct {
	Backend MQBackend `yaml:"backend" env:"WH_MQ_BACKEND"`
	// NATS is read only when Backend is nats.
	NATS MQNATSConfig `yaml:"nats"`
}

type MQBackend string

type MQNATSConfig struct {
	URLs []string `yaml:"urls" env:"WH_MQ_NATS_URLS"`
	// Name is the connection name the server reports; empty is
	// wavehouse-<hostname>.
	Name string `yaml:"name" env:"WH_MQ_NATS_NAME"`
	// CredsFile, NKeySeedFile and User are exclusive: one way to
	// authenticate, or none.
	CredsFile    string    `yaml:"creds_file" env:"WH_MQ_NATS_CREDS_FILE"`
	NKeySeedFile string    `yaml:"nkey_seed_file" env:"WH_MQ_NATS_NKEY_SEED_FILE"`
	User         string    `yaml:"user" env:"WH_MQ_NATS_USER"`
	PasswordFile string    `yaml:"password_file" env:"WH_MQ_NATS_PASSWORD_FILE"`
	TLS          MQNATSTLS `yaml:"tls"`
	// JSDomain is the JetStream domain, for a leafnode or hub-and-spoke
	// deployment.
	JSDomain      string `yaml:"js_domain" env:"WH_MQ_NATS_JS_DOMAIN"`
	SubjectPrefix string `yaml:"subject_prefix" env:"WH_MQ_NATS_SUBJECT_PREFIX"`
	Partitions    int    `yaml:"partitions" env:"WH_MQ_NATS_PARTITIONS"`
	// Shards is how many shards each partition has, one durable each.
	Shards int `yaml:"shards" env:"WH_MQ_NATS_SHARDS"`
	// IngestConsumer names the shard durables: <ingest_consumer>-<shard>.
	IngestConsumer string `yaml:"ingest_consumer" env:"WH_MQ_NATS_INGEST_CONSUMER"`
	// HistoryStream is looked up by name; empty is <SUBJECT_PREFIX>_HISTORY,
	// the name the generated manifests give it.
	HistoryStream  string        `yaml:"history_stream" env:"WH_MQ_NATS_HISTORY_STREAM"`
	ConnectTimeout time.Duration `yaml:"connect_timeout" env:"WH_MQ_NATS_CONNECT_TIMEOUT"`
	PublishTimeout time.Duration `yaml:"publish_timeout" env:"WH_MQ_NATS_PUBLISH_TIMEOUT"`
	TopologyWait   time.Duration `yaml:"topology_wait" env:"WH_MQ_NATS_TOPOLOGY_WAIT"`
}

type MQNATSTLS struct {
	CAFile         string `yaml:"ca_file" env:"WH_MQ_NATS_TLS_CA_FILE"`
	CertFile       string `yaml:"cert_file" env:"WH_MQ_NATS_TLS_CERT_FILE"`
	KeyFile        string `yaml:"key_file" env:"WH_MQ_NATS_TLS_KEY_FILE"`
	ServerName     string `yaml:"server_name" env:"WH_MQ_NATS_TLS_SERVER_NAME"`
	HandshakeFirst bool   `yaml:"handshake_first" env:"WH_MQ_NATS_TLS_HANDSHAKE_FIRST"`
}

type OTel struct {
	Enabled bool        `yaml:"enabled" env:"WH_OTEL_ENABLED"`
	Traces  OTelTraces  `yaml:"traces"`
	Metrics OTelMetrics `yaml:"metrics"`
	Logs    OTelLogs    `yaml:"logs"`
}

type OTelLogs struct {
	Enabled    bool    `yaml:"enabled" env:"WH_OTEL_LOGS_ENABLED"`
	SampleRate float64 `yaml:"sample_rate" env:"WH_OTEL_LOGS_SAMPLE_RATE"`
}

type OTelMetrics struct {
	Enabled bool `yaml:"enabled" env:"WH_OTEL_METRICS_ENABLED"`
}

type OTelTraces struct {
	Enabled    bool    `yaml:"enabled" env:"WH_OTEL_TRACES_ENABLED"`
	SampleRate float64 `yaml:"sample_rate" env:"WH_OTEL_TRACES_SAMPLE_RATE"`
}

type Prometheus struct {
	Enabled bool   `yaml:"enabled" env:"WH_PROMETHEUS_ENABLED"`
	Path    string `yaml:"path" env:"WH_PROMETHEUS_PATH"`
	Port    int    `yaml:"port" env:"WH_PROMETHEUS_PORT"`
}

type Role string

type Server struct {
	Port            int `yaml:"port" env:"WH_SERVER_PORT"`
	ShutdownTimeout int `yaml:"shutdown_timeout" env:"WH_SERVER_SHUTDOWN_TIMEOUT"`
}

type Settings struct {
	Dir string `yaml:"dir" env:"WH_SETTINGS_DIR"`
}