Excalibur.Data.IdentityMap 3.0.0-alpha.205

This is a prerelease version of Excalibur.Data.IdentityMap.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Excalibur.Data.IdentityMap --version 3.0.0-alpha.205
                    
NuGet\Install-Package Excalibur.Data.IdentityMap -Version 3.0.0-alpha.205
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Excalibur.Data.IdentityMap" Version="3.0.0-alpha.205" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Excalibur.Data.IdentityMap" Version="3.0.0-alpha.205" />
                    
Directory.Packages.props
<PackageReference Include="Excalibur.Data.IdentityMap" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Excalibur.Data.IdentityMap --version 3.0.0-alpha.205
                    
#r "nuget: Excalibur.Data.IdentityMap, 3.0.0-alpha.205"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Excalibur.Data.IdentityMap@3.0.0-alpha.205
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Excalibur.Data.IdentityMap&version=3.0.0-alpha.205&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Excalibur.Data.IdentityMap&version=3.0.0-alpha.205&prerelease
                    
Install as a Cake Tool

Excalibur.Data.IdentityMap

Aggregate identity map abstractions for Excalibur, providing external-to-internal ID resolution for CDC ingestion and anti-corruption layers.

Overview

The identity map store provides a write-side authoritative mapping between external system identifiers (e.g., legacy transaction IDs, ERP account numbers) and internal aggregate IDs. This enables:

  • Idempotent CDC ingestion -- detect whether an external record has already been imported
  • Cross-aggregate reference resolution -- resolve related entities (Account, Client, Branch) by their external keys
  • Anti-corruption layer -- decouple domain model IDs from external system IDs

Usage

// Register with SQL Server provider
services.AddIdentityMap(identity =>
{
    identity.UseSqlServer(sql =>
    {
        sql.ConnectionString(connectionString)
           .SchemaName("dbo")
           .TableName("IdentityMap");
    });
});

// Resolve an external ID to an aggregate ID
Guid? orderId = await identityMap.ResolveAsync<Guid>(
    "LegacyCore", legacyOrderId, "Order", cancellationToken);

// Bind a new mapping (idempotent)
var result = await identityMap.TryBindAsync(
    "LegacyCore", legacyOrderId, "Order",
    newOrderId.ToString(), cancellationToken);

if (result.WasCreated)
{
    // New aggregate -- proceed with creation
}
else
{
    // Existing aggregate -- route to update/reconcile
}

Packages

Package Purpose
Excalibur.Data.IdentityMap Core abstractions, builder, InMemory implementation
Excalibur.Data.IdentityMap.SqlServer SQL Server provider using Dapper
Product Compatible and additional computed target framework versions.
.NET 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Excalibur.Data.IdentityMap:

Package Downloads
Excalibur.Data.IdentityMap.SqlServer

SQL Server identity map store implementation for Excalibur, providing durable external-to-internal aggregate ID resolution.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0-alpha.216 44 6/30/2026
3.0.0-alpha.215 59 6/23/2026
3.0.0-alpha.214 57 6/23/2026
3.0.0-alpha.208 59 6/11/2026
3.0.0-alpha.207 55 6/11/2026
3.0.0-alpha.205 57 6/10/2026
3.0.0-alpha.204 61 6/8/2026
3.0.0-alpha.203 62 6/8/2026
3.0.0-alpha.202 56 6/8/2026
3.0.0-alpha.201 57 6/8/2026
3.0.0-alpha.199 55 6/8/2026
3.0.0-alpha.198 58 5/28/2026
3.0.0-alpha.197 76 5/28/2026
3.0.0-alpha.194 57 5/20/2026
3.0.0-alpha.193 57 5/13/2026
3.0.0-alpha.192 61 5/13/2026
3.0.0-alpha.191 59 5/13/2026
3.0.0-alpha.189 67 5/12/2026
3.0.0-alpha.187 58 5/8/2026
3.0.0-alpha.185 59 5/7/2026
Loading failed