client.hpp

// SPDX-FileCopyrightText: 2026 Klaus Reimer <k@ailis.de>
// SPDX-License-Identifier: MIT
 
#pragma once
 
#include <kaycxx/http/buffered_response.hpp>
#include <kaycxx/http/request_body.hpp>
#include <kaycxx/http/request_options.hpp>
#include <kaycxx/http/response_body.hpp>
#include <kaycxx/http/streamed_response.hpp>
 
#include <memory>
#include <string_view>
 
namespace kaycxx::http {

class client {
public:
    client();

    explicit client(request_options default_options);

    ~client();
 
    client(const client&) = delete;
    client& operator=(const client&) = delete;

    client(client&& other) noexcept;

    client& operator=(client&& other) noexcept;

    [[nodiscard]] buffered_response request(std::string_view method, std::string_view url, const request_options& options = {});

    [[nodiscard]] buffered_response request(
        std::string_view method,
        std::string_view url,
        request_body body,
        const request_options& options = {}
    );

    [[nodiscard]] streamed_response request(
        std::string_view method,
        std::string_view url,
        response_body output,
        const request_options& options = {}
    );

    [[nodiscard]] streamed_response request(
        std::string_view method,
        std::string_view url,
        request_body body,
        response_body output,
        const request_options& options = {}
    );

    [[nodiscard]] buffered_response get(std::string_view url, const request_options& options = {});

    [[nodiscard]] buffered_response get(std::string_view url, request_body body, const request_options& options = {});

    [[nodiscard]] streamed_response get(std::string_view url, response_body output, const request_options& options = {});

    [[nodiscard]] streamed_response get(
        std::string_view url,
        request_body body,
        response_body output,
        const request_options& options = {}
    );

    [[nodiscard]] buffered_response post(std::string_view url, const request_options& options = {});

    [[nodiscard]] buffered_response post(std::string_view url, request_body body, const request_options& options = {});

    [[nodiscard]] streamed_response post(std::string_view url, response_body output, const request_options& options = {});

    [[nodiscard]] streamed_response post(
        std::string_view url,
        request_body body,
        response_body output,
        const request_options& options = {}
    );

    [[nodiscard]] buffered_response put(std::string_view url, const request_options& options = {});

    [[nodiscard]] buffered_response put(std::string_view url, request_body body, const request_options& options = {});

    [[nodiscard]] streamed_response put(std::string_view url, response_body output, const request_options& options = {});

    [[nodiscard]] streamed_response put(
        std::string_view url,
        request_body body,
        response_body output,
        const request_options& options = {}
    );

    [[nodiscard]] buffered_response del(std::string_view url, const request_options& options = {});

    [[nodiscard]] buffered_response del(std::string_view url, request_body body, const request_options& options = {});

    [[nodiscard]] streamed_response del(std::string_view url, response_body output, const request_options& options = {});

    [[nodiscard]] streamed_response del(
        std::string_view url,
        request_body body,
        response_body output,
        const request_options& options = {}
    );
 
private:
    class impl;

    [[nodiscard]] impl& require_impl();

    std::unique_ptr<impl> impl_;
};
 
} // namespace kaycxx::http