cordova-plugin-hot-updates 2.2.0 → 2.2.2

package/README.md

@@ -1,7 +1,18 @@
-# Cordova Hot Updates Plugin v2.2.0
+# Cordova Hot Updates Plugin v2.2.2
 
 Frontend-controlled manual hot updates for Cordova iOS applications using WebView Reload approach.
 
+## Changelog
+
+### v2.2.2 (2024-11-28)
+- **Fixed**: Failed download no longer corrupts previously downloaded update
+- **Fixed**: Infinite loop when pending update installation fails (flags now cleared)
+- **Fixed**: UserDefaults now saved only after successful download (not before)
+- **Improved**: ZIP file validation with magic bytes check (PK\x03\x04) before extraction
+- **Improved**: Cleaner logs without duplicates and full paths
+- **Improved**: All errors now have consistent format with `ERROR:` prefix
+- **Removed**: Redundant initialization code
+
 [![npm version](https://badge.fury.io/js/cordova-plugin-hot-updates.svg)](https://badge.fury.io/js/cordova-plugin-hot-updates)
 [![License](https://img.shields.io/badge/License-Custom%20Non--Commercial-blue.svg)](#license)
 
@@ -125,11 +136,11 @@ callback(null)
 ### Error Handling Example
 
 ```javascript
-window.hotUpdate.getUpdate({url: 'http://...'}, function(error) {
-  if (error) {
-    console.error('[HotUpdates]', error.code, ':', error.message);
+window.hotUpdate.getUpdate({url: 'http://...'}, function(result) {
+  if (result && result.error) {
+    console.error('[HotUpdates]', result.error.code, ':', result.error.message);
 
-    switch(error.code) {
+    switch(result.error.code) {
       case 'HTTP_ERROR':
         // Handle HTTP errors
         break;
@@ -137,7 +148,7 @@ window.hotUpdate.getUpdate({url: 'http://...'}, function(error) {
         // Handle network errors
         break;
       default:
-        console.error('Unknown error:', error);
+        console.error('Unknown error:', result.error);
     }
   } else {
     console.log('Update downloaded successfully');
@@ -268,6 +279,32 @@ window.hotUpdate.getIgnoreList(function(result) {
 
 ---
 
+### window.hotUpdate.getVersionInfo(callback)
+
+Returns version information (debug method).
+
+**Parameters:**
+- `callback` (Function) - `callback(info)`
+  - `info.appBundleVersion` (string) - Native app version from Info.plist
+  - `info.installedVersion` (string|null) - Current hot update version
+  - `info.previousVersion` (string|null) - Last working version (for rollback)
+  - `info.canaryVersion` (string|null) - Version confirmed by canary
+  - `info.pendingVersion` (string|null) - Version pending installation
+  - `info.hasPendingUpdate` (boolean) - Whether pending update exists
+  - `info.ignoreList` (string[]) - Array of problematic versions
+
+**Example:**
+```javascript
+window.hotUpdate.getVersionInfo(function(info) {
+    console.log('App version:', info.appBundleVersion);
+    console.log('Installed:', info.installedVersion);
+    console.log('Previous:', info.previousVersion);
+    console.log('Pending:', info.hasPendingUpdate ? info.pendingVersion : 'none');
+});
+```
+
+---
+
 ## Complete Update Flow
 
 ```javascript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-hot-updates",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Frontend-controlled manual hot updates for Cordova iOS apps using WebView Reload approach. Manual updates only, JavaScript controls all decisions.",
   "main": "www/HotUpdates.js",
   "scripts": {

package/plugin.xml

@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='utf-8'?>
 <plugin id="cordova-plugin-hot-updates"
-        version="2.2.0"
+        version="2.2.2"
         xmlns="http://apache.org/cordova/ns/plugins/1.0"
         xmlns:android="http://schemas.android.com/apk/res/android">
 

package/src/ios/HotUpdates+Helpers.h

@@ -2,7 +2,7 @@
  * @file HotUpdates+Helpers.h
  * @brief Helper methods for Hot Updates Plugin
  * @details Category extension providing utility methods for error handling
- * @version 2.2.0
+ * @version 2.1.0
  * @date 2025-11-13
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.

package/src/ios/HotUpdates+Helpers.m

@@ -2,7 +2,7 @@
  * @file HotUpdates+Helpers.m
  * @brief Implementation of helper methods for Hot Updates Plugin
  * @details Provides utility methods for error handling and response formatting
- * @version 2.2.0
+ * @version 2.1.0
  * @date 2025-11-13
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.

package/src/ios/HotUpdates.h

@@ -32,39 +32,13 @@
     NSString *previousVersionPath;    // Путь к предыдущей версии
 }
 
-// Plugin lifecycle methods
-- (void)pluginInitialize;
-- (void)loadConfiguration;
-- (void)initializeWWWFolder;
-- (void)checkAndInstallPendingUpdate;
-- (void)switchToUpdatedContentWithReload;
-- (void)reloadWebView;
-
-// Update management methods (internal)
-- (void)installPendingUpdate:(NSString*)newVersion;
-- (BOOL)unzipFile:(NSString *)zipPath toDestination:(NSString *)destinationPath;
-
-// Version comparison utilities
-- (NSComparisonResult)compareVersion:(NSString*)version1 withVersion:(NSString*)version2;
-
-// JavaScript callable methods (minimal set for debugging)
-- (void)getCurrentVersion:(CDVInvokedUrlCommand*)command;
-- (void)getPendingUpdateInfo:(CDVInvokedUrlCommand*)command;
-
-// Ignore List management (JS can only read, native controls)
-- (void)getIgnoreList:(CDVInvokedUrlCommand*)command;
-
-// Debug methods (for manual testing only)
-- (void)addToIgnoreList:(CDVInvokedUrlCommand*)command;
-- (void)removeFromIgnoreList:(CDVInvokedUrlCommand*)command;
-- (void)clearIgnoreList:(CDVInvokedUrlCommand*)command;
-
-// Update methods (v2.1.0 - manual updates only)
+// JavaScript API methods (v2.1.0)
 - (void)getUpdate:(CDVInvokedUrlCommand*)command;      // Download update
 - (void)forceUpdate:(CDVInvokedUrlCommand*)command;    // Install downloaded update
 - (void)canary:(CDVInvokedUrlCommand*)command;         // Confirm successful load
+- (void)getIgnoreList:(CDVInvokedUrlCommand*)command;  // Get ignore list (JS reads only)
 
-// Debug methods
+// Debug method
 - (void)getVersionInfo:(CDVInvokedUrlCommand*)command; // Get all version info for debugging
 
 @end

package/src/ios/HotUpdates.m

@@ -12,8 +12,8 @@
  *          - IgnoreList for tracking problematic versions
  *          - Auto-install pending updates on next app launch
  *
- * @version 2.2.0
- * @date 2025-11-03
+ * @version 2.2.2
+ * @date 2025-11-28
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.
  */
@@ -56,21 +56,18 @@ static BOOL hasPerformedInitialReload = NO;
     [self loadConfiguration];
     [self loadIgnoreList];
 
-    isUpdateReadyToInstall = NO;
-    pendingUpdateURL = nil;
-    pendingUpdateVersion = nil;
+    // Сбрасываем флаг загрузки (если приложение было убито во время загрузки)
+    isDownloadingUpdate = NO;
+    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kDownloadInProgress];
 
+    // Читаем состояние из UserDefaults
     pendingUpdateURL = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingUpdateURL];
     isUpdateReadyToInstall = [[NSUserDefaults standardUserDefaults] boolForKey:kPendingUpdateReady];
     if (isUpdateReadyToInstall) {
         pendingUpdateVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
-        NSLog(@"[HotUpdates] Found pending update ready to install: %@", pendingUpdateVersion);
     }
 
-    NSLog(@"[HotUpdates] Startup sequence initiated");
-    NSLog(@"[HotUpdates] Bundle www path: %@", [[NSBundle mainBundle] pathForResource:kWWWDirName ofType:nil]);
-    NSLog(@"[HotUpdates] Documents www path: %@", wwwPath);
-    NSLog(@"[HotUpdates] Ignore list: %@", ignoreList);
+    NSLog(@"[HotUpdates] Initializing plugin...");
 
     [self checkAndInstallPendingUpdate];
     [self initializeWWWFolder];
@@ -81,19 +78,12 @@ static BOOL hasPerformedInitialReload = NO;
         NSString *canaryVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kCanaryVersion];
 
         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];
