scrabble-game/backend/internal/config/config_test.go

package config

import (
	"testing"
	"time"

	"scrabble/backend/internal/postgres"
	"scrabble/backend/internal/telemetry"
)

// testDSN is a syntactically valid DSN used to satisfy the required-DSN check.
const testDSN = "postgres://u:p@localhost:5432/db?search_path=backend&sslmode=disable"

// TestLoadDefaults verifies that Load applies defaults when only the required
// DSN is set.
func TestLoadDefaults(t *testing.T) {
	t.Setenv("BACKEND_HTTP_ADDR", "")
	t.Setenv("BACKEND_LOG_LEVEL", "")
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_DICT_DIR", "/dict")
	t.Setenv("BACKEND_DICT_VERSION", "")
	t.Setenv("BACKEND_GAME_TIMEOUT_SWEEP_INTERVAL", "")
	t.Setenv("BACKEND_GAME_CACHE_TTL", "")

	c, err := Load()
	if err != nil {
		t.Fatalf("Load: %v", err)
	}
	if c.HTTPAddr != defaultHTTPAddr {
		t.Errorf("HTTPAddr = %q, want %q", c.HTTPAddr, defaultHTTPAddr)
	}
	if c.LogLevel != defaultLogLevel {
		t.Errorf("LogLevel = %q, want %q", c.LogLevel, defaultLogLevel)
	}
	if c.Postgres.DSN != testDSN {
		t.Errorf("Postgres.DSN = %q, want %q", c.Postgres.DSN, testDSN)
	}
	if c.Postgres.MaxOpenConns != postgres.DefaultMaxOpenConns {
		t.Errorf("Postgres.MaxOpenConns = %d, want %d", c.Postgres.MaxOpenConns, postgres.DefaultMaxOpenConns)
	}
	if c.Telemetry.ServiceName != telemetry.DefaultServiceName {
		t.Errorf("Telemetry.ServiceName = %q, want %q", c.Telemetry.ServiceName, telemetry.DefaultServiceName)
	}
	if c.Telemetry.TracesExporter != telemetry.ExporterNone {
		t.Errorf("Telemetry.TracesExporter = %q, want %q", c.Telemetry.TracesExporter, telemetry.ExporterNone)
	}
	if c.Game.DictDir != "/dict" {
		t.Errorf("Game.DictDir = %q, want /dict", c.Game.DictDir)
	}
	if c.Game.DictVersion != "v1" {
		t.Errorf("Game.DictVersion = %q, want v1", c.Game.DictVersion)
	}
	if c.Game.TimeoutSweepInterval != time.Minute {
		t.Errorf("Game.TimeoutSweepInterval = %s, want 1m", c.Game.TimeoutSweepInterval)
	}
	if c.Game.CacheTTL != 24*time.Hour {
		t.Errorf("Game.CacheTTL = %s, want 24h", c.Game.CacheTTL)
	}
}

// TestLoadOverrides verifies that environment variables override the defaults.
func TestLoadOverrides(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_HTTP_ADDR", "127.0.0.1:9090")
	t.Setenv("BACKEND_LOG_LEVEL", "debug")
	t.Setenv("BACKEND_POSTGRES_MAX_OPEN_CONNS", "7")
	t.Setenv("BACKEND_POSTGRES_OPERATION_TIMEOUT", "3s")
	t.Setenv("BACKEND_SERVICE_NAME", "scrabble-test")
	t.Setenv("BACKEND_OTEL_TRACES_EXPORTER", "stdout")
	t.Setenv("BACKEND_DICT_DIR", "/srv/dict")
	t.Setenv("BACKEND_DICT_VERSION", "2026-06")
	t.Setenv("BACKEND_GAME_TIMEOUT_SWEEP_INTERVAL", "30s")
	t.Setenv("BACKEND_GAME_CACHE_TTL", "1h")

	c, err := Load()
	if err != nil {
		t.Fatalf("Load: %v", err)
	}
	if c.HTTPAddr != "127.0.0.1:9090" {
		t.Errorf("HTTPAddr = %q, want %q", c.HTTPAddr, "127.0.0.1:9090")
	}
	if c.Game.DictDir != "/srv/dict" || c.Game.DictVersion != "2026-06" {
		t.Errorf("Game dict = %q/%q, want /srv/dict/2026-06", c.Game.DictDir, c.Game.DictVersion)
	}
	if c.Game.TimeoutSweepInterval != 30*time.Second {
		t.Errorf("Game.TimeoutSweepInterval = %s, want 30s", c.Game.TimeoutSweepInterval)
	}
	if c.Game.CacheTTL != time.Hour {
		t.Errorf("Game.CacheTTL = %s, want 1h", c.Game.CacheTTL)
	}
	if c.LogLevel != "debug" {
		t.Errorf("LogLevel = %q", c.LogLevel)
	}
	if c.Postgres.MaxOpenConns != 7 {
		t.Errorf("Postgres.MaxOpenConns = %d, want 7", c.Postgres.MaxOpenConns)
	}
	if c.Postgres.OperationTimeout != 3*time.Second {
		t.Errorf("Postgres.OperationTimeout = %s, want 3s", c.Postgres.OperationTimeout)
	}
	if c.Telemetry.ServiceName != "scrabble-test" {
		t.Errorf("Telemetry.ServiceName = %q", c.Telemetry.ServiceName)
	}
	if c.Telemetry.TracesExporter != telemetry.ExporterStdout {
		t.Errorf("Telemetry.TracesExporter = %q, want %q", c.Telemetry.TracesExporter, telemetry.ExporterStdout)
	}
}

// TestLoadRejectsMissingDSN verifies that an empty DSN fails validation.
func TestLoadRejectsMissingDSN(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", "")
	if _, err := Load(); err == nil {
		t.Fatal("Load: expected an error for a missing DSN, got nil")
	}
}

// TestLoadRejectsInvalidLevel verifies that an unknown log level is rejected.
func TestLoadRejectsInvalidLevel(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_LOG_LEVEL", "verbose")
	if _, err := Load(); err == nil {
		t.Fatal("Load: expected an error for an invalid log level, got nil")
	}
}

// TestLoadRejectsMissingDictDir verifies that an unset dictionary directory fails
// validation (the game subsystem cannot load without it).
func TestLoadRejectsMissingDictDir(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_LOG_LEVEL", "info")
	t.Setenv("BACKEND_DICT_DIR", "")
	if _, err := Load(); err == nil {
		t.Fatal("Load: expected an error for a missing dictionary dir, got nil")
	}
}

// TestLoadRejectsMalformedInt verifies that a non-numeric pool size is rejected.
func TestLoadRejectsMalformedInt(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_POSTGRES_MAX_OPEN_CONNS", "lots")
	if _, err := Load(); err == nil {
		t.Fatal("Load: expected an error for a malformed int, got nil")
	}
}

// TestLoadRejectsMalformedDuration verifies that a malformed duration is rejected.
func TestLoadRejectsMalformedDuration(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_POSTGRES_OPERATION_TIMEOUT", "soon")
	if _, err := Load(); err == nil {
		t.Fatal("Load: expected an error for a malformed duration, got nil")
	}
}

// TestLoadRejectsUnsupportedExporter verifies that an exporter outside the MVP
// set is rejected.
func TestLoadRejectsUnsupportedExporter(t *testing.T) {
	t.Setenv("BACKEND_POSTGRES_DSN", testDSN)
	t.Setenv("BACKEND_OTEL_TRACES_EXPORTER", "otlp")
	if _, err := Load(); err == nil {
		t.Fatal("Load: expected an error for an unsupported exporter, got nil")
	}
}