cordova-plugin-hot-updates 2.2.0 → 2.2.1

package/README.md

@@ -1,4 +1,4 @@
-# Cordova Hot Updates Plugin v2.2.0
+# Cordova Hot Updates Plugin v2.2.1
 
 Frontend-controlled manual hot updates for Cordova iOS applications using WebView Reload approach.
 
@@ -125,11 +125,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 +137,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 +268,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.1",
   "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.1"
         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.1.2
+ * @date 2025-11-26
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.
  */
@@ -56,6 +56,10 @@ static BOOL hasPerformedInitialReload = NO;
     [self loadConfiguration];
     [self loadIgnoreList];
 
+    // Сбрасываем флаг загрузки (если приложение было убито во время загрузки)
+    isDownloadingUpdate = NO;
+    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:kDownloadInProgress];
+
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
     pendingUpdateVersion = nil;
@@ -83,11 +87,7 @@ static BOOL hasPerformedInitialReload = NO;
         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);
         }
@@ -113,7 +113,6 @@ 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);
@@ -174,11 +173,13 @@ static BOOL hasPerformedInitialReload = NO;
             ((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];
+                NSLog(@"[HotUpdates] WebView reloaded with updated content (version: %@)", installedVersion);
+            }];
         } else {
             NSLog(@"[HotUpdates] Documents/www/index.html not found, keeping bundle www");
         }
@@ -189,10 +190,18 @@ static BOOL hasPerformedInitialReload = NO;
 }
 
 /*!
- * @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:@[
@@ -207,6 +216,9 @@ static BOOL hasPerformedInitialReload = NO;
                                                modifiedSince:dateFrom
                                            completionHandler:^{
         NSLog(@"[HotUpdates] WebView cache cleared");
+        if (completion) {
+            dispatch_async(dispatch_get_main_queue(), completion);
+        }
     }];
 }
 
@@ -397,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 {
@@ -412,10 +446,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 +454,9 @@ static BOOL hasPerformedInitialReload = NO;
 
         hasPerformedInitialReload = NO;
 
-        [self clearWebViewCache];
-        [self reloadWebView];
+        [self clearWebViewCacheWithCompletion:^{
+            [self reloadWebView];
+        }];
     } else {
         NSLog(@"[HotUpdates] Automatic rollback failed");
     }
@@ -542,7 +574,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
@@ -613,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];
@@ -813,6 +864,7 @@ static BOOL hasPerformedInitialReload = NO;
 
     isUpdateReadyToInstall = NO;
     pendingUpdateURL = nil;
+    pendingUpdateVersion = nil;
 
     NSLog(@"[HotUpdates] Update installed successfully");
 
@@ -822,28 +874,24 @@ static BOOL hasPerformedInitialReload = NO;
     // После 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
@@ -866,12 +914,8 @@ 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];
 }
 

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',
+            []
+        );
     }
 };