Sylin.Koan.Data.Hygiene 1.0.288

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

Sylin.Koan.Data.Hygiene

Declarative field hygiene for Koan Entities: annotate string properties with [Trim], [Lowercase], or [Uppercase] and the value is normalized on the persisted clone across every write path — Save, bulk, batch, REST endpoints, soft-delete re-persists.

using Koan.Data.Abstractions.Annotations;

public sealed class Contact : Entity<Contact>
{
    [Trim, Lowercase] public string Email { get; set; } = "";
    [Trim] public string DisplayName { get; set; } = "";
}

Reference = Intent: referencing the package is the whole step — no registration, no options.

The contract

  • Normalization applies to the persisted clone; the caller's in-memory instance is never modified (ARCH-0098 clone discipline).
  • null passes through; empty strings pass through; normalization is invariant-culture.
  • ApplyOnRead is an identity no-op — trimming is irreversible by design, so the stored value IS the value. Types with hygiene transforms are automatically excluded from the distributed L2 cache.
  • Non-string or setter-less properties carrying hygiene attributes are skipped silently at scan time. Hygiene never throws; it is not validation.

Capability node: Field hygiene · Design record: docs/initiatives/data-hygiene.md.

Install

dotnet add package Sylin.Koan.Data.Hygiene

Limits

Configuration decides participation; unsupported requests reject before provider work with a named capability and a correction. Provider-specific limits live in the package's TECHNICAL.md.

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

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.288 115 9/13/2026
1.0.286 108 9/12/2026
1.0.284 99 9/12/2026
1.0.283 95 9/10/2026
1.0.280 107 9/10/2026
1.0.277 105 9/9/2026
1.0.274 96 9/9/2026
1.0.272 95 9/9/2026
1.0.268 100 9/9/2026
1.0.267 103 9/9/2026
1.0.263 90 9/5/2026
1.0.262 130 8/30/2026
1.0.261 100 8/30/2026
1.0.259 102 8/28/2026
1.0.258 102 8/28/2026
1.0.257 104 8/28/2026
1.0.256 96 8/28/2026
1.0.255 100 8/28/2026
1.0.254 114 8/27/2026
1.0.250 105 8/27/2026
Loading failed