more cringe (#2919)

src/Discord.Net.Core/Entities/AppSubscriptions/EntitlementType.cs

@@ -1,7 +1,45 @@
 namespace Discord;
 
+/// <summary>
+///     Represents the type of entitlement.
+/// </summary>
 public enum EntitlementType
 {
+    /// <summary>
+    ///     The entitlement was purchased by user.
+    /// </summary>
+    Purchase = 1,
+
+    /// <summary>
+    ///     Entitlement for Discord Nitro subscription.
+    /// </summary>
+    PremiumSubscription = 2,
+
+    /// <summary>
+    ///     Entitlement was gifted by developer.
+    /// </summary>
+    DeveloperGift = 3,
+
+    /// <summary>
+    ///     Entitlement was purchased by a dev in application test mode.
+    /// </summary>
+    TestModePurchase = 4,
+
+    /// <summary>
+    ///     Entitlement was granted when the SKU was free.
+    /// </summary>
+    FreePurchase = 5,
+
+    /// <summary>
+    ///     Entitlement was gifted by another user.
+    /// </summary>
+    UserGift = 6,
+
+    /// <summary>
+    ///     Entitlement was claimed by user for free as a Nitro Subscriber.
+    /// </summary>
+    PremiumPurchase = 7,
+
     /// <summary>
     ///     The entitlement was purchased as an app subscription.
     /// </summary>

src/Discord.Net.Core/Entities/AppSubscriptions/SKUFlags.cs

@@ -2,10 +2,19 @@
 
 namespace Discord;
 
+/// <summary>
+///     SKU flags for subscriptions.
+/// </summary>
 [Flags]
 public enum SKUFlags
 {
+    /// <summary>
+    ///     The SKU is a guild subscription.
+    /// </summary>
     GuildSubscription = 1 << 7,
 
+    /// <summary>
+    ///     The SKU is a user subscription.
+    /// </summary>
     UserSubscription = 1 << 8
 }

src/Discord.Net.Core/Entities/AppSubscriptions/SKUType.cs

@@ -2,13 +2,23 @@ namespace Discord;
 
 public enum SKUType
 {
+    /// <summary>
+    ///     Durable one-time purchase.
+    /// </summary>
+    Durable = 2,
+
+    /// <summary>
+    ///     Consumable one-time purchase.
+    /// </summary>
+    Consumable = 3,
+
     /// <summary>
     ///     Represents a recurring subscription.
     /// </summary>
     Subscription = 5,
 
     /// <summary>
-    ///     System-generated group for each <see cref="SKUType.Subscription"/> SKU created.
+    ///     System-generated group for each <see cref="Subscription"/> SKU created.
     /// </summary>
     SubscriptionGroup = 6,
 }

src/Discord.Net.Core/IDiscordClient.cs

@@ -349,5 +349,12 @@ public interface IDiscordClient : IDisposable, IAsyncDisposable
         ///     Returns all SKUs for a given application. 
         /// </summary>
         Task<IReadOnlyCollection<SKU>> GetSKUsAsync(RequestOptions options = null);
+
+        /// <summary>
+        ///     Marks a given one-time purchase entitlement for the user as consumed.
+        /// </summary>
+        /// <param name="entitlementId">The id of the entitlement.</param>
+        /// <param name="options">The options to be used when sending the request.</param>
+        Task ConsumeEntitlementAsync(ulong entitlementId, RequestOptions options = null);
     }
 }

src/Discord.Net.Rest/API/Common/Entitlement.cs

@@ -24,7 +24,7 @@ internal class Entitlement
     public EntitlementType Type { get; set; }
 
     [JsonProperty("consumed")]
-    public bool IsConsumed { get; set; }
+    public Optional<bool> IsConsumed { get; set; }
 
     [JsonProperty("starts_at")]
     public Optional<DateTimeOffset> StartsAt { get; set; }

src/Discord.Net.Rest/BaseDiscordClient.cs

