Struct StoredToken 

pub struct StoredToken {
    pub access_token: String,
    pub refresh_token: String,
    pub expires_at: u64,
}

Stored token data, persisted to the token file.

This is the format written by stoat login and read/updated by stoat serve. The expires_at field is a Unix timestamp (seconds).

Fields

access_token: String

The current OAuth access token.

refresh_token: String

The refresh token for obtaining new access tokens.

expires_at: u64

Unix timestamp (seconds) when the access token expires.

Implementations

impl StoredToken

pub fn to_json(&self) -> Result<String, Error>

Serialize to a JSON string.

Errors

Returns a serde_json::Error if serialization fails (should not happen for this type).

pub fn from_json(s: &str) -> Result<Self, Error>

Deserialize from a JSON string.

Errors

Returns a serde_json::Error if the input is not valid JSON or does not match the expected schema.

pub const fn is_expired(&self, now_unix: u64) -> bool

Check whether the access token has expired.

now_unix is the current Unix timestamp in seconds. Returns true if the current time is at or past expires_at.

pub const fn needs_refresh(&self, now_unix: u64, margin_secs: u64) -> bool

Check whether the access token needs refreshing.

Returns true if the token is expired or will expire within margin_secs seconds. This allows proactive refresh before the token actually expires, avoiding 401 errors on forwarded requests.

Use DEFAULT_REFRESH_MARGIN_SECS for the standard margin.

Trait Implementations

impl Clone for StoredToken

fn clone(&self) -> StoredToken

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StoredToken

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StoredToken

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for StoredToken

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for StoredToken

impl StructuralPartialEq for StoredToken