schema.json

// ===========================
// = Messages sent to server =
// ===========================

// Connect
{
  "messageType": "connect",
  "data": {
    "gameID": <number>
  }
}

// Join
{
  "messageType": "join",
  "data": {
    "nickname": string,
    "playerType": "player" | "spectator"
  }
}

// Ready

{
  "messageType": "set_ready",
  "data": {
    "ready": boolean
  }
}

// Card Move - TODO: update
{
  "messageType": "play_card",
  "data": {
    "target" : <target>,
  }
}

{
  "messageType": "draw",
  "data:" {
     "stack": <stack>,
  }
}

// Get game state
{
  "messageType": "get_game_state",
  "gameID": number
}

// Rematch

{
  "messageType": "rematch",
  "gameID": number
}


// =================================
// = Messages returned from server =
// =================================

// Error
{
  "messageType": "error",
  "data": {
    "errorMessage": string,
    "errorType": <short error message>
  }
}

// Error Types: join_failed | game_not_found

// Game Created
{
  "messageType": "game_created",
  "data": {
    "gameID": int,
  }
}

// Connected
{
  "messageType": "connected",
  "data": {
    "started": boolean,
    "players": [string]
  }
}

// Roster Update
{
  "messageType": "roster_update",
  "data": {
   "players": [<string>]
  }
}

// Started
{
  "messageType": "started",
  "data": {
   "gameState": <gamestate>
  }
}

// Game State - TODO: change to delta format
{
  "messageType": "game_state"
  "data": {
    "gameState": <gamestate>
  }
}

// Deal card
{
  "messageType": "deal_card",
  "data": {
    "card": <card>,
    "playerNumber": <number>,
    "stackNumber": <number>
  }
}

// Card Move (draw into hand or move from hand to rider)
{ 
  "messageType": "card move",
  "data": {
    "from": "deck" | { 
      "playerID": <number>,
      "location": "rider" | "hand" | <stackNumber>
    } | "deck",
    "to": { 
      "playerID": <number>, 
      "location": "rider" | "hand" | <stackNumber>
    } | trash,
    "card": <card>
  }
}

// Invalidate Move (reject a move from player's hand to a rider)

// Game over
{
  "messageType": "game_over"
  "data": {
    "winner": <string>,
  }
}

// ===================
// = Data Structures =
// ===================

target = {
  "kind": "player" | "stack",
  "id": number
}

"gameState": {
  "dealtCard": {
    "card": <card>,
    "target": <target>,
    "eta": number
  }
  "players": [
    {
      "rider": {
        "card": "hit" | "split" | "skip"
        "extras": number
      } | null,
      "stacks": [
        [<card>]
      ]
    }
  ]
}

"card": "hit" | "split" | "skip" | "stop" | "push" | "pull" | "ground"