@sera4/essentia 1.0.10 → 1.0.12

package/README.md

@@ -5,4 +5,5 @@ A collection of small modules providing essential utilities for TWS services:
 * [Sequelize Paginator](paginator/README.md)
 * [Sequelize HAL Decorator](hal/README.md)
 * A logging tool
-* A small utility to dump the last commit of the project
+* An HTTP response tool for consistenty formatting error responses
+* A small utility to dump the last commit of the project

package/health/index.js

@@ -0,0 +1,121 @@
+"use strict"
+
+const pathHelper = require("path");
+const logger = require("../logger/s4-logger");
+
+class HealthCheckError extends Error {
+  constructor(m) {
+    super(m);
+  }
+}
+
+/* Health Checking router + controller for use in all of our modules
+ * Example use: Place the following code in your routes file 
+ *
+ *    const hc = require("@sera4/essentia").healthCheck;
+ *    const router = require('express').Router();
+ *
+ *      ....
+ *    app.use(hc.defaultPath(serverConfigs.api_prefix), hc.routes(router));
+ *
+ */
+
+class HealthCheck {
+  constructor(appendData = {}) { 
+    this.defaultResponse = {
+      ...
+      appendData,
+      status: 200,
+      errors: {}
+    };
+
+    this.defaultPathRoute = `health_check\(.*\)?` 
+    this.lastCallID = null;
+
+    this.healthChecks = [];
+  }
+
+  /* call this with an async function, must support wait capability 
+   * 
+   *   const dbCheck = async () => {
+   *     return { name: "db", "result": "success", critical: false };
+   *   }
+   */ 
+  addCheck(fcn) {
+    this.healthChecks.push(fcn);
+  }
+
+  defaultPath(prefix = "") {
+    return `${prefix}/${this.defaultPathRoute}`
+  }
+
+  routes(router) {
+    if (!router) {
+      throw new HealthCheckError("missing_express_router");
+    }
+
+    /* definition of all routes, rooted at defaultPath */
+    router.get('/', (req, res) => {
+      this.checkHealth(req, res)
+    });
+
+    return router
+  }
+
+  /* performs health checks and returns 200 if true and 500 if not */
+  async checkHealth(req, res) {
+    const checkFormat = pathHelper.extname(req.baseUrl);
+
+    try {
+      const result = await Promise.all(this.healthChecks.map(async healthCallback => {
+        return await healthCallback();
+      }));
+
+      //let result = (result.reduce((e) => e.success, 200))
+      let callId = (Math.random()*0xFFFFFF<<0).toString(16);
+      this.lastCallId = callId;
+
+      let status = this.defaultResponse.status;
+
+      result.some(e => {
+        if (e.result.match(/fail/)) {
+          status = 500;
+          return true; // break
+        }
+      })
+
+      // set this in the header no matter what
+      res.setHeader('check', callId)
+
+      if (checkFormat === ".json") {
+        if (status === 200) {
+          res.status(status).json({
+            "check": callId,
+            "healthy":true,
+            "message":"success"
+          });
+        } else {
+          res.status(status).json({
+            "check": callId,
+            "healthy": false,
+            "message": "fail",
+            "services": [result]
+          });
+        }
+      } else {
+        let status_message;
+        if (status === 200) {
+          status_message = "success"
+        } else {
+          status_message = "fail"
+        }
+
+        res.status(status).send(status_message);
+      }
+    } catch(error) {
+      res.status(500).send();
+    }  
+  }
+}
+
+module.exports = HealthCheck;

package/index.js

@@ -1,9 +1,12 @@
+'use strict';
+
 module.exports = {
   paginator : require("./paginator/s4-pagination"),
   sqlPaginator : require("./paginator/sql-pagination"),
   logger : require("./logger/s4-logger"),
   lastCommit : require("./last_commit"),
   halDecorator : require("./hal"),
-  formatter : require("./formatter")
+  formatter : require("./formatter"),
+  healthCheck: require("./health")
 }
 //console.log(module.exports.formatter.formatError({ status: 200, error: ["error1"] }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sera4/essentia",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "A library of utilities for Teleporte Web Services",
   "main": "index.js",
   "scripts": {
@@ -16,6 +16,7 @@
   "license": "UNLICENSED",
   "devDependencies": {
     "chai": "^4.1.2",
+    "express": "^4.16.4",
     "mocha": "^5.1.1",
     "mocha-junit-reporter": "^1.17.0",
     "node-mocks-http": "^1.5.8",