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

package/src/helpers/api/server-adapter/index.js

@@ -1,155 +0,0 @@
-import {
-  isStream,
-  isEventEmitter,
-  prepareDataBuffer,
-  createOptions,
-  createTransport,
-  uncompressResponse,
-  enhanceError,
-  createError,
-  settle,
-} from './helpers';
-
-import { REQUEST_STAGES } from './constants';
-
-/**
- * Адаптер для Axios, создающий события на основных этапах запроса к API.
- * За образец использован дефолтный адаптер 'axios/lib/adapters/http.js',
- * но без поддержки proxy, socketPath и cancelToken за ненадобностью.
- * Только для NodeJS, на клиенте не использовать.
- * @param {Object} config Конфигурация инстанса Axios.
- * @return {Promise} Разрешится после запроса к API.
- */
-const serverAdapter = config => new Promise((resolve, reject) => {
-  const {
-    headers,
-    data: pureData,
-    timeout,
-    responseType,
-    maxContentLength,
-    responseEncoding,
-    emitter,
-  } = config;
-
-  const needEmit = isEventEmitter(emitter);
-
-  // Регистрируем обработчик начала запроса.
-  needEmit && emitter.emit(REQUEST_STAGES.start);
-
-  // Подготовка данных запроса.
-  let data;
-
-  if (pureData && !isStream(pureData)) {
-    data = prepareDataBuffer(pureData);
-    if (data) {
-      headers['Content-Length'] = data.length;
-    } else {
-      reject(createError(
-        'Data after transformation must be a string, an ArrayBuffer, a Buffer, or a Stream',
-        config
-      ));
-    }
-  } else {
-    data = pureData;
-  }
-
-  const options = createOptions({ ...config, headers });
-  const transport = createTransport(config);
-
-  // Создаем запрос и коллбэк, обрабатывающий ответ.
-  const req = transport.request(options, res => {
-    // Регистрируем обработчик получения ответа.
-    res.once('readable', () => needEmit && emitter.emit(REQUEST_STAGES.firstByteReceived));
-
-    const stream = uncompressResponse(res);
-
-    if (stream !== res) {
-      delete res.headers['content-encoding'];
-    }
-
-    const response = {
-      status: res.statusCode,
-      statusText: res.statusMessage,
-      headers: res.headers,
-      config,
-      request: res.req,
-    };
-
-    const resBuffer = [];
-
-    /**
-     * Обработчик получения порции данных.
-     * @param {Buffer} chunk Порция данных.
-     */
-    const chunksHandler = chunk => {
-      resBuffer.push(chunk);
-      if (
-        maxContentLength > -1
-          && Buffer.concat(resBuffer).length > maxContentLength
-      ) {
-        stream.destroy();
-        reject(createError(`maxContentLength size of ${maxContentLength} exceeded`, config, null, res.req));
-      }
-    };
-
-    /**
-     * Обработчик завершения получения данных.
-     */
-    const finishHandler = () => {
-      const concatBuffer = Buffer.concat(resBuffer);
-      response.data = responseType === 'arraybuffer'
-        ? concatBuffer
-        : concatBuffer.toString(responseEncoding);
-
-      settle(resolve, reject, response);
-
-      // Регистрируем обработчик завершения запроса.
-      needEmit && emitter.emit(REQUEST_STAGES.end);
-    };
-    if (responseType === 'stream') {
-      response.data = stream;
-      settle(resolve, reject, response);
-    } else {
-      stream
-        .on('data', chunksHandler)
-        .on('error', err => {
-          !req.aborted && reject(enhanceError(err, config, null, res.req));
-        })
-        .on('end', finishHandler);
-    }
-  });
-
-  // Регистрируем обработчики событий сокета.
-  if (needEmit) {
-    req.on('socket', socket => {
-      socket.connecting && socket
-        .on('lookup', () => emitter.emit(REQUEST_STAGES.dnsLookupFinish))
-        .on('connect', () => emitter.emit(REQUEST_STAGES.tcpConnectionConnect))
-        .on('secureConnect', () => emitter.emit(REQUEST_STAGES.tlsHandshakeFinish));
-    });
-  }
-
-  req.on('error', err => {
-    !req.aborted && reject(enhanceError(err, config, null, req));
-  });
-
-  if (timeout) {
-    req.setTimeout(timeout, () => {
-      req.abort();
-      reject(createError(`timeout of ${config.timeout} ms exceeded`, config, 'ECONNABORTED', req));
-    });
-  }
-
-  // Отправка данных запроса.
-  if (isStream(data)) {
-    data
-      .on('error', err => {
-        reject(enhanceError(err, config, null, req));
-      })
-      .pipe(req);
-  } else {
-    req.end(data);
-  }
-});
-
-export default serverAdapter;

