Implement support for user banners.

See discord/discord-api-docs#6986.

Author: Nihlus

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Guilds/IGuildMemberUpdate.cs

@@ -59,6 +59,11 @@ public interface IGuildMemberUpdate : IGatewayEvent
     /// </summary>
     Optional<IImageHash?> Avatar { get; }
 
+    /// <summary>
+    /// Gets the member's guild banner hash.
+    /// </summary>
+    Optional<IImageHash?> Banner { get; }
+
     /// <summary>
     /// Gets the date when the user joined the guild.
     /// </summary>

Backend/Remora.Discord.API.Abstractions/API/Objects/Guilds/IGuildMember.cs

@@ -48,6 +48,11 @@ public interface IGuildMember : IPartialGuildMember
     /// </summary>
     new Optional<IImageHash?> Avatar { get; }
 
+    /// <summary>
+    /// Gets the member's guild banner hash.
+    /// </summary>
+    new Optional<IImageHash?> Banner { get; }
+
     /// <summary>
     /// Gets the roles the user has.
     /// </summary>
@@ -102,6 +107,9 @@ public interface IGuildMember : IPartialGuildMember
     /// <inheritdoc />
     Optional<IImageHash?> IPartialGuildMember.Avatar => this.Avatar;
 
+    /// <inheritdoc />
+    Optional<IImageHash?> IPartialGuildMember.Banner => this.Banner;
+
     /// <inheritdoc/>
     Optional<IReadOnlyList<Snowflake>> IPartialGuildMember.Roles => new(this.Roles);
 

Backend/Remora.Discord.API.Abstractions/API/Objects/Guilds/IPartialGuildMember.cs

@@ -42,6 +42,9 @@ public interface IPartialGuildMember
     /// <inheritdoc cref="IGuildMember.Avatar"/>
     Optional<IImageHash?> Avatar { get; }
 
+    /// <inheritdoc cref="IGuildMember.Banner"/>
+    Optional<IImageHash?> Banner { get; }
+
     /// <inheritdoc cref="IGuildMember.Roles" />
     Optional<IReadOnlyList<Snowflake>> Roles { get; }
 

Backend/Remora.Discord.API/API/Gateway/Events/Guilds/GuildMemberAdd.cs

@@ -37,6 +37,7 @@ public record GuildMemberAdd
     Optional<IUser> User,
     Optional<string?> Nickname,
     Optional<IImageHash?> Avatar,
+    Optional<IImageHash?> Banner,
     IReadOnlyList<Snowflake> Roles,
     DateTimeOffset JoinedAt,
     Optional<DateTimeOffset?> PremiumSince,

Backend/Remora.Discord.API/API/Gateway/Events/Guilds/GuildMemberUpdate.cs

@@ -40,6 +40,7 @@ public record GuildMemberUpdate
     IUser User,
     Optional<string?> Nickname = default,
     Optional<IImageHash?> Avatar = default,
+    Optional<IImageHash?> Banner = default,
     DateTimeOffset? JoinedAt = default,
     Optional<DateTimeOffset?> PremiumSince = default,
     Optional<bool> IsPending = default,

Backend/Remora.Discord.API/API/Objects/Guilds/GuildMember.cs

@@ -37,6 +37,7 @@ public record GuildMember
     Optional<IUser> User,
     Optional<string?> Nickname,
     Optional<IImageHash?> Avatar,
+    Optional<IImageHash?> Banner,
     IReadOnlyList<Snowflake> Roles,
     DateTimeOffset JoinedAt,
     Optional<DateTimeOffset?> PremiumSince,

Backend/Remora.Discord.API/API/Objects/Guilds/PartialGuildMember.cs

@@ -37,6 +37,7 @@ public record PartialGuildMember
     Optional<IUser> User = default,
     Optional<string?> Nickname = default,
     Optional<IImageHash?> Avatar = default,
+    Optional<IImageHash?> Banner = default,
     Optional<IReadOnlyList<Snowflake>> Roles = default,
     Optional<DateTimeOffset> JoinedAt = default,
     Optional<DateTimeOffset?> PremiumSince = default,

Backend/Remora.Discord.Caching/Responders/EarlyCacheResponder.cs

@@ -188,6 +188,7 @@ public async Task<Result> RespondAsync(IGuildMemberUpdate gatewayEvent, Cancella
                 new Optional<IUser>(gatewayEvent.User),
                 gatewayEvent.Nickname.TryGet(out var nickname) ? nickname : cachedInstance.Nickname,
                 gatewayEvent.Avatar,
+                gatewayEvent.Banner,
                 gatewayEvent.Roles,
                 gatewayEvent.JoinedAt ?? cachedInstance.JoinedAt,
                 gatewayEvent.PremiumSince.TryGet(out var premiumSince) ? premiumSince : cachedInstance.PremiumSince,
@@ -206,6 +207,7 @@ public async Task<Result> RespondAsync(IGuildMemberUpdate gatewayEvent, Cancella
                 new Optional<IUser>(gatewayEvent.User),
                 gatewayEvent.Nickname,
                 gatewayEvent.Avatar,
+                gatewayEvent.Banner,
                 gatewayEvent.Roles,
                 gatewayEvent.JoinedAt.Value,
                 gatewayEvent.PremiumSince,

Tests/Remora.Discord.Tests/Samples/Gateway/Events/GUILD_MEMBER_UPDATE/GUILD_MEMBER_UPDATE.json

@@ -15,6 +15,7 @@
     },
     "nick": "none",
     "avatar": "68b329da9893e34099c7d8ad5cb9c940",
+    "banner": "68b329da9893e34099c7d8ad5cb9c940",
     "joined_at": "1970-01-01T00:00:00.000000+00:00",
     "premium_since": "1970-01-01T00:00:00.000000+00:00",
     "deaf": true,

Tests/Remora.Discord.Tests/Samples/Gateway/Events/GUILD_MEMBER_UPDATE/GUILD_MEMBER_UPDATE.nulls.json

@@ -15,6 +15,7 @@
     },
     "nick": null,
     "avatar": null,
+    "banner": null,
     "joined_at": null,
     "premium_since": null,
     "deaf": true,