@rsdk/core 0.14.0

package/.eslintignore

@@ -0,0 +1,4 @@
+libs/contract
+**/*.d.ts
+**/*.js
+**/generated

package/.eslintrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+    root: true,
+    extends: ["rsdk"],
+};

package/.prettierignore

@@ -0,0 +1 @@
+**/*.spec.ts

package/.prettierrc.json

@@ -0,0 +1 @@
+"@rsdk/prettier-config"

package/dist/app/platform.app.d.ts

@@ -0,0 +1,28 @@
+import type { PlatformAppMetadata, PlatformAppOptions } from '../types';
+/**
+ * Platform application itself.
+ *
+ * Just instantiate it, call run() method, and you are
+ * ready to go!
+ */
+export declare class PlatformApp {
+    readonly platformAppOptions: PlatformAppOptions;
+    private readonly context;
+    constructor(platformAppOptions: PlatformAppOptions);
+    /**
+     * Get all important information about PlatformApp instance
+     * @returns Readonly metadata
+     */
+    getMetadata(): Readonly<PlatformAppMetadata>;
+    /**
+     * Runs application.
+     * @returns Promise<void>
+     */
+    run(): Promise<void>;
+    /**
+     * Создание и конфигурирование приложения по стандартному сценарию
+     * Не путать с запуском
+     * @private
+     */
+    private createApplication;
+}

package/dist/app/platform.app.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformApp = void 0;
+const core_1 = require("@nestjs/core");
+const platform_context_1 = require("../platform.context");
+/**
+ * Platform application itself.
+ *
+ * Just instantiate it, call run() method, and you are
+ * ready to go!
+ */
+class PlatformApp {
+    platformAppOptions;
+    context;
+    constructor(platformAppOptions) {
+        this.platformAppOptions = platformAppOptions;
+        this.context = new platform_context_1.PlatformContext(platformAppOptions);
+    }
+    /**
+     * Get all important information about PlatformApp instance
+     * @returns Readonly metadata
+     */
+    getMetadata() {
+        return this.context.getMetadata();
+    }
+    /**
+     * Runs application.
+     * @returns Promise<void>
+     */
+    async run() {
+        const context = this.context;
+        const app = await this.createApplication();
+        await context.runConfiguredApplication(app);
+    }
+    /**
+     * Создание и конфигурирование приложения по стандартному сценарию
+     * Не путать с запуском
+     * @private
+     */
+    async createApplication() {
+        const context = this.context;
+        const nestContext = context.getNestFactoryCreateOptions();
+        const app = await core_1.NestFactory.create(context.root, ...nestContext);
+        await context.configureApp(app);
+        return app;
+    }
+}
+exports.PlatformApp = PlatformApp;
+//# sourceMappingURL=platform.app.js.map

package/dist/app/platform.app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.app.js","sourceRoot":"","sources":["../../src/app/platform.app.ts"],"names":[],"mappings":";;;AACA,uCAA2C;AAE3C,0DAAsD;AAGtD;;;;;GAKG;AACH,MAAa,WAAW;IAGD;IAFJ,OAAO,CAAkB;IAE1C,YAAqB,kBAAsC;QAAtC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACzD,IAAI,CAAC,OAAO,GAAG,IAAI,kCAAe,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE3C,MAAM,OAAO,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,WAAW,CAAC,CAAC;QAEnE,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAvCD,kCAuCC"}

package/dist/app-metadata/app-metadata.const.d.ts

@@ -0,0 +1,3 @@
+export declare const APP_NAME: unique symbol;
+export declare const APP_DESCRIPTION: unique symbol;
+export declare const APP_VERSION: unique symbol;

package/dist/app-metadata/app-metadata.const.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_VERSION = exports.APP_DESCRIPTION = exports.APP_NAME = void 0;
+exports.APP_NAME = Symbol('APP_NAME_TOKEN');
+exports.APP_DESCRIPTION = Symbol('APP_DESCRIPTION_TOKEN');
+exports.APP_VERSION = Symbol('APP_VERSION_TOKEN');
+//# sourceMappingURL=app-metadata.const.js.map

package/dist/app-metadata/app-metadata.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-metadata.const.js","sourceRoot":"","sources":["../../src/app-metadata/app-metadata.const.ts"],"names":[],"mappings":";;;AAAa,QAAA,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACpC,QAAA,eAAe,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAClD,QAAA,WAAW,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/app-metadata/app-metadata.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { PlatformExtendedOptions } from '../types';
+export declare class AppMetadataModule {
+    static forRoot(options: PlatformExtendedOptions): DynamicModule;
+}

