npm - @sima-land/isomorph - Versions diffs - 11.0.0-alpha.44 → 11.0.0-alpha.46 - Mend

@sima-land/isomorph 11.0.0-alpha.44 → 11.0.0-alpha.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (792) hide show

package/src/preset/node/handler/utils/index.tsx DELETED Viewed

@@ -1,110 +0,0 @@
-import { ReactNode, createContext, useContext } from 'react';
-import { PageAssets } from '../../../isomorphic/types';
-import { Handler, Request } from 'express';
-import { Application, CURRENT_APP, Resolve } from '../../../../di';
-import { KnownToken } from '../../../../tokens';
-export const HelmetContext = createContext<{ title?: string; assets?: PageAssets }>({});
-const resetCSS = `
-* {
-  box-sizing: border-box;
-}
-body {
-  font-family: -apple-system,BlinkMacSystemFont,'Source Sans Pro',"Segoe UI",Roboto,"Helvetica Neue",Ubuntu,Arial,sans-serif;
-  margin: 0;
-}
-`;
-/**
- * Простой Helmet-компонент.
- * Выведет html, head и body.
- * @param props Свойства.
- * @return Элемент.
- */
-export function RegularHelmet({ children }: { children?: ReactNode }) {
-  const { title, assets } = useContext(HelmetContext);
-  return (
-    <html>
-      <head>
-        <meta charSet='UTF-8' />
-        <meta httpEquiv='X-UA-Compatible' content='IE=edge' />
-        <meta name='viewport' content='width=device-width, initial-scale=1' />
-        <title>{title ?? 'Document'}</title>
-        <link
-          href='https://fonts.googleapis.com/css2?family=Source+Sans+Pro:ital,wght@0,200;0,300;0,400;0,600;0,700;0,900;1,200;1,300;1,400;1,600;1,700;1,900&amp;display=swap'
-          rel='stylesheet'
-        />
-        <style dangerouslySetInnerHTML={{ __html: resetCSS }} />
-        {assets?.criticalCss && <link rel='stylesheet' href={assets.criticalCss} />}
-        {assets?.css && <link rel='stylesheet' href={assets.css} />}
-        {assets?.criticalJs && <script src={assets.criticalJs} />}
-      </head>
-      <body>
-        {children}
-        {assets?.js && <script src={assets.js} />}
-      </body>
-    </html>
-  );
-}
-/**
- * Специфичные для наших микросервисов дополнительные данные ответа.
- */
-export class SpecificExtras {
-  private _meta: any;
-  /**
-   * Установит мета-данные.
-   * @param meta Данные.
-   * @return Контекст.
-   */
-  setMeta(meta: any): this {
-    this._meta = meta;
-    return this;
-  }
-  /**
-   * Вернет установленные мета-данные.
-   * @return Данные.
-   */
-  getMeta(): unknown {
-    return this._meta;
-  }
-}
-/**
- * Определит формат ответа.
- * @param req Запрос.
- * @return Формат.
- */
-export function getResponseFormat(req: Request): 'html' | 'json' {
-  let result: 'html' | 'json' = 'html';
-  if ((req.header('accept') || '').toLowerCase().includes('application/json')) {
-    result = 'json';
-  }
-  return result;
-}
-/**
- * Возвращает express-handler, создающий дочернее di-приложение при запросе.
- * @param getApp Должна вернуть di-приложения запроса.
- * @return Обработчик.
- */
-export function HandlerProvider(getApp: () => Application) {
-  return (resolve: Resolve): Handler => {
-    const parent = resolve(CURRENT_APP);
-    return (req, res, next) => {
-      const app = getApp();
-      app.attach(parent);
-      app.bind(KnownToken.Http.Handler.context).toValue({ req, res, next });
-      app.get(KnownToken.Http.Handler.main)();
-    };
-  };
-}

package/src/preset/node/index.ts DELETED Viewed

@@ -1,3 +0,0 @@
-export type { HandlerContext } from './types';
-export { PresetNode } from './node';
-export { PresetHandler, HandlerProvider } from './handler';

package/src/preset/node/node/index.ts DELETED Viewed

