node-server-engine 1.0.5

package/dist/middleware/userResolver/userResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userResolver.js","names":["_EngineError","require","_utils","namespace","userResolver","request","response","next","id","user","EngineError","message","data","reportDebug"],"sources":["../../../src/middleware/userResolver/userResolver.ts"],"sourcesContent":["import { Request, Response, NextFunction } from 'express';\nimport { EngineError } from 'entities/EngineError';\nimport { RequestUser } from 'middleware/authJwt/authJwt.types';\nimport { reportDebug } from 'utils';\n\nconst namespace = 'engine:middleware:userResolver';\n\n/** Fetch the user previously identified by a JWT and adds his data to the request.user object */\nexport async function userResolver(\n  request: Request,\n  response: Response,\n  next: NextFunction\n): Promise<void> {\n  const id = request.user?.id;\n  if (!id)\n    throw new EngineError({\n      message: 'Could not resolve user as the request is missing his ID'\n    });\n  const user = { user: 'ram', id };\n  if (!user)\n    throw new EngineError({\n      message: 'Could not resolve user as it could not be fetched',\n      data: { id }\n    });\n  reportDebug({\n    namespace,\n    message: 'Resolved user based on his token',\n    data: { user, request: request.user }\n  });\n  request.user = {\n    ...(request.user as RequestUser),\n    ...user\n  };\n\n  next();\n}\n"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAEA,MAAME,SAAS,GAAG,gCAAgC;;AAElD;AACO,eAAeC,YAAYA,CAChCC,OAAgB,EAChBC,QAAkB,EAClBC,IAAkB,EACH;EACf,MAAMC,EAAE,GAAGH,OAAO,CAACI,IAAI,EAAED,EAAE;EAC3B,IAAI,CAACA,EAAE,EACL,MAAM,IAAIE,wBAAW,CAAC;IACpBC,OAAO,EAAE;EACX,CAAC,CAAC;EACJ,MAAMF,IAAI,GAAG;IAAEA,IAAI,EAAE,KAAK;IAAED;EAAG,CAAC;EAChC,IAAI,CAACC,IAAI,EACP,MAAM,IAAIC,wBAAW,CAAC;IACpBC,OAAO,EAAE,mDAAmD;IAC5DC,IAAI,EAAE;MAAEJ;IAAG;EACb,CAAC,CAAC;EACJ,IAAAK,kBAAW,EAAC;IACVV,SAAS;IACTQ,OAAO,EAAE,kCAAkC;IAC3CC,IAAI,EAAE;MAAEH,IAAI;MAAEJ,OAAO,EAAEA,OAAO,CAACI;IAAK;EACtC,CAAC,CAAC;EACFJ,OAAO,CAACI,IAAI,GAAG;IACb,GAAIJ,OAAO,CAACI,IAAoB;IAChC,GAAGA;EACL,CAAC;EAEDF,IAAI,CAAC,CAAC;AACR","ignoreList":[]}

package/dist/middleware/validate/index.d.ts

@@ -0,0 +1 @@
+export * from './validate';

