vimp-engine 0.37.1 → 0.38.1

package/src/devtools/builtinScenario.js

@@ -26,7 +26,7 @@ const FIXTURE_UNUSED_KEYS = ['e1'];
 const firstKey = dict => Object.keys(dict ?? {})[0];
 
 // Клавиша для смоука обязана быть удерживаемой: по конвенции playerKeys
-// (docs/ai/04-client-plugin.md) `type: 1` — триггер, у которого 'up'
+// (docs/en/plugin-api.md) `type: 1` — триггер, у которого 'up'
 // игнорируется, и «нажал — отпустил» не даёт ни удержания, ни движения.
 // Порядок объявления в playerKeys контрактом не задан, поэтому берём первую
 // без type; если игра объявила одни триггеры — первую любую, смоук всё равно

package/src/devtools/contract/rules/a2-package-scripts.js

@@ -1,6 +1,6 @@
 import { ERROR, skip, verdict } from '../result.js';
 
-// Набор npm-скриптов пакета игры (docs/ai/02-packaging.md). Это не вкусовое
+// Набор npm-скриптов пакета игры (docs/en/packaging.md). Это не вкусовое
 // требование: инструкции движка и CI сгенерированной игры зовут их по имени,
 // а отсутствующий core:build:node тихо оставляет headless-прогон без ядра.
 const REQUIRED = [

package/src/devtools/contract/rules/a4-vite-config.js

@@ -2,7 +2,7 @@ import { ERROR, skip, verdict } from '../result.js';
 
 // vite.config.js проверяется как текст, а не импортом: конфиг —
 // функция от mode и вне Vite не исполняется. Каждый пункт здесь ловит
-// молчаливую поломку сборки, а не стилистику (docs/ai/02-packaging.md):
+// молчаливую поломку сборки, а не стилистику (docs/en/packaging.md):
 // без preserveEntrySignatures default-экспорт плагина вытряхивает
 // tree-shaking, а build.lib всегда инлайнит ассеты.
 const REQUIRED = [

package/src/devtools/contract/rules/b8-system-messages.js

@@ -4,7 +4,7 @@ import { ERROR, skip, verdict } from '../result.js';
 // реестра: код в зарезервированном диапазоне затирает движковое сообщение
 // без предупреждения, и вместо «Vote passed» игрок видит игровой текст.
 // Диапазоны — длины движковых групп (config/chatMessages.js).
-export const RESERVED = { s: 11, v: 15, m: 1, c: 1, n: 1 };
+export const RESERVED = { s: 11, v: 15, m: 1, c: 1 };
 
 export default {
   id: 'B8',

package/src/devtools/invariants.js

@@ -484,7 +484,7 @@ function predictionDrift({ clients, scenario }) {
 // Компоненты player-блока — игровая раскладка, движок знает только их
 // порядок, поэтому нарушение адресуется индексом. Исключение — уровень 0
 // (source 'camera'): там движок сравнивает ровно мировые x/y, и называть их
-// «#0/#1» значит прятать причину (см. docs/ai/13-debugging.md).
+// «#0/#1» значит прятать причину (см. docs/en/debugging.md).
 const CAMERA_COMPONENTS = ['x', 'y'];
 
 function formatDivergence(record) {

package/src/devtools/pluginLoader.js

@@ -12,7 +12,7 @@ import { loadGamePackage } from '../lib/loadGamePackage.js';
 //   3. ничего         — фикстура miniGame из этого репозитория.
 //
 // entries.wasmNode — новое ОПЦИОНАЛЬНОЕ поле манифеста: конвенция
-// core/pkg-node/ уже описана в docs/ai/02-packaging.md, не хватало только
+// core/pkg-node/ уже описана в docs/en/packaging.md, не хватало только
 // пути в манифесте. Его отсутствие не ошибка — просто игра не прогоняется
 // headless своим настоящим ядром.
 

package/src/host/GameCoreAdapter.js

@@ -106,9 +106,6 @@ export default class GameCoreAdapter {
     return JSON.parse(this._core.remove_players_and_shots());
   }
 
-  // имена — мета (ParticipantManager/Stat), ядру не нужны
-  changeName() {}
-
   // перемещает танк при смене команды/респауне (Game.changePlayerData)
   changePlayerData(gameId, data) {
     const [x, y, angle] = data.respawnData;

package/src/host/HostGame.js

@@ -1974,6 +1974,34 @@ export default class HostGame {
     };
   }
 
+  // есть ли у участника identity-токен: в standalone и dedicated личность
+  // гостевая, и обновлять там нечего
+  hasToken(gameId) {
+    const token = this._participants.get(gameId)?.token;
+
+    return typeof token === 'string' && token !== '';
+  }
+
+  // ник, под которым участник вошёл (тот же, что сверяет RESUME_REQUEST)
+  getIdentityName(gameId) {
+    return this._participants.get(gameId)?.identityName ?? null;
+  }
+
+  // свежий токен участника (порт TOKEN_REFRESH): им пишутся rank/state, и
+  // он же поедет в эстафету Worker'ов
+  refreshToken(gameId, token) {
+    const user = this._participants.get(gameId);
+
+    if (!user) {
+      return false;
+    }
+
+    user.token = token;
+    this._playerDataSync.attachToken(gameId, token);
+
+    return true;
+  }
+
   // привязывает участника к новому соединению и шлёт ему всё, что нужно,
   // чтобы продолжить с того же места: RESUME_RESULT, затем пакет входа
   // (очистка, полный кадр, stat/panel/keyset/accolades) и новый секрет.

package/src/host/PortMachine.js

@@ -23,8 +23,9 @@ const PC_VOTE_DATA = wsports.client.VOTE_DATA;
 const PC_PONG = wsports.client.PONG;
 const PC_RESUME_REQUEST = wsports.client.RESUME_REQUEST;
 const PC_LEAVE = wsports.client.LEAVE;
+const PC_TOKEN_REFRESH = wsports.client.TOKEN_REFRESH;
 
-const PORT_COUNT = 11;
+const PORT_COUNT = 12;
 
 // версии формата RESUME_REQUEST, которые понимает хост
 const RESUME_VERSION = 1;
@@ -38,6 +39,7 @@ const IN_GAME_PORTS = [
   PC_VOTE_DATA,
   PC_PONG,
   PC_LEAVE,
+  PC_TOKEN_REFRESH,
 ];
 
 export default class PortMachine {
@@ -139,6 +141,7 @@ export default class PortMachine {
     const state = {
       gameId: undefined,
       enabled: new Array(PORT_COUNT).fill(false),
+      refreshing: false,
     };
 
     this._clients.set(socketId, state);
@@ -153,6 +156,7 @@ export default class PortMachine {
     const state = {
       gameId: undefined,
       enabled: new Array(PORT_COUNT).fill(false),
+      refreshing: false,
       resumeTimer: null,
     };
 
@@ -210,6 +214,7 @@ export default class PortMachine {
     const state = {
       gameId,
       enabled: new Array(PORT_COUNT).fill(false),
+      refreshing: false,
     };
 
     state.methods = this._buildPortMethods(socketId, state);
@@ -379,6 +384,47 @@ export default class PortMachine {
       .catch(() => reject('auth'));
   }
 
+  // TOKEN_REFRESH { token }: токен принимается, только если он подписан
+  // auth-сервисом и выдан на тот же ник, под которым участник вошёл
+  _refreshToken(socketId, state, data) {
+    const { gameId } = state;
+
+    if (
+      typeof data?.token !== 'string' ||
+      gameId === undefined ||
+      state.refreshing ||
+      !this._host.hasToken(gameId)
+    ) {
+      return;
+    }
+
+    // не больше одной проверки подписи в полёте на соединение
+    state.refreshing = true;
+
+    this._identity
+      .resolve({ token: data.token }, socketId)
+      .then(name => {
+        if (!this._clients.has(socketId)) {
+          return;
+        }
+
+        if (name !== this._host.getIdentityName(gameId)) {
+          console.warn(
+            '[host] TOKEN_REFRESH: token of another identity ignored',
+          );
+          return;
+        }
+
+        this._host.refreshToken(gameId, data.token);
+      })
+      .catch(() => {
+        // недействительный токен: участник остаётся со старым
+      })
+      .finally(() => {
+        state.refreshing = false;
+      });
+  }
+
   // перехват полуоткрытой сессии: участник ещё числится за прежним
   // соединением (обрыв, которого хост не заметил) — закрыть его, не снимая
   // участника; его поздний disconnect уже ничего не найдёт
@@ -553,6 +599,9 @@ export default class PortMachine {
 
       // 10: leave
       () => this._leave(socketId, state),
+
+      // 11: token refresh
+      data => this._refreshToken(socketId, state, data),
     ];
   }
 }

package/src/host/meta/SocketManager.js

@@ -30,7 +30,6 @@ export default class SocketManager {
     this._PORT_SOUND_DATA = ports.SOUND_DATA;
     this._PORT_GAME_INFORM_DATA = ports.GAME_INFORM_DATA;
     this._PORT_TECH_INFORM_DATA = ports.TECH_INFORM_DATA;
-    this._PORT_MISC = ports.MISC;
     this._PORT_PING = ports.PING;
     this._PORT_CLEAR = ports.CLEAR;
     this._PORT_CONSOLE = ports.CONSOLE;
@@ -455,16 +454,4 @@ export default class SocketManager {
   sendResumeResult(socketId, data) {
     this._send(socketId, this._PORT_RESUME_RESULT, data);
   }
-
-  /**
-   * Отправка команды смены имени.
-   * @param {string} socketId
-   * @param {string} name
-   */
-  sendName(socketId, name) {
-    this._send(socketId, this._PORT_MISC, {
-      key: 'localstorageNameReplace',
-      value: name,
-    });
-  }
 }

package/src/host/meta/core/RoundManager.js

@@ -1,5 +1,3 @@
-import { isValidName } from '../../../lib/validators.js';
-
 // масштабирование данных карты (физика, респауны) под mapScale
 function scaleMapData(mapData) {
   const scale = mapData.scale;
@@ -522,23 +520,6 @@ class RoundManager {
     return true;
   }
 
-  // меняет ник игрока
-  changeName(gameId, name) {
-    const user = this._participants.get(gameId);
-    const oldName = user.name;
-
-    if (isValidName(name)) {
-      name = this._participants.checkName(name);
-      user.name = name;
-      this._game.changeName(gameId, name);
-      this._stat.updateUser(gameId, user.teamId, { name });
-      this._chat.pushSystem('NAME_CHANGED', [oldName, name]);
-      this._socketManager.sendName(user.socketId, name);
-    } else {
-      this._chat.pushSystemByUser(gameId, 'NAME_INVALID');
-    }
-  }
-
   // меняет команду игрока
   changeTeam(gameId, newTeam) {
     this._applyTeamChange(gameId, newTeam);

package/src/host/meta/modules/PlayerDataSync.js

@@ -663,7 +663,7 @@ export default class PlayerDataSync {
         do {
           entry.flushAgain = false;
           await this._sync(participantId, entry);
-        } while (entry.flushAgain);
+        } while (entry.flushAgain && !entry.awaitingToken);
       } finally {
         entry.inFlight = false;
         entry.inFlightPromise = null;
@@ -673,6 +673,16 @@ export default class PlayerDataSync {
     return entry.inFlightPromise;
   }
 
+  // 401: запрос ушёл с токеном usedToken. Если за время полёта приложен
+  // свежий (attachToken), ждать нечего — повтор уходит в этой же серии
+  _onTokenExpired(entry, usedToken) {
+    if (entry.token === usedToken) {
+      entry.awaitingToken = true;
+    } else {
+      entry.flushAgain = true;
+    }
+  }
+
   // F4: если исходная load() не удалась, PUT дефолтом затёр бы реальные
   // сохранённые рейтинг/state — вместо этого повторяем load() и шлём PUT
   // только для того, что реально загрузилось
@@ -756,8 +766,19 @@ export default class PlayerDataSync {
             // получит тот же ответ. Оставить запись открытой значит слать
             // заведомый мусор на каждом flush до конца жизни комнаты, а
             // накопленное после неё не ушло бы вовсе. Очки теряются, и это
-            // честнее вечного цикла (сам отказ уже в логе выше)
-            if (res.status >= 400 && res.status < 500 && res.status !== 429) {
+            // честнее вечного цикла (сам отказ уже в логе выше).
+            // 401 — отказ не по содержанию, а по сроку токена: запись
+            // остаётся открытой и уйдёт со свежим (attachToken)
+            if (res.status === 401) {
+              this._onTokenExpired(entry, token);
+              console.warn(
+                `[playerData] PUT rank 401 for ${participantId} — waiting for a fresh token`,
+              );
+            } else if (
+              res.status >= 400 &&
+              res.status < 500 &&
+              res.status !== 429
+            ) {
               drop();
             }
           }
@@ -787,6 +808,11 @@ export default class PlayerDataSync {
             console.warn(
               `[playerData] PUT state ${res.status} for ${participantId}`,
             );
+
+            // токен истёк: состояние уйдёт со свежим (attachToken)
+            if (res.status === 401) {
+              this._onTokenExpired(entry, token);
+            }
           }
         }),
       );

package/src/host/meta/modules/chat/systemMessages.js

@@ -1,5 +1,5 @@
 // Реестр кодов системных сообщений чата. Движковые группы: s (статусы),
-// v (голосования), m (карты), c (команды), n (имена). Игровые коды
+// v (голосования), m (карты), c (команды). Игровые коды
 // (у танков — группа b:*) добавляются через registerCodes и не должны
 // пересекаться с движковыми группами. Английские тексты движковых кодов — config/chatMessages.js,
 // игровых — на клиенте (конфиг игры).
@@ -46,9 +46,6 @@ export const ENGINE_MESSAGE_CODES = Object.freeze({
 
   COMMANDS_NOT_FOUND: 'c:0', // Command not found
   RANK: 'c:1', // Your rank: {0}
-
-  NAME_INVALID: 'n:0', // Invalid name
-  NAME_CHANGED: 'n:1', // {0} changed name to {1}
 });
 
 // изменяемый реестр: движковые коды + игровые из registerCodes

package/src/lib/loadGamePackage.js

@@ -12,7 +12,7 @@ import { ENGINE_CAPABILITIES } from './capabilities.js';
 // должен зависеть от отладочного контура (граница из CLAUDE.md).
 //
 // entries.wasmNode — node-сборка ядра игры (конвенция core/pkg-node,
-// docs/ai/02-packaging.md). Для боевой игры она обязательна: без ядра
+// docs/en/packaging.md). Для боевой игры она обязательна: без ядра
 // авторитетную симуляцию крутить нечем.
 
 /**

package/src/lib/validators.js

@@ -13,6 +13,14 @@ const NAME_REGEXP = new RegExp('^[a-zA-Z]([\\w\\s#]{0,13})[\\w]{1}$');
 export const isValidName = name =>
   typeof name === 'string' && NAME_REGEXP.test(name);
 
+// ник профиля: копия правила auth-сервиса (packages/auth/src/lib/validators.js)
+// — общей рантайм-зависимости у пакетов нет. Строже isValidName: внутри ника
+// допустим только обычный пробел, не любой \s
+const NICK_REGEXP = new RegExp('^[a-zA-Z]([\\w #]{0,13})[\\w]{1}$');
+
+export const isValidNick = nick =>
+  typeof nick === 'string' && NICK_REGEXP.test(nick);
+
 // потолок длины поля формы, когда maxlength в дескрипторе не объявлен.
 // regExp игры исполняется на хосте против строки, которую прислал клиент, и
 // катастрофический паттерн вроде "(a+)+b" превращает три десятка символов в

package/src/standalone/index.js

@@ -8,7 +8,7 @@ import { ensureGameShell } from '../client/views/gameShell.js';
 
 // Standalone SDK (Этап 3 плана standalone-sdk): единственная точка входа для
 // репозитория игры — `npm run dev` открывает вкладку с работающим матчем без
-// мастера, без OAuth и без экрана лобби.
+// мастера, без входа и без экрана лобби.
 //
 // Отличия от прода (осознанные, см. plan/standalone-sdk/README.md):
 //   - хост крутится в главном потоке (inline), а не в Worker'е: HostPlugin