@rsdk/core 0.14.0

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

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReloadEvents = void 0;
+/* eslint-disable prettier/prettier */
+const events_1 = __importDefault(require("events"));
+class ReloadEvents extends events_1.default {
+    static instance;
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new ReloadEvents();
+        }
+        return this.instance;
+    }
+}
+exports.ReloadEvents = ReloadEvents;
+//# sourceMappingURL=config-reload.events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-reload.events.js","sourceRoot":"","sources":["../../../src/config/reload/config-reload.events.ts"],"names":[],"mappings":";;;;;;AAAA,sCAAsC;AACtC,oDAAkC;AAOlC,MAAa,YAAa,SAAQ,gBAAY;IACpC,MAAM,CAAC,QAAQ,CAAe;IAEtC,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;SACpC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAVD,oCAUC"}

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

@@ -0,0 +1 @@
+export * from './config-reload.events';

package/dist/config/reload/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("./config-reload.events"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/reload/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/dist/config/sources/base/config-source.abstract.d.ts

@@ -0,0 +1,23 @@
+import type { RawValues, SourceType } from '../../types';
+export declare abstract class ConfigSource {
+    /**
+     * Wrapped .loadRaw() method which should be implemented in
+     * derived class and enforces basic validation and error transforming.
+     *
+     * NOTE: Guarantees that only ConfigSourceException can't be thrown
+     * @returns Promise<Vars>
+     */
+    load(): Promise<RawValues>;
+    /**
+     * Flattens raw configuration and validates that each property is
+     * either primitive or array of primitives.
+     *
+     * @param obj Raw configuration object obtained from source
+     * @param prefix recursive calls chain path in for of string
+     * @returns Vars
+     */
+    private flattenEndValidate;
+    abstract name(): string;
+    abstract type(): SourceType;
+    abstract loadRaw(): Promise<unknown>;
+}

package/dist/config/sources/base/config-source.abstract.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigSource = void 0;
+const common_1 = require("@rsdk/common");
+const exceptions_1 = require("../exceptions");
+class ConfigSource {
+    /**
+     * Wrapped .loadRaw() method which should be implemented in
+     * derived class and enforces basic validation and error transforming.
+     *
+     * NOTE: Guarantees that only ConfigSourceException can't be thrown
+     * @returns Promise<Vars>
+     */
+    async load() {
+        try {
+            /**
+             * Need to handle error on reload because
+             * otherwise application will go down (just as
+             * on reading step)
+             *
+             * TODO: Add negative health check when last
+             * 3 configuration updates fail
+             */
+            const raw = await this.loadRaw();
+            return this.flattenEndValidate(raw);
+        }
+        catch (err) {
+            if (err instanceof exceptions_1.ConfigSourceException) {
+                throw err;
+            }
+            throw new exceptions_1.ConfigSourceException('Failed to load configuration from file', err);
+        }
+    }
+    /**
+     * Flattens raw configuration and validates that each property is
+     * either primitive or array of primitives.
+     *
+     * @param obj Raw configuration object obtained from source
+     * @param prefix recursive calls chain path in for of string
+     * @returns Vars
+     */
+    flattenEndValidate(obj, prefix = '') {
+        if (!(0, common_1.isRecord)(obj)) {
+            throw new exceptions_1.ConfigSourceException(prefix
+                ? `Value at key: ${prefix} should be an object, primitive or array of primitives`
+                : `Value at root sould be an object`);
+        }
+        return Object.entries(obj).reduce((acc, [key, value]) => {
+            if ((0, common_1.isPrimitive)(value)) {
+                acc.set(key, value);
+                return acc;
+            }
+            const pre = (prefix.length > 0 ? `${prefix}.` : '') + key;
+            if (Array.isArray(value)) {
+                if (!value.every(common_1.isPrimitive)) {
+                    throw new exceptions_1.ConfigSourceException(`Non primitive array at key: ${pre}`);
+                }
+                acc.set(key, value);
+                return acc;
+            }
+            /**
+             * Value is not primitive and is not array which means
+             * it is object. So: do recursion
+             */
+            for (const [key, v] of this.flattenEndValidate(value, pre).entries()) {
+                acc.set(key, v);
+            }
+            return acc;
+        }, new Map());
+    }
+}
+exports.ConfigSource = ConfigSource;
+//# sourceMappingURL=config-source.abstract.js.map

package/dist/config/sources/base/config-source.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source.abstract.js","sourceRoot":"","sources":["../../../../src/config/sources/base/config-source.abstract.ts"],"names":[],"mappings":";;;AAAA,yCAAqD;AAGrD,8CAAsD;AAEtD,MAAsB,YAAY;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI;QACR,IAAI;YACF;;;;;;;eAOG;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAEjC,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;SACrC;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,GAAG,YAAY,kCAAqB,EAAE;gBACxC,MAAM,GAAG,CAAC;aACX;YAED,MAAM,IAAI,kCAAqB,CAC7B,wCAAwC,EACxC,GAAY,CACb,CAAC;SACH;IACH,CAAC;IAED;;;;;;;OAOG;IACK,kBAAkB,CAAC,GAAY,EAAE,MAAM,GAAG,EAAE;QAClD,IAAI,CAAC,IAAA,iBAAQ,EAAC,GAAG,CAAC,EAAE;YAClB,MAAM,IAAI,kCAAqB,CAC7B,MAAM;gBACJ,CAAC,CAAC,iBAAiB,MAAM,wDAAwD;gBACjF,CAAC,CAAC,kCAAkC,CACvC,CAAC;SACH;QAED,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAc,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACjE,IAAI,IAAA,oBAAW,EAAC,KAAK,CAAC,EAAE;gBACtB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAEpB,OAAO,GAAG,CAAC;aACZ;YAED,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;YAE1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBACxB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAW,CAAC,EAAE;oBAC7B,MAAM,IAAI,kCAAqB,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;iBACvE;gBAED,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAEpB,OAAO,GAAG,CAAC;aACZ;YAED;;;eAGG;YACH,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACpE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;aACjB;YAED,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,IAAI,GAAG,EAA0B,CAAC,CAAC;IACxC,CAAC;CAKF;AApFD,oCAoFC"}

package/dist/config/sources/base/index.d.ts

@@ -0,0 +1,2 @@
+export * from './reloadable-config-source.abstract';
+export * from './config-source.abstract';

package/dist/config/sources/base/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("./reloadable-config-source.abstract"), exports);
+__exportStar(require("./config-source.abstract"), exports);
+//# sourceMappingURL=index.js.map

