fraiseql-server 2.2.0

//! Configuration loading from TOML files and environment variables.
//!
//! Loading is performed via methods on [`RuntimeConfig`] that locate and
//! deserialize `fraiseql.toml`, then validate the result with
//! `ConfigValidator` in the `validation` sub-module.

use std::{env, path::Path};

use fraiseql_error::ConfigError;

use crate::config::{RuntimeConfig, validation::ConfigValidator};

impl RuntimeConfig {
    /// Load configuration from file with full validation
    ///
    /// # Errors
    ///
    /// Returns `ConfigError::ReadError` if the file cannot be read.
    /// Returns `ConfigError::ParseError` if the file content is not valid TOML.
    /// Returns `ConfigError` if validation fails or required environment variables are missing.
    pub fn from_file(path: impl AsRef<Path>) -> Result<Self, ConfigError> {
        let path = path.as_ref();

        let content = std::fs::read_to_string(path).map_err(|e| ConfigError::ReadError {
            path:   path.to_path_buf(),
            source: e,
        })?;

        let config: RuntimeConfig =
            toml::from_str(&content).map_err(|e| ConfigError::ParseError { source: e })?;

        // Run comprehensive validation
        let validation = ConfigValidator::new(&config).validate();
        let warnings = validation.into_result()?;

        // Log warnings
        for warning in warnings {
            tracing::warn!("Configuration warning: {}", warning);
        }

        Ok(config)
    }

    /// Load configuration from default locations
    ///
    /// # Errors
    ///
    /// Returns `ConfigError::NotFound` if no configuration file is found in any default location.
    /// Returns `ConfigError` if the found file cannot be read, parsed, or fails validation.
    pub fn load() -> Result<Self, ConfigError> {
        // Check FRAISEQL_CONFIG environment variable
        if let Ok(path) = env::var("FRAISEQL_CONFIG") {
            return Self::from_file(&path);
        }

        // Check current directory
        let local_config = Path::new("./fraiseql.toml");
        if local_config.exists() {
            return Self::from_file(local_config);
        }

        // Check user config directory
        if let Some(config_dir) = dirs::config_dir() {
            let user_config = config_dir.join("fraiseql/config.toml");
            if user_config.exists() {
                return Self::from_file(&user_config);
            }
        }

        Err(ConfigError::NotFound)
    }

    /// Load configuration with optional file path (CLI argument)
    ///
    /// # Errors
    ///
    /// Returns `ConfigError` if loading from the given path or from default locations fails.
    pub fn load_with_path(path: Option<&Path>) -> Result<Self, ConfigError> {
        match path {
            Some(p) => Self::from_file(p),
            None => Self::load(),
        }
    }

    /// Validate configuration without loading env vars (for dry-run/testing)
    ///
    /// # Errors
    ///
    /// Returns `ConfigError::ParseError` if the content is not valid TOML or cannot be
    /// deserialized.
    pub fn validate_syntax(content: &str) -> Result<(), ConfigError> {
        let _config: RuntimeConfig =
            toml::from_str(content).map_err(|e| ConfigError::ParseError { source: e })?;
        Ok(())
    }
}