V3 Final merge

CHANGELOG.md

@@ -1,7 +1,98 @@
 # Changelog
 
+## [3.0.0] - 2021-12-13
+
+### Added
+
+- #1767 Add method to clear guild user cache (19a66bf)
+- #1847 Bump API version to 9 (06a64b7)
+- #1848 Remove obsolete sync voice regions methods and properties (ed8e573)
+- #1851 Remove DM cache and fix references (7a201e9)
+- #1860 Remove /users/@me call for socket and rework sharded client a bit (384ad85)
+- #1863 Change GuildMemberUpdate before state to cacheable (c2e87f5)
+- #1879 Add Name property to Teams (c5b4b64)
+- #1896 IVoiceChannel implements IMentionable (3395700)
+- #1943 Handle bidirectional usernames (10afd96)
+- #1948 warn on invalid gateway intents (51e06e9)
+- #1949 default application games (82276e3)
+- #1923 Added Interaction Support (933ea42).
+- #1923 Added Application commands (933ea42).
+- #1923 Added Message Components (933ea42).
+- #1923 Added Thread Channels (933ea42).
+- #1923 Added Stage Channels (933ea42).
+- #1923 Added Guild Events (933ea42).
+- #1923 Revamped Stickers (933ea42).
+- #1923 Added `TimestampTag` (933ea42).
+- #1923 Added `Name` property to teams (933ea42).
+- #1923 Added url validation to embeds (933ea42).
+- #1923 Added `NsfwLevel` to Guilds (933ea42).
+- #1923 Added helpers to `Emoji` for parsing (933ea42).
+- #1923 Added banner and accent color to guild users (933ea42).
+- #1923 Added `RatelimitCallback` to `RequestOptions` (933ea42).
+- #1923 Added `Emoji` to roles (933ea42).
+- #1923 Added `UseInteractionSnowflakeDate` to config (933ea42).
+- #1923 Added checks for gateway intent in some methods. DownloadUsersAsync will throw an exception if you don't have the gateway intent enabled locally now, this will help with the vauge error that was given before (933ea42).
+- #1923 Added SendFilesAsync to channels (933ea42).
+- #1923 Added Attachments property to MessageProperties (933ea42).
+- #1958 Added NET5.0 and NET6.0 builds (aa6bb5e).
+- #1958 Added `Discord.Interactions` (aa6bb5e).
+
+### Fixed
+
+- #1832 Grab correct Uses value for vanity urls (8ed8714)
+- #1849 Remove obsolete methods and properties (70aab6c)
+- #1850 Create DM channel with id and author alone (95bae78)
+- #1853 Fire GuildMemberUpdated without cached user (d176fef)
+- #1854 Gateway events for DMs (a7ff6ce)
+- #1858 MessageUpdated without author (8b29e0f)
+- #1859 Add missing AddRef and related (de7f9b5)
+- #1862 Message update without author (fabe034)
+- #1864 ApiClient.CurrentUser being null (08507c0)
+- #1871 Add empty role list if not present (f47001a)
+- #1872 Connection deadlock when trying to Send and Disconnect (97d90b9)
+- #1873 Remove OperationCanceledException handling in connecting logic (7cf8499)
+- #1876 Message type (ac52a11)
+- #1877 Rest message type (22bb1b0)
+- #1886 Change embed description max length to 4096 (8349cd7)
+- #1890 Add default avatar to WithAuthor extension (c200861)
+
+### Misc
+
+- #20 Update EmbedBuilder.Overwrites.md (76a878a)
+- #21 Fix line about PriorityAttribute (75b74e1)
+- #1152 Add characters commonly use in links to Sanitize (b9274d1)
+- #1518 Add default nullable enum typereader (f7a07ae)
+- #1666 Added negative TimeSpan handling (6abdfcb)
+- #1852 Internal change to GetOrCreateUser (dfaaa21)
+- #1861 Add MaxBitrate to the interface (e0dbe7c)
+- #1865 Add null check to AllowedMentions.ToModel() (3cb662f)
+- #1923 Merge Labs 3.X into dev (933ea42)
+- #1941 Fix emoto try parse (900c1f4)
+- #1942 Implement multi-file upload to webhooks (bc440ab)
+- #1944 Add Voice binaries (b5c150d)
+- #1945 Update socket presence and add new presence event (9d6dc62)
+- #1946 fix NRE when adding parameters thru builders (143ca6d)
+- #1947 fix sharded client current user (d5f5ae1)
+- #1950 Add custom setter to Group property of ModuleBuilder to automatically invoke AddAliases (ba656e9)
+- #1958 Update from Discord .Net Labs 3.4.8 (aa6bb5e)
+- #1959 Update isRequired (98b03be)
+- Add `MatchResult` (d1b31c8)
+- Add requested changes (a92ec56)
+- Fix incorrect casing on `HandleCommandPipeline` (adf3a9c)
+- Merge branch 'commands/validate-get-best-match' of https://github.com/siscodeorg/Discord.Net into siscodeorg-commands/validate-get-best-match (3cd9f39)
+- Merge branch 'siscodeorg-commands/validate-get-best-match' into dev (4f1fe2b)
+- Remove docs build from azure pipelines (2336b98)
+- use async main (125f6c7)
+- #1923 Made `Hierarchy` a `IGuildUser` property.
+- #1923 Changed embed discription length to 4096 (933ea42).
+- #1923 Fixed gateway serialization to include nulls for API v9 (933ea42).
+- #1923 Removed error log for gateway reconnects (933ea42).
+- #1966 Updated docs.
+
 ## [2.4.0] - 2021-05-22
