spikard 0.2.5 → 0.3.1

data/vendor/crates/spikard-http/src/lib.rs

@@ -1,529 +0,0 @@
-//! Spikard HTTP Server
-//!
-//! Pure Rust HTTP server with language-agnostic handler trait.
-//! Language bindings (Python, Node, WASM) implement the Handler trait.
-
-pub mod auth;
-pub mod background;
-pub mod bindings;
-pub mod body_metadata;
-pub mod cors;
-pub mod debug;
-#[cfg(feature = "di")]
-pub mod di_handler;
-pub mod handler_response;
-pub mod handler_trait;
-pub mod lifecycle;
-pub mod middleware;
-pub mod openapi;
-pub mod parameters;
-pub mod problem;
-pub mod query_parser;
-pub mod response;
-pub mod router;
-pub mod schema_registry;
-pub mod server;
-pub mod sse;
-pub mod testing;
-pub mod type_hints;
-pub mod validation;
-pub mod websocket;
-
-use serde::{Deserialize, Serialize};
-
-#[cfg(test)]
-mod handler_trait_tests;
-
-pub use auth::{Claims, api_key_auth_middleware, jwt_auth_middleware};
-pub use background::{
-    BackgroundHandle, BackgroundJobError, BackgroundJobMetadata, BackgroundRuntime, BackgroundSpawnError,
-    BackgroundTaskConfig,
-};
-pub use body_metadata::ResponseBodySize;
-#[cfg(feature = "di")]
-pub use di_handler::DependencyInjectingHandler;
-pub use handler_response::HandlerResponse;
-pub use handler_trait::{Handler, HandlerResult, RequestData, ValidatedParams};
-pub use lifecycle::{HookResult, LifecycleHook, LifecycleHooks, LifecycleHooksBuilder, request_hook, response_hook};
-pub use openapi::{ContactInfo, LicenseInfo, OpenApiConfig, SecuritySchemeInfo, ServerInfo};
-pub use parameters::ParameterValidator;
-pub use problem::{CONTENT_TYPE_PROBLEM_JSON, ProblemDetails};
-pub use response::Response;
-pub use router::{Route, RouteHandler, Router};
-pub use schema_registry::SchemaRegistry;
-pub use server::Server;
-pub use spikard_core::{CompressionConfig, CorsConfig, Method, RateLimitConfig, RouteMetadata};
-pub use sse::{SseEvent, SseEventProducer, SseState, sse_handler};
-pub use testing::{ResponseSnapshot, SnapshotError, snapshot_response};
-pub use validation::SchemaValidator;
-pub use websocket::{WebSocketHandler, WebSocketState, websocket_handler};
-
-/// JWT authentication configuration
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct JwtConfig {
-    /// Secret key for JWT verification
-    pub secret: String,
-    /// Required algorithm (HS256, HS384, HS512, RS256, etc.)
-    #[serde(default = "default_jwt_algorithm")]
-    pub algorithm: String,
-    /// Required audience claim
-    pub audience: Option<Vec<String>>,
-    /// Required issuer claim
-    pub issuer: Option<String>,
-    /// Leeway for expiration checks (seconds)
-    #[serde(default)]
-    pub leeway: u64,
-}
-
-fn default_jwt_algorithm() -> String {
-    "HS256".to_string()
-}
-
-/// API Key authentication configuration
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct ApiKeyConfig {
-    /// Valid API keys
-    pub keys: Vec<String>,
-    /// Header name to check (e.g., "X-API-Key")
-    #[serde(default = "default_api_key_header")]
-    pub header_name: String,
-}
-
-fn default_api_key_header() -> String {
-    "X-API-Key".to_string()
-}
-
-/// Static file serving configuration
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct StaticFilesConfig {
-    /// Directory path to serve
-    pub directory: String,
-    /// URL path prefix (e.g., "/static")
-    pub route_prefix: String,
-    /// Fallback to index.html for directories
-    #[serde(default = "default_true")]
-    pub index_file: bool,
-    /// Cache-Control header value
-    pub cache_control: Option<String>,
-}
-
-/// Server configuration
-#[derive(Debug, Clone)]
-pub struct ServerConfig {
-    /// Host to bind to
-    pub host: String,
-    /// Port to bind to
-    pub port: u16,
-    /// Number of worker threads (unused with tokio)
-    pub workers: usize,
-
-    /// Enable request ID generation and propagation
-    pub enable_request_id: bool,
-    /// Maximum request body size in bytes (None = unlimited, not recommended)
-    pub max_body_size: Option<usize>,
-    /// Request timeout in seconds (None = no timeout)
-    pub request_timeout: Option<u64>,
-    /// Enable compression middleware
-    pub compression: Option<CompressionConfig>,
-    /// Enable rate limiting
-    pub rate_limit: Option<RateLimitConfig>,
-    /// JWT authentication configuration
-    pub jwt_auth: Option<JwtConfig>,
-    /// API Key authentication configuration
-    pub api_key_auth: Option<ApiKeyConfig>,
-    /// Static file serving configuration
-    pub static_files: Vec<StaticFilesConfig>,
-    /// Enable graceful shutdown on SIGTERM/SIGINT
-    pub graceful_shutdown: bool,
-    /// Graceful shutdown timeout (seconds)
-    pub shutdown_timeout: u64,
-    /// OpenAPI documentation configuration
-    pub openapi: Option<crate::openapi::OpenApiConfig>,
-    /// Lifecycle hooks for request/response processing
-    pub lifecycle_hooks: Option<std::sync::Arc<LifecycleHooks>>,
-    /// Background task executor configuration
-    pub background_tasks: BackgroundTaskConfig,
-    /// Dependency injection container (requires 'di' feature)
-    #[cfg(feature = "di")]
-    pub di_container: Option<std::sync::Arc<spikard_core::di::DependencyContainer>>,
-}
-
-impl Default for ServerConfig {
-    fn default() -> Self {
-        Self {
-            host: "127.0.0.1".to_string(),
-            port: 8000,
-            workers: 1,
-            enable_request_id: true,
-            max_body_size: Some(10 * 1024 * 1024),
-            request_timeout: Some(30),
-            compression: Some(CompressionConfig::default()),
-            rate_limit: None,
-            jwt_auth: None,
-            api_key_auth: None,
-            static_files: Vec::new(),
-            graceful_shutdown: true,
-            shutdown_timeout: 30,
-            openapi: None,
-            lifecycle_hooks: None,
-            background_tasks: BackgroundTaskConfig::default(),
-            #[cfg(feature = "di")]
-            di_container: None,
-        }
-    }
-}
-
-impl ServerConfig {
-    /// Create a new builder for ServerConfig
-    ///
-    /// # Example
-    ///
-    /// ```ignorerust
-    /// use spikard_http::ServerConfig;
-    ///
-    /// let config = ServerConfig::builder()
-    ///     .port(3000)
-    ///     .host("0.0.0.0")
-    ///     .build();
-    /// ```
-    pub fn builder() -> ServerConfigBuilder {
-        ServerConfigBuilder::default()
-    }
-}
-
-/// Builder for ServerConfig
-///
-/// Provides a fluent API for configuring a Spikard server with dependency injection support.
-///
-/// # Dependency Injection
-///
-/// The builder provides methods to register dependencies that will be injected into handlers:
-///
-/// ```ignorerust
-/// # #[cfg(feature = "di")]
-/// # {
-/// use spikard_http::ServerConfig;
-/// use std::sync::Arc;
-///
-/// let config = ServerConfig::builder()
-///     .port(3000)
-///     .provide_value("app_name", "MyApp".to_string())
-///     .provide_value("max_connections", 100)
-///     .build();
-/// # }
-/// ```
-///
-/// For factory dependencies that create values on-demand:
-///
-/// ```ignorerust
-/// # #[cfg(feature = "di")]
-/// # {
-/// use spikard_http::ServerConfig;
-///
-/// let config = ServerConfig::builder()
-///     .port(3000)
-///     .provide_value("db_url", "postgresql://localhost/mydb".to_string())
-///     .build();
-/// # }
-/// ```
-#[derive(Debug, Clone, Default)]
-pub struct ServerConfigBuilder {
-    config: ServerConfig,
-}
-
-impl ServerConfigBuilder {
-    /// Set the host address to bind to
-    pub fn host(mut self, host: impl Into<String>) -> Self {
-        self.config.host = host.into();
-        self
-    }
-
-    /// Set the port to bind to
-    pub fn port(mut self, port: u16) -> Self {
-        self.config.port = port;
-        self
-    }
-
-    /// Set the number of worker threads (unused with tokio, kept for compatibility)
-    pub fn workers(mut self, workers: usize) -> Self {
-        self.config.workers = workers;
-        self
-    }
-
-    /// Enable or disable request ID generation and propagation
-    pub fn enable_request_id(mut self, enable: bool) -> Self {
-        self.config.enable_request_id = enable;
-        self
-    }
-
-    /// Set maximum request body size in bytes (None = unlimited, not recommended)
-    pub fn max_body_size(mut self, size: Option<usize>) -> Self {
-        self.config.max_body_size = size;
-        self
-    }
-
-    /// Set request timeout in seconds (None = no timeout)
-    pub fn request_timeout(mut self, timeout: Option<u64>) -> Self {
-        self.config.request_timeout = timeout;
-        self
-    }
-
-    /// Set compression configuration
-    pub fn compression(mut self, compression: Option<CompressionConfig>) -> Self {
-        self.config.compression = compression;
-        self
-    }
-
-    /// Set rate limiting configuration
-    pub fn rate_limit(mut self, rate_limit: Option<RateLimitConfig>) -> Self {
-        self.config.rate_limit = rate_limit;
-        self
-    }
-
-    /// Set JWT authentication configuration
-    pub fn jwt_auth(mut self, jwt_auth: Option<JwtConfig>) -> Self {
-        self.config.jwt_auth = jwt_auth;
-        self
-    }
-
-    /// Set API key authentication configuration
-    pub fn api_key_auth(mut self, api_key_auth: Option<ApiKeyConfig>) -> Self {
-        self.config.api_key_auth = api_key_auth;
-        self
-    }
-
-    /// Add static file serving configuration
-    pub fn static_files(mut self, static_files: Vec<StaticFilesConfig>) -> Self {
-        self.config.static_files = static_files;
-        self
-    }
-
-    /// Add a single static file serving configuration
-    pub fn add_static_files(mut self, static_file: StaticFilesConfig) -> Self {
-        self.config.static_files.push(static_file);
-        self
-    }
-
-    /// Enable or disable graceful shutdown on SIGTERM/SIGINT
-    pub fn graceful_shutdown(mut self, enable: bool) -> Self {
-        self.config.graceful_shutdown = enable;
-        self
-    }
-
-    /// Set graceful shutdown timeout in seconds
-    pub fn shutdown_timeout(mut self, timeout: u64) -> Self {
-        self.config.shutdown_timeout = timeout;
-        self
-    }
-
-    /// Set OpenAPI documentation configuration
-    pub fn openapi(mut self, openapi: Option<crate::openapi::OpenApiConfig>) -> Self {
-        self.config.openapi = openapi;
-        self
-    }
-
-    /// Set lifecycle hooks for request/response processing
-    pub fn lifecycle_hooks(mut self, hooks: Option<std::sync::Arc<LifecycleHooks>>) -> Self {
-        self.config.lifecycle_hooks = hooks;
-        self
-    }
-
-    /// Set background task executor configuration
-    pub fn background_tasks(mut self, config: BackgroundTaskConfig) -> Self {
-        self.config.background_tasks = config;
-        self
-    }
-
-    /// Register a value dependency (like Fastify decorate)
-    ///
-    /// Value dependencies are static values that are cloned when injected into handlers.
-    /// Use this for configuration objects, constants, or small shared state.
-    ///
-    /// # Example
-    ///
-    /// ```ignorerust
-    /// # #[cfg(feature = "di")]
-    /// # {
-    /// use spikard_http::ServerConfig;
-    ///
-    /// let config = ServerConfig::builder()
-    ///     .provide_value("app_name", "MyApp".to_string())
-    ///     .provide_value("version", "1.0.0".to_string())
-    ///     .provide_value("max_connections", 100)
-    ///     .build();
-    /// # }
-    /// ```
-    #[cfg(feature = "di")]
-    pub fn provide_value<T: Clone + Send + Sync + 'static>(mut self, key: impl Into<String>, value: T) -> Self {
-        use spikard_core::di::{DependencyContainer, ValueDependency};
-        use std::sync::Arc;
-
-        let key_str = key.into();
-
-        // Get or create DI container (mutable)
-        let container = if let Some(container) = self.config.di_container.take() {
-            // Try to get mutable access - this will only work if we're the only owner
-            Arc::try_unwrap(container).unwrap_or_else(|_arc| {
-                // If we can't unwrap, we lose existing dependencies
-                // This is a fallback that shouldn't happen in normal builder usage (linear chaining)
-                DependencyContainer::new()
-            })
-        } else {
-            DependencyContainer::new()
-        };
-
-        let mut container = container;
-
-        // Create ValueDependency
-        let dep = ValueDependency::new(key_str.clone(), value);
-
-        // Register (panic on error for builder pattern)
-        container
-            .register(key_str, Arc::new(dep))
-            .expect("Failed to register dependency");
-
-        self.config.di_container = Some(Arc::new(container));
-        self
-    }
-
-    /// Register a factory dependency (like Litestar Provide)
-    ///
-    /// Factory dependencies create values on-demand, optionally depending on other
-    /// registered dependencies. Factories are async and have access to resolved dependencies.
-    ///
-    /// # Type Parameters
-    ///
-    /// * `F` - Factory function type
-    /// * `Fut` - Future returned by the factory
-    /// * `T` - Type of value produced by the factory
-    ///
-    /// # Arguments
-    ///
-    /// * `key` - Unique identifier for this dependency
-    /// * `factory` - Async function that creates the dependency value
-    ///
-    /// # Example
-    ///
-    /// ```ignorerust
-    /// # #[cfg(feature = "di")]
-    /// # {
-    /// use spikard_http::ServerConfig;
-    /// use std::sync::Arc;
-    ///
-    /// let config = ServerConfig::builder()
-    ///     .provide_value("db_url", "postgresql://localhost/mydb".to_string())
-    ///     .provide_factory("db_pool", |resolved| async move {
-    ///         let url: Arc<String> = resolved.get("db_url").ok_or("Missing db_url")?;
-    ///         // Create database pool...
-    ///         Ok(format!("Pool: {}", url))
-    ///     })
-    ///     .build();
-    /// # }
-    /// ```
-    #[cfg(feature = "di")]
-    pub fn provide_factory<F, Fut, T>(mut self, key: impl Into<String>, factory: F) -> Self
-    where
-        F: Fn(&spikard_core::di::ResolvedDependencies) -> Fut + Send + Sync + Clone + 'static,
-        Fut: std::future::Future<Output = Result<T, String>> + Send + 'static,
-        T: Send + Sync + 'static,
-    {
-        use futures::future::BoxFuture;
-        use spikard_core::di::{DependencyContainer, DependencyError, FactoryDependency};
-        use std::sync::Arc;
-
-        let key_str = key.into();
-
-        // Get or create DI container (mutable)
-        let container = if let Some(container) = self.config.di_container.take() {
-            Arc::try_unwrap(container).unwrap_or_else(|_| DependencyContainer::new())
-        } else {
-            DependencyContainer::new()
-        };
-
-        let mut container = container;
-
-        // Clone factory for the closure
-        let factory_clone = factory.clone();
-
-        // Create FactoryDependency using builder
-        let dep = FactoryDependency::builder(key_str.clone())
-            .factory(
-                move |_req: &axum::http::Request<()>,
-                      _data: &spikard_core::RequestData,
-                      resolved: &spikard_core::di::ResolvedDependencies| {
-                    let factory = factory_clone.clone();
-                    let factory_result = factory(resolved);
-                    Box::pin(async move {
-                        let result = factory_result
-                            .await
-                            .map_err(|e| DependencyError::ResolutionFailed { message: e })?;
-                        Ok(Arc::new(result) as Arc<dyn std::any::Any + Send + Sync>)
-                    })
-                        as BoxFuture<'static, Result<Arc<dyn std::any::Any + Send + Sync>, DependencyError>>
-                },
-            )
-            .build();
-
-        container
-            .register(key_str, Arc::new(dep))
-            .expect("Failed to register dependency");
-
-        self.config.di_container = Some(Arc::new(container));
-        self
-    }
-
-    /// Register a dependency with full control (advanced API)
-    ///
-    /// This method allows you to register custom dependency implementations
-    /// that implement the `Dependency` trait. Use this for advanced use cases
-    /// where you need fine-grained control over dependency resolution.
-    ///
-    /// # Example
-    ///
-    /// ```ignorerust
-    /// # #[cfg(feature = "di")]
-    /// # {
-    /// use spikard_http::ServerConfig;
-    /// use spikard_core::di::ValueDependency;
-    /// use std::sync::Arc;
-    ///
-    /// let dep = ValueDependency::new("custom", "value".to_string());
-    ///
-    /// let config = ServerConfig::builder()
-    ///     .provide(Arc::new(dep))
-    ///     .build();
-    /// # }
-    /// ```
-    #[cfg(feature = "di")]
-    pub fn provide(mut self, dependency: std::sync::Arc<dyn spikard_core::di::Dependency>) -> Self {
-        use spikard_core::di::DependencyContainer;
-        use std::sync::Arc;
-
-        let key = dependency.key().to_string();
-
-        // Get or create DI container (mutable)
-        let container = if let Some(container) = self.config.di_container.take() {
-            Arc::try_unwrap(container).unwrap_or_else(|_| DependencyContainer::new())
-        } else {
-            DependencyContainer::new()
-        };
-
-        let mut container = container;
-
-        container
-            .register(key, dependency)
-            .expect("Failed to register dependency");
-
-        self.config.di_container = Some(Arc::new(container));
-        self
-    }
-
-    /// Build the ServerConfig
-    pub fn build(self) -> ServerConfig {
-        self.config
-    }
-}
-
-const fn default_true() -> bool {
-    true
-}