-        } else {
-            NSLog(@"[HotUpdates] Canary already confirmed for version %@", currentVersion);
+            NSLog(@"[HotUpdates] Starting canary timer for version %@", currentVersion);
+            [self startCanaryTimer];
         }
     }
 
-    NSLog(@"[HotUpdates] Plugin initialized.");
+    NSLog(@"[HotUpdates] Plugin initialized (v%@)", appBundleVersion);
 }
 
 - (void)loadConfiguration {
@@ -101,9 +91,6 @@ static BOOL hasPerformedInitialReload = NO;
     if (!appBundleVersion) {
         appBundleVersion = @"1.0.0";
     }
-
-    NSLog(@"[HotUpdates] Configuration loaded:");
-    NSLog(@"  App bundle version: %@", appBundleVersion);
 }
 
 /*!
@@ -113,10 +100,9 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)checkAndInstallPendingUpdate {
     BOOL hasPendingUpdate = [[NSUserDefaults standardUserDefaults] boolForKey:kHasPending];
     NSString *pendingVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
-    NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
 
     if (hasPendingUpdate && pendingVersion) {
-        NSLog(@"[HotUpdates] Installing pending update %@ to Documents/www (auto-install on launch)", pendingVersion);
+        NSLog(@"[HotUpdates] Auto-installing pending update: %@", pendingVersion);
 
         [self backupCurrentVersion];
 
@@ -141,9 +127,15 @@ static BOOL hasPerformedInitialReload = NO;
 
                 [[NSFileManager defaultManager] removeItemAtPath:pendingUpdatePath error:nil];
 
-                NSLog(@"[HotUpdates] Update %@ installed successfully (canary timer will start)", pendingVersion);
+                NSLog(@"[HotUpdates] Update %@ installed successfully", pendingVersion);
             } else {
-                NSLog(@"[HotUpdates] Failed to install update: %@", copyError.localizedDescription);
+                NSLog(@"[HotUpdates] Failed to install pending update: %@", copyError.localizedDescription);
+                // Очищаем флаги чтобы не пытаться снова при следующем запуске
+                [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kHasPending];
+                [[NSUserDefaults standardUserDefaults] removeObjectForKey:kPendingVersion];
+                [[NSUserDefaults standardUserDefaults] synchronize];
+                // Удаляем битое обновление
+                [[NSFileManager defaultManager] removeItemAtPath:pendingUpdatePath error:nil];
             }
         }
     }
@@ -157,7 +149,6 @@ static BOOL hasPerformedInitialReload = NO;
 - (void)switchToUpdatedContentWithReload {
     // Предотвращаем повторные перезагрузки при навигации между страницами
     if (hasPerformedInitialReload) {
-        NSLog(@"[HotUpdates] Initial reload already performed, skipping");
         return;
     }
 
@@ -168,33 +159,36 @@ static BOOL hasPerformedInitialReload = NO;
         NSString *indexPath = [documentsWwwPath stringByAppendingPathComponent:@"index.html"];
 
         if ([[NSFileManager defaultManager] fileExistsAtPath:indexPath]) {
-            NSLog(@"[HotUpdates] Using WebView reload approach");
-            NSLog(@"[HotUpdates] Found installed update version: %@", installedVersion);
+            NSLog(@"[HotUpdates] Loading installed version: %@", installedVersion);
 
             ((CDVViewController *)self.viewController).wwwFolderName = documentsWwwPath;
-            NSLog(@"[HotUpdates] Changed wwwFolderName to: %@", documentsWwwPath);
-
-            [self reloadWebView];
-
             hasPerformedInitialReload = YES;
 
-            NSLog(@"[HotUpdates] WebView reloaded with updated content (version: %@)", installedVersion);
+            // Очищаем кэш перед перезагрузкой, иначе может загрузиться старая версия
+            [self clearWebViewCacheWithCompletion:^{
+                [self reloadWebView];
+            }];
         } else {
-            NSLog(@"[HotUpdates] Documents/www/index.html not found, keeping bundle www");
+            NSLog(@"[HotUpdates] WARNING: Documents/www/index.html not found, using bundle");
         }
     } 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 {
-    NSLog(@"[HotUpdates] Clearing WebView cache");
+    [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 {
     NSSet *websiteDataTypes = [NSSet setWithArray:@[
         WKWebsiteDataTypeDiskCache,
         WKWebsiteDataTypeMemoryCache,
@@ -206,7 +200,9 @@ static BOOL hasPerformedInitialReload = NO;
     [[WKWebsiteDataStore defaultDataStore] removeDataOfTypes:websiteDataTypes
                                                modifiedSince:dateFrom
                                            completionHandler:^{
-        NSLog(@"[HotUpdates] WebView cache cleared");
+        if (completion) {
+            dispatch_async(dispatch_get_main_queue(), completion);
+        }
     }];
 }
 
@@ -219,26 +215,22 @@ static BOOL hasPerformedInitialReload = NO;
         NSURL *fileURL = [NSURL fileURLWithPath:indexPath];
         NSURL *allowReadAccessToURL = [NSURL fileURLWithPath:documentsWwwPath];
 
-        NSLog(@"[HotUpdates] Loading WebView with new URL: %@", fileURL.absoluteString);
-
         id webViewEngine = cdvViewController.webViewEngine;
         if (webViewEngine && [webViewEngine respondsToSelector:@selector(engineWebView)]) {
             WKWebView *webView = [webViewEngine performSelector:@selector(engineWebView)];
 
             if (webView && [webView isKindOfClass:[WKWebView class]]) {
-                // loadFileURL:allowingReadAccessToURL: правильно настраивает sandbox permissions для локальных файлов
                 dispatch_async(dispatch_get_main_queue(), ^{
                     [webView loadFileURL:fileURL allowingReadAccessToURL:allowReadAccessToURL];
-                    NSLog(@"[HotUpdates] WebView loadFileURL executed with sandbox permissions");
                 });
             } else {
-                NSLog(@"[HotUpdates] Could not access WKWebView for reload");
+                NSLog(@"[HotUpdates] ERROR: Could not access WKWebView for reload");
             }
         } else {
-            NSLog(@"[HotUpdates] WebView engine not available for reload");
+            NSLog(@"[HotUpdates] ERROR: WebView engine not available for reload");
         }
     } else {
-        NSLog(@"[HotUpdates] ViewController is not CDVViewController type");
+        NSLog(@"[HotUpdates] ERROR: ViewController is not CDVViewController type");
     }
 }
 
@@ -247,120 +239,126 @@ static BOOL hasPerformedInitialReload = NO;
     NSFileManager *fileManager = [NSFileManager defaultManager];
 
     if (![fileManager fileExistsAtPath:wwwPath]) {
-        NSLog(@"[HotUpdates] WWW folder not found in Documents. Creating and copying from bundle...");
-
         NSString *bundleWWWPath = [[NSBundle mainBundle] pathForResource:@"www" ofType:nil];
         if (bundleWWWPath) {
             NSError *error;
             [fileManager copyItemAtPath:bundleWWWPath toPath:wwwPath error:&error];
             if (error) {
-                NSLog(@"[HotUpdates] Error copying www folder: %@", error.localizedDescription);
+                NSLog(@"[HotUpdates] ERROR: Failed to copy www folder: %@", error.localizedDescription);
             } else {
-                NSLog(@"[HotUpdates] WWW folder copied successfully to Documents");
+                NSLog(@"[HotUpdates] Initialized www folder from bundle");
             }
         } else {
-            NSLog(@"[HotUpdates] Error: Bundle www folder not found");
+            NSLog(@"[HotUpdates] ERROR: Bundle www folder not found");
         }
-    } else {
-        NSLog(@"[HotUpdates] WWW folder already exists in Documents");
     }
 }
 
 - (BOOL)unzipFile:(NSString*)zipPath toDestination:(NSString*)destination {
-    NSLog(@"[HotUpdates] Unzipping %@ to %@", zipPath, destination);
-
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error = nil;
 
+    // Проверяем существование ZIP файла
+    if (![fileManager fileExistsAtPath:zipPath]) {
+        NSLog(@"[HotUpdates] ERROR: ZIP file does not exist");
+        return NO;
+    }
+
+    // Проверяем magic bytes (PK\x03\x04)
+    if (![self isValidZipFile:zipPath]) {
+        NSLog(@"[HotUpdates] ERROR: Invalid file format (not a ZIP archive)");
+        return NO;
+    }
+
+    NSLog(@"[HotUpdates] Extracting update package...");
+
+    // Создаём директорию назначения если не существует
     if (![fileManager fileExistsAtPath:destination]) {
         [fileManager createDirectoryAtPath:destination withIntermediateDirectories:YES attributes:nil error:&error];
         if (error) {
-            NSLog(@"[HotUpdates] Error creating destination directory: %@", error.localizedDescription);
+            NSLog(@"[HotUpdates] ERROR: Failed to create destination directory: %@", error.localizedDescription);
             return NO;
         }
     }
 
-    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 ([fileManager fileExistsAtPath:tempExtractPath]) {
+        [fileManager 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);
+    if (![fileManager createDirectoryAtPath:tempExtractPath withIntermediateDirectories:YES attributes:nil error:&error]) {
+        NSLog(@"[HotUpdates] ERROR: Failed to create temp directory: %@", error.localizedDescription);
         return NO;
     }
 
-    NSLog(@"[HotUpdates] Extracting to temp location: %@", tempExtractPath);
-
     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 (может быть вложенной)
-        NSString *wwwSourcePath = nil;
-        for (NSString *item in extractedContents) {
-            NSString *itemPath = [tempExtractPath stringByAppendingPathComponent:item];
-            BOOL isDirectory;
-            if ([[NSFileManager defaultManager] fileExistsAtPath:itemPath isDirectory:&isDirectory] && isDirectory) {
-                if ([item isEqualToString:@"www"]) {
-                    wwwSourcePath = itemPath;
-                    break;
-                }
-                NSString *nestedWwwPath = [itemPath stringByAppendingPathComponent:@"www"];
-                if ([[NSFileManager defaultManager] fileExistsAtPath:nestedWwwPath]) {
-                    wwwSourcePath = nestedWwwPath;
-                    break;
-                }
+    if (!extractSuccess) {
+        NSLog(@"[HotUpdates] ERROR: Failed to extract ZIP archive");
+        [fileManager removeItemAtPath:tempExtractPath error:nil];
+        return NO;
+    }
+
+    NSArray *extractedContents = [fileManager contentsOfDirectoryAtPath:tempExtractPath error:nil];
+
+    // Ищем папку www (может быть вложенной)
+    NSString *wwwSourcePath = nil;
+    for (NSString *item in extractedContents) {
+        NSString *itemPath = [tempExtractPath stringByAppendingPathComponent:item];
+        BOOL isDirectory;
+        if ([fileManager fileExistsAtPath:itemPath isDirectory:&isDirectory] && isDirectory) {
+            if ([item isEqualToString:@"www"]) {
+                wwwSourcePath = itemPath;
+                break;
+            }
+            NSString *nestedWwwPath = [itemPath stringByAppendingPathComponent:@"www"];
+            if ([fileManager fileExistsAtPath:nestedWwwPath]) {
+                wwwSourcePath = nestedWwwPath;
+                break;
             }
         }
+    }
 
-        if (wwwSourcePath) {
-            NSLog(@"[HotUpdates] Found www folder at: %@", wwwSourcePath);
+    if (!wwwSourcePath) {
+        NSLog(@"[HotUpdates] ERROR: www folder not found in ZIP archive");
+        [fileManager removeItemAtPath:tempExtractPath error:nil];
+        return NO;
+    }
 
-            NSString *finalWwwPath = [destination stringByAppendingPathComponent:@"www"];
+    NSString *finalWwwPath = [destination stringByAppendingPathComponent:@"www"];
 
-            if ([[NSFileManager defaultManager] fileExistsAtPath:finalWwwPath]) {
-                [[NSFileManager defaultManager] removeItemAtPath:finalWwwPath error:nil];
-            }
+    if ([fileManager fileExistsAtPath:finalWwwPath]) {
+        [fileManager removeItemAtPath:finalWwwPath error:nil];
+    }
 
-            NSError *copyError = nil;
-            BOOL copySuccess = [[NSFileManager defaultManager] copyItemAtPath:wwwSourcePath toPath:finalWwwPath error:&copyError];
+    NSError *copyError = nil;
+    BOOL copySuccess = [fileManager copyItemAtPath:wwwSourcePath toPath:finalWwwPath error:&copyError];
 
-            if (copySuccess) {
-                NSLog(@"[HotUpdates] www folder copied successfully to: %@", finalWwwPath);
+    [fileManager removeItemAtPath:tempExtractPath error:nil];
 
-                [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
+    if (!copySuccess) {
+        NSLog(@"[HotUpdates] ERROR: Failed to copy www folder: %@", copyError.localizedDescription);
+        return NO;
+    }
 
-                NSLog(@"[HotUpdates] ZIP extraction completed successfully");
-                return YES;
-            } else {
-                NSLog(@"[HotUpdates] Error copying www folder: %@", copyError.localizedDescription);
-            }
-        } else {
-            NSLog(@"[HotUpdates] www folder not found in ZIP archive");
-            NSLog(@"[HotUpdates] Available contents: %@", extractedContents);
-        }
+    NSLog(@"[HotUpdates] Extraction completed successfully");
+    return YES;
+}
 
-        [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
-    } else {
-        NSLog(@"[HotUpdates] Failed to extract ZIP archive");
-        [[NSFileManager defaultManager] removeItemAtPath:tempExtractPath error:nil];
-    }
+- (BOOL)isValidZipFile:(NSString*)filePath {
+    NSFileHandle *file = [NSFileHandle fileHandleForReadingAtPath:filePath];
+    if (!file) return NO;
 
-    NSLog(@"[HotUpdates] ZIP extraction failed");
-    return NO;
+    NSData *header = [file readDataOfLength:4];
+    [file closeFile];
+
+    if (header.length < 4) return NO;
+
+    const uint8_t *bytes = header.bytes;
+    // ZIP magic: PK\x03\x04 (0x504B0304)
+    return (bytes[0] == 0x50 && bytes[1] == 0x4B && bytes[2] == 0x03 && bytes[3] == 0x04);
 }
 
 #pragma mark - Settings Management
@@ -397,6 +395,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 {
@@ -412,10 +432,7 @@ static BOOL hasPerformedInitialReload = NO;
 
     NSLog(@"[HotUpdates] Version %@ considered faulty, performing rollback", currentVersion);
 
-    if (currentVersion) {
-        [self addVersionToIgnoreList:currentVersion];
-    }
-
+    // Примечание: версия добавляется в ignoreList внутри rollbackToPreviousVersion
     BOOL rollbackSuccess = [self rollbackToPreviousVersion];
 
     if (rollbackSuccess) {
@@ -423,8 +440,9 @@ static BOOL hasPerformedInitialReload = NO;
 
         hasPerformedInitialReload = NO;
 
-        [self clearWebViewCache];
-        [self reloadWebView];
+        [self clearWebViewCacheWithCompletion:^{
+            [self reloadWebView];
+        }];
     } else {
         NSLog(@"[HotUpdates] Automatic rollback failed");
     }
@@ -542,7 +560,11 @@ 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
@@ -567,8 +589,7 @@ static BOOL hasPerformedInitialReload = NO;
         updateVersion = @"pending";
     }
 
-    NSLog(@"[HotUpdates] getUpdate() called - downloading update from: %@", downloadURL);
-    NSLog(@"[HotUpdates] Version: %@", updateVersion);
+    NSLog(@"[HotUpdates] getUpdate: v%@ from %@", updateVersion, downloadURL);
 
     NSString *installedVersion = [[NSUserDefaults standardUserDefaults] stringForKey:kInstalledVersion];
     if (installedVersion && [installedVersion isEqualToString:updateVersion]) {
@@ -596,11 +617,9 @@ static BOOL hasPerformedInitialReload = NO;
         return;
     }
 
+    // Сохраняем только в память, в UserDefaults запишем после успешной загрузки
     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];
 }
@@ -613,21 +632,36 @@ static BOOL hasPerformedInitialReload = NO;
     NSLog(@"[HotUpdates] Starting download");
 
     NSURL *url = [NSURL URLWithString:downloadURL];
+    if (!url) {
+        NSLog(@"[HotUpdates] ERROR: Invalid URL format");
+        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];
 
         if (error) {
-            NSLog(@"[HotUpdates] Download failed: %@", error.localizedDescription);
+            NSLog(@"[HotUpdates] ERROR: Download failed: %@", error.localizedDescription);
 
             CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                      messageAsDictionary:[self createError:kErrorDownloadFailed
@@ -638,7 +672,7 @@ static BOOL hasPerformedInitialReload = NO;
 
         NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *)response;
         if (httpResponse.statusCode != 200) {
-            NSLog(@"[HotUpdates] Download failed: HTTP %ld", (long)httpResponse.statusCode);
+            NSLog(@"[HotUpdates] ERROR: HTTP %ld", (long)httpResponse.statusCode);
 
             CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                      messageAsDictionary:[self createError:kErrorHTTPError
@@ -647,9 +681,7 @@ static BOOL hasPerformedInitialReload = NO;
             return;
         }
 
-        NSLog(@"[HotUpdates] Download completed successfully");
-
-        // Сохраняем скачанное обновление во временную папку
+        NSLog(@"[HotUpdates] Download completed, verifying...");
         [self saveDownloadedUpdate:location callbackId:callbackId];
     }];
 
@@ -657,24 +689,25 @@ static BOOL hasPerformedInitialReload = NO;
 }
 
 - (void)saveDownloadedUpdate:(NSURL*)updateLocation callbackId:(NSString*)callbackId {
-    NSLog(@"[HotUpdates] Saving downloaded update");
-
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error;
 
+    // Используем временную папку для новой загрузки (не трогаем существующую temp_downloaded_update)
+    NSString *newDownloadPath = [documentsPath stringByAppendingPathComponent:@"temp_new_download"];
     NSString *tempUpdatePath = [documentsPath stringByAppendingPathComponent:@"temp_downloaded_update"];
 
-    if ([fileManager fileExistsAtPath:tempUpdatePath]) {
-        [fileManager removeItemAtPath:tempUpdatePath error:nil];
+    // Очищаем только папку для новой загрузки
+    if ([fileManager fileExistsAtPath:newDownloadPath]) {
+        [fileManager removeItemAtPath:newDownloadPath error:nil];
     }
 
-    [fileManager createDirectoryAtPath:tempUpdatePath
+    [fileManager createDirectoryAtPath:newDownloadPath
            withIntermediateDirectories:YES
                             attributes:nil
                                  error:&error];
 
     if (error) {
-        NSLog(@"[HotUpdates] Error creating temp directory: %@", error);
+        NSLog(@"[HotUpdates] ERROR: Failed to create temp directory: %@", error.localizedDescription);
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                  messageAsDictionary:[self createError:kErrorTempDirError
                                                                                 message:@"Cannot create temp directory"]];
@@ -682,11 +715,10 @@ static BOOL hasPerformedInitialReload = NO;
         return;
     }
 
-    BOOL unzipSuccess = [self unzipFile:updateLocation.path toDestination:tempUpdatePath];
+    BOOL unzipSuccess = [self unzipFile:updateLocation.path toDestination:newDownloadPath];
 
     if (!unzipSuccess) {
-        NSLog(@"[HotUpdates] Failed to unzip update");
-        [fileManager removeItemAtPath:tempUpdatePath error:nil];
+        [fileManager removeItemAtPath:newDownloadPath error:nil];
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                  messageAsDictionary:[self createError:kErrorExtractionFailed
@@ -695,10 +727,10 @@ static BOOL hasPerformedInitialReload = NO;
         return;
     }
 
-    NSString *tempWwwPath = [tempUpdatePath stringByAppendingPathComponent:kWWWDirName];
-    if (![fileManager fileExistsAtPath:tempWwwPath]) {
-        NSLog(@"[HotUpdates] www folder not found in update package");
-        [fileManager removeItemAtPath:tempUpdatePath error:nil];
+    NSString *newWwwPath = [newDownloadPath stringByAppendingPathComponent:kWWWDirName];
+    if (![fileManager fileExistsAtPath:newWwwPath]) {
+        NSLog(@"[HotUpdates] ERROR: www folder not found in update package");
+        [fileManager removeItemAtPath:newDownloadPath error:nil];
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                  messageAsDictionary:[self createError:kErrorWWWNotFound
@@ -707,6 +739,12 @@ static BOOL hasPerformedInitialReload = NO;
         return;
     }
 
+    // Успех! Теперь безопасно заменяем старую temp_downloaded_update на новую
+    if ([fileManager fileExistsAtPath:tempUpdatePath]) {
+        [fileManager removeItemAtPath:tempUpdatePath error:nil];
+    }
+    [fileManager moveItemAtPath:newDownloadPath toPath:tempUpdatePath error:nil];
+
     // Копируем в pending_update для автоустановки при следующем запуске
     NSString *pendingPath = [documentsPath stringByAppendingPathComponent:kPendingUpdateDirName];
 
@@ -719,18 +757,18 @@ static BOOL hasPerformedInitialReload = NO;
                                              error:&error];
 
     if (!copySuccess) {
-        NSLog(@"[HotUpdates] Failed to copy to pending_update: %@", error);
-    } else {
-        NSLog(@"[HotUpdates] Copied to pending_update for auto-install on next launch");
+        NSLog(@"[HotUpdates] WARNING: Failed to copy to pending_update (auto-install disabled): %@", error.localizedDescription);
     }
 
     isUpdateReadyToInstall = YES;
+    // Сохраняем URL и версию в UserDefaults только после успешной загрузки
+    [[NSUserDefaults standardUserDefaults] setObject:pendingUpdateURL forKey:kPendingUpdateURL];
+    [[NSUserDefaults standardUserDefaults] setObject:pendingUpdateVersion forKey:kPendingVersion];
     [[NSUserDefaults standardUserDefaults] setBool:YES forKey:kPendingUpdateReady];
     [[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");
+    NSLog(@"[HotUpdates] Update ready (v%@)", pendingUpdateVersion);
 
     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
@@ -739,8 +777,6 @@ static BOOL hasPerformedInitialReload = NO;
 #pragma mark - Force Update (Install Only)
 
 - (void)forceUpdate:(CDVInvokedUrlCommand*)command {
-    NSLog(@"[HotUpdates] forceUpdate() called - installing downloaded update");
-
     if (!isUpdateReadyToInstall) {
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                  messageAsDictionary:[self createError:kErrorNoUpdateReady
@@ -753,7 +789,7 @@ static BOOL hasPerformedInitialReload = NO;
     NSString *tempWwwPath = [tempUpdatePath stringByAppendingPathComponent:kWWWDirName];
 
     if (![[NSFileManager defaultManager] fileExistsAtPath:tempWwwPath]) {
-        NSLog(@"[HotUpdates] Downloaded update files not found");
+        NSLog(@"[HotUpdates] ERROR: Downloaded update files not found");
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                  messageAsDictionary:[self createError:kErrorUpdateFilesNotFound
@@ -766,13 +802,13 @@ static BOOL hasPerformedInitialReload = NO;
 }
 
 - (void)installDownloadedUpdate:(NSString*)tempWwwPath callbackId:(NSString*)callbackId {
-    NSLog(@"[HotUpdates] Installing update");
-
     NSString *versionToInstall = [[NSUserDefaults standardUserDefaults] stringForKey:kPendingVersion];
     if (!versionToInstall) {
         versionToInstall = @"unknown";
     }
 
+    NSLog(@"[HotUpdates] forceUpdate: installing v%@", versionToInstall);
+
     NSFileManager *fileManager = [NSFileManager defaultManager];
     NSError *error;
 
@@ -787,7 +823,7 @@ static BOOL hasPerformedInitialReload = NO;
                                              error:&error];
 
     if (!copySuccess) {
-        NSLog(@"[HotUpdates] Failed to install update: %@", error);
+        NSLog(@"[HotUpdates] ERROR: Failed to install update: %@", error.localizedDescription);
 
         CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
                                                  messageAsDictionary:[self createError:kErrorInstallFailed
@@ -813,37 +849,30 @@ static BOOL hasPerformedInitialReload = NO;
 
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
+    pendingUpdateVersion = nil;
 
     NSLog(@"[HotUpdates] Update installed successfully");
+    NSLog(@"[HotUpdates] Starting canary timer for version %@", newVersion);
 
     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
 
-    // После reloadWebView pluginInitialize НЕ вызывается, поэтому canary timer запускаем вручную
-    NSLog(@"[HotUpdates] Starting canary timer (20 seconds) for version %@", newVersion);
-
-    if (canaryTimer && [canaryTimer isValid]) {
-        [canaryTimer invalidate];
-    }
-
-    canaryTimer = [NSTimer scheduledTimerWithTimeInterval:20.0
-                                                   target:self
-                                                 selector:@selector(canaryTimeout)
-                                                 userInfo:nil
-                                                  repeats:NO];
-
+    [self startCanaryTimer];
     hasPerformedInitialReload = NO;
 
-    // Очищаем кэш WebView перед перезагрузкой, иначе может загрузиться старая версия
-    [self clearWebViewCache];
-
-    [self reloadWebView];
+    [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
@@ -853,8 +882,6 @@ static BOOL hasPerformedInitialReload = NO;
         return;
     }
 
-    NSLog(@"[HotUpdates] Canary called for version: %@", canaryVersion);
-
     // Сохраняем canary версию
     [[NSUserDefaults standardUserDefaults] setObject:canaryVersion forKey:kCanaryVersion];
     [[NSUserDefaults standardUserDefaults] synchronize];
@@ -863,15 +890,11 @@ static BOOL hasPerformedInitialReload = NO;
     if (canaryTimer && [canaryTimer isValid]) {
         [canaryTimer invalidate];
         canaryTimer = nil;
-        NSLog(@"[HotUpdates] Canary timer stopped - JS confirmed bundle is working");
+        NSLog(@"[HotUpdates] Canary confirmed: v%@", canaryVersion);
     }
 
-    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];
 }
 

package/src/ios/HotUpdatesConstants.h

@@ -1,17 +1,19 @@
 /*!
  * @file HotUpdatesConstants.h
  * @brief Constants for Hot Updates Plugin
- * @details Defines error codes, storage keys, and directory names
- * @version 2.2.0
+ * @details Contains error codes, storage keys, and directory names used by the plugin
+ * @version 2.1.0
  * @date 2025-11-13
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.
  */
 
