@tramvai/module-http-client 2.70.1 → 2.72.0

package/lib/httpClient/createUserAgent.browser.js

@@ -0,0 +1,16 @@
+const createUserAgent = ({ appInfo, envManager, }) => {
+    const { appName } = appInfo;
+    const appVersion = envManager.get('APP_VERSION');
+    const appRelease = envManager.get('APP_RELEASE');
+    const userAgent = [
+        'tramvai',
+        appName,
+        appVersion && `version ${appVersion}`,
+        appRelease && `release ${appRelease}`,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return userAgent;
+};
+
+export { createUserAgent };

package/lib/httpClient/createUserAgent.es.js

@@ -0,0 +1,16 @@
+const createUserAgent = ({ appInfo, envManager, }) => {
+    const { appName } = appInfo;
+    const appVersion = envManager.get('APP_VERSION');
+    const appRelease = envManager.get('APP_RELEASE');
+    const userAgent = [
+        'tramvai',
+        appName,
+        appVersion && `version ${appVersion}`,
+        appRelease && `release ${appRelease}`,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return userAgent;
+};
+
+export { createUserAgent };

package/lib/httpClient/createUserAgent.js

@@ -0,0 +1,20 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const createUserAgent = ({ appInfo, envManager, }) => {
+    const { appName } = appInfo;
+    const appVersion = envManager.get('APP_VERSION');
+    const appRelease = envManager.get('APP_RELEASE');
+    const userAgent = [
+        'tramvai',
+        appName,
+        appVersion && `version ${appVersion}`,
+        appRelease && `release ${appRelease}`,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return userAgent;
+};
+
+exports.createUserAgent = createUserAgent;

package/lib/httpClient/httpClientFactory.browser.js

@@ -0,0 +1,72 @@
+import isNil from '@tinkoff/utils/is/nil';
+import compose from '@tinkoff/utils/function/compose';
+import { mergeOptions, createTinkoffRequest, HttpClientAdapter } from '@tramvai/tinkoff-request-http-client-adapter';
+import { fillHeaderIp, fillHeaders } from '../utils/fillHeaders.browser.browser.js';
+import { createUserAgent } from './createUserAgent.browser.js';
+
+const environmentDependentOptions = typeof window === 'undefined'
+    ? {
+        defaultTimeout: 2000,
+    }
+    : {
+        defaultTimeout: 30000,
+    };
+const httpClientFactory = ({ logger, envManager, appInfo, requestManager, headersList, createCache, makeRequestRegistry, agent, querySerializer, disableCircuitBreaker = false, defaultOptions, commandLineExecutionContext, }) => {
+    return (options) => {
+        var _a;
+        if (!options.name) {
+            throw Error(`You need to pass a unique field "name" for the HTTP client instance`);
+        }
+        const forceDisableCache = envManager.get('HTTP_CLIENT_CACHE_DISABLED');
+        const forceDisabledCircuitBreaker = envManager.get('HTTP_CLIENT_CIRCUIT_BREAKER_DISABLED');
+        const adapterOptions = mergeOptions(mergeOptions({
+            logger,
+            agent,
+            querySerializer,
+            method: 'GET',
+            createCache: createCache
+                ? (cacheOptions) => createCache('memory', cacheOptions)
+                : undefined,
+            modifyRequest: compose(fillHeaderIp(), fillHeaders()),
+            circuitBreakerOptions: {
+                failureThreshold: 75,
+                minimumFailureCount: 10,
+            },
+            // TODO: remove any after [resolving](https://github.com/southpolesteve/node-abort-controller/issues/31)
+            signal: (_a = commandLineExecutionContext === null || commandLineExecutionContext === void 0 ? void 0 : commandLineExecutionContext()) === null || _a === void 0 ? void 0 : _a.abortSignal,
+            ...environmentDependentOptions,
+        }, defaultOptions !== null && defaultOptions !== void 0 ? defaultOptions : {}), options);
+        // по умолчанию, на сервере, библиотека https://github.com/node-fetch/node-fetch
+        // отправляет заголовок "User-Agent" вида "node-fetch".
+        // для улучшения логов сервисов, в которые делают запросы tramvai приложения,
+        // заменяем "User-Agent" на кастомный, содержащий название и версию приложения
+        if (typeof window === 'undefined') {
+            adapterOptions.headers = {
+                'User-Agent': createUserAgent({ appInfo, envManager }),
+                ...adapterOptions.headers,
+            };
+        }
+        if (!isNil(forceDisableCache)) {
+            adapterOptions.disableCache = !!forceDisableCache;
+        }
+        if (disableCircuitBreaker) {
+            adapterOptions.enableCircuitBreaker = false;
+        }
+        // environment variable in priority over disableCircuitBreaker
+        if (!isNil(forceDisabledCircuitBreaker)) {
+            adapterOptions.enableCircuitBreaker = !forceDisabledCircuitBreaker;
+        }
+        // кэшируем инстанс @tinkoff/request
+        if (!makeRequestRegistry.has(adapterOptions.name)) {
+            makeRequestRegistry.set(adapterOptions.name, createTinkoffRequest(adapterOptions));
+        }
+        const makeRequest = makeRequestRegistry.get(adapterOptions.name);
+        const httpClientAdapter = new HttpClientAdapter({
+            options: adapterOptions,
+            makeRequest,
+        });
+        return httpClientAdapter;
+    };
+};
+
+export { httpClientFactory };

package/lib/httpClient/httpClientFactory.es.js

@@ -0,0 +1,72 @@
+import isNil from '@tinkoff/utils/is/nil';
+import compose from '@tinkoff/utils/function/compose';
+import { mergeOptions, createTinkoffRequest, HttpClientAdapter } from '@tramvai/tinkoff-request-http-client-adapter';
+import { fillHeaderIp, fillHeaders } from '../utils/fillHeaders.es.js';
+import { createUserAgent } from './createUserAgent.es.js';
+
+const environmentDependentOptions = typeof window === 'undefined'
+    ? {
+        defaultTimeout: 2000,
+    }
+    : {
+        defaultTimeout: 30000,
+    };
+const httpClientFactory = ({ logger, envManager, appInfo, requestManager, headersList, createCache, makeRequestRegistry, agent, querySerializer, disableCircuitBreaker = false, defaultOptions, commandLineExecutionContext, }) => {
+    return (options) => {
+        var _a;
+        if (!options.name) {
+            throw Error(`You need to pass a unique field "name" for the HTTP client instance`);
+        }
+        const forceDisableCache = envManager.get('HTTP_CLIENT_CACHE_DISABLED');
+        const forceDisabledCircuitBreaker = envManager.get('HTTP_CLIENT_CIRCUIT_BREAKER_DISABLED');
+        const adapterOptions = mergeOptions(mergeOptions({
+            logger,
+            agent,
+            querySerializer,
+            method: 'GET',
+            createCache: createCache
+                ? (cacheOptions) => createCache('memory', cacheOptions)
+                : undefined,
+            modifyRequest: compose(fillHeaderIp({ requestManager }), fillHeaders({ requestManager, headersList })),
+            circuitBreakerOptions: {
+                failureThreshold: 75,
+                minimumFailureCount: 10,
+            },
+            // TODO: remove any after [resolving](https://github.com/southpolesteve/node-abort-controller/issues/31)
+            signal: (_a = commandLineExecutionContext === null || commandLineExecutionContext === void 0 ? void 0 : commandLineExecutionContext()) === null || _a === void 0 ? void 0 : _a.abortSignal,
+            ...environmentDependentOptions,
+        }, defaultOptions !== null && defaultOptions !== void 0 ? defaultOptions : {}), options);
+        // по умолчанию, на сервере, библиотека https://github.com/node-fetch/node-fetch
+        // отправляет заголовок "User-Agent" вида "node-fetch".
+        // для улучшения логов сервисов, в которые делают запросы tramvai приложения,
+        // заменяем "User-Agent" на кастомный, содержащий название и версию приложения
+        if (typeof window === 'undefined') {
+            adapterOptions.headers = {
+                'User-Agent': createUserAgent({ appInfo, envManager }),
+                ...adapterOptions.headers,
+            };
+        }
+        if (!isNil(forceDisableCache)) {
+            adapterOptions.disableCache = !!forceDisableCache;
+        }
+        if (disableCircuitBreaker) {
+            adapterOptions.enableCircuitBreaker = false;
+        }
+        // environment variable in priority over disableCircuitBreaker
+        if (!isNil(forceDisabledCircuitBreaker)) {
+            adapterOptions.enableCircuitBreaker = !forceDisabledCircuitBreaker;
+        }
+        // кэшируем инстанс @tinkoff/request
+        if (!makeRequestRegistry.has(adapterOptions.name)) {
+            makeRequestRegistry.set(adapterOptions.name, createTinkoffRequest(adapterOptions));
+        }
+        const makeRequest = makeRequestRegistry.get(adapterOptions.name);
+        const httpClientAdapter = new HttpClientAdapter({
+            options: adapterOptions,
+            makeRequest,
+        });
+        return httpClientAdapter;
+    };
+};
+
+export { httpClientFactory };

package/lib/httpClient/httpClientFactory.js

@@ -0,0 +1,81 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var isNil = require('@tinkoff/utils/is/nil');
+var compose = require('@tinkoff/utils/function/compose');
+var tinkoffRequestHttpClientAdapter = require('@tramvai/tinkoff-request-http-client-adapter');
+var fillHeaders = require('../utils/fillHeaders.js');
+var createUserAgent = require('./createUserAgent.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var isNil__default = /*#__PURE__*/_interopDefaultLegacy(isNil);
+var compose__default = /*#__PURE__*/_interopDefaultLegacy(compose);
+
+const environmentDependentOptions = typeof window === 'undefined'
+    ? {
+        defaultTimeout: 2000,
+    }
+    : {
+        defaultTimeout: 30000,
+    };
+const httpClientFactory = ({ logger, envManager, appInfo, requestManager, headersList, createCache, makeRequestRegistry, agent, querySerializer, disableCircuitBreaker = false, defaultOptions, commandLineExecutionContext, }) => {
+    return (options) => {
+        var _a;
+        if (!options.name) {
+            throw Error(`You need to pass a unique field "name" for the HTTP client instance`);
+        }
+        const forceDisableCache = envManager.get('HTTP_CLIENT_CACHE_DISABLED');
+        const forceDisabledCircuitBreaker = envManager.get('HTTP_CLIENT_CIRCUIT_BREAKER_DISABLED');
+        const adapterOptions = tinkoffRequestHttpClientAdapter.mergeOptions(tinkoffRequestHttpClientAdapter.mergeOptions({
+            logger,
+            agent,
+            querySerializer,
+            method: 'GET',
+            createCache: createCache
+                ? (cacheOptions) => createCache('memory', cacheOptions)
+                : undefined,
+            modifyRequest: compose__default["default"](fillHeaders.fillHeaderIp({ requestManager }), fillHeaders.fillHeaders({ requestManager, headersList })),
+            circuitBreakerOptions: {
+                failureThreshold: 75,
+                minimumFailureCount: 10,
+            },
+            // TODO: remove any after [resolving](https://github.com/southpolesteve/node-abort-controller/issues/31)
+            signal: (_a = commandLineExecutionContext === null || commandLineExecutionContext === void 0 ? void 0 : commandLineExecutionContext()) === null || _a === void 0 ? void 0 : _a.abortSignal,
+            ...environmentDependentOptions,
+        }, defaultOptions !== null && defaultOptions !== void 0 ? defaultOptions : {}), options);
+        // по умолчанию, на сервере, библиотека https://github.com/node-fetch/node-fetch
+        // отправляет заголовок "User-Agent" вида "node-fetch".
+        // для улучшения логов сервисов, в которые делают запросы tramvai приложения,
+        // заменяем "User-Agent" на кастомный, содержащий название и версию приложения
+        if (typeof window === 'undefined') {
+            adapterOptions.headers = {
+                'User-Agent': createUserAgent.createUserAgent({ appInfo, envManager }),
+                ...adapterOptions.headers,
+            };
+        }
+        if (!isNil__default["default"](forceDisableCache)) {
+            adapterOptions.disableCache = !!forceDisableCache;
+        }
+        if (disableCircuitBreaker) {
+            adapterOptions.enableCircuitBreaker = false;
+        }
+        // environment variable in priority over disableCircuitBreaker
+        if (!isNil__default["default"](forceDisabledCircuitBreaker)) {
+            adapterOptions.enableCircuitBreaker = !forceDisabledCircuitBreaker;
+        }
+        // кэшируем инстанс @tinkoff/request
+        if (!makeRequestRegistry.has(adapterOptions.name)) {
+            makeRequestRegistry.set(adapterOptions.name, tinkoffRequestHttpClientAdapter.createTinkoffRequest(adapterOptions));
+        }
+        const makeRequest = makeRequestRegistry.get(adapterOptions.name);
+        const httpClientAdapter = new tinkoffRequestHttpClientAdapter.HttpClientAdapter({
+            options: adapterOptions,
+            makeRequest,
+        });
+        return httpClientAdapter;
+    };
+};
+
+exports.httpClientFactory = httpClientFactory;

package/lib/httpClientModule.browser.js

@@ -0,0 +1,109 @@
+import { createToken } from '@tinkoff/dippy';
+import { Module, provide, APP_INFO_TOKEN, Scope } from '@tramvai/core';
+import { HTTP_CLIENT_FACTORY, API_CLIENT_PASS_HEADERS, HTTP_CLIENT_AGENT, DISABLE_CIRCUIT_BREAKER, DEFAULT_HTTP_CLIENT_FACTORY_OPTIONS, HTTP_CLIENT } from '@tramvai/tokens-http-client';
+import { LOGGER_TOKEN, ENV_MANAGER_TOKEN, REQUEST_MANAGER_TOKEN, COMMAND_LINE_EXECUTION_CONTEXT_TOKEN, ENV_USED_TOKEN, CREATE_CACHE_TOKEN } from '@tramvai/tokens-common';
+import { httpClientFactory } from './httpClient/httpClientFactory.browser.js';
+import { PapiClientModule } from './papiClientModule.browser.browser.js';
+
+const createCacheToken = createToken('httpClient createCache');
+const HttpClientModule = /* @__PURE__ */ Module({
+    imports: [PapiClientModule],
+    providers: [
+        provide({
+            provide: HTTP_CLIENT_FACTORY,
+            useFactory: httpClientFactory,
+            deps: {
+                logger: LOGGER_TOKEN,
+                envManager: ENV_MANAGER_TOKEN,
+                appInfo: APP_INFO_TOKEN,
+                createCache: createCacheToken,
+                makeRequestRegistry: 'makeRequestRegistry',
+                requestManager: {
+                    token: REQUEST_MANAGER_TOKEN,
+                    optional: true,
+                },
+                headersList: {
+                    token: API_CLIENT_PASS_HEADERS,
+                    optional: true,
+                },
+                agent: {
+                    token: HTTP_CLIENT_AGENT,
+                    optional: true,
+                },
+                disableCircuitBreaker: {
+                    token: DISABLE_CIRCUIT_BREAKER,
+                    optional: true,
+                },
+                defaultOptions: {
+                    token: DEFAULT_HTTP_CLIENT_FACTORY_OPTIONS,
+                    optional: true,
+                },
+                commandLineExecutionContext: {
+                    token: COMMAND_LINE_EXECUTION_CONTEXT_TOKEN,
+                    optional: true,
+                },
+            },
+        }),
+        provide({
+            provide: HTTP_CLIENT,
+            useFactory: ({ factory }) => {
+                return factory({
+                    name: 'http-client',
+                    disableCache: true,
+                });
+            },
+            deps: {
+                factory: HTTP_CLIENT_FACTORY,
+            },
+        }),
+        provide({
+            provide: ENV_USED_TOKEN,
+            useValue: [
+                { key: 'HTTP_CLIENT_CACHE_DISABLED', optional: true, dehydrate: false },
+                { key: 'HTTP_CLIENT_CIRCUIT_BREAKER_DISABLED', optional: true, dehydrate: false },
+            ],
+        }),
+        /**
+         * хранилище для экземпляров @tinkoff/request
+         *
+         * требуется хранить экземпляры в единственном виде,
+         * т.к. многие плагины @tinkoff/request после инициализации имеют состояние
+         * (cache, circuit breaker), и не будут корректно работать на сервере,
+         * если создавать новые экземпляры на Scope.REQUEST
+         */
+        provide({
+            provide: 'makeRequestRegistry',
+            scope: Scope.SINGLETON,
+            useFactory: () => new Map(),
+        }),
+        /**
+         * `CREATE_CACHE_TOKEN` имеет проверку, если токен используется провайдером,
+         * который имеет Scope.SINGLETON, то инстанс кэша сохраняется в общее хранилище,
+         * и доступен для очистки через `/papi/clear-cache`.
+         * Scope.REQUEST игнорируется, т.к. это верная утечка памяти,
+         * инстансов кэши было бы неограниченное количество.
+         *
+         * HTTP клиенты создаются со Scope.REQUEST, но инстансы @tinkoff/request
+         * (и соответственно кэшей) создаются только один раз, благодаря `makeRequestRegistry`.
+         * это гарантирует отсутствие утечек памяти, поэтому мы обходим проверку
+         * на Scope.SINGLETON c помощью обертки `createCacheToken`
+         */
+        provide({
+            provide: createCacheToken,
+            scope: Scope.SINGLETON,
+            useFactory: ({ createCache }) => {
+                return createCache;
+            },
+            deps: {
+                createCache: CREATE_CACHE_TOKEN,
+            },
+        }),
+        provide({
+            provide: API_CLIENT_PASS_HEADERS,
+            useValue: ['x-request-id'],
+        }),
+    ],
+})(class HttpClientModule {
+});
+
+export { HttpClientModule };

package/lib/httpClientModule.es.js

@@ -0,0 +1,109 @@
+import { createToken } from '@tinkoff/dippy';
+import { Module, provide, APP_INFO_TOKEN, Scope } from '@tramvai/core';
+import { HTTP_CLIENT_FACTORY, API_CLIENT_PASS_HEADERS, HTTP_CLIENT_AGENT, DISABLE_CIRCUIT_BREAKER, DEFAULT_HTTP_CLIENT_FACTORY_OPTIONS, HTTP_CLIENT } from '@tramvai/tokens-http-client';
+import { LOGGER_TOKEN, ENV_MANAGER_TOKEN, REQUEST_MANAGER_TOKEN, COMMAND_LINE_EXECUTION_CONTEXT_TOKEN, ENV_USED_TOKEN, CREATE_CACHE_TOKEN } from '@tramvai/tokens-common';
+import { httpClientFactory } from './httpClient/httpClientFactory.es.js';
+import { PapiClientModule } from './papiClientModule.es.js';
+
+const createCacheToken = createToken('httpClient createCache');
+const HttpClientModule = /* @__PURE__ */ Module({
+    imports: [PapiClientModule],
+    providers: [
+        provide({
+            provide: HTTP_CLIENT_FACTORY,
+            useFactory: httpClientFactory,
+            deps: {
+                logger: LOGGER_TOKEN,
+                envManager: ENV_MANAGER_TOKEN,
+                appInfo: APP_INFO_TOKEN,
+                createCache: createCacheToken,
+                makeRequestRegistry: 'makeRequestRegistry',
+                requestManager: {
+                    token: REQUEST_MANAGER_TOKEN,
+                    optional: true,
+                },
+                headersList: {
+                    token: API_CLIENT_PASS_HEADERS,
+                    optional: true,
+                },
+                agent: {
+                    token: HTTP_CLIENT_AGENT,
+                    optional: true,
+                },
+                disableCircuitBreaker: {
+                    token: DISABLE_CIRCUIT_BREAKER,
+                    optional: true,
+                },
+                defaultOptions: {
+                    token: DEFAULT_HTTP_CLIENT_FACTORY_OPTIONS,
+                    optional: true,
+                },
+                commandLineExecutionContext: {
+                    token: COMMAND_LINE_EXECUTION_CONTEXT_TOKEN,
+                    optional: true,
+                },
+            },
+        }),
+        provide({
+            provide: HTTP_CLIENT,
+            useFactory: ({ factory }) => {
+                return factory({
+                    name: 'http-client',
+                    disableCache: true,
+                });
+            },
+            deps: {
+                factory: HTTP_CLIENT_FACTORY,
+            },
+        }),
+        provide({
+            provide: ENV_USED_TOKEN,
+            useValue: [
+                { key: 'HTTP_CLIENT_CACHE_DISABLED', optional: true, dehydrate: false },
+                { key: 'HTTP_CLIENT_CIRCUIT_BREAKER_DISABLED', optional: true, dehydrate: false },
+            ],
+        }),
+        /**
+         * хранилище для экземпляров @tinkoff/request
+         *
+         * требуется хранить экземпляры в единственном виде,
+         * т.к. многие плагины @tinkoff/request после инициализации имеют состояние
+         * (cache, circuit breaker), и не будут корректно работать на сервере,
+         * если создавать новые экземпляры на Scope.REQUEST
+         */
+        provide({
+            provide: 'makeRequestRegistry',
+            scope: Scope.SINGLETON,
+            useFactory: () => new Map(),
+        }),
+        /**
+         * `CREATE_CACHE_TOKEN` имеет проверку, если токен используется провайдером,
+         * который имеет Scope.SINGLETON, то инстанс кэша сохраняется в общее хранилище,
+         * и доступен для очистки через `/papi/clear-cache`.
+         * Scope.REQUEST игнорируется, т.к. это верная утечка памяти,
+         * инстансов кэши было бы неограниченное количество.
+         *
+         * HTTP клиенты создаются со Scope.REQUEST, но инстансы @tinkoff/request
+         * (и соответственно кэшей) создаются только один раз, благодаря `makeRequestRegistry`.
+         * это гарантирует отсутствие утечек памяти, поэтому мы обходим проверку
+         * на Scope.SINGLETON c помощью обертки `createCacheToken`
+         */
+        provide({
+            provide: createCacheToken,
+            scope: Scope.SINGLETON,
+            useFactory: ({ createCache }) => {
+                return createCache;
+            },
+            deps: {
+                createCache: CREATE_CACHE_TOKEN,
+            },
+        }),
+        provide({
+            provide: API_CLIENT_PASS_HEADERS,
+            useValue: ['x-request-id'],
+        }),
+    ],
+})(class HttpClientModule {
+});
+
+export { HttpClientModule };

package/lib/httpClientModule.js

@@ -0,0 +1,113 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var dippy = require('@tinkoff/dippy');
+var core = require('@tramvai/core');
+var tokensHttpClient = require('@tramvai/tokens-http-client');
+var tokensCommon = require('@tramvai/tokens-common');
+var httpClientFactory = require('./httpClient/httpClientFactory.js');
+var papiClientModule = require('./papiClientModule.js');
+
+const createCacheToken = dippy.createToken('httpClient createCache');
+const HttpClientModule = /* @__PURE__ */ core.Module({
+    imports: [papiClientModule.PapiClientModule],
+    providers: [
+        core.provide({
+            provide: tokensHttpClient.HTTP_CLIENT_FACTORY,
+            useFactory: httpClientFactory.httpClientFactory,
+            deps: {
+                logger: tokensCommon.LOGGER_TOKEN,
+                envManager: tokensCommon.ENV_MANAGER_TOKEN,
+                appInfo: core.APP_INFO_TOKEN,
+                createCache: createCacheToken,
+                makeRequestRegistry: 'makeRequestRegistry',
+                requestManager: {
+                    token: tokensCommon.REQUEST_MANAGER_TOKEN,
+                    optional: true,
+                },
+                headersList: {
+                    token: tokensHttpClient.API_CLIENT_PASS_HEADERS,
+                    optional: true,
+                },
+                agent: {
+                    token: tokensHttpClient.HTTP_CLIENT_AGENT,
+                    optional: true,
+                },
+                disableCircuitBreaker: {
+                    token: tokensHttpClient.DISABLE_CIRCUIT_BREAKER,
+                    optional: true,
+                },
+                defaultOptions: {
+                    token: tokensHttpClient.DEFAULT_HTTP_CLIENT_FACTORY_OPTIONS,
+                    optional: true,
+                },
+                commandLineExecutionContext: {
+                    token: tokensCommon.COMMAND_LINE_EXECUTION_CONTEXT_TOKEN,
+                    optional: true,
+                },
+            },
+        }),
+        core.provide({
+            provide: tokensHttpClient.HTTP_CLIENT,
+            useFactory: ({ factory }) => {
+                return factory({
+                    name: 'http-client',
+                    disableCache: true,
+                });
+            },
+            deps: {
+                factory: tokensHttpClient.HTTP_CLIENT_FACTORY,
+            },
+        }),
+        core.provide({
+            provide: tokensCommon.ENV_USED_TOKEN,
+            useValue: [
+                { key: 'HTTP_CLIENT_CACHE_DISABLED', optional: true, dehydrate: false },
+                { key: 'HTTP_CLIENT_CIRCUIT_BREAKER_DISABLED', optional: true, dehydrate: false },
+            ],
+        }),
+        /**
+         * хранилище для экземпляров @tinkoff/request
+         *
+         * требуется хранить экземпляры в единственном виде,
+         * т.к. многие плагины @tinkoff/request после инициализации имеют состояние
+         * (cache, circuit breaker), и не будут корректно работать на сервере,
+         * если создавать новые экземпляры на Scope.REQUEST
+         */
+        core.provide({
+            provide: 'makeRequestRegistry',
+            scope: core.Scope.SINGLETON,
+            useFactory: () => new Map(),
+        }),
+        /**
+         * `CREATE_CACHE_TOKEN` имеет проверку, если токен используется провайдером,
+         * который имеет Scope.SINGLETON, то инстанс кэша сохраняется в общее хранилище,
+         * и доступен для очистки через `/papi/clear-cache`.
+         * Scope.REQUEST игнорируется, т.к. это верная утечка памяти,
+         * инстансов кэши было бы неограниченное количество.
+         *
+         * HTTP клиенты создаются со Scope.REQUEST, но инстансы @tinkoff/request
+         * (и соответственно кэшей) создаются только один раз, благодаря `makeRequestRegistry`.
+         * это гарантирует отсутствие утечек памяти, поэтому мы обходим проверку
+         * на Scope.SINGLETON c помощью обертки `createCacheToken`
+         */
+        core.provide({
+            provide: createCacheToken,
+            scope: core.Scope.SINGLETON,
+            useFactory: ({ createCache }) => {
+                return createCache;
+            },
+            deps: {
+                createCache: tokensCommon.CREATE_CACHE_TOKEN,
+            },
+        }),
+        core.provide({
+            provide: tokensHttpClient.API_CLIENT_PASS_HEADERS,
+            useValue: ['x-request-id'],
+        }),
+    ],
+})(class HttpClientModule {
+});
+
+exports.HttpClientModule = HttpClientModule;