package/dist/middleware/validate/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _validate = require("./validate");
+Object.keys(_validate).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _validate[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _validate[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/dist/middleware/validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_validate","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sources":["../../../src/middleware/validate/index.ts"],"sourcesContent":["export * from './validate';\n"],"mappings":";;;;;AAAA,IAAAA,SAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,SAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,SAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,SAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/middleware/validate/validate.d.ts

@@ -0,0 +1,4 @@
+import { Request, Response, NextFunction } from 'express';
+import { Schema, ValidationChain } from 'express-validator';
+/** Validate the express-validator results */
+export declare const validate: (config: Schema) => Array<ValidationChain | ((req: Request, res: Response, next: NextFunction) => void)>;

package/dist/middleware/validate/validate.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validate = void 0;
+var _expressValidator = require("express-validator");
+var _ValidationError = require("../../entities/ValidationError");
+/** Validate the express-validator results */
+const validate = config => [...(0, _expressValidator.checkSchema)(config), (req, res, next) => {
+  const result = (0, _expressValidator.validationResult)(req);
+  if (result.isEmpty()) {
+    next();
+    return;
+  }
+  next(new _ValidationError.ValidationError(result));
+}];
+exports.validate = validate;
+//# sourceMappingURL=validate.js.map

package/dist/middleware/validate/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","names":["_expressValidator","require","_ValidationError","validate","config","checkSchema","req","res","next","result","validationResult","isEmpty","ValidationError","exports"],"sources":["../../../src/middleware/validate/validate.ts"],"sourcesContent":["import { Request, Response, NextFunction } from 'express';\nimport {\n  checkSchema,\n  validationResult,\n  Schema,\n  ValidationChain\n} from 'express-validator';\nimport { ValidationError } from 'entities/ValidationError';\n\n/** Validate the express-validator results */\nexport const validate = (\n  config: Schema\n): Array<\n  ValidationChain | ((req: Request, res: Response, next: NextFunction) => void)\n> => [\n  ...checkSchema(config),\n  (req: Request, res: Response, next: NextFunction): void => {\n    const result = validationResult(req);\n    if (result.isEmpty()) {\n      next();\n      return;\n    }\n    next(new ValidationError(result));\n  }\n];\n"],"mappings":";;;;;;AACA,IAAAA,iBAAA,GAAAC,OAAA;AAMA,IAAAC,gBAAA,GAAAD,OAAA;AAEA;AACO,MAAME,QAAQ,GACnBC,MAAc,IAGX,CACH,GAAG,IAAAC,6BAAW,EAACD,MAAM,CAAC,EACtB,CAACE,GAAY,EAAEC,GAAa,EAAEC,IAAkB,KAAW;EACzD,MAAMC,MAAM,GAAG,IAAAC,kCAAgB,EAACJ,GAAG,CAAC;EACpC,IAAIG,MAAM,CAACE,OAAO,CAAC,CAAC,EAAE;IACpBH,IAAI,CAAC,CAAC;IACN;EACF;EACAA,IAAI,CAAC,IAAII,gCAAe,CAACH,MAAM,CAAC,CAAC;AACnC,CAAC,CACF;AAACI,OAAA,CAAAV,QAAA,GAAAA,QAAA","ignoreList":[]}

package/dist/middleware/version/index.d.ts

@@ -0,0 +1 @@
+export * from './version';

package/dist/middleware/version/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _version = require("./version");
+Object.keys(_version).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _version[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _version[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/dist/middleware/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_version","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sources":["../../../src/middleware/version/index.ts"],"sourcesContent":["export * from './version';\n"],"mappings":";;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,QAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,QAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,QAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/middleware/version/version.d.ts

@@ -0,0 +1,6 @@
+import { Router } from 'express';
+/**
+ * Path returning the version of the service
+ * @return {Router}
+ */
+export declare function version(): Router;

package/dist/middleware/version/version.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.version = version;
+var _express = require("express");
+var _package = require("../../../package.json");
+/**
+ * Path returning the version of the service
+ * @return {Router}
+ */
+function version() {
+  return (0, _express.Router)().use('/version', (req, res) => {
+    res.json({
+      version: process.env.BUILD_ID,
+      engineVersion: _package.version
+    });
+  });
+}
+//# sourceMappingURL=version.js.map

package/dist/middleware/version/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","names":["_express","require","_package","version","Router","use","req","res","json","process","env","BUILD_ID","engineVersion"],"sources":["../../../src/middleware/version/version.ts"],"sourcesContent":["import { Router, Request, Response } from 'express';\nimport { version as engineVersion } from '../../../package.json';\n\n/**\n * Path returning the version of the service\n * @return {Router}\n */\nexport function version(): Router {\n  return Router().use('/version', (req: Request, res: Response) => {\n    res.json({ version: process.env.BUILD_ID, engineVersion });\n  });\n}\n"],"mappings":";;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,QAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACO,SAASE,OAAOA,CAAA,EAAW;EAChC,OAAO,IAAAC,eAAM,EAAC,CAAC,CAACC,GAAG,CAAC,UAAU,EAAE,CAACC,GAAY,EAAEC,GAAa,KAAK;IAC/DA,GAAG,CAACC,IAAI,CAAC;MAAEL,OAAO,EAAEM,OAAO,CAACC,GAAG,CAACC,QAAQ;MAAEC,aAAa,EAAbA;IAAc,CAAC,CAAC;EAC5D,CAAC,CAAC;AACJ","ignoreList":[]}

package/dist/utils/checkEnvironment/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensure the process.env is valid using Envalid.
+ * if the validation fails it will log a helpful EngineError.emergency()
+ * and exit the process with status-code 1.
+ * @param validators - Envalid validators
+ */
+export declare function checkEnvironment(validators?: {}): void;
+/**
+ * Ensure the process.env is valid using Envalid.
+ * if the validation fails it will throw a EngineError.emergency()
+ * @param validators - Envalid validators
+ */
+export declare function assertEnvironment(validators?: {}): void;

package/dist/utils/checkEnvironment/index.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.assertEnvironment = assertEnvironment;
+exports.checkEnvironment = checkEnvironment;
+var _envalid = require("envalid");
+var _EngineError = require("../../entities/EngineError");
+var _report = require("../report");
+/**
+ * Create an Envalid reporter
+ * @param shouldExit - should the reporter exit the process on fail
+ * @return Envalid reporter function
+ */
+function createReporter(shouldExit) {
+  return reporter => {
+    const {
+      errors
+    } = reporter;
+    const failedChecks = Object.keys(errors);
+    const message = failedChecks.join(', ');
+    if (failedChecks.length == 0) return;
+    if (shouldExit) {
+      (0, _report.reportError)(new _EngineError.EngineError({
+        message: `Check Environment Failed:  ${message}`,
+        data: failedChecks
+      }));
+      process.exit(1);
+    }
+    throw new _EngineError.EngineError({
+      message: `Check Environment Failed:  ${message}`,
+      data: failedChecks
+    });
+  };
+}
+
+/**
+ * Ensure the process.env is valid using Envalid.
+ * if the validation fails it will log a helpful EngineError.emergency()
+ * and exit the process with status-code 1.
+ * @param validators - Envalid validators
+ */
+function checkEnvironment(validators = {}) {
+  (0, _envalid.cleanEnv)(process.env, validators, {
+    reporter: createReporter(true)
+  });
+}
+
+/**
+ * Ensure the process.env is valid using Envalid.
+ * if the validation fails it will throw a EngineError.emergency()
+ * @param validators - Envalid validators
+ */
+function assertEnvironment(validators = {}) {
+  (0, _envalid.cleanEnv)({
+    ...process.env
+  }, validators, {
+    reporter: createReporter(false)
+  });
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/checkEnvironment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_envalid","require","_EngineError","_report","createReporter","shouldExit","reporter","errors","failedChecks","Object","keys","message","join","length","reportError","EngineError","data","process","exit","checkEnvironment","validators","cleanEnv","env","assertEnvironment"],"sources":["../../../src/utils/checkEnvironment/index.ts"],"sourcesContent":["import { cleanEnv, ReporterOptions } from 'envalid';\nimport { EngineError } from 'entities/EngineError';\nimport { reportError } from 'utils/report';\n\n/**\n * Create an Envalid reporter\n * @param shouldExit - should the reporter exit the process on fail\n * @return Envalid reporter function\n */\nfunction createReporter(shouldExit: boolean) {\n  return (reporter: ReporterOptions<unknown>): void => {\n    const { errors } = reporter;\n    const failedChecks = Object.keys(errors);\n    const message = failedChecks.join(', ');\n    if (failedChecks.length == 0) return;\n    if (shouldExit) {\n      reportError(\n        new EngineError({\n          message: `Check Environment Failed:  ${message}`,\n          data: failedChecks\n        })\n      );\n      process.exit(1);\n    }\n    throw new EngineError({\n      message: `Check Environment Failed:  ${message}`,\n      data: failedChecks\n    });\n  };\n}\n\n/**\n * Ensure the process.env is valid using Envalid.\n * if the validation fails it will log a helpful EngineError.emergency()\n * and exit the process with status-code 1.\n * @param validators - Envalid validators\n */\nexport function checkEnvironment(validators = {}): void {\n  cleanEnv(process.env, validators, { reporter: createReporter(true) });\n}\n\n/**\n * Ensure the process.env is valid using Envalid.\n * if the validation fails it will throw a EngineError.emergency()\n * @param validators - Envalid validators\n */\nexport function assertEnvironment(validators = {}): void {\n  cleanEnv({ ...process.env }, validators, { reporter: createReporter(false) });\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA,SAASG,cAAcA,CAACC,UAAmB,EAAE;EAC3C,OAAQC,QAAkC,IAAW;IACnD,MAAM;MAAEC;IAAO,CAAC,GAAGD,QAAQ;IAC3B,MAAME,YAAY,GAAGC,MAAM,CAACC,IAAI,CAACH,MAAM,CAAC;IACxC,MAAMI,OAAO,GAAGH,YAAY,CAACI,IAAI,CAAC,IAAI,CAAC;IACvC,IAAIJ,YAAY,CAACK,MAAM,IAAI,CAAC,EAAE;IAC9B,IAAIR,UAAU,EAAE;MACd,IAAAS,mBAAW,EACT,IAAIC,wBAAW,CAAC;QACdJ,OAAO,EAAE,8BAA8BA,OAAO,EAAE;QAChDK,IAAI,EAAER;MACR,CAAC,CACH,CAAC;MACDS,OAAO,CAACC,IAAI,CAAC,CAAC,CAAC;IACjB;IACA,MAAM,IAAIH,wBAAW,CAAC;MACpBJ,OAAO,EAAE,8BAA8BA,OAAO,EAAE;MAChDK,IAAI,EAAER;IACR,CAAC,CAAC;EACJ,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASW,gBAAgBA,CAACC,UAAU,GAAG,CAAC,CAAC,EAAQ;EACtD,IAAAC,iBAAQ,EAACJ,OAAO,CAACK,GAAG,EAAEF,UAAU,EAAE;IAAEd,QAAQ,EAAEF,cAAc,CAAC,IAAI;EAAE,CAAC,CAAC;AACvE;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASmB,iBAAiBA,CAACH,UAAU,GAAG,CAAC,CAAC,EAAQ;EACvD,IAAAC,iBAAQ,EAAC;IAAE,GAAGJ,OAAO,CAACK;EAAI,CAAC,EAAEF,UAAU,EAAE;IAAEd,QAAQ,EAAEF,cAAc,CAAC,KAAK;EAAE,CAAC,CAAC;AAC/E","ignoreList":[]}

package/dist/utils/createHttpServer/createHttpServer.d.ts

@@ -0,0 +1,5 @@
+import { RequestListener, Server } from 'http';
+import { Server as SecureServer } from 'https';
+import { Application } from 'express';
+/** Create and configure an http/https server */
+export declare function createHttpServer(handler?: Application | RequestListener): Server | SecureServer;

package/dist/utils/createHttpServer/createHttpServer.js

@@ -0,0 +1,30 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createHttpServer = createHttpServer;
+var _fs = _interopRequireDefault(require("fs"));
+var _http = require("http");
+var _https = require("https");
+var _createHttpServer = require("./createHttpServer.validate");
+/** Create and configure an http/https server */
+function createHttpServer(handler) {
+  // Validate the environment variables
+  (0, _createHttpServer.validateHttpEnvironment)();
+  // Create a https server if env var are specified
+  if (process.env.TLS_SERVER_KEY && process.env.TLS_SERVER_CERT) {
+    return (0, _https.createServer)({
+      key: _fs.default.readFileSync(process.env.TLS_SERVER_KEY),
+      passphrase: process.env.TLS_SERVER_KEY_PASSPHRASE,
+      cert: _fs.default.readFileSync(process.env.TLS_SERVER_CERT),
+      ca: process.env.TLS_CA ? _fs.default.readFileSync(process.env.TLS_CA) : undefined,
+      requestCert: true,
+      rejectUnauthorized: false
+    }, handler);
+  } else {
+    return (0, _http.createServer)(handler);
+  }
+}
+//# sourceMappingURL=createHttpServer.js.map

package/dist/utils/createHttpServer/createHttpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHttpServer.js","names":["_fs","_interopRequireDefault","require","_http","_https","_createHttpServer","createHttpServer","handler","validateHttpEnvironment","process","env","TLS_SERVER_KEY","TLS_SERVER_CERT","createSecureServer","key","fs","readFileSync","passphrase","TLS_SERVER_KEY_PASSPHRASE","cert","ca","TLS_CA","undefined","requestCert","rejectUnauthorized","createServer"],"sources":["../../../src/utils/createHttpServer/createHttpServer.ts"],"sourcesContent":["import fs from 'fs';\nimport { createServer, RequestListener, Server } from 'http';\nimport {\n  createServer as createSecureServer,\n  Server as SecureServer\n} from 'https';\nimport { Application } from 'express';\nimport { validateHttpEnvironment } from './createHttpServer.validate';\n\n/** Create and configure an http/https server */\nexport function createHttpServer(\n  handler?: Application | RequestListener\n): Server | SecureServer {\n  // Validate the environment variables\n  validateHttpEnvironment();\n  // Create a https server if env var are specified\n  if (process.env.TLS_SERVER_KEY && process.env.TLS_SERVER_CERT) {\n    return createSecureServer(\n      {\n        key: fs.readFileSync(process.env.TLS_SERVER_KEY),\n        passphrase: process.env.TLS_SERVER_KEY_PASSPHRASE,\n        cert: fs.readFileSync(process.env.TLS_SERVER_CERT),\n        ca: process.env.TLS_CA\n          ? fs.readFileSync(process.env.TLS_CA)\n          : undefined,\n        requestCert: true,\n        rejectUnauthorized: false\n      },\n      handler\n    );\n  } else {\n    return createServer(handler);\n  }\n}\n"],"mappings":";;;;;;;AAAA,IAAAA,GAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AACA,IAAAE,MAAA,GAAAF,OAAA;AAKA,IAAAG,iBAAA,GAAAH,OAAA;AAEA;AACO,SAASI,gBAAgBA,CAC9BC,OAAuC,EAChB;EACvB;EACA,IAAAC,yCAAuB,EAAC,CAAC;EACzB;EACA,IAAIC,OAAO,CAACC,GAAG,CAACC,cAAc,IAAIF,OAAO,CAACC,GAAG,CAACE,eAAe,EAAE;IAC7D,OAAO,IAAAC,mBAAkB,EACvB;MACEC,GAAG,EAAEC,WAAE,CAACC,YAAY,CAACP,OAAO,CAACC,GAAG,CAACC,cAAc,CAAC;MAChDM,UAAU,EAAER,OAAO,CAACC,GAAG,CAACQ,yBAAyB;MACjDC,IAAI,EAAEJ,WAAE,CAACC,YAAY,CAACP,OAAO,CAACC,GAAG,CAACE,eAAe,CAAC;MAClDQ,EAAE,EAAEX,OAAO,CAACC,GAAG,CAACW,MAAM,GAClBN,WAAE,CAACC,YAAY,CAACP,OAAO,CAACC,GAAG,CAACW,MAAM,CAAC,GACnCC,SAAS;MACbC,WAAW,EAAE,IAAI;MACjBC,kBAAkB,EAAE;IACtB,CAAC,EACDjB,OACF,CAAC;EACH,CAAC,MAAM;IACL,OAAO,IAAAkB,kBAAY,EAAClB,OAAO,CAAC;EAC9B;AACF","ignoreList":[]}

package/dist/utils/createHttpServer/createHttpServer.validate.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Environment variable validator for the creation of a HTTP(S) server
+ */
+export declare function validateHttpEnvironment(): void;

package/dist/utils/createHttpServer/createHttpServer.validate.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validateHttpEnvironment = validateHttpEnvironment;
+var _ = require("./..");
+/**
+ * Environment variable validator for the creation of a HTTP(S) server
+ */
+function validateHttpEnvironment() {
+  // We only check if there is at least the host specified
+  if (process.env.TLS_SERVER_CERT && process.env.TLS_SERVER_CERT) {
+    (0, _.assertEnvironment)({
+      TLS_SERVER_KEY: _.envAssert.isPath()
+    });
+    (0, _.assertEnvironment)({
+      TLS_SERVER_CERT: _.envAssert.isPath()
+    });
+    // Optional variables
+    if (process.env.TLS_SERVER_KEY_PASSPHRASE) {
+      (0, _.assertEnvironment)({
+        TLS_SERVER_KEY_PASSPHRASE: _.envAssert.isString()
+      });
+    }
+    if (process.env.TLS_CA) (0, _.assertEnvironment)({
+      TLS_CA: _.envAssert.isPath()
+    });
+  }
+}
+//# sourceMappingURL=createHttpServer.validate.js.map

package/dist/utils/createHttpServer/createHttpServer.validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHttpServer.validate.js","names":["_","require","validateHttpEnvironment","process","env","TLS_SERVER_CERT","assertEnvironment","TLS_SERVER_KEY","envAssert","isPath","TLS_SERVER_KEY_PASSPHRASE","isString","TLS_CA"],"sources":["../../../src/utils/createHttpServer/createHttpServer.validate.ts"],"sourcesContent":["import { assertEnvironment, envAssert } from 'utils';\n\n/**\n * Environment variable validator for the creation of a HTTP(S) server\n */\nexport function validateHttpEnvironment(): void {\n  // We only check if there is at least the host specified\n  if (process.env.TLS_SERVER_CERT && process.env.TLS_SERVER_CERT) {\n    assertEnvironment({ TLS_SERVER_KEY: envAssert.isPath() });\n    assertEnvironment({ TLS_SERVER_CERT: envAssert.isPath() });\n    // Optional variables\n    if (process.env.TLS_SERVER_KEY_PASSPHRASE) {\n      assertEnvironment({ TLS_SERVER_KEY_PASSPHRASE: envAssert.isString() });\n    }\n    if (process.env.TLS_CA) assertEnvironment({ TLS_CA: envAssert.isPath() });\n  }\n}\n"],"mappings":";;;;;;AAAA,IAAAA,CAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACO,SAASC,uBAAuBA,CAAA,EAAS;EAC9C;EACA,IAAIC,OAAO,CAACC,GAAG,CAACC,eAAe,IAAIF,OAAO,CAACC,GAAG,CAACC,eAAe,EAAE;IAC9D,IAAAC,mBAAiB,EAAC;MAAEC,cAAc,EAAEC,WAAS,CAACC,MAAM,CAAC;IAAE,CAAC,CAAC;IACzD,IAAAH,mBAAiB,EAAC;MAAED,eAAe,EAAEG,WAAS,CAACC,MAAM,CAAC;IAAE,CAAC,CAAC;IAC1D;IACA,IAAIN,OAAO,CAACC,GAAG,CAACM,yBAAyB,EAAE;MACzC,IAAAJ,mBAAiB,EAAC;QAAEI,yBAAyB,EAAEF,WAAS,CAACG,QAAQ,CAAC;MAAE,CAAC,CAAC;IACxE;IACA,IAAIR,OAAO,CAACC,GAAG,CAACQ,MAAM,EAAE,IAAAN,mBAAiB,EAAC;MAAEM,MAAM,EAAEJ,WAAS,CAACC,MAAM,CAAC;IAAE,CAAC,CAAC;EAC3E;AACF","ignoreList":[]}

package/dist/utils/createHttpServer/index.d.ts

@@ -0,0 +1 @@
+export * from './createHttpServer';

package/dist/utils/createHttpServer/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _createHttpServer = require("./createHttpServer");
+Object.keys(_createHttpServer).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _createHttpServer[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _createHttpServer[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/createHttpServer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_createHttpServer","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sources":["../../../src/utils/createHttpServer/index.ts"],"sourcesContent":["export * from './createHttpServer';\n"],"mappings":";;;;;AAAA,IAAAA,iBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,iBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,iBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,iBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/utils/createSortedObject/createSortedObject.d.ts

@@ -0,0 +1,2 @@
+/** Deep sort the objects keys alphabetically */
+export declare function createSortedObject<T>(data: T): T;

package/dist/utils/createSortedObject/createSortedObject.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createSortedObject = createSortedObject;
+/** Deep sort the objects keys alphabetically */
+function createSortedObject(data) {
+  if (!(data instanceof Object)) throw new Error('Non');
+  const result = {};
+  Object.keys(data).sort().forEach(key => {
+    const value = data[key];
+    if (typeof value !== 'object' || value instanceof Array || value === null) {
+      result[key] = value;
+    } else {
+      result[key] = createSortedObject(value);
+    }
+  });
+  return result;
+}
+//# sourceMappingURL=createSortedObject.js.map

package/dist/utils/createSortedObject/createSortedObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSortedObject.js","names":["createSortedObject","data","Object","Error","result","keys","sort","forEach","key","value","Array"],"sources":["../../../src/utils/createSortedObject/createSortedObject.ts"],"sourcesContent":["/** Deep sort the objects keys alphabetically */\nexport function createSortedObject<T>(data: T): T {\n  if (!(data instanceof Object)) throw new Error('Non');\n  const result: Record<string, unknown> = {};\n  Object.keys(data)\n    .sort()\n    .forEach((key: string) => {\n      const value = (data as Record<string, unknown>)[key];\n      if (\n        typeof value !== 'object' ||\n        value instanceof Array ||\n        value === null\n      ) {\n        result[key] = value;\n      } else {\n        result[key] = createSortedObject(value);\n      }\n    });\n  return result as T;\n}\n"],"mappings":";;;;;;AAAA;AACO,SAASA,kBAAkBA,CAAIC,IAAO,EAAK;EAChD,IAAI,EAAEA,IAAI,YAAYC,MAAM,CAAC,EAAE,MAAM,IAAIC,KAAK,CAAC,KAAK,CAAC;EACrD,MAAMC,MAA+B,GAAG,CAAC,CAAC;EAC1CF,MAAM,CAACG,IAAI,CAACJ,IAAI,CAAC,CACdK,IAAI,CAAC,CAAC,CACNC,OAAO,CAAEC,GAAW,IAAK;IACxB,MAAMC,KAAK,GAAIR,IAAI,CAA6BO,GAAG,CAAC;IACpD,IACE,OAAOC,KAAK,KAAK,QAAQ,IACzBA,KAAK,YAAYC,KAAK,IACtBD,KAAK,KAAK,IAAI,EACd;MACAL,MAAM,CAACI,GAAG,CAAC,GAAGC,KAAK;IACrB,CAAC,MAAM;MACLL,MAAM,CAACI,GAAG,CAAC,GAAGR,kBAAkB,CAACS,KAAK,CAAC;IACzC;EACF,CAAC,CAAC;EACJ,OAAOL,MAAM;AACf","ignoreList":[]}

package/dist/utils/createSortedObject/index.d.ts

@@ -0,0 +1 @@
+export * from './createSortedObject';

package/dist/utils/createSortedObject/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _createSortedObject = require("./createSortedObject");
+Object.keys(_createSortedObject).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _createSortedObject[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _createSortedObject[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/createSortedObject/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_createSortedObject","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sources":["../../../src/utils/createSortedObject/index.ts"],"sourcesContent":["export * from './createSortedObject';\n"],"mappings":";;;;;AAAA,IAAAA,mBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,mBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,mBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,mBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/utils/dbMigration/dbMigration.d.ts

@@ -0,0 +1,17 @@
+import { ClearDbOptions, RecreateDbOptions } from './dbMigration.types';
+/** Run all the non-executed migrations one by one */
+export declare function runPendingMigrations(): Promise<void>;
+/** Rollback all migrations up to a specified target version */
+export declare function rollbackMigrations(): Promise<void>;
+/**
+ * Recreate the whole database
+ * Quick way to make sure that we are working on a clean database
+ * /!\ Should only be used when running tests
+ */
+export declare function testRecreateDB(options?: RecreateDbOptions): Promise<void>;
+/**
+ * Empty all the schemas in the database
+ * Quick way to flush the database data while keep the structure
+ * /!\ Should only be used when running tests
+ */
+export declare function testClearDB(options?: ClearDbOptions): Promise<void>;

package/dist/utils/dbMigration/dbMigration.js

@@ -0,0 +1,207 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.rollbackMigrations = rollbackMigrations;
+exports.runPendingMigrations = runPendingMigrations;
+exports.testClearDB = testClearDB;
+exports.testRecreateDB = testRecreateDB;
+var _fs = require("fs");
+var _path = require("path");
+var _umzug = require("umzug");
+var _migrateMetadataTable = require("./migrateMetadataTable");
+var _models = require("../../db/models");
+var _EngineError = require("../../entities/EngineError");
+var _Sequelize = require("../../entities/Sequelize");
+var _report = require("../report");
+var _semverCompare = require("../semverCompare");
+/* eslint-disable @typescript-eslint/no-require-imports */
+// Register ts-node at the top of runMigrations.ts
+require('ts-node/register');
+const namespace = 'engine:utils:dbMigration';
+function getMigrationPaths() {
+  // We look between possibilities for the first directory that exists and matches our expectations
+  // First a user specified one, then the production default, then the development default
+  const prodDefaultPath = (0, _path.join)(process.cwd(), './dist/db/migrations');
+  const devDefaultPath = (0, _path.join)(process.cwd(), './src/db/migrations');
+  const path = [process.env.DB_MIGRATIONS_DIR, process.env.NODE_ENV === 'prod' ? prodDefaultPath : devDefaultPath].filter(path => path && (0, _fs.existsSync)(path) && (0, _fs.lstatSync)(path).isDirectory());
+  (0, _report.reportDebug)({
+    namespace,
+    message: 'Obtaining Umzug migration options',
+    data: {
+      path,
+      prodPath: prodDefaultPath,
+      devPath: devDefaultPath,
+      customPath: process.env.DB_MIGRATIONS_DIR
+    }
+  });
+  return path.map(p => process.env.NODE_ENV === 'prod' ? `${p}/*.js` : `${p}/*.ts`);
+}
+
+/** Run all the non-executed migrations one by one */
+async function runPendingMigrations() {
+  if (!_Sequelize.sequelize) throw new _EngineError.EngineError({
+    message: 'Sequelize is not initialized'
+  });
+  // First make sure that the metadata table is up to date
+  await (0, _migrateMetadataTable.migrateMetadataTable)(_Sequelize.sequelize);
+  const migrationPaths = getMigrationPaths();
+  if (!migrationPaths || migrationPaths.length <= 0) {
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'No valid migration paths found.',
+      data: {
+        migrationPaths
+      }
+    });
+    return;
+  }
+  migrationPaths?.forEach(async path => {
+    const migrator = new _umzug.Umzug({
+      migrations: {
+        glob: path,
+        resolve: ({
+          name,
+          path,
+          context
+        }) => {
+          // Use require to import the migration file
+          const migration = require(path || '');
+          return {
+            name,
+            up: async () => migration.up(context),
+            down: async () => migration.down(context)
+          };
+        }
+      },
+      context: _Sequelize.sequelize.getQueryInterface(),
+      storage: new _umzug.SequelizeStorage({
+        sequelize: _Sequelize.sequelize
+      }),
+      logger: console
+    });
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'Starting pending database migrations',
+      data: {
+        path
+      }
+    });
+    await migrator.up();
+    console.log('Db Migration Completed');
+  });
+}
+
+/** Rollback all migrations up to a specified target version */
+async function rollbackMigrations() {
+  if (!_Sequelize.sequelize) throw new _EngineError.EngineError({
+    message: 'Sequelize is not initialized'
+  });
+  if (!process.env.BUILD_ID) throw new _EngineError.EngineError({
+    message: 'BUILD_ID is not defined'
+  });
+
+  // Fetch executed migrations in ascending order
+  const migrations = await _models.SequelizeMeta.findAll({
+    order: [['name', 'ASC']]
+  });
+  const rollbackUntil = migrations.find(migration => migration.version && (0, _semverCompare.semverCompare)(migration.version, process.env.BUILD_ID) === 1);
+  if (!rollbackUntil) {
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'No rollback target found for the current BUILD_ID.',
+      data: {
+        buildId: process.env.BUILD_ID
+      }
+    });
+    return;
+  }
+  const migrationPaths = getMigrationPaths();
+  if (!migrationPaths || migrationPaths.length <= 0) {
+    (0, _report.reportDebug)({
+      namespace,
+      message: 'No valid migration paths found for rollback.',
+      data: {
+        migrationPaths
+      }
+    });
+    return;
+  }
+  migrationPaths.forEach(async path => {
+    const migrator = new _umzug.Umzug({
+      migrations: {
+        glob: path,
+        resolve: ({
+          name,
+          path,
+          context
+        }) => {
+          const migration = require(path || '');
+          return {
+            name,
+            up: async () => migration.up(context),
+            down: async () => migration.down(context)
+          };
+        }
+      },
+      context: _Sequelize.sequelize.getQueryInterface(),
+      storage: new _umzug.SequelizeStorage({
+        sequelize: _Sequelize.sequelize
+      }),
+      logger: console
+    });
+    (0, _report.reportDebug)({
+      namespace,
+      message: `Rolling back migrations up to: ${rollbackUntil.name}`,
+      data: {
+        path
+      }
+    });
+    await migrator.down({
+      to: rollbackUntil.name
+    });
+  });
+}
+
+/**
+ * Recreate the whole database
+ * Quick way to make sure that we are working on a clean database
+ * /!\ Should only be used when running tests
+ */
+async function testRecreateDB(options = {}) {
+  if (!_Sequelize.sequelize) throw new _EngineError.EngineError({
+    message: 'Sequelize is not initialized'
+  });
+  await _Sequelize.sequelize.query(`DROP SCHEMA public${process.env.SQL_TYPE === 'postgres' ? ' CASCADE' : ''}`);
+  await _Sequelize.sequelize.query(`CREATE SCHEMA public`);
+  if (!options.clean) await runPendingMigrations();
+}
+
+/**
+ * Empty all the schemas in the database
+ * Quick way to flush the database data while keep the structure
+ * /!\ Should only be used when running tests
+ */
+async function testClearDB(options = {}) {
+  if (!_Sequelize.sequelize) throw new _EngineError.EngineError({
+    message: 'Sequelize is not initialized'
+  });
+  await _Sequelize.sequelize.transaction(clearDbTransaction(_Sequelize.sequelize, options));
+}
+
+/** DB clearing transaction */
+function clearDbTransaction(sequelize, options) {
+  return async t => {
+    for (const model of Object.keys(sequelize.models)) {
+      // We ignore the migration metadata schema
+      if (!options.includeMetadata && model === 'sequelizeMeta') continue;
+      const table = sequelize.models[model].tableName;
+      await sequelize.query(`TRUNCATE ${table}${process.env.SQL_TYPE === 'postgres' ? ' CASCADE' : ''};`, {
+        raw: true,
+        transaction: t
+      });
+    }
+  };
+}
+//# sourceMappingURL=dbMigration.js.map