MaksIT.CR.Client 2.0.0

MaksIT.CR.Client

HTTP client for the MAKS-IT CR API.

• CR routes (api/cr/*, registry): JWT Bearer via AccessToken, or HTTP Basic (Username / Password) for service users.
• Identity (api/identity/*): JWT Bearer via AccessToken (set manually or after LoginAsync / RefreshTokenAsync).

Shared wire types (MaksIT.CR.Contracts) are bundled in this NuGet package.

Features

• ICRClient / CRClient for organizations, applications, catalog images/charts, registry, and identity.
• DI registration via AddCRClient (Microsoft.Extensions.Http).
• CRApiException when the API returns a non-success status code.

Installation

dotnet add package MaksIT.CR.Client

Target Framework

• .NET 10 (net10.0)

Quick Start

Dependency injection (JWT or Basic)

using MaksIT.CR.Client;
using MaksIT.CR.Contracts.CR.Organization.Search;

builder.Services.AddCRClient(opts => {
  opts.BaseAddress = "https://cr.example.com";
  opts.Username = "admin";
  opts.Password = "...";
  // or: opts.AccessToken = "<jwt>";
});

public sealed class MyService(ICRClient client) {
  public Task DoWorkAsync(CancellationToken ct) =>
    client.SearchOrganizationsAsync(new SearchOrganizationRequest { PageNumber = 1, PageSize = 20 }, ct);
}

JWT (identity)

var login = await client.LoginAsync(new LoginRequest { Username = "admin", Password = "..." });
// client.AccessToken is set automatically

var users = await client.SearchUsersAsync(new SearchUserRequest { PageNumber = 1, PageSize = 20 });

Or pass AccessToken in CRClientOptions / Connect-CR -AccessToken.

Use the reverse-proxy origin when CR is deployed behind YARP or ingress (e.g. http://localhost:8080), not the internal server port.

Manual construction

var httpClient = new HttpClient();
var client = new CRClient(httpClient, "https://cr.example.com", username: "admin", password: "...", accessToken: null);

Contract namespaces

Patch DTOs use PatchRequestModelBase with Operations: Dictionary<string, PatchOperation> from MaksIT.Core.Webapi.Models.

API surface

Catalog chart names are short (demo-app). Helm OCI URLs use the fixed prefix: helm push … oci://host/charts → oci://host/charts/demo-app. Images stay flat (docker push host/api). The same short name may be used for an Image and a Chart; charts is reserved.

PowerShell

See MaksIT.CR.Client.PowerShell (Connect-CR and cmdlets for CR and identity).

Contributing

See CONTRIBUTING.md.

License

See LICENSE.md.