namespace BlueLaminate.Core.Options;

/// <summary>
/// Pacing configuration for the listing sweeps, bound from the <c>Sweep</c>
/// configuration section. Controls how the sweep throttles itself between API
/// pages so it stays under CSFloat's rate limit. Defaults preserve the original
/// hard-coded behaviour.
/// </summary>
public sealed class SweepOptions
{
    public const string SectionName = "Sweep";

    /// <summary>
    /// Base courtesy delay between pages, applied even when the rate-limit bucket
    /// looks healthy so we never hammer the API at a fixed cadence.
    /// </summary>
    public TimeSpan PageDelay { get; set; } = TimeSpan.FromSeconds(5);

    /// <summary>
    /// Upper bound on the random jitter added to <see cref="PageDelay"/>; the
    /// spread keeps request timing from being perfectly regular.
    /// </summary>
    public TimeSpan MaxJitter { get; set; } = TimeSpan.FromSeconds(3);

    /// <summary>
    /// Pace before the rate-limit bucket is fully empty by this many requests, so
    /// a slightly-stale counter can't tip us into a 429.
    /// </summary>
    public int RateLimitSafetyMargin { get; set; } = 2;

    /// <summary>
    /// Fallback wait when the bucket is exhausted but the API didn't report a usable
    /// reset time. Guarantees we never fire a request at zero remaining.
    /// </summary>
    public TimeSpan RateLimitCooldown { get; set; } = TimeSpan.FromSeconds(60);
}