@ovencord/discord.js 14.16.3

package/src/structures/BaseInvite.ts

@@ -0,0 +1,192 @@
+import { RouteBases  } from 'discord-api-types/v10';
+import { Base  } from './Base.js';
+
+/**
+ * The base invite class.
+ *
+ * @extends {Base}
+ */
+export class BaseInvite extends Base {
+  public client: any;
+  public type: any;
+  public code: any;
+  public inviterId: any;
+  public maxAge: any;
+  public createdTimestamp: any;
+  public _expiresTimestamp: any;
+  public channelId: any;
+  public approximateMemberCount: any;
+  constructor(client, data) {
+    super(client);
+
+    /**
+     * The type of this invite.
+     *
+     * @type {InviteType}
+     */
+    this.type = data.type;
+
+    /**
+     * The invite code.
+     *
+     * @type {string}
+     */
+    this.code = data.code;
+
+    this._patch(data);
+  }
+
+  _patch(data) {
+    if ('inviter_id' in data) {
+      /**
+       * The id of the user that created this invite.
+       *
+       * @type {?Snowflake}
+       */
+      this.inviterId = data.inviter_id;
+    } else {
+      this.inviterId ??= null;
+    }
+
+    if ('inviter' in data) {
+      this.client.users._add(data.inviter);
+      this.inviterId ??= data.inviter.id;
+    }
+
+    if ('max_age' in data) {
+      /**
+       * The maximum age of the invite in seconds. `0` for no expiry.
+       *
+       * @type {?number}
+       */
+      this.maxAge = data.max_age;
+    } else {
+      this.maxAge ??= null;
+    }
+
+    if ('created_at' in data) {
+      /**
+       * The timestamp this invite was created at.
+       *
+       * @type {?number}
+       */
+      this.createdTimestamp = Date.parse(data.created_at);
+    } else {
+      this.createdTimestamp ??= null;
+    }
+
+    if ('expires_at' in data) {
+      this._expiresTimestamp = data.expires_at && Date.parse(data.expires_at);
+    } else {
+      this._expiresTimestamp ??= null;
+    }
+
+    if ('channel_id' in data) {
+      /**
+       * The id of the channel this invite is for.
+       *
+       * @type {?Snowflake}
+       */
+      this.channelId = data.channel_id;
+    }
+
+    if ('approximate_member_count' in data) {
+      /**
+       * The approximate total number of members.
+       *
+       * @type {?number}
+       */
+      this.approximateMemberCount = data.approximate_member_count;
+    } else {
+      this.approximateMemberCount ??= null;
+    }
+  }
+
+  /**
+   * The user that created this invite.
+   *
+   * @type {?User}
+   * @readonly
+   */
+  get inviter() {
+    return this.inviterId && this.client.users.resolve(this.inviterId);
+  }
+
+  /**
+   * The creation date of this invite.
+   *
+   * @type {?Date}
+   * @readonly
+   */
+  get createdAt() {
+    return this.createdTimestamp && new Date(this.createdTimestamp);
+  }
+
+  /**
+   * The timestamp this invite expires at.
+   *
+   * @type {?number}
+   * @readonly
+   */
+  get expiresTimestamp() {
+    return (
+      this._expiresTimestamp ??
+      (this.createdTimestamp && this.maxAge ? this.createdTimestamp + this.maxAge * 1_000 : null)
+    );
+  }
+
+  /**
+   * The expiry date of this invite.
+   *
+   * @type {?Date}
+   * @readonly
+   */
+  get expiresAt() {
+    return this.expiresTimestamp && new Date(this.expiresTimestamp);
+  }
+
+  /**
+   * The URL to the invite.
+   *
+   * @type {string}
+   * @readonly
+   */
+  get url() {
+    return `${RouteBases.invite}/${this.code}`;
+  }
+
+  /**
+   * A regular expression that matches Discord invite links.
+   * The `code` group property is present on the `exec()` result of this expression.
+   *
+   * @type {RegExp}
+   * @memberof BaseInvite
+   */
+  static InvitesPattern = /discord(?:(?:app)?\.com\/invite|\.gg(?:\/invite)?)\/(?<code>[\w-]{2,255})/i;
+
+  /**
+   * When concatenated with a string, this automatically concatenates the invite's URL instead of the object.
+   *
+   * @returns {string}
+   * @example
+   * // Logs: Invite: https://discord.gg/djs
+   * console.log(`Invite: ${invite}`);
+   */
+  toString() {
+    return this.url;
+  }
+
+  toJSON() {
+    return super.toJSON({
+      url: true,
+      expiresTimestamp: true,
+      uses: false,
+      channel: 'channelId',
+      inviter: 'inviterId',
+    });
+  }
+
+  valueOf() {
+    return this.code;
+  }
+}

