feat: update monetization

CHANGELOG.md

@@ -22,6 +22,8 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#2418](https://github.com/Pycord-Development/pycord/pull/2418))
 - Added `member` data to the `raw_reaction_remove` event.
   ([#2412](https://github.com/Pycord-Development/pycord/pull/2412))
+- Added support for one-time purchases for Discord monetization.
+  ([#2438](https://github.com/Pycord-Development/pycord/pull/2438))
 
 ### Fixed
 
@@ -42,6 +44,8 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#2411](https://github.com/Pycord-Development/pycord/pull/2411))
 - Fixed option typehints being ignored when using `parameter_name`.
   ([#2417](https://github.com/Pycord-Development/pycord/pull/2417))
+- Fixed `Entitlement.delete` not passing all needed parameters to its HTTP method.
+  ([#2438](https://github.com/Pycord-Development/pycord/pull/2438))
 
 ### Changed
 

discord/enums.py

@@ -1003,13 +1003,22 @@ class ReactionType(Enum):
 class SKUType(Enum):
     """The SKU type"""
 
+    durable = 2
+    consumable = 3
     subscription = 5
     subscription_group = 6
 
 
 class EntitlementType(Enum):
     """The entitlement type"""
 
+    purchase = 1
+    premium_subscription = 2
+    developer_gift = 3
+    test_mode_purchase = 4
+    free_purchase = 5
+    user_gift = 6
+    premium_purchase = 7
     application_subscription = 8
 
 

discord/http.py

@@ -2936,13 +2936,50 @@ def list_skus(
     def list_entitlements(
         self,
         application_id: Snowflake,
+        *,
+        user_id: Snowflake | None = None,
+        sku_ids: list[Snowflake] | None = None,
+        before: Snowflake | None = None,
+        after: Snowflake | None = None,
+        limit: int | None = None,
+        guild_id: Snowflake | None = None,
+        exclude_ended: bool | None = None,
     ) -> Response[list[monetization.Entitlement]]:
+        params: dict[str, Any] = {}
+        if user_id is not None:
+            params["user_id"] = user_id
+        if sku_ids is not None:
+            params["sku_ids"] = ",".join(sku_ids)
+        if before is not None:
+            params["before"] = before
+        if after is not None:
+            params["after"] = after
+        if limit is not None:
+            params["limit"] = limit
+        if guild_id is not None:
+            params["guild_id"] = guild_id
+        if exclude_ended is not None:
+            params["exclude_ended"] = exclude_ended
+
         r = Route(
             "GET",
             "/applications/{application_id}/entitlements",
             application_id=application_id,
         )
-        return self.request(r)
+        return self.request(r, params=params)
+
+    def consume_entitlement(
+        self,
+        application_id: Snowflake,
+        entitlement_id: Snowflake,
+    ) -> Response[None]:
+        r = Route(
+            "POST",
+            "/applications/{application_id}/entitlements/{entitlement_id}/consume",
+            application_id=application_id,
+            entitlement_id=entitlement_id,
+        )
+        return self.request(r, json=payload)
 
     def create_test_entitlement(
         self,

discord/monetization.py

@@ -122,6 +122,10 @@ class Entitlement(Hashable):
         When the entitlement expires.
     guild_id: Union[:class:`int`, :class:`MISSING`]
         The ID of the guild that owns this entitlement.
+    consumed: :class:`bool`
+        Whether or not this entitlement has been consumed.
+        This will always be ``False`` for entitlements that are not
+        of type :attr:`EntitlementType.consumable`.
     """
 
     __slots__ = (
@@ -135,6 +139,7 @@ class Entitlement(Hashable):
         "starts_at",
         "ends_at",
         "guild_id",
+        "consumed",
     )
 
     def __init__(self, *, data: EntitlementPayload, state: ConnectionState) -> None:
@@ -150,17 +155,36 @@ def __init__(self, *, data: EntitlementPayload, state: ConnectionState) -> None:
         )
         self.ends_at: datetime | MISSING = parse_time(data.get("ends_at")) or MISSING
         self.guild_id: int | MISSING = _get_as_snowflake(data, "guild_id") or MISSING
+        self.consumed: bool = data.get("consumed", False)
 
     def __repr__(self) -> str:
         return (
             f"<Entitlement id={self.id} sku_id={self.sku_id} application_id={self.application_id} "
             f"user_id={self.user_id} type={self.type} deleted={self.deleted} "
-            f"starts_at={self.starts_at} ends_at={self.ends_at} guild_id={self.guild_id}>"
+            f"starts_at={self.starts_at} ends_at={self.ends_at} guild_id={self.guild_id} consumed={self.consumed}>"
         )
 
     def __eq__(self, other: object) -> bool:
         return isinstance(other, self.__class__) and other.id == self.id
 
+    async def consume(self) -> None:
+        """|coro|
+
+        Consumes this entitlement.
+
+        This can only be done on entitlements of type :attr:`EntitlementType.consumable`.
+
+        Raises
+        ------
+        TypeError
+            The entitlement is not consumable.
+        HTTPException
+            Consuming the entitlement failed.
+        """
+        if self.type is not EntitlementType.consumable:
+            raise TypeError("Cannot consume non-consumable entitlement")
+        await self._state.http.consume_entitlement(self._state.application_id, self.id)
+
     async def delete(self) -> None:
         """|coro|
 
@@ -173,4 +197,6 @@ async def delete(self) -> None:
         HTTPException
             Deleting the entitlement failed.
         """
-        await self._state.http.delete_test_entitlement(self.id)
+        await self._state.http.delete_test_entitlement(
+            self._state.application_id, self.id
+        )

docs/api/enums.rst

@@ -2369,6 +2369,14 @@ of :class:`enum.Enum`.
 
     .. versionadded:: 2.5
 
+    .. attribute:: durable
+
+        Represents a durable one-time purchase.
+
+    .. attribute:: consumable
+
+        Represents a consumable one-time purchase.
+
     .. attribute:: subscription
 
         Represents a recurring subscription.
@@ -2384,7 +2392,35 @@ of :class:`enum.Enum`.
 
     .. versionadded:: 2.5
 
-    .. attribute:: app_subscription
+    .. attribute:: purchase
+
+        Entitlement was purchased by the user.
+
+    .. attribute:: premium_subscription
+
+        Entitlement is for a Discord Nitro subscription.
+
+    .. attribute:: developer_gift
+
+        Entitlement was gifted by the developer.
+
+    .. attribute:: test_mode_purchase
+
+        Entitlement was purchased by a developer in the application's test mode.
+
+    .. attribute:: free_purchase
+
+        Entitlement was granted when the SKU was free.
+
+    .. attribute:: user_gift
+
+        Entitlement was gifted by another user.
+
+    .. attribute:: premium_purchase
+
+        Entitlement was claimed by a user for free as a Nitro subscriber.
+
+    .. attribute:: application_subscription
 
         Entitlement was purchased as an app subscription.