vimp-engine 0.38.0 → 0.38.2

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,
-};