@sima-land/isomorph 10.1.0 → 11.0.0-alpha.2

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;

package/src/helpers/redux/prepare-on-ready.js

@@ -1,16 +0,0 @@
-/**
- * Оборачивает опциональный обработчик события готовности стора, добавляя отписку и опциональную очистку таймера.
- * @param {Object} store Стор.
- * @param {Function} unsubscribe Функция отписки от стора.
- * @param {Function|*} onReady Опциональный обработчик события готовности стора.
- * @return {Function} Обёрнутый обработчик готовности стора.
- */
-const prepareOnReady = (store, unsubscribe, onReady) => timerId => {
-  unsubscribe();
-
-  timerId && clearTimeout(timerId);
-
-  onReady && onReady(store);
-};
-
-export default prepareOnReady;

package/src/helpers/redux/remote-data.js

@@ -1,124 +0,0 @@
-import {
-  createReducer as pureCreateReducer,
-} from 'reduxsauce';
-import { STATUSES } from './constants';
-import pipe from 'lodash/fp/pipe';
-
-/**
- * Приняв статус, вернет функцию,
- * которая примет состояние и добавит в него статус в поле "status".
- * @param {string} status Значение статуса.
- * @return {function (Object): Object} Примет состояние и добавит в него статус в поле "status".
- */
-const defaultStatusAdderMaker = status => state => ({
-  ...state,
-  status,
-});
-
-/**
- * Возвращает новую функцию, которая вернет обернутый обработчик.
- * Обернутый обработчик добавит статус в состояние с помощью переданной функции withStatus.
- * @param {Function} withStatus Функция, добавляющая в состояние статус.
- * @return {function (Function): Function} Функция, оборачивающая обработчик.
- */
-const createHandleWithStatusMaker = withStatus => {
-  /**
-   * Приняв обработчик, вернет функцию,
-   * которая будет применять withStatus к результату обработчика.
-   * @param {Function} handler Обработчик.
-   * @return {*} Новое состояние.
-   */
-  const handlerMaker = handler => {
-    const handleWithStatus = pipe(
-      handler,
-      withStatus
-    );
-
-    return handleWithStatus;
-  };
-
-  return handlerMaker;
-};
-
-/**
- * Модифицированная версия createReducer из пакета "reduxsauce".
- * @param {*} initialState Начальное состояние.
- * @param {function (Wrappers, Handlers): Object} createHandlers Должна вернуть набор обработчиков.
- * @param {Object} [options] Опции.
- * @param {Object} [options.createStatusAdder] Функция, которая добавит статус в состояние.
- * @return {Function} Функция-reducer.
- */
-export const createReducer = (
-  initialState,
-  createHandlers,
-  {
-    createStatusAdder = defaultStatusAdderMaker,
-  } = {}
-) => {
-  /**
-   * @typedef {Object} Wrappers Набор оберток для обработчиков.
-   * @property {Function} asInitial Обернет переданный обработчик, добавляя в состояние статус "initial".
-   * @property {Function} asRequest Обернет переданный обработчик, добавляя в состояние статус "fetching".
-   * @property {Function} asSuccess Обернет переданный обработчик, добавляя в состояние статус "success".
-   * @property {Function} asFailure Обернет переданный обработчик, добавляя в состояние статус "failure".
-   */
-  const wrappers = {
-    asInitial: createHandleWithStatusMaker(
-      createStatusAdder(STATUSES.initial)
-    ),
-    asRequest: createHandleWithStatusMaker(
-      createStatusAdder(STATUSES.fetching)
-    ),
-    asSuccess: createHandleWithStatusMaker(
-      createStatusAdder(STATUSES.success)
-    ),
-    asFailure: createHandleWithStatusMaker(
-      createStatusAdder(STATUSES.failure)
-    ),
-  };
-
-  /**
-   * @typedef {Object} Handlers Набор обработчиков.
-   * @property {Function} initial Обработает состояние, добавив статус "initial" с помощью createStatusAdder.
-   * @property {Function} request Обработает состояние, добавив статус "fetching" с помощью createStatusAdder.
-   * @property {Function} success Обработает состояние, добавив статус "success" с помощью createStatusAdder.
-   * @property {Function} failure Обработает состояние, добавив статус "failure" с помощью createStatusAdder.
-   */
-  const handlers = {
-    initial: createStatusAdder(STATUSES.initial),
-    request: createStatusAdder(STATUSES.fetching),
-    success: createStatusAdder(STATUSES.success),
-    failure: createStatusAdder(STATUSES.failure),
-  };
-
-  return pureCreateReducer(
-    initialState,
-    createHandlers(wrappers, handlers)
-  );
-};
-
-/**
- * Возвращает функцию, создающую начальное состояние со статусом.
- * @param {*} baseInitialState Начальное состояние.
- * @param {Object} [options] Опции.
- * @param {Function} [options.createStatusAdder] Получив статус, вернет функцию, которая применит его к состоянию.
- * @return {Function} Функция, создающую начальное состояние со статусом.
- */
-export const createStateMaker = (
-  baseInitialState = {},
-  {
-    createStatusAdder = defaultStatusAdderMaker,
-  } = {}
-) => {
-  const addStatus = createStatusAdder(STATUSES.initial);
-
-  /**
-   * Генерирует состояние с начальным статусом.
-   * @return {*} Состояние с начальным статусом.
-   */
-  const createStateWithStatus = () => addStatus(
-    baseInitialState
-  );
-
-  return createStateWithStatus;
-};

