@sima-land/isomorph 11.0.0-alpha.35 → 11.0.0-alpha.37

package/dist/cjs/preset/isomorphic/utils/index.js

@@ -0,0 +1,322 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SagaLogging = exports.HttpStatus = exports.HttpClientLogging = exports.HttpApiHostPool = void 0;
+exports.displayUrl = displayUrl;
+exports.severityFromStatus = severityFromStatus;
+var _axios = _interopRequireDefault(require("axios"));
+var _log = require("../../../log");
+var _utils = require("../../../utils/axios/utils");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** Реализация пула хостов. */
+class HttpApiHostPool {
+  /**
+   * Конструктор.
+   * @param map Карта "Название api >> Название переменной среды с хостом api".
+   * @param source Источник конфигурации.
+   */
+  constructor(map, source) {
+    this.map = map;
+    this.source = source;
+  }
+
+  /** @inheritDoc */
+  get(key) {
+    const variableName = this.map[key];
+    if (!variableName) {
+      throw Error(`Known HTTP API not found by key "${key}"`);
+    }
+
+    // "лениво" берём переменную, именно в момент вызова (чтобы не заставлять указывать в сервисах все переменные разом)
+    return this.source.require(variableName);
+  }
+}
+
+/**
+ * Возвращает уровень на основе статуса ответа.
+ * @param status Статус HTTP-ответа.
+ * @return Уровень.
+ */
+exports.HttpApiHostPool = HttpApiHostPool;
+function severityFromStatus(status) {
+  let result;
+  if (typeof status === 'number') {
+    switch (true) {
+      case status >= 200 && status <= 299:
+        result = 'info';
+        break;
+      case status >= 300 && status <= 499:
+        result = 'warning';
+        break;
+      default:
+        result = 'error';
+    }
+  } else {
+    result = 'error';
+  }
+  return result;
+}
+
+/**
+ * Обработчик для промежуточного слоя логирования исходящих http-запросов.
+ * Отправляет хлебные крошки и данные ошибки, пригодные для Sentry.
+ */
+class HttpClientLogging {
+  /**
+   * Конструктор.
+   * @param logger Logger.
+   * @param data Данные запроса.
+   */
+  constructor(logger, data) {
+    const config = (0, _utils.applyAxiosDefaults)(data.config, data.defaults);
+    this.logger = logger;
+    this.requestInfo = {
+      ...config,
+      readyURL: displayUrl(config.baseURL, config.url)
+    };
+  }
+
+  /**
+   * Отправит хлебные крошки перед запросом.
+   */
+  beforeRequest() {
+    const {
+      readyURL,
+      method,
+      params
+    } = this.requestInfo;
+    this.logger.info(new _log.Breadcrumb({
+      category: 'http.request',
+      type: 'http',
+      data: {
+        url: readyURL,
+        method,
+        params
+      },
+      level: 'info'
+    }));
+  }
+
+  /**
+   * Отправит хлебные крошки после запроса.
+   * @param data Данные ответа.
+   */
+  afterResponse({
+    response
+  }) {
+    const {
+      readyURL,
+      method,
+      params
+    } = this.requestInfo;
+    this.logger.info(new _log.Breadcrumb({
+      category: 'http.response',
+      type: 'http',
+      data: {
+        url: readyURL,
+        method,
+        status_code: response.status,
+        params
+      },
+      level: 'info'
+    }));
+  }
+
+  /**
+   * Отправит данные ошибки при перехвате.
+   * @param data Данные запроса.
+   */
+  onCatch({
+    error
+  }) {
+    if (_axios.default.isAxiosError(error)) {
+      const {
+        requestInfo
+      } = this;
+      const statusCode = error.response?.status || 'UNKNOWN';
+
+      // @todo выяснить: нужно ли нам отправлять ответы с кодом <500 в Sentry на уровне всех команд
+      // если да то можно добавить метод в духе errorStatusFilter(s => s !== 422)
+      this.logger.error(new _log.DetailedError(`HTTP request failed, status code: ${statusCode}, error message: ${error.message}`, {
+        level: severityFromStatus(error.response?.status),
+        context: [{
+          key: 'Request details',
+          data: {
+            url: requestInfo.url,
+            baseURL: requestInfo.baseURL,
+            method: requestInfo.method,
+            headers: requestInfo.headers,
+            data: requestInfo.data,
+            params: requestInfo.params
+          }
+        }, {
+          key: 'Response details',
+          data: {
+            data: error.response?.data,
+            // копируем так как в Sentry падает ошибка: **non-serializable** (TypeError: Object.getPrototypeOf(...) is null)
+            headers: {
+              ...error.response?.headers
+            },
+            error: error.toJSON()
+          }
+        }]
+      }));
+      if (typeof statusCode === 'number') {
+        this.logger.info(new _log.Breadcrumb({
+          category: 'http.response',
+          type: 'http',
+          data: {
+            url: requestInfo.readyURL,
+            method: requestInfo.method,
+            status_code: statusCode,
+            params: requestInfo.params
+          },
+          level: 'error'
+        }));
+      }
+    } else {
+      this.logger.error(error);
+    }
+  }
+}
+
+/**
+ * Лог событий запуска и выполнения redux-saga.
+ */
+exports.HttpClientLogging = HttpClientLogging;
+class SagaLogging {
+  /**
+   * @param logger Logger.
+   */
+  constructor(logger) {
+    this.logger = logger;
+  }
+
+  /**
+   * При получении ошибки выполнения саги передаст ее логгеру ее с данными стека в extra.
+   * @param error Ошибка.
+   * @param info Инфо выполнения саги.
+   */
+  onSagaError(error, info) {
+    this.logger.error(new _log.DetailedError(error.message, {
+      extra: {
+        key: 'Saga stack',
+        data: info.sagaStack
+      }
+    }));
+  }
+
+  /**
+   * При получении ошибки запуска саги передаст ее логгеру.
+   * @param error Ошибка.
+   */
+  onConfigError(error) {
+    this.logger.error(error);
+  }
+
+  /**
+   * При прерывании саги передаст информацию логгеру как ошибку.
+   * @param info Инфо прерывания саги.
+   */
+  onTimeoutInterrupt({
+    timeout
+  }) {
+    this.logger.error(new _log.DetailedError(`Сага прервана по таймауту (${timeout}мс)`, {
+      level: 'warning'
+    }));
+  }
+}
+
+/** Работа с HTTP-статусами по соглашению. */
+exports.SagaLogging = SagaLogging;
+class HttpStatus {
+  /**
+   * Определяет, является ли переданный статус успешным.
+   * @param status Статус.
+   * @return Признак.
+   */
+  static isOk(status) {
+    return typeof status === 'number' && status === 200;
+  }
+
+  /**
+   * Определяет, является ли переданный статус успешным POST.
+   * @param status Статус.
+   * @return Признак.
+   */
+  static isPostOk(status) {
+    return typeof status === 'number' && status === 201;
+  }
+
+  /**
+   * Определяет, является ли переданный статус успешным DELETE.
+   * @param status Статус.
+   * @return Признак.
+   */
+  static isDeleteOk(status) {
+    return typeof status === 'number' && (status === 204 || status === 200);
+  }
+
+  /**
+   * Возвращает новый промежуточный слой для валидации статуса HTTP-ответа.
+   * Валидация применяется только если в конфиге запроса не указан validateStatus.
+   * @return Промежуточный слой.
+   */
+  static axiosMiddleware() {
+    return async (config, next, defaults) => {
+      if (config.validateStatus !== undefined || defaults.validateStatus !== undefined) {
+        // если validateStatus указан явно то не применяем валидацию по умолчанию
+        await next(config);
+      } else {
+        let validateStatus = null;
+        switch (config.method?.toLowerCase()) {
+          case 'get':
+          case 'put':
+          case undefined:
+            validateStatus = HttpStatus.isOk;
+            break;
+          case 'post':
+            validateStatus = HttpStatus.isPostOk;
+            break;
+          case 'delete':
+            validateStatus = HttpStatus.isDeleteOk;
+            break;
+        }
+        await next({
+          ...config,
+          validateStatus
+        });
+      }
+    };
+  }
+}
+
+/**
+ * Объединяет значения опций baseURL и url (axios) в одну строку для логирования.
+ * @param baseURL Опция baseURL.
+ * @param url Опция url.
+ * @return Отображение. Не является валидным URL.
+ */
+exports.HttpStatus = HttpStatus;
+function displayUrl(baseURL = '', url = '') {
+  let result;
+  switch (true) {
+    case Boolean(baseURL && url):
+      result = `${baseURL.replace(/\/$/, '')}/${url.replace(/^\//, '')}`;
+      break;
+    case Boolean(baseURL) && !url:
+      result = baseURL;
+      break;
+    case !baseURL && Boolean(url):
+      result = url;
+      break;
+    case !baseURL && !url:
+    default:
+      result = '[empty]';
+      break;
+  }
+  return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/preset/isomorphic/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_axios","_interopRequireDefault","require","_log","_utils","obj","__esModule","default","HttpApiHostPool","constructor","map","source","get","key","variableName","Error","exports","severityFromStatus","status","result","HttpClientLogging","logger","data","config","applyAxiosDefaults","defaults","requestInfo","readyURL","displayUrl","baseURL","url","beforeRequest","method","params","info","Breadcrumb","category","type","level","afterResponse","response","status_code","onCatch","error","Axios","isAxiosError","statusCode","DetailedError","message","context","headers","toJSON","SagaLogging","onSagaError","extra","sagaStack","onConfigError","onTimeoutInterrupt","timeout","HttpStatus","isOk","isPostOk","isDeleteOk","axiosMiddleware","next","validateStatus","undefined","toLowerCase","Boolean","replace"],"sources":["../../../../../src/preset/isomorphic/utils/index.ts"],"sourcesContent":["import { SeverityLevel } from '@sentry/browser';\nimport Axios, { AxiosRequestConfig } from 'axios';\nimport type { Middleware } from 'middleware-axios';\nimport type { StrictMap } from '../types';\nimport type { ConfigSource } from '../../../config/types';\nimport { Logger, Breadcrumb, DetailedError } from '../../../log';\nimport {\n  SharedData,\n  DoneSharedData,\n  FailSharedData,\n  LogMiddlewareHandler,\n} from '../../../utils/axios/middleware/log';\nimport { applyAxiosDefaults } from '../../../utils/axios/utils';\nimport {\n  SagaErrorInfo,\n  SagaInterruptInfo,\n  SagaMiddlewareHandler,\n} from '../../../utils/redux-saga/types';\n\n/** Реализация пула хостов. */\nexport class HttpApiHostPool<Key extends string> implements StrictMap<Key> {\n  private map: Record<Key, string>;\n  private source: ConfigSource;\n\n  /**\n   * Конструктор.\n   * @param map Карта \"Название api >> Название переменной среды с хостом api\".\n   * @param source Источник конфигурации.\n   */\n  constructor(map: Record<Key, string>, source: ConfigSource) {\n    this.map = map;\n    this.source = source;\n  }\n\n  /** @inheritDoc */\n  get(key: Key): string {\n    const variableName = this.map[key];\n\n    if (!variableName) {\n      throw Error(`Known HTTP API not found by key \"${key}\"`);\n    }\n\n    // \"лениво\" берём переменную, именно в момент вызова (чтобы не заставлять указывать в сервисах все переменные разом)\n    return this.source.require(variableName);\n  }\n}\n\n/**\n * Возвращает уровень на основе статуса ответа.\n * @param status Статус HTTP-ответа.\n * @return Уровень.\n */\nexport function severityFromStatus(status: unknown): SeverityLevel {\n  let result: SeverityLevel;\n\n  if (typeof status === 'number') {\n    switch (true) {\n      case status >= 200 && status <= 299:\n        result = 'info';\n        break;\n      case status >= 300 && status <= 499:\n        result = 'warning';\n        break;\n      default:\n        result = 'error';\n    }\n  } else {\n    result = 'error';\n  }\n\n  return result;\n}\n\n/**\n * Обработчик для промежуточного слоя логирования исходящих http-запросов.\n * Отправляет хлебные крошки и данные ошибки, пригодные для Sentry.\n */\nexport class HttpClientLogging implements LogMiddlewareHandler {\n  protected logger: Logger;\n\n  protected readonly requestInfo: ReturnType<typeof applyAxiosDefaults> & {\n    readyURL: string;\n  };\n\n  /**\n   * Конструктор.\n   * @param logger Logger.\n   * @param data Данные запроса.\n   */\n  constructor(logger: Logger, data: SharedData) {\n    const config = applyAxiosDefaults(data.config, data.defaults);\n\n    this.logger = logger;\n\n    this.requestInfo = {\n      ...config,\n      readyURL: displayUrl(config.baseURL, config.url),\n    };\n  }\n\n  /**\n   * Отправит хлебные крошки перед запросом.\n   */\n  beforeRequest() {\n    const { readyURL, method, params } = this.requestInfo;\n\n    this.logger.info(\n      new Breadcrumb({\n        category: 'http.request',\n        type: 'http',\n        data: {\n          url: readyURL,\n          method,\n          params,\n        },\n        level: 'info',\n      }),\n    );\n  }\n\n  /**\n   * Отправит хлебные крошки после запроса.\n   * @param data Данные ответа.\n   */\n  afterResponse({ response }: DoneSharedData) {\n    const { readyURL, method, params } = this.requestInfo;\n\n    this.logger.info(\n      new Breadcrumb({\n        category: 'http.response',\n        type: 'http',\n        data: {\n          url: readyURL,\n          method,\n          status_code: response.status,\n          params,\n        },\n        level: 'info',\n      }),\n    );\n  }\n\n  /**\n   * Отправит данные ошибки при перехвате.\n   * @param data Данные запроса.\n   */\n  onCatch({ error }: FailSharedData) {\n    if (Axios.isAxiosError(error)) {\n      const { requestInfo } = this;\n      const statusCode = error.response?.status || 'UNKNOWN';\n\n      // @todo выяснить: нужно ли нам отправлять ответы с кодом <500 в Sentry на уровне всех команд\n      // если да то можно добавить метод в духе errorStatusFilter(s => s !== 422)\n      this.logger.error(\n        new DetailedError(\n          `HTTP request failed, status code: ${statusCode}, error message: ${error.message}`,\n          {\n            level: severityFromStatus(error.response?.status),\n            context: [\n              {\n                key: 'Request details',\n                data: {\n                  url: requestInfo.url,\n                  baseURL: requestInfo.baseURL,\n                  method: requestInfo.method,\n                  headers: requestInfo.headers,\n                  data: requestInfo.data,\n                  params: requestInfo.params,\n                },\n              },\n              {\n                key: 'Response details',\n                data: {\n                  data: error.response?.data,\n\n                  // копируем так как в Sentry падает ошибка: **non-serializable** (TypeError: Object.getPrototypeOf(...) is null)\n                  headers: { ...error.response?.headers },\n\n                  error: error.toJSON(),\n                },\n              },\n            ],\n          },\n        ),\n      );\n\n      if (typeof statusCode === 'number') {\n        this.logger.info(\n          new Breadcrumb({\n            category: 'http.response',\n            type: 'http',\n            data: {\n              url: requestInfo.readyURL,\n              method: requestInfo.method,\n              status_code: statusCode,\n              params: requestInfo.params,\n            },\n            level: 'error',\n          }),\n        );\n      }\n    } else {\n      this.logger.error(error);\n    }\n  }\n}\n\n/**\n * Лог событий запуска и выполнения redux-saga.\n */\nexport class SagaLogging implements SagaMiddlewareHandler {\n  protected logger: Logger;\n\n  /**\n   * @param logger Logger.\n   */\n  constructor(logger: Logger) {\n    this.logger = logger;\n  }\n\n  /**\n   * При получении ошибки выполнения саги передаст ее логгеру ее с данными стека в extra.\n   * @param error Ошибка.\n   * @param info Инфо выполнения саги.\n   */\n  onSagaError(error: Error, info: SagaErrorInfo) {\n    this.logger.error(\n      new DetailedError(error.message, {\n        extra: {\n          key: 'Saga stack',\n          data: info.sagaStack,\n        },\n      }),\n    );\n  }\n\n  /**\n   * При получении ошибки запуска саги передаст ее логгеру.\n   * @param error Ошибка.\n   */\n  onConfigError(error: Error) {\n    this.logger.error(error);\n  }\n\n  /**\n   * При прерывании саги передаст информацию логгеру как ошибку.\n   * @param info Инфо прерывания саги.\n   */\n  onTimeoutInterrupt({ timeout }: SagaInterruptInfo) {\n    this.logger.error(\n      new DetailedError(`Сага прервана по таймауту (${timeout}мс)`, {\n        level: 'warning',\n      }),\n    );\n  }\n}\n\n/** Работа с HTTP-статусами по соглашению. */\nexport abstract class HttpStatus {\n  /**\n   * Определяет, является ли переданный статус успешным.\n   * @param status Статус.\n   * @return Признак.\n   */\n  static isOk(status: unknown): boolean {\n    return typeof status === 'number' && status === 200;\n  }\n\n  /**\n   * Определяет, является ли переданный статус успешным POST.\n   * @param status Статус.\n   * @return Признак.\n   */\n  static isPostOk(status: unknown): boolean {\n    return typeof status === 'number' && status === 201;\n  }\n\n  /**\n   * Определяет, является ли переданный статус успешным DELETE.\n   * @param status Статус.\n   * @return Признак.\n   */\n  static isDeleteOk(status: unknown): boolean {\n    return typeof status === 'number' && (status === 204 || status === 200);\n  }\n\n  /**\n   * Возвращает новый промежуточный слой для валидации статуса HTTP-ответа.\n   * Валидация применяется только если в конфиге запроса не указан validateStatus.\n   * @return Промежуточный слой.\n   */\n  static axiosMiddleware(): Middleware<unknown> {\n    return async (config, next, defaults) => {\n      if (config.validateStatus !== undefined || defaults.validateStatus !== undefined) {\n        // если validateStatus указан явно то не применяем валидацию по умолчанию\n        await next(config);\n      } else {\n        let validateStatus: AxiosRequestConfig['validateStatus'] = null;\n\n        switch (config.method?.toLowerCase()) {\n          case 'get':\n          case 'put':\n          case undefined:\n            validateStatus = HttpStatus.isOk;\n            break;\n          case 'post':\n            validateStatus = HttpStatus.isPostOk;\n            break;\n          case 'delete':\n            validateStatus = HttpStatus.isDeleteOk;\n            break;\n        }\n\n        await next({ ...config, validateStatus });\n      }\n    };\n  }\n}\n\n/**\n * Объединяет значения опций baseURL и url (axios) в одну строку для логирования.\n * @param baseURL Опция baseURL.\n * @param url Опция url.\n * @return Отображение. Не является валидным URL.\n */\nexport function displayUrl(\n  baseURL: AxiosRequestConfig['baseURL'] = '',\n  url: AxiosRequestConfig['url'] = '',\n) {\n  let result: string;\n\n  switch (true) {\n    case Boolean(baseURL && url):\n      result = `${baseURL.replace(/\\/$/, '')}/${url.replace(/^\\//, '')}`;\n      break;\n    case Boolean(baseURL) && !url:\n      result = baseURL;\n      break;\n    case !baseURL && Boolean(url):\n      result = url;\n      break;\n    case !baseURL && !url:\n    default:\n      result = '[empty]';\n      break;\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/cjs/preset/node/handler/index.js

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "HandlerProvider", {
+  enumerable: true,
+  get: function () {
+    return _utils.HandlerProvider;
+  }
+});
+exports.PresetHandler = PresetHandler;
+var _di = require("../../../di");
+var _tokens = require("../../../tokens");
+var _providers = require("../../isomorphic/providers");
+var _providers2 = require("./providers");
+var _utils = require("./utils");
+/**
+ * Возвращает preset с зависимостями по умолчанию для работы в рамках ответа на http-запрос.
+ * @param customize Получит функцию с помощью которой можно переопределить предустановленные провайдеры.
+ * @todo Возможно стоит переименовать в PresetPageHandler.
+ * @return Preset.
+ */
+function PresetHandler(customize) {
+  // ВАЖНО: используем .set() вместо аргумента defaults функции createPreset из-за скорости
+  const preset = (0, _di.createPreset)();
+
+  // saga
+  preset.set(_tokens.KnownToken.sagaMiddleware, _providers.provideSagaMiddleware);
+
+  // http client
+  preset.set(_tokens.KnownToken.Http.Client.factory, _providers2.provideHttpClientFactory);
+  preset.set(_tokens.KnownToken.Http.Client.Middleware.Log.handler, _providers.provideHttpClientLogHandler);
+
+  // http handler
+  preset.set(_tokens.KnownToken.Http.Handler.main, _providers2.provideHandlerMain);
+  preset.set(_tokens.KnownToken.Http.Handler.Request.specificParams, _providers2.provideSpecificParams);
+  preset.set(_tokens.KnownToken.Http.Handler.Response.specificExtras, () => new _utils.SpecificExtras());
+  preset.set(_tokens.KnownToken.Http.Handler.Page.assets, () => ({
+    js: '',
+    css: ''
+  }));
+  preset.set(_tokens.KnownToken.Http.Handler.Page.helmet, _providers2.providePageHelmet);
+  preset.set(_tokens.KnownToken.Http.Handler.Page.render, _providers2.providePageRender);
+  if (customize) {
+    customize({
+      override: preset.set.bind(preset)
+    });
+  }
+  return preset;
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/preset/node/handler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_di","require","_tokens","_providers","_providers2","_utils","PresetHandler","customize","preset","createPreset","set","KnownToken","sagaMiddleware","provideSagaMiddleware","Http","Client","factory","provideHttpClientFactory","Middleware","Log","handler","provideHttpClientLogHandler","Handler","main","provideHandlerMain","Request","specificParams","provideSpecificParams","Response","specificExtras","SpecificExtras","Page","assets","js","css","helmet","providePageHelmet","render","providePageRender","override","bind"],"sources":["../../../../../src/preset/node/handler/index.ts"],"sourcesContent":["import { Preset, createPreset } from '../../../di';\nimport { KnownToken } from '../../../tokens';\nimport { provideSagaMiddleware, provideHttpClientLogHandler } from '../../isomorphic/providers';\nimport { PresetTuner } from '../../isomorphic/types';\nimport {\n  provideHttpClientFactory,\n  provideHandlerMain,\n  provideSpecificParams,\n  providePageHelmet,\n  providePageRender,\n} from './providers';\nimport { SpecificExtras } from './utils';\n\n/**\n * Возвращает preset с зависимостями по умолчанию для работы в рамках ответа на http-запрос.\n * @param customize Получит функцию с помощью которой можно переопределить предустановленные провайдеры.\n * @todo Возможно стоит переименовать в PresetPageHandler.\n * @return Preset.\n */\nexport function PresetHandler(customize?: PresetTuner): Preset {\n  // ВАЖНО: используем .set() вместо аргумента defaults функции createPreset из-за скорости\n  const preset = createPreset();\n\n  // saga\n  preset.set(KnownToken.sagaMiddleware, provideSagaMiddleware);\n\n  // http client\n  preset.set(KnownToken.Http.Client.factory, provideHttpClientFactory);\n  preset.set(KnownToken.Http.Client.Middleware.Log.handler, provideHttpClientLogHandler);\n\n  // http handler\n  preset.set(KnownToken.Http.Handler.main, provideHandlerMain);\n  preset.set(KnownToken.Http.Handler.Request.specificParams, provideSpecificParams);\n  preset.set(KnownToken.Http.Handler.Response.specificExtras, () => new SpecificExtras());\n  preset.set(KnownToken.Http.Handler.Page.assets, () => ({ js: '', css: '' }));\n  preset.set(KnownToken.Http.Handler.Page.helmet, providePageHelmet);\n  preset.set(KnownToken.Http.Handler.Page.render, providePageRender);\n\n  if (customize) {\n    customize({ override: preset.set.bind(preset) });\n  }\n\n  return preset;\n}\n\nexport { HandlerProvider } from './utils';\n"],"mappings":";;;;;;;;;;;;AAAA,IAAAA,GAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,UAAA,GAAAF,OAAA;AAEA,IAAAG,WAAA,GAAAH,OAAA;AAOA,IAAAI,MAAA,GAAAJ,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,aAAaA,CAACC,SAAuB,EAAU;EAC7D;EACA,MAAMC,MAAM,GAAG,IAAAC,gBAAY,EAAC,CAAC;;EAE7B;EACAD,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACC,cAAc,EAAEC,gCAAqB,CAAC;;EAE5D;EACAL,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACC,MAAM,CAACC,OAAO,EAAEC,oCAAwB,CAAC;EACpET,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACC,MAAM,CAACG,UAAU,CAACC,GAAG,CAACC,OAAO,EAAEC,sCAA2B,CAAC;;EAEtF;EACAb,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACQ,OAAO,CAACC,IAAI,EAAEC,8BAAkB,CAAC;EAC5DhB,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACQ,OAAO,CAACG,OAAO,CAACC,cAAc,EAAEC,iCAAqB,CAAC;EACjFnB,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACQ,OAAO,CAACM,QAAQ,CAACC,cAAc,EAAE,MAAM,IAAIC,qBAAc,CAAC,CAAC,CAAC;EACvFtB,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACQ,OAAO,CAACS,IAAI,CAACC,MAAM,EAAE,OAAO;IAAEC,EAAE,EAAE,EAAE;IAAEC,GAAG,EAAE;EAAG,CAAC,CAAC,CAAC;EAC5E1B,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACQ,OAAO,CAACS,IAAI,CAACI,MAAM,EAAEC,6BAAiB,CAAC;EAClE5B,MAAM,CAACE,GAAG,CAACC,kBAAU,CAACG,IAAI,CAACQ,OAAO,CAACS,IAAI,CAACM,MAAM,EAAEC,6BAAiB,CAAC;EAElE,IAAI/B,SAAS,EAAE;IACbA,SAAS,CAAC;MAAEgC,QAAQ,EAAE/B,MAAM,CAACE,GAAG,CAAC8B,IAAI,CAAChC,MAAM;IAAE,CAAC,CAAC;EAClD;EAEA,OAAOA,MAAM;AACf"}

package/dist/cjs/preset/node/handler/providers/index.js

@@ -0,0 +1,212 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.provideHandlerMain = provideHandlerMain;
+exports.provideHttpClientFactory = provideHttpClientFactory;
+exports.providePageHelmet = providePageHelmet;
+exports.providePageRender = providePageRender;
+exports.provideSpecificParams = provideSpecificParams;
+var _http = require("../../../../http");
+var _tokens = require("../../../../tokens");
+var _httpClient = require("../../node/utils/http-client");
+var _middlewareAxios = require("middleware-axios");
+var _utils = require("../../../isomorphic/utils");
+var _axios = require("../../../../utils/axios");
+var _constants = require("../../../isomorphic/constants");
+var _react = require("react");
+var _utils2 = require("../utils");
+var _server = require("react-dom/server");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * Провайдер фабрики http-клиентов.
+ * @param resolve Функция для получения зависимости по токену.
+ * @return Фабрика.
+ */
+function provideHttpClientFactory(resolve) {
+  // @todo а что если привести все зависимости к виду:
+  // const getAppConfig = resolve.lazy(KnownToken.Config.base);
+
+  const appConfig = resolve(_tokens.KnownToken.Config.base);
+  const tracer = resolve(_tokens.KnownToken.Tracing.tracer);
+  const context = resolve(_tokens.KnownToken.Http.Handler.context);
+  const logHandler = resolve(_tokens.KnownToken.Http.Client.Middleware.Log.handler);
+
+  // @todo добавить при необходимости (но тогда в логе будет значительно больше ошибок)
+  // можно не отсылать ошибки из клиента если ответ от сервера уже ушел (writableEnded)
+  // const controller = new AbortController();
+  // context.res.on('finish', () => {
+  //   controller.abort();
+  // });
+
+  // ВАЖНО: для всех клиентов в рамках обработчика должно быть одно хранилище cookie
+  const cookieStore = (0, _http.createCookieStore)(context.req.header('cookie'));
+  cookieStore.subscribe(() => {
+    if (!context.res.writableEnded) {
+      context.res.setHeader('cookie', cookieStore.getCookies());
+    }
+  });
+  const defaultHeaders = (0, _httpClient.getRequestHeaders)(appConfig, context.req);
+  return (config = {}) => {
+    const client = (0, _middlewareAxios.create)({
+      ...config,
+      headers: {
+        ...defaultHeaders,
+        // @todo убрать as any
+        ...config.headers
+      }
+    });
+    client.use(_utils.HttpStatus.axiosMiddleware());
+    client.use((0, _httpClient.tracingMiddleware)(tracer, context.res.locals.tracing.rootContext));
+    client.use((0, _axios.logMiddleware)(logHandler));
+    client.use((0, _axios.cookieMiddleware)(cookieStore));
+    return client;
+  };
+}
+
+/**
+ * Провайдер главной функции обработчика входящего http-запроса.
+ * @param resolve Функция для получения зависимости по токену.
+ * @return Главная функция.
+ */
+function provideHandlerMain(resolve) {
+  const config = resolve(_tokens.KnownToken.Config.base);
+  const logger = resolve(_tokens.KnownToken.logger);
+  const assetsInit = resolve(_tokens.KnownToken.Http.Handler.Page.assets);
+  const render = resolve(_tokens.KnownToken.Http.Handler.Page.render);
+  const extras = resolve(_tokens.KnownToken.Http.Handler.Response.specificExtras);
+  const Helmet = resolve(_tokens.KnownToken.Http.Handler.Page.helmet);
+  const {
+    req,
+    res
+  } = resolve(_tokens.KnownToken.Http.Handler.context);
+  const getAssets = typeof assetsInit === 'function' ? assetsInit : () => assetsInit;
+
+  /**
+   * Рендер JSX-элемента в строку.
+   * @param element Элемент.
+   * @return Строка.
+   */
+  const elementToString = element => {
+    res.emit(_constants.RESPONSE_EVENT_TYPE.renderStart);
+    const result = (0, _server.renderToString)(element);
+    res.emit(_constants.RESPONSE_EVENT_TYPE.renderFinish);
+    return result;
+  };
+  return async function main() {
+    try {
+      const assets = await getAssets();
+      const meta = extras.getMeta();
+      const jsx = /*#__PURE__*/(0, _jsxRuntime.jsx)(_utils2.HelmetContext.Provider, {
+        value: {
+          title: config.appName,
+          assets
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(Helmet, {
+          children: await render()
+        })
+      });
+      switch ((0, _utils2.getResponseFormat)(req)) {
+        case 'html':
+          {
+            res.setHeader('simaland-bundle-js', assets.js);
+            res.setHeader('simaland-bundle-css', assets.css);
+            if (assets.criticalJs) {
+              res.setHeader('simaland-critical-js', assets.criticalJs);
+            }
+            if (assets.criticalCss) {
+              res.setHeader('simaland-critical-css', assets.criticalCss);
+            }
+            if (meta) {
+              res.setHeader('simaland-meta', JSON.stringify(meta));
+            }
+
+            // ВАЖНО: DOCTYPE обязательно нужен так как влияет на то как браузер будет парсить html/css
+            // ВАЖНО: DOCTYPE нужен только когда отдаем полноценную страницу
+            if (config.env === 'development') {
+              res.send(`<!DOCTYPE html>${elementToString(jsx)}`);
+            } else {
+              res.send(elementToString(jsx));
+            }
+            break;
+          }
+        case 'json':
+          {
+            res.json({
+              markup: elementToString(jsx),
+              bundle_js: assets.js,
+              bundle_css: assets.css,
+              critical_js: assets.criticalJs,
+              critical_css: assets.criticalCss,
+              meta
+            });
+            break;
+          }
+      }
+    } catch (error) {
+      let message;
+      let statusCode = 500; // по умолчанию, если на этапе подготовки страницы что-то не так, отдаем 500
+
+      if (error instanceof Error) {
+        message = error.message;
+        if (error instanceof _http.ResponseError) {
+          statusCode = error.statusCode;
+        }
+      } else {
+        message = String(error);
+      }
+      res.status(statusCode).send(message);
+      logger.error(error);
+    }
+  };
+}
+
+/**
+ * Провайдер render-функции.
+ * @return Render-Функция.
+ */
+function providePageRender() {
+  return () => /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("h1", {
+      children: "Hello, world!"
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)("p", {
+      children: "This is a stub page. Define the render component in your handler"
+    })]
+  });
+}
+
+/**
+ * Провайдер helmet-компонента. Этот компонент является контейнером для результата render-функции.
+ * @param resolve Функция для получения зависимости по токену.
+ * @return Helmet-компонент.
+ */
+function providePageHelmet(resolve) {
+  const config = resolve(_tokens.KnownToken.Config.base);
+  const {
+    req
+  } = resolve(_tokens.KnownToken.Http.Handler.context);
+  return config.env === 'development' && (0, _utils2.getResponseFormat)(req) === 'html' ? _utils2.RegularHelmet : _react.Fragment;
+}
+
+/**
+ * Провайдер специфичных параметров, которые frontend-микросервис будет получать в запросе.
+ * @param resolve Функция для получения зависимости по токену.
+ * @return Параметры.
+ */
+function provideSpecificParams(resolve) {
+  const context = resolve(_tokens.KnownToken.Http.Handler.context);
+  try {
+    const headerValue = context.req.header('simaland-params');
+
+    /**
+     * Node.js переводит в ASCII.
+     * @see {https://github.com/nodejs/node/issues/17390}
+     */
+    const processedValue = headerValue ? Buffer.from(headerValue, 'binary').toString('utf8') : '';
+    return processedValue ? JSON.parse(processedValue) : {};
+  } catch {
+    return {};
+  }
+}
+//# sourceMappingURL=index.js.map