@imessaging/telegram-mtproto 0.8.11 → 0.8.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.8.11",
+  "version": "0.8.13",
   "description": "Telegram MTProto user-account transport for imessaging",
   "keywords": [
     "messaging",
@@ -31,7 +31,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@imessaging/core": "^0.8.9",
+    "@imessaging/core": "^0.8.11",
     "big-integer": "^1.6.52"
   },
   "peerDependencies": {

package/src/incoming.ts

@@ -60,6 +60,8 @@ export type MtprotoMessageLike = {
     lastName?: string;
     title?: string;
     accessHash?: { toString(): string } | string | number;
+    /** Есть только у пользователя (Api.User). */
+    mutualContact?: boolean;
   };
   /** Сущность САМОГО чата из обновления: канал, группа или собеседник. Может не прийти. */
   chat?: {
@@ -325,6 +327,8 @@ export function toIncomingMessage(
     // связывают человека со своей учётной записью.
     senderUsername: message.sender?.username,
     senderName,
+    senderMutualContact:
+      typeof message.sender?.mutualContact === "boolean" ? message.sender.mutualContact : undefined,
     chatTitle,
     chatUsername: message.chat?.username ?? undefined,
     messageId: String(message.id),

package/src/telegram-mtproto-transport.ts

@@ -1,4 +1,6 @@
 import type {
+  ChannelCommand,
+  CommandMenuTransport,
   ContactCard,
   ContactTransport,
   PhoneLookupOptions,
@@ -9,6 +11,8 @@ import type {
   OutgoingObserverTransport,
   OutgoingReadReceipt,
   OutgoingReadReceiptTransport,
+  PeerInfo,
+  PeerInfoTransport,
   ButtonPress,
   ButtonPressTransport,
   IncomingAttachment,
@@ -106,6 +110,18 @@ const OWN_MEMORY_MS = 10 * 60 * 1000;
 /** Номер не занят Telegram или не принят в этой форме — «не найдено», а не отказ. */
 const PHONE_NOT_FOUND_ERRORS = new Set(["PHONE_NOT_OCCUPIED", "PHONE_NUMBER_INVALID"]);
 
+/** @username не занят или записан неверно — «не найдено», а не отказ. */
+const USERNAME_NOT_FOUND_ERRORS = new Set(["USERNAME_NOT_OCCUPIED", "USERNAME_INVALID"]);
+
+function toPeerInfo(user: Api.User): PeerInfo {
+  return {
+    id: user.id.toString(),
+    username: user.username ?? undefined,
+    contact: Boolean(user.contact),
+    mutualContact: Boolean(user.mutualContact),
+  };
+}
+
 /** Номер чата входного пира в том же маркированном виде, что chatId во входящем (peerToChat). */
 function inputPeerChatId(peer: Api.TypeInputPeer): string {
   if (peer instanceof Api.InputPeerChannel) return peerToChat({ channelId: peer.channelId }).chatId;
@@ -114,6 +130,14 @@ function inputPeerChatId(peer: Api.TypeInputPeer): string {
   throw new Error(`Unsupported input peer: ${peer.className}`);
 }
 
+/** Разметка отправки: кнопки, а без них — снятие постоянной клавиатуры по `removeKeyboard`. */
+function sendMarkup(message: OutboundMessage) {
+  return (
+    toGramJsButtons(message.buttons) ??
+    (message.removeKeyboard ? new Api.ReplyKeyboardHide({}) : undefined)
+  );
+}
+
 function toGramJsButtons(buttons?: OutboundButton[][]) {
   if (!buttons || buttons.length === 0) return undefined;
   return buttons.map((row) =>
@@ -127,6 +151,7 @@ function toGramJsButtons(buttons?: OutboundButton[][]) {
 
 export class TelegramMtprotoTransport
   implements
+    CommandMenuTransport,
     ContactTransport,
     DraftTransport,
     EditableMessageTransport,
@@ -135,6 +160,7 @@ export class TelegramMtprotoTransport
     IncomingMessageTransport,
     OutgoingObserverTransport,
     OutgoingReadReceiptTransport,
+    PeerInfoTransport,
     PhoneLookupTransport,
     ReactionTransport,
     ReadReceiptTransport,
@@ -707,6 +733,74 @@ export class TelegramMtprotoTransport
     this.lastActivityAt = new Date();
   }
 
+  /**
+   * Контакт ли собеседник и взаимно ли. Пир берётся из хранилища и кэша клиента, иначе по @username;
+   * по телефону не ищет — это findByPhone.
+   */
+  async peerInfo(recipient: MessageRecipient): Promise<PeerInfo | null> {
+    this.assertConnected();
+    if (recipient.type !== "user" && recipient.type !== "username") return null;
+    const cached = await this.peerStore.get(this.options.accountId, recipient);
+    if (cached && cached.type !== "user") return null;
+    const peer = cached ? this.toInputPeer(cached) : await this.knownInputPeer(recipient);
+    if (peer instanceof Api.InputPeerUser) {
+      const [user] = await this.client.invoke(
+        new Api.users.GetUsers({
+          id: [new Api.InputUser({ userId: peer.userId, accessHash: peer.accessHash })],
+        }),
+      );
+      return user && isUser(user) ? toPeerInfo(user) : null;
+    }
+    if (peer) return null;
+
+    const username = recipient.username?.replace(/^@/, "");
+    if (!username) return null;
+    let result: Api.contacts.ResolvedPeer;
+    try {
+      result = await this.client.invoke(new Api.contacts.ResolveUsername({ username }));
+    } catch (error: unknown) {
+      if (USERNAME_NOT_FOUND_ERRORS.has((error as TelegramRpcError).errorMessage ?? ""))
+        return null;
+      throw error;
+    }
+    const resolved = result.peer;
+    if (!isPeerUser(resolved)) return null;
+    const user = result.users.find(
+      (candidate): candidate is Api.User =>
+        isUser(candidate) && candidate.id.equals(resolved.userId),
+    );
+    if (!user) return null;
+    if (user.accessHash) {
+      await this.peerStore.set(
+        this.options.accountId,
+        recipient,
+        {
+          type: "user",
+          id: user.id.toString(),
+          accessHash: user.accessHash.toString(),
+          username,
+          resolvedAt: new Date().toISOString(),
+        },
+        this.options.peerTtlSeconds,
+      );
+    }
+    return toPeerInfo(user);
+  }
+
+  /** Меню команд бота. Сессия обычной учётки получит отказ Telegram: меню бывает только у бота. */
+  async setCommands(commands: ChannelCommand[]): Promise<void> {
+    this.assertConnected();
+    await this.client.invoke(
+      new Api.bots.SetBotCommands({
+        scope: new Api.BotCommandScopeDefault(),
+        langCode: "",
+        commands: commands.map(
+          (c) => new Api.BotCommand({ command: c.command, description: c.description }),
+        ),
+      }),
+    );
+  }
+
   async disconnect(): Promise<void> {
     await this.client.disconnect();
     this.connected = false;
@@ -869,7 +963,7 @@ export class TelegramMtprotoTransport
         parseMode,
         formattingEntities,
         replyTo: message.replyToMessageId ?? message.threadId,
-        buttons: toGramJsButtons(message.buttons),
+        buttons: sendMarkup(message),
       });
       this.rememberOwn(this.ownSent, peer, sent.id);
       for (const document of message.documents ?? []) {
@@ -882,10 +976,13 @@ export class TelegramMtprotoTransport
         this.rememberOwn(this.ownSent, peer, file.id);
       }
       this.lastActivityAt = new Date();
+      // Получатель есть, только если ответ принёс users: короткий ответ лички (UpdateShortSentMessage) их не несёт.
+      const chat = sent.chat;
       return {
         transportId: this.id,
         messageId: String(sent.id),
         recipientId: this.getPeerId(peer),
+        ...(chat instanceof Api.User ? { mutualContact: Boolean(chat.mutualContact) } : {}),
       };
     } catch (error: unknown) {
       if (retried || !this.isInvalidPeerError(error)) throw error;