vimp-engine 0.35.6 → 0.37.0

package/src/client/session/hostRoomPrep.js

@@ -0,0 +1,152 @@
+// Подготовка комнаты к Worker'у хоста: room.game по манифесту игры, карты
+// мастера, URL worker-бандла. Общая для создания комнаты, прогрева
+// преемника (host-migration этап 6, HostPrewarm) и эстафеты Worker'ов.
+//
+// Без DOM: активную игру, конфиг и сеть инъектирует сборщик
+// (client/main.js).
+
+/**
+ * @param {Object} deps
+ * @param {Function} deps.getActiveGame - () → манифест активной игры.
+ * @param {Object} deps.config - lobby-конфиг (maps, worker, game).
+ * @param {boolean} deps.isDevBuild
+ * @param {Function} deps.fetchGamePluginManifest - lib/gamePlugin.js.
+ * @param {Function} [deps.fetch]
+ */
+export function createHostRoomPrep({
+  getActiveGame,
+  config,
+  isDevBuild,
+  fetchGamePluginManifest,
+  fetch = (...args) => globalThis.fetch(...args),
+}) {
+  // Этап 5.1/6.4: скачивает каталог карт мастера активной игры (манифест +
+  // все карты)
+  async function fetchMasterMaps(gameManifest = getActiveGame()) {
+    const manifestRes = await fetch(config.maps.manifestUrl(gameManifest));
+
+    if (!manifestRes.ok) {
+      throw new Error(`maps manifest: HTTP ${manifestRes.status}`);
+    }
+
+    const manifest = await manifestRes.json();
+
+    const entries = await Promise.all(
+      manifest.maps.map(async name => {
+        const url = `${config.maps.baseUrl(gameManifest)}/${encodeURIComponent(name)}`;
+        const res = await fetch(url);
+
+        if (!res.ok) {
+          throw new Error(`map ${name}: HTTP ${res.status}`);
+        }
+
+        return [name, await res.json()];
+      }),
+    );
+
+    return { version: manifest.version, maps: Object.fromEntries(entries) };
+  }
+
+  // Этап 5.2: скачивает манифест worker-бандла мастера ({ version, url })
+  async function fetchWorkerManifest() {
+    const res = await fetch(config.worker.manifestUrl);
+
+    if (!res.ok) {
+      throw new Error(`worker manifest: HTTP ${res.status}`);
+    }
+
+    return res.json();
+  }
+
+  // Этап 6.5: перечитывает манифест активной игры мастера — своп не должен
+  // нести новому Worker'у закэшированный с момента создания комнаты
+  // hostEntryUrl/wasmUrl (деплой игры мог обновиться независимо от движка)
+  async function fetchGameManifest(gameId) {
+    return fetchGamePluginManifest(config.game.manifestUrl(gameId));
+  }
+
+  // манифест игры по ссылке на неё: уже загруженный активный — как есть,
+  // другая версия — версионный манифест мастера
+  async function resolveGameManifest(gameRef) {
+    if (gameRef?.entries) {
+      return gameRef;
+    }
+
+    const active = getActiveGame();
+
+    if (
+      active &&
+      gameRef.id === active.id &&
+      gameRef.version === active.version
+    ) {
+      return active;
+    }
+
+    return fetchGamePluginManifest(
+      config.game.versionManifestUrl(gameRef.id, gameRef.version),
+    );
+  }
+
+  // gameRef — манифест игры или { id, version } из контрольной точки: бета
+  // обязана поднять ту версию игры, что крутится в комнате (версионные URL
+  // мастера)
+  async function prepareHostRoom(room, gameRef = getActiveGame()) {
+    const gameManifest = await resolveGameManifest(gameRef);
+
+    // отладочный контур (этап 6): рекордер живого матча и хостовый
+    // CONSOLE-лог поднимаются только в dev-сборке
+    room.isDevMode = isDevBuild;
+
+    // Этап 6.4: Worker грузит HostPlugin динамически по
+    // entries.host/entries.wasm активной игры — движок не знает игру
+    // статически
+    room.game = {
+      id: gameManifest.id,
+      version: gameManifest.version,
+      hostEntryUrl: gameManifest.entries.host,
+      wasmUrl: gameManifest.entries.wasm,
+    };
+
+    // Этап 5.1: комната стартует на актуальных картах мастера;
+    // недоступность каталога некритична — Worker возьмёт карты из бандла
+    let mapsVersion = null;
+
+    try {
+      const catalog = await fetchMasterMaps(gameManifest);
+
+      room.maps = catalog.maps;
+      mapsVersion = catalog.version;
+    } catch (e) {
+      console.warn('[maps] master catalog unavailable, using bundled maps:', e);
+    }
+
+    // Этап 5.2: Worker создаётся по манифесту мастера — бандл страницы после
+    // деплоя исчезает из раздачи; без манифеста (dev) — бандловый URL,
+    // обновления кода отключены
+    let workerUrl = null;
+    let codeVersion = null;
+
+    try {
+      const manifest = await fetchWorkerManifest();
+
+      // составной codeVersion (Этап 6.5): движок (worker-бандл) + игра
+      // (id/version манифеста, с которым комната стартует)
+      codeVersion = {
+        engine: manifest.version,
+        game: { id: gameManifest.id, version: gameManifest.version },
+      };
+      workerUrl = manifest.url;
+    } catch (e) {
+      console.warn('[worker] master manifest unavailable, using bundled:', e);
+    }
+
+    return { room, workerUrl, mapsVersion, codeVersion };
+  }
+
+  return {
+    prepareHostRoom,
+    fetchMasterMaps,
+    fetchWorkerManifest,
+    fetchGameManifest,
+  };
+}

