From 42406c18383902bbef5f3d78e5c04511eff9f519 Mon Sep 17 00:00:00 2001
From: Rory& <root@rory.gay>
Date: Sat, 13 Jun 2026 20:24:12 +0200
Subject: [PATCH] Replace APIRole with schema

---
 assets/openapi.json                           | Bin 972276 -> 976879 bytes
 assets/schemas.json                           | Bin 439600 -> 443855 bytes
 .../routes/guilds/#guild_id/roles/index.ts    |   2 +-
 src/schemas/api/guilds/Role.ts                |  61 ++++++++++++++++++
 src/schemas/responses/TypedResponses.ts       |   4 +-
 5 files changed, 63 insertions(+), 4 deletions(-)

diff --git a/assets/openapi.json b/assets/openapi.json
index 95a8807f5a6b4a7a8781fd84ed76e48585c4922a..45a151ba04dba199bfd7883c42295a8e31b4a806 100644
GIT binary patch
delta 449
zcmeye+WP%@>xLG_Elm1+%t84%lM5fFZWma^_>Xb&gNbod4=`FxS{XjQ|1uxPbiYzo
z?a2Xgx*#6wboF*-`RNWR9CFi*SFxH;*IL4wFg-w+rDOW;HfAfJp2-2ls*?rQ*iSEL
zVNRLewS@J=^bbNT3DZBg^0H6o$zYZSYi7;QNexMy9ypU#a=JkitIzb`t60q@Z;(`;
z-o2Xj%k*<GO!d=07;v*pfB1o2YPv!$v)uFp@@(we&G?u~&bG(iVFF@iAZ7t#*6p!(
z*e>m71^Oa2WctD9Y>Lwz`dI9zZ(Gi)H2uL&E`jX^eT?TBr!VMaW}SRNn0>nC3RZa}
ziOKr&d8YI2X3?Df;W0ZuMDgSUKl!KcS;49>-Qfb0;Pem7KzCo*#$+?SPlbh(J3cMH
zD88VyC^;i>dSfu7`1A)=+?>+|Bw4k=iY5p2v9TrR=jEj)PkwkxdwRi37Uk&$<*eqD
z6)bos8|VnM>(5~aVh$kY+^#=|E3p9LSqE$GY1<2Gxf@u3dN`b?PpIVbpUx-FE!OTQ
R#0|teK+L<{Pl#{XVE`aYt406-

