seyfert 0.1.0 → 1.0.1

package/lib/api/utils/utils.js

@@ -1,117 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deprecationWarning = exports.isBufferLike = exports.sleep = exports.calculateUserDefaultAvatarIndex = exports.onRateLimit = exports.shouldRetry = exports.hasSublimit = exports.parseResponse = exports.makeURLSearchParams = void 0;
-const RateLimitError_js_1 = require("../errors/RateLimitError.js");
-const constants_js_1 = require("./constants.js");
-const types_js_1 = require("./types.js");
-function serializeSearchParam(value) {
-    switch (typeof value) {
-        case 'string':
-            return value;
-        case 'number':
-        case 'bigint':
-        case 'boolean':
-            return value.toString();
-        case 'object':
-            if (value === null)
-                return null;
-            if (value instanceof Date) {
-                return Number.isNaN(value.getTime()) ? null : value.toISOString();
-            }
-            // eslint-disable-next-line @typescript-eslint/no-base-to-string
-            if (typeof value.toString === 'function' && value.toString !== Object.prototype.toString)
-                return value.toString();
-            return null;
-        default:
-            return null;
-    }
-}
-/**
- * Creates and populates an URLSearchParams instance from an object, stripping
- * out null and undefined values, while also coercing non-strings to strings.
- *
- * @param options - The options to use
- * @returns A populated URLSearchParams instance
- */
-function makeURLSearchParams(options) {
-    const params = new URLSearchParams();
-    if (!options)
-        return params;
-    for (const [key, value] of Object.entries(options)) {
-        const serialized = serializeSearchParam(value);
-        if (serialized !== null)
-            params.append(key, serialized);
-    }
-    return params;
-}
-exports.makeURLSearchParams = makeURLSearchParams;
-/**
- * Converts the response to usable data
- *
- * @param res - The fetch response
- */
-async function parseResponse(res) {
-    if (res.headers.get('Content-Type')?.startsWith('application/json')) {
-        return res.json();
-    }
-    return res.arrayBuffer();
-}
-exports.parseResponse = parseResponse;
-/**
- * Check whether a request falls under a sublimit
- *
- * @param bucketRoute - The buckets route identifier
- * @param body - The options provided as JSON data
- * @param method - The HTTP method that will be used to make the request
- * @returns Whether the request falls under a sublimit
- */
-function hasSublimit(bucketRoute, body, method) {
-    // TODO: Update for new sublimits
-    // Currently known sublimits:
-    // Editing channel `name` or `topic`
-    if (bucketRoute === '/channels/:id') {
-        if (typeof body !== 'object' || body === null)
-            return false;
-        // This should never be a POST body, but just in case
-        if (method !== types_js_1.RequestMethod.Patch)
-            return false;
-        const castedBody = body;
-        return ['name', 'topic'].some(key => Reflect.has(castedBody, key));
-    }
-    // If we are checking if a request has a sublimit on a route not checked above, sublimit all requests to avoid a flood of 429s
-    return true;
-}
-exports.hasSublimit = hasSublimit;
-/**
- * Check whether an error indicates that a retry can be attempted
- *
- * @param error - The error thrown by the network request
- * @returns Whether the error indicates a retry should be attempted
- */
-function shouldRetry(error) {
-    // Retry for possible timed out requests
-    if (error.name === 'AbortError')
-        return true;
-    // Downlevel ECONNRESET to retry as it may be recoverable
-    return ('code' in error && error.code === 'ECONNRESET') || error.message.includes('ECONNRESET');
-}
-exports.shouldRetry = shouldRetry;
-/**
- * Determines whether the request should be queued or whether a RateLimitError should be thrown
- *
- * @internal
- */
-async function onRateLimit(manager, rateLimitData) {
-    if (!manager.options.rejectOnRateLimit)
-        return;
-    const shouldThrow = typeof manager.options.rejectOnRateLimit === 'function'
-        ? await manager.options.rejectOnRateLimit(rateLimitData)
-        : manager.options.rejectOnRateLimit.some(route => rateLimitData.route.startsWith(route.toLowerCase()));
-    if (shouldThrow) {
-        throw new RateLimitError_js_1.RateLimitError(rateLimitData);
-    }
-}
-exports.onRateLimit = onRateLimit;
+exports.isBufferLike = exports.calculateUserDefaultAvatarIndex = void 0;
 /**
  * Calculates the default avatar index for a given user id.
  *
@@ -121,17 +10,6 @@ function calculateUserDefaultAvatarIndex(userId) {
     return Number(BigInt(userId) >> 22n) % 6;
 }
 exports.calculateUserDefaultAvatarIndex = calculateUserDefaultAvatarIndex;
-/**
- * Sleeps for a given amount of time.
- *
- * @param ms - The amount of time (in milliseconds) to sleep for
- */
-async function sleep(ms) {
-    return new Promise(resolve => {
-        setTimeout(() => resolve(), ms);
-    });
-}
-exports.sleep = sleep;
 /**
  * Verifies that a value is a buffer-like object.
  *
@@ -141,19 +19,3 @@ function isBufferLike(value) {
     return value instanceof ArrayBuffer || value instanceof Uint8Array || value instanceof Uint8ClampedArray;
 }
 exports.isBufferLike = isBufferLike;
-/**
- * Irrespective environment warning.
- *
- * @remarks Only the message is needed. The deprecation prefix is handled already.
- * @param message - A string the warning will emit with
- * @internal
- */
-function deprecationWarning(message) {
-    if (typeof globalThis.process === 'undefined') {
-        console.warn(`${constants_js_1.DEPRECATION_WARNING_PREFIX}: ${message}`);
-    }
-    else {
-        process.emitWarning(message, constants_js_1.DEPRECATION_WARNING_PREFIX);
-    }
-}
-exports.deprecationWarning = deprecationWarning;

