Dloizides.Marketing.AspNetCore 1.0.1

Marketing.AspNetCore

Self-hosted marketing / bulk email for .NET. Send one campaign to many recipients over any IEmailService transport (Email.Abstractions) — today that's Maddy/SMTP via Email.Smtp; tomorrow it could be a dedicated bulk ESP (Postal, Mailgun, SES) with no code change. No third-party service is required.

It deliberately stays out of the transactional path: marketing mail is best-effort, rate-limited, carries one-click unsubscribe, and logs its own observability tokens.

What it gives you

• ICampaignEmailSender.SendBulkAsync(content, recipients) — renders and sends per-recipient mail; one failure never aborts the batch; returns a CampaignSendReport (sent / failed counts + per-recipient failures).
• Per-recipient merge fields — {{firstName}} placeholders in the subject and body, substituted from each recipient's values (HTML-encoded in the body).
• RFC 8058 one-click unsubscribe — when a recipient has an UnsubscribeUrl, it is rendered in the footer and advertised via List-Unsubscribe / List-Unsubscribe-Post headers.
• IUnsubscribeTokenService — HMAC-signed, self-contained unsubscribe tokens so the unsubscribe endpoint can be anonymous yet tamper-proof (no session, no DB lookup to verify).
• Rate limiting — paces the send to MaxSendsPerSecond so it doesn't overwhelm the SMTP relay.
• Observability — emits campaign_sent / campaign_failed structured logs (the marketing siblings of email_sent / email_failed).

Register

// 1. A transport (any IEmailService) — e.g. SMTP via Email.Smtp:
services.AddSmtpEmail(o => configuration.GetSection("Smtp").Bind(o));

// 2. Marketing on top of it:
services.AddMarketingEmail(configuration);          // binds the "Marketing" section
// or
services.AddMarketingEmail(o =>
{
    o.UnsubscribeSigningKey = "...";                // a server secret
    o.DefaultFromAddress    = "noreply@dloizides.com";
    o.DefaultFromName       = "Acme";
    o.MaxSendsPerSecond     = 10;
    o.FooterText            = "Acme Ltd · 1 Example St · Unsubscribe any time.";
});

Send a campaign

var token = unsubscribeTokens.Create(tenantId, subscriber.Id, subscriber.Email);
var recipient = new CampaignRecipient
{
    Address        = subscriber.Email,
    Name           = subscriber.Name,
    MergeFields    = new Dictionary<string,string> { ["firstName"] = subscriber.FirstName },
    UnsubscribeUrl = $"https://notification-api.dloizides.com/api/v1/marketing/unsubscribe?token={token}",
};

var report = await campaignSender.SendBulkAsync(
    new CampaignContent
    {
        CampaignName = "June newsletter",
        Subject      = "Hi {{firstName}}, what's new",
        HtmlBody     = "<p>Hello {{firstName}},</p><p>...</p>",
    },
    new[] { recipient });

// report.SentCount / report.FailedCount / report.Failures

Unsubscribe endpoint (host side)

if (unsubscribeTokens.TryValidate(token, out var payload))
{
    // payload.TenantId / payload.SubscriberId / payload.Email — mark unsubscribed
}

Configuration (Marketing section)

MIT.