@mtcute/core 0.29.6 → 0.30.0

package/client.cjs

@@ -20,6 +20,7 @@ const signIn = require("./highlevel/methods/auth/sign-in.cjs");
 const startTest = require("./highlevel/methods/auth/start-test.cjs");
 const start = require("./highlevel/methods/auth/start.cjs");
 const utils$1 = require("./highlevel/methods/auth/utils.cjs");
+const answerBotGuestChatQuery = require("./highlevel/methods/bots/answer-bot-guest-chat-query.cjs");
 const answerCallbackQuery = require("./highlevel/methods/bots/answer-callback-query.cjs");
 const answerInlineQuery = require("./highlevel/methods/bots/answer-inline-query.cjs");
 const answerPreCheckoutQuery = require("./highlevel/methods/bots/answer-pre-checkout-query.cjs");
@@ -303,6 +304,7 @@ class TelegramClient {
     this.onDeleteMessage = new utils.Emitter();
     this.onChatMemberUpdate = new utils.Emitter();
     this.onInlineQuery = new utils.Emitter();
+    this.onBotGuestChatQuery = new utils.Emitter();
     this.onChosenInlineResult = new utils.Emitter();
     this.onCallbackQuery = new utils.Emitter();
     this.onInlineCallbackQuery = new utils.Emitter();
@@ -373,6 +375,9 @@ class TelegramClient {
               case "inline_query":
                 this.onInlineQuery.emit(update.data);
                 break;
+              case "bot_guest_chat_query":
+                this.onBotGuestChatQuery.emit(update.data);
+                break;
               case "chosen_inline_result":
                 this.onChosenInlineResult.emit(update.data);
                 break;
@@ -488,6 +493,9 @@ TelegramClient.prototype.start = function(...args) {
 TelegramClient.prototype.isSelfPeer = function(...args) {
   return utils$1.isSelfPeer(this._client, ...args);
 };
+TelegramClient.prototype.answerBotGuestChatQuery = function(...args) {
+  return answerBotGuestChatQuery.answerBotGuestChatQuery(this._client, ...args);
+};
 TelegramClient.prototype.answerCallbackQuery = function(...args) {
   return answerCallbackQuery.answerCallbackQuery(this._client, ...args);
 };

package/client.js

@@ -13,6 +13,7 @@ import { signIn } from "./highlevel/methods/auth/sign-in.js";
 import { startTest } from "./highlevel/methods/auth/start-test.js";
 import { start } from "./highlevel/methods/auth/start.js";
 import { isSelfPeer } from "./highlevel/methods/auth/utils.js";
+import { answerBotGuestChatQuery } from "./highlevel/methods/bots/answer-bot-guest-chat-query.js";
 import { answerCallbackQuery } from "./highlevel/methods/bots/answer-callback-query.js";
 import { answerInlineQuery } from "./highlevel/methods/bots/answer-inline-query.js";
 import { answerPreCheckoutQuery } from "./highlevel/methods/bots/answer-pre-checkout-query.js";
@@ -296,6 +297,7 @@ class TelegramClient {
     this.onDeleteMessage = new Emitter();
     this.onChatMemberUpdate = new Emitter();
     this.onInlineQuery = new Emitter();
+    this.onBotGuestChatQuery = new Emitter();
     this.onChosenInlineResult = new Emitter();
     this.onCallbackQuery = new Emitter();
     this.onInlineCallbackQuery = new Emitter();
@@ -366,6 +368,9 @@ class TelegramClient {
               case "inline_query":
                 this.onInlineQuery.emit(update.data);
                 break;
+              case "bot_guest_chat_query":
+                this.onBotGuestChatQuery.emit(update.data);
+                break;
               case "chosen_inline_result":
                 this.onChosenInlineResult.emit(update.data);
                 break;
@@ -481,6 +486,9 @@ TelegramClient.prototype.start = function(...args) {
 TelegramClient.prototype.isSelfPeer = function(...args) {
   return isSelfPeer(this._client, ...args);
 };
+TelegramClient.prototype.answerBotGuestChatQuery = function(...args) {
+  return answerBotGuestChatQuery(this._client, ...args);
+};
 TelegramClient.prototype.answerCallbackQuery = function(...args) {
   return answerCallbackQuery(this._client, ...args);
 };

package/highlevel/client.d.cts

@@ -6,6 +6,8 @@ import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
 import { LogOutResult } from './methods/auth/log-out.js';
 import { CreateGroupResult } from './methods/chats/create-group.js';
+import { JoinChatResult } from './methods/chats/join-chat.js';
+import { DraftMessageInput } from './methods/chats/save-draft.js';
 import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum-topics.js';
 import { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/gifts/get-resale-star-gifts.js';
 import { StarGiftUpgradeOptions } from './methods/gifts/get-star-gift-upgrade-options.js';
@@ -27,7 +29,7 @@ import { InputStarsAmount } from './methods/premium/_normalize-stars-amount.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputDocumentId, InputFileLike, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotGuestChatQuery, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputDocumentId, InputFileLike, InputInlineMessage, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -91,6 +93,8 @@ export interface TelegramClient extends ITelegramClient {
     readonly onChatMemberUpdate: Emitter<ChatMemberUpdate>;
     /** an inline query handler */
     readonly onInlineQuery: Emitter<InlineQuery>;
+    /** a bot guest chat query handler */
+    readonly onBotGuestChatQuery: Emitter<BotGuestChatQuery>;
     /** a chosen inline result handler */
     readonly onChosenInlineResult: Emitter<ChosenInlineResult>;
     /** a callback query handler */
@@ -412,6 +416,14 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     isSelfPeer(peer: tl.TypeInputPeer | tl.TypePeer | tl.TypeInputUser): boolean;
+    /**
+     * Answer a bot guest chat query with a result.
+     *
+     * @param queryId  Query ID
+     * @param result  Result of the query
+     * @returns  ID of the inline message that was sent
+     */
+    answerBotGuestChatQuery(queryId: tl.Long | BotGuestChatQuery, result: InputInlineMessage | InputInlineResult): Promise<tl.TypeInputBotInlineMessageID>;
     /**
      * Send an answer to a callback query.
      *
@@ -1113,6 +1125,8 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Edit the custom rank (title) of a group chat participant.
+     * **Available**: 👤 users only
+     *
      */
     editChatMemberRank(params: {
         /** Chat ID */
@@ -1283,6 +1297,8 @@ export interface TelegramClient extends ITelegramClient {
      * Get the user who will be made the creator of the chat/channel/supergroup if you were to leave it.
      *
      * You must be the creator of the chat/channel/supergroup to use this method.
+     * **Available**: 👤 users only
+     *
      */
     getCreatorAfterLeave(chatId: InputPeerLike): Promise<User | null>;
     /**
@@ -1385,17 +1401,13 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Join a channel or supergroup
      *
-     * When using with invite links, this method may throw RPC error
-     * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
-     * You will get into the chat once they do so.
-     *
      * **Available**: 👤 users only
      *
      * @param chatId
      *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
      *   or ID of the linked supergroup or channel.
      */
-    joinChat(chatId: InputPeerLike): Promise<Chat>;
+    joinChat(chatId: InputPeerLike): Promise<JoinChatResult>;
     /**
      * Kick a user from a chat.
      *
@@ -1503,7 +1515,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param draft  Draft message, or `null` to delete.
      */
-    saveDraft(chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;
+    saveDraft(chatId: InputPeerLike, draft: null | DraftMessageInput): Promise<void>;
     /**
      * Set peer color and optionally background pattern
      * **Available**: 👤 users only
@@ -1689,6 +1701,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be the creator of the chat to use this method,
      * and your account must have 2FA enabled.
+     * **Available**: 👤 users only
+     *
      */
     transferChatOwnership(params: {
         /** ID of the chat/channel/supergroup to transfer */
@@ -3100,6 +3114,8 @@ export interface TelegramClient extends ITelegramClient {
          *
          * - `append` - appends the text to the previous draft
          * - `replace` - replaces the previous draft with the new one
+         *
+         * @default  `replace`
          */
         mode?: 'append' | 'replace';
     }): Promise<StreamingDraft>;

package/highlevel/client.d.ts

@@ -6,6 +6,8 @@ import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
 import { LogOutResult } from './methods/auth/log-out.js';
 import { CreateGroupResult } from './methods/chats/create-group.js';
+import { JoinChatResult } from './methods/chats/join-chat.js';
+import { DraftMessageInput } from './methods/chats/save-draft.js';
 import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum-topics.js';
 import { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/gifts/get-resale-star-gifts.js';
 import { StarGiftUpgradeOptions } from './methods/gifts/get-star-gift-upgrade-options.js';
@@ -27,7 +29,7 @@ import { InputStarsAmount } from './methods/premium/_normalize-stars-amount.js';
 import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputDocumentId, InputFileLike, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotGuestChatQuery, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputDocumentId, InputFileLike, InputInlineMessage, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -91,6 +93,8 @@ export interface TelegramClient extends ITelegramClient {
     readonly onChatMemberUpdate: Emitter<ChatMemberUpdate>;
     /** an inline query handler */
     readonly onInlineQuery: Emitter<InlineQuery>;
+    /** a bot guest chat query handler */
+    readonly onBotGuestChatQuery: Emitter<BotGuestChatQuery>;
     /** a chosen inline result handler */
     readonly onChosenInlineResult: Emitter<ChosenInlineResult>;
     /** a callback query handler */
@@ -412,6 +416,14 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     isSelfPeer(peer: tl.TypeInputPeer | tl.TypePeer | tl.TypeInputUser): boolean;
+    /**
+     * Answer a bot guest chat query with a result.
+     *
+     * @param queryId  Query ID
+     * @param result  Result of the query
+     * @returns  ID of the inline message that was sent
+     */
+    answerBotGuestChatQuery(queryId: tl.Long | BotGuestChatQuery, result: InputInlineMessage | InputInlineResult): Promise<tl.TypeInputBotInlineMessageID>;
     /**
      * Send an answer to a callback query.
      *
@@ -1113,6 +1125,8 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Edit the custom rank (title) of a group chat participant.
+     * **Available**: 👤 users only
+     *
      */
     editChatMemberRank(params: {
         /** Chat ID */
@@ -1283,6 +1297,8 @@ export interface TelegramClient extends ITelegramClient {
      * Get the user who will be made the creator of the chat/channel/supergroup if you were to leave it.
      *
      * You must be the creator of the chat/channel/supergroup to use this method.
+     * **Available**: 👤 users only
+     *
      */
     getCreatorAfterLeave(chatId: InputPeerLike): Promise<User | null>;
     /**
@@ -1385,17 +1401,13 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Join a channel or supergroup
      *
-     * When using with invite links, this method may throw RPC error
-     * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
-     * You will get into the chat once they do so.
-     *
      * **Available**: 👤 users only
      *
      * @param chatId
      *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
      *   or ID of the linked supergroup or channel.
      */
-    joinChat(chatId: InputPeerLike): Promise<Chat>;
+    joinChat(chatId: InputPeerLike): Promise<JoinChatResult>;
     /**
      * Kick a user from a chat.
      *
@@ -1503,7 +1515,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param draft  Draft message, or `null` to delete.
      */
-    saveDraft(chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;
+    saveDraft(chatId: InputPeerLike, draft: null | DraftMessageInput): Promise<void>;
     /**
      * Set peer color and optionally background pattern
      * **Available**: 👤 users only
@@ -1689,6 +1701,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be the creator of the chat to use this method,
      * and your account must have 2FA enabled.
+     * **Available**: 👤 users only
+     *
      */
     transferChatOwnership(params: {
         /** ID of the chat/channel/supergroup to transfer */
@@ -3100,6 +3114,8 @@ export interface TelegramClient extends ITelegramClient {
          *
          * - `append` - appends the text to the previous draft
          * - `replace` - replaces the previous draft with the new one
+         *
+         * @default  `replace`
          */
         mode?: 'append' | 'replace';
     }): Promise<StreamingDraft>;

package/highlevel/methods/bots/answer-bot-guest-chat-query.cjs

@@ -0,0 +1,26 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS bundles are deprecated. They will be removed completely in one of the upcoming releases. No support is provided for CommonJS users. 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 Long = require("long");
+const factories = require("../../types/bots/inline-result/factories.cjs");
+async function answerBotGuestChatQuery(client, queryId, result) {
+  if (!("id" in result)) {
+    result = {
+      type: "article",
+      id: "guest",
+      title: "guest",
+      message: result
+    };
+  }
+  const [, tlResults] = await factories._convertToTl(client, [result]);
+  return client.call({
+    _: "messages.setBotGuestChatResult",
+    queryId: Long.isLong(queryId) ? queryId : queryId.id,
+    result: tlResults[0]
+  });
+}
+exports.answerBotGuestChatQuery = answerBotGuestChatQuery;

package/highlevel/methods/bots/answer-bot-guest-chat-query.d.cts

@@ -0,0 +1,12 @@
+import { tl } from '../../../tl/index.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputInlineMessage, InputInlineResult } from '../../types/bots/index.js';
+import { BotGuestChatQuery } from '../../types/updates/bot-guest-chat-query.js';
+/**
+ * Answer a bot guest chat query with a result.
+ *
+ * @param queryId  Query ID
+ * @param result  Result of the query
+ * @returns  ID of the inline message that was sent
+ */
+export declare function answerBotGuestChatQuery(client: ITelegramClient, queryId: tl.Long | BotGuestChatQuery, result: InputInlineMessage | InputInlineResult): Promise<tl.TypeInputBotInlineMessageID>;

package/highlevel/methods/bots/answer-bot-guest-chat-query.d.ts

@@ -0,0 +1,12 @@
+import { tl } from '../../../tl/index.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputInlineMessage, InputInlineResult } from '../../types/bots/index.js';
+import { BotGuestChatQuery } from '../../types/updates/bot-guest-chat-query.js';
+/**
+ * Answer a bot guest chat query with a result.
+ *
+ * @param queryId  Query ID
+ * @param result  Result of the query
+ * @returns  ID of the inline message that was sent
+ */
+export declare function answerBotGuestChatQuery(client: ITelegramClient, queryId: tl.Long | BotGuestChatQuery, result: InputInlineMessage | InputInlineResult): Promise<tl.TypeInputBotInlineMessageID>;

package/highlevel/methods/bots/answer-bot-guest-chat-query.js

@@ -0,0 +1,21 @@
+import Long from "long";
+import { _convertToTl } from "../../types/bots/inline-result/factories.js";
+async function answerBotGuestChatQuery(client, queryId, result) {
+  if (!("id" in result)) {
+    result = {
+      type: "article",
+      id: "guest",
+      title: "guest",
+      message: result
+    };
+  }
+  const [, tlResults] = await _convertToTl(client, [result]);
+  return client.call({
+    _: "messages.setBotGuestChatResult",
+    queryId: Long.isLong(queryId) ? queryId : queryId.id,
+    result: tlResults[0]
+  });
+}
+export {
+  answerBotGuestChatQuery
+};

package/highlevel/methods/chats/join-chat.cjs

@@ -8,26 +8,48 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("../../updates/utils.cjs");
 const peerUtils = require("../../utils/peer-utils.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
+const innerTl = require("../../../tl/inner-tl.cjs");
+const peersIndex = require("../../types/peers/peers-index.cjs");
+const user = require("../../types/peers/user.cjs");
 const chat = require("../../types/peers/chat.cjs");
 async function joinChat(client, chatId) {
-  if (typeof chatId === "string") {
-    const m = chatId.match(peerUtils.INVITE_LINK_REGEX);
-    if (m) {
-      const res2 = await client.call({
-        _: "messages.importChatInvite",
-        hash: m[1]
+  let res;
+  try {
+    if (typeof chatId === "string") {
+      const m = chatId.match(peerUtils.INVITE_LINK_REGEX);
+      if (m) {
+        res = await client.call({
+          _: "messages.importChatInvite",
+          hash: m[1]
+        });
+      }
+    }
+    if (!res) {
+      res = await client.call({
+        _: "channels.joinChannel",
+        channel: await resolvePeer.resolveChannel(client, chatId)
       });
-      utils.assertIsUpdatesGroup("messages.importChatInvite", res2);
-      client.handleClientUpdate(res2);
-      return new chat.Chat(res2.chats[0]);
+    }
+  } catch (e) {
+    if (innerTl.RpcError.is(e, "INVITE_REQUEST_SENT")) {
+      return { status: "request_sent" };
+    } else {
+      throw e;
+    }
+  }
+  switch (res._) {
+    case "messages.chatInviteJoinResultOk":
+      utils.assertIsUpdatesGroup("joinChat", res.updates);
+      client.handleClientUpdate(res.updates);
+      return { status: "ok", chat: new chat.Chat(res.updates.chats[0]) };
+    case "messages.chatInviteJoinResultWebView": {
+      const peers = peersIndex.PeersIndex.from(res);
+      return {
+        status: "webview",
+        bot: new user.User(peers.user(res.botId)),
+        webview: res.webview
+      };
     }
   }
-  const res = await client.call({
-    _: "channels.joinChannel",
-    channel: await resolvePeer.resolveChannel(client, chatId)
-  });
-  utils.assertIsUpdatesGroup("channels.joinChannel", res);
-  client.handleClientUpdate(res);
-  return new chat.Chat(res.chats[0]);
 }
 exports.joinChat = joinChat;

package/highlevel/methods/chats/join-chat.d.cts

@@ -1,14 +1,28 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike, Chat } from '../../types/index.js';
+import { InputPeerLike, Chat, User } from '../../types/index.js';
+import { tl } from '../../../tl/index.js';
 /**
- * Join a channel or supergroup
+ * Result of {@link joinChat}
  *
- * When using with invite links, this method may throw RPC error
- * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
- * You will get into the chat once they do so.
+ * - `status: 'ok'` - the chat was joined successfully
+ * - `status: 'request_sent'` - a join request was sent and needs to be approved by the chat admin
+ * - `status: 'webview'` - a guard bot requested you to open a webview before joining the chat
+ */
+export type JoinChatResult = {
+    status: 'ok';
+    chat: Chat;
+} | {
+    status: 'request_sent';
+} | {
+    status: 'webview';
+    bot: User;
+    webview: tl.TypeWebViewResult;
+};
+/**
+ * Join a channel or supergroup
  *
  * @param chatId
  *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
  *   or ID of the linked supergroup or channel.
  */
-export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;
+export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<JoinChatResult>;

package/highlevel/methods/chats/join-chat.d.ts

@@ -1,14 +1,28 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike, Chat } from '../../types/index.js';
+import { InputPeerLike, Chat, User } from '../../types/index.js';
+import { tl } from '../../../tl/index.js';
 /**
- * Join a channel or supergroup
+ * Result of {@link joinChat}
  *
- * When using with invite links, this method may throw RPC error
- * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
- * You will get into the chat once they do so.
+ * - `status: 'ok'` - the chat was joined successfully
+ * - `status: 'request_sent'` - a join request was sent and needs to be approved by the chat admin
+ * - `status: 'webview'` - a guard bot requested you to open a webview before joining the chat
+ */
+export type JoinChatResult = {
+    status: 'ok';
+    chat: Chat;
+} | {
+    status: 'request_sent';
+} | {
+    status: 'webview';
+    bot: User;
+    webview: tl.TypeWebViewResult;
+};
+/**
+ * Join a channel or supergroup
  *
  * @param chatId
  *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
  *   or ID of the linked supergroup or channel.
  */
-export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;
+export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<JoinChatResult>;

package/highlevel/methods/chats/join-chat.js

@@ -1,27 +1,49 @@
 import { assertIsUpdatesGroup } from "../../updates/utils.js";
 import { INVITE_LINK_REGEX } from "../../utils/peer-utils.js";
 import { resolveChannel } from "../users/resolve-peer.js";
+import { RpcError } from "../../../tl/inner-tl.js";
+import { PeersIndex } from "../../types/peers/peers-index.js";
+import { User as User$2 } from "../../types/peers/user.js";
 import { Chat as Chat$2 } from "../../types/peers/chat.js";
 async function joinChat(client, chatId) {
-  if (typeof chatId === "string") {
-    const m = chatId.match(INVITE_LINK_REGEX);
-    if (m) {
-      const res2 = await client.call({
-        _: "messages.importChatInvite",
-        hash: m[1]
+  let res;
+  try {
+    if (typeof chatId === "string") {
+      const m = chatId.match(INVITE_LINK_REGEX);
+      if (m) {
+        res = await client.call({
+          _: "messages.importChatInvite",
+          hash: m[1]
+        });
+      }
+    }
+    if (!res) {
+      res = await client.call({
+        _: "channels.joinChannel",
+        channel: await resolveChannel(client, chatId)
       });
-      assertIsUpdatesGroup("messages.importChatInvite", res2);
-      client.handleClientUpdate(res2);
-      return new Chat$2(res2.chats[0]);
+    }
+  } catch (e) {
+    if (RpcError.is(e, "INVITE_REQUEST_SENT")) {
+      return { status: "request_sent" };
+    } else {
+      throw e;
+    }
+  }
+  switch (res._) {
+    case "messages.chatInviteJoinResultOk":
+      assertIsUpdatesGroup("joinChat", res.updates);
+      client.handleClientUpdate(res.updates);
+      return { status: "ok", chat: new Chat$2(res.updates.chats[0]) };
+    case "messages.chatInviteJoinResultWebView": {
+      const peers = PeersIndex.from(res);
+      return {
+        status: "webview",
+        bot: new User$2(peers.user(res.botId)),
+        webview: res.webview
+      };
     }
   }
-  const res = await client.call({
-    _: "channels.joinChannel",
-    channel: await resolveChannel(client, chatId)
-  });
-  assertIsUpdatesGroup("channels.joinChannel", res);
-  client.handleClientUpdate(res);
-  return new Chat$2(res.chats[0]);
 }
 export {
   joinChat

package/highlevel/methods/chats/save-draft.d.cts

@@ -1,10 +1,13 @@
 import { tl } from '../../../tl/index.js';
 import { ITelegramClient } from '../../client.types.js';
 import { InputPeerLike } from '../../types/index.js';
+export type DraftMessageInput = Omit<tl.RawDraftMessage, '_' | 'date' | 'richMessage'> & {
+    richMessage?: tl.TypeInputRichMessage;
+};
 /**
  * Save or delete a draft message associated with some chat
  *
  * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
  * @param draft  Draft message, or `null` to delete.
  */
-export declare function saveDraft(client: ITelegramClient, chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;
+export declare function saveDraft(client: ITelegramClient, chatId: InputPeerLike, draft: null | DraftMessageInput): Promise<void>;

package/highlevel/methods/chats/save-draft.d.ts

@@ -1,10 +1,13 @@
 import { tl } from '../../../tl/index.js';
 import { ITelegramClient } from '../../client.types.js';
 import { InputPeerLike } from '../../types/index.js';
+export type DraftMessageInput = Omit<tl.RawDraftMessage, '_' | 'date' | 'richMessage'> & {
+    richMessage?: tl.TypeInputRichMessage;
+};
 /**
  * Save or delete a draft message associated with some chat
  *
  * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
  * @param draft  Draft message, or `null` to delete.
  */
-export declare function saveDraft(client: ITelegramClient, chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;
+export declare function saveDraft(client: ITelegramClient, chatId: InputPeerLike, draft: null | DraftMessageInput): Promise<void>;

package/highlevel/methods/messages/send-copy-group.cjs

@@ -28,15 +28,11 @@ async function sendCopyGroup(client, params) {
   return sendMediaGroup.sendMediaGroup(
     client,
     toChatId,
-    msgs.map((msg) => {
-      const raw = msg.raw;
-      return {
-        type: "auto",
-        file: msg.media.inputMedia,
-        caption: raw.message,
-        entities: raw.entities
-      };
-    }),
+    msgs.map((msg) => ({
+      type: "auto",
+      file: msg.media.inputMedia,
+      caption: msg.textWithEntities
+    })),
     rest
   );
 }

package/highlevel/methods/messages/send-copy-group.js

@@ -21,15 +21,11 @@ async function sendCopyGroup(client, params) {
   return sendMediaGroup(
     client,
     toChatId,
-    msgs.map((msg) => {
-      const raw = msg.raw;
-      return {
-        type: "auto",
-        file: msg.media.inputMedia,
-        caption: raw.message,
-        entities: raw.entities
-      };
-    }),
+    msgs.map((msg) => ({
+      type: "auto",
+      file: msg.media.inputMedia,
+      caption: msg.textWithEntities
+    })),
     rest
   );
 }