package/src/helpers/redux/selector/statuses.js

@@ -1,30 +0,0 @@
-import { createSelector } from 'reselect';
-import propEq from 'lodash/fp/propEq';
-import identity from 'lodash/identity';
-import { STATUSES } from '../constants';
-
-const statusEq = propEq('status');
-const isInitial = statusEq(STATUSES.initial);
-const isFetching = statusEq(STATUSES.fetching);
-const isSuccessful = statusEq(STATUSES.success);
-const isFailed = statusEq(STATUSES.failure);
-
-/**
- * Вернет новый набор селекторов статуса.
- * @param {Function} [selectSection=identity] Вернет раздел состояния, у которого есть статус.
- * @return {{ isInitial: Function, isFetching: Function, isSuccessful: Function, isFailed: Function }} Селекторы.
- */
-const create = (selectSection = identity) => ({
-  isInitial: createSelector(selectSection, isInitial),
-  isFetching: createSelector(selectSection, isFetching),
-  isSuccessful: createSelector(selectSection, isSuccessful),
-  isFailed: createSelector(selectSection, isFailed),
-});
-
-export const StatusSelectors = {
-  create,
-  isInitial,
-  isFetching,
-  isSuccessful,
-  isFailed,
-};

package/src/helpers/redux/wait-on-store-readiness.js

@@ -1,40 +0,0 @@
-import prepareOnReady from './prepare-on-ready';
-import isFunction from 'lodash/isFunction';
-
-/**
- * Наблюдатель за готовностью стора.
- * @param {Object} store Стор.
- * @param {Function} isReady Функция определения готовности стора.
- * @param {Function} onReady Функция обработчик события готовности стора.
- * @param {Function} onTimeout Функция обработчик события таймаута ожидания готовности стора.
- * @param {number} timeout Максимальное время, отведённое на ожидание готовности стора.
- * @return {Object} Стор.
- */
-const waitOnStoreReadiness = (
-  store,
-  isReady,
-  onReady,
-  onTimeout,
-  timeout = 2 ** 30
-) => {
-  let timer = null;
-  const wrapperOnReady = prepareOnReady(
-    store,
-    store.subscribe(
-      () => {
-        isReady(store) && wrapperOnReady(timer);
-      }
-    ),
-    onReady
-  );
-  timer = setTimeout(
-    () => {
-      wrapperOnReady();
-      isFunction(onTimeout) && onTimeout(store);
-    },
-    timeout
-  );
-  return store;
-};
-
-export default waitOnStoreReadiness;

package/src/helpers/render/get-react-markup-data.js

@@ -1,18 +0,0 @@
-import React from 'react';
-import { renderToString } from 'react-dom/server';
-import { Provider } from 'react-redux';
-
-/**
- * Возвращает функцию формирующую данные React-приложения.
- * @param {Object} param Параметры.
- * @param {ReactElement} param.app Главный компонент приложения.
- * @param {Object} param.store Объект глобального состояния приложения.
- * @param {string} param.key Ключ.
- * @return {Function} Функция формирующая данные React-приложения.
- */
-const getReactMarkupData = ({ app: App, store, key = 'markup' }) => data => ({
-  ...data,
-  [key]: renderToString(<Provider store={store}><App /></Provider>),
-});
-
-export default getReactMarkupData;