vimp-engine 0.38.1 → 0.38.3

package/src/lib/loadGamePackage.js

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

package/src/lib/packageLink.js

@@ -1,63 +1,31 @@
-// Ссылка на проект для футеров лобби и формы входа: движок показывает рядом
-// npm-версию, и клик по соседней ячейке ведёт в репозиторий этого пакета.
+// Адрес проекта пакета — его `repository`: ссылка ведёт на саму игру, в том
+// числе закрытую. `homepage` не читается. Фолбэка нет: пакет без repository
+// адреса не получает — страница пакета в npm маскировала бы недостающие
+// метаданные. О пропущенном поле предупреждает правило контракта A7.
 //
-// Источник — `repository` его package.json (иначе `homepage`). Фолбэка нет:
-// пакет, не объявивший ни того, ни другого, ссылки не получает, и ячейка
-// футера остаётся пустой. Это сознательно — прежний фолбэк на страницу пакета
-// в npm давал разнобой («GitHub» у одной игры, «npm» у другой) и молча
-// маскировал недостающие метаданные вместо того, чтобы показать их отсутствие.
-// О пропущенном поле предупреждает правило контракта A7.
-//
-// Хостинг не ограничен github.com: подпись выводится из хоста, поэтому чужой
-// плагин на GitLab получает честную ссылку, а не пустую ячейку.
-//
-// Модуль изоморфный: мастер зовёт resolveProjectUrl для пакета игры
-// (GameCatalog), клиент — для собственного package.json движка
-// (client/lib/engineVersion.js).
+// Хостинг не ограничен github.com. Модуль изоморфный: мастер зовёт
+// resolveProjectUrl для метаданных пакета игры (адрес уходит в реестр игр),
+// devtools — для package.json игры (правило A7).
 
 /**
- * Адрес проекта из package.json, приведённый к https: repository, иначе
- * homepage.
+ * Адрес проекта из package.json, приведённый к http(s): поле repository.
  * @param {Object} pkg - разобранный package.json
- * @returns {string|null} https-URL либо null, если поля нет или это не адрес
+ * @returns {string|null} http(s)-URL либо null, если поля нет или это не адрес
  */
 export function resolveProjectUrl(pkg) {
   if (!pkg || typeof pkg !== 'object') {
     return null;
   }
 
-  const { homepage, repository } = pkg;
+  const { repository } = pkg;
 
   // repository бывает и строкой ("github:user/repo"), и объектом {type, url}
-  const declared =
-    typeof repository === 'string' ? repository : repository?.url;
-
-  // объявленный, но не приводящийся к http(s) repository (пустая строка,
-  // внутренний git-хост) не повод терять валидный homepage: поле проверяется
-  // по результату, а не по факту наличия
-  return normalizeRepository(declared) ?? normalize(homepage);
-}
-
-/**
- * Ссылка футера по готовому адресу проекта.
- * @param {string|null} [url] - результат resolveProjectUrl
- * @returns {{url: string, label: string}|null} null, если адреса нет
- */
-export function projectLink(url) {
-  // адрес перепроверяется, хотя свои вызовы приходят уже из
-  // resolveProjectUrl: функция — публичный экспорт ("./lib/*"), а результат
-  // уходит прямо в href якоря (client/lib/footerLink.js)
-  const value = typeof url === 'string' ? url.trim() : '';
-
-  if (!/^https?:\/\//.test(value)) {
-    return null;
-  }
-
-  return { url: value, label: labelFor(value) };
+  return normalizeRepository(
+    typeof repository === 'string' ? repository : repository?.url,
+  );
 }
 
