add user clans

Author: Lexedia

lib/src/http/managers/user_manager.dart

@@ -20,6 +20,7 @@ import 'package:nyxx/src/models/user/application_role_connection.dart';
 import 'package:nyxx/src/models/user/avatar_decoration_data.dart';
 import 'package:nyxx/src/models/user/connection.dart';
 import 'package:nyxx/src/models/user/user.dart';
+import 'package:nyxx/src/models/user/user_clan.dart';
 import 'package:nyxx/src/utils/cache_helpers.dart';
 import 'package:nyxx/src/utils/parsing_helpers.dart';
 
@@ -58,6 +59,7 @@ class UserManager extends ReadOnlyManager<User> {
       publicFlags: hasPublicFlags ? UserFlags(raw['public_flags'] as int) : null,
       avatarDecorationHash: avatarDecorationData?.asset,
       avatarDecorationData: avatarDecorationData,
+      clan: maybeParse(raw['clan'], parseUserClan),
     );
   }
 
@@ -101,6 +103,17 @@ class UserManager extends ReadOnlyManager<User> {
     );
   }
 
+  /// Parse a [UserClan] from [raw].
+  UserClan parseUserClan(Map<String, Object?> raw) {
+    return UserClan(
+      identityGuildId: Snowflake.parse(raw['identity_guild_id']!),
+      isIdentityEnabled: raw['identity_enabled'] as bool,
+      tag: raw['tag'] as String,
+      badgeHash: raw['badge'] as String,
+      client: client,
+    );
+  }
+
   @override
   Future<User> fetch(Snowflake id) async {
     final route = HttpRoute()..users(id: id.toString());

lib/src/http/route.dart

@@ -344,4 +344,7 @@ extension RouteHelpers on HttpRoute {
 
   /// Adds the [`send-soundboard-sound`](https://discord.com/developers/docs/resources/soundboard#send-soundboard-sound) part to this [HttpRoute].
   void sendSoundboardSound() => add(HttpRoutePart('send-soundboard-sound'));
+
+  /// Adds the [`clan-badges`](https://discord.com/developers/docs/reference#image-formatting-cdn-endpoints)
+  void clanBadges({String? id}) => add(HttpRoutePart('clan-badges', [if (id != null) HttpRouteParam(id)]));
 }

lib/src/models/user/user.dart

@@ -7,6 +7,7 @@ import 'package:nyxx/src/models/locale.dart';
 import 'package:nyxx/src/models/message/author.dart';
 import 'package:nyxx/src/models/snowflake_entity/snowflake_entity.dart';
 import 'package:nyxx/src/models/user/avatar_decoration_data.dart';
+import 'package:nyxx/src/models/user/user_clan.dart';
 import 'package:nyxx/src/utils/enum_like.dart';
 import 'package:nyxx/src/utils/flags.dart';
 
@@ -77,6 +78,9 @@ class User extends PartialUser implements MessageAuthor, CommandOptionMentionabl
   /// The user's avatar deciration data.
   final AvatarDecorationData? avatarDecorationData;
 
+  /// The user's clan data.
+  final UserClan? clan;
+
   /// {@macro user}
   /// @nodoc
   User({
@@ -97,6 +101,7 @@ class User extends PartialUser implements MessageAuthor, CommandOptionMentionabl
     required this.publicFlags,
     required this.avatarDecorationHash,
     required this.avatarDecorationData,
+    required this.clan,
   });
 
   /// This user's banner.

lib/src/models/user/user_clan.dart

@@ -0,0 +1,31 @@
+import 'package:nyxx/src/client.dart';
+import 'package:nyxx/src/http/cdn/cdn_asset.dart';
+import 'package:nyxx/src/http/route.dart';
+import 'package:nyxx/src/models/guild/guild.dart';
+import 'package:nyxx/src/models/snowflake.dart';
+import 'package:nyxx/src/utils/to_string_helper/to_string_helper.dart';
+
+class UserClan with ToStringHelper {
+  final NyxxRest _client;
+
+  /// The ID of this user's primary clan
+  final Snowflake identityGuildId;
+
+  /// Whether the user is displaying their clan tag
+  final bool isIdentityEnabled;
+
+  /// The text of the user's clan tag. Limited to 4 characters
+  final String tag;
+
+  /// The clan badge hash.
+  final String badgeHash;
+
+  UserClan({required this.identityGuildId, required this.badgeHash, required this.isIdentityEnabled, required this.tag, required NyxxRest client})
+      : _client = client;
+
+  /// The guild of this user's primary clan
+  PartialGuild get identifyGuild => PartialGuild(id: identityGuildId, manager: _client.guilds);
+
+  /// The clan badge
+  CdnAsset get badge => CdnAsset(client: _client, base: HttpRoute()..clanBadges(id: identityGuildId.toString()), hash: badgeHash);
+}