@mtcute/core 0.24.1 → 0.24.3

package/client.cjs

@@ -57,6 +57,7 @@ const getChatPreview = require("./highlevel/methods/chats/get-chat-preview.cjs")
 const getChat = require("./highlevel/methods/chats/get-chat.cjs");
 const getFullChat = require("./highlevel/methods/chats/get-full-chat.cjs");
 const getFullUser = require("./highlevel/methods/chats/get-full-user.cjs");
+const getMessageAuthor = require("./highlevel/methods/chats/get-message-author.cjs");
 const getNearbyChats = require("./highlevel/methods/chats/get-nearby-chats.cjs");
 const getPeer = require("./highlevel/methods/chats/get-peer.cjs");
 const getSimilarChannels = require("./highlevel/methods/chats/get-similar-channels.cjs");
@@ -593,6 +594,9 @@ TelegramClient.prototype.getFullChat = function(...args) {
 TelegramClient.prototype.getFullUser = function(...args) {
   return getFullUser.getFullUser(this._client, ...args);
 };
+TelegramClient.prototype.getMessageAuthor = function(...args) {
+  return getMessageAuthor.getMessageAuthor(this._client, ...args);
+};
 TelegramClient.prototype.getNearbyChats = function(...args) {
   return getNearbyChats.getNearbyChats(this._client, ...args);
 };
@@ -779,6 +783,9 @@ TelegramClient.prototype.toggleForumTopicPinned = function(...args) {
 TelegramClient.prototype.toggleForum = function(...args) {
   return toggleForum.toggleForum(this._client, ...args);
 };
+TelegramClient.prototype.updateForumSettings = function(...args) {
+  return toggleForum.updateForumSettings(this._client, ...args);
+};
 TelegramClient.prototype.toggleGeneralTopicHidden = function(...args) {
   return toggleGeneralTopicHidden.toggleGeneralTopicHidden(this._client, ...args);
 };

package/client.js

@@ -50,6 +50,7 @@ import { getChatPreview } from "./highlevel/methods/chats/get-chat-preview.js";
 import { getChat } from "./highlevel/methods/chats/get-chat.js";
 import { getFullChat } from "./highlevel/methods/chats/get-full-chat.js";
 import { getFullUser } from "./highlevel/methods/chats/get-full-user.js";
+import { getMessageAuthor } from "./highlevel/methods/chats/get-message-author.js";
 import { getNearbyChats } from "./highlevel/methods/chats/get-nearby-chats.js";
 import { getPeer } from "./highlevel/methods/chats/get-peer.js";
 import { getSimilarChannels } from "./highlevel/methods/chats/get-similar-channels.js";
@@ -109,7 +110,7 @@ import { iterForumTopics } from "./highlevel/methods/forums/iter-forum-topics.js
 import { reorderPinnedForumTopics } from "./highlevel/methods/forums/reorder-pinned-forum-topics.js";
 import { toggleForumTopicClosed } from "./highlevel/methods/forums/toggle-forum-topic-closed.js";
 import { toggleForumTopicPinned } from "./highlevel/methods/forums/toggle-forum-topic-pinned.js";
-import { toggleForum } from "./highlevel/methods/forums/toggle-forum.js";
+import { toggleForum, updateForumSettings } from "./highlevel/methods/forums/toggle-forum.js";
 import { toggleGeneralTopicHidden } from "./highlevel/methods/forums/toggle-general-topic-hidden.js";
 import { createInviteLink } from "./highlevel/methods/invite-links/create-invite-link.js";
 import { editInviteLink } from "./highlevel/methods/invite-links/edit-invite-link.js";
@@ -586,6 +587,9 @@ TelegramClient.prototype.getFullChat = function(...args) {
 TelegramClient.prototype.getFullUser = function(...args) {
   return getFullUser(this._client, ...args);
 };
+TelegramClient.prototype.getMessageAuthor = function(...args) {
+  return getMessageAuthor(this._client, ...args);
+};
 TelegramClient.prototype.getNearbyChats = function(...args) {
   return getNearbyChats(this._client, ...args);
 };
@@ -772,6 +776,9 @@ TelegramClient.prototype.toggleForumTopicPinned = function(...args) {
 TelegramClient.prototype.toggleForum = function(...args) {
   return toggleForum(this._client, ...args);
 };
+TelegramClient.prototype.updateForumSettings = function(...args) {
+  return updateForumSettings(this._client, ...args);
+};
 TelegramClient.prototype.toggleGeneralTopicHidden = function(...args) {
   return toggleGeneralTopicHidden(this._client, ...args);
 };

package/highlevel/client.d.cts

@@ -1290,6 +1290,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param userId  ID of the user or their username
      */
     getFullUser(userId: InputPeerLike): Promise<FullUser>;
+    getMessageAuthor(message: InputMessageId): Promise<User>;
     /**
      * Get nearby chats
      *
@@ -2335,8 +2336,24 @@ export interface TelegramClient extends ITelegramClient {
      *
      * @param chatId  Chat ID or username
      * @param [enabled=false]  Whether the supergroup should be a forum
+     * @deprecated Use {@link updateForumSettings} instead
      */
     toggleForum(chatId: InputPeerLike, enabled?: boolean): Promise<void>;
+    /**
+     * Update forum settings of a supergroup.
+     *
+     * Only owner of the supergroup can change this setting.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID or username
+     * @param settings  New settings. `null` is a shorthand for `{ isForum: false }`
+     */
+    updateForumSettings(chatId: InputPeerLike, settings: null | {
+        /** Whether the supergroup should be a forum */
+        isForum: boolean;
+        threadsMode: 'list' | 'tabs';
+    }): Promise<void>;
     /**
      * Toggle whether "General" topic in a forum is hidden or not
      *

package/highlevel/client.d.ts

@@ -1290,6 +1290,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param userId  ID of the user or their username
      */
     getFullUser(userId: InputPeerLike): Promise<FullUser>;
+    getMessageAuthor(message: InputMessageId): Promise<User>;
     /**
      * Get nearby chats
      *
@@ -2335,8 +2336,24 @@ export interface TelegramClient extends ITelegramClient {
      *
      * @param chatId  Chat ID or username
      * @param [enabled=false]  Whether the supergroup should be a forum
+     * @deprecated Use {@link updateForumSettings} instead
      */
     toggleForum(chatId: InputPeerLike, enabled?: boolean): Promise<void>;
+    /**
+     * Update forum settings of a supergroup.
+     *
+     * Only owner of the supergroup can change this setting.
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID or username
+     * @param settings  New settings. `null` is a shorthand for `{ isForum: false }`
+     */
+    updateForumSettings(chatId: InputPeerLike, settings: null | {
+        /** Whether the supergroup should be a forum */
+        isForum: boolean;
+        threadsMode: 'list' | 'tabs';
+    }): Promise<void>;
     /**
      * Toggle whether "General" topic in a forum is hidden or not
      *

package/highlevel/methods/chats/get-message-author.cjs

@@ -0,0 +1,20 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS support is deprecated and will be removed in 0.25.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[@mtcute/core] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const resolvePeer = require("../users/resolve-peer.cjs");
+const inputMessageId = require("../../types/messages/input-message-id.cjs");
+const user = require("../../types/peers/user.cjs");
+async function getMessageAuthor(client, message) {
+  const { chatId, message: msgId } = inputMessageId.normalizeInputMessageId(message);
+  const res = await client.call({
+    _: "channels.getMessageAuthor",
+    channel: await resolvePeer.resolveChannel(client, chatId),
+    id: msgId
+  });
+  return new user.User(res);
+}
+exports.getMessageAuthor = getMessageAuthor;

package/highlevel/methods/chats/get-message-author.d.cts

@@ -0,0 +1,3 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, User } from '../../types/index.js';
+export declare function getMessageAuthor(client: ITelegramClient, message: InputMessageId): Promise<User>;

package/highlevel/methods/chats/get-message-author.d.ts

@@ -0,0 +1,3 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputMessageId, User } from '../../types/index.js';
+export declare function getMessageAuthor(client: ITelegramClient, message: InputMessageId): Promise<User>;

package/highlevel/methods/chats/get-message-author.js

@@ -0,0 +1,15 @@
+import { resolveChannel } from "../users/resolve-peer.js";
+import { normalizeInputMessageId } from "../../types/messages/input-message-id.js";
+import { User as User$2 } from "../../types/peers/user.js";
+async function getMessageAuthor(client, message) {
+  const { chatId, message: msgId } = normalizeInputMessageId(message);
+  const res = await client.call({
+    _: "channels.getMessageAuthor",
+    channel: await resolveChannel(client, chatId),
+    id: msgId
+  });
+  return new User$2(res);
+}
+export {
+  getMessageAuthor
+};

package/highlevel/methods/forums/toggle-forum.cjs

@@ -10,8 +10,19 @@ async function toggleForum(client, chatId, enabled = false) {
   const res = await client.call({
     _: "channels.toggleForum",
     channel: await resolvePeer.resolveChannel(client, chatId),
-    enabled
+    enabled,
+    tabs: false
+  });
+  client.handleClientUpdate(res);
+}
+async function updateForumSettings(client, chatId, settings) {
+  const res = await client.call({
+    _: "channels.toggleForum",
+    channel: await resolvePeer.resolveChannel(client, chatId),
+    enabled: settings?.isForum ?? false,
+    tabs: settings?.threadsMode === "tabs"
   });
   client.handleClientUpdate(res);
 }
 exports.toggleForum = toggleForum;
+exports.updateForumSettings = updateForumSettings;

package/highlevel/methods/forums/toggle-forum.d.cts

@@ -7,5 +7,19 @@ import { InputPeerLike } from '../../types/index.js';
  *
  * @param chatId  Chat ID or username
  * @param enabled  Whether the supergroup should be a forum
+ * @deprecated Use {@link updateForumSettings} instead
  */
 export declare function toggleForum(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;
+/**
+ * Update forum settings of a supergroup.
+ *
+ * Only owner of the supergroup can change this setting.
+ *
+ * @param chatId  Chat ID or username
+ * @param settings  New settings. `null` is a shorthand for `{ isForum: false }`
+ */
+export declare function updateForumSettings(client: ITelegramClient, chatId: InputPeerLike, settings: null | {
+    /** Whether the supergroup should be a forum */
+    isForum: boolean;
+    threadsMode: 'list' | 'tabs';
+}): Promise<void>;

package/highlevel/methods/forums/toggle-forum.d.ts

@@ -7,5 +7,19 @@ import { InputPeerLike } from '../../types/index.js';
  *
  * @param chatId  Chat ID or username
  * @param enabled  Whether the supergroup should be a forum
+ * @deprecated Use {@link updateForumSettings} instead
  */
 export declare function toggleForum(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;
+/**
+ * Update forum settings of a supergroup.
+ *
+ * Only owner of the supergroup can change this setting.
+ *
+ * @param chatId  Chat ID or username
+ * @param settings  New settings. `null` is a shorthand for `{ isForum: false }`
+ */
+export declare function updateForumSettings(client: ITelegramClient, chatId: InputPeerLike, settings: null | {
+    /** Whether the supergroup should be a forum */
+    isForum: boolean;
+    threadsMode: 'list' | 'tabs';
+}): Promise<void>;

package/highlevel/methods/forums/toggle-forum.js

@@ -3,10 +3,21 @@ async function toggleForum(client, chatId, enabled = false) {
   const res = await client.call({
     _: "channels.toggleForum",
     channel: await resolveChannel(client, chatId),
-    enabled
+    enabled,
+    tabs: false
+  });
+  client.handleClientUpdate(res);
+}
+async function updateForumSettings(client, chatId, settings) {
+  const res = await client.call({
+    _: "channels.toggleForum",
+    channel: await resolveChannel(client, chatId),
+    enabled: settings?.isForum ?? false,
+    tabs: settings?.threadsMode === "tabs"
   });
   client.handleClientUpdate(res);
 }
 export {
-  toggleForum
+  toggleForum,
+  updateForumSettings
 };

package/highlevel/methods/messages/forward-messages.cjs

@@ -26,7 +26,9 @@ async function forwardMessagesById(client, params) {
     noAuthor,
     noCaption,
     allowPaidFloodskip,
-    videoTimestamp
+    videoTimestamp,
+    toThreadId,
+    toMonoforumPeer
   } = params;
   if (messages.length > 100) {
     throw new errors.MtArgumentError("You can forward no more than 100 messages at once");
@@ -48,7 +50,12 @@ async function forwardMessagesById(client, params) {
     quickReplyShortcut: sendCommon._normalizeQuickReplyShortcut(params.quickReply),
     allowPaidFloodskip,
     videoTimestamp,
-    allowPaidStars: params.allowPaidMessages
+    allowPaidStars: params.allowPaidMessages,
+    topMsgId: toThreadId,
+    replyTo: toMonoforumPeer ? {
+      _: "inputReplyToMonoForum",
+      monoforumPeerId: await resolvePeer.resolvePeer(client, toMonoforumPeer)
+    } : void 0
   });
   utils.assertIsUpdatesGroup("messages.forwardMessages", res);
   client.handleClientUpdate(res, !params.shouldDispatch);

package/highlevel/methods/messages/forward-messages.d.cts

@@ -4,6 +4,13 @@ import { InputPeerLike, Message } from '../../types/index.js';
 export interface ForwardMessageOptions {
     /** Destination chat ID, username, phone, `"me"` or `"self"` */
     toChatId: InputPeerLike;
+    /** When forwarding to forums, ID of the thread to forward to */
+    toThreadId?: number;
+    /**
+     * When forwarding to a monoforum you are an admin of,
+     * you **must** pass an ID of a peer you are sending the message to.
+     */
+    toMonoforumPeer?: InputPeerLike;
     /**
      * Whether to forward silently (also applies to caption message).
      */

package/highlevel/methods/messages/forward-messages.d.ts

@@ -4,6 +4,13 @@ import { InputPeerLike, Message } from '../../types/index.js';
 export interface ForwardMessageOptions {
     /** Destination chat ID, username, phone, `"me"` or `"self"` */
     toChatId: InputPeerLike;
+    /** When forwarding to forums, ID of the thread to forward to */
+    toThreadId?: number;
+    /**
+     * When forwarding to a monoforum you are an admin of,
+     * you **must** pass an ID of a peer you are sending the message to.
+     */
+    toMonoforumPeer?: InputPeerLike;
     /**
      * Whether to forward silently (also applies to caption message).
      */

package/highlevel/methods/messages/forward-messages.js

@@ -19,7 +19,9 @@ async function forwardMessagesById(client, params) {
     noAuthor,
     noCaption,
     allowPaidFloodskip,
-    videoTimestamp
+    videoTimestamp,
+    toThreadId,
+    toMonoforumPeer
   } = params;
   if (messages.length > 100) {
     throw new MtArgumentError("You can forward no more than 100 messages at once");
@@ -41,7 +43,12 @@ async function forwardMessagesById(client, params) {
     quickReplyShortcut: _normalizeQuickReplyShortcut(params.quickReply),
     allowPaidFloodskip,
     videoTimestamp,
-    allowPaidStars: params.allowPaidMessages
+    allowPaidStars: params.allowPaidMessages,
+    topMsgId: toThreadId,
+    replyTo: toMonoforumPeer ? {
+      _: "inputReplyToMonoForum",
+      monoforumPeerId: await resolvePeer(client, toMonoforumPeer)
+    } : void 0
   });
   assertIsUpdatesGroup("messages.forwardMessages", res);
   client.handleClientUpdate(res, !params.shouldDispatch);

package/highlevel/methods/messages/send-common.cjs

@@ -55,7 +55,13 @@ async function _processCommonSendParameters(client, chatId, params) {
       replyToPeerId: replyToPeer,
       quoteText: params.quote?.text,
       quoteEntities: params.quote?.entities,
-      quoteOffset: params.quoteOffset
+      quoteOffset: params.quoteOffset,
+      monoforumPeerId: params.toMonoforumPeer ? await resolvePeer.resolvePeer(client, params.toMonoforumPeer) : void 0
+    };
+  } else if (params.toMonoforumPeer) {
+    tlReplyTo = {
+      _: "inputReplyToMonoForum",
+      monoforumPeerId: await resolvePeer.resolvePeer(client, params.toMonoforumPeer)
     };
   } else if (params.replyToStory) {
     tlReplyTo = {

package/highlevel/methods/messages/send-common.d.cts

@@ -12,6 +12,13 @@ export interface CommonSendParams {
      * Can also be a message from another chat, in which case a quote will be sent.
      */
     replyTo?: number | Message;
+    /**
+     * When the chat is a monoforum you are an admin of, you **must** pass an
+     * ID of a peer you are sending the message to.
+     *
+     * Otherwise, you will get a `REPLY_TO_MONOFORUM_PEER_INVALID` error.
+     */
+    toMonoforumPeer?: InputPeerLike;
     /**
      * Whether to throw an error if {@link replyTo}
      * message does not exist.

package/highlevel/methods/messages/send-common.d.ts

@@ -12,6 +12,13 @@ export interface CommonSendParams {
      * Can also be a message from another chat, in which case a quote will be sent.
      */
     replyTo?: number | Message;
+    /**
+     * When the chat is a monoforum you are an admin of, you **must** pass an
+     * ID of a peer you are sending the message to.
+     *
+     * Otherwise, you will get a `REPLY_TO_MONOFORUM_PEER_INVALID` error.
+     */
+    toMonoforumPeer?: InputPeerLike;
     /**
      * Whether to throw an error if {@link replyTo}
      * message does not exist.

package/highlevel/methods/messages/send-common.js

@@ -48,7 +48,13 @@ async function _processCommonSendParameters(client, chatId, params) {
       replyToPeerId: replyToPeer,
       quoteText: params.quote?.text,
       quoteEntities: params.quote?.entities,
-      quoteOffset: params.quoteOffset
+      quoteOffset: params.quoteOffset,
+      monoforumPeerId: params.toMonoforumPeer ? await resolvePeer(client, params.toMonoforumPeer) : void 0
+    };
+  } else if (params.toMonoforumPeer) {
+    tlReplyTo = {
+      _: "inputReplyToMonoForum",
+      monoforumPeerId: await resolvePeer(client, params.toMonoforumPeer)
     };
   } else if (params.replyToStory) {
     tlReplyTo = {

package/highlevel/methods.d.cts

@@ -53,6 +53,7 @@ export { getChatPreview } from './methods/chats/get-chat-preview.js';
 export { getChat } from './methods/chats/get-chat.js';
 export { getFullChat } from './methods/chats/get-full-chat.js';
 export { getFullUser } from './methods/chats/get-full-user.js';
+export { getMessageAuthor } from './methods/chats/get-message-author.js';
 export { getNearbyChats } from './methods/chats/get-nearby-chats.js';
 export { getPeer } from './methods/chats/get-peer.js';
 export { getSimilarChannels } from './methods/chats/get-similar-channels.js';
@@ -115,6 +116,7 @@ export { reorderPinnedForumTopics } from './methods/forums/reorder-pinned-forum-
 export { toggleForumTopicClosed } from './methods/forums/toggle-forum-topic-closed.js';
 export { toggleForumTopicPinned } from './methods/forums/toggle-forum-topic-pinned.js';
 export { toggleForum } from './methods/forums/toggle-forum.js';
+export { updateForumSettings } from './methods/forums/toggle-forum.js';
 export { toggleGeneralTopicHidden } from './methods/forums/toggle-general-topic-hidden.js';
 export { createInviteLink } from './methods/invite-links/create-invite-link.js';
 export { editInviteLink } from './methods/invite-links/edit-invite-link.js';

package/highlevel/methods.d.ts

@@ -53,6 +53,7 @@ export { getChatPreview } from './methods/chats/get-chat-preview.js';
 export { getChat } from './methods/chats/get-chat.js';
 export { getFullChat } from './methods/chats/get-full-chat.js';
 export { getFullUser } from './methods/chats/get-full-user.js';
+export { getMessageAuthor } from './methods/chats/get-message-author.js';
 export { getNearbyChats } from './methods/chats/get-nearby-chats.js';
 export { getPeer } from './methods/chats/get-peer.js';
 export { getSimilarChannels } from './methods/chats/get-similar-channels.js';
@@ -115,6 +116,7 @@ export { reorderPinnedForumTopics } from './methods/forums/reorder-pinned-forum-
 export { toggleForumTopicClosed } from './methods/forums/toggle-forum-topic-closed.js';
 export { toggleForumTopicPinned } from './methods/forums/toggle-forum-topic-pinned.js';
 export { toggleForum } from './methods/forums/toggle-forum.js';
+export { updateForumSettings } from './methods/forums/toggle-forum.js';
 export { toggleGeneralTopicHidden } from './methods/forums/toggle-general-topic-hidden.js';
 export { createInviteLink } from './methods/invite-links/create-invite-link.js';
 export { editInviteLink } from './methods/invite-links/edit-invite-link.js';

package/highlevel/types/media/input-media/factories.cjs

@@ -70,6 +70,7 @@ function geoLive(latitude, longitude, params = {}) {
 function dice(emoji, params) {
   const ret = params;
   ret.type = "dice";
+  ret.emoji = emoji;
   return ret;
 }
 function contact(params) {

package/highlevel/types/media/input-media/factories.js

@@ -63,6 +63,7 @@ function geoLive(latitude, longitude, params = {}) {
 function dice(emoji, params) {
   const ret = params;
   ret.type = "dice";
+  ret.emoji = emoji;
   return ret;
 }
 function contact(params) {

package/highlevel/types/messages/message-action.d.cts

@@ -441,6 +441,8 @@ export interface ActionPaidMessagesPaid {
     readonly type: 'messages_paid';
     /** Amount of Telegram Stars paid */
     stars: tl.Long;
+    /** Whether the stars were paid for a direct message to channel administrators */
+    broadcastDirect?: boolean;
 }
 /** Paid messages were refunded */
 export interface ActionPaidMessagesRefunded {

package/highlevel/types/messages/message-action.d.ts

@@ -441,6 +441,8 @@ export interface ActionPaidMessagesPaid {
     readonly type: 'messages_paid';
     /** Amount of Telegram Stars paid */
     stars: tl.Long;
+    /** Whether the stars were paid for a direct message to channel administrators */
+    broadcastDirect?: boolean;
 }
 /** Paid messages were refunded */
 export interface ActionPaidMessagesRefunded {

package/highlevel/types/peers/chat.cjs

@@ -108,6 +108,8 @@ class Chat {
       case "channelForbidden":
         if (this.raw._ === "channel" && this.raw.gigagroup) {
           return "gigagroup";
+        } else if (this.raw._ === "channel" && this.raw.monoforum) {
+          return "monoforum";
         } else if (this.raw.broadcast) {
           return "channel";
         } else if (this.raw.megagroup) {
@@ -242,6 +244,23 @@ class Chat {
   get hasAutoTranslation() {
     return this.raw._ === "channel" && this.raw.autotranslation;
   }
+  /** Whether this forum should display threads as tabs instead of a list */
+  get hasForumTabs() {
+    return this.raw._ === "channel" && this.raw.forumTabs;
+  }
+  /** Whether this broadcast channel has direct messages to channel administrators enabled */
+  get hasBroadcastDirect() {
+    return this.raw._ === "channel" && this.raw.broadcastMessagesAllowed;
+  }
+  /**
+   * Depending on {@link chatType}:
+   *   - `channel`: this field might contain the ID of the linked monoforum,
+   *     if this broadcast channel has a linked monoforum
+   *   - `monoforum`: this field contains the ID of the channel that this monoforum is linked to
+   */
+  get monoforumLinkedChatId() {
+    return this.raw._ === "channel" ? this.raw.linkedMonoforumId ?? null : null;
+  }
   /** Chat title */
   get title() {
     return this.raw.title;

package/highlevel/types/peers/chat.d.cts

@@ -10,8 +10,9 @@ import { ChatPhoto } from './chat-photo.js';
  *  - `supergroup`: Supergroup
  *  - `channel`: Broadcast channel
  *  - `gigagroup`: Gigagroup aka Broadcast group
+ *  - `monoforum`: Monoforum (chat for direct messages to channel administrators)
  */
-export type ChatType = 'group' | 'supergroup' | 'channel' | 'gigagroup';
+export type ChatType = 'group' | 'supergroup' | 'channel' | 'gigagroup' | 'monoforum';
 /**
  * A chat.
  */
@@ -131,6 +132,17 @@ export declare class Chat {
     get hasSignatures(): boolean;
     /** Whether this chat/channel has auto-translation enabled */
     get hasAutoTranslation(): boolean;
+    /** Whether this forum should display threads as tabs instead of a list */
+    get hasForumTabs(): boolean;
+    /** Whether this broadcast channel has direct messages to channel administrators enabled */
+    get hasBroadcastDirect(): boolean;
+    /**
+     * Depending on {@link chatType}:
+     *   - `channel`: this field might contain the ID of the linked monoforum,
+     *     if this broadcast channel has a linked monoforum
+     *   - `monoforum`: this field contains the ID of the channel that this monoforum is linked to
+     */
+    get monoforumLinkedChatId(): number | null;
     /** Chat title */
     get title(): string;
     /** Chat username (if available) */

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

@@ -10,8 +10,9 @@ import { ChatPhoto } from './chat-photo.js';
  *  - `supergroup`: Supergroup
  *  - `channel`: Broadcast channel
  *  - `gigagroup`: Gigagroup aka Broadcast group
+ *  - `monoforum`: Monoforum (chat for direct messages to channel administrators)
  */
-export type ChatType = 'group' | 'supergroup' | 'channel' | 'gigagroup';
+export type ChatType = 'group' | 'supergroup' | 'channel' | 'gigagroup' | 'monoforum';
 /**
  * A chat.
  */
@@ -131,6 +132,17 @@ export declare class Chat {
     get hasSignatures(): boolean;
     /** Whether this chat/channel has auto-translation enabled */
     get hasAutoTranslation(): boolean;
+    /** Whether this forum should display threads as tabs instead of a list */
+    get hasForumTabs(): boolean;
+    /** Whether this broadcast channel has direct messages to channel administrators enabled */
+    get hasBroadcastDirect(): boolean;
+    /**
+     * Depending on {@link chatType}:
+     *   - `channel`: this field might contain the ID of the linked monoforum,
+     *     if this broadcast channel has a linked monoforum
+     *   - `monoforum`: this field contains the ID of the channel that this monoforum is linked to
+     */
+    get monoforumLinkedChatId(): number | null;
     /** Chat title */
     get title(): string;
     /** Chat username (if available) */

package/highlevel/types/peers/chat.js

@@ -101,6 +101,8 @@ class Chat {
       case "channelForbidden":
         if (this.raw._ === "channel" && this.raw.gigagroup) {
           return "gigagroup";
+        } else if (this.raw._ === "channel" && this.raw.monoforum) {
+          return "monoforum";
         } else if (this.raw.broadcast) {
           return "channel";
         } else if (this.raw.megagroup) {
@@ -235,6 +237,23 @@ class Chat {
   get hasAutoTranslation() {
     return this.raw._ === "channel" && this.raw.autotranslation;
   }
+  /** Whether this forum should display threads as tabs instead of a list */
+  get hasForumTabs() {
+    return this.raw._ === "channel" && this.raw.forumTabs;
+  }
+  /** Whether this broadcast channel has direct messages to channel administrators enabled */
+  get hasBroadcastDirect() {
+    return this.raw._ === "channel" && this.raw.broadcastMessagesAllowed;
+  }
+  /**
+   * Depending on {@link chatType}:
+   *   - `channel`: this field might contain the ID of the linked monoforum,
+   *     if this broadcast channel has a linked monoforum
+   *   - `monoforum`: this field contains the ID of the channel that this monoforum is linked to
+   */
+  get monoforumLinkedChatId() {
+    return this.raw._ === "channel" ? this.raw.linkedMonoforumId ?? null : null;
+  }
   /** Chat title */
   get title() {
     return this.raw.title;

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

@@ -253,6 +253,16 @@ class FullChat extends chat.Chat {
     if (!this.full.linkedChatId) return null;
     return new chat.Chat(this.peers.chat(this.full.linkedChatId));
   }
+  /**
+   * Information about a linked monoforum chat:
+   * - for channels: the linked monoforum
+   * - for monoforums: the channel this monoforum is linked to
+   */
+  get monoforumLinkedChat() {
+    if (this.raw._ !== "channel") return null;
+    if (!this.raw.linkedMonoforumId) return null;
+    return new chat.Chat(this.peers.chat(this.raw.linkedMonoforumId));
+  }
   /**
    * TTL of all messages in this chat, in seconds
    */

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

@@ -138,6 +138,12 @@ export declare class FullChat extends Chat {
      * - for supergroups: the linked channel
      */
     get linkedChat(): Chat | null;
+    /**
+     * Information about a linked monoforum chat:
+     * - for channels: the linked monoforum
+     * - for monoforums: the channel this monoforum is linked to
+     */
+    get monoforumLinkedChat(): Chat | null;
     /**
      * TTL of all messages in this chat, in seconds
      */