This is a dome project to send email with attachment using Amazon SES and handling email matrix (Bounces,Complaints and Delivery) by configuring Amazon SNS consuming through SQS

Handling Bounces and Complaints:

• Monitor your bounces and complaints and remove any bounced or complained recipient addresses from your mailing list.
• Dashboard to see the status email delivery
• Dashboard to control and managing the blacklist

For technical details and configuring the sqs for handing the email delivery status watch below video

Note

• Update the accessKeyId,secretAccessKey,region and 3 SQS queue url in config->developed.json

The flow of Bounce and Complaint handling in AWS using SNS

• 1. First, we need to create an SNS Topic. An SNS Topic is a communication channel to send messages and subscribe to notifications. It provides an access point for publishers and subscribers to communicate with each other. The following code snippet will create an SNS Topic called 'bounce-complaint-topic'.
• 2. After creating the topic we'll now create a subscription request at Amazon SQS queue that can receive notification messages from Amazon SNS. Once you subscribe an endpoint to a topic and the subscription is confirmed, the endpoint will receive all messages published to that topic.
• 3. After confirming the subscription we'll now set the notifications types that will be published to the specified Amazon SNS topic,

ses-bounces-email (topic) to ses-bounces-email (queue)
ses-complaints-email (topic) to ses-complaints-email (queue)
ses-delivery-email (topic) to ses-delivery-email (queue)

All the APIs that are expose can be found in routes.

To run the project in development mode (environment: development), you need to configure environment variable in your startup file (like .bash_profile or .profile)

$ npm start

Determines the SES API is up and running with ok response

$ curl -X GET -H "Cache-Control: no-cache" "http://localhost/status"

Response

{
  "app": "amazon_ses",
  "version": "1.0.0"
}

Current API entry format:

{
  "error":{
    "code": "Unique error code defined in order to debug error easily(CQ01)",
    "errSource": "File from where error occurred (app.js)",  
    "function": "Function name (sendEmail)", 
    "message": "Message of the error (Unable to fetch the blacklist information)", 
    "description": "Description of the error message in detail", 
    "time": "Error occurred time in ISO format (2016-12-19T19:23:59.617Z)"
  },
  "data":{},
  "version": "1.0.0"
}

Mocha is a feature-rich JavaScript test framework running on Node.js Allows unit test all the system APIs

$ npm test

Postman Amazon SES API collection

- scripts /
    |__ postman /
            |__ Amazon-SES.postman_collection

- docker /
    |__ DockerFile
- scripts /
    |__ postman /
            |__ Amazon-SES.postman_collection
- src/
  |__ index.js
  |__ app.js
  |__ cleanup.js
  |__ public /
  |__ config /
      |__ development.json
      |__ production.json
  |__ controllers /
  |__ handlers
          |__ mongo /
                |__ mongoClient.js
          |__ logs.js
  |__ service /
          |__ sqsMatrixService.js
  |__ router.js    
  |__ tests /
	    |__ test.email.js
	    |__ test.blacklist.js
  |__ gulpfile.js
  |__ package.json
    

Amazon ses uses a number of open source projects to work properly:

• AngularJS - HTML enhanced for web apps!
• Twitter Bootstrap - great UI boilerplate for modern web apps
• node.js - Evented I/O for the backend
• Express - fast node.js network app framework
• MongoDB - MongoDB is a free and open-source cross-platform document-oriented database program.

Amazon SES uses a number of open source projects to make development faster, efficient and automate the build process:

• SES - Amazon Simple Email Service (Amazon SES) is a cost-effective email service built on the reliable and scalable infrastructure that Amazon.com developed to serve its own customer base
• SNS - Amazon Simple Notification Service (Amazon SNS) is a fast, flexible, fully managed push notification service that lets you send individual messages or to fan-out messages to large numbers of recipients.
• SQS - Amazon Simple Queue Service (SQS) is a fully-managed message queuing service for reliably communicating among distributed software components and microservices - at any scale.
• async - Async is a utility module which provides straight-forward, powerful functions for working with asynchronous JavaScript.
• Nodemailer - Nodemailer is a module for Node.js applications to allow easy as cake email sending.
• eslint - A plumbable and configurable linter tool for identifying and reporting on patterns in JavaScript. Maintain your code quality with ease.!
• gulp - Gulp is a toolkit for automating painful or time-consuming tasks in your development work flow, so you can stop messing around and build something.
• mocha - A test framework running on node.js and the browser which runs tests serially, mapping uncaught exceptions to the correct test cases.
• nodemon - Nodemon is a utility that will monitor for any changes in your source and automatically restart your server.
• should - should is an expressive, readable, framework-agnostic assertion library.
• supertest - Super-agent driven library for testing node.js HTTP servers using a fluent API

• Clone the branch from github.
• Install MongoDB.
• Config the all the server details into one of the config file.

Install the dependencies and dev dependencies and start the server.

$ cd src
$ npm install
$ npm start

Install the gulp command

$ npm install --global gulp-cli

Runs run gulp automatically rebuilds and check for eslint code quality

$ gulp

• Need to need high efficiency of sending email use RabbitMQ
• Charts to see the success / failure email delivery status