RubyGems - spikard - Versions diffs - 0.4.0-arm64-darwin-23 - Mend

spikard 0.4.0-arm64-darwin-23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (138) hide show

checksums.yaml +7 -0
data/LICENSE +1 -0
data/README.md +659 -0
data/ext/spikard_rb/Cargo.toml +17 -0
data/ext/spikard_rb/extconf.rb +10 -0
data/ext/spikard_rb/src/lib.rs +6 -0
data/lib/spikard/app.rb +405 -0
data/lib/spikard/background.rb +27 -0
data/lib/spikard/config.rb +396 -0
data/lib/spikard/converters.rb +13 -0
data/lib/spikard/handler_wrapper.rb +113 -0
data/lib/spikard/provide.rb +214 -0
data/lib/spikard/response.rb +173 -0
data/lib/spikard/schema.rb +243 -0
data/lib/spikard/sse.rb +111 -0
data/lib/spikard/streaming_response.rb +44 -0
data/lib/spikard/testing.rb +221 -0
data/lib/spikard/upload_file.rb +131 -0
data/lib/spikard/version.rb +5 -0
data/lib/spikard/websocket.rb +59 -0
data/lib/spikard.rb +43 -0
data/sig/spikard.rbs +366 -0
data/vendor/bundle/ruby/3.4.0/gems/diff-lcs-1.6.2/mise.toml +5 -0
data/vendor/bundle/ruby/3.4.0/gems/rake-compiler-dock-1.10.0/build/buildkitd.toml +2 -0
data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -0
data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +139 -0
data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +561 -0
data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
data/vendor/crates/spikard-bindings-shared/src/error_response.rs +403 -0
data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +274 -0
data/vendor/crates/spikard-bindings-shared/src/lib.rs +25 -0
data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +298 -0
data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +637 -0
data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +309 -0
data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +355 -0
data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +502 -0
data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +389 -0
data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +413 -0
data/vendor/crates/spikard-core/Cargo.toml +40 -0
data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -0
data/vendor/crates/spikard-core/src/bindings/response.rs +133 -0
data/vendor/crates/spikard-core/src/debug.rs +63 -0
data/vendor/crates/spikard-core/src/di/container.rs +726 -0
data/vendor/crates/spikard-core/src/di/dependency.rs +273 -0
data/vendor/crates/spikard-core/src/di/error.rs +118 -0
data/vendor/crates/spikard-core/src/di/factory.rs +538 -0
data/vendor/crates/spikard-core/src/di/graph.rs +545 -0
data/vendor/crates/spikard-core/src/di/mod.rs +192 -0
data/vendor/crates/spikard-core/src/di/resolved.rs +411 -0
data/vendor/crates/spikard-core/src/di/value.rs +283 -0
data/vendor/crates/spikard-core/src/errors.rs +39 -0
data/vendor/crates/spikard-core/src/http.rs +153 -0
data/vendor/crates/spikard-core/src/lib.rs +29 -0
data/vendor/crates/spikard-core/src/lifecycle.rs +422 -0
data/vendor/crates/spikard-core/src/metadata.rs +397 -0
data/vendor/crates/spikard-core/src/parameters.rs +723 -0
data/vendor/crates/spikard-core/src/problem.rs +310 -0
data/vendor/crates/spikard-core/src/request_data.rs +189 -0
data/vendor/crates/spikard-core/src/router.rs +249 -0
data/vendor/crates/spikard-core/src/schema_registry.rs +183 -0
data/vendor/crates/spikard-core/src/type_hints.rs +304 -0
data/vendor/crates/spikard-core/src/validation/error_mapper.rs +689 -0
data/vendor/crates/spikard-core/src/validation/mod.rs +459 -0
data/vendor/crates/spikard-http/Cargo.toml +58 -0
data/vendor/crates/spikard-http/examples/sse-notifications.rs +147 -0
data/vendor/crates/spikard-http/examples/websocket-chat.rs +91 -0
data/vendor/crates/spikard-http/src/auth.rs +247 -0
data/vendor/crates/spikard-http/src/background.rs +1562 -0
data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -0
data/vendor/crates/spikard-http/src/bindings/response.rs +1 -0
data/vendor/crates/spikard-http/src/body_metadata.rs +8 -0
data/vendor/crates/spikard-http/src/cors.rs +490 -0
data/vendor/crates/spikard-http/src/debug.rs +63 -0
data/vendor/crates/spikard-http/src/di_handler.rs +1878 -0
data/vendor/crates/spikard-http/src/handler_response.rs +532 -0
data/vendor/crates/spikard-http/src/handler_trait.rs +861 -0
data/vendor/crates/spikard-http/src/handler_trait_tests.rs +284 -0
data/vendor/crates/spikard-http/src/lib.rs +524 -0
data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +149 -0
data/vendor/crates/spikard-http/src/lifecycle.rs +428 -0
data/vendor/crates/spikard-http/src/middleware/mod.rs +285 -0
data/vendor/crates/spikard-http/src/middleware/multipart.rs +930 -0
data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +541 -0
data/vendor/crates/spikard-http/src/middleware/validation.rs +287 -0
data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -0
data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -0
data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +867 -0
data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +678 -0
data/vendor/crates/spikard-http/src/query_parser.rs +369 -0
data/vendor/crates/spikard-http/src/response.rs +399 -0
data/vendor/crates/spikard-http/src/server/handler.rs +1557 -0
data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +98 -0
data/vendor/crates/spikard-http/src/server/mod.rs +806 -0
data/vendor/crates/spikard-http/src/server/request_extraction.rs +630 -0
data/vendor/crates/spikard-http/src/server/routing_factory.rs +497 -0
data/vendor/crates/spikard-http/src/sse.rs +961 -0
data/vendor/crates/spikard-http/src/testing/form.rs +14 -0
data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -0
data/vendor/crates/spikard-http/src/testing/test_client.rs +285 -0
data/vendor/crates/spikard-http/src/testing.rs +377 -0
data/vendor/crates/spikard-http/src/websocket.rs +831 -0
data/vendor/crates/spikard-http/tests/background_behavior.rs +918 -0
data/vendor/crates/spikard-http/tests/common/handlers.rs +308 -0
data/vendor/crates/spikard-http/tests/common/mod.rs +21 -0
data/vendor/crates/spikard-http/tests/di_integration.rs +202 -0
data/vendor/crates/spikard-http/tests/doc_snippets.rs +4 -0
data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1135 -0
data/vendor/crates/spikard-http/tests/multipart_behavior.rs +688 -0
data/vendor/crates/spikard-http/tests/server_config_builder.rs +324 -0
data/vendor/crates/spikard-http/tests/sse_behavior.rs +728 -0
data/vendor/crates/spikard-http/tests/websocket_behavior.rs +724 -0
data/vendor/crates/spikard-rb/Cargo.toml +43 -0
data/vendor/crates/spikard-rb/build.rs +199 -0
data/vendor/crates/spikard-rb/src/background.rs +63 -0
data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
data/vendor/crates/spikard-rb/src/config/server_config.rs +283 -0
data/vendor/crates/spikard-rb/src/conversion.rs +459 -0
data/vendor/crates/spikard-rb/src/di/builder.rs +105 -0
data/vendor/crates/spikard-rb/src/di/mod.rs +413 -0
data/vendor/crates/spikard-rb/src/handler.rs +612 -0
data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
data/vendor/crates/spikard-rb/src/lib.rs +1857 -0
data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -0
data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +427 -0
data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +326 -0
data/vendor/crates/spikard-rb/src/server.rs +283 -0
data/vendor/crates/spikard-rb/src/sse.rs +231 -0
data/vendor/crates/spikard-rb/src/testing/client.rs +404 -0
data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -0
data/vendor/crates/spikard-rb/src/testing/websocket.rs +221 -0
data/vendor/crates/spikard-rb/src/websocket.rs +233 -0
data/vendor/crates/spikard-rb/tests/magnus_ffi_tests.rs +14 -0
metadata +213 -0

