// SPDX-License-Identifier: GPL-3.0-only #pragma once // The engine side of the Modern interface contract (docs/new_ui/integration, draft // "bmh-modern-ui@draft1"; engine decisions in docs/new_engine/ui-anbindung.md). // // A read answers in the contract's envelope: // {messageType: "snapshot", requestId, meta: {contractVersion, careerId, worldId, worldRevision, // stateRevision, projectionRevision, locale, date, season, scope, availability, currency}, data} // or {messageType: "error", requestId, code, message, currentRevision, retryable, stateChanged}. // // Reads never change the game, draw random numbers or move the revision. Money is the // contract's Money {minor: decimal string, currency: "EUR", minorUnits: 2}: the engine keeps // whole euros, converted here exactly once. Revisions are decimal strings. // // Read kinds so far: "session" (the human managers and who is at the desk) and "desktop" // (the desk of the active manager: manager, team, account, next match, menu availability). #include #include #include #include "cli/json.hpp" #include "modern/game/modern_state.hpp" namespace bmh::modern { // What the session adds to the state: the revision the interface acts on and the manager at // the desk (runtime manager slot). struct UiContext { uint64_t state_revision = 0; int manager = 0; // The desk's next match as the session prepared it (DeskState): the opponent's runtime // team (-1: none, nullopt: not known), the competition label, whether it is away. std::optional next_opponent; std::string next_competition; bool next_away = false; }; // Gives a career without them its identities: a career id ("career:" + 16 hex digits, drawn // from the system, not from a game generator) and an id per human manager slot // ("manager:", counted per career, never reused). Called after the career start, a join // and loading; changes nothing that is already set. void ensure_ui_identities(ModernState& g); // The money of the engine (whole euros) as the contract's Money. cli::Json ui_money(int64_t euros); cli::Json ui_read(const ModernState& g, const UiContext& context, const cli::Json& request); // The parts of a command answer the session puts together (ModernSession::ui_command). cli::Json ui_command_result(const std::string& request_id, uint64_t previous, uint64_t next, const std::vector& changed_reads, const std::string& feedback); cli::Json ui_error(const std::string& request_id, const std::string& code, const std::string& message, uint64_t revision, bool retryable); // The contract id of a manager slot ("manager:"). std::string ui_manager_id(const ModernState& g, int manager); // Reads the session answers itself (they need the executable's tables): data in the envelope. cli::Json ui_snapshot(const ModernState& g, const UiContext& context, const std::string& request_id, cli::Json data); std::string ui_team_id(const ModernState& g, int team); std::string ui_player_id(const ModernState& g, int player); } // namespace bmh::modern