Authlink.Portal.Client.Core 2.11.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 in v2.11.0

New Features - Registration Link Management:

• Added GetRegistrationLinksRequest / GetRegistrationLinksResponse for listing registration links with filtering
• Added GetRegistrationLinkRequest / GetRegistrationLinkResponse for retrieving a single registration link
• Added GetRegistrationLinkBatchRequest / GetRegistrationLinkBatchResponse for retrieving batch details
• Added CreateRegistrationLinkRequest / CreateRegistrationLinkResponse for creating single registration links
• Added CreateRegistrationLinkBatchRequest / CreateRegistrationLinkBatchResponse for batch creation
• Added RevokeRegistrationLinkRequest / RevokeRegistrationLinkResponse for revoking registration links
• Added ResendRegistrationLinkRequest / ResendRegistrationLinkResponse for resending emails
• Added RegistrationLinkDto, RegistrationLinkListDto, RegistrationLinkBatchDto, RecipientInfoDto DTOs
• Added RegistrationLinkStatus and RegistrationLinkBatchStatus enums
• 7 new methods on IPortalClient for registration link management

See CHANGELOG.md for full version history.

Error Handling

All methods return ErrorOr<T> for explicit error handling:

var result = await client.GetUsersAsync(request);

if (result.IsError)
{
    var error = result.FirstError;
    Console.WriteLine($"Error: {error.Code} - {error.Description}");

    // Access metadata
    if (error.Metadata.TryGetValue("StatusCode", out var statusCode))
    {
        Console.WriteLine($"HTTP Status: {statusCode}");
    }
    return;
}

var response = result.Value;

Error Types

The package includes PortalClientErrors with predefined error factories:

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

Documentation

https://docs.authlink.co.za

License

MIT