router.hpp

/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
 *
 * Copyright (C) 2025 Marco Craveiro <marco.craveiro@gmail.com>
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 3 of the License, or (at your option) any later
 * version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 51
 * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 */
#ifndef ORES_HTTP_NET_ROUTER_HPP
#define ORES_HTTP_NET_ROUTER_HPP
 
#include <vector>
#include <memory>
#include <optional>
#include <functional>
#include <rfl/json.hpp>
#include "ores.http.api/domain/route.hpp"
#include "ores.logging/make_logger.hpp"
 
namespace ores::http::net {
 
class route_builder final {
public:
    route_builder(domain::http_method method, const std::string& pattern);
 
    route_builder& handler(domain::request_handler h);
 
    route_builder& auth_required();
 
    route_builder& roles(std::vector<std::string> r);
 
    route_builder& summary(std::string s);
 
    route_builder& description(std::string d);
 
    route_builder& tags(std::vector<std::string> t);
 
    route_builder& query_param(const std::string& name,
        const std::string& type = "string",
        const std::string& format = "",
        bool required = false,
        const std::string& desc = "",
        const std::optional<std::string>& default_value = std::nullopt);
 
    template<typename T>
    route_builder& body(
        std::function<T()> example_generator = nullptr,
        bool required = true,
        const std::string& content_type = "application/json") {
 
        domain::request_body_schema schema;
        schema.content_type = content_type;
        schema.required = required;
        schema.json_schema = rfl::json::to_schema<T>();
 
        if (example_generator) {
            schema.example_json = rfl::json::write(example_generator());
        }
 
        body_schema_ = schema;
        return *this;
    }
 
    template<typename T>
    route_builder& response(
        std::function<T()> example_generator = nullptr,
        const std::string& desc = "Successful response",
        const std::string& content_type = "application/json") {
 
        domain::response_schema schema;
        schema.status_code = "200";
        schema.description = desc;
        schema.content_type = content_type;
        schema.json_schema = rfl::json::to_schema<T>();
 
        if (example_generator) {
            schema.example_json = rfl::json::write(example_generator());
        }
 
        success_response_schema_ = schema;
        return *this;
    }
 
    domain::route build() const;
 
private:
    domain::http_method method_;
    std::string pattern_;
    domain::request_handler handler_;
    bool requires_auth_ = false;
    std::vector<std::string> required_roles_;
    std::string summary_;
    std::string description_;
    std::vector<std::string> tags_;
    std::vector<domain::query_param> query_params_;
    std::optional<domain::request_body_schema> body_schema_;
    std::optional<domain::response_schema> success_response_schema_;
};
 
class router final {
public:
    router();
 
    route_builder get(const std::string& pattern);
 
    route_builder post(const std::string& pattern);
 
    route_builder put(const std::string& pattern);
 
    route_builder patch(const std::string& pattern);
 
    route_builder delete_(const std::string& pattern);
 
    void add_route(const domain::route& route);
 
    std::optional<domain::route> match(domain::http_method method,
        const std::string& path,
        std::unordered_map<std::string, std::string>& path_params) const;
 
    const std::vector<domain::route>& routes() const { return routes_; }
 
private:
    inline static std::string_view logger_name = "ores.http.net.router";
 
    static auto& lg() {
        using namespace ores::logging;
        static auto instance = make_logger(logger_name);
        return instance;
    }
 
    std::vector<domain::route> routes_;
};
 
}
 
#endif