data/vendor/crates/spikard-http/src/handler_response.rs ADDED Viewed

@@ -0,0 +1,532 @@
+use axum::{
+    BoxError,
+    body::Body,
+    http::{HeaderMap, HeaderName, HeaderValue, StatusCode},
+    response::Response as AxumResponse,
+};
+use bytes::Bytes;
+use futures::{Stream, StreamExt};
+use std::pin::Pin;
+/// Unified response type that can represent either a ready response or a streaming body.
+///
+/// This enum allows handlers to return either:
+/// - A complete response that's ready to send (`Response` variant)
+/// - A streaming response with potentially unbounded data (`Stream` variant)
+///
+/// # Variants
+///
+/// * `Response` - A complete Axum response ready to send to the client. Use this for
+///   responses where you have all the data ready (files, JSON bodies, HTML, etc.)
+///
+/// * `Stream` - A streaming response that produces data chunks over time. Use this for:
+///   - Large files (avoid loading entire file in memory)
+///   - Server-Sent Events (SSE)
+///   - Long-polling responses
+///   - Real-time data feeds
+///   - Any unbounded or very large responses
+///
+/// # Examples
+///
+/// ```ignore
+/// // Regular response
+/// let response = AxumResponse::builder()
+///     .status(StatusCode::OK)
+///     .body(Body::from("Hello"))
+///     .unwrap();
+/// let handler_response = HandlerResponse::from(response);
+///
+/// // Streaming response
+/// let stream = futures::stream::iter(vec![
+///     Ok::<_, Box<dyn std::error::Error>>(Bytes::from("chunk1")),
+///     Ok(Bytes::from("chunk2")),
+/// ]);
+/// let response = HandlerResponse::stream(stream)
+///     .with_status(StatusCode::OK);
+/// ```
+pub enum HandlerResponse {
+    /// A complete response ready to send
+    Response(AxumResponse<Body>),
+    /// A streaming response with custom status and headers
+    Stream {
+        /// The byte stream that will be sent to the client
+        stream: Pin<Box<dyn Stream<Item = Result<Bytes, BoxError>> + Send + 'static>>,
+        /// HTTP status code for the response
+        status: StatusCode,
+        /// Response headers to send
+        headers: HeaderMap,
+    },
+}
+impl From<AxumResponse<Body>> for HandlerResponse {
+    fn from(response: AxumResponse<Body>) -> Self {
+        HandlerResponse::Response(response)
+    }
+}
+impl HandlerResponse {
+    /// Convert the handler response into an Axum response.
+    ///
+    /// Consumes the `HandlerResponse` and produces an `AxumResponse<Body>` ready
+    /// to be sent to the client. For streaming responses, wraps the stream in an
+    /// Axum Body.
+    ///
+    /// # Returns
+    /// An `AxumResponse<Body>` ready to be returned from an Axum handler
+    pub fn into_response(self) -> AxumResponse<Body> {
+        match self {
+            HandlerResponse::Response(response) => response,
+            HandlerResponse::Stream {
+                stream,
+                status,
+                mut headers,
+            } => {
+                let body = Body::from_stream(stream);
+                let mut response = AxumResponse::new(body);
+                *response.status_mut() = status;
+                response.headers_mut().extend(headers.drain());
+                response
+            }
+        }
+    }
+    /// Create a streaming response from any async stream of byte chunks.
+    ///
+    /// Wraps an async stream of byte chunks into a `HandlerResponse::Stream`.
+    /// This is useful for large files, real-time data, or any unbounded response.
+    ///
+    /// # Type Parameters
+    /// * `S` - The stream type implementing `Stream<Item = Result<Bytes, E>>`
+    /// * `E` - The error type that can be converted to `BoxError`
+    ///
+    /// # Arguments
+    /// * `stream` - An async stream that yields byte chunks or errors
+    ///
+    /// # Returns
+    /// A `HandlerResponse` with 200 OK status and empty headers (customize with
+    /// `with_status()` and `with_header()`)
+    ///
+    /// # Example
+    ///
+    /// ```ignore
+    /// use futures::stream;
+    /// use spikard_http::HandlerResponse;
+    /// use bytes::Bytes;
+    ///
+    /// let stream = stream::iter(vec![
+    ///     Ok::<_, Box<dyn std::error::Error>>(Bytes::from("Hello ")),
+    ///     Ok(Bytes::from("World")),
+    /// ]);
+    /// let response = HandlerResponse::stream(stream)
+    ///     .with_status(StatusCode::OK);
+    /// ```
+    pub fn stream<S, E>(stream: S) -> Self
+    where
+        S: Stream<Item = Result<Bytes, E>> + Send + 'static,
+        E: Into<BoxError>,
+    {
+        let mapped = stream.map(|chunk| chunk.map_err(Into::into));
+        HandlerResponse::Stream {
+            stream: Box::pin(mapped),
+            status: StatusCode::OK,
+            headers: HeaderMap::new(),
+        }
+    }
+    /// Override the HTTP status code for the streaming response.
+    ///
+    /// Sets the HTTP status code to be used in the response. This only affects
+    /// `Stream` variants; regular responses already have their status set.
+    ///
+    /// # Arguments
+    /// * `status` - The HTTP status code to use (e.g., `StatusCode::OK`)
+    ///
+    /// # Returns
+    /// Self for method chaining
+    ///
+    /// # Example
+    ///
+    /// ```ignore
+    /// let response = HandlerResponse::stream(my_stream)
+    ///     .with_status(StatusCode::PARTIAL_CONTENT);
+    /// ```
+    pub fn with_status(mut self, status: StatusCode) -> Self {
+        if let HandlerResponse::Stream { status: s, .. } = &mut self {
+            *s = status;
+        }
+        self
+    }
+    /// Insert or replace a header on the streaming response.
+    ///
+    /// Adds an HTTP header to the response. This only affects `Stream` variants;
+    /// regular responses already have their headers set. If a header with the same
+    /// name already exists, it will be replaced.
+    ///
+    /// # Arguments
+    /// * `name` - The header name (e.g., `HeaderName::from_static("content-type")`)
+    /// * `value` - The header value
+    ///
+    /// # Returns
+    /// Self for method chaining
+    ///
+    /// # Example
+    ///
+    /// ```ignore
+    /// use axum::http::{HeaderName, HeaderValue};
+    ///
+    /// let response = HandlerResponse::stream(my_stream)
+    ///     .with_header(
+    ///         HeaderName::from_static("content-type"),
+    ///         HeaderValue::from_static("application/octet-stream")
+    ///     );
+    /// ```
+    pub fn with_header(mut self, name: HeaderName, value: HeaderValue) -> Self {
+        if let HandlerResponse::Stream { headers, .. } = &mut self {
+            headers.insert(name, value);
+        }
+        self
+    }
+}
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use axum::http::header;
+    use http_body_util::BodyExt;
+    /// Test 1: Convert AxumResponse → HandlerResponse::Response
+    #[test]
+    fn test_from_axum_response() {
+        let axum_response = AxumResponse::new(Body::from("test body"));
+        let handler_response = HandlerResponse::from(axum_response);
+        match handler_response {
+            HandlerResponse::Response(_) => {}
+            HandlerResponse::Stream { .. } => panic!("Expected Response variant"),
+        }
+    }
+    /// Test 2: Create stream with chunks, verify wrapping
+    #[tokio::test]
+    async fn test_stream_creation_with_chunks() {
+        let chunks = vec![
+            Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from("chunk1")),
+            Ok(Bytes::from("chunk2")),
+            Ok(Bytes::from("chunk3")),
+        ];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream);
+        match handler_response {
+            HandlerResponse::Stream { status, headers, .. } => {
+                assert_eq!(status, StatusCode::OK);
+                assert!(headers.is_empty());
+            }
+            HandlerResponse::Response(_) => panic!("Expected Stream variant"),
+        }
+    }
+    /// Test 3: Stream with custom status code (206 Partial Content)
+    #[tokio::test]
+    async fn test_stream_with_custom_status() {
+        let chunks = vec![Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from(
+            "partial",
+        ))];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream).with_status(StatusCode::PARTIAL_CONTENT);
+        match handler_response {
+            HandlerResponse::Stream { status, .. } => {
+                assert_eq!(status, StatusCode::PARTIAL_CONTENT);
+            }
+            HandlerResponse::Response(_) => panic!("Expected Stream variant"),
+        }
+    }
+    /// Test 4: Stream with headers via with_header()
+    #[tokio::test]
+    async fn test_stream_with_headers() {
+        let chunks = vec![Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from("test"))];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream)
+            .with_header(header::CONTENT_TYPE, HeaderValue::from_static("application/x-ndjson"))
+            .with_header(header::CACHE_CONTROL, HeaderValue::from_static("no-cache"));
+        match handler_response {
+            HandlerResponse::Stream { headers, .. } => {
+                assert_eq!(headers.get(header::CONTENT_TYPE).unwrap(), "application/x-ndjson");
+                assert_eq!(headers.get(header::CACHE_CONTROL).unwrap(), "no-cache");
+            }
+            HandlerResponse::Response(_) => panic!("Expected Stream variant"),
+        }
+    }
+    /// Test 5: Stream body consumption - read all chunks from stream
+    #[tokio::test]
+    async fn test_stream_body_consumption() {
+        let chunks = vec![
+            Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from("hello ")),
+            Ok(Bytes::from("world")),
+            Ok(Bytes::from("!")),
+        ];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream).with_status(StatusCode::OK);
+        let axum_response = handler_response.into_response();
+        let body = axum_response.into_body().collect().await.unwrap();
+        let bytes = body.to_bytes();
+        assert_eq!(bytes, "hello world!");
+    }
+    /// Test 6: Into response for Response variant - passthrough conversion
+    #[tokio::test]
+    async fn test_into_response_for_response_variant() {
+        let original_body = "test response body";
+        let axum_response = AxumResponse::new(Body::from(original_body));
+        let handler_response = HandlerResponse::from(axum_response);
+        let result = handler_response.into_response();
+        let body = result.into_body().collect().await.unwrap();
+        let bytes = body.to_bytes();
+        assert_eq!(bytes, original_body);
+    }
+    /// Test 7: Method chaining - with_status() → with_header() → with_header()
+    #[tokio::test]
+    async fn test_method_chaining() {
+        let chunks = vec![Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from(
+            "chained",
+        ))];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream)
+            .with_status(StatusCode::CREATED)
+            .with_header(header::CONTENT_TYPE, HeaderValue::from_static("text/plain"))
+            .with_header(header::ETAG, HeaderValue::from_static("\"abc123\""));
+        match handler_response {
+            HandlerResponse::Stream { status, headers, .. } => {
+                assert_eq!(status, StatusCode::CREATED);
+                assert_eq!(headers.get(header::CONTENT_TYPE).unwrap(), "text/plain");
+                assert_eq!(headers.get(header::ETAG).unwrap(), "\"abc123\"");
+            }
+            HandlerResponse::Response(_) => panic!("Expected Stream variant"),
+        }
+    }
+    /// Test 8: Empty stream - zero-byte stream handling
+    #[tokio::test]
+    async fn test_empty_stream() {
+        let chunks: Vec<Result<Bytes, Box<dyn std::error::Error + Send + Sync>>> = vec![];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream).with_status(StatusCode::NO_CONTENT);
+        let axum_response = handler_response.into_response();
+        let status = axum_response.status();
+        let body = axum_response.into_body().collect().await.unwrap();
+        let bytes = body.to_bytes();
+        assert!(bytes.is_empty());
+        assert_eq!(status, StatusCode::NO_CONTENT);
+    }
+    /// Test 9: Large stream - many chunks (100+ items)
+    #[tokio::test]
+    async fn test_large_stream() {
+        let chunks: Vec<Result<Bytes, Box<dyn std::error::Error + Send + Sync>>> =
+            (0..150).map(|i| Ok(Bytes::from(format!("chunk{} ", i)))).collect();
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream);
+        let axum_response = handler_response.into_response();
+        let body = axum_response.into_body().collect().await.unwrap();
+        let bytes = body.to_bytes();
+        // Verify we got all chunks
+        assert!(bytes.len() > 1000);
+        for i in 0..150 {
+            let expected = format!("chunk{} ", i);
+            assert!(std::str::from_utf8(&bytes).unwrap().contains(&expected));
+        }
+    }
+    /// Test 10: Error in stream - stream item returns Err, verify error propagation
+    #[tokio::test]
+    async fn test_stream_error_propagation() {
+        let chunks: Vec<Result<Bytes, Box<dyn std::error::Error + Send + Sync>>> = vec![
+            Ok(Bytes::from("good1 ")),
+            Err("custom error".into()),
+            Ok(Bytes::from("good2")),
+        ];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream);
+        let axum_response = handler_response.into_response();
+        let result = axum_response.into_body().collect().await;
+        // Error should propagate when collecting
+        assert!(result.is_err());
+    }
+    /// Test 11: Response variant ignores with_status()
+    #[test]
+    fn test_response_variant_ignores_with_status() {
+        let axum_response = AxumResponse::builder()
+            .status(StatusCode::OK)
+            .body(Body::from("test"))
+            .unwrap();
+        let handler_response = HandlerResponse::from(axum_response);
+        // Calling with_status on Response variant should be no-op
+        let result = handler_response.with_status(StatusCode::NOT_FOUND);
+        match result {
+            HandlerResponse::Response(resp) => {
+                assert_eq!(resp.status(), StatusCode::OK);
+            }
+            HandlerResponse::Stream { .. } => panic!("Expected Response variant"),
+        }
+    }
+    /// Test 12: Response variant ignores with_header()
+    #[test]
+    fn test_response_variant_ignores_with_header() {
+        let axum_response = AxumResponse::builder()
+            .status(StatusCode::OK)
+            .header(header::CONTENT_TYPE, "text/plain")
+            .body(Body::from("test"))
+            .unwrap();
+        let handler_response = HandlerResponse::from(axum_response);
+        // Calling with_header on Response variant should be no-op
+        let result = handler_response.with_header(header::CACHE_CONTROL, HeaderValue::from_static("max-age=3600"));
+        match result {
+            HandlerResponse::Response(resp) => {
+                assert!(resp.headers().get(header::CACHE_CONTROL).is_none());
+            }
+            HandlerResponse::Stream { .. } => panic!("Expected Response variant"),
+        }
+    }
+    /// Test 13: Stream into_response applies status and headers
+    #[tokio::test]
+    async fn test_stream_into_response_applies_status_and_headers() {
+        let chunks = vec![Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from(
+            "stream data",
+        ))];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream)
+            .with_status(StatusCode::PARTIAL_CONTENT)
+            .with_header(header::CONTENT_RANGE, HeaderValue::from_static("bytes 0-10/100"));
+        let axum_response = handler_response.into_response();
+        assert_eq!(axum_response.status(), StatusCode::PARTIAL_CONTENT);
+        assert_eq!(
+            axum_response.headers().get(header::CONTENT_RANGE).unwrap(),
+            "bytes 0-10/100"
+        );
+        let body = axum_response.into_body().collect().await.unwrap();
+        assert_eq!(body.to_bytes(), "stream data");
+    }
+    /// Test 14: Multiple header replacements via with_header()
+    #[tokio::test]
+    async fn test_multiple_header_replacements() {
+        let chunks = vec![Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from("data"))];
+        let stream = futures::stream::iter(chunks);
+        // Replace the same header twice - second should win
+        let handler_response = HandlerResponse::stream(stream)
+            .with_header(header::CONTENT_TYPE, HeaderValue::from_static("application/json"))
+            .with_header(header::CONTENT_TYPE, HeaderValue::from_static("application/x-ndjson"));
+        match handler_response {
+            HandlerResponse::Stream { headers, .. } => {
+                assert_eq!(headers.get(header::CONTENT_TYPE).unwrap(), "application/x-ndjson");
+            }
+            HandlerResponse::Response(_) => panic!("Expected Stream variant"),
+        }
+    }
+    /// Test 15: Stream with various status codes
+    #[tokio::test]
+    async fn test_stream_with_various_status_codes() {
+        let status_codes = vec![
+            StatusCode::OK,
+            StatusCode::CREATED,
+            StatusCode::ACCEPTED,
+            StatusCode::PARTIAL_CONTENT,
+            StatusCode::MULTI_STATUS,
+        ];
+        for status in status_codes {
+            let chunks = vec![Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from("test"))];
+            let stream = futures::stream::iter(chunks);
+            let handler_response = HandlerResponse::stream(stream).with_status(status);
+            match handler_response {
+                HandlerResponse::Stream { status: s, .. } => {
+                    assert_eq!(s, status);
+                }
+                HandlerResponse::Response(_) => panic!("Expected Stream variant"),
+            }
+        }
+    }
+    /// Test 16: Stream with JSON lines content (fixture-based)
+    #[tokio::test]
+    async fn test_stream_with_json_lines_content() {
+        let chunks = vec![
+            Ok::<_, Box<dyn std::error::Error + Send + Sync>>(Bytes::from(r#"{"index":0,"payload":"alpha"}"#)),
+            Ok(Bytes::from("\n")),
+            Ok(Bytes::from(r#"{"index":1,"payload":"beta"}"#)),
+            Ok(Bytes::from("\n")),
+            Ok(Bytes::from(r#"{"index":2,"payload":"gamma"}"#)),
+            Ok(Bytes::from("\n")),
+        ];
+        let stream = futures::stream::iter(chunks);
+        let handler_response = HandlerResponse::stream(stream)
+            .with_status(StatusCode::OK)
+            .with_header(header::CONTENT_TYPE, HeaderValue::from_static("application/x-ndjson"));
+        let axum_response = handler_response.into_response();
+        let status = axum_response.status();
+        let body = axum_response.into_body().collect().await.unwrap();
+        let bytes = body.to_bytes();
+        let body_str = std::str::from_utf8(&bytes).unwrap();
+        assert_eq!(status, StatusCode::OK);
+        assert!(body_str.contains("alpha"));
+        assert!(body_str.contains("beta"));
+        assert!(body_str.contains("gamma"));
+    }
+    /// Test 17: Round-trip Response → HandlerResponse → Response
+    #[tokio::test]
+    async fn test_response_roundtrip() {
+        let original = AxumResponse::builder()
+            .status(StatusCode::OK)
+            .header(header::CONTENT_TYPE, "text/plain")
+            .body(Body::from("roundtrip test"))
+            .unwrap();
+        let handler_response = HandlerResponse::from(original);
+        let result = handler_response.into_response();
+        assert_eq!(result.status(), StatusCode::OK);
+        assert_eq!(result.headers().get(header::CONTENT_TYPE).unwrap(), "text/plain");
+        let body = result.into_body().collect().await.unwrap();
+        assert_eq!(body.to_bytes(), "roundtrip test");
+    }
+}