@mtcute/core 0.31.0 → 0.32.0

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

@@ -5,6 +5,7 @@ import { PeersIndex } from '../peers/peers-index.js';
 import { MessageMedia } from './message-media.js';
 import { User } from '../peers/user.js';
 import { MessageEntity } from './message-entity.js';
+import { RichMessage } from './rich/rich-message.js';
 /**
  * An ephemeral message — a message sent by a bot that is only visible
  * to a single user in a chat and is not persisted in the chat history.
@@ -19,8 +20,21 @@ export declare class EphemeralMessage {
     get isOutgoing(): boolean;
     /** Sender of this message (usually the bot) */
     get sender(): Peer;
-    /** Chat where this message was sent */
-    get chat(): Peer;
+    /**
+     * Chat where this message was sent.
+     *
+     * `null` if not available (e.g. welcome message templates)
+     */
+    get chat(): Peer | null;
+    /** Whether this message is a welcome message template */
+    get isWelcomeTemplate(): boolean;
+    /**
+     * If set, any eventual webpage preview should be shown on top of
+     * the message instead of at the bottom.
+     */
+    get invertMedia(): boolean;
+    /** Whether this message can't be forwarded */
+    get isContentProtected(): boolean;
     /** ID of the user this message is visible to */
     get receiverId(): number;
     /**
@@ -52,4 +66,10 @@ export declare class EphemeralMessage {
     get replyMarkup(): tl.TypeReplyMarkup | null;
     /** Information about the message this message is a reply to, if any */
     get replyTo(): tl.TypeMessageReplyHeader | null;
+    /** Rich message content, if any */
+    get richMessage(): RichMessage | null;
+    /** Identifier uniquely corresponding to the chat this message was sent to, if any */
+    get chatInstance(): tl.Long | null;
+    /** ID of the message this message is anchored to, if any */
+    get anchorMessageId(): number | null;
 }

package/highlevel/types/messages/ephemeral-message.js

@@ -3,6 +3,7 @@ import { parsePeer } from "../peers/peer.js";
 import { User as User$2 } from "../peers/user.js";
 import { MessageEntity as MessageEntity$2 } from "./message-entity.js";
 import { _messageMediaFromTl } from "./message-media.js";
