Struct TargetTokenMap 

pub struct TargetTokenMap { /* private fields */ }

Account-scoped map from opaque tokens to authorized cases for one turn.

Implementations

impl TargetTokenMap

pub fn new(account_id: AccountId, turn_id: TurnId) -> Self

Creates an empty map for one account and turn.

pub fn account_id(&self) -> &AccountId

The account the map is scoped to.

pub fn turn_id(&self) -> &TurnId

The turn the tokens were issued for.

pub fn issue( &mut self, case_ref: CaseRef, label: impl Into<String>, ) -> TargetToken

Issues (or returns the existing) token for a case.

Tokens are derived deterministically from the account, turn and case so a replayed turn reproduces the same catalog; they are opaque and carry no database identifier. Re-issuing for a case already in the map updates the label and revision and restores Authorized.

pub fn resolve( &self, account: &AccountId, token: &TargetToken, ) -> TargetResolution

Resolves a token for account.

A different account, an unknown token and another tenant’s token all yield Unauthorized. Missing and Stale are reported only for tokens issued in this map and marked as such.

pub fn mark_missing(&mut self, token: &TargetToken) -> bool

Marks a token’s case as gone. Returns false when the token is unknown.

pub fn mark_stale( &mut self, token: &TargetToken, current_revision: CaseRevision, ) -> bool

Marks a token’s case as moved to current_revision. Returns false when the token is unknown.

pub fn token_for(&self, key: &CaseKey) -> Option<&TargetToken>

The token issued for a case, if any.

pub fn get(&self, token: &TargetToken) -> Option<&TargetEntry>

Entry behind a token, without an account check. For the runtime that owns the map; client-facing paths must use Self::resolve.

pub fn candidates(&self) -> Vec<TargetCandidate>

All authorized candidates, for the interpretation catalog.

pub fn candidates_for(&self, workflow: &WorkflowKey) -> Vec<TargetCandidate>

Authorized candidates of one workflow, for resolving mentions.

pub fn iter(&self) -> impl Iterator<Item = (&TargetToken, &TargetEntry)>

Iterates all entries.

pub fn len(&self) -> usize

Number of tokens.

pub fn is_empty(&self) -> bool

Returns true when no token was issued.

Trait Implementations

impl Clone for TargetTokenMap

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TargetTokenMap

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TargetTokenMap

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TargetTokenMap

impl PartialEq for TargetTokenMap

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TargetTokenMap

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 TargetTokenMap