Struct DemoSessionRow 

pub struct DemoSessionRow {
    pub id: i64,
    pub token_hash: String,
    pub created_at: DateTime<Utc>,
    pub last_seen_at: DateTime<Utc>,
    pub expires_at: DateTime<Utc>,
    pub revoked_at: Option<DateTime<Utc>>,
}

A short-lived anonymous owner for simulator-only public demo runs. The raw bearer token is never stored; callers pass its lowercase hexadecimal SHA-256 hash to the repository.

Fields

id: i64

token_hash: String

created_at: DateTime<Utc>

last_seen_at: DateTime<Utc>

expires_at: DateTime<Utc>

revoked_at: Option<DateTime<Utc>>

Implementations

impl DemoSessionRow

pub async fn create( pool: &SqlitePool, token_hash: &str, now: DateTime<Utc>, expires_at: DateTime<Utc>, ) -> DbResult<Self>

Persists a session on first use, or returns the already-persisted valid row when another request won the same token-hash race.

pub async fn get_or_create( pool: &SqlitePool, token_hash: &str, now: DateTime<Utc>, expires_at: DateTime<Utc>, ) -> DbResult<Self>

Lazily persists a token hash on first use. Concurrent callers presenting the same token converge on one row: the unique-token loser reloads the winner’s valid row rather than surfacing a uniqueness error.

An expired or revoked conflicting row remains authoritative and is returned as RowNotFound; it is never revived and its fixed expiry is never extended.

pub async fn get_by_token_hash( pool: &SqlitePool, token_hash: &str, now: DateTime<Utc>, ) -> DbResult<Option<Self>>

Looks up an authorization session and atomically records its latest activity. Expired and revoked rows are deliberately indistinguishable from a missing row, and the fixed expiry is never extended.

pub async fn touch_by_token_hash( pool: &SqlitePool, token_hash: &str, now: DateTime<Utc>, ) -> DbResult<Option<Self>>

Records activity only while the session remains valid. expires_at is never changed: demo sessions have an absolute lifetime, not a sliding one.

pub async fn revoke( pool: &SqlitePool, id: i64, now: DateTime<Utc>, ) -> DbResult<bool>

pub async fn cleanup_expired( pool: &SqlitePool, now: DateTime<Utc>, ) -> DbResult<u64>

Removes expired/revoked sessions and cascades their terminal owned history.

A session owning a running run is protected even after expiry or revocation. Startup recovery must first mark that run failed via Self::recover_running_demo_runs; only a later cleanup can remove the session and its now-terminal history.

pub async fn recover_running_demo_runs( pool: &SqlitePool, now: DateTime<Utc>, ) -> DbResult<u64>

Marks demo runs left in running state by a process restart as failed. Demo work is intentionally not resumed after a crash or restart.

Trait Implementations

impl Clone for DemoSessionRow

fn clone(&self) -> DemoSessionRow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DemoSessionRow

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

Formats the value using the given formatter.

impl Eq for DemoSessionRow

impl PartialEq for DemoSessionRow

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