phase 8: lobby UI + cross-stack lobby command catalog + TS FlatBuffers

- Extend pkg/model/lobby and pkg/schema/fbs/lobby.fbs with public-games list, my-applications/invites lists, game-create, application-submit, invite-redeem/decline. Mirror the matching transcoder pairs and Go fixture round-trip tests. - Wire the seven new lobby message types through gateway/internal/backendclient/{routes,lobby_commands}.go with per-command REST helpers, JSON-tolerant decoding of backend wire shapes, and httptest-based unit coverage for success / 4xx / 5xx / 503 across each command. - Introduce TS-side FlatBuffers via the `flatbuffers` runtime dep, a `make fbs-ts` target driving flatc, and the generated bindings under ui/frontend/src/proto/galaxy/fbs. Phase 7's `user.account.get` decode now uses these bindings as well, closing the JSON.parse vs FlatBuffers gap that would have failed against a real local stack. - Replace the placeholder lobby with five sections (my games, pending invitations, my applications, public games, create new game) and the /lobby/create form. Submit-application uses an inline race-name form on the public-game card; create-game keeps name / description / turn_schedule / enrollment_ends_at always visible and the rest under an Advanced toggle with TS-side defaults. - Update lobby/+page.svelte to throw LobbyError on non-ok result codes; GalaxyClient.executeCommand now returns { resultCode, payloadBytes }. - Vitest binding round-trips, lobby.ts wrapper unit tests, lobby-page + lobby-create component tests, Playwright lobby-flow.spec covering create / submit / accept across all four projects. Phase 7 e2e was migrated to the FlatBuffers fixtures and to click+fill against the Safari-autofill readonly inputs. - Mark Phase 8 done in ui/PLAN.md, mirror the wire-format note into Phase 7, append the new lobby commands to gateway/README.md and docs/ARCHITECTURE.md, add ui/docs/lobby.md. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-07 18:05:08 +02:00
parent 5d2a3b79c5
commit f57a290432
90 changed files with 11862 additions and 112 deletions
@@ -9,10 +9,44 @@ const (
 	// used to read the calling user's own games.
 	MessageTypeMyGamesList = "lobby.my.games.list"

+	// MessageTypePublicGamesList is the authenticated gateway message
+	// type used to read the paginated list of joinable public games.
+	MessageTypePublicGamesList = "lobby.public.games.list"
+
+	// MessageTypeMyApplicationsList is the authenticated gateway message
+	// type used to read the caller's pending and decided applications to
+	// public games.
+	MessageTypeMyApplicationsList = "lobby.my.applications.list"
+
+	// MessageTypeMyInvitesList is the authenticated gateway message type
+	// used to read the caller's pending invites to private games.
+	MessageTypeMyInvitesList = "lobby.my.invites.list"
+
 	// MessageTypeOpenEnrollment is the authenticated gateway message
 	// type used by the game owner to transition a draft game to
 	// `enrollment_open`.
 	MessageTypeOpenEnrollment = "lobby.game.open-enrollment"
+
+	// MessageTypeGameCreate is the authenticated gateway message type
+	// used to create a private game owned by the caller. Public games
+	// are created exclusively through the admin surface; the gateway
+	// rejects any attempt to set visibility to `public`.
+	MessageTypeGameCreate = "lobby.game.create"
+
+	// MessageTypeApplicationSubmit is the authenticated gateway message
+	// type used by a user to submit an application to a public game in
+	// `enrollment_open`.
+	MessageTypeApplicationSubmit = "lobby.application.submit"
+
+	// MessageTypeInviteRedeem is the authenticated gateway message type
+	// used to accept an outstanding invite and create the corresponding
+	// membership.
+	MessageTypeInviteRedeem = "lobby.invite.redeem"
+
+	// MessageTypeInviteDecline is the authenticated gateway message type
+	// used to terminally decline an outstanding invite. No membership is
+	// created.
+	MessageTypeInviteDecline = "lobby.invite.decline"
 )

 // MyGamesListRequest stores the authenticated read request for the
@@ -26,18 +60,88 @@ type MyGamesListResponse struct {
 	Items []GameSummary `json:"items"`
 }

