Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

nodemailer-direct-transport

andris9380.7kMIT3.3.2TypeScript support: definitely-typed

Direct transport for Nodemailer

SMTP, Nodemailer

readme

Direct SMTP transport module for Nodemailer

Applies for Nodemailer v1.x and not for v0.x where transports are built-in.

Usage

Install with npm

npm install nodemailer-direct-transport

Require to your script

var nodemailer = require('nodemailer');
var directTransport = require('nodemailer-direct-transport');

Create a Nodemailer transport object

var transporter = nodemailer.createTransport(directTransport(options))

Where

  • options defines connection data
    • options.name hostname to be used when introducing the client to the MX server
    • options.logger optional bunyan compatible logger instance. If set to true then logs to console. If value is not set or is false then nothing is logged
    • options.debug if set to true, then logs SMTP traffic, otherwise logs only transaction events
    • options.port optional port to use for connecting to MX servers (defaults to MTA standard 25)
    • options.retryDelay optional timeout in ms for retrying failed messages (defaults to 15 minutes)
    • getSocket optional method that is called every time a new connection is made against the SMTP server. This method can provide an existing socket to be used instead of creating a new one

Example

var transport = nodemailer.createTransport(directTransport({
    name: 'smtp.example.com' // should be the hostname machine IP address resolves to
}));

send callback

Send callback includes the following arguments

  • error if the mail was not sent
    • error.errors is an array of error responses (one response for one MX exchange)
      • error.errors[].recipients an array of failed recipients
      • error.errors[].response Error response from the SMTP server
  • info if at least one mail was sent or is pending
    • info.accepted an array of recipients that were accepted
    • info.rejected an array of recipients that were rejected
    • info.pending an array of pending recipient objects (messages that were not rejected permanently and are retried later)
      • info.pending[].recipients an array of recipient addresses that are still pending
      • info.pending[].response Response from the SMTP server
    • info.errors An array of errors (for these exhanges that rejected mail)

Issues

Direct transport is very inefficient as it queues all e-mails to be sent into memory. Additionally, if a message is not yet sent and the process is closed, all data about queued messages is lost. Thus direct transport is only suitable for low throughput systems, where the message can be processed immediately.

While not being 100% reliable (remember - if process exits, entire queue is lost), direct transport can still handle sending errors, graylisting and such. If a message can not be sent, it is re-queued and retried later.

License

MIT

changelog

Changelog

3.3.2 2016-09-05

  • Fetch envelope from message object

v3.3.0 2016-09-05

  • Updated dependencies

v3.2.0 2016-07-08

  • If the first MX fails, then try the next one

v3.1.0 2016-05-11

  • Bumped dependencies

v3.0.7 2016-04-11

  • Upgraded smtp-connection to fix issues with internationalized email addresses

v3.0.5 2016-02-17

  • Yet another smtp-connection bump

v3.0.4 2016-02-16

  • Yet another smtp-connection bump to get proxied sockets working

v3.0.3 2016-02-15

  • Bumped smtp-connection dependency to fix an issue with proxied sockets and TLS

v3.0.2 2016-02-13

  • Fixed an issue with proxy support

v3.0.1 2016-02-11

  • Bumped dependencies

v3.0.0 2016-02-11

  • Bumped dependencies
  • Always try to use STARTTLS first and fallback to plaintext if it fails

v2.1.1 2016-02-10

  • Bumped dependencies

v2.1.0 2016-02-09

  • Added new option getSocket

v2.0.1 2016-01-20

  • Bumped dependencies

v2.0.0 2016-01-04

  • Locked dependencies

v2.0.0-beta.1 2016-01-04

  • Fixed invalid source ulr in package.json

v2.0.0-beta.0 2016-01-04

  • Replaced jshint with eslint
  • Replaced logger interface. Instead of emitting 'log' events, use a bunyan-compatible logger
  • Support IPv6 literal addresses

v1.1.0 2015-10-08

If MX record is not found, fallback to A or AAAA

v1.0.2 2015-03-09

Bumped smtp-connection version and replaced simplesmtp based tests with smtp-server based ones.

v1.0.0 2014-07-30

Fixed a bug with stream buffering. Uses mail.resolveContent provided by Nodemailer v1.1.

As the change includes a method from Nodemailer 1.1 and not 1.0, then changed the version scheme to use proper semver instead of 0.x.