RossWright.MetalCore.Server 2026.1.1

Ross Wright's Metal Core Server Library

Copyright (c) 2023-2026 Pross Co.

Table of Contents

• Messaging
  • Messaging Contracts
  • SMTP Email
• App Builder Fluent Syntax
  • WebApplicationBuilder
  • WebApplication
• Installation
• See Also
• License

Messaging

The Server package provides an abstraction framework for messaging that decouples application code from delivery implementations. Application code depends only on IEmailService or ISmsService; switching to a different delivery provider requires only a registration change in Program.cs — no changes to handlers or services.

Currently provided: SMTP via AddSmtpEmailService(). SendGrid and Twilio integrations were previously available as separate packages and may return in a future release.

// Program.cs
builder.AddSmtpEmailService();

// Handler
await emailService.Send(new AddressedEmail {
    Subject = "Welcome",
    ToRecipients = [new EmailRecipient { Email = user.Email }],
    TextBody = "Thanks for signing up."
});

Messaging Contracts

RossWright.Messaging namespace.

SMTP Email

RossWright.Messaging.Smtp namespace.

Bind configuration from appsettings.json under the "MetalCore.Smtp" section.

Authenticated relay (Gmail, SendGrid SMTP, AWS SES SMTP, etc.):

"MetalCore.Smtp": {
  "Host": "smtp.example.com",
  "Port": 587,
  "EnableSsl": true,
  "FromEmail": "no-reply@example.com",
  "FromName": "My App",
  "Username": "smtp-user",
  "Password": "smtp-password"
}

Unauthenticated relay (internal mail relay, local dev SMTP server, etc.) — omit Username and Password:

"MetalCore.Smtp": {
  "Host": "relay.internal",
  "Port": 25,
  "EnableSsl": false,
  "FromEmail": "no-reply@example.com",
  "FromName": "My App"
}

When Username and Password are both present and non-empty, the client sets SmtpClient.Credentials to a NetworkCredential before sending. When either is absent, the client sends without credentials.

SMS: No concrete ISmsService implementation is provided in this package. Register your own implementation against ISmsService.

App Builder Fluent Syntax

MetalCore provides extension methods on WebApplicationBuilder and WebApplication that enable a single fluent chain from CreateBuilder(args) through to Run(), eliminating the intermediate variable assignments that standard ASP.NET Core startup requires.

WebApplication.CreateBuilder(args)
    .AddMetalInjection(_ => _.ScanThisAssembly())
    .AddSmtpEmailService()
    .AddServices((services, config) => services
        .AddCors(...)
        .AddSwaggerGen())
    .Build()
    .UseApp((app, config) => {
        app.UseHttpsRedirection();
        app.UseStaticFiles();
        app.MapFallbackToFile("index.html");
    })
    .Run();

WebApplicationBuilder

WebApplication

Installation

dotnet add package RossWright.MetalCore.Server

Or add directly to your project file:

<PackageReference Include="RossWright.MetalCore.Server" Version="*" />

See Also

License

All Ross Wright Metal Libraries including this one are licensed under Apache License 2.0 with Commons Clause.

You are free to:

• Use the libraries in any project (personal or commercial)
• Modify them
• Include them in products or services you sell

You may not:

• Sell the libraries themselves (or any product/service whose primary value comes from the libraries)
• Repackage them with minimal changes and sell them as your own standalone product

Full legal text: LICENSE.md