cordova-plugin-hot-updates 2.1.2 → 2.2.1

package/src/ios/HotUpdates.m

@@ -13,7 +13,7 @@
  *          - Auto-install pending updates on next app launch
  *
  * @version 2.1.2
- * @date 2025-11-13
+ * @date 2025-11-26
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.
  */
@@ -21,27 +21,10 @@
 #import <Cordova/CDV.h>
 #import <Cordova/CDVViewController.h>
 #import "HotUpdates.h"
+#import "HotUpdates+Helpers.h"
+#import "HotUpdatesConstants.h"
 #import <SSZipArchive/SSZipArchive.h>
 
-// Storage keys
-static NSString * const kInstalledVersion = @"hot_updates_installed_version";
-static NSString * const kPendingVersion = @"hot_updates_pending_version";
-static NSString * const kHasPending = @"hot_updates_has_pending";
-static NSString * const kPreviousVersion = @"hot_updates_previous_version";
-static NSString * const kIgnoreList = @"hot_updates_ignore_list";
-static NSString * const kCanaryVersion = @"hot_updates_canary_version";
-static NSString * const kDownloadInProgress = @"hot_updates_download_in_progress";
-
-// Constants for v2.1.0
-static NSString * const kPendingUpdateURL = @"hot_updates_pending_update_url";
-static NSString * const kPendingUpdateReady = @"hot_updates_pending_ready";
-
-// Directory names
-static NSString * const kWWWDirName = @"www";
-static NSString * const kPreviousWWWDirName = @"www_previous";
-static NSString * const kBackupWWWDirName = @"www_backup";
-static NSString * const kPendingUpdateDirName = @"pending_update";
-
 // Флаг для предотвращения повторных перезагрузок при навигации внутри WebView
 static BOOL hasPerformedInitialReload = NO;
 
@@ -65,24 +48,22 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)pluginInitialize {
     [super pluginInitialize];
 
-    // Получаем пути к директориям
     NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
     documentsPath = [paths objectAtIndex:0];
     wwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
     previousVersionPath = [documentsPath stringByAppendingPathComponent:kPreviousWWWDirName];
 
-    // Загружаем конфигурацию
     [self loadConfiguration];
-
-    // Загрузка ignoreList
     [self loadIgnoreList];
 
-    // Инициализация переменных
+    // Сбрасываем флаг загрузки (если приложение было убито во время загрузки)
+    isDownloadingUpdate = NO;
+    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kDownloadInProgress];
+
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
     pendingUpdateVersion = nil;
 
