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

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

package/src/helpers/saga/cache-result.js

@@ -1,77 +0,0 @@
-import { call } from 'redux-saga/effects';
-import isFunction from 'lodash/isFunction';
-import isPlainObject from 'lodash/isPlainObject';
-import doSafeRequest from './do-safe-request';
-
-/**
- * Проверяет наличие данных, запрошенных из кэша.
- * @param {*} data Данные, запрошенных из кэша.
- * @return {boolean} Получен ли ответ.
- */
-export const validateCacheDefault = data => Boolean(data);
-
-/**
- * Проверяет валидность ответа API.
- * @param {Object} response Ответ API.
- * @return {boolean} Результат проверки.
- */
-export const validateResultDefault = response =>
-  Boolean(response) && isPlainObject(response) && Boolean(response.ok);
-
-/**
- * @typedef {Object} Cache Объект кэша.
- * @property {Function} get Функция, получающая данные из кэша.
- * @property {Function} set Функция, записывающая данные в кэш.
- * @property {boolean} status Статус доступности кэша.
- */
-
-/**
- * Запрашивает данные с сервера с кэшированием.
- * @param {Object} options Настройки кэширования.
- * @param {Cache} options.cache Объект кэша.
- * @param {string} options.key Ключ для сохранения.
- * @param {Function} options.captureException Обработчик ошибки.
- * @param {Function} options.validateCache Функция для проверки валидности данных кэша.
- * @param {Function} options.validateResult Функция для проверки валидности результата при сохранении в кэш.
- * @param {Function} options.fn Функция для получения данных.
- * @param {Array} options.args Аргументы функции для запроса данных.
- * @return {import('./do-safe-request').ServerResponse} Результат.
- */
-export default function * cacheResult ({
-  cache,
-  key,
-  captureException,
-  validateCache = validateCacheDefault,
-  validateResult = validateResultDefault,
-  fn = doSafeRequest,
-  args = [],
-  duration = 3600,
-}) {
-  const { get, set, status } = cache || {};
-  let isCacheAvailable = status && isFunction(get) && isFunction(set);
-  const canDoRequest = isFunction(validateCache) && isFunction(fn);
-  let result;
-  try {
-    result = isCacheAvailable && (yield call(get, key));
-    if (validateCache(result)) {
-      result = JSON.parse(result);
-    }
-  } catch (error) {
-    if (isFunction(captureException)) {
-      captureException(error);
-    }
-    isCacheAvailable = false;
-    result = null;
-  }
-
-  if (canDoRequest && !validateCache(result)) {
-    result = yield call(fn, ...args);
-    const isResultValid = isFunction(validateResult) && validateResult(result);
-
-    if (isCacheAvailable && isResultValid) {
-      yield call(set, key, JSON.stringify(result), duration);
-    }
-  }
-
-  return result;
-}

package/src/helpers/saga/create-store.js

@@ -1,102 +0,0 @@
-import { applyMiddleware, createStore as createReduxStore } from 'redux';
-import createSagaMiddleware, { END } from 'redux-saga';
-import isFunction from 'lodash/isFunction';
-import { createService } from '../../container';
-import waitOnStoreReadiness from '../redux/wait-on-store-readiness';
-
-/**
- * Создаёт функцию для обработки успешного завершения подготовки стора.
- * @param {Function} onReady Опциональный обработчик успешного завершения.
- * @return {Function} Функция для обработки успешного завершения подготовки стора.
- */
-export const createSagaReadyHandler = onReady => store => {
-  store.dispatch(END);
-  isFunction(onReady) && onReady(store);
-};
-
-/**
- * Создаёт store с применённым middleware саг.
- * @param {Function} reducer Редьюсер.
- * @param {Function} initialSaga Инициализирующая сага.
- * @param {Object} options Необязательные опции.
- * @param {Function} options.isReady Функция для определения готовности store.
- * @param {Object} options.initialState Начальное состояние.
- * @param {Function} options.compose Функция для применения middleware.
- * @param {Array} options.middleware Список дополнительных middleware.
- * @param {Function} options.onReady Функция которая будет выполнена по готовности store.
- * @param {number} options.timeout Максимальное время ожидания готовности store.
- * @param {Function} [options.onTimeout] Функция обработчик события таймаута ожидания готовности store.
- * @param {Function} [options.onSagasErrorHandler] Корневой обработчик ошибок в сагах.
- * @return {Object} Объект со store и функцией runSaga для запуска саг.
- */
-export const createStore = (
-  reducer,
-  initialSaga,
-  {
-    isReady,
-    initialState = {},
-    compose = input => input,
-    middleware = [],
-    onReady,
-    timeout,
-    onTimeout,
-    onSagasErrorHandler,
-  } = {}
-) => {
-  const sagaMiddleware = createSagaMiddleware(
-    isFunction(onSagasErrorHandler)
-      ? { onError: onSagasErrorHandler }
-      : {}
-  );
-  let store = createReduxStore(
-    reducer,
-    initialState,
-    compose(applyMiddleware(sagaMiddleware, ...middleware))
-  );
-  if (isFunction(isReady)) {
-    store = waitOnStoreReadiness(
-      store,
-      isReady,
-      createSagaReadyHandler(onReady),
-      onTimeout,
-      timeout
-    );
-  } else if (isFunction(onReady)) {
-    throw new TypeError(
-      'Third argument property "onReady" is a function, when property "isReady" is not a function. '
-      + 'The "onReady" function will never be called.'
-    );
-  }
-  return {
-    store,
-    runSaga: () => sagaMiddleware.run(initialSaga).toPromise(),
-  };
-};
-
-/**
- * Преобразует опции сервиса в аргументы функции.
- * @param {Object} param Параметры.
- * @param {Function} param.reducer Редьюсер.
- * @param {Function} param.initialSaga Инициализирующая сага.
- * @param {Object} param.options Остальные, необязательные опции.
- * @return {Array} Массив агрументов для использования в функции.
- */
-export const mapServiceOptionsToArgs = (
-  {
-    reducer,
-    initialSaga,
-    ...options
-  }
-) => [
-  reducer,
-  initialSaga,
-  options,
-];
-
-/**
- * @type {Function} Сервис создания store для использования совместно с контейнером
- */
-export const createStoreService = createService(
-  createStore,
-  mapServiceOptionsToArgs
-);

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