package/dist/app-metadata/app-metadata.module.js

@@ -0,0 +1,41 @@
+"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 AppMetadataModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppMetadataModule = void 0;
+const common_1 = require("@nestjs/common");
+const app_metadata_const_1 = require("./app-metadata.const");
+let AppMetadataModule = AppMetadataModule_1 = class AppMetadataModule {
+    static forRoot(options) {
+        const providers = [
+            {
+                provide: app_metadata_const_1.APP_NAME,
+                useValue: options.name,
+            },
+            {
+                provide: app_metadata_const_1.APP_DESCRIPTION,
+                useValue: options.description,
+            },
+            {
+                provide: app_metadata_const_1.APP_VERSION,
+                useValue: options.version,
+            },
+        ];
+        return {
+            global: true,
+            module: AppMetadataModule_1,
+            providers,
+            exports: providers,
+        };
+    }
+};
+AppMetadataModule = AppMetadataModule_1 = __decorate([
+    (0, common_1.Module)({})
+], AppMetadataModule);
+exports.AppMetadataModule = AppMetadataModule;
+//# sourceMappingURL=app-metadata.module.js.map

package/dist/app-metadata/app-metadata.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-metadata.module.js","sourceRoot":"","sources":["../../src/app-metadata/app-metadata.module.ts"],"names":[],"mappings":";;;;;;;;;;AACA,2CAAwC;AAIxC,6DAA8E;AAGvE,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,OAAgC;QAC7C,MAAM,SAAS,GAAe;YAC5B;gBACE,OAAO,EAAE,6BAAQ;gBACjB,QAAQ,EAAE,OAAO,CAAC,IAAI;aACvB;YACD;gBACE,OAAO,EAAE,oCAAe;gBACxB,QAAQ,EAAE,OAAO,CAAC,WAAW;aAC9B;YACD;gBACE,OAAO,EAAE,gCAAW;gBACpB,QAAQ,EAAE,OAAO,CAAC,OAAO;aAC1B;SACF,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,mBAAiB;YACzB,SAAS;YAET,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;CACF,CAAA;AAzBY,iBAAiB;IAD7B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAyB7B;AAzBY,8CAAiB"}

package/dist/app-metadata/app-name.const.d.ts

@@ -0,0 +1 @@
+export declare const APP_NAME_PATTERN: RegExp;

package/dist/app-metadata/app-name.const.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_NAME_PATTERN = void 0;
+exports.APP_NAME_PATTERN = /^[a-z][a-z-]*\.[a-z-.]*[a-z]$/;
+//# sourceMappingURL=app-name.const.js.map

package/dist/app-metadata/app-name.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-name.const.js","sourceRoot":"","sources":["../../src/app-metadata/app-name.const.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG,+BAA+B,CAAC"}

package/dist/app-metadata/app-name.validator.d.ts

@@ -0,0 +1,2 @@
+export declare const isValidAppName: (name: string) => boolean;
+export declare const assertAppName: (name: string) => void;

package/dist/app-metadata/app-name.validator.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertAppName = exports.isValidAppName = void 0;
+const app_name_const_1 = require("./app-name.const");
+const exceptions_1 = require("./exceptions");
+const isValidAppName = (name) => app_name_const_1.APP_NAME_PATTERN.test(name);
+exports.isValidAppName = isValidAppName;
+const assertAppName = (name) => {
+    if (!(0, exports.isValidAppName)(name)) {
+        throw new exceptions_1.InvalidAppNameException(name);
+    }
+};
+exports.assertAppName = assertAppName;
+//# sourceMappingURL=app-name.validator.js.map

package/dist/app-metadata/app-name.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-name.validator.js","sourceRoot":"","sources":["../../src/app-metadata/app-name.validator.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AACpD,6CAAuD;AAEhD,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE,CACtD,iCAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AADjB,QAAA,cAAc,kBACG;AAEvB,MAAM,aAAa,GAAG,CAAC,IAAY,EAAQ,EAAE;IAClD,IAAI,CAAC,IAAA,sBAAc,EAAC,IAAI,CAAC,EAAE;QACzB,MAAM,IAAI,oCAAuB,CAAC,IAAI,CAAC,CAAC;KACzC;AACH,CAAC,CAAC;AAJW,QAAA,aAAa,iBAIxB"}

package/dist/app-metadata/decorators/app-name.decorator.d.ts

@@ -0,0 +1 @@
+export declare const AppName: () => ParameterDecorator;

