|
- 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
- {
- #region RestGuildChannel
- 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)
- {
- return model.Type switch
- {
- ChannelType.News => RestNewsChannel.Create(discord, guild, model),
- ChannelType.Text => RestTextChannel.Create(discord, guild, model),
- ChannelType.Voice => RestVoiceChannel.Create(discord, guild, model),
- ChannelType.Stage => RestStageChannel.Create(discord, guild, model),
- ChannelType.Forum => RestForumChannel.Create(discord, guild, model),
- ChannelType.Category => RestCategoryChannel.Create(discord, guild, model),
- ChannelType.PublicThread or ChannelType.PrivateThread or ChannelType.NewsThread => RestThreadChannel.Create(discord, guild, model),
- _ => new RestGuildChannel(discord, guild, model.Id),
- };
- }
- internal override void Update(Model model)
- {
- Name = model.Name.Value;
-
- if (model.Position.IsSpecified)
- {
- Position = model.Position.Value;
- }
-
- if (model.PermissionOverwrites.IsSpecified)
- {
- 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;
- #endregion
-
- #region 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 in Text/Voice
- /// <inheritdoc />
- Task<IGuildUser> IGuildChannel.GetUserAsync(ulong id, CacheMode mode, RequestOptions options)
- => Task.FromResult<IGuildUser>(null); //Overridden in Text/Voice
- #endregion
-
- #region 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
- #endregion
- }
- }
|