Add support for custom email headers via JSON input (#264)

* Adding custom header with JSON support

* Adding headers in test workflow

---------

Co-authored-by: W506810_wexinc <spiros.kalogeropoulos@wexinc.com>

.github/workflows/test.yml

@@ -46,6 +46,7 @@ jobs:
           convert_markdown: true
           attachments: package.json,action.yml
           priority: high
+          headers: '{"X-My-Test-Header": "Passed"}'
 
       - name: Get mail
         run: |

README.md

@@ -63,6 +63,8 @@ Some features:
     attachments: attachments.zip,git.diff,./dist/static/*.js
     # Optional priority: 'high', 'normal' (default) or 'low'
     priority: low
+    # Optional custom headers:
+    headers: '{"X-Priority": "3 (Normal)", "X-My-Header": "MyValue"}'
     # Optional nodemailerlog: true/false
     nodemailerlog: false
     # Optional nodemailerdebug: true/false if true lognodem will also be set true

action.yml

@@ -57,6 +57,9 @@ inputs:
   priority:
     description: Set Priority level for the mail message to 'high', 'normal' (default) or 'low'
     required: false
+  headers:
+    description: 'Custom headers for the mail message as a JSON string (e.g., {"X-Custom-Header": "value"})'
+    required: false
   nodemailerlog:
     description: Log option for nodemailer
     required: false

main.js

@@ -115,6 +115,7 @@ async function main() {
             required: false,
         });
         const envelopeTo = core.getInput("envelope_to", { required: false });
+        const headers = core.getInput("headers", { required: false });
 
         // if neither to, cc or bcc is provided, throw error
         if (!to && !cc && !bcc) {
@@ -166,6 +167,7 @@ async function main() {
                         ? getText(htmlBody, convertMarkdown)
                         : undefined,
                     priority: priority ? priority : undefined,
+                    headers: headers ? JSON.parse(headers) : undefined,
                     attachments: attachments
                         ? await getAttachments(attachments)
                         : undefined,

node_modules/.package-lock.json

@@ -185,9 +185,9 @@
       }
     },
     "node_modules/minimatch": {
-      "version": "3.1.2",
+      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.3.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "integrity": "sha512-M2GCs7Vk83NxkUyQV1bkABc4yxgz9kILhHImZiBPAZ9ybuvCb0/H7lEl5XvIg3g+9d4eNotkZA5IWwYl0tibaA==",
       "license": "ISC",
       "dependencies": {
         "brace-expansion": "^1.1.7"
@@ -197,9 +197,9 @@
       }
     },
     "node_modules/nodemailer": {
-      "version": "8.0.0",
+      "version": "8.0.1",
-      "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-8.0.0.tgz",
+      "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-8.0.1.tgz",
-      "integrity": "sha512-xvVJf/f0bzmNpnRIbhCp/IKxaHgJ6QynvUbLXzzMRPG3LDQr5oXkYuw4uDFyFYs8cge8agwwrJAXZsd4hhMquw==",
+      "integrity": "sha512-5kcldIXmaEjZcHR6F28IKGSgpmZHaF1IXLWFTG+Xh3S+Cce4MiakLtWY+PlBU69fLbRa8HlaGIrC/QolUpHkhg==",
       "license": "MIT-0",
       "engines": {
         "node": ">=6.0.0"

node_modules/minimatch/minimatch.js

@@ -390,6 +390,9 @@ function parse (pattern, isSub) {
           continue
         }
 
+        // coalesce consecutive non-globstar * characters
+        if (c === '*' && stateChar === '*') continue
+
         // if we already have a stateChar, then it means
         // that there was something like ** or +? in there.
         // Handle the stateChar, then proceed with this one.

node_modules/minimatch/package.json

@@ -2,9 +2,9 @@
   "author": "Isaac Z. Schlueter <i@izs.me> (http://blog.izs.me)",
   "name": "minimatch",
   "description": "a glob matcher in javascript",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "publishConfig": {
-    "tag": "v3-legacy"
+    "tag": "legacy-v3"
   },
   "repository": {
     "type": "git",

node_modules/nodemailer/CHANGELOG.md

@@ -1,5 +1,14 @@
 # CHANGELOG
 
+## [8.0.1](https://github.com/nodemailer/nodemailer/compare/v8.0.0...v8.0.1) (2026-02-07)
+
+
+### Bug Fixes
+
+* absorb TLS errors during socket teardown ([7f8dde4](https://github.com/nodemailer/nodemailer/commit/7f8dde41438c66b8311e888fa5f8c518fcaba6f1))
+* absorb TLS errors during socket teardown ([381f628](https://github.com/nodemailer/nodemailer/commit/381f628d55e62bb3131bd2a452fa1ce00bc48aea))
+* Add Gmail Workspace service configuration ([#1787](https://github.com/nodemailer/nodemailer/issues/1787)) ([dc97ede](https://github.com/nodemailer/nodemailer/commit/dc97ede417b3030b311771541b1f17f5ca76bcbf))
+
 ## [8.0.0](https://github.com/nodemailer/nodemailer/compare/v7.0.13...v8.0.0) (2026-02-04)
 
 

node_modules/nodemailer/lib/smtp-connection/index.js

@@ -15,6 +15,7 @@ const CONNECTION_TIMEOUT = 2 * 60 * 1000; // how much to wait for the connection
 const SOCKET_TIMEOUT = 10 * 60 * 1000; // how much to wait for socket inactivity before disconnecting the client
 const GREETING_TIMEOUT = 30 * 1000; // how much to wait after connection is established but SMTP greeting is not receieved
 const DNS_TIMEOUT = 30 * 1000; // how much to wait for resolveHostname
+const TEARDOWN_NOOP = () => {}; // reusable no-op handler for absorbing errors during socket teardown
 
 /**
  * Generates a SMTP connection object
@@ -505,6 +506,9 @@ class SMTPConnection extends EventEmitter {
                 socket.removeListener('end', this._onSocketEnd);
                 socket.removeListener('error', this._onSocketError);
                 socket.removeListener('error', this._onConnectionSocketError);
+                // Absorb errors that may fire during socket teardown (e.g. server
+                // sending cleartext after TLS shutdown triggers ERR_SSL_BAD_RECORD_TYPE)
+                socket.on('error', TEARDOWN_NOOP);
                 socket[closeMethod]();
             } catch (_E) {
                 // just ignore

node_modules/nodemailer/lib/well-known/services.json

@@ -147,6 +147,14 @@
         "secure": true
     },
 
+    "GmailWorkspace": {
+        "description": "Gmail Workspace",
+        "aliases": ["Google Workspace Mail"],
+        "host": "smtp-relay.gmail.com",
+        "port": 465,
+        "secure": true
+    },
+
     "GMX": {
         "description": "GMX Mail",
         "domains": ["gmx.com", "gmx.net", "gmx.de"],

node_modules/nodemailer/package.json

@@ -1,6 +1,6 @@
 {
     "name": "nodemailer",
-    "version": "8.0.0",
+    "version": "8.0.1",
     "description": "Easy as cake e-mail sending from your Node.js applications",
     "main": "lib/nodemailer.js",
     "scripts": {
@@ -26,12 +26,12 @@
     },
     "homepage": "https://nodemailer.com/",
     "devDependencies": {
-        "@aws-sdk/client-sesv2": "3.975.0",
+        "@aws-sdk/client-sesv2": "3.985.0",
         "bunyan": "1.8.15",
         "c8": "10.1.3",
-        "eslint": "9.39.2",
+        "eslint": "10.0.0",
         "eslint-config-prettier": "10.1.8",
-        "globals": "17.1.0",
+        "globals": "17.3.0",
         "libbase64": "1.3.0",
         "libmime": "5.3.7",
         "libqp": "2.1.1",
@@ -39,7 +39,7 @@
         "prettier": "3.8.1",
         "proxy": "1.0.2",
         "proxy-test-server": "1.0.0",
-        "smtp-server": "3.18.0"
+        "smtp-server": "3.18.1"
     },
     "engines": {
         "node": ">=6.0.0"

package-lock.json

@@ -8,7 +8,7 @@
       "dependencies": {
         "@actions/core": "^3.0.0",
         "@actions/glob": "^0.6.1",
-        "nodemailer": "^8.0.0",
+        "nodemailer": "^8.0.1",
         "showdown": "^1.9.1"
       }
     },
@@ -194,9 +194,9 @@
       }
     },
     "node_modules/minimatch": {
-      "version": "3.1.2",
+      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.3.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "integrity": "sha512-M2GCs7Vk83NxkUyQV1bkABc4yxgz9kILhHImZiBPAZ9ybuvCb0/H7lEl5XvIg3g+9d4eNotkZA5IWwYl0tibaA==",
       "license": "ISC",
       "dependencies": {
         "brace-expansion": "^1.1.7"
@@ -206,9 +206,9 @@
       }
     },
     "node_modules/nodemailer": {
-      "version": "8.0.0",
+      "version": "8.0.1",
-      "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-8.0.0.tgz",
+      "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-8.0.1.tgz",
-      "integrity": "sha512-xvVJf/f0bzmNpnRIbhCp/IKxaHgJ6QynvUbLXzzMRPG3LDQr5oXkYuw4uDFyFYs8cge8agwwrJAXZsd4hhMquw==",
+      "integrity": "sha512-5kcldIXmaEjZcHR6F28IKGSgpmZHaF1IXLWFTG+Xh3S+Cce4MiakLtWY+PlBU69fLbRa8HlaGIrC/QolUpHkhg==",
       "license": "MIT-0",
       "engines": {
         "node": ">=6.0.0"

package.json

@@ -5,7 +5,7 @@
   "dependencies": {
     "@actions/core": "^3.0.0",
     "@actions/glob": "^0.6.1",
-    "nodemailer": "^8.0.0",
+    "nodemailer": "^8.0.1",
     "showdown": "^1.9.1"
   }
 }