@sima-land/isomorph 10.0.0 → 11.0.0-alpha.1

package/src/config/validate.js

@@ -1,114 +0,0 @@
-import {
-  defaultValidate,
-  callError,
-} from './helpers';
-import isFunction from 'lodash/isFunction';
-import isPlainObject from 'lodash/isPlainObject';
-
-export const RULE_TYPES = Object.freeze({
-  error: 'error',
-  warning: 'warning',
-});
-
-/**
- * Возвращает массив валидаторов.
- * @param {Object|Array|Function} validation Функция-валидатор, либо объект-валидатор,
- * либо массив объектов-валидаторов.
- * @return {Array} Массив валидаторов.
- */
-export const getValidatorsList = validation => {
-  let result = validation;
-
-  if (isFunction(validation)) {
-    result = [{ validate: validation }];
-  } else if (isPlainObject(validation)) {
-    result = [validation];
-  }
-
-  return result;
-};
-
-/**
- * Проверяет значение на корректность.
- * @param {Function} validate Функция-валидатор.
- * @param {*} value Значение.
- * @return {boolean} Валидно ли значение.
- */
-export const checkValue = (validate, value) => isFunction(validate)
-  ? !validate(value)
-  : !defaultValidate(value);
-
-/**
- * Валидирует значение свойства конфигурации.
- * @param {string} property Название свойства.
- * @param {*} value Значение, которое нужно провалидировать.
- * @param {Object} rules Правила валидации,.
- * @param {Object|Array|Function} rules.validation Функция-валидатор, либо объект-валидатор,
- * либо массив объектов-валидаторов.
- */
-export const validateValue = (
-  property,
-  value,
-  {
-    validation = defaultValidate,
-    ...restRules
-  }
-) => {
-  const validatorsList = getValidatorsList(validation);
-  const failedValidator = validatorsList.find(({ validate }) =>
-    checkValue(validate, value));
-
-  failedValidator && callError({
-    property,
-    value,
-    ...restRules,
-    ...failedValidator,
-  });
-};
-
-/**
- * Валидирует определенное свойство конфигурации.
- * @param {Object} config Объект конфигурации.
- * @param {string} property Название свойства.
- * @param {Object} rules Объект с описанием правил валидидации свойство.
- */
-export const validateProperty = (config, property, rules) => {
-  const value = config[property];
-  const rulesList = Array.isArray(rules) ? rules : [rules];
-
-  if (value === undefined) {
-    const { error, type } = rules;
-    callError({ property, value, error, type });
-  } else {
-    rulesList.forEach(rule => {
-      validateValue(property, value, rule);
-    });
-  }
-};
-
-/**
- * Валидирует конфигурацию.
- * @param {Object} config Конфигурация, которую нужно провалидировать.
- * @param {Object} validationConfig Конфигурация валидатора.
- * @return {Object} Конфигурация приложения.
- */
-const validateConfig = (
-  config,
-  validationConfig
-) => {
-  if (!isPlainObject(config)) {
-    throw new TypeError('Конфигурация приложения должна быть чистым объектом');
-  }
-
-  if (!isPlainObject(validationConfig)) {
-    throw new TypeError('Конфигурация валидатора должна быть чистым объектом');
-  }
-
-  Object.entries(validationConfig).forEach(([property, rules]) => {
-    validateProperty(config, property, rules);
-  });
-
-  return config;
-};
-
-export default validateConfig;

package/src/container/create-inject.js

