Initial release

Entities/DiscordConnection.cs

@@ -0,0 +1,48 @@
+using Newtonsoft.Json;
+
+namespace x3rt.DiscordOAuth2.Entities;
+
+public class DiscordConnection
+{
+    [JsonProperty("id")] public string Id { get; set; }
+    [JsonProperty("name")] public string Name { get; set; }
+    [JsonProperty("type")] public ConnectionType Type { get; set; }
+    [JsonProperty("revoked")] public bool? Revoked { get; set; }
+    [JsonProperty("integrations")] public object[] Integrations { get; set; }
+    [JsonProperty("verified")] public bool? Verified { get; set; }
+    [JsonProperty("friend_sync")] public bool? FriendSync { get; set; }
+    [JsonProperty("show_activity")] public bool? ShowActivity { get; set; }
+    [JsonProperty("two_way_link")] public bool? TwoWayLink { get; set; }
+    [JsonProperty("visibility")] public ConnectionVisibility? Visibility { get; set; }
+
+
+    public enum ConnectionVisibility
+    {
+        None,
+        Everyone
+    }
+
+
+    public enum ConnectionType
+    {
+        BattleNet,
+        Ebay,
+        EpicGames,
+        Facebook,
+        GitHub,
+        Instagram,
+        LeagueOfLegends,
+        PayPal,
+        PlayStation,
+        Reddit,
+        RiotGames,
+        Spotify,
+        Skype,
+        Steam,
+        TikTok,
+        Twitch,
+        Twitter,
+        Xbox,
+        YouTube
+    }
+}

Entities/DiscordGuild.cs

@@ -0,0 +1,24 @@
+using Newtonsoft.Json;
+
+namespace x3rt.DiscordOAuth2.Entities;
+
+public class DiscordGuild
+{
+    [JsonProperty("id")] public ulong Id { get; set; }
+
+    [JsonProperty("name")] public string Name { get; set; }
+
+    [JsonProperty("icon")] public string? Icon { get; set; }
+
+    [JsonProperty("owner")] public bool Owner { get; set; }
+
+    [JsonProperty("permissions")] public string Permissions { get; set; }
+
+    [JsonProperty("features")] public GuildFeatures Features { get; set; }
+
+    public override string ToString()
+    {
+        return
+            $"Id: {Id}; Name: {Name}; Icon: {Icon}; Owner: {Owner}; Permissions: {Permissions}; Features: {Features}";
+    }
+}

Entities/DiscordUser.cs

@@ -0,0 +1,38 @@
+using x3rt.DiscordOAuth2.Entities.Enums;
+
+namespace x3rt.DiscordOAuth2.Entities;
+
+public class DiscordUser
+{
+    public ulong Id { get; set; }
+    public string Username { get; set; }
+    public string Discriminator { get; set; }
+    public string? Avatar { get; set; }
+    public bool? Bot { get; set; }
+    public bool? System { get; set; }
+    public bool? MfaEnabled { get; set; }
+    public string? Banner { get; set; }
+    public int? AccentColor { get; set; }
+    public string? Locale { get; set; }
+    public bool? Verified { get; set; }
+    public string? Email { get; set; }
+    public UserFlag? Flags { get; set; }
+    public PremiumType? PremiumType { get; set; }
+    public UserFlag? PublicFlags { get; set; }
+
+    public override string ToString()
+    {
+        string result = "";
+        foreach (var property in GetType().GetProperties())
+        {
+            var value = property.GetValue(this);
+            if (value is not null)
+            {
+                result += $"{property.Name}: {value}; ";
+            }
+        }
+
+        result = result.TrimEnd(' ', ';');
+        return result;
+    }
+}

Entities/Enums/GuildFeature.cs

