Struct SessionRenewer 

pub struct SessionRenewer<R, A, G, H> { /* private fields */ }

Renews existing sessions using refresh-token rotation.

Use this service when a client presents a refresh token and you need to decide whether renewal is needed, coordinate leases, rotate token state, and produce replacement tokens.

Examples

use webgates_sessions::config::SessionConfig;
use webgates_sessions::services::SessionRenewer;
use webgates_sessions::tokens::{
    OpaqueRefreshTokenGenerator, RefreshTokenLength, Sha256RefreshTokenHasher,
    TokenPairIssuer, AuthToken, AuthTokenIssuer,
};
use webgates_sessions::session::Session;

#[derive(Debug, Clone, Copy)]
struct NoopIssuer;

impl AuthTokenIssuer<Session> for NoopIssuer {
    type Error = webgates_sessions::errors::TokenError;
    fn issue_auth_token(
        &self,
        s: &Session,
    ) -> impl std::future::Future<Output = Result<AuthToken, Self::Error>> + Send {
        std::future::ready(AuthToken::new(format!("auth-{}", s.subject_id)))
    }
}


let length = RefreshTokenLength::new(64).unwrap();
let token_pair_issuer = TokenPairIssuer::new(
    NoopIssuer,
    OpaqueRefreshTokenGenerator::new(length),
    Sha256RefreshTokenHasher,
);

let renewer = SessionRenewer::new(
    SessionConfig::default(),
    Noop,
    token_pair_issuer,
)
.unwrap();

Implementations

impl<R, A, G, H> SessionRenewer<R, A, G, H>

pub fn new( config: SessionConfig, repository: R, token_pair_issuer: TokenPairIssuer<A, G, H>, ) -> ConfigResult<Self>

Creates a new session renewer.

Errors

Returns a configuration error when config is internally inconsistent.

impl<R, A, G, H> SessionRenewer<R, A, G, H>

where R: SessionRepository, A: AuthTokenIssuer<Session>, G: RefreshTokenGenerator, H: RefreshTokenHasher,

pub async fn renew_session( &self, auth_token_state: AuthTokenState, requirement: RenewalRequirement, refresh_token: &RefreshTokenPlaintext, now: SystemTime, ) -> Result<RenewalOutcome>

Attempts to renew a session using the presented refresh token.

Valid auth tokens that are not yet near expiry short-circuit to RenewalOutcome::NotNeeded without touching persistence.

Errors

Returns a session error when hashing, repository access, token issuance, or family revocation fails.

Trait Implementations

impl<R: Clone, A: Clone, G: Clone, H: Clone> Clone for SessionRenewer<R, A, G, H>

fn clone(&self) -> SessionRenewer<R, A, G, H>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R: Debug, A: Debug, G: Debug, H: Debug> Debug for SessionRenewer<R, A, G, H>

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

Formats the value using the given formatter.