@imessaging/telegram-mtproto 0.7.1 → 0.7.3

package/package.json

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

package/src/incoming.ts

@@ -1,4 +1,4 @@
-import type { IncomingAttachment, IncomingMessage } from "@imessaging/core";
+import type { IncomingAttachment, IncomingLink, IncomingMessage } from "@imessaging/core";
 
 /** Пир MTProto в той части, по которой определяется чат. Приходит из `Api.TypePeer`. */
 export type MtprotoPeerLike = {
@@ -14,10 +14,26 @@ export type MtprotoMessageLike = {
   message?: string;
   /** `true` — сообщение отправлено САМОЙ учётной записью. */
   out?: boolean;
+  date?: number;
+  editDate?: number;
+  groupedId?: { toString(): string };
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
-  replyTo?: { replyToMsgId?: number | string };
+  /**
+   * Разметка текста: жирное, ссылки, упоминания. Отсюда берутся адреса, которых В ТЕКСТЕ НЕТ.
+   *
+   * Смещения Telegram считает в кодовых единицах UTF-16 — тех же, которыми режет строку JS, так
+   * что `slice` по ним точен. Считать в символах значило бы промахиваться на каждом эмодзи.
+   */
+  entities?: MtprotoEntityLike[];
+  /** Кнопки под сообщением. У поста в канале здесь `ReplyInlineMarkup`, у остальных пусто. */
+  replyMarkup?: { rows?: { buttons?: MtprotoButtonLike[] }[] };
+  replyTo?: {
+    replyToMsgId?: number | string;
+    replyToTopId?: number | string;
+    forumTopic?: boolean;
+  };
   /** Заголовок форварда. Пусто — сообщение своё, не пересланное. */
   fwdFrom?: {
     fromId?: MtprotoPeerLike;
@@ -30,7 +46,13 @@ 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;
+  };
   /**
    * Пир отправителя ВМЕСТЕ с `accessHash` — так его отдаёт само обновление.
    *
@@ -52,6 +74,23 @@ export type MtprotoMediaLike = {
     attributes?: { className?: string; fileName?: string }[];
   };
   photo?: unknown;
+  /** Предпросмотр страницы. Вложением НЕ считается: скачивать нечего, адрес есть. */
+  webpage?: { className?: string; url?: string; displayUrl?: string; title?: string };
+};
+
+/** Сущность разметки. `url` есть только у скрытой гиперссылки (`MessageEntityTextUrl`). */
+export type MtprotoEntityLike = {
+  className?: string;
+  offset?: number;
+  length?: number;
+  url?: string;
+};
+
+/** Кнопка под сообщением. Адрес несёт только `KeyboardButtonUrl`, у остальных его нет. */
+export type MtprotoButtonLike = {
+  className?: string;
+  text?: string;
+  url?: string;
 };
 
 /**
@@ -96,9 +135,7 @@ export function unmarkPeerId(chatId: string): string {
  * Пир источника МОЖЕТ отсутствовать: автор форварда вправе скрыть его. Тогда остаётся имя, а
  * иногда и оно пустое — и это честнее выдумывания, чем подстановка чата, в котором сообщение лежит.
  */
-function toForwardedFrom(
-  fwdFrom: MtprotoMessageLike["fwdFrom"],
-): IncomingMessage["forwardedFrom"] {
+function toForwardedFrom(fwdFrom: MtprotoMessageLike["fwdFrom"]): IncomingMessage["forwardedFrom"] {
   if (!fwdFrom) return undefined;
   const peer = fwdFrom.fromId ? peerToChat(fwdFrom.fromId) : null;
   return {
@@ -146,6 +183,47 @@ export function collectAttachments(
   return [];
 }
 
+/**
+ * Адреса из сообщения: текст, скрытые гиперссылки, кнопки, предпросмотр.
+ *
+ * Разбирается ЗДЕСЬ, а не у потребителя, по одной причине: половины этих адресов в тексте нет.
+ * Слово «откликнуться» со скрытой ссылкой, надпись на кнопке и предпросмотр живут в разметке, и
+ * поиск регулярным выражением по `text` не находит их ВООБЩЕ — а выглядит это не промахом
+ * разбора, а вакансией без ссылки. Замер 16.09.2026 по боевой базе italent: у всех 379 вакансий,
+ * приехавших шлюзом, поле адреса пустое, тогда как у 8190 прежних оно заполнено.
+ *
+ * Повторы снимаются по адресу: один и тот же URL часто и в тексте, и в предпросмотре, и
+ * потребитель, считающий их разными, показал бы человеку две одинаковые ссылки.
+ */
+export function collectLinks(message: MtprotoMessageLike): IncomingLink[] {
+  const text = message.message ?? "";
+  const links: IncomingLink[] = [];
+  const seen = new Set<string>();
+  const add = (url: string | undefined, origin: IncomingLink["origin"], label?: string): void => {
+    const trimmed = url?.trim();
+    if (!trimmed || seen.has(trimmed)) return;
+    seen.add(trimmed);
+    links.push(label ? { url: trimmed, label, origin } : { url: trimmed, origin });
+  };
+
+  // Порядок — как в сообщении: смещения приходят по возрастанию, но полагаться на это не надо.
+  const entities = [...(message.entities ?? [])].sort((a, b) => (a.offset ?? 0) - (b.offset ?? 0));
+  for (const entity of entities) {
+    const shown = text.slice(entity.offset ?? 0, (entity.offset ?? 0) + (entity.length ?? 0));
+    // Голый адрес: Telegram размечает его сам, и сам адрес — это и есть показанный текст.
+    if (entity.className === "MessageEntityUrl") add(shown, "text");
+    // Скрытая гиперссылка: адрес в поле, а показанное слово — подпись к нему.
+    if (entity.className === "MessageEntityTextUrl") add(entity.url, "markup", shown || undefined);
+  }
+
+  for (const row of message.replyMarkup?.rows ?? []) {
+    for (const button of row.buttons ?? []) add(button.url, "button", button.text);
+  }
+
+  add(message.media?.webpage?.url, "preview", message.media?.webpage?.title);
+  return links;
+}
+
 /**
  * Сообщение живой учётной записи → общий вид.
  *
@@ -166,6 +244,26 @@ 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;
+  }
+
+  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,
@@ -175,13 +273,16 @@ export function toIncomingMessage(
     // Имя отправителя: по нему отвечают, когда номер клиенту неизвестен, и по нему же продукты
     // связывают человека со своей учётной записью.
     senderUsername: message.sender?.username,
+    senderName,
     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),
-    replyToMessageId:
-      message.replyTo?.replyToMsgId === undefined
-        ? undefined
-        : String(message.replyTo.replyToMsgId),
+    links: collectLinks(message),
+    replyToMessageId,
+    threadId,
     forwardedFrom: toForwardedFrom(message.fwdFrom),
   };
 }

package/src/index.ts

@@ -1,15 +1,19 @@
 export {
   TelegramMtprotoTransport,
+  type TelegramChatSummary,
   type TelegramMtprotoTransportOptions,
 } from "./telegram-mtproto-transport";
 export {
   collectAttachments,
+  collectLinks,
   downloadFromMessage,
   IncomingDispatcher,
   peerToChat,
   unmarkPeerId,
   toIncomingMessage,
   type DownloadingClient,
+  type MtprotoButtonLike,
+  type MtprotoEntityLike,
   type MtprotoMediaLike,
   type MtprotoMessageLike,
   type MtprotoPeerLike,

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);