@imessaging/core 0.8.4 → 0.8.6

package/package.json

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

package/src/index.ts

@@ -15,6 +15,7 @@ export { MemoryPeerStore } from "./memory-peer-store";
 export { createPeerKey } from "./peer-key";
 export {
   canEdit,
+  canFindByPhone,
   canMarkRead,
   canReact,
   canReceive,
@@ -43,6 +44,9 @@ export type {
   EditedMessageTransport,
   MessageDraft,
   OutgoingObserverTransport,
+  PhoneLookupOptions,
+  PhoneLookupTransport,
+  PhoneMatch,
   EditResult,
   EmailRecipient,
   HeadhunterRecipient,

package/src/types.ts

@@ -409,6 +409,33 @@ export function canObserveOutgoing(
   );
 }
 
+/** Учётка, найденная по номеру телефона. */
+export type PhoneMatch = { userId: string; username?: string; firstName?: string };
+
+export type PhoneLookupOptions = {
+  /**
+   * Контакт, заведённый ради поиска, остаётся в адресной книге (по умолчанию): с человеком будут работать, и
+   * оператор на телефоне видит его имя, а не номер. `false` — удалить сразу, для массового перебора номеров.
+   */
+  keepContact?: boolean;
+  /** Имя контакта; без него — сам номер. */
+  firstName?: string;
+  lastName?: string;
+};
+
+/**
+ * Поиск учётки по номеру телефона — когда о человеке известен только номер. Найденный пир транспорт
+ * запоминает: следующий send по `{ type: "user", id: userId }` уходит без повторного поиска.
+ */
+export interface PhoneLookupTransport extends MessageTransport {
+  /** Номер — E.164 (`+79991234567`). Не найден — `null`; прочие отказы канала — исключением с его текстом. */
+  findByPhone(phone: string, options?: PhoneLookupOptions): Promise<PhoneMatch | null>;
+}
+
+export function canFindByPhone(transport: MessageTransport): transport is PhoneLookupTransport {
+  return typeof (transport as PhoneLookupTransport).findByPhone === "function";
+}
+
 /** Пункт меню команд канала: `/menu` и подпись рядом с ним. */
 export type ChannelCommand = {
   /** Без ведущей косой черты. */