2022-04-16 10:44:43 +00:00
|
|
|
'use strict';
|
|
|
|
|
|
|
|
const { TypeError } = require('../errors');
|
|
|
|
const { MessageComponentTypes, Events } = require('../util/Constants');
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Represents an interactive component of a Message. It should not be necessary to construct this directly.
|
|
|
|
* See {@link MessageComponent}
|
|
|
|
*/
|
|
|
|
class BaseMessageComponent {
|
|
|
|
/**
|
|
|
|
* Options for a BaseMessageComponent
|
|
|
|
* @typedef {Object} BaseMessageComponentOptions
|
|
|
|
* @property {MessageComponentTypeResolvable} type The type of this component
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Data that can be resolved into options for a MessageComponent. This can be:
|
|
|
|
* * MessageActionRowOptions
|
|
|
|
* * MessageButtonOptions
|
|
|
|
* * MessageSelectMenuOptions
|
|
|
|
* @typedef {MessageActionRowOptions|MessageButtonOptions|MessageSelectMenuOptions} MessageComponentOptions
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Components that can be sent in a message. These can be:
|
|
|
|
* * MessageActionRow
|
|
|
|
* * MessageButton
|
|
|
|
* * MessageSelectMenu
|
|
|
|
* @typedef {MessageActionRow|MessageButton|MessageSelectMenu} MessageComponent
|
|
|
|
* @see {@link https://discord.com/developers/docs/interactions/message-components#component-object-component-types}
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Data that can be resolved to a MessageComponentType. This can be:
|
|
|
|
* * MessageComponentType
|
|
|
|
* * string
|
|
|
|
* * number
|
|
|
|
* @typedef {string|number|MessageComponentType} MessageComponentTypeResolvable
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param {BaseMessageComponent|BaseMessageComponentOptions} [data={}] The options for this component
|
|
|
|
*/
|
|
|
|
constructor(data) {
|
|
|
|
/**
|
|
|
|
* The type of this component
|
|
|
|
* @type {?MessageComponentType}
|
|
|
|
*/
|
|
|
|
this.type = 'type' in data ? BaseMessageComponent.resolveType(data.type) : null;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructs a MessageComponent based on the type of the incoming data
|
|
|
|
* @param {MessageComponentOptions} data Data for a MessageComponent
|
|
|
|
* @param {Client|WebhookClient} [client] Client constructing this component
|
|
|
|
* @returns {?MessageComponent}
|
|
|
|
* @private
|
|
|
|
*/
|
|
|
|
static create(data, client) {
|
|
|
|
let component;
|
|
|
|
let type = data.type;
|
|
|
|
|
|
|
|
if (typeof type === 'string') type = MessageComponentTypes[type];
|
|
|
|
|
|
|
|
switch (type) {
|
|
|
|
case MessageComponentTypes.ACTION_ROW: {
|
|
|
|
const MessageActionRow = require('./MessageActionRow');
|
|
|
|
component = data instanceof MessageActionRow ? data : new MessageActionRow(data, client);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
case MessageComponentTypes.BUTTON: {
|
|
|
|
const MessageButton = require('./MessageButton');
|
|
|
|
component = data instanceof MessageButton ? data : new MessageButton(data);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
case MessageComponentTypes.SELECT_MENU: {
|
|
|
|
const MessageSelectMenu = require('./MessageSelectMenu');
|
|
|
|
component = data instanceof MessageSelectMenu ? data : new MessageSelectMenu(data);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
default:
|
|
|
|
if (client) {
|
|
|
|
client.emit(Events.DEBUG, `[BaseMessageComponent] Received component with unknown type: ${data.type}`);
|
|
|
|
} else {
|
|
|
|
throw new TypeError('INVALID_TYPE', 'data.type', 'valid MessageComponentType');
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return component;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Resolves the type of a MessageComponent
|
|
|
|
* @param {MessageComponentTypeResolvable} type The type to resolve
|
|
|
|
* @returns {MessageComponentType}
|
|
|
|
* @private
|
|
|
|
*/
|
|
|
|
static resolveType(type) {
|
|
|
|
return typeof type === 'string' ? type : MessageComponentTypes[type];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
module.exports = BaseMessageComponent;
|