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

package/src/preset/node/index.ts

@@ -1,101 +0,0 @@
-/* eslint-disable require-jsdoc */
-import type { Preset } from '../types';
-import type { Provider } from '../../container/types';
-import type { BaseConfig } from '../../config/types';
-import type { Logger } from '../../logger/types';
-import type { Tracer } from '@opentelemetry/api';
-import type { DefaultMiddleware } from '../../http-server/types';
-import { KnownToken as Token } from '../../tokens';
-import { createPreset } from '..';
-import { createConfigSource } from '../../config/node';
-import { createBaseConfig } from '../../config';
-import { createLogger } from '../../logger';
-import { createTracer } from '../../tracer/node';
-import { createConsoleHandler } from '../../logger/handler/console';
-import { createSentryHandler } from '../../logger/handler/sentry';
-import { createSentryLib } from '../../error-tracker/node';
-import { loggingMiddleware } from '../../http-server/middleware/logging';
-import { tracingMiddleware } from '../../http-server/middleware/tracing';
-import {
-  renderMetricsMiddleware,
-  responseMetricsMiddleware,
-} from '../../http-server/middleware/metrics';
-import { createDefaultMetrics, createMetricsHttpApp } from '../../metrics/node';
-import { JaegerExporter } from '@opentelemetry/exporter-jaeger';
-import { create } from 'middleware-axios';
-import Express from 'express';
-import { Handlers } from '@sentry/node';
-
-/**
- * Возвращает preset с зависимостями по умолчанию для frontend-микросервисов на Node.js.
- * @return Preset.
- */
-export function PresetNode(): Preset {
-  return createPreset([
-    [Token.Config.source, createConfigSource],
-    [Token.Config.base, provideBaseConfig],
-    [Token.logger, provideLogger],
-    [Token.tracer, provideTracer],
-    [Token.Http.Client.factory, () => create],
-    [Token.Http.Server.factory, () => Express],
-    [Token.Http.Server.Defaults.middleware, provideDefaultMiddleware],
-    [Token.Metrics.httpApp, createMetricsHttpApp],
-  ]);
-}
-
-export const provideBaseConfig: Provider<BaseConfig> = resolve => {
-  const source = resolve(Token.Config.source);
-
-  return createBaseConfig(source);
-};
-
-export const provideLogger: Provider<Logger> = resolve => {
-  const source = resolve(Token.Config.source);
-  const config = resolve(Token.Config.base);
-
-  const sentry = createSentryLib({
-    dsn: source.get('SENTRY_DSN'),
-    release: source.get('SENTRY_RELEASE'),
-    environment: source.get('SENTRY_ENVIRONMENT'),
-  });
-
-  const logger = createLogger();
-  logger.subscribe(createConsoleHandler(config));
-  logger.subscribe(createSentryHandler(sentry));
-
-  return logger;
-};
-
-export const provideTracer: Provider<Tracer> = resolve => {
-  const source = resolve(Token.Config.source);
-
-  const exporter = new JaegerExporter({
-    endpoint: source.require('JAEGER_ENDPOINT'),
-  });
-
-  return createTracer(resolve(Token.Config.base), exporter);
-};
-
-export const provideDefaultMiddleware: Provider<DefaultMiddleware> = resolve => {
-  const config = resolve(Token.Config.base);
-  const logger = resolve(Token.logger);
-  const tracer = resolve(Token.tracer);
-
-  const metrics = createDefaultMetrics();
-
-  return {
-    start: [Handlers.requestHandler()],
-    logging: [loggingMiddleware(config, logger)],
-    tracing: [tracingMiddleware(tracer)],
-    metrics: [
-      responseMetricsMiddleware(config, {
-        counter: metrics.requestCount,
-        histogram: metrics.responseDuration,
-      }),
-      renderMetricsMiddleware(config, {
-        histogram: metrics.renderDuration,
-      }),
-    ],
-    finish: [Handlers.errorHandler()],
-  };
-};

package/src/preset/node/response.ts

