FxMap.Nats
5.0.0
See the version list below for details.
dotnet add package FxMap.Nats --version 5.0.0
NuGet\Install-Package FxMap.Nats -Version 5.0.0
<PackageReference Include="FxMap.Nats" Version="5.0.0" />
<PackageVersion Include="FxMap.Nats" Version="5.0.0" />
<PackageReference Include="FxMap.Nats" />
paket add FxMap.Nats --version 5.0.0
#r "nuget: FxMap.Nats, 5.0.0"
#:package FxMap.Nats@5.0.0
#addin nuget:?package=FxMap.Nats&version=5.0.0
#tool nuget:?package=FxMap.Nats&version=5.0.0
FxMap.Nats
NATS transport for FxMap — request/reply between services over NATS.
FxMap · Documentation · Demo project
A transport carries FxMap requests between the service that needs data (the client) and the service that owns it
(the server). Every service that maps data needs the core FxMap package; the owning service also needs a data provider
(EntityFrameworkCore or
MongoDb), and both sides use the same transport.
Requests are batched per distributed key, so a hundred objects that need a UserName produce one request.
Installation
dotnet add package FxMap.Nats
Warning
All FxMap.* packages must use the same version.
Usage
builder.Services.AddFxMap(cfg =>
{
cfg.AddEntitiesFromAssemblyContaining<SomeEntityAssemblyMarker>();
cfg.AddProfilesFromAssemblyContaining<SomeProfileAssemblyMarker>();
cfg.AddNats(c => c.NatsOpts(opts => opts.Url = "nats://localhost:4222"));
});
// With more options
cfg.AddNats(c =>
{
c.TopicPrefix("billing"); // optional, see below
c.NatsOpts(opts =>
{
opts.Url = "nats://localhost:4222";
opts.MaxReconnectRetry = 5;
opts.RequestTimeout = TimeSpan.FromSeconds(10);
// ... any other FxNatsOpts property
});
});
Naming
FxMap uses one subject per distributed key: fxmap-{namespace}-{type name}, lower case, for example
fxmap-myapp.contracts-userdistributedkey. With TopicPrefix("billing") the subject becomes
billing-fxmap-{namespace}-{type name}. Avoid using these subjects for anything else.
Related packages
| Package | Description | Documentation |
|---|---|---|
| Core | ||
| FxMap | FxMap core: profiles, entity configs, the mapper and the expression language | README |
| Data providers | ||
| FxMap.EntityFrameworkCore | Answers requests from an Entity Framework Core DbContext |
README |
| FxMap.MongoDb | Answers requests from MongoDB collections | README |
| Integrations | ||
| FxMap.HotChocolate | Fills GraphQL response types through HotChocolate | README |
| Transports | ||
| FxMap.Grpc | gRPC transport | README |
| FxMap.Nats | NATS transport | This document |
| FxMap.RabbitMq | RabbitMQ transport | README |
| FxMap.Kafka | Apache Kafka transport | README |
| FxMap.Azure.ServiceBus | Azure Service Bus transport (Standard / Premium tiers) | README |
| FxMap.Aws.Sqs | Amazon SQS transport | README |
| Tooling | ||
| FxMap.Analyzers | Roslyn analyzer that validates expression strings at compile time | README |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- FxMap (>= 5.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.0)
- NATS.Net (>= 2.5.5)
-
net8.0
- FxMap (>= 5.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.0)
- NATS.Net (>= 2.5.5)
-
net9.0
- FxMap (>= 5.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.0)
- NATS.Net (>= 2.5.5)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 5.1.1 | 182 | 10/19/2026 |
| 5.1.0 | 113 | 10/15/2026 |
| 5.0.0 | 109 | 10/14/2026 |
| 4.1.5 | 117 | 10/13/2026 |
| 4.1.4 | 103 | 10/13/2026 |
| 4.1.3 | 104 | 10/12/2026 |
| 4.1.2 | 115 | 10/11/2026 |
| 4.1.1 | 108 | 10/6/2026 |
| 4.1.0 | 105 | 10/5/2026 |
| 4.0.0 | 115 | 10/5/2026 |
| 3.0.0 | 125 | 10/2/2026 |
| 2.3.5 | 109 | 10/2/2026 |
| 2.3.4 | 110 | 10/2/2026 |
| 2.3.3 | 102 | 10/1/2026 |
| 2.3.2 | 108 | 10/1/2026 |
| 2.3.1 | 126 | 8/21/2026 |
| 2.3.0 | 153 | 6/16/2026 |
| 2.2.2 | 143 | 6/3/2026 |
| 2.2.1 | 142 | 5/31/2026 |
| 2.2.0 | 132 | 5/26/2026 |