-#import <Foundation/Foundation.h>
+#ifndef HotUpdatesConstants_h
+#define HotUpdatesConstants_h
 
 #pragma mark - Error Codes
 
+// Error codes returned to JavaScript
 extern NSString * const kErrorUpdateDataRequired;
 extern NSString * const kErrorURLRequired;
 extern NSString * const kErrorDownloadInProgress;
@@ -27,6 +29,7 @@ extern NSString * const kErrorVersionRequired;
 
 #pragma mark - Storage Keys
 
+// NSUserDefaults keys
 extern NSString * const kInstalledVersion;
 extern NSString * const kPendingVersion;
 extern NSString * const kHasPending;
@@ -39,7 +42,10 @@ extern NSString * const kPendingUpdateReady;
 
 #pragma mark - Directory Names
 
+// Directory names
 extern NSString * const kWWWDirName;
 extern NSString * const kPreviousWWWDirName;
 extern NSString * const kBackupWWWDirName;
 extern NSString * const kPendingUpdateDirName;
+
+#endif /* HotUpdatesConstants_h */

package/src/ios/HotUpdatesConstants.m

@@ -2,7 +2,7 @@
  * @file HotUpdatesConstants.m
  * @brief Implementation of constants for Hot Updates Plugin
  * @details Defines all constant values used throughout the plugin