+
 ### Added
+
 - #1726 Add stickers (91a9063)
 - #1753 Webhook message edit & delete functionality (f67cd8e)
 - #1757 Add ability to add/remove roles by id (4c9910c)
@@ -12,15 +103,19 @@
 - #1844 Add Discord Certified Moderator user flag (4b8d444)
 
 ### Fixed
+
 - #1486 Add type reader when entity type reader exists (c46daaa)
 - #1835 Cached message emoji cleanup at MESSAGE_REACTION_REMOVE_EMOJI (8afef82)
 
 ### Misc
+
 - #1778 Remove URI check from EmbedBuilder (25b04c4)
 - #1800 Fix spelling in SnowflakeUtils.FromSnowflake (6aff419)
 
 ## [2.3.1] - 2021-03-10
+
 ### Fixed
+
 - #1761 Deadlock in DiscordShardedClient when Ready is never received (73e5cc2)
 - #1773 Private methods aren't added as commands (0fc713a)
 - #1780 NullReferenceException in pin/unpin audit logs (f794163)
@@ -29,10 +124,13 @@
 - #1794 Audit log UserId can be null (d41aeee)
 
 ### Misc
+
 - #1774 Add remark regarding CustomStatus as the activity (51b7afe)
 
 ## [2.3.0] - 2021-01-28
+
 ### Added
+
 - #1491 Add INVITE_CREATE and INVITE_DELETE events (1ab670b)
 - #1520 Support reading multiple activities (421a0c1)
 - #1521 Allow for inherited commands in modules (a51cdf6)
@@ -57,6 +155,7 @@
 - #1690 Add max bitrate value to SocketGuild (aacfea0)
 
 ### Fixed
+
 - #1244 Missing AddReactions permission for DM channels. (e40ca4a)
 - #1469 unsupported property causes an exception (468f826)
 - #1525 AllowedMentions and AllowedMentionTypes (3325031)
@@ -99,6 +198,7 @@
 - Missing MessageReference when sending files (2095701)
 
 ### Misc
+
 - #1545 MutualGuilds optimization (323a677)
 - #1551 Update webhook regex to support discord.com (7585789)
 - #1556 Add SearchUsersAsync (57880de)
