@creator.co/wapi 1.2.3 → 1.2.5

package/dist/src/BaseEvent/Transaction.d.ts

@@ -0,0 +1,39 @@
+import type { APIGatewayEvent, Context, SQSEvent } from 'aws-lambda';
+import Request from '../API/Request';
+import Response, { ResponseErrorType } from '../API/Response';
+import type { DatabaseTransactionType, DatabaseType, DbConfig } from '../Database/types';
+import Logger, { LoggerConfig } from '../Logger/Logger';
+import Publisher, { PublisherConfig } from '../Publisher/Publisher';
+export type TransactionExecution<TransactionType, ResponseInnerType, MiscRespType = null> = (transaction: TransactionType) => Promise<Response<ResponseInnerType> | Response<ResponseErrorType> | MiscRespType>;
+export type TransactionConfig = {
+    throwOnErrors?: boolean;
+    syncReturn?: boolean;
+    logger?: LoggerConfig;
+    publisher?: PublisherConfig;
+};
+export default class Transaction<InputType = object, ResponseInnerType = null, MiscRespType = null> {
+    private databaseManager;
+    private transactions;
+    private event;
+    private context;
+    private response;
+    private syncReturn;
+    private retrowErrors;
+    readonly logger: Logger;
+    readonly request: Request<InputType>;
+    readonly publisher: Publisher;
+    responseProxy: (response: Response<ResponseInnerType>) => Promise<void>;
+    constructor(event: APIGatewayEvent | SQSEvent, context: Context, config?: TransactionConfig);
+    execute(executionFunc: TransactionExecution<Transaction<InputType, ResponseInnerType, MiscRespType>, ResponseInnerType, MiscRespType>): Promise<Response<ResponseInnerType | ResponseErrorType> | MiscRespType>;
+    private iexecute;
+    /**
+     * Retrieves a database transaction for the specified database configuration.
+     * @async
+     * @param {DbConfig<S>} config - The configuration object for the database.
+     * @returns {Promise<DatabaseTransactionType<S>>} A promise that resolves to the database transaction.
+     */
+    getDbTransaction<S extends DatabaseType>(config: DbConfig<S>): Promise<DatabaseTransactionType<S>>;
+    private executeDBTransactions;
+    private executeLoggerFlush;
+    private getErrorResponse;
+}

package/dist/src/BaseEvent/Transaction.js

