elynn-baileys 1.0.1

package/lib/Discord/routes/Applications.js

@@ -0,0 +1,618 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module REST/ApplicationCommands */
+const Routes = __importStar(require("../util/Routes"));
+const ApplicationCommand_1 = __importDefault(require("../structures/ApplicationCommand"));
+const SKU_1 = __importDefault(require("../structures/SKU"));
+const Entitlement_1 = __importDefault(require("../structures/Entitlement"));
+const TestEntitlement_1 = __importDefault(require("../structures/TestEntitlement"));
+const ClientApplication_1 = __importDefault(require("../structures/ClientApplication"));
+const Application_1 = __importDefault(require("../structures/Application"));
+const Subscription_1 = __importDefault(require("../structures/Subscription"));
+const QueryBuilder_1 = __importDefault(require("../util/QueryBuilder"));
+/** Various methods for interacting with application commands. Located at {@link Client#rest | Client#rest}{@link RESTManager#applications | .applications}. */
+class Applications {
+    _manager;
+    constructor(manager) {
+        this._manager = manager;
+    }
+    /**
+     * Overwrite all existing global application commands.
+     * @param applicationID The ID of the application.
+     * @param options The commands.
+     * @caching This method **does not** cache its result.
+     */
+    async bulkEditGlobalCommands(applicationID, options) {
+        const opts = options;
+        return this._manager.authRequest({
+            method: "PUT",
+            path: Routes.APPLICATION_COMMANDS(applicationID),
+            json: opts.map(opt => ({
+                contexts: opt.contexts,
+                description: opt.description,
+                default_member_permissions: opt.defaultMemberPermissions,
+                description_localizations: opt.descriptionLocalizations,
+                dm_permission: opt.dmPermission,
+                handler: opt.handler,
+                integration_types: opt.integrationTypes,
+                name: opt.name,
+                name_localizations: opt.nameLocalizations,
+                nsfw: opt.nsfw,
+                options: opt.options?.map(o => this._manager.client.util.optionToRaw(o)),
+                type: opt.type
+            }))
+        }).then(data => data.map(d => new ApplicationCommand_1.default(d, this._manager.client)));
+    }
+    /**
+     * Overwrite all existing application commands in a guild.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param options The commands.
+     * @caching This method **does not** cache its result.
+     */
+    async bulkEditGuildCommands(applicationID, guildID, options) {
+        const opts = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "PUT",
+            path: Routes.GUILD_APPLICATION_COMMANDS(applicationID, guildID),
+            json: opts.map(opt => ({
+                id: opt.id,
+                default_member_permissions: opt.defaultMemberPermissions,
+                description: opt.description,
+                description_localizations: opt.descriptionLocalizations,
+                dm_permission: opt.dmPermission,
+                name: opt.name,
+                name_localizations: opt.nameLocalizations,
+                nsfw: opt.nsfw,
+                options: opt.options?.map(o => this._manager.client.util.optionToRaw(o)),
+                type: opt.type
+            }))
+        }).then(data => data.map(d => new ApplicationCommand_1.default(d, this._manager.client)));
+    }
+    /**
+     * Mark an entitlement as consumed.
+     * @param applicationID The ID of the application to the entitlement is for.
+     * @param entitlementID The ID of the entitlement to consume.
+     */
+    async consumeEntitlement(applicationID, entitlementID) {
+        await this._manager.authRequest({
+            method: "POST",
+            path: Routes.CONSUME_ENTITLEMENT(applicationID, entitlementID)
+        });
+    }
+    /**
+     * Create an emoji for an application.
+     * @param applicationID The ID of the application.
+     * @param options The options for creating the emoji.
+     * @caching This method **does not** cache its result.
+     */
+    async createEmoji(applicationID, options) {
+        options = this._manager.client.util._freeze(options);
+        let image;
+        if (options.image) {
+            image = this._manager.client.util._convertImage(options.image, "image");
+        }
+        return this._manager.authRequest({
+            method: "POST",
+            path: Routes.APPLICATION_EMOJIS(applicationID),
+            json: {
+                name: options.name,
+                image
+            }
+        }).then(emoji => this._manager.client.util.convertApplicationEmoji(emoji));
+    }
+    /**
+     * Create a global application command.
+     * @param applicationID The ID of the application.
+     * @param options The options for the command.
+     * @caching This method **does not** cache its result.
+     */
+    async createGlobalCommand(applicationID, options) {
+        const opt = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "POST",
+            path: Routes.APPLICATION_COMMANDS(applicationID),
+            json: {
+                contexts: opt.contexts,
+                default_member_permissions: opt.defaultMemberPermissions,
+                description_localizations: opt.descriptionLocalizations,
+                description: opt.description,
+                dm_permission: opt.dmPermission,
+                handler: opt.handler,
+                integration_types: opt.integrationTypes,
+                name_localizations: opt.nameLocalizations,
+                name: opt.name,
+                nsfw: opt.nsfw,
+                options: opt.options?.map(o => this._manager.client.util.optionToRaw(o)),
+                type: opt.type
+            }
+        }).then(data => new ApplicationCommand_1.default(data, this._manager.client));
+    }
+    /**
+     * Create a guild application command.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param options The options for the command.
+     * @caching This method **does not** cache its result.
+     */
+    async createGuildCommand(applicationID, guildID, options) {
+        const opt = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "POST",
+            path: Routes.GUILD_APPLICATION_COMMANDS(applicationID, guildID),
+            json: {
+                default_member_permissions: opt.defaultMemberPermissions,
+                description: opt.description,
+                description_localizations: opt.descriptionLocalizations,
+                dm_permission: opt.dmPermission,
+                name: opt.name,
+                name_localizations: opt.nameLocalizations,
+                nsfw: opt.nsfw,
+                options: opt.options?.map(o => this._manager.client.util.optionToRaw(o)),
+                type: opt.type
+            }
+        }).then(data => new ApplicationCommand_1.default(data, this._manager.client));
+    }
+    /**
+     * Create a test entitlement.
+     * @param applicationID The ID of the application to create the entitlement for.
+     * @param options The options for creating the test entitlement.
+     */
+    async createTestEntitlement(applicationID, options) {
+        options = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "POST",
+            path: Routes.ENTITLEMENTS(applicationID),
+            json: {
+                owner_id: options.ownerID,
+                owner_type: options.ownerType,
+                sku_id: options.skuID
+            }
+        }).then(data => new TestEntitlement_1.default(data, this._manager.client));
+    }
+    /**
+     * Delete an emoji for an application.
+     * @param applicationID The ID of the application.
+     * @param emojiID The ID of the emoji to be deleted.
+     * @caching This method **does not** cache its result.
+     */
+    async deleteEmoji(applicationID, emojiID) {
+        await this._manager.authRequest({
+            method: "DELETE",
+            path: Routes.APPLICATION_EMOJI(applicationID, emojiID)
+        });
+    }
+    /**
+     * Delete a global application command.
+     * @param applicationID The ID of the application.
+     * @param commandID The ID the command to delete.
+     * @caching This method **does not** cache its result.
+     */
+    async deleteGlobalCommand(applicationID, commandID) {
+        await this._manager.authRequest({
+            method: "DELETE",
+            path: Routes.APPLICATION_COMMAND(applicationID, commandID)
+        });
+    }
+    /**
+     * Delete a guild application command.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param commandID The ID of the command to delete.
+     * @caching This method **does not** cache its result.
+     */
+    async deleteGuildCommand(applicationID, guildID, commandID) {
+        await this._manager.authRequest({
+            method: "DELETE",
+            path: Routes.GUILD_APPLICATION_COMMAND(applicationID, guildID, commandID)
+        });
+    }
+    /**
+     * Delete an entitlement.
+     * @param applicationID The ID of the application to delete the entitlement from.
+     * @param entitlementID The ID of the entitlement to delete.
+     */
+    async deleteTestEntitlement(applicationID, entitlementID) {
+        await this._manager.authRequest({
+            method: "DELETE",
+            path: Routes.ENTITLEMENT(applicationID, entitlementID)
+        });
+    }
+    /**
+     * Edit the currently authenticated bot's application info.
+     * @param options The options for editing the application.
+     * @caching This method **does not** cache its result.
+     */
+    async editCurrent(options) {
+        options = this._manager.client.util._freeze(options);
+        let coverImage, icon;
+        if (options.coverImage) {
+            coverImage = this._manager.client.util._convertImage(options.coverImage, "cover image");
+        }
+        if (options.icon) {
+            icon = this._manager.client.util._convertImage(options.icon, "icon");
+        }
+        return this._manager.authRequest({
+            method: "PATCH",
+            path: Routes.APPLICATION,
+            json: {
+                cover_image: coverImage,
+                custom_install_url: options.customInstallURL,
+                description: options.description,
+                event_webhooks_status: options.eventWebhooksStatus,
+                event_webhooks_types: options.eventWebhooksTypes,
+                event_webhooks_url: options.eventWebhooksURL,
+                flags: options.flags,
+                icon,
+                install_params: options.installParams,
+                integration_types_config: options.integrationTypesConfig,
+                interactions_endpoint_url: options.interactionsEndpointURL,
+                role_connections_verification_url: options.roleConnectionsVerificationURL,
+                tags: options.tags
+            }
+        }).then(data => new Application_1.default(data, this._manager.client));
+    }
+    /**
+     * Edit an existing emoji for an application.
+     * @param applicationID The ID of the application.
+     * @param emojiID The ID of the emoji to be edited.
+     * @param options The options for editing the emoji.
+     * @caching This method **does not** cache its result.
+     */
+    async editEmoji(applicationID, emojiID, options) {
+        options = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "PATCH",
+            path: Routes.APPLICATION_EMOJI(applicationID, emojiID),
+            json: { name: options.name }
+        }).then(emoji => this._manager.client.util.convertApplicationEmoji(emoji));
+    }
+    /**
+     * Edit a global application command.
+     * @param applicationID The ID of the application.
+     * @param commandID The ID of the command to edit.
+     * @param options The options for editing the command.
+     * @caching This method **does not** cache its result.
+     */
+    async editGlobalCommand(applicationID, commandID, options) {
+        const opt = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "PATCH",
+            path: Routes.APPLICATION_COMMAND(applicationID, commandID),
+            json: {
+                contexts: opt.contexts,
+                default_member_permissions: opt.defaultMemberPermissions,
+                description: opt.description,
+                description_localizations: opt.descriptionLocalizations,
+                dm_permission: opt.dmPermission,
+                integration_types: opt.integrationTypes,
+                name: opt.name,
+                name_localizations: opt.nameLocalizations,
+                nsfw: opt.nsfw,
+                options: opt.options?.map(o => this._manager.client.util.optionToRaw(o))
+            }
+        }).then(data => new ApplicationCommand_1.default(data, this._manager.client));
+    }
+    /**
+     * Edit a guild application command.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param commandID The ID of the command to edit.
+     * @param options The options for editing the command.
+     * @caching This method **does not** cache its result.
+     */
+    async editGuildCommand(applicationID, guildID, commandID, options) {
+        const opt = this._manager.client.util._freeze(options);
+        return this._manager.authRequest({
+            method: "PATCH",
+            path: Routes.GUILD_APPLICATION_COMMAND(applicationID, guildID, commandID),
+            json: {
+                default_member_permissions: opt.defaultMemberPermissions,
+                description: opt.description,
+                description_localizations: opt.descriptionLocalizations,
+                dm_permission: opt.dmPermission,
+                name: opt.name,
+                name_localizations: opt.nameLocalizations,
+                nsfw: opt.nsfw,
+                options: opt.options?.map(o => this._manager.client.util.optionToRaw(o))
+            }
+        }).then(data => new ApplicationCommand_1.default(data, this._manager.client));
+    }
+    /**
+     * Edit a guild application command's permissions. This requires a bearer token with the `applications.commands.permissions.update` scope.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param commandID The ID of the command.
+     * @param options The options for editing the permissions.
+     * @caching This method **does not** cache its result.
+     */
+    async editGuildCommandPermissions(applicationID, guildID, commandID, options) {
+        options = this._manager.client.util._freeze(options);
+        return (options.accessToken ? this._manager.request.bind(this._manager) : this._manager.authRequest.bind(this._manager))({
+            method: "PATCH",
+            path: Routes.GUILD_APPLICATION_COMMAND_PERMISSION(applicationID, guildID, commandID),
+            json: { permissions: options.permissions },
+            auth: options.accessToken
+        }).then(data => {
+            const d = data;
+            return {
+                applicationID: d.application_id,
+                guildID: d.guild_id,
+                id: d.id,
+                permissions: d.permissions
+            };
+        });
+    }
+    /**
+     * Get an activity instance.
+     * @param applicationID The ID of the application.
+     * @param instanceID The ID of the instance.
+     */
+    async getActivityInstance(applicationID, instanceID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION_ACTIVITY_INSTANCE(applicationID, instanceID)
+        }).then(data => ({
+            applicationID: data.application_id,
+            instanceID: data.instance_id,
+            launchID: data.launch_id,
+            location: {
+                channelID: data.location.channel_id,
+                guildID: data.location.guild_id,
+                id: data.location.id,
+                kind: data.location.kind
+            },
+            users: data.users
+        }));
+    }
+    /**
+     * Get the currently authenticated bot's application info as a bare {@link ClientApplication | ClientApplication}.
+     * @caching This method **does not** cache its result.
+     */
+    async getClient() {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION
+        }).then(data => new ClientApplication_1.default(data, this._manager.client));
+    }
+    /**
+     * Get the currently authenticated bot's application info.
+     * @caching This method **does not** cache its result.
+     */
+    async getCurrent() {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION
+        }).then(data => new Application_1.default(data, this._manager.client));
+    }
+    /**
+     * Get an emoji for an application.
+     * @param applicationID The ID of the application to get the emojis of.
+     * @param emojiID The ID of the emoji to get.
+     * @caching This method **does not** cache its result.
+     */
+    async getEmoji(applicationID, emojiID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION_EMOJI(applicationID, emojiID)
+        }).then(emoji => this._manager.client.util.convertApplicationEmoji(emoji));
+    }
+    /**
+     * Get the emojis for an application.
+     * @param applicationID The ID of the application to get the emojis of.
+     * @caching This method **does not** cache its result.
+     */
+    async getEmojis(applicationID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION_EMOJIS(applicationID)
+        }).then(({ items }) => ({
+            items: items.map(item => this._manager.client.util.convertApplicationEmoji(item))
+        }));
+    }
+    /**
+     * Get the entitlements for an application.
+     * @param applicationID The ID of the application to get the entitlements of.
+     * @param options The options for getting the entitlements.
+     */
+    async getEntitlements(applicationID, options = {}) {
+        options = this._manager.client.util._freeze(options);
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("after", options.after);
+        query.setIfPresent("before", options.before);
+        query.setIfPresent("exclude_deleted", options.excludeDeleted);
+        query.setIfPresent("exclude_ended", options.excludeEnded);
+        query.setIfPresent("guild_id", options.guildID);
+        query.setIfPresent("limit", options.limit);
+        query.setIfPresent("sku_ids", options.skuIDs?.join(","));
+        query.setIfPresent("user_id", options.userID);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.ENTITLEMENTS(applicationID),
+            query
+        }).then(data => data.map(d => "subscription_id" in d && d.subscription_id ? new Entitlement_1.default(d, this._manager.client) : new TestEntitlement_1.default(d, this._manager.client)));
+    }
+    /**
+     * Get a global application command.
+     * @param applicationID The ID of the application.
+     * @param commandID The ID of the command.
+     * @param options The options for getting the command.
+     * @caching This method **does not** cache its result.
+     */
+    async getGlobalCommand(applicationID, commandID, options) {
+        options = this._manager.client.util._freeze(options);
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("with_localizations", options?.withLocalizations);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION_COMMAND(applicationID, commandID),
+            query,
+            headers: options?.locale === undefined ? undefined : { "X-Discord-Locale": options.locale }
+        }).then(data => new ApplicationCommand_1.default(data, this._manager.client));
+    }
+    /**
+     * Get an application's global commands.
+     * @param applicationID The ID of the application.
+     * @param options The options for getting the command.
+     * @caching This method **does not** cache its result.
+     */
+    async getGlobalCommands(applicationID, options) {
+        options = this._manager.client.util._freeze(options);
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("with_localizations", options?.withLocalizations);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.APPLICATION_COMMANDS(applicationID),
+            query,
+            headers: options?.locale === undefined ? undefined : { "X-Discord-Locale": options.locale }
+        }).then(data => data.map(d => new ApplicationCommand_1.default(d, this._manager.client)));
+    }
+    /**
+     * Get a global application command.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param commandID The ID of the command.
+     * @param options The options for getting the command.
+     * @caching This method **does not** cache its result.
+     */
+    async getGuildCommand(applicationID, guildID, commandID, options) {
+        options = this._manager.client.util._freeze(options);
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("with_localizations", options?.withLocalizations);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.GUILD_APPLICATION_COMMAND(applicationID, commandID, guildID),
+            query,
+            headers: options?.locale === undefined ? undefined : { "X-Discord-Locale": options.locale }
+        }).then(data => new ApplicationCommand_1.default(data, this._manager.client));
+    }
+    /**
+     * Get an application's application commands in a specific guild.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param options The options for getting the command.
+     * @caching This method **does not** cache its result.
+     */
+    async getGuildCommands(applicationID, guildID, options) {
+        options = this._manager.client.util._freeze(options);
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("with_localizations", options?.withLocalizations);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.GUILD_APPLICATION_COMMANDS(applicationID, guildID),
+            query,
+            headers: options?.locale === undefined ? undefined : { "X-Discord-Locale": options.locale }
+        }).then(data => data.map(d => new ApplicationCommand_1.default(d, this._manager.client)));
+    }
+    /**
+     * Get an application command's permissions in a guild.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @param commandID The ID of the command.
+     * @caching This method **does not** cache its result.
+     */
+    async getGuildPermission(applicationID, guildID, commandID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.GUILD_APPLICATION_COMMAND_PERMISSION(applicationID, guildID, commandID)
+        }).then(data => ({
+            applicationID: data.application_id,
+            guildID: data.guild_id,
+            id: data.id,
+            permissions: data.permissions
+        }));
+    }
+    /**
+     * Get the permissions for all application commands in a guild.
+     * @param applicationID The ID of the application.
+     * @param guildID The ID of the guild.
+     * @caching This method **does not** cache its result.
+     */
+    async getGuildPermissions(applicationID, guildID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.GUILD_APPLICATION_COMMAND_PERMISSIONS(applicationID, guildID)
+        }).then(data => data.map(d => ({
+            applicationID: d.application_id,
+            guildID: d.guild_id,
+            id: d.id,
+            permissions: d.permissions
+        })));
+    }
+    /**
+     * Get the subscription for an SKU.
+     * @param skuID The ID of the SKU to get the subscription of.
+     * @param subscriptionID The ID of the subscription to get.
+     */
+    async getSKUSubscription(skuID, subscriptionID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.SKU_SUBSCRIPTION(skuID, subscriptionID)
+        }).then(data => new Subscription_1.default(data, this._manager.client));
+    }
+    /**
+     * Get the subscriptions for an SKU.
+     * @param skuID The ID of the SKU to get the subscriptions of.
+     * @param options The options for getting the subscriptions.
+     */
+    async getSKUSubscriptions(skuID, options) {
+        options = this._manager.client.util._freeze(options);
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("after", options.after);
+        query.setIfPresent("before", options.before);
+        query.setIfPresent("limit", options.limit);
+        query.setIfPresent("user_id", options.userID);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.SKU_SUBSCRIPTIONS(skuID),
+            query
+        }).then(data => data.map(d => new Subscription_1.default(d, this._manager.client)));
+    }
+    /**
+     * Get the SKUs for an application.
+     * @param applicationID The ID of the application to get the SKUs of.
+     */
+    async getSKUs(applicationID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.SKUS(applicationID)
+        }).then(data => data.map(d => new SKU_1.default(d, this._manager.client)));
+    }
+}
+exports.default = Applications;