package/src/helpers/development/use-dot-env.js

@@ -1,9 +0,0 @@
-/**
- * Определяет, необходимо ли подключать dotenv и если необходимо, подключает его.
- * @param {string} environment Значение переменной среды NODE_ENV.
- */
-const useDotEnv = environment => {
-  ['development', 'test'].includes(environment) && require('dotenv').config();
-};
-
-export default useDotEnv;

package/src/helpers/get-params/index.js

@@ -1,59 +0,0 @@
-import get from 'lodash/get';
-import isFunction from 'lodash/isFunction';
-import { createService } from '../../container';
-
-/**
- * Генерирует параметры приложения.
- * @param {Object} request Запрос.
- * @param {Object} config Конфиг приложения.
- * @param {Function} getValue Генератор значения.
- * @param {Function} modify Модификатор Значения.
- * @param {Object} defaultValue Значение поумолчанию.
- * @return {Object} Параметры приложения.
- */
-export const getParams = (request, config, getValue = () => {}, modify, defaultValue) => {
-  let result = getValue(request);
-  if (!result) {
-    result = defaultValue;
-  }
-  if (isFunction(modify)) {
-    result = modify(result, request, config);
-  }
-  return result;
-};
-
-/**
- * Парсит заголовок запроса.
- * @param {Object} request Запрос.
- * @return {Object} Параметры.
- */
-export const parseHttpHeaders = request => {
-  /**
-   * Node.js переводит в ASCII.
-   * @see {https://github.com/nodejs/node/issues/17390}
-   */
-  const params = Buffer.from(
-    get(request, 'headers[simaland-params]', ''),
-    'binary'
-  ).toString('utf8');
-  return params ? JSON.parse(params) : null;
-};
-
-export default createService(
-  getParams,
-  (
-    {
-      request,
-      config,
-      getValue,
-      modify,
-      defaultValue,
-    }
-  ) => [
-    request,
-    config,
-    getValue,
-    modify,
-    defaultValue,
-  ]
-);

package/src/helpers/http/request-getters.js

@@ -1,42 +0,0 @@
-import { isIP } from 'net';
-import isFunction from 'lodash/isFunction';
-
-/**
- * Получает IP пользователя из заголовков запроса.
- * @param {Object} request Запрос.
- * @return {string} IP пользователя.
- */
-export const getXClientIp = ({ request }) => {
-  const ip = request.headers['x-client-ip']
-    || request.headers['x-forwarded-for']
-    || request.connection.remoteAddress;
-  return isIP(ip) ? ip : '';
-};
-
-/**
- * Получает метод запроса из объекта запроса.
- * @param {Object} request Запрос.
- * @return {string} Метод запроса.
- */
-export const getMethod = ({ request }) => request.method;
-
-/**
- * Получает статус ответа из объекта ответа.
- * @param {Object} response Ответ.
- * @return {number} Статус ответа.
- */
-export const getStatus = ({ response }) => response.statusCode;
-
-/**
- * Получает оригинальный url из объекта запроса.
- * @param {Object} request Запрос.
- * @return {number} Url запроса.
- */
-export const getOriginalUrl = ({ request }) => request.originalUrl;
-
-/**
- * Получает куки из запроса.
- * @param {Object} request Запрос.
- * @return {string} Куки.
- */
-export const getCookie = request => (request && isFunction(request.get) && request.get('cookie')) || '';

package/src/helpers/http/statuses-validator.js

@@ -1,20 +0,0 @@
-/**
- * Валидация http статуса ответа на POST запрос.
- * @param {number} status Статус http ответа.
- * @return {boolean} Валидность.
- */
-export const validatePostStatus = status => status === 201;
-
-/**
- * Валидация http статуса ответа на DELETE запрос.
- * @param {number} status Статус http ответа.
- * @return {boolean} Валидность.
- */
-export const validateDeleteStatus = status => status === 204 || status === 200;
-
-/**
- * Валидация http статуса 200.
- * @param {number} status Статус http ответа.
- * @return {boolean} Валидность.
- */
-export const isOkStatus = status => status === 200;

package/src/helpers/logger/create-pino-instance/index.js

