Merge Labs 3.X into dev (#1923)
* meta: bump version * Null or empty fix (#176) * Add components and stickers to ReplyAsync extension * Fixed null or empty * Changed Label to Description * -||- Co-authored-by: quin lynch <lynchquin@gmail.com> * More regions (#177) * Preconditions * ChannelHelper * RestDMChannel * RestGroupChannel * RestBan * RestGroupUser * EntityExtensions * DiscordSocketClient * DiscordSocketClient * Discord.net.core.xml fix (#178) * Changed Label to Description * Added Discord- .MessageComponent .ISticker[] ,Discord.MessageComponent,Discord.ISticker[] to ReplyAsync * Remove references to labs * Update Discord.Net.sln * Added SendMessagesInThreads and StartEmbeddedActivities. (#175) * Added SendMessagesInThreads and StartEmbeddedActivities. Adjusted owner perms. Change UsePublicThreads -> CreatePublicThreads Change UsePrivateThreads -> CreatePrivateThreads * removed extra /// * Added UsePublicThreads and UsePrivateThreads back with Obsolete Attribute * removed 'false' from Obsolete Attribute * Squashed commit of the following: commit dca41a348e36a9b4e7006ef3a76377eb32aad276 Author: quin lynch <lynchquin@gmail.com> Date: Thu Sep 23 07:02:19 2021 -0300 Autocomplete commands * meta: xml. closes #171 * Revert user agent and $device to dnet * meta: bump version * meta: bump vers * Fix sticker args * Grammer fix (#179) * Made IVoiceChannel mentionable * Embeds array for send message async (#181) * meta: bump version * meta: bump vers * Fix sticker args * Grammer fix (#179) * Added embeds for SendMessageAsync * [JsonProperty("embed")] forgot to remove this public Optional<Embed> Embed { get; set; } * It has been done as requested. * Changed the old way of handeling single embeds * Moved embeds param and added options param * xmls Co-authored-by: quin lynch <lynchquin@gmail.com> * Fix thread permissions (#183) * Update GuildPermissionsTests.cs * Update GuildPermissions.cs * Use compound assignment (#186) * Used compound assignment * -||- * -||- * Remove unnecessary suppression (#188) * Inlined variable declarations (#185) * Fixed some warnings (#184) * Fixed some warnings * Another fixed warning * Changed the SSendFileAsync to SendFileAsync * Removed para AlwaysAcknowledgeInteractions * Moved it back to the previous version * Added periods to the end like quin requested!! :(( Co-authored-by: MrCakeSlayer <13650699+MrCakeSlayer@users.noreply.github.com> * Object initialization can be simplified fixed (#189) * Conditional-expression-simplification (#193) * Capitlazation fixes (#192) * Removed-this. (#191) * Use 'switch' expression (#187) * Use 'switch' expression * Reverted it to the old switch case * Fixed-compiler-error (#194) * Submitting updates to include new permissions. (#195) * Submitting updates to include new permissions. * Make old permissions obsolete and update tests Co-authored-by: quin lynch <lynchquin@gmail.com> * Update azure-pipelines.yml * Update azure-pipelines.yml * Update azure-pipelines.yml * Add support for long in autocomplete option * Add support for sending files with multiple embeds (#196) * Add support for sending files with multiple embeds * Simplify prepending single embed to embed array * Consistency for embeds endpoints (#197) * Changed the way of handling prepending of embeds. For consistency. * reformatted the summary * Revert pipeline * Fix duplicate merge conflicts * Changed minimum slash command name length to 1 per Discord API docs (#198) * Channel endpoints requirements correction (#199) * Added some requirements to channels for topic * Changed check from NotNullOrEmpty to NotNullOrEmpty * Added some requirements to channels for name Preconditions.LessThan * Formatting of file * Added restriction for description not being null (#200) * Update azure-pipelines.yml * Update deploy.yml * Remove version tag from proj * Update deploy.yml * Removed versions from project files * Removed style of the nuget badge and added logo (#201) The style was not properly added to it and the plastic version does not look good with the discord badge. I thought it would look better with a logo * Fix Type not being set in SocketApplicationCommand * Remove useless GuildId property * meta: update XML * Add Autocomplete to SlashCommandOptionBuilder * Added autocomplete in SlashCommandOptionBuilder. (#206) Co-authored-by: Quin Lynch <49576606+quinchs@users.noreply.github.com> * Fix duplicate autocomplete * Fix #208 * Fix sub commands being interpreted as a parameter for autocomplete * Fix exposed optional * Support the discord:// protocol in buttons (#207) * Update UrlValidation.cs * Update ComponentBuilder.cs * Add docs and better error messages. * Fix wonky intentation * Add competing activity status type (#205) * Update GuildPermissionsTests.cs * Update GuildPermissions.cs * Add competing status type * Add Icons to IRole (#204) * Added icon field to IRole * Added GetGuildRoleIconUrl() * Added Clean Content Function (#174) * Added Clean Content Function * Fixed Spelling problems and bad var handling * Add StripMarkDown Method * Clean Content Expanded (#212) * Implement CleanContent In IMessage & RestMessage * Update Spelling and Documentation * Add SanatizeMessage to MessageHelper and Refactor Rest and Socket Message * Add event for autocomplete interaction (#214) * Spelling corrections (#215) * Remove null collections * Followup with file async warnings (#216) * Changed from NotNullOrWhitespace to NotNullOrEmpty * Added NotNullOrEmpty on filename * Added system to interpret from the path * Added a check for if it contains a period * It has been done, how ever it will break stuff * Changed to use ??= how ever still added error check * Added space under check * Changed from with a period to valid file extension * Added checks for SendFileAsync * Removed filename != null && * Add channel types in application command options. (#217) * add channel types in application command options * Indent Docs * Stage instance audit logs as well as thread audit log type * Update azure-pipelines.yml * Update azure-pipelines.yml * Fix system messages not including mentioned users. Added ContextMenuCommand message type * Remove file extension check (#218) * Fix NRE in modify guild channel * Fix 429's not being accounted for in ratelimit updates * meta: add net5 framework Co-Authored-By: MrCakeSlayer <13650699+MrCakeSlayer@users.noreply.github.com> * Proper doc logos (#221) * Update GuildPermissionsTests.cs * Update GuildPermissions.cs * Add competing activity status type * logo changes * logo text as path * add missing logo * Update package logo and favicon * Update docfx references * Remove XML files and use original pipeline format * Remove console writeline * Remove Console.WriteLine * Remove useless log * Rename Available sticker field to IsAvailable * Rename Available to IsAvailable in stickers * Add summary indent for role members * Add summary indent to SocketInvite * Rename DefaultPermission to IsDefaultPermission * Rename Default to IsDefault and Required to IsRequired in IApplicationCommandOption * Rename Default and Required to IsDefault and IsRequired in IApplicationCommandOption. Rename DefaultPermission to IsDefaultPermission in IApplicationCommand * Remove extra white spaces * Renamed Joined, Archived, and Locked to HasJoined, IsArchived, and IsLocked * Rename Live and DiscoverableDisabled to IsDiscoverableDisabled and IsLive in IStageChannel * Remove newline * Add indent to summaries * Remove unnecessary json serializer field * Fix ToEntity for roletags incorrectly using IsPremiumSubscriber * Update RestChannel for new channel types * Fix different rest channels not deserializing properly * fully qualify internal for UrlValidation and add indent to summary * Add missing periods to InteractionResponseType * Fix summary in IApplicationCommandOptionChoice * Update IApplicationCommandOption summaries * Update IApplicationCommandInteractionDataOption summaries * Update IApplicationCommandInteractionData summaries * Update IApplicationCommand summaries * Update ApplicationCommandType summaries * rename DefaultPermission to IsDefaultPermission in ApplicationCommandProperties * update ApplicationCommandOptionChoiceProperties summaries * Rename Default, Required, and Autocomplete to IsDefault, IsRequired, and IsAutocomplete in ApplicationCommandOptionProperties * Update SlashCommandProperties summaries * update SlashCommandBuilder boolean field names, summaries, and choice parameters * Update SelectMenuOption summaries, Rename Default to IsDefault in SelectMenuOption * update SelectMenuComponent summaries. Rename Disabled to IsDisabled in SelectMenuComponent * update ComponentBuilder summaries and boolean fields. * Update ButtonComponent summaries and boolean fields * update ActionRowComponent summaries * Update UserCommandBuilder * Update MessageCommandBuilder summaries and boolean properties * Update IGuild summary * Update IGuild summaries * Update StagePrivacyLevel summary * update IThreadChannel summaries * Update IStageChannel summaries * Refactor summaries and boolean property names * General cleanup (#223) * General cleanup * Add Async suffix to SendAutocompleteResult * Fix more formatting * Fix unused RequestOptions in GetActiveThreadsAsync * Add message to ArgumentNullException * Ephemeral attachments * Add missing jsonproperty attribute * Add IMessage.Interaction * Update attachment checks for embed urls * meta: bump version * Remove old package configs and update image * Update package logos * Fix logo reference for azure * Deprecate old package definitions in favor for target file * Deprecate old package definitions in favor for target file Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com> * Update package ids * Fix url validation * meta: bump version * Fix assignment of UserMentions (#233) * Fix CleanContent (#231) * Fix SocketSlashCommandData access modifier. (#237) Fixes #229 * Update README with better header (#232) * Update README with better header Adds HTML elements that implement the main logo & improve the redirection tag positions. * Resolving border issue in light-mode * Update sponsor section * Implement checks for interaction respond times and multiple interaction responses. closes #236, #235 * Add response check to socket auto complete * meta: bump versions * Fix #239 * meta: bump version * meta: update logo * meta: bump versions * Revert received at time, confirmed by discord staff to be accurate * Merge branch 'release/3.x' of https://github.com/Discord-Net-Labs/Discord.Net-Labs into merger-labs Update requested changes of obsolete and references to labs. Added `Interaction` to `IMessage` Fixed grammar Fixed bugs relating to interactions. * Update docs * Update CHANGELOG.md * meta: docs building * Update docs.yml * Update docs.yml * Fix docfx version * Update docs.yml * Update docs.bat * Rename docs repo for clone * update docfx version * Update docs.bat * Update docfx version * Remove docs from pipeline * FAQ revamped, metadata updated (#241) * FAQ revamped, metadata updated * Update FAQ.md * Update README.md * Docs index improvement * Fix InvalidOperationException in modify channel * feature: guild avatars, closes #238 * feature: modify role icons * meta: changelog * meta: bump version * Update README.md * Fix non value type options not being included in autocomplete * Add new activity flags (#254) * Add new activity flags * Add missing commas * Added support for GUILD_JOIN_REQUEST_DELETE event (#253) Fixes #247 * Adding BotHTTPInteraction user flag (#252) * animated guild banner support (#255) * Docs work (WIP) (#242) * Main page work * Metadata logo dir * More main page edits * Naming change * Dnet guide entries pruned * Add student hub guild directory channel (#256) * animated guild banner support * Add guild directory channel * Fix followup with file overwrite having incorrect parameter locations * Merge labs 3.x * Update GUILD_JOIN_REQUEST_DELETE event * Update head.tmpl.partial * Removed BannerId and AccentColor (#260) * Removed BannerId property, GetBannerURL method, and AccentColor property from IUser and socket entities. * Fixed errors in IUser.cs * Added back summary for GetAvatarUrl method in IUser.cs * Support Guild Boost Progress Bars (#262) * Support Guild Boost Progress Bars * Update SocketChannel.cs * Fix non-optional and unnecessary values. * Spelling * Reordering and consistency. * Remove log for reconnect * Add missing flags to SystemChannelMessageDeny (#267) * Fix labs reference in analyzer project and provider project * Rename new activity flags * Guild feature revamp and smart gateway intent checks * Get thread user implementation * Amend creating slash command guide (#269) * Adding BotHTTPInteraction user flag * Added comments explaining the Global command create stipulations. * Fix numeric type check for options * Add state checking to ConnectionManager.StartAsync (#272) * initial interface changes * Multi file upload + attachment editing * meta: bump versions * Update CHANGELOG.md * Update CHANGELOG.md * Support Min and Max values on ApplicationCommandOptions (#273) * Support Min and Max values on ApplicationCommandOptions * Support decimal min/max values * Docs imrpovments + use ToNullable * Logomark, doc settings edit (#258) * Logomark, doc settings edit * Replace standard logo * Bumping docfx plugins to latest release * Bump version metadata * Logo svg fix * Change default sticker behavior and add AlwaysResolveSticker to the config * Implement rest based interactions. Added ED25519 checks. Updated summaries. * Update package logo * Automatically fix ordering of optional command options (#276) * auto fix optional command option order * clean up indentation * Fix maximum number of Select Menu Options (#282) As of https://discord.com/developers/docs/interactions/message-components#select-menu-object-select-menu-structure the maximum number of options is 25, not less than 25. Hopefully the change catches all necessary locations * Add voice region to modify voice channels * Update summaries on rest interactions * Interaction Specific Interfaces (#283) * added interaction specific interfaces * fix build error * implement change requests * Update application * Add Guild Scheduled Events (#279) * guild events initial * sharded events * Add new gateway intents and fix bugs * More work on new changes to guild events * Update guild scheduled events * Added events to extended guild and add event start event * Update preconditions * Implement breaking changes guild guild events. Add guild event permissions * Update tests and change privacy level requirements * Update summaries and add docs for guild events * meta: bump version * Increment meta version (#285) * Increment meta version * Update docfx.json * Fix #289 and add configureawaits to rest based interactions * meta: bump version * Add GUILD_SCHEDULED_EVENT_USER_ADD and GUILD_SCHEDULED_EVENT_USER_REMOVE (#287) * Remove newline * Fix autocomplete result value * meta: bump versions * Add `GuildScheduledEventUserAdd` and `GuildScheduledEventUserRemove` to sharded client * Make RestUserCommand public (#292) * Fix Components not showing on FUWF (#288) (#293) Adds Components to Payload JSON Generation * Implement smarter rest resolvable interaction data. Fixes #294 * Add UseInteractionSnowflakeDate to config #286 * Implement Better Discord Errors (#291) * Initial error parsing * Implement better errors * Add missing error codes * Add voice disconnect opcodes * Remove unused class, add summaries to discordjsonerror, and remove public constructor of slash command properties * Add error code summary * Update error message summary * Update src/Discord.Net.Core/DiscordJsonError.cs Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com> * Update src/Discord.Net.WebSocket/API/Voice/VoiceCloseCode.cs Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com> * Fix autocomplete result value Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com> * Change the minimum length of slash commands to 1 (#284) * Change the minimum length of slash commands to 1. This is the correct value according to the docs and it has been changed after user feedback. * Fix the limit in 3 other places Co-authored-by: quin lynch <lynchquin@gmail.com> * Add new thread creation properties * Add role emoji. Fixes #295 * Fix mocked text channel * Fix precondition checks. Closes #281 * Initial fix (#297) * meta: bump version * Update from release/3.x * Remove more labs references * Remove doc file for Discord.Net.Analyzers Co-authored-by: Simon Hjorthøj <sh2@live.dk> Co-authored-by: drobbins329 <drobbins329@gmail.com> Co-authored-by: MrCakeSlayer <13650699+MrCakeSlayer@users.noreply.github.com> Co-authored-by: d4n3436 <dan3436@hotmail.com> Co-authored-by: Will <WilliamWelsh@users.noreply.github.com> Co-authored-by: Eugene Garbuzov <kkxo.mail@gmail.com> Co-authored-by: CottageDwellingCat <80918250+CottageDwellingCat@users.noreply.github.com> Co-authored-by: Emily <89871431+emillly-b@users.noreply.github.com> Co-authored-by: marens101 <marens101@gmail.com> Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com> Co-authored-by: Armano den Boef <68127614+Rozen4334@users.noreply.github.com> Co-authored-by: Bill <billchirico@gmail.com> Co-authored-by: Liege72 <65319395+Liege72@users.noreply.github.com> Co-authored-by: Floowey <floowey@gmx.at> Co-authored-by: Cenk Ergen <57065323+Cenngo@users.noreply.github.com> Co-authored-by: exsersewo <exsersewo@systemexit.co.uk> Co-authored-by: Dennis Fischer <fischer_dennis@live.de>
This commit is contained in:
@@ -8,12 +8,13 @@ using WidgetModel = Discord.API.GuildWidget;
|
||||
using Model = Discord.API.Guild;
|
||||
using RoleModel = Discord.API.Role;
|
||||
using ImageModel = Discord.API.Image;
|
||||
using System.IO;
|
||||
|
||||
namespace Discord.Rest
|
||||
{
|
||||
internal static class GuildHelper
|
||||
{
|
||||
//General
|
||||
#region General
|
||||
/// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception>
|
||||
public static async Task<Model> ModifyAsync(IGuild guild, BaseDiscordClient client,
|
||||
Action<GuildProperties> func, RequestOptions options)
|
||||
@@ -35,7 +36,8 @@ namespace Discord.Rest
|
||||
Banner = args.Banner.IsSpecified ? args.Banner.Value?.ToModel() : Optional.Create<ImageModel?>(),
|
||||
VerificationLevel = args.VerificationLevel,
|
||||
ExplicitContentFilter = args.ExplicitContentFilter,
|
||||
SystemChannelFlags = args.SystemChannelFlags
|
||||
SystemChannelFlags = args.SystemChannelFlags,
|
||||
IsBoostProgressBarEnabled = args.IsBoostProgressBarEnabled
|
||||
};
|
||||
|
||||
if (args.AfkChannel.IsSpecified)
|
||||
@@ -122,8 +124,9 @@ namespace Discord.Rest
|
||||
{
|
||||
await client.ApiClient.DeleteGuildAsync(guild.Id, options).ConfigureAwait(false);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Bans
|
||||
#region Bans
|
||||
public static async Task<IReadOnlyCollection<RestBan>> GetBansAsync(IGuild guild, BaseDiscordClient client,
|
||||
RequestOptions options)
|
||||
{
|
||||
@@ -147,8 +150,9 @@ namespace Discord.Rest
|
||||
{
|
||||
await client.ApiClient.RemoveGuildBanAsync(guild.Id, userId, options).ConfigureAwait(false);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Channels
|
||||
#region Channels
|
||||
public static async Task<RestGuildChannel> GetChannelAsync(IGuild guild, BaseDiscordClient client,
|
||||
ulong id, RequestOptions options)
|
||||
{
|
||||
@@ -220,6 +224,34 @@ namespace Discord.Rest
|
||||
var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
|
||||
return RestVoiceChannel.Create(client, guild, model);
|
||||
}
|
||||
public static async Task<RestStageChannel> CreateStageChannelAsync(IGuild guild, BaseDiscordClient client,
|
||||
string name, RequestOptions options, Action<VoiceChannelProperties> func = null)
|
||||
{
|
||||
if (name == null)
|
||||
throw new ArgumentNullException(paramName: nameof(name));
|
||||
|
||||
var props = new VoiceChannelProperties();
|
||||
func?.Invoke(props);
|
||||
|
||||
var args = new CreateGuildChannelParams(name, ChannelType.Stage)
|
||||
{
|
||||
CategoryId = props.CategoryId,
|
||||
Bitrate = props.Bitrate,
|
||||
UserLimit = props.UserLimit,
|
||||
Position = props.Position,
|
||||
Overwrites = props.PermissionOverwrites.IsSpecified
|
||||
? props.PermissionOverwrites.Value.Select(overwrite => new API.Overwrite
|
||||
{
|
||||
TargetId = overwrite.TargetId,
|
||||
TargetType = overwrite.TargetType,
|
||||
Allow = overwrite.Permissions.AllowValue.ToString(),
|
||||
Deny = overwrite.Permissions.DenyValue.ToString()
|
||||
}).ToArray()
|
||||
: Optional.Create<API.Overwrite[]>(),
|
||||
};
|
||||
var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
|
||||
return RestStageChannel.Create(client, guild, model);
|
||||
}
|
||||
/// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
|
||||
public static async Task<RestCategoryChannel> CreateCategoryChannelAsync(IGuild guild, BaseDiscordClient client,
|
||||
string name, RequestOptions options, Action<GuildChannelProperties> func = null)
|
||||
@@ -246,16 +278,18 @@ namespace Discord.Rest
|
||||
var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false);
|
||||
return RestCategoryChannel.Create(client, guild, model);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Voice Regions
|
||||
#region Voice Regions
|
||||
public static async Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(IGuild guild, BaseDiscordClient client,
|
||||
RequestOptions options)
|
||||
{
|
||||
var models = await client.ApiClient.GetGuildVoiceRegionsAsync(guild.Id, options).ConfigureAwait(false);
|
||||
return models.Select(x => RestVoiceRegion.Create(client, x)).ToImmutableArray();
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Integrations
|
||||
#region Integrations
|
||||
public static async Task<IReadOnlyCollection<RestGuildIntegration>> GetIntegrationsAsync(IGuild guild, BaseDiscordClient client,
|
||||
RequestOptions options)
|
||||
{
|
||||
@@ -269,8 +303,24 @@ namespace Discord.Rest
|
||||
var model = await client.ApiClient.CreateGuildIntegrationAsync(guild.Id, args, options).ConfigureAwait(false);
|
||||
return RestGuildIntegration.Create(client, guild, model);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Invites
|
||||
#region Interactions
|
||||
public static async Task<IReadOnlyCollection<RestGuildCommand>> GetSlashCommandsAsync(IGuild guild, BaseDiscordClient client,
|
||||
RequestOptions options)
|
||||
{
|
||||
var models = await client.ApiClient.GetGuildApplicationCommandsAsync(guild.Id, options);
|
||||
return models.Select(x => RestGuildCommand.Create(client, x, guild.Id)).ToImmutableArray();
|
||||
}
|
||||
public static async Task<RestGuildCommand> GetSlashCommandAsync(IGuild guild, ulong id, BaseDiscordClient client,
|
||||
RequestOptions options)
|
||||
{
|
||||
var model = await client.ApiClient.GetGuildApplicationCommandAsync(guild.Id, id, options);
|
||||
return RestGuildCommand.Create(client, model, guild.Id);
|
||||
}
|
||||
#endregion
|
||||
|
||||
#region Invites
|
||||
public static async Task<IReadOnlyCollection<RestInviteMetadata>> GetInvitesAsync(IGuild guild, BaseDiscordClient client,
|
||||
RequestOptions options)
|
||||
{
|
||||
@@ -286,8 +336,9 @@ namespace Discord.Rest
|
||||
inviteModel.Uses = vanityModel.Uses;
|
||||
return RestInviteMetadata.Create(client, guild, null, inviteModel);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Roles
|
||||
#region Roles
|
||||
/// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception>
|
||||
public static async Task<RestRole> CreateRoleAsync(IGuild guild, BaseDiscordClient client,
|
||||
string name, GuildPermissions? permissions, Color? color, bool isHoisted, bool isMentionable, RequestOptions options)
|
||||
@@ -307,8 +358,9 @@ namespace Discord.Rest
|
||||
|
||||
return RestRole.Create(client, guild, model);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Users
|
||||
#region Users
|
||||
public static async Task<RestGuildUser> AddGuildUserAsync(IGuild guild, BaseDiscordClient client, ulong userId, string accessToken,
|
||||
Action<AddGuildUserProperties> func, RequestOptions options)
|
||||
{
|
||||
@@ -427,8 +479,9 @@ namespace Discord.Rest
|
||||
var models = await client.ApiClient.SearchGuildMembersAsync(guild.Id, apiArgs, options).ConfigureAwait(false);
|
||||
return models.Select(x => RestGuildUser.Create(client, guild, x)).ToImmutableArray();
|
||||
}
|
||||
#endregion
|
||||
|
||||
// Audit logs
|
||||
#region Audit logs
|
||||
public static IAsyncEnumerable<IReadOnlyCollection<RestAuditLogEntry>> GetAuditLogsAsync(IGuild guild, BaseDiscordClient client,
|
||||
ulong? from, int? limit, RequestOptions options, ulong? userId = null, ActionType? actionType = null)
|
||||
{
|
||||
@@ -460,8 +513,9 @@ namespace Discord.Rest
|
||||
count: limit
|
||||
);
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Webhooks
|
||||
#region Webhooks
|
||||
public static async Task<RestWebhook> GetWebhookAsync(IGuild guild, BaseDiscordClient client, ulong id, RequestOptions options)
|
||||
{
|
||||
var model = await client.ApiClient.GetWebhookAsync(id, options: options).ConfigureAwait(false);
|
||||
@@ -474,8 +528,9 @@ namespace Discord.Rest
|
||||
var models = await client.ApiClient.GetGuildWebhooksAsync(guild.Id, options).ConfigureAwait(false);
|
||||
return models.Select(x => RestWebhook.Create(client, guild, x)).ToImmutableArray();
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Emotes
|
||||
#region Emotes
|
||||
public static async Task<IReadOnlyCollection<GuildEmote>> GetEmotesAsync(IGuild guild, BaseDiscordClient client, RequestOptions options)
|
||||
{
|
||||
var models = await client.ApiClient.GetGuildEmotesAsync(guild.Id, options).ConfigureAwait(false);
|
||||
@@ -521,5 +576,308 @@ namespace Discord.Rest
|
||||
}
|
||||
public static Task DeleteEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, RequestOptions options)
|
||||
=> client.ApiClient.DeleteGuildEmoteAsync(guild.Id, id, options);
|
||||
|
||||
public static async Task<API.Sticker> CreateStickerAsync(BaseDiscordClient client, IGuild guild, string name, string description, IEnumerable<string> tags,
|
||||
Image image, RequestOptions options = null)
|
||||
{
|
||||
Preconditions.NotNull(name, nameof(name));
|
||||
Preconditions.NotNull(description, nameof(description));
|
||||
|
||||
Preconditions.AtLeast(name.Length, 2, nameof(name));
|
||||
Preconditions.AtLeast(description.Length, 2, nameof(description));
|
||||
|
||||
Preconditions.AtMost(name.Length, 30, nameof(name));
|
||||
Preconditions.AtMost(description.Length, 100, nameof(name));
|
||||
|
||||
var apiArgs = new CreateStickerParams()
|
||||
{
|
||||
Name = name,
|
||||
Description = description,
|
||||
File = image.Stream,
|
||||
Tags = string.Join(", ", tags)
|
||||
};
|
||||
|
||||
return await client.ApiClient.CreateGuildStickerAsync(apiArgs, guild.Id, options).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
public static async Task<API.Sticker> CreateStickerAsync(BaseDiscordClient client, IGuild guild, string name, string description, IEnumerable<string> tags,
|
||||
Stream file, string filename, RequestOptions options = null)
|
||||
{
|
||||
Preconditions.NotNull(name, nameof(name));
|
||||
Preconditions.NotNull(description, nameof(description));
|
||||
Preconditions.NotNull(file, nameof(file));
|
||||
Preconditions.NotNull(filename, nameof(filename));
|
||||
|
||||
Preconditions.AtLeast(name.Length, 2, nameof(name));
|
||||
Preconditions.AtLeast(description.Length, 2, nameof(description));
|
||||
|
||||
Preconditions.AtMost(name.Length, 30, nameof(name));
|
||||
Preconditions.AtMost(description.Length, 100, nameof(name));
|
||||
|
||||
var apiArgs = new CreateStickerParams()
|
||||
{
|
||||
Name = name,
|
||||
Description = description,
|
||||
File = file,
|
||||
Tags = string.Join(", ", tags),
|
||||
FileName = filename
|
||||
};
|
||||
|
||||
return await client.ApiClient.CreateGuildStickerAsync(apiArgs, guild.Id, options).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
public static async Task<API.Sticker> ModifyStickerAsync(BaseDiscordClient client, ulong guildId, ISticker sticker, Action<StickerProperties> func,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
if (func == null)
|
||||
throw new ArgumentNullException(paramName: nameof(func));
|
||||
|
||||
var props = new StickerProperties();
|
||||
func(props);
|
||||
|
||||
var apiArgs = new ModifyStickerParams()
|
||||
{
|
||||
Description = props.Description,
|
||||
Name = props.Name,
|
||||
Tags = props.Tags.IsSpecified ?
|
||||
string.Join(", ", props.Tags.Value) :
|
||||
Optional<string>.Unspecified
|
||||
};
|
||||
|
||||
return await client.ApiClient.ModifyStickerAsync(apiArgs, guildId, sticker.Id, options).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
public static async Task DeleteStickerAsync(BaseDiscordClient client, ulong guildId, ISticker sticker, RequestOptions options = null)
|
||||
=> await client.ApiClient.DeleteStickerAsync(guildId, sticker.Id, options).ConfigureAwait(false);
|
||||
#endregion
|
||||
|
||||
#region Events
|
||||
|
||||
public static async Task<IReadOnlyCollection<RestUser>> GetEventUsersAsync(BaseDiscordClient client, IGuildScheduledEvent guildEvent, int limit = 100, RequestOptions options = null)
|
||||
{
|
||||
var models = await client.ApiClient.GetGuildScheduledEventUsersAsync(guildEvent.Id, guildEvent.Guild.Id, limit, options).ConfigureAwait(false);
|
||||
|
||||
return models.Select(x => RestUser.Create(client, guildEvent.Guild, x)).ToImmutableArray();
|
||||
}
|
||||
|
||||
public static IAsyncEnumerable<IReadOnlyCollection<RestUser>> GetEventUsersAsync(BaseDiscordClient client, IGuildScheduledEvent guildEvent,
|
||||
ulong? fromUserId, int? limit, RequestOptions options)
|
||||
{
|
||||
return new PagedAsyncEnumerable<RestUser>(
|
||||
DiscordConfig.MaxGuildEventUsersPerBatch,
|
||||
async (info, ct) =>
|
||||
{
|
||||
var args = new GetEventUsersParams
|
||||
{
|
||||
Limit = info.PageSize,
|
||||
RelativeDirection = Direction.After,
|
||||
};
|
||||
if (info.Position != null)
|
||||
args.RelativeUserId = info.Position.Value;
|
||||
var models = await client.ApiClient.GetGuildScheduledEventUsersAsync(guildEvent.Id, guildEvent.Guild.Id, args, options).ConfigureAwait(false);
|
||||
return models
|
||||
.Select(x => RestUser.Create(client, guildEvent.Guild, x))
|
||||
.ToImmutableArray();
|
||||
},
|
||||
nextPage: (info, lastPage) =>
|
||||
{
|
||||
if (lastPage.Count != DiscordConfig.MaxGuildEventUsersPerBatch)
|
||||
return false;
|
||||
info.Position = lastPage.Max(x => x.Id);
|
||||
return true;
|
||||
},
|
||||
start: fromUserId,
|
||||
count: limit
|
||||
);
|
||||
}
|
||||
|
||||
public static IAsyncEnumerable<IReadOnlyCollection<RestUser>> GetEventUsersAsync(BaseDiscordClient client, IGuildScheduledEvent guildEvent,
|
||||
ulong? fromUserId, Direction dir, int limit, RequestOptions options = null)
|
||||
{
|
||||
if (dir == Direction.Around && limit > DiscordConfig.MaxMessagesPerBatch)
|
||||
{
|
||||
int around = limit / 2;
|
||||
if (fromUserId.HasValue)
|
||||
return GetEventUsersAsync(client, guildEvent, fromUserId.Value + 1, Direction.Before, around + 1, options) //Need to include the message itself
|
||||
.Concat(GetEventUsersAsync(client, guildEvent, fromUserId, Direction.After, around, options));
|
||||
else //Shouldn't happen since there's no public overload for ulong? and Direction
|
||||
return GetEventUsersAsync(client, guildEvent, null, Direction.Before, around + 1, options);
|
||||
}
|
||||
|
||||
return new PagedAsyncEnumerable<RestUser>(
|
||||
DiscordConfig.MaxGuildEventUsersPerBatch,
|
||||
async (info, ct) =>
|
||||
{
|
||||
var args = new GetEventUsersParams
|
||||
{
|
||||
RelativeDirection = dir,
|
||||
Limit = info.PageSize
|
||||
};
|
||||
if (info.Position != null)
|
||||
args.RelativeUserId = info.Position.Value;
|
||||
|
||||
var models = await client.ApiClient.GetGuildScheduledEventUsersAsync(guildEvent.Id, guildEvent.Guild.Id, args, options).ConfigureAwait(false);
|
||||
var builder = ImmutableArray.CreateBuilder<RestUser>();
|
||||
foreach (var model in models)
|
||||
{
|
||||
builder.Add(RestUser.Create(client, guildEvent.Guild, model));
|
||||
}
|
||||
return builder.ToImmutable();
|
||||
},
|
||||
nextPage: (info, lastPage) =>
|
||||
{
|
||||
if (lastPage.Count != DiscordConfig.MaxGuildEventUsersPerBatch)
|
||||
return false;
|
||||
if (dir == Direction.Before)
|
||||
info.Position = lastPage.Min(x => x.Id);
|
||||
else
|
||||
info.Position = lastPage.Max(x => x.Id);
|
||||
return true;
|
||||
},
|
||||
start: fromUserId,
|
||||
count: limit
|
||||
);
|
||||
}
|
||||
|
||||
public static async Task<API.GuildScheduledEvent> ModifyGuildEventAsync(BaseDiscordClient client, Action<GuildScheduledEventsProperties> func,
|
||||
IGuildScheduledEvent guildEvent, RequestOptions options = null)
|
||||
{
|
||||
var args = new GuildScheduledEventsProperties();
|
||||
|
||||
func(args);
|
||||
|
||||
if (args.Status.IsSpecified)
|
||||
{
|
||||
switch (args.Status.Value)
|
||||
{
|
||||
case GuildScheduledEventStatus.Active when guildEvent.Status != GuildScheduledEventStatus.Scheduled:
|
||||
case GuildScheduledEventStatus.Completed when guildEvent.Status != GuildScheduledEventStatus.Active:
|
||||
case GuildScheduledEventStatus.Cancelled when guildEvent.Status != GuildScheduledEventStatus.Scheduled:
|
||||
throw new ArgumentException($"Cannot set event to {args.Status.Value} when events status is {guildEvent.Status}");
|
||||
}
|
||||
}
|
||||
|
||||
if (args.Type.IsSpecified)
|
||||
{
|
||||
// taken from https://discord.com/developers/docs/resources/guild-scheduled-event#modify-guild-scheduled-event
|
||||
switch (args.Type.Value)
|
||||
{
|
||||
case GuildScheduledEventType.External:
|
||||
if (!args.Location.IsSpecified)
|
||||
throw new ArgumentException("Location must be specified for external events.");
|
||||
if (!args.EndTime.IsSpecified)
|
||||
throw new ArgumentException("End time must be specified for external events.");
|
||||
if (!args.ChannelId.IsSpecified)
|
||||
throw new ArgumentException("Channel id must be set to null!");
|
||||
if (args.ChannelId.Value != null)
|
||||
throw new ArgumentException("Channel id must be set to null!");
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
var apiArgs = new ModifyGuildScheduledEventParams()
|
||||
{
|
||||
ChannelId = args.ChannelId,
|
||||
Description = args.Description,
|
||||
EndTime = args.EndTime,
|
||||
Name = args.Name,
|
||||
PrivacyLevel = args.PrivacyLevel,
|
||||
StartTime = args.StartTime,
|
||||
Status = args.Status,
|
||||
Type = args.Type
|
||||
};
|
||||
|
||||
if(args.Location.IsSpecified)
|
||||
{
|
||||
apiArgs.EntityMetadata = new API.GuildScheduledEventEntityMetadata()
|
||||
{
|
||||
Location = args.Location,
|
||||
};
|
||||
}
|
||||
|
||||
return await client.ApiClient.ModifyGuildScheduledEventAsync(apiArgs, guildEvent.Id, guildEvent.Guild.Id, options).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
public static async Task<RestGuildEvent> GetGuildEventAsync(BaseDiscordClient client, ulong id, IGuild guild, RequestOptions options = null)
|
||||
{
|
||||
var model = await client.ApiClient.GetGuildScheduledEventAsync(id, guild.Id, options).ConfigureAwait(false);
|
||||
|
||||
if (model == null)
|
||||
return null;
|
||||
|
||||
return RestGuildEvent.Create(client, guild, model);
|
||||
}
|
||||
|
||||
public static async Task<IReadOnlyCollection<RestGuildEvent>> GetGuildEventsAsync(BaseDiscordClient client, IGuild guild, RequestOptions options = null)
|
||||
{
|
||||
var models = await client.ApiClient.ListGuildScheduledEventsAsync(guild.Id, options).ConfigureAwait(false);
|
||||
|
||||
return models.Select(x => RestGuildEvent.Create(client, guild, x)).ToImmutableArray();
|
||||
}
|
||||
|
||||
public static async Task<RestGuildEvent> CreateGuildEventAsync(BaseDiscordClient client, IGuild guild,
|
||||
string name,
|
||||
GuildScheduledEventPrivacyLevel privacyLevel,
|
||||
DateTimeOffset startTime,
|
||||
GuildScheduledEventType type,
|
||||
string description = null,
|
||||
DateTimeOffset? endTime = null,
|
||||
ulong? channelId = null,
|
||||
string location = null,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
if(location != null)
|
||||
{
|
||||
Preconditions.AtMost(location.Length, 100, nameof(location));
|
||||
}
|
||||
|
||||
switch (type)
|
||||
{
|
||||
case GuildScheduledEventType.Stage or GuildScheduledEventType.Voice when channelId == null:
|
||||
throw new ArgumentException($"{nameof(channelId)} must not be null when type is {type}", nameof(channelId));
|
||||
case GuildScheduledEventType.External when channelId != null:
|
||||
throw new ArgumentException($"{nameof(channelId)} must be null when using external event type", nameof(channelId));
|
||||
case GuildScheduledEventType.External when location == null:
|
||||
throw new ArgumentException($"{nameof(location)} must not be null when using external event type", nameof(location));
|
||||
case GuildScheduledEventType.External when endTime == null:
|
||||
throw new ArgumentException($"{nameof(endTime)} must not be null when using external event type", nameof(endTime));
|
||||
}
|
||||
|
||||
if (startTime <= DateTimeOffset.Now)
|
||||
throw new ArgumentOutOfRangeException(nameof(startTime), "The start time for an event cannot be in the past");
|
||||
|
||||
if (endTime != null && endTime <= startTime)
|
||||
throw new ArgumentOutOfRangeException(nameof(endTime), $"{nameof(endTime)} cannot be before the start time");
|
||||
|
||||
var apiArgs = new CreateGuildScheduledEventParams()
|
||||
{
|
||||
ChannelId = channelId ?? Optional<ulong>.Unspecified,
|
||||
Description = description ?? Optional<string>.Unspecified,
|
||||
EndTime = endTime ?? Optional<DateTimeOffset>.Unspecified,
|
||||
Name = name,
|
||||
PrivacyLevel = privacyLevel,
|
||||
StartTime = startTime,
|
||||
Type = type
|
||||
};
|
||||
|
||||
if(location != null)
|
||||
{
|
||||
apiArgs.EntityMetadata = new API.GuildScheduledEventEntityMetadata()
|
||||
{
|
||||
Location = location
|
||||
};
|
||||
}
|
||||
|
||||
var model = await client.ApiClient.CreateGuildScheduledEventAsync(apiArgs, guild.Id, options).ConfigureAwait(false);
|
||||
|
||||
return RestGuildEvent.Create(client, guild, client.CurrentUser, model);
|
||||
}
|
||||
|
||||
public static async Task DeleteEventAsync(BaseDiscordClient client, IGuildScheduledEvent guildEvent, RequestOptions options = null)
|
||||
{
|
||||
await client.ApiClient.DeleteGuildScheduledEventAsync(guildEvent.Id, guildEvent.Guild.Id, options).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user