disgroove 1.0.8 → 1.1.0

package/README.md

@@ -27,26 +27,59 @@ const client = new Client("token", {
 ### Example
 
 ```js
-const { Client, GatewayIntents, GatewayEvents } = require("disgroove");
+const {
+  Client,
+  GatewayIntents,
+  GatewayEvents,
+  ActivityType,
+  StatusTypes,
+  InteractionType,
+  InteractionCallbackType,
+  MessageFlags,
+} = require("disgroove");
 const client = new Client("token", {
   intents: GatewayIntents.All,
 });
 
 client.on(GatewayEvents.Ready, async () => {
-  const user = await client.getUser();
+  const user = await client.getUser(); // Get the bot user
 
-  console.log(`${user.username} is ready`);
+  console.log(`${user.username} is now online!`); // Print "Username is now online!" when the bot connects to the gateway
+
+  const application = await client.getApplication(); // Get the bot application
+
+  await application.createGlobalApplicationCommand({
+    name: "ping",
+    description: "Reply with Pong! �",
+  }); // Create a global application command named "ping"
+
+  client.updatePresence({
+    activities: [
+      {
+        name: "/ping",
+        type: ActivityType.Watching,
+        createdAt: Date.now(),
+      },
+    ],
+    status: StatusTypes.Online,
+    afk: false,
+  }); // Update the bot presence to "Watching /ping"
 });
 
-client.on(GatewayEvents.MessageCreate, async (message) => {
-  if (message.content === "!ping") {
-    const channel = await client.getChannel(message.channelId);
+client.on(GatewayEvents.InteractionCreate, async (interaction) => {
+  if (interaction.type !== InteractionType.ApplicationCommand) return; // Check if the interaction is an application command
 
-    await channel.createMessage({
-      content: "Pong! �",
-    });
+  if (interaction.data.name === "ping") {
+    // Check if the application command name is equals to "ping"
+    await interaction.createResponse({
+      type: InteractionCallbackType.ChannelMessageWithSource,
+      data: {
+        content: "Pong! �",
+        flags: MessageFlags.Ephemeral,
+      },
+    }); // Reply with an ephemeral message "Pong! �"
   }
 });
 
-client.connect();
+client.connect(); // Connect the bot to the gateway
 ```

package/dist/{class/Client.d.ts → Client.d.ts}

@@ -1,12 +1,18 @@
 /// <reference types="node" />
 import WebSocket from "ws";
-import { type DefaultMessageNotificationLevel, type ExplicitContentFilterLevel, GatewayEvents, GatewayIntents, type GuildFeatures, type OAuth2Scopes, type PrivacyLevel, type StatusTypes, type SystemChannelFlags, type VerificationLevel } from "../utils";
-import { REST } from "../rest";
-import { Application, AutoModerationRule, Channel, Guild, GuildMember, GuildScheduledEvent, Integration, Interaction, Invite, Message, StageInstance, User } from "../structures";
-import type { JSONActivity, JSONAuditLogEntry, JSONAutoModerationActionExectionEventFields, JSONAutoModerationRule, JSONChannel, JSONChannelPinsUpdateEventFields, JSONGuildApplicationCommandPermissions, JSONGuildBanAddEventFields, JSONGuildBanRemoveEventFields, JSONGuildDeleteEventFields, JSONGuildEmojisUpdateEventFields, JSONGuildIntegrationsUpdateEventFields, JSONGuildMemberRemoveEventFields, JSONGuildMemberUpdateEventFields, JSONGuildMembersChunkEventFields, JSONGuildRoleCreateEventFields, JSONGuildRoleDeleteEventFields, JSONGuildRoleUpdateEventFields, JSONGuildScheduledEvent, JSONGuildScheduledEventUserAddEventFields, JSONGuildScheduledEventUserRemoveEventFields, JSONGuildStickersUpdateEventFields, JSONIntegrationDeleteEventFields, JSONInvite, JSONInviteCreateEventFields, JSONInviteDeleteEventFields, JSONMessageDeleteBulkEventFields, JSONMessageDeleteEventFields, JSONMessageReactionAddEventFields, JSONMessageReactionRemoveAllEventFields, JSONMessageReactionRemoveEmojiEventFields, JSONMessageReactionRemoveEventFields, JSONPresenceUpdateEventFields, JSONRole, JSONStageInstance, JSONStickerPack, JSONThreadListSyncEventFields, JSONThreadMember, JSONThreadMembersUpdateEventFields, JSONTypingStartEventFields, JSONVoiceRegion, JSONVoiceServerUpdateEventFields, JSONVoiceState, JSONWebhooksUpdateEventFields } from "../types";
+import { type DefaultMessageNotificationLevel, type ExplicitContentFilterLevel, GatewayEvents, GatewayIntents, type GuildFeatures, type OAuth2Scopes, type PrivacyLevel, StatusTypes, type SystemChannelFlags, type VerificationLevel } from "./utils";
+import { REST } from "./rest";
+import { Application, AutoModerationRule, Channel, Guild, GuildMember, GuildScheduledEvent, Integration, Interaction, Invite, Message, StageInstance, User } from "./structures";
+import type { JSONActivity, JSONAuditLogEntry, JSONAutoModerationActionExectionEventFields, JSONAutoModerationRule, JSONChannel, JSONChannelPinsUpdateEventFields, JSONGuildApplicationCommandPermissions, JSONGuildBanAddEventFields, JSONGuildBanRemoveEventFields, JSONGuildDeleteEventFields, JSONGuildEmojisUpdateEventFields, JSONGuildIntegrationsUpdateEventFields, JSONGuildMemberRemoveEventFields, JSONGuildMemberUpdateEventFields, JSONGuildMembersChunkEventFields, JSONGuildRoleCreateEventFields, JSONGuildRoleDeleteEventFields, JSONGuildRoleUpdateEventFields, JSONGuildScheduledEvent, JSONGuildScheduledEventUserAddEventFields, JSONGuildScheduledEventUserRemoveEventFields, JSONGuildStickersUpdateEventFields, JSONIntegrationDeleteEventFields, JSONInvite, JSONInviteCreateEventFields, JSONInviteDeleteEventFields, JSONMessageDeleteBulkEventFields, JSONMessageDeleteEventFields, JSONMessageReactionAddEventFields, JSONMessageReactionRemoveAllEventFields, JSONMessageReactionRemoveEmojiEventFields, JSONMessageReactionRemoveEventFields, JSONPresenceUpdateEventFields, JSONRole, JSONStageInstance, JSONStickerPack, JSONThreadListSyncEventFields, JSONThreadMember, JSONThreadMembersUpdateEventFields, JSONTypingStartEventFields, JSONVoiceRegion, JSONVoiceServerUpdateEventFields, JSONVoiceState, JSONWebhooksUpdateEventFields } from "./types";
 import EventEmitter from "node:events";
 export interface ClientOptions {
     intents?: GatewayIntents | number;
+    auth?: "Bot" | "Bearer";
+    presence?: {
+        activities: Array<JSONActivity>;
+        status: StatusTypes;
+        afk: boolean;
+    };
 }
 export declare interface Client extends EventEmitter {
     on(event: GatewayEvents.Hello, listener: (listener: {
@@ -78,14 +84,23 @@ export declare interface Client extends EventEmitter {
     on(event: GatewayEvents.StageInstanceDelete, listener: (listener: JSONStageInstance) => void): this;
 }
 export declare class Client extends EventEmitter {
-    private heartbeatInterval?;
+    private heartbeatInterval;
     token: string;
     intents: GatewayIntents | number;
+    auth: "Bot" | "Bearer";
+    presence?: {
+        activities: Array<JSONActivity>;
+        status: StatusTypes;
+        afk: boolean;
+    };
     rest: REST;
     ws: WebSocket;
     constructor(token: string, options?: ClientOptions);
+    /** https://discord.com/developers/docs/resources/application#get-current-application */
     getApplication(): Promise<Application>;
+    /** https://discord.com/developers/docs/resources/channel#get-channel */
     getChannel(channelId: string): Promise<Channel>;
+    /** https://discord.com/developers/docs/resources/guild#create-guild */
     createGuild(options: {
         name: string;
         region?: string | null;
@@ -100,30 +115,39 @@ export declare class Client extends EventEmitter {
         systemChannelId?: string;
         systemChannelFlags?: SystemChannelFlags;
     }): Promise<Guild>;
+    /** https://discord.com/developers/docs/resources/guild#get-guild */
     getGuild(guildId: string, options?: {
         withCounts?: boolean;
     }): Promise<Guild>;
+    /** https://discord.com/developers/docs/resources/guild-template#create-guild-from-guild-template */
     createGuildFromTemplate(code: string, options: {
         name: string;
         icon?: string;
     }): Promise<Guild>;
+    /** https://discord.com/developers/docs/resources/invite#get-invite */
     getInvite(code: string, options?: {
         withCounts?: boolean;
         withExpiration?: boolean;
         guildScheduledEventId?: string;
     }): Promise<Invite>;
+    /** https://discord.com/developers/docs/resources/invite#delete-invite */
     deleteInvite(code: string, reason?: string): Promise<JSONInvite>;
+    /** https://discord.com/developers/docs/resources/stage-instance#create-stage-instance */
     createStageInstance(options: {
         channelId: string;
         topic: string;
         privacyLevel?: PrivacyLevel;
         sendStartNotifications?: boolean;
     }, reason?: string): Promise<StageInstance>;
+    /** https://discord.com/developers/docs/resources/stage-instance#get-stage-instance */
     getStageInstance(channelId: string): Promise<StageInstance>;
+    /** https://discord.com/developers/docs/resources/sticker#list-nitro-sticker-packs */
     listNitroStickerPacks(): Promise<{
         stickerPacks: Array<JSONStickerPack>;
     }>;
+    /** https://discord.com/developers/docs/resources/user#get-user */
     getUser(userId?: string): Promise<User>;
+    /** https://discord.com/developers/docs/resources/user#get-current-user-guilds */
     getGuilds(options?: {
         before?: string;
         after?: string;
@@ -139,10 +163,13 @@ export declare class Client extends EventEmitter {
         approximate_member_count: number;
         approximate_presence_count: number;
     }>>;
+    /** https://discord.com/developers/docs/resources/voice#list-voice-regions */
     listVoiceRegions(): Promise<Array<JSONVoiceRegion>>;
+    /** https://discord.com/developers/docs/topics/gateway#get-gateway */
     getGateway(): Promise<{
         url: string;
     }>;
+    /** https://discord.com/developers/docs/topics/gateway#get-gateway-bot */
     getGatewayBot(): Promise<{
         url: string;
         shards: number;
@@ -153,18 +180,26 @@ export declare class Client extends EventEmitter {
             maxConcurrency: number;
         };
     }>;
+    /** https://discord.com/developers/docs/topics/gateway-events#update-presence */
     updatePresence(options: {
-        since: number | null;
         activities: Array<JSONActivity>;
         status: StatusTypes;
         afk: boolean;
     }): void;
+    /** https://discord.com/developers/docs/topics/oauth2#get-current-bot-application-information */
     getOAuth2Application(): Promise<Application>;
+    /** https://discord.com/developers/docs/topics/oauth2#get-current-authorization-information */
     getOAuth2Authorization(): Promise<{
         application: Application;
         scopes: Array<OAuth2Scopes>;
         expires: number;
         user?: User;
     }>;
+    /** https://discord.com/developers/docs/topics/gateway#connections */
     connect(): void;
+    disconnect(): void;
+    private onWebSocketOpen;
+    private onWebSocketMessage;
+    private onWebSocketError;
+    private onWebSocketClose;
 }