ChangeTracker.Npgsql 1.0.2

dotnet add package ChangeTracker.Npgsql --version 1.0.2
                    
NuGet\Install-Package ChangeTracker.Npgsql -Version 1.0.2
                    
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="ChangeTracker.Npgsql" Version="1.0.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ChangeTracker.Npgsql" Version="1.0.2" />
                    
Directory.Packages.props
<PackageReference Include="ChangeTracker.Npgsql" />
                    
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 ChangeTracker.Npgsql --version 1.0.2
                    
#r "nuget: ChangeTracker.Npgsql, 1.0.2"
                    
#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 ChangeTracker.Npgsql@1.0.2
                    
#: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=ChangeTracker.Npgsql&version=1.0.2
                    
Install as a Cake Addin
#tool nuget:?package=ChangeTracker.Npgsql&version=1.0.2
                    
Install as a Cake Tool

ChangeTracker

NuGet Status NuGet Status NuGet Status

Change Tracker is a library for efficient HTTP caching using database change tracking. It implements 304 Not Modified responses by generating ETags based on database timestamps, reducing server load while ensuring clients always receive current data.

Overview

ChangeTracker monitors database changes and generates ETags that combine:

  • Assembly write time (when your application was built)
  • Database timestamp (last data modification time)
  • Custom suffix (optional runtime context)

When a client requests data with a cached ETag, the server compares it with the current state.

  • If unchanged: it returns 304 Not Modified and the client uses its cached copy.
  • If changed: fresh data is returned with a new ETag.

ETags follow this format:

{AssemblyWriteTime}-{DbTimeStamp}-{Suffix}

Ideal Use Case

  • Read-heavy applications where data changes less frequently than it's read
  • APIs serving semi-static data that changes periodically
  • Applications needing reduced server load without compromising data freshness

Quick start

1. Enable table tracking
2. Configure services
builder.Services
    .AddTracker()
    .AddNpgsqlProvider<DatabaseContext>();
3. Configure endpoint

Controller action:

[HttpGet]
[Track(["roles"])]
public ActionResult<IEnumerable<Role>> GetAll() => dbContext.Roles.ToList();

Minimal api:

app.MapGet("/roles/getall", (DatabaseContext dbContext) =>
{
    return dbContext.Roles.ToList();
})
.WithTracking(options =>
{
    options.Tables = ["roles"];
});

Middleware:

app.UseTracker(options =>
{
    options.Tables = ["roles"];
    options.Filter = (httpContext) => httpContext.Request.Path.Value.Contains("/api/roles/getall");
});

Verifying behavior

Testing Cache Hits

  • Open your application in a browser
  • Open Developer Tools (F12)
  • Navigate to the Network tab
  • Refresh the page

Cached responses will show:

  • Status: 304 Not Modified
  • Request Header: if-none-match (with ETag value)
  • Response Header: etag (current ETag)

Testing Cache Misses

To test the full request pipeline:

  • Open Developer Tools → Network tab
  • Check "Disable cache" in the toolbar
  • Refresh the page

This prevents the browser from sending if-none-match, forcing a cache miss and full server execution.

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
1.0.2 114 9/29/2026
1.0.1 154 1/5/2026
1.0.0 141 1/4/2026