@imessaging/core 0.8.8 → 0.8.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/core",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "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

@@ -84,6 +84,11 @@ export type OutboundMessage = {
   threadId?: number;
   documents?: OutboundDocument[];
   buttons?: OutboundButton[][];
+  /**
+   * Снять постоянную клавиатуру (ReplyKeyboardMarkup) у собеседника. Действует без `buttons`;
+   * канал без такой клавиатуры поле не замечает.
+   */
+  removeKeyboard?: boolean;
   /**
    * Как написан `text`: транспорт сам переводит разметку в формат своего канала — Telegram и MAX
    * получают выделения, почта HTML и простой текст, hh простой текст. Не задан — прежнее поведение
@@ -508,3 +513,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";
+}