HttpClient.h

Go to the documentation of this file.

// Copyright (c) 2025 Dave R. Smith.
// Malena Framework — Licensed under PolyForm Noncommercial 1.0.0; commercial use requires a paid license. See LICENSE.
 
#ifndef MALENA_HTTPCLIENT_H
#define MALENA_HTTPCLIENT_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <Malena/Engine/Networking/NetworkRequest.h>
#include <Malena/Engine/Networking/NetworkResponse.h>
#include <functional>
#include <string>
#include <unordered_map>
#include <nlohmann/json.hpp>
 
namespace ml
{
    class MALENA_API HttpClient
    {
    public:
        using ResponseCallback = std::function<void(NetworkResponse)>;

        explicit HttpClient(const std::string& baseUrl = "");
 
        // ── Configuration ────────────────────────────────────────────────────

        void setBaseUrl(const std::string& url);

        void setDefaultHeader(const std::string& key, const std::string& value);

        void setDefaultTimeout(int seconds);

        void setBearerToken(const std::string& token);
 
        // ── Async ────────────────────────────────────────────────────────────

        void get(const std::string& path, ResponseCallback cb);

        void post(const std::string& path,
                  const std::string& body,
                  ResponseCallback   cb,
                  const std::string& contentType = "application/json");

        void put(const std::string& path,
                 const std::string& body,
                 ResponseCallback   cb,
                 const std::string& contentType = "application/json");

        void patch(const std::string& path,
                   const std::string& body,
                   ResponseCallback   cb,
                   const std::string& contentType = "application/json");

        void del(const std::string& path, ResponseCallback cb);
 
        // ── JSON overloads ───────────────────────────────────────────────────

        void post(const std::string&       path,
                  const nlohmann::json&    json,
                  ResponseCallback         cb)
        {
            post(path, json.dump(), std::move(cb));
        }

        void put(const std::string&       path,
                 const nlohmann::json&    json,
                 ResponseCallback         cb)
        {
            put(path, json.dump(), std::move(cb));
        }

        void patch(const std::string&       path,
                   const nlohmann::json&    json,
                   ResponseCallback         cb)
        {
            patch(path, json.dump(), std::move(cb));
        }

        void send(const NetworkRequest& request, ResponseCallback cb);
 
        // ── Sync ─────────────────────────────────────────────────────────────

        NetworkResponse sendSync(const NetworkRequest& request);
 
    private:
        std::string _baseUrl;
        int         _defaultTimeout = 30;
        std::unordered_map<std::string, std::string> _defaultHeaders;

        static NetworkResponse execute(const NetworkRequest& request);

        [[nodiscard]] std::string resolveUrl(const std::string& path) const;
    };
 
} // namespace ml
 
#endif // MALENA_HTTPCLIENT_H