@@ -1,57 +0,0 @@
-/* eslint-disable require-jsdoc */
-import type { Preset } from '../types';
-import type { Provider } from '../../container/types';
-import type { SagaRunner } from '../../saga-runner/types';
-import { KnownToken } from '../../tokens';
-import { createPreset } from '..';
-import { renderToString } from 'react-dom/server';
-import { createSagaRunner } from '../../saga-runner';
-import { RESPONSE_EVENT } from '../../http-server/constants';
-import { PageResponse } from '../../http-server/utils';
-
-/**
- * Возвращает preset с зависимостями по умолчанию для работы в рамках ответа на http-запрос.
- * @return Preset.
- */
-export function PresetResponse(): Preset {
-  return createPreset([
-    [KnownToken.Response.sagaRunner, provideSagaRunner],
-    [KnownToken.Response.render, provideRender],
-    [KnownToken.Response.main, provideMain],
-  ]);
-}
-
-export const provideSagaRunner: Provider<SagaRunner> = resolve => {
-  const logger = resolve(KnownToken.logger);
-  return createSagaRunner(logger);
-};
-
-export const provideRender: Provider<(el: JSX.Element) => string | Promise<string>> = resolve => {
-  const { res } = resolve(KnownToken.Response.context);
-
-  return function render(element: JSX.Element): string {
-    res.emit(RESPONSE_EVENT.renderStart);
-
-    const result = renderToString(element);
-
-    res.emit(RESPONSE_EVENT.renderFinish);
-
-    return result;
-  };
-};
-
-export const provideMain: Provider<() => void> = resolve => {
-  const context = resolve(KnownToken.Response.context);
-  const assets = resolve(KnownToken.Response.assets);
-  const prepare = resolve(KnownToken.Response.prepare);
-  const render = resolve(KnownToken.Response.render);
-
-  return async function main() {
-    PageResponse.create()
-      .markup(await render(await prepare()))
-      .script(assets.js)
-      .style(assets.css)
-      .format(PageResponse.defineFormat(context.req))
-      .send(context.res);
-  };
-};

package/src/preset/types.ts

@@ -1,9 +0,0 @@
-import type { Application } from '../container/application';
-import type { Token, Provider } from '../container/types';
-
-export type PresetEntry<T = any> = [Token<T>, Provider<T>];
-
-export interface Preset {
-  override: <T>(token: Token<T>, provider: Provider<T>) => void;
-  apply: (application: Application) => void;
-}

package/src/saga-runner/index.ts

@@ -1,59 +0,0 @@
-import type { Store } from '@reduxjs/toolkit';
-import type { Logger } from '../logger/types';
-import type { SagaRunner } from './types';
-import createSagaMiddleware, { Saga, END } from 'redux-saga';
-import { SentryError } from '../error-tracker/utils';
-
-/**
- * Возвращает новый runner для redux-saga.
- * @param logger Logger.
- * @return Runner.
- */
-export function createSagaRunner(logger: Logger): SagaRunner {
-  const middleware = createSagaMiddleware({
-    onError: (error, { sagaStack }) => {
-      logger.error(
-        new SentryError(error.message, {
-          extra: { key: 'Saga stack', data: sagaStack },
-        }),
-      );
-    },
-  });
-
-  return {
-    middleware,
-
-    // eslint-disable-next-line require-jsdoc, jsdoc/require-jsdoc
-    prepare(store: Store, { timeout }: { timeout?: number } = {}) {
-      return {
-        // eslint-disable-next-line require-jsdoc, jsdoc/require-jsdoc
-        async run<S extends Saga>(saga: S, ...args: Parameters<S>) {
-          let ready = false;
-
-          await Promise.race([
-            // ждем пока сага выполнится
-            middleware
-              .run(saga, ...args)
-              .toPromise()
-              .then(() => {
-                ready = true;
-              }),
-
-            // если сага не выполнилась за положенное время - прерываем
-            typeof timeout === 'number' &&
-              Number.isFinite(timeout) &&
-              new Promise<void>(resolve => {
-                setTimeout(() => {
-                  if (!ready) {
-                    logger.error(Error('Сага прервана по таймауту'));
-                    store.dispatch(END);
-                  }
-                  resolve();
-                }, timeout);
-              }),
-          ]);
-        },
-      };
-    },
-  };
-}

package/src/saga-runner/types.ts

@@ -1,13 +0,0 @@
-import type { Saga, SagaMiddleware } from 'redux-saga';
-import type { Store } from '@reduxjs/toolkit';
-
-export interface SagaRunner {
-  middleware: SagaMiddleware<any>;
-
-  prepare: (
-    store: Store,
-    options?: { timeout?: number },
-  ) => {
-    run: <S extends Saga>(saga: S, ...args: Parameters<S>) => Promise<void>;
-  };
-}

package/src/tokens.ts

