@imessaging/telegram-mtproto 0.7.4 → 0.8.1

package/package.json

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

package/src/entities.ts

@@ -0,0 +1,27 @@
+import { Api } from "telegram";
+import type { FormattedText } from "@imessaging/core";
+
+/**
+ * Выделения FormattedText → сущности MTProto. Смещения у обоих в UTF-16, переводить их не нужно.
+ */
+export function toTelegramEntities(ft: FormattedText): Api.TypeMessageEntity[] {
+  return ft.entities.map((e) => {
+    const base = { offset: e.offset, length: e.length };
+    switch (e.type) {
+      case "bold":
+        return new Api.MessageEntityBold(base);
+      case "italic":
+        return new Api.MessageEntityItalic(base);
+      case "underline":
+        return new Api.MessageEntityUnderline(base);
+      case "strike":
+        return new Api.MessageEntityStrike(base);
+      case "code":
+        return new Api.MessageEntityCode(base);
+      case "pre":
+        return new Api.MessageEntityPre({ ...base, language: e.language ?? "" });
+      case "link":
+        return new Api.MessageEntityTextUrl({ ...base, url: e.url ?? "" });
+    }
+  });
+}

package/src/incoming.ts

@@ -14,9 +14,11 @@ export type MtprotoMessageLike = {
   message?: string;
   /** `true` — сообщение отправлено САМОЙ учётной записью. */
   out?: boolean;
-  date?: number;
-  editDate?: number;
-  groupedId?: { toString(): string };
+  // gramjs отдаёт отсутствующее поле как `null`, а не `undefined`: проверки ниже — на оба.
+  date?: number | null;
+  editDate?: number | null;
+  groupedId?: { toString(): string } | null;
+  mentioned?: boolean | null;
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
@@ -31,7 +33,7 @@ export type MtprotoMessageLike = {
   replyMarkup?: { rows?: { buttons?: MtprotoButtonLike[] }[] };
   replyTo?: {
     replyToMsgId?: number | string;
-    replyToTopId?: number | string;
+    replyToTopId?: number | string | null;
     forumTopic?: boolean;
   };
   /** Заголовок форварда. Пусто — сообщение своё, не пересланное. */
@@ -269,7 +271,7 @@ export function toIncomingMessage(
   if (message.replyTo?.forumTopic === true) {
     threadId = Number(message.replyTo.replyToTopId ?? message.replyTo.replyToMsgId);
     replyToMessageId =
-      message.replyTo.replyToTopId === undefined ? undefined : String(message.replyTo.replyToMsgId);
+      message.replyTo.replyToTopId == null ? undefined : String(message.replyTo.replyToMsgId);
   } else {
     replyToMessageId =
       message.replyTo?.replyToMsgId === undefined
@@ -292,10 +294,12 @@ export function toIncomingMessage(
     messageId: String(message.id),
     albumId: message.groupedId?.toString(),
     text: message.message ?? "",
-    sentAt: message.date !== undefined ? new Date(message.date * 1000) : undefined,
-    editedAt: message.editDate !== undefined ? new Date(message.editDate * 1000) : undefined,
+    sentAt: message.date ? new Date(message.date * 1000) : undefined,
+    // Непоправленное сообщение приходит с `editDate: null` — это не правка в 1970 году.
+    editedAt: message.editDate ? new Date(message.editDate * 1000) : undefined,
     attachments: collectAttachments(message, chatId),
     links: collectLinks(message),
+    mentionsMe: typeof message.mentioned === "boolean" ? message.mentioned : undefined,
     replyToMessageId,
     threadId,
     forwardedFrom: toForwardedFrom(message.fwdFrom),

package/src/telegram-mtproto-transport.ts

@@ -17,7 +17,8 @@ import type {
   TransportStatus,
   TypingTransport,
 } from "@imessaging/core";
-import { isTelegramRecipient, MemoryPeerStore } from "@imessaging/core";
+import { isTelegramRecipient, MemoryPeerStore, formattedOf } from "@imessaging/core";
+import { toTelegramEntities } from "./entities";
 import { peerToChat, unmarkPeerId } from "./incoming";
 import bigInt from "big-integer";
 import { Api, TelegramClient } from "telegram";
@@ -42,6 +43,7 @@ export type TelegramChatSummary = {
   title: string;
   username?: string;
   unreadCount: number;
+  unreadMentions: number;
 };
 
 export type TelegramMtprotoTransportOptions = {
@@ -407,7 +409,14 @@ export class TelegramMtprotoTransport
         );
       }
 
-      summaries.push({ chatId, chatType, title, username, unreadCount: dialog.unreadCount });
+      summaries.push({
+        chatId,
+        chatType,
+        title,
+        username,
+        unreadCount: dialog.unreadCount,
+        unreadMentions: dialog.unreadMentionsCount ?? 0,
+      });
       if (summaries.length >= limit) break;
     }
     return summaries;
@@ -416,16 +425,21 @@ export class TelegramMtprotoTransport
   /**
    * Последние `limit` сообщений чата, от старых к новым, ВКЛЮЧАЯ свои — это чтение истории, а не приём.
    * Служебные события (вход в группу, закреп) пропускаются: текста и вложений у них нет.
+   *
+   * @param options.mentionsOnly Только упоминания аккаунта. Фильтр работает на уровне всего чата;
+   *                             вызывающий код должен сам отфильтровать результат по `threadId`.
    */
   async history(
     recipient: TelegramRecipient,
-    options?: { limit?: number; threadId?: number },
+    options?: { limit?: number; threadId?: number; mentionsOnly?: boolean },
   ): Promise<IncomingMessage[]> {
     this.assertConnected();
     const peer = await this.getInputPeer(recipient);
+    // gramjs игнорирует filter, если передан replyTo, поэтому для mentionsOnly replyTo не передаём
     const messages = await this.client.getMessages(peer, {
       limit: options?.limit ?? 30,
-      replyTo: options?.threadId,
+      replyTo: options?.mentionsOnly ? undefined : options?.threadId,
+      filter: options?.mentionsOnly ? new Api.InputMessagesFilterMyMentions() : undefined,
     });
     return [...messages]
       .reverse()
@@ -439,12 +453,40 @@ export class TelegramMtprotoTransport
       );
   }
 
+  /**
+   * Запросить конкретные сообщения по их номерам.
+   * Контекст для упоминаний, то есть сообщение, на которое кто-то ответил.
+   * Если запросить пустой список, вернёт `[]` без сетевых вызовов (но после проверки соединения).
+   */
+  async messagesByIds(recipient: TelegramRecipient, ids: number[]): Promise<IncomingMessage[]> {
+    this.assertConnected();
+    if (ids.length === 0) return [];
+    const peer = await this.getInputPeer(recipient);
+    const messages = await this.client.getMessages(peer, { ids });
+    return messages
+      .filter((message) => message && message.className === "Message")
+      .map((message) =>
+        toIncomingMessage(
+          message as unknown as MtprotoMessageLike,
+          this.id,
+          this.options.accountId,
+        ),
+      )
+      .sort((a, b) => Number(a.messageId) - Number(b.messageId));
+  }
+
   private async sendWithRetry(message: OutboundMessage, retried: boolean): Promise<SendResult> {
     try {
       const peer = await this.getInputPeer(message.recipient);
+      // С `format` уходят готовые выделения: gramjs тогда не разбирает текст своим markdown вовсе.
+      const ft = formattedOf(message);
+      const text = ft ? ft.text : message.text;
+      const parseMode = ft ? undefined : message.parseMode?.toLowerCase();
+      const formattingEntities = ft ? toTelegramEntities(ft) : undefined;
       const sent = await this.client.sendMessage(peer, {
-        message: message.text,
-        parseMode: message.parseMode?.toLowerCase(),
+        message: text,
+        parseMode,
+        formattingEntities,
         replyTo: message.replyToMessageId ?? message.threadId,
       });
       for (const document of message.documents ?? []) {
@@ -604,12 +646,17 @@ export class TelegramMtprotoTransport
     let peer: Api.TypeInputPeer | null = null;
     try {
       peer = await this.getInputPeer(message.recipient);
+      const ft = formattedOf(message);
+      const text = ft ? ft.text : message.text;
+      const parseMode = ft ? undefined : message.parseMode?.toLowerCase();
+      const formattingEntities = ft ? toTelegramEntities(ft) : undefined;
       // Кнопки здесь не передаются — ровно как и при отправке этим транспортом: inline-клавиатуру
       // MTProto-аккаунт не рисует. Передать их сюда значило бы обещать разметку, которой не будет.
       await this.client.editMessage(peer, {
         message: messageId,
-        text: message.text,
-        parseMode: message.parseMode?.toLowerCase(),
+        text,
+        parseMode,
+        formattingEntities,
       });
       this.lastActivityAt = new Date();
       return {