-// GameSummary stores one game record returned by `lobby.my.games.list`.
+// GameSummary stores one game record returned by the various lobby
+// list endpoints. `OwnerUserID` is empty for public games (no human
+// owner).
 type GameSummary struct {
-	GameID             string    `json:"game_id"`
-	GameName           string    `json:"game_name"`
-	GameType           string    `json:"game_type"`
-	Status             string    `json:"status"`
-	OwnerUserID        string    `json:"owner_user_id"`
-	MinPlayers         int       `json:"min_players"`
-	MaxPlayers         int       `json:"max_players"`
-	EnrollmentEndsAt   time.Time `json:"enrollment_ends_at"`
-	CreatedAt          time.Time `json:"created_at"`
-	UpdatedAt          time.Time `json:"updated_at"`
+	GameID           string    `json:"game_id"`
+	GameName         string    `json:"game_name"`
+	GameType         string    `json:"game_type"`
+	Status           string    `json:"status"`
+	OwnerUserID      string    `json:"owner_user_id"`
+	MinPlayers       int       `json:"min_players"`
+	MaxPlayers       int       `json:"max_players"`
+	EnrollmentEndsAt time.Time `json:"enrollment_ends_at"`
+	CreatedAt        time.Time `json:"created_at"`
+	UpdatedAt        time.Time `json:"updated_at"`
+}
+
+// PublicGamesListRequest stores the paginated read request for joinable
+// public games. Page numbers start at 1; page sizes are capped by the
+// backend.
+type PublicGamesListRequest struct {
+	Page     int `json:"page"`
+	PageSize int `json:"page_size"`
+}
+
+// PublicGamesListResponse stores one page of public games together with
+// the pagination metadata returned by the backend.
+type PublicGamesListResponse struct {
+	Items    []GameSummary `json:"items"`
+	Page     int           `json:"page"`
+	PageSize int           `json:"page_size"`
+	Total    int           `json:"total"`
+}
+
+// MyApplicationsListRequest stores the authenticated read request for
+// the caller's applications. Empty body — gateway derives identity from
+// the authenticated session.
+type MyApplicationsListRequest struct{}
+
+// MyApplicationsListResponse stores the caller's application list,
+// ordered as Lobby returns it.
+type MyApplicationsListResponse struct {
+	Items []ApplicationSummary `json:"items"`
+}
+
+// ApplicationSummary stores a single application record returned by
+// `lobby.my.applications.list` and `lobby.application.submit`.
+// `DecidedAt` is nil while the application is pending.
+type ApplicationSummary struct {
+	ApplicationID   string     `json:"application_id"`
+	GameID          string     `json:"game_id"`
+	ApplicantUserID string     `json:"applicant_user_id"`
+	RaceName        string     `json:"race_name"`
+	Status          string     `json:"status"`
+	CreatedAt       time.Time  `json:"created_at"`
+	DecidedAt       *time.Time `json:"decided_at,omitempty"`
+}
+
+// MyInvitesListRequest stores the authenticated read request for the
+// caller's invites. Empty body.
+type MyInvitesListRequest struct{}
+
+// MyInvitesListResponse stores the caller's invite list.
+type MyInvitesListResponse struct {
+	Items []InviteSummary `json:"items"`
+}
+
+// InviteSummary stores one invite record returned by
+// `lobby.my.invites.list`, `lobby.invite.redeem`, and
+// `lobby.invite.decline`. `InvitedUserID` is empty for code-based
+// invites; `Code` is empty for user-bound invites; `DecidedAt` is nil
+// while the invite is still pending.
+type InviteSummary struct {
+	InviteID      string     `json:"invite_id"`
+	GameID        string     `json:"game_id"`
+	InviterUserID string     `json:"inviter_user_id"`
+	InvitedUserID string     `json:"invited_user_id,omitempty"`
+	Code          string     `json:"code,omitempty"`
+	RaceName      string     `json:"race_name"`
+	Status        string     `json:"status"`
+	CreatedAt     time.Time  `json:"created_at"`
+	ExpiresAt     time.Time  `json:"expires_at"`
+	DecidedAt     *time.Time `json:"decided_at,omitempty"`
 }

 // OpenEnrollmentRequest stores the owner-only command that transitions
@@ -55,6 +159,70 @@ type OpenEnrollmentResponse struct {
 	Status string `json:"status"`
 }

+// GameCreateRequest stores the create-game command issued by the user
+// surface. Visibility is always `private` here; the gateway rejects any
+// other value before forwarding to backend, mirroring the FUNCTIONAL
+// §3.3 invariant.
+type GameCreateRequest struct {
+	GameName            string    `json:"game_name"`
+	Description         string    `json:"description"`
+	MinPlayers          int       `json:"min_players"`
+	MaxPlayers          int       `json:"max_players"`
+	StartGapHours       int       `json:"start_gap_hours"`
+	StartGapPlayers     int       `json:"start_gap_players"`
+	EnrollmentEndsAt    time.Time `json:"enrollment_ends_at"`
+	TurnSchedule        string    `json:"turn_schedule"`
+	TargetEngineVersion string    `json:"target_engine_version"`
+}
+
+// GameCreateResponse stores the freshly created game projected onto the
+// shared GameSummary shape — the gateway does not expose runtime fields
+// at create time because the game is always in `draft` until the owner
+// transitions it.
+type GameCreateResponse struct {
+	Game GameSummary `json:"game"`
+}
+
+// ApplicationSubmitRequest stores the submit-application command. The
+// game must be public and in `enrollment_open`; backend rejects all
+// other states.
+type ApplicationSubmitRequest struct {
+	GameID   string `json:"game_id"`
+	RaceName string `json:"race_name"`
+}
+
+// ApplicationSubmitResponse wraps the application created by a
+// successful submit-application call.
+type ApplicationSubmitResponse struct {
+	Application ApplicationSummary `json:"application"`
+}
+
+// InviteRedeemRequest accepts a pending invite and creates the
+// corresponding membership at the backend.
+type InviteRedeemRequest struct {
+	GameID   string `json:"game_id"`
+	InviteID string `json:"invite_id"`
+}
+
+// InviteRedeemResponse wraps the invite record updated by a successful
+// redeem (status transitions to `accepted`).
+type InviteRedeemResponse struct {
+	Invite InviteSummary `json:"invite"`
+}
+
+// InviteDeclineRequest terminally declines a pending invite. No
+// membership is created.
+type InviteDeclineRequest struct {
+	GameID   string `json:"game_id"`
+	InviteID string `json:"invite_id"`
+}
+
+// InviteDeclineResponse wraps the invite record updated by a successful
+// decline (status transitions to `declined`).
+type InviteDeclineResponse struct {
+	Invite InviteSummary `json:"invite"`
+}
+
 // ErrorBody stores the canonical Lobby error envelope code/message
 // pair.
 type ErrorBody struct {