@imessaging/core 0.7.1 → 0.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/core",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Core messaging transport contracts and Telegram peer storage",
   "keywords": [
     "messaging",

package/src/index.ts

@@ -13,6 +13,7 @@ export type {
   ChannelCommand,
   CommandMenuTransport,
   IncomingAttachment,
+  IncomingLink,
   IncomingMessage,
   IncomingMessageTransport,
   ReadReceiptTransport,

package/src/types.ts

@@ -217,6 +217,25 @@ export type IncomingAttachment = {
   sizeBytes?: number;
 };
 
+/**
+ * Адрес, вложенный в сообщение.
+ *
+ * Отдельным полем, а не поиском по тексту: половина адресов в тексте НЕ ЛЕЖИТ. Слово со скрытой
+ * гиперссылкой («откликнуться»), надпись на кнопке и предпросмотр страницы приходят сущностями
+ * разметки, и потребитель, разбирающий `text` регулярным выражением, их не увидит вовсе — а
+ * промах здесь выглядит не ошибкой, а вакансией без ссылки.
+ *
+ * Выбор адреса за потребителем: одному нужна площадка, другому форма выгрузки резюме, и решать за
+ * них здесь значит отдавать одному чужое.
+ */
+export type IncomingLink = {
+  url: string;
+  /** Что видит человек на месте адреса: слово гиперссылки или надпись на кнопке. */
+  label?: string;
+  /** Где адрес лежал. Разные места — разный смысл, и «кнопка» отличается от «упомянут в тексте». */
+  origin: "text" | "markup" | "button" | "preview";
+};
+
 /**
  * Входящее сообщение — общий вид для всех каналов.
  *
@@ -231,9 +250,24 @@ export type IncomingMessage = {
   /** Кто написал. `null` — канал отправителя не называет (рассылка, служебное событие). */
   senderId: string | null;
   senderUsername?: string;
+  /** Как отправитель назван в канале: «Имя Фамилия» человека или название чата. */
+  senderName?: string;
   messageId: string;
+  /** Общий у частей одного альбома: Telegram присылает его отдельными сообщениями. */
+  albumId?: string;
   text: string;
+  /** Когда отправлено. Нет — канал время не сообщает. */
+  sentAt?: Date;
+  /** Когда правили последний раз. Нет — не правили. */
+  editedAt?: Date;
   attachments: IncomingAttachment[];
+  /**
+   * Адреса из сообщения, в порядке появления.
+   *
+   * `undefined` — канал разметку не разбирает вовсе; пустой список — разобрал и не нашёл. Это
+   * РАЗНЫЕ вещи: первое молчит о своём незнании, второе утверждает, что адресов нет.
+   */
+  links?: IncomingLink[];
   replyToMessageId?: string;
   threadId?: number;
   /**