more flex and filters

Controllers/IssuedInvoicesController.cs

@@ -18,10 +18,24 @@ public sealed class IssuedInvoicesController : ControllerBase
 
     public IssuedInvoicesController(IssuedInvoicesService service) => _service = service;
 
-    /// <summary>List issued invoices (paged).</summary>
+    /// <summary>
+    /// List issued invoices (paged, optionally filtered and sorted).
+    /// </summary>
+    /// <param name="filter">
+    /// Optional iDoklad-style filter, e.g. <c>(DateOfTaxing~gte~2024-01-01),(IsPaid~eq~false)</c>.
+    /// Operators: eq, neq, gt, gte, lt, lte, ct (contains), nct (not contains).
+    /// </param>
+    /// <param name="filtertype">How multiple conditions combine: <c>and</c> (default) or <c>or</c>.</param>
+    /// <param name="sort">Optional sort, e.g. <c>DateOfIssue~desc,Id~asc</c>.</param>
     [HttpGet]
-    public async Task<IActionResult> List([FromQuery] int page = 1, [FromQuery] int pageSize = 20, CancellationToken ct = default)
-        => Ok(await _service.ListAsync(page, pageSize, ct));
+    public async Task<IActionResult> List(
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 20,
+        [FromQuery] string? filter = null,
+        [FromQuery] string? filtertype = null,
+        [FromQuery] string? sort = null,
+        CancellationToken ct = default)
+        => Ok(await _service.ListAsync(page, pageSize, filter, filtertype, sort, ct));
 
     /// <summary>Get an issued invoice detail by id.</summary>
     [HttpGet("{id:int}")]