@capawesome/capacitor-live-update 8.3.0-dev.f9cc1d15.1783929784 → 8.4.0

package/CapawesomeCapacitorLiveUpdate.podspec

@@ -17,19 +17,4 @@ Pod::Spec.new do |s|
   s.dependency 'ZIPFoundation', '~> 0.9.0'
   s.swift_version = '5.1'
   s.static_framework = true
-  s.default_subspec = 'Default'
-
-  s.subspec 'Default' do |ss|
-    # Default subspec
-  end
-
-  # Opt-in subspec that pulls in the Ionic Live Update Provider SDK and
-  # compiles in the provider/manager classes guarded by
-  # `#if CAPAWESOME_INCLUDE_IONIC_PROVIDER`.
-  s.subspec 'IonicProvider' do |ss|
-    ss.dependency 'LiveUpdateProvider', '~> 1.0.0'
-    ss.pod_target_xcconfig = {
-      'OTHER_SWIFT_FLAGS' => '$(inherited) -DCAPAWESOME_INCLUDE_IONIC_PROVIDER'
-    }
-  end
 end

package/Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version: 6.1
+// swift-tools-version: 5.9
 import PackageDescription
 
 let package = Package(
@@ -9,17 +9,10 @@ let package = Package(
             name: "CapawesomeCapacitorLiveUpdate",
             targets: ["LiveUpdatePlugin"])
     ],
-    traits: [
-        .trait(
-            name: "IonicProvider",
-            description: "Enables the Ionic Live Update Provider SDK integration."
-        )
-    ],
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0"),
         .package(url: "https://github.com/Alamofire/Alamofire.git", .upToNextMajor(from: "5.10.2")),
-        .package(url: "https://github.com/weichsel/ZIPFoundation.git", .upToNextMinor(from: "0.9.0")),
-        .package(url: "https://github.com/ionic-team/live-update-provider-sdk.git", from: "1.0.0")
+        .package(url: "https://github.com/weichsel/ZIPFoundation.git", .upToNextMinor(from: "0.9.0"))
     ],
     targets: [
         .target(
@@ -28,21 +21,12 @@ let package = Package(
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
                 .product(name: "Cordova", package: "capacitor-swift-pm"),
                 .product(name: "Alamofire", package: "Alamofire"),
-                .product(name: "ZIPFoundation", package: "ZIPFoundation"),
-                .product(
-                    name: "LiveUpdateProvider",
-                    package: "live-update-provider-sdk",
-                    condition: .when(traits: ["IonicProvider"])
-                )
+                .product(name: "ZIPFoundation", package: "ZIPFoundation")
             ],
-            path: "ios/Plugin",
-            swiftSettings: [
-                .define("CAPAWESOME_INCLUDE_IONIC_PROVIDER", .when(traits: ["IonicProvider"]))
-            ]),
+            path: "ios/Plugin"),
         .testTarget(
             name: "LiveUpdatePluginTests",
             dependencies: ["LiveUpdatePlugin"],
             path: "ios/PluginTests")
-    ],
-    swiftLanguageModes: [.v5]
+    ]
 )

package/README.md

