vimp-engine 0.20.0 → 0.21.0

package/src/lib/validators.js

@@ -168,3 +168,50 @@ export const clampLimit = (value, fallback, max) => {
 
   return Number.isInteger(num) ? Math.min(Math.max(num, 1), max) : fallback;
 };
+
+// Сколько завершённых игр движок может склеить в один запрос: окно склейки
+// на его стороне — минута (lobbyConfig.playerData.minFlushInterval), столько
+// игр в неё не влезает.
+//
+// Множитель СВЯЗАН с rank.maxPoints auth-сервиса (packages/auth/src/config/
+// auth.js): мастер не должен пропускать то, что auth отклонит. Отклонённое
+// тело для хоста неустранимо — PlayerDataSync повторял бы его до конца жизни
+// комнаты, — поэтому при правке per-game maxGameScore проверяется и потолок
+// суммы на той стороне.
+const MERGED_GAMES_PER_WINDOW = 20;
+
+// клампит результат игры (snakes-v3 этап 3.3): `best` — очки ОДНОЙ игры,
+// `points` — сумма склеенных игр с прошлой синхронизации. Потолок одной
+// игры объявляет сама игра (master:games[].maxGameScore), потолок суммы —
+// это же значение на минутное окно синхронизации; всё, что больше, значит
+// либо взломанного клиента, либо неверно настроенную игру, и мастер режет
+// его перед проксированием, а не отклоняет запрос целиком: честная часть
+// результата не должна пропадать из-за одной аномальной строки.
+// Инвариант `best <= points` держится и после клампа — auth его требует
+export const clampGameResult = (points, best, maxGameScore) => {
+  const maxPoints = maxGameScore * MERGED_GAMES_PER_WINDOW;
+  const toInt = value => {
+    const num = Math.trunc(Number(value));
+
+    return Number.isFinite(num) ? Math.max(num, 0) : 0;
+  };
+  const cappedBest = Math.min(toInt(best), maxGameScore);
+  const cappedPoints = Math.min(toInt(points), maxPoints);
+
+  return {
+    points: cappedPoints,
+    // best > points — битый клиент: сумма не может быть меньше своего
+    // максимума. Поднимать сумму до максимума значило бы дорисовать
+    // месячному рейтингу очки, которых не было, поэтому режется best
+    best: Math.min(cappedBest, cappedPoints),
+    // превышение логируется вызывающим: это сигнал о сломанной игре
+    clamped: cappedBest !== toInt(best) || cappedPoints !== toInt(points),
+  };
+};
+
+// Ключ сопоставления ника с глобальным топом. Уникальность users.nick в auth
+// регистронезависимая (миграция 002), поэтому и сравнивать надо так же —
+// иначе «Alice» и «alice» разъедутся. Правило одно, а мест, где по нику
+// ищут, три (host/meta/modules/Accolades.js, client/components/model/Stat.js
+// и сам auth), поэтому оно живёт здесь, а не переписывается в каждом.
+export const nickKey = nick => String(nick ?? '').toLowerCase();