@@ -1,54 +0,0 @@
-import { createToken } from './container';
-import type { Application } from 'express';
-import type { DefaultMiddleware, PageAssets, ResponseContext } from './http-server/types';
-import type { SagaRunner } from './saga-runner/types';
-import type { Logger } from './logger/types';
-import type { HttpClientFactory } from './http-client/types';
-import type { ConfigSource, BaseConfig } from './config/types';
-import type { Tracer } from './tracer/types';
-import type { Cache } from './cache/types';
-
-export const KnownToken = {
-  // config
-  Config: {
-    source: createToken<ConfigSource>('config.source'),
-    base: createToken<BaseConfig>('config.base'),
-  },
-
-  // cache
-  cache: createToken<Cache>('cache'),
-
-  // logging
-  logger: createToken<Logger>('logger'),
-
-  // tracing
-  tracer: createToken<Tracer>('tracer'),
-
-  // metrics
-  Metrics: {
-    httpApp: createToken<Application>('metrics.http-app'),
-  },
-
-  // http
-  Http: {
-    Client: {
-      factory: createToken<HttpClientFactory>('http.client.factory'),
-    },
-    Server: {
-      factory: createToken<() => Application>('http.server.factory'),
-      Defaults: {
-        middleware: createToken<DefaultMiddleware>('http.server.defaults.middleware'),
-      },
-    },
-  },
-
-  // scope: page response
-  Response: {
-    context: createToken<ResponseContext>('response/context'),
-    assets: createToken<PageAssets>('response/assets'),
-    prepare: createToken<() => JSX.Element | Promise<JSX.Element>>('response/prepare'),
-    render: createToken<(element: JSX.Element) => string | Promise<string>>('response/render'),
-    main: createToken<() => void>('response/main'),
-    sagaRunner: createToken<SagaRunner>('response/saga-runner'),
-  },
-} as const;

package/src/tracer/node.ts

@@ -1,40 +0,0 @@
-import type { Tracer } from './types';
-import type { BaseConfig } from '../config/types';
-import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
-import { BatchSpanProcessor, SpanExporter } from '@opentelemetry/tracing';
-import { SemanticResourceAttributes } from '@opentelemetry/semantic-conventions';
-import { registerInstrumentations } from '@opentelemetry/instrumentation';
-import { ExpressInstrumentation } from '@opentelemetry/instrumentation-express';
-import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
-import { Resource } from '@opentelemetry/resources';
-import { JaegerPropagator } from '@opentelemetry/propagator-jaeger';
-
-/**
- * Возвращает новый tracer - объект для трассировки стадий различных процессов.
- * @param config Конфиг.
- * @param exporter Экспортер данных трассировки.
- * @return Tracer.
- */
-export function createTracer(config: BaseConfig, exporter: SpanExporter): Tracer {
-  // @todo доделать по инструкции: https://selvaganesh93.medium.com/tracing-node-js-application-with-opentelemetry-jaeger-ui-9523c0ac8453
-  const provider = new NodeTracerProvider({
-    resource: new Resource({
-      [SemanticResourceAttributes.SERVICE_NAME]: config.appName,
-      [SemanticResourceAttributes.SERVICE_VERSION]: config.appVersion,
-      [SemanticResourceAttributes.DEPLOYMENT_ENVIRONMENT]: config.env,
-    }),
-  });
-
-  // @todo выяснить, почему не сходятся типы и приходится оставлять as any
-  provider.addSpanProcessor(new BatchSpanProcessor(exporter) as any);
-
-  provider.register({
-    propagator: new JaegerPropagator(),
-  });
-
-  registerInstrumentations({
-    instrumentations: [new ExpressInstrumentation(), new HttpInstrumentation()],
-  });
-
-  return provider.getTracer(config.appName, config.appVersion);
-}

package/src/tracer/types.ts

@@ -1,3 +0,0 @@
-import type { Tracer } from '@opentelemetry/api';
-
-export type { Tracer };

package/src/utils/browser/analytics/__test__/data-layer.test.ts

