@imessaging/core 0.8.11 → 0.8.13

package/package.json

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

package/src/index.ts

@@ -26,6 +26,7 @@ export {
   canReceiveEdits,
   canSaveDraft,
   canShowTyping,
+  canTellSelf,
   hasCommandMenu,
   isTelegramRecipient,
 } from "./types";
@@ -36,6 +37,7 @@ export type {
   IncomingAttachment,
   IncomingLink,
   IncomingMessage,
+  IncomingMessageKind,
   IncomingMessageTransport,
   OutgoingReadReceipt,
   OutgoingReadReceiptTransport,
@@ -68,6 +70,8 @@ export type {
   OutboundMessage,
   ReactionTransport,
   ResolvedPeer,
+  SelfAccount,
+  SelfAwareTransport,
   SendResult,
   TelegramPeerStore,
   TelegramRecipient,

package/src/types.ts

@@ -280,6 +280,21 @@ export type IncomingLink = {
  * `transportId` и `accountId` входят В САМО сообщение, а не подставляются потребителем: один
  * продукт слушает несколько учёток сразу, и `chatId` уникален только внутри пары «канал + учётка».
  */
+/** Что лежит в сообщении. `unsupported` — клиент такой вид не знает, `other` — знает, но отдельного кода нет. */
+export type IncomingMessageKind =
+  | "text"
+  | "voice"
+  | "video_note"
+  | "sticker"
+  | "poll"
+  | "contact"
+  | "geo"
+  | "photo"
+  | "video"
+  | "document"
+  | "unsupported"
+  | "other";
+
 export type IncomingMessage = {
   transportId: string;
   accountId: string;
@@ -303,6 +318,8 @@ export type IncomingMessage = {
   /** Общий у частей одного альбома: Telegram присылает его отдельными сообщениями. */
   albumId?: string;
   text: string;
+  /** Вид содержимого: голосовое, кружок, опрос… Нет — канал вид не сообщает. */
+  kind?: IncomingMessageKind;
   /** Когда отправлено. Нет — канал время не сообщает. */
   sentAt?: Date;
   /** Когда правили последний раз. Нет — не правили. */
@@ -470,6 +487,22 @@ export function canGetPeerInfo(transport: MessageTransport): transport is PeerIn
   return typeof (transport as PeerInfoTransport).peerInfo === "function";
 }
 
+/** Учётка, под которой работает транспорт: по ней отличают свои сообщения от чужих. */
+export type SelfAccount = {
+  id: string;
+  username?: string;
+  isBot: boolean;
+};
+
+/** Транспорт знает свою учётку. Ответ кэшируется: повторный вызов не ходит в сеть. */
+export interface SelfAwareTransport extends MessageTransport {
+  self(): Promise<SelfAccount>;
+}
+
+export function canTellSelf(transport: MessageTransport): transport is SelfAwareTransport {
+  return typeof (transport as SelfAwareTransport).self === "function";
+}
+
 /** Карточка контакта в адресной книге учётки: имя и заметка о человеке, текст заметки даёт продукт. */
 export type ContactCard = {
   userId: string;