Migration Guide

v0.7.0 to v1.0.0

No breaking changes. v1.0.0 adds provider failover support as an additive feature.

New features:

• FailoverManager class
• failover config option (global and per-mailer)
• onFailover callback
• MailResponse now includes provider, failoverUsed, failoverAttempts
• MailFake.simulateFailures() / resetFailures() for testing failover
• AssertableMessage failover methods: wasFailoverUsed(), getProvider(), getFailoverAttempts(), getResponse()

To adopt failover

Mail.configure({
  // ... existing config
  failover: {
    chain: ['sendgrid', 'ses'],
    maxRetriesPerProvider: 2,
  },
});

Version History