Struct ClientSessionData 

pub struct ClientSessionData<S: BosStr = DefaultStr> {
    pub account_did: Did<S>,
    pub session_id: S,
    pub host_url: Uri<String>,
    pub authserver_url: S,
    pub authserver_token_endpoint: S,
    pub authserver_revocation_endpoint: Option<S>,
    pub scopes: Scopes<S>,
    pub dpop_data: DpopClientData,
    pub token_set: TokenSet<S>,
    pub resolved_scopes: Option<Vec<Scope<SmolStr>>>,
}

Persisted information about an OAuth session. Used to resume an active session.

Fields

account_did: Did<S>

DID of the authenticated account; serves as the primary key for session storage because only one active session per account is assumed.

session_id: S

Opaque identifier that distinguishes this session from other sessions for the same account.

Reuses the random state token generated during the PAR flow.

host_url: Uri<String>

Base URL of the resource server (PDS): scheme, host, and port only

authserver_url: S

Base URL of the authorization server (PDS or entryway): scheme, host, and port only

authserver_token_endpoint: S

Full URL of the authorization server’s token endpoint.

authserver_revocation_endpoint: Option<S>

Full URL of the authorization server’s revocation endpoint, if advertised.

scopes: Scopes<S>

The set of OAuth scopes approved for this session, as returned in the initial token response.

dpop_data: DpopClientData

DPoP key and nonce state for ongoing requests in this session.

token_set: TokenSet<S>

Current token set (access token, refresh token, expiry, etc.).

resolved_scopes: Option<Vec<Scope<SmolStr>>>

Fully expanded scopes with include scopes resolved.

This is populated eagerly at session creation when scope-check is enabled. It is None when scope checking is not enabled, when no eager resolution was performed, or when reading older persisted sessions that predate this field.

Implementations

impl<S: BosStr + Ord + AsRef<str>> ClientSessionData<S>

pub fn update_with_tokens(&mut self, token_set: &TokenSet<S>)

where S: FromStr + Clone + From<SmolStr> + AsRef<str>, S::Err: Debug,

Update this session’s token set and, if the new token set includes scopes, replace the scope list.

Called after a successful token refresh so that any scope changes returned by the server are reflected in the persisted session without requiring a full re-authentication.

This method is only available on DefaultStr-backed sessions (the common case for in-memory sessions). Zero-copy borrowed sessions are read-only by nature and would not be refreshed in place.

Trait Implementations

impl<S: Clone + BosStr> Clone for ClientSessionData<S>

fn clone(&self) -> ClientSessionData<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + BosStr> Debug for ClientSessionData<S>

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

Formats the value using the given formatter.

impl<'de, S> Deserialize<'de> for ClientSessionData<S>

where S: Deserialize<'de> + BosStr + AsRef<str>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<S: Eq + BosStr> Eq for ClientSessionData<S>

impl<S: BosStr + Ord + IntoStatic + AsRef<str>> IntoStatic for ClientSessionData<S>

where S::Output: BosStr + Ord + AsRef<str>,

type Output = ClientSessionData<<S as IntoStatic>::Output>

The “owned” variant of the type. For Cow<'a, str>, this is Cow<'static, str>, for example.

fn into_static(self) -> Self::Output

Turns the value into an “owned” variant, which can then be returned, moved, etc.

impl<S: PartialEq + BosStr> PartialEq for ClientSessionData<S>

fn eq(&self, other: &ClientSessionData<S>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<S> Serialize for ClientSessionData<S>

where S: Serialize + BosStr + Ord,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: ClientAuthStore + Send + Sync> SessionStore<SessionKey, ClientSessionData> for Arc<T>

async fn get(&self, key: &SessionKey) -> Option<ClientSessionData>

Get the current session if present.

async fn set( &self, _key: SessionKey, session: ClientSessionData, ) -> Result<(), SessionStoreError>

Persist the given session.

async fn del(&self, key: &SessionKey) -> Result<(), SessionStoreError>

Delete the given session.

async fn list_keys(&self) -> Result<Vec<SessionKey>, SessionStoreError>

List known session keys when the backend supports enumeration.

impl<S: PartialEq + BosStr> StructuralPartialEq for ClientSessionData<S>