@rsdk/core 0.14.0

package/dist/config/config-reload.indicator.js

@@ -0,0 +1,42 @@
+"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.ConfigReloadIndicator = void 0;
+const common_1 = require("@nestjs/common");
+const helpers_1 = require("../health/helpers");
+const reload_1 = require("./reload");
+let ConfigReloadIndicator = class ConfigReloadIndicator {
+    events = reload_1.ReloadEvents.getInstance();
+    errors = new Map();
+    constructor() {
+        this.events
+            .on('reload_failure', (source, err) => this.errors.set(source, err))
+            .on('update_failure', (config, err) => this.errors.set(config, err))
+            .on('reload', (source) => this.errors.delete(source))
+            .on('update', (config) => this.errors.delete(config));
+    }
+    async check() {
+        if (this.errors.size === 0) {
+            return helpers_1.CheckResult.up({});
+        }
+        const details = {};
+        for (const [key, err] of this.errors.entries()) {
+            details[key.constructor.name] = { error: err };
+        }
+        return helpers_1.CheckResult.down(details);
+    }
+};
+ConfigReloadIndicator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], ConfigReloadIndicator);
+exports.ConfigReloadIndicator = ConfigReloadIndicator;
+//# sourceMappingURL=config-reload.indicator.js.map

package/dist/config/config-reload.indicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-reload.indicator.js","sourceRoot":"","sources":["../../src/config/config-reload.indicator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAG5C,+CAAgD;AAGhD,qCAAwC;AAIjC,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACxB,MAAM,GAAG,qBAAY,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEzD;QACE,IAAI,CAAC,MAAM;aACR,EAAE,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;aACnE,EAAE,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;aACnE,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aACpD,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE;YAC1B,OAAO,qBAAW,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SAC3B;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE;YAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;SAChD;QAED,OAAO,qBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AAzBY,qBAAqB;IADjC,IAAA,mBAAU,GAAE;;GACA,qBAAqB,CAyBjC;AAzBY,sDAAqB"}

package/dist/config/config.abstract.d.ts

@@ -0,0 +1,19 @@
+import 'reflect-metadata';
+import type { Vars } from './vars.class';
+/**
+ * It is unconventional to use raw values from process.env or somewhere
+ * else because it will not be autodocumented. Instead developer is strongly
+ * encouraged to extends this abstract class and annotate all fields with
+ * @Property() decorator providing nesessary metadata.
+ */
+export declare class Config {
+    /**
+     * Keys are prefixed and sources are added.
+     */
+    private readonly propertiesMetadata;
+    private readonly events;
+    constructor();
+    onUpdate(fn: (keys: string[]) => void): void;
+    read(vars: Vars): string[];
+    tryUpdate(vars: Vars): void;
+}

package/dist/config/config.abstract.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+const lodash_1 = require("lodash");
+require("reflect-metadata");
+const metadata_1 = require("./metadata");
+const reload_1 = require("./reload");
+/**
+ * It is unconventional to use raw values from process.env or somewhere
+ * else because it will not be autodocumented. Instead developer is strongly
+ * encouraged to extends this abstract class and annotate all fields with
+ * @Property() decorator providing nesessary metadata.
+ */
+class Config {
+    /**
+     * Keys are prefixed and sources are added.
+     */
+    propertiesMetadata;
+    events = reload_1.ReloadEvents.getInstance();
+    // TODO: why not to pass this.vars and event emitter?
+    constructor() {
+        const metadata = Reflect.getMetadata(metadata_1.CONFIG_METADATA_KEY, this.constructor);
+        this.propertiesMetadata = metadata.properties;
+    }
+    onUpdate(fn) {
+        this.events.on('update', (_, updatedKeys) => {
+            const prefixedKeys = Object.keys(this.propertiesMetadata).map((x) => `${this.constructor.name}/${x}`);
+            if ((0, lodash_1.intersection)(prefixedKeys, updatedKeys).length > 0) {
+                fn(updatedKeys);
+            }
+        });
+    }
+    read(vars) {
+        const updated = [];
+        for (const [prop, metadata] of Object.entries(this.propertiesMetadata)) {
+            const value = this[prop];
+            const newValue = vars.extract(metadata);
+            // FIXME: Doesn't work with object types.
+            if (!(0, lodash_1.isEqual)(newValue, value)) {
+                this[prop] = newValue;
+                updated.push(`${this.constructor.name}/${prop}`);
+            }
+        }
+        return updated;
+    }
+    tryUpdate(vars) {
+        try {
+            const updated = this.read(vars);
+            this.events.emit('update', this, updated);
+        }
+        catch (err) {
+            this.events.emit('update_failure', this, err);
+        }
+    }
+}
+exports.Config = Config;
+//# sourceMappingURL=config.abstract.js.map

