vimp-engine 0.38.1 → 0.38.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lgick
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,9 +1,15 @@
 # vimp-engine
 
-VIMP — движок-приложение: мастер (лобби, WebRTC-сигналинг), P2P-транспорт,
-Worker-хост, мета-модули матча, MVC-каркас клиента. Игровые правила
-(например, `@vimp-games/tanks`) подключаются динамически через
-[plugin-api](https://github.com/lgick/vimp/blob/main/docs/en/plugin-api.md)
-— этот пакет их не содержит.
+The VIMP engine SDK for game plugins: the browser host and client runtime,
+the standalone mode (`vimp-engine/standalone`) and the CLI tools `vimp-sim`
+and `vimp-contract`. Game rules live in separate plugin packages that the
+engine loads at runtime through the
+[plugin contract](https://docs.vimp.lgick.dev/en/plugin-api).
 
-Документация: https://github.com/lgick/vimp/tree/main/docs/en
+Start a game:
+
+```bash
+npm create vimp-game my-game
+```
+
+Documentation: https://docs.vimp.lgick.dev

package/bin/vimp-sim.js

@@ -40,8 +40,8 @@ const BUILTIN_NOTICE =
   'notice: the built-in smoke scenario is running against --game. It only\n' +
   'notice: proves the loop closes on this plugin: key coverage (invariant 2)\n' +
   'notice: and prediction drift (invariant 9) are skipped — both need a\n' +
-  'notice: scenario written for your game. See § Scenario format in the\n' +
-  "notice: engine's docs/en/debugging.md (github.com/lgick/vimp), then run\n" +
+  'notice: scenario written for your game. See § Scenario format at\n' +
+  'notice: https://docs.vimp.lgick.dev/en/debugging#scenario-format, then run\n' +
   'notice: vimp-sim --scenario <file>.\n\n';
 
 // типичная опечатка «--core без --game»: фикстурное ядро — обычный JS и

package/core/Cargo.toml

@@ -1,10 +1,11 @@
 [package]
 name = "vimp-engine-core"
-version = "0.23.2"
+version = "0.23.3"
 edition = "2024"
-description = "VIMP — движковый каркас симуляции (физика, карта, снапшот-фрейминг, интерполяция/предикт/raycast-примитивы, нав-утилиты). Без wasm-bindgen — обёртки для WASM-ABI собирает game-crate."
+description = "VIMP engine simulation core: physics, map, snapshot framing, interpolation/prediction/raycast primitives, navigation utilities. No wasm-bindgen — the game crate builds the WASM ABI wrappers."
 license = "MIT"
-repository = "https://github.com/lgick/vimp"
+homepage = "https://docs.vimp.lgick.dev/en/core"
+documentation = "https://docs.rs/vimp-engine-core"
 readme = "README.md"
 
 [lib]

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "vimp-engine",
-  "version": "0.38.1",
-  "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
+  "version": "0.38.2",
+  "description": "VIMP engine SDK: browser host and client runtime, standalone mode and CLI tools (vimp-sim, vimp-contract) for VIMP game plugins",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/lgick/vimp.git"
+    "url": "git+ssh://git@github.com/lgick/vimp.git",
+    "directory": "packages/engine"
   },
-  "homepage": "https://github.com/lgick/vimp#readme",
+  "homepage": "https://docs.vimp.lgick.dev",
   "type": "module",
   "engines": {
     "node": ">=20.11.0"
@@ -23,7 +24,12 @@
   },
   "files": [
     "src/lib",
+    "!src/lib/clientIp.js",
+    "!src/lib/rateLimiter.js",
+    "!src/lib/security.js",
     "src/config",
+    "!src/config/env.js",
+    "!src/config/master.js",
     "src/host",
     "src/client",
     "!src/client/_*",
@@ -31,7 +37,8 @@
     "src/devtools",
     "tests/fixtures",
     "core/Cargo.toml",
-    "bin"
+    "bin",
+    "!bin/vimp-surface.js"
   ],
   "scripts": {
     "predev": "node scripts/sync-pixi-vendor.mjs",

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

@@ -13,7 +13,8 @@ export default class AuthView {
   // texts — игровые тексты формы (authSchema.texts: title, sections);
   // сам каркас (auth.pug) нейтрален и текстов игры не содержит.
   // params — та же дескрипторная схема формы, что и у room-формы
-  // (docs/en/plugin-api.md "Form schema"), едет по сети в PS_AUTH_DATA
+  // (docs.vimp.lgick.dev/en/plugin-api "Form schema"), едет по сети в
+  // PS_AUTH_DATA
   constructor(model, elems, texts = null, params = null) {
     if (authView) {
       return authView;
@@ -63,7 +64,8 @@ export default class AuthView {
   }
 
   // строит контролы формы игрока из той же дескрипторной схемы, что и
-  // room-форма (единый formBuilder, docs/en/plugin-api.md "Form schema")
+  // room-форма (единый formBuilder, docs.vimp.lgick.dev/en/plugin-api "Form
+  // schema")
   _renderFields(elems, params) {
     if (!Array.isArray(params)) {
       return;

package/src/client/lib/formBuilder.js

@@ -4,9 +4,9 @@ import { resolveDescriptor } from '../../lib/formControls.js';
 import { toDisplay, toStored, isNumericField } from '../../lib/formUnit.js';
 
 // Общий билдер полей форм (room-форма и auth-форма используют один
-// контракт дескрипторов — docs/en/plugin-api.md, раздел "Form schema").
-// control: 'select'|'text'|'checkbox'|'radio'; все контролы — нативные
-// элементы формы, без визуальной кастомизации.
+// контракт дескрипторов — docs.vimp.lgick.dev/en/plugin-api, раздел "Form
+// schema"). control: 'select'|'text'|'checkbox'|'radio'; все контролы —
+// нативные элементы формы, без визуальной кастомизации.
 //
 // Имя контрола приезжает от игры и разрешается через append-only реестр
 // (lib/formControls.js): имена, выведенные из эксплуатации в v3 ('range',
@@ -270,7 +270,8 @@ const builders = {
 // control» на имени, которое реестр считает живым
 export const FORM_CONTROLS = Object.keys(builders);
 
-// строит одно поле формы по дескриптору (docs/en/plugin-api.md, "Form schema")
+// строит одно поле формы по дескриптору (docs.vimp.lgick.dev/en/plugin-api,
+// "Form schema")
 export function buildField(descriptor, ctx = {}) {
   // алиас выведенного контрола ('range' → numeric 'text') разрешается
   // здесь же, где строится поле, и теми же правилами, что в валидации
@@ -291,10 +292,10 @@ export function buildField(descriptor, ctx = {}) {
 }
 
 // засеивает default каждого дескриптора room-формы значением из roomDefaults
-// (docs/en/plugin-api.md "Form schema": roomDefaults остаётся единственным
-// источником значений по умолчанию); явный descriptor.default, если он есть
-// в схеме, побеждает. Вынесено из populateRoomForm (main.js), чтобы этот же
-// код был накрыт тестом, а не продублирован в нём
+// (docs.vimp.lgick.dev/en/plugin-api "Form schema": roomDefaults остаётся
+// единственным источником значений по умолчанию); явный descriptor.default,
+// если он есть в схеме, побеждает. Вынесено из populateRoomForm (main.js),
+// чтобы этот же код был накрыт тестом, а не продублирован в нём
 export function mergeRoomDefaults(descriptors, roomDefaults) {
   return descriptors.map(descriptor => ({
     default: roomDefaults[descriptor.name],

package/src/client/main.js

@@ -934,7 +934,8 @@ socketMethods[PS_GAME_INFORM_DATA] = data => {
 };
 
 // проигрывает shimmer-волну по логотипу в начале раунда; логотип живёт вне
-// PanelView.containerId, поэтому панель им не управляет (см. docs/en/client.md)
+// PanelView.containerId, поэтому панель им не управляет
+// (см. docs.vimp.lgick.dev/en/client-api)
 const playLogoRoundStart = () => {
   const logo = document.getElementById('logo');
 
@@ -2182,8 +2183,8 @@ let roomFormFields = new Map();
 let roomFormDescriptors = [];
 
 // генерирует форму создания комнаты по явной схеме манифеста (roomForm,
-// docs/en/plugin-api.md "Form schema") — движок не выводит контролы из типа
-// значения, схема плагина полностью описывает форму
+// docs.vimp.lgick.dev/en/plugin-api "Form schema") — движок не выводит контролы
+// из типа значения, схема плагина полностью описывает форму
 function populateRoomForm(manifest) {
   const container = document.getElementById(lobbyConfig.elems.fieldsId);
 
@@ -2569,13 +2570,13 @@ function initLobby() {
   hostBtn?.addEventListener('click', async () => {
     // валидация (pattern/required/min/max) — единственная граница
     // room-формы: она едет клиенту как JSON манифеста, JS-валидаторы
-    // (как в auth-форме) туда не сериализуются (docs/en/plugin-api.md
-    // "Form schema"); авторитетный клампинг всё равно в applyRoomOverrides.js
-    // (вызывается из host.worker.js при создании комнаты). Проверяем до
-    // активации игры: неверная форма не должна стоить загрузки плагина.
-    // arm() и рисует ошибки, и снимает фильтр «только тронутые поля»: клик —
-    // это ответ за форму целиком, включая поля, которых игрок не касался.
-    // Он же чистит блок, когда ошибок нет
+    // (как в auth-форме) туда не сериализуются
+    // (docs.vimp.lgick.dev/en/plugin-api "Form schema"); авторитетный клампинг
+    // всё равно в applyRoomOverrides.js (вызывается из host.worker.js при
+    // создании комнаты). Проверяем до активации игры: неверная форма не должна
+    // стоить загрузки плагина. arm() и рисует ошибки, и снимает фильтр «только
+    // тронутые поля»: клик — это ответ за форму целиком, включая поля, которых
+    // игрок не касался. Он же чистит блок, когда ошибок нет
     if (liveErrors.arm().length) {
       return;
     }

package/src/client/network/WebSocketTransport.js

@@ -5,7 +5,7 @@ import Publisher from '../../lib/Publisher.js';
 // publisher с 'message'/'close', connect/send/close, — поэтому клиентский код
 // про него не знает.
 //
-// Отличия от WebRTC, которые надо держать в голове (см. docs/en/network.md):
+// Отличия от WebRTC, которые надо держать в голове:
 // разделения meta/state тут нет, флаг reliable игнорируется. Значит PING/PONG
 // идут надёжным каналом (замер RTT становится замером TCP-пути), а бэкпрешер
 // вместо дропа позиционных кадров живёт на серверной стороне.

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

@@ -32,7 +32,8 @@ div#lobby(style='display:none')
             label.form-label(for='lobby-game')= 'Select game'
             select#lobby-game.field-select
           //- поля настроек комнаты генерируются по явной схеме roomForm
-          //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
+          //- манифеста активной игры (docs.vimp.lgick.dev/en/plugin-api "Form
+          //- schema")
           div#lobby-fields
           //- ошибки формы (formBuilder.renderFormErrors) и отказ загрузки
           //- плагина выбранной игры — строкой в форме, а не в #tech-informer:

package/src/config/authClient.js

@@ -1,7 +1,6 @@
 // Конфиг клиента профиля лобби. Бандлится в клиентскую сборку, как
 // config/lobby.js — auth-сервис живёт на отдельном домене/порте, поэтому
-// serviceUrl подставляется под конкретный деплой при сборке (см.
-// docs/en/auth.md).
+// serviceUrl подставляется под конкретный деплой при сборке.
 export default {
   // базовый URL центрального auth-сервиса (packages/auth). Дефолт — dev-порт
   // из packages/auth/src/config/auth.js; в проде подставляется Vite'ом из

package/src/config/gameCodes.js

@@ -1,6 +1,6 @@
 // коды игровых информ-сообщений (порт GAME_INFORM_DATA, см.
-// docs/en/network.md) — общий контракт хоста (SocketManager) и клиента
-// (main.js): значение не должно расходиться между ними молча
+// docs.vimp.lgick.dev/en/snapshot) — общий контракт хоста (SocketManager) и
+// клиента (main.js): значение не должно расходиться между ними молча
 export default {
   winnerTeam: [0],
   roundStart: [1],

package/src/config/wsports.js

@@ -1,5 +1,5 @@
-// Номера портов JSON-канала (docs/en/network.md). Реестр append-only, как и
-// остальные словари плагинной поверхности (этап 3 плана
+// Номера портов JSON-канала (docs.vimp.lgick.dev/en/snapshot). Реестр
+// append-only, как и остальные словари плагинной поверхности (этап 3 плана
 // plugin-forward-compat): номер НИКОГДА не переиспользуется и не
 // перенумеровывается — уже опубликованная сборка игры шлёт и слушает те
 // номера, что видела при сборке, и её dist больше никто не тронет.

package/src/devtools/builtinScenario.js

@@ -13,8 +13,8 @@ import { isFixture } from './pluginLoader.js';
 // Ввод начинается на 40-м тике, а не сразу: кадр спавна с force_reset
 // приходит примерно на interpolation.delay (движковый дефолт — 100 мс, тут
 // ~3× запаса) позже входа и чистит удержанные клавиши предиктора
-// (docs/en/debugging.md) — встроенный сценарий не должен демонстрировать
-// ровно ту ловушку, от которой предостерегает документация
+// (docs.vimp.lgick.dev/en/debugging) — встроенный сценарий не должен
+// демонстрировать ровно ту ловушку, от которой предостерегает документация
 const INPUT_DOWN_TICK = 40;
 const INPUT_UP_TICK = 100;
 const TICKS = 120;
@@ -26,7 +26,7 @@ const FIXTURE_UNUSED_KEYS = ['e1'];
 const firstKey = dict => Object.keys(dict ?? {})[0];
 
 // Клавиша для смоука обязана быть удерживаемой: по конвенции playerKeys
-// (docs/en/plugin-api.md) `type: 1` — триггер, у которого 'up'
+// (docs.vimp.lgick.dev/en/plugin-api) `type: 1` — триггер, у которого 'up'
 // игнорируется, и «нажал — отпустил» не даёт ни удержания, ни движения.
 // Порядок объявления в playerKeys контрактом не задан, поэтому берём первую
 // без type; если игра объявила одни триггеры — первую любую, смоук всё равно

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

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

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

@@ -2,9 +2,10 @@ import { ERROR, skip, verdict } from '../result.js';
 
 // vite.config.js проверяется как текст, а не импортом: конфиг —
 // функция от mode и вне Vite не исполняется. Каждый пункт здесь ловит
-// молчаливую поломку сборки, а не стилистику (docs/en/packaging.md):
-// без preserveEntrySignatures default-экспорт плагина вытряхивает
-// tree-shaking, а build.lib всегда инлайнит ассеты.
+// молчаливую поломку сборки, а не стилистику
+// (docs.vimp.lgick.dev/en/packaging): без preserveEntrySignatures
+// default-экспорт плагина вытряхивает tree-shaking, а build.lib всегда инлайнит
+// ассеты.
 const REQUIRED = [
   [/emptyOutDir\s*:\s*false/, 'emptyOutDir: false (two builds share dist/)'],
   [/assetsInlineLimit\s*:\s*0/, 'assetsInlineLimit: 0'],

package/src/devtools/contract/rules/a7-package-repository.js

@@ -1,16 +1,17 @@
 import { WARN, skip, verdict } from '../result.js';
 import { resolveProjectUrl } from '../../../lib/packageLink.js';
 
-// Игра без объявленного репозитория собирается и играется — это не отказ.
-// Но движок показывает ссылку на проект в футере формы входа, и берёт он её
-// только отсюда (фолбэка нет, см. lib/packageLink.js): без поля ячейка
-// футера у игроков останется пустой, а заметить это без подсказки негде.
+// Игра без объявленного homepage/repository собирается и играется — это не
+// отказ. Но движок показывает ссылку на проект в футере формы входа, и берёт
+// он её только из этих полей (фолбэка нет, см. lib/packageLink.js): без них
+// ячейка футера у игроков останется пустой, а заметить это без подсказки негде.
 // Отсюда warn — под --strict он становится ошибкой.
 export default {
   id: 'A7',
   name: 'packageRepository',
   level: WARN,
-  title: 'package.json declares repository (the #auth footer links to it)',
+  title:
+    'package.json declares homepage or repository (the #auth footer links to it)',
 
   check(ctx) {
     if (!ctx.pkg) {

package/src/devtools/contract/rules/c4-component-dependencies.js

@@ -4,11 +4,11 @@ import { SERVICES } from '../../../config/clientServices.js';
 // Движковый пул сервисов держит реестр (config/clientServices.js), но пул
 // ими не исчерпывается: игра доливает туда свои через
 // ClientPlugin.hooks.services(core) — например геометрию предсказанной
-// динамики карты (docs/en/plugin-api.md «hooks.services»). Незнакомое имя не
-// ошибка для движка: part получает undefined и рисует пустоту — карта без
-// assetsBase выглядит как чистый холст без единой строки в консоли, ради
-// этого правило и существует. Правило остаётся ERROR: оно работает на этапе
-// разработки игры, а не в рантайме.
+// динамики карты (docs.vimp.lgick.dev/en/plugin-api «hooks.services»).
+// Незнакомое имя не ошибка для движка: part получает undefined и рисует пустоту
+// — карта без assetsBase выглядит как чистый холст без единой строки в консоли,
+// ради этого правило и существует. Правило остаётся ERROR: оно работает на
+// этапе разработки игры, а не в рантайме.
 //
 // Что именно возвращает `hooks.services(core)`, статически не видно — хук
 // требует живого ядра. Поэтому у плагина есть необязательное поле

package/src/devtools/invariants.js

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

package/src/devtools/pluginLoader.js

@@ -12,9 +12,9 @@ import { loadGamePackage } from '../lib/loadGamePackage.js';
 //   3. ничего         — фикстура miniGame из этого репозитория.
 //
 // entries.wasmNode — новое ОПЦИОНАЛЬНОЕ поле манифеста: конвенция
-// core/pkg-node/ уже описана в docs/en/packaging.md, не хватало только
-// пути в манифесте. Его отсутствие не ошибка — просто игра не прогоняется
-// headless своим настоящим ядром.
+// core/pkg-node/ уже описана в docs.vimp.lgick.dev/en/packaging, не хватало
+// только пути в манифесте. Его отсутствие не ошибка — просто игра не
+// прогоняется headless своим настоящим ядром.
 
 const FIXTURE_DIR = new URL('../../tests/fixtures/miniGame/', import.meta.url);
 

package/src/host/PortMachine.js

@@ -1,9 +1,10 @@
 // Хендшейк-машина клиента, вынутая из host.worker.js: автомат по клиентским
-// портам 0–10 (см. docs/en/network.md). Изоморфна — ни self, ни postMessage,
-// ни DOM: всё, что знает про транспорт, приходит через makeSocket. Поэтому её
-// крутит и Worker браузерного хоста, и inline-хост standalone SDK, и
-// Node-процесс dedicated-сервера: копий автомата быть не должно, иначе они
-// разъедутся ровно так, как разъезжались бы копии createHostRuntime.
+// портам (таблица портов — docs.vimp.lgick.dev/en/snapshot). Изоморфна — ни
+// self, ни postMessage, ни DOM: всё, что знает про транспорт, приходит через
+// makeSocket. Поэтому её крутит и Worker браузерного хоста, и inline-хост
+// standalone SDK, и Node-процесс dedicated-сервера: копий автомата быть не
+// должно, иначе они разъедутся ровно так, как разъезжались бы копии
+// createHostRuntime.
 
 import wsports from '../config/wsports.js';
 import closeCodes from '../config/closeCodes.js';

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,7 +1,7 @@
 // Ссылка на проект для футеров лобби и формы входа: движок показывает рядом
-// npm-версию, и клик по соседней ячейке ведёт в репозиторий этого пакета.
+// npm-версию, и клик по соседней ячейке ведёт на страницу проекта этого пакета.
 //
-// Источник — `repository` его package.json (иначе `homepage`). Фолбэка нет:
+// Источник — `homepage` его package.json (иначе `repository`). Фолбэка нет:
 // пакет, не объявивший ни того, ни другого, ссылки не получает, и ячейка
 // футера остаётся пустой. Это сознательно — прежний фолбэк на страницу пакета
 // в npm давал разнобой («GitHub» у одной игры, «npm» у другой) и молча
@@ -16,8 +16,8 @@
 // (client/lib/engineVersion.js).
 
 /**
- * Адрес проекта из package.json, приведённый к https: repository, иначе
- * homepage.
+ * Адрес проекта из package.json, приведённый к https: homepage, иначе
+ * repository.
  * @param {Object} pkg - разобранный package.json
  * @returns {string|null} https-URL либо null, если поля нет или это не адрес
  */
@@ -32,10 +32,10 @@ export function resolveProjectUrl(pkg) {
   const declared =
     typeof repository === 'string' ? repository : repository?.url;
 
-  // объявленный, но не приводящийся к http(s) repository (пустая строка,
-  // внутренний git-хост) не повод терять валидный homepage: поле проверяется
-  // по результату, а не по факту наличия
-  return normalizeRepository(declared) ?? normalize(homepage);
+  // homepage важнее repository: поле repository обязано называть
+  // репозиторий публикации (его сверяет npm Trusted Publishing), и у пакета
+  // из закрытого репозитория такая ссылка отдаёт игроку 404
+  return normalize(homepage) ?? normalizeRepository(declared);
 }
 
 /**
@@ -94,8 +94,9 @@ function normalize(raw) {
 
   url = url.replace(/^git\+/, '');
 
-  // scp-форма git@host:user/repo — двоеточие здесь разделитель, не порт
-  const scp = /^git@([^:/]+):(.+)$/.exec(url);
+  // scp-форма git@host:user/repo (в том числе с лишним ssh://, как её
+  // нередко пишет npm) — двоеточие здесь разделитель, не порт
+  const scp = /^(?:ssh:\/\/)?git@([^:/]+):(.+)$/.exec(url);
 
   if (scp) {
     url = `https://${scp[1]}/${scp[2]}`;

package/src/standalone/index.js

@@ -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/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;
-}

package/src/config/master.js

@@ -1,288 +0,0 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-// корень репозитория — якорь от расположения файла, не от cwd
-const rootDir = path.resolve(
-  fileURLToPath(import.meta.url),
-  '..',
-  '..',
-  '..',
-  '..',
-  '..',
-);
-
-export default {
-  name: 'VIMP Master Server',
-  protocol: 'https:',
-  domain: 'localhost',
-  // 3000 — игровой сервер, 3001 — Vite HMR (vite.config.js)
-  port: 3002,
-
-  // сертификаты для локальной разработки — в .certs корня репозитория
-  // (в продакшене обычный HTTP за Nginx)
-  httpsOptions: {
-    key: path.join(rootDir, '.certs', 'key.pem'),
-    cert: path.join(rootDir, '.certs', 'cert.pem'),
-  },
-
-  // Статический каталог игр-плагинов. ПУСТ по умолчанию
-  // (master-game-registry, этап 3): штатный источник каталога — реестр игр
-  // auth-сервиса, откуда мастер скачивает одобренные пакеты сам
-  // (master/GameSync.js). Движок игр не знает и зависимостями их не тянет.
-  //
-  // Массив остаётся двум потребителям, и env-переопределения у него нет:
-  // локальной разработке (каталог наполняют собранные пакеты @vimp-games/*
-  // из node_modules, master/localGames.js — прилинкованная игра важнее
-  // реестра) и dedicated-серверу, который берёт отсюда игру, названную
-  // VIMP_DEDICATED_GAME. `package` — имя npm-пакета игры, резолвится через
-  // node_modules; версию задаёт сама установленная зависимость.
-  // maxGameScore (snakes-v3 этап 3.3, необязательное поле рядом с
-  // id/package) — потолок результата ОДНОЙ игры для этой игры; мастер
-  // клампит им `best`/`points` PUT /auth/rank. Для игр реестра его задаёт
-  // админ при модерации, здесь — только запасной путь. Не задан — дефолт
-  // master:playerData:maxGameScore
-  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: {
-    // если всего комнат <= порога — региональный фильтр
-    // и пагинация отключаются, отдаётся весь список
-    regionThreshold: 15,
-    defaultLimit: 10, // размер страницы по умолчанию
-    maxLimit: 50, // максимальный размер страницы
-  },
-
-  // ограничения регистрируемых комнат
-  host: {
-    // санитарная рамка вместимости комнаты для случая, когда игра комнаты
-    // неизвестна мастеру (gameId: null у старых хостов или id не из
-    // каталога). Потолок известной игры задаёт её манифест
-    // (roomDefaults.maxPlayers) — движок его не ограничивает
-    maxPlayersLimit: 8,
-    heartbeatTimeout: 30000, // нет heartbeat дольше — хост потерян
-    sweepInterval: 10000, // период уборки реестра комнат
-  },
-
-  // жизнь комнаты (host-migration, этап 2): комната живёт, пока в ней есть
-  // участник
-  room: {
-    // отсоединённый участник ещё считается в комнате (реконнект сигналинга)
-    memberGraceMs: 15000,
-    // обрыв WS хоста запускает миграцию не сразу, а через столько, если хост
-    // не вернулся reclaim_host'ом и ни один гость не сообщил host_unreachable
-    // (host_leaving мигрирует сразу); reclaim_host после начала миграции, до
-    // регистрации преемника, её отменяет (этап 7.0)
-    hostDisconnectGraceMs: 2000,
-    // повышать некого — комната ждёт reclaim_host столько, потом уборка
-    // мигрирует или закрывает её
-    hostReclaimGraceMs: 10000,
-    // потолок строки карточки комнаты в лобби (gameConfig.lobbyInfo игры)
-    maxInfoLength: 48,
-    // RTT участников (host-migration этап 6): ws.ping() каждой сессии с
-    // этим периодом; EMA RTT и джиттера — единая линейка связности для
-    // хоста и кандидатов
-    rttProbeIntervalMs: 5000,
-    // сессия без pong дольше — terminate(): «тихо умерший» хост находится
-    // быстрее, чем по heartbeatTimeout
-    wsDeadAfterMs: 12000,
-    // преемник (бета): кандидат должен пробыть в комнате не меньше этого
-    minMemberAgeMs: 10000,
-    // плановый пересчёт преемника (помимо join/leave/member_update)
-    successorReviewMs: 15000,
-    // гистерезис смены беты: лучший кандидат держит score не хуже
-    // successorSwitchRatio × score текущего дольше successorSwitchSustainMs
-    successorSwitchSustainMs: 30000,
-    successorSwitchRatio: 0.65,
-    // аварийная миграция (этап 7): бета — преемник с точкой, если она
-    // получила её не раньше checkpointMaxAgeMs назад (по standby_status.ageMs;
-    // статус идёт раз в 5 с — окно больше двух периодов), иначе cold-промоушен любого
-    // способного; преемник не занял комнату за promotionTimeoutMs
-    // (coldPromotionTimeoutMs — он перезагружает страницу) — следующий
-    checkpointMaxAgeMs: 12000,
-    promotionTimeoutMs: 10000,
-    coldPromotionTimeoutMs: 25000,
-    // отчёты host_unreachable: хост не ответил на probe за probeTimeoutMs —
-    // потерян; ответил, но за reportWindowMs отчиталась половина гостей —
-    // принудительная миграция, не чаще forcedMigrationCooldownMs на комнату.
-    // Гости и отчёты считаются по аккаунтам; кворум — не меньше
-    // minUnreachableReporters разных пользователей (в паре с плохим P2P один
-    // гость не снимает хоста — иначе роль «пинг-понгом» ходит по кругу)
-    probeTimeoutMs: 2000,
-    reportWindowMs: 5000,
-    forcedMigrationCooldownMs: 30000,
-    minUnreachableReporters: 2,
-    // плановая передача (этап 8): преемник не занял комнату за
-    // handoffTimeoutMs — передача отменяется, хост размораживает матч
-    handoffTimeoutMs: 8000,
-    // host_migrating.waitMs — дедлайн текущей попытки промоушена (передачи)
-    // плюс migrationNoticeMarginMs: столько гость ждёт host_changed
-    migrationNoticeMarginMs: 5000,
-    // автотриггеры (этап 9c). Сетевой лаг хоста: медиана его RTT до гостей
-    // (host_health) выше lagRttThresholdMs непрерывно lagSustainMs, а score
-    // беты лучше score хоста хотя бы на lagImprovementRatio — хосту
-    // request_handoff. Не раньше autoMigrationCooldownMs с прошлой
-    // авто-смены хоста в комнате (overload/hidden/network — кулдаун общий)
-    // и с получения роли текущим хостом
-    lagRttThresholdMs: 250,
-    lagSustainMs: 10000,
-    lagImprovementRatio: 0.35,
-    autoMigrationCooldownMs: 90000,
-    // бета — не ниже этого FPS рендера (caps.fps гостя; неизвестный FPS не
-    // отсеивает). Аварийный промоушен порог не применяет
-    minSuccessorFps: 30,
-    // голосование «Change host» (этап 10, /changehost; только лобби-режим):
-    // голоса считает мастер. Длительность голосования; повторный старт в
-    // комнате и тем же пользователем — не раньше кулдаунов; прошедшее
-    // голосование просит хоста отдать роль, не начал за voteForceAfterMs —
-    // принудительная миграция; снятый хост не бета и не хост комнаты
-    // demotedCooldownMs (кроме случая, когда больше принять некому).
-    // Один голос на аккаунт; голосует и начинает участник, пробывший в
-    // комнате не меньше minVoterAgeMs (свежие вкладки не накручивают голоса).
-    // После смены хоста голосование ждёт первого room_peers нового хоста —
-    // до него подтверждёнными считаются все, и фантомы попали бы в число
-    // голосующих, — но не дольше peersReportGraceMs (больше
-    // lobby.migration.peersReportIntervalMs: потерянный первый отчёт
-    // повторится внутри окна; хост старше room_peers отчёта не пришлёт)
-    vote: {
-      hostVoteDurationMs: 15000,
-      roomVoteCooldownMs: 120000,
-      userStartCooldownMs: 60000,
-      voteForceAfterMs: 5000,
-      demotedCooldownMs: 600000,
-      minVoterAgeMs: 30000,
-      peersReportGraceMs: 20000,
-    },
-    // GET /rooms/:roomId (прямая ссылка, этап 3) на IP: открытие ссылки —
-    // один запрос, лимит только против перебора roomId
-    lookupRateLimit: {
-      limit: 20,
-      windowMs: 1000,
-    },
-  },
-
-  // GET /auth/leaderboard (code review L2): TTL кэша на мастере (мс) и
-  // верхняя граница ?limit= — публичный анонимный эндпоинт, самый частый
-  // запрос лобби, выборка меняется медленно
-  leaderboard: {
-    cacheTtl: 15000,
-    maxLimit: 100,
-  },
-
-  // GET /auth/placement + агрегирующий GET /auth/placements (snakes-v3
-  // этап 3.3): место меняется медленно, а каждый вход участника стоит трёх
-  // срезов. Кэш здесь про round-trip до auth; стоимость самого запроса
-  // снята на стороне auth (RankDistribution)
-  placement: {
-    cacheTtl: 30000,
-  },
-
-  // пределы записи профилей в БД (snakes-v3 этап 3, решение пользователя 9):
-  // «игр сотни, серверов сотни» — минимальный интервал держит движок на
-  // стороне хоста, а мастер держит потолок для сломанного или злонамеренного
-  // сервера, который этот интервал обошёл
-  playerData: {
-    // PUT /auth/rank + /auth/state на комнату (проверенный roomId) в минуту.
-    // Честная комната на 32 при lobbyConfig.playerData.minFlushInterval в
-    // 5 минут пишет 64 запроса за эти 5 минут, то есть ~13/мин; остальное —
-    // запас на срочные границы (уход участника обходит интервал), и его
-    // хватает даже комнате, полностью сменившей состав дважды за минуту.
-    // Потолок держит не честную комнату, а сломанную или злонамеренную,
-    // поэтому запас считается от честной, а не «пусть будет побольше»
-    writesPerMinute: 120,
-    // потолок результата ОДНОЙ игры, если игра не объявила свой
-    // (master:games[].maxGameScore): обоснование — plan/snakes-v3/stage_2.md
-    maxGameScore: 10000,
-  },
-
-  // заголовки безопасности (гигиена среды, Этап 5.4). CSP на статику/.wasm в
-  // проде ставит Nginx (см. docs/deployment.md) — здесь single source of truth
-  // политики; мастер применяет её к своим ответам только в проде (в dev CSP
-  // сломала бы Vite HMR). WASM требует 'wasm-unsafe-eval', Worker — 'blob:';
-  // connect-src data: — PixiJS фетчит тестовый data:-URL для проверки ImageBitmap.
-  // authServiceUrl — домен central auth-сервиса (packages/auth): лобби
-  // делает туда прямой fetch (браузерные ручки auth-сервиса), поэтому
-  // connect-src должен его разрешать; сам OAuth-редирект (location.href на
-  // auth-сервис/провайдера) CSP не ограничивает — это навигация верхнего
-  // уровня, не fetch/XHR. challenges.cloudflare.com в script-src и frame-src
-  // — скрипт и iframe виджета Turnstile на экране регистрации.
-  // script-src несёт sha256-хэш инлайнового importmap из index.html (для
-  // pixi.js — src="..." на <script type="importmap"> браузеры не
-  // поддерживают, инлайн обязателен). Хэш посчитан по факту собранного
-  // packages/engine/dist/index.html скриптом
-  // scripts/check-importmap-csp-hash.mjs (запускается postbuild) — vite
-  // build минифицирует HTML и может изменить байты скрипта, поэтому хэш
-  // нельзя брать из исходника/консоли браузера; при правке importmap или
-  // апгрейде Vite смотреть на вывод postbuild-проверки.
-  security: {
-    authServiceUrl: 'http://localhost:3010',
-    csp: authServiceUrl =>
-      [
-        "default-src 'self'",
-        "script-src 'self' 'wasm-unsafe-eval' 'sha256-XJmzkFBLHYpcM8KgGRFztTJTwfMb5xIFKAmqlgTpobo=' https://challenges.cloudflare.com",
-        "worker-src 'self' blob:",
-        'frame-src https://challenges.cloudflare.com',
-        `connect-src 'self' wss: data:${authServiceUrl ? ` ${authServiceUrl}` : ''}`,
-        "img-src 'self' data: blob:",
-        "style-src 'self' 'unsafe-inline'",
-        "object-src 'none'",
-        "base-uri 'self'",
-        "frame-ancestors 'none'",
-      ].join('; '),
-    referrerPolicy: 'no-referrer',
-  },
-
-  // журнал клиентских ошибок (plan/client-reports): приём POST
-  // /client-reports на боксе и пересылка пачками в auth-сервис. Пустой
-  // token — пересылка выключена, остаётся строка в журнале процесса
-  clientReports: {
-    token: '',
-    flushIntervalMs: 30000,
-    forwardBatch: 50,
-    forwardTimeoutMs: 5000,
-    maxPending: 500, // потолок разных отпечатков в буфере
-    logSeenMax: 5000, // сколько отпечатков процесс помнит «уже печатал»
-    // бюджет НОВЫХ отпечатков на бокс (решение 9 плана): распределённый спам
-    // обходит лимит по IP, а новая строка в auth — главный ресурс. Повторы
-    // известных отпечатков бюджет не тратят
-    newFingerprintsPerMinute: 60,
-    // ключ — адрес, для IPv6 — подсеть /64 (lib/clientIp.js → rateLimitKey)
-    // клиент шлёт не чаще раза в 10 с — запас на несколько вкладок за одним
-    // адресом (NAT); главная защита — бюджет новых отпечатков
-    rateLimit: { limit: 30, windowMs: 60000 },
-    bodyLimit: '16kb',
-    maxItemsPerRequest: 10,
-  },
-
-  // заголовок с регионом хоста от Nginx/CDN (например, CF-IPCountry);
-  // выбран вместо geoip-lite — бесплатнее по памяти
-  regionHeader: 'x-region',
-
-  // лимит сигнальных ping-запросов с одного IP (защита от DDOS)
-  pingRateLimit: {
-    limit: 10,
-    windowMs: 1000,
-  },
-
-  // ICE-конфигурация для установки P2P-соединений:
-  // STUN обязателен; TURN — опциональный релей по итогам Этапа 0
-  iceServers: [{ urls: 'stun:stun.l.google.com:19302' }],
-};

package/src/lib/clientIp.js

@@ -1,96 +0,0 @@
-// Адрес клиента для rate-limit'ов серверных контуров.
-//
-// `X-Forwarded-For` для этого не годится: Nginx деплоя ставит его через
-// `$proxy_add_x_forwarded_for` (.github/deployment/install-system.sh), то есть
-// ДОПИСЫВАЕТ реальный адрес к тому, что прислал клиент. Первый элемент списка
-// задаёт сам клиент — на нём лимит и обходится (свой заголовок на каждое
-// соединение), и выбирается чужой бакет (заголовок с адресом жертвы закрывает
-// ей вход). Тот же Nginx перезаписывает `X-Real-IP` значением `$remote_addr`,
-// поэтому за прокси доверяем только ему, а без прокси — адресу сокета.
-
-// один раз на процесс: предупреждение о прокси без X-Real-IP на каждое
-// соединение превратилось бы в лог-флуд
-let proxyHeaderWarned = false;
-
-/**
- * @param {Object} req - Запрос (http.IncomingMessage или express Request).
- * @param {Object} [options]
- * @param {boolean} [options.trustProxy] - Стоит ли перед процессом обратный
- *   прокси, перезаписывающий `X-Real-IP` (в этом репозитории — прод-Nginx).
- * @returns {string} Адрес клиента или '' (сокет уже разорван).
- */
-export function clientIp(req, { trustProxy = false } = {}) {
-  const header = trustProxy ? req.headers['x-real-ip'] : undefined;
-
-  // за прокси без X-Real-IP ключом станет адрес самого прокси — один общий
-  // бакет на всех клиентов сразу: правило «одна комната на IP» пустило бы
-  // одну комнату на весь мастер, а лимит пингов стал бы общим. Падать на
-  // первом запросе нельзя (сервер должен подняться), молчать — тоже
-  if (trustProxy && !header && !proxyHeaderWarned) {
-    proxyHeaderWarned = true;
-    console.warn(
-      '[clientIp] trustProxy is on but no X-Real-IP header arrived: every ' +
-        "client now keys on the proxy's own address, one shared rate-limit " +
-        'bucket. Check `proxy_set_header X-Real-IP $remote_addr`.',
-    );
-  }
-
-  return String(header || req.socket?.remoteAddress || '').trim();
-}
-
-// Ключ rate-limit'а по адресу: IPv4 — сам адрес, IPv6 — подсеть /64.
-// Провайдер выдаёт абоненту /64 целиком, то есть у одного человека
-// 2^64 адресов, и лимит «на адрес» для IPv6 не лимит вовсе
-export function rateLimitKey(ip) {
-  const addr = String(ip ?? '').trim();
-
-  if (!addr) {
-    return '';
-  }
-
-  const mapped = /^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/i.exec(addr);
-
-  if (mapped) {
-    return mapped[1];
-  }
-
-  if (!addr.includes(':')) {
-    return addr;
-  }
-
-  const groups = expandIpv6(addr.split('%')[0]);
-
-  if (!groups) {
-    return addr;
-  }
-
-  return `v6:${groups
-    .slice(0, 4)
-    .map(g => parseInt(g, 16).toString(16))
-    .join(':')}::/64`;
-}
-
-// '2001:db8::1' → 8 hex-групп или null, если запись непарсима
-function expandIpv6(addr) {
-  const halves = addr.split('::');
-
-  if (halves.length > 2) {
-    return null;
-  }
-
-  const head = halves[0] ? halves[0].split(':') : [];
-  const tail = halves.length === 2 && halves[1] ? halves[1].split(':') : [];
-  const missing = 8 - head.length - tail.length;
-
-  if (halves.length === 1 ? missing !== 0 : missing < 1) {
-    return null;
-  }
-
-  const groups = [
-    ...head,
-    ...Array(halves.length === 2 ? missing : 0).fill('0'),
-    ...tail,
-  ];
-
-  return groups.every(g => /^[0-9a-f]{1,4}$/i.test(g)) ? groups : null;
-}

package/src/lib/rateLimiter.js

@@ -1,40 +0,0 @@
-// Rate limiter с фиксированным окном: не более `limit` событий
-// на ключ (например, IP) за `windowMs` миллисекунд.
-export default class RateLimiter {
-  constructor({ limit, windowMs }) {
-    this._limit = limit;
-    this._windowMs = windowMs;
-    this._buckets = new Map(); // key -> { count, windowStart }
-  }
-
-  // регистрирует событие; false — лимит для ключа исчерпан
-  consume(key, now = Date.now()) {
-    const bucket = this._buckets.get(key);
-
-    if (!bucket || now - bucket.windowStart >= this._windowMs) {
-      this._buckets.set(key, { count: 1, windowStart: now });
-      return true;
-    }
-
-    if (bucket.count >= this._limit) {
-      return false;
-    }
-
-    bucket.count += 1;
-
-    return true;
-  }
-
-  // удаляет истёкшие окна (периодическая уборка памяти)
-  sweep(now = Date.now()) {
-    for (const [key, bucket] of this._buckets) {
-      if (now - bucket.windowStart >= this._windowMs) {
-        this._buckets.delete(key);
-      }
-    }
-  }
-
-  clear() {
-    this._buckets.clear();
-  }
-}

package/src/lib/security.js

@@ -1,45 +0,0 @@
-import config from './config.js';
-
-// создаёт проверку origin для заданных protocol/domain/port
-// (используется и игровым сервером, и мастер-сервером)
-const createOriginValidator = function ({ protocol, domain, port }) {
-  return function (requestOrigin, cb) {
-    const isProduction = process.env.NODE_ENV === 'production';
-
-    const allowedOrigins = [
-      // origin'ы для локальной разработки
-      `${protocol}//localhost:${port}`,
-      `${protocol}//127.0.0.1:${port}`,
-    ];
-
-    if (isProduction) {
-      // в продакшене разрешен только настоящий домен по стандартному HTTPS
-      // порт не требуется, так как браузер не добавляет его
-      // для стандартного порта 443
-      allowedOrigins.push(`https://${domain}`);
-    }
-
-    let err = null;
-
-    if (!allowedOrigins.includes(requestOrigin)) {
-      err = `Blocked connection from invalid origin: ${requestOrigin}`;
-    }
-
-    process.nextTick(() => cb(err));
-  };
-};
-
-const origin = function (requestOrigin, cb) {
-  const validator = createOriginValidator({
-    protocol: config.get('server:protocol'),
-    domain: config.get('server:domain'),
-    port: config.get('server:port'),
-  });
-
-  validator(requestOrigin, cb);
-};
-
-export default {
-  origin,
-  createOriginValidator,
-};