@dtorn/contact-api-core NPM

@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