refactor(helpers): separate functions into files (#667)

* refactor(helpers): separate functions into files

* idk

* idk

src/helpers/roles/add_role.ts

@@ -0,0 +1,34 @@
+import { botID } from "../../bot.ts";
+import { RequestManager } from "../../rest/request_manager.ts";
+import { Errors } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import {
+  isHigherPosition,
+  requireBotGuildPermissions,
+} from "../../util/permissions.ts";
+
+/** Add a role to the member */
+export async function addRole(
+  guildID: string,
+  memberID: string,
+  roleID: string,
+  reason?: string,
+) {
+  const isHigherRolePosition = await isHigherPosition(
+    guildID,
+    botID,
+    roleID,
+  );
+  if (!isHigherRolePosition) {
+    throw new Error(Errors.BOTS_HIGHEST_ROLE_TOO_LOW);
+  }
+
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.put(
+    endpoints.GUILD_MEMBER_ROLE(guildID, memberID, roleID),
+    { reason },
+  );
+
+  return result;
+}

src/helpers/roles/create_role.ts

@@ -0,0 +1,31 @@
+import { cacheHandlers } from "../../cache.ts";
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { CreateRoleOptions, RoleData } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import {
+  calculateBits,
+  requireBotGuildPermissions,
+} from "../../util/permissions.ts";
+
+/** Create a new role for the guild. Requires the MANAGE_ROLES permission. */
+export async function createRole(
+  guildID: string,
+  options: CreateRoleOptions,
+  reason?: string,
+) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.post(endpoints.GUILD_ROLES(guildID), {
+    ...options,
+    permissions: calculateBits(options?.permissions || []),
+    reason,
+  });
+
+  const roleData = result as RoleData;
+  const role = await structures.createRoleStruct(roleData);
+  const guild = await cacheHandlers.get("guilds", guildID);
+  guild?.roles.set(role.id, role);
+
+  return role;
+}

src/helpers/roles/delete_role.ts

@@ -0,0 +1,12 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/** Delete a guild role. Requires the MANAGE_ROLES permission. */
+export async function deleteRole(guildID: string, id: string) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.delete(endpoints.GUILD_ROLE(guildID, id));
+
+  return result;
+}

src/helpers/roles/edit_role.ts

@@ -0,0 +1,25 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { CreateRoleOptions } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import {
+  calculateBits,
+  requireBotGuildPermissions,
+} from "../../util/permissions.ts";
+
+/** Edit a guild role. Requires the MANAGE_ROLES permission. */
+export async function editRole(
+  guildID: string,
+  id: string,
+  options: CreateRoleOptions,
+) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.patch(endpoints.GUILD_ROLE(guildID, id), {
+    ...options,
+    permissions: options.permissions
+      ? calculateBits(options.permissions)
+      : undefined,
+  });
+
+  return result;
+}

src/helpers/roles/get_roles.ts

@@ -0,0 +1,15 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/** Returns a list of role objects for the guild.
+ *
+ * ⚠️ **If you need this, you are probably doing something wrong. This is not intended for use. Your roles will be cached in your guild.**
+ */
+export async function getRoles(guildID: string) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.get(endpoints.GUILD_ROLES(guildID));
+
+  return result;
+}

src/helpers/roles/remove_role.ts

@@ -0,0 +1,36 @@
+import { botID } from "../../bot.ts";
+import { RequestManager } from "../../rest/request_manager.ts";
+import { Errors } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import {
+  isHigherPosition,
+  requireBotGuildPermissions,
+} from "../../util/permissions.ts";
+
+/** Remove a role from the member */
+export async function removeRole(
+  guildID: string,
+  memberID: string,
+  roleID: string,
+  reason?: string,
+) {
+  const isHigherRolePosition = await isHigherPosition(
+    guildID,
+    botID,
+    roleID,
+  );
+  if (
+    !isHigherRolePosition
+  ) {
+    throw new Error(Errors.BOTS_HIGHEST_ROLE_TOO_LOW);
+  }
+
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.delete(
+    endpoints.GUILD_MEMBER_ROLE(guildID, memberID, roleID),
+    { reason },
+  );
+
+  return result;
+}

src/helpers/roles/swap_roles.ts

@@ -0,0 +1,16 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { PositionSwap } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/** Modify the positions of a set of role objects for the guild. Requires the MANAGE_ROLES permission. */
+export async function swapRoles(guildID: string, rolePositons: PositionSwap) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_ROLES"]);
+
+  const result = await RequestManager.patch(
+    endpoints.GUILD_ROLES(guildID),
+    rolePositons,
+  );
+
+  return result;
+}