AWS Lambda for sending emails. Ready for deployment in 60 seocnds.
This lambda gives your browser (or any client) a backend for sending emails.
- 30+ pre-configured services (Gmail, Hotmail, SendGrid...etc)
- HTML content as well as plain text alternative
- 30+ supported HTML template engines (handlebars, jade, haml...etc)
- Easy HTML styling with Juice
- Embedded images in HTML
- Email Attachments
- Unicode to use any characters
// install node-lambda
npm install -g node-lambda
// clone the lambda and get inside!
git clone https://github.com/eahefnawy/lambda-mailer.git
cd lambda-mailer
// install dependencies
npm install
// create deployment files (to hold your env vars)
touch .env deploy.env event.json
.env file is used by your local machine to test and deploy the lambda, deploy.env is used by your lambda function after deployment. So there might be some duplicate env vars.
open .env and fill it with your AWS credentials: (make sure you have proper IAM permissions)
AWS_ENVIRONMENT=dev
AWS_ACCESS_KEY_ID=your_key
AWS_SECRET_ACCESS_KEY=your_secret
AWS_SESSION_TOKEN=your_sesson token (optional)
AWS_ROLE_ARN=your_amazon_role
AWS_REGION=us-east-1
AWS_FUNCTION_NAME=your_lambda_name
AWS_HANDLER=index.handler
AWS_MODE=event
AWS_MEMORY_SIZE=128
AWS_TIMEOUT=60
AWS_DESCRIPTION=your_lambda_description
AWS_RUNTIME=nodejs
CONFIG_FILE=deploy.env
EMAIL_SERVICE=gmail
[email protected]
EMAIL_SERVICE_PASS=password
open deploy.env and fill it with your gmail credentials:
EMAIL_SERVICE=gmail
[email protected]
EMAIL_SERVICE_PASS=password
open event.json and fill it with the following sample event: (just change the to and from Properties)
{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Hello",
"template": "welcome",
"context": {
"first_name": "Sam",
"last_name": "Smith"
}
}
now everything is set! Let's test locally!
node-lambda run
This will use the welcome template coupled with the context/data (first_name & last_name).
You should receive an email that says:
Welcome Sam Smith
You can edit the template text by editing these two files:
lambda-mailer/templates/welcome/html.handlebars
lambda-mailer/templates/welcome/text.handlebars
now that it works locally, let's deploy to AWS:
node-lambda deploy
That's it! Now you can call the lambda from any AWS SDK, like your browser JS SDK.
lambda-mailer supports the following 30 service, pre-configured and ready to use. You just provide the service, username & password in env vars as shown earlier:
- '1und1'
- 'AOL'
- 'DebugMail.io'
- 'DynectEmail'
- 'FastMail'
- 'GandiMail'
- 'Gmail'
- 'Godaddy'
- 'GodaddyAsia'
- 'GodaddyEurope'
- 'hot.ee'
- 'Hotmail'
- 'iCloud'
- 'mail.ee'
- 'Mail.ru'
- 'Mailgun'
- 'Mailjet'
- 'Mandrill'
- 'Naver'
- 'Postmark'
- 'QQ'
- 'QQex'
- 'SendCloud'
- 'SendGrid'
- 'SES'
- 'Sparkpost'
- 'Yahoo'
- 'Yandex'
- 'Zoho'
lambda-mailer comes with a welcome template for demonstration. You can add/remove templates from the following directory:
lambda-mailer/templates/
lambda-mailer uses handlebars as the default template engine. You can use any other template engine by adding it to the package.json file and update dependencies with npm install.
Here's the full list of supported templates:
- atpl
- doT.js (website)
- dust (unmaintained) (website)
- dustjs-linkedin (maintained fork of dust) (website)
- eco
- ect (website)
- ejs
- haml (website)
- haml-coffee (website)
- hamlet
- handlebars (website)
- hogan (website)
- htmling
- jade (website)
- jazz
- jqtpl (website)
- JUST
- liquor
- lodash (website)
- mote (website)
- mustache
- nunjucks (website)
- QEJS
- ractive
- react
- swig (website)
- templayed
- liquid (website)
- toffee
- underscore (website)
- walrus (website)
- whiskers
after chosing your template engine, make sure the file extentions of the template files match the template you chose:
html.{{ext}}
text.{{ext}}
style.{{ext}}
Here's the full list of options you can pass in your event:
- from - The e-mail address of the sender. All e-mail addresses can be plain
'[email protected]'or formatted'Sender Name <[email protected]>', see here for details - sender - An e-mail address that will appear on the Sender: field
- to - Comma separated list or an array of recipients e-mail addresses that will appear on the To: field
- cc - Comma separated list or an array of recipients e-mail addresses that will appear on the Cc: field
- bcc - Comma separated list or an array of recipients e-mail addresses that will appear on the Bcc: field
- replyTo - An e-mail address that will appear on the Reply-To: field
- inReplyTo - The message-id this message is replying
- references - Message-id list (an array or space separated string)
- subject - The subject of the e-mail
- template - The template to use for this email. Make sure it matches one of the folder names inside the
templatesfolder - context - The context/data the template needs. eg.
{"first_name": "..."} - watchHtml - Apple Watch specific HTML version of the message (experimental)
- headers - An object or array of additional header fields (e.g. {"X-Key-Name": "key value"} or [{key: "X-Key-Name", value: "val1"}, {key: "X-Key-Name", value: "val2"}])
- attachments - An array of attachment objects
- alternatives - An array of alternative text contents (in addition to text and html parts)
- envelope - optional SMTP envelope, if auto generated envelope is not suitable
- messageId - optional Message-Id value, random value will be generated if not set
- date - optional Date value, current UTC string will be used if not set
- encoding - optional transfer encoding for the textual parts