Add Get Unban Requests endpoint

MiniTwitch.Helix/Enums/UnbanRequestStatus.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace MiniTwitch.Helix.Enums;
+
+public enum UnbanRequestStatus
+{
+    Unknown,
+    Pending,
+    Approved,
+    Denied,
+    Acknowledged,
+    Canceled,
+}

MiniTwitch.Helix/HelixWrapper.cs

@@ -959,4 +959,12 @@ public Task<HelixResult<UserEmotes>> GetUserEmotes(
         long? broadcasterId = null,
         CancellationToken cancellationToken = default)
     => _all.GetUserEmotes(broadcasterId, cancellationToken);
+
+    public Task<HelixResult<UnbanRequests>> GetUnbanRequests(
+        long broadcasterId,
+        UnbanRequestStatus status,
+        long? userId,
+        int? first,
+        CancellationToken cancellationToken = default)
+    => _all.GetUnbanRequests(broadcasterId, status, userId, first, cancellationToken);
 }

MiniTwitch.Helix/Internal/Models/Endpoints.cs

@@ -2027,4 +2027,18 @@ internal static class Endpoints
             _ => "Unknown response code"
         }
     };
+
+    public static readonly HelixEndpoint GetUnbanRequests = new()
+    {
+        Method = HttpMethod.Get,
+        Route = "/moderation/unban_requests",
+        SuccessStatusCode = HttpStatusCode.OK,
+        GetResponseMessage = code => code switch
+        {
+            HttpStatusCode.OK => "Successfully retrieved the list of unban requests.",
+            HttpStatusCode.BadRequest => "The broadcaster_id query parameter is required.\r\nThe ID in the broadcaster_id query parameter is not valid.\r\nThe moderator_id query parameter is required.\r\nThe ID in the moderator_id query parameter is not valid.\r\nThe pagination cursor is not valid.",
+            HttpStatusCode.Unauthorized => "The ID in moderator_id must match the user ID in the user access token.\r\nThe Authorization header is required and must contain a user access token.\r\nThe user access token must include the moderator:read:unban_requests or moderator:manage:unban_requests scope.\r\nThe access token is not valid.\r\nThe client ID specified in the Client-Id header does not match the client ID specified in the access token.",
+            _ => "Unknown response code"
+        }
+    };
 }

MiniTwitch.Helix/Models/AllCategories.cs

@@ -2153,4 +2153,23 @@ public Task<HelixResult<UserEmotes>> GetUserEmotes(
 
         return HelixResultFactory.Create<UserEmotes>(this.ApiClient, request, endpoint, cancellationToken);
     }
+
+
+    public Task<HelixResult<UnbanRequests>> GetUnbanRequests(
+        long broadcasterId,
+        UnbanRequestStatus status,
+        long? userId,
+        int? first,
+        CancellationToken cancellationToken = default)
+    {
+        HelixEndpoint endpoint = Endpoints.GetUnbanRequests;
+        RequestData request = new RequestData(_baseUrl, endpoint)
+            .AddParam(QueryParams.BroadcasterId, broadcasterId)
+            .AddParam(QueryParams.ModeratorId, this.UserId)
+            .AddParam(QueryParams.Status, status)
+            .AddParam(QueryParams.UserId, userId)
+            .AddParam(QueryParams.First, first);
+
+        return HelixResultFactory.Create<UnbanRequests>(this.ApiClient, request, endpoint, cancellationToken);
+    }
 }

MiniTwitch.Helix/Models/ModerationCategory.cs

@@ -1,4 +1,5 @@
-using MiniTwitch.Helix.Requests;
+using MiniTwitch.Helix.Enums;
+using MiniTwitch.Helix.Requests;
 using MiniTwitch.Helix.Responses;
 
 namespace MiniTwitch.Helix.Models;
@@ -119,4 +120,12 @@ public Task<HelixResult<ModeratedChannels>> GetModeratedChannels(
         int? first = null,
         CancellationToken cancellationToken = default)
     => _all.GetModeratedChannels(first, cancellationToken);
+
+    public Task<HelixResult<UnbanRequests>> GetUnbanRequests(
+        long broadcasterId,
+        UnbanRequestStatus status,
+        long? userId,
+        int? first,
+        CancellationToken cancellationToken = default)
+    => _all.GetUnbanRequests(broadcasterId, status, userId, first, cancellationToken);
 }

MiniTwitch.Helix/Responses/UnbanRequests.cs

@@ -0,0 +1,33 @@
+using System.Text.Json.Serialization;
+using MiniTwitch.Helix.Enums;
+using MiniTwitch.Helix.Internal.Json;
+using MiniTwitch.Helix.Models;
+
+namespace MiniTwitch.Helix.Responses;
+public class UnbanRequests : PaginableResponse<UnbanRequests.Request>
+{
+    public record Request(
+        string Id,
+        long BroadcasterId,
+        [property: JsonPropertyName("broadcaster_login")]
+        string BroadcasterName,
+        [property: JsonPropertyName("broadcaster_name")]
+        string BroadcasterDisplayName,
+        long ModeratorId,
+        [property: JsonPropertyName("moderator_login")]
+        string ModeratorName,
+        [property: JsonPropertyName("moderator_name")]
+        string ModeratorDisplayName,
+        long UserId,
+        [property: JsonPropertyName("user_login")]
+        string UserName,
+        [property: JsonPropertyName("user_name")]
+        string UserDisplayName,
+        string Text,
+        [property: JsonConverter(typeof(EnumConverter<UnbanRequestStatus>))]
+        UnbanRequestStatus Status,
+        DateTime CreatedAt,
+        DateTime? ResolvedAt,
+        string? ResolutionText
+    );
+}