@imessaging/core 0.8.3 → 0.8.5

package/package.json

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

package/src/index.ts

@@ -15,10 +15,13 @@ export { MemoryPeerStore } from "./memory-peer-store";
 export { createPeerKey } from "./peer-key";
 export {
   canEdit,
+  canFindByPhone,
   canMarkRead,
   canReact,
   canReceive,
+  canObserveOutgoing,
   canReceiveEdits,
+  canSaveDraft,
   canShowTyping,
   hasCommandMenu,
   isTelegramRecipient,
@@ -37,7 +40,12 @@ export type {
 export type {
   EditableMessage,
   EditableMessageTransport,
+  DraftTransport,
   EditedMessageTransport,
+  MessageDraft,
+  OutgoingObserverTransport,
+  PhoneLookupTransport,
+  PhoneMatch,
   EditResult,
   EmailRecipient,
   HeadhunterRecipient,

package/src/types.ts

@@ -300,6 +300,11 @@ export type IncomingMessage = {
   editedAt?: Date;
   /** В сообщении упомянут аккаунт или это ответ на его сообщение (так Telegram определяет упоминание); нет — канал не сообщает. */
   mentionsMe?: boolean;
+  /**
+   * Только в onOutgoing/onOutgoingEdit: сообщение отправил или поправил сам транспорт (send/edit), а не человек
+   * с другого устройства. Помечается, а не отбрасывается: иначе своя отправка выглядела бы правкой оператора.
+   */
+  sentByTransport?: boolean;
   /**
    * Форматирование текста в той же модели, что исходящая разметка, смещения в UTF-16;
    * undefined = канал не сообщает форматирование, [] = сообщил, форматирования нет.
@@ -367,6 +372,59 @@ export function canReceiveEdits(transport: MessageTransport): transport is Edite
   return typeof (transport as EditedMessageTransport).onEdit === "function";
 }
 
+/** Черновик в поле ввода чата: ответ готовит машина, отправляет человек. */
+export type MessageDraft = {
+  recipient: MessageRecipient;
+  /** Текст черновика; пустой — очистить черновик. */
+  text: string;
+  /** Как написан `text`; не задан — простой текст, без разбора разметки. */
+  format?: TextFormat;
+  /** Черновик ответом на это сообщение. */
+  replyToMessageId?: string;
+};
+
+export interface DraftTransport extends MessageTransport {
+  saveDraft(draft: MessageDraft): Promise<void>;
+}
+
+export function canSaveDraft(transport: MessageTransport): transport is DraftTransport {
+  return typeof (transport as DraftTransport).saveDraft === "function";
+}
+
+/**
+ * Свои исходящие учётки — то, что человек отправил или поправил с другого устройства. Отдельной подпиской:
+ * onMessage и onEdit своё не отдают и отдавать не должны — иначе шлюз отвечал бы сам себе.
+ */
+export interface OutgoingObserverTransport extends MessageTransport {
+  onOutgoing(handler: (message: IncomingMessage) => void | Promise<void>): () => void;
+  onOutgoingEdit(handler: (message: IncomingMessage) => void | Promise<void>): () => void;
+}
+
+export function canObserveOutgoing(
+  transport: MessageTransport,
+): transport is OutgoingObserverTransport {
+  const candidate = transport as OutgoingObserverTransport;
+  return (
+    typeof candidate.onOutgoing === "function" && typeof candidate.onOutgoingEdit === "function"
+  );
+}
+
+/** Учётка, найденная по номеру телефона. */
+export type PhoneMatch = { userId: string; username?: string; firstName?: string };
+
+/**
+ * Поиск учётки по номеру телефона — когда о человеке известен только номер. Найденный пир транспорт
+ * запоминает: следующий send по `{ type: "user", id: userId }` уходит без повторного поиска.
+ */
+export interface PhoneLookupTransport extends MessageTransport {
+  /** Номер — E.164 (`+79991234567`). Не найден — `null`; прочие отказы канала — исключением с его текстом. */
+  findByPhone(phone: string): Promise<PhoneMatch | null>;
+}
+
+export function canFindByPhone(transport: MessageTransport): transport is PhoneLookupTransport {
+  return typeof (transport as PhoneLookupTransport).findByPhone === "function";
+}
+
 /** Пункт меню команд канала: `/menu` и подпись рядом с ним. */
 export type ChannelCommand = {
   /** Без ведущей косой черты. */