disgroove 1.3.1 → 1.3.3-dev.1

package/lib/index.ts

@@ -0,0 +1,7 @@
+export * from "./gateway";
+export * from "./rest";
+export * from "./structures";
+export * from "./types";
+export * from "./utils";
+export * from "./Client";
+export * from "./constants";

package/lib/rest/CDN.ts

@@ -0,0 +1,56 @@
+export const achievementIcon = (
+  applicationId: string,
+  achievementId: string,
+  iconHash: string
+) =>
+  `app-assets/${applicationId}/achievements/${achievementId}/icons/${iconHash}.png` as const;
+export const applicationAsset = (applicationId: string, assetId: string) =>
+  `app-assets/${applicationId}/${assetId}.png` as const;
+export const applicationCover = (applicationId: string, coverImage: string) =>
+  `app-icons/${applicationId}/${coverImage}.png` as const;
+export const applicationIcon = (applicationId: string, icon: string) =>
+  `app-icons/${applicationId}/${icon}.png` as const;
+export const customEmoji = (emojiId: string) =>
+  `emojis/${emojiId}.png` as const;
+export const defaultUserAvatar = (index: string) =>
+  `embed/avatars/${index}.png` as const;
+export const guildBanner = (guildId: string, banner: string) =>
+  `banners/${guildId}/${banner}.png` as const;
+export const guildDiscoverySplash = (guildId: string, splash: string) =>
+  `discovery-splashes/${guildId}/${splash}.png` as const;
+export const guildIcon = (guildId: string, icon: string) =>
+  `icons/${guildId}/${icon}.png` as const;
+export const guildMemberAvatar = (
+  guildId: string,
+  userId: string,
+  avatar: string
+) => `guilds/${guildId}/users/${userId}/avatars/${avatar}.png` as const;
+export const guildMemberBanner = (
+  guildId: string,
+  userId: string,
+  banner: string
+) => `guilds/${guildId}/users/${userId}/banners/${banner}.png` as const;
+export const guildScheduledEventCover = (
+  scheduledEventId: string,
+  coverImage: string
+) => `guild-events/${scheduledEventId}/${coverImage}.png` as const;
+export const guildSplash = (guildId: string, splash: string) =>
+  `splashes/${guildId}/${splash}.png` as const;
+export const roleIcon = (roleId: string, icon: string) =>
+  `role-icons/${roleId}/${icon}.png` as const;
+export const stickerPackBanner = (assetId: string) =>
+  `app-assets/710982414301790216/store/${assetId}.png` as const;
+export const sticker = (stickerId: string) =>
+  `stickers/${stickerId}.png` as const;
+export const storePageAsset = (applicationId: string, assetId: string) =>
+  `app-assets/${applicationId}/store/${assetId}` as const;
+export const teamIcon = (teamId: string, icon: string) =>
+  `team-icons/${teamId}/${icon}.png` as const;
+export const userAvatar = (userId: string, avatar: string) =>
+  `avatars/${userId}/${avatar}.png` as const;
+export const userAvatarDecoration = (
+  userId: string,
+  avatarDecoration: string
+) => `avatar-decorations/${userId}/${avatarDecoration}.png` as const;
+export const userBanner = (userId: string, banner: string) =>
+  `banners/${userId}/${banner}.png` as const;

package/lib/rest/Endpoints.ts

