@imessaging/telegram-mtproto 0.7.1 → 0.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "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.2",
     "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 = {
@@ -17,6 +17,15 @@ export type MtprotoMessageLike = {
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
+  /**
+   * Разметка текста: жирное, ссылки, упоминания. Отсюда берутся адреса, которых В ТЕКСТЕ НЕТ.
+   *
+   * Смещения Telegram считает в кодовых единицах UTF-16 — тех же, которыми режет строку JS, так
+   * что `slice` по ним точен. Считать в символах значило бы промахиваться на каждом эмодзи.
+   */
+  entities?: MtprotoEntityLike[];
+  /** Кнопки под сообщением. У поста в канале здесь `ReplyInlineMarkup`, у остальных пусто. */
+  replyMarkup?: { rows?: { buttons?: MtprotoButtonLike[] }[] };
   replyTo?: { replyToMsgId?: number | string };
   /** Заголовок форварда. Пусто — сообщение своё, не пересланное. */
   fwdFrom?: {
@@ -52,6 +61,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 +122,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 +170,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;
+}
+
 /**
  * Сообщение живой учётной записи → общий вид.
  *
@@ -178,6 +243,7 @@ export function toIncomingMessage(
     messageId: String(message.id),
     text: message.message ?? "",
     attachments: collectAttachments(message, chatId),
+    links: collectLinks(message),
     replyToMessageId:
       message.replyTo?.replyToMsgId === undefined
         ? undefined

package/src/index.ts

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