package/lib/builders/ActionRow.js

@@ -30,7 +30,7 @@ class ActionRow extends Base_1.BaseComponentBuilder {
      * actionRow.addComponents([buttonComponent1, buttonComponent2]);
      */
     addComponents(...component) {
-        this.components = this.components.concat((0, common_1.fastFlat)(component));
+        this.components = this.components.concat(component.flat());
         return this;
     }
     /**

package/lib/builders/Attachment.d.ts

@@ -1,13 +1,15 @@
 /// <reference types="node" />
-import type { RESTAPIAttachment } from 'discord-api-types/v10';
+import type { APIAttachment, RESTAPIAttachment } from 'discord-api-types/v10';
 import { type RawFile } from '..';
-import type { ImageResolvable } from '../common';
+import type { BaseClient } from '../client/base';
+import type { ImageResolvable, ObjectToLower } from '../common';
+import { Base } from '../structures/extra/Base';
 export interface AttachmentResolvableMap {
     url: string;
-    buffer: Buffer;
+    buffer: Buffer | ArrayBuffer;
     path: string;
 }
-export type AttachmentResolvable = AttachmentResolvableMap[keyof AttachmentResolvableMap] | Attachment;
+export type AttachmentResolvable = AttachmentResolvableMap[keyof AttachmentResolvableMap] | AttachmentBuilder | Attachment;
 export type AttachmentDataType = keyof AttachmentResolvableMap;
 export interface AttachmentData {
     name: string;
@@ -15,7 +17,13 @@ export interface AttachmentData {
     resolvable: AttachmentResolvable;
     type: AttachmentDataType;
 }
-export declare class Attachment {
+export interface Attachment extends ObjectToLower<APIAttachment> {
+}
+export declare class Attachment extends Base {
+    data: APIAttachment;
+    constructor(client: BaseClient, data: APIAttachment);
+}
+export declare class AttachmentBuilder {
     data: Partial<AttachmentData>;
     /**
      * Creates a new Attachment instance.
@@ -78,7 +86,7 @@ export declare function resolveAttachment(resolve: Attachment | AttachmentData |
  * @param resources - The list of attachments to resolve.
  * @returns The resolved raw files.
  */
-export declare function resolveFiles(resources: (Attachment | RawFile)[]): Promise<RawFile[]>;
+export declare function resolveFiles(resources: (AttachmentBuilder | RawFile | Attachment)[]): Promise<RawFile[]>;
 /**
  * Resolves the data of an attachment.
  * @param data - The resolvable data of the attachment.

package/lib/builders/Attachment.js

@@ -3,12 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveImage = exports.resolveBase64 = exports.resolveAttachmentData = exports.resolveFiles = exports.resolveAttachment = exports.Attachment = void 0;
+exports.resolveImage = exports.resolveBase64 = exports.resolveAttachmentData = exports.resolveFiles = exports.resolveAttachment = exports.AttachmentBuilder = exports.Attachment = void 0;
 const node_crypto_1 = require("node:crypto");
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 const __1 = require("..");
-class Attachment {
+const Base_1 = require("../structures/extra/Base");
+class Attachment extends Base_1.Base {
+    data;
+    constructor(client, data) {
+        super(client);
+        this.data = data;
+        this.__patchThis(data);
+    }
+}
+exports.Attachment = Attachment;
+class AttachmentBuilder {
     data;
     /**
      * Creates a new Attachment instance.
@@ -85,7 +95,7 @@ class Attachment {
         return this.data;
     }
 }
-exports.Attachment = Attachment;
+exports.AttachmentBuilder = AttachmentBuilder;
 /**
  * Resolves an attachment to a REST API attachment.
  * @param resolve - The attachment or attachment data to resolve.
@@ -94,7 +104,7 @@ exports.Attachment = Attachment;
 function resolveAttachment(resolve) {
     if ('id' in resolve)
         return resolve;
-    if (resolve instanceof Attachment) {
+    if (resolve instanceof AttachmentBuilder) {
         const data = resolve.toJSON();
         return { filename: data.name, description: data.description };
     }
@@ -108,11 +118,20 @@ exports.resolveAttachment = resolveAttachment;
  */
 async function resolveFiles(resources) {
     const data = await Promise.all(resources.map(async (resource, i) => {
-        if (resource instanceof Attachment) {
+        if (resource instanceof AttachmentBuilder) {
             const { type, resolvable, name } = resource.toJSON();
             const resolve = await resolveAttachmentData(resolvable, type);
             return { ...resolve, key: `files[${i}]`, name };
         }
+        if (resource instanceof Attachment) {
+            const resolve = await resolveAttachmentData(resource.url, 'url');
+            return {
+                data: resolve.data,
+                contentType: resolve.contentType,
+                key: `files[${i}]`,
+                name: resource.filename,
+            };
+        }
         return {
             data: resource.data,
             contentType: resource.contentType,
@@ -130,7 +149,7 @@ exports.resolveFiles = resolveFiles;
  * @returns The resolved attachment data.
  */
 async function resolveAttachmentData(data, type) {
-    if (data instanceof Attachment) {
+    if (data instanceof AttachmentBuilder) {
         if (!data.data.resolvable)
             return (0, __1.throwError)('The attachment type has been expressed as attachment but cannot be resolved as one.');
         return { data: data.data.resolvable };
@@ -184,12 +203,16 @@ exports.resolveBase64 = resolveBase64;
  * @returns The resolved base64 data URL.
  */
 async function resolveImage(image) {
-    if (image instanceof Attachment) {
+    if (image instanceof AttachmentBuilder) {
         const { data: { type, resolvable }, } = image;
         if (type && resolvable)
             return resolveBase64((await resolveAttachmentData(resolvable, type)).data);
         return (0, __1.throwError)(`The attachment type has been expressed as ${(type ?? 'Attachment').toUpperCase()} but cannot be resolved as one.`);
     }
+    if (image instanceof Attachment) {
+        const response = await fetch(image.url);
+        return resolveBase64((await resolveAttachmentData(await response.arrayBuffer(), 'buffer')).data);
+    }
     const file = await resolveAttachmentData(image.data, image.type);
     return resolveBase64(file.data);
 }

package/lib/builders/Button.d.ts

@@ -1,6 +1,4 @@
-import { type APIButtonComponent, type APIButtonComponentWithCustomId, type APIButtonComponentWithURL, type ButtonStyle, type EmojiResolvable, type When } from '../common';
-import type { ButtonInteraction } from '../structures';
-import type { ComponentCallback } from './types';
+import { type APIButtonComponentWithCustomId, type APIButtonComponentWithURL, type ButtonStyle, type EmojiResolvable, type When } from '../common';
 export type ButtonStylesForID = Exclude<ButtonStyle, ButtonStyle.Link>;
 /**
  * Represents a button component.
@@ -18,13 +16,13 @@ export declare class Button<Type extends boolean = boolean> {
      * @param id - The custom ID to set.
      * @returns The modified Button instance.
      */
-    setCustomId(id: string): Omit<this, 'setURL'>;
+    setCustomId(id: string): this;
     /**
      * Sets the URL for the button.
      * @param url - The URL to set.
      * @returns The modified Button instance.
      */
-    setURL(url: string): Omit<this, 'setCustomId' | 'run'>;
+    setURL(url: string): this;
     /**
      * Sets the label for the button.
      * @param label - The label to set.
@@ -43,17 +41,10 @@ export declare class Button<Type extends boolean = boolean> {
      * @returns The modified Button instance.
      */
     setDisabled(disabled?: boolean): this;
-    setStyle(style: ButtonStyle.Link): Omit<this, 'setCustomId' | 'run'>;
-    setStyle(style: ButtonStylesForID): Omit<this, 'setURL'>;
-    /**
-     * Sets the callback function to be executed when the button is interacted with.
-     * @param func - The callback function to set.
-     * @returns The modified Button instance.
-     */
-    run(func: ComponentCallback<ButtonInteraction>): Omit<this, 'setURL'>;
+    setStyle(style: ButtonStyle): this;
     /**
      * Converts the Button instance to its JSON representation.
      * @returns The JSON representation of the Button instance.
      */
-    toJSON(): APIButtonComponent;
+    toJSON(): When<Type, APIButtonComponentWithCustomId, APIButtonComponentWithURL>;
 }

package/lib/builders/Button.js

@@ -10,8 +10,6 @@ const functions_1 = require("../structures/extra/functions");
  */
 class Button {
     data;
-    /** @internal */
-    __exec;
     /**
      * Creates a new Button instance.
      * @param data - The initial data for the button.
@@ -74,15 +72,6 @@ class Button {
         this.data.style = style;
         return this;
     }
-    /**
-     * Sets the callback function to be executed when the button is interacted with.
-     * @param func - The callback function to set.
-     * @returns The modified Button instance.
-     */
-    run(func) {
-        this.__exec = func;
-        return this;
-    }
     /**
      * Converts the Button instance to its JSON representation.
      * @returns The JSON representation of the Button instance.

package/lib/builders/{MessageEmbed.d.ts → Embed.d.ts}

@@ -2,7 +2,7 @@ import { type APIEmbed, type APIEmbedAuthor, type APIEmbedField, type APIEmbedFo
 /**
  * Represents a message embed.
  * @example
- * const embed = new MessageEmbed();
+ * const embed = new Embed();
  * embed.setTitle('Seyfert');
  * embed.setDescription('Better than discord.js');
  * embed.setColor('Green');
@@ -11,16 +11,16 @@ import { type APIEmbed, type APIEmbedAuthor, type APIEmbedField, type APIEmbedFo
 export declare class Embed {
     data: Partial<APIEmbed>;
     /**
-     * Creates a new instance of MessageEmbed.
+     * Creates a new instance of Embed.
      * @param data - The initial data for the embed.
      * @example
-     * const embed = new MessageEmbed({ title: 'Hello', description: 'This is an example embed' });
+     * const embed = new Embed({ title: 'Hello', description: 'This is an example embed' });
      */
     constructor(data?: Partial<APIEmbed>);
     /**
      * Sets the author of the embed.
      * @param author - The author information.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setAuthor({ name: 'John Doe', iconURL: 'https://example.com/avatar.png' });
      */
@@ -28,7 +28,7 @@ export declare class Embed {
     /**
      * Sets the color of the embed.
      * @param color - The color of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setColor('#FF0000');
      * embed.setColor('Blurple');
@@ -37,7 +37,7 @@ export declare class Embed {
     /**
      * Sets the description of the embed.
      * @param desc - The description of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setDescription('This is the description of the embed');
      */
@@ -45,7 +45,7 @@ export declare class Embed {
     /**
      * Adds one or more fields to the embed.
      * @param fields - The fields to add to the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.addFields({ name: 'Field 1', value: 'Value 1' }, { name: 'Field 2', value: 'Value 2' });
      */
@@ -53,7 +53,7 @@ export declare class Embed {
     /**
      * Sets the fields of the embed.
      * @param fields - The fields of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setFields([{ name: 'Field 1', value: 'Value 1' }, { name: 'Field 2', value: 'Value 2' }]);
      */
@@ -61,7 +61,7 @@ export declare class Embed {
     /**
      * Sets the footer of the embed.
      * @param footer - The footer information.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setFooter({ text: 'This is the footer', iconURL: 'https://example.com/footer.png' });
      */
@@ -69,7 +69,7 @@ export declare class Embed {
     /**
      * Sets the image of the embed.
      * @param url - The URL of the image.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setImage('https://example.com/image.png');
      */
@@ -77,7 +77,7 @@ export declare class Embed {
     /**
      * Sets the timestamp of the embed.
      * @param time - The timestamp value.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setTimestamp();
      * embed.setTimestamp(1628761200000);
@@ -87,7 +87,7 @@ export declare class Embed {
     /**
      * Sets the title of the embed.
      * @param title - The title of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setTitle('This is the title');
      */
@@ -95,7 +95,7 @@ export declare class Embed {
     /**
      * Sets the URL of the embed.
      * @param url - The URL of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setURL('https://seyfert.com');
      */
@@ -103,13 +103,13 @@ export declare class Embed {
     /**
      * Sets the thumbnail of the embed.
      * @param url - The URL of the thumbnail.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setThumbnail('https://example.com/thumbnail.png');
      */
     setThumbnail(url?: string): this;
     /**
-     * Converts the MessageEmbed instance to a JSON object.
+     * Converts the Embed instance to a JSON object.
      * @returns The JSON representation of the MessageEmbed instance.
      */
     toJSON(): APIEmbed;

package/lib/builders/{MessageEmbed.js → Embed.js}

@@ -5,7 +5,7 @@ const common_1 = require("../common");
 /**
  * Represents a message embed.
  * @example
- * const embed = new MessageEmbed();
+ * const embed = new Embed();
  * embed.setTitle('Seyfert');
  * embed.setDescription('Better than discord.js');
  * embed.setColor('Green');
@@ -14,10 +14,10 @@ const common_1 = require("../common");
 class Embed {
     data;
     /**
-     * Creates a new instance of MessageEmbed.
+     * Creates a new instance of Embed.
      * @param data - The initial data for the embed.
      * @example
-     * const embed = new MessageEmbed({ title: 'Hello', description: 'This is an example embed' });
+     * const embed = new Embed({ title: 'Hello', description: 'This is an example embed' });
      */
     constructor(data = {}) {
         this.data = data;
@@ -27,7 +27,7 @@ class Embed {
     /**
      * Sets the author of the embed.
      * @param author - The author information.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setAuthor({ name: 'John Doe', iconURL: 'https://example.com/avatar.png' });
      */
@@ -38,7 +38,7 @@ class Embed {
     /**
      * Sets the color of the embed.
      * @param color - The color of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setColor('#FF0000');
      * embed.setColor('Blurple');
@@ -50,7 +50,7 @@ class Embed {
     /**
      * Sets the description of the embed.
      * @param desc - The description of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setDescription('This is the description of the embed');
      */
@@ -61,18 +61,18 @@ class Embed {
     /**
      * Adds one or more fields to the embed.
      * @param fields - The fields to add to the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.addFields({ name: 'Field 1', value: 'Value 1' }, { name: 'Field 2', value: 'Value 2' });
      */
     addFields(...fields) {
-        this.data.fields = this.data.fields.concat((0, common_1.fastFlat)(fields));
+        this.data.fields = this.data.fields.concat(fields.flat());
         return this;
     }
     /**
      * Sets the fields of the embed.
      * @param fields - The fields of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setFields([{ name: 'Field 1', value: 'Value 1' }, { name: 'Field 2', value: 'Value 2' }]);
      */
@@ -83,7 +83,7 @@ class Embed {
     /**
      * Sets the footer of the embed.
      * @param footer - The footer information.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setFooter({ text: 'This is the footer', iconURL: 'https://example.com/footer.png' });
      */
@@ -94,7 +94,7 @@ class Embed {
     /**
      * Sets the image of the embed.
      * @param url - The URL of the image.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setImage('https://example.com/image.png');
      */
@@ -105,7 +105,7 @@ class Embed {
     /**
      * Sets the timestamp of the embed.
      * @param time - The timestamp value.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setTimestamp();
      * embed.setTimestamp(1628761200000);
@@ -118,7 +118,7 @@ class Embed {
     /**
      * Sets the title of the embed.
      * @param title - The title of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setTitle('This is the title');
      */
@@ -129,7 +129,7 @@ class Embed {
     /**
      * Sets the URL of the embed.
      * @param url - The URL of the embed.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setURL('https://seyfert.com');
      */
@@ -140,7 +140,7 @@ class Embed {
     /**
      * Sets the thumbnail of the embed.
      * @param url - The URL of the thumbnail.
-     * @returns The updated MessageEmbed instance.
+     * @returns The updated Embed instance.
      * @example
      * embed.setThumbnail('https://example.com/thumbnail.png');
      */
@@ -149,7 +149,7 @@ class Embed {
         return this;
     }
     /**
-     * Converts the MessageEmbed instance to a JSON object.
+     * Converts the Embed instance to a JSON object.
      * @returns The JSON representation of the MessageEmbed instance.
      */
     toJSON() {

package/lib/builders/Modal.js

@@ -35,7 +35,7 @@ class Modal {
      * @returns The current Modal instance.
      */
     addComponents(...components) {
-        this.components = this.components.concat((0, common_1.fastFlat)(components));
+        this.components = this.components.concat(components.flat());
         return this;
     }
     /**