webmaxsocket 1.0.0 → 1.1.1

package/README.md

@@ -2,13 +2,16 @@
 
 ## 📖 Описание / Description
 
-**WebMaxSocket** — async Node.js библиотека для работы с внутренним API мессенджера Max. Позволяет создавать WebSocket соединение с **QR-кодом авторизацией**.
+**WebMaxSocket** — async Node.js библиотека для работы с внутренним API мессенджера Max. Поддерживает **QR-код авторизацию**, **Token авторизацию**, и работу через **WebSocket** (WEB) или **TCP Socket** (IOS/ANDROID).
 
 ## ✨ Особенности / Features
 
 - ✅ **QR-код авторизация** / QR code authentication  
-- ✅ **WebSocket соединение** / WebSocket connection
+- ✅ **QR для привязки устройства** (`showLinkDeviceQR`) после входа по SMS/TCP — тот же сценарий, что «Профиль → Устройства → Подключить устройство» в приложении
+- ✅ **Token авторизация** / Token authentication
+- ✅ **Два транспорта:** WebSocket (WEB) и TCP Socket (IOS/ANDROID)
 - ✅ **Автоматическое сохранение сессий** / Automatic session storage
+- ✅ **Автовыбор транспорта** после QR-авторизации (переход на TCP)
 - ✅ **Отправка и получение сообщений** / Send and receive messages
 - ✅ **Редактирование и удаление сообщений** / Edit and delete messages
 - ✅ **Event-driven архитектура** / Event-driven architecture
@@ -21,6 +24,16 @@
 npm install webmaxsocket
 ```
 
+### Зависимости для Socket транспорта (IOS/ANDROID)
+
+Для работы с TCP Socket транспортом требуется библиотека `lz4`. Если при установке возникают проблемы с `node-gyp`:
+
+```bash
+npm install lz4 --ignore-scripts
+```
+
+**Примечание:** Для обычной QR-авторизации (WEB) дополнительные зависимости не нужны. Socket транспорт используется только после сохранения сессии или при явном указании `deviceType: 'IOS'`/`'ANDROID'`.
+
 ## 🚀 Быстрый старт / Quick Start
 
 ### Базовый пример / Basic Example
@@ -63,28 +76,111 @@ main().catch(console.error);
 
 ### Авторизация / Authentication
 
-При первом запуске вы увидите QR-код в консоли:
+#### Способ 1: QR-код (рекомендуется для первого запуска)
 
-On first run, you'll see a QR code in the console:
+При первом запуске вы увидите QR-код в консоли:
 
 ```
 🔐 АВТОРИЗАЦИЯ ЧЕРЕЗ QR-КОД
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-📱 Откройте приложение Max на телефоне
-➡️  Настройки → Устройства → Подключить устройство
+📱 На телефоне: Профиль → Устройства / Безопасность → Подключить устройство
 📸 Отсканируйте QR-код
 
 █████████████████████████████
