cordova-plugin-hot-updates 2.1.1 → 2.2.0

package/docs/README.md

@@ -1,187 +0,0 @@
-# Hot Updates Plugin v2.1.0 - JavaScript Integration
-
-**4 метода API | JavaScript контролирует ВСЁ | Manual updates only**
-
-**Последнее обновление:** 2025-11-04 (Bugfix Update)
-
----
-
-## 🐛 Важные исправления (2025-11-04)
-
-✅ **Автоустановка** - теперь работает при каждом запуске
-✅ **Callback формат** - возвращает `null` при успехе (не пустую строку)
-✅ **WebView cache** - очищается перед reload (версия всегда актуальна)
-✅ **Динамическая версия** - `window.APP_VERSION` загружается из native автоматически
-✅ **Проверка установленной версии** - `getUpdate()` не скачивает уже установленную версию
-✅ **Чистый код** - убраны отладочные логи и смайлики из native
-
----
-
-## 📋 API методы
-
-```javascript
-// 1. Скачать обновление
-window.HotUpdates.getUpdate({url: string, version?: string}, callback)
-
-// 2. Установить обновление
-window.HotUpdates.forceUpdate(callback)
-
-// 3. Подтвердить успешную загрузку
-window.HotUpdates.canary(version: string, callback)
-
-// 4. Получить черный список
-window.HotUpdates.getIgnoreList(callback)
-```
-
-**Callback формат:**
-- Успех: `callback(null)` или `callback()`
-- Ошибка: `callback({error: {message: "..."}})`
-
----
-
-## 🔑 Получение версии приложения
-
-### ⚡ Рекомендуемый подход (НОВОЕ в v2.1.0)
-
-Версия загружается **автоматически из native** через `getVersionInfo()`:
-
-```javascript
-document.addEventListener('deviceready', function() {
-    // Получаем версию из native (installedVersion или appBundleVersion)
-    cordova.exec(
-        function(info) {
-            window.APP_VERSION = info.installedVersion || info.appBundleVersion;
-            console.log('Current version:', window.APP_VERSION);
-
-            // Теперь можно вызвать canary
-            window.HotUpdates.canary(window.APP_VERSION, function() {
-                console.log('Canary confirmed');
-            });
-        },
-        function(error) {
-            console.error('Failed to get version:', error);
-        },
-        'HotUpdates',
-        'getVersionInfo',
-        []
-    );
-});
-```
-
-**Преимущества:**
-- ✅ Версия всегда актуальна после hot update
-- ✅ Не нужно синхронизировать версию между кодом и config.xml
-- ✅ Автоматически обновляется после каждого обновления
-
-### 📌 Альтернатива: Статическая версия
-
-Если нужна статическая версия (не рекомендуется):
-
-```html
-<script src="cordova.js"></script>
-<script>
-  window.APP_VERSION = "2.7.7"; // Нужно обновлять вручную
-</script>
-<script src="js/app.js"></script>
-```
-
----
-
-## ⚡ Минимальная интеграция
-
-```javascript
-document.addEventListener('deviceready', function() {
-    // 1. Canary обязателен при каждом старте
-    window.HotUpdates.canary(window.APP_VERSION, function() {
-        console.log('Canary confirmed');
-    });
-
-    // 2. Проверить ignoreList
-    window.HotUpdates.getIgnoreList(function(result) {
-        const ignoredVersions = result.versions; // ["2.7.5", "2.7.6"]
-
-        // 3. Проверить обновления на сервере
-        fetch('https://your-api.com/updates/check?version=' + window.APP_VERSION)
-            .then(r => r.json())
-            .then(data => {
-                if (data.hasUpdate && !ignoredVersions.includes(data.newVersion)) {
-                    // 4. Скачать обновление
-                    window.HotUpdates.getUpdate({
-                        url: data.downloadURL,
-                        version: data.newVersion
-                    }, function(error) {
-                        if (error) {
-                            console.error('Download failed:', error.error.message);
-                            return;
-                        }
-
-                        // 5. Показать popup
-                        if (confirm('Обновить до ' + data.newVersion + '?')) {
-                            // 6. Установить
-                            window.HotUpdates.forceUpdate(function(error) {
-                                if (error) {
-                                    console.error('Install failed:', error.error.message);
-                                } else {
-                                    console.log('Update installed, reloading...');
-                                }
-                            });
-                        }
-                        // Если пользователь отказался - обновление установится при следующем запуске
-                    });
-                }
-            })
-            .catch(err => console.error('Check failed:', err));
-    });
-});
-```
-
----
-
-## 🎯 Ключевые правила
-
-### 1. JavaScript контролирует ВСЁ
-- Native НЕ проверяет ignoreList
-- Вы читаете список через `getIgnoreList()` и принимаете решения
-- Native только выполняет команды
-
-### 2. Canary обязателен
-```javascript
-// При КАЖДОМ старте приложения, иначе rollback через 20 секунд
-window.HotUpdates.canary(window.APP_VERSION, function() {});
-```
-
-### 3. Автоустановка при следующем запуске
-Если пользователь проигнорировал popup (закрыл приложение), обновление автоматически установится при следующем запуске.
-
----
-
-## 📚 Полная документация
-
-- **API.md** - полное описание всех методов, параметров и ошибок
-
----
-
-## 🔥 Тестирование
-
-Откройте `hot-updates-admin.html` в приложении для тестирования всех методов.
-
----
-
-## ⚠️ Важно
-
-1. **window.APP_VERSION**
-   - ✅ Рекомендуется загружать через `getVersionInfo()` (автоматически актуальна)
-   - ⚠️ Статическая установка требует ручного обновления при каждом релизе
-   - Должна быть установлена ДО первого вызова `canary()`
-
-2. **canary()** должен вызываться при КАЖДОМ старте приложения (иначе rollback через 20 сек)
-
-3. **getIgnoreList()** нужно проверять ПЕРЕД скачиванием обновления
-
-4. **Автоустановка**
-   - ✅ Работает автоматически при следующем запуске (если пользователь проигнорировал popup)
-   - ✅ Срабатывает всегда (исправлено в v2.1.0 Bugfix Update)
-
-5. **Callback формат**
-   - Успех: `callback()` или `callback(null)` - возвращает `null` или `undefined`
-   - Ошибка: `callback({error: {message: "текст ошибки"}})`

