refactor(gameplay): keep host transition payloads in cartridge

lobby/tests.py

@@ -59,16 +59,12 @@ class LobbyGameplayExtractionTests(TestCase):
         self.assertIs(lobby_views._start_next_round, gameplay_services.start_next_round)
         self.assertIs(lobby_views._finish_game, gameplay_services.finish_game)
         self.assertIs(lobby_views._build_scoreboard_phase_event, gameplay_payloads.build_scoreboard_phase_event)
-        self.assertIs(lobby_views._build_start_next_round_response, gameplay_payloads.build_start_next_round_response)
-        self.assertIs(lobby_views._build_finish_game_response, gameplay_payloads.build_finish_game_response)
 
     @patch("lobby.views.sync_broadcast_phase_event")
-    @patch("lobby.views._build_start_next_round_response", return_value={"ok": True})
     @patch("lobby.views._start_next_round")
     def test_start_next_round_view_delegates_transition_to_service(
         self,
         mock_start_next_round,
-        mock_build_response,
         mock_sync_broadcast_phase_event,
     ):
         next_round_config = RoundConfig.objects.create(
@@ -88,6 +84,7 @@ class LobbyGameplayExtractionTests(TestCase):
             round_config=next_round_config,
             round_question=round_question,
             should_broadcast=True,
+            response_payload={"ok": True},
             phase_event_name="phase.lie_started",
             phase_event_payload={"round_question_id": round_question.id},
         )
@@ -98,7 +95,6 @@ class LobbyGameplayExtractionTests(TestCase):
         self.assertEqual(response.status_code, 200)
         self.assertEqual(response.json(), {"ok": True})
         mock_start_next_round.assert_called_once_with(self.session)
-        mock_build_response.assert_called_once_with(self.session, next_round_config, round_question)
         mock_sync_broadcast_phase_event.assert_called_once_with(
             self.session.code,
             "phase.lie_started",
@@ -106,12 +102,10 @@ class LobbyGameplayExtractionTests(TestCase):
         )
 
     @patch("lobby.views.sync_broadcast_phase_event")
-    @patch("lobby.views._build_finish_game_response", return_value={"ok": True})
     @patch("lobby.views._finish_game")
     def test_finish_game_view_delegates_transition_to_service(
         self,
         mock_finish_game,
-        mock_build_response,
         mock_sync_broadcast_phase_event,
     ):
         finished_session = GameSession.objects.get(pk=self.session.pk)
@@ -119,6 +113,7 @@ class LobbyGameplayExtractionTests(TestCase):
         transition = gameplay_services.FinishGameResult(
             session=finished_session,
             should_broadcast=True,
+            response_payload={"ok": True},
             phase_event_name="phase.game_over",
             phase_event_payload={"winner": None, "leaderboard": []},
         )
@@ -129,7 +124,6 @@ class LobbyGameplayExtractionTests(TestCase):
         self.assertEqual(response.status_code, 200)
         self.assertEqual(response.json(), {"ok": True})
         mock_finish_game.assert_called_once_with(self.session)
-        mock_build_response.assert_called_once_with(finished_session)
         mock_sync_broadcast_phase_event.assert_called_once_with(
             self.session.code,
             "phase.game_over",
@@ -137,12 +131,10 @@ class LobbyGameplayExtractionTests(TestCase):
         )
 
     @patch("lobby.views.sync_broadcast_phase_event")
-    @patch("lobby.views._build_start_next_round_response", return_value={"ok": True})
     @patch("lobby.views._start_next_round")
     def test_start_next_round_view_skips_broadcast_on_service_replay(
         self,
         mock_start_next_round,
-        mock_build_response,
         mock_sync_broadcast_phase_event,
     ):
         replay_round_config = RoundConfig.objects.create(
@@ -165,6 +157,7 @@ class LobbyGameplayExtractionTests(TestCase):
             round_config=replay_round_config,
             round_question=round_question,
             should_broadcast=False,
+            response_payload={"ok": True},
         )
         mock_start_next_round.return_value = transition
 
@@ -173,21 +166,22 @@ class LobbyGameplayExtractionTests(TestCase):
         self.assertEqual(response.status_code, 200)
         self.assertEqual(response.json(), {"ok": True})
         mock_start_next_round.assert_called_once_with(self.session)
-        mock_build_response.assert_called_once_with(replay_session, replay_round_config, round_question)
         mock_sync_broadcast_phase_event.assert_not_called()
 
     @patch("lobby.views.sync_broadcast_phase_event")
