vimp-engine 0.40.0 → 0.42.0

package/src/client/lib/hostUnloadGuard.js

@@ -1,25 +1,29 @@
-// Защита комнаты от случайного закрытия вкладки хоста (host-migration этап
-// 8.4).
+// Защита комнаты от случайного закрытия вкладки хоста.
 //
 // beforeunload висит, только пока вкладка — текущий хост и в комнате есть
-// другие люди: Ctrl+W/F5 спросит «Leave site?». Финального дампа во время
-// диалога не будет — пока он открыт, главный поток стоит, а именно он
-// ретранслирует Worker → DataChannel; гости это время видят замерший матч.
+// другие люди. При назначенной бете обработчик сразу объявляет уход мастеру
+// (host_leaving — аварийная миграция к ней начинается, пока висит диалог
+// «Leave site?»); без беты — нет: мастер закрыл бы комнату всем, даже если
+// вкладка останется. Затем просит диалог. «Leave» — вкладка закрывается;
+// «Cancel» — мастер снимает её с роли (host_revoked), и она остаётся в
+// комнате гостем. Финального дампа нет: пока диалог открыт, главный поток
+// стоит, а именно он ретранслирует Worker → DataChannel, — откат не больше
+// интервала периодических точек.
 //
 // pagehide срабатывает и после «Leave», и при закрытии без диалога (на
-// мобильных beforeunload ненадёжен — там остаётся только он): хост сразу
-// говорит мастеру host_leaving (аварийная миграция без ожидания обрыва WS),
-// гость — LEAVE хосту и leave_room мастеру (его место освобождается сразу,
-// а не через resumeGraceMs). Всё best-effort: недошедшее перекроет обрыв
-// соединений.
+// мобильных beforeunload ненадёжен — там остаётся только он): хост, ещё не
+// объявивший уход, говорит мастеру host_leaving, гость — LEAVE хосту и
+// leave_room мастеру (его место освобождается сразу, а не через
+// resumeGraceMs). Всё best-effort: недошедшее перекроет обрыв соединений.
 //
