DcsvIo.D2.ErrorCodes.Registry 0.1.1

DcsvIo.D2.ErrorCodes.Registry

Merged cross-catalog error-code registry for D2. Aggregates every *-error-codes.spec.json catalog into a single compile-time-frozen code → ErrorCodeInfo lookup table — so any consuming service can resolve a wire error code to its full metadata without importing the producer's catalog.

Generated by DcsvIo.D2.ErrorCodes.Registry.SourceGen (RegistryGenerator) from the generic error-codes catalog plus all domain *-error-codes.spec.json files. Never hand-edit generated ErrorCodeRegistry.g.cs — change the spec and rebuild.

Install

dotnet add package DcsvIo.D2.ErrorCodes.Registry

Public API

if (ErrorCodeRegistry.TryResolve("AUTH_JWT_EXPIRED", out var info))
{
    info.Code;           // "AUTH_JWT_EXPIRED"
    info.HttpStatus;     // 401
    info.Category;       // ErrorCategory.ValidationFailure
    info.Category.ToWire(); // "validation_failure"
    info.UserMessageKey; // TK.Auth.Errors.UNAUTHORIZED
    info.FactoryName;    // "JwtExpired"
    info.FactoryShape;   // "standard"
    info.Domain;         // "auth"
}

var allCodes = ErrorCodeRegistry.All;

ErrorCodeInfo field shape

Catalog behavior

• Merged: all *-error-codes.spec.json catalogs are aggregated into one registry at build time — no runtime I/O or DI required.
• Cross-catalog collision guard: D2ERC004 fires at build time when the same code string appears in two different catalogs; D2ERC005 fires on reserved-namespace violations (unprefixed code in a per-domain spec, or domain-prefixed code in the generic spec). No registry is emitted until violations are resolved.
• Category validation: D2ERC006 fires on a malformed spec; D2ERC007 fires when a code's category wire string is not a member of the closed ErrorCategory set.
• Unknown codes return false / null — a hard not-found signaling deploy-skew to the caller.

Dependency edges

DcsvIo.D2.ErrorCodes.Category   (zero-dep leaf — ErrorCategory enum)
         ▲
         └── DcsvIo.D2.ErrorCodes.Registry
                   ▲
                   └── (consuming services — never from domain code)

DcsvIo.D2.I18n.Keys is also a direct dependency (the UserMessageKey field is a typed TKMessage; the TKMessage constructor is internal and DcsvIo.D2.I18n.Abstractions grants InternalsVisibleTo access to this assembly).

Source of truth

Generic error-codes catalog + every domain *-error-codes.spec.json + the closed error-category set the registry cross-checks against at codegen time.

The TypeScript package @dcsv-io/d2-error-codes-registry is generated from the same spec set. Cross-runtime parity is pinned by shared fixtures / twin tests.