@@ -1,41 +0,0 @@
-import pino from 'pino';
-import formatTime from '../format-time';
-import isPlainObject from 'lodash/isPlainObject';
-
-/**
- * Модуль создающий экземпляр логгера.
- * @param {Object} options Зависимости модуля.
- * @return {Function} Функция, которая создает логгер.
- */
-export default function createPinoInstance ({ config } = {}) {
-  /**
-   * Функция, которая создает экземпляр логгера.
-   * @param {Object} param Параметры.
-   * @param {string|number} param.timestamp Время.
-   * @param {boolean} param.isProduction Является ли production-сборкой.
-   * @param {boolean} param.hasColorize Нужно ли выделять цветом.
-   * @return {Function} Экземпляр логгера.
-   */
-  const loggerCreator = (
-    {
-      timestamp,
-      isProduction,
-      hasColorize,
-    }
-  ) => {
-    const logger = pino({
-      timestamp,
-      prettyPrint: hasColorize && { colorize: true },
-      useLevelLabels: true,
-    });
-    logger.extreme = isProduction;
-
-    return logger;
-  };
-
-  return loggerCreator({
-    timestamp: formatTime,
-    isProduction: isPlainObject(config) ? config.isProduction : true,
-    hasColorize: isPlainObject(config) ? config.isDevelopment : false,
-  });
-}

package/src/helpers/logger/format-time/index.js

@@ -1,6 +0,0 @@
-/**
- * Форматирует дату.
- * @return {string} Строка с датой в формате ISO.
- */
-const formatTime = () => `,"time":"${new Date().toISOString()}"`;
-export default formatTime;

package/src/helpers/metrics/index.js

@@ -1,40 +0,0 @@
-/**
- * Формирует данные метрики из данных приложения, запроса и ответа.
- * @param {Object} options Опции приложения.
- * @param {Object} options.dependencies Зависимости сервиса сбора метрик.
- * @param {Object} options.dependencies.config Конфигурация приложения.
- * @param {import('http').IncomingMessage} options.request Запрос.
- * @param {import('http').ServerResponse} options.response Ответ.
- * @return {{route: string, place: string, statusCode: number}} Данные для отправки в метрику.
- */
-export const labelsResolver = ({ dependencies: { config }, request, response }) => ({
-  version: config.version || 'development',
-  route: request.baseUrl + request.path,
-  code: response.statusCode,
-  method: request.method,
-});
-
-/**
- * Создаёт функцию, подписывающую обработчик на определённое событие ответа сервера.
- * @param {string} eventName Название события.
- * @return {function({response: import('http').ServerResponse, callback: Function}): import('http').ServerResponse}
- * Функция-подписчик.
- */
-export const createResponseEventSubscriber = eventName =>
-  ({ response, callback }) => response.once(eventName, callback);
-
-/**
- * Подписывает функцию-обработчик на событие начала рендеринга.
- * @param {import('http').ServerResponse} response Ответ.
- * @param {Function} callback Обработчик.
- * @return {import('http').ServerResponse} Ответ.
- */
-export const renderStartSubscriber = createResponseEventSubscriber('render:start');
-
-/**
- * Подписывает функцию-обработчик на событие конца рендеринга.
- * @param {import('http').ServerResponse} response Ответ.
- * @param {Function} callback Обработчик.
- * @return {import('http').ServerResponse} Ответ.
- */
-export const renderFinishSubscriber = createResponseEventSubscriber('render:finish');

package/src/helpers/prometheus/index.js

@@ -1,9 +0,0 @@
-import PrometheusClient from 'prom-client';
-import { PrometheusMetric } from './metric-adapter.js';
-import { createMeasureMiddleware } from './measure-middleware.js';
-
-export {
-  PrometheusClient,
-  PrometheusMetric,
-  createMeasureMiddleware,
-};

package/src/helpers/prometheus/measure-middleware.js

