@sublet/hulk-express-mongo

HulkSmash! Express Server

Pre-built Express server that allows you to get up and running quickly.

Under the hood this utilizes Express and Mongo to get you up and running quickly with very little setup. Additionally I am fond of Papertrail so I use that for logging.

Environment Variables

The config is currently pre-setup for you so all you need to do is provide the correct environment variables.

PORT=3000
MONGO_URI=mongodb://localhost
MONGO_DB=freebyrd-api-local
PAPERTRAIL_HOSTNAME=sample-api
PAPERTRAIL_URI=*****.papertrailapp.com
PAPERTRAIL_PORT=*****

Installation and Usage

Install by enter one of the commands below.

npm install @sublet/hulk-express-mongo

-or-

yarn add @sublet/hulk-express-mongo

Once installed, create an app.js file at the root level

const path = require('path')

const config = {
  port: process.env.EXPRESS_PORT || '3000',
  bind: '127.0.0.1',
  appFolder: path.join(__dirname, 'app'),
  wrapAsync: (fn, validate = false) => {
    return function(req, res, next) {

      if (validate) fn(req, res, next).catch(next)

      // Make sure to `.catch()` any errors and pass them along to the `next()`
      // middleware in the chain, in this case the error handler.
      if (!validate) fn(req, res, next).catch(next)
    }
  }
}

const server = require('@sublet/hulk-express-mongo')(config)

server.setupAndCreate()

module.exports = server

This can then be pulled into your app and the subfunctions can be accessed.

Example of starting the server.

#!/usr/bin/env node

/**
 * Environment variable validation
 */
require('dotenv').config()

const server = require('../app');

server.start()

Quick Project Setup: CLI

Install the library globaly so you can access the CLI.

npm i -g @sublet/hulk-express-mongo

hulk-smash init

Create an API

hulk-smash template:api --title users

Create a Service

hulk-smash template:service --title users

Copy Default Environment Variables

cp sample.env .env

Scripts section to make Makefile commands work

"scripts": {
  "start": "sls offline start --skipCacheInvalidation --dontPrintOutput --noPrependStageInUrl --lambdaPort 3005 --httpPort 3040",
  "test": "NODE_ENV=test nyc --reporter=html --reporter=text make test-all",
  "lint": "eslint ./"
},
"engines": {
  "node": ">=14.15.1"
},

Install Dependencies

npm i @sublet/hulk-express-mongo app-module-path aws-config aws-sdk axios bluebird boom ejs md5 moment numeral request serverless-http uuidv4

Install Dev Dependencies

npm i chai chai-http eslint mocha nyc pre-commit require-directory serverless serverless-offline should supertest --save-dev