@rsdk/core 0.14.0

package/dist/metrics/metrics.config.d.ts

@@ -0,0 +1,5 @@
+import { Config } from '../config';
+export declare class MetricsModuleConfig extends Config {
+    isEnabled: boolean;
+    includeDefault: boolean;
+}

package/dist/metrics/metrics.config.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsModuleConfig = void 0;
+const config_1 = require("../config");
+let MetricsModuleConfig = class MetricsModuleConfig extends config_1.Config {
+    isEnabled;
+    includeDefault;
+};
+__decorate([
+    (0, config_1.Property)('METRICS_ENABLED', new config_1.BoolParser(), {
+        defaultValue: true,
+        description: 'Enables or disables metrics all together',
+    }),
+    __metadata("design:type", Boolean)
+], MetricsModuleConfig.prototype, "isEnabled", void 0);
+__decorate([
+    (0, config_1.Property)('METRICS_INCLUDE_DEFAULT', new config_1.BoolParser(), {
+        defaultValue: true,
+        description: 'Indicates that default Node.js metrics should be included',
+    }),
+    __metadata("design:type", Boolean)
+], MetricsModuleConfig.prototype, "includeDefault", void 0);
+MetricsModuleConfig = __decorate([
+    (0, config_1.ConfigSection)({ name: 'Metrics configuration' })
+], MetricsModuleConfig);
+exports.MetricsModuleConfig = MetricsModuleConfig;
+//# sourceMappingURL=metrics.config.js.map

package/dist/metrics/metrics.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.config.js","sourceRoot":"","sources":["../../src/metrics/metrics.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sCAAwE;AAGjE,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,eAAM;IAK7C,SAAS,CAAW;IAMpB,cAAc,CAAW;CAC1B,CAAA;AAXC;IAAC,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,IAAI,mBAAU,EAAE,EAAE;QAC7C,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,0CAA0C;KACxD,CAAC;;sDACkB;AAEpB;IAAC,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,IAAI,mBAAU,EAAE,EAAE;QACrD,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,2DAA2D;KACzE,CAAC;;2DACuB;AAXd,mBAAmB;IAD/B,IAAA,sBAAa,EAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;GACpC,mBAAmB,CAY/B;AAZY,kDAAmB"}

package/dist/metrics/metrics.module.d.ts

