feat: fire chat event for hosts of own channel

chat/src/main/java/com/github/twitch4j/chat/events/IRCEventHandler.java

@@ -66,6 +66,7 @@ public IRCEventHandler(TwitchChat twitchChat) {
         eventManager.onEvent("twitch4j-chat-notice-trigger", IRCMessageEvent.class, this::onNoticeEvent);
         eventManager.onEvent("twitch4j-chat-host-on-trigger", IRCMessageEvent.class, this::onHostOnEvent);
         eventManager.onEvent("twitch4j-chat-host-off-trigger", IRCMessageEvent.class, this::onHostOffEvent);
+        eventManager.onEvent("twitch4j-chat-inbound-host-trigger", IRCMessageEvent.class, this::onInboundHostEvent);
         eventManager.onEvent("twitch4j-chat-list-mods-trigger", IRCMessageEvent.class, this::onListModsEvent);
         eventManager.onEvent("twitch4j-chat-list-vips-trigger", IRCMessageEvent.class, this::onListVipsEvent);
         eventManager.onEvent("twitch4j-chat-roomstate-trigger", IRCMessageEvent.class, this::onChannelState);
@@ -510,6 +511,17 @@ public void onHostOffEvent(IRCMessageEvent event) {
         }
     }
 
+    public void onInboundHostEvent(IRCMessageEvent event) {
+        if ("PRIVMSG".equals(event.getCommandType()) && "jtv".equals(event.getClientName().orElse(null)) && event.getChannelName().isPresent() && event.getRawTags().isEmpty()) {
+            final String hostMessageSuffix = " is now hosting you.";
+            event.getMessage()
+                .map(String::trim)
+                .filter(msg -> msg.endsWith(hostMessageSuffix))
+                .map(msg -> msg.substring(0, msg.length() - hostMessageSuffix.length()))
+                .ifPresent(hostName -> eventManager.publish(new InboundHostEvent(event.getChannelName().get(), hostName)));
+        }
+    }
+
     public void onListModsEvent(IRCMessageEvent event) {
         if ("NOTICE".equals(event.getCommandType()) && event.getTagValue("msg-id").filter(s -> s.equals("room_mods") || s.equals("no_mods")).isPresent()) {
             List<String> names = extractItemsFromDelimitedList(event.getMessage(), "The moderators of this channel are: ", ", ");

chat/src/main/java/com/github/twitch4j/chat/events/channel/InboundHostEvent.java

@@ -0,0 +1,28 @@
+package com.github.twitch4j.chat.events.channel;
+
+import com.github.twitch4j.chat.events.TwitchEvent;
+import com.github.twitch4j.common.annotation.Unofficial;
+import lombok.EqualsAndHashCode;
+import lombok.Value;
+
+/**
+ * Fired when the authenticated channel to the TwitchChat instance was hosted by another user.
+ * <p>
+ * Not officially documented by Twitch so this could stop working at any time.
+ */
+@Value
+@EqualsAndHashCode(callSuper = true)
+@Unofficial
+public class InboundHostEvent extends TwitchEvent {
+
+    /**
+     * Login name of the channel that was hosted (i.e., the user passed in chatAccount).
+     */
+    String hostTarget;
+
+    /**
+     * Display name of the user that just hosted your channel.
+     */
+    String hosterName;
+
+}