@capawesome/capacitor-live-update 7.2.1 → 7.3.0

package/README.md

@@ -4,7 +4,7 @@ Capacitor plugin that allows you to update your app remotely in real-time withou
 
 <div class="capawesome-z29o10a">
   <a href="https://cloud.capawesome.io/" target="_blank">
-    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-deploy-real-time-app-updates.png?t=1" />
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
   </a>
 </div>
 
@@ -17,16 +17,34 @@ We are proud to offer one of the most complete and feature-rich Capacitor plugin
 - 📦 **Bundle Management**: Download, set, and delete bundles.
 - ☁️ **Cloud Support**: Use the [Capawesome Cloud](https://cloud.capawesome.io/) to manage your app updates.
 - 📺 **Channel Support**: Set a channel for the app to manage different versions.
-- 🔄 **Auto Update**: Automatically download and set the latest bundle for the app.
+- 🔄 **Auto Update**: Automatically download and set the latest bundle for the app with configurable background update strategy.
 - 🛟 **Rollback**: Reset the app to the default bundle if an incompatible bundle has been set.
 - 🚀 **Rollout**: Gradually roll out new bundles to gather valuable feedback.
 - 🔁 **Delta Updates**: Make your updates faster by only downloading changed files.
 - 🔒 **Security**: Verify the authenticity and integrity of the bundle using a public key.
-- ⚔️ **Battle-Tested**: Used in more than 500 projects to update apps on more than 10,000,000 devices.
+- ⚔️ **Battle-Tested**: Used in more than 1,000 projects to update apps on more than 20,000,000 devices.
 - 🌐 **Open Source**: Licensed under the MIT License.
 
 Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
 
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 7.x.x          | >=7.x.x           | Active support |
+| 6.x.x          | 6.x.x             | Maintenance    |
+| 5.x.x          | 5.x.x             | Deprecated     |
+
+## Guides
+
+- [Announcing the Capacitor Live Update Plugin](https://capawesome.io/blog/announcing-the-capacitor-live-update-plugin/)
+- [Exploring the Capacitor Live Update API](https://capawesome.io/blog/exploring-the-capacitor-live-update-api/)
+- [How Live Updates for Capacitor work](https://capawesome.io/blog/how-live-updates-for-capacitor-work/)
+- [How to gradually roll out Capacitor Live Updates](https://capawesome.io/blog/how-to-gradually-roll-out-capacitor-live-updates/#update-a-bundle)
+- [How to restrict Capacitor Live Updates to Native Versions](https://capawesome.io/blog/how-to-restrict-capacitor-live-updates-to-native-versions/)
+- [Live Updates for Nuxt Capacitor Apps with Capawesome Cloud](https://capawesome.io/blog/live-updates-for-nuxt-capacitor/)
+- [Migrating from App Center to Capawesome Cloud](https://capawesome.io/blog/migrating-from-app-center-to-capawesome-cloud/)
+
 ## Installation
 
 ```bash
@@ -79,15 +97,17 @@ We recommend to declare [`CA92.1`](https://developer.apple.com/documentation/bun
 <docgen-config>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-| Prop                    | Type                 | Description                                                                                                                                                                                                                                                                                                                                                                                     | Default                                | Since |
-| ----------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ----- |
-| **`appId`**             | <code>string</code>  | The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud/). This is **NOT** the same as the app identifier (e.g. `com.example.app`). This is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).                                                                                                           |                                        | 5.0.0 |
-| **`autoDeleteBundles`** | <code>boolean</code> | Whether or not to automatically delete unused bundles. When enabled, the plugin will automatically delete unused bundles after calling `ready()`.                                                                                                                                                                                                                                               | <code>false</code>                     | 5.0.0 |
-| **`defaultChannel`**    | <code>string</code>  | The default channel of the app.                                                                                                                                                                                                                                                                                                                                                                 |                                        | 6.3.0 |
-| **`httpTimeout`**       | <code>number</code>  | The timeout in milliseconds for HTTP requests.                                                                                                                                                                                                                                                                                                                                                  | <code>60000</code>                     | 6.4.0 |
-| **`publicKey`**         | <code>string</code>  | The public key to verify the integrity of the bundle. The public key must be a PEM-encoded RSA public key.                                                                                                                                                                                                                                                                                      |                                        | 6.1.0 |
-| **`readyTimeout`**      | <code>number</code>  | The timeout in milliseconds to wait for the app to be ready before resetting to the default bundle. It is strongly **recommended** to configure this option so that the plugin can roll back to the default bundle in case of problems. If configured, the plugin will wait for the app to call the `ready()` method before resetting to the default bundle. Set to `0` to disable the timeout. | <code>0</code>                         | 5.0.0 |
-| **`serverDomain`**      | <code>string</code>  | The API domain of the [Capawesome Cloud](https://cloud.capawesome.io) server **without** scheme or path.                                                                                                                                                                                                                                                                                        | <code>'api.cloud.capawesome.io'</code> | 7.0.0 |
+| Prop                             | Type                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                | Default                                | Since |
+| -------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ----- |
+| **`appId`**                      | <code>string</code>                 | The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud/). This is **NOT** the same as the app identifier (e.g. `com.example.app`). This is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).                                                                                                                                      |                                        | 5.0.0 |
+| **`autoBlockRolledBackBundles`** | <code>boolean</code>                | Whether or not to automatically block bundles that have been rolled back. When enabled, the plugin will automatically block bundles that caused a rollback (up to 100 bundles). When the limit is reached, the oldest blocked bundle is unblocked. Blocked bundles will be skipped in future sync operations. **Attention**: This option has no effect if `readyTimeout` is set to `0`. Only available on Android and iOS. | <code>false</code>                     | 7.3.0 |
+| **`autoDeleteBundles`**          | <code>boolean</code>                | Whether or not to automatically delete unused bundles. When enabled, the plugin will automatically delete unused bundles after calling `ready()`.                                                                                                                                                                                                                                                                          | <code>false</code>                     | 5.0.0 |
+| **`autoUpdateStrategy`**         | <code>'none' \| 'background'</code> | The auto-update strategy for live updates. - `none`: Live updates will not be applied automatically. - `background`: Live updates will be automatically downloaded and applied in the background at app startup and when the app resumes (if the last check was more than 15 minutes ago). Only available on Android and iOS.                                                                                              | <code>'none'</code>                    | 7.3.0 |
+| **`defaultChannel`**             | <code>string</code>                 | The default channel of the app.                                                                                                                                                                                                                                                                                                                                                                                            |                                        | 6.3.0 |
+| **`httpTimeout`**                | <code>number</code>                 | The timeout in milliseconds for HTTP requests.                                                                                                                                                                                                                                                                                                                                                                             | <code>60000</code>                     | 6.4.0 |
+| **`publicKey`**                  | <code>string</code>                 | The public key to verify the integrity of the bundle. The public key must be a PEM-encoded RSA public key.                                                                                                                                                                                                                                                                                                                 |                                        | 6.1.0 |
+| **`readyTimeout`**               | <code>number</code>                 | The timeout in milliseconds to wait for the app to be ready before resetting to the default bundle. It is strongly **recommended** to configure this option (e.g. `10000` ms) so that the plugin can roll back to the default bundle in case of problems. If configured, the plugin will wait for the app to call the `ready()` method before resetting to the default bundle. Set to `0` to disable the timeout.          | <code>0</code>                         | 5.0.0 |
+| **`serverDomain`**               | <code>string</code>                 | The API domain of the [Capawesome Cloud](https://cloud.capawesome.io) server **without** scheme or path.                                                                                                                                                                                                                                                                                                                   | <code>'api.cloud.capawesome.io'</code> | 7.0.0 |
 
 ### Examples
 
@@ -98,7 +118,9 @@ In `capacitor.config.json`:
   "plugins": {
     "LiveUpdate": {
       "appId": '6e351b4f-69a7-415e-a057-4567df7ffe94',
+      "autoBlockRolledBackBundles": undefined,
       "autoDeleteBundles": undefined,
+      "autoUpdateStrategy": 'background',
       "defaultChannel": 'production',
       "httpTimeout": undefined,
       "publicKey": '-----BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDodf1SD0OOn6hIlDuKBza0Ed0OqtwyVJwiyjmE9BJaZ7y8ZUfcF+SKmd0l2cDPM45XIg2tAFux5n29uoKyHwSt+6tCi5CJA5Z1/1eZruRRqABLonV77KS3HUtvOgqRLDnKSV89dYZkM++NwmzOPgIF422mvc+VukcVOBfc8/AHQIDAQAB-----END PUBLIC KEY-----',
@@ -120,7 +142,9 @@ const config: CapacitorConfig = {
   plugins: {
     LiveUpdate: {
       appId: '6e351b4f-69a7-415e-a057-4567df7ffe94',
+      autoBlockRolledBackBundles: undefined,
       autoDeleteBundles: undefined,
+      autoUpdateStrategy: 'background',
       defaultChannel: 'production',
       httpTimeout: undefined,
       publicKey: '-----BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDodf1SD0OOn6hIlDuKBza0Ed0OqtwyVJwiyjmE9BJaZ7y8ZUfcF+SKmd0l2cDPM45XIg2tAFux5n29uoKyHwSt+6tCi5CJA5Z1/1eZruRRqABLonV77KS3HUtvOgqRLDnKSV89dYZkM++NwmzOPgIF422mvc+VukcVOBfc8/AHQIDAQAB-----END PUBLIC KEY-----',
@@ -135,20 +159,6 @@ export default config;
 
 </docgen-config>
 
-## Starter templates
-
-The following starter templates are available:
-
-- [Ionstarter Angular Firebase](https://ionstarter.dev/)
-- [Ionstarter Angular SQLite](https://ionstarter.dev/)
-
-## Guides
-
-- [Announcing the Capacitor Live Update Plugin](https://capawesome.io/blog/announcing-the-capacitor-live-update-plugin/)
-- [How Live Updates for Capacitor work](https://capawesome.io/blog/how-live-updates-for-capacitor-work/)
-- [How to restrict Capacitor Live Updates to Native Versions](https://capawesome.io/blog/how-to-restrict-capacitor-live-updates-to-native-versions/)
-- [How to gradually roll out Capacitor Live Updates](https://capawesome.io/blog/how-to-gradually-roll-out-capacitor-live-updates/)
-
 ## Usage
 
 ```typescript
@@ -282,6 +292,7 @@ const isNewBundleAvailable = async () => {
 * [`setNextBundle(...)`](#setnextbundle)
 * [`sync(...)`](#sync)
 * [`addListener('downloadBundleProgress', ...)`](#addlistenerdownloadbundleprogress-)
+* [`addListener('nextBundleSet', ...)`](#addlistenernextbundleset-)
 * [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -651,6 +662,31 @@ Only available on Android and iOS.
 --------------------
 
 
+### addListener('nextBundleSet', ...)
+
+```typescript
+addListener(eventName: 'nextBundleSet', listenerFunc: NextBundleSetListener) => Promise<PluginListenerHandle>
+```
+
+Listen for when a bundle is set as the next bundle.
+
+This event is triggered whenever a bundle is set to be used on the next app restart,
+either through automatic updates or manual calls to `setNextBundle()`.
+
+Only available on Android and iOS.
+
+| Param              | Type                                                                    |
+| ------------------ | ----------------------------------------------------------------------- |
+| **`eventName`**    | <code>'nextBundleSet'</code>                                            |
+| **`listenerFunc`** | <code><a href="#nextbundlesetlistener">NextBundleSetListener</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 7.3.0
+
+--------------------
+
+
 ### removeAllListeners()
 
 ```typescript
@@ -823,6 +859,15 @@ Event that is triggered when the download progress of a bundle changes.
 | **`totalBytes`**      | <code>number</code> | The total number of bytes to download.                                  | 7.0.0 |
 
 
+#### NextBundleSetEvent
+
+Event that is triggered when a bundle is set as the next bundle.
+
+| Prop           | Type                        | Description                                                                                                     | Since |
+| -------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------- | ----- |
+| **`bundleId`** | <code>string \| null</code> | The unique identifier of the bundle that is set as the next bundle. If `null`, the default bundle will be used. | 7.3.0 |
+
+
 ### Type Aliases
 
 
@@ -832,6 +877,13 @@ Listener for the download progress of a bundle.
 
 <code>(event: <a href="#downloadbundleprogressevent">DownloadBundleProgressEvent</a>): void</code>
 
+
+#### NextBundleSetListener
+
+Listener for when a bundle is set as the next bundle.
+
+<code>(event: <a href="#nextbundlesetevent">NextBundleSetEvent</a>): void</code>
+
 </docgen-api>
 
 ## Testing

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/LiveUpdate.java

@@ -17,6 +17,7 @@ import io.capawesome.capacitorjs.plugins.liveupdate.classes.Manifest;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.ManifestItem;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.api.GetLatestBundleResponse;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.events.DownloadBundleProgressEvent;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.events.NextBundleSetEvent;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.DeleteBundleOptions;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.DownloadBundleOptions;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.FetchLatestBundleOptions;
@@ -67,6 +68,8 @@ import org.json.JSONObject;
 
 public class LiveUpdate {
 
+    private final long autoUpdateIntervalMs = 15 * 60 * 1000; // 15 minutes
+
     @NonNull
     private final LiveUpdateConfig config;
 
@@ -88,7 +91,10 @@ public class LiveUpdate {
     private final Handler rollbackHandler = new Handler();
     private final String manifestFileName = "capawesome-live-update-manifest.json"; // DO NOT CHANGE!
 
+    private boolean initialPageLoaded = false;
+    private long lastAutoUpdateCheckTimestamp = 0;
     private boolean rollbackPerformed = false;
+    private boolean syncInProgress = false;
 
     public LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull LiveUpdatePlugin plugin) throws PackageManager.NameNotFoundException {
         this.config = config;
@@ -205,6 +211,21 @@ public class LiveUpdate {
         callback.success(result);
     }
 
+    public void handleOnPageLoaded() {
+        // Wait for initial page load to perform auto update to make sure the WebViewLocalServer is initialized.
+        // Otherwise, a NullPointerException may occur for `com.getcapacitor.WebViewLocalServer.getBasePath()`.
+        if ("background".equals(config.getAutoUpdateStrategy()) && !initialPageLoaded) {
+            initialPageLoaded = true;
+            performAutoUpdate();
+        }
+    }
+
+    public void handleOnResume() {
+        if ("background".equals(config.getAutoUpdateStrategy()) && initialPageLoaded) {
+            performAutoUpdate();
+        }
+    }
+
     public void ready(@NonNull NonEmptyCallback callback) {
         Logger.debug(LiveUpdatePlugin.TAG, "App is ready.");
         if (config.getReadyTimeout() <= 0) {
@@ -219,6 +240,10 @@ public class LiveUpdate {
         // Get the current and previous bundle IDs
         String currentBundleId = getCurrentBundleId();
         String previousBundleId = getPreviousBundleId();
+        // Block the rolled back bundle if enabled
+        if (config.getAutoBlockRolledBackBundles() && rollbackPerformed && previousBundleId != null) {
+            addBlockedBundleId(previousBundleId);
+        }
         // Return the result
         ReadyResult result = new ReadyResult(currentBundleId, previousBundleId, rollbackPerformed);
         callback.success(result);
@@ -270,44 +295,62 @@ public class LiveUpdate {
     }
 
     public void sync(@NonNull SyncOptions options, @NonNull NonEmptyCallback<Result> callback) throws Exception {
-        String channel = options.getChannel();
-        // Fetch the latest bundle
-        FetchLatestBundleOptions fetchLatestBundleOptions = new FetchLatestBundleOptions(channel);
-        GetLatestBundleResponse response = fetchLatestBundle(fetchLatestBundleOptions);
-        if (response == null) {
-            Logger.debug(LiveUpdatePlugin.TAG, "No update available.");
-            SyncResult syncResult = new SyncResult(null);
-            callback.success(syncResult);
+        if (syncInProgress) {
+            Exception exception = new Exception(LiveUpdatePlugin.ERROR_SYNC_IN_PROGRESS);
+            callback.error(exception);
             return;
         }
-        ArtifactType artifactType = response.getArtifactType();
-        String latestBundleId = response.getBundleId();
-        String checksum = response.getChecksum();
-        String signature = response.getSignature();
-        String url = response.getUrl();
-        // Check if the bundle already exists
-        if (hasBundleById(latestBundleId)) {
-            String nextBundleId = null;
-            String currentBundleId = getCurrentBundleId();
-            if (!latestBundleId.equals(currentBundleId)) {
-                // Set the next bundle
-                setNextBundleById(latestBundleId);
-                nextBundleId = latestBundleId;
+        syncInProgress = true;
+
+        try {
+            String channel = options.getChannel();
+            // Fetch the latest bundle
+            FetchLatestBundleOptions fetchLatestBundleOptions = new FetchLatestBundleOptions(channel);
+            GetLatestBundleResponse response = fetchLatestBundle(fetchLatestBundleOptions);
+            if (response == null) {
+                Logger.debug(LiveUpdatePlugin.TAG, "No update available.");
+                SyncResult syncResult = new SyncResult(null);
+                callback.success(syncResult);
+                return;
             }
-            SyncResult syncResult = new SyncResult(nextBundleId);
+            ArtifactType artifactType = response.getArtifactType();
+            String latestBundleId = response.getBundleId();
+            String checksum = response.getChecksum();
+            String signature = response.getSignature();
+            String url = response.getUrl();
+            // Check if the bundle is blocked
+            if (isBlockedBundleId(latestBundleId)) {
+                Logger.warn(LiveUpdatePlugin.TAG, "Bundle is blocked and will not be downloaded.");
+                SyncResult syncResult = new SyncResult(null);
+                callback.success(syncResult);
+                return;
+            }
+            // Check if the bundle already exists
+            if (hasBundleById(latestBundleId)) {
+                String nextBundleId = null;
+                String currentBundleId = getCurrentBundleId();
+                if (!latestBundleId.equals(currentBundleId)) {
+                    // Set the next bundle
+                    setNextBundleById(latestBundleId);
+                    nextBundleId = latestBundleId;
+                }
+                SyncResult syncResult = new SyncResult(nextBundleId);
+                callback.success(syncResult);
+                return;
+            }
+            // Download the bundle
+            if (artifactType == ArtifactType.MANIFEST) {
+                downloadBundleOfTypeManifest(latestBundleId, url);
+            } else {
+                downloadBundleOfTypeZip(latestBundleId, checksum, signature, url);
+            }
+            // Set the next bundle
+            setNextBundleById(latestBundleId);
+            SyncResult syncResult = new SyncResult(latestBundleId);
             callback.success(syncResult);
-            return;
+        } finally {
+            syncInProgress = false;
         }
-        // Download the bundle
-        if (artifactType == ArtifactType.MANIFEST) {
-            downloadBundleOfTypeManifest(latestBundleId, url);
-        } else {
-            downloadBundleOfTypeZip(latestBundleId, checksum, signature, url);
-        }
-        // Set the next bundle
-        setNextBundleById(latestBundleId);
-        SyncResult syncResult = new SyncResult(latestBundleId);
-        callback.success(syncResult);
     }
 
     private void addBundle(@NonNull String bundleId, @NonNull File sourceDirectory) throws Exception {
@@ -766,10 +809,15 @@ public class LiveUpdate {
      */
     @NonNull
     private String getNextCapacitorServerPath() {
-        return plugin
+        String path = plugin
             .getContext()
             .getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE)
             .getString(WebView.CAP_SERVER_PATH, defaultWebAssetDir);
+        // Empty path means default path
+        if (path.isEmpty()) {
+            path = defaultWebAssetDir;
+        }
+        return path;
     }
 
     /**
@@ -834,10 +882,44 @@ public class LiveUpdate {
         return loadManifest(source);
     }
 
-    public void notifyDownloadBundleProgressListeners(@NonNull final DownloadBundleProgressEvent event) {
+    private void notifyDownloadBundleProgressListeners(@NonNull final DownloadBundleProgressEvent event) {
         plugin.notifyDownloadBundleProgressListeners(event);
     }
 
+    private void performAutoUpdate() {
+        // Check if enough time has passed since the last check
+        long now = System.currentTimeMillis();
+        if (lastAutoUpdateCheckTimestamp > 0 && (now - lastAutoUpdateCheckTimestamp) < autoUpdateIntervalMs) {
+            Logger.debug(LiveUpdatePlugin.TAG, "Auto-update skipped. Last check was less than 15 minutes ago.");
+            return;
+        }
+
+        // Update the timestamp
+        lastAutoUpdateCheckTimestamp = now;
+
+        // Run sync in background thread
+        new Thread(() -> {
+            try {
+                Logger.debug(LiveUpdatePlugin.TAG, "Auto-update started.");
+                SyncOptions options = new SyncOptions((String) null);
+                NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
+                    @Override
+                    public void success(Result result) {
+                        Logger.debug(LiveUpdatePlugin.TAG, "Auto-update completed successfully.");
+                    }
+
+                    @Override
+                    public void error(Exception exception) {
+                        Logger.error(LiveUpdatePlugin.TAG, "Auto-update failed: " + exception.getMessage(), exception);
+                    }
+                };
+                sync(options, callback);
+            } catch (Exception exception) {
+                Logger.error(LiveUpdatePlugin.TAG, "Auto-update failed: " + exception.getMessage(), exception);
+            }
+        }).start();
+    }
+
     private void rollback() {
         // Set the rollback flag
         rollbackPerformed = true;
@@ -911,6 +993,54 @@ public class LiveUpdate {
             File bundleDirectory = buildBundleDirectoryFor(bundleId);
             setNextCapacitorServerPath(bundleDirectory.getPath());
         }
+
+        // Notify listeners
+        notifyNextBundleSetListeners(bundleId);
+    }
+
+    private void notifyNextBundleSetListeners(@Nullable String bundleId) {
+        NextBundleSetEvent event = new NextBundleSetEvent(bundleId);
+        plugin.notifyNextBundleSetListeners(event);
+    }
+
+    private void addBlockedBundleId(@NonNull String bundleId) {
+        String blockedIds = preferences.getBlockedBundleIds();
+        List<String> blockedList = new ArrayList<>();
+
+        // Parse existing blocked IDs
+        if (blockedIds != null && !blockedIds.isEmpty()) {
+            String[] ids = blockedIds.split(",");
+            blockedList.addAll(Arrays.asList(ids));
+        }
+
+        // Skip if already blocked
+        if (blockedList.contains(bundleId)) {
+            return;
+        }
+
+        // Remove oldest if limit reached
+        if (blockedList.size() >= 100) {
+            blockedList.remove(0);
+        }
+
+        // Add new bundle
+        blockedList.add(bundleId);
+
+        // Save back to preferences
+        String newBlockedIds = String.join(",", blockedList);
+        preferences.setBlockedBundleIds(newBlockedIds);
+
+        Logger.debug(LiveUpdatePlugin.TAG, "Bundle blocked: " + bundleId);
+    }
+
+    private boolean isBlockedBundleId(@NonNull String bundleId) {
+        String blockedIds = preferences.getBlockedBundleIds();
+        if (blockedIds == null || blockedIds.isEmpty()) {
+            return false;
+        }
+
+        String[] ids = blockedIds.split(",");
+        return Arrays.asList(ids).contains(bundleId);
     }
 
     private void setNextCapacitorServerPath(@NonNull String path) {

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/LiveUpdateConfig.java

@@ -1,5 +1,6 @@
 package io.capawesome.capacitorjs.plugins.liveupdate;
 
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import java.security.Key;
 
@@ -8,8 +9,13 @@ public class LiveUpdateConfig {
     @Nullable
     private String appId = null;
 
+    private boolean autoBlockRolledBackBundles = false;
+
     private boolean autoDeleteBundles = false;
 
+    @NonNull
+    private String autoUpdateStrategy = "none";
+
     @Nullable
     private String defaultChannel = null;
 
@@ -26,10 +32,19 @@ public class LiveUpdateConfig {
         return appId;
     }
 
+    public boolean getAutoBlockRolledBackBundles() {
+        return autoBlockRolledBackBundles;
+    }
+
     public boolean getAutoDeleteBundles() {
         return autoDeleteBundles;
     }
 
+    @NonNull
+    public String getAutoUpdateStrategy() {
+        return autoUpdateStrategy;
+    }
+
     @Nullable
     public String getDefaultChannel() {
         return defaultChannel;
@@ -56,10 +71,18 @@ public class LiveUpdateConfig {
         this.appId = appId;
     }
 
+    public void setAutoBlockRolledBackBundles(boolean autoBlockRolledBackBundles) {
+        this.autoBlockRolledBackBundles = autoBlockRolledBackBundles;
+    }
+
     public void setAutoDeleteBundles(boolean autoDeleteBundles) {
         this.autoDeleteBundles = autoDeleteBundles;
     }
 
+    public void setAutoUpdateStrategy(@NonNull String autoUpdateStrategy) {
+        this.autoUpdateStrategy = autoUpdateStrategy;
+    }
+
     public void setDefaultChannel(@Nullable String defaultChannel) {
         this.defaultChannel = defaultChannel;
     }