cordova-plugin-hot-updates 2.2.2 → 2.2.3

package/README.md

@@ -1,18 +1,7 @@
-# Cordova Hot Updates Plugin v2.2.2
+# Cordova Hot Updates Plugin v2.2.3
 
 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)
 
@@ -25,6 +14,7 @@ This plugin enables **manual, JavaScript-controlled** web content updates for yo
 - **Auto-Install on Launch**: If user ignores update prompt, it installs on next app launch
 - **Canary System**: Automatic rollback if update fails to load (20-second timeout)
 - **IgnoreList**: Tracks problematic versions (information only, does NOT block installation)
+- **Version History** *(new in v2.2.3)*: Tracks successful versions for progressive data migrations
 - **Instant Effect**: WebView Reload approach - no app restart needed
 - **Cache Management**: Clears WKWebView cache (disk, memory, Service Worker) before reload
 
@@ -279,6 +269,58 @@ window.hotUpdate.getIgnoreList(function(result) {
 
 ---
 
+### window.hotUpdate.getVersionHistory(callback)
+
+Returns list of all successfully installed versions (excluding rolled back ones).
+
+**New in v2.2.3** - Enables progressive data migrations.
+
+When internal data structure changes, you may need to run migrations. This method returns the version history so your app can determine which migrations to run.
+
+**Key behaviors:**
+- **Automatically initialized** with `appBundleVersion` on first launch
+- **Added to history** when update is successfully installed
+- **Removed from history** when version is rolled back (failed canary)
+- **Excludes ignoreList** - only contains successful versions
+
+**Parameters:**
+- `callback` (Function) - `callback(result)`
+  - `result`: `{versions: string[]}` - Array of successful version strings
+
+**Example:**
+```javascript
+window.hotUpdate.getVersionHistory(function(result) {
+    console.log('Version history:', result.versions);
+    // Example: ["2.7.7", "2.7.8", "2.7.9"]
+
+    // Run migrations based on version progression
+    result.versions.forEach((version, index) => {
+        if (index > 0) {
+            const from = result.versions[index - 1];
+            const to = version;
+            runMigration(from, to);
+        }
+    });
+});
+```
+
+**Use Case:**
+```javascript
+// Check for missed critical versions
+window.hotUpdate.getVersionHistory(function(result) {
+    const criticalVersions = ['2.8.0', '3.0.0']; // Versions with important migrations
+    const missed = criticalVersions.filter(v => !result.versions.includes(v));
+
+    if (missed.length > 0) {
+        console.warn('User skipped critical versions:', missed);
+        // Run all missed critical migrations
+        missed.forEach(v => runCriticalMigration(v));
+    }
+});
+```
+
+---
+
 ### window.hotUpdate.getVersionInfo(callback)
 
 Returns version information (debug method).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-hot-updates",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "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.2"
+        version="2.2.3"
         xmlns="http://apache.org/cordova/ns/plugins/1.0"
         xmlns:android="http://schemas.android.com/apk/res/android">
 

package/src/ios/HotUpdates.h

@@ -29,16 +29,18 @@
 
     // Settings
     NSMutableArray *ignoreList;       // Список игнорируемых версий (управляется только native)
+    NSMutableArray *versionHistory;   // История успешно установленных версий (исключая откаченные)
     NSString *previousVersionPath;    // Путь к предыдущей версии
 }
 
-// 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)
+// JavaScript API methods (v2.2.2)
+- (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)
+- (void)getVersionHistory:(CDVInvokedUrlCommand*)command; // Get version history (successful installs only)
 
 // Debug method
-- (void)getVersionInfo:(CDVInvokedUrlCommand*)command; // Get all version info for debugging
+- (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.2
- * @date 2025-11-28
+ * @version 2.1.2
+ * @date 2025-11-26
  * @author Mustafin Vladimir
  * @copyright Copyright (c) 2025. All rights reserved.
  */
@@ -55,6 +55,7 @@ static BOOL hasPerformedInitialReload = NO;
 
     [self loadConfiguration];
     [self loadIgnoreList];
+    [self loadVersionHistory];
 
     // Сбрасываем флаг загрузки (если приложение было убито во время загрузки)
     isDownloadingUpdate = NO;
@@ -127,6 +128,9 @@ static BOOL hasPerformedInitialReload = NO;
 
                 [[NSFileManager defaultManager] removeItemAtPath:pendingUpdatePath error:nil];
 
+                // Добавляем версию в историю при успешной установке
+                [self addVersionToHistory:pendingVersion];
+
                 NSLog(@"[HotUpdates] Update %@ installed successfully", pendingVersion);
             } else {
                 NSLog(@"[HotUpdates] Failed to install pending update: %@", copyError.localizedDescription);
@@ -395,6 +399,58 @@ static BOOL hasPerformedInitialReload = NO;
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }
 
+#pragma mark - Version History Management
+
+- (void)loadVersionHistory {
+    NSArray *savedHistory = [[NSUserDefaults standardUserDefaults] arrayForKey:kVersionHistory];
+    if (savedHistory) {
+        versionHistory = [savedHistory mutableCopy];
+    } else {
+        versionHistory = [NSMutableArray array];
+        // При первом запуске добавляем исходную версию приложения
+        if (appBundleVersion) {
+            [versionHistory addObject:appBundleVersion];
+            [self saveVersionHistory];
+            NSLog(@"[HotUpdates] Initial version history created with app version: %@", appBundleVersion);
+        }
+    }
+}
+
+- (NSArray*)getVersionHistoryInternal {
+    return [versionHistory copy];
+}
+
+- (void)saveVersionHistory {
+    [[NSUserDefaults standardUserDefaults] setObject:versionHistory forKey:kVersionHistory];
+    [[NSUserDefaults standardUserDefaults] synchronize];
+}
+
+- (void)addVersionToHistory:(NSString*)version {
+    if (version && ![versionHistory containsObject:version]) {
+        [versionHistory addObject:version];
+        [self saveVersionHistory];
+        NSLog(@"[HotUpdates] Added version %@ to version history", version);
+    }
+}
+
+- (void)removeVersionFromHistory:(NSString*)version {
+    if (version && [versionHistory containsObject:version]) {
+        [versionHistory removeObject:version];
+        [self saveVersionHistory];
+        NSLog(@"[HotUpdates] Removed version %@ from version history", version);
+    }
+}
+
+- (void)getVersionHistory:(CDVInvokedUrlCommand*)command {
+    NSArray *history = [self getVersionHistoryInternal];
+
+    CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK
+                                             messageAsDictionary:@{
+        @"versions": history
+    }];
+    [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
+}
+
 #pragma mark - Canary Timer
 
 /*!
@@ -543,6 +599,8 @@ static BOOL hasPerformedInitialReload = NO;
 
         if (currentVersion) {
             [self addVersionToIgnoreList:currentVersion];
+            // Удаляем откаченную версию из истории (она не прошла canary)
+            [self removeVersionFromHistory:currentVersion];
         }
 
         return YES;
@@ -851,6 +909,9 @@ static BOOL hasPerformedInitialReload = NO;
     pendingUpdateURL = nil;
     pendingUpdateVersion = nil;
 
+    // Добавляем версию в историю при успешной установке
+    [self addVersionToHistory:newVersion];
+
     NSLog(@"[HotUpdates] Update installed successfully");
     NSLog(@"[HotUpdates] Starting canary timer for version %@", newVersion);
 

package/src/ios/HotUpdatesConstants.h

@@ -39,6 +39,7 @@ extern NSString * const kCanaryVersion;
 extern NSString * const kDownloadInProgress;
 extern NSString * const kPendingUpdateURL;
 extern NSString * const kPendingUpdateReady;
+extern NSString * const kVersionHistory;
 
 #pragma mark - Directory Names
 

package/src/ios/HotUpdatesConstants.m

@@ -37,6 +37,7 @@ NSString * const kCanaryVersion = @"hot_updates_canary_version";
 NSString * const kDownloadInProgress = @"hot_updates_download_in_progress";
 NSString * const kPendingUpdateURL = @"hot_updates_pending_update_url";
 NSString * const kPendingUpdateReady = @"hot_updates_pending_ready";
+NSString * const kVersionHistory = @"hot_updates_version_history";
 
 #pragma mark - Directory Names