vimp-engine 0.24.1 → 0.25.0

package/src/client/lib/gameActivator.js

@@ -8,8 +8,14 @@
 // Вынесено из main.js (бутстрап, тестами не покрывается) отдельным модулем,
 // чтобы кеш и обработка отказа проверялись юнит-тестом.
 export function createGameActivator({ gamesById, loadClientPlugin }) {
-  // gameId -> промис загрузки: кешируется именно промис, иначе два быстрых
-  // клика подряд запустили бы импорт дважды
+  // `${gameId}@${manifest.version}` -> промис загрузки: кешируется именно
+  // промис, иначе два быстрых клика подряд запустили бы импорт дважды.
+  //
+  // Версия в ключе обязательна (master-game-registry, этап 3): в каталоге
+  // мастера две версии одной игры живут одновременно (админ стейджит новую,
+  // игроки играют в одобренную), и ключ по одному gameId вернул бы уже
+  // выполненный import() НЕ ТОГО кода. manifest.version — хеш бандла, то
+  // есть идентификатор самого кода
   const plugins = new Map();
 
   return async function activateGame(gameId) {
@@ -19,18 +25,20 @@ export function createGameActivator({ gamesById, loadClientPlugin }) {
       throw new Error(`unknown game "${gameId}"`);
     }
 
-    let pending = plugins.get(gameId);
+    const key = `${gameId}@${manifest.version}`;
+
+    let pending = plugins.get(key);
 
     if (!pending) {
       pending = loadClientPlugin(manifest).catch(e => {
         // отказ не кешируем: сеть могла моргнуть, повторный клик обязан
         // попробовать снова, а не переигрывать ту же ошибку вечно
-        plugins.delete(gameId);
+        plugins.delete(key);
 
         throw e;
       });
 
-      plugins.set(gameId, pending);
+      plugins.set(key, pending);
     }
 
     return { manifest, plugin: await pending };

package/src/client/main.js

@@ -73,6 +73,9 @@ import LobbyCtrl from './components/controller/Lobby.js';
 import LobbyAuthModel from './components/model/LobbyAuth.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 BakingProvider from './providers/BakingProvider.js';
 import DependencyProvider from './providers/DependencyProvider.js';
 import { HOT_FLAGS } from '../config/opcodes.js';
@@ -1718,8 +1721,7 @@ let hostRegistration = null;
 // Этап 5.1/6.4: скачивает каталог карт мастера активной игры (манифест +
 // все карты)
 async function fetchMasterMaps() {
-  const gameId = activeGameManifest.id;
-  const manifestRes = await fetch(lobbyConfig.maps.manifestUrl(gameId));
+  const manifestRes = await fetch(lobbyConfig.maps.manifestUrl(activeGameManifest));
 
   if (!manifestRes.ok) {
     throw new Error(`maps manifest: HTTP ${manifestRes.status}`);
@@ -1729,7 +1731,7 @@ async function fetchMasterMaps() {
 
   const entries = await Promise.all(
     manifest.maps.map(async name => {
-      const url = `${lobbyConfig.maps.baseUrl(gameId)}/${encodeURIComponent(name)}`;
+      const url = `${lobbyConfig.maps.baseUrl(activeGameManifest)}/${encodeURIComponent(name)}`;
       const res = await fetch(url);
 
       if (!res.ok) {
@@ -1840,8 +1842,16 @@ async function fetchServers({ offset, limit, search }) {
     params.set('limit', limit);
   }
 
+  // токен едет и сюда (master-game-registry, этап 4): список серверов
+  // публичный, но админу мастер отдаёт вместе с ним скрытые тестовые
+  // комнаты застейдженных версий
+  const token = lobbyAuthModel?.getToken();
+
   try {
-    const res = await fetch(`${lobbyConfig.serversUrl}?${params}`);
+    const res = await fetch(
+      `${lobbyConfig.serversUrl}?${params}`,
+      token ? { headers: { authorization: `Bearer ${token}` } } : undefined,
+    );
 
     return res.ok ? await res.json() : null;
   } catch (e) {
@@ -1939,6 +1949,11 @@ function populateRoomForm(manifest) {
   }
 }
 
+// роли, которым лобби показывает кнопку «Moderation» (master-game-registry,
+// этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
+// запись — auth-сервис, перечитывая роль из БД
+const ADMIN_ROLES = ['admin', 'superadmin'];
+
 // каталог манифестов по id: форма и leaderboard селектора игр, а также
 // активация игры перед созданием комнаты и входом в чужую
 const gamesById = new Map(
@@ -1972,7 +1987,10 @@ function clearLobbyError() {
 // активирует игру и перепривязывает манифест/плагин/CSS; false — отказ уже
 // показан игроку, лобби остаётся рабочим
 async function selectActiveGame(gameId) {
-  if (gameId === activeGameManifest.id) {
+  // сверка идёт с самим манифестом, а не с его id: каталог вкладки может
+  // пополниться застейдженной версией той же игры (registerGameManifest), и
+  // сравнение по id оставило бы активной одобренную версию
+  if (gameId === activeGameManifest.id && gamesById.get(gameId) === activeGameManifest) {
     return true;
   }
 
@@ -1993,8 +2011,36 @@ async function selectActiveGame(gameId) {
   }
 }
 
+// id игр, чей манифест в каталоге вкладки подменён застейдженной версией
+// (master-game-registry, этап 4): в селекторе такая игра помечается, чтобы
+// админ видел, что поднимет комнату НЕ на одобренной версии
+const stagedGameIds = new Set();
+
+/**
+ * Кладёт манифест застейдженной (не одобренной) версии в каталог вкладки —
+ * так админ может поднять по нему комнату, не трогая каталог игроков.
+ * Дальше всё работает существующим путём: createGameActivator грузит
+ * ClientPlugin по entries.client (ключ кеша версионный, поэтому плагин
+ * черновика не подменит одобренный), connectAsHost поднимает комнату, а
+ * мастер помечает её скрытой по версии манифеста.
+ * @param {Object} manifest - Манифест застейдженной версии из /admin/games.
+ * @returns {void}
+ */
+function registerGameManifest(manifest) {
+  if (!manifest?.id) {
+    return;
+  }
+
+  gamesById.set(manifest.id, manifest);
+  stagedGameIds.add(manifest.id);
+  populateGameSelect();
+}
+
 // заполняет #lobby-game всем каталогом манифестов мастера — раньше туда
-// попадал только gamesManifest[0], теперь селектор рабочий
+// попадал только gamesManifest[0], теперь селектор рабочий.
+// Источник — gamesById, а не gamesManifest: каталог вкладки пополняется на
+// лету застейдженными версиями (registerGameManifest), и селектор
+// перерисовывается целиком
 function populateGameSelect() {
   const gameSelect = document.getElementById(lobbyConfig.elems.gameId);
 
@@ -2002,7 +2048,13 @@ function populateGameSelect() {
     return;
   }
 
-  gamesManifest.forEach(manifest => {
+  // перерисовка не должна сбрасывать выбор игрока: селектор целиком
+  // пересобирается и при добавлении застейдженной версии
+  const selected = gameSelect.value;
+
+  gameSelect.textContent = '';
+
+  gamesById.forEach(manifest => {
     const option = document.createElement('option');
     const available = isGameAvailable(manifest);
 
@@ -2011,14 +2063,15 @@ function populateGameSelect() {
     // каталога, и игрок видел пустое лобби без причины), но выбрать её
     // нельзя: комнату по ней всё равно не поднять
     option.textContent = available
-      ? manifest.title
+      ? `${manifest.title}${stagedGameIds.has(manifest.id) ? lobbyConfig.games.stagedSuffix : ''}`
       : `${manifest.title} — unavailable`;
     option.disabled = !available;
     option.title = available ? '' : manifest.compat.text;
     gameSelect.appendChild(option);
   });
 
-  gameSelect.value = activeGameManifest.id;
+  gameSelect.value =
+    selected && gamesById.has(selected) ? selected : activeGameManifest.id;
 }
 
 // поднимает лобби после welcome от мастера (iceServers уже получены);
@@ -2114,6 +2167,22 @@ function initLobby() {
     () => ({ descriptors: roomFormDescriptors, fields: roomFormFields }),
   );
 
+  // реестр игр (master-game-registry, этап 4): заявка разработчика и панель
+  // модерации живут в том же лобби. Триплет поднимается вместе с лобби —
+  // панель доступна любому авторизованному, кнопку модерации показывает роль
+  const gamesModel = new GamesModel(lobbyConfig.games, () => lobbyAuthModel.getToken());
+  const gamesView = new GamesView(gamesModel, lobbyConfig.games);
+  const games = new GamesCtrl(gamesModel, gamesView);
+
+  games.setAdmin(ADMIN_ROLES.includes(lobbyAuthModel.getRole()));
+
+  // «Test»: манифест застейдженной версии кладётся в каталог вкладки, и
+  // админ поднимает по нему комнату обычной кнопкой Create server
+  games.publisher.on('staged', ({ manifest }) => {
+    registerGameManifest(manifest);
+    gamesView.hide();
+  });
+
   // создание комнаты в этой же вкладке (хост-игрок через loopback)
   populateGameSelect();
   populateRoomForm(activeGameManifest);

package/src/client/style.css

@@ -1053,3 +1053,104 @@ body.hide-cursor {
   color: #f56;
   margin: 8px 0;
 }
+
+/*games*/
+
+/* панель реестра игр (master-game-registry, этап 4): открывается вместо
+   #lobby теми же кнопками бейджа пользователя. Каркас — тот же, что у
+   лобби (.card, .form-row, .lobby-column), собственных цветовых переменных
+   секция не заводит */
+#games-panel {
+  background-color: #222;
+  position: absolute;
+  width: 100%;
+  min-height: 100%;
+  top: 0;
+  left: 0;
+  z-index: 8;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  box-sizing: border-box;
+}
+
+#games-mine,
+#games-moderation {
+  width: 700px;
+  padding: 10px;
+  text-align: left;
+}
+
+/* заголовок панели и кнопка возврата в одной строке */
+.games-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.games-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.games-item {
+  border-bottom: 1px solid #444;
+  padding: 8px;
+}
+
+.games-item-title {
+  font-weight: bold;
+}
+
+/* поля прямо в карточке заявки: версия и причина отклонения относятся к
+   конкретной строке списка, а не к форме панели */
+.games-version-input,
+.games-note-input {
+  width: 200px;
+  text-align: left;
+  margin-right: 8px;
+}
+
+/* поля заявки — текстовые, а не счётчики: правило .form-row
+   input[type='text'] рассчитано на «max players» room-формы */
+#games-submit-form .form-row input[type='text'] {
+  width: 260px;
+  max-width: 100%;
+  text-align: left;
+}
+
+.games-filters {
+  display: flex;
+  gap: 12px;
+  border-bottom: 1px solid #444;
+  margin-bottom: 12px;
+}
+
+.games-filter-btn {
+  background: none;
+  border: none;
+  color: #888;
+  font-weight: bold;
+  padding: 6px 4px 8px;
+  margin: 0;
+  text-shadow: none;
+}
+
+.games-filter-btn.active {
+  color: #eee;
+}
+
+/* кнопки входа в панель стоят рядом с Sign out в бейдже пользователя */
+.lobby-user-actions {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+@media (max-width: 900px) {
+  #games-mine,
+  #games-moderation {
+    width: 100%;
+  }
+}

package/src/client/views/includes/games.pug

@@ -0,0 +1,36 @@
+//- Реестр игр в лобби (master-game-registry, этап 4): разработчик подаёт
+//- заявку и следит за её статусом, админ модерирует и играет в черновик.
+//- Панель скрыта по умолчанию — открывается кнопками бейджа пользователя
+//- (#lobby-user в lobby.pug); id элементов перечислены в config/lobby.js.
+//- Подписи — по-английски, как и остальное лобби
+div#games-panel(style='display:none')
+  div.lobby-column
+    div.card#games-mine
+      div.games-head
+        h3.lobby-section-title= 'My games'
+        input#games-close(type='button', value='Back to lobby')
+      ul#games-mine-list.games-list
+      form#games-submit-form
+        div.form-row
+          label.form-label(for='games-field-id')= 'Game id'
+          input#games-field-id.field-text(type='text', name='id', maxlength='32', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-package')= 'npm package'
+          input#games-field-package.field-text(type='text', name='packageName', maxlength='214', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-version')= 'Version'
+          input#games-field-version.field-text(type='text', name='version', maxlength='64', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-repo')= 'Repository URL'
+          input#games-field-repo.field-text(type='text', name='repoUrl', maxlength='256', autocomplete='off')
+        div.form-row
+          label.form-label(for='games-field-title')= 'Title'
+          input#games-field-title.field-text(type='text', name='title', maxlength='64', autocomplete='off')
+        div#games-submit-error.form-error
+        input#games-submit(type='submit', value='Submit for review')
+
+    div.card#games-moderation(style='display:none')
+      h3.lobby-section-title= 'Moderation'
+      div#games-filters.games-filters
+      ul#games-admin-list.games-list
+      div#games-admin-error.form-error

package/src/client/views/includes/lobby.pug

@@ -14,7 +14,13 @@ div#lobby(style='display:none')
           div
             span= 'Signed in as '
             b#lobby-user-nick
-          input#lobby-user-logout(type='button', value='Sign out')
+          //- вход в панель реестра игр (master-game-registry, этап 4):
+          //- «My games» видит любой авторизованный, «Moderation» — только
+          //- админская роль (main.js по LobbyAuthModel.getRole())
+          div.lobby-user-actions
+            input#games-open-mine(type='button', value='My games')
+            input#games-open-moderation(type='button', value='Moderation', style='display:none')
+            input#lobby-user-logout(type='button', value='Sign out')
         hr.lobby-divider
         h3.lobby-section-title= 'HOST A GAME'
         div#lobby-create

package/src/client/views/index.pug

@@ -4,5 +4,6 @@ include includes/chat
 include includes/stat
 include includes/lobbyAuth
 include includes/lobby
+include includes/games
 include includes/auth
 include includes/informer

package/src/config/env.js

@@ -31,6 +31,12 @@ export function applyMasterEnv(config, env = process.env) {
   if (env.GAMES_MATRIX) {
     config.set('master:games', JSON.parse(env.GAMES_MATRIX));
   }
+
+  // корень хранилища игровых пакетов (направление master-game-registry) —
+  // в проде это смонтированный том, переживающий пересоздание контейнера
+  if (env.VIMP_GAMES_DIR) {
+    config.set('master:gameStore:dir', env.VIMP_GAMES_DIR);
+  }
 }
 
 /**

package/src/config/lobby.js

@@ -11,10 +11,19 @@ export default {
 
   // каталог карт мастера, per-game (Этап 6.4): комната хоста стартует на
   // актуальных картах активной игры, недоступность каталога — fallback на
-  // карты из бандла
+  // карты из бандла.
+  //
+  // Аргумент — МАНИФЕСТ, а не gameId (master-game-registry, этап 3): карты
+  // клиент берёт не из assetsBase, а по отдельному URL, и версионность
+  // каталога обязана доехать и сюда, иначе комната на застейдженной версии
+  // играла бы на картах одобренной. `mapsBase` проставляет мастер при
+  // ребейзе версионного каталога; его отсутствие (dev, standalone,
+  // dedicated, старый мастер) — законный случай, тогда работает прежний
+  // путь по id
   maps: {
-    manifestUrl: gameId => `/games/${gameId}/maps/manifest.json`,
-    baseUrl: gameId => `/games/${gameId}/maps`,
+    manifestUrl: manifest =>
+      `${manifest.mapsBase ?? `/games/${manifest.id}/maps`}/manifest.json`,
+    baseUrl: manifest => manifest.mapsBase ?? `/games/${manifest.id}/maps`,
   },
 
   // манифест конкретной игры (Этап 6.5): эстафета Worker'ов перечитывает его
@@ -184,6 +193,76 @@ export default {
     linkId: 'lobby-link',
   },
 
+  // реестр игр (master-game-registry, этап 4): заявка разработчика и панель
+  // модерации живут в том же лобби, без правки конфигов и рестартов.
+  // Все URL и id элементов — здесь: правило репозитория, модули их не
+  // хардкодят (games.pug)
+  games: {
+    urls: {
+      // заявки вызывающего со статусами и замечаниями модератора
+      mine: '/games/mine',
+      // заявка на новую игру платформы (валидируется мастером до записи)
+      submit: '/games/submit',
+      // заявка на новую версию уже заведённой игры
+      version: id => `/games/mine/${encodeURIComponent(id)}/version`,
+      // очередь модерации целиком плюс локальное состояние на этом мастере
+      admin: '/admin/games',
+      // манифесты застейдженных версий — по ним админ поднимает тестовую
+      // комнату, не трогая каталог игроков
+      staged: '/admin/games/manifest.json',
+      // «Test»: скачать версию и положить её в каталог не раздаваемой
+      stage: id => `/admin/games/${encodeURIComponent(id)}/stage`,
+      // решение модератора
+      moderate: id => `/admin/games/${encodeURIComponent(id)}`,
+      // что опубликовано в npm — индикатор «есть версия новее»
+      versions: id => `/admin/games/${encodeURIComponent(id)}/versions`,
+    },
+
+    // фильтры очереди модерации: id статуса реестра -> подпись кнопки.
+    // Значения обязаны совпадать со статусами auth-сервиса
+    statuses: [
+      { id: 'pending', title: 'Pending' },
+      { id: 'approved', title: 'Published' },
+      { id: 'rejected', title: 'Rejected' },
+      { id: 'disabled', title: 'Disabled' },
+    ],
+    defaultStatus: 'pending',
+
+    // суффикс игры, поднятой из застейдженной версии: в селекторе она
+    // стоит рядом с одобренной, и различать их обязано быть видно
+    stagedSuffix: ' (test)',
+
+    // DOM-элементы панели (из games.pug)
+    elems: {
+      panelId: 'games-panel',
+      // панель и лобби делят место: открытая панель прячет #lobby целиком
+      lobbyId: 'lobby',
+      // кнопки в бейдже пользователя (lobby.pug)
+      openMineBtnId: 'games-open-mine',
+      openModerationBtnId: 'games-open-moderation',
+      closeBtnId: 'games-close',
+
+      // «My games»
+      mineListId: 'games-mine-list',
+      submitFormId: 'games-submit-form',
+      submitErrorId: 'games-submit-error',
+      submitBtnId: 'games-submit',
+      fieldIds: {
+        id: 'games-field-id',
+        packageName: 'games-field-package',
+        version: 'games-field-version',
+        repoUrl: 'games-field-repo',
+        title: 'games-field-title',
+      },
+
+      // модерация
+      moderationId: 'games-moderation',
+      adminListId: 'games-admin-list',
+      adminErrorId: 'games-admin-error',
+      filtersId: 'games-filters',
+    },
+  },
+
   // создание комнаты (хост в этой же вкладке); лимит игроков/время
   // раунда-карты/огонь по своим/карта по умолчанию — из roomDefaults
   // манифеста активной игры (Этап 6.3), не бандлятся здесь

package/src/config/master.js

@@ -18,22 +18,42 @@ export default {
     cert: path.join(rootDir, '.certs', 'cert.pem'),
   },
 
-  // список игр-плагинов, подключаемых к мастеру (Этап A2 плана разделения):
-  // `package` — имя npm-пакета игры, резолвится через node_modules; пакет
-  // объявлен зависимостью в корневом package.json репозитория (деплой-уровень),
-  // не в packages/engine — vimp-engine остаётся game-agnostic и не тянет
-  // конкретную игру за собой (кодревью Этапов A, находка F1). Версию задаёт
-  // именно эта зависимость, каталог берёт её из dist/manifest.json пакета.
-  // Список переопределяется переменной окружения GAMES_MATRIX (JSON) — её
-  // задаёт деплой; вне прода каталог вдобавок дополняется собранными
-  // пакетами @vimp-games/* из node_modules (master/localGames.js), чтобы
-  // прилинкованная игра попадала в лобби без правки этого массива: он
-  // публикуется вместе с пакетом vimp-engine
+  // Статический каталог игр-плагинов. ПУСТ по умолчанию
+  // (master-game-registry, этап 3): штатный источник каталога — реестр игр
+  // auth-сервиса, откуда мастер скачивает одобренные пакеты сам
+  // (master/GameSync.js). Движок игр не знает и зависимостями их не тянет.
+  //
+  // Массив и переменная окружения GAMES_MATRIX (JSON) остаются
+  // переопределением для двух случаев: локальная разработка (каталог вдобавок
+  // дополняется собранными пакетами @vimp-games/* из node_modules,
+  // master/localGames.js — прилинкованная игра важнее реестра) и self-hosted
+  // мастер без реестра. `package` — имя npm-пакета игры, резолвится через
+  // node_modules; версию задаёт сама установленная зависимость.
   // maxGameScore (snakes-v3 этап 3.3, необязательное поле рядом с
   // id/package) — потолок результата ОДНОЙ игры для этой игры; мастер
-  // клампит им `best`/`points` PUT /auth/rank. Не задан — дефолт
+  // клампит им `best`/`points` PUT /auth/rank. Для игр реестра его задаёт
+  // админ при модерации, здесь — только запасной путь. Не задан — дефолт
   // master:playerData:maxGameScore
-  games: [{ id: 'tanks', package: '@vimp-games/tanks' }],
+  games: [],
+
+  // Хранилище игровых пакетов (направление master-game-registry): мастер
+  // качает одобренные игры из npm registry и раздаёт их с диска, вместо того
+  // чтобы получать их npm-зависимостью на этапе сборки образа.
+  gameStore: {
+    // корень хранилища; null → <repoRoot>/.games (локальная разработка).
+    // В проде задаётся VIMP_GAMES_DIR и монтируется томом
+    dir: null,
+    registryUrl: 'https://registry.npmjs.org',
+    // период опроса реестра auth за изменениями каталога
+    refreshInterval: 60000,
+    // потолки распаковки недоверенного архива
+    maxTarballBytes: 64 * 1024 * 1024,
+    maxFiles: 5000,
+    // сколько версий одной игры держать на диске: активная + стейджевая
+    keepVersions: 2,
+    // потолок ожидания ответа реестра
+    timeout: 30000,
+  },
 
   // список серверов (GET /servers)
   servers: {

package/src/devtools/contract/rules/b2-engine-api.js

@@ -123,7 +123,7 @@ export default {
 // исключена: пакет, собранный до появления поля, обязан оставаться
 // валидным (И1/И2)
 function halfViolations(ctx, manifestRequires) {
-  const wanted = new Set(manifestRequires);
+  const wanted = new Set(resolveNames(manifestRequires));
   const violations = [];
   const halves = [
     ['HostPlugin', ctx.hostPlugin?.requires],
@@ -139,7 +139,7 @@ function halfViolations(ctx, manifestRequires) {
       continue;
     }
 
-    const extra = value.filter(name => !wanted.has(name));
+    const extra = resolveNames(value).filter(name => !wanted.has(name));
 
     if (extra.length) {
       violations.push(
@@ -158,10 +158,12 @@ function halfViolations(ctx, manifestRequires) {
     return violations;
   }
 
-  const declared = halves
-    .map(([, value]) => value)
-    .filter(Array.isArray)
-    .flat();
+  const declared = resolveNames(
+    halves
+      .map(([, value]) => value)
+      .filter(Array.isArray)
+      .flat(),
+  );
 
   const missing = [...wanted].filter(name => !declared.includes(name));
 
@@ -176,6 +178,19 @@ function halfViolations(ctx, manifestRequires) {
   return violations;
 }
 
+// Имена сравниваются РЕЗОЛВНУТЫМИ: реестр возможностей append-only, и
+// выведенное алиасом имя движок принимает вечно наравне с активным.
+// Манифест с новым именем и половина, оставшаяся на выведенном, просят одно
+// и то же — считать это расхождением значило бы ругаться на игру за то, что
+// движок переименовал возможность (тот самый отказ по возрасту, который план
+// снимал). Неизвестное имя резолва не имеет и сравнивается как есть: о нём
+// говорит проверка по реестру выше
+function resolveNames(names) {
+  return (Array.isArray(names) ? names : []).map(
+    name => ENGINE_CAPABILITIES.resolve(name) ?? name,
+  );
+}
+
 // то же, что делают B5 и C10: выведенное имя — не отказ, а предупреждение.
 // Отвергать за него значило бы отвергать игру за возраст (И1)
 function finish(violations, retired) {

package/src/devtools/contract/rules/c10-auth-schema.js

@@ -2,6 +2,7 @@ import { ERROR, WARN, skip, verdict } from '../result.js';
 import { resolveValidator } from '../../../lib/validators.js';
 import {
   formControls,
+  resolveDescriptor,
   ACTIVE_FORM_CONTROLS,
 } from '../../../lib/formControls.js';
 
@@ -13,6 +14,10 @@ import {
 // которого нет в authSchema.validators (поле не проверяется никем).
 const NICKNAME = /^(name|nick|nickname|player|playername|login|username)$/i;
 
+// те же имена, что у validateAuth и билдера формы: список вариантов есть
+// только у них, и только им движок резолвит `source`
+const OPTION_CONTROLS = ['select', 'radio'];
+
 export default {
   id: 'C10',
   name: 'authSchema',
@@ -76,8 +81,18 @@ export default {
       // значит список вариантов у такого поля пуст всегда: игрок видит
       // 'no options available' и войти не может, а хост отвергает любое
       // значение как не-вариант. Это только для authSchema; в roomForm
-      // (правило B5) source штатный — там движок отдаёт каталог карт
-      if (field.options?.source !== undefined) {
+      // (правило B5) source штатный — там движок отдаёт каталог карт.
+      //
+      // Только для контролов со списком: у text/checkbox `source` не читает
+      // никто (formBuilder.resolveOptions зовут лишь buildSelect/buildRadio),
+      // и такое поле работает — отвергать за лишний ключ значило бы отвергать
+      // игру, которая логинит игроков как ни в чём не бывало
+      // по резолвнутому контролу, а не по написанному: 'segmented' — та же
+      // группа вариантов, что radio, и source в ней так же не резолвится
+      if (
+        OPTION_CONTROLS.includes(resolveDescriptor(field.options)?.control) &&
+        field.options?.source !== undefined
+      ) {
         violations.push(
           `authSchema param "${field.name}" declares options.source ` +
             `"${field.options.source}" — the auth form is built without ` +