package/dist/config/sources/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/sources/base/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sEAAoD;AACpD,2DAAyC"}

package/dist/config/sources/base/reloadable-config-source.abstract.d.ts

@@ -0,0 +1,12 @@
+import type { ILogger } from '@rsdk/logging';
+import type { SourceType } from '../../types';
+import { ConfigSource } from './config-source.abstract';
+export declare abstract class ReloadableConfigSource extends ConfigSource {
+    protected readonly logger: ILogger;
+    private readonly events;
+    constructor(logger: ILogger);
+    type(): SourceType;
+    reload(): Promise<void>;
+    abstract init(): void;
+}
+export declare const isReloadable: (s: ConfigSource) => s is ReloadableConfigSource;

package/dist/config/sources/base/reloadable-config-source.abstract.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReloadable = exports.ReloadableConfigSource = void 0;
+const reload_1 = require("../../reload");
+const config_source_abstract_1 = require("./config-source.abstract");
+class ReloadableConfigSource extends config_source_abstract_1.ConfigSource {
+    logger;
+    events = reload_1.ReloadEvents.getInstance();
+    constructor(logger) {
+        super();
+        this.logger = logger;
+    }
+    type() {
+        return 'reloadable';
+    }
+    async reload() {
+        try {
+            const vars = await this.load();
+            this.events.emit('reload', this, vars);
+        }
+        catch (err) {
+            this.logger.error(`Failed to reload configuration (${this.constructor.name})`, err);
+            this.events.emit('reload_failure', this, err);
+        }
+    }
+}
+exports.ReloadableConfigSource = ReloadableConfigSource;
+const isReloadable = (s) => s.type() === 'reloadable';
+exports.isReloadable = isReloadable;
+//# sourceMappingURL=reloadable-config-source.abstract.js.map

