@imessaging/core 0.8.7 → 0.8.9

package/package.json

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

package/src/index.ts

@@ -18,6 +18,7 @@ export {
   canFindByPhone,
   canSaveContact,
   canMarkRead,
+  canObserveOutgoingRead,
   canReact,
   canReceive,
   canObserveOutgoing,
@@ -35,6 +36,8 @@ export type {
   IncomingLink,
   IncomingMessage,
   IncomingMessageTransport,
+  OutgoingReadReceipt,
+  OutgoingReadReceiptTransport,
   ReadReceiptTransport,
   TypingTransport,
 } from "./types";

package/src/types.ts

@@ -305,6 +305,11 @@ export type IncomingMessage = {
    * с другого устройства. Помечается, а не отбрасывается: иначе своя отправка выглядела бы правкой оператора.
    */
   sentByTransport?: boolean;
+  /**
+   * Сообщение отправила сама учётка — есть в истории (history, messagesByIds), где свои идут вперемешку
+   * с чужими; `undefined` — канал этого не сообщает.
+   */
+  outgoing?: boolean;
   /**
    * Форматирование текста в той же модели, что исходящая разметка, смещения в UTF-16;
    * undefined = канал не сообщает форматирование, [] = сообщил, форматирования нет.
@@ -503,3 +508,22 @@ export interface ReadReceiptTransport extends MessageTransport {
 export function canMarkRead(transport: MessageTransport): transport is ReadReceiptTransport {
   return typeof (transport as ReadReceiptTransport).markRead === "function";
 }
+
+/** Отметка о том, что адресат прочитал наши исходящие сообщения. */
+export type OutgoingReadReceipt = {
+  chatId: string;
+  /** Включительно: все исходящие до этого номера прочтены. */
+  maxMessageId: string;
+  readAt: Date;
+};
+
+/** Канал, умеющий сообщать о прочтении адресатом наших исходящих сообщений. */
+export interface OutgoingReadReceiptTransport extends MessageTransport {
+  onOutgoingRead(handler: (receipt: OutgoingReadReceipt) => void | Promise<void>): () => void;
+}
+
+export function canObserveOutgoingRead(
+  transport: MessageTransport,
+): transport is OutgoingReadReceiptTransport {
+  return typeof (transport as OutgoingReadReceiptTransport).onOutgoingRead === "function";
+}