Struct SessionManager 

pub struct SessionManager { /* private fields */ }

Manager maintaining session slots, concurrency bounds, and token authentication.

Implementations

impl SessionManager

pub fn new() -> Self

pub fn pin_tracker(&self) -> &PinTracker

Returns a reference to the PIN attempt tracker.

pub async fn has_active_session(&self) -> bool

Checks if a session is currently pending or active.

pub async fn claim_pending( &self, session_id: String, sender_ip: IpAddr, cert_fingerprint: Option<String>, cancel: CancellationToken, ) -> Result<(), StatusCode>

Claims the session slot for a pending prepare-upload request. Returns hyper::StatusCode::CONFLICT (409) if a session is already active or pending.

pub async fn clear_pending(&self, session_id: &str)

Releases the pending session if it still matches session_id.

pub async fn activate_session( &self, session_id: &str, sender_ip: IpAddr, cert_fingerprint: Option<String>, files: HashMap<String, SessionFile>, ) -> Result<(), StatusCode>

Promotes a pending session into an active upload session with accepted files.

pub async fn validate_and_start_upload( &self, session_id: &str, file_id: &str, token: &str, sender_ip: IpAddr, ) -> Result<SessionFile, StatusCode>

Validates upload authorization parameters for /api/localsend/v2/upload.

Verifies:

1. An active session exists matching session_id.
2. Sender IP matches the session’s recorded IP.
3. The requested file_id was accepted and has not completed.
4. The upload token matches the token issued during prepare-upload.

Returns the corresponding SessionFile and sets its status to InProgress.

pub async fn mark_file_status( &self, session_id: &str, file_id: &str, status: FileTransferStatus, ) -> bool

Updates the status of a file in the active session. If all files reach terminal status, the session is completed and the slot is freed. Returns whether the entire session finished.

pub async fn cancel_session( &self, session_id: Option<&str>, remote_ip: IpAddr, ) -> Option<SessionEndReason>

Cancels the session if the request matches the current pending or active session. Returns Some(SessionEndReason) if an active or pending session was cancelled.

pub async fn abort_locally(&self) -> Option<SessionEndReason>

Forcibly aborts and clears the current session locally.

Trait Implementations

impl Debug for SessionManager

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

Formats the value using the given formatter.

impl Default for SessionManager

fn default() -> Self

Returns the “default value” for a type.