You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
238 lines
11 KiB
238 lines
11 KiB
4 years ago
|
using System;
|
||
|
using System.Collections.Generic;
|
||
|
using System.Collections.Immutable;
|
||
|
using System.Linq;
|
||
|
using System.Threading.Tasks;
|
||
|
using Model = Discord.API.Channel;
|
||
|
|
||
|
namespace Discord.Rest
|
||
|
{
|
||
|
/// <summary>
|
||
|
/// Represents a private REST-based group channel.
|
||
|
/// </summary>
|
||
|
public class RestGuildChannel : RestChannel, IGuildChannel
|
||
|
{
|
||
|
private ImmutableArray<Overwrite> _overwrites;
|
||
|
|
||
|
/// <inheritdoc />
|
||
|
public virtual IReadOnlyCollection<Overwrite> PermissionOverwrites => _overwrites;
|
||
|
|
||
|
internal IGuild Guild { get; }
|
||
|
/// <inheritdoc />
|
||
|
public string Name { get; private set; }
|
||
|
/// <inheritdoc />
|
||
|
public int Position { get; private set; }
|
||
|
/// <inheritdoc />
|
||
|
public ulong GuildId => Guild.Id;
|
||
|
|
||
|
internal RestGuildChannel(BaseDiscordClient discord, IGuild guild, ulong id)
|
||
|
: base(discord, id)
|
||
|
{
|
||
|
Guild = guild;
|
||
|
}
|
||
|
internal static RestGuildChannel Create(BaseDiscordClient discord, IGuild guild, Model model)
|
||
|
{
|
||
|
switch (model.Type)
|
||
|
{
|
||
|
case ChannelType.News:
|
||
|
return RestNewsChannel.Create(discord, guild, model);
|
||
|
case ChannelType.Text:
|
||
|
return RestTextChannel.Create(discord, guild, model);
|
||
|
case ChannelType.Voice:
|
||
|
return RestVoiceChannel.Create(discord, guild, model);
|
||
|
case ChannelType.Category:
|
||
|
return RestCategoryChannel.Create(discord, guild, model);
|
||
|
default:
|
||
|
return new RestGuildChannel(discord, guild, model.Id);
|
||
|
}
|
||
|
}
|
||
|
internal override void Update(Model model)
|
||
|
{
|
||
|
Name = model.Name.Value;
|
||
|
Position = model.Position.Value;
|
||
|
|
||
|
var overwrites = model.PermissionOverwrites.Value;
|
||
|
var newOverwrites = ImmutableArray.CreateBuilder<Overwrite>(overwrites.Length);
|
||
|
for (int i = 0; i < overwrites.Length; i++)
|
||
|
newOverwrites.Add(overwrites[i].ToEntity());
|
||
|
_overwrites = newOverwrites.ToImmutable();
|
||
|
}
|
||
|
|
||
|
/// <inheritdoc />
|
||
|
public override async Task UpdateAsync(RequestOptions options = null)
|
||
|
{
|
||
|
var model = await Discord.ApiClient.GetChannelAsync(GuildId, Id, options).ConfigureAwait(false);
|
||
|
Update(model);
|
||
|
}
|
||
|
/// <inheritdoc />
|
||
|
public async Task ModifyAsync(Action<GuildChannelProperties> func, RequestOptions options = null)
|
||
|
{
|
||
|
var model = await ChannelHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false);
|
||
|
Update(model);
|
||
|
}
|
||
|
/// <inheritdoc />
|
||
|
public Task DeleteAsync(RequestOptions options = null)
|
||
|
=> ChannelHelper.DeleteAsync(this, Discord, options);
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the permission overwrite for a specific user.
|
||
|
/// </summary>
|
||
|
/// <param name="user">The user to get the overwrite from.</param>
|
||
|
/// <returns>
|
||
|
/// An overwrite object for the targeted user; <c>null</c> if none is set.
|
||
|
/// </returns>
|
||
|
public virtual OverwritePermissions? GetPermissionOverwrite(IUser user)
|
||
|
{
|
||
|
for (int i = 0; i < _overwrites.Length; i++)
|
||
|
{
|
||
|
if (_overwrites[i].TargetId == user.Id)
|
||
|
return _overwrites[i].Permissions;
|
||
|
}
|
||
|
return null;
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the permission overwrite for a specific role.
|
||
|
/// </summary>
|
||
|
/// <param name="role">The role to get the overwrite from.</param>
|
||
|
/// <returns>
|
||
|
/// An overwrite object for the targeted role; <c>null</c> if none is set.
|
||
|
/// </returns>
|
||
|
public virtual OverwritePermissions? GetPermissionOverwrite(IRole role)
|
||
|
{
|
||
|
for (int i = 0; i < _overwrites.Length; i++)
|
||
|
{
|
||
|
if (_overwrites[i].TargetId == role.Id)
|
||
|
return _overwrites[i].Permissions;
|
||
|
}
|
||
|
return null;
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Adds or updates the permission overwrite for the given user.
|
||
|
/// </summary>
|
||
|
/// <param name="user">The user to add the overwrite to.</param>
|
||
|
/// <param name="permissions">The overwrite to add to the user.</param>
|
||
|
/// <param name="options">The options to be used when sending the request.</param>
|
||
|
/// <returns>
|
||
|
/// A task representing the asynchronous permission operation for adding the specified permissions to the channel.
|
||
|
/// </returns>
|
||
|
public virtual async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options = null)
|
||
|
{
|
||
|
await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, user, permissions, options).ConfigureAwait(false);
|
||
|
_overwrites = _overwrites.Add(new Overwrite(user.Id, PermissionTarget.User, new OverwritePermissions(permissions.AllowValue, permissions.DenyValue)));
|
||
|
}
|
||
|
/// <summary>
|
||
|
/// Adds or updates the permission overwrite for the given role.
|
||
|
/// </summary>
|
||
|
/// <param name="role">The role to add the overwrite to.</param>
|
||
|
/// <param name="permissions">The overwrite to add to the role.</param>
|
||
|
/// <param name="options">The options to be used when sending the request.</param>
|
||
|
/// <returns>
|
||
|
/// A task representing the asynchronous permission operation for adding the specified permissions to the channel.
|
||
|
/// </returns>
|
||
|
public virtual async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options = null)
|
||
|
{
|
||
|
await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, role, permissions, options).ConfigureAwait(false);
|
||
|
_overwrites = _overwrites.Add(new Overwrite(role.Id, PermissionTarget.Role, new OverwritePermissions(permissions.AllowValue, permissions.DenyValue)));
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Removes the permission overwrite for the given user, if one exists.
|
||
|
/// </summary>
|
||
|
/// <param name="user">The user to remove the overwrite from.</param>
|
||
|
/// <param name="options">The options to be used when sending the request.</param>
|
||
|
/// <returns>
|
||
|
/// A task representing the asynchronous operation for removing the specified permissions from the channel.
|
||
|
/// </returns>
|
||
|
public virtual async Task RemovePermissionOverwriteAsync(IUser user, RequestOptions options = null)
|
||
|
{
|
||
|
await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, user, options).ConfigureAwait(false);
|
||
|
|
||
|
for (int i = 0; i < _overwrites.Length; i++)
|
||
|
{
|
||
|
if (_overwrites[i].TargetId == user.Id)
|
||
|
{
|
||
|
_overwrites = _overwrites.RemoveAt(i);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/// <summary>
|
||
|
/// Removes the permission overwrite for the given role, if one exists.
|
||
|
/// </summary>
|
||
|
/// <param name="role">The role to remove the overwrite from.</param>
|
||
|
/// <param name="options">The options to be used when sending the request.</param>
|
||
|
/// <returns>
|
||
|
/// A task representing the asynchronous operation for removing the specified permissions from the channel.
|
||
|
/// </returns>
|
||
|
public virtual async Task RemovePermissionOverwriteAsync(IRole role, RequestOptions options = null)
|
||
|
{
|
||
|
await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, role, options).ConfigureAwait(false);
|
||
|
|
||
|
for (int i = 0; i < _overwrites.Length; i++)
|
||
|
{
|
||
|
if (_overwrites[i].TargetId == role.Id)
|
||
|
{
|
||
|
_overwrites = _overwrites.RemoveAt(i);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/// <summary>
|
||
|
/// Gets the name of this channel.
|
||
|
/// </summary>
|
||
|
/// <returns>
|
||
|
/// A string that is the name of this channel.
|
||
|
/// </returns>
|
||
|
public override string ToString() => Name;
|
||
|
|
||
|
//IGuildChannel
|
||
|
/// <inheritdoc />
|
||
|
IGuild IGuildChannel.Guild
|
||
|
{
|
||
|
get
|
||
|
{
|
||
|
if (Guild != null)
|
||
|
return Guild;
|
||
|
throw new InvalidOperationException("Unable to return this entity's parent unless it was fetched through that object.");
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/// <inheritdoc />
|
||
|
OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IRole role)
|
||
|
=> GetPermissionOverwrite(role);
|
||
|
/// <inheritdoc />
|
||
|
OverwritePermissions? IGuildChannel.GetPermissionOverwrite(IUser user)
|
||
|
=> GetPermissionOverwrite(user);
|
||
|
/// <inheritdoc />
|
||
|
async Task IGuildChannel.AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options)
|
||
|
=> await AddPermissionOverwriteAsync(role, permissions, options).ConfigureAwait(false);
|
||
|
/// <inheritdoc />
|
||
|
async Task IGuildChannel.AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options)
|
||
|
=> await AddPermissionOverwriteAsync(user, permissions, options).ConfigureAwait(false);
|
||
|
/// <inheritdoc />
|
||
|
async Task IGuildChannel.RemovePermissionOverwriteAsync(IRole role, RequestOptions options)
|
||
|
=> await RemovePermissionOverwriteAsync(role, options).ConfigureAwait(false);
|
||
|
/// <inheritdoc />
|
||
|
async Task IGuildChannel.RemovePermissionOverwriteAsync(IUser user, RequestOptions options)
|
||
|
=> await RemovePermissionOverwriteAsync(user, options).ConfigureAwait(false);
|
||
|
|
||
|
/// <inheritdoc />
|
||
|
IAsyncEnumerable<IReadOnlyCollection<IGuildUser>> IGuildChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
|
||
|
=> AsyncEnumerable.Empty<IReadOnlyCollection<IGuildUser>>(); //Overridden //Overridden in Text/Voice
|
||
|
/// <inheritdoc />
|
||
|
Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
|
||
|
=> Task.FromResult<IGuildUser>(null); //Overridden in Text/Voice
|
||
|
|
||
|
//IChannel
|
||
|
/// <inheritdoc />
|
||
|
IAsyncEnumerable<IReadOnlyCollection<IUser>> IChannel.GetUsersAsync(CacheMode mode, RequestOptions options)
|
||
|
=> AsyncEnumerable.Empty<IReadOnlyCollection<IUser>>(); //Overridden in Text/Voice
|
||
|
/// <inheritdoc />
|
||
|
Task<IUser> IChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
|
||
|
=> Task.FromResult<IUser>(null); //Overridden in Text/Voice
|
||
|
}
|
||
|
}
|