delta 149
zcmaEV-ulaG>xLG_Elm1+)8FZ{v2U-HU@AGw5|p2lI{m?3ri$qgWVl(TZ-`<Pnl4bv
z$T!(QN3i|<Qzjs024WT<X5Ie&DchC(lY81Y+x6G612G2>b8gpP#}!e)?ik<+Hj7c1
rvuyeTe@@Bm2@*U)tke1Ux!I=kYjO*;d#Z2)F%J;)ZueB-TXq-#+0i$+

diff --git a/assets/schemas.json b/assets/schemas.json
index 9506fab1c452f0243d49dfc6ba3c011fdd8bba08..b82fe51886b7c7d7a7b248a276b063e3b1b382e7 100644
GIT binary patch
delta 358
zcmX|+%PT}-7{>d~_nu>9m`TZ)(@aJwkuoWik|ZollW8_)gHGcTnHwv&vm-3%E00qA
z0diTWvyqK4Xkv~XvKSkSS<OG-a$K_bE#7|5^Y*@{1$S;k)z4Ta%|o#nY!eHhR$(rq
z$dn9&Uf_M`4zLCkA8885CMj@csRy??iXfDw0hmjC9lM-2{zSw<XDOVV_XtP154y&h
zv6m&FyPukbS>eHci|j_cp4=>q+_|;$#H2=;mt2MVKm{6{O3mTH#k`2G@vfapiQvCt
zQR6PnZVp$23CV(6kcDgn6Ut?|&AL1q9-Bys1nY%-PpXlRuxo}7Rkq`8npgkM!n0<_
z>ofQLJy-0IY;az%61?1#OXy`b<lA|xSRSsyXoh?UZgRywG9F8g#OIUR<X8&+ur&1T
l#nzKoZ1pON7Mq=oYQle1_usXgLwqhQiuZV_p{^)ZZC_MRi8cTL

delta 72
zcmX@#ExqBDRKpg=V@Ia1b6{oP{@^U*iPg+O`8m_qS29ISzpu-}H`(W`Py5nJCLm@8
aViq7~-M+Mv?HKRmzXhDzclEQ0ngIa7xF7TY

diff --git a/src/api/routes/guilds/#guild_id/roles/index.ts b/src/api/routes/guilds/#guild_id/roles/index.ts
index 4cb82663f..5f792222d 100644
--- a/src/api/routes/guilds/#guild_id/roles/index.ts
+++ b/src/api/routes/guilds/#guild_id/roles/index.ts
@@ -119,7 +119,7 @@ router.patch(
         permission: "MANAGE_ROLES",
         responses: {
             200: {
-                body: "APIRoleArray",
+                body: "RoleListResponse",
             },
             400: {
                 body: "APIErrorResponse",
diff --git a/src/schemas/api/guilds/Role.ts b/src/schemas/api/guilds/Role.ts
index 2f32e5d75..fd3440e6f 100644
--- a/src/schemas/api/guilds/Role.ts
+++ b/src/schemas/api/guilds/Role.ts
@@ -1,3 +1,44 @@
+/*
+	Spacebar: A FOSS re-implementation and extension of the Discord.com backend.
+	Copyright (C) 2026 Spacebar and Spacebar Contributors
+
+	This program is free software: you can redistribute it and/or modify
+	it under the terms of the GNU Affero 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 Affero General Public License for more details.
+
+	You should have received a copy of the GNU Affero General Public License
+	along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+
+import { Snowflake } from "../../Identifiers";
+
+export interface RoleResponse {
+    id: Snowflake;
+    name: string;
+    description: string | null;
+    // @deprecated
+    color: number;
+    colors: RoleColors;
+    hoist: boolean;
+    icon?: string | null;
+    unicode_emoji?: string | null;
+    position: number;
+    // @format number
+    permissions: string;
+    managed: boolean;
+    mentionable: boolean;
+    flags?: number;
+    tags?: RoleTags; // unused currently
+}
+
+export type RoleListResponse = RoleResponse[];
+
 export class RoleColors {
     primary_color: number;
     secondary_color: number | undefined; // only used for "holographic" and "gradient" styles
@@ -11,3 +52,23 @@ export class RoleColors {
         };
     }
 }
+
+export class RoleTags {
+    bot_id?: Snowflake;
+    integration_id?: Snowflake;
+    subscription_listing_id?: Snowflake;
+    // ??? https://github.com/discord-userdoccers/discord-userdoccers/issues/576 - in other words, types are currently unknown
+    premium_subscriber?: boolean | null;
+    available_for_purchase?: boolean | null;
+    guild_connections?: boolean | null;
+
+    toJSON(): RoleTags {
+        return {
+            ...this,
+            // "forward compatibility"
+            premium_subscriber: this.premium_subscriber ? null : undefined,
+            available_for_purchase: this.available_for_purchase ? null : undefined,
+            guild_connections: this.subscription_listing_id ? null : undefined,
+        };
+    }
+}
diff --git a/src/schemas/responses/TypedResponses.ts b/src/schemas/responses/TypedResponses.ts
index 692487b0a..e0413a72e 100644
--- a/src/schemas/responses/TypedResponses.ts
+++ b/src/schemas/responses/TypedResponses.ts
@@ -20,8 +20,7 @@
 import { GeneralConfiguration, LimitsConfiguration } from "../../util/config/types";
 import { DmChannelDTO } from "../../util/dtos";
 // TODO: remove entity imports
-import { Application, BackupCode, Categories, Channel, Guild, Invite, Member, Message, Role, Template, Webhook } from "@spacebar/database";
-import { GuildVoiceRegion } from "./GuildVoiceRegionsResponse";
+import { Application, BackupCode, Categories, Channel, Guild, Invite, Member, Message, Template, Webhook } from "@spacebar/database";
 import { GuildCreateResponse, PrivateUser, PublicMember, PublicUser } from "@spacebar/schemas";
 
 // TODO: remove this entire file!
@@ -54,7 +53,6 @@ export interface APIGuildWithJoinedAt extends GuildCreateResponse {
     joined_at: string;
 }
 
-export type APIRoleArray = Role[];
 export type APITemplateArray = Template[];
 export type APILimitsConfiguration = LimitsConfiguration;