| @@ -683,6 +683,9 @@ namespace Discord | |||||
| /// <summary> | /// <summary> | ||||
| /// Downloads all users for this guild if the current list is incomplete. | /// Downloads all users for this guild if the current list is incomplete. | ||||
| /// </summary> | /// </summary> | ||||
| /// <remarks> | |||||
| /// This method downloads all users found within this guild throught the Gateway and caches them. | |||||
| /// </remarks> | |||||
| /// <returns> | /// <returns> | ||||
| /// A task that represents the asynchronous download operation. | /// A task that represents the asynchronous download operation. | ||||
| /// </returns> | /// </returns> | ||||
| @@ -57,6 +57,21 @@ namespace Discord | |||||
| /// </returns> | /// </returns> | ||||
| Task UnpinAsync(RequestOptions options = null); | Task UnpinAsync(RequestOptions options = null); | ||||
| /// <summary> | |||||
| /// Publishes (crossposts) this message. | |||||
| /// </summary> | |||||
| /// <param name="options">The options to be used when sending the request.</param> | |||||
| /// <returns> | |||||
| /// A task that represents the asynchronous operation for publishing this message. | |||||
| /// </returns> | |||||
| /// <remarks> | |||||
| /// <note type="warning"> | |||||
| /// This call will throw an <see cref="InvalidOperationException"/> if attempted in a non-news channel. | |||||
| /// </note> | |||||
| /// This method will publish (crosspost) the message. Please note, publishing (crossposting), is only available in news channels. | |||||
| /// </remarks> | |||||
| Task CrosspostAsync(RequestOptions options = null); | |||||
| /// <summary> | /// <summary> | ||||
| /// Transforms this message's text into a human-readable form by resolving its tags. | /// Transforms this message's text into a human-readable form by resolving its tags. | ||||
| /// </summary> | /// </summary> | ||||
| @@ -695,6 +695,15 @@ namespace Discord.API | |||||
| var ids = new BucketIds(channelId: channelId); | var ids = new BucketIds(channelId: channelId); | ||||
| await SendAsync("POST", () => $"channels/{channelId}/typing", ids, options: options).ConfigureAwait(false); | await SendAsync("POST", () => $"channels/{channelId}/typing", ids, options: options).ConfigureAwait(false); | ||||
| } | } | ||||
| public async Task CrosspostAsync(ulong channelId, ulong messageId, RequestOptions options = null) | |||||
| { | |||||
| Preconditions.NotEqual(channelId, 0, nameof(channelId)); | |||||
| Preconditions.NotEqual(messageId, 0, nameof(messageId)); | |||||
| options = RequestOptions.CreateOrClone(options); | |||||
| var ids = new BucketIds(channelId: channelId); | |||||
| await SendAsync("POST", () => $"channels/{channelId}/messages/{messageId}/crosspost", ids, options: options).ConfigureAwait(false); | |||||
| } | |||||
| //Channel Permissions | //Channel Permissions | ||||
| public async Task ModifyChannelPermissionsAsync(ulong channelId, ulong targetId, ModifyChannelPermissionsParams args, RequestOptions options = null) | public async Task ModifyChannelPermissionsAsync(ulong channelId, ulong targetId, ModifyChannelPermissionsParams args, RequestOptions options = null) | ||||
| @@ -44,8 +44,10 @@ namespace Discord.Rest | |||||
| }; | }; | ||||
| return await client.ApiClient.ModifyMessageAsync(msg.Channel.Id, msg.Id, apiArgs, options).ConfigureAwait(false); | return await client.ApiClient.ModifyMessageAsync(msg.Channel.Id, msg.Id, apiArgs, options).ConfigureAwait(false); | ||||
| } | } | ||||
| public static Task DeleteAsync(IMessage msg, BaseDiscordClient client, RequestOptions options) | public static Task DeleteAsync(IMessage msg, BaseDiscordClient client, RequestOptions options) | ||||
| => DeleteAsync(msg.Channel.Id, msg.Id, client, options); | => DeleteAsync(msg.Channel.Id, msg.Id, client, options); | ||||
| public static async Task DeleteAsync(ulong channelId, ulong msgId, BaseDiscordClient client, | public static async Task DeleteAsync(ulong channelId, ulong msgId, BaseDiscordClient client, | ||||
| RequestOptions options) | RequestOptions options) | ||||
| { | { | ||||
| @@ -115,6 +117,7 @@ namespace Discord.Rest | |||||
| { | { | ||||
| await client.ApiClient.AddPinAsync(msg.Channel.Id, msg.Id, options).ConfigureAwait(false); | await client.ApiClient.AddPinAsync(msg.Channel.Id, msg.Id, options).ConfigureAwait(false); | ||||
| } | } | ||||
| public static async Task UnpinAsync(IMessage msg, BaseDiscordClient client, | public static async Task UnpinAsync(IMessage msg, BaseDiscordClient client, | ||||
| RequestOptions options) | RequestOptions options) | ||||
| { | { | ||||
| @@ -240,6 +243,7 @@ namespace Discord.Rest | |||||
| return tags.ToImmutable(); | return tags.ToImmutable(); | ||||
| } | } | ||||
| private static int? FindIndex(IReadOnlyList<ITag> tags, int index) | private static int? FindIndex(IReadOnlyList<ITag> tags, int index) | ||||
| { | { | ||||
| int i = 0; | int i = 0; | ||||
| @@ -253,6 +257,7 @@ namespace Discord.Rest | |||||
| return null; //Overlaps tag before this | return null; //Overlaps tag before this | ||||
| return i; | return i; | ||||
| } | } | ||||
| public static ImmutableArray<ulong> FilterTagsByKey(TagType type, ImmutableArray<ITag> tags) | public static ImmutableArray<ulong> FilterTagsByKey(TagType type, ImmutableArray<ITag> tags) | ||||
| { | { | ||||
| return tags | return tags | ||||
| @@ -260,6 +265,7 @@ namespace Discord.Rest | |||||
| .Select(x => x.Key) | .Select(x => x.Key) | ||||
| .ToImmutableArray(); | .ToImmutableArray(); | ||||
| } | } | ||||
| public static ImmutableArray<T> FilterTagsByValue<T>(TagType type, ImmutableArray<ITag> tags) | public static ImmutableArray<T> FilterTagsByValue<T>(TagType type, ImmutableArray<ITag> tags) | ||||
| { | { | ||||
| return tags | return tags | ||||
| @@ -279,5 +285,14 @@ namespace Discord.Rest | |||||
| return MessageSource.Bot; | return MessageSource.Bot; | ||||
| return MessageSource.User; | return MessageSource.User; | ||||
| } | } | ||||
| public static Task CrosspostAsync(IMessage msg, BaseDiscordClient client, RequestOptions options) | |||||
| => CrosspostAsync(msg.Channel.Id, msg.Id, client, options); | |||||
| public static async Task CrosspostAsync(ulong channelId, ulong msgId, BaseDiscordClient client, | |||||
| RequestOptions options) | |||||
| { | |||||
| await client.ApiClient.CrosspostAsync(channelId, msgId, options).ConfigureAwait(false); | |||||
| } | |||||
| } | } | ||||
| } | } | ||||
| @@ -165,7 +165,7 @@ namespace Discord.Rest | |||||
| IReadOnlyCollection<IEmbed> IMessage.Embeds => Embeds; | IReadOnlyCollection<IEmbed> IMessage.Embeds => Embeds; | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| IReadOnlyCollection<ulong> IMessage.MentionedUserIds => MentionedUsers.Select(x => x.Id).ToImmutableArray(); | IReadOnlyCollection<ulong> IMessage.MentionedUserIds => MentionedUsers.Select(x => x.Id).ToImmutableArray(); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| public IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions => _reactions.ToDictionary(x => x.Emote, x => new ReactionMetadata { ReactionCount = x.Count, IsMe = x.Me }); | public IReadOnlyDictionary<IEmote, ReactionMetadata> Reactions => _reactions.ToDictionary(x => x.Emote, x => new ReactionMetadata { ReactionCount = x.Count, IsMe = x.Me }); | ||||
| @@ -148,6 +148,18 @@ namespace Discord.Rest | |||||
| TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name) | TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name) | ||||
| => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | ||||
| /// <inheritdoc /> | |||||
| /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="RestNewsChannel"/> channel.</exception> | |||||
| public async Task CrosspostAsync(RequestOptions options = null) | |||||
| { | |||||
| if (!(Channel is RestNewsChannel)) | |||||
| { | |||||
| throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels."); | |||||
| } | |||||
| await MessageHelper.CrosspostAsync(this, Discord, options); | |||||
| } | |||||
| private string DebuggerDisplay => $"{Author}: {Content} ({Id}{(Attachments.Count > 0 ? $", {Attachments.Count} Attachments" : "")})"; | private string DebuggerDisplay => $"{Author}: {Content} ({Id}{(Attachments.Count > 0 ? $", {Attachments.Count} Attachments" : "")})"; | ||||
| } | } | ||||
| } | } | ||||
| @@ -1771,17 +1771,7 @@ namespace Discord.WebSocket | |||||
| return guild; | return guild; | ||||
| } | } | ||||
| internal SocketGuild RemoveGuild(ulong id) | internal SocketGuild RemoveGuild(ulong id) | ||||
| { | |||||
| var guild = State.RemoveGuild(id); | |||||
| if (guild != null) | |||||
| { | |||||
| foreach (var _ in guild.Channels) | |||||
| State.RemoveChannel(id); | |||||
| foreach (var user in guild.Users) | |||||
| user.GlobalUser.RemoveRef(this); | |||||
| } | |||||
| return guild; | |||||
| } | |||||
| => State.RemoveGuild(id); | |||||
| /// <exception cref="InvalidOperationException">Unexpected channel type is created.</exception> | /// <exception cref="InvalidOperationException">Unexpected channel type is created.</exception> | ||||
| internal ISocketPrivateChannel AddPrivateChannel(API.Channel model, ClientState state) | internal ISocketPrivateChannel AddPrivateChannel(API.Channel model, ClientState state) | ||||
| @@ -123,7 +123,7 @@ namespace Discord.WebSocket | |||||
| model.Content = text; | model.Content = text; | ||||
| } | } | ||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="InvalidOperationException">Only the author of a message may modify the message.</exception> | /// <exception cref="InvalidOperationException">Only the author of a message may modify the message.</exception> | ||||
| /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception> | /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception> | ||||
| @@ -147,7 +147,19 @@ namespace Discord.WebSocket | |||||
| public string Resolve(TagHandling userHandling = TagHandling.Name, TagHandling channelHandling = TagHandling.Name, | public string Resolve(TagHandling userHandling = TagHandling.Name, TagHandling channelHandling = TagHandling.Name, | ||||
| TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name) | TagHandling roleHandling = TagHandling.Name, TagHandling everyoneHandling = TagHandling.Ignore, TagHandling emojiHandling = TagHandling.Name) | ||||
| => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | => MentionUtils.Resolve(this, 0, userHandling, channelHandling, roleHandling, everyoneHandling, emojiHandling); | ||||
| /// <inheritdoc /> | |||||
| /// <exception cref="InvalidOperationException">This operation may only be called on a <see cref="SocketNewsChannel"/> channel.</exception> | |||||
| public async Task CrosspostAsync(RequestOptions options = null) | |||||
| { | |||||
| if (!(Channel is SocketNewsChannel)) | |||||
| { | |||||
| throw new InvalidOperationException("Publishing (crossposting) is only valid in news channels."); | |||||
| } | |||||
| await MessageHelper.CrosspostAsync(this, Discord, options); | |||||
| } | |||||
| private string DebuggerDisplay => $"{Author}: {Content} ({Id}{(Attachments.Count > 0 ? $", {Attachments.Count} Attachments" : "")})"; | private string DebuggerDisplay => $"{Author}: {Content} ({Id}{(Attachments.Count > 0 ? $", {Attachments.Count} Attachments" : "")})"; | ||||
| internal new SocketUserMessage Clone() => MemberwiseClone() as SocketUserMessage; | internal new SocketUserMessage Clone() => MemberwiseClone() as SocketUserMessage; | ||||
| } | } | ||||
| @@ -44,8 +44,11 @@ namespace Discord.WebSocket | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets mutual guilds shared with this user. | /// Gets mutual guilds shared with this user. | ||||
| /// </summary> | /// </summary> | ||||
| /// <remarks> | |||||
| /// This property will only include guilds in the same <see cref="DiscordSocketClient"/>. | |||||
| /// </remarks> | |||||
| public IReadOnlyCollection<SocketGuild> MutualGuilds | public IReadOnlyCollection<SocketGuild> MutualGuilds | ||||
| => Discord.Guilds.Where(g => g.Users.Any(u => u.Id == Id)).ToImmutableArray(); | |||||
| => Discord.Guilds.Where(g => g.GetUser(Id) != null).ToImmutableArray(); | |||||
| internal SocketUser(DiscordSocketClient discord, ulong id) | internal SocketUser(DiscordSocketClient discord, ulong id) | ||||
| : base(discord, id) | : base(discord, id) | ||||
| @@ -33,7 +33,7 @@ namespace Discord.Webhook | |||||
| : this(webhookUrl, new DiscordRestConfig()) { } | : this(webhookUrl, new DiscordRestConfig()) { } | ||||
| // regex pattern to match webhook urls | // regex pattern to match webhook urls | ||||
| private static Regex WebhookUrlRegex = new Regex(@"^.*discordapp\.com\/api\/webhooks\/([\d]+)\/([a-z0-9_-]+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase); | |||||
| private static Regex WebhookUrlRegex = new Regex(@"^.*(discord|discordapp)\.com\/api\/webhooks\/([\d]+)\/([a-z0-9_-]+)$", RegexOptions.Compiled | RegexOptions.IgnoreCase); | |||||
| /// <summary> Creates a new Webhook Discord client. </summary> | /// <summary> Creates a new Webhook Discord client. </summary> | ||||
| public DiscordWebhookClient(ulong webhookId, string webhookToken, DiscordRestConfig config) | public DiscordWebhookClient(ulong webhookId, string webhookToken, DiscordRestConfig config) | ||||
| @@ -132,13 +132,13 @@ namespace Discord.Webhook | |||||
| if (match != null) | if (match != null) | ||||
| { | { | ||||
| // ensure that the first group is a ulong, set the _webhookId | // ensure that the first group is a ulong, set the _webhookId | ||||
| // 0th group is always the entire match, so start at index 1 | |||||
| if (!(match.Groups[1].Success && ulong.TryParse(match.Groups[1].Value, NumberStyles.None, CultureInfo.InvariantCulture, out webhookId))) | |||||
| // 0th group is always the entire match, and 1 is the domain; so start at index 2 | |||||
| if (!(match.Groups[2].Success && ulong.TryParse(match.Groups[2].Value, NumberStyles.None, CultureInfo.InvariantCulture, out webhookId))) | |||||
| throw ex("The webhook Id could not be parsed."); | throw ex("The webhook Id could not be parsed."); | ||||
| if (!match.Groups[2].Success) | |||||
| if (!match.Groups[3].Success) | |||||
| throw ex("The webhook token could not be parsed."); | throw ex("The webhook token could not be parsed."); | ||||
| webhookToken = match.Groups[2].Value; | |||||
| webhookToken = match.Groups[3].Value; | |||||
| } | } | ||||
| else | else | ||||
| throw ex(); | throw ex(); | ||||