docs: clarify voice message attachment properties in documentation

Author: almeidx

packages/discord.js/src/structures/Attachment.js

@@ -9,8 +9,8 @@ const { basename, flatten } = require('../util/Util.js');
  * @property {string} [name] The name of the attachment
  * @property {string} [description] The description of the attachment
  * @property {title} [title] The title of the attachment
- * @property {string} [waveform] The base64 encoded byte array representing a sampled waveform
- * @property {number} [duration] The duration of the attachment in seconds
+ * @property {string} [waveform] The base64 encoded byte array representing a sampled waveform (from voice message attachments)
+ * @property {number} [duration] The duration of the attachment in seconds (from voice message attachments)
  */
 
 /**
@@ -118,7 +118,7 @@ class Attachment {
     if ('duration_secs' in data) {
       /**
        * The duration of this attachment in seconds
-       * <info>This will only be available if the attachment is an audio file.</info>
+       * <info>This will only be available if the attachment is the audio file from a voice message.</info>
        *
        * @type {?number}
        */
@@ -130,7 +130,7 @@ class Attachment {
     if ('waveform' in data) {
       /**
        * The base64 encoded byte array representing a sampled waveform
-       * <info>This will only be available if the attachment is an audio file.</info>
+       * <info>This will only be available if this attachment is the audio file from a voice message.</info>
        *
        * @type {?string}
        */

packages/discord.js/src/structures/AttachmentBuilder.js

@@ -41,13 +41,15 @@ class AttachmentBuilder {
 
     /**
      * The base64 encoded byte array representing a sampled waveform
+     * <info>This is only for voice message attachments.</info>
      *
      * @type {?string}
      */
     this.waveform = data.waveform;
 
     /**
      * The duration of the attachment in seconds
+     * <info>This is only for voice message attachments.</info>
      *
      * @type {?number}
      */
@@ -100,6 +102,7 @@ class AttachmentBuilder {
 
   /**
    * Sets the waveform of this attachment.
+   * <info>This is only for voice message attachments.</info>
    *
    * @param {string} waveform The base64 encoded byte array representing a sampled waveform
    * @returns {AttachmentBuilder} This attachment
@@ -111,6 +114,7 @@ class AttachmentBuilder {
 
   /**
    * Sets the duration of this attachment.
+   * <info>This is only for voice message attachments.</info>
    *
    * @param {number} duration The duration of the attachment in seconds
    * @returns {AttachmentBuilder} This attachment
@@ -176,6 +180,6 @@ exports.AttachmentBuilder = AttachmentBuilder;
  * @property {string} [name] The name of the attachment
  * @property {string} [description] The description of the attachment
  * @property {string} [title] The title of the attachment
- * @property {string} [waveform] The base64 encoded byte array representing a sampled waveform
- * @property {number} [duration] The duration of the attachment in seconds
+ * @property {string} [waveform] The base64 encoded byte array representing a sampled waveform (for voice message attachments)
+ * @property {number} [duration] The duration of the attachment in seconds (for voice message attachments)
  */