feat(core): Add deletePlan controller, tests, and CI pipeline

- Introduced conditional delete and other error handler middlewares, along
  with a simple unit test and a GitHub actions CI pipeline.
- Added the MIT license.
- Added CI badge and update `README.md`

Author: sydrawat01

.env.example

@@ -0,0 +1,3 @@
+HOSTNAME=xxxxxxxxx
+PORT=xxxx
+REDIS_PORT=xxxx

.eslintrc.js

@@ -21,4 +21,4 @@ module.exports = {
     'default-param-last': 'off',
     camelcase: 'off',
   },
-};
+}

.github/workflows/test-suite.yml

@@ -0,0 +1,35 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: Unit Test Suite
+
+# Controls when the action will run.
+on:
+  workflow_dispatch:
+  # Triggers the workflow on push or pull request events but only for the master branch
+  pull_request:
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    environment: ${{ vars.ENVIRONMENT }}
+    strategy:
+      matrix:
+        node-version: [18.x]
+
+    name: Run unit tests
+    steps:
+      - uses: actions/checkout@v4
+      - name: "Create .env file"
+        run: |
+          touch .env
+          echo HOSTNAME=${{ vars.HOSTNAME }} >> .env
+          echo PORT=${{ vars.PORT }} >> .env
+          echo DATABASE=${{ vars.REDIS_PORT }} >> .env
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: yarn
+      - run: yarn test

.prettierrc.js

@@ -6,4 +6,4 @@ module.exports = {
   printWidth: 80,
   tabWidth: 2,
   endOfLine: 'auto',
-};
+}

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2023 Siddharth Rawat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,21 +1,22 @@
-# CSYE 7255: Adv Big Data Indexing Techniques
+# INFO-7255: Adv Big Data Indexing Techniques
 
