package postgres import ( "crypto/tls" "fmt" "net/url" "strconv" "strings" "time" ) type Backend string const ( BackendLocal Backend = "local" BackendPostgres Backend = "postgres" ) type SSLMode string const ( SSLDisable SSLMode = "disable" SSLVerifyFull SSLMode = "verify-full" ) type Getenv func(string) string type ReadFile func(string) ([]byte, error) type Config struct { Backend Backend DatabaseURL string SSLMode SSLMode TLSConfig *tls.Config PoolMax int32 IdleTimeout time.Duration ConnectionTimeout time.Duration StatementTimeout time.Duration ApplicationName string } func ParseConfig(getenv Getenv, _ ReadFile) (Config, error) { if getenv == nil { return Config{}, fmt.Errorf("environment getter is required") } cfg := Config{ PoolMax: 10, IdleTimeout: 30 * time.Second, ConnectionTimeout: 10 * time.Second, StatementTimeout: 30 * time.Second, ApplicationName: "zhinian-go", // Production RDS currently refuses TLS. Keep the transport choice in // code so an older Secret cannot silently re-enable negotiation. SSLMode: SSLDisable, } backend := strings.ToLower(strings.TrimSpace(getenv("ZHINIAN_DATA_BACKEND"))) if backend == "" && strings.ToLower(strings.TrimSpace(getenv("NODE_ENV"))) != "production" { backend = string(BackendLocal) } switch Backend(backend) { case BackendLocal, BackendPostgres: cfg.Backend = Backend(backend) default: return Config{}, fmt.Errorf("ZHINIAN_DATA_BACKEND must be explicitly set to 'local' or 'postgres'") } if cfg.Backend == BackendLocal { return cfg, nil } var err error if cfg.PoolMax, err = positiveInt32(getenv, "DATABASE_POOL_MAX", cfg.PoolMax); err != nil { return Config{}, err } if cfg.IdleTimeout, err = nonNegativeMilliseconds(getenv, "DATABASE_IDLE_TIMEOUT_MS", cfg.IdleTimeout); err != nil { return Config{}, err } if cfg.ConnectionTimeout, err = positiveMilliseconds(getenv, "DATABASE_CONNECTION_TIMEOUT_MS", cfg.ConnectionTimeout); err != nil { return Config{}, err } if cfg.StatementTimeout, err = positiveMilliseconds(getenv, "DATABASE_STATEMENT_TIMEOUT_MS", cfg.StatementTimeout); err != nil { return Config{}, err } if value := strings.TrimSpace(getenv("DATABASE_APPLICATION_NAME")); value != "" { cfg.ApplicationName = value } cfg.DatabaseURL = strings.TrimSpace(getenv("DATABASE_URL")) if cfg.DatabaseURL == "" { return Config{}, fmt.Errorf("DATABASE_URL is required when ZHINIAN_DATA_BACKEND=postgres") } parsed, parseErr := url.ParseRequestURI(cfg.DatabaseURL) if parseErr != nil || parsed.Host == "" { return Config{}, fmt.Errorf("DATABASE_URL must be a valid PostgreSQL connection URI") } if parsed.Scheme != "postgres" && parsed.Scheme != "postgresql" { return Config{}, fmt.Errorf("DATABASE_URL must use the postgres:// or postgresql:// scheme") } query := parsed.Query() for key, values := range query { lower := strings.ToLower(key) if strings.HasPrefix(lower, "ssl") && lower != "sslmode" && lower != "sslrootcert" { return Config{}, fmt.Errorf("DATABASE_URL contains unsupported SSL query parameter %s; PostgreSQL transport is forced to sslmode=disable", key) } if lower == "sslmode" { for _, value := range values { mode := strings.ToLower(strings.TrimSpace(value)) if mode != "" && mode != string(SSLDisable) && mode != string(SSLVerifyFull) { return Config{}, fmt.Errorf("DATABASE_URL sslmode must be 'disable' or 'verify-full'") } } } } cfg.DatabaseURL, err = forcePlaintextDatabaseURL(cfg.DatabaseURL) if err != nil { return Config{}, fmt.Errorf("normalize DATABASE_URL: %w", err) } return cfg, nil } func positiveInt32(getenv Getenv, name string, fallback int32) (int32, error) { raw := strings.TrimSpace(getenv(name)) if raw == "" { return fallback, nil } value, err := strconv.ParseInt(raw, 10, 32) if err != nil || value <= 0 { return 0, fmt.Errorf("%s must be a positive integer", name) } return int32(value), nil } func nonNegativeMilliseconds(getenv Getenv, name string, fallback time.Duration) (time.Duration, error) { return milliseconds(getenv, name, fallback, true) } func positiveMilliseconds(getenv Getenv, name string, fallback time.Duration) (time.Duration, error) { return milliseconds(getenv, name, fallback, false) } func milliseconds(getenv Getenv, name string, fallback time.Duration, allowZero bool) (time.Duration, error) { raw := strings.TrimSpace(getenv(name)) if raw == "" { return fallback, nil } value, err := strconv.ParseInt(raw, 10, 64) if err != nil || value < 0 || (!allowZero && value == 0) || value > int64((1<<63-1)/time.Millisecond) { qualifier := "positive" if allowZero { qualifier = "non-negative" } return 0, fmt.Errorf("%s must be a %s integer", name, qualifier) } return time.Duration(value) * time.Millisecond, nil }