// Package lobby defines the public typed command and response payloads
// exposed at the authenticated Gateway -> Game Lobby boundary.
package lobby

import "time"

const (
	// MessageTypeMyGamesList is the authenticated gateway message type
	// used to read the calling user's own games.
	MessageTypeMyGamesList = "lobby.my.games.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"
)

// MyGamesListRequest stores the authenticated read request for the
// caller's games. The request body is intentionally empty; gateway
// derives the calling user identity from the verified session.
type MyGamesListRequest struct{}

// MyGamesListResponse stores the list of games the caller participates
// in, ordered as Lobby returns them.
type MyGamesListResponse struct {
	Items []GameSummary `json:"items"`
}

// GameSummary stores one game record returned by `lobby.my.games.list`.
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"`
}

// OpenEnrollmentRequest stores the owner-only command that transitions
// a game from `draft` to `enrollment_open`.
type OpenEnrollmentRequest struct {
	// GameID identifies the game whose enrollment the caller wants to
	// open. The owner check is enforced by Lobby.
	GameID string `json:"game_id"`
}

// OpenEnrollmentResponse stores the resulting game record after a
// successful open-enrollment transition.
type OpenEnrollmentResponse struct {
	GameID string `json:"game_id"`
	Status string `json:"status"`
}

// ErrorBody stores the canonical Lobby error envelope code/message
// pair.
type ErrorBody struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

// ErrorResponse wraps ErrorBody for the FlatBuffers payload boundary.
type ErrorResponse struct {
	Error ErrorBody `json:"error"`
}