-    // Загружаем информацию о pending update если есть
     pendingUpdateURL = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingUpdateURL];
     isUpdateReadyToInstall = [[NSUserDefaults standardUserDefaults] boolForKey:kPendingUpdateReady];
     if (isUpdateReadyToInstall) {
@@ -95,29 +76,18 @@ static BOOL hasPerformedInitialReload = NO;
     NSLog(@"[HotUpdates] Documents www path: %@", wwwPath);
     NSLog(@"[HotUpdates] Ignore list: %@", ignoreList);
 
-    // 1. Проверяем и устанавливаем pending updates
     [self checkAndInstallPendingUpdate];
-
-    // 2. Создаем папку www если её нет (копируем из bundle)
     [self initializeWWWFolder];
-
-    // 3. Переключаем WebView на обновленный контент и перезагружаем
     [self switchToUpdatedContentWithReload];
 
-    // 4. Запускаем canary timer на 20 секунд
     NSString *currentVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     if (currentVersion) {
         NSString *canaryVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kCanaryVersion];
 
-        // Если canary еще не был вызван для текущей версии
         if (!canaryVersion || ![canaryVersion isEqualToString:currentVersion]) {
             NSLog(@"[HotUpdates] Starting canary timer (20 seconds) for version %@", currentVersion);
 
-            canaryTimer = [NSTimer scheduledTimerWithTimeInterval:20.0
-                                                           target:self
-                                                         selector:@selector(canaryTimeout)
-                                                         userInfo:nil
-                                                          repeats:NO];
+            [self startCanaryTimer];
         } else {
             NSLog(@"[HotUpdates] Canary already confirmed for version %@", currentVersion);
         }
@@ -127,7 +97,6 @@ static BOOL hasPerformedInitialReload = NO;
 }
 
 - (void)loadConfiguration {
-    // Получаем версию bundle приложения
     appBundleVersion = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"];
     if (!appBundleVersion) {
         appBundleVersion = @"1.0.0";
@@ -144,16 +113,10 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)checkAndInstallPendingUpdate {
     BOOL hasPendingUpdate = [[NSUserDefaults standardUserDefaults] boolForKey:kHasPending];
     NSString *pendingVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
-    NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
 
-    // ТЗ п.7: Если пользователь проигнорировал попап, обновление устанавливается автоматически при следующем запуске
     if (hasPendingUpdate && pendingVersion) {
-        // ВАЖНО (ТЗ): НЕ проверяем ignoreList - JS сам решил загрузить эту версию
-        // Если версия скачана (через getUpdate), значит JS одобрил её установку
-
         NSLog(@"[HotUpdates] Installing pending update %@ to Documents/www (auto-install on launch)", pendingVersion);
 
-        // НОВОЕ: Создаем резервную копию текущей версии перед установкой
         [self backupCurrentVersion];
 
         NSString *pendingUpdatePath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
@@ -161,24 +124,20 @@ static BOOL hasPerformedInitialReload = NO;
         NSString *documentsWwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
 
         if ([[NSFileManager defaultManager] fileExistsAtPath:pendingWwwPath]) {
-            // Удаляем старую Documents/www
             if ([[NSFileManager defaultManager] fileExistsAtPath:documentsWwwPath]) {
                 [[NSFileManager defaultManager] removeItemAtPath:documentsWwwPath error:nil];
             }
 
-            // Копируем pending_update/www в Documents/www
             NSError *copyError = nil;
             BOOL copySuccess = [[NSFileManager defaultManager] copyItemAtPath:pendingWwwPath toPath:documentsWwwPath error:&copyError];
 
             if (copySuccess) {
-                // Помечаем как установленный
                 [[NSUserDefaults standardUserDefaults] setObject:pendingVersion forKey:kInstalledVersion];
                 [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending];
                 [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingVersion];
-                [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion]; // Сбрасываем canary для новой версии
+                [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion];
                 [[NSUserDefaults standardUserDefaults] synchronize];
 
-                // Очищаем pending_update папку
                 [[NSFileManager defaultManager] removeItemAtPath:pendingUpdatePath error:nil];
 
                 NSLog(@"[HotUpdates] Update %@ installed successfully (canary timer will start)", pendingVersion);
@@ -195,7 +154,7 @@ static BOOL hasPerformedInitialReload = NO;
  *          Uses static flag to prevent reload on every page navigation (only once per app launch)
  */
 - (void)switchToUpdatedContentWithReload {
-    // Предотвращаем повторные перезагрузки при навигации между страницами (например, admin → index.html)
+    // Предотвращаем повторные перезагрузки при навигации между страницами
     if (hasPerformedInitialReload) {
         NSLog(@"[HotUpdates] Initial reload already performed, skipping");
         return;
@@ -207,37 +166,42 @@ static BOOL hasPerformedInitialReload = NO;
         NSString *documentsWwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
         NSString *indexPath = [documentsWwwPath stringByAppendingPathComponent:@"index.html"];
 
-        // Проверяем, что файлы действительно существуют
         if ([[NSFileManager defaultManager] fileExistsAtPath:indexPath]) {
             NSLog(@"[HotUpdates] Using WebView reload approach");
             NSLog(@"[HotUpdates] Found installed update version: %@", installedVersion);
 
-            // Устанавливаем новый путь
             ((CDVViewController *)self.viewController).wwwFolderName = documentsWwwPath;
             NSLog(@"[HotUpdates] Changed wwwFolderName to: %@", documentsWwwPath);
 
-            // Принудительно перезагружаем WebView для применения нового пути
-            [self reloadWebView];
-
-            // Устанавливаем флаг, чтобы больше не перезагружать при навигации
             hasPerformedInitialReload = YES;
 
-            NSLog(@"[HotUpdates] WebView reloaded with updated content (version: %@)", installedVersion);
+            // Очищаем кэш перед перезагрузкой, иначе может загрузиться старая версия
+            [self clearWebViewCacheWithCompletion:^{
+                [self reloadWebView];
+                NSLog(@"[HotUpdates] WebView reloaded with updated content (version: %@)", installedVersion);
+            }];
         } else {
             NSLog(@"[HotUpdates] Documents/www/index.html not found, keeping bundle www");
         }
     } else {
         NSLog(@"[HotUpdates] No installed updates, using bundle www");
-        // Устанавливаем флаг даже если нет обновлений, чтобы не проверять постоянно
         hasPerformedInitialReload = YES;
     }
 }
 
 /*!
- * @brief Force reload the WebView
- * @details Uses WKWebView loadFileURL with proper sandbox permissions
+ * @brief Clear WebView cache
+ * @details Clears disk cache, memory cache, offline storage and service workers
  */
 - (void)clearWebViewCache {
+    [self clearWebViewCacheWithCompletion:nil];
+}
+
+/*!
+ * @brief Clear WebView cache with completion handler
+ * @param completion Block called after cache is cleared (on main thread)
+ */
+- (void)clearWebViewCacheWithCompletion:(void (^)(void))completion {
     NSLog(@"[HotUpdates] Clearing WebView cache");
 
     NSSet *websiteDataTypes = [NSSet setWithArray:@[
@@ -252,15 +216,16 @@ static BOOL hasPerformedInitialReload = NO;
                                                modifiedSince:dateFrom
                                            completionHandler:^{
         NSLog(@"[HotUpdates] WebView cache cleared");
+        if (completion) {
+            dispatch_async(dispatch_get_main_queue(), completion);
+        }
     }];
 }
 
 - (void)reloadWebView {
-    // Приводим к типу CDVViewController для доступа к webViewEngine
     if ([self.viewController isKindOfClass:[CDVViewController class]]) {
         CDVViewController *cdvViewController = (CDVViewController *)self.viewController;
 
-        // Строим новый URL для обновленного контента
         NSString *documentsWwwPath = [documentsPath stringByAppendingPathComponent:kWWWDirName];
         NSString *indexPath = [documentsWwwPath stringByAppendingPathComponent:@"index.html"];
         NSURL *fileURL = [NSURL fileURLWithPath:indexPath];
@@ -270,13 +235,11 @@ static BOOL hasPerformedInitialReload = NO;
 
         id webViewEngine = cdvViewController.webViewEngine;
         if (webViewEngine && [webViewEngine respondsToSelector:@selector(engineWebView)]) {
-            // Получаем WKWebView
             WKWebView *webView = [webViewEngine performSelector:@selector(engineWebView)];
 
             if (webView && [webView isKindOfClass:[WKWebView class]]) {
-                // Используем loadFileURL:allowingReadAccessToURL: для правильных sandbox permissions
+                // loadFileURL:allowingReadAccessToURL: правильно настраивает sandbox permissions для локальных файлов
                 dispatch_async(dispatch_get_main_queue(), ^{
-                    // Этот метод правильно настраивает sandbox для локальных файлов
                     [webView loadFileURL:fileURL allowingReadAccessToURL:allowReadAccessToURL];
                     NSLog(@"[HotUpdates] WebView loadFileURL executed with sandbox permissions");
                 });
@@ -294,12 +257,10 @@ static BOOL hasPerformedInitialReload = NO;
 
 - (void)initializeWWWFolder {
     NSFileManager *fileManager = [NSFileManager defaultManager];
-    
-    // Проверяем, существует ли папка www в Documents
+
     if (![fileManager fileExistsAtPath:wwwPath]) {
         NSLog(@"[HotUpdates] WWW folder not found in Documents. Creating and copying from bundle...");
-        
-        // Копируем содержимое www из bundle в Documents
+
         NSString *bundleWWWPath = [[NSBundle mainBundle] pathForResource:@"www" ofType:nil];
         if (bundleWWWPath) {
             NSError *error;
@@ -323,7 +284,6 @@ static BOOL hasPerformedInitialReload = NO;
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error = nil;
 
-    // Создаем папку назначения если её нет
     if (![fileManager fileExistsAtPath:destination]) {
         [fileManager createDirectoryAtPath:destination withIntermediateDirectories:YES attributes:nil error:&error];
         if (error) {
@@ -332,24 +292,19 @@ static BOOL hasPerformedInitialReload = NO;
         }
     }
 
-    // Распаковка ZIP архива с SSZipArchive
     NSLog(@"[HotUpdates] Extracting ZIP archive using SSZipArchive library");
 
-    // Простая проверка файла
     if (![[NSFileManager defaultManager] fileExistsAtPath:zipPath]) {
         NSLog(@"[HotUpdates] ZIP file does not exist: %@", zipPath);
         return NO;
     }
-    
-    // Создаем временную папку для распаковки
+
     NSString *tempExtractPath = [destination stringByAppendingPathComponent:@"temp_extract"];
-    
-    // Удаляем существующую временную папку
+
     if ([[NSFileManager defaultManager] fileExistsAtPath:tempExtractPath]) {
         [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
     }
-    
-    // Создаем временную папку
+
     if (![[NSFileManager defaultManager] createDirectoryAtPath:tempExtractPath withIntermediateDirectories:YES attributes:nil error:&error]) {
         NSLog(@"[HotUpdates] Failed to create temp extraction folder: %@", error.localizedDescription);
         return NO;
@@ -357,17 +312,15 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Extracting to temp location: %@", tempExtractPath);
 
-    // Распаковываем ZIP архив
     BOOL extractSuccess = [SSZipArchive unzipFileAtPath:zipPath toDestination:tempExtractPath];
 
     if (extractSuccess) {
         NSLog(@"[HotUpdates] ZIP extraction successful");
 
-        // Проверяем содержимое распакованного архива
         NSArray *extractedContents = [[NSFileManager defaultManager] contentsOfDirectoryAtPath:tempExtractPath error:nil];
         NSLog(@"[HotUpdates] Extracted contents: %@", extractedContents);
-        
-        // Ищем папку www в распакованном содержимом
+
+        // Ищем папку www (может быть вложенной)
         NSString *wwwSourcePath = nil;
         for (NSString *item in extractedContents) {
             NSString *itemPath = [tempExtractPath stringByAppendingPathComponent:item];
@@ -377,7 +330,6 @@ static BOOL hasPerformedInitialReload = NO;
                     wwwSourcePath = itemPath;
                     break;
                 }
-                // Проверяем, есть ли www внутри папки
                 NSString *nestedWwwPath = [itemPath stringByAppendingPathComponent:@"www"];
                 if ([[NSFileManager defaultManager] fileExistsAtPath:nestedWwwPath]) {
                     wwwSourcePath = nestedWwwPath;
@@ -385,26 +337,22 @@ static BOOL hasPerformedInitialReload = NO;
                 }
             }
         }
-        
+
         if (wwwSourcePath) {
             NSLog(@"[HotUpdates] Found www folder at: %@", wwwSourcePath);
 
-            // Копируем www папку в финальное место
             NSString *finalWwwPath = [destination stringByAppendingPathComponent:@"www"];
 
-            // Удаляем существующую папку www если есть
             if ([[NSFileManager defaultManager] fileExistsAtPath:finalWwwPath]) {
                 [[NSFileManager defaultManager] removeItemAtPath:finalWwwPath error:nil];
             }
 
-            // Копируем новую www папку
             NSError *copyError = nil;
             BOOL copySuccess = [[NSFileManager defaultManager] copyItemAtPath:wwwSourcePath toPath:finalWwwPath error:&copyError];
 
             if (copySuccess) {
                 NSLog(@"[HotUpdates] www folder copied successfully to: %@", finalWwwPath);
 
-                // Очищаем временную папку
                 [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
 
                 NSLog(@"[HotUpdates] ZIP extraction completed successfully");
@@ -417,11 +365,9 @@ static BOOL hasPerformedInitialReload = NO;
             NSLog(@"[HotUpdates] Available contents: %@", extractedContents);
         }
 
-        // Очищаем временную папку при ошибке
         [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
     } else {
         NSLog(@"[HotUpdates] Failed to extract ZIP archive");
-        // Очищаем временную папку при ошибке
         [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
     }
 
@@ -463,6 +409,28 @@ static BOOL hasPerformedInitialReload = NO;
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }
 
+#pragma mark - Canary Timer
+
+/*!
+ * @brief Start canary timer with weak self to prevent retain cycle
+ * @details Uses block-based timer (iOS 10+) with weak reference
+ */
+- (void)startCanaryTimer {
+    // Инвалидируем предыдущий таймер если есть
+    if (canaryTimer && [canaryTimer isValid]) {
+        [canaryTimer invalidate];
+        canaryTimer = nil;
+    }
+
+    // Используем weak self для предотвращения retain cycle
+    __weak __typeof__(self) weakSelf = self;
+    canaryTimer = [NSTimer scheduledTimerWithTimeInterval:20.0
+                                                  repeats:NO
+                                                    block:^(NSTimer * _Nonnull timer) {
+        [weakSelf canaryTimeout];
+    }];
+}
+
 #pragma mark - Canary Timeout Handler
 
 - (void)canaryTimeout {
@@ -471,7 +439,6 @@ static BOOL hasPerformedInitialReload = NO;
     NSString *currentVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     NSString *previousVersion = [self getPreviousVersion];
 
-    // Если некуда откатываться (свежая установка из Store) - ничего не делаем
     if (!previousVersion || previousVersion.length == 0) {
         NSLog(@"[HotUpdates] Fresh install from Store, rollback not possible");
         return;
@@ -479,23 +446,17 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Version %@ considered faulty, performing rollback", currentVersion);
 
-    // Добавляем в ignoreList
-    if (currentVersion) {
-        [self addVersionToIgnoreList:currentVersion];
-    }
-
-    // Выполняем rollback
+    // Примечание: версия добавляется в ignoreList внутри rollbackToPreviousVersion
     BOOL rollbackSuccess = [self rollbackToPreviousVersion];
 
     if (rollbackSuccess) {
         NSLog(@"[HotUpdates] Automatic rollback completed successfully");
 
-        // Сбрасываем флаг для разрешения перезагрузки после rollback
         hasPerformedInitialReload = NO;
 
-        // Очищаем кэш и перезагружаем WebView
-        [self clearWebViewCache];
-        [self reloadWebView];
+        [self clearWebViewCacheWithCompletion:^{
+            [self reloadWebView];
+        }];
     } else {
         NSLog(@"[HotUpdates] Automatic rollback failed");
     }
@@ -549,26 +510,23 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Rollback: %@ -> %@", currentVersion ?: @"bundle", previousVersion ?: @"nil");
 
-    // Проверка: нет previousVersion
     if (!previousVersion || previousVersion.length == 0) {
         NSLog(@"[HotUpdates] Rollback failed: no previous version");
         return NO;
     }
 
-    // Проверка: папка не существует
     if (![fileManager fileExistsAtPath:previousVersionPath]) {
         NSLog(@"[HotUpdates] Rollback failed: previous version folder not found");
         return NO;
     }
 
-    // Проверка: previous = current (защита от цикла)
+    // Защита от цикла rollback
     NSString *effectiveCurrentVersion = currentVersion ?: appBundleVersion;
     if ([previousVersion isEqualToString:effectiveCurrentVersion]) {
         NSLog(@"[HotUpdates] Rollback failed: cannot rollback to same version");
         return NO;
     }
 
-    // Создаем временную резервную копию текущей
     NSString *tempBackupPath = [documentsPath stringByAppendingPathComponent:kBackupWWWDirName];
     if ([fileManager fileExistsAtPath:tempBackupPath]) {
         [fileManager removeItemAtPath:tempBackupPath error:nil];
@@ -576,7 +534,6 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSError *error = nil;
 
-    // Бэкапим текущую версию
     if ([fileManager fileExistsAtPath:wwwPath]) {
         [fileManager moveItemAtPath:wwwPath toPath:tempBackupPath error:&error];
         if (error) {
@@ -585,23 +542,19 @@ static BOOL hasPerformedInitialReload = NO;
         }
     }
 
-    // Копируем предыдущую версию
     BOOL success = [fileManager copyItemAtPath:previousVersionPath
                                         toPath:wwwPath
                                          error:&error];
 
     if (success) {
-        // Обновляем метаданные (previousVersion очищается для предотвращения циклов)
         [[NSUserDefaults standardUserDefaults] setObject:previousVersion forKey:kInstalledVersion];
         [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPreviousVersion];
         [[NSUserDefaults standardUserDefaults] synchronize];
 
-        // Очищаем временный бэкап
         [fileManager removeItemAtPath:tempBackupPath error:nil];
 
         NSLog(@"[HotUpdates] Rollback successful: %@ -> %@", currentVersion, previousVersion);
 
-        // Добавляем проблемную версию в ignoreList
         if (currentVersion) {
             [self addVersionToIgnoreList:currentVersion];
         }
@@ -610,7 +563,6 @@ static BOOL hasPerformedInitialReload = NO;
     } else {
         NSLog(@"[HotUpdates] Rollback failed: %@", error.localizedDescription);
 
-        // Восстанавливаем текущую версию
         if ([fileManager fileExistsAtPath:tempBackupPath]) {
             [fileManager moveItemAtPath:tempBackupPath toPath:wwwPath error:nil];
         }
@@ -622,15 +574,16 @@ static BOOL hasPerformedInitialReload = NO;
 #pragma mark - Get Update (Download Only)
 
 - (void)getUpdate:(CDVInvokedUrlCommand*)command {
-    NSDictionary *updateData = [command.arguments objectAtIndex:0];
+    // Безопасное получение первого аргумента
+    NSDictionary *updateData = nil;
+    if (command.arguments.count > 0 && [command.arguments[0] isKindOfClass:[NSDictionary class]]) {
+        updateData = command.arguments[0];
+    }
 
     if (!updateData) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Update data required"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorUpdateDataRequired
+                                                                                message:@"Update data required"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
@@ -639,16 +592,12 @@ static BOOL hasPerformedInitialReload = NO;
 
     if (!downloadURL) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"URL required"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorURLRequired
+                                                                                message:@"URL is required"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // Опциональная версия (для автоустановки при следующем запуске)
     NSString *updateVersion = [updateData objectForKey:@"version"];
     if (!updateVersion) {
         updateVersion = @"pending";
@@ -657,50 +606,38 @@ static BOOL hasPerformedInitialReload = NO;
     NSLog(@"[HotUpdates] getUpdate() called - downloading update from: %@", downloadURL);
     NSLog(@"[HotUpdates] Version: %@", updateVersion);
 
-    // ВАЖНО (ТЗ): НЕ проверяем ignoreList - JS сам контролирует что загружать
-
-    // 1. Проверяем, не установлена ли уже эта версия
     NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     if (installedVersion && [installedVersion isEqualToString:updateVersion]) {
         NSLog(@"[HotUpdates] Version %@ already installed, skipping download", updateVersion);
-        // Возвращаем SUCCESS - версия уже установлена
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // 2. Проверяем, не скачана ли уже эта версия (hasPending + та же версия)
     BOOL hasPending = [[NSUserDefaults standardUserDefaults] boolForKey:kHasPending];
     NSString *existingPendingVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
 
     if (hasPending && existingPendingVersion && [existingPendingVersion isEqualToString:updateVersion]) {
         NSLog(@"[HotUpdates] Version %@ already downloaded, skipping re-download", updateVersion);
-        // Возвращаем SUCCESS - версия уже скачана, повторная загрузка не нужна
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // 3. Проверяем, не скачивается ли уже обновление
     if (isDownloadingUpdate) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Download already in progress"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorDownloadInProgress
+                                                                                message:@"Download already in progress"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // Сохраняем URL и версию для последующей установки и автоустановки
     pendingUpdateURL = downloadURL;
     pendingUpdateVersion = updateVersion;
     [[NSUserDefaults standardUserDefaults] setObject:downloadURL forKey:kPendingUpdateURL];
     [[NSUserDefaults standardUserDefaults] setObject:updateVersion forKey:kPendingVersion];
     [[NSUserDefaults standardUserDefaults] synchronize];
 
-    // Запускаем загрузку
     [self downloadUpdateOnly:downloadURL callbackId:command.callbackId];
 }
 
@@ -712,15 +649,30 @@ static BOOL hasPerformedInitialReload = NO;
     NSLog(@"[HotUpdates] Starting download");
 
     NSURL *url = [NSURL URLWithString:downloadURL];
+    if (!url) {
+        NSLog(@"[HotUpdates] Invalid URL: %@", downloadURL);
+        isDownloadingUpdate = NO;
+        [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kDownloadInProgress];
+        [[NSUserDefaults standardUserDefaults] synchronize];
+
+        CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
+                                                 messageAsDictionary:[self createError:kErrorURLRequired
+                                                                                message:@"Invalid URL format"]];
+        [self.commandDelegate sendPluginResult:result callbackId:callbackId];
+        return;
+    }
 
     NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
-    config.timeoutIntervalForRequest = 60.0;
-    config.timeoutIntervalForResource = 300.0;
+    config.timeoutIntervalForRequest = 30.0;  // ТЗ: 30-60 секунд
+    config.timeoutIntervalForResource = 60.0; // ТЗ: максимум 60 секунд на всю загрузку
 
     NSURLSession *session = [NSURLSession sessionWithConfiguration:config];
 
     NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithURL:url
                                                         completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
+        // Инвалидируем сессию для предотвращения утечки памяти
+        [session finishTasksAndInvalidate];
+
         self->isDownloadingUpdate = NO;
         [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kDownloadInProgress];
         [[NSUserDefaults standardUserDefaults] synchronize];
@@ -729,11 +681,8 @@ static BOOL hasPerformedInitialReload = NO;
             NSLog(@"[HotUpdates] Download failed: %@", error.localizedDescription);
 
             CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                     messageAsDictionary:@{
-                @"error": @{
-                    @"message": error.localizedDescription
-                }
-            }];
+                                                     messageAsDictionary:[self createError:kErrorDownloadFailed
+                                                                                    message:[NSString stringWithFormat:@"Download failed: %@", error.localizedDescription]]];
             [self.commandDelegate sendPluginResult:result callbackId:callbackId];
             return;
         }
@@ -743,11 +692,8 @@ static BOOL hasPerformedInitialReload = NO;
             NSLog(@"[HotUpdates] Download failed: HTTP %ld", (long)httpResponse.statusCode);
 
             CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                     messageAsDictionary:@{
-                @"error": @{
-                    @"message": [NSString stringWithFormat:@"HTTP %ld", (long)httpResponse.statusCode]
-                }
-            }];
+                                                     messageAsDictionary:[self createError:kErrorHTTPError
+                                                                                    message:[NSString stringWithFormat:@"HTTP error: %ld", (long)httpResponse.statusCode]]];
             [self.commandDelegate sendPluginResult:result callbackId:callbackId];
             return;
         }
@@ -767,15 +713,12 @@ static BOOL hasPerformedInitialReload = NO;
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error;
 
-    // Создаем временную папку для распаковки
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
 
-    // Удаляем старую временную папку
     if ([fileManager fileExistsAtPath:tempUpdatePath]) {
         [fileManager removeItemAtPath:tempUpdatePath error:nil];
     }
 
-    // Создаем новую временную папку
     [fileManager createDirectoryAtPath:tempUpdatePath
            withIntermediateDirectories:YES
                             attributes:nil
@@ -784,16 +727,12 @@ static BOOL hasPerformedInitialReload = NO;
     if (error) {
         NSLog(@"[HotUpdates] Error creating temp directory: %@", error);
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Cannot create temp directory"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorTempDirError
+                                                                                message:@"Cannot create temp directory"]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Распаковываем обновление
     BOOL unzipSuccess = [self unzipFile:updateLocation.path toDestination:tempUpdatePath];
 
     if (!unzipSuccess) {
@@ -801,63 +740,49 @@ static BOOL hasPerformedInitialReload = NO;
         [fileManager removeItemAtPath:tempUpdatePath error:nil];
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Failed to extract update package"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorExtractionFailed
+                                                                                message:@"Failed to extract update package"]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Проверяем наличие www папки
     NSString *tempWwwPath = [tempUpdatePath stringByAppendingPathComponent:kWWWDirName];
     if (![fileManager fileExistsAtPath:tempWwwPath]) {
         NSLog(@"[HotUpdates] www folder not found in update package");
         [fileManager removeItemAtPath:tempUpdatePath error:nil];
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"www folder not found in package"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorWWWNotFound
+                                                                                message:@"www folder not found in package"]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Копируем также в pending_update для автоустановки при следующем запуске (ТЗ п.7)
+    // Копируем в pending_update для автоустановки при следующем запуске
     NSString *pendingPath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
 
-    // Удаляем старую pending_update папку
     if ([fileManager fileExistsAtPath:pendingPath]) {
         [fileManager removeItemAtPath:pendingPath error:nil];
     }
 
-    // Копируем temp_downloaded_update → pending_update
     BOOL copySuccess = [fileManager copyItemAtPath:tempUpdatePath
                                             toPath:pendingPath
                                              error:&error];
 
     if (!copySuccess) {
         NSLog(@"[HotUpdates] Failed to copy to pending_update: %@", error);
-        // Не критично - forceUpdate всё равно сработает из temp_downloaded_update
     } else {
         NSLog(@"[HotUpdates] Copied to pending_update for auto-install on next launch");
     }
 
-    // Помечаем обновление как готовое к установке (для forceUpdate)
     isUpdateReadyToInstall = YES;
     [[NSUserDefaults standardUserDefaults] setBool:YES forKey:kPendingUpdateReady];
-
-    // Устанавливаем флаг для автоустановки при следующем запуске (ТЗ п.7)
     [[NSUserDefaults standardUserDefaults] setBool:YES forKey:kHasPending];
     [[NSUserDefaults standardUserDefaults] synchronize];
 
     NSLog(@"[HotUpdates] Update downloaded and ready to install");
     NSLog(@"[HotUpdates] If user ignores popup, update will install automatically on next launch");
 
-    // Возвращаем успех (callback без ошибки) - ТЗ: возвращаем null при успехе
     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
 }
@@ -867,16 +792,10 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)forceUpdate:(CDVInvokedUrlCommand*)command {
     NSLog(@"[HotUpdates] forceUpdate() called - installing downloaded update");
 
-    // ВАЖНО: Не проверяем ignoreList - это контролирует JS
-
-    // Проверяем, что обновление было скачано
     if (!isUpdateReadyToInstall) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"No update ready to install. Call getUpdate() first."
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorNoUpdateReady
+                                                                                message:@"No update ready to install"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
@@ -884,47 +803,36 @@ static BOOL hasPerformedInitialReload = NO;
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
     NSString *tempWwwPath = [tempUpdatePath stringByAppendingPathComponent:kWWWDirName];
 
-    // Проверяем наличие скачанных файлов
     if (![[NSFileManager defaultManager] fileExistsAtPath:tempWwwPath]) {
         NSLog(@"[HotUpdates] Downloaded update files not found");
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": @"Downloaded update files not found"
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorUpdateFilesNotFound
+                                                                                message:@"Downloaded update files not found"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
 
-    // Устанавливаем обновление
     [self installDownloadedUpdate:tempWwwPath callbackId:command.callbackId];
 }
 
 - (void)installDownloadedUpdate:(NSString*)tempWwwPath callbackId:(NSString*)callbackId {
     NSLog(@"[HotUpdates] Installing update");
 
-    // Определяем версию ДО установки
     NSString *versionToInstall = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
     if (!versionToInstall) {
         versionToInstall = @"unknown";
     }
 
-    // ВАЖНО (ТЗ): НЕ проверяем ignoreList - JS сам контролирует что устанавливать
-
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error;
 
-    // ВАЖНО: Создаем резервную копию текущей версии
     [self backupCurrentVersion];
 
-    // Удаляем текущую www
     if ([fileManager fileExistsAtPath:wwwPath]) {
         [fileManager removeItemAtPath:wwwPath error:nil];
     }
 
-    // Копируем новую версию
     BOOL copySuccess = [fileManager copyItemAtPath:tempWwwPath
                                             toPath:wwwPath
                                              error:&error];
@@ -933,78 +841,62 @@ static BOOL hasPerformedInitialReload = NO;
         NSLog(@"[HotUpdates] Failed to install update: %@", error);
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                 messageAsDictionary:@{
-            @"error": @{
-                @"message": error.localizedDescription
-            }
-        }];
+                                                 messageAsDictionary:[self createError:kErrorInstallFailed
+                                                                                message:[NSString stringWithFormat:@"Install failed: %@", error.localizedDescription]]];
         [self.commandDelegate sendPluginResult:result callbackId:callbackId];
         return;
     }
 
-    // Используем версию определенную ранее
     NSString *newVersion = versionToInstall;
 
-    // Обновляем метаданные
     [[NSUserDefaults standardUserDefaults] setObject:newVersion forKey:kInstalledVersion];
     [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kPendingUpdateReady];
-    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending]; // Очищаем флаг автоустановки
+    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending];
     [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingUpdateURL];
     [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingVersion];
-    [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion]; // Сбрасываем canary
+    [[NSUserDefaults standardUserDefaults] removeObjectForKey:kCanaryVersion];
     [[NSUserDefaults standardUserDefaults] synchronize];
 
-    // Очищаем временные папки
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
     NSString *pendingPath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
     [fileManager removeItemAtPath:tempUpdatePath error:nil];
     [fileManager removeItemAtPath:pendingPath error:nil];
 
-    // Сбрасываем флаги
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
+    pendingUpdateVersion = nil;
 
     NSLog(@"[HotUpdates] Update installed successfully");
 
-    // Возвращаем успех ПЕРЕД перезагрузкой - ТЗ: возвращаем null при успехе
     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
 
-    // КРИТИЧЕСКИ ВАЖНО: Запускаем canary timer ПЕРЕД перезагрузкой
-    // После reloadWebView pluginInitialize НЕ вызывается, поэтому таймер нужно запустить вручную
+    // После reloadWebView pluginInitialize НЕ вызывается, поэтому canary timer запускаем вручную
     NSLog(@"[HotUpdates] Starting canary timer (20 seconds) for version %@", newVersion);
 
-    // Останавливаем предыдущий таймер если был
-    if (canaryTimer && [canaryTimer isValid]) {
-        [canaryTimer invalidate];
-    }
-
-    // Запускаем новый таймер на 20 секунд
-    canaryTimer = [NSTimer scheduledTimerWithTimeInterval:20.0
-                                                   target:self
-                                                 selector:@selector(canaryTimeout)
-                                                 userInfo:nil
-                                                  repeats:NO];
+    [self startCanaryTimer];
 
-    // Сбрасываем флаг для разрешения перезагрузки после установки обновления
     hasPerformedInitialReload = NO;
 
-    // КРИТИЧЕСКИ ВАЖНО: Очищаем кэш WebView перед перезагрузкой
-    // Без этого может загрузиться старая закэшированная версия
-    [self clearWebViewCache];
-
-    // Перезагружаем WebView с новым контентом
-    [self reloadWebView];
+    // Очищаем кэш WebView перед перезагрузкой, иначе может загрузиться старая версия
+    [self clearWebViewCacheWithCompletion:^{
+        [self reloadWebView];
+    }];
 }
 
 #pragma mark - Canary
 
 - (void)canary:(CDVInvokedUrlCommand*)command {
-    NSString *canaryVersion = [command.arguments objectAtIndex:0];
+    // Безопасное получение первого аргумента
+    NSString *canaryVersion = nil;
+    if (command.arguments.count > 0 && [command.arguments[0] isKindOfClass:[NSString class]]) {
+        canaryVersion = command.arguments[0];
+    }
 
     if (!canaryVersion || canaryVersion.length == 0) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                                    messageAsString:@"Version required"];
+                                                 messageAsDictionary:[self createError:kErrorVersionRequired
+                                                                                message:@"Version is required"]];
         [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
         return;
     }
@@ -1022,16 +914,12 @@ static BOOL hasPerformedInitialReload = NO;
         NSLog(@"[HotUpdates] Canary timer stopped - JS confirmed bundle is working");
     }
 
-    CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK
-                                             messageAsDictionary:@{
-        @"success": @YES,
-        @"canaryVersion": canaryVersion,
-        @"message": @"Canary version confirmed"
-    }];
+    // ТЗ: при успехе callback возвращает null
+    CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }
 
-#pragma mark - Information Methods
+#pragma mark - Debug Methods
 
 - (void)getVersionInfo:(CDVInvokedUrlCommand*)command {
     NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
@@ -1055,14 +943,4 @@ static BOOL hasPerformedInitialReload = NO;
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }
 
-- (void)checkForUpdates:(CDVInvokedUrlCommand*)command {
-    CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
-                                             messageAsDictionary:@{
-        @"error": @{
-            @"message": @"checkForUpdates() removed in v2.1.0. Use fetch() in JS to check your server for updates, then call getUpdate({url}) to download."
-        }
-    }];
-    [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
-}
-
 @end