package/dist/app-metadata/decorators/app-name.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppName = void 0;
+const common_1 = require("@nestjs/common");
+const app_metadata_const_1 = require("../app-metadata.const");
+const AppName = () => (0, common_1.Inject)(app_metadata_const_1.APP_NAME);
+exports.AppName = AppName;
+//# sourceMappingURL=app-name.decorator.js.map

package/dist/app-metadata/decorators/app-name.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-name.decorator.js","sourceRoot":"","sources":["../../../src/app-metadata/decorators/app-name.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,8DAAiD;AAE1C,MAAM,OAAO,GAAG,GAAuB,EAAE,CAAC,IAAA,eAAM,EAAC,6BAAQ,CAAC,CAAC;AAArD,QAAA,OAAO,WAA8C"}

package/dist/app-metadata/decorators/index.d.ts

@@ -0,0 +1 @@
+export * from './app-name.decorator';

package/dist/app-metadata/decorators/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./app-name.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/app-metadata/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app-metadata/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC"}

package/dist/app-metadata/exceptions/app-name-validation.exception.d.ts

@@ -0,0 +1,4 @@
+import { BootstrapException } from '../../exceptions';
+export declare class InvalidAppNameException extends BootstrapException {
+    constructor(name: string);
+}

package/dist/app-metadata/exceptions/app-name-validation.exception.js

@@ -0,0 +1,38 @@
+"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.InvalidAppNameException = void 0;
+const common_1 = require("@rsdk/common");
+const exceptions_1 = require("../../exceptions");
+const app_name_const_1 = require("../app-name.const");
+let InvalidAppNameException = class InvalidAppNameException extends exceptions_1.BootstrapException {
+    constructor(name) {
+        super((0, common_1.text) `
+      Application name <${name}> is invalid! It should match regexp
+      ${app_name_const_1.APP_NAME_PATTERN} which means that it
+      should include 2 or more parts separated with ".".
+      Last one is considered name, others are namespaces.
+      In each part only "a-z" and "-" are allowed!
+      Please fix it in your package.json file.
+    `);
+    }
+};
+InvalidAppNameException = __decorate([
+    (0, exceptions_1.Exception)({
+        description: (0, common_1.text) `
+    Application name (in package.json) doesn't follow naming
+    conventions.
+  `,
+    }),
+    __metadata("design:paramtypes", [String])
+], InvalidAppNameException);
+exports.InvalidAppNameException = InvalidAppNameException;
+//# sourceMappingURL=app-name-validation.exception.js.map

package/dist/app-metadata/exceptions/app-name-validation.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-name-validation.exception.js","sourceRoot":"","sources":["../../../src/app-metadata/exceptions/app-name-validation.exception.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAoC;AAEpC,iDAAiE;AACjE,sDAAqD;AAQ9C,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,+BAAkB;IAC7D,YAAY,IAAY;QACtB,KAAK,CAAC,IAAA,aAAI,EAAA;0BACY,IAAI;QACtB,iCAAgB;;;;;KAKnB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAXY,uBAAuB;IANnC,IAAA,sBAAS,EAAC;QACT,WAAW,EAAE,IAAA,aAAI,EAAA;;;GAGhB;KACF,CAAC;;GACW,uBAAuB,CAWnC;AAXY,0DAAuB"}

package/dist/app-metadata/exceptions/index.d.ts

@@ -0,0 +1 @@
+export * from './app-name-validation.exception';

package/dist/app-metadata/exceptions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./app-name-validation.exception"), exports);
+//# sourceMappingURL=index.js.map

package/dist/app-metadata/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app-metadata/exceptions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD"}

package/dist/app-metadata/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app-metadata.module';
+export * from './app-name.validator';

