feat: managed roles and bot default permissions

package.json

@@ -31,7 +31,7 @@
     "@vladfrangu/async_event_emitter": "^2.4.7",
     "json-with-bigint": "^3.4.4",
     "solid-js": "^1.9.14",
-    "stoat-api": "0.15.3",
+    "stoat-api": "0.16.0",
     "ulid": "^3.0.2"
   },
   "devDependencies": {

src/classes/Bot.ts

@@ -124,6 +124,13 @@ export class Bot {
     return this.#collection.getUnderlyingObject(this.id).flags;
   }
 
+  /**
+   * Bot default permissions
+   */
+  get defaultPermissions(): number | undefined {
+    return this.#collection.getUnderlyingObject(this.id).defaultPermissions;
+  }
+
   /**
    * Instantiate `PublicBot` class from this bot
    */
@@ -132,6 +139,10 @@ export class Bot {
       _id: this.id,
       username: this.user?.username ?? "",
       avatar: this.user?.avatar?.id,
+      default_permissions:
+        this.defaultPermissions !== undefined
+          ? Number(this.defaultPermissions)
+          : undefined,
     });
   }
 

src/classes/PublicBot.ts

@@ -16,6 +16,10 @@ export class PublicBot {
   readonly username: string;
   readonly avatar?: File;
   readonly description?: string;
+  /**
+   * Permissions the bot asks for (0n when unset or the instance doesn't send them)
+   */
+  readonly defaultPermissions: bigint;
 
   /**
    * Construct Public Bot
@@ -33,15 +37,20 @@ export class PublicBot {
         } as APIFile)
       : undefined;
     this.description = data.description!;
+
+    const requested = data.default_permissions as number | null | undefined;
+    this.defaultPermissions = requested != null ? BigInt(requested) : 0n;
   }
 
   /**
    * Add the bot to a server
    * @param server Server
+   * @param permissions Permissions to grant the bot (requires Manage Roles)
    */
-  addToServer(server: Server | string): void {
+  addToServer(server: Server | string, permissions?: bigint): void {
     this.#client.api.post(`/bots/${this.id as ""}/invite`, {
       server: server instanceof Server ? server.id : server,
+      permissions: permissions ? Number(permissions) : undefined,
     });
   }
 

src/classes/ServerRole.ts

@@ -21,6 +21,7 @@ export class ServerRole {
   readonly colour?: string;
   readonly hoist: boolean;
   readonly rank: number;
+  readonly owner: string;
 
   /**
    * Construct server role
@@ -43,6 +44,7 @@ export class ServerRole {
     this.colour = data.colour ?? undefined;
     this.hoist = data.hoist || false;
     this.rank = data.rank ?? 0;
+    this.owner = data.owner ?? "";
   }
 
   /**

src/hydration/bot.ts

@@ -13,6 +13,7 @@ export type HydratedBot = {
   termsOfServiceUrl?: string;
   privacyPolicyUrl?: string;
   flags: BotFlags;
+  defaultPermissions?: number;
 };
 
 export const botHydration: Hydrate<APIBot, HydratedBot> = {
@@ -22,6 +23,7 @@ export const botHydration: Hydrate<APIBot, HydratedBot> = {
     interactions_url: "interactionsUrl",
     terms_of_service_url: "termsOfServiceUrl",
     privacy_policy_url: "privacyPolicyUrl",
+    default_permissions: "defaultPermissions",
   },
   functions: {
     id: (bot) => bot._id,
@@ -34,6 +36,7 @@ export const botHydration: Hydrate<APIBot, HydratedBot> = {
     termsOfServiceUrl: (bot) => bot.terms_of_service_url!,
     privacyPolicyUrl: (bot) => bot.privacy_policy_url!,
     flags: (bot) => bot.flags!,
+    defaultPermissions: (bot) => bot.default_permissions!,
   },
   initialHydration: () => ({}),
 };