Enum ServerMessage 

pub enum ServerMessage {
    Hello {
        heartbeat_interval_ms: u32,
        server_version: Option<String>,
    },
    Ready {
        session_id: String,
        player_id: i64,
        lobby: Option<LobbySnapshot>,
        game: Option<GameSnapshot>,
    },
    Resumed {
        missed_events: Vec<ServerMessage>,
    },
    HeartbeatAck {
        server_time: u64,
    },
    InvalidSession {
        reason: String,
    },
    LobbyJoined {
        lobby_id: String,
        lobby_code: Option<String>,
        lobby: LobbySnapshot,
    },
    LobbySnapshot {
        lobby: LobbySnapshot,
    },
    LobbyDelta {
        changes: Vec<LobbyChange>,
    },
    LobbyLeft,
    CustomLobbyCreated {
        lobby_id: String,
        lobby_code: String,
    },
    GameStarted {
        game_id: String,
        grid: Grid,
        players: Vec<GamePlayerInfo>,
        your_turn_order: u8,
        current_turn: i64,
        round: u8,
        max_rounds: u8,
        turn_time_limit: Option<u32>,
    },
    GameSnapshot {
        game_id: String,
        game: GameSnapshot,
    },
    GameDelta {
        game_id: String,
        changes: Vec<GameChange>,
    },
    GameOver {
        game_id: String,
        final_scores: Vec<ScoreInfo>,
        winner_id: i64,
        is_draw: bool,
    },
    GameCancelled {
        game_id: String,
        reason: String,
    },
    PlayerJoined {
        player: LobbyPlayerInfo,
    },
    PlayerLeft {
        player_id: i64,
        reason: Option<String>,
    },
    PlayerReconnected {
        player_id: i64,
    },
    PlayerDisconnected {
        game_id: Option<String>,
        player_id: i64,
        grace_period_seconds: u32,
    },
    WordScored {
        player_id: i64,
        game_id: String,
        word: String,
        score: i32,
        path: Vec<Position>,
        total_score: i32,
        gems_earned: i32,
        total_gems: i32,
        new_grid: Grid,
    },
    TurnChanged {
        player_id: i64,
        game_id: String,
        round: u8,
        time_remaining: Option<u32>,
    },
    TurnPassed {
        player_id: i64,
        game_id: String,
    },
    RoundChanged {
        game_id: String,
        round: u8,
        max_rounds: u8,
        new_grid: Option<Grid>,
    },
    BoardShuffled {
        player_id: i64,
        game_id: String,
        new_grid: Grid,
        gems_spent: i32,
        total_gems: i32,
    },
    TileSwapped {
        player_id: i64,
        game_id: String,
        row: usize,
        col: usize,
        old_letter: char,
        new_letter: char,
        gems_spent: i32,
        total_gems: i32,
    },
    SwapModeEntered {
        player_id: i64,
        game_id: String,
    },
    SwapModeExited {
        player_id: i64,
        game_id: String,
    },
    SpectatorJoined {
        game_id: String,
        game: GameSnapshot,
    },
    SpectatorAdded {
        spectator: SpectatorInfo,
        game_id: String,
    },
    SpectatorRemoved {
        spectator_id: i64,
        game_id: String,
    },
    SpectatorBecamePlayer {
        player_id: i64,
        username: String,
        game_id: String,
    },
    SpectatorLeft,
    SelectionUpdate {
        player_id: i64,
        game_id: String,
        positions: Vec<Position>,
    },
    TimerVoteUpdate {
        state: TimerVoteState,
        game_id: String,
    },
    TurnTimerStarted {
        target_player_id: i64,
        game_id: String,
        seconds: u32,
    },
    TurnTimerExpired {
        player_id: i64,
        game_id: String,
    },
    RematchCountdownUpdate {
        state: RematchCountdownState,
        previous_game_id: String,
    },
    PlayerLeftRematch {
        player_id: i64,
        previous_game_id: String,
    },
    RematchStarting {
        triggered_by: Option<i64>,
        previous_game_id: String,
    },
    PlayerPoolChanged {
        player_id: i64,
        old_pool: Option<GameType>,
        new_pool: Option<GameType>,
    },
    PoolJoined {
        position: i32,
        total_in_pool: i32,
        game_id: String,
    },
    PoolUpdate {
        position: i32,
        total_in_pool: i32,
        game_id: String,
    },
    PoolLeft,
    AdminGamesList {
        games: Vec<AdminGameInfo>,
    },
    AdminGameDeleted {
        game_id: String,
    },
    GameStateUpdate {
        game_id: String,
        state: String,
        grid: Grid,
        players: Vec<PlayerInfo>,
        current_turn: i64,
        round: i32,
        max_rounds: i32,
        used_words: Vec<String>,
        spectators: Vec<SpectatorInfo>,
        timer_vote_state: TimerVoteState,
    },
    LobbyStateUpdate {
        lobby_id: String,
        players: Vec<LobbyPlayerInfo>,
        games: Vec<LobbyGameInfo>,
    },
    DebugStateResponse {
        timestamp: String,
        player: DebugPlayerInfo,
        websocket_context: DebugWebsocketContext,
        lobby_state: Option<DebugLobbyState>,
        backend_game_state: Option<DebugBackendGameState>,
        handler_game_state: Option<DebugHandlerGameState>,
    },
    Error {
        code: ErrorCode,
        message: String,
        details: Option<Value>,
    },
}

