@creator.co/wapi 1.2.3 → 1.2.5

package/dist/src/Server/lib/container/Proxy.d.ts

@@ -0,0 +1,95 @@
+import Server from './../Server';
+import { RouterConfig } from '../../Router';
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @class Proxy
+ * @typedef {Proxy}
+ */
+export default class Proxy {
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @type {boolean}
+     */
+    private stopping;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @readonly
+     * @type {RouterConfig}
+     */
+    private readonly config;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @readonly
+     * @type {express.Express}
+     */
+    private readonly app;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @readonly
+     * @type {Server["handleServerlessEvent"]}
+     */
+    private readonly serverlessHandler;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @type {HTTPServer}
+     */
+    private listener;
+    /**
+     * Creates an instance of Proxy.
+     *
+     * @constructor
+     * @param {RouterConfig} config
+     * @param {Server["handleServerlessEvent"]} serverlessHandler
+     */
+    constructor(config: RouterConfig, serverlessHandler: Server['handleServerlessEvent']);
+    /**
+     * ${1:Description placeholder}
+     *
+     * @async
+     * @returns {*}
+     */
+    load(): Promise<void>;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @async
+     * @param {?*} [err]
+     * @returns {*}
+     */
+    unload(err?: any): Promise<void>;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @async
+     * @returns {Promise<void>}
+     */
+    private startListeners;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @async
+     * @param {?*} [err]
+     * @returns {unknown}
+     */
+    private stopListeners;
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     */
+    private installRoutes;
+}

package/dist/src/Server/lib/container/Proxy.js

@@ -0,0 +1,202 @@
+"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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var http_1 = require("http");
+var cors = require("cors");
+var express = require("express");
+var GenericHandler_1 = require("./GenericHandler");
+var HealthHandler_1 = require("./HealthHandler");
+var package_json_1 = require("../../../../package.json");
+var Utils_1 = require("../../../API/Utils");
+var Globals_1 = require("../../../Globals");
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @class Proxy
+ * @typedef {Proxy}
+ */
+var Proxy = /** @class */ (function () {
+    /**
+     * Creates an instance of Proxy.
+     *
+     * @constructor
+     * @param {RouterConfig} config
+     * @param {Server["handleServerlessEvent"]} serverlessHandler
+     */
+    function Proxy(config, serverlessHandler) {
+        this.stopping = false;
+        this.config = config;
+        this.serverlessHandler = serverlessHandler;
+        this.app = express();
+        /* Opinionated Express configs */
+        this.app.use(express.json());
+        // apply cors config
+        var corsConfig = this.config.cors || Utils_1.default.parseObjectNullIfEmpty(process.env.CORS);
+        this.app.use(cors(corsConfig
+            ? {
+                origin: corsConfig.origin,
+                allowedHeaders: corsConfig.headers,
+                credentials: !!corsConfig.allowCredentials,
+            }
+            : {}));
+        // //This supposedly fix some 502 codes where nodejs socket would hang during
+        // //a request and if behind ALB, it would cause 502 codes. Had experiencied this
+        // //and 502 codes reduced dramastically, but still some appearances. Maybe this
+        // //is just a palliative work-around for the real issue; TODO: need to investigate
+        // //in the future.
+        // this.listener.listener.keepAliveTimeout = 120e3
+        // this.listener.listener.headersTimeout = 120e3
+    }
+    /**
+     * ${1:Description placeholder}
+     *
+     * @async
+     * @returns {*}
+     */
+    Proxy.prototype.load = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.startListeners()];
+                    case 1:
+                        _a.sent();
+                        this.installRoutes();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * ${1:Description placeholder}
+     *
+     * @async
+     * @param {?*} [err]
+     * @returns {*}
+     */
+    Proxy.prototype.unload = function (err) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.stopListeners(err)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /* lifecycle */
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @async
+     * @returns {Promise<void>}
+     */
+    Proxy.prototype.startListeners = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                return [2 /*return*/, new Promise(function (resolve) {
+                        var port = _this.config.port || Globals_1.default.Listener_HTTP_DefaultPort;
+                        console.log("[Proxy] - [STARTING] - v.".concat(package_json_1.version, " - :").concat(port));
+                        // Create Server
+                        _this.listener = (0, http_1.createServer)(_this.app);
+                        // Set defaults
+                        _this.listener.setTimeout(_this.config.timeout || Globals_1.default.Listener_HTTP_DefaultTimeout);
+                        // Start Server
+                        _this.listener.listen(port, function () {
+                            console.log("[Proxy] - [STARTED]");
+                            resolve();
+                        });
+                    })];
+            });
+        });
+    };
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     * @async
+     * @param {?*} [err]
+     * @returns {unknown}
+     */
+    Proxy.prototype.stopListeners = function (err) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                if (this.stopping)
+                    return [2 /*return*/];
+                this.stopping = true;
+                console.debug('[Proxy] - [STOPPING]');
+                return [2 /*return*/, new Promise(function (resolve) {
+                        _this.listener.close(function (_err) {
+                            var err2 = err || _err;
+                            if (err2)
+                                console.log('[Proxy] - exit output:', err2);
+                            console.log('[Proxy] - [STOPPED]');
+                            process.exit(err || _err ? 1 : 0);
+                            resolve(null);
+                        });
+                    })];
+            });
+        });
+    };
+    /* routing */
+    /**
+     * ${1:Description placeholder}
+     *
+     * @private
+     */
+    Proxy.prototype.installRoutes = function () {
+        //Health check route -- This is a bypass route to only check if
+        //runtime proxy is working and responding to calls.
+        console.log("[Proxy] - [HEALTH-ROUTE] - ".concat(this.config.healthCheckRoute || Globals_1.default.Listener_HTTP_DefaultHealthCheckRoute));
+        this.app
+            .route(this.config.healthCheckRoute || Globals_1.default.Listener_HTTP_DefaultHealthCheckRoute)
+            .get(HealthHandler_1.default);
+        //Main route -- We use a wildcard route because is not the job of the runtime and neither
+        //the task to deny/constrain routes that invoked this task; all the job is done by the
+        //load balancer and we just foward everything we have to the function.
+        this.app.route(Globals_1.default.Listener_HTTP_ProxyRoute).all((0, GenericHandler_1.default)(this.serverlessHandler));
+    };
+    return Proxy;
+}());
+exports.default = Proxy;
+//# sourceMappingURL=Proxy.js.map

