vimp-engine 0.39.0 → 0.41.0

package/src/client/main.js

@@ -35,11 +35,10 @@ import {
   bindLiveErrors,
 } from './lib/formBuilder.js';
 import { normalizeAuthParams } from './lib/authParams.js';
-import { renderDocsLink } from './lib/footerLink.js';
 import { createGameActivator } from './lib/gameActivator.js';
 import createAutostart from './lib/autostart.js';
 import { applyCatalogState } from './lib/catalogState.js';
-import { getBootConfig, resolveBootConfig } from './boot.js';
+import { resolveBootConfig } from './boot.js';
 import {
   ensureGameShell,
   ensureCanvas,
@@ -67,7 +66,6 @@ import { validateAuth } from '../lib/validators.js';
 import SoundManager from './SoundManager.js';
 import SignalingClient from './network/SignalingClient.js';
 import LoopbackTransport from './network/LoopbackTransport.js';
-import WebSocketTransport from './network/WebSocketTransport.js';
 import InlineHostBridge from './network/InlineHostBridge.js';
 import SessionSupervisor, {
   SESSION_STATES,
@@ -83,11 +81,7 @@ import {
 import { createVerifier, challengeOf } from './lib/pkce.js';
 import { createTurnstile } from './lib/turnstile.js';
 import TokenRenewer from './network/TokenRenewer.js';
-import {
-  isKickClose,
-  POLICY_CLOSE_INFORMS,
-  shouldReloadAfterClose,
-} from './network/policyClose.js';
+import { isKickClose } from './network/policyClose.js';
 import LobbyModel from './components/model/Lobby.js';
 import LobbyView from './components/view/Lobby.js';
 import LobbyCtrl from './components/controller/Lobby.js';
@@ -145,8 +139,8 @@ import runHotTick from './lib/hotTick.js';
 
 // Динамическая загрузка игры по каталогу мастера (Этап 6.3): ClientPlugin
 // (parts, bakers, игровой CSS, хуки ядра) грузится по entries.client манифеста
-// — движок не импортирует игру статически. Первой активируется gamesManifest[0]
-// (или boot.gameId), но активная игра не заморожена: выбор в #lobby-game и
+// — движок не импортирует игру статически. Первой активируется первая
+// доступная игра каталога, но активная игра не заморожена: выбор в #lobby-game и
 // вход в чужую комнату переключают её через gameActivator (см. bindActiveGame).
 // Переключение безопасно ровно до старта матча: всё пер-игровое состояние
 // (Factory, Pixi-приложения, clientCore, звук) появляется только в CONFIG_DATA,
@@ -179,37 +173,24 @@ function bindActiveGame(manifest, plugin) {
 }
 
 // режим загрузки (Этап 2 плана standalone-sdk): lobby — прод с мастером,
-// solo — хост в этой же вкладке (standalone SDK), dedicated — прямой WS к
-// Node-серверу. Ветвлений ровно пять: манифест, сигналинг/лобби, транспорт,
-// авто-аутентификация и точка монтирования канвасов.
-//
-// каталог манифестов нужен только лобби-контуру, а его запрос не зависит от
-// ответа /config — пускаем оба в полёт разом, иначе старт лобби платит лишний
-// последовательный round-trip
-const injectedBoot = getBootConfig();
-const manifestPromise = injectedBoot
-  ? null
-  : fetchGamesManifest(lobbyConfig.gamesManifestUrl, (...args) =>
-      fetchRetrying(fetch, ...args),
-    ).catch(err => err);
-
-let boot;
-
-try {
-  boot = injectedBoot ?? (await resolveBootConfig());
-} catch (e) {
-  // сети нет и режим неизвестен: репортёр ещё не создан (ему нужен режим),
-  // игроку остаётся надпись отказа
-  showBootFailure(`Failed to load the game: ${e.message}`);
-  throw e;
-}
-
+// solo — хост в этой же вкладке (standalone SDK). Ветвлений ровно пять:
+// манифест, сигналинг/лобби, транспорт, авто-аутентификация и точка
+// монтирования канвасов.
+const boot = resolveBootConfig();
 const bootMode = boot.mode;
 const isLobbyMode = bootMode === 'lobby';
 
+// каталог манифестов нужен только лобби-контуру: запрос уходит до создания
+// журнала и каркаса, а ждут его только в загрузке игры ниже
+const manifestPromise = isLobbyMode
+  ? fetchGamesManifest(lobbyConfig.gamesManifestUrl, (...args) =>
+      fetchRetrying(fetch, ...args),
+    ).catch(err => err)
+  : null;
+
 // журнал клиентских ошибок: ставится как можно
-// раньше, чтобы ловить и сбои самого старта. Лобби и dedicated шлют на
-// свой бокс; SDK (solo) — только если встраивающий передал reportUrl
+// раньше, чтобы ловить и сбои самого старта. Лобби шлёт на свой бокс;
+// SDK (solo) — только если встраивающий передал reportUrl
 const diagnostics = createDiagnostics({
   url:
     bootMode === 'solo'
@@ -258,7 +239,7 @@ try {
 
     try {
       // недоступная игра активной быть не может (lib/pickActiveGame.js)
-      activeGameManifest = pickActiveGame(gamesManifest, boot.gameId);
+      activeGameManifest = pickActiveGame(gamesManifest);
       syncDiagnosticsGame();
     } catch (e) {
       // «каталог непустой, но играбельного в нём нет» (движок обновили, все
@@ -266,7 +247,7 @@ try {
       // лобби это то же самое, что пустой каталог: играть не во что, но
       // модерация и заявка на месте, и только они это чинят. Терять их из-за
       // такого нельзя, поэтому причина едет строкой отказа лобби, а не
-      // терминальным оверлеем. В solo/dedicated отказ остаётся отказом
+      // терминальным оверлеем. В solo отказ остаётся отказом
       if (!isLobbyMode) {
         throw e;
       }
@@ -278,7 +259,7 @@ try {
   // пустой каталог — состояние лобби, а не отказ загрузки: модератор вправе
   // отключить последнюю игру, реестр вправе ещё ничего не одобрить, и вернуть
   // каталог к жизни можно только из панели, которая живёт в этой же вкладке.
-  // В solo/dedicated игры нет — это отказ: там весь смысл вкладки в матче
+  // В solo игры нет — это отказ: там весь смысл вкладки в матче
   if (!activeGameManifest && !isLobbyMode) {
     throw new Error('master has no games in its catalog');
   }
@@ -338,7 +319,7 @@ const PC_LEAVE = wsports.client.LEAVE;
 
 // сигнальный WebSocket мастера (лобби + установка P2P); игровой трафик идёт
 // по WebRTC (transport), не через мастер
-// (только lobby: solo и dedicated мастера не имеют вовсе)
+// (только lobby: у solo мастера нет вовсе)
 const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
 const signaling = isLobbyMode
   ? new SignalingClient(`${wsProtocol}//${location.host}/`)
@@ -346,7 +327,7 @@ const signaling = isLobbyMode
 
 // супервизор сессии (host-migration этап 4): держит текущий транспорт к
 // хосту и переживает его обрыв — переподключается и возвращает место в
-// матче. Создаётся при входе в комнату (или в solo/dedicated-матч)
+// матче. Создаётся при входе в комнату (или в solo-матч)
 let supervisor = null;
 
 // оверлей «Reconnecting…» на время переподключения (только лобби-режим)
@@ -406,7 +387,7 @@ const GAME_ROUND_START_CODE = GAME_CODES.roundStart[0];
 // соединения важнее общего сообщения handleDisconnect
 let terminalInformShown = false;
 // ключ последнего терминального tech-кода: по нему лобби-режим отличает кик
-// (policyClose.isKickClose) от закрытия комнаты — в P2P кода закрытия нет
+// (policyClose.isKickClose) от закрытия комнаты — у транспортов кода закрытия нет
 let terminalTechKey = null;
 // снятие предыдущего animationend-листенера логотипа при повторном
 // playLogoRoundStart — иначе листенеры копятся при частых стартах раунда
@@ -618,9 +599,9 @@ socketMethods[PS_AUTH_DATA] = data => {
 
   document.getElementById('logo').textContent = texts?.title || 'VIMP';
 
-  // футер формы входа: версия пакета ИГРЫ и (в dev-сборке) ссылка на
-  // документацию. Здесь, а не в AuthView: его elems приходят из
-  // authSchema.elems игрового плагина, и футер каркаса — не его забота.
+  // футер формы входа: версия пакета ИГРЫ. Здесь, а не в AuthView: его
+  // elems приходят из authSchema.elems игрового плагина, и футер каркаса —
+  // не его забота.
   // Версию кладёт в манифест мастер (GameCatalog читает package.json
   // пакета); в standalone-манифесте её может не быть — тогда ячейка пустая,
   // раскладку space-between это не ломает
@@ -630,8 +611,6 @@ socketMethods[PS_AUTH_DATA] = data => {
     authVersion.textContent = activeGameManifest?.packageVersion ?? '';
   }
 
-  renderDocsLink(document.getElementById('auth-docs-link'), isDevBuild);
-
   // память клиента (localStorage) + принудительное значение поля с
   // единственным вариантом. Здесь, а не в AuthView: solo-путь ниже отвечает
   // хосту вообще без формы и обязан прийти к тем же значениям
@@ -987,7 +966,7 @@ socketMethods[PS_GAME_INFORM_DATA] = data => {
 
 // проигрывает shimmer-волну по логотипу в начале раунда; логотип живёт вне
 // PanelView.containerId, поэтому панель им не управляет
-// (см. docs.vimp.lgick.dev/en/client-api)
+// (см. VIMP docs: client-api.md)
 const playLogoRoundStart = () => {
   const logo = document.getElementById('logo');
 
@@ -1066,6 +1045,10 @@ socketMethods[PS_CLEAR] = function (setIdList) {
     }
   }
 
+  // личное меню и подсказки прошлого раунда гаснут; ядро игры зажжёт
+  // подсказку заново при спавне
+  modules.vote?.clearPersonal();
+
   clientCore?.reset();
   soundManager.reset();
 };
@@ -1672,10 +1655,8 @@ function handleMessage(data) {
 
 // терминальное закрытие сессии (супервизор: возвращаться некуда — кик,
 // политика, уход хоста, окно переподключения истекло). Останавливаем
-// рендер, показываем заглушку и возвращаемся в лобби перезагрузкой.
-// closeCode приходит только от WebSocket-транспорта (dedicated), остальные
-// транспорты эмитят close без него
-function handleDisconnect(closeCode) {
+// рендер, показываем заглушку и возвращаемся в лобби перезагрузкой
+function handleDisconnect() {
   showSessionOverlay(null);
 
   // app.stop() здесь не зовём: при sharedTicker это Ticker.shared.stop()
@@ -1729,31 +1710,18 @@ function handleDisconnect(closeCode) {
   inlineHost?.destroy();
   inlineHost = null;
 
-  // запасной текст политического отказа: если сервер прислал причину сам
-  // (TECH_INFORM перед закрытием — так приезжает 4006, полная комната), ниже
-  // не пишется вообще ничего, и побеждает серверный текст
-  const policyInform = POLICY_CLOSE_INFORMS[closeCode];
-
-  // терминальную причину закрытия (кик, полная комната) не затираем
+  // терминальную причину закрытия (кик, полная комната — TECH_INFORM перед
+  // закрытием) не затираем
   if (!terminalInformShown) {
     socketMethods[PS_TECH_INFORM_DATA](
-      policyInform ??
-        (isLobbyMode
-          ? 'Host left — the room is closed. Finding another room…'
-          : 'The match is over — connection to the host is closed.'),
+      isLobbyMode
+        ? 'Host left — the room is closed. Finding another room…'
+        : 'The match is over — connection to the host is closed.',
     );
   }
 
-  // в solo перезагружаться некуда: лобби нет, а матч поднимается с нуля.
-  // В dedicated сервер жив — переподключение перезагрузкой уместно, но не
-  // тогда, когда он сам нас и отбил по политике (network/policyClose.js)
-  if (bootMode === 'solo' || !shouldReloadAfterClose(closeCode)) {
-    return;
-  }
-
+  // в solo перезагружаться некуда: лобби нет, а матч поднимается с нуля
   if (!isLobbyMode) {
-    setTimeout(() => reloadPage(), 3000);
-
     return;
   }
 
@@ -1763,7 +1731,7 @@ function handleDisconnect(closeCode) {
   // — на главную без перезагрузки (причина остаётся в #tech-informer, клик
   // по нему открывает лобби); закрытие комнаты — в быструю игру той же игры
   const exit = decideExitRoute({
-    kicked: isKickClose(closeCode, terminalTechKey) || roomCtx.startFailed,
+    kicked: isKickClose(terminalTechKey) || roomCtx.startFailed,
     gameId: activeGameManifest?.id,
   });
 
@@ -1803,10 +1771,9 @@ function startSession(transport, reconnect = null) {
     onResumeRejected: handleResumeRejected,
     onHostLost: reportHostUnreachable,
     onColdRestart: handleColdRestart,
-    // кик (TECH_INFORM перед закрытием) и отказы политики не лечатся
+    // кик и полная комната (TECH_INFORM перед закрытием) не лечатся
     // переподключением
-    isTerminalClose: closeCode =>
-      terminalInformShown || !shouldReloadAfterClose(closeCode),
+    isTerminalClose: () => terminalInformShown,
     reconnect,
     timing: lobbyConfig.session,
   });
@@ -2221,14 +2188,6 @@ async function connectSolo() {
   transport.connect();
 }
 
-// dedicated-режим: прямой WebSocket к Node-серверу игры
-function connectDedicated() {
-  const transport = new WebSocketTransport(boot.wsUrl);
-
-  startSession(transport);
-  transport.connect();
-}
-
 // REST-запрос списка серверов у мастера (поиск игнорирует пагинацию)
 async function fetchServers({ offset, limit, search }) {
   const params = new URLSearchParams();
@@ -2317,7 +2276,7 @@ let roomFormFields = new Map();
 let roomFormDescriptors = [];
 
 // генерирует форму создания комнаты по явной схеме манифеста (roomForm,
-// docs.vimp.lgick.dev/en/plugin-api "Form schema") — движок не выводит контролы
+// VIMP docs: plugin-api.md § "Form schema") — движок не выводит контролы
 // из типа значения, схема плагина полностью описывает форму
 function populateRoomForm(manifest) {
   const container = document.getElementById(lobbyConfig.elems.fieldsId);
@@ -2705,7 +2664,7 @@ function initLobby() {
     // валидация (pattern/required/min/max) — единственная граница
     // room-формы: она едет клиенту как JSON манифеста, JS-валидаторы
     // (как в auth-форме) туда не сериализуются
-    // (docs.vimp.lgick.dev/en/plugin-api "Form schema"); авторитетный клампинг
+    // (VIMP docs: plugin-api.md § "Form schema"); авторитетный клампинг
     // всё равно в applyRoomOverrides.js (вызывается из host.worker.js при
     // создании комнаты). Проверяем до активации игры: неверная форма не должна
     // стоить загрузки плагина. arm() и рисует ошибки, и снимает фильтр «только
@@ -2813,7 +2772,7 @@ function leaveRoomWith(message) {
 }
 
 // точка 2 ветвления: лобби, экран профиля и сигналинг живут только в lobby;
-// solo и dedicated идут сразу к транспорту
+// solo идёт сразу к транспорту
 if (isLobbyMode) {
   authApi = createAuthApi({ serviceUrl: authClientConfig.serviceUrl });
 
@@ -2956,7 +2915,7 @@ if (isLobbyMode) {
   window.addEventListener('hashchange', () => route.handleHashChange());
 
   signaling.connect();
-} else if (bootMode === 'solo') {
+} else {
   try {
     await connectSolo();
   } catch (e) {
@@ -2965,6 +2924,4 @@ if (isLobbyMode) {
     );
     throw e;
   }
-} else {
-  connectDedicated();
 }

package/src/client/network/SessionSupervisor.js

@@ -52,8 +52,8 @@ export default class SessionSupervisor {
    * @param {Object} opts
    * @param {Function} opts.onMessage - входящее сообщение текущего
    *   транспорта (строка или ArrayBuffer).
-   * @param {Function} opts.onTerminal - (closeCode) сессия закрыта
-   *   окончательно: путь прежнего handleDisconnect.
+   * @param {Function} opts.onTerminal - сессия закрыта окончательно
+   *   (handleDisconnect).
    * @param {Function} [opts.onVoice] - (data) голосовой пакет текущего
    *   транспорта в состоянии inGame (бинарный, без разбора).
    * @param {Function} [opts.onStateChange] - (state, prev).
@@ -63,10 +63,10 @@ export default class SessionSupervisor {
    *   матче (до переподключения): свидетельство мастеру (host_unreachable).
    * @param {Function} [opts.onColdRestart] - новый хост поднял матч заново
    *   (host_changed cold): возобновлять нечего, только чистый вход.
-   * @param {Function} [opts.isTerminalClose] - (closeCode) закрытие по
-   *   политике или кику: возвращаться некуда.
+   * @param {Function} [opts.isTerminalClose] - () закрытие после
+   *   терминальной причины (кик, полная комната): возвращаться некуда.
    * @param {Object|null} [opts.reconnect] - null — переподключения нет
-   *   (solo, dedicated, вкладка-хост на loopback). Иначе:
+   *   (solo, вкладка-хост на loopback). Иначе:
    *   { createTransport() → новый транспорт с resume (уже connect'нутый),
    *     getToken() → identity-токен для RESUME_REQUEST }.
    * @param {Object} [opts.timing] - { reconnectWindowMs, reconnectBaseDelayMs,
@@ -493,7 +493,7 @@ export default class SessionSupervisor {
     const handlers = {
       message: data => this._handleMessage(transport, data),
       voice: data => this._handleVoice(transport, data),
-      close: closeCode => this._handleClose(transport, closeCode),
+      close: () => this._handleClose(transport),
       open: () => this._handleOpen(transport),
     };
 
@@ -573,7 +573,7 @@ export default class SessionSupervisor {
     }
   }
 
-  _handleClose(transport, closeCode) {
+  _handleClose(transport) {
     if (transport !== this._transport) {
       return;
     }
@@ -590,7 +590,7 @@ export default class SessionSupervisor {
       // транспорт, выданный resumeWith без фабрики попыток: повторять нечем
       if (this._reconnect === null) {
         if (!this._failRoleResume('closed')) {
-          this._terminate(closeCode);
+          this._terminate();
         }
 
         return;
@@ -600,23 +600,23 @@ export default class SessionSupervisor {
       return;
     }
 
-    if (this._canResume(closeCode)) {
+    if (this._canResume()) {
       this._startReconnect();
       return;
     }
 
-    this._terminate(closeCode);
+    this._terminate();
   }
 
   // нетерминальным бывает только обрыв посреди матча, у которого есть место
   // для возврата и кому возвращаться
-  _canResume(closeCode) {
+  _canResume() {
     return (
       this._reconnect !== null &&
       !this._userLeft &&
       this._state === S.inGame &&
       this._session !== null &&
-      !this._isTerminalClose(closeCode)
+      !this._isTerminalClose()
     );
   }
 
@@ -728,7 +728,7 @@ export default class SessionSupervisor {
 
   // ***** завершение ***** //
 
-  _terminate(closeCode) {
+  _terminate() {
     if (this._state === S.closed) {
       return;
     }
@@ -738,7 +738,7 @@ export default class SessionSupervisor {
     this._clearMigrationTimer();
     this._onRoleResumeFailed = null;
     this._setState(S.closed);
-    this._onTerminal(closeCode);
+    this._onTerminal();
   }
 
   _setState(state) {

package/src/client/network/WebRtcManager.js

@@ -493,8 +493,7 @@ export default class WebRtcManager {
     channel.onmessage = event => this.publisher.emit('voice', event.data);
   }
 
-  // кода закрытия у data channel нет: 'close' эмитится без аргумента, как
-  // и раньше (код приходит только от WebSocket-транспорта dedicated)
+  // кода закрытия у data channel нет: 'close' эмитится без аргумента
   _emitClose() {
     if (this._closed) {
       return;

package/src/client/network/policyClose.js

@@ -1,84 +1,17 @@
-// Отказы по политике: коды закрытия, которыми dedicated-сервер отбивает
-// соединение (`src/dedicated/main.js` — invalidOrigin, handshakeTimeout,
-// tooManyConnections) и которыми порт-машина отбивает полную комнату
-// (`src/host/PortMachine.js` — roomFull). Числа берутся из общей карты
-// `src/config/closeCodes.js`, чтобы серверные контуры и клиент не разъехались
-// молча; тест модуля требует явного решения по каждому коду карты.
-//
-// Клиенту от кода нужны два разных ответа, и совпадают они не всегда, поэтому
-// знание разведено на два экспорта (review-4.md, R4-2):
-//
-//   - перезагружаться ли. Ни на одном из этих кодов перезагрузка не помогает:
-//     лимит частоты подключений съел бы ей же очередное соединение, таймаут
-//     хендшейка запустился бы заново, origin страницы не меняется вовсе, а
-//     слот в полной комнате перезагрузка не освобождает. Брошенная вкладка
-//     перезагружалась бы вечно, а ждущий слот игрок за 30 витков сам упёрся бы
-//     в лимит подключений и получил бы чужую причину отказа;
-//   - какой текст показать. Тексты запасные: `handleDisconnect` берёт их
-//     только тогда, когда сервер причину не прислал сам (`terminalInformShown`
-//     — `client/main.js`). Полная комната, например, приезжает с причиной от
-//     порт-машины (TECH_INFORM перед `close`), и она всегда побеждает —
-//     запись 4006 ниже отработает, только если тот кадр не доехал. Тексты
-//     здесь, а не в `techInformList`: список переопределяет игра, и движковый
-//     индекс дал бы у неё «Unknown error».
-
-import closeCodes from '../../config/closeCodes.js';
-
-const {
-  invalidOrigin,
-  roomFull,
-  handshakeTimeout,
-  tooManyConnections,
-  kickIdle,
-  kickForMaxLatency,
-  kickForMissedPings,
-} = closeCodes;
-
-const NO_RELOAD_CLOSE_CODES = new Set([
-  invalidOrigin,
-  roomFull,
-  handshakeTimeout,
-  tooManyConnections,
-]);
-
-export const POLICY_CLOSE_INFORMS = {
-  [invalidOrigin]:
-    'This page is not allowed by the game server. Check the address you opened.',
-  [roomFull]: 'The room is full. Try again later.',
-  [handshakeTimeout]:
-    'Idle connection closed before the match started. Reload the page when you are ready to play.',
-  [tooManyConnections]:
-    'Too many connections from your address. Wait a minute and reload the page.',
-};
-
-/**
- * @param {number} [closeCode] - Код закрытия транспорта. Его отдаёт только
- *   WebSocket-транспорт (dedicated); в P2P и solo кода нет вовсе.
- * @returns {boolean} Уместна ли перезагрузка страницы после разрыва.
- */
-export function shouldReloadAfterClose(closeCode) {
-  return !NO_RELOAD_CLOSE_CODES.has(closeCode);
-}
-
-// Кики хоста (host/HostGame.js). В P2P кода закрытия нет вовсе — причина
-// приезжает только TECH_INFORM-ключом перед закрытием (индексы
-// TECH_CODES из host/meta/SocketManager.js = индексы techInformList);
-// в dedicated есть и код. Лобби-режим уводит кикнутого на главную без
-// перезагрузки (client/lib/roomLink.js decideExitRoute): быстрая игра по
-// hash вернула бы его в ту же комнату
-const KICK_CLOSE_CODES = new Set([
-  kickIdle,
-  kickForMaxLatency,
-  kickForMissedPings,
-]);
-
+// Кики хоста (host/HostGame.js). Кода закрытия у транспортов клиента нет —
+// причина приезжает только TECH_INFORM-ключом перед закрытием (индексы
+// TECH_CODES из host/meta/SocketManager.js = индексы techInformList).
+// Лобби-режим уводит кикнутого на главную без перезагрузки
+// (client/lib/roomLink.js decideExitRoute): быстрая игра по hash вернула бы
+// его в ту же комнату.
+
+// kickIdle, kickForMaxLatency, kickForMissedPings
 export const KICK_TECH_KEYS = new Set([3, 4, 5]);
 
 /**
- * @param {number} [closeCode] - Код закрытия транспорта (только WebSocket).
  * @param {number|null} [techKey] - Последний терминальный TECH_INFORM-ключ.
  * @returns {boolean} Закрыто ли соединение киком хоста.
  */
-export function isKickClose(closeCode, techKey) {
-  return KICK_CLOSE_CODES.has(closeCode) || KICK_TECH_KEYS.has(techKey);
+export function isKickClose(techKey) {
+  return KICK_TECH_KEYS.has(techKey);
 }