package/src/structures/BaseSelectMenuComponent.ts

@@ -0,0 +1,58 @@
+import { Component  } from './Component.js';
+
+/**
+ * Represents a select menu component
+ *
+ * @extends {Component}
+ */
+export class BaseSelectMenuComponent extends Component {
+  /**
+   * The placeholder for this select menu
+   *
+   * @type {?string}
+   * @readonly
+   */
+  get placeholder() {
+    return this.data.placeholder ?? null;
+  }
+
+  /**
+   * The maximum amount of options that can be selected
+   *
+   * @type {?number}
+   * @readonly
+   */
+  get maxValues() {
+    return this.data.max_values ?? null;
+  }
+
+  /**
+   * The minimum amount of options that must be selected
+   *
+   * @type {?number}
+   * @readonly
+   */
+  get minValues() {
+    return this.data.min_values ?? null;
+  }
+
+  /**
+   * The custom id of this select menu
+   *
+   * @type {string}
+   * @readonly
+   */
+  get customId() {
+    return this.data.custom_id;
+  }
+
+  /**
+   * Whether this select menu is disabled
+   *
+   * @type {boolean}
+   * @readonly
+   */
+  get disabled() {
+    return this.data.disabled ?? false;
+  }
+}

package/src/structures/ButtonComponent.ts

@@ -0,0 +1,68 @@
+import { Component  } from './Component.js';
+
+/**
+ * Represents a button component
+ *
+ * @extends {Component}
+ */
+export class ButtonComponent extends Component {
+  /**
+   * The style of this button
+   *
+   * @type {ButtonStyle}
+   * @readonly
+   */
+  get style() {
+    return this.data.style;
+  }
+
+  /**
+   * The label of this button
+   *
+   * @type {?string}
+   * @readonly
+   */
+  get label() {
+    return this.data.label ?? null;
+  }
+
+  /**
+   * The emoji used in this button
+   *
+   * @type {?APIMessageComponentEmoji}
+   * @readonly
+   */
+  get emoji() {
+    return this.data.emoji ?? null;
+  }
+
+  /**
+   * Whether this button is disabled
+   *
+   * @type {boolean}
+   * @readonly
+   */
+  get disabled() {
+    return this.data.disabled ?? false;
+  }
+
+  /**
+   * The custom id of this button (only defined on non-link buttons)
+   *
+   * @type {?string}
+   * @readonly
+   */
+  get customId() {
+    return this.data.custom_id ?? null;
+  }
+
+  /**
+   * The URL of this button (only defined on link buttons)
+   *
+   * @type {?string}
+   * @readonly
+   */
+  get url() {
+    return this.data.url ?? null;
+  }
+}

package/src/structures/ButtonInteraction.ts

@@ -0,0 +1,8 @@
+import { MessageComponentInteraction  } from './MessageComponentInteraction.js';
+
+/**
+ * Represents a button interaction.
+ *
+ * @extends {MessageComponentInteraction}
+ */
+export class ButtonInteraction extends MessageComponentInteraction {}

package/src/structures/CategoryChannel.ts

