@deffa5556/bail 1.0.6 → 1.0.7

package/cjs/lib/Discord/routes/OAuth.cjs

@@ -0,0 +1,350 @@
+"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 });
+const Routes = __importStar(require("../util/Routes"));
+const OAuthApplication_1 = __importDefault(require("../structures/OAuthApplication"));
+const PartialApplication_1 = __importDefault(require("../structures/PartialApplication"));
+const Member_1 = __importDefault(require("../structures/Member"));
+const Webhook_1 = __importDefault(require("../structures/Webhook"));
+const Integration_1 = __importDefault(require("../structures/Integration"));
+const OAuthHelper_1 = __importDefault(require("../rest/OAuthHelper"));
+const OAuthGuild_1 = __importDefault(require("../structures/OAuthGuild"));
+const ExtendedUser_1 = __importDefault(require("../structures/ExtendedUser"));
+const QueryBuilder_1 = __importDefault(require("../util/QueryBuilder"));
+/** Various methods for interacting with oauth. Located at {@link Client#rest | Client#rest}{@link RESTManager#oauth | .oauth}. */
+class OAuth {
+    constructor(manager) {
+        this._manager = manager;
+    }
+    /**
+     * Get an access token for the application owner. If the application is owned by a team, this is restricted to `identify` & `applications.commands.update`.
+     * @param options The options to for the client credentials grant.
+     * @caching This method **does not** cache its result.
+     */
+    async clientCredentialsGrant(options) {
+        options = this._manager.client.util._freeze(options);
+        const form = new FormData();
+        form.append("grant_type", "client_credentials");
+        form.append("scope", options.scopes.join(" "));
+        return this._manager.request({
+            method: "POST",
+            path: Routes.OAUTH_TOKEN,
+            form,
+            auth: (options.clientID ?? this._manager.client["_application"]) && options.clientSecret ? `Basic ${Buffer.from(`${options.clientID ?? this._manager.client["_application"].id}:${options.clientSecret}`).toString("base64")}` : true
+        }).then(data => ({
+            accessToken: data.access_token,
+            expiresIn: data.expires_in,
+            scopes: data.scope.split(" "),
+            tokenType: data.token_type,
+            webhook: data.webhook ? new Webhook_1.default(data.webhook, this._manager.client) : null
+        }));
+    }
+    /**
+     * Exchange a code for an access token.
+     * @param options The options for exchanging the code.
+     * @caching This method **does not** cache its result.
+     */
+    async exchangeCode(options) {
+        options = this._manager.client.util._freeze(options);
+        const form = new FormData();
+        form.append("client_id", options.clientID);
+        form.append("client_secret", options.clientSecret);
+        form.append("code", options.code);
+        form.append("grant_type", "authorization_code");
+        form.append("redirect_uri", options.redirectURI);
+        return this._manager.authRequest({
+            method: "POST",
+            path: Routes.OAUTH_TOKEN,
+            form
+        }).then(data => ({
+            accessToken: data.access_token,
+            expiresIn: data.expires_in,
+            refreshToken: data.refresh_token,
+            scopes: data.scope.split(" "),
+            tokenType: data.token_type,
+            webhook: data.webhook ? new Webhook_1.default(data.webhook, this._manager.client) : null
+        }));
+    }
+    /**
+     * Get the current OAuth2 application's information.
+     * @caching This method **does not** cache its result.
+     */
+    async getApplication() {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_APPLICATION
+        }).then(data => new OAuthApplication_1.default(data, this._manager.client));
+    }
+    /**
+     * Get information about the current authorization.
+     *
+     * Note: OAuth only. Bots cannot use this.
+     * @caching This method **does** cache part of its result.
+     * @caches {@link Client#users | Client#users}
+     */
+    async getCurrentAuthorizationInformation() {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_INFO
+        }).then(data => ({
+            application: new PartialApplication_1.default(data.application, this._manager.client),
+            expires: new Date(data.expires),
+            scopes: data.scopes,
+            user: this._manager.client.users.update(data.user)
+        }));
+    }
+    /**
+     * Get the connections of the currently authenticated user.
+     *
+     * Note: Requires the `connections` scope when using oauth.
+     * @caching This method **does not** cache its result.
+     */
+    async getCurrentConnections() {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_CONNECTIONS
+        }).then(data => data.map(connection => ({
+            friendSync: connection.friend_sync,
+            id: connection.id,
+            integrations: connection.integrations?.map(integration => new Integration_1.default(integration, this._manager.client)),
+            name: connection.name,
+            revoked: connection.revoked,
+            showActivity: connection.show_activity,
+            twoWayLink: connection.two_way_link,
+            type: connection.type,
+            verified: connection.verified,
+            visibility: connection.visibility
+        })));
+    }
+    /**
+     * Get the guild member information about the currently authenticated user.
+     *
+     * Note: OAuth only. Requires the `guilds.members.read` scope. Bots cannot use this.
+     * @param guild the ID of the guild
+     * @caching This method **does not** cache its result.
+     */
+    async getCurrentGuildMember(guild) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_GUILD_MEMBER(guild)
+        }).then(data => new Member_1.default(data, this._manager.client, guild));
+    }
+    /**
+     * Get the currently authenticated user's guilds. Note these are missing several properties gateway guilds have.
+     * @param options The options for getting the current user's guilds.
+     * @caching This method **does not** cache its result.
+     */
+    async getCurrentGuilds(options) {
+        const query = new QueryBuilder_1.default();
+        query.setIfPresent("after", options?.after);
+        query.setIfPresent("before", options?.before);
+        query.setIfPresent("limit", options?.limit);
+        query.setIfPresent("with_counts", options?.withCounts);
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_GUILDS,
+            query
+        }).then(data => data.map(d => new OAuthGuild_1.default(d, this._manager.client)));
+    }
+    /**
+     * Get the currently authenticated user's information.
+     * @caching This method **does not** cache its result.
+     */
+    async getCurrentUser() {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_CURRENT_USER
+        }).then(data => new ExtendedUser_1.default(data, this._manager.client));
+    }
+    /**
+     * Get a helper instance that can be used with a specific access token.
+     * @param accessToken The access token. Must be prefixed with `Bearer `.
+     */
+    getHelper(accessToken) {
+        return new OAuthHelper_1.default(this._manager, accessToken);
+    }
+    /**
+     * Get an application's role connection metadata records.
+     * @param applicationID The ID of the application.
+     * @caching This method **does not** cache its result.
+     */
+    async getRoleConnectionsMetadata(applicationID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.ROLE_CONNECTIONS_METADATA(applicationID)
+        }).then(data => data.map(d => ({
+            description: d.description,
+            descriptionLocalizations: d.description_localizations,
+            key: d.key,
+            name: d.name,
+            nameLocalizations: d.name_localizations,
+            type: d.type
+        })));
+    }
+    /**
+     * Get the authenticated user's role connection object for an application. This requires the `role_connections.write` scope.
+     * @param applicationID The ID of the application.
+     * @caching This method **does not** cache its result.
+     */
+    async getUserRoleConnection(applicationID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.OAUTH_ROLE_CONNECTION(applicationID)
+        }).then(data => ({
+            metadata: Object.entries(data.metadata).map(([key, value]) => ({
+                [key]: {
+                    description: value.description,
+                    descriptionLocalizations: value.description_localizations,
+                    key: value.key,
+                    name: value.name,
+                    nameLocalizations: value.name_localizations,
+                    type: value.type
+                }
+            })).reduce((a, b) => ({ ...a, ...b })),
+            platformName: data.platform_name,
+            platformUsername: data.platform_username
+        }));
+    }
+    /**
+     * Refresh an existing access token.
+     * @param options The options for refreshing the token.
+     * @caching This method **does not** cache its result.
+     */
+    async refreshToken(options) {
+        options = this._manager.client.util._freeze(options);
+        const form = new FormData();
+        form.append("client_id", options.clientID);
+        form.append("client_secret", options.clientSecret);
+        form.append("grant_type", "refresh_token");
+        form.append("refresh_token", options.refreshToken);
+        return this._manager.authRequest({
+            method: "POST",
+            path: Routes.OAUTH_TOKEN,
+            form
+        }).then(data => ({
+            accessToken: data.access_token,
+            expiresIn: data.expires_in,
+            refreshToken: data.refresh_token,
+            scopes: data.scope.split(" "),
+            tokenType: data.token_type
+        }));
+    }
+    /**
+     * Revoke an access token.
+     * @param options The options for revoking the token.
+     * @caching This method **does not** cache its result.
+     */
+    async revokeToken(options) {
+        options = this._manager.client.util._freeze(options);
+        const form = new FormData();
+        form.append("client_id", options.clientID);
+        form.append("client_secret", options.clientSecret);
+        form.append("token", options.token);
+        await this._manager.authRequest({
+            method: "POST",
+            path: Routes.OAUTH_TOKEN_REVOKE,
+            form
+        });
+    }
+    /**
+     * Update an application's role connections metadata.
+     * @param applicationID The ID of the application.
+     * @param metadata The metadata records.
+     * @caching This method **does not** cache its result.
+     */
+    async updateRoleConnectionsMetadata(applicationID, metadata) {
+        return this._manager.authRequest({
+            method: "PUT",
+            path: Routes.ROLE_CONNECTIONS_METADATA(applicationID),
+            json: metadata.map(d => ({
+                description: d.description,
+                description_localizations: d.descriptionLocalizations,
+                key: d.key,
+                name: d.name,
+                name_localizations: d.nameLocalizations,
+                type: d.type
+            }))
+        }).then(data => data.map(d => ({
+            description: d.description,
+            descriptionLocalizations: d.description_localizations,
+            key: d.key,
+            name: d.name,
+            nameLocalizations: d.name_localizations,
+            type: d.type
+        })));
+    }
+    /**
+     * Update the authenticated user's role connection object for an application. This requires the `role_connections.write` scope.
+     * @param applicationID The ID of the application.
+     * @param data The metadata to update.
+     * @caching This method **does not** cache its result.
+     */
+    async updateUserRoleConnection(applicationID, data) {
+        return this._manager.authRequest({
+            method: "PUT",
+            path: Routes.OAUTH_ROLE_CONNECTION(applicationID),
+            json: {
+                metadata: data.metadata,
+                platform_name: data.platformName,
+                platform_username: data.platformUsername
+            }
+        }).then(d => ({
+            metadata: Object.entries(d.metadata).map(([key, value]) => ({
+                [key]: {
+                    description: value.description,
+                    descriptionLocalizations: value.description_localizations,
+                    key: value.key,
+                    name: value.name,
+                    nameLocalizations: value.name_localizations,
+                    type: value.type
+                }
+            })).reduce((a, b) => ({ ...a, ...b })),
+            platformName: d.platform_name,
+            platformUsername: d.platform_username
+        }));
+    }
+}
+exports.default = OAuth;