-█████████████████████████████
-████ ▄▄▄▄▄ █▀█ █▄▄█ ▄▄▄▄▄ ████
-████ █   █ █▀▀▀█ ▄█ █   █ ████
 ...
 ```
 
-После сканирования токен сохраняется автоматически.
+После сканирования:
+- Токен и clientSessionId сохраняются автоматически
+- При следующем запуске клиент **автоматически переключится на TCP Socket** для стабильности
+- Повторная авторизация не требуется
+
+#### Способ 2: SMS авторизация (IOS/ANDROID)
+
+Авторизация по номеру телефона с кодом из SMS:
+
+```javascript
+const client = new WebMaxClient({
+  name: 'my_session',
+  deviceType: 'IOS'  // Обязательно для SMS авторизации
+});
+
+await client.connect();
+
+// Запрос кода
+const authSession = await client.authorizeBySMS('+79001234567');
+
+// Получаем код из SMS и отправляем
+const code = '123456';  // Код из SMS
+await authSession.sendCode(code);
+
+// Завершаем запуск
+await client.triggerHandlers(client.handlers.START);
+```
+
+Или запустите готовый пример:
+
+```bash
+node example-sms.js
+node example-sms.js +79001234567  # с номером в аргументе
+```
+
+#### QR после входа: привязка второго устройства (IOS/ANDROID)
+
+Когда вы уже авторизованы по **TCP** (SMS и сохранённая сессия), запрос **`GET_QR` на том же соединении недоступен** (ответ сервера: недопустимое состояние сессии). Для сценария как в приложении — **показать QR, телефон сканирует** — используйте метод **`showLinkDeviceQR()`**: библиотека открывает **отдельное краткоживущее WebSocket-подключение** (как у [web.max.ru](https://web.max.ru)), запрашивает QR, печатает его в консоль и при необходимости ждёт сканирования.
+
+Требования: активное соединение и **`isAuthorized`** (обычно после `await client.start()`).
+
+```javascript
+await client.start();
+
+// Показать QR и ждать, пока отсканируют в приложении Max на телефоне
+await client.showLinkDeviceQR();
+
+// Только показать QR и вернуть данные (без ожидания скана)
+const data = await client.showLinkDeviceQR({ waitForScan: false });
+// data: { qrLink, trackId, pollingInterval, expiresAt }
+```
+
+Опции: `waitForScan` (по умолчанию `true`), `small` — компактный QR в терминале.
+
+**Версия клиента:** для выдачи QR сервер ожидает актуальный **`appVersion`** в User-Agent (не ниже **25.12.13**). В конструкторе по умолчанию используется **25.12.14**; при необходимости передайте `appVersion: '25.21.3'` или новее.
 
-After scanning, the token is saved automatically.
+Если сервер отвечает **`qr_login.disabled`**, проверьте версию приложения в опциях, откройте [web.max.ru](https://web.max.ru) в браузере или войдите на втором устройстве по номеру телефона.
+
+#### Способ 3: Token авторизация
+
+Если у вас уже есть токен (от другого сервиса/приложения):
+
+```javascript
+const client = new WebMaxClient({
+  name: 'my_session',
+  token: 'An_Sx6HQ9HDiftNkVBNf6Q5PG5D8Oyj...',  // Ваш токен
+  configPath: 'config/myconfig.json',  // Или из файла
+  saveToken: true
+});
+
+await client.start();
+```
+
+Формат конфига (`config/default.json`):
+```json
+{
+  "token": "An_Sx6HQ9HDiftNk...",
+  "ua": "Mozilla/5.0 (iPhone...)",
+  "device_type": 2,
+  "deviceType": "IOS"
+}
+```
+
+#### Транспорты
+
+- **WEB** (`deviceType: 'WEB'` или `device_type: 1`) → WebSocket (ws-api.oneme.ru)
+- **IOS** (`deviceType: 'IOS'` или `device_type: 2`) → TCP Socket (api.oneme.ru)
+- **ANDROID** (`deviceType: 'ANDROID'` или `device_type: 3`) → TCP Socket (api.oneme.ru)
+
+Клиент **автоматически выбирает** правильный транспорт на основе сохраненного deviceType.
 
 ## API
 
@@ -97,10 +193,23 @@ After scanning, the token is saved automatically.
 ```javascript
 const client = new WebMaxClient({
   name: 'session',        // Имя сессии (для сохранения авторизации)
-  phone: '+1234567890',   // Номер телефона
+  token: 'An_Sx6H...',    // Токен авторизации (опционально)
+  configPath: 'myconfig', // Путь к config файлу (опционально)
+  deviceType: 'WEB',      // Тип устройства: 'WEB', 'IOS', 'ANDROID', 'DESKTOP' (опционально)
+  saveToken: true,        // Сохранять токен в сессию (по умолчанию true)
+  debug: false,           // Отладочный режим (опционально)
   apiUrl: 'wss://...',    // URL WebSocket API (опционально)
   maxReconnectAttempts: 5,// Максимальное количество попыток переподключения
-  reconnectDelay: 3000    // Задержка между попытками переподключения (мс)
+  reconnectDelay: 3000,   // Задержка между попытками переподключения (мс)
+  // User-Agent / клиент (важно для GET_QR, см. showLinkDeviceQR):
+  appVersion: '25.12.14', // Рекомендуется ≥ 25.12.13 для запроса QR
+  ua: 'Mozilla/5.0 ...', // или headerUserAgent
+  osVersion: 'Windows 11',
+  screen: '1920x1080 1.0x',
+  timezone: 'Europe/Moscow',
+  locale: 'ru',
+  buildNumber: 0x97cb,    // опционально
+  clientSessionId: 1      // опционально
 });
 ```
 
@@ -114,9 +223,42 @@ const client = new WebMaxClient({
 await client.start();
 ```
 
