DcsvIo.D2.Validation.Abstractions 0.1.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package DcsvIo.D2.Validation.Abstractions --version 0.1.1
                    


                    

                
NuGet\Install-Package DcsvIo.D2.Validation.Abstractions -Version 0.1.1
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="DcsvIo.D2.Validation.Abstractions" Version="0.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="DcsvIo.D2.Validation.Abstractions" Version="0.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="DcsvIo.D2.Validation.Abstractions" />
                    


                            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 DcsvIo.D2.Validation.Abstractions --version 0.1.1
                    


                    

                
#r "nuget: DcsvIo.D2.Validation.Abstractions, 0.1.1"
#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 DcsvIo.D2.Validation.Abstractions@0.1.1
#: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=DcsvIo.D2.Validation.Abstractions&version=0.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=DcsvIo.D2.Validation.Abstractions&version=0.1.1
                    


                            Install as a Cake Tool

DcsvIo.D2.Validation.Abstractions

Audience: backend .NET service engineers and any consumer that depends on email, phone, or postal-code validation, the shared field-length bounds, or the name/sex taxonomy enums — without committing to a specific implementation.

Interface contracts for the D² validator family plus the shared field-constraints catalog (codegen-emitted field-length constants + closed-list taxonomy enums). Domain code anywhere in the backend can reference this package without pulling in a phone-number library, regex catalog, or DI container. This is the lowest shared vocabulary layer every consumer depends on — the validator interfaces, the FieldConstraints bounds that gate value-object Create(...) calls, and the NamePrefix / NameSuffix / BiologicalSex taxonomy enums.

Install

dotnet add package DcsvIo.D2.Validation.Abstractions

Interfaces

Interface Signature Returns
IEmailValidator Validate(string? email) Ok with trimmed + lowercased address; ValidationFailed with per-field InputError
IPhoneValidator Validate(string? phone, CountryCode? defaultRegion = null) Ok with E.164-normalized number; ValidationFailed with per-field InputError
IPostalCodeValidator Validate(string? postalCode, CountryCode? countryCode = null) Ok with trimmed + uppercased code; ValidationFailed with per-field InputError

All three interfaces share the same return contract: D2Result<string> — normalized value on success, ValidationFailed carrying structured InputError field diagnostics on failure.

Field-constraints catalog (codegen-emitted)

Spec-driven from contracts/validation/field-constraints.spec.json via DcsvIo.D2.Validation.SourceGen — emitted at build time into Generated/ (committed, linguist-generated). The same spec drives the TS-side @dcsv-io/d2-validation-abstractions catalog, so cross-language drift is structurally impossible.

FieldConstraints (static class of public const int)

Field-length / digit-count bounds — generous-but-bounded; they reject garbage, never real human data. The value objects (contacts + Location) and the FE/BFF Zod schemas read these to gate Create(...).

Constant Value Applies to
FIRST_NAME_MAX / MIDDLE_NAME_MAX / LAST_NAME_MAX / PREFERRED_NAME_MAX 255 person name fields
COMPANY_NAME_MAX / JOB_TITLE_MAX / DEPARTMENT_MAX 255 professional fields
STREET_LINE_MAX / CITY_MAX 255 address fields
COMPANY_WEBSITE_MAX 2048 raw company-website URL
AFFIX_CUSTOM_MAX 64 custom name prefix / suffix
POSTAL_CODE_MAX 16 postal / ZIP code
EMAIL_MAX 254 email address
PHONE_E164_MAX 32 raw phone-number string
PHONE_MIN_DIGITS / PHONE_MAX_DIGITS 7 / 15 phone digit-count floor / ceiling

Taxonomy enums (byte-backed, [JsonConverter(typeof(JsonStringEnumConverter))])

Closed-list string-wire vocabularies. The member name IS the wire form; unknown wire codes throw JsonException at the deserialization boundary (strict policy).

Enum Members
NamePrefix (17) Mr, Ms, Miss, Mrs, Mx, Dr, Prof, Sir, Lady, Lord, RtHon, Rev, Fr, Pr, Sr, Elder, Other
NameSuffix (13) Jr, Sr, I–X (ordinals), Other
BiologicalSex (4) Male, Female, Intersex, Unspecified (absence sentinel; no Other)

The catalog carries no localized display strings (member names are display-adequate); FE labels route through i18n TK.* keys if a picker needs them.

Consumers

  • .NET services — inject via DI; implementations live in DcsvIo.D2.Validation.
  • Frontend parity — the TypeScript mirror package @dcsv-io/d2-validation-abstractions defines the equivalent interfaces AND the same codegen-emitted FieldConstraints + taxonomy enums (with Zod schemas) so client-side validation stays structurally in sync with the server.

The postal-code twin

DcsvIo.D2.Validation.Abstractions.IPostalCodeValidator (this package) is the country-aware validator — it accepts a CountryCode and applies country-specific format rules. A deliberately distinct twin exists at DcsvIo.D2.Location.IPostalCodeValidator: that is the country-blind boundary validator used by value-object construction (global-range regex only). The two share a short name but are namespace-distinct by design. Consumers needing both may alias one with a using directive.

Dependencies

  • DcsvIo.D2.Result — D2Result<string> return type for all three interfaces.
  • DcsvIo.D2.Geo.Abstractions — CountryCode parameter on IPhoneValidator and IPostalCodeValidator.
  • DcsvIo.D2.Validation.SourceGen (analyzer; ReferenceOutputAssembly="false", PrivateAssets="all") — emits the FieldConstraints + taxonomy catalog at build time; no runtime closure impact.

Zero DI / implementation / IO dependencies. This is the vocabulary slice every consumer depends on.

Telemetry

No telemetry surface — foundation lib emits no spans or metrics. Consumers instrument the validator call sites in their own OTel setup.

Configuration

No configuration — zero-config; the contracts carry no tunable behavior.

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 (4)

Showing the top 4 NuGet packages that depend on DcsvIo.D2.Validation.Abstractions:

Package Downloads
DcsvIo.D2.Location

Hash-deduplicatable geographic value objects for D2 — coordinates, street and admin addresses, deterministic identity hashes, and the postal-code validator contract.
DcsvIo.D2.Contacts

Composable, self-redacting PII value objects for D2 — immutable Create-constructed building blocks (name, demographics, professional, email, phone) that fold into host entities.
DcsvIo.D2.Location.EntityFrameworkCore

Reusable Entity Framework Core mapping for the DcsvIo.D2.Location value objects, applied via infra IEntityTypeConfiguration.
DcsvIo.D2.Validation

Default validators for D2 — email, phone, and postal-code validation backed by libphonenumber-csharp and a ported postcode dataset.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.1 154 7/17/2026
0.1.0 150 7/17/2026