JJConsulting.Infinity.Client 1.4.33

JJConsulting.Infinity.Client

Client library for interacting with the JJInfinity API, providing typed access to its endpoints and integration support for .NET applications.

Installation

Install via NuGet Package Manager:

dotnet add package JJConsulting.Infinity.Client

Or via the NuGet Package Manager UI in Visual Studio or Rider.

For Serilog ASP.NET Core integration, also install:

dotnet add package Serilog.AspNetCore

Usage

1. Register the client in your Program.cs:

using JJConsulting.Infinity.Client.Configuration;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddInfinityClient(options =>
{
    options.BaseAddress = builder.Configuration["Infinity:BaseAddress"]!;
    options.Token = builder.Configuration["Infinity:Token"]!;
});

// OR, if you need SignIn authentication:
builder.Services.AddInfinityClient(options =>
{
    options.BaseAddress = builder.Configuration["Infinity:BaseAddress"]!;
    options.Username = builder.Configuration["Infinity:Username"]!;
    options.Password = builder.Configuration["Infinity:Password"]!;
});

var app = builder.Build();

Localization Providers

You can register one or more localization providers and sync them automatically at application startup:

using JJConsulting.Infinity.Client.Configuration;
using JJConsulting.Infinity.Client.Localization;

public sealed class AppLocalizationProvider : IInfinityLocalizationProvider
{
    public Task<List<string>> GetKeysAsync(CancellationToken cancellationToken = default)
    {
        return Task.FromResult(new List<string>
        {
            "Hello",
            "Home.Title"
        });
    }
}

builder.Services
    .AddInfinityClient(options =>
    {
        options.BaseAddress = builder.Configuration["Infinity:BaseAddress"]!;
        options.Token = builder.Configuration["Infinity:Token"]!;
    })
    .WithInfinityLocalization("MyApp")
    .AddKeysFromLocalizationProvider<AppLocalizationProvider>();

At startup, each provider is executed and the client sends its keys to POST /localization/sources/{source}/keys.

Resource File Provider (.resx)

If you already maintain translations in resource files, you can register AddKeysFromResources<TResource>().

The provider reads all resource files for TResource (neutral + culture-specific resources) and sends discovered keys during startup sync.

using JJConsulting.Infinity.Client.Configuration;

// Marker type that has matching .resx files, for example:
// - MyAppResources.resx
// - MyAppResources.pt-BR.resx
public sealed class MyAppResources;

builder.Services
    .AddInfinityClient(options =>
    {
        options.BaseAddress = builder.Configuration["Infinity:BaseAddress"]!;
        options.Token = builder.Configuration["Infinity:Token"]!;
    })
    .WithInfinityLocalization("MyApp")
    .AddKeysFromResources<MyAppResources>();

Manual Localization API

If you need to call localization endpoints directly, inject ILocalizationService:

using JJConsulting.Infinity.Localization;

public sealed class LocalizationSyncService(ILocalizationService localizationService)
{
    public async Task SyncAsync(CancellationToken cancellationToken = default)
    {
        await localizationService.SetStringsAsync("MyApp", new List<LocalizationCultureStrings>
        {
            new()
            {
                Culture = "en-US",
                Strings = new Dictionary<string, string>
                {
                    ["Hello"] = "Hello"
                }
            }
        }, cancellationToken);

        await localizationService.AddKeysAsync("MyApp", ["NewKey1", "NewKey2"], cancellationToken);
    }
}

AddKeysAsync maps to POST /localization/sources/{source}/keys and ignores keys that already exist in the source.

You can generate a token selecting a user at /Admin/Users and generating a token at "Tokens".

2. Inject and use services in your application:

using JJConsulting.Infinity.Domain.Contracts;
using JJConsulting.Infinity.Domain.Identity.Users;

public class MyService(IUserService userService)
{
    public async Task<UserDetails> GetUserAsync(Guid userId)
    {
        var user = await userService.GetUserAsync(userId);
        // Handle the user
    }
}

Serilog Integration (ASP.NET Core)

Send structured logs from Serilog directly to the JJInfinity API using Serilog.AspNetCore.

1. Configure Serilog in Program.cs using builder.Host.UseSerilog:

using JJConsulting.Infinity.Client.Configuration;
using Serilog;
using Serilog.Formatting.Compact;

var builder = WebApplication.CreateBuilder(args);

builder.Host.UseSerilog((context, services, loggerConfig) =>
{
    loggerConfig
        .WriteTo.Console()
        .WriteTo.InfinityHttp(options =>
        {
            options.BaseAddress = context.Configuration["Infinity:BaseAddress"]!;
            options.Token = context.Configuration["Infinity:Token"]!;
        });
});

builder.Services.AddInfinityClient(options =>
{
    options.BaseAddress = builder.Configuration["Infinity:BaseAddress"]!;
    options.Token = builder.Configuration["Infinity:Token"]!;
});

var app = builder.Build();

2. Use Serilog normally in your application using ILogger:

public class OrderController(ILogger<OrderController> logger) : ControllerBase
{
    [HttpGet("{id}")]
    public IActionResult GetOrder(int id)
    {
        logger.LogInformation("Fetching order with ID {OrderId}", id);
        return Ok();
    }

Features

• Typed access to JJInfinity API endpoints
• Integration with Microsoft.Extensions.DependencyInjection
• Supports .NET Standard 2.0 and above

Public API

The public API is available here.