@imessaging/core 0.8.5 → 0.8.6

package/package.json

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

package/src/index.ts

@@ -44,6 +44,7 @@ export type {
   EditedMessageTransport,
   MessageDraft,
   OutgoingObserverTransport,
+  PhoneLookupOptions,
   PhoneLookupTransport,
   PhoneMatch,
   EditResult,

package/src/types.ts

@@ -412,13 +412,24 @@ 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): Promise<PhoneMatch | null>;
+  findByPhone(phone: string, options?: PhoneLookupOptions): Promise<PhoneMatch | null>;
 }
 
 export function canFindByPhone(transport: MessageTransport): transport is PhoneLookupTransport {