@@ -0,0 +1,46 @@
+import { CategoryChannelChildManager  } from '../managers/CategoryChannelChildManager.js';
+import { GuildChannel  } from './GuildChannel.js';
+
+/**
+ * Represents a guild category channel on Discord.
+ *
+ * @extends {GuildChannel}
+ */
+export class CategoryChannel extends GuildChannel {
+  /**
+   * The id of the parent of this channel.
+   *
+   * @name CategoryChannel#parentId
+   * @type {null}
+   */
+
+  /**
+   * The parent of this channel.
+   *
+   * @name CategoryChannel#parent
+   * @type {null}
+   * @readonly
+   */
+
+  /**
+   * Sets the category parent of this channel.
+   * <warn>It is not possible to set the parent of a CategoryChannel.</warn>
+   *
+   * @method setParent
+   * @memberof CategoryChannel
+   * @instance
+   * @param {?CategoryChannelResolvable} channel The channel to set as parent
+   * @param {SetParentOptions} [options={}] The options for setting the parent
+   * @returns {Promise<GuildChannel>}
+   */
+
+  /**
+   * A manager of the channels belonging to this category
+   *
+   * @type {CategoryChannelChildManager}
+   * @readonly
+   */
+  get children() {
+    return new CategoryChannelChildManager(this);
+  }
+}

package/src/structures/ChannelSelectMenuComponent.ts

@@ -0,0 +1,18 @@
+import { BaseSelectMenuComponent  } from './BaseSelectMenuComponent.js';
+
+/**
+ * Represents a channel select menu component
+ *
+ * @extends {BaseSelectMenuComponent}
+ */
+export class ChannelSelectMenuComponent extends BaseSelectMenuComponent {
+  /**
+   * The options in this select menu
+   *
+   * @type {?(ChannelType[])}
+   * @readonly
+   */
+  get channelTypes() {
+    return this.data.channel_types ?? null;
+  }
+}

package/src/structures/ChannelSelectMenuInteraction.ts

@@ -0,0 +1,34 @@
+import { Collection  } from '@ovencord/collection';
+import { MessageComponentInteraction  } from './MessageComponentInteraction.js';
+
+/**
+ * Represents a {@link ComponentType.ChannelSelect} select menu interaction.
+ *
+ * @extends {MessageComponentInteraction}
+ */
+export class ChannelSelectMenuInteraction extends MessageComponentInteraction {
+  public client: any;
+  public channels: any;
+  constructor(client, data) {
+    super(client, data);
+    const { resolved, values } = data.data;
+
+    /**
+     * An array of the selected channel ids
+     *
+     * @type {Snowflake[]}
+     */
+    this.values = values ?? [];
+
+    /**
+     * Collection of the selected channels
+     *
+     * @type {Collection<Snowflake, BaseChannel|APIChannel>}
+     */
+    this.channels = new Collection();
+
+    for (const channel of Object.values(resolved?.channels ?? {})) {
+      this.channels.set(channel.id, this.client.channels._add(channel, this.guild) ?? channel);
+    }
+  }
+}

package/src/structures/ChatInputCommandInteraction.ts

@@ -0,0 +1,43 @@
+import { transformResolved  } from '../util/Util.js';
+import { CommandInteraction  } from './CommandInteraction.js';
+import { CommandInteractionOptionResolver  } from './CommandInteractionOptionResolver.js';
+
+/**
+ * Represents a command interaction.
+ *
+ * @extends {CommandInteraction}
+ */
+export class ChatInputCommandInteraction extends CommandInteraction {
+  public client: any;
+  public options: any;
+  constructor(client, data) {
+    super(client, data);
+
+    /**
+     * The options passed to the command.
+     *
+     * @type {CommandInteractionOptionResolver}
+     */
+    this.options = new CommandInteractionOptionResolver(
+      this.client,
+      data.data.options?.map(option => this.transformOption(option, data.data.resolved)) ?? [],
+      transformResolved({ client: this.client, guild: this.guild, channel: this.channel }, data.data.resolved),
+    );
+  }
+
+  /**
+   * Returns a string representation of the command interaction.
+   * This can then be copied by a user and executed again in a new command while keeping the option order.
+   *
+   * @returns {string}
+   */
+  toString() {
+    const properties = [
+      this.commandName,
+      this.options._group,
+      this.options._subcommand,
+      ...this.options._hoistedOptions.map(option => `${option.name}:${option.value}`),
+    ];
+    return `/${properties.filter(Boolean).join(' ')}`;
+  }
+}