spikard 0.3.6 → 0.5.0

data/vendor/crates/spikard-bindings-shared/src/error_response.rs

@@ -0,0 +1,401 @@
+//! Shared error response formatting
+//!
+//! This module consolidates error response building across all language bindings,
+//! eliminating duplicate `structured_error()` functions in Node, Ruby, and PHP bindings.
+
+use axum::http::StatusCode;
+use serde_json::Value;
+use spikard_core::errors::StructuredError;
+use spikard_core::problem::ProblemDetails;
+use spikard_core::validation::ValidationError;
+
+/// Builder for creating standardized error responses across all bindings
+pub struct ErrorResponseBuilder;
+
+impl ErrorResponseBuilder {
+    /// Create a structured error response with status code and error details
+    ///
+    /// Returns a tuple of (StatusCode, JSON body as String)
+    ///
+    /// # Arguments
+    /// * `status` - HTTP status code
+    /// * `code` - Machine-readable error code
+    /// * `message` - Human-readable error message
+    ///
+    /// # Example
+    /// ```
+    /// use axum::http::StatusCode;
+    /// use spikard_bindings_shared::ErrorResponseBuilder;
+    ///
+    /// let (status, body) = ErrorResponseBuilder::structured_error(
+    ///     StatusCode::BAD_REQUEST,
+    ///     "invalid_input",
+    ///     "Missing required field",
+    /// );
+    /// ```
+    pub fn structured_error(status: StatusCode, code: &str, message: impl Into<String>) -> (StatusCode, String) {
+        let payload = StructuredError::simple(code.to_string(), message.into());
+        let body = serde_json::to_string(&payload)
+            .unwrap_or_else(|_| r#"{"error":"serialization_failed","code":"internal_error","details":{}}"#.to_string());
+        (status, body)
+    }
+
+    /// Create an error response with additional details
+    ///
+    /// Returns a tuple of (StatusCode, JSON body as String)
+    ///
+    /// # Arguments
+    /// * `status` - HTTP status code
+    /// * `code` - Machine-readable error code
+    /// * `message` - Human-readable error message
+    /// * `details` - Structured details about the error
+    ///
+    /// # Example
+    /// ```
+    /// use axum::http::StatusCode;
+    /// use serde_json::json;
+    /// use spikard_bindings_shared::ErrorResponseBuilder;
+    ///
+    /// let details = json!({
+    ///     "field": "email",
+    ///     "reason": "invalid_format"
+    /// });
+    /// let (status, body) = ErrorResponseBuilder::with_details(
+    ///     StatusCode::BAD_REQUEST,
+    ///     "validation_error",
+    ///     "Invalid email format",
+    ///     details,
+    /// );
+    /// ```
+    pub fn with_details(
+        status: StatusCode,
+        code: &str,
+        message: impl Into<String>,
+        details: Value,
+    ) -> (StatusCode, String) {
+        let payload = StructuredError::new(code.to_string(), message.into(), details);
+        let body = serde_json::to_string(&payload)
+            .unwrap_or_else(|_| r#"{"error":"serialization_failed","code":"internal_error","details":{}}"#.to_string());
+        (status, body)
+    }
+
+    /// Create an error response from a StructuredError
+    ///
+    /// Returns a tuple of (StatusCode, JSON body as String)
+    ///
+    /// # Arguments
+    /// * `error` - The structured error
+    ///
+    /// # Note
+    /// Uses INTERNAL_SERVER_ERROR as the default status code. Override with
+    /// `structured_error()` or `with_details()` for specific status codes.
+    pub fn from_structured_error(error: StructuredError) -> (StatusCode, String) {
+        let status = StatusCode::INTERNAL_SERVER_ERROR;
+        let body = serde_json::to_string(&error)
+            .unwrap_or_else(|_| r#"{"error":"serialization_failed","code":"internal_error","details":{}}"#.to_string());
+        (status, body)
+    }
+
+    /// Create a validation error response
+    ///
+    /// Converts ValidationError to RFC 9457 Problem Details format.
+    /// Returns (StatusCode::UNPROCESSABLE_ENTITY, JSON body)
+    ///
+    /// # Arguments
+    /// * `validation_error` - The validation error containing one or more details
+    ///
+    /// # Example
+    /// ```
+    /// use spikard_core::validation::{ValidationError, ValidationErrorDetail};
+    /// use serde_json::Value;
+    /// use spikard_bindings_shared::ErrorResponseBuilder;
+    ///
+    /// let validation_error = ValidationError {
+    ///     errors: vec![
+    ///         ValidationErrorDetail {
+    ///             error_type: "missing".to_string(),
+    ///             loc: vec!["body".to_string(), "username".to_string()],
+    ///             msg: "Field required".to_string(),
+    ///             input: Value::String("".to_string()),
+    ///             ctx: None,
+    ///         },
+    ///     ],
+    /// };
+    ///
+    /// let (status, body) = ErrorResponseBuilder::validation_error(&validation_error);
+    /// ```
+    pub fn validation_error(validation_error: &ValidationError) -> (StatusCode, String) {
+        let problem = ProblemDetails::from_validation_error(validation_error);
+        let status = problem.status_code();
+        let body = serde_json::to_string(&problem).unwrap_or_else(|_| {
+            r#"{"title":"Validation Failed","type":"https://spikard.dev/errors/validation-error","status":422}"#
+                .to_string()
+        });
+        (status, body)
+    }
+
+    /// Create an RFC 9457 Problem Details response
+    ///
+    /// Returns a tuple of (StatusCode, JSON body as String)
+    ///
+    /// # Arguments
+    /// * `problem` - The Problem Details object
+    ///
+    /// # Example
+    /// ```
+    /// use axum::http::StatusCode;
+    /// use spikard_core::problem::ProblemDetails;
+    /// use spikard_bindings_shared::ErrorResponseBuilder;
+    ///
+    /// let problem = ProblemDetails::not_found("User with id 123 not found");
+    /// let (status, body) = ErrorResponseBuilder::problem_details_response(&problem);
+    /// ```
+    pub fn problem_details_response(problem: &ProblemDetails) -> (StatusCode, String) {
+        let status = problem.status_code();
+        let body = serde_json::to_string(problem).unwrap_or_else(|_| {
+            r#"{"title":"Internal Server Error","type":"https://spikard.dev/errors/internal-server-error","status":500}"#
+                .to_string()
+        });
+        (status, body)
+    }
+
+    /// Create a generic bad request error
+    ///
+    /// Returns (StatusCode::BAD_REQUEST, JSON body)
+    pub fn bad_request(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::BAD_REQUEST, "bad_request", message)
+    }
+
+    /// Create a generic internal server error
+    ///
+    /// Returns (StatusCode::INTERNAL_SERVER_ERROR, JSON body)
+    pub fn internal_error(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::INTERNAL_SERVER_ERROR, "internal_error", message)
+    }
+
+    /// Create an unauthorized error
+    ///
+    /// Returns (StatusCode::UNAUTHORIZED, JSON body)
+    pub fn unauthorized(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::UNAUTHORIZED, "unauthorized", message)
+    }
+
+    /// Create a forbidden error
+    ///
+    /// Returns (StatusCode::FORBIDDEN, JSON body)
+    pub fn forbidden(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::FORBIDDEN, "forbidden", message)
+    }
+
+    /// Create a not found error
+    ///
+    /// Returns (StatusCode::NOT_FOUND, JSON body)
+    pub fn not_found(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::NOT_FOUND, "not_found", message)
+    }
+
+    /// Create a method not allowed error
+    ///
+    /// Returns (StatusCode::METHOD_NOT_ALLOWED, JSON body)
+    pub fn method_not_allowed(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::METHOD_NOT_ALLOWED, "method_not_allowed", message)
+    }
+
+    /// Create an unprocessable entity error (validation failed)
+    ///
+    /// Returns (StatusCode::UNPROCESSABLE_ENTITY, JSON body)
+    pub fn unprocessable_entity(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::UNPROCESSABLE_ENTITY, "unprocessable_entity", message)
+    }
+
+    /// Create a conflict error
+    ///
+    /// Returns (StatusCode::CONFLICT, JSON body)
+    pub fn conflict(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::CONFLICT, "conflict", message)
+    }
+
+    /// Create a service unavailable error
+    ///
+    /// Returns (StatusCode::SERVICE_UNAVAILABLE, JSON body)
+    pub fn service_unavailable(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::SERVICE_UNAVAILABLE, "service_unavailable", message)
+    }
+
+    /// Create a request timeout error
+    ///
+    /// Returns (StatusCode::REQUEST_TIMEOUT, JSON body)
+    pub fn request_timeout(message: impl Into<String>) -> (StatusCode, String) {
+        Self::structured_error(StatusCode::REQUEST_TIMEOUT, "request_timeout", message)
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde_json::json;
+    use spikard_core::validation::ValidationErrorDetail;
+
+    #[test]
+    fn test_structured_error() {
+        let (status, body) =
+            ErrorResponseBuilder::structured_error(StatusCode::BAD_REQUEST, "invalid_input", "Missing required field");
+        assert_eq!(status, StatusCode::BAD_REQUEST);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["error"], "Missing required field");
+        assert_eq!(parsed["code"], "invalid_input");
+        assert!(parsed["details"].is_object());
+    }
+
+    #[test]
+    fn test_with_details() {
+        let details = json!({
+            "field": "email",
+            "reason": "invalid_format"
+        });
+        let (status, body) = ErrorResponseBuilder::with_details(
+            StatusCode::BAD_REQUEST,
+            "validation_error",
+            "Invalid email format",
+            details.clone(),
+        );
+        assert_eq!(status, StatusCode::BAD_REQUEST);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "validation_error");
+        assert_eq!(parsed["error"], "Invalid email format");
+        assert_eq!(parsed["details"]["field"], "email");
+        assert_eq!(parsed["details"]["reason"], "invalid_format");
+    }
+
+    #[test]
+    fn test_from_structured_error() {
+        let error = StructuredError::simple("test_error", "Something went wrong");
+        let (status, body) = ErrorResponseBuilder::from_structured_error(error);
+        assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "test_error");
+        assert_eq!(parsed["error"], "Something went wrong");
+    }
+
+    #[test]
+    fn test_validation_error() {
+        let validation_error = ValidationError {
+            errors: vec![ValidationErrorDetail {
+                error_type: "missing".to_string(),
+                loc: vec!["body".to_string(), "username".to_string()],
+                msg: "Field required".to_string(),
+                input: Value::String("".to_string()),
+                ctx: None,
+            }],
+        };
+
+        let (status, body) = ErrorResponseBuilder::validation_error(&validation_error);
+        assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["title"], "Request Validation Failed");
+        assert_eq!(parsed["status"], 422);
+        assert!(parsed["errors"].is_array());
+    }
+
+    #[test]
+    fn test_problem_details_response() {
+        let problem = ProblemDetails::not_found("User with id 123 not found");
+        let (status, body) = ErrorResponseBuilder::problem_details_response(&problem);
+        assert_eq!(status, StatusCode::NOT_FOUND);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["type"], "https://spikard.dev/errors/not-found");
+        assert_eq!(parsed["title"], "Resource Not Found");
+        assert_eq!(parsed["status"], 404);
+    }
+
+    #[test]
+    fn test_bad_request() {
+        let (status, body) = ErrorResponseBuilder::bad_request("Invalid data");
+        assert_eq!(status, StatusCode::BAD_REQUEST);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "bad_request");
+        assert_eq!(parsed["error"], "Invalid data");
+    }
+
+    #[test]
+    fn test_internal_error() {
+        let (status, body) = ErrorResponseBuilder::internal_error("Something went wrong");
+        assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "internal_error");
+        assert_eq!(parsed["error"], "Something went wrong");
+    }
+
+    #[test]
+    fn test_unauthorized() {
+        let (status, body) = ErrorResponseBuilder::unauthorized("Authentication required");
+        assert_eq!(status, StatusCode::UNAUTHORIZED);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "unauthorized");
+    }
+
+    #[test]
+    fn test_forbidden() {
+        let (status, body) = ErrorResponseBuilder::forbidden("Access denied");
+        assert_eq!(status, StatusCode::FORBIDDEN);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "forbidden");
+    }
+
+    #[test]
+    fn test_not_found() {
+        let (status, body) = ErrorResponseBuilder::not_found("Resource not found");
+        assert_eq!(status, StatusCode::NOT_FOUND);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "not_found");
+    }
+
+    #[test]
+    fn test_method_not_allowed() {
+        let (status, body) = ErrorResponseBuilder::method_not_allowed("Method POST not allowed");
+        assert_eq!(status, StatusCode::METHOD_NOT_ALLOWED);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "method_not_allowed");
+    }
+
+    #[test]
+    fn test_unprocessable_entity() {
+        let (status, body) = ErrorResponseBuilder::unprocessable_entity("Validation failed");
+        assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "unprocessable_entity");
+    }
+
+    #[test]
+    fn test_conflict() {
+        let (status, body) = ErrorResponseBuilder::conflict("Resource already exists");
+        assert_eq!(status, StatusCode::CONFLICT);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "conflict");
+    }
+
+    #[test]
+    fn test_service_unavailable() {
+        let (status, body) = ErrorResponseBuilder::service_unavailable("Service temporarily unavailable");
+        assert_eq!(status, StatusCode::SERVICE_UNAVAILABLE);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "service_unavailable");
+    }
+
+    #[test]
+    fn test_request_timeout() {
+        let (status, body) = ErrorResponseBuilder::request_timeout("Request timed out");
+        assert_eq!(status, StatusCode::REQUEST_TIMEOUT);
+        let parsed: Value = serde_json::from_str(&body).unwrap();
+        assert_eq!(parsed["code"], "request_timeout");
+    }
+
+    #[test]
+    fn test_serialization_fallback() {
+        let details = serde_json::Map::new();
+        let (_status, body) =
+            ErrorResponseBuilder::with_details(StatusCode::BAD_REQUEST, "test", "Test error", Value::Object(details));
+
+        assert!(serde_json::from_str::<Value>(&body).is_ok());
+    }
+}

