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

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;

package/src/helpers/render/index.js

@@ -1,69 +0,0 @@
-import isFunction from 'lodash/isFunction';
-import wrapInMeasureEvent from '../utils/wrap-in-measure-event';
-
-/**
- * Создаёт функцию для рендеринга приложения, навешивая необходимые события.
- * @param {Object} param Параметры.
- * @param {Function} param.render Пользовательская функция для рендеринга приложения.
- * @param {import('http').ServerResponse} param.response Ответ.
- * @return {Function} Функция, обёрнутая в событие для измерения времени рендеринга.
- */
-export const prepareRenderFunction = ({
-  render,
-  response,
-}) => wrapInMeasureEvent(
-  {
-    fn: render,
-    startEvent: 'render:start',
-    endEvent: 'render:finish',
-    emitter: response,
-  }
-);
-
-/**
- * Возвращает шаблон, который подходит текущей конфигурации.
- * @param {Object} data Данные.
- * @param {Object} data.templates Шаблоны.
- * @param {Object} data.config Конфигурация со средой выполнения.
- * @return {Object} Шаблон совпадающий со средой выполнения.
- */
-export const getTemplate = ({ templates, config } = {}) => {
-  for (const templateName in templates) {
-    const { checker, template } = validateTemplate(templates[templateName]);
-    if (checker(config)) {
-      return template;
-    }
-  }
-};
-
-/**
- * Проверка templates на валидность.
- * @param {Object} templateObject Шаблон.
- * @return {Object} [templateObject] Валидный шаблон.
- */
-export function validateTemplate (templateObject) {
-  const { checker, template } = templateObject || {};
-  if ([checker, template].some(value => !isFunction(value))) {
-    const jsonView = JSON.stringify(templateObject, jsonStringifyReplacer, 2);
-    throw Error(`
-Template object must contain properties "checker" and "template" that must be a functions.
-${jsonView}
-		`.trim());
-  } else {
-    return templateObject;
-  }
-}
-
-/**
- * Преобразует функцию в строку.
- * @param {string} key Ключ объекта.
- * @param {*} value Значение объекта.
- * @return {*} [value] Преобразованное значение объекта.
- */
-export function jsonStringifyReplacer (key, value) {
-  let result = value;
-  if (!JSON.stringify(value)) {
-    result = Object.prototype.toString.call(value);
-  }
-  return result;
-}

package/src/helpers/render/render-app.js

@@ -1,15 +0,0 @@
-/**
- * Выводит данные в шаблон.
- * @param {Object} data Исхоные данные для рендеринга.
- * @param {Function} data.template Функция-шаблон, для вывода данных в разметку.
- * @param {Function} data.getAppData Функция формирующая настройки приложения.
- * @return {string} Разметка, в виде строки, полученная в результате рендеринга шаблона.
- */
-const renderApp = ({
-  template,
-  getAppData,
-}) => template({
-  ...getAppData(),
-});
-
-export default renderApp;

package/src/helpers/saga/__fixtures__/do-safe-request.js

@@ -1,49 +0,0 @@
-export const data = {
-  id: 500,
-  trademark: {},
-  notices_text_all: ['text', 'text'],
-  files: [
-    {
-      filename: 'test_1.pdf',
-      title: 'Тест-1',
-      size: 13,
-      url: 'https://test-1.pgf',
-    },
-    {
-      filename: 'test_2.pdf',
-      title: 'Тест-2',
-      size: 31,
-      url: 'https://test-2.pgf',
-    },
-  ],
-  modifier: {
-    isPicture: false,
-  },
-};
-
-export const error = {
-  message: 'Error message',
-};
-
-export const errorWithConfig = {
-  message: 'Error message',
-  config: {
-    url: 'test-error-url',
-  },
-};
-
-export const errorWithResponse = {
-  message: 'Error message',
-  response: {
-    status: 500,
-    data: {
-      test: 'test',
-    },
-    headers: {
-      test: 'test',
-    },
-    config: {
-      test: 'test',
-    },
-  },
-};