@mtcute/core 0.5.0 → 0.7.0

package/cjs/highlevel/types/peers/user.js

@@ -0,0 +1,437 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.User = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../utils/index.js");
+const memoize_js_1 = require("../../utils/memoize.js");
+const message_entity_js_1 = require("../messages/message-entity.js");
+const emoji_status_js_1 = require("../reactions/emoji-status.js");
+const chat_colors_js_1 = require("./chat-colors.js");
+const chat_photo_js_1 = require("./chat-photo.js");
+class User {
+    constructor(user) {
+        this.type = 'user';
+        (0, type_assertions_js_1.assertTypeIs)('User#init', user, 'user');
+        this.raw = user;
+    }
+    /** Unique identifier for this user or bot */
+    get id() {
+        return this.raw.id;
+    }
+    /**
+     * Whether this user's information is incomplete.
+     *
+     * This usually only happens in large chats, where
+     * the server sometimes sends only a part of the user's
+     * information. Basic info like name and profile photo
+     * are always available, but other fields may be omitted
+     * despite being available.
+     *
+     * It was observed that these fields may be missing:
+     *   - `username, usernames`
+     *   - `status, lastOnline, nextOffline`
+     *   - `storiesMaxId`
+     *   - `photo` - in some cases when user has some some privacy settings
+     *   - and probably more
+     *
+     * This currently only ever happens for non-bot users, so if you are building
+     * a normal bot, you can safely ignore this field.
+     *
+     * To fetch the "complete" user information, use one of these methods:
+     *  - {@link TelegramClient.getUsers}
+     *  - {@link TelegramClient.getChat}
+     *  - {@link TelegramClient.getFullChat}.
+     *
+     * Learn more: [Incomplete peers](https://mtcute.dev/guide/topics/peers.html#incomplete-peers)
+     */
+    get isMin() {
+        return this.raw.min;
+    }
+    /** Whether this user is you yourself */
+    get isSelf() {
+        return this.raw.self;
+    }
+    /** Whether this user is in your contacts */
+    get isContact() {
+        return this.raw.contact;
+    }
+    /** Whether you both have each other's contact */
+    get isMutualContact() {
+        return this.raw.mutualContact;
+    }
+    /** Whether this user is in yout "close friends" list */
+    get isCloseFriend() {
+        return this.raw.closeFriend;
+    }
+    /** Whether this user is deleted */
+    get isDeleted() {
+        return this.raw.deleted;
+    }
+    /** Whether this user is a bot */
+    get isBot() {
+        return this.raw.bot;
+    }
+    /** Whether this user is a bot that has access to all messages */
+    get isBotWithHistory() {
+        return this.raw.botChatHistory;
+    }
+    /** Whether this user is a bot that can't be added to chats */
+    get isBotWithoutChats() {
+        return this.raw.botNochats;
+    }
+    /** Whether this bot offers an attachment menu web app */
+    get isBotWithAttachmentMenu() {
+        return this.raw.botAttachMenu;
+    }
+    /** Whether this bot can be edited by the current user */
+    get isBotEditable() {
+        return this.raw.botCanEdit;
+    }
+    /** Whether this user has been verified by Telegram */
+    get isVerified() {
+        return this.raw.verified;
+    }
+    /**
+     * Whether this user has been restricted. Bots only.
+     * See {@link restrictionReason} for details
+     */
+    get isRestricted() {
+        return this.raw.restricted;
+    }
+    /**
+     * Reason why this bot was restricted
+     */
+    get restrictionReason() {
+        return this.raw.restrictionReason ?? [];
+    }
+    /** Whether this user has been flagged for scam */
+    get isScam() {
+        return this.raw.scam;
+    }
+    /** Whether this user has been flagged for impersonation */
+    get isFake() {
+        return this.raw.fake;
+    }
+    /** Whether this user is part of the Telegram support team */
+    get isSupport() {
+        return this.raw.support;
+    }
+    /** Whether this user has Premium subscription */
+    get isPremium() {
+        return this.raw.premium;
+    }
+    /** Whether Premium is required to contact this user */
+    get isPremiumRequired() {
+        return this.raw.contactRequirePremium;
+    }
+    /** User's or bot's first name */
+    get firstName() {
+        return this.raw.firstName ?? 'Deleted Account';
+    }
+    /** User's or bot's last name */
+    get lastName() {
+        return this.raw.lastName ?? null;
+    }
+    static parseStatus(status, bot = false) {
+        let ret;
+        let date;
+        let byMe = false;
+        const us = status;
+        if (bot) {
+            ret = 'bot';
+        }
+        else if (!us) {
+            ret = 'long_time_ago';
+        }
+        else {
+            switch (us._) {
+                case 'userStatusOnline':
+                    ret = 'online';
+                    date = new Date(us.expires * 1000);
+                    break;
+                case 'userStatusOffline':
+                    ret = 'offline';
+                    date = new Date(us.wasOnline * 1000);
+                    break;
+                case 'userStatusRecently':
+                    ret = 'recently';
+                    byMe = us.byMe;
+                    break;
+                case 'userStatusLastWeek':
+                    ret = 'within_week';
+                    byMe = us.byMe;
+                    break;
+                case 'userStatusLastMonth':
+                    ret = 'within_month';
+                    byMe = us.byMe;
+                    break;
+                default:
+                    ret = 'long_time_ago';
+                    break;
+            }
+        }
+        return {
+            status: ret,
+            lastOnline: ret === 'offline' ? date : null,
+            nextOffline: ret === 'online' ? date : null,
+            byMe,
+        };
+    }
+    get _parsedStatus() {
+        return User.parseStatus(this.raw.status, this.raw.bot);
+    }
+    /** User's Last Seen & Online status */
+    get status() {
+        return this._parsedStatus.status;
+    }
+    /**
+     * Whether user's online status is hidden because
+     * we have hidden our own online status from them,
+     * and we don't have Premium subscription.
+     */
+    get statusHiddenByMe() {
+        return this._parsedStatus.byMe;
+    }
+    /**
+     * Last time this user was seen online.
+     * Only available if {@link status} is `offline`
+     */
+    get lastOnline() {
+        return this._parsedStatus.lastOnline;
+    }
+    /**
+     * Time when this user will automatically go offline.
+     * Only available if {@link status} is `online`
+     */
+    get nextOffline() {
+        return this._parsedStatus.nextOffline;
+    }
+    /** User's or bot's username */
+    get username() {
+        return this.raw.username ?? this.raw.usernames?.[0]?.username ?? null;
+    }
+    /** User's or bot's usernames (including collectibles) */
+    get usernames() {
+        if (this.raw.username) {
+            return [{ _: 'username', username: this.raw.username, active: true }];
+        }
+        if (!this.raw.usernames?.length) {
+            return null;
+        }
+        return this.raw.usernames;
+    }
+    /**
+     * IETF language tag of the user's language
+     *
+     * Only available in some contexts
+     */
+    get language() {
+        return this.raw.langCode ?? null;
+    }
+    /**
+     * User's or bot's assigned DC (data center).
+     * Available only in case the user has set a public profile photo.
+     *
+     * **Note**: this information is approximate; it is based on where
+     * Telegram stores a user profile pictures and does not by any means tell
+     * you the user location (i.e. a user might travel far away, but will still connect
+     * to its assigned DC).
+     * More info at [Pyrogram FAQ](https://docs.pyrogram.org/faq#what-are-the-ip-addresses-of-telegram-data-centers).
+     */
+    get dcId() {
+        return this.raw.photo?.dcId ?? null;
+    }
+    /** User's phone number */
+    get phoneNumber() {
+        return this.raw.phone ?? null;
+    }
+    /**
+     * Get this user's input peer for advanced use-cases.
+     *
+     * > **Note**: for {@link min} users, this method will return
+     * > `mtcute.dummyInputPeerMinUser`, which is actually not a valid input peer.
+     * > These are used to indicate that the user is incomplete, and a message
+     * > reference is needed to resolve the peer.
+     * >
+     * > Such objects are handled by {@link TelegramClient.resolvePeer} method,
+     * > so prefer using it whenever you need an input peer.
+     */
+    get inputPeer() {
+        if (this.raw.min) {
+            return {
+                _: 'mtcute.dummyInputPeerMinUser',
+                userId: this.raw.id,
+            };
+        }
+        if (!this.raw.accessHash) {
+            throw new errors_js_1.MtArgumentError("user's access hash is not available!");
+        }
+        return {
+            _: 'inputPeerUser',
+            userId: this.raw.id,
+            accessHash: this.raw.accessHash,
+        };
+    }
+    /**
+     * User's or bot's current profile photo, if any.
+     * Suitable for downloads only
+     */
+    get photo() {
+        if (this.raw.photo?._ !== 'userProfilePhoto')
+            return null;
+        return new chat_photo_js_1.ChatPhoto(this.inputPeer, this.raw.photo);
+    }
+    /**
+     * The list of reasons why this bot might be unavailable to some users.
+     * This field is available only in case *isRestricted* is `true`
+     */
+    get restrictions() {
+        return this.raw.restrictionReason ?? null;
+    }
+    /**
+     * User's display name.
+     *
+     * First name and last name if available,
+     * only first name otherwise.
+     */
+    get displayName() {
+        if (!this.firstName)
+            return 'Deleted Account';
+        if (this.lastName)
+            return `${this.firstName} ${this.lastName}`;
+        return this.firstName;
+    }
+    /**
+     * User's emoji status, if any.
+     */
+    get emojiStatus() {
+        if (!this.raw.emojiStatus || this.raw.emojiStatus._ === 'emojiStatusEmpty')
+            return null;
+        return new emoji_status_js_1.EmojiStatus(this.raw.emojiStatus);
+    }
+    /** Whether you have hidden (arhived) this user's stories */
+    get storiesHidden() {
+        return this.raw.storiesHidden;
+    }
+    get storiesUnavailable() {
+        return this.raw.storiesUnavailable;
+    }
+    /**
+     * Maximum ID of stories this user has (or 0 if none)
+     */
+    get storiesMaxId() {
+        return this.raw.storiesMaxId ?? 0;
+    }
+    /**
+     * Color that should be used when rendering replies to
+     * their messages and web previews sent by them,
+     * as well as to render the chat title
+     */
+    get color() {
+        return new chat_colors_js_1.ChatColors(this.raw.id, this.raw.color);
+    }
+    /**
+     * Color that should be used when rendering the header of
+     * the user's profile
+     *
+     * If `null`, a generic header should be used instead
+     */
+    get profileColors() {
+        return this.raw.profileColor ? new chat_colors_js_1.ChatColors(this.raw.id, this.raw.profileColor) : null;
+    }
+    /**
+     * Create a mention for the user.
+     *
+     * When available and `text` is omitted, this method will return `@username`.
+     * Otherwise, text mention is created.
+     *
+     * Use `null` as `text` (first parameter) to force create a text
+     * mention with display name, even if there is a username.
+     *
+     * > **Note**: This method doesn't format anything on its own.
+     * > Instead, it returns a {@link MessageEntity} that can later
+     * > be used with `html` or `md` template tags
+     *
+     * @param text  Text of the mention.
+     * @example
+     * ```typescript
+     * msg.replyText(html`Hello, ${msg.sender.mention()`)
+     * ```
+     */
+    mention(text) {
+        if (text === undefined && this.username) {
+            return `@${this.username}`;
+        }
+        if (!text)
+            text = this.displayName;
+        return new message_entity_js_1.MessageEntity({
+            _: 'messageEntityMentionName',
+            offset: 0,
+            length: text.length,
+            userId: this.raw.id,
+        }, text);
+    }
+    /**
+     * Create a permanent mention for this user.
+     *
+     * *Permanent* means that this mention will also
+     * contain user's access hash, so even if the user
+     * changes their username or the client forgets
+     * about that user, it can still be mentioned.
+     *
+     * Telegram might change access hash in some cases,
+     * so it may not exactly be *permanent*. The only way
+     * to actually make it permanent is to send it as a message
+     * somewhere and load it from there if needed.
+     *
+     * Note that some users (particularly, users with hidden forwards)
+     * may not be mentioned like this outside the chats you have in common.
+     *
+     * This method is only needed when the result will be
+     * stored somewhere outside current mtcute instance (e.g. saved for later use),
+     * otherwise {@link mention} will be enough.
+     *
+     * > **Note**: This method doesn't format anything on its own.
+     * > Instead, it returns a {@link MessageEntity} that can later
+     * > be used with `html` or `md` template tags
+     *
+     * > **Note**: the resulting text can only be used by clients
+     * > that support mtcute notation of permanent
+     * > mention links (`tg://user?id=123&hash=abc`).
+     * >
+     * > Also note that these permanent mentions are only
+     * > valid for current account, since peer access hashes are
+     * > account-specific and can't be used on another account.
+     * >
+     * > Also note that for some users such mentions might not work at all
+     * > due to privacy settings.
+     *
+     * @param text  Mention text
+     */
+    permanentMention(text) {
+        if (!this.raw.accessHash) {
+            throw new errors_js_1.MtArgumentError("User's access hash is not available!");
+        }
+        if (!text)
+            text = this.displayName;
+        return new message_entity_js_1.MessageEntity({
+            _: 'messageEntityTextUrl',
+            offset: 0,
+            length: text.length,
+            url: `tg://user?id=${this.id}&hash=${this.raw.accessHash.toString(16)}`,
+        }, text);
+    }
+}
+exports.User = User;
+(0, memoize_js_1.memoizeGetters)(User, [
+    '_parsedStatus',
+    'usernames',
+    'inputPeer',
+    'photo',
+    'emojiStatus',
+    'color',
+    'profileColors',
+]);
+(0, index_js_1.makeInspectable)(User, undefined, ['_parsedStatus']);
+//# sourceMappingURL=user.js.map

