@discordeno/utils 19.0.0-next.a196e22 → 19.0.0-next.a26c7c0

package/README.md

@@ -149,6 +149,6 @@ and unofficial templates:
 
 ## Links
 
-- [Website](https://discordeno.github.io/discordeno/)
+- [Website](https://discordeno.js.org/)
 - [Documentation](https://doc.deno.land/https/deno.land/x/discordeno/mod.ts)
 - [Discord](https://discord.com/invite/5vBgXk3UcZ)

package/dist/bucket.d.ts

@@ -9,13 +9,15 @@ export declare class LeakyBucket implements LeakyBucketOptions {
     queue: Array<(value: void | PromiseLike<void>) => void>;
     /** Whether or not the queue is already processing. */
     processing: boolean;
-    /** The timeout id for the timer to reduce the used amount by the refill amount.  */
+    /** The timeout id for the timer to reduce the used amount by the refill amount. */
     timeoutId?: NodeJS.Timeout;
     /** The timestamp in milliseconds when the next refill is scheduled. */
     refillsAt?: number;
     constructor(options?: LeakyBucketOptions);
     /** The amount of requests that still remain. */
     get remaining(): number;
+    /** Refills the bucket as needed. */
+    refillBucket(): void;
     /** Begin processing the queue. */
     processQueue(): Promise<void>;
     /** Pauses the execution until the request is available to be made. */

package/dist/bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bucket.d.ts","sourceRoot":"","sources":["../src/bucket.ts"],"names":[],"mappings":";AAGA,qBAAa,WAAY,YAAW,kBAAkB;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IAEpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAI;IAChB,4FAA4F;IAC5F,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAK;IAC5D,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAQ;IAC3B,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAA;IAC1B,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;gBAEN,OAAO,CAAC,EAAE,kBAAkB;IAMxC,gDAAgD;IAChD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kCAAkC;IAC5B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDnC,sEAAsE;IAChE,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAWrD;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB"}
+{"version":3,"file":"bucket.d.ts","sourceRoot":"","sources":["../src/bucket.ts"],"names":[],"mappings":";AAGA,qBAAa,WAAY,YAAW,kBAAkB;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IAEpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAI;IAChB,4FAA4F;IAC5F,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAK;IAC5D,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAQ;IAC3B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAA;IAC1B,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;gBAEN,OAAO,CAAC,EAAE,kBAAkB;IAMxC,gDAAgD;IAChD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,oCAAoC;IACpC,YAAY,IAAI,IAAI;IAkBpB,kCAAkC;IAC5B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDnC,sEAAsE;IAChE,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAWrD;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB"}

package/dist/bucket.js

@@ -12,13 +12,27 @@ export class LeakyBucket {
     /** The amount of requests that still remain. */ get remaining() {
         return this.max < this.used ? 0 : this.max - this.used;
     }
+    /** Refills the bucket as needed. */ refillBucket() {
+        logger.debug(`[LeakyBucket] Timeout for leaky bucket requests executed. Refilling bucket.`);
+        // Lower the used amount by the refill amount
+        this.used = this.refillAmount > this.used ? 0 : this.used - this.refillAmount;
+        // Reset the refillsAt timestamp since it just got refilled
+        this.refillsAt = undefined;
+        // Reset the timeoutId
+        clearTimeout(this.timeoutId);
+        this.timeoutId = undefined;
+        if (this.used > 0) {
+            this.timeoutId = setTimeout(()=>{
+                this.refillBucket();
+            }, this.refillInterval);
+            this.refillsAt = Date.now() + this.refillInterval;
+        }
+    }
     /** Begin processing the queue. */ async processQueue() {
-        logger.debug('[Gateway] Processing queue');
+        logger.debug('[LeakyBucket] Processing queue');
         // There is already a queue that is processing
-        if (this.processing) {
-            logger.debug('[Gateway] Queue is already processing.');
-            return;
-        }
+        if (this.processing) return logger.debug('[LeakyBucket] Queue is already processing.');
+        this.processing = true;
         // Begin going through the queue.
         while(this.queue.length){
             if (this.remaining) {
@@ -31,11 +45,7 @@ export class LeakyBucket {
                 if (!this.timeoutId) {
                     logger.debug(`[LeakyBucket] Creating new timeout for leaky bucket requests.`);
                     this.timeoutId = setTimeout(()=>{
-                        logger.debug(`[LeakyBucket] Timeout for leaky bucket requests executed. Refilling bucket.`);
-                        // Lower the used amount by the refill amount
-                        this.used -= this.refillAmount;
-                        // Reset the refillsAt timestamp since it just got refilled
-                        this.refillsAt = undefined;
+                        this.refillBucket();
                     }, this.refillInterval);
                     // Set the time for when this refill will occur.
                     this.refillsAt = Date.now() + this.refillInterval;
@@ -47,6 +57,9 @@ export class LeakyBucket {
                     logger.debug(`[LeakyBucket] Delaying execution of leaky bucket requests for ${this.refillsAt - now}ms`);
                     await delay(this.refillsAt - now);
                     logger.debug(`[LeakyBucket] Resuming execution`);
+                } else {
+                    logger.debug(`[LeakyBucket] Delaying execution of leaky bucket requests for 1000ms`);
+                    await delay(1000);
                 }
             }
         }
@@ -58,7 +71,7 @@ export class LeakyBucket {
             // High priority requests get added to the start of the queue
             if (highPriority) this.queue.unshift(resolve);
             else this.queue.push(resolve);
-            // Each request should trigger the queue to be processesd.
+            // Each request should trigger the queue to be processed.
             void this.processQueue();
         });
     }

package/dist/bucket.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bucket.ts"],"sourcesContent":["import logger from './logger.js'\nimport { delay } from './utils.js'\n\nexport class LeakyBucket implements LeakyBucketOptions {\n  max: number\n  refillInterval: number\n  refillAmount: number\n\n  /** The amount of requests that have been used up already. */\n  used: number = 0\n  /** The queue of requests to acquire an available request. Mapped by <shardId, resolve()> */\n  queue: Array<(value: void | PromiseLike<void>) => void> = []\n  /** Whether or not the queue is already processing. */\n  processing: boolean = false\n  /** The timeout id for the timer to reduce the used amount by the refill amount.  */\n  timeoutId?: NodeJS.Timeout\n  /** The timestamp in milliseconds when the next refill is scheduled. */\n  refillsAt?: number\n\n  constructor(options?: LeakyBucketOptions) {\n    this.max = options?.max ?? 1\n    this.refillAmount = options?.refillAmount ? (options.refillAmount > this.max ? this.max : options.refillAmount) : 1\n    this.refillInterval = options?.refillInterval ?? 5000\n  }\n\n  /** The amount of requests that still remain. */\n  get remaining(): number {\n    return this.max < this.used ? 0 : this.max - this.used\n  }\n\n  /** Begin processing the queue. */\n  async processQueue(): Promise<void> {\n    logger.debug('[Gateway] Processing queue')\n    // There is already a queue that is processing\n    if (this.processing) {\n      logger.debug('[Gateway] Queue is already processing.')\n      return\n    }\n\n    // Begin going through the queue.\n    while (this.queue.length) {\n      if (this.remaining) {\n        logger.debug(`[LeakyBucket] Processing queue. Remaining: ${this.remaining} Length: ${this.queue.length}`)\n        // Resolves the promise allowing the paused execution of this request to resolve and continue.\n        this.queue.shift()?.()\n        // A request can be made\n        this.used++\n\n        // Create a new timeout for this request if none exists.\n        if (!this.timeoutId) {\n          logger.debug(`[LeakyBucket] Creating new timeout for leaky bucket requests.`)\n          this.timeoutId = setTimeout(() => {\n            logger.debug(`[LeakyBucket] Timeout for leaky bucket requests executed. Refilling bucket.`)\n            // Lower the used amount by the refill amount\n            this.used -= this.refillAmount\n            // Reset the refillsAt timestamp since it just got refilled\n            this.refillsAt = undefined\n          }, this.refillInterval)\n          // Set the time for when this refill will occur.\n          this.refillsAt = Date.now() + this.refillInterval\n        }\n      }\n\n      // Check if a refill is scheduled, since we have used up all available requests\n      else if (this.refillsAt) {\n        const now = Date.now()\n        // If there is time left until next refill, just delay execution.\n        if (this.refillsAt > now) {\n          logger.debug(`[LeakyBucket] Delaying execution of leaky bucket requests for ${this.refillsAt - now}ms`)\n          await delay(this.refillsAt - now)\n          logger.debug(`[LeakyBucket] Resuming execution`)\n        }\n      }\n    }\n\n    // Loop has ended mark false so it can restart later when needed\n    this.processing = false\n  }\n\n  /** Pauses the execution until the request is available to be made. */\n  async acquire(highPriority?: boolean): Promise<void> {\n    return await new Promise((resolve) => {\n      // High priority requests get added to the start of the queue\n      if (highPriority) this.queue.unshift(resolve)\n      // All other requests get pushed to the end.\n      else this.queue.push(resolve)\n\n      // Each request should trigger the queue to be processesd.\n      void this.processQueue()\n    })\n  }\n}\n\nexport interface LeakyBucketOptions {\n  /**\n   * Max requests allowed at once.\n   * @default 1\n   */\n  max?: number\n  /**\n   * Interval in milliseconds between refills.\n   * @default 5000\n   */\n  refillInterval?: number\n  /**\n   * Amount of requests to refill at each interval.\n   * @default 1\n   */\n  refillAmount?: number\n}\n"],"names":["logger","delay","LeakyBucket","constructor","options","used","queue","processing","max","refillAmount","refillInterval","remaining","processQueue","debug","length","shift","timeoutId","setTimeout","refillsAt","undefined","Date","now","acquire","highPriority","Promise","resolve","unshift","push"],"mappings":"AAAA,OAAOA,YAAY,cAAa;AAChC,SAASC,KAAK,QAAQ,aAAY;AAElC,OAAO,MAAMC;IAgBXC,YAAYC,OAA4B,CAAE;QAX1C,2DAA2D,QAC3DC,OAAe;QACf,0FAA0F,QAC1FC,QAA0D,EAAE;QAC5D,oDAAoD,QACpDC,aAAsB,KAAK;QAOzB,IAAI,CAACC,GAAG,GAAGJ,SAASI,OAAO;QAC3B,IAAI,CAACC,YAAY,GAAGL,SAASK,eAAgBL,QAAQK,YAAY,GAAG,IAAI,CAACD,GAAG,GAAG,IAAI,CAACA,GAAG,GAAGJ,QAAQK,YAAY,GAAI,CAAC;QACnH,IAAI,CAACC,cAAc,GAAGN,SAASM,kBAAkB;IACnD;IAEA,8CAA8C,GAC9C,IAAIC,YAAoB;QACtB,OAAO,IAAI,CAACH,GAAG,GAAG,IAAI,CAACH,IAAI,GAAG,IAAI,IAAI,CAACG,GAAG,GAAG,IAAI,CAACH,IAAI;IACxD;IAEA,gCAAgC,GAChC,MAAMO,eAA8B;QAClCZ,OAAOa,KAAK,CAAC;QACb,8CAA8C;QAC9C,IAAI,IAAI,CAACN,UAAU,EAAE;YACnBP,OAAOa,KAAK,CAAC;YACb;QACF,CAAC;QAED,iCAAiC;QACjC,MAAO,IAAI,CAACP,KAAK,CAACQ,MAAM,CAAE;YACxB,IAAI,IAAI,CAACH,SAAS,EAAE;gBAClBX,OAAOa,KAAK,CAAC,CAAC,2CAA2C,EAAE,IAAI,CAACF,SAAS,CAAC,SAAS,EAAE,IAAI,CAACL,KAAK,CAACQ,MAAM,CAAC,CAAC;gBACxG,8FAA8F;gBAC9F,IAAI,CAACR,KAAK,CAACS,KAAK;gBAChB,wBAAwB;gBACxB,IAAI,CAACV,IAAI;gBAET,wDAAwD;gBACxD,IAAI,CAAC,IAAI,CAACW,SAAS,EAAE;oBACnBhB,OAAOa,KAAK,CAAC,CAAC,6DAA6D,CAAC;oBAC5E,IAAI,CAACG,SAAS,GAAGC,WAAW,IAAM;wBAChCjB,OAAOa,KAAK,CAAC,CAAC,2EAA2E,CAAC;wBAC1F,6CAA6C;wBAC7C,IAAI,CAACR,IAAI,IAAI,IAAI,CAACI,YAAY;wBAC9B,2DAA2D;wBAC3D,IAAI,CAACS,SAAS,GAAGC;oBACnB,GAAG,IAAI,CAACT,cAAc;oBACtB,gDAAgD;oBAChD,IAAI,CAACQ,SAAS,GAAGE,KAAKC,GAAG,KAAK,IAAI,CAACX,cAAc;gBACnD,CAAC;YACH,OAGK,IAAI,IAAI,CAACQ,SAAS,EAAE;gBACvB,MAAMG,MAAMD,KAAKC,GAAG;gBACpB,iEAAiE;gBACjE,IAAI,IAAI,CAACH,SAAS,GAAGG,KAAK;oBACxBrB,OAAOa,KAAK,CAAC,CAAC,8DAA8D,EAAE,IAAI,CAACK,SAAS,GAAGG,IAAI,EAAE,CAAC;oBACtG,MAAMpB,MAAM,IAAI,CAACiB,SAAS,GAAGG;oBAC7BrB,OAAOa,KAAK,CAAC,CAAC,gCAAgC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH;QAEA,gEAAgE;QAChE,IAAI,CAACN,UAAU,GAAG,KAAK;IACzB;IAEA,oEAAoE,GACpE,MAAMe,QAAQC,YAAsB,EAAiB;QACnD,OAAO,MAAM,IAAIC,QAAQ,CAACC,UAAY;YACpC,6DAA6D;YAC7D,IAAIF,cAAc,IAAI,CAACjB,KAAK,CAACoB,OAAO,CAACD;iBAEhC,IAAI,CAACnB,KAAK,CAACqB,IAAI,CAACF;YAErB,0DAA0D;YAC1D,KAAK,IAAI,CAACb,YAAY;QACxB;IACF;AACF,CAAC"}
+{"version":3,"sources":["../src/bucket.ts"],"sourcesContent":["import logger from './logger.js'\nimport { delay } from './utils.js'\n\nexport class LeakyBucket implements LeakyBucketOptions {\n  max: number\n  refillInterval: number\n  refillAmount: number\n\n  /** The amount of requests that have been used up already. */\n  used: number = 0\n  /** The queue of requests to acquire an available request. Mapped by <shardId, resolve()> */\n  queue: Array<(value: void | PromiseLike<void>) => void> = []\n  /** Whether or not the queue is already processing. */\n  processing: boolean = false\n  /** The timeout id for the timer to reduce the used amount by the refill amount. */\n  timeoutId?: NodeJS.Timeout\n  /** The timestamp in milliseconds when the next refill is scheduled. */\n  refillsAt?: number\n\n  constructor(options?: LeakyBucketOptions) {\n    this.max = options?.max ?? 1\n    this.refillAmount = options?.refillAmount ? (options.refillAmount > this.max ? this.max : options.refillAmount) : 1\n    this.refillInterval = options?.refillInterval ?? 5000\n  }\n\n  /** The amount of requests that still remain. */\n  get remaining(): number {\n    return this.max < this.used ? 0 : this.max - this.used\n  }\n\n  /** Refills the bucket as needed. */\n  refillBucket(): void {\n    logger.debug(`[LeakyBucket] Timeout for leaky bucket requests executed. Refilling bucket.`)\n    // Lower the used amount by the refill amount\n    this.used = this.refillAmount > this.used ? 0 : this.used - this.refillAmount\n    // Reset the refillsAt timestamp since it just got refilled\n    this.refillsAt = undefined\n    // Reset the timeoutId\n    clearTimeout(this.timeoutId)\n    this.timeoutId = undefined\n\n    if (this.used > 0) {\n      this.timeoutId = setTimeout(() => {\n        this.refillBucket()\n      }, this.refillInterval)\n      this.refillsAt = Date.now() + this.refillInterval\n    }\n  }\n\n  /** Begin processing the queue. */\n  async processQueue(): Promise<void> {\n    logger.debug('[LeakyBucket] Processing queue')\n\n    // There is already a queue that is processing\n    if (this.processing) return logger.debug('[LeakyBucket] Queue is already processing.')\n\n    this.processing = true\n\n    // Begin going through the queue.\n    while (this.queue.length) {\n      if (this.remaining) {\n        logger.debug(`[LeakyBucket] Processing queue. Remaining: ${this.remaining} Length: ${this.queue.length}`)\n        // Resolves the promise allowing the paused execution of this request to resolve and continue.\n        this.queue.shift()?.()\n        // A request can be made\n        this.used++\n\n        // Create a new timeout for this request if none exists.\n        if (!this.timeoutId) {\n          logger.debug(`[LeakyBucket] Creating new timeout for leaky bucket requests.`)\n\n          this.timeoutId = setTimeout(() => {\n            this.refillBucket()\n          }, this.refillInterval)\n          // Set the time for when this refill will occur.\n          this.refillsAt = Date.now() + this.refillInterval\n        }\n      }\n\n      // Check if a refill is scheduled, since we have used up all available requests\n      else if (this.refillsAt) {\n        const now = Date.now()\n        // If there is time left until next refill, just delay execution.\n        if (this.refillsAt > now) {\n          logger.debug(`[LeakyBucket] Delaying execution of leaky bucket requests for ${this.refillsAt - now}ms`)\n          await delay(this.refillsAt - now)\n          logger.debug(`[LeakyBucket] Resuming execution`)\n        }\n\n        // If the refillsAt has passed but the timeout didn't yet execute delay the execution\n        else {\n          logger.debug(`[LeakyBucket] Delaying execution of leaky bucket requests for 1000ms`)\n          await delay(1000)\n        }\n      }\n    }\n\n    // Loop has ended mark false so it can restart later when needed\n    this.processing = false\n  }\n\n  /** Pauses the execution until the request is available to be made. */\n  async acquire(highPriority?: boolean): Promise<void> {\n    return await new Promise((resolve) => {\n      // High priority requests get added to the start of the queue\n      if (highPriority) this.queue.unshift(resolve)\n      // All other requests get pushed to the end.\n      else this.queue.push(resolve)\n\n      // Each request should trigger the queue to be processed.\n      void this.processQueue()\n    })\n  }\n}\n\nexport interface LeakyBucketOptions {\n  /**\n   * Max requests allowed at once.\n   * @default 1\n   */\n  max?: number\n  /**\n   * Interval in milliseconds between refills.\n   * @default 5000\n   */\n  refillInterval?: number\n  /**\n   * Amount of requests to refill at each interval.\n   * @default 1\n   */\n  refillAmount?: number\n}\n"],"names":["logger","delay","LeakyBucket","constructor","options","used","queue","processing","max","refillAmount","refillInterval","remaining","refillBucket","debug","refillsAt","undefined","clearTimeout","timeoutId","setTimeout","Date","now","processQueue","length","shift","acquire","highPriority","Promise","resolve","unshift","push"],"mappings":"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"}

package/dist/builders/embeds.d.ts

@@ -0,0 +1,146 @@
+import type { DiscordEmbed, DiscordEmbedAuthor, DiscordEmbedField, DiscordEmbedFooter, DiscordEmbedImage, DiscordEmbedThumbnail, DiscordEmbedVideo } from '@discordeno/types';
+/**
+ * A builder to help create Discord embeds.
+ *
+ * @export
+ * @class EmbedsBuilder
+ * @typedef {EmbedsBuilder}
+ * @extends {Array<DiscordEmbed>}
+ * @example
+ * const embeds = new EmbedBuilder()
+ *  .setTitle('My Embed')
+ *  .setDescription('This is my new embed')
+ *  .newEmbed()
+ *  .setTitle('My Second Embed')
+ */
+export declare class EmbedsBuilder extends Array<DiscordEmbed> {
+    #private;
+    /**
+     * Adds a new field to the embed fields array.
+     *
+     * @param {string} name - Field name
+     * @param {string} value - Field value
+     * @param {?boolean} [inline=false] - Field should be inline or not.
+     * @returns {EmbedsBuilder}
+     */
+    addField(name: string, value: string, inline?: boolean): EmbedsBuilder;
+    /**
+     * Creates a blank embed.
+     *
+     * @returns {EmbedsBuilder}
+     */
+    newEmbed(): EmbedsBuilder;
+    /**
+     * Set the current embed author.
+     *
+     * @param {string} name - Name of the author
+     * @param {?Omit<DiscordEmbedAuthor, 'name'>} [options] - Extra author options
+     * @returns {EmbedsBuilder}
+     */
+    setAuthor(name: string, options?: Omit<DiscordEmbedAuthor, 'name'>): EmbedsBuilder;
+    /**
+     * Set the color on the side of the current embed.
+     *
+     * @param {(number | string)} color - The color, in base16 or hex color code
+     * @returns {EmbedsBuilder}
+     */
+    setColor(color: number | string): EmbedsBuilder;
+    /**
+     * Set the current embed to a different index.
+     *
+     * WARNING: Only use this method if you know what you're doing. Make sure to set it back to the latest when you're done.
+     *
+     * @param {?number} [index] - The index of the embed in the EmbedsBuilder array
+     * @returns {EmbedsBuilder}
+     */
+    setCurrentEmbed(index?: number): EmbedsBuilder;
+    /**
+     * Set the description of the current embed.
+     *
+     * @param {string} description - Description
+     * @returns {EmbedsBuilder}
+     */
+    setDescription(description: string): EmbedsBuilder;
+    /**
+     * Overwrite all fields on the current embed.
+     *
+     * @param {DiscordEmbedField[]} fields
+     * @returns {EmbedsBuilder}
+     */
+    setFields(fields: DiscordEmbedField[]): EmbedsBuilder;
+    /**
+     * Set the footer in the current embed.
+     *
+     * @param {string} text - The text to display in the footer
+     * @param {?Omit<DiscordEmbedFooter, 'text'>} [options]
+     * @returns {EmbedsBuilder}
+     */
+    setFooter(text: string, options?: Omit<DiscordEmbedFooter, 'text'>): EmbedsBuilder;
+    /**
+     * Set the image in the current embed.
+     *
+     * @param {string} url - URL of the image
+     * @param {?Omit<DiscordEmbedImage, 'url'>} [options]
+     * @returns {EmbedsBuilder}
+     */
+    setImage(url: string, options?: Omit<DiscordEmbedImage, 'url'>): EmbedsBuilder;
+    /**
+     * Set the provider of the current embed.
+     *
+     * @param {string} name
+     * @param {?string} [url]
+     * @returns {EmbedsBuilder}
+     */
+    setProvider(name: string, url?: string): EmbedsBuilder;
+    /**
+     * Set the color of the current embed to a random value.
+     *
+     * @returns {EmbedsBuilder}
+     */
+    setRandomColor(): EmbedsBuilder;
+    /**
+     * Set the title of the current embed.
+     *
+     * @param {string} title
+     * @param {?string} [url]
+     * @returns {EmbedsBuilder}
+     */
+    setTitle(title: string, url?: string): EmbedsBuilder;
+    /**
+     * Set the timestamp of the current embed.
+     *
+     * @param {?(string | number | Date)} [timestamp]
+     * @returns {EmbedsBuilder}
+     */
+    setTimestamp(timestamp?: string | number | Date): EmbedsBuilder;
+    /**
+     * Set the thumbnail of the current embed.
+     *
+     * @param {string} url - URL of the image
+     * @param {?Omit<DiscordEmbedThumbnail, 'url'>} [options]
+     * @returns {EmbedsBuilder}
+     */
+    setThumbnail(url: string, options?: Omit<DiscordEmbedThumbnail, 'url'>): EmbedsBuilder;
+    /**
+     * Set the URL of the current embed title.
+     *
+     * @param {string} url
+     * @returns {EmbedsBuilder}
+     */
+    setUrl(url: string): EmbedsBuilder;
+    /**
+     * Set the video of the current embed.
+     *
+     * @param {string} url
+     * @param {?Omit<DiscordEmbedVideo, 'url'>} [options]
+     * @returns {EmbedsBuilder}
+     */
+    setVideo(url: string, options?: Omit<DiscordEmbedVideo, 'url'>): EmbedsBuilder;
+    /**
+     * Validate all embeds available against current known Discord limits to help prevent bad requests.
+     *
+     * @returns {EmbedsBuilder}
+     */
+    validate(): EmbedsBuilder;
+}
+//# sourceMappingURL=embeds.d.ts.map

package/dist/builders/embeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeds.d.ts","sourceRoot":"","sources":["../../src/builders/embeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,mBAAmB,CAAA;AAE1B;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,KAAK,CAAC,YAAY,CAAC;;IAGpD;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa;IActE;;;;OAIG;IACH,QAAQ,IAAI,aAAa;IAWzB;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,aAAa;IAUlF;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa;IAW/C;;;;;;;OAOG;IACH,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa;IAgB9C;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAMlD;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,aAAa;IAMrD;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,aAAa;IAUlF;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,aAAa;IAU9E;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa;IAStD;;;;OAIG;IACH,cAAc,IAAI,aAAa;IAI/B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa;IAUpD;;;;;OAKG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,aAAa;IAM/D;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,GAAG,aAAa;IAUtF;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAMlC;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,aAAa;IAU9E;;;;OAIG;IACH,QAAQ,IAAI,aAAa;CA4F1B"}

package/dist/builders/embeds.js

@@ -0,0 +1,295 @@
+/**
+ * A builder to help create Discord embeds.
+ *
+ * @export
+ * @class EmbedsBuilder
+ * @typedef {EmbedsBuilder}
+ * @extends {Array<DiscordEmbed>}
+ * @example
+ * const embeds = new EmbedBuilder()
+ *  .setTitle('My Embed')
+ *  .setDescription('This is my new embed')
+ *  .newEmbed()
+ *  .setTitle('My Second Embed')
+ */ export class EmbedsBuilder extends Array {
+    #currentEmbedIndex;
+    /**
+   * Adds a new field to the embed fields array.
+   *
+   * @param {string} name - Field name
+   * @param {string} value - Field value
+   * @param {?boolean} [inline=false] - Field should be inline or not.
+   * @returns {EmbedsBuilder}
+   */ addField(name, value, inline) {
+        if (this.#currentEmbed.fields === undefined) {
+            this.#currentEmbed.fields = [];
+        }
+        this.#currentEmbed.fields.push({
+            name,
+            value,
+            inline
+        });
+        return this;
+    }
+    /**
+   * Creates a blank embed.
+   *
+   * @returns {EmbedsBuilder}
+   */ newEmbed() {
+        if (this.length >= 10) {
+            throw new Error('Maximum embed count exceeded. You can not have more than 10 embeds.');
+        }
+        this.push({});
+        this.setCurrentEmbed();
+        return this;
+    }
+    /**
+   * Set the current embed author.
+   *
+   * @param {string} name - Name of the author
+   * @param {?Omit<DiscordEmbedAuthor, 'name'>} [options] - Extra author options
+   * @returns {EmbedsBuilder}
+   */ setAuthor(name, options) {
+        this.#currentEmbed.author = {
+            ...this.#currentEmbed.author,
+            ...options,
+            name
+        };
+        return this;
+    }
+    /**
+   * Set the color on the side of the current embed.
+   *
+   * @param {(number | string)} color - The color, in base16 or hex color code
+   * @returns {EmbedsBuilder}
+   */ setColor(color) {
+        if (typeof color === 'string') {
+            const convertedValue = parseInt(color.replace('#', ''), 16);
+            color = Number.isNaN(convertedValue) ? 0 : convertedValue;
+        }
+        this.#currentEmbed.color = color;
+        return this;
+    }
+    /**
+   * Set the current embed to a different index.
+   *
+   * WARNING: Only use this method if you know what you're doing. Make sure to set it back to the latest when you're done.
+   *
+   * @param {?number} [index] - The index of the embed in the EmbedsBuilder array
+   * @returns {EmbedsBuilder}
+   */ setCurrentEmbed(index) {
+        if (index === undefined) {
+            this.#currentEmbedIndex = this.length - 1;
+            return this;
+        }
+        if (index >= this.length || index < 0) {
+            throw new Error('Can not set the current embed to a index out of bounds.');
+        }
+        this.#currentEmbedIndex = index;
+        return this;
+    }
+    /**
+   * Set the description of the current embed.
+   *
+   * @param {string} description - Description
+   * @returns {EmbedsBuilder}
+   */ setDescription(description) {
+        this.#currentEmbed.description = description;
+        return this;
+    }
+    /**
+   * Overwrite all fields on the current embed.
+   *
+   * @param {DiscordEmbedField[]} fields
+   * @returns {EmbedsBuilder}
+   */ setFields(fields) {
+        this.#currentEmbed.fields = fields;
+        return this;
+    }
+    /**
+   * Set the footer in the current embed.
+   *
+   * @param {string} text - The text to display in the footer
+   * @param {?Omit<DiscordEmbedFooter, 'text'>} [options]
+   * @returns {EmbedsBuilder}
+   */ setFooter(text, options) {
+        this.#currentEmbed.footer = {
+            ...this.#currentEmbed.footer,
+            ...options,
+            text
+        };
+        return this;
+    }
+    /**
+   * Set the image in the current embed.
+   *
+   * @param {string} url - URL of the image
+   * @param {?Omit<DiscordEmbedImage, 'url'>} [options]
+   * @returns {EmbedsBuilder}
+   */ setImage(url, options) {
+        this.#currentEmbed.image = {
+            ...this.#currentEmbed.image,
+            ...options,
+            url
+        };
+        return this;
+    }
+    /**
+   * Set the provider of the current embed.
+   *
+   * @param {string} name
+   * @param {?string} [url]
+   * @returns {EmbedsBuilder}
+   */ setProvider(name, url) {
+        this.#currentEmbed.provider = {
+            name,
+            url
+        };
+        return this;
+    }
+    /**
+   * Set the color of the current embed to a random value.
+   *
+   * @returns {EmbedsBuilder}
+   */ setRandomColor() {
+        return this.setColor(Math.floor(Math.random() * (0xffffff + 1)));
+    }
+    /**
+   * Set the title of the current embed.
+   *
+   * @param {string} title
+   * @param {?string} [url]
+   * @returns {EmbedsBuilder}
+   */ setTitle(title, url) {
+        this.#currentEmbed.title = title;
+        if (url) {
+            this.setUrl(url);
+        }
+        return this;
+    }
+    /**
+   * Set the timestamp of the current embed.
+   *
+   * @param {?(string | number | Date)} [timestamp]
+   * @returns {EmbedsBuilder}
+   */ setTimestamp(timestamp) {
+        this.#currentEmbed.timestamp = new Date(timestamp).toISOString();
+        return this;
+    }
+    /**
+   * Set the thumbnail of the current embed.
+   *
+   * @param {string} url - URL of the image
+   * @param {?Omit<DiscordEmbedThumbnail, 'url'>} [options]
+   * @returns {EmbedsBuilder}
+   */ setThumbnail(url, options) {
+        this.#currentEmbed.thumbnail = {
+            ...this.#currentEmbed.thumbnail,
+            ...options,
+            url
+        };
+        return this;
+    }
+    /**
+   * Set the URL of the current embed title.
+   *
+   * @param {string} url
+   * @returns {EmbedsBuilder}
+   */ setUrl(url) {
+        this.#currentEmbed.url = url;
+        return this;
+    }
+    /**
+   * Set the video of the current embed.
+   *
+   * @param {string} url
+   * @param {?Omit<DiscordEmbedVideo, 'url'>} [options]
+   * @returns {EmbedsBuilder}
+   */ setVideo(url, options) {
+        this.#currentEmbed.video = {
+            ...this.#currentEmbed.video,
+            ...options,
+            url
+        };
+        return this;
+    }
+    /**
+   * Validate all embeds available against current known Discord limits to help prevent bad requests.
+   *
+   * @returns {EmbedsBuilder}
+   */ validate() {
+        let totalCharacters = 0;
+        if (this.length > 10) {
+            throw new Error('You can not have more than 10 embeds on a single message.');
+        }
+        this.forEach(({ author , description , fields , footer , title  }, index)=>{
+            if (title) {
+                const trimmedTitle = title.trim();
+                if (trimmedTitle.length > 256) {
+                    throw new Error(`Title of embed ${index} can not be longer than 256 characters.`);
+                }
+                totalCharacters += trimmedTitle.length;
+            }
+            if (description) {
+                const trimmedDescription = description.trim();
+                if (trimmedDescription.length > 4096) {
+                    throw new Error(`Description of embed ${index} can not be longer than 4096 characters.`);
+                }
+                totalCharacters += trimmedDescription.length;
+            }
+            if (fields) {
+                if (fields.length > 25) {
+                    throw new Error(`embed ${index} can not have more than 25 fields.`);
+                }
+                fields.forEach(({ name , value  }, fieldIndex)=>{
+                    const trimmedName = name.trim();
+                    const trimmedValue = value.trim();
+                    if (trimmedName.length > 256) {
+                        throw new Error(`Name of field ${fieldIndex} on embed ${index} can not be longer than 256 characters.`);
+                    }
+                    if (trimmedValue.length > 4096) {
+                        throw new Error(`Value of field ${fieldIndex} on embed ${index} can not be longer than 1024 characters.`);
+                    }
+                    totalCharacters += trimmedName.length;
+                    totalCharacters += trimmedValue.length;
+                });
+            }
+            if (footer) {
+                const trimmedFooterText = footer.text.trim();
+                if (trimmedFooterText.length > 2048) {
+                    throw new Error(`Footer text of embed ${index} can not be longer than 2048 characters.`);
+                }
+                totalCharacters += trimmedFooterText.length;
+            }
+            if (author) {
+                const trimmedAuthorName = author.name.trim();
+                if (trimmedAuthorName.length > 256) {
+                    throw new Error(`Author name of embed ${index} can not be longer than 256 characters.`);
+                }
+                totalCharacters += trimmedAuthorName.length;
+            }
+        });
+        if (totalCharacters > 6000) {
+            throw new Error('Total character length of all embeds can not exceed 6000 characters.');
+        }
+        return this;
+    }
+    /**
+   * Returns the current embed.
+   *
+   * @readonly
+   * @type {DiscordEmbed}
+   */ get #currentEmbed() {
+        if (this.length === 0) {
+            this.newEmbed();
+            this.setCurrentEmbed();
+        }
+        return this[this.#currentEmbedIndex];
+    }
+    constructor(...args){
+        super(...args);
+        this.#currentEmbedIndex = 0;
+    }
+}
+
+//# sourceMappingURL=embeds.js.map

package/dist/builders/embeds.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/builders/embeds.ts"],"sourcesContent":["import type {\n  DiscordEmbed,\n  DiscordEmbedAuthor,\n  DiscordEmbedField,\n  DiscordEmbedFooter,\n  DiscordEmbedImage,\n  DiscordEmbedThumbnail,\n  DiscordEmbedVideo,\n} from '@discordeno/types'\n\n/**\n * A builder to help create Discord embeds.\n *\n * @export\n * @class EmbedsBuilder\n * @typedef {EmbedsBuilder}\n * @extends {Array<DiscordEmbed>}\n * @example\n * const embeds = new EmbedBuilder()\n *  .setTitle('My Embed')\n *  .setDescription('This is my new embed')\n *  .newEmbed()\n *  .setTitle('My Second Embed')\n */\nexport class EmbedsBuilder extends Array<DiscordEmbed> {\n  #currentEmbedIndex: number = 0\n\n  /**\n   * Adds a new field to the embed fields array.\n   *\n   * @param {string} name - Field name\n   * @param {string} value - Field value\n   * @param {?boolean} [inline=false] - Field should be inline or not.\n   * @returns {EmbedsBuilder}\n   */\n  addField(name: string, value: string, inline?: boolean): EmbedsBuilder {\n    if (this.#currentEmbed.fields === undefined) {\n      this.#currentEmbed.fields = []\n    }\n\n    this.#currentEmbed.fields.push({\n      name,\n      value,\n      inline,\n    })\n\n    return this\n  }\n\n  /**\n   * Creates a blank embed.\n   *\n   * @returns {EmbedsBuilder}\n   */\n  newEmbed(): EmbedsBuilder {\n    if (this.length >= 10) {\n      throw new Error('Maximum embed count exceeded. You can not have more than 10 embeds.')\n    }\n\n    this.push({})\n    this.setCurrentEmbed()\n\n    return this\n  }\n\n  /**\n   * Set the current embed author.\n   *\n   * @param {string} name - Name of the author\n   * @param {?Omit<DiscordEmbedAuthor, 'name'>} [options] - Extra author options\n   * @returns {EmbedsBuilder}\n   */\n  setAuthor(name: string, options?: Omit<DiscordEmbedAuthor, 'name'>): EmbedsBuilder {\n    this.#currentEmbed.author = {\n      ...this.#currentEmbed.author,\n      ...options,\n      name,\n    }\n\n    return this\n  }\n\n  /**\n   * Set the color on the side of the current embed.\n   *\n   * @param {(number | string)} color - The color, in base16 or hex color code\n   * @returns {EmbedsBuilder}\n   */\n  setColor(color: number | string): EmbedsBuilder {\n    if (typeof color === 'string') {\n      const convertedValue = parseInt(color.replace('#', ''), 16)\n      color = Number.isNaN(convertedValue) ? 0 : convertedValue\n    }\n\n    this.#currentEmbed.color = color\n\n    return this\n  }\n\n  /**\n   * Set the current embed to a different index.\n   *\n   * WARNING: Only use this method if you know what you're doing. Make sure to set it back to the latest when you're done.\n   *\n   * @param {?number} [index] - The index of the embed in the EmbedsBuilder array\n   * @returns {EmbedsBuilder}\n   */\n  setCurrentEmbed(index?: number): EmbedsBuilder {\n    if (index === undefined) {\n      this.#currentEmbedIndex = this.length - 1\n\n      return this\n    }\n\n    if (index >= this.length || index < 0) {\n      throw new Error('Can not set the current embed to a index out of bounds.')\n    }\n\n    this.#currentEmbedIndex = index\n\n    return this\n  }\n\n  /**\n   * Set the description of the current embed.\n   *\n   * @param {string} description - Description\n   * @returns {EmbedsBuilder}\n   */\n  setDescription(description: string): EmbedsBuilder {\n    this.#currentEmbed.description = description\n\n    return this\n  }\n\n  /**\n   * Overwrite all fields on the current embed.\n   *\n   * @param {DiscordEmbedField[]} fields\n   * @returns {EmbedsBuilder}\n   */\n  setFields(fields: DiscordEmbedField[]): EmbedsBuilder {\n    this.#currentEmbed.fields = fields\n\n    return this\n  }\n\n  /**\n   * Set the footer in the current embed.\n   *\n   * @param {string} text - The text to display in the footer\n   * @param {?Omit<DiscordEmbedFooter, 'text'>} [options]\n   * @returns {EmbedsBuilder}\n   */\n  setFooter(text: string, options?: Omit<DiscordEmbedFooter, 'text'>): EmbedsBuilder {\n    this.#currentEmbed.footer = {\n      ...this.#currentEmbed.footer,\n      ...options,\n      text,\n    }\n\n    return this\n  }\n\n  /**\n   * Set the image in the current embed.\n   *\n   * @param {string} url - URL of the image\n   * @param {?Omit<DiscordEmbedImage, 'url'>} [options]\n   * @returns {EmbedsBuilder}\n   */\n  setImage(url: string, options?: Omit<DiscordEmbedImage, 'url'>): EmbedsBuilder {\n    this.#currentEmbed.image = {\n      ...this.#currentEmbed.image,\n      ...options,\n      url,\n    }\n\n    return this\n  }\n\n  /**\n   * Set the provider of the current embed.\n   *\n   * @param {string} name\n   * @param {?string} [url]\n   * @returns {EmbedsBuilder}\n   */\n  setProvider(name: string, url?: string): EmbedsBuilder {\n    this.#currentEmbed.provider = {\n      name,\n      url,\n    }\n\n    return this\n  }\n\n  /**\n   * Set the color of the current embed to a random value.\n   *\n   * @returns {EmbedsBuilder}\n   */\n  setRandomColor(): EmbedsBuilder {\n    return this.setColor(Math.floor(Math.random() * (0xffffff + 1)))\n  }\n\n  /**\n   * Set the title of the current embed.\n   *\n   * @param {string} title\n   * @param {?string} [url]\n   * @returns {EmbedsBuilder}\n   */\n  setTitle(title: string, url?: string): EmbedsBuilder {\n    this.#currentEmbed.title = title\n\n    if (url) {\n      this.setUrl(url)\n    }\n\n    return this\n  }\n\n  /**\n   * Set the timestamp of the current embed.\n   *\n   * @param {?(string | number | Date)} [timestamp]\n   * @returns {EmbedsBuilder}\n   */\n  setTimestamp(timestamp?: string | number | Date): EmbedsBuilder {\n    this.#currentEmbed.timestamp = new Date(timestamp!).toISOString()\n\n    return this\n  }\n\n  /**\n   * Set the thumbnail of the current embed.\n   *\n   * @param {string} url - URL of the image\n   * @param {?Omit<DiscordEmbedThumbnail, 'url'>} [options]\n   * @returns {EmbedsBuilder}\n   */\n  setThumbnail(url: string, options?: Omit<DiscordEmbedThumbnail, 'url'>): EmbedsBuilder {\n    this.#currentEmbed.thumbnail = {\n      ...this.#currentEmbed.thumbnail,\n      ...options,\n      url,\n    }\n\n    return this\n  }\n\n  /**\n   * Set the URL of the current embed title.\n   *\n   * @param {string} url\n   * @returns {EmbedsBuilder}\n   */\n  setUrl(url: string): EmbedsBuilder {\n    this.#currentEmbed.url = url\n\n    return this\n  }\n\n  /**\n   * Set the video of the current embed.\n   *\n   * @param {string} url\n   * @param {?Omit<DiscordEmbedVideo, 'url'>} [options]\n   * @returns {EmbedsBuilder}\n   */\n  setVideo(url: string, options?: Omit<DiscordEmbedVideo, 'url'>): EmbedsBuilder {\n    this.#currentEmbed.video = {\n      ...this.#currentEmbed.video,\n      ...options,\n      url,\n    }\n\n    return this\n  }\n\n  /**\n   * Validate all embeds available against current known Discord limits to help prevent bad requests.\n   *\n   * @returns {EmbedsBuilder}\n   */\n  validate(): EmbedsBuilder {\n    let totalCharacters = 0\n\n    if (this.length > 10) {\n      throw new Error('You can not have more than 10 embeds on a single message.')\n    }\n\n    this.forEach(({ author, description, fields, footer, title }, index) => {\n      if (title) {\n        const trimmedTitle = title.trim()\n\n        if (trimmedTitle.length > 256) {\n          throw new Error(`Title of embed ${index} can not be longer than 256 characters.`)\n        }\n\n        totalCharacters += trimmedTitle.length\n      }\n\n      if (description) {\n        const trimmedDescription = description.trim()\n\n        if (trimmedDescription.length > 4096) {\n          throw new Error(`Description of embed ${index} can not be longer than 4096 characters.`)\n        }\n\n        totalCharacters += trimmedDescription.length\n      }\n\n      if (fields) {\n        if (fields.length > 25) {\n          throw new Error(`embed ${index} can not have more than 25 fields.`)\n        }\n\n        fields.forEach(({ name, value }, fieldIndex) => {\n          const trimmedName = name.trim()\n          const trimmedValue = value.trim()\n\n          if (trimmedName.length > 256) {\n            throw new Error(`Name of field ${fieldIndex} on embed ${index} can not be longer than 256 characters.`)\n          }\n\n          if (trimmedValue.length > 4096) {\n            throw new Error(`Value of field ${fieldIndex} on embed ${index} can not be longer than 1024 characters.`)\n          }\n\n          totalCharacters += trimmedName.length\n          totalCharacters += trimmedValue.length\n        })\n      }\n\n      if (footer) {\n        const trimmedFooterText = footer.text.trim()\n\n        if (trimmedFooterText.length > 2048) {\n          throw new Error(`Footer text of embed ${index} can not be longer than 2048 characters.`)\n        }\n\n        totalCharacters += trimmedFooterText.length\n      }\n\n      if (author) {\n        const trimmedAuthorName = author.name.trim()\n\n        if (trimmedAuthorName.length > 256) {\n          throw new Error(`Author name of embed ${index} can not be longer than 256 characters.`)\n        }\n\n        totalCharacters += trimmedAuthorName.length\n      }\n    })\n\n    if (totalCharacters > 6000) {\n      throw new Error('Total character length of all embeds can not exceed 6000 characters.')\n    }\n\n    return this\n  }\n\n  /**\n   * Returns the current embed.\n   *\n   * @readonly\n   * @type {DiscordEmbed}\n   */\n  get #currentEmbed(): DiscordEmbed {\n    if (this.length === 0) {\n      this.newEmbed()\n      this.setCurrentEmbed()\n    }\n\n    return this[this.#currentEmbedIndex]\n  }\n}\n"],"names":["EmbedsBuilder","Array","currentEmbedIndex","addField","name","value","inline","currentEmbed","fields","undefined","push","newEmbed","length","Error","setCurrentEmbed","setAuthor","options","author","setColor","color","convertedValue","parseInt","replace","Number","isNaN","index","setDescription","description","setFields","setFooter","text","footer","setImage","url","image","setProvider","provider","setRandomColor","Math","floor","random","setTitle","title","setUrl","setTimestamp","timestamp","Date","toISOString","setThumbnail","thumbnail","setVideo","video","validate","totalCharacters","forEach","trimmedTitle","trim","trimmedDescription","fieldIndex","trimmedName","trimmedValue","trimmedFooterText","trimmedAuthorName"],"mappings":"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"}

package/dist/builders.d.ts

@@ -0,0 +1,4 @@
+import { EmbedsBuilder } from './builders/embeds.js';
+export * from './builders/embeds.js';
+export declare const createEmbeds: () => EmbedsBuilder;
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,cAAc,sBAAsB,CAAA;AAEpC,eAAO,MAAM,YAAY,QAAO,aAAoC,CAAA"}

package/dist/builders.js

@@ -0,0 +1,5 @@
+import { EmbedsBuilder } from './builders/embeds.js';
+export * from './builders/embeds.js';
+export const createEmbeds = ()=>new EmbedsBuilder();
+
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders.ts"],"sourcesContent":["import { EmbedsBuilder } from './builders/embeds.js'\n\nexport * from './builders/embeds.js'\n\nexport const createEmbeds = (): EmbedsBuilder => new EmbedsBuilder()\n"],"names":["EmbedsBuilder","createEmbeds"],"mappings":"AAAA,SAASA,aAAa,QAAQ,uBAAsB;AAEpD,cAAc,uBAAsB;AAEpC,OAAO,MAAMC,eAAe,IAAqB,IAAID,gBAAe"}

package/dist/casing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"casing.d.ts","sourceRoot":"","sources":["../src/casing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE5D,wBAAgB,QAAQ,CAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAcnD;AAED,wBAAgB,SAAS,CAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAcrD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAepD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAapD"}
+{"version":3,"file":"casing.d.ts","sourceRoot":"","sources":["../src/casing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE5D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAclD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAcpD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAepD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAapD"}