NetworkRequest.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_NETWORKREQUEST_H
#define MALENA_NETWORKREQUEST_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <string>
#include <unordered_map>
#include <nlohmann/json.hpp>
 
namespace ml
{
    class MALENA_API NetworkRequest
    {
    public:
        explicit NetworkRequest(const std::string& url);
 
        // ── Method ───────────────────────────────────────────────────────────

        NetworkRequest& method(const std::string& m);
 
        // ── Headers ──────────────────────────────────────────────────────────

        NetworkRequest& header(const std::string& key, const std::string& value);

        NetworkRequest& bearerToken(const std::string& token);

        NetworkRequest& basicAuth(const std::string& user, const std::string& pass);
 
        // ── Body ─────────────────────────────────────────────────────────────

        NetworkRequest& body(const std::string& data,
                             const std::string& contentType = "application/json");

        NetworkRequest& body(const nlohmann::json& json)
        {
            return body(json.dump(), "application/json");
        }
 
        // ── Options ──────────────────────────────────────────────────────────

        NetworkRequest& timeout(int seconds);
 
        // ── Accessors ────────────────────────────────────────────────────────
 
        [[nodiscard]] const std::string& getUrl()         const { return _url; }
        [[nodiscard]] const std::string& getMethod()      const { return _method; }
        [[nodiscard]] const std::string& getBody()        const { return _body; }
        [[nodiscard]] const std::string& getContentType() const { return _contentType; }
        [[nodiscard]] int                getTimeout()     const { return _timeoutSeconds; }
 
        [[nodiscard]] const std::unordered_map<std::string, std::string>&
        getHeaders() const { return _headers; }
 
    private:
        std::string _url;
        std::string _method        = "GET";
        std::string _body;
        std::string _contentType;
        int         _timeoutSeconds = 30;
 
        std::unordered_map<std::string, std::string> _headers;
    };
 
} // namespace ml
 
#endif // MALENA_NETWORKREQUEST_H