From 7d29c6ac3c0ed7bb25e1668091fdfec5fbeca9ea Mon Sep 17 00:00:00 2001
From: Mahsaap <mahsaaptwitch@gmail.com>
Date: Thu, 20 Jun 2024 22:19:15 -0300
Subject: [PATCH 1/2] Add WarnChatUser Endpoint

---
 .../Request/WarnChatUserRequest.cs            | 22 +++++++++
 .../WarnChatUser/WarnChatUserResponse.cs      | 16 +++++++
 .../Moderation/WarnChatUser/WarnedChatUser.cs | 34 +++++++++++++
 TwitchLib.Api.Helix/Moderation.cs             | 48 +++++++++++++++++++
 4 files changed, 120 insertions(+)
 create mode 100644 TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs
 create mode 100644 TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnChatUserResponse.cs
 create mode 100644 TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnedChatUser.cs

diff --git a/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs
new file mode 100644
index 00000000..4a167fc2
--- /dev/null
+++ b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs
@@ -0,0 +1,22 @@
+using Newtonsoft.Json;
+
+namespace TwitchLib.Api.Helix.Models.Moderation.WarnChatUser.Request;
+
+/// <summary>
+/// Request that contains information about the warning.
+/// </summary>
+public class WarnChatUserRequest
+{
+    /// <summary>
+    ///  The ID of the twitch user to be warned.
+    /// </summary>
+    [JsonProperty(PropertyName = "user_id")]
+    public string UserId { get; set; }
+
+    /// <summary>
+    /// A custom reason for the warning. Max 500 chars.
+    /// </summary>
+    [JsonProperty(PropertyName = "reason")]
+    public string Reason { get; set; } = string.Empty;
+}
+}
diff --git a/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnChatUserResponse.cs b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnChatUserResponse.cs
new file mode 100644
index 00000000..8d19341b
--- /dev/null
+++ b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnChatUserResponse.cs
@@ -0,0 +1,16 @@
+using Newtonsoft.Json;
+
+namespace TwitchLib.Api.Helix.Models.Moderation.WarnChatUser;
+
+/// <summary>
+/// Warn chat user response object.
+/// </summary>
+public class WarnChatUserResponse
+{
+    /// <summary>
+    /// A list that contains information about the warning.
+    /// </summary>
+    [JsonProperty(PropertyName = "data")]
+    public WarnedChatUser[] Data { get; protected set; }
+}
+
diff --git a/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnedChatUser.cs b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnedChatUser.cs
new file mode 100644
index 00000000..16e5574d
--- /dev/null
+++ b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/WarnedChatUser.cs
@@ -0,0 +1,34 @@
+using Newtonsoft.Json;
+
+namespace TwitchLib.Api.Helix.Models.Moderation.WarnChatUser;
+
+/// <summary>
+/// Contains information about the warning.
+/// </summary>
+public class WarnedChatUser
+{
+    /// <summary>
+    /// The ID of the channel in which the warning will take effect.
+    /// </summary>
+    [JsonProperty(PropertyName = "broadcaster_id")]
+    public string BroadcasterId { get; protected set; }
+
+    /// <summary>
+    /// The ID of the warned user.
+    /// </summary>
+    [JsonProperty(PropertyName = "user_id")]
+    public string UserId { get; protected set; }
+
+    /// <summary>
+    /// The ID of the user who applied the warning.
+    /// </summary>
+    [JsonProperty(PropertyName = "moderator_id")]
+    public string ModeratorId { get; protected set; }
+
+    /// <summary>
+    /// The reason provided for warning.
+    /// </summary>
+    [JsonProperty(PropertyName = "reason")]
+    public string Reason { get; protected set; }
+}
+
diff --git a/TwitchLib.Api.Helix/Moderation.cs b/TwitchLib.Api.Helix/Moderation.cs
index a629c6a2..4c96c7c2 100644
--- a/TwitchLib.Api.Helix/Moderation.cs
+++ b/TwitchLib.Api.Helix/Moderation.cs
@@ -26,6 +26,8 @@
 using TwitchLib.Api.Helix.Models.Moderation.UnbanRequests;
 using TwitchLib.Api.Helix.Models.Moderation.UnbanRequests.GetUnbanRequests;
 using TwitchLib.Api.Helix.Models.Moderation.UnbanRequests.ResolveUnbanRequests;