package/dist/config/sources/base/reloadable-config-source.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reloadable-config-source.abstract.js","sourceRoot":"","sources":["../../../../src/config/sources/base/reloadable-config-source.abstract.ts"],"names":[],"mappings":";;;AAEA,yCAA4C;AAG5C,qEAAwD;AAExD,MAAsB,sBAAuB,SAAQ,qCAAY;IAC5C,MAAM,CAAU;IAClB,MAAM,GAAG,qBAAY,CAAC,WAAW,EAAE,CAAC;IAErD,YAAY,MAAe;QACzB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACF,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAE/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;SACxC;QAAC,OAAO,GAAQ,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,mCAAmC,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,EAC3D,GAAG,CACJ,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;SAC/C;IACH,CAAC;CAGF;AA5BD,wDA4BC;AAEM,MAAM,YAAY,GAAG,CAAC,CAAe,EAA+B,EAAE,CAC3E,CAAC,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC;AADf,QAAA,YAAY,gBACG"}

package/dist/config/sources/config-source.decorator.d.ts

@@ -0,0 +1,12 @@
+import type { SourceType } from '../types';
+export interface SourceOptions {
+    description?: string;
+    name?: string;
+}
+/**
+ * This decorator is used to register additional configuration
+ * sourcePropertyParser
+ * @param options Metadata used mostly for docs generation
+ * @returns
+ */
+export declare const Source: (type: SourceType, options?: SourceOptions) => ClassDecorator;

package/dist/config/sources/config-source.decorator.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Source = void 0;
+const metadata_1 = require("../metadata");
+const SOURCE_METADATA_KEY = 'CONFIG_SOURCE_METADATA_KEY';
+const DEFAULT_OPTIONS = {};
+/**
+ * This decorator is used to register additional configuration
+ * sourcePropertyParser
+ * @param options Metadata used mostly for docs generation
+ * @returns
+ */
+const Source = (type, options = {}) => {
+    return function (target) {
+        const name = options.name || target.name;
+        const effectiveOptions = { ...DEFAULT_OPTIONS, ...options, name, type };
+        Reflect.defineMetadata(SOURCE_METADATA_KEY, effectiveOptions, target);
+        metadata_1.ConfigMetadataRegistry.registerSource(target, effectiveOptions);
+    };
+};
+exports.Source = Source;
+//# sourceMappingURL=config-source.decorator.js.map

package/dist/config/sources/config-source.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source.decorator.js","sourceRoot":"","sources":["../../../src/config/sources/config-source.decorator.ts"],"names":[],"mappings":";;;AAGA,0CAAqD;AAGrD,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAOzD,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;GAKG;AACI,MAAM,MAAM,GAAG,CACpB,IAAgB,EAChB,UAAyB,EAAE,EACX,EAAE;IAClB,OAAO,UAAU,MAAgB;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;QACzC,MAAM,gBAAgB,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAExE,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAEtE,iCAAsB,CAAC,cAAc,CACnC,MAAqB,EACrB,gBAAgB,CACjB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,MAAM,UAejB"}

package/dist/config/sources/exceptions/config-source-di.exception.d.ts

@@ -0,0 +1,6 @@
+import { Constructor } from '@rsdk/common';
+import { BootstrapException } from '../../../exceptions';
+import type { ConfigSource } from '../base';
+export declare class ConfigSourceDIException extends BootstrapException {
+    constructor(source: Constructor<ConfigSource>, param: unknown);
+}

package/dist/config/sources/exceptions/config-source-di.exception.js

@@ -0,0 +1,34 @@
+"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.ConfigSourceDIException = void 0;
+const common_1 = require("@rsdk/common");
+const exceptions_1 = require("../../../exceptions");
+let ConfigSourceDIException = class ConfigSourceDIException extends exceptions_1.BootstrapException {
+    constructor(source, param) {
+        super((0, common_1.text) `
+      Only standalone properties (from env) and some special values (ex. application name)
+      can be injected into ConfigSource constructor. You are trying to inject
+      <${param}> to ${source.constructor.name}.
+    `);
+    }
+};
+ConfigSourceDIException = __decorate([
+    (0, exceptions_1.Exception)({
+        description: (0, common_1.text) `
+    Wrong usage of DI in custom configuration source.
+    See @rsdk/core docs.
+  `,
+    }),
+    __metadata("design:paramtypes", [Object, Object])
+], ConfigSourceDIException);
+exports.ConfigSourceDIException = ConfigSourceDIException;
+//# sourceMappingURL=config-source-di.exception.js.map

