Add entitlement gateway events

src/client/dispatch.rs

@@ -517,6 +517,18 @@ fn update_cache_with_event(ctx: Context, event: Event) -> Option<(FullEvent, Opt
             ctx,
             unsubscribed: event,
         },
+        Event::EntitlementCreate(event) => FullEvent::EntitlementCreate {
+            ctx,
+            entitlement: event.entitlement,
+        },
+        Event::EntitlementUpdate(event) => FullEvent::EntitlementUpdate {
+            ctx,
+            entitlement: event.entitlement,
+        },
+        Event::EntitlementDelete(event) => FullEvent::EntitlementDelete {
+            ctx,
+            entitlement: event.entitlement,
+        },
     };
 
     Some((event, extra_event))

src/client/event_handler.rs

@@ -439,6 +439,27 @@ event_handler! {
     /// Provides data about the cancelled subscription.
     async fn guild_scheduled_event_user_remove(&self, GuildScheduledEventUserRemove { ctx: Context, unsubscribed: GuildScheduledEventUserRemoveEvent });
 
+    /// Dispatched when a user subscribes to a SKU.
+    ///
+    /// Provides data about the subscription.
+    async fn entitlement_create(&self, EntitlementCreate { ctx: Context, entitlement: Entitlement });
+
+    /// Dispatched when a user's subscription to a SKU renews for the next billing period.
+    ///
+    /// Provides data abut the updated subscription. Specifically, the [`Entitlement::ends_at`]
+    /// field will have changed.
+    async fn entitlement_update(&self, EntitlementUpdate { ctx: Context, entitlement: Entitlement });
+
+    /// Dispatched when a user's entitlement has been deleted. This happens rarely, but can occur
+    /// if a subscription is refunded or otherwise deleted by Discord.
+    ///
+    /// Provides data about the subscription. Specifically, the [`Entitlement::deleted`] field will
+    /// be set.
+    ///
+    /// Note that expired subscriptions do not result in deletion of their corresponding
+    /// [`Entitlement`] and will not trigger this event upon expiring.
+    async fn entitlement_delete(&self, EntitlementDelete { ctx: Context, entitlement: Entitlement });
+
     /// Dispatched when an HTTP rate limit is hit
     async fn ratelimit(&self, Ratelimit { data: RatelimitInfo });
 }

src/model/event.rs

@@ -952,6 +952,36 @@ pub struct GuildScheduledEventUserRemoveEvent {
     pub guild_id: GuildId,
 }
 
+/// Requires no gateway intents.
+///
+/// [Discord docs](https://discord.com/developers/docs/monetization/entitlements#new-entitlement)
+#[derive(Clone, Debug, Deserialize, Serialize)]
+#[serde(transparent)]
+#[non_exhaustive]
+pub struct EntitlementCreateEvent {
+    pub entitlement: Entitlement,
+}
+
+/// Requires no gateway intents.
+///
+/// [Discord docs](https://discord.com/developers/docs/monetization/entitlements#new-entitlement)
+#[derive(Clone, Debug, Deserialize, Serialize)]
+#[serde(transparent)]
+#[non_exhaustive]
+pub struct EntitlementUpdateEvent {
+    pub entitlement: Entitlement,
+}
+
+/// Requires no gateway intents.
+///
+/// [Discord docs](https://discord.com/developers/docs/monetization/entitlements#new-entitlement)
+#[derive(Clone, Debug, Deserialize, Serialize)]
+#[serde(transparent)]
+#[non_exhaustive]
+pub struct EntitlementDeleteEvent {
+    pub entitlement: Entitlement,
+}
+
 /// [Discord docs](https://discord.com/developers/docs/topics/gateway-events#payload-structure).
 #[allow(clippy::large_enum_variant)]
 #[derive(Debug, Clone, Serialize)]
@@ -1188,6 +1218,12 @@ pub enum Event {
     GuildScheduledEventUserAdd(GuildScheduledEventUserAddEvent),
     /// A guild member has unsubscribed from a scheduled event.
     GuildScheduledEventUserRemove(GuildScheduledEventUserRemoveEvent),
+    /// A user subscribed to a SKU.
+    EntitlementCreate(EntitlementCreateEvent),
+    /// A user's subscription to a SKU renewed for the next billing period.
+    EntitlementUpdate(EntitlementUpdateEvent),
+    /// A user's entitlement was deleted by Discord, or refunded.
+    EntitlementDelete(EntitlementDeleteEvent),
     /// An event type not covered by the above
     #[serde(other, deserialize_with = "ignore_input")]
     Unknown,