->NOTE: This is a WIP. Please visit different branches for each version of the demos for the submissions
+[![Unit Test Suite](https://github.com/sydrawat01/INFO7255/actions/workflows/test-suite.yml/badge.svg)](https://github.com/sydrawat01/INFO7255/actions/workflows/test-suite.yml)
 
 ## Setup
 
 1. Install the dependencies
 
-```shell
-yarn
-#or if you are using npm: npm i
-```
+   ```shell
+   yarn
+   # or if you are using npm: npm i
+   ```
+
 2. Start the server locally
 
-```shell
-yarn start:dev
-# npm run start:dev
-```
+   ```shell
+   yarn start:dev
+   # npm run start:dev
+   ```
 
 ## Author
 

package.json

@@ -1,17 +1,19 @@
 {
   "name": "api",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "RESTful API",
   "main": "src/server.js",
   "author": "Siddharth Rawat <rawat.sid@northeastern.edu>",
   "license": "MIT",
   "scripts": {
     "env": "nodemon -r dotenv/config",
     "start:dev": "nodemon --exec babel-node ./src/server.js",
-    "clean": "rm  -rf ./dist"
+    "clean": "rm  -rf ./dist",
+    "build": "yarn clean && babel ./src/server.js --out-dir ./dist",
+    "test": "mocha --require @babel/register './tests/*.test.js' --recursive --exit",
+    "test:dev": "mocha --require @babel/register './tests/*.test.js' --watch"
   },
   "dependencies": {
-    "ajv": "^8.12.0",
     "app-root-path": "^3.1.0",
     "dotenv": "^16.3.1",
     "express": "^4.18.2",
@@ -27,6 +29,14 @@
     "@babel/plugin-proposal-class-properties": "^7.18.6",
     "@babel/preset-env": "^7.22.15",
     "@babel/register": "^7.22.15",
-    "nodemon": "^3.0.1"
+    "eslint": "^8.50.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-import": "^2.28.1",
+    "eslint-plugin-prettier": "^5.0.0",
+    "mocha": "^10.2.0",
+    "nodemon": "^3.0.1",
+    "prettier": "^3.0.3",
+    "supertest": "^6.3.3"
   }
 }

src/api/app.js

@@ -1,7 +1,5 @@
 import express from 'express'
 import { errorHandler } from './middlewares/errorHandler'
-// import { healthRoute } from './routes/health.route'
-// import { planRoute } from './routes/plan.route'
 import { healthRoute, planRoute } from './routes/index.routes'
 
 const app = express()

src/api/controllers/health.controller.js

@@ -1,5 +1,4 @@
 import logger from '../../configs/logger.config'
-// import appConfig from '../configs/app.config'
 
 const health = (req, res) => {
   const { protocol, method, hostname, originalUrl } = req

src/api/controllers/plan.controller.js

@@ -1,10 +1,13 @@
-import { findPlan, addPlan, delPlan } from '../services/redis.client'
+import { findPlan, addPlan, deleteByPlanId } from '../services/redis.client'
 import { validate, md5hash } from '../utils/schemaValidation'
 import {
   BadRequestError,
+  InternalServerError,
   ResourceNotFoundError,
+  PreConditionFailedError,
   conflictHandler,
   createHandler,
+  noContentHandler,
   notModifiedHandler,
   successHandler,
 } from '../utils/error.util'
@@ -18,32 +21,31 @@ const getPlan = async (req, res, next) => {
     `Requesting ${method} ${protocol}://${hostname}${originalUrl}`,
     metaData
   )
-  const planId = params.planId
   try {
+    const { planId } = params
     if (planId === null || planId === '' || planId === '{}') {
       throw new BadRequestError(`Invalid planId`)
     }
     const value = await findPlan(planId)
     if (value.objectId === planId) {
+      // conditional read based on `if-none-match` header
       if (
         req.headers['if-none-match'] &&
-        value.ETag == req.headers['if-none-match']
+        value.ETag === req.headers['if-none-match']
       ) {
         res.setHeader('ETag', value.ETag)
         const data = {
           message: 'Plan has not changed',
           plan: JSON.parse(value.plan),
         }
         notModifiedHandler(res, data)
-        return
       } else {
         res.setHeader('ETag', value.ETag)
         const data = {
           message: 'Plan has changed',
           plan: JSON.parse(value.plan),
         }
         successHandler(res, data)
-        return
       }
     } else {
       throw new ResourceNotFoundError(`Plan not found`)
@@ -64,20 +66,20 @@ const savePlan = async (req, res, next) => {
   try {
     if (validate(req.body)) {
       const value = await findPlan(req.body.objectId)
+      logger.warn(`VALUE: ${value}`)
       if (value) {
         res.setHeader('ETag', value.ETag)
         const data = { message: 'Item already exists' }
         conflictHandler(res, data)
-        return
       } else {
-        const ETag = (await addPlan(req.body)).ETag
+        const newPlan = await addPlan(req.body)
+        const { ETag } = newPlan
         res.setHeader('ETag', ETag)
         const data = {
           message: 'Item added',
           ETag,
         }
         createHandler(res, data)
-        return
       }
     } else {
       throw new BadRequestError(`Item is not valid`)
@@ -87,6 +89,44 @@ const savePlan = async (req, res, next) => {
   }
 }
 
-const deletePlan = async (req, res, next) => {}
+const deletePlan = async (req, res, next) => {
+  const { protocol, method, hostname, originalUrl, params } = req
+  const headers = { ...req.headers }
+  const metaData = { protocol, method, hostname, originalUrl, headers, params }
+  logger.info(
+    `Requesting ${method} ${protocol}://${hostname}${originalUrl}`,
+    metaData
+  )
+  try {
+    const { planId } = params
+    if (planId === null || planId === '' || planId === '{}') {
+      throw new BadRequestError(`Invalid planId`)
+    }
+    const value = await findPlan(planId)
+    if (value.objectId === planId) {
+      // conditional delete based on `if-match` header
+      if (req.headers['if-match'] && value.ETag === req.headers['if-match']) {
+        const data = {
+          plan: JSON.parse(value.plan),
+        }
+        logger.info(`Item found`, JSON.parse(value.plan))
+        if (deleteByPlanId(planId)) {
+          logger.info(`Item deleted`, JSON.parse(value.plan))
+          noContentHandler(res, data)
+        } else {
+          throw new InternalServerError(`Item not deleted`)
+        }
+      } else {
+        throw new PreConditionFailedError(
+          `ETag provided in header is not valid`
+        )
+      }
+    } else {
+      throw new ResourceNotFoundError(`Plan not found`)
+    }
+  } catch (err) {
+    next(err)
+  }
+}
 
 export { getPlan, savePlan, deletePlan }