- * @version 2.2.0
+ * @version 2.1.0
  * @date 2025-11-13
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.

package/www/HotUpdates.js

@@ -1,73 +1,80 @@
 var exec = require('cordova/exec');
 
 /**
- * Cordova Hot Updates Plugin v2.1.2
+ * Cordova Hot Updates Plugin v2.2.1
  * Frontend-controlled manual hot updates for iOS
  *
- * Provides manual over-the-air (OTA) updates for Cordova applications
- * using the WebView Reload approach. All update decisions are controlled
- * by JavaScript - the native plugin only executes commands.
- *
- * Features:
- * - Frontend-controlled manual updates (no automatic checking)
- * - Two-step update flow: getUpdate() downloads, forceUpdate() installs
- * - Automatic rollback with 20-second canary timer
- * - IgnoreList system for tracking problematic versions (information only)
- * - Auto-install pending updates on next app launch
- * - WebView reload approach for instant updates without app restart
- * - No App Store approval required for web content updates
- *
- * @version 2.1.2
+ * @version 2.2.1
  * @author Mustafin Vladimir
  */
+
+/**
+ * Error codes returned by the plugin
+ * @readonly
+ * @enum {string}
+ */
+var ErrorCodes = {
+    // getUpdate errors
+    UPDATE_DATA_REQUIRED: 'UPDATE_DATA_REQUIRED',
+    URL_REQUIRED: 'URL_REQUIRED',
+    DOWNLOAD_IN_PROGRESS: 'DOWNLOAD_IN_PROGRESS',
+    DOWNLOAD_FAILED: 'DOWNLOAD_FAILED',
+    HTTP_ERROR: 'HTTP_ERROR',
+    TEMP_DIR_ERROR: 'TEMP_DIR_ERROR',
+    EXTRACTION_FAILED: 'EXTRACTION_FAILED',
+    WWW_NOT_FOUND: 'WWW_NOT_FOUND',
+    // forceUpdate errors
+    NO_UPDATE_READY: 'NO_UPDATE_READY',
+    UPDATE_FILES_NOT_FOUND: 'UPDATE_FILES_NOT_FOUND',
+    INSTALL_FAILED: 'INSTALL_FAILED',
+    // canary errors
+    VERSION_REQUIRED: 'VERSION_REQUIRED'
+};
+
 var HotUpdates = {
 
+    /**
+     * Error codes enum
+     * @type {Object}
+     */
+    ErrorCodes: ErrorCodes,
+
     /**
      * Download update from server
      *
-     * Downloads update ZIP archive from the provided URL and saves to two locations:
-     * - temp_downloaded_update (for immediate installation via forceUpdate)
-     * - pending_update (for auto-installation on next app launch)
-     *
-     * If the specified version is already downloaded, returns success without re-downloading.
-     * Does NOT check ignoreList - JavaScript controls all installation decisions.
-     *
      * @param {Object} options - Update options
      * @param {string} options.url - URL to download ZIP archive (required)
      * @param {string} [options.version] - Version string (optional)
-     * @param {Function} callback - Callback function
-     *   - Called with null on success
-     *   - Called with {error: {message?: string}} on error
+     * @param {Function} callback - Callback(error)
+     *   - null on success
+     *   - {error: {code: string, message: string}} on error
      *
      * @example
-     * window.hotUpdate.getUpdate({
-     *     url: 'https://your-server.com/updates/2.0.0.zip',
-     *     version: '2.0.0'
-     * }, function(error) {
-     *     if (error) {
-     *         console.error('Download failed:', error);
-     *     } else {
-     *         console.log('Update downloaded successfully');
-     *         // Can now call forceUpdate() to install immediately
-     *         // Or user can ignore and it will auto-install on next launch
-     *     }
+     * hotUpdate.getUpdate({url: 'https://server.com/update.zip', version: '2.0.0'}, function(err) {
+     *     if (err) console.error(err.error.code, err.error.message);
+     *     else console.log('Downloaded');
      * });
      */
     getUpdate: function(options, callback) {
-        if (!options || !options.url) {
+        if (!options) {
+            if (callback) {
+                callback({error: {code: ErrorCodes.UPDATE_DATA_REQUIRED, message: 'Update data required'}});
+            }
+            return;
+        }
+
+        if (!options.url) {
             if (callback) {
-                callback({error: {message: 'URL is required'}});
+                callback({error: {code: ErrorCodes.URL_REQUIRED, message: 'URL is required'}});
             }
             return;
         }
 
         exec(
             function() {
-                // Success
                 if (callback) callback(null);
             },
             function(error) {
-                // Error
                 if (callback) callback({error: error});
             },
             'HotUpdates',
@@ -79,42 +86,22 @@ var HotUpdates = {
     /**
      * Install downloaded update immediately
      *
-     * Installs the update that was downloaded via getUpdate().
-     * This will:
-     * 1. Backup current version to www_previous
-     * 2. Copy downloaded update to Documents/www
-     * 3. Clear WebView cache (disk, memory, Service Worker)
-     * 4. Reload WebView
-     * 5. Start 20-second canary timer
-     *
-     * IMPORTANT: JavaScript MUST call canary(version) within 20 seconds
-     * after reload to confirm successful bundle load. Otherwise automatic
-     * rollback will occur.
-     *
-     * Does NOT check ignoreList - JavaScript decides what to install.
-     *
-     * @param {Function} callback - Callback function
-     *   - Called with null on success (before WebView reload)
-     *   - Called with {error: {message?: string}} on error
+     * @param {Function} callback - Callback(error)
+     *   - null on success (WebView will reload)
+     *   - {error: {code: string, message: string}} on error
      *
      * @example
-     * window.hotUpdate.forceUpdate(function(error) {
-     *     if (error) {
-     *         console.error('Install failed:', error);
-     *     } else {
-     *         console.log('Update installing, WebView will reload...');
-     *         // After reload, MUST call canary() within 20 seconds!
-     *     }
+     * hotUpdate.forceUpdate(function(err) {
+     *     if (err) console.error(err.error.code);
+     *     // WebView reloads, call canary() within 20 sec
      * });
      */
     forceUpdate: function(callback) {
         exec(
             function() {
-                // Success
                 if (callback) callback(null);
             },
             function(error) {
-                // Error
                 if (callback) callback({error: error});
             },
             'HotUpdates',
@@ -124,36 +111,30 @@ var HotUpdates = {
     },
 
     /**
-     * Confirm successful bundle load (canary check)
-     *
-     * MUST be called within 20 seconds after forceUpdate() to confirm
-     * that the new bundle loaded successfully. This stops the canary timer
-     * and prevents automatic rollback.
-     *
-     * If not called within 20 seconds:
-     * - Automatic rollback to previous version
-     * - Failed version added to ignoreList
-     * - WebView reloaded with previous version
-     *
-     * Call this immediately after your app initialization completes.
+     * Confirm successful bundle load (MUST call within 20 sec after forceUpdate)
      *
-     * @param {string} version - Version that loaded successfully
-     * @param {Function} [callback] - Optional callback (not used, method is synchronous)
+     * @param {string} version - Current version
+     * @param {Function} [callback] - Optional callback
      *
      * @example
-     * // Call as early as possible after app loads
      * document.addEventListener('deviceready', function() {
-     *     window.hotUpdate.canary('2.0.0');
-     *     console.log('Canary confirmed, update successful');
-     * }, false);
+     *     hotUpdate.canary('2.0.0');
+     * });
      */
     canary: function(version, callback) {
+        if (!version) {
+            if (callback) {
+                callback({error: {code: ErrorCodes.VERSION_REQUIRED, message: 'Version is required'}});
+            }
+            return;
+        }
+
         exec(
             function() {
-                if (callback) callback();
+                if (callback) callback(null);
             },
-            function() {
-                if (callback) callback();
+            function(error) {
+                if (callback) callback({error: error});
             },
             'HotUpdates',
             'canary',
@@ -162,50 +143,62 @@ var HotUpdates = {
     },
 
     /**
-     * Get list of problematic versions (information only)
+     * Get list of problematic versions
      *
-     * Returns array of version strings that failed to load (triggered rollback).
-     * This is an INFORMATION-ONLY system - native does NOT block installation
-     * of versions in this list.
-     *
-     * JavaScript should read this list and decide whether to skip downloading/
-     * installing these versions. If JS decides to install a version from the
-     * ignoreList, that's allowed (per TS requirements).
-     *
-     * Native automatically adds versions to this list when rollback occurs.
-     * JavaScript cannot modify the list (no add/remove/clear methods per TS v2.1.0).
-     *
-     * @param {Function} callback - Callback function
-     *   - Called with {versions: string[]} - Array of problematic version strings
+     * @param {Function} callback - Callback({versions: string[]})
      *
      * @example
-     * window.hotUpdate.getIgnoreList(function(result) {
-     *     console.log('Problematic versions:', result.versions);
-     *     // Example: {versions: ['1.9.0', '2.0.1']}
-     *
-     *     // JavaScript decides what to do with this information
-     *     var shouldSkip = result.versions.includes(availableVersion);
-     *     if (shouldSkip) {
-     *         console.log('Skipping known problematic version');
-     *     } else {
-     *         // Download and install
+     * hotUpdate.getIgnoreList(function(result) {
+     *     if (result.versions.includes(newVersion)) {
+     *         console.log('Version is blacklisted');
      *     }
      * });
      */
     getIgnoreList: function(callback) {
         exec(
-            function(versions) {
-                // Success - native returns array of version strings
-                if (callback) callback({versions: versions || []});
+            function(result) {
+                if (callback) callback(result || {versions: []});
             },
-            function(error) {
-                // Error - return empty list
+            function() {
                 if (callback) callback({versions: []});
             },
             'HotUpdates',
             'getIgnoreList',
             []
         );
+    },
+
+    /**
+     * Get version info (debug method)
+     *
+     * @param {Function} callback - Callback with version info
+     *   {
+     *     appBundleVersion: string,
+     *     installedVersion: string|null,
+     *     previousVersion: string|null,
+     *     canaryVersion: string|null,
+     *     pendingVersion: string|null,
+     *     hasPendingUpdate: boolean,
+     *     ignoreList: string[]
+     *   }
+     *
+     * @example
+     * hotUpdate.getVersionInfo(function(info) {
+     *     console.log('Current:', info.installedVersion || info.appBundleVersion);
+     * });
+     */
+    getVersionInfo: function(callback) {
+        exec(
+            function(info) {
+                if (callback) callback(info);
+            },
+            function(error) {
+                if (callback) callback({error: error});
+            },
+            'HotUpdates',
+            'getVersionInfo',
+            []
+        );
     }
 };