#pragma once #include "evo/network/session_protocol.hpp" #include "evo/persistence/checkpoint_store.hpp" #include "evo/persistence/life_reservation_store.hpp" #include "evo/server/lifecycle/cellular_batch.hpp" #include "evo/server/ops.hpp" #include #include #include #include #include #include #include #include namespace evo::server { using CellularConnect = std::function, persistence::PgFailure>()>; struct CellularHostConfig { persistence::RegionKey key{}; std::uint64_t frame{}; persistence::LeasePolicy lease{}; persistence::Sha256Digest build{}; std::vector retained_builds; }; enum class CellularHostError : std::uint8_t { configuration, not_ready, invalid_batch, publication }; struct CellularPublishFailure { // Safe persistence diagnostics only: category and SQLSTATE, never server text. CellularHostError kind{}; std::optional publication; std::optional store; std::optional object; }; struct FinalCellularAction { CellularActionRecord action; std::uint64_t commit_sequence{}; friend bool operator==(const FinalCellularAction&, const FinalCellularAction&) = default; }; // Single-writer profile-4 authority. The caller supplies a complete bounded trace; // the host replays it from its recovered state and advances only on a confirmed head. class CellularRegionHost { public: [[nodiscard]] static std::expected, CellularHostError> create(CellularHostConfig config, CellularConnect connect, std::unique_ptr objects); CellularRegionHost(const CellularRegionHost&) = delete; CellularRegionHost& operator=(const CellularRegionHost&) = delete; ~CellularRegionHost(); // Acquires/renews authority, recovers fully, or resolves the exact pending commit. const HostStatus& step(); [[nodiscard]] std::expected publish(const CellularBatch& batch, std::span actions = {}); // v5 requests allocate durably, then wait for the scheduler to include the exact // reservation in a profile-4 batch. Repeating the request is idempotent. [[nodiscard]] network::PrimitiveLifeOutcome create_primitive_life(const persistence::Uuid& account, std::uint64_t generation, std::uint64_t request); [[nodiscard]] network::PrimitiveLifeOutcome query_primitive_life(const persistence::Uuid& account, std::uint64_t generation, std::uint64_t request); [[nodiscard]] std::span queued_births() const noexcept { return queued_births_; } [[nodiscard]] std::vector take_finalized_actions(); void drain(); [[nodiscard]] std::optional authority() const; [[nodiscard]] const HostStatus& status() const noexcept { return status_; } [[nodiscard]] const CellularLives* state() const noexcept { return state_.get(); } [[nodiscard]] const std::optional& committed() const noexcept { return committed_; } private: struct Pending; CellularRegionHost(CellularHostConfig config, CellularConnect connect, std::unique_ptr objects); bool database(); void acquire(); void upkeep(); void resolve(); void refresh(); void finalize_births(std::span births); void queue_birth(const CellularTickIntents::Birth& birth); [[nodiscard]] network::PrimitiveLifeOutcome query_birth(const persistence::Uuid& account, std::uint64_t generation, std::uint64_t request, bool enqueue); CellularHostConfig config_; CellularConnect connect_; std::unique_ptr objects_; std::unique_ptr db_; persistence::LeaseAuthority authority_; std::unique_ptr state_; std::optional committed_; std::unique_ptr pending_; std::vector finalized_actions_; std::vector queued_births_; HostStatus status_{}; }; } // namespace evo::server