vimp-engine 0.24.2 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {
@@ -46,6 +46,7 @@
     "express": "^5.1.0",
     "howler": "^2.2.4",
     "pixi.js": "8.19.0",
+    "tar": "^7.5.1",
     "uuid": "^13.0.0",
     "vite-express": "^0.21.1",
     "ws": "^8.18.3"

package/src/client/components/controller/Games.js

@@ -0,0 +1,99 @@
+import Publisher from '../../../lib/Publisher.js';
+
+// Singleton GamesCtrl
+
+let gamesCtrl;
+
+// Контроллер реестра игр: связывает view-события с моделью, как LobbyCtrl.
+// Собственного сетевого I/O не делает. Наружу (main.js) пробрасывает только
+// 'staged' — манифест застейдженной версии, который нужно положить в каталог
+// вкладки, чтобы админ мог поднять по нему комнату
+export default class GamesCtrl {
+  constructor(model, view) {
+    if (gamesCtrl) {
+      return gamesCtrl;
+    }
+
+    gamesCtrl = this;
+
+    this._model = model;
+    this._view = view;
+
+    this.publisher = new Publisher();
+
+    const vp = view.publisher;
+
+    vp.on('open-mine', 'openMine', this);
+    vp.on('open-moderation', 'openModeration', this);
+    vp.on('submit', 'submit', this);
+    vp.on('update-version', 'updateVersion', this);
+    vp.on('filter', 'filter', this);
+    vp.on('stage', 'stage', this);
+    vp.on('approve', 'approve', this);
+    vp.on('reject', 'reject', this);
+    vp.on('disable', 'disable', this);
+    vp.on('load-versions', 'loadVersions', this);
+
+    model.publisher.on('staged', 'staged', this);
+  }
+
+  // роль решает только видимость кнопки модерации: доступ к данным
+  // проверяет мастер, а запись — auth-сервис по роли из БД
+  setAdmin(isAdmin) {
+    this._view.setAdmin(isAdmin);
+
+    // черновики, уже скачанные этим мастером, возвращаются в каталог вкладки
+    // сразу: после матча лобби перезагружает страницу, и без этого админ
+    // терял бы из селектора версию, которую сам же поставил на тест
+    if (isAdmin) {
+      this._model.loadStaged();
+    }
+  }
+
+  openMine() {
+    this._view.show(false);
+    this._model.loadMine();
+  }
+
+  openModeration() {
+    this._view.show(true);
+    this._model.loadMine();
+    this._model.loadAdmin();
+  }
+
+  submit(form) {
+    this._model.submit(form);
+  }
+
+  updateVersion({ id, version }) {
+    this._model.requestVersion(id, version);
+  }
+
+  filter(status) {
+    this._model.setFilter(status);
+  }
+
+  stage({ id, version }) {
+    this._model.stage(id, version);
+  }
+
+  approve({ id }) {
+    this._model.moderate(id, { status: 'approved' });
+  }
+
+  reject({ id, note }) {
+    this._model.moderate(id, { status: 'rejected', note });
+  }
+
+  disable({ id }) {
+    this._model.moderate(id, { status: 'disabled' });
+  }
+
+  loadVersions({ id }) {
+    this._model.loadVersions(id);
+  }
+
+  staged(data) {
+    this.publisher.emit('staged', data);
+  }
+}

package/src/client/components/model/Games.js

@@ -0,0 +1,209 @@
+import Publisher from '../../../lib/Publisher.js';
+
+// Singleton GamesModel
+
+let gamesModel;
+
+// коды отказов мастера и auth-сервиса — единственное, что приезжает вместо
+// текста; человеческая формулировка живёт во view, как в LobbyAuthView
+const REQUEST_FAILED = 'requestFailed';
+
+// Модель реестра игр в лобби (master-game-registry, этап 4): заявки
+// вызывающего, очередь модерации и «Test» новой версии. В отличие от
+// LobbyModel сетевые запросы делает сама — это простой REST к мастеру,
+// сигнальный сокет здесь ни при чём (тот же приём, что у LobbyAuthModel с
+// POST /nick). DOM не трогает.
+export default class GamesModel {
+  /**
+   * @param {Object} config - Блок `games` конфига лобби (urls, statuses).
+   * @param {Function} getToken - Возвращает identity-токен лобби.
+   */
+  constructor(config, getToken) {
+    if (gamesModel) {
+      return gamesModel;
+    }
+
+    gamesModel = this;
+
+    this._config = config;
+    this._getToken = getToken;
+
+    this._mine = [];
+    this._all = [];
+    this._versions = new Map(); // id игры -> версии, опубликованные в npm
+    this._filter = config.defaultStatus;
+
+    this.publisher = new Publisher();
+  }
+
+  getFilter() {
+    return this._filter;
+  }
+
+  // фильтр очереди модерации: строки уже загружены, повторный запрос не нужен
+  setFilter(status) {
+    this._filter = status;
+    this._emitAdmin();
+  }
+
+  async loadMine() {
+    const { ok, json } = await this._request(this._config.urls.mine);
+
+    if (!ok) {
+      this._fail('mine', json);
+      return;
+    }
+
+    this._mine = json.games ?? [];
+    this.publisher.emit('mine-changed', this._mine);
+  }
+
+  // застейдженные версии, уже лежащие на этом мастере: после перезагрузки
+  // вкладки (а lobby-режим перезагружает её после каждого матча) черновик
+  // иначе исчезал бы из селектора, оставаясь скачанным
+  async loadStaged() {
+    const { ok, json } = await this._request(this._config.urls.staged);
+
+    if (!ok) {
+      return;
+    }
+
+    (json.manifests ?? []).forEach(({ id, version, manifest }) => {
+      this.publisher.emit('staged', { id, version, manifest });
+    });
+  }
+
+  async loadAdmin() {
+    const { ok, json } = await this._request(this._config.urls.admin);
+
+    if (!ok) {
+      this._fail('admin', json);
+      return;
+    }
+
+    this._all = json.games ?? [];
+    this._emitAdmin();
+  }
+
+  // список опубликованных версий пакета: индикатор «есть версия новее
+  // раздаваемой». Запрашивается по игре, а не для всей очереди сразу —
+  // каждый ответ стоит похода мастера в npm registry
+  async loadVersions(id) {
+    const { ok, json } = await this._request(this._config.urls.versions(id));
+
+    if (!ok) {
+      return;
+    }
+
+    this._versions.set(id, json.versions ?? []);
+    this._emitAdmin();
+  }
+
+  async submit(form) {
+    const { ok, json } = await this._request(this._config.urls.submit, {
+      method: 'POST',
+      body: form,
+    });
+
+    if (!ok) {
+      this._fail('mine', json);
+      return;
+    }
+
+    // отдельным событием, а не внутри loadMine: список перерисовывается и
+    // при открытии панели, а чистить форму нужно ровно на успехе отправки —
+    // иначе повторная отправка того же содержимого выглядит как «кнопка не
+    // сработала» (ответ gameExists при заполненных полях)
+    this.publisher.emit('submitted');
+
+    await this.loadMine();
+  }
+
+  async requestVersion(id, version) {
+    const { ok, json } = await this._request(this._config.urls.version(id), {
+      method: 'POST',
+      body: { version },
+    });
+
+    if (!ok) {
+      this._fail('mine', json);
+      return;
+    }
+
+    await this.loadMine();
+  }
+
+  // «Test»: мастер качает версию и кладёт её в каталог не раздаваемой.
+  // Манифест едет наружу — по нему вкладка админа поднимает комнату
+  async stage(id, version) {
+    const { ok, json } = await this._request(this._config.urls.stage(id), {
+      method: 'POST',
+      body: { version },
+    });
+
+    if (!ok) {
+      this._fail('admin', json);
+      return;
+    }
+
+    this.publisher.emit('staged', { id, version: json.version, manifest: json.manifest });
+    await this.loadAdmin();
+  }
+
+  async moderate(id, patch) {
+    const { ok, json } = await this._request(this._config.urls.moderate(id), {
+      method: 'PATCH',
+      body: patch,
+    });
+
+    if (!ok) {
+      this._fail('admin', json);
+      return;
+    }
+
+    await this.loadAdmin();
+  }
+
+  _emitAdmin() {
+    this.publisher.emit('admin-changed', {
+      games: this._all.filter(game => game.status === this._filter),
+      filter: this._filter,
+      versions: this._versions,
+    });
+  }
+
+  // ошибки приезжают двумя формами: список проблем пакета от мастера
+  // ({errors: [...]}, структурная проверка до записи в реестр) и код отказа
+  // auth-сервиса ({error: '...'}). Наружу уходит одна
+  _fail(scope, json) {
+    const errors = Array.isArray(json?.errors)
+      ? json.errors.map(error => ({ name: 'package', error }))
+      : [{ name: 'request', error: json?.error ?? REQUEST_FAILED }];
+
+    this.publisher.emit('error', { scope, errors });
+  }
+
+  async _request(url, { method = 'GET', body } = {}) {
+    const token = this._getToken();
+
+    if (!token) {
+      return { ok: false, json: { error: 'unauthorized' } };
+    }
+
+    try {
+      const res = await fetch(url, {
+        method,
+        headers: {
+          authorization: `Bearer ${token}`,
+          ...(body ? { 'content-type': 'application/json' } : {}),
+        },
+        body: body ? JSON.stringify(body) : undefined,
+      });
+      const json = await res.json().catch(() => null);
+
+      return { ok: res.ok, json };
+    } catch {
+      return { ok: false, json: { error: 'network' } };
+    }
+  }
+}

package/src/client/components/model/LobbyAuth.js

@@ -117,6 +117,14 @@ export default class LobbyAuthModel {
     return this._nick;
   }
 
+  // роль из payload уже проверенного на срок токена (master-game-registry,
+  // этап 4). Это ПОДСКАЗКА ИНТЕРФЕЙСУ — показывать ли кнопку модерации, — а
+  // не право: доступ к данным проверяет мастер по подписи, а запись —
+  // auth-сервис, перечитывая роль из БД
+  getRole() {
+    return decodeJwtPayload(this._identityToken)?.role ?? 'user';
+  }
+
   _restore(tokenStorageKey) {
     const token = localStorage[tokenStorageKey];
 

package/src/client/components/view/Games.js

@@ -0,0 +1,341 @@
+import Publisher from '../../../lib/Publisher.js';
+import { renderFormErrors } from '../../lib/formBuilder.js';
+
+// Singleton GamesView
+
+let gamesView;
+
+// коды отказов мастера/auth — человеческая формулировка живёт здесь, как в
+// LobbyAuthView: модель кодов не переводит, view не ходит в сеть.
+// Язык интерфейса — английский, как и в остальном лобби
+const ERROR_MESSAGES = {
+  unauthorized: 'Please sign in again',
+  forbidden: 'Not enough rights',
+  network: 'Network unavailable, try again',
+  requestFailed: 'Request failed',
+  // лимитер мастера (5 заявок в минуту на пользователя) считает и заявки,
+  // отклонённые по формату, — без своей строки код уезжал бы в интерфейс сырым
+  tooManyRequests: 'Too many requests, try again in a minute',
+  gameExists: 'A game with this id already exists',
+  tooManyGames: 'Too many submissions from one author',
+  unknownGame: 'Game is not in the registry',
+  invalidGameId: 'Invalid game id',
+  invalidPackageName: 'Invalid npm package name',
+  invalidVersion: 'Invalid version',
+  invalidTitle: 'Invalid title',
+  invalidRepoUrl: 'Invalid repository URL',
+  invalidMaxGameScore: 'Invalid score cap',
+  authServiceUnavailable: 'Registry service unavailable',
+};
+
+const STATUS_TITLES = {
+  pending: 'in review',
+  approved: 'published',
+  rejected: 'rejected',
+  disabled: 'disabled',
+};
+
+// Представление реестра игр: списки заявок и очереди модерации, фильтры,
+// строки ошибок. В сеть не ходит и состояния не держит — рисует то, что
+// пришло событием модели, и публикует намерения пользователя
+export default class GamesView {
+  /**
+   * @param {Object} model - GamesModel (источник событий).
+   * @param {Object} config - Блок `games` конфига лобби.
+   */
+  constructor(model, config) {
+    if (gamesView) {
+      return gamesView;
+    }
+
+    gamesView = this;
+
+    const { elems } = config;
+
+    this._config = config;
+    this._elems = elems;
+
+    this._panel = document.getElementById(elems.panelId);
+    this._lobby = document.getElementById(elems.lobbyId);
+    this._openMine = document.getElementById(elems.openMineBtnId);
+    this._openModeration = document.getElementById(elems.openModerationBtnId);
+    this._close = document.getElementById(elems.closeBtnId);
+
+    this._mineList = document.getElementById(elems.mineListId);
+    this._submitForm = document.getElementById(elems.submitFormId);
+    this._submitError = document.getElementById(elems.submitErrorId);
+
+    this._moderation = document.getElementById(elems.moderationId);
+    this._adminList = document.getElementById(elems.adminListId);
+    this._adminError = document.getElementById(elems.adminErrorId);
+    this._filters = document.getElementById(elems.filtersId);
+
+    this._fields = new Map(
+      Object.entries(elems.fieldIds).map(([name, id]) => [
+        name,
+        document.getElementById(id),
+      ]),
+    );
+
+    this.publisher = new Publisher();
+
+    this._openMine.onclick = () => this.publisher.emit('open-mine');
+    this._openModeration.onclick = () => this.publisher.emit('open-moderation');
+    this._close.onclick = () => this.hide();
+
+    this._submitForm.onsubmit = e => {
+      e.preventDefault();
+      this.publisher.emit('submit', this._readForm());
+    };
+
+    this._renderFilters();
+
+    const mp = model.publisher;
+
+    mp.on('submitted', 'clearForm', this);
+    mp.on('mine-changed', 'renderMine', this);
+    mp.on('admin-changed', 'renderAdmin', this);
+    mp.on('error', 'renderError', this);
+  }
+
+  // кнопку модерации показывает не сама панель, а роль вызывающего
+  // (main.js по LobbyAuthModel.getRole())
+  setAdmin(isAdmin) {
+    this._openModeration.style.display = isAdmin ? '' : 'none';
+  }
+
+  show(moderation = false) {
+    this._panel.style.display = 'flex';
+    this._lobby.style.display = 'none';
+    this._moderation.style.display = moderation ? 'block' : 'none';
+  }
+
+  hide() {
+    // закрытой панели закрывать нечего: возврат черновиков после
+    // перезагрузки идёт тем же событием 'staged', что и «Test», и не должен
+    // трогать разметку лобби
+    if (this._panel.style.display === 'none') {
+      return;
+    }
+
+    this._panel.style.display = 'none';
+    this._lobby.style.display = 'flex';
+  }
+
+  // заявка ушла — поля пустые: следующая отправка начинается с чистой формы
+  clearForm() {
+    this._fields.forEach(field => {
+      field.value = '';
+    });
+  }
+
+  renderMine(games) {
+    this._submitError.textContent = '';
+    this._mineList.textContent = '';
+
+    (games || []).forEach(game => {
+      const item = document.createElement('li');
+
+      item.className = 'games-item';
+      item.appendChild(
+        this._line(
+          `${game.title ? `${game.title} · ` : ''}${game.id} — ` +
+            `${game.packageName} @ ${game.version ?? '—'}`,
+          'games-item-title',
+        ),
+      );
+      item.appendChild(this._line(this._statusLine(game)));
+      this._appendRepo(item, game.repoUrl);
+
+      if (game.moderatorNote) {
+        item.appendChild(this._line(`Note: ${game.moderatorNote}`));
+      }
+
+      // заявка на новую версию своей игры: поле рядом со строкой, а не
+      // отдельной формой — версия относится к конкретной заявке
+      const version = document.createElement('input');
+      const send = document.createElement('input');
+
+      version.type = 'text';
+      version.className = 'field-text games-version-input';
+      version.placeholder = 'New version';
+      send.type = 'button';
+      send.value = 'Update version';
+      send.onclick = () =>
+        this.publisher.emit('update-version', { id: game.id, version: version.value.trim() });
+
+      item.appendChild(version);
+      item.appendChild(send);
+      this._mineList.appendChild(item);
+    });
+  }
+
+  renderAdmin({ games, filter, versions }) {
+    this._adminError.textContent = '';
+    this._adminList.textContent = '';
+    this._markFilter(filter);
+
+    (games || []).forEach(game => {
+      this._adminList.appendChild(this._adminItem(game, versions));
+    });
+  }
+
+  renderError({ scope, errors }) {
+    const container = scope === 'admin' ? this._adminError : this._submitError;
+
+    renderFormErrors(
+      container,
+      errors.map(({ name, error }) => ({
+        name,
+        label: name,
+        error: ERROR_MESSAGES[error] ?? error,
+      })),
+    );
+  }
+
+  _adminItem(game, versions) {
+    const item = document.createElement('li');
+    const published = versions?.get(game.id) ?? [];
+    const latest = published[published.length - 1];
+
+    item.className = 'games-item';
+    item.appendChild(
+      this._line(
+        `${game.title ? `${game.title} · ` : ''}${game.id} — ${game.packageName}`,
+        'games-item-title',
+      ),
+    );
+    // у игр, засеянных миграцией, автора нет вовсе: без запасного прочерка
+    // в строке печаталось бы литеральное "null"
+    item.appendChild(this._line(`Author: ${game.authorNick ?? game.authorUserId ?? '—'}`));
+    this._appendRepo(item, game.repoUrl);
+    item.appendChild(
+      this._line(
+        `Served: ${game.version ?? '—'}; requested: ${game.pendingVersion ?? '—'}` +
+          (latest ? `; in npm: ${latest}` : ''),
+      ),
+    );
+    item.appendChild(this._line(this._statusLine(game)));
+
+    if (game.local) {
+      item.appendChild(
+        this._line(
+          `On this master: ${game.local.downloaded ? 'downloaded' : 'not downloaded'}` +
+            (game.local.stagedVersion ? `; staged ${game.local.stagedVersion}` : '') +
+            (game.local.lastError ? `; error: ${game.local.lastError}` : ''),
+        ),
+      );
+    }
+
+    const note = document.createElement('input');
+
+    note.type = 'text';
+    note.className = 'field-text games-note-input';
+    note.placeholder = 'Rejection reason';
+
+    item.appendChild(note);
+    item.appendChild(
+      this._button('Test', () =>
+        this.publisher.emit('stage', {
+          id: game.id,
+          version: game.pendingVersion ?? game.version,
+        }),
+      ),
+    );
+    item.appendChild(
+      this._button('Approve', () => this.publisher.emit('approve', { id: game.id })),
+    );
+    item.appendChild(
+      this._button('Reject', () =>
+        this.publisher.emit('reject', { id: game.id, note: note.value.trim() }),
+      ),
+    );
+    item.appendChild(
+      this._button('Disable', () => this.publisher.emit('disable', { id: game.id })),
+    );
+    item.appendChild(
+      this._button('npm versions', () =>
+        this.publisher.emit('load-versions', { id: game.id }),
+      ),
+    );
+
+    return item;
+  }
+
+  // Ссылка на репозиторий игры. Протокол проверяется и здесь, хотя auth уже
+  // принимает только http(s): href — единственное место представления, где
+  // содержимое поля становится исполняемым (javascript:), и полагаться на
+  // одну проверку на другой стороне сети тут не стоит
+  _appendRepo(item, url) {
+    if (typeof url !== 'string' || !/^https?:\/\//i.test(url)) {
+      return;
+    }
+
+    const line = document.createElement('div');
+    const link = document.createElement('a');
+
+    link.href = url;
+    link.textContent = url;
+    link.target = '_blank';
+    link.rel = 'noopener noreferrer';
+    line.appendChild(link);
+    item.appendChild(line);
+  }
+
+  _statusLine(game) {
+    const status = STATUS_TITLES[game.status] ?? game.status;
+    const date = game.createdAt ? new Date(game.createdAt).toLocaleDateString() : '';
+
+    return date ? `Status: ${status} (submitted ${date})` : `Status: ${status}`;
+  }
+
+  _renderFilters() {
+    this._filterButtons = new Map();
+
+    this._config.statuses.forEach(({ id, title }) => {
+      const btn = this._button(title, () => this.publisher.emit('filter', id));
+
+      btn.className = 'games-filter-btn';
+      this._filterButtons.set(id, btn);
+      this._filters.appendChild(btn);
+    });
+  }
+
+  _markFilter(filter) {
+    this._filterButtons.forEach((btn, id) => {
+      btn.classList.toggle('active', id === filter);
+    });
+  }
+
+  _button(value, onclick) {
+    const btn = document.createElement('input');
+
+    btn.type = 'button';
+    btn.value = value;
+    btn.onclick = onclick;
+
+    return btn;
+  }
+
+  _line(text, className) {
+    const line = document.createElement('div');
+
+    line.textContent = text;
+
+    if (className) {
+      line.className = className;
+    }
+
+    return line;
+  }
+
+  _readForm() {
+    const form = {};
+
+    this._fields.forEach((field, name) => {
+      form[name] = field.value.trim();
+    });
+
+    return form;
+  }
+}

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: {