revbot.js 0.0.7 → 0.0.8

package/README.md

@@ -3,7 +3,7 @@
 # Note: this package is currently in the early stages of development and testing
 
 `revbot.js` is a Node.js library for building bots on the Revolt platform. It provides an easy-to-use interface for interacting with Revolt's API, managing events, and handling various bot functionalities.
-[revolt server](https://rvlt.gg/7hG9csvW) [docs](https://jade3375.github.io/revbot.js/)
+[revolt server](https://rvlt.gg/2NcCgYZ0) [docs](https://jade3375.github.io/revbot.js/)
 
 ## Installation
 

package/dist/index.d.mts

@@ -73,23 +73,51 @@ declare class UUID extends null {
 }
 
 type BitFieldResolvable = BitField | number | string | BitFieldResolvable[];
+/**
+ * Represents a bitfield that can be used to manage flags or permissions.
+ */
 declare class BitField {
     static FLAGS: Record<string, number>;
     bitfield: number;
     constructor(bits?: BitFieldResolvable);
+    /**
+     * Resolves a bitfield or an array of bitfields into a single number.
+     * @param bit The bitfield or array of bitfields to resolve.
+     * @returns The resolved bitfield as a number.
+     */
     static resolve(bit: BitFieldResolvable): number;
+    /**
+     * Returns the class that this instance belongs to.
+     * @returns The class of the bitfield.
+     */
     get self(): {
         FLAGS: Record<string, number>;
         resolve(bit: BitFieldResolvable): number;
         new (bits?: BitFieldResolvable): BitField;
     };
+    /**
+     * Checks if any of the bits in the bitfield are set.
+     * @param bit The bitfield or array of bitfields to check.
+     * @returns True if any bits are set, false otherwise.
+     */
     any(bit: BitFieldResolvable): boolean;
+    /**
+     * checks if a specific permission is set.
+     */
     has(bit: BitFieldResolvable): boolean;
+    /**
+     * Returns an array of all the Permissions that are set in the bitfield.
+     * @returns An array of flag names.
+     */
     toArray(): string[];
     add(...bits: BitFieldResolvable[]): this;
     remove(...bits: BitFieldResolvable[]): this;
     freeze(): Readonly<this>;
     valueOf(): number;
+    /**
+     *
+     * @returns A record of all flags and their boolean values indicating whether they are set.
+     */
     serialize(): Record<string, boolean>;
     [Symbol.iterator](): Iterable<string>;
 }
@@ -465,6 +493,44 @@ declare class ServerPermissions extends BitField {
     constructor(bits?: ServerPermissionsResolvable);
     static resolve(bit: ServerPermissionsResolvable): number;
 }
+declare class FullPermissions extends BitField {
+    static readonly FLAGS: {
+        readonly ManageChannel: number;
+        readonly ManageServer: number;
+        readonly ManagePermissions: number;
+        readonly ManageRole: number;
+        readonly ManageCustomisation: number;
+        readonly KickMembers: number;
+        readonly BanMembers: number;
+        readonly TimeoutMembers: number;
+        readonly AssignRoles: number;
+        readonly ChangeNickname: number;
+        readonly ManageNicknames: number;
+        readonly ChangeAvatar: number;
+        readonly RemoveAvatars: number;
+        readonly ViewChannel: number;
+        readonly ReadMessageHistory: number;
+        readonly SendMessage: number;
+        readonly ManageMessages: number;
+        readonly ManageWebhooks: number;
+        readonly InviteOthers: number;
+        readonly SendEmbeds: number;
+        readonly UploadFiles: number;
+        readonly Masquerade: number;
+        readonly React: number;
+        readonly Connect: number;
+        readonly Speak: number;
+        readonly Video: number;
+        readonly MuteMembers: number;
+        readonly DeafenMembers: number;
+        readonly MoveMembers: number;
+        readonly MentionEveryone: number;
+        readonly MentionRoles: number;
+        readonly GrantAll: 4503599627370495;
+    };
+    constructor(bits?: number | string | FullPermissions | Array<number | string | FullPermissions>);
+    static resolve(bit: number | string | FullPermissions): number;
+}
 declare const DEFAULT_PERMISSION_DM: Readonly<ChannelPermissions>;
 
 type BadgeString = keyof typeof Badges.FLAGS;
@@ -840,7 +906,7 @@ declare class Server extends Base {
     /** Whether the server is marked as NSFW (Not Safe For Work). */
     nsfw: boolean;
     /** The default permissions for the server. */
-    permissions: ServerPermissions;
+    permissions: FullPermissions;
     /** The categories in the server. */
     categories: Map<string, Category>;
     /** the emojies associated with the server */
@@ -893,6 +959,55 @@ declare class Server extends Base {
     toString(): string;
 }
 
+/**
+ * Represents the permissions that can be set for a role.
+ */
+type editablePermissions = {
+    /**
+     * Permissions to allow for the role.
+     * Each key corresponds to a permission flag in FullPermissions.
+     */
+    a?: Array<keyof (typeof FullPermissions)["FLAGS"]>;
+    /**
+     * Permissions to deny for the role.
+     * Each key corresponds to a permission flag in FullPermissions.
+     */
+    d?: Array<keyof (typeof FullPermissions)["FLAGS"]>;
+};
+/**
+ * Represents a role that can be edited in a server.
+ */
+type editableRole = {
+    /**
+     * Name of the role.
+     */
+    name?: string;
+    /**
+     * Colour of the role, or `null` if no colour is set.
+     */
+    colour?: string | null;
+    /**
+     * Whether the role is displayed separately in the member list.
+     */
+    hoist?: boolean;
+    /**
+     * Rank of the role, used for ordering.
+     */
+    rank?: number;
+    /**
+     * Permissions to set for the role.
+     * Format: { a: allow, d: deny }
+     */
+    permissions?: editablePermissions;
+    /**
+     * Fields to remove from the role.
+     * Each key corresponds to a field in the Role type.
+     */
+    remove?: Array<keyof Role$1 & {
+        [key: string]: unknown;
+    }>;
+};
+
 /**
  * Represents a role in a server.
  *
@@ -960,6 +1075,7 @@ declare class Role extends Base {
      * ```
      */
     delete(): Promise<void>;
+    edit(data: editableRole): Promise<Role>;
     /**
      * Converts the role to a string representation.
      *
@@ -1532,8 +1648,8 @@ type APIServerChannel$1 = Extract<Channel$1, {
     channel_type: "TextChannel" | "VoiceChannel";
 }>;
 interface Overwrite {
-    allow: ChannelPermissions;
-    deny: ChannelPermissions;
+    allow: FullPermissions;
+    deny: FullPermissions;
 }
 /**
  * Represents a server channel, which can be a text or voice channel.
@@ -2397,6 +2513,20 @@ declare class RoleManager extends BaseManager<Role, Role$1 & {
      * @returns A promise that resolves when the role is deleted
      */
     delete(role: RoleResolvable): Promise<void>;
+    /**
+     *
+     * @param role the role to edit
+     * @param data data to edit the role with
+     * @param data.permissions The permissions to set for the role, in the format { a: allow, d: deny }
+     * @param data.name The name of the role
+     * @param data.colour The color of the role, or `null` if no color is set
+     * @param data.hoist Whether the role is displayed separately in the member list
+     * @param data.rank The rank of the role, used for ordering
+     * @param data.remove Fields to remove from the role
+     * @returns Role
+     * @throws {TypeError} If the role ID is invalid
+     */
+    edit(role: RoleResolvable, data: editableRole): Promise<Role>;
 }
 
 type APIServerChannel = Extract<Channel$1, {
@@ -2487,4 +2617,4 @@ declare class ServerMemberManager extends BaseManager<ServerMember, Member> {
     resolveId(member: ServerMemberResolvable): string | null;
 }
 
-export { Attachment, type BadgeString, Badges, type BadgesResolvable, Base, BaseManager, BitField, type BitFieldResolvable, Category, Channel, ChannelManager, ChannelPermissions, type ChannelPermissionsResolvable, type ChannelPermissionsString, type ChannelResolvable, ChannelTypes, type CreateChannelOptions, DEFAULT_CLIENT_OPTIONS, DEFAULT_PERMISSION_DM, DMChannel, type EditServerMemberOptions, type EditServerOptions, type Embed, type EmbedImage, type EmbedSpecial, type EmbedVideo, Emoji, Events, GroupChannel, Invite, Mentions, Message, type MessageEditOptions, MessageEmbed, MessageManager, type MessageOptions, type MessageQueryOptions, type MessageReply, type MessageResolvable, type MessageSearchOptions, NotesChannel, type Overwrite, Presence, Role, RoleManager, type RoleResolvable, SYSTEM_USER_ID, Server, ServerChannel, ServerChannelManager, type ServerChannelResolvable, ServerManager, ServerMember, ServerMemberManager, type ServerMemberResolvable, ServerPermissions, type ServerPermissionsResolvable, type ServerPermissionsString, type ServerResolvable, Status, TextChannel, UUID, User, UserManager, UserPermissions, type UserPermissionsResolvable, type UserPermissionsString, type UserResolvable, VoiceChannel, WSEvents, apiUrl, cdnUrl, client, wsUrl };
+export { Attachment, type BadgeString, Badges, type BadgesResolvable, Base, BaseManager, BitField, type BitFieldResolvable, Category, Channel, ChannelManager, ChannelPermissions, type ChannelPermissionsResolvable, type ChannelPermissionsString, type ChannelResolvable, ChannelTypes, type CreateChannelOptions, DEFAULT_CLIENT_OPTIONS, DEFAULT_PERMISSION_DM, DMChannel, type EditServerMemberOptions, type EditServerOptions, type Embed, type EmbedImage, type EmbedSpecial, type EmbedVideo, Emoji, Events, FullPermissions, GroupChannel, Invite, Mentions, Message, type MessageEditOptions, MessageEmbed, MessageManager, type MessageOptions, type MessageQueryOptions, type MessageReply, type MessageResolvable, type MessageSearchOptions, NotesChannel, type Overwrite, Presence, Role, RoleManager, type RoleResolvable, SYSTEM_USER_ID, Server, ServerChannel, ServerChannelManager, type ServerChannelResolvable, ServerManager, ServerMember, ServerMemberManager, type ServerMemberResolvable, ServerPermissions, type ServerPermissionsResolvable, type ServerPermissionsString, type ServerResolvable, Status, TextChannel, UUID, User, UserManager, UserPermissions, type UserPermissionsResolvable, type UserPermissionsString, type UserResolvable, VoiceChannel, WSEvents, apiUrl, cdnUrl, client, wsUrl };

package/dist/index.d.ts

@@ -73,23 +73,51 @@ declare class UUID extends null {
 }
 
 type BitFieldResolvable = BitField | number | string | BitFieldResolvable[];
+/**
+ * Represents a bitfield that can be used to manage flags or permissions.
+ */
 declare class BitField {
     static FLAGS: Record<string, number>;
     bitfield: number;
     constructor(bits?: BitFieldResolvable);
+    /**
+     * Resolves a bitfield or an array of bitfields into a single number.
+     * @param bit The bitfield or array of bitfields to resolve.
+     * @returns The resolved bitfield as a number.
+     */
     static resolve(bit: BitFieldResolvable): number;
+    /**
+     * Returns the class that this instance belongs to.
+     * @returns The class of the bitfield.
+     */
     get self(): {
         FLAGS: Record<string, number>;
         resolve(bit: BitFieldResolvable): number;
         new (bits?: BitFieldResolvable): BitField;
     };
+    /**
+     * Checks if any of the bits in the bitfield are set.
+     * @param bit The bitfield or array of bitfields to check.
+     * @returns True if any bits are set, false otherwise.
+     */
     any(bit: BitFieldResolvable): boolean;
+    /**
+     * checks if a specific permission is set.
+     */
     has(bit: BitFieldResolvable): boolean;
+    /**
+     * Returns an array of all the Permissions that are set in the bitfield.
+     * @returns An array of flag names.
+     */
     toArray(): string[];
     add(...bits: BitFieldResolvable[]): this;
     remove(...bits: BitFieldResolvable[]): this;
     freeze(): Readonly<this>;
     valueOf(): number;
+    /**
+     *
+     * @returns A record of all flags and their boolean values indicating whether they are set.
+     */
     serialize(): Record<string, boolean>;
     [Symbol.iterator](): Iterable<string>;
 }
@@ -465,6 +493,44 @@ declare class ServerPermissions extends BitField {
     constructor(bits?: ServerPermissionsResolvable);
     static resolve(bit: ServerPermissionsResolvable): number;
 }
+declare class FullPermissions extends BitField {
+    static readonly FLAGS: {
+        readonly ManageChannel: number;
+        readonly ManageServer: number;
+        readonly ManagePermissions: number;
+        readonly ManageRole: number;
+        readonly ManageCustomisation: number;
+        readonly KickMembers: number;
+        readonly BanMembers: number;
+        readonly TimeoutMembers: number;
+        readonly AssignRoles: number;
+        readonly ChangeNickname: number;
+        readonly ManageNicknames: number;
+        readonly ChangeAvatar: number;
+        readonly RemoveAvatars: number;
+        readonly ViewChannel: number;
+        readonly ReadMessageHistory: number;
+        readonly SendMessage: number;
+        readonly ManageMessages: number;
+        readonly ManageWebhooks: number;
+        readonly InviteOthers: number;
+        readonly SendEmbeds: number;
+        readonly UploadFiles: number;
+        readonly Masquerade: number;
+        readonly React: number;
+        readonly Connect: number;
+        readonly Speak: number;
+        readonly Video: number;
+        readonly MuteMembers: number;
+        readonly DeafenMembers: number;
+        readonly MoveMembers: number;
+        readonly MentionEveryone: number;
+        readonly MentionRoles: number;
+        readonly GrantAll: 4503599627370495;
+    };
+    constructor(bits?: number | string | FullPermissions | Array<number | string | FullPermissions>);
+    static resolve(bit: number | string | FullPermissions): number;
+}
 declare const DEFAULT_PERMISSION_DM: Readonly<ChannelPermissions>;
 
 type BadgeString = keyof typeof Badges.FLAGS;
@@ -840,7 +906,7 @@ declare class Server extends Base {
     /** Whether the server is marked as NSFW (Not Safe For Work). */
     nsfw: boolean;
     /** The default permissions for the server. */
-    permissions: ServerPermissions;
+    permissions: FullPermissions;
     /** The categories in the server. */
     categories: Map<string, Category>;
     /** the emojies associated with the server */
@@ -893,6 +959,55 @@ declare class Server extends Base {
     toString(): string;
 }
 
+/**
+ * Represents the permissions that can be set for a role.
+ */
+type editablePermissions = {
+    /**
+     * Permissions to allow for the role.
+     * Each key corresponds to a permission flag in FullPermissions.
+     */
+    a?: Array<keyof (typeof FullPermissions)["FLAGS"]>;
+    /**
+     * Permissions to deny for the role.
+     * Each key corresponds to a permission flag in FullPermissions.
+     */
+    d?: Array<keyof (typeof FullPermissions)["FLAGS"]>;
+};
+/**
+ * Represents a role that can be edited in a server.
+ */
+type editableRole = {
+    /**
+     * Name of the role.
+     */
+    name?: string;
+    /**
+     * Colour of the role, or `null` if no colour is set.
+     */
+    colour?: string | null;
+    /**
+     * Whether the role is displayed separately in the member list.
+     */
+    hoist?: boolean;
+    /**
+     * Rank of the role, used for ordering.
+     */
+    rank?: number;
+    /**
+     * Permissions to set for the role.
+     * Format: { a: allow, d: deny }
+     */
+    permissions?: editablePermissions;
+    /**
+     * Fields to remove from the role.
+     * Each key corresponds to a field in the Role type.
+     */
+    remove?: Array<keyof Role$1 & {
+        [key: string]: unknown;
+    }>;
+};
+
 /**
  * Represents a role in a server.
  *
@@ -960,6 +1075,7 @@ declare class Role extends Base {
      * ```
      */
     delete(): Promise<void>;
+    edit(data: editableRole): Promise<Role>;
     /**
      * Converts the role to a string representation.
      *
@@ -1532,8 +1648,8 @@ type APIServerChannel$1 = Extract<Channel$1, {
     channel_type: "TextChannel" | "VoiceChannel";
 }>;
 interface Overwrite {
-    allow: ChannelPermissions;
-    deny: ChannelPermissions;
+    allow: FullPermissions;
+    deny: FullPermissions;
 }
 /**
  * Represents a server channel, which can be a text or voice channel.
@@ -2397,6 +2513,20 @@ declare class RoleManager extends BaseManager<Role, Role$1 & {
      * @returns A promise that resolves when the role is deleted
      */
     delete(role: RoleResolvable): Promise<void>;
+    /**
+     *
+     * @param role the role to edit
+     * @param data data to edit the role with
+     * @param data.permissions The permissions to set for the role, in the format { a: allow, d: deny }
+     * @param data.name The name of the role
+     * @param data.colour The color of the role, or `null` if no color is set
+     * @param data.hoist Whether the role is displayed separately in the member list
+     * @param data.rank The rank of the role, used for ordering
+     * @param data.remove Fields to remove from the role
+     * @returns Role
+     * @throws {TypeError} If the role ID is invalid
+     */
+    edit(role: RoleResolvable, data: editableRole): Promise<Role>;
 }
 
 type APIServerChannel = Extract<Channel$1, {
@@ -2487,4 +2617,4 @@ declare class ServerMemberManager extends BaseManager<ServerMember, Member> {
     resolveId(member: ServerMemberResolvable): string | null;
 }
 
-export { Attachment, type BadgeString, Badges, type BadgesResolvable, Base, BaseManager, BitField, type BitFieldResolvable, Category, Channel, ChannelManager, ChannelPermissions, type ChannelPermissionsResolvable, type ChannelPermissionsString, type ChannelResolvable, ChannelTypes, type CreateChannelOptions, DEFAULT_CLIENT_OPTIONS, DEFAULT_PERMISSION_DM, DMChannel, type EditServerMemberOptions, type EditServerOptions, type Embed, type EmbedImage, type EmbedSpecial, type EmbedVideo, Emoji, Events, GroupChannel, Invite, Mentions, Message, type MessageEditOptions, MessageEmbed, MessageManager, type MessageOptions, type MessageQueryOptions, type MessageReply, type MessageResolvable, type MessageSearchOptions, NotesChannel, type Overwrite, Presence, Role, RoleManager, type RoleResolvable, SYSTEM_USER_ID, Server, ServerChannel, ServerChannelManager, type ServerChannelResolvable, ServerManager, ServerMember, ServerMemberManager, type ServerMemberResolvable, ServerPermissions, type ServerPermissionsResolvable, type ServerPermissionsString, type ServerResolvable, Status, TextChannel, UUID, User, UserManager, UserPermissions, type UserPermissionsResolvable, type UserPermissionsString, type UserResolvable, VoiceChannel, WSEvents, apiUrl, cdnUrl, client, wsUrl };
+export { Attachment, type BadgeString, Badges, type BadgesResolvable, Base, BaseManager, BitField, type BitFieldResolvable, Category, Channel, ChannelManager, ChannelPermissions, type ChannelPermissionsResolvable, type ChannelPermissionsString, type ChannelResolvable, ChannelTypes, type CreateChannelOptions, DEFAULT_CLIENT_OPTIONS, DEFAULT_PERMISSION_DM, DMChannel, type EditServerMemberOptions, type EditServerOptions, type Embed, type EmbedImage, type EmbedSpecial, type EmbedVideo, Emoji, Events, FullPermissions, GroupChannel, Invite, Mentions, Message, type MessageEditOptions, MessageEmbed, MessageManager, type MessageOptions, type MessageQueryOptions, type MessageReply, type MessageResolvable, type MessageSearchOptions, NotesChannel, type Overwrite, Presence, Role, RoleManager, type RoleResolvable, SYSTEM_USER_ID, Server, ServerChannel, ServerChannelManager, type ServerChannelResolvable, ServerManager, ServerMember, ServerMemberManager, type ServerMemberResolvable, ServerPermissions, type ServerPermissionsResolvable, type ServerPermissionsString, type ServerResolvable, Status, TextChannel, UUID, User, UserManager, UserPermissions, type UserPermissionsResolvable, type UserPermissionsString, type UserResolvable, VoiceChannel, WSEvents, apiUrl, cdnUrl, client, wsUrl };

package/dist/index.js

@@ -13,6 +13,7 @@ var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.
 var __typeError = (msg) => {
   throw TypeError(msg);
 };
+var __pow = Math.pow;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __spreadValues = (a, b) => {
   for (var prop in b || (b = {}))
@@ -122,6 +123,7 @@ __export(index_exports, {
   DMChannel: () => DMChannel3,
   Emoji: () => Emoji2,
   Events: () => Events,
+  FullPermissions: () => FullPermissions,
   GroupChannel: () => GroupChannel2,
   Invite: () => Invite,
   Mentions: () => Mentions,
@@ -197,6 +199,11 @@ var _BitField = class _BitField {
     this.bitfield = DEFAULT_BIT;
     this.bitfield = this.self.resolve(bits);
   }
+  /**
+   * Resolves a bitfield or an array of bitfields into a single number.
+   * @param bit The bitfield or array of bitfields to resolve.
+   * @returns The resolved bitfield as a number.
+   */
   static resolve(bit) {
     if (bit instanceof _BitField) return bit.bitfield;
     if (typeof bit === "number" && bit >= DEFAULT_BIT) return bit;
@@ -206,17 +213,33 @@ var _BitField = class _BitField {
     if (typeof this.FLAGS[bit] !== "undefined") return this.FLAGS[bit];
     throw new Error("BITFIELD_INVALID");
   }
+  /**
+   * Returns the class that this instance belongs to.
+   * @returns The class of the bitfield.
+   */
   get self() {
     return this.constructor;
   }
+  /**
+   * Checks if any of the bits in the bitfield are set.
+   * @param bit The bitfield or array of bitfields to check.
+   * @returns True if any bits are set, false otherwise.
+   */
   any(bit) {
     bit = this.self.resolve(bit);
     return (this.bitfield & bit) !== DEFAULT_BIT;
   }
+  /**
+   * checks if a specific permission is set.
+   */
   has(bit) {
     bit = this.self.resolve(bit);
     return (this.bitfield & bit) === bit;
   }
+  /**
+   * Returns an array of all the Permissions that are set in the bitfield.
+   * @returns An array of flag names.
+   */
   toArray() {
     return Object.keys(this.self.FLAGS).filter((bit) => this.has(bit));
   }
@@ -248,6 +271,10 @@ var _BitField = class _BitField {
   valueOf() {
     return this.bitfield;
   }
+  /**
+   *
+   * @returns A record of all flags and their boolean values indicating whether they are set.
+   */
   serialize() {
     const serialized = {};
     for (const [flag, bit] of Object.entries(this.self.FLAGS)) {
@@ -478,14 +505,14 @@ var ChannelPermissions = class extends BitField {
   }
 };
 ChannelPermissions.FLAGS = {
-  VIEW_CHANNEL: 1 << 0,
-  SEND_MESSAGE: 1 << 1,
-  MANAGE_MESSAGE: 1 << 2,
-  MANAGE_CHANNEL: 1 << 3,
-  VOICE_CALL: 1 << 4,
-  INVITE_OTHERS: 1 << 5,
-  EMBED_LINKS: 1 << 6,
-  UPLOAD_FILES: 1 << 7
+  VIEW_CHANNEL: __pow(1, 0),
+  SEND_MESSAGE: __pow(1, 22),
+  MANAGE_MESSAGE: __pow(1, 2),
+  MANAGE_CHANNEL: __pow(1, 3),
+  VOICE_CALL: __pow(1, 4),
+  INVITE_OTHERS: __pow(1, 5),
+  EMBED_LINKS: __pow(1, 6),
+  UPLOAD_FILES: __pow(1, 7)
 };
 var UserPermissions = class extends BitField {
   constructor(bits) {
@@ -496,10 +523,10 @@ var UserPermissions = class extends BitField {
   }
 };
 UserPermissions.FLAGS = {
-  ACCESS: 1 << 0,
-  VIEW_PROFILE: 1 << 1,
-  SEND_MESSAGES: 1 << 2,
-  INVITE: 1 << 3
+  ACCESS: __pow(1, 0),
+  VIEW_PROFILE: __pow(1, 1),
+  SEND_MESSAGES: __pow(1, 2),
+  INVITE: __pow(1, 3)
 };
 var ServerPermissions = class extends BitField {
   constructor(bits) {
@@ -510,16 +537,96 @@ var ServerPermissions = class extends BitField {
   }
 };
 ServerPermissions.FLAGS = {
-  VIEW_SERVER: 1 << 0,
-  MANAGE_ROLES: 1 << 1,
-  MANAGE_CHANNELS: 1 << 2,
-  MANAGE_SERVER: 1 << 3,
-  KICK_MEMBERS: 1 << 4,
-  BAN_MEMBERS: 1 << 5,
-  CHANGE_NICKNAME: 1 << 12,
-  MANAGE_NICKNAMES: 1 << 13,
-  CHANGE_AVATAR: 1 << 14,
-  REMOVE_AVATARS: 1 << 15
+  VIEW_SERVER: __pow(1, 0),
+  MANAGE_ROLES: __pow(1, 1),
+  MANAGE_CHANNELS: __pow(1, 2),
+  MANAGE_SERVER: __pow(1, 3),
+  KICK_MEMBERS: __pow(1, 4),
+  BAN_MEMBERS: __pow(1, 5),
+  CHANGE_NICKNAME: __pow(1, 12),
+  MANAGE_NICKNAMES: __pow(1, 13),
+  CHANGE_AVATAR: __pow(1, 14),
+  REMOVE_AVATARS: __pow(1, 15)
+};
+var FullPermissions = class extends BitField {
+  constructor(bits) {
+    super(bits);
+  }
+  static resolve(bit) {
+    return super.resolve(bit);
+  }
+};
+FullPermissions.FLAGS = {
+  // * Generic permissions
+  /// Manage the channel or channels on the server
+  ManageChannel: __pow(2, 0),
+  /// Manage the server
+  ManageServer: __pow(2, 1),
+  /// Manage permissions on servers or channels
+  ManagePermissions: __pow(2, 2),
+  /// Manage roles on server
+  ManageRole: __pow(2, 3),
+  /// Manage server customisation (includes emoji)
+  ManageCustomisation: __pow(2, 4),
+  // * Member permissions
+  /// Kick other members below their ranking
+  KickMembers: __pow(2, 6),
+  /// Ban other members below their ranking
+  BanMembers: __pow(2, 7),
+  /// Timeout other members below their ranking
+  TimeoutMembers: __pow(2, 8),
+  /// Assign roles to members below their ranking
+  AssignRoles: __pow(2, 9),
+  /// Change own nickname
+  ChangeNickname: __pow(2, 10),
+  /// Change or remove other's nicknames below their ranking
+  ManageNicknames: __pow(2, 11),
+  /// Change own avatar
+  ChangeAvatar: __pow(2, 12),
+  /// Remove other's avatars below their ranking
+  RemoveAvatars: __pow(2, 13),
+  // * Channel permissions
+  /// View a channel
+  ViewChannel: __pow(2, 20),
+  /// Read a channel's past message history
+  ReadMessageHistory: __pow(2, 21),
+  /// Send a message in a channel
+  SendMessage: __pow(2, 22),
+  /// Delete messages in a channel
+  ManageMessages: __pow(2, 23),
+  /// Manage webhook entries on a channel
+  ManageWebhooks: __pow(2, 24),
+  /// Create invites to this channel
+  InviteOthers: __pow(2, 25),
+  /// Send embedded content in this channel
+  SendEmbeds: __pow(2, 26),
+  /// Send attachments and media in this channel
+  UploadFiles: __pow(2, 27),
+  /// Masquerade messages using custom nickname and avatar
+  Masquerade: __pow(2, 28),
+  /// React to messages with emoji
+  React: __pow(2, 29),
+  // * Voice permissions
+  /// Connect to a voice channel
+  Connect: __pow(2, 30),
+  /// Speak in a voice call
+  Speak: __pow(2, 31),
+  /// Share video in a voice call
+  Video: __pow(2, 32),
+  /// Mute other members with lower ranking in a voice call
+  MuteMembers: __pow(2, 33),
+  /// Deafen other members with lower ranking in a voice call
+  DeafenMembers: __pow(2, 34),
+  /// Move members between voice channels
+  MoveMembers: __pow(2, 35),
+  // * Mention permissions
+  /// Mention @everyone or @online
+  MentionEveryone: __pow(2, 37),
+  /// Mention a role
+  MentionRoles: __pow(2, 38),
+  // * Grant all permissions
+  /// Safely grant all permissions
+  GrantAll: 4503599627370495
 };
 var DEFAULT_PERMISSION_DM = new ChannelPermissions([
   "VIEW_CHANNEL",
@@ -1066,9 +1173,7 @@ var Server2 = class extends Base {
       }
     }
     if (typeof data.default_permissions === "number") {
-      this.permissions = new ServerPermissions(
-        data.default_permissions
-      ).freeze();
+      this.permissions = new FullPermissions(data.default_permissions).freeze();
     }
     if (typeof data.analytics === "boolean") this.analytics = data.analytics;
     if (typeof data.discoverable === "boolean") {
@@ -1171,8 +1276,8 @@ var Role = class extends Base {
     if (data.permissions) {
       const { a, d } = data.permissions;
       this.overwrite = {
-        allow: new ChannelPermissions(a),
-        deny: new ChannelPermissions(d)
+        allow: new FullPermissions(a),
+        deny: new FullPermissions(d)
       };
     }
     for (const field of clear) {
@@ -1218,6 +1323,9 @@ var Role = class extends Base {
   delete() {
     return this.server.roles.delete(this);
   }
+  edit(data) {
+    return this.server.roles.edit(this, data);
+  }
   /**
    * Converts the role to a string representation.
    *
@@ -1974,8 +2082,8 @@ var ServerChannel = class extends Channel {
       this.overwrites.clear();
       for (const [id, { a, d }] of Object.entries(data.role_permissions)) {
         this.overwrites.set(id, {
-          allow: new ChannelPermissions(a),
-          deny: new ChannelPermissions(d)
+          allow: new FullPermissions(a),
+          deny: new FullPermissions(d)
         });
       }
     }
@@ -2893,6 +3001,42 @@ var RoleManager = class extends BaseManager {
       yield this.client.api.delete(`/servers/${this.server.id}/roles/${id}`);
     });
   }
+  /**
+   *
+   * @param role the role to edit
+   * @param data data to edit the role with
+   * @param data.permissions The permissions to set for the role, in the format { a: allow, d: deny }
+   * @param data.name The name of the role
+   * @param data.colour The color of the role, or `null` if no color is set
+   * @param data.hoist Whether the role is displayed separately in the member list
+   * @param data.rank The rank of the role, used for ordering
+   * @param data.remove Fields to remove from the role
+   * @returns Role
+   * @throws {TypeError} If the role ID is invalid
+   */
+  edit(role, data) {
+    return __async(this, null, function* () {
+      var _a, _b;
+      const id = this.resolveId(role);
+      if (!id) throw new TypeError("INVALID_TYPE");
+      if (data.permissions) {
+        const permissions = {
+          allow: new FullPermissions(((_a = data.permissions) == null ? void 0 : _a.a) || []).bitfield,
+          deny: new FullPermissions(((_b = data.permissions) == null ? void 0 : _b.d) || []).bitfield
+        };
+        yield this.client.api.put(
+          `/servers/${this.server.id}/permissions/${id}`,
+          { body: { permissions } }
+        );
+      }
+      delete data.permissions;
+      const updatedRole = yield this.client.api.patch(
+        `/servers/${this.server.id}/roles/${id}`,
+        { body: data }
+      );
+      return this._add(Object.assign(updatedRole, { id }));
+    });
+  }
 };
 
 // src/managers/serverChannelManager.ts
@@ -3091,7 +3235,7 @@ var import_node_events = require("events");
 var import_axios3 = __toESM(require("axios"));
 
 // package.json
-var version = "0.0.7";
+var version = "0.0.8";
 
 // src/rest/restClient.ts
 var RestClient = class {
@@ -4245,6 +4389,7 @@ var client2 = class extends BaseClient {
   DMChannel,
   Emoji,
   Events,
+  FullPermissions,
   GroupChannel,
   Invite,
   Mentions,

package/dist/index.mjs

@@ -8,6 +8,7 @@ var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.
 var __typeError = (msg) => {
   throw TypeError(msg);
 };
+var __pow = Math.pow;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __spreadValues = (a, b) => {
   for (var prop in b || (b = {}))
@@ -124,6 +125,11 @@ var _BitField = class _BitField {
     this.bitfield = DEFAULT_BIT;
     this.bitfield = this.self.resolve(bits);
   }
+  /**
+   * Resolves a bitfield or an array of bitfields into a single number.
+   * @param bit The bitfield or array of bitfields to resolve.
+   * @returns The resolved bitfield as a number.
+   */
   static resolve(bit) {
     if (bit instanceof _BitField) return bit.bitfield;
     if (typeof bit === "number" && bit >= DEFAULT_BIT) return bit;
@@ -133,17 +139,33 @@ var _BitField = class _BitField {
     if (typeof this.FLAGS[bit] !== "undefined") return this.FLAGS[bit];
     throw new Error("BITFIELD_INVALID");
   }
+  /**
+   * Returns the class that this instance belongs to.
+   * @returns The class of the bitfield.
+   */
   get self() {
     return this.constructor;
   }
+  /**
+   * Checks if any of the bits in the bitfield are set.
+   * @param bit The bitfield or array of bitfields to check.
+   * @returns True if any bits are set, false otherwise.
+   */
   any(bit) {
     bit = this.self.resolve(bit);
     return (this.bitfield & bit) !== DEFAULT_BIT;
   }
+  /**
+   * checks if a specific permission is set.
+   */
   has(bit) {
     bit = this.self.resolve(bit);
     return (this.bitfield & bit) === bit;
   }
+  /**
+   * Returns an array of all the Permissions that are set in the bitfield.
+   * @returns An array of flag names.
+   */
   toArray() {
     return Object.keys(this.self.FLAGS).filter((bit) => this.has(bit));
   }
@@ -175,6 +197,10 @@ var _BitField = class _BitField {
   valueOf() {
     return this.bitfield;
   }
+  /**
+   *
+   * @returns A record of all flags and their boolean values indicating whether they are set.
+   */
   serialize() {
     const serialized = {};
     for (const [flag, bit] of Object.entries(this.self.FLAGS)) {
@@ -405,14 +431,14 @@ var ChannelPermissions = class extends BitField {
   }
 };
 ChannelPermissions.FLAGS = {
-  VIEW_CHANNEL: 1 << 0,
-  SEND_MESSAGE: 1 << 1,
-  MANAGE_MESSAGE: 1 << 2,
-  MANAGE_CHANNEL: 1 << 3,
-  VOICE_CALL: 1 << 4,
-  INVITE_OTHERS: 1 << 5,
-  EMBED_LINKS: 1 << 6,
-  UPLOAD_FILES: 1 << 7
+  VIEW_CHANNEL: __pow(1, 0),
+  SEND_MESSAGE: __pow(1, 22),
+  MANAGE_MESSAGE: __pow(1, 2),
+  MANAGE_CHANNEL: __pow(1, 3),
+  VOICE_CALL: __pow(1, 4),
+  INVITE_OTHERS: __pow(1, 5),
+  EMBED_LINKS: __pow(1, 6),
+  UPLOAD_FILES: __pow(1, 7)
 };
 var UserPermissions = class extends BitField {
   constructor(bits) {
@@ -423,10 +449,10 @@ var UserPermissions = class extends BitField {
   }
 };
 UserPermissions.FLAGS = {
-  ACCESS: 1 << 0,
-  VIEW_PROFILE: 1 << 1,
-  SEND_MESSAGES: 1 << 2,
-  INVITE: 1 << 3
+  ACCESS: __pow(1, 0),
+  VIEW_PROFILE: __pow(1, 1),
+  SEND_MESSAGES: __pow(1, 2),
+  INVITE: __pow(1, 3)
 };
 var ServerPermissions = class extends BitField {
   constructor(bits) {
@@ -437,16 +463,96 @@ var ServerPermissions = class extends BitField {
   }
 };
 ServerPermissions.FLAGS = {
-  VIEW_SERVER: 1 << 0,
-  MANAGE_ROLES: 1 << 1,
-  MANAGE_CHANNELS: 1 << 2,
-  MANAGE_SERVER: 1 << 3,
-  KICK_MEMBERS: 1 << 4,
-  BAN_MEMBERS: 1 << 5,
-  CHANGE_NICKNAME: 1 << 12,
-  MANAGE_NICKNAMES: 1 << 13,
-  CHANGE_AVATAR: 1 << 14,
-  REMOVE_AVATARS: 1 << 15
+  VIEW_SERVER: __pow(1, 0),
+  MANAGE_ROLES: __pow(1, 1),
+  MANAGE_CHANNELS: __pow(1, 2),
+  MANAGE_SERVER: __pow(1, 3),
+  KICK_MEMBERS: __pow(1, 4),
+  BAN_MEMBERS: __pow(1, 5),
+  CHANGE_NICKNAME: __pow(1, 12),
+  MANAGE_NICKNAMES: __pow(1, 13),
+  CHANGE_AVATAR: __pow(1, 14),
+  REMOVE_AVATARS: __pow(1, 15)
+};
+var FullPermissions = class extends BitField {
+  constructor(bits) {
+    super(bits);
+  }
+  static resolve(bit) {
+    return super.resolve(bit);
+  }
+};
+FullPermissions.FLAGS = {
+  // * Generic permissions
+  /// Manage the channel or channels on the server
+  ManageChannel: __pow(2, 0),
+  /// Manage the server
+  ManageServer: __pow(2, 1),
+  /// Manage permissions on servers or channels
+  ManagePermissions: __pow(2, 2),
+  /// Manage roles on server
+  ManageRole: __pow(2, 3),
+  /// Manage server customisation (includes emoji)
+  ManageCustomisation: __pow(2, 4),
+  // * Member permissions
+  /// Kick other members below their ranking
+  KickMembers: __pow(2, 6),
+  /// Ban other members below their ranking
+  BanMembers: __pow(2, 7),
+  /// Timeout other members below their ranking
+  TimeoutMembers: __pow(2, 8),
+  /// Assign roles to members below their ranking
+  AssignRoles: __pow(2, 9),
+  /// Change own nickname
+  ChangeNickname: __pow(2, 10),
+  /// Change or remove other's nicknames below their ranking
+  ManageNicknames: __pow(2, 11),
+  /// Change own avatar
+  ChangeAvatar: __pow(2, 12),
+  /// Remove other's avatars below their ranking
+  RemoveAvatars: __pow(2, 13),
+  // * Channel permissions
+  /// View a channel
+  ViewChannel: __pow(2, 20),
+  /// Read a channel's past message history
+  ReadMessageHistory: __pow(2, 21),
+  /// Send a message in a channel
+  SendMessage: __pow(2, 22),
+  /// Delete messages in a channel
+  ManageMessages: __pow(2, 23),
+  /// Manage webhook entries on a channel
+  ManageWebhooks: __pow(2, 24),
+  /// Create invites to this channel
+  InviteOthers: __pow(2, 25),
+  /// Send embedded content in this channel
+  SendEmbeds: __pow(2, 26),
+  /// Send attachments and media in this channel
+  UploadFiles: __pow(2, 27),
+  /// Masquerade messages using custom nickname and avatar
+  Masquerade: __pow(2, 28),
+  /// React to messages with emoji
+  React: __pow(2, 29),
+  // * Voice permissions
+  /// Connect to a voice channel
+  Connect: __pow(2, 30),
+  /// Speak in a voice call
+  Speak: __pow(2, 31),
+  /// Share video in a voice call
+  Video: __pow(2, 32),
+  /// Mute other members with lower ranking in a voice call
+  MuteMembers: __pow(2, 33),
+  /// Deafen other members with lower ranking in a voice call
+  DeafenMembers: __pow(2, 34),
+  /// Move members between voice channels
+  MoveMembers: __pow(2, 35),
+  // * Mention permissions
+  /// Mention @everyone or @online
+  MentionEveryone: __pow(2, 37),
+  /// Mention a role
+  MentionRoles: __pow(2, 38),
+  // * Grant all permissions
+  /// Safely grant all permissions
+  GrantAll: 4503599627370495
 };
 var DEFAULT_PERMISSION_DM = new ChannelPermissions([
   "VIEW_CHANNEL",
@@ -993,9 +1099,7 @@ var Server2 = class extends Base {
       }
     }
     if (typeof data.default_permissions === "number") {
-      this.permissions = new ServerPermissions(
-        data.default_permissions
-      ).freeze();
+      this.permissions = new FullPermissions(data.default_permissions).freeze();
     }
     if (typeof data.analytics === "boolean") this.analytics = data.analytics;
     if (typeof data.discoverable === "boolean") {
@@ -1098,8 +1202,8 @@ var Role = class extends Base {
     if (data.permissions) {
       const { a, d } = data.permissions;
       this.overwrite = {
-        allow: new ChannelPermissions(a),
-        deny: new ChannelPermissions(d)
+        allow: new FullPermissions(a),
+        deny: new FullPermissions(d)
       };
     }
     for (const field of clear) {
@@ -1145,6 +1249,9 @@ var Role = class extends Base {
   delete() {
     return this.server.roles.delete(this);
   }
+  edit(data) {
+    return this.server.roles.edit(this, data);
+  }
   /**
    * Converts the role to a string representation.
    *
@@ -1901,8 +2008,8 @@ var ServerChannel = class extends Channel {
       this.overwrites.clear();
       for (const [id, { a, d }] of Object.entries(data.role_permissions)) {
         this.overwrites.set(id, {
-          allow: new ChannelPermissions(a),
-          deny: new ChannelPermissions(d)
+          allow: new FullPermissions(a),
+          deny: new FullPermissions(d)
         });
       }
     }
@@ -2820,6 +2927,42 @@ var RoleManager = class extends BaseManager {
       yield this.client.api.delete(`/servers/${this.server.id}/roles/${id}`);
     });
   }
+  /**
+   *
+   * @param role the role to edit
+   * @param data data to edit the role with
+   * @param data.permissions The permissions to set for the role, in the format { a: allow, d: deny }
+   * @param data.name The name of the role
+   * @param data.colour The color of the role, or `null` if no color is set
+   * @param data.hoist Whether the role is displayed separately in the member list
+   * @param data.rank The rank of the role, used for ordering
+   * @param data.remove Fields to remove from the role
+   * @returns Role
+   * @throws {TypeError} If the role ID is invalid
+   */
+  edit(role, data) {
+    return __async(this, null, function* () {
+      var _a, _b;
+      const id = this.resolveId(role);
+      if (!id) throw new TypeError("INVALID_TYPE");
+      if (data.permissions) {
+        const permissions = {
+          allow: new FullPermissions(((_a = data.permissions) == null ? void 0 : _a.a) || []).bitfield,
+          deny: new FullPermissions(((_b = data.permissions) == null ? void 0 : _b.d) || []).bitfield
+        };
+        yield this.client.api.put(
+          `/servers/${this.server.id}/permissions/${id}`,
+          { body: { permissions } }
+        );
+      }
+      delete data.permissions;
+      const updatedRole = yield this.client.api.patch(
+        `/servers/${this.server.id}/roles/${id}`,
+        { body: data }
+      );
+      return this._add(Object.assign(updatedRole, { id }));
+    });
+  }
 };
 
 // src/managers/serverChannelManager.ts
@@ -3018,7 +3161,7 @@ import { EventEmitter } from "node:events";
 import axios3 from "axios";
 
 // package.json
-var version = "0.0.7";
+var version = "0.0.8";
 
 // src/rest/restClient.ts
 var RestClient = class {
@@ -4171,6 +4314,7 @@ export {
   DMChannel3 as DMChannel,
   Emoji2 as Emoji,
   Events,
+  FullPermissions,
   GroupChannel2 as GroupChannel,
   Invite,
   Mentions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "revbot.js",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "A Revolt bot client used to interact with the revolt api for Node.js, written in TypeScript.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",