From 01c3427a240e62e759fc0505efea8cb6ed9cef37 Mon Sep 17 00:00:00 2001
From: iProdigy <gitProdigy@proton.me>
Date: Thu, 5 Jan 2023 15:56:27 -0600
Subject: [PATCH] docs: warn upcoming deprecation of helix getFollowers (#665)

---
 .../github/twitch4j/helix/TwitchHelix.java    | 19 ++++++++++++-------
 .../com/github/twitch4j/IClientHelper.java    |  8 +++++++-
 2 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/rest-helix/src/main/java/com/github/twitch4j/helix/TwitchHelix.java b/rest-helix/src/main/java/com/github/twitch4j/helix/TwitchHelix.java
index 82913ec27..775a1eb47 100644
--- a/rest-helix/src/main/java/com/github/twitch4j/helix/TwitchHelix.java
+++ b/rest-helix/src/main/java/com/github/twitch4j/helix/TwitchHelix.java
@@ -2540,15 +2540,20 @@ HystrixCommand<Void> unblockUser(
     /**
      * Get Followers
      * <p>
-     * Gets information on follow relationships between two Twitch users. Information returned is sorted in order, most recent follow first. This can return information like “who is lirik following,” “who is following lirik,” or “is user X following user Y.”
-     * Using user-token or app-token to increase rate limits.
+     * Gets information on follow relationships between two Twitch users.
+     * Information returned is sorted in order, most recent follow first.
+     * <p>
+     * WARNING: This method will soon be deprecated as Twitch is imposing new auth requirements.
+     * When to_id is specified, a (scoped) broadcaster or moderator oauth token will be required.
+     * When from_id is specified, a (scoped) user access token associated with from_id will be required.
      *
-     * @param authToken User or App auth Token, for increased rate-limits
-     * @param fromId User ID. The request returns information about users who are being followed by the from_id user.
-     * @param toId   User ID. The request returns information about users who are following the to_id user.
-     * @param after  Cursor for forward pagination: tells the server where to start fetching the next set of results, in a multi-page response.
-     * @param limit  Maximum number of objects to return. Maximum: 100. Default: 20.
+     * @param authToken User or App access Token
+     * @param fromId    User ID. The request returns information about users who are being followed by the from_id user.
+     * @param toId      User ID. The request returns information about users who are following the to_id user.
+     * @param after     Cursor for forward pagination: tells the server where to start fetching the next set of results, in a multi-page response.
+     * @param limit     Maximum number of objects to return. Maximum: 100. Default: 20.
      * @return FollowList
+     * @see <a href="https://www.twitch.tv/videos/1604648673?t=0h36m30s">Early deprecation notice</a>
      */
     @RequestLine("GET /users/follows?from_id={from_id}&to_id={to_id}&after={after}&first={first}")
     @Headers("Authorization: Bearer {token}")
diff --git a/twitch4j/src/main/java/com/github/twitch4j/IClientHelper.java b/twitch4j/src/main/java/com/github/twitch4j/IClientHelper.java
index ab5fc40a3..33e907fae 100644
--- a/twitch4j/src/main/java/com/github/twitch4j/IClientHelper.java
+++ b/twitch4j/src/main/java/com/github/twitch4j/IClientHelper.java
@@ -41,6 +41,8 @@ public interface IClientHelper extends AutoCloseable {
 
     /**
      * Enable Follow Listener, without invoking a Helix API call
+     * <p>
+     * WARNING: This will eventually require defaultAuthToken to represent the channel (or a moderator), due to Twitch scope changes.
      *
      * @param channelId   Channel Id
      * @param channelName Channel Name
@@ -156,7 +158,9 @@ default void disableStreamEventListener(Iterable<String> channelNames) {
     }
 
     /**
-     * Follow Listener
+     * Enable Follow Listener for the given channel name
+     * <p>
+     * WARNING: This will eventually require defaultAuthToken to represent the channel (or a moderator), due to Twitch scope changes.
      *
      * @param channelName Channel Name
      */
@@ -177,6 +181,8 @@ default User enableFollowEventListener(String channelName) {
 
     /**
      * Enable Follow Listener for the given channel names
+     * <p>
+     * WARNING: This will eventually require defaultAuthToken to represent the channel (or a moderator), due to Twitch scope changes.
      *
      * @param channelNames the channel names to be added
      */