package/dist/config/config.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.abstract.js","sourceRoot":"","sources":["../../src/config/config.abstract.ts"],"names":[],"mappings":";;;AAAA,mCAA+C;AAE/C,4BAA0B;AAE1B,yCAAiD;AACjD,qCAAwC;AAIxC;;;;;GAKG;AACH,MAAa,MAAM;IACjB;;OAEG;IACc,kBAAkB,CAAmC;IACrD,MAAM,GAAiB,qBAAY,CAAC,WAAW,EAAE,CAAC;IAEnE,qDAAqD;IACrD;QACE,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAClC,8BAAmB,EACnB,IAAI,CAAC,WAAW,CACE,CAAC;QAErB,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC;IAChD,CAAC;IAED,QAAQ,CAAC,EAA4B;QACnC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAS,EAAE,WAAqB,EAAE,EAAE;YAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAC3D,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,EAAE,CACvC,CAAC;YACF,IAAI,IAAA,qBAAY,EAAC,YAAY,EAAE,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;gBACtD,EAAE,CAAC,WAAW,CAAC,CAAC;aACjB;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,IAAU;QACb,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE;YACtE,MAAM,KAAK,GAAI,IAAY,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAExC,yCAAyC;YACzC,IAAI,CAAC,IAAA,gBAAO,EAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;gBAC5B,IAAY,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;aAClD;SACF;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS,CAAC,IAAU;QAClB,IAAI;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEhC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;SAC3C;QAAC,OAAO,GAAQ,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;SAC/C;IACH,CAAC;CACF;AAtDD,wBAsDC"}

package/dist/config/config.module.d.ts