package/docs/hot-updates-admin.html

@@ -1,467 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru">
-<head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width,initial-scale=1">
-    <title>Hot Updates Admin v2.1.0</title>
-    <style>
-        * { margin: 0; padding: 0; box-sizing: border-box; }
-        body {
-            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Arial, sans-serif;
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-            padding: 20px;
-            min-height: 100vh;
-        }
-        .container {
-            max-width: 600px;
-            margin: 0 auto;
-            background: white;
-            border-radius: 15px;
-            padding: 20px;
-            box-shadow: 0 10px 40px rgba(0,0,0,0.2);
-        }
-        h1 {
-            color: #667eea;
-            margin-bottom: 10px;
-            font-size: 24px;
-            text-align: center;
-        }
-        .back-link {
-            display: block;
-            text-align: center;
-            margin-bottom: 20px;
-            color: #667eea;
-            text-decoration: none;
-            font-weight: 600;
-        }
-        .back-link:hover {
-            text-decoration: underline;
-        }
-        .status {
-            background: #f0f4ff;
-            padding: 15px;
-            border-radius: 10px;
-            margin-bottom: 20px;
-            font-size: 13px;
-            line-height: 1.6;
-        }
-        .status-title {
-            font-weight: bold;
-            color: #667eea;
-            margin-bottom: 10px;
-        }
-        .section {
-            margin-bottom: 20px;
-        }
-        .section-title {
-            font-weight: bold;
-            margin-bottom: 10px;
-            color: #333;
-            font-size: 16px;
-            padding-bottom: 5px;
-            border-bottom: 2px solid #667eea;
-        }
-        button {
-            width: 100%;
-            padding: 12px;
-            margin: 5px 0;
-            border: none;
-            border-radius: 8px;
-            background: #667eea;
-            color: white;
-            font-size: 14px;
-            font-weight: 600;
-            cursor: pointer;
-            transition: all 0.3s;
-        }
-        button:active {
-            transform: scale(0.98);
-            background: #5568d3;
-        }
-        button.danger { background: #f56565; }
-        button.success { background: #48bb78; }
-        button.warning { background: #ed8936; }
-        .log {
-            background: #1a1a1a;
-            color: #00ff00;
-            padding: 15px;
-            border-radius: 8px;
-            font-family: 'Courier New', monospace;
-            font-size: 11px;
-            max-height: 300px;
-            overflow-y: auto;
-            margin-top: 15px;
-            line-height: 1.4;
-        }
-        .log-entry {
-            margin-bottom: 5px;
-            padding: 2px 0;
-        }
-        .log-time {
-            color: #888;
-            margin-right: 5px;
-        }
-        .log-success { color: #48bb78; }
-        .log-error { color: #f56565; }
-        .log-info { color: #4299e1; }
-        .progress {
-            background: #e2e8f0;
-            height: 6px;
-            border-radius: 3px;
-            overflow: hidden;
-            margin: 10px 0;
-            display: none;
-        }
-        .progress-bar {
-            height: 100%;
-            background: linear-gradient(90deg, #667eea, #764ba2);
-            width: 0%;
-            transition: width 0.3s;
-        }
-        .version-badge {
-            display: inline-block;
-            background: #667eea;
-            color: white;
-            padding: 3px 10px;
-            border-radius: 12px;
-            font-size: 11px;
-            font-weight: bold;
-            margin-right: 5px;
-        }
-        .input-group {
-            margin: 10px 0;
-        }
-        input {
-            width: 100%;
-            padding: 10px;
-            border: 1px solid #ddd;
-            border-radius: 6px;
-            font-size: 14px;
-            margin-top: 5px;
-        }
-        label {
-            font-size: 13px;
-            color: #555;
-            font-weight: 600;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <h1>🔥 Hot Updates Admin v2.1.0</h1>
-
-        <a href="index.html" class="back-link">← Вернуться к приложению</a>
-
-        <div id="status" class="status">
-            <div class="status-title">📱 Статус</div>
-            <div id="statusContent">Загрузка...</div>
-        </div>
-
-        <div class="progress" id="progress">
-            <div class="progress-bar" id="progressBar"></div>
-        </div>
-
-        <div class="section">
-            <div class="section-title">📋 Информация (DEBUG)</div>
-            <button onclick="getVersionInfo()">🔍 Получить версии</button>
-            <div id="versionInfo" style="margin-top: 10px; font-size: 12px; color: #666; line-height: 1.6; background: #f7fafc; padding: 10px; border-radius: 6px;"></div>
-        </div>
-
-        <div class="section">
-            <div class="section-title">⚡ Update (NEW API v2.1.0)</div>
-            <div class="input-group">
-                <label>URL:</label>
-                <input type="text" id="updateUrl" value="http://localhost:3000/api/updates/download/2.7.8/ios">
-            </div>
-            <button class="warning" onclick="performGetUpdate()">📥 Download</button>
-            <button class="success" onclick="performInstallUpdate()">🚀 Install</button>
-            <button class="danger" onclick="performFullUpdate()">⚡ FULL UPDATE</button>
-        </div>
-
-        <div class="section">
-            <div class="section-title">🐦 Canary (ТЗ п.4)</div>
-            <p style="font-size: 11px; color: #666; margin-bottom: 8px;">
-                Вызывается автоматически при старте JS. Timeout: 20 сек → auto rollback.
-            </p>
-            <button class="success" onclick="confirmCanary()">✅ Confirm Canary</button>
-        </div>
-
-        <div class="section">
-            <div class="section-title">🚫 Ignore List (Read-Only)</div>
-            <p style="font-size: 11px; color: #666; margin-bottom: 8px;">
-                Управляется native (добавляет при auto-rollback). JS только читает.
-            </p>
-            <button class="warning" onclick="getIgnoreList()">📋 Show Ignore List</button>
-        </div>
-
-        <div class="section">
-            <div class="section-title">📝 Логи</div>
-            <div id="log" class="log"></div>
-            <button class="danger" onclick="clearLog()" style="margin-top: 10px;">Очистить</button>
-        </div>
-    </div>
-
-    <script src="cordova.js"></script>
-    <script>
-        // APP VERSION - берется динамически из native (installedVersion или appBundleVersion)
-        window.APP_VERSION = null; // Заполняется асинхронно в deviceready
-    </script>
-    <script>
-        const logContainer = document.getElementById('log');
-        const statusContent = document.getElementById('statusContent');
-        const progressBar = document.getElementById('progressBar');
-        const progress = document.getElementById('progress');
-
-        function log(message, type = 'info') {
-            const time = new Date().toLocaleTimeString('ru-RU');
-            const entry = document.createElement('div');
-            entry.className = `log-entry log-${type}`;
-            entry.innerHTML = `<span class="log-time">[${time}]</span>${message}`;
-            logContainer.insertBefore(entry, logContainer.firstChild);
-            console.log(message);
-        }
-
-        function clearLog() {
-            logContainer.innerHTML = '';
-        }
-
-        function updateStatus(info) {
-            statusContent.innerHTML = `
-                <div><span class="version-badge">Bundle</span>${info.appBundleVersion || 'N/A'}</div>
-                <div><span class="version-badge">Installed</span>${info.installedVersion || 'N/A'}</div>
-                <div><span class="version-badge">Previous</span>${info.previousVersion || 'N/A'}</div>
-                <div style="margin-top: 10px;">
-                    Auto: <strong>${info.autoUpdateEnabled ? '✅' : '❌'}</strong> |
-                    Rollback: <strong>${info.canRollback ? '✅' : '❌'}</strong>
-                </div>
-            `;
-        }
-
-        function showProgress(percent) {
-            progress.style.display = 'block';
-            progressBar.style.width = percent + '%';
-        }
-
-        function hideProgress() {
-            progress.style.display = 'none';
-            progressBar.style.width = '0%';
-        }
-
-        document.addEventListener('deviceready', function() {
-            log('✅ Admin panel ready', 'success');
-            log('ℹ️ v2.1.0 - 4 API methods only', 'info');
-
-            if (navigator.splashscreen) {
-                navigator.splashscreen.hide();
-            }
-
-            statusContent.innerHTML = `
-                <div>🔥 Hot Updates v2.1.0 Final</div>
-                <div style="margin-top: 5px; font-size: 11px;">
-                    Loading info...
-                </div>
-            `;
-
-            // ВАЖНО: Загружаем версию динамически из native
-            cordova.exec(
-                function(info) {
-                    // Устанавливаем текущую версию (installedVersion или appBundleVersion)
-                    window.APP_VERSION = info.installedVersion || info.appBundleVersion;
-                    log(`📱 Current version: ${window.APP_VERSION}`, 'info');
-
-                    // Автоматически загружаем полную информацию
-                    setTimeout(() => getVersionInfo(), 100);
-                },
-                function(error) {
-                    log(`❌ Failed to load version: ${JSON.stringify(error)}`, 'error');
-                    window.APP_VERSION = '2.7.7'; // Fallback
-                    setTimeout(() => getVersionInfo(), 500);
-                },
-                'HotUpdates',
-                'getVersionInfo',
-                []
-            );
-        }, false);
-
-        // DEBUG: getVersionInfo для отладки
-        function getVersionInfo() {
-            log('🔍 Getting version info...', 'info');
-            cordova.exec(
-                function(info) {
-                    log('✅ Version info received', 'success');
-
-                    const versionInfoDiv = document.getElementById('versionInfo');
-                    versionInfoDiv.innerHTML = `
-                        <strong>Bundle:</strong> ${info.appBundleVersion}<br>
-                        <strong>Installed:</strong> ${info.installedVersion || 'none'}<br>
-                        <strong>Previous:</strong> ${info.previousVersion || 'none'}<br>
-                        <strong>Canary:</strong> ${info.canaryVersion || 'none'}<br>
-                        <strong>Pending:</strong> ${info.pendingVersion || 'none'} ${info.hasPendingUpdate ? '✅' : ''}<br>
-                        <strong>Ignore List:</strong> ${info.ignoreList.length ? info.ignoreList.join(', ') : 'empty'}
-                    `;
-
-                    statusContent.innerHTML = `
-                        <div>Current: ${info.installedVersion || info.appBundleVersion}</div>
-                        <div style="margin-top: 5px; font-size: 11px;">
-                            Previous: ${info.previousVersion || 'none'}
-                        </div>
-                    `;
-                },
-                function(error) {
-                    log(`❌ Error: ${JSON.stringify(error)}`, 'error');
-                },
-                'HotUpdates',
-                'getVersionInfo',
-                []
-            );
-        }
-
-        // NEW API v2.1.0: getUpdate - только загрузка
-        function performGetUpdate() {
-            const url = document.getElementById('updateUrl').value;
-            if (!url) {
-                log('❌ URL required!', 'error');
-                return;
-            }
-
-            // Извлекаем версию из URL (например: /2.7.8/ → 2.7.8)
-            const versionMatch = url.match(/\/(\d+\.\d+\.\d+)\//);
-            const version = versionMatch ? versionMatch[1] : 'pending';
-
-            log(`📥 Downloading version ${version}...`, 'info');
-            showProgress(0);
-
-            cordova.exec(
-                function(result) {
-                    log(`✅ Downloaded!`, 'success');
-                    log(`ℹ️ If you ignore popup, update installs on next launch`, 'info');
-                    showProgress(100);
-                    setTimeout(() => hideProgress(), 1000);
-                },
-                function(error) {
-                    log(`❌ ${error.error?.message || JSON.stringify(error)}`, 'error');
-                    hideProgress();
-                },
-                'HotUpdates',
-                'getUpdate',
-                [{url: url, version: version}]
-            );
-        }
-
-        // NEW API v2.1.0: forceUpdate - только установка (БЕЗ параметров!)
-        function performInstallUpdate() {
-            log(`🚀 Installing...`, 'info');
-            showProgress(50);
-
-            cordova.exec(
-                function(result) {
-                    log(`✅ Installed!`, 'success');
-                    showProgress(100);
-                    setTimeout(() => {
-                        hideProgress();
-                        log('ℹ️ WebView reloaded with new version', 'info');
-                    }, 1000);
-                },
-                function(error) {
-                    log(`❌ ${error.error?.message || JSON.stringify(error)}`, 'error');
-                    hideProgress();
-                },
-                'HotUpdates',
-                'forceUpdate',
-                []
-            );
-        }
-
-        // Full update: getUpdate + forceUpdate
-        function performFullUpdate() {
-            const url = document.getElementById('updateUrl').value;
-            if (!url) {
-                log('❌ URL required!', 'error');
-                return;
-            }
-
-            // Извлекаем версию из URL
-            const versionMatch = url.match(/\/(\d+\.\d+\.\d+)\//);
-            const version = versionMatch ? versionMatch[1] : 'pending';
-
-            log(`⚡ Full update to ${version}...`, 'info');
-            showProgress(0);
-
-            cordova.exec(
-                function(result) {
-                    log(`✅ Downloaded`, 'success');
-                    showProgress(50);
-
-                    cordova.exec(
-                        function(installResult) {
-                            log(`✅ Installed!`, 'success');
-                            showProgress(100);
-                            setTimeout(() => {
-                                hideProgress();
-                                log('ℹ️ WebView reloaded with new version', 'info');
-                            }, 1000);
-                        },
-                        function(installError) {
-                            log(`❌ ${installError.error?.message || JSON.stringify(installError)}`, 'error');
-                            hideProgress();
-                        },
-                        'HotUpdates',
-                        'forceUpdate',
-                        []
-                    );
-                },
-                function(downloadError) {
-                    log(`❌ ${downloadError.error?.message || JSON.stringify(downloadError)}`, 'error');
-                    hideProgress();
-                },
-                'HotUpdates',
-                'getUpdate',
-                [{url: url, version: version}]
-            );
-        }
-
-        function confirmCanary() {
-            // Версия берется из глобальной переменной window.APP_VERSION
-            // В production она устанавливается в app.js при сборке
-            const version = window.APP_VERSION || '2.7.7';
-
-            log(`🐦 Confirming canary for version ${version}...`, 'info');
-
-            cordova.exec(
-                function(result) {
-                    log(`✅ Canary confirmed for ${version}!`, 'success');
-                },
-                function(error) {
-                    log(`❌ ${JSON.stringify(error)}`, 'error');
-                },
-                'HotUpdates',
-                'canary',
-                [version]
-            );
-        }
-
-        // ❌ performRollback() REMOVED - rollback is automatic only (canary timeout 20 sec)
-
-        function getIgnoreList() {
-            log('📋 Getting list...', 'info');
-            cordova.exec(
-                function(result) {
-                    // NEW API v2.1.0: {versions: []}
-                    const versions = result.versions || [];
-                    if (versions.length > 0) {
-                        log(`✅ (${versions.length}): ${versions.join(', ')}`, 'success');
-                    } else {
-                        log(`ℹ️ Empty`, 'info');
-                    }
-                },
-                function(error) {
-                    log(`❌ ${JSON.stringify(error)}`, 'error');
-                },
-                'HotUpdates',
-                'getIgnoreList',
-                []
-            );
-        }
-    </script>
-</body>
-</html>