@@ -1,73 +0,0 @@
-import { KnownToken } from '../../../tokens';
-import { provideBaseConfig } from '../../isomorphic/providers';
-import { Preset, createPreset } from '../../../di';
-import { PresetTuner } from '../../isomorphic/types';
-import { healthCheck } from '../../../utils/express/handler/health-check';
-import {
-  provideConfigSource,
-  provideHttpClientFactory,
-  provideHttpServerErrorMiddleware,
-  provideHttpServerFactory,
-  provideHttpServerLogMiddleware,
-  provideHttpServerMetricsMiddleware,
-  provideHttpServerRequestMiddleware,
-  provideHttpServerTracingMiddleware,
-  provideKnownHttpApiHosts,
-  provideLogger,
-  provideMetricsHttpApp,
-  provideSpanExporter,
-  provideSsrBridgeServerSide,
-  provideTracer,
-  provideTracerProvider,
-  provideTracerProviderResource,
-} from './providers';
-/**
- * Возвращает preset с зависимостями по умолчанию для frontend-микросервисов на Node.js.
- * @param customize Получит функцию с помощью которой можно переопределить предустановленные провайдеры.
- * @return Preset.
- */
-export function PresetNode(customize?: PresetTuner): Preset {
-  // ВАЖНО: используем .set() вместо аргумента defaults функции createPreset из-за скорости
-  const preset = createPreset();
-  // config
-  preset.set(KnownToken.Config.source, provideConfigSource);
-  preset.set(KnownToken.Config.base, provideBaseConfig);
-  // log
-  preset.set(KnownToken.logger, provideLogger);
-  // tracing
-  preset.set(KnownToken.Tracing.tracer, provideTracer);
-  preset.set(KnownToken.Tracing.spanExporter, provideSpanExporter);
-  preset.set(KnownToken.Tracing.tracerProvider, provideTracerProvider);
-  preset.set(KnownToken.Tracing.tracerProviderResource, provideTracerProviderResource);
-  // metrics
-  preset.set(KnownToken.Metrics.httpApp, provideMetricsHttpApp);
-  // http client
-  preset.set(KnownToken.Http.Client.factory, provideHttpClientFactory);
-  // http server
-  preset.set(KnownToken.Http.Server.factory, provideHttpServerFactory);
-  preset.set(KnownToken.Http.Server.Handlers.healthCheck, healthCheck);
-  preset.set(KnownToken.Http.Server.Middleware.request, provideHttpServerRequestMiddleware);
-  preset.set(KnownToken.Http.Server.Middleware.log, provideHttpServerLogMiddleware);
-  preset.set(KnownToken.Http.Server.Middleware.metrics, provideHttpServerMetricsMiddleware);
-  preset.set(KnownToken.Http.Server.Middleware.tracing, provideHttpServerTracingMiddleware);
-  preset.set(KnownToken.Http.Server.Middleware.error, provideHttpServerErrorMiddleware);
-  // http api
-  preset.set(KnownToken.Http.Api.knownHosts, provideKnownHttpApiHosts);
-  // ssr bridge
-  preset.set(KnownToken.SsrBridge.serverSide, provideSsrBridgeServerSide);
-  if (customize) {
-    customize({ override: preset.set.bind(preset) });
-  }
-  return preset;
-}

package/src/preset/node/node/providers/index.ts DELETED Viewed