-    @patch("lobby.views._build_finish_game_response", return_value={"ok": True})
     @patch("lobby.views._finish_game")
     def test_finish_game_view_skips_broadcast_on_service_replay(
         self,
         mock_finish_game,
-        mock_build_response,
         mock_sync_broadcast_phase_event,
     ):
         finished_session = GameSession.objects.get(pk=self.session.pk)
         finished_session.status = GameSession.Status.FINISHED
-        transition = gameplay_services.FinishGameResult(session=finished_session, should_broadcast=False)
+        transition = gameplay_services.FinishGameResult(
+            session=finished_session,
+            should_broadcast=False,
+            response_payload={"ok": True},
+        )
         mock_finish_game.return_value = transition
 
         response = self.client.post(reverse("lobby:finish_game", kwargs={"code": self.session.code}))
@@ -195,7 +189,6 @@ class LobbyGameplayExtractionTests(TestCase):
         self.assertEqual(response.status_code, 200)
         self.assertEqual(response.json(), {"ok": True})
         mock_finish_game.assert_called_once_with(self.session)
-        mock_build_response.assert_called_once_with(finished_session)
         mock_sync_broadcast_phase_event.assert_not_called()
 
 class LobbyFlowTests(TestCase):

lobby/views.py

@@ -10,12 +10,10 @@ from django.views.decorators.http import require_GET, require_POST
 
 from fupogfakta.models import Category, GameSession, Guess, LieAnswer, Player, Question, RoundConfig, RoundQuestion, ScoreEvent
 from fupogfakta.payloads import (
-    build_finish_game_response as _build_finish_game_response,
     build_leaderboard as _build_leaderboard,
     build_lie_started_payload as _build_lie_started_payload,
     build_reveal_payload as _build_reveal_payload,
     build_scoreboard_phase_event as _build_scoreboard_phase_event,
-    build_start_next_round_response as _build_start_next_round_response,
 )
 from fupogfakta.services import (
     finish_game as _finish_game,
@@ -75,11 +73,10 @@ def _create_unique_session_code() -> str:
 def _maybe_promote_reveal_to_scoreboard(session: GameSession) -> GameSession:
     transition = _promote_reveal_to_scoreboard(session)
     if transition.should_broadcast:
-        phase_event = _build_scoreboard_phase_event(transition.session, transition.leaderboard)
         sync_broadcast_phase_event(
             transition.session.code,
-            phase_event["name"],
-            phase_event["payload"],
+            transition.phase_event_name,
+            transition.phase_event_payload,
         )
     return transition.session
 
@@ -872,28 +869,16 @@ def reveal_scoreboard(request: HttpRequest, code: str) -> JsonResponse:
 
     transition = _promote_reveal_to_scoreboard(session)
     if transition.should_broadcast:
-        phase_event = _build_scoreboard_phase_event(transition.session, transition.leaderboard)
         sync_broadcast_phase_event(
             transition.session.code,
-            phase_event["name"],
-            phase_event["payload"],
+            transition.phase_event_name,
+            transition.phase_event_payload,
         )
     session = transition.session
     if session.status not in {GameSession.Status.SCOREBOARD, GameSession.Status.FINISHED}:
         return api_error(request, code="scoreboard_invalid_phase", status=400)
 
-    leaderboard = transition.leaderboard
-
-    return JsonResponse(
-        {
-            "session": {
-                "code": session.code,
-                "status": session.status,
-                "current_round": session.current_round,
-            },
-            "leaderboard": leaderboard,
-        }
-    )
+    return JsonResponse(transition.response_payload)
 
 
 @require_POST
@@ -921,13 +906,7 @@ def start_next_round(request: HttpRequest, code: str) -> JsonResponse:
             transition.phase_event_payload,
         )
 
-    return JsonResponse(
-        _build_start_next_round_response(
-            transition.session,
-            transition.round_config,
-            transition.round_question,
-        )
-    )
+    return JsonResponse(transition.response_payload)
 
 @require_POST
 @login_required
@@ -954,7 +933,7 @@ def finish_game(request: HttpRequest, code: str) -> JsonResponse:
             transition.phase_event_payload,
         )
 
-    return JsonResponse(_build_finish_game_response(transition.session))
+    return JsonResponse(transition.response_payload)
 
 
 @require_POST