deps: remove nodemailer from koru

Clients need to integrate their own email solutuions. The interface is directly compatible with
nodemailer.

Author: jacott

README.md

@@ -9,7 +9,7 @@ See [Getting started](doc/getting-started.md) and [Koru API documentation](https
 
 The MIT License (MIT)
 
-Copyright (c) 2014-2025 Geoff Jacobsen <geoffjacobsen@gmail.com>
+Copyright (c) 2014-2026 Geoff Jacobsen <geoffjacobsen@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

app/koru/email-test.js

@@ -2,8 +2,6 @@ isServer && define((require, exports, module) => {
   'use strict';
   const TH              = require('koru/test-helper');
   const util            = require('koru/util');
-  const NodeMailer      = requirejs.nodeRequire('nodemailer');
-  const SmtpStub        = requirejs.nodeRequire('nodemailer-stub-transport');
   const stream          = require('stream');
   const nodeUtil        = requirejs.nodeRequire('util');
 
@@ -23,49 +21,33 @@ isServer && define((require, exports, module) => {
     });
 
     test('send', async () => {
-      Email._transport = {
+      Email.initPool({
         sendMail(options, callback) {
           v.sendOpts = options;
           callback();
         },
-      };
+      });
       await Email.send(v.options = {from: 'foo@vimaly.com'});
 
       assert.same(v.sendOpts, v.options);
     });
 
-    test('initPool to stub', async () => {
-      const stub = SmtpStub();
-      let logCount = 0;
-      stub.on('log', function (info) {
-        ++logCount;
-        if (info.type === 'envelope') v.info = info;
-      });
+    test('stubPool', async () => {
+      stub(console, 'log');
 
-      Email.initPool(stub);
-      await Email.send(v.options = {
+      Email.stubPool();
+      await Email.send({
         from: 'foo@vimaly.com',
         to: 'bar@vimaly.com',
         subject: 'The subject',
         text: 'The text body',
       });
 
-      assert.same(logCount, 5);
-      assert.equals(JSON.parse(v.info.message), {
-        from: 'foo@vimaly.com', to: ['bar@vimaly.com']});
-    });
-
-    test('initPool to url', () => {
-      stub(NodeMailer, 'createTransport');
-
-      Email.initPool('smtp://foo:bar@vimaly.com:465');
-
-      assert.calledOnceWith(NodeMailer.createTransport, {
-        pool: true,
-        port: 465, host: 'vimaly.com',
-        auth: {user: 'foo', pass: 'bar'},
-        secure: false, requireTLS: true,
-      });
+      assert.calledOnce(console.log);
+      assert.equals(
+        console.log.firstCall.args[0],
+        'Email Stub:\nTo: bar@vimaly.com\nFrom: foo@vimaly.com\nSubject: The subject\n======== Text ===========\nThe text body\n======== HTML ===========\nundefined\n======== EOM ============',
+      );
     });
   });
 });

app/koru/email.js

@@ -1,54 +1,34 @@
 define((require) => {
   'use strict';
-  const Future          = require('koru/future');
-  const NodeMailer      = requirejs.nodeRequire('nodemailer');
-  const SmtpStub        = requirejs.nodeRequire('nodemailer-stub-transport');
-  const urlModule       = requirejs.nodeRequire('url');
-
   const Email = {
-    send: (options) => new Promise((resolve) => {Email._transport.sendMail(options, resolve)}),
-
-    initPool(urlOrTransport) {
-      if (typeof urlOrTransport === 'string') {
-        const mailUrl = urlModule.parse(urlOrTransport);
-        if (mailUrl.protocol !== 'smtp:') {
-          throw new Error("Email protocol must be 'smtp'");
-        }
-
-        const port = +(mailUrl.port);
-        let auth = false;
-        if (mailUrl.auth) {
-          const parts = mailUrl.auth.split(':', 2);
-          auth = {user: parts[0] && decodeURIComponent(parts[0]),
-                  pass: parts[1] && decodeURIComponent(parts[1])};
-        }
+    send: (options) =>
+      new Promise((resolve) => {
+        Email._transport.sendMail(options, resolve);
+      }),
+
+    initPool(transport) {
+      if (typeof transport.sendMail !== 'function') {
+        throw new Error('Invalid email transport');
+      }
 
-        Email._transport = NodeMailer.createTransport({
-          pool: true,
-          port: port || 25,
-          host: mailUrl.hostname || 'localhost',
-          secure: false,
-          requireTLS: port == 465,
-          auth,
-        });
-      } else {
-        if (urlOrTransport === undefined) {
-          urlOrTransport = SmtpStub();
+      Email._transport = transport;
+    },
 
-          urlOrTransport.on('log', (info) => {
-            switch (info.type) {
-            case 'message':
-              console.log(info.message
-                          .replace(/=([A-F0-9]{2})/g, (_, hex) => String.fromCharCode(parseInt(hex, 16)))
-                          .replace(/=\r\n/g, '').replace(/\r\n/g, '\n'));
-              break;
-            default:
-              console.log('====== Email ======');
-            }
-          });
-        }
-        Email._transport = NodeMailer.createTransport(urlOrTransport);
-      }
+    stubPool() {
+      Email.initPool({
+        sendMail(options, callback) {
+          console.log(`Email Stub:
+To: ${options.to}
+From: ${options.from}
+Subject: ${options.subject}
+======== Text ===========
+${options.text}
+======== HTML ===========
+${options.html}
+======== EOM ============`);
+          callback();
+        },
+      });
     },
 
     /** private */