Struct RenewalManager 

pub struct RenewalManager { /* private fields */ }

Callback invoked by the manager to actually perform a renewal.

The manager itself does not hold lease objects; callers provide a renew_fn closure to tick_with that performs the renewal and returns the new expires_at timestamp on success.

Alternatively, use tick for a simpler API that auto-renews by extending expires_at by policy.min_renew_secs.

Implementations

impl RenewalManager

pub fn new() -> Self

Create an empty manager with no registered leases.

pub fn register( &mut self, lease_id: u128, expires_at: u64, policy: RenewalPolicy, )

Register a lease for managed renewal.

created_at is inferred as expires_at - policy.min_renew_secs (clamped to 0). For precise control, use register_with_created_at.

pub fn register_with_created_at( &mut self, lease_id: u128, created_at: u64, expires_at: u64, policy: RenewalPolicy, )

Register a lease with an explicit creation timestamp.

pub fn unregister(&mut self, lease_id: u128)

Unregister a lease.

pub fn len(&self) -> usize

Number of leases currently managed.

pub fn is_empty(&self) -> bool

Returns true if no leases are managed.

pub fn tick(&mut self, now_unix_secs: u64) -> RenewalSummary

Drive renewals using a simple model: if a lease is due, extend expires_at by policy.min_renew_secs. This is suitable when the manager owns the lease state (e.g. testing or self-contained use).

pub fn tick_with<F>( &mut self, now_unix_secs: u64, renew_fn: F, ) -> RenewalSummary

where F: FnMut(u128, u64) -> Result<u64, ()>,

Drive renewals with a caller-provided renewal function.

renew_fn(lease_id, duration_secs) should attempt the actual renewal and return the new expires_at on success, or an error.

pub fn is_near_expiry(&self, lease_id: u128, now: u64) -> bool

Returns true if the given lease is near expiry (< 10% TTL remaining).

pub fn on_revoked<F: Fn(u128, u8) + 'static>(&mut self, callback: F)

Register a callback invoked when a lease is revoked (e.g. via WITHDRAW cleanup or REVOKE_BROADCAST).

The callback receives the lease ID and a reason code (0 = unknown/timeout).

pub fn notify_revoked(&self, lease_id: u128, reason: u8)

Notify all registered revocation callbacks for the given lease.

reason is the WITHDRAW reason code (0 = timeout/unknown).

pub fn expires_at(&self, lease_id: u128) -> Option<u64>

Returns the current expires_at for a managed lease, if registered.

Trait Implementations

impl Default for RenewalManager

fn default() -> Self

Returns the “default value” for a type.