@sima-land/isomorph 9.0.7 → 11.0.0-alpha.0

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

package/src/helpers/add-error-handling/index.js

@@ -1,24 +0,0 @@
-import isFunction from 'lodash/isFunction';
-
-/**
- * Возвращает функцию с обработкой ошибки обработчика роута Express.
- * @param {Function} handler Обработчик роута Express.
- * @param {Function} [errorHandler] Обработчик ошибки роута Express.
- * @return {Function} Обработчик роута обернутого для отлова ошибок.
- */
-export const addErrorHandling = (handler, errorHandler) => {
-  if (!isFunction(handler)) {
-    throw new Error('Аргумент "handler" должен быть функцией.');
-  }
-  return async (request, response, next, ...args) => {
-    try {
-      await handler(request, response, next, ...args);
-    } catch (err) {
-      if (isFunction(errorHandler)) {
-        await errorHandler(err, request, response, next, ...args);
-      } else {
-        await next(err);
-      }
-    }
-  };
-};

package/src/helpers/api/create-enhancer.js

@@ -1,52 +0,0 @@
-import { createService } from '../../container';
-
-/**
- * Конструктор для создания функции для применения middleware к экземпляру axios.
- * @param {Array} middlewares Middleware, которые должны быть применены.
- * @return {function(Object): Object} Функция для применения middleware к экземпляру axios.
- */
-export const applyMiddleware = (...middlewares) =>
-  instance =>
-    middlewares.reduce(
-      (currentInstance, middleware) => currentInstance.use(middleware),
-      instance
-    );
-
-/**
- * Функция для сборки middleware в функцию для применения к экземпляру axios.
- * @param {Array<Function>} constructors Функции-конструкторы middleware.
- * @param {Object} params Параметры для конструкторов.
- * @return {function(Object): Object} Функция для применения созданных middleware к экземпляру axios.
- */
-export const createEnhancer = (constructors, params) =>
-  applyMiddleware(
-    ...Array.isArray(constructors) ? constructors.map(constructor => constructor(params)) : []
-  );
-
-/**
- * Преобразует опции сервиса в аргументы функции.
- * @param {Object} param Параметры.
- * @param {Array<Function>} param.constructors Функции-конструкторы middleware.
- * @param {Object} param.params Параметры для конструкторов.
- * @return {Array} Массив агрументов для использования в функции.
- */
-export const mapServiceOptionsToArgs = (
-  {
-    constructors,
-    ...params
-  }
-) => [
-  constructors,
-  params,
-];
-
-/**
- * Функция для сборки middleware в функцию для применения к экземпляру axios для использования в контейнере.
- * @type {Function}
- */
-const enhancerConstructor = createService(
-  createEnhancer,
-  mapServiceOptionsToArgs
-);
-
-export default enhancerConstructor;

package/src/helpers/api/create-instance.js

@@ -1,42 +0,0 @@
-import { create } from 'middleware-axios';
-import isFunction from 'lodash/isFunction';
-import { createService } from '../../container';
-
-/**
- * Функция для создания экземпляра axios с возможностью передать обработчик для применения middleware.
- * @param {Object} config Конфигурация для axios.
- * @param {Function} enhancer Функция для применения middleware к экземпляру.
- * @return {Object} Экземпляр axios с применёнными middleware.
- */
-export const createInstance = (config, enhancer) => {
-  const instance = create(config);
-  return isFunction(enhancer) ? enhancer(instance) : instance;
-};
-
-/**
- * Преобразует опции сервиса в аргументы функции.
- * @param {Object} param Параметры.
- * @param {Object} param.config Конфигурация для axios.
- * @param {Function} param.enhancer Функция для применения middleware к экземпляру.
- * @return {Array} Массив агрументов для использования в функции.
- */
-export const mapServiceOptionsToArgs = (
-  {
-    config,
-    enhancer,
-  }
-) => [
-  config,
-  enhancer,
-];
-
-/**
- * Конструктор экземпляра axios для использования в контейнере.
- * @type {Function}
- */
-const instanceConstructor = createService(
-  createInstance,
-  mapServiceOptionsToArgs
-);
-
-export default instanceConstructor;

package/src/helpers/api/middlewares/collect-cookie-middleware.js

@@ -1,27 +0,0 @@
-import uniq from 'lodash/uniq';
-import get from 'lodash/get';
-
-/**
- * Создаёт middleware для сбора cookie со всех запросов в API и их передачи в ответ сервера.
- * @param {Object} options Параметры для создания middleware.
- * @param {Object} options.response Ответ на запрос в сервис.
- * @return {function(Object, Function): Promise} Middleware для сбора cookie со всех запросов в API.
- */
-const createCollectCookieMiddleware = ({ response }) =>
-
-  /**
-   * Middleware для сбора cookie со всех запросов в API.
-   * @param {Object} requestConfig Конфигурация запроса API.
-   * @param {Function} next Функция для передачи контекста выполнения следующему middleware.
-   * @return {Promise} Промис.
-   */
-  async (requestConfig, next) => {
-    const apiResponse = await next(requestConfig);
-    const initialCookie = response.get('set-cookie') || [];
-    const additionalCookie = get(apiResponse, 'headers.set-cookie', []);
-    if (additionalCookie.length) {
-      response.set('set-cookie', uniq([...initialCookie, ...additionalCookie]));
-    }
-  };
-
-export default createCollectCookieMiddleware;

package/src/helpers/api/middlewares/count-api-response-time.js

@@ -1,31 +0,0 @@
-import { getMsFromHRT } from '../../utils/get-ms-from-hrt';
-
-/**
- * Создаёт middleware, собирающий данные о времени ответа запросов в API.
- * @param {Object} param Параметры.
- * @param {Object} param.response Ответ.
- * @param {string} param.timeDataKey Ключ свойства в response.locals для сохранения замеров времени.
- * @return {function(Object, Function)} Middleware для сохранения времени ответа API.
- */
-const createCountApiResponseTimeMiddleware = ({ response, timeDataKey }) =>
-
-  /**
-   * Middleware для сбора данных о времени ответа запросов в API.
-   * @param {Object} requestConfig Конфигурация запроса API.
-   * @param {Function} next Функция для передачи контекста выполнения следующему middleware.
-   * @return {Promise} Промис.
-   */
-  async (requestConfig, next) => {
-    const startTime = process.hrtime();
-    const apiResponse = await next(requestConfig);
-    const url = apiResponse.config.url.replace(/\/\d+/gi, '/ID');
-    const method = apiResponse.config.method.toUpperCase();
-
-    if (!response.locals[timeDataKey]) {
-      response.locals[timeDataKey] = {};
-    }
-    response.locals[timeDataKey][`${method} ${url}`] = getMsFromHRT(process.hrtime(startTime));
-    return response;
-  };
-
-export default createCountApiResponseTimeMiddleware;