ses.md

ses Event type

The ses event type allows you to handle events generated from the AWS Simple Email service (SES). The event type is a record-based event type and can contain one or more records. The following is a sample event from the AWS Lambda documentation:

{
    "Records": [
        {
            "eventVersion": "1.0",
            "ses": {
                "mail": {
                    "commonHeaders": {
                        "from": [
                            "Jane Doe <janedoe@example.com>"
                        ],
                        "to": [
                            "johndoe@example.com"
                        ],
                        "returnPath": "janedoe@example.com",
                        "messageId": "<0123456789example.com>",
                        "date": "Wed, 7 Oct 2015 12:34:56 -0700",
                        "subject": "Test Subject"
                    },
                    "source": "janedoe@example.com",
                    "timestamp": "1970-01-01T00:00:00.000Z",
                    "destination": [
                        "johndoe@example.com"
                    ],
                    "headers": [
                        {
                            "name": "Return-Path",
                            "value": "<janedoe@example.com>"
                        },
                        {
                            "name": "Received",
                            "value": "from mailer.example.com (mailer.example.com [203.0.113.1]) by inbound-smtp.us-west-2.amazonaws.com with SMTP id o3vrnil0e2ic28trm7dfhrc2v0cnbeccl4nbp0g1x for johndoe@example.com; Wed, 07 Oct 2015 12:34:56 +0000 (UTC)"
                        },
                        {
                            "name": "DKIM-Signature",
                            "value": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=example.com; s=example; h=mime-version:from:date:message-id:subject:to:content-type; bh=jX3F0bCAI7sIbkHyy3mLYO28ieDQz2R0P8HwQkklFj4x=; b=sQwJ+LMe9RjkesGu+vqU56asvMhrLRRYrWCbVt6WJulueecwfEwRf9JVWgkBTKiL6m2hr70xDbPWDhtLdLO+jB3hzjVnXwK3pYIOHw3vxG6NtJ6o61XSUwjEsp9tdyxQjZf2HNYee873832l3K1EeSXKzxYk9Pwqcpi3dMC74ct9GukjIevf1H46hm1L2d9VYTL0LGZGHOAyMnHmEGB8ZExWbI+k6khpurTQQ4sp4PZPRlgHtnj3Zzv7nmpTo7dtPG5z5S9J+L+Ba7dixT0jn3HuhaJ9b+VThboo4YfsX9PMNhWWxGjVksSFOcGluPO7QutCPyoY4gbxtwkN9W69HA=="
                        },
                        {
                            "name": "MIME-Version",
                            "value": "1.0"
                        },
                        {
                            "name": "From",
                            "value": "Jane Doe <janedoe@example.com>"
                        },
                        {
                            "name": "Date",
                            "value": "Wed, 7 Oct 2015 12:34:56 -0700"
                        },
                        {
                            "name": "Message-ID",
                            "value": "<0123456789example.com>"
                        },
                        {
                            "name": "Subject",
                            "value": "Test Subject"
                        },
                        {
                            "name": "To",
                            "value": "johndoe@example.com"
                        },
                        {
                            "name": "Content-Type",
                            "value": "text/plain; charset=UTF-8"
                        }
                    ],
                    "headersTruncated": false,
                    "messageId": "o3vrnil0e2ic28trm7dfhrc2v0clambda4nbp0g1x"
                },
                "receipt": {
                    "recipients": [
                        "johndoe@example.com"
                    ],
                    "timestamp": "1970-01-01T00:00:00.000Z",
                    "spamVerdict": {
                        "status": "PASS"
                    },
                    "dkimVerdict": {
                        "status": "PASS"
                    },
                    "processingTimeMillis": 574,
                    "action": {
                        "type": "Lambda",
                        "invocationType": "Event",
                        "functionArn": "functionarn"
                    },
                    "spfVerdict": {
                        "status": "PASS"
                    },
                    "virusVerdict": {
                        "status": "PASS"
                    }
                }
            },
            "eventSource": "aws:ses"
        }
    ]
}

To map the event using Vandium, we would use the ses() handler:

const vandium = require( 'vandium' );

exports.handler = vandium.ses( (records, context) => {

        // handle the event
    });

Your handler can return a Promise or value. If you require the use of a callback function for asynchronous operations that cannot be done using Promises, then you can provide a callback parameter in your code.

const vandium = require( 'vandium' );

exports.handler = vandium.ses( (records, context, callback) => {

        // handle the event

        callback( null, { /* response here */} );
    });