@@ -0,0 +1,266 @@
+namespace x3rt.DiscordOAuth2.Entities.Enums;
+
+[Flags]
+// Credit: Discord.Net
+public enum GuildFeature : long
+{
+    /// <summary>
+    ///     The guild has no features.
+    /// </summary>
+    None = 0L,
+
+    /// <summary>
+    ///     The guild has access to animated banners.
+    /// </summary>
+    AnimatedBanner = 1L << 0,
+
+    /// <summary>
+    ///     The guild has access to set an animated guild icon.
+    /// </summary>
+    AnimatedIcon = 1L << 1,
+
+    /// <summary>
+    ///     The guild has access to set a guild banner image.
+    /// </summary>
+    Banner = 1L << 2,
+
+    /// <summary>
+    ///     The guild has access to channel banners.
+    /// </summary>
+    ChannelBanner = 1L << 3,
+
+    /// <summary>
+    ///     The guild has access to use commerce features (i.e. create store channels).
+    /// </summary>
+    Commerce = 1L << 4,
+
+    /// <summary>
+    ///     The guild can enable welcome screen, Membership Screening, stage channels and discovery, and receives community updates.
+    /// </summary>
+    /// <remarks>
+    ///     This feature is mutable.
+    /// </remarks>
+    Community = 1L << 5,
+
+    /// <summary>
+    ///     The guild is able to be discovered in the directory.
+    /// </summary>
+    /// <remarks>
+    ///     This feature is mutable.
+    /// </remarks>
+    Discoverable = 1L << 6,
+
+    /// <summary>
+    ///     The guild has discoverable disabled.
+    /// </summary>
+    DiscoverableDisabled = 1L << 7,
+
+    /// <summary>
+    ///     The guild has enabled discoverable before.
+    /// </summary>
+    EnabledDiscoverableBefore = 1L << 8,
+
+    /// <summary>
+    ///     The guild is able to be featured in the directory.
+    /// </summary>
+    Featureable = 1L << 9,
+
+    /// <summary>
+    ///     The guild has a force relay.
+    /// </summary>
+    ForceRelay = 1L << 10,
+
+    /// <summary>
+    ///     The guild has a directory entry.
+    /// </summary>
+    HasDirectoryEntry = 1L << 11,
+
+    /// <summary>
+    ///     The guild is a hub.
+    /// </summary>
+    Hub = 1L << 12,
+
+    /// <summary>
+    ///     You shouldn't be here...
+    /// </summary>
+    InternalEmployeeOnly = 1L << 13,
+
+    /// <summary>
+    ///     The guild has access to set an invite splash background.
+    /// </summary>
+    InviteSplash = 1L << 14,
+
+    /// <summary>
+    ///     The guild is linked to a hub.
+    /// </summary>
+    LinkedToHub = 1L << 15,
+
+    /// <summary>
+    ///     The guild has member profiles.
+    /// </summary>
+    MemberProfiles = 1L << 16,
+
+    /// <summary>
+    ///     The guild has enabled <seealso href="https://discord.com/developers/docs/resources/guild#membership-screening-object">Membership Screening</seealso>.
+    /// </summary>
+    MemberVerificationGateEnabled = 1L << 17,
+
+    /// <summary>
+    ///     The guild has enabled monetization.
+    /// </summary>
+    MonetizationEnabled = 1L << 18,
+
+    /// <summary>
+    ///     The guild has more emojis.
+    /// </summary>
+    MoreEmoji = 1L << 19,
+
+    /// <summary>
+    ///     The guild has increased custom sticker slots.
+    /// </summary>
+    MoreStickers = 1L << 20,
+
+    /// <summary>
+    ///     The guild has access to create news channels.
+    /// </summary>
+    News = 1L << 21,
+
+    /// <summary>
+    ///     The guild has new thread permissions.
+    /// </summary>
+    NewThreadPermissions = 1L << 22,
+
+    /// <summary>
+    ///     The guild is partnered.
+    /// </summary>
+    Partnered = 1L << 23,
+
+    /// <summary>
+    ///     The guild has a premium tier three override; guilds made by Discord usually have this.
+    /// </summary>
+    PremiumTier3Override = 1L << 24,
+
+    /// <summary>
+    ///     The guild can be previewed before joining via Membership Screening or the directory.
+    /// </summary>
+    PreviewEnabled = 1L << 25,
+
+    /// <summary>
+    ///     The guild has access to create private threads.
+    /// </summary>
+    PrivateThreads = 1L << 26,
+
+    /// <summary>
+    ///     The guild has relay enabled.
+    /// </summary>
+    RelayEnabled = 1L << 27,
+
+    /// <summary>
+    ///     The guild is able to set role icons.
+    /// </summary>
+    RoleIcons = 1L << 28,
+
+    /// <summary>
+    ///     The guild has role subscriptions available for purchase.
+    /// </summary>
+    RoleSubscriptionsAvailableForPurchase = 1L << 29,
+
+    /// <summary>
+    ///     The guild has role subscriptions enabled.
+    /// </summary>
+    RoleSubscriptionsEnabled = 1L << 30,
+
+    /// <summary>
+    ///     The guild has access to the seven day archive time for threads.
+    /// </summary>
+    SevenDayThreadArchive = 1L << 31,
+
+    /// <summary>
+    ///     The guild has text in voice enabled.
+    /// </summary>
+    TextInVoiceEnabled = 1L << 32,
+
+    /// <summary>
+    ///     The guild has threads enabled.
+    /// </summary>
+    ThreadsEnabled = 1L << 33,
+
+    /// <summary>
+    ///     The guild has testing threads enabled.
+    /// </summary>
+    ThreadsEnabledTesting = 1L << 34,
+
+    /// <summary>
+    ///     The guild has the default thread auto archive.
+    /// </summary>
+    ThreadsDefaultAutoArchiveDuration = 1L << 35,
+
+    /// <summary>
+    ///     The guild has access to the three day archive time for threads.
+    /// </summary>
+    ThreeDayThreadArchive = 1L << 36,
+
+    /// <summary>
+    ///     The guild has enabled ticketed events.
+    /// </summary>
+    TicketedEventsEnabled = 1L << 37,
+
+    /// <summary>
+    ///     The guild has access to set a vanity URL.
+    /// </summary>
+    VanityUrl = 1L << 38,
+
+    /// <summary>
+    ///     The guild is verified.
+    /// </summary>
+    Verified = 1L << 39,
+
+    /// <summary>
+    ///     The guild has access to set 384kbps bitrate in voice (previously VIP voice servers).
+    /// </summary>
+    VIPRegions = 1L << 40,
+
+    /// <summary>
+    ///     The guild has enabled the welcome screen.
+    /// </summary>
+    WelcomeScreenEnabled = 1L << 41,
+
+    /// <summary>
+    ///     The guild has been set as a support server on the App Directory.
+    /// </summary>
+    DeveloperSupportServer = 1L << 42,
+
+    /// <summary>
+    ///     The guild has invites disabled.
+    /// </summary>
+    /// <remarks>
+    ///     This feature is mutable.
+    /// </remarks>
+    InvitesDisabled = 1L << 43,
+
+    /// <summary>
+    ///     The guild has auto moderation enabled.
+    /// </summary>
+    AutoModeration = 1L << 44,
+
+    /// <summary>
+    ///     This guild has alerts for join raids disabled.
+    /// </summary>
+    /// <remarks>
+    ///     This feature is mutable.
+    /// </remarks>
+    RaidAlertsDisabled = 1L << 45,
+
+    /// <summary>
+    ///     This guild has Clyde AI enabled.
+    /// </summary>
+    /// <remarks>
+    ///     This feature is mutable.
+    /// </remarks>
+    ClydeEnabled = 1L << 46,
+
+    /// <summary>
+    ///     This guild has a guild web page vanity url.
+    /// </summary>
+    GuildWebPageVanityUrl = 1L << 47
+}

