@lichess-org/types 2.0.19 → 2.0.21

package/lichess-api.d.ts

@@ -203,6 +203,31 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/puzzle/next": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get a new puzzle
+     * @description Get a random Lichess puzzle in JSON format.
+     *
+     *     If authenticated, only returns puzzles that the user has never seen before.
+     *
+     *     **DO NOT** use this endpoint to enumerate puzzles for mass download. Instead, download the [full public puzzle database](https://database.lichess.org/#puzzles).
+     *
+     */
+    get: operations["apiPuzzleNext"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/puzzle/activity": {
     parameters: {
       query?: never;
@@ -799,7 +824,7 @@ export interface paths {
     };
     /**
      * Get current tournaments
-     * @description Get recently finished, ongoing, and upcoming tournaments.
+     * @description Get recently active and finished tournaments.
      *     This API is used to display the [Lichess tournament schedule](https://lichess.org/tournament).
      *
      */
@@ -1579,7 +1604,7 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
-  "/broadcast/{broadcastTournamentId}/leaderboard": {
+  "/broadcast/{broadcastTournamentId}/players": {
     parameters: {
       query?: never;
       header?: never;
@@ -1587,11 +1612,11 @@ export interface paths {
       cookie?: never;
     };
     /**
-     * Get a broadcast leaderboard
-     * @description Get the leaderboard of a broadcast tournament, if available.
+     * Get players of a broadcast
+     * @description Get the list of players of a broadcast tournament, if available.
      *
      */
-    get: operations["broadcastLeaderboardGet"];
+    get: operations["broadcastPlayersGet"];
     put?: never;
     post?: never;
     delete?: never;
@@ -1711,7 +1736,7 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
-  "/broadcast/round/{broadcastRoundId}/push": {
+  "/api/broadcast/round/{broadcastRoundId}/push": {
     parameters: {
       query?: never;
       header?: never;
@@ -3422,8 +3447,10 @@ export interface paths {
      *     Start the OAuth2 Authorization Code Flow with PKCE by securely
      *     generating two random strings unique to each authorization
      *     request:
+     *
      *     * `code_verifier`
      *     * `state`
+     *
      *     Store these in session storage. Make sure not to reveal `code_verifier`
      *     to eavesdroppers. Do not show it in URLs, do not abuse `state` to store
      *     it, do not send it over insecure connections. However it is fine if
@@ -3433,16 +3460,21 @@ export interface paths {
      *     authorization and then be redirected back to the given `redirect_uri`.
      *     If the authorization failed, the following query string parameters will
      *     be appended to the redirection:
+     *
      *     * `error`, in particular with value `access_denied` if the user
      *        cancelled authorization
      *     * `error_description` to aid debugging
      *     * `state`, exactly as passed in the `state` parameter
+     *
      *     If the authorization succeeded, the following query string parameters
      *     will be appended to the redirection:
+     *
      *     * `code`, containing a fresh short-lived authorization code
      *     * `state`, exactly as passed in the `state` parameter
+     *
      *     Next, to defend against cross site request forgery, check that the
      *     returned `state` matches the `state` you originally generated.
+     *
      *     Finally, continue by using the authorization code to
      *     [obtain an access token](#operation/apiToken).
      *
@@ -3515,6 +3547,7 @@ export interface paths {
     /**
      * Masters database
      * @description **Endpoint: <https://explorer.lichess.ovh/masters>**
+     *
      *     Example: `curl https://explorer.lichess.ovh/masters?play=d2d4,d7d5,c2c4,c7c6,c4d5`
      *
      */
@@ -3537,7 +3570,9 @@ export interface paths {
     /**
      * Lichess games
      * @description **Endpoint: <https://explorer.lichess.ovh/lichess>**
+     *
      *     Games sampled from all Lichess players.
+     *
      *     Example: `curl https://explorer.lichess.ovh/lichess?variant=standard&speeds=blitz,rapid,classical&ratings=2200,2500&fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR%20w%20KQkq%20-%200%201`
      *
      */
@@ -3560,13 +3595,17 @@ export interface paths {
     /**
      * Player games
      * @description **Endpoint: <https://explorer.lichess.ovh/player>**
+     *
      *     Games of a Lichess player.
+     *
      *     Responds with a stream of [newline delimited JSON](#section/Introduction/Streaming-with-ND-JSON). Will start indexing
      *     on demand, immediately respond with the current results, and stream
      *     more updates until indexing is complete. The stream is throttled
      *     and deduplicated. Empty lines may be sent to avoid timeouts.
+     *
      *     Will index new games at most once per minute, and revisit previously
      *     ongoing games at most once every day.
+     *
      *     Example: `curl https://explorer.lichess.ovh/player?player=revoof&color=white&play=d2d4,d7d5&recentGames=1`
      *
      */
@@ -3589,6 +3628,7 @@ export interface paths {
     /**
      * OTB master game
      * @description **Endpoint: `https://explorer.lichess.ovh/masters/pgn/{gameId}`**
+     *
      *     Example: `curl https://explorer.lichess.ovh/masters/pgn/aAbqI4ey`
      *
      */
@@ -4648,6 +4688,142 @@ export interface components {
     Ok: {
       ok?: boolean;
     };
+    TimelineEntryFollow: {
+      /** @enum {string} */
+      type: "follow";
+      date: number;
+      data: {
+        u1: string;
+        u2: string;
+      };
+    };
+    TimelineEntryTeamJoin: {
+      /** @enum {string} */
+      type: "team-join";
+      date: number;
+      data: {
+        userId: string;
+        teamId: string;
+      };
+    };
+    TimelineEntryTeamCreate: {
+      /** @enum {string} */
+      type: "team-create";
+      date: number;
+      data: {
+        userId: string;
+        teamId: string;
+      };
+    };
+    TimelineEntryForumPost: {
+      /** @enum {string} */
+      type: "forum-post";
+      date: number;
+      data: {
+        userId: string;
+        topicId: string;
+        topicName: string;
+        postId: string;
+      };
+    };
+    TimelineEntryBlogPost: {
+      /** @enum {string} */
+      type: "blog-post";
+      date: number;
+      data: {
+        id: string;
+        slug: string;
+        title: string;
+      };
+    };
+    TimelineEntryUblogPost: {
+      /** @enum {string} */
+      type: "ublog-post";
+      date: number;
+      data: {
+        userId: string;
+        id: string;
+        slug: string;
+        title: string;
+      };
+    };
+    TimelineEntryTourJoin: {
+      /** @enum {string} */
+      type: "tour-join";
+      date: number;
+      data: {
+        userId: string;
+        tourId: string;
+        tourName: string;
+      };
+    };
+    TimelineEntryGameEnd: {
+      /** @enum {string} */
+      type: "game-end";
+      date: number;
+      data: {
+        fullId: string;
+        opponent: string;
+        win: boolean;
+        perf: components["schemas"]["PerfType"];
+      };
+    };
+    TimelineEntrySimul: {
+      /** @enum {string} */
+      type: "simul-create" | "simul-join";
+      date: number;
+      data: {
+        userId: string;
+        simulId: string;
+        simulName: string;
+      };
+    };
+    TimelineEntryStudyLike: {
+      /** @enum {string} */
+      type: "study-like";
+      date: number;
+      data: {
+        userId: string;
+        studyId: string;
+        studyName: string;
+      };
+    };
+    TimelineEntryPlanStart: {
+      /** @enum {string} */
+      type: "plan-start";
+      date: number;
+      data: {
+        userId: string;
+      };
+    };
+    TimelineEntryPlanRenew: {
+      /** @enum {string} */
+      type: "plan-renew";
+      date: number;
+      data: {
+        userId: string;
+        months: number;
+      };
+    };
+    TimelineEntryUblogPostLike: {
+      /** @enum {string} */
+      type: "ublog-post-like";
+      date: number;
+      data: {
+        userId: string;
+        id: string;
+        title: string;
+      };
+    };
+    TimelineEntryStreamStart: {
+      /** @enum {string} */
+      type: "stream-start";
+      date: number;
+      data: {
+        id: string;
+        name?: string;
+      };
+    };
     /** @example {
      *       "entries": [
      *         {
@@ -4776,7 +4952,7 @@ export interface components {
      *         {
      *           "type": "stream-start",
      *           "data": {
-     *             "userId": "chess-network",
+     *             "id": "chess-network",
      *             "title": "Streamers Battle December !team | lichess.org"
      *           },
      *           "date": 1644232201429
@@ -4797,8 +4973,30 @@ export interface components {
      *       }
      *     } */
     Timeline: {
-      entries?: unknown[];
-      users?: Record<string, never>;
+      entries: (
+        | components["schemas"]["TimelineEntryFollow"]
+        | components["schemas"]["TimelineEntryTeamJoin"]
+        | components["schemas"]["TimelineEntryTeamCreate"]
+        | components["schemas"]["TimelineEntryForumPost"]
+        | components["schemas"]["TimelineEntryBlogPost"]
+        | components["schemas"]["TimelineEntryUblogPost"]
+        | components["schemas"]["TimelineEntryTourJoin"]
+        | components["schemas"]["TimelineEntryGameEnd"]
+        | components["schemas"]["TimelineEntrySimul"]
+        | components["schemas"]["TimelineEntryStudyLike"]
+        | components["schemas"]["TimelineEntryPlanStart"]
+        | components["schemas"]["TimelineEntryPlanRenew"]
+        | components["schemas"]["TimelineEntryUblogPostLike"]
+        | components["schemas"]["TimelineEntryStreamStart"]
+      )[];
+      users: {
+        [key: string]: {
+          id: string;
+          name: string;
+          title?: components["schemas"]["Title"];
+          patron?: boolean;
+        };
+      };
     };
     /** @example [Event "Rated Blitz game"]
      *     [Site "https://lichess.org/fY44h4OY"]
@@ -4885,6 +5083,7 @@ export interface components {
         mistake: number;
         blunder: number;
         acpl: number;
+        accuracy?: number;
       };
       team?: string;
     };
@@ -5857,7 +6056,6 @@ export interface components {
     };
     BroadcastTop: {
       active?: components["schemas"]["BroadcastWithLastRound"][];
-      upcoming?: components["schemas"]["BroadcastWithLastRound"][];
       past?: {
         /** @example 4 */
         currentPage?: number;
@@ -6000,7 +6198,7 @@ export interface components {
        */
       tier?: 3 | 4 | 5 | -1;
     };
-    BroadcastLeaderboardEntry: {
+    BroadcastPlayerEntry: {
       /** @example Hernandez Riera, Jose */
       name?: string;
       /** @example 2.5 */
@@ -6009,6 +6207,10 @@ export interface components {
       played?: number;
       /** @example 2149 */
       rating?: number;
+      /** @example -5 */
+      ratingDiff?: number;
+      /** @example 2138 */
+      performance?: number;
       /** @example FM */
       title?: string;
       /** @example 3408230 */
@@ -7232,23 +7434,41 @@ export interface components {
       /** @description The reason why the request was rejected. */
       error_description?: string;
     };
+    OpeningExplorerOpening: {
+      eco: string;
+      name: string;
+    };
+    OpeningExplorerGamePlayer: {
+      name: string;
+      rating: number;
+    };
+    OpeningExplorerMastersGame: {
+      id: string;
+      /** @enum {string|null} */
+      winner: "white" | "black" | null;
+      white: components["schemas"]["OpeningExplorerGamePlayer"];
+      black: components["schemas"]["OpeningExplorerGamePlayer"];
+      year: number;
+      month?: string;
+    };
     /** @example {
      *       "opening": {
      *         "eco": "D10",
      *         "name": "Slav Defense: Exchange Variation"
      *       },
-     *       "white": 1443,
-     *       "draws": 3787,
-     *       "black": 1156,
+     *       "white": 1828,
+     *       "draws": 4904,
+     *       "black": 1403,
      *       "moves": [
      *         {
      *           "uci": "c6d5",
      *           "san": "cxd5",
-     *           "averageRating": 2423,
-     *           "white": 1443,
-     *           "draws": 3787,
-     *           "black": 1155,
-     *           "game": null
+     *           "averageRating": 2414,
+     *           "white": 1828,
+     *           "draws": 4904,
+     *           "black": 1402,
+     *           "game": null,
+     *           "opening": null
      *         },
      *         {
      *           "uci": "g8f6",
@@ -7260,16 +7480,20 @@ export interface components {
      *           "game": {
      *             "id": "1EErB5jc",
      *             "winner": "black",
-     *             "white": {
-     *               "name": "Drozdovskij, Yuri",
-     *               "rating": 2509
-     *             },
      *             "black": {
      *               "name": "Dobrov, Vladimir",
      *               "rating": 2515
      *             },
+     *             "white": {
+     *               "name": "Drozdovskij, Yuri",
+     *               "rating": 2509
+     *             },
      *             "year": 2006,
      *             "month": "2006-01"
+     *           },
+     *           "opening": {
+     *             "eco": "D06",
+     *             "name": "Queen's Gambit Declined: Marshall Defense, Tan Gambit"
      *           }
      *         }
      *       ],
@@ -7278,14 +7502,14 @@ export interface components {
      *           "uci": "c6d5",
      *           "id": "kN6d9l2i",
      *           "winner": "black",
-     *           "white": {
-     *             "name": "Carlsen, M.",
-     *             "rating": 2881
-     *           },
      *           "black": {
      *             "name": "Anand, V.",
      *             "rating": 2785
      *           },
+     *           "white": {
+     *             "name": "Carlsen, M.",
+     *             "rating": 2881
+     *           },
      *           "year": 2014,
      *           "month": "2014-06"
      *         },
@@ -7293,59 +7517,211 @@ export interface components {
      *           "uci": "c6d5",
      *           "id": "qeYPJL2y",
      *           "winner": "white",
+     *           "black": {
+     *             "name": "Carlsen, M.",
+     *             "rating": 2843
+     *           },
      *           "white": {
      *             "name": "So, W.",
      *             "rating": 2778
      *           },
+     *           "year": 2018,
+     *           "month": "2018-06"
+     *         }
+     *       ]
+     *     } */
+    OpeningExplorerMasters: {
+      opening: components["schemas"]["OpeningExplorerOpening"] | null;
+      white: number;
+      draws: number;
+      black: number;
+      moves: {
+        uci: string;
+        san: string;
+        averageRating: number;
+        white: number;
+        draws: number;
+        black: number;
+        game: components["schemas"]["OpeningExplorerMastersGame"] | null;
+        opening: components["schemas"]["OpeningExplorerOpening"] | null;
+      }[];
+      topGames: ({
+        uci: string;
+      } & components["schemas"]["OpeningExplorerMastersGame"])[];
+    };
+    OpeningExplorerLichessGame: {
+      id: string;
+      /** @enum {string|null} */
+      winner: "white" | "black" | null;
+      speed: components["schemas"]["Speed"];
+      white: components["schemas"]["OpeningExplorerGamePlayer"];
+      black: components["schemas"]["OpeningExplorerGamePlayer"];
+      year: number;
+      month: string;
+    };
+    /** @example {
+     *       "opening": {
+     *         "eco": "D10",
+     *         "name": "Slav Defense: Exchange Variation"
+     *       },
+     *       "white": 4164079,
+     *       "draws": 405547,
+     *       "black": 3668091,
+     *       "moves": [
+     *         {
+     *           "uci": "c6d5",
+     *           "san": "cxd5",
+     *           "averageRating": 1801,
+     *           "white": 3716043,
+     *           "draws": 370963,
+     *           "black": 3304807,
+     *           "game": null,
+     *           "opening": null
+     *         },
+     *         {
+     *           "uci": "d8d5",
+     *           "san": "Qxd5",
+     *           "averageRating": 1658,
+     *           "white": 195544,
+     *           "draws": 14378,
+     *           "black": 140001,
+     *           "game": null,
+     *           "opening": null
+     *         }
+     *       ],
+     *       "recentGames": [
+     *         {
+     *           "uci": "c6d5",
+     *           "id": "ilsfX0gq",
+     *           "winner": "black",
+     *           "speed": "blitz",
+     *           "mode": "rated",
+     *           "black": {
+     *             "name": "captan64",
+     *             "rating": 2201
+     *           },
+     *           "white": {
+     *             "name": "ElsaPato33",
+     *             "rating": 2324
+     *           },
+     *           "year": 2024,
+     *           "month": "2024-10"
+     *         }
+     *       ],
+     *       "topGames": [
+     *         {
+     *           "uci": "g8f6",
+     *           "id": "EqJcFS1j",
+     *           "winner": "white",
+     *           "speed": "ultraBullet",
+     *           "mode": "rated",
      *           "black": {
-     *             "name": "Carlsen, M.",
-     *             "rating": 2843
+     *             "name": "toivok",
+     *             "rating": 2708
+     *           },
+     *           "white": {
+     *             "name": "penguingim1",
+     *             "rating": 2969
      *           },
      *           "year": 2018,
-     *           "month": "2018-06"
+     *           "month": "2018-04"
      *         }
      *       ],
-     *       "recentGames": [],
      *       "history": [
      *         {
-     *           "month": "2017-04",
-     *           "black": 413538,
-     *           "draws": 38549,
-     *           "white": 429805
+     *           "month": "2013-01",
+     *           "white": 60,
+     *           "draws": 2,
+     *           "black": 54
+     *         },
+     *         {
+     *           "month": "2013-02",
+     *           "white": 71,
+     *           "draws": 8,
+     *           "black": 75
      *         },
      *         {
-     *           "month": "2017-05",
-     *           "black": 418542,
-     *           "draws": 39171,
-     *           "white": 434066
+     *           "month": "2013-03",
+     *           "white": 83,
+     *           "draws": 4,
+     *           "black": 72
      *         }
      *       ]
      *     } */
-    OpeningExplorerJson: unknown;
+    OpeningExplorerLichess: {
+      opening: components["schemas"]["OpeningExplorerOpening"] | null;
+      white: number;
+      draws: number;
+      black: number;
+      moves: {
+        uci: string;
+        san: string;
+        averageRating: number;
+        white: number;
+        draws: number;
+        black: number;
+        game: components["schemas"]["OpeningExplorerLichessGame"] | null;
+        opening: components["schemas"]["OpeningExplorerOpening"] | null;
+      }[];
+      topGames: ({
+        uci: string;
+      } & components["schemas"]["OpeningExplorerLichessGame"])[];
+      recentGames: ({
+        uci: string;
+      } & components["schemas"]["OpeningExplorerLichessGame"])[];
+      history?: {
+        month: string;
+        white: number;
+        draws: number;
+        black: number;
+      }[];
+    };
+    OpeningExplorerPlayerGame: {
+      id: string;
+      /** @enum {string|null} */
+      winner: "white" | "black" | null;
+      speed: components["schemas"]["Speed"];
+      /** @enum {string} */
+      mode: "rated" | "casual";
+      white: components["schemas"]["OpeningExplorerGamePlayer"];
+      black: components["schemas"]["OpeningExplorerGamePlayer"];
+      year: number;
+      month: string;
+    };
     /** @example {
-     *       "white": 359,
+     *       "opening": {
+     *         "eco": "D00",
+     *         "name": "Queen's Pawn Game"
+     *       },
+     *       "queuePosition": 25,
+     *       "white": 366,
      *       "draws": 23,
-     *       "black": 273,
+     *       "black": 279,
      *       "moves": [
      *         {
      *           "uci": "c2c4",
      *           "san": "c4",
      *           "averageOpponentRating": 1695,
      *           "performance": 1744,
-     *           "white": 354,
+     *           "white": 361,
      *           "draws": 23,
-     *           "black": 266,
-     *           "game": null
+     *           "black": 272,
+     *           "game": null,
+     *           "opening": {
+     *             "eco": "D06",
+     *             "name": "Queen's Gambit"
+     *           }
      *         },
      *         {
      *           "uci": "c2c3",
      *           "san": "c3",
-     *           "averageOpponentRating": 1796,
-     *           "performance": 1796,
+     *           "averageOpponentRating": 1797,
+     *           "performance": 1797,
      *           "white": 2,
      *           "draws": 0,
      *           "black": 2,
-     *           "game": null
+     *           "game": null,
+     *           "opening": null
      *         },
      *         {
      *           "uci": "e2e4",
@@ -7355,41 +7731,24 @@ export interface components {
      *           "white": 1,
      *           "draws": 0,
      *           "black": 2,
-     *           "game": null
+     *           "game": null,
+     *           "opening": {
+     *             "eco": "D00",
+     *             "name": "Blackmar-Diemer Gambit"
+     *           }
      *         },
      *         {
      *           "uci": "g1f3",
      *           "san": "Nf3",
-     *           "averageOpponentRating": 1496,
+     *           "averageOpponentRating": 1497,
      *           "performance": 1374,
      *           "white": 1,
      *           "draws": 0,
      *           "black": 2,
-     *           "game": null
-     *         },
-     *         {
-     *           "uci": "h2h3",
-     *           "san": "h3",
-     *           "averageOpponentRating": 1696,
-     *           "performance": 2496,
-     *           "white": 1,
-     *           "draws": 0,
-     *           "black": 0,
-     *           "game": {
-     *             "id": "zyI4GGKv",
-     *             "winner": "white",
-     *             "speed": "bullet",
-     *             "mode": "rated",
-     *             "black": {
-     *               "name": "gocool99",
-     *               "rating": 1696
-     *             },
-     *             "white": {
-     *               "name": "revoof",
-     *               "rating": 1702
-     *             },
-     *             "year": 2020,
-     *             "month": "2020-07"
+     *           "game": null,
+     *           "opening": {
+     *             "eco": "D02",
+     *             "name": "Queen's Pawn Game: Zukertort Variation"
      *           }
      *         },
      *         {
@@ -7415,35 +7774,51 @@ export interface components {
      *             },
      *             "year": 2020,
      *             "month": "2020-06"
-     *           }
+     *           },
+     *           "opening": null
      *         }
      *       ],
      *       "recentGames": [
      *         {
      *           "uci": "c2c4",
-     *           "id": "BGLmUtv7",
+     *           "id": "ycZbWQZO",
      *           "winner": "white",
      *           "speed": "bullet",
      *           "mode": "rated",
      *           "black": {
-     *             "name": "yigithanyiigit",
-     *             "rating": 1227
+     *             "name": "Winavesh",
+     *             "rating": 1700
      *           },
      *           "white": {
      *             "name": "revoof",
-     *             "rating": 1717
+     *             "rating": 1700
      *           },
-     *           "year": 2022,
-     *           "month": "2022-03"
+     *           "year": 2024,
+     *           "month": "2024-11"
      *         }
-     *       ],
-     *       "opening": {
-     *         "eco": "D00",
-     *         "name": "Queen's Pawn Game"
-     *       },
-     *       "queuePosition": 0
+     *       ]
      *     } */
-    OpeningExplorerPlayerJson: unknown;
+    OpeningExplorerPlayer: {
+      opening: components["schemas"]["OpeningExplorerOpening"] | null;
+      queuePosition: number;
+      white: number;
+      draws: number;
+      black: number;
+      moves: {
+        uci: string;
+        san: string;
+        averageOpponentRating: number;
+        performance: number;
+        white: number;
+        draws: number;
+        black: number;
+        game: components["schemas"]["OpeningExplorerPlayerGame"] | null;
+        opening: components["schemas"]["OpeningExplorerOpening"] | null;
+      }[];
+      recentGames: ({
+        uci: string;
+      } & components["schemas"]["OpeningExplorerPlayerGame"])[];
+    };
     /** @example [Event "Wch Blitz"]
      *     [Site "Astana"]
      *     [Date "2012.07.10"]
@@ -7826,6 +8201,35 @@ export interface operations {
       };
     };
   };
+  apiPuzzleNext: {
+    parameters: {
+      query?: {
+        /** @description The theme or opening to filter puzzles with.
+         *
+         *     Available themes are listed in [the lichess source code](https://github.com/ornicar/lila/blob/master/translation/source/puzzleTheme.xml).
+         *      */
+        angle?: string;
+        /** @description The desired puzzle difficulty, relative to the authenticated user puzzle rating, or 1500 if anonymous. */
+        difficulty?: "easiest" | "easier" | "normal" | "harder" | "hardest";
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The requested puzzle. */
+      200: {
+        headers: {
+          "Access-Control-Allow-Origin"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["PuzzleAndGame"];
+        };
+      };
+    };
+  };
   apiPuzzleActivity: {
     parameters: {
       query?: {
@@ -8115,7 +8519,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -8180,7 +8584,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -8259,7 +8663,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -8334,7 +8738,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -9375,7 +9779,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -10169,7 +10573,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -10549,7 +10953,7 @@ export interface operations {
   broadcastsTop: {
     parameters: {
       query?: {
-        /** @description Which page to fetch. Only page 1 has "active" and "upcoming" broadcasts. */
+        /** @description Which page to fetch. Only page 1 has "active" broadcasts. */
         page?: number;
         /**
          * @description Convert the "description" field from markdown to HTML
@@ -10676,7 +11080,7 @@ export interface operations {
       };
     };
   };
-  broadcastLeaderboardGet: {
+  broadcastPlayersGet: {
     parameters: {
       query?: never;
       header?: never;
@@ -10688,13 +11092,13 @@ export interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description The broadcast leaderboard players */
+      /** @description The broadcast players */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["BroadcastLeaderboardEntry"][];
+          "application/json": components["schemas"]["BroadcastPlayerEntry"][];
         };
       };
     };
@@ -13012,7 +13416,7 @@ export interface operations {
          *     Or in an `analysis` JSON field, depending on the response type.
          *      */
         evals?: boolean;
-        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available.
+        /** @description Include [accuracy percent](https://lichess.org/page/accuracy) of each player, when available. Only available in JSON.
          *      */
         accuracy?: boolean;
         /** @description Include the opening name.
@@ -13653,7 +14057,7 @@ export interface operations {
          *     Required to find an opening name, if `fen` is not an exact match
          *     for a named position.
          *
-         * @example e2e4,e7e5,c2c4,c7c6,c4e5
+         * @example d2d4,d7d5,c2c4,c7c6,c4d5
          */
         play?: string;
         /** @description Include only games from this year or later */
@@ -13678,7 +14082,7 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["OpeningExplorerJson"];
+          "application/json": components["schemas"]["OpeningExplorerMasters"];
         };
       };
     };
@@ -13699,7 +14103,7 @@ export interface operations {
          *     Required to find an opening name, if `fen` is not an exact match
          *     for a named position.
          *
-         * @example e2e4,e7e5,c2c4,c7c6,c4e5
+         * @example d2d4,d7d5,c2c4,c7c6,c4d5
          */
         play?: string;
         /** @description Comma separated list of game speeds to filter by */
@@ -13736,19 +14140,24 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["OpeningExplorerJson"];
+          "application/json": components["schemas"]["OpeningExplorerLichess"];
         };
       };
     };
   };
   openingExplorerPlayer: {
     parameters: {
-      query?: {
+      query: {
         /**
          * @description Username or ID of the player
          * @example revoof
          */
-        player?: string;
+        player: string;
+        /**
+         * @description Look for games with *player* on the given side
+         * @example white
+         */
+        color: "white" | "black";
         /** @description Variant */
         variant?: components["schemas"]["VariantKey"];
         /**
@@ -13791,7 +14200,7 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/nd-json": components["schemas"]["OpeningExplorerPlayerJson"];
+          "application/nd-json": components["schemas"]["OpeningExplorerPlayer"];
         };
       };
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lichess-org/types",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Lichess.org API types",
   "homepage": "https://github.com/lichess-org/api",
   "license": "AGPL-3.0-or-later",
@@ -11,9 +11,9 @@
     "gen": "openapi-typescript  ../doc/specs/lichess-api.yaml -o lichess-api.d.ts --default-non-nullable=false"
   },
   "devDependencies": {
-    "openapi-typescript": "^7.4.1",
-    "prettier": "^3.3.3",
-    "typescript": "^5.6.2"
+    "openapi-typescript": "^7.4.4",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2"
   },
-  "packageManager": "pnpm@9.12.0+sha512.4abf725084d7bcbafbd728bfc7bee61f2f791f977fd87542b3579dcb23504d170d46337945e4c66485cd12d588a0c0e570ed9c477e7ccdd8507cf05f3f92eaca"
+  "packageManager": "pnpm@9.14.2+sha512.6e2baf77d06b9362294152c851c4f278ede37ab1eba3a55fda317a4a17b209f4dbb973fb250a77abc463a341fcb1f17f17cfa24091c4eb319cda0d9b84278387"
 }