using System.ComponentModel.DataAnnotations;

namespace BlueLaminate.Scraper.CsFloat;

/// <summary>
/// Configuration for <see cref="CsFloatListingsClient"/>, bound from the
/// <c>CsFloat</c> configuration section. Defaults match the live API so the
/// client works with no configuration beyond the key.
/// </summary>
public sealed class CsFloatOptions
{
    public const string SectionName = "CsFloat";

    /// <summary>
    /// Developer key CSFloat requires on the <c>Authorization</c> header. Falls
    /// back to the legacy <c>CSFLOAT_API_KEY</c> environment variable (wired in the
    /// composition root). Only commands that hit the API need it.
    /// </summary>
    public string? ApiKey { get; set; }

    /// <summary>Active-listings endpoint.</summary>
    public string BaseUrl { get; set; } = "https://csfloat.com/api/v1/listings";

    /// <summary>
    /// Listings per page. CSFloat caps this at 50; values outside [1, 50] are
    /// rejected at startup rather than silently clamped.
    /// </summary>
    [Range(1, 50, ErrorMessage = "CsFloat:MaxLimit must be between 1 and 50 (the CSFloat API page cap).")]
    public int MaxLimit { get; set; } = 50;
}