First pass on stage channels

src/main/java/net/dv8tion/jda/api/JDA.java

@@ -58,6 +58,7 @@
 import java.util.function.BooleanSupplier;
 import java.util.function.Consumer;
 import java.util.regex.Matcher;
+import java.util.stream.Collectors;
 
 /**
  * The core of JDA. Acts as a registry system of JDA. All parts of the the API can be accessed starting from this class.
@@ -1164,6 +1165,8 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
             return getTextChannelById(id);
         case VOICE:
             return getVoiceChannelById(id);
+        case STAGE:
+            return getStageChannelById(id);
         case STORE:
             return getStoreChannelById(id);
         case CATEGORY:
@@ -1172,6 +1175,29 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
         return null;
     }
 
+    @Nonnull
+    default List<StageChannel> getStageChannelsByName(@Nonnull String name, boolean ignoreCase)
+    {
+        return getVoiceChannelsByName(name, ignoreCase)
+                .stream()
+                .filter(StageChannel.class::isInstance)
+                .map(StageChannel.class::cast)
+                .collect(Collectors.toList());
+    }
+
+    @Nullable
+    default StageChannel getStageChannelById(@Nonnull String id)
+    {
+        return getStageChannelById(MiscUtil.parseSnowflake(id));
+    }
+
+    @Nullable
+    default StageChannel getStageChannelById(long id)
+    {
+        VoiceChannel channel = getVoiceChannelById(id);
+        return channel instanceof StageChannel ? (StageChannel) channel : null;
+    }
+
     /**
      * {@link net.dv8tion.jda.api.utils.cache.SnowflakeCacheView SnowflakeCacheView} of
      * all cached {@link net.dv8tion.jda.api.entities.Category Categories} visible to this JDA session.

src/main/java/net/dv8tion/jda/api/entities/Category.java

@@ -159,6 +159,43 @@ public interface Category extends GuildChannel
     @CheckReturnValue
     ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name);
 
+    /**
+     * Creates a new {@link net.dv8tion.jda.api.entities.StageChannel VoiceChannel} with this Category as parent.
+     * For this to be successful, the logged in account has to have the
+     * {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission in the {@link net.dv8tion.jda.api.entities.Guild Guild}.
+     *
+     * <p>This will copy all {@link net.dv8tion.jda.api.entities.PermissionOverride PermissionOverrides} of this Category!
+     * Unless the bot is unable to sync it with this category due to permission escalation.
+     * See {@link IPermissionHolder#canSync(GuildChannel, GuildChannel)} for details.
+     *
+     * <p>Possible {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} caused by
+     * the returned {@link net.dv8tion.jda.api.requests.RestAction RestAction} include the following:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The channel could not be created due to a permission discrepancy</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The {@link net.dv8tion.jda.api.Permission#VIEW_CHANNEL VIEW_CHANNEL} permission was removed</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MAX_CHANNELS MAX_CHANNELS}
+     *     <br>The maximum number of channels were exceeded</li>
+     * </ul>
+     *
+     * @param  name
+     *         The name of the StageChannel to create
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If the logged in account does not have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL} permission
+     * @throws IllegalArgumentException
+     *         If the provided name is {@code null} or empty or greater than 100 characters in length
+     *
+     * @return A specific {@link ChannelAction ChannelAction}
+     *         <br>This action allows to set fields for the new StageChannel before creating it
+     */
+    @Nonnull
+    @CheckReturnValue
+    ChannelAction<StageChannel> createStageChannel(@Nonnull String name);
+
     /**
      * Modifies the positional order of this Category's nested {@link #getTextChannels() TextChannels} and {@link #getStoreChannels() StoreChannels}.
      * <br>This uses an extension of {@link ChannelOrderAction ChannelOrderAction}

src/main/java/net/dv8tion/jda/api/entities/Guild.java

@@ -56,6 +56,7 @@
 import java.util.concurrent.Future;
 import java.util.function.Consumer;
 import java.util.function.Predicate;
+import java.util.stream.Collectors;
 
 /**
  * Represents a Discord {@link net.dv8tion.jda.api.entities.Guild Guild}.
@@ -1147,6 +1148,8 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
                 return getTextChannelById(id);
             case VOICE:
                 return getVoiceChannelById(id);
+            case STAGE:
+                return getStageChannelById(id);
             case STORE:
                 return getStoreChannelById(id);
             case CATEGORY:
@@ -1155,6 +1158,29 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
         return null;
     }
 
+    @Nonnull
+    default List<StageChannel> getStageChannelsByName(@Nonnull String name, boolean ignoreCase)
+    {
+        return getVoiceChannelsByName(name, ignoreCase)
+                .stream()
+                .filter(StageChannel.class::isInstance)
+                .map(StageChannel.class::cast)
+                .collect(Collectors.toList());
+    }
+
+    @Nullable
+    default StageChannel getStageChannelById(@Nonnull String id)
+    {
+        return getStageChannelById(MiscUtil.parseSnowflake(id));
+    }
+
+    @Nullable
+    default StageChannel getStageChannelById(long id)
+    {
+        VoiceChannel channel = getVoiceChannelById(id);
+        return channel instanceof StageChannel ? (StageChannel) channel : null;
+    }
+
     /**
      * Gets the {@link net.dv8tion.jda.api.entities.Category Category} from this guild that matches the provided id.
      * This method is similar to {@link net.dv8tion.jda.api.JDA#getCategoryById(String)}, but it only checks in this
@@ -4613,6 +4639,70 @@ default ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name)
     @CheckReturnValue
     ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name, @Nullable Category parent);
 
+    /**
+     * Creates a new {@link net.dv8tion.jda.api.entities.StageChannel VoiceChannel} in this Guild.
+     * For this to be successful, the logged in account has to have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission.
+     *
+     * <p>Possible {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} caused by
+     * the returned {@link net.dv8tion.jda.api.requests.RestAction RestAction} include the following:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The channel could not be created due to a permission discrepancy</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MAX_CHANNELS MAX_CHANNELS}
+     *     <br>The maximum number of channels were exceeded</li>
+     * </ul>
+     *
+     * @param  name
+     *         The name of the StageChannel to create
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If the logged in account does not have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL} permission
+     * @throws IllegalArgumentException
+     *         If the provided name is {@code null} or empty or greater than 100 characters in length
+     *
+     * @return A specific {@link ChannelAction ChannelAction}
+     *         <br>This action allows to set fields for the new StageChannel before creating it
+     */
+    @Nonnull
+    @CheckReturnValue
+    default ChannelAction<StageChannel> createStageChannel(@Nonnull String name)
+    {
+        return createStageChannel(name, null);
+    }
+
+    /**
+     * Creates a new {@link net.dv8tion.jda.api.entities.StageChannel VoiceChannel} in this Guild.
+     * For this to be successful, the logged in account has to have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission.
+     *
+     * <p>Possible {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} caused by
+     * the returned {@link net.dv8tion.jda.api.requests.RestAction RestAction} include the following:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The channel could not be created due to a permission discrepancy</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MAX_CHANNELS MAX_CHANNELS}
+     *     <br>The maximum number of channels were exceeded</li>
+     * </ul>
+     *
+     * @param  name
+     *         The name of the StageChannel to create
+     * @param  parent
+     *         The optional parent category for this channel, or null
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If the logged in account does not have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL} permission
+     * @throws IllegalArgumentException
+     *         If the provided name is {@code null} or empty or greater than 100 characters in length;
+     *         or the provided parent is not in the same guild.
+     *
+     * @return A specific {@link ChannelAction ChannelAction}
+     *         <br>This action allows to set fields for the new StageChannel before creating it
+     */
+    @Nonnull
+    @CheckReturnValue
+    ChannelAction<StageChannel> createStageChannel(@Nonnull String name, @Nullable Category parent);
+
     /**
      * Creates a new {@link net.dv8tion.jda.api.entities.Category Category} in this Guild.
      * For this to be successful, the logged in account has to have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission.

src/main/java/net/dv8tion/jda/api/entities/IPermissionHolder.java

@@ -173,7 +173,7 @@ public interface IPermissionHolder extends ISnowflake
     default boolean hasAccess(@Nonnull GuildChannel channel)
     {
         Checks.notNull(channel, "Channel");
-        return channel.getType() == ChannelType.VOICE
+        return channel.getType() == ChannelType.VOICE || channel.getType() == ChannelType.STAGE
                 ? hasPermission(channel, Permission.VOICE_CONNECT, Permission.VIEW_CHANNEL)
                 : hasPermission(channel, Permission.VIEW_CHANNEL);
     }

src/main/java/net/dv8tion/jda/api/events/guild/invite/GenericGuildInviteEvent.java

@@ -114,7 +114,7 @@ public TextChannel getTextChannel()
      * The {@link VoiceChannel} this invite points to.
      *
      * @throws IllegalStateException
-     *         If this did not happen in a channel of type {@link ChannelType#VOICE ChannelType.VOICE}
+     *         If this did not happen in a voice channel
      *
      * @return {@link VoiceChannel}
      *
@@ -124,11 +124,30 @@ public TextChannel getTextChannel()
     @Nonnull
     public VoiceChannel getVoiceChannel()
     {
-        if (getChannelType() != ChannelType.VOICE)
-            throw new IllegalStateException("The channel is not of type VOICE");
+        if (!(channel instanceof VoiceChannel))
+            throw new IllegalStateException("The channel is not of type VOICE or STAGE");
         return (VoiceChannel) getChannel();
     }
 
+    /**
+     * The {@link StageChannel} this invite points to.
+     *
+     * @throws IllegalStateException
+     *         If this did not happen in a channel of type {@link ChannelType#STAGE ChannelType.STAGE}
+     *
+     * @return {@link StageChannel}
+     *
+     * @see    #getChannel()
+     * @see    #getChannelType()
+     */
+    @Nonnull
+    public StageChannel getStageChannel()
+    {
+        if (getChannelType() != ChannelType.STAGE)
+            throw new IllegalStateException("The channel is not of type STAGE");
+        return (StageChannel) getChannel();
+    }
+
     /**
      * The {@link StoreChannel} this invite points to.
      *

src/main/java/net/dv8tion/jda/api/requests/restaction/GuildAction.java

@@ -539,9 +539,12 @@ class ChannelData implements SerializableData
         public ChannelData(ChannelType type, String name)
         {
             Checks.notBlank(name, "Name");
-            Checks.check(type == ChannelType.TEXT || type == ChannelType.VOICE, "Can only create channels of type TEXT or VOICE in GuildAction!");
-            Checks.check(name.length() >= 2 && name.length() <= 100, "Channel name has to be between 2-100 characters long!");
-            Checks.check(type == ChannelType.VOICE || name.matches("[a-zA-Z0-9-_]+"), "Channels of type TEXT must have a name in alphanumeric with underscores!");
+            Checks.check(type == ChannelType.TEXT || type == ChannelType.VOICE || type == ChannelType.STAGE,
+                "Can only create channels of type TEXT, STAGE, or VOICE in GuildAction!");
+            Checks.check(name.length() >= 2 && name.length() <= 100,
+                "Channel name has to be between 2-100 characters long!");
+            Checks.check(type == ChannelType.VOICE || type == ChannelType.STAGE || name.matches("[a-zA-Z0-9-_]+"),
+                "Channels of type TEXT must have a name in alphanumeric with underscores!");
 
             this.type = type;
             this.name = name;

src/main/java/net/dv8tion/jda/internal/entities/CategoryImpl.java

@@ -171,6 +171,14 @@ public ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name)
         return trySync(action);
     }
 
+    @Nonnull
+    @Override
+    public ChannelAction<StageChannel> createStageChannel(@Nonnull String name)
+    {
+        ChannelAction<StageChannel> action = getGuild().createStageChannel(name, this);
+        return trySync(action);
+    }
+
     private <T extends GuildChannel> ChannelAction<T> trySync(ChannelAction<T> action)
     {
         Member selfMember = getGuild().getSelfMember();

src/main/java/net/dv8tion/jda/internal/entities/GuildImpl.java

@@ -1393,6 +1393,28 @@ public ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name, Cate
         return new ChannelActionImpl<>(VoiceChannel.class, name, this, ChannelType.VOICE).setParent(parent);
     }
 
+    @Nonnull
+    @Override
+    public ChannelAction<StageChannel> createStageChannel(@Nonnull String name, Category parent)
+    {
+        if (parent != null)
+        {
+            Checks.check(parent.getGuild().equals(this), "Category is not from the same guild!");
+            if (!getSelfMember().hasPermission(parent, Permission.MANAGE_CHANNEL))
+                throw new InsufficientPermissionException(parent, Permission.MANAGE_CHANNEL);
+        }
+        else
+        {
+            checkPermission(Permission.MANAGE_CHANNEL);
+        }
+
+        Checks.notBlank(name, "Name");
+        name = name.trim();
+
+        Checks.check(name.length() > 0 && name.length() <= 100, "Provided name must be 1 - 100 characters in length");
+        return new ChannelActionImpl<>(StageChannel.class, name, this, ChannelType.STAGE).setParent(parent);
+    }
+
     @Nonnull
     @Override
     public ChannelAction<Category> createCategory(@Nonnull String name)

src/main/java/net/dv8tion/jda/internal/handle/ChannelCreateHandler.java

@@ -68,6 +68,7 @@ protected Long handleInternally(DataObject content)
                         builder.createTextChannel(content, guildId)));
                 break;
             }
+            case STAGE:
             case VOICE:
             {
                 jda.handleEvent(

src/main/java/net/dv8tion/jda/internal/handle/ChannelDeleteHandler.java

@@ -85,6 +85,7 @@ protected Long handleInternally(DataObject content)
                         channel));
                 break;
             }
+            case STAGE:
             case VOICE:
             {
                 VoiceChannel channel = getJDA().getVoiceChannelsView().remove(channelId);

src/main/java/net/dv8tion/jda/internal/handle/ChannelUpdateHandler.java

@@ -183,6 +183,7 @@ protected Long handleInternally(DataObject content)
                 applyPermissions(textChannel, permOverwrites);
                 break;  //Finish the TextChannelUpdate case
             }
+            case STAGE:
             case VOICE:
             {
                 VoiceChannelImpl voiceChannel = (VoiceChannelImpl) getJDA().getVoiceChannelsView().get(channelId);
@@ -323,6 +324,7 @@ private void applyPermissions(AbstractChannelImpl<?,?> channel, DataArray permOv
                     api, responseNumber,
                     (StoreChannel) channel, changed));
             break;
+        case STAGE:
         case VOICE:
             api.handleEvent(
                 new VoiceChannelUpdatePermissionsEvent(

src/main/java/net/dv8tion/jda/internal/requests/restaction/ChannelActionImpl.java

@@ -140,8 +140,8 @@ public ChannelActionImpl<T> setPosition(Integer position)
     @CheckReturnValue
     public ChannelActionImpl<T> setTopic(String topic)
     {
-        if (type != ChannelType.TEXT)
-            throw new UnsupportedOperationException("Can only set the topic for a TextChannel!");
+        if (type != ChannelType.TEXT && type != ChannelType.STAGE)
+            throw new UnsupportedOperationException("Can only set the topic for a TextChannel or StageChannel!");
         if (topic != null && topic.length() > 1024)
             throw new IllegalArgumentException("Channel Topic must not be greater than 1024 in length!");
         this.topic = topic;
@@ -330,14 +330,15 @@ protected RequestBody finalizeData()
                     object.put("user_limit", userlimit);
                 break;
             case TEXT:
-                if (topic != null && !topic.isEmpty())
-                    object.put("topic", topic);
                 if (nsfw != null)
                     object.put("nsfw", nsfw);
                 if (slowmode != null)
                     object.put("rate_limit_per_user", slowmode);
                 if (news != null)
                     object.put("type", news ? 5 : 0);
+            case STAGE:
+                if (topic != null && !topic.isEmpty())
+                    object.put("topic", topic);
         }
         if (type != ChannelType.CATEGORY && parent != null)
             object.put("parent_id", parent.getId());
@@ -352,6 +353,7 @@ protected void handleSuccess(Response response, Request<T> request)
         GuildChannel channel;
         switch (type)
         {
+            case STAGE:
             case VOICE:
                 channel = builder.createVoiceChannel(response.getObject(), guild.getIdLong());
                 break;

src/main/java/net/dv8tion/jda/internal/utils/PermissionUtil.java

@@ -368,7 +368,7 @@ public static long getEffectivePermission(GuildChannel channel, Member member)
 
         //When the permission to view the channel or to connect to the channel is not applied it is not granted
         // This means that we have no access to this channel at all
-        final boolean hasConnect = channel.getType() != ChannelType.VOICE || isApplied(permission, connectChannel);
+        final boolean hasConnect = (channel.getType() != ChannelType.VOICE && channel.getType() != ChannelType.STAGE) || isApplied(permission, connectChannel);
         final boolean hasView = isApplied(permission, viewChannel);
         return hasView && hasConnect ? permission : 0;
     }