@imessaging/telegram-mtproto 0.8.0 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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.2",
     "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

@@ -8,8 +8,10 @@ import type {
   EditableMessage,
   EditableMessageTransport,
   EditResult,
+  MessageReaction,
   MessageRecipient,
   OutboundMessage,
+  ReactionTransport,
   ResolvedPeer,
   SendResult,
   TelegramPeerStore,
@@ -43,6 +45,7 @@ export type TelegramChatSummary = {
   title: string;
   username?: string;
   unreadCount: number;
+  unreadMentions: number;
 };
 
 export type TelegramMtprotoTransportOptions = {
@@ -88,6 +91,7 @@ export class TelegramMtprotoTransport
     EditableMessageTransport,
     ButtonPressTransport,
     IncomingMessageTransport,
+    ReactionTransport,
     ReadReceiptTransport,
     TypingTransport
 {
@@ -325,6 +329,29 @@ export class TelegramMtprotoTransport
     );
   }
 
+  async react(reaction: MessageReaction): Promise<void> {
+    this.assertConnected();
+    if (!isTelegramRecipient(reaction.recipient)) {
+      if (reaction.recipient.type === "email") {
+        throw new Error("Telegram MTProto cannot react to an email");
+      }
+      throw new Error(`Telegram MTProto cannot react to ${reaction.recipient.type}`);
+    }
+    const messageId = Number(reaction.messageId);
+    if (!Number.isSafeInteger(messageId) || messageId <= 0) {
+      throw new Error(`Telegram message id must be a positive integer: ${reaction.messageId}`);
+    }
+    const peer = await this.getInputPeer(reaction.recipient);
+    await this.client.invoke(
+      new Api.messages.SendReaction({
+        peer,
+        msgId: messageId,
+        reaction: reaction.emoji ? [new Api.ReactionEmoji({ emoticon: reaction.emoji })] : [],
+      }),
+    );
+    this.lastActivityAt = new Date();
+  }
+
   async disconnect(): Promise<void> {
     await this.client.disconnect();
     this.connected = false;
@@ -408,7 +435,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 +451,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 +479,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);