Crafter.Network/interfaces/Crafter.Network-ClientHTTP.cppm

/*
Crafter®.Network
Copyright (C) 2026 Catcrafts®
Catcrafts.net

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 3.0 of the License, or (at your option) any later version.

This library 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
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
*/

export module Crafter.Network:ClientHTTP;
import std;
import :HTTP;
import :ClientQUIC;

namespace Crafter {
    // HTTP/3 client over QUIC. The constructor establishes the QUIC connection
    // (TLS handshake + ALPN "h3"); each Send() opens a fresh request stream
    // on the multiplexed connection. Thread-affinity: Send() is not safe to
    // call from multiple threads concurrently against the same ClientHTTP,
    // but distinct ClientHTTP instances are independent.
    //
    // For local development against a self-signed listener, pass
    // QUICClientCredentials{insecureNoServerValidation = true}.
    //
    // Browser build: the request is dispatched via the browser's fetch()
    // and the synchronous Send() is not compiled — use SendAsync instead.
    // The ClientHTTP instance does not maintain a persistent connection
    // (fetch is request-scoped); host and port are stored and prefixed to
    // the request path on each call. QUICClientCredentials is ignored.
    export class ClientHTTP {
    public:
        std::string host;
        std::uint16_t port;

        ClientHTTP(const char* host, std::uint16_t port, QUICClientCredentials creds = {});
        ClientHTTP(std::string host, std::uint16_t port, QUICClientCredentials creds = {});

        ~ClientHTTP();
        ClientHTTP(const ClientHTTP&) = delete;
        ClientHTTP(ClientHTTP&&) noexcept;

#ifndef CRAFTER_NETWORK_BROWSER
        // Send a request and synchronously read back the full response.
        HTTPResponse Send(const HTTPRequest& request);
#endif

        // Send a request and deliver the response (or an error) via callback.
        // Available on both native and browser builds. Native dispatches on
        // Crafter.Thread's ThreadPool; browser uses fetch() and resolves on
        // the JS event loop.
        void SendAsync(const HTTPRequest& request,
                       std::function<void(HTTPResponse)> onSuccess,
                       std::function<void(std::string)> onError);

    private:
        struct Impl;
        std::unique_ptr<Impl> impl;
    };
}