mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2024-11-08 08:47:17 +01:00
250 lines
6.7 KiB
C++
250 lines
6.7 KiB
C++
/************************************************************************************
|
|
*
|
|
* D++, A Lightweight C++ library for Discord
|
|
*
|
|
* Copyright 2021 Craig Edwards and D++ contributors
|
|
* (https://github.com/brainboxdotcc/DPP/graphs/contributors)
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
************************************************************************************/
|
|
#pragma once
|
|
#include <dpp/export.h>
|
|
#include <dpp/json_fwd.hpp>
|
|
|
|
namespace dpp {
|
|
|
|
/**
|
|
* @brief Various bitmask flags used to represent information about a dpp::user
|
|
*/
|
|
enum user_flags {
|
|
/// User is a bot
|
|
u_bot = 0b00000000000000000000001,
|
|
/// User is a system user (Clyde!)
|
|
u_system = 0b00000000000000000000010,
|
|
/// User has multi-factor authentication enabled
|
|
u_mfa_enabled = 0b00000000000000000000100,
|
|
/// User is verified (verified email address)
|
|
u_verified = 0b00000000000000000001000,
|
|
/// User has full nitro
|
|
u_nitro_full = 0b00000000000000000010000,
|
|
/// User has nitro classic
|
|
u_nitro_classic = 0b00000000000000000100000,
|
|
/// User is discord staff
|
|
u_discord_employee = 0b00000000000000001000000,
|
|
/// User owns a partnered server
|
|
u_partnered_owner = 0b00000000000000010000000,
|
|
/// User is a member of hypesquad events
|
|
u_hypesquad_events = 0b00000000000000100000000,
|
|
/// User has BugHunter level 1
|
|
u_bughunter_1 = 0b00000000000001000000000,
|
|
/// User is a member of House Bravery
|
|
u_house_bravery = 0b00000000000010000000000,
|
|
/// User is a member of House Brilliance
|
|
u_house_brilliance = 0b00000000000100000000000,
|
|
/// User is a member of House Balance
|
|
u_house_balanace = 0b00000000001000000000000,
|
|
/// User is an early supporter
|
|
u_early_supporter = 0b00000000010000000000000,
|
|
/// User is a team user
|
|
u_team_user = 0b00000000100000000000000,
|
|
/// User is has Bug Hunter level 2
|
|
u_bughunter_2 = 0b00000001000000000000000,
|
|
/// User is a verified bot
|
|
u_verified_bot = 0b00000010000000000000000,
|
|
/// User has the Early Verified Bot Developer badge
|
|
u_verified_bot_dev = 0b00000100000000000000000,
|
|
/// User's icon is animated
|
|
u_animated_icon = 0b00001000000000000000000,
|
|
/// User is a certified moderator
|
|
u_certified_moderator = 0b00010000000000000000000
|
|
};
|
|
|
|
/**
|
|
* @brief Represents a user on discord. May or may not be a member of a dpp::guild.
|
|
*/
|
|
class CoreExport user : public managed {
|
|
public:
|
|
/** Discord username */
|
|
std::string username;
|
|
/** Discriminator (aka tag), 4 digits usually displayed with leading zeroes */
|
|
uint16_t discriminator;
|
|
/** Avatar hash */
|
|
utility::iconhash avatar;
|
|
/** Flags built from a bitmask of values in dpp::user_flags */
|
|
uint32_t flags;
|
|
/** Reference count of how many guilds this user is in */
|
|
uint8_t refcount;
|
|
|
|
/**
|
|
* @brief Construct a new user object
|
|
*/
|
|
user();
|
|
|
|
/**
|
|
* @brief Destroy the user object
|
|
*/
|
|
virtual ~user();
|
|
|
|
/** Fill this record from json.
|
|
* @param j The json to fill this record from
|
|
* @return Reference to self
|
|
*/
|
|
user& fill_from_json(nlohmann::json* j);
|
|
|
|
/**
|
|
* @brief Get the avatar url of the user object
|
|
*
|
|
* @return std::string avatar url
|
|
*/
|
|
std::string get_avatar_url() const;
|
|
|
|
/**
|
|
* @brief User is a bot
|
|
*
|
|
* @return True if the user is a bot
|
|
*/
|
|
bool is_bot() const;
|
|
/**
|
|
* @brief User is a system user (Clyde)
|
|
*
|
|
* @return true if user is a system user
|
|
*/
|
|
bool is_system() const;
|
|
/**
|
|
* @brief User has multi-factor authentication enabled
|
|
*
|
|
* @return true if multi-factor is enabled
|
|
*/
|
|
bool is_mfa_enabled() const;
|
|
/**
|
|
* @brief Return true if user has verified account
|
|
*
|
|
* @return true if verified
|
|
*/
|
|
bool is_verified() const;
|
|
/**
|
|
* @brief Return true if user has full nitro.
|
|
* This is mutually exclusive with full nitro.
|
|
*
|
|
* @return true if user has full nitro
|
|
*/
|
|
bool has_nitro_full() const;
|
|
/**
|
|
* @brief Return true if user has nitro classic.
|
|
* This is mutually exclusive with nitro classic.
|
|
*
|
|
* @return true if user has nitro classic
|
|
*/
|
|
bool has_nitro_classic() const;
|
|
/**
|
|
* @brief Return true if user is a discord employee
|
|
*
|
|
* @return true if user is discord staff
|
|
*/
|
|
bool is_discord_employee() const;
|
|
/**
|
|
* @brief Return true if user owns a partnered server
|
|
*
|
|
* @return true if user has partnered server
|
|
*/
|
|
bool is_partnered_owner() const;
|
|
/**
|
|
* @brief Return true if user has hypesquad events
|
|
*
|
|
* @return true if has hypesquad events
|
|
*/
|
|
bool has_hypesquad_events() const;
|
|
/**
|
|
* @brief Return true if user has the bughunter level 1 badge
|
|
*
|
|
* @return true if has bughunter level 1
|
|
*/
|
|
bool is_bughunter_1() const;
|
|
/**
|
|
* @brief Return true if user is in house bravery
|
|
*
|
|
* @return true if in house bravery
|
|
*/
|
|
bool is_house_bravery() const;
|
|
/**
|
|
* @brief Return true if user is in house brilliance
|
|
*
|
|
* @return true if in house brilliance
|
|
*/
|
|
bool is_house_brilliance() const;
|
|
/**
|
|
* @brief Return true if user is in house balance
|
|
*
|
|
* @return true if in house brilliance
|
|
*/
|
|
bool is_house_balanace() const;
|
|
/**
|
|
* @brief Return true if user is an early supporter
|
|
*
|
|
* @return true if early supporter
|
|
*/
|
|
bool is_early_supporter() const;
|
|
/**
|
|
* @brief Return true if user is a team user
|
|
*
|
|
* @return true if a team user
|
|
*/
|
|
bool is_team_user() const;
|
|
/**
|
|
* @brief Return true if user has the bughunter level 2 badge
|
|
*
|
|
* @return true if has bughunter level 2
|
|
*/
|
|
bool is_bughunter_2() const;
|
|
/**
|
|
* @brief Return true if user has the verified bot badge
|
|
*
|
|
* @return true if verified bot
|
|
*/
|
|
bool is_verified_bot() const;
|
|
/**
|
|
* @brief Return true if user is an early verified bot developer
|
|
*
|
|
* @return true if verified bot developer
|
|
*/
|
|
bool is_verified_bot_dev() const;
|
|
/**
|
|
* @brief Return true if user is a certified moderator
|
|
*
|
|
* @return true if certified moderator
|
|
*/
|
|
bool is_certified_moderator() const;
|
|
/**
|
|
* @brief Return true if user has an animated icon
|
|
*
|
|
* @return true if icon is animated (gif)
|
|
*/
|
|
bool has_animated_icon() const;
|
|
};
|
|
|
|
/**
|
|
* @brief helper function to deserialize a user from json
|
|
*
|
|
* @see https://github.com/nlohmann/json#arbitrary-types-conversions
|
|
*
|
|
* @param j output json object
|
|
* @param u user to be deserialized
|
|
*/
|
|
void from_json(const nlohmann::json& j, user& u);
|
|
|
|
/** A group of users */
|
|
typedef std::unordered_map<snowflake, user> user_map;
|
|
|
|
};
|