vimp-engine 0.34.8 → 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/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/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,
   });
 
   // конфиг загрузки задан — дальше работает обычный клиент движка в