turul-http-mcp-server 0.3.47

//! Middleware system for MCP servers
//!
//! This module provides a trait-based middleware architecture that allows intercepting
//! and modifying MCP requests and responses. Middleware can be used for authentication,
//! logging, rate limiting, and custom business logic.
//!
//! # Overview
//!
//! The middleware system consists of:
//! - [`McpMiddleware`] - Core trait for implementing middleware
//! - [`RequestContext`] - Normalized request context across transports
//! - [`SessionInjection`] - Write-only mechanism for populating session state
//! - [`MiddlewareStack`] - Ordered execution of multiple middleware layers
//!
//! # Examples
//!
//! ```rust,no_run
//! use turul_http_mcp_server::middleware::{McpMiddleware, RequestContext, SessionInjection, MiddlewareError};
//! use turul_mcp_session_storage::SessionView;
//! use async_trait::async_trait;
//!
//! // Define custom middleware
//! struct LoggingMiddleware;
//!
//! #[async_trait]
//! impl McpMiddleware for LoggingMiddleware {
//!     async fn before_dispatch(
//!         &self,
//!         ctx: &mut RequestContext<'_>,
//!         _session: Option<&dyn SessionView>,
//!         _injection: &mut SessionInjection,
//!     ) -> Result<(), MiddlewareError> {
//!         println!("Request: {}", ctx.method());
//!         Ok(())
//!     }
//! }
//! ```

pub mod bearer;
pub mod builtins;
pub mod context;
pub mod error;
pub mod session_view_adapter;
pub mod stack;
pub mod traits;

pub use bearer::{extract_bearer_token, is_bearer_scheme};
pub use context::{DispatcherResult, RequestContext, SessionInjection};
pub use error::{MiddlewareError, error_codes};
pub use session_view_adapter::StorageBackedSessionView;
pub use stack::MiddlewareStack;
pub use traits::McpMiddleware;