@@ -0,0 +1,354 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var Request_1 = require("../API/Request");
+var Response_1 = require("../API/Response");
+var DatabaseManager_1 = require("../Database/DatabaseManager");
+var Globals_1 = require("../Globals");
+var Logger_1 = require("../Logger/Logger");
+var Publisher_1 = require("../Publisher/Publisher");
+var Transaction = /** @class */ (function () {
+    //
+    function Transaction(event, context, config) {
+        this.databaseManager = DatabaseManager_1.DatabaseManager.INSTANCE;
+        this.transactions = [];
+        var transactionId = context.awsRequestId
+            ? context.awsRequestId
+            : event.requestContext
+                ? event.requestContext.requestId
+                : 'unknown';
+        // transaction ctx
+        this.event = event;
+        this.context = context;
+        this.response = null;
+        // when set, this will be called with the response context right before calling the context suceed/fail - useful for writing the resp for example.
+        this.responseProxy = null;
+        // transaction flags
+        this.syncReturn = !!(config === null || config === void 0 ? void 0 : config.syncReturn);
+        this.retrowErrors = !!(config === null || config === void 0 ? void 0 : config.throwOnErrors); /* retrow internal errors */
+        // components
+        this.logger = new Logger_1.default(config === null || config === void 0 ? void 0 : config.logger, transactionId);
+        this.request = new Request_1.default(this.event, this.context, this.logger);
+        this.publisher = new Publisher_1.default(config === null || config === void 0 ? void 0 : config.publisher);
+    }
+    //Main interface
+    Transaction.prototype.execute = function (executionFunc) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.executeLoggerFlush(function () { return __awaiter(_this, void 0, void 0, function () {
+                            var _this = this;
+                            return __generator(this, function (_a) {
+                                switch (_a.label) {
+                                    case 0: return [4 /*yield*/, this.executeDBTransactions(function () { return __awaiter(_this, void 0, void 0, function () {
+                                            return __generator(this, function (_a) {
+                                                switch (_a.label) {
+                                                    case 0: return [4 /*yield*/, this.iexecute(executionFunc)];
+                                                    case 1: return [2 /*return*/, _a.sent()];
+                                                }
+                                            });
+                                        }); })];
+                                    case 1:
+                                        _a.sent();
+                                        return [2 /*return*/];
+                                }
+                            });
+                        }); })
+                        // return raw response if sync return is requested
+                    ];
+                    case 1:
+                        _a.sent();
+                        // return raw response if sync return is requested
+                        if (this.syncReturn)
+                            return [2 /*return*/, this.response
+                                // allow request to async succeed through lambda context
+                            ];
+                        // allow request to async succeed through lambda context
+                        return [2 /*return*/, null];
+                }
+            });
+        });
+    };
+    //Executions
+    Transaction.prototype.iexecute = function (executionFunc) {
+        return __awaiter(this, void 0, void 0, function () {
+            var executionFailed, _a, e_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        executionFailed = true //failed til we say no!
+                        ;
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 8, , 10]);
+                        //Execute
+                        this.logger.debug('Starting main request code');
+                        _a = this;
+                        return [4 /*yield*/, executionFunc(this)
+                            //Answer client
+                        ];
+                    case 2:
+                        _a.response = _b.sent();
+                        if (!(this.response && this.response instanceof Response_1.default)) return [3 /*break*/, 4];
+                        return [4 /*yield*/, this.response.build(this.context, this, this.syncReturn)];
+                    case 3:
+                        _b.sent();
+                        executionFailed = !!(this.response.getBody() && this.response.getBody()['rollback']);
+                        return [3 /*break*/, 7];
+                    case 4:
+                        if (!(this.syncReturn && this.response)) return [3 /*break*/, 5];
+                        this.logger.log('Sync return with different response object');
+                        this.logger.debug(this.response);
+                        executionFailed = false;
+                        return [3 /*break*/, 7];
+                    case 5:
+                        this.response = this.getErrorResponse(Globals_1.default.ErrorResponseInvalidServerResponse, Globals_1.default.ErrorCode_APIError);
+                        return [4 /*yield*/, this.response.build(this.context, this, this.syncReturn)];
+                    case 6:
+                        _b.sent();
+                        this.logger.error('Invalid response object from main request code.');
+                        _b.label = 7;
+                    case 7: return [3 /*break*/, 10];
+                    case 8:
+                        e_1 = _b.sent();
+                        /*EXECUTION FAIL*/
+                        this.logger.error('Exception when executing main request code.');
+                        this.logger.exception(e_1);
+                        //retrow?
+                        if (this.retrowErrors)
+                            throw e_1;
+                        //envelope exception?
+                        this.response = this.getErrorResponse(Globals_1.default.ErrorResponseUnhandledError, Globals_1.default.ErrorCode_APIError);
+                        return [4 /*yield*/, this.response.build(this.context, this, this.syncReturn)];
+                    case 9:
+                        _b.sent();
+                        return [3 /*break*/, 10];
+                    case 10: return [2 /*return*/, executionFailed];
+                }
+            });
+        });
+    };
+    /**
+     * Retrieves a database transaction for the specified database configuration.
+     * @async
+     * @param {DbConfig<S>} config - The configuration object for the database.
+     * @returns {Promise<DatabaseTransactionType<S>>} A promise that resolves to the database transaction.
+     */
+    Transaction.prototype.getDbTransaction = function (config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var db, dbTrans;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        db = this.databaseManager.create(config);
+                        return [4 /*yield*/, db.transaction()];
+                    case 1:
+                        dbTrans = _a.sent();
+                        this.transactions.push(dbTrans);
+                        return [2 /*return*/, dbTrans];
+                }
+            });
+        });
+    };
+    Transaction.prototype.executeDBTransactions = function (safeExecution) {
+        return __awaiter(this, void 0, void 0, function () {
+            var execFailed, _a, _b, transaction, e_2, e_3_1, e_4, _c, _d, transaction, e_5, e_6_1;
+            var e_3, _e, e_6, _f;
+            return __generator(this, function (_g) {
+                switch (_g.label) {
+                    case 0:
+                        _g.trys.push([0, 12, , 23]);
+                        return [4 /*yield*/, safeExecution()];
+                    case 1:
+                        execFailed = _g.sent();
+                        _g.label = 2;
+                    case 2:
+                        _g.trys.push([2, 9, 10, 11]);
+                        _a = __values(__spreadArray([], __read(this.transactions), false).reverse()), _b = _a.next();
+                        _g.label = 3;
+                    case 3:
+                        if (!!_b.done) return [3 /*break*/, 8];
+                        transaction = _b.value;
+                        _g.label = 4;
+                    case 4:
+                        _g.trys.push([4, 6, , 7]);
+                        return [4 /*yield*/, transaction[execFailed ? 'closeFailure' : 'closeSuccess']()];
+                    case 5:
+                        _g.sent();
+                        return [3 /*break*/, 7];
+                    case 6:
+                        e_2 = _g.sent();
+                        // TODO: should we keep committing transactions even if one fails?
+                        this.logger.error('Exception when closing DB transactions after success.');
+                        this.logger.exception(e_2);
+                        return [3 /*break*/, 7];
+                    case 7:
+                        _b = _a.next();
+                        return [3 /*break*/, 3];
+                    case 8: return [3 /*break*/, 11];
+                    case 9:
+                        e_3_1 = _g.sent();
+                        e_3 = { error: e_3_1 };
+                        return [3 /*break*/, 11];
+                    case 10:
+                        try {
+                            if (_b && !_b.done && (_e = _a.return)) _e.call(_a);
+                        }
+                        finally { if (e_3) throw e_3.error; }
+                        return [7 /*endfinally*/];
+                    case 11: return [3 /*break*/, 23];
+                    case 12:
+                        e_4 = _g.sent();
+                        _g.label = 13;
+                    case 13:
+                        _g.trys.push([13, 20, 21, 22]);
+                        _c = __values(__spreadArray([], __read(this.transactions), false).reverse()), _d = _c.next();
+                        _g.label = 14;
+                    case 14:
+                        if (!!_d.done) return [3 /*break*/, 19];
+                        transaction = _d.value;
+                        _g.label = 15;
+                    case 15:
+                        _g.trys.push([15, 17, , 18]);
+                        return [4 /*yield*/, transaction.closeFailure()];
+                    case 16:
+                        _g.sent();
+                        return [3 /*break*/, 18];
+                    case 17:
+                        e_5 = _g.sent();
+                        this.logger.error('Exception when closing DB transactions after failure.');
+                        this.logger.exception(e_5);
+                        return [3 /*break*/, 18];
+                    case 18:
+                        _d = _c.next();
+                        return [3 /*break*/, 14];
+                    case 19: return [3 /*break*/, 22];
+                    case 20:
+                        e_6_1 = _g.sent();
+                        e_6 = { error: e_6_1 };
+                        return [3 /*break*/, 22];
+                    case 21:
+                        try {
+                            if (_d && !_d.done && (_f = _c.return)) _f.call(_c);
+                        }
+                        finally { if (e_6) throw e_6.error; }
+                        return [7 /*endfinally*/];
+                    case 22:
+                        this.logger.error('Exception when executing DB transactions.');
+                        this.logger.log(e_4.stack);
+                        //retrow?
+                        if (this.retrowErrors)
+                            throw e_4;
+                        return [3 /*break*/, 23];
+                    case 23: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Transaction.prototype.executeLoggerFlush = function (safeExecution) {
+        return __awaiter(this, void 0, void 0, function () {
+            var e_7;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, 3, 4]);
+                        return [4 /*yield*/, safeExecution()];
+                    case 1:
+                        _a.sent();
+                        return [3 /*break*/, 4];
+                    case 2:
+                        e_7 = _a.sent();
+                        this.logger.error('Exception when flushing logs.');
+                        this.logger.exception(e_7);
+                        //retrow?
+                        if (this.retrowErrors)
+                            throw e_7;
+                        return [3 /*break*/, 4];
+                    case 3:
+                        this.logger.debug('Transaction ended');
+                        return [7 /*endfinally*/];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /* Response support */
+    Transaction.prototype.getErrorResponse = function (error, code) {
+        return Response_1.default.BadRequestResponseWithRollback(error, code);
+    };
+    return Transaction;
+}());
+exports.default = Transaction;
+//# sourceMappingURL=Transaction.js.map

package/dist/src/BaseEvent/Transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction.js","sourceRoot":"","sources":["../../../src/BaseEvent/Transaction.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,0CAAoC;AACpC,4CAA6D;AAC7D,+DAA6D;AAG7D,sCAAgC;AAChC,2CAAuD;AACvD,oDAAmE;AAenE;IAkBE,EAAE;IACF,qBAAY,KAAiC,EAAE,OAAgB,EAAE,MAA0B;QAdnF,oBAAe,GAAoB,iCAAe,CAAC,QAAQ,CAAA;QAC3D,iBAAY,GAA0B,EAAE,CAAA;QAc9C,IAAM,aAAa,GAAG,OAAO,CAAC,YAAY;YACxC,CAAC,CAAC,OAAO,CAAC,YAAY;YACtB,CAAC,CAAmB,KAAM,CAAC,cAAc;gBACzC,CAAC,CAAmB,KAAM,CAAC,cAAc,CAAC,SAAS;gBACnD,CAAC,CAAC,SAAS,CAAA;QACb,kBAAkB;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,kJAAkJ;QAClJ,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,oBAAoB;QACpB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,UAAU,CAAA,CAAA;QACtC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,aAAa,CAAA,CAAA,CAAC,4BAA4B;QACxE,aAAa;QACb,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAM,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,EAAE,aAAa,CAAC,CAAA;QACvD,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,CAAY,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5E,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAS,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,SAAS,CAAC,CAAA;IACnD,CAAC;IAED,gBAAgB;IACH,6BAAO,GAApB,UACE,aAIC;;;;;4BAED,qBAAM,IAAI,CAAC,kBAAkB,CAAC;;;;4CAC5B,qBAAM,IAAI,CAAC,qBAAqB,CAAC;;;4DACxB,qBAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAA;4DAAzC,sBAAO,SAAkC,EAAA;;;6CAC1C,CAAC,EAAA;;wCAFF,SAEE,CAAA;;;;6BACH,CAAC;wBACF,kDAAkD;sBADhD;;wBAJF,SAIE,CAAA;wBACF,kDAAkD;wBAClD,IAAI,IAAI,CAAC,UAAU;4BAAE,sBAAO,IAAI,CAAC,QAAQ;gCACzC,wDAAwD;8BADf;wBACzC,wDAAwD;wBACxD,sBAAO,IAAI,EAAA;;;;KACZ;IAED,YAAY;IACE,8BAAQ,GAAtB,UACE,aAIC;;;;;;wBAEG,eAAe,GAAG,IAAI,CAAC,uBAAuB;wBAAxB,CAAA;;;;wBAGxB,SAAS;wBACT,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;wBAC/C,KAAA,IAAI,CAAA;wBAAY,qBAAM,aAAa,CAAC,IAAI,CAAC;4BACzC,eAAe;0BAD0B;;wBAAzC,GAAK,QAAQ,GAAG,SAAyB,CAAA;6BAErC,CAAA,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,YAAY,kBAAQ,CAAA,EAAlD,wBAAkD;wBACpD,qBAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,EAAA;;wBAA9D,SAA8D,CAAA;wBAC9D,eAAe,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;;;6BAC3E,CAAA,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAA,EAAhC,wBAAgC;wBACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAA;wBAC7D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;wBAChC,eAAe,GAAG,KAAK,CAAA;;;wBAEvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CACnC,iBAAO,CAAC,kCAAkC,EAC1C,iBAAO,CAAC,kBAAkB,CAC3B,CAAA;wBACD,qBAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,EAAA;;wBAA9D,SAA8D,CAAA;wBAC9D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAA;;;;;wBAGtE,kBAAkB;wBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAA;wBAChE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAC,CAAC,CAAA;wBACxB,SAAS;wBACT,IAAI,IAAI,CAAC,YAAY;4BAAE,MAAM,GAAC,CAAA;wBAC9B,qBAAqB;wBACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CACnC,iBAAO,CAAC,2BAA2B,EACnC,iBAAO,CAAC,kBAAkB,CAC3B,CAAA;wBACD,qBAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,EAAA;;wBAA9D,SAA8D,CAAA;;6BAEhE,sBAAO,eAAe,EAAA;;;;KACvB;IAED;;;;;OAKG;IACU,sCAAgB,GAA7B,UACE,MAAmB;;;;;;wBAEb,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;wBAC9B,qBAAM,EAAE,CAAC,WAAW,EAAE,EAAA;;wBAAhC,OAAO,GAAG,SAAsB;wBACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;wBAC/B,sBAAO,OAAc,EAAA;;;;KACtB;IAEa,2CAAqB,GAAnC,UAAoC,aAAqC;;;;;;;;wBAGlD,qBAAM,aAAa,EAAE,EAAA;;wBAAlC,UAAU,GAAG,SAAqB;;;;wBACd,KAAA,SAAA,yBAAI,IAAI,CAAC,YAAY,UAAE,OAAO,EAAE,CAAA;;;;wBAA/C,WAAW;;;;wBAElB,qBAAM,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,EAAA;;wBAAjE,SAAiE,CAAA;;;;wBAEjE,kEAAkE;wBAClE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAA;wBAC1E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAC,CAAC,CAAA;;;;;;;;;;;;;;;;;;;;;;wBAMF,KAAA,SAAA,yBAAI,IAAI,CAAC,YAAY,UAAE,OAAO,EAAE,CAAA;;;;wBAA/C,WAAW;;;;wBAElB,qBAAM,WAAW,CAAC,YAAY,EAAE,EAAA;;wBAAhC,SAAgC,CAAA;;;;wBAEhC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAA;wBAC1E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAC,CAAC,CAAA;;;;;;;;;;;;;;;;;wBAG5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;wBAC9D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAC,CAAC,KAAK,CAAC,CAAA;wBACxB,SAAS;wBACT,IAAI,IAAI,CAAC,YAAY;4BAAE,MAAM,GAAC,CAAA;;;;;;KAEjC;IAEa,wCAAkB,GAAhC,UAAiC,aAAa;;;;;;;wBAE1C,qBAAM,aAAa,EAAE,EAAA;;wBAArB,SAAqB,CAAA;;;;wBAErB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;wBAClD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAC,CAAC,CAAA;wBACxB,SAAS;wBACT,IAAI,IAAI,CAAC,YAAY;4BAAE,MAAM,GAAC,CAAA;;;wBAE9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;;;;;;KAEzC;IAED,sBAAsB;IACd,sCAAgB,GAAxB,UAAyB,KAAa,EAAE,IAAY;QAClD,OAAO,kBAAQ,CAAC,8BAA8B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC7D,CAAC;IACH,kBAAC;AAAD,CAAC,AAxKD,IAwKC"}

package/dist/src/Config/Configuration.d.ts

@@ -0,0 +1,131 @@
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @typedef {ConfigurationSchema}
+ */
+export type ConfigurationSchema = {
+    [name: string]: {
+        isLocal?: boolean;
+        isRemote?: boolean;
+        required?: boolean;
+        cachingPolicy?: string;
+    };
+};
+/**
+ * ${1:Description placeholder}
+ *
+ * @typedef {ExtractRemote}
+ * @template Type
+ */
+type ExtractRemote<Type> = {
+    [Property in keyof Type]-?: Type[Property] extends {
+        isRemote: true;
+    } ? Property : null;
+};
+/**
+ * ${1:Description placeholder}
+ *
+ * @typedef {ExtractLocal}
+ * @template Type
+ */
+type ExtractLocal<Type> = {
+    [Property in keyof Type]-?: Type[Property] extends {
+        isLocal: true;
+    } ? Property : null;
+};
+/**
+ * ${1:Description placeholder}
+ *
+ * @typedef {OmitKeysByValueType}
+ * @template T
+ * @template U
+ */
+type OmitKeysByValueType<T, U> = {
+    [P in keyof T]: T[P] extends U ? never : P;
+}[keyof T];
+/**
+ * ${1:Description placeholder}
+ *
+ * @typedef {OmitByValueType}
+ * @template T
+ * @template V
+ */
+type OmitByValueType<T, V> = T extends infer _ ? {
+    [key in OmitKeysByValueType<T, V>]: T[key];
+} : never;
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @class Configuration
+ * @typedef {Configuration}
+ * @template {ConfigurationSchema} T
+ */
+export default class Configuration<T extends ConfigurationSchema> {
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @readonly
+     * @type {T}
+     */
+    private readonly schema;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @readonly
+     * @type {string}
+     */
+    private readonly remotePrefix;
+    /**
+     * Creates an instance of Configuration.
+     *
+     * @constructor
+     * @param {T} schema
+     * @param {string} remotePrefix
+     */
+    constructor(schema: T, remotePrefix: string);
+    /**
+     * ${1:Description placeholder}
+     *
+     * @public
+     * @param {keyof OmitByValueType<ExtractLocal<T>, null>} propName
+     * @returns {*}
+     */
+    get(propName: keyof OmitByValueType<ExtractLocal<T>, null>): any;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @public
+     * @async
+     * @param {keyof OmitByValueType<ExtractRemote<T>, null>} propName
+     * @returns {Promise<any>}
+     */
+    asyncGet(propName: keyof OmitByValueType<ExtractRemote<T>, null>): Promise<any>;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @param {string} valueKey
+     * @returns {*}
+     */
+    private getCachedValue;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @param {string} valueKey
+     * @param {*} value
+     * @param {string} [policy="1d"]
+     */
+    private cacheValue;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     */
+    private resetCache;
+}
+export {};