namespace StellaOps.JobEngine.WebService.Contracts;

/// <summary>
/// Common query options for pagination.
/// </summary>
public sealed record QueryOptions
{
    /// <summary>Maximum number of results to return. Default 50.</summary>
    public int Limit { get; init; } = 50;

    /// <summary>Cursor for pagination (opaque token).</summary>
    public string? Cursor { get; init; }

    /// <summary>Sort order: "asc" or "desc". Default "desc".</summary>
    public string? Sort { get; init; }

    /// <summary>Filter by created after date.</summary>
    public DateTimeOffset? CreatedAfter { get; init; }

    /// <summary>Filter by created before date.</summary>
    public DateTimeOffset? CreatedBefore { get; init; }
}