data/vendor/crates/spikard-bindings-shared/src/handler_base.rs

@@ -0,0 +1,238 @@
+//! Base handler traits and execution infrastructure
+//!
+//! This module provides language-agnostic handler execution patterns that
+//! eliminate duplicate code across Node, Ruby, PHP, and WASM bindings.
+
+use std::future::Future;
+use std::pin::Pin;
+use std::sync::Arc;
+
+use axum::body::Body;
+use axum::http::{Request, Response};
+use spikard_core::validation::{SchemaValidator, ValidationError};
+use spikard_http::Handler;
+use spikard_http::handler_trait::{HandlerResult, RequestData};
+
+use crate::error_response::ErrorResponseBuilder;
+
+/// Error type for handler operations
+#[derive(Debug, thiserror::Error)]
+pub enum HandlerError {
+    #[error("Validation error: {0}")]
+    Validation(String),
+
+    #[error("Handler execution error: {0}")]
+    Execution(String),
+
+    #[error("Response conversion error: {0}")]
+    ResponseConversion(String),
+
+    #[error("Internal error: {0}")]
+    Internal(String),
+}
+
+impl From<ValidationError> for HandlerError {
+    fn from(err: ValidationError) -> Self {
+        HandlerError::Validation(format!("{:?}", err))
+    }
+}
+
+/// Language-specific handler implementation
+///
+/// This trait defines the three key operations that every language binding must implement:
+/// 1. Prepare request data for the language runtime
+/// 2. Invoke the handler in the language runtime
+/// 3. Interpret the response from the language runtime
+///
+/// The `HandlerExecutor` handles all common logic (validation, error formatting)
+/// while delegating language-specific operations to implementations of this trait.
+pub trait LanguageHandler: Send + Sync {
+    /// Input type passed to the language handler
+    type Input: Send;
+
+    /// Output type returned from the language handler
+    type Output: Send;
+
+    /// Prepare request data for passing to the language handler
+    fn prepare_request(&self, request_data: &RequestData) -> Result<Self::Input, HandlerError>;
+
+    /// Invoke the language-specific handler with the prepared input
+    fn invoke_handler(
+        &self,
+        input: Self::Input,
+    ) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>>;
+
+    /// Interpret the handler's output and convert it to an HTTP response
+    fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError>;
+}
+
+/// Universal handler executor that works with any language binding
+///
+/// This struct consolidates the common handler execution flow:
+/// - Request body validation
+/// - Handler invocation
+/// - Error handling and formatting
+///
+/// Language bindings provide thin wrappers that implement `LanguageHandler`.
+pub struct HandlerExecutor<L: LanguageHandler> {
+    language_handler: Arc<L>,
+    request_validator: Option<Arc<SchemaValidator>>,
+}
+
+impl<L: LanguageHandler> HandlerExecutor<L> {
+    /// Create a new handler executor
+    pub fn new(language_handler: Arc<L>, request_validator: Option<Arc<SchemaValidator>>) -> Self {
+        Self {
+            language_handler,
+            request_validator,
+        }
+    }
+
+    /// Create a handler executor with only a language handler
+    pub fn with_handler(language_handler: Arc<L>) -> Self {
+        Self {
+            language_handler,
+            request_validator: None,
+        }
+    }
+
+    /// Add request validation to this executor
+    pub fn with_request_validator(mut self, validator: Arc<SchemaValidator>) -> Self {
+        self.request_validator = Some(validator);
+        self
+    }
+}
+
+impl<L: LanguageHandler + 'static> Handler for HandlerExecutor<L> {
+    fn call(
+        &self,
+        _request: Request<Body>,
+        request_data: RequestData,
+    ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
+        Box::pin(async move {
+            if let Some(validator) = &self.request_validator
+                && let Err(validation_err) = validator.validate(&request_data.body)
+            {
+                return Err(ErrorResponseBuilder::validation_error(&validation_err));
+            }
+
+            let input = self
+                .language_handler
+                .prepare_request(&request_data)
+                .map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to prepare request: {}", e)))?;
+
+            let output = self
+                .language_handler
+                .invoke_handler(input)
+                .await
+                .map_err(|e| ErrorResponseBuilder::internal_error(format!("Handler execution failed: {}", e)))?;
+
+            let response = self
+                .language_handler
+                .interpret_response(output)
+                .map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to interpret response: {}", e)))?;
+
+            Ok(response)
+        })
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde_json::json;
+
+    struct MockLanguageHandler;
+
+    impl LanguageHandler for MockLanguageHandler {
+        type Input = String;
+        type Output = String;
+
+        fn prepare_request(&self, _data: &RequestData) -> Result<Self::Input, HandlerError> {
+            Ok("test_input".to_string())
+        }
+
+        fn invoke_handler(
+            &self,
+            _input: Self::Input,
+        ) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>> {
+            Box::pin(async { Ok("test_output".to_string()) })
+        }
+
+        fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError> {
+            Ok(Response::builder().status(200).body(Body::from(output)).unwrap())
+        }
+    }
+
+    #[tokio::test]
+    async fn test_handler_executor_basic() {
+        let mock_handler = Arc::new(MockLanguageHandler);
+        let executor = HandlerExecutor::new(mock_handler, None);
+
+        let request = Request::builder().body(Body::empty()).unwrap();
+        let request_data = RequestData {
+            path_params: Arc::new(std::collections::HashMap::new()),
+            query_params: json!({}),
+            validated_params: None,
+            raw_query_params: Arc::new(std::collections::HashMap::new()),
+            body: json!({}),
+            raw_body: None,
+            headers: Arc::new(std::collections::HashMap::new()),
+            cookies: Arc::new(std::collections::HashMap::new()),
+            method: "GET".to_string(),
+            path: "/test".to_string(),
+            dependencies: None,
+        };
+
+        let result = executor.call(request, request_data).await;
+        assert!(result.is_ok());
+    }
+
+    #[tokio::test]
+    async fn test_handler_executor_with_handler_only() {
+        let mock_handler = Arc::new(MockLanguageHandler);
+        let executor = HandlerExecutor::with_handler(mock_handler);
+
+        let request = Request::builder().body(Body::empty()).unwrap();
+        let request_data = RequestData {
+            path_params: Arc::new(std::collections::HashMap::new()),
+            query_params: json!({}),
+            validated_params: None,
+            raw_query_params: Arc::new(std::collections::HashMap::new()),
+            body: json!({}),
+            raw_body: None,
+            headers: Arc::new(std::collections::HashMap::new()),
+            cookies: Arc::new(std::collections::HashMap::new()),
+            method: "GET".to_string(),
+            path: "/test".to_string(),
+            dependencies: None,
+        };
+
+        let result = executor.call(request, request_data).await;
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_handler_error_validation() {
+        let err = HandlerError::Validation("test error".to_string());
+        assert_eq!(err.to_string(), "Validation error: test error");
+    }
+
+    #[test]
+    fn test_handler_error_execution() {
+        let err = HandlerError::Execution("test error".to_string());
+        assert_eq!(err.to_string(), "Handler execution error: test error");
+    }
+
+    #[test]
+    fn test_handler_error_response_conversion() {
+        let err = HandlerError::ResponseConversion("test error".to_string());
+        assert_eq!(err.to_string(), "Response conversion error: test error");
+    }
+
+    #[test]
+    fn test_handler_error_internal() {
+        let err = HandlerError::Internal("test error".to_string());
+        assert_eq!(err.to_string(), "Internal error: test error");
+    }
+}

data/vendor/crates/spikard-bindings-shared/src/lib.rs

@@ -0,0 +1,24 @@
+//! Shared utilities for language bindings
+//!
+//! This crate provides common functionality used across all language bindings
+//! (Python, Node.js, Ruby, PHP, WASM) to eliminate code duplication and ensure
+//! consistent behavior.
+
+pub mod config_extractor;
+pub mod conversion_traits;
+pub mod di_traits;
+pub mod error_response;
+pub mod handler_base;
+pub mod lifecycle_base;
+pub mod lifecycle_executor;
+pub mod response_builder;
+pub mod test_client_base;
+pub mod validation_helpers;
+
+pub use config_extractor::{ConfigExtractor, ConfigSource};
+pub use di_traits::{FactoryDependencyAdapter, ValueDependencyAdapter};
+pub use error_response::ErrorResponseBuilder;
+pub use handler_base::{HandlerError, HandlerExecutor, LanguageHandler};
+pub use lifecycle_executor::{
+    HookResultData, LanguageLifecycleHook, LifecycleExecutor, RequestModifications, extract_body,
+};