Struct SessionConfig 

pub struct SessionConfig {
    pub auth_token_ttl: Duration,
    pub refresh_token_ttl: Duration,
    pub proactive_renewal_window: Duration,
    pub renewal_lease_ttl: LeaseTtl,
    pub clock_skew_tolerance: Duration,
}

Configuration for session issuance and renewal behavior.

This type intentionally stays free of HTTP-specific concerns such as cookie names, headers, or response mutation. Adapter crates should translate these values into transport-specific behavior at the system edge.

Examples

use std::time::Duration;
use webgates_sessions::config::SessionConfig;
use webgates_sessions::lease::LeaseTtl;

// Use defaults for a typical production setup.
let config = SessionConfig::default();
assert!(config.is_valid());

// Or supply explicit values.
let config = SessionConfig::new(
    Duration::from_secs(15 * 60),     // auth token TTL: 15 min
    Duration::from_secs(30 * 24 * 3600), // refresh token TTL: 30 days
    Duration::from_secs(2 * 60),      // proactive renewal window: 2 min
    LeaseTtl::new(Duration::from_secs(30)),
    Duration::from_secs(5),           // clock-skew tolerance: 5 s
)
.validate()
.unwrap();

assert!(config.is_valid());

Fields

auth_token_ttl: Duration

Lifetime of the short-lived authentication token.

refresh_token_ttl: Duration

Lifetime of the long-lived refresh token.

proactive_renewal_window: Duration

Window before auth-token expiry during which proactive renewal is allowed.

renewal_lease_ttl: LeaseTtl

Typed duration for which a renewal lease remains valid once acquired.

clock_skew_tolerance: Duration

Maximum amount of clock skew tolerated by renewal decision logic.

Implementations

impl SessionConfig

pub const fn new( auth_token_ttl: Duration, refresh_token_ttl: Duration, proactive_renewal_window: Duration, renewal_lease_ttl: LeaseTtl, clock_skew_tolerance: Duration, ) -> Self

Creates a configuration with explicit values.

pub fn renewal_lease_duration(&self) -> Duration

Returns the configured lease TTL as a raw duration.

pub fn validate(self) -> ConfigResult<Self>

Validates the configuration and returns the typed value when it is internally consistent.

Errors

Returns a configuration error when one of the required durations is zero or when the proactive renewal window exceeds the auth-token lifetime.

pub fn is_valid(&self) -> bool

Returns true when the configuration is internally consistent.

Trait Implementations

impl Clone for SessionConfig

fn clone(&self) -> SessionConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SessionConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SessionConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SessionConfig

fn eq(&self, other: &SessionConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SessionConfig

impl StructuralPartialEq for SessionConfig