package/cjs/lib/Discord/routes/Users.cjs

@@ -0,0 +1,107 @@
+"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 });
+const Routes = __importStar(require("../util/Routes"));
+const ExtendedUser_1 = __importDefault(require("../structures/ExtendedUser"));
+/** Various methods for interacting with users. Located at {@link Client#rest | Client#rest}{@link RESTManager#users | .users}. */
+class Users {
+    constructor(manager) {
+        this._manager = manager;
+    }
+    /** Alias for {@link REST/Channels#createDM | Channels#createDM}. */
+    get createDM() {
+        return this._manager.channels.createDM.bind(this._manager.channels);
+    }
+    /**
+     * Edit the currently authenticated user.
+     * @param options The options to edit with.
+     * @caching This method **does not** cache its result.
+     */
+    async editSelf(options) {
+        options = this._manager.client.util._freeze(options);
+        let avatar = options.avatar;
+        let banner = options.banner;
+        if (avatar) {
+            avatar = this._manager.client.util._convertImage(avatar, "avatar");
+        }
+        if (banner) {
+            banner = this._manager.client.util._convertImage(banner, "banner");
+        }
+        return this._manager.authRequest({
+            method: "PATCH",
+            path: Routes.USER("@me"),
+            json: {
+                avatar,
+                banner,
+                username: options.username
+            }
+        }).then(data => new ExtendedUser_1.default(data, this._manager.client));
+    }
+    /**
+     * Get a user.
+     * @param userID the ID of the user
+     * @caching This method **does** cache its result.
+     * @caches {@link Client#users | Client#users}
+     */
+    async get(userID) {
+        return this._manager.authRequest({
+            method: "GET",
+            path: Routes.USER(userID)
+        }).then(data => this._manager.client.users.update(data));
+    }
+    /**
+     * Leave a guild.
+     * @param guildID The ID of the guild to leave.
+     * @caching This method **does not** cache its result.
+     */
+    async leaveGuild(guildID) {
+        await this._manager.authRequest({
+            method: "DELETE",
+            path: Routes.OAUTH_GUILD(guildID)
+        });
+    }
+}
+exports.default = Users;