capy-core 0.7.1

Typed configuration, application context, and errors for the Capy web framework.
Documentation
use crate::{AppError, Result};
use serde::{Deserialize, Serialize};

/// Cookie policy. Cross-site cookies are intentionally outside the built-in path.
#[derive(Clone, Copy, Debug, Default, Deserialize, Serialize)]
#[serde(rename_all = "lowercase")]
pub enum SameSite {
    /// Send cookies for same-site requests and top-level safe navigation.
    #[default]
    Lax,
    /// Send cookies only in same-site contexts.
    Strict,
}

/// Small, typed settings for the optional conventional identity system.
#[derive(Clone, Debug, Deserialize, Serialize)]
#[serde(default, deny_unknown_fields)]
pub struct AuthSettings {
    /// Absolute authenticated session lifetime, in seconds (default: 30 days).
    pub session_lifetime_seconds: u64,
    /// Host-only cookie name. Defaults to `__Host-session` in production.
    pub cookie_name: Option<String>,
    /// Defaults to true in production and false locally. Production rejects false.
    pub secure: Option<bool>,
    /// Browser cookie policy; Lax by default.
    pub same_site: SameSite,
    /// Reset token lifetime, in seconds (default: 30 minutes).
    pub password_reset_lifetime_seconds: u64,
}

impl Default for AuthSettings {
    fn default() -> Self {
        Self {
            session_lifetime_seconds: 30 * 86400,
            cookie_name: None,
            secure: None,
            same_site: SameSite::Lax,
            password_reset_lifetime_seconds: 1800,
        }
    }
}

impl AuthSettings {
    /// Resolve the host-only cookie name for an environment.
    pub fn cookie_name(&self, production: bool) -> &str {
        self.cookie_name.as_deref().unwrap_or(if production {
            "__Host-session"
        } else {
            "session"
        })
    }

    /// Resolve the transport policy without weakening production defaults.
    pub fn secure(&self, production: bool) -> bool {
        production || self.secure.unwrap_or(false)
    }

    /// Validate settings when auth is installed; unrelated apps need no auth config.
    pub fn validate(&self, production: bool) -> Result<()> {
        let cookie = self.cookie_name(production);
        if cookie.is_empty()
            || cookie.len() > 100
            || !cookie
                .bytes()
                .all(|c| c.is_ascii_alphanumeric() || b"_-".contains(&c))
            || (cookie.starts_with("__Host-") || cookie.starts_with("__Secure-"))
                && !self.secure(production)
            || production && self.secure == Some(false)
        {
            return Err(AppError::Configuration(
                "Auth requires a valid cookie name and Secure cookies in production.".into(),
            ));
        }
        if !(60..=90 * 86400).contains(&self.session_lifetime_seconds)
            || !(60..=86400).contains(&self.password_reset_lifetime_seconds)
        {
            return Err(AppError::Configuration("Auth session lifetime must be 60..=7776000 seconds; reset lifetime must be 60..=86400 seconds.".into()));
        }
        Ok(())
    }
}