2022-03-19 10:37:45 +00:00
|
|
|
'use strict';
|
|
|
|
|
2022-09-09 16:44:45 +00:00
|
|
|
const { Collection } = require('@discordjs/collection');
|
2022-03-19 10:37:45 +00:00
|
|
|
const Team = require('./Team');
|
|
|
|
const Application = require('./interfaces/Application');
|
2022-05-14 08:06:15 +00:00
|
|
|
const ApplicationCommandManager = require('../managers/ApplicationCommandManager');
|
2022-03-24 10:55:32 +00:00
|
|
|
const ApplicationFlags = require('../util/ApplicationFlags');
|
2022-05-14 08:06:15 +00:00
|
|
|
const Permissions = require('../util/Permissions');
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @typedef {Object} ClientApplicationInstallParams
|
|
|
|
* @property {InviteScope[]} scopes The scopes to add the application to the server with
|
|
|
|
* @property {Readonly<Permissions>} permissions The permissions this bot will request upon joining
|
|
|
|
*/
|
2022-03-19 10:37:45 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Represents a Client OAuth2 Application.
|
|
|
|
* @extends {Application}
|
|
|
|
*/
|
|
|
|
class ClientApplication extends Application {
|
2022-06-26 06:40:26 +00:00
|
|
|
constructor(client, data, user) {
|
2022-03-19 10:37:45 +00:00
|
|
|
super(client, data);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The application command manager for this application
|
|
|
|
* @type {ApplicationCommandManager}
|
|
|
|
*/
|
2022-06-26 06:40:26 +00:00
|
|
|
this.commands = new ApplicationCommandManager(this.client, undefined, user);
|
2022-03-19 10:37:45 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
_patch(data) {
|
|
|
|
super._patch(data);
|
|
|
|
|
2022-05-14 08:06:15 +00:00
|
|
|
/**
|
|
|
|
* The tags this application has (max of 5)
|
|
|
|
* @type {string[]}
|
|
|
|
*/
|
|
|
|
this.tags = data.tags ?? [];
|
|
|
|
|
|
|
|
if ('install_params' in data) {
|
|
|
|
/**
|
|
|
|
* Settings for this application's default in-app authorization
|
|
|
|
* @type {?ClientApplicationInstallParams}
|
|
|
|
*/
|
|
|
|
this.installParams = {
|
|
|
|
scopes: data.install_params.scopes,
|
|
|
|
permissions: new Permissions(data.install_params.permissions).freeze(),
|
|
|
|
};
|
|
|
|
} else {
|
|
|
|
this.installParams ??= null;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ('custom_install_url' in data) {
|
|
|
|
/**
|
|
|
|
* This application's custom installation URL
|
|
|
|
* @type {?string}
|
|
|
|
*/
|
|
|
|
this.customInstallURL = data.custom_install_url;
|
|
|
|
} else {
|
|
|
|
this.customInstallURL = null;
|
|
|
|
}
|
|
|
|
|
2022-03-19 10:37:45 +00:00
|
|
|
if ('flags' in data) {
|
|
|
|
/**
|
|
|
|
* The flags this application has
|
2022-03-24 10:55:32 +00:00
|
|
|
* @type {ApplicationFlags}
|
2022-03-19 10:37:45 +00:00
|
|
|
*/
|
2022-03-24 10:55:32 +00:00
|
|
|
this.flags = new ApplicationFlags(data.flags).freeze();
|
2022-03-19 10:37:45 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if ('cover_image' in data) {
|
|
|
|
/**
|
|
|
|
* The hash of the application's cover image
|
|
|
|
* @type {?string}
|
|
|
|
*/
|
|
|
|
this.cover = data.cover_image;
|
|
|
|
} else {
|
|
|
|
this.cover ??= null;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ('rpc_origins' in data) {
|
|
|
|
/**
|
|
|
|
* The application's RPC origins, if enabled
|
|
|
|
* @type {string[]}
|
|
|
|
*/
|
|
|
|
this.rpcOrigins = data.rpc_origins;
|
|
|
|
} else {
|
|
|
|
this.rpcOrigins ??= [];
|
|
|
|
}
|
|
|
|
|
|
|
|
if ('bot_require_code_grant' in data) {
|
|
|
|
/**
|
|
|
|
* If this application's bot requires a code grant when using the OAuth2 flow
|
|
|
|
* @type {?boolean}
|
|
|
|
*/
|
|
|
|
this.botRequireCodeGrant = data.bot_require_code_grant;
|
|
|
|
} else {
|
|
|
|
this.botRequireCodeGrant ??= null;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ('bot_public' in data) {
|
|
|
|
/**
|
|
|
|
* If this application's bot is public
|
|
|
|
* @type {?boolean}
|
|
|
|
*/
|
|
|
|
this.botPublic = data.bot_public;
|
|
|
|
} else {
|
|
|
|
this.botPublic ??= null;
|
|
|
|
}
|
|
|
|
|
2022-09-09 16:44:45 +00:00
|
|
|
if ('popular_application_command_ids' in data) {
|
|
|
|
/**
|
|
|
|
* List of popular command
|
|
|
|
* @type {?Collection<Snowflake, ApplicationCommand>}
|
|
|
|
*/
|
|
|
|
this.popularCommands = new Collection();
|
|
|
|
data.popular_application_command_ids.forEach(id => {
|
2022-09-16 12:08:15 +00:00
|
|
|
this.popularCommands.set(id, this.commands?.cache?.get(id));
|
2022-09-09 16:44:45 +00:00
|
|
|
});
|
|
|
|
}
|
|
|
|
|
2022-03-19 10:37:45 +00:00
|
|
|
/**
|
|
|
|
* The owner of this OAuth application
|
|
|
|
* @type {?(User|Team)}
|
|
|
|
*/
|
|
|
|
this.owner = data.team
|
|
|
|
? new Team(this.client, data.team)
|
|
|
|
: data.owner
|
|
|
|
? this.client.users._add(data.owner)
|
|
|
|
: this.owner ?? null;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Whether this application is partial
|
|
|
|
* @type {boolean}
|
|
|
|
* @readonly
|
|
|
|
*/
|
|
|
|
get partial() {
|
|
|
|
return !this.name;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Obtains this application from Discord.
|
|
|
|
* @returns {Promise<ClientApplication>}
|
|
|
|
*/
|
|
|
|
async fetch() {
|
2022-06-26 06:40:26 +00:00
|
|
|
const app = await this.client.api.oauth2.authorize.get({
|
|
|
|
query: {
|
|
|
|
client_id: this.id,
|
2022-09-16 12:08:15 +00:00
|
|
|
scope: 'bot applications.commands',
|
2022-06-26 06:40:26 +00:00
|
|
|
},
|
|
|
|
});
|
2022-09-16 12:08:15 +00:00
|
|
|
const user = this.client.users._add(app.bot);
|
|
|
|
user._partial = false;
|
2022-06-26 06:40:26 +00:00
|
|
|
this._patch(app.application);
|
2022-03-19 10:37:45 +00:00
|
|
|
return this;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
module.exports = ClientApplication;
|