new-native-tools 3.1.26 → 3.1.27-cobra-33-146-1757491392

package/index.d.ts

@@ -12,6 +12,101 @@ export declare function checkVersionInAllFolders(dirs: Array<string>): Array<Pro
 export declare function generateZipPatch(oldFilePath: string, newFilePath: string): Promise<Array<number>>
 export declare function applyZipPatch(basePath: string, patch: Array<number>, targetPath: string): Promise<void>
 export declare function downloadWithProgress(url: string, callback: (...args: any[]) => any): object
+/**
+ * Статус интернет соединения
+ *
+ * Структура содержит полную информацию о состоянии сетевого подключения устройства
+ */
+export interface ConnectionStatus {
+  /**
+   * Статус подключения к интернету
+   *
+   * `true` - есть интернет соединение, `false` - нет соединения
+   */
+  isConnected: boolean
+  /**
+   * Тип сетевого соединения
+   *
+   * Возможные значения:
+   * - `"wifi"` - Wi-Fi соединение
+   * - `"ethernet"` - Проводное Ethernet соединение
+   * - `"cellular"` - Мобильная связь (3G/4G/5G)
+   * - `"internet"` - Подтвержденное интернет соединение (Windows)
+   * - `"local-network"` - Только локальная сеть
+   * - `"vpn"` - VPN соединение (macOS)
+   * - `"http-verified"` - Подтверждено через HTTP запрос
+   * - `"unknown"` - Тип соединения не определен
+   * - `"none"` - Нет соединения
+   */
+  connectionType: string
+  /**
+   * Задержка соединения в миллисекундах
+   *
+   * Измеряется только при HTTP проверках. Для системных проверок равно `null`
+   */
+  latencyMs?: number
+  /**
+   * Сообщение об ошибке
+   *
+   * Содержит описание проблемы, если `is_connected = false`.
+   * Для успешных соединений равно `null`
+   */
+  errorMessage?: string
+  /**
+   * Требуется ли вход через captive portal
+   *
+   * `true` - обнаружен captive portal, требуется аутентификация
+   * `false` - captive portal не обнаружен
+   * `null` - статус неизвестен
+   */
+  requiresPortalLogin?: boolean
+}
+/**
+ * Проверяет состояние интернет соединения устройства
+ *
+ * Функция выполняет двухэтапную проверку:
+ * 1. **Системная проверка** - быстрая проверка наличия сетевого подключения через ОС
+ * 2. **HTTP проверка** - проверка реального интернета через переданный хост (опционально)
+ *
+ * # Параметры
+ *
+ * * `host` - Опциональный хост для проверки реального интернет соединения.
+ *   Если не передан, возвращается только результат системной проверки.
+ *
+ * # Возвращаемое значение
+ *
+ * Возвращает `ConnectionStatus` со следующими полями:
+ * - `is_connected` - true если есть интернет соединение
+ * - `connection_type` - тип соединения ("wifi", "ethernet", "cellular", "http-custom", etc.)
+ * - `latency_ms` - задержка в миллисекундах (если измерялась)
+ * - `error_message` - описание ошибки (если есть)
+ *
+ * # Логика работы
+ *
+ * ## Без хоста (быстрая проверка ~1ms):
+ * - **Windows**: `InternetGetConnectedState` WinAPI
+ * - **Linux**: Проверка `/proc/net/route` на наличие default route
+ * - **macOS**: `SCNetworkReachability` для общей сетевой доступности
+ *
+ * ## С хостом (полная проверка ~100-2000ms):
+ * 1. Выполняется системная проверка
+ * 2. При наличии подключения делается HTTP запрос к переданному хосту
+ * 3. Пробуются HTTPS и HTTP варианты
+ * 4. Любой HTTP ответ считается успешным
+ *
+ * # Примеры
+ *
+ * ```javascript
+ * // Быстрая системная проверка
+ * const systemCheck = await checkInternetConnection();
+ *
+ * // Полная проверка с вашим сервисом
+ * const fullCheck = await checkInternetConnection("api.yourservice.com");
+ * ```
+ *
+ * Timeout: 10 секунд. Функция не использует предопределенные внешние сервисы.
+ */
+export declare function checkInternetConnection(host?: string | undefined | null): Promise<ConnectionStatus>
 export declare function exportEntireLeveldb(dbPath: string): Promise<Record<string, any>>
 export declare function importLevelDb(levelDbPath: string, levelDbJsonData: string): Promise<void>
 export declare function proxyCheckHttp(ip: string, port: number, username: string | undefined | null, password: string | undefined | null, domain: string, useHttps?: boolean | undefined | null): Promise<string>

package/index.js

@@ -310,12 +310,13 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { checkVersionInAllFolders, generateZipPatch, applyZipPatch, downloadWithProgress, exportEntireLeveldb, importLevelDb, proxyCheckHttp, proxyCheckSocks5H, proxyCheckSocks5, sqliteAddLoginPassword, createSqliteLoginDatabase, sqliteGetVersion, sqliteAddCookies, sqliteGetCookies, migrateCookiesDown, getSystemInfo, unzipToFolder, archivateFolder, validateArchive, setForegroundByPid, isProcessRunning, killProcessByPid, closeProcessByPid, tileWindowsEvenly, rustLoggerInit, getVersion } = nativeBinding
+const { checkVersionInAllFolders, generateZipPatch, applyZipPatch, downloadWithProgress, checkInternetConnection, exportEntireLeveldb, importLevelDb, proxyCheckHttp, proxyCheckSocks5H, proxyCheckSocks5, sqliteAddLoginPassword, createSqliteLoginDatabase, sqliteGetVersion, sqliteAddCookies, sqliteGetCookies, migrateCookiesDown, getSystemInfo, unzipToFolder, archivateFolder, validateArchive, setForegroundByPid, isProcessRunning, killProcessByPid, closeProcessByPid, tileWindowsEvenly, rustLoggerInit, getVersion } = nativeBinding
 
 module.exports.checkVersionInAllFolders = checkVersionInAllFolders
 module.exports.generateZipPatch = generateZipPatch
 module.exports.applyZipPatch = applyZipPatch
 module.exports.downloadWithProgress = downloadWithProgress
+module.exports.checkInternetConnection = checkInternetConnection
 module.exports.exportEntireLeveldb = exportEntireLeveldb
 module.exports.importLevelDb = importLevelDb
 module.exports.proxyCheckHttp = proxyCheckHttp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "new-native-tools",
-  "version": "3.1.26",
+  "version": "3.1.27-cobra-33-146-1757491392",
   "main": "index.js",
   "types": "index.d.ts",
   "napi": {
@@ -41,10 +41,10 @@
     "version": "napi version"
   },
   "optionalDependencies": {
-    "new-native-tools-win32-x64-msvc": "3.1.26",
-    "new-native-tools-darwin-x64": "3.1.26",
-    "new-native-tools-linux-x64-gnu": "3.1.26",
-    "new-native-tools-darwin-arm64": "3.1.26",
-    "new-native-tools-win32-ia32-msvc": "3.1.26"
+    "new-native-tools-darwin-arm64": "3.1.27",
+    "new-native-tools-darwin-x64": "3.1.27",
+    "new-native-tools-linux-x64-gnu": "3.1.27",
+    "new-native-tools-win32-ia32-msvc": "3.1.27",
+    "new-native-tools-win32-x64-msvc": "3.1.27"
   }
-}
+}