@my-swu/simulator-client 0.1.0

package/schema/list-active-ai-matches-request.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ListActiveAiMatchesRequest",
+  "description": "Authenticated request for resumable solo AI matches holding a matching slot.",
+  "type": "object",
+  "properties": {
+    "historyIdentities": {
+      "description": "Browser/account proofs used to authorize the host seat.",
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistoryIdentityInput"
+      }
+    },
+    "limitScope": {
+      "description": "Admission counter the caller needs to free before retrying creation.",
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ActiveAiMatchLimitScope"
+    }
+  },
+  "required": [
+    "historyIdentities",
+    "limitScope"
+  ]
+}

package/schema/list-active-ai-matches-response.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ListActiveAiMatchesResponse",
+  "description": "Active AI matches the caller can resume or abandon to recover capacity.",
+  "type": "object",
+  "properties": {
+    "matches": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ActiveAiMatchRecoveryEntry"
+      }
+    }
+  },
+  "required": [
+    "matches"
+  ]
+}

package/schema/lobby-access-response.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyAccessResponse",
+  "type": "object",
+  "properties": {
+    "lobbyId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "playerId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "playerToken": {
+      "type": "string"
+    },
+    "private": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyPrivateView"
+    },
+    "snapshot": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbySnapshot"
+    }
+  },
+  "required": [
+    "lobbyId",
+    "playerId",
+    "playerToken",
+    "snapshot",
+    "private"
+  ]
+}

package/schema/lobby-chat-request.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyChatRequest",
+  "type": "object",
+  "properties": {
+    "message": {
+      "type": "string"
+    },
+    "playerToken": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "playerToken",
+    "message"
+  ]
+}

package/schema/lobby-chat-response.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyChatResponse",
+  "type": "object",
+  "properties": {
+    "message": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyChatMessage"
+    },
+    "snapshot": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbySnapshot"
+    }
+  },
+  "required": [
+    "message",
+    "snapshot"
+  ]
+}

package/schema/lobby-list-response.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyListResponse",
+  "type": "object",
+  "properties": {
+    "lobbies": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/PublicLobbySummary"
+      }
+    }
+  },
+  "required": [
+    "lobbies"
+  ]
+}

package/schema/lobby-list-server-message.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyListServerMessage",
+  "description": "Wire message pushed over the list-level lobby WebSocket (`GET /ws/lobbies`).\n\nUnlike [`LobbyServerMessage`] (the per-lobby socket), this carries the\npublic, viewer-agnostic lobby list rather than a single lobby snapshot. The\nserver sends a `Snapshot` immediately on connect and a fresh `Snapshot` on\nevery list-affecting change; `Pong` replies to a client `ping` keepalive.\nFull snapshots are pushed (no deltas): the list is capped at 50 entries.",
+  "oneOf": [
+    {
+      "description": "The complete, authoritative public lobby list. Replace, do not merge.",
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyListResponse"
+        },
+        "type": {
+          "type": "string",
+          "const": "snapshot"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "description": "Keepalive reply echoing the client-supplied nonce, if any.",
+      "type": "object",
+      "properties": {
+        "payload": {
+          "type": "object",
+          "properties": {
+            "nonce": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          }
+        },
+        "type": {
+          "type": "string",
+          "const": "pong"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    }
+  ]
+}

package/schema/lobby-matchmaking-decision-request.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyMatchmakingDecisionRequest",
+  "type": "object",
+  "properties": {
+    "playerToken": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "playerToken"
+  ]
+}

package/schema/lobby-matchmaking-request.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyMatchmakingRequest",
+  "type": "object",
+  "properties": {
+    "accountToken": {
+      "description": "Optional verified account proof. When present and the selection is\neligible, the server silently prefers the skill-based queue; any\nmissing or invalid token degrades to the random queue instead of\nfailing, so clients never learn which queue served them upfront.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "authenticated": {
+      "description": "Whether the queued player is authenticated in the app.",
+      "type": "boolean"
+    },
+    "avatarUrl": {
+      "description": "Optional public avatar image URL for the queued player.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "config": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyMatchmakingConfig"
+    },
+    "deck": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/DeckInput"
+    },
+    "deckId": {
+      "description": "Freeform client deck id for the submitted deck.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "deckTitle": {
+      "description": "Optional display title for the submitted deck.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "formatSetup": {
+      "description": "Optional format-specific setup submitted with the matchmaking deck.",
+      "anyOf": [
+        {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/FormatSetupInput"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "historyIdentities": {
+      "description": "Personal identities that should own this queued player's history.",
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/HistoryIdentityInput"
+      }
+    },
+    "name": {
+      "type": "string"
+    },
+    "profileUrl": {
+      "description": "Optional public profile page URL for the queued player.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "config",
+    "name",
+    "authenticated",
+    "historyIdentities",
+    "deck"
+  ]
+}