+##### `authorizeBySMS(phone)`
+
+Авторизация по номеру телефона через SMS (только для IOS/ANDROID).
+
+```javascript
+// Подключаемся
+await client.connect();
+
+// Запрашиваем код
+const authSession = await client.authorizeBySMS('+79001234567');
+
+// Вводим код из SMS
+await authSession.sendCode('123456');
+```
+
+##### `showLinkDeviceQR(options)`
+
+Показать в консоли **QR-код для привязки устройства** (как в приложении Max: телефон сканирует QR). Нужна **уже выполненная авторизация** (`start()` или `connect` + `sync`).
+
+- Для **WEB** запрос выполняется по текущему WebSocket.
+- Для **IOS/ANDROID** после входа по TCP используется **второе** WebSocket-подключение без повторного `LOGIN` на той сессии (иначе `GET_QR` на том же TCP недоступен).
+
+```javascript
+await client.showLinkDeviceQR();
+await client.showLinkDeviceQR({ waitForScan: false, small: false });
+```
+
+Возвращает `Promise<{ qrLink, trackId, pollingInterval, expiresAt }>`.
+
+##### `requestQR()`, `checkQRStatus(trackId)`, `loginByQR(trackId)`, `authorizeByQR()`
+
+Низкоуровневые шаги QR-авторизации для **WEB** (первый вход без SMS). Обычно достаточно `start()` без токена или `authorizeByQR()`.
+
 ##### `sendMessage(options)`
 
-Отправляет сообщение в чат.
+Отправляет сообщение в чат с уведомлением (notify: true).
 
 ```javascript
 const message = await client.sendMessage({
@@ -128,6 +270,20 @@ const message = await client.sendMessage({
 });
 ```
 
+##### `sendMessageChannel(options)`
+
+Отправляет сообщение в канал без уведомления (notify: false).
+
+```javascript
+const message = await client.sendMessageChannel({
+  chatId: 123,
+  text: 'Сообщение в канал',
+  cid: Date.now(),
+  replyTo: null,        // ID сообщения для ответа (опционально)
+  attachments: []       // Вложения (опционально)
+});
+```
+
 ##### `editMessage(options)`
 
 Редактирует сообщение.
@@ -362,22 +518,98 @@ ChatActions.RECORDING_VOICE // Записывает голосовое
 ChatActions.RECORDING_VIDEO // Записывает видео
 ```
 
+### MaxSocketTransport
+
+Низкоуровневый TCP Socket транспорт для IOS/ANDROID (api.oneme.ru).
+
+#### Прямое использование (advanced)
+
+```javascript
+const { MaxSocketTransport } = require('webmaxsocket');
+
+const transport = new MaxSocketTransport({
+  deviceType: 'IOS',
+  ua: 'Mozilla/5.0 (iPhone...)',
+  deviceId: 'your-device-id',
+  debug: true
+});
+
+await transport.connect();
+await transport.handshake(userAgentPayload);
+const syncData = await transport.sync(token, userAgent);
+```
+
+**Примечание:** В большинстве случаев используйте `WebMaxClient`, который автоматически выбирает нужный транспорт.
+
+## 📚 Примеры
+
+### Пример 1: QR-авторизация (example.js)
+
+```bash
+node example.js
+```
+
+Первый запуск - QR-авторизация, повторные запуски - автоматический вход через TCP Socket.
+
+### Пример 2: Token авторизация (example-token.js)
+
+```bash
+# Через config файл
+node example-token.js
+node example-token.js myconfig  # config/myconfig.json
+
+# Через переменную окружения
+TOKEN="ваш_токен" node example-token.js
+```
+
+### Пример 3: SMS авторизация (example-sms.js)
+
+```bash
+# Интерактивный ввод номера
+node example-sms.js
+
+# С номером в аргументе
+node example-sms.js +79001234567
+```
+
+### Пример 4: IOS/ANDROID Socket (example-ios.js)
+
+```bash
+# С готовым конфигом
+node example-ios.js
+
+# С отладкой
+node example-ios.js --debug
+```
+
+### Пример 5: QR для второго устройства после SMS
+
+После успешного `start()` с сохранённой сессией IOS/Android вызовите `showLinkDeviceQR()` (см. раздел **«QR после входа»** выше).
+
 ## Структура проекта
 
 ```
 webmaxsocket/
 ├── lib/
 │   ├── client.js           # Основной клиент