+import { RichMessage as RichMessage$2 } from "./rich/rich-message.js";
 import { makeInspectable } from "../../utils/inspectable.js";
 class EphemeralMessage {
   constructor(raw, _peers) {
@@ -21,9 +22,28 @@ class EphemeralMessage {
   get sender() {
     return parsePeer(this.raw.fromId, this._peers);
   }
-  /** Chat where this message was sent */
+  /**
+   * Chat where this message was sent.
+   *
+   * `null` if not available (e.g. welcome message templates)
+   */
   get chat() {
-    return parsePeer(this.raw.peerId, this._peers);
+    return this.raw.peerId ? parsePeer(this.raw.peerId, this._peers) : null;
+  }
+  /** Whether this message is a welcome message template */
+  get isWelcomeTemplate() {
+    return this.raw.welcomeTemplate;
+  }
+  /**
+   * If set, any eventual webpage preview should be shown on top of
+   * the message instead of at the bottom.
+   */
+  get invertMedia() {
+    return this.raw.invertMedia;
+  }
+  /** Whether this message can't be forwarded */
+  get isContentProtected() {
+    return this.raw.noforwards;
   }
   /** ID of the user this message is visible to */
   get receiverId() {
@@ -90,8 +110,20 @@ class EphemeralMessage {
   get replyTo() {
     return this.raw.replyTo ?? null;
   }
+  /** Rich message content, if any */
+  get richMessage() {
+    return this.raw.richMessage ? new RichMessage$2(this.raw.richMessage) : null;
+  }
+  /** Identifier uniquely corresponding to the chat this message was sent to, if any */
+  get chatInstance() {
+    return this.raw.chatInstance ?? null;
+  }
+  /** ID of the message this message is anchored to, if any */
+  get anchorMessageId() {
+    return this.raw.anchorMsgId ?? null;
+  }
 }
-const EphemeralMessage$1 = /* @__PURE__ */ memoizeGetters(EphemeralMessage, ["sender", "chat", "receiver", "entities", "media"]);
+const EphemeralMessage$1 = /* @__PURE__ */ memoizeGetters(EphemeralMessage, ["sender", "chat", "receiver", "entities", "media", "richMessage"]);
 const EphemeralMessage$2 = /* @__PURE__ */ makeInspectable(EphemeralMessage$1);
 export {
   EphemeralMessage$2 as EphemeralMessage

package/highlevel/types/messages/message-action.cjs

@@ -205,6 +205,11 @@ function _messageActionFromTl(act) {
       return {
         type: "user_joined_approved"
       };
+    case "messageActionChatJoinedViaCommunity":
+      return {
+        type: "user_joined_community",
+        community: new chat.Chat(this._peers.chat(act.communityId))
+      };
     case "messageActionWebViewDataSent":
       return {
         type: "webview_sent",
@@ -341,7 +346,9 @@ function _messageActionFromTl(act) {
         canExportAt: act.canExportAt ? new Date(act.canExportAt * 1e3) : void 0,
         canCraftAt: act.canCraftAt ? new Date(act.canCraftAt * 1e3) : void 0,
         savedId: act.savedId,
-        dropDetailsStars: act.dropOriginalDetailsStars
+        dropDetailsStars: act.dropOriginalDetailsStars,
+        nameHidden: act.nameHidden,
+        message: act.message
       };
       if (act.assigned) {
         return {

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

@@ -104,6 +104,12 @@ export interface ActionUserJoinedLink {
 export interface ActionUserJoinedApproved {
     readonly type: 'user_joined_approved';
 }
+/** User has joined the group because they are a member of a community */
+export interface ActionUserJoinedViaCommunity {
+    readonly type: 'user_joined_community';
+    /** Community the user has joined via */
+    readonly community: Chat;
+}
 /** A payment was received from a user (bot) */
 export interface ActionPaymentReceived {
     readonly type: 'payment_received';
@@ -477,6 +483,10 @@ interface StarGiftUniqueCommon {
     dropDetailsStars?: tl.Long;
     /** ID of the related saved profile gift */
     savedId?: tl.Long;
+    /** Whether the name of the sender/buyer is hidden */
+    nameHidden: boolean;
+    /** Message attached to the gift, if any */
+    message?: TextWithEntities;
 }
 /** A star gift was upgraded to a unique one */
 export interface ActionStarGiftUpgraded extends StarGiftUniqueCommon {
@@ -628,7 +638,7 @@ export interface ActionChangeCreator {
     /** New creator */
     newCreator: User;
 }
-export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionThemeChangedUnique | ActionUserJoinedApproved | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGiftSent | ActionStarGiftUpgradePaid | ActionStarGiftUpgraded | ActionStarGiftBoughtResale | ActionStarGiftTransferred | ActionStarGiftAssigned | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | ActionSuggestBirthday | ActionStarGiftPurchaseOffer | ActionStarGiftPurchaseOfferDeclined | ActionStarGiftBoughtOffer | ActionStarGiftCrafted | ActionNewCreatorPending | ActionChangeCreator | ActionNoForwardsToggle | ActionNoForwardsRequest | ActionPollAppendAnswer | ActionPollDeleteAnswer | ActionManagedBotCreated | ActionChangeCommunity | null;
+export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionThemeChangedUnique | ActionUserJoinedApproved | ActionUserJoinedViaCommunity | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGiftSent | ActionStarGiftUpgradePaid | ActionStarGiftUpgraded | ActionStarGiftBoughtResale | ActionStarGiftTransferred | ActionStarGiftAssigned | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | ActionSuggestBirthday | ActionStarGiftPurchaseOffer | ActionStarGiftPurchaseOfferDeclined | ActionStarGiftBoughtOffer | ActionStarGiftCrafted | ActionNewCreatorPending | ActionChangeCreator | ActionNoForwardsToggle | ActionNoForwardsRequest | ActionPollAppendAnswer | ActionPollDeleteAnswer | ActionManagedBotCreated | ActionChangeCommunity | null;
 /** @internal */
 export declare function _messageActionFromTl(this: Message, act: tl.TypeMessageAction): MessageAction;
 export {};

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

@@ -104,6 +104,12 @@ export interface ActionUserJoinedLink {
 export interface ActionUserJoinedApproved {
     readonly type: 'user_joined_approved';
 }
+/** User has joined the group because they are a member of a community */
+export interface ActionUserJoinedViaCommunity {
+    readonly type: 'user_joined_community';
+    /** Community the user has joined via */
+    readonly community: Chat;
+}
 /** A payment was received from a user (bot) */
 export interface ActionPaymentReceived {
     readonly type: 'payment_received';
@@ -477,6 +483,10 @@ interface StarGiftUniqueCommon {
     dropDetailsStars?: tl.Long;
     /** ID of the related saved profile gift */
     savedId?: tl.Long;
+    /** Whether the name of the sender/buyer is hidden */
+    nameHidden: boolean;
+    /** Message attached to the gift, if any */
+    message?: TextWithEntities;
 }
 /** A star gift was upgraded to a unique one */
 export interface ActionStarGiftUpgraded extends StarGiftUniqueCommon {
@@ -628,7 +638,7 @@ export interface ActionChangeCreator {
     /** New creator */
     newCreator: User;
 }
-export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionThemeChangedUnique | ActionUserJoinedApproved | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGiftSent | ActionStarGiftUpgradePaid | ActionStarGiftUpgraded | ActionStarGiftBoughtResale | ActionStarGiftTransferred | ActionStarGiftAssigned | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | ActionSuggestBirthday | ActionStarGiftPurchaseOffer | ActionStarGiftPurchaseOfferDeclined | ActionStarGiftBoughtOffer | ActionStarGiftCrafted | ActionNewCreatorPending | ActionChangeCreator | ActionNoForwardsToggle | ActionNoForwardsRequest | ActionPollAppendAnswer | ActionPollDeleteAnswer | ActionManagedBotCreated | ActionChangeCommunity | null;
+export type MessageAction = ActionChatCreated | ActionChannelCreated | ActionChatMigrateTo | ActionChannelMigrateFrom | ActionMessagePinned | ActionHistoryCleared | ActionGameScore | ActionContactJoined | ActionTitleChanged | ActionPhotoChanged | ActionPhotoDeleted | ActionUsersAdded | ActionUserLeft | ActionUserRemoved | ActionUserJoinedLink | ActionPaymentReceived | ActionPaymentSent | ActionCall | ActionScreenshotTaken | ActionBotAllowed | ActionGeoProximity | ActionGroupCallStarted | ActionGroupCallEnded | ActionGroupCallScheduled | ActionGroupInvite | ActionTtlChanged | ActionTopicCreated | ActionTopicEdited | ActionCustom | ActionThemeChanged | ActionThemeChangedUnique | ActionUserJoinedApproved | ActionUserJoinedViaCommunity | ActionWebviewDataSent | ActionWebviewDataReceived | ActionPremiumGifted | ActionPhotoSuggested | ActionPeerSent | ActionPeerChosen | ActionWallpaperChanged | ActionGiftCode | ActionGiveawayStarted | ActionGiveawayEnded | ActionBoostApply | ActionPaymentRefunded | ActionStarGifted | ActionStarsPrize | ActionStarGiftSent | ActionStarGiftUpgradePaid | ActionStarGiftUpgraded | ActionStarGiftBoughtResale | ActionStarGiftTransferred | ActionStarGiftAssigned | ActionPaidMessagesPaid | ActionPaidMessagesRefunded | ActionTodoCompletions | ActionTodoAppendTasks | ActionTonGift | ActionSuggestBirthday | ActionStarGiftPurchaseOffer | ActionStarGiftPurchaseOfferDeclined | ActionStarGiftBoughtOffer | ActionStarGiftCrafted | ActionNewCreatorPending | ActionChangeCreator | ActionNoForwardsToggle | ActionNoForwardsRequest | ActionPollAppendAnswer | ActionPollDeleteAnswer | ActionManagedBotCreated | ActionChangeCommunity | null;
 /** @internal */
 export declare function _messageActionFromTl(this: Message, act: tl.TypeMessageAction): MessageAction;
 export {};

package/highlevel/types/messages/message-action.js

@@ -198,6 +198,11 @@ function _messageActionFromTl(act) {
       return {
         type: "user_joined_approved"
       };
+    case "messageActionChatJoinedViaCommunity":
+      return {
+        type: "user_joined_community",
+        community: new Chat$2(this._peers.chat(act.communityId))
+      };
     case "messageActionWebViewDataSent":
       return {
         type: "webview_sent",
@@ -334,7 +339,9 @@ function _messageActionFromTl(act) {
         canExportAt: act.canExportAt ? new Date(act.canExportAt * 1e3) : void 0,
         canCraftAt: act.canCraftAt ? new Date(act.canCraftAt * 1e3) : void 0,
         savedId: act.savedId,
-        dropDetailsStars: act.dropOriginalDetailsStars
+        dropDetailsStars: act.dropOriginalDetailsStars,
+        nameHidden: act.nameHidden,
+        message: act.message
       };
       if (act.assigned) {
         return {

package/highlevel/types/messages/message.cjs

@@ -379,7 +379,8 @@ class Message {
         return {
           type: "force_reply",
           singleUse: rm.singleUse,
-          selective: rm.selective
+          selective: rm.selective,
+          placeholder: rm.placeholder
         };
       case "replyKeyboardMarkup":
         return {
@@ -387,12 +388,16 @@ class Message {
           resize: rm.resize,
           singleUse: rm.singleUse,
           selective: rm.selective,
+          persistent: rm.persistent,
+          forceReply: rm.forceReply,
+          placeholder: rm.placeholder,
           buttons: factories._rowsTo2d(rm.rows)
         };
       case "replyInlineMarkup":
         return {
           type: "inline",
-          buttons: factories._rowsTo2d(rm.rows)
+          forceReply: rm.forceReply,
+          buttons: factories._inlineRowsTo2d(rm.rows)
         };
       default:
         utils.assertNever();

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

@@ -1,5 +1,5 @@
 import { tl } from '../../../tl/index.js';
-import { ReplyMarkup } from '../bots/keyboards/index.js';
+import { ParsedReplyMarkup } from '../bots/keyboards/index.js';
 import { TextWithEntities } from '../misc/index.js';
 import { Peer } from '../peers/peer.js';
 import { PeersIndex } from '../peers/peers-index.js';
@@ -232,7 +232,7 @@ export declare class Message {
     /**
      * Reply markup provided with this message, if any.
      */
-    get markup(): ReplyMarkup | null;
+    get markup(): ParsedReplyMarkup | null;
     /**
      * Whether this message can be forwarded
      *

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

@@ -1,5 +1,5 @@
 import { tl } from '../../../tl/index.js';
-import { ReplyMarkup } from '../bots/keyboards/index.js';
+import { ParsedReplyMarkup } from '../bots/keyboards/index.js';
 import { TextWithEntities } from '../misc/index.js';
 import { Peer } from '../peers/peer.js';
 import { PeersIndex } from '../peers/peers-index.js';
@@ -232,7 +232,7 @@ export declare class Message {
     /**
      * Reply markup provided with this message, if any.
      */
-    get markup(): ReplyMarkup | null;
+    get markup(): ParsedReplyMarkup | null;
     /**
      * Whether this message can be forwarded
      *

package/highlevel/types/messages/message.js

@@ -16,7 +16,7 @@ import { RepliedMessageInfo as RepliedMessageInfo$2 } from "./replied-message.js
 import { RichMessage as RichMessage$2 } from "./rich/rich-message.js";
 import { SuggestedPostInfo as SuggestedPostInfo$1 } from "./suggested-post.js";
 import { makeInspectable } from "../../utils/inspectable.js";
-import { _rowsTo2d } from "../bots/keyboards/factories.js";
+import { _inlineRowsTo2d, _rowsTo2d } from "../bots/keyboards/factories.js";
 class Message {
   constructor(raw, _peers, isScheduled = false) {
     this._peers = _peers;
@@ -372,7 +372,8 @@ class Message {
         return {
           type: "force_reply",
           singleUse: rm.singleUse,
-          selective: rm.selective
+          selective: rm.selective,
+          placeholder: rm.placeholder
         };
       case "replyKeyboardMarkup":
         return {
@@ -380,12 +381,16 @@ class Message {
           resize: rm.resize,
           singleUse: rm.singleUse,
           selective: rm.selective,
+          persistent: rm.persistent,
+          forceReply: rm.forceReply,
+          placeholder: rm.placeholder,
           buttons: _rowsTo2d(rm.rows)
         };
       case "replyInlineMarkup":
         return {
           type: "inline",
-          buttons: _rowsTo2d(rm.rows)
+          forceReply: rm.forceReply,
+          buttons: _inlineRowsTo2d(rm.rows)
         };
       default:
         assertNever();

package/highlevel/types/messages/rich/inner.cjs

@@ -6,7 +6,9 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const Long = require("long");
+const errors = require("../../../../types/errors.cjs");
 const entities = require("../../../utils/entities.cjs");
+const normalize = require("../../bots/keyboards/normalize.cjs");
 const RICH_EMPTY = { _: "textEmpty" };
 function normalizeRichText(text) {
   if (typeof text === "string") return { _: "textPlain", text };
@@ -55,6 +57,38 @@ function blockquote(content, caption) {
   }
   return { _: "pageBlockBlockquote", text: normalizeRichText(content), caption: normalizedCaption };
 }
+function normalizeButton(btn, text) {
+  if ("_" in btn) {
+    if (btn._ !== "keyboardInlineButton") {
+      throw new errors.MtArgumentError("reply keyboard buttons cannot be used in rich messages");
+    }
+    return {
+      text: normalizeRichText(text ?? btn.text),
+      type: btn.type,
+      style: void 0
+    };
+  }
+  return {
+    text: normalizeRichText(text ?? btn.text),
+    type: normalize._toInlineButtonType(btn),
+    style: normalize._toRichButtonStyle(btn.style)
+  };
+}
+function textButton(button2, text) {
+  return { _: "textButton", ...normalizeButton(button2, text) };
+}
+function button(button2, text) {
+  return { _: "pageButton", ...normalizeButton(button2, text) };
+}
+function buttonRow(buttons, params = {}) {
+  return {
+    _: "pageBlockButtonRow",
+    alignLeft: params.align === "left" || void 0,
+    alignCenter: params.align === "center" || void 0,
+    alignRight: params.align === "right" || void 0,
+    buttons: buttons.map((it) => "_" in it && it._ === "pageButton" ? it : button(it))
+  };
+}
 function pullquote(text, caption) {
   return {
     _: "pageBlockPullquote",
@@ -196,6 +230,8 @@ function audio(file, params = {}) {
 exports.anchor = anchor;
 exports.audio = audio;
 exports.blockquote = blockquote;
+exports.button = button;
+exports.buttonRow = buttonRow;
 exports.collage = collage;
 exports.details = details;
 exports.divider = divider;
@@ -215,5 +251,6 @@ exports.slideshow = slideshow;
 exports.table = table;
 exports.tableCell = tableCell;
 exports.tableRow = tableRow;
+exports.textButton = textButton;
 exports.thinking = thinking;
 exports.video = video;

package/highlevel/types/messages/rich/inner.d.cts

@@ -1,4 +1,5 @@
 import { tl } from '../../../../tl/index.js';
+import { InputInlineKeyboardButton } from '../../bots/keyboards/types.js';
 import { InputMediaAudio, InputMediaPhoto, InputMediaVideo } from '../../media/index.js';
 import { InputText } from '../../misc/entities.js';
 import { InputPageBlock, InputPageBlockOrFile, InputPageBlockWithFile } from './types.js';
@@ -48,6 +49,24 @@ export declare function preformatted(text: InputRichText, language?: string): tl
  * containing other blocks (`pageBlockBlockquoteBlocks`).
  */
 export declare function blockquote(content: InputRichText | InputPageBlockOrFile[], caption?: InputRichText): tl.RawPageBlockBlockquote | Block<'pageBlockBlockquoteBlocks'>;
+/**
+ * Create an inline button inside rich text
+ *
+ * @param button  Button to render (see {@link BotKeyboard})
+ * @param text  Rich text to use as the button label, defaults to the button's own text
+ */
+export declare function textButton(button: InputInlineKeyboardButton, text?: InputRichText): tl.RawTextButton;
+/** Create a button to be used inside a {@link buttonRow} */
+export declare function button(button: InputInlineKeyboardButton, text?: InputRichText): tl.RawPageButton;
+/**
+ * Create a row of buttons
+ *
+ * @param buttons  Buttons in the row (see {@link BotKeyboard}), or raw `pageButton`s
+ * @param params  Alignment of the row
+ */
+export declare function buttonRow(buttons: (InputInlineKeyboardButton | tl.RawPageButton)[], params?: {
+    align?: 'left' | 'center' | 'right';
+}): tl.RawPageBlockButtonRow;
 /** Create a pullquote block */
 export declare function pullquote(text: InputRichText, caption?: InputRichText): tl.RawPageBlockPullquote;
 /** Create a map block */

package/highlevel/types/messages/rich/inner.d.ts

@@ -1,4 +1,5 @@
 import { tl } from '../../../../tl/index.js';
+import { InputInlineKeyboardButton } from '../../bots/keyboards/types.js';
 import { InputMediaAudio, InputMediaPhoto, InputMediaVideo } from '../../media/index.js';
 import { InputText } from '../../misc/entities.js';
 import { InputPageBlock, InputPageBlockOrFile, InputPageBlockWithFile } from './types.js';
@@ -48,6 +49,24 @@ export declare function preformatted(text: InputRichText, language?: string): tl
  * containing other blocks (`pageBlockBlockquoteBlocks`).
  */
 export declare function blockquote(content: InputRichText | InputPageBlockOrFile[], caption?: InputRichText): tl.RawPageBlockBlockquote | Block<'pageBlockBlockquoteBlocks'>;
+/**
+ * Create an inline button inside rich text
+ *
+ * @param button  Button to render (see {@link BotKeyboard})
+ * @param text  Rich text to use as the button label, defaults to the button's own text
+ */
+export declare function textButton(button: InputInlineKeyboardButton, text?: InputRichText): tl.RawTextButton;
+/** Create a button to be used inside a {@link buttonRow} */
+export declare function button(button: InputInlineKeyboardButton, text?: InputRichText): tl.RawPageButton;
+/**
+ * Create a row of buttons
+ *
+ * @param buttons  Buttons in the row (see {@link BotKeyboard}), or raw `pageButton`s
+ * @param params  Alignment of the row
+ */
+export declare function buttonRow(buttons: (InputInlineKeyboardButton | tl.RawPageButton)[], params?: {
+    align?: 'left' | 'center' | 'right';
+}): tl.RawPageBlockButtonRow;
 /** Create a pullquote block */
 export declare function pullquote(text: InputRichText, caption?: InputRichText): tl.RawPageBlockPullquote;
 /** Create a map block */

package/highlevel/types/messages/rich/inner.js

@@ -1,5 +1,7 @@
 import Long from "long";
+import { MtArgumentError } from "../../../../types/errors.js";
 import { textWithEntitiesToRichText } from "../../../utils/entities.js";
+import { _toRichButtonStyle, _toInlineButtonType } from "../../bots/keyboards/normalize.js";
 const RICH_EMPTY = { _: "textEmpty" };
 function normalizeRichText(text) {
   if (typeof text === "string") return { _: "textPlain", text };
@@ -48,6 +50,38 @@ function blockquote(content, caption) {
   }
   return { _: "pageBlockBlockquote", text: normalizeRichText(content), caption: normalizedCaption };
 }
+function normalizeButton(btn, text) {
+  if ("_" in btn) {
+    if (btn._ !== "keyboardInlineButton") {
+      throw new MtArgumentError("reply keyboard buttons cannot be used in rich messages");
+    }
+    return {
+      text: normalizeRichText(text ?? btn.text),
+      type: btn.type,
+      style: void 0
+    };
+  }
+  return {
+    text: normalizeRichText(text ?? btn.text),
+    type: _toInlineButtonType(btn),
+    style: _toRichButtonStyle(btn.style)
+  };
+}
+function textButton(button2, text) {
+  return { _: "textButton", ...normalizeButton(button2, text) };
+}
+function button(button2, text) {
+  return { _: "pageButton", ...normalizeButton(button2, text) };
+}
+function buttonRow(buttons, params = {}) {
+  return {
+    _: "pageBlockButtonRow",
+    alignLeft: params.align === "left" || void 0,
+    alignCenter: params.align === "center" || void 0,
+    alignRight: params.align === "right" || void 0,
+    buttons: buttons.map((it) => "_" in it && it._ === "pageButton" ? it : button(it))
+  };
+}
 function pullquote(text, caption) {
   return {
     _: "pageBlockPullquote",
@@ -190,6 +224,8 @@ export {
   anchor,
   audio,
   blockquote,
+  button,
+  buttonRow,
   collage,
   details,
   divider,
@@ -209,6 +245,7 @@ export {
   table,
   tableCell,
   tableRow,
+  textButton,
   thinking,
   video
 };

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

@@ -312,6 +312,10 @@ class FullChat extends chat.Chat {
     if (this.full._ !== "channelFull" || !this.full.botVerification) return null;
     return new botVerification.BotVerification(this.full.botVerification);
   }
+  /** Whether this chat has welcome messages configured */
+  get hasWelcomeMessages() {
+    return this.full._ !== "communityFull" && this.full.hasWelcomeMessages;
+  }
   /** Whether star gifts are available in this chat */
   get starGiftsAvailable() {
     return this.full._ === "channelFull" && this.full.stargiftsAvailable;

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

@@ -167,6 +167,8 @@ export declare class FullChat extends Chat {
     get stories(): PeerStories | null;
     /** Information about a bot-issued verification (if any) */
     get botVerification(): BotVerification | null;
+    /** Whether this chat has welcome messages configured */
+    get hasWelcomeMessages(): boolean;
     /** Whether star gifts are available in this chat */
     get starGiftsAvailable(): boolean;
     /** Number of star gifts available in this chat */

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

@@ -167,6 +167,8 @@ export declare class FullChat extends Chat {
     get stories(): PeerStories | null;
     /** Information about a bot-issued verification (if any) */
     get botVerification(): BotVerification | null;
+    /** Whether this chat has welcome messages configured */
+    get hasWelcomeMessages(): boolean;
     /** Whether star gifts are available in this chat */
     get starGiftsAvailable(): boolean;
     /** Number of star gifts available in this chat */

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

@@ -305,6 +305,10 @@ class FullChat extends Chat$2 {
     if (this.full._ !== "channelFull" || !this.full.botVerification) return null;
     return new BotVerification$1(this.full.botVerification);
   }
+  /** Whether this chat has welcome messages configured */
+  get hasWelcomeMessages() {
+    return this.full._ !== "communityFull" && this.full.hasWelcomeMessages;
+  }
   /** Whether star gifts are available in this chat */
   get starGiftsAvailable() {
     return this.full._ === "channelFull" && this.full.stargiftsAvailable;

package/highlevel/types/peers/typing-status.d.cts

@@ -22,5 +22,8 @@
  *  - `sticker`: User is choosing a sticker
  *  - `interaction`: User has sent an emoji interaction
  *  - `interaction_seen`: User is watching a previously sent emoji interaction
+ *  - `stop_draft`: User has requested to stop the ongoing draft streaming
  */
-export type TypingStatus = 'typing' | 'cancel' | 'record_video' | 'upload_video' | 'record_voice' | 'upload_voice' | 'upload_photo' | 'upload_document' | 'geo' | 'contact' | 'game' | 'record_round' | 'upload_round' | 'speak_call' | 'history_import' | 'sticker' | 'interaction' | 'interaction_seen';
+export type TypingStatus = 'typing' | 'cancel' | 'record_video' | 'upload_video' | 'record_voice' | 'upload_voice' | 'upload_photo' | 'upload_document' | 'geo' | 'contact' | 'game' | 'record_round' | 'upload_round' | 'speak_call' | 'history_import' | 'sticker' | 'interaction' | 'interaction_seen' | 'stop_draft';
+/** {@link TypingStatus} values that can be sent by the client as-is */
+export type SendableTypingStatus = Exclude<TypingStatus, 'interaction' | 'interaction_seen' | 'stop_draft'>;

package/highlevel/types/peers/typing-status.d.ts

@@ -22,5 +22,8 @@
  *  - `sticker`: User is choosing a sticker
  *  - `interaction`: User has sent an emoji interaction
  *  - `interaction_seen`: User is watching a previously sent emoji interaction
+ *  - `stop_draft`: User has requested to stop the ongoing draft streaming
  */
-export type TypingStatus = 'typing' | 'cancel' | 'record_video' | 'upload_video' | 'record_voice' | 'upload_voice' | 'upload_photo' | 'upload_document' | 'geo' | 'contact' | 'game' | 'record_round' | 'upload_round' | 'speak_call' | 'history_import' | 'sticker' | 'interaction' | 'interaction_seen';
+export type TypingStatus = 'typing' | 'cancel' | 'record_video' | 'upload_video' | 'record_voice' | 'upload_voice' | 'upload_photo' | 'upload_document' | 'geo' | 'contact' | 'game' | 'record_round' | 'upload_round' | 'speak_call' | 'history_import' | 'sticker' | 'interaction' | 'interaction_seen' | 'stop_draft';
+/** {@link TypingStatus} values that can be sent by the client as-is */
+export type SendableTypingStatus = Exclude<TypingStatus, 'interaction' | 'interaction_seen' | 'stop_draft'>;

package/highlevel/types/updates/ephemeral-callback-query.cjs

@@ -24,9 +24,17 @@ class EphemeralCallbackQuery {
   get user() {
     return new user.User(this._peers.user(this.raw.userId));
   }
-  /** Chat where the originating ephemeral message was sent */
+  /**
+   * Chat where the originating ephemeral message was sent.
+   *
+   * `null` if not available (see {@link chatInstance})
+   */
   get chat() {
-    return peer.parsePeer(this.raw.peer, this._peers);
+    return this.raw.peer ? peer.parsePeer(this.raw.peer, this._peers) : null;
+  }
+  /** Identifier uniquely corresponding to the chat the message was sent to, if any */
+  get chatInstance() {
+    return this.raw.chatInstance ?? null;
   }
   /** Identifier of the ephemeral message containing the button which was clicked */
   get messageId() {

package/highlevel/types/updates/ephemeral-callback-query.d.cts

@@ -14,8 +14,14 @@ export declare class EphemeralCallbackQuery {
     get id(): tl.Long;
     /** User who has pressed the button */
     get user(): User;
-    /** Chat where the originating ephemeral message was sent */
-    get chat(): Peer;
+    /**
+     * Chat where the originating ephemeral message was sent.
+     *
+     * `null` if not available (see {@link chatInstance})
+     */
+    get chat(): Peer | null;
+    /** Identifier uniquely corresponding to the chat the message was sent to, if any */
+    get chatInstance(): tl.Long | null;
     /** Identifier of the ephemeral message containing the button which was clicked */
     get messageId(): number;
     /** The originating ephemeral message */

package/highlevel/types/updates/ephemeral-callback-query.d.ts

@@ -14,8 +14,14 @@ export declare class EphemeralCallbackQuery {
     get id(): tl.Long;
     /** User who has pressed the button */
     get user(): User;
-    /** Chat where the originating ephemeral message was sent */
-    get chat(): Peer;
+    /**
+     * Chat where the originating ephemeral message was sent.
+     *
+     * `null` if not available (see {@link chatInstance})
+     */
+    get chat(): Peer | null;
+    /** Identifier uniquely corresponding to the chat the message was sent to, if any */
+    get chatInstance(): tl.Long | null;
     /** Identifier of the ephemeral message containing the button which was clicked */
     get messageId(): number;
     /** The originating ephemeral message */