JJConsulting.Infinity.Client 1.4.17

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();

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.