Struct Session 

pub struct Session {
    pub session_id: SessionId,
    pub family_id: SessionFamilyId,
    pub subject_id: String,
    pub created_at: SystemTime,
    pub expires_at: SystemTime,
    pub last_seen_at: Option<SystemTime>,
    pub revoked: bool,
}

Persisted session state tracked by the session layer.

This is the canonical framework-agnostic session record used by repository contracts and higher-level renewal services.

Examples

use std::time::{Duration, SystemTime};
use webgates_sessions::session::{Session, SessionFamilyId};

let now = SystemTime::UNIX_EPOCH + Duration::from_secs(1_000);
let session = Session::new(
    SessionFamilyId::new(),
    "user-42",
    now,
    now + Duration::from_secs(3_600),
);

assert_eq!(session.subject_id, "user-42");
assert!(session.is_active_at(now));
assert!(!session.is_expired_at(now));

let revoked = session.revoked();
assert!(!revoked.is_active_at(now));

Fields

session_id: SessionId

Stable session identifier.

family_id: SessionFamilyId

Owning session family identifier.

subject_id: String

Stable subject identifier that owns the session.

created_at: SystemTime

Creation timestamp for the session.

expires_at: SystemTime

Expiration timestamp for the session.

last_seen_at: Option<SystemTime>

Last observed activity timestamp for the session.

revoked: bool

Whether the session is currently revoked.

Implementations

impl Session

pub fn new( family_id: SessionFamilyId, subject_id: impl Into<String>, created_at: SystemTime, expires_at: SystemTime, ) -> Self

Creates a new active session record.

pub fn touched(self, last_seen_at: SystemTime) -> Self

Returns a copy of the session with an updated last_seen_at value.

pub fn revoked(self) -> Self

Returns a copy of the session marked as revoked.

pub fn is_active_at(&self, now: SystemTime) -> bool

Returns true when the session is active at now.

pub fn is_expired_at(&self, now: SystemTime) -> bool

Returns true when the session has expired at now.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl PartialEq for Session

fn eq(&self, other: &Session) -> 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 Session

impl StructuralPartialEq for Session