vimp-engine 0.24.2 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.24.2",
+  "version": "0.26.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,215 @@
+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();
+
+    // после loadAdmin, а не до: renderAdmin чистит строку отказа панели, и
+    // предупреждение, показанное раньше, стёрлось бы тем же тиком
+    if (json?.warning) {
+      this.publisher.emit('warning', { scope: 'admin', code: json.warning });
+    }
+  }
+
+  _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];