Releases: Jericho/StrongGrid
0.82.0
0.81.0
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 = "[email protected]"
},
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.
0.80.0
0.79.0
0.78.0
As part of this release we had 6 issues closed.
Bug
- #384 Importing contacts does not work
New Features
- #385 Get multiple Contacts by Id
- #382 Get Contacts by Email
- #381 Import Contacts via Compressed CSV Files
- #380 Allow sender to be personalized when sending email to multiple recipients
Improvement
- #378 Target net5.0
0.77.0
0.76.0
As part of this release we had 45 commits which resulted in 7 issues being closed.
Breaking Changes
- #364 Add unofficial support for /v3/suppression/unsubscribes?email=some-text
- #362 Typo in method name UpdatBouncePurgeMailSettingsAsync
- #358 Changes in "Click Track Settings" retrieve and update endpoints
Bugs
- #363 Custom JsonConverter ignored when an enumerable property is added to Json object
- #357 Unable to set the ReplyTo when creating a sender identity
- #356 Updating Legacy sender identity does not work
Improvement
- #360 Unable to get the from email