add follows v2, deprecate follows v1

Author: IAmTomahawkx

docs/changelog.rst

@@ -34,6 +34,11 @@ Master
         - Added Shoutout events
             - :func:`~twitchio.ext.eventsub.EventSubClient.subscribe_channel_shoutout_create`
             - :func:`~twitchio.ext.eventsub.EventSubClient.subscribe_channel_shoutout_receive`
+        - Added :func:`~twitchio.ext.eventsub.EventSubClient.subscribe_channel_follows_v2`
+
+    - Deprecations
+        - :func:`~twitchio.ext.eventsub.EventSubClient.subscribe_channel_follows`, use :func:`~twitchio.ext.eventsub.EventSubClient.subscribe_channel_follows_v2`
+
 
 - ext.pubsub
     - Bug fixes

docs/exts/eventsub.rst

@@ -64,7 +64,7 @@ Running Eventsub Inside a Commands Bot
             self.loop.create_task(esclient.listen(port=4000))
 
             try:
-                await esclient.subscribe_channel_follows(broadcaster=channel_ID)
+                await esclient.subscribe_channel_follows_v2(broadcaster=some_channel_ID, moderator=a_channel_mod_ID)
             except twitchio.HTTPException:
                 pass
 

twitchio/ext/eventsub/models.py

@@ -1476,6 +1476,7 @@ class _SubscriptionTypes(metaclass=_SubTypesMeta):
     _name_map: Dict[str, str]
 
     follow = "channel.follow", 1, ChannelFollowData
+    followV2 = "channel.follow", 2, ChannelFollowData
     subscription = "channel.subscribe", 1, ChannelSubscribeData
     subscription_end = "channel.subscription.end", 1, ChannelSubscriptionEndData
     subscription_gift = "channel.subscription.gift", 1, ChannelSubscriptionGiftData

twitchio/ext/eventsub/server.py

@@ -1,6 +1,7 @@
 import asyncio
 import logging
 import socket
+import warnings
 from typing import Union, Tuple, Type, Optional, Any
 from collections.abc import Iterable
 
@@ -153,8 +154,18 @@ def subscribe_channel_update(self, broadcaster: Union[PartialUser, str, int]):
         return self._subscribe_with_broadcaster(models.SubscriptionTypes.channel_update, broadcaster)
 
     def subscribe_channel_follows(self, broadcaster: Union[PartialUser, str, int]):
+        """
+        .. warning::
+            This endpoint is deprecated, use :func:`~EventSubClient.subscribe_channel_follows_v2`
+
+        """
+        warnings.warn("subscribe_channel_follows is deprecated, use subscribe_channel_follows_v2 instead.", DeprecationWarning, 2)
+
         return self._subscribe_with_broadcaster(models.SubscriptionTypes.follow, broadcaster)
 
+    def subscribe_channel_follows_v2(self, broadcaster: Union[PartialUser, str, int], moderator: Union[PartialUser, str, int]):
+        return self._subscribe_with_broadcaster_moderator(models.SubscriptionTypes.followV2, broadcaster, moderator)
+
     def subscribe_channel_moderators_add(self, broadcaster: Union[PartialUser, str, int]):
         return self._subscribe_with_broadcaster(models.SubscriptionTypes.channel_moderator_add, broadcaster)