Authlink.Portal.Client.Core 2.2.0

📦 Package Overview

Authlink.Portal.Client.Core is a low-level, dependency-free library that defines interfaces, data contracts, and shared models used by client SDKs that integrate with Authlink Portal.

It is intended to be consumed by higher-level packages such as:

• Authlink.Portal.Client.Http

🚀 Install

dotnet add package Authlink.Portal.Client.Core

Or via Package Manager:

PM> Install-Package Authlink.Portal.Client.Core

🔧 Purpose

This package serves as a foundation layer, enabling:

• Type-safe error handling with ErrorOr<T>
• Comprehensive error information (HTTP status codes, response bodies, exception details)
• Decoupled, testable client implementations
• Plug-and-play support across .NET environments (console, web, serverless)

🆕 What's New

v2.2.0

New Features:

• Added TenantId filtering parameter to GetUsersRequest for tenant-specific user queries
• Added Status filtering parameter to GetUsersRequest for filtering users by status (Active, Inactive, Deleted)

Enhancements:

• Enhanced user query capabilities with status-based filtering
• Improved tenant-aware user retrieval

v2.1.0

New Features:

• Added GetUserByEmailRequest and GetUserByEmailResponse for retrieving users by email address
• Added GetUserByGovernmentIdRequest and GetUserByGovernmentIdResponse for retrieving users by government identifier
• Updated IPortalClient interface with GetUserByEmailAsync and GetUserByGovernmentIdAsync methods

Enhancements:

• Improved documentation for all request/response models

v2.0

Breaking Changes:

All IPortalClient methods now return ErrorOr<TResponse> instead of throwing exceptions:

// v1.x - Exception-based error handling
Task<UsersResponse> UsersAsync(UsersRequest request, CancellationToken cancellationToken = default);

// v2.0 - ErrorOr-based error handling
Task<ErrorOr<UsersResponse>> UsersAsync(UsersRequest request, CancellationToken cancellationToken = default);

New Error Handling:

The package now includes PortalClientErrors with predefined error factories for common scenarios:

• HTTP request failures (with status codes and response bodies)
• Not Found (404)
• Validation failures (400)
• Unauthorized (401)
• Forbidden (403)
• Conflict (409)
• Deserialization errors
• Network errors
• Timeouts

All errors include rich metadata accessible via error.Metadata dictionary:

• StatusCode - HTTP status code
• ResponseBody - Server response content
• RequestPath - The request path that failed
• ExceptionType & ExceptionMessage - Exception details

📚 Documentation

https://docs.authlink.co.za

📄 License

MIT