Muslim.Extensions 10.0.1

Muslim.Extensions

Small extension methods for .NET 10: object mapping, password hashing, empty checks, enum parsing and date conversion.

dotnet add package Muslim.Extensions

All methods live in the Muslim.Extensions namespace.

Mapping

Map<TDto>() uses the IMapper registered in your container, through Muslim.Inject. Set it up once in Program.cs:

using Muslim.Inject;

builder.Services.AddAutoMapper(typeof(ProductProfile).Assembly);

var app = builder.Build();
InjectExtensions.SetServiceProvider(app.Services);

public class ProductProfile : Profile
{
    public ProductProfile() => CreateMap<Product, ProductDto>();
}

Then map anywhere, without injecting IMapper:

ProductDto dto = product.Map<ProductDto>();
List<ProductDto> list = products.Map<List<ProductDto>>();

If SetServiceProvider was not called, or IMapper is not registered, Map throws an InvalidOperationException that says which one is missing.

Password hashing

// sign-up
user.PasswordHash = request.Password.HashPassword();

// sign-in
if (!request.Password.VerifyHashedPassword(user.PasswordHash))
    return Results.Unauthorized();

if (user.PasswordHash.NeedsPasswordRehash())
{
    user.PasswordHash = request.Password.HashPassword();
    await db.SaveChangesAsync();
}

• The hash looks like PBKDF2-SHA256$600000$salt$key. Store it in a string column of at least 100 characters.
• VerifyHashedPassword also accepts old hashes made with ComputeSha256Hash. NeedsPasswordRehash returns true for those, so users move to the stronger hash the next time they sign in.
• Hashes are compared in constant time. An empty or broken stored hash returns false instead of throwing.
• Do not use ComputeSha256Hash for new passwords. It is a plain digest with no salt.

Empty checks

0.IsEmpty();                    // true
"".IsEmpty();                   // false — use string.IsNullOrEmpty for strings
((int?)null).IsEmpty();         // true
Guid.Empty.IsEmpty();           // true

new ProductFilterDto().IsObjEmpty();              // true  — nothing filled in
new ProductFilterDto { Name = "a" }.IsObjEmpty(); // false
new List<string>().IsObjEmpty();                  // true

IsObjEmpty is useful for "did the client send anything?" checks on a DTO.

Other helpers

var status = "Active".ToEnum<OrderStatus>();   // throws ArgumentException for an unknown value

DateOnly day = order.CreatedDate.ToDateOnly(); // works for DateTime and DateTime?

int count   = maybeCount.NotNull();            // null -> 0
string name = maybeName.NotNull();             // null -> ""

Good to know

• Only Map<TDto>() needs setup. Every other method works on its own.
• This package uses AutoMapper 12.0.1, which NuGet flags with a security advisory (GHSA-rvv3-g6hj-g44x). Moving to a newer AutoMapper changes its API and license, so it has not been done yet. Check whether the advisory affects your inputs.

Related packages

Coding-agent guidance

When you build a project that uses this package, a short guide for AI coding agents is copied to .agents/skills/muslim-extensions/ at the root of your repository. Agents that read skills from .agents/skills, such as Codex and GitHub Copilot in VS Code, use it to write correct code against this package. Your own files and other skills are never touched, and nothing is deleted automatically.

To turn it off, add this to your project or Directory.Build.props:

<PropertyGroup>
  <MuslimExtensionsGenerateSkill>false</MuslimExtensionsGenerateSkill>
</PropertyGroup>

License

See LICENSE.txt.