@imessaging/core 0.8.6 → 0.8.8

package/package.json

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

package/src/index.ts

@@ -16,6 +16,7 @@ export { createPeerKey } from "./peer-key";
 export {
   canEdit,
   canFindByPhone,
+  canSaveContact,
   canMarkRead,
   canReact,
   canReceive,
@@ -40,6 +41,8 @@ export type {
 export type {
   EditableMessage,
   EditableMessageTransport,
+  ContactCard,
+  ContactTransport,
   DraftTransport,
   EditedMessageTransport,
   MessageDraft,

package/src/types.ts

@@ -305,6 +305,11 @@ export type IncomingMessage = {
    * с другого устройства. Помечается, а не отбрасывается: иначе своя отправка выглядела бы правкой оператора.
    */
   sentByTransport?: boolean;
+  /**
+   * Сообщение отправила сама учётка — есть в истории (history, messagesByIds), где свои идут вперемешку
+   * с чужими; `undefined` — канал этого не сообщает.
+   */
+  outgoing?: boolean;
   /**
    * Форматирование текста в той же модели, что исходящая разметка, смещения в UTF-16;
    * undefined = канал не сообщает форматирование, [] = сообщил, форматирования нет.
@@ -436,6 +441,25 @@ export function canFindByPhone(transport: MessageTransport): transport is PhoneL
   return typeof (transport as PhoneLookupTransport).findByPhone === "function";
 }
 
+/** Карточка контакта в адресной книге учётки: имя и заметка о человеке, текст заметки даёт продукт. */
+export type ContactCard = {
+  userId: string;
+  /** E.164; нужен, только если номер ещё не известен учётке. */
+  phone?: string;
+  firstName: string;
+  lastName?: string;
+  note?: string;
+};
+
+/** Сохранить или обновить контакт — тем же вызовом: есть контакт — имя и заметка перезаписываются. */
+export interface ContactTransport extends MessageTransport {
+  saveContact(contact: ContactCard): Promise<void>;
+}
+
+export function canSaveContact(transport: MessageTransport): transport is ContactTransport {
+  return typeof (transport as ContactTransport).saveContact === "function";
+}
+
 /** Пункт меню команд канала: `/menu` и подпись рядом с ним. */
 export type ChannelCommand = {
   /** Без ведущей косой черты. */