0.81.0

[Jericho]

As part of this release we had 2 issues closed.

Breaking Changes

• #392 Simplify the IWarmupEngine interface
• #391 send mail settings: bypass_spam_management vs. SpamChecking

Notes

I want to take a minute to highlight and explain the breaking changes related to MailSettings. In January 2020, SendGrid made the following announcement:

As we continuously modernize our email delivery infrastructure, we have retired select, sparsely used, and outdated features in order to improve efficiency. The features we have retired include Plain Text to HTML, Gravatar, Spam Checker, Drop Feature, and the Sendwithus integration.

Buried in this announcement, is the fact that they are retiring "Spam Checker" which I have to admit I did not notice at the time. Thanks to @tmacht for noticing this issue and for alerting me to the fact that the options available in StrongGrid did not correspond to SendGrid's documentation. "Spam Check" is therefore removed from the MailSettings in StrongGrid in 0.81.0 and also the ISettings.GetSpamCheckMailSettingsAsync and the ISettings.UpdateSpamCheckMailSettingsAsync methods are marked as Obsolete and will be removed in a future release.

In the process of investigating the issue raised by @tmacht, I uncovered two other changes that SendGrid made to their API which I had not noticed.

The first one was announced in December 2020:

As we continuously modernize our email delivery infrastructure, we have retired select, sparsely used, and outdated features in order to improve efficiency. The features we have retired include the Sections and BCC mail settings.

Notice that they are retiring "Sections" and "BCC", which explains why they are being removed from StrongGrid in 0.81.0 but also, notice their choice of words: they say the features being retired "include" Sections and BCC. Does that imply there are other features that were retired as well??? I haven't been able to determine what other features might have been removed from their API, but be aware that it's possible I might have missed something. Please let me know if you have additional information about the other features that have been retired.

The second one was not announced (as far as I know):

Four new settings are now available that allow you to control whether to bypass unsubscribe groups, the spam report list, the bounce list and the global unsubscribe list when sending an individual email.

Finally, I used this opportunity to make one more breaking change to the MailSettings class: the SandboxMode property has been simplified by changing to a Boolean. I hope you'll agree that it make's much simpler to turn on the sandbox mode.

Code Samples

In 0.80.0 and prior version:

var mailSettings = new MailSettings
{
  SandboxMode = new SandboxModeSettings
  {
    Enabled = true
  },
  Bcc = new BccSettings
  {
    Enabled = true,
    EmailAddress = "recipient@example.com"
  },
  BypassListManagement = new BypassListManagementSettings
  {
    Enabled = false
  },
  SpamChecking = new SpamCheckingSettings
  {
    Enabled = true,
    Threshold = 1,
    PostToUrl = "http://whatever.com"
  },
};

In 0.81.0:

var mailSettings = new MailSettings
{
  SandboxModeEnabled = true,
  BypassListManagement = false,
  BypassSpamManagement = true,
  BypassBounceManagement = false,
  BypassUnsubscribeManagement = true
};

Finally, please notice that the fact that Sections has been removed means that there is one fewer parameter when invoking the SendAsync, SendToSingleRecipientAsync and the SendToMultipleRecipientsAsync methods.

Final thoughts

I hope this helps clarify the breaking changes introduced in this release but feel free to join the discussion associated with this release if you have any question related to these changes.

---

This discussion was created from the release 0.81.0.