@@ -1,50 +0,0 @@
-import { dataLayerPush } from '../data-layer';
-
-describe('dataLayerPush', () => {
-  beforeAll(() => {
-    (window as any).dataLayer = {
-      checkContext: () => 123,
-
-      push: jest.fn(function (this: any, data) {
-        // имитируем реальную работу window.dataLayer.push: в процессе удаляет data.n
-        delete data.n;
-
-        // имитируем реальную работу window.dataLayer.push: в процессе вызывает другие методы с this
-        this.checkContext();
-      }),
-    };
-  });
-
-  afterAll(() => {
-    delete (window as any).dataLayer;
-  });
-
-  it('should handle window.dataLayer.push mutates object argument', () => {
-    const testData = {
-      n: 'test-event',
-      prop1: 1,
-      prop2: 2,
-    };
-
-    expect((window as any).dataLayer.push).toBeCalledTimes(0);
-
-    dataLayerPush(testData);
-
-    expect((window as any).dataLayer.push).toBeCalledTimes(1);
-    expect((window as any).dataLayer.push.mock.calls[0][0]).toEqual({
-      prop1: 1,
-      prop2: 2,
-    });
-    expect(testData).toEqual({
-      n: 'test-event',
-      prop1: 1,
-      prop2: 2,
-    });
-  });
-
-  it('should handle window.dataLayer.push absence', () => {
-    delete (window as any).dataLayer;
-
-    expect(() => dataLayerPush({ n: 'test-123' })).not.toThrow();
-  });
-});

package/src/utils/browser/analytics/__test__/oko.test.tsx

@@ -1,143 +0,0 @@
-import React, { createElement } from 'react';
-import { render } from 'react-dom';
-import { act, Simulate } from 'react-dom/test-utils';
-import { okoPush, useOkoPush } from '../oko';
-
-describe('useOkoPush', () => {
-  const TestComponent = ({ prop }: any) => {
-    const fn = useOkoPush({
-      n: 'test-event',
-      prop,
-    });
-
-    return createElement('div', { 'data-testid': 'test-block', onClick: fn });
-  };
-
-  beforeAll(() => {
-    (window as any).oko = {
-      push: jest.fn(),
-    };
-  });
-
-  afterAll(() => {
-    delete (window as any).oko;
-  });
-
-  it('should call', () => {
-    const container = document.createElement('div');
-
-    document.body.append(container);
-
-    render(<TestComponent prop={123} />, container);
-
-    expect((window as any).oko.push).toHaveBeenCalledTimes(0);
-
-    act(() => {
-      Simulate.click(container.querySelector('[data-testid="test-block"]') as HTMLElement);
-    });
-
-    expect((window as any).oko.push).toHaveBeenCalledTimes(1);
-    expect((window as any).oko.push).toHaveBeenCalledWith({
-      n: 'test-event',
-      prop: 123,
-    });
-  });
-
-  it('should throw error', async () => {
-    const container = document.createElement('div');
-
-    document.body.append(container);
-
-    render(<TestComponent prop={1} />, container);
-
-    const renderWithError = () => {
-      render(<TestComponent prop={2} />, container);
-    };
-
-    expect(renderWithError).toThrow(
-      Error(
-        [
-          'useAnalytics: Данные для аналитики изменились.',
-          'Если необходимо использовать динамические данные, вынесите логику из React-компонента.',
-        ].join('\n'),
-      ),
-    );
-  });
-
-  it('should do not throw for complex object structure', () => {
-    const ComplexTest = () => {
-      const fn = useOkoPush({
-        n: 'custom',
-        category: 'balance_goods',
-        custom_str: ['minus'],
-      });
-
-      return <div data-testid='test-block' onClick={fn} />;
-    };
-
-    const container = document.createElement('div');
-
-    document.body.append(container);
-
-    act(() => {
-      render(<ComplexTest />, container);
-    });
-
-    const secondRender = () => {
-      act(() => {
-        render(<ComplexTest />, container);
-      });
-    };
-
-    expect(secondRender).not.toThrow();
-  });
-});
-
-describe('okoPush', () => {
-  beforeAll(() => {
-    (window as any).oko = {
-      checkContext: () => 123,
-
-      push: jest.fn(function (this: any, data) {
-        // имитируем реальную работу window.oko.push: в процессе удаляет data.n
-        delete data.n;
-
-        // имитируем реальную работу window.oko.push: в процессе вызывает другие методы с this
-        this.checkContext();
-      }),
-    };
-  });
-
-  afterAll(() => {
-    delete (window as any).oko;
-  });
-
-  it('should handle window.oko.push mutates object argument', () => {
-    const testData = {
-      n: 'test-event',
-      prop1: 1,
-      prop2: 2,
-    };
-
-    expect((window as any).oko.push).toBeCalledTimes(0);
-
-    okoPush(testData);
-
-    expect((window as any).oko.push).toBeCalledTimes(1);
-    expect((window as any).oko.push.mock.calls[0][0]).toEqual({
-      prop1: 1,
-      prop2: 2,
-    });
-    expect(testData).toEqual({
-      n: 'test-event',
-      prop1: 1,
-      prop2: 2,
-    });
-  });
-
-  it('should handle window.oko.push absence', () => {
-    delete (window as any).oko;
-
-    expect(() => okoPush({ n: 'test-123' })).not.toThrow();
-  });
-});

