vimp-engine 0.34.7 → 0.35.0

package/src/client/style.css

@@ -1156,6 +1156,109 @@ body.hide-cursor {
   color: #d66;
 }
 
+/* журнал клиентских ошибок (plan/client-reports, этап 5): тот же каркас и
+   палитра, что у панели реестра игр; графы — .games-filters/.games-filter-btn */
+#reports-panel {
+  background-color: #222;
+  position: absolute;
+  width: 100%;
+  min-height: 100%;
+  top: 0;
+  left: 0;
+  z-index: 8;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  box-sizing: border-box;
+}
+
+.reports-card {
+  width: 900px;
+  padding: 10px;
+  text-align: left;
+}
+
+.reports-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 900px;
+  padding: 0 10px;
+  box-sizing: border-box;
+}
+
+.reports-toolbar {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+}
+
+.reports-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.reports-item {
+  border-bottom: 1px solid #444;
+  padding: 8px;
+}
+
+.reports-summary {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 12px;
+  cursor: pointer;
+}
+
+.reports-count,
+.reports-message {
+  font-weight: bold;
+}
+
+.reports-message {
+  flex-basis: 100%;
+  word-break: break-word;
+}
+
+.reports-when,
+.reports-kind {
+  color: #888;
+}
+
+.reports-status-open {
+  color: #d66;
+}
+
+.reports-details {
+  margin-top: 8px;
+}
+
+.reports-full-message {
+  word-break: break-word;
+}
+
+/* стек и details: моноширинно, длинные строки прокручиваются по
+   горизонтали, высокий стек — по вертикали */
+.reports-pre {
+  font-family: monospace;
+  font-size: 12px;
+  white-space: pre;
+  overflow: auto;
+  max-height: 300px;
+  margin: 8px 0;
+  padding: 8px;
+  border: 1px solid #444;
+}
+
+.reports-note-input {
+  width: 260px;
+  text-align: left;
+  margin-right: 8px;
+}
+
 /* кнопки входа в панель стоят рядом с Sign out в бейдже пользователя */
 .lobby-user-actions {
   display: flex;
@@ -1166,7 +1269,9 @@ body.hide-cursor {
 @media (max-width: 900px) {
   #games-mine,
   #games-moderation,
-  .games-head {
+  .games-head,
+  .reports-card,
+  .reports-head {
     width: 100%;
   }
 }

package/src/client/views/includes/lobby.pug

@@ -20,6 +20,8 @@ div#lobby(style='display:none')
           div.lobby-user-actions
             input#games-open-mine(type='button', value='My games')
             input#games-open-moderation(type='button', value='Moderation', style='display:none')
+            //- журнал клиентских ошибок (plan/client-reports, этап 5): только админ
+            input#reports-open(type='button', value='Errors', style='display:none')
             input#lobby-user-logout(type='button', value='Sign out')
         hr.lobby-divider
         h3.lobby-section-title= 'HOST A GAME'

package/src/client/views/includes/reports.pug

@@ -0,0 +1,18 @@
+//- Журнал клиентских ошибок (plan/client-reports, этап 5): только админ.
+//- Панель скрыта по умолчанию — открывается кнопкой «Errors» бейджа
+//- пользователя (#lobby-user в lobby.pug); id элементов перечислены в
+//- config/lobby.js. Подписи — по-английски, как и остальное лобби
+div#reports-panel(style='display:none')
+  div.lobby-column
+    div.reports-head
+      h3.lobby-section-title= 'Client errors'
+      input#reports-close(type='button', value='Back to lobby')
+
+    div.card.reports-card
+      div.reports-toolbar
+        div#reports-filters.games-filters
+        select#reports-game.field-select
+          option(value='')= 'All games'
+      ul#reports-list.reports-list
+      div#reports-error.form-error
+      input#reports-more(type='button', value='Load more', style='display:none')

package/src/client/views/index.pug

@@ -5,5 +5,6 @@ include includes/stat
 include includes/lobbyAuth
 include includes/lobby
 include includes/games
+include includes/reports
 include includes/auth
 include includes/informer

package/src/config/clientServices.js

@@ -19,6 +19,8 @@ export const clientServices = createRegistry('clientServices', [
   { value: 'localPlayer', since: 3 },
   // места в глобальном топе (lib/accolades.js)
   { value: 'accolades', since: 4 },
+  // журнал клиентских ошибок (lib/diagnostics.js): warn/capture партов
+  { value: 'diagnostics', since: 4 },
 ]);
 
 // плоский список имён — то, чем правило C4 проверяет componentDependencies

package/src/config/env.js

@@ -31,6 +31,12 @@ export function applyMasterEnv(config, env = process.env) {
   if (env.VIMP_GAMES_DIR) {
     config.set('master:gameStore:dir', env.VIMP_GAMES_DIR);
   }
+
+  // общий секрет бокса и auth-сервиса для пересылки журнала клиентских
+  // ошибок (plan/client-reports)
+  if (env.VIMP_CLIENT_REPORTS_TOKEN) {
+    config.set('master:clientReports:token', env.VIMP_CLIENT_REPORTS_TOKEN);
+  }
 }
 
 /**

package/src/config/lobby.js

@@ -145,6 +145,10 @@ export default {
   // маршрут поднимается мастером только в dev, в проде вернёт 404
   debugReportUrl: '/debug/report',
 
+  // журнал клиентских ошибок (plan/client-reports): приём на том же боксе,
+  // что раздал страницу, — лобби-мастер или dedicated
+  clientReportUrl: '/client-reports',
+
   // размер страницы для «Загрузить ещё» (offset/limit к мастеру)
   pageSize: 10,
 
@@ -284,6 +288,41 @@ export default {
     },
   },
 
+  // журнал клиентских ошибок (plan/client-reports, этап 5): только админ.
+  // URL и id элементов — здесь, как у панели реестра игр (reports.pug)
+  clientReports: {
+    urls: {
+      // страница журнала: ?status&gameId&limit&offset
+      list: '/admin/client-reports',
+      // статус и заметка админа по строке
+      setStatus: id => `/admin/client-reports/${encodeURIComponent(id)}`,
+    },
+    pageSize: 50,
+    // графы: значения совпадают со статусами auth-сервиса, 'all' — без фильтра
+    statuses: [
+      { id: 'open', title: 'Open' },
+      { id: 'fixed', title: 'Fixed' },
+      { id: 'ignored', title: 'Ignored' },
+      { id: 'all', title: 'All' },
+    ],
+    defaultStatus: 'open',
+
+    // DOM-элементы панели (из reports.pug)
+    elems: {
+      panelId: 'reports-panel',
+      // панель и лобби делят место, как у панели реестра игр
+      lobbyId: 'lobby',
+      // кнопка в бейдже пользователя (lobby.pug), видна только админу
+      openBtnId: 'reports-open',
+      closeBtnId: 'reports-close',
+      filtersId: 'reports-filters',
+      gameSelectId: 'reports-game',
+      listId: 'reports-list',
+      moreBtnId: 'reports-more',
+      errorId: 'reports-error',
+    },
+  },
+
   // создание комнаты (хост в этой же вкладке); лимит игроков/время
   // раунда-карты/огонь по своим/карта по умолчанию — из roomDefaults
   // манифеста активной игры (Этап 6.3), не бандлятся здесь

package/src/config/master.js

@@ -160,6 +160,26 @@ export default {
     referrerPolicy: 'no-referrer',
   },
 
+  // журнал клиентских ошибок (plan/client-reports): приём POST
+  // /client-reports на боксе и пересылка пачками в auth-сервис. Пустой
+  // token — пересылка выключена, остаётся строка в журнале процесса
+  clientReports: {
+    token: '',
+    flushIntervalMs: 30000,
+    forwardBatch: 50,
+    forwardTimeoutMs: 5000,
+    maxPending: 500, // потолок разных отпечатков в буфере
+    logSeenMax: 5000, // сколько отпечатков процесс помнит «уже печатал»
+    // бюджет НОВЫХ отпечатков на бокс (решение 9 плана): распределённый спам
+    // обходит лимит по IP, а новая строка в auth — главный ресурс. Повторы
+    // известных отпечатков бюджет не тратят
+    newFingerprintsPerMinute: 60,
+    // ключ — адрес, для IPv6 — подсеть /64 (lib/clientIp.js → rateLimitKey)
+    rateLimit: { limit: 10, windowMs: 60000 },
+    bodyLimit: '16kb',
+    maxItemsPerRequest: 10,
+  },
+
   // заголовок с регионом хоста от Nginx/CDN (например, CF-IPCountry);
   // выбран вместо geoip-lite — бесплатнее по памяти
   regionHeader: 'x-region',

package/src/host/HostGame.js

@@ -258,6 +258,9 @@ export default class HostGame {
     this._handoffRestored = false;
     this._handoffMapTimeLeft = null;
 
+    // матч закрывается (destroy): снятие участников исход раунда не решает
+    this._isDestroying = false;
+
     // внедрение зависимостей (ядро отдаёт панель/фасад события через адаптер)
     this._socketManager.injectServices(this._game, this._panel, this._stat);
     this._game.injectServices({ vimp: this, panel: this._panel });
@@ -679,6 +682,7 @@ export default class HostGame {
    * @returns {Promise} Завершение финальной синхронизации профилей.
    */
   async destroy() {
+    this._isDestroying = true;
     this._timerManager.stopGameTimers();
     this._timerManager.stopIdleCheckTimer();
     this._timerManager.stopAllVoteTimers();
@@ -884,6 +888,7 @@ export default class HostGame {
 
     if (team) {
       this._scripted.removeOneForHuman(team);
+      this._roundManager.checkRoundOutcome();
     }
   }
 
@@ -960,6 +965,13 @@ export default class HostGame {
     this._participants.remove(gameId);
 
     this._chat.pushSystem('USER_LEFT', [user.name]);
+
+    // ушёл последний живой команды, пока раунд ждал одной выжившей. При
+    // закрытии матча исход не решается: таймеры уже сняты, и завершение
+    // раунда взвело бы новый и повторило бы finishAllGames/flushAll
+    if (!this._isDestroying) {
+      this._roundManager.checkRoundOutcome();
+    }
   }
 
   // обновляет команды (формат wire: 'seq:action:name', указатель —

package/src/host/host.worker.js

@@ -151,6 +151,20 @@ function onDebug({ requestId, action }) {
   self.postMessage({ type: 'debug_result', requestId, result, error });
 }
 
+// журнал клиентских ошибок (plan/client-reports): необработанный reject в
+// Worker не всплывает в worker.onerror главного потока — пересылаем сами.
+// Отдельный тип сообщения: 'error' занят сбоем init и запускает откат эстафеты
+self.addEventListener('unhandledrejection', event => {
+  const reason = event.reason;
+
+  self.postMessage({
+    type: 'diagnostic',
+    kind: 'rejection',
+    message: reason && reason.message ? reason.message : String(reason),
+    stack: reason && typeof reason.stack === 'string' ? reason.stack : null,
+  });
+});
+
 self.onmessage = async event => {
   const msg = event.data;
 

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

@@ -75,6 +75,9 @@ class RoundManager {
     this._scaledMapData = null;
     this._startMapNumber = 0;
     this._isRoundEnding = false;
+    // команды, чей вайп уже записан в этом раунде: при 3+ командах раунд
+    // идёт дальше, и второй раз `deaths` той же команде не пишется
+    this._wipedTeamIds = new Set();
     this._removedPlayersList = []; // gameId игроков для удаления с полотна
 
     // эстафета Worker'ов (Этап 5.2): колбэк переноса на границе раунда
@@ -148,6 +151,7 @@ class RoundManager {
 
     this._participants.clearActive();
     this._removedPlayersList = [];
+    this._wipedTeamIds.clear();
 
     this._panel.reset();
     this._stat.reset();
@@ -264,6 +268,7 @@ class RoundManager {
   // запуск нового раунда
   initiateNewRound() {
     this._timerManager.stopRoundTimer();
+    this._wipedTeamIds.clear();
 
     // граница раунда достигнута — отдать состояние эстафете; новый раунд
     // стартует уже новый Worker после переноса
@@ -455,6 +460,14 @@ class RoundManager {
 
   // меняет команду игрока
   changeTeam(gameId, newTeam) {
+    this._applyTeamChange(gameId, newTeam);
+
+    // уход в наблюдатели или в другую команду может оставить живых только в
+    // одной команде — раунд, ждавший этого после вайпа, завершается здесь
+    this.checkRoundOutcome();
+  }
+
+  _applyTeamChange(gameId, newTeam) {
     const user = this._participants.get(gameId);
     const currentTeam = user.team;
     const respawns = this._scaledMapData.respawns;
@@ -638,7 +651,7 @@ class RoundManager {
       // убийца мог покинуть игру до попадания (например, взрыв его бомбы) —
       // фраг не начисляется, но раунд обязан корректно завершиться
       if (!killerUser) {
-        this._checkTeamWipe(victimUser.teamId, null);
+        this._checkTeamWipe(victimUser.teamId);
         return;
       }
 
@@ -669,54 +682,108 @@ class RoundManager {
       this._chat.pushSystem('REPORT_KILL', [killerUser.name, victimUser.name]);
 
       // проверка на уничтожение всей команды противника
-      this._checkTeamWipe(victimUser.teamId, killerUser.teamId);
+      this._checkTeamWipe(victimUser.teamId);
     }
   }
 
-  // проверяет уничтожение всей команды
-  _checkTeamWipe(victimTeamId, killerTeamId) {
-    // под endlessRound раунд не заканчивается вообще: вычищенная команда —
-    // не повод для результата и отложенного перезапуска
-    if (this._endlessRound) {
+  // проверяет уничтожение всей команды. Победитель — команда, у которой
+  // остались живые, а не команда последнего убийцы: суицид, огонь по своим
+  // или ушедший убийца иначе объявляли бы GAME OVER живой команде
+  _checkTeamWipe(victimTeamId) {
+    if (!this._canResolveRound() || victimTeamId === this._spectatorId) {
       return;
     }
 
-    // если раунд уже в процессе завершения
-    if (this._isRoundEnding) {
+    const aliveTeamIds = this._getAliveTeamIds(victimTeamId);
+
+    // в команде жертвы есть живой — команда не уничтожена
+    if (!aliveTeamIds) {
       return;
     }
 
-    let winnerTeam = null;
+    // запись поражения команде (один раз за раунд)
+    if (!this._wipedTeamIds.has(victimTeamId)) {
+      this._wipedTeamIds.add(victimTeamId);
+      this._stat.updateHead(victimTeamId, 'deaths', 1);
+    }
+
+    this._resolveRound(aliveTeamIds);
+  }
 
-    // если команда наблюдателей, проверка не требуется
-    if (victimTeamId === this._spectatorId) {
+  // перепроверяет исход раунда без смерти (уход игрока, смена команды):
+  // нужна только раунду, в котором вайп уже был, но живые оставались больше
+  // чем в одной команде. Без вайпа уход игрока раунд не завершает
+  checkRoundOutcome() {
+    if (!this._canResolveRound() || this._wipedTeamIds.size === 0) {
       return;
     }
 
-    // проверка на живых участников в команде (люди и scripted)
+    this._resolveRound(this._getAliveTeamIds());
+  }
+
+  _canResolveRound() {
+    // под endlessRound раунд не заканчивается вообще: вычищенная команда —
+    // не повод для результата и отложенного перезапуска. Раунд, который уже
+    // завершается, второй раз не завершается
+    return !this._endlessRound && !this._isRoundEnding;
+  }
+
+  // id команд с живыми участниками (люди и scripted). null — если живой
+  // нашёлся в `victimTeamId`: остальных опрашивать незачем. Наблюдатели
+  // отсеиваются до вызова в ядро
+  _getAliveTeamIds(victimTeamId = null) {
+    const aliveTeamIds = new Set();
+
     for (const participant of this._participants.getAll()) {
-      // если нашелся живой участник, команда не уничтожена
       if (
-        participant.teamId === victimTeamId &&
-        this._game.isAlive(participant.gameId)
+        participant.teamId === this._spectatorId ||
+        !this._game.isAlive(participant.gameId)
       ) {
-        return;
+        continue;
       }
+
+      if (participant.teamId === victimTeamId) {
+        return null;
+      }
+
+      aliveTeamIds.add(participant.teamId);
+    }
+
+    return aliveTeamIds;
+  }
+
+  // завершает раунд, если живые остались не больше чем в одной команде:
+  // она побеждает, нет выживших — ничья
+  _resolveRound(aliveTeamIds) {
+    // при 3+ командах раунд идёт, пока живые есть больше чем в одной
+    if (aliveTeamIds.size > 1) {
+      return;
     }
 
     // активация флага завершения раунда
     this._isRoundEnding = true;
 
-    // запись поражения команде
-    this._stat.updateHead(victimTeamId, 'deaths', 1);
-
-    // если убийца из другой команды, фраг для команды-победителя
-    if (killerTeamId && killerTeamId !== victimTeamId) {
-      this._stat.updateHead(killerTeamId, 'score', 1);
+    const [winnerTeamId] = aliveTeamIds;
+    const winnerTeam = Object.keys(this._teams).find(
+      key => this._teams[key] === winnerTeamId,
+    );
 
-      winnerTeam = Object.keys(this._teams).find(
-        key => this._teams[key] === killerTeamId,
-      );
+    // счёт и объявление решает одно условие: команда вне `teams` не может
+    // получить очко, которого клиенты не увидят
+    if (winnerTeam) {
+      this._stat.updateHead(winnerTeamId, 'score', 1);
+    } else {
+      // ничья: последние игроки нескольких команд погибли в одном тике, а
+      // смерти после первой приходят уже в завершающийся раунд — поражение
+      // пишется всем вымершим командам сразу
+      for (const participant of this._participants.getAll()) {
+        const teamId = participant.teamId;
+
+        if (teamId !== this._spectatorId && !this._wipedTeamIds.has(teamId)) {
+          this._wipedTeamIds.add(teamId);
+          this._stat.updateHead(teamId, 'deaths', 1);
+        }
+      }
     }
 
     // синхронизация накопленных профилей на мастер по итогам раунда
@@ -725,26 +792,25 @@ class RoundManager {
     this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
-    if (winnerTeam) {
-      this._participants.getHumans().forEach(user => {
-        const socketId = user.socketId;
-
-        if (user.teamId === victimTeamId) {
-          this._socketManager.sendSoundCue(socketId, 'defeat');
-        } else {
-          this._socketManager.sendSoundCue(socketId, 'victory');
-        }
+    this._participants.getHumans().forEach(user => {
+      const socketId = user.socketId;
+      // наблюдатель не проигрывает: ему victory при любом исходе, ничья
+      // включительно
+      const isWinner =
+        user.teamId === this._spectatorId ||
+        (winnerTeam && user.teamId === winnerTeamId);
+
+      this._socketManager.sendSoundCue(
+        socketId,
+        isWinner ? 'victory' : 'defeat',
+      );
 
+      if (winnerTeam) {
         this._socketManager.sendRoundEnd(socketId, winnerTeam);
-      });
-    } else {
-      this._participants.getHumans().forEach(user => {
-        const socketId = user.socketId;
-
-        this._socketManager.sendSoundCue(socketId, 'defeat');
+      } else {
         this._socketManager.sendRoundEnd(socketId);
-      });
-    }
+      }
+    });
 
     this._timerManager.stopRoundTimer();
     this._timerManager.startRoundRestartDelay(); // отложенный перезапуск раунда

package/src/lib/capabilities.js

@@ -43,6 +43,9 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // `SimCtx::map_body_state`) и доступ игры к телам карты по индексу
   // (хэндл, индекс по хэндлу, отключение тела)
   { value: 'map.bodyState', since: '0.34.0' },
+  // сервис пула `diagnostics` (журнал клиентских ошибок, plan/client-reports);
+  // опционален — игра не пишет его в `requires`
+  { value: 'diagnostics', since: '0.35.0' },
 ]);
 
 // плоский список имён — то, чем правило контракта B2 проверяет `requires`

package/src/lib/clientIp.js

@@ -37,3 +37,53 @@ export function clientIp(req, { trustProxy = false } = {}) {
 
   return String(header || req.socket?.remoteAddress || '').trim();
 }
+
+// Ключ rate-limit'а по адресу: IPv4 — сам адрес, IPv6 — подсеть /64.
+// Провайдер выдаёт абоненту /64 целиком, то есть у одного человека
+// 2^64 адресов, и лимит «на адрес» для IPv6 не лимит вовсе
+export function rateLimitKey(ip) {
+  const addr = String(ip ?? '').trim();
+
+  if (!addr) {
+    return '';
+  }
+
+  const mapped = /^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/i.exec(addr);
+
+  if (mapped) {
+    return mapped[1];
+  }
+
+  if (!addr.includes(':')) {
+    return addr;
+  }
+
+  const groups = expandIpv6(addr.split('%')[0]);
+
+  if (!groups) {
+    return addr;
+  }
+
+  return `v6:${groups.slice(0, 4).map(g => parseInt(g, 16).toString(16)).join(':')}::/64`;
+}
+
+// '2001:db8::1' → 8 hex-групп или null, если запись непарсима
+function expandIpv6(addr) {
+  const halves = addr.split('::');
+
+  if (halves.length > 2) {
+    return null;
+  }
+
+  const head = halves[0] ? halves[0].split(':') : [];
+  const tail = halves.length === 2 && halves[1] ? halves[1].split(':') : [];
+  const missing = 8 - head.length - tail.length;
+
+  if (halves.length === 1 ? missing !== 0 : missing < 1) {
+    return null;
+  }
+
+  const groups = [...head, ...Array(halves.length === 2 ? missing : 0).fill('0'), ...tail];
+
+  return groups.every(g => /^[0-9a-f]{1,4}$/i.test(g)) ? groups : null;
+}

package/src/standalone/index.js

@@ -43,6 +43,9 @@ import { ensureGameShell } from '../client/views/gameShell.js';
  *   плагина.
  * @param {boolean} [options.devMode] - room.isDevMode: рекордер и хостовый
  *   CONSOLE-лог.
+ * @param {string|null} [options.reportUrl] - Адрес приёма журнала клиентских
+ *   ошибок (`POST`, формат — docs/en/client.md, «Error reporting»). По
+ *   умолчанию `null`: в solo нет бокса, и отчёты не отправляются.
  * @returns {Promise<Object>} `{ stop() }` — останов матча.
  */
 export async function startStandaloneGame({
@@ -59,6 +62,7 @@ export async function startStandaloneGame({
   room = {},
   requires,
   devMode = false,
+  reportUrl = null,
 } = {}) {
   requireOption(hostPlugin, 'hostPlugin');
   requireOption(clientPlugin, 'clientPlugin');
@@ -102,6 +106,7 @@ export async function startStandaloneGame({
       : null,
     startupVotes,
     startupCommands,
+    reportUrl,
   });
 
   // конфиг загрузки задан — дальше работает обычный клиент движка в