UtilityNGPKG — v1.0.0
Welcome to the official documentation for UtilityNGPKG, a collection of ready-to-use .NET service integrations for common backend tasks — from sending emails and verifying identities, to processing payments and generating JWT tokens.
Getting Started — AddUtilityNGPKG
The ideal way to register all services available on this package is the AddUtilityNGPKG extension method. Call it once in your Program.cs:
builder.Services.AddUtilityNGPKG();
This registers the following services automatically:
| Interface | Implementation | Lifetime |
|---|---|---|
IApiIntegrationService |
IntegrationService |
Scoped |
IPaystackService |
PaystackService |
Scoped |
IFileService |
FileService |
Scoped |
IKycService |
KycService |
Scoped |
IPaginationHelperFactory |
PaginationHelperFactory |
Singleton |
ITokenBuilder |
TokenBuilder |
Singleton |
IMailService |
MailService |
Singleton |
ISanitizationService |
SanitizationService |
Singleton |
It also calls services.AddHttpClient() internally, so you might not need to register that separately.
Available Modules
| Module | Description |
|---|---|
| External API Integration | Generic HTTP client wrapper for outbound third-party API calls |
| File Upload | Upload, download, sign, and delete files via cloud storage providers |
| KYC Integration | Identity verification and PDF text extraction |
| Mailer | Transactional emails with built-in HTML templates |
| Pagination | Slice in-memory collections into pages with full nav metadata |
| Payment Gateway | Full payment lifecycle — pay-ins, payouts, bank resolution, webhooks |
| Sanitizer | XSS-safe HTML and URL sanitization |
| Tokenomics | JWT generation, password hashing (Argon2id), AES/RSA encryption, token generation |
| Response Detail | Standardized API response wrapper used throughout the package |