initial commit

backend/API/DTOs/PrintJobs/PrintJobQueryDtos.cs

@@ -0,0 +1,30 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace Extrudex.API.DTOs.PrintJobs;
+
+/// <summary>
+/// Query parameters for filtering and paginating the print job list endpoint.
+/// All parameters are optional — defaults are applied when not provided.
+/// </summary>
+public class PrintJobQueryParameters
+{
+    /// <summary>Page number (1-based). Defaults to 1.</summary>
+    [Range(1, int.MaxValue, ErrorMessage = "PageNumber must be at least 1.")]
+    public int PageNumber { get; set; } = 1;
+
+    /// <summary>Number of items per page. Defaults to 20, max 100.</summary>
+    [Range(1, 100, ErrorMessage = "PageSize must be between 1 and 100.")]
+    public int PageSize { get; set; } = 20;
+
+    /// <summary>Optional filter by printer ID. Only returns jobs for this printer.</summary>
+    public Guid? PrinterId { get; set; }
+
+    /// <summary>Optional filter by spool ID. Only returns jobs that used this spool.</summary>
+    public Guid? SpoolId { get; set; }
+
+    /// <summary>
+    /// Optional filter by job status. Must be a valid JobStatus value
+    /// (Queued, Printing, Completed, Cancelled, Failed). Case-insensitive.
+    /// </summary>
+    public string? Status { get; set; }
+}