Implement support for soundboards.

See discord/discord-api-docs#6260 and discord/discord-api-docs#7207.

Author: Nihlus

Backend/Remora.Discord.API.Abstractions/API/Gateway/Commands/GatewayIntents.cs

@@ -76,8 +76,12 @@ public enum GatewayIntents
     /// Subscribes to the following events:
     ///     - GUILD_EMOJIS_UPDATE
     ///     - GUILD_STICKERS_UPDATE
+    ///     - GUILD_SOUNDBOARD_SOUND_CREATE
+    ///     - GUILD_SOUNDBOARD_SOUND_UPDATE
+    ///     - GUILD_SOUNDBOARD_SOUND_DELETE
+    ///     - GUILD_SOUNDBOARD_SOUNDS_UPDATE
     /// </summary>
-    GuildEmojisAndStickers = 1 << 3,
+    GuildExpressions = 1 << 3,
 
     /// <summary>
     /// Subscribes to the following events:

Backend/Remora.Discord.API.Abstractions/API/Gateway/Commands/IRequestSoundboardSounds.cs

@@ -0,0 +1,39 @@
+//
+//  IRequestSoundboardSounds.cs
+//
+//  Author:
+//       Jarl Gullberg <[email protected]>
+//
+//  Copyright (c) Jarl Gullberg
+//
+//  This program is free software: you can redistribute it and/or modify
+//  it under the terms of the GNU Lesser General Public License as published by
+//  the Free Software Foundation, either version 3 of the License, or
+//  (at your option) any later version.
+//
+//  This program is distributed in the hope that it will be useful,
+//  but WITHOUT ANY WARRANTY; without even the implied warranty of
+//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//  GNU Lesser General Public License for more details.
+//
+//  You should have received a copy of the GNU Lesser General Public License
+//  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+using System.Collections.Generic;
+using JetBrains.Annotations;
+using Remora.Rest.Core;
+
+namespace Remora.Discord.API.Abstractions.Gateway.Commands;
+
+/// <summary>
+/// Represents a request for the soundboard sounds of the given guilds.
+/// </summary>
+[PublicAPI]
+public interface IRequestSoundboardSounds
+{
+    /// <summary>
+    /// Gets the guild IDs of the guilds to get the soundboard sounds of.
+    /// </summary>
+    IReadOnlyList<Snowflake> GuildIDs { get; }
+}

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Soundboard/IGuildSoundboardSoundCreate.cs

@@ -0,0 +1,30 @@
+//
+//  IGuildSoundboardSoundCreate.cs
+//
+//  Author:
+//       Jarl Gullberg <[email protected]>
+//
+//  Copyright (c) Jarl Gullberg
+//
+//  This program is free software: you can redistribute it and/or modify
+//  it under the terms of the GNU Lesser General Public License as published by
+//  the Free Software Foundation, either version 3 of the License, or
+//  (at your option) any later version.
+//
+//  This program is distributed in the hope that it will be useful,
+//  but WITHOUT ANY WARRANTY; without even the implied warranty of
+//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//  GNU Lesser General Public License for more details.
+//
+//  You should have received a copy of the GNU Lesser General Public License
+//  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+using Remora.Discord.API.Abstractions.Objects.Soundboard;
+
+namespace Remora.Discord.API.Abstractions.Gateway.Events;
+
+/// <summary>
+/// Represents a creation event for a soundboard sound.
+/// </summary>
+public interface IGuildSoundboardSoundCreate : IGatewayEvent, ISoundboardSound;

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Soundboard/IGuildSoundboardSoundDelete.cs

@@ -0,0 +1,41 @@
+//
+//  IGuildSoundboardSoundDelete.cs
+//
+//  Author:
+//       Jarl Gullberg <[email protected]>
+//
+//  Copyright (c) Jarl Gullberg
+//
+//  This program is free software: you can redistribute it and/or modify
+//  it under the terms of the GNU Lesser General Public License as published by
+//  the Free Software Foundation, either version 3 of the License, or
+//  (at your option) any later version.
+//
+//  This program is distributed in the hope that it will be useful,
+//  but WITHOUT ANY WARRANTY; without even the implied warranty of
+//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//  GNU Lesser General Public License for more details.
+//
+//  You should have received a copy of the GNU Lesser General Public License
+//  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+using Remora.Rest.Core;
+
+namespace Remora.Discord.API.Abstractions.Gateway.Events;
+
+/// <summary>
+/// Represents a delete event for a soundboard sound.
+/// </summary>
+public interface IGuildSoundboardSoundDelete : IGatewayEvent
+{
+    /// <summary>
+    /// Gets the ID of the deleted sound.
+    /// </summary>
+    Snowflake SoundID { get; }
+
+    /// <summary>
+    /// Gets the ID of the guild the sound was deleted from.
+    /// </summary>
+    Snowflake GuildID { get; }
+}

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Soundboard/IGuildSoundboardSoundUpdate.cs

@@ -0,0 +1,30 @@
+//
+//  IGuildSoundboardSoundUpdate.cs
+//
+//  Author:
+//       Jarl Gullberg <[email protected]>
+//
+//  Copyright (c) Jarl Gullberg
+//
+//  This program is free software: you can redistribute it and/or modify
+//  it under the terms of the GNU Lesser General Public License as published by
+//  the Free Software Foundation, either version 3 of the License, or
+//  (at your option) any later version.
+//
+//  This program is distributed in the hope that it will be useful,
+//  but WITHOUT ANY WARRANTY; without even the implied warranty of
+//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//  GNU Lesser General Public License for more details.
+//
+//  You should have received a copy of the GNU Lesser General Public License
+//  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+using Remora.Discord.API.Abstractions.Objects.Soundboard;
+
+namespace Remora.Discord.API.Abstractions.Gateway.Events;
+
+/// <summary>
+/// Represents an update event for a soundboard sound.
+/// </summary>
+public interface IGuildSoundboardSoundUpdate : IGatewayEvent, ISoundboardSound;

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Soundboard/IGuildSoundboardSoundsUpdate.cs

