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

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

@@ -1,244 +0,0 @@
-import isArrayBuffer from 'lodash/isArrayBuffer';
-import isFunction from 'lodash/isFunction';
-import isString from 'lodash/isString';
-import pipe from 'lodash/fp/pipe';
-import get from 'lodash/fp/get';
-import eq from 'lodash/fp/eq';
-
-import { http as httpFollow, https as httpsFollow } from 'follow-redirects';
-import http from 'http';
-import https from 'https';
-import zlib from 'zlib';
-
-/**
- * Проверяет, что переданный аргумент поддерживает метод экземпляра Stream.
- */
-export const isStream = pipe(
-  get('pipe'),
-  isFunction
-);
-
-/**
- * Проверяет, что переданный аргумент поддерживает метод экземпляра EventEmitter.
- */
-export const isEventEmitter = pipe(
-  get('emit'),
-  isFunction
-);
-
-/**
- * Проверяет, что переданный аргумент соответствует протоколу `https`.
- */
-export const isHttps = eq('https:');
-
-/**
- * Возвращает экземпляр Buffer созданный из переданных данных.
- * @param {Buffer|ArrayBuffer|string} data Данные.
- * @return {Buffer|undefined} Данные.
- */
-export const prepareDataBuffer = data => {
-  let result;
-  if (isString(data)) {
-    result = Buffer.from(data, 'utf-8');
-  } else if (Buffer.isBuffer(data)) {
-    result = data;
-  } else if (isArrayBuffer(data)) {
-    result = Buffer.from(new Uint8Array(data));
-  }
-  return result;
-};
-
-/**
- * Создает экземпляр URL из объединенного пути с базой. Если путь абсолютный - использует только его.
- * @param {string} input Путь для объединения.
- * @param {string} base База.
- * @return {URL} Объект URL.
- */
-export const createConcatURL = (input, base) => {
-  const cleanInput = input ? input.replace(/^\/(?!\/)/, '') : '';
-  const cleanBase = base ? base.replace(/\/?$/, '/') : undefined;
-  return new URL(cleanInput, cleanBase);
-};
-
-/**
- * Возвращает подходящий интерфейс транспорта в зависимости от конфигурации.
- * @param {Object} config Конфигурация.
- * @param {string} config.url Относительный URL запроса.
- * @param {string} config.baseURL Базовый URL.
- * @param {Object} config.transport Кастомный транспорт, переданный в конфигурации.
- * @param {number} config.maxRedirects Максимальное количество редиректов.
- * @return {Object} Транспорт.
- */
-export const createTransport = ({
-  url,
-  baseURL,
-  transport,
-  maxRedirects,
-}) => {
-  const { protocol } = createConcatURL(url, baseURL);
-  const isHttpsRequest = isHttps(protocol);
-
-  let result;
-  if (transport) {
-    result = transport;
-  } else if (maxRedirects === 0) {
-    result = isHttpsRequest ? https : http;
-  } else {
-    result = isHttpsRequest ? httpsFollow : httpFollow;
-  }
-  return result;
-};
-
-/**
- * Объединяет имеющиеся параметры запроса с переданными и возвращает сериализованный путь с параметрами запроса.
- * @param {URL} url Экземпляр URL.
- * @param {Object|string|URLSearchParams} [params] Параметры запроса.
- * @param {Function} [paramsSerializer] Функция для сериализации переданных параметров.
- * @return {string} Путь с параметрами.
- */
-export const buildRequestPath = (url, params, paramsSerializer) => {
-  const outlineSearchParams = new URLSearchParams(
-    isFunction(paramsSerializer)
-      ? paramsSerializer(params)
-      : params
-  );
-  outlineSearchParams.forEach((value, name) => url.searchParams.append(name, value));
-  return url.href.replace(url.origin, '');
-};
-
-/**
- * Формирует объект опций для запроса на основании переданной конфигурации.
- * @param {Object} config Конфигурация.
- * @return {Object} Опции.
- */
-export const createOptions = ({
-  url,
-  baseURL,
-  method,
-  headers,
-  httpAgent,
-  httpsAgent,
-  params,
-  paramsSerializer,
-  maxRedirects,
-  maxContentLength,
-}) => {
-  const fullURL = createConcatURL(url, baseURL);
-  const {
-    protocol,
-    hostname,
-    port,
-  } = fullURL;
-
-  const agent = isHttps(protocol) ? httpsAgent : httpAgent;
-
-  const result = {
-    path: buildRequestPath(fullURL, params, paramsSerializer),
-    method: method.toUpperCase(),
-    agents: { http: httpAgent, https: httpsAgent },
-    headers,
-    agent,
-    hostname,
-    port: Number(port) || undefined,
-  };
-
-  if (maxRedirects) {
-    result.maxRedirects = maxRedirects;
-  }
-
-  if (maxContentLength && maxContentLength > -1) {
-    result.maxBodyLength = maxContentLength;
-  }
-  return result;
-};
-
-/**
- * Возвращает декомпресированный запрос либо исходный запрос, если не было заголовка о компрессии.
- * @param {import('stream').Readable} response Запрос.
- * @return {import('stream').Readable} Обработанный запрос.
- */
-export const uncompressResponse = response => {
-  const isCompress = [
-    'gzip',
-    'compress',
-    'deflate',
-  ].includes(response.headers['content-encoding']);
-
-  return isCompress && response.statusCode !== 204
-    ? response.pipe(zlib.createUnzip())
-    : response;
-};
-
-/**
- * Возвращает ошибку, дополненную свойствами из запроса.
- * @param {Error} error Ошибка.
- * @param {Object} config Конфиг.
- * @param {string} code Код ошибки.
- * @param {import('http').ClientRequest} request Запрос.
- * @param {import('http').IncomingMessage} response Ответ.
- * @return {Error} Расширенная ошибка.
- */
-export const enhanceError = (error, config, code, request, response) => {
-  const enhance = {
-    config,
-    request,
-    response,
-    isAxiosError: true,
-
-    /**
-     * Возвращает объект для передачи в JSON.stringify().
-     * @return {Object} Объект.
-     */
-    toJSON () {
-      return {
-        message: this.message,
-        name: this.name,
-        description: this.description,
-        number: this.number,
-        fileName: this.fileName,
-        lineNumber: this.lineNumber,
-        columnNumber: this.columnNumber,
-        stack: this.stack,
-        config: this.config,
-        code: this.code,
-      };
-    },
-  };
-
-  if (code) {
-    enhance.code = code;
-  }
-
-  return Object.assign(error, enhance);
-};
-
-/**
- * Создает расширенную ошибку из текста и параметров запроса.
- * @param {string} message Текст ошибки.
- * @param {Array} rest Параметры запроса.
- * @return {Error} Ошибка.
- */
-export const createError = (message, ...rest) => enhanceError(new Error(message), ...rest);
-
-/**
- * Валидирует код ответа и разрешает промис.
- * @param {Function} resolve Разрешает промис.
- * @param {Function} reject Отклоняет промис.
- * @param {import('http').IncomingMessage} response Ответ на запрос.
- */
-export const settle = (resolve, reject, response) => {
-  const { status, config, request } = response;
-  const { validateStatus } = config || {};
-
-  if (!validateStatus || validateStatus(status)) {
-    resolve(response);
-  } else {
-    reject(createError(
-      `Request failed with status code ${status}`,
-      config,
-      null,
-      request,
-      response
-    ));
-  }
-};

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