Add hasAnyPermission(Permission... permissions) method to IPermissionHolder

[lajczik]

Currently, checking whether a permission holder has at least one of several permissions requires chaining multiple hasPermission calls with ||, e.g.

if (member.hasPermission(Permission.ADMINISTRATOR) || member.hasPermission(Permission.MANAGE_SERVER)) { ... }

This is verbose and inefficient because each call recomputes the effective permissions. Adding a dedicated hasAnyPermission method would simplify the code and allow for potential internal optimizations (e.g., computing permissions once and checking all bits).

Motivation

• Developer convenience – clean, expressive code for a common pattern.
• Performance – the current approach recalculates permissions for each check. A single method can compute effective permissions once and then test for any of the given bits, reducing overhead in permission‑intensive code paths.
• Consistency – complements the existing hasPermission (which requires all permissions) and the Collection overloads.

Proposed API
Add the following methods to the IPermissionHolder interface:

/**
 * Checks whether this PermissionHolder has at least one of the given {@link Permission Permissions} in the Guild.
 *
 * @param  permissions
 *         Permissions to check for (at least one required)
 *
 * @throws IllegalArgumentException
 *         If null is provided
 * @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
 *         If this is a {@link Member#isDetached() detached} member.
 *
 * @return True, if this PermissionHolder has any of the specified Permissions.
 */
boolean hasAnyPermission(@Nonnull Permission... permissions);

/**
 * Checks whether this PermissionHolder has at least one of the given {@link Permission Permissions}
 * in the specified {@link GuildChannel}.
 *
 * @param  channel
 *         The {@link GuildChannel} in which to check.
 * @param  permissions
 *         Permissions to check for (at least one required)
 *
 * @throws IllegalArgumentException
 *         If null is provided
 * @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
 *         If this is a {@link Role#isDetached() detached} role
 * @throws net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException
 *         If this is a detached member and permission data is missing
 *
 * @return True, if this PermissionHolder has any of the specified Permissions in the provided GuildChannel.
 */
boolean hasAnyPermission(@Nonnull GuildChannel channel, @Nonnull Permission... permissions);

Additionally, provide default convenience overloads for Collection<Permission>:

default boolean hasAnyPermission(@Nonnull Collection<Permission> permissions) {
    Checks.notNull(permissions, "Permission Collection");
    return hasAnyPermission(permissions.toArray(Permission.EMPTY_PERMISSIONS));
}

default boolean hasAnyPermission(@Nonnull GuildChannel channel, @Nonnull Collection<Permission> permissions) {
    Checks.notNull(permissions, "Permission Collection");
    return hasAnyPermission(channel, permissions.toArray(Permission.EMPTY_PERMISSIONS));
}

Implementation considerations

• The existing hasPermission methods are implemented in Member and Role (likely via PermissionUtil). The new methods would follow a similar pattern, using PermissionUtil.checkAnyPermission or a variant.
• Internal implementation can reuse getEffectivePermission (for guild) and getEffectivePermission(channel, holder) to obtain the permission bits once, then check (effective & raw) != 0 for each required permission.
• The method should return true at the first match, allowing early exit.

Example usage

// Instead of:
if (member.hasPermission(Permission.ADMINISTRATOR) || member.hasPermission(Permission.MANAGE_SERVER)) { ... }

// Use:
if (member.hasAnyPermission(Permission.ADMINISTRATOR, Permission.MANAGE_SERVER)) { ... }

Related discussion
This feature has been requested informally by the community (e.g., [link to any existing discussions if known]), and it aligns with similar utilities in other libraries.