@@ -0,0 +1,121 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { Constructor } from '@rsdk/common';
+import type { PlatformOptions } from '../types';
+import type { Config } from './config.abstract';
+import type { ConfigSource } from './sources';
+export interface ConfigModuleOptions {
+    /**
+     * By convention every configuration key should have unique prefix
+     * for current service. It is inferred from application name
+     */
+    appName: string;
+    /**
+     * Additional asynchronous configuration sources. For example a source
+     * that loads configuration from Consul or other remote system.
+     */
+    sources?: Constructor<ConfigSource>[];
+}
+/**
+ * Configuration is loaded in predictable order. You should take
+ * into account chat all repeating keys will be overwritten on each step:
+ *
+ * 1. .env file if there is any
+ * 2. process environment
+ * 3. динамические source'ы (если сделать последовательно - то в порядке указания)
+ */
+export declare class PlatformConfigModule {
+    private static isBootstrapped;
+    private static events;
+    private static vars;
+    private static prefix;
+    /**
+     * Проинициализированные секции конфигов
+     * @private
+     */
+    private static initializedConfigs;
+    /**
+     * undefined является валидным значением по умолчанию (`defaultValue`)
+     * @private
+     */
+    private static properties;
+    /**
+     * We don't use class as context here because it is undefined if
+     * tsc target is ES2022
+     */
+    private static logger;
+    /**
+     * Метадата о необходимых приложению значениях конфигурации
+     * Зачем храним?
+     * Потому что пайплайн такой:
+     * 1. Собираем данные о том какие поля нам нужны
+     * 2. Приложение запрашивает поле из конфигурации
+     * 3. Ищем метаданные
+     * 4. По метаданным вытягиваем значение
+     * 5. Отдаём значение
+     *
+     * Это важно так как позволяет прозрачным образом контролировать этот процесс и инициализировать поля в тот момент когда они потребуются
+     * А не в тот момент когда их объявили
+     * Основной кейс, где это применяется - тесты
+     * @private
+     */
+    private static propertyMetadata;
+    /**
+     * This method should be invoked BEFORE bootstrapping nest application.
+     *
+     * It takes 2 main actions:
+     * - load environment variables
+     *
+     * - instantiates all configuration initializedConfig (classes marked with
+     *   @ConfigSection() decorator) and adds them into internal storage
+     *
+     * If any of these actions fails - application should exit.
+     *
+     * NOTE: This method should be invoked before any other interaction
+     * with ConfigurationModule
+     *
+     * ATTENTION: not load values from additional source
+     */
+    static bootstrap(options?: ConfigModuleOptions): void;
+    /**
+     * Use this method to imports specific configuration property
+     * into given module
+     *
+     * @param alias It's not so easy to use plain property key because
+     * of prefix and source key issues. That's why we use aliases. Specify
+     * the same string that was used to define property in
+     * @Property() or @ExtraEnv() decorator.
+     *
+     * @returns DynamicModule
+     */
+    static forProperty(alias: string): DynamicModule;
+    /**
+     * Use this method to import specified configuration section
+     * into given module
+     * @param ctor Pass constructor of configuration section class
+     * @returns DynamicModule
+     */
+    static forFeature(ctor: Constructor<Config>): DynamicModule;
+    static forRoot(options: PlatformOptions): DynamicModule;
+    /**
+     * Extracting specific instance of configuration section by
+     * its class reference. Throws error if called before .bootstrap()
+     *
+     * ATTENTION: Конфиг будет разрешен с доступными на данный момент переменными,
+     * то есть если дополнительные источники конфигурации ещё не были проинициализированы,
+     * они не будут учтены в разрешении конфигурации.
+     *
+     * @param ctor Pass constructor of configuration section class
+     * @returns T
+     */
+    static resolve<T extends Config>(ctor: Constructor<T>): T;
+    private static getPropertyProvider;
+    private static readEnvironment;
+    private static extractStandaloneProperties;
+    /**
+     * Инициализирует инстанс секции конфига
+     * ATTENTION: не проверяет есть ли ещё проинициализированные, будьте внимательны во избежание неожиданного поведение
+     * @param ctor
+     * @private
+     */
+    private static instantiateSection;
+}

package/dist/config/config.module.js

