refactor(gameplay): keep host transition payloads in cartridge

fupogfakta/payloads.py

@@ -123,6 +123,17 @@ def build_scoreboard_phase_event(session: GameSession, leaderboard: list[dict] |
     }
 
 
+def build_reveal_scoreboard_response(session: GameSession, leaderboard: list[dict]) -> dict:
+    return {
+        "session": {
+            "code": session.code,
+            "status": session.status,
+            "current_round": session.current_round,
+        },
+        "leaderboard": leaderboard,
+    }
+
+
 def build_finish_game_phase_event(session: GameSession) -> dict:
     leaderboard = build_leaderboard(session)
     winner = leaderboard[0] if leaderboard else None

fupogfakta/services.py

@@ -6,7 +6,14 @@ from django.db import transaction
 from django.utils import timezone
 
 from .models import GameSession, Guess, LieAnswer, Player, Question, RoundConfig, RoundQuestion, ScoreEvent
-from .payloads import build_finish_game_phase_event, build_start_next_round_phase_event
+from .payloads import (
+    build_finish_game_phase_event,
+    build_finish_game_response,
+    build_reveal_scoreboard_response,
+    build_scoreboard_phase_event,
+    build_start_next_round_phase_event,
+    build_start_next_round_response,
+)
 
 
 @dataclass(frozen=True)
@@ -15,6 +22,7 @@ class RoundTransitionResult:
     round_config: RoundConfig
     round_question: RoundQuestion
     should_broadcast: bool
+    response_payload: dict[str, Any]
     phase_event_name: str | None = None
     phase_event_payload: dict[str, Any] | None = None
 
@@ -23,6 +31,7 @@ class RoundTransitionResult:
 class FinishGameResult:
     session: GameSession
     should_broadcast: bool
+    response_payload: dict[str, Any]
     phase_event_name: str | None = None
     phase_event_payload: dict[str, Any] | None = None
 
@@ -32,6 +41,9 @@ class ScoreboardTransitionResult:
     session: GameSession
     leaderboard: list[dict]
     should_broadcast: bool
+    response_payload: dict[str, Any] | None = None
+    phase_event_name: str | None = None
+    phase_event_payload: dict[str, Any] | None = None
 
 
 def get_current_round_question(session: GameSession) -> RoundQuestion | None:
@@ -172,6 +184,11 @@ def start_next_round(session: GameSession) -> RoundTransitionResult:
             round_config=next_round_config,
             round_question=round_question,
             should_broadcast=should_broadcast,
+            response_payload=build_start_next_round_response(
+                locked_session,
+                next_round_config,
+                round_question,
+            ),
             phase_event_name=phase_event_name,
             phase_event_payload=phase_event_payload,
         )
@@ -198,6 +215,7 @@ def finish_game(session: GameSession) -> FinishGameResult:
         return FinishGameResult(
             session=locked_session,
             should_broadcast=should_broadcast,
+            response_payload=build_finish_game_response(locked_session),
             phase_event_name=phase_event_name,
             phase_event_payload=phase_event_payload,
         )
@@ -211,7 +229,12 @@ def promote_reveal_to_scoreboard(session: GameSession) -> ScoreboardTransitionRe
             .order_by("-score", "nickname")
             .values("id", "nickname", "score")
         )
-        return ScoreboardTransitionResult(session=session, leaderboard=leaderboard, should_broadcast=False)
+        return ScoreboardTransitionResult(
+            session=session,
+            leaderboard=leaderboard,
+            should_broadcast=False,
+            response_payload=build_reveal_scoreboard_response(session, leaderboard),
+        )
 
     current_round_question = get_current_round_question(session)
     if current_round_question is None:
@@ -220,7 +243,12 @@ def promote_reveal_to_scoreboard(session: GameSession) -> ScoreboardTransitionRe
             .order_by("-score", "nickname")
             .values("id", "nickname", "score")
         )
-        return ScoreboardTransitionResult(session=session, leaderboard=leaderboard, should_broadcast=False)
+        return ScoreboardTransitionResult(
+            session=session,
+            leaderboard=leaderboard,
+            should_broadcast=False,
+            response_payload=build_reveal_scoreboard_response(session, leaderboard),
+        )
 
     players_count = Player.objects.filter(session=session).count()
     guess_count = Guess.objects.filter(round_question=current_round_question).count()
@@ -235,7 +263,12 @@ def promote_reveal_to_scoreboard(session: GameSession) -> ScoreboardTransitionRe
             .order_by("-score", "nickname")
             .values("id", "nickname", "score")
         )
-        return ScoreboardTransitionResult(session=session, leaderboard=leaderboard, should_broadcast=False)
+        return ScoreboardTransitionResult(
+            session=session,
+            leaderboard=leaderboard,
+            should_broadcast=False,
+            response_payload=build_reveal_scoreboard_response(session, leaderboard),
+        )
 
     with transaction.atomic():
         locked_session = GameSession.objects.select_for_update().get(pk=session.pk)
@@ -253,10 +286,19 @@ def promote_reveal_to_scoreboard(session: GameSession) -> ScoreboardTransitionRe
         .order_by("-score", "nickname")
         .values("id", "nickname", "score")
     )
+    phase_event_name = None
+    phase_event_payload = None
+    if should_broadcast:
+        phase_event = build_scoreboard_phase_event(scoreboard_session, leaderboard)
+        phase_event_name = phase_event["name"]
+        phase_event_payload = phase_event["payload"]
     return ScoreboardTransitionResult(
         session=scoreboard_session,
         leaderboard=leaderboard,
         should_broadcast=should_broadcast,
+        response_payload=build_reveal_scoreboard_response(scoreboard_session, leaderboard),
+        phase_event_name=phase_event_name,
+        phase_event_payload=phase_event_payload,
     )