node-amazon-ses-simulator

node-amazon-ses-simulator

A local server that simulates responses from Amazon's Simple Email Service (SES).

Getting Started

Install locally and run with:

npm install -D node-amazon-ses-simulator
node ./node_modules/node-amazon-ses-simulator/index.js --help

Otherwise, install globally:

npm install -g node-amazon-ses-simulator
node-amazon-ses-simulator --help

Your server's AWS.SES config will need to point towards the right endpoint:

const ses = new AWS.SES({
    accessKeyId,
    secretAccessKey,
    secretKey,
    region,
    endpoint: 'http://localhost:9999' // See this line
  });

What and why

Put simply - this server will respond with valid XML that Amazon's SDK will accept.

Amazon have their own test server but it isn't free - with the same cost as regular emails. This can be frustrating when you need to test services sending large volumes of emails.

Command line args

This module accepts several arguments. All are optional.

Name	Type	Description	Default
-h --host	string	Set the hostname	localhost
-p --port	number	Set the port	9999
-i --interval	number	Interval between req reports (ms)	1000
-v --validate	boolean	Should validate emails	false
-e --error	number	Percentage chance of throttling error	0