+│   ├── socketTransport.js  # TCP Socket транспорт
 │   ├── session.js          # Управление сессиями
+│   ├── userAgent.js        # UserAgent генератор
+│   ├── opcodes.js          # Протокол опкоды
 │   ├── constants.js        # Константы
 │   └── entities/
 │       ├── User.js         # Класс пользователя
 │       ├── Message.js      # Класс сообщения
 │       ├── ChatAction.js   # Класс действия в чате
 │       └── index.js        # Экспорт сущностей
+├── config/                 # Конфигурационные файлы
+│   └── example.json        # Пример конфига
 ├── sessions/               # Директория с сохраненными сессиями
 ├── index.js                # Точка входа
-├── example.js              # Пример использования
+├── example.js              # QR-авторизация
+├── example-token.js        # Token авторизация
+├── example-sms.js          # SMS авторизация
+├── example-ios.js          # IOS/ANDROID Socket
 ├── package.json
 └── README.md
 ```
@@ -408,4 +640,56 @@ try {
 } catch (error) {
   console.error('Ошибка:', error.message);
 }
-```
+```
+
+## 🔧 Отладка / Debug
+
+Для включения отладочного вывода:
+
+```javascript
+const client = new WebMaxClient({
+  name: 'my_session',
+  debug: true  // или process.env.DEBUG = '1'
+});
+```
+
+Или через переменную окружения:
+
+```bash
+DEBUG=1 node example.js
+```
+
+## 💡 Важные замечания
+
+1. **TCP Socket после QR-авторизации:** После первой успешной QR-авторизации клиент автоматически сохраняет `clientSessionId` и переключается на TCP Socket транспорт при следующем запуске для повышения стабильности.
+
+2. **QR для нового устройства после входа по SMS/TCP:** Используйте `showLinkDeviceQR()`. Это не отдельный опкод в протоколе, а тот же `GET_QR`, что и у веб-клиента; для уже залогиненного TCP-сокета запрос выполняется через **эфемерное WebSocket-подключение** (временный файл сессии `_link_qr_*` удаляется после завершения).
+
+3. **Версия `appVersion` и QR:** Слишком старая версия в User-Agent может привести к ответу `qr_login.disabled` на `GET_QR`. Задайте в конструкторе актуальную строку (по умолчанию **25.12.14**).
+
+4. **Разница между sendMessage и sendMessageChannel:**
+   - `sendMessage()` - отправка с уведомлением (notify: true) для обычных чатов
+   - `sendMessageChannel()` - отправка без уведомления (notify: false) для каналов
+
+5. **Автоматический выбор транспорта:** Клиент автоматически определяет какой транспорт использовать на основе `deviceType` в сессии или config файле.
+
+## 🔗 Ссылки / Links
+
+- [GitHub Repository](https://github.com/Tellarion/webmaxsocket)
+- [NPM Package](https://www.npmjs.com/package/webmaxsocket)
+
+## 📄 Лицензия / License
+
+MIT License - see LICENSE file for details
+
+## 👤 Автор / Author
+
+Tellarion - [tellarion.dev](https://tellarion.dev)
+
+## 💝 Поддержка / Support
+
+Если вам нравится эта библиотека и вы хотите поддержать разработку:
+
+**USDT (TRC20):** `TXfs1iVbp2aLd3rbc4cenVzMoTevP5RbBE`
+
+Спасибо за вашу поддержку!

package/config/example.json

@@ -0,0 +1,6 @@
+{
+  "token": "YOUR_TOKEN_HERE",
+  "ua": "Mozilla/5.0 (iPhone15,2; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/602.1.50",
+  "device_type": 2,
+  "deviceType": "IOS"
+}

package/example-ios.js

@@ -0,0 +1,186 @@
+/**
+ * IOS/ANDROID: вход через Socket (api.oneme.ru), не WebSocket
+ * WEB: через WebSocket (ws-api.oneme.ru)
+ *
+ * С готовым конфигом: node example-ios.js
+ * Без токена — запрос телефона и SMS
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { WebMaxClient, MaxSocketTransport } = require('./index');
+const { UserAgentPayload } = require('./lib/userAgent');
+const { Opcode } = require('./lib/opcodes');
+
+const argv = process.argv.slice(2).filter((a) => a !== '--debug' && a !== '-d');
+if (process.argv.includes('--debug') || process.argv.includes('-d')) process.env.DEBUG = '1';
+const CONFIG_NAME = argv[0] || process.env.CONFIG || 'default';
+
+function loadConfig() {
+  const base = path.join(process.cwd(), 'config');
+  const p = path.join(base, CONFIG_NAME + (CONFIG_NAME.endsWith('.json') ? '' : '.json'));
+  if (!fs.existsSync(p)) return null;
+  return JSON.parse(fs.readFileSync(p, 'utf8'));
+}
+
+function configToUserAgent(config) {
+  const dt = config.deviceType || (config.device_type === 2 ? 'IOS' : config.device_type === 3 ? 'ANDROID' : 'WEB');
+  return new UserAgentPayload({
+    deviceType: dt,
+    locale: config.locale || 'ru',
+    deviceLocale: config.deviceLocale || config.locale || 'ru',
+    osVersion: config.osVersion || '18.6.2',
+    deviceName: config.deviceName || 'Safari',
+    headerUserAgent: config.headerUserAgent || config.ua || '',
+    appVersion: config.appVersion || '25.12.14',
+    screen: config.screen || '390x844 3.0x',
+    timezone: config.timezone || 'Europe/Moscow',
+    buildNumber: config.buildNumber,
+    clientSessionId: config.clientSessionId,
+    release: config.release
+  });
+}
+
+function useSocket(config) {
+  const dt = config.deviceType || config.device_type;
+  return dt === 'IOS' || dt === 'ANDROID' || dt === 2 || dt === 3;
+}
+
+async function main() {
+  const config = loadConfig();
+  const hasToken = config && config.token && config.token.length >= 50;
+
+  if (hasToken && useSocket(config)) {
+    console.log('🚀 Socket (api.oneme.ru) — IOS/ANDROID\n');
+    const ua = configToUserAgent(config);
+    const transport = new MaxSocketTransport({
+      deviceType: config.deviceType || (config.device_type === 2 ? 'IOS' : 'ANDROID'),
+      ua: config.headerUserAgent || config.ua,
+      deviceId: config.deviceId || require('uuid').v4(),
+      debug: process.env.DEBUG === '1'
+    });
+
+    transport.onNotification = (data) => {
+      if (data.opcode === Opcode.NOTIF_MESSAGE && data.payload) {
+        const m = data.payload;
+        if (m.senderId !== transport.me?.id) {
+          console.log('💬', (m.sender?.firstName || 'User') + ':', m.text || '[вложение]');
+        }
+      }
+    };
+
+    await transport.connect();
+    await transport.handshake(ua);
+
+    const syncResp = await transport.sync(config.token, ua.toJSON());
+
+    if (process.env.DEBUG === '1') {
+      const s = JSON.stringify(syncResp, null, 2);
+      console.log('\n📋 Sync (сырой):', s.slice(0, 3000) + (s.length > 3000 ? '\n...' : ''));
+    }
+    console.log('\n📋 Ключи sync:', Object.keys(syncResp || {}).join(', '));
+
+    const contact = syncResp?.profile?.contact ?? syncResp?.profile?.user ?? syncResp?.contact;
+    if (contact) {
+      const names = contact.names || [];
+      const name = Array.isArray(names) ? names[0] : names;
+      const first = name?.firstName ?? name?.name ?? '';
+      const last = name?.lastName ?? '';
+      transport.me = {
+        id: contact.id,
+        firstname: first,
+        lastname: last,
+        fullname: [first, last].filter(Boolean).join(' ') || 'User'
+      };
+      console.log('\n👤 Профиль:');
+      console.log('   ID:', contact.id);
+      console.log('   Имя:', transport.me.fullname);
+      console.log('   Телефон:', contact.phone ? '+' + contact.phone : '—');
+    }
+
+    const syncChats = syncResp?.chats ?? syncResp?.chatList ?? syncResp?.list ?? [];
+    const chats = await transport.getChats();
+    const allChats = syncChats.length ? syncChats : chats;
+    console.log('\n📂 Диалоги (' + allChats.length + '):');
+    allChats.slice(0, 20).forEach((c, i) => {
+      const t = c.title ?? c.name ?? c.chat?.title ?? ('Chat ' + (c.id ?? c.chatId ?? i));
+      const lastMsg = c.lastMessage?.text ?? c.lastMessage?.message ?? '—';
+      console.log(`   ${i + 1}. ${t} — ${String(lastMsg).slice(0, 35)}`);
+    });
+    if (allChats.length > 20) console.log('   ... и ещё', allChats.length - 20);
+
+    const contacts = syncResp?.contacts || [];
+    if (contacts.length) {
+      console.log('\n📇 Контакты:', contacts.length);
+    }
+
+    console.log('\n🤖 Socket работает (Ctrl+C — выход)\n');
+    process.on('SIGINT', () => { transport.close(); process.exit(0); });
+    return;
+  }
+
+  if (hasToken) {
+    const client = new WebMaxClient({
+      name: 'web_session',
+      configPath: CONFIG_NAME,
+      saveToken: false,
+      debug: process.env.DEBUG === '1'
+    });
+    client.onStart(async () => {
+      if (client.me) console.log('\n✅ Вход:', client.me.fullname || client.me.firstname, '(ID:', client.me.id + ')\n');
+      try { console.log('📂 Диалогов:', (await client.getChats()).length); } catch (e) { console.log('⚠️', e.message); }
+    });
+    client.onMessage((m) => { if (m.senderId !== client.me?.id) console.log('💬', m.getSenderName() + ':', m.text); });
+    client.onError((e) => console.error('❌', e.message));
+    await client.start();
+    console.log('🤖 Бот работает (Ctrl+C — выход)\n');
+    return;
+  }
+
+  const readline = require('readline');
+  const { v4: uuidv4 } = require('uuid');
+  const IOS_UA = 'Mozilla/5.0 (iPhone15,2; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/602.1.50';
+
+  function ask(q) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((r) => rl.question(q, (a) => { rl.close(); r(a.trim()); }));
+  }
+
+  console.log('📱 Получение токена по телефону (Socket)\n');
+  const phone = await ask('Номер (+79xxxxxxxxx): ');
+  if (!/^\+?\d{10,15}$/.test(phone.replace(/\s/g, ''))) { console.error('❌ Неверный формат'); process.exit(1); }
+  let clean = phone.replace(/\D/g, '');
+  if (clean.startsWith('8') && clean.length === 11) clean = '7' + clean.slice(1);
+  else if (clean.startsWith('9') && clean.length === 10) clean = '7' + clean;
+  const norm = '+' + clean;
+
+  const transport = new MaxSocketTransport({ deviceType: 'IOS', ua: IOS_UA, deviceId: uuidv4(), debug: process.env.DEBUG === '1' });
+  await transport.connect();
+  await transport.handshake(new UserAgentPayload({ deviceType: 'IOS', headerUserAgent: IOS_UA, appVersion: '25.12.14', osVersion: '18.6.2', deviceName: 'Safari', screen: '390x844 3.0x', locale: 'ru', deviceLocale: 'ru', timezone: 'Europe/Moscow' }));
+
+  console.log('📤 Запрос кода...');
+  const tempToken = await transport.requestCode(norm);
+  if (!tempToken) throw new Error('Не получен временный токен');
+  const code = await ask('Код из SMS (6 цифр): ');
+  if (!/^\d{6}$/.test(code)) throw new Error('Неверный код');
+
+  const authResp = await transport.sendCode(tempToken, code);
+  const token = authResp?.tokenAttrs?.LOGIN?.token;
+  if (!token) throw new Error(authResp?.passwordChallenge ? '2FA не поддерживается' : 'Токен не получен');
+  await transport.close();
+
+  const cfg = { token, ua: IOS_UA, device_type: 2, deviceType: 'IOS' };
+  const dir = path.join(process.cwd(), 'config');
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(path.join(dir, CONFIG_NAME + '.json'), JSON.stringify(cfg, null, 2), 'utf8');
+  console.log('\n✅ Конфиг сохранён:', path.join(dir, CONFIG_NAME + '.json'));
+  console.log('   Запуск: node example-ios.js', CONFIG_NAME);
+}
+
+main().catch((e) => { console.error('❌', e.message); process.exit(1); });
+process.on('SIGINT', () => {
+  console.log('\n\n👋 Завершение работы...');
+  console.log('\n💝 Нравится библиотека? Поддержите разработку:');
+  console.log('   USDT (TRC20): TXfs1iVbp2aLd3rbc4cenVzMoTevP5RbBE');
+  process.exit(0);
+});