Add voice channel statuses

Backend/Remora.Discord.API.Abstractions/API/Gateway/Events/Channels/IVoiceChannelStatusUpdate.cs

@@ -0,0 +1,46 @@
+//
+//  IVoiceChannelStatusUpdate.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 an update to the respective voice channel.
+/// </summary>
+public interface IVoiceChannelStatusUpdate : IGatewayEvent
+{
+    /// <summary>
+    /// Gets the ID of the channel being updated.
+    /// </summary>
+    Snowflake ID { get; }
+
+    /// <summary>
+    /// Gets the ID of the guild.
+    /// </summary>
+    Snowflake GuildID { get; }
+
+    /// <summary>
+    /// Gets the new status of the voice channel.
+    /// </summary>
+    Optional<string> Status { get; }
+}

Backend/Remora.Discord.API.Abstractions/API/Objects/Channels/IChannel.cs

@@ -212,6 +212,11 @@ public interface IChannel : IPartialChannel
     /// </summary>
     new Optional<ForumLayout> DefaultForumLayout { get; }
 
+    /// <summary>
+    /// Gets the status of the channel.
+    /// </summary>
+    new Optional<string?> Status { get; }
+
     /// <inheritdoc/>
     Optional<Snowflake> IPartialChannel.ID => this.ID;
 
@@ -316,4 +321,7 @@ public interface IChannel : IPartialChannel
 
     /// <inheritdoc/>
     Optional<ForumLayout> IPartialChannel.DefaultForumLayout => this.DefaultForumLayout;
+
+    /// <inheritdoc/>
+    Optional<string?> IPartialChannel.Status => this.Status;
 }

Backend/Remora.Discord.API.Abstractions/API/Objects/Channels/IPartialChannel.cs

@@ -137,4 +137,7 @@ public interface IPartialChannel
 
     /// <inheritdoc cref="IChannel.DefaultForumLayout" />
     Optional<ForumLayout> DefaultForumLayout { get; }
+
+    /// <inheritdoc cref="IChannel.Status"/>
+    Optional<string?> Status { get; }
 }

Backend/Remora.Discord.API.Abstractions/API/Rest/IDiscordRestChannelAPI.cs

@@ -47,6 +47,22 @@ public interface IDiscordRestChannelAPI
     /// <returns>A retrieval result which may or may not have succeeded.</returns>
     Task<Result<IChannel>> GetChannelAsync(Snowflake channelID, CancellationToken ct = default);
 
+    /// <summary>
+    /// Sets the status of a given voice channel.
+    /// </summary>
+    /// <param name="channelID">The ID of the channel.</param>
+    /// <param name="status">The status to set.</param>
+    /// <param name="reason">The reason to mark the action in the audit log with.</param>
+    /// <param name="ct">The cancellation token for this operation.</param>
+    /// <returns>A modification result that may or not have succeeded.</returns>
+    Task<Result> SetVoiceChannelStatusAsync
+    (
+        Snowflake channelID,
+        Optional<string> status,
+        Optional<string> reason = default,
+        CancellationToken ct = default
+    );
+
     /// <summary>
     /// Modifies the given channel.
     /// </summary>

Backend/Remora.Discord.API/API/Gateway/Events/Channels/ChannelCreate.cs

@@ -67,5 +67,6 @@ public record ChannelCreate
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IChannelCreate;

Backend/Remora.Discord.API/API/Gateway/Events/Channels/ChannelDelete.cs

@@ -67,5 +67,6 @@ public record ChannelDelete
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IChannelDelete;

Backend/Remora.Discord.API/API/Gateway/Events/Channels/ChannelUpdate.cs

@@ -67,5 +67,6 @@ public record ChannelUpdate
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IChannelUpdate;

Backend/Remora.Discord.API/API/Gateway/Events/Channels/ThreadCreate.cs

@@ -68,5 +68,6 @@ public record ThreadCreate
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IThreadCreate;

Backend/Remora.Discord.API/API/Gateway/Events/Channels/ThreadDelete.cs

@@ -67,5 +67,6 @@ public record ThreadDelete
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IThreadDelete;

Backend/Remora.Discord.API/API/Gateway/Events/Channels/ThreadUpdate.cs

@@ -67,5 +67,6 @@ public record ThreadUpdate
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IThreadUpdate;

Backend/Remora.Discord.API/API/Gateway/Events/Channels/VoiceChannelStatusUpdate.cs

@@ -0,0 +1,34 @@
+//
+//  VoiceChannelStatusUpdate.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.Gateway.Events;
+using Remora.Rest.Core;
+
+namespace Remora.Discord.API.Gateway.Events.Channels;
+
+/// <inheritdoc cref="Remora.Discord.API.Abstractions.Gateway.Events.IVoiceChannelStatusUpdate"/>
+public record VoiceChannelStatusUpdate
+(
+    Snowflake ID,
+    Snowflake GuildID,
+    Optional<string> Status
+) : IVoiceChannelStatusUpdate;

Backend/Remora.Discord.API/API/Objects/Channels/Channel.cs

@@ -68,5 +68,6 @@ public record Channel
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IChannel;

Backend/Remora.Discord.API/API/Objects/Channels/PartialChannel.cs

@@ -68,5 +68,6 @@ public record PartialChannel
     Optional<IDefaultReaction?> DefaultReactionEmoji = default,
     Optional<TimeSpan> DefaultThreadRateLimitPerUser = default,
     Optional<SortOrder?> DefaultSortOrder = default,
-    Optional<ForumLayout> DefaultForumLayout = default
+    Optional<ForumLayout> DefaultForumLayout = default,
+    Optional<string?> Status = default
 ) : IPartialChannel;

Backend/Remora.Discord.Caching/API/CachingDiscordRestChannelAPI.Delegations.cs

@@ -35,6 +35,18 @@ namespace Remora.Discord.Caching.API;
 
 public partial class CachingDiscordRestChannelAPI
 {
+    /// <inheritdoc />
+    public Task<Result> SetVoiceChannelStatusAsync
+    (
+        Snowflake channelID,
+        Optional<string> status,
+        Optional<string> reason = default,
+        CancellationToken ct = default
+    )
+    {
+        return _actual.SetVoiceChannelStatusAsync(channelID, status, reason, ct);
+    }
+
     /// <inheritdoc />
     public Task<Result<IChannel>> ModifyGroupDMChannelAsync
     (

Backend/Remora.Discord.Rest/API/Channels/DiscordRestChannelAPI.cs

@@ -80,6 +80,28 @@
         );
     }
 
+    /// <inheritdoc />
+    public virtual Task<Result> SetVoiceChannelStatusAsync
+    (
+        Snowflake channelID,
+        Optional<string> status,
+        Optional<string> reason = default,
+        CancellationToken ct = default
+    )
+    {
+        if (status is { HasValue: true, Value: { Length: > 500 } })
+        {
+            return Task.FromResult<Result>(new ArgumentOutOfRangeError(nameof(status), "The status must between 0 and 500 characters."));
+        }
+
+        return this.RestHttpClient.PatchAsync
+        (
+            $"channels/{channelID}/voice-status",
+            b => b.WithJson(b => b.Write("status", status, this.JsonOptions)).WithRateLimitContext(this.RateLimitCache),
+            ct: ct
+        );
+    }
+
     /// <inheritdoc />
     public virtual async Task<Result<IChannel>> ModifyChannelAsync
     (