BlackDigital.Domain 26.10.20.2

BlackDigital.Domain

🇧🇷 Português | 🇺🇸 English

Reusable domain building blocks for any .NET backend

About the Project

BlackDigital.Domain is a shared library of infrastructure and security building blocks designed to be reused across any .NET backend project — REST APIs, background jobs, worker services, Azure Functions, and more. It has no dependency on ASP.NET Core, so it can be referenced from any project type.

Key Features

• Email Infrastructure: SMTP email service (via MailKitLite) with multi-provider support and HTML template rendering
• JWT Token Service: Generate, validate, and inspect JWT tokens
• Password Hashing: Argon2id password hashing interface
• Authorization Attribute: Dependency-free [Authorize] metadata with nullable Roles and Policy for classes, interfaces and methods

Installation

Via .NET CLI

dotnet add package BlackDigital.Domain

Via PackageReference

<PackageReference Include="BlackDigital.Domain" Version="26.10.11.01" />

Features

Email

Send transactional emails with SMTP and optional HTML templates.

using BlackDigital.Domain.Infrastructures;

var email = Email.Create()
    .To("user@example.com", "John Doe")
    .WithSubject("Welcome")
    .WithBody("<h1>Hello, John!</h1>", isHtml: true);

await emailService.SendEmailAsync(email);

Full Email Documentation

Security (JWT + Password Hashing)

using BlackDigital.Domain.Security;
using System.Security.Claims;

var tokenService = new JwtTokenService(secretKey, issuer, audience);

var claims = new[]
{
    new Claim(ClaimTypes.NameIdentifier, "123"),
    new Claim(ClaimTypes.Name, "john@example.com")
};

string token = tokenService.GenerateToken(Guid.NewGuid(), claims);

[Authorize]
public interface IUserService
{
    [Authorize(Roles = new[] { "Admin", "Manager" })]
    Task<IEnumerable<User>> ListUsersAsync();

    [Authorize(Policy = "Category.Write")]
    Task SaveUserAsync([Body] SaveUser user);
}

Full Security Documentation

Project Structure

BlackDigital.Domain/
├── src/
│   ├── Infrastructures/   # Email services (SMTP + templates)
│   └── Security/          # JWT, password hashing and authorization attributes
├── test/                  # Unit tests
├── doc/                   # Documentation
└── README.md

License

This project is licensed under the MIT License - see the LICENSE file for details.