@imessaging/telegram-mtproto 0.8.12 → 0.8.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.8.12",
+  "version": "0.8.14",
   "description": "Telegram MTProto user-account transport for imessaging",
   "keywords": [
     "messaging",
@@ -31,7 +31,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@imessaging/core": "^0.8.10",
+    "@imessaging/core": "^0.8.12",
     "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

@@ -11,6 +11,8 @@ import type {
   OutgoingObserverTransport,
   OutgoingReadReceipt,
   OutgoingReadReceiptTransport,
+  PeerInfo,
+  PeerInfoTransport,
   ButtonPress,
   ButtonPressTransport,
   IncomingAttachment,
@@ -27,6 +29,8 @@ import type {
   OutboundMessage,
   ReactionTransport,
   ResolvedPeer,
+  SelfAccount,
+  SelfAwareTransport,
   SendResult,
   TelegramPeerStore,
   TelegramRecipient,
@@ -108,6 +112,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;
@@ -146,8 +162,10 @@ export class TelegramMtprotoTransport
     IncomingMessageTransport,
     OutgoingObserverTransport,
     OutgoingReadReceiptTransport,
+    PeerInfoTransport,
     PhoneLookupTransport,
     ReactionTransport,
+    SelfAwareTransport,
     ReadReceiptTransport,
     TypingTransport
 {
@@ -176,6 +194,8 @@ export class TelegramMtprotoTransport
   private readonly ownEdited = new Map<string, number>();
   /** Идущие send/edit: обновление о своём сообщении может прийти раньше, чем вызов вернёт его номер. */
   private readonly ownPending = new Set<Promise<unknown>>();
+  /** Своя учётка: не меняется за жизнь сессии, спрашивается один раз. */
+  private selfAccount?: Promise<SelfAccount>;
   /** Отметка жизни подписки: срабатывает на любом обновлении, включая служебные. */
   private activityListener: ((event: unknown) => void) | null = null;
 
@@ -718,6 +738,80 @@ export class TelegramMtprotoTransport
     this.lastActivityAt = new Date();
   }
 
+  /** Своя учётка — users.GetUsers(InputUserSelf); удачный ответ кэшируется, отказ — нет. */
+  async self(): Promise<SelfAccount> {
+    this.assertConnected();
+    this.selfAccount ??= this.client
+      .invoke(new Api.users.GetUsers({ id: [new Api.InputUserSelf()] }))
+      .then(([user]) => {
+        if (!user || !isUser(user)) throw new Error("users.GetUsers(self) returned no user");
+        return {
+          id: user.id.toString(),
+          ...(user.username ? { username: user.username } : {}),
+          isBot: user.bot === true,
+        };
+      })
+      .catch((error: unknown) => {
+        this.selfAccount = undefined;
+        throw error;
+      });
+    return this.selfAccount;
+  }
+
+  /**
+   * Контакт ли собеседник и взаимно ли. Пир берётся из хранилища и кэша клиента, иначе по @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();
@@ -907,10 +1001,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;