vimp-engine 0.37.1 → 0.38.1

package/src/client/lib/turnstile.js

@@ -0,0 +1,130 @@
+// Cloudflare Turnstile на регистрации: ленивая загрузка скрипта, один
+// виджет, токен на одну отправку формы. Без сети в тестах: документ, окно и
+// таймеры инъектируются.
+
+// code: 'blocked' — скрипт или виджет недоступны (блокировщик, ошибка
+// виджета); 'expired' — проверка истекла, не дождавшись игрока
+function turnstileError(code) {
+  const error = new Error(`Turnstile ${code}`);
+
+  error.code = code;
+
+  return error;
+}
+
+const blockedError = () => turnstileError('blocked');
+
+/**
+ * @param {Object} options
+ * @param {string} options.scriptUrl
+ * @param {number} options.loadTimeoutMs
+ * @param {string} options.action
+ * @param {Document} [options.doc]
+ * @param {Window} [options.win]
+ * @param {Object} [options.timers] - { setTimeout, clearTimeout } (тесты).
+ */
+export function createTurnstile({
+  scriptUrl,
+  loadTimeoutMs,
+  action,
+  doc = document,
+  win = window,
+  timers = globalThis,
+}) {
+  let widgetId = null;
+  // виджет уже отдавал токен: перед следующим execute нужен reset
+  let used = false;
+  // текущий getToken: виджет создаётся один раз, а его callback'и должны
+  // завершать именно ожидающий вызов, не первый
+  let pending = null;
+
+  // скрипт подгружается при первом обращении; отказ (error, таймаут, нет
+  // win.turnstile после load) убирает элемент — Retry загрузит его заново
+  function loadScript() {
+    if (win.turnstile) {
+      return Promise.resolve();
+    }
+
+    return new Promise((resolve, reject) => {
+      const script = doc.createElement('script');
+      let timer = null;
+
+      const fail = () => {
+        timers.clearTimeout(timer);
+        script.remove();
+        reject(blockedError());
+      };
+
+      timer = timers.setTimeout(fail, loadTimeoutMs);
+
+      script.addEventListener('load', () => {
+        if (!win.turnstile) {
+          fail();
+          return;
+        }
+
+        timers.clearTimeout(timer);
+        resolve();
+      });
+      script.addEventListener('error', fail);
+
+      script.src = scriptUrl;
+      script.async = true;
+      doc.head.appendChild(script);
+    });
+  }
+
+  return {
+    // токен на одну отправку формы; отказ — Error с полем code = 'blocked'
+    async getToken(container, siteKey) {
+      await loadScript();
+
+      return new Promise((resolve, reject) => {
+        pending = { resolve, reject };
+
+        if (widgetId === null) {
+          widgetId = win.turnstile.render(container, {
+            sitekey: siteKey,
+            action,
+            execution: 'execute',
+            appearance: 'interaction-only',
+            callback: token => {
+              used = true;
+              pending?.resolve(token);
+            },
+            'error-callback': () => {
+              // после ошибки виджету нужен reset перед следующим execute
+              used = true;
+              pending?.reject(blockedError());
+              return true;
+            },
+            // проверка истекла, пока игрок не ответил: без этого getToken
+            // не завершился бы и форма осталась заблокированной
+            'timeout-callback': () => {
+              used = true;
+              pending?.reject(turnstileError('expired'));
+            },
+            'expired-callback': () => {
+              used = true;
+              pending?.reject(turnstileError('expired'));
+            },
+          });
+        } else if (used) {
+          win.turnstile.reset(widgetId);
+          used = false;
+        }
+
+        // срока ожидания нет: интерактивная проверка может ждать клика
+        win.turnstile.execute(container);
+      });
+    },
+
+    // токен израсходован сервером: следующая отправка получит новый
+    reset() {
+      if (widgetId !== null) {
+        win.turnstile.reset(widgetId);
+        used = false;
+      }
+    },
+  };
+}

package/src/client/main.js