package/schema/lobby-response.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyResponse",
+  "type": "object",
+  "properties": {
+    "snapshot": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbySnapshot"
+    }
+  },
+  "required": [
+    "snapshot"
+  ]
+}

package/schema/lobby-server-message.schema.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbyServerMessage",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyWelcomePayload"
+        },
+        "type": {
+          "type": "string",
+          "const": "welcome"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbySnapshot"
+        },
+        "type": {
+          "type": "string",
+          "const": "snapshot"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "description": "The player was moved into a matched ranked lobby and must reconnect there.",
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyAccessResponse"
+        },
+        "type": {
+          "type": "string",
+          "const": "matchmakingRelocated"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyChatMessage"
+        },
+        "type": {
+          "type": "string",
+          "const": "chatMessage"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/RoomPlayerPresenceEvent"
+        },
+        "type": {
+          "type": "string",
+          "const": "playerPresence"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "started"
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/LobbyKickedPayload"
+        },
+        "type": {
+          "type": "string",
+          "const": "kicked"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/ErrorPayload"
+        },
+        "type": {
+          "type": "string",
+          "const": "error"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "type": "object",
+          "properties": {
+            "nonce": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          }
+        },
+        "type": {
+          "type": "string",
+          "const": "pong"
+        }
+      },
+      "required": [
+        "type",
+        "payload"
+      ]
+    }
+  ]
+}

package/schema/lobby-sync-request.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "LobbySyncRequest",
+  "type": "object",
+  "properties": {
+    "playerToken": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "playerToken"
+  ]
+}

package/schema/manifest.json

