@imessaging/telegram-mtproto 0.8.14 → 0.8.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.8.14",
+  "version": "0.8.15",
   "description": "Telegram MTProto user-account transport for imessaging",
   "keywords": [
     "messaging",
@@ -31,10 +31,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@imessaging/core": "^0.8.12",
+    "@imessaging/core": "^0.8.13",
     "big-integer": "^1.6.52"
   },
   "peerDependencies": {
-    "telegram": ">=1.224.1"
+    "telegram": ">=1.229.1"
   }
 }

package/src/incoming.ts

@@ -2,9 +2,12 @@ import type {
   IncomingAttachment,
   IncomingLink,
   IncomingMessage,
+  IncomingMessageKind,
   TextEntity,
   TextEntityType,
 } from "@imessaging/core";
+import type { Api } from "telegram";
+import { renderRichText, toPlainText } from "telegram/richMessage";
 
 /** Пир MTProto в той части, по которой определяется чат. Приходит из `Api.TypePeer`. */
 export type MtprotoPeerLike = {
@@ -27,7 +30,12 @@ export type MtprotoMessageLike = {
   mentioned?: boolean | null;
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
-  media?: MtprotoMediaLike;
+  media?: MtprotoMediaLike | null;
+  /**
+   * «Богатое» сообщение (слой 228+): текст лежит деревом блоков, а `message` пуст.
+   * Слой 224 отдавал такое как MessageMediaUnsupported — текст терялся (замер 16.10.2026).
+   */
+  richMessage?: Api.TypeRichMessage | null;
   /**
    * Разметка текста: жирное, ссылки, упоминания. Отсюда берутся адреса, которых В ТЕКСТЕ НЕТ.
    *
@@ -88,7 +96,14 @@ export type MtprotoMediaLike = {
   document?: {
     mimeType?: string;
     size?: { toString(): string } | number;
-    attributes?: { className?: string; fileName?: string }[];
+    attributes?: {
+      className?: string;
+      fileName?: string;
+      /** DocumentAttributeAudio: голосовое, а не музыка. */
+      voice?: boolean;
+      /** DocumentAttributeVideo: кружок, а не видео. */
+      roundMessage?: boolean;
+    }[];
   };
   photo?: unknown;
   /** Предпросмотр страницы. Вложением НЕ считается: скачивать нечего, адрес есть. */
@@ -104,11 +119,15 @@ export type MtprotoEntityLike = {
   language?: string;
 };
 
-/** Кнопка под сообщением. Адрес несёт только `KeyboardButtonUrl`, у остальных его нет. */
+/**
+ * Кнопка под сообщением. До слоя 229 адрес нёс `KeyboardButtonUrl.url`, с 229 —
+ * `KeyboardInlineButton.type` вида `InlineButtonTypeUrl`.
+ */
 export type MtprotoButtonLike = {
   className?: string;
   text?: string;
   url?: string;
+  type?: { className?: string; url?: string };
 };
 
 /**
@@ -235,13 +254,79 @@ export function collectLinks(message: MtprotoMessageLike): IncomingLink[] {
   }
 
   for (const row of message.replyMarkup?.rows ?? []) {
-    for (const button of row.buttons ?? []) add(button.url, "button", button.text);
+    for (const button of row.buttons ?? [])
+      add(button.url ?? button.type?.url, "button", button.text);
   }
 
+  if (message.richMessage) collectRichLinks(message.richMessage, add);
   add(message.media?.webpage?.url, "preview", message.media?.webpage?.title);
   return links;
 }
 
+/** Адреса из дерева richMessage: TextUrl (адрес в поле) и TextAutoUrl (адрес — сам текст). */
+function collectRichLinks(
+  node: unknown,
+  add: (url: string | undefined, origin: IncomingLink["origin"], label?: string) => void,
+): void {
+  if (Array.isArray(node)) {
+    for (const item of node) collectRichLinks(item, add);
+    return;
+  }
+  if (!node || typeof node !== "object") return;
+  const rich = node as { className?: string; url?: string; text?: Api.TypeRichText };
+  if (rich.className === "TextUrl") {
+    add(rich.url, "markup", renderRichText(rich.text) || undefined);
+    return;
+  }
+  if (rich.className === "TextAutoUrl") {
+    add(renderRichText(rich.text), "text");
+    return;
+  }
+  for (const [key, value] of Object.entries(node)) {
+    // Фото и документы richMessage — медиа, не текст: в них не спускаемся.
+    if (key === "photos" || key === "documents" || key === "originalArgs") continue;
+    if (value && typeof value === "object") collectRichLinks(value, add);
+  }
+}
+
+/** Текст сообщения: обычный `message`, а если он пуст — плоский текст блоков richMessage. */
+export function messageText(message: MtprotoMessageLike): string {
+  if (message.message) return message.message;
+  if (message.richMessage?.className === "RichMessage") return toPlainText(message.richMessage);
+  return "";
+}
+
+/** Вид содержимого по media. Голосовое и кружок различаются только атрибутами документа. */
+export function messageKind(message: MtprotoMessageLike): IncomingMessageKind {
+  const media = message.media;
+  if (!media || media.className === "MessageMediaWebPage") return "text";
+  switch (media.className) {
+    case "MessageMediaPhoto":
+      return "photo";
+    case "MessageMediaPoll":
+      return "poll";
+    case "MessageMediaContact":
+      return "contact";
+    case "MessageMediaGeo":
+    case "MessageMediaGeoLive":
+    case "MessageMediaVenue":
+      return "geo";
+    case "MessageMediaUnsupported":
+      return "unsupported";
+  }
+  if (media.document) {
+    const attributes = media.document.attributes ?? [];
+    const has = (name: string) => attributes.find((attribute) => attribute.className === name);
+    if (has("DocumentAttributeAudio")?.voice) return "voice";
+    if (has("DocumentAttributeSticker")) return "sticker";
+    const video = has("DocumentAttributeVideo");
+    if (video?.roundMessage) return "video_note";
+    if (video) return "video";
+    return "document";
+  }
+  return "other";
+}
+
 const FORMATTING: Record<string, TextEntityType> = {
   MessageEntityBold: "bold",
   MessageEntityItalic: "italic",
@@ -333,7 +418,8 @@ export function toIncomingMessage(
     chatUsername: message.chat?.username ?? undefined,
     messageId: String(message.id),
     albumId: message.groupedId?.toString(),
-    text: message.message ?? "",
+    text: messageText(message),
+    kind: messageKind(message),
     sentAt: message.date ? new Date(message.date * 1000) : undefined,
     // Непоправленное сообщение приходит с `editDate: null` — это не правка в 1970 году.
     editedAt: message.editDate ? new Date(message.editDate * 1000) : undefined,

package/src/index.ts

@@ -6,6 +6,8 @@ export {
 export {
   collectAttachments,
   collectLinks,
+  messageKind,
+  messageText,
   downloadFromMessage,
   formattingEntities,
   IncomingDispatcher,