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

* refactor(helpers): separate functions into files

* idk

* idk

src/helpers/templates/create_guild_from_template.ts

@@ -0,0 +1,34 @@
+import { cacheHandlers } from "../../cache.ts";
+import { RequestManager } from "../../rest/request_manager.ts";
+import {
+  CreateGuildFromTemplate,
+  CreateGuildPayload,
+} from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { urlToBase64 } from "../../util/utils.ts";
+
+/**
+ * Create a new guild based on a template
+ * NOTE: This endpoint can be used only by bots in less than 10 guilds.
+ */
+export async function createGuildFromTemplate(
+  templateCode: string,
+  data: CreateGuildFromTemplate,
+) {
+  if ((await cacheHandlers.size("guilds")) >= 10) {
+    throw new Error(
+      "This function can only be used by bots in less than 10 guilds.",
+    );
+  }
+
+  if (data.icon) {
+    data.icon = await urlToBase64(data.icon);
+  }
+
+  const result = await await RequestManager.post(
+    endpoints.GUILD_TEMPLATE(templateCode),
+    data,
+  );
+
+  return result as CreateGuildPayload;
+}

src/helpers/templates/create_guild_template.ts

@@ -0,0 +1,33 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { CreateGuildTemplate, GuildTemplate } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/**
+ * Creates a template for the guild.
+ * Requires the `MANAGE_GUILD` permission.
+ * @param name name of the template (1-100 characters)
+ * @param description description for the template (0-120 characters
+ */
+export async function createGuildTemplate(
+  guildID: string,
+  data: CreateGuildTemplate,
+) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_GUILD"]);
+
+  if (data.name.length < 1 || data.name.length > 100) {
+    throw new Error("The name can only be in between 1-100 characters.");
+  }
+
+  if (data.description?.length && data.description.length > 120) {
+    throw new Error("The description can only be in between 0-120 characters.");
+  }
+
+  const template = (await RequestManager.post(
+    endpoints.GUILD_TEMPLATES(guildID),
+    data,
+  )) as GuildTemplate;
+
+  return structures.createTemplateStruct(template);
+}

src/helpers/templates/delete_guild_template.ts

@@ -0,0 +1,22 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { GuildTemplate } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/**
+ * Deletes a template from a guild.
+ * Requires the `MANAGE_GUILD` permission.
+ */
+export async function deleteGuildTemplate(
+  guildID: string,
+  templateCode: string,
+) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_GUILD"]);
+
+  const deletedTemplate = (await RequestManager.delete(
+    `${endpoints.GUILD_TEMPLATES(guildID)}/${templateCode}`,
+  )) as GuildTemplate;
+
+  return structures.createTemplateStruct(deletedTemplate);
+}

src/helpers/templates/edit_guild_template.ts

@@ -0,0 +1,32 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { EditGuildTemplate, GuildTemplate } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/**
+ * Edit a template's metadata.
+ * Requires the `MANAGE_GUILD` permission.
+ */
+export async function editGuildTemplate(
+  guildID: string,
+  templateCode: string,
+  data: EditGuildTemplate,
+) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_GUILD"]);
+
+  if (data.name?.length && (data.name.length < 1 || data.name.length > 100)) {
+    throw new Error("The name can only be in between 1-100 characters.");
+  }
+
+  if (data.description?.length && data.description.length > 120) {
+    throw new Error("The description can only be in between 0-120 characters.");
+  }
+
+  const template = (await RequestManager.patch(
+    `${endpoints.GUILD_TEMPLATES(guildID)}/${templateCode}`,
+    data,
+  )) as GuildTemplate;
+
+  return structures.createTemplateStruct(template);
+}

src/helpers/templates/get_guild_templates.ts

@@ -0,0 +1,19 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { GuildTemplate } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/**
+ * Returns an array of templates.
+ * Requires the `MANAGE_GUILD` permission.
+ */
+export async function getGuildTemplates(guildID: string) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_GUILD"]);
+
+  const templates = (await RequestManager.get(
+    endpoints.GUILD_TEMPLATES(guildID),
+  )) as GuildTemplate[];
+
+  return templates.map((template) => structures.createTemplateStruct(template));
+}

src/helpers/templates/get_template.ts

@@ -0,0 +1,14 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { GuildTemplate } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+
+/** Returns the guild template if it exists */
+export async function getTemplate(templateCode: string) {
+  const result = (await RequestManager.get(
+    endpoints.GUILD_TEMPLATE(templateCode),
+  ) as GuildTemplate);
+  const template = await structures.createTemplateStruct(result);
+
+  return template;
+}

src/helpers/templates/sync_guild_template.ts

@@ -0,0 +1,19 @@
+import { RequestManager } from "../../rest/request_manager.ts";
+import { structures } from "../../structures/mod.ts";
+import { GuildTemplate } from "../../types/mod.ts";
+import { endpoints } from "../../util/constants.ts";
+import { requireBotGuildPermissions } from "../../util/permissions.ts";
+
+/**
+ * Syncs the template to the guild's current state.
+ * Requires the `MANAGE_GUILD` permission.
+ */
+export async function syncGuildTemplate(guildID: string, templateCode: string) {
+  await requireBotGuildPermissions(guildID, ["MANAGE_GUILD"]);
+
+  const template = (await RequestManager.put(
+    `${endpoints.GUILD_TEMPLATES(guildID)}/${templateCode}`,
+  )) as GuildTemplate;
+
+  return structures.createTemplateStruct(template);
+}