@go-mailer/jarvis 5.0.4 → 5.0.6

package/.eslintignore

@@ -0,0 +1 @@
+test/

package/.eslintrc.yml

@@ -0,0 +1,10 @@
+env:
+  commonjs: true
+  es2021: true
+  node: true
+extends:
+  - standard
+parserOptions:
+  ecmaVersion: latest
+rules:
+  camelcase: 0

package/index.js

@@ -6,15 +6,17 @@ const HTTP = require('./lib/middlewares/http')
 const Authenticator = require('./lib/middlewares/auth')
 const AutomationConstants = require('./lib/constants/automation')
 const { RequestLogger, ProcessLogger } = require('./lib/middlewares/logger')
+const Utility = require('./lib/utilitiy/index')
 
-module.exports = { 
+module.exports = {
   Authenticator,
   AutomationConstants,
   EnvVar,
   FeatureFlag,
   HTTP,
   ProcessLogger,
-  RequestLogger,
   QueryBuilder,
-  Redis
+  Redis,
+  RequestLogger,
+  Utility
 }

package/lib/clients/go-flags.js

@@ -1,7 +1,7 @@
-const axios = require("axios");
-const Env = require("../env");
-const BASE_URI = Env.fetch("GO_FLAGS_URI", true);
-const API_KEY = Env.fetch("GO_FLAGS_KEY", true);
+const axios = require('axios')
+const Env = require('../env')
+const BASE_URI = Env.fetch('GO_FLAGS_URI', true)
+const API_KEY = Env.fetch('GO_FLAGS_KEY', true)
 
 const verifyFeatureFlag = async (flag_name, criteria = {}, environment = '') => {
   const { error, payload } = (
@@ -9,19 +9,19 @@ const verifyFeatureFlag = async (flag_name, criteria = {}, environment = '') =>
       `${BASE_URI}/api/v1/flags/${flag_name}`,
       {
         payload: criteria,
-        environment: environment || Env.fetch("GO_FLAGS_ENV", true)
+        environment: environment || Env.fetch('GO_FLAGS_ENV', true)
       },
       {
         headers: {
-          authorization: `Bearer ${API_KEY}`,
-        },
+          authorization: `Bearer ${API_KEY}`
+        }
       }
     )
-  ).data;
+  ).data
 
-  if (error) throw new Error(error);
+  if (error) throw new Error(error)
 
-  return payload.is_permitted;
-};
+  return payload.is_permitted
+}
 
-module.exports = { verifyFeatureFlag };
+module.exports = { verifyFeatureFlag }

package/lib/clients/iam.js

@@ -1,21 +1,35 @@
-const axios = require("axios");
-const Env = require("../env");
-const IAM_URI = Env.fetch("IAM_SERVICE_URI", true);
-const DEFAULT_TOKEN = Env.fetch("DEFAULT_TOKEN", true);
+const axios = require('axios').default
+const Env = require('../env')
+const IAM_URI = Env.fetch('IAM_SERVICE_URI', true)
+const DEFAULT_TOKEN = Env.fetch('DEFAULT_TOKEN', true)
+
+const checkAuthority = async ({ action, resource, user_id, tenant_id }) => {
+  const { error, payload } = (
+    await axios.post(`${IAM_URI}/authorizer`, {
+      action,
+      resource,
+      tenant_id,
+      user_id
+    })
+  ).data
+
+  if (error || !payload.is_permitted) throw new Error('Unauthorized')
+  return payload.is_permitted
+}
 
 const verifyAPIKey = async (key) => {
   const { error, payload } = (
     await axios.get(`${IAM_URI}/keys/verify/${key}`, {
       headers: {
-        authorization: `Bearer ${DEFAULT_TOKEN}`,
-      },
+        authorization: `Bearer ${DEFAULT_TOKEN}`
+      }
     })
-  ).data;
+  ).data
 
-  if (error) throw new Error("Unauthorized");
+  if (error) throw new Error('Unauthorized')
 
