vimp-engine 0.38.1 → 0.38.3

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/devtools/surface/abiParse.js

@@ -1,175 +0,0 @@
-// Разбор `core/src/abi.rs` — единственный раздел слепка плагинной
-// поверхности, который нельзя собрать импортом: методы wasm-ABI живут внутри
-// `macro_rules!`, раскрывающихся уже в крейте игры. Слепок читает файл как
-// текст и вытаскивает имена и нормализованные сигнатуры `pub fn`.
-//
-// Разбор обязан ПАДАТЬ, а не возвращать пустоту: молчаливо пустой раздел
-// слепка пропустит любое нарушение И1/И3 (plan/plugin-forward-compat).
-
-// имя макроса → раздел слепка (`abi.game` / `abi.client`)
-const MACRO_SECTIONS = {
-  // имена макросов Rust — строками: camelCase к ним неприменим
-  'export_game_core_abi': 'game',
-  'export_client_core_abi': 'client',
-};
-
-/**
- * @param {string} source - Содержимое `core/src/abi.rs`.
- * @returns {{game: Object[], client: Object[]}} Методы ABI по разделам,
- *   каждый — { name, args, ret }, отсортированные по имени.
- */
-export function parseAbi(source) {
-  const blocks = splitMacros(source);
-
-  if (blocks.length === 0) {
-    throw new Error(
-      'abiParse: no macro_rules! block found in core/src/abi.rs — the file ' +
-        'was restructured; fix the parser instead of letting the surface ' +
-        'snapshot go silently empty',
-    );
-  }
-
-  const sections = {};
-
-  for (const block of blocks) {
-    const section = MACRO_SECTIONS[block.macro];
-
-    if (!section) {
-      continue; // макрос вне ABI плагина — не часть поверхности
-    }
-
-    const methods = parseMethods(block.body);
-
-    if (methods.length === 0) {
-      throw new Error(
-        `abiParse: macro_rules! ${block.macro} yielded no "pub fn" — the ` +
-          'file was restructured; fix the parser',
-      );
-    }
-
-    sections[section] = methods.sort((a, b) => a.name.localeCompare(b.name));
-  }
-
-  for (const [macro, section] of Object.entries(MACRO_SECTIONS)) {
-    if (!sections[section]) {
-      throw new Error(
-        `abiParse: macro_rules! ${macro} not found in core/src/abi.rs`,
-      );
-    }
-  }
-
-  return sections;
-}
-
-// тело каждого `macro_rules! <name> { … }` — от имени до парной скобке
-function splitMacros(source) {
-  const re = /macro_rules!\s+([a-z_0-9]+)\s*\{/g;
-  const blocks = [];
-  let match;
-
-  while ((match = re.exec(source)) !== null) {
-    const open = re.lastIndex - 1;
-    const close = matchBrace(source, open, '{', '}');
-
-    blocks.push({
-      macro: match[1],
-      body: source.slice(open + 1, close),
-    });
-  }
-
-  return blocks;
-}
-
-// `pub fn name(args) -> ret` внутри тела макроса; тело метода пропускается
-function parseMethods(body) {
-  const re = /pub\s+fn\s+([a-z_0-9]+)\s*\(/g;
-  const methods = [];
-  let match;
-
-  while ((match = re.exec(body)) !== null) {
-    const open = re.lastIndex - 1;
-    const close = matchBrace(body, open, '(', ')');
-    const tail = body.slice(close + 1);
-    const arrow = /^\s*->([^{;]+)/.exec(tail);
-
-    methods.push({
-      name: match[1],
-      args: splitArgs(body.slice(open + 1, close)).map(normalizeType),
-      ret: arrow ? normalizeType(arrow[1]) : '()',
-    });
-  }
-
-  return methods;
-}
-
-// индекс скобки, парной открывающей на позиции `open`
-function matchBrace(source, open, openChar, closeChar) {
-  let depth = 0;
-
-  for (let i = open; i < source.length; i += 1) {
-    if (source[i] === openChar) {
-      depth += 1;
-    } else if (source[i] === closeChar) {
-      depth -= 1;
-
-      if (depth === 0) {
-        return i;
-      }
-    }
-  }
-
-  throw new Error(`abiParse: unbalanced ${openChar} at offset ${open}`);
-}
-
-// список аргументов по запятым верхнего уровня; получатель (`&self`,
-// `&mut self`) в сигнатуру не входит — он не часть бинарного контракта
-function splitArgs(list) {
-  const args = [];
-  let depth = 0;
-  let current = '';
-
-  for (const ch of list) {
-    if (ch === '<' || ch === '(' || ch === '[') {
-      depth += 1;
-    } else if (ch === '>' || ch === ')' || ch === ']') {
-      depth -= 1;
-    }
-
-    if (ch === ',' && depth === 0) {
-      args.push(current);
-      current = '';
-      continue;
-    }
-
-    current += ch;
-  }
-
-  args.push(current);
-
-  return args
-    .map(arg => arg.trim())
-    .filter(arg => arg.length > 0 && !/^&?\s*(mut\s+)?self$/.test(arg))
-    .map(arg => {
-      const colon = arg.indexOf(':');
-
-      // аргумент без имени в этих макросах не встречается: имя есть всегда
-      return colon === -1 ? arg : arg.slice(colon + 1);
-    });
-}
-
-// Стабильная строка типа: меняется тогда и только тогда, когда меняется
-// бинарный контракт. Ссылка/`mut`/пробелы/путь до wasm-bindgen на него не
-// влияют; `Result<T, JsError>` сворачивается в `Result<T>` — вариант ошибки
-// у всех методов один.
-function normalizeType(type) {
-  const flat = type
-    .replaceAll('::wasm_bindgen::', '')
-    .replaceAll('wasm_bindgen::', '')
-    .replace(/\bmut\b/g, '')
-    .replaceAll('&', '')
-    .replace(/\s+/g, '');
-
-  return flat.replace(/^Result<(.*),JsError>$/, 'Result<$1>');
-}
-
-export default parseAbi;