TlsClient.Core 0.3.1

TlsClient.Core

Core library for TlsClient.NET. Provides primitives to configure and build a TlsClient with advanced TLS capabilities (fingerprinting, browser identifiers, user-agent control, redirect & timeout policies, certificate validation toggles, cookie handling, etc.).

This package is the foundation used by subpackages like:

• TlsClient.HttpClient (via TlsClientHandler)
• TlsClient.RestSharp (via TlsRestClientBuilder)

📦 Installation

Install from NuGet:

dotnet add package TlsClient.Core

🚀 Quick Start

Example 1 – Direct Options

using TlsClient.Core;

TlsClient.Initialize("{LIBRARY_PATH}");

var tlsClient = new TlsClient(
    new TlsClientOptions
    {
        TlsClientIdentifier = TlsClientIdentifier.Chrome132,
        FollowRedirects = true,
        Timeout = TimeSpan.FromSeconds(15),
        InsecureSkipVerify = true,
        DefaultHeaders = new()
        {
            { "User-Agent", new() { "TlsClient.NET 1.0" } }
        }
    }
);

Example 2 – Fluent Builder

using TlsClient.Core;

TlsClient.Initialize("{LIBRARY_PATH}");

var tlsClient = new TlsClientBuilder()
    .WithIdentifier(TlsClientIdentifier.Chrome132)
    .WithUserAgent("TestClient 1.0")
    .WithFollowRedirects()
    .WithTimeout(TimeSpan.FromSeconds(15))
    .WithDefaultCookieJar()
    .Build();

ℹ️ Use TlsClient.HttpClient or TlsClient.RestSharp to integrate into existing stacks.

⚠️ Without TlsClient.Initialize(path) the library will not work.

⚙️ Options (TlsClientOptions)

🧰 Builder (TlsClientBuilder)

Fluent API to configure a TlsClient.

Example 1 – Proxy + Headers

TlsClient.Initialize("{LIBRARY_PATH}");

var tlsClient = new TlsClientBuilder()
    .WithIdentifier(TlsClientIdentifier.Chrome132)
    .WithProxyUrl("http://127.0.0.1:8080", isRotating: true)
    .WithHeader("Accept-Language", "en-US,en;q=0.9")
    .Build();

Example 2 – With Pinning

TlsClient.Initialize("{LIBRARY_PATH}");

var tlsClient = new TlsClientBuilder()
    .WithIdentifier(TlsClientIdentifier.Chrome132)
    .WithCertificatePinning("example.com", new List<string>
    {
        "sha256/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
    })
    .Build();

Tabii 👍 İşte sadece Request kısmı (tüm property’ler dahil, Markdown formatında döküm):

📦 Request (Request)

The Request class represents a single HTTP request configuration. Below are all available properties:

🧰 Request Builder (RequestBuilder)

Simplifies building a Request.

Example 1 – JSON POST

var req = new RequestBuilder()
    .WithUrl("https://httpbin.org/post")
    .WithMethod(HttpMethod.Post)
    .WithBody(new { email = "user@example.com", active = true })
    .WithHeader("Content-Type", "application/json")
    .Build();

Example 2 – GET with Cookies

var req = new RequestBuilder()
    .WithUrl("https://example.com/report")
    .WithMethod(HttpMethod.Get)
    .WithCookie("session", "abcdef")
    .WithStreamOutputPath("C:\\temp\\report.bin")
    .Build();

🧯 Error Handling

• Builders throw ArgumentException / InvalidOperationException for invalid inputs.
• Network/TLS issues bubble up as standard .NET exceptions.

🧪 Testing Tips

• Use https://httpbin.org to test headers, cookies, TLS behavior.
• Toggle InsecureSkipVerify only in controlled test environments.

📜 License

MIT License – see the root LICENSE file.