@@ -1,32 +0,0 @@
-import isFunction from 'lodash/isFunction';
-import getDependencies from './get-dependencies';
-import isContainer from './is-container';
-
-/**
- * Создаёт функцию для инъекции зависимостей из контейнера в функции.
- * @param {Function} getContainer Функция для получения экземпляра контейнера.
- * @return {Function} Функция для инъекции зависимостей из контейнера.
- */
-const createInject = getContainer => ({
-  target,
-  dependencies = [],
-  registerArgs,
-}) => async (...args) => {
-  const container = getContainer();
-
-  // Если не получили контейнера, то выходим с ошибкой.
-  if (!isContainer(container)) {
-    throw new TypeError('Полученный результат выполнения функции getContainer не реализует интерфейс контейнера.');
-  }
-
-  // Если требуется регистрируем аргументы функции как сервисы в контейнере.
-  if (isFunction(registerArgs)) {
-    registerArgs(container, ...args);
-  }
-  return target(
-    ...args,
-    ...Object.values(await getDependencies(container, dependencies))
-  );
-};
-
-export default createInject;

package/src/container/get-dependencies.js

@@ -1,46 +0,0 @@
-import isString from 'lodash/isString';
-import isPlainObject from 'lodash/isPlainObject';
-
-/**
- * Определяет, является ли зависимость статической, то есть не требующей инициализации.
- * @param {Object} dependency Конфигурация зависимости.
- * @param {string} dependency.name Название зависимости.
- * @param {*} dependency.value Значение зависимости.
- * @return {boolean} Является ли зависимость статической.
- */
-export const isStaticDependency = ({ name, value }) =>
-  typeof name === 'string'
-  && typeof value !== 'undefined';
-
-/**
- * Создает объект зависимостей на основе их названий.
- * @param {Object} container Экземпляр контейнера в котором должен осуществляться поиск зависимостей.
- * @param {Object} dependencies Список зависимостей.
- * @param {string} serviceName Названия сервиса.
- * @return {Object} Объект зависимостей.
- */
-const getDependencies = (
-  container,
-  dependencies = [],
-  serviceName
-) => dependencies.reduce(async (prevPromise, dependency) => {
-  const result = await prevPromise;
-  if (isString(dependency)) {
-    result[dependency] = await container.get(dependency, serviceName);
-  }
-
-  if (isPlainObject(dependency)) {
-    if (isStaticDependency(dependency)) {
-      result[dependency.name] = dependency.value;
-    } else {
-      const [necessaryName, necessaryDepName] = Object.entries(dependency).shift() || [];
-      if (necessaryName && necessaryDepName) {
-        result[necessaryName] = await container.get(necessaryDepName);
-      }
-    }
-  }
-
-  return result;
-}, Promise.resolve({}));
-
-export default getDependencies;

package/src/container/index.js

