From 10d892303fbbe6a6a2782c611b1a18656b721a06 Mon Sep 17 00:00:00 2001 From: Sidd Date: Tue, 6 Sep 2022 22:12:52 -0700 Subject: [PATCH] chore: deprecate hosts due to twitch announcement --- .../com/github/twitch4j/chat/events/IRCEventHandler.java | 3 +++ .../github/twitch4j/chat/events/channel/HostOffEvent.java | 3 +++ .../github/twitch4j/chat/events/channel/HostOnEvent.java | 3 +++ .../twitch4j/chat/events/channel/InboundHostEvent.java | 3 +++ .../github/twitch4j/pubsub/domain/ChatModerationAction.java | 6 ++++++ .../com/github/twitch4j/tmi/TwitchMessagingInterface.java | 2 ++ .../src/main/java/com/github/twitch4j/tmi/domain/Host.java | 1 + .../main/java/com/github/twitch4j/tmi/domain/HostList.java | 1 + 8 files changed, 22 insertions(+) diff --git a/chat/src/main/java/com/github/twitch4j/chat/events/IRCEventHandler.java b/chat/src/main/java/com/github/twitch4j/chat/events/IRCEventHandler.java index 766278cec..d9bdb6b20 100644 --- a/chat/src/main/java/com/github/twitch4j/chat/events/IRCEventHandler.java +++ b/chat/src/main/java/com/github/twitch4j/chat/events/IRCEventHandler.java @@ -551,6 +551,7 @@ public void onNoticeEvent(IRCMessageEvent event) { } } + @Deprecated public void onHostOnEvent(IRCMessageEvent event) { if (event.getCommandType().equals("NOTICE")) { EventChannel channel = event.getChannel(); @@ -565,6 +566,7 @@ public void onHostOnEvent(IRCMessageEvent event) { } } + @Deprecated public void onHostOffEvent(IRCMessageEvent event) { if (event.getCommandType().equals("NOTICE")) { EventChannel channel = event.getChannel(); @@ -576,6 +578,7 @@ public void onHostOffEvent(IRCMessageEvent event) { } } + @Deprecated public void onInboundHostEvent(IRCMessageEvent event) { if ("PRIVMSG".equals(event.getCommandType()) && "jtv".equals(event.getClientName().orElse(null)) && event.getChannelName().isPresent() && event.getRawTags().isEmpty()) { final String hostMessage = " is now hosting you"; diff --git a/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOffEvent.java b/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOffEvent.java index 02ce51ba2..8d160feeb 100644 --- a/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOffEvent.java +++ b/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOffEvent.java @@ -8,10 +8,13 @@ /** * This event gets called when the user stops hosting someone. + * + * @deprecated Twitch is removing host mode on October 3, 2022 */ @Value @EqualsAndHashCode(callSuper = true) @ToString(callSuper = true) +@Deprecated public class HostOffEvent extends AbstractChannelEvent { /** diff --git a/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOnEvent.java b/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOnEvent.java index b8c4d59bf..5bd583f8a 100644 --- a/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOnEvent.java +++ b/chat/src/main/java/com/github/twitch4j/chat/events/channel/HostOnEvent.java @@ -8,10 +8,13 @@ /** * This event gets called when the user starts hosting someone. + * + * @deprecated Twitch is removing host mode on October 3, 2022 */ @Value @Getter @EqualsAndHashCode(callSuper = false) +@Deprecated public class HostOnEvent extends AbstractChannelEvent { /** diff --git a/chat/src/main/java/com/github/twitch4j/chat/events/channel/InboundHostEvent.java b/chat/src/main/java/com/github/twitch4j/chat/events/channel/InboundHostEvent.java index 9ed26fa28..24e713fa0 100644 --- a/chat/src/main/java/com/github/twitch4j/chat/events/channel/InboundHostEvent.java +++ b/chat/src/main/java/com/github/twitch4j/chat/events/channel/InboundHostEvent.java @@ -9,10 +9,13 @@ * Fired when the authenticated channel to the TwitchChat instance was hosted by another user. *

* Not officially documented by Twitch so this could stop working at any time. + * + * @deprecated Twitch is removing host mode on October 3, 2022 */ @Value @EqualsAndHashCode(callSuper = true) @Unofficial +@Deprecated public class InboundHostEvent extends TwitchEvent { /** diff --git a/pubsub/src/main/java/com/github/twitch4j/pubsub/domain/ChatModerationAction.java b/pubsub/src/main/java/com/github/twitch4j/pubsub/domain/ChatModerationAction.java index 6adcc72a5..7ccd8e383 100644 --- a/pubsub/src/main/java/com/github/twitch4j/pubsub/domain/ChatModerationAction.java +++ b/pubsub/src/main/java/com/github/twitch4j/pubsub/domain/ChatModerationAction.java @@ -269,11 +269,17 @@ public enum ModerationAction { UNMOD, /** * Another channel was hosted + * + * @deprecated Twitch is removing host mode on October 3, 2022 */ + @Deprecated HOST, /** * Channel exited host mode + * + * @deprecated Twitch is removing host mode on October 3, 2022 */ + @Deprecated UNHOST, /** * A raid on another channel was initiated diff --git a/rest-tmi/src/main/java/com/github/twitch4j/tmi/TwitchMessagingInterface.java b/rest-tmi/src/main/java/com/github/twitch4j/tmi/TwitchMessagingInterface.java index bb365a95d..8ce3c24da 100644 --- a/rest-tmi/src/main/java/com/github/twitch4j/tmi/TwitchMessagingInterface.java +++ b/rest-tmi/src/main/java/com/github/twitch4j/tmi/TwitchMessagingInterface.java @@ -94,7 +94,9 @@ HystrixCommand getChatters( * * @param channelIds A list containing a user ID for each channel to check. * @return Host information for each channel ID passed. + * @deprecated Twitch is removing host mode on October 3, 2022 */ + @Deprecated @RequestLine("GET /hosts?include_logins=1&host={id}") HystrixCommand getHosts( @Param("id") List channelIds diff --git a/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/Host.java b/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/Host.java index fc921b1c0..7f2b6b06c 100644 --- a/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/Host.java +++ b/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/Host.java @@ -8,6 +8,7 @@ @Data @Setter(AccessLevel.PRIVATE) @NoArgsConstructor +@Deprecated public class Host { private String hostId; diff --git a/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/HostList.java b/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/HostList.java index 3b53eaec4..b5c6500f3 100644 --- a/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/HostList.java +++ b/rest-tmi/src/main/java/com/github/twitch4j/tmi/domain/HostList.java @@ -10,6 +10,7 @@ @Data @Setter(AccessLevel.PRIVATE) @NoArgsConstructor +@Deprecated public class HostList { private List hosts;