| @@ -2,9 +2,9 @@ | |||||
| [](https://www.nuget.org/packages/Discord.Net) | [](https://www.nuget.org/packages/Discord.Net) | ||||
| [](https://www.myget.org/feed/Packages/discord-net) | [](https://www.myget.org/feed/Packages/discord-net) | ||||
| [](https://dev.azure.com/discord-net/Discord.Net/_build/latest?definitionId=1&branchName=dev) | [](https://dev.azure.com/discord-net/Discord.Net/_build/latest?definitionId=1&branchName=dev) | ||||
| [](https://discord.gg/jkrBmQR) | |||||
| [](https://discord.gg/jkrBmQR) | |||||
| An unofficial .NET API Wrapper for the Discord client (http://discordapp.com). | |||||
| An unofficial .NET API Wrapper for the Discord client (https://discord.com). | |||||
| Check out the [documentation](https://discord.foxbot.me/) or join the [Discord API Chat](https://discord.gg/jkrBmQR). | Check out the [documentation](https://discord.foxbot.me/) or join the [Discord API Chat](https://discord.gg/jkrBmQR). | ||||
| @@ -4,10 +4,10 @@ field, and 2 normal fields using an @Discord.EmbedBuilder: | |||||
| ```cs | ```cs | ||||
| var exampleAuthor = new EmbedAuthorBuilder() | var exampleAuthor = new EmbedAuthorBuilder() | ||||
| .WithName("I am a bot") | .WithName("I am a bot") | ||||
| .WithIconUrl("https://discordapp.com/assets/e05ead6e6ebc08df9291738d0aa6986d.png"); | |||||
| .WithIconUrl("https://discord.com/assets/e05ead6e6ebc08df9291738d0aa6986d.png"); | |||||
| var exampleFooter = new EmbedFooterBuilder() | var exampleFooter = new EmbedFooterBuilder() | ||||
| .WithText("I am a nice footer") | .WithText("I am a nice footer") | ||||
| .WithIconUrl("https://discordapp.com/assets/28174a34e77bb5e5310ced9f95cb480b.png"); | |||||
| .WithIconUrl("https://discord.com/assets/28174a34e77bb5e5310ced9f95cb480b.png"); | |||||
| var exampleField = new EmbedFieldBuilder() | var exampleField = new EmbedFieldBuilder() | ||||
| .WithName("Title of Another Field") | .WithName("Title of Another Field") | ||||
| .WithValue("I am an [example](https://example.com).") | .WithValue("I am an [example](https://example.com).") | ||||
| @@ -22,4 +22,4 @@ var embed = new EmbedBuilder() | |||||
| .WithAuthor(exampleAuthor) | .WithAuthor(exampleAuthor) | ||||
| .WithFooter(exampleFooter) | .WithFooter(exampleFooter) | ||||
| .Build(); | .Build(); | ||||
| ``` | |||||
| ``` | |||||
| @@ -30,7 +30,7 @@ There are few possible reasons why this may occur. | |||||
| [TokenType]: xref:Discord.TokenType | [TokenType]: xref:Discord.TokenType | ||||
| [827]: https://github.com/RogueException/Discord.Net/issues/827 | [827]: https://github.com/RogueException/Discord.Net/issues/827 | ||||
| [958]: https://github.com/RogueException/Discord.Net/issues/958 | [958]: https://github.com/RogueException/Discord.Net/issues/958 | ||||
| [Discord API Terms of Service]: https://discordapp.com/developers/docs/legal | |||||
| [Discord API Terms of Service]: https://discord.com/developers/docs/legal | |||||
| ## How do I do X, Y, Z when my bot connects/logs on? Why do I get a `NullReferenceException` upon calling any client methods after connect? | ## How do I do X, Y, Z when my bot connects/logs on? Why do I get a `NullReferenceException` upon calling any client methods after connect? | ||||
| @@ -19,7 +19,7 @@ channels, and are often referred to as "servers". | |||||
| * A **Channel** ([IChannel]) represents a generic channel. | * A **Channel** ([IChannel]) represents a generic channel. | ||||
| - Example: #dotnet_discord-net | - Example: #dotnet_discord-net | ||||
| - See [Channel Types](#channel-types) | - See [Channel Types](#channel-types) | ||||
| [IGuild]: xref:Discord.IGuild | [IGuild]: xref:Discord.IGuild | ||||
| [IChannel]: xref:Discord.IChannel | [IChannel]: xref:Discord.IChannel | ||||
| @@ -79,4 +79,4 @@ activity for listening to a song on Spotify. | |||||
| [RichGame]: xref:Discord.RichGame | [RichGame]: xref:Discord.RichGame | ||||
| [StreamingGame]: xref:Discord.StreamingGame | [StreamingGame]: xref:Discord.StreamingGame | ||||
| [SpotifyGame]: xref:Discord.SpotifyGame | [SpotifyGame]: xref:Discord.SpotifyGame | ||||
| [Rich Presence Intro]: https://discordapp.com/developers/docs/rich-presence/best-practices | |||||
| [Rich Presence Intro]: https://discord.com/developers/docs/rich-presence/best-practices | |||||
| @@ -31,7 +31,7 @@ the Discord Applications Portal first. | |||||
|  |  | ||||
| [Discord Applications Portal]: https://discordapp.com/developers/applications/ | |||||
| [Discord Applications Portal]: https://discord.com/developers/applications/ | |||||
| ## Adding your bot to a server | ## Adding your bot to a server | ||||
| @@ -165,11 +165,11 @@ or any other blocking method, such as reading from the console. | |||||
| > the source code for your bot. | > the source code for your bot. | ||||
| > | > | ||||
| > In the following example, we retrieve the token from a pre-defined | > In the following example, we retrieve the token from a pre-defined | ||||
| > variable, which is **NOT** secure, especially if you plan on | |||||
| > variable, which is **NOT** secure, especially if you plan on | |||||
| > distributing the application in any shape or form. | > distributing the application in any shape or form. | ||||
| > | > | ||||
| > We recommend alternative storage such as | |||||
| > [Environment Variables], an external configuration file, or a | |||||
| > We recommend alternative storage such as | |||||
| > [Environment Variables], an external configuration file, or a | |||||
| > secrets manager for safe-handling of secrets. | > secrets manager for safe-handling of secrets. | ||||
| > | > | ||||
| > [Environment Variables]: https://en.wikipedia.org/wiki/Environment_variable | > [Environment Variables]: https://en.wikipedia.org/wiki/Environment_variable | ||||
| @@ -221,4 +221,4 @@ should be to separate... | |||||
| 2. the modules (handle commands) | 2. the modules (handle commands) | ||||
| 3. the services (persistent storage, pure functions, data manipulation) | 3. the services (persistent storage, pure functions, data manipulation) | ||||
| [CommandService]: xref:Discord.Commands.CommandService | |||||
| [CommandService]: xref:Discord.Commands.CommandService | |||||
| @@ -11,12 +11,12 @@ title: Home | |||||
| [](https://www.nuget.org/packages/Discord.Net) | [](https://www.nuget.org/packages/Discord.Net) | ||||
| [](https://www.myget.org/feed/Packages/discord-net) | [](https://www.myget.org/feed/Packages/discord-net) | ||||
| [](https://dev.azure.com/discord-net/Discord.Net/_build/latest?definitionId=1&branchName=dev) | [](https://dev.azure.com/discord-net/Discord.Net/_build/latest?definitionId=1&branchName=dev) | ||||
| [](https://discord.gg/jkrBmQR) | |||||
| [](https://discord.gg/jkrBmQR) | |||||
| ## What is Discord.Net? | ## What is Discord.Net? | ||||
| Discord.Net is an asynchronous, multi-platform .NET Library used to | Discord.Net is an asynchronous, multi-platform .NET Library used to | ||||
| interface with the [Discord API](https://discordapp.com/). | |||||
| interface with the [Discord API](https://discord.com/). | |||||
| ## Where to begin? | ## Where to begin? | ||||
| @@ -14,10 +14,10 @@ namespace _04_webhook_client | |||||
| public async Task MainAsync() | public async Task MainAsync() | ||||
| { | { | ||||
| // The webhook url follows the format https://discordapp.com/api/webhooks/{id}/{token} | |||||
| // The webhook url follows the format https://discord.com/api/webhooks/{id}/{token} | |||||
| // Because anyone with the webhook URL can use your webhook | // Because anyone with the webhook URL can use your webhook | ||||
| // you should NOT hard code the URL or ID + token into your application. | |||||
| using (var client = new DiscordWebhookClient("https://discordapp.com/api/webhooks/123/abc123")) | |||||
| // you should NOT hard code the URL or ID + token into your application. | |||||
| using (var client = new DiscordWebhookClient("https://discord.com/api/webhooks/123/abc123")) | |||||
| { | { | ||||
| var embed = new EmbedBuilder | var embed = new EmbedBuilder | ||||
| { | { | ||||
| @@ -26,7 +26,7 @@ namespace _04_webhook_client | |||||
| }; | }; | ||||
| // Webhooks are able to send multiple embeds per message | // Webhooks are able to send multiple embeds per message | ||||
| // As such, your embeds must be passed as a collection. | |||||
| // As such, your embeds must be passed as a collection. | |||||
| await client.SendMessageAsync(text: "Send a message to this webhook!", embeds: new[] { embed.Build() }); | await client.SendMessageAsync(text: "Send a message to this webhook!", embeds: new[] { embed.Build() }); | ||||
| } | } | ||||
| } | } | ||||
| @@ -1,4 +1,5 @@ | |||||
| using System; | |||||
| using System; | |||||
| using System.Collections.Generic; | |||||
| using System.Threading.Tasks; | using System.Threading.Tasks; | ||||
| namespace Discord.Audio | namespace Discord.Audio | ||||
| @@ -20,6 +21,9 @@ namespace Discord.Audio | |||||
| /// <summary> Gets the estimated round-trip latency, in milliseconds, to the voice UDP server. </summary> | /// <summary> Gets the estimated round-trip latency, in milliseconds, to the voice UDP server. </summary> | ||||
| int UdpLatency { get; } | int UdpLatency { get; } | ||||
| /// <summary>Gets the current audio streams.</summary> | |||||
| IReadOnlyDictionary<ulong, AudioInStream> GetStreams(); | |||||
| Task StopAsync(); | Task StopAsync(); | ||||
| Task SetSpeakingAsync(bool value); | Task SetSpeakingAsync(bool value); | ||||
| @@ -7,6 +7,17 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| public static class CDN | public static class CDN | ||||
| { | { | ||||
| /// <summary> | |||||
| /// Returns a team icon URL. | |||||
| /// </summary> | |||||
| /// <param name="teamId">The team identifier.</param> | |||||
| /// <param name="iconId">The icon identifier.</param> | |||||
| /// <returns> | |||||
| /// A URL pointing to the team's icon. | |||||
| /// </returns> | |||||
| public static string GetTeamIconUrl(ulong teamId, string iconId) | |||||
| => iconId != null ? $"{DiscordConfig.CDNUrl}team-icons/{teamId}/{iconId}.jpg" : null; | |||||
| /// <summary> | /// <summary> | ||||
| /// Returns an application icon URL. | /// Returns an application icon URL. | ||||
| /// </summary> | /// </summary> | ||||
| @@ -62,11 +73,21 @@ namespace Discord | |||||
| /// <param name="guildId">The guild snowflake identifier.</param> | /// <param name="guildId">The guild snowflake identifier.</param> | ||||
| /// <param name="splashId">The splash icon identifier.</param> | /// <param name="splashId">The splash icon identifier.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A URL pointing to the guild's icon. | |||||
| /// A URL pointing to the guild's splash. | |||||
| /// </returns> | /// </returns> | ||||
| public static string GetGuildSplashUrl(ulong guildId, string splashId) | public static string GetGuildSplashUrl(ulong guildId, string splashId) | ||||
| => splashId != null ? $"{DiscordConfig.CDNUrl}splashes/{guildId}/{splashId}.jpg" : null; | => splashId != null ? $"{DiscordConfig.CDNUrl}splashes/{guildId}/{splashId}.jpg" : null; | ||||
| /// <summary> | /// <summary> | ||||
| /// Returns a guild discovery splash URL. | |||||
| /// </summary> | |||||
| /// <param name="guildId">The guild snowflake identifier.</param> | |||||
| /// <param name="discoverySplashId">The discovery splash icon identifier.</param> | |||||
| /// <returns> | |||||
| /// A URL pointing to the guild's discovery splash. | |||||
| /// </returns> | |||||
| public static string GetGuildDiscoverySplashUrl(ulong guildId, string discoverySplashId) | |||||
| => discoverySplashId != null ? $"{DiscordConfig.CDNUrl}discovery-splashes/{guildId}/{discoverySplashId}.jpg" : null; | |||||
| /// <summary> | |||||
| /// Returns a channel icon URL. | /// Returns a channel icon URL. | ||||
| /// </summary> | /// </summary> | ||||
| /// <param name="channelId">The channel snowflake identifier.</param> | /// <param name="channelId">The channel snowflake identifier.</param> | ||||
| @@ -13,7 +13,7 @@ namespace Discord | |||||
| /// <returns> | /// <returns> | ||||
| /// An <see cref="int"/> representing the API version that Discord.Net uses to communicate with Discord. | /// An <see cref="int"/> representing the API version that Discord.Net uses to communicate with Discord. | ||||
| /// <para>A list of available API version can be seen on the official | /// <para>A list of available API version can be seen on the official | ||||
| /// <see href="https://discordapp.com/developers/docs/reference#api-versioning">Discord API documentation</see> | |||||
| /// <see href="https://discord.com/developers/docs/reference#api-versioning">Discord API documentation</see> | |||||
| /// .</para> | /// .</para> | ||||
| /// </returns> | /// </returns> | ||||
| public const int APIVersion = 6; | public const int APIVersion = 6; | ||||
| @@ -50,7 +50,7 @@ namespace Discord | |||||
| /// <returns> | /// <returns> | ||||
| /// The Discord API URL using <see cref="APIVersion"/>. | /// The Discord API URL using <see cref="APIVersion"/>. | ||||
| /// </returns> | /// </returns> | ||||
| public static readonly string APIUrl = $"https://discordapp.com/api/v{APIVersion}/"; | |||||
| public static readonly string APIUrl = $"https://discord.com/api/v{APIVersion}/"; | |||||
| /// <summary> | /// <summary> | ||||
| /// Returns the base Discord CDN URL. | /// Returns the base Discord CDN URL. | ||||
| /// </summary> | /// </summary> | ||||
| @@ -28,7 +28,7 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| /// <remarks> | /// <remarks> | ||||
| /// Setting this value to a category's snowflake identifier will change or set this channel's parent to the | /// Setting this value to a category's snowflake identifier will change or set this channel's parent to the | ||||
| /// specified channel; setting this value to <c>0</c> will detach this channel from its parent if one | |||||
| /// specified channel; setting this value to <see langword="null"/> will detach this channel from its parent if one | |||||
| /// is set. | /// is set. | ||||
| /// </remarks> | /// </remarks> | ||||
| public Optional<ulong?> CategoryId { get; set; } | public Optional<ulong?> CategoryId { get; set; } | ||||
| @@ -0,0 +1,9 @@ | |||||
| namespace Discord | |||||
| { | |||||
| /// <summary> | |||||
| /// Represents a generic news channel in a guild that can send and receive messages. | |||||
| /// </summary> | |||||
| public interface INewsChannel : ITextChannel | |||||
| { | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,21 @@ | |||||
| namespace Discord | |||||
| { | |||||
| /// <summary> | |||||
| /// Provides properties that are used to modify the widget of an <see cref="IGuild" /> with the specified changes. | |||||
| /// </summary> | |||||
| public class GuildWidgetProperties | |||||
| { | |||||
| /// <summary> | |||||
| /// Sets whether the widget should be enabled. | |||||
| /// </summary> | |||||
| public Optional<bool> Enabled { get; set; } | |||||
| /// <summary> | |||||
| /// Sets the channel that the invite should place its users in, if not <see langword="null" />. | |||||
| /// </summary> | |||||
| public Optional<IChannel> Channel { get; set; } | |||||
| /// <summary> | |||||
| /// Sets the channel that the invite should place its users in, if not <see langword="null" />. | |||||
| /// </summary> | |||||
| public Optional<ulong?> ChannelId { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -23,7 +23,7 @@ namespace Discord | |||||
| /// automatically moved to the AFK voice channel. | /// automatically moved to the AFK voice channel. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// An <see cref="int"/> representing the amount of time in seconds for a user to be marked as inactive | |||||
| /// An <see langword="int"/> representing the amount of time in seconds for a user to be marked as inactive | |||||
| /// and moved into the AFK voice channel. | /// and moved into the AFK voice channel. | ||||
| /// </returns> | /// </returns> | ||||
| int AFKTimeout { get; } | int AFKTimeout { get; } | ||||
| @@ -31,10 +31,17 @@ namespace Discord | |||||
| /// Gets a value that indicates whether this guild is embeddable (i.e. can use widget). | /// Gets a value that indicates whether this guild is embeddable (i.e. can use widget). | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// <c>true</c> if this guild can be embedded via widgets; otherwise <c>false</c>. | |||||
| /// <see langword="true" /> if this guild has a widget enabled; otherwise <see langword="false" />. | |||||
| /// </returns> | /// </returns> | ||||
| bool IsEmbeddable { get; } | bool IsEmbeddable { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets a value that indicates whether this guild has the widget enabled. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// <see langword="true" /> if this guild has a widget enabled; otherwise <see langword="false" />. | |||||
| /// </returns> | |||||
| bool IsWidgetEnabled { get; } | |||||
| /// <summary> | |||||
| /// Gets the default message notifications for users who haven't explicitly set their notification settings. | /// Gets the default message notifications for users who haven't explicitly set their notification settings. | ||||
| /// </summary> | /// </summary> | ||||
| DefaultMessageNotifications DefaultMessageNotifications { get; } | DefaultMessageNotifications DefaultMessageNotifications { get; } | ||||
| @@ -64,31 +71,45 @@ namespace Discord | |||||
| /// Gets the ID of this guild's icon. | /// Gets the ID of this guild's icon. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// An identifier for the splash image; <c>null</c> if none is set. | |||||
| /// An identifier for the splash image; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string IconId { get; } | string IconId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the URL of this guild's icon. | /// Gets the URL of this guild's icon. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A URL pointing to the guild's icon; <c>null</c> if none is set. | |||||
| /// A URL pointing to the guild's icon; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string IconUrl { get; } | string IconUrl { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of this guild's splash image. | /// Gets the ID of this guild's splash image. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// An identifier for the splash image; <c>null</c> if none is set. | |||||
| /// An identifier for the splash image; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string SplashId { get; } | string SplashId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the URL of this guild's splash image. | /// Gets the URL of this guild's splash image. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A URL pointing to the guild's splash image; <c>null</c> if none is set. | |||||
| /// A URL pointing to the guild's splash image; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string SplashUrl { get; } | string SplashUrl { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of this guild's discovery splash image. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// An identifier for the discovery splash image; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| string DiscoverySplashId { get; } | |||||
| /// <summary> | |||||
| /// Gets the URL of this guild's discovery splash image. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A URL pointing to the guild's discovery splash image; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| string DiscoverySplashUrl { get; } | |||||
| /// <summary> | |||||
| /// Determines if this guild is currently connected and ready to be used. | /// Determines if this guild is currently connected and ready to be used. | ||||
| /// </summary> | /// </summary> | ||||
| /// <remarks> | /// <remarks> | ||||
| @@ -98,7 +119,7 @@ namespace Discord | |||||
| /// This boolean is used to determine if the guild is currently connected to the WebSocket and is ready to be used/accessed. | /// This boolean is used to determine if the guild is currently connected to the WebSocket and is ready to be used/accessed. | ||||
| /// </remarks> | /// </remarks> | ||||
| /// <returns> | /// <returns> | ||||
| /// <c>true</c> if this guild is currently connected and ready to be used; otherwise <c>false</c>. | |||||
| /// <c>true</c> if this guild is currently connected and ready to be used; otherwise <see langword="false"/>. | |||||
| /// </returns> | /// </returns> | ||||
| bool Available { get; } | bool Available { get; } | ||||
| @@ -106,7 +127,7 @@ namespace Discord | |||||
| /// Gets the ID of the AFK voice channel for this guild. | /// Gets the ID of the AFK voice channel for this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="ulong"/> representing the snowflake identifier of the AFK voice channel; <c>null</c> if | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the AFK voice channel; <see langword="null" /> if | |||||
| /// none is set. | /// none is set. | ||||
| /// </returns> | /// </returns> | ||||
| ulong? AFKChannelId { get; } | ulong? AFKChannelId { get; } | ||||
| @@ -121,7 +142,7 @@ namespace Discord | |||||
| /// </note> | /// </note> | ||||
| /// </remarks> | /// </remarks> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="ulong"/> representing the snowflake identifier of the default text channel; <c>0</c> if | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the default text channel; <c>0</c> if | |||||
| /// none can be found. | /// none can be found. | ||||
| /// </returns> | /// </returns> | ||||
| ulong DefaultChannelId { get; } | ulong DefaultChannelId { get; } | ||||
| @@ -129,30 +150,54 @@ namespace Discord | |||||
| /// Gets the ID of the widget embed channel of this guild. | /// Gets the ID of the widget embed channel of this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="ulong"/> representing the snowflake identifier of the embedded channel found within the | |||||
| /// widget settings of this guild; <c>null</c> if none is set. | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the embedded channel found within the | |||||
| /// widget settings of this guild; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| ulong? EmbedChannelId { get; } | ulong? EmbedChannelId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of the channel assigned to the widget of this guild. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the channel assigned to the widget found | |||||
| /// within the widget settings of this guild; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| ulong? WidgetChannelId { get; } | |||||
| /// <summary> | |||||
| /// Gets the ID of the channel where randomized welcome messages are sent. | /// Gets the ID of the channel where randomized welcome messages are sent. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="ulong"/> representing the snowflake identifier of the system channel where randomized | |||||
| /// welcome messages are sent; <c>null</c> if none is set. | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the system channel where randomized | |||||
| /// welcome messages are sent; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| ulong? SystemChannelId { get; } | ulong? SystemChannelId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of the channel with the rules. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the channel that contains the rules; | |||||
| /// <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| ulong? RulesChannelId { get; } | |||||
| /// <summary> | |||||
| /// Gets the ID of the channel where admins and moderators of Community guilds receive notices from Discord. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the channel where admins and moderators | |||||
| /// of Community guilds receive notices from Discord; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| ulong? PublicUpdatesChannelId { get; } | |||||
| /// <summary> | |||||
| /// Gets the ID of the user that owns this guild. | /// Gets the ID of the user that owns this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="ulong"/> representing the snowflake identifier of the user that owns this guild. | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the user that owns this guild. | |||||
| /// </returns> | /// </returns> | ||||
| ulong OwnerId { get; } | ulong OwnerId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the application ID of the guild creator if it is bot-created. | /// Gets the application ID of the guild creator if it is bot-created. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="ulong"/> representing the snowflake identifier of the application ID that created this guild, or <c>null</c> if it was not bot-created. | |||||
| /// A <see langword="ulong"/> representing the snowflake identifier of the application ID that created this guild, or <see langword="null" /> if it was not bot-created. | |||||
| /// </returns> | /// </returns> | ||||
| ulong? ApplicationId { get; } | ulong? ApplicationId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -208,21 +253,21 @@ namespace Discord | |||||
| /// Gets the identifier for this guilds banner image. | /// Gets the identifier for this guilds banner image. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// An identifier for the banner image; <c>null</c> if none is set. | |||||
| /// An identifier for the banner image; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string BannerId { get; } | string BannerId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the URL of this guild's banner image. | /// Gets the URL of this guild's banner image. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A URL pointing to the guild's banner image; <c>null</c> if none is set. | |||||
| /// A URL pointing to the guild's banner image; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string BannerUrl { get; } | string BannerUrl { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the code for this guild's vanity invite URL. | /// Gets the code for this guild's vanity invite URL. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A string containing the vanity invite code for this guild; <c>null</c> if none is set. | |||||
| /// A string containing the vanity invite code for this guild; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string VanityURLCode { get; } | string VanityURLCode { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -236,7 +281,7 @@ namespace Discord | |||||
| /// Gets the description for the guild. | /// Gets the description for the guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// The description for the guild; <c>null</c> if none is set. | |||||
| /// The description for the guild; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string Description { get; } | string Description { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -246,9 +291,50 @@ namespace Discord | |||||
| /// This is the number of users who have boosted this guild. | /// This is the number of users who have boosted this guild. | ||||
| /// </remarks> | /// </remarks> | ||||
| /// <returns> | /// <returns> | ||||
| /// The number of premium subscribers of this guild. | |||||
| /// The number of premium subscribers of this guild; <see langword="null" /> if not available. | |||||
| /// </returns> | /// </returns> | ||||
| int PremiumSubscriptionCount { get; } | int PremiumSubscriptionCount { get; } | ||||
| /// <summary> | |||||
| /// Gets the maximum number of presences for the guild. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// The maximum number of presences for the guild. | |||||
| /// </returns> | |||||
| int? MaxPresences { get; } | |||||
| /// <summary> | |||||
| /// Gets the maximum number of members for the guild. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// The maximum number of members for the guild. | |||||
| /// </returns> | |||||
| int? MaxMembers { get; } | |||||
| /// <summary> | |||||
| /// Gets the maximum amount of users in a video channel. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// The maximum amount of users in a video channel. | |||||
| /// </returns> | |||||
| int? MaxVideoChannelUsers { get; } | |||||
| /// <summary> | |||||
| /// Gets the approximate number of members in this guild. | |||||
| /// </summary> | |||||
| /// <remarks> | |||||
| /// Only available when getting a guild via REST when `with_counts` is true. | |||||
| /// </remarks> | |||||
| /// <returns> | |||||
| /// The approximate number of members in this guild. | |||||
| /// </returns> | |||||
| int? ApproximateMemberCount { get; } | |||||
| /// <summary> | |||||
| /// Gets the approximate number of non-offline members in this guild. | |||||
| /// </summary> | |||||
| /// <remarks> | |||||
| /// Only available when getting a guild via REST when `with_counts` is true. | |||||
| /// </remarks> | |||||
| /// <returns> | |||||
| /// The approximate number of non-offline members in this guild. | |||||
| /// </returns> | |||||
| int? ApproximatePresenceCount { get; } | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets the preferred locale of this guild in IETF BCP 47 | /// Gets the preferred locale of this guild in IETF BCP 47 | ||||
| @@ -285,8 +371,18 @@ namespace Discord | |||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous modification operation. | /// A task that represents the asynchronous modification operation. | ||||
| /// </returns> | /// </returns> | ||||
| [Obsolete("This endpoint is deprecated, use ModifyWidgetAsync instead.")] | |||||
| Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null); | Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Modifies this guild's widget. | |||||
| /// </summary> | |||||
| /// <param name="func">The delegate containing the properties to modify the guild widget with.</param> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous modification operation. | |||||
| /// </returns> | |||||
| Task ModifyWidgetAsync(Action<GuildWidgetProperties> func, RequestOptions options = null); | |||||
| /// <summary> | |||||
| /// Bulk-modifies the order of channels in this guild. | /// Bulk-modifies the order of channels in this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <param name="args">The properties used to modify the channel positions with.</param> | /// <param name="args">The properties used to modify the channel positions with.</param> | ||||
| @@ -336,7 +432,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains a ban object, which | /// A task that represents the asynchronous get operation. The task result contains a ban object, which | ||||
| /// contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found. | |||||
| /// contains the user information and the reason for the ban; <see langword="null" /> if the ban entry cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IBan> GetBanAsync(IUser user, RequestOptions options = null); | Task<IBan> GetBanAsync(IUser user, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -346,7 +442,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains a ban object, which | /// A task that represents the asynchronous get operation. The task result contains a ban object, which | ||||
| /// contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found. | |||||
| /// contains the user information and the reason for the ban; <see langword="null" /> if the ban entry cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IBan> GetBanAsync(ulong userId, RequestOptions options = null); | Task<IBan> GetBanAsync(ulong userId, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -410,7 +506,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the generic channel | /// A task that represents the asynchronous get operation. The task result contains the generic channel | ||||
| /// associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// associated with the specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IGuildChannel> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IGuildChannel> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -431,7 +527,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel | /// A task that represents the asynchronous get operation. The task result contains the text channel | ||||
| /// associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// associated with the specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<ITextChannel> GetTextChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<ITextChannel> GetTextChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -462,7 +558,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the voice channel associated | /// A task that represents the asynchronous get operation. The task result contains the voice channel associated | ||||
| /// with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// with the specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IVoiceChannel> GetVoiceChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IVoiceChannel> GetVoiceChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -472,7 +568,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the voice channel that the | /// A task that represents the asynchronous get operation. The task result contains the voice channel that the | ||||
| /// AFK users will be moved to after they have idled for too long; <c>null</c> if none is set. | |||||
| /// AFK users will be moved to after they have idled for too long; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IVoiceChannel> GetAFKChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IVoiceChannel> GetAFKChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -482,7 +578,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel where | /// A task that represents the asynchronous get operation. The task result contains the text channel where | ||||
| /// randomized welcome messages will be sent to; <c>null</c> if none is set. | |||||
| /// randomized welcome messages will be sent to; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| Task<ITextChannel> GetSystemChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<ITextChannel> GetSystemChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -492,7 +588,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the first viewable text | /// A task that represents the asynchronous get operation. The task result contains the first viewable text | ||||
| /// channel in this guild; <c>null</c> if none is found. | |||||
| /// channel in this guild; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<ITextChannel> GetDefaultChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<ITextChannel> GetDefaultChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -502,9 +598,40 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the embed channel set | /// A task that represents the asynchronous get operation. The task result contains the embed channel set | ||||
| /// within the server's widget settings; <c>null</c> if none is set. | |||||
| /// within the server's widget settings; <see langword="null" /> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| [Obsolete("This endpoint is deprecated, use GetWidgetChannelAsync instead.")] | |||||
| Task<IGuildChannel> GetEmbedChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IGuildChannel> GetEmbedChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | |||||
| /// Gets the widget channel (i.e. the channel set in the guild's widget settings) in this guild. | |||||
| /// </summary> | |||||
| /// <param name="mode">The <see cref="CacheMode" /> that determines whether the object should be fetched from cache.</param> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous get operation. The task result contains the widget channel set | |||||
| /// within the server's widget settings; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| Task<IGuildChannel> GetWidgetChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | |||||
| /// <summary> | |||||
| /// Gets the text channel where Community guilds can display rules and/or guidelines. | |||||
| /// </summary> | |||||
| /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel | |||||
| /// where Community guilds can display rules and/or guidelines; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| Task<ITextChannel> GetRulesChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | |||||
| /// <summary> | |||||
| /// Gets the text channel channel where admins and moderators of Community guilds receive notices from Discord. | |||||
| /// </summary> | |||||
| /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel channel where | |||||
| /// admins and moderators of Community guilds receive notices from Discord; <see langword="null" /> if none is set. | |||||
| /// </returns> | |||||
| Task<ITextChannel> GetPublicUpdatesChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | |||||
| /// <summary> | /// <summary> | ||||
| /// Creates a new text channel in this guild. | /// Creates a new text channel in this guild. | ||||
| @@ -573,7 +700,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the partial metadata of | /// A task that represents the asynchronous get operation. The task result contains the partial metadata of | ||||
| /// the vanity invite found within this guild; <c>null</c> if none is found. | |||||
| /// the vanity invite found within this guild; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IInviteMetadata> GetVanityInviteAsync(RequestOptions options = null); | Task<IInviteMetadata> GetVanityInviteAsync(RequestOptions options = null); | ||||
| @@ -582,7 +709,7 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the role.</param> | /// <param name="id">The snowflake identifier for the role.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A role that is associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// A role that is associated with the specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| IRole GetRole(ulong id); | IRole GetRole(ulong id); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -624,7 +751,7 @@ namespace Discord | |||||
| /// <param name="accessToken">The OAuth2 access token for the user, requested with the guilds.join scope.</param> | /// <param name="accessToken">The OAuth2 access token for the user, requested with the guilds.join scope.</param> | ||||
| /// <param name="func">The delegate containing the properties to be applied to the user upon being added to the guild.</param> | /// <param name="func">The delegate containing the properties to be applied to the user upon being added to the guild.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns>A guild user associated with the specified <paramref name="userId" />; <c>null</c> if the user is already in the guild.</returns> | |||||
| /// <returns>A guild user associated with the specified <paramref name="userId" />; <see langword="null" /> if the user is already in the guild.</returns> | |||||
| Task<IGuildUser> AddGuildUserAsync(ulong userId, string accessToken, Action<AddGuildUserProperties> func = null, RequestOptions options = null); | Task<IGuildUser> AddGuildUserAsync(ulong userId, string accessToken, Action<AddGuildUserProperties> func = null, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets a collection of all users in this guild. | /// Gets a collection of all users in this guild. | ||||
| @@ -649,7 +776,7 @@ namespace Discord | |||||
| /// <remarks> | /// <remarks> | ||||
| /// This method retrieves a user found within this guild. | /// This method retrieves a user found within this guild. | ||||
| /// <note> | /// <note> | ||||
| /// This may return <c>null</c> in the WebSocket implementation due to incomplete user collection in | |||||
| /// This may return <see langword="null" /> in the WebSocket implementation due to incomplete user collection in | |||||
| /// large guilds. | /// large guilds. | ||||
| /// </note> | /// </note> | ||||
| /// </remarks> | /// </remarks> | ||||
| @@ -658,7 +785,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the guild user | /// A task that represents the asynchronous get operation. The task result contains the guild user | ||||
| /// associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// associated with the specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IGuildUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IGuildUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -705,11 +832,12 @@ namespace Discord | |||||
| /// <param name="days">The number of days required for the users to be kicked.</param> | /// <param name="days">The number of days required for the users to be kicked.</param> | ||||
| /// <param name="simulate">Whether this prune action is a simulation.</param> | /// <param name="simulate">Whether this prune action is a simulation.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <param name="includeRoleIds">An array of role IDs to be included in the prune of users who do not have any additional roles.</param> | |||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous prune operation. The task result contains the number of users to | /// A task that represents the asynchronous prune operation. The task result contains the number of users to | ||||
| /// be or has been removed from this guild. | /// be or has been removed from this guild. | ||||
| /// </returns> | /// </returns> | ||||
| Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null); | |||||
| Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null, IEnumerable<ulong> includeRoleIds = null); | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets a collection of users in this guild that the name or nickname starts with the | /// Gets a collection of users in this guild that the name or nickname starts with the | ||||
| /// provided <see cref="string"/> at <paramref name="query"/>. | /// provided <see cref="string"/> at <paramref name="query"/>. | ||||
| @@ -751,7 +879,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the webhook with the | /// A task that represents the asynchronous get operation. The task result contains the webhook with the | ||||
| /// specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null); | Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -771,7 +899,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the emote found with the | /// A task that represents the asynchronous get operation. The task result contains the emote found with the | ||||
| /// specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// specified <paramref name="id"/>; <see langword="null" /> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null); | Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -22,6 +22,18 @@ namespace Discord | |||||
| /// Gets the icon URL of the application. | /// Gets the icon URL of the application. | ||||
| /// </summary> | /// </summary> | ||||
| string IconUrl { get; } | string IconUrl { get; } | ||||
| /// <summary> | |||||
| /// Gets if the bot is public. | |||||
| /// </summary> | |||||
| bool IsBotPublic { get; } | |||||
| /// <summary> | |||||
| /// Gets if the bot requires code grant. | |||||
| /// </summary> | |||||
| bool BotRequiresCodeGrant { get; } | |||||
| /// <summary> | |||||
| /// Gets the team associated with this application if there is one. | |||||
| /// </summary> | |||||
| ITeam Team { get; } | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets the partial user object containing info on the owner of the application. | /// Gets the partial user object containing info on the owner of the application. | ||||
| @@ -10,6 +10,7 @@ namespace Discord | |||||
| /// <summary> | /// <summary> | ||||
| /// Updates this object's properties with its current state. | /// Updates this object's properties with its current state. | ||||
| /// </summary> | /// </summary> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| Task UpdateAsync(RequestOptions options = null); | Task UpdateAsync(RequestOptions options = null); | ||||
| } | } | ||||
| } | } | ||||
| @@ -0,0 +1,14 @@ | |||||
| namespace Discord | |||||
| { | |||||
| public enum TargetUserType | |||||
| { | |||||
| /// <summary> | |||||
| /// The invite whose target user type is not defined. | |||||
| /// </summary> | |||||
| Undefined = 0, | |||||
| /// <summary> | |||||
| /// The invite is for a Go Live stream. | |||||
| /// </summary> | |||||
| Stream = 1 | |||||
| } | |||||
| } | |||||
| @@ -39,6 +39,13 @@ namespace Discord | |||||
| /// </returns> | /// </returns> | ||||
| bool IsSuppressed { get; } | bool IsSuppressed { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the value that indicates whether this message mentioned everyone. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// <c>true</c> if this message mentioned everyone; otherwise <c>false</c>. | |||||
| /// </returns> | |||||
| bool MentionedEveryone { get; } | |||||
| /// <summary> | |||||
| /// Gets the content for this message. | /// Gets the content for this message. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| @@ -17,7 +17,7 @@ namespace Discord | |||||
| /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for category channels. </summary> | /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for category channels. </summary> | ||||
| public static readonly ChannelPermissions Category = new ChannelPermissions(0b01100_1111110_1111111110001_010001); | public static readonly ChannelPermissions Category = new ChannelPermissions(0b01100_1111110_1111111110001_010001); | ||||
| /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for direct message channels. </summary> | /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for direct message channels. </summary> | ||||
| public static readonly ChannelPermissions DM = new ChannelPermissions(0b00000_1000110_1011100110000_000000); | |||||
| public static readonly ChannelPermissions DM = new ChannelPermissions(0b00000_1000110_1011100110001_000000); | |||||
| /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for group channels. </summary> | /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for group channels. </summary> | ||||
| public static readonly ChannelPermissions Group = new ChannelPermissions(0b00000_1000110_0001101100000_000000); | public static readonly ChannelPermissions Group = new ChannelPermissions(0b00000_1000110_0001101100000_000000); | ||||
| /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for a given channel type. </summary> | /// <summary> Gets a <see cref="ChannelPermissions"/> that grants all permissions for a given channel type. </summary> | ||||
| @@ -51,6 +51,10 @@ namespace Discord | |||||
| /// authentication when used on a guild that has server-wide 2FA enabled. | /// authentication when used on a guild that has server-wide 2FA enabled. | ||||
| /// </remarks> | /// </remarks> | ||||
| ManageGuild = 0x00_00_00_20, | ManageGuild = 0x00_00_00_20, | ||||
| /// <summary> | |||||
| /// Allows for viewing of guild insights | |||||
| /// </summary> | |||||
| ViewGuildInsights = 0x00_08_00_00, | |||||
| // Text | // Text | ||||
| /// <summary> | /// <summary> | ||||
| @@ -12,7 +12,7 @@ namespace Discord | |||||
| /// <summary> Gets a <see cref="GuildPermissions"/> that grants all guild permissions for webhook users. </summary> | /// <summary> Gets a <see cref="GuildPermissions"/> that grants all guild permissions for webhook users. </summary> | ||||
| public static readonly GuildPermissions Webhook = new GuildPermissions(0b00000_0000000_0001101100000_000000); | public static readonly GuildPermissions Webhook = new GuildPermissions(0b00000_0000000_0001101100000_000000); | ||||
| /// <summary> Gets a <see cref="GuildPermissions"/> that grants all guild permissions. </summary> | /// <summary> Gets a <see cref="GuildPermissions"/> that grants all guild permissions. </summary> | ||||
| public static readonly GuildPermissions All = new GuildPermissions(0b11111_1111110_1111111111111_111111); | |||||
| public static readonly GuildPermissions All = new GuildPermissions(0b11111_1111111_1111111111111_111111); | |||||
| /// <summary> Gets a packed value representing all the permissions in this <see cref="GuildPermissions"/>. </summary> | /// <summary> Gets a packed value representing all the permissions in this <see cref="GuildPermissions"/>. </summary> | ||||
| public ulong RawValue { get; } | public ulong RawValue { get; } | ||||
| @@ -34,6 +34,8 @@ namespace Discord | |||||
| public bool AddReactions => Permissions.GetValue(RawValue, GuildPermission.AddReactions); | public bool AddReactions => Permissions.GetValue(RawValue, GuildPermission.AddReactions); | ||||
| /// <summary> If <c>true</c>, a user may view the audit log. </summary> | /// <summary> If <c>true</c>, a user may view the audit log. </summary> | ||||
| public bool ViewAuditLog => Permissions.GetValue(RawValue, GuildPermission.ViewAuditLog); | public bool ViewAuditLog => Permissions.GetValue(RawValue, GuildPermission.ViewAuditLog); | ||||
| /// <summary> If <c>true</c>, a user may view the guild insights. </summary> | |||||
| public bool ViewGuildInsights => Permissions.GetValue(RawValue, GuildPermission.ViewGuildInsights); | |||||
| /// <summary> If True, a user may join channels. </summary> | /// <summary> If True, a user may join channels. </summary> | ||||
| [Obsolete("Use ViewChannel instead.")] | [Obsolete("Use ViewChannel instead.")] | ||||
| @@ -97,6 +99,7 @@ namespace Discord | |||||
| bool? manageGuild = null, | bool? manageGuild = null, | ||||
| bool? addReactions = null, | bool? addReactions = null, | ||||
| bool? viewAuditLog = null, | bool? viewAuditLog = null, | ||||
| bool? viewGuildInsights = null, | |||||
| bool? viewChannel = null, | bool? viewChannel = null, | ||||
| bool? sendMessages = null, | bool? sendMessages = null, | ||||
| bool? sendTTSMessages = null, | bool? sendTTSMessages = null, | ||||
| @@ -130,6 +133,7 @@ namespace Discord | |||||
| Permissions.SetValue(ref value, manageGuild, GuildPermission.ManageGuild); | Permissions.SetValue(ref value, manageGuild, GuildPermission.ManageGuild); | ||||
| Permissions.SetValue(ref value, addReactions, GuildPermission.AddReactions); | Permissions.SetValue(ref value, addReactions, GuildPermission.AddReactions); | ||||
| Permissions.SetValue(ref value, viewAuditLog, GuildPermission.ViewAuditLog); | Permissions.SetValue(ref value, viewAuditLog, GuildPermission.ViewAuditLog); | ||||
| Permissions.SetValue(ref value, viewGuildInsights, GuildPermission.ViewGuildInsights); | |||||
| Permissions.SetValue(ref value, viewChannel, GuildPermission.ViewChannel); | Permissions.SetValue(ref value, viewChannel, GuildPermission.ViewChannel); | ||||
| Permissions.SetValue(ref value, sendMessages, GuildPermission.SendMessages); | Permissions.SetValue(ref value, sendMessages, GuildPermission.SendMessages); | ||||
| Permissions.SetValue(ref value, sendTTSMessages, GuildPermission.SendTTSMessages); | Permissions.SetValue(ref value, sendTTSMessages, GuildPermission.SendTTSMessages); | ||||
| @@ -166,6 +170,7 @@ namespace Discord | |||||
| bool manageGuild = false, | bool manageGuild = false, | ||||
| bool addReactions = false, | bool addReactions = false, | ||||
| bool viewAuditLog = false, | bool viewAuditLog = false, | ||||
| bool viewGuildInsights = false, | |||||
| bool viewChannel = false, | bool viewChannel = false, | ||||
| bool sendMessages = false, | bool sendMessages = false, | ||||
| bool sendTTSMessages = false, | bool sendTTSMessages = false, | ||||
| @@ -198,6 +203,7 @@ namespace Discord | |||||
| manageGuild: manageGuild, | manageGuild: manageGuild, | ||||
| addReactions: addReactions, | addReactions: addReactions, | ||||
| viewAuditLog: viewAuditLog, | viewAuditLog: viewAuditLog, | ||||
| viewGuildInsights: viewGuildInsights, | |||||
| viewChannel: viewChannel, | viewChannel: viewChannel, | ||||
| sendMessages: sendMessages, | sendMessages: sendMessages, | ||||
| sendTTSMessages: sendTTSMessages, | sendTTSMessages: sendTTSMessages, | ||||
| @@ -231,6 +237,7 @@ namespace Discord | |||||
| bool? manageGuild = null, | bool? manageGuild = null, | ||||
| bool? addReactions = null, | bool? addReactions = null, | ||||
| bool? viewAuditLog = null, | bool? viewAuditLog = null, | ||||
| bool? viewGuildInsights = null, | |||||
| bool? viewChannel = null, | bool? viewChannel = null, | ||||
| bool? sendMessages = null, | bool? sendMessages = null, | ||||
| bool? sendTTSMessages = null, | bool? sendTTSMessages = null, | ||||
| @@ -254,7 +261,7 @@ namespace Discord | |||||
| bool? manageWebhooks = null, | bool? manageWebhooks = null, | ||||
| bool? manageEmojis = null) | bool? manageEmojis = null) | ||||
| => new GuildPermissions(RawValue, createInstantInvite, kickMembers, banMembers, administrator, manageChannels, manageGuild, addReactions, | => new GuildPermissions(RawValue, createInstantInvite, kickMembers, banMembers, administrator, manageChannels, manageGuild, addReactions, | ||||
| viewAuditLog, viewChannel, sendMessages, sendTTSMessages, manageMessages, embedLinks, attachFiles, | |||||
| viewAuditLog, viewGuildInsights, viewChannel, sendMessages, sendTTSMessages, manageMessages, embedLinks, attachFiles, | |||||
| readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, moveMembers, | readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, moveMembers, | ||||
| useVoiceActivation, prioritySpeaker, stream, changeNickname, manageNicknames, manageRoles, manageWebhooks, manageEmojis); | useVoiceActivation, prioritySpeaker, stream, changeNickname, manageNicknames, manageRoles, manageWebhooks, manageEmojis); | ||||
| @@ -76,6 +76,10 @@ namespace Discord | |||||
| public PermValue MoveMembers => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.MoveMembers); | public PermValue MoveMembers => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.MoveMembers); | ||||
| /// <summary> If Allowed, a user may use voice-activity-detection rather than push-to-talk. </summary> | /// <summary> If Allowed, a user may use voice-activity-detection rather than push-to-talk. </summary> | ||||
| public PermValue UseVAD => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.UseVAD); | public PermValue UseVAD => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.UseVAD); | ||||
| /// <summary> If Allowed, a user may use priority speaker in a voice channel. </summary> | |||||
| public PermValue PrioritySpeaker => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.PrioritySpeaker); | |||||
| /// <summary> If Allowed, a user may go live in a voice channel. </summary> | |||||
| public PermValue Stream => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.Stream); | |||||
| /// <summary> If Allowed, a user may adjust role permissions. This also implicitly grants all other permissions. </summary> | /// <summary> If Allowed, a user may adjust role permissions. This also implicitly grants all other permissions. </summary> | ||||
| public PermValue ManageRoles => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.ManageRoles); | public PermValue ManageRoles => Permissions.GetValue(AllowValue, DenyValue, ChannelPermission.ManageRoles); | ||||
| @@ -109,7 +113,9 @@ namespace Discord | |||||
| PermValue? moveMembers = null, | PermValue? moveMembers = null, | ||||
| PermValue? useVoiceActivation = null, | PermValue? useVoiceActivation = null, | ||||
| PermValue? manageRoles = null, | PermValue? manageRoles = null, | ||||
| PermValue? manageWebhooks = null) | |||||
| PermValue? manageWebhooks = null, | |||||
| PermValue? prioritySpeaker = null, | |||||
| PermValue? stream = null) | |||||
| { | { | ||||
| Permissions.SetValue(ref allowValue, ref denyValue, createInstantInvite, ChannelPermission.CreateInstantInvite); | Permissions.SetValue(ref allowValue, ref denyValue, createInstantInvite, ChannelPermission.CreateInstantInvite); | ||||
| Permissions.SetValue(ref allowValue, ref denyValue, manageChannel, ChannelPermission.ManageChannels); | Permissions.SetValue(ref allowValue, ref denyValue, manageChannel, ChannelPermission.ManageChannels); | ||||
| @@ -129,6 +135,8 @@ namespace Discord | |||||
| Permissions.SetValue(ref allowValue, ref denyValue, deafenMembers, ChannelPermission.DeafenMembers); | Permissions.SetValue(ref allowValue, ref denyValue, deafenMembers, ChannelPermission.DeafenMembers); | ||||
| Permissions.SetValue(ref allowValue, ref denyValue, moveMembers, ChannelPermission.MoveMembers); | Permissions.SetValue(ref allowValue, ref denyValue, moveMembers, ChannelPermission.MoveMembers); | ||||
| Permissions.SetValue(ref allowValue, ref denyValue, useVoiceActivation, ChannelPermission.UseVAD); | Permissions.SetValue(ref allowValue, ref denyValue, useVoiceActivation, ChannelPermission.UseVAD); | ||||
| Permissions.SetValue(ref allowValue, ref denyValue, prioritySpeaker, ChannelPermission.PrioritySpeaker); | |||||
| Permissions.SetValue(ref allowValue, ref denyValue, stream, ChannelPermission.Stream); | |||||
| Permissions.SetValue(ref allowValue, ref denyValue, manageRoles, ChannelPermission.ManageRoles); | Permissions.SetValue(ref allowValue, ref denyValue, manageRoles, ChannelPermission.ManageRoles); | ||||
| Permissions.SetValue(ref allowValue, ref denyValue, manageWebhooks, ChannelPermission.ManageWebhooks); | Permissions.SetValue(ref allowValue, ref denyValue, manageWebhooks, ChannelPermission.ManageWebhooks); | ||||
| @@ -159,10 +167,12 @@ namespace Discord | |||||
| PermValue moveMembers = PermValue.Inherit, | PermValue moveMembers = PermValue.Inherit, | ||||
| PermValue useVoiceActivation = PermValue.Inherit, | PermValue useVoiceActivation = PermValue.Inherit, | ||||
| PermValue manageRoles = PermValue.Inherit, | PermValue manageRoles = PermValue.Inherit, | ||||
| PermValue manageWebhooks = PermValue.Inherit) | |||||
| PermValue manageWebhooks = PermValue.Inherit, | |||||
| PermValue prioritySpeaker = PermValue.Inherit, | |||||
| PermValue stream = PermValue.Inherit) | |||||
| : this(0, 0, createInstantInvite, manageChannel, addReactions, viewChannel, sendMessages, sendTTSMessages, manageMessages, | : this(0, 0, createInstantInvite, manageChannel, addReactions, viewChannel, sendMessages, sendTTSMessages, manageMessages, | ||||
| embedLinks, attachFiles, readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, | embedLinks, attachFiles, readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, | ||||
| moveMembers, useVoiceActivation, manageRoles, manageWebhooks) { } | |||||
| moveMembers, useVoiceActivation, manageRoles, manageWebhooks, prioritySpeaker, stream) { } | |||||
| /// <summary> | /// <summary> | ||||
| /// Initializes a new <see cref="OverwritePermissions" /> from the current one, changing the provided | /// Initializes a new <see cref="OverwritePermissions" /> from the current one, changing the provided | ||||
| @@ -188,10 +198,12 @@ namespace Discord | |||||
| PermValue? moveMembers = null, | PermValue? moveMembers = null, | ||||
| PermValue? useVoiceActivation = null, | PermValue? useVoiceActivation = null, | ||||
| PermValue? manageRoles = null, | PermValue? manageRoles = null, | ||||
| PermValue? manageWebhooks = null) | |||||
| PermValue? manageWebhooks = null, | |||||
| PermValue? prioritySpeaker = null, | |||||
| PermValue? stream = null) | |||||
| => new OverwritePermissions(AllowValue, DenyValue, createInstantInvite, manageChannel, addReactions, viewChannel, sendMessages, sendTTSMessages, manageMessages, | => new OverwritePermissions(AllowValue, DenyValue, createInstantInvite, manageChannel, addReactions, viewChannel, sendMessages, sendTTSMessages, manageMessages, | ||||
| embedLinks, attachFiles, readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, | embedLinks, attachFiles, readMessageHistory, mentionEveryone, useExternalEmojis, connect, speak, muteMembers, deafenMembers, | ||||
| moveMembers, useVoiceActivation, manageRoles, manageWebhooks); | |||||
| moveMembers, useVoiceActivation, manageRoles, manageWebhooks, prioritySpeaker, stream); | |||||
| /// <summary> | /// <summary> | ||||
| /// Creates a <see cref="List{T}"/> of all the <see cref="ChannelPermission"/> values that are allowed. | /// Creates a <see cref="List{T}"/> of all the <see cref="ChannelPermission"/> values that are allowed. | ||||
| @@ -0,0 +1,27 @@ | |||||
| using System.Collections.Generic; | |||||
| namespace Discord | |||||
| { | |||||
| /// <summary> | |||||
| /// Represents a Discord Team. | |||||
| /// </summary> | |||||
| public interface ITeam | |||||
| { | |||||
| /// <summary> | |||||
| /// Gets the team icon url. | |||||
| /// </summary> | |||||
| string IconUrl { get; } | |||||
| /// <summary> | |||||
| /// Gets the team unique identifier. | |||||
| /// </summary> | |||||
| ulong Id { get; } | |||||
| /// <summary> | |||||
| /// Gets the members of this team. | |||||
| /// </summary> | |||||
| IReadOnlyList<ITeamMember> TeamMembers { get; } | |||||
| /// <summary> | |||||
| /// Gets the user identifier that owns this team. | |||||
| /// </summary> | |||||
| ulong OwnerUserId { get; } | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,25 @@ | |||||
| namespace Discord | |||||
| { | |||||
| /// <summary> | |||||
| /// Represents a Discord Team member. | |||||
| /// </summary> | |||||
| public interface ITeamMember | |||||
| { | |||||
| /// <summary> | |||||
| /// Gets the membership state of this team member. | |||||
| /// </summary> | |||||
| MembershipState MembershipState { get; } | |||||
| /// <summary> | |||||
| /// Gets the permissions of this team member. | |||||
| /// </summary> | |||||
| string[] Permissions { get; } | |||||
| /// <summary> | |||||
| /// Gets the team unique identifier for this team member. | |||||
| /// </summary> | |||||
| ulong TeamId { get; } | |||||
| /// <summary> | |||||
| /// Gets the Discord user of this team member. | |||||
| /// </summary> | |||||
| IUser User { get; } | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,11 @@ | |||||
| namespace Discord | |||||
| { | |||||
| /// <summary> | |||||
| /// Represents the membership state of a team member. | |||||
| /// </summary> | |||||
| public enum MembershipState | |||||
| { | |||||
| Invited, | |||||
| Accepted, | |||||
| } | |||||
| } | |||||
| @@ -17,7 +17,7 @@ namespace Discord | |||||
| public static string GetJumpUrl(this IMessage msg) | public static string GetJumpUrl(this IMessage msg) | ||||
| { | { | ||||
| var channel = msg.Channel; | var channel = msg.Channel; | ||||
| return $"https://discordapp.com/channels/{(channel is IDMChannel ? "@me" : $"{(channel as ITextChannel).GuildId}")}/{channel.Id}/{msg.Id}"; | |||||
| return $"https://discord.com/channels/{(channel is IDMChannel ? "@me" : $"{(channel as ITextChannel).GuildId}")}/{channel.Id}/{msg.Id}"; | |||||
| } | } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -13,7 +13,7 @@ namespace Discord.Net | |||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// An | /// An | ||||
| /// <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#http">HTTP status code</see> | |||||
| /// <see href="https://discord.com/developers/docs/topics/opcodes-and-status-codes#http">HTTP status code</see> | |||||
| /// from Discord. | /// from Discord. | ||||
| /// </returns> | /// </returns> | ||||
| public HttpStatusCode HttpCode { get; } | public HttpStatusCode HttpCode { get; } | ||||
| @@ -22,7 +22,7 @@ namespace Discord.Net | |||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A | /// A | ||||
| /// <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#json">JSON error code</see> | |||||
| /// <see href="https://discord.com/developers/docs/topics/opcodes-and-status-codes#json">JSON error code</see> | |||||
| /// from Discord, or <c>null</c> if none. | /// from Discord, or <c>null</c> if none. | ||||
| /// </returns> | /// </returns> | ||||
| public int? DiscordCode { get; } | public int? DiscordCode { get; } | ||||
| @@ -11,7 +11,7 @@ namespace Discord.Net | |||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A | /// A | ||||
| /// <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-close-event-codes">close code</see> | |||||
| /// <see href="https://discord.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-close-event-codes">close code</see> | |||||
| /// from Discord. | /// from Discord. | ||||
| /// </returns> | /// </returns> | ||||
| public int CloseCode { get; } | public int CloseCode { get; } | ||||
| @@ -1,4 +1,4 @@ | |||||
| #pragma warning disable CS1591 | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | using Newtonsoft.Json; | ||||
| namespace Discord.API | namespace Discord.API | ||||
| @@ -15,6 +15,12 @@ namespace Discord.API | |||||
| public ulong Id { get; set; } | public ulong Id { get; set; } | ||||
| [JsonProperty("icon")] | [JsonProperty("icon")] | ||||
| public string Icon { get; set; } | public string Icon { get; set; } | ||||
| [JsonProperty("bot_public")] | |||||
| public bool IsBotPublic { get; set; } | |||||
| [JsonProperty("bot_require_code_grant")] | |||||
| public bool BotRequiresCodeGrant { get; set; } | |||||
| [JsonProperty("team")] | |||||
| public Team Team { get; set; } | |||||
| [JsonProperty("flags"), Int53] | [JsonProperty("flags"), Int53] | ||||
| public Optional<ulong> Flags { get; set; } | public Optional<ulong> Flags { get; set; } | ||||
| @@ -13,6 +13,8 @@ namespace Discord.API | |||||
| public string Icon { get; set; } | public string Icon { get; set; } | ||||
| [JsonProperty("splash")] | [JsonProperty("splash")] | ||||
| public string Splash { get; set; } | public string Splash { get; set; } | ||||
| [JsonProperty("discovery_splash")] | |||||
| public string DiscoverySplash { get; set; } | |||||
| [JsonProperty("owner_id")] | [JsonProperty("owner_id")] | ||||
| public ulong OwnerId { get; set; } | public ulong OwnerId { get; set; } | ||||
| [JsonProperty("region")] | [JsonProperty("region")] | ||||
| @@ -22,9 +24,9 @@ namespace Discord.API | |||||
| [JsonProperty("afk_timeout")] | [JsonProperty("afk_timeout")] | ||||
| public int AFKTimeout { get; set; } | public int AFKTimeout { get; set; } | ||||
| [JsonProperty("embed_enabled")] | [JsonProperty("embed_enabled")] | ||||
| public bool EmbedEnabled { get; set; } | |||||
| public Optional<bool> EmbedEnabled { get; set; } | |||||
| [JsonProperty("embed_channel_id")] | [JsonProperty("embed_channel_id")] | ||||
| public ulong? EmbedChannelId { get; set; } | |||||
| public Optional<ulong?> EmbedChannelId { get; set; } | |||||
| [JsonProperty("verification_level")] | [JsonProperty("verification_level")] | ||||
| public VerificationLevel VerificationLevel { get; set; } | public VerificationLevel VerificationLevel { get; set; } | ||||
| [JsonProperty("default_message_notifications")] | [JsonProperty("default_message_notifications")] | ||||
| @@ -43,6 +45,10 @@ namespace Discord.API | |||||
| public MfaLevel MfaLevel { get; set; } | public MfaLevel MfaLevel { get; set; } | ||||
| [JsonProperty("application_id")] | [JsonProperty("application_id")] | ||||
| public ulong? ApplicationId { get; set; } | public ulong? ApplicationId { get; set; } | ||||
| [JsonProperty("widget_enabled")] | |||||
| public Optional<bool> WidgetEnabled { get; set; } | |||||
| [JsonProperty("widget_channel_id")] | |||||
| public Optional<ulong?> WidgetChannelId { get; set; } | |||||
| [JsonProperty("system_channel_id")] | [JsonProperty("system_channel_id")] | ||||
| public ulong? SystemChannelId { get; set; } | public ulong? SystemChannelId { get; set; } | ||||
| [JsonProperty("premium_tier")] | [JsonProperty("premium_tier")] | ||||
| @@ -56,9 +62,23 @@ namespace Discord.API | |||||
| // this value is inverted, flags set will turn OFF features | // this value is inverted, flags set will turn OFF features | ||||
| [JsonProperty("system_channel_flags")] | [JsonProperty("system_channel_flags")] | ||||
| public SystemChannelMessageDeny SystemChannelFlags { get; set; } | public SystemChannelMessageDeny SystemChannelFlags { get; set; } | ||||
| [JsonProperty("rules_channel_id")] | |||||
| public ulong? RulesChannelId { get; set; } | |||||
| [JsonProperty("max_presences")] | |||||
| public Optional<int?> MaxPresences { get; set; } | |||||
| [JsonProperty("max_members")] | |||||
| public Optional<int> MaxMembers { get; set; } | |||||
| [JsonProperty("premium_subscription_count")] | [JsonProperty("premium_subscription_count")] | ||||
| public int? PremiumSubscriptionCount { get; set; } | |||||
| public Optional<int> PremiumSubscriptionCount { get; set; } | |||||
| [JsonProperty("preferred_locale")] | [JsonProperty("preferred_locale")] | ||||
| public string PreferredLocale { get; set; } | public string PreferredLocale { get; set; } | ||||
| [JsonProperty("public_updates_channel_id")] | |||||
| public ulong? PublicUpdatesChannelId { get; set; } | |||||
| [JsonProperty("max_video_channel_users")] | |||||
| public Optional<int> MaxVideoChannelUsers { get; set; } | |||||
| [JsonProperty("approximate_member_count")] | |||||
| public Optional<int> ApproximateMemberCount { get; set; } | |||||
| [JsonProperty("approximate_presence_count")] | |||||
| public Optional<int> ApproximatePresenceCount { get; set; } | |||||
| } | } | ||||
| } | } | ||||
| @@ -1,4 +1,4 @@ | |||||
| #pragma warning disable CS1591 | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | using Newtonsoft.Json; | ||||
| namespace Discord.API | namespace Discord.API | ||||
| @@ -8,6 +8,6 @@ namespace Discord.API | |||||
| [JsonProperty("enabled")] | [JsonProperty("enabled")] | ||||
| public bool Enabled { get; set; } | public bool Enabled { get; set; } | ||||
| [JsonProperty("channel_id")] | [JsonProperty("channel_id")] | ||||
| public ulong ChannelId { get; set; } | |||||
| public ulong? ChannelId { get; set; } | |||||
| } | } | ||||
| } | } | ||||
| @@ -0,0 +1,13 @@ | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | |||||
| namespace Discord.API | |||||
| { | |||||
| internal class GuildWidget | |||||
| { | |||||
| [JsonProperty("enabled")] | |||||
| public bool Enabled { get; set; } | |||||
| [JsonProperty("channel_id")] | |||||
| public ulong? ChannelId { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,9 @@ | |||||
| namespace Discord.API | |||||
| { | |||||
| internal enum MembershipState | |||||
| { | |||||
| None = 0, | |||||
| Invited = 1, | |||||
| Accepted = 2, | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,17 @@ | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | |||||
| namespace Discord.API | |||||
| { | |||||
| internal class Team | |||||
| { | |||||
| [JsonProperty("icon")] | |||||
| public Optional<string> Icon { get; set; } | |||||
| [JsonProperty("id")] | |||||
| public ulong Id { get; set; } | |||||
| [JsonProperty("members")] | |||||
| public TeamMember[] TeamMembers { get; set; } | |||||
| [JsonProperty("owner_user_id")] | |||||
| public ulong OwnerUserId { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,17 @@ | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | |||||
| namespace Discord.API | |||||
| { | |||||
| internal class TeamMember | |||||
| { | |||||
| [JsonProperty("membership_state")] | |||||
| public MembershipState MembershipState { get; set; } | |||||
| [JsonProperty("permissions")] | |||||
| public string[] Permissions { get; set; } | |||||
| [JsonProperty("team_id")] | |||||
| public ulong TeamId { get; set; } | |||||
| [JsonProperty("user")] | |||||
| public User User { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -1,4 +1,4 @@ | |||||
| #pragma warning disable CS1591 | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | using Newtonsoft.Json; | ||||
| namespace Discord.API.Rest | namespace Discord.API.Rest | ||||
| @@ -19,6 +19,8 @@ namespace Discord.API.Rest | |||||
| public Optional<string> Username { get; set; } | public Optional<string> Username { get; set; } | ||||
| [JsonProperty("avatar_url")] | [JsonProperty("avatar_url")] | ||||
| public Optional<string> AvatarUrl { get; set; } | public Optional<string> AvatarUrl { get; set; } | ||||
| [JsonProperty("allowed_mentions")] | |||||
| public Optional<AllowedMentions> AllowedMentions { get; set; } | |||||
| public CreateWebhookMessageParams(string content) | public CreateWebhookMessageParams(string content) | ||||
| { | { | ||||
| @@ -9,9 +9,13 @@ namespace Discord.API.Rest | |||||
| [JsonProperty("days")] | [JsonProperty("days")] | ||||
| public int Days { get; } | public int Days { get; } | ||||
| public GuildPruneParams(int days) | |||||
| [JsonProperty("include_roles")] | |||||
| public ulong[] IncludeRoleIds { get; } | |||||
| public GuildPruneParams(int days, ulong[] includeRoleIds) | |||||
| { | { | ||||
| Days = days; | Days = days; | ||||
| IncludeRoleIds = includeRoleIds; | |||||
| } | } | ||||
| } | } | ||||
| } | } | ||||
| @@ -0,0 +1,14 @@ | |||||
| #pragma warning disable CS1591 | |||||
| using Newtonsoft.Json; | |||||
| namespace Discord.API.Rest | |||||
| { | |||||
| [JsonObject(MemberSerialization = MemberSerialization.OptIn)] | |||||
| internal class ModifyGuildWidgetParams | |||||
| { | |||||
| [JsonProperty("enabled")] | |||||
| public Optional<bool> Enabled { get; set; } | |||||
| [JsonProperty("channel")] | |||||
| public Optional<ulong?> ChannelId { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -21,6 +21,7 @@ namespace Discord.API.Rest | |||||
| public Optional<string> Username { get; set; } | public Optional<string> Username { get; set; } | ||||
| public Optional<string> AvatarUrl { get; set; } | public Optional<string> AvatarUrl { get; set; } | ||||
| public Optional<Embed[]> Embeds { get; set; } | public Optional<Embed[]> Embeds { get; set; } | ||||
| public Optional<AllowedMentions> AllowedMentions { get; set; } | |||||
| public bool IsSpoiler { get; set; } = false; | public bool IsSpoiler { get; set; } = false; | ||||
| @@ -51,6 +52,8 @@ namespace Discord.API.Rest | |||||
| payload["avatar_url"] = AvatarUrl.Value; | payload["avatar_url"] = AvatarUrl.Value; | ||||
| if (Embeds.IsSpecified) | if (Embeds.IsSpecified) | ||||
| payload["embeds"] = Embeds.Value; | payload["embeds"] = Embeds.Value; | ||||
| if (AllowedMentions.IsSpecified) | |||||
| payload["allowed_mentions"] = AllowedMentions.Value; | |||||
| var json = new StringBuilder(); | var json = new StringBuilder(); | ||||
| using (var text = new StringWriter(json)) | using (var text = new StringWriter(json)) | ||||
| @@ -46,12 +46,12 @@ namespace Discord.Rest | |||||
| _restLogger = LogManager.CreateLogger("Rest"); | _restLogger = LogManager.CreateLogger("Rest"); | ||||
| _isFirstLogin = config.DisplayInitialLog; | _isFirstLogin = config.DisplayInitialLog; | ||||
| ApiClient.RequestQueue.RateLimitTriggered += async (id, info) => | |||||
| ApiClient.RequestQueue.RateLimitTriggered += async (id, info, endpoint) => | |||||
| { | { | ||||
| if (info == null) | if (info == null) | ||||
| await _restLogger.VerboseAsync($"Preemptive Rate limit triggered: {id?.ToString() ?? "null"}").ConfigureAwait(false); | |||||
| await _restLogger.VerboseAsync($"Preemptive Rate limit triggered: {endpoint} {(id.IsHashBucket ? $"(Bucket: {id.BucketHash})" : "")}").ConfigureAwait(false); | |||||
| else | else | ||||
| await _restLogger.WarningAsync($"Rate limit triggered: {id?.ToString() ?? "null"}").ConfigureAwait(false); | |||||
| await _restLogger.WarningAsync($"Rate limit triggered: {endpoint} {(id.IsHashBucket ? $"(Bucket: {id.BucketHash})" : "")}").ConfigureAwait(false); | |||||
| }; | }; | ||||
| ApiClient.SentRequest += async (method, endpoint, millis) => await _restLogger.VerboseAsync($"{method} {endpoint}: {millis} ms").ConfigureAwait(false); | ApiClient.SentRequest += async (method, endpoint, millis) => await _restLogger.VerboseAsync($"{method} {endpoint}: {millis} ms").ConfigureAwait(false); | ||||
| } | } | ||||
| @@ -62,9 +62,9 @@ namespace Discord.Rest | |||||
| } | } | ||||
| public static async Task<RestGuild> GetGuildAsync(BaseDiscordClient client, | public static async Task<RestGuild> GetGuildAsync(BaseDiscordClient client, | ||||
| ulong id, RequestOptions options) | |||||
| ulong id, bool withCounts, RequestOptions options) | |||||
| { | { | ||||
| var model = await client.ApiClient.GetGuildAsync(id, options).ConfigureAwait(false); | |||||
| var model = await client.ApiClient.GetGuildAsync(id, withCounts, options).ConfigureAwait(false); | |||||
| if (model != null) | if (model != null) | ||||
| return RestGuild.Create(client, model); | return RestGuild.Create(client, model); | ||||
| return null; | return null; | ||||
| @@ -77,6 +77,14 @@ namespace Discord.Rest | |||||
| return RestGuildEmbed.Create(model); | return RestGuildEmbed.Create(model); | ||||
| return null; | return null; | ||||
| } | } | ||||
| public static async Task<RestGuildWidget?> GetGuildWidgetAsync(BaseDiscordClient client, | |||||
| ulong id, RequestOptions options) | |||||
| { | |||||
| var model = await client.ApiClient.GetGuildWidgetAsync(id, options).ConfigureAwait(false); | |||||
| if (model != null) | |||||
| return RestGuildWidget.Create(model); | |||||
| return null; | |||||
| } | |||||
| public static IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(BaseDiscordClient client, | public static IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(BaseDiscordClient client, | ||||
| ulong? fromGuildId, int? limit, RequestOptions options) | ulong? fromGuildId, int? limit, RequestOptions options) | ||||
| { | { | ||||
| @@ -106,13 +114,13 @@ namespace Discord.Rest | |||||
| count: limit | count: limit | ||||
| ); | ); | ||||
| } | } | ||||
| public static async Task<IReadOnlyCollection<RestGuild>> GetGuildsAsync(BaseDiscordClient client, RequestOptions options) | |||||
| public static async Task<IReadOnlyCollection<RestGuild>> GetGuildsAsync(BaseDiscordClient client, bool withCounts, RequestOptions options) | |||||
| { | { | ||||
| var summaryModels = await GetGuildSummariesAsync(client, null, null, options).FlattenAsync().ConfigureAwait(false); | var summaryModels = await GetGuildSummariesAsync(client, null, null, options).FlattenAsync().ConfigureAwait(false); | ||||
| var guilds = ImmutableArray.CreateBuilder<RestGuild>(); | var guilds = ImmutableArray.CreateBuilder<RestGuild>(); | ||||
| foreach (var summaryModel in summaryModels) | foreach (var summaryModel in summaryModels) | ||||
| { | { | ||||
| var guildModel = await client.ApiClient.GetGuildAsync(summaryModel.Id).ConfigureAwait(false); | |||||
| var guildModel = await client.ApiClient.GetGuildAsync(summaryModel.Id, withCounts).ConfigureAwait(false); | |||||
| if (guildModel != null) | if (guildModel != null) | ||||
| guilds.Add(RestGuild.Create(client, guildModel)); | guilds.Add(RestGuild.Create(client, guildModel)); | ||||
| } | } | ||||
| @@ -140,7 +148,7 @@ namespace Discord.Rest | |||||
| public static async Task<RestGuildUser> GetGuildUserAsync(BaseDiscordClient client, | public static async Task<RestGuildUser> GetGuildUserAsync(BaseDiscordClient client, | ||||
| ulong guildId, ulong id, RequestOptions options) | ulong guildId, ulong id, RequestOptions options) | ||||
| { | { | ||||
| var guild = await GetGuildAsync(client, guildId, options).ConfigureAwait(false); | |||||
| var guild = await GetGuildAsync(client, guildId, false, options).ConfigureAwait(false); | |||||
| if (guild == null) | if (guild == null) | ||||
| return null; | return null; | ||||
| @@ -787,7 +787,7 @@ namespace Discord.API | |||||
| } | } | ||||
| //Guilds | //Guilds | ||||
| public async Task<Guild> GetGuildAsync(ulong guildId, RequestOptions options = null) | |||||
| public async Task<Guild> GetGuildAsync(ulong guildId, bool withCounts, RequestOptions options = null) | |||||
| { | { | ||||
| Preconditions.NotEqual(guildId, 0, nameof(guildId)); | Preconditions.NotEqual(guildId, 0, nameof(guildId)); | ||||
| options = RequestOptions.CreateOrClone(options); | options = RequestOptions.CreateOrClone(options); | ||||
| @@ -795,7 +795,7 @@ namespace Discord.API | |||||
| try | try | ||||
| { | { | ||||
| var ids = new BucketIds(guildId: guildId); | var ids = new BucketIds(guildId: guildId); | ||||
| return await SendAsync<Guild>("GET", () => $"guilds/{guildId}", ids, options: options).ConfigureAwait(false); | |||||
| return await SendAsync<Guild>("GET", () => $"guilds/{guildId}?with_counts={(withCounts ? "true" : "false")}", ids, options: options).ConfigureAwait(false); | |||||
| } | } | ||||
| catch (HttpException ex) when (ex.HttpCode == HttpStatusCode.NotFound) { return null; } | catch (HttpException ex) when (ex.HttpCode == HttpStatusCode.NotFound) { return null; } | ||||
| } | } | ||||
| @@ -853,10 +853,11 @@ namespace Discord.API | |||||
| Preconditions.NotEqual(guildId, 0, nameof(guildId)); | Preconditions.NotEqual(guildId, 0, nameof(guildId)); | ||||
| Preconditions.NotNull(args, nameof(args)); | Preconditions.NotNull(args, nameof(args)); | ||||
| Preconditions.AtLeast(args.Days, 1, nameof(args.Days)); | Preconditions.AtLeast(args.Days, 1, nameof(args.Days)); | ||||
| string endpointRoleIds = args.IncludeRoleIds?.Length > 0 ? $"&include_roles={string.Join(",", args.IncludeRoleIds)}" : ""; | |||||
| options = RequestOptions.CreateOrClone(options); | options = RequestOptions.CreateOrClone(options); | ||||
| var ids = new BucketIds(guildId: guildId); | var ids = new BucketIds(guildId: guildId); | ||||
| return await SendAsync<GetGuildPruneCountResponse>("GET", () => $"guilds/{guildId}/prune?days={args.Days}", ids, options: options).ConfigureAwait(false); | |||||
| return await SendAsync<GetGuildPruneCountResponse>("GET", () => $"guilds/{guildId}/prune?days={args.Days}{endpointRoleIds}", ids, options: options).ConfigureAwait(false); | |||||
| } | } | ||||
| //Guild Bans | //Guild Bans | ||||
| @@ -874,8 +875,12 @@ namespace Discord.API | |||||
| Preconditions.NotEqual(guildId, 0, nameof(guildId)); | Preconditions.NotEqual(guildId, 0, nameof(guildId)); | ||||
| options = RequestOptions.CreateOrClone(options); | options = RequestOptions.CreateOrClone(options); | ||||
| var ids = new BucketIds(guildId: guildId); | |||||
| return await SendAsync<Ban>("GET", () => $"guilds/{guildId}/bans/{userId}", ids, options: options).ConfigureAwait(false); | |||||
| try | |||||
| { | |||||
| var ids = new BucketIds(guildId: guildId); | |||||
| return await SendAsync<Ban>("GET", () => $"guilds/{guildId}/bans/{userId}", ids, options: options).ConfigureAwait(false); | |||||
| } | |||||
| catch (HttpException ex) when (ex.HttpCode == HttpStatusCode.NotFound) { return null; } | |||||
| } | } | ||||
| /// <exception cref="ArgumentException"> | /// <exception cref="ArgumentException"> | ||||
| /// <paramref name="guildId"/> and <paramref name="userId"/> must not be equal to zero. | /// <paramref name="guildId"/> and <paramref name="userId"/> must not be equal to zero. | ||||
| @@ -933,6 +938,32 @@ namespace Discord.API | |||||
| return await SendJsonAsync<GuildEmbed>("PATCH", () => $"guilds/{guildId}/embed", args, ids, options: options).ConfigureAwait(false); | return await SendJsonAsync<GuildEmbed>("PATCH", () => $"guilds/{guildId}/embed", args, ids, options: options).ConfigureAwait(false); | ||||
| } | } | ||||
| //Guild Widget | |||||
| /// <exception cref="ArgumentException"><paramref name="guildId"/> must not be equal to zero.</exception> | |||||
| public async Task<GuildWidget> GetGuildWidgetAsync(ulong guildId, RequestOptions options = null) | |||||
| { | |||||
| Preconditions.NotEqual(guildId, 0, nameof(guildId)); | |||||
| options = RequestOptions.CreateOrClone(options); | |||||
| try | |||||
| { | |||||
| var ids = new BucketIds(guildId: guildId); | |||||
| return await SendAsync<GuildWidget>("GET", () => $"guilds/{guildId}/widget", ids, options: options).ConfigureAwait(false); | |||||
| } | |||||
| catch (HttpException ex) when (ex.HttpCode == HttpStatusCode.NotFound) { return null; } | |||||
| } | |||||
| /// <exception cref="ArgumentException"><paramref name="guildId"/> must not be equal to zero.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="args"/> must not be <see langword="null"/>.</exception> | |||||
| public async Task<GuildWidget> ModifyGuildWidgetAsync(ulong guildId, Rest.ModifyGuildWidgetParams args, RequestOptions options = null) | |||||
| { | |||||
| Preconditions.NotNull(args, nameof(args)); | |||||
| Preconditions.NotEqual(guildId, 0, nameof(guildId)); | |||||
| options = RequestOptions.CreateOrClone(options); | |||||
| var ids = new BucketIds(guildId: guildId); | |||||
| return await SendJsonAsync<GuildWidget>("PATCH", () => $"guilds/{guildId}/widget", args, ids, options: options).ConfigureAwait(false); | |||||
| } | |||||
| //Guild Integrations | //Guild Integrations | ||||
| /// <exception cref="ArgumentException"><paramref name="guildId"/> must not be equal to zero.</exception> | /// <exception cref="ArgumentException"><paramref name="guildId"/> must not be equal to zero.</exception> | ||||
| public async Task<IReadOnlyCollection<Integration>> GetGuildIntegrationsAsync(ulong guildId, RequestOptions options = null) | public async Task<IReadOnlyCollection<Integration>> GetGuildIntegrationsAsync(ulong guildId, RequestOptions options = null) | ||||
| @@ -1,3 +1,4 @@ | |||||
| using System; | |||||
| using System.Collections.Generic; | using System.Collections.Generic; | ||||
| using System.Collections.Immutable; | using System.Collections.Immutable; | ||||
| using System.IO; | using System.IO; | ||||
| @@ -77,15 +78,22 @@ namespace Discord.Rest | |||||
| => ClientHelper.GetInviteAsync(this, inviteId, options); | => ClientHelper.GetInviteAsync(this, inviteId, options); | ||||
| public Task<RestGuild> GetGuildAsync(ulong id, RequestOptions options = null) | public Task<RestGuild> GetGuildAsync(ulong id, RequestOptions options = null) | ||||
| => ClientHelper.GetGuildAsync(this, id, options); | |||||
| => ClientHelper.GetGuildAsync(this, id, false, options); | |||||
| public Task<RestGuild> GetGuildAsync(ulong id, bool withCounts, RequestOptions options = null) | |||||
| => ClientHelper.GetGuildAsync(this, id, withCounts, options); | |||||
| [Obsolete("This endpoint is deprecated, use GetGuildWidgetAsync instead.")] | |||||
| public Task<RestGuildEmbed?> GetGuildEmbedAsync(ulong id, RequestOptions options = null) | public Task<RestGuildEmbed?> GetGuildEmbedAsync(ulong id, RequestOptions options = null) | ||||
| => ClientHelper.GetGuildEmbedAsync(this, id, options); | => ClientHelper.GetGuildEmbedAsync(this, id, options); | ||||
| public Task<RestGuildWidget?> GetGuildWidgetAsync(ulong id, RequestOptions options = null) | |||||
| => ClientHelper.GetGuildWidgetAsync(this, id, options); | |||||
| public IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(RequestOptions options = null) | public IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(RequestOptions options = null) | ||||
| => ClientHelper.GetGuildSummariesAsync(this, null, null, options); | => ClientHelper.GetGuildSummariesAsync(this, null, null, options); | ||||
| public IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(ulong fromGuildId, int limit, RequestOptions options = null) | public IAsyncEnumerable<IReadOnlyCollection<RestUserGuild>> GetGuildSummariesAsync(ulong fromGuildId, int limit, RequestOptions options = null) | ||||
| => ClientHelper.GetGuildSummariesAsync(this, fromGuildId, limit, options); | => ClientHelper.GetGuildSummariesAsync(this, fromGuildId, limit, options); | ||||
| public Task<IReadOnlyCollection<RestGuild>> GetGuildsAsync(RequestOptions options = null) | public Task<IReadOnlyCollection<RestGuild>> GetGuildsAsync(RequestOptions options = null) | ||||
| => ClientHelper.GetGuildsAsync(this, options); | |||||
| => ClientHelper.GetGuildsAsync(this, false, options); | |||||
| public Task<IReadOnlyCollection<RestGuild>> GetGuildsAsync(bool withCounts, RequestOptions options = null) | |||||
| => ClientHelper.GetGuildsAsync(this, withCounts, options); | |||||
| public Task<RestGuild> CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon = null, RequestOptions options = null) | public Task<RestGuild> CreateGuildAsync(string name, IVoiceRegion region, Stream jpegIcon = null, RequestOptions options = null) | ||||
| => ClientHelper.CreateGuildAsync(this, name, region, jpegIcon, options); | => ClientHelper.CreateGuildAsync(this, name, region, jpegIcon, options); | ||||
| @@ -28,7 +28,16 @@ namespace Discord.Rest | |||||
| { | { | ||||
| Name = args.Name, | Name = args.Name, | ||||
| Position = args.Position, | Position = args.Position, | ||||
| CategoryId = args.CategoryId | |||||
| CategoryId = args.CategoryId, | |||||
| Overwrites = args.PermissionOverwrites.IsSpecified | |||||
| ? args.PermissionOverwrites.Value.Select(overwrite => new API.Overwrite | |||||
| { | |||||
| TargetId = overwrite.TargetId, | |||||
| TargetType = overwrite.TargetType, | |||||
| Allow = overwrite.Permissions.AllowValue, | |||||
| Deny = overwrite.Permissions.DenyValue | |||||
| }).ToArray() | |||||
| : Optional.Create<API.Overwrite[]>(), | |||||
| }; | }; | ||||
| return await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false); | return await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false); | ||||
| } | } | ||||
| @@ -70,7 +79,16 @@ namespace Discord.Rest | |||||
| Name = args.Name, | Name = args.Name, | ||||
| Position = args.Position, | Position = args.Position, | ||||
| CategoryId = args.CategoryId, | CategoryId = args.CategoryId, | ||||
| UserLimit = args.UserLimit.IsSpecified ? (args.UserLimit.Value ?? 0) : Optional.Create<int>() | |||||
| UserLimit = args.UserLimit.IsSpecified ? (args.UserLimit.Value ?? 0) : Optional.Create<int>(), | |||||
| Overwrites = args.PermissionOverwrites.IsSpecified | |||||
| ? args.PermissionOverwrites.Value.Select(overwrite => new API.Overwrite | |||||
| { | |||||
| TargetId = overwrite.TargetId, | |||||
| TargetType = overwrite.TargetType, | |||||
| Allow = overwrite.Permissions.AllowValue, | |||||
| Deny = overwrite.Permissions.DenyValue | |||||
| }).ToArray() | |||||
| : Optional.Create<API.Overwrite[]>(), | |||||
| }; | }; | ||||
| return await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false); | return await client.ApiClient.ModifyGuildChannelAsync(channel.Id, apiArgs, options).ConfigureAwait(false); | ||||
| } | } | ||||
| @@ -12,7 +12,7 @@ namespace Discord.Rest | |||||
| /// Represents a REST-based news channel in a guild that has the same properties as a <see cref="RestTextChannel"/>. | /// Represents a REST-based news channel in a guild that has the same properties as a <see cref="RestTextChannel"/>. | ||||
| /// </summary> | /// </summary> | ||||
| [DebuggerDisplay(@"{DebuggerDisplay,nq}")] | [DebuggerDisplay(@"{DebuggerDisplay,nq}")] | ||||
| public class RestNewsChannel : RestTextChannel | |||||
| public class RestNewsChannel : RestTextChannel, INewsChannel | |||||
| { | { | ||||
| internal RestNewsChannel(BaseDiscordClient discord, IGuild guild, ulong id) | internal RestNewsChannel(BaseDiscordClient discord, IGuild guild, ulong id) | ||||
| :base(discord, guild, id) | :base(discord, guild, id) | ||||
| @@ -5,6 +5,7 @@ using System.Collections.Immutable; | |||||
| using System.Linq; | using System.Linq; | ||||
| using System.Threading.Tasks; | using System.Threading.Tasks; | ||||
| using EmbedModel = Discord.API.GuildEmbed; | using EmbedModel = Discord.API.GuildEmbed; | ||||
| using WidgetModel = Discord.API.GuildWidget; | |||||
| using Model = Discord.API.Guild; | using Model = Discord.API.Guild; | ||||
| using RoleModel = Discord.API.Role; | using RoleModel = Discord.API.Role; | ||||
| using ImageModel = Discord.API.Image; | using ImageModel = Discord.API.Image; | ||||
| @@ -99,6 +100,27 @@ namespace Discord.Rest | |||||
| return await client.ApiClient.ModifyGuildEmbedAsync(guild.Id, apiArgs, options).ConfigureAwait(false); | return await client.ApiClient.ModifyGuildEmbedAsync(guild.Id, apiArgs, options).ConfigureAwait(false); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public static async Task<WidgetModel> ModifyWidgetAsync(IGuild guild, BaseDiscordClient client, | |||||
| Action<GuildWidgetProperties> func, RequestOptions options) | |||||
| { | |||||
| if (func == null) | |||||
| throw new ArgumentNullException(nameof(func)); | |||||
| var args = new GuildWidgetProperties(); | |||||
| func(args); | |||||
| var apiArgs = new API.Rest.ModifyGuildWidgetParams | |||||
| { | |||||
| Enabled = args.Enabled | |||||
| }; | |||||
| if (args.Channel.IsSpecified) | |||||
| apiArgs.ChannelId = args.Channel.Value?.Id; | |||||
| else if (args.ChannelId.IsSpecified) | |||||
| apiArgs.ChannelId = args.ChannelId.Value; | |||||
| return await client.ApiClient.ModifyGuildWidgetAsync(guild.Id, apiArgs, options).ConfigureAwait(false); | |||||
| } | |||||
| public static async Task ReorderChannelsAsync(IGuild guild, BaseDiscordClient client, | public static async Task ReorderChannelsAsync(IGuild guild, BaseDiscordClient client, | ||||
| IEnumerable<ReorderChannelProperties> args, RequestOptions options) | IEnumerable<ReorderChannelProperties> args, RequestOptions options) | ||||
| { | { | ||||
| @@ -132,7 +154,7 @@ namespace Discord.Rest | |||||
| public static async Task<RestBan> GetBanAsync(IGuild guild, BaseDiscordClient client, ulong userId, RequestOptions options) | public static async Task<RestBan> GetBanAsync(IGuild guild, BaseDiscordClient client, ulong userId, RequestOptions options) | ||||
| { | { | ||||
| var model = await client.ApiClient.GetGuildBanAsync(guild.Id, userId, options).ConfigureAwait(false); | var model = await client.ApiClient.GetGuildBanAsync(guild.Id, userId, options).ConfigureAwait(false); | ||||
| return RestBan.Create(client, model); | |||||
| return model == null ? null : RestBan.Create(client, model); | |||||
| } | } | ||||
| public static async Task AddBanAsync(IGuild guild, BaseDiscordClient client, | public static async Task AddBanAsync(IGuild guild, BaseDiscordClient client, | ||||
| @@ -404,9 +426,9 @@ namespace Discord.Rest | |||||
| ); | ); | ||||
| } | } | ||||
| public static async Task<int> PruneUsersAsync(IGuild guild, BaseDiscordClient client, | public static async Task<int> PruneUsersAsync(IGuild guild, BaseDiscordClient client, | ||||
| int days, bool simulate, RequestOptions options) | |||||
| int days, bool simulate, RequestOptions options, IEnumerable<ulong> includeRoleIds) | |||||
| { | { | ||||
| var args = new GuildPruneParams(days); | |||||
| var args = new GuildPruneParams(days, includeRoleIds?.ToArray()); | |||||
| GetGuildPruneCountResponse model; | GetGuildPruneCountResponse model; | ||||
| if (simulate) | if (simulate) | ||||
| model = await client.ApiClient.GetGuildPruneCountAsync(guild.Id, args, options).ConfigureAwait(false); | model = await client.ApiClient.GetGuildPruneCountAsync(guild.Id, args, options).ConfigureAwait(false); | ||||
| @@ -479,7 +501,7 @@ namespace Discord.Rest | |||||
| var emote = await client.ApiClient.GetGuildEmoteAsync(guild.Id, id, options).ConfigureAwait(false); | var emote = await client.ApiClient.GetGuildEmoteAsync(guild.Id, id, options).ConfigureAwait(false); | ||||
| return emote.ToEntity(); | return emote.ToEntity(); | ||||
| } | } | ||||
| public static async Task<GuildEmote> CreateEmoteAsync(IGuild guild, BaseDiscordClient client, string name, Image image, Optional<IEnumerable<IRole>> roles, | |||||
| public static async Task<GuildEmote> CreateEmoteAsync(IGuild guild, BaseDiscordClient client, string name, Image image, Optional<IEnumerable<IRole>> roles, | |||||
| RequestOptions options) | RequestOptions options) | ||||
| { | { | ||||
| var apiargs = new CreateGuildEmoteParams | var apiargs = new CreateGuildEmoteParams | ||||
| @@ -494,7 +516,7 @@ namespace Discord.Rest | |||||
| return emote.ToEntity(); | return emote.ToEntity(); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | ||||
| public static async Task<GuildEmote> ModifyEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, Action<EmoteProperties> func, | |||||
| public static async Task<GuildEmote> ModifyEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, Action<EmoteProperties> func, | |||||
| RequestOptions options) | RequestOptions options) | ||||
| { | { | ||||
| if (func == null) throw new ArgumentNullException(paramName: nameof(func)); | if (func == null) throw new ArgumentNullException(paramName: nameof(func)); | ||||
| @@ -512,7 +534,7 @@ namespace Discord.Rest | |||||
| var emote = await client.ApiClient.ModifyGuildEmoteAsync(guild.Id, id, apiargs, options).ConfigureAwait(false); | var emote = await client.ApiClient.ModifyGuildEmoteAsync(guild.Id, id, apiargs, options).ConfigureAwait(false); | ||||
| return emote.ToEntity(); | return emote.ToEntity(); | ||||
| } | } | ||||
| public static Task DeleteEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, RequestOptions options) | |||||
| public static Task DeleteEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, RequestOptions options) | |||||
| => client.ApiClient.DeleteGuildEmoteAsync(guild.Id, id, options); | => client.ApiClient.DeleteGuildEmoteAsync(guild.Id, id, options); | ||||
| } | } | ||||
| } | } | ||||
| @@ -7,6 +7,7 @@ using System.Globalization; | |||||
| using System.Linq; | using System.Linq; | ||||
| using System.Threading.Tasks; | using System.Threading.Tasks; | ||||
| using EmbedModel = Discord.API.GuildEmbed; | using EmbedModel = Discord.API.GuildEmbed; | ||||
| using WidgetModel = Discord.API.GuildWidget; | |||||
| using Model = Discord.API.Guild; | using Model = Discord.API.Guild; | ||||
| namespace Discord.Rest | namespace Discord.Rest | ||||
| @@ -28,6 +29,8 @@ namespace Discord.Rest | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public bool IsEmbeddable { get; private set; } | public bool IsEmbeddable { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public bool IsWidgetEnabled { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public VerificationLevel VerificationLevel { get; private set; } | public VerificationLevel VerificationLevel { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public MfaLevel MfaLevel { get; private set; } | public MfaLevel MfaLevel { get; private set; } | ||||
| @@ -41,8 +44,14 @@ namespace Discord.Rest | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public ulong? EmbedChannelId { get; private set; } | public ulong? EmbedChannelId { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public ulong? WidgetChannelId { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public ulong? SystemChannelId { get; private set; } | public ulong? SystemChannelId { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public ulong? RulesChannelId { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public ulong? PublicUpdatesChannelId { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public ulong OwnerId { get; private set; } | public ulong OwnerId { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string VoiceRegionId { get; private set; } | public string VoiceRegionId { get; private set; } | ||||
| @@ -50,6 +59,8 @@ namespace Discord.Rest | |||||
| public string IconId { get; private set; } | public string IconId { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string SplashId { get; private set; } | public string SplashId { get; private set; } | ||||
| /// <inheritdoc /> | |||||
| public string DiscoverySplashId { get; private set; } | |||||
| internal bool Available { get; private set; } | internal bool Available { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public ulong? ApplicationId { get; private set; } | public ulong? ApplicationId { get; private set; } | ||||
| @@ -67,6 +78,16 @@ namespace Discord.Rest | |||||
| public int PremiumSubscriptionCount { get; private set; } | public int PremiumSubscriptionCount { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string PreferredLocale { get; private set; } | public string PreferredLocale { get; private set; } | ||||
| /// <inheritdoc /> | |||||
| public int? MaxPresences { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public int? MaxMembers { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public int? MaxVideoChannelUsers { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public int? ApproximateMemberCount { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public int? ApproximatePresenceCount { get; private set; } | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public CultureInfo PreferredCulture { get; private set; } | public CultureInfo PreferredCulture { get; private set; } | ||||
| @@ -81,6 +102,8 @@ namespace Discord.Rest | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string SplashUrl => CDN.GetGuildSplashUrl(Id, SplashId); | public string SplashUrl => CDN.GetGuildSplashUrl(Id, SplashId); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string DiscoverySplashUrl => CDN.GetGuildDiscoverySplashUrl(Id, DiscoverySplashId); | |||||
| /// <inheritdoc /> | |||||
| public string BannerUrl => CDN.GetGuildBannerUrl(Id, BannerId); | public string BannerUrl => CDN.GetGuildBannerUrl(Id, BannerId); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -110,15 +133,24 @@ namespace Discord.Rest | |||||
| internal void Update(Model model) | internal void Update(Model model) | ||||
| { | { | ||||
| AFKChannelId = model.AFKChannelId; | AFKChannelId = model.AFKChannelId; | ||||
| EmbedChannelId = model.EmbedChannelId; | |||||
| if (model.EmbedChannelId.IsSpecified) | |||||
| EmbedChannelId = model.EmbedChannelId.Value; | |||||
| if (model.WidgetChannelId.IsSpecified) | |||||
| WidgetChannelId = model.WidgetChannelId.Value; | |||||
| SystemChannelId = model.SystemChannelId; | SystemChannelId = model.SystemChannelId; | ||||
| RulesChannelId = model.RulesChannelId; | |||||
| PublicUpdatesChannelId = model.PublicUpdatesChannelId; | |||||
| AFKTimeout = model.AFKTimeout; | AFKTimeout = model.AFKTimeout; | ||||
| IsEmbeddable = model.EmbedEnabled; | |||||
| if (model.EmbedEnabled.IsSpecified) | |||||
| IsEmbeddable = model.EmbedEnabled.Value; | |||||
| if (model.WidgetEnabled.IsSpecified) | |||||
| IsWidgetEnabled = model.WidgetEnabled.Value; | |||||
| IconId = model.Icon; | IconId = model.Icon; | ||||
| Name = model.Name; | Name = model.Name; | ||||
| OwnerId = model.OwnerId; | OwnerId = model.OwnerId; | ||||
| VoiceRegionId = model.Region; | VoiceRegionId = model.Region; | ||||
| SplashId = model.Splash; | SplashId = model.Splash; | ||||
| DiscoverySplashId = model.DiscoverySplash; | |||||
| VerificationLevel = model.VerificationLevel; | VerificationLevel = model.VerificationLevel; | ||||
| MfaLevel = model.MfaLevel; | MfaLevel = model.MfaLevel; | ||||
| DefaultMessageNotifications = model.DefaultMessageNotifications; | DefaultMessageNotifications = model.DefaultMessageNotifications; | ||||
| @@ -129,9 +161,20 @@ namespace Discord.Rest | |||||
| BannerId = model.Banner; | BannerId = model.Banner; | ||||
| SystemChannelFlags = model.SystemChannelFlags; | SystemChannelFlags = model.SystemChannelFlags; | ||||
| Description = model.Description; | Description = model.Description; | ||||
| PremiumSubscriptionCount = model.PremiumSubscriptionCount.GetValueOrDefault(); | |||||
| if (model.PremiumSubscriptionCount.IsSpecified) | |||||
| PremiumSubscriptionCount = model.PremiumSubscriptionCount.Value; | |||||
| if (model.MaxPresences.IsSpecified) | |||||
| MaxPresences = model.MaxPresences.Value ?? 25000; | |||||
| if (model.MaxMembers.IsSpecified) | |||||
| MaxMembers = model.MaxMembers.Value; | |||||
| if (model.MaxVideoChannelUsers.IsSpecified) | |||||
| MaxVideoChannelUsers = model.MaxVideoChannelUsers.Value; | |||||
| PreferredLocale = model.PreferredLocale; | PreferredLocale = model.PreferredLocale; | ||||
| PreferredCulture = new CultureInfo(PreferredLocale); | PreferredCulture = new CultureInfo(PreferredLocale); | ||||
| if (model.ApproximateMemberCount.IsSpecified) | |||||
| ApproximateMemberCount = model.ApproximateMemberCount.Value; | |||||
| if (model.ApproximatePresenceCount.IsSpecified) | |||||
| ApproximatePresenceCount = model.ApproximatePresenceCount.Value; | |||||
| if (model.Emojis != null) | if (model.Emojis != null) | ||||
| { | { | ||||
| @@ -163,17 +206,36 @@ namespace Discord.Rest | |||||
| EmbedChannelId = model.ChannelId; | EmbedChannelId = model.ChannelId; | ||||
| IsEmbeddable = model.Enabled; | IsEmbeddable = model.Enabled; | ||||
| } | } | ||||
| internal void Update(WidgetModel model) | |||||
| { | |||||
| WidgetChannelId = model.ChannelId; | |||||
| IsWidgetEnabled = model.Enabled; | |||||
| } | |||||
| //General | //General | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public async Task UpdateAsync(RequestOptions options = null) | public async Task UpdateAsync(RequestOptions options = null) | ||||
| => Update(await Discord.ApiClient.GetGuildAsync(Id, options).ConfigureAwait(false)); | |||||
| => Update(await Discord.ApiClient.GetGuildAsync(Id, false, options).ConfigureAwait(false)); | |||||
| /// <summary> | |||||
| /// Updates this object's properties with its current state. | |||||
| /// </summary> | |||||
| /// <param name="withCounts"> | |||||
| /// If true, <see cref="ApproximateMemberCount"/> and <see cref="ApproximatePresenceCount"/> | |||||
| /// will be updated as well. | |||||
| /// </param> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <remarks> | |||||
| /// If <paramref name="withCounts"/> is true, <see cref="ApproximateMemberCount"/> and | |||||
| /// <see cref="ApproximatePresenceCount"/> will be updated as well. | |||||
| /// </remarks> | |||||
| public async Task UpdateAsync(bool withCounts, RequestOptions options = null) | |||||
| => Update(await Discord.ApiClient.GetGuildAsync(Id, withCounts, options).ConfigureAwait(false)); | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public Task DeleteAsync(RequestOptions options = null) | public Task DeleteAsync(RequestOptions options = null) | ||||
| => GuildHelper.DeleteAsync(this, Discord, options); | => GuildHelper.DeleteAsync(this, Discord, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| public async Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | public async Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | ||||
| { | { | ||||
| var model = await GuildHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false); | var model = await GuildHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false); | ||||
| @@ -181,7 +243,8 @@ namespace Discord.Rest | |||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| [Obsolete("This endpoint is deprecated, use ModifyWidgetAsync instead.")] | |||||
| public async Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | public async Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | ||||
| { | { | ||||
| var model = await GuildHelper.ModifyEmbedAsync(this, Discord, func, options).ConfigureAwait(false); | var model = await GuildHelper.ModifyEmbedAsync(this, Discord, func, options).ConfigureAwait(false); | ||||
| @@ -189,7 +252,15 @@ namespace Discord.Rest | |||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="args" /> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| public async Task ModifyWidgetAsync(Action<GuildWidgetProperties> func, RequestOptions options = null) | |||||
| { | |||||
| var model = await GuildHelper.ModifyWidgetAsync(this, Discord, func, options).ConfigureAwait(false); | |||||
| Update(model); | |||||
| } | |||||
| /// <inheritdoc /> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="args" /> is <see langword="null"/>.</exception> | |||||
| public async Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null) | public async Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null) | ||||
| { | { | ||||
| var arr = args.ToArray(); | var arr = args.ToArray(); | ||||
| @@ -205,7 +276,7 @@ namespace Discord.Rest | |||||
| role?.Update(model); | role?.Update(model); | ||||
| } | } | ||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public Task LeaveAsync(RequestOptions options = null) | public Task LeaveAsync(RequestOptions options = null) | ||||
| => GuildHelper.LeaveAsync(this, Discord, options); | => GuildHelper.LeaveAsync(this, Discord, options); | ||||
| @@ -230,7 +301,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains a ban object, which | /// A task that represents the asynchronous get operation. The task result contains a ban object, which | ||||
| /// contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found. | |||||
| /// contains the user information and the reason for the ban; <see langword="null"/> if the ban entry cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestBan> GetBanAsync(IUser user, RequestOptions options = null) | public Task<RestBan> GetBanAsync(IUser user, RequestOptions options = null) | ||||
| => GuildHelper.GetBanAsync(this, Discord, user.Id, options); | => GuildHelper.GetBanAsync(this, Discord, user.Id, options); | ||||
| @@ -241,7 +312,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains a ban object, which | /// A task that represents the asynchronous get operation. The task result contains a ban object, which | ||||
| /// contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found. | |||||
| /// contains the user information and the reason for the ban; <see langword="null"/> if the ban entry cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestBan> GetBanAsync(ulong userId, RequestOptions options = null) | public Task<RestBan> GetBanAsync(ulong userId, RequestOptions options = null) | ||||
| => GuildHelper.GetBanAsync(this, Discord, userId, options); | => GuildHelper.GetBanAsync(this, Discord, userId, options); | ||||
| @@ -279,7 +350,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the generic channel | /// A task that represents the asynchronous get operation. The task result contains the generic channel | ||||
| /// associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestGuildChannel> GetChannelAsync(ulong id, RequestOptions options = null) | public Task<RestGuildChannel> GetChannelAsync(ulong id, RequestOptions options = null) | ||||
| => GuildHelper.GetChannelAsync(this, Discord, id, options); | => GuildHelper.GetChannelAsync(this, Discord, id, options); | ||||
| @@ -291,7 +362,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel | /// A task that represents the asynchronous get operation. The task result contains the text channel | ||||
| /// associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public async Task<RestTextChannel> GetTextChannelAsync(ulong id, RequestOptions options = null) | public async Task<RestTextChannel> GetTextChannelAsync(ulong id, RequestOptions options = null) | ||||
| { | { | ||||
| @@ -320,7 +391,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the voice channel associated | /// A task that represents the asynchronous get operation. The task result contains the voice channel associated | ||||
| /// with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public async Task<RestVoiceChannel> GetVoiceChannelAsync(ulong id, RequestOptions options = null) | public async Task<RestVoiceChannel> GetVoiceChannelAsync(ulong id, RequestOptions options = null) | ||||
| { | { | ||||
| @@ -362,7 +433,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the voice channel that the | /// A task that represents the asynchronous get operation. The task result contains the voice channel that the | ||||
| /// AFK users will be moved to after they have idled for too long; <c>null</c> if none is set. | |||||
| /// AFK users will be moved to after they have idled for too long; <see langword="null"/> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| public async Task<RestVoiceChannel> GetAFKChannelAsync(RequestOptions options = null) | public async Task<RestVoiceChannel> GetAFKChannelAsync(RequestOptions options = null) | ||||
| { | { | ||||
| @@ -381,7 +452,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the first viewable text | /// A task that represents the asynchronous get operation. The task result contains the first viewable text | ||||
| /// channel in this guild; <c>null</c> if none is found. | |||||
| /// channel in this guild; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public async Task<RestTextChannel> GetDefaultChannelAsync(RequestOptions options = null) | public async Task<RestTextChannel> GetDefaultChannelAsync(RequestOptions options = null) | ||||
| { | { | ||||
| @@ -399,8 +470,9 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the embed channel set | /// A task that represents the asynchronous get operation. The task result contains the embed channel set | ||||
| /// within the server's widget settings; <c>null</c> if none is set. | |||||
| /// within the server's widget settings; <see langword="null"/> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| [Obsolete("This endpoint is deprecated, use GetWidgetChannelAsync instead.")] | |||||
| public async Task<RestGuildChannel> GetEmbedChannelAsync(RequestOptions options = null) | public async Task<RestGuildChannel> GetEmbedChannelAsync(RequestOptions options = null) | ||||
| { | { | ||||
| var embedId = EmbedChannelId; | var embedId = EmbedChannelId; | ||||
| @@ -410,12 +482,28 @@ namespace Discord.Rest | |||||
| } | } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the first viewable text channel in this guild. | |||||
| /// Gets the widget channel (i.e. the channel set in the guild's widget settings) in this guild. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the first viewable text | |||||
| /// channel in this guild; <c>null</c> if none is found. | |||||
| /// A task that represents the asynchronous get operation. The task result contains the widget channel set | |||||
| /// within the server's widget settings; <see langword="null"/> if none is set. | |||||
| /// </returns> | |||||
| public async Task<RestGuildChannel> GetWidgetChannelAsync(RequestOptions options = null) | |||||
| { | |||||
| var widgetChannelId = WidgetChannelId; | |||||
| if (widgetChannelId.HasValue) | |||||
| return await GuildHelper.GetChannelAsync(this, Discord, widgetChannelId.Value, options).ConfigureAwait(false); | |||||
| return null; | |||||
| } | |||||
| /// <summary> | |||||
| /// Gets the text channel where guild notices such as welcome messages and boost events are posted. | |||||
| /// </summary> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel | |||||
| /// where guild notices such as welcome messages and boost events are poste; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public async Task<RestTextChannel> GetSystemChannelAsync(RequestOptions options = null) | public async Task<RestTextChannel> GetSystemChannelAsync(RequestOptions options = null) | ||||
| { | { | ||||
| @@ -427,6 +515,45 @@ namespace Discord.Rest | |||||
| } | } | ||||
| return null; | return null; | ||||
| } | } | ||||
| /// <summary> | |||||
| /// Gets the text channel where Community guilds can display rules and/or guidelines. | |||||
| /// </summary> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel | |||||
| /// where Community guilds can display rules and/or guidelines; <see langword="null"/> if none is set. | |||||
| /// </returns> | |||||
| public async Task<RestTextChannel> GetRulesChannelAsync(RequestOptions options = null) | |||||
| { | |||||
| var rulesChannelId = RulesChannelId; | |||||
| if (rulesChannelId.HasValue) | |||||
| { | |||||
| var channel = await GuildHelper.GetChannelAsync(this, Discord, rulesChannelId.Value, options).ConfigureAwait(false); | |||||
| return channel as RestTextChannel; | |||||
| } | |||||
| return null; | |||||
| } | |||||
| /// <summary> | |||||
| /// Gets the text channel channel where admins and moderators of Community guilds receive notices from Discord. | |||||
| /// </summary> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous get operation. The task result contains the text channel channel where | |||||
| /// admins and moderators of Community guilds receive notices from Discord; <see langword="null"/> if none is set. | |||||
| /// </returns> | |||||
| public async Task<RestTextChannel> GetPublicUpdatesChannelAsync(RequestOptions options = null) | |||||
| { | |||||
| var publicUpdatesChannelId = PublicUpdatesChannelId; | |||||
| if (publicUpdatesChannelId.HasValue) | |||||
| { | |||||
| var channel = await GuildHelper.GetChannelAsync(this, Discord, publicUpdatesChannelId.Value, options).ConfigureAwait(false); | |||||
| return channel as RestTextChannel; | |||||
| } | |||||
| return null; | |||||
| } | |||||
| /// <summary> | /// <summary> | ||||
| /// Creates a new text channel in this guild. | /// Creates a new text channel in this guild. | ||||
| /// </summary> | /// </summary> | ||||
| @@ -458,7 +585,7 @@ namespace Discord.Rest | |||||
| /// <param name="name">The name of the new channel.</param> | /// <param name="name">The name of the new channel.</param> | ||||
| /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name" /> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name" /> is <see langword="null"/>.</exception> | |||||
| /// <returns> | /// <returns> | ||||
| /// The created voice channel. | /// The created voice channel. | ||||
| /// </returns> | /// </returns> | ||||
| @@ -470,7 +597,7 @@ namespace Discord.Rest | |||||
| /// <param name="name">The name of the new channel.</param> | /// <param name="name">The name of the new channel.</param> | ||||
| /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name" /> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name" /> is <see langword="null"/>.</exception> | |||||
| /// <returns> | /// <returns> | ||||
| /// The created category channel. | /// The created category channel. | ||||
| /// </returns> | /// </returns> | ||||
| @@ -521,7 +648,7 @@ namespace Discord.Rest | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the role.</param> | /// <param name="id">The snowflake identifier for the role.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A role that is associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// A role that is associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public RestRole GetRole(ulong id) | public RestRole GetRole(ulong id) | ||||
| { | { | ||||
| @@ -585,7 +712,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the guild user | /// A task that represents the asynchronous get operation. The task result contains the guild user | ||||
| /// associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestGuildUser> GetUserAsync(ulong id, RequestOptions options = null) | public Task<RestGuildUser> GetUserAsync(ulong id, RequestOptions options = null) | ||||
| => GuildHelper.GetUserAsync(this, Discord, id, options); | => GuildHelper.GetUserAsync(this, Discord, id, options); | ||||
| @@ -631,8 +758,8 @@ namespace Discord.Rest | |||||
| /// A task that represents the asynchronous prune operation. The task result contains the number of users to | /// A task that represents the asynchronous prune operation. The task result contains the number of users to | ||||
| /// be or has been removed from this guild. | /// be or has been removed from this guild. | ||||
| /// </returns> | /// </returns> | ||||
| public Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null) | |||||
| => GuildHelper.PruneUsersAsync(this, Discord, days, simulate, options); | |||||
| public Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null, IEnumerable<ulong> includeRoleIds = null) | |||||
| => GuildHelper.PruneUsersAsync(this, Discord, days, simulate, options, includeRoleIds); | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets a collection of users in this guild that the name or nickname starts with the | /// Gets a collection of users in this guild that the name or nickname starts with the | ||||
| @@ -675,7 +802,7 @@ namespace Discord.Rest | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the webhook with the | /// A task that represents the asynchronous get operation. The task result contains the webhook with the | ||||
| /// specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null) | public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null) | ||||
| => GuildHelper.GetWebhookAsync(this, Discord, id, options); | => GuildHelper.GetWebhookAsync(this, Discord, id, options); | ||||
| @@ -708,7 +835,7 @@ namespace Discord.Rest | |||||
| public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null) | public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null) | ||||
| => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options); | => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null) | public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options); | => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -808,6 +935,7 @@ namespace Discord.Rest | |||||
| return null; | return null; | ||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| [Obsolete("This endpoint is deprecated, use GetWidgetChannelAsync instead.")] | |||||
| async Task<IGuildChannel> IGuild.GetEmbedChannelAsync(CacheMode mode, RequestOptions options) | async Task<IGuildChannel> IGuild.GetEmbedChannelAsync(CacheMode mode, RequestOptions options) | ||||
| { | { | ||||
| if (mode == CacheMode.AllowDownload) | if (mode == CacheMode.AllowDownload) | ||||
| @@ -816,6 +944,14 @@ namespace Discord.Rest | |||||
| return null; | return null; | ||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| async Task<IGuildChannel> IGuild.GetWidgetChannelAsync(CacheMode mode, RequestOptions options) | |||||
| { | |||||
| if (mode == CacheMode.AllowDownload) | |||||
| return await GetWidgetChannelAsync(options).ConfigureAwait(false); | |||||
| else | |||||
| return null; | |||||
| } | |||||
| /// <inheritdoc /> | |||||
| async Task<ITextChannel> IGuild.GetSystemChannelAsync(CacheMode mode, RequestOptions options) | async Task<ITextChannel> IGuild.GetSystemChannelAsync(CacheMode mode, RequestOptions options) | ||||
| { | { | ||||
| if (mode == CacheMode.AllowDownload) | if (mode == CacheMode.AllowDownload) | ||||
| @@ -824,6 +960,22 @@ namespace Discord.Rest | |||||
| return null; | return null; | ||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| async Task<ITextChannel> IGuild.GetRulesChannelAsync(CacheMode mode, RequestOptions options) | |||||
| { | |||||
| if (mode == CacheMode.AllowDownload) | |||||
| return await GetRulesChannelAsync(options).ConfigureAwait(false); | |||||
| else | |||||
| return null; | |||||
| } | |||||
| /// <inheritdoc /> | |||||
| async Task<ITextChannel> IGuild.GetPublicUpdatesChannelAsync(CacheMode mode, RequestOptions options) | |||||
| { | |||||
| if (mode == CacheMode.AllowDownload) | |||||
| return await GetPublicUpdatesChannelAsync(options).ConfigureAwait(false); | |||||
| else | |||||
| return null; | |||||
| } | |||||
| /// <inheritdoc /> | |||||
| async Task<ITextChannel> IGuild.CreateTextChannelAsync(string name, Action<TextChannelProperties> func, RequestOptions options) | async Task<ITextChannel> IGuild.CreateTextChannelAsync(string name, Action<TextChannelProperties> func, RequestOptions options) | ||||
| => await CreateTextChannelAsync(name, func, options).ConfigureAwait(false); | => await CreateTextChannelAsync(name, func, options).ConfigureAwait(false); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -0,0 +1,25 @@ | |||||
| using System.Diagnostics; | |||||
| using Model = Discord.API.GuildWidget; | |||||
| namespace Discord.Rest | |||||
| { | |||||
| [DebuggerDisplay(@"{DebuggerDisplay,nq}")] | |||||
| public struct RestGuildWidget | |||||
| { | |||||
| public bool IsEnabled { get; private set; } | |||||
| public ulong? ChannelId { get; private set; } | |||||
| internal RestGuildWidget(bool isEnabled, ulong? channelId) | |||||
| { | |||||
| ChannelId = channelId; | |||||
| IsEnabled = isEnabled; | |||||
| } | |||||
| internal static RestGuildWidget Create(Model model) | |||||
| { | |||||
| return new RestGuildWidget(model.Enabled, model.ChannelId); | |||||
| } | |||||
| public override string ToString() => ChannelId?.ToString() ?? "Unknown"; | |||||
| private string DebuggerDisplay => $"{ChannelId} ({(IsEnabled ? "Enabled" : "Disabled")})"; | |||||
| } | |||||
| } | |||||
| @@ -65,12 +65,12 @@ namespace Discord.Rest | |||||
| public static async Task AddReactionAsync(IMessage msg, IEmote emote, BaseDiscordClient client, RequestOptions options) | public static async Task AddReactionAsync(IMessage msg, IEmote emote, BaseDiscordClient client, RequestOptions options) | ||||
| { | { | ||||
| await client.ApiClient.AddReactionAsync(msg.Channel.Id, msg.Id, emote is Emote e ? $"{e.Name}:{e.Id}" : emote.Name, options).ConfigureAwait(false); | |||||
| await client.ApiClient.AddReactionAsync(msg.Channel.Id, msg.Id, emote is Emote e ? $"{e.Name}:{e.Id}" : UrlEncode(emote.Name), options).ConfigureAwait(false); | |||||
| } | } | ||||
| public static async Task RemoveReactionAsync(IMessage msg, ulong userId, IEmote emote, BaseDiscordClient client, RequestOptions options) | public static async Task RemoveReactionAsync(IMessage msg, ulong userId, IEmote emote, BaseDiscordClient client, RequestOptions options) | ||||
| { | { | ||||
| await client.ApiClient.RemoveReactionAsync(msg.Channel.Id, msg.Id, userId, emote is Emote e ? $"{e.Name}:{e.Id}" : emote.Name, options).ConfigureAwait(false); | |||||
| await client.ApiClient.RemoveReactionAsync(msg.Channel.Id, msg.Id, userId, emote is Emote e ? $"{e.Name}:{e.Id}" : UrlEncode(emote.Name), options).ConfigureAwait(false); | |||||
| } | } | ||||
| public static async Task RemoveAllReactionsAsync(IMessage msg, BaseDiscordClient client, RequestOptions options) | public static async Task RemoveAllReactionsAsync(IMessage msg, BaseDiscordClient client, RequestOptions options) | ||||
| @@ -80,14 +80,14 @@ namespace Discord.Rest | |||||
| public static async Task RemoveAllReactionsForEmoteAsync(IMessage msg, IEmote emote, BaseDiscordClient client, RequestOptions options) | public static async Task RemoveAllReactionsForEmoteAsync(IMessage msg, IEmote emote, BaseDiscordClient client, RequestOptions options) | ||||
| { | { | ||||
| await client.ApiClient.RemoveAllReactionsForEmoteAsync(msg.Channel.Id, msg.Id, emote is Emote e ? $"{e.Name}:{e.Id}" : emote.Name, options).ConfigureAwait(false); | |||||
| await client.ApiClient.RemoveAllReactionsForEmoteAsync(msg.Channel.Id, msg.Id, emote is Emote e ? $"{e.Name}:{e.Id}" : UrlEncode(emote.Name), options).ConfigureAwait(false); | |||||
| } | } | ||||
| public static IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IMessage msg, IEmote emote, | public static IAsyncEnumerable<IReadOnlyCollection<IUser>> GetReactionUsersAsync(IMessage msg, IEmote emote, | ||||
| int? limit, BaseDiscordClient client, RequestOptions options) | int? limit, BaseDiscordClient client, RequestOptions options) | ||||
| { | { | ||||
| Preconditions.NotNull(emote, nameof(emote)); | Preconditions.NotNull(emote, nameof(emote)); | ||||
| var emoji = (emote is Emote e ? $"{e.Name}:{e.Id}" : emote.Name); | |||||
| var emoji = (emote is Emote e ? $"{e.Name}:{e.Id}" : UrlEncode(emote.Name)); | |||||
| return new PagedAsyncEnumerable<IUser>( | return new PagedAsyncEnumerable<IUser>( | ||||
| DiscordConfig.MaxUserReactionsPerBatch, | DiscordConfig.MaxUserReactionsPerBatch, | ||||
| @@ -114,7 +114,15 @@ namespace Discord.Rest | |||||
| }, | }, | ||||
| count: limit | count: limit | ||||
| ); | ); | ||||
| } | |||||
| private static string UrlEncode(string text) | |||||
| { | |||||
| #if NET461 | |||||
| return System.Net.WebUtility.UrlEncode(text); | |||||
| #else | |||||
| return System.Web.HttpUtility.UrlEncode(text); | |||||
| #endif | |||||
| } | } | ||||
| public static async Task PinAsync(IMessage msg, BaseDiscordClient client, | public static async Task PinAsync(IMessage msg, BaseDiscordClient client, | ||||
| @@ -37,6 +37,9 @@ namespace Discord.Rest | |||||
| public virtual bool IsSuppressed => false; | public virtual bool IsSuppressed => false; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public virtual DateTimeOffset? EditedTimestamp => null; | public virtual DateTimeOffset? EditedTimestamp => null; | ||||
| /// <inheritdoc /> | |||||
| public virtual bool MentionedEveryone => false; | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets a collection of the <see cref="Attachment"/>'s on the message. | /// Gets a collection of the <see cref="Attachment"/>'s on the message. | ||||
| /// </summary> | /// </summary> | ||||
| @@ -18,6 +18,8 @@ namespace Discord.Rest | |||||
| private ImmutableArray<Attachment> _attachments = ImmutableArray.Create<Attachment>(); | private ImmutableArray<Attachment> _attachments = ImmutableArray.Create<Attachment>(); | ||||
| private ImmutableArray<Embed> _embeds = ImmutableArray.Create<Embed>(); | private ImmutableArray<Embed> _embeds = ImmutableArray.Create<Embed>(); | ||||
| private ImmutableArray<ITag> _tags = ImmutableArray.Create<ITag>(); | private ImmutableArray<ITag> _tags = ImmutableArray.Create<ITag>(); | ||||
| private ImmutableArray<ulong> _roleMentionIds = ImmutableArray.Create<ulong>(); | |||||
| private ImmutableArray<RestUser> _userMentions = ImmutableArray.Create<RestUser>(); | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override bool IsTTS => _isTTS; | public override bool IsTTS => _isTTS; | ||||
| @@ -28,15 +30,17 @@ namespace Discord.Rest | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override DateTimeOffset? EditedTimestamp => DateTimeUtils.FromTicks(_editedTimestampTicks); | public override DateTimeOffset? EditedTimestamp => DateTimeUtils.FromTicks(_editedTimestampTicks); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override bool MentionedEveryone => _isMentioningEveryone; | |||||
| /// <inheritdoc /> | |||||
| public override IReadOnlyCollection<Attachment> Attachments => _attachments; | public override IReadOnlyCollection<Attachment> Attachments => _attachments; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<Embed> Embeds => _embeds; | public override IReadOnlyCollection<Embed> Embeds => _embeds; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<ulong> MentionedChannelIds => MessageHelper.FilterTagsByKey(TagType.ChannelMention, _tags); | public override IReadOnlyCollection<ulong> MentionedChannelIds => MessageHelper.FilterTagsByKey(TagType.ChannelMention, _tags); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<ulong> MentionedRoleIds => MessageHelper.FilterTagsByKey(TagType.RoleMention, _tags); | |||||
| public override IReadOnlyCollection<ulong> MentionedRoleIds => _roleMentionIds; | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<RestUser> MentionedUsers => MessageHelper.FilterTagsByValue<RestUser>(TagType.UserMention, _tags); | |||||
| public override IReadOnlyCollection<RestUser> MentionedUsers => _userMentions; | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<ITag> Tags => _tags; | public override IReadOnlyCollection<ITag> Tags => _tags; | ||||
| @@ -67,6 +71,8 @@ namespace Discord.Rest | |||||
| { | { | ||||
| _isSuppressed = model.Flags.Value.HasFlag(API.MessageFlags.Suppressed); | _isSuppressed = model.Flags.Value.HasFlag(API.MessageFlags.Suppressed); | ||||
| } | } | ||||
| if (model.RoleMentions.IsSpecified) | |||||
| _roleMentionIds = model.RoleMentions.Value.ToImmutableArray(); | |||||
| if (model.Attachments.IsSpecified) | if (model.Attachments.IsSpecified) | ||||
| { | { | ||||
| @@ -96,20 +102,19 @@ namespace Discord.Rest | |||||
| _embeds = ImmutableArray.Create<Embed>(); | _embeds = ImmutableArray.Create<Embed>(); | ||||
| } | } | ||||
| ImmutableArray<IUser> mentions = ImmutableArray.Create<IUser>(); | |||||
| if (model.UserMentions.IsSpecified) | if (model.UserMentions.IsSpecified) | ||||
| { | { | ||||
| var value = model.UserMentions.Value; | var value = model.UserMentions.Value; | ||||
| if (value.Length > 0) | if (value.Length > 0) | ||||
| { | { | ||||
| var newMentions = ImmutableArray.CreateBuilder<IUser>(value.Length); | |||||
| var newMentions = ImmutableArray.CreateBuilder<RestUser>(value.Length); | |||||
| for (int i = 0; i < value.Length; i++) | for (int i = 0; i < value.Length; i++) | ||||
| { | { | ||||
| var val = value[i]; | var val = value[i]; | ||||
| if (val.Object != null) | if (val.Object != null) | ||||
| newMentions.Add(RestUser.Create(Discord, val.Object)); | newMentions.Add(RestUser.Create(Discord, val.Object)); | ||||
| } | } | ||||
| mentions = newMentions.ToImmutable(); | |||||
| _userMentions = newMentions.ToImmutable(); | |||||
| } | } | ||||
| } | } | ||||
| @@ -118,7 +123,7 @@ namespace Discord.Rest | |||||
| var text = model.Content.Value; | var text = model.Content.Value; | ||||
| var guildId = (Channel as IGuildChannel)?.GuildId; | var guildId = (Channel as IGuildChannel)?.GuildId; | ||||
| var guild = guildId != null ? (Discord as IDiscordClient).GetGuildAsync(guildId.Value, CacheMode.CacheOnly).Result : null; | var guild = guildId != null ? (Discord as IDiscordClient).GetGuildAsync(guildId.Value, CacheMode.CacheOnly).Result : null; | ||||
| _tags = MessageHelper.ParseTags(text, null, guild, mentions); | |||||
| _tags = MessageHelper.ParseTags(text, null, guild, _userMentions); | |||||
| model.Content = text; | model.Content = text; | ||||
| } | } | ||||
| } | } | ||||
| @@ -149,10 +154,10 @@ namespace Discord.Rest | |||||
| => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="RestNewsChannel"/> channel.</exception> | |||||
| /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="INewsChannel"/> channel.</exception> | |||||
| public async Task CrosspostAsync(RequestOptions options = null) | public async Task CrosspostAsync(RequestOptions options = null) | ||||
| { | { | ||||
| if (!(Channel is RestNewsChannel)) | |||||
| if (!(Channel is INewsChannel)) | |||||
| { | { | ||||
| throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels."); | throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels."); | ||||
| } | } | ||||
| @@ -21,6 +21,12 @@ namespace Discord.Rest | |||||
| public string[] RPCOrigins { get; private set; } | public string[] RPCOrigins { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public ulong Flags { get; private set; } | public ulong Flags { get; private set; } | ||||
| /// <inheritdoc /> | |||||
| public bool IsBotPublic { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public bool BotRequiresCodeGrant { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public ITeam Team { get; private set; } | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public IUser Owner { get; private set; } | public IUser Owner { get; private set; } | ||||
| @@ -46,11 +52,15 @@ namespace Discord.Rest | |||||
| RPCOrigins = model.RPCOrigins; | RPCOrigins = model.RPCOrigins; | ||||
| Name = model.Name; | Name = model.Name; | ||||
| _iconId = model.Icon; | _iconId = model.Icon; | ||||
| IsBotPublic = model.IsBotPublic; | |||||
| BotRequiresCodeGrant = model.BotRequiresCodeGrant; | |||||
| if (model.Flags.IsSpecified) | if (model.Flags.IsSpecified) | ||||
| Flags = model.Flags.Value; //TODO: Do we still need this? | Flags = model.Flags.Value; //TODO: Do we still need this? | ||||
| if (model.Owner.IsSpecified) | if (model.Owner.IsSpecified) | ||||
| Owner = RestUser.Create(Discord, model.Owner.Value); | Owner = RestUser.Create(Discord, model.Owner.Value); | ||||
| if (model.Team != null) | |||||
| Team = RestTeam.Create(Discord, model.Team); | |||||
| } | } | ||||
| /// <exception cref="InvalidOperationException">Unable to update this object from a different application token.</exception> | /// <exception cref="InvalidOperationException">Unable to update this object from a different application token.</exception> | ||||
| @@ -0,0 +1,37 @@ | |||||
| using System.Collections.Generic; | |||||
| using System.Collections.Immutable; | |||||
| using System.Linq; | |||||
| using Model = Discord.API.Team; | |||||
| namespace Discord.Rest | |||||
| { | |||||
| public class RestTeam : RestEntity<ulong>, ITeam | |||||
| { | |||||
| /// <inheritdoc /> | |||||
| public string IconUrl => _iconId != null ? CDN.GetTeamIconUrl(Id, _iconId) : null; | |||||
| /// <inheritdoc /> | |||||
| public IReadOnlyList<ITeamMember> TeamMembers { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public ulong OwnerUserId { get; private set; } | |||||
| private string _iconId; | |||||
| internal RestTeam(BaseDiscordClient discord, ulong id) | |||||
| : base(discord, id) | |||||
| { | |||||
| } | |||||
| internal static RestTeam Create(BaseDiscordClient discord, Model model) | |||||
| { | |||||
| var entity = new RestTeam(discord, model.Id); | |||||
| entity.Update(model); | |||||
| return entity; | |||||
| } | |||||
| internal virtual void Update(Model model) | |||||
| { | |||||
| if (model.Icon.IsSpecified) | |||||
| _iconId = model.Icon.Value; | |||||
| OwnerUserId = model.OwnerUserId; | |||||
| TeamMembers = model.TeamMembers.Select(x => new RestTeamMember(Discord, x)).ToImmutableArray(); | |||||
| } | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,30 @@ | |||||
| using System; | |||||
| using Model = Discord.API.TeamMember; | |||||
| namespace Discord.Rest | |||||
| { | |||||
| public class RestTeamMember : ITeamMember | |||||
| { | |||||
| /// <inheritdoc /> | |||||
| public MembershipState MembershipState { get; } | |||||
| /// <inheritdoc /> | |||||
| public string[] Permissions { get; } | |||||
| /// <inheritdoc /> | |||||
| public ulong TeamId { get; } | |||||
| /// <inheritdoc /> | |||||
| public IUser User { get; } | |||||
| internal RestTeamMember(BaseDiscordClient discord, Model model) | |||||
| { | |||||
| MembershipState = model.MembershipState switch | |||||
| { | |||||
| API.MembershipState.Invited => MembershipState.Invited, | |||||
| API.MembershipState.Accepted => MembershipState.Accepted, | |||||
| _ => throw new InvalidOperationException("Invalid membership state"), | |||||
| }; | |||||
| Permissions = model.Permissions; | |||||
| TeamId = model.TeamId; | |||||
| User = RestUser.Create(discord, model.User); | |||||
| } | |||||
| } | |||||
| } | |||||
| @@ -12,7 +12,7 @@ namespace Discord.Net.Queue | |||||
| { | { | ||||
| internal class RequestQueue : IDisposable | internal class RequestQueue : IDisposable | ||||
| { | { | ||||
| public event Func<BucketId, RateLimitInfo?, Task> RateLimitTriggered; | |||||
| public event Func<BucketId, RateLimitInfo?, string, Task> RateLimitTriggered; | |||||
| private readonly ConcurrentDictionary<BucketId, object> _buckets; | private readonly ConcurrentDictionary<BucketId, object> _buckets; | ||||
| private readonly SemaphoreSlim _tokenLock; | private readonly SemaphoreSlim _tokenLock; | ||||
| @@ -190,9 +190,9 @@ namespace Discord.Net.Queue | |||||
| } | } | ||||
| return (RequestBucket)obj; | return (RequestBucket)obj; | ||||
| } | } | ||||
| internal async Task RaiseRateLimitTriggered(BucketId bucketId, RateLimitInfo? info) | |||||
| internal async Task RaiseRateLimitTriggered(BucketId bucketId, RateLimitInfo? info, string endpoint) | |||||
| { | { | ||||
| await RateLimitTriggered(bucketId, info).ConfigureAwait(false); | |||||
| await RateLimitTriggered(bucketId, info, endpoint).ConfigureAwait(false); | |||||
| } | } | ||||
| internal (RequestBucket, BucketId) UpdateBucketHash(BucketId id, string discordHash) | internal (RequestBucket, BucketId) UpdateBucketHash(BucketId id, string discordHash) | ||||
| { | { | ||||
| @@ -86,7 +86,7 @@ namespace Discord.Net.Queue | |||||
| #endif | #endif | ||||
| UpdateRateLimit(id, request, info, true); | UpdateRateLimit(id, request, info, true); | ||||
| } | } | ||||
| await _queue.RaiseRateLimitTriggered(Id, info).ConfigureAwait(false); | |||||
| await _queue.RaiseRateLimitTriggered(Id, info, $"{request.Method} {request.Endpoint}").ConfigureAwait(false); | |||||
| continue; //Retry | continue; //Retry | ||||
| case HttpStatusCode.BadGateway: //502 | case HttpStatusCode.BadGateway: //502 | ||||
| #if DEBUG_LIMITS | #if DEBUG_LIMITS | ||||
| @@ -249,7 +249,7 @@ namespace Discord.Net.Queue | |||||
| if (!isRateLimited) | if (!isRateLimited) | ||||
| { | { | ||||
| isRateLimited = true; | isRateLimited = true; | ||||
| await _queue.RaiseRateLimitTriggered(Id, null).ConfigureAwait(false); | |||||
| await _queue.RaiseRateLimitTriggered(Id, null, $"{request.Method} {request.Endpoint}").ConfigureAwait(false); | |||||
| } | } | ||||
| ThrowRetryLimit(request); | ThrowRetryLimit(request); | ||||
| @@ -0,0 +1,31 @@ | |||||
| using Newtonsoft.Json; | |||||
| using System; | |||||
| namespace Discord.API.Gateway | |||||
| { | |||||
| internal class InviteCreateEvent | |||||
| { | |||||
| [JsonProperty("channel_id")] | |||||
| public ulong ChannelId { get; set; } | |||||
| [JsonProperty("code")] | |||||
| public string Code { get; set; } | |||||
| [JsonProperty("created_at")] | |||||
| public DateTimeOffset CreatedAt { get; set; } | |||||
| [JsonProperty("guild_id")] | |||||
| public Optional<ulong> GuildId { get; set; } | |||||
| [JsonProperty("inviter")] | |||||
| public Optional<User> Inviter { get; set; } | |||||
| [JsonProperty("max_age")] | |||||
| public int MaxAge { get; set; } | |||||
| [JsonProperty("max_uses")] | |||||
| public int MaxUses { get; set; } | |||||
| [JsonProperty("target_user")] | |||||
| public Optional<User> TargetUser { get; set; } | |||||
| [JsonProperty("target_user_type")] | |||||
| public Optional<TargetUserType> TargetUserType { get; set; } | |||||
| [JsonProperty("temporary")] | |||||
| public bool Temporary { get; set; } | |||||
| [JsonProperty("uses")] | |||||
| public int Uses { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,14 @@ | |||||
| using Newtonsoft.Json; | |||||
| namespace Discord.API.Gateway | |||||
| { | |||||
| internal class InviteDeleteEvent | |||||
| { | |||||
| [JsonProperty("channel_id")] | |||||
| public ulong ChannelId { get; set; } | |||||
| [JsonProperty("code")] | |||||
| public string Code { get; set; } | |||||
| [JsonProperty("guild_id")] | |||||
| public Optional<ulong> GuildId { get; set; } | |||||
| } | |||||
| } | |||||
| @@ -99,6 +99,12 @@ namespace Discord.Audio | |||||
| _token = token; | _token = token; | ||||
| await _connection.StartAsync().ConfigureAwait(false); | await _connection.StartAsync().ConfigureAwait(false); | ||||
| } | } | ||||
| public IReadOnlyDictionary<ulong, AudioInStream> GetStreams() | |||||
| { | |||||
| return _streams.ToDictionary(pair => pair.Key, pair => pair.Value.Reader); | |||||
| } | |||||
| public async Task StopAsync() | public async Task StopAsync() | ||||
| { | { | ||||
| await _connection.StopAsync().ConfigureAwait(false); | await _connection.StopAsync().ConfigureAwait(false); | ||||
| @@ -379,7 +385,7 @@ namespace Discord.Audio | |||||
| private async Task RunHeartbeatAsync(int intervalMillis, CancellationToken cancelToken) | private async Task RunHeartbeatAsync(int intervalMillis, CancellationToken cancelToken) | ||||
| { | { | ||||
| //TODO: Clean this up when Discord's session patch is live | |||||
| // TODO: Clean this up when Discord's session patch is live | |||||
| try | try | ||||
| { | { | ||||
| await _audioLogger.DebugAsync("Heartbeat Started").ConfigureAwait(false); | await _audioLogger.DebugAsync("Heartbeat Started").ConfigureAwait(false); | ||||
| @@ -61,14 +61,17 @@ namespace Discord.Audio.Streams | |||||
| _task = Run(); | _task = Run(); | ||||
| } | } | ||||
| protected override void Dispose(bool disposing) | protected override void Dispose(bool disposing) | ||||
| { | { | ||||
| if (disposing) | if (disposing) | ||||
| { | { | ||||
| _disposeTokenSource?.Cancel(); | _disposeTokenSource?.Cancel(); | ||||
| _disposeTokenSource?.Dispose(); | _disposeTokenSource?.Dispose(); | ||||
| _cancelTokenSource?.Cancel(); | |||||
| _cancelTokenSource?.Dispose(); | _cancelTokenSource?.Dispose(); | ||||
| _queueLock?.Dispose(); | _queueLock?.Dispose(); | ||||
| _next.Dispose(); | |||||
| } | } | ||||
| base.Dispose(disposing); | base.Dispose(disposing); | ||||
| } | } | ||||
| @@ -68,10 +68,12 @@ namespace Discord.Audio.Streams | |||||
| protected override void Dispose(bool disposing) | protected override void Dispose(bool disposing) | ||||
| { | { | ||||
| base.Dispose(disposing); | |||||
| if (disposing) | if (disposing) | ||||
| { | |||||
| _decoder.Dispose(); | _decoder.Dispose(); | ||||
| _next.Dispose(); | |||||
| } | |||||
| base.Dispose(disposing); | |||||
| } | } | ||||
| } | } | ||||
| } | } | ||||
| @@ -1,4 +1,4 @@ | |||||
| using System; | |||||
| using System; | |||||
| using System.Threading; | using System.Threading; | ||||
| using System.Threading.Tasks; | using System.Threading.Tasks; | ||||
| @@ -89,10 +89,12 @@ namespace Discord.Audio.Streams | |||||
| protected override void Dispose(bool disposing) | protected override void Dispose(bool disposing) | ||||
| { | { | ||||
| base.Dispose(disposing); | |||||
| if (disposing) | if (disposing) | ||||
| { | |||||
| _encoder.Dispose(); | _encoder.Dispose(); | ||||
| _next.Dispose(); | |||||
| } | |||||
| base.Dispose(disposing); | |||||
| } | } | ||||
| } | } | ||||
| } | } | ||||
| @@ -76,5 +76,12 @@ namespace Discord.Audio.Streams | |||||
| (buffer[extensionOffset + 3]); | (buffer[extensionOffset + 3]); | ||||
| return extensionOffset + 4 + (extensionLength * 4); | return extensionOffset + 4 + (extensionLength * 4); | ||||
| } | } | ||||
| protected override void Dispose(bool disposing) | |||||
| { | |||||
| if (disposing) | |||||
| _next.Dispose(); | |||||
| base.Dispose(disposing); | |||||
| } | |||||
| } | } | ||||
| } | } | ||||
| @@ -1,4 +1,4 @@ | |||||
| using System; | |||||
| using System; | |||||
| using System.Threading; | using System.Threading; | ||||
| using System.Threading.Tasks; | using System.Threading.Tasks; | ||||
| @@ -69,5 +69,12 @@ namespace Discord.Audio.Streams | |||||
| { | { | ||||
| await _next.ClearAsync(cancelToken).ConfigureAwait(false); | await _next.ClearAsync(cancelToken).ConfigureAwait(false); | ||||
| } | } | ||||
| protected override void Dispose(bool disposing) | |||||
| { | |||||
| if (disposing) | |||||
| _next.Dispose(); | |||||
| base.Dispose(disposing); | |||||
| } | |||||
| } | } | ||||
| } | } | ||||
| @@ -44,5 +44,12 @@ namespace Discord.Audio.Streams | |||||
| { | { | ||||
| await _next.ClearAsync(cancelToken).ConfigureAwait(false); | await _next.ClearAsync(cancelToken).ConfigureAwait(false); | ||||
| } | } | ||||
| protected override void Dispose(bool disposing) | |||||
| { | |||||
| if (disposing) | |||||
| _next.Dispose(); | |||||
| base.Dispose(disposing); | |||||
| } | |||||
| } | } | ||||
| } | } | ||||
| @@ -60,5 +60,12 @@ namespace Discord.Audio.Streams | |||||
| { | { | ||||
| await _next.ClearAsync(cancelToken).ConfigureAwait(false); | await _next.ClearAsync(cancelToken).ConfigureAwait(false); | ||||
| } | } | ||||
| protected override void Dispose(bool disposing) | |||||
| { | |||||
| if (disposing) | |||||
| _next.Dispose(); | |||||
| base.Dispose(disposing); | |||||
| } | |||||
| } | } | ||||
| } | } | ||||
| @@ -389,5 +389,47 @@ namespace Discord.WebSocket | |||||
| remove { _recipientRemovedEvent.Remove(value); } | remove { _recipientRemovedEvent.Remove(value); } | ||||
| } | } | ||||
| internal readonly AsyncEvent<Func<SocketGroupUser, Task>> _recipientRemovedEvent = new AsyncEvent<Func<SocketGroupUser, Task>>(); | internal readonly AsyncEvent<Func<SocketGroupUser, Task>> _recipientRemovedEvent = new AsyncEvent<Func<SocketGroupUser, Task>>(); | ||||
| //Invites | |||||
| /// <summary> | |||||
| /// Fired when an invite is created. | |||||
| /// </summary> | |||||
| /// <remarks> | |||||
| /// <para> | |||||
| /// This event is fired when an invite is created. The event handler must return a | |||||
| /// <see cref="Task"/> and accept a <see cref="SocketInvite"/> as its parameter. | |||||
| /// </para> | |||||
| /// <para> | |||||
| /// The invite created will be passed into the <see cref="SocketInvite"/> parameter. | |||||
| /// </para> | |||||
| /// </remarks> | |||||
| public event Func<SocketInvite, Task> InviteCreated | |||||
| { | |||||
| add { _inviteCreatedEvent.Add(value); } | |||||
| remove { _inviteCreatedEvent.Remove(value); } | |||||
| } | |||||
| internal readonly AsyncEvent<Func<SocketInvite, Task>> _inviteCreatedEvent = new AsyncEvent<Func<SocketInvite, Task>>(); | |||||
| /// <summary> | |||||
| /// Fired when an invite is deleted. | |||||
| /// </summary> | |||||
| /// <remarks> | |||||
| /// <para> | |||||
| /// This event is fired when an invite is deleted. The event handler must return | |||||
| /// a <see cref="Task"/> and accept a <see cref="SocketGuildChannel"/> and | |||||
| /// <see cref="string"/> as its parameter. | |||||
| /// </para> | |||||
| /// <para> | |||||
| /// The channel where this invite was created will be passed into the <see cref="SocketGuildChannel"/> parameter. | |||||
| /// </para> | |||||
| /// <para> | |||||
| /// The code of the deleted invite will be passed into the <see cref="string"/> parameter. | |||||
| /// </para> | |||||
| /// </remarks> | |||||
| public event Func<SocketGuildChannel, string, Task> InviteDeleted | |||||
| { | |||||
| add { _inviteDeletedEvent.Add(value); } | |||||
| remove { _inviteDeletedEvent.Remove(value); } | |||||
| } | |||||
| internal readonly AsyncEvent<Func<SocketGuildChannel, string, Task>> _inviteDeletedEvent = new AsyncEvent<Func<SocketGuildChannel, string, Task>>(); | |||||
| } | } | ||||
| } | } | ||||
| @@ -44,6 +44,8 @@ namespace Discord | |||||
| var ex2 = ex as WebSocketClosedException; | var ex2 = ex as WebSocketClosedException; | ||||
| if (ex2?.CloseCode == 4006) | if (ex2?.CloseCode == 4006) | ||||
| CriticalError(new Exception("WebSocket session expired", ex)); | CriticalError(new Exception("WebSocket session expired", ex)); | ||||
| else if (ex2?.CloseCode == 4014) | |||||
| CriticalError(new Exception("WebSocket connection was closed", ex)); | |||||
| else | else | ||||
| Error(new Exception("WebSocket connection was closed", ex)); | Error(new Exception("WebSocket connection was closed", ex)); | ||||
| } | } | ||||
| @@ -358,6 +358,9 @@ namespace Discord.WebSocket | |||||
| client.UserIsTyping += (oldUser, newUser) => _userIsTypingEvent.InvokeAsync(oldUser, newUser); | client.UserIsTyping += (oldUser, newUser) => _userIsTypingEvent.InvokeAsync(oldUser, newUser); | ||||
| client.RecipientAdded += (user) => _recipientAddedEvent.InvokeAsync(user); | client.RecipientAdded += (user) => _recipientAddedEvent.InvokeAsync(user); | ||||
| client.RecipientRemoved += (user) => _recipientRemovedEvent.InvokeAsync(user); | client.RecipientRemoved += (user) => _recipientRemovedEvent.InvokeAsync(user); | ||||
| client.InviteCreated += (invite) => _inviteCreatedEvent.InvokeAsync(invite); | |||||
| client.InviteDeleted += (channel, invite) => _inviteDeletedEvent.InvokeAsync(channel, invite); | |||||
| } | } | ||||
| //IDiscordClient | //IDiscordClient | ||||
| @@ -368,7 +368,7 @@ namespace Discord.WebSocket | |||||
| { | { | ||||
| var cachedGuilds = guilds.ToImmutableArray(); | var cachedGuilds = guilds.ToImmutableArray(); | ||||
| const short batchSize = 100; //TODO: Gateway Intents will limit to a maximum of 1 guild_id | |||||
| const short batchSize = 1; | |||||
| ulong[] batchIds = new ulong[Math.Min(batchSize, cachedGuilds.Length)]; | ulong[] batchIds = new ulong[Math.Min(batchSize, cachedGuilds.Length)]; | ||||
| Task[] batchTasks = new Task[batchIds.Length]; | Task[] batchTasks = new Task[batchIds.Length]; | ||||
| int batchCount = (cachedGuilds.Length + (batchSize - 1)) / batchSize; | int batchCount = (cachedGuilds.Length + (batchSize - 1)) / batchSize; | ||||
| @@ -901,6 +901,13 @@ namespace Discord.WebSocket | |||||
| if (user != null) | if (user != null) | ||||
| { | { | ||||
| var globalBefore = user.GlobalUser.Clone(); | |||||
| if (user.GlobalUser.Update(State, data.User)) | |||||
| { | |||||
| //Global data was updated, trigger UserUpdated | |||||
| await TimedInvokeAsync(_userUpdatedEvent, nameof(UserUpdated), globalBefore, user).ConfigureAwait(false); | |||||
| } | |||||
| var before = user.Clone(); | var before = user.Clone(); | ||||
| user.Update(State, data); | user.Update(State, data); | ||||
| await TimedInvokeAsync(_guildMemberUpdatedEvent, nameof(GuildMemberUpdated), before, user).ConfigureAwait(false); | await TimedInvokeAsync(_guildMemberUpdatedEvent, nameof(GuildMemberUpdated), before, user).ConfigureAwait(false); | ||||
| @@ -1679,6 +1686,64 @@ namespace Discord.WebSocket | |||||
| } | } | ||||
| break; | break; | ||||
| //Invites | |||||
| case "INVITE_CREATE": | |||||
| { | |||||
| await _gatewayLogger.DebugAsync("Received Dispatch (INVITE_CREATE)").ConfigureAwait(false); | |||||
| var data = (payload as JToken).ToObject<API.Gateway.InviteCreateEvent>(_serializer); | |||||
| if (State.GetChannel(data.ChannelId) is SocketGuildChannel channel) | |||||
| { | |||||
| var guild = channel.Guild; | |||||
| if (!guild.IsSynced) | |||||
| { | |||||
| await UnsyncedGuildAsync(type, guild.Id).ConfigureAwait(false); | |||||
| return; | |||||
| } | |||||
| SocketGuildUser inviter = data.Inviter.IsSpecified | |||||
| ? (guild.GetUser(data.Inviter.Value.Id) ?? guild.AddOrUpdateUser(data.Inviter.Value)) | |||||
| : null; | |||||
| SocketUser target = data.TargetUser.IsSpecified | |||||
| ? (guild.GetUser(data.TargetUser.Value.Id) ?? (SocketUser)SocketUnknownUser.Create(this, State, data.TargetUser.Value)) | |||||
| : null; | |||||
| var invite = SocketInvite.Create(this, guild, channel, inviter, target, data); | |||||
| await TimedInvokeAsync(_inviteCreatedEvent, nameof(InviteCreated), invite).ConfigureAwait(false); | |||||
| } | |||||
| else | |||||
| { | |||||
| await UnknownChannelAsync(type, data.ChannelId).ConfigureAwait(false); | |||||
| return; | |||||
| } | |||||
| } | |||||
| break; | |||||
| case "INVITE_DELETE": | |||||
| { | |||||
| await _gatewayLogger.DebugAsync("Received Dispatch (INVITE_DELETE)").ConfigureAwait(false); | |||||
| var data = (payload as JToken).ToObject<API.Gateway.InviteDeleteEvent>(_serializer); | |||||
| if (State.GetChannel(data.ChannelId) is SocketGuildChannel channel) | |||||
| { | |||||
| var guild = channel.Guild; | |||||
| if (!guild.IsSynced) | |||||
| { | |||||
| await UnsyncedGuildAsync(type, guild.Id).ConfigureAwait(false); | |||||
| return; | |||||
| } | |||||
| await TimedInvokeAsync(_inviteDeletedEvent, nameof(InviteDeleted), channel, data.Code).ConfigureAwait(false); | |||||
| } | |||||
| else | |||||
| { | |||||
| await UnknownChannelAsync(type, data.ChannelId).ConfigureAwait(false); | |||||
| return; | |||||
| } | |||||
| } | |||||
| break; | |||||
| //Ignored (User only) | //Ignored (User only) | ||||
| case "CHANNEL_PINS_ACK": | case "CHANNEL_PINS_ACK": | ||||
| await _gatewayLogger.DebugAsync("Ignored Dispatch (CHANNEL_PINS_ACK)").ConfigureAwait(false); | await _gatewayLogger.DebugAsync("Ignored Dispatch (CHANNEL_PINS_ACK)").ConfigureAwait(false); | ||||
| @@ -87,7 +87,7 @@ namespace Discord.WebSocket | |||||
| /// </para> | /// </para> | ||||
| /// <para> | /// <para> | ||||
| /// For more information, please see | /// For more information, please see | ||||
| /// <see href="https://discordapp.com/developers/docs/topics/gateway#request-guild-members">Request Guild Members</see> | |||||
| /// <see href="https://discord.com/developers/docs/topics/gateway#request-guild-members">Request Guild Members</see> | |||||
| /// on the official Discord API documentation. | /// on the official Discord API documentation. | ||||
| /// </para> | /// </para> | ||||
| /// <note> | /// <note> | ||||
| @@ -158,6 +158,7 @@ namespace Discord.WebSocket | |||||
| } | } | ||||
| private int _maxWaitForGuildAvailable = 10000; | private int _maxWaitForGuildAvailable = 10000; | ||||
| /// <summary> | |||||
| /// Gets or sets gateway intents to limit what events are sent from Discord. Allows for more granular control than the <see cref="GuildSubscriptions"/> property. | /// Gets or sets gateway intents to limit what events are sent from Discord. Allows for more granular control than the <see cref="GuildSubscriptions"/> property. | ||||
| /// </summary> | /// </summary> | ||||
| /// <remarks> | /// <remarks> | ||||
| @@ -125,7 +125,6 @@ namespace Discord.WebSocket | |||||
| public virtual async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options = null) | public virtual async Task AddPermissionOverwriteAsync(IUser user, OverwritePermissions permissions, RequestOptions options = null) | ||||
| { | { | ||||
| await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, user, permissions, options).ConfigureAwait(false); | 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> | /// <summary> | ||||
| @@ -140,7 +139,6 @@ namespace Discord.WebSocket | |||||
| public virtual async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options = null) | public virtual async Task AddPermissionOverwriteAsync(IRole role, OverwritePermissions permissions, RequestOptions options = null) | ||||
| { | { | ||||
| await ChannelHelper.AddPermissionOverwriteAsync(this, Discord, role, permissions, options).ConfigureAwait(false); | 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> | /// <summary> | ||||
| /// Removes the permission overwrite for the given user, if one exists. | /// Removes the permission overwrite for the given user, if one exists. | ||||
| @@ -153,15 +151,6 @@ namespace Discord.WebSocket | |||||
| public virtual async Task RemovePermissionOverwriteAsync(IUser user, RequestOptions options = null) | public virtual async Task RemovePermissionOverwriteAsync(IUser user, RequestOptions options = null) | ||||
| { | { | ||||
| await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, user, options).ConfigureAwait(false); | 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> | /// <summary> | ||||
| /// Removes the permission overwrite for the given role, if one exists. | /// Removes the permission overwrite for the given role, if one exists. | ||||
| @@ -174,15 +163,6 @@ namespace Discord.WebSocket | |||||
| public virtual async Task RemovePermissionOverwriteAsync(IRole role, RequestOptions options = null) | public virtual async Task RemovePermissionOverwriteAsync(IRole role, RequestOptions options = null) | ||||
| { | { | ||||
| await ChannelHelper.RemovePermissionOverwriteAsync(this, Discord, role, options).ConfigureAwait(false); | 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; | |||||
| } | |||||
| } | |||||
| } | } | ||||
| public new virtual SocketGuildUser GetUser(ulong id) => null; | public new virtual SocketGuildUser GetUser(ulong id) => null; | ||||
| @@ -15,7 +15,7 @@ namespace Discord.WebSocket | |||||
| /// </note> | /// </note> | ||||
| /// </remarks> | /// </remarks> | ||||
| [DebuggerDisplay(@"{DebuggerDisplay,nq}")] | [DebuggerDisplay(@"{DebuggerDisplay,nq}")] | ||||
| public class SocketNewsChannel : SocketTextChannel | |||||
| public class SocketNewsChannel : SocketTextChannel, INewsChannel | |||||
| { | { | ||||
| internal SocketNewsChannel(DiscordSocketClient discord, ulong id, SocketGuild guild) | internal SocketNewsChannel(DiscordSocketClient discord, ulong id, SocketGuild guild) | ||||
| :base(discord, id, guild) | :base(discord, id, guild) | ||||
| @@ -48,6 +48,8 @@ namespace Discord.WebSocket | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public bool IsEmbeddable { get; private set; } | public bool IsEmbeddable { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public bool IsWidgetEnabled { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public VerificationLevel VerificationLevel { get; private set; } | public VerificationLevel VerificationLevel { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public MfaLevel MfaLevel { get; private set; } | public MfaLevel MfaLevel { get; private set; } | ||||
| @@ -83,7 +85,10 @@ namespace Discord.WebSocket | |||||
| internal ulong? AFKChannelId { get; private set; } | internal ulong? AFKChannelId { get; private set; } | ||||
| internal ulong? EmbedChannelId { get; private set; } | internal ulong? EmbedChannelId { get; private set; } | ||||
| internal ulong? WidgetChannelId { get; private set; } | |||||
| internal ulong? SystemChannelId { get; private set; } | internal ulong? SystemChannelId { get; private set; } | ||||
| internal ulong? RulesChannelId { get; private set; } | |||||
| internal ulong? PublicUpdatesChannelId { get; private set; } | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public ulong OwnerId { get; private set; } | public ulong OwnerId { get; private set; } | ||||
| /// <summary> Gets the user that owns this guild. </summary> | /// <summary> Gets the user that owns this guild. </summary> | ||||
| @@ -95,6 +100,8 @@ namespace Discord.WebSocket | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string SplashId { get; private set; } | public string SplashId { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string DiscoverySplashId { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public PremiumTier PremiumTier { get; private set; } | public PremiumTier PremiumTier { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string BannerId { get; private set; } | public string BannerId { get; private set; } | ||||
| @@ -108,6 +115,12 @@ namespace Discord.WebSocket | |||||
| public int PremiumSubscriptionCount { get; private set; } | public int PremiumSubscriptionCount { get; private set; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string PreferredLocale { get; private set; } | public string PreferredLocale { get; private set; } | ||||
| /// <inheritdoc /> | |||||
| public int? MaxPresences { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public int? MaxMembers { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public int? MaxVideoChannelUsers { get; private set; } | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public CultureInfo PreferredCulture { get; private set; } | public CultureInfo PreferredCulture { get; private set; } | ||||
| @@ -119,6 +132,8 @@ namespace Discord.WebSocket | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string SplashUrl => CDN.GetGuildSplashUrl(Id, SplashId); | public string SplashUrl => CDN.GetGuildSplashUrl(Id, SplashId); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public string DiscoverySplashUrl => CDN.GetGuildDiscoverySplashUrl(Id, DiscoverySplashId); | |||||
| /// <inheritdoc /> | |||||
| public string BannerUrl => CDN.GetGuildBannerUrl(Id, BannerId); | public string BannerUrl => CDN.GetGuildBannerUrl(Id, BannerId); | ||||
| /// <summary> Indicates whether the client has all the members downloaded to the local guild cache. </summary> | /// <summary> Indicates whether the client has all the members downloaded to the local guild cache. </summary> | ||||
| public bool HasAllMembers => MemberCount == DownloadedMemberCount;// _downloaderPromise.Task.IsCompleted; | public bool HasAllMembers => MemberCount == DownloadedMemberCount;// _downloaderPromise.Task.IsCompleted; | ||||
| @@ -152,7 +167,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A <see cref="SocketVoiceChannel" /> that the AFK users will be moved to after they have idled for too | /// A <see cref="SocketVoiceChannel" /> that the AFK users will be moved to after they have idled for too | ||||
| /// long; <c>null</c> if none is set. | |||||
| /// long; <see langword="null"/> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketVoiceChannel AFKChannel | public SocketVoiceChannel AFKChannel | ||||
| { | { | ||||
| @@ -166,8 +181,9 @@ namespace Discord.WebSocket | |||||
| /// Gets the embed channel (i.e. the channel set in the guild's widget settings) in this guild. | /// Gets the embed channel (i.e. the channel set in the guild's widget settings) in this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A channel set within the server's widget settings; <c>null</c> if none is set. | |||||
| /// A channel set within the server's widget settings; <see langword="null"/> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| [Obsolete("This property is deprecated, use WidgetChannel instead.")] | |||||
| public SocketGuildChannel EmbedChannel | public SocketGuildChannel EmbedChannel | ||||
| { | { | ||||
| get | get | ||||
| @@ -177,10 +193,24 @@ namespace Discord.WebSocket | |||||
| } | } | ||||
| } | } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the widget channel (i.e. the channel set in the guild's widget settings) in this guild. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A channel set within the server's widget settings; <see langword="null"/> if none is set. | |||||
| /// </returns> | |||||
| public SocketGuildChannel WidgetChannel | |||||
| { | |||||
| get | |||||
| { | |||||
| var id = WidgetChannelId; | |||||
| return id.HasValue ? GetChannel(id.Value) : null; | |||||
| } | |||||
| } | |||||
| /// <summary> | |||||
| /// Gets the system channel where randomized welcome messages are sent in this guild. | /// Gets the system channel where randomized welcome messages are sent in this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A text channel where randomized welcome messages will be sent to; <c>null</c> if none is set. | |||||
| /// A text channel where randomized welcome messages will be sent to; <see langword="null"/> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketTextChannel SystemChannel | public SocketTextChannel SystemChannel | ||||
| { | { | ||||
| @@ -191,6 +221,36 @@ namespace Discord.WebSocket | |||||
| } | } | ||||
| } | } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the channel with the guild rules. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A text channel with the guild rules; <see langword="null"/> if none is set. | |||||
| /// </returns> | |||||
| public SocketTextChannel RulesChannel | |||||
| { | |||||
| get | |||||
| { | |||||
| var id = RulesChannelId; | |||||
| return id.HasValue ? GetTextChannel(id.Value) : null; | |||||
| } | |||||
| } | |||||
| /// <summary> | |||||
| /// Gets the channel where admins and moderators of Community guilds receive | |||||
| /// notices from Discord. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A text channel where admins and moderators of Community guilds receive | |||||
| /// notices from Discord; <see langword="null"/> if none is set. | |||||
| /// </returns> | |||||
| public SocketTextChannel PublicUpdatesChannel | |||||
| { | |||||
| get | |||||
| { | |||||
| var id = PublicUpdatesChannelId; | |||||
| return id.HasValue ? GetTextChannel(id.Value) : null; | |||||
| } | |||||
| } | |||||
| /// <summary> | |||||
| /// Gets a collection of all text channels in this guild. | /// Gets a collection of all text channels in this guild. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| @@ -360,15 +420,24 @@ namespace Discord.WebSocket | |||||
| internal void Update(ClientState state, Model model) | internal void Update(ClientState state, Model model) | ||||
| { | { | ||||
| AFKChannelId = model.AFKChannelId; | AFKChannelId = model.AFKChannelId; | ||||
| EmbedChannelId = model.EmbedChannelId; | |||||
| if (model.EmbedChannelId.IsSpecified) | |||||
| EmbedChannelId = model.EmbedChannelId.Value; | |||||
| if (model.WidgetChannelId.IsSpecified) | |||||
| WidgetChannelId = model.WidgetChannelId.Value; | |||||
| SystemChannelId = model.SystemChannelId; | SystemChannelId = model.SystemChannelId; | ||||
| RulesChannelId = model.RulesChannelId; | |||||
| PublicUpdatesChannelId = model.PublicUpdatesChannelId; | |||||
| AFKTimeout = model.AFKTimeout; | AFKTimeout = model.AFKTimeout; | ||||
| IsEmbeddable = model.EmbedEnabled; | |||||
| if (model.EmbedEnabled.IsSpecified) | |||||
| IsEmbeddable = model.EmbedEnabled.Value; | |||||
| if (model.WidgetEnabled.IsSpecified) | |||||
| IsWidgetEnabled = model.WidgetEnabled.Value; | |||||
| IconId = model.Icon; | IconId = model.Icon; | ||||
| Name = model.Name; | Name = model.Name; | ||||
| OwnerId = model.OwnerId; | OwnerId = model.OwnerId; | ||||
| VoiceRegionId = model.Region; | VoiceRegionId = model.Region; | ||||
| SplashId = model.Splash; | SplashId = model.Splash; | ||||
| DiscoverySplashId = model.DiscoverySplash; | |||||
| VerificationLevel = model.VerificationLevel; | VerificationLevel = model.VerificationLevel; | ||||
| MfaLevel = model.MfaLevel; | MfaLevel = model.MfaLevel; | ||||
| DefaultMessageNotifications = model.DefaultMessageNotifications; | DefaultMessageNotifications = model.DefaultMessageNotifications; | ||||
| @@ -379,9 +448,16 @@ namespace Discord.WebSocket | |||||
| BannerId = model.Banner; | BannerId = model.Banner; | ||||
| SystemChannelFlags = model.SystemChannelFlags; | SystemChannelFlags = model.SystemChannelFlags; | ||||
| Description = model.Description; | Description = model.Description; | ||||
| PremiumSubscriptionCount = model.PremiumSubscriptionCount.GetValueOrDefault(); | |||||
| if (model.PremiumSubscriptionCount.IsSpecified) | |||||
| PremiumSubscriptionCount = model.PremiumSubscriptionCount.Value; | |||||
| if (model.MaxPresences.IsSpecified) | |||||
| MaxPresences = model.MaxPresences.Value ?? 25000; | |||||
| if (model.MaxMembers.IsSpecified) | |||||
| MaxMembers = model.MaxMembers.Value; | |||||
| if (model.MaxVideoChannelUsers.IsSpecified) | |||||
| MaxVideoChannelUsers = model.MaxVideoChannelUsers.Value; | |||||
| PreferredLocale = model.PreferredLocale; | PreferredLocale = model.PreferredLocale; | ||||
| PreferredCulture = new CultureInfo(PreferredLocale); | |||||
| PreferredCulture = PreferredLocale == null ? null : new CultureInfo(PreferredLocale); | |||||
| if (model.Emojis != null) | if (model.Emojis != null) | ||||
| { | { | ||||
| @@ -447,15 +523,20 @@ namespace Discord.WebSocket | |||||
| => GuildHelper.DeleteAsync(this, Discord, options); | => GuildHelper.DeleteAsync(this, Discord, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| public Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | public Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyAsync(this, Discord, func, options); | => GuildHelper.ModifyAsync(this, Discord, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| [Obsolete("This endpoint is deprecated, use ModifyWidgetAsync instead.")] | |||||
| public Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | public Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyEmbedAsync(this, Discord, func, options); | => GuildHelper.ModifyEmbedAsync(this, Discord, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| public Task ModifyWidgetAsync(Action<GuildWidgetProperties> func, RequestOptions options = null) | |||||
| => GuildHelper.ModifyWidgetAsync(this, Discord, func, options); | |||||
| /// <inheritdoc /> | |||||
| public Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null) | public Task ReorderChannelsAsync(IEnumerable<ReorderChannelProperties> args, RequestOptions options = null) | ||||
| => GuildHelper.ReorderChannelsAsync(this, Discord, args, options); | => GuildHelper.ReorderChannelsAsync(this, Discord, args, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -485,7 +566,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains a ban object, which | /// A task that represents the asynchronous get operation. The task result contains a ban object, which | ||||
| /// contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found. | |||||
| /// contains the user information and the reason for the ban; <see langword="null"/> if the ban entry cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestBan> GetBanAsync(IUser user, RequestOptions options = null) | public Task<RestBan> GetBanAsync(IUser user, RequestOptions options = null) | ||||
| => GuildHelper.GetBanAsync(this, Discord, user.Id, options); | => GuildHelper.GetBanAsync(this, Discord, user.Id, options); | ||||
| @@ -496,7 +577,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains a ban object, which | /// A task that represents the asynchronous get operation. The task result contains a ban object, which | ||||
| /// contains the user information and the reason for the ban; <c>null</c> if the ban entry cannot be found. | |||||
| /// contains the user information and the reason for the ban; <see langword="null"/> if the ban entry cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestBan> GetBanAsync(ulong userId, RequestOptions options = null) | public Task<RestBan> GetBanAsync(ulong userId, RequestOptions options = null) | ||||
| => GuildHelper.GetBanAsync(this, Discord, userId, options); | => GuildHelper.GetBanAsync(this, Discord, userId, options); | ||||
| @@ -521,7 +602,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the channel.</param> | /// <param name="id">The snowflake identifier for the channel.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A generic channel associated with the specified <paramref name="id" />; <c>null</c> if none is found. | |||||
| /// A generic channel associated with the specified <paramref name="id" />; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketGuildChannel GetChannel(ulong id) | public SocketGuildChannel GetChannel(ulong id) | ||||
| { | { | ||||
| @@ -535,7 +616,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the text channel.</param> | /// <param name="id">The snowflake identifier for the text channel.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A text channel associated with the specified <paramref name="id" />; <c>null</c> if none is found. | |||||
| /// A text channel associated with the specified <paramref name="id" />; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketTextChannel GetTextChannel(ulong id) | public SocketTextChannel GetTextChannel(ulong id) | ||||
| => GetChannel(id) as SocketTextChannel; | => GetChannel(id) as SocketTextChannel; | ||||
| @@ -544,7 +625,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the voice channel.</param> | /// <param name="id">The snowflake identifier for the voice channel.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A voice channel associated with the specified <paramref name="id" />; <c>null</c> if none is found. | |||||
| /// A voice channel associated with the specified <paramref name="id" />; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketVoiceChannel GetVoiceChannel(ulong id) | public SocketVoiceChannel GetVoiceChannel(ulong id) | ||||
| => GetChannel(id) as SocketVoiceChannel; | => GetChannel(id) as SocketVoiceChannel; | ||||
| @@ -553,7 +634,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the category channel.</param> | /// <param name="id">The snowflake identifier for the category channel.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A category channel associated with the specified <paramref name="id" />; <c>null</c> if none is found. | |||||
| /// A category channel associated with the specified <paramref name="id" />; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketCategoryChannel GetCategoryChannel(ulong id) | public SocketCategoryChannel GetCategoryChannel(ulong id) | ||||
| => GetChannel(id) as SocketCategoryChannel; | => GetChannel(id) as SocketCategoryChannel; | ||||
| @@ -589,7 +670,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="name">The new name for the voice channel.</param> | /// <param name="name">The new name for the voice channel.</param> | ||||
| /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous creation operation. The task result contains the newly created | /// A task that represents the asynchronous creation operation. The task result contains the newly created | ||||
| /// voice channel. | /// voice channel. | ||||
| @@ -602,7 +683,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="name">The new name for the category.</param> | /// <param name="name">The new name for the category.</param> | ||||
| /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | /// <param name="func">The delegate containing the properties to be applied to the channel upon its creation.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous creation operation. The task result contains the newly created | /// A task that represents the asynchronous creation operation. The task result contains the newly created | ||||
| /// category channel. | /// category channel. | ||||
| @@ -666,7 +747,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the partial metadata of | /// A task that represents the asynchronous get operation. The task result contains the partial metadata of | ||||
| /// the vanity invite found within this guild; <c>null</c> if none is found. | |||||
| /// the vanity invite found within this guild; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestInviteMetadata> GetVanityInviteAsync(RequestOptions options = null) | public Task<RestInviteMetadata> GetVanityInviteAsync(RequestOptions options = null) | ||||
| => GuildHelper.GetVanityInviteAsync(this, Discord, options); | => GuildHelper.GetVanityInviteAsync(this, Discord, options); | ||||
| @@ -677,7 +758,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The snowflake identifier for the role.</param> | /// <param name="id">The snowflake identifier for the role.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A role that is associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// A role that is associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketRole GetRole(ulong id) | public SocketRole GetRole(ulong id) | ||||
| { | { | ||||
| @@ -699,7 +780,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="isHoisted">Whether the role is separated from others on the sidebar.</param> | /// <param name="isHoisted">Whether the role is separated from others on the sidebar.</param> | ||||
| /// <param name="isMentionable">Whether the role can be mentioned.</param> | /// <param name="isMentionable">Whether the role can be mentioned.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous creation operation. The task result contains the newly created | /// A task that represents the asynchronous creation operation. The task result contains the newly created | ||||
| /// role. | /// role. | ||||
| @@ -731,13 +812,13 @@ namespace Discord.WebSocket | |||||
| /// <remarks> | /// <remarks> | ||||
| /// This method retrieves a user found within this guild. | /// This method retrieves a user found within this guild. | ||||
| /// <note> | /// <note> | ||||
| /// This may return <c>null</c> in the WebSocket implementation due to incomplete user collection in | |||||
| /// This may return <see langword="null"/> in the WebSocket implementation due to incomplete user collection in | |||||
| /// large guilds. | /// large guilds. | ||||
| /// </note> | /// </note> | ||||
| /// </remarks> | /// </remarks> | ||||
| /// <param name="id">The snowflake identifier of the user.</param> | /// <param name="id">The snowflake identifier of the user.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A guild user associated with the specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// A guild user associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public SocketGuildUser GetUser(ulong id) | public SocketGuildUser GetUser(ulong id) | ||||
| { | { | ||||
| @@ -746,8 +827,8 @@ namespace Discord.WebSocket | |||||
| return null; | return null; | ||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null) | |||||
| => GuildHelper.PruneUsersAsync(this, Discord, days, simulate, options); | |||||
| public Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null, IEnumerable<ulong> includeRoleIds = null) | |||||
| => GuildHelper.PruneUsersAsync(this, Discord, days, simulate, options, includeRoleIds); | |||||
| internal SocketGuildUser AddOrUpdateUser(UserModel model) | internal SocketGuildUser AddOrUpdateUser(UserModel model) | ||||
| { | { | ||||
| @@ -891,7 +972,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous get operation. The task result contains the webhook with the | /// A task that represents the asynchronous get operation. The task result contains the webhook with the | ||||
| /// specified <paramref name="id"/>; <c>null</c> if none is found. | |||||
| /// specified <paramref name="id"/>; <see langword="null"/> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null) | public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null) | ||||
| => GuildHelper.GetWebhookAsync(this, Discord, id, options); | => GuildHelper.GetWebhookAsync(this, Discord, id, options); | ||||
| @@ -914,7 +995,7 @@ namespace Discord.WebSocket | |||||
| public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null) | public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null) | ||||
| => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options); | => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null) | public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options); | => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -1133,11 +1214,21 @@ namespace Discord.WebSocket | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| ulong? IGuild.EmbedChannelId => EmbedChannelId; | ulong? IGuild.EmbedChannelId => EmbedChannelId; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| ulong? IGuild.WidgetChannelId => WidgetChannelId; | |||||
| /// <inheritdoc /> | |||||
| ulong? IGuild.SystemChannelId => SystemChannelId; | ulong? IGuild.SystemChannelId => SystemChannelId; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| ulong? IGuild.RulesChannelId => RulesChannelId; | |||||
| /// <inheritdoc /> | |||||
| ulong? IGuild.PublicUpdatesChannelId => PublicUpdatesChannelId; | |||||
| /// <inheritdoc /> | |||||
| IRole IGuild.EveryoneRole => EveryoneRole; | IRole IGuild.EveryoneRole => EveryoneRole; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| IReadOnlyCollection<IRole> IGuild.Roles => Roles; | IReadOnlyCollection<IRole> IGuild.Roles => Roles; | ||||
| /// <inheritdoc /> | |||||
| int? IGuild.ApproximateMemberCount => null; | |||||
| /// <inheritdoc /> | |||||
| int? IGuild.ApproximatePresenceCount => null; | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| async Task<IReadOnlyCollection<IBan>> IGuild.GetBansAsync(RequestOptions options) | async Task<IReadOnlyCollection<IBan>> IGuild.GetBansAsync(RequestOptions options) | ||||
| @@ -1177,12 +1268,22 @@ namespace Discord.WebSocket | |||||
| Task<ITextChannel> IGuild.GetDefaultChannelAsync(CacheMode mode, RequestOptions options) | Task<ITextChannel> IGuild.GetDefaultChannelAsync(CacheMode mode, RequestOptions options) | ||||
| => Task.FromResult<ITextChannel>(DefaultChannel); | => Task.FromResult<ITextChannel>(DefaultChannel); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| [Obsolete("This method is deprecated, use GetWidgetChannelAsync instead.")] | |||||
| Task<IGuildChannel> IGuild.GetEmbedChannelAsync(CacheMode mode, RequestOptions options) | Task<IGuildChannel> IGuild.GetEmbedChannelAsync(CacheMode mode, RequestOptions options) | ||||
| => Task.FromResult<IGuildChannel>(EmbedChannel); | => Task.FromResult<IGuildChannel>(EmbedChannel); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| Task<IGuildChannel> IGuild.GetWidgetChannelAsync(CacheMode mode, RequestOptions options) | |||||
| => Task.FromResult<IGuildChannel>(WidgetChannel); | |||||
| /// <inheritdoc /> | |||||
| Task<ITextChannel> IGuild.GetSystemChannelAsync(CacheMode mode, RequestOptions options) | Task<ITextChannel> IGuild.GetSystemChannelAsync(CacheMode mode, RequestOptions options) | ||||
| => Task.FromResult<ITextChannel>(SystemChannel); | => Task.FromResult<ITextChannel>(SystemChannel); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| Task<ITextChannel> IGuild.GetRulesChannelAsync(CacheMode mode, RequestOptions options) | |||||
| => Task.FromResult<ITextChannel>(RulesChannel); | |||||
| /// <inheritdoc /> | |||||
| Task<ITextChannel> IGuild.GetPublicUpdatesChannelAsync(CacheMode mode, RequestOptions options) | |||||
| => Task.FromResult<ITextChannel>(PublicUpdatesChannel); | |||||
| /// <inheritdoc /> | |||||
| async Task<ITextChannel> IGuild.CreateTextChannelAsync(string name, Action<TextChannelProperties> func, RequestOptions options) | async Task<ITextChannel> IGuild.CreateTextChannelAsync(string name, Action<TextChannelProperties> func, RequestOptions options) | ||||
| => await CreateTextChannelAsync(name, func, options).ConfigureAwait(false); | => await CreateTextChannelAsync(name, func, options).ConfigureAwait(false); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -0,0 +1,143 @@ | |||||
| using Discord.Rest; | |||||
| using System; | |||||
| using System.Diagnostics; | |||||
| using System.Threading.Tasks; | |||||
| using Model = Discord.API.Gateway.InviteCreateEvent; | |||||
| namespace Discord.WebSocket | |||||
| { | |||||
| [DebuggerDisplay(@"{DebuggerDisplay,nq}")] | |||||
| public class SocketInvite : SocketEntity<string>, IInviteMetadata | |||||
| { | |||||
| private long _createdAtTicks; | |||||
| /// <inheritdoc /> | |||||
| public ulong ChannelId { get; private set; } | |||||
| /// <summary> | |||||
| /// Gets the channel where this invite was created. | |||||
| /// </summary> | |||||
| public SocketGuildChannel Channel { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public ulong? GuildId { get; private set; } | |||||
| /// <summary> | |||||
| /// Gets the guild where this invite was created. | |||||
| /// </summary> | |||||
| public SocketGuild Guild { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| ChannelType IInvite.ChannelType | |||||
| { | |||||
| get | |||||
| { | |||||
| switch (Channel) | |||||
| { | |||||
| case IVoiceChannel voiceChannel: return ChannelType.Voice; | |||||
| case ICategoryChannel categoryChannel: return ChannelType.Category; | |||||
| case IDMChannel dmChannel: return ChannelType.DM; | |||||
| case IGroupChannel groupChannel: return ChannelType.Group; | |||||
| case INewsChannel newsChannel: return ChannelType.News; | |||||
| case ITextChannel textChannel: return ChannelType.Text; | |||||
| default: throw new InvalidOperationException("Invalid channel type."); | |||||
| } | |||||
| } | |||||
| } | |||||
| /// <inheritdoc /> | |||||
| string IInvite.ChannelName => Channel.Name; | |||||
| /// <inheritdoc /> | |||||
| string IInvite.GuildName => Guild.Name; | |||||
| /// <inheritdoc /> | |||||
| int? IInvite.PresenceCount => throw new NotImplementedException(); | |||||
| /// <inheritdoc /> | |||||
| int? IInvite.MemberCount => throw new NotImplementedException(); | |||||
| /// <inheritdoc /> | |||||
| bool IInviteMetadata.IsRevoked => throw new NotImplementedException(); | |||||
| /// <inheritdoc /> | |||||
| public bool IsTemporary { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| int? IInviteMetadata.MaxAge { get => MaxAge; } | |||||
| /// <inheritdoc /> | |||||
| int? IInviteMetadata.MaxUses { get => MaxUses; } | |||||
| /// <inheritdoc /> | |||||
| int? IInviteMetadata.Uses { get => Uses; } | |||||
| /// <summary> | |||||
| /// Gets the time (in seconds) until the invite expires. | |||||
| /// </summary> | |||||
| public int MaxAge { get; private set; } | |||||
| /// <summary> | |||||
| /// Gets the max number of uses this invite may have. | |||||
| /// </summary> | |||||
| public int MaxUses { get; private set; } | |||||
| /// <summary> | |||||
| /// Gets the number of times this invite has been used. | |||||
| /// </summary> | |||||
| public int Uses { get; private set; } | |||||
| /// <summary> | |||||
| /// Gets the user that created this invite if available. | |||||
| /// </summary> | |||||
| public SocketGuildUser Inviter { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| DateTimeOffset? IInviteMetadata.CreatedAt => DateTimeUtils.FromTicks(_createdAtTicks); | |||||
| /// <summary> | |||||
| /// Gets when this invite was created. | |||||
| /// </summary> | |||||
| public DateTimeOffset CreatedAt => DateTimeUtils.FromTicks(_createdAtTicks); | |||||
| /// <summary> | |||||
| /// Gets the user targeted by this invite if available. | |||||
| /// </summary> | |||||
| public SocketUser TargetUser { get; private set; } | |||||
| /// <summary> | |||||
| /// Gets the type of the user targeted by this invite. | |||||
| /// </summary> | |||||
| public TargetUserType TargetUserType { get; private set; } | |||||
| /// <inheritdoc /> | |||||
| public string Code => Id; | |||||
| /// <inheritdoc /> | |||||
| public string Url => $"{DiscordConfig.InviteUrl}{Code}"; | |||||
| internal SocketInvite(DiscordSocketClient discord, SocketGuild guild, SocketGuildChannel channel, SocketGuildUser inviter, SocketUser target, string id) | |||||
| : base(discord, id) | |||||
| { | |||||
| Guild = guild; | |||||
| Channel = channel; | |||||
| Inviter = inviter; | |||||
| TargetUser = target; | |||||
| } | |||||
| internal static SocketInvite Create(DiscordSocketClient discord, SocketGuild guild, SocketGuildChannel channel, SocketGuildUser inviter, SocketUser target, Model model) | |||||
| { | |||||
| var entity = new SocketInvite(discord, guild, channel, inviter, target, model.Code); | |||||
| entity.Update(model); | |||||
| return entity; | |||||
| } | |||||
| internal void Update(Model model) | |||||
| { | |||||
| ChannelId = model.ChannelId; | |||||
| GuildId = model.GuildId.IsSpecified ? model.GuildId.Value : Guild.Id; | |||||
| IsTemporary = model.Temporary; | |||||
| MaxAge = model.MaxAge; | |||||
| MaxUses = model.MaxUses; | |||||
| Uses = model.Uses; | |||||
| _createdAtTicks = model.CreatedAt.UtcTicks; | |||||
| TargetUserType = model.TargetUserType.IsSpecified ? model.TargetUserType.Value : TargetUserType.Undefined; | |||||
| } | |||||
| /// <inheritdoc /> | |||||
| public Task DeleteAsync(RequestOptions options = null) | |||||
| => InviteHelper.DeleteAsync(this, Discord, options); | |||||
| /// <summary> | |||||
| /// Gets the URL of the invite. | |||||
| /// </summary> | |||||
| /// <returns> | |||||
| /// A string that resolves to the Url of the invite. | |||||
| /// </returns> | |||||
| public override string ToString() => Url; | |||||
| private string DebuggerDisplay => $"{Url} ({Guild?.Name} / {Channel.Name})"; | |||||
| /// <inheritdoc /> | |||||
| IGuild IInvite.Guild => Guild; | |||||
| /// <inheritdoc /> | |||||
| IChannel IInvite.Channel => Channel; | |||||
| /// <inheritdoc /> | |||||
| IUser IInviteMetadata.Inviter => Inviter; | |||||
| } | |||||
| } | |||||
| @@ -46,6 +46,8 @@ namespace Discord.WebSocket | |||||
| public virtual bool IsSuppressed => false; | public virtual bool IsSuppressed => false; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public virtual DateTimeOffset? EditedTimestamp => null; | public virtual DateTimeOffset? EditedTimestamp => null; | ||||
| /// <inheritdoc /> | |||||
| public virtual bool MentionedEveryone => false; | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public MessageActivity Activity { get; private set; } | public MessageActivity Activity { get; private set; } | ||||
| @@ -20,7 +20,9 @@ namespace Discord.WebSocket | |||||
| private ImmutableArray<Attachment> _attachments = ImmutableArray.Create<Attachment>(); | private ImmutableArray<Attachment> _attachments = ImmutableArray.Create<Attachment>(); | ||||
| private ImmutableArray<Embed> _embeds = ImmutableArray.Create<Embed>(); | private ImmutableArray<Embed> _embeds = ImmutableArray.Create<Embed>(); | ||||
| private ImmutableArray<ITag> _tags = ImmutableArray.Create<ITag>(); | private ImmutableArray<ITag> _tags = ImmutableArray.Create<ITag>(); | ||||
| private ImmutableArray<SocketRole> _roleMentions = ImmutableArray.Create<SocketRole>(); | |||||
| private ImmutableArray<SocketUser> _userMentions = ImmutableArray.Create<SocketUser>(); | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override bool IsTTS => _isTTS; | public override bool IsTTS => _isTTS; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -30,6 +32,8 @@ namespace Discord.WebSocket | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override DateTimeOffset? EditedTimestamp => DateTimeUtils.FromTicks(_editedTimestampTicks); | public override DateTimeOffset? EditedTimestamp => DateTimeUtils.FromTicks(_editedTimestampTicks); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override bool MentionedEveryone => _isMentioningEveryone; | |||||
| /// <inheritdoc /> | |||||
| public override IReadOnlyCollection<Attachment> Attachments => _attachments; | public override IReadOnlyCollection<Attachment> Attachments => _attachments; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<Embed> Embeds => _embeds; | public override IReadOnlyCollection<Embed> Embeds => _embeds; | ||||
| @@ -38,9 +42,9 @@ namespace Discord.WebSocket | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<SocketGuildChannel> MentionedChannels => MessageHelper.FilterTagsByValue<SocketGuildChannel>(TagType.ChannelMention, _tags); | public override IReadOnlyCollection<SocketGuildChannel> MentionedChannels => MessageHelper.FilterTagsByValue<SocketGuildChannel>(TagType.ChannelMention, _tags); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<SocketRole> MentionedRoles => MessageHelper.FilterTagsByValue<SocketRole>(TagType.RoleMention, _tags); | |||||
| public override IReadOnlyCollection<SocketRole> MentionedRoles => _roleMentions; | |||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public override IReadOnlyCollection<SocketUser> MentionedUsers => MessageHelper.FilterTagsByValue<SocketUser>(TagType.UserMention, _tags); | |||||
| public override IReadOnlyCollection<SocketUser> MentionedUsers => _userMentions; | |||||
| internal SocketUserMessage(DiscordSocketClient discord, ulong id, ISocketMessageChannel channel, SocketUser author, MessageSource source) | internal SocketUserMessage(DiscordSocketClient discord, ulong id, ISocketMessageChannel channel, SocketUser author, MessageSource source) | ||||
| : base(discord, id, channel, author, source) | : base(discord, id, channel, author, source) | ||||
| @@ -57,6 +61,8 @@ namespace Discord.WebSocket | |||||
| { | { | ||||
| base.Update(state, model); | base.Update(state, model); | ||||
| SocketGuild guild = (Channel as SocketGuildChannel)?.Guild; | |||||
| if (model.IsTextToSpeech.IsSpecified) | if (model.IsTextToSpeech.IsSpecified) | ||||
| _isTTS = model.IsTextToSpeech.Value; | _isTTS = model.IsTextToSpeech.Value; | ||||
| if (model.Pinned.IsSpecified) | if (model.Pinned.IsSpecified) | ||||
| @@ -69,6 +75,8 @@ namespace Discord.WebSocket | |||||
| { | { | ||||
| _isSuppressed = model.Flags.Value.HasFlag(API.MessageFlags.Suppressed); | _isSuppressed = model.Flags.Value.HasFlag(API.MessageFlags.Suppressed); | ||||
| } | } | ||||
| if (model.RoleMentions.IsSpecified) | |||||
| _roleMentions = model.RoleMentions.Value.Select(x => guild.GetRole(x)).ToImmutableArray(); | |||||
| if (model.Attachments.IsSpecified) | if (model.Attachments.IsSpecified) | ||||
| { | { | ||||
| @@ -98,28 +106,29 @@ namespace Discord.WebSocket | |||||
| _embeds = ImmutableArray.Create<Embed>(); | _embeds = ImmutableArray.Create<Embed>(); | ||||
| } | } | ||||
| IReadOnlyCollection<IUser> mentions = ImmutableArray.Create<SocketUnknownUser>(); //Is passed to ParseTags to get real mention collection | |||||
| if (model.UserMentions.IsSpecified) | if (model.UserMentions.IsSpecified) | ||||
| { | { | ||||
| var value = model.UserMentions.Value; | var value = model.UserMentions.Value; | ||||
| if (value.Length > 0) | if (value.Length > 0) | ||||
| { | { | ||||
| var newMentions = ImmutableArray.CreateBuilder<SocketUnknownUser>(value.Length); | |||||
| var newMentions = ImmutableArray.CreateBuilder<SocketUser>(value.Length); | |||||
| for (int i = 0; i < value.Length; i++) | for (int i = 0; i < value.Length; i++) | ||||
| { | { | ||||
| var val = value[i]; | var val = value[i]; | ||||
| if (val.Object != null) | |||||
| var guildUser = guild.GetUser(val.Id); | |||||
| if (guildUser != null) | |||||
| newMentions.Add(guildUser); | |||||
| else if (val.Object != null) | |||||
| newMentions.Add(SocketUnknownUser.Create(Discord, state, val.Object)); | newMentions.Add(SocketUnknownUser.Create(Discord, state, val.Object)); | ||||
| } | } | ||||
| mentions = newMentions.ToImmutable(); | |||||
| _userMentions = newMentions.ToImmutable(); | |||||
| } | } | ||||
| } | } | ||||
| if (model.Content.IsSpecified) | if (model.Content.IsSpecified) | ||||
| { | { | ||||
| var text = model.Content.Value; | var text = model.Content.Value; | ||||
| var guild = (Channel as SocketGuildChannel)?.Guild; | |||||
| _tags = MessageHelper.ParseTags(text, Channel, guild, mentions); | |||||
| _tags = MessageHelper.ParseTags(text, Channel, guild, _userMentions); | |||||
| model.Content = text; | model.Content = text; | ||||
| } | } | ||||
| } | } | ||||
| @@ -149,10 +158,10 @@ namespace Discord.WebSocket | |||||
| => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="SocketNewsChannel"/> channel.</exception> | |||||
| /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="INewsChannel"/> channel.</exception> | |||||
| public async Task CrosspostAsync(RequestOptions options = null) | public async Task CrosspostAsync(RequestOptions options = null) | ||||
| { | { | ||||
| if (!(Channel is SocketNewsChannel)) | |||||
| if (!(Channel is INewsChannel)) | |||||
| { | { | ||||
| throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels."); | throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels."); | ||||
| } | } | ||||
| @@ -33,7 +33,7 @@ namespace Discord.Webhook | |||||
| : this(webhookUrl, new DiscordRestConfig()) { } | : this(webhookUrl, new DiscordRestConfig()) { } | ||||
| // regex pattern to match webhook urls | // regex pattern to match webhook urls | ||||
| private static Regex WebhookUrlRegex = new Regex(@"^.*(discord|discordapp)\.com\/api\/webhooks\/([\d]+)\/([a-z0-9_-]+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase); | |||||
| private static Regex WebhookUrlRegex = new Regex(@"^.*(discord|discordapp)\.com\/api\/webhooks\/([\d]+)\/([a-z0-9_-]+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.CultureInvariant); | |||||
| /// <summary> Creates a new Webhook Discord client. </summary> | /// <summary> Creates a new Webhook Discord client. </summary> | ||||
| public DiscordWebhookClient(ulong webhookId, string webhookToken, DiscordRestConfig config) | public DiscordWebhookClient(ulong webhookId, string webhookToken, DiscordRestConfig config) | ||||
| @@ -74,12 +74,12 @@ namespace Discord.Webhook | |||||
| _restLogger = LogManager.CreateLogger("Rest"); | _restLogger = LogManager.CreateLogger("Rest"); | ||||
| ApiClient.RequestQueue.RateLimitTriggered += async (id, info) => | |||||
| ApiClient.RequestQueue.RateLimitTriggered += async (id, info, endpoint) => | |||||
| { | { | ||||
| if (info == null) | if (info == null) | ||||
| await _restLogger.VerboseAsync($"Preemptive Rate limit triggered: {id?.ToString() ?? "null"}").ConfigureAwait(false); | |||||
| await _restLogger.VerboseAsync($"Preemptive Rate limit triggered: {endpoint} {(id.IsHashBucket ? $"(Bucket: {id.BucketHash})" : "")}").ConfigureAwait(false); | |||||
| else | else | ||||
| await _restLogger.WarningAsync($"Rate limit triggered: {id?.ToString() ?? "null"}").ConfigureAwait(false); | |||||
| await _restLogger.WarningAsync($"Rate limit triggered: {endpoint} {(id.IsHashBucket ? $"(Bucket: {id.BucketHash})" : "")}").ConfigureAwait(false); | |||||
| }; | }; | ||||
| ApiClient.SentRequest += async (method, endpoint, millis) => await _restLogger.VerboseAsync($"{method} {endpoint}: {millis} ms").ConfigureAwait(false); | ApiClient.SentRequest += async (method, endpoint, millis) => await _restLogger.VerboseAsync($"{method} {endpoint}: {millis} ms").ConfigureAwait(false); | ||||
| } | } | ||||
| @@ -88,19 +88,21 @@ namespace Discord.Webhook | |||||
| /// <summary> Sends a message to the channel for this webhook. </summary> | /// <summary> Sends a message to the channel for this webhook. </summary> | ||||
| /// <returns> Returns the ID of the created message. </returns> | /// <returns> Returns the ID of the created message. </returns> | ||||
| public Task<ulong> SendMessageAsync(string text = null, bool isTTS = false, IEnumerable<Embed> embeds = null, | public Task<ulong> SendMessageAsync(string text = null, bool isTTS = false, IEnumerable<Embed> embeds = null, | ||||
| string username = null, string avatarUrl = null, RequestOptions options = null) | |||||
| => WebhookClientHelper.SendMessageAsync(this, text, isTTS, embeds, username, avatarUrl, options); | |||||
| string username = null, string avatarUrl = null, RequestOptions options = null, AllowedMentions allowedMentions = null) | |||||
| => WebhookClientHelper.SendMessageAsync(this, text, isTTS, embeds, username, avatarUrl, allowedMentions, options); | |||||
| /// <summary> Sends a message to the channel for this webhook with an attachment. </summary> | /// <summary> Sends a message to the channel for this webhook with an attachment. </summary> | ||||
| /// <returns> Returns the ID of the created message. </returns> | /// <returns> Returns the ID of the created message. </returns> | ||||
| public Task<ulong> SendFileAsync(string filePath, string text, bool isTTS = false, | public Task<ulong> SendFileAsync(string filePath, string text, bool isTTS = false, | ||||
| IEnumerable<Embed> embeds = null, string username = null, string avatarUrl = null, RequestOptions options = null, bool isSpoiler = false) | |||||
| => WebhookClientHelper.SendFileAsync(this, filePath, text, isTTS, embeds, username, avatarUrl, options, isSpoiler); | |||||
| IEnumerable<Embed> embeds = null, string username = null, string avatarUrl = null, | |||||
| RequestOptions options = null, bool isSpoiler = false, AllowedMentions allowedMentions = null) | |||||
| => WebhookClientHelper.SendFileAsync(this, filePath, text, isTTS, embeds, username, avatarUrl, allowedMentions, options, isSpoiler); | |||||
| /// <summary> Sends a message to the channel for this webhook with an attachment. </summary> | /// <summary> Sends a message to the channel for this webhook with an attachment. </summary> | ||||
| /// <returns> Returns the ID of the created message. </returns> | /// <returns> Returns the ID of the created message. </returns> | ||||
| public Task<ulong> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, | public Task<ulong> SendFileAsync(Stream stream, string filename, string text, bool isTTS = false, | ||||
| IEnumerable<Embed> embeds = null, string username = null, string avatarUrl = null, RequestOptions options = null, bool isSpoiler = false) | |||||
| => WebhookClientHelper.SendFileAsync(this, stream, filename, text, isTTS, embeds, username, avatarUrl, options, isSpoiler); | |||||
| IEnumerable<Embed> embeds = null, string username = null, string avatarUrl = null, | |||||
| RequestOptions options = null, bool isSpoiler = false, AllowedMentions allowedMentions = null) | |||||
| => WebhookClientHelper.SendFileAsync(this, stream, filename, text, isTTS, embeds, username, avatarUrl, allowedMentions, options, isSpoiler); | |||||
| /// <summary> Modifies the properties of this webhook. </summary> | /// <summary> Modifies the properties of this webhook. </summary> | ||||
| public Task ModifyWebhookAsync(Action<WebhookProperties> func, RequestOptions options = null) | public Task ModifyWebhookAsync(Action<WebhookProperties> func, RequestOptions options = null) | ||||
| @@ -21,7 +21,7 @@ namespace Discord.Webhook | |||||
| return RestInternalWebhook.Create(client, model); | return RestInternalWebhook.Create(client, model); | ||||
| } | } | ||||
| public static async Task<ulong> SendMessageAsync(DiscordWebhookClient client, | public static async Task<ulong> SendMessageAsync(DiscordWebhookClient client, | ||||
| string text, bool isTTS, IEnumerable<Embed> embeds, string username, string avatarUrl, RequestOptions options) | |||||
| string text, bool isTTS, IEnumerable<Embed> embeds, string username, string avatarUrl, AllowedMentions allowedMentions, RequestOptions options) | |||||
| { | { | ||||
| var args = new CreateWebhookMessageParams(text) { IsTTS = isTTS }; | var args = new CreateWebhookMessageParams(text) { IsTTS = isTTS }; | ||||
| if (embeds != null) | if (embeds != null) | ||||
| @@ -30,19 +30,21 @@ namespace Discord.Webhook | |||||
| args.Username = username; | args.Username = username; | ||||
| if (avatarUrl != null) | if (avatarUrl != null) | ||||
| args.AvatarUrl = avatarUrl; | args.AvatarUrl = avatarUrl; | ||||
| if (allowedMentions != null) | |||||
| args.AllowedMentions = allowedMentions.ToModel(); | |||||
| var model = await client.ApiClient.CreateWebhookMessageAsync(client.Webhook.Id, args, options: options).ConfigureAwait(false); | var model = await client.ApiClient.CreateWebhookMessageAsync(client.Webhook.Id, args, options: options).ConfigureAwait(false); | ||||
| return model.Id; | return model.Id; | ||||
| } | } | ||||
| public static async Task<ulong> SendFileAsync(DiscordWebhookClient client, string filePath, string text, bool isTTS, | public static async Task<ulong> SendFileAsync(DiscordWebhookClient client, string filePath, string text, bool isTTS, | ||||
| IEnumerable<Embed> embeds, string username, string avatarUrl, RequestOptions options, bool isSpoiler) | |||||
| IEnumerable<Embed> embeds, string username, string avatarUrl, AllowedMentions allowedMentions, RequestOptions options, bool isSpoiler) | |||||
| { | { | ||||
| string filename = Path.GetFileName(filePath); | string filename = Path.GetFileName(filePath); | ||||
| using (var file = File.OpenRead(filePath)) | using (var file = File.OpenRead(filePath)) | ||||
| return await SendFileAsync(client, file, filename, text, isTTS, embeds, username, avatarUrl, options, isSpoiler).ConfigureAwait(false); | |||||
| return await SendFileAsync(client, file, filename, text, isTTS, embeds, username, avatarUrl, allowedMentions, options, isSpoiler).ConfigureAwait(false); | |||||
| } | } | ||||
| public static async Task<ulong> SendFileAsync(DiscordWebhookClient client, Stream stream, string filename, string text, bool isTTS, | public static async Task<ulong> SendFileAsync(DiscordWebhookClient client, Stream stream, string filename, string text, bool isTTS, | ||||
| IEnumerable<Embed> embeds, string username, string avatarUrl, RequestOptions options, bool isSpoiler) | |||||
| IEnumerable<Embed> embeds, string username, string avatarUrl, AllowedMentions allowedMentions, RequestOptions options, bool isSpoiler) | |||||
| { | { | ||||
| var args = new UploadWebhookFileParams(stream) { Filename = filename, Content = text, IsTTS = isTTS, IsSpoiler = isSpoiler }; | var args = new UploadWebhookFileParams(stream) { Filename = filename, Content = text, IsTTS = isTTS, IsSpoiler = isSpoiler }; | ||||
| if (username != null) | if (username != null) | ||||
| @@ -51,6 +53,8 @@ namespace Discord.Webhook | |||||
| args.AvatarUrl = avatarUrl; | args.AvatarUrl = avatarUrl; | ||||
| if (embeds != null) | if (embeds != null) | ||||
| args.Embeds = embeds.Select(x => x.ToModel()).ToArray(); | args.Embeds = embeds.Select(x => x.ToModel()).ToArray(); | ||||
| if(allowedMentions != null) | |||||
| args.AllowedMentions = allowedMentions.ToModel(); | |||||
| var msg = await client.ApiClient.UploadWebhookFileAsync(client.Webhook.Id, args, options).ConfigureAwait(false); | var msg = await client.ApiClient.UploadWebhookFileAsync(client.Webhook.Id, args, options).ConfigureAwait(false); | ||||
| return msg.Id; | return msg.Id; | ||||
| } | } | ||||
| @@ -69,6 +69,7 @@ namespace Discord | |||||
| AssertFlag(() => new GuildPermissions(manageGuild: true), GuildPermission.ManageGuild); | AssertFlag(() => new GuildPermissions(manageGuild: true), GuildPermission.ManageGuild); | ||||
| AssertFlag(() => new GuildPermissions(addReactions: true), GuildPermission.AddReactions); | AssertFlag(() => new GuildPermissions(addReactions: true), GuildPermission.AddReactions); | ||||
| AssertFlag(() => new GuildPermissions(viewAuditLog: true), GuildPermission.ViewAuditLog); | AssertFlag(() => new GuildPermissions(viewAuditLog: true), GuildPermission.ViewAuditLog); | ||||
| AssertFlag(() => new GuildPermissions(viewGuildInsights: true), GuildPermission.ViewGuildInsights); | |||||
| AssertFlag(() => new GuildPermissions(viewChannel: true), GuildPermission.ViewChannel); | AssertFlag(() => new GuildPermissions(viewChannel: true), GuildPermission.ViewChannel); | ||||
| AssertFlag(() => new GuildPermissions(sendMessages: true), GuildPermission.SendMessages); | AssertFlag(() => new GuildPermissions(sendMessages: true), GuildPermission.SendMessages); | ||||
| AssertFlag(() => new GuildPermissions(sendTTSMessages: true), GuildPermission.SendTTSMessages); | AssertFlag(() => new GuildPermissions(sendTTSMessages: true), GuildPermission.SendTTSMessages); | ||||
| @@ -141,6 +142,7 @@ namespace Discord | |||||
| AssertUtil(GuildPermission.ManageGuild, x => x.ManageGuild, (p, enable) => p.Modify(manageGuild: enable)); | AssertUtil(GuildPermission.ManageGuild, x => x.ManageGuild, (p, enable) => p.Modify(manageGuild: enable)); | ||||
| AssertUtil(GuildPermission.AddReactions, x => x.AddReactions, (p, enable) => p.Modify(addReactions: enable)); | AssertUtil(GuildPermission.AddReactions, x => x.AddReactions, (p, enable) => p.Modify(addReactions: enable)); | ||||
| AssertUtil(GuildPermission.ViewAuditLog, x => x.ViewAuditLog, (p, enable) => p.Modify(viewAuditLog: enable)); | AssertUtil(GuildPermission.ViewAuditLog, x => x.ViewAuditLog, (p, enable) => p.Modify(viewAuditLog: enable)); | ||||
| AssertUtil(GuildPermission.ViewGuildInsights, x => x.ViewGuildInsights, (p, enable) => p.Modify(viewGuildInsights: enable)); | |||||
| AssertUtil(GuildPermission.ViewChannel, x => x.ViewChannel, (p, enable) => p.Modify(viewChannel: enable)); | AssertUtil(GuildPermission.ViewChannel, x => x.ViewChannel, (p, enable) => p.Modify(viewChannel: enable)); | ||||
| AssertUtil(GuildPermission.SendMessages, x => x.SendMessages, (p, enable) => p.Modify(sendMessages: enable)); | AssertUtil(GuildPermission.SendMessages, x => x.SendMessages, (p, enable) => p.Modify(sendMessages: enable)); | ||||
| AssertUtil(GuildPermission.SendTTSMessages, x => x.SendTTSMessages, (p, enable) => p.Modify(sendTTSMessages: enable)); | AssertUtil(GuildPermission.SendTTSMessages, x => x.SendTTSMessages, (p, enable) => p.Modify(sendTTSMessages: enable)); | ||||
| @@ -83,7 +83,7 @@ namespace Discord | |||||
| public void BotTokenDoesNotThrowExceptions(string token) | public void BotTokenDoesNotThrowExceptions(string token) | ||||
| { | { | ||||
| // This example token is pulled from the Discord Docs | // This example token is pulled from the Discord Docs | ||||
| // https://discordapp.com/developers/docs/reference#authentication-example-bot-token-authorization-header | |||||
| // https://discord.com/developers/docs/reference#authentication-example-bot-token-authorization-header | |||||
| // should not throw any exception | // should not throw any exception | ||||
| TokenUtils.ValidateToken(TokenType.Bot, token); | TokenUtils.ValidateToken(TokenType.Bot, token); | ||||
| } | } | ||||
| @@ -12,18 +12,18 @@ namespace Discord | |||||
| public class DiscordWebhookClientTests | public class DiscordWebhookClientTests | ||||
| { | { | ||||
| [Theory] | [Theory] | ||||
| [InlineData("https://discordapp.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| [InlineData("https://discord.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | ||||
| // ptb, canary, etc will have slightly different urls | // ptb, canary, etc will have slightly different urls | ||||
| [InlineData("https://ptb.discordapp.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| [InlineData("https://ptb.discord.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | ||||
| [InlineData("https://canary.discordapp.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| [InlineData("https://canary.discord.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | ||||
| // don't care about https | // don't care about https | ||||
| [InlineData("http://canary.discordapp.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| [InlineData("http://canary.discord.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | ||||
| // this is the minimum that the regex cares about | // this is the minimum that the regex cares about | ||||
| [InlineData("discordapp.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| [InlineData("discord.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK", | |||||
| 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | 123412347732897802, "_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | ||||
| public void TestWebhook_Valid(string webhookurl, ulong expectedId, string expectedToken) | public void TestWebhook_Valid(string webhookurl, ulong expectedId, string expectedToken) | ||||
| { | { | ||||
| @@ -48,7 +48,7 @@ namespace Discord | |||||
| [Theory] | [Theory] | ||||
| [InlineData("123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | [InlineData("123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK")] | ||||
| // trailing slash | // trailing slash | ||||
| [InlineData("https://discordapp.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK/")] | |||||
| [InlineData("https://discord.com/api/webhooks/123412347732897802/_abcde123456789-ABCDEFGHIJKLMNOP12345678-abcdefghijklmnopABCDEFGHIJK/")] | |||||
| public void TestWebhook_Invalid(string webhookurl) | public void TestWebhook_Invalid(string webhookurl) | ||||
| { | { | ||||
| Assert.Throws<ArgumentException>(() => | Assert.Throws<ArgumentException>(() => | ||||