csi-lk/aws-ses-local

Local Amazon Simple Email Service Server

Hi, my name is Callum 🧔‍♂️

I have been a Front End Developer for 12+ years now and run my own consultancy 🐓 grilks in Melbourne, Australia 🇦🇺.

I occasionally write articles and snippets on my personal website, csi.lk (or 🧔‍♂️.ml if you're interested).

I also have a lot of code and presentations open sourced below, check it out and let me know what you think.

aws-ses-local's Issues

Support sendRawEmail

sendRawEmail(params = {}, callback)

Write documentation

• Building
• Starting
• What is supported
• How to use

Security Vulnerability: Prototype Pollution

There is a vulnerability in lodash version 4.17.4. It looks like babel-core uses this dependency, and the version of babel-core that this library uses is still on version 4.17.4.

babel-core should be upgraded so that lodash is at least 4.17.5 which fixes the vulnerability. I believe babel-core version 6.26.3 will fix it.

Also see: https://nodesecurity.io/advisories/577

Result of npm audit on a project that uses this library:

# Run  npm update babel-core --depth 3  to resolve 14 vulnerabilities
┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-helpers  │
│               │ > babel-template > babel-traverse > lodash                   │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-template │
│               │ > babel-traverse > lodash                                    │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core >                │
│               │ babel-generator > babel-types > lodash                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-template │
│               │ > babel-types > lodash                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-helpers  │
│               │ > babel-template > babel-types > lodash                      │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-template │
│               │ > lodash                                                     │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core >                │
│               │ babel-generator > lodash                                     │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-traverse │
│               │ > babel-types > lodash                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-helpers  │
│               │ > babel-template > lodash                                    │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-traverse │
│               │ > lodash                                                     │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-helpers  │
│               │ > babel-template > babel-traverse > babel-types > lodash     │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-types >  │
│               │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > babel-template │
│               │ > babel-traverse > babel-types > lodash                      │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘


┌───────────────┬──────────────────────────────────────────────────────────────┐
│ Low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ lodash                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ aws-ses-local                                                │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ aws-ses-local > babel-register > babel-core > lodash         │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://nodesecurity.io/advisories/577                       │
└───────────────┴──────────────────────────────────────────────────────────────┘

Setup Code Coverage tool

Maybe something like Coveralls

Introduce server health check endpoint

@csi-lk 👋 Would you be open to introducing a server health check endpoint? If not I can fork but I'd rather make a contribution if you and/or others find it useful. The reason for the introduction is to wait for the SES service to become available to run any necessary tests in my application.

The intended endpoint introduced will be a GET / responding with a 200 👍

Manually include in code?

Is there an interface to manually require and start this from another program without using the CLI interface?

Cannot receive mail

Hello,
I have tried to send email with aws-ses-local.
And I have got the log like this:

📬 Email Received

From: {my address}

To: {my address}

Subject: hello

Html Email: /aws-ses-local/output/2020-10-20/01.57.17.14/body.html

Text Email: /aws-ses-local/output/2020-10-20/01.57.17.14/body.txt

But my mail box received nothing.

How can I know what I did wrong?

Support SendEmail

Support basic sendEmail(params = {}, callback) functionality with console output

Concat of current path & created email path bug

This line return to me a path like that, i need to replace ${process.cwd()} by empty string

My workspace is /Users/username/workspace/cleo/, and i launch the server here

Received Value : /Users/username/workspace/cleo//Users/vgiraud/workspace/cleo/var/mail/test/2018-04-11/13.24.29.06/body.txt

Expected Value : /Users/vgiraud/workspace/cleo/var/mail/test/2018-04-11/13.24.29.06/body.txt

I think we dont need the ${process.cwd()} at

aws-ses-local/src/send-email.js

Line 28 in a52ec70

successTemplate.replace('{{message}}', `${process.cwd()}/${path.join(fullDir)}/body.html`)

Regards,

Wrong response for sendRawEmail

I was getting an empty response back from SES when invoking sendRawEmail until I cloned success.xml as success-raw.xml and changed the file to:

 <?xml version="1.0" encoding="UTF-8"?>
 <SendRawEmailResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
 	<SendRawEmailResult>
 		<MessageId>{{message}}</MessageId>
 	</SendRawEmailResult>
 </SendRawEmailResponse>

and renamed the template in send-raw-email.js.

Deploy to NPM

Setup CI

For running tests

Test runtime arguments

Unfortunately I have no idea how to do this, would be great if anyone could point me in the right direction