LSCore Documentation

LSCore is a collection of free and open-source .NET 10.0 libraries that simplify building ASP.NET Core APIs. Its core principles are simplicity and abstraction: features are divided into independent packages so you include only what you need.

All packages are published to NuGet and share a synchronized version (currently 10.0.0).

Upgrading from 9.x? 10.0.0 targets net10.0. The major version tracks the targeted .NET version, so moving to it requires retargeting your application to .NET 10. The 9.1.x line remains on NuGet and continues to target net9.0.

Quick Start

  1. Install the packages you need from NuGet (see module listing below).
  2. Configure services in Program.cs using the Add*() extension methods.
  3. Activate middleware with the Use*() extension methods after building the app.

Minimal example with exception handling and dependency injection:

using LSCore.DependencyInjection;
using LSCore.Exceptions.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

builder.AddLSCoreDependencyInjection("MyProject");

var app = builder.Build();

app.UseLSCoreDependencyInjection();
app.UseLSCoreExceptionsHandler();

app.Run();

For hands-on learners, explore the src/SampleApps directory which contains working implementations of all features. See the Samples page for details.

Modules

Authentication and Authorization

Module Packages Documentation
Auth (shared contracts) LSCore.Auth.Contracts Auth Overview
Auth – API Key LSCore.Auth.Key.Contracts, LSCore.Auth.Key.DependencyInjection Key Auth
Auth – Username/Password (JWT) LSCore.Auth.UserPass.Contracts, LSCore.Auth.UserPass.Domain, LSCore.Auth.UserPass.DependencyInjection Auth Overview
Auth – Role-Based LSCore.Auth.Role.Contracts, LSCore.Auth.Role.Domain, LSCore.Auth.Role.DependencyInjection Auth Overview
Auth – Permission-Based LSCore.Auth.Permission.Contracts, LSCore.Auth.Permission.Domain, LSCore.Auth.Permission.DependencyInjection Auth Overview

Core Infrastructure

Module Packages Documentation
Dependency Injection LSCore.DependencyInjection Convention-based assembly scanner. Auto-registers services, mappers, and validators.
Exception Handling LSCore.Exceptions, LSCore.Exceptions.DependencyInjection Exceptions
Logging LSCore.Logging Logging

Data and Mapping

Module Packages Documentation
Repository LSCore.Repository.Contracts, LSCore.Repository Repository
Mapper LSCore.Mapper.Contracts, LSCore.Mapper.Domain Mapper
Sort and Page LSCore.SortAndPage.Contracts, LSCore.SortAndPage.Domain Sort and Page

Validation

Module Packages Documentation
Validation LSCore.Validation.Contracts, LSCore.Validation.Domain Validation

API Client

Module Packages Documentation
REST API Client LSCore.ApiClient.Rest, LSCore.ApiClient.Rest.DependencyInjection API Client

Utilities

Module Packages Documentation
Common Contracts LSCore.Common.Contracts Common
Common Extensions LSCore.Common.Extensions Common

All NuGet Packages

Package Description
LSCore.ApiClient.Rest Abstract base class for REST API clients with status-code mapping
LSCore.ApiClient.Rest.DependencyInjection DI registration for the REST API client
LSCore.Auth.Contracts Shared authentication interfaces and types
LSCore.Auth.Key.Contracts API-key authentication interfaces
LSCore.Auth.Key.DependencyInjection API-key authentication middleware and DI wiring
LSCore.Auth.Permission.Contracts Permission-based authorization interfaces
LSCore.Auth.Permission.Domain Permission-based authorization implementation
LSCore.Auth.Permission.DependencyInjection Permission-based authorization middleware and DI wiring
LSCore.Auth.Role.Contracts Role-based authorization interfaces
LSCore.Auth.Role.Domain Role-based authorization implementation
LSCore.Auth.Role.DependencyInjection Role-based authorization middleware and DI wiring
LSCore.Auth.UserPass.Contracts Username/password (JWT) authentication interfaces
LSCore.Auth.UserPass.Domain JWT authentication with BCrypt password hashing
LSCore.Auth.UserPass.DependencyInjection JWT authentication middleware and DI wiring
LSCore.Common.Contracts Shared data types (e.g., LSCoreIdRequest)
LSCore.Common.Extensions Utility extension methods
LSCore.DependencyInjection Convention-based assembly scanner for automatic service registration
LSCore.Exceptions Exception types mapping to HTTP status codes (400, 401, 403, 404, 500)
LSCore.Exceptions.DependencyInjection Exception-handling middleware for ASP.NET Core
LSCore.Logging Console and debug logging configuration
LSCore.Mapper.Contracts ILSCoreMapper<TSource, TDestination> interface
LSCore.Mapper.Domain ToMapped<>() extension methods for object mapping
LSCore.Repository.Contracts Repository interfaces and LSCoreEntity base class
LSCore.Repository Generic repository with CRUD, soft-delete, and audit fields
LSCore.SortAndPage.Contracts Sorting and pagination request/response models
LSCore.SortAndPage.Domain ToSortedAndPagedResponse<>() extension on IQueryable<T>
LSCore.Validation.Contracts ILSCoreValidator<T> interface and validation message utilities
LSCore.Validation.Domain FluentValidation-based validators with automatic Validate<T>() extension

LSCore is free and open-source.