@@ -1,73 +0,0 @@
-import negate from 'lodash/negate';
-import isFunction from 'lodash/isFunction';
-import { isPrometheusMetric } from './metric-adapter.js';
-import { labelsResolver } from '../metrics';
-import { createObserveMiddleware, defaultStartSubscriber, defaultFinishSubscriber } from '../../observe-middleware';
-
-/**
- * Возвращает функцию, создающую модуль для замера метрик запросов Express-приложения.
- * @param {Object} dependencies Опции.
- * @param {Function} dependencies.resolveLabels Функция, результат которой будет использован как аргумент setLabels.
- * @param {Array} dependencies.startMetrics Список метрик, замеряемых при старте запроса.
- * @param {Array} dependencies.finishMetrics Список метрик, замеряемых при отправке ответа.
- * @return {Function} Функция, возвращающая промежуточный слой для использования в Express-приложении.
- */
-export const createMeasureMiddleware = (dependencies = {}) => {
-  const {
-    resolveLabels = labelsResolver,
-    startMetrics = [],
-    finishMetrics = [],
-    startSubscriber = defaultStartSubscriber,
-    finishSubscriber = defaultFinishSubscriber,
-  } = dependencies || {};
-  if (!isFunction(resolveLabels)) {
-    throw TypeError('First argument property "resolveLabels" must be a function');
-  }
-
-  if ([startMetrics, finishMetrics].some(negate(Array.isArray))) {
-    throw TypeError('First argument properties "startMetrics" and "finishMetrics" must be arrays');
-  }
-
-  if ([...startMetrics, ...finishMetrics].some(negate(isPrometheusMetric))) {
-    throw TypeError('Every metric in "startMetrics" and "finishMetrics" must be instance of PrometheusMetric');
-  }
-
-  if (!isFunction(startSubscriber)) {
-    throw TypeError('First argument property "startSubscriber" must be a function');
-  }
-
-  if (!isFunction(finishSubscriber)) {
-    throw TypeError('First argument property "finishSubscriber" must be a function');
-  }
-
-  return createObserveMiddleware({
-    onStart: (timestamp, request, response) => {
-      startMetrics.forEach(metric => {
-        metric
-          .setLabels(resolveLabels({
-            dependencies,
-            metric,
-            request,
-            response,
-            timestamp,
-          }))
-          .spot();
-      });
-    },
-    onFinish: (duration, request, response) => {
-      finishMetrics.forEach(metric => {
-        metric
-          .setLabels(resolveLabels({
-            dependencies,
-            duration,
-            metric,
-            request,
-            response,
-          }))
-          .spot(duration);
-      });
-    },
-    startSubscriber,
-    finishSubscriber,
-  });
-};

package/src/helpers/prometheus/metric-adapter.js

@@ -1,99 +0,0 @@
-import PrometheusClient from 'prom-client';
-import difference from 'lodash/difference';
-
-/**
- * Список имен конструкторов из пакета "prom-client", пригодных для создания адаптеров.
- * @type {Array<string>}
- */
-export const availableMetricTypes = Object.freeze([
-  'Counter',
-  'Gauge',
-  'Histogram',
-  'Summary',
-]);
-
-/**
- * Ключ свойства адаптера с оригинальным объектом метрики.
- * @type {symbol}
- */
-export const originalMetricKey = Symbol('original-metric-key');
-
-/**
- * Возвращает оригинальный объект метрики из переданного адаптера.
- * @param {PrometheusMetric} adapter Объект адаптера.
- * @return {Object} Объект метрики.
- */
-export const getOriginalInstance = adapter => adapter
-  ? adapter[originalMetricKey]
-  : undefined;
-
-/**
- * Определяет, является ли переданное значение экземпляром класса PrometheusMetric.
- * @param {*} value Проверяемое значение.
- * @return {boolean} Переданное значение является экземпляром класса PrometheusMetric?
- */
-export const isPrometheusMetric = value => value instanceof PrometheusMetric;
-
-/**
- * Класс объектов-адаптеров для классов метрик из пакета "prom-client".
- */
-export class PrometheusMetric {
-  labels = {};
-
-  /**
-   * Инициализирует объект-адаптер метрики.
-   * @param {string} metricType Тип метрики, определяемый названием класса из пакета "prom-client".
-   * @param {Object} options Опции, передаваемые в конструктор метрики из пакета "prom-client".
-   */
-  constructor (metricType = '', options = {}) {
-    if (!availableMetricTypes.includes(metricType)) {
-      throw Error(`First argument must be one of available types: ${availableMetricTypes.join(', ')}`);
-    }
-    Object.assign(this, { ...options, metricType });
-    this[originalMetricKey] = new PrometheusClient[metricType](options);
-  }
-
-  /**
-   * Устанавливает значения показателей по переданному объекту, где ключ - название показателя.
-   * @param {Object} labels Объект со значениями показателей по названиям.
-   * @return {PrometheusMetric} Экземпляр.
-   */
-  setLabels (labels = {}) {
-    const newLabels = labels || {};
-    if (Array.isArray(this.labelNames)) {
-      if (difference(this.labelNames, Object.keys(newLabels)).length > 0) {
-        throw Error(`Labels count must be equal to labelNames count = ${this.labelNames.length}`);
-      }
-    }
-    this.labels = newLabels;
-
-    return this;
-  }
-
-  /**
-   * Фиксирует показатель метрики в сервисе Prometheus.
-   * @param {*} value Значение фиксируемого показателя, игнорируется для типа "Counter".
-   * @return {PrometheusMetric} Экземпляр.
-   */
-  spot (value) {
-    const instance = getOriginalInstance(this);
-
-    switch (this.metricType) {
-      case 'Counter':
-        instance.inc(this.labels, 1);
-        break;
-      case 'Summary':
-      case 'Histogram':
-        instance.observe(this.labels, value);
-        break;
-      case 'Gauge': {
-        const isPositive = value > 0;
-        const methodName = isPositive ? 'inc' : 'dec';
-        instance[methodName](Math.abs(value));
-        break;
-      }
-    }
-
-    return this;
-  }
-}