package/dist/config/sources/exceptions/config-source-di.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source-di.exception.js","sourceRoot":"","sources":["../../../../src/config/sources/exceptions/config-source-di.exception.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAiD;AAEjD,oDAAoE;AAS7D,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,+BAAkB;IAC7D,YAAY,MAAiC,EAAE,KAAc;QAC3D,KAAK,CAAC,IAAA,aAAI,EAAA;;;SAGL,KAAK,QAAQ,MAAM,CAAC,WAAW,CAAC,IAAI;KACxC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AARY,uBAAuB;IANnC,IAAA,sBAAS,EAAC;QACT,WAAW,EAAE,IAAA,aAAI,EAAA;;;GAGhB;KACF,CAAC;;GACW,uBAAuB,CAQnC;AARY,0DAAuB"}

package/dist/config/sources/exceptions/config-source.exception.d.ts

@@ -0,0 +1,4 @@
+import { PlatformException } from '../../../exceptions';
+export declare class ConfigSourceException extends PlatformException {
+    constructor(message: string, cause?: Error);
+}

package/dist/config/sources/exceptions/config-source.exception.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigSourceException = void 0;
+const exceptions_1 = require("../../../exceptions");
+class ConfigSourceException extends exceptions_1.PlatformException {
+    constructor(message, cause) {
+        super('CONFIG:LOAD', message, { cause });
+    }
+}
+exports.ConfigSourceException = ConfigSourceException;
+//# sourceMappingURL=config-source.exception.js.map

package/dist/config/sources/exceptions/config-source.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-source.exception.js","sourceRoot":"","sources":["../../../../src/config/sources/exceptions/config-source.exception.ts"],"names":[],"mappings":";;;AAAA,oDAAwD;AAExD,MAAa,qBAAsB,SAAQ,8BAAiB;IAC1D,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAJD,sDAIC"}

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

@@ -0,0 +1,2 @@
+export * from './config-source.exception';
+export * from './config-source-di.exception';

