Nextended.Core 10.1.31

Nextended.Core

Foundation library — extension methods, custom types (Money, Date, BaseId, SuperType), class mapping, deep clone, encryption, hashing and the code-generation attributes.

📖 Documentation: English · Deutsch

Installation

dotnet add package Nextended.Core

Nextended.Core has no Nextended dependencies — every other package in the suite builds on it.

What's inside

Quick start

Class mapping

using Nextended.Core.Extensions;

// Convention-based, no configuration
var dto = user.MapTo<UserDto>();

// Whole sequences
var dtos = users.MapElementsTo<UserDto>();

// Explicit member assignment where names differ
var settings = ClassMappingSettings.Default
    .AddAssignment<User, UserDto>(u => u.EmailAddress, d => d.Mail)
    .IgnoreProperties<User>(u => u.Password)
    .AddConverter<string, DateTime>(DateTime.Parse);

var mapped = user.MapTo<UserDto>(settings);

// Tweak any setting inline
var lenient = ClassMappingSettings.Default.Set(s => s.IgnoreExceptions = true);

There is also a chained Assign(...).To(...).And(...) form, but note it returns a Tuple<ClassMappingSettings, …> rather than the settings object — take .Item1 before passing it to MapTo, or use AddAssignment as above.

Deep clone

using Nextended.Core.DeepClone;

var copy = order.CloneDeep();          // full graph, references preserved

Mark members you never want copied with [ClonerIgnore].

Custom types

using Nextended.Core.Types;

var price = new Money(99.99m, Currency.USD);
var due   = Date.Today.AddDays(30);        // date without a time component
var span  = new Range<int>(1, 10);

Money keeps decimal precision and its currency together; Date removes the "what time is midnight in which zone" class of bug from date-only values.

String and date extensions

using Nextended.Core.Extensions;

"hello world".ToPascalCase();     // "HelloWorld"
"hello world".ToCamel();          // "helloWorld"
"MyClassName".SplitByUpperCase(); // "My Class Name"
"a long sentence".ToEllipsis(8);  // "a long …"
"user@example.com".IsEmailAddress();

DateTime.Today.AddWeekDays(5);    // skips weekends
DateTime.Today.IsWeekend();
DateTime.Today.FirstDayOfMonth();
DateTime.UtcNow.ToISOz();

Note Earlier revisions of this documentation showed ToCamelCase(), DeepClone(), AddBusinessDays(), ToSnakeCase() and IsBusinessDay(). Those methods do not exist. The verified names are ToCamel(), CloneDeep(), AddWeekDays() and IsWeekend() / IsWeekday().

Measuring a call

using Nextended.Core.Measurement;

var measured = await Measure.RunAsync(() => repository.LoadAllAsync());
Console.WriteLine($"{measured.Elapsed} for {measured.Result.Count} rows");

Faceted search

using Nextended.Core.Facets;

var facets = await new FacetBuilder()
    .WithOptions(o => o.MaxOptionsPerGroup = 20)
    .BuildAsync<Product>(products);

// facets -> FacetGroup list with counts, ready to render and to feed back as an OData filter

Documentation

The README is an overview. The reference documentation covers every extension group, the mapping settings, the facet model and the type system in detail:

• 📖 Nextended.Core — English
• 📖 Nextended.Core — Deutsch
• 📖 Class mapping reference
• 📖 Extension method reference
• 📖 Type reference
• 📖 Encryption and hashing

Migrating from nExt

Nextended.Core is the continuation of the nExt.Core package. Namespaces moved from nExt.* to Nextended.*; the API is otherwise source-compatible. See the migration guide. The legacy nExt.Core package is no longer maintained.

Supported frameworks

• netstandard2.0
• netstandard2.1
• net8.0
• net9.0
• net10.0

Dependencies

No Nextended dependencies — this is the root of the dependency tree.

The Nextended family

The other 17 packages in the suite:

Core libraries

