#pragma once #include #include #include #include #include #include #include // M9.8c launcher model (toolkit- and network-independent). Validates what the user // typed, loads the two credential files within bounds, and tracks the connect flow. // M10.5c (ADR-0093): grant records are M10 session grants (network::session_grant_bytes), // issued by `evo-session-probe grants`; the default endpoint is the dev route (ADR-0087). // Error texts are fixed: they never contain file contents, grant bytes or keys, and // nothing here is persisted or logged. namespace evo::client { inline constexpr std::size_t grant_record_bytes = 160; // network::session_grant_bytes. inline constexpr std::size_t max_grant_records = 64; // As issued by the probe. inline constexpr std::size_t max_authority_bytes = 65536; // One small PEM CA. inline constexpr std::size_t max_field_bytes = 1024; // Every text field. using GrantRecord = std::array; enum class LaunchError : std::uint8_t { endpoint, server_name, authority_path, grants_path, authority_unreadable, authority_invalid, grants_unreadable, grants_invalid, grant_refused, server_unreachable, grants_exhausted, no_session }; [[nodiscard]] std::string_view launch_error_text(LaunchError error) noexcept; // Defaults: the dev route (ADR-0087) and the name on its certificate. struct ConnectForm { std::string endpoint{"void.aeternalisgames.com:7400"}, server_name{"void.aeternalisgames.com"}; std::string authority_path, grants_path; }; struct Endpoint { std::string host; std::uint16_t port{}; }; struct ConnectMaterial { Endpoint endpoint; std::string server_name, authority_pem; std::string authority_path; // The same CA as a file (the QUIC stack loads it too). std::vector grants; }; // "host:port", "[ipv6]:port" or "a.b.c.d:port"; plain DNS host names only. [[nodiscard]] std::expected parse_endpoint(std::string_view text); [[nodiscard]] std::expected load_connect(const ConnectForm& form); // What the session reports while connecting, reduced to what the launcher decides on. enum class ConnectSignal : std::uint8_t { welcome, // A session was opened. lost, // Transport/TLS failure or deadline before a Close. refused, // Closed as unauthenticated/expired/duplicate: this grant cannot work. not_ready, // Closed as shutdown/capacity: the session retries later with the next grant. exhausted // No unused grant remains. }; enum class LaunchPhase : std::uint8_t { choosing, fixture, connecting, connected, failed }; class Launcher { public: static constexpr int max_attempts_without_welcome = 3; void start_fixture() noexcept; // From choosing or failed (retry). The caller then creates a fresh session. [[nodiscard]] bool begin_connect() noexcept; // Cancel returns to choosing from connecting, connected or failed; the caller // drops its session. Fixture mode also returns to choosing. void cancel() noexcept; // Lost connections after a welcome are reconnects, not failures; before any // welcome, repeated loss means the endpoint, name or CA is wrong. void observe(ConnectSignal signal) noexcept; void fail(LaunchError error) noexcept; [[nodiscard]] LaunchPhase phase() const noexcept { return phase_; } [[nodiscard]] LaunchError error() const noexcept { return error_; } [[nodiscard]] bool ever_connected() const noexcept { return welcomed_; } private: LaunchPhase phase_{LaunchPhase::choosing}; LaunchError error_{LaunchError::no_session}; int losses_{}; bool welcomed_{}; }; } // namespace evo::client