Update entitlement endpoints.

See discord/discord-api-docs#7279.

Author: Nihlus

Backend/Remora.Discord.API.Abstractions/API/Rest/IDiscordRestMonetizationAPI.cs

@@ -47,6 +47,7 @@ public interface IDiscordRestMonetizationAPI
     /// <param name="limit">The maximum number of entitlements to return (1-100). Defaults to 100.</param>
     /// <param name="guildID">The ID of the guild to limit the search to.</param>
     /// <param name="excludeEnded">Whether to exclude expired entitlements.</param>
+    /// <param name="excludeDeleted">Whether to exclude deleted entitlements.</param>
     /// <param name="ct">The cancellation token for this operation.</param>
     /// <returns>The entitlements.</returns>
     Task<Result<IReadOnlyList<IEntitlement>>> ListEntitlementsAsync
@@ -59,6 +60,21 @@ Task<Result<IReadOnlyList<IEntitlement>>> ListEntitlementsAsync
         Optional<int> limit = default,
         Optional<Snowflake> guildID = default,
         Optional<bool> excludeEnded = default,
+        Optional<bool> excludeDeleted = default,
+        CancellationToken ct = default
+    );
+
+    /// <summary>
+    /// Gets information about an entitlement.
+    /// </summary>
+    /// <param name="applicationID">The ID of the application.</param>
+    /// <param name="entitlementID">The ID of the entitlement.</param>
+    /// <param name="ct">The cancellation token for this operation.</param>
+    /// <returns>The entitlement.</returns>
+    Task<Result<IEntitlement>> GetEntitlementAsync
+    (
+        Snowflake applicationID,
+        Snowflake entitlementID,
         CancellationToken ct = default
     );
 

Backend/Remora.Discord.Rest/API/Monetization/DiscordRestMonetizationAPI.cs

@@ -68,6 +68,7 @@ public Task<Result<IReadOnlyList<IEntitlement>>> ListEntitlementsAsync
         Optional<int> limit = default,
         Optional<Snowflake> guildID = default,
         Optional<bool> excludeEnded = default,
+        Optional<bool> excludeDeleted = default,
         CancellationToken ct = default
     ) => this.RestHttpClient.GetAsync<IReadOnlyList<IEntitlement>>
     (
@@ -80,10 +81,24 @@ public Task<Result<IReadOnlyList<IEntitlement>>> ListEntitlementsAsync
             .AddQueryParameter("limit", limit)
             .AddQueryParameter("guild_id", guildID)
             .AddQueryParameter("exclude_ended", excludeEnded)
+            .AddQueryParameter("exclude_deleted", excludeDeleted)
             .WithRateLimitContext(this.RateLimitCache),
         ct: ct
     );
 
+    /// <inheritdoc />
+    public Task<Result<IEntitlement>> GetEntitlementAsync
+    (
+        Snowflake applicationID,
+        Snowflake entitlementID,
+        CancellationToken ct = default
+    ) => this.RestHttpClient.GetAsync<IEntitlement>
+    (
+        $"applications/{applicationID}/entitlements/{entitlementID}",
+        b => b.WithRateLimitContext(this.RateLimitCache),
+        ct: ct
+    );
+
     /// <inheritdoc />
     public Task<Result> ConsumeEntitlementAsync
     (

Tests/Remora.Discord.Rest.Tests/API/Monetization/DiscordRestMonetizationAPITests.cs

@@ -72,23 +72,24 @@ public async Task PerformsRequestCorrectly()
             var limit = 1;
             var guildID = DiscordSnowflake.New(7);
             var excludeEnded = true;
+            var excludeDeleted = true;
 
             var api = CreateAPI
             (
                 b => b
                     .Expect(HttpMethod.Get, $"{Constants.BaseURL}applications/{applicationID}/entitlements")
                     .WithExactQueryString
                     (
-                        new KeyValuePair<string, string>[]
-                        {
+                        [
                             new("user_id", userID.ToString()),
                             new("sku_ids", string.Join(',', skuIDs.Select(id => id.ToString()))),
                             new("before", before.ToString()),
                             new("after", after.ToString()),
                             new("limit", limit.ToString()),
                             new("guild_id", guildID.ToString()),
-                            new("exclude_ended", excludeEnded.ToString())
-                        }
+                            new("exclude_ended", excludeEnded.ToString()),
+                            new("exclude_deleted", excludeDeleted.ToString())
+                        ]
                     )
                     .Respond("application/json", "[ ]")
             );
@@ -102,7 +103,49 @@ public async Task PerformsRequestCorrectly()
                 after,
                 limit,
                 guildID,
-                excludeEnded
+                excludeEnded,
+                excludeDeleted
+            );
+
+            ResultAssert.Successful(result);
+        }
+    }
+
+    /// <summary>
+    /// Tests the <see cref="DiscordRestMonetizationAPI.GetEntitlementAsync"/> method.
+    /// </summary>
+    public class GetEntitlementAsync : RestAPITestBase<IDiscordRestMonetizationAPI>
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="GetEntitlementAsync"/> class.
+        /// </summary>
+        /// <param name="fixture">The test fixture.</param>
+        public GetEntitlementAsync(RestAPITestFixture fixture)
+            : base(fixture)
+        {
+        }
+
+        /// <summary>
+        /// Tests whether the API method performs its request correctly.
+        /// </summary>
+        /// <returns>A <see cref="Task"/> representing the result of the asynchronous operation.</returns>
+        [Fact]
+        public async Task PerformsRequestCorrectly()
+        {
+            var applicationID = DiscordSnowflake.New(1);
+            var entitlementID = DiscordSnowflake.New(2);
+
+            var api = CreateAPI
+            (
+                b => b
+                    .Expect(HttpMethod.Get, $"{Constants.BaseURL}applications/{applicationID}/entitlements/{entitlementID}")
+                    .Respond("application/json", SampleRepository.Samples[typeof(IEntitlement)])
+            );
+
+            var result = await api.GetEntitlementAsync
+            (
+                applicationID,
+                entitlementID
             );
 
             ResultAssert.Successful(result);