[getContacts] Получение контактов пользователя

📌 Описание

Метод getContacts() запрашивает у нативного приложения список контактов пользователя.

Возвращает Promise с массивом объектов, содержащих подробности о каждом контакте.

📤 Сигнатура

ConverzillaSDK.getContacts(): Promise<Contact[]>

📦 Что возвращается

Promise, который:

✅ при успешном выполнении — возвращает массив Contact[]

❌ при ошибке — отклоняется с описанием ошибки.

📄 Структура объекта Contact

interface Contact {
  recordID: string;
  displayName: string;
  familyName: string;
  givenName: string;
  middleName: string;
  phoneNumbers: Array<{ label: string; number: string }>;
  emailAddresses: Array<{ label: string; email: string }>;
  postalAddresses: Array<{
    label: string;
    formattedAddress: string;
    street: string;
    city: string;
    state: string;
    country: string;
    postCode: string;
  }>;
  birthday?: { day: number; month: number; year: number };
  company?: string;
  jobTitle?: string;
  note?: string;
}

💻 Пример использования

ConverzillaSDK.getContacts()
  .then(contacts => {
    console.log('Найдено контактов:', contacts.length);
    contacts.forEach(contact => {
      console.log(`Имя: ${contact.displayName}`);
      contact.phoneNumbers.forEach(phone =>
        console.log(`Телефон (${phone.label}): ${phone.number}`)
      );
    });
  })
  .catch(error => {
    console.error('Ошибка при получении контактов:', error);
  });