feat: add role gradient support

Ref: discord/discord-api-docs#7549

Author: Snazzah

CHANGELOG.md

@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added:
 - Added `collectibles` to users
+- Added `colors` to roles (supporting role gradients)
 ## [6.4.2] - 2025-06-15
 ### Fixed:
 - Fix express apps being forced to use `express.json` in the entire app ([#633](https://github.com/Snazzah/slash-create/pull/633))

src/constants.ts

@@ -794,6 +794,7 @@ export interface UserNameplate {
 /** @private */
 export interface ResolvedRole {
   color: number;
+  colors: RoleColors;
   hoist: boolean;
   id: string;
   icon?: string;
@@ -806,6 +807,32 @@ export interface ResolvedRole {
   tags?: RoleTags;
 }
 
+/** A role's tags */
+export interface RoleTags {
+  /** The ID of the bot that belongs to the role */
+  bot_id?: string;
+  /** The ID of the integration that belongs to the role */
+  integration_id?: string;
+  /** Whether this is the guild's booster role */
+  premium_subscriber?: null;
+  /** The ID of this role's subscription SKU and listing */
+  subscription_listing_id?: string;
+  /** Whether this role can be purchased */
+  available_for_purchase?: null;
+  /** Whether this is a guild's linked role */
+  guild_connections?: null;
+}
+
+/** A role's colors */
+export interface RoleColors {
+  /** The primary color for the role */
+  primary_color: number;
+  /** The secondary color for the role */
+  secondary_color: number | null;
+  /** The tertiary color for the role */
+  tertiary_color: number | null;
+}
+
 /** @private */
 export interface CommandChannel {
   type: ChannelType;
@@ -881,22 +908,6 @@ export interface ForumDefaultReaction {
   emoji_id: string | null;
 }
 
-/** A role's tags */
-export interface RoleTags {
-  /** The ID of the bot that belongs to the role */
-  bot_id?: string;
-  /** The ID of the integration that belongs to the role */
-  integration_id?: string;
-  /** Whether this is the guild's booster role */
-  premium_subscriber?: null;
-  /** The ID of this role's subscription SKU and listing */
-  subscription_listing_id?: string;
-  /** Whether this role can be purchased */
-  available_for_purchase?: null;
-  /** Whether this is a guild's linked role */
-  guild_connections?: null;
-}
-
 /** @hidden */
 export interface UserObject extends CommandUser {
   /** Whether this user is a bot. */

src/structures/role.ts

@@ -5,6 +5,7 @@ import {
   ImageFormats,
   ImageSizeBoundaries,
   ResolvedRole,
+  RoleColors,
   RoleTags
 } from '../constants';
 import { BaseSlashCreator } from '../creator';
@@ -20,6 +21,8 @@ export class Role {
   readonly position: number;
   /** The role's color integer */
   readonly color: number;
+  /** The role's colors */
+  readonly colors: RoleColors;
   /** Whether the role is being hoisted */
   readonly hoist: boolean;
   /** The role icon hash */
@@ -49,6 +52,7 @@ export class Role {
     this.name = data.name;
     this.position = data.position;
     this.color = data.color;
+    this.colors = data.colors;
     this.hoist = data.hoist;
     if (data.icon) this.icon = data.icon;
     this.managed = data.managed;