package/dist/config/sources/exceptions/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("./config-source.exception"), exports);
+__exportStar(require("./config-source-di.exception"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/sources/exceptions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,+DAA6C"}

package/dist/config/sources/implementations/json-file.source.d.ts

@@ -0,0 +1,9 @@
+import type { SourceType } from '../../types';
+import { ConfigSource } from '../base';
+export declare class StaticFileSource extends ConfigSource {
+    private readonly path;
+    constructor(path: string);
+    type(): SourceType;
+    name(): string;
+    loadRaw(): Promise<unknown>;
+}

package/dist/config/sources/implementations/json-file.source.js

@@ -0,0 +1,46 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaticFileSource = void 0;
+const common_1 = require("@rsdk/common");
+const metadata_1 = require("../../metadata");
+const parsers_1 = require("../../parsers");
+const base_1 = require("../base");
+const config_source_decorator_1 = require("../config-source.decorator");
+let StaticFileSource = class StaticFileSource extends base_1.ConfigSource {
+    path;
+    constructor(path) {
+        super();
+        this.path = path;
+    }
+    type() {
+        return 'static';
+    }
+    name() {
+        return `Static conf file: ${this.path}`;
+    }
+    loadRaw() {
+        return (0, common_1.readObj)(this.path);
+    }
+};
+StaticFileSource = __decorate([
+    (0, config_source_decorator_1.Source)('static'),
+    (0, metadata_1.DeclareProperty)(`CONFIG_PATH`, new parsers_1.FsPathParser('file'), {
+        description: 'Path to some configuration file',
+    }),
+    __param(0, (0, metadata_1.InjectProperty)('CONFIG_PATH')),
+    __metadata("design:paramtypes", [String])
+], StaticFileSource);
+exports.StaticFileSource = StaticFileSource;
+//# sourceMappingURL=json-file.source.js.map

package/dist/config/sources/implementations/json-file.source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.source.js","sourceRoot":"","sources":["../../../../src/config/sources/implementations/json-file.source.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,yCAAuC;AAEvC,6CAAiE;AACjE,2CAA6C;AAE7C,kCAAuC;AACvC,wEAAoD;AAM7C,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,mBAAY;IACY;IAA5D,YAA4D,IAAY;QACtE,KAAK,EAAE,CAAC;QADkD,SAAI,GAAJ,IAAI,CAAQ;IAExE,CAAC;IAEQ,IAAI;QACX,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEQ,IAAI;QACX,OAAO,qBAAqB,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAEQ,OAAO;QACd,OAAO,IAAA,gBAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF,CAAA;AAhBY,gBAAgB;IAJ5B,IAAA,gCAAM,EAAC,QAAQ,CAAC;IAChB,IAAA,0BAAe,EAAC,aAAa,EAAE,IAAI,sBAAY,CAAC,MAAM,CAAC,EAAE;QACxD,WAAW,EAAE,iCAAiC;KAC/C,CAAC;IAEa,WAAA,IAAA,yBAAc,EAAC,aAAa,CAAC,CAAA;;GAD/B,gBAAgB,CAgB5B;AAhBY,4CAAgB"}

package/dist/config/sources/implementations/relodable-json-file.source.d.ts

@@ -0,0 +1,8 @@
+import { ReloadableConfigSource } from '../base';
+export declare class ReloadableFileSource extends ReloadableConfigSource {
+    private readonly path;
+    constructor(path: string);
+    name(): string;
+    loadRaw(): Promise<unknown>;
+    init(): void;
+}

package/dist/config/sources/implementations/relodable-json-file.source.js

@@ -0,0 +1,55 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ReloadableFileSource_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReloadableFileSource = void 0;
+const fs_1 = require("fs");
+const common_1 = require("@rsdk/common");
+const logging_1 = require("@rsdk/logging");
+const metadata_1 = require("../../metadata");
+const parsers_1 = require("../../parsers");
+const base_1 = require("../base");
+const config_source_decorator_1 = require("../config-source.decorator");
+let ReloadableFileSource = ReloadableFileSource_1 = class ReloadableFileSource extends base_1.ReloadableConfigSource {
+    path;
+    constructor(path) {
+        super(logging_1.LoggerFactory.create(ReloadableFileSource_1));
+        this.path = path;
+    }
+    name() {
+        return `Configuration file: ${this.path}`;
+    }
+    loadRaw() {
+        return (0, common_1.readObj)(this.path);
+    }
+    init() {
+        (0, fs_1.watch)(this.path, (event) => {
+            if (event !== 'change') {
+                return;
+            }
+            this.logger.info('Changes detected', { source: this.name });
+            this.reload();
+        });
+    }
+};
+ReloadableFileSource = ReloadableFileSource_1 = __decorate([
+    (0, config_source_decorator_1.Source)('reloadable'),
+    (0, metadata_1.DeclareProperty)('CONFIG_PATH', new parsers_1.FsPathParser('file'), {
+        description: 'Path to some configuration file',
+    }),
+    __param(0, (0, metadata_1.InjectProperty)('CONFIG_PATH')),
+    __metadata("design:paramtypes", [String])
+], ReloadableFileSource);
+exports.ReloadableFileSource = ReloadableFileSource;
+//# sourceMappingURL=relodable-json-file.source.js.map

package/dist/config/sources/implementations/relodable-json-file.source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relodable-json-file.source.js","sourceRoot":"","sources":["../../../../src/config/sources/implementations/relodable-json-file.source.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2BAA2B;AAE3B,yCAAuC;AACvC,2CAA8C;AAE9C,6CAAiE;AACjE,2CAA6C;AAC7C,kCAAiD;AACjD,wEAAoD;AAM7C,IAAM,oBAAoB,4BAA1B,MAAM,oBAAqB,SAAQ,6BAAsB;IACF;IAA5D,YAA4D,IAAY;QACtE,KAAK,CAAC,uBAAa,CAAC,MAAM,CAAC,sBAAoB,CAAC,CAAC,CAAC;QADQ,SAAI,GAAJ,IAAI,CAAQ;IAExE,CAAC;IAEQ,IAAI;QACX,OAAO,uBAAuB,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAEQ,OAAO;QACd,OAAO,IAAA,gBAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEQ,IAAI;QACX,IAAA,UAAK,EAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,KAAK,KAAK,QAAQ,EAAE;gBACtB,OAAO;aACR;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAxBY,oBAAoB;IAJhC,IAAA,gCAAM,EAAC,YAAY,CAAC;IACpB,IAAA,0BAAe,EAAC,aAAa,EAAE,IAAI,sBAAY,CAAC,MAAM,CAAC,EAAE;QACxD,WAAW,EAAE,iCAAiC;KAC/C,CAAC;IAEa,WAAA,IAAA,yBAAc,EAAC,aAAa,CAAC,CAAA;;GAD/B,oBAAoB,CAwBhC;AAxBY,oDAAoB"}

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

@@ -0,0 +1,3 @@
+export * from './config-source.decorator';
+export * from './exceptions';
+export * from './base';

package/dist/config/sources/index.js

@@ -0,0 +1,20 @@
+"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("./config-source.decorator"), exports);
+__exportStar(require("./exceptions"), exports);
+__exportStar(require("./base"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/sources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,+CAA6B;AAC7B,yCAAuB"}

package/dist/config/types.d.ts

@@ -0,0 +1,65 @@
+import type { EnumValue, Primitive, Size, Timespan } from '@rsdk/common';
+export type SourceType = 'static' | 'reloadable';
+export type RawConfigValue = Primitive | Primitive[];
+export type SingleConfigValue = string | number | boolean | Timespan | Size | EnumValue | URL;
+export type ConfigValue = SingleConfigValue | SingleConfigValue[];
+export interface Changes {
+    createdKeys: string[];
+    updatedKeys: string[];
+}
+export interface PropertyOptions<T extends ConfigValue> {
+    /**
+     * Description of configuration property. Will automatically
+     * appear in documentation.
+     */
+    description: string;
+    /**
+     * Providing default value for property effectively makes it optional
+     */
+    defaultValue?: T | undefined;
+}
+export interface PropertyMetadata<T extends ConfigValue = ConfigValue> {
+    key: string;
+    parser: PropertyParser<T>;
+    description: string;
+    /**
+     * Expect that this property will be in env, not in extra source.
+     */
+    expectedInEnv: boolean;
+    defaultValue?: T | undefined;
+}
+export interface SectionMetadata {
+    name: string;
+    properties: Record<string | symbol, PropertyMetadata>;
+    description?: string;
+}
+export interface SourceMetadata {
+    type: SourceType;
+    name: string;
+    description?: string;
+}
+export interface ParserMetadata {
+    type: string;
+    description: string;
+}
+/**
+ * Implement this interface to create more parsers.
+ * For example: email, BigInt, guid etc.
+ *
+ * NOTE: In other modules it is more common to define metadata
+ * via decorators. But this case is a bit different.
+ *
+ * 1. Parser implementations can have constructors with parameters
+ * which will affect it's behaviour. It's will be nice to have it
+ * in metadata, and decorators won't provide this.
+ *
+ * 2. Metadata will be extracted via type() and description() methods
+ * mostly during decorator factories (such as @Property()) code is
+ * executed. Thus output **can** be used in autodoc
+ */
+export interface PropertyParser<T extends ConfigValue = ConfigValue> {
+    type(): string;
+    description(): string;
+    parse(value: RawConfigValue): T;
+}
+export type RawValues = Map<string, RawConfigValue>;

package/dist/config/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/config/vars.class.d.ts

@@ -0,0 +1,19 @@
+import type { Changes, ConfigValue, PropertyMetadata, RawConfigValue, RawValues } from './types';
+export declare enum SetResult {
+    CREATED = 0,
+    UPDATED = 1,
+    UNCHANGED = 2
+}
+export declare class Vars {
+    private readonly prefix;
+    private readonly values;
+    /**
+     * Expecting prefix is already converted to upper snake case
+     * @param prefix
+     */
+    constructor(prefix: string);
+    set(key: string, value: RawConfigValue): [SetResult, string];
+    merge(values: RawValues): Changes;
+    extract<T extends ConfigValue>(propMeta: PropertyMetadata<T>): T | undefined;
+    private toUpperSnakeCase;
+}