-  return payload.org_id;
-};
+  return payload.org_id
+}
 
 const verifyFeatureFlag = async (flag_name, criteria = {}) => {
   const { error, payload } = (
@@ -23,20 +37,20 @@ const verifyFeatureFlag = async (flag_name, criteria = {}) => {
       `${IAM_URI}/flags`,
       {
         criteria,
-        environment: Env.fetch("NODE_ENV"),
-        name: flag_name,
+        environment: Env.fetch('NODE_ENV'),
+        name: flag_name
       },
       {
         headers: {
-          authorization: `Bearer ${DEFAULT_TOKEN}`,
-        },
+          authorization: `Bearer ${DEFAULT_TOKEN}`
+        }
       }
     )
-  ).data;
+  ).data
 
-  if (error) throw new Error(error);
+  if (error) throw new Error(error)
 
-  return payload.is_permitted;
-};
+  return payload.is_permitted
+}
 
-module.exports = { verifyAPIKey, verifyFeatureFlag };
+module.exports = { checkAuthority, verifyAPIKey, verifyFeatureFlag }

package/lib/constants/automation.js

@@ -7,7 +7,7 @@ module.exports = {
   EVENT_OPENED_TRANSACTIONAL: 'opened_transactional',
   EVENT_SUBSCRIPTION: 'joined_audience',
   EVENT_UNSUBSCRIPTION: 'left_audience',
-  
+
   //
   EFFECT_REMOVE_CONTACT: 'delete_contact',
   EFFECT_SEND_TRANSACTIONAL: 'send_transactional_email',

package/lib/env.js

@@ -1,24 +1,24 @@
-require("dotenv").config();
+require('dotenv').config()
 
 /** */
 class EnvVar {
-  constructor() {
-    this.config = {};
+  constructor () {
+    this.config = {}
   }
 
-  set(config = {}) {
+  set (config = {}) {
     this.config = {
       ...this.config,
-      ...config,
-    };
+      ...config
+    }
   }
 
-  fetch(var_name = "", is_required = false) {
-    if (!var_name) throw new Error(`Variable name is required.`);
-    const value = process.env[var_name] || this.config[var_name];
-    if (is_required && !value) throw new Error(`Required EnvVar ${var_name} not found`);
-    return value;
+  fetch (var_name = '', is_required = false) {
+    if (!var_name) throw new Error('Variable name is required.')
+    const value = process.env[var_name] || this.config[var_name]
+    if (is_required && !value) throw new Error(`Required EnvVar ${var_name} not found`)
+    return value
   }
 }
 
-module.exports = new EnvVar();
+module.exports = new EnvVar()

package/lib/flag.js

@@ -4,10 +4,10 @@ const flagLogger = new ProcessLogger('FeatureFlag')
 
 const verify = async (flag_name = '', criteria = {}) => {
   try {
-    if (!flag_name) throw new Error('Unspecified flag name');
-    if (!Object.keys(criteria)) throw new Error('Unspecified criteria');
-    
-    const result = await verifyFeatureFlag(flag_name, criteria);
+    if (!flag_name) throw new Error('Unspecified flag name')
+    if (!Object.keys(criteria)) throw new Error('Unspecified criteria')
+
+    const result = await verifyFeatureFlag(flag_name, criteria)
     return result
   } catch (e) {
     flagLogger.error(e, 'verify')

package/lib/middlewares/auth.js

@@ -2,98 +2,113 @@
  * User Authentication Middleware
  */
 
- const jwt = require("jsonwebtoken");
- const Env = require("../env");
- const Errors = require("./errors");
- const { ProcessLogger } = require("./logger");
- const { verifyAPIKey } = require("../clients/iam");
- const authLogger = new ProcessLogger("Authenticator");
- 
- // helpers
- const extractToken = (headers) => {
-   const { authorization } = headers;
-   if (!authorization) throw new Error("Unauthorized");
- 
-   const [, token] = authorization.split(" ");
-   if (!token) throw new Error("Unauthorized");
- 
-   return token;
- };
- 
- const extractId = (request, key) => {
-   const { params, query, body } = request;
-   let id = { $exists: true };
-   if (query[key]) id = query[key];
-   if (params[key]) id = params[key];
-   if (body[key]) id = body[key];
- 
-   return id;
- };
- 
- // main
- 
- const authenticateAdmin = async (request, response, next) => {
-   const { is_admin } = request;
-   if (!is_admin) return response.status(403).json(Errors.UNAUTHORIZED);
- 
-   next();
- };
- 
- const authenticateBearerKey = async (request, response, next) => {
-   try {
-     const token = extractToken(request.headers);
-     request.tenant_id = await verifyAPIKey(token);
-     next();
-   } catch (e) {
-     authLogger.error(e, "authenticateBearerKey");
-     return response.status(403).json(Errors.UNAUTHORIZED);
-   }
- };
- 
- const authenticateParamKey = async (request, response, next) => {
-   try {
-     const { api_key: token } = request.params;
-     request.tenant_id = await verifyAPIKey(token);
-     next();
-   } catch (e) {
-     authLogger.error(e, "authenticateParamKey");
-     return response.status(403).json(Errors.UNAUTHORIZED);
-   }
- };
- 
- const authenticateUser = async (request, response, next) => {
-   try {
-     // env vars
-     const DEFAULT_TOKEN = Env.fetch("DEFAULT_TOKEN", true);
-     const ISSUER = Env.fetch("JWT_ISSUER", true);
-     const SECRET = Env.fetch("JWT_SECRET", true);
- 
-     const token = extractToken(request.headers);
-     if (token === DEFAULT_TOKEN) {
-       // inter-service requests
-       request.is_service_request = true;
-       // typically scope requests by tenant_id
-       request.tenant_id = request.body.tenant_id || request.query.tenant_id || { $exists: true };
-       request.user_id = request.body.user_id || request.query.user_id || { $exists: true };
-       return next();
-     }
- 
-     const { id: user_id, is_admin, tenant_id } = await jwt.verify(token, SECRET, { issuer: ISSUER });
-     request.is_admin = !!is_admin;
-     request.user_id = is_admin ? extractId(request, "user_id") : user_id;
-     request.tenant_id = is_admin ? extractId(request, "tenant_id") : tenant_id;
- 
-     next();
-   } catch (e) {
-     authLogger.error(e, "authenticateUser");
-     return response.status(403).json(Errors.UNAUTHORIZED);
-   }
- };
- 
- module.exports = {
-   authenticateAdmin,
-   authenticateBearerKey,
-   authenticateParamKey,
-   authenticateUser,
- };
- 
+const jwt = require('jsonwebtoken')
+const Env = require('../env')
+const Errors = require('./errors')
+const { ProcessLogger } = require('./logger')
+const { checkAuthority, verifyAPIKey } = require('../clients/iam')
+const authLogger = new ProcessLogger('Authenticator')
+
+// helpers
+const extractToken = (headers) => {
+  const { authorization } = headers
+  if (!authorization) throw new Error('Unauthorized')
+
+  const [, token] = authorization.split(' ')
+  if (!token) throw new Error('Unauthorized')
+
+  return token
+}
+
+const extractId = (request, key) => {
+  const { params, query, body } = request
+  let id = { $exists: true }
+  if (query[key]) id = query[key]
+  if (params[key]) id = params[key]
+  if (body[key]) id = body[key]
+
+  return id
+}
+
+// main
+
+const authenticateAdmin = async (request, response, next) => {
+  const { is_admin } = request
+  if (!is_admin) return response.status(403).json(Errors.UNAUTHORIZED)
+
+  next()
+}
+
+const authenticateBearerKey = async (request, response, next) => {
+  try {
+    const token = extractToken(request.headers)
+    request.tenant_id = await verifyAPIKey(token)
+    next()
+  } catch (e) {
+    authLogger.error(e, 'authenticateBearerKey')
+    return response.status(403).json(Errors.UNAUTHORIZED)
+  }
+}
+
+const authenticateParamKey = async (request, response, next) => {
+  try {
+    const { api_key: token } = request.params
+    request.tenant_id = await verifyAPIKey(token)
+    next()
+  } catch (e) {
+    authLogger.error(e, 'authenticateParamKey')
+    return response.status(403).json(Errors.UNAUTHORIZED)
+  }
+}
+
+const authenticateUser = async (request, response, next) => {
+  try {
+    // env vars
+    const DEFAULT_TOKEN = Env.fetch('DEFAULT_TOKEN', true)
+    const ISSUER = Env.fetch('JWT_ISSUER', true)
+    const SECRET = Env.fetch('JWT_SECRET', true)
+
+    const token = extractToken(request.headers)
+    if (token === DEFAULT_TOKEN) {
+      // inter-service requests
+      request.is_service_request = true
+      // typically scope requests by tenant_id
+      request.tenant_id = request.body.tenant_id || request.query.tenant_id || { $exists: true }
+      request.user_id = request.body.user_id || request.query.user_id || { $exists: true }
+      return next()
+    }
+
+    const { id: user_id, is_admin, tenant_id } = await jwt.verify(token, SECRET, { issuer: ISSUER })
+    request.is_admin = !!is_admin
+    request.user_id = is_admin ? extractId(request, 'user_id') : user_id
+    request.tenant_id = is_admin ? extractId(request, 'tenant_id') : tenant_id
+
+    next()
+  } catch (e) {
+    authLogger.error(e, 'authenticateUser')
+    return response.status(403).json(Errors.UNAUTHORIZED)
+  }
+}
+
+const authorizeUser = async ({ action, resource }) => {
+  return async (request, response, next) => {
+    try {
+      const { is_admin, tenant_id, user_id } = request
+      if (is_admin) next()
+
+      await checkAuthority({ action, resource, tenant_id, user_id })
+      next()
+    } catch (e) {
+      authLogger.error(e, 'authorizeUser')
+      return response.status(403).json(Errors.UNAUTHORIZED)
+    }
+  }
+}
+
+module.exports = {
+  authenticateAdmin,
+  authenticateBearerKey,
+  authenticateParamKey,
+  authenticateUser,
+  authorizeUser
+}

package/lib/middlewares/http.js

@@ -1,52 +1,52 @@
 /** **/
-const { ProcessLogger } = require("./logger");
-const HTTPLogger = new ProcessLogger("HTTPSetup");
+const { ProcessLogger } = require('./logger')
+const HTTPLogger = new ProcessLogger('HTTPSetup')
 
 module.exports = {
-  handle404(_, __, next) {
+  handle404 (_, __, next) {
     const return_data = {
       status_code: 404,
       success: false,
-      error: "Resource not found",
-      payload: null,
-    };
+      error: 'Resource not found',
+      payload: null
+    }
 
-    next(return_data);
+    next(return_data)
   },
 
-  handleError(error, __, response, ____) {
+  handleError (error, __, response, ____) {
     // Log errors
     if (error.error) {
-      HTTPLogger.info(error.error, "handleError");
+      HTTPLogger.info(error.error, 'handleError')
     } else {
-      HTTPLogger.error(error, "handleError");
+      HTTPLogger.error(error, 'handleError')
     }
 
     // return error
     return response.status(error.status_code || 500).json({
       success: false,
       status_code: error.status_code || 500,
-      error: error.error || "Internal Server Error",
-      payload: null,
-    });
+      error: error.error || 'Internal Server Error',
+      payload: null
+    })
   },
 
-  processResponse(request, response, next) {
-    if (!request.payload) return next();
+  processResponse (request, response, next) {
+    if (!request.payload) return next()
 
-    const { status_code } = request.payload;
-    return response.status(status_code).json(request.payload);
+    const { status_code } = request.payload
+    return response.status(status_code).json(request.payload)
   },
 
-  setupRequest(request, response, next) {
-    request.headers["access-control-allow-origin"] = "*";
-    request.headers["access-control-allow-headers"] = "*";
+  setupRequest (request, response, next) {
+    request.headers['access-control-allow-origin'] = '*'
+    request.headers['access-control-allow-headers'] = '*'
 
-    if (request.method === "OPTIONS") {
-      request.headers["access-control-allow-methods"] = "GET, POST, PUT, PATCH, DELETE";
-      response.status(200).json();
+    if (request.method === 'OPTIONS') {
+      request.headers['access-control-allow-methods'] = 'GET, POST, PUT, PATCH, DELETE'
+      response.status(200).json()
     }
 
-    next();
-  },
-};
+    next()
+  }
+}

package/lib/middlewares/logger.js

@@ -2,41 +2,38 @@
  * @author Oguntuberu Nathan O. <nateoguns.work@gmail.com>
  **/
 
-const Env = require("../env");
-const { randomUUID } = require("crypto");
-const { Logtail } = require("@logtail/node");
-const LOGTAIL_SECRET = Env.fetch("LOGTAIL_SECRET", true);
-const logtail = new Logtail(LOGTAIL_SECRET);
+const Env = require('../env')
+const { randomUUID } = require('crypto')
 
 function hashLogData (log = {}) {
   const hashed = JSON.stringify(log).replace(/\w+@/gi, '************')
   return JSON.parse(hashed)
 }
 
-function RequestLogger() {
-  const app_name = Env.fetch("APP_NAME", true);
+function RequestLogger () {
+  const app_name = Env.fetch('APP_NAME', true)
   return (request, response, next) => {
-    if (!request.request_id) request.request_id = randomUUID();
+    if (!request.request_id) request.request_id = randomUUID()
 
     //
     const {
       query,
       params,
-      headers: { host, origin, "user-agent": user_agent, "sec-ch-ua-platform": os, referer },
+      headers: { host, origin, 'user-agent': user_agent, 'sec-ch-ua-platform': os, referer },
       request_id,
-      tenant_id,
-    } = request;
+      tenant_id
+    } = request
 
-    response.on("finish", () => {
+    response.on('finish', () => {
       const {
         _parsedUrl: { pathname },
         httpVersion,
         _startTime,
         _remoteAddress,
-        payload,
-      } = response.req;
-      const { statusCode, statusMessage } = response.req.res;
-      const duration = Date.now() - Date.parse(_startTime);
+        payload
+      } = response.req
+      const { statusCode, statusMessage } = response.req.res
+      const duration = Date.now() - Date.parse(_startTime)
       const log = {
         app_name,
         request_id,
@@ -52,11 +49,11 @@ function RequestLogger() {
         _remoteAddress,
         pathname,
         duration,
-        type: "request",
-        status_code: payload ? payload.status_code : statusCode,
-      };
+        type: 'request',
+        status_code: payload ? payload.status_code : statusCode
+      }
 
-      let error = payload ? payload.error : statusMessage;
+      const error = payload ? payload.error : statusMessage
       // if (error) {
       //   log.error = error;
       //   logtail.error(pathname, hashLogData(log));
@@ -65,18 +62,19 @@ function RequestLogger() {
       // }
 
       // logtail.flush();
-    });
+      console.log(pathname, hashLogData({ ...log, error }))
+    })
 
-    next();
-  };
+    next()
+  }
 }
 
 class ProcessLogger {
-  constructor(service = "System") {
-    this.service = service;
+  constructor (service = 'System') {
+    this.service = service
   }
 
-  error(error, method = "unspecified_method", params = {}) {
+  error (error, method = 'unspecified_method', params = {}) {
     // logtail.error(`${this.service}:${method}:${error.message}`, hashLogData({
     //   app_name: Env.fetch("APP_NAME", true),
     //   type: "process",
@@ -85,12 +83,12 @@ class ProcessLogger {
     //   params,
     // }));
     // logtail.flush();
-    console.log(`${this.service}:${method}:${error.message}`, error.stack)
+    console.log(`${this.service}:${method}:${error.message}`, params, error.stack)
   }
 
-  info(info, method = "unspecified_method", params = {}) {
-    const message_str = `${this.service}:${method}:${info}`;
-    console.log(message_str);
+  info (info, method = 'unspecified_method', params = {}) {
+    const message_str = `${this.service}:${method}:${info}`
+    console.log(message_str, params)
     // logtail.info(message_str, hashLogData({
     //   app_name: Env.fetch("APP_NAME", true),
     //   type: "process",
@@ -101,4 +99,4 @@ class ProcessLogger {
   }
 }
 
-module.exports = { RequestLogger, ProcessLogger };
+module.exports = { RequestLogger, ProcessLogger }

package/lib/query.js

@@ -2,7 +2,7 @@ const buildQuery = (options) => {
   const sort_condition = options.sort_by ? buildSortOrderString(options.sort_by) : {}
   const fields_to_return = options.return_only ? buildReturnFieldsString(options.return_only) : ''
   const count = options.count || false
-  
+
   const group_by = options.group_by
   const sum = options.sum
   const is_pipeline = group_by || sum
@@ -179,7 +179,7 @@ const generatePipeline = ({ group_by, seek_conditions, sort_condition, sum, fiel
   })
 
   let sort_options = sort_condition
-  if (sort_condition && typeof(sort_condition) === 'string') {
+  if (sort_condition && typeof (sort_condition) === 'string') {
     sort_options = sort_condition.split(' ').reduce((sac, condition) => {
       let key = condition
       let value = 1
@@ -219,7 +219,7 @@ const generatePipeline = ({ group_by, seek_conditions, sort_condition, sum, fiel
     const sum_field = sum.split(',')[0]
     pipeline.push({
       $group: {
-        _id: { tenant_id: "$tenant_id" },
+        _id: { tenant_id: '$tenant_id' },
         [sum_field]: { $sum: `$${sum_field}` }
       }
     })
@@ -227,7 +227,7 @@ const generatePipeline = ({ group_by, seek_conditions, sort_condition, sum, fiel
 
   if (count) {
     pipeline.push({
-      $count: "size"
+      $count: 'size'
     })
   }
 

package/lib/redis/index.js

@@ -29,8 +29,8 @@ class RedisClient {
   }
 }
 //
-const redisClient = new RedisClient() 
-module.exports ={ 
+const redisClient = new RedisClient()
+module.exports = {
   RedisClient: redisClient,
   Schemas
 }

package/lib/utilitiy/chart.js

@@ -0,0 +1,69 @@
+const processRangeInDays = (min = 0, seconds_in_day = 86400000) => {
+  const ranges = []
+  let x = min
+  for (let i = 0; i < 31; i++) {
+    const [, mmm, dd] = new Date(x).toDateString().split(' ')
+    ranges.push({ start: x, end: x + seconds_in_day - 1000, label: `${mmm} ${dd}` })
+    x += seconds_in_day
+  }
+
+  return ranges
+}
+
+const processRangeInWeeks = (min = 0, seconds_in_day = 86400000) => {
+  const ranges = []
+  let x = min
+  const [, mmm, dd] = new Date(x).toDateString().split(' ')
+  for (let i = 0; i < Math.ceil(100 / 7); i++) {
+    ranges[i] = {
+      start: x,
+      end: x + 6 * seconds_in_day - 1000,
+      label: `${mmm} ${dd}`
+    }
+    x += 6 * seconds_in_day
+  }
+
+  return ranges
+}
+
+const processRangeInMonths = (min, max) => {
+  // group in months
+  const d = new Date(min)
+  const year = d.getFullYear()
+  const month = d.getUTCMonth()
+
+  const ranges = []
+  let x = min
+  for (let i = 1; x <= max; i++) {
+    const [, mmm, , yyyy] = new Date(x).toDateString().split(' ')
+    ranges.push({
+      start: x,
+      end: Date.parse(new Date(year, month + i, 1)) - 1000,
+      label: `${mmm} ${yyyy}`
+    })
+
+    x = Date.parse(new Date(year, month + i, 1))
+  }
+
+  return ranges
+}
+
+module.exports = {
+  processDateRange: (start, stop) => {
+    const min = Date.parse(start)
+    const max = Date.parse(stop)
+    const difference = max - min
+    const seconds_in_day = 86400000
+
+    let ranges = []
+    if (difference / seconds_in_day <= 31) {
+      ranges = processRangeInDays(min, seconds_in_day)
+    } else if (difference / seconds_in_day <= 100) {
+      ranges = processRangeInWeeks(min, seconds_in_day)
+    } else {
+      ranges = processRangeInMonths(min, max)
+    }
+
+    return ranges
+  }
+}

package/lib/utilitiy/date.js

@@ -0,0 +1,204 @@
+/** */
+const MONTH_MAP = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
+const NUM_OF_MILLISECONDS_IN_ONE_DAY = 86400000
+
+/** */
+const convertDateFromIsoToHTMLFormat = (iso_date) => {
+  const date = new Date(iso_date)
+  const day = padDateValue(date.getDate())
+  const month = padDateValue(date.getMonth() + 1)
+  const year = date.getFullYear()
+
+  const converted_date = `${year}-${month}-${day}`
+  return iso_date ? converted_date : ''
+}
+
+/**
+ * Extracts day string of the given timestamp for graphs. Return ex. 'Jan 10'
+ * @param {Number} timestamp
+ */
+const extractDayStringForGraph = (timestamp) => {
+  const date = new Date(timestamp)
+  const month = MONTH_MAP[date.getMonth()]
+  const day = padDateValue(date.getDate())
+
+  return `${month} ${day}`
+}
+
+const generateHTMLFormDateTimeDefaults = () => {
+  const date = new Date().toISOString()
+  const generated_date = `${convertDateFromIsoToHTMLFormat(date)}`
+  return generated_date
+}
+
+/**
+ * Generates a configuration of back-counted days starting from a base time.
+ *
+ * @param {*} base_timestamp The day to start back count
+ * @param {*} spread The numbers of days to count back.
+ */
+const generateDaysConfigurationForGraph = (base_timestamp, spread = 7, key_values) => {
+  let curr_timestamp = getDayTimestampForRawTimestamp(base_timestamp)
+  const config = {}
+  for (let i = 0; i < spread; i++) {
+    const date_string = extractDayStringForGraph(curr_timestamp)
+    // key_values = [subscribers , unsubscribers]; [opens, bounces]
+    config[date_string] = {
+      date: date_string,
+      [key_values[0]]: 0,
+      [key_values[1]]: 0
+    }
+    curr_timestamp -= NUM_OF_MILLISECONDS_IN_ONE_DAY
+  }
+  return config
+}
+
+/**
+ * Generates the number of milliseconds at (12:00AM) for the date specified in the raw_timestamp.
+ *
+ * @param {Number} raw_timestamp number of milliseconds
+ */
+const getDayTimestampForRawTimestamp = (raw_timestamp) => {
+  const date = new Date(raw_timestamp)
+  const day = `${padDateValue(date.getMonth() + 1)}/${padDateValue(date.getDate())}/${date.getFullYear()}`
+  return Date.parse(day)
+}
+
+/**
+ * Get the timestamp of the first and last days of the month
+ */
+
+const getMonthTimeRange = () => {
+  const year = new Date().getFullYear()
+  const current_month = new Date().getMonth()
+  const start = Date.parse(new Date(year, current_month, 1))
+  const end = Date.parse(new Date(year, current_month + 1, 1)) - 1000
+
+  return { start, end }
+}
+
+/**
+ * Get today's midnight time stamp
+ */
+
+const getCurrentDayTimestamp = () => {
+  const date = new Date()
+  const year = date.getFullYear()
+  const month = padDateValue(date.getMonth() + 1)
+  const day = padDateValue(date.getDate())
+  const date_string = `${year}-${month}-${day}`
+  return Date.parse(date_string)
+}
+
+/**
+ * prefixes 0 on numbers with single digits.
+ * @param {Number} value
+ */
+const padDateValue = (value) => {
+  return value < 10 ? `0${value}` : value
+}
+
+const isCampaignSendDateValid = (chosen_date) => {
+  const today = new Date().toDateString()
+  return new Date(`${chosen_date}`) >= new Date(today)
+}
+
+const toDateString = (date = '') => {
+  if (!date) return ''
+  return new Date(date).toDateString()
+}
+
+const formatDateWithoutDayOfWeek = (date = '') => {
+  if (!date) return ''
+  const options = { year: 'numeric', month: 'short', day: 'numeric' }
+  return new Date(date).toLocaleDateString(undefined, options)
+}
+
+const formatDateForDisplay = (raw_value) => {
+  const date = new Date(raw_value)
+  if (!raw_value || !date) return raw_value
+  const [, mon, day, year, time] = date.toString().split(' ')
+  return [mon, `${day},`, year, time].join(' ')
+}
+
+const toTimeString = (date = '') => {
+  if (!date) return ''
+  const options = {
+    hour: 'numeric',
+    minute: 'numeric',
+    hour12: true
+  }
+  return new Date(date).toLocaleTimeString('en-US', options)
+}
+
+const generateDefaultRange = () => {
+  const [today] = new Date().toISOString().split('T')
+  const [thirty_days_ago] = new Date(Date.parse(today) - 30 * 86400000).toISOString().split('T')
+  return [thirty_days_ago, today]
+}
+
+/**
+ *
+ * @param {Number} year
+ * @returns {startDate, endDate}
+ */
+const getYearRange = (year) => {
+  const startDate = new Date(year, 0, 1).getTime() // January 1st
+  const endDate = new Date(year, 11, 31).getTime() + 86400000 - 1 // December 31st (23:59:59)
+  return { startDate, endDate }
+}
+
+const getMonthTimestamps = (year) => {
+  const timestamps = []
+
+  for (let month = 0; month < 12; month++) {
+    const startDate = new Date(year, month, 1)
+    const endDate = new Date(year, month + 1, 0, 23, 59, 59, 999) // Last day of the month
+
+    timestamps.push({
+      start: startDate.getTime(),
+      end: endDate.getTime()
+    })
+  }
+
+  return timestamps
+}
+
+const getMonthNameFromTimestamp = (timestamp) => {
+  const date = new Date(timestamp)
+  const months = [
+    'January',
+    'February',
+    'March',
+    'April',
+    'May',
+    'June',
+    'July',
+    'August',
+    'September',
+    'October',
+    'November',
+    'December'
+  ]
+  return months[date.getMonth()]
+}
+
+module.exports = {
+  convertDateFromIsoToHTMLFormat,
+  extractDayStringForGraph,
+  formatDateForDisplay,
+  formatDateWithoutDayOfWeek,
+  generateDaysConfigurationForGraph,
+  generateHTMLFormDateTimeDefaults,
+  getCurrentDayTimestamp,
+  getDayTimestampForRawTimestamp,
+  generateDefaultRange,
+  getMonthTimeRange,
+  isCampaignSendDateValid,
+  padDateValue,
+  toDateString,
+  toTimeString,
+  getYearRange,
+  getMonthTimestamps,
+  getMonthNameFromTimestamp
+}

package/lib/utilitiy/index.js

@@ -0,0 +1,9 @@
+const Chart = require('./chart')
+const Date = require('./date')
+const Number = require('./number')
+
+module.exports = {
+  Chart,
+  Date,
+  Number
+}

package/lib/utilitiy/number.js

@@ -0,0 +1,7 @@
+module.exports = {
+  toReadableNumber: (value) => {
+    if (!value) return 0
+    if (isNaN(value)) return value
+    return Number(Number(value).toFixed(2)).toLocaleString()
+  }
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@go-mailer/jarvis",
-  "version": "5.0.4",
+  "version": "5.0.6",
   "main": "index.js",
   "repository": "git@github.com:go-mailer-ltd/jarvis-node.git",
   "author": "Nathan Oguntuberu <nateoguns.work@gmail.com>",
   "license": "MIT",
   "scripts": {
-    "test": "mocha --recursive -w -c || true"
+    "test": "mocha --recursive -w -c || true",
+    "lint:fix": "eslint --fix .  --ext .js"
   },
   "dependencies": {
     "@logtail/node": "^0.3.3",
@@ -18,6 +19,11 @@
   },
   "devDependencies": {
     "chai": "^4.3.7",
+    "eslint": "^7.32.0",
+    "eslint-config-standard": "^16.0.3",
+    "eslint-plugin-import": "^2.25.4",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "^5.2.0",
     "mocha": "^10.2.0"
   }
 }