vimp-engine 0.20.0 → 0.21.0

package/src/devtools/contract/rules/c6-stat-columns.js

@@ -67,6 +67,19 @@ function styledColumns(styles, total) {
   return covered;
 }
 
+// Режим 'leaderboard' (snakes-v3 этап 4): движок даёт списку только
+// каркас, внешний вид — дело игры. Достаточно любого правила плагина про
+// `.stat-leaderboard` — раскладка колонок там на контейнере, а не на ячейках
+function styledLeaderboard(styles) {
+  for (const [, selector] of String(styles || '').matchAll(RULE)) {
+    if (selector.includes('.stat-leaderboard')) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
 export default {
   id: 'C6',
   name: 'statColumns',
@@ -74,12 +87,27 @@ export default {
   title: 'stat columns past the engine layout are styled by the plugin',
 
   check(ctx) {
-    const columns = ctx.clientConfig?.modules?.stat?.params?.columns;
+    const params = ctx.clientConfig?.modules?.stat?.params;
+    const columns = params?.columns;
 
     if (!columns) {
       return skip('no client stat columns');
     }
 
+    // snakes-v3 этап 4: в режиме 'leaderboard' движковых таблиц нет вовсе —
+    // рисуется один список `.stat-leaderboard`, и число колонок движковой
+    // раскладке ничего не говорит. Проверять здесь надо другое: привезла
+    // ли игра свои стили под этот список
+    if (params.mode === 'leaderboard') {
+      return styledLeaderboard(ctx.clientPlugin?.styles)
+        ? verdict([], 'leaderboard list, laid out by the plugin\'s own styles')
+        : verdict([
+            "stat declares mode 'leaderboard', but ClientPlugin.styles says " +
+              'nothing about #stat .stat-leaderboard: the engine CSS gives ' +
+              'the list only a bare three-column skeleton',
+          ]);
+    }
+
     // меньше пяти — движковых ширин просто хватает с запасом
     if (columns.length <= ENGINE_COLUMNS) {
       return verdict([]);

package/src/devtools/contract/rules/index.js

@@ -25,6 +25,7 @@ import c7 from './c7-key-sets.js';
 import c8 from './c8-baked-assets.js';
 import c9 from './c9-chat-messages.js';
 import c10 from './c10-auth-schema.js';
+import c11 from './c11-stat-mode.js';
 import d1 from './d1-snapshot-ids.js';
 import d2 from './d2-snapshot-classes.js';
 import d3 from './d3-snapshot-interp.js';
@@ -37,7 +38,7 @@ import e3 from './e3-sound-registry.js';
 export const rules = [
   a1, a2, a3, a4, a5, a6, a7,
   b1, b2, b3, b4, b5, b6, b7, b8, b9, b10,
-  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10,
+  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10, c11,
   d1, d2, d3,
   e1, e2, e3,
 ];

package/src/host/HostGame.js

@@ -1,4 +1,5 @@
 import Panel from './meta/modules/Panel.js';
+import Accolades from './meta/modules/Accolades.js';
 import PlayerDataSync from './meta/modules/PlayerDataSync.js';
 import Stat from './meta/modules/Stat.js';
 import Chat from './meta/modules/chat/index.js';
@@ -117,6 +118,10 @@ export default class HostGame {
     // endlessRound — раунд не перезапускается сам. Флаги независимы
     this._noSpectators = data.noSpectators === true;
     this._endlessRound = data.endlessRound === true;
+    // statMode — чем игра занимает экран по Tab. 'leaderboard' значит, что
+    // клиент рисует глобальный топ, который тянет сам: движковый stat в
+    // этом режиме никто не рисует, и платить за его рассылку незачем
+    this._statLeaderboard = data.statMode === 'leaderboard';
     this._spectatorTeam = this._noSpectators ? null : data.spectatorTeam;
     this._spectatorId = this._noSpectators
       ? null
@@ -146,6 +151,18 @@ export default class HostGame {
       // мастера) — подменяется только там, в проде остаётся глобальный fetch
       ...(playerDataFetch ? { fetchImpl: playerDataFetch } : {}),
     });
+    // места участников в глобальном топе (snakes-v3 этап 4): косметика для
+    // parts игры, движок не знает, какой знак игра нарисует за место
+    this._accolades = new Accolades({
+      participants: this._participants,
+      gameId: this._gameId,
+      // место и очки самого участника: их привозит PlayerDataSync на входе,
+      // и без них игрок вне топа-10 не увидел бы по Tab собственной строки
+      getRating: (id, period) => this._playerDataSync.getRating(id, period),
+      // headless-прогону некуда ходить за топом — тот же подмен, что и у
+      // PlayerDataSync
+      ...(playerDataFetch ? { fetchImpl: playerDataFetch } : {}),
+    });
     this._chat = new Chat();
     this._vote = new Vote();
 
@@ -344,9 +361,20 @@ export default class HostGame {
       removedPlayersList.pop();
     }
 
+    // фоновый опрос глобального топа: сам решает, пора ли (refreshInterval)
+    this._accolades.tick();
+
     const userList = this._participants.getNetworkedReady();
     const panelUpdates = this._panel.processUpdates();
-    const stat = this._stat.getLast();
+    // getLast() — ЕДИНСТВЕННЫЙ дренаж Stat: reset() в _lastBody только
+    // дописывает. Поэтому буфер осушается всегда, даже когда рассылки не
+    // будет: пропуск вызова в режиме leaderboard растил бы эти массивы всё
+    // время жизни комнаты (endlessRound — она живёт часами), а StatBridge
+    // пишет в них на каждый подобранный кристалл. Гейтится ОТПРАВКА
+    const lastStat = this._stat.getLast();
+    // в режиме leaderboard движковый stat не рисуется вовсе — не шлём
+    const stat = this._statLeaderboard ? null : lastStat;
+    const accolades = this._accolades.shift();
     const chat = this._chat.shift();
     const vote = this._vote.shift();
 
@@ -421,6 +449,10 @@ export default class HostGame {
         this._socketManager.sendStat(socketId, stat);
       }
 
+      if (accolades) {
+        this._socketManager.sendAccolades(socketId, accolades);
+      }
+
       const chatUser = chat || this._chat.shiftByUser(gameId);
       if (chatUser) {
         this._socketManager.sendChat(socketId, chatUser);
@@ -510,6 +542,20 @@ export default class HostGame {
     user.isReady = true;
     this._socketManager.sendTechInform(socketId);
     this._socketManager.sendFirstVote(socketId);
+
+    // топ и места в нём — целиком и лично, как и первый кадр stat.
+    // Периодическая рассылка (shift() в игровом цикле) уходит только тем,
+    // кто УЖЕ готов, а места новичка посчитаны на его входе, за всю загрузку
+    // карты до этой строки: та рассылка ушла бы без него и не повторилась
+    // бы — места с тех пор не менялись, — и ни знак, ни таблица по Tab не
+    // появились бы до первого чужого входа. В комнате, куда больше никто не
+    // заходит, никогда
+    const accoladesNow = this._accolades.current();
+
+    if (Object.keys(accoladesNow.places).length) {
+      this._socketManager.sendAccolades(socketId, accoladesNow);
+    }
+
     this._chat.pushSystem('USER_JOINED', [user.name]);
 
     // noSpectators: голосования за вход нет — участник уже в играющей
@@ -643,7 +689,11 @@ export default class HostGame {
     // иначе removeUser стартует второй flush с той же накопленной дельтой
     // (двойной зачёт рейтинга), а destroy разрешился бы раньше, чем эти
     // запросы уйдут
-    await this._playerDataSync.flushAll();
+    // незакрытые игры участников закрываются здесь: их очки иначе не
+    // попали бы ни в сумму, ни в максимум и пропали бы вместе с комнатой
+    // (правило 7 snakes-v3 этап 3 — запись гарантирована в destroy())
+    this._playerDataSync.finishAllGames();
+    await this._playerDataSync.flushAll({ urgent: true });
 
     // getAll() отдаёт копию — снятие внутри цикла реестр не ломает
     for (const user of this._participants.getAll()) {
@@ -863,6 +913,11 @@ export default class HostGame {
     // вход; сбой auth-сервиса оставляет участника с дефолтами
     this._playerDataSync.load(gameId, params.token);
 
+    // место новичка в глобальном топе: знак должен появиться сразу, а не
+    // на следующем периодическом опросе. Это пересчёт по уже известным
+    // срезам, а не поход за ними — за топом ходит только tick()
+    this._accolades.noteRoster();
+
     queueMicrotask(() => {
       cb(gameId);
     });
@@ -886,9 +941,12 @@ export default class HostGame {
     this._vote.removeUser(gameId);
     this._panel.removeUser(gameId);
 
-    // финальная синхронизация rank/state перед уходом участника (Этап B4)
+    // финальная синхронизация профиля перед уходом участника (Этап B4):
+    // незавершённая игра закрывается — второго шанса записать её очки не
+    // будет, — и интервал синхронизации эта граница обходит (urgent)
+    this._playerDataSync.finishGame(gameId);
     this._playerDataSync
-      .flush(gameId)
+      .flush(gameId, { urgent: true })
       .catch(err =>
         console.warn('[playerData] final flush failed:', err.message),
       )
@@ -1058,11 +1116,44 @@ export default class HostGame {
 
   // прибавка к рангу для игр, которые не эмитят CoreEvent::Death и потому
   // никогда не проходят через RoundManager.reportKill: прямая прокладка к
-  // PlayerDataSync, без раунд-логики и без проверки team-wipe
+  // PlayerDataSync, без раунд-логики и без проверки team-wipe.
+  // @deprecated snakes-v3: алиас addPlayerPoints
   addPlayerRank(gameId, delta) {
     this._playerDataSync.addRank(gameId, delta);
   }
 
+  // ***** результат игры (snakes-v3 этап 3) ***** //
+
+  // очки ТЕКУЩЕЙ игры участника: жизнь, раунд, матч — что игра называет
+  // игрой. В рейтинги они попадают только на finishPlayerGame
+  addPlayerPoints(gameId, delta) {
+    this._playerDataSync.addPoints(gameId, delta);
+  }
+
+  // игра участника закончилась: накопленные очки уходят в сумму (месячный
+  // рейтинг) и в максимум (дневной). Игра без раундов зовёт это сама — у
+  // игры с раундами обе границы закрывает RoundManager
+  finishPlayerGame(gameId) {
+    this._playerDataSync.finishGame(gameId);
+  }
+
+  // значения среза для показа: { value, placement, total } или null
+  getPlayerRating(gameId, period) {
+    return this._playerDataSync.getRating(gameId, period);
+  }
+
+  // приехал ли СРЕЗ с мастера: ноль незагруженного рейтинга и настоящий
+  // ноль — разные вещи, и игре, которая на них смотрит, надо их различать
+  isPlayerRatingLoaded(gameId, period) {
+    return this._playerDataSync.isRatingLoaded(gameId, period);
+  }
+
+  // точечный перезапрос места в срезе (чат-команда /rank): место меняют
+  // чужие игры, локально его не пересчитать. Троттлинг — в PlayerDataSync
+  refreshPlayerPlacement(gameId, period) {
+    return this._playerDataSync.refreshPlacement(gameId, period);
+  }
+
   // синхронизация профилей (rank/state) всех участников на мастер прямо
   // сейчас — для игр, у которых нет ни конца раунда, ни смены карты
   // (`endlessRound` + карта, пересобираемая через overrideMapData): обе
@@ -1072,8 +1163,13 @@ export default class HostGame {
   //
   // Best-effort, как и весь PlayerDataSync: промис не отвергается, сбой
   // логируется в `[playerData]` и повторится следующим flush'ем.
-  flushPlayerData() {
-    return this._playerDataSync.flushAll();
+  //
+  // snakes-v3 этап 3: это просьба, а не команда — участник, у которого с
+  // прошлой синхронизации прошло меньше lobbyConfig.playerData.
+  // minFlushInterval, пропускается. Срочные границы (уход участника,
+  // destroy комнаты) интервал обходят, игре они недоступны
+  flushPlayerData({ urgent = false } = {}) {
+    return this._playerDataSync.flushAll({ urgent });
   }
 
   // hostId + per-room секрет комнаты, подтверждённые мастером при

package/src/host/meta/SocketManager.js

@@ -39,6 +39,7 @@ export default class SocketManager {
     this._PORT_CHAT_DATA = ports.CHAT_DATA;
     this._PORT_VOTE_DATA = ports.VOTE_DATA;
     this._PORT_KEYSET_DATA = ports.KEYSET_DATA;
+    this._PORT_ACCOLADES_DATA = ports.ACCOLADES_DATA;
 
     this._soundCues = soundCues;
     this._initialVote = initialVote;
@@ -337,6 +338,16 @@ export default class SocketManager {
     this._send(socketId, this._PORT_STAT_DATA, data);
   }
 
+  /**
+   * Отправка мест участников в глобальном топе (snakes-v3 этап 4). Движок
+   * раздаёт числа, знак за место рисует part игры.
+   * @param {string} socketId
+   * @param {Object} data - { [gameId]: { daily, monthly } }
+   */
+  sendAccolades(socketId, data) {
+    this._send(socketId, this._PORT_ACCOLADES_DATA, data);
+  }
+
   /**
    * Отправка сообщения чата.
    * @param {string} socketId

package/src/host/meta/core/RoundManager.js

@@ -146,8 +146,11 @@ class RoundManager {
     this._stat.reset();
     this._voteCoordinator.reset();
 
-    // синхронизация накопленных rank/state на мастер перед сменой карты
-    // (Этап B4) — естественная граница жизненного цикла
+    // синхронизация накопленных профилей на мастер перед сменой карты
+    // (Этап B4) — естественная граница жизненного цикла. Смена карты
+    // заканчивает игру каждого участника (snakes-v3 этап 3): без этого у
+    // игры с раундами дневной максимум навсегда остался бы нулём
+    this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
     this._snapshotManager.reset();
@@ -696,8 +699,10 @@ class RoundManager {
       );
     }
 
-    // синхронизация накопленных rank/state на мастер по итогам раунда
-    // (Этап B4) — естественная граница жизненного цикла
+    // синхронизация накопленных профилей на мастер по итогам раунда
+    // (Этап B4) — естественная граница жизненного цикла. Конец раунда и
+    // есть конец игры участника (snakes-v3 этап 3)
+    this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
     if (winnerTeam) {

package/src/host/meta/modules/Accolades.js

@@ -0,0 +1,283 @@
+import lobbyConfig from '../../../config/lobby.js';
+import { nickKey } from '../../../lib/validators.js';
+
+// Кто из участников комнаты сейчас в глобальном топ-10 — дневном и
+// месячном (snakes-v3 этап 4). Источник — тот же публичный топ, что рисует
+// лобби, поэтому награда одинакова на любом сервере: она про игрока, а не
+// про комнату. Движок при этом не знает, ЧТО игра нарисует за место, — он
+// раздаёт только числа, а знак рисует part игры.
+//
+// Ник глобально уникален (users.nick в auth) и это единственный ключ, по
+// которому глобальный топ сопоставим с участником комнаты. Боты и гости в
+// топ не попадают никогда — у них нет записи в auth, их место null, и это
+// нормальный, а не аварийный случай.
+//
+// Запросы идут с If-None-Match: топ меняется медленно, совпал валидатор —
+// 304 без тела, схлопнутый TTL-кэшем мастера на всю сеть.
+//
+// ***** ЗА ТОПОМ ХОДИТ КОМНАТА, А НЕ ИГРОК *****
+//
+// Тот же топ рисуется клиенту по Tab (`modules.stat.params.mode:
+// 'leaderboard'`), и рисуется он ИЗ ЭТОЙ РАССЫЛКИ, а не собственным запросом
+// клиента. Так это и должно быть: игрок разговаривает со своим игровым
+// сервером, а не с мастером. Арифметика на целевом масштабе (100 игр × 100
+// серверов × 8 игроков = 80 000 игроков) объясняет, почему это не вкусовщина:
+//
+//   клиент сам      — 80 000 игроков / 15 с троттлинга = 5300 запросов/с,
+//                     причём место игрока (`/auth/placement`) персонально и
+//                     общим кэшем мастера не схлопывается вовсе;
+//   комната за всех — 10 000 комнат × 2 среза / 45 с = 440 запросов/с, и все
+//                     они попадают в один TTL-кэш мастера на (игру, срез),
+//                     то есть в БД доходит 100 игр × 2 среза за TTL.
+//
+// Разница — четыре порядка на самом дорогом запросе схемы.
+export default class Accolades {
+  // fetchImpl обёрнут стрелкой по той же причине, что и в PlayerDataSync:
+  // голый `fetch` из поля объекта вызывался бы с чужим `this` и падал на
+  // brand-check ещё до сети
+  constructor({
+    participants,
+    gameId,
+    // место и очки самого участника в срезе: их привозит PlayerDataSync на
+    // входе игрока (GET /auth/placements). Нужны для строки «я» в списке —
+    // игрок вне топа-10 видит собственное место вместо десятой строки
+    getRating = () => null,
+    fetchImpl = (...args) => fetch(...args),
+    config = lobbyConfig,
+    now = () => Date.now(),
+  }) {
+    this._participants = participants;
+    this._gameId = gameId;
+    this._getRating = getRating;
+    this._fetch = fetchImpl;
+    this._url = config.leaderboardUrl;
+    this._limit = config.leaderboardLimit;
+    this._interval = config.accolades.refreshInterval;
+    this._periods = config.accolades.periods;
+    this._now = now;
+
+    // последний известный топ каждого среза: ключ награды -> Map(ник в
+    // нижнем регистре -> место). 304 оставляет прошлый
+    this._tops = new Map();
+    // и он же строками, как их рисует клиент: ключ СРЕЗА ('day'/'month') ->
+    // [{ place, nick, score }]. Два представления одного ответа: по нику
+    // ищут знаки, по порядку — таблица
+    this._boards = {};
+    // ETag прошлого ответа среза — валидатор следующего запроса
+    this._etags = new Map();
+
+    this._payload = { places: {}, boards: {}, self: {} };
+    // слепок ПУСТОЙ рассылки, а не '{}': иначе первый же _recompute в
+    // пустой комнате считал бы её изменившейся и слал бы пустоту
+    this._serialized = JSON.stringify(this._payload);
+    this._dirty = false;
+
+    // null, а не 0: первый опрос обязан пройти, каким бы ни было начало
+    // отсчёта времени
+    this._lastRefreshAt = null;
+    this._inFlight = false;
+  }
+
+  // периодический опрос: зовётся каждый игровой тик, работает не чаще
+  // refreshInterval. Промис наружу не отдаётся — это фон, а не шаг кадра, —
+  // но именно поэтому он обязан быть пойман здесь: непойманный reject в
+  // игровом цикле воркера кладёт комнату целиком
+  tick() {
+    this.refresh().catch(err =>
+      console.warn('[accolades] tick failed:', err?.message),
+    );
+  }
+
+  // состав комнаты изменился (вход участника): места пересчитываются
+  // ЛОКАЛЬНО — срезы уже лежат в _tops, и ходить за ними ради новичка
+  // незачем. Ходили бы: по два запроса на каждый вход, а при уже летящем
+  // опросе новичок ещё и терялся бы до следующего refreshInterval, потому
+  // что _inFlight глушит вызов целиком
+  noteRoster() {
+    this._recompute();
+  }
+
+  async refresh() {
+    const now = this._now();
+
+    if (this._inFlight) {
+      return;
+    }
+
+    if (this._lastRefreshAt !== null && now - this._lastRefreshAt < this._interval) {
+      return;
+    }
+
+    this._lastRefreshAt = now;
+    this._inFlight = true;
+
+    try {
+      await Promise.all(
+        Object.entries(this._periods).map(([award, period]) =>
+          this._load(award, period),
+        ),
+      );
+      this._recompute();
+    } finally {
+      this._inFlight = false;
+    }
+  }
+
+  // Текущая рассылка целиком — для участника, который ТОЛЬКО ЧТО стал готов
+  // принимать данные. Рассылка через shift() ему не досталась бы: она
+  // уходит только тем, кто уже в getNetworkedReady(), а места новичка
+  // считаются на входе, за всю загрузку карты до его готовности. Один раз
+  // отданный shift() второй раз не повторится (места с тех пор не менялись),
+  // и ни знак, ни таблица не появились бы до первого чужого входа
+  current() {
+    return this._payload;
+  }
+
+  // Рассылка или null, если с прошлого вызова ничего не изменилось. Обычно
+  // именно null — и сообщения не будет вовсе.
+  //
+  //   places — { [gameId]: { daily, monthly } }: место участника в топе-10
+  //            каждого среза или null. По ним part игры рисует знак;
+  //   boards — { day: [{ place, nick, score }], month: [...] }: сам топ, как
+  //            его рисует по Tab режим stat 'leaderboard';
+  //   self   — { [gameId]: { day: { place, score }, month: {...} } }: место и
+  //            очки самого участника, чтобы игрок ВНЕ топа видел свою строку.
+  //
+  // Всё три пересчитываются только в _recompute (опрос раз в refreshInterval
+  // и вход участника), поэтому очки в `self` отстают от только что законченной
+  // игры не больше чем на один интервал опроса. Это осознанно: они меняются с
+  // каждой смертью, и рассылать их сразу значило бы слать сообщение на каждую
+  // смерть каждого из восьми — ровно то, что «не изменилось — не отправляем»
+  // и запрещает. Свой ТЕКУЩИЙ счёт игрок и так видит на HUD
+  shift() {
+    if (!this._dirty) {
+      return null;
+    }
+
+    this._dirty = false;
+
+    return this._payload;
+  }
+
+  async _load(award, period) {
+    const query = new URLSearchParams({
+      game: this._gameId,
+      limit: this._limit,
+      period,
+    });
+    const etag = this._etags.get(award);
+
+    try {
+      const res = await this._fetch(`${this._url}?${query}`, {
+        headers: etag ? { 'if-none-match': etag } : {},
+      });
+
+      // 304 — топ тот же: прошлый срез остаётся как есть
+      if (res.status === 304) {
+        return;
+      }
+
+      if (!res.ok) {
+        console.warn(`[accolades] GET leaderboard ${res.status} (${period})`);
+
+        return;
+      }
+
+      const { leaderboard } = (await res.json()) ?? {};
+      const places = new Map();
+      const rows = [];
+
+      for (const row of leaderboard ?? []) {
+        // уникальность ника в auth регистронезависимая (миграция 002) —
+        // сопоставлять надо так же, иначе «Alice» и «alice» разъедутся
+        if (row?.nick) {
+          places.set(nickKey(row.nick), Number(row.place));
+          rows.push({
+            place: Number(row.place),
+            nick: row.nick,
+            score: Number(row.rank) || 0,
+          });
+        }
+      }
+
+      this._tops.set(award, places);
+      this._boards[period] = rows;
+      this._etags.set(award, res.headers?.get?.('etag') ?? null);
+    } catch (err) {
+      // недоступность мастера — остаёмся на прошлых местах: пропавший на
+      // одну минуту знак хуже, чем чуть устаревший
+      console.warn(`[accolades] refresh failed (${period}):`, err.message);
+    }
+  }
+
+  _recompute() {
+    const places = {};
+    const self = {};
+    // срезы, за которыми ходит хост, в терминах auth ('day'/'month') — по
+    // ним же клиент выбирает таблицу под свой stat.params.period
+    const periods = Object.values(this._periods);
+
+    for (const participant of this._participants.getAll()) {
+      const entry = {};
+      const gameId = String(participant.gameId);
+
+      for (const award of Object.keys(this._periods)) {
+        entry[award] = null;
+      }
+
+      // Знак — только участнику с проверенной личностью. В лобби это ничего
+      // не меняет: там `name` и есть claim проверенного identity-токена
+      // (host/identity.js: createTokenIdentity.resolve возвращает
+      // payload.nick, и PortMachine передаёт в createUser именно его), а не
+      // то, что игрок написал в форме.
+      //
+      // Меняет это в гостевом контуре (standalone/dedicated), где ник —
+      // поле формы и «не защищён от подмены» по прямому признанию
+      // createGuestIdentity. Токена у гостя нет, и сопоставление по нику
+      // выдало бы ему чужую корону — стоит она ровно того, что значит.
+      if (participant.token) {
+        const nick = nickKey(participant.name);
+
+        for (const award of Object.keys(this._periods)) {
+          entry[award] = this._tops.get(award)?.get(nick) ?? null;
+        }
+
+        // место и очки этого участника в каждом срезе: их привёз
+        // PlayerDataSync на входе. Игрок вне топа-10 видит по Tab свою
+        // строку вместо десятой, и взять её больше неоткуда — топ его не
+        // содержит по определению
+        const mine = {};
+
+        for (const period of periods) {
+          const rating = this._getRating(gameId, period);
+
+          if (rating) {
+            mine[period] = {
+              place: rating.placement ?? null,
+              score: rating.value ?? 0,
+            };
+          }
+        }
+
+        if (Object.keys(mine).length) {
+          self[gameId] = mine;
+        }
+      }
+
+      places[gameId] = entry;
+    }
+
+    const payload = { places, boards: this._boards, self };
+    const serialized = JSON.stringify(payload);
+
+    // «не изменилось — не отправляем»: и 304, и неизменившийся состав
+    // комнаты оставляют рассылку пустой
+    if (serialized === this._serialized) {
+      return;
+    }
+
+    this._serialized = serialized;
+    this._payload = payload;
+    this._dirty = true;
+  }
+}