feat(api): implement stage voice channels

lib/api/server/channels/server_stage_channel.dart

@@ -0,0 +1,69 @@
+import 'package:mineral/api/common/channel_methods.dart';
+import 'package:mineral/api/common/channel_permission_overwrite.dart';
+import 'package:mineral/api/common/channel_properties.dart';
+import 'package:mineral/api/common/embed/message_embed.dart';
+import 'package:mineral/api/common/managers/message_manager.dart';
+import 'package:mineral/api/common/polls/poll.dart';
+import 'package:mineral/api/common/snowflake.dart';
+import 'package:mineral/api/common/types/channel_type.dart';
+import 'package:mineral/api/server/channels/server_category_channel.dart';
+import 'package:mineral/api/server/channels/server_channel.dart';
+import 'package:mineral/api/server/server_message.dart';
+
+final class ServerStageChannel extends ServerChannel {
+  final ChannelProperties _properties;
+  final ChannelMethods _methods;
+
+  final MessageManager<ServerMessage> messages = MessageManager();
+
+  @override
+  Snowflake get id => _properties.id;
+
+  @override
+  ChannelType get type => _properties.type;
+
+  @override
+  String get name => _properties.name!;
+
+  @override
+  int get position => _properties.position!;
+
+  @override
+  List<ChannelPermissionOverwrite> get permissions => _properties.permissions!;
+
+  String? get description => _properties.description;
+
+  late final ServerCategoryChannel? category;
+
+  @override
+  Snowflake get guildId => _properties.guildId!;
+
+  ServerStageChannel(this._properties) : _methods = ChannelMethods(_properties.id);
+
+  Future<void> setName(String name, {String? reason}) => _methods.setName(name, reason);
+
+  Future<void> setDescription(String description, {String? reason}) =>
+      _methods.setDescription(description, reason);
+
+  Future<void> setCategory(String categoryId, {String? reason}) =>
+      _methods.setCategory(categoryId, reason);
+
+  Future<void> setPosition(int position, {String? reason}) =>
+      _methods.setPosition(position, reason);
+
+  Future<void> setNsfw(bool nsfw, {String? reason}) => _methods.setNsfw(nsfw, reason);
+
+  Future<void> setRateLimitPerUser(int rateLimitPerUser, {String? reason}) =>
+      _methods.setRateLimitPerUser(rateLimitPerUser, reason);
+
+  Future<void> setDefaultAutoArchiveDuration(int defaultAutoArchiveDuration, {String? reason}) =>
+      _methods.setDefaultAutoArchiveDuration(defaultAutoArchiveDuration, reason);
+
+  Future<void> setDefaultThreadRateLimitPerUser(int value, {String? reason}) =>
+      _methods.setDefaultThreadRateLimitPerUser(value, reason);
+
+  Future<void> send({String? content, List<MessageEmbed>? embeds, Poll? poll}) =>
+      _methods.send(guildId: _properties.guildId, content: content, embeds: embeds, poll: poll);
+
+  Future<void> delete({String? reason}) => _methods.delete(reason);
+}

lib/infrastructure/internals/marshaller/factories/channels/server_forum_channel_factory.dart

@@ -41,6 +41,7 @@ final class ServerForumChannelFactory implements ChannelFactoryContract<ServerFo
       'position': channel.position,
       'guild_id': channel.guildId,
       'permission_overwrites': permissions,
+      'parent_id': channel.category?.id,
     };
   }
 }

lib/infrastructure/internals/marshaller/factories/channels/server_stage_channel_factory.dart

@@ -0,0 +1,36 @@
+import 'package:mineral/api/common/channel_properties.dart';
+import 'package:mineral/api/common/types/channel_type.dart';
+import 'package:mineral/api/server/channels/server_stage_channel.dart';
+import 'package:mineral/infrastructure/internals/marshaller/marshaller.dart';
+import 'package:mineral/infrastructure/internals/marshaller/types/channel_factory.dart';
+
+final class ServerStageChannelFactory implements ChannelFactoryContract<ServerStageChannel> {
+  @override
+  ChannelType get type => ChannelType.guildStageVoice;
+
+  @override
+  Future<ServerStageChannel> make(
+      MarshallerContract marshaller, String guildId, Map<String, dynamic> json) async {
+    final properties = await ChannelProperties.make(marshaller, json);
+
+    return ServerStageChannel(properties);
+  }
+
+  @override
+  Future<Map<String, dynamic>> deserialize(
+      MarshallerContract marshaller, ServerStageChannel channel) async {
+    final permissions = await Future.wait(channel.permissions.map(
+        (element) async => marshaller.serializers.channelPermissionOverwrite.deserialize(element)));
+
+    return {
+      'id': channel.id.value,
+      'type': channel.type.value,
+      'name': channel.name,
+      'position': channel.position,
+      'guild_id': channel.guildId,
+      'topic': channel.description,
+      'permission_overwrites': permissions,
+      'parent_id': channel.category?.id,
+    };
+  }
+}

lib/infrastructure/internals/marshaller/factories/channels/server_text_channel_factory.dart

@@ -29,7 +29,8 @@ final class ServerTextChannelFactory implements ChannelFactoryContract<ServerTex
       'position': channel.position,
       'guild_id': channel.guildId,
       'topic': channel.description,
-      'permission_overwrites': permissions
+      'permission_overwrites': permissions,
+      'parent_id': channel.category?.id,
     };
   }
 }

lib/infrastructure/internals/marshaller/serializers/channel_serializer.dart

@@ -4,6 +4,7 @@ import 'package:mineral/infrastructure/internals/marshaller/factories/channels/p
 import 'package:mineral/infrastructure/internals/marshaller/factories/channels/server_announcement_channel_factory.dart';
 import 'package:mineral/infrastructure/internals/marshaller/factories/channels/server_category_channel_factory.dart';
 import 'package:mineral/infrastructure/internals/marshaller/factories/channels/server_forum_channel_factory.dart';
+import 'package:mineral/infrastructure/internals/marshaller/factories/channels/server_stage_channel_factory.dart';
 import 'package:mineral/infrastructure/internals/marshaller/factories/channels/server_text_channel_factory.dart';
 import 'package:mineral/infrastructure/internals/marshaller/factories/channels/server_voice_channel_factory.dart';
 import 'package:mineral/infrastructure/internals/marshaller/marshaller.dart';
@@ -19,6 +20,7 @@ final class ChannelSerializer<T extends Channel?> implements SerializerContract<
     ServerCategoryChannelFactory(),
     ServerAnnouncementChannelFactory(),
     ServerForumChannelFactory(),
+    ServerStageChannelFactory(),
     PrivateChannelFactory(),
   ];