@@ -0,0 +1,241 @@
+// Guilds
+export const guild = (guildId: string) => `guilds/${guildId}` as const;
+export const guilds = () => "guilds" as const;
+export const guildActiveThreads = (guildId: string) =>
+  `guilds/${guildId}/threads/active` as const;
+export const guildAuditLog = (guildId: string) =>
+  `guilds/${guildId}/audit-logs` as const;
+export const guildAutoModerationRule = (guildId: string, ruleId: string) =>
+  `guilds/${guildId}/auto-moderation/rules/${ruleId}` as const;
+export const guildAutoModerationRules = (guildId: string) =>
+  `guilds/${guildId}/auto-moderation/rules` as const;
+export const guildBan = (guildId: string, userId: string) =>
+  `guilds/${guildId}/bans/${userId}` as const;
+export const guildBans = (guildId: string) => `guilds/${guildId}/bans` as const;
+export const guildChannels = (guildId: string) =>
+  `guilds/${guildId}/channels` as const;
+export const guildCurrentMemberNickname = (guildId: string) =>
+  `guilds/${guildId}/members/@me/nick` as const;
+export const guildEmoji = (guildId: string, emojiId: string) =>
+  `guilds/${guildId}/emojis/${emojiId}` as const;
+export const guildEmojis = (guildId: string) =>
+  `guilds/${guildId}/emojis` as const;
+export const guildIntegration = (guildId: string, integrationId: string) =>
+  `guilds/${guildId}/integrations/${integrationId}` as const;
+export const guildIntegrations = (guildId: string) =>
+  `guilds/${guildId}/integrations` as const;
+export const guildInvites = (guildId: string) =>
+  `guilds/${guildId}/invites` as const;
+export const guildMFA = (guildId: string) => `guilds/${guildId}/mfa` as const;
+export const guildMember = (guildId: string, userId: string | "@me" = "@me") =>
+  `guilds/${guildId}/members/${userId}` as const;
+export const guildMemberRole = (
+  guildId: string,
+  memberId: string,
+  roleId: string
+) => `guilds/${guildId}/members/${memberId}/roles/${roleId}` as const;
+export const guildMembers = (guildId: string) =>
+  `guilds/${guildId}/members` as const;
+export const guildMembersSearch = (guildId: string) =>
+  `guilds/${guildId}/members/search` as const;
+export const guildMemberVerification = (guildId: string) =>
+  `guilds/${guildId}/member-verification` as const;
+export const guildOnboarding = (guildId: string) =>
+  `guilds/${guildId}/onboarding` as const;
+export const guildPreview = (guildId: string) =>
+  `guilds/${guildId}/preview` as const;
+export const guildPrune = (guildId: string) =>
+  `guilds/${guildId}/prune` as const;
+export const guildRole = (guildId: string, roleId: string) =>
+  `guilds/${guildId}/roles/${roleId}` as const;
+export const guildRoles = (guildId: string) =>
+  `guilds/${guildId}/roles` as const;
+export const guildScheduledEvent = (
+  guildId: string,
+  guildScheduledEventId: string
+) => `guilds/${guildId}/scheduled-events/${guildScheduledEventId}` as const;
+export const guildScheduledEvents = (guildId: string) =>
+  `guilds/${guildId}/scheduled-events` as const;
+export const guildScheduledEventUsers = (
+  guildId: string,
+  guildScheduledEventId: string
+) =>
+  `guilds/${guildId}/scheduled-events/${guildScheduledEventId}/users` as const;
+export const guildSticker = (guildId: string, stickerId: string) =>
+  `guilds/${guildId}/stickers/${stickerId}` as const;
+export const guildStickers = (guildId: string) =>
+  `guilds/${guildId}/stickers` as const;
+export const guildTemplate = (guildId: string, code: string) =>
+  `guilds/${guildId}/templates/${code}` as const;
+export const guildTemplates = (guildId: string) =>
+  `guilds/${guildId}/templates` as const;
+export const guildVanityURL = (guildId: string) =>
+  `guilds/${guildId}/vanity-url` as const;
+export const guildVoiceRegions = (guildId: string) =>
+  `guilds/${guildId}/regions` as const;
+export const guildVoiceState = (
+  guildId: string,
+  userId: string | "@me" = "@me"
+) => `guilds/${guildId}/voice-states/${userId}` as const;
+export const guildWebhooks = (guildId: string) =>
+  `guilds/${guildId}/webhooks` as const;
+export const guildWelcomeScreen = (guildId: string) =>
+  `guilds/${guildId}/welcome-screen` as const;
+export const guildWidgetImage = (guildId: string) =>
+  `guilds/${guildId}/widget.png` as const;
+
+export const guildWidgetJSON = (guildId: string) =>
+  `guilds/${guildId}/widget.json` as const;
+export const guildWidgetSettings = (guildId: string) =>
+  `guilds/${guildId}/widget` as const;
+export const template = (code: string) => `guilds/templates/${code}` as const;
+
+// Channels
+export const channel = (channelId: string) => `channels/${channelId}` as const;
+export const channelBulkDelete = (channelId: string) =>
+  `channels/${channelId}/messages/bulk-delete` as const;
+export const channelFollowers = (channelId: string) =>
+  `channels/${channelId}/followers` as const;
+export const channelInvites = (channelId: string) =>
+  `channels/${channelId}/invites` as const;
+export const channelMessage = (channelId: string, messageId: string) =>
+  `channels/${channelId}/messages/${messageId}` as const;
+export const channelMessageAllReactions = (
+  channelId: string,
+  messageId: string,
+  emoji?: string
+) =>
+  emoji
+    ? (`channels/${channelId}/messages/${messageId}/reactions/${emoji}` as const)
+    : (`channels/${channelId}/messages/${messageId}/reactions` as const);
+export const channelMessageCrosspost = (channelId: string, messageId: string) =>
+  `channels/${channelId}/messages/${messageId}/crosspost` as const;
+export const channelMessageReaction = (
+  channelId: string,
+  messageId: string,
+  emoji: string,
+  userId: string | "@me" = "@me"
+) =>
+  `channels/${channelId}/messages/${messageId}/reactions/${emoji}/${userId}` as const;
+export const channelMessages = (channelId: string) =>
+  `channels/${channelId}/messages` as const;
+export const channelPermission = (channelId: string, overwriteId: string) =>
+  `channels/${channelId}/permissions/${overwriteId}` as const;
+export const channelPin = (channelId: string, messageId: string) =>
+  `channels/${channelId}/pins/${messageId}` as const;
+export const channelPins = (channelId: string) =>
+  `channels/${channelId}/pins` as const;
+export const channelRecipient = (channelId: string, userId: string) =>
+  `channels/${channelId}/recipients/${userId}` as const;
+export const channelThreads = (
+  channelId: string,
+  archivedStatus: "public" | "private",
+  joined: boolean
+) =>
+  joined
+    ? (`channels/${channelId}/users/@me/threads/archived/${archivedStatus}` as const)
+    : (`channels/${channelId}/threads/archived/${archivedStatus}` as const);
+export const channelTyping = (channelId: string) =>
+  `channels/${channelId}/typing` as const;
+export const channelWebhooks = (channelId: string) =>
+  `channels/${channelId}/webhooks` as const;
+export const threads = (channelId: string, messageId?: string) =>
+  messageId
+    ? (`channels/${channelId}/messages/${messageId}/threads` as const)
+    : (`channels/${channelId}/threads` as const);
+export const threadMembers = (threadId: string, userId?: string | "@me") =>
+  userId
+    ? (`channels/${threadId}/thread-members` as const)
+    : (`channels/${threadId}/thread-members/${userId}` as const);
+
+// Users
+export const user = (userId: string | "@me" = "@me") =>
+  `users/${userId}` as const;
+export const userApplicationRoleConnection = (applicationId: string) =>
+  `users/@me/applications/${applicationId}/role-connection` as const;
+export const userChannels = () => "users/@me/channels" as const;
+export const userConnections = () => "users/@me/connections" as const;
+export const userGuild = (guildId: string) =>
+  `users/@me/guilds/${guildId}` as const;
+export const userGuilds = () => "users/@me/guilds" as const;
+
+// Applications
+
+export const applicationCommand = (applicationId: string, commandId: string) =>
+  `applications/${applicationId}/commands/${commandId}` as const;
+export const applicationCommands = (applicationId: string) =>
+  `applications/${applicationId}/commands` as const;
+export const applicationCommandPermissions = (
+  applicationId: string,
+  guildId: string,
+  commandId: string
+) =>
+  `applications/${applicationId}/guilds/${guildId}/commands/${commandId}/permissions` as const;
+export const applicationCurrentUser = () => "applications/@me" as const;
+export const applicationEntitlement = (
+  applicationId: string,
+  entitlementId: string
+) => `applications/${applicationId}/entitlements/${entitlementId}` as const;
+export const applicationEntitlements = (applicationId: string) =>
+  `applications/${applicationId}/entitlements` as const;
+export const applicationGuildCommand = (
+  applicationId: string,
+  guildId: string,
+  commandId: string
+) =>
+  `applications/${applicationId}/guilds/${guildId}/commands/${commandId}` as const;
+export const applicationGuildCommands = (
+  applicationId: string,
+  guildId: string
+) => `applications/${applicationId}/guilds/${guildId}/commands` as const;
+export const applicationRoleConnectionMetadata = (applicationId: string) =>
+  `applications/${applicationId}/role-connections/metadata` as const;
+export const applicationSKUs = (applicationId: string) =>
+  `applications/${applicationId}/skus` as const;
+export const guildApplicationCommandsPermissions = (
+  applicationId: string,
+  guildId: string
+) =>
+  `applications/${applicationId}/guilds/${guildId}/commands/permissions` as const;
+
+// Webhooks
+export const webhook = (webhookId: string, webhookToken?: string) =>
+  webhookToken
+    ? (`webhooks/${webhookId}/${webhookToken}` as const)
+    : (`webhooks/${webhookId}` as const);
+export const webhookMessage = (
+  webhookId: string,
+  webhookToken: string,
+  messageId: string | "@original" = "@original"
+) => `webhooks/${webhookId}/${webhookToken}/messages/${messageId}` as const;
+export const webhookPlatform = (
+  webhookId: string,
+  webhookToken: string,
+  platform: "github" | "slack"
+) => `webhooks/${webhookId}/${webhookToken}/${platform}` as const;
+
+// Gateway
+export const gateway = () => "gateway" as const;
+export const gatewayBot = () => "gateway/bot" as const;
+
+// OAuth2
+export const oauth2Authorization = () => "oauth2/authorize" as const;
+
+export const oauth2CurrentApplication = () =>
+  `oauth2/applications/@me` as const;
+export const oauth2CurrentAuthorization = () => "oauth2/@me" as const;
+export const oauth2TokenExchange = () => "oauth2/token" as const;
+export const oauth2TokenRevocation = () => "oauth2/token/revoke" as const;
+
+// Misc
+export const interactionCallback = (
+  interactionId: string,
+  interactionToken: string
+) => `interactions/${interactionId}/${interactionToken}/callback` as const;
+export const invite = (code: string) => `invites/${code}` as const;
+export const stageInstance = (channelId: string) =>
+  `stage-instances/${channelId}` as const;
+export const stageInstances = () => "stage-instances" as const;
+export const sticker = (stickerId: string) => `stickers/${stickerId}` as const;
+export const stickerPacks = () => "sticker-packs" as const;
+export const voiceRegions = () => "voice/regions" as const;