@@ -123,7 +223,9 @@
 - Move bulk deletes remarks from <summary> to <remarks> (62539f0)
 
 ## [2.2.0] - 2020-04-16
+
 ### Added
+
 - #1247 Implement Client Status Support (9da11b4)
 - #1310 id overload for RemoveReactionAsync (c88b1da)
 - #1319 BOOST (faf23de)
@@ -146,6 +248,7 @@
 - suppress messages (cd28892)
 
 ### Fixed
+
 - #1318 #1314 Don't parse tags within code blocks (c977f2e)
 - #1333 Remove null coalescing on ToEmbedBuilder Color (120c0f7)
 - #1337 Fixed attempting to access a non-present optional value (4edda5b)
@@ -161,11 +264,13 @@
 - include MessageFlags and SuppressEmbedParams (d6d4429)
 
 ### Changed
+
 - #1368 Update ISystemMessage interface to allow reactions (07f4d5f)
 - #1417 fix #1415 Re-add support for overwrite permissions for news channels (e627f07)
 - use millisecond precision by default (bcb3534)
 
 ### Misc
+
 - #1290 Split Unit and Integration tests into separate projects (a797be9)
 - #1328 Fix #1327 Color.ToString returns wrong value (1e8aa08)
 - #1329 Fix invalid cref values in docs (363d1c6)
@@ -190,14 +295,16 @@
 - 2.2.0 (4b602b4)
 - target the Process env-var scope (3c6b376)
 - fix metapackage build (1794f95)
-- copy only _site to docs-static (a8cdadc)
+- copy only \_site to docs-static (a8cdadc)
 - do not exit on failed robocopy (fd204ee)
 - add idn debugger (91aec9f)
 - rename IsStream to IsStreaming (dcd9cdd)
 - feature (40844b9)
 
 ## [2.1.1] - 2019-06-08
+
 ### Fixed
+
 - #994: Remainder parameters now ignore character escaping, as there is no reason to escape characters here (2e95c49)
 - #1316: `Emote.Equals` now pays no respect to the Name property, since Discord's API does not care about an emote's name (abf3e90)
 - #1317: `Emote.GetHashCode` now pays no respect to the Name property, see above (1b54883)
@@ -206,16 +313,20 @@
 - News embeds will be processed as `EmbedType.Unknown`, rather than throwing an error and dropping the message (d287ed1)
 
 ### Changed
+
 - #1311: Members may now be disconnected from voice channels by passing `null` as `GuildUserProperties.Channel` (fc48c66)
 - #1313: `IMessage.Tags` now includes the EveryoneRole on @everyone and @here mentions (1f55f01)
 - #1320: The maximum value for setting slow-mode has been updated to 6 hours, per the new API limit (4433ca7)
 
 ### Misc
+
 - This library's compatibility with Semantic Versioning has been clarified. Please see the README (4d7de17)
 - The depency on System.Interactive.Async has been bumped to `3.2.0` (3e65e03)
 
 ## [2.1.0] - 2019-05-18
+
 ### Added
+
 - #1236: Bulk deletes (for messages) may now be accessed via the `MessagesBulkDeleted` event (dec353e)
 - #1240: OAuth applications utilizing the `guilds.join` scope may now add users to guilds through any client (1356ea9)
 - #1255: Message and attachment spoilers may now be set or detected (f3b20b2)
@@ -227,9 +338,11 @@
 - `ExclusiveBulkDelete` configuration setting can be used to control bulk delete event behavior (03e6401)
 
 ### Removed
+
 - #1294: The `IGuildUser` overload of `EmbedBuilder.WithAuthor` no longer exists (b52b54d)
 
 ### Fixed
+
 - #1256: Fetching audit logs no longer raises null reference exceptions when a webhook has been deleted (049b014)
 - #1268: Null reference exceptions on `MESSAGE_CREATE` concerning partial member objects no longer occur (377622b)
 - #1278: The token validator now internally pads tokens to the proper length (48b327b)
