spikard 0.5.0 → 0.6.1

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 (135) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +1 -1
  3. data/README.md +674 -674
  4. data/ext/spikard_rb/Cargo.toml +17 -17
  5. data/ext/spikard_rb/extconf.rb +13 -10
  6. data/ext/spikard_rb/src/lib.rs +6 -6
  7. data/lib/spikard/app.rb +405 -405
  8. data/lib/spikard/background.rb +27 -27
  9. data/lib/spikard/config.rb +396 -396
  10. data/lib/spikard/converters.rb +13 -13
  11. data/lib/spikard/handler_wrapper.rb +113 -113
  12. data/lib/spikard/provide.rb +214 -214
  13. data/lib/spikard/response.rb +173 -173
  14. data/lib/spikard/schema.rb +243 -243
  15. data/lib/spikard/sse.rb +111 -111
  16. data/lib/spikard/streaming_response.rb +44 -44
  17. data/lib/spikard/testing.rb +256 -256
  18. data/lib/spikard/upload_file.rb +131 -131
  19. data/lib/spikard/version.rb +5 -5
  20. data/lib/spikard/websocket.rb +59 -59
  21. data/lib/spikard.rb +43 -43
  22. data/sig/spikard.rbs +366 -366
  23. data/vendor/crates/spikard-bindings-shared/Cargo.toml +63 -63
  24. data/vendor/crates/spikard-bindings-shared/examples/config_extraction.rs +132 -132
  25. data/vendor/crates/spikard-bindings-shared/src/config_extractor.rs +752 -752
  26. data/vendor/crates/spikard-bindings-shared/src/conversion_traits.rs +194 -194
  27. data/vendor/crates/spikard-bindings-shared/src/di_traits.rs +246 -246
  28. data/vendor/crates/spikard-bindings-shared/src/error_response.rs +401 -401
  29. data/vendor/crates/spikard-bindings-shared/src/handler_base.rs +238 -238
  30. data/vendor/crates/spikard-bindings-shared/src/lib.rs +24 -24
  31. data/vendor/crates/spikard-bindings-shared/src/lifecycle_base.rs +292 -292
  32. data/vendor/crates/spikard-bindings-shared/src/lifecycle_executor.rs +616 -616
  33. data/vendor/crates/spikard-bindings-shared/src/response_builder.rs +305 -305
  34. data/vendor/crates/spikard-bindings-shared/src/test_client_base.rs +248 -248
  35. data/vendor/crates/spikard-bindings-shared/src/validation_helpers.rs +351 -351
  36. data/vendor/crates/spikard-bindings-shared/tests/comprehensive_coverage.rs +454 -454
  37. data/vendor/crates/spikard-bindings-shared/tests/error_response_edge_cases.rs +383 -383
  38. data/vendor/crates/spikard-bindings-shared/tests/handler_base_integration.rs +280 -280
  39. data/vendor/crates/spikard-core/Cargo.toml +40 -40
  40. data/vendor/crates/spikard-core/src/bindings/mod.rs +3 -3
  41. data/vendor/crates/spikard-core/src/bindings/response.rs +133 -133
  42. data/vendor/crates/spikard-core/src/debug.rs +127 -127
  43. data/vendor/crates/spikard-core/src/di/container.rs +702 -702
  44. data/vendor/crates/spikard-core/src/di/dependency.rs +273 -273
  45. data/vendor/crates/spikard-core/src/di/error.rs +118 -118
  46. data/vendor/crates/spikard-core/src/di/factory.rs +534 -534
  47. data/vendor/crates/spikard-core/src/di/graph.rs +506 -506
  48. data/vendor/crates/spikard-core/src/di/mod.rs +192 -192
  49. data/vendor/crates/spikard-core/src/di/resolved.rs +405 -405
  50. data/vendor/crates/spikard-core/src/di/value.rs +281 -281
  51. data/vendor/crates/spikard-core/src/errors.rs +69 -69
  52. data/vendor/crates/spikard-core/src/http.rs +415 -415
  53. data/vendor/crates/spikard-core/src/lib.rs +29 -29
  54. data/vendor/crates/spikard-core/src/lifecycle.rs +1186 -1186
  55. data/vendor/crates/spikard-core/src/metadata.rs +389 -389
  56. data/vendor/crates/spikard-core/src/parameters.rs +2525 -2525
  57. data/vendor/crates/spikard-core/src/problem.rs +344 -344
  58. data/vendor/crates/spikard-core/src/request_data.rs +1154 -1154
  59. data/vendor/crates/spikard-core/src/router.rs +510 -510
  60. data/vendor/crates/spikard-core/src/schema_registry.rs +183 -183
  61. data/vendor/crates/spikard-core/src/type_hints.rs +304 -304
  62. data/vendor/crates/spikard-core/src/validation/error_mapper.rs +696 -688
  63. data/vendor/crates/spikard-core/src/validation/mod.rs +457 -457
  64. data/vendor/crates/spikard-http/Cargo.toml +62 -64
  65. data/vendor/crates/spikard-http/examples/sse-notifications.rs +148 -148
  66. data/vendor/crates/spikard-http/examples/websocket-chat.rs +92 -92
  67. data/vendor/crates/spikard-http/src/auth.rs +296 -296
  68. data/vendor/crates/spikard-http/src/background.rs +1860 -1860
  69. data/vendor/crates/spikard-http/src/bindings/mod.rs +3 -3
  70. data/vendor/crates/spikard-http/src/bindings/response.rs +1 -1
  71. data/vendor/crates/spikard-http/src/body_metadata.rs +8 -8
  72. data/vendor/crates/spikard-http/src/cors.rs +1005 -1005
  73. data/vendor/crates/spikard-http/src/debug.rs +128 -128
  74. data/vendor/crates/spikard-http/src/di_handler.rs +1668 -1668
  75. data/vendor/crates/spikard-http/src/handler_response.rs +901 -901
  76. data/vendor/crates/spikard-http/src/handler_trait.rs +838 -830
  77. data/vendor/crates/spikard-http/src/handler_trait_tests.rs +290 -290
  78. data/vendor/crates/spikard-http/src/lib.rs +534 -534
  79. data/vendor/crates/spikard-http/src/lifecycle/adapter.rs +230 -230
  80. data/vendor/crates/spikard-http/src/lifecycle.rs +1193 -1193
  81. data/vendor/crates/spikard-http/src/middleware/mod.rs +560 -540
  82. data/vendor/crates/spikard-http/src/middleware/multipart.rs +912 -912
  83. data/vendor/crates/spikard-http/src/middleware/urlencoded.rs +513 -513
  84. data/vendor/crates/spikard-http/src/middleware/validation.rs +768 -735
  85. data/vendor/crates/spikard-http/src/openapi/mod.rs +309 -309
  86. data/vendor/crates/spikard-http/src/openapi/parameter_extraction.rs +535 -535
  87. data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs +1363 -1363
  88. data/vendor/crates/spikard-http/src/openapi/spec_generation.rs +665 -665
  89. data/vendor/crates/spikard-http/src/query_parser.rs +793 -793
  90. data/vendor/crates/spikard-http/src/response.rs +720 -720
  91. data/vendor/crates/spikard-http/src/server/handler.rs +1650 -1650
  92. data/vendor/crates/spikard-http/src/server/lifecycle_execution.rs +234 -234
  93. data/vendor/crates/spikard-http/src/server/mod.rs +1593 -1502
  94. data/vendor/crates/spikard-http/src/server/request_extraction.rs +789 -770
  95. data/vendor/crates/spikard-http/src/server/routing_factory.rs +629 -599
  96. data/vendor/crates/spikard-http/src/sse.rs +1409 -1409
  97. data/vendor/crates/spikard-http/src/testing/form.rs +52 -52
  98. data/vendor/crates/spikard-http/src/testing/multipart.rs +64 -60
  99. data/vendor/crates/spikard-http/src/testing/test_client.rs +311 -283
  100. data/vendor/crates/spikard-http/src/testing.rs +406 -377
  101. data/vendor/crates/spikard-http/src/websocket.rs +1404 -1375
  102. data/vendor/crates/spikard-http/tests/background_behavior.rs +832 -832
  103. data/vendor/crates/spikard-http/tests/common/handlers.rs +309 -309
  104. data/vendor/crates/spikard-http/tests/common/mod.rs +26 -26
  105. data/vendor/crates/spikard-http/tests/di_integration.rs +192 -192
  106. data/vendor/crates/spikard-http/tests/doc_snippets.rs +5 -5
  107. data/vendor/crates/spikard-http/tests/lifecycle_execution.rs +1093 -1093
  108. data/vendor/crates/spikard-http/tests/multipart_behavior.rs +656 -656
  109. data/vendor/crates/spikard-http/tests/server_config_builder.rs +314 -314
  110. data/vendor/crates/spikard-http/tests/sse_behavior.rs +620 -620
  111. data/vendor/crates/spikard-http/tests/websocket_behavior.rs +663 -663
  112. data/vendor/crates/spikard-rb/Cargo.toml +48 -48
  113. data/vendor/crates/spikard-rb/build.rs +199 -199
  114. data/vendor/crates/spikard-rb/src/background.rs +63 -63
  115. data/vendor/crates/spikard-rb/src/config/mod.rs +5 -5
  116. data/vendor/crates/spikard-rb/src/config/server_config.rs +285 -285
  117. data/vendor/crates/spikard-rb/src/conversion.rs +554 -554
  118. data/vendor/crates/spikard-rb/src/di/builder.rs +100 -100
  119. data/vendor/crates/spikard-rb/src/di/mod.rs +375 -375
  120. data/vendor/crates/spikard-rb/src/handler.rs +618 -618
  121. data/vendor/crates/spikard-rb/src/integration/mod.rs +3 -3
  122. data/vendor/crates/spikard-rb/src/lib.rs +1806 -1810
  123. data/vendor/crates/spikard-rb/src/lifecycle.rs +275 -275
  124. data/vendor/crates/spikard-rb/src/metadata/mod.rs +5 -5
  125. data/vendor/crates/spikard-rb/src/metadata/route_extraction.rs +442 -447
  126. data/vendor/crates/spikard-rb/src/runtime/mod.rs +5 -5
  127. data/vendor/crates/spikard-rb/src/runtime/server_runner.rs +324 -324
  128. data/vendor/crates/spikard-rb/src/server.rs +305 -308
  129. data/vendor/crates/spikard-rb/src/sse.rs +231 -231
  130. data/vendor/crates/spikard-rb/src/testing/client.rs +538 -551
  131. data/vendor/crates/spikard-rb/src/testing/mod.rs +7 -7
  132. data/vendor/crates/spikard-rb/src/testing/sse.rs +143 -143
  133. data/vendor/crates/spikard-rb/src/testing/websocket.rs +608 -635
  134. data/vendor/crates/spikard-rb/src/websocket.rs +377 -374
  135. metadata +15 -1
