Skip to content

CHANGELOG.md

Latest commit

 

History

History
111 lines (88 loc) · 3.94 KB

CHANGELOG.md

File metadata and controls

111 lines (88 loc) · 3.94 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.3.0]

Added

  • SMTP configuration override per mailer context via SmtpConfigOverride property on IMailerContext / MailerContextAbstract. Allows sending emails through different SMTP servers depending on the mailer context.
  • OnConfigureSmtpClient(SmtpClient client) hook on IMailerContext / MailerContextAbstract. Override this in your mailer context to configure the full MailKit SmtpClient before it connects (e.g., ServerCertificateValidationCallback, ClientCertificates, ProxyClient, Timeout, AuthenticationMechanisms, etc.).
  • New AddAspNetCoreMailKitMailer(Action<SmtpClient>) extension overload for registering services with a client configuration action only.
  • All existing AddAspNetCoreMailKitMailer overloads now accept an optional Action<SmtpClient> parameter for global client configuration at registration time.

Changed

  • Refactored MailClient internals to reduce duplicated code by extracting _ResolveContext, _ResolveSmtpConfig, and _SendMessageAsync helper methods.
  • Updated all dependencies to latest versions:
    • MailKit 4.14.1 → 4.15.1
    • Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation 10.0.1 → 10.0.5
    • Microsoft.Extensions.Configuration 10.0.1 → 10.0.5
    • Microsoft.Extensions.Configuration.Binder 10.0.1 → 10.0.5
    • Microsoft.Extensions.Options 10.0.1 → 10.0.5
    • coverlet.collector 6.0.4 → 8.0.1
    • Microsoft.NET.Test.Sdk 18.0.1 → 18.4.0

Removed

  • Removed unused RestSharp.Serializers.NewtonsoftJson dependency from integration tests.

Fixed

  • Resolved nullable warnings (CS8601/CS8604) in MailClient.PrepareMessage for Subject and Email properties.

Breaking changes

  • Dependency versions have been bumped significantly. If you depend on specific versions of MailKit, MimeKit, or the Microsoft.AspNetCore.* packages, please test your application after upgrading.

[2.2.1]

Added

  • CID (Content-ID) support for inline/embedded images and resources in HTML emails

How to Use Inline Images with CID

1. Add a linked resource in your mailer method:

public IMailerContextResult WelcomeMailWithLogo(string email, string logoPath)
{
    return this.HtmlMail(
        new EmailAddressModel("User", email),
        "Welcome!",
        new WelcomeModel(),
        withAttachments: a => a.AddLinkedResource(logoPath, "company-logo"));
}

2. Reference the image in your Razor view using cid::

<img src="cid:company-logo" alt="Logo" />

The AddLinkedResource method supports file paths, byte arrays, and URLs. See the README for full documentation.

[2.2.0]

  • Attachments now support byte array and fixed filenames.
  • Updated dependencies to latest versions.
  • General code improvements and optimizations.
  • Added Async Method support for mailer contexts.
  • Updated to .NET 10

[2.1.1]

  • Fixed Bug - SMTP connection was not properly disposed after sending an email.

[2.1.0]

  • Updated to .NET 9
  • Updated to MailKit 4.11.0
  • Updated to Razor 9.0.4
  • Updated to HtmlAgilityPack 1.12.1
  • Removed Newtonsoft.Json dependency
  • Removed obsolete and unused package RestSharp
  • Improved nullability annotations

[2.0.2]

Fixed

  • Resolved a bug where the memory cache for the CSS Inline Style Helper returned empty strings or null instead of reading the actual file.

[2.0.1]

Added

  • Introduced the GetContentAsync method to render the HTML without sending the mail.

[2.0.0]

Changed

  • Upgraded to .NET 8.

[1.2.2]

Updated

  • Updated dependencies for .NET 6.

[1.1.1]

Updated

  • Updated changelog for 1.1.x.

[1.1.0]

Added

  • Initial .NET 5 release.

[1.0.2]

Updated

  • Updated examples.

[1.0.1]

Updated

  • Updated documentation.

[1.0.0]

Added

  • Initial release.