@@ -0,0 +1,45 @@
+//
+//  IGuildSoundboardSoundsUpdate.cs
+//
+//  Author:
+//       Jarl Gullberg <[email protected]>
+//
+//  Copyright (c) Jarl Gullberg
+//
+//  This program is free software: you can redistribute it and/or modify
+//  it under the terms of the GNU Lesser General Public License as published by
+//  the Free Software Foundation, either version 3 of the License, or
+//  (at your option) any later version.
+//
+//  This program is distributed in the hope that it will be useful,
+//  but WITHOUT ANY WARRANTY; without even the implied warranty of
+//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//  GNU Lesser General Public License for more details.
+//
+//  You should have received a copy of the GNU Lesser General Public License
+//  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+using System.Collections.Generic;
+using JetBrains.Annotations;
+using Remora.Discord.API.Abstractions.Objects.Soundboard;
+using Remora.Rest.Core;
+
+namespace Remora.Discord.API.Abstractions.Gateway.Events;
+
+/// <summary>
+/// Represents a batch of update events for soundboard sounds.
+/// </summary>
+[PublicAPI]
+public interface IGuildSoundboardSoundsUpdate : IGatewayEvent
+{
+    /// <summary>
+    /// Gets the updated soundboard sounds.
+    /// </summary>
+    IReadOnlyList<ISoundboardSound> SoundboardSounds { get; }
+
+    /// <summary>
+    /// Gets the ID of the guild that the sounds were updated in.
+    /// </summary>
+    Snowflake GuildID { get; }
+}

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Soundboard/ISoundboardSounds.cs

@@ -0,0 +1,45 @@
+//
+//  ISoundboardSounds.cs
+//
+//  Author:
+//       Jarl Gullberg <[email protected]>
+//
+//  Copyright (c) Jarl Gullberg
+//
+//  This program is free software: you can redistribute it and/or modify
+//  it under the terms of the GNU Lesser General Public License as published by
+//  the Free Software Foundation, either version 3 of the License, or
+//  (at your option) any later version.
+//
+//  This program is distributed in the hope that it will be useful,
+//  but WITHOUT ANY WARRANTY; without even the implied warranty of
+//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//  GNU Lesser General Public License for more details.
+//
+//  You should have received a copy of the GNU Lesser General Public License
+//  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+
+using System.Collections.Generic;
+using JetBrains.Annotations;
+using Remora.Discord.API.Abstractions.Objects.Soundboard;
+using Remora.Rest.Core;
+
+namespace Remora.Discord.API.Abstractions.Gateway.Events;
+
+/// <summary>
+/// Represents a batch of requested soundboard sounds.
+/// </summary>
+[PublicAPI]
+public interface ISoundboardSounds : IGatewayEvent
+{
+    /// <summary>
+    /// Gets the soundboard sounds.
+    /// </summary>
+    IReadOnlyList<ISoundboardSound> Sounds { get; }
+
+    /// <summary>
+    /// Gets the ID of the guild that the sounds belong to.
+    /// </summary>
+    Snowflake GuildID { get; }
+}

Backend/Remora.Discord.API.Abstractions/API/Gateway/OperationCode.cs

@@ -88,5 +88,10 @@ public enum OperationCode
     /// <summary>
     /// Sent in response to receiving a heartbeat to acknowledge that it has been received.
     /// </summary>
-    HeartbeatAcknowledge = 11
+    HeartbeatAcknowledge = 11,
+
+    /// <summary>
+    /// Request information about soundboard sounds in guilds.
+    /// </summary>
+    RequestSoundboardSounds = 31
 }

Backend/Remora.Discord.API.Abstractions/API/Objects/AuditLogs/AuditLogEvent.cs

@@ -270,6 +270,21 @@ public enum AuditLogEvent
     /// </summary>
     ApplicationCommandPermissionUpdate = 121,
 
+    /// <summary>
+    /// A soundboard sound was created.
+    /// </summary>
+    SoundboardSoundCreate = 130,
+
+    /// <summary>
+    /// A soundboard sound was updated.
+    /// </summary>
+    SoundboardSoundUpdate = 131,
+
+    /// <summary>
+    /// A soundboard sound was deleted.
+    /// </summary>
+    SoundboardSoundDelete = 132,
+
     /// <summary>
     /// An Auto Moderation rule was created.
     /// </summary>

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

@@ -100,6 +100,11 @@ public enum GuildFeature
     /// </summary>
     MemberVerificationGateEnabled,
 
+    /// <summary>
+    /// The guild has increased custom soundboard sound slots.
+    /// </summary>
+    MoreSoundboard,
+
     /// <summary>
     /// The guild has enabled monetization.
     /// </summary>
@@ -145,6 +150,11 @@ public enum GuildFeature
     /// </summary>
     RoleSubscriptionsEnabled,
 
+    /// <summary>
+    /// The guild has created soundboard sounds.
+    /// </summary>
+    Soundboard,
+
     /// <summary>
     /// The guild has enabled ticketed events.
     /// </summary>