package/cjs/highlevel/types/peers/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/peers/user.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { assertTypeIs } from '../../../utils/type-assertions.js'\nimport { makeInspectable } from '../../utils/index.js'\nimport { memoizeGetters } from '../../utils/memoize.js'\nimport { MessageEntity } from '../messages/message-entity.js'\nimport { EmojiStatus } from '../reactions/emoji-status.js'\nimport { ChatColors } from './chat-colors.js'\nimport { ChatPhoto } from './chat-photo.js'\n\n/**\n * User's Last Seen & Online status.\n * Can be one of the following:\n *  - `online`, user is online right now.\n *  - `offline`, user is currently offline.\n *  - `recently`, user with hidden last seen time who was online between 1 second and 72 hours ago.\n *  - `within_week`, user with hidden last seen time who was online between 72 hours and 7 days ago.\n *  - `within_month`, user with hidden last seen time who was online between 7 days and a month ago.\n *  - `long_time_ago`, blocked user or user with hidden last seen time who was online more than a month ago.\n *  - `bot`, for bots.\n */\nexport type UserStatus = 'online' | 'offline' | 'recently' | 'within_week' | 'within_month' | 'long_time_ago' | 'bot'\n\nexport interface UserParsedStatus {\n    status: UserStatus\n    lastOnline: Date | null\n    nextOffline: Date | null\n    byMe: boolean\n}\n\nexport class User {\n    readonly type = 'user' as const\n\n    /**\n     * Underlying raw TL object\n     */\n    readonly raw: tl.RawUser\n\n    constructor(user: tl.TypeUser) {\n        assertTypeIs('User#init', user, 'user')\n\n        this.raw = user\n    }\n\n    /** Unique identifier for this user or bot */\n    get id(): number {\n        return this.raw.id\n    }\n\n    /**\n     * Whether this user's information is incomplete.\n     *\n     * This usually only happens in large chats, where\n     * the server sometimes sends only a part of the user's\n     * information. Basic info like name and profile photo\n     * are always available, but other fields may be omitted\n     * despite being available.\n     *\n     * It was observed that these fields may be missing:\n     *   - `username, usernames`\n     *   - `status, lastOnline, nextOffline`\n     *   - `storiesMaxId`\n     *   - `photo` - in some cases when user has some some privacy settings\n     *   - and probably more\n     *\n     * This currently only ever happens for non-bot users, so if you are building\n     * a normal bot, you can safely ignore this field.\n     *\n     * To fetch the \"complete\" user information, use one of these methods:\n     *  - {@link TelegramClient.getUsers}\n     *  - {@link TelegramClient.getChat}\n     *  - {@link TelegramClient.getFullChat}.\n     *\n     * Learn more: [Incomplete peers](https://mtcute.dev/guide/topics/peers.html#incomplete-peers)\n     */\n    get isMin(): boolean {\n        return this.raw.min!\n    }\n\n    /** Whether this user is you yourself */\n    get isSelf(): boolean {\n        return this.raw.self!\n    }\n\n    /** Whether this user is in your contacts */\n    get isContact(): boolean {\n        return this.raw.contact!\n    }\n\n    /** Whether you both have each other's contact */\n    get isMutualContact(): boolean {\n        return this.raw.mutualContact!\n    }\n\n    /** Whether this user is in yout \"close friends\" list */\n    get isCloseFriend(): boolean {\n        return this.raw.closeFriend!\n    }\n\n    /** Whether this user is deleted */\n    get isDeleted(): boolean {\n        return this.raw.deleted!\n    }\n\n    /** Whether this user is a bot */\n    get isBot(): boolean {\n        return this.raw.bot!\n    }\n\n    /** Whether this user is a bot that has access to all messages */\n    get isBotWithHistory(): boolean {\n        return this.raw.botChatHistory!\n    }\n\n    /** Whether this user is a bot that can't be added to chats */\n    get isBotWithoutChats(): boolean {\n        return this.raw.botNochats!\n    }\n\n    /** Whether this bot offers an attachment menu web app */\n    get isBotWithAttachmentMenu(): boolean {\n        return this.raw.botAttachMenu!\n    }\n\n    /** Whether this bot can be edited by the current user */\n    get isBotEditable(): boolean {\n        return this.raw.botCanEdit!\n    }\n\n    /** Whether this user has been verified by Telegram */\n    get isVerified(): boolean {\n        return this.raw.verified!\n    }\n\n    /**\n     * Whether this user has been restricted. Bots only.\n     * See {@link restrictionReason} for details\n     */\n    get isRestricted(): boolean {\n        return this.raw.restricted!\n    }\n\n    /**\n     * Reason why this bot was restricted\n     */\n    get restrictionReason(): tl.TypeRestrictionReason[] {\n        return this.raw.restrictionReason ?? []\n    }\n\n    /** Whether this user has been flagged for scam */\n    get isScam(): boolean {\n        return this.raw.scam!\n    }\n\n    /** Whether this user has been flagged for impersonation */\n    get isFake(): boolean {\n        return this.raw.fake!\n    }\n\n    /** Whether this user is part of the Telegram support team */\n    get isSupport(): boolean {\n        return this.raw.support!\n    }\n\n    /** Whether this user has Premium subscription */\n    get isPremium(): boolean {\n        return this.raw.premium!\n    }\n\n    /** Whether Premium is required to contact this user */\n    get isPremiumRequired(): boolean {\n        return this.raw.contactRequirePremium!\n    }\n\n    /** User's or bot's first name */\n    get firstName(): string {\n        return this.raw.firstName ?? 'Deleted Account'\n    }\n\n    /** User's or bot's last name */\n    get lastName(): string | null {\n        return this.raw.lastName ?? null\n    }\n\n    static parseStatus(status?: tl.TypeUserStatus, bot = false): UserParsedStatus {\n        let ret: UserStatus\n        let date: Date\n        let byMe = false\n\n        const us = status\n\n        if (bot) {\n            ret = 'bot'\n        } else if (!us) {\n            ret = 'long_time_ago'\n        } else {\n            switch (us._) {\n                case 'userStatusOnline':\n                    ret = 'online'\n                    date = new Date(us.expires * 1000)\n                    break\n                case 'userStatusOffline':\n                    ret = 'offline'\n                    date = new Date(us.wasOnline * 1000)\n                    break\n                case 'userStatusRecently':\n                    ret = 'recently'\n                    byMe = us.byMe!\n                    break\n                case 'userStatusLastWeek':\n                    ret = 'within_week'\n                    byMe = us.byMe!\n                    break\n                case 'userStatusLastMonth':\n                    ret = 'within_month'\n                    byMe = us.byMe!\n                    break\n                default:\n                    ret = 'long_time_ago'\n                    break\n            }\n        }\n\n        return {\n            status: ret,\n            lastOnline: ret === 'offline' ? date! : null,\n            nextOffline: ret === 'online' ? date! : null,\n            byMe,\n        }\n    }\n\n    private get _parsedStatus() {\n        return User.parseStatus(this.raw.status, this.raw.bot)\n    }\n\n    /** User's Last Seen & Online status */\n    get status(): UserStatus {\n        return this._parsedStatus.status\n    }\n\n    /**\n     * Whether user's online status is hidden because\n     * we have hidden our own online status from them,\n     * and we don't have Premium subscription.\n     */\n    get statusHiddenByMe(): boolean {\n        return this._parsedStatus.byMe\n    }\n\n    /**\n     * Last time this user was seen online.\n     * Only available if {@link status} is `offline`\n     */\n    get lastOnline(): Date | null {\n        return this._parsedStatus.lastOnline\n    }\n\n    /**\n     * Time when this user will automatically go offline.\n     * Only available if {@link status} is `online`\n     */\n    get nextOffline(): Date | null {\n        return this._parsedStatus.nextOffline\n    }\n\n    /** User's or bot's username */\n    get username(): string | null {\n        return this.raw.username ?? this.raw.usernames?.[0]?.username ?? null\n    }\n\n    /** User's or bot's usernames (including collectibles) */\n    get usernames(): ReadonlyArray<tl.RawUsername> | null {\n        if (this.raw.username) {\n            return [{ _: 'username', username: this.raw.username, active: true }]\n        }\n\n        if (!this.raw.usernames?.length) {\n            return null\n        }\n\n        return this.raw.usernames\n    }\n\n    /**\n     * IETF language tag of the user's language\n     *\n     * Only available in some contexts\n     */\n    get language(): string | null {\n        return this.raw.langCode ?? null\n    }\n\n    /**\n     * User's or bot's assigned DC (data center).\n     * Available only in case the user has set a public profile photo.\n     *\n     * **Note**: this information is approximate; it is based on where\n     * Telegram stores a user profile pictures and does not by any means tell\n     * you the user location (i.e. a user might travel far away, but will still connect\n     * to its assigned DC).\n     * More info at [Pyrogram FAQ](https://docs.pyrogram.org/faq#what-are-the-ip-addresses-of-telegram-data-centers).\n     */\n    get dcId(): number | null {\n        return (this.raw.photo as Exclude<typeof this.raw.photo, tl.RawUserProfilePhotoEmpty>)?.dcId ?? null\n    }\n\n    /** User's phone number */\n    get phoneNumber(): string | null {\n        return this.raw.phone ?? null\n    }\n\n    /**\n     * Get this user's input peer for advanced use-cases.\n     *\n     * > **Note**: for {@link min} users, this method will return\n     * > `mtcute.dummyInputPeerMinUser`, which is actually not a valid input peer.\n     * > These are used to indicate that the user is incomplete, and a message\n     * > reference is needed to resolve the peer.\n     * >\n     * > Such objects are handled by {@link TelegramClient.resolvePeer} method,\n     * > so prefer using it whenever you need an input peer.\n     */\n    get inputPeer(): tl.TypeInputPeer {\n        if (this.raw.min) {\n            return {\n                _: 'mtcute.dummyInputPeerMinUser',\n                userId: this.raw.id,\n            }\n        }\n\n        if (!this.raw.accessHash) {\n            throw new MtArgumentError(\"user's access hash is not available!\")\n        }\n\n        return {\n            _: 'inputPeerUser',\n            userId: this.raw.id,\n            accessHash: this.raw.accessHash,\n        }\n    }\n\n    /**\n     * User's or bot's current profile photo, if any.\n     * Suitable for downloads only\n     */\n    get photo(): ChatPhoto | null {\n        if (this.raw.photo?._ !== 'userProfilePhoto') return null\n\n        return new ChatPhoto(this.inputPeer, this.raw.photo)\n    }\n\n    /**\n     * The list of reasons why this bot might be unavailable to some users.\n     * This field is available only in case *isRestricted* is `true`\n     */\n    get restrictions(): ReadonlyArray<tl.RawRestrictionReason> | null {\n        return this.raw.restrictionReason ?? null\n    }\n\n    /**\n     * User's display name.\n     *\n     * First name and last name if available,\n     * only first name otherwise.\n     */\n    get displayName(): string {\n        if (!this.firstName) return 'Deleted Account'\n        if (this.lastName) return `${this.firstName} ${this.lastName}`\n\n        return this.firstName\n    }\n\n    /**\n     * User's emoji status, if any.\n     */\n    get emojiStatus(): EmojiStatus | null {\n        if (!this.raw.emojiStatus || this.raw.emojiStatus._ === 'emojiStatusEmpty') return null\n\n        return new EmojiStatus(this.raw.emojiStatus)\n    }\n\n    /** Whether you have hidden (arhived) this user's stories */\n    get storiesHidden(): boolean {\n        return this.raw.storiesHidden!\n    }\n\n    get storiesUnavailable(): boolean {\n        return this.raw.storiesUnavailable!\n    }\n\n    /**\n     * Maximum ID of stories this user has (or 0 if none)\n     */\n    get storiesMaxId(): number {\n        return this.raw.storiesMaxId ?? 0\n    }\n\n    /**\n     * Color that should be used when rendering replies to\n     * their messages and web previews sent by them,\n     * as well as to render the chat title\n     */\n    get color(): ChatColors {\n        return new ChatColors(this.raw.id, this.raw.color)\n    }\n\n    /**\n     * Color that should be used when rendering the header of\n     * the user's profile\n     *\n     * If `null`, a generic header should be used instead\n     */\n    get profileColors(): ChatColors | null {\n        return this.raw.profileColor ? new ChatColors(this.raw.id, this.raw.profileColor) : null\n    }\n\n    /**\n     * Create a mention for the user.\n     *\n     * When available and `text` is omitted, this method will return `@username`.\n     * Otherwise, text mention is created.\n     *\n     * Use `null` as `text` (first parameter) to force create a text\n     * mention with display name, even if there is a username.\n     *\n     * > **Note**: This method doesn't format anything on its own.\n     * > Instead, it returns a {@link MessageEntity} that can later\n     * > be used with `html` or `md` template tags\n     *\n     * @param text  Text of the mention.\n     * @example\n     * ```typescript\n     * msg.replyText(html`Hello, ${msg.sender.mention()`)\n     * ```\n     */\n    mention(text?: string | null): string | MessageEntity {\n        if (text === undefined && this.username) {\n            return `@${this.username}`\n        }\n\n        if (!text) text = this.displayName\n\n        return new MessageEntity(\n            {\n                _: 'messageEntityMentionName',\n                offset: 0,\n                length: text.length,\n                userId: this.raw.id,\n            },\n            text,\n        )\n    }\n\n    /**\n     * Create a permanent mention for this user.\n     *\n     * *Permanent* means that this mention will also\n     * contain user's access hash, so even if the user\n     * changes their username or the client forgets\n     * about that user, it can still be mentioned.\n     *\n     * Telegram might change access hash in some cases,\n     * so it may not exactly be *permanent*. The only way\n     * to actually make it permanent is to send it as a message\n     * somewhere and load it from there if needed.\n     *\n     * Note that some users (particularly, users with hidden forwards)\n     * may not be mentioned like this outside the chats you have in common.\n     *\n     * This method is only needed when the result will be\n     * stored somewhere outside current mtcute instance (e.g. saved for later use),\n     * otherwise {@link mention} will be enough.\n     *\n     * > **Note**: This method doesn't format anything on its own.\n     * > Instead, it returns a {@link MessageEntity} that can later\n     * > be used with `html` or `md` template tags\n     *\n     * > **Note**: the resulting text can only be used by clients\n     * > that support mtcute notation of permanent\n     * > mention links (`tg://user?id=123&hash=abc`).\n     * >\n     * > Also note that these permanent mentions are only\n     * > valid for current account, since peer access hashes are\n     * > account-specific and can't be used on another account.\n     * >\n     * > Also note that for some users such mentions might not work at all\n     * > due to privacy settings.\n     *\n     * @param text  Mention text\n     */\n    permanentMention(text?: string | null): MessageEntity {\n        if (!this.raw.accessHash) {\n            throw new MtArgumentError(\"User's access hash is not available!\")\n        }\n\n        if (!text) text = this.displayName\n\n        return new MessageEntity(\n            {\n                _: 'messageEntityTextUrl',\n                offset: 0,\n                length: text.length,\n                url: `tg://user?id=${this.id}&hash=${this.raw.accessHash.toString(16)}`,\n            },\n            text,\n        )\n    }\n}\n\nmemoizeGetters(User, [\n    '_parsedStatus' as keyof User,\n    'usernames',\n    'inputPeer',\n    'photo',\n    'emojiStatus',\n    'color',\n    'profileColors',\n])\nmakeInspectable(User, undefined, ['_parsedStatus' as keyof User])\n"]}

package/cjs/highlevel/types/peers/user.test.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/highlevel/types/peers/user.test.js

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const long_1 = __importDefault(require("long"));
+const vitest_1 = require("vitest");
+const test_1 = require("@mtcute/test");
+const index_js_1 = require("../messages/index.js");
+const user_js_1 = require("./user.js");
+(0, vitest_1.describe)('User', () => {
+    (0, vitest_1.describe)('inputPeer', () => {
+        (0, vitest_1.it)('should return correct input peer', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                id: 123,
+                accessHash: long_1.default.fromBits(456, 789),
+            }));
+            (0, vitest_1.expect)(user.inputPeer).toEqual({
+                _: 'inputPeerUser',
+                userId: 123,
+                accessHash: long_1.default.fromBits(456, 789),
+            });
+        });
+        (0, vitest_1.it)('should throw if user has no access hash', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                id: 123,
+                accessHash: undefined,
+            }));
+            (0, vitest_1.expect)(() => user.inputPeer).toThrow();
+        });
+        (0, vitest_1.it)('should return correct input peer for min', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                id: 123,
+                accessHash: long_1.default.fromBits(456, 789),
+                min: true,
+            }));
+            (0, vitest_1.expect)(user.inputPeer).toEqual({
+                _: 'mtcute.dummyInputPeerMinUser',
+                userId: 123,
+            });
+        });
+    });
+    (0, vitest_1.describe)('status', () => {
+        (0, vitest_1.it)('should correctly handle bot online status', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                bot: true,
+            }));
+            (0, vitest_1.expect)(user.status).toEqual('bot');
+            (0, vitest_1.expect)(user.lastOnline).toBeNull();
+            (0, vitest_1.expect)(user.nextOffline).toBeNull();
+        });
+        (0, vitest_1.it)('should correctly handle online status', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                status: {
+                    _: 'userStatusOnline',
+                    expires: 1000,
+                },
+            }));
+            (0, vitest_1.expect)(user.status).toEqual('online');
+            (0, vitest_1.expect)(user.lastOnline).toBeNull();
+            (0, vitest_1.expect)(user.nextOffline).toEqual(new Date(1000000));
+        });
+        (0, vitest_1.it)('should correctly handle offline status', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                status: {
+                    _: 'userStatusOffline',
+                    wasOnline: 1000,
+                },
+            }));
+            (0, vitest_1.expect)(user.status).toEqual('offline');
+            (0, vitest_1.expect)(user.lastOnline).toEqual(new Date(1000000));
+            (0, vitest_1.expect)(user.nextOffline).toBeNull();
+        });
+        vitest_1.it.each([
+            ['userStatusRecently', 'recently'],
+            ['userStatusLastWeek', 'within_week'],
+            ['userStatusLastMonth', 'within_month'],
+            ['userStatusEmpty', 'long_time_ago'],
+        ])('should correctly handle %s status', (status, expected) => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                status: {
+                    _: status,
+                },
+            }));
+            (0, vitest_1.expect)(user.status).toEqual(expected);
+            (0, vitest_1.expect)(user.lastOnline).toBeNull();
+            (0, vitest_1.expect)(user.nextOffline).toBeNull();
+        });
+    });
+    (0, vitest_1.describe)('usernames', () => {
+        (0, vitest_1.it)('should handle users with one username', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                username: 'test',
+            }));
+            (0, vitest_1.expect)(user.username).toEqual('test');
+            (0, vitest_1.expect)(user.usernames).toEqual([{ _: 'username', username: 'test', active: true }]);
+        });
+        (0, vitest_1.it)('should handle users with multiple usernames', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                usernames: [
+                    { _: 'username', username: 'test', active: true },
+                    { _: 'username', username: 'test2', active: false },
+                ],
+            }));
+            (0, vitest_1.expect)(user.username).toEqual('test');
+            (0, vitest_1.expect)(user.usernames).toEqual([
+                { _: 'username', username: 'test', active: true },
+                { _: 'username', username: 'test2', active: false },
+            ]);
+        });
+        (0, vitest_1.it)('should handle users with both username and usernames', () => {
+            // according to docs, this shouldn't ever actually happen,
+            // but just in case. let's just ignore the usernames field
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                username: 'test1',
+                usernames: [
+                    { _: 'username', username: 'test2', active: true },
+                    { _: 'username', username: 'test3', active: false },
+                ],
+            }));
+            (0, vitest_1.expect)(user.username).toEqual('test1');
+            (0, vitest_1.expect)(user.usernames).toEqual([{ _: 'username', username: 'test1', active: true }]);
+        });
+    });
+    (0, vitest_1.describe)('displayName', () => {
+        (0, vitest_1.it)('should work for users without first name', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                firstName: undefined,
+            }));
+            (0, vitest_1.expect)(user.displayName).toEqual('Deleted Account');
+        });
+        (0, vitest_1.it)('should work for users with only first name', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                firstName: 'John',
+            }));
+            (0, vitest_1.expect)(user.displayName).toEqual('John');
+        });
+        (0, vitest_1.it)('should work for users with first and last name', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                firstName: 'John',
+                lastName: 'Doe',
+            }));
+            (0, vitest_1.expect)(user.displayName).toEqual('John Doe');
+        });
+    });
+    (0, vitest_1.describe)('mention', () => {
+        (0, vitest_1.it)('should work for users with a username', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                username: 'test',
+            }));
+            (0, vitest_1.expect)(user.mention()).toEqual('@test');
+        });
+        (0, vitest_1.it)('should work for users with multiple usernames', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                usernames: [
+                    { _: 'username', username: 'test', active: true },
+                    { _: 'username', username: 'test2', active: false },
+                ],
+            }));
+            (0, vitest_1.expect)(user.mention()).toEqual('@test');
+        });
+        (0, vitest_1.it)('should work for users without a username', () => {
+            const user = new user_js_1.User((0, test_1.createStub)('user', {
+                firstName: 'John',
+                lastName: 'Doe',
+            }));
+            (0, vitest_1.expect)(user.mention()).toEqual(new index_js_1.MessageEntity({
+                _: 'messageEntityMentionName',
+                userId: user.id,
+                offset: 0,
+                length: 8,
+            }, 'John Doe'));
+        });
+    });
+});
+//# sourceMappingURL=user.test.js.map