@imessaging/core 0.5.0 → 0.6.0

package/package.json

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

package/src/index.ts

@@ -1,6 +1,13 @@
 export { MemoryPeerStore } from "./memory-peer-store";
 export { createPeerKey } from "./peer-key";
-export { canEdit, canReceive, canShowTyping, hasCommandMenu, isTelegramRecipient } from "./types";
+export {
+  canEdit,
+  canMarkRead,
+  canReceive,
+  canShowTyping,
+  hasCommandMenu,
+  isTelegramRecipient,
+} from "./types";
 export type { ButtonPress, ButtonPressTransport } from "./types";
 export type {
   ChannelCommand,
@@ -8,6 +15,7 @@ export type {
   IncomingAttachment,
   IncomingMessage,
   IncomingMessageTransport,
+  ReadReceiptTransport,
   TypingTransport,
 } from "./types";
 export type {

package/src/types.ts

@@ -152,6 +152,14 @@ export interface TelegramPeerStore {
 export type ButtonPress = {
   /** Кто нажал. `null` — отправитель неизвестен каналу. */
   senderId: number | null;
+  /**
+   * В каком чате нажали. `undefined` — канал чата не назвал.
+   *
+   * Нужен затем, что нажатие и сообщение одного чата обязаны исполняться по очереди: карточка
+   * живёт в чате, и ответ на кнопку, обогнавший идущий ответ агента, приходит человеку раньше того,
+   * на что он отвечает. По одному отправителю это не построить — в группе он не равен чату.
+   */
+  chatId?: string;
   data: string;
   /**
    * Подтвердить нажатие, показав человеку текст.
@@ -259,3 +267,18 @@ export interface TypingTransport extends MessageTransport {
 export function canShowTyping(transport: MessageTransport): transport is TypingTransport {
   return typeof (transport as TypingTransport).typing === "function";
 }
+
+/**
+ * Канал, умеющий отметить сообщение прочитанным.
+ *
+ * Не украшение: пока отметки нет, у собеседника горит непрочитанное, а у бота или учётной записи
+ * копится счётчик, по которому потом не отличить обработанное от пропущенного.
+ */
+export interface ReadReceiptTransport extends MessageTransport {
+  /** Отметить прочитанным всё до `messageId` включительно. */
+  markRead(recipient: MessageRecipient, messageId: string): Promise<void>;
+}
+
+export function canMarkRead(transport: MessageTransport): transport is ReadReceiptTransport {
+  return typeof (transport as ReadReceiptTransport).markRead === "function";
+}