@@ -238,9 +351,11 @@
 - Exceptions in event handlers are now always logged (f6e3200)
 
 ### Changed
+
 - #1305: Token validation will fail when tokens contain whitespace (bb61efa)
 
 ### Misc
+
 - #1241: Added documentation samples for Webhooks (655a006)
 - #1243: Happy new year 🎉 (0275f7d)
 - #1257: Improved clarity in comments in the command samples (2473619)
@@ -251,16 +366,20 @@
 - IDisposableAnalyzers should now be a development dependency (8003ac8)
 
 ## [2.0.1] - 2019-01-04
+
 ### Fixed
+
 - #1226: Only escape the closing quotation mark of non-remainder strings (65b8c09)
 - Commands with async RunModes will now propagate exceptions up to CommandExecuted (497918e)
 
 ### Misc
+
 - #1225: Commands sample no longer hooks the log event twice (552f34c)
 - #1227: The logo on the docs index page should scale responsively (d39bf6e)
 - #1230: Replaced precondition sample on docs (feed4fd)
 
 ## [2.0.0] - 2018-12-28
+
 ### Added
 
 - #747: `CommandService` now has a `CommandExecuted` event (e991715)
@@ -316,6 +435,7 @@
 - Reactions can now be added to messages in bulk (5421df1)
 
 ### Fixed
+
 - #742: `DiscordShardedClient#GetGuildFor` will now direct null guilds to Shard 0 (d5e9d6f)
 - #743: Various issues with permissions and inheritance of permissions (f996338)
 - #755: `IRole.Mention` will correctly tag the @everyone role (6b5a6e7)
@@ -363,6 +483,7 @@
 - The default WebSocket will now close correctly (ac389f5)
 
 ### Changed
+
 - #731: `IUserMessage#GetReactionUsersAsync` now takes an `IEmote` instead of a `string` (5d7f2fc)
 - #744: IAsyncEnumerable has been redesigned (5bbd9bb)
 - #777: `IGuild#DefaultChannel` will now resolve the first accessible channel, per changes to Discord (1ffcd4b)
@@ -397,14 +518,15 @@
 - The socket client will now use additional fields to fill in member/guild information on messages (8fb2c71)
 - The Audio Client now uses Voice WS v3 (9ba38d7)
 
-
 ### Removed
+
 - #790: Redundant overloads for `AddField` removed from EmbedBuilder (479361b)
 - #925: RPC is no longer being maintained nor packaged (b30af57)
 - #958: Remove support for user tokens (2fd4f56)
 - User logins (including selfbots) are no longer supported (fc5adca)
 
 ### Misc
+
 - #786: Unit tests for the Color structure (22b969c)
 - #828: We now include a contributing guide (cd82a0f)
 - #876: We now include a standard editorconfig (5c8c784)
@@ -425,11 +547,13 @@
 - Fixed documentation layout for the logo (bafdce4)
 
 ## [1.0.2] - 2017-09-09
+
 ### Fixed
 
 - Guilds utilizing Channel Categories will no longer crash bots on the `READY` event.
 
 ## [1.0.1] - 2017-07-05
+
 ### Fixed
 
 - #732: Fixed parameter preconditions not being loaded from class-based modules (b6dcc9e)
@@ -438,4 +562,5 @@
 - Fixed module auto-detection for nested modules (d2afb06)
 
 ### Changed
+
 - ShardedCommandContext now inherits from SocketCommandContext (8cd99be)

CONTRIBUTING.md

@@ -17,7 +17,7 @@ any member of the community.
 
 We prefer pull-requests that are descriptive of the changes being made
 and highlight any potential benefits/drawbacks of the change, but these
