@imessaging/telegram-mtproto 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.8.0",
+  "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.8.0",
+    "@imessaging/core": "^0.8.1",
     "big-integer": "^1.6.52"
   },
   "peerDependencies": {

package/src/incoming.ts

@@ -18,6 +18,7 @@ export type MtprotoMessageLike = {
   date?: number | null;
   editDate?: number | null;
   groupedId?: { toString(): string } | null;
+  mentioned?: boolean | null;
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
@@ -298,6 +299,7 @@ export function toIncomingMessage(
     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

@@ -43,6 +43,7 @@ export type TelegramChatSummary = {
   title: string;
   username?: string;
   unreadCount: number;
+  unreadMentions: number;
 };
 
 export type TelegramMtprotoTransportOptions = {
@@ -408,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;
@@ -417,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()
@@ -440,6 +453,28 @@ 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);