@mtcute/core 0.17.0 → 0.18.0-rc.5

package/highlevel/types/peers/forum-topic.d.ts

@@ -1,6 +1,6 @@
 import { tl } from '@mtcute/tl';
-import { DraftMessage, Message } from '../messages/index.js';
 import { Peer } from './peer.js';
+import { DraftMessage, Message } from '../messages/index.js';
 import { PeersIndex } from './peers-index.js';
 export declare class ForumTopic {
     readonly raw: tl.RawForumTopic;

package/highlevel/types/peers/forum-topic.js

@@ -0,0 +1,155 @@
+import { hasValueAtKey } from "../../../utils/type-assertions.js";
+import { memoizeGetters } from "../../utils/memoize.js";
+import { MtMessageNotFoundError } from "../errors.js";
+import { parsePeer } from "./peer.js";
+import { PeersIndex } from "./peers-index.js";
+import { Message as Message$2 } from "../messages/message.js";
+import { DraftMessage as DraftMessage$2 } from "../messages/draft-message.js";
+import { makeInspectable } from "../../utils/inspectable.js";
+class ForumTopic {
+  constructor(raw, _peers, _messages) {
+    this.raw = raw;
+    this._peers = _peers;
+    this._messages = _messages;
+  }
+  static COLOR_BLUE = 7322096;
+  static COLOR_YELLOW = 16766590;
+  static COLOR_PURPLE = 13338331;
+  static COLOR_GREEN = 9367192;
+  static COLOR_PINK = 16749490;
+  static COLOR_RED = 16478047;
+  static parseTlForumTopics(topics) {
+    const peers = PeersIndex.from(topics);
+    const messages = /* @__PURE__ */ new Map();
+    topics.messages.forEach((msg) => {
+      if (!msg.peerId) return;
+      messages.set(msg.id, msg);
+    });
+    return topics.topics.filter(hasValueAtKey("_", "forumTopic")).map((it) => new ForumTopic(it, peers, messages));
+  }
+  /**
+   * Whether the topic was created by the current user
+   */
+  get isMy() {
+    return this.raw.my;
+  }
+  /**
+   * Whether the topic is closed
+   */
+  get isClosed() {
+    return this.raw.closed;
+  }
+  /**
+   * Whether the topic is pinned
+   */
+  get isPinned() {
+    return this.raw.pinned;
+  }
+  /**
+   * Whether this constructor is a reduced version of the full topic information.
+   *
+   * If `true`, only {@link isMy}, {@link isClosed}, {@link id}, {@link date},
+   * {@link title}, {@link iconColor}, {@link iconCustomEmoji} and {@link creator}
+   * parameters will contain valid information.
+   */
+  get isShort() {
+    return this.raw.short;
+  }
+  /**
+   * ID of the topic
+   */
+  get id() {
+    return this.raw.id;
+  }
+  /**
+   * Date when the topic was created
+   */
+  get date() {
+    return new Date(this.raw.date * 1e3);
+  }
+  /**
+   * Title of the topic
+   */
+  get title() {
+    return this.raw.title;
+  }
+  /**
+   * Color of the topic's icon, used as a fallback
+   * in case {@link iconEmoji} is not set.
+   *
+   * One of the static `COLOR_*` fields.
+   */
+  get iconColor() {
+    return this.raw.iconColor ?? null;
+  }
+  /**
+   * Emoji used as the topic's icon.
+   */
+  get iconCustomEmoji() {
+    return this.raw.iconEmojiId ?? null;
+  }
+  /**
+   * Creator of the topic
+   */
+  get creator() {
+    return parsePeer(this.raw.fromId, this._peers);
+  }
+  /**
+   * The latest message sent in this topic
+   */
+  get lastMessage() {
+    const id = this.raw.topMessage;
+    if (this._messages?.has(id)) {
+      return new Message$2(this._messages.get(id), this._peers);
+    }
+    throw new MtMessageNotFoundError(0, id);
+  }
+  /**
+   * ID of the last read outgoing message in this topic
+   */
+  get lastReadIngoing() {
+    return this.raw.readInboxMaxId;
+  }
+  /**
+   * ID of the last read ingoing message in this topic
+   */
+  get lastReadOutgoing() {
+    return this.raw.readOutboxMaxId;
+  }
+  /**
+   * ID of the last read message in this topic
+   */
+  get lastRead() {
+    return Math.max(this.raw.readOutboxMaxId, this.raw.readInboxMaxId);
+  }
+  /**
+   * Number of unread messages in the topic
+   */
+  get unreadCount() {
+    return this.raw.unreadCount;
+  }
+  /**
+   * Number of unread mentions in the topic
+   */
+  get unreadMentionsCount() {
+    return this.raw.unreadMentionsCount;
+  }
+  /**
+   * Number of unread reactions in the topic
+   */
+  get unreadReactionsCount() {
+    return this.raw.unreadReactionsCount;
+  }
+  /**
+   * Draft message in the topic
+   */
+  get draftMessage() {
+    if (!this.raw.draft || this.raw.draft._ === "draftMessageEmpty") return null;
+    return new DraftMessage$2(this.raw.draft);
+  }
+}
+const ForumTopic$1 = /* @__PURE__ */ memoizeGetters(ForumTopic, ["creator", "lastMessage", "draftMessage"]);
+const ForumTopic$2 = /* @__PURE__ */ makeInspectable(ForumTopic$1);
+export {
+  ForumTopic$2 as ForumTopic
+};

package/highlevel/types/peers/full-chat.cjs

@@ -0,0 +1,308 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const inspectable = require("../../utils/inspectable.cjs");
+const memoize = require("../../utils/memoize.cjs");
+const photo = require("../media/photo.cjs");
+const stickerSet = require("../misc/sticker-set.cjs");
+const peerStories = require("../stories/peer-stories.cjs");
+const botInfo = require("./bot-info.cjs");
+const chatInviteLink = require("./chat-invite-link.cjs");
+const chatLocation = require("./chat-location.cjs");
+const chat = require("./chat.cjs");
+const peersIndex = require("./peers-index.cjs");
+const user = require("./user.cjs");
+class FullChat extends chat.Chat {
+  peers;
+  full;
+  constructor(obj) {
+    const peers = peersIndex.PeersIndex.from(obj);
+    super(peers.chat(obj.fullChat.id));
+    this.peers = peers;
+    this.full = obj.fullChat;
+  }
+  /** Whether this chat is archived */
+  get isArchived() {
+    return this.full._ === "channelFull" && this.full.folderId === 1;
+  }
+  /** Whether paid reactions are enabled for this channel */
+  get hasPaidReactions() {
+    return this.full?._ === "channelFull" && this.full.paidReactionsAvailable;
+  }
+  /** Whether this channel has hidden participants */
+  get hasHiddenParticipants() {
+    return this.full._ === "channelFull" && !this.full.participantsHidden;
+  }
+  /** Whether the current user can change the chat's username */
+  get canSetUsername() {
+    return this.full.canSetUsername;
+  }
+  /** Whether the current user can change the chat's sticker set */
+  get canSetStickers() {
+    return this.full._ === "channelFull" && this.full.canSetStickers;
+  }
+  /** Whether the history before we joined the chat is hidden */
+  get hasHiddenHistory() {
+    return this.full._ === "channelFull" && this.full.hiddenPrehistory;
+  }
+  /** Whether there are scheduled messages in this chat */
+  get hasScheduledMessages() {
+    return this.full._ === "channelFull" && this.full.hasScheduled;
+  }
+  /** Whether the current user can view the chat's statistics */
+  get canViewStats() {
+    return this.full._ === "channelFull" && this.full.canViewStats;
+  }
+  /** Whether the current user can view the chat's participants list */
+  get canViewParticipants() {
+    return this.full._ === "channelFull" && this.full.canViewParticipants;
+  }
+  /** Whether the current user can delete the chat */
+  get canDeleteChat() {
+    switch (this.full._) {
+      case "channelFull":
+        return this.full.canDeleteChannel;
+      case "chatFull":
+        return this.raw._ === "chat" && this.raw.creator;
+    }
+  }
+  /**
+   * Whether the current user has blocked any anonumous admin of the supergroup.
+   * If set, you won't receive mentions from them, nor their replies in `@replies`
+   */
+  get isBlocked() {
+    return this.full._ === "channelFull" && this.full.blocked;
+  }
+  /** Whether the native antispam is enabled for this channel */
+  get hasNativeAntispam() {
+    return this.full._ === "channelFull" && this.full.antispam;
+  }
+  /** Whether the real-time translations popup should not be shown for this channel */
+  get hasTranslationsDisabled() {
+    return this.full._ === "channelFull" && this.full.translationsDisabled;
+  }
+  /** Whether this chat has pinned stories */
+  get hasPinnedStories() {
+    return this.full._ === "channelFull" && this.full.storiesPinnedAvailable;
+  }
+  /**
+   * Whether ads on this channels were disabled
+   * (this flag is only visible to channel owner)
+   */
+  get hasAdsDisabled() {
+    return this.full._ === "channelFull" && this.full.restrictedSponsored;
+  }
+  /** Whether sending paid media is available in this channel */
+  get isPaidMediaAvailable() {
+    return this.full._ === "channelFull" && this.full.paidMediaAllowed;
+  }
+  /**
+   * Full information about this chat's photo, if any.
+   *
+   * Unlike {@link Chat.photo}, this field contains additional information
+   * about the photo, such as its date, more sizes, and is the only
+   * way to get the animated profile photo.
+   *
+   * This field takes into account any personal/fallback photo
+   * that the user may have set
+   */
+  get fullPhoto() {
+    if (!this.full) return null;
+    const photo$1 = this.full.chatPhoto;
+    if (photo$1?._ !== "photo") return null;
+    return new photo.Photo(photo$1);
+  }
+  /**
+   * Bio of the other party in a private chat, or description of a
+   * group, supergroup or channel.
+   */
+  get bio() {
+    return this.full.about;
+  }
+  /**
+   * Chat's primary invite link, if available
+   */
+  get inviteLink() {
+    switch (this.full.exportedInvite?._) {
+      case "chatInvitePublicJoinRequests":
+        return null;
+      case "chatInviteExported":
+        return new chatInviteLink.ChatInviteLink(this.full.exportedInvite);
+    }
+    return null;
+  }
+  /**
+   * For supergroups, information about the group sticker set.
+   */
+  get stickerSet() {
+    if (this.full?._ !== "channelFull" || !this.full.stickerset) return null;
+    return new stickerSet.StickerSet(this.full.stickerset);
+  }
+  /**
+   * For supergroups, information about the group emoji set.
+   */
+  get emojiSet() {
+    if (this.full?._ !== "channelFull" || !this.full.emojiset) return null;
+    return new stickerSet.StickerSet(this.full.emojiset);
+  }
+  /**
+   * Whether the group sticker set can be changed by you.
+   */
+  get canSetStickerSet() {
+    return this.full && this.full._ === "channelFull" ? this.full.canSetStickers ?? null : null;
+  }
+  /**
+   * Number of boosts applied by the current user to this chat.
+   */
+  get boostsApplied() {
+    if (!this.full || this.full._ !== "channelFull") return 0;
+    return this.full?.boostsApplied ?? 0;
+  }
+  /**
+   * Number of boosts required for the user to be unrestricted in this chat.
+   */
+  get boostsForUnrestrict() {
+    if (!this.full || this.full._ !== "channelFull") return 0;
+    return this.full?.boostsUnrestrict ?? 0;
+  }
+  /** Whether the current user can view Telegram Stars revenue for this chat */
+  get canViewStarsRevenue() {
+    return this.full._ === "channelFull" && this.full.canViewStarsRevenue;
+  }
+  /** Whether the current user can view ad revenue for this chat */
+  get canViewAdRevenue() {
+    return this.full._ === "channelFull" && this.full.canViewRevenue;
+  }
+  /** Number of admins in the chat (0 if not available) */
+  get adminsCount() {
+    return this.full._ === "channelFull" ? this.full.adminsCount ?? 0 : 0;
+  }
+  /** Number of users kicked from the chat (if available) */
+  get kickedCount() {
+    return this.full._ === "channelFull" ? this.full.kickedCount ?? null : null;
+  }
+  /** Number of users kicked from the chat (if available) */
+  get bannedCount() {
+    return this.full._ === "channelFull" ? this.full.bannedCount ?? null : null;
+  }
+  /** Number of members of the chat that are currently online */
+  get onlineCount() {
+    return this.full._ === "channelFull" ? this.full.onlineCount ?? 0 : 0;
+  }
+  /** ID of the last read incoming message in the chat */
+  get readInboxMaxId() {
+    return this.full._ === "channelFull" ? this.full.readInboxMaxId : 0;
+  }
+  /** ID of the last read outgoing message in the chat */
+  get readOutboxMaxId() {
+    return this.full._ === "channelFull" ? this.full.readOutboxMaxId : 0;
+  }
+  /** Number of unread messages in the chat */
+  get unreadCount() {
+    return this.full._ === "channelFull" ? this.full.unreadCount : 0;
+  }
+  /** Notification settings for this chat */
+  get notificationsSettings() {
+    return this.full._ === "channelFull" ? this.full.notifySettings ?? null : null;
+  }
+  /** Information about bots in this chat */
+  get botInfo() {
+    return this.full._ === "channelFull" ? this.full.botInfo.map((it) => new botInfo.BotInfo(it)) : [];
+  }
+  /**
+   * For supergroups, ID of the basic group from which this supergroup was upgraded,
+   * and the identifier of the last message from the original group.
+   */
+  get migratedFrom() {
+    if (this.full._ !== "channelFull") return null;
+    if (!this.full.migratedFromChatId || !this.full.migratedFromMaxId) return null;
+    return {
+      chatId: this.full.migratedFromChatId.toNumber(),
+      msgId: this.full.migratedFromMaxId
+    };
+  }
+  /** For supergroups with hidden history, ID of the first message visible to the current user */
+  get historyMinId() {
+    return this.full._ === "channelFull" ? this.full.availableMinId ?? 0 : 0;
+  }
+  /** ID of the last pinned message in the chat */
+  get pinnedMsgId() {
+    return this.full._ === "channelFull" ? this.full.pinnedMsgId ?? null : null;
+  }
+  /**
+   * Location of the chat.
+   */
+  get location() {
+    if (!this.full || this.full._ !== "channelFull" || this.full.location?._ !== "channelLocation") {
+      return null;
+    }
+    return new chatLocation.ChatLocation(this.full.location);
+  }
+  /**
+   * Information about a linked chat:
+   * - for channels: the discussion group
+   * - for supergroups: the linked channel
+   */
+  get linkedChat() {
+    if (this.full._ !== "channelFull") return null;
+    if (!this.full.linkedChatId) return null;
+    return new chat.Chat(this.peers.chat(this.full.linkedChatId));
+  }
+  /**
+   * TTL of all messages in this chat, in seconds
+   */
+  get ttlPeriod() {
+    return this.full?.ttlPeriod ?? null;
+  }
+  /** Slowmode delay for this chat, if any */
+  get slowmodeSeconds() {
+    return this.full._ === "channelFull" ? this.full.slowmodeSeconds ?? null : null;
+  }
+  /**
+   * For supergroups with slow mode, date of the next time the current user
+   * will be able to send a message. `null` if they can send messages now.
+   */
+  get slowmodeNextSendDate() {
+    if (this.full._ !== "channelFull" || !this.full.slowmodeNextSendDate) return null;
+    return new Date(this.full.slowmodeNextSendDate * 1e3);
+  }
+  /** Number of pending join requests in the chat (only visible to admins) */
+  get pendingJoinRequests() {
+    return this.full._ === "channelFull" ? this.full.requestsPending ?? 0 : 0;
+  }
+  /** Users who have recently requested to join the chat (only visible to admins) */
+  get recentRequesters() {
+    if (this.full._ !== "channelFull" || !this.full.recentRequesters) return [];
+    return this.full.recentRequesters.map((it) => new user.User(this.peers.user(it.toNumber())));
+  }
+  /** Reactions available in this chat */
+  get availableReactions() {
+    return this.full._ === "channelFull" ? this.full.availableReactions ?? null : null;
+  }
+  /** Maximum number of unique reactions on a single message in this chat, if any */
+  get maxReactions() {
+    return this.full._ === "channelFull" ? this.full.reactionsLimit ?? null : null;
+  }
+  /** Channel stories */
+  get stories() {
+    if (this.full._ !== "channelFull" || !this.full.stories) return null;
+    return new peerStories.PeerStories(this.full.stories, this.peers);
+  }
+}
+const FullChat$1 = /* @__PURE__ */ memoize.memoizeGetters(FullChat, [
+  "fullPhoto",
+  "inviteLink",
+  "location",
+  "stickerSet",
+  "emojiSet",
+  "botInfo",
+  "linkedChat",
+  "recentRequesters",
+  "stories"
+]);
+const FullChat$2 = /* @__PURE__ */ inspectable.makeInspectable(FullChat$1);
+exports.FullChat = FullChat$2;

package/highlevel/types/peers/full-chat.d.ts

@@ -1,24 +1,58 @@
 import { tl } from '@mtcute/tl';
 import { Photo } from '../media/photo.js';
 import { StickerSet } from '../misc/sticker-set.js';
-import { BusinessAccount } from '../premium/business-account.js';
-import { Chat } from './chat.js';
+import { PeerStories } from '../stories/peer-stories.js';
+import { BotInfo } from './bot-info.js';
 import { ChatInviteLink } from './chat-invite-link.js';
 import { ChatLocation } from './chat-location.js';
+import { Chat } from './chat.js';
+import { PeersIndex } from './peers-index.js';
+import { User } from './user.js';
 /**
- * Complete information about a particular chat.
+ * Full information about a particular chat.
  */
 export declare class FullChat extends Chat {
-    readonly fullPeer: tl.TypeUserFull | tl.TypeChatFull;
-    constructor(peer: tl.TypeUser | tl.TypeChat, fullPeer: tl.TypeUserFull | tl.TypeChatFull);
-    /** @internal */
-    static _parse(full: tl.messages.RawChatFull | tl.users.TypeUserFull): FullChat;
-    /**
-     * Whether this chat (user) has restricted sending them voice/video messages.
-     */
-    get hasBlockedVoices(): boolean;
+    readonly peers: PeersIndex;
+    readonly full: tl.TypeChatFull;
+    constructor(obj: tl.messages.RawChatFull);
+    /** Whether this chat is archived */
+    get isArchived(): boolean;
     /** Whether paid reactions are enabled for this channel */
     get hasPaidReactions(): boolean;
+    /** Whether this channel has hidden participants */
+    get hasHiddenParticipants(): boolean;
+    /** Whether the current user can change the chat's username */
+    get canSetUsername(): boolean;
+    /** Whether the current user can change the chat's sticker set */
+    get canSetStickers(): boolean;
+    /** Whether the history before we joined the chat is hidden */
+    get hasHiddenHistory(): boolean;
+    /** Whether there are scheduled messages in this chat */
+    get hasScheduledMessages(): boolean;
+    /** Whether the current user can view the chat's statistics */
+    get canViewStats(): boolean;
+    /** Whether the current user can view the chat's participants list */
+    get canViewParticipants(): boolean;
+    /** Whether the current user can delete the chat */
+    get canDeleteChat(): boolean;
+    /**
+     * Whether the current user has blocked any anonumous admin of the supergroup.
+     * If set, you won't receive mentions from them, nor their replies in `@replies`
+     */
+    get isBlocked(): boolean;
+    /** Whether the native antispam is enabled for this channel */
+    get hasNativeAntispam(): boolean;
+    /** Whether the real-time translations popup should not be shown for this channel */
+    get hasTranslationsDisabled(): boolean;
+    /** Whether this chat has pinned stories */
+    get hasPinnedStories(): boolean;
+    /**
+     * Whether ads on this channels were disabled
+     * (this flag is only visible to channel owner)
+     */
+    get hasAdsDisabled(): boolean;
+    /** Whether sending paid media is available in this channel */
+    get isPaidMediaAvailable(): boolean;
     /**
      * Full information about this chat's photo, if any.
      *
@@ -30,32 +64,13 @@ export declare class FullChat extends Chat {
      * that the user may have set
      */
     get fullPhoto(): Photo | null;
-    /**
-     * A custom photo (set by the current user) that should be displayed
-     * instead of the actual chat photo.
-     *
-     * Currently only available for users.
-     */
-    get personalPhoto(): Photo | null;
-    /**
-     * Actual profile photo of the user, bypassing the custom one.
-     */
-    get realPhoto(): Photo | null;
-    /**
-     * A photo that the user has set to be shown
-     * in case their actual profile photo is not available
-     * due to privacy settings.
-     *
-     * Currently only available for users.
-     */
-    get publicPhoto(): Photo | null;
     /**
      * Bio of the other party in a private chat, or description of a
      * group, supergroup or channel.
      */
-    get bio(): string | null;
+    get bio(): string;
     /**
-     * Chat's primary invite link, for groups, supergroups and channels.
+     * Chat's primary invite link, if available
      */
     get inviteLink(): ChatInviteLink | null;
     /**
@@ -80,28 +95,67 @@ export declare class FullChat extends Chat {
     get boostsForUnrestrict(): number;
     /** Whether the current user can view Telegram Stars revenue for this chat */
     get canViewStarsRevenue(): boolean;
-    /**
-     * Chat members count, for groups, supergroups and channels only.
-     */
-    get membersCount(): number | null;
+    /** Whether the current user can view ad revenue for this chat */
+    get canViewAdRevenue(): boolean;
+    /** Number of admins in the chat (0 if not available) */
+    get adminsCount(): number;
+    /** Number of users kicked from the chat (if available) */
+    get kickedCount(): number | null;
+    /** Number of users kicked from the chat (if available) */
+    get bannedCount(): number | null;
+    /** Number of members of the chat that are currently online */
+    get onlineCount(): number;
+    /** ID of the last read incoming message in the chat */
+    get readInboxMaxId(): number;
+    /** ID of the last read outgoing message in the chat */
+    get readOutboxMaxId(): number;
+    /** Number of unread messages in the chat */
+    get unreadCount(): number;
+    /** Notification settings for this chat */
+    get notificationsSettings(): tl.TypePeerNotifySettings | null;
+    /** Information about bots in this chat */
+    get botInfo(): BotInfo[];
+    /**
+     * For supergroups, ID of the basic group from which this supergroup was upgraded,
+     * and the identifier of the last message from the original group.
+     */
+    get migratedFrom(): {
+        chatId: number;
+        msgId: number;
+    } | null;
+    /** For supergroups with hidden history, ID of the first message visible to the current user */
+    get historyMinId(): number;
+    /** ID of the last pinned message in the chat */
+    get pinnedMsgId(): number | null;
     /**
      * Location of the chat.
      */
     get location(): ChatLocation | null;
-    private _linkedChat?;
     /**
      * Information about a linked chat:
      * - for channels: the discussion group
      * - for supergroups: the linked channel
-     * - for users: the personal channel
      */
     get linkedChat(): Chat | null;
     /**
      * TTL of all messages in this chat, in seconds
      */
     get ttlPeriod(): number | null;
-    /**
-     * If this is a business account, information about the business.
-     */
-    get business(): BusinessAccount | null;
+    /** Slowmode delay for this chat, if any */
+    get slowmodeSeconds(): number | null;
+    /**
+     * For supergroups with slow mode, date of the next time the current user
+     * will be able to send a message. `null` if they can send messages now.
+     */
+    get slowmodeNextSendDate(): Date | null;
+    /** Number of pending join requests in the chat (only visible to admins) */
+    get pendingJoinRequests(): number;
+    /** Users who have recently requested to join the chat (only visible to admins) */
+    get recentRequesters(): User[];
+    /** Reactions available in this chat */
+    get availableReactions(): tl.TypeChatReactions | null;
+    /** Maximum number of unique reactions on a single message in this chat, if any */
+    get maxReactions(): number | null;
+    /** Channel stories */
+    get stories(): PeerStories | null;
 }