package/dist/app-metadata/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./app-metadata.module"), exports);
+__exportStar(require("./app-name.validator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/app-metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app-metadata/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,uDAAqC"}

package/dist/config/additional-source/additional-source.initializer.d.ts

@@ -0,0 +1,38 @@
+import type { AdditionalSourceOptions } from './additional-source.module';
+/**
+ * Содержит логику инициализации дополнительных источников конфигурации
+ */
+export declare class AdditionalSourceInitializer {
+    private options;
+    /**
+     * Промис, состояние которого отражает состояние инициализации дополнительных источников конфигурации
+     * @private
+     */
+    private initializePromise;
+    constructor(options: AdditionalSourceOptions);
+    /**
+     * Инициализирует дополнительные источники конфигурации
+     * ATTENTION: Можно вызывать сколько угодно раз, однако результат будет идентичным в буквальном смысле,
+     *
+     * AdditionalSourceModuleInitializer.initialize() === AdditionalSourceModuleInitializer.initialize() // true
+     *
+     * Это сделано намеренно из-за того как nestjs работает с разрешением зависимостей, а именно `Promise.all`.
+     * Соответственно провайдеров конфигурации может быть много и всем им необходимо инициализировать
+     * источники, проверка на `isInitialized` очевидно создаёт неразрешимые проблемы из-за асинхронности.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initializing additional configuration sources.
+     * Loading values and merging them into the storage.
+     * NOTE: standalone properties from env can be used to
+     * configure additional sources
+     */
+    private initializeAdditionalSources;
+    /**
+     * Returns the arguments for creating the `ConfigSource` instance
+     * @param options
+     * @param ctor
+     * @private
+     */
+    private getConfigSourceArguments;
+}

package/dist/config/additional-source/additional-source.initializer.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdditionalSourceInitializer = void 0;
+const constants_1 = require("@nestjs/common/constants");
+const app_metadata_const_1 = require("../../app-metadata/app-metadata.const");
+const exceptions_1 = require("../../exceptions");
+const exceptions_2 = require("../exceptions");
+const metadata_1 = require("../metadata");
+const sources_1 = require("../sources");
+/**
+ * Содержит логику инициализации дополнительных источников конфигурации
+ */
+class AdditionalSourceInitializer {
+    options;
+    /**
+     * Промис, состояние которого отражает состояние инициализации дополнительных источников конфигурации
+     * @private
+     */
+    initializePromise;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Инициализирует дополнительные источники конфигурации
+     * ATTENTION: Можно вызывать сколько угодно раз, однако результат будет идентичным в буквальном смысле,
+     *
+     * AdditionalSourceModuleInitializer.initialize() === AdditionalSourceModuleInitializer.initialize() // true
+     *
+     * Это сделано намеренно из-за того как nestjs работает с разрешением зависимостей, а именно `Promise.all`.
+     * Соответственно провайдеров конфигурации может быть много и всем им необходимо инициализировать
+     * источники, проверка на `isInitialized` очевидно создаёт неразрешимые проблемы из-за асинхронности.
+     */
+    async initialize() {
+        if (this.initializePromise) {
+            return this.initializePromise;
+        }
+        this.initializePromise = this.initializeAdditionalSources(this.options);
+        return this.initializePromise;
+    }
+    /**
+     * Initializing additional configuration sources.
+     * Loading values and merging them into the storage.
+     * NOTE: standalone properties from env can be used to
+     * configure additional sources
+     */
+    async initializeAdditionalSources(options) {
+        if (!options.sources || options.sources.length === 0) {
+            options.logger.info('No additional sources configured');
+            return;
+        }
+        const { sources, events, logger, vars } = options;
+        logger.info('Initializing additional configuration sources');
+        for (const ctor of sources) {
+            // We should restore the order to initialize for our ctor init later
+            const args = this.getConfigSourceArguments(options, ctor);
+            const source = new ctor(...args);
+            logger.info('Loading configuration from source', {
+                source: source.name,
+            });
+            const loaded = await source.load();
+            /**
+             * Loading and merging data into storage
+             */
+            const { updatedKeys } = vars.merge(loaded);
+            if (updatedKeys.length > 0) {
+                logger.warn(`${updatedKeys.length} values overwritten`, {
+                    keys: updatedKeys,
+                    source: source.name,
+                });
+            }
+            /**
+             * In case the source is reloadable we subscribe to it's
+             * 'reload' event
+             */
+            if ((0, sources_1.isReloadable)(source)) {
+                logger.info('Setting up configuration reload', {
+                    source: source.name,
+                });
+                source.init();
+            }
+        }
+        events.on('reload', (source, newValues) => {
+            const { createdKeys, updatedKeys } = vars.merge(newValues);
+            if (createdKeys.length > 0 || updatedKeys.length > 0) {
+                events.emit('merge', source, {
+                    createdKeys,
+                    updatedKeys,
+                });
+            }
+        });
+        logger.info('Additional sources initialized successfully');
+    }
+    /**
+     * Returns the arguments for creating the `ConfigSource` instance
+     * @param options
+     * @param ctor
+     * @private
+     */
+    getConfigSourceArguments(options, ctor) {
+        // Injectable config properties!
+        const metadata = Reflect.getMetadata(constants_1.SELF_DECLARED_DEPS_METADATA, ctor);
+        // No metadata - no args
+        if (!metadata) {
+            return [];
+        }
+        const sortedMetadata = [...metadata].sort((a, b) => a.index - b.index);
+        const { prefix, propertyMetadata, vars } = options;
+        const injectables = new Map().set(app_metadata_const_1.APP_NAME, prefix);
+        const args = sortedMetadata.map((x) => {
+            if (injectables.has(x.param)) {
+                return injectables.get(x.param);
+            }
+            if (!(0, metadata_1.isPropertyToken)(x.param)) {
+                throw new sources_1.ConfigSourceDIException(ctor, x.param);
+            }
+            const propMeta = propertyMetadata.get(x.param);
+            if (!propMeta) {
+                throw new exceptions_2.ConfigPropertyMetadataNotFound(x.param);
+            }
+            const property = vars.extract(propMeta);
+            if (!property) {
+                throw new exceptions_1.NoInitException('Config property', x.param, 'You probably should add @DeclareProperty decorator to source class.');
+            }
+            return property;
+        });
+        return args;
+    }
+}
+exports.AdditionalSourceInitializer = AdditionalSourceInitializer;
+//# sourceMappingURL=additional-source.initializer.js.map

package/dist/config/additional-source/additional-source.initializer.js.map

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

package/dist/config/additional-source/additional-source.module.d.ts

@@ -0,0 +1,24 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { Constructor } from '@rsdk/common';
+import type { ILogger } from '@rsdk/logging';
+import type { PropertyToken } from '../metadata';
+import type { ReloadEvents } from '../reload';
+import type { ConfigSource } from '../sources';
+import type { PropertyMetadata } from '../types';
+import type { Vars } from '../vars.class';
+/**
+ * Модуль реализующий работу с `AdditionalSource` указанными в конфиге.
+ * Инициализирует все `source` в хуке `onModuleInit`
+ */
+export declare class AdditionalSourceModule {
+    static forRoot(options: AdditionalSourceOptions): DynamicModule;
+}
+export interface AdditionalSourceOptions {
+    sources: Constructor<ConfigSource>[] | undefined;
+    logger: ILogger;
+    properties: Map<PropertyToken, unknown>;
+    propertyMetadata: Map<string, PropertyMetadata>;
+    vars: Vars;
+    events: ReloadEvents;
+    prefix: string;
+}

package/dist/config/additional-source/additional-source.module.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdditionalSourceModule = void 0;
+const config_reload_indicator_1 = require("../config-reload.indicator");
+const additional_source_initializer_1 = require("./additional-source.initializer");
+/**
+ * Модуль реализующий работу с `AdditionalSource` указанными в конфиге.
+ * Инициализирует все `source` в хуке `onModuleInit`
+ */
+class AdditionalSourceModule {
+    static forRoot(options) {
+        return {
+            imports: [
+                {
+                    global: true,
+                    module: AdditionalSourceModule,
+                    providers: [
+                        {
+                            provide: additional_source_initializer_1.AdditionalSourceInitializer,
+                            useValue: new additional_source_initializer_1.AdditionalSourceInitializer(options),
+                        },
+                    ],
+                    exports: [additional_source_initializer_1.AdditionalSourceInitializer],
+                },
+            ],
+            providers: [config_reload_indicator_1.ConfigReloadIndicator],
+            module: AdditionalSourceModule,
+        };
+    }
+}
+exports.AdditionalSourceModule = AdditionalSourceModule;
+//# sourceMappingURL=additional-source.module.js.map

package/dist/config/additional-source/additional-source.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"additional-source.module.js","sourceRoot":"","sources":["../../../src/config/additional-source/additional-source.module.ts"],"names":[],"mappings":";;;AAIA,wEAAmE;AAOnE,mFAA8E;AAE9E;;;GAGG;AACH,MAAa,sBAAsB;IACjC,MAAM,CAAC,OAAO,CAAC,OAAgC;QAC7C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,sBAAsB;oBAC9B,SAAS,EAAE;wBACT;4BACE,OAAO,EAAE,2DAA2B;4BACpC,QAAQ,EAAE,IAAI,2DAA2B,CAAC,OAAO,CAAC;yBACnD;qBACF;oBACD,OAAO,EAAE,CAAC,2DAA2B,CAAC;iBACvC;aACF;YACD,SAAS,EAAE,CAAC,+CAAqB,CAAC;YAClC,MAAM,EAAE,sBAAsB;SAC/B,CAAC;IACJ,CAAC;CACF;AApBD,wDAoBC"}

package/dist/config/config-reload.indicator.d.ts

@@ -0,0 +1,8 @@
+import type { HealthIndicator } from '../health';
+import { CheckResult } from '../health/helpers';
+export declare class ConfigReloadIndicator implements HealthIndicator {
+    private events;
+    private errors;
+    constructor();
+    check(): Promise<CheckResult>;
+}