@@ -292,6 +292,11 @@ Task IDiscordClient.DeleteTestEntitlementAsync(ulong entitlementId, RequestOptio
         /// </summary>
         Task<IReadOnlyCollection<SKU>> IDiscordClient.GetSKUsAsync(RequestOptions options) => Task.FromResult<IReadOnlyCollection<SKU>>(Array.Empty<SKU>());
 
+        /// <summary>
+        ///     Marks a given one-time purchase entitlement for the user as consumed.
+        /// </summary>
+        Task IDiscordClient.ConsumeEntitlementAsync(ulong entitlementId, RequestOptions options) => Task.CompletedTask;
+
         #endregion
     }
 }

src/Discord.Net.Rest/ClientHelper.cs

@@ -446,6 +446,9 @@ public static async Task<IReadOnlyCollection<SKU>> ListSKUsAsync(BaseDiscordClie
             return models.Select(x => new SKU(x.Id, x.Type, x.ApplicationId, x.Name, x.Slug)).ToImmutableArray();
         }
 
+        public static Task ConsumeEntitlementAsync(BaseDiscordClient client, ulong entitlementId, RequestOptions options = null)
+            => client.ApiClient.ConsumeEntitlementAsync(entitlementId, options);
+
         #endregion
     }
 }

src/Discord.Net.Rest/DiscordRestApiClient.cs

@@ -2828,6 +2828,9 @@ public Task<Entitlement[]> ListEntitlementAsync(ListEntitlementsParams args, Req
         public Task<SKU[]> ListSKUsAsync(RequestOptions options = null)
             => SendAsync<SKU[]>("GET", () => $"applications/{CurrentApplicationId}/skus", new BucketIds(), options: options);
 
+        public Task ConsumeEntitlementAsync(ulong entitlementId, RequestOptions options = null)
+            => SendAsync("POST", () => $"applications/{CurrentApplicationId}/entitlements/{entitlementId}/consume", new BucketIds(), options: options);
+
         #endregion
     }
 }

src/Discord.Net.Rest/DiscordRestClient.cs

@@ -296,6 +296,10 @@ public Task DeleteTestEntitlementAsync(ulong entitlementId, RequestOptions optio
         public Task<IReadOnlyCollection<SKU>> GetSKUsAsync(RequestOptions options = null)
             => ClientHelper.ListSKUsAsync(this, options);
 
+        /// <inheritdoc />
+        public Task ConsumeEntitlementAsync(ulong entitlementId, RequestOptions options = null)
+            => ClientHelper.ConsumeEntitlementAsync(this, entitlementId, options);
+
         #endregion
 
         #region IDiscordClient

src/Discord.Net.Rest/Entities/AppSubscriptions/RestEntitlement.cs

@@ -55,7 +55,7 @@ internal void Update(Model model)
             : null;
         ApplicationId = model.ApplicationId;
         Type = model.Type;
-        IsConsumed = model.IsConsumed;
+        IsConsumed = model.IsConsumed.GetValueOrDefault(false);
         StartsAt = model.StartsAt.IsSpecified
             ? model.StartsAt.Value
             : null;

src/Discord.Net.WebSocket/DiscordSocketClient.cs

@@ -447,6 +447,10 @@ public Task DeleteTestEntitlementAsync(ulong entitlementId, RequestOptions optio
         public Task<IReadOnlyCollection<SKU>> GetSKUsAsync(RequestOptions options = null)
             => ClientHelper.ListSKUsAsync(this, options);
 
+        /// <inheritdoc />
+        public Task ConsumeEntitlementAsync(ulong entitlementId, RequestOptions options = null)
+            => ClientHelper.ConsumeEntitlementAsync(this, entitlementId, options);
+
         /// <summary>
         ///     Gets entitlements from cache.
         /// </summary>

src/Discord.Net.WebSocket/Entities/AppSubscriptions/SocketEntitlement.cs

@@ -67,7 +67,7 @@ internal void Update(Model model)
 
         ApplicationId = model.ApplicationId;
         Type = model.Type;
-        IsConsumed = model.IsConsumed;
+        IsConsumed = model.IsConsumed.GetValueOrDefault(false);
         StartsAt = model.StartsAt.IsSpecified
             ? model.StartsAt.Value
             : null;