Entities/Enums/OAuthScope.cs

@@ -0,0 +1,134 @@
+namespace x3rt.DiscordOAuth2.Entities.Enums;
+
+/// <summary>
+/// Represents the OAuth2 scopes available for a Discord application.
+/// <a href="https://github.com/DSharpPlus/DSharpPlus/blob/e62b2cc3e434b744ef3cf14929f506c21be4d0d4/DSharpPlus/Entities/Application/DiscordApplication.cs#L442">
+///     <br></br>
+///     Credit to DSharpPlus
+/// </a>
+/// </summary>
+public enum OAuthScope
+{
+    /// <summary>
+    /// Allows <c>/users/@me</c> without <c>email</c>.
+    /// </summary>
+    Identify,
+
+    /// <summary>
+    /// Enables <c>/users/@me</c> to return <c>email</c>.
+    /// </summary>
+    Email,
+
+    /// <summary>
+    /// Allows <c>/users/@me/connections</c> to return linked third-party accounts.
+    /// </summary>
+    Connections,
+
+    /// <summary>
+    /// Allows <c>/users/@me/guilds</c> to return basic information about all of a user's guilds.
+    /// </summary>
+    Guilds,
+
+    /// <summary>
+    /// Allows <c>/guilds/{guild.id}/members/{user.id}</c> to be used for joining users into a guild.
+    /// </summary>
+    GuildsJoin,
+
+    /// <summary>
+    /// Allows <c>/users/@me/guilds/{guild.id}/members</c> to return a user's member information in a guild.
+    /// </summary>
+    GuildsMembersRead,
+
+    /// <summary>Allows your app to join users into a group DM.</summary>
+    GdmJoin,
+
+    /// <summary>
+    /// For local RPC server access, this allows you to control a user's local Discord client.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    Rpc,
+
+    /// <summary>
+    /// For local RPC server access, this allows you to receive notifications pushed to the user.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    RpcNotificationsRead,
+
+    /// <summary>
+    /// For local RPC server access, this allows you to read a user's voice settings and listen for voice events.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    RpcVoiceRead,
+
+    /// <summary>
+    /// For local RPC server access, this allows you to update a user's voice settings.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    RpcVoiceWrite,
+
+    /// <summary>
+    /// For local RPC server access, this allows you to update a user's activity.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    RpcActivitiesWrite,
+
+    /// <summary>
+    /// For OAuth2 bots, this puts the bot in the user's selected guild by default.
+    /// </summary>
+    Bot,
+
+    /// <summary>
+    /// This generates a webhook that is returned in the OAuth token response for authorization code grants.
+    /// </summary>
+    WebhookIncoming,
+
+    /// <summary>
+    /// For local RPC server access, this allows you to read messages from all client channels
+    /// (otherwise restricted to channels/guilds your application creates).
+    /// </summary>
+    MessagesRead,
+
+    /// <summary>
+    /// Allows your application to upload/update builds for a user's applications.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    ApplicationsBuildsUpload,
+
+    /// <summary>
+    /// Allows your application to read build data for a user's applications.
+    /// </summary>
+    ApplicationsBuildsRead,
+
+    /// <summary>
+    /// Allows your application to use application commands in a guild.
+    /// </summary>
+    ApplicationsCommands,
+
+    /// <summary>
+    /// Allows your application to read and update store data (SKUs, store listings, achievements etc.) for a user's applications.
+    /// </summary>
+    ApplicationsStoreUpdate,
+
+    /// <summary>
+    /// Allows your application to read entitlements for a user's applications.
+    /// </summary>
+    ApplicationsEntitlements,
+
+    /// <summary>
+    /// Allows your application to fetch data from a user's "Now Playing/Recently Played" list.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    ActivitiesRead,
+
+    /// <summary>Allows your application to update a user's activity.</summary>
+    /// <remarks>
+    /// Outside of the GameSDK activity manager, this scope requires Discord approval.
+    /// </remarks>
+    ActivitiesWrite,
+
+    /// <summary>
+    /// Allows your application to know a user's friends and implicit relationships.
+    /// </summary>
+    /// <remarks>This scope requires Discord approval.</remarks>
+    RelationshipsRead,
+}

