vimp-engine 0.35.5 → 0.36.0

package/src/client/components/view/LobbyAuth.js

@@ -18,8 +18,9 @@ const LOGIN_ERROR_MESSAGES = {
 };
 
 // Представление логина лобби: переключает login/nick секции lobbyAuth.pug и
-// бейдж пользователя в lobby.pug (#lobby-user), скрывает/показывает #lobby
-// целиком — до авторизации список серверов недоступен (B2)
+// бейдж пользователя в lobby.pug (#lobby-user), скрывает #lobby целиком —
+// до авторизации список серверов недоступен (B2). Показывает лобби main.js,
+// когда маршрут в него ведёт: вход по ссылке минует лобби вовсе
 export default class LobbyAuthView {
   constructor(model, config) {
     if (lobbyAuthView) {
@@ -31,7 +32,9 @@ export default class LobbyAuthView {
     const { elems, providerButtonClass } = config;
 
     this._elems = elems;
-    this._providerButtons = document.querySelectorAll(`.${providerButtonClass}`);
+    this._providerButtons = document.querySelectorAll(
+      `.${providerButtonClass}`,
+    );
 
     this._container = document.getElementById(elems.containerId);
     this._loginSection = document.getElementById(elems.loginSectionId);
@@ -77,7 +80,9 @@ export default class LobbyAuthView {
     this._user.style.display = 'none';
 
     this._providerButtons.forEach(btn => {
-      btn.style.display = providers.includes(btn.dataset.provider) ? '' : 'none';
+      btn.style.display = providers.includes(btn.dataset.provider)
+        ? ''
+        : 'none';
     });
   }
 
@@ -92,17 +97,18 @@ export default class LobbyAuthView {
 
   showLobby({ nick }) {
     this._container.style.display = 'none';
-    this._lobby.style.display = 'flex';
     this._user.style.display = 'flex';
     this._userNick.textContent = nick;
   }
 
   renderLoginError(code) {
-    this._loginError.textContent = LOGIN_ERROR_MESSAGES[code] || 'Sign-in failed';
+    this._loginError.textContent =
+      LOGIN_ERROR_MESSAGES[code] || 'Sign-in failed';
   }
 
   renderNickError(code) {
-    this._nickError.textContent = NICK_ERROR_MESSAGES[code] || 'Something went wrong';
+    this._nickError.textContent =
+      NICK_ERROR_MESSAGES[code] || 'Something went wrong';
   }
 
   _emitNick() {

package/src/client/components/view/Panel.js

@@ -234,8 +234,7 @@ export default class PanelView {
     }
 
     const { blocksToShow, blink } = pendingTarget;
-    const step =
-      blocksToShow > 0 ? BAR_FILL_DURATION_MS / blocksToShow : 0;
+    const step = blocksToShow > 0 ? BAR_FILL_DURATION_MS / blocksToShow : 0;
 
     for (let index = 0; index < blocksToShow; index += 1) {
       bar.blockTimers.push(

package/src/client/components/view/RoomMenu.js

@@ -0,0 +1,69 @@
+import Publisher from '../../../lib/Publisher.js';
+
+// Singleton RoomMenuView
+
+let roomMenuView;
+
+export default class RoomMenuView {
+  // config — lobbyConfig.roomMenu: { elems: { panelId, menuId, toggleId,
+  // listId, leaveId, handoverId, statusId } }
+  constructor(model, config) {
+    if (roomMenuView) {
+      return roomMenuView;
+    }
+
+    roomMenuView = this;
+
+    const { elems } = config;
+
+    this._menu = document.getElementById(elems.menuId);
+    this._list = document.getElementById(elems.listId);
+    this._leave = document.getElementById(elems.leaveId);
+    this._handover = document.getElementById(elems.handoverId);
+    this._status = document.getElementById(elems.statusId);
+    this._panel = document.getElementById(elems.panelId);
+    this._home = this._menu.parentElement;
+
+    this.publisher = new Publisher();
+
+    document
+      .getElementById(elems.toggleId)
+      .addEventListener('click', () => this.publisher.emit('toggle'));
+    this._leave.addEventListener('click', () => this.publisher.emit('leave'));
+    this._handover.addEventListener('click', () =>
+      this.publisher.emit('handover'),
+    );
+
+    this._mPublic = model.publisher;
+    this._mPublic.on('state', 'showState', this);
+    this._mPublic.on('open', 'showOpen', this);
+  }
+
+  showState({ visible, leave, handover, status }) {
+    this._menu.style.display = visible ? 'block' : 'none';
+    showItem(this._leave, leave);
+    showItem(this._handover, handover);
+    this._status.textContent = status ?? '';
+    this._status.style.display = status ? 'block' : 'none';
+  }
+
+  // меню — часть панели (справа от таблицы), но разметка отдельная: каркас
+  // панели общий со standalone SDK, где меню комнаты нет. Игра без панели в
+  // initIdList держит её скрытой — тогда меню остаётся кнопкой в углу
+  placeInPanel(inPanel) {
+    const parent = inPanel && this._panel ? this._panel : this._home;
+
+    if (this._menu.parentElement !== parent) {
+      parent.appendChild(this._menu);
+    }
+  }
+
+  showOpen(open) {
+    this._list.style.display = open ? 'block' : 'none';
+  }
+}
+
+function showItem(elem, { visible, disabled }) {
+  elem.style.display = visible ? 'block' : 'none';
+  elem.disabled = disabled;
+}

package/src/client/debug.js

@@ -24,6 +24,8 @@ export function debugLog(...args) {
  *   если вкладка не хостит комнату).
  * @param {Function} params.getClientCore - Текущий ClientCore.
  * @param {string} params.reportUrl - Эндпоинт выгрузки на мастере.
+ * @param {Function} [params.startHandoff] - ({ reason, stay }) => boolean —
+ *   плановая передача хоста (host-migration этап 8), пока у неё нет меню.
  * @param {Function} [params.fetchImpl] - fetch (подменяется в тестах).
  * @param {Function} [params.log] - Логгер (подменяется в тестах).
  * @returns {Object} API для window.__vimpDebug.
@@ -32,6 +34,7 @@ export function createDebugApi({
   getHostController,
   getClientCore,
   reportUrl,
+  startHandoff = null,
   fetchImpl,
   log = debugLog,
 }) {
@@ -105,7 +108,9 @@ export function createDebugApi({
     async startRecording() {
       const started = await requireHost().startRecording();
 
-      log(started ? 'recording started' : 'recording unavailable (no dev mode)');
+      log(
+        started ? 'recording started' : 'recording unavailable (no dev mode)',
+      );
 
       return started;
     },
@@ -154,5 +159,23 @@ export function createDebugApi({
 
       return dump;
     },
+
+    /**
+     * Плановая передача роли хоста бете (host-migration этап 8): stay —
+     * остаться в комнате гостем, иначе уход в лобби.
+     * @param {Object} [options]
+     * @param {string} [options.reason]
+     * @param {boolean} [options.stay]
+     * @returns {boolean} передача началась.
+     */
+    handoff({ reason = 'handover', stay = true } = {}) {
+      requireHost();
+
+      const started = startHandoff?.({ reason, stay }) === true;
+
+      log(started ? `handoff started (${reason})` : 'handoff not started');
+
+      return started;
+    },
   };
 }

package/src/client/lib/FpsMeter.js

@@ -0,0 +1,46 @@
+// Средний FPS рендера за окно (host-migration этап 9c): гость сообщает его
+// мастеру в caps.fps, и мастер не назначает бетой слабую вкладку.
+// Ticker.shared.FPS для этого не годится — это скорость одного последнего
+// кадра: пауза сборщика мусора в момент замера сняла бы бету с прогревом.
+
+// окно короче — замер шумный, не сообщается
+const MIN_WINDOW_MS = 1000;
+
+export default class FpsMeter {
+  /**
+   * @param {Object} [options]
+   * @param {Function} [options.now] - монотонные часы, мс.
+   */
+  constructor({ now = () => performance.now() } = {}) {
+    this._now = now;
+    this._frames = 0;
+    this._since = now();
+  }
+
+  // кадр отрисован (колбэк тикера)
+  frame() {
+    this._frames++;
+  }
+
+  // окно заново: кадры до этого момента не в счёт (вкладка была скрыта)
+  reset() {
+    this._frames = 0;
+    this._since = this._now();
+  }
+
+  /**
+   * Средний FPS с прошлого замера; окно начинается заново.
+   * @returns {number|null} null — кадров не было или окно короче 1 с.
+   */
+  sample() {
+    const elapsedMs = this._now() - this._since;
+    const fps =
+      this._frames > 0 && elapsedMs >= MIN_WINDOW_MS
+        ? (this._frames * 1000) / elapsedMs
+        : null;
+
+    this.reset();
+
+    return fps;
+  }
+}

package/src/client/lib/JoinRetry.js

@@ -0,0 +1,73 @@
+// Повтор join_room на unknownRoom (host-migration-review этап 6): после
+// рестарта мастера реестр комнат пуст, и комната появляется, только когда
+// хост вернёт её reclaim_host. Гость, чей сигналинг переподключился раньше
+// хоста, повторяет вход с бэкоффом, пока не истечёт окно.
+//
+// Без DOM: отправку, таймеры и часы инъектирует владелец
+// (client/session/Membership.js).
+
+const DEFAULT_DELAYS_MS = [1000, 2000, 4000, 8000, 8000, 8000];
+
+export default class JoinRetry {
+  /**
+   * @param {Object} opts
+   * @param {Function} opts.send - () отправить join_room.
+   * @param {number[]} [opts.delaysMs] - задержки попыток; последняя
+   *   повторяется.
+   * @param {number} [opts.windowMs] - сколько всего пытаться (от первого
+   *   schedule() после stop()).
+   * @param {Object} [opts.timers] - { setTimeout, clearTimeout }.
+   * @param {Function} [opts.now]
+   */
+  constructor({
+    send,
+    delaysMs = DEFAULT_DELAYS_MS,
+    windowMs = 30000,
+    timers = globalThis,
+    now = () => Date.now(),
+  }) {
+    this._send = send;
+    this._delaysMs = delaysMs;
+    this._windowMs = windowMs;
+    this._timers = timers;
+    this._now = now;
+    this._timer = null;
+    this._attempt = 0;
+    this._startedAt = null;
+  }
+
+  // следующая попытка, если окно не истекло
+  schedule() {
+    if (this._timer !== null) {
+      return;
+    }
+
+    const now = this._now();
+
+    if (this._startedAt === null) {
+      this._startedAt = now;
+    } else if (now - this._startedAt >= this._windowMs) {
+      return;
+    }
+
+    const delay =
+      this._delaysMs[Math.min(this._attempt, this._delaysMs.length - 1)];
+
+    this._attempt += 1;
+    this._timer = this._timers.setTimeout(() => {
+      this._timer = null;
+      this._send();
+    }, delay);
+  }
+
+  // снять таймер и сбросить окно: вход состоялся или вкладка ушла
+  stop() {
+    if (this._timer !== null) {
+      this._timers.clearTimeout(this._timer);
+      this._timer = null;
+    }
+
+    this._attempt = 0;
+    this._startedAt = null;
+  }
+}

package/src/client/lib/diagnostics.js

@@ -37,7 +37,14 @@ const EXTENSION_PREFIXES = [
 ];
 
 // служебные значения blockedURI — не URL, берутся как есть
-const CSP_KEYWORDS = new Set(['', 'inline', 'eval', 'wasm-eval', 'data', 'blob']);
+const CSP_KEYWORDS = new Set([
+  '',
+  'inline',
+  'eval',
+  'wasm-eval',
+  'data',
+  'blob',
+]);
 
 const encoder = new TextEncoder();
 
@@ -72,7 +79,12 @@ function topFrame(stack) {
     return '';
   }
 
-  return stack.split('\n').find(line => FRAME_RE.test(line))?.trim() ?? '';
+  return (
+    stack
+      .split('\n')
+      .find(line => FRAME_RE.test(line))
+      ?.trim() ?? ''
+  );
 }
 
 // снимок деталей: простой объект ≤ 2048 байт JSON, иначе пометка усечения
@@ -127,7 +139,12 @@ function isExtensionUrl(value) {
 function defaultSend(url, json) {
   if (typeof navigator !== 'undefined' && navigator.sendBeacon) {
     try {
-      if (navigator.sendBeacon(url, new Blob([json], { type: 'application/json' }))) {
+      if (
+        navigator.sendBeacon(
+          url,
+          new Blob([json], { type: 'application/json' }),
+        )
+      ) {
         return;
       }
     } catch {
@@ -237,7 +254,10 @@ export function createDiagnostics({
     // молча съедал бы приросты счётчиков непрерывно повторяющейся ошибки
     const sinceLast = lastSentAt === null ? Infinity : now() - lastSentAt;
 
-    timer = setTimeout(flush, Math.max(flushDelayMs, minIntervalMs - sinceLast));
+    timer = setTimeout(
+      flush,
+      Math.max(flushDelayMs, minIntervalMs - sinceLast),
+    );
   }
 
   function guarded(fn) {
@@ -301,7 +321,10 @@ export function createDiagnostics({
   // сработавшее тысячу раз, одна запись со счётчиком
   function reportCsp(event) {
     guarded(() => {
-      if (isExtensionUrl(event.blockedURI) || isExtensionUrl(event.sourceFile)) {
+      if (
+        isExtensionUrl(event.blockedURI) ||
+        isExtensionUrl(event.sourceFile)
+      ) {
         return;
       }
 

package/src/client/lib/hostCaps.js

@@ -0,0 +1,82 @@
+import { supportsModuleWorker } from '../network/workerSupport.js';
+
+// Возможности участника комнаты (host-migration этап 6): мастер по ним
+// выбирает преемника хоста (master/successor.js). Шлются в join_room /
+// register_host и в member_update при смене видимости вкладки или типа
+// ICE-кандидата, а гостем — раз в 10 с ради свежего FPS (этап 9c).
+
+/**
+ * Мобильное устройство: Client Hints, а без них — грубый указатель.
+ * @param {Object} [env] - { navigator, matchMedia } (тесты).
+ * @returns {boolean}
+ */
+export function isMobileDevice(env = globalThis) {
+  const hinted = env.navigator?.userAgentData?.mobile;
+
+  if (typeof hinted === 'boolean') {
+    return hinted;
+  }
+
+  try {
+    return env.matchMedia?.('(pointer: coarse)').matches === true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Может ли вкладка поднять Worker хоста и принимать WebRTC.
+ * @param {Object} [env] - { RTCPeerConnection, WebAssembly, navigator,
+ *   matchMedia, moduleWorker: () => boolean } (тесты).
+ * @returns {boolean}
+ */
+export function canHostIn(env = globalThis) {
+  const moduleWorker = env.moduleWorker ?? supportsModuleWorker;
+
+  return (
+    typeof env.RTCPeerConnection !== 'undefined' &&
+    typeof env.WebAssembly === 'object' &&
+    env.WebAssembly !== null &&
+    !isMobileDevice(env) &&
+    moduleWorker()
+  );
+}
+
+/**
+ * Собирает caps участника.
+ * @param {Object} options
+ * @param {boolean} options.canHost - результат canHostIn (считается один
+ *   раз: проба Worker'а не бесплатна).
+ * @param {string|null} [options.iceType] - тип своего локального
+ *   ICE-кандидата в выбранной паре с хостом ('host'|'srflx'|'prflx'|'relay').
+ * @param {number|null} [options.fps] - FPS рендера (гость; мастер не
+ *   назначает бетой вкладку ниже master.room.minSuccessorFps).
+ * @param {Object} [env] - { document, navigator, matchMedia } (тесты).
+ * @returns {{ canHost: boolean, mobile: boolean, hidden: boolean,
+ *   iceType: string|null, fps: number|null }}
+ */
+export function buildHostCaps(
+  { canHost, iceType = null, fps = null },
+  env = globalThis,
+) {
+  return {
+    canHost: canHost === true,
+    mobile: isMobileDevice(env),
+    hidden: env.document?.hidden === true,
+    iceType: iceType ?? null,
+    fps: Number.isFinite(fps) ? Math.round(fps) : null,
+  };
+}
+
+/**
+ * Хватит ли срока токена, чтобы вкладка могла принять роль хоста: хост
+ * предъявляет токен мастеру посреди матча (register_host, reclaim_host), а
+ * продления нет.
+ * @param {number|null} expiresAt - мс эпохи; null — неизвестно (не мешает).
+ * @param {number} minLifetimeMs
+ * @param {number} [now]
+ * @returns {boolean}
+ */
+export function tokenAllowsHosting(expiresAt, minLifetimeMs, now = Date.now()) {
+  return expiresAt === null || expiresAt - now > minLifetimeMs;
+}

package/src/client/lib/hostUnloadGuard.js

@@ -0,0 +1,108 @@
+// Защита комнаты от случайного закрытия вкладки хоста (host-migration этап
+// 8.4).
+//
+// beforeunload висит, только пока вкладка — текущий хост и в комнате есть
+// другие люди: Ctrl+W/F5 спросит «Leave site?». Финального дампа во время
+// диалога не будет — пока он открыт, главный поток стоит, а именно он
+// ретранслирует Worker → DataChannel; гости это время видят замерший матч.
+//
+// pagehide срабатывает и после «Leave», и при закрытии без диалога (на
+// мобильных beforeunload ненадёжен — там остаётся только он): хост сразу
+// говорит мастеру host_leaving (аварийная миграция без ожидания обрыва WS),
+// гость — LEAVE хосту и leave_room мастеру (его место освобождается сразу,
+// а не через resumeGraceMs). Всё best-effort: недошедшее перекроет обрыв
+// соединений.
+//
+// exit() — вкладка уходит сама («Leave server», переход в лобби): диалог не
+// нужен, уход уже объявлен.
+
+export default class HostUnloadGuard {
+  /**
+   * @param {Object} options
+   * @param {Function} options.onHostLeave - () pagehide у хоста.
+   * @param {Function} options.onGuestLeave - () pagehide у гостя комнаты.
+   * @param {EventTarget} [options.target] - window (тесты — свой).
+   */
+  constructor({ onHostLeave, onGuestLeave, target = globalThis }) {
+    this._onHostLeave = onHostLeave;
+    this._onGuestLeave = onGuestLeave;
+    this._target = target;
+
+    // null — не в комнате | 'host' | 'guest'
+    this._role = null;
+    this._othersPresent = false;
+    this._armed = false;
+    this._exiting = false;
+
+    this._onBeforeUnload = event => {
+      event.preventDefault();
+      // старые браузеры показывают диалог только по returnValue
+      event.returnValue = '';
+    };
+    this._onPageHide = () => this._pageHide();
+
+    target.addEventListener('pagehide', this._onPageHide);
+  }
+
+  // диалог закрытия сейчас висит
+  get armed() {
+    return this._armed;
+  }
+
+  /**
+   * Роль вкладки в комнате и есть ли в ней другие люди.
+   * @param {Object} state
+   * @param {'host'|'guest'|null} state.role
+   * @param {boolean} [state.othersPresent]
+   */
+  update({ role, othersPresent = false }) {
+    this._role = role ?? null;
+    this._othersPresent = othersPresent === true;
+    this._sync();
+  }
+
+  // вкладка уходит сама: ни диалога, ни повторного объявления ухода
+  exit() {
+    this._exiting = true;
+    this._sync();
+  }
+
+  destroy() {
+    this.exit();
+    this._target.removeEventListener('pagehide', this._onPageHide);
+  }
+
+  _sync() {
+    const armed =
+      !this._exiting && this._role === 'host' && this._othersPresent;
+
+    if (armed === this._armed) {
+      return;
+    }
+
+    this._armed = armed;
+
+    if (armed) {
+      this._target.addEventListener('beforeunload', this._onBeforeUnload);
+    } else {
+      this._target.removeEventListener('beforeunload', this._onBeforeUnload);
+    }
+  }
+
+  _pageHide() {
+    if (this._exiting) {
+      return;
+    }
+
+    // страница уходит: второй pagehide (bfcache) ничего не повторит
+    this._exiting = true;
+
+    if (this._role === 'host') {
+      this._onHostLeave();
+    } else if (this._role === 'guest') {
+      this._onGuestLeave();
+    }
+
+    this._sync();
+  }
+}

package/src/client/lib/hostVoteCommand.js

@@ -0,0 +1,92 @@
+// Голосование «Change host» (host-migration этап 10): команда /changehost и
+// окно у гостей. Голоса считает мастер, поэтому команда в лобби-режиме не
+// уходит хосту. В solo/dedicated мастера нет — команда остаётся обычным
+// текстом для игры.
+
+// имя голосования движка; префикс '@' зарезервирован движком
+export const CHANGE_HOST_VOTE = '@changeHost';
+
+export const CHANGE_HOST_VALUES = ['Yes', 'No'];
+
+const COMMAND = '/changehost';
+
+/**
+ * Разбор сообщения чата.
+ * @param {string} text
+ * @param {string} bootMode - 'lobby' | 'solo' | 'dedicated'.
+ * @returns {'start'|'usage'|null} null — не перехватывать.
+ */
+export function parseChangeHost(text, bootMode) {
+  if (bootMode !== 'lobby' || typeof text !== 'string') {
+    return null;
+  }
+
+  const [command, ...args] = text.trim().split(/\s+/);
+
+  if (command !== COMMAND) {
+    return null;
+  }
+
+  return args.length === 0 ? 'start' : 'usage';
+}
+
+/**
+ * Заголовок окна голосования у гостя.
+ * @param {string|null} nick - инициатор.
+ * @returns {string}
+ */
+export function changeHostTitle(nick) {
+  return nick ? `Change host? (started by ${nick})` : 'Change host?';
+}
+
+/**
+ * Ответ окна ('Yes'/'No') — значение host_vote_answer.
+ * @param {string} value
+ * @returns {'yes'|'no'|null}
+ */
+export function answerValue(value) {
+  const index = CHANGE_HOST_VALUES.indexOf(value);
+
+  return index === -1 ? null : index === 0 ? 'yes' : 'no';
+}
+
+// причина отказа мастера → код системного сообщения
+const REJECTION_KEYS = {
+  host: 'HOST_VOTE_IS_HOST',
+  active: 'HOST_VOTE_ACTIVE',
+  roomCooldown: 'HOST_VOTE_RECENT',
+  userCooldown: 'HOST_VOTE_RECENT',
+};
+
+/**
+ * Ключ системного сообщения для ошибки мастера на host_vote_start.
+ * @param {Object} error - { code, reason }.
+ * @returns {string|null} null — ошибка не про голосование.
+ */
+export function rejectionMessageKey({ code, reason } = {}) {
+  if (code === 'noSuccessor') {
+    return 'HOST_VOTE_NO_SUCCESSOR';
+  }
+
+  if (code === 'voteRejected') {
+    return REJECTION_KEYS[reason] ?? 'HOST_VOTE_UNAVAILABLE';
+  }
+
+  return null;
+}
+
+/**
+ * Системное сообщение итога голосования.
+ * @param {Object} result - host_vote_result.
+ * @returns {{ key: string, params: Array<string> }}
+ */
+export function resultMessage({ passed, cancelled, yes, eligibleCount }) {
+  if (cancelled) {
+    return { key: 'HOST_VOTE_CANCELLED', params: [] };
+  }
+
+  return {
+    key: passed ? 'HOST_VOTE_PASSED' : 'HOST_VOTE_FAILED',
+    params: [String(yes), String(eligibleCount)],
+  };
+}

package/src/client/lib/pageReload.js

@@ -0,0 +1,29 @@
+import { reloadTo } from './roomLink.js';
+
+/**
+ * Программная перезагрузка страницы: сначала guard.exit() — иначе
+ * pagehide принял бы её за закрытие вкладки, и гость (бета перед холодным
+ * промоушеном, возврат в ту же комнату) объявил бы уход и потерял место.
+ * Единственное место, где клиент перезагружает страницу (ESLint).
+ * @param {Object} deps
+ * @param {Function} deps.getGuard - () → HostUnloadGuard | null.
+ * @param {Function} [deps.reloadToHash] - (hashPart) — тесты.
+ * @param {Function} [deps.reloadSame] - () — тесты.
+ * @returns {Function} (hashPart?) => void; hashPart не задан — тот же адрес.
+ */
+export function createPageReload({
+  getGuard,
+  reloadToHash = reloadTo,
+  // eslint-disable-next-line no-restricted-syntax -- сама обёртка
+  reloadSame = () => window.location.reload(),
+}) {
+  return hashPart => {
+    getGuard()?.exit();
+
+    if (hashPart === undefined) {
+      reloadSame();
+    } else {
+      reloadToHash(hashPart);
+    }
+  };
+}