-// exit() — вкладка уходит сама («Leave server», переход в лобби): диалог не
-// нужен, уход уже объявлен.
+// exit() — вкладка уходит сама (Exit, переход в лобби): диалог не нужен,
+// уход уже объявлен.
 
 export default class HostUnloadGuard {
   /**
    * @param {Object} options
-   * @param {Function} options.onHostLeave - () pagehide у хоста.
+   * @param {Function} options.onHostLeave - () → boolean: хост уходит
+   *   (beforeunload при бете или pagehide); true — host_leaving отправлен.
    * @param {Function} options.onGuestLeave - () pagehide у гостя комнаты.
    * @param {EventTarget} [options.target] - window (тесты — свой).
    */
@@ -31,10 +35,17 @@ export default class HostUnloadGuard {
     // null — не в комнате | 'host' | 'guest'
     this._role = null;
     this._othersPresent = false;
+    this._hasSuccessor = false;
     this._armed = false;
     this._exiting = false;
+    // host_leaving уже отправлен из beforeunload этой роли хоста
+    this._hostLeaveSent = false;
 
     this._onBeforeUnload = event => {
+      if (this._role === 'host' && this._hasSuccessor) {
+        this._announceHostLeave();
+      }
+
       event.preventDefault();
       // старые браузеры показывают диалог только по returnValue
       event.returnValue = '';
@@ -54,10 +65,17 @@ export default class HostUnloadGuard {
    * @param {Object} state
    * @param {'host'|'guest'|null} state.role
    * @param {boolean} [state.othersPresent]
+   * @param {boolean} [state.hasSuccessor] - мастер назначил бету.
    */
-  update({ role, othersPresent = false }) {
+  update({ role, othersPresent = false, hasSuccessor = false }) {
     this._role = role ?? null;
     this._othersPresent = othersPresent === true;
+    this._hasSuccessor = hasSuccessor === true;
+
+    if (this._role !== 'host') {
+      this._hostLeaveSent = false;
+    }
+
     this._sync();
   }
 
@@ -98,11 +116,18 @@ export default class HostUnloadGuard {
     this._exiting = true;
 
     if (this._role === 'host') {
-      this._onHostLeave();
+      this._announceHostLeave();
     } else if (this._role === 'guest') {
       this._onGuestLeave();
     }
 
     this._sync();
   }
+
+  // host_leaving один раз на роль хоста; флаг — только если ушёл
+  _announceHostLeave() {
+    if (!this._hostLeaveSent && this._onHostLeave() === true) {
+      this._hostLeaveSent = true;
+    }
+  }
 }

package/src/client/lib/roomLink.js

@@ -237,6 +237,38 @@ export function pickQuickPlayRoom(servers, gameId) {
   return best;
 }
 
+/**
+ * Сообщение терминального закрытия сессии (если причину ещё не показал
+ * TECH_INFORM).
+ * @param {Object} opts
+ * @param {boolean} opts.isLobbyMode
+ * @param {boolean} opts.transportOpened - каналы транспорта открывались
+ *   (SessionSupervisor.everOpened).
+ * @returns {{message: string, joinFailed: boolean}} joinFailed — вход не
+ *   состоялся (P2P не поднялось): уход на главную, как при несостоявшемся
+ *   старте комнаты.
+ */
+export function decideCloseNotice({ isLobbyMode, transportOpened }) {
+  if (!isLobbyMode) {
+    return {
+      message: 'The match is over — connection to the host is closed.',
+      joinFailed: false,
+    };
+  }
+
+  if (!transportOpened) {
+    return {
+      message: 'P2P connection failed. Click to return to the lobby.',
+      joinFailed: true,
+    };
+  }
+
+  return {
+    message: 'Host left — the room is closed. Finding another room…',
+    joinFailed: false,
+  };
+}
+
 /**
  * Куда уходить после разрыва с комнатой (лобби-режим).
  * @param {Object} reason

package/src/client/main.js

@@ -73,6 +73,7 @@ import SessionSupervisor, {
 import FpsMeter from './lib/FpsMeter.js';
 import HostUnloadGuard from './lib/hostUnloadGuard.js';
 import { createPageReload } from './lib/pageReload.js';
+import { AutoRejoin, saveAutoRejoin } from './lib/autoRejoin.js';
 import { createAuthApi } from './lib/authApi.js';
 import {
   decideSessionStorageChange,
@@ -111,6 +112,7 @@ import RoomMenuView from './components/view/RoomMenu.js';
 import RoomMenuCtrl from './components/controller/RoomMenu.js';
 import {
   absoluteLink,
+  decideCloseNotice,
   decideExitRoute,
   formatGameLink,
   formatRoomLink,
@@ -589,13 +591,19 @@ socketMethods[PS_CONFIG_DATA] = async data => {
     });
 };
 
+// последний PS_AUTH_DATA: форма строится из него и тогда, когда хост отбил
+// автовход
+let lastAuthData = null;
+// автовход после перезагрузки в ту же комнату (взводит RouteBoot)
+const autoRejoin = new AutoRejoin();
+
 // auth data
 socketMethods[PS_AUTH_DATA] = data => {
   if (typeof data !== 'object' || data === null) {
     return;
   }
 
-  const { elems, params, texts } = data;
+  const { params, texts } = data;
 
   document.getElementById('logo').textContent = texts?.title || 'VIMP';
 
@@ -623,6 +631,22 @@ socketMethods[PS_AUTH_DATA] = data => {
     return;
   }
 
+  lastAuthData = data;
+
+  // перезагрузка после потери места (reloadToRoom): ответ сохранёнными
+  // значениями формы — теми же, что подставила бы форма
+  if (autoRejoin.begin(roomCtx.roomId)) {
+    showSessionOverlay('Reconnecting…');
+    sendAuthResponse(defaultsFrom(params));
+
+    return;
+  }
+
+  showAuthForm(data);
+};
+
+// форма входа игры (#auth)
+function showAuthForm({ elems, params, texts }) {
   // клиент проверяет только движковые правила (isValidName): игровые
   // валидаторы (isValidModel) не идут по проводу и не грузятся с
   // ClientPlugin (HostPlugin.authSchema — только у хоста). Хост валидирует
@@ -633,19 +657,22 @@ socketMethods[PS_AUTH_DATA] = data => {
   const authView = new AuthView(authModel, elems, texts, params);
   modules.auth = new AuthCtrl(authModel, authView);
 
-  authModel.publisher.on('socket', data => {
-    // игровой хук авторизации (модель танка для реплик движения и выстрелов)
-    if (clientCore) {
-      clientPlugin.hooks.onAuth(clientCore, data);
-    }
-
-    // ник больше не вводится в игровой форме — токен лобби несёт claim
-    // 'nick', хост проверяет его подпись по /jwks и берёт ник оттуда (Этап B3)
-    sending(PC_AUTH_RESPONSE, { ...data, token: lobbyAuthModel?.getToken() });
-  });
+  authModel.publisher.on('socket', sendAuthResponse);
 
   modules.auth.init(params);
-};
+}
+
+// ответ хосту на форму входа (форма или автовход)
+function sendAuthResponse(data) {
+  // игровой хук авторизации (модель танка для реплик движения и выстрелов)
+  if (clientCore) {
+    clientPlugin.hooks.onAuth(clientCore, data);
+  }
+
+  // ник в игровой форме не вводится — токен лобби несёт claim 'nick', хост
+  // проверяет его подпись по /jwks и берёт ник оттуда
+  sending(PC_AUTH_RESPONSE, { ...data, token: lobbyAuthModel?.getToken() });
+}
 
 // значения формы по умолчанию (schema → { name: value }): база авто-ответа
 function defaultsFrom(params) {
@@ -654,6 +681,15 @@ function defaultsFrom(params) {
 
 // auth errors
 socketMethods[PS_AUTH_RESULT] = async err => {
+  // автовход отбит хостом (выбор формы больше не годится) — обычная форма
+  // с ошибкой: игрок исправит выбор
+  if (autoRejoin.result(err) && lastAuthData) {
+    showSessionOverlay(null);
+    showAuthForm(lastAuthData);
+    modules.auth.parseRes(err);
+    return;
+  }
+
   if (modules.auth) {
     modules.auth.parseRes(err);
   } else if (err) {
@@ -1045,6 +1081,10 @@ socketMethods[PS_CLEAR] = function (setIdList) {
     }
   }
 
+  // личное меню и подсказки прошлого раунда гаснут; ядро игры зажжёт
+  // подсказку заново при спавне
+  modules.vote?.clearPersonal();
+
   clientCore?.reset();
   soundManager.reset();
 };
@@ -1707,13 +1747,19 @@ function handleDisconnect() {
   inlineHost = null;
 
   // терминальную причину закрытия (кик, полная комната — TECH_INFORM перед
-  // закрытием) не затираем
+  // закрытием) не затираем. Каналы так и не открылись — вход не состоялся:
+  // уход на главную, как при несостоявшемся старте комнаты
   if (!terminalInformShown) {
-    socketMethods[PS_TECH_INFORM_DATA](
-      isLobbyMode
-        ? 'Host left — the room is closed. Finding another room…'
-        : 'The match is over — connection to the host is closed.',
-    );
+    const notice = decideCloseNotice({
+      isLobbyMode,
+      transportOpened: supervisor?.everOpened === true,
+    });
+
+    if (notice.joinFailed) {
+      roomCtx.startFailed = true;
+    }
+
+    socketMethods[PS_TECH_INFORM_DATA](notice.message);
   }
 
   // в solo перезагружаться некуда: лобби нет, а матч поднимается с нуля
@@ -1804,6 +1850,11 @@ function isSessionPaused() {
 // (зацикленные звуки не должны гудеть одной нотой всю паузу). Рендер не
 // останавливается — кадр стоит, независимые от снапшотов анимации идут
 function handleSessionState(state, prev) {
+  // окно «Leave the game?» не переживает паузу: клавишами владеет она
+  if (state !== SESSION_STATES.inGame) {
+    roomMenu?.closeConfirm();
+  }
+
   if (state === SESSION_STATES.migrating) {
     showSessionOverlay('Switching host…');
     voiceClient?.suspend();
@@ -1848,6 +1899,7 @@ function handleSessionResumed() {
   clientCore?.reset();
   // «Change host?» ведёт мастер — оно паузу переживает
   modules.vote?.removeHostVotes();
+  roomMenu?.closeConfirm();
   modules.controls?.enableKeys();
 
   if (document.visibilityState !== 'hidden') {
@@ -1863,7 +1915,9 @@ function handleResumeRejected(reason) {
   reloadToRoom();
 }
 
-// ссылка на текущую комнату (иначе — на быструю игру той же игры)
+// ссылка на текущую комнату (иначе — на быструю игру той же игры). В ту же
+// комнату — с автовходом: место потеряно, а не покинуто, и форма входа
+// игры после перезагрузки не показывается
 function reloadToRoom() {
   const gameId = activeGameManifest?.id;
 
@@ -1872,11 +1926,29 @@ function reloadToRoom() {
     return;
   }
 
-  reloadPage(
-    roomCtx.roomId
-      ? formatRoomLink(gameId, roomCtx.roomId)
-      : formatGameLink(gameId),
-  );
+  if (roomCtx.roomId) {
+    if (autoRejoin.canMark()) {
+      saveAutoRejoin(
+        sessionStorageOrNull(),
+        { gameId, roomId: roomCtx.roomId },
+        Date.now(),
+      );
+    }
+
+    reloadPage(formatRoomLink(gameId, roomCtx.roomId));
+    return;
+  }
+
+  reloadPage(formatGameLink(gameId));
+}
+
+// sessionStorage или null: доступ к нему бросает, если хранилище запрещено
+function sessionStorageOrNull() {
+  try {
+    return window.sessionStorage;
+  } catch {
+    return null;
+  }
 }
 
 // хост начал рукопожатие заново посреди живой сессии (порт — какой
@@ -1898,8 +1970,8 @@ let lobby = null;
 // storage): две вкладки одного профиля — два участника
 const memberId = isLobbyMode ? crypto.randomUUID() : null;
 
-// меню комнаты внутри матча (этапы 3 и 8d) и защита вкладки хоста от
-// случайного закрытия (этап 8.4): только лобби-режим
+// кнопка Exit внутри матча и защита вкладки хоста от случайного закрытия:
+// только лобби-режим
 let roomMenu = null;
 let unloadGuard = null;
 // любая программная перезагрузка — только через неё (client/lib/pageReload.js)
@@ -1960,7 +2032,7 @@ const hostRole = new HostRole({
   ui: {
     showRoomLink,
     refreshRoomControls,
-    setHandoffMenu: state => roomMenu?.setHandoff(state),
+    setExitStatus: state => roomMenu?.setHandoff(state),
     isHidden: isPageHidden,
     informTech,
     ensureWebRtc: ensureWebRtcAvailable,
@@ -1994,7 +2066,7 @@ const handoff = new HandoffFlow({
     mute: () => soundManager.mute(),
     unmute: () => soundManager.unmute(),
     isHidden: isPageHidden,
-    setHandoffMenu: state => roomMenu?.setHandoff(state),
+    setExitStatus: state => roomMenu?.setHandoff(state),
     sendLeave: () => sending(PC_LEAVE),
     reloadPage,
   },
@@ -2055,39 +2127,50 @@ if (isLobbyMode) {
     roomMenuModel,
     new RoomMenuView(roomMenuModel, lobbyConfig.roomMenu),
     {
-      onLeave: () => handoff.leaveByUser(),
-      onHandover: () => handoff.start({ reason: 'handover', stay: true }),
+      onExit: () => handoff.leaveByUser(),
+      // игровые клавиши молчат, пока окно открыто; при Yes вкладка уходит
+      onConfirmOpen: () => modules.controls?.disableKeys(),
+      // в паузе сессии или замороженной передаче клавиши включит её конец
+      onConfirmClose: () => {
+        if (!handoff.frozen && !isSessionPaused()) {
+          modules.controls?.enableKeys();
+        }
+      },
     },
   );
 
   unloadGuard = new HostUnloadGuard({
     // мастер начинает аварийную миграцию сразу, не дожидаясь обрыва WS
     onHostLeave: () => {
-      if (hostRole.room) {
-        signaling.hostLeaving(hostRole.room.roomId, hostRole.room.epoch);
+      if (!hostRole.room) {
+        return false;
       }
+
+      signaling.hostLeaving(hostRole.room.roomId, hostRole.room.epoch);
+      promotionFlow.markLeaveAnnounced();
+
+      return true;
     },
     // место освобождается сразу, а не через resumeGraceMs
     onGuestLeave: () => handoff.announceGuestLeave(),
   });
 }
 
-// роль вкладки в комнате для меню и защиты закрытия: хост — пока у неё
+// роль вкладки в комнате для защиты закрытия: хост — пока у неё
 // Worker комнаты (и во время промоушена), гость — пока она в комнате
 function refreshRoomControls() {
   const role = !roomCtx.roomId ? null : hostRole.controller ? 'host' : 'guest';
   const othersPresent = role === 'host' && hostRole.peerCount > 0;
 
-  roomMenu?.setRole({
+  unloadGuard?.update({
     role,
     othersPresent,
     hasSuccessor: role === 'host' && hostRole.successorMemberId !== null,
   });
-  unloadGuard?.update({ role, othersPresent });
 }
 
 // адресная строка показывает ссылку на комнату, пока вкладка в ней: её
-// можно скопировать прямо оттуда, как и пунктом меню комнаты
+// можно скопировать прямо оттуда
 function showRoomLink(gameId, roomId) {
   if (!gameId) {
     return;
@@ -2729,6 +2812,7 @@ const route = new RouteBoot({
   connectToRoom: roomId => guest.connectToRoom(roomId),
   createRoom: (room, options) => hostRole.createRoom(room, options),
   fetchServers,
+  autoRejoin,
   ui: {
     initLobby,
     selectLobbyGame: gameId => {

package/src/client/network/HostConnectionManager.js

@@ -30,6 +30,7 @@ export default class HostConnectionManager {
 
     // clientId → { pc, meta, state, voice, openCount, memberId }
     this._peers = new Map();
+    this._destroyed = false;
 
     signaling.publisher.on('webrtc_offer', 'onOffer', this);
     signaling.publisher.on('ice_candidate', 'onRemoteCandidate', this);
@@ -38,6 +39,10 @@ export default class HostConnectionManager {
 
   // приём SDP-оффера клиента: создаёт peer, отвечает answer
   async onOffer(msg) {
+    if (this._destroyed) {
+      return;
+    }
+
     // memberId — id вкладки гостя (переживает реконнект сигналинга);
     // понадобится назначению преемника (host-migration, этап 6)
     const { clientId, sdp, memberId = null } = msg;
@@ -101,11 +106,21 @@ export default class HostConnectionManager {
       return;
     }
 
+    // менеджер уничтожили, пока шло согласование: ответ от закрытого pc
+    // гость принял бы первым и ждал бы мёртвое соединение
+    if (this._destroyed) {
+      return;
+    }
+
     this._signaling.sendAnswer(clientId, pc.localDescription);
   }
 
   // приём ICE-кандидата клиента
   async onRemoteCandidate(msg) {
+    if (this._destroyed) {
+      return;
+    }
+
     const peer = this._peers.get(msg.fromId);
 
     if (!peer) {
@@ -121,6 +136,10 @@ export default class HostConnectionManager {
 
   // сигнальный ping клиента из лобби → pong (замер приблизительный)
   onPing(msg) {
+    if (this._destroyed) {
+      return;
+    }
+
     this._signaling.pongHost(msg.clientId, msg.pingId);
   }
 
@@ -282,8 +301,15 @@ export default class HostConnectionManager {
     return this._peers.size;
   }
 
-  // закрывает все соединения (закрытие комнаты)
+  // закрывает соединения и снимает подписки сигналинга (снятие роли
+  // хоста): брошенный менеджер иначе отвечал бы на офферы следующей роли.
+  // Флаг — страховка от события, разосланного в том же emit
   destroy() {
+    this._destroyed = true;
+    this._signaling.publisher.off('webrtc_offer', 'onOffer', this);
+    this._signaling.publisher.off('ice_candidate', 'onRemoteCandidate', this);
+    this._signaling.publisher.off('ping_host', 'onPing', this);
+
     for (const clientId of [...this._peers.keys()]) {
       this._closePeer(clientId);
     }

package/src/client/network/HostController.js

@@ -109,9 +109,6 @@ export default class HostController {
 
     this._voiceRelay = new VoiceRelay();
 
-    // ожидание границы раунда плановой передачей (host-migration этап 8d)
-    this._roundBoundaryCallback = null;
-
     // подписчики готовых контрольных точек (host-migration этап 5)
     this._checkpointListeners = new Set();
     // период включённых периодических точек (null — выключены): новый Worker
@@ -421,24 +418,6 @@ export default class HostController {
     return () => this._healthListeners.delete(cb);
   }
 
-  /**
-   * Плановая передача хоста (host-migration этап 8d): cb сработает на
-   * ближайшей границе раунда — у игры с migration.midRound сразу (решает
-   * Worker). Новый вызов заменяет прежний колбэк.
-   * @param {Function} cb
-   */
-  awaitRoundBoundary(cb) {
-    this._roundBoundaryCallback = cb;
-    this._worker.postMessage({ type: 'round_boundary_wait' });
-  }
-
-  cancelRoundBoundary() {
-    if (this._roundBoundaryCallback) {
-      this._roundBoundaryCallback = null;
-      this._worker.postMessage({ type: 'round_boundary_cancel' });
-    }
-  }
-
   // заморозка матча: цикл и отсчёты встают с остатками
   freeze() {
     this._worker.postMessage({ type: 'freeze' });
@@ -580,7 +559,7 @@ export default class HostController {
       return Promise.resolve();
     }
 
-    // повторный вызов (второй клик «Leave server») — тот же промис: второй
+    // повторный вызов (второй Exit) — тот же промис: второй
     // HostGame.destroy() поверх идущего повторил бы flush (двойной зачёт)
     if (this._shutdownPromise) {
       return this._shutdownPromise;
@@ -816,14 +795,6 @@ export default class HostController {
         this._onHandoffState(msg.state);
         break;
 
-      case 'round_boundary': {
-        const cb = this._roundBoundaryCallback;
-
-        this._roundBoundaryCallback = null;
-        cb?.();
-        break;
-      }
-
       case 'checkpoint': {
         const checkpoint = { ...msg };