modo-rs 0.6.2

//! # Session
//!
//! Database-backed HTTP session management.
//!
//! Sessions are stored in a SQLite table (`sessions`) and identified by a
//! signed, opaque cookie. The middleware handles the full request/response
//! lifecycle: reading the session token from the cookie on the request path,
//! loading and fingerprint-validating the session, running the handler, and
//! then flushing dirty data or touching the expiry timestamp before writing the
//! `Set-Cookie` header on the response path.
//!
//! Requires the **`session`** feature flag (transitively enables `db`).
//!
//! # Provides
//!
//! - [`SessionConfig`] — deserialised session configuration (TTL, cookie name, limits).
//! - [`Session`] — axum extractor; primary API for handlers.
//! - [`SessionData`] — snapshot of a session row returned from the database.
//! - [`SessionToken`] — opaque 32-byte random token; redacted in `Debug`/`Display`.
//! - [`Store`] — low-level SQLite store; use directly for background jobs.
//! - [`SessionLayer`] — Tower layer; apply to a `Router` to enable session support.
//! - [`layer`] — convenience constructor for [`SessionLayer`].
//! - [`device`] — user-agent parsing helpers for device classification.
//! - [`fingerprint`] — browser fingerprinting for session hijacking detection.
//! - [`meta`] — request metadata ([`meta::SessionMeta`]) and [`meta::header_str`] helper.
//!
//! # Quick start
//!
//! ```rust,no_run
//! use modo::session::{self, SessionConfig, Store};
//! use modo::cookie::{CookieConfig, key_from_config};
//! use modo::db::Database;
//!
//! async fn build_app(
//!     db: Database,
//!     session_cfg: SessionConfig,
//!     cookie_cfg: CookieConfig,
//! ) -> modo::Result<axum::Router> {
//!     let key = key_from_config(&cookie_cfg)?;
//!     let store = Store::new(db, session_cfg);
//!     let session_layer = session::layer(store, &cookie_cfg, &key);
//!
//!     let router = axum::Router::new()
//!         // .route(...)
//!         .layer(session_layer);
//!
//!     Ok(router)
//! }
//! ```

mod config;
pub mod device;
mod extractor;
pub mod fingerprint;
pub mod meta;
mod middleware;
mod store;
mod token;

pub use config::SessionConfig;
pub use extractor::Session;
#[cfg(feature = "templates")]
pub(crate) use extractor::SessionState;
pub use middleware::SessionLayer;
pub use middleware::layer;
pub use store::{SessionData, Store};
pub use token::SessionToken;