@@ -1,188 +0,0 @@
-import isString from 'lodash/isString';
-import isFunction from 'lodash/isFunction';
-import ServiceNotFoundError from './service-not-found-error';
-import getDependencies from './get-dependencies';
-import isContainer from './is-container';
-import isNotEmptyString from '../helpers/utils/is-not-empty-string';
-
-/**
- * Оборачивает функцию для использования в контейнере.
- * @param {Function} fn Функция, которую необходимо обернуть.
- * @param {Function} dependenciesToArgs Функция для преобразования зависимостей сервиса в аргументы функции.
- * @return {Function} Функция-сервис, для использования в контейнере.
- */
-export const createService = (
-  fn,
-  dependenciesToArgs
-) => (dependencies, ...args) => fn(...dependenciesToArgs(dependencies), ...args);
-
-/**
- * Создаёт функцию для получения синглтона контейнера с заданными параметрами.
- * @param {Object} options Опции для создания контейнера.
- * @return {function(): Object} Функция для получения контейнера-синглтона.
- */
-export const createSingleton = options => {
-  let container;
-  return () => {
-    if (!container) {
-      container = create(options);
-    }
-    return container;
-  };
-};
-
-/**
- * Создаёт функцию-фабрику для создания нового экземпляра контейнера при её вызове.
- * @param {Object} options Опции для создания контейнера.
- * @return {function(): Object} Функция-фабрика для получения экземпляра контейнера с заданными параметрами.
- */
-export const createFactory = options => () => create(options);
-
-/**
- * Реализует наследование контейнера от другого контейнера.
- * @param {Object} container Дочерний контейнер.
- * @param {Object} parentContainer Родительский контейнер.
- * @return {Object} Контейнер с поиском зависимости в родителе.
- */
-const inherit = (
-  container,
-  parentContainer
-) => {
-  let result = container;
-  if (isContainer(parentContainer)) {
-    result = {
-      ...container,
-
-      /**
-       * Оборачивает получение зависимости для добавления поиска в родительском контейнере.
-       * @param {string} name Название зависимости.
-       * @return {*} Зависимость.
-       * @throws {TypeError} Выдаст ошибку если параметр "name" не строка.
-       * @throws {Error} Выдаст ошибку если параметр "name" не строка или пустая строка.
-       * @throws {ServiceNotFoundError} Выдаст ошибку при попытке вызвать незарегистрированный сервис.
-       */
-      async get (name) {
-        let dependency;
-        try {
-          dependency = await container.get(name);
-        } catch (e) {
-          if (e instanceof ServiceNotFoundError) {
-            dependency = await parentContainer.get(name);
-          } else {
-            throw e;
-          }
-        }
-        return dependency;
-      },
-    };
-  }
-  return result;
-};
-
-/**
- * Функция создает IoC-контейнер.
- * @param {Object} options Дополнительные опции для IoC-контейнера.
- * @param {Array} options.services Массив сервисов, которые нужно зарегистрировать.
- * @param {Object} options.parent Родительский контейнер.
- * @return {Object} IoC Container.
- * @throws {TypeError} Выдаст ошибку если параметр "services" не массив.
- */
-export default function create ({ services = [], parent = null } = {}) {
-  if (!Array.isArray(services)) {
-    throw new TypeError('Параметр "services" должен быть массивом');
-  }
-
-  const registry = {};
-
-  const container = inherit({
-    /**
-     * Добавляет зависимость в список зависимостей.
-     * @param {Object} options Опции необходимые для добавления зависимости.
-     * @param {string} options.name Название зависимости.
-     * @param {Function} options.singleton Функция-синглтон.
-     * @param {Function} options.factory Функция-конструктор.
-     * @param {*} options.value Переданная зависимость.
-     * @param {Array} options.dependencies Массив зависимостей.
-     * @throws {Error} Выдаст ошибку если параметр "name" не строка или пустая строка.
-     * @throws {Error} Выдаст ошибку если не передан ни один из параметров "factory", "singleton" или "value".
-     */
-    set ({ name, singleton, factory, value, dependencies = [] } = {}) {
-      if (!isString(name) || name === '') {
-        throw new Error('Параметр "name" должен быть непустой строкой');
-      }
-
-      if (factory !== undefined && !isFunction(factory)) {
-        throw new TypeError('Параметр "factory" должен быть функцией');
-      }
-
-      if (singleton !== undefined && !isFunction(singleton)) {
-        throw new TypeError('Параметр "singleton" должен быть функцией');
-      }
-
-      if (factory === undefined && value === undefined && singleton === undefined) {
-        throw Error(`Сервис ${name} не зарегистрирован,
-так как обязательно должен быть передан один из параметров "factory", "singleton" или "value"`);
-      }
-
-      registry[name] = {
-        name,
-        singleton,
-        factory,
-        dependencies,
-        value,
-      };
-    },
-
-    /**
-     * Получает зависимость по ее названию.
-     * @param {string} name Название зависимости.
-     * @param {string} serviceName Название сервиса.
-     * @return {*} Зависимость.
-     * @throws {TypeError} Выдаст ошибку если параметр "name" не строка.
-     * @throws {Error} Выдаст ошибку если параметр "name" не строка или пустая строка.
-     * @throws {ServiceNotFoundError} Выдаст ошибку при попытке вызвать незарегистрированный сервис.
-     */
-    async get (name, serviceName = '') {
-      if (!isString(name) || name === '') {
-        throw new Error('Параметр "name" должен быть непустой строкой');
-      }
-
-      const service = registry[name];
-      let dependency;
-
-      if (!service) {
-        throw new ServiceNotFoundError(
-          isNotEmptyString(serviceName)
-            ? `Не найдена зависимость "${name}" в цепочке вызовов "${serviceName}"`
-            : `Сервис "${name}" не зарегистрирован`
-        );
-      }
-
-      if (service.singleton && !service.value) {
-        service.value = await service.singleton(
-          {
-            ...await getDependencies(container, service.dependencies, `${serviceName}/${name}`),
-          }
-        );
-      }
-
-      if (service.value !== undefined) {
-        dependency = service.value;
-      }
-
-      if (service.factory) {
-        dependency = await service.factory(
-          {
-            ...await getDependencies(container, service.dependencies, `${serviceName}/${name}`),
-          }
-        );
-      }
-
-      return dependency;
-    },
-  }, parent);
-
-  services.forEach(service => container.set(service));
-
-  return container;
-}