@@ -0,0 +1,271 @@
+"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 PlatformConfigModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformConfigModule = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@rsdk/common");
+const logging_1 = require("@rsdk/logging");
+const exceptions_1 = require("../exceptions");
+const additional_source_initializer_1 = require("./additional-source/additional-source.initializer");
+const additional_source_module_1 = require("./additional-source/additional-source.module");
+const exceptions_2 = require("./exceptions");
+const metadata_1 = require("./metadata");
+const reload_1 = require("./reload");
+const vars_class_1 = require("./vars.class");
+/**
+ * Configuration is loaded in predictable order. You should take
+ * into account chat all repeating keys will be overwritten on each step:
+ *
+ * 1. .env file if there is any
+ * 2. process environment
+ * 3. динамические source'ы (если сделать последовательно - то в порядке указания)
+ */
+let PlatformConfigModule = PlatformConfigModule_1 = class PlatformConfigModule {
+    static isBootstrapped = false;
+    static events = reload_1.ReloadEvents.getInstance();
+    static vars;
+    static prefix;
+    /**
+     * Проинициализированные секции конфигов
+     * @private
+     */
+    static initializedConfigs = new Map();
+    /**
+     * undefined является валидным значением по умолчанию (`defaultValue`)
+     * @private
+     */
+    static properties = new Map();
+    /**
+     * We don't use class as context here because it is undefined if
+     * tsc target is ES2022
+     */
+    static logger = logging_1.LoggerFactory.create('PlatformConfigModule');
+    /**
+     * Метадата о необходимых приложению значениях конфигурации
+     * Зачем храним?
+     * Потому что пайплайн такой:
+     * 1. Собираем данные о том какие поля нам нужны
+     * 2. Приложение запрашивает поле из конфигурации
+     * 3. Ищем метаданные
+     * 4. По метаданным вытягиваем значение
+     * 5. Отдаём значение
+     *
+     * Это важно так как позволяет прозрачным образом контролировать этот процесс и инициализировать поля в тот момент когда они потребуются
+     * А не в тот момент когда их объявили
+     * Основной кейс, где это применяется - тесты
+     * @private
+     */
+    static propertyMetadata = new Map();
+    /**
+     * This method should be invoked BEFORE bootstrapping nest application.
+     *
+     * It takes 2 main actions:
+     * - load environment variables
+     *
+     * - instantiates all configuration initializedConfig (classes marked with
+     *   @ConfigSection() decorator) and adds them into internal storage
+     *
+     * If any of these actions fails - application should exit.
+     *
+     * NOTE: This method should be invoked before any other interaction
+     * with ConfigurationModule
+     *
+     * ATTENTION: not load values from additional source
+     */
+    static bootstrap(options) {
+        if (this.isBootstrapped) {
+            throw new exceptions_1.SequenceException("Can't bootstrap ConfigurationModule twice");
+        }
+        this.prefix = options?.appName ?? '';
+        if (this.prefix) {
+            this.logger.info('Setting configuration keys prefix', {
+                prefix: this.prefix,
+            });
+        }
+        this.vars = new vars_class_1.Vars(this.prefix);
+        this.readEnvironment();
+        /**
+         * Reading and validating standalone properties from env.
+         *
+         * NOTE: Splitting extraction if standalone properties into 2 phases
+         * is necessary, some configuration sources can need something
+         * from env to be instatiated.
+         */
+        const { properties } = metadata_1.ConfigMetadataRegistry.getMetadata();
+        this.extractStandaloneProperties(properties, 'expectedInEnv');
+        /**
+         * NOTE: That properties from .env already loaded.
+         * Now loading ones from other sources
+         */
+        this.extractStandaloneProperties(properties, 'others');
+        this.isBootstrapped = true;
+    }
+    /**
+     * Use this method to imports specific configuration property
+     * into given module
+     *
+     * @param alias It's not so easy to use plain property key because
+     * of prefix and source key issues. That's why we use aliases. Specify
+     * the same string that was used to define property in
+     * @Property() or @ExtraEnv() decorator.
+     *
+     * @returns DynamicModule
+     */
+    static forProperty(alias) {
+        const token = (0, metadata_1.getPropertyToken)(alias);
+        const provider = this.getPropertyProvider(token);
+        return {
+            module: PlatformConfigModule_1,
+            providers: [provider],
+            exports: [provider],
+        };
+    }
+    /**
+     * Use this method to import specified configuration section
+     * into given module
+     * @param ctor Pass constructor of configuration section class
+     * @returns DynamicModule
+     */
+    static forFeature(ctor) {
+        /**
+         * Factory providers are used because at the point of time when
+         * forFeature() is executed Config instances don't yet exist
+         */
+        const provider = {
+            inject: [{ optional: true, token: additional_source_initializer_1.AdditionalSourceInitializer }],
+            provide: ctor,
+            useFactory: async (additionalSourceModuleInitializer) => {
+                /**
+                 * Да, каждый раз вызываем метод `initialize` более подробно почему так - смотри в `JSDoc` метода
+                 */
+                await additionalSourceModuleInitializer?.initialize();
+                return this.resolve(ctor);
+            },
+        };
+        return {
+            module: PlatformConfigModule_1,
+            providers: [provider],
+            exports: [provider],
+        };
+    }
+    static forRoot(options) {
+        const providers = [];
+        const imports = [];
+        if (options.config?.sources) {
+            imports.push(
+            // TODO: Эти опции в идеале добавить в сам контейнер и использовать их везде
+            additional_source_module_1.AdditionalSourceModule.forRoot({
+                sources: options.config?.sources,
+                logger: this.logger,
+                properties: this.properties,
+                vars: this.vars,
+                events: this.events,
+                prefix: this.prefix,
+                propertyMetadata: this.propertyMetadata,
+            }));
+        }
+        return {
+            imports,
+            module: PlatformConfigModule_1,
+            providers,
+        };
+    }
+    /**
+     * Extracting specific instance of configuration section by
+     * its class reference. Throws error if called before .bootstrap()
+     *
+     * ATTENTION: Конфиг будет разрешен с доступными на данный момент переменными,
+     * то есть если дополнительные источники конфигурации ещё не были проинициализированы,
+     * они не будут учтены в разрешении конфигурации.
+     *
+     * @param ctor Pass constructor of configuration section class
+     * @returns T
+     */
+    static resolve(ctor) {
+        /**
+         * Автор уверен, что здесь не стоит делать bootstrap так как это разные зоны ответственности
+         */
+        if (!this.isBootstrapped) {
+            throw new exceptions_2.ConfigNotBootstrappedException();
+        }
+        const instance = this.initializedConfigs.get(ctor);
+        if (!instance) {
+            const instantiateSection = this.instantiateSection(ctor);
+            this.initializedConfigs.set(ctor, instantiateSection);
+            return instantiateSection;
+        }
+        // We know exactly it is T
+        return instance;
+    }
+    static getPropertyProvider(token) {
+        return {
+            inject: [{ optional: true, token: additional_source_initializer_1.AdditionalSourceInitializer }],
+            provide: token,
+            useFactory: async (additionalSourceModuleInitializer) => {
+                await additionalSourceModuleInitializer?.initialize();
+                if (this.properties.has(token)) {
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    return this.properties.get(token);
+                }
+                const propMeta = this.propertyMetadata.get(token);
+                if (!propMeta) {
+                    throw new exceptions_2.ConfigPropertyMetadataNotFound(token);
+                }
+                const value = this.vars.extract(propMeta);
+                this.properties.set(token, value);
+                return value;
+            },
+        };
+    }
+    static readEnvironment() {
+        this.logger.info('Loading variables from .env file if exists');
+        common_2.dotenv.config();
+        this.logger.info('Initializing raw parameters storage');
+        /**
+         * Copying parameters from process.env, skipping entries
+         * for which value is undefined (not sure it's possible,
+         * but @types/node says it is).
+         */
+        for (const [key, value] of Object.entries(process.env)) {
+            if (value !== undefined) {
+                this.vars.set(key, value);
+            }
+        }
+    }
+    static extractStandaloneProperties(properties, subset) {
+        for (const [alias, metadata] of properties.entries()) {
+            if (subset === 'expectedInEnv' && !metadata.expectedInEnv) {
+                continue;
+            }
+            this.propertyMetadata.set((0, metadata_1.getPropertyToken)(alias), metadata);
+        }
+    }
+    /**
+     * Инициализирует инстанс секции конфига
+     * ATTENTION: не проверяет есть ли ещё проинициализированные, будьте внимательны во избежание неожиданного поведение
+     * @param ctor
+     * @private
+     */
+    static instantiateSection(ctor) {
+        const instance = new ctor();
+        this.logger.debug('Initializing configuration section instance', {
+            ctor: ctor.name,
+        });
+        this.events.on('merge', () => {
+            instance.tryUpdate(this.vars);
+        });
+        instance.read(this.vars);
+        return instance;
+    }
+};
+PlatformConfigModule = PlatformConfigModule_1 = __decorate([
+    (0, common_1.Module)({})
+], PlatformConfigModule);
+exports.PlatformConfigModule = PlatformConfigModule;
+//# sourceMappingURL=config.module.js.map

