JTigerNova.jtiger.network 1.0.0

jtiger.network

.NET library providing a resilient HTTP api client base, built on RestSharp.

Retries transport failures with linear backoff and builds a fresh client per attempt, so a retry never reuses a faulted connection. No I/O beyond the request itself.

ResilientApiClient

Derive from it and implement GetApiUrlEndpoint to map a relative url onto your base endpoint:

public sealed class MyApi : ResilientApiClient
{
    private readonly string baseUrl;

    public MyApi(string baseUrl) { this.baseUrl = baseUrl; }

    protected override string GetApiUrlEndpoint(string relativeUrl) => $"{baseUrl}/{relativeUrl}";

    public Task<(IRestResponse Response, Uri BaseUrl)> GetWidget(string id)
        => ExecuteGet($"widgets/{id}");
}

Verb helpers - ExecuteGet, ExecutePost, ExecutePut, ExecutePatch, ExecuteDelete - take optional headers and form parameters. For anything richer (file uploads, query params, custom serialization) use the configureRequest overload:

var (response, baseUrl) = await Execute(
    method:           Method.POST,
    relativeUrl:      "media/upload",
    configureRequest: req => req.AddFile("file", path),
    timeoutMs:        120_000);

Retry behavior

A request is attempted up to TransportAttempts times. An attempt is retried only when ResponseStatus != Completed - that is, on transport failure. A completed request is returned as-is, so HTTP 4xx/5xx are never retried; the caller decides what those mean.

With the defaults (3 attempts, 100ms base) a fully failing request waits 100ms, then 200ms, then gives up.

Each attempt constructs a new RestClient and RestRequest, which is what keeps a retry from reusing a connection that just faulted.

Timeouts

protected virtual int RequestTimeout         => ApiClientDefaults.RequestTimeout;         
protected virtual int RequestTimeoutExtended => ApiClientDefaults.RequestTimeoutExtended; 

EnableExtendedTimeout switches between the two. Override either property to change them for your client, or pass timeoutMs to Execute for a single call.

ResilientJTigerNovaApiClient

Adds endpoint resolution for the three JTiger Nova environments.

public sealed class MyNovaApi : ResilientJTigerNovaApiClient
{
    public MyNovaApi(bool isLocal, bool isProduction) : base(isLocal: isLocal, isProduction: isProduction) { }

    protected override string ApiLocal      => "http://localhost:5000";
    protected override string ApiTest       => "https://test.example.com";
    protected override string ApiProduction => "https://api.example.com";
    protected override string ApiVersion    => "v1";
}

isLocal takes precedence over isProduction. The resolved path is exposed as Api, and IsApiPathKnown reports whether that path and ApiVersion are both present - useful when the paths come from configuration or a business rather than constants, so a client can bail before issuing a request that would go nowhere.

Defaults

Dependencies

• RestSharp

License

MIT License - Copyright 2026 JTiger Nova