Struct LifecycleDeviceResolver 

pub struct LifecycleDeviceResolver<E, S, C>
where
    E: DeviceFingerprintExtractor,
    S: DeviceStore,
    C: Clock,
{ /* private fields */ }

Available on crate feature device only.

Built-in DeviceResolver composing DeviceFingerprintExtractor + DeviceLifecycleService with the four pluggable hooks documented in the module-level docs.

Cheap to clone (every field is Arc or Clone); construct once at startup, hand to SessionLayer::with_device_resolver.

Implementations

impl<E, S, C> LifecycleDeviceResolver<E, S, C>

where E: DeviceFingerprintExtractor, S: DeviceStore, C: Clock,

pub fn new(extractor: E, lifecycle: DeviceLifecycleService<S>, clock: C) -> Self

Construct with the three required collaborators and the documented defaults for the four pluggable hooks. Override any of them with with_tenant_fn / with_client_ip_fn / with_user_fn / with_new_id_fn before passing the resolver to the session layer.

pub fn with_tenant_fn<F>(self, f: F) -> Self

where F: Fn(&Parts) -> Option<TenantId> + Send + Sync + 'static,

Override the tenant-extraction strategy.

pub fn with_client_ip_fn<F>(self, f: F) -> Self

where F: Fn(&Parts) -> Option<IpAddr> + Send + Sync + 'static,

Override the client-IP extraction strategy.

pub fn with_user_fn<F>(self, f: F) -> Self

where F: Fn(&Parts) -> Option<UserId> + Send + Sync + 'static,

Override the user-extraction strategy. Useful when an upstream auth layer has already injected a UserId into the request extensions and you want the device’s user_id field populated at creation time. (Without this, devices are created at user_id = None and become “owned” only when the application updates them post-authn.)

pub fn with_new_id_fn<F>(self, f: F) -> Self

where F: Fn() -> DeviceId + Send + Sync + 'static,

Override the new-id minting strategy. Default uses uuid::Uuid::new_v4(). Override for DST tests to inject a deterministic generator.

Trait Implementations

impl<E, S, C> Clone for LifecycleDeviceResolver<E, S, C>

where E: DeviceFingerprintExtractor, S: DeviceStore, C: Clock,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E, S, C> DeviceResolver for LifecycleDeviceResolver<E, S, C>

where E: DeviceFingerprintExtractor, S: DeviceStore, C: Clock,

type Error = <S as DeviceStore>::Error

Storage / configuration error type; typically the DeviceStore::Error of the underlying store.

async fn resolve(&self, parts: &Parts) -> Result<Option<DeviceId>, Self::Error>

Resolve the device for parts. Always best-effort: returning Ok(None) is the documented “no device” outcome; the layer never fails the request on Err(_).