package/lib/rest/REST.ts

@@ -0,0 +1,45 @@
+import { RequestData, RequestsManager } from ".";
+
+export interface File {
+  contents: Buffer;
+  name: string;
+}
+
+export enum RESTMethods {
+  Get = "GET",
+  Post = "POST",
+  Delete = "DELETE",
+  Patch = "PATCH",
+  Put = "PUT",
+}
+
+export class REST {
+  manager: RequestsManager;
+
+  constructor(token: string, auth: "Bot" | "Bearer") {
+    this.manager = new RequestsManager(token, auth);
+  }
+
+  get<T>(
+    endpoint: string,
+    data?: Pick<RequestData, "query" | "authorization">
+  ): Promise<T> {
+    return this.manager.request<T>(RESTMethods.Get, endpoint, data);
+  }
+
+  post<T>(endpoint: string, data?: RequestData): Promise<T> {
+    return this.manager.request<T>(RESTMethods.Post, endpoint, data);
+  }
+
+  delete<T>(endpoint: string, data?: RequestData): Promise<T> {
+    return this.manager.request<T>(RESTMethods.Delete, endpoint, data);
+  }
+
+  patch<T>(endpoint: string, data?: RequestData): Promise<T> {
+    return this.manager.request<T>(RESTMethods.Patch, endpoint, data);
+  }
+
+  put<T>(endpoint: string, data?: RequestData): Promise<T> {
+    return this.manager.request<T>(RESTMethods.Put, endpoint, data);
+  }
+}

