feat: add new moderation apis (#101)

Author: peterdeme

src/Clients/FlagClient.cs

@@ -35,5 +35,17 @@ public async Task<QueryMessageFlagsResponse> QueryMessageFlags(FlagMessageQueryR
                 HttpMethod.GET,
                 HttpStatusCode.OK,
                 queryParams: request.ToQueryParameters());
+
+        public async Task<QueryFlagReportsResponse> QueryFlagReportsAsync(QueryFlagReportsRequest request)
+            => await ExecuteRequestAsync<QueryFlagReportsResponse>("moderation/reports",
+            HttpMethod.POST,
+            HttpStatusCode.Created,
+            request);
+
+        public async Task<ReviewFlagReportResponse> ReviewFlagReportAsync(string reportId, ReviewFlagReportRequest request)
+            => await ExecuteRequestAsync<ReviewFlagReportResponse>($"moderation/reports/{reportId}",
+                HttpMethod.PATCH,
+                HttpStatusCode.OK,
+                request);
     }
 }

src/Clients/IFlagClient.cs

@@ -32,5 +32,17 @@ public interface IFlagClient
         /// </summary>
         /// <remarks>https://getstream.io/chat/docs/dotnet-csharp/moderation/?language=csharp#query-message-flags</remarks>
         Task<QueryMessageFlagsResponse> QueryMessageFlags(FlagMessageQueryRequest request);
+
+        /// <summary>
+        /// Queries flag reports.
+        /// </summary>
+        /// <remarks>https://getstream.io/chat/docs/dotnet-csharp/moderation/?language=csharp</remarks>
+        Task<QueryFlagReportsResponse> QueryFlagReportsAsync(QueryFlagReportsRequest request);
+
+        /// <summary>
+        /// Sends a flag report review.
+        /// </summary>
+        /// <remarks>https://getstream.io/chat/docs/dotnet-csharp/moderation/?language=csharp</remarks>
+        Task<ReviewFlagReportResponse> ReviewFlagReportAsync(string reportId, ReviewFlagReportRequest request);
     }
 }

src/Models/Moderation.cs

@@ -104,4 +104,75 @@ public List<KeyValuePair<string, string>> ToQueryParameters()
             };
         }
     }
+
+    public class QueryFlagReportsRequest
+    {
+        private const int DefaultOffset = 0;
+        private const int DefaultLimit = 20;
+
+        [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "filter_conditions")]
+        public Dictionary<string, object> FilterConditions { get; set; }
+        public int Limit { get; set; } = DefaultLimit;
+        public int Offset { get; set; } = DefaultOffset;
+    }
+
+    public class FlagReport
+    {
+        public string Id { get; set; }
+        public Message Message { get; set; }
+
+        [JsonProperty("flags_count")]
+        public int FlagsCount { get; set; }
+
+        [JsonProperty("message_user_id")]
+        public string MessageUserId { get; set; }
+
+        [JsonProperty("channel_cid")]
+        public string ChannelCid { get; set; }
+
+        [JsonProperty("created_at")]
+        public DateTimeOffset CreatedAt { get; set; }
+
+        [JsonProperty("updated_at")]
+        public DateTimeOffset UpdatedAt { get; set; }
+    }
+
+    public class QueryFlagReportsResponse : ApiResponse
+    {
+        [JsonProperty("flag_reports")]
+        public List<FlagReport> FlagReports { get; set; }
+    }
+
+    public class ReviewFlagReportRequest
+    {
+        [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "review_result")]
+        public string ReviewResult { get; set; }
+
+        [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "user_id")]
+        public string UserId { get; set; }
+
+        [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "review_details")]
+        public Dictionary<string, object> ReviewDetails { get; set; }
+    }
+
+    public class ExtendedFlagReport : FlagReport
+    {
+        [JsonProperty("review_result")]
+        public string ReviewResult { get; set; }
+
+        [JsonProperty("review_details")]
+        public Dictionary<string, object> ReviewDetails { get; set; }
+
+        [JsonProperty("reviewed_at")]
+        public DateTimeOffset ReviewedAt { get; set; }
+
+        [JsonProperty("reviewed_by")]
+        public User ReviewedBy { get; set; }
+    }
+
+    public class ReviewFlagReportResponse : ApiResponse
+    {
+        [JsonProperty("flag_report")]
+        public ExtendedFlagReport FlagReport { get; set; }
+    }
 }

tests/FlagClientTests.cs

@@ -77,5 +77,28 @@ await WaitForAsync(async () =>
                 return resp.Flags.Count > 0;
             });
         }
+
+        [Test]
+        public async Task TestQueryFlagAndReviewFlagAsync()
+        {
+            await _flagClient.FlagMessageAsync(_message.Id, _chanMember2.Id);
+
+            var queryResp = await _flagClient.QueryFlagReportsAsync(new QueryFlagReportsRequest
+            {
+                FilterConditions = new Dictionary<string, object>
+                {
+                    { "message_id", _message.Id },
+                },
+            });
+            var report = queryResp.FlagReports[0];
+            report.Message.Id.Should().Be(_message.Id);
+
+            var reviewResp = await _flagClient.ReviewFlagReportAsync(report.Id, new ReviewFlagReportRequest
+            {
+                ReviewResult = "reviewed",
+                UserId = _chanMember1.Id,
+            });
+            reviewResp.FlagReport.ReviewResult.Should().Be("reviewed");
+        }
     }
 }