Odex.AspNetCore.Clarc.Infrastructure 0.2.0

Odex.AspNetCore.Clarc.Infrastructure

Reusable infrastructure-layer helpers for .NET 9 that align with Odex.AspNetCore.Clarc.Domain: LINQ query builders, PagedRequest / PagedResponse<T> materialization, Specification<T> on IQueryable, a default ITransactionContext, and typed infrastructure exceptions. The public API is documented with XML comments. This assembly targets net9.0 and does not reference a specific ORM—you plug in Count, ToList, or async equivalents from your stack.

Table of contents

• About
• Installation
• Requirements
• Clean architecture role
• Capabilities
• API documentation
• Quick examples
• Namespaces
• Exception types (Domain vs Infrastructure)
• CI/CD
• Contributing
• Security
• License
• Links

About

Odex.AspNetCore.Clarc.Infrastructure is part of the CLARC (clean-architecture style) family. It complements the Domain package with general-purpose building blocks you typically implement once per solution: composable IQueryable pipelines, pagination aligned with PagedRequest, PagedResponse<T> projection, specification-based filters, and a cooperative ITransactionContext for unit-of-work code.

The AspNetCore segment in the package ID is historical; the library does not require ASP.NET Core at compile time.

Installation

dotnet add package Odex.AspNetCore.Clarc.Infrastructure

Pin a version for reproducible builds:

dotnet add package Odex.AspNetCore.Clarc.Infrastructure --version 0.2.0

Requirements

Runtime dependencies beyond .NET and Domain: none. The package build uses Microsoft.SourceLink.GitHub (private asset) for debuggable symbols on GitHub.

Clean architecture role

This library stays below application use-case code: it provides helpers, not business rules.

Capabilities

API documentation

Public types and members use /// XML documentation. GenerateDocumentationFile is enabled; the NuGet package ships Odex.AspNetCore.Clarc.Infrastructure.xml next to the assembly for IntelliSense and NuGet.org tooltips.

Quick examples

Paged response (sync, in-memory or deferred provider):

using Odex.AspNetCore.Clarc.Domain.ValueObjects.Requests;
using Odex.AspNetCore.Clarc.Infrastructure.Data.Pagination;

public sealed record MyListRequest : PagedRequest;

var page = myQuery.ToPagedResponse(new MyListRequest { Page = 2, PageSize = 10 });

Paged response (async — host supplies delegates; example uses EF Core extension methods after referencing that package):

var page = await myQuery.ToPagedResponseAsync(
    request,
    (q, ct) => q.CountAsync(ct),   // e.g. Microsoft.EntityFrameworkCore
    (q, ct) => q.ToListAsync(ct),
    cancellationToken);

Specification on IQueryable:

using Odex.AspNetCore.Clarc.Infrastructure.Data.Specifications;

var filtered = myQuery.Where(myDomainSpecification);

Transaction context (in your unit of work):

using Odex.AspNetCore.Clarc.Infrastructure.Contexts;

var ctx = new TransactionContext();
// Pass ctx into ExecuteInTransactionAsync; after store work:
ctx.NotifyCommitted(); // or ctx.NotifyRolledBack();

Namespaces

Exception types (Domain vs Infrastructure)

• Odex.AspNetCore.Clarc.Domain.Constants.ExceptionType — classifies domain failures (DomainException, policy violations, not found, concurrency, …).
• Odex.AspNetCore.Clarc.Infrastructure.Constants.ExceptionType — classifies technical failures (configuration, DB connectivity, external HTTP, serialization, …).

Use the Domain enum at your application boundary for business errors; use the Infrastructure enum for infrastructure exceptions shipped from this package.

CI/CD

GitHub Actions run restore → strict Release build → tests → pack on every push and pull request to main, and a Release workflow publishes to NuGet.org from version tags or manual dispatch. See CONTRIBUTING.md for NUGET_API_KEY setup and tagging conventions.

Contributing

See CONTRIBUTING.md for local build commands, XML documentation rules, pull request expectations, and versioning.

Security

Report vulnerabilities privately per SECURITY.md. Do not use public issues for undisclosed security problems.

License

This project is released under the MIT License.

Links

• Domain package: Odex.AspNetCore.Clarc.Domain — repository, changelog
• This repository: github.com/o-shabi/odex-clarc-infrastructure-aspnetcore
• This changelog: CHANGELOG.md