Add support for reflect-cpp's JSON

.github/actions/install/reflectcpp-json/action.yml

@@ -0,0 +1,12 @@
+name: Install reflect-cpp
+description: Install reflect-cpp for building test application
+inputs:
+  version:
+    description: The desired reflect-cpp version to install
+    required: false
+    default: "0.24.0"
+runs:
+  using: composite
+  steps:
+    - run: ${{ github.action_path }}/install-reflect-cpp.sh ${{ inputs.version }}
+      shell: bash

.github/actions/install/reflectcpp-json/install-reflect-cpp.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# Install reflect-cpp library with specified version
+
+set -e  # Exit on error
+
+# Check if version is provided
+if [[ -z "$1" ]] || [[ "$1" == "-h" ]] || [[ "$1" == "--help" ]]; then
+    echo "Usage: $0 VERSION"
+    echo ""
+    echo "Install reflect-cpp library"
+    echo ""
+    echo "Arguments:"
+    echo "  VERSION reflect-cpp version to install (required)"
+    echo ""
+    echo "Examples:"
+    echo "  $0 0.24.0"
+    exit 1
+fi
+
+# Configuration
+reflectcpp_VERSION="$1"
+INSTALL_DIR="/tmp"
+BUILD_DIR="${INSTALL_DIR}/reflect-cpp-${reflectcpp_VERSION}"
+
+echo "Installing reflectcpp v${reflectcpp_VERSION}..."
+
+# Download
+echo "Downloading reflectcpp v${reflectcpp_VERSION}..."
+cd "${INSTALL_DIR}"
+wget -q "https://github.com/getml/reflect-cpp/archive/v${reflectcpp_VERSION}.tar.gz"
+
+# Extract
+echo "Extracting archive..."
+tar -zxf "v${reflectcpp_VERSION}.tar.gz"
+
+# Build and install
+echo "Building and installing..."
+cd "${BUILD_DIR}"
+cmake .  -DCMAKE_BUILD_TYPE=Release -DREFLECTCPP_INSTALL=ON
+cmake --build .
+sudo cmake --install .
+
+# Cleanup
+echo "Cleaning up..."
+rm -f "${INSTALL_DIR}/v${reflectcpp_VERSION}.tar.gz"
+rm -rf "${BUILD_DIR}"
+
+echo "✓ reflect-cpp v${reflectcpp_VERSION} installed successfully!"

.github/workflows/lint.yml

@@ -72,6 +72,7 @@ jobs:
           - { name: "nlohmann_json", library: "JSON for Modern C++", url: "https://github.com/nlohmann/json", disable_pico: true }
           - { name: "open_source_parsers_jsoncpp", library: "jsoncpp", url: "https://github.com/open-source-parsers/jsoncpp", disable_pico: true }
           - { name: "glaze_json", library: "Glaze", url: "https://github.com/stephenberry/glaze", disable_pico: true }
+          - { name: "reflectcpp_json", library: "ReflectCpp", url: "https://github.com/getml/reflect-cpp", disable_pico: true }
     name: render-defaults (${{ matrix.traits.name }})
     steps:
       - uses: actions/checkout@v4
@@ -102,6 +103,7 @@ jobs:
           - { name: "nlohmann_json", suite: "NlohmannTest" }
           - { name: "open_source_parsers_jsoncpp", suite: "OspJsoncppTest" }
           # - { name: "glaze_json", suite: "GlazeTest" } # No supported due to istream buffer being specialized
+          # - { name: "reflectcpp_json", suite: "ReflectCppJsonTest" } # No supported due to istream buffer being specialized
     name: render-tests (${{ matrix.traits.name }})
     steps:
       - uses: actions/checkout@v4

.github/workflows/traits.yml

@@ -22,6 +22,7 @@ jobs:
           - { name: "kazuho-picojson", tag: "111c9be5188f7350c2eac9ddaedd8cca3d7bf394", version: "111c9be" }
           - { name: "open-source-parsers-jsoncpp", tag: "1.9.6", version: "v1.9.6" }
           - { name: "glaze-json", tag: "7.0.2", version: "v7.0.2" }
+          - { name: "reflectcpp-json", tag: "0.24.0", version: "v0.24.0" }
     steps:
       - uses: actions/checkout@v4
       - uses: lukka/get-cmake@latest
@@ -65,6 +66,11 @@ jobs:
         with:
           version: ${{matrix.target.tag}}
 
+      - if: matrix.target.name == 'reflectcpp-json'
+        uses: ./.github/actions/install/reflectcpp-json
+        with:
+          version: ${{ matrix.target.tag }}
+
       - name: test
         working-directory: example/traits
         run: |

CMakeLists.txt