Messages sent from server to client.

Variants

Hello

Initial server greeting after WebSocket connect.

Sent immediately upon connection, before Identify.

Fields

heartbeat_interval_ms: u32

Recommended heartbeat interval in milliseconds

server_version: Option<String>

Server version for compatibility checks

Ready

Successful authentication response.

Contains the full initial state snapshot.

Fields

session_id: String

Unique session ID for this connection

player_id: i64

The authenticated player’s user ID

lobby: Option<LobbySnapshot>

Full lobby state (if in a lobby)

game: Option<GameSnapshot>

Full game state (if in a game)

Resumed

Session resumed successfully after reconnect.

Contains any events missed during disconnection.

Fields

missed_events: Vec<ServerMessage>

Events that occurred while disconnected

HeartbeatAck

Heartbeat response.

Echoes back for latency calculation.

Fields

server_time: u64

Server timestamp when heartbeat was received

InvalidSession

Session is invalid or expired.

Client should re-authenticate.

Fields

reason: String

LobbyJoined

Sent when successfully joining a lobby.

Fields

lobby_id: String

lobby_code: Option<String>

6-char code for custom lobbies

lobby: LobbySnapshot

Full lobby state

LobbySnapshot

Full lobby state snapshot.

Sent on initial join or when delta sync fails.

Fields

lobby: LobbySnapshot

LobbyDelta

Incremental lobby state update.

More efficient than full snapshots for small changes.

Fields

changes: Vec<LobbyChange>

LobbyLeft

Confirmation of leaving lobby.

CustomLobbyCreated

Custom lobby was created successfully.

Fields

lobby_id: String

lobby_code: String

GameStarted

A new game has started.

Contains initial game state for all participants.

Fields

game_id: String

grid: Grid

players: Vec<GamePlayerInfo>

your_turn_order: u8

Your turn order (0-indexed)

current_turn: i64

Who goes first

round: u8

max_rounds: u8

turn_time_limit: Option<u32>

Turn time limit in seconds (if configured)

GameSnapshot

Full game state snapshot.

Sent when joining as spectator or when delta sync fails.

Fields

game_id: String

game: GameSnapshot

GameDelta

Incremental game state update.

Fields

game_id: String

changes: Vec<GameChange>

GameOver

Game has ended normally.

Fields

game_id: String

final_scores: Vec<ScoreInfo>

Final scores, sorted by rank

winner_id: i64

Winner’s user ID

is_draw: bool

Whether it was a draw

GameCancelled

Game was cancelled (not enough players, host left, etc.).

Fields

game_id: String

reason: String

PlayerJoined

A player joined the lobby.

Fields

player: LobbyPlayerInfo

PlayerLeft

A player left the lobby.

Fields

player_id: i64

reason: Option<String>

PlayerReconnected

A player reconnected after disconnection.

Fields

player_id: i64

PlayerDisconnected

A player disconnected (may reconnect).

Fields

game_id: Option<String>

player_id: i64

grace_period_seconds: u32

Grace period in seconds before they’re removed

WordScored

A word was successfully scored.

Fields

player_id: i64

game_id: String

word: String

score: i32

path: Vec<Position>

Positions that formed the word

total_score: i32

New total score

gems_earned: i32

Gems earned from this word

total_gems: i32

New gem total

new_grid: Grid

Updated grid (letters replaced)

TurnChanged

Turn changed to another player.

Fields

player_id: i64

game_id: String

round: u8

time_remaining: Option<u32>

Time remaining for this turn (if timer active)

TurnPassed

A player passed their turn.

Fields

player_id: i64

game_id: String

RoundChanged

Round number changed.

Fields

game_id: String

round: u8

max_rounds: u8

new_grid: Option<Grid>

New grid if board was regenerated at the start of this round. Only present when the game is configured with regenerate_board_each_round: true.

BoardShuffled

Board was shuffled.

Fields

player_id: i64

game_id: String

new_grid: Grid

gems_spent: i32

total_gems: i32

Player’s remaining gems after shuffle

TileSwapped

