@imessaging/core 0.7.0 → 0.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/core",
-  "version": "0.7.0",
+  "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,8 +253,33 @@ export type IncomingMessage = {
   messageId: string;
   text: string;
   attachments: IncomingAttachment[];
+  /**
+   * Адреса из сообщения, в порядке появления.
+   *
+   * `undefined` — канал разметку не разбирает вовсе; пустой список — разобрал и не нашёл. Это
+   * РАЗНЫЕ вещи: первое молчит о своём незнании, второе утверждает, что адресов нет.
+   */
+  links?: IncomingLink[];
   replyToMessageId?: string;
   threadId?: number;
+  /**
+   * Откуда сообщение переслано. Есть только у форварда.
+   *
+   * Нужно не для истории: в канале-агрегаторе лежат ЧУЖИЕ сообщения, и владелец вакансии —
+   * канал-источник, а не тот, в котором она оказалась. Без этого поля продукт приписал бы её
+   * агрегатору, то есть не тому заказчику.
+   *
+   * `chatId` может отсутствовать: автор форварда вправе скрыть источник — тогда известно только
+   * имя (`title`), а иногда и его нет.
+   */
+  forwardedFrom?: {
+    chatId?: string;
+    chatType?: IncomingMessage["chatType"];
+    /** Как назван источник в самом форварде: имя канала или человека. */
+    title?: string;
+    /** Номер сообщения в источнике, если он известен. */
+    messageId?: string;
+  };
 };
 
 /**