@@ -1,434 +0,0 @@
-import type { ConventionalFluentInfo, Logger, LogHandler } from '../../../../log/types';
-import { BridgeServerSide, SsrBridge } from '../../../../utils/ssr';
-import { ConfigSource, createConfigSource } from '../../../../config';
-import { createLogger } from '../../../../log';
-import { createPinoHandler } from '../../../../log/handler/pino';
-import { createSentryHandler } from '../../../../log/handler/sentry';
-import { HttpApiHostPool } from '../../../isomorphic/utils';
-import { KnownToken } from '../../../../tokens';
-import { Resolve } from '../../../../di';
-import { StrictMap, KnownHttpApiKey } from '../../../isomorphic/types';
-import { toMilliseconds } from '../../../../utils';
-import { RESPONSE_EVENT_TYPE } from '../../../isomorphic/constants';
-import { getClientIp } from '../utils/http-server';
-// Node.js specific packages
-import os from 'node:os';
-import path from 'node:path';
-// Node.js libraries (not isomorphic)
-import { config as applyDotenv } from 'dotenv';
-import { init, getCurrentHub, Handlers } from '@sentry/node';
-import * as PromClient from 'prom-client';
-import Express, { Application, ErrorRequestHandler, Handler, Request, Response } from 'express';
-import pino from 'pino';
-import PinoPretty from 'pino-pretty';
-// opentelemetry
-import { propagation, ROOT_CONTEXT, trace, type Tracer } from '@opentelemetry/api';
-import {
-  BasicTracerProvider,
-  BatchSpanProcessor,
-  SpanExporter,
-} from '@opentelemetry/sdk-trace-base';
-import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
-import { JaegerPropagator } from '@opentelemetry/propagator-jaeger';
-import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
-import { Resource } from '@opentelemetry/resources';
-import { SemanticResourceAttributes } from '@opentelemetry/semantic-conventions';
-import { create } from 'middleware-axios';
-/**
- * Провайдер источника конфигурации.
- * @return Источник конфигурации.
- */
-export function provideConfigSource(): ConfigSource {
-  const envName = process.env.NODE_ENV;
-  // подключаем соответствующий среде файл со значениями по умолчанию
-  if (envName) {
-    applyDotenv({ path: path.resolve(process.cwd(), `./.env.${envName}`) });
-  }
-  return createConfigSource(process.env);
-}
-/**
- * Провайдер Logger'а.
- * @param resolve Функция для получения зависимости по токену.
- * @return Logger.
- */
-export function provideLogger(resolve: Resolve): Logger {
-  const logger = createLogger();
-  // @todo возможно надо придумать как не давать вызывать провайдеры внутри провайдеров
-  logger.subscribe(providePinoHandler(resolve));
-  logger.subscribe(provideSentryHandler(resolve));
-  return logger;
-}
-/**
- * Провайдер обработчика логирования для Sentry.
- * @param resolve Функция для получения зависимости по токену.
- * @return Обработчик.
- */
-export function provideSentryHandler(resolve: Resolve): LogHandler {
-  const source = resolve(KnownToken.Config.source);
-  // экспериментально пробуем не использовать вручную созданный клиент
-  init({
-    dsn: source.require('SENTRY_DSN'),
-    release: source.require('SENTRY_RELEASE'),
-    environment: source.require('SENTRY_ENVIRONMENT'),
-  });
-  // ВАЖНО: передаем функцию чтобы брать текущий hub в момент вызова метода logger'а
-  // это нужно чтобы хлебные крошки в ошибках Sentry группировались по запросам
-  return createSentryHandler(getCurrentHub);
-}
-/**
- * Провайдер обработчика логирования для Pino.
- * @param resolve Функция для получения зависимости по токену.
- * @return Обработчик.
- */
-export function providePinoHandler(resolve: Resolve): LogHandler {
-  const config = resolve(KnownToken.Config.base);
-  const pinoLogger = pino(
-    config.env === 'production'
-      ? {
-          formatters: {
-            // ВАЖНО: для Fluent необходимо наличие поля level: string
-            level: label => ({ level: label }),
-          },
-        }
-      : PinoPretty({
-          colorize: true,
-          translateTime: 'yyyy-mm-dd HH:MM:ss.l o',
-        }),
-  );
-  return createPinoHandler(pinoLogger);
-}
-/**
- * Провайдер объекта Tracer.
- * @param resolve Функция для получения зависимости по токену.
- * @return Tracer.
- */
-export function provideTracer(resolve: Resolve): Tracer {
-  const config = resolve(KnownToken.Config.base);
-  const provider = resolve(KnownToken.Tracing.tracerProvider);
-  return provider.getTracer(config.appName, config.appVersion);
-}
-/**
- * Провайдер объекта SpanExporter.
- * @param resolve Функция для получения зависимости по токену.
- * @return SpanExporter.
- */
-export function provideSpanExporter(resolve: Resolve): SpanExporter {
-  const source = resolve(KnownToken.Config.source);
-  return new OTLPTraceExporter({
-    url: source.require('JAEGER_AGENT_URL'),
-  });
-}
-/**
- * Провайдер объекта BasicTracerProvider.
- * @param resolve Функция для получения зависимости по токену.
- * @return BasicTracerProvider.
- */
-export function provideTracerProvider(resolve: Resolve): BasicTracerProvider {
-  const exporter = resolve(KnownToken.Tracing.spanExporter);
-  const resource = resolve(KnownToken.Tracing.tracerProviderResource);
-  const provider = new NodeTracerProvider({ resource });
-  provider.addSpanProcessor(new BatchSpanProcessor(exporter));
-  provider.register({ propagator: new JaegerPropagator() });
-  return provider;
-}
-/**
- * Провайдер объекта Resource.
- * @param resolve Функция для получения зависимости по токену.
- * @return Resource.
- */
-export function provideTracerProviderResource(resolve: Resolve): Resource {
-  const config = resolve(KnownToken.Config.base);
-  return new Resource({
-    [SemanticResourceAttributes.HOST_NAME]: os.hostname(),
-    [SemanticResourceAttributes.SERVICE_NAME]: config.appName,
-    [SemanticResourceAttributes.SERVICE_VERSION]: config.appVersion,
-    [SemanticResourceAttributes.DEPLOYMENT_ENVIRONMENT]: config.env,
-  });
-}
-/**
- * Провайдер фабрики http-клиентов.
- * @return Фабрика.
- */
-export function provideHttpClientFactory() {
-  return create;
-}
-/**
- * Провайдер фабрики http-серверов.
- * @return Фабрика.
- */
-export function provideHttpServerFactory() {
-  return Express;
-}
-/**
- * Провайдер промежуточного слоя учета входящих http-запросов.
- * @return Промежуточный слой.
- */
-export function provideHttpServerRequestMiddleware(): Handler {
-  return Handlers.requestHandler();
-}
-/**
- * Провайдер промежуточного слоя логирования входящих http-запросов.
- * @param resolve Функция для получения зависимости по токену.
- * @return Промежуточный слой.
- */
-export function provideHttpServerLogMiddleware(resolve: Resolve): Handler {
-  const config = resolve(KnownToken.Config.base);
-  const logger = resolve(KnownToken.logger);
-  return (req, res, next) => {
-    const start = process.hrtime.bigint();
-    const remoteIp = getClientIp(req) ?? '';
-    const startMsg: Omit<ConventionalFluentInfo, 'latency' | 'status'> & { type: string } = {
-      type: 'http.request[incoming]',
-      version: config.appVersion,
-      route: req.originalUrl,
-      method: req.method,
-      remote_ip: remoteIp,
-    };
-    logger.info(startMsg);
-    res.once('finish', () => {
-      const finish = process.hrtime.bigint();
-      const finishMsg: ConventionalFluentInfo & { type: string } = {
-        type: 'http.response[outgoing]',
-        version: config.appVersion,
-        route: req.originalUrl,
-        method: req.method,
-        status: res.statusCode,
-        remote_ip: remoteIp,
-        latency: toMilliseconds(finish - start),
-      };
-      logger.info(finishMsg);
-    });
-    next();
-  };
-}
-/**
- * Провайдер промежуточного слоя сбора метрик входящих http-запросов.
- * @param resolve Функция для получения зависимости по токену.
- * @return Промежуточный слой.
- */
-export function provideHttpServerMetricsMiddleware(resolve: Resolve): Handler {
-  const config = resolve(KnownToken.Config.base);
-  const ConventionalLabels = {
-    HTTP_RESPONSE: ['version', 'route', 'code', 'method'],
-    SSR: ['version', 'route', 'method'],
-  } as const;
-  const requestCount = new PromClient.Counter({
-    name: 'http_request_count',
-    help: 'Incoming HTTP request count',
-    labelNames: ConventionalLabels.HTTP_RESPONSE,
-  });
-  const responseDuration = new PromClient.Histogram({
-    name: 'http_response_duration_ms',
-    help: 'Duration of incoming HTTP requests in ms',
-    labelNames: ConventionalLabels.HTTP_RESPONSE,
-    buckets: [30, 100, 200, 500, 1000, 2500, 5000, 10000],
-  });
-  const renderDuration = new PromClient.Histogram({
-    name: 'render_duration_ms',
-    help: 'Duration of SSR ms',
-    labelNames: ConventionalLabels.SSR,
-    buckets: [0.1, 15, 50, 100, 250, 500, 800, 1500],
-  });
-  /**
-   * Функция формирования labels.
-   * @param req Request.
-   * @param res Response.
-   * @return Labels.
-   */
-  const getLabels = (
-    req: Request,
-    res: Response,
-  ): Record<(typeof ConventionalLabels.HTTP_RESPONSE)[number], string | number> => ({
-    version: config.appVersion,
-    route: req.baseUrl + req.path,
-    code: res.statusCode,
-    method: req.method,
-  });
-  return (req, res, next) => {
-    const responseStart = process.hrtime.bigint();
-    requestCount.inc(getLabels(req, res), 1);
-    res.once(RESPONSE_EVENT_TYPE.renderStart, () => {
-      const renderStart = process.hrtime.bigint();
-      res.once(RESPONSE_EVENT_TYPE.renderFinish, () => {
-        const renderFinish = process.hrtime.bigint();
-        renderDuration.observe(
-          {
-            version: config.appVersion,
-            method: req.method,
-            route: req.baseUrl + req.path,
-          },
-          toMilliseconds(renderFinish - renderStart),
-        );
-      });
-    });
-    res.once('finish', () => {
-      const responseFinish = process.hrtime.bigint();
-      responseDuration.observe(getLabels(req, res), toMilliseconds(responseFinish - responseStart));
-    });
-    next();
-  };
-}
-/**
- * Провайдер промежуточного слоя трассировки входящих http-запросов.
- * @param resolve Функция для получения зависимости по токену.
- * @return Промежуточный слой.
- */
-export function provideHttpServerTracingMiddleware(resolve: Resolve): Handler {
-  const tracer = resolve(KnownToken.Tracing.tracer);
-  /**
-   * Возвращает набор стандартных атрибутов для спана.
-   * @param req Входящий http-запрос.
-   * @return Атрибуты.
-   */
-  const getConventionalRequestAttrs = (req: Request): Record<string, string | undefined> => {
-    const result: Record<string, string | undefined> = {
-      'request.path': req.originalUrl,
-    };
-    for (const headerName in req.headers) {
-      if (headerName.toLowerCase().startsWith('simaland-')) {
-        result[headerName] = req.header(headerName);
-      }
-    }
-    return result;
-  };
-  return (req, res, next) => {
-    const externalContext = propagation.extract(ROOT_CONTEXT, req.headers);
-    const rootSpan = tracer.startSpan('response', undefined, externalContext);
-    rootSpan.setAttributes(getConventionalRequestAttrs(req));
-    const rootContext = trace.setSpan(externalContext, rootSpan);
-    res.locals.tracing = {
-      rootSpan,
-      rootContext,
-      renderSpan: null,
-    };
-    res.once(RESPONSE_EVENT_TYPE.renderStart, () => {
-      res.locals.tracing.renderSpan = tracer.startSpan('render', undefined, rootContext);
-      res.once(RESPONSE_EVENT_TYPE.renderFinish, () => {
-        res.locals.tracing.renderSpan.end();
-      });
-    });
-    res.once('finish', () => {
-      rootSpan.end();
-    });
-    next();
-  };
-}
-/**
- * Провайдер промежуточного слоя обработки ошибок в рамках ответ на http-запросы.
- * @return Промежуточный слой.
- */
-export function provideHttpServerErrorMiddleware(): ErrorRequestHandler {
-  return Handlers.errorHandler();
-}
-/**
- * Провайдер серверной части "моста" для передачи данных между сервером и клиентом.
- * @param resolve Функция для получения зависимости по токену.
- * @return Серверная часть "моста".
- */
-export function provideSsrBridgeServerSide(resolve: Resolve): BridgeServerSide {
-  const config = resolve(KnownToken.Config.base);
-  return SsrBridge.prepare(config.appName);
-}
-/**
- * Провайдер известных http-хостов.
- * @param resolve Функция для получения зависимости по токену.
- * @return Пул известных http-хостов.
- */
-export function provideKnownHttpApiHosts(resolve: Resolve): StrictMap<KnownHttpApiKey> {
-  const source = resolve(KnownToken.Config.source);
-  return new HttpApiHostPool(
-    {
-      ilium: 'API_URL_ILIUM',
-      simaV3: 'API_URL_SIMALAND_V3',
-      simaV4: 'API_URL_SIMALAND_V4',
-      simaV6: 'API_URL_SIMALAND_V6',
-    },
-    source,
-  );
-}
-/**
- * Провайдер express-приложения метрик.
- * @return Пул известных http-хостов.
- */
-export function provideMetricsHttpApp(): Application {
-  PromClient.collectDefaultMetrics();
-  const app = Express();
-  app.get('/', async function (req, res) {
-    const metrics = await PromClient.register.metrics();
-    res.setHeader('Content-Type', PromClient.register.contentType);
-    res.send(metrics);
-  });
-  return app;
-}