Struct AuthManager 

pub struct AuthManager {
    http_client: Arc<HttpClient>,
    current_session: Arc<RwLock<Option<Session>>>,
    connectivity_monitor: Option<Arc<Mutex<ConnectivityMonitor>>>,
}

Authentication manager

Fields

http_client: Arc<HttpClient>

current_session: Arc<RwLock<Option<Session>>>

connectivity_monitor: Option<Arc<Mutex<ConnectivityMonitor>>>

Implementations

impl AuthManager

pub fn new(http_client: HttpClient) -> Self

Create a new auth manager

pub fn set_connectivity_monitor( &mut self, monitor: Arc<Mutex<ConnectivityMonitor>>, )

Set the connectivity monitor (for marking server reachability)

pub fn normalize_url(url: &str) -> Result<String, String>

Normalize and validate server URL. Enforces HTTPS — plain HTTP is rejected for security.

pub fn normalize_username(username: &str) -> String

Normalize a username before it goes to the server.

Only surrounding whitespace is stripped — interior spaces are legal in Jellyfin usernames. Without this, a trailing space from a soft keyboard’s autocorrect makes the server report an unknown user, which surfaces as a 401 that looks exactly like a wrong password.

TRACES: UR-042 | DR-054

pub async fn connect_to_server( &self, server_url: &str, ) -> Result<ServerInfo, String>

Connect to server and get server info

pub async fn login( &self, server_url: &str, username: &str, password: &str, device_id: &str, ) -> Result<AuthResult, String>

Authenticate by username and password

pub async fn verify_session( &self, server_url: &str, user_id: &str, access_token: &str, device_id: &str, ) -> Result<User, String>

Verify current session by fetching user info

pub async fn logout( &self, server_url: &str, access_token: &str, device_id: &str, ) -> Result<(), String>

Logout (call Jellyfin logout endpoint)

pub async fn get_session(&self) -> Option<Session>

Get current session

pub async fn set_session(&self, session: Option<Session>)

Set current session