@capawesome/capacitor-live-update 6.8.0 → 7.0.0-dev.2633ff2.1765953041

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

@@ -1,21 +1,32 @@
 package io.capawesome.capacitorjs.plugins.liveupdate;
 
+import android.webkit.WebView;
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
 import com.getcapacitor.Logger;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
+import com.getcapacitor.WebViewListener;
 import com.getcapacitor.annotation.CapacitorPlugin;
+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;
-import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.SetBundleOptions;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.SetChannelOptions;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.SetConfigOptions;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.SetCustomIdOptions;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.SetNextBundleOptions;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.options.SyncOptions;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.FetchLatestBundleResult;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.GetBlockedBundlesResult;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.GetConfigResult;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.GetCurrentBundleResult;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.GetDownloadedBundlesResult;
 import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.GetNextBundleResult;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.IsSyncingResult;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.EmptyCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.NonEmptyCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
@@ -24,7 +35,7 @@ import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
 public class LiveUpdatePlugin extends Plugin {
 
     public static final String TAG = "LiveUpdate";
-    public static final String VERSION = "6.8.0";
+    public static final String VERSION = "7.4.0";
     public static final String SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdate"; // DO NOT CHANGE
     public static final String ERROR_APP_ID_MISSING = "appId must be configured.";
     public static final String ERROR_BUNDLE_EXISTS = "bundle already exists.";
@@ -42,8 +53,9 @@ public class LiveUpdatePlugin extends Plugin {
     public static final String ERROR_SIGNATURE_MISSING = "Bundle does not contain a signature.";
     public static final String ERROR_SYNC_IN_PROGRESS = "Sync is already in progress.";
     public static final String ERROR_UNKNOWN_ERROR = "An unknown error has occurred.";
-
-    private boolean syncInProgress = false;
+    public static final String EVENT_DOWNLOAD_BUNDLE_PROGRESS = "downloadBundleProgress";
+    public static final String EVENT_NEXT_BUNDLE_SET = "nextBundleSet";
+    public static final String EVENT_RELOADED = "reloaded";
 
     @Nullable
     private LiveUpdateConfig config;
@@ -51,6 +63,8 @@ public class LiveUpdatePlugin extends Plugin {
     @Nullable
     private LiveUpdate implementation;
 
+    private boolean webViewListenerRegistered = false;
+
     public void load() {
         try {
             config = getLiveUpdateConfig();
@@ -60,6 +74,46 @@ public class LiveUpdatePlugin extends Plugin {
         }
     }
 
+    @Override
+    protected void handleOnResume() {
+        super.handleOnResume();
+        try {
+            // Notify the implementation that the app has resumed
+            if (implementation != null) {
+                implementation.handleOnResume();
+            }
+            // Register WebView listener to trigger auto-update when page is loaded
+            // Important: For some reason, the listener CANNOT be registered in the load() method
+            // or constructor, it MUST be done here in onResume().
+            if (!webViewListenerRegistered) {
+                webViewListenerRegistered = true;
+                getBridge()
+                    .addWebViewListener(
+                        new WebViewListener() {
+                            @Override
+                            public void onPageLoaded(WebView webView) {
+                                if (implementation != null) {
+                                    implementation.handleOnPageLoaded();
+                                }
+                            }
+                        }
+                    );
+            }
+        } catch (Exception exception) {
+            Logger.error(TAG, exception.getMessage(), exception);
+        }
+    }
+
+    @PluginMethod
+    public void clearBlockedBundles(PluginCall call) {
+        try {
+            implementation.clearBlockedBundles();
+            resolveCall(call);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
     @PluginMethod
     public void deleteBundle(PluginCall call) {
         try {
@@ -73,7 +127,7 @@ public class LiveUpdatePlugin extends Plugin {
             EmptyCallback callback = new EmptyCallback() {
                 @Override
                 public void success() {
-                    call.resolve();
+                    resolveCall(call);
                 }
 
                 @Override
@@ -109,7 +163,7 @@ public class LiveUpdatePlugin extends Plugin {
             EmptyCallback callback = new EmptyCallback() {
                 @Override
                 public void success() {
-                    call.resolve();
+                    resolveCall(call);
                 }
 
                 @Override
@@ -127,11 +181,17 @@ public class LiveUpdatePlugin extends Plugin {
     @PluginMethod
     public void fetchLatestBundle(PluginCall call) {
         try {
+            String appId = config.getAppId();
+            if (appId == null || appId.isEmpty()) {
+                call.reject(ERROR_APP_ID_MISSING);
+                return;
+            }
+
             FetchLatestBundleOptions options = new FetchLatestBundleOptions(call);
-            NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
+            NonEmptyCallback<FetchLatestBundleResult> callback = new NonEmptyCallback<>() {
                 @Override
-                public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                public void success(FetchLatestBundleResult result) {
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -147,12 +207,12 @@ public class LiveUpdatePlugin extends Plugin {
     }
 
     @PluginMethod
-    public void getBundle(PluginCall call) {
+    public void getBlockedBundles(PluginCall call) {
         try {
-            NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
+            NonEmptyCallback<GetBlockedBundlesResult> callback = new NonEmptyCallback<>() {
                 @Override
-                public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                public void success(GetBlockedBundlesResult result) {
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -161,7 +221,8 @@ public class LiveUpdatePlugin extends Plugin {
                 }
             };
 
-            implementation.getBundle(callback);
+            assert implementation != null;
+            implementation.getBlockedBundles(callback);
         } catch (Exception exception) {
             rejectCall(call, exception);
         }
@@ -173,7 +234,7 @@ public class LiveUpdatePlugin extends Plugin {
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -188,13 +249,35 @@ public class LiveUpdatePlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void getDownloadedBundles(PluginCall call) {
+        try {
+            NonEmptyCallback<GetDownloadedBundlesResult> callback = new NonEmptyCallback<>() {
+                @Override
+                public void success(GetDownloadedBundlesResult result) {
+                    resolveCall(call, result.toJSObject());
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            assert implementation != null;
+            implementation.getDownloadedBundles(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
     @PluginMethod
     public void getChannel(PluginCall call) {
         try {
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -209,13 +292,35 @@ public class LiveUpdatePlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void getConfig(PluginCall call) {
+        try {
+            NonEmptyCallback<GetConfigResult> callback = new NonEmptyCallback<>() {
+                @Override
+                public void success(GetConfigResult result) {
+                    resolveCall(call, result.toJSObject());
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            assert implementation != null;
+            implementation.getConfig(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
     @PluginMethod
     public void getCurrentBundle(PluginCall call) {
         try {
             NonEmptyCallback<GetCurrentBundleResult> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(GetCurrentBundleResult result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -237,7 +342,7 @@ public class LiveUpdatePlugin extends Plugin {
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -258,7 +363,7 @@ public class LiveUpdatePlugin extends Plugin {
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -279,7 +384,7 @@ public class LiveUpdatePlugin extends Plugin {
             NonEmptyCallback<GetNextBundleResult> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(GetNextBundleResult result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -301,7 +406,7 @@ public class LiveUpdatePlugin extends Plugin {
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -322,7 +427,7 @@ public class LiveUpdatePlugin extends Plugin {
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
@@ -337,11 +442,44 @@ public class LiveUpdatePlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void isSyncing(PluginCall call) {
+        try {
+            NonEmptyCallback<IsSyncingResult> callback = new NonEmptyCallback<>() {
+                @Override
+                public void success(IsSyncingResult result) {
+                    resolveCall(call, result.toJSObject());
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            assert implementation != null;
+            implementation.isSyncing(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
     @PluginMethod
     public void ready(PluginCall call) {
         try {
-            implementation.ready();
-            call.resolve();
+            NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
+                @Override
+                public void success(Result result) {
+                    resolveCall(call, result.toJSObject());
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            implementation.ready(callback);
         } catch (Exception exception) {
             rejectCall(call, exception);
         }
@@ -351,7 +489,7 @@ public class LiveUpdatePlugin extends Plugin {
     public void reload(PluginCall call) {
         try {
             implementation.reload();
-            call.resolve();
+            resolveCall(call);
         } catch (Exception exception) {
             rejectCall(call, exception);
         }
@@ -361,35 +499,17 @@ public class LiveUpdatePlugin extends Plugin {
     public void reset(PluginCall call) {
         try {
             implementation.reset();
-            call.resolve();
+            resolveCall(call);
         } catch (Exception exception) {
             rejectCall(call, exception);
         }
     }
 
     @PluginMethod
-    public void setBundle(PluginCall call) {
+    public void resetConfig(PluginCall call) {
         try {
-            String bundleId = call.getString("bundleId");
-            if (bundleId == null) {
-                call.reject(ERROR_BUNDLE_ID_MISSING);
-                return;
-            }
-
-            SetBundleOptions options = new SetBundleOptions(bundleId);
-            EmptyCallback callback = new EmptyCallback() {
-                @Override
-                public void success() {
-                    call.resolve();
-                }
-
-                @Override
-                public void error(Exception exception) {
-                    rejectCall(call, exception);
-                }
-            };
-
-            implementation.setBundle(options, callback);
+            implementation.resetConfig();
+            resolveCall(call);
         } catch (Exception exception) {
             rejectCall(call, exception);
         }
@@ -404,7 +524,7 @@ public class LiveUpdatePlugin extends Plugin {
             EmptyCallback callback = new EmptyCallback() {
                 @Override
                 public void success() {
-                    call.resolve();
+                    resolveCall(call);
                 }
 
                 @Override
@@ -419,6 +539,17 @@ public class LiveUpdatePlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void setConfig(PluginCall call) {
+        try {
+            SetConfigOptions options = new SetConfigOptions(call);
+            implementation.setConfig(options);
+            resolveCall(call);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
     @PluginMethod
     public void setCustomId(PluginCall call) {
         try {
@@ -432,7 +563,7 @@ public class LiveUpdatePlugin extends Plugin {
             EmptyCallback callback = new EmptyCallback() {
                 @Override
                 public void success() {
-                    call.resolve();
+                    resolveCall(call);
                 }
 
                 @Override
@@ -454,7 +585,7 @@ public class LiveUpdatePlugin extends Plugin {
             EmptyCallback callback = new EmptyCallback() {
                 @Override
                 public void success() {
-                    call.resolve();
+                    resolveCall(call);
                 }
 
                 @Override
@@ -473,64 +604,76 @@ public class LiveUpdatePlugin extends Plugin {
     public void sync(PluginCall call) {
         try {
             String appId = config.getAppId();
-            if (appId == null) {
+            if (appId == null || appId.isEmpty()) {
                 call.reject(ERROR_APP_ID_MISSING);
                 return;
             }
 
-            if (syncInProgress) {
-                call.reject(ERROR_SYNC_IN_PROGRESS);
-                return;
-            }
-            syncInProgress = true;
-
             SyncOptions options = new SyncOptions(call);
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
-                    syncInProgress = false;
-                    call.resolve(result.toJSObject());
+                    resolveCall(call, result.toJSObject());
                 }
 
                 @Override
                 public void error(Exception exception) {
-                    syncInProgress = false;
                     rejectCall(call, exception);
                 }
             };
 
             implementation.sync(options, callback);
         } catch (Exception exception) {
-            syncInProgress = false;
             rejectCall(call, exception);
         }
     }
 
+    public void notifyDownloadBundleProgressListeners(@NonNull DownloadBundleProgressEvent event) {
+        notifyListeners(EVENT_DOWNLOAD_BUNDLE_PROGRESS, event.toJSObject(), false);
+    }
+
+    public void notifyNextBundleSetListeners(@NonNull NextBundleSetEvent event) {
+        notifyListeners(EVENT_NEXT_BUNDLE_SET, event.toJSObject(), false);
+    }
+
+    public void notifyReloadedListeners() {
+        JSObject event = new JSObject();
+        notifyListeners(EVENT_RELOADED, event, true);
+    }
+
     private LiveUpdateConfig getLiveUpdateConfig() {
         LiveUpdateConfig config = new LiveUpdateConfig();
 
         String appId = getConfig().getString("appId", config.getAppId());
         config.setAppId(appId);
+        boolean autoBlockRolledBackBundles = getConfig().getBoolean("autoBlockRolledBackBundles", config.getAutoBlockRolledBackBundles());
+        config.setAutoBlockRolledBackBundles(autoBlockRolledBackBundles);
         boolean autoDeleteBundles = getConfig().getBoolean("autoDeleteBundles", config.getAutoDeleteBundles());
         config.setAutoDeleteBundles(autoDeleteBundles);
+        String autoUpdateStrategy = getConfig().getString("autoUpdateStrategy", config.getAutoUpdateStrategy());
+        config.setAutoUpdateStrategy(autoUpdateStrategy);
         String defaultChannel = getConfig().getString("defaultChannel", config.getDefaultChannel());
         config.setDefaultChannel(defaultChannel);
-        boolean enabled = getConfig().getBoolean("enabled", config.getEnabled());
-        config.setEnabled(enabled);
         int httpTimeout = getConfig().getInt("httpTimeout", config.getHttpTimeout());
         config.setHttpTimeout(httpTimeout);
-        String location = getConfig().getString("location", config.getLocation());
-        config.setLocation(location);
         String publicKey = getConfig().getString("publicKey", config.getPublicKey());
         config.setPublicKey(publicKey);
         int readyTimeout = getConfig().getInt("readyTimeout", config.getReadyTimeout());
         config.setReadyTimeout(readyTimeout);
-        boolean resetOnUpdate = getConfig().getBoolean("resetOnUpdate", config.getResetOnUpdate());
-        config.setResetOnUpdate(resetOnUpdate);
+        String serverDomain = getConfig().getString("serverDomain", config.getServerDomain());
+        config.setServerDomain(serverDomain);
 
         return config;
     }
 
+    private void resolveCall(@NonNull PluginCall call) {
+        call.resolve();
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @NonNull JSObject result) {
+        call.resolve(result);
+    }
+
     private void rejectCall(PluginCall call, Exception exception) {
         String message = exception.getMessage();
         if (exception instanceof java.net.SocketTimeoutException) {

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

@@ -15,16 +15,24 @@ public class LiveUpdatePreferences {
     @NonNull
     private final SharedPreferences.Editor settingsEditor;
 
+    private final String appIdKey = "appId"; // DO NOT CHANGE
+    private final String blockedBundleIdsKey = "blockedBundleIds"; // DO NOT CHANGE
     private final String channelKey = "channel"; // DO NOT CHANGE
     private final String deviceIdKey = "deviceId"; // DO NOT CHANGE
     private final String customIdKey = "customId"; // DO NOT CHANGE
     private final String lastVersionCodeKey = "lastVersionCode"; // DO NOT CHANGE
+    private final String previousBundleIdKey = "previousBundleId"; // DO NOT CHANGE
 
     public LiveUpdatePreferences(@NonNull Context context) {
         this.context = context;
         this.settingsEditor = context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).edit();
     }
 
+    @Nullable
+    public String getAppId() {
+        return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(appIdKey, null);
+    }
+
     @Nullable
     public String getChannel() {
         return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(channelKey, null);
@@ -49,7 +57,39 @@ public class LiveUpdatePreferences {
     }
 
     public int getLastVersionCode() {
-        return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getInt(lastVersionCodeKey, 0);
+        return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getInt(lastVersionCodeKey, -1);
+    }
+
+    @Nullable
+    public String getPreviousBundleId() {
+        return context
+            .getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE)
+            .getString(previousBundleIdKey, null);
+    }
+
+    @Nullable
+    public String getBlockedBundleIds() {
+        return context
+            .getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE)
+            .getString(blockedBundleIdsKey, null);
+    }
+
+    public void setAppId(@Nullable String appId) {
+        if (appId == null) {
+            settingsEditor.remove(appIdKey);
+        } else {
+            settingsEditor.putString(appIdKey, appId);
+        }
+        settingsEditor.apply();
+    }
+
+    public void setBlockedBundleIds(@Nullable String blockedBundleIds) {
+        if (blockedBundleIds == null) {
+            settingsEditor.remove(blockedBundleIdsKey);
+        } else {
+            settingsEditor.putString(blockedBundleIdsKey, blockedBundleIds);
+        }
+        settingsEditor.apply();
     }
 
     public void setChannel(@Nullable String channel) {
@@ -79,8 +119,17 @@ public class LiveUpdatePreferences {
         settingsEditor.apply();
     }
 
-    public void setLastVersionCode(int lastVersionCode) {
-        settingsEditor.putInt(lastVersionCodeKey, lastVersionCode);
+    public void setLastVersionCode(int versionCode) {
+        settingsEditor.putInt(lastVersionCodeKey, versionCode);
+        settingsEditor.apply();
+    }
+
+    public void setPreviousBundleId(@Nullable String bundleId) {
+        if (bundleId == null) {
+            settingsEditor.remove(previousBundleIdKey);
+        } else {
+            settingsEditor.putString(previousBundleIdKey, bundleId);
+        }
         settingsEditor.apply();
     }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/api/GetLatestBundleResponse.java

@@ -19,6 +19,9 @@ public class GetLatestBundleResponse {
     @Nullable
     private String checksum;
 
+    @Nullable
+    private JSONObject customProperties;
+
     @Nullable
     private String signature;
 
@@ -33,8 +36,9 @@ public class GetLatestBundleResponse {
             this.artifactType = ArtifactType.ZIP;
         }
         this.bundleId = responseJson.optString("bundleId");
-        this.checksum = responseJson.optString("checksum");
-        this.signature = responseJson.optString("signature");
+        this.checksum = responseJson.isNull("checksum") ? null : responseJson.optString("checksum");
+        this.customProperties = responseJson.optJSONObject("customProperties");
+        this.signature = responseJson.isNull("signature") ? null : responseJson.optString("signature");
         this.url = responseJson.optString("url");
     }
 
@@ -48,6 +52,11 @@ public class GetLatestBundleResponse {
         return bundleId;
     }
 
+    @Nullable
+    public JSONObject getCustomProperties() {
+        return customProperties;
+    }
+
     @Nullable
     public String getChecksum() {
         return checksum;

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/classes/events/DownloadBundleProgressEvent.java

@@ -0,0 +1,32 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes.events;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
+
+public class DownloadBundleProgressEvent implements Result {
+
+    @NonNull
+    private final String bundleId;
+
+    private final long downloadedBytes;
+    private final long totalBytes;
+    private final double progress;
+
+    public DownloadBundleProgressEvent(@NonNull String bundleId, long downloadedBytes, long totalBytes) {
+        this.bundleId = bundleId;
+        this.downloadedBytes = downloadedBytes;
+        this.totalBytes = totalBytes;
+        this.progress = (double) downloadedBytes / (double) totalBytes;
+    }
+
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("bundleId", bundleId);
+        result.put("downloadedBytes", downloadedBytes);
+        result.put("progress", progress);
+        result.put("totalBytes", totalBytes);
+        return result;
+    }
+}