webmaxsocket 1.1.5 → 1.1.6

package/README.md

@@ -31,12 +31,18 @@
 npm install webmaxsocket
 ```
 
-### Зависимости для Socket транспорта (IOS/ANDROID)
+### Зависимости для Socket транспорта (IOS/ANDROID) / Socket transport dependencies
 
-Для работы с TCP Socket транспортом требуется библиотека `lz4`. Если при установке возникают проблемы с `node-gyp`:
+Ответы сервера по TCP содержат полезную нагрузку в **LZ4**-блоках (поверх **msgpack**). Для распаковки используется **`lz4js`** — чистый JavaScript, **без node-gyp** и нативной сборки, в том числе на Windows без Visual Studio C++. Он входит в зависимости `webmaxsocket` и ставится вместе с пакетом. При необходимости можно доустановить вручную:
 
 ```bash
-npm install lz4 --ignore-scripts
+npm install lz4js
+```
+
+Дополнительно можно установить нативный модуль **`lz4`**, если в окружении доступна сборка C++:
+
+```bash
+npm install lz4
 ```
 
 **Примечание:** Для обычной QR-авторизации (WEB) дополнительные зависимости не нужны. Socket транспорт используется только после сохранения сессии или при явном указании `deviceType: 'IOS'`/`'ANDROID'`.
@@ -668,7 +674,7 @@ ChatActions.RECORDING_VIDEO // Записывает видео
 
 ### MaxSocketTransport
 
-Низкоуровневый TCP Socket транспорт для IOS/ANDROID (api.oneme.ru).
+Низкоуровневый TCP Socket транспорт для IOS/ANDROID (api.oneme.ru). Входящие пакеты с флагом сжатия распаковываются через **LZ4** (см. раздел **«Зависимости для Socket транспорта»** выше).
 
 #### Прямое использование (advanced)
 
@@ -827,6 +833,8 @@ DEBUG=1 node example.js
 
 7. **TCP и keep-alive (PING):** сервер периодически шлёт `PING`. На WebSocket клиент отвечает `sendPong`; на **TCP** раньше ответ не отправлялся — соединение могло обрываться через несколько минут, после чего процесс Node **завершался** (нечем держать event loop). Сейчас на TCP автоматически шлётся тот же ответ, что и у WebSocket (`PING` с пустым payload).
 
+8. **LZ4:** для IOS/ANDROID входящие данные распаковываются из LZ4-блоков; **`lz4js`** входит в зависимости пакета. При необходимости можно установить нативный **`lz4`** (см. раздел **«Зависимости для Socket транспорта»**).
+
 ## 🔗 Ссылки / Links
 
 - [GitHub Repository](https://github.com/Tellarion/webmaxsocket)

package/api.package.md

@@ -2,6 +2,8 @@
 
 Краткий перечень возможностей для работы с библиотекой. Подробности и примеры — в `README.md`.
 
+**Зависимости TCP (IOS/ANDROID):** ответы по сокету сжаты **LZ4**; для распаковки используется **`lz4js`**. См. `README.md` → «Зависимости для Socket транспорта».
+
 ---
 
 ## Экспорт пакета (`require('webmaxsocket')`)

package/lib/client.js

@@ -68,17 +68,28 @@ class WebMaxClient extends EventEmitter {
     this.apiUrl = options.apiUrl || 'wss://ws-api.oneme.ru/websocket';
     
     // Загрузка из config — token, ua (agent), device_type
-    let token = options.token || null;
     let agent = options.ua || options.agent || options.headerUserAgent || null;
     let configObj = {};
     const configPath = options.configPath || options.config;
     if (configPath) {
       configObj = loadSessionConfig(configPath);
-      token = token || configObj.token || null;
       agent = agent || configObj.agent || configObj.ua || configObj.headerUserAgent || null;
     }
-    
-    this._providedToken = token;
+
+    const optTok = options.token;
+    this._explicitOptionToken =
+      optTok !== undefined && optTok !== null && String(optTok).trim() !== ''
+        ? String(optTok).trim()
+        : null;
+    this._configFileToken =
+      configPath &&
+      configObj.token !== undefined &&
+      configObj.token !== null &&
+      String(configObj.token).trim() !== ''
+        ? String(configObj.token).trim()
+        : null;
+    /** Сырые токены из опций/config (без sessions); приоритет при старте см. _resolveTokenForStart */
+    this._providedToken = this._explicitOptionToken || this._configFileToken;
     this._saveTokenToSession = options.saveToken !== false;
     this.origin = options.origin || 'https://web.max.ru';
     /** Доп. заголовок для ws (например Referer при QR с max.ru, пока Origin остаётся web.max.ru — иначе 403). */
@@ -166,6 +177,9 @@ class WebMaxClient extends EventEmitter {
       Boolean(options.debug) ||
       process.env.DEBUG === '1' ||
       process.env.WEBMAX_DEBUG === '1';
+    this._authDebug = Boolean(options.authDebug) || process.env.WEBMAX_AUTH_DEBUG === '1';
+    /** После успешного sync копировать sessions/<name>.json → <name>.last_ok.json */
+    this._sessionBackupOnSuccess = options.sessionBackup !== false;
     /** Режим JSON-лога входящих: off | messages | verbose (см. logIncoming в README) */
     this._incomingLogMode = resolveIncomingLogMode(options);
     this._wireIncomingLogListeners();
@@ -200,6 +214,55 @@ class WebMaxClient extends EventEmitter {
     });
   }
 
+  /**
+   * Приоритет токена: явный options.token → сохранённая sessions/<name>.json → token из config.
+   * Иначе после SMS в sessions лежит новый токен, а из config подставлялся старый и sync падал с «обновите config».
+   */
+  _resolveTokenForStart() {
+    if (this._explicitOptionToken) {
+      return { token: this._explicitOptionToken, source: 'options.token' };
+    }
+    const sessionTok = this.session.get('token');
+    if (sessionTok && String(sessionTok).trim() !== '') {
+      return { token: String(sessionTok).trim(), source: 'session_file' };
+    }
+    if (this._configFileToken) {
+      return { token: this._configFileToken, source: 'config_file' };
+    }
+    return { token: null, source: null };
+  }
+
+  _logAuthContext(phase, extra = {}) {
+    if (!this.debug && !this._authDebug) return;
+    let libVersion = 'unknown';
+    try {
+      libVersion = require(path.join(__dirname, '..', 'package.json')).version;
+    } catch (_) {
+      /* ignore */
+    }
+    const tok = this._token || this.session.get('token');
+    const tokenPreview =
+      tok && String(tok).length > 14
+        ? `${String(tok).slice(0, 8)}…${String(tok).slice(-4)}`
+        : tok
+          ? '(short)'
+          : '(none)';
+    const payload = {
+      phase,
+      libVersion,
+      node: process.version,
+      cwd: process.cwd(),
+      sessionName: this.sessionName,
+      sessionPath: this.session.sessionFile,
+      backupPath: path.join(this.session.sessionDir, `${this.sessionName}.last_ok.json`),
+      tokenPreview,
+      deviceId: this.deviceId,
+      userAgent: this.userAgent.toJSON(),
+      ...extra
+    };
+    console.log('[webmaxsocket:auth]', JSON.stringify(payload, null, 2));
+  }
+
   /**
    * Регистрация обработчика события start
    */
@@ -281,32 +344,47 @@ class WebMaxClient extends EventEmitter {
       // Подключаемся к WebSocket или Socket
       await this.connect();
       
-      // Приоритет: 1) переданный токен, 2) сохранённая сессия, 3) QR-авторизация
-      const tokenToUse = this._providedToken || this.session.get('token');
-      
+      const { token: tokenToUse, source: tokenSource } = this._resolveTokenForStart();
+
       if (tokenToUse) {
-        if (this._providedToken) {
+        if (tokenSource === 'session_file') {
+          console.log('✅ Найдена сохраненная сессия');
+        } else {
           console.log('✅ Вход по токену (token auth)');
           if (this._saveTokenToSession) {
-            this.session.set('token', this._providedToken);
+            this.session.set('token', tokenToUse);
             this.session.set('deviceId', this.deviceId);
           }
-        } else {
-          console.log('✅ Найдена сохраненная сессия');
         }
         this._token = tokenToUse;
-        
+
+        this._logAuthContext('start:before_sync', { tokenSource });
+
         try {
           await this.sync();
           this.isAuthorized = true;
         } catch (error) {
-          const wasTokenAuth = !!this._providedToken;
+          const fromConfigOrOptions =
+            tokenSource === 'config_file' || tokenSource === 'options.token';
           this.session.clear();
+          this._explicitOptionToken = null;
+          this._configFileToken = null;
           this._providedToken = null;
-          if (wasTokenAuth) {
-            throw new Error(`Токен недействителен или сессия истекла. Обновите токен в config. (${error.message})`);
+          if (fromConfigOrOptions) {
+            throw new Error(
+              `Токен недействителен или сессия истекла. Обновите token в config или удалите/очистите token в config, чтобы использовалась актуальная сессия из sessions/. (${error.message})`
+            );
           }
           console.log('⚠️ Сессия истекла, требуется повторная авторизация');
+          if (this.debug || this._authDebug) {
+            console.log(
+              '[webmaxsocket:auth] Подсказка: для восстановления попробуйте скопировать sessions/' +
+                this.sessionName +
+                '.last_ok.json поверх sessions/' +
+                this.sessionName +
+                '.json (если копия есть).'
+            );
+          }
           await this.authorize();
         }
       } else {
@@ -1102,10 +1180,11 @@ class WebMaxClient extends EventEmitter {
           this._token = token;
           
           console.log('✅ Авторизация по SMS успешна!');
-          
+          this._logAuthContext('sms:after_login', { tokenSource: 'sms' });
+
           // Выполняем sync
           await this.sync();
-          
+
           return token;
         }
       };
@@ -1139,7 +1218,9 @@ class WebMaxClient extends EventEmitter {
    */
   async sync() {
     console.log('🔄 Синхронизация с сервером...');
-    
+
+    this._logAuthContext('sync');
+
     const token = this._token || this.session.get('token');
     
     if (!token) {
@@ -1189,7 +1270,27 @@ class WebMaxClient extends EventEmitter {
     } else {
       console.log('⚠️ Данные пользователя не найдены в ответе sync');
     }
-    
+
+    try {
+      let libVersion = 'unknown';
+      try {
+        libVersion = require(path.join(__dirname, '..', 'package.json')).version;
+      } catch (_) {
+        /* ignore */
+      }
+      this.session.set('_authMeta', {
+        lastSyncOkAt: new Date().toISOString(),
+        webmaxsocket: libVersion,
+        node: process.version
+      });
+    } catch (_) {
+      /* ignore */
+    }
+    if (this._sessionBackupOnSuccess) {
+      this.session.copyToLastOk();
+    }
+    this._logAuthContext('sync:ok', { userId: this.me?.id });
+
     return responsePayload;
   }
 
@@ -1227,13 +1328,18 @@ class WebMaxClient extends EventEmitter {
       }
       
       this._token = token;
-      
+
+      this._logAuthContext('connectWithSession:before_sync', { tokenSource: 'session_file' });
+
       try {
         await this.sync();
         this.isAuthorized = true;
         console.log('Подключение с сохраненной сессией успешно');
       } catch (error) {
         console.log('Сессия истекла, требуется повторная авторизация');
+        if (this.debug || this._authDebug) {
+          console.log('[webmaxsocket:auth] sync error:', error.message);
+        }
         this.session.clear();
         await this.authorize();
       }

package/lib/session.js

@@ -40,6 +40,22 @@ class SessionManager {
     return false;
   }
 
+  /**
+   * Копия последнего успешного состояния (после удачного sync) — для ручного восстановления:
+   * скопируйте `.last_ok.json` на место основного файла сессии.
+   */
+  copyToLastOk() {
+    try {
+      if (!fs.existsSync(this.sessionFile)) return false;
+      const okPath = path.join(this.sessionDir, `${this.sessionName}.last_ok.json`);
+      fs.copyFileSync(this.sessionFile, okPath);
+      return true;
+    } catch (error) {
+      console.error('Ошибка резервной копии сессии:', error.message);
+      return false;
+    }
+  }
+
   /**
    * Сохраняет данные сессии в файл
    */

package/lib/socketTransport.js

@@ -6,8 +6,29 @@
 
 const tls = require('tls');
 const { encode: msgpackEncode, decode: msgpackDecode } = require('@msgpack/msgpack');
-const lz4Binding = require('lz4/lib/binding.js');
 const { v4: uuidv4 } = require('uuid');
+
+/**
+ * Распаковка LZ4-блока (как в протоколе Max).
+ * Сначала нативный `lz4` (нужен node-gyp / VS C++ на Windows), иначе чистый JS `lz4js`.
+ */
+function resolveLz4Uncompress() {
+  try {
+    const lz4Binding = require('lz4/lib/binding.js');
+    return (inp, out) => lz4Binding.uncompress(inp, out);
+  } catch (_) {
+    try {
+      const lz4js = require('lz4js');
+      return (inp, out) => lz4js.decompressBlock(inp, out, 0, inp.length, 0);
+    } catch (e) {
+      throw new Error(
+        'LZ4: установите зависимость `lz4js` (npm i lz4js) или соберите нативный `lz4` (Visual Studio, C++ workload). ' +
+          e.message
+      );
+    }
+  }
+}
+const lz4Uncompress = resolveLz4Uncompress();
 const { Opcode, getOpcodeName } = require('./opcodes');
 const { UserAgentPayload } = require('./userAgent');
 
@@ -50,7 +71,7 @@ function unpackPacket(data) {
     try {
       if (compFlag !== 0) {
         const out = Buffer.alloc(Math.max(payloadLength * 20, 256 * 1024));
-        const n = lz4Binding.uncompress(payloadBytes, out);
+        const n = lz4Uncompress(payloadBytes, out);
         if (n > 0) payload = msgpackDecode(out.subarray(0, n));
       } else {
         payload = msgpackDecode(payloadBytes);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webmaxsocket",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "Node.js client for Max Messenger with QR code and token authentication",
   "main": "index.js",
   "scripts": {
@@ -38,7 +38,7 @@
   "homepage": "https://github.com/Tellarion/webmaxsocket#readme",
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3",
-    "lz4": "^0.6.5",
+    "lz4js": "^0.2.0",
     "qrcode-terminal": "^0.12.0",
     "uuid": "^9.0.0",
     "ws": "^8.18.0"