@@ -25,11 +25,10 @@ The Capacitor Live Update plugin is one of the most feature-rich Over-the-Air (O
 - 📡 **Update Lifecycle Events**: Track download progress, react to bundle changes, and detect reloads with auto-blocking of rolled back bundles.
 - 🏠 **Self-Hosted Bundles**: Download bundles from any URL, no Capawesome Cloud dependency required.
 - 🏷️ **Custom Properties**: Associate custom key-value metadata with bundles via Capawesome Cloud.
-- 🌀 **Ionic Portals Support**: Power live updates for [Ionic Portals](https://ionic.io/docs/portals) via the [Ionic Live Update Provider SDK](https://github.com/ionic-team/live-update-provider-sdk).
-- 🧩 **Federated Capacitor Support**: Power live updates for [Federated Capacitor](https://ionic.io/docs/portals/for-capacitor/overview) shells via the [Ionic Live Update Provider SDK](https://github.com/ionic-team/live-update-provider-sdk).
 - 🔒 **Security**: Verify the authenticity and integrity of the bundle using a public key.
 - ⚔️ **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.
+- 🤝 **Compatibility**: Works alongside the [App Update](https://capawesome.io/docs/sdks/capacitor/app-update/) and [Firebase Remote Config](https://capawesome.io/docs/sdks/capacitor/firebase/remote-config/) plugins.
 
 Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
 
@@ -57,6 +56,7 @@ The Live Update plugin is typically used to ship changes to users without going
 - [Getting Started with Capawesome Cloud Live Updates](https://capawesome.io/docs/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/)
+- [Live Updates for Nuxt Capacitor Apps](https://capawesome.io/blog/live-updates-for-nuxt-capacitor/)
 
 ## Installation
 
@@ -84,7 +84,7 @@ npx cap sync
 
 #### Channel
 
-If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/guides/best-practices/#versioned-channels), you can set a default channel directly in your native project by adding a string resource.
+If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/channels/#versioned-channels), you can set a default channel directly in your native project by adding a string resource.
 This allows you to tie the channel to the version code at build time.
 
 Add the following to your app's `build.gradle` file:
@@ -101,8 +101,7 @@ android {
 
 If needed, you can define the following project variable in your app’s `variables.gradle` file to change the default version of the dependency:
 
-- `$ionicLiveUpdateProviderVersion` version of `io.ionic:liveupdateprovider` (default: `1.0.0`)
-- `$okhttp3Version` version of `com.squareup.okhttp3:okhttp` (default: `5.3.2`)
+- `$okhttp3Version` version of `com.squareup.okhttp3:okhttp` and `com.squareup.okhttp3:okhttp-brotli` (default: `5.3.2`)
 - `$zip4jVersion` version of `net.lingala.zip4j:zip4j` (default: `2.11.5`)
 
 This can be useful if you encounter dependency conflicts with other plugins in your project.
@@ -111,7 +110,7 @@ This can be useful if you encounter dependency conflicts with other plugins in y
 
 #### Channel
 
-If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/guides/best-practices/#versioned-channels), you can set a default channel directly in your native project by adding a key to your `Info.plist` file.
+If you are using [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/channels/#versioned-channels), you can set a default channel directly in your native project by adding a key to your `Info.plist` file.
 This allows you to tie the channel to the build version at build time.
 
 Add the following to your `Info.plist` file:
@@ -148,10 +147,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.
 
-## Ionic Live Update Provider SDK Integration
-
-This plugin implements the [Ionic Live Update Provider SDK](https://github.com/ionic-team/live-update-provider-sdk) contract, so that **Ionic Portals** and **Federated Capacitor** apps can use Capawesome Cloud to deliver live updates. Federated Capacitor resolves the provider by the plugin name `LiveUpdate`. See [the full setup guide](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/live-update/docs/ionic-live-update-provider-sdk-integration.md) for details.
-
 ## Configuration
 
 <docgen-config>
@@ -1367,7 +1362,7 @@ On Capawesome Cloud, the bundle ID corresponds to the ID of the app build artifa
 There are four ways to set a channel, listed from lowest to highest priority:
 
 1. **Capacitor config**: Set the `defaultChannel` property in the [plugin configuration](#configuration). This is the simplest way to set a static default channel.
-2. **Native config**: Set `CapawesomeLiveUpdateDefaultChannel` in `Info.plist` (iOS) or `capawesome_live_update_default_channel` in `strings.xml` (Android). This is useful for [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/guides/best-practices/#versioned-channels) where the channel is tied to the build version.
+2. **Native config**: Set `CapawesomeLiveUpdateDefaultChannel` in `Info.plist` (iOS) or `capawesome_live_update_default_channel` in `strings.xml` (Android). This is useful for [Versioned Channels](https://capawesome.io/docs/cloud/live-updates/channels/#versioned-channels) where the channel is tied to the build version.
 3. **[`setChannel(...)`](#setchannel)**: Set the channel at runtime. The value is persisted across app restarts.
 4. **[`sync(...)`](#sync)**: Pass a `channel` option to override the channel for a single sync call. This does **not** persist the channel.
 

package/android/build.gradle

@@ -1,5 +1,3 @@
-import org.jetbrains.kotlin.gradle.dsl.JvmTarget
-
 ext {
     junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
     androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
@@ -7,23 +5,19 @@ ext {
     androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
     okhttp3Version = project.hasProperty('okhttp3Version') ? rootProject.ext.okhttp3Version : '5.3.2'
     zip4jVersion = project.hasProperty('zip4jVersion') ? rootProject.ext.zip4jVersion : '2.11.5'
-    ionicLiveUpdateProviderVersion = project.hasProperty('ionicLiveUpdateProviderVersion') ? rootProject.ext.ionicLiveUpdateProviderVersion : '1.0.0'
 }
 
 buildscript {
-    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '2.2.20'
     repositories {
         google()
         mavenCentral()
     }
     dependencies {
         classpath 'com.android.tools.build:gradle:8.13.0'
-        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
 
 apply plugin: 'com.android.library'
-apply plugin: 'org.jetbrains.kotlin.android'
 
 android {
     namespace = "io.capawesome.capacitorjs.plugins.liveupdate"
@@ -34,7 +28,6 @@ android {
         versionCode 1
         versionName "1.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
-        consumerProguardFiles 'consumer-rules.pro'
     }
     buildTypes {
         release {
@@ -51,12 +44,6 @@ android {
     }
 }
 
-kotlin {
-    compilerOptions {
-        jvmTarget = JvmTarget.JVM_21
-    }
-}
-
 repositories {
     google()
     mavenCentral()
@@ -69,10 +56,7 @@ dependencies {
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "net.lingala.zip4j:zip4j:$zip4jVersion"
     implementation "com.squareup.okhttp3:okhttp:$okhttp3Version"
-    // The Ionic Live Update Provider SDK is compile-time only: Federated Capacitor
-    // and Ionic Portals bring it transitively at runtime, and the provider classes
-    // are only loaded when a host actually calls `createManager`.
-    compileOnly "io.ionic:liveupdateprovider:$ionicLiveUpdateProviderVersion"
+    implementation "com.squareup.okhttp3:okhttp-brotli:$okhttp3Version"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

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

@@ -1,16 +1,17 @@
 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;
 import android.content.res.AssetManager;
 import android.os.Build;
 import android.os.Handler;
+import android.os.Looper;
 import android.util.Base64;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
+import androidx.core.content.pm.PackageInfoCompat;
 import com.getcapacitor.Bridge;
 import com.getcapacitor.Logger;
 import com.getcapacitor.plugin.WebView;
@@ -88,15 +89,12 @@ public class LiveUpdate {
     @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
+    @NonNull
     private final LiveUpdatePlugin plugin;
 
     @NonNull
@@ -106,7 +104,7 @@ public class LiveUpdate {
     private final SharedPreferences.Editor webViewSettingsEditor;
 
     private final String bundlesDirectory = "_capacitor_live_update_bundles"; // DO NOT CHANGE!
-    private final Handler rollbackHandler = new Handler();
+    private final Handler rollbackHandler = new Handler(Looper.getMainLooper());
     private final String manifestFileName = "capawesome-live-update-manifest.json"; // DO NOT CHANGE!
 
     private boolean initialPageLoaded = false;
@@ -115,26 +113,11 @@ public class LiveUpdate {
     private boolean syncInProgress = false;
 
     public LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull LiveUpdatePlugin plugin) throws PackageManager.NameNotFoundException {
-        this(config, plugin.getContext(), plugin);
-    }
-
-    /**
-     * Creates a headless instance without a Capacitor plugin, e.g. for Ionic Portals hosts
-     * that construct a provider manager directly. WebView-related operations (server path
-     * changes, reload) and plugin events are skipped in this mode.
-     */
-    public LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull Context context) throws PackageManager.NameNotFoundException {
-        this(config, context, null);
-    }
-
-    private LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull Context context, @Nullable LiveUpdatePlugin plugin)
-        throws PackageManager.NameNotFoundException {
         this.config = config;
-        this.context = context;
         this.httpClient = new LiveUpdateHttpClient(config);
         this.plugin = plugin;
-        this.preferences = new LiveUpdatePreferences(context);
-        this.webViewSettingsEditor = context.getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE).edit();
+        this.preferences = new LiveUpdatePreferences(plugin.getContext());
+        this.webViewSettingsEditor = plugin.getContext().getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE).edit();
 
         // Check version and reset config if version changed
         checkAndResetConfigIfVersionChanged();
@@ -319,17 +302,6 @@ public class LiveUpdate {
         callback.success(result);
     }
 
-    /**
-     * @return The on-disk directory of a downloaded bundle, or `null` if the bundle does not exist.
-     */
-    @Nullable
-    public File getBundleDirectory(@NonNull String bundleId) {
-        if (!hasBundleById(bundleId)) {
-            return null;
-        }
-        return buildBundleDirectoryFor(bundleId);
-    }
-
     public void getCustomId(@NonNull NonEmptyCallback callback) {
         String customId = preferences.getCustomId();
         GetCustomIdResult result = new GetCustomIdResult(customId);
@@ -579,21 +551,21 @@ public class LiveUpdate {
     }
 
     private File buildBundlesDirectory() {
-        return new File(context.getFilesDir(), bundlesDirectory);
+        return new File(plugin.getContext().getFilesDir(), bundlesDirectory);
     }
 
     private File buildBundleDirectoryFor(@NonNull String bundleId) {
-        return new File(context.getFilesDir(), bundlesDirectory + "/" + bundleId);
+        return new File(plugin.getContext().getFilesDir(), bundlesDirectory + "/" + bundleId);
     }
 
     private File buildTemporaryDirectory() {
         String fileName = UUID.randomUUID().toString();
-        return new File(context.getCacheDir(), fileName);
+        return new File(plugin.getContext().getCacheDir(), fileName);
     }
 
     private File buildTemporaryZipFile() {
         String fileName = UUID.randomUUID().toString() + ".zip";
-        return new File(context.getCacheDir(), fileName);
+        return new File(plugin.getContext().getCacheDir(), fileName);
     }
 
     private void copyCurrentBundleFile(@NonNull ManifestItem fileToCopy, @NonNull File destinationDirectory) throws IOException {
@@ -601,7 +573,7 @@ public class LiveUpdate {
         String currentBundleId = getCurrentBundleId();
         if (currentBundleId == null) {
             // Create the source input stream
-            AssetManager assets = context.getAssets();
+            AssetManager assets = plugin.getContext().getAssets();
             InputStream inputStream = assets.open(defaultWebAssetDir + "/" + href);
             // Create the destination file
             File destination = new File(destinationDirectory, href);
@@ -1007,17 +979,13 @@ public class LiveUpdate {
         @NonNull NonEmptyCallback<GetLatestBundleResponse> callback
     ) {
         try {
-            String appId = options.getAppId() == null ? getAppId() : options.getAppId();
-            if (appId == null || appId.isEmpty()) {
-                throw new Exception(LiveUpdatePlugin.ERROR_APP_ID_MISSING);
-            }
             String channel = options.getChannel() == null ? getChannel() : options.getChannel();
             String url = new HttpUrl.Builder()
                 .scheme("https")
                 .host(config.getServerDomain())
                 .addPathSegment("v1")
                 .addPathSegment("apps")
-                .addPathSegment(appId)
+                .addPathSegment(getAppId())
                 .addPathSegment("bundles")
                 .addPathSegment("latest")
                 .addQueryParameter("appVersionCode", getVersionCodeAsString())
@@ -1084,7 +1052,7 @@ public class LiveUpdate {
             MessageDigest digest = MessageDigest.getInstance("SHA-256");
             BufferedSource source = Okio.buffer(Okio.source(file));
             Buffer buffer = new Buffer();
-            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1;) {
+            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1; ) {
                 digest.update(buffer.readByteArray());
             }
             source.close();
@@ -1131,11 +1099,14 @@ public class LiveUpdate {
 
     @Nullable
     private String getNativeChannel() {
-        int resId = context.getResources().getIdentifier("capawesome_live_update_default_channel", "string", context.getPackageName());
+        int resId = plugin
+            .getContext()
+            .getResources()
+            .getIdentifier("capawesome_live_update_default_channel", "string", plugin.getContext().getPackageName());
         if (resId == 0) {
             return null;
         }
-        return context.getResources().getString(resId);
+        return plugin.getContext().getResources().getString(resId);
     }
 
     /**
@@ -1154,10 +1125,6 @@ public class LiveUpdate {
      * @return The absolute path to the current bundle directory (`public` for the built-in bundle).
      */
     private String getCurrentCapacitorServerPath() {
-        if (plugin == null) {
-            // Headless mode: there is no WebView, so the default bundle is always current.
-            return defaultWebAssetDir;
-        }
         return plugin.getBridge().getServerBasePath();
     }
 
@@ -1188,7 +1155,8 @@ public class LiveUpdate {
      */
     @NonNull
     private String getNextCapacitorServerPath() {
-        String path = context
+        String path = plugin
+            .getContext()
             .getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE)
             .getString(WebView.CAP_SERVER_PATH, defaultWebAssetDir);
         // Empty path means default path
@@ -1207,7 +1175,7 @@ public class LiveUpdate {
     }
 
     private int getVersionCodeAsInt() throws PackageManager.NameNotFoundException {
-        return getPackageInfo().versionCode;
+        return (int) PackageInfoCompat.getLongVersionCode(getPackageInfo());
     }
 
     private String getVersionCodeAsString() throws PackageManager.NameNotFoundException {
@@ -1233,7 +1201,7 @@ public class LiveUpdate {
     private Manifest loadCurrentManifest() throws Exception {
         String currentBundleId = getCurrentBundleId();
         if (currentBundleId == null) {
-            AssetManager assets = context.getAssets();
+            AssetManager assets = plugin.getContext().getAssets();
             boolean manifestFileExists = Arrays.asList(assets.list(defaultWebAssetDir)).contains(manifestFileName);
             if (manifestFileExists) {
                 InputStream inputStream = assets.open(defaultWebAssetDir + "/" + manifestFileName);
@@ -1265,9 +1233,6 @@ public class LiveUpdate {
     }
 
     private void notifyDownloadBundleProgressListeners(@NonNull final DownloadBundleProgressEvent event) {
-        if (plugin == null) {
-            return;
-        }
         plugin.notifyDownloadBundleProgressListeners(event);
     }
 
@@ -1354,10 +1319,6 @@ public class LiveUpdate {
     }
 
     private void setCurrentCapacitorServerPath(@NonNull String path) {
-        if (plugin == null) {
-            // Headless mode: there is no WebView to point at the new path.
-            return;
-        }
         if (path.equals(defaultWebAssetDir)) {
             this.plugin.getBridge().setServerAssetPath(path);
         } else {
@@ -1384,17 +1345,11 @@ public class LiveUpdate {
     }
 
     private void notifyNextBundleSetListeners(@Nullable String bundleId) {
-        if (plugin == null) {
-            return;
-        }
         NextBundleSetEvent event = new NextBundleSetEvent(bundleId);
         plugin.notifyNextBundleSetListeners(event);
     }
 
     private void notifyReloadedListeners() {
-        if (plugin == null) {
-            return;
-        }
         plugin.notifyReloadedListeners();
     }
 
@@ -1535,7 +1490,7 @@ public class LiveUpdate {
             sig.initVerify(key);
             BufferedSource source = Okio.buffer(Okio.source(file));
             Buffer buffer = new Buffer();
-            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1;) {
+            for (long bytesRead; (bytesRead = source.read(buffer, 2048)) != -1; ) {
                 sig.update(buffer.readByteArray());
             }
             source.close();
@@ -1547,11 +1502,11 @@ public class LiveUpdate {
     }
 
     private PackageInfo getPackageInfo() throws PackageManager.NameNotFoundException {
-        String packageName = this.context.getPackageName();
+        String packageName = this.plugin.getContext().getPackageName();
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-            return this.context.getPackageManager().getPackageInfo(packageName, PackageManager.PackageInfoFlags.of(0));
+            return this.plugin.getContext().getPackageManager().getPackageInfo(packageName, PackageManager.PackageInfoFlags.of(0));
         } else {
-            return this.context.getPackageManager().getPackageInfo(packageName, 0);
+            return this.plugin.getContext().getPackageManager().getPackageInfo(packageName, 0);
         }
     }
 }

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

@@ -15,6 +15,7 @@ import okhttp3.OkHttpClient;
 import okhttp3.Request;
 import okhttp3.Response;
 import okhttp3.ResponseBody;
+import okhttp3.brotli.BrotliInterceptor;
 import okio.Buffer;
 import okio.BufferedSink;
 import okio.BufferedSource;
@@ -58,6 +59,7 @@ public class LiveUpdateHttpClient {
         dispatcher.setMaxRequestsPerHost(30);
 
         this.okHttpClient = new OkHttpClient.Builder()
+            .addInterceptor(BrotliInterceptor.INSTANCE)
             .dispatcher(dispatcher)
             .connectTimeout(httpTimeout, TimeUnit.MILLISECONDS)
             .readTimeout(httpTimeout, TimeUnit.MILLISECONDS)
@@ -101,7 +103,7 @@ public class LiveUpdateHttpClient {
         Buffer sinkBuffer = sink.getBuffer();
         long totalBytesRead = 0;
         int bufferSize = 8 * 1024;
-        for (long bytesRead; (bytesRead = source.read(sinkBuffer, bufferSize)) != -1;) {
+        for (long bytesRead; (bytesRead = source.read(sinkBuffer, bufferSize)) != -1; ) {
             sink.emit();
             totalBytesRead += bytesRead;
             if (callback != null) {

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

@@ -1,6 +1,5 @@
 package io.capawesome.capacitorjs.plugins.liveupdate;
 
-import android.content.Context;
 import android.webkit.WebView;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
@@ -33,10 +32,6 @@ import io.capawesome.capacitorjs.plugins.liveupdate.classes.results.IsSyncingRes
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.EmptyCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.NonEmptyCallback;
 import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
-import io.capawesome.capacitorjs.plugins.liveupdate.providers.ionic.LiveUpdateIonicManager;
-import io.ionic.liveupdateprovider.ProviderError;
-import io.ionic.liveupdateprovider.ProviderManager;
-import java.util.Map;
 
 @CapacitorPlugin(name = "LiveUpdate")
 public class LiveUpdatePlugin extends Plugin {
@@ -45,7 +40,6 @@ public class LiveUpdatePlugin extends Plugin {
     public static final String VERSION = "8.3.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_DIRECTORY_NOT_FOUND = "Bundle directory could not be resolved.";
     public static final String ERROR_BUNDLE_EXISTS = "bundle already exists.";
     public static final String ERROR_BUNDLE_ID_MISSING = "bundleId must be provided.";
     public static final String ERROR_BUNDLE_INDEX_HTML_MISSING = "The bundle does not contain an index.html file.";
@@ -54,10 +48,7 @@ public class LiveUpdatePlugin extends Plugin {
     public static final String ERROR_CHECKSUM_MISMATCH = "Checksum mismatch.";
     public static final String ERROR_CUSTOM_ID_MISSING = "customId must be provided.";
     public static final String ERROR_DOWNLOAD_FAILED = "Bundle could not be downloaded.";
-    public static final String ERROR_DOWNLOAD_URL_MISSING = "Bundle does not have a valid download URL.";
     public static final String ERROR_HTTP_TIMEOUT = "Request timed out.";
-    public static final String ERROR_MANAGER_KEY_MISSING = "managerKey must be provided.";
-    public static final String ERROR_PLUGIN_NOT_INITIALIZED = "Plugin is not initialized.";
     public static final String ERROR_URL_MISSING = "url must be provided.";
     public static final String ERROR_SIGNATURE_VERIFICATION_FAILED = "Signature verification failed.";
     public static final String ERROR_PUBLIC_KEY_INVALID = "Invalid public key.";
@@ -85,26 +76,6 @@ public class LiveUpdatePlugin extends Plugin {
         }
     }
 
-    /**
-     * Creates a manager for the Ionic Live Update Provider SDK. Invoked natively by
-     * Federated Capacitor after resolving this plugin by its Capacitor plugin name.
-     *
-     * This class deliberately does NOT implement the SDK's `LiveUpdateProvider` interface:
-     * superinterfaces are resolved eagerly at class-definition time, which would crash the
-     * plugin when the compileOnly SDK is absent at runtime. Instead, this method matches the
-     * interface's exact signature and Federated Capacitor invokes it via reflection when the
-     * cast to `LiveUpdateProvider` fails. Method references are resolved lazily, so this
-     * class loads fine without the SDK. Do NOT change the signature.
-     */
-    @NonNull
-    public ProviderManager createManager(@NonNull Context context, @NonNull Map<String, ?> configuration)
-        throws ProviderError.InvalidConfiguration {
-        if (implementation == null) {
-            throw new ProviderError.InvalidConfiguration(ERROR_PLUGIN_NOT_INITIALIZED, null);
-        }
-        return new LiveUpdateIonicManager(context, configuration, implementation);
-    }
-
     @Override
     protected void handleOnResume() {
         super.handleOnResume();
@@ -118,17 +89,16 @@ public class LiveUpdatePlugin extends Plugin {
             // 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();
-                                }
+                getBridge().addWebViewListener(
+                    new WebViewListener() {
+                        @Override
+                        public void onPageLoaded(WebView webView) {
+                            if (implementation != null) {
+                                implementation.handleOnPageLoaded();
                             }
                         }
-                    );
+                    }
+                );
             }
         } catch (Exception exception) {
             Logger.error(TAG, exception.getMessage(), exception);

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

@@ -6,32 +6,17 @@ import com.getcapacitor.PluginCall;
 
 public class FetchLatestBundleOptions {
 
-    @Nullable
-    private final String appId;
-
     @Nullable
     private final String channel;
 
     public FetchLatestBundleOptions(@NonNull PluginCall call) {
-        this.appId = null;
         this.channel = call.getString("channel", null);
     }
 
     public FetchLatestBundleOptions(@Nullable String channel) {
-        this.appId = null;
-        this.channel = channel;
-    }
-
-    public FetchLatestBundleOptions(@Nullable String appId, @Nullable String channel) {
-        this.appId = appId;
         this.channel = channel;
     }
 
-    @Nullable
-    public String getAppId() {
-        return appId;
-    }
-
     @Nullable
     public String getChannel() {
         return channel;

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

@@ -48,36 +48,6 @@ public class FetchLatestBundleResult implements Result {
         this.signature = signature;
     }
 
-    @Nullable
-    public ArtifactType getArtifactType() {
-        return artifactType;
-    }
-
-    @Nullable
-    public String getBundleId() {
-        return bundleId;
-    }
-
-    @Nullable
-    public String getChecksum() {
-        return checksum;
-    }
-
-    @Nullable
-    public JSONObject getCustomProperties() {
-        return customProperties;
-    }
-
-    @Nullable
-    public String getDownloadUrl() {
-        return downloadUrl;
-    }
-
-    @Nullable
-    public String getSignature() {
-        return signature;
-    }
-
     @NonNull
     public JSObject toJSObject() {
         JSObject result = new JSObject();

package/ios/Plugin/Classes/Options/FetchLatestBundleOptions.swift

@@ -2,28 +2,16 @@ import Foundation
 import Capacitor
 
 @objc public class FetchLatestBundleOptions: NSObject {
-    private var appId: String?
     private var channel: String?
 
     init(_ call: CAPPluginCall) {
-        self.appId = nil
         self.channel = call.getString("channel")
     }
 
     init(channel: String?) {
-        self.appId = nil
         self.channel = channel
     }
 
-    init(appId: String?, channel: String?) {
-        self.appId = appId
-        self.channel = channel
-    }
-
-    func getAppId() -> String? {
-        return appId
-    }
-
     func getChannel() -> String? {
         return channel
     }

package/ios/Plugin/Classes/Results/FetchLatestBundleResult.swift

@@ -20,30 +20,6 @@ import Capacitor
         self.signature = signature
     }
 
-    public func getArtifactType() -> String? {
-        return artifactType?.rawValue
-    }
-
-    public func getBundleId() -> String? {
-        return bundleId
-    }
-
-    public func getChecksum() -> String? {
-        return checksum
-    }
-
-    public func getCustomProperties() -> [String: Any]? {
-        return customProperties
-    }
-
-    public func getDownloadUrl() -> String? {
-        return downloadUrl
-    }
-
-    public func getSignature() -> String? {
-        return signature
-    }
-
     public func toJSObject() -> AnyObject {
         var result = JSObject()
         if artifactType == .manifest {

package/ios/Plugin/Enums/CustomError.swift

@@ -3,7 +3,6 @@ import Foundation
 public enum CustomError: Error {
     case appIdMissing
     case bundleAlreadyExists
-    case bundleDirectoryNotFound
     case bundleIdMissing
     case bundleIndexHtmlMissing
     case bundleNotFound
@@ -13,10 +12,7 @@ public enum CustomError: Error {
     case checksumMismatch
     case customIdMissing
     case downloadFailed
-    case downloadUrlMissing
     case httpTimeout
-    case managerKeyMissing
-    case pluginNotInitialized
     case signatureMissing
     case signatureVerificationFailed
     case syncInProgress
@@ -31,8 +27,6 @@ extension CustomError: LocalizedError {
             return NSLocalizedString("appId must be configured.", comment: "appIdMissing")
         case .bundleAlreadyExists:
             return NSLocalizedString("bundle already exists.", comment: "bundleAlreadyExists")
-        case .bundleDirectoryNotFound:
-            return NSLocalizedString("Bundle directory could not be resolved.", comment: "bundleDirectoryNotFound")
         case .bundleIdMissing:
             return NSLocalizedString("bundleId must be provided.", comment: "bundleIdMissing")
         case .bundleIndexHtmlMissing:
@@ -51,14 +45,8 @@ extension CustomError: LocalizedError {
             return NSLocalizedString("customId must be provided.", comment: "customIdMissing")
         case .downloadFailed:
             return NSLocalizedString("Bundle could not be downloaded.", comment: "downloadFailed")
-        case .downloadUrlMissing:
-            return NSLocalizedString("Bundle does not have a valid download URL.", comment: "downloadUrlMissing")
         case .httpTimeout:
             return NSLocalizedString("Request timed out.", comment: "httpTimeout")
-        case .managerKeyMissing:
-            return NSLocalizedString("managerKey must be provided.", comment: "managerKeyMissing")
-        case .pluginNotInitialized:
-            return NSLocalizedString("Plugin is not initialized.", comment: "pluginNotInitialized")
         case .signatureMissing:
             return NSLocalizedString("Bundle does not contain a signature.", comment: "signatureMissing")
         case .signatureVerificationFailed:

package/ios/Plugin/LiveUpdate.swift

@@ -16,7 +16,7 @@ import CommonCrypto
     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 plugin: LiveUpdatePlugin
     private let preferences: LiveUpdatePreferences
 
     private var rollbackDispatchWorkItem: DispatchWorkItem?
@@ -24,10 +24,7 @@ import CommonCrypto
     private var lastAutoUpdateCheckTimestamp: Int64 = 0
     private var syncInProgress = false
 
-    /// - Parameter plugin: The Capacitor plugin, or `nil` for a headless instance
-    ///   (e.g. for Ionic Portals hosts that construct a provider manager directly).
-    ///   In headless mode, WebView-related operations and plugin events are skipped.
-    init(config: LiveUpdateConfig, plugin: LiveUpdatePlugin? = nil) {
+    init(config: LiveUpdateConfig, plugin: LiveUpdatePlugin) {
         self.config = config
         self.httpClient = LiveUpdateHttpClient(config: config)
         self.plugin = plugin
@@ -164,14 +161,6 @@ import CommonCrypto
         completion(result, nil)
     }
 
-    /// - Returns: The on-disk URL of a downloaded bundle, or `nil` if the bundle does not exist.
-    public func getBundleDirectory(bundleId: String) -> URL? {
-        guard hasBundleById(bundleId) else {
-            return nil
-        }
-        return buildBundleURLFor(bundleId: bundleId)
-    }
-
     @objc public func getCustomId(completion: @escaping (Result?, Error?) -> Void) {
         let customId = preferences.getCustomId()
 
@@ -474,7 +463,8 @@ import CommonCrypto
 
     private func downloadAndVerifyFile(url: String, file: URL, checksum: String?, signature: String?, callback: ((Progress) -> Void)?) async throws {
         let destination: DownloadRequest.Destination = { _, _ in
-            return (file, [.createIntermediateDirectories])
+            // `removePreviousFile` ensures that a leftover file from a failed attempt does not fail the download
+            return (file, [.createIntermediateDirectories, .removePreviousFile])
         }
         let urlComponents = URLComponents(string: url)!
         let result = try await httpClient.download(url: urlComponents.asURL(), destination: destination, callback: callback)
@@ -591,9 +581,6 @@ import CommonCrypto
     }
 
     private func fetchLatestBundle(_ options: FetchLatestBundleOptions) async throws -> GetLatestBundleResponse? {
-        guard let appId = options.getAppId() ?? getAppId(), !appId.isEmpty else {
-            throw CustomError.appIdMissing
-        }
         let channel = options.getChannel() ?? getChannel()
         var parameters = [String: String]()
         parameters["appVersionCode"] = getVersionCode()
@@ -605,7 +592,7 @@ import CommonCrypto
         parameters["osVersion"] = await UIDevice.current.systemVersion
         parameters["platform"] = "1"
         parameters["pluginVersion"] = LiveUpdatePlugin.version
-        var urlComponents = URLComponents(string: "https://\(config.serverDomain)/v1/apps/\(appId)/bundles/latest")!
+        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)
@@ -695,7 +682,7 @@ import CommonCrypto
 
     /// - Returns: The path to the current bundle directory or `nil` if no view controller was found.
     private func getCurrentCapacitorServerPath() -> String? {
-        guard let viewController = self.plugin?.bridge?.viewController as? CAPBridgeViewController else {
+        guard let viewController = self.plugin.bridge?.viewController as? CAPBridgeViewController else {
             return nil
         }
         return viewController.getServerBasePath()
@@ -777,7 +764,7 @@ import CommonCrypto
     }
 
     private func notifyDownloadBundleProgressListeners(_ event: DownloadBundleProgressEvent) {
-        plugin?.notifyDownloadBundleProgressListeners(event)
+        plugin.notifyDownloadBundleProgressListeners(event)
     }
 
     private func performAutoUpdate() {
@@ -854,7 +841,7 @@ import CommonCrypto
     }
 
     private func setCurrentCapacitorServerPath(path: String) {
-        guard let viewController = self.plugin?.bridge?.viewController as? CAPBridgeViewController else {
+        guard let viewController = self.plugin.bridge?.viewController as? CAPBridgeViewController else {
             return
         }
         viewController.setServerBasePath(path: path)
@@ -873,11 +860,11 @@ import CommonCrypto
 
     private func notifyNextBundleSetListeners(_ bundleId: String?) {
         let event = NextBundleSetEvent(bundleId: bundleId)
-        plugin?.notifyNextBundleSetListeners(event)
+        plugin.notifyNextBundleSetListeners(event)
     }
 
     private func notifyReloadedListeners() {
-        plugin?.notifyReloadedListeners()
+        plugin.notifyReloadedListeners()
     }
 
     private func addBlockedBundleId(_ bundleId: String) {

package/ios/Plugin/LiveUpdateHttpClient.swift

@@ -27,13 +27,16 @@ public class LiveUpdateHttpClient: NSObject {
 
     public func download(url: URL, destination: @escaping DownloadRequest.Destination, callback: ((Progress) -> Void)?) async throws -> AFDownloadResponse<Data> {
         var request = URLRequest(url: url)
+        // Ignore the URL cache so that a cached response is never replayed for a deterministic request URL
+        request.cachePolicy = .reloadIgnoringLocalCacheData
         request.httpMethod = HTTPMethod.get.rawValue
         request.timeoutInterval = Double(config.httpTimeout) / 1000.0
         if let deviceId = deviceId, !deviceId.isEmpty {
             request.setValue(deviceId, forHTTPHeaderField: "X-Capawesome-Device-Id")
         }
         return try await withCheckedThrowingContinuation { continuation in
-            AF.download(request, to: destination).downloadProgress { progress in
+            // `validate()` treats non-2xx responses as errors so that an error body is never saved as a bundle file
+            AF.download(request, to: destination).validate().downloadProgress { progress in
                 if let callback = callback {
                     callback(progress)
                 }
@@ -45,6 +48,8 @@ public class LiveUpdateHttpClient: NSObject {
 
     public func request<T: Decodable>(url: URL, type: T.Type) async throws -> AFDataResponse<T> {
         var request = URLRequest(url: url)
+        // Ignore the URL cache so that a cached response is never replayed for a deterministic request URL
+        request.cachePolicy = .reloadIgnoringLocalCacheData
         request.httpMethod = HTTPMethod.get.rawValue
         request.timeoutInterval = Double(config.httpTimeout) / 1000.0
         if let deviceId = deviceId, !deviceId.isEmpty {

package/ios/Plugin/LiveUpdatePlugin.swift

@@ -47,7 +47,7 @@ public class LiveUpdatePlugin: CAPPlugin, CAPBridgedPlugin {
     private let eventReloaded = "reloaded"
 
     private var config: LiveUpdateConfig?
-    var implementation: LiveUpdate?
+    private var implementation: LiveUpdate?
 
     override public func load() {
         self.config = liveUpdateConfig()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-live-update",
-  "version": "8.3.0-dev.f9cc1d15.1783929784",
+  "version": "8.4.0",
   "description": "Capacitor plugin to update your app remotely in real-time on Android and iOS.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -75,15 +75,15 @@
   },
   "devDependencies": {
     "@capacitor/android": "8.0.0",
-    "@capacitor/cli": "8.0.0",
+    "@capacitor/cli": "8.4.2",
     "@capacitor/core": "8.0.0",
     "@capacitor/docgen": "0.3.1",
     "@capacitor/ios": "8.0.0",
     "@ionic/eslint-config": "0.4.0",
     "eslint": "8.57.0",
-    "prettier-plugin-java": "2.6.7",
+    "prettier-plugin-java": "2.9.7",
     "rimraf": "6.1.2",
-    "rollup": "4.53.3",
+    "rollup": "4.62.3",
     "swiftlint": "2.0.0",
     "typescript": "5.9.3"
   },

package/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/providers/ionic/LiveUpdateIonicManager.kt

@@ -1,169 +0,0 @@
-package io.capawesome.capacitorjs.plugins.liveupdate.providers.ionic
-
-import android.content.Context
-import android.content.SharedPreferences
-import com.getcapacitor.Logger
-import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdate
-import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdateConfig
-import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdatePlugin
-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.results.FetchLatestBundleResult
-import io.capawesome.capacitorjs.plugins.liveupdate.enums.ArtifactType
-import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.EmptyCallback
-import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.NonEmptyCallback
-import io.ionic.liveupdateprovider.MetadataSyncResult
-import io.ionic.liveupdateprovider.ProviderError
-import io.ionic.liveupdateprovider.ProviderManager
-import io.ionic.liveupdateprovider.ProviderSyncResult
-import java.io.File
-import kotlin.coroutines.resume
-import kotlin.coroutines.resumeWithException
-import kotlin.coroutines.suspendCoroutine
-import org.json.JSONObject
-
-/**
- * Ionic Live Update Provider manager backed by the Capawesome live update plugin.
- *
- * Each manager instance is scoped by a `managerKey` so that multiple shells (Portals or
- * Federated Capacitor apps) can persist their own active bundle without colliding with each
- * other or with the standalone plugin's `currentBundleId` / `nextBundleId` state.
- *
- * Provider configuration keys (V1):
- * - `managerKey` (required) — scopes per-manager persisted state
- * - `appId` (optional) — Capawesome Cloud app UUID; falls back to plugin config
- * - `channel` (optional) — channel to sync; falls back to plugin config
- */
-class LiveUpdateIonicManager
-@Throws(ProviderError.InvalidConfiguration::class)
-constructor(context: Context, configuration: Map<String, *>, private val liveUpdate: LiveUpdate) : ProviderManager {
-
-    /**
-     * Creates a manager without a running Capacitor plugin, e.g. for Ionic Portals hosts
-     * that construct the manager directly and attach it to a Portal via
-     * `setLiveUpdateProviderManager(...)`. Uses a headless [LiveUpdate] instance with the
-     * default configuration; pass `appId` and `channel` via the configuration map.
-     */
-    @Throws(ProviderError.InvalidConfiguration::class)
-    constructor(context: Context, configuration: Map<String, *>) : this(context, configuration, LiveUpdate(LiveUpdateConfig(), context))
-
-    companion object {
-        const val SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdateIonicProvider"
-        const val PREF_PREFIX_LAST_SYNCED_BUNDLE_ID = "lastSyncedBundleId."
-    }
-
-    override var latestAppDirectory: File? = null
-        private set
-
-    private val appId: String?
-    private val channel: String?
-    private val managerKey: String
-    private val sharedPreferences: SharedPreferences
-
-    init {
-        val managerKeyValue = configuration["managerKey"]
-        if (managerKeyValue !is String || managerKeyValue.isEmpty()) {
-            throw ProviderError.InvalidConfiguration(LiveUpdatePlugin.ERROR_MANAGER_KEY_MISSING)
-        }
-        managerKey = managerKeyValue
-        appId = configuration["appId"] as? String
-        channel = configuration["channel"] as? String
-        sharedPreferences = context.applicationContext.getSharedPreferences(SHARED_PREFERENCES_NAME, Context.MODE_PRIVATE)
-
-        // Restore the last synced bundle directory, if any.
-        val persistedBundleId = sharedPreferences.getString(getLastSyncedBundleIdKey(), null)
-        if (persistedBundleId != null) {
-            latestAppDirectory = liveUpdate.getBundleDirectory(persistedBundleId)
-        }
-    }
-
-    override suspend fun sync(): ProviderSyncResult? {
-        try {
-            val result = fetchLatestBundle()
-
-            // No update available; nothing to report.
-            val bundleId = result.bundleId ?: return null
-
-            // Bundle already on disk — just point latestAppDirectory at it and persist.
-            val existingDirectory = liveUpdate.getBundleDirectory(bundleId)
-            if (existingDirectory != null) {
-                applySyncedBundle(bundleId, existingDirectory)
-                return MetadataSyncResult(buildMetadata(bundleId, result.customProperties))
-            }
-
-            // Otherwise, download and then apply.
-            downloadBundle(bundleId, result)
-            val downloadedDirectory =
-                liveUpdate.getBundleDirectory(bundleId) ?: throw Exception(LiveUpdatePlugin.ERROR_BUNDLE_DIRECTORY_NOT_FOUND)
-            applySyncedBundle(bundleId, downloadedDirectory)
-            return MetadataSyncResult(buildMetadata(bundleId, result.customProperties))
-        } catch (exception: Exception) {
-            Logger.error(LiveUpdatePlugin.TAG, "Ionic provider sync failed: ${exception.message}", exception)
-            throw exception
-        }
-    }
-
-    private fun applySyncedBundle(bundleId: String, directory: File) {
-        latestAppDirectory = directory
-        sharedPreferences.edit().putString(getLastSyncedBundleIdKey(), bundleId).apply()
-    }
-
-    private fun buildMetadata(bundleId: String, customProperties: JSONObject?): Map<String, Any> {
-        val metadata = mutableMapOf<String, Any>("bundleId" to bundleId)
-        channel?.let { metadata["channel"] = it }
-        customProperties?.let {
-            val customPropertiesMap = jsonObjectToMap(it)
-            if (customPropertiesMap.isNotEmpty()) {
-                metadata["customProperties"] = customPropertiesMap
-            }
-        }
-        return metadata
-    }
-
-    private suspend fun downloadBundle(bundleId: String, result: FetchLatestBundleResult) {
-        val downloadUrl = result.downloadUrl
-        if (downloadUrl.isNullOrEmpty()) {
-            throw Exception(LiveUpdatePlugin.ERROR_DOWNLOAD_URL_MISSING)
-        }
-        val artifactType = if (result.artifactType == ArtifactType.MANIFEST) "manifest" else "zip"
-        val options = DownloadBundleOptions(artifactType, bundleId, result.checksum, result.signature, downloadUrl)
-        return suspendCoroutine { continuation ->
-            liveUpdate.downloadBundle(
-                options,
-                object : EmptyCallback {
-                    override fun success() = continuation.resume(Unit)
-
-                    override fun error(exception: Exception) = continuation.resumeWithException(exception)
-                }
-            )
-        }
-    }
-
-    private suspend fun fetchLatestBundle(): FetchLatestBundleResult = suspendCoroutine { continuation ->
-        liveUpdate.fetchLatestBundle(
-            FetchLatestBundleOptions(appId, channel),
-            object : NonEmptyCallback<FetchLatestBundleResult> {
-                override fun success(result: FetchLatestBundleResult) = continuation.resume(result)
-
-                override fun error(exception: Exception) = continuation.resumeWithException(exception)
-            }
-        )
-    }
-
-    private fun getLastSyncedBundleIdKey(): String {
-        return PREF_PREFIX_LAST_SYNCED_BUNDLE_ID + managerKey
-    }
-
-    private fun jsonObjectToMap(jsonObject: JSONObject): Map<String, Any> {
-        val map = mutableMapOf<String, Any>()
-        val keys = jsonObject.keys()
-        while (keys.hasNext()) {
-            val key = keys.next()
-            val value = jsonObject.opt(key)
-            if (value != null && value != JSONObject.NULL) {
-                map[key] = value
-            }
-        }
-        return map
-    }
-}

package/ios/Plugin/Providers/Ionic/LiveUpdateIonicManager.swift

@@ -1,108 +0,0 @@
-#if CAPAWESOME_INCLUDE_IONIC_PROVIDER
-import Foundation
-import Capacitor
-import LiveUpdateProvider
-
-/// Ionic Live Update Provider manager backed by the Capawesome live update plugin.
-///
-/// Each manager instance is scoped by a `managerKey` so that multiple shells (Portals or
-/// Federated Capacitor apps) can persist their own active bundle without colliding with
-/// each other or with the standalone plugin's `currentBundleId` / `nextBundleId` state.
-///
-/// Provider configuration keys (V1):
-/// - `managerKey` (required) — scopes per-manager persisted state
-/// - `appId` (optional) — Capawesome Cloud app UUID; falls back to plugin config
-/// - `channel` (optional) — channel to sync; falls back to plugin config
-public final class LiveUpdateIonicManager: ProviderManager {
-    private static let userDefaultsPrefix = "CapawesomeLiveUpdateIonicProvider.lastSyncedBundleId."
-
-    public private(set) var latestAppDirectory: URL?
-
-    private let appId: String?
-    private let channel: String?
-    private let liveUpdate: LiveUpdate
-    private let managerKey: String
-
-    /// Creates a manager without a running Capacitor plugin, e.g. for Ionic Portals hosts
-    /// that construct the manager directly and attach it to a Portal via
-    /// `liveUpdateSource: .provider(manager:)`. Uses a headless `LiveUpdate` instance with
-    /// the default configuration; pass `appId` and `channel` via the configuration dictionary.
-    public convenience init(configuration: [String: Any]) throws {
-        try self.init(configuration: configuration, liveUpdate: LiveUpdate(config: LiveUpdateConfig()))
-    }
-
-    init(configuration: [String: Any], liveUpdate: LiveUpdate) throws {
-        guard let managerKey = configuration["managerKey"] as? String, !managerKey.isEmpty else {
-            throw ProviderError.invalidConfiguration(message: CustomError.managerKeyMissing.localizedDescription)
-        }
-        self.managerKey = managerKey
-        self.appId = configuration["appId"] as? String
-        self.channel = configuration["channel"] as? String
-        self.liveUpdate = liveUpdate
-
-        // Restore the last synced bundle directory, if any.
-        if let persistedBundleId = UserDefaults.standard.string(forKey: lastSyncedBundleIdKey()) {
-            self.latestAppDirectory = liveUpdate.getBundleDirectory(bundleId: persistedBundleId)
-        }
-    }
-
-    public func sync() async throws -> (any ProviderSyncResult)? {
-        do {
-            let result = try await liveUpdate.fetchLatestBundle(FetchLatestBundleOptions(appId: appId, channel: channel))
-
-            // No update available; nothing to report.
-            guard let bundleId = result.getBundleId() else {
-                return nil
-            }
-
-            // Bundle already on disk — just point latestAppDirectory at it and persist.
-            if let existingDirectory = liveUpdate.getBundleDirectory(bundleId: bundleId) {
-                applySyncedBundle(bundleId: bundleId, directory: existingDirectory)
-                return MetadataSyncResult(metadata: buildMetadata(bundleId: bundleId, customProperties: result.getCustomProperties()))
-            }
-
-            // Otherwise, download and then apply.
-            guard let downloadUrl = result.getDownloadUrl(), !downloadUrl.isEmpty else {
-                throw CustomError.downloadUrlMissing
-            }
-            let downloadOptions = DownloadBundleOptions(
-                artifactType: result.getArtifactType() ?? "zip",
-                bundleId: bundleId,
-                checksum: result.getChecksum(),
-                signature: result.getSignature(),
-                url: downloadUrl
-            )
-            try await liveUpdate.downloadBundle(downloadOptions)
-
-            guard let downloadedDirectory = liveUpdate.getBundleDirectory(bundleId: bundleId) else {
-                throw CustomError.bundleDirectoryNotFound
-            }
-            applySyncedBundle(bundleId: bundleId, directory: downloadedDirectory)
-            return MetadataSyncResult(metadata: buildMetadata(bundleId: bundleId, customProperties: result.getCustomProperties()))
-        } catch {
-            CAPLog.print("[", LiveUpdatePlugin.tag, "] Ionic provider sync failed: ", error.localizedDescription)
-            throw error
-        }
-    }
-
-    private func applySyncedBundle(bundleId: String, directory: URL) {
-        latestAppDirectory = directory
-        UserDefaults.standard.set(bundleId, forKey: lastSyncedBundleIdKey())
-    }
-
-    private func buildMetadata(bundleId: String, customProperties: [String: Any]?) -> [String: Any] {
-        var metadata: [String: Any] = ["bundleId": bundleId]
-        if let channel = channel {
-            metadata["channel"] = channel
-        }
-        if let customProperties = customProperties, !customProperties.isEmpty {
-            metadata["customProperties"] = customProperties
-        }
-        return metadata
-    }
-
-    private func lastSyncedBundleIdKey() -> String {
-        return Self.userDefaultsPrefix + managerKey
-    }
-}
-#endif

package/ios/Plugin/Providers/Ionic/LiveUpdatePlugin+LiveUpdateProvider.swift

@@ -1,15 +0,0 @@
-#if CAPAWESOME_INCLUDE_IONIC_PROVIDER
-import Foundation
-import LiveUpdateProvider
-
-extension LiveUpdatePlugin: LiveUpdateProvider {
-    /// Creates a manager for the Ionic Live Update Provider SDK. Invoked natively by
-    /// Federated Capacitor after resolving this plugin by its Capacitor plugin name.
-    public func createManager(configuration: [String: Any]) throws -> any ProviderManager {
-        guard let implementation = implementation else {
-            throw ProviderError.invalidConfiguration(message: CustomError.pluginNotInitialized.localizedDescription)
-        }
-        return try LiveUpdateIonicManager(configuration: configuration, liveUpdate: implementation)
-    }
-}
-#endif