package/src/container/is-container.js

@@ -1,14 +0,0 @@
-import isPlainObject from 'lodash/isPlainObject';
-import isFunction from 'lodash/isFunction';
-
-/**
- * Проверяет является ли переданный экземпляр контейнером.
- * @param {*} instance Предполагаемый экземпляр контейнера.
- * @return {boolean} Является ли переданный экземпляр контейнером.
- */
-const isContainer = instance =>
-  isPlainObject(instance)
-  && isFunction(instance.get)
-  && isFunction(instance.set);
-
-export default isContainer;

package/src/container/service-not-found-error.js

@@ -1,14 +0,0 @@
-/**
- * Ошибка поиска сервиса в контейнере.
- */
-export default class ServiceNotFoundError extends Error {
-  /**
-   * Конструктор.
-   * @param {...*} args Аргументы.
-   */
-  constructor (...args) {
-    super(...args);
-    this.name = this.constructor.name;
-    Error.captureStackTrace && Error.captureStackTrace(this, this.constructor);
-  }
-}

package/src/create-proxy/create-proxy-middleware/index.js

@@ -1,47 +0,0 @@
-import get from 'lodash/get';
-import pipe from 'lodash/fp/pipe';
-import isFunction from 'lodash/isFunction';
-import expressProxy from 'express-http-proxy';
-
-const urlApi = require('url');
-
-/**
- * Получает обработчик с прокинутым path из config url.
- * @param {string} path Часть пути после хоста.
- * @return {Function} Обработчик для передачи URL запроса из оригинальной версии с клиента в проксирующий запрос.
- */
-export const getRequestPathResolver = path => request => request && path + request.originalUrl;
-
-/**
- * Функция создающая обработчик запроса.
- * @param {string} header Отслеживаемый заголовок.
- * @param {Array} map Массив обработчика.
- * @param {Object} config Конфигурация приложения.
- * @param {Object} proxyOptions Пользовательская конфигурация прокси.
- * @return {Function} Функция, обрабатывающая запрос.
- */
-export default function createProxyMiddleware (header, map, config, proxyOptions = {}) {
-  return (req, res, next) => {
-    const headerType = get(req, `headers['${header.toLowerCase()}']`, null);
-    const getUrl = headerType ? map[headerType] : null;
-    const proxyInstance = isFunction(getUrl) ? expressProxy(getUrl(config), {
-      proxyReqPathResolver: getRequestPathResolver(getUrlPath(getUrl(config))), ...proxyOptions,
-    }) : null;
-
-    if (proxyInstance) {
-      proxyInstance(req, res, next);
-    } else {
-      next();
-    }
-  };
-}
-
-/**
- * Получает path из url без слэша в конце.
- * @param {string} url Url.
- * @return {string} Path или пустую строку.
- */
-export const getUrlPath = pipe(
-  urlApi.parse,
-  url => url.path && url.path.replace(/\/$/, '')
-);