A tile was swapped.

Fields

player_id: i64

game_id: String

row: usize

col: usize

old_letter: char

new_letter: char

gems_spent: i32

total_gems: i32

Player’s remaining gems after swap

SwapModeEntered

Player entered swap mode (for animation).

Fields

player_id: i64

game_id: String

SwapModeExited

Player exited swap mode.

Fields

player_id: i64

game_id: String

SpectatorJoined

Successfully joined as spectator.

Fields

game_id: String

game: GameSnapshot

Full game state

SpectatorAdded

A new spectator joined (broadcast to others).

Fields

spectator: SpectatorInfo

game_id: String

SpectatorRemoved

A spectator left.

Fields

spectator_id: i64

game_id: String

SpectatorBecamePlayer

Spectator joined as player.

Fields

player_id: i64

username: String

game_id: String

SpectatorLeft

Confirmation of leaving spectator mode.

SelectionUpdate

Another player’s tile selection (for live preview).

Fields

player_id: i64

game_id: String

positions: Vec<Position>

TimerVoteUpdate

Timer vote state changed.

Fields

state: TimerVoteState

game_id: String

TurnTimerStarted

Turn timer started (vote passed).

Fields

target_player_id: i64

game_id: String

seconds: u32

TurnTimerExpired

Turn timer expired - player auto-passed.

Fields

player_id: i64

game_id: String

RematchCountdownUpdate

Rematch countdown state update.

Sent to all players on the results screen after a game ends.

Fields

state: RematchCountdownState

Current countdown state

previous_game_id: String

The game that just ended

PlayerLeftRematch

A player opted out of rematch pool.

Broadcast to remaining players so they can update the player list.

Fields

player_id: i64

previous_game_id: String

The game they left from

RematchStarting

Rematch is starting (sent right before GameStarted).

Allows frontend to show “Starting…” before the new game begins.

Fields

triggered_by: Option<i64>

Who triggered the early start (None if countdown expired naturally)

previous_game_id: String

The previous game that ended

PlayerPoolChanged

Fields

player_id: i64

old_pool: Option<GameType>

new_pool: Option<GameType>

PoolJoined

Player joined the game pool.

Fields

position: i32

total_in_pool: i32

game_id: String

PoolUpdate

Pool position updated.

Fields

position: i32

total_in_pool: i32

game_id: String

PoolLeft

Left the pool.

AdminGamesList

Response to admin game list request.

Fields

games: Vec<AdminGameInfo>

AdminGameDeleted

Game was deleted by admin.

Fields

game_id: String

GameStateUpdate

Generic state update (legacy format).

Used for backward compatibility with existing frontend.

Fields

game_id: String

state: String

grid: Grid

players: Vec<PlayerInfo>

current_turn: i64

round: i32

max_rounds: i32

used_words: Vec<String>

spectators: Vec<SpectatorInfo>

timer_vote_state: TimerVoteState

LobbyStateUpdate

Lobby state update (legacy format).

Fields

lobby_id: String

players: Vec<LobbyPlayerInfo>

games: Vec<LobbyGameInfo>

DebugStateResponse

Debug state response with player context diagnostics.

Fields

timestamp: String

player: DebugPlayerInfo

websocket_context: DebugWebsocketContext

lobby_state: Option<DebugLobbyState>

backend_game_state: Option<DebugBackendGameState>

handler_game_state: Option<DebugHandlerGameState>

Error

Error response.

Fields

code: ErrorCode

message: String

details: Option<Value>

Additional context (e.g., which field was invalid)

Implementations

impl ServerMessage

pub fn error(code: ErrorCode) -> Self

Create an error message from an error code.

pub fn error_with_message(code: ErrorCode, message: impl Into<String>) -> Self

Create an error message with custom message.

pub fn error_with_details( code: ErrorCode, message: impl Into<String>, details: Value, ) -> Self

Create an error message with details.

pub fn message_type(&self) -> &'static str

Get the message type as a string (for logging/debugging).

pub fn is_error(&self) -> bool

Check if this is an error message.

pub fn should_store_for_replay(&self) -> bool

Check if this message should be stored for reconnection replay.

Some messages are transient and don’t need to be replayed.

Trait Implementations

impl Clone for ServerMessage

fn clone(&self) -> ServerMessage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServerMessage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ServerMessage> for Value

Convert a ServerMessage to a serde_json::Value.

fn from(msg: ServerMessage) -> Self

Converts to this type from the input type.

impl Serialize for ServerMessage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Value> for ServerMessage

Convert a serde_json::Value to a ServerMessage.

type Error = Error

The type returned in the event of a conversion error.

fn try_from( value: Value, ) -> Result<Self, <ServerMessage as TryFrom<Value>>::Error>

Performs the conversion.