-types of write-ups are not required. See this [merge request](https://github.com/RogueException/Discord.Net/pull/793)
+types of write-ups are not required. See this [merge request](https://github.com/discord-net/Discord.Net/pull/793)
 for an example of a well-written description.
 
 ## Semantic Versioning
@@ -28,7 +28,7 @@ that are SemVer compliant with the latest version of the library in
 development.
 
 The working release should be the latest build off of the `dev` branch,
-but can also be found on the [development board](https://github.com/RogueException/Discord.Net/projects/1).
+but can also be found on the [development board](https://github.com/discord-net/Discord.Net/projects/1).
 
 We follow the .NET Foundation's [Breaking Change Rules](https://github.com/dotnet/corefx/blob/master/Documentation/coding-guidelines/breaking-change-rules.md)
 when determining the SemVer compliance of a change.
@@ -59,4 +59,4 @@ The length of the documentation should also follow the ruler as suggested by our
 #### Recommended Reads
 
 * [Official Microsoft Documentation](https://docs.microsoft.com)
-* [Sandcastle User Manual](https://ewsoftware.github.io/XMLCommentsGuide/html/4268757F-CE8D-4E6D-8502-4F7F2E22DDA3.htm)
+* [Sandcastle User Manual](https://ewsoftware.github.io/XMLCommentsGuide/html/4268757F-CE8D-4E6D-8502-4F7F2E22DDA3.htm)

README.md

@@ -31,6 +31,10 @@ The individual components may also be installed from NuGet:
 
 Nightly builds are available through our MyGet feed (`https://www.myget.org/F/discord-net/api/v3/index.json`).
 
+### Unstable (Labs)
+
+Labs builds are avaiable on nuget (`https://www.nuget.org/packages/Discord.Net.Labs/`) and myget (`https://www.myget.org/F/discord-net-labs/api/v3/index.json`).
+
 ## Compiling
 
 In order to compile Discord.Net, you require the following:

docs/_overwrites/Commands/ICommandContext.Inclusion.md

@@ -1,5 +1,5 @@
 An example of how this class is used the command system can be seen 
 below:
 
-[!code[Sample module](../../guides/commands/samples/intro/empty-module.cs)]
-[!code[Command handler](../../guides/commands/samples/intro/command_handler.cs)]
+[!code[Sample module](../../guides/text_commands/samples/intro/empty-module.cs)]
+[!code[Command handler](../../guides/text_commands/samples/intro/command_handler.cs)]

docs/_template/description-generator/plugins/LICENSE

@@ -19,3 +19,11 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+==============================================================================
+
+Humanizer (https://github.com/Humanizr/Humanizer)
+The MIT License (MIT)
+Copyright (c) .NET Foundation and Contributors
+
+==============================================================================

docs/_template/last-modified/plugins/LibGit2Sharp.dll.config

@@ -1,4 +1,4 @@
 <configuration>
-    <dllmap os="linux" cpu="x86-64" wordsize="64" dll="git2-ef5a385" target="lib/linux-x64/libgit2-ef5a385.so" />
-    <dllmap os="osx" cpu="x86,x86-64" dll="git2-ef5a385" target="lib/osx/libgit2-ef5a385.dylib" />
+    <dllmap os="linux" cpu="x86-64" wordsize="64" dll="git2-6777db8" target="lib/linux-x64/libgit2-6777db8.so" />
+    <dllmap os="osx" cpu="x86,x86-64" dll="git2-6777db8" target="lib/osx/libgit2-6777db8.dylib" />
 </configuration>

docs/_template/light-dark-theme/partials/head.tmpl.partial

@@ -10,7 +10,7 @@
   <meta property="og:locale" content="en-us">
   <meta property="og:type" content="website">
   <meta property="og:site_name" content="Discord.Net Docs">
-  <meta property="og:image" content="https://cdn.jsdelivr.net/gh/discord-net/Discord.Net/docs/marketing/logo/PackageLogo.png">
+  <meta property="og:image" content="https://raw.githubusercontent.com/Discord-Net/Discord.Net/dev/docs/marketing/logo/PackageLogo.png">
   <meta property="og:image:alt" content="Discord.Net Logo">
   <meta name="theme-color" content="#995EA7"/>
   <meta name="generator" content="docfx {{_docfxVersion}}">