Add support for transferring server ownership

References:

- revoltchat/backend#396
- revoltchat/rfcs#14

Author: MCausc78

pyvolt/http.py

@@ -5865,6 +5865,7 @@ async def edit_server(
         flags: UndefinedOr[ServerFlags] = UNDEFINED,
         discoverable: UndefinedOr[bool] = UNDEFINED,
         analytics: UndefinedOr[bool] = UNDEFINED,
+        owner: UndefinedOr[typing.Union[str, BaseUser, BaseMember]] = UNDEFINED,
     ) -> Server:
         """|coro|
 
@@ -5898,6 +5899,12 @@ async def edit_server(
             The new server flags. You must be a privileged user to provide this.
         analytics: UndefinedOr[:class:`bool`]
             Whether analytics should be collected for this server. Must be enabled in order to show up on `Revolt Discover <https://rvlt.gg>`_.
+        owner: UndefinedOr[Union[:class:`str`, :class:`.BaseUser`, :class:`.BaseMember`]]
+            The member to transfer ownership to.
+
+            You must own the server, or be a privileged user to provide this.
+
+            The target user must be not a bot.
 
         Raises
         ------
@@ -5922,13 +5929,15 @@ async def edit_server(
         :class:`Forbidden`
             Possible values for :attr:`~HTTPException.type`:
 
-            +-----------------------+---------------------------------------------------------------------------------------+
-            | Value                 | Reason                                                                                |
-            +-----------------------+---------------------------------------------------------------------------------------+
-            | ``MissingPermission`` | You do not have the proper permissions to edit server details.                        |
-            +-----------------------+---------------------------------------------------------------------------------------+
-            | ``NotPrivileged``     | You provided ``discoverable`` or ``flags`` parameters and you wasn't privileged user. |
-            +-----------------------+---------------------------------------------------------------------------------------+
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | Value                 | Reason                                                                                    |
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | ``MissingPermission`` | You do not have the proper permissions to edit server details.                            |
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | ``NotOwner``          | You provided ``owner`` parameter and you didn't own the server or wasn't privileged user. |
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | ``NotPrivileged``     | You provided ``discoverable`` or ``flags`` parameters and you wasn't privileged user.     |
+            +-----------------------+-------------------------------------------------------------------------------------------+
         :class:`NotFound`
             Possible values for :attr:`~HTTPException.type`:
 
@@ -5999,6 +6008,9 @@ async def edit_server(
         if analytics is not UNDEFINED:
             payload['analytics'] = analytics
 
+        if owner is not UNDEFINED:
+            payload['owner'] = _resolve_member_id(owner)
+
         if len(remove) > 0:
             payload['remove'] = remove
 

pyvolt/raw/servers.py

@@ -122,6 +122,7 @@ class DataEditServer(typing.TypedDict):
     flags: typing_extensions.NotRequired[int]
     discoverable: typing_extensions.NotRequired[bool]
     analytics: typing_extensions.NotRequired[bool]
+    owner: typing_extensions.NotRequired[str]
     remove: typing_extensions.NotRequired[list[FieldsServer]]
 
 

pyvolt/server.py

@@ -1200,6 +1200,7 @@ async def edit(
         flags: UndefinedOr[ServerFlags] = UNDEFINED,
         discoverable: UndefinedOr[bool] = UNDEFINED,
         analytics: UndefinedOr[bool] = UNDEFINED,
+        owner: UndefinedOr[typing.Union[str, BaseUser, BaseMember]] = UNDEFINED,
     ) -> Server:
         """|coro|
 
@@ -1233,6 +1234,12 @@ async def edit(
             The new server flags. You must be a privileged user to provide this.
         analytics: UndefinedOr[:class:`bool`]
             Whether analytics should be collected for this server. Must be enabled in order to show up on `Revolt Discover <https://rvlt.gg>`_.
+        owner: UndefinedOr[Union[:class:`str`, :class:`.BaseUser`, :class:`.BaseMember`]]
+            The member to transfer ownership to.
+
+            You must own the server, or be a privileged user to provide this.
+
+            The target user must be not a bot.
 
         Raises
         ------
@@ -1257,13 +1264,15 @@ async def edit(
         :class:`Forbidden`
             Possible values for :attr:`~HTTPException.type`:
 
-            +-----------------------+---------------------------------------------------------------------------------------+
-            | Value                 | Reason                                                                                |
-            +-----------------------+---------------------------------------------------------------------------------------+
-            | ``MissingPermission`` | You do not have the proper permissions to edit server details.                        |
-            +-----------------------+---------------------------------------------------------------------------------------+
-            | ``NotPrivileged``     | You provided ``discoverable`` or ``flags`` parameters and you wasn't privileged user. |
-            +-----------------------+---------------------------------------------------------------------------------------+
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | Value                 | Reason                                                                                    |
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | ``MissingPermission`` | You do not have the proper permissions to edit server details.                            |
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | ``NotOwner``          | You provided ``owner`` parameter and you didn't own the server or wasn't privileged user. |
+            +-----------------------+-------------------------------------------------------------------------------------------+
+            | ``NotPrivileged``     | You provided ``discoverable`` or ``flags`` parameters and you wasn't privileged user.     |
+            +-----------------------+-------------------------------------------------------------------------------------------+
         :class:`NotFound`
             Possible values for :attr:`~HTTPException.type`:
 
@@ -1300,6 +1309,7 @@ async def edit(
             flags=flags,
             discoverable=discoverable,
             analytics=analytics,
+            owner=owner,
         )
 
     async def fetch(