@capawesome/capacitor-live-update 8.0.0 → 8.1.0-dev.97c86c2c.1768835749

package/CapawesomeCapacitorLiveUpdate.podspec

@@ -11,10 +11,10 @@ Pod::Spec.new do |s|
   s.author = package['author']
   s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
   s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
-  s.ios.deployment_target = '16.0'
+  s.ios.deployment_target = '15.0'
   s.dependency 'Capacitor'
   s.dependency 'Alamofire', '~> 5.10.2'
-  s.dependency 'SSZipArchive', '~> 2.6.0'
+  s.dependency 'ZIPFoundation', '~> 0.9.0'
   s.swift_version = '5.1'
   s.static_framework = true
 end

package/Package.swift

@@ -3,7 +3,7 @@ import PackageDescription
 
 let package = Package(
     name: "CapawesomeCapacitorLiveUpdate",
-    platforms: [.iOS(.v16)],
+    platforms: [.iOS(.v15)],
     products: [
         .library(
             name: "CapawesomeCapacitorLiveUpdate",
@@ -12,7 +12,7 @@ let package = Package(
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0"),
         .package(url: "https://github.com/Alamofire/Alamofire.git", .upToNextMinor(from: "5.10.2")),
-        .package(url: "https://github.com/ZipArchive/ZipArchive.git", .upToNextMinor(from: "2.6.0"))
+        .package(url: "https://github.com/weichsel/ZIPFoundation.git", .upToNextMinor(from: "0.9.0"))
     ],
     targets: [
         .target(
@@ -21,7 +21,7 @@ let package = Package(
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
                 .product(name: "Cordova", package: "capacitor-swift-pm"),
                 .product(name: "Alamofire", package: "Alamofire"),
-                .product(name: "ZipArchive", package: "ZipArchive")
+                .product(name: "ZIPFoundation", package: "ZIPFoundation")
             ],
             path: "ios/Plugin"),
         .testTarget(

package/README.md

@@ -13,7 +13,7 @@ Capacitor plugin that allows you to update your app remotely in real-time withou
 We are proud to offer one of the most complete and feature-rich Capacitor plugins for Over-the-Air (OTA) updates. Here are some of the key features:
 
 - 🔋 Supports **Android and iOS**
-- ⚡️ **Capacitor 7** support
+- ⚡️ **Capacitor 6/7/8** support
 - 📦 **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.
@@ -38,12 +38,8 @@ Missing a feature? Just [open an issue](https://github.com/capawesome-team/capac
 
 ## 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/)
+- [Getting Started with Capawesome Cloud Live Updates](https://capawesome.io/cloud/live-updates/setup/)
+- [Migrating from Ionic Appflow to Capawesome Cloud](https://capawesome.io/blog/migrating-from-ionic-appflow-to-capawesome-cloud/)
 - [Migrating from App Center to Capawesome Cloud](https://capawesome.io/blog/migrating-from-app-center-to-capawesome-cloud/)
 
 ## Installation
@@ -93,21 +89,6 @@ Add the `NSPrivacyAccessedAPICategoryUserDefaults` dictionary key to your [Priva
 
 We recommend to declare [`CA92.1`](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api#4278401) as the reason for accessing the [`UserDefaults`](https://developer.apple.com/documentation/foundation/userdefaults) API.
 
-#### Minimum Deployment Target
-
-If you are using **Swift Package Manager**, make sure that your iOS deployment target is set to at least `16.0` in your Xcode project settings (usually in `ios/App/App.xcodeproj`):
-
-```diff
--IPHONEOS_DEPLOYMENT_TARGET = 15.0
-+IPHONEOS_DEPLOYMENT_TARGET = 16.0
-```
-
-If you are using **CocoaPods**, make sure that your iOS deployment target is set to at least `16.0` in your `Podfile`:
-
-```ruby
-platform :ios, '16.0'
-```
-
 ## Configuration
 
 <docgen-config>

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

@@ -1,6 +1,7 @@
 package io.capawesome.capacitorjs.plugins.liveupdate;
 
 import android.app.Activity;
+import android.content.Context;
 import android.content.SharedPreferences;
 import android.content.pm.PackageInfo;
 import android.content.pm.PackageManager;
@@ -13,6 +14,7 @@ import androidx.annotation.Nullable;
 import com.getcapacitor.Bridge;
 import com.getcapacitor.Logger;
 import com.getcapacitor.plugin.WebView;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.CustomExceptions;
 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;
@@ -44,6 +46,7 @@ import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.SyncResult;
 import io.capawesome.capacitorjs.plugins.liveupdate.enums.ArtifactType;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.DownloadProgressCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.EmptyCallback;
+import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.LiveUpdateEventEmitter;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.NonEmptyCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
 import java.io.File;
@@ -77,18 +80,32 @@ import org.json.JSONObject;
 
 public class LiveUpdate {
 
+    public static final String TAG = "LiveUpdate";
+    public static final String VERSION = "8.1.1";
+
+    @Nullable
+    private static LiveUpdate instance = null;
+
+    private static final Object LOCK = new Object();
+
     private final long autoUpdateIntervalMs = 15 * 60 * 1000; // 15 minutes
 
+    @NonNull
+    private final Bridge bridge;
+
     @NonNull
     private final LiveUpdateConfig config;
 
+    @NonNull
+    private final Context context;
+
     private final String defaultWebAssetDir = Bridge.DEFAULT_WEB_ASSET_DIR;
 
-    @NonNull
-    private final LiveUpdateHttpClient httpClient;
+    @Nullable
+    private final LiveUpdateEventEmitter eventEmitter;
 
     @NonNull
-    private final LiveUpdatePlugin plugin;
+    private final LiveUpdateHttpClient httpClient;
 
     @NonNull
     private final LiveUpdatePreferences preferences;
@@ -105,12 +122,19 @@ public class LiveUpdate {
     private boolean rollbackPerformed = false;
     private boolean syncInProgress = false;
 
-    public LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull LiveUpdatePlugin plugin) throws PackageManager.NameNotFoundException {
+    private LiveUpdate(
+        @NonNull Context context,
+        @NonNull Bridge bridge,
+        @NonNull LiveUpdateConfig config,
+        @Nullable LiveUpdateEventEmitter eventEmitter
+    ) throws PackageManager.NameNotFoundException {
+        this.context = context;
+        this.bridge = bridge;
         this.config = config;
+        this.eventEmitter = eventEmitter;
         this.httpClient = new LiveUpdateHttpClient(config);
-        this.plugin = plugin;
-        this.preferences = new LiveUpdatePreferences(plugin.getContext());
-        this.webViewSettingsEditor = plugin.getContext().getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE).edit();
+        this.preferences = new LiveUpdatePreferences(context);
+        this.webViewSettingsEditor = context.getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE).edit();
 
         // Check version and reset config if version changed
         checkAndResetConfigIfVersionChanged();
@@ -120,6 +144,31 @@ public class LiveUpdate {
         startRollbackTimer();
     }
 
+    @NonNull
+    public static LiveUpdate getInstance(
+        @NonNull Context context,
+        @NonNull Bridge bridge,
+        @NonNull LiveUpdateConfig config,
+        @Nullable LiveUpdateEventEmitter eventEmitter
+    ) throws PackageManager.NameNotFoundException {
+        if (instance == null) {
+            synchronized (LOCK) {
+                if (instance == null) {
+                    instance = new LiveUpdate(context, bridge, config, eventEmitter);
+                }
+            }
+        }
+        return instance;
+    }
+
+    @NonNull
+    public static LiveUpdate getInstance() {
+        if (instance == null) {
+            throw new IllegalStateException("LiveUpdate not initialized. Call getInstance with dependencies first.");
+        }
+        return instance;
+    }
+
     public void clearBlockedBundles() {
         preferences.setBlockedBundleIds(null);
     }
@@ -128,7 +177,7 @@ public class LiveUpdate {
         String bundleId = options.getBundleId();
 
         if (!hasBundleById(bundleId)) {
-            Exception exception = new Exception(LiveUpdatePlugin.ERROR_BUNDLE_NOT_FOUND);
+            Exception exception = CustomExceptions.BUNDLE_NOT_FOUND;
             callback.error(exception);
             return;
         }
@@ -284,9 +333,9 @@ public class LiveUpdate {
     }
 
     public void ready(@NonNull NonEmptyCallback callback) {
-        Logger.debug(LiveUpdatePlugin.TAG, "App is ready.");
+        Logger.debug(LiveUpdate.TAG, "App is ready.");
         if (config.getReadyTimeout() <= 0) {
-            Logger.warn(LiveUpdatePlugin.TAG, "Ready timeout is set to 0. Automatic rollback is disabled.");
+            Logger.warn(LiveUpdate.TAG, "Ready timeout is set to 0. Automatic rollback is disabled.");
         }
         // Stop the rollback timer
         stopRollbackTimer();
@@ -352,7 +401,7 @@ public class LiveUpdate {
             if (hasBundleById(bundleId)) {
                 setNextBundleById(bundleId);
             } else {
-                Exception exception = new Exception(LiveUpdatePlugin.ERROR_BUNDLE_NOT_FOUND);
+                Exception exception = CustomExceptions.BUNDLE_NOT_FOUND;
                 callback.error(exception);
                 return;
             }
@@ -362,7 +411,7 @@ public class LiveUpdate {
 
     public void sync(@NonNull SyncOptions options, @NonNull NonEmptyCallback<Result> callback) {
         if (syncInProgress) {
-            Exception exception = new Exception(LiveUpdatePlugin.ERROR_SYNC_IN_PROGRESS);
+            Exception exception = CustomExceptions.SYNC_IN_PROGRESS;
             callback.error(exception);
             return;
         }
@@ -378,7 +427,7 @@ public class LiveUpdate {
                 public void success(@Nullable GetLatestBundleResponse response) {
                     try {
                         if (response == null) {
-                            Logger.debug(LiveUpdatePlugin.TAG, "No update available.");
+                            Logger.debug(LiveUpdate.TAG, "No update available.");
                             syncInProgress = false;
                             SyncResult syncResult = new SyncResult(null);
                             callback.success(syncResult);
@@ -391,7 +440,7 @@ public class LiveUpdate {
                         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.");
+                            Logger.warn(LiveUpdate.TAG, "Bundle is blocked and will not be downloaded.");
                             syncInProgress = false;
                             SyncResult syncResult = new SyncResult(null);
                             callback.success(syncResult);
@@ -459,7 +508,7 @@ public class LiveUpdate {
         // Search folder with index.html file
         File indexHtmlFile = searchIndexHtmlFile(sourceDirectory);
         if (indexHtmlFile == null) {
-            throw new Exception(LiveUpdatePlugin.ERROR_BUNDLE_INDEX_HTML_MISSING);
+            throw CustomExceptions.BUNDLE_INDEX_HTML_MISSING;
         }
 
         // Create the bundles directory if it does not exist
@@ -482,21 +531,21 @@ public class LiveUpdate {
     }
 
     private File buildBundlesDirectory() {
-        return new File(plugin.getContext().getFilesDir(), bundlesDirectory);
+        return new File(context.getFilesDir(), bundlesDirectory);
     }
 
     private File buildBundleDirectoryFor(@NonNull String bundleId) {
-        return new File(plugin.getContext().getFilesDir(), bundlesDirectory + "/" + bundleId);
+        return new File(context.getFilesDir(), bundlesDirectory + "/" + bundleId);
     }
 
     private File buildTemporaryDirectory() {
         String fileName = UUID.randomUUID().toString();
-        return new File(plugin.getContext().getCacheDir(), fileName);
+        return new File(context.getCacheDir(), fileName);
     }
 
     private File buildTemporaryZipFile() {
         String fileName = UUID.randomUUID().toString() + ".zip";
-        return new File(plugin.getContext().getCacheDir(), fileName);
+        return new File(context.getCacheDir(), fileName);
     }
 
     private void copyCurrentBundleFile(@NonNull ManifestItem fileToCopy, @NonNull File destinationDirectory) throws IOException {
@@ -504,7 +553,7 @@ public class LiveUpdate {
         String currentBundleId = getCurrentBundleId();
         if (currentBundleId == null) {
             // Create the source input stream
-            AssetManager assets = plugin.getContext().getAssets();
+            AssetManager assets = context.getAssets();
             InputStream inputStream = assets.open(defaultWebAssetDir + "/" + href);
             // Create the destination file
             File destination = new File(destinationDirectory, href);
@@ -532,7 +581,7 @@ public class LiveUpdate {
         for (ManifestItem fileToCopy : filesToCopy) {
             boolean success = tryCopyCurrentBundleFile(fileToCopy, destinationDirectory);
             if (!success) {
-                Logger.warn(LiveUpdatePlugin.TAG, "Failed to copy file: " + fileToCopy.getHref());
+                Logger.warn(LiveUpdate.TAG, "Failed to copy file: " + fileToCopy.getHref());
                 // If the file could not be copied, add it to the list of missing items
                 missingItems.add(fileToCopy);
             }
@@ -578,8 +627,8 @@ public class LiveUpdate {
             KeyFactory keyFactory = KeyFactory.getInstance("RSA");
             return keyFactory.generatePublic(X509publicKey);
         } catch (Exception exception) {
-            Logger.error(LiveUpdatePlugin.TAG, exception.getMessage(), exception);
-            throw new Exception(LiveUpdatePlugin.ERROR_PUBLIC_KEY_INVALID);
+            Logger.error(LiveUpdate.TAG, exception.getMessage(), exception);
+            throw CustomExceptions.PUBLIC_KEY_INVALID;
         }
     }
 
@@ -645,8 +694,8 @@ public class LiveUpdate {
                             completionCallback.success();
                         } else {
                             String errorMessage = response.body().string();
-                            Exception exception = new Exception(LiveUpdatePlugin.ERROR_DOWNLOAD_FAILED);
-                            Logger.error(LiveUpdatePlugin.TAG, errorMessage, exception);
+                            Exception exception = CustomExceptions.DOWNLOAD_FAILED;
+                            Logger.error(LiveUpdate.TAG, errorMessage, exception);
                             completionCallback.error(exception);
                         }
                     } catch (Exception e) {
@@ -749,7 +798,7 @@ public class LiveUpdate {
                     public void error(@NonNull Exception e) {
                         // Capture first error and cancel all remaining downloads
                         if (firstError.compareAndSet(null, e)) {
-                            Logger.error(LiveUpdatePlugin.TAG, "Failed to download file: " + item.getHref(), e);
+                            Logger.error(LiveUpdate.TAG, "Failed to download file: " + item.getHref(), e);
                             // Cancel all in-flight downloads (fail-fast)
                             synchronized (activeCalls) {
                                 for (Call activeCall : activeCalls) {
@@ -924,10 +973,10 @@ public class LiveUpdate {
                 .addQueryParameter("deviceId", getDeviceId())
                 .addQueryParameter("osVersion", String.valueOf(Build.VERSION.SDK_INT))
                 .addQueryParameter("platform", "0")
-                .addQueryParameter("pluginVersion", LiveUpdatePlugin.VERSION)
+                .addQueryParameter("pluginVersion", LiveUpdate.VERSION)
                 .build()
                 .toString();
-            Logger.debug(LiveUpdatePlugin.TAG, "Fetching latest bundle: " + url);
+            Logger.debug(LiveUpdate.TAG, "Fetching latest bundle: " + url);
 
             httpClient.enqueue(
                 url,
@@ -936,7 +985,7 @@ public class LiveUpdate {
                     public void success(@NonNull Response response) {
                         try {
                             String responseBodyString = response.body().string();
-                            Logger.debug(LiveUpdatePlugin.TAG, "Latest bundle response: " + responseBodyString);
+                            Logger.debug(LiveUpdate.TAG, "Latest bundle response: " + responseBodyString);
                             if (response.isSuccessful()) {
                                 JSONObject responseJson = new JSONObject(responseBodyString);
                                 GetLatestBundleResponse result = new GetLatestBundleResponse(responseJson);
@@ -986,8 +1035,8 @@ public class LiveUpdate {
             source.close();
             return digest.digest();
         } catch (IOException exception) {
-            Logger.error(LiveUpdatePlugin.TAG, exception.getMessage(), exception);
-            throw new Exception(LiveUpdatePlugin.ERROR_CHECKSUM_CALCULATION_FAILED);
+            Logger.error(LiveUpdate.TAG, exception.getMessage(), exception);
+            throw CustomExceptions.CHECKSUM_CALCULATION_FAILED;
         }
     }
 
@@ -1037,7 +1086,7 @@ public class LiveUpdate {
      * @return The absolute path to the current bundle directory (`public` for the built-in bundle).
      */
     private String getCurrentCapacitorServerPath() {
-        return plugin.getBridge().getServerBasePath();
+        return bridge.getServerBasePath();
     }
 
     @NonNull
@@ -1067,8 +1116,7 @@ public class LiveUpdate {
      */
     @NonNull
     private String getNextCapacitorServerPath() {
-        String path = plugin
-            .getContext()
+        String path = context
             .getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE)
             .getString(WebView.CAP_SERVER_PATH, defaultWebAssetDir);
         // Empty path means default path
@@ -1113,7 +1161,7 @@ public class LiveUpdate {
     private Manifest loadCurrentManifest() throws Exception {
         String currentBundleId = getCurrentBundleId();
         if (currentBundleId == null) {
-            AssetManager assets = plugin.getContext().getAssets();
+            AssetManager assets = context.getAssets();
             boolean manifestFileExists = Arrays.asList(assets.list(defaultWebAssetDir)).contains(manifestFileName);
             if (manifestFileExists) {
                 InputStream inputStream = assets.open(defaultWebAssetDir + "/" + manifestFileName);
@@ -1145,14 +1193,17 @@ public class LiveUpdate {
     }
 
     private void notifyDownloadBundleProgressListeners(@NonNull final DownloadBundleProgressEvent event) {
-        plugin.notifyDownloadBundleProgressListeners(event);
+        if (eventEmitter == null) {
+            return;
+        }
+        eventEmitter.onDownloadBundleProgress(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.");
+            Logger.debug(LiveUpdate.TAG, "Auto-update skipped. Last check was less than 15 minutes ago.");
             return;
         }
 
@@ -1160,17 +1211,17 @@ public class LiveUpdate {
         lastAutoUpdateCheckTimestamp = now;
 
         // Run sync
-        Logger.debug(LiveUpdatePlugin.TAG, "Auto-update started.");
+        Logger.debug(LiveUpdate.TAG, "Auto-update started.");
         SyncOptions options = new SyncOptions((String) null);
         NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
             @Override
             public void success(@NonNull Result result) {
-                Logger.debug(LiveUpdatePlugin.TAG, "Auto-update completed successfully.");
+                Logger.debug(LiveUpdate.TAG, "Auto-update completed successfully.");
             }
 
             @Override
             public void error(@NonNull Exception exception) {
-                Logger.error(LiveUpdatePlugin.TAG, "Auto-update failed: " + exception.getMessage(), exception);
+                Logger.error(LiveUpdate.TAG, "Auto-update failed: " + exception.getMessage(), exception);
             }
         };
         sync(options, callback);
@@ -1184,9 +1235,9 @@ public class LiveUpdate {
         setPreviousBundleId(currentBundleId);
         // Log the rollback result
         if (currentBundleId == null) {
-            Logger.debug(LiveUpdatePlugin.TAG, "App is not ready. Default bundle is already in use.");
+            Logger.debug(LiveUpdate.TAG, "App is not ready. Default bundle is already in use.");
         } else {
-            Logger.debug(LiveUpdatePlugin.TAG, "App is not ready. Rolling back to default bundle.");
+            Logger.debug(LiveUpdate.TAG, "App is not ready. Rolling back to default bundle.");
             // Rollback to the default bundle
             setNextBundleById(null);
             setCurrentBundleById(null);
@@ -1232,11 +1283,11 @@ public class LiveUpdate {
 
     private void setCurrentCapacitorServerPath(@NonNull String path) {
         if (path.equals(defaultWebAssetDir)) {
-            this.plugin.getBridge().setServerAssetPath(path);
+            this.bridge.setServerAssetPath(path);
         } else {
-            this.plugin.getBridge().setServerBasePath(path);
+            this.bridge.setServerBasePath(path);
         }
-        this.plugin.getBridge().reload();
+        this.bridge.reload();
         // Notify listeners
         notifyReloadedListeners();
     }
@@ -1257,12 +1308,18 @@ public class LiveUpdate {
     }
 
     private void notifyNextBundleSetListeners(@Nullable String bundleId) {
+        if (eventEmitter == null) {
+            return;
+        }
         NextBundleSetEvent event = new NextBundleSetEvent(bundleId);
-        plugin.notifyNextBundleSetListeners(event);
+        eventEmitter.onNextBundleSet(event);
     }
 
     private void notifyReloadedListeners() {
-        plugin.notifyReloadedListeners();
+        if (eventEmitter == null) {
+            return;
+        }
+        eventEmitter.onReloaded();
     }
 
     private void addBlockedBundleId(@NonNull String bundleId) {
@@ -1292,7 +1349,7 @@ public class LiveUpdate {
         String newBlockedIds = String.join(",", blockedList);
         preferences.setBlockedBundleIds(newBlockedIds);
 
-        Logger.debug(LiveUpdatePlugin.TAG, "Bundle blocked: " + bundleId);
+        Logger.debug(LiveUpdate.TAG, "Bundle blocked: " + bundleId);
     }
 
     private boolean isBlockedBundleId(@NonNull String bundleId) {
@@ -1316,7 +1373,7 @@ public class LiveUpdate {
 
         if (lastVersionCode == -1 || lastVersionCode != currentVersionCode) {
             Logger.debug(
-                LiveUpdatePlugin.TAG,
+                LiveUpdate.TAG,
                 "App version changed (last: " + lastVersionCode + ", current: " + currentVersionCode + "), resetting config."
             );
             resetConfig();
@@ -1366,12 +1423,12 @@ public class LiveUpdate {
         if (publicKey != null) {
             // Verify the signature
             if (signature == null) {
-                throw new Exception(LiveUpdatePlugin.ERROR_SIGNATURE_MISSING);
+                throw CustomExceptions.SIGNATURE_MISSING;
             }
             // Verify the signature
             boolean verified = verifySignatureForFile(file, signature, publicKey);
             if (!verified) {
-                throw new Exception(LiveUpdatePlugin.ERROR_SIGNATURE_VERIFICATION_FAILED);
+                throw CustomExceptions.SIGNATURE_VERIFICATION_FAILED;
             }
         }
         // Verify the checksum
@@ -1379,7 +1436,7 @@ public class LiveUpdate {
             // Calculate the checksum
             boolean verified = verifyChecksumForFile(file, checksum);
             if (!verified) {
-                throw new Exception(LiveUpdatePlugin.ERROR_CHECKSUM_MISMATCH);
+                throw CustomExceptions.CHECKSUM_MISMATCH;
             }
         }
     }
@@ -1402,17 +1459,17 @@ public class LiveUpdate {
             source.close();
             return sig.verify(signatureBytes);
         } catch (Exception exception) {
-            Logger.error(LiveUpdatePlugin.TAG, exception.getMessage(), exception);
-            throw new Exception(LiveUpdatePlugin.ERROR_SIGNATURE_VERIFICATION_FAILED);
+            Logger.error(LiveUpdate.TAG, exception.getMessage(), exception);
+            throw CustomExceptions.SIGNATURE_VERIFICATION_FAILED;
         }
     }
 
     private PackageInfo getPackageInfo() throws PackageManager.NameNotFoundException {
-        String packageName = this.plugin.getContext().getPackageName();
+        String packageName = this.context.getPackageName();
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-            return this.plugin.getContext().getPackageManager().getPackageInfo(packageName, PackageManager.PackageInfoFlags.of(0));
+            return this.context.getPackageManager().getPackageInfo(packageName, PackageManager.PackageInfoFlags.of(0));
         } else {
-            return this.plugin.getContext().getPackageManager().getPackageInfo(packageName, 0);
+            return this.context.getPackageManager().getPackageInfo(packageName, 0);
         }
     }
 }

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

@@ -28,15 +28,15 @@ import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.GetDownloade
 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.LiveUpdateEventEmitter;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.NonEmptyCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
 
 @CapacitorPlugin(name = "LiveUpdate")
 public class LiveUpdatePlugin extends Plugin {
 
-    public static final String TAG = "LiveUpdate";
-    public static final String VERSION = "7.4.0";
-    public static final String SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdate"; // DO NOT CHANGE
+    public static final String TAG = LiveUpdate.TAG;
+    public static final String VERSION = LiveUpdate.VERSION;
     public static final String ERROR_APP_ID_MISSING = "appId must be configured.";
     public static final String ERROR_BUNDLE_EXISTS = "bundle already exists.";
     public static final String ERROR_BUNDLE_ID_MISSING = "bundleId must be provided.";
@@ -68,7 +68,8 @@ public class LiveUpdatePlugin extends Plugin {
     public void load() {
         try {
             config = getLiveUpdateConfig();
-            implementation = new LiveUpdate(config, this);
+            LiveUpdateEventEmitter eventEmitter = new PluginLiveUpdateEventEmitter();
+            implementation = LiveUpdate.getInstance(getContext(), getBridge(), config, eventEmitter);
         } catch (Exception exception) {
             Logger.error(TAG, exception.getMessage(), exception);
         }
@@ -684,4 +685,22 @@ public class LiveUpdatePlugin extends Plugin {
         Logger.error(TAG, message, exception);
         call.reject(message);
     }
+
+    private class PluginLiveUpdateEventEmitter implements LiveUpdateEventEmitter {
+
+        @Override
+        public void onDownloadBundleProgress(@NonNull DownloadBundleProgressEvent event) {
+            notifyDownloadBundleProgressListeners(event);
+        }
+
+        @Override
+        public void onNextBundleSet(@NonNull NextBundleSetEvent event) {
+            notifyNextBundleSetListeners(event);
+        }
+
+        @Override
+        public void onReloaded() {
+            notifyReloadedListeners();
+        }
+    }
 }

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

@@ -9,6 +9,8 @@ import java.util.UUID;
 
 public class LiveUpdatePreferences {
 
+    private static final String SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdate"; // DO NOT CHANGE
+
     @NonNull
     private final Context context;
 
@@ -25,53 +27,45 @@ public class LiveUpdatePreferences {
 
     public LiveUpdatePreferences(@NonNull Context context) {
         this.context = context;
-        this.settingsEditor = context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).edit();
+        this.settingsEditor = context.getSharedPreferences(SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).edit();
     }
 
     @Nullable
     public String getAppId() {
-        return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(appIdKey, null);
+        return context.getSharedPreferences(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);
+        return context.getSharedPreferences(SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(channelKey, null);
     }
 
     @Nullable
     public String getCustomId() {
-        return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(customIdKey, null);
+        return context.getSharedPreferences(SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(customIdKey, null);
     }
 
     @Nullable
     public String getDeviceIdForApp(@Nullable String appId) {
         if (appId == null) {
-            return context
-                .getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE)
-                .getString(deviceIdKey, null);
+            return context.getSharedPreferences(SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(deviceIdKey, null);
         } else {
-            return context
-                .getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE)
-                .getString(deviceIdKey + "_" + appId, null);
+            return context.getSharedPreferences(SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(deviceIdKey + "_" + appId, null);
         }
     }
 
     public int getLastVersionCode() {
-        return context.getSharedPreferences(LiveUpdatePlugin.SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getInt(lastVersionCodeKey, -1);
+        return context.getSharedPreferences(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);
+        return context.getSharedPreferences(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);
+        return context.getSharedPreferences(SHARED_PREFERENCES_NAME, Activity.MODE_PRIVATE).getString(blockedBundleIdsKey, null);
     }
 
     public void setAppId(@Nullable String appId) {

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

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+public class CustomException extends Exception {
+
+    @Nullable
+    private final String code;
+
+    public CustomException(@Nullable String code, @NonNull String message) {
+        super(message);
+        this.code = code;
+    }
+
+    @Nullable
+    public String getCode() {
+        return code;
+    }
+}

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

@@ -0,0 +1,33 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.classes;
+
+public class CustomExceptions {
+
+    public static final CustomException APP_ID_MISSING = new CustomException("APP_ID_MISSING", "appId must be configured.");
+    public static final CustomException BUNDLE_EXISTS = new CustomException("BUNDLE_EXISTS", "bundle already exists.");
+    public static final CustomException BUNDLE_ID_MISSING = new CustomException(null, "bundleId must be provided.");
+    public static final CustomException BUNDLE_INDEX_HTML_MISSING = new CustomException(
+        "BUNDLE_INDEX_HTML_MISSING",
+        "The bundle does not contain an index.html file."
+    );
+    public static final CustomException BUNDLE_NOT_FOUND = new CustomException("BUNDLE_NOT_FOUND", "bundle not found.");
+    public static final CustomException CHECKSUM_CALCULATION_FAILED = new CustomException(
+        "CHECKSUM_CALCULATION_FAILED",
+        "Failed to calculate checksum."
+    );
+    public static final CustomException CHECKSUM_MISMATCH = new CustomException("CHECKSUM_MISMATCH", "Checksum mismatch.");
+    public static final CustomException CUSTOM_ID_MISSING = new CustomException(null, "customId must be provided.");
+    public static final CustomException DOWNLOAD_FAILED = new CustomException("DOWNLOAD_FAILED", "Bundle could not be downloaded.");
+    public static final CustomException HTTP_TIMEOUT = new CustomException("HTTP_TIMEOUT", "Request timed out.");
+    public static final CustomException URL_MISSING = new CustomException(null, "url must be provided.");
+    public static final CustomException SIGNATURE_VERIFICATION_FAILED = new CustomException(
+        "SIGNATURE_VERIFICATION_FAILED",
+        "Signature verification failed."
+    );
+    public static final CustomException PUBLIC_KEY_INVALID = new CustomException("PUBLIC_KEY_INVALID", "Invalid public key.");
+    public static final CustomException SIGNATURE_MISSING = new CustomException(
+        "SIGNATURE_MISSING",
+        "Bundle does not contain a signature."
+    );
+    public static final CustomException SYNC_IN_PROGRESS = new CustomException("SYNC_IN_PROGRESS", "Sync is already in progress.");
+    public static final CustomException UNKNOWN_ERROR = new CustomException("UNKNOWN_ERROR", "An unknown error has occurred.");
+}

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

@@ -0,0 +1,13 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.interfaces;
+
+import androidx.annotation.NonNull;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.events.DownloadBundleProgressEvent;
+import io.capawesome.capacitorjs.plugins.liveupdate.classes.events.NextBundleSetEvent;
+
+public interface LiveUpdateEventEmitter {
+    void onDownloadBundleProgress(@NonNull DownloadBundleProgressEvent event);
+
+    void onNextBundleSet(@NonNull NextBundleSetEvent event);
+
+    void onReloaded();
+}

package/ios/Plugin/LiveUpdate.swift

@@ -1,26 +1,29 @@
 import Foundation
 import CryptoKit
-#if canImport(ZipArchive)
-import ZipArchive
-#else
-import SSZipArchive
-#endif
+import ZIPFoundation
 import Capacitor
 import Alamofire
 import CommonCrypto
 
 // swiftlint:disable type_body_length
 @objc public class LiveUpdate: NSObject {
+    public static let tag = "LiveUpdate"
+    public static let version = "8.1.1"
+
+    private static var _sharedInstance: LiveUpdate?
+    private static let queue = DispatchQueue(label: "io.capawesome.liveupdate.singleton")
+
     private let autoUpdateIntervalMs: Int64 = 15 * 60 * 1000 // 15 minutes
+    private let bridge: LiveUpdateBridge
     private let bundlesDirectory = "NoCloud/ionic_built_snapshots" // DO NOT CHANGE! (See https://dub.sh/BLluidt)
     private let cachesDirectoryUrl = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask).first!
     private let config: LiveUpdateConfig
     private let defaultWebAssetDir = "public" // DO NOT CHANGE! (See https://dub.sh/Buvz4yj)
     private let defaultServerPathKey = "serverBasePath" // DO NOT CHANGE! (See https://dub.sh/ceDl0zT)
+    private let eventEmitter: LiveUpdateEventEmitter?
     private let httpClient: LiveUpdateHttpClient
     private let libraryDirectoryUrl = FileManager.default.urls(for: .libraryDirectory, in: .userDomainMask).first!
     private let manifestFileName = "capawesome-live-update-manifest.json" // DO NOT CHANGE!
-    private let plugin: LiveUpdatePlugin
     private let preferences: LiveUpdatePreferences
 
     private var rollbackDispatchWorkItem: DispatchWorkItem?
@@ -28,10 +31,11 @@ import CommonCrypto
     private var lastAutoUpdateCheckTimestamp: Int64 = 0
     private var syncInProgress = false
 
-    init(config: LiveUpdateConfig, plugin: LiveUpdatePlugin) {
+    private init(bridge: LiveUpdateBridge, config: LiveUpdateConfig, eventEmitter: LiveUpdateEventEmitter?) {
+        self.bridge = bridge
         self.config = config
+        self.eventEmitter = eventEmitter
         self.httpClient = LiveUpdateHttpClient(config: config)
-        self.plugin = plugin
         self.preferences = LiveUpdatePreferences()
         super.init()
 
@@ -43,6 +47,28 @@ import CommonCrypto
         startRollbackTimer()
     }
 
+    public static func getInstance(
+        bridge: LiveUpdateBridge,
+        config: LiveUpdateConfig,
+        eventEmitter: LiveUpdateEventEmitter?
+    ) -> LiveUpdate {
+        return queue.sync {
+            if _sharedInstance == nil {
+                _sharedInstance = LiveUpdate(bridge: bridge, config: config, eventEmitter: eventEmitter)
+            }
+            return _sharedInstance!
+        }
+    }
+
+    public static func getInstance() -> LiveUpdate {
+        return queue.sync {
+            guard let instance = _sharedInstance else {
+                fatalError("LiveUpdate not initialized. Call getInstance(bridge:config:eventEmitter:) first.")
+            }
+            return instance
+        }
+    }
+
     @objc public func clearBlockedBundles() {
         preferences.setBlockedBundleIds(nil)
     }
@@ -178,9 +204,9 @@ import CommonCrypto
     }
 
     @objc public func ready(completion: @escaping (Result?, Error?) -> Void) {
-        CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "App is ready.")
+        CAPLog.print("[", LiveUpdate.tag, "] ", "App is ready.")
         if config.readyTimeout <= 0 {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Ready timeout is set to 0. Automatic rollback is disabled.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Ready timeout is set to 0. Automatic rollback is disabled.")
         }
         // Stop the rollback timer
         stopRollbackTimer()
@@ -268,7 +294,7 @@ import CommonCrypto
         // Fetch the latest bundle
         let fetchLatestBundleOptions = FetchLatestBundleOptions(channel: channel)
         guard let response = try await fetchLatestBundle(fetchLatestBundleOptions) else {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "No update available.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "No update available.")
             return SyncResult(nextBundleId: nil)
         }
         let artifactType = response.artifactType
@@ -278,7 +304,7 @@ import CommonCrypto
         let downloadUrl = response.url
         // Check if the bundle is blocked
         if isBlockedBundleId(latestBundleId) {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Bundle is blocked and will not be downloaded.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Bundle is blocked and will not be downloaded.")
             return SyncResult(nextBundleId: nil)
         }
         // Check if bundle already exists
@@ -323,7 +349,7 @@ import CommonCrypto
 
     private func addBundleOfTypeZip(bundleId: String, zipFile: URL) async throws {
         // Unzip the bundle
-        let unzippedDirectory = self.unzipFile(zipFile: zipFile)
+        let unzippedDirectory = try self.unzipFile(zipFile: zipFile)
         // Add the bundle
         try self.addBundle(bundleId: bundleId, directory: unzippedDirectory)
     }
@@ -376,7 +402,7 @@ import CommonCrypto
         for fileToCopy in filesToCopy {
             let success = tryCopyCurrentBundleFile(fileToCopy: fileToCopy, toDirectory: toDirectory)
             if !success {
-                CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to copy file: \(fileToCopy.href)")
+                CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to copy file: \(fileToCopy.href)")
                 // If the file could not be copied, add it to the list of missing items
                 missingItems.append(fileToCopy)
             }
@@ -391,7 +417,7 @@ import CommonCrypto
             do {
                 try FileManager.default.createDirectory(at: bundlesDirectoryUrl, withIntermediateDirectories: true, attributes: nil)
             } catch {
-                CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to create bundles directory.")
+                CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to create bundles directory.")
             }
         }
     }
@@ -423,7 +449,7 @@ import CommonCrypto
                 do {
                     try deleteBundleById(bundleId)
                 } catch {
-                    CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to delete bundle with id: \(bundleId)")
+                    CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to delete bundle with id: \(bundleId)")
                 }
             }
         }
@@ -436,7 +462,7 @@ import CommonCrypto
         let urlComponents = URLComponents(string: url)!
         let result = try await httpClient.download(url: urlComponents.asURL(), destination: destination, callback: callback)
         if let error = result.error {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to download file: \(error)")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to download file: \(error)")
             if let urlError = error.underlyingError as? URLError {
                 if urlError.code == .timedOut {
                     throw urlError
@@ -558,14 +584,14 @@ import CommonCrypto
         parameters["deviceId"] = getDeviceId()
         parameters["osVersion"] = await UIDevice.current.systemVersion
         parameters["platform"] = "1"
-        parameters["pluginVersion"] = LiveUpdatePlugin.version
+        parameters["pluginVersion"] = LiveUpdate.version
         var urlComponents = URLComponents(string: "https://\(config.serverDomain)/v1/apps/\(getAppId() ?? "")/bundles/latest")!
         urlComponents.queryItems = parameters.map { URLQueryItem(name: $0.key, value: $0.value) }
         let url = try urlComponents.asURL()
-        CAPLog.print("[", LiveUpdatePlugin.tag, "] Fetching latest bundle: ", url)
+        CAPLog.print("[", LiveUpdate.tag, "] Fetching latest bundle: ", url)
         let response = try await self.httpClient.request(url: url, type: GetLatestBundleResponse.self)
         if let data = response.data {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] Latest bundle response: ", String(decoding: data, as: UTF8.self))
+            CAPLog.print("[", LiveUpdate.tag, "] Latest bundle response: ", String(decoding: data, as: UTF8.self))
         }
         if let error = response.error {
             if let urlError = error.underlyingError as? URLError {
@@ -640,12 +666,9 @@ import CommonCrypto
         return bundleId
     }
 
-    /// - Returns: The path to the current bundle directory or `nil` if no view controller was found.
+    /// - Returns: The path to the current bundle directory or `nil` if the bridge does not provide a path.
     private func getCurrentCapacitorServerPath() -> String? {
-        guard let viewController = self.plugin.bridge?.viewController as? CAPBridgeViewController else {
-            return nil
-        }
-        return viewController.getServerBasePath()
+        return bridge.getServerBasePath()
     }
 
     private func getDeviceId() -> String {
@@ -724,14 +747,16 @@ import CommonCrypto
     }
 
     private func notifyDownloadBundleProgressListeners(_ event: DownloadBundleProgressEvent) {
-        plugin.notifyDownloadBundleProgressListeners(event)
+        if let eventEmitter = eventEmitter {
+            eventEmitter.onDownloadBundleProgress(event)
+        }
     }
 
     private func performAutoUpdate() {
         // Check if enough time has passed since the last check
         let now = Int64(Date().timeIntervalSince1970 * 1000)
         if lastAutoUpdateCheckTimestamp > 0 && (now - lastAutoUpdateCheckTimestamp) < autoUpdateIntervalMs {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Auto-update skipped. Last check was less than 15 minutes ago.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Auto-update skipped. Last check was less than 15 minutes ago.")
             return
         }
 
@@ -741,12 +766,12 @@ import CommonCrypto
         // Run sync in background task
         Task {
             do {
-                CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Auto-update started.")
+                CAPLog.print("[", LiveUpdate.tag, "] ", "Auto-update started.")
                 let options = SyncOptions(channel: nil)
                 _ = try await sync(options)
-                CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Auto-update completed successfully.")
+                CAPLog.print("[", LiveUpdate.tag, "] ", "Auto-update completed successfully.")
             } catch {
-                CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Auto-update failed: ", error.localizedDescription)
+                CAPLog.print("[", LiveUpdate.tag, "] ", "Auto-update failed: ", error.localizedDescription)
             }
         }
     }
@@ -759,11 +784,11 @@ import CommonCrypto
         setPreviousBundleId(bundleId: currentBundleId)
         // Perform the rollback
         if let _ = currentBundleId {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "App is not ready. Rolling back to default bundle.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "App is not ready. Rolling back to default bundle.")
             setNextBundleById(nil)
             setCurrentBundleById(nil)
         } else {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "App is not ready. Default bundle is already in use.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "App is not ready. Default bundle is already in use.")
         }
     }
 
@@ -789,7 +814,7 @@ import CommonCrypto
                 }
             }
         } catch {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to search index.html file: \(error.localizedDescription)")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to search index.html file: \(error.localizedDescription)")
         }
         return nil
     }
@@ -801,10 +826,7 @@ import CommonCrypto
     }
 
     private func setCurrentCapacitorServerPath(path: String) {
-        guard let viewController = self.plugin.bridge?.viewController as? CAPBridgeViewController else {
-            return
-        }
-        viewController.setServerBasePath(path: path)
+        bridge.setServerBasePath(path: path)
         // Notify listeners
         notifyReloadedListeners()
     }
@@ -819,12 +841,16 @@ import CommonCrypto
     }
 
     private func notifyNextBundleSetListeners(_ bundleId: String?) {
-        let event = NextBundleSetEvent(bundleId: bundleId)
-        plugin.notifyNextBundleSetListeners(event)
+        if let eventEmitter = eventEmitter {
+            let event = NextBundleSetEvent(bundleId: bundleId)
+            eventEmitter.onNextBundleSet(event)
+        }
     }
 
     private func notifyReloadedListeners() {
-        plugin.notifyReloadedListeners()
+        if let eventEmitter = eventEmitter {
+            eventEmitter.onReloaded()
+        }
     }
 
     private func addBlockedBundleId(_ bundleId: String) {
@@ -852,7 +878,7 @@ import CommonCrypto
         let newBlockedIds = blockedList.joined(separator: ",")
         preferences.setBlockedBundleIds(newBlockedIds)
 
-        CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Bundle blocked: ", bundleId)
+        CAPLog.print("[", LiveUpdate.tag, "] ", "Bundle blocked: ", bundleId)
     }
 
     private func isBlockedBundleId(_ bundleId: String) -> Bool {
@@ -882,7 +908,7 @@ import CommonCrypto
 
         if lastVersionCode == nil || lastVersionName == nil || lastVersionCode != currentVersionCode || lastVersionName != currentVersionName {
             CAPLog.print(
-                "[", LiveUpdatePlugin.tag, "] ",
+                "[", LiveUpdate.tag, "] ",
                 "App version changed (last: \(lastVersionName ?? "nil")/\(lastVersionCode ?? "nil"), current: \(currentVersionName)/\(currentVersionCode)), resetting config."
             )
             resetConfig()
@@ -923,9 +949,10 @@ import CommonCrypto
         }
     }
 
-    private func unzipFile(zipFile: URL) -> URL {
+    private func unzipFile(zipFile: URL) throws -> URL {
         let destinationDirectory = zipFile.deletingPathExtension()
-        SSZipArchive.unzipFile(atPath: zipFile.path, toDestination: destinationDirectory.path)
+        try FileManager.default.createDirectory(at: destinationDirectory, withIntermediateDirectories: true, attributes: nil)
+        try FileManager.default.unzipItem(at: zipFile, to: destinationDirectory)
         return destinationDirectory
     }
 
@@ -967,7 +994,7 @@ import CommonCrypto
             .replacingOccurrences(of: "-----END PUBLIC KEY-----", with: "")
             .replacingOccurrences(of: "\n", with: "")
         guard let publicKeyData = Data(base64Encoded: publicKeyAsBase64) else {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to decode public key.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to decode public key.")
             return false
         }
         let publicKeyAttributes: [CFString: Any] = [
@@ -979,12 +1006,12 @@ import CommonCrypto
         var secKeyCreateWithDataError: Unmanaged<CFError>?
         guard let publicKey = SecKeyCreateWithData(publicKeyData as CFData, publicKeyAttributes as CFDictionary, &secKeyCreateWithDataError) else {
             if let error = secKeyCreateWithDataError?.takeRetainedValue() {
-                CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to create public key with error: \(error)")
+                CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to create public key with error: \(error)")
             }
             return false
         }
         guard let signatureData = Data(base64Encoded: signature) else {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to decode signature.")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to decode signature.")
             return false
         }
 
@@ -1014,7 +1041,7 @@ import CommonCrypto
         let signatureAlgorithm = SecKeyAlgorithm.rsaSignatureDigestPKCS1v15SHA256
         let verificationResult = SecKeyVerifySignature(publicKey, signatureAlgorithm, digest as CFData, signatureData as CFData, &secKeyVerifySignatureError)
         if let error = secKeyVerifySignatureError?.takeRetainedValue() {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to verify signature with error: \(error)")
+            CAPLog.print("[", LiveUpdate.tag, "] ", "Failed to verify signature with error: \(error)")
         }
         return verificationResult
     }

package/ios/Plugin/LiveUpdateConfig.swift

@@ -8,4 +8,6 @@ public struct LiveUpdateConfig {
     var publicKey: String?
     var readyTimeout = 0
     var serverDomain = "api.cloud.capawesome.io"
+
+    public init() {}
 }

package/ios/Plugin/LiveUpdatePlugin.swift

@@ -7,9 +7,8 @@ import Capacitor
  */
 @objc(LiveUpdatePlugin)
 public class LiveUpdatePlugin: CAPPlugin, CAPBridgedPlugin {
-    public static let tag = "LiveUpdate"
-    public static let version = "7.4.0"
-    public static let userDefaultsPrefix = "CapawesomeLiveUpdate" // DO NOT CHANGE
+    public static let tag = LiveUpdate.tag
+    public static let version = LiveUpdate.version
 
     public let identifier = "LiveUpdatePlugin"
     public let jsName = "LiveUpdate"
@@ -49,8 +48,14 @@ public class LiveUpdatePlugin: CAPPlugin, CAPBridgedPlugin {
     private var implementation: LiveUpdate?
 
     override public func load() {
-        self.config = liveUpdateConfig()
-        self.implementation = LiveUpdate(config: config!, plugin: self)
+        guard let bridge = bridge else {
+            return
+        }
+        let config = liveUpdateConfig()
+        self.config = config
+        let bridgeWrapper = PluginLiveUpdateBridge(bridge: bridge)
+        let eventEmitter = PluginLiveUpdateEventEmitter(plugin: self)
+        self.implementation = LiveUpdate.getInstance(bridge: bridgeWrapper, config: config, eventEmitter: eventEmitter)
 
         // Notify implementation about load
         implementation?.handleLoad()
@@ -422,4 +427,46 @@ public class LiveUpdatePlugin: CAPPlugin, CAPBridgedPlugin {
     private func resolveCall(_ call: CAPPluginCall, _ result: JSObject) {
         call.resolve(result)
     }
+
+    private class PluginLiveUpdateBridge: NSObject, LiveUpdateBridge {
+        private weak var bridge: CAPBridgeProtocol?
+
+        init(bridge: CAPBridgeProtocol) {
+            self.bridge = bridge
+        }
+
+        func getServerBasePath() -> String? {
+            guard let viewController = bridge?.viewController as? CAPBridgeViewController else {
+                return nil
+            }
+            return viewController.getServerBasePath()
+        }
+
+        func setServerBasePath(path: String) {
+            guard let viewController = bridge?.viewController as? CAPBridgeViewController else {
+                return
+            }
+            viewController.setServerBasePath(path: path)
+        }
+    }
+
+    private class PluginLiveUpdateEventEmitter: NSObject, LiveUpdateEventEmitter {
+        weak var plugin: LiveUpdatePlugin?
+
+        init(plugin: LiveUpdatePlugin) {
+            self.plugin = plugin
+        }
+
+        func onDownloadBundleProgress(_ event: DownloadBundleProgressEvent) {
+            plugin?.notifyDownloadBundleProgressListeners(event)
+        }
+
+        func onNextBundleSet(_ event: NextBundleSetEvent) {
+            plugin?.notifyNextBundleSetListeners(event)
+        }
+
+        func onReloaded() {
+            plugin?.notifyReloadedListeners()
+        }
+    }
 }

package/ios/Plugin/LiveUpdatePreferences.swift

@@ -1,6 +1,8 @@
 import Foundation
 
 public class LiveUpdatePreferences: NSObject {
+    private static let userDefaultsPrefix = "CapawesomeLiveUpdate" // DO NOT CHANGE
+
     private let appIdKey = "appId" // DO NOT CHANGE
     private let blockedBundleIdsKey = "blockedBundleIds" // DO NOT CHANGE
     private let channelKey = "channel" // DO NOT CHANGE
@@ -97,6 +99,6 @@ public class LiveUpdatePreferences: NSObject {
     }
 
     private func applyPrefix(to key: String) -> String {
-        return LiveUpdatePlugin.userDefaultsPrefix + "." + key
+        return LiveUpdatePreferences.userDefaultsPrefix + "." + key
     }
 }

package/ios/Plugin/Protocols/LiveUpdateBridge.swift

@@ -0,0 +1,6 @@
+import Foundation
+
+@objc public protocol LiveUpdateBridge {
+    func getServerBasePath() -> String?
+    func setServerBasePath(path: String)
+}

package/ios/Plugin/Protocols/LiveUpdateEventEmitter.swift

@@ -0,0 +1,8 @@
+import Foundation
+import Capacitor
+
+@objc public protocol LiveUpdateEventEmitter {
+    func onDownloadBundleProgress(_ event: DownloadBundleProgressEvent)
+    func onNextBundleSet(_ event: NextBundleSetEvent)
+    func onReloaded()
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-live-update",
-  "version": "8.0.0",
+  "version": "8.1.0-dev.97c86c2c.1768835749",
   "description": "Capacitor plugin to update your app remotely in real-time.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",