@@ -0,0 +1,35 @@
+import type { DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
+import type { Constructor } from '@rsdk/common';
+import { MetricsModuleConfig } from './metrics.config';
+import type { AnyMetric, MetricsModuleOptions } from './types';
+/**
+ * Metrics module exposes metrics interface (depending on transport)
+ * and gives convenient ways to register and inject custom prom-client
+ * metrics.
+ *
+ * @willsoto/nestjs-prometheus was an alternative, but it didn't really
+ * fit
+ */
+export declare class MetricsModule implements OnApplicationBootstrap {
+    private readonly config;
+    private static isBootstrapped;
+    private static metrics;
+    constructor(config: MetricsModuleConfig);
+    /**
+     * Adds metrics controller provided as options
+     *
+     * @returns dynamic module
+     */
+    static forRoot(options: MetricsModuleOptions): DynamicModule;
+    /**
+     * Use this to inject specified metric into target module
+     *
+     * @param other Not empty List of metric classes
+     * @returns dynamic module
+     */
+    static forFeature(first: Constructor<AnyMetric>, ...other: Constructor<AnyMetric>[]): DynamicModule;
+    /**
+     * Configures prom-client
+     */
+    onApplicationBootstrap(): void;
+}

package/dist/metrics/metrics.module.js

@@ -0,0 +1,98 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var MetricsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsModule = void 0;
+const common_1 = require("@nestjs/common");
+const prom_client_1 = __importDefault(require("prom-client"));
+const config_1 = require("../config");
+const metadata_1 = require("./metadata");
+const metrics_config_1 = require("./metrics.config");
+/**
+ * Metrics module exposes metrics interface (depending on transport)
+ * and gives convenient ways to register and inject custom prom-client
+ * metrics.
+ *
+ * @willsoto/nestjs-prometheus was an alternative, but it didn't really
+ * fit
+ */
+let MetricsModule = MetricsModule_1 = class MetricsModule {
+    config;
+    static isBootstrapped = false;
+    static metrics = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Adds metrics controller provided as options
+     *
+     * @returns dynamic module
+     */
+    static forRoot(options) {
+        return {
+            controllers: [...options.controllers],
+            module: MetricsModule_1,
+        };
+    }
+    /**
+     * Use this to inject specified metric into target module
+     *
+     * @param other Not empty List of metric classes
+     * @returns dynamic module
+     */
+    static forFeature(first, ...other) {
+        const providers = [];
+        for (const ctor of [first, ...other]) {
+            const existing = this.metrics.get(ctor);
+            if (existing) {
+                providers.push(existing);
+                continue;
+            }
+            const metadata = metadata_1.MetricsRegistry.getOne(ctor);
+            providers.push({
+                provide: ctor,
+                useValue: new ctor(metadata),
+            });
+        }
+        return {
+            module: MetricsModule_1,
+            exports: providers,
+            providers,
+        };
+    }
+    /**
+     * Configures prom-client
+     */
+    onApplicationBootstrap() {
+        /**
+         * This module initializes many times: forRoot, forFeature
+         * but real prom-client should occur only once.
+         */
+        if (MetricsModule_1.isBootstrapped) {
+            return;
+        }
+        if (this.config.includeDefault) {
+            prom_client_1.default.collectDefaultMetrics();
+        }
+        MetricsModule_1.isBootstrapped = true;
+    }
+};
+MetricsModule = MetricsModule_1 = __decorate([
+    (0, common_1.Module)({
+        imports: [config_1.PlatformConfigModule.forFeature(metrics_config_1.MetricsModuleConfig)],
+    }),
+    __metadata("design:paramtypes", [metrics_config_1.MetricsModuleConfig])
+], MetricsModule);
+exports.MetricsModule = MetricsModule;
+//# sourceMappingURL=metrics.module.js.map

package/dist/metrics/metrics.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.module.js","sourceRoot":"","sources":["../../src/metrics/metrics.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAKA,2CAAwC;AAExC,8DAAiC;AAEjC,sCAAiD;AAEjD,yCAA6C;AAC7C,qDAAuD;AAGvD;;;;;;;GAOG;AAII,IAAM,aAAa,qBAAnB,MAAM,aAAa;IAIK;IAHrB,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC;IAC9B,MAAM,CAAC,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAErE,YAA6B,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;IAAG,CAAC;IAE5D;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,OAA6B;QAC1C,OAAO;YACL,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;YACrC,MAAM,EAAE,eAAa;SACtB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CACf,KAA6B,EAC7B,GAAG,KAA+B;QAElC,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,EAAE;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAExC,IAAI,QAAQ,EAAE;gBACZ,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAEzB,SAAS;aACV;YAED,MAAM,QAAQ,GAAG,0BAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE9C,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC;aAC7B,CAAC,CAAC;SACJ;QAED,OAAO;YACL,MAAM,EAAE,eAAa;YAErB,OAAO,EAAE,SAAS;YAClB,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB;;;WAGG;QACH,IAAI,eAAa,CAAC,cAAc,EAAE;YAChC,OAAO;SACR;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;YAC9B,qBAAM,CAAC,qBAAqB,EAAE,CAAC;SAChC;QAED,eAAa,CAAC,cAAc,GAAG,IAAI,CAAC;IACtC,CAAC;;AAxEU,aAAa;IAHzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,6BAAoB,CAAC,UAAU,CAAC,oCAAmB,CAAC,CAAC;KAChE,CAAC;qCAKqC,oCAAmB;GAJ7C,aAAa,CAyEzB;AAzEY,sCAAa"}

package/dist/metrics/types.d.ts

@@ -0,0 +1,21 @@
+import type { Controller } from '@nestjs/common/interfaces';
+import type { Constructor } from '@rsdk/common';
+import type { CounterConfiguration, GaugeConfiguration, HistogramConfiguration, SummaryConfiguration } from 'prom-client';
+export { Metric as AnyMetric } from 'prom-client';
+export interface MetricsModuleOptions {
+    controllers: Constructor<Controller>[];
+}
+export interface MetricMetadata {
+    name: string;
+    type: 'counter' | 'gauge' | 'histogram' | 'summary';
+    description?: string;
+}
+export type OmitType<T extends MetricMetadata> = Omit<T, 'type'>;
+export type CounterMetadata = CounterConfiguration<string> & MetricMetadata;
+export declare const isCounterMetadata: (x: MetricMetadata) => x is CounterMetadata;
+export type GaugeMetadata = GaugeConfiguration<string> & MetricMetadata;
+export declare const isGaugeMetadata: (x: MetricMetadata) => x is GaugeMetadata;
+export type HistogramMetadata = HistogramConfiguration<string> & MetricMetadata;
+export declare const isHistogramMetadata: (x: MetricMetadata) => x is HistogramMetadata;
+export type SummaryMetadata = SummaryConfiguration<string> & MetricMetadata;
+export declare const isSummaryMetadata: (x: MetricMetadata) => x is SummaryMetadata;

package/dist/metrics/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSummaryMetadata = exports.isHistogramMetadata = exports.isGaugeMetadata = exports.isCounterMetadata = void 0;
+const isCounterMetadata = (x) => x.type === 'counter';
+exports.isCounterMetadata = isCounterMetadata;
+const isGaugeMetadata = (x) => x.type === 'gauge';
+exports.isGaugeMetadata = isGaugeMetadata;
+const isHistogramMetadata = (x) => x.type === 'histogram';
+exports.isHistogramMetadata = isHistogramMetadata;
+const isSummaryMetadata = (x) => x.type === 'summary';
+exports.isSummaryMetadata = isSummaryMetadata;
+//# sourceMappingURL=types.js.map

package/dist/metrics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":";;;AAwBO,MAAM,iBAAiB,GAAG,CAAC,CAAiB,EAAwB,EAAE,CAC3E,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AADV,QAAA,iBAAiB,qBACP;AAGhB,MAAM,eAAe,GAAG,CAAC,CAAiB,EAAsB,EAAE,CACvE,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;AADR,QAAA,eAAe,mBACP;AAGd,MAAM,mBAAmB,GAAG,CACjC,CAAiB,EACO,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;AAFvC,QAAA,mBAAmB,uBAEoB;AAG7C,MAAM,iBAAiB,GAAG,CAAC,CAAiB,EAAwB,EAAE,CAC3E,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AADV,QAAA,iBAAiB,qBACP"}

package/dist/noop.http-adapter.d.ts

@@ -0,0 +1,32 @@
+import { AbstractHttpAdapter } from '@nestjs/core';
+export declare class NoopHttpAdapter<T> extends AbstractHttpAdapter<T> {
+    get(): void;
+    post(): void;
+    put(): void;
+    patch(): void;
+    head(): void;
+    delete(): void;
+    all(): void;
+    use(): void;
+    close(): any;
+    initHttpServer(): any;
+    useStaticAssets(): any;
+    setViewEngine(): any;
+    getRequestHostname(): any;
+    getRequestMethod(): any;
+    getRequestUrl(): any;
+    status(): any;
+    reply(): any;
+    end(): any;
+    render(): any;
+    redirect(): any;
+    setErrorHandler(): any;
+    setNotFoundHandler(): any;
+    isHeadersSent(): any;
+    setHeader(): any;
+    registerParserMiddleware(): any;
+    enableCors(): any;
+    createMiddlewareFactory(): (path: string, callback: Function) => any;
+    getType(): string;
+    applyVersionFilter(): (req: any, res: any, next: () => void) => Function;
+}

package/dist/noop.http-adapter.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopHttpAdapter = void 0;
+/* eslint-disable @typescript-eslint/ban-types */
+const core_1 = require("@nestjs/core");
+const exceptions_1 = require("./exceptions");
+// Just do nothing
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+const noop = () => { };
+class NoopHttpAdapter extends core_1.AbstractHttpAdapter {
+    get() {
+        throw new exceptions_1.NoHttpException();
+    }
+    post() {
+        throw new exceptions_1.NoHttpException();
+    }
+    put() {
+        throw new exceptions_1.NoHttpException();
+    }
+    patch() {
+        throw new exceptions_1.NoHttpException();
+    }
+    head() {
+        throw new exceptions_1.NoHttpException();
+    }
+    delete() {
+        throw new exceptions_1.NoHttpException();
+    }
+    all() {
+        throw new exceptions_1.NoHttpException();
+    }
+    use() {
+        throw new exceptions_1.NoHttpException();
+    }
+    close() {
+        noop();
+    }
+    initHttpServer() {
+        noop();
+    }
+    useStaticAssets() {
+        noop();
+    }
+    setViewEngine() {
+        noop();
+    }
+    getRequestHostname() {
+        noop();
+    }
+    getRequestMethod() {
+        noop();
+    }
+    getRequestUrl() {
+        noop();
+    }
+    status() {
+        noop();
+    }
+    reply() {
+        noop();
+    }
+    end() {
+        noop();
+    }
+    render() {
+        noop();
+    }
+    redirect() {
+        noop();
+    }
+    setErrorHandler() {
+        noop();
+    }
+    setNotFoundHandler() {
+        noop();
+    }
+    isHeadersSent() {
+        noop();
+    }
+    setHeader() {
+        noop();
+    }
+    registerParserMiddleware() {
+        noop();
+    }
+    enableCors() {
+        noop();
+    }
+    createMiddlewareFactory() {
+        return noop;
+    }
+    getType() {
+        return 'noop';
+    }
+    applyVersionFilter() {
+        return () => noop;
+    }
+}
+exports.NoopHttpAdapter = NoopHttpAdapter;
+//# sourceMappingURL=noop.http-adapter.js.map

package/dist/noop.http-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.http-adapter.js","sourceRoot":"","sources":["../src/noop.http-adapter.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,uCAAmD;AAEnD,6CAA+C;AAE/C,kBAAkB;AAClB,gEAAgE;AAChE,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;AAE5B,MAAa,eAAmB,SAAQ,0BAAsB;IACnD,GAAG;QACV,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,IAAI;QACX,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,GAAG;QACV,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,KAAK;QACZ,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,IAAI;QACX,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,MAAM;QACb,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,GAAG;QACV,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAEQ,GAAG;QACV,MAAM,IAAI,4BAAe,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,EAAE,CAAC;IACT,CAAC;IAED,cAAc;QACZ,IAAI,EAAE,CAAC;IACT,CAAC;IAED,eAAe;QACb,IAAI,EAAE,CAAC;IACT,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC;IACT,CAAC;IAED,kBAAkB;QAChB,IAAI,EAAE,CAAC;IACT,CAAC;IAED,gBAAgB;QACd,IAAI,EAAE,CAAC;IACT,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC;IACT,CAAC;IAED,MAAM;QACJ,IAAI,EAAE,CAAC;IACT,CAAC;IAED,KAAK;QACH,IAAI,EAAE,CAAC;IACT,CAAC;IAED,GAAG;QACD,IAAI,EAAE,CAAC;IACT,CAAC;IAED,MAAM;QACJ,IAAI,EAAE,CAAC;IACT,CAAC;IAED,QAAQ;QACN,IAAI,EAAE,CAAC;IACT,CAAC;IAED,eAAe;QACb,IAAI,EAAE,CAAC;IACT,CAAC;IAED,kBAAkB;QAChB,IAAI,EAAE,CAAC;IACT,CAAC;IAED,aAAa;QACX,IAAI,EAAE,CAAC;IACT,CAAC;IAED,SAAS;QACP,IAAI,EAAE,CAAC;IACT,CAAC;IAED,wBAAwB;QACtB,IAAI,EAAE,CAAC;IACT,CAAC;IAED,UAAU;QACR,IAAI,EAAE,CAAC;IACT,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kBAAkB;QAChB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;IACpB,CAAC;CACF;AApHD,0CAoHC"}

package/dist/platform.context.d.ts

@@ -0,0 +1,55 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { INestApplication } from '@nestjs/common/interfaces';
+import type { NestApplicationOptions } from '@nestjs/common/interfaces/nest-application-options.interface';
+import type { AbstractHttpAdapter } from '@nestjs/core';
+import type { PlatformAppMetadata, PlatformOptions } from './types';
+/**
+ * Агрегат для хранения опций приложения, а также методы для конфигурации и запуска приложения
+ */
+export declare class PlatformContext {
+    readonly options: PlatformOptions;
+    readonly logger: import("@rsdk/logging").ILogger;
+    readonly root: DynamicModule;
+    private microservices;
+    private readonly httpTransport;
+    private readonly httpAdapter;
+    private readonly extendedOptions;
+    /**
+     * Создаёт контекст проводя базовые проверки
+     * - все транспорты совместимы между собой
+     * - подключенные плагины могут работать с таким набором транспортов
+     *
+     * А также инициализирует конфигурацию согласно требованиям платформы
+     * @param options
+     */
+    constructor(options: PlatformOptions);
+    private static assertPluginCompatability;
+    private static assertTransportCompatability;
+    /**
+     * Get all important information about PlatformApp instance
+     * @returns Readonly metadata
+     */
+    getMetadata(): Readonly<PlatformAppMetadata>;
+    /**
+     * Сделано прежде всего для совместимости с тестами.
+     * Производит все необходимые проверки и инициализации транспортов, не запускает приложение
+     */
+    configureApp(app: INestApplication): Promise<void>;
+    /**
+     * Сделано прежде всего для совместимости с тестами
+     * @param app просто запускает приложение (не применяет никакую конфигурацию)
+     */
+    runConfiguredApplication(app: INestApplication): Promise<void>;
+    /**
+     * Возвращает аргументы для `createNestApplication`.
+     * Немедленно возникает вопрос, а почему бы не просто `createNestApplication`
+     * Ответ: Потому что как минимум в тестах приложение создаётся хитрым способом не поддающемуся логике с точки зрения последовательности решений
+     *
+     * testingModuleRef.createApplication(...context.getNestFactoryCreateOptions())
+     * NestFactory.create(context.root, ...context.getNestFactoryCreateOptions())
+     */
+    getNestFactoryCreateOptions(): [
+        httpAdapter: AbstractHttpAdapter,
+        options?: NestApplicationOptions
+    ];
+}

package/dist/platform.context.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformContext = void 0;
+const logging_1 = require("@rsdk/logging");
+const lodash_1 = require("lodash");
+const manifest_1 = require("./manifest/manifest");
+const config_1 = require("./config");
+const exceptions_1 = require("./exceptions");
+const logging_2 = require("./logging");
+const noop_http_adapter_1 = require("./noop.http-adapter");
+const platform_module_1 = require("./platform.module");
+const types_1 = require("./types");
+/**
+ * Агрегат для хранения опций приложения, а также методы для конфигурации и запуска приложения
+ */
+class PlatformContext {
+    options;
+    logger = logging_1.LoggerFactory.create('App');
+    root;
+    microservices;
+    httpTransport;
+    httpAdapter;
+    extendedOptions;
+    /**
+     * Создаёт контекст проводя базовые проверки
+     * - все транспорты совместимы между собой
+     * - подключенные плагины могут работать с таким набором транспортов
+     *
+     * А также инициализирует конфигурацию согласно требованиям платформы
+     * @param options
+     */
+    constructor(options) {
+        this.options = options;
+        PlatformContext.assertTransportCompatability(options);
+        PlatformContext.assertPluginCompatability(options);
+        const { name, description, version } = manifest_1.Manifest.getData(options.manifestPath);
+        const extendedOptions = {
+            description,
+            name,
+            version,
+            ...options,
+        };
+        this.extendedOptions = extendedOptions;
+        config_1.PlatformConfigModule.bootstrap({
+            ...(extendedOptions.config ?? {}),
+            appName: extendedOptions.name,
+        });
+        this.httpTransport = options.transports?.find?.(types_1.isHttpTransport);
+        this.httpAdapter =
+            this.httpTransport?.getAdapter() ?? new noop_http_adapter_1.NoopHttpAdapter();
+        this.root = platform_module_1.PlatformModule.forRoot(this.extendedOptions);
+    }
+    static assertPluginCompatability(options) {
+        if (!options.plugins) {
+            return;
+        }
+        const protocols = (options.transports ?? []).map((x) => x.getProtocol());
+        for (const plugin of options.plugins) {
+            if (!(0, types_1.hasSpecifiedTransports)(plugin)) {
+                continue;
+            }
+            if ((0, lodash_1.intersection)(plugin.forTransports(), protocols).length === 0) {
+                throw new exceptions_1.NoMatchingTransportException(plugin);
+            }
+        }
+    }
+    static assertTransportCompatability(options) {
+        const grouped = (0, lodash_1.groupBy)(options.transports, (x) => x.getProtocol());
+        for (const [protocol, implementations] of Object.entries(grouped)) {
+            if (implementations.length > 1) {
+                throw new exceptions_1.DuplicateProtocolException(protocol, implementations.length);
+            }
+        }
+    }
+    /**
+     * Get all important information about PlatformApp instance
+     * @returns Readonly metadata
+     */
+    getMetadata() {
+        const confMetadata = config_1.ConfigMetadataRegistry.getMetadata();
+        const options = this.extendedOptions;
+        const protocols = (options?.transports ?? []).map((x) => x.getProtocol());
+        return {
+            name: options.name,
+            description: options.description,
+            protocols: protocols,
+            config: {
+                prefix: options.name,
+                sections: [...confMetadata.sections.values()].map(types_1.transformSectionMetadata),
+                sources: [...confMetadata.sources.values()],
+                properties: [...confMetadata.properties.values()].map(types_1.serializePropertyMetadata),
+            },
+        };
+    }
+    /**
+     * Сделано прежде всего для совместимости с тестами.
+     * Производит все необходимые проверки и инициализации транспортов, не запускает приложение
+     */
+    async configureApp(app) {
+        const awaiter = this.httpTransport?.configure(app);
+        if (awaiter instanceof Promise) {
+            await awaiter;
+        }
+        app.enableShutdownHooks();
+        this.microservices = new Map();
+        const transports = this.options.transports ?? [];
+        for (const transport of transports.filter(types_1.isMicroserviceTransport)) {
+            transport.init();
+            const options = transport.createMicroserviceOptions();
+            const microservice = app.connectMicroservice(options, {
+                inheritAppConfig: true,
+            });
+            this.microservices.set(microservice, transport);
+        }
+    }
+    /**
+     * Сделано прежде всего для совместимости с тестами
+     * @param app просто запускает приложение (не применяет никакую конфигурацию)
+     */
+    async runConfiguredApplication(app) {
+        try {
+            this.logger.info('Mapping controllers...');
+            if (this.httpTransport) {
+                const { host, port } = this.httpTransport.createHttpOptions();
+                await app.listen(port, host, () => this.logger.info(`Http server started on ${host}:${port}`));
+            }
+            else {
+                await app.init();
+            }
+            if (this.microservices.size > 0) {
+                for (const [microservice, transport] of this.microservices) {
+                    await microservice.listen();
+                    transport.onStart();
+                }
+            }
+        }
+        catch (err) {
+            this.logger.fatal(err);
+            process.exit(1);
+        }
+    }
+    /**
+     * Возвращает аргументы для `createNestApplication`.
+     * Немедленно возникает вопрос, а почему бы не просто `createNestApplication`
+     * Ответ: Потому что как минимум в тестах приложение создаётся хитрым способом не поддающемуся логике с точки зрения последовательности решений
+     *
+     * testingModuleRef.createApplication(...context.getNestFactoryCreateOptions())
+     * NestFactory.create(context.root, ...context.getNestFactoryCreateOptions())
+     */
+    getNestFactoryCreateOptions() {
+        return [
+            this.httpAdapter,
+            {
+                // Leave body parser configuration to httpTransport implementation
+                bodyParser: false,
+                logger: new logging_2.NestLoggerAdapter(this.logger),
+            },
+        ];
+    }
+}
+exports.PlatformContext = PlatformContext;
+//# sourceMappingURL=platform.context.js.map

package/dist/platform.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.context.js","sourceRoot":"","sources":["../src/platform.context.ts"],"names":[],"mappings":"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"}

package/dist/platform.module.d.ts

@@ -0,0 +1,8 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { MiddlewareConsumer, NestModule } from '@nestjs/common/interfaces';
+import type { PlatformExtendedOptions } from './types';
+export declare class PlatformModule implements NestModule {
+    private static options;
+    static forRoot(options: PlatformExtendedOptions): DynamicModule;
+    configure(consumer: MiddlewareConsumer): void;
+}

package/dist/platform.module.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var PlatformModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformModule = void 0;
+const common_1 = require("@nestjs/common");
+const plugin_module_1 = require("./plugin/plugin.module");
+const transport_module_1 = require("./transport/transport.module");
+const app_metadata_1 = require("./app-metadata");
+const config_1 = require("./config");
+const exceptions_1 = require("./exceptions");
+const logging_1 = require("./logging");
+const tracing_1 = require("./tracing");
+let PlatformModule = PlatformModule_1 = class PlatformModule {
+    static options;
+    static forRoot(options) {
+        if (this.options) {
+            throw new exceptions_1.SequenceException("Can't call PlatformModule.setup() method twice");
+        }
+        this.options = options;
+        const imports = [
+            // Plugins
+            plugin_module_1.PlatformPluginModule.forOptions(options),
+            // Infrastructure
+            app_metadata_1.AppMetadataModule.forRoot(options),
+            logging_1.LoggingModule.forRoot(),
+            config_1.PlatformConfigModule.forRoot(options),
+            tracing_1.TracingModule.forRoot({ appName: options.name, processing: 'simple' }),
+        ];
+        // Adding transport module if needed
+        if (options.transports) {
+            imports.push(transport_module_1.PlatformTransportModule.forOptions(options));
+        }
+        // Adding application level modules
+        if (options.modules) {
+            imports.push(...options.modules);
+        }
+        return {
+            module: PlatformModule_1,
+            imports,
+        };
+    }
+    configure(consumer) {
+        if (!PlatformModule_1.options) {
+            throw new exceptions_1.SequenceException('Should call PlatformModule.setup() before configuring middleware!');
+        }
+        for (const plugin of PlatformModule_1.options.plugins || []) {
+            plugin?.configureMiddleware?.(consumer);
+        }
+    }
+};
+PlatformModule = PlatformModule_1 = __decorate([
+    (0, common_1.Module)({})
+], PlatformModule);
+exports.PlatformModule = PlatformModule;
+//# sourceMappingURL=platform.module.js.map