@dtorn/contact-api-core

The API that handles all contact-related requests from a website that implements it as the backend.

---

Node.js version: 12.20.0

---

Setup

npm install @dtorn/contact-api-core --save

Application structure

root
-- config
---- data.json
---- development.js
---- index.js
---- local.js
---- production.js
---- staging.js
-- language
---- el.js // any 'language code' could be here as long as it's added to the index.js's default language
---- index.js
-- public
---- images
-------- favicon.ico
-------- logo.png
.env
.env.development
.env.local
.env.production
.env.staging
index.js

Config

// config/data.json
{
  "users": [
    {
      "id": "671ec03e-edbb-4a3d-8dda-05558e05b0d0"
    }
  ]
}

// config/index.js
require("dotenv").config();
const local = require("./local");
const development = require("./development");
const staging = require("./staging");
const production = require("./production");

let config;

switch (process.env.NODE_ENV) {
  case "local":
    config = local;
    break;
  case "development":
    config = development;
    break;
  case "staging":
    config = staging;
    break;
  case "production":
    config = production;
    break;
  default:
    config = local;
    break;
}

module.exports = config;

// config/local.js
const Local = {
  apiPath: "",
  apiVersion: "",
  protocol: "",
  domain: "",
  url: "",
  website: {
    domain: "",
    url: "",
  },
  email: {
    contact: "",
    administrator: "",
  },
  launchYear: 0,
  preferences: {
    sendMessageEmail: false,
  },
};

module.exports = Local;

Language

// language/index.js
const EL = require("./el");

module.exports = {
  el: EL,
  default: "el",
};

// language/EL.js
module.exports = {
  identity: {
    brandName: "",
    legalName: "",
    address: "",
    postalCode: "",
    country: "",
    email: "",
    phone: "",
  },
  name: "",
  phone: "",
  email: "",
  message: "",
  thankYouTitle: "",
  thankYouForContactingUs: "",
  messageReceived: "",
  cantSeeThisMessage: "",
  viewItInBrowser: "",
  messageSent: "",
  yourContactDetails: "",
  thankYouMessage: "",
  moto: "",
  contactForm: {
    title: "",
    clientSubject: "",
  },
};

index.js

// index.js
require("contact-api-core");

.env

• Create a new .env file for each development environment. Usually it would be:

  • .env: the current debug environment
  • .env.local: local environment
  • .env.development: development environment (continuous integration)
  • .env.staging: staging environment (release testing)
  • .env.production: production environment

• local – used for workstation testing, e.g. http://localhost:8000

• development – used for development testing, e.g. https://dev.{DOMAIN_NAME}

• staging – used for release testing, e.g. https://sta.{DOMAIN_NAME}

• production – used for production, e.g. https://{DOMAIN_NAME}

# sample-env file

# NODE_ENV

# ENCRYPTION_KEY

# JWT_TOKEN_KEY
# JWT_TOKEN_EXPIRATION

# DB_USERNAME
# DB_PASSWORD
# DB_DATABASE
# DB_HOST
# DB_DIALECT

# EMAIL_HOST
# EMAIL_USERNAME
# EMAIL_PASSWORD

# Configure .env files
echo .sample-env > .env.local
echo .sample-env > .env.development
echo .sample-env > .env.staging
echo .sample-env > .env.production
echo .env.local > .env

Notes

Tools

• REST API response structure
• Sequelize ORM
• NodeMailer mailing service
• HeidiSQL program for testing the different database configuration environments
• Check headers handling

Guides

• Sequelize Setup w/ Sequelize CLI and associations

Changelog

14/04/2023 1.0.11

• Add support to define custom DB_PORT and PORT through environmental variables

09/05/2021 1.0.10

• Change the request data for the authorization request. Make it simplier by requiring just { id: '...' } instead of { user: { id: '' } }

07/03/2021 1.0.9

• Fix problematic path in validations hook file

07/03/2021 1.0.8

• Implement validation hooks in controllers and tested

07/03/2021 1.0.8-beta

• Implement validation hooks in controllers

22/02/2021 1.0.7

• Fix class issues regarding property declaration:
  • libs/external-request-verification-handler.js
  • libs/encrypt.js

20/02/2021 1.0.6

• Unsubscribe only if input email exists in messages
• Remove await from send email promise. The server must respond right after the record is stored in the database

19/02/2021 1.0.5

• Fix config/data.json path (from seeder file)
• Add console.log on sequelize actions

19/02/2021 1.0.4

• Fix config / language paths

19/02/2021 1.0.3

• Add morgan as a dependency instead of a dev dependency

19/02/2021 1.0.2

• Fix tests path issues (config and language)
• Better handle default config and language index files

19/02/2021 1.0.1

• Initial npm package publish
• Structure fixes
• Remove sensitive data

18/02/2021 1.0.0

• Restructure the project and make it generic
• Change email recepient in all environments except production to be the email.administrator