spikard 0.4.0-x86_64-linux

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
  1. checksums.yaml +7 -0
  2. data/LICENSE +1 -0
  3. data/README.md +659 -0
  4. data/ext/spikard_rb/Cargo.toml +17 -0
  5. data/ext/spikard_rb/extconf.rb +10 -0
  6. data/ext/spikard_rb/src/lib.rs +6 -0
  7. data/lib/spikard/app.rb +405 -0
  8. data/lib/spikard/background.rb +27 -0
  9. data/lib/spikard/config.rb +396 -0
  10. data/lib/spikard/converters.rb +13 -0
  11. data/lib/spikard/handler_wrapper.rb +113 -0
  12. data/lib/spikard/provide.rb +214 -0
  13. data/lib/spikard/response.rb +173 -0
  14. data/lib/spikard/schema.rb +243 -0
  15. data/lib/spikard/sse.rb +111 -0
  16. data/lib/spikard/streaming_response.rb +44 -0
  17. data/lib/spikard/testing.rb +221 -0
  18. data/lib/spikard/upload_file.rb +131 -0
  19. data/lib/spikard/version.rb +5 -0
  20. data/lib/spikard/websocket.rb +59 -0
  21. data/lib/spikard.rb +43 -0
  22. data/sig/spikard.rbs +366 -0
  23. data/vendor/bundle/ruby/3.4.0/gems/diff-lcs-1.6.2/mise.toml +5 -0
  24. data/vendor/bundle/ruby/3.4.0/gems/rake-compiler-dock-1.10.0/build/buildkitd.toml +2 -0
  25. data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -0
  26. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +139 -0
  27. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +561 -0
  28. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -0
  29. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -0
  30. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +403 -0
  31. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +274 -0
  32. data/vendor/crates/spikard-bindings-shared/src/lib.rs +25 -0
  33. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +298 -0
  34. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +637 -0
  35. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +309 -0
  36. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -0
  37. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +355 -0
  38. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +502 -0
  39. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +389 -0
  40. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +413 -0
  41. data/vendor/crates/spikard-core/Cargo.toml +40 -0
  42. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -0
  43. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -0
  44. data/vendor/crates/spikard-core/src/debug.rs +63 -0
  45. data/vendor/crates/spikard-core/src/di/container.rs +726 -0
  46. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -0
  47. data/vendor/crates/spikard-core/src/di/error.rs +118 -0
  48. data/vendor/crates/spikard-core/src/di/factory.rs +538 -0
  49. data/vendor/crates/spikard-core/src/di/graph.rs +545 -0
  50. data/vendor/crates/spikard-core/src/di/mod.rs +192 -0
  51. data/vendor/crates/spikard-core/src/di/resolved.rs +411 -0
  52. data/vendor/crates/spikard-core/src/di/value.rs +283 -0
  53. data/vendor/crates/spikard-core/src/errors.rs +39 -0
  54. data/vendor/crates/spikard-core/src/http.rs +153 -0
  55. data/vendor/crates/spikard-core/src/lib.rs +29 -0
  56. data/vendor/crates/spikard-core/src/lifecycle.rs +422 -0
  57. data/vendor/crates/spikard-core/src/metadata.rs +397 -0
  58. data/vendor/crates/spikard-core/src/parameters.rs +723 -0
  59. data/vendor/crates/spikard-core/src/problem.rs +310 -0
  60. data/vendor/crates/spikard-core/src/request_data.rs +189 -0
  61. data/vendor/crates/spikard-core/src/router.rs +249 -0
  62. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -0
  63. data/vendor/crates/spikard-core/src/type_hints.rs +304 -0
  64. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +689 -0
  65. data/vendor/crates/spikard-core/src/validation/mod.rs +459 -0
  66. data/vendor/crates/spikard-http/Cargo.toml +58 -0
  67. data/vendor/crates/spikard-http/examples/sse-notifications.rs +147 -0
  68. data/vendor/crates/spikard-http/examples/websocket-chat.rs +91 -0
  69. data/vendor/crates/spikard-http/src/auth.rs +247 -0
  70. data/vendor/crates/spikard-http/src/background.rs +1562 -0
  71. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -0
  72. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -0
  73. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -0
  74. data/vendor/crates/spikard-http/src/cors.rs +490 -0
  75. data/vendor/crates/spikard-http/src/debug.rs +63 -0
  76. data/vendor/crates/spikard-http/src/di_handler.rs +1878 -0
  77. data/vendor/crates/spikard-http/src/handler_response.rs +532 -0
  78. data/vendor/crates/spikard-http/src/handler_trait.rs +861 -0
  79. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +284 -0
  80. data/vendor/crates/spikard-http/src/lib.rs +524 -0
  81. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +149 -0
  82. data/vendor/crates/spikard-http/src/lifecycle.rs +428 -0
  83. data/vendor/crates/spikard-http/src/middleware/mod.rs +285 -0
  84. data/vendor/crates/spikard-http/src/middleware/multipart.rs +930 -0
  85. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +541 -0
  86. data/vendor/crates/spikard-http/src/middleware/validation.rs +287 -0
  87. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -0
  88. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -0
  89. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +867 -0
  90. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +678 -0
  91. data/vendor/crates/spikard-http/src/query_parser.rs +369 -0
  92. data/vendor/crates/spikard-http/src/response.rs +399 -0
  93. data/vendor/crates/spikard-http/src/server/handler.rs +1557 -0
  94. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +98 -0
  95. data/vendor/crates/spikard-http/src/server/mod.rs +806 -0
  96. data/vendor/crates/spikard-http/src/server/request_extraction.rs +630 -0
  97. data/vendor/crates/spikard-http/src/server/routing_factory.rs +497 -0
  98. data/vendor/crates/spikard-http/src/sse.rs +961 -0
  99. data/vendor/crates/spikard-http/src/testing/form.rs +14 -0
  100. data/vendor/crates/spikard-http/src/testing/multipart.rs +60 -0
  101. data/vendor/crates/spikard-http/src/testing/test_client.rs +285 -0
  102. data/vendor/crates/spikard-http/src/testing.rs +377 -0
  103. data/vendor/crates/spikard-http/src/websocket.rs +831 -0
  104. data/vendor/crates/spikard-http/tests/background_behavior.rs +918 -0
  105. data/vendor/crates/spikard-http/tests/common/handlers.rs +308 -0
  106. data/vendor/crates/spikard-http/tests/common/mod.rs +21 -0
  107. data/vendor/crates/spikard-http/tests/di_integration.rs +202 -0
  108. data/vendor/crates/spikard-http/tests/doc_snippets.rs +4 -0
  109. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1135 -0
  110. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +688 -0
  111. data/vendor/crates/spikard-http/tests/server_config_builder.rs +324 -0
  112. data/vendor/crates/spikard-http/tests/sse_behavior.rs +728 -0
  113. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +724 -0
  114. data/vendor/crates/spikard-rb/Cargo.toml +43 -0
  115. data/vendor/crates/spikard-rb/build.rs +199 -0
  116. data/vendor/crates/spikard-rb/src/background.rs +63 -0
  117. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -0
  118. data/vendor/crates/spikard-rb/src/config/server_config.rs +283 -0
  119. data/vendor/crates/spikard-rb/src/conversion.rs +459 -0
  120. data/vendor/crates/spikard-rb/src/di/builder.rs +105 -0
  121. data/vendor/crates/spikard-rb/src/di/mod.rs +413 -0
  122. data/vendor/crates/spikard-rb/src/handler.rs +612 -0
  123. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -0
  124. data/vendor/crates/spikard-rb/src/lib.rs +1857 -0
  125. data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -0
  126. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -0
  127. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +427 -0
  128. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -0
  129. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +326 -0
  130. data/vendor/crates/spikard-rb/src/server.rs +283 -0
  131. data/vendor/crates/spikard-rb/src/sse.rs +231 -0
  132. data/vendor/crates/spikard-rb/src/testing/client.rs +404 -0
  133. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -0
  134. data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -0
  135. data/vendor/crates/spikard-rb/src/testing/websocket.rs +221 -0
  136. data/vendor/crates/spikard-rb/src/websocket.rs +233 -0
  137. data/vendor/crates/spikard-rb/tests/magnus_ffi_tests.rs +14 -0
  138. metadata +213 -0