package/src/create-proxy/index.js

@@ -1,27 +0,0 @@
-import createProxyMiddleware from './create-proxy-middleware';
-
-/**
- * Конструктор сервиса проксирования.
- * @param {Object} param Параметры.
- * @param {Object} param.config Конфигурация приложения.
- * @param {Object} param.config.proxy Конфигурация прокси.
- * @return {Function} Функция-конструктор.
- */
-export default function createProxy (
-  {
-    config,
-    config: {
-      proxy,
-    },
-  }
-) {
-  return app => {
-    if (!Array.isArray(proxy)) {
-      throw TypeError('Параметр proxy должен быть массивом');
-    }
-
-    proxy.forEach(({ url, header, map, proxyOptions }) => {
-      app.use(url, createProxyMiddleware(header, map, config, proxyOptions));
-    });
-  };
-}

package/src/create-response-sender/index.js

@@ -1,48 +0,0 @@
-import propOr from 'lodash/fp/propOr';
-
-const getDataLayer = propOr({}, ['app', 'dataLayer']);
-
-/**
- * Возвращает функцию ответа на запрос, подходящую для текущего окружения.
- * @param {Object} dependencies Зависимости.
- * @param {boolean} dependencies.config.isProduction Флаг production среды.
- * @param {Object} dependencies.response Объект ответа.
- * @return {Function} Функция ответа на запрос.
- */
-export default function createResponseSender ({ config: { isProduction }, response }) {
-  /**
-   * Функция ответа на запрос в формате HTML.
-   * @param {Object} options Опции.
-   * @param {string} options.markup Разметка.
-   */
-  const htmlSender = ({ markup }) => { response.send(markup); };
-
-  /**
-   * Функция ответа на запрос в формате JSON.
-   * @param {Object} options Опции.
-   * @param {string} options.markup Разметка.
-   * @param {{css: string, js: string, criticalJs: string[]}} options.assets Ссылки на ресурсы приложения.
-   * @param {Object} options.store Стор приложения.
-   */
-  const jsonSender = ({
-    markup,
-    assets: {
-      css,
-      js,
-      criticalJs,
-    },
-    store,
-  }) => {
-    const payload = {
-      markup,
-      bundle_css: css || '',
-      bundle_js: js || '',
-      critical_js: criticalJs || [],
-      meta: getDataLayer(store.getState()),
-    };
-
-    response.json(payload);
-  };
-
-  return isProduction ? jsonSender : htmlSender;
-}

package/src/get-dynamic-data/index.js

@@ -1,26 +0,0 @@
-import { getMethod, getStatus, getXClientIp, getOriginalUrl } from '../helpers/http/request-getters';
-
-/**
- * Получает данные API для логирования.
- * @param {Object} params Входные параметры.
- * @param {Object} params.response Ответ.
- * @param {string} params.timeDataKey Поле в response.local, из которого следует запрашивать log data.
- * @return {number} Статус ответа.
- */
-export const getApiLogData = ({ response, timeDataKey }) => response.locals[timeDataKey] || {};
-
-/**
- * Возвращает динамически получаемые данные.
- * @param {Object} dependencies Зависимости.
- * @param {Object} dependencies.config Конфигурация.
- * @param {string} dependencies.timeDataKey Поле в response.local, из которого следует запрашивать log data.
- * @return {Object} Объект с данными.
- */
-export const getDynamicData = ({ config, timeDataKey = 'logData' }) => (request, response) => ({
-  remote_ip: getXClientIp({ request }),
-  method: getMethod({ request }),
-  status: getStatus({ response }),
-  route: getOriginalUrl({ request }),
-  ...getApiLogData({ response, timeDataKey }),
-  version: config.version,
-});

package/src/graceful-shutdown/index.js

