IBeam.Communications.Email.Smtp 2.8.2

IBeam.Communications.Email.Smtp

IBeam.Communications.Email.Smtp implements IEmailService using the standard SMTP protocol. It is useful when a consuming API already has access to an SMTP relay, enterprise mail server, local dev relay, or provider-neutral SMTP endpoint.

When To Use This

• Your organization already provides an SMTP relay.
• You want a simple standards-based email provider.
• You want application services to stay on IBeam IEmailService.
• You need a provider that can work without SendGrid or Azure Communication Services.

What This Package Contains

Architecture Fit

API <-- DTO/model object --> Service <-- Entity --> Repository

This package belongs behind the service layer. A domain service decides when an email should be sent and calls IEmailService; this package only delivers that message through SMTP.

Quick Start

using IBeam.Communications.Abstractions;
using IBeam.Communications.Email.Smtp;

builder.Services.AddIBeamCommunications(builder.Configuration);
builder.Services.AddIBeamSmtpEmail(builder.Configuration);

Configuration:

{
  "IBeam": {
    "Communications": {
      "Email": {
        "FromAddress": "noreply@example.com",
        "FromName": "Example App",
        "Smtp": {
          "Host": "smtp.example.com",
          "Port": 587,
          "EnableSsl": true,
          "UseDefaultCredentials": false,
          "Username": "smtp-user",
          "Password": "<secret>",
          "DefaultFromAddress": "noreply@example.com",
          "DefaultFromDisplayName": "Example App"
        }
      }
    }
  }
}

Send email:

public sealed class AlertEmailService
{
    private readonly IEmailService _email;

    public AlertEmailService(IEmailService email)
    {
        _email = email;
    }

    public Task SendAlertAsync(string to, CancellationToken ct = default)
    {
        var message = new EmailMessage
        {
            Subject = "Action needed",
            TextBody = "Please review the latest alert."
        };
        message.To.Add(to);

        return _email.SendAsync(message, ct: ct);
    }
}

Configuration

Shared fallback sender settings are also bound from IBeam:Communications:Email.

Service Operations, Auditing, And Permissions

SMTP delivery is not the business operation. Tag the service method that decides to send the message.

[IBeamOperation("orders.confirmation.send")]
public Task SendConfirmationAsync(Guid tenantId, Guid orderId, CancellationToken ct = default)
    => _operations.ExecuteAsync(
        this,
        token => SendConfirmationCoreAsync(tenantId, orderId, token),
        new ServiceOperationExecutionOptions
        {
            TenantId = tenantId,
            EntityId = orderId
        },
        ct);

Use ILogger<T> or a consuming outbox service if you need SMTP diagnostics, retries, or delivery tracking.

Data Storage

This package does not create database tables or durable stores.

Extension Points

Package Relationships

Extended Examples And Agent Guidance

• Project agent prompt: .agent/prompt.md
• Repository implementation guide: ../.agent/implementation-guide.md
• Consuming API migration prompt: ../IBeam.AI.Enablement/examples/consuming-api-migration-prompt.md

Troubleshooting

Version Notes

• Targets net10.0.
• Uses System.Net.Mail.SmtpClient and creates a new client per send.
• Package version is assigned by the repository release workflow.