@@ -0,0 +1,1557 @@
1
+ //! ValidatingHandler wrapper that executes request/parameter validation before handler
2
+
3
+ use crate::handler_trait::{Handler, HandlerResult, RequestData};
4
+ use axum::body::Body;
5
+ use futures::FutureExt;
6
+ use serde_json::Value;
7
+ use spikard_core::errors::StructuredError;
8
+ use spikard_core::{ParameterValidator, ProblemDetails, SchemaValidator};
9
+ use std::future::Future;
10
+ use std::panic::AssertUnwindSafe;
11
+ use std::pin::Pin;
12
+ use std::sync::Arc;
13
+
14
+ /// Wrapper that runs request/parameter validation before calling the user handler.
15
+ pub struct ValidatingHandler {
16
+ inner: Arc<dyn Handler>,
17
+ request_validator: Option<Arc<SchemaValidator>>,
18
+ parameter_validator: Option<ParameterValidator>,
19
+ }
20
+
21
+ impl ValidatingHandler {
22
+ /// Create a new validating handler wrapping the inner handler with schema validators
23
+ pub fn new(inner: Arc<dyn Handler>, route: &crate::Route) -> Self {
24
+ Self {
25
+ inner,
26
+ request_validator: route.request_validator.clone(),
27
+ parameter_validator: route.parameter_validator.clone(),
28
+ }
29
+ }
30
+ }
31
+
32
+ impl Handler for ValidatingHandler {
33
+ fn call(
34
+ &self,
35
+ req: axum::http::Request<Body>,
36
+ mut request_data: RequestData,
37
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
38
+ let inner = self.inner.clone();
39
+ let request_validator = self.request_validator.clone();
40
+ let parameter_validator = self.parameter_validator.clone();
41
+
42
+ Box::pin(async move {
43
+ if let Some(validator) = request_validator {
44
+ if request_data.body.is_null() && request_data.raw_body.is_some() {
45
+ let raw_bytes = request_data.raw_body.as_ref().unwrap();
46
+ request_data.body = serde_json::from_slice::<Value>(raw_bytes)
47
+ .map_err(|e| (axum::http::StatusCode::BAD_REQUEST, format!("Invalid JSON: {}", e)))?;
48
+ }
49
+
50
+ if let Err(errors) = validator.validate(&request_data.body) {
51
+ let problem = ProblemDetails::from_validation_error(&errors);
52
+ let body = problem.to_json().unwrap_or_else(|_| "{}".to_string());
53
+ return Err((problem.status_code(), body));
54
+ }
55
+ }
56
+
57
+ if let Some(validator) = parameter_validator
58
+ && let Err(errors) = validator.validate_and_extract(
59
+ &request_data.query_params,
60
+ &request_data.raw_query_params,
61
+ &request_data.path_params,
62
+ &request_data.headers,
63
+ &request_data.cookies,
64
+ )
65
+ {
66
+ let problem = ProblemDetails::from_validation_error(&errors);
67
+ let body = problem.to_json().unwrap_or_else(|_| "{}".to_string());
68
+ return Err((problem.status_code(), body));
69
+ }
70
+
71
+ match AssertUnwindSafe(async { inner.call(req, request_data).await })
72
+ .catch_unwind()
73
+ .await
74
+ {
75
+ Ok(result) => result,
76
+ Err(_) => {
77
+ let panic_payload = StructuredError::simple("panic", "Unexpected panic in handler");
78
+ let body = serde_json::to_string(&panic_payload)
79
+ .unwrap_or_else(|_| r#"{"error":"panic","code":"panic","details":{}}"#.to_string());
80
+ Err((axum::http::StatusCode::INTERNAL_SERVER_ERROR, body))
81
+ }
82
+ }
83
+ })
84
+ }
85
+ }
86
+
87
+ #[cfg(test)]
88
+ mod tests {
89
+ use super::*;
90
+ use axum::http::{Request, Response, StatusCode};
91
+ use serde_json::json;
92
+ use std::collections::HashMap;
93
+ use std::sync::Arc;
94
+
95
+ /// Create a minimal RequestData for testing
96
+ fn create_request_data(body: Value) -> RequestData {
97
+ RequestData {
98
+ path_params: Arc::new(HashMap::new()),
99
+ query_params: json!({}),
100
+ raw_query_params: Arc::new(HashMap::new()),
101
+ body,
102
+ raw_body: None,
103
+ headers: Arc::new(HashMap::new()),
104
+ cookies: Arc::new(HashMap::new()),
105
+ method: "POST".to_string(),
106
+ path: "/test".to_string(),
107
+ #[cfg(feature = "di")]
108
+ dependencies: None,
109
+ }
110
+ }
111
+
112
+ /// Create RequestData with raw body bytes
113
+ fn create_request_data_with_raw_body(raw_body: Vec<u8>) -> RequestData {
114
+ RequestData {
115
+ path_params: Arc::new(HashMap::new()),
116
+ query_params: json!({}),
117
+ raw_query_params: Arc::new(HashMap::new()),
118
+ body: Value::Null,
119
+ raw_body: Some(bytes::Bytes::from(raw_body)),
120
+ headers: Arc::new(HashMap::new()),
121
+ cookies: Arc::new(HashMap::new()),
122
+ method: "POST".to_string(),
123
+ path: "/test".to_string(),
124
+ #[cfg(feature = "di")]
125
+ dependencies: None,
126
+ }
127
+ }
128
+
129
+ /// Success handler that echoes request body
130
+ struct SuccessEchoHandler;
131
+
132
+ impl Handler for SuccessEchoHandler {
133
+ fn call(
134
+ &self,
135
+ _request: Request<Body>,
136
+ request_data: RequestData,
137
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
138
+ Box::pin(async move {
139
+ let response = Response::builder()
140
+ .status(StatusCode::OK)
141
+ .header("content-type", "application/json")
142
+ .body(Body::from(request_data.body.to_string()))
143
+ .unwrap();
144
+ Ok(response)
145
+ })
146
+ }
147
+ }
148
+
149
+ /// Panic handler for testing panic recovery
150
+ struct PanicHandlerImpl;
151
+
152
+ impl Handler for PanicHandlerImpl {
153
+ fn call(
154
+ &self,
155
+ _request: Request<Body>,
156
+ _request_data: RequestData,
157
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
158
+ Box::pin(async move {
159
+ panic!("Intentional panic for testing");
160
+ })
161
+ }
162
+ }
163
+
164
+ /// Test 1: Handler with no validators passes through to inner handler
165
+ #[tokio::test]
166
+ async fn test_no_validation_passes_through() {
167
+ // Create a Route with no validators
168
+ let route = spikard_core::Route {
169
+ method: spikard_core::http::Method::Post,
170
+ path: "/test".to_string(),
171
+ handler_name: "test_handler".to_string(),
172
+ request_validator: None,
173
+ response_validator: None,
174
+ parameter_validator: None,
175
+ file_params: None,
176
+ is_async: true,
177
+ cors: None,
178
+ expects_json_body: false,
179
+ #[cfg(feature = "di")]
180
+ handler_dependencies: vec![],
181
+ };
182
+
183
+ let inner = Arc::new(SuccessEchoHandler);
184
+ let validator_handler = ValidatingHandler::new(inner, &route);
185
+
186
+ let request = Request::builder()
187
+ .method("POST")
188
+ .uri("/test")
189
+ .body(Body::empty())
190
+ .unwrap();
191
+
192
+ let request_data = create_request_data(json!({"name": "Alice"}));
193
+
194
+ let result = validator_handler.call(request, request_data).await;
195
+
196
+ assert!(result.is_ok(), "Handler should succeed without validators");
197
+ let response = result.unwrap();
198
+ assert_eq!(response.status(), StatusCode::OK);
199
+ }
200
+
201
+ /// Test 2: Request body validation - Valid input passes
202
+ #[tokio::test]
203
+ async fn test_request_body_validation_valid() {
204
+ let schema = json!({
205
+ "type": "object",
206
+ "properties": {
207
+ "name": {"type": "string"},
208
+ "age": {"type": "integer"}
209
+ },
210
+ "required": ["name"]
211
+ });
212
+
213
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
214
+
215
+ let route = spikard_core::Route {
216
+ method: spikard_core::http::Method::Post,
217
+ path: "/test".to_string(),
218
+ handler_name: "test_handler".to_string(),
219
+ request_validator: Some(validator),
220
+ response_validator: None,
221
+ parameter_validator: None,
222
+ file_params: None,
223
+ is_async: true,
224
+ cors: None,
225
+ expects_json_body: true,
226
+ #[cfg(feature = "di")]
227
+ handler_dependencies: vec![],
228
+ };
229
+
230
+ let inner = Arc::new(SuccessEchoHandler);
231
+ let validator_handler = ValidatingHandler::new(inner, &route);
232
+
233
+ let request = Request::builder()
234
+ .method("POST")
235
+ .uri("/test")
236
+ .body(Body::empty())
237
+ .unwrap();
238
+
239
+ let request_data = create_request_data(json!({"name": "Alice", "age": 30}));
240
+
241
+ let result = validator_handler.call(request, request_data).await;
242
+
243
+ assert!(result.is_ok(), "Valid request should pass validation");
244
+ let response = result.unwrap();
245
+ assert_eq!(response.status(), StatusCode::OK);
246
+ }
247
+
248
+ /// Test 3: Request body validation - Invalid input returns 422
249
+ #[tokio::test]
250
+ async fn test_request_body_validation_invalid() {
251
+ let schema = json!({
252
+ "type": "object",
253
+ "properties": {
254
+ "name": {"type": "string"}
255
+ },
256
+ "required": ["name"]
257
+ });
258
+
259
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
260
+
261
+ let route = spikard_core::Route {
262
+ method: spikard_core::http::Method::Post,
263
+ path: "/test".to_string(),
264
+ handler_name: "test_handler".to_string(),
265
+ request_validator: Some(validator),
266
+ response_validator: None,
267
+ parameter_validator: None,
268
+ file_params: None,
269
+ is_async: true,
270
+ cors: None,
271
+ expects_json_body: true,
272
+ #[cfg(feature = "di")]
273
+ handler_dependencies: vec![],
274
+ };
275
+
276
+ let inner = Arc::new(SuccessEchoHandler);
277
+ let validator_handler = ValidatingHandler::new(inner, &route);
278
+
279
+ let request = Request::builder()
280
+ .method("POST")
281
+ .uri("/test")
282
+ .body(Body::empty())
283
+ .unwrap();
284
+
285
+ // Missing required "name" field
286
+ let request_data = create_request_data(json!({"age": 30}));
287
+
288
+ let result = validator_handler.call(request, request_data).await;
289
+
290
+ assert!(result.is_err(), "Invalid request should fail validation");
291
+ let (status, body) = result.unwrap_err();
292
+ assert_eq!(
293
+ status,
294
+ StatusCode::UNPROCESSABLE_ENTITY,
295
+ "Should return 422 for validation error"
296
+ );
297
+
298
+ // Verify ProblemDetails JSON structure
299
+ let problem: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
300
+ assert_eq!(problem["type"], "https://spikard.dev/errors/validation-error");
301
+ assert_eq!(problem["title"], "Request Validation Failed");
302
+ assert_eq!(problem["status"], 422);
303
+ assert!(problem["errors"].is_array(), "Should contain errors array extension");
304
+ assert!(
305
+ problem["errors"][0]["loc"][0] == "body",
306
+ "Error location should start with 'body'"
307
+ );
308
+ }
309
+
310
+ /// Test 4: JSON parsing error returns 400
311
+ #[tokio::test]
312
+ async fn test_json_parsing_error() {
313
+ let schema = json!({
314
+ "type": "object",
315
+ "properties": {
316
+ "name": {"type": "string"}
317
+ }
318
+ });
319
+
320
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
321
+
322
+ let route = spikard_core::Route {
323
+ method: spikard_core::http::Method::Post,
324
+ path: "/test".to_string(),
325
+ handler_name: "test_handler".to_string(),
326
+ request_validator: Some(validator),
327
+ response_validator: None,
328
+ parameter_validator: None,
329
+ file_params: None,
330
+ is_async: true,
331
+ cors: None,
332
+ expects_json_body: true,
333
+ #[cfg(feature = "di")]
334
+ handler_dependencies: vec![],
335
+ };
336
+
337
+ let inner = Arc::new(SuccessEchoHandler);
338
+ let validator_handler = ValidatingHandler::new(inner, &route);
339
+
340
+ let request = Request::builder()
341
+ .method("POST")
342
+ .uri("/test")
343
+ .body(Body::empty())
344
+ .unwrap();
345
+
346
+ // Invalid JSON bytes
347
+ let request_data = create_request_data_with_raw_body(b"{invalid json}".to_vec());
348
+
349
+ let result = validator_handler.call(request, request_data).await;
350
+
351
+ assert!(result.is_err(), "Invalid JSON should fail");
352
+ let (status, body) = result.unwrap_err();
353
+ assert_eq!(status, StatusCode::BAD_REQUEST);
354
+ assert!(
355
+ body.contains("Invalid JSON"),
356
+ "Error message should mention invalid JSON"
357
+ );
358
+ }
359
+
360
+ /// Test 5: Panic handling - Inner handler panic is caught and returns 500
361
+ #[tokio::test]
362
+ async fn test_panic_handling() {
363
+ let route = spikard_core::Route {
364
+ method: spikard_core::http::Method::Post,
365
+ path: "/test".to_string(),
366
+ handler_name: "test_handler".to_string(),
367
+ request_validator: None,
368
+ response_validator: None,
369
+ parameter_validator: None,
370
+ file_params: None,
371
+ is_async: true,
372
+ cors: None,
373
+ expects_json_body: false,
374
+ #[cfg(feature = "di")]
375
+ handler_dependencies: vec![],
376
+ };
377
+
378
+ let inner = Arc::new(PanicHandlerImpl);
379
+ let validator_handler = ValidatingHandler::new(inner, &route);
380
+
381
+ let request = Request::builder()
382
+ .method("POST")
383
+ .uri("/test")
384
+ .body(Body::empty())
385
+ .unwrap();
386
+
387
+ let request_data = create_request_data(json!({}));
388
+
389
+ // This should NOT panic; instead, it should catch the panic and return error
390
+ let result = validator_handler.call(request, request_data).await;
391
+
392
+ assert!(result.is_err(), "Panicking handler should return error");
393
+ let (status, body) = result.unwrap_err();
394
+ assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR, "Panic should return 500");
395
+
396
+ // Verify panic error structure
397
+ let error: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
398
+ assert_eq!(error["code"], "panic");
399
+ assert_eq!(error["error"], "Unexpected panic in handler");
400
+ }
401
+
402
+ /// Test 6: Raw body parsing - Body is parsed on-demand from raw_body
403
+ #[tokio::test]
404
+ async fn test_raw_body_parsing() {
405
+ let schema = json!({
406
+ "type": "object",
407
+ "properties": {
408
+ "name": {"type": "string"}
409
+ },
410
+ "required": ["name"]
411
+ });
412
+
413
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
414
+
415
+ let route = spikard_core::Route {
416
+ method: spikard_core::http::Method::Post,
417
+ path: "/test".to_string(),
418
+ handler_name: "test_handler".to_string(),
419
+ request_validator: Some(validator),
420
+ response_validator: None,
421
+ parameter_validator: None,
422
+ file_params: None,
423
+ is_async: true,
424
+ cors: None,
425
+ expects_json_body: true,
426
+ #[cfg(feature = "di")]
427
+ handler_dependencies: vec![],
428
+ };
429
+
430
+ let inner = Arc::new(SuccessEchoHandler);
431
+ let validator_handler = ValidatingHandler::new(inner, &route);
432
+
433
+ let request = Request::builder()
434
+ .method("POST")
435
+ .uri("/test")
436
+ .body(Body::empty())
437
+ .unwrap();
438
+
439
+ // Create request data with raw body but null parsed body
440
+ let raw_body_json = br#"{"name":"Bob"}"#;
441
+ let request_data = create_request_data_with_raw_body(raw_body_json.to_vec());
442
+
443
+ let result = validator_handler.call(request, request_data).await;
444
+
445
+ assert!(result.is_ok(), "Raw body should be parsed successfully");
446
+ let response = result.unwrap();
447
+ assert_eq!(response.status(), StatusCode::OK);
448
+ }
449
+
450
+ /// Test 7: Multiple validation error details in response
451
+ #[tokio::test]
452
+ async fn test_multiple_validation_errors() {
453
+ let schema = json!({
454
+ "type": "object",
455
+ "properties": {
456
+ "name": {"type": "string"},
457
+ "email": {"type": "string", "format": "email"},
458
+ "age": {"type": "integer", "minimum": 0}
459
+ },
460
+ "required": ["name", "email", "age"]
461
+ });
462
+
463
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
464
+
465
+ let route = spikard_core::Route {
466
+ method: spikard_core::http::Method::Post,
467
+ path: "/test".to_string(),
468
+ handler_name: "test_handler".to_string(),
469
+ request_validator: Some(validator),
470
+ response_validator: None,
471
+ parameter_validator: None,
472
+ file_params: None,
473
+ is_async: true,
474
+ cors: None,
475
+ expects_json_body: true,
476
+ #[cfg(feature = "di")]
477
+ handler_dependencies: vec![],
478
+ };
479
+
480
+ let inner = Arc::new(SuccessEchoHandler);
481
+ let validator_handler = ValidatingHandler::new(inner, &route);
482
+
483
+ let request = Request::builder()
484
+ .method("POST")
485
+ .uri("/test")
486
+ .body(Body::empty())
487
+ .unwrap();
488
+
489
+ // Missing name and email, age is negative
490
+ let request_data = create_request_data(json!({"age": -5}));
491
+
492
+ let result = validator_handler.call(request, request_data).await;
493
+
494
+ assert!(result.is_err());
495
+ let (status, body) = result.unwrap_err();
496
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
497
+
498
+ let problem: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
499
+ let errors = problem["errors"].as_array().expect("Should have errors array");
500
+ assert!(
501
+ errors.len() >= 2,
502
+ "Should have multiple validation errors: got {}",
503
+ errors.len()
504
+ );
505
+ }
506
+
507
+ /// Test 8: Type mismatch in request body
508
+ #[tokio::test]
509
+ async fn test_type_mismatch_validation() {
510
+ let schema = json!({
511
+ "type": "object",
512
+ "properties": {
513
+ "age": {"type": "integer"}
514
+ },
515
+ "required": ["age"]
516
+ });
517
+
518
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
519
+
520
+ let route = spikard_core::Route {
521
+ method: spikard_core::http::Method::Post,
522
+ path: "/test".to_string(),
523
+ handler_name: "test_handler".to_string(),
524
+ request_validator: Some(validator),
525
+ response_validator: None,
526
+ parameter_validator: None,
527
+ file_params: None,
528
+ is_async: true,
529
+ cors: None,
530
+ expects_json_body: true,
531
+ #[cfg(feature = "di")]
532
+ handler_dependencies: vec![],
533
+ };
534
+
535
+ let inner = Arc::new(SuccessEchoHandler);
536
+ let validator_handler = ValidatingHandler::new(inner, &route);
537
+
538
+ let request = Request::builder()
539
+ .method("POST")
540
+ .uri("/test")
541
+ .body(Body::empty())
542
+ .unwrap();
543
+
544
+ // age is string instead of integer
545
+ let request_data = create_request_data(json!({"age": "thirty"}));
546
+
547
+ let result = validator_handler.call(request, request_data).await;
548
+
549
+ assert!(result.is_err());
550
+ let (status, body) = result.unwrap_err();
551
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
552
+
553
+ let problem: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
554
+ let errors = problem["errors"].as_array().expect("Should have errors array");
555
+ assert!(!errors.is_empty());
556
+ assert_eq!(errors[0]["loc"][1], "age");
557
+ }
558
+
559
+ /// Test 9: Successfully validates empty body when not required
560
+ #[tokio::test]
561
+ async fn test_empty_body_validation_optional() {
562
+ let schema = json!({
563
+ "type": "object",
564
+ "properties": {
565
+ "name": {"type": "string"}
566
+ }
567
+ });
568
+
569
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
570
+
571
+ let route = spikard_core::Route {
572
+ method: spikard_core::http::Method::Post,
573
+ path: "/test".to_string(),
574
+ handler_name: "test_handler".to_string(),
575
+ request_validator: Some(validator),
576
+ response_validator: None,
577
+ parameter_validator: None,
578
+ file_params: None,
579
+ is_async: true,
580
+ cors: None,
581
+ expects_json_body: true,
582
+ #[cfg(feature = "di")]
583
+ handler_dependencies: vec![],
584
+ };
585
+
586
+ let inner = Arc::new(SuccessEchoHandler);
587
+ let validator_handler = ValidatingHandler::new(inner, &route);
588
+
589
+ let request = Request::builder()
590
+ .method("POST")
591
+ .uri("/test")
592
+ .body(Body::empty())
593
+ .unwrap();
594
+
595
+ let request_data = create_request_data(json!({}));
596
+
597
+ let result = validator_handler.call(request, request_data).await;
598
+
599
+ assert!(result.is_ok(), "Empty body should be valid when no fields are required");
600
+ }
601
+
602
+ /// Test 10: Parameter validation with empty validators passes through
603
+ #[tokio::test]
604
+ async fn test_parameter_validation_empty() {
605
+ let param_validator = spikard_core::ParameterValidator::new(json!({})).expect("Valid empty schema");
606
+
607
+ let route = spikard_core::Route {
608
+ method: spikard_core::http::Method::Get,
609
+ path: "/search".to_string(),
610
+ handler_name: "search_handler".to_string(),
611
+ request_validator: None,
612
+ response_validator: None,
613
+ parameter_validator: Some(param_validator),
614
+ file_params: None,
615
+ is_async: true,
616
+ cors: None,
617
+ expects_json_body: false,
618
+ #[cfg(feature = "di")]
619
+ handler_dependencies: vec![],
620
+ };
621
+
622
+ let inner = Arc::new(SuccessEchoHandler);
623
+ let validator_handler = ValidatingHandler::new(inner, &route);
624
+
625
+ let request = Request::builder()
626
+ .method("GET")
627
+ .uri("/search")
628
+ .body(Body::empty())
629
+ .unwrap();
630
+
631
+ let request_data = create_request_data(json!({}));
632
+
633
+ let result = validator_handler.call(request, request_data).await;
634
+
635
+ // With empty parameter validator, should still execute handler
636
+ assert!(result.is_ok());
637
+ }
638
+
639
+ /// Test 11: Request body is null when raw_body is None
640
+ #[tokio::test]
641
+ async fn test_null_body_with_no_raw_body() {
642
+ let schema = json!({
643
+ "type": "object",
644
+ "properties": {
645
+ "name": {"type": "string"}
646
+ }
647
+ });
648
+
649
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
650
+
651
+ let route = spikard_core::Route {
652
+ method: spikard_core::http::Method::Post,
653
+ path: "/test".to_string(),
654
+ handler_name: "test_handler".to_string(),
655
+ request_validator: Some(validator),
656
+ response_validator: None,
657
+ parameter_validator: None,
658
+ file_params: None,
659
+ is_async: true,
660
+ cors: None,
661
+ expects_json_body: true,
662
+ #[cfg(feature = "di")]
663
+ handler_dependencies: vec![],
664
+ };
665
+
666
+ let inner = Arc::new(SuccessEchoHandler);
667
+ let validator_handler = ValidatingHandler::new(inner, &route);
668
+
669
+ let request = Request::builder()
670
+ .method("POST")
671
+ .uri("/test")
672
+ .body(Body::empty())
673
+ .unwrap();
674
+
675
+ // Create request_data with null body and no raw_body
676
+ let request_data = RequestData {
677
+ path_params: Arc::new(HashMap::new()),
678
+ query_params: json!({}),
679
+ raw_query_params: Arc::new(HashMap::new()),
680
+ body: Value::Null,
681
+ raw_body: None,
682
+ headers: Arc::new(HashMap::new()),
683
+ cookies: Arc::new(HashMap::new()),
684
+ method: "POST".to_string(),
685
+ path: "/test".to_string(),
686
+ #[cfg(feature = "di")]
687
+ dependencies: None,
688
+ };
689
+
690
+ let result = validator_handler.call(request, request_data).await;
691
+
692
+ // With null body and no raw_body, validator should reject
693
+ assert!(result.is_err(), "Null body with no raw_body should fail");
694
+ }
695
+
696
+ /// Test 12: Panic error serialization has correct JSON structure
697
+ #[tokio::test]
698
+ async fn test_panic_error_json_structure() {
699
+ let route = spikard_core::Route {
700
+ method: spikard_core::http::Method::Post,
701
+ path: "/test".to_string(),
702
+ handler_name: "test_handler".to_string(),
703
+ request_validator: None,
704
+ response_validator: None,
705
+ parameter_validator: None,
706
+ file_params: None,
707
+ is_async: true,
708
+ cors: None,
709
+ expects_json_body: false,
710
+ #[cfg(feature = "di")]
711
+ handler_dependencies: vec![],
712
+ };
713
+
714
+ let inner = Arc::new(PanicHandlerImpl);
715
+ let validator_handler = ValidatingHandler::new(inner, &route);
716
+
717
+ let request = Request::builder()
718
+ .method("POST")
719
+ .uri("/test")
720
+ .body(Body::empty())
721
+ .unwrap();
722
+
723
+ let request_data = create_request_data(json!({}));
724
+
725
+ let result = validator_handler.call(request, request_data).await;
726
+
727
+ assert!(result.is_err());
728
+ let (status, body) = result.unwrap_err();
729
+ assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR);
730
+
731
+ // Verify the panic error has correct fields
732
+ let error: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
733
+ assert!(error.get("error").is_some(), "Should have 'error' field");
734
+ assert!(error.get("code").is_some(), "Should have 'code' field");
735
+ assert_eq!(error["code"], "panic", "Code should be 'panic'");
736
+ }
737
+
738
+ /// Test 13: Handler receives request and request_data unchanged
739
+ #[tokio::test]
740
+ async fn test_handler_receives_correct_data() {
741
+ let route = spikard_core::Route {
742
+ method: spikard_core::http::Method::Post,
743
+ path: "/test".to_string(),
744
+ handler_name: "test_handler".to_string(),
745
+ request_validator: None,
746
+ response_validator: None,
747
+ parameter_validator: None,
748
+ file_params: None,
749
+ is_async: true,
750
+ cors: None,
751
+ expects_json_body: false,
752
+ #[cfg(feature = "di")]
753
+ handler_dependencies: vec![],
754
+ };
755
+
756
+ let inner = Arc::new(SuccessEchoHandler);
757
+ let validator_handler = ValidatingHandler::new(inner, &route);
758
+
759
+ let request = Request::builder()
760
+ .method("POST")
761
+ .uri("/test")
762
+ .body(Body::empty())
763
+ .unwrap();
764
+
765
+ let original_body = json!({"test": "data"});
766
+ let request_data = create_request_data(original_body.clone());
767
+
768
+ let result = validator_handler.call(request, request_data).await;
769
+
770
+ assert!(result.is_ok());
771
+ let response = result.unwrap();
772
+ assert_eq!(response.status(), StatusCode::OK);
773
+ }
774
+
775
+ /// Test 14: Raw body parsing when body is null and raw_body exists
776
+ #[tokio::test]
777
+ async fn test_raw_body_parsing_when_body_null() {
778
+ let schema = json!({
779
+ "type": "object",
780
+ "properties": {
781
+ "id": {"type": "integer"}
782
+ },
783
+ "required": ["id"]
784
+ });
785
+
786
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
787
+
788
+ let route = spikard_core::Route {
789
+ method: spikard_core::http::Method::Post,
790
+ path: "/test".to_string(),
791
+ handler_name: "test_handler".to_string(),
792
+ request_validator: Some(validator),
793
+ response_validator: None,
794
+ parameter_validator: None,
795
+ file_params: None,
796
+ is_async: true,
797
+ cors: None,
798
+ expects_json_body: true,
799
+ #[cfg(feature = "di")]
800
+ handler_dependencies: vec![],
801
+ };
802
+
803
+ let inner = Arc::new(SuccessEchoHandler);
804
+ let validator_handler = ValidatingHandler::new(inner, &route);
805
+
806
+ let request = Request::builder()
807
+ .method("POST")
808
+ .uri("/test")
809
+ .body(Body::empty())
810
+ .unwrap();
811
+
812
+ // Create request with null body and raw JSON bytes
813
+ let request_data = RequestData {
814
+ path_params: Arc::new(HashMap::new()),
815
+ query_params: json!({}),
816
+ raw_query_params: Arc::new(HashMap::new()),
817
+ body: Value::Null,
818
+ raw_body: Some(bytes::Bytes::from(br#"{"id":42}"#.to_vec())),
819
+ headers: Arc::new(HashMap::new()),
820
+ cookies: Arc::new(HashMap::new()),
821
+ method: "POST".to_string(),
822
+ path: "/test".to_string(),
823
+ #[cfg(feature = "di")]
824
+ dependencies: None,
825
+ };
826
+
827
+ let result = validator_handler.call(request, request_data).await;
828
+
829
+ assert!(result.is_ok(), "Should parse raw_body and validate successfully");
830
+ let response = result.unwrap();
831
+ assert_eq!(response.status(), StatusCode::OK);
832
+ }
833
+
834
+ /// Test 15: Validation error returns correct status code (422)
835
+ #[tokio::test]
836
+ async fn test_validation_error_status_code() {
837
+ let schema = json!({
838
+ "type": "object",
839
+ "properties": {
840
+ "count": {"type": "integer", "minimum": 1}
841
+ },
842
+ "required": ["count"]
843
+ });
844
+
845
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
846
+
847
+ let route = spikard_core::Route {
848
+ method: spikard_core::http::Method::Post,
849
+ path: "/test".to_string(),
850
+ handler_name: "test_handler".to_string(),
851
+ request_validator: Some(validator),
852
+ response_validator: None,
853
+ parameter_validator: None,
854
+ file_params: None,
855
+ is_async: true,
856
+ cors: None,
857
+ expects_json_body: true,
858
+ #[cfg(feature = "di")]
859
+ handler_dependencies: vec![],
860
+ };
861
+
862
+ let inner = Arc::new(SuccessEchoHandler);
863
+ let validator_handler = ValidatingHandler::new(inner, &route);
864
+
865
+ let request = Request::builder()
866
+ .method("POST")
867
+ .uri("/test")
868
+ .body(Body::empty())
869
+ .unwrap();
870
+
871
+ let request_data = create_request_data(json!({"count": 0}));
872
+
873
+ let result = validator_handler.call(request, request_data).await;
874
+
875
+ assert!(result.is_err());
876
+ let (status, _body) = result.unwrap_err();
877
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
878
+ }
879
+
880
+ /// Test 16: Invalid JSON parsing returns 400 status
881
+ #[tokio::test]
882
+ async fn test_invalid_json_parsing_status() {
883
+ let schema = json!({"type": "object"});
884
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
885
+
886
+ let route = spikard_core::Route {
887
+ method: spikard_core::http::Method::Post,
888
+ path: "/test".to_string(),
889
+ handler_name: "test_handler".to_string(),
890
+ request_validator: Some(validator),
891
+ response_validator: None,
892
+ parameter_validator: None,
893
+ file_params: None,
894
+ is_async: true,
895
+ cors: None,
896
+ expects_json_body: true,
897
+ #[cfg(feature = "di")]
898
+ handler_dependencies: vec![],
899
+ };
900
+
901
+ let inner = Arc::new(SuccessEchoHandler);
902
+ let validator_handler = ValidatingHandler::new(inner, &route);
903
+
904
+ let request = Request::builder()
905
+ .method("POST")
906
+ .uri("/test")
907
+ .body(Body::empty())
908
+ .unwrap();
909
+
910
+ let request_data = create_request_data_with_raw_body(b"[invalid]".to_vec());
911
+
912
+ let result = validator_handler.call(request, request_data).await;
913
+
914
+ assert!(result.is_err());
915
+ let (status, _body) = result.unwrap_err();
916
+ assert_eq!(status, StatusCode::BAD_REQUEST);
917
+ }
918
+
919
+ /// Test 17: Handler clones inner handler Arc correctly
920
+ #[tokio::test]
921
+ async fn test_inner_handler_arc_cloning() {
922
+ let route = spikard_core::Route {
923
+ method: spikard_core::http::Method::Post,
924
+ path: "/test".to_string(),
925
+ handler_name: "test_handler".to_string(),
926
+ request_validator: None,
927
+ response_validator: None,
928
+ parameter_validator: None,
929
+ file_params: None,
930
+ is_async: true,
931
+ cors: None,
932
+ expects_json_body: false,
933
+ #[cfg(feature = "di")]
934
+ handler_dependencies: vec![],
935
+ };
936
+
937
+ let inner = Arc::new(SuccessEchoHandler);
938
+ let original_arc_ptr = Arc::as_ptr(&inner);
939
+
940
+ let validator_handler = ValidatingHandler::new(inner.clone(), &route);
941
+
942
+ let request = Request::builder()
943
+ .method("POST")
944
+ .uri("/test")
945
+ .body(Body::empty())
946
+ .unwrap();
947
+
948
+ let request_data = create_request_data(json!({"data": "test"}));
949
+
950
+ let result = validator_handler.call(request, request_data).await;
951
+
952
+ assert!(result.is_ok());
953
+ // Arc pointer should be identical (same underlying allocation)
954
+ assert_eq!(Arc::as_ptr(&inner), original_arc_ptr);
955
+ }
956
+
957
+ /// Test 18: Panic during panic error serialization falls back to hardcoded JSON
958
+ #[tokio::test]
959
+ async fn test_panic_error_serialization_fallback() {
960
+ let route = spikard_core::Route {
961
+ method: spikard_core::http::Method::Post,
962
+ path: "/test".to_string(),
963
+ handler_name: "test_handler".to_string(),
964
+ request_validator: None,
965
+ response_validator: None,
966
+ parameter_validator: None,
967
+ file_params: None,
968
+ is_async: true,
969
+ cors: None,
970
+ expects_json_body: false,
971
+ #[cfg(feature = "di")]
972
+ handler_dependencies: vec![],
973
+ };
974
+
975
+ let inner = Arc::new(PanicHandlerImpl);
976
+ let validator_handler = ValidatingHandler::new(inner, &route);
977
+
978
+ let request = Request::builder()
979
+ .method("POST")
980
+ .uri("/test")
981
+ .body(Body::empty())
982
+ .unwrap();
983
+
984
+ let request_data = create_request_data(json!({}));
985
+
986
+ let result = validator_handler.call(request, request_data).await;
987
+
988
+ assert!(result.is_err());
989
+ let (_status, body) = result.unwrap_err();
990
+
991
+ // Should either be the serialized panic error or the fallback
992
+ // Both are valid JSON containing panic information
993
+ assert!(
994
+ body.contains("panic") || body.contains("Unexpected"),
995
+ "Body should contain panic-related information"
996
+ );
997
+ }
998
+
999
+ /// Test 19: Validation error body is valid JSON
1000
+ #[tokio::test]
1001
+ async fn test_validation_error_body_is_json() {
1002
+ let schema = json!({
1003
+ "type": "object",
1004
+ "properties": {
1005
+ "email": {"type": "string", "format": "email"}
1006
+ },
1007
+ "required": ["email"]
1008
+ });
1009
+
1010
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1011
+
1012
+ let route = spikard_core::Route {
1013
+ method: spikard_core::http::Method::Post,
1014
+ path: "/test".to_string(),
1015
+ handler_name: "test_handler".to_string(),
1016
+ request_validator: Some(validator),
1017
+ response_validator: None,
1018
+ parameter_validator: None,
1019
+ file_params: None,
1020
+ is_async: true,
1021
+ cors: None,
1022
+ expects_json_body: true,
1023
+ #[cfg(feature = "di")]
1024
+ handler_dependencies: vec![],
1025
+ };
1026
+
1027
+ let inner = Arc::new(SuccessEchoHandler);
1028
+ let validator_handler = ValidatingHandler::new(inner, &route);
1029
+
1030
+ let request = Request::builder()
1031
+ .method("POST")
1032
+ .uri("/test")
1033
+ .body(Body::empty())
1034
+ .unwrap();
1035
+
1036
+ let request_data = create_request_data(json!({}));
1037
+
1038
+ let result = validator_handler.call(request, request_data).await;
1039
+
1040
+ assert!(result.is_err());
1041
+ let (_status, body) = result.unwrap_err();
1042
+
1043
+ // Body must be valid JSON
1044
+ let parsed: serde_json::Value = serde_json::from_str(&body).expect("Validation error body must be valid JSON");
1045
+ assert!(parsed.is_object(), "Validation error body should be a JSON object");
1046
+ }
1047
+
1048
+ /// Test 20: No validators means handler executes without validation
1049
+ #[tokio::test]
1050
+ async fn test_no_validators_executes_handler_directly() {
1051
+ let route = spikard_core::Route {
1052
+ method: spikard_core::http::Method::Post,
1053
+ path: "/test".to_string(),
1054
+ handler_name: "test_handler".to_string(),
1055
+ request_validator: None,
1056
+ response_validator: None,
1057
+ parameter_validator: None,
1058
+ file_params: None,
1059
+ is_async: true,
1060
+ cors: None,
1061
+ expects_json_body: false,
1062
+ #[cfg(feature = "di")]
1063
+ handler_dependencies: vec![],
1064
+ };
1065
+
1066
+ let inner = Arc::new(SuccessEchoHandler);
1067
+ let validator_handler = ValidatingHandler::new(inner, &route);
1068
+
1069
+ let request = Request::builder()
1070
+ .method("POST")
1071
+ .uri("/test")
1072
+ .body(Body::empty())
1073
+ .unwrap();
1074
+
1075
+ let request_data = create_request_data(json!({"any": "data", "is": "ok"}));
1076
+
1077
+ let result = validator_handler.call(request, request_data).await;
1078
+
1079
+ assert!(result.is_ok(), "Without validators, any data should pass through");
1080
+ let response = result.unwrap();
1081
+ assert_eq!(response.status(), StatusCode::OK);
1082
+ }
1083
+
1084
+ /// Test 21: Handler correctly uses path params, headers, and cookies from request data
1085
+ #[tokio::test]
1086
+ async fn test_handler_with_path_headers_cookies() {
1087
+ let route = spikard_core::Route {
1088
+ method: spikard_core::http::Method::Get,
1089
+ path: "/api/{id}".to_string(),
1090
+ handler_name: "handler".to_string(),
1091
+ request_validator: None,
1092
+ response_validator: None,
1093
+ parameter_validator: None,
1094
+ file_params: None,
1095
+ is_async: true,
1096
+ cors: None,
1097
+ expects_json_body: false,
1098
+ #[cfg(feature = "di")]
1099
+ handler_dependencies: vec![],
1100
+ };
1101
+
1102
+ let inner = Arc::new(SuccessEchoHandler);
1103
+ let validator_handler = ValidatingHandler::new(inner, &route);
1104
+
1105
+ let request = Request::builder()
1106
+ .method("GET")
1107
+ .uri("/api/123?search=test")
1108
+ .body(Body::empty())
1109
+ .unwrap();
1110
+
1111
+ let mut request_data = create_request_data(json!({}));
1112
+ request_data.path_params = Arc::new({
1113
+ let mut m = HashMap::new();
1114
+ m.insert("id".to_string(), "123".to_string());
1115
+ m
1116
+ });
1117
+ request_data.headers = Arc::new({
1118
+ let mut m = HashMap::new();
1119
+ m.insert("x-custom".to_string(), "header-value".to_string());
1120
+ m
1121
+ });
1122
+ request_data.cookies = Arc::new({
1123
+ let mut m = HashMap::new();
1124
+ m.insert("session".to_string(), "abc123".to_string());
1125
+ m
1126
+ });
1127
+
1128
+ let result = validator_handler.call(request, request_data).await;
1129
+
1130
+ // Should execute successfully with all request data sources populated
1131
+ assert!(result.is_ok());
1132
+ }
1133
+
1134
+ /// Test 22: Panic in handler produces correct status 500
1135
+ #[tokio::test]
1136
+ async fn test_panic_produces_500_status() {
1137
+ let route = spikard_core::Route {
1138
+ method: spikard_core::http::Method::Post,
1139
+ path: "/test".to_string(),
1140
+ handler_name: "test_handler".to_string(),
1141
+ request_validator: None,
1142
+ response_validator: None,
1143
+ parameter_validator: None,
1144
+ file_params: None,
1145
+ is_async: true,
1146
+ cors: None,
1147
+ expects_json_body: false,
1148
+ #[cfg(feature = "di")]
1149
+ handler_dependencies: vec![],
1150
+ };
1151
+
1152
+ let inner = Arc::new(PanicHandlerImpl);
1153
+ let validator_handler = ValidatingHandler::new(inner, &route);
1154
+
1155
+ let request = Request::builder()
1156
+ .method("POST")
1157
+ .uri("/test")
1158
+ .body(Body::empty())
1159
+ .unwrap();
1160
+
1161
+ let request_data = create_request_data(json!({}));
1162
+
1163
+ let result = validator_handler.call(request, request_data).await;
1164
+
1165
+ assert!(result.is_err());
1166
+ let (status, _body) = result.unwrap_err();
1167
+ assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR);
1168
+ }
1169
+
1170
+ /// Test 23: Valid JSON but invalid schema should fail validation
1171
+ #[tokio::test]
1172
+ async fn test_valid_json_invalid_schema() {
1173
+ let schema = json!({
1174
+ "type": "object",
1175
+ "properties": {
1176
+ "price": {"type": "number", "minimum": 0, "maximum": 1000}
1177
+ },
1178
+ "required": ["price"]
1179
+ });
1180
+
1181
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1182
+
1183
+ let route = spikard_core::Route {
1184
+ method: spikard_core::http::Method::Post,
1185
+ path: "/test".to_string(),
1186
+ handler_name: "test_handler".to_string(),
1187
+ request_validator: Some(validator),
1188
+ response_validator: None,
1189
+ parameter_validator: None,
1190
+ file_params: None,
1191
+ is_async: true,
1192
+ cors: None,
1193
+ expects_json_body: true,
1194
+ #[cfg(feature = "di")]
1195
+ handler_dependencies: vec![],
1196
+ };
1197
+
1198
+ let inner = Arc::new(SuccessEchoHandler);
1199
+ let validator_handler = ValidatingHandler::new(inner, &route);
1200
+
1201
+ let request = Request::builder()
1202
+ .method("POST")
1203
+ .uri("/test")
1204
+ .body(Body::empty())
1205
+ .unwrap();
1206
+
1207
+ // Valid JSON but price exceeds maximum
1208
+ let request_data = create_request_data(json!({"price": 2000.0}));
1209
+
1210
+ let result = validator_handler.call(request, request_data).await;
1211
+
1212
+ assert!(result.is_err(), "Should fail schema validation");
1213
+ let (status, _body) = result.unwrap_err();
1214
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
1215
+ }
1216
+
1217
+ /// Test 24: Empty raw body bytes with validator
1218
+ #[tokio::test]
1219
+ async fn test_empty_raw_body_bytes() {
1220
+ let schema = json!({
1221
+ "type": "object"
1222
+ });
1223
+
1224
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1225
+
1226
+ let route = spikard_core::Route {
1227
+ method: spikard_core::http::Method::Post,
1228
+ path: "/test".to_string(),
1229
+ handler_name: "test_handler".to_string(),
1230
+ request_validator: Some(validator),
1231
+ response_validator: None,
1232
+ parameter_validator: None,
1233
+ file_params: None,
1234
+ is_async: true,
1235
+ cors: None,
1236
+ expects_json_body: true,
1237
+ #[cfg(feature = "di")]
1238
+ handler_dependencies: vec![],
1239
+ };
1240
+
1241
+ let inner = Arc::new(SuccessEchoHandler);
1242
+ let validator_handler = ValidatingHandler::new(inner, &route);
1243
+
1244
+ let request = Request::builder()
1245
+ .method("POST")
1246
+ .uri("/test")
1247
+ .body(Body::empty())
1248
+ .unwrap();
1249
+
1250
+ // Empty bytes array should fail JSON parsing
1251
+ let request_data = create_request_data_with_raw_body(vec![]);
1252
+
1253
+ let result = validator_handler.call(request, request_data).await;
1254
+
1255
+ assert!(result.is_err(), "Empty raw body should fail JSON parsing");
1256
+ let (status, _body) = result.unwrap_err();
1257
+ assert_eq!(status, StatusCode::BAD_REQUEST);
1258
+ }
1259
+
1260
+ /// Test 25: JSON parsing error message contains useful info
1261
+ #[tokio::test]
1262
+ async fn test_json_parsing_error_message() {
1263
+ let schema = json!({"type": "object"});
1264
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1265
+
1266
+ let route = spikard_core::Route {
1267
+ method: spikard_core::http::Method::Post,
1268
+ path: "/test".to_string(),
1269
+ handler_name: "test_handler".to_string(),
1270
+ request_validator: Some(validator),
1271
+ response_validator: None,
1272
+ parameter_validator: None,
1273
+ file_params: None,
1274
+ is_async: true,
1275
+ cors: None,
1276
+ expects_json_body: true,
1277
+ #[cfg(feature = "di")]
1278
+ handler_dependencies: vec![],
1279
+ };
1280
+
1281
+ let inner = Arc::new(SuccessEchoHandler);
1282
+ let validator_handler = ValidatingHandler::new(inner, &route);
1283
+
1284
+ let request = Request::builder()
1285
+ .method("POST")
1286
+ .uri("/test")
1287
+ .body(Body::empty())
1288
+ .unwrap();
1289
+
1290
+ let request_data = create_request_data_with_raw_body(b"not valid json}}".to_vec());
1291
+
1292
+ let result = validator_handler.call(request, request_data).await;
1293
+
1294
+ assert!(result.is_err());
1295
+ let (_status, body) = result.unwrap_err();
1296
+ assert!(
1297
+ body.contains("Invalid JSON"),
1298
+ "Error message should mention invalid JSON"
1299
+ );
1300
+ }
1301
+
1302
+ /// Test 26: Nested object validation in request body
1303
+ #[tokio::test]
1304
+ async fn test_nested_object_validation() {
1305
+ let schema = json!({
1306
+ "type": "object",
1307
+ "properties": {
1308
+ "user": {
1309
+ "type": "object",
1310
+ "properties": {
1311
+ "name": {"type": "string"},
1312
+ "age": {"type": "integer"}
1313
+ },
1314
+ "required": ["name"]
1315
+ }
1316
+ },
1317
+ "required": ["user"]
1318
+ });
1319
+
1320
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1321
+
1322
+ let route = spikard_core::Route {
1323
+ method: spikard_core::http::Method::Post,
1324
+ path: "/test".to_string(),
1325
+ handler_name: "test_handler".to_string(),
1326
+ request_validator: Some(validator),
1327
+ response_validator: None,
1328
+ parameter_validator: None,
1329
+ file_params: None,
1330
+ is_async: true,
1331
+ cors: None,
1332
+ expects_json_body: true,
1333
+ #[cfg(feature = "di")]
1334
+ handler_dependencies: vec![],
1335
+ };
1336
+
1337
+ let inner = Arc::new(SuccessEchoHandler);
1338
+ let validator_handler = ValidatingHandler::new(inner, &route);
1339
+
1340
+ let request = Request::builder()
1341
+ .method("POST")
1342
+ .uri("/test")
1343
+ .body(Body::empty())
1344
+ .unwrap();
1345
+
1346
+ // Missing required name in nested user object
1347
+ let request_data = create_request_data(json!({"user": {"age": 30}}));
1348
+
1349
+ let result = validator_handler.call(request, request_data).await;
1350
+
1351
+ assert!(result.is_err());
1352
+ let (status, body) = result.unwrap_err();
1353
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
1354
+
1355
+ let problem: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
1356
+ assert!(problem["errors"].is_array(), "Should contain errors array");
1357
+ }
1358
+
1359
+ /// Test 27: Array validation in request body
1360
+ #[tokio::test]
1361
+ async fn test_array_validation() {
1362
+ let schema = json!({
1363
+ "type": "object",
1364
+ "properties": {
1365
+ "items": {
1366
+ "type": "array",
1367
+ "items": {"type": "string"}
1368
+ }
1369
+ },
1370
+ "required": ["items"]
1371
+ });
1372
+
1373
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1374
+
1375
+ let route = spikard_core::Route {
1376
+ method: spikard_core::http::Method::Post,
1377
+ path: "/test".to_string(),
1378
+ handler_name: "test_handler".to_string(),
1379
+ request_validator: Some(validator),
1380
+ response_validator: None,
1381
+ parameter_validator: None,
1382
+ file_params: None,
1383
+ is_async: true,
1384
+ cors: None,
1385
+ expects_json_body: true,
1386
+ #[cfg(feature = "di")]
1387
+ handler_dependencies: vec![],
1388
+ };
1389
+
1390
+ let inner = Arc::new(SuccessEchoHandler);
1391
+ let validator_handler = ValidatingHandler::new(inner, &route);
1392
+
1393
+ let request = Request::builder()
1394
+ .method("POST")
1395
+ .uri("/test")
1396
+ .body(Body::empty())
1397
+ .unwrap();
1398
+
1399
+ // Valid array of strings
1400
+ let request_data = create_request_data(json!({"items": ["a", "b", "c"]}));
1401
+
1402
+ let result = validator_handler.call(request, request_data).await;
1403
+
1404
+ assert!(result.is_ok(), "Valid array should pass validation");
1405
+ }
1406
+
1407
+ /// Test 28: Array with wrong item type validation error
1408
+ #[tokio::test]
1409
+ async fn test_array_wrong_item_type() {
1410
+ let schema = json!({
1411
+ "type": "object",
1412
+ "properties": {
1413
+ "tags": {
1414
+ "type": "array",
1415
+ "items": {"type": "string"}
1416
+ }
1417
+ },
1418
+ "required": ["tags"]
1419
+ });
1420
+
1421
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1422
+
1423
+ let route = spikard_core::Route {
1424
+ method: spikard_core::http::Method::Post,
1425
+ path: "/test".to_string(),
1426
+ handler_name: "test_handler".to_string(),
1427
+ request_validator: Some(validator),
1428
+ response_validator: None,
1429
+ parameter_validator: None,
1430
+ file_params: None,
1431
+ is_async: true,
1432
+ cors: None,
1433
+ expects_json_body: true,
1434
+ #[cfg(feature = "di")]
1435
+ handler_dependencies: vec![],
1436
+ };
1437
+
1438
+ let inner = Arc::new(SuccessEchoHandler);
1439
+ let validator_handler = ValidatingHandler::new(inner, &route);
1440
+
1441
+ let request = Request::builder()
1442
+ .method("POST")
1443
+ .uri("/test")
1444
+ .body(Body::empty())
1445
+ .unwrap();
1446
+
1447
+ // Array with non-string items
1448
+ let request_data = create_request_data(json!({"tags": ["tag1", 42, "tag3"]}));
1449
+
1450
+ let result = validator_handler.call(request, request_data).await;
1451
+
1452
+ assert!(result.is_err(), "Array with wrong item type should fail");
1453
+ let (status, _body) = result.unwrap_err();
1454
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
1455
+ }
1456
+
1457
+ /// Test 29: Unwind safety with concurrent handler execution
1458
+ #[tokio::test]
1459
+ async fn test_concurrent_panic_handling() {
1460
+ let route = spikard_core::Route {
1461
+ method: spikard_core::http::Method::Post,
1462
+ path: "/test".to_string(),
1463
+ handler_name: "test_handler".to_string(),
1464
+ request_validator: None,
1465
+ response_validator: None,
1466
+ parameter_validator: None,
1467
+ file_params: None,
1468
+ is_async: true,
1469
+ cors: None,
1470
+ expects_json_body: false,
1471
+ #[cfg(feature = "di")]
1472
+ handler_dependencies: vec![],
1473
+ };
1474
+
1475
+ let inner = Arc::new(PanicHandlerImpl);
1476
+ let validator_handler = Arc::new(ValidatingHandler::new(inner, &route));
1477
+
1478
+ let mut handles = vec![];
1479
+
1480
+ // Spawn multiple concurrent requests
1481
+ for i in 0..5 {
1482
+ let handler = validator_handler.clone();
1483
+ let handle = tokio::spawn(async move {
1484
+ let request = Request::builder()
1485
+ .method("POST")
1486
+ .uri("/test")
1487
+ .body(Body::empty())
1488
+ .unwrap();
1489
+
1490
+ let request_data = create_request_data(json!({"id": i}));
1491
+
1492
+ let result = handler.call(request, request_data).await;
1493
+ assert!(result.is_err(), "Each concurrent panic should be caught");
1494
+
1495
+ let (status, _body) = result.unwrap_err();
1496
+ assert_eq!(status, StatusCode::INTERNAL_SERVER_ERROR);
1497
+ });
1498
+
1499
+ handles.push(handle);
1500
+ }
1501
+
1502
+ for handle in handles {
1503
+ handle.await.expect("Concurrent test should complete");
1504
+ }
1505
+ }
1506
+
1507
+ /// Test 30: Problem details status code from validation error
1508
+ #[tokio::test]
1509
+ async fn test_problem_details_status_code_mapping() {
1510
+ let schema = json!({
1511
+ "type": "object",
1512
+ "properties": {
1513
+ "required_field": {"type": "string"}
1514
+ },
1515
+ "required": ["required_field"]
1516
+ });
1517
+
1518
+ let validator = Arc::new(SchemaValidator::new(schema).unwrap());
1519
+
1520
+ let route = spikard_core::Route {
1521
+ method: spikard_core::http::Method::Post,
1522
+ path: "/test".to_string(),
1523
+ handler_name: "test_handler".to_string(),
1524
+ request_validator: Some(validator),
1525
+ response_validator: None,
1526
+ parameter_validator: None,
1527
+ file_params: None,
1528
+ is_async: true,
1529
+ cors: None,
1530
+ expects_json_body: true,
1531
+ #[cfg(feature = "di")]
1532
+ handler_dependencies: vec![],
1533
+ };
1534
+
1535
+ let inner = Arc::new(SuccessEchoHandler);
1536
+ let validator_handler = ValidatingHandler::new(inner, &route);
1537
+
1538
+ let request = Request::builder()
1539
+ .method("POST")
1540
+ .uri("/test")
1541
+ .body(Body::empty())
1542
+ .unwrap();
1543
+
1544
+ let request_data = create_request_data(json!({}));
1545
+
1546
+ let result = validator_handler.call(request, request_data).await;
1547
+
1548
+ assert!(result.is_err());
1549
+ let (status, body) = result.unwrap_err();
1550
+
1551
+ // ProblemDetails::from_validation_error should produce status_code()
1552
+ assert_eq!(status, StatusCode::UNPROCESSABLE_ENTITY);
1553
+
1554
+ let problem: serde_json::Value = serde_json::from_str(&body).expect("Should parse as JSON");
1555
+ assert_eq!(problem["status"], 422);
1556
+ }
1557
+ }