package/lib/rest/RequestsManager.ts

@@ -0,0 +1,134 @@
+import { File, RESTMethods } from ".";
+import { fetch, FormData, File as UndiciFile } from "undici";
+import { HTTPResponseCodes } from "../constants";
+import { HTTPError, RESTError } from "../utils";
+import * as pkg from "../../package.json";
+
+export interface RequestData {
+  json?: unknown;
+  form?: FormData;
+  files?: Array<File> | null;
+  reason?: string;
+  query?: Partial<Record<string, string | number | boolean | Array<string>>>;
+  authorization?: boolean;
+}
+
+export class RequestsManager {
+  token: string;
+  auth: "Bot" | "Bearer";
+  globalBlock: boolean = false;
+
+  constructor(token: string, auth: "Bot" | "Bearer") {
+    this.token = token;
+    this.auth = auth;
+  }
+
+  request<T = unknown>(
+    method: RESTMethods,
+    endpoint: string,
+    data?: RequestData
+  ): Promise<T> {
+    return new Promise<T>(async (resolve, reject) => {
+      if (this.globalBlock && !endpoint.startsWith("interactions")) return;
+
+      let url: URL = new URL(`https://discord.com/api/v10/${endpoint}`);
+
+      if (data?.query)
+        for (const [key, value] of Object.entries(data.query))
+          if (value !== undefined) url.searchParams.set(key, String(value));
+
+      let headers: Record<string, string> = {
+        "User-Agent": `DiscordBot (https://github.com/XenKys/disgroove, ${pkg.version})`,
+        Authorization: `${this.auth} ${this.token}`,
+      };
+      let body: string | FormData | undefined;
+
+      if (data?.authorization === false) delete headers["Authorization"];
+
+      if (method !== RESTMethods.Get) {
+        if (data?.form || (data?.files && data?.files?.length !== 0)) {
+          const formData = data.form ?? new FormData();
+
+          if (data?.files && data?.files?.length !== 0) {
+            for (let i = 0; i < data?.files.length; i++) {
+              const file = data?.files[i];
+
+              formData?.set(
+                `files[${i}]`,
+                new UndiciFile([file.contents], file.name)
+              );
+            }
+
+            if (data?.json)
+              formData?.set("payload_json", JSON.stringify(data?.json));
+          }
+
+          body = formData;
+        } else {
+          body = JSON.stringify(data?.json);
+
+          headers["Content-Type"] = "application/json";
+        }
+
+        if (data?.reason !== undefined)
+          headers["X-Audit-Log-Reason"] = data?.reason;
+      }
+
+      try {
+        const response = await fetch(url.href, {
+          method,
+          body,
+          headers,
+        });
+
+        if (response.headers.has("X-RateLimit-Global")) {
+          this.globalBlock = true;
+
+          setTimeout(() => {
+            this.globalBlock = false;
+          }, Number(response.headers.get("Retry-After")) * 1000);
+        }
+
+        if (response.status >= HTTPResponseCodes.NotModified) {
+          if (response.status === HTTPResponseCodes.TooManyRequests) {
+            setTimeout(
+              () =>
+                this.request<T>(method, endpoint, data)
+                  .then(resolve)
+                  .catch(reject),
+              Number(response.headers.get("Retry-After")) * 1000
+            );
+          } else if (response.status === HTTPResponseCodes.GatewayUnavailable) {
+            setTimeout(
+              () =>
+                this.request<T>(method, endpoint, data)
+                  .then(resolve)
+                  .catch(reject),
+              5 * 1000
+            );
+          } else {
+            const responseJSON = await response.json();
+
+            reject(
+              responseJSON &&
+                typeof responseJSON === "object" &&
+                "code" in responseJSON &&
+                "message" in responseJSON &&
+                responseJSON.code !== 0
+                ? new RESTError(
+                    `[${responseJSON.code}] ${responseJSON.message}`
+                  )
+                : new HTTPError(`[${response.status}] ${response.statusText}`)
+            );
+          }
+        } else if (response.status === HTTPResponseCodes.NoContent) {
+          resolve(null as T);
+        } else {
+          resolve((await response.json()) as T);
+        }
+      } catch (err) {
+        reject(err);
+      }
+    });
+  }
+}

package/lib/rest/index.ts

@@ -0,0 +1,4 @@
+export * as CDN from "./CDN";
+export * as Endpoints from "./Endpoints";
+export * from "./RequestsManager";
+export * from "./REST";