vimp-engine 0.1.0

package/src/lib/math.js

@@ -0,0 +1,75 @@
+/**
+ * Линейная интерполяция
+ * @param {number} a
+ * @param {number} b
+ * @param {number} t - значение от 0 до 1
+ */
+export const lerp = (a, b, t) => a + (b - a) * t;
+
+/**
+ * Интерполяция угла в радианах по кратчайшему пути
+ * @param {number} a
+ * @param {number} b
+ * @param {number} t - значение от 0 до 1
+ */
+export const lerpAngle = (a, b, t) => {
+  let diff = b - a;
+
+  while (diff > Math.PI) {
+    diff -= Math.PI * 2;
+  }
+
+  while (diff < -Math.PI) {
+    diff += Math.PI * 2;
+  }
+
+  return a + diff * t;
+};
+
+/**
+ * Ограничивает число в диапазоне [min, max]
+ * @param {number} value
+ * @param {number} min
+ * @param {number} max
+ * @returns {number}
+ */
+export const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+
+/**
+ * Перевод градусов в радианы
+ * @param {number} degrees
+ * @returns {number}
+ */
+export const degToRad = degrees => degrees * (Math.PI / 180);
+
+/**
+ * Перевод радиан в градусы
+ * @param {number} radians
+ * @returns {number}
+ */
+export const radToDeg = radians => radians * (180 / Math.PI);
+
+/**
+ * Нормализует угол в радианах к диапазону [-PI, PI]
+ * @param {number} angle
+ * @returns {number}
+ */
+export const normalizeAngle = angle => {
+  while (angle > Math.PI) {
+    angle -= Math.PI * 2;
+  }
+
+  while (angle < -Math.PI) {
+    angle += Math.PI * 2;
+  }
+
+  return angle;
+};
+
+/**
+ * Случайное число в диапазоне [min, max)
+ * @param {number} min
+ * @param {number} max
+ * @returns {number}
+ */
+export const randomRange = (min, max) => Math.random() * (max - min) + min;

package/src/lib/rateLimiter.js

@@ -0,0 +1,40 @@
+// 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/sanitizers.js

@@ -0,0 +1,17 @@
+// Управляющие символы (переводы строк, табы и т.п.) ломают однострочный чат.
+// eslint-disable-next-line no-control-regex
+const controlCharsRegExp = /[\x00-\x1f\x7f]/g;
+
+/**
+ * Убирает из сообщения управляющие символы. Не XSS-защита — экранирование
+ * на выводе (`textContent`/`setAttribute`).
+ * @param {string} message
+ * @returns {string} - Очищенная строка (пустая, если на входе не строка).
+ */
+export const sanitizeMessage = message => {
+  if (typeof message !== 'string') {
+    return '';
+  }
+
+  return message.replace(controlCharsRegExp, '');
+};

package/src/lib/security.js

@@ -0,0 +1,45 @@
+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,
+};

package/src/lib/validators.js

@@ -0,0 +1,52 @@
+const NAME_REGEXP = new RegExp('^[a-zA-Z]([\\w\\s#]{0,13})[\\w]{1}$');
+
+/**
+ * Проверяет, является ли строка валидным именем пользователя.
+ * @param {string} name - Имя для проверки.
+ * @returns {boolean} - true, если имя валидно, иначе false.
+ */
+export const isValidName = name =>
+  typeof name === 'string' && NAME_REGEXP.test(name);
+
+// движковые правила валидации; игровые (например isValidModel)
+// инжектируются третьим аргументом validateAuth (authSchema игры)
+const validationRules = {
+  isValidName,
+};
+
+/**
+ * Валидирует объект с данными для авторизации.
+ * @param {object} data - Объект с данными для проверки.
+ * @param {Array} authParams - Массив правил для валидации
+ * @param {Object} [validators] - Игровые валидаторы (имя → функция),
+ *   дополняют движковые validationRules.
+ * @returns {Array|undefined} - Массив ошибок или undefined.
+ */
+export const validateAuth = (data, authParams, validators = {}) => {
+  const rules = { ...validationRules, ...validators };
+  const errors = [];
+
+  for (const { name, options } of authParams) {
+    if (!(name in data)) {
+      return [{ name, error: `Property is missing` }];
+    }
+
+    const value = data[name];
+
+    if (typeof value !== 'string') {
+      return [{ name, error: `Property must be a string` }];
+    }
+
+    if (options?.validator) {
+      const validatorFn = rules[options.validator];
+
+      if (validatorFn && !validatorFn(value)) {
+        errors.push({ name, error: 'not valid' });
+      } else if (!validatorFn) {
+        console.warn(`Validator function '${options.validator}' not found.`);
+      }
+    }
+  }
+
+  return errors.length ? errors : undefined;
+};