@@ -1,97 +0,0 @@
-import isFunction from 'lodash/isFunction';
-import isNumeric from '../helpers/utils/is-numeric';
-
-/**
- * Время ожидания до принудительного завершения процесса приложения по умолчанию.
- * @type {number}
- */
-export const defaultExitTimeout = 20000;
-
-/**
- * Декорирует http-сервер, добавляя остановку при завершении процесса node-приложения.
- * @param {import('http').Server} server Экземпляр класса http.Server.
- * @param {Object} [options] Экземпляр класса http.Server.
- * @param {Function} [options.onSuccess] Будет вызвана перед завершением процесса в случае успешного завершения.
- * @param {Function} [options.onError] Будет вызвана перед принудительным завершением процесса.
- * @param {number} [options.timeout=20000] Время ожидания остановки, после которого выполнится принудительная остановка.
- */
-export const decorateGracefulShutdown = (server, options) => {
-  const handleShutdown = createShutdownHandler(server, options);
-
-  // e.g. kill
-  process.on('SIGTERM', handleShutdown);
-
-  // e.g. Ctrl + C
-  process.on('SIGINT', handleShutdown);
-};
-
-/**
- * Возвращает функцию, которая запускает остановку http-сервера и завершает процесс приложения принудительно.
- * @param {import('http').Server} server Экземпляр класса http.Server.
- * @param {Object} [options] Экземпляр класса http.Server.
- * @param {Function} [options.onSuccess] Будет вызвана перед завершением процесса.
- * @param {Function} [options.onError] Будет вызвана перед завершением процесса.
- * @param {number} [options.timeout=20000] Время ожидания остановки, после которого выполнится принудительная остановка.
- * @return {Function} Функция, запускающая остановку http-сервера и завершающая процесс приложения принудительно.
- */
-export const createShutdownHandler = (
-  server,
-  {
-    onError,
-    onSuccess,
-    timeout = defaultExitTimeout,
-  } = {}
-) => {
-  const validTimeout = isNumeric(timeout)
-    ? Number(timeout)
-    : defaultExitTimeout;
-
-  return () => {
-    server.close(createCloseHandler(0, onSuccess));
-    setTimeout(createCloseHandler(1, onError), validTimeout); // принудительное завершение
-  };
-};
-
-/**
- * Возвращает функцию, которая завершает процесс node-приложения с определенным кодом.
- * @param {number} [exitCode=0] Код завершения процесса.
- * @param {Function} [onClose] Функция, которая будет вызвана перед завершением процесса.
- * @return {Function} Функция завершения процесса.
- */
-export const createCloseHandler = (exitCode = 0, onClose) => () => {
-  isFunction(onClose) && onClose(exitCode);
-  process.exit(exitCode);
-};
-
-/**
- * Создаёт обработчики событий завершения приложения.
- * @param {Object} options Опции.
- * @param {Object} options.logger Логгер.
- * @param {Object} [options.config] Конфигурация приложения.
- * @param {string} options.message Сообщение, которое будет залоггировано в консоль.
- * @return {Function} Обработчик завершения приложения.
- */
-export const onExitHandlerCreator = ({ logger, config, message }) => () => {
-  const { isDevelopment = true } = config || {};
-  isDevelopment && logger.info(message);
-};
-
-/**
- * Сервис для реализации лёгкого завершения приложения.
- * @param {Object} options Опции.
- * @param {Function} options.onExitError Обработчик завершения с ошибкой.
- * @param {Function} options.onExitSuccess Обработчик успешного завершения.
- * @param {number} options.processExitTimeout Максимальное время, отведённое приложению на завершение.
- * @return {Function} Функция, реализующая лёгкое завершение приложения.
- */
-export const gracefulShutdownCreator = (
-  {
-    onExitError: onError,
-    onExitSuccess: onSuccess,
-    processExitTimeout: timeout,
-  }
-) => server => decorateGracefulShutdown(server, {
-  onError,
-  onSuccess,
-  timeout,
-});