Chore: Rebuild bin

Author: gazmull

bin/Embeds.js

@@ -21,6 +21,12 @@ exports.Embeds = class extends t.PaginationEmbed {
     for (const e of this.array) e.addField(r, t, s);
     return this;
   }
+  attachFiles(r) {
+    if (!this.array) throw new TypeError("this.array must be set first.");
+    if (!r) return this;
+    for (const t of this.array) t.attachFiles(r);
+    return this;
+  }
   async build() {
     return this.pages = this.array.length, await this._verify(), this.listenerCount("start") && this.emit("start"), 
     this._loadList();

bin/base/index.js

@@ -147,7 +147,8 @@ exports.PaginationEmbed = class extends t.EventEmitter {
     if (t) return this._drawEmojis();
   }
   async _loadPage(t = 1) {
-    return this.setPage(t), await this._loadList(!1), this._awaitResponse();
+    return this.setPage(t), this.listenerCount("pageUpdate") && this.emit("pageUpdate"), 
+    await this._loadList(!1), this._awaitResponse();
   }
   async _awaitResponse() {
     const t = Object.values(this.navigationEmojis), e = (e, i) => {
@@ -188,7 +189,7 @@ exports.PaginationEmbed = class extends t.EventEmitter {
     }
   }
   async _cleanUp(t, e, i = !0, s) {
-    if (this.deleteOnTimeout && e.deletable && await e.delete(), e.guild && !e.deleted && await e.reactions.removeAll(), 
+    if (this.deleteOnTimeout && e.deletable && (await e.delete(), e.deleted = !0), e.guild && !e.deleted && await e.reactions.removeAll(), 
     t instanceof Error) return void (this.listenerCount("error") && this.emit("error", t));
     const a = i ? "expire" : "finish";
     this.listenerCount(a) && this.emit(a, s);

typings/Embeds.d.ts

@@ -1,4 +1,4 @@
-import { ColorResolvable, EmbedField, MessageEmbed, StringResolvable } from 'discord.js';
+import { ColorResolvable, EmbedField, FileOptions, MessageAttachment, MessageEmbed, StringResolvable } from 'discord.js';
 import { PaginationEmbed } from './base';
 /**
  * A pagination mode that uses an array of MessageEmbed to paginate.
@@ -47,6 +47,11 @@ export declare class Embeds extends PaginationEmbed<MessageEmbed> {
      * @param inline - Whether the field is inline to the other fields.
      */
     addField(name: string, value: StringResolvable, inline?: boolean): this;
+    /**
+     * Files to attach to all embeds.
+     * @param files - Files to attach.
+     */
+    attachFiles(files: Array<FileOptions | string | MessageAttachment>): this;
     /**
      * Build the Pagination Embeds.
      *

typings/FieldsEmbed.d.ts

@@ -47,7 +47,7 @@ export declare class FieldsEmbed<Element> extends PaginationEmbed<Element> {
      *    })
      *    .setFunctionEmojis({
      *      '🔄': (user, instance) => {
-     *        const field = instance.fields[0];
+     *        const field = instance.embed.fields[0];
      *
      *        if (field.name === 'Name')
      *          field.name = user.tag;

typings/base/index.d.ts

@@ -26,9 +26,16 @@ export declare class PaginationEmbed<Element> extends EventEmitter {
     page: number;
     /** The time for awaiting a user action before timeout in ms. Default: `30000` */
     timeout: number;
-    /** The emojis used for navigation emojis. */
+    /**
+     * The emojis used for navigation emojis.
+     * Navigation emojis are the default message reactions for navigating through the pagination.
+     */
     navigationEmojis: INavigationEmojis;
-    /** The emojis used for function emojis. */
+    /**
+     * The emojis used for function emojis.
+     * Function emojis are user-customised message reactions
+     * for modifying the current instance of the pagination such as modifying embed texts, stopping the pagination, etc.
+     */
     functionEmojis: IFunctionEmoji<Element>;
     /**
      * The disabled navigation emojis.
@@ -60,7 +67,7 @@ export declare class PaginationEmbed<Element> extends EventEmitter {
      * ### Example
      * ```js
      *  <PaginationEmbed>.addFunctionEmoji('🅱', (_, instance) => {
-     *    const field = instance.fields[0];
+     *    const field = instance.embed.fields[0];
      *
      *    if (field.name.includes('🅱'))
      *      field.name = 'Name';
@@ -126,7 +133,7 @@ export declare class PaginationEmbed<Element> extends EventEmitter {
      * ```js
      *  <PaginationEmbed>.setFunctionEmojis({
      *    '🔄': (user, instance) => {
-     *      const field = instance.fields[0];
+     *      const field = instance.embed.fields[0];
      *
      *      if (field.name === 'Name')
      *        field.name = user.tag;
@@ -199,8 +206,8 @@ export declare class PaginationEmbed<Element> extends EventEmitter {
     /** Awaits the reaction from the user(s). */
     protected _awaitResponse(): Promise<void>;
     /**
-     * Only used for _awaitResponse:
-     * Deletes the client's message, and emites either error or finish depending on the passed parameters.
+     * Only used for `_awaitResponse`:
+     * Deletes the client's message, and emits either `error` or `finish` event depending on the passed parameters.
      * @param err The error object.
      * @param clientMessage The client's message.
      * @param expired Whether the clean up is for `expired` event.
@@ -222,6 +229,11 @@ export declare class PaginationEmbed<Element> extends EventEmitter {
      * @event
      */
     on(event: 'finish', listener: ListenerUser): this;
+    /**
+     * Emitted when the page number is updated.
+     * @event
+     */
+    on(event: 'pageUpdate', listener: () => void): this;
     /**
      * Emitted upon a user reacting on the instance.
      * @event
@@ -240,7 +252,7 @@ export declare class PaginationEmbed<Element> extends EventEmitter {
     /** @event */
     once(event: 'finish', listener: ListenerUser): this;
     /** @event */
-    once(event: 'start' | 'expire', listener: () => void): this;
+    once(event: 'start' | 'expire' | 'pageUpdate', listener: () => void): this;
     /** @event */
     once(event: 'react', listener: ListenerReact): this;
     /** @event */