package/src/utils/browser/analytics/data-layer.ts

@@ -1,12 +0,0 @@
-import { isFunction } from 'lodash';
-
-/**
- * Отправка аналитики в око.
- * @param eventData Данные события для отправки.
- */
-export const dataLayerPush = (eventData: Record<string, any>) => {
-  const win: any = window;
-
-  // копируем объект так как window.dataLayer.push может менять аргумент в процессе работы
-  isFunction(win.dataLayer?.push) && win.dataLayer.push({ ...eventData });
-};

package/src/utils/browser/analytics/oko.ts

@@ -1,44 +0,0 @@
-import { useRef } from 'react';
-import { isEqual, isFunction } from 'lodash';
-
-export type OkoEvent = Record<string, any>;
-
-/**
- * Отправка аналитики в око.
- * @param eventData Данные события для отправки.
- */
-export const okoPush = (eventData: OkoEvent) => {
-  const win: any = window;
-
-  // копируем объект так как window.oko.push меняет свой аргумент в процессе выполнения
-  isFunction(win.oko?.push) && win.oko.push({ ...eventData });
-};
-
-/**
- * Хук, возвращающий функцию, которая отправит аналитику в ОКО.
- * @param data Данные события для отправки в ОКО.
- * @return Функция.
- */
-export const useOkoPush = (data: OkoEvent) => {
-  const dataRef = useRef<OkoEvent>();
-  const fnRef = useRef<() => void>();
-
-  if (!dataRef.current) {
-    dataRef.current = { ...data };
-  }
-
-  if (!fnRef.current) {
-    fnRef.current = () => okoPush(dataRef.current as OkoEvent);
-  }
-
-  if (!isEqual(data, dataRef.current)) {
-    throw Error(
-      [
-        'useAnalytics: Данные для аналитики изменились.',
-        'Если необходимо использовать динамические данные, вынесите логику из React-компонента.',
-      ].join('\n'),
-    );
-  }
-
-  return fnRef.current;
-};

package/src/utils/browser/storage/index.ts

@@ -1,75 +0,0 @@
-/* eslint-disable require-jsdoc, jsdoc/require-jsdoc */
-
-export interface StorageUtils
-  extends Pick<Storage, 'clear' | 'getItem' | 'key' | 'removeItem' | 'setItem' | 'length'> {
-  isAvailable: () => boolean;
-}
-
-export function createStorageUtils(getStorage: () => Storage): StorageUtils {
-  function isAvailable(): boolean {
-    try {
-      const testKey = `local_storage_test_key::${Date.now()}`;
-
-      getStorage().setItem(testKey, testKey);
-      getStorage().removeItem(testKey);
-
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  function clear(): void {
-    if (isAvailable()) {
-      getStorage().clear();
-    }
-  }
-
-  function getItem(name: string): string | null {
-    if (isAvailable()) {
-      return getStorage().getItem(name);
-    }
-
-    return null;
-  }
-
-  function key(index: number): string | null {
-    if (isAvailable()) {
-      return getStorage().key(index);
-    }
-    return null;
-  }
-
-  function removeItem(name: string): void {
-    if (isAvailable()) {
-      getStorage().removeItem(name);
-    }
-  }
-
-  function setItem(name: string, value: string): void {
-    if (isAvailable()) {
-      getStorage().setItem(name, value);
-    }
-  }
-
-  function length(): number {
-    if (isAvailable()) {
-      return getStorage().length;
-    }
-
-    return 0;
-  }
-
-  return {
-    isAvailable,
-
-    clear,
-    getItem,
-    key,
-    removeItem,
-    setItem,
-    get length() {
-      return length();
-    },
-  };
-}

package/src/utils/number.ts

@@ -1,8 +0,0 @@
-/**
- * Переводит наносекунды в миллисекунды.
- * @param nanoseconds Наносекунды.
- * @return Миллисекунды.
- */
-export function toMilliseconds(nanoseconds: bigint): number {
-  return Number(nanoseconds / 1000000n);
-}