http_adapter.hpp

Go to the documentation of this file.

#pragma once
 
#include "aria/abi/export.hpp"
#include "aria/binding/view_adapter.hpp"
#include "http_config.hpp"
#include "http_view.hpp"
 
#include <cstdint>
#include <functional>
#include <memory>
#include <string>
#include <string_view>
#include <vector>
 
// Forward declaration so consumers don't pay for the cpp-httplib include
// unless they actually use the `native_server()` escape hatch below.
namespace httplib { class Server; }
 
namespace aria::adapters::http {

class ARIA_HTTP_API HttpAdapter final : public binding::IViewAdapter {
public:
    explicit HttpAdapter(HttpAdapterConfig config = {});
    ~HttpAdapter() override;
 
    HttpAdapter(const HttpAdapter&) = delete;
    HttpAdapter& operator=(const HttpAdapter&) = delete;
    HttpAdapter(HttpAdapter&&) = delete;
    HttpAdapter& operator=(HttpAdapter&&) = delete;
 
    // ── Lifecycle ──────────────────────────────────────────────────────

    bool start();

    void stop();

    [[nodiscard]] bool running() const noexcept;

    [[nodiscard]] std::uint16_t actual_port() const noexcept;

    [[nodiscard]] std::size_t client_count() const noexcept;
 
    // ── View registry ──────────────────────────────────────────────────

    HttpView& register_view(std::string id, std::string kind);

    [[nodiscard]] HttpView* find_view(std::string_view id);

    void unregister_view(std::string_view id);

    struct ViewInfo {
        std::string id;
        std::string kind;
    };
    [[nodiscard]] std::vector<ViewInfo> list_views() const;
 
    // ── IViewAdapter ───────────────────────────────────────────────────
 
    [[nodiscard]] std::string_view platform_name() const noexcept override {
        return "http";
    }
 
    void set_text(binding::IView& v, std::string_view text) override;
    [[nodiscard]] std::string get_text(binding::IView& v) override;
    ::aria::Subscription on_text_changed(
        binding::IView& v, std::function<void(std::string_view)> cb) override;
 
    void set_bool(binding::IView& v, bool value) override;
    [[nodiscard]] bool get_bool(binding::IView& v) override;
    ::aria::Subscription on_bool_changed(
        binding::IView& v, std::function<void(bool)> cb) override;
 
    void set_int(binding::IView& v, int value) override;
    [[nodiscard]] int get_int(binding::IView& v) override;
    ::aria::Subscription on_int_changed(
        binding::IView& v, std::function<void(int)> cb) override;
 
    void set_int64(binding::IView& v, std::int64_t value) override;
    [[nodiscard]] std::int64_t get_int64(binding::IView& v) override;
    ::aria::Subscription on_int64_changed(
        binding::IView& v, std::function<void(std::int64_t)> cb) override;
 
    void set_uint64(binding::IView& v, std::uint64_t value) override;
    [[nodiscard]] std::uint64_t get_uint64(binding::IView& v) override;
    ::aria::Subscription on_uint64_changed(
        binding::IView& v, std::function<void(std::uint64_t)> cb) override;
 
    void set_float(binding::IView& v, float value) override;
    [[nodiscard]] float get_float(binding::IView& v) override;
    ::aria::Subscription on_float_changed(
        binding::IView& v, std::function<void(float)> cb) override;
 
    void set_double(binding::IView& v, double value) override;
    [[nodiscard]] double get_double(binding::IView& v) override;
    ::aria::Subscription on_double_changed(
        binding::IView& v, std::function<void(double)> cb) override;
 
    void set_visible(binding::IView& v, bool visible) override;
    void set_enabled(binding::IView& v, bool enabled) override;
 
    ::aria::Subscription on_click(
        binding::IView& v, std::function<void()> cb) override;
 
    // ── Custom command channel ─────────────────────────────────────────

    using CommandHandler =
        std::function<std::string(std::string_view args_json)>;

    void register_command(std::string_view view_id,
                          std::string_view command_name,
                          CommandHandler handler);

    void unregister_command(std::string_view view_id,
                            std::string_view command_name);
 
    // ── Native server escape hatch ─────────────────────────────────────

    [[nodiscard]] ::httplib::Server& native_server() noexcept;
 
private:
    struct Impl;
    std::shared_ptr<Impl> p_;
};
 
}  // namespace aria::adapters::http