Struct AuthClient 

pub struct AuthClient { /* private fields */ }

Authentication client for APS

Handles OAuth 2.0 token acquisition for both 2-legged and 3-legged flows.

Implementations

impl AuthClient

pub async fn login_device(&self, scopes: &[&str]) -> Result<StoredToken>

Login with 3-legged OAuth using manual PKCE flow (headless-friendly).

1. Generates a PKCE code verifier / challenge pair.
2. Prints an authorization URL for the user to open in any browser.
3. Prompts the user to paste back the callback URL (or bare code).
4. Exchanges the authorization code + verifier for tokens.

impl AuthClient

pub async fn get_3leg_token(&self) -> Result<String>

Get a valid 3-legged access token (requires prior login)

Uses Mutex-based coordination to ensure only one refresh occurs at a time. Concurrent callers wait and receive the newly refreshed token.

pub async fn is_logged_in(&self) -> bool

Check if user is logged in with 3-legged OAuth

pub async fn login(&self, scopes: &[&str]) -> Result<StoredToken>

Start 3-legged OAuth login flow

pub async fn logout(&self) -> Result<()>

Logout - clear stored tokens

pub async fn get_user_info(&self) -> Result<UserInfo>

Get user profile information (requires 3-legged auth with user:read or user-profile:read scope)

pub async fn get_token_expiry(&self) -> Option<i64>

Get token expiry timestamp

impl AuthClient

pub fn delete_stored_token(&self) -> Result<()>

Delete stored token

pub async fn login_with_token( &self, access_token: String, refresh_token: Option<String>, expires_in: u64, scopes: Vec<String>, ) -> Result<StoredToken>

Login with a provided access token (for CI/CD scenarios)

impl AuthClient

pub async fn get_token(&self) -> Result<String>

Get a valid 2-legged access token

pub async fn test_auth(&self) -> Result<()>

Test 2-legged authentication

pub async fn clear_cache(&self)

Clear the cached 2-legged token

impl AuthClient

pub fn new(config: Config) -> Self

Create a new authentication client

pub fn new_with_http_config( config: Config, http_config: HttpClientConfig, ) -> Self

Create a new authentication client with custom HTTP config

pub fn config(&self) -> &Config

Get config reference

Trait Implementations

impl Clone for AuthClient

fn clone(&self) -> AuthClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.