JavaScript (v3): Add SES SendRawEmail example using nodemailer.

.doc_gen/metadata/ses_metadata.yaml

@@ -62,6 +62,24 @@ ses_SendBulkTemplatedEmail:
                 - ses.JavaScript.email.sendBulkTemplatedEmailV3
   services:
     ses: {SendBulkTemplatedEmail}
+ses_SendRawEmail:
+  title: Send a raw email with &SES; using an &AWS; SDK
+  title_abbrev: Send raw email
+  synopsis: send a raw email with &SES;.
+  category:
+  languages:
+    JavaScript:
+        versions:
+            - sdk_version: 3
+              github: javascriptv3/example_code/ses
+              sdkguide:
+              excerpts:
+                - description: Use <ulink url="https://nodemailer.com/transports/ses/">nodemailer</ulink> to send an email
+                    with an attachment.
+                  snippet_tags:
+                    - javascript.v3.ses.attachment
+  services:
+    ses: {SendRawEmail}
 ses_SendTemplatedEmail:
   title: Send templated email with &SES; using an &AWS; SDK
   title_abbrev: Send templated email

javascriptv3/example_code/ses/package.json

@@ -9,9 +9,11 @@
     "integration-test": "vitest run **/*.integration.test.js"
   },
   "dependencies": {
-    "@aws-sdk/client-ses": "^3.215.0"
+    "@aws-sdk/client-ses": "^3.215.0",
+    "nodemailer": "^6.9.4"
   },
   "devDependencies": {
+    "@types/nodemailer": "^6.4.9",
     "vitest": "^0.25.2"
   }
 }

javascriptv3/example_code/ses/src/send-with-attachments.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {fileURLToPath} from "url";
+
+// snippet-start:[javascript.v3.ses.attachment]
+import sesClientModule from "@aws-sdk/client-ses";
+/**
+ * nodemailer wraps the SES SDK and calls SendRawEmail. Use this for more advanced
+ * functionality like adding attachments to your email.
+ *
+ * https://nodemailer.com/transports/ses/
+ */
+import nodemailer from "nodemailer";
+
+/**
+ * @param {string} from An Amazon SES verified email address.
+ * @param {*} to An Amazon SES verified email address.
+ */
+export const sendEmailWithAttachments = (
+  from = "[email protected]",
+  to = "[email protected]"
+) => {
+  const ses = new sesClientModule.SESClient({});
+  const transporter = nodemailer.createTransport({
+    SES: {ses, aws: sesClientModule},
+  });
+
+  return new Promise((resolve, reject) => {
+    transporter.sendMail(
+      {
+        from,
+        to,
+        subject: "Hello World",
+        text: "Greetings from Amazon SES!",
+        attachments: [{content: "Hello World!", filename: "hello.txt"}],
+      },
+      (err, info) => {
+        if (err) {
+          reject(err);
+        } else {
+          resolve(info);
+        }
+      }
+    );
+  });
+};
+// snippet-end:[javascript.v3.ses.attachment]
+
+// Invoke main function if this file was run directly.
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  sendEmailWithAttachments();
+}