spikard 0.3.5 → 0.5.0

data/vendor/crates/spikard-http/src/openapi/schema_conversion.rs

@@ -1,308 +1,1363 @@
-//! JSON Schema to OpenAPI schema conversion utilities
-
-use utoipa::openapi::{RefOr, Schema};
-
-/// Convert serde_json::Value (JSON Schema) to utoipa Schema
-/// OpenAPI 3.1.0 is fully compatible with JSON Schema Draft 2020-12
-pub fn json_value_to_schema(value: &serde_json::Value) -> Result<RefOr<Schema>, String> {
-    if let Some(type_str) = value.get("type").and_then(|t| t.as_str()) {
-        match type_str {
-            "object" => {
-                let mut object_schema = utoipa::openapi::ObjectBuilder::new();
-
-                if let Some(properties) = value.get("properties").and_then(|p| p.as_object()) {
-                    for (prop_name, prop_schema) in properties {
-                        let prop_openapi_schema = json_value_to_schema(prop_schema)?;
-                        object_schema = object_schema.property(prop_name, prop_openapi_schema);
-                    }
-                }
-
-                if let Some(required) = value.get("required").and_then(|r| r.as_array()) {
-                    for field in required {
-                        if let Some(field_name) = field.as_str() {
-                            object_schema = object_schema.required(field_name);
-                        }
-                    }
-                }
-
-                Ok(RefOr::T(Schema::Object(object_schema.build())))
-            }
-            "array" => {
-                let mut array_schema = utoipa::openapi::ArrayBuilder::new();
-
-                if let Some(items) = value.get("items") {
-                    let items_schema = json_value_to_schema(items)?;
-                    array_schema = array_schema.items(items_schema);
-                }
-
-                Ok(RefOr::T(Schema::Array(array_schema.build())))
-            }
-            "string" => {
-                let mut schema_type = utoipa::openapi::schema::Type::String;
-
-                if let Some(format) = value.get("format").and_then(|f| f.as_str()) {
-                    match format {
-                        "date-time" => schema_type = utoipa::openapi::schema::Type::String,
-                        "date" => schema_type = utoipa::openapi::schema::Type::String,
-                        "email" => schema_type = utoipa::openapi::schema::Type::String,
-                        "uri" => schema_type = utoipa::openapi::schema::Type::String,
-                        _ => {}
-                    }
-                }
-
-                Ok(RefOr::T(Schema::Object(
-                    utoipa::openapi::ObjectBuilder::new().schema_type(schema_type).build(),
-                )))
-            }
-            "integer" => Ok(RefOr::T(Schema::Object(
-                utoipa::openapi::ObjectBuilder::new()
-                    .schema_type(utoipa::openapi::schema::Type::Integer)
-                    .build(),
-            ))),
-            "number" => Ok(RefOr::T(Schema::Object(
-                utoipa::openapi::ObjectBuilder::new()
-                    .schema_type(utoipa::openapi::schema::Type::Number)
-                    .build(),
-            ))),
-            "boolean" => Ok(RefOr::T(Schema::Object(
-                utoipa::openapi::ObjectBuilder::new()
-                    .schema_type(utoipa::openapi::schema::Type::Boolean)
-                    .build(),
-            ))),
-            _ => Err(format!("Unsupported schema type: {}", type_str)),
-        }
-    } else {
-        Ok(RefOr::T(Schema::Object(utoipa::openapi::ObjectBuilder::new().build())))
-    }
-}
-
-/// Convert JSON Schema to OpenAPI RequestBody
-pub fn json_schema_to_request_body(
-    schema: &serde_json::Value,
-) -> Result<utoipa::openapi::request_body::RequestBody, String> {
-    use utoipa::openapi::content::ContentBuilder;
-
-    let openapi_schema = json_value_to_schema(schema)?;
-
-    let content = ContentBuilder::new().schema(Some(openapi_schema)).build();
-
-    let mut request_body = utoipa::openapi::request_body::RequestBody::new();
-    request_body.content.insert("application/json".to_string(), content);
-
-    request_body.required = Some(utoipa::openapi::Required::True);
-
-    Ok(request_body)
-}
-
-/// Convert JSON Schema to OpenAPI Response
-pub fn json_schema_to_response(schema: &serde_json::Value) -> Result<utoipa::openapi::Response, String> {
-    use utoipa::openapi::content::ContentBuilder;
-
-    let openapi_schema = json_value_to_schema(schema)?;
-
-    let content = ContentBuilder::new().schema(Some(openapi_schema)).build();
-
-    let mut response = utoipa::openapi::Response::new("Successful response");
-    response.content.insert("application/json".to_string(), content);
-
-    Ok(response)
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn test_json_value_to_schema_string() {
-        let schema_json = serde_json::json!({
-            "type": "string"
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-    }
-
-    #[test]
-    fn test_json_value_to_schema_integer() {
-        let schema_json = serde_json::json!({
-            "type": "integer"
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-    }
-
-    #[test]
-    fn test_json_value_to_schema_number() {
-        let schema_json = serde_json::json!({
-            "type": "number"
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-    }
-
-    #[test]
-    fn test_json_value_to_schema_boolean() {
-        let schema_json = serde_json::json!({
-            "type": "boolean"
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-    }
-
-    #[test]
-    fn test_json_value_to_schema_object() {
-        let schema_json = serde_json::json!({
-            "type": "object",
-            "properties": {
-                "name": { "type": "string" },
-                "age": { "type": "integer" }
-            },
-            "required": ["name"]
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-
-        if let Ok(RefOr::T(Schema::Object(obj))) = result {
-            assert!(obj.properties.contains_key("name"));
-            assert!(obj.properties.contains_key("age"));
-            assert!(obj.required.contains(&"name".to_string()));
-        } else {
-            panic!("Expected Object schema");
-        }
-    }
-
-    #[test]
-    fn test_json_value_to_schema_array() {
-        let schema_json = serde_json::json!({
-            "type": "array",
-            "items": {
-                "type": "string"
-            }
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-
-        if let Ok(RefOr::T(Schema::Array(_))) = result {
-        } else {
-            panic!("Expected Array schema");
-        }
-    }
-
-    #[test]
-    fn test_json_value_to_schema_nested_object() {
-        let schema_json = serde_json::json!({
-            "type": "object",
-            "properties": {
-                "user": {
-                    "type": "object",
-                    "properties": {
-                        "name": { "type": "string" },
-                        "email": { "type": "string" }
-                    }
-                }
-            }
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-    }
-
-    #[test]
-    fn test_json_schema_to_request_body() {
-        let schema_json = serde_json::json!({
-            "type": "object",
-            "properties": {
-                "title": { "type": "string" },
-                "count": { "type": "integer" }
-            },
-            "required": ["title"]
-        });
-
-        let result = json_schema_to_request_body(&schema_json);
-        assert!(result.is_ok());
-
-        let request_body = result.unwrap();
-        assert!(request_body.content.contains_key("application/json"));
-        assert!(matches!(request_body.required, Some(utoipa::openapi::Required::True)));
-    }
-
-    #[test]
-    fn test_json_schema_to_request_body_array() {
-        let schema_json = serde_json::json!({
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "id": { "type": "integer" }
-                }
-            }
-        });
-
-        let result = json_schema_to_request_body(&schema_json);
-        assert!(result.is_ok());
-
-        let request_body = result.unwrap();
-        assert!(request_body.content.contains_key("application/json"));
-    }
-
-    #[test]
-    fn test_json_schema_to_response() {
-        let schema_json = serde_json::json!({
-            "type": "object",
-            "properties": {
-                "id": { "type": "integer" },
-                "name": { "type": "string" }
-            }
-        });
-
-        let result = json_schema_to_response(&schema_json);
-        assert!(result.is_ok());
-
-        let response = result.unwrap();
-        assert!(response.content.contains_key("application/json"));
-        assert_eq!(response.description, "Successful response");
-    }
-
-    #[test]
-    fn test_json_schema_to_response_array() {
-        let schema_json = serde_json::json!({
-            "type": "array",
-            "items": {
-                "type": "string"
-            }
-        });
-
-        let result = json_schema_to_response(&schema_json);
-        assert!(result.is_ok());
-
-        let response = result.unwrap();
-        assert!(response.content.contains_key("application/json"));
-    }
-
-    #[test]
-    fn test_json_value_to_schema_string_with_format() {
-        let schema_json = serde_json::json!({
-            "type": "string",
-            "format": "date-time"
-        });
-
-        let result = json_value_to_schema(&schema_json);
-        assert!(result.is_ok());
-    }
-
-    #[test]
-    fn test_json_schema_to_request_body_empty_object() {
-        let schema_json = serde_json::json!({
-            "type": "object",
-            "properties": {}
-        });
-
-        let result = json_schema_to_request_body(&schema_json);
-        assert!(result.is_ok());
-    }
-}
+//! JSON Schema to OpenAPI schema conversion utilities
+
+use utoipa::openapi::{RefOr, Schema};
+
+/// Convert serde_json::Value (JSON Schema) to utoipa Schema
+/// OpenAPI 3.1.0 is fully compatible with JSON Schema Draft 2020-12
+pub fn json_value_to_schema(value: &serde_json::Value) -> Result<RefOr<Schema>, String> {
+    if let Some(type_str) = value.get("type").and_then(|t| t.as_str()) {
+        match type_str {
+            "object" => {
+                let mut object_schema = utoipa::openapi::ObjectBuilder::new();
+
+                if let Some(properties) = value.get("properties").and_then(|p| p.as_object()) {
+                    for (prop_name, prop_schema) in properties {
+                        let prop_openapi_schema = json_value_to_schema(prop_schema)?;
+                        object_schema = object_schema.property(prop_name, prop_openapi_schema);
+                    }
+                }
+
+                if let Some(required) = value.get("required").and_then(|r| r.as_array()) {
+                    for field in required {
+                        if let Some(field_name) = field.as_str() {
+                            object_schema = object_schema.required(field_name);
+                        }
+                    }
+                }
+
+                Ok(RefOr::T(Schema::Object(object_schema.build())))
+            }
+            "array" => {
+                let mut array_schema = utoipa::openapi::ArrayBuilder::new();
+
+                if let Some(items) = value.get("items") {
+                    let items_schema = json_value_to_schema(items)?;
+                    array_schema = array_schema.items(items_schema);
+                }
+
+                Ok(RefOr::T(Schema::Array(array_schema.build())))
+            }
+            "string" => {
+                let mut schema_type = utoipa::openapi::schema::Type::String;
+
+                if let Some(format) = value.get("format").and_then(|f| f.as_str()) {
+                    match format {
+                        "date-time" => schema_type = utoipa::openapi::schema::Type::String,
+                        "date" => schema_type = utoipa::openapi::schema::Type::String,
+                        "email" => schema_type = utoipa::openapi::schema::Type::String,
+                        "uri" => schema_type = utoipa::openapi::schema::Type::String,
+                        _ => {}
+                    }
+                }
+
+                Ok(RefOr::T(Schema::Object(
+                    utoipa::openapi::ObjectBuilder::new().schema_type(schema_type).build(),
+                )))
+            }
+            "integer" => Ok(RefOr::T(Schema::Object(
+                utoipa::openapi::ObjectBuilder::new()
+                    .schema_type(utoipa::openapi::schema::Type::Integer)
+                    .build(),
+            ))),
+            "number" => Ok(RefOr::T(Schema::Object(
+                utoipa::openapi::ObjectBuilder::new()
+                    .schema_type(utoipa::openapi::schema::Type::Number)
+                    .build(),
+            ))),
+            "boolean" => Ok(RefOr::T(Schema::Object(
+                utoipa::openapi::ObjectBuilder::new()
+                    .schema_type(utoipa::openapi::schema::Type::Boolean)
+                    .build(),
+            ))),
+            _ => Err(format!("Unsupported schema type: {}", type_str)),
+        }
+    } else {
+        Ok(RefOr::T(Schema::Object(utoipa::openapi::ObjectBuilder::new().build())))
+    }
+}
+
+/// Convert JSON Schema to OpenAPI RequestBody
+pub fn json_schema_to_request_body(
+    schema: &serde_json::Value,
+) -> Result<utoipa::openapi::request_body::RequestBody, String> {
+    use utoipa::openapi::content::ContentBuilder;
+
+    let openapi_schema = json_value_to_schema(schema)?;
+
+    let content = ContentBuilder::new().schema(Some(openapi_schema)).build();
+
+    let mut request_body = utoipa::openapi::request_body::RequestBody::new();
+    request_body.content.insert("application/json".to_string(), content);
+
+    request_body.required = Some(utoipa::openapi::Required::True);
+
+    Ok(request_body)
+}
+
+/// Convert JSON Schema to OpenAPI Response
+pub fn json_schema_to_response(schema: &serde_json::Value) -> Result<utoipa::openapi::Response, String> {
+    use utoipa::openapi::content::ContentBuilder;
+
+    let openapi_schema = json_value_to_schema(schema)?;
+
+    let content = ContentBuilder::new().schema(Some(openapi_schema)).build();
+
+    let mut response = utoipa::openapi::Response::new("Successful response");
+    response.content.insert("application/json".to_string(), content);
+
+    Ok(response)
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_json_value_to_schema_string() {
+        let schema_json = serde_json::json!({
+            "type": "string"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_json_value_to_schema_integer() {
+        let schema_json = serde_json::json!({
+            "type": "integer"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_json_value_to_schema_number() {
+        let schema_json = serde_json::json!({
+            "type": "number"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_json_value_to_schema_boolean() {
+        let schema_json = serde_json::json!({
+            "type": "boolean"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_json_value_to_schema_object() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "name": { "type": "string" },
+                "age": { "type": "integer" }
+            },
+            "required": ["name"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.properties.contains_key("name"));
+            assert!(obj.properties.contains_key("age"));
+            assert!(obj.required.contains(&"name".to_string()));
+        } else {
+            panic!("Expected Object schema");
+        }
+    }
+
+    #[test]
+    fn test_json_value_to_schema_array() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "string"
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Array(_))) = result {
+        } else {
+            panic!("Expected Array schema");
+        }
+    }
+
+    #[test]
+    fn test_json_value_to_schema_nested_object() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "user": {
+                    "type": "object",
+                    "properties": {
+                        "name": { "type": "string" },
+                        "email": { "type": "string" }
+                    }
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_json_schema_to_request_body() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "title": { "type": "string" },
+                "count": { "type": "integer" }
+            },
+            "required": ["title"]
+        });
+
+        let result = json_schema_to_request_body(&schema_json);
+        assert!(result.is_ok());
+
+        let request_body = result.unwrap();
+        assert!(request_body.content.contains_key("application/json"));
+        assert!(matches!(request_body.required, Some(utoipa::openapi::Required::True)));
+    }
+
+    #[test]
+    fn test_json_schema_to_request_body_array() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "id": { "type": "integer" }
+                }
+            }
+        });
+
+        let result = json_schema_to_request_body(&schema_json);
+        assert!(result.is_ok());
+
+        let request_body = result.unwrap();
+        assert!(request_body.content.contains_key("application/json"));
+    }
+
+    #[test]
+    fn test_json_schema_to_response() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "name": { "type": "string" }
+            }
+        });
+
+        let result = json_schema_to_response(&schema_json);
+        assert!(result.is_ok());
+
+        let response = result.unwrap();
+        assert!(response.content.contains_key("application/json"));
+        assert_eq!(response.description, "Successful response");
+    }
+
+    #[test]
+    fn test_json_schema_to_response_array() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "string"
+            }
+        });
+
+        let result = json_schema_to_response(&schema_json);
+        assert!(result.is_ok());
+
+        let response = result.unwrap();
+        assert!(response.content.contains_key("application/json"));
+    }
+
+    #[test]
+    fn test_json_value_to_schema_string_with_format() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "date-time"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_json_schema_to_request_body_empty_object() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {}
+        });
+
+        let result = json_schema_to_request_body(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_circular_reference_simple_cycle() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "parent": { "$ref": "#/properties/id" }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_self_referential_schema_direct() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "value": { "type": "string" },
+                "self": { "$ref": "#" }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_deeply_nested_object_10_levels() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "l1": {
+                    "type": "object",
+                    "properties": {
+                        "l2": {
+                            "type": "object",
+                            "properties": {
+                                "l3": {
+                                    "type": "object",
+                                    "properties": {
+                                        "l4": {
+                                            "type": "object",
+                                            "properties": {
+                                                "l5": {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "l6": {
+                                                            "type": "object",
+                                                            "properties": {
+                                                                "l7": {
+                                                                    "type": "object",
+                                                                    "properties": {
+                                                                        "l8": {
+                                                                            "type": "object",
+                                                                            "properties": {
+                                                                                "l9": {
+                                                                                    "type": "object",
+                                                                                    "properties": {
+                                                                                        "l10": { "type": "string" }
+                                                                                    }
+                                                                                }
+                                                                            }
+                                                                        }
+                                                                    }
+                                                                }
+                                                            }
+                                                        }
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok(), "Deep nesting should not cause stack overflow");
+    }
+
+    #[test]
+    fn test_deeply_nested_array_5_levels() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "array",
+                "items": {
+                    "type": "array",
+                    "items": {
+                        "type": "array",
+                        "items": {
+                            "type": "array",
+                            "items": { "type": "string" }
+                        }
+                    }
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_type_coercion_integer_to_number() {
+        let schema_json = serde_json::json!({
+            "type": "integer"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(matches!(
+                obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::Integer)
+            ));
+        } else {
+            panic!("Expected Object schema with Type::Integer");
+        }
+    }
+
+    #[test]
+    fn test_type_coercion_number_vs_integer() {
+        let int_schema = serde_json::json!({ "type": "integer" });
+        let num_schema = serde_json::json!({ "type": "number" });
+
+        let int_result = json_value_to_schema(&int_schema);
+        let num_result = json_value_to_schema(&num_schema);
+
+        assert!(int_result.is_ok());
+        assert!(num_result.is_ok());
+
+        if let (Ok(RefOr::T(Schema::Object(int_obj))), Ok(RefOr::T(Schema::Object(num_obj)))) = (int_result, num_result)
+        {
+            assert!(matches!(
+                int_obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::Integer)
+            ));
+            assert!(matches!(
+                num_obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::Number)
+            ));
+        }
+    }
+
+    #[test]
+    fn test_nullable_property_in_object() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "optional_field": { "type": "string" }
+            },
+            "required": ["id"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"id".to_string()));
+            assert!(!obj.required.contains(&"optional_field".to_string()));
+        } else {
+            panic!("Expected Object schema");
+        }
+    }
+
+    #[test]
+    fn test_required_array_with_multiple_fields() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "name": { "type": "string" },
+                "email": { "type": "string" },
+                "optional": { "type": "string" }
+            },
+            "required": ["id", "name", "email"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"id".to_string()));
+            assert!(obj.required.contains(&"name".to_string()));
+            assert!(obj.required.contains(&"email".to_string()));
+            assert!(!obj.required.contains(&"optional".to_string()));
+        }
+    }
+
+    #[test]
+    fn test_format_uuid() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "uuid"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_format_email() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "email"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_format_date_time() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "date-time"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(matches!(
+                obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::String)
+            ));
+        }
+    }
+
+    #[test]
+    fn test_format_date() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "date"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_format_uri() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "uri"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_format_unknown_custom_format() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "custom-format"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok(), "Unknown formats should be gracefully handled");
+    }
+
+    #[test]
+    fn test_array_of_objects() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "id": { "type": "integer" },
+                    "name": { "type": "string" }
+                },
+                "required": ["id"]
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Array(_))) = result {
+        } else {
+            panic!("Expected Array schema");
+        }
+    }
+
+    #[test]
+    fn test_array_of_arrays_of_objects() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "value": { "type": "string" }
+                    }
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_additional_properties_true() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" }
+            },
+            "additionalProperties": true
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_additional_properties_false() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" }
+            },
+            "additionalProperties": false
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok(), "additionalProperties:false should not cause errors");
+    }
+
+    #[test]
+    fn test_object_with_additional_properties_schema() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" }
+            },
+            "additionalProperties": { "type": "string" }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_empty_schema() {
+        let schema_json = serde_json::json!({});
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok(), "Empty schema should create basic object");
+    }
+
+    #[test]
+    fn test_schema_with_only_type_field() {
+        let schema_json = serde_json::json!({
+            "type": "object"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.properties.is_empty());
+        }
+    }
+
+    #[test]
+    fn test_array_without_items_schema() {
+        let schema_json = serde_json::json!({
+            "type": "array"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_mixed_property_types() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "name": { "type": "string" },
+                "active": { "type": "boolean" },
+                "score": { "type": "number" },
+                "tags": {
+                    "type": "array",
+                    "items": { "type": "string" }
+                },
+                "metadata": {
+                    "type": "object",
+                    "properties": {
+                        "created": { "type": "string", "format": "date-time" }
+                    }
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert_eq!(obj.properties.len(), 6);
+            assert!(obj.properties.contains_key("id"));
+            assert!(obj.properties.contains_key("name"));
+            assert!(obj.properties.contains_key("active"));
+            assert!(obj.properties.contains_key("score"));
+            assert!(obj.properties.contains_key("tags"));
+            assert!(obj.properties.contains_key("metadata"));
+        }
+    }
+
+    #[test]
+    fn test_nullable_complex_types() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "user": {
+                    "oneOf": [
+                        { "type": "object", "properties": { "id": { "type": "integer" } } },
+                        { "type": "null" }
+                    ]
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_unsupported_type_error() {
+        let schema_json = serde_json::json!({
+            "type": "unsupported_type"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_err());
+        if let Err(err) = result {
+            assert!(err.contains("Unsupported schema type"));
+        }
+    }
+
+    #[test]
+    fn test_required_with_non_string_elements() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "a": { "type": "string" },
+                "b": { "type": "integer" }
+            },
+            "required": [123, null, "a"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok(), "Non-string elements in required should be skipped");
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"a".to_string()));
+            assert_eq!(obj.required.len(), 1);
+        }
+    }
+
+    #[test]
+    fn test_properties_with_null_values() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "valid": { "type": "string" },
+                "null_value": null
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_empty_required_array() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "name": { "type": "string" }
+            },
+            "required": []
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.is_empty());
+        }
+    }
+
+    #[test]
+    fn test_request_body_with_missing_items() {
+        let schema_json = serde_json::json!({
+            "type": "array"
+        });
+
+        let result = json_schema_to_request_body(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_response_with_all_scalar_types() {
+        let types = vec!["string", "integer", "number", "boolean"];
+
+        for type_name in types {
+            let schema_json = serde_json::json!({
+                "type": type_name
+            });
+
+            let result = json_schema_to_response(&schema_json);
+            assert!(
+                result.is_ok(),
+                "Response schema with type '{}' should succeed",
+                type_name
+            );
+
+            let response = result.unwrap();
+            assert!(response.content.contains_key("application/json"));
+        }
+    }
+
+    #[test]
+    fn test_string_format_datetime_creates_string_type() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "date-time"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(matches!(
+                obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::String)
+            ));
+        }
+    }
+
+    #[test]
+    fn test_string_format_email_creates_string_type() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "email"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(matches!(
+                obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::String)
+            ));
+        }
+    }
+
+    #[test]
+    fn test_string_format_uri_creates_string_type() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "format": "uri"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(matches!(
+                obj.schema_type,
+                utoipa::openapi::schema::SchemaType::Type(utoipa::openapi::schema::Type::String)
+            ));
+        }
+    }
+
+    #[test]
+    fn test_array_nested_with_mixed_object_types() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "id": { "type": "integer" },
+                        "tags": {
+                            "type": "array",
+                            "items": { "type": "string" }
+                        }
+                    },
+                    "required": ["id"]
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_deeply_nested_arrays() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "level1": {
+                    "type": "array",
+                    "items": {
+                        "type": "array",
+                        "items": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    }
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_many_properties() {
+        let mut properties = serde_json::Map::new();
+        for i in 0..50 {
+            properties.insert(
+                format!("prop_{}", i),
+                serde_json::json!({ "type": if i % 2 == 0 { "string" } else { "integer" } }),
+            );
+        }
+
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": properties
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert_eq!(obj.properties.len(), 50);
+        }
+    }
+
+    #[test]
+    fn test_required_field_not_in_properties() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" }
+            },
+            "required": ["id", "missing_field"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"id".to_string()));
+            assert!(obj.required.contains(&"missing_field".to_string()));
+        }
+    }
+
+    #[test]
+    fn test_empty_object_with_required_fields() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {},
+            "required": ["field1", "field2"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"field1".to_string()));
+            assert!(obj.required.contains(&"field2".to_string()));
+        }
+    }
+
+    #[test]
+    fn test_array_items_missing_completely() {
+        let schema_json = serde_json::json!({
+            "type": "array"
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Array(_arr))) = result {
+        } else {
+            panic!("Expected Array schema");
+        }
+    }
+
+    #[test]
+    fn test_nested_object_mixed_required_across_levels() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "level1": {
+                    "type": "object",
+                    "properties": {
+                        "level2": {
+                            "type": "object",
+                            "properties": {
+                                "value": { "type": "string" }
+                            },
+                            "required": ["value"]
+                        }
+                    },
+                    "required": ["level2"]
+                }
+            },
+            "required": ["level1"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(outer))) = result {
+            assert!(outer.required.contains(&"level1".to_string()));
+        }
+    }
+
+    #[test]
+    fn test_string_format_all_known_formats() {
+        let formats = vec!["date-time", "date", "email", "uri"];
+
+        for format in formats {
+            let schema_json = serde_json::json!({
+                "type": "string",
+                "format": format
+            });
+
+            let result = json_value_to_schema(&schema_json);
+            assert!(result.is_ok(), "Format '{}' should be handled", format);
+        }
+    }
+
+    #[test]
+    fn test_request_body_complex_nested_structure() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "user": {
+                    "type": "object",
+                    "properties": {
+                        "id": { "type": "integer" },
+                        "profile": {
+                            "type": "object",
+                            "properties": {
+                                "name": { "type": "string" },
+                                "contacts": {
+                                    "type": "array",
+                                    "items": {
+                                        "type": "object",
+                                        "properties": {
+                                            "email": { "type": "string" },
+                                            "phone": { "type": "string" }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+            "required": ["user"]
+        });
+
+        let result = json_schema_to_request_body(&schema_json);
+        assert!(result.is_ok());
+
+        let request_body = result.unwrap();
+        assert!(request_body.content.contains_key("application/json"));
+        assert!(matches!(request_body.required, Some(utoipa::openapi::Required::True)));
+    }
+
+    #[test]
+    fn test_response_array_of_complex_objects() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "id": { "type": "integer" },
+                    "name": { "type": "string" },
+                    "created_at": { "type": "string", "format": "date-time" }
+                },
+                "required": ["id", "name"]
+            }
+        });
+
+        let result = json_schema_to_response(&schema_json);
+        assert!(result.is_ok());
+
+        let response = result.unwrap();
+        assert!(response.content.contains_key("application/json"));
+        assert_eq!(response.description, "Successful response");
+    }
+
+    #[test]
+    fn test_object_property_with_format_but_type_string() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "timestamp": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "email": {
+                    "type": "string",
+                    "format": "email"
+                }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.properties.contains_key("timestamp"));
+            assert!(obj.properties.contains_key("email"));
+        }
+    }
+
+    #[test]
+    fn test_duplicate_required_fields() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" },
+                "name": { "type": "string" }
+            },
+            "required": ["id", "name", "id", "name"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"id".to_string()));
+            assert!(obj.required.contains(&"name".to_string()));
+        }
+    }
+
+    #[test]
+    fn test_object_with_very_long_property_names() {
+        let long_name = "very_long_property_name_that_is_256_characters_or_more_\
+            aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\
+            aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\
+            aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\
+            aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                long_name: { "type": "string" }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.properties.contains_key(long_name));
+        }
+    }
+
+    #[test]
+    fn test_arrays_of_all_primitive_types() {
+        let types = vec!["string", "integer", "number", "boolean"];
+
+        for type_name in types {
+            let schema_json = serde_json::json!({
+                "type": "array",
+                "items": { "type": type_name }
+            });
+
+            let result = json_value_to_schema(&schema_json);
+            assert!(result.is_ok(), "Array of {} should be handled correctly", type_name);
+        }
+    }
+
+    #[test]
+    fn test_large_object_with_mixed_required_optional() {
+        let mut properties = serde_json::Map::new();
+        let mut required = Vec::new();
+
+        for i in 0..30 {
+            properties.insert(format!("field_{}", i), serde_json::json!({ "type": "string" }));
+            if i % 3 == 0 {
+                required.push(format!("field_{}", i));
+            }
+        }
+
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": properties,
+            "required": required
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.len() >= 9);
+            assert!(obj.properties.len() == 30);
+        }
+    }
+
+    #[test]
+    fn test_object_no_properties_with_required() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "required": ["name", "age"]
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.required.contains(&"name".to_string()));
+            assert!(obj.required.contains(&"age".to_string()));
+        }
+    }
+
+    #[test]
+    fn test_request_body_all_optional_fields() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "name": { "type": "string" },
+                "email": { "type": "string" },
+                "age": { "type": "integer" }
+            }
+        });
+
+        let result = json_schema_to_request_body(&schema_json);
+        assert!(result.is_ok());
+
+        let request_body = result.unwrap();
+        assert!(request_body.content.contains_key("application/json"));
+    }
+
+    #[test]
+    fn test_integer_with_min_max_values() {
+        let schema_json = serde_json::json!({
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 100
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_string_with_length_constraints() {
+        let schema_json = serde_json::json!({
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 255
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_array_with_item_count_constraints() {
+        let schema_json = serde_json::json!({
+            "type": "array",
+            "items": { "type": "string" },
+            "minItems": 1,
+            "maxItems": 10
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_object_with_pattern_properties() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "id": { "type": "integer" }
+            },
+            "patternProperties": {
+                "^S_": { "type": "string" }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_deeply_nested_object_15_levels() {
+        let mut schema = serde_json::json!({ "type": "string" });
+
+        for i in 0..15 {
+            schema = serde_json::json!({
+                "type": "object",
+                "properties": {
+                    format!("level_{}", i): schema
+                }
+            });
+        }
+
+        let result = json_value_to_schema(&schema);
+        assert!(result.is_ok(), "15-level deep nesting should not cause stack overflow");
+    }
+
+    #[test]
+    fn test_object_with_unicode_property_names() {
+        let schema_json = serde_json::json!({
+            "type": "object",
+            "properties": {
+                "名前": { "type": "string" },
+                "年齢": { "type": "integer" },
+                "🚀": { "type": "string" }
+            }
+        });
+
+        let result = json_value_to_schema(&schema_json);
+        assert!(result.is_ok());
+
+        if let Ok(RefOr::T(Schema::Object(obj))) = result {
+            assert!(obj.properties.contains_key("名前"));
+            assert!(obj.properties.contains_key("年齢"));
+            assert!(obj.properties.contains_key("🚀"));
+        }
+    }
+}