@@ -0,0 +1,124 @@
+{
+  "version": "d8592d3386a56e29b26ac35fb9e99a6e912733015edb7957fa7cae5282347bcf",
+  "files": [
+    "simulator-report-list-response.schema.json",
+    "simulator-report-response.schema.json",
+    "health-response.schema.json",
+    "simulator-availability-response.schema.json",
+    "simulator-admin-status-response.schema.json",
+    "card-catalog-refresh-response.schema.json",
+    "set-simulator-maintenance-request.schema.json",
+    "set-ranked-admission-request.schema.json",
+    "api-error-response.schema.json",
+    "meta-window.schema.json",
+    "ranked-queue.schema.json",
+    "ranked-admin-status.schema.json",
+    "ranked-matchmaking-view.schema.json",
+    "ranked-leaderboard-entry.schema.json",
+    "create-meta-window-request.schema.json",
+    "meta-windows-response.schema.json",
+    "ranked-profile-request.schema.json",
+    "ranked-profile-response.schema.json",
+    "ranked-leaderboard-query.schema.json",
+    "ranked-leaderboard-response.schema.json",
+    "create-match-request.schema.json",
+    "create-lobby-request.schema.json",
+    "join-lobby-request.schema.json",
+    "spectate-lobby-request.schema.json",
+    "lobby-matchmaking-request.schema.json",
+    "lobby-sync-request.schema.json",
+    "lobby-matchmaking-decision-request.schema.json",
+    "update-lobby-player-request.schema.json",
+    "update-lobby-ai-player-request.schema.json",
+    "add-lobby-ai-player-request.schema.json",
+    "lobby-chat-request.schema.json",
+    "start-lobby-request.schema.json",
+    "return-lobby-match-request.schema.json",
+    "submit-lobby-limited-deck-request.schema.json",
+    "prepare-lobby-limited-ai-decks-request.schema.json",
+    "start-lobby-limited-match-request.schema.json",
+    "leave-lobby-request.schema.json",
+    "kick-lobby-player-request.schema.json",
+    "kick-lobby-spectator-request.schema.json",
+    "update-lobby-settings-request.schema.json",
+    "lobby-response.schema.json",
+    "lobby-list-response.schema.json",
+    "lobby-access-response.schema.json",
+    "lobby-chat-response.schema.json",
+    "lobby-server-message.schema.json",
+    "lobby-list-server-message.schema.json",
+    "create-tournament-room-request.schema.json",
+    "join-tournament-room-request.schema.json",
+    "tournament-room-sync-request.schema.json",
+    "update-tournament-room-player-request.schema.json",
+    "update-tournament-room-settings-request.schema.json",
+    "tournament-room-chat-request.schema.json",
+    "start-tournament-event-request.schema.json",
+    "tournament-event-command-request.schema.json",
+    "submit-tournament-deck-request.schema.json",
+    "create-tournament-table-request.schema.json",
+    "join-tournament-table-request.schema.json",
+    "return-tournament-match-request.schema.json",
+    "leave-tournament-room-request.schema.json",
+    "close-tournament-room-request.schema.json",
+    "tournament-room-response.schema.json",
+    "tournament-room-list-response.schema.json",
+    "tournament-room-access-response.schema.json",
+    "tournament-room-chat-response.schema.json",
+    "tournament-room-server-message.schema.json",
+    "create-limited-event-request.schema.json",
+    "limited-event-access-response.schema.json",
+    "limited-event-preflight-response.schema.json",
+    "limited-event-response.schema.json",
+    "limited-event-command-request.schema.json",
+    "join-limited-event-request.schema.json",
+    "match-access-response.schema.json",
+    "abandon-match-request.schema.json",
+    "abandon-match-response.schema.json",
+    "list-active-ai-matches-request.schema.json",
+    "list-active-ai-matches-response.schema.json",
+    "leave-match-request.schema.json",
+    "leave-match-response.schema.json",
+    "match-spectator-access-response.schema.json",
+    "join-match-request.schema.json",
+    "spectate-match-request.schema.json",
+    "submit-match-deck-request.schema.json",
+    "submit-match-deck-response.schema.json",
+    "format-event-request.schema.json",
+    "format-event-response.schema.json",
+    "undo-match-request.schema.json",
+    "undo-match-response.schema.json",
+    "undo-respond-match-request.schema.json",
+    "rematch-match-request.schema.json",
+    "rematch-match-response.schema.json",
+    "set-ai-paused-request.schema.json",
+    "set-ai-paused-response.schema.json",
+    "get-match-response.schema.json",
+    "match-history-list-request.schema.json",
+    "match-history-list-response.schema.json",
+    "match-history-deck-stats-request.schema.json",
+    "match-history-deck-stats-response.schema.json",
+    "match-history-entry.schema.json",
+    "match-history-replay-request.schema.json",
+    "match-history-replay-response.schema.json",
+    "match-chat-lookup-response.schema.json",
+    "match-history-restore-request.schema.json",
+    "restore-history-response.schema.json",
+    "cards-response.schema.json",
+    "resolve-card-ids-request.schema.json",
+    "resolve-card-ids-response.schema.json",
+    "client-message.schema.json",
+    "server-message.schema.json",
+    "game-command.schema.json",
+    "game-event.schema.json",
+    "game-state.schema.json",
+    "match-connection-role.schema.json",
+    "welcome-payload.schema.json",
+    "error-payload.schema.json",
+    "match-save-payload.schema.json",
+    "save-match-request.schema.json",
+    "restore-match-save-request.schema.json",
+    "restore-match-save-response.schema.json"
+  ],
+  "shared": "common.schema.json"
+}

package/schema/match-access-response.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchAccessResponse",
+  "type": "object",
+  "properties": {
+    "matchId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "replaySeed": {
+      "description": "Resolved seed for a private solo-vs-AI match. Never projected in live state.",
+      "type": "integer",
+      "format": "uint64",
+      "minimum": 0
+    },
+    "seat": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/Seat"
+    },
+    "seatToken": {
+      "type": "string"
+    },
+    "snapshot": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/GameState"
+    }
+  },
+  "required": [
+    "matchId",
+    "seat",
+    "seatToken",
+    "snapshot"
+  ]
+}

package/schema/match-chat-lookup-response.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchChatLookupResponse",
+  "description": "One server-recorded chat message resolved for moderation review.\n\nThe payload is the server's own record, not a caller-supplied copy: a\nmoderation report must quote what the match actually broadcast.",
+  "type": "object",
+  "properties": {
+    "chat": {
+      "description": "Server-derived chat payload, including the authoring seat's identity.",
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchChatMessage"
+    },
+    "createdAtMs": {
+      "description": "When the server recorded the message, in Unix milliseconds.",
+      "type": "integer",
+      "format": "uint64",
+      "minimum": 0
+    },
+    "matchId": {
+      "description": "Match the message was recorded in.",
+      "type": "string",
+      "format": "uuid"
+    },
+    "messageId": {
+      "description": "History entry id of the message.",
+      "type": "string",
+      "format": "uuid"
+    }
+  },
+  "required": [
+    "matchId",
+    "messageId",
+    "createdAtMs",
+    "chat"
+  ]
+}

package/schema/match-connection-role.schema.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MatchConnectionRole",
+  "type": "string",
+  "enum": [
+    "player",
+    "spectator"
+  ]
+}