package/dist/config/config.module.js.map

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

package/dist/config/exceptions/config-not-bootstrapped.exception.d.ts

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

package/dist/config/exceptions/config-not-bootstrapped.exception.js

@@ -0,0 +1,30 @@
+"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.ConfigNotBootstrappedException = void 0;
+const common_1 = require("@rsdk/common");
+const exceptions_1 = require("../../exceptions");
+let ConfigNotBootstrappedException = class ConfigNotBootstrappedException extends exceptions_1.BootstrapException {
+    constructor() {
+        super('Configuration module is not bootstrapped!');
+    }
+};
+ConfigNotBootstrappedException = __decorate([
+    (0, exceptions_1.Exception)({
+        description: (0, common_1.text) `
+    Occures when something is calling PlatformConfigModule functionality
+    when it is not yet bootstrapped.
+  `,
+    }),
+    __metadata("design:paramtypes", [])
+], ConfigNotBootstrappedException);
+exports.ConfigNotBootstrappedException = ConfigNotBootstrappedException;
+//# sourceMappingURL=config-not-bootstrapped.exception.js.map

package/dist/config/exceptions/config-not-bootstrapped.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-not-bootstrapped.exception.js","sourceRoot":"","sources":["../../../src/config/exceptions/config-not-bootstrapped.exception.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAoC;AAEpC,iDAAiE;AAQ1D,IAAM,8BAA8B,GAApC,MAAM,8BAA+B,SAAQ,+BAAkB;IACpE;QACE,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACrD,CAAC;CACF,CAAA;AAJY,8BAA8B;IAN1C,IAAA,sBAAS,EAAC;QACT,WAAW,EAAE,IAAA,aAAI,EAAA;;;GAGhB;KACF,CAAC;;GACW,8BAA8B,CAI1C;AAJY,wEAA8B"}