@@ -1,238 +1,238 @@
1
- //! Base handler traits and execution infrastructure
2
- //!
3
- //! This module provides language-agnostic handler execution patterns that
4
- //! eliminate duplicate code across Node, Ruby, PHP, and WASM bindings.
5
-
6
- use std::future::Future;
7
- use std::pin::Pin;
8
- use std::sync::Arc;
9
-
10
- use axum::body::Body;
11
- use axum::http::{Request, Response};
12
- use spikard_core::validation::{SchemaValidator, ValidationError};
13
- use spikard_http::Handler;
14
- use spikard_http::handler_trait::{HandlerResult, RequestData};
15
-
16
- use crate::error_response::ErrorResponseBuilder;
17
-
18
- /// Error type for handler operations
19
- #[derive(Debug, thiserror::Error)]
20
- pub enum HandlerError {
21
- #[error("Validation error: {0}")]
22
- Validation(String),
23
-
24
- #[error("Handler execution error: {0}")]
25
- Execution(String),
26
-
27
- #[error("Response conversion error: {0}")]
28
- ResponseConversion(String),
29
-
30
- #[error("Internal error: {0}")]
31
- Internal(String),
32
- }
33
-
34
- impl From<ValidationError> for HandlerError {
35
- fn from(err: ValidationError) -> Self {
36
- HandlerError::Validation(format!("{:?}", err))
37
- }
38
- }
39
-
40
- /// Language-specific handler implementation
41
- ///
42
- /// This trait defines the three key operations that every language binding must implement:
43
- /// 1. Prepare request data for the language runtime
44
- /// 2. Invoke the handler in the language runtime
45
- /// 3. Interpret the response from the language runtime
46
- ///
47
- /// The `HandlerExecutor` handles all common logic (validation, error formatting)
48
- /// while delegating language-specific operations to implementations of this trait.
49
- pub trait LanguageHandler: Send + Sync {
50
- /// Input type passed to the language handler
51
- type Input: Send;
52
-
53
- /// Output type returned from the language handler
54
- type Output: Send;
55
-
56
- /// Prepare request data for passing to the language handler
57
- fn prepare_request(&self, request_data: &RequestData) -> Result<Self::Input, HandlerError>;
58
-
59
- /// Invoke the language-specific handler with the prepared input
60
- fn invoke_handler(
61
- &self,
62
- input: Self::Input,
63
- ) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>>;
64
-
65
- /// Interpret the handler's output and convert it to an HTTP response
66
- fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError>;
67
- }
68
-
69
- /// Universal handler executor that works with any language binding
70
- ///
71
- /// This struct consolidates the common handler execution flow:
72
- /// - Request body validation
73
- /// - Handler invocation
74
- /// - Error handling and formatting
75
- ///
76
- /// Language bindings provide thin wrappers that implement `LanguageHandler`.
77
- pub struct HandlerExecutor<L: LanguageHandler> {
78
- language_handler: Arc<L>,
79
- request_validator: Option<Arc<SchemaValidator>>,
80
- }
81
-
82
- impl<L: LanguageHandler> HandlerExecutor<L> {
83
- /// Create a new handler executor
84
- pub fn new(language_handler: Arc<L>, request_validator: Option<Arc<SchemaValidator>>) -> Self {
85
- Self {
86
- language_handler,
87
- request_validator,
88
- }
89
- }
90
-
91
- /// Create a handler executor with only a language handler
92
- pub fn with_handler(language_handler: Arc<L>) -> Self {
93
- Self {
94
- language_handler,
95
- request_validator: None,
96
- }
97
- }
98
-
99
- /// Add request validation to this executor
100
- pub fn with_request_validator(mut self, validator: Arc<SchemaValidator>) -> Self {
101
- self.request_validator = Some(validator);
102
- self
103
- }
104
- }
105
-
106
- impl<L: LanguageHandler + 'static> Handler for HandlerExecutor<L> {
107
- fn call(
108
- &self,
109
- _request: Request<Body>,
110
- request_data: RequestData,
111
- ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
112
- Box::pin(async move {
113
- if let Some(validator) = &self.request_validator
114
- && let Err(validation_err) = validator.validate(&request_data.body)
115
- {
116
- return Err(ErrorResponseBuilder::validation_error(&validation_err));
117
- }
118
-
119
- let input = self
120
- .language_handler
121
- .prepare_request(&request_data)
122
- .map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to prepare request: {}", e)))?;
123
-
124
- let output = self
125
- .language_handler
126
- .invoke_handler(input)
127
- .await
128
- .map_err(|e| ErrorResponseBuilder::internal_error(format!("Handler execution failed: {}", e)))?;
129
-
130
- let response = self
131
- .language_handler
132
- .interpret_response(output)
133
- .map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to interpret response: {}", e)))?;
134
-
135
- Ok(response)
136
- })
137
- }
138
- }
139
-
140
- #[cfg(test)]
141
- mod tests {
142
- use super::*;
143
- use serde_json::json;
144
-
145
- struct MockLanguageHandler;
146
-
147
- impl LanguageHandler for MockLanguageHandler {
148
- type Input = String;
149
- type Output = String;
150
-
151
- fn prepare_request(&self, _data: &RequestData) -> Result<Self::Input, HandlerError> {
152
- Ok("test_input".to_string())
153
- }
154
-
155
- fn invoke_handler(
156
- &self,
157
- _input: Self::Input,
158
- ) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>> {
159
- Box::pin(async { Ok("test_output".to_string()) })
160
- }
161
-
162
- fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError> {
163
- Ok(Response::builder().status(200).body(Body::from(output)).unwrap())
164
- }
165
- }
166
-
167
- #[tokio::test]
168
- async fn test_handler_executor_basic() {
169
- let mock_handler = Arc::new(MockLanguageHandler);
170
- let executor = HandlerExecutor::new(mock_handler, None);
171
-
172
- let request = Request::builder().body(Body::empty()).unwrap();
173
- let request_data = RequestData {
174
- path_params: Arc::new(std::collections::HashMap::new()),
175
- query_params: json!({}),
176
- validated_params: None,
177
- raw_query_params: Arc::new(std::collections::HashMap::new()),
178
- body: json!({}),
179
- raw_body: None,
180
- headers: Arc::new(std::collections::HashMap::new()),
181
- cookies: Arc::new(std::collections::HashMap::new()),
182
- method: "GET".to_string(),
183
- path: "/test".to_string(),
184
- dependencies: None,
185
- };
186
-
187
- let result = executor.call(request, request_data).await;
188
- assert!(result.is_ok());
189
- }
190
-
191
- #[tokio::test]
192
- async fn test_handler_executor_with_handler_only() {
193
- let mock_handler = Arc::new(MockLanguageHandler);
194
- let executor = HandlerExecutor::with_handler(mock_handler);
195
-
196
- let request = Request::builder().body(Body::empty()).unwrap();
197
- let request_data = RequestData {
198
- path_params: Arc::new(std::collections::HashMap::new()),
199
- query_params: json!({}),
200
- validated_params: None,
201
- raw_query_params: Arc::new(std::collections::HashMap::new()),
202
- body: json!({}),
203
- raw_body: None,
204
- headers: Arc::new(std::collections::HashMap::new()),
205
- cookies: Arc::new(std::collections::HashMap::new()),
206
- method: "GET".to_string(),
207
- path: "/test".to_string(),
208
- dependencies: None,
209
- };
210
-
211
- let result = executor.call(request, request_data).await;
212
- assert!(result.is_ok());
213
- }
214
-
215
- #[test]
216
- fn test_handler_error_validation() {
217
- let err = HandlerError::Validation("test error".to_string());
218
- assert_eq!(err.to_string(), "Validation error: test error");
219
- }
220
-
221
- #[test]
222
- fn test_handler_error_execution() {
223
- let err = HandlerError::Execution("test error".to_string());
224
- assert_eq!(err.to_string(), "Handler execution error: test error");
225
- }
226
-
227
- #[test]
228
- fn test_handler_error_response_conversion() {
229
- let err = HandlerError::ResponseConversion("test error".to_string());
230
- assert_eq!(err.to_string(), "Response conversion error: test error");
231
- }
232
-
233
- #[test]
234
- fn test_handler_error_internal() {
235
- let err = HandlerError::Internal("test error".to_string());
236
- assert_eq!(err.to_string(), "Internal error: test error");
237
- }
238
- }
1
+ //! Base handler traits and execution infrastructure
2
+ //!
3
+ //! This module provides language-agnostic handler execution patterns that
4
+ //! eliminate duplicate code across Node, Ruby, PHP, and WASM bindings.
5
+
6
+ use std::future::Future;
7
+ use std::pin::Pin;
8
+ use std::sync::Arc;
9
+
10
+ use axum::body::Body;
11
+ use axum::http::{Request, Response};
12
+ use spikard_core::validation::{SchemaValidator, ValidationError};
13
+ use spikard_http::Handler;
14
+ use spikard_http::handler_trait::{HandlerResult, RequestData};
15
+
16
+ use crate::error_response::ErrorResponseBuilder;
17
+
18
+ /// Error type for handler operations
19
+ #[derive(Debug, thiserror::Error)]
20
+ pub enum HandlerError {
21
+ #[error("Validation error: {0}")]
22
+ Validation(String),
23
+
24
+ #[error("Handler execution error: {0}")]
25
+ Execution(String),
26
+
27
+ #[error("Response conversion error: {0}")]
28
+ ResponseConversion(String),
29
+
30
+ #[error("Internal error: {0}")]
31
+ Internal(String),
32
+ }
33
+
34
+ impl From<ValidationError> for HandlerError {
35
+ fn from(err: ValidationError) -> Self {
36
+ HandlerError::Validation(format!("{:?}", err))
37
+ }
38
+ }
39
+
40
+ /// Language-specific handler implementation
41
+ ///
42
+ /// This trait defines the three key operations that every language binding must implement:
43
+ /// 1. Prepare request data for the language runtime
44
+ /// 2. Invoke the handler in the language runtime
45
+ /// 3. Interpret the response from the language runtime
46
+ ///
47
+ /// The `HandlerExecutor` handles all common logic (validation, error formatting)
48
+ /// while delegating language-specific operations to implementations of this trait.
49
+ pub trait LanguageHandler: Send + Sync {
50
+ /// Input type passed to the language handler
51
+ type Input: Send;
52
+
53
+ /// Output type returned from the language handler
54
+ type Output: Send;
55
+
56
+ /// Prepare request data for passing to the language handler
57
+ fn prepare_request(&self, request_data: &RequestData) -> Result<Self::Input, HandlerError>;
58
+
59
+ /// Invoke the language-specific handler with the prepared input
60
+ fn invoke_handler(
61
+ &self,
62
+ input: Self::Input,
63
+ ) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>>;
64
+
65
+ /// Interpret the handler's output and convert it to an HTTP response
66
+ fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError>;
67
+ }
68
+
69
+ /// Universal handler executor that works with any language binding
70
+ ///
71
+ /// This struct consolidates the common handler execution flow:
72
+ /// - Request body validation
73
+ /// - Handler invocation
74
+ /// - Error handling and formatting
75
+ ///
76
+ /// Language bindings provide thin wrappers that implement `LanguageHandler`.
77
+ pub struct HandlerExecutor<L: LanguageHandler> {
78
+ language_handler: Arc<L>,
79
+ request_validator: Option<Arc<SchemaValidator>>,
80
+ }
81
+
82
+ impl<L: LanguageHandler> HandlerExecutor<L> {
83
+ /// Create a new handler executor
84
+ pub fn new(language_handler: Arc<L>, request_validator: Option<Arc<SchemaValidator>>) -> Self {
85
+ Self {
86
+ language_handler,
87
+ request_validator,
88
+ }
89
+ }
90
+
91
+ /// Create a handler executor with only a language handler
92
+ pub fn with_handler(language_handler: Arc<L>) -> Self {
93
+ Self {
94
+ language_handler,
95
+ request_validator: None,
96
+ }
97
+ }
98
+
99
+ /// Add request validation to this executor
100
+ pub fn with_request_validator(mut self, validator: Arc<SchemaValidator>) -> Self {
101
+ self.request_validator = Some(validator);
102
+ self
103
+ }
104
+ }
105
+
106
+ impl<L: LanguageHandler + 'static> Handler for HandlerExecutor<L> {
107
+ fn call(
108
+ &self,
109
+ _request: Request<Body>,
110
+ request_data: RequestData,
111
+ ) -> Pin<Box<dyn Future<Output = HandlerResult> + Send + '_>> {
112
+ Box::pin(async move {
113
+ if let Some(validator) = &self.request_validator
114
+ && let Err(validation_err) = validator.validate(&request_data.body)
115
+ {
116
+ return Err(ErrorResponseBuilder::validation_error(&validation_err));
117
+ }
118
+
119
+ let input = self
120
+ .language_handler
121
+ .prepare_request(&request_data)
122
+ .map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to prepare request: {}", e)))?;
123
+
124
+ let output = self
125
+ .language_handler
126
+ .invoke_handler(input)
127
+ .await
128
+ .map_err(|e| ErrorResponseBuilder::internal_error(format!("Handler execution failed: {}", e)))?;
129
+
130
+ let response = self
131
+ .language_handler
132
+ .interpret_response(output)
133
+ .map_err(|e| ErrorResponseBuilder::internal_error(format!("Failed to interpret response: {}", e)))?;
134
+
135
+ Ok(response)
136
+ })
137
+ }
138
+ }
139
+
140
+ #[cfg(test)]
141
+ mod tests {
142
+ use super::*;
143
+ use serde_json::json;
144
+
145
+ struct MockLanguageHandler;
146
+
147
+ impl LanguageHandler for MockLanguageHandler {
148
+ type Input = String;
149
+ type Output = String;
150
+
151
+ fn prepare_request(&self, _data: &RequestData) -> Result<Self::Input, HandlerError> {
152
+ Ok("test_input".to_string())
153
+ }
154
+
155
+ fn invoke_handler(
156
+ &self,
157
+ _input: Self::Input,
158
+ ) -> Pin<Box<dyn Future<Output = Result<Self::Output, HandlerError>> + Send + '_>> {
159
+ Box::pin(async { Ok("test_output".to_string()) })
160
+ }
161
+
162
+ fn interpret_response(&self, output: Self::Output) -> Result<Response<Body>, HandlerError> {
163
+ Ok(Response::builder().status(200).body(Body::from(output)).unwrap())
164
+ }
165
+ }
166
+
167
+ #[tokio::test]
168
+ async fn test_handler_executor_basic() {
169
+ let mock_handler = Arc::new(MockLanguageHandler);
170
+ let executor = HandlerExecutor::new(mock_handler, None);
171
+
172
+ let request = Request::builder().body(Body::empty()).unwrap();
173
+ let request_data = RequestData {
174
+ path_params: Arc::new(std::collections::HashMap::new()),
175
+ query_params: json!({}),
176
+ validated_params: None,
177
+ raw_query_params: Arc::new(std::collections::HashMap::new()),
178
+ body: json!({}),
179
+ raw_body: None,
180
+ headers: Arc::new(std::collections::HashMap::new()),
181
+ cookies: Arc::new(std::collections::HashMap::new()),
182
+ method: "GET".to_string(),
183
+ path: "/test".to_string(),
184
+ dependencies: None,
185
+ };
186
+
187
+ let result = executor.call(request, request_data).await;
188
+ assert!(result.is_ok());
189
+ }
190
+
191
+ #[tokio::test]
192
+ async fn test_handler_executor_with_handler_only() {
193
+ let mock_handler = Arc::new(MockLanguageHandler);
194
+ let executor = HandlerExecutor::with_handler(mock_handler);
195
+
196
+ let request = Request::builder().body(Body::empty()).unwrap();
197
+ let request_data = RequestData {
198
+ path_params: Arc::new(std::collections::HashMap::new()),
199
+ query_params: json!({}),
200
+ validated_params: None,
201
+ raw_query_params: Arc::new(std::collections::HashMap::new()),
202
+ body: json!({}),
203
+ raw_body: None,
204
+ headers: Arc::new(std::collections::HashMap::new()),
205
+ cookies: Arc::new(std::collections::HashMap::new()),
206
+ method: "GET".to_string(),
207
+ path: "/test".to_string(),
208
+ dependencies: None,
209
+ };
210
+
211
+ let result = executor.call(request, request_data).await;
212
+ assert!(result.is_ok());
213
+ }
214
+
215
+ #[test]
216
+ fn test_handler_error_validation() {
217
+ let err = HandlerError::Validation("test error".to_string());
218
+ assert_eq!(err.to_string(), "Validation error: test error");
219
+ }
220
+
221
+ #[test]
222
+ fn test_handler_error_execution() {
223
+ let err = HandlerError::Execution("test error".to_string());
224
+ assert_eq!(err.to_string(), "Handler execution error: test error");
225
+ }
226
+
227
+ #[test]
228
+ fn test_handler_error_response_conversion() {
229
+ let err = HandlerError::ResponseConversion("test error".to_string());
230
+ assert_eq!(err.to_string(), "Response conversion error: test error");
231
+ }
232
+
233
+ #[test]
234
+ fn test_handler_error_internal() {
235
+ let err = HandlerError::Internal("test error".to_string());
236
+ assert_eq!(err.to_string(), "Internal error: test error");
237
+ }
238
+ }
@@ -1,24 +1,24 @@
1
- //! Shared utilities for language bindings
2
- //!
3
- //! This crate provides common functionality used across all language bindings
4
- //! (Python, Node.js, Ruby, PHP, WASM) to eliminate code duplication and ensure
5
- //! consistent behavior.
6
-
7
- pub mod config_extractor;
8
- pub mod conversion_traits;
9
- pub mod di_traits;
10
- pub mod error_response;
11
- pub mod handler_base;
12
- pub mod lifecycle_base;
13
- pub mod lifecycle_executor;
14
- pub mod response_builder;
15
- pub mod test_client_base;
16
- pub mod validation_helpers;
17
-
18
- pub use config_extractor::{ConfigExtractor, ConfigSource};
19
- pub use di_traits::{FactoryDependencyAdapter, ValueDependencyAdapter};
20
- pub use error_response::ErrorResponseBuilder;
21
- pub use handler_base::{HandlerError, HandlerExecutor, LanguageHandler};
22
- pub use lifecycle_executor::{
23
- HookResultData, LanguageLifecycleHook, LifecycleExecutor, RequestModifications, extract_body,
24
- };
1
+ //! Shared utilities for language bindings
2
+ //!
3
+ //! This crate provides common functionality used across all language bindings
4
+ //! (Python, Node.js, Ruby, PHP, WASM) to eliminate code duplication and ensure
5
+ //! consistent behavior.
6
+
7
+ pub mod config_extractor;
8
+ pub mod conversion_traits;
9
+ pub mod di_traits;
10
+ pub mod error_response;
11
+ pub mod handler_base;
12
+ pub mod lifecycle_base;
13
+ pub mod lifecycle_executor;
14
+ pub mod response_builder;
15
+ pub mod test_client_base;
16
+ pub mod validation_helpers;
17
+
18
+ pub use config_extractor::{ConfigExtractor, ConfigSource};
19
+ pub use di_traits::{FactoryDependencyAdapter, ValueDependencyAdapter};
20
+ pub use error_response::ErrorResponseBuilder;
21
+ pub use handler_base::{HandlerError, HandlerExecutor, LanguageHandler};
22
+ pub use lifecycle_executor::{
23
+ HookResultData, LanguageLifecycleHook, LifecycleExecutor, RequestModifications, extract_body,
24
+ };