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:
Quin Lynch
@@ -19,6 +19,9 @@ using PresenceModel = Discord.API.Presence;
|
||||
using RoleModel = Discord.API.Role;
|
||||
using UserModel = Discord.API.User;
|
||||
using VoiceStateModel = Discord.API.VoiceState;
|
||||
using StickerModel = Discord.API.Sticker;
|
||||
using EventModel = Discord.API.GuildScheduledEvent;
|
||||
using System.IO;
|
||||
|
||||
namespace Discord.WebSocket
|
||||
{
|
||||
@@ -28,16 +31,19 @@ namespace Discord.WebSocket
|
||||
[DebuggerDisplay(@"{DebuggerDisplay,nq}")]
|
||||
public class SocketGuild : SocketEntity<ulong>, IGuild, IDisposable
|
||||
{
|
||||
#region SocketGuild
|
||||
#pragma warning disable IDISP002, IDISP006
|
||||
private readonly SemaphoreSlim _audioLock;
|
||||
private TaskCompletionSource<bool> _syncPromise, _downloaderPromise;
|
||||
private TaskCompletionSource<AudioClient> _audioConnectPromise;
|
||||
private ConcurrentHashSet<ulong> _channels;
|
||||
private ConcurrentDictionary<ulong, SocketGuildChannel> _channels;
|
||||
private ConcurrentDictionary<ulong, SocketGuildUser> _members;
|
||||
private ConcurrentDictionary<ulong, SocketRole> _roles;
|
||||
private ConcurrentDictionary<ulong, SocketVoiceState> _voiceStates;
|
||||
private ConcurrentDictionary<ulong, SocketCustomSticker> _stickers;
|
||||
private ConcurrentDictionary<ulong, SocketGuildEvent> _events;
|
||||
private ImmutableArray<GuildEmote> _emotes;
|
||||
private ImmutableArray<string> _features;
|
||||
|
||||
private AudioClient _audioClient;
|
||||
#pragma warning restore IDISP002, IDISP006
|
||||
|
||||
@@ -118,9 +124,14 @@ namespace Discord.WebSocket
|
||||
public int? MaxMembers { get; private set; }
|
||||
/// <inheritdoc />
|
||||
public int? MaxVideoChannelUsers { get; private set; }
|
||||
|
||||
/// <inheritdoc />
|
||||
public NsfwLevel NsfwLevel { get; private set; }
|
||||
/// <inheritdoc />
|
||||
public CultureInfo PreferredCulture { get; private set; }
|
||||
/// <inheritdoc />
|
||||
public bool IsBoostProgressBarEnabled { get; private set; }
|
||||
/// <inheritdoc />
|
||||
public GuildFeatures Features { get; private set; }
|
||||
|
||||
/// <inheritdoc />
|
||||
public DateTimeOffset CreatedAt => SnowflakeUtils.FromSnowflake(Id);
|
||||
@@ -131,7 +142,7 @@ namespace Discord.WebSocket
|
||||
/// <inheritdoc />
|
||||
public string DiscoverySplashUrl => CDN.GetGuildDiscoverySplashUrl(Id, DiscoverySplashId);
|
||||
/// <inheritdoc />
|
||||
public string BannerUrl => CDN.GetGuildBannerUrl(Id, BannerId);
|
||||
public string BannerUrl => CDN.GetGuildBannerUrl(Id, BannerId, ImageFormat.Auto);
|
||||
/// <summary> Indicates whether the client has all the members downloaded to the local guild cache. </summary>
|
||||
public bool HasAllMembers => MemberCount <= DownloadedMemberCount;// _downloaderPromise.Task.IsCompleted;
|
||||
/// <summary> Indicates whether the guild cache is synced to this guild. </summary>
|
||||
@@ -269,6 +280,14 @@ namespace Discord.WebSocket
|
||||
public IReadOnlyCollection<SocketVoiceChannel> VoiceChannels
|
||||
=> Channels.OfType<SocketVoiceChannel>().ToImmutableArray();
|
||||
/// <summary>
|
||||
/// Gets a collection of all stage channels in this guild.
|
||||
/// </summary>
|
||||
/// <returns>
|
||||
/// A read-only collection of stage channels found within this guild.
|
||||
/// </returns>
|
||||
public IReadOnlyCollection<SocketStageChannel> StageChannels
|
||||
=> Channels.OfType<SocketStageChannel>().ToImmutableArray();
|
||||
/// <summary>
|
||||
/// Gets a collection of all category channels in this guild.
|
||||
/// </summary>
|
||||
/// <returns>
|
||||
@@ -277,6 +296,14 @@ namespace Discord.WebSocket
|
||||
public IReadOnlyCollection<SocketCategoryChannel> CategoryChannels
|
||||
=> Channels.OfType<SocketCategoryChannel>().ToImmutableArray();
|
||||
/// <summary>
|
||||
/// Gets a collection of all thread channels in this guild.
|
||||
/// </summary>
|
||||
/// <returns>
|
||||
/// A read-only collection of thread channels found within this guild.
|
||||
/// </returns>
|
||||
public IReadOnlyCollection<SocketThreadChannel> ThreadChannels
|
||||
=> Channels.OfType<SocketThreadChannel>().ToImmutableArray();
|
||||
/// <summary>
|
||||
/// Gets the current logged-in user.
|
||||
/// </summary>
|
||||
public SocketGuildUser CurrentUser => _members.TryGetValue(Discord.CurrentUser.Id, out SocketGuildUser member) ? member : null;
|
||||
@@ -299,13 +326,16 @@ namespace Discord.WebSocket
|
||||
{
|
||||
var channels = _channels;
|
||||
var state = Discord.State;
|
||||
return channels.Select(x => state.GetChannel(x) as SocketGuildChannel).Where(x => x != null).ToReadOnlyCollection(channels);
|
||||
return channels.Select(x => x.Value).Where(x => x != null).ToReadOnlyCollection(channels);
|
||||
}
|
||||
}
|
||||
/// <inheritdoc />
|
||||
public IReadOnlyCollection<GuildEmote> Emotes => _emotes;
|
||||
/// <inheritdoc />
|
||||
public IReadOnlyCollection<string> Features => _features;
|
||||
/// <summary>
|
||||
/// Gets a collection of all custom stickers for this guild.
|
||||
/// </summary>
|
||||
public IReadOnlyCollection<SocketCustomSticker> Stickers
|
||||
=> _stickers.Select(x => x.Value).ToImmutableArray();
|
||||
/// <summary>
|
||||
/// Gets a collection of users in this guild.
|
||||
/// </summary>
|
||||
@@ -336,12 +366,22 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public IReadOnlyCollection<SocketRole> Roles => _roles.ToReadOnlyCollection();
|
||||
|
||||
/// <summary>
|
||||
/// Gets a collection of all events within this guild.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// This field is based off of caching alone, since there is no events returned on the guild model.
|
||||
/// </remarks>
|
||||
/// <returns>
|
||||
/// A read-only collection of guild events found within this guild.
|
||||
/// </returns>
|
||||
public IReadOnlyCollection<SocketGuildEvent> Events => _events.ToReadOnlyCollection();
|
||||
|
||||
internal SocketGuild(DiscordSocketClient client, ulong id)
|
||||
: base(client, id)
|
||||
{
|
||||
_audioLock = new SemaphoreSlim(1, 1);
|
||||
_emotes = ImmutableArray.Create<GuildEmote>();
|
||||
_features = ImmutableArray.Create<string>();
|
||||
}
|
||||
internal static SocketGuild Create(DiscordSocketClient discord, ClientState state, ExtendedModel model)
|
||||
{
|
||||
@@ -354,8 +394,10 @@ namespace Discord.WebSocket
|
||||
IsAvailable = !(model.Unavailable ?? false);
|
||||
if (!IsAvailable)
|
||||
{
|
||||
if(_events == null)
|
||||
_events = new ConcurrentDictionary<ulong, SocketGuildEvent>();
|
||||
if (_channels == null)
|
||||
_channels = new ConcurrentHashSet<ulong>();
|
||||
_channels = new ConcurrentDictionary<ulong, SocketGuildChannel>();
|
||||
if (_members == null)
|
||||
_members = new ConcurrentDictionary<ulong, SocketGuildUser>();
|
||||
if (_roles == null)
|
||||
@@ -371,15 +413,23 @@ namespace Discord.WebSocket
|
||||
|
||||
Update(state, model as Model);
|
||||
|
||||
var channels = new ConcurrentHashSet<ulong>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(model.Channels.Length * 1.05));
|
||||
var channels = new ConcurrentDictionary<ulong, SocketGuildChannel>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(model.Channels.Length * 1.05));
|
||||
{
|
||||
for (int i = 0; i < model.Channels.Length; i++)
|
||||
{
|
||||
var channel = SocketGuildChannel.Create(this, state, model.Channels[i]);
|
||||
state.AddChannel(channel);
|
||||
channels.TryAdd(channel.Id);
|
||||
channels.TryAdd(channel.Id, channel);
|
||||
}
|
||||
|
||||
for(int i = 0; i < model.Threads.Length; i++)
|
||||
{
|
||||
var threadChannel = SocketThreadChannel.Create(this, state, model.Threads[i]);
|
||||
state.AddChannel(threadChannel);
|
||||
channels.TryAdd(threadChannel.Id, threadChannel);
|
||||
}
|
||||
}
|
||||
|
||||
_channels = channels;
|
||||
|
||||
var members = new ConcurrentDictionary<ulong, SocketGuildUser>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(model.Members.Length * 1.05));
|
||||
@@ -414,6 +464,17 @@ namespace Discord.WebSocket
|
||||
}
|
||||
_voiceStates = voiceStates;
|
||||
|
||||
var events = new ConcurrentDictionary<ulong, SocketGuildEvent>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(model.GuildScheduledEvents.Length * 1.05));
|
||||
{
|
||||
for (int i = 0; i < model.GuildScheduledEvents.Length; i++)
|
||||
{
|
||||
var guildEvent = SocketGuildEvent.Create(Discord, this, model.GuildScheduledEvents[i]);
|
||||
events.TryAdd(guildEvent.Id, guildEvent);
|
||||
}
|
||||
}
|
||||
_events = events;
|
||||
|
||||
|
||||
_syncPromise = new TaskCompletionSource<bool>();
|
||||
_downloaderPromise = new TaskCompletionSource<bool>();
|
||||
var _ = _syncPromise.TrySetResultAsync(true);
|
||||
@@ -448,6 +509,7 @@ namespace Discord.WebSocket
|
||||
SystemChannelFlags = model.SystemChannelFlags;
|
||||
Description = model.Description;
|
||||
PremiumSubscriptionCount = model.PremiumSubscriptionCount.GetValueOrDefault();
|
||||
NsfwLevel = model.NsfwLevel;
|
||||
if (model.MaxPresences.IsSpecified)
|
||||
MaxPresences = model.MaxPresences.Value ?? 25000;
|
||||
if (model.MaxMembers.IsSpecified)
|
||||
@@ -456,7 +518,8 @@ namespace Discord.WebSocket
|
||||
MaxVideoChannelUsers = model.MaxVideoChannelUsers.Value;
|
||||
PreferredLocale = model.PreferredLocale;
|
||||
PreferredCulture = PreferredLocale == null ? null : new CultureInfo(PreferredLocale);
|
||||
|
||||
if (model.IsBoostProgressBarEnabled.IsSpecified)
|
||||
IsBoostProgressBarEnabled = model.IsBoostProgressBarEnabled.Value;
|
||||
if (model.Emojis != null)
|
||||
{
|
||||
var emojis = ImmutableArray.CreateBuilder<GuildEmote>(model.Emojis.Length);
|
||||
@@ -467,10 +530,7 @@ namespace Discord.WebSocket
|
||||
else
|
||||
_emotes = ImmutableArray.Create<GuildEmote>();
|
||||
|
||||
if (model.Features != null)
|
||||
_features = model.Features.ToImmutableArray();
|
||||
else
|
||||
_features = ImmutableArray.Create<string>();
|
||||
Features = model.Features;
|
||||
|
||||
var roles = new ConcurrentDictionary<ulong, SocketRole>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(model.Roles.Length * 1.05));
|
||||
if (model.Roles != null)
|
||||
@@ -482,6 +542,25 @@ namespace Discord.WebSocket
|
||||
}
|
||||
}
|
||||
_roles = roles;
|
||||
|
||||
if (model.Stickers != null)
|
||||
{
|
||||
var stickers = new ConcurrentDictionary<ulong, SocketCustomSticker>(ConcurrentHashSet.DefaultConcurrencyLevel, (int)(model.Stickers.Length * 1.05));
|
||||
for (int i = 0; i < model.Stickers.Length; i++)
|
||||
{
|
||||
var sticker = model.Stickers[i];
|
||||
if (sticker.User.IsSpecified)
|
||||
AddOrUpdateUser(sticker.User.Value);
|
||||
|
||||
var entity = SocketCustomSticker.Create(Discord, sticker, this, sticker.User.IsSpecified ? sticker.User.Value.Id : null);
|
||||
|
||||
stickers.TryAdd(sticker.Id, entity);
|
||||
}
|
||||
|
||||
_stickers = stickers;
|
||||
}
|
||||
else
|
||||
_stickers = new ConcurrentDictionary<ulong, SocketCustomSticker>(ConcurrentHashSet.DefaultConcurrencyLevel, 7);
|
||||
}
|
||||
/*internal void Update(ClientState state, GuildSyncModel model) //TODO remove? userbot related
|
||||
{
|
||||
@@ -514,8 +593,9 @@ namespace Discord.WebSocket
|
||||
emotes.Add(model.Emojis[i].ToEntity());
|
||||
_emotes = emotes.ToImmutable();
|
||||
}
|
||||
#endregion
|
||||
|
||||
//General
|
||||
#region General
|
||||
/// <inheritdoc />
|
||||
public Task DeleteAsync(RequestOptions options = null)
|
||||
=> GuildHelper.DeleteAsync(this, Discord, options);
|
||||
@@ -539,8 +619,9 @@ namespace Discord.WebSocket
|
||||
/// <inheritdoc />
|
||||
public Task LeaveAsync(RequestOptions options = null)
|
||||
=> GuildHelper.LeaveAsync(this, Discord, options);
|
||||
#endregion
|
||||
|
||||
//Bans
|
||||
#region Bans
|
||||
/// <summary>
|
||||
/// Gets a collection of all users banned in this guild.
|
||||
/// </summary>
|
||||
@@ -588,8 +669,9 @@ namespace Discord.WebSocket
|
||||
/// <inheritdoc />
|
||||
public Task RemoveBanAsync(ulong userId, RequestOptions options = null)
|
||||
=> GuildHelper.RemoveBanAsync(this, Discord, userId, options);
|
||||
#endregion
|
||||
|
||||
//Channels
|
||||
#region Channels
|
||||
/// <summary>
|
||||
/// Gets a channel in this guild.
|
||||
/// </summary>
|
||||
@@ -614,6 +696,16 @@ namespace Discord.WebSocket
|
||||
public SocketTextChannel GetTextChannel(ulong id)
|
||||
=> GetChannel(id) as SocketTextChannel;
|
||||
/// <summary>
|
||||
/// Gets a thread in this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The snowflake identifier for the thread.</param>
|
||||
/// <returns>
|
||||
/// A thread channel associated with the specified <paramref name="id" />; <see langword="null"/> if none is found.
|
||||
/// </returns>
|
||||
public SocketThreadChannel GetThreadChannel(ulong id)
|
||||
=> GetChannel(id) as SocketThreadChannel;
|
||||
|
||||
/// <summary>
|
||||
/// Gets a voice channel in this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The snowflake identifier for the voice channel.</param>
|
||||
@@ -623,6 +715,15 @@ namespace Discord.WebSocket
|
||||
public SocketVoiceChannel GetVoiceChannel(ulong id)
|
||||
=> GetChannel(id) as SocketVoiceChannel;
|
||||
/// <summary>
|
||||
/// Gets a stage channel in this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The snowflake identifier for the stage channel.</param>
|
||||
/// <returns>
|
||||
/// A stage channel associated with the specified <paramref name="id" />; <see langword="null"/> if none is found.
|
||||
/// </returns>
|
||||
public SocketStageChannel GetStageChannel(ulong id)
|
||||
=> GetChannel(id) as SocketStageChannel;
|
||||
/// <summary>
|
||||
/// Gets a category channel in this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The snowflake identifier for the category channel.</param>
|
||||
@@ -670,6 +771,19 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public Task<RestVoiceChannel> CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func = null, RequestOptions options = null)
|
||||
=> GuildHelper.CreateVoiceChannelAsync(this, Discord, name, options, func);
|
||||
|
||||
/// <summary>
|
||||
/// Creates a new stage channel in this guild.
|
||||
/// </summary>
|
||||
/// <param name="name">The new name for the stage channel.</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>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous creation operation. The task result contains the newly created
|
||||
/// stage channel.
|
||||
/// </returns>
|
||||
public Task<RestStageChannel> CreateStageChannelAsync(string name, Action<VoiceChannelProperties> func = null, RequestOptions options = null)
|
||||
=> GuildHelper.CreateStageChannelAsync(this, Discord, name, options, func);
|
||||
/// <summary>
|
||||
/// Creates a new channel category in this guild.
|
||||
/// </summary>
|
||||
@@ -687,25 +801,40 @@ namespace Discord.WebSocket
|
||||
internal SocketGuildChannel AddChannel(ClientState state, ChannelModel model)
|
||||
{
|
||||
var channel = SocketGuildChannel.Create(this, state, model);
|
||||
_channels.TryAdd(model.Id);
|
||||
_channels.TryAdd(model.Id, channel);
|
||||
state.AddChannel(channel);
|
||||
return channel;
|
||||
}
|
||||
|
||||
internal SocketGuildChannel AddOrUpdateChannel(ClientState state, ChannelModel model)
|
||||
{
|
||||
if (_channels.TryGetValue(model.Id, out SocketGuildChannel channel))
|
||||
channel.Update(Discord.State, model);
|
||||
else
|
||||
{
|
||||
channel = SocketGuildChannel.Create(this, Discord.State, model);
|
||||
_channels[channel.Id] = channel;
|
||||
state.AddChannel(channel);
|
||||
}
|
||||
return channel;
|
||||
}
|
||||
|
||||
internal SocketGuildChannel RemoveChannel(ClientState state, ulong id)
|
||||
{
|
||||
if (_channels.TryRemove(id))
|
||||
if (_channels.TryRemove(id, out var _))
|
||||
return state.RemoveChannel(id) as SocketGuildChannel;
|
||||
return null;
|
||||
}
|
||||
internal void PurgeChannelCache(ClientState state)
|
||||
{
|
||||
foreach (var channelId in _channels)
|
||||
state.RemoveChannel(channelId);
|
||||
state.RemoveChannel(channelId.Key);
|
||||
|
||||
_channels.Clear();
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Voice Regions
|
||||
#region Voice Regions
|
||||
/// <summary>
|
||||
/// Gets a collection of all the voice regions this guild can access.
|
||||
/// </summary>
|
||||
@@ -716,14 +845,124 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public Task<IReadOnlyCollection<RestVoiceRegion>> GetVoiceRegionsAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetVoiceRegionsAsync(this, Discord, options);
|
||||
#endregion
|
||||
|
||||
//Integrations
|
||||
#region Integrations
|
||||
public Task<IReadOnlyCollection<RestGuildIntegration>> GetIntegrationsAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetIntegrationsAsync(this, Discord, options);
|
||||
public Task<RestGuildIntegration> CreateIntegrationAsync(ulong id, string type, RequestOptions options = null)
|
||||
=> GuildHelper.CreateIntegrationAsync(this, Discord, id, type, options);
|
||||
#endregion
|
||||
|
||||
//Invites
|
||||
#region Interactions
|
||||
/// <summary>
|
||||
/// Deletes all application commands in the current guild.
|
||||
/// </summary>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous delete operation.
|
||||
/// </returns>
|
||||
public Task DeleteApplicationCommandsAsync(RequestOptions options = null)
|
||||
=> InteractionHelper.DeleteAllGuildCommandsAsync(Discord, Id, options);
|
||||
|
||||
/// <summary>
|
||||
/// Gets a collection of slash commands created by the current user in this guild.
|
||||
/// </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 a read-only collection of
|
||||
/// slash commands created by the current user.
|
||||
/// </returns>
|
||||
public async Task<IReadOnlyCollection<SocketApplicationCommand>> GetApplicationCommandsAsync(RequestOptions options = null)
|
||||
{
|
||||
var commands = (await Discord.ApiClient.GetGuildApplicationCommandsAsync(Id, options)).Select(x => SocketApplicationCommand.Create(Discord, x, Id));
|
||||
|
||||
foreach (var command in commands)
|
||||
{
|
||||
Discord.State.AddCommand(command);
|
||||
}
|
||||
|
||||
return commands.ToImmutableArray();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets an application command within this guild with the specified id.
|
||||
/// </summary>
|
||||
/// <param name="id">The id of the application command to get.</param>
|
||||
/// <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 ValueTask that represents the asynchronous get operation. The task result contains a <see cref="IApplicationCommand"/>
|
||||
/// if found, otherwise <see langword="null"/>.
|
||||
/// </returns>
|
||||
public async ValueTask<SocketApplicationCommand> GetApplicationCommandAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null)
|
||||
{
|
||||
var command = Discord.State.GetCommand(id);
|
||||
|
||||
if (command != null)
|
||||
return command;
|
||||
|
||||
if (mode == CacheMode.CacheOnly)
|
||||
return null;
|
||||
|
||||
var model = await Discord.ApiClient.GetGlobalApplicationCommandAsync(id, options);
|
||||
|
||||
if (model == null)
|
||||
return null;
|
||||
|
||||
command = SocketApplicationCommand.Create(Discord, model, Id);
|
||||
|
||||
Discord.State.AddCommand(command);
|
||||
|
||||
return command;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Creates an application command within this guild.
|
||||
/// </summary>
|
||||
/// <param name="properties">The properties to use when creating the command.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous creation operation. The task result contains the command that was created.
|
||||
/// </returns>
|
||||
public async Task<SocketApplicationCommand> CreateApplicationCommandAsync(ApplicationCommandProperties properties, RequestOptions options = null)
|
||||
{
|
||||
var model = await InteractionHelper.CreateGuildCommandAsync(Discord, Id, properties, options);
|
||||
|
||||
var entity = Discord.State.GetOrAddCommand(model.Id, (id) => SocketApplicationCommand.Create(Discord, model));
|
||||
|
||||
entity.Update(model);
|
||||
|
||||
return entity;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Overwrites the application commands within this guild.
|
||||
/// </summary>
|
||||
/// <param name="properties">A collection of properties to use when creating the commands.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous creation operation. The task result contains a collection of commands that was created.
|
||||
/// </returns>
|
||||
public async Task<IReadOnlyCollection<SocketApplicationCommand>> BulkOverwriteApplicationCommandAsync(ApplicationCommandProperties[] properties,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
var models = await InteractionHelper.BulkOverwriteGuildCommandsAsync(Discord, Id, properties, options);
|
||||
|
||||
var entities = models.Select(x => SocketApplicationCommand.Create(Discord, x));
|
||||
|
||||
Discord.State.PurgeCommands(x => !x.IsGlobalCommand && x.Guild.Id == Id);
|
||||
|
||||
foreach(var entity in entities)
|
||||
{
|
||||
Discord.State.AddCommand(entity);
|
||||
}
|
||||
|
||||
return entities.ToImmutableArray();
|
||||
}
|
||||
#endregion
|
||||
|
||||
#region Invites
|
||||
/// <summary>
|
||||
/// Gets a collection of all invites in this guild.
|
||||
/// </summary>
|
||||
@@ -744,8 +983,9 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public Task<RestInviteMetadata> GetVanityInviteAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetVanityInviteAsync(this, Discord, options);
|
||||
#endregion
|
||||
|
||||
//Roles
|
||||
#region Roles
|
||||
/// <summary>
|
||||
/// Gets a role in this guild.
|
||||
/// </summary>
|
||||
@@ -794,7 +1034,45 @@ namespace Discord.WebSocket
|
||||
return null;
|
||||
}
|
||||
|
||||
//Users
|
||||
internal SocketRole AddOrUpdateRole(RoleModel model)
|
||||
{
|
||||
if (_roles.TryGetValue(model.Id, out SocketRole role))
|
||||
_roles[model.Id].Update(Discord.State, model);
|
||||
else
|
||||
role = AddRole(model);
|
||||
|
||||
return role;
|
||||
}
|
||||
|
||||
internal SocketCustomSticker AddSticker(StickerModel model)
|
||||
{
|
||||
if (model.User.IsSpecified)
|
||||
AddOrUpdateUser(model.User.Value);
|
||||
|
||||
var sticker = SocketCustomSticker.Create(Discord, model, this, model.User.IsSpecified ? model.User.Value.Id : null);
|
||||
_stickers[model.Id] = sticker;
|
||||
return sticker;
|
||||
}
|
||||
|
||||
internal SocketCustomSticker AddOrUpdateSticker(StickerModel model)
|
||||
{
|
||||
if (_stickers.TryGetValue(model.Id, out SocketCustomSticker sticker))
|
||||
_stickers[model.Id].Update(model);
|
||||
else
|
||||
sticker = AddSticker(model);
|
||||
|
||||
return sticker;
|
||||
}
|
||||
|
||||
internal SocketCustomSticker RemoveSticker(ulong id)
|
||||
{
|
||||
if (_stickers.TryRemove(id, out SocketCustomSticker sticker))
|
||||
return sticker;
|
||||
return null;
|
||||
}
|
||||
#endregion
|
||||
|
||||
#region Users
|
||||
/// <inheritdoc />
|
||||
public Task<RestGuildUser> AddGuildUserAsync(ulong id, string accessToken, Action<AddGuildUserProperties> func = null, RequestOptions options = null)
|
||||
=> GuildHelper.AddGuildUserAsync(this, Discord, id, accessToken, func, options);
|
||||
@@ -935,8 +1213,118 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public Task<IReadOnlyCollection<RestGuildUser>> SearchUsersAsync(string query, int limit = DiscordConfig.MaxUsersPerBatch, RequestOptions options = null)
|
||||
=> GuildHelper.SearchUsersAsync(this, Discord, query, limit, options);
|
||||
#endregion
|
||||
|
||||
//Audit logs
|
||||
#region Guild Events
|
||||
|
||||
/// <summary>
|
||||
/// Gets an event in this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The snowflake identifier for the event.</param>
|
||||
/// <returns>
|
||||
/// An event that is associated with the specified <paramref name="id"/>; <see langword="null"/> if none is found.
|
||||
/// </returns>
|
||||
public SocketGuildEvent GetEvent(ulong id)
|
||||
{
|
||||
if (_events.TryGetValue(id, out SocketGuildEvent value))
|
||||
return value;
|
||||
return null;
|
||||
}
|
||||
|
||||
internal SocketGuildEvent RemoveEvent(ulong id)
|
||||
{
|
||||
if (_events.TryRemove(id, out SocketGuildEvent value))
|
||||
return value;
|
||||
return null;
|
||||
}
|
||||
|
||||
internal SocketGuildEvent AddOrUpdateEvent(EventModel model)
|
||||
{
|
||||
if (_events.TryGetValue(model.Id, out SocketGuildEvent value))
|
||||
value.Update(model);
|
||||
else
|
||||
{
|
||||
value = SocketGuildEvent.Create(Discord, this, model);
|
||||
_events[model.Id] = value;
|
||||
}
|
||||
return value;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets an event within this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The snowflake identifier for the event.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous get operation.
|
||||
/// </returns>
|
||||
public Task<RestGuildEvent> GetEventAsync(ulong id, RequestOptions options = null)
|
||||
=> GuildHelper.GetGuildEventAsync(Discord, id, this, options);
|
||||
|
||||
/// <summary>
|
||||
/// Gets all active events within this guild.
|
||||
/// </summary>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous get operation.
|
||||
/// </returns>
|
||||
public Task<IReadOnlyCollection<RestGuildEvent>> GetEventsAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetGuildEventsAsync(Discord, this, options);
|
||||
|
||||
/// <summary>
|
||||
/// Creates an event within this guild.
|
||||
/// </summary>
|
||||
/// <param name="name">The name of the event.</param>
|
||||
/// <param name="privacyLevel">The privacy level of the event.</param>
|
||||
/// <param name="startTime">The start time of the event.</param>
|
||||
/// <param name="type">The type of the event.</param>
|
||||
/// <param name="description">The description of the event.</param>
|
||||
/// <param name="endTime">The end time of the event.</param>
|
||||
/// <param name="channelId">
|
||||
/// The channel id of the event.
|
||||
/// <remarks>
|
||||
/// The event must have a type of <see cref="GuildScheduledEventType.Stage"/> or <see cref="GuildScheduledEventType.Voice"/>
|
||||
/// in order to use this property.
|
||||
/// </remarks>
|
||||
/// </param>
|
||||
/// <param name="speakers">A collection of speakers for the event.</param>
|
||||
/// <param name="location">The location of the event; links are supported</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous create operation.
|
||||
/// </returns>
|
||||
public Task<RestGuildEvent> CreateEventAsync(
|
||||
string name,
|
||||
DateTimeOffset startTime,
|
||||
GuildScheduledEventType type,
|
||||
GuildScheduledEventPrivacyLevel privacyLevel = GuildScheduledEventPrivacyLevel.Private,
|
||||
string description = null,
|
||||
DateTimeOffset? endTime = null,
|
||||
ulong? channelId = null,
|
||||
string location = null,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
// requirements taken from https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-permissions-requirements
|
||||
switch (type)
|
||||
{
|
||||
case GuildScheduledEventType.Stage:
|
||||
CurrentUser.GuildPermissions.Ensure(GuildPermission.ManageEvents | GuildPermission.ManageChannels | GuildPermission.MuteMembers | GuildPermission.MoveMembers);
|
||||
break;
|
||||
case GuildScheduledEventType.Voice:
|
||||
CurrentUser.GuildPermissions.Ensure(GuildPermission.ManageEvents | GuildPermission.ViewChannel | GuildPermission.Connect);
|
||||
break;
|
||||
case GuildScheduledEventType.External:
|
||||
CurrentUser.GuildPermissions.Ensure(GuildPermission.ManageEvents);
|
||||
break;
|
||||
}
|
||||
|
||||
return GuildHelper.CreateGuildEventAsync(Discord, this, name, privacyLevel, startTime, type, description, endTime, channelId, location, options);
|
||||
}
|
||||
|
||||
|
||||
#endregion
|
||||
|
||||
#region Audit logs
|
||||
/// <summary>
|
||||
/// Gets the specified number of audit log entries for this guild.
|
||||
/// </summary>
|
||||
@@ -951,8 +1339,9 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public IAsyncEnumerable<IReadOnlyCollection<RestAuditLogEntry>> GetAuditLogsAsync(int limit, RequestOptions options = null, ulong? beforeId = null, ulong? userId = null, ActionType? actionType = null)
|
||||
=> GuildHelper.GetAuditLogsAsync(this, Discord, beforeId, limit, options, userId: userId, actionType: actionType);
|
||||
#endregion
|
||||
|
||||
//Webhooks
|
||||
#region Webhooks
|
||||
/// <summary>
|
||||
/// Gets a webhook found within this guild.
|
||||
/// </summary>
|
||||
@@ -974,8 +1363,9 @@ namespace Discord.WebSocket
|
||||
/// </returns>
|
||||
public Task<IReadOnlyCollection<RestWebhook>> GetWebhooksAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetWebhooksAsync(this, Discord, options);
|
||||
#endregion
|
||||
|
||||
//Emotes
|
||||
#region Emotes
|
||||
/// <inheritdoc />
|
||||
public Task<IReadOnlyCollection<GuildEmote>> GetEmotesAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetEmotesAsync(this, Discord, options);
|
||||
@@ -993,7 +1383,154 @@ namespace Discord.WebSocket
|
||||
public Task DeleteEmoteAsync(GuildEmote emote, RequestOptions options = null)
|
||||
=> GuildHelper.DeleteEmoteAsync(this, Discord, emote.Id, options);
|
||||
|
||||
//Voice States
|
||||
/// <summary>
|
||||
/// Moves the user to the voice channel.
|
||||
/// </summary>
|
||||
/// <param name="user">The user to move.</param>
|
||||
/// <param name="targetChannel">the channel where the user gets moved to.</param>
|
||||
/// <returns>A task that represents the asynchronous operation for moving a user.</returns>
|
||||
public Task MoveAsync(IGuildUser user, IVoiceChannel targetChannel)
|
||||
=> user.ModifyAsync(x => x.Channel = new Optional<IVoiceChannel>(targetChannel));
|
||||
|
||||
/// <summary>
|
||||
/// Disconnects the user from its current voice channel
|
||||
/// </summary>
|
||||
/// <param name="user">The user to disconnect.</param>
|
||||
/// <returns>A task that represents the asynchronous operation for disconnecting a user.</returns>
|
||||
async Task IGuild.DisconnectAsync(IGuildUser user) => await user.ModifyAsync(x => x.Channel = new Optional<IVoiceChannel>());
|
||||
#endregion
|
||||
|
||||
#region Stickers
|
||||
/// <summary>
|
||||
/// Gets a specific sticker within this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The id of the sticker to get.</param>
|
||||
/// <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 sticker found with the
|
||||
/// specified <paramref name="id"/>; <see langword="null" /> if none is found.
|
||||
/// </returns>
|
||||
public async ValueTask<SocketCustomSticker> GetStickerAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null)
|
||||
{
|
||||
var sticker = _stickers.FirstOrDefault(x => x.Key == id);
|
||||
|
||||
if (sticker.Value != null)
|
||||
return sticker.Value;
|
||||
|
||||
if (mode == CacheMode.CacheOnly)
|
||||
return null;
|
||||
|
||||
var model = await Discord.ApiClient.GetGuildStickerAsync(Id, id, options).ConfigureAwait(false);
|
||||
|
||||
if (model == null)
|
||||
return null;
|
||||
|
||||
return AddOrUpdateSticker(model);
|
||||
}
|
||||
/// <summary>
|
||||
/// Gets a specific sticker within this guild.
|
||||
/// </summary>
|
||||
/// <param name="id">The id of the sticker to get.</param>
|
||||
/// <returns>A sticker, if none is found then <see langword="null"/>.</returns>
|
||||
public SocketCustomSticker GetSticker(ulong id)
|
||||
=> GetStickerAsync(id, CacheMode.CacheOnly).GetAwaiter().GetResult();
|
||||
/// <summary>
|
||||
/// Gets a collection of all stickers within 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 a read-only collection
|
||||
/// of stickers found within the guild.
|
||||
/// </returns>
|
||||
public async ValueTask<IReadOnlyCollection<SocketCustomSticker>> GetStickersAsync(CacheMode mode = CacheMode.AllowDownload,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
if (Stickers.Count > 0)
|
||||
return Stickers;
|
||||
|
||||
if (mode == CacheMode.CacheOnly)
|
||||
return ImmutableArray.Create<SocketCustomSticker>();
|
||||
|
||||
var models = await Discord.ApiClient.ListGuildStickersAsync(Id, options).ConfigureAwait(false);
|
||||
|
||||
List<SocketCustomSticker> stickers = new();
|
||||
|
||||
foreach (var model in models)
|
||||
{
|
||||
stickers.Add(AddOrUpdateSticker(model));
|
||||
}
|
||||
|
||||
return stickers;
|
||||
}
|
||||
/// <summary>
|
||||
/// Creates a new sticker in this guild.
|
||||
/// </summary>
|
||||
/// <param name="name">The name of the sticker.</param>
|
||||
/// <param name="description">The description of the sticker.</param>
|
||||
/// <param name="tags">The tags of the sticker.</param>
|
||||
/// <param name="image">The image of the new emote.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous creation operation. The task result contains the created sticker.
|
||||
/// </returns>
|
||||
public async Task<SocketCustomSticker> CreateStickerAsync(string name, string description, IEnumerable<string> tags, Image image,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
var model = await GuildHelper.CreateStickerAsync(Discord, this, name, description, tags, image, options).ConfigureAwait(false);
|
||||
|
||||
return AddOrUpdateSticker(model);
|
||||
}
|
||||
/// <summary>
|
||||
/// Creates a new sticker in this guild
|
||||
/// </summary>
|
||||
/// <param name="name">The name of the sticker.</param>
|
||||
/// <param name="description">The description of the sticker.</param>
|
||||
/// <param name="tags">The tags of the sticker.</param>
|
||||
/// <param name="path">The path of the file to upload.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous creation operation. The task result contains the created sticker.
|
||||
/// </returns>
|
||||
public Task<SocketCustomSticker> CreateStickerAsync(string name, string description, IEnumerable<string> tags, string path,
|
||||
RequestOptions options = null)
|
||||
{
|
||||
var fs = File.OpenRead(path);
|
||||
return CreateStickerAsync(name, description, tags, fs, Path.GetFileName(fs.Name), options);
|
||||
}
|
||||
/// <summary>
|
||||
/// Creates a new sticker in this guild
|
||||
/// </summary>
|
||||
/// <param name="name">The name of the sticker.</param>
|
||||
/// <param name="description">The description of the sticker.</param>
|
||||
/// <param name="tags">The tags of the sticker.</param>
|
||||
/// <param name="stream">The stream containing the file data.</param>
|
||||
/// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous creation operation. The task result contains the created sticker.
|
||||
/// </returns>
|
||||
public async Task<SocketCustomSticker> CreateStickerAsync(string name, string description, IEnumerable<string> tags, Stream stream,
|
||||
string filename, RequestOptions options = null)
|
||||
{
|
||||
var model = await GuildHelper.CreateStickerAsync(Discord, this, name, description, tags, stream, filename, options).ConfigureAwait(false);
|
||||
|
||||
return AddOrUpdateSticker(model);
|
||||
}
|
||||
/// <summary>
|
||||
/// Deletes a sticker within this guild.
|
||||
/// </summary>
|
||||
/// <param name="sticker">The sticker to delete.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A task that represents the asynchronous removal operation.
|
||||
/// </returns>
|
||||
public Task DeleteStickerAsync(SocketCustomSticker sticker, RequestOptions options = null)
|
||||
=> sticker.DeleteAsync(options);
|
||||
#endregion
|
||||
|
||||
#region Voice States
|
||||
internal async Task<SocketVoiceState> AddOrUpdateVoiceStateAsync(ClientState state, VoiceStateModel model)
|
||||
{
|
||||
var voiceChannel = state.GetChannel(model.ChannelId.Value) as SocketVoiceChannel;
|
||||
@@ -1037,8 +1574,9 @@ namespace Discord.WebSocket
|
||||
}
|
||||
return null;
|
||||
}
|
||||
#endregion
|
||||
|
||||
//Audio
|
||||
#region Audio
|
||||
internal AudioInStream GetAudioStream(ulong userId)
|
||||
{
|
||||
return _audioClient?.GetInputStream(userId);
|
||||
@@ -1143,7 +1681,7 @@ namespace Discord.WebSocket
|
||||
}
|
||||
internal async Task FinishConnectAudio(string url, string token)
|
||||
{
|
||||
//TODO: Mem Leak: Disconnected/Connected handlers arent cleaned up
|
||||
//TODO: Mem Leak: Disconnected/Connected handlers aren't cleaned up
|
||||
var voiceState = GetVoiceState(Discord.CurrentUser.Id).Value;
|
||||
|
||||
await _audioLock.WaitAsync().ConfigureAwait(false);
|
||||
@@ -1192,8 +1730,9 @@ namespace Discord.WebSocket
|
||||
public override string ToString() => Name;
|
||||
private string DebuggerDisplay => $"{Name} ({Id})";
|
||||
internal SocketGuild Clone() => MemberwiseClone() as SocketGuild;
|
||||
#endregion
|
||||
|
||||
//IGuild
|
||||
#region IGuild
|
||||
/// <inheritdoc />
|
||||
ulong? IGuild.AFKChannelId => AFKChannelId;
|
||||
/// <inheritdoc />
|
||||
@@ -1216,7 +1755,17 @@ namespace Discord.WebSocket
|
||||
int? IGuild.ApproximateMemberCount => null;
|
||||
/// <inheritdoc />
|
||||
int? IGuild.ApproximatePresenceCount => null;
|
||||
|
||||
/// <inheritdoc />
|
||||
IReadOnlyCollection<ICustomSticker> IGuild.Stickers => Stickers;
|
||||
/// <inheritdoc />
|
||||
async Task<IGuildScheduledEvent> IGuild.CreateEventAsync(string name, DateTimeOffset startTime, GuildScheduledEventType type, GuildScheduledEventPrivacyLevel privacyLevel, string description, DateTimeOffset? endTime, ulong? channelId, string location, RequestOptions options)
|
||||
=> await CreateEventAsync(name, startTime, type, privacyLevel, description, endTime, channelId, location, options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<IGuildScheduledEvent> IGuild.GetEventAsync(ulong id, RequestOptions options)
|
||||
=> await GetEventAsync(id, options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<IReadOnlyCollection<IGuildScheduledEvent>> IGuild.GetEventsAsync(RequestOptions options)
|
||||
=> await GetEventsAsync(options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<IReadOnlyCollection<IBan>> IGuild.GetBansAsync(RequestOptions options)
|
||||
=> await GetBansAsync(options).ConfigureAwait(false);
|
||||
@@ -1240,15 +1789,27 @@ namespace Discord.WebSocket
|
||||
Task<ITextChannel> IGuild.GetTextChannelAsync(ulong id, CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<ITextChannel>(GetTextChannel(id));
|
||||
/// <inheritdoc />
|
||||
Task<IThreadChannel> IGuild.GetThreadChannelAsync(ulong id, CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IThreadChannel>(GetThreadChannel(id));
|
||||
/// <inheritdoc />
|
||||
Task<IReadOnlyCollection<IThreadChannel>> IGuild.GetThreadChannelsAsync(CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IReadOnlyCollection<IThreadChannel>>(ThreadChannels);
|
||||
/// <inheritdoc />
|
||||
Task<IReadOnlyCollection<IVoiceChannel>> IGuild.GetVoiceChannelsAsync(CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IReadOnlyCollection<IVoiceChannel>>(VoiceChannels);
|
||||
/// <inheritdoc />
|
||||
Task<IReadOnlyCollection<ICategoryChannel>> IGuild.GetCategoriesAsync(CacheMode mode , RequestOptions options)
|
||||
Task<IReadOnlyCollection<ICategoryChannel>> IGuild.GetCategoriesAsync(CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IReadOnlyCollection<ICategoryChannel>>(CategoryChannels);
|
||||
/// <inheritdoc />
|
||||
Task<IVoiceChannel> IGuild.GetVoiceChannelAsync(ulong id, CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IVoiceChannel>(GetVoiceChannel(id));
|
||||
/// <inheritdoc />
|
||||
Task<IStageChannel> IGuild.GetStageChannelAsync(ulong id, CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IStageChannel>(GetStageChannel(id));
|
||||
/// <inheritdoc />
|
||||
Task<IReadOnlyCollection<IStageChannel>> IGuild.GetStageChannelsAsync(CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IReadOnlyCollection<IStageChannel>>(StageChannels);
|
||||
/// <inheritdoc />
|
||||
Task<IVoiceChannel> IGuild.GetAFKChannelAsync(CacheMode mode, RequestOptions options)
|
||||
=> Task.FromResult<IVoiceChannel>(AFKChannel);
|
||||
/// <inheritdoc />
|
||||
@@ -1273,6 +1834,9 @@ namespace Discord.WebSocket
|
||||
async Task<IVoiceChannel> IGuild.CreateVoiceChannelAsync(string name, Action<VoiceChannelProperties> func, RequestOptions options)
|
||||
=> await CreateVoiceChannelAsync(name, func, options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<IStageChannel> IGuild.CreateStageChannelAsync(string name, Action<VoiceChannelProperties> func, RequestOptions options)
|
||||
=> await CreateStageChannelAsync(name, func, options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<ICategoryChannel> IGuild.CreateCategoryAsync(string name, Action<GuildChannelProperties> func, RequestOptions options)
|
||||
=> await CreateCategoryChannelAsync(name, func, options).ConfigureAwait(false);
|
||||
|
||||
@@ -1350,6 +1914,37 @@ namespace Discord.WebSocket
|
||||
/// <inheritdoc />
|
||||
async Task<IReadOnlyCollection<IWebhook>> IGuild.GetWebhooksAsync(RequestOptions options)
|
||||
=> await GetWebhooksAsync(options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<IReadOnlyCollection<IApplicationCommand>> IGuild.GetApplicationCommandsAsync (RequestOptions options)
|
||||
=> await GetApplicationCommandsAsync(options).ConfigureAwait(false);
|
||||
/// <inheritdoc />
|
||||
async Task<ICustomSticker> IGuild.CreateStickerAsync(string name, string description, IEnumerable<string> tags, Image image, RequestOptions options)
|
||||
=> await CreateStickerAsync(name, description, tags, image, options);
|
||||
/// <inheritdoc />
|
||||
async Task<ICustomSticker> IGuild.CreateStickerAsync(string name, string description, IEnumerable<string> tags, Stream stream, string filename, RequestOptions options)
|
||||
=> await CreateStickerAsync(name, description, tags, stream, filename, options);
|
||||
/// <inheritdoc />
|
||||
async Task<ICustomSticker> IGuild.CreateStickerAsync(string name, string description, IEnumerable<string> tags, string path, RequestOptions options)
|
||||
=> await CreateStickerAsync(name, description, tags, path, options);
|
||||
/// <inheritdoc />
|
||||
async Task<ICustomSticker> IGuild.GetStickerAsync(ulong id, CacheMode mode, RequestOptions options)
|
||||
=> await GetStickerAsync(id, mode, options);
|
||||
/// <inheritdoc />
|
||||
async Task<IReadOnlyCollection<ICustomSticker>> IGuild.GetStickersAsync(CacheMode mode, RequestOptions options)
|
||||
=> await GetStickersAsync(mode, options);
|
||||
/// <inheritdoc />
|
||||
Task IGuild.DeleteStickerAsync(ICustomSticker sticker, RequestOptions options)
|
||||
=> DeleteStickerAsync(_stickers[sticker.Id], options);
|
||||
/// <inheritdoc />
|
||||
async Task<IApplicationCommand> IGuild.GetApplicationCommandAsync(ulong id, CacheMode mode, RequestOptions options)
|
||||
=> await GetApplicationCommandAsync(id, mode, options);
|
||||
/// <inheritdoc />
|
||||
async Task<IApplicationCommand> IGuild.CreateApplicationCommandAsync(ApplicationCommandProperties properties, RequestOptions options)
|
||||
=> await CreateApplicationCommandAsync(properties, options);
|
||||
/// <inheritdoc />
|
||||
async Task<IReadOnlyCollection<IApplicationCommand>> IGuild.BulkOverwriteApplicationCommandsAsync(ApplicationCommandProperties[] properties,
|
||||
RequestOptions options)
|
||||
=> await BulkOverwriteApplicationCommandAsync(properties, options);
|
||||
|
||||
void IDisposable.Dispose()
|
||||
{
|
||||
@@ -1357,5 +1952,6 @@ namespace Discord.WebSocket
|
||||
_audioLock?.Dispose();
|
||||
_audioClient?.Dispose();
|
||||
}
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
|
||||
216
src/Discord.Net.WebSocket/Entities/Guilds/SocketGuildEvent.cs
Normal file
216
src/Discord.Net.WebSocket/Entities/Guilds/SocketGuildEvent.cs
Normal file
@@ -0,0 +1,216 @@
|
||||
using Discord.Rest;
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Collections.Immutable;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.Threading.Tasks;
|
||||
using Model = Discord.API.GuildScheduledEvent;
|
||||
|
||||
namespace Discord.WebSocket
|
||||
{
|
||||
/// <summary>
|
||||
/// Represents a WebSocket-based guild event.
|
||||
/// </summary>
|
||||
public class SocketGuildEvent : SocketEntity<ulong>, IGuildScheduledEvent
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets the guild of the event.
|
||||
/// </summary>
|
||||
public SocketGuild Guild { get; private set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets the channel of the event.
|
||||
/// </summary>
|
||||
public SocketGuildChannel Channel { get; private set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets the user who created the event.
|
||||
/// </summary>
|
||||
public SocketGuildUser Creator { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public string Name { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public string Description { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public DateTimeOffset StartTime { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public DateTimeOffset? EndTime { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public GuildScheduledEventPrivacyLevel PrivacyLevel { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public GuildScheduledEventStatus Status { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public GuildScheduledEventType Type { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public ulong? EntityId { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public string Location { get; private set; }
|
||||
|
||||
/// <inheritdoc/>
|
||||
public int? UserCount { get; private set; }
|
||||
|
||||
internal SocketGuildEvent(DiscordSocketClient client, SocketGuild guild, ulong id)
|
||||
: base(client, id)
|
||||
{
|
||||
Guild = guild;
|
||||
}
|
||||
|
||||
internal static SocketGuildEvent Create(DiscordSocketClient client, SocketGuild guild, Model model)
|
||||
{
|
||||
var entity = new SocketGuildEvent(client, guild, model.Id);
|
||||
entity.Update(model);
|
||||
return entity;
|
||||
}
|
||||
|
||||
internal void Update(Model model)
|
||||
{
|
||||
if (model.ChannelId.IsSpecified && model.ChannelId.Value != null)
|
||||
{
|
||||
Channel = Guild.GetChannel(model.ChannelId.Value.Value);
|
||||
}
|
||||
|
||||
if (model.CreatorId.IsSpecified)
|
||||
{
|
||||
var guildUser = Guild.GetUser(model.CreatorId.Value);
|
||||
|
||||
if(guildUser != null)
|
||||
{
|
||||
if(model.Creator.IsSpecified)
|
||||
guildUser.Update(Discord.State, model.Creator.Value);
|
||||
|
||||
Creator = guildUser;
|
||||
}
|
||||
else if (guildUser == null && model.Creator.IsSpecified)
|
||||
{
|
||||
guildUser = SocketGuildUser.Create(Guild, Discord.State, model.Creator.Value);
|
||||
Creator = guildUser;
|
||||
}
|
||||
}
|
||||
|
||||
Name = model.Name;
|
||||
Description = model.Description.GetValueOrDefault();
|
||||
|
||||
EntityId = model.EntityId;
|
||||
Location = model.EntityMetadata?.Location.GetValueOrDefault();
|
||||
Type = model.EntityType;
|
||||
|
||||
PrivacyLevel = model.PrivacyLevel;
|
||||
EndTime = model.ScheduledEndTime;
|
||||
StartTime = model.ScheduledStartTime;
|
||||
Status = model.Status;
|
||||
UserCount = model.UserCount.ToNullable();
|
||||
}
|
||||
|
||||
/// <inheritdoc/>
|
||||
public Task DeleteAsync(RequestOptions options = null)
|
||||
=> GuildHelper.DeleteEventAsync(Discord, this, options);
|
||||
|
||||
/// <inheritdoc/>
|
||||
public Task StartAsync(RequestOptions options = null)
|
||||
=> ModifyAsync(x => x.Status = GuildScheduledEventStatus.Active);
|
||||
|
||||
/// <inheritdoc/>
|
||||
public Task EndAsync(RequestOptions options = null)
|
||||
=> ModifyAsync(x => x.Status = Status == GuildScheduledEventStatus.Scheduled
|
||||
? GuildScheduledEventStatus.Cancelled
|
||||
: GuildScheduledEventStatus.Completed);
|
||||
|
||||
/// <inheritdoc/>
|
||||
public async Task ModifyAsync(Action<GuildScheduledEventsProperties> func, RequestOptions options = null)
|
||||
{
|
||||
var model = await GuildHelper.ModifyGuildEventAsync(Discord, func, this, options).ConfigureAwait(false);
|
||||
Update(model);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets a collection of users that are interested in this event.
|
||||
/// </summary>
|
||||
/// <param name="limit">The amount of users to fetch.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// A read-only collection of users.
|
||||
/// </returns>
|
||||
public Task<IReadOnlyCollection<RestUser>> GetUsersAsync(int limit = 100, RequestOptions options = null)
|
||||
=> GuildHelper.GetEventUsersAsync(Discord, this, limit, options);
|
||||
|
||||
/// <summary>
|
||||
/// Gets a collection of N users interested in the event.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <note type="important">
|
||||
/// The returned collection is an asynchronous enumerable object; one must call
|
||||
/// <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual messages as a
|
||||
/// collection.
|
||||
/// </note>
|
||||
/// This method will attempt to fetch all users that are interested in the event.
|
||||
/// The library will attempt to split up the requests according to and <see cref="DiscordConfig.MaxGuildEventUsersPerBatch"/>.
|
||||
/// In other words, if there are 300 users, and the <see cref="Discord.DiscordConfig.MaxGuildEventUsersPerBatch"/> constant
|
||||
/// is <c>100</c>, the request will be split into 3 individual requests; thus returning 3 individual asynchronous
|
||||
/// responses, hence the need of flattening.
|
||||
/// </remarks>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// Paged collection of users.
|
||||
/// </returns>
|
||||
public IAsyncEnumerable<IReadOnlyCollection<RestUser>> GetUsersAsync(RequestOptions options = null)
|
||||
=> GuildHelper.GetEventUsersAsync(Discord, this, null, null, options);
|
||||
|
||||
/// <summary>
|
||||
/// Gets a collection of N users interested in the event.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <note type="important">
|
||||
/// The returned collection is an asynchronous enumerable object; one must call
|
||||
/// <see cref="AsyncEnumerableExtensions.FlattenAsync{T}"/> to access the individual users as a
|
||||
/// collection.
|
||||
/// </note>
|
||||
/// <note type="warning">
|
||||
/// Do not fetch too many users at once! This may cause unwanted preemptive rate limit or even actual
|
||||
/// rate limit, causing your bot to freeze!
|
||||
/// </note>
|
||||
/// This method will attempt to fetch the number of users specified under <paramref name="limit"/> around
|
||||
/// the user <paramref name="fromUserId"/> depending on the <paramref name="dir"/>. The library will
|
||||
/// attempt to split up the requests according to your <paramref name="limit"/> and
|
||||
/// <see cref="DiscordConfig.MaxGuildEventUsersPerBatch"/>. In other words, should the user request 500 users,
|
||||
/// and the <see cref="Discord.DiscordConfig.MaxGuildEventUsersPerBatch"/> constant is <c>100</c>, the request will
|
||||
/// be split into 5 individual requests; thus returning 5 individual asynchronous responses, hence the need
|
||||
/// of flattening.
|
||||
/// </remarks>
|
||||
/// <param name="fromUserId">The ID of the starting user to get the users from.</param>
|
||||
/// <param name="dir">The direction of the users to be gotten from.</param>
|
||||
/// <param name="limit">The numbers of users to be gotten from.</param>
|
||||
/// <param name="options">The options to be used when sending the request.</param>
|
||||
/// <returns>
|
||||
/// Paged collection of users.
|
||||
/// </returns>
|
||||
public IAsyncEnumerable<IReadOnlyCollection<RestUser>> GetUsersAsync(ulong fromUserId, Direction dir, int limit = DiscordConfig.MaxGuildEventUsersPerBatch, RequestOptions options = null)
|
||||
=> GuildHelper.GetEventUsersAsync(Discord, this, fromUserId, dir, limit, options);
|
||||
|
||||
#region IGuildScheduledEvent
|
||||
|
||||
/// <inheritdoc/>
|
||||
IAsyncEnumerable<IReadOnlyCollection<IUser>> IGuildScheduledEvent.GetUsersAsync(RequestOptions options)
|
||||
=> GetUsersAsync(options);
|
||||
/// <inheritdoc/>
|
||||
IAsyncEnumerable<IReadOnlyCollection<IUser>> IGuildScheduledEvent.GetUsersAsync(ulong fromUserId, Direction dir, int limit, RequestOptions options)
|
||||
=> GetUsersAsync(fromUserId, dir, limit, options);
|
||||
/// <inheritdoc/>
|
||||
IGuild IGuildScheduledEvent.Guild => Guild;
|
||||
/// <inheritdoc/>
|
||||
IUser IGuildScheduledEvent.Creator => Creator;
|
||||
/// <inheritdoc/>
|
||||
ulong? IGuildScheduledEvent.ChannelId => Channel?.Id;
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user