@imessaging/telegram-mtproto 0.7.2 → 0.7.4

package/package.json

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

package/src/incoming.ts

@@ -14,6 +14,9 @@ export type MtprotoMessageLike = {
   message?: string;
   /** `true` — сообщение отправлено САМОЙ учётной записью. */
   out?: boolean;
+  date?: number;
+  editDate?: number;
+  groupedId?: { toString(): string };
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
@@ -26,7 +29,11 @@ export type MtprotoMessageLike = {
   entities?: MtprotoEntityLike[];
   /** Кнопки под сообщением. У поста в канале здесь `ReplyInlineMarkup`, у остальных пусто. */
   replyMarkup?: { rows?: { buttons?: MtprotoButtonLike[] }[] };
-  replyTo?: { replyToMsgId?: number | string };
+  replyTo?: {
+    replyToMsgId?: number | string;
+    replyToTopId?: number | string;
+    forumTopic?: boolean;
+  };
   /** Заголовок форварда. Пусто — сообщение своё, не пересланное. */
   fwdFrom?: {
     fromId?: MtprotoPeerLike;
@@ -39,7 +46,20 @@ export type MtprotoMessageLike = {
    * Нужен не ради имени: по одному номеру ответить нельзя, пока собеседник клиенту неизвестен, а
    * `accessHash` живёт только здесь. Поле необязательное: в обновлении его может не быть.
    */
-  sender?: { username?: string; accessHash?: { toString(): string } | string | number };
+  sender?: {
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    title?: string;
+    accessHash?: { toString(): string } | string | number;
+  };
+  /** Сущность САМОГО чата из обновления: канал, группа или собеседник. Может не прийти. */
+  chat?: {
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    title?: string;
+  };
   /**
    * Пир отправителя ВМЕСТЕ с `accessHash` — так его отдаёт само обновление.
    *
@@ -231,6 +251,32 @@ export function toIncomingMessage(
       ? chatId
       : null;
 
+  let senderName: string | undefined;
+  if (message.sender) {
+    const parts = [message.sender.firstName, message.sender.lastName].filter(Boolean) as string[];
+    if (parts.length > 0) senderName = parts.join(" ").trim();
+    else if (message.sender.title) senderName = message.sender.title;
+  }
+
+  const chatName = [message.chat?.firstName, message.chat?.lastName]
+    .filter(Boolean)
+    .join(" ")
+    .trim();
+  const chatTitle = message.chat?.title || chatName || undefined;
+
+  let threadId: number | undefined;
+  let replyToMessageId: string | undefined;
+  if (message.replyTo?.forumTopic === true) {
+    threadId = Number(message.replyTo.replyToTopId ?? message.replyTo.replyToMsgId);
+    replyToMessageId =
+      message.replyTo.replyToTopId === undefined ? undefined : String(message.replyTo.replyToMsgId);
+  } else {
+    replyToMessageId =
+      message.replyTo?.replyToMsgId === undefined
+        ? undefined
+        : String(message.replyTo.replyToMsgId);
+  }
+
   return {
     transportId,
     accountId,
@@ -240,14 +286,18 @@ export function toIncomingMessage(
     // Имя отправителя: по нему отвечают, когда номер клиенту неизвестен, и по нему же продукты
     // связывают человека со своей учётной записью.
     senderUsername: message.sender?.username,
+    senderName,
+    chatTitle,
+    chatUsername: message.chat?.username ?? undefined,
     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,
     attachments: collectAttachments(message, chatId),
     links: collectLinks(message),
-    replyToMessageId:
-      message.replyTo?.replyToMsgId === undefined
-        ? undefined
-        : String(message.replyTo.replyToMsgId),
+    replyToMessageId,
+    threadId,
     forwardedFrom: toForwardedFrom(message.fwdFrom),
   };
 }

package/src/index.ts

@@ -1,5 +1,6 @@
 export {
   TelegramMtprotoTransport,
+  type TelegramChatSummary,
   type TelegramMtprotoTransportOptions,
 } from "./telegram-mtproto-transport";
 export {

package/src/telegram-mtproto-transport.ts

@@ -13,6 +13,7 @@ import type {
   ResolvedPeer,
   SendResult,
   TelegramPeerStore,
+  TelegramRecipient,
   TransportStatus,
   TypingTransport,
 } from "@imessaging/core";
@@ -29,10 +30,20 @@ import { StringSession } from "telegram/sessions";
 import {
   downloadFromMessage,
   IncomingDispatcher,
+  toIncomingMessage,
   type DownloadingClient,
   type MtprotoMessageLike,
+  type MtprotoPeerLike,
 } from "./incoming";
 
+export type TelegramChatSummary = {
+  chatId: string;
+  chatType: IncomingMessage["chatType"];
+  title: string;
+  username?: string;
+  unreadCount: number;
+};
+
 export type TelegramMtprotoTransportOptions = {
   accountId: string;
   apiId: number;
@@ -348,6 +359,86 @@ export class TelegramMtprotoTransport
     };
   }
 
+  /**
+   * Диалоги учётки; `query` — подстрока названия без учёта регистра.
+   * Пир каждого диалога запоминается: следующий `history` по chatId не обходит диалоги заново.
+   */
+  async listChats(options?: { query?: string; limit?: number }): Promise<TelegramChatSummary[]> {
+    this.assertConnected();
+    const limit = options?.limit ?? 100;
+    const query = options?.query?.toLowerCase();
+    // С запросом обходим всё: совпадение может лежать в самом конце списка. Без него — ровно limit.
+    const dialogs = await this.client.getDialogs(query === undefined ? { limit } : {});
+    const summaries: TelegramChatSummary[] = [];
+
+    for (const dialog of dialogs) {
+      if (!dialog.entity) continue;
+      const title = dialog.title ?? "";
+      if (query !== undefined && !title.toLowerCase().includes(query)) continue;
+
+      // Супергруппа — тоже канал (isChannel и isGroup сразу), поэтому канал проверяется первым.
+      const entityId = dialog.entity.id.toString();
+      const peerLike: MtprotoPeerLike | undefined = dialog.isChannel
+        ? { channelId: entityId }
+        : dialog.isGroup
+          ? { chatId: entityId }
+          : dialog.isUser
+            ? { userId: entityId }
+            : undefined;
+      if (!peerLike) continue;
+      const { chatId, chatType } = peerToChat(peerLike);
+      const entity = dialog.entity as { accessHash?: { toString(): string }; username?: string };
+      const accessHash = entity.accessHash?.toString();
+      const username = entity.username ?? undefined;
+
+      // У обычной группы access hash не бывает — ей хватает номера, и запомнить её тоже нужно.
+      if (accessHash || chatType === "group") {
+        await this.peerStore.set(
+          this.options.accountId,
+          { type: chatType, id: chatId },
+          {
+            type: chatType,
+            id: chatId,
+            accessHash,
+            username,
+            resolvedAt: new Date().toISOString(),
+          },
+          this.options.peerTtlSeconds,
+        );
+      }
+
+      summaries.push({ chatId, chatType, title, username, unreadCount: dialog.unreadCount });
+      if (summaries.length >= limit) break;
+    }
+    return summaries;
+  }
+
+  /**
+   * Последние `limit` сообщений чата, от старых к новым, ВКЛЮЧАЯ свои — это чтение истории, а не приём.
+   * Служебные события (вход в группу, закреп) пропускаются: текста и вложений у них нет.
+   */
+  async history(
+    recipient: TelegramRecipient,
+    options?: { limit?: number; threadId?: number },
+  ): Promise<IncomingMessage[]> {
+    this.assertConnected();
+    const peer = await this.getInputPeer(recipient);
+    const messages = await this.client.getMessages(peer, {
+      limit: options?.limit ?? 30,
+      replyTo: options?.threadId,
+    });
+    return [...messages]
+      .reverse()
+      .filter((message) => message.className === "Message")
+      .map((message) =>
+        toIncomingMessage(
+          message as unknown as MtprotoMessageLike,
+          this.id,
+          this.options.accountId,
+        ),
+      );
+  }
+
   private async sendWithRetry(message: OutboundMessage, retried: boolean): Promise<SendResult> {
     try {
       const peer = await this.getInputPeer(message.recipient);