• Nextended.Core — Foundation library — extension methods, custom types (Money, Date, BaseId, SuperType), class mapping, deep clone, encryption, hashing and the code-generation attributes. (this package)
• Nextended.Cache — Expression-based caching — automatic cache keys from method expressions, CacheProvider with condition-based invalidation, thread-safe AddOrGetExisting.

Data access

• Nextended.EF — Entity Framework Core extensions — graph loading (LoadGraphAsync, IncludeAll, MultiInclude), declarative include definitions, paging, dynamic sorting and bulk operations.

ASP.NET Core & web

• Nextended.Web — ASP.NET Core utilities — zero-config OData (AddODataAuto), composable IQueryable OData appliers, strongly typed controller URLs, streaming download helpers and a background executor that can replay a captured request.
• Nextended.ResponseFilters — Fluent, provider-agnostic pipeline that redacts, masks, rounds, truncates, hashes, prunes and restructures response DTOs before serialization — per request, per user, per permission.
• Nextended.ResponseFilters.AspNetCore — ASP.NET Core adapter for Nextended.ResponseFilters — registers the pipeline as a global IAsyncResultFilter and replays structural edits against the serialized JSON tree.

UI libraries

• Nextended.Blazor — Blazor helpers — IBrowserFile extensions (bytes, data URLs, downloads), a hierarchical model for browsing inside uploaded zip/tar/rar archives, MIME-type detection and component-parameter reflection.
• Nextended.UI — WPF and Windows desktop helpers — a global input-binding manager with hold/sequence matching, DirectInput and XInput gamepad readers, key-bind capture controls, converters, behaviours, markup extensions and runtime-defined PropertyGrid types.

Code generation & tooling

• Nextended.Imaging — Image processing — aspect-preserving resize, crop, colour replacement, brightness-based foreground picking, thumbnail generation, byte/data-URL conversion and MIME detection from magic bytes.
• Nextended.CodeGen — Roslyn source generator — DTOs and interfaces from your entities, strongly typed classes from JSON/XML, lookup tables from Excel, and documentation from source files.

.NET Aspire hosting

• Nextended.Aspire — Conditional AppHost builder extensions — WithReferenceIf / WaitForIf / WithExplicitStartIf, strongly typed environment variables from config objects, HTTPS dev-cert wiring, Docker guards, GitHub-source resources and npm app discovery.
• Nextended.Aspire.Hosting.Supabase — The complete Supabase stack — Postgres, Auth (GoTrue), REST, Realtime, Storage, Studio, Kong and Edge Functions — as one composable Aspire resource.
• Nextended.Aspire.Hosting.N8n — The n8n workflow-automation platform as an Aspire resource, with Postgres persistence, workflow import and a typed client for triggering workflows from .NET.
• Nextended.Aspire.Hosting.Grafana — Grafana, Prometheus, Loki, Tempo, Promtail, cAdvisor, postgres_exporter and the OpenTelemetry Collector as composable resources with auto-provisioned datasources.
• Nextended.Aspire.Hosting.WebDataStudio — WebDataStudio — a browser database studio for PostgreSQL, MySQL, SQL Server, SQLite, Oracle, DuckDB, ClickHouse, MongoDB and Redis — wired to the databases of your stack.
• Nextended.Aspire.Hosting.AspireUI — AspireUI — the visual AppHost builder — as a resource inside your own Aspire stack, with an optional pre-seeded admin user and a starter stack built from your project paths.
• Nextended.Aspire.Hosting.LocalAI — Self-hosted, OpenAI-compatible multimodal AI — image generation, text-to-speech, speech-to-text and video — with gallery model management, GPU support and Open WebUI.
• Nextended.Aspire.Hosting.Php — Run PHP endpoints inside your Aspire stack — a docroot folder or a single router script served by PHP's built-in web server, with php.ini settings as fluent options.

Links

• 📦 NuGet package
• 📖 Documentation — English
• 📖 Dokumentation — Deutsch
• 🏠 Documentation portal
• 🧑‍💻 Source code
• 🐛 Report an issue

License

GPL-3.0-or-later — see LICENSE.