data/vendor/crates/spikard-http/src/lifecycle/adapter.rs

@@ -1,149 +0,0 @@
-//! Shared utilities for lifecycle hook implementations across language bindings.
-//!
-//! This module provides common error messages, hook registration patterns, and
-//! serialization utilities to eliminate duplication across Python, Node.js,
-//! Ruby, and WASM bindings.
-
-use crate::lifecycle::LifecycleHook;
-use axum::body::Body;
-use axum::http::{Request, Response};
-use std::sync::Arc;
-
-/// Standard error message formatters for lifecycle hooks.
-/// These are used consistently across all language bindings.
-pub mod error {
-    use std::fmt::Display;
-
-    /// Format error when a hook invocation fails
-    pub fn call_failed(hook_name: &str, reason: impl Display) -> String {
-        format!("Hook '{}' call failed: {}", hook_name, reason)
-    }
-
-    /// Format error when a task execution fails (tokio/threading)
-    pub fn task_error(hook_name: &str, reason: impl Display) -> String {
-        format!("Hook '{}' task error: {}", hook_name, reason)
-    }
-
-    /// Format error when a promise/future fails
-    pub fn promise_failed(hook_name: &str, reason: impl Display) -> String {
-        format!("Hook '{}' promise failed: {}", hook_name, reason)
-    }
-
-    /// Format error for Python-specific failures
-    pub fn python_error(hook_name: &str, reason: impl Display) -> String {
-        format!("Hook '{}' Python error: {}", hook_name, reason)
-    }
-
-    /// Format error when body reading fails
-    pub fn body_read_failed(direction: &str, reason: impl Display) -> String {
-        format!("Failed to read {} body: {}", direction, reason)
-    }
-
-    /// Format error when body writing fails
-    pub fn body_write_failed(reason: impl Display) -> String {
-        format!("Failed to write body: {}", reason)
-    }
-
-    /// Format error for serialization failures
-    pub fn serialize_failed(context: &str, reason: impl Display) -> String {
-        format!("Failed to serialize {}: {}", context, reason)
-    }
-
-    /// Format error for deserialization failures
-    pub fn deserialize_failed(context: &str, reason: impl Display) -> String {
-        format!("Failed to deserialize {}: {}", context, reason)
-    }
-
-    /// Format error when building HTTP objects fails
-    pub fn build_failed(what: &str, reason: impl Display) -> String {
-        format!("Failed to build {}: {}", what, reason)
-    }
-}
-
-/// Utilities for serializing/deserializing request and response bodies
-pub mod serial {
-    use super::*;
-
-    /// Extract body bytes from an axum Body
-    pub async fn extract_body(body: Body) -> Result<bytes::Bytes, String> {
-        use axum::body::to_bytes;
-        to_bytes(body, usize::MAX)
-            .await
-            .map_err(|e| error::body_read_failed("request/response", e))
-    }
-
-    /// Create a JSON-formatted response body
-    pub fn json_response_body(json: &serde_json::Value) -> Result<Body, String> {
-        serde_json::to_string(json)
-            .map(Body::from)
-            .map_err(|e| error::serialize_failed("response JSON", e))
-    }
-
-    /// Parse a JSON value from bytes
-    pub fn parse_json(bytes: &[u8]) -> Result<serde_json::Value, String> {
-        if bytes.is_empty() {
-            return Ok(serde_json::Value::Null);
-        }
-        serde_json::from_slice(bytes)
-            .or_else(|_| Ok(serde_json::Value::String(String::from_utf8_lossy(bytes).to_string())))
-    }
-}
-
-/// Re-export of the HTTP-specific lifecycle hooks type alias
-pub use super::LifecycleHooks as HttpLifecycleHooks;
-
-/// Helper for registering hooks with standard naming conventions
-pub struct HookRegistry;
-
-impl HookRegistry {
-    /// Extract hooks from a configuration and register them with a naming pattern
-    /// Used by bindings to standardize hook naming (e.g., "on_request_hook_0")
-    pub fn register_from_list<F>(
-        hooks: &mut HttpLifecycleHooks,
-        hook_list: Vec<Arc<dyn LifecycleHook<Request<Body>, Response<Body>>>>,
-        _hook_type: &str,
-        register_fn: F,
-    ) where
-        F: Fn(&mut HttpLifecycleHooks, Arc<dyn LifecycleHook<Request<Body>, Response<Body>>>),
-    {
-        for hook in hook_list {
-            register_fn(hooks, hook);
-        }
-    }
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn test_error_messages() {
-        let call_err = error::call_failed("test_hook", "test reason");
-        assert!(call_err.contains("test_hook"));
-        assert!(call_err.contains("test reason"));
-
-        let task_err = error::task_error("task_hook", "spawn failed");
-        assert!(task_err.contains("task_hook"));
-
-        let promise_err = error::promise_failed("promise_hook", "rejected");
-        assert!(promise_err.contains("promise_hook"));
-    }
-
-    #[test]
-    fn test_body_error_messages() {
-        let read_err = error::body_read_failed("request", "stream closed");
-        assert!(read_err.contains("request"));
-
-        let write_err = error::body_write_failed("allocation failed");
-        assert!(write_err.contains("allocation"));
-    }
-
-    #[test]
-    fn test_json_error_messages() {
-        let ser_err = error::serialize_failed("request body", "invalid type");
-        assert!(ser_err.contains("request body"));
-
-        let deser_err = error::deserialize_failed("response", "malformed");
-        assert!(deser_err.contains("response"));
-    }
-}