@imessaging/core 0.7.1 → 0.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/core",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "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";
+};
+
 /**
  * Входящее сообщение — общий вид для всех каналов.
  *
@@ -234,6 +253,13 @@ export type IncomingMessage = {
   messageId: string;
   text: string;
   attachments: IncomingAttachment[];
+  /**
+   * Адреса из сообщения, в порядке появления.
+   *
+   * `undefined` — канал разметку не разбирает вовсе; пустой список — разобрал и не нашёл. Это
+   * РАЗНЫЕ вещи: первое молчит о своём незнании, второе утверждает, что адресов нет.
+   */
+  links?: IncomingLink[];
   replyToMessageId?: string;
   threadId?: number;
   /**