Entities/Enums/PremiumType.cs

@@ -0,0 +1,9 @@
+namespace x3rt.DiscordOAuth2.Entities.Enums;
+
+public enum PremiumType
+{
+    None = 0,
+    NitroClassic = 1,
+    Nitro = 2,
+    NitroBasic = 3
+}

Entities/Enums/UserFlag.cs

@@ -0,0 +1,21 @@
+namespace x3rt.DiscordOAuth2.Entities.Enums;
+
+[Flags]
+public enum UserFlag : ulong
+{
+    Staff = 1 << 0,
+    Partner = 1 << 1,
+    HypeSquad = 1 << 2,
+    BugHunterLevel1 = 1 << 3,
+    HouseBraveryMember = 1 << 6,
+    HouseBrillianceMember = 1 << 7,
+    HouseBalanceMember = 1 << 8,
+    EarlyNitroSupporter = 1 << 9,
+    TeamPseudoUser = 1 << 10,
+    BugHunterLevel2 = 1 << 14,
+    VerifiedBot = 1 << 16,
+    VerifiedDeveloper = 1 << 17,
+    CertifiedModerator = 1 << 18,
+    BotHttpInteractions = 1 << 19,
+    ActiveDeveloper = 1 << 22
+}

Entities/GuildFeatures.cs

@@ -0,0 +1,13 @@
+using x3rt.DiscordOAuth2.Entities.Enums;
+
+namespace x3rt.DiscordOAuth2.Entities;
+
+public record GuildFeatures
+{
+    IEnumerable<GuildFeature> Features { get; set; }
+
+    public override string ToString()
+    {
+        return string.Join(", ", Features);
+    }
+}

Entities/OAuthToken.cs

@@ -0,0 +1,16 @@
+using Newtonsoft.Json;
+
+namespace x3rt.DiscordOAuth2.Entities;
+
+public class OAuthToken
+{
+    [JsonProperty("access_token")] public string AccessToken { get; set; }
+
+    [JsonProperty("expires_in")] public int ExpiresIn { get; set; }
+
+    [JsonProperty("refresh_token")] public string RefreshToken { get; set; }
+
+    [JsonProperty("scope")] public string Scope { get; set; }
+
+    [JsonProperty("token_type")] public string TokenType { get; set; }
+}