Struct MagicLink 

pub struct MagicLink {
    pub id: Uuid,
    pub token_hash: String,
    pub subject_user_id: Uuid,
    pub scope_kind: MagicLinkScopeKind,
    pub scope_id: Uuid,
    pub issued_by: Uuid,
    pub expires_at: DateTime<Utc>,
    pub consumed_at: Option<DateTime<Utc>>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Fields

id: Uuid

token_hash: String

SHA-256 hex of the clear token. The clear token is NEVER stored.

subject_user_id: Uuid

User to whom the link grants access (e.g. external contractor user).

scope_kind: MagicLinkScopeKind

scope_id: Uuid

issued_by: Uuid

Syndic / superadmin user who issued the link (audit trail).

expires_at: DateTime<Utc>

consumed_at: Option<DateTime<Utc>>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl MagicLink

pub fn issue( subject_user_id: Uuid, scope_kind: MagicLinkScopeKind, scope_id: Uuid, issued_by: Uuid, ttl: Duration, ) -> Result<(Self, String), AppError>

Issue a new MagicLink. Returns the persisted entity AND the clear token that must be returned in the HTTP response (and never stored elsewhere).

Errors

• AppError::Validation if ttl <= 0, scope_id is nil, or subject_user_id == issued_by.

pub fn hash_token(clear_token: &str) -> String

SHA-256 hex digest of a clear token. Public so the repository / handler can hash an incoming token and look it up.

pub fn is_expired(&self) -> bool

pub fn is_consumed(&self) -> bool

pub fn is_valid(&self) -> bool

pub fn consume(&mut self)

Mark this link as consumed. Idempotent — subsequent calls are no-ops in-memory but should be guarded by the repository’s atomic UPDATE.

Trait Implementations

impl Clone for MagicLink

fn clone(&self) -> MagicLink

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MagicLink

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MagicLink

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MagicLink

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MagicLink