@@ -1,47 +0,0 @@
-import { call } from 'redux-saga/effects';
-import get from 'lodash/get';
-
-/**
- * @typedef {Object} ServerResponse Ответ сервера.
- * @property {boolean} ok Были ли запрос совершен успешно.
- * @property {Object|null} error Объект ошибки.
- * @property {Object|string|null} data Данные ответа.
- * @property {number|null} status Статус ответа.
- */
-
-/**
- * Безопасно запрашивает данные c сервера, с обработкой и логированием ошибок, обрабатывает ответ.
- * @param {Function} performRequest Функция, выполняющая запрос.
- * @param {Object} [options] Опции.
- * @param {Array} [options.args] Аргументы функции, выполняющей запрос.
- * @return {ServerResponse} Ответ сервера.
- */
-export default function * doSafeRequest (
-  performRequest,
-  options
-) {
-  const {
-    args = [],
-  } = options || {};
-
-  let response;
-  let ok = false;
-  let originalError = null;
-
-  try {
-    response = yield call(performRequest, ...args);
-    ok = true;
-  } catch (error) {
-    // пытаемся получить данные ответа из ошибки
-    response = error.response;
-
-    // добавляем в результат объект ошибки
-    originalError = error;
-  }
-  return {
-    ok,
-    error: originalError,
-    data: get(response, 'data', null),
-    status: get(response, 'status', null),
-  };
-}

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

@@ -1,11 +0,0 @@
-import { call } from 'redux-saga/effects';
-import doSafeRequest from './do-safe-request';
-
-/**
- * Обёрнутая в эффект call сага doSafeRequest.
- * @param {Array} args Аргументы для вызова саги.
- * @return {import('@redux-saga/core/effects').CallEffect} Эффект.
- */
-const safeRequest = (...args) => call(doSafeRequest, ...args);
-
-export default safeRequest;

package/src/helpers/saga/take-chain.js

@@ -1,53 +0,0 @@
-import { delay, fork, put, race, take } from 'redux-saga/effects';
-import propEq from 'lodash/fp/propEq';
-import now from 'lodash/now';
-
-/**
- * Накапливает экшены и генерирует эффект по таймауту.
- * @param {number} timeout Время задержки в мс.
- * @param {Array} types Массив с типами экшенов.
- * @param {Function} task Генератор.
- * @param {...*} args Аргументы для генератора.
- * @return {Object} Эффект.
- */
-export const takeChain = (timeout, types, task, ...args) =>
-  fork(generateTakeChain, timeout, types, task, ...args);
-
-/**
- * Генерирует эффект по таймауту.
- * @param {number} timeout Время задержки в мс.
- * @param {Array} types Массив с типами экшенов.
- * @param {Function} task Генератор.
- * @param {...*} args Аргументы для генератора.
- */
-export function * generateTakeChain (timeout, types, task, ...args) {
-  while (true) {
-    const BREAK_TYPE = `BREAK_${now()}`;
-    const collectedActions = [yield take(types)];
-
-    yield fork(putDelayed, timeout, BREAK_TYPE);
-
-    while (true) {
-      const { action, canceled } = yield race({
-        action: take(types),
-        canceled: take(BREAK_TYPE),
-      });
-
-      action && collectedActions.push(action);
-      if (canceled || types.every(type => collectedActions.some(propEq('type', type)))) {
-        yield fork(task, ...args, collectedActions);
-        break;
-      }
-    }
-  }
-}
-
-/**
- * Вызывает экшен с заданной задержкой.
- * @param {number} timeout Время задержки в мс.
- * @param {string} type Тип экшена.
- */
-export function * putDelayed (timeout, type) {
-  yield delay(timeout);
-  yield put({ type });
-}