package/dist/src/Server/lib/container/Proxy.js.map

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

package/dist/src/Server/lib/container/Utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @param {string} url
+ * @returns {*}
+ */
+export declare function parseMultiValueQueryStringParameters(url: string): any;
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @param {*} url
+ * @returns {*}
+ */
+export declare function parseQueryStringParameters(url: any): {
+    [k: string]: string;
+};

package/dist/src/Server/lib/container/Utils.js

@@ -0,0 +1,84 @@
+"use strict";
+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.");
+};
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseQueryStringParameters = exports.parseMultiValueQueryStringParameters = void 0;
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @param {string} url
+ * @returns {*}
+ */
+function parseMultiValueQueryStringParameters(url) {
+    var e_1, _a;
+    // dummy placeholder url for the WHATWG URL constructor
+    // https://github.com/nodejs/node/issues/12682
+    var searchParams = new URL(url, 'http://example').searchParams;
+    //
+    if (Array.from(searchParams).length === 0)
+        return {};
+    var map = new Map();
+    try {
+        // eslint-disable-next-line no-restricted-syntax
+        for (var searchParams_1 = __values(searchParams), searchParams_1_1 = searchParams_1.next(); !searchParams_1_1.done; searchParams_1_1 = searchParams_1.next()) {
+            var _b = __read(searchParams_1_1.value, 2), key = _b[0], value = _b[1];
+            var item = map.get(key);
+            if (item)
+                item.push(value);
+            else
+                map.set(key, [value]);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (searchParams_1_1 && !searchParams_1_1.done && (_a = searchParams_1.return)) _a.call(searchParams_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return Object.fromEntries(map);
+}
+exports.parseMultiValueQueryStringParameters = parseMultiValueQueryStringParameters;
+/**
+ * ${1:Description placeholder}
+ *
+ * @export
+ * @param {*} url
+ * @returns {*}
+ */
+function parseQueryStringParameters(url) {
+    // dummy placeholder url for the WHATWG URL constructor
+    // https://github.com/nodejs/node/issues/12682
+    var searchParams = new URL(url, 'http://example').searchParams;
+    if (Array.from(searchParams).length === 0)
+        return null;
+    return Object.fromEntries(searchParams);
+}
+exports.parseQueryStringParameters = parseQueryStringParameters;
+//# sourceMappingURL=Utils.js.map

package/dist/src/Server/lib/container/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../../../../src/Server/lib/container/Utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,SAAgB,oCAAoC,CAAC,GAAW;;IAC9D,uDAAuD;IACvD,8CAA8C;IACtC,IAAA,YAAY,GAAK,IAAI,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,aAAnC,CAAmC;IACvD,EAAE;IACF,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpD,IAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;;QACrB,gDAAgD;QAChD,KAA2B,IAAA,iBAAA,SAAA,YAAY,CAAA,0CAAA,oEAAE;YAA9B,IAAA,KAAA,iCAAY,EAAX,GAAG,QAAA,EAAE,KAAK,QAAA;YACpB,IAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACzB,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;;gBACrB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;SAC3B;;;;;;;;;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAdD,oFAcC;AACD;;;;;;GAMG;AACH,SAAgB,0BAA0B,CAAC,GAAG;IAC5C,uDAAuD;IACvD,8CAA8C;IACtC,IAAA,YAAY,GAAK,IAAI,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,aAAnC,CAAmC;IACvD,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtD,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;AACzC,CAAC;AAND,gEAMC"}

package/dist/src/Validation/Validator.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import Response, { ResponseErrorType } from '../API/Response';
+/**
+ * Description placeholder
+ *
+ * @export
+ * @class Validator
+ * @typedef {Validator}
+ */
+export default class Validator {
+    /**
+     * Description placeholder
+     *
+     * @public
+     * @static
+     * @param {*} data
+     * @param {z.ZodObject<any>} schema
+     * @returns {(boolean | Response<ResponseErrorType>)}
+     */
+    static validateSchema(data: any, schema: z.ZodObject<any>): boolean | Response<ResponseErrorType>;
+}

package/dist/src/Validation/Validator.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var zod_1 = require("zod");
+var Response_1 = require("../API/Response");
+var Globals_1 = require("../Globals");
+/**
+ * Description placeholder
+ *
+ * @export
+ * @class Validator
+ * @typedef {Validator}
+ */
+var Validator = /** @class */ (function () {
+    function Validator() {
+    }
+    /**
+     * Description placeholder
+     *
+     * @public
+     * @static
+     * @param {*} data
+     * @param {z.ZodObject<any>} schema
+     * @returns {(boolean | Response<ResponseErrorType>)}
+     */
+    Validator.validateSchema = function (data, schema) {
+        var error, validatedInput;
+        // Validate body against known zod schema
+        try {
+            validatedInput = schema.parse(data);
+        }
+        catch (err) {
+            if (err instanceof zod_1.z.ZodError)
+                error = JSON.parse(err.message);
+            else
+                error = 'Unknown validation error!'; //unhandled case, hard to test
+        }
+        // Error validation
+        if (!validatedInput || error) {
+            return Response_1.default.BadRequestResponse(Globals_1.default.ErrorResponseValidationFail, Globals_1.default.ErrorCode_InvalidInput, { validationFailure: error });
+        }
+        else {
+            return true;
+        }
+    };
+    return Validator;
+}());
+exports.default = Validator;
+//# sourceMappingURL=Validator.js.map

package/dist/src/Validation/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../../src/Validation/Validator.ts"],"names":[],"mappings":";;AAAA,2BAAuB;AAEvB,4CAA6D;AAC7D,sCAAgC;AAEhC;;;;;;GAMG;AACH;IAAA;IAiCA,CAAC;IAhCC;;;;;;;;OAQG;IACW,wBAAc,GAA5B,UACE,IAAS,EACT,MAAwB;QAExB,IAAI,KAAK,EAAE,cAAc,CAAA;QACzB,yCAAyC;QACzC,IAAI;YACF,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAA;SACrD;QAAC,OAAO,GAAqB,EAAE;YAC9B,IAAI,GAAG,YAAY,OAAC,CAAC,QAAQ;gBAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;;gBACzD,KAAK,GAAG,2BAA2B,CAAA,CAAC,8BAA8B;SACxE;QACD,mBAAmB;QACnB,IAAI,CAAC,cAAc,IAAI,KAAK,EAAE;YAC5B,OAAO,kBAAQ,CAAC,kBAAkB,CAChC,iBAAO,CAAC,2BAA2B,EACnC,iBAAO,CAAC,sBAAsB,EAC9B,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAC7B,CAAA;SACF;aAAM;YACL,OAAO,IAAI,CAAA;SACZ;IACH,CAAC;IACH,gBAAC;AAAD,CAAC,AAjCD,IAiCC"}

package/jest.config.ts

@@ -18,15 +18,8 @@ const config: Config.InitialOptions = {
       },
     ],
   ],
-  coverageReporters: [
-    'clover',
-    'json',
-    'lcov',
-    'text',
-    ['text', { file: 'coverage.txt' }],
-    'json-summary',
-  ],
-  collectCoverageFrom: ['src/**/*.(t|j)s'],
+  coverageReporters: ['clover', 'json', 'lcov', ['text', { file: 'coverage.txt' }], 'json-summary'],
+  collectCoverageFrom: ['src/**/*.(t|j)s', '!src/**/*.d.(t|j)s'],
   coverageThreshold: {
     global: {
       branches: 80,

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@creator.co/wapi",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
   "scripts": {
-    "build": "npm run lint && tsc --build",
+    "build": "tsc --build",
     "clean": "tsc --build --clean",
     "lint-fix": "eslint . --ext .ts --fix",
     "lint": "eslint . --ext .ts",
-    "test": "jest --coverage --silent --runInBand",
-    "test-dev": "jest --coverage --runInBand"
+    "test": "jest --coverage --silent --runInBand && cat coverage/coverage.txt",
+    "test-dev": "jest --coverage --runInBand && cat coverage/coverage.txt"
   },
   "author": "",
   "license": "ISC",
@@ -24,6 +24,7 @@
     "@aws-sdk/credential-provider-node": "^3.414.0",
     "@types/email-templates": "^10.0.1",
     "@types/nodemailer": "^6.4.10",
+    "@types/object-hash": "^3.0.4",
     "abind": "^1.0.5",
     "cors": "^2.8.5",
     "cuid": "^3.0.0",
@@ -32,18 +33,23 @@
     "express": "^4.18.2",
     "json-stringify-safe": "^5.0.1",
     "jsonwebtoken": "^9.0.2",
+    "knex": "^3.0.1",
     "node-cache": "^5.1.2",
+    "object-hash": "^3.0.0",
     "parse-duration": "^1.1.0",
+    "pg": "^8.11.3",
     "sha1": "^1.1.1",
     "stack-trace": "0.0.10",
     "zod": "^3.22.4"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.119",
+    "@types/chai": "^4.3.9",
     "@types/express": "^4.17.19",
     "@types/jest": "^29.5.6",
     "@types/jsonwebtoken": "^9.0.3",
     "@types/node": "^20.5.7",
+    "@types/pg": "^8.10.5",
     "@typescript-eslint/eslint-plugin": "^6.5.0",
     "@typescript-eslint/parser": "^6.5.0",
     "aws-lambda": "^1.0.7",

package/src/BaseEvent/Transaction.ts

@@ -2,6 +2,9 @@ import type { APIGatewayEvent, Context, SQSEvent } from 'aws-lambda'
 
 import Request from '../API/Request'
 import Response, { ResponseErrorType } from '../API/Response'
+import { DatabaseManager } from '../Database/DatabaseManager'
+import { DatabaseTransaction } from '../Database/DatabaseTransaction'
+import type { DatabaseTransactionType, DatabaseType, DbConfig } from '../Database/types'
 import Globals from '../Globals'
 import Logger, { LoggerConfig } from '../Logger/Logger'
 import Publisher, { PublisherConfig } from '../Publisher/Publisher'
@@ -24,6 +27,8 @@ export default class Transaction<
   ResponseInnerType = null,
   MiscRespType = null,
 > {
+  private databaseManager: DatabaseManager = DatabaseManager.INSTANCE
+  private transactions: DatabaseTransaction[] = []
   private event: any
   private context: Context
   private response: Response<ResponseInnerType | ResponseErrorType> | MiscRespType | null
@@ -34,6 +39,7 @@ export default class Transaction<
   public readonly request: Request<InputType>
   public readonly publisher: Publisher
   public responseProxy: (response: Response<ResponseInnerType>) => Promise<void>
+
   //
   constructor(event: APIGatewayEvent | SQSEvent, context: Context, config?: TransactionConfig) {
     const transactionId = context.awsRequestId
@@ -74,6 +80,7 @@ export default class Transaction<
     // allow request to async succeed through lambda context
     return null
   }
+
   //Executions
   private async iexecute(
     executionFunc: TransactionExecution<
@@ -119,32 +126,54 @@ export default class Transaction<
     }
     return executionFailed
   }
-  private async executeDBTransactions(safeExecution) {
+
+  /**
+   * 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.
+   */
+  public async getDbTransaction<S extends DatabaseType>(
+    config: DbConfig<S>
+  ): Promise<DatabaseTransactionType<S>> {
+    const db = this.databaseManager.create(config)
+    const dbTrans = await db.transaction()
+    this.transactions.push(dbTrans)
+    return dbTrans as any
+  }
+
+  private async executeDBTransactions(safeExecution: () => Promise<boolean>): Promise<void> {
     try {
-      // //start DB
-      // if (this.db) await this.db.connect();
-      // //start transaction
-      // if (this.db) await this.db.beginTransaction();
-      // //
-      // let executionFailed =
-      await safeExecution()
-      // //Commit if not failed, rollback if failed
-      // if (!executionFailed) {
-      //   if (this.db) await this.db.commit();
-      // } else {
-      //   this.logger.log("Rolling back DB transactions. Main code failed!");
-      //   if (this.db) await this.db.rollback();
-      // }
-      // //Cleanup DB after execution
-      // if (this.db) await this.db.cleanup();
+      // Execute
+      const execFailed = await safeExecution()
+      for (const transaction of [...this.transactions].reverse()) {
+        try {
+          await transaction[execFailed ? 'closeFailure' : 'closeSuccess']()
+        } catch (e) {
+          // TODO: should we keep committing transactions even if one fails?
+          this.logger.error('Exception when closing DB transactions after success.')
+          this.logger.exception(e)
+        }
+      }
     } catch (e) {
+      /* this part of the code handle exceptions at transaction level,
+         so probably a bug but we still handle such */
+      for (const transaction of [...this.transactions].reverse()) {
+        try {
+          await transaction.closeFailure()
+        } catch (e) {
+          this.logger.error('Exception when closing DB transactions after failure.')
+          this.logger.exception(e)
+        }
+      }
       this.logger.error('Exception when executing DB transactions.')
       this.logger.log(e.stack)
       //retrow?
       if (this.retrowErrors) throw e
     }
   }
-  private async executeLoggerFlush(safeExecution) {
+
+  private async executeLoggerFlush(safeExecution): Promise<void> {
     try {
       await safeExecution()
     } catch (e) {
@@ -156,6 +185,7 @@ export default class Transaction<
       this.logger.debug('Transaction ended')
     }
   }
+
   /* Response support */
   private getErrorResponse(error: string, code: string): Response<ResponseErrorType> {
     return Response.BadRequestResponseWithRollback(error, code)