+using TwitchLib.Api.Helix.Models.Moderation.WarnChatUser;
+using TwitchLib.Api.Helix.Models.Moderation.WarnChatUser.Request;
 
 namespace TwitchLib.Api.Helix
 {
@@ -810,5 +812,51 @@ public Task<GetModeratedChannelsResponse> GetModeratedChannelsAsync(string userI
         }
 
         #endregion
+
+        #region WarnChatUser
+        /// <summary>
+        /// Warns a user in the specified broadcaster’s chat room, preventing them from chat interaction until the warning is acknowledged.
+        /// <para>New warnings can be issued to a user when they already have a warning in the channel (new warning will replace old warning).</para>
+        /// <para>Requires a user access token that includes the moderator:manage:warnings scope.</para>
+        /// <para>Query parameter moderator_id must match the user_id in the user access token.</para>
+        /// </summary>
+        /// <param name="broadcasterId">The ID of the channel in which the warning will take effect.</param>
+        /// <param name="moderatorId">The ID of the twitch user who requested the warning.</param>
+        /// <param name="warnChatUserRequest">request object contains information about the warning.</param>
+        /// <param name="accessToken">optional access token to override the one used while creating the TwitchAPI object</param>
+        /// <returns cref="WarnChatUserResponse"></returns>
+        /// <exception cref="BadParameterException"></exception>
+        public Task<WarnChatUserResponse> WarnChatUserAsync(string broadcasterId, string moderatorId, WarnChatUserRequest warnChatUserRequest, string accessToken = null)
+        {
+            if (string.IsNullOrEmpty(broadcasterId))
+                throw new BadParameterException("broadcasterId must be set");
+
+            if (string.IsNullOrEmpty(moderatorId))
+                throw new BadParameterException("moderatorId must be set");
+
+            if (warnChatUserRequest == null)
+                throw new BadParameterException("warnChatUserRequest cannot be null");
+
+            if (string.IsNullOrWhiteSpace(warnChatUserRequest.UserId))
+                throw new BadParameterException("warnChatUserRequest.UserId must be set");
+
+            if (warnChatUserRequest.Reason.Length > 500)
+                throw new BadParameterException("warnChatUserRequest.Reason can't be greater then 500 characters.");
+
+            var getParams = new List<KeyValuePair<string, string>>
+            {
+                new KeyValuePair<string, string>("broadcaster_id", broadcasterId),
+                new KeyValuePair<string, string>("moderator_id", moderatorId)
+            };
+
+            var body = new
+            {
+                data = warnChatUserRequest
+            };
+
+            return TwitchPostGenericAsync<WarnChatUserResponse>("/moderation/warnings", ApiVersion.Helix, JsonConvert.SerializeObject(body), getParams, accessToken);
+        }
+
+        #endregion
     }
 }

From 8ce7155c7c02649f4c6771140d0a105466dcdf64 Mon Sep 17 00:00:00 2001
From: Mahsaap <mahsaaptwitch@gmail.com>
Date: Thu, 20 Jun 2024 22:21:45 -0300
Subject: [PATCH 2/2] Fix typo (bracket)

---
 .../Moderation/WarnChatUser/Request/WarnChatUserRequest.cs     | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs
index 4a167fc2..977d439c 100644
--- a/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs
+++ b/TwitchLib.Api.Helix.Models/Moderation/WarnChatUser/Request/WarnChatUserRequest.cs
@@ -18,5 +18,4 @@ public class WarnChatUserRequest
     /// </summary>
     [JsonProperty(PropertyName = "reason")]
     public string Reason { get; set; } = string.Empty;
-}
-}
+}
\ No newline at end of file