@@ -36,7 +36,7 @@ set(JWT_SSL_LIBRARY OpenSSL CACHE STRING "Determines which SSL library to build
 set_property(CACHE JWT_SSL_LIBRARY PROPERTY STRINGS ${JWT_SSL_LIBRARY_OPTIONS})
 
 set(JWT_JSON_TRAITS_OPTIONS boost-json danielaparker-jsoncons kazuho-picojson nlohmann-json open-source-parsers-jsoncpp
-                            glaze-json)
+                            glaze-json reflectcpp-json)
 
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")
 

docs/traits.md

@@ -11,14 +11,16 @@ For your convenience there are serval traits implementation which provide some p
 [![jsoncons][jsoncons]](https://github.com/danielaparker/jsoncons)
 [![boostjson][boostjson]](https://github.com/boostorg/json)
 [![jsoncpp][jsoncpp]](https://github.com/open-source-parsers/jsoncpp)
-[![glaze][glaze]]([https://github.com/open-source-parsers/jsoncpp](https://github.com/stephenberry/glaze))
+[![glaze][glaze]](https://github.com/stephenberry/glaze)
+[![reflectcpp][reflectcpp]](https://github.com/getml/reflect-cpp)
 
 [picojson]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/kazuho-picojson/shields.json
 [nlohmann]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/nlohmann-json/shields.json
 [jsoncons]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/danielaparker-jsoncons/shields.json
 [boostjson]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/boost-json/shields.json
 [jsoncpp]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/open-source-parsers-jsoncpp/shields.json
 [glaze]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/glaze-json/shields.json
+[reflectcpp]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/Thalhammer/jwt-cpp/badges/traits/reflectcpp-json/shields.json
 
 In order to maintain compatibility, [picojson](https://github.com/kazuho/picojson) is still used to provide a specialized `jwt::claim` along with all helpers. Defining `JWT_DISABLE_PICOJSON` will remove this optional dependency. It's possible to directly include the traits defaults for the other JSON libraries. See the [traits examples](https://github.com/Thalhammer/jwt-cpp/tree/master/example/traits) for details.
 

example/traits/CMakeLists.txt

@@ -38,5 +38,13 @@ endif()
 find_package(glaze CONFIG)
 if(TARGET glaze::glaze)
   add_executable(glaze-json glaze-json.cpp)
+  target_compile_features(glaze-json PRIVATE cxx_std_23)
   target_link_libraries(glaze-json glaze::glaze jwt-cpp::jwt-cpp)
 endif()
+
+find_package(reflectcpp CONFIG)
+if(TARGET reflectcpp::reflectcpp)
+  add_executable(reflectcpp-json reflectcpp-json.cpp)
+  target_compile_features(reflectcpp-json PRIVATE cxx_std_20)
+  target_link_libraries(reflectcpp-json jwt-cpp::jwt-cpp reflectcpp::reflectcpp)
+endif()

example/traits/reflectcpp-json.cpp

@@ -0,0 +1,83 @@
+#include "jwt-cpp/jwt.h"
+#include "jwt-cpp/traits/reflectcpp-json/traits.h"
+
+#include <chrono>
+#include <iostream>
+
+int main() {
+	using sec = std::chrono::seconds;
+	using min = std::chrono::minutes;
+	using traits = jwt::traits::reflectcpp_json;
+	using claim = jwt::basic_claim<traits>;
+
+	// Load a raw JSON object into a claim (reflect-cpp: parse -> wrap)
+	claim from_raw_json;
+	{
+		traits::value_type value;
+		// Mirrors the nlohmann example’s JSON
+		const auto* const json_text = R"##({"api":{"array":[1,2,3],"null":null}})##";
+		if (!traits::parse(value, json_text)) {
+			std::cerr << "failed to parse raw json\n";
+			return 1;
+		}
+		from_raw_json = claim{std::move(value)};
+	}
+
+	claim::set_t list{"once", "twice"};
+	std::vector<int64_t> big_numbers{727663072LL, 770979831LL, 427239169LL, 525936436LL};
+
+	// Build an array claim from the big_numbers vector
+	traits::array_type arr;
+	arr.reserve(big_numbers.size());
+	for (auto val : big_numbers) {
+		arr.emplace_back(val);
+	}
+	claim array_claim{traits::value_type{arr}};
+	claim strings_claim{list.begin(), list.end()};
+
+	const auto time = jwt::date::clock::now();
+	const auto token = jwt::create<traits>()
+						   .set_type("JWT")
+						   .set_issuer("auth.mydomain.io")
+						   .set_audience("mydomain.io")
+						   .set_issued_at(time)
+						   .set_not_before(time)
+						   .set_expires_at(time + min{2} + sec{15})
+						   .set_payload_claim("boolean", true)
+						   .set_payload_claim("integer", 12345)
+						   .set_payload_claim("precision", 12.3456789)
+						   .set_payload_claim("strings", strings_claim) // <— fixed
+						   .set_payload_claim("array", array_claim)
+						   .set_payload_claim("object", from_raw_json)
+						   .sign(jwt::algorithm::none{});
+
+	const auto decoded = jwt::decode<traits>(token);
+
+	// Access payload /object/api/array using reflect-cpp's Result-returning get()
+	{
+		const auto obj_v = decoded.get_payload_claim("object").to_json(); // R::value_type
+		const auto obj = traits::as_object(obj_v);						  // rfl::Object<rfl::Generic>
+
+		if (auto api_res = obj.get("api"); api_res) {				 // rfl::Result<rfl::Generic>
+			const auto api_obj = traits::as_object(api_res.value()); // nested object
+
+			if (auto arr_res = api_obj.get("array"); arr_res) {
+				const auto& nested = traits::as_array(arr_res.value()); // vector-like
+				std::cout << "payload /object/api/array = " << rfl::json::write(nested) << '\n';
+			} else {
+				std::cout << "payload /object/api/array missing\n";
+			}
+		} else {
+			std::cout << "payload /object/api missing\n";
+		}
+	}
+
+	jwt::verify<traits>()
+		.allow_algorithm(jwt::algorithm::none{})
+		.with_issuer("auth.mydomain.io")
+		.with_audience("mydomain.io")
+		.with_claim("object", from_raw_json)
+		.verify(decoded);
+
+	return 0;
+}

include/jwt-cpp/traits/reflectcpp-json/defaults.h

@@ -0,0 +1,91 @@
+#ifndef JWT_CPP_REFLECTCPP_JSON_DEFAULTS_H
+#define JWT_CPP_REFLECTCPP_JSON_DEFAULTS_H
+
+#ifndef JWT_DISABLE_PICOJSON
+#define JWT_DISABLE_PICOJSON
+#endif
+
+#include "traits.h"
+
+namespace jwt {
+	/**
+	 * \brief a class to store a generic [ReflectCpp](https://github.com/getml/reflect-cpp) value as claim
+	 *
+	 * This type is the specialization of the \ref basic_claim class which
+	 * uses the standard template types.
+	 */
+	using claim = basic_claim<traits::reflectcpp_json>;
+
+	/**
+	 * Create a verifier using the default clock
+	 * \return verifier instance
+	 */
+	inline verifier<default_clock, traits::reflectcpp_json> verify() {
+		return verify<default_clock, traits::reflectcpp_json>(default_clock{});
+	}
+
+	/**
+	 * Create a builder using the default clock
+	 * \return builder instance to create a new token
+	 */
+	inline builder<default_clock, traits::reflectcpp_json> create() {
+		return builder<default_clock, traits::reflectcpp_json>(default_clock{});
+	}
+
+#ifndef JWT_DISABLE_BASE64
+	/**
+	 * Decode a token
+	 * \param token Token to decode
+	 * \return Decoded token
+	 * \throw std::invalid_argument Token is not in correct format
+	 * \throw std::runtime_error Base64 decoding failed or invalid json
+	 */
+	inline decoded_jwt<traits::reflectcpp_json> decode(const std::string& token) {
+		return decoded_jwt<traits::reflectcpp_json>(token);
+	}
+#endif
+
+	/**
+	 * Decode a token
+	 * \tparam Decode is callable, taking a string_type and returns a string_type.
+	 * It should ensure the padding of the input and then base64url decode and
+	 * return the results.
+	 * \param token Token to decode
+	 * \param decode The token to parse
+	 * \return Decoded token
+	 * \throw std::invalid_argument Token is not in correct format
+	 * \throw std::runtime_error Base64 decoding failed or invalid json
+	 */
+	template<typename Decode>
+	decoded_jwt<traits::reflectcpp_json> decode(const std::string& token, Decode decode) {
+		return decoded_jwt<traits::reflectcpp_json>(token, decode);
+	}
+
+	/**
+	 * Parse a jwk
+	 * \param token JWK Token to parse
+	 * \return Parsed JWK
+	 * \throw std::runtime_error Token is not in correct format
+	 */
+	inline jwk<traits::reflectcpp_json> parse_jwk(const traits::reflectcpp_json::string_type& token) {
+		return jwk<traits::reflectcpp_json>(token);
+	}
+
+	/**
+	 * Parse a jwks
+	 * \param token JWKs Token to parse
+	 * \return Parsed JWKs
+	 * \throw std::runtime_error Token is not in correct format
+	 */
+	inline jwks<traits::reflectcpp_json> parse_jwks(const traits::reflectcpp_json::string_type& token) {
+		return jwks<traits::reflectcpp_json>(token);
+	}
+
+	/**
+	 * This type is the specialization of the \ref verify_ops::verify_context class which
+	 * uses the standard template types.
+	 */
+	using verify_context = verify_ops::verify_context<traits::reflectcpp_json>;
+} // namespace jwt
+
+#endif // JWT_CPP_REFLECTCPP_JSON_DEFAULTS_H