using var client = await LinkitClient.CreateClientAsync(
    config => config
        .WithBaseUrl("https://linkit.works/api/v1")
        .WithTimeout(TimeSpan.FromMinutes(2))
        .WithMaxConcurrentRequests(100)
        .WithRetryPolicy(retry => {
            retry.MaxRetries = 5;
            retry.InitialDelay = TimeSpan.FromMilliseconds(200);
            retry.BackoffMultiplier = 2.0;
            retry.MaxDelay = TimeSpan.FromSeconds(30);
        })
        .WithDefaultHeader("X-Client-Version", "1.0.0")
        .WithDefaultHeader("X-Correlation-Id", Guid.NewGuid().ToString())
        .WithRequestLogging(
            onBeforeRequest: req => logger.LogTrace("[Outbound] {Method} {Uri}", req.Method, req.RequestUri),
            onAfterResponse: res => logger.LogTrace("[Inbound] {StatusCode}", res.StatusCode))
        .OnError(error => logger.LogError(error, "Client error occurred"))
        .OnInitialized(() => logger.LogInformation("Linkit client initialized successfully")),
    jwtToken,
    errorHandler => errorHandler
        .WithCircuitBreaker(failureThreshold: 10, resetTimeout: TimeSpan.FromMinutes(2))
        .WithRetryPolicy(maxRetries: 3, retryDelay: TimeSpan.FromSeconds(1)),
    logger
).ConfigureAwait(false); // ← Always use ConfigureAwait(false) on .NET Framework

var product = await client.Products()
    .Create()
    .WithId("PROD-001")
    .WithName("Premium Widget", "ويدجت متميز")
    .WithPrice(99.99, vatPercentage: 0.15)
    .WithBarcode("1234567890123")
    .WithAttributes(attr => attr
        .IsFastMoving()
        .Buffer(25)
        .SitemapPriority(0.9))
    .EnableQuickCommerce()
    .AsEnabled()
    .ExecuteAsync();

var products = await client.Products()
    .Query()
    .SearchFor("laptop")
    .EnabledOnly()
    .FastMovingOnly()
    .QuickCommerceOnly()
    .Page(1)
    .Take(50)
    .OrderBy("-created")
    .WithMetadata("query_type", "inventory_check")
    .ExecuteAsync();

await client.Products()
    .ProcessInBatches()
    .Where(p => p.AveragePrice > 1000)
    .WithBatchSize(100)
    .WithConcurrency(10)
    .Process(async products => {
        foreach (var product in products)
            await ProcessProductAsync(product).ConfigureAwait(false);
    })
    .ProcessAllAsync();

// Update stock levels
await client.Skus()
    .UpdateStock("EXISTING-SKU-ID", "BRANCH-ID")
    .SetQuantity(150)
    .SetAvailability(true)
    .WithMetadata("reason", "restocking")
    .ExecuteAsync();

// Update SKU with marketplace IDs
await client.Skus()
    .Update("EXISTING-SKU-ID", "BRANCH-ID")
    .WithPrice(899.99)
    .WithStock(quantity: 200, maxQuantity: 1000)
    .WithReorderThreshold(50)
    .WithMarketplaceIds(ids => ids
        .Amazon("AMZ-SKU-123", "B08N5WRWNW")
        .Noon("N123456789", "Z87654321")
        .Salla("SALLA-987")
        .Zid("ZID-654"))
    .ExecuteAsync();

// Create
var branch = await client.Branches()
    .Create()
    .WithId("STORE-001")
    .WithName("Downtown Store", "متجر وسط المدينة")
    .AtLocation(25.2048, 55.2708)
    .WithStatus(BranchStatus.Published)
    .AsActive()
    .WithWorkingHours(hours => hours
        .Monday("09:00", "21:00")
        .Friday("14:00", "22:00"))
    .ExecuteAsync();

// Find nearby
var nearbyBranches = await client.Branches()
    .FindNearby(lat: 25.2048, lon: 55.2708)
    .WithinRadius(10)
    .ActiveOnly()
    .ExecuteAsync();

// Create
var customer = await client.Customers()
    .Create()
    .WithName("Ahmad", "Hamdi")
    .WithEmail("ahmad@example.com")
    .WithPhone("+966500000000")
    .AsType("vip")
    .WithStatus("active")
    .ExecuteAsync();

// Lookup
var found = await client.Customers()
    .Lookup()
    .ByEmail("ahmad@example.com")
    .ExecuteAsync();

// Batch process VIP customers
await client.Customers()
    .ProcessInBatches()
    .ActiveOnly()
    .Where(c => c.Type == "vip")
    .WithBatchSize(50)
    .WithConcurrency(10)
    .Process(async customers => {
        foreach (var c in customers)
            await ProcessVipCustomerAsync(c).ConfigureAwait(false);
    })
    .ProcessAllAsync();

using LinkitDotNetLegacy.Exceptions;

try
{
    var sku = await client.Skus().Query().ForProduct("nonexistent").ExecuteAsync();
}
catch (LinkitNotFoundException ex)
{
    Console.WriteLine($"Not found: {ex.ResourceId}");
}
catch (LinkitRateLimitException ex)
{
    Console.WriteLine($"Rate limited — retry after {ex.RetryAfterMs}ms");
}
catch (LinkitValidationException ex)
{
    foreach (var error in ex.Details)
        Console.WriteLine($"  {error.Key}: {error.Value}");
}
catch (LinkitApiException ex)
{
    Console.WriteLine($"API error {ex.StatusCode}: {ex.Message}");
}

config => config
    .WithRetryPolicy(retry => {
        retry.MaxRetries = 5;
        retry.InitialDelay = TimeSpan.FromMilliseconds(200);
        retry.BackoffMultiplier = 2.0;
    })
    .WithMaxConcurrentRequests(20)

// ✅ Correct for .NET Framework library code
var result = await client.Products().Query().ExecuteAsync().ConfigureAwait(false);

// ❌ Risk of deadlock in ASP.NET / WinForms contexts
var result = await client.Products().Query().ExecuteAsync();

// The SDK internally uses optimized settings:
// - ContractResolver: CamelCasePropertyNamesContractResolver
// - NullValueHandling: NullValueHandling.Ignore
// - DateFormatHandling: DateFormatHandling.IsoDateFormat
// - Custom converters for DateTime and empty arrays