package/dist/config/exceptions/config-property-metadata-not-found.d.ts

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

package/dist/config/exceptions/config-property-metadata-not-found.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigPropertyMetadataNotFound = void 0;
+const exceptions_1 = require("../../exceptions");
+class ConfigPropertyMetadataNotFound extends exceptions_1.InternalException {
+    constructor(configPropertyToken) {
+        super(`Metadata for config property ${configPropertyToken} not found`, {
+            details: configPropertyToken,
+        });
+    }
+}
+exports.ConfigPropertyMetadataNotFound = ConfigPropertyMetadataNotFound;
+//# sourceMappingURL=config-property-metadata-not-found.js.map

package/dist/config/exceptions/config-property-metadata-not-found.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-property-metadata-not-found.js","sourceRoot":"","sources":["../../../src/config/exceptions/config-property-metadata-not-found.ts"],"names":[],"mappings":";;;AAAA,iDAAqD;AAErD,MAAa,8BAA+B,SAAQ,8BAAiB;IACnE,YAAY,mBAA2B;QACrC,KAAK,CAAC,gCAAgC,mBAAmB,YAAY,EAAE;YACrE,OAAO,EAAE,mBAAmB;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAND,wEAMC"}

package/dist/config/exceptions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './config-not-bootstrapped.exception';
+export * from './property.exception';
+export { ConfigPropertyMetadataNotFound } from './config-property-metadata-not-found';

package/dist/config/exceptions/index.js

@@ -0,0 +1,22 @@
+"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 });
+exports.ConfigPropertyMetadataNotFound = void 0;
+__exportStar(require("./config-not-bootstrapped.exception"), exports);
+__exportStar(require("./property.exception"), exports);
+var config_property_metadata_not_found_1 = require("./config-property-metadata-not-found");
+Object.defineProperty(exports, "ConfigPropertyMetadataNotFound", { enumerable: true, get: function () { return config_property_metadata_not_found_1.ConfigPropertyMetadataNotFound; } });
+//# sourceMappingURL=index.js.map

package/dist/config/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/exceptions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sEAAoD;AACpD,uDAAqC;AACrC,2FAAsF;AAA7E,oJAAA,8BAA8B,OAAA"}

package/dist/config/exceptions/property.exception.d.ts

@@ -0,0 +1,5 @@
+import { PlatformException } from '../../exceptions';
+export declare class PropertyException extends PlatformException {
+    constructor(property: string, msg: string);
+    static fromError(err: any, key: string): PropertyException;
+}

package/dist/config/exceptions/property.exception.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyException = void 0;
+const exceptions_1 = require("../../exceptions");
+class PropertyException extends exceptions_1.PlatformException {
+    constructor(property, msg) {
+        super('CONFIG:PROPERTY', msg, {
+            details: {
+                property,
+            },
+        });
+    }
+    static fromError(err, key) {
+        return new PropertyException(key, err.message || 'UNKNOWN ERROR');
+    }
+}
+exports.PropertyException = PropertyException;
+//# sourceMappingURL=property.exception.js.map