Moves the reaction-related methods contained in IUserMessage to the IReactionMessage type. Updates the type of ISystemMessage so that it implements IReactionMessage.pull/1368/head
| @@ -0,0 +1,98 @@ | |||
| using System; | |||
| using System.Collections.Generic; | |||
| using System.Linq; | |||
| using System.Text; | |||
| using System.Threading.Tasks; | |||
| namespace Discord | |||
| { | |||
| /// <summary> | |||
| /// Represents a message that can be reacted to. | |||
| /// </summary> | |||
| public interface IReactionMessage : IMessage | |||
| { | |||
| /// <summary> | |||
| /// Gets all reactions included in this message. | |||
| /// </summary> | |||
| IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions { get; } | |||
| /// <summary> | |||
| /// Adds a reaction to this message. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example adds the reaction, <c>💕</c>, to the message. | |||
| /// <code language="cs"> | |||
| /// await msg.AddReactionAsync(new Emoji("\U0001f495")); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emote">The emoji used to react to this message.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for adding a reaction to this message. | |||
| /// </returns> | |||
| /// <seealso cref="IEmote"/> | |||
| Task AddReactionAsync(IEmote emote, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Removes a reaction from message. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example removes the reaction, <c>💕</c>, added by the message author from the message. | |||
| /// <code language="cs"> | |||
| /// await msg.RemoveReactionAsync(new Emoji("\U0001f495"), msg.Author); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emote">The emoji used to react to this message.</param> | |||
| /// <param name="user">The user that added the emoji.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for removing a reaction to this message. | |||
| /// </returns> | |||
| /// <seealso cref="IEmote"/> | |||
| Task RemoveReactionAsync(IEmote emote, IUser user, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Removes a reaction from message. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example removes the reaction, <c>💕</c>, added by the user with ID 84291986575613952 from the message. | |||
| /// <code language="cs"> | |||
| /// await msg.RemoveReactionAsync(new Emoji("\U0001f495"), 84291986575613952); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emote">The emoji used to react to this message.</param> | |||
| /// <param name="userId">The ID of the user that added the emoji.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for removing a reaction to this message. | |||
| /// </returns> | |||
| /// <seealso cref="IEmote"/> | |||
| Task RemoveReactionAsync(IEmote emote, ulong userId, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Removes all reactions from this message. | |||
| /// </summary> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous removal operation. | |||
| /// </returns> | |||
| Task RemoveAllReactionsAsync(RequestOptions options = null); | |||
| /// <summary> | |||
| /// Gets all users that reacted to a message with a given emote. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example gets the users that have reacted with the emoji <c>💕</c> to the message. | |||
| /// <code language="cs"> | |||
| /// var emoji = new Emoji("\U0001f495"); | |||
| /// var reactedUsers = await message.GetReactionUsersAsync(emoji, 100).FlattenAsync(); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emoji">The emoji that represents the reaction that you wish to get.</param> | |||
| /// <param name="limit">The number of users to request.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A paged collection containing a read-only collection of users that has reacted to this message. | |||
| /// Flattening the paginated response into a collection of users with | |||
| /// <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> is required if you wish to access the users. | |||
| /// </returns> | |||
| IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IEmote emoji, int limit, RequestOptions options = null); | |||
| } | |||
| } | |||
| @@ -3,7 +3,7 @@ namespace Discord | |||
| /// <summary> | |||
| /// Represents a generic message sent by the system. | |||
| /// </summary> | |||
| public interface ISystemMessage : IMessage | |||
| public interface ISystemMessage : IReactionMessage | |||
| { | |||
| } | |||
| } | |||
| @@ -7,7 +7,7 @@ namespace Discord | |||
| /// <summary> | |||
| /// Represents a generic message sent by a user. | |||
| /// </summary> | |||
| public interface IUserMessage : IMessage | |||
| public interface IUserMessage : IReactionMessage | |||
| { | |||
| /// <summary> | |||
| /// Modifies this message. | |||
| @@ -57,90 +57,6 @@ namespace Discord | |||
| /// </returns> | |||
| Task UnpinAsync(RequestOptions options = null); | |||
| /// <summary> | |||
| /// Gets all reactions included in this message. | |||
| /// </summary> | |||
| IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions { get; } | |||
| /// <summary> | |||
| /// Adds a reaction to this message. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example adds the reaction, <c>💕</c>, to the message. | |||
| /// <code language="cs"> | |||
| /// await msg.AddReactionAsync(new Emoji("\U0001f495")); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emote">The emoji used to react to this message.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for adding a reaction to this message. | |||
| /// </returns> | |||
| /// <seealso cref="IEmote"/> | |||
| Task AddReactionAsync(IEmote emote, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Removes a reaction from message. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example removes the reaction, <c>💕</c>, added by the message author from the message. | |||
| /// <code language="cs"> | |||
| /// await msg.RemoveReactionAsync(new Emoji("\U0001f495"), msg.Author); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emote">The emoji used to react to this message.</param> | |||
| /// <param name="user">The user that added the emoji.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for removing a reaction to this message. | |||
| /// </returns> | |||
| /// <seealso cref="IEmote"/> | |||
| Task RemoveReactionAsync(IEmote emote, IUser user, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Removes a reaction from message. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example removes the reaction, <c>💕</c>, added by the user with ID 84291986575613952 from the message. | |||
| /// <code language="cs"> | |||
| /// await msg.RemoveReactionAsync(new Emoji("\U0001f495"), 84291986575613952); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emote">The emoji used to react to this message.</param> | |||
| /// <param name="userId">The ID of the user that added the emoji.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for removing a reaction to this message. | |||
| /// </returns> | |||
| /// <seealso cref="IEmote"/> | |||
| Task RemoveReactionAsync(IEmote emote, ulong userId, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Removes all reactions from this message. | |||
| /// </summary> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous removal operation. | |||
| /// </returns> | |||
| Task RemoveAllReactionsAsync(RequestOptions options = null); | |||
| /// <summary> | |||
| /// Gets all users that reacted to a message with a given emote. | |||
| /// </summary> | |||
| /// <example> | |||
| /// The following example gets the users that have reacted with the emoji <c>💕</c> to the message. | |||
| /// <code language="cs"> | |||
| /// var emoji = new Emoji("\U0001f495"); | |||
| /// var reactedUsers = await message.GetReactionUsersAsync(emoji, 100).FlattenAsync(); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="emoji">The emoji that represents the reaction that you wish to get.</param> | |||
| /// <param name="limit">The number of users to request.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A paged collection containing a read-only collection of users that has reacted to this message. | |||
| /// Flattening the paginated response into a collection of users with | |||
| /// <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> is required if you wish to access the users. | |||
| /// </returns> | |||
| IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IEmote emoji, int limit, RequestOptions options = null); | |||
| /// <summary> | |||
| /// Transforms this message's text into a human-readable form by resolving its tags. | |||
| /// </summary> | |||