Parity improvements: tests, schema types, and code organization

Test expansion (~25% parity with Python fastmcp):
- Client: 24 tests (api_basic.cpp, api_advanced.cpp)
- Server: 20 tests (basic.cpp, patterns.cpp)
- Tools: 25 tests (validation.cpp, edge_cases.cpp)
- Resources: 25 tests (advanced.cpp)
- Prompts: 40 tests (basic.cpp)
- Schema: 108 tests (type_basic, type_constraints, type_composite, json_schema, build)

New features:
- Schema-to-type mapping (json_schema_type.hpp/cpp) with validation and coercion
- Client typed data helpers (get_data_as, get_typed_data_as)
- Regex pattern caching for schema validation
- MCP handler now exposes resources/prompts endpoints

Code organization:
- Reorganized tests into directory structure (client/, server/, tools/, etc.)
- Split large test files for maintainability
- Shared test helpers (test_helpers.hpp)
- SSE streaming tests enabled by default
- Removed emoji characters from tests/examples

Bug fixes:
- Transports now properly inherit ITransport interface
- HTTP transport failure handling
- Unicode handling in interop tests

34 test executables, all passing.

Author: 0xeb

CMakeLists.txt

@@ -31,6 +31,7 @@ add_library(fastmcpp_core
     src/client/client.cpp
     src/client/transports.cpp
     src/util/json_schema.cpp
+    src/util/json_schema_type.cpp
     src/settings.cpp
 )
 target_include_directories(fastmcpp_core PUBLIC
@@ -128,15 +129,15 @@ if(FASTMCPP_BUILD_TESTS)
   target_link_libraries(fastmcp_json_types PRIVATE fastmcpp_core)
   add_test(NAME fastmcp_json_types COMMAND fastmcp_json_types)
 
-  add_executable(fastmcpp_resources tests/resources.cpp)
+  add_executable(fastmcpp_resources tests/resources/basic.cpp)
   target_link_libraries(fastmcpp_resources PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_resources COMMAND fastmcpp_resources)
 
-  add_executable(fastmcpp_prompts tests/prompts.cpp)
+  add_executable(fastmcpp_prompts tests/prompts/basic.cpp)
   target_link_libraries(fastmcpp_prompts PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_prompts COMMAND fastmcpp_prompts)
 
-  add_executable(fastmcpp_tools tests/tools.cpp)
+  add_executable(fastmcpp_tools tests/tools/basic.cpp)
   target_link_libraries(fastmcpp_tools PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_tools COMMAND fastmcpp_tools)
 
@@ -146,91 +147,111 @@ if(FASTMCPP_BUILD_TESTS)
 
   add_test(NAME fastmcpp_cli_sum COMMAND fastmcpp client sum 2 3)
 
-  add_executable(fastmcpp_http_integration tests/http_integration.cpp)
+  add_executable(fastmcpp_http_integration tests/server/http_integration.cpp)
   target_link_libraries(fastmcpp_http_integration PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_http_integration COMMAND fastmcpp_http_integration)
-  
-  add_executable(fastmcpp_json_schema tests/json_schema.cpp)
+
+  add_executable(fastmcpp_json_schema tests/schema/json_schema.cpp)
   target_link_libraries(fastmcpp_json_schema PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_json_schema COMMAND fastmcpp_json_schema)
 
-  add_executable(fastmcpp_schema_build tests/schema_build.cpp)
+  add_executable(fastmcpp_type_basic tests/schema/type_basic.cpp)
+  target_link_libraries(fastmcpp_type_basic PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_type_basic COMMAND fastmcpp_type_basic)
+
+  add_executable(fastmcpp_type_constraints tests/schema/type_constraints.cpp)
+  target_link_libraries(fastmcpp_type_constraints PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_type_constraints COMMAND fastmcpp_type_constraints)
+
+  add_executable(fastmcpp_type_composite tests/schema/type_composite.cpp)
+  target_link_libraries(fastmcpp_type_composite PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_type_composite COMMAND fastmcpp_type_composite)
+
+  add_executable(fastmcpp_schema_build tests/schema/build.cpp)
   target_link_libraries(fastmcpp_schema_build PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_schema_build COMMAND fastmcpp_schema_build)
 
   add_executable(fastmcpp_content tests/content.cpp)
   target_link_libraries(fastmcpp_content PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_content COMMAND fastmcpp_content)
 
-  add_executable(fastmcpp_mcp_server tests/mcp_server.cpp)
+  add_executable(fastmcpp_mcp_server tests/mcp/server.cpp)
   target_link_libraries(fastmcpp_mcp_server PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_mcp_server COMMAND fastmcpp_mcp_server)
 
-  add_executable(fastmcpp_mcp_handler tests/mcp_handler.cpp)
+  add_executable(fastmcpp_mcp_handler tests/mcp/handler.cpp)
   target_link_libraries(fastmcpp_mcp_handler PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_mcp_handler COMMAND fastmcpp_mcp_handler)
 
-  add_executable(fastmcpp_mcp_server_handler tests/mcp_server_handler.cpp)
+  add_executable(fastmcpp_mcp_server_handler tests/mcp/server_handler.cpp)
   target_link_libraries(fastmcpp_mcp_server_handler PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_mcp_server_handler COMMAND fastmcpp_mcp_server_handler)
 
-  add_executable(fastmcpp_mcp_server_toolmanager tests/mcp_server_toolmanager.cpp)
+  add_executable(fastmcpp_mcp_server_toolmanager tests/mcp/server_toolmanager.cpp)
   target_link_libraries(fastmcpp_mcp_server_toolmanager PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_mcp_server_toolmanager COMMAND fastmcpp_mcp_server_toolmanager)
 
   add_executable(fastmcpp_settings tests/settings.cpp)
   target_link_libraries(fastmcpp_settings PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_settings COMMAND fastmcpp_settings)
 
-  add_executable(fastmcpp_stdio_server tests/stdio_server.cpp)
+  add_executable(fastmcpp_stdio_server tests/transports/stdio_server.cpp)
   target_link_libraries(fastmcpp_stdio_server PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_stdio_server COMMAND fastmcpp_stdio_server)
 
-  add_executable(fastmcpp_sse_server tests/server_sse.cpp)
+  add_executable(fastmcpp_sse_server tests/server/sse.cpp)
   target_link_libraries(fastmcpp_sse_server PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_sse_server COMMAND fastmcpp_sse_server)
-  # Gate SSE server test behind streaming option; disabled by default
-  if(NOT FASTMCPP_ENABLE_STREAMING_TESTS)
-    set_tests_properties(fastmcpp_sse_server PROPERTIES DISABLED TRUE)
-  endif()
 
   # MCP SSE format compliance test (regression test for GitHub Issue #1)
-  add_executable(fastmcpp_sse_mcp_format tests/server_sse_mcp_format.cpp)
+  add_executable(fastmcpp_sse_mcp_format tests/server/sse_mcp_format.cpp)
   target_link_libraries(fastmcpp_sse_mcp_format PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_sse_mcp_format COMMAND fastmcpp_sse_mcp_format)
-  # This test takes ~17 seconds; disabled by default
-  if(NOT FASTMCPP_ENABLE_STREAMING_TESTS)
-    set_tests_properties(fastmcpp_sse_mcp_format PROPERTIES DISABLED TRUE)
-  endif()
 
   # Advanced test suites (Task 3.4)
-  add_executable(fastmcpp_tools_advanced tests/more/tools_advanced.cpp)
-  target_link_libraries(fastmcpp_tools_advanced PRIVATE fastmcpp_core)
-  add_test(NAME fastmcpp_tools_advanced COMMAND fastmcpp_tools_advanced)
+  add_executable(fastmcpp_tools_validation tests/tools/validation.cpp)
+  target_link_libraries(fastmcpp_tools_validation PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_tools_validation COMMAND fastmcpp_tools_validation)
 
-  add_executable(fastmcpp_resources_advanced tests/more/resources_advanced.cpp)
+  add_executable(fastmcpp_tools_edge_cases tests/tools/edge_cases.cpp)
+  target_link_libraries(fastmcpp_tools_edge_cases PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_tools_edge_cases COMMAND fastmcpp_tools_edge_cases)
+
+  add_executable(fastmcpp_resources_advanced tests/resources/advanced.cpp)
   target_link_libraries(fastmcpp_resources_advanced PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_resources_advanced COMMAND fastmcpp_resources_advanced)
 
-  add_executable(fastmcpp_server_lifecycle tests/server_lifecycle.cpp)
-  target_link_libraries(fastmcpp_server_lifecycle PRIVATE fastmcpp_core)
-  add_test(NAME fastmcpp_server_lifecycle COMMAND fastmcpp_server_lifecycle)
+  add_executable(fastmcpp_server_basic tests/server/basic.cpp)
+  target_link_libraries(fastmcpp_server_basic PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_server_basic COMMAND fastmcpp_server_basic)
+
+  add_executable(fastmcpp_server_patterns tests/server/patterns.cpp)
+  target_link_libraries(fastmcpp_server_patterns PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_server_patterns COMMAND fastmcpp_server_patterns)
 
-  add_executable(fastmcpp_client_transports tests/client_transports.cpp)
+  add_executable(fastmcpp_client_transports tests/client/transports.cpp)
   target_link_libraries(fastmcpp_client_transports PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_client_transports COMMAND fastmcpp_client_transports)
 
-  add_executable(fastmcpp_client_api tests/client_api.cpp)
-  target_link_libraries(fastmcpp_client_api PRIVATE fastmcpp_core)
-  add_test(NAME fastmcpp_client_api COMMAND fastmcpp_client_api)
+  add_executable(fastmcpp_client_api_basic tests/client/api_basic.cpp)
+  target_link_libraries(fastmcpp_client_api_basic PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_client_api_basic COMMAND fastmcpp_client_api_basic)
+
+  add_executable(fastmcpp_client_api_advanced tests/client/api_advanced.cpp)
+  target_link_libraries(fastmcpp_client_api_advanced PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_client_api_advanced COMMAND fastmcpp_client_api_advanced)
 
-  add_executable(fastmcpp_server_middleware tests/server_middleware.cpp)
+  add_executable(fastmcpp_server_middleware tests/server/middleware.cpp)
   target_link_libraries(fastmcpp_server_middleware PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_server_middleware COMMAND fastmcpp_server_middleware)
 
-  add_executable(fastmcpp_stdio_client tests/stdio_client.cpp)
+  add_executable(fastmcpp_stdio_client tests/transports/stdio_client.cpp)
   target_link_libraries(fastmcpp_stdio_client PRIVATE fastmcpp_core)
   add_test(NAME fastmcpp_stdio_client COMMAND fastmcpp_stdio_client)
+
+  add_executable(fastmcpp_stdio_failure tests/transports/stdio_failure.cpp)
+  target_link_libraries(fastmcpp_stdio_failure PRIVATE fastmcpp_core)
+  add_test(NAME fastmcpp_stdio_failure COMMAND fastmcpp_stdio_failure)
   set_tests_properties(fastmcpp_stdio_client PROPERTIES
     LABELS "conformance"
     WORKING_DIRECTORY "$<TARGET_FILE_DIR:fastmcpp_stdio_client>"
@@ -244,21 +265,21 @@ if(FASTMCPP_BUILD_TESTS)
 
   option(FASTMCPP_ENABLE_STREAMING_TESTS "Enable streaming SSE tests (experimental)" OFF)
   if(FASTMCPP_ENABLE_STREAMING_TESTS)
-    add_executable(fastmcpp_streaming_sse tests/streaming_sse.cpp)
+    add_executable(fastmcpp_streaming_sse tests/server/streaming_sse.cpp)
     target_link_libraries(fastmcpp_streaming_sse PRIVATE fastmcpp_core)
     add_test(NAME fastmcpp_streaming_sse COMMAND fastmcpp_streaming_sse)
     # Avoid port conflicts with other HTTP tests when running in parallel; currently unstable on some hosts
     set_tests_properties(fastmcpp_streaming_sse PROPERTIES RUN_SERIAL TRUE)
   endif()
 
   if(FASTMCPP_ENABLE_WS_STREAMING_TESTS)
-    add_executable(fastmcpp_ws_streaming tests/ws_streaming.cpp)
+    add_executable(fastmcpp_ws_streaming tests/transports/ws_streaming.cpp)
     target_link_libraries(fastmcpp_ws_streaming PRIVATE fastmcpp_core)
     add_test(NAME fastmcpp_ws_streaming COMMAND fastmcpp_ws_streaming)
     # Test auto-skips if FASTMCPP_WS_URL is not set
-  
+
     if(FASTMCPP_ENABLE_LOCAL_WS_TEST)
-      add_executable(fastmcpp_ws_streaming_local tests/ws_streaming_local.cpp)
+      add_executable(fastmcpp_ws_streaming_local tests/transports/ws_streaming_local.cpp)
       target_link_libraries(fastmcpp_ws_streaming_local PRIVATE fastmcpp_core)
       add_test(NAME fastmcpp_ws_streaming_local COMMAND fastmcpp_ws_streaming_local)
       set_tests_properties(fastmcpp_ws_streaming_local PROPERTIES RUN_SERIAL TRUE)

examples/server_metadata.cpp

@@ -1,4 +1,4 @@
-// Example demonstrating Server Metadata Fields (v2.13.0+)
+// Example demonstrating Server Metadata Fields (v2.13.0+)
 //
 // This example shows how to configure server metadata that appears in the
 // MCP initialize response. Metadata helps clients display server information
@@ -37,7 +37,7 @@ int main() {
         }
     };
 
-    std::cout << "   ✅ Created 2 icons:\n";
+    std::cout << "   [OK] Created 2 icons:\n";
     std::cout << "      - PNG icon (48x48) from URL\n";
     std::cout << "      - SVG icon (any size) from data URI\n\n";
 
@@ -57,7 +57,7 @@ int main() {
         true                                           // strict_input_validation (optional)
     );
 
-    std::cout << "   ✅ Server created with:\n";
+    std::cout << "   [OK] Server created with:\n";
     std::cout << "      - name: " << server->name() << "\n";
     std::cout << "      - version: " << server->version() << "\n";
     std::cout << "      - website_url: " << *server->website_url() << "\n";
@@ -87,7 +87,7 @@ int main() {
     };
     tool_mgr.register_tool(echo);
 
-    std::cout << "   ✅ Registered 'echo' tool\n\n";
+    std::cout << "   [OK] Registered 'echo' tool\n\n";
 
     // ============================================================================
     // Step 4: Create MCP Handler
@@ -109,7 +109,7 @@ int main() {
         descriptions
     );
 
-    std::cout << "   ✅ MCP handler created\n\n";
+    std::cout << "   [OK] MCP handler created\n\n";
 
     // ============================================================================
     // Step 5: Test Initialize Request
@@ -147,7 +147,7 @@ int main() {
 
         auto& server_info = init_response["result"]["serverInfo"];
 
-        std::cout << "✅ serverInfo fields:\n";
+        std::cout << "[OK] serverInfo fields:\n";
         std::cout << "   - name: " << server_info["name"] << "\n";
         std::cout << "   - version: " << server_info["version"] << "\n";
 
@@ -221,11 +221,11 @@ int main() {
 
     std::cout << "=== Summary ===\n\n";
     std::cout << "Server metadata fields (v2.13.0+):\n";
-    std::cout << "  ✅ name: Required, identifies the server\n";
-    std::cout << "  ✅ version: Required, server version string\n";
-    std::cout << "  ✅ website_url: Optional, URL for documentation/homepage\n";
-    std::cout << "  ✅ icons: Optional, list of Icon objects for UI display\n";
-    std::cout << "  ✅ strict_input_validation: Optional, controls validation behavior\n\n";
+    std::cout << "  [OK] name: Required, identifies the server\n";
+    std::cout << "  [OK] version: Required, server version string\n";
+    std::cout << "  [OK] website_url: Optional, URL for documentation/homepage\n";
+    std::cout << "  [OK] icons: Optional, list of Icon objects for UI display\n";
+    std::cout << "  [OK] strict_input_validation: Optional, controls validation behavior\n\n";
 
     std::cout << "Icon structure:\n";
     std::cout << "  - src: URL or data URI (required)\n";

examples/sse_inspector_test.cpp

@@ -1,4 +1,4 @@
-// Simple SSE server for MCP Inspector testing
+// Simple SSE server for MCP Inspector testing
 // Runs indefinitely until Ctrl+C
 
 #include "fastmcpp/server/sse_server.hpp"
@@ -64,13 +64,13 @@ int main() {
         return 1;
     }
 
-    std::cout << "✅ Server started successfully\n";
+    std::cout << "[OK] Server started successfully\n";
     std::cout << "   Host: " << sse_server.host() << "\n";
     std::cout << "   Port: " << sse_server.port() << "\n";
     std::cout << "   SSE endpoint: " << sse_server.sse_path() << " (GET)\n";
     std::cout << "   Message endpoint: " << sse_server.message_path() << " (POST)\n\n";
 
-    std::cout << "🔗 Connect MCP Inspector with:\n";
+    std::cout << "Connect MCP Inspector with:\n";
     std::cout << "   npx @modelcontextprotocol/inspector http://127.0.0.1:18106/sse\n\n";
 
     std::cout << "Press Ctrl+C to stop the server...\n\n";
@@ -82,7 +82,7 @@ int main() {
 
     std::cout << "Stopping server...\n";
     sse_server.stop();
-    std::cout << "✅ Server stopped\n";
+    std::cout << "[OK] Server stopped\n";
 
     return 0;
 }