@@ -69,6 +69,14 @@ import SessionSupervisor, {
 import FpsMeter from './lib/FpsMeter.js';
 import HostUnloadGuard from './lib/hostUnloadGuard.js';
 import { createPageReload } from './lib/pageReload.js';
+import { createAuthApi } from './lib/authApi.js';
+import {
+  decideSessionStorageChange,
+  decideStoredSession,
+} from './lib/sessionSync.js';
+import { createVerifier, challengeOf } from './lib/pkce.js';
+import { createTurnstile } from './lib/turnstile.js';
+import TokenRenewer from './network/TokenRenewer.js';
 import {
   isKickClose,
   POLICY_CLOSE_INFORMS,
@@ -78,11 +86,14 @@ import LobbyModel from './components/model/Lobby.js';
 import LobbyView from './components/view/Lobby.js';
 import LobbyCtrl from './components/controller/Lobby.js';
 import LobbyAuthModel from './components/model/LobbyAuth.js';
+import ProfileModel from './components/model/Profile.js';
 import LobbyAuthView from './components/view/LobbyAuth.js';
 import LobbyAuthCtrl from './components/controller/LobbyAuth.js';
 import GamesModel from './components/model/Games.js';
 import GamesView from './components/view/Games.js';
 import GamesCtrl from './components/controller/Games.js';
+import ProfileView from './components/view/Profile.js';
+import ProfileCtrl from './components/controller/Profile.js';
 import { createRoomContext } from './session/roomContext.js';
 import { createHostRoomPrep } from './session/hostRoomPrep.js';
 import Membership from './session/Membership.js';
@@ -274,7 +285,6 @@ const PS_FIRST_SHOT_DATA = wsports.server.FIRST_SHOT_DATA;
 const PS_SOUND_DATA = wsports.server.SOUND_DATA;
 const PS_GAME_INFORM_DATA = wsports.server.GAME_INFORM_DATA;
 const PS_TECH_INFORM_DATA = wsports.server.TECH_INFORM_DATA;
-const PS_MISC = wsports.server.MISC;
 const PS_PING = wsports.server.PING;
 const PS_CLEAR = wsports.server.CLEAR;
 const PS_CONSOLE = wsports.server.CONSOLE;
@@ -290,6 +300,7 @@ const PS_RESUME_RESULT = wsports.server.RESUME_RESULT;
 // PC (client ports): порты получения данных от клиента
 const PC_CONFIG_READY = wsports.client.CONFIG_READY;
 const PC_AUTH_RESPONSE = wsports.client.AUTH_RESPONSE;
+const PC_TOKEN_REFRESH = wsports.client.TOKEN_REFRESH;
 const PC_MODULES_READY = wsports.client.MODULES_READY;
 const PC_MAP_READY = wsports.client.MAP_READY;
 const PC_FIRST_SHOT_READY = wsports.client.FIRST_SHOT_READY;
@@ -978,15 +989,6 @@ socketMethods[PS_TECH_INFORM_DATA] = data => {
   }
 };
 
-// misc
-socketMethods[PS_MISC] = data => {
-  const { key, value } = data;
-
-  if (key === 'localstorageNameReplace') {
-    localStorage['userName'] = value;
-  }
-};
-
 // ping
 socketMethods[PS_PING] = pingId => {
   sending(PC_PONG, pingId, false);
@@ -1909,7 +1911,7 @@ const guest = new GuestSession({
   getPromotion: () => promotionFlow,
   getSupervisor,
   getToken,
-  logout: () => lobbyAuthModel.logout(),
+  refreshIdentity: () => lobbyAuthModel.refresh(),
   config: lobbyConfig,
   diagnostics,
   ui: {
@@ -2471,8 +2473,8 @@ function initLobby() {
   const games = new GamesCtrl(gamesModel, gamesView);
 
   // кнопку «Moderation» лобби показывает роли admin (master-game-registry,
-  // этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
-  // запись — auth-сервис, перечитывая роль из БД
+  // этап 4). Это подсказка интерфейсу: права админа auth-сервис проверяет
+  // сам, по нику из VIMP_ADMIN_NICKS
   games.setAdmin(lobbyAuthModel.getRole() === 'admin');
 
   // журнал клиентских ошибок (plan/client-reports, этап 5): кнопку «Errors»
@@ -2493,6 +2495,17 @@ function initLobby() {
   clientReportsView.setGames([...gamesById.values()]);
   clientReports.setAdmin(lobbyAuthModel.getRole() === 'admin');
 
+  // панель профиля: привязка аккаунта, выход, выгрузка данных, удаление
+  const profileModel = new ProfileModel(lobbyConfig.profile, {
+    auth: lobbyAuthModel,
+    api: authApi,
+  });
+  const profileView = new ProfileView(profileModel, lobbyConfig.profile);
+  const profile = new ProfileCtrl(profileModel, profileView);
+
+  // выход и удаление меняют личность вкладки — только перезагрузкой
+  profile.publisher.on('left', () => reloadPage());
+
   // «Test»: манифест застейдженной версии кладётся в каталог вкладки, и
   // админ поднимает по нему комнату обычной кнопкой Create server
   games.publisher.on('staged', ({ manifest }) => {
@@ -2595,13 +2608,21 @@ function initLobby() {
   });
 
   lobby.open();
+
+  // вкладка вернулась от провайдера: итог привязки показывает панель
+  const linkResult = profileModel.takeLinkResult();
+
+  if (linkResult) {
+    profile.openWithLinkResult(linkResult);
+  }
 }
 
-// логин лобби (Этап B2): central auth-сервис выдаёт JWT, лобби открывается
-// только после успешной авторизации (глобальный ник вместо свободного ввода
-// в игре). Не зависит от сигнального сокета мастера — читает query string
-// (OAuth-редирект) и localStorage независимо от 'welcome'
+// экран профиля: central auth-сервис выдаёт JWT по сессии устройства, лобби
+// открывается только когда у вкладки есть личность (профиль с глобальным
+// ником). Не зависит от сигнального сокета мастера — читает query string
+// (возврат с OAuth) и localStorage независимо от 'welcome'
 let lobbyAuthModel = null;
+let authApi = null;
 let lobbyAuthView = null;
 
 let welcomeReceived = false;
@@ -2656,13 +2677,31 @@ function leaveRoomWith(message) {
   }
 }
 
-// точка 2 ветвления: лобби, OAuth-гейт и сигналинг живут только в lobby;
+// точка 2 ветвления: лобби, экран профиля и сигналинг живут только в lobby;
 // solo и dedicated идут сразу к транспорту
 if (isLobbyMode) {
-  lobbyAuthModel = new LobbyAuthModel(authClientConfig);
+  authApi = createAuthApi({ serviceUrl: authClientConfig.serviceUrl });
+
+  lobbyAuthModel = new LobbyAuthModel(authClientConfig, {
+    api: authApi,
+    pkce: { createVerifier, challengeOf },
+    isDev: isDevBuild,
+  });
   lobbyAuthView = new LobbyAuthView(lobbyAuthModel, authClientConfig);
 
-  const lobbyAuthCtrl = new LobbyAuthCtrl(lobbyAuthModel, lobbyAuthView);
+  // контроллер подписывается на вид сам
+  new LobbyAuthCtrl(lobbyAuthModel, lobbyAuthView, {
+    turnstile: createTurnstile(authClientConfig.turnstile),
+  });
+
+  // тихое продление identity-токена: вкладка остаётся в аккаунте, пока жива
+  // сессия устройства
+  const tokenRenewer = new TokenRenewer({
+    getExpiresAt: getTokenExpiresAt,
+    renew: () => lobbyAuthModel.refresh(),
+    leadMs: authClientConfig.renew.leadMs,
+    retryMs: authClientConfig.renew.retryMs,
+  });
 
   signaling.publisher.on('welcome', () => {
     welcomeReceived = true;
@@ -2695,16 +2734,81 @@ if (isLobbyMode) {
       handoff.armTokenHandoff();
     }
 
-    // повторный вход после logout: маршрут уже разобран, а логин-гейт
-    // спрятал лобби — вернуть его, если вкладка не в комнате
-    if (route.booted && !roomCtx.entered) {
-      lobby?.open();
+    tokenRenewer.arm();
+  });
+
+  // свежий токен — мастеру (следующим сообщением сигналинга), хосту (порт
+  // TOKEN_REFRESH) и таймерам роли хоста
+  lobbyAuthModel.publisher.on('token-renewed', () => {
+    tokenRenewer.arm();
+    membership.armTokenCapsTimer();
+    // вкладка в комнате возвращает мастеру canHost по новому сроку
+    membership.sendUpdate();
+
+    if (hostRole.controller) {
+      handoff.armTokenHandoff();
+    }
+
+    if (sessionStarted && supervisor) {
+      sending(PC_TOKEN_REFRESH, { token: getToken() });
     }
   });
 
-  // OAuth-возврат: токены из query прочитаны — чистим только query, hash
+  // личность вкладки меняется только перезагрузкой страницы; из комнаты в
+  // лобби ведёт тоже только reloadPage(), поэтому в матче Welcome с
+  // уведомлением покажет следующая загрузка
+  lobbyAuthModel.publisher.on('session-lost', () => {
+    lobbyAuthModel.setNotice('profileGone');
+
+    if (!roomCtx.roomId) {
+      reloadPage();
+      return;
+    }
+
+    diagnostics.warn('engine.session.profileGone', {}, { source: 'client' });
+  });
+
+  // другая вкладка сменила личность браузера (регистрация, Restore, выход,
+  // удаление): вкладка вне комнаты перечитывает её перезагрузкой
+  window.addEventListener('storage', event => {
+    if (event.storageArea !== localStorage) {
+      return;
+    }
+
+    const action = decideSessionStorageChange({
+      event,
+      sessionKey: authClientConfig.sessionStorageKey,
+      currentSession: lobbyAuthModel.getSession(),
+      inRoom: Boolean(roomCtx.roomId),
+    });
+
+    if (action === 'reload') {
+      reloadPage();
+    }
+  });
+
+  // страница, восстановленная из bfcache (возврат кнопкой «Назад» от
+  // провайдера OAuth), событий storage не получала: личность сверяется с
+  // хранилищем заново
+  window.addEventListener('pageshow', event => {
+    if (!event.persisted) {
+      return;
+    }
+
+    const action = decideStoredSession({
+      storedSession: localStorage.getItem(authClientConfig.sessionStorageKey),
+      currentSession: lobbyAuthModel.getSession(),
+      inRoom: Boolean(roomCtx.roomId),
+    });
+
+    if (action === 'reload') {
+      reloadPage();
+    }
+  });
+
+  // возврат с OAuth и dev-сессия прочитаны — чистим только query, hash
   // (маршрут #/<gameId>[/<roomId>]) остаётся
-  if (lobbyAuthCtrl.init(window.location.search)) {
+  if (lobbyAuthModel.takeUrlParams(window.location.search)) {
     window.history.replaceState(
       null,
       '',
@@ -2712,6 +2816,8 @@ if (isLobbyMode) {
     );
   }
 
+  lobbyAuthModel.boot();
+
   window.addEventListener('hashchange', () => route.handleHashChange());
 
   signaling.connect();

package/src/client/network/TokenRenewer.js

@@ -0,0 +1,99 @@
+// Тихое продление identity-токена: за leadMs до exp запрашивает свежий у
+// сессии устройства. Сбой сети — повтор через retryMs без ограничения числа
+// попыток: сеть вернётся — токен продлится. Запуски идут не чаще раза в
+// retryMs, даже если срок остаётся в окне продления (цикла не будет).
+//
+// Без DOM: срок, продление и таймеры инъектирует владелец (client/main.js).
+
+export default class TokenRenewer {
+  /**
+   * @param {Object} options
+   * @param {Function} options.getExpiresAt - () → мс эпохи | null.
+   * @param {Function} options.renew - () → Promise<'ok' | 'retry' | 'lost'>.
+   * @param {number} options.leadMs
+   * @param {number} options.retryMs
+   * @param {Function} [options.now]
+   * @param {Object} [options.timers] - { setTimeout, clearTimeout } (тесты).
+   */
+  constructor({
+    getExpiresAt,
+    renew,
+    leadMs,
+    retryMs,
+    now = () => Date.now(),
+    timers = globalThis,
+  }) {
+    this._getExpiresAt = getExpiresAt;
+    this._renew = renew;
+    this._leadMs = leadMs;
+    this._retryMs = retryMs;
+    this._now = now;
+    this._timers = timers;
+    this._timer = null;
+    this._lastFireAt = null;
+  }
+
+  // таймер на expiresAt - leadMs, но не раньше «сейчас»; срок неизвестен —
+  // таймера нет. Повторный arm заменяет прежний таймер
+  arm() {
+    this._schedule(this._delayToLead());
+  }
+
+  cancel() {
+    if (this._timer !== null) {
+      this._timers.clearTimeout(this._timer);
+      this._timer = null;
+    }
+  }
+
+  _delayToLead() {
+    const expiresAt = this._getExpiresAt();
+
+    if (expiresAt === null) {
+      return null;
+    }
+
+    const now = this._now();
+    // не раньше retryMs после предыдущего запуска: срок, который и со
+    // свежим токеном остаётся в окне продления, не должен завести цикл.
+    // Сверху порог ограничен тем же retryMs: часы устройства могли перевести
+    // назад, и разность с прошлым запуском уже ничего не значит
+    const floor =
+      this._lastFireAt === null
+        ? 0
+        : Math.min(this._retryMs, this._lastFireAt + this._retryMs - now);
+
+    return Math.max(0, floor, expiresAt - this._leadMs - now);
+  }
+
+  _schedule(delay) {
+    this.cancel();
+
+    if (delay === null) {
+      return;
+    }
+
+    this._timer = this._timers.setTimeout(() => this._fire(), delay);
+  }
+
+  async _fire() {
+    this._timer = null;
+    this._lastFireAt = this._now();
+
+    let result;
+
+    try {
+      result = await this._renew();
+    } catch {
+      // неожиданный сбой не должен обрывать цепочку продления
+      result = 'retry';
+    }
+
+    if (result === 'ok') {
+      this.arm();
+    } else if (result === 'retry') {
+      this._schedule(this._retryMs);
+    }
+    // 'lost': таймер не взводится, потерю объявляет модель
+  }
+}

package/src/client/session/GuestSession.js

@@ -21,6 +21,9 @@ import WebRtcManager from '../network/WebRtcManager.js';
 // Без DOM: сигналинг, роли, супервизор, UI-действия и фабрики инъектирует
 // сборщик (client/main.js).
 
+// минимум между продлениями входа по одному виду запроса
+const RENEW_RETRY_MIN_MS = 60000;
+
 export default class GuestSession {
   /**
    * @param {Object} deps
@@ -32,7 +35,8 @@ export default class GuestSession {
    * @param {Function} deps.getPromotion - () → PromotionFlow.
    * @param {Function} deps.getSupervisor - () → SessionSupervisor | null.
    * @param {Function} deps.getToken - () → identity-токен.
-   * @param {Function} deps.logout - выход из лобби-авторизации.
+   * @param {Function} deps.refreshIdentity - () → Promise<'ok'|'retry'|'lost'>,
+   *   продление identity-токена по сессии устройства.
    * @param {Object} deps.config - lobby-конфиг (webrtc, reconnect).
    * @param {Object} deps.diagnostics
    * @param {Object} deps.ui - { ensureWebRtc() → bool, showRoomLink(roomId),
@@ -51,7 +55,7 @@ export default class GuestSession {
     getPromotion,
     getSupervisor,
     getToken,
-    logout,
+    refreshIdentity,
     config,
     diagnostics,
     ui,
@@ -67,7 +71,7 @@ export default class GuestSession {
     this._getPromotion = getPromotion;
     this._getSupervisor = getSupervisor;
     this._getToken = getToken;
-    this._logout = logout;
+    this._refreshIdentity = refreshIdentity;
     this._config = config;
     this._diagnostics = diagnostics;
     this._ui = ui;
@@ -83,6 +87,8 @@ export default class GuestSession {
     // открытое у гостя голосование «Change host» ({ roomId, voteId }) —
     // ответ окна уходит мастеру с этим voteId
     this._hostVote = null;
+    // вид запроса (msg.re) → время последнего продления (защита от цикла)
+    this._renewAttempts = new Map();
   }
 
   get hostVote() {
@@ -323,22 +329,15 @@ export default class GuestSession {
         if (action === 'abandonPromotion') {
           this._getPromotion().abandon({ code, report: true });
         } else if (action === 'keepPlaying') {
-          // P2P-матчу токен не нужен; без нового текста в UI (системные
-          // сообщения — только кодами, тексты в играх)
-          this._diagnostics.warn(
-            'engine.session.tokenExpired',
-            { re: msg.re },
-            { source: 'client' },
-          );
+          // P2P-матчу токен не нужен, без нового текста в UI (системные
+          // сообщения — только кодами, тексты в играх). Членство на мастере
+          // вернёт повторный join_room после продления; о неудаче продления
+          // пишет _renewAndRetry
           this._membership.stopJoinRetry();
-        } else {
-          this._logout();
+        }
 
-          if (action === 'logoutAndLeave') {
-            this._ui.leaveRoomWith(
-              'Your session has expired — please sign in again.',
-            );
-          }
+        if (action !== 'abandonPromotion') {
+          this._renewAndRetry(msg);
         }
         break;
       }
@@ -386,6 +385,53 @@ export default class GuestSession {
     }
   }
 
+  // продление входа и повтор отклонённого запроса. Не чаще раза в
+  // RENEW_RETRY_MIN_MS на вид запроса: мастер, отвергающий и свежий токен,
+  // не должен завести цикл
+  async _renewAndRetry(msg) {
+    const now = this._now();
+    const last = this._renewAttempts.get(msg.re);
+
+    if (last !== undefined && now - last < RENEW_RETRY_MIN_MS) {
+      this._warnTokenExpired(msg);
+      return;
+    }
+
+    this._renewAttempts.set(msg.re, now);
+
+    const result = await this._refreshIdentity();
+
+    if (result === 'ok') {
+      if (msg.re === 'join_room') {
+        this._membership.sendJoinRoom();
+      } else if (msg.re === 'register_host' || msg.re === 'reclaim_host') {
+        this._hostRole.reRegister();
+      }
+      return;
+    }
+
+    // хост, не продливший вход, не удержит комнату
+    if (
+      this._ctx.roomId &&
+      (msg.re === 'register_host' || msg.re === 'reclaim_host')
+    ) {
+      this._ui.leaveRoomWith(
+        'Your session could not be renewed — please reload the page.',
+      );
+      return;
+    }
+
+    this._warnTokenExpired(msg);
+  }
+
+  _warnTokenExpired(msg) {
+    this._diagnostics.warn(
+      'engine.session.tokenExpired',
+      { re: msg.re },
+      { source: 'client' },
+    );
+  }
+
   _ownRoom(msg) {
     return Boolean(this._ctx.roomId) && msg.roomId === this._ctx.roomId;
   }

package/src/client/session/Membership.js

@@ -85,7 +85,8 @@ export default class Membership {
   }
 
   // хватит ли срока входа на роль хоста: register_host/reclaim_host
-  // предъявляют токен мастеру посреди матча, а продления нет
+  // предъявляют токен мастеру посреди матча. Страховка на случай, когда
+  // тихое продление токена не удаётся
   tokenAllowsHostRole() {
     return tokenAllowsHosting(
       this._getTokenExpiresAt(),