// Package config loads and validates process configuration from environment // variables and optional *_FILE secrets. package config import ( "fmt" "os" "strconv" "strings" "time" ) type Config struct { Host string Port string InstanceID string SessionTTL time.Duration IdempotencyTTL time.Duration DatabaseURL string CacheURL string DBMaxConns int32 DBTimeout time.Duration RedisTimeout time.Duration StartupWait time.Duration RunMigrations bool MigrateOnly bool } func Load() (Config, error) { instance, err := instanceID() if err != nil { return Config{}, err } sessionTTL, err := envInt("SESSION_TTL_SECONDS", 3600, 1, 0) if err != nil { return Config{}, err } idempotencyTTL, err := envInt("IDEMPOTENCY_TTL_SECONDS", 86400, 1, 0) if err != nil { return Config{}, err } maxConns, err := envInt("DB_POOL_MAX_CONNS", 10, 1, 100) if err != nil { return Config{}, err } cfg := Config{ Host: envOr("APP_HOST", "0.0.0.0"), Port: envOr("APP_PORT", "8080"), InstanceID: instance, SessionTTL: time.Duration(sessionTTL) * time.Second, IdempotencyTTL: time.Duration(idempotencyTTL) * time.Second, DBMaxConns: int32(maxConns), DBTimeout: 5 * time.Second, RedisTimeout: 2 * time.Second, StartupWait: 30 * time.Second, } if cfg.RunMigrations, err = envBool("RUN_MIGRATIONS", true); err != nil { return Config{}, err } if cfg.MigrateOnly, err = envBool("MIGRATE_ONLY", false); err != nil { return Config{}, err } if cfg.DatabaseURL, err = secret("DATABASE_URL"); err != nil { return Config{}, err } if cfg.DatabaseURL == "" { return Config{}, fmt.Errorf("DATABASE_URL or DATABASE_URL_FILE is required") } if cfg.MigrateOnly { return cfg, nil } if cfg.CacheURL, err = secret("CACHE_URL"); err != nil { return Config{}, err } if cfg.CacheURL == "" { if cfg.CacheURL, err = secret("REDIS_URL"); err != nil { return Config{}, err } } if cfg.CacheURL == "" { return Config{}, fmt.Errorf("CACHE_URL or CACHE_URL_FILE is required") } if value := strings.ToLower(envOr("SESSION_STORE", "redis")); value != "redis" { return Config{}, fmt.Errorf("SESSION_STORE must be redis (got %q)", value) } return cfg, nil } func instanceID() (string, error) { if value := strings.TrimSpace(os.Getenv("INSTANCE_ID")); value != "" { return value, nil } name, err := os.Hostname() if err != nil { return "", fmt.Errorf("determine INSTANCE_ID: %w", err) } if name = strings.TrimSpace(name); name == "" { return "", fmt.Errorf("determine INSTANCE_ID: hostname is empty and INSTANCE_ID is not set") } return name, nil } func envBool(name string, fallback bool) (bool, error) { value := os.Getenv(name) if value == "" { return fallback, nil } parsed, err := strconv.ParseBool(value) if err != nil { return false, fmt.Errorf("%s must be true or false", name) } return parsed, nil } // envInt parses an integer setting; max <= 0 means "no upper bound". func envInt(name string, fallback, min, max int) (int, error) { value := os.Getenv(name) if value == "" { return fallback, nil } parsed, err := strconv.Atoi(value) if err != nil || parsed < min || (max > 0 && parsed > max) { if max > 0 { return 0, fmt.Errorf("%s must be an integer between %d and %d", name, min, max) } return 0, fmt.Errorf("%s must be an integer >= %d", name, min) } return parsed, nil } func envOr(name, fallback string) string { if value := os.Getenv(name); value != "" { return value } return fallback } func secret(name string) (string, error) { if value := os.Getenv(name); value != "" { return value, nil } path := os.Getenv(name + "_FILE") if path == "" { return "", nil } data, err := os.ReadFile(path) if err != nil { return "", fmt.Errorf("read %s_FILE: %w", name, err) } value := strings.TrimSpace(string(data)) if value == "" { return "", fmt.Errorf("%s_FILE is empty", name) } return value, nil }