package/src/helpers/react/error-handlers/index.tsx

@@ -1,68 +0,0 @@
-import React from 'react';
-
-export interface Props {
-  children: NonNullable<React.ReactNode> | null
-  fallback: NonNullable<React.ReactNode> | null
-  captureException?: (error: Error, errorInfo: React.ErrorInfo) => void
-}
-
-/**
- * Обработчик ошибок в React компонентах.
- */
-export class ErrorBoundary extends React.Component<Props, { hasError: boolean }> {
-  /**
-   * @param props Свойства компонента.
-   * @param props.children Дочерний компонент.
-   * @param props.fallback Запасной элемент, если возникла ошибка.
-   * @param props.captureException Функция для логирования ошибки.
-   */
-  constructor (props: Props) {
-    super(props);
-
-    this.state = { hasError: false };
-  }
-
-  /** @inheritdoc */
-  static getDerivedStateFromError () {
-    return { hasError: true };
-  }
-
-  /** @inheritdoc */
-  componentDidCatch (error: Error, errorInfo: React.ErrorInfo) {
-    const { captureException } = this.props;
-
-    captureException?.(error, errorInfo);
-  }
-
-  /**
-   * Рендер.
-   * @return Дочерний элемент либо запасное значение.
-   */
-  render () {
-    const { children, fallback } = this.props;
-
-    return this.state.hasError ? fallback : children;
-  }
-}
-
-/**
- * Обертка над Suspense c перехватом ошибок.
- * @param props Свойства компонента.
- * @param props.children Дочерний компонент.
- * @param props.fallback Запасной элемент, если возникла ошибка.
- * @param props.captureException Функция для логирования ошибки.
- * @return Элемент.
- */
-export const SafeSuspense = ({
-  children,
-  fallback,
-  captureException,
-}: Props) => (
-  <React.Suspense fallback={fallback}>
-    <ErrorBoundary
-      children={children}
-      fallback={fallback}
-      captureException={captureException}
-    />
-  </React.Suspense>
-);

package/src/helpers/redux/constants.js

@@ -1,10 +0,0 @@
-/**
- * Статусы состояния данных.
- * @type {Object}
- */
-export const STATUSES = Object.freeze({
-  initial: 'initial',
-  success: 'success',
-  fetching: 'fetching',
-  failure: 'failure',
-});

package/src/helpers/redux/create-compose-middleware.js

@@ -1,24 +0,0 @@
-import { compose } from 'redux';
-import isFunction from 'lodash/isFunction';
-
-/**
- * Создаёт функцию для композиции нескольких промежуточных обработчиков для применения в сторе
- * и подключения redux devtools в среде разработки.
- * @param {Object} options Опции.
- * @param {Function} options.devToolsComposeCreator Функция для создания compose с redux dev tools.
- * @param {Function} options.getName Функция возвращающая название сервиса.
- * @param {Function} options.getDevToolsEnabled Функция опредяляющая нужно ли подключать dev tools.
- * @return {Function} Функция для объединения нескольких промежуточных обработчиков в сторе.
- */
-const createComposeMiddleware = ({
-  devToolsComposeCreator,
-  getName,
-  getDevToolsEnabled,
-} = {}) =>
-  isFunction(devToolsComposeCreator) && isFunction(getName) && isFunction(getDevToolsEnabled) && getDevToolsEnabled()
-    ? devToolsComposeCreator({
-      name: getName(),
-    })
-    : compose;
-
-export default createComposeMiddleware;

package/src/helpers/redux/get-dev-compose-creator.js

@@ -1,9 +0,0 @@
-import get from 'lodash/get';
-
-/**
- * Получает из глобального объекта функцию для создания функции compose c devtools.
- * @return {Function | null} Функция для создания функции compose либо null, если функция не найдена.
- */
-const getDevComposeCreator = () => get(window, '__REDUX_DEVTOOLS_EXTENSION_COMPOSE__', null);
-
-export default getDevComposeCreator;