-// шорткат "user/repo" — семантика поля repository (так его читает npm), в
-// homepage такая строка означала бы относительный путь, а не адрес на GitHub
+// шорткат "user/repo" — семантика поля repository (так его читает npm)
 function normalizeRepository(raw) {
   const value = typeof raw === 'string' ? raw.trim() : '';
 
@@ -94,8 +62,12 @@ function normalize(raw) {
 
   url = url.replace(/^git\+/, '');
 
-  // scp-форма git@host:user/repo — двоеточие здесь разделитель, не порт
-  const scp = /^git@([^:/]+):(.+)$/.exec(url);
+  // порт SSH (ssh://host:2222/…) к адресу https не относится
+  url = url.replace(/^(ssh:\/\/(?:[^/@]*@)?[^/:@]+):\d+(?=\/|$)/, '$1');
+
+  // scp-форма git@host:user/repo (в том числе с лишним ssh://, как её
+  // нередко пишет npm) — двоеточие здесь разделитель, не порт
+  const scp = /^(?:ssh:\/\/)?git@([^:/]+):(.+)$/.exec(url);
 
   if (scp) {
     url = `https://${scp[1]}/${scp[2]}`;
@@ -116,22 +88,8 @@ function normalize(raw) {
       // в href он уехал бы в DOM и историю браузера
       .replace(/^(https?:\/\/)[^/@]*@/, '$1')
       .replace(/\.git(?=$|[#?])/, '')
-      // npm сам дописывает "#readme" в homepage при генерации package.json
+      // якорь #readme в адресе репозитория ссылке не нужен
       .replace(/#readme$/, '')
       .replace(/\/+$/, '')
   );
 }
-
-// подпись ячейки: у наших пакетов это всегда GitHub, у чужого хостинга —
-// его хост, чтобы подпись не врала об источнике
-function labelFor(url) {
-  let host;
-
-  try {
-    host = new URL(url).hostname.replace(/^www\./, '');
-  } catch {
-    return 'Website';
-  }
-
-  return host === 'github.com' ? 'GitHub' : host;
-}

package/src/lib/validators.js

@@ -13,7 +13,7 @@ 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)
+// ник профиля: копия правила auth-сервиса (валидаторы auth-сервиса)
 // — общей рантайм-зависимости у пакетов нет. Строже isValidName: внутри ника
 // допустим только обычный пробел, не любой \s
 const NICK_REGEXP = new RegExp('^[a-zA-Z]([\\w #]{0,13})[\\w]{1}$');
@@ -272,8 +272,8 @@ export const clampLimit = (value, fallback, max) => {
 // на его стороне — минута (lobbyConfig.playerData.minFlushInterval), столько
 // игр в неё не влезает.
 //
-// Множитель СВЯЗАН с rank.maxPoints auth-сервиса (packages/auth/src/config/
-// auth.js): мастер не должен пропускать то, что auth отклонит. Отклонённое
+// Множитель СВЯЗАН с rank.maxPoints из конфига auth-сервиса: мастер
+// не должен пропускать то, что auth отклонит. Отклонённое
 // тело для хоста неустранимо — PlayerDataSync повторял бы его до конца жизни
 // комнаты, — поэтому при правке per-game maxGameScore проверяется и потолок
 // суммы на той стороне.

package/src/standalone/index.js

@@ -10,7 +10,7 @@ import { ensureGameShell } from '../client/views/gameShell.js';
 // репозитория игры — `npm run dev` открывает вкладку с работающим матчем без
 // мастера, без входа и без экрана лобби.
 //
-// Отличия от прода (осознанные, см. plan/standalone-sdk/README.md):
+// Отличия от прода (осознанные):
 //   - хост крутится в главном потоке (inline), а не в Worker'е: HostPlugin
 //     непередаваем постмесседжем, а SDK получает живой объект плагина;
 //   - личность гостевая (ник из формы или из playerName), рейтинг и
@@ -44,7 +44,7 @@ import { ensureGameShell } from '../client/views/gameShell.js';
  * @param {boolean} [options.devMode] - room.isDevMode: рекордер и хостовый
  *   CONSOLE-лог.
  * @param {string|null} [options.reportUrl] - Адрес приёма журнала клиентских
- *   ошибок (`POST`, формат — docs/en/client.md, «Error reporting»). По
+ *   ошибок (`POST`, формат — docs.vimp.lgick.dev/en/standalone). По
  *   умолчанию `null`: в solo нет бокса, и отчёты не отправляются.
  * @returns {Promise<Object>} `{ stop() }` — останов матча.
  */
@@ -71,10 +71,10 @@ export async function startStandaloneGame({
   // возможность, которой в этой сборке движка нет, иначе всплыла бы где-то
   // в середине хендшейка непрозрачной ошибкой. Мастера тут нет, а значит нет
   // и GameManifest с его `requires` — источником служат сами половины
-  // плагина (необязательное поле `requires`, docs/en/plugin-api.md) либо
-  // опция вызова, если встраивающий знает лучше. Одна проверка вместо двух:
-  // сообщение адресовано разработчику встраивания, делить его по половинам
-  // незачем
+  // плагина (необязательное поле `requires`, docs.vimp.lgick.dev/en/plugin-api)
+  // либо опция вызова, если встраивающий знает лучше. Одна проверка вместо
+  // двух: сообщение адресовано разработчику встраивания, делить его по
+  // половинам незачем
   requireCompatible({
     id: hostPlugin.id,
     // mergeRequires, а не спред: строка вместо массива ('accolades' —

package/tests/fixtures/generations/gen-api3/README.md

@@ -1,7 +1,7 @@
 # gen-api3 — ЗАМОРОЖЕНО
 
 Снимок плагина 2026-08-29, поколение `engineApi: 3`.
-Не править: правка фикстуры маскирует слом совместимости
-(этап 1 плана `plan/plugin-forward-compat`). Новое поколение
+Не править: правка фикстуры маскирует слом совместимости.
+Новое поколение
 добавляется копированием текущего `../../miniGame`, а не правкой
 этого каталога.

package/tests/fixtures/generations/gen-api4/README.md

@@ -1,7 +1,7 @@
 # gen-api4 — ЗАМОРОЖЕНО
 
 Снимок плагина 2026-08-29, поколение `engineApi: 4`.
-Не править: правка фикстуры маскирует слом совместимости
-(этап 1 плана `plan/plugin-forward-compat`). Новое поколение
+Не править: правка фикстуры маскирует слом совместимости.
+Новое поколение
 добавляется копированием текущего `../../miniGame`, а не правкой
 этого каталога.

package/bin/vimp-surface.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import {
-  collectSurface,
-  formatSurface,
-  diffSurface,
-} from '../src/devtools/surface/collect.js';
-
-// CLI слепка плагинной поверхности (этап 1 плана plugin-forward-compat):
-// без флага печатает расхождение с закоммиченным contract/surface.json и
-// возвращает 1 при нарушении И1/И3, с --write перезаписывает слепок.
-// Внутренний инструмент репозитория движка: в поле `bin` публикуемого
-// пакета он не значится.
-
-const SURFACE_PATH = fileURLToPath(
-  new URL('../contract/surface.json', import.meta.url),
-);
-
-const USAGE = `Usage: vimp-surface [options]
-
-  --write   rewrite contract/surface.json with the collected surface
-  --help
-`;
-
-async function main(argv) {
-  if (argv.includes('--help')) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-
-  const surface = await collectSurface();
-
-  if (argv.includes('--write')) {
-    await mkdir(path.dirname(SURFACE_PATH), { recursive: true });
-    await writeFile(SURFACE_PATH, formatSurface(surface));
-    process.stdout.write(`surface: written ${SURFACE_PATH}\n`);
-
-    return 0;
-  }
-
-  let committed;
-
-  try {
-    committed = JSON.parse(await readFile(SURFACE_PATH, 'utf8'));
-  } catch {
-    process.stderr.write(
-      `surface: no snapshot at ${SURFACE_PATH} — run ` +
-        '`npm run surface:update` to create it\n',
-    );
-
-    return 1;
-  }
-
-  const { violations, additions } = diffSurface(committed, surface);
-
-  for (const addition of additions) {
-    process.stdout.write(`surface: добавлено ${addition}\n`);
-  }
-
-  if (additions.length > 0 && violations.length === 0) {
-    process.stdout.write(
-      'слепок устарел, запусти `npm run surface:update` (добавление ' +
-        'поверхности совместимость не ломает)\n',
-    );
-  }
-
-  for (const violation of violations) {
-    process.stderr.write(`${violation}\n\n`);
-  }
-
-  if (violations.length === 0 && additions.length === 0) {
-    process.stdout.write('surface: слепок совпадает\n');
-  }
-
-  return violations.length > 0 ? 1 : 0;
-}
-
-main(process.argv.slice(2)).then(
-  code => {
-    process.exitCode = code;
-  },
-  err => {
-    process.stderr.write(`${err.message}\n`);
-    process.exitCode = 1;
-  },
-);

package/src/config/env.js

@@ -1,104 +0,0 @@
-// Env-переопределения серверного конфига (Этап 4 плана standalone-sdk).
-// Раньше этот блок жил в master/main.js под условием NODE_ENV=production:
-// лобби-мастер в dev работает на дефолтах конфига. Dedicated-серверу так
-// нельзя — игру, порт и настройки комнаты он получает только из окружения,
-// в том числе локально, — поэтому чтение вынесено сюда и применяется каждым
-// входом по своим правилам.
-
-/**
- * Применяет env-переопределения к конфигу мастера.
- * @param {Object} config - Синглтон lib/config.js.
- * @param {Object} [env] - Окружение (по умолчанию process.env).
- */
-export function applyMasterEnv(config, env = process.env) {
-  if (env.VIMP_DOMAIN) {
-    config.set('master:domain', env.VIMP_DOMAIN);
-  }
-
-  // порт серверного процесса
-  if (env.VIMP_MASTER_PORT) {
-    config.set('master:port', Number(env.VIMP_MASTER_PORT));
-  }
-
-  // домен central auth-сервиса — попадает в CSP connect-src, т.к. лобби
-  // делает туда прямые fetch (ручки профиля)
-  if (env.VIMP_AUTH_SERVICE_URL) {
-    config.set('master:security:authServiceUrl', env.VIMP_AUTH_SERVICE_URL);
-  }
-
-  // корень хранилища игровых пакетов (направление master-game-registry) —
-  // в проде это смонтированный том, переживающий пересоздание контейнера
-  if (env.VIMP_GAMES_DIR) {
-    config.set('master:gameStore:dir', env.VIMP_GAMES_DIR);
-  }
-
-  // общий секрет бокса и auth-сервиса для пересылки журнала клиентских
-  // ошибок (plan/client-reports)
-  if (env.VIMP_CLIENT_REPORTS_TOKEN) {
-    config.set('master:clientReports:token', env.VIMP_CLIENT_REPORTS_TOKEN);
-  }
-}
-
-// минимальная длина VIMP_ROOM_SECRET_KEY — ключ HMAC-SHA256
-const ROOM_SECRET_KEY_MIN_BYTES = 32;
-
-/**
- * Ключ секрета комнаты (host-migration, этап 2): roomSecret = HMAC(ключ,
- * roomId:epoch:hostUserId) — им хост доказывает комнату после рестарта
- * мастера. В production обязателен; в dev без него генерируется случайный на
- * время процесса (комнаты после рестарта dev-мастера не восстанавливаются).
- * @param {Object} [env] - Окружение (по умолчанию process.env).
- * @param {Object} opts
- * @param {boolean} opts.isProduction
- * @param {Function} opts.randomBytes - crypto.randomBytes.
- * @returns {{ key: string|Buffer, ephemeral: boolean }}
- */
-export function readRoomSecretKey(
-  env = process.env,
-  { isProduction, randomBytes },
-) {
-  const key = env.VIMP_ROOM_SECRET_KEY;
-
-  if (key) {
-    if (Buffer.byteLength(key) < ROOM_SECRET_KEY_MIN_BYTES) {
-      throw new Error(
-        `VIMP_ROOM_SECRET_KEY: at least ${ROOM_SECRET_KEY_MIN_BYTES} bytes required`,
-      );
-    }
-
-    return { key, ephemeral: false };
-  }
-
-  if (isProduction) {
-    throw new Error('VIMP_ROOM_SECRET_KEY must be set in production');
-  }
-
-  return { key: randomBytes(ROOM_SECRET_KEY_MIN_BYTES), ephemeral: true };
-}
-
-/**
- * Настройки комнаты dedicated-сервера: VIMP_DEDICATED_ROOM — JSON-объект
- * (map, maxPlayers, roundTime, mapTime, friendlyFire, seed). Мусор в
- * переменной не должен ронять процесс молча — отказ именованный.
- * @param {Object} [env] - Окружение (по умолчанию process.env).
- * @returns {Object} Переопределения комнаты.
- */
-export function readDedicatedRoom(env = process.env) {
-  if (!env.VIMP_DEDICATED_ROOM) {
-    return {};
-  }
-
-  let room;
-
-  try {
-    room = JSON.parse(env.VIMP_DEDICATED_ROOM);
-  } catch (e) {
-    throw new Error(`VIMP_DEDICATED_ROOM: invalid JSON — ${e.message}`);
-  }
-
-  if (!room || typeof room !== 'object' || Array.isArray(room)) {
-    throw new Error('VIMP_DEDICATED_ROOM: expected a JSON object');
-  }
-
-  return room;
-}