http_types.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2024, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include <string>
#include <map>
#include <vector>
#include <cstdint>
#include <optional>
 
#include "kcenon/network/detail/utils/result_types.h"
 
namespace kcenon::network::internal
{
    enum class http_method
    {
        HTTP_GET,
        HTTP_POST,
        HTTP_PUT,
        HTTP_DELETE,
        HTTP_HEAD,
        HTTP_OPTIONS,
        HTTP_PATCH,
        HTTP_CONNECT,
        HTTP_TRACE
    };
 
    enum class http_version
    {
        HTTP_1_0,
        HTTP_1_1,
        HTTP_2_0
    };
 
    struct cookie
    {
        std::string name;
        std::string value;
        std::string path;
        std::string domain;
        std::string expires;
        int max_age = -1;  // -1 = session cookie
        bool secure = false;
        bool http_only = false;
        std::string same_site;  // "Strict", "Lax", "None"
 
        auto to_header_value() const -> std::string;
    };
 
    struct multipart_file
    {
        std::string field_name;
        std::string filename;
        std::string content_type;
        std::vector<uint8_t> content;
    };
 
    struct http_request
    {
        http_method method = http_method::HTTP_GET;
        std::string uri;
        http_version version = http_version::HTTP_1_1;
        std::map<std::string, std::string> headers;
        std::vector<uint8_t> body;
        std::map<std::string, std::string> query_params;
        std::map<std::string, std::string> cookies;  // Parsed cookies from Cookie header
        std::map<std::string, std::string> form_data;  // Form fields from multipart/form-data
        std::map<std::string, multipart_file> files;  // Uploaded files from multipart/form-data
 
        auto get_header(const std::string& name) const -> std::optional<std::string>;
 
        auto set_header(const std::string& name, const std::string& value) -> void;
 
        auto get_body_string() const -> std::string;
 
        auto set_body_string(const std::string& content) -> void;
    };
 
    struct http_response
    {
        int status_code = 200;
        std::string status_message = "OK";
        http_version version = http_version::HTTP_1_1;
        std::map<std::string, std::string> headers;
        std::vector<uint8_t> body;
        std::vector<cookie> set_cookies;  // Cookies to set in Set-Cookie headers
        bool use_chunked_encoding = false;  // Use Transfer-Encoding: chunked
 
        auto get_header(const std::string& name) const -> std::optional<std::string>;
 
        auto set_header(const std::string& name, const std::string& value) -> void;
 
        auto get_body_string() const -> std::string;
 
        auto set_body_string(const std::string& content) -> void;
 
        auto set_cookie(const std::string& name, const std::string& value,
                       const std::string& path = "/", int max_age = -1,
                       bool http_only = true, bool secure = false,
                       const std::string& same_site = "") -> void;
    };
 
    auto http_method_to_string(http_method method) -> std::string;
 
    auto string_to_http_method(const std::string& method_str) -> ::kcenon::network::internal::Result<http_method>;
 
    auto http_version_to_string(http_version version) -> std::string;
 
    auto string_to_http_version(const std::string& version_str) -> ::kcenon::network::internal::Result<http_version>;
 
    auto get_status_message(int status_code) -> std::string;
 
} // namespace kcenon::network::internal