package/src/client/session/roomContext.js

@@ -0,0 +1,32 @@
+// Общее состояние вкладки в комнате (лобби-режим): его читают и меняют
+// роли хоста, гостя, беты, промоушен и маршруты (client/session/*).
+// Обычный объект, а не класс: модули получают одну и ту же ссылку от
+// сборщика (client/main.js), тесты — свежую на каждый сценарий.
+
+/**
+ * @returns {{
+ *   roomId: string|null,
+ *   epoch: number|null,
+ *   memberJoined: boolean,
+ *   entered: boolean,
+ *   startFailed: boolean,
+ * }}
+ */
+export function createRoomContext() {
+  return {
+    // комната, в которой вкладка гость или хост
+    roomId: null,
+    // эпоха хоста комнаты, ответившего последним: ответы прежних эпох чужие
+    epoch: null,
+    // вкладка объявила мастеру членство (join_room) и повторяет его после
+    // реконнекта сигналинга — даже если WebRTC в этот момент переподключается
+    memberJoined: false,
+    // вкладка ушла из лобби в комнату (по ссылке или из лобби). Не
+    // сбрасывается: после разрыва страница — остатки матча, и новый маршрут
+    // из hashchange поднимается перезагрузкой, а не бутстрапом поверх них
+    entered: false,
+    // Worker комнаты не поднялся: та же быстрая игра создала бы её снова и
+    // снова — поэтому уход на главную, как при кике
+    startFailed: false,
+  };
+}

package/src/client/style.css

@@ -86,7 +86,9 @@ body.hide-cursor {
   left: 0;
   right: 0;
   height: 24px;
-  z-index: 4;
+  /* 7 — выше прозрачного #game-informer (6), иначе тот перехватывал бы
+     клики по кнопке меню комнаты; ниже лобби/экрана авторизации игры (8) */
+  z-index: 7;
   overflow: hidden;
 }
 
@@ -359,6 +361,58 @@ body.hide-cursor {
   display: block;
 }
 
+/*room menu (host-migration, этап 3): кнопка внутри #panel справа от
+  таблицы (RoomMenuView.placeInPanel); order — таблицу PanelView достраивает
+  позже, по CONFIG_DATA. Без панели (игра её не показывает) — угол экрана;
+  z-index 7 — выше прозрачного #game-informer (6) и ниже лобби (8)*/
+
+#room-menu {
+  position: absolute;
+  top: 0;
+  right: 0;
+  z-index: 7;
+  font-size: 12px;
+  text-transform: none;
+}
+
+#panel > #room-menu {
+  position: static;
+  order: 1;
+  flex: 0 0 auto;
+}
+
+#room-menu-toggle {
+  display: block;
+  margin-left: auto;
+  height: 24px;
+  padding: 0 8px;
+  border: none;
+  background: transparent;
+}
+
+/* fixed — иначе список обрезал бы overflow: hidden панели */
+#room-menu-list {
+  position: fixed;
+  top: 24px;
+  right: 0;
+  padding: 4px;
+  background: #fff;
+}
+
+#room-menu-list input {
+  display: block;
+  width: 100%;
+  white-space: nowrap;
+  margin-top: 5px;
+}
+
+#room-menu-status {
+  padding: 2px 4px;
+  /* тёмный: фон списка белый */
+  color: #333;
+  white-space: nowrap;
+}
+
 /*chat*/
 
 #chat {
@@ -633,6 +687,25 @@ body.hide-cursor {
   white-space: pre-line;
 }
 
+/* оверлей сессии (host-migration этап 4): матч на паузе, пока клиент
+   переподключается к хосту; уровень лобби/авторизации — они с ним не
+   показываются одновременно, а #tech-informer остаётся выше. Своего
+   display нет: скрыт он `.vimp-shell > *`, показывает его main.js (flex) */
+#session-overlay {
+  position: absolute;
+  top: 0;
+  left: 0;
+  z-index: 8;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+  background-color: rgb(0 0 0 / 60%);
+  color: #fff;
+  font-size: 20px;
+  line-height: 24px;
+}
+
 #game-informer {
   position: absolute;
   top: 0;
@@ -700,13 +773,6 @@ body.hide-cursor {
   gap: 10px;
 }
 
-/* поле имени сервера — строка формы, а не узкий числовой инпут
-   (.form-row input[type='text'] рассчитан на счётчики вроде max players) */
-#lobby-name {
-  width: 200px;
-  text-align: left;
-}
-
 #lobby input[type='text'],
 #lobby select {
   box-sizing: border-box;
@@ -741,7 +807,7 @@ body.hide-cursor {
 
 .lobby-card {
   display: grid;
-  grid-template-columns: 1fr auto auto;
+  grid-template-columns: 1fr auto;
   column-gap: 8px;
   row-gap: 2px;
   padding: 10px 12px;
@@ -758,13 +824,19 @@ body.hide-cursor {
 }
 
 .lobby-card-name {
-  grid-column: 1 / -1;
+  grid-column: 1;
   font-weight: bold;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 
+.lobby-card-copy {
+  grid-column: 2;
+  font-size: 10px;
+  padding: 0 6px;
+}
+
 .lobby-card-info {
   grid-column: 1;
   color: #aaa;
@@ -774,19 +846,8 @@ body.hide-cursor {
   white-space: nowrap;
 }
 
-.lobby-card-rating {
-  grid-column: 2;
-  text-align: right;
-  color: #4caf50;
-  font-size: 10px;
-}
-
-.lobby-card-rating.is-negative {
-  color: #e57373;
-}
-
 .lobby-card-latency {
-  grid-column: 3;
+  grid-column: 2;
   text-align: right;
   color: #ff0;
   font-size: 10px;

package/src/client/views/gameShell.js

@@ -67,6 +67,13 @@ const SHELL = [
     ],
   },
   { tag: 'div', id: 'game-informer' },
+  // оверлей переподключения (host-migration этап 4): в solo/dedicated не
+  // показывается, но разметка общая с informer.pug
+  {
+    tag: 'div',
+    id: 'session-overlay',
+    children: [{ tag: 'span', id: 'session-overlay-text' }],
+  },
   { tag: 'div', id: 'tech-informer' },
 ];
 

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

@@ -1,2 +1,6 @@
 div#game-informer
+//- оверлей сессии (host-migration этап 4): «Reconnecting…» поверх матча на
+//- время переподключения к хосту; терминальный #tech-informer — выше него
+div#session-overlay
+  span#session-overlay-text
 div#tech-informer

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

@@ -31,9 +31,6 @@ div#lobby(style='display:none')
           div.form-row
             label.form-label(for='lobby-game')= 'Select game'
             select#lobby-game.field-select
-          div.form-row
-            label.form-label(for='lobby-name')= 'Server name'
-            input#lobby-name.field-text(type='text', maxlength='30', autocomplete='off')
           //- поля настроек комнаты генерируются по явной схеме roomForm
           //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
           div#lobby-fields

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

@@ -0,0 +1,9 @@
+//- меню комнаты (host-migration, этапы 3 и 8d): только лобби-режим, пока
+//- вкладка в комнате. «Hand over host» — только у хоста, когда передавать
+//- есть кому; статус передачи — на месте заблокированных пунктов
+div#room-menu(style='display:none')
+  input#room-menu-toggle(type='button', value='☰', title='Room menu')
+  div#room-menu-list(style='display:none')
+    input#room-menu-handover(type='button', value='Hand over host', style='display:none')
+    input#room-menu-leave(type='button', value='Leave server')
+    div#room-menu-status(style='display:none')

package/src/client/views/index.pug

@@ -2,6 +2,7 @@
 include includes/panel
 include includes/chat
 include includes/stat
+include includes/roomMenu
 include includes/lobbyAuth
 include includes/lobby
 include includes/games

package/src/config/chatMessages.js

@@ -0,0 +1,45 @@
+// Английские тексты движковых кодов чата по умолчанию (группы s, v, m, c, n);
+// индекс = номер кода. Лежат здесь, а не в clientDefaults: при слиянии
+// конфига массивы заменяются целиком, и массив `s` игры стёр бы умолчания.
+// Правило перекрытия: строка игры по тому же индексу важнее умолчания;
+// '' — игра заглушает сообщение; null/нет индекса — берётся умолчание.
+// Новый код движка добавляется в ENGINE_MESSAGE_CODES (host/meta/modules/chat/
+// systemMessages.js), сюда и в RESERVED правила B8 одним изменением —
+// за этим следит tests/config/chatMessages.test.js.
+export default {
+  s: [
+    'Team {0} is full. Your current team: {1}',
+    'Your team: {0}',
+    'Your new team: {0}',
+    'Your new status: spectator',
+    '{0} killed {1}',
+    '{0} joined the game',
+    '{0} left the game',
+    'Host changed',
+    'You are no longer the host (connection lost)',
+    'Host changed: the previous host was lagging',
+    'Host changed: the previous host went inactive',
+    'Host changed: the previous host had a poor connection',
+  ],
+  v: [
+    'A vote has been created',
+    'Voting has started',
+    'Your vote has been accepted',
+    'Voting is temporarily unavailable',
+    'Vote passed',
+    'Vote failed',
+    'Usage: /changehost',
+    'You are the host — use “Hand over host” in the room menu',
+    'No connection to the master server',
+    'A host vote was held recently',
+    'No other player can host',
+    'A host vote is already in progress',
+    'A host vote is not possible right now',
+    'Vote to change host passed ({0}/{1})',
+    'Vote to change host failed ({0}/{1})',
+    'Host vote cancelled',
+  ],
+  m: ['Current map: {0}', 'Next map: {0}'],
+  c: ['Command not found', 'Your rank: {0}'],
+  n: ['Invalid name', '{0} changed name to {1}'],
+};

package/src/config/closeCodes.js

@@ -7,7 +7,7 @@
 export default {
   staleHost: 4000, // master/SignalingServer.js — сигнальный WS хоста протух
   invalidOrigin: 4001, // master/SignalingServer.js, dedicated/main.js
-  blocked: 4002, // master/SignalingServer.js — хостер заблокирован рейтингом
+  // 4002 retired (server rating removed) — номер не переиспользуется
   kickForMaxLatency: 4003, // host/HostGame.js
   kickForMissedPings: 4004, // host/HostGame.js
   kickIdle: 4005, // host/HostGame.js

package/src/config/env.js

@@ -39,6 +39,43 @@ export function applyMasterEnv(config, env = process.env) {
   }
 }
 
+// минимальная длина VIMP_ROOM_SECRET_KEY — ключ HMAC-SHA256
+const ROOM_SECRET_KEY_MIN_BYTES = 32;
+
+/**
+ * Ключ секрета комнаты (host-migration, этап 2): roomSecret = HMAC(ключ,
+ * roomId:epoch:hostUserId) — им хост доказывает комнату после рестарта
+ * мастера. В production обязателен; в dev без него генерируется случайный на
+ * время процесса (комнаты после рестарта dev-мастера не восстанавливаются).
+ * @param {Object} [env] - Окружение (по умолчанию process.env).
+ * @param {Object} opts
+ * @param {boolean} opts.isProduction
+ * @param {Function} opts.randomBytes - crypto.randomBytes.
+ * @returns {{ key: string|Buffer, ephemeral: boolean }}
+ */
+export function readRoomSecretKey(
+  env = process.env,
+  { isProduction, randomBytes },
+) {
+  const key = env.VIMP_ROOM_SECRET_KEY;
+
+  if (key) {
+    if (Buffer.byteLength(key) < ROOM_SECRET_KEY_MIN_BYTES) {
+      throw new Error(
+        `VIMP_ROOM_SECRET_KEY: at least ${ROOM_SECRET_KEY_MIN_BYTES} bytes required`,
+      );
+    }
+
+    return { key, ephemeral: false };
+  }
+
+  if (isProduction) {
+    throw new Error('VIMP_ROOM_SECRET_KEY must be set in production');
+  }
+
+  return { key: randomBytes(ROOM_SECRET_KEY_MIN_BYTES), ephemeral: true };
+}
+
 /**
  * Настройки комнаты dedicated-сервера: VIMP_DEDICATED_ROOM — JSON-объект
  * (map, maxPlayers, roundTime, mapTime, friendlyFire, seed). Мусор в

package/src/config/hostDefaults.js

@@ -64,6 +64,30 @@ export default {
     maxLatency: 1000,
   },
 
+  // возобновление сессии (host-migration этап 4). Сколько хост держит место
+  // участника, чей транспорт оборвался без LEAVE: слот занят, актор в мире,
+  // клавиши отпущены. Включает его только Worker лобби — dedicated и
+  // standalone поднимают PortMachine без этой опции (0 — снять сразу)
+  resumeGraceMs: 20000,
+
+  // сколько возобновляющее соединение может молчать до RESUME_REQUEST
+  resumeRequestTimeoutMs: 5000,
+
+  // промоушен преемника (host-migration этап 7.4): сколько матч, поднятый из
+  // контрольной точки, стоит на паузе, ожидая возврата людей точки, прежде
+  // чем стартовать без них (их место держится ещё resumeGraceMs)
+  resumeWaitMs: 3000,
+
+  // контрольная точка хоста (host-migration этап 5). Предел распакованного
+  // размера чужой точки — защита от «zip-бомбы»: сырой дамп tanks ~420 КБ,
+  // запас на порядок с лишним
+  maxCheckpointBytes: 8 * 1024 * 1024,
+
+  // сколько эстафета Worker'ов ждёт финальной синхронизации профилей
+  // (flushAll) перед отдачей состояния новому Worker'у; дольше — отдаёт
+  // как есть, неотправленное едет в состоянии
+  handoffFlushTimeoutMs: 3000,
+
   // порог допустимого бездействия перед киком
   // если null — кик отключен
   idleKickTimeout: {