@capawesome/capacitor-live-update 8.2.0 → 8.2.1-dev.70823ec8.1778138208

package/CapawesomeCapacitorLiveUpdate.podspec

@@ -17,4 +17,19 @@ 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', '0.1.0-alpha.2'
+    ss.pod_target_xcconfig = {
+      'OTHER_SWIFT_FLAGS' => '$(inherited) -DCAPAWESOME_INCLUDE_IONIC_PROVIDER'
+    }
+  end
 end

package/Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version: 5.9
+// swift-tools-version: 6.1
 import PackageDescription
 
 let package = Package(
@@ -9,10 +9,17 @@ let package = Package(
             name: "CapawesomeCapacitorLiveUpdate",
             targets: ["LiveUpdatePlugin"])
     ],
+    traits: [
+        .trait(
+            name: "IonicProvider",
+            description: "Enables registration with the Ionic Live Update Provider SDK."
+        )
+    ],
     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/weichsel/ZIPFoundation.git", .upToNextMinor(from: "0.9.0"))
+        .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", exact: "0.1.0-alpha.2")
     ],
     targets: [
         .target(
@@ -21,12 +28,21 @@ 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: "ZIPFoundation", package: "ZIPFoundation"),
+                .product(
+                    name: "LiveUpdateProvider",
+                    package: "live-update-provider-sdk",
+                    condition: .when(traits: ["IonicProvider"])
+                )
             ],
-            path: "ios/Plugin"),
+            path: "ios/Plugin",
+            swiftSettings: [
+                .define("CAPAWESOME_INCLUDE_IONIC_PROVIDER", .when(traits: ["IonicProvider"]))
+            ]),
         .testTarget(
             name: "LiveUpdatePluginTests",
             dependencies: ["LiveUpdatePlugin"],
             path: "ios/PluginTests")
-    ]
+    ],
+    swiftLanguageModes: [.v5]
 )

package/README.md

@@ -25,19 +25,25 @@ We are proud to offer one of the most complete and feature-rich Capacitor plugin
 - 📡 **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.
 
 Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
 
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
 ## Compatibility
 
 | Plugin Version | Capacitor Version | Status         |
 | -------------- | ----------------- | -------------- |
 | 8.x.x          | >=8.x.x           | Active support |
 | 7.x.x          | 7.x.x             | Maintenance    |
-| 6.x.x          | 6.x.x             | Deprecated     |
+| 6.x.x          | 6.x.x             | Maintenance    |
 | 5.x.x          | 5.x.x             | Deprecated     |
 
 ## Guides
@@ -48,6 +54,21 @@ Missing a feature? Just [open an issue](https://github.com/capawesome-team/capac
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-live-update` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome/capacitor-live-update
 npx cap sync
@@ -120,6 +141,10 @@ 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 can register itself as a provider for the [Ionic Live Update Provider SDK](https://github.com/ionic-team/live-update-provider-sdk), so that **Ionic Portals** and **Federated Capacitor** apps can use Capawesome Cloud to deliver live updates. 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>
@@ -995,7 +1020,7 @@ Remove all listeners for this plugin.
 | Prop                   | Type                                    | Description                                                                                                                                                                                  | Since |
 | ---------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
 | **`artifactType`**     | <code>'manifest' \| 'zip'</code>        | The artifact type of the bundle.                                                                                                                                                             | 6.7.0 |
-| **`bundleId`**         | <code>string \| null</code>             | The unique identifier of the latest bundle. If `null`, no bundle is available.                                                                                                               | 6.6.0 |
+| **`bundleId`**         | <code>string \| null</code>             | The unique identifier of the latest bundle. On Capawesome Cloud, this is the ID of the app build artifact. If `null`, no bundle is available.                                                | 6.6.0 |
 | **`checksum`**         | <code>string</code>                     | The checksum of the latest bundle if the bundle is self-hosted. If the bundle is hosted on Capawesome Cloud, the checksum will be returned as response header when downloading the bundle.   | 7.1.0 |
 | **`customProperties`** | <code>{ [key: string]: string; }</code> | Custom properties that are associated with the latest bundle.                                                                                                                                | 7.0.0 |
 | **`downloadUrl`**      | <code>string</code>                     | The URL of the latest bundle to download. Pass this URL to the `downloadBundle(...)` method to download the bundle.                                                                          | 6.7.0 |
@@ -1228,6 +1253,13 @@ For this reason, you must be careful to [restrict live updates to compatible nat
 
 ## FAQ
 
+### What is a bundle?
+
+A bundle is a set of web assets (HTML, CSS, JavaScript, etc.) that make up your app's user interface.
+The plugin manages two types of bundles: the **built-in bundle** that ships with the native app binary, and **live update bundles** that are downloaded at runtime to update the app without a native release.
+Each live update bundle has a unique **bundle ID** returned by the [`fetchLatestBundle(...)`](#fetchlatestbundle) method.
+On Capawesome Cloud, the bundle ID corresponds to the ID of the app build artifact.
+
 ### How do I set a channel?
 
 There are four ways to set a channel, listed from lowest to highest priority:
@@ -1237,8 +1269,9 @@ There are four ways to set a channel, listed from lowest to highest priority:
 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.
 
-Each method overrides the ones above it.
-You can check the currently resolved channel by calling [`getChannel()`](#getchannel).
+Each method overrides the ones above it. You can check the currently resolved channel by calling [`getChannel()`](#getchannel).
+
+Additionally, Capawesome Cloud supports [forced channel assignments](https://capawesome.io/blog/capawesome-cloud-forced-channel-assignments/) which allow you to override the channel for a specific device without any app code changes. Please note that forced channel assignments have a higher priority than all of the above methods and should be used with caution.
 
 ### Why can't I see my changes during development?
 

package/android/build.gradle

@@ -5,6 +5,8 @@ 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'
+    capawesomeCapacitorLiveUpdateIncludeIonicProvider = project.hasProperty('capawesomeCapacitorLiveUpdateIncludeIonicProvider') ? rootProject.ext.capawesomeCapacitorLiveUpdateIncludeIonicProvider : false
+    ionicLiveUpdateProviderVersion = project.hasProperty('ionicLiveUpdateProviderVersion') ? rootProject.ext.ionicLiveUpdateProviderVersion : '0.1.0-alpha.2'
 }
 
 buildscript {
@@ -56,6 +58,11 @@ dependencies {
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "net.lingala.zip4j:zip4j:$zip4jVersion"
     implementation "com.squareup.okhttp3:okhttp:$okhttp3Version"
+    if (capawesomeCapacitorLiveUpdateIncludeIonicProvider) {
+        implementation "io.ionic:liveupdateprovider:$ionicLiveUpdateProviderVersion"
+    } else {
+        compileOnly "io.ionic:liveupdateprovider:$ionicLiveUpdateProviderVersion"
+    }
     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

@@ -69,6 +69,7 @@ import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicLong;
 import java.util.concurrent.atomic.AtomicReference;
 import net.lingala.zip4j.ZipFile;
+import net.lingala.zip4j.model.FileHeader;
 import okhttp3.Call;
 import okhttp3.HttpUrl;
 import okhttp3.Response;
@@ -297,6 +298,17 @@ 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);
@@ -971,13 +983,17 @@ 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(getAppId())
+                .addPathSegment(appId)
                 .addPathSegment("bundles")
                 .addPathSegment("latest")
                 .addQueryParameter("appVersionCode", getVersionCodeAsString())
@@ -1432,7 +1448,13 @@ public class LiveUpdate {
     private File unzipFile(@NonNull File zipFile) throws IOException {
         File destination = buildTemporaryDirectory();
         String destinationPath = destination.getPath();
-        new ZipFile(zipFile).extractAll(destinationPath);
+        ZipFile zip = new ZipFile(zipFile);
+        // Clear stored Unix permissions to prevent EACCES errors on newer Android versions
+        // where restrictive directory permissions from the zip block file creation.
+        for (FileHeader fileHeader : zip.getFileHeaders()) {
+            fileHeader.setExternalFileAttributes(null);
+        }
+        zip.extractAll(destinationPath);
         return destination;
     }
 

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

@@ -32,6 +32,7 @@ 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.LiveUpdateIonicProviderRegistration;
 
 @CapacitorPlugin(name = "LiveUpdate")
 public class LiveUpdatePlugin extends Plugin {
@@ -40,6 +41,7 @@ public class LiveUpdatePlugin extends Plugin {
     public static final String VERSION = "8.2.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.";
@@ -48,7 +50,9 @@ 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_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.";
@@ -71,6 +75,10 @@ public class LiveUpdatePlugin extends Plugin {
         try {
             config = getLiveUpdateConfig();
             implementation = new LiveUpdate(config, this);
+            // Register the Ionic Live Update Provider when the optional SDK is on the classpath.
+            if (LiveUpdateIonicProviderRegistration.isAvailable()) {
+                LiveUpdateIonicProviderRegistration.tryRegister(implementation);
+            }
         } catch (Exception exception) {
             Logger.error(TAG, exception.getMessage(), exception);
         }

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

@@ -6,17 +6,32 @@ 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

@@ -43,6 +43,36 @@ 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/android/src/main/java/io/capawesome/capacitorjs/plugins/liveupdate/providers/ionic/LiveUpdateIonicManager.java

@@ -0,0 +1,232 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.providers.ionic;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.Logger;
+import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdate;
+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.FederatedCapacitorSyncResult;
+import io.ionic.liveupdateprovider.LiveUpdateProviderError;
+import io.ionic.liveupdateprovider.LiveUpdateProviderManager;
+import io.ionic.liveupdateprovider.LiveUpdateProviderSyncCallback;
+import java.io.File;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+import org.json.JSONObject;
+
+/**
+ * Ionic Live Update Provider manager backed by the Capawesome live update plugin.
+ *
+ * Each manager instance is scoped by a {@code 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 {@code currentBundleId} / {@code nextBundleId} state.
+ *
+ * Provider config keys (V1):
+ * <ul>
+ *   <li>{@code managerKey} (required) — scopes per-manager persisted state</li>
+ *   <li>{@code appId} (optional) — Capawesome Cloud app UUID; falls back to plugin config</li>
+ *   <li>{@code channel} (optional) — channel to sync; falls back to plugin config</li>
+ * </ul>
+ */
+public class LiveUpdateIonicManager implements LiveUpdateProviderManager {
+
+    public static final String SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdateIonicProvider";
+    public static final String PREF_PREFIX_LAST_SYNCED_BUNDLE_ID = "lastSyncedBundleId.";
+
+    @Nullable
+    private final String appId;
+
+    @Nullable
+    private final String channel;
+
+    @Nullable
+    private File latestAppDirectory;
+
+    @NonNull
+    private final LiveUpdate liveUpdate;
+
+    @NonNull
+    private final String managerKey;
+
+    @NonNull
+    private final SharedPreferences sharedPreferences;
+
+    public LiveUpdateIonicManager(@NonNull Context context, @NonNull Map<String, ?> config, @NonNull LiveUpdate liveUpdate)
+        throws LiveUpdateProviderError.InvalidConfiguration {
+        Object managerKeyValue = config.get("managerKey");
+        if (!(managerKeyValue instanceof String) || ((String) managerKeyValue).isEmpty()) {
+            throw new LiveUpdateProviderError.InvalidConfiguration(LiveUpdatePlugin.ERROR_MANAGER_KEY_MISSING, null);
+        }
+        this.managerKey = (String) managerKeyValue;
+
+        Object appIdValue = config.get("appId");
+        this.appId = appIdValue instanceof String ? (String) appIdValue : null;
+
+        Object channelValue = config.get("channel");
+        this.channel = channelValue instanceof String ? (String) channelValue : null;
+
+        this.liveUpdate = liveUpdate;
+        this.sharedPreferences = context.getApplicationContext().getSharedPreferences(SHARED_PREFERENCES_NAME, Context.MODE_PRIVATE);
+
+        // Restore the last synced bundle directory, if any.
+        String persistedBundleId = sharedPreferences.getString(getLastSyncedBundleIdKey(), null);
+        if (persistedBundleId != null) {
+            this.latestAppDirectory = liveUpdate.getBundleDirectory(persistedBundleId);
+        }
+    }
+
+    @Nullable
+    @Override
+    public File getLatestAppDirectory() {
+        return latestAppDirectory;
+    }
+
+    @Override
+    public void sync(@Nullable LiveUpdateProviderSyncCallback callback) {
+        try {
+            FetchLatestBundleOptions fetchOptions = new FetchLatestBundleOptions(appId, channel);
+            liveUpdate.fetchLatestBundle(
+                fetchOptions,
+                new NonEmptyCallback<FetchLatestBundleResult>() {
+                    @Override
+                    public void success(@NonNull FetchLatestBundleResult result) {
+                        handleFetchLatestBundleSuccess(result, callback);
+                    }
+
+                    @Override
+                    public void error(@NonNull Exception exception) {
+                        notifyFailure(callback, exception);
+                    }
+                }
+            );
+        } catch (Exception exception) {
+            notifyFailure(callback, exception);
+        }
+    }
+
+    private void handleFetchLatestBundleSuccess(
+        @NonNull FetchLatestBundleResult result,
+        @Nullable LiveUpdateProviderSyncCallback callback
+    ) {
+        try {
+            String bundleId = result.getBundleId();
+            if (bundleId == null) {
+                // No update available; report success without changing state.
+                notifySuccess(callback, null, null);
+                return;
+            }
+
+            // Bundle already on disk — just point latestAppDirectory at it and persist.
+            File existingDirectory = liveUpdate.getBundleDirectory(bundleId);
+            if (existingDirectory != null) {
+                applySyncedBundle(bundleId, existingDirectory);
+                notifySuccess(callback, bundleId, result.getCustomProperties());
+                return;
+            }
+
+            // Otherwise, download and then apply.
+            String downloadUrl = result.getDownloadUrl();
+            if (downloadUrl == null || downloadUrl.isEmpty()) {
+                notifyFailure(callback, new Exception(LiveUpdatePlugin.ERROR_DOWNLOAD_URL_MISSING));
+                return;
+            }
+            ArtifactType artifactType = result.getArtifactType() == null ? ArtifactType.ZIP : result.getArtifactType();
+            String artifactTypeString = artifactType == ArtifactType.MANIFEST ? "manifest" : "zip";
+            DownloadBundleOptions downloadOptions = new DownloadBundleOptions(
+                artifactTypeString,
+                bundleId,
+                result.getChecksum(),
+                result.getSignature(),
+                downloadUrl
+            );
+            liveUpdate.downloadBundle(
+                downloadOptions,
+                new EmptyCallback() {
+                    @Override
+                    public void success() {
+                        File downloadedDirectory = liveUpdate.getBundleDirectory(bundleId);
+                        if (downloadedDirectory == null) {
+                            notifyFailure(callback, new Exception(LiveUpdatePlugin.ERROR_BUNDLE_DIRECTORY_NOT_FOUND));
+                            return;
+                        }
+                        applySyncedBundle(bundleId, downloadedDirectory);
+                        notifySuccess(callback, bundleId, result.getCustomProperties());
+                    }
+
+                    @Override
+                    public void error(@NonNull Exception exception) {
+                        notifyFailure(callback, exception);
+                    }
+                }
+            );
+        } catch (Exception exception) {
+            notifyFailure(callback, exception);
+        }
+    }
+
+    private void applySyncedBundle(@NonNull String bundleId, @NonNull File directory) {
+        latestAppDirectory = directory;
+        sharedPreferences.edit().putString(getLastSyncedBundleIdKey(), bundleId).apply();
+    }
+
+    private void notifySuccess(
+        @Nullable LiveUpdateProviderSyncCallback callback,
+        @Nullable String bundleId,
+        @Nullable JSONObject customProperties
+    ) {
+        if (callback == null) {
+            return;
+        }
+        Map<String, Object> metadata = new HashMap<>();
+        if (bundleId != null) {
+            metadata.put("bundleId", bundleId);
+        }
+        if (channel != null) {
+            metadata.put("channel", channel);
+        }
+        if (customProperties != null) {
+            Map<String, Object> customPropertiesMap = jsonObjectToMap(customProperties);
+            if (!customPropertiesMap.isEmpty()) {
+                metadata.put("customProperties", customPropertiesMap);
+            }
+        }
+        callback.onSuccess(new FederatedCapacitorSyncResult(metadata));
+    }
+
+    private void notifyFailure(@Nullable LiveUpdateProviderSyncCallback callback, @NonNull Exception exception) {
+        Logger.error(LiveUpdatePlugin.TAG, "Ionic provider sync failed: " + exception.getMessage(), exception);
+        if (callback == null) {
+            return;
+        }
+        String message = exception.getMessage() == null ? LiveUpdatePlugin.ERROR_UNKNOWN_ERROR : exception.getMessage();
+        callback.onFailure(new LiveUpdateProviderError.SyncFailed(message, exception));
+    }
+
+    @NonNull
+    private String getLastSyncedBundleIdKey() {
+        return PREF_PREFIX_LAST_SYNCED_BUNDLE_ID + managerKey;
+    }
+
+    @NonNull
+    private static Map<String, Object> jsonObjectToMap(@NonNull JSONObject jsonObject) {
+        Map<String, Object> map = new HashMap<>();
+        Iterator<String> keys = jsonObject.keys();
+        while (keys.hasNext()) {
+            String key = keys.next();
+            Object value = jsonObject.opt(key);
+            if (value != null && value != JSONObject.NULL) {
+                map.put(key, value);
+            }
+        }
+        return map;
+    }
+}

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

@@ -0,0 +1,41 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.providers.ionic;
+
+import android.content.Context;
+import androidx.annotation.NonNull;
+import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdate;
+import io.ionic.liveupdateprovider.LiveUpdateProvider;
+import io.ionic.liveupdateprovider.LiveUpdateProviderError;
+import io.ionic.liveupdateprovider.LiveUpdateProviderManager;
+import java.util.Map;
+
+/**
+ * Ionic Live Update Provider implementation backed by the Capawesome live update plugin.
+ *
+ * Registered with {@link io.ionic.liveupdateprovider.LiveUpdateProviderRegistry} when the
+ * Capacitor plugin loads, so Federated Capacitor can resolve provider id {@code "capawesome"}
+ * and create managers from the per-shell configuration.
+ */
+public class LiveUpdateIonicProvider implements LiveUpdateProvider {
+
+    public static final String ID = "capawesome";
+
+    @NonNull
+    private final LiveUpdate liveUpdate;
+
+    public LiveUpdateIonicProvider(@NonNull LiveUpdate liveUpdate) {
+        this.liveUpdate = liveUpdate;
+    }
+
+    @NonNull
+    @Override
+    public String getId() {
+        return ID;
+    }
+
+    @NonNull
+    @Override
+    public LiveUpdateProviderManager createManager(@NonNull Context context, @NonNull Map<String, ?> config)
+        throws LiveUpdateProviderError.InvalidConfiguration {
+        return new LiveUpdateIonicManager(context, config, liveUpdate);
+    }
+}

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

@@ -0,0 +1,46 @@
+package io.capawesome.capacitorjs.plugins.liveupdate.providers.ionic;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.Logger;
+import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdate;
+import io.capawesome.capacitorjs.plugins.liveupdate.LiveUpdatePlugin;
+import io.ionic.liveupdateprovider.LiveUpdateProviderRegistry;
+
+/**
+ * Helper that registers the Capawesome live update provider with the Ionic
+ * {@link LiveUpdateProviderRegistry}, but only when the optional
+ * {@code io.ionic:liveupdateprovider} dependency is present at runtime.
+ *
+ * The Gradle build wires the SDK as either {@code implementation} (when the consumer opts in
+ * via {@code capawesomeCapacitorLiveUpdateIncludeIonicProvider = true}) or {@code compileOnly}
+ * (the default). When opted out, the SDK classes are stripped from the consumer APK and the
+ * reflection check below short-circuits registration.
+ */
+public final class LiveUpdateIonicProviderRegistration {
+
+    private LiveUpdateIonicProviderRegistration() {
+        // Static utility — no instances.
+    }
+
+    public static boolean isAvailable() {
+        try {
+            Class.forName("io.ionic.liveupdateprovider.LiveUpdateProviderRegistry");
+            return true;
+        } catch (ClassNotFoundException exception) {
+            return false;
+        }
+    }
+
+    public static void tryRegister(@NonNull LiveUpdate liveUpdate) {
+        try {
+            if (LiveUpdateProviderRegistry.resolve(LiveUpdateIonicProvider.ID) != null) {
+                Logger.debug(LiveUpdatePlugin.TAG, "Ionic provider '" + LiveUpdateIonicProvider.ID + "' already registered.");
+                return;
+            }
+            LiveUpdateProviderRegistry.register(new LiveUpdateIonicProvider(liveUpdate));
+            Logger.debug(LiveUpdatePlugin.TAG, "Registered Ionic provider '" + LiveUpdateIonicProvider.ID + "'.");
+        } catch (Exception exception) {
+            Logger.error(LiveUpdatePlugin.TAG, "Failed to register Ionic provider: " + exception.getMessage(), exception);
+        }
+    }
+}

package/dist/docs.json

@@ -877,7 +877,7 @@
               "name": "since"
             }
           ],
-          "docs": "The unique identifier of the latest bundle.\n\nIf `null`, no bundle is available.",
+          "docs": "The unique identifier of the latest bundle.\n\nOn Capawesome Cloud, this is the ID of the app build artifact.\n\nIf `null`, no bundle is available.",
           "complexTypes": [],
           "type": "string | null"
         },

package/dist/esm/definitions.d.ts

@@ -556,6 +556,8 @@ export interface FetchLatestBundleResult {
     /**
      * The unique identifier of the latest bundle.
      *
+     * On Capawesome Cloud, this is the ID of the app build artifact.
+     *
      * If `null`, no bundle is available.
      *
      * @since 6.6.0

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PluginListenerHandle } from '@capacitor/core';\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    LiveUpdate?: {\n      /**\n       * The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud/).\n       *\n       * This is **NOT** the same as the app identifier (e.g. `com.example.app`).\n       * This is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).\n       *\n       * @since 5.0.0\n       * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'\n       */\n      appId?: string;\n      /**\n       * Whether or not to automatically block bundles that have been rolled back.\n       *\n       * When enabled, the plugin will automatically block bundles that caused a rollback\n       * (up to 100 bundles). When the limit is reached, the oldest blocked bundle is unblocked.\n       * Blocked bundles will be skipped in future sync operations.\n       *\n       * **Attention**: This option has no effect if `readyTimeout` is set to `0`.\n       *\n       * Only available on Android and iOS.\n       *\n       * @since 7.3.0\n       * @default false\n       */\n      autoBlockRolledBackBundles?: boolean;\n      /**\n       * Whether or not to automatically delete unused bundles.\n       *\n       * When enabled, the plugin will automatically delete unused bundles after calling `ready()`.\n       *\n       * @since 5.0.0\n       * @default false\n       */\n      autoDeleteBundles?: boolean;\n      /**\n       * The auto-update strategy for live updates.\n       *\n       * - `none`: Live updates will not be applied automatically.\n       * - `background`: Live updates will be automatically downloaded\n       * and applied in the background at app startup and when the app resumes\n       * (if the last check was more than 15 minutes ago).\n       *\n       * Only available on Android and iOS.\n       *\n       * @since 7.3.0\n       * @default 'none'\n       * @example 'background'\n       */\n      autoUpdateStrategy?: 'none' | 'background';\n      /**\n       * The default channel of the app.\n       *\n       * This can be overridden by `setChannel()`, the `channel` parameter of `sync()`,\n       * or the native channel configuration\n       * (`CapawesomeLiveUpdateDefaultChannel` in `Info.plist` on iOS or `capawesome_live_update_default_channel`\n       * in `strings.xml` on Android).\n       *\n       * @since 6.3.0\n       * @example 'production'\n       */\n      defaultChannel?: string;\n      /**\n       * The timeout in milliseconds for HTTP requests.\n       *\n       * @since 6.4.0\n       * @default 60000\n       */\n      httpTimeout?: number;\n      /**\n       * The public key to verify the integrity of the bundle.\n       *\n       * The public key must be a PEM-encoded RSA public key.\n       *\n       * @since 6.1.0\n       * @example '-----BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDodf1SD0OOn6hIlDuKBza0Ed0OqtwyVJwiyjmE9BJaZ7y8ZUfcF+SKmd0l2cDPM45XIg2tAFux5n29uoKyHwSt+6tCi5CJA5Z1/1eZruRRqABLonV77KS3HUtvOgqRLDnKSV89dYZkM++NwmzOPgIF422mvc+VukcVOBfc8/AHQIDAQAB-----END PUBLIC KEY-----'\n       */\n      publicKey?: string;\n      /**\n       * The timeout in milliseconds to wait for the app to be ready\n       * before resetting to the default bundle.\n       *\n       * It is strongly **recommended** to configure this option (e.g. `10000` ms)\n       * so that the plugin can roll back to the default bundle in case of problems.\n       * If configured, the plugin will wait for the app to call the `ready()`\n       * method before resetting to the default bundle.\n       *\n       * Set to `0` to disable the timeout.\n       *\n       * @since 5.0.0\n       * @default 0\n       * @example 10000\n       */\n      readyTimeout?: number;\n      /**\n       * The API domain of the [Capawesome Cloud](https://cloud.capawesome.io) server **without** scheme or path.\n       *\n       * @since 7.0.0\n       * @default 'api.cloud.capawesome.io'\n       * @example 'api.cloud.capawesome.eu'\n       */\n      serverDomain?: string;\n    };\n  }\n}\n\nexport interface LiveUpdatePlugin {\n  /**\n   * Clear all blocked bundles from the blocked list.\n   *\n   * This removes all bundle identifiers that were automatically blocked\n   * due to rollbacks when `autoBlockRolledBackBundles` is enabled.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  clearBlockedBundles(): Promise<void>;\n  /**\n   * Delete a bundle from the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  deleteBundle(options: DeleteBundleOptions): Promise<void>;\n  /**\n   * Download a bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  downloadBundle(options: DownloadBundleOptions): Promise<void>;\n  /**\n   * Fetch channels from [Capawesome Cloud](https://capawesome.io/cloud/).\n   *\n   * This is primarily intended for development and QA purposes.\n   * It allows you to retrieve a list of available channels so you can\n   * dynamically switch between them using `setChannel(...)`.\n   *\n   * **Attention**: Only works for apps with public channels enabled.\n   * If channels are private, they can still be set using `setChannel(...)`\n   * but won't be returned by this method.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 8.2.0\n   */\n  fetchChannels(options?: FetchChannelsOptions): Promise<FetchChannelsResult>;\n  /**\n   * Fetch the latest bundle using the [Capawesome Cloud](https://capawesome.io/cloud/).\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.6.0\n   */\n  fetchLatestBundle(\n    options?: FetchLatestBundleOptions,\n  ): Promise<FetchLatestBundleResult>;\n  /**\n   * Get all blocked bundle identifiers.\n   *\n   * Returns the list of bundle identifiers that were automatically blocked\n   * due to rollbacks when `autoBlockRolledBackBundles` is enabled.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  getBlockedBundles(): Promise<GetBlockedBundlesResult>;\n  /**\n   * Get all identifiers of bundles that have been downloaded.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   * @deprecated Use `getDownloadedBundles()` instead.\n   */\n  getBundles(): Promise<GetBundlesResult>;\n  /**\n   * Get the channel that is used for the update.\n   *\n   * The channel is resolved in the following order (highest priority first):\n   * 1. `setChannel()` (SharedPreferences on Android / UserDefaults on iOS)\n   * 2. Native config (`CapawesomeLiveUpdateDefaultChannel` in `Info.plist` on iOS or\n   *    `capawesome_live_update_default_channel` in `strings.xml` on Android)\n   * 3. Capacitor config `defaultChannel`\n   *\n   * **Note**: The `channel` parameter of `sync()` takes the highest priority\n   * but is not persisted and therefore not returned by this method.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getChannel(): Promise<GetChannelResult>;\n  /**\n   * Get the runtime configuration.\n   *\n   * Returns the current plugin configuration including any runtime\n   * overrides set via `setConfig()`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  getConfig(): Promise<GetConfigResult>;\n  /**\n   * Get all identifiers of bundles that have been downloaded.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  getDownloadedBundles(): Promise<GetDownloadedBundlesResult>;\n  /**\n   * Get the bundle identifier of the current bundle.\n   * The current bundle is the bundle that is currently used by the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.7.0\n   */\n  getCurrentBundle(): Promise<GetCurrentBundleResult>;\n  /**\n   * Get the custom identifier of the device.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getCustomId(): Promise<GetCustomIdResult>;\n  /**\n   * Get the unique device identifier.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getDeviceId(): Promise<GetDeviceIdResult>;\n  /**\n   * Check whether a sync operation is currently in progress.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  isSyncing(): Promise<IsSyncingResult>;\n  /**\n   * Get the bundle identifier of the next bundle.\n   * The next bundle is the bundle that will be used after calling `reload()`\n   * or restarting the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.7.0\n   */\n  getNextBundle(): Promise<GetNextBundleResult>;\n  /**\n   * Get the version code of the app.\n   *\n   * On **Android**, this is the `versionCode` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleVersion` from the `Info.plist` file.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getVersionCode(): Promise<GetVersionCodeResult>;\n  /**\n   * Get the version name of the app.\n   *\n   * On **Android**, this is the `versionName` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleShortVersionString` from the `Info.plist` file.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getVersionName(): Promise<GetVersionNameResult>;\n  /**\n   * Notify the plugin that the app is ready to use and no rollback is needed.\n   *\n   * **Attention**: This method should be called as soon as the app is ready to use\n   * to prevent the app from being reset to the default bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  ready(): Promise<ReadyResult>;\n  /**\n   * Reload the app to apply the new bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  reload(): Promise<void>;\n  /**\n   * Reset the app to the default bundle.\n   *\n   * Call `reload()` or restart the app to apply the changes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  reset(): Promise<void>;\n  /**\n   * Reset the runtime configuration to the values from the Capacitor config file.\n   *\n   * This clears any runtime configuration set via `setConfig()`.\n   * The changes take effect immediately.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  resetConfig(): Promise<void>;\n  /**\n   * Set the channel to use for the update.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  setChannel(options: SetChannelOptions): Promise<void>;\n  /**\n   * Set the runtime configuration.\n   *\n   * This allows updating plugin configuration options at runtime.\n   * The changes are persisted across app restarts and take effect immediately.\n   *\n   * **Important:** Runtime configuration is automatically reset to default values\n   * whenever the native app is updated to a new version. This ensures that\n   * configuration from previous versions doesn't persist after an app update.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  setConfig(options: SetConfigOptions): Promise<void>;\n  /**\n   * Set the custom identifier of the device.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  setCustomId(options: SetCustomIdOptions): Promise<void>;\n  /**\n   * Set the next bundle to use for the app.\n   *\n   * Call `reload()` or restart the app to apply the changes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.7.0\n   */\n  setNextBundle(options: SetNextBundleOptions): Promise<void>;\n  /**\n   * Automatically download and set the latest bundle for the app using the [Capawesome Cloud](https://capawesome.io/cloud/).\n   *\n   * Call `reload()` or restart the app to apply the changes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  sync(options?: SyncOptions): Promise<SyncResult>;\n  /**\n   * Listen for the download progress of a bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.0.0\n   */\n  addListener(\n    eventName: 'downloadBundleProgress',\n    listenerFunc: DownloadBundleProgressListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for when a bundle is set as the next bundle.\n   *\n   * This event is triggered whenever a bundle is set to be used on the next app restart,\n   * either through automatic updates or manual calls to `setNextBundle()`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.3.0\n   */\n  addListener(\n    eventName: 'nextBundleSet',\n    listenerFunc: NextBundleSetListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for when the app is reloaded.\n   *\n   * This event is triggered after the `reload()` method is called\n   * and the app has been reloaded.\n   *\n   * **Note:** To verify whether an update was successfully applied after a reload,\n   * use the `ready()` method instead. The `ready()` method provides detailed information\n   * about the current bundle, previous bundle, and whether a rollback occurred.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  addListener(\n    eventName: 'reloaded',\n    listenerFunc: ReloadedListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 7.2.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface DeleteBundleOptions {\n  /**\n   * The unique identifier of the bundle to delete.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n}\n\nexport interface DownloadBundleOptions {\n  /**\n   * The artifact type of the bundle.\n   *\n   * @since 6.6.0\n   * @default 'zip'\n   * @example 'manifest'\n   */\n  artifactType?: 'manifest' | 'zip';\n  /**\n   * The unique identifier of the bundle.\n   *\n   * **Attention**: The value `public` is reserved and cannot be used as a bundle identifier.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n  /**\n   * The checksum of the self-hosted bundle as a SHA-256 hash\n   * in hex format to verify the integrity of the bundle.\n   *\n   * **Attention**: Only supported for the `zip` artifact type.\n   *\n   * @since 7.1.0\n   */\n  checksum?: string;\n  /**\n   * The signature of the self-hosted bundle as a signed SHA-256 hash\n   * in base64 format to verify the integrity of the bundle.\n   *\n   * **Attention**: Only supported for the `zip` artifact type.\n   *\n   * @since 7.1.0\n   */\n  signature?: string;\n  /**\n   * The URL of the bundle to download.\n   *\n   * For the `zip` artifact type, the URL must point to a ZIP file.\n   * For the `manifest` artifact type, the URL serves as the base URL\n   * to download the individual files. For example, if the URL is\n   * `https://example.com/download`, the plugin will download the file\n   * with the href `index.html` from `https://example.com/download?href=index.html`.\n   *\n   * To **verify the integrity** of the file, the server should return\n   * a `X-Checksum` header with the SHA-256 hash in hex format.\n   *\n   * To **verify the signature** of the file, the server should return\n   * a `X-Signature` header with the signed SHA-256 hash in base64 format.\n   *\n   * @since 5.0.0\n   * @example 'https://example.com/bundle.zip'\n   */\n  url: string;\n}\n\n/**\n * @since 8.2.0\n */\nexport interface FetchChannelsOptions {\n  /**\n   * The maximum number of channels to return.\n   *\n   * @since 8.2.0\n   * @default 50\n   */\n  limit?: number;\n  /**\n   * The number of channels to skip.\n   *\n   * @since 8.2.0\n   * @default 0\n   */\n  offset?: number;\n  /**\n   * The query to filter channels by name.\n   *\n   * @since 8.2.0\n   */\n  query?: string;\n}\n\n/**\n * @since 8.2.0\n */\nexport interface FetchChannelsResult {\n  /**\n   * The list of channels.\n   *\n   * @since 8.2.0\n   */\n  channels: Channel[];\n}\n\n/**\n * @since 8.2.0\n */\nexport interface Channel {\n  /**\n   * The unique identifier of the channel.\n   *\n   * @since 8.2.0\n   */\n  id: string;\n  /**\n   * The name of the channel.\n   *\n   * @since 8.2.0\n   */\n  name: string;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface FetchLatestBundleOptions {\n  /**\n   * The name of the channel where the latest bundle is fetched from.\n   *\n   * @since 6.7.0\n   */\n  channel?: string;\n}\n\n/**\n * @since 6.6.0\n */\nexport interface FetchLatestBundleResult {\n  /**\n   * The artifact type of the bundle.\n   *\n   * @since 6.7.0\n   */\n  artifactType?: 'manifest' | 'zip';\n  /**\n   * The unique identifier of the latest bundle.\n   *\n   * If `null`, no bundle is available.\n   *\n   * @since 6.6.0\n   */\n  bundleId: string | null;\n  /**\n   * The checksum of the latest bundle if the bundle is self-hosted.\n   *\n   * If the bundle is hosted on Capawesome Cloud, the checksum will be\n   * returned as response header when downloading the bundle.\n   *\n   * @since 7.1.0\n   */\n  checksum?: string;\n  /**\n   * Custom properties that are associated with the latest bundle.\n   *\n   * @since 7.0.0\n   * @example { \"key\": \"value\" }\n   */\n  customProperties?: { [key: string]: string };\n  /**\n   * The URL of the latest bundle to download.\n   * Pass this URL to the `downloadBundle(...)` method to download the bundle.\n   *\n   * @since 6.7.0\n   */\n  downloadUrl?: string;\n  /**\n   * The signature of the latest bundle if the bundle is self-hosted.\n   *\n   * If the bundle is hosted on Capawesome Cloud, the signature will be\n   * returned as response header when downloading the bundle.\n   *\n   * @since 7.1.0\n   */\n  signature?: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetBundleResult {\n  /**\n   * The unique identifier of the active bundle.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface GetBlockedBundlesResult {\n  /**\n   * An array of unique identifiers of all blocked bundles.\n   *\n   * @since 7.4.0\n   */\n  bundleIds: string[];\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetBundlesResult {\n  /**\n   * An array of unique identifiers of all available bundles.\n   *\n   * @since 5.0.0\n   */\n  bundleIds: string[];\n}\n\n/**\n * @since 7.4.0\n */\nexport interface GetDownloadedBundlesResult {\n  /**\n   * An array of unique identifiers of all downloaded bundles.\n   *\n   * @since 7.4.0\n   */\n  bundleIds: string[];\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetChannelResult {\n  /**\n   * The channel name.\n   *\n   * If `null`, the app is using the default channel.\n   *\n   * @since 5.0.0\n   * @example 'production'\n   */\n  channel: string | null;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface GetConfigResult {\n  /**\n   * The app ID used to identify the app.\n   *\n   * If `null`, no app ID is configured.\n   *\n   * @since 7.4.0\n   * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'\n   */\n  appId: string | null;\n  /**\n   * The auto-update strategy for live updates.\n   *\n   * @since 7.4.0\n   * @example 'background'\n   */\n  autoUpdateStrategy: 'none' | 'background';\n}\n\n/**\n * @since 6.7.0\n */\nexport interface GetCurrentBundleResult {\n  /**\n   * The unique identifier of the current bundle.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 6.7.0\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetDeviceIdResult {\n  /**\n   * The unique identifier of the device.\n   *\n   * On iOS, [`identifierForVendor`](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor) is used.\n   * The value of this property is the same for apps that come from the same vendor running on the same device.\n   *\n   * @since 5.0.0\n   *\n   * @example '50d2a548-80b7-4dad-adc7-97c0e79d8a89'\n   */\n  deviceId: string;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface IsSyncingResult {\n  /**\n   * Whether a sync operation is currently in progress.\n   *\n   * @since 7.4.0\n   */\n  syncing: boolean;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface GetNextBundleResult {\n  /**\n   * The unique identifier of the next bundle.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 6.7.0\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetVersionCodeResult {\n  /**\n   * The version code of the app.\n   *\n   * On **Android**, this is the `versionCode` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleVersion` from the `Info.plist` file.\n   *\n   * @since 5.0.0\n   * @example \"1\"\n   */\n  versionCode: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetVersionNameResult {\n  /**\n   * The version name of the app.\n   *\n   * On **Android**, this is the `versionName` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleShortVersionString` from the `Info.plist` file.\n   *\n   * @since 5.0.0\n   * @example \"1.0.0\"\n   */\n  versionName: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetCustomIdResult {\n  /**\n   * The custom identifier of the device.\n   *\n   * If `null`, no custom identifier is set.\n   *\n   * @since 5.0.0\n   * @example '50d2a548-80b7-4dad-adc7-97c0e79d8a89'\n   */\n  customId: string | null;\n}\n\n/**\n * @since 7.0.0\n */\nexport interface ReadyResult {\n  /**\n   * The identifier of the previous bundle used.\n   *\n   * If `null`, the default bundle was used.\n   *\n   * @since 7.0.0\n   */\n  previousBundleId: string | null;\n  /**\n   * The identifier of the current bundle used.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 7.0.0\n   */\n  currentBundleId: string | null;\n  /**\n   * Whether or not the app was reset to the default bundle.\n   *\n   * @since 7.0.0\n   */\n  rollback: boolean;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetBundleOptions {\n  /**\n   * The unique identifier of the bundle to use.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetChannelOptions {\n  /**\n   * The channel name.\n   *\n   * Set `null` to remove the channel.\n   *\n   * @since 5.0.0\n   */\n  channel: string | null;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface SetConfigOptions {\n  /**\n   * The app ID used to identify the app.\n   *\n   * Set `null` to reset to the value from the Capacitor config file.\n   *\n   * @since 7.4.0\n   * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'\n   */\n  appId?: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetCustomIdOptions {\n  /**\n   * The custom identifier of the device.\n   *\n   * Set `null` to remove the custom identifier.\n   *\n   * @since 5.0.0\n   */\n  customId: string | null;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface SetNextBundleOptions {\n  /**\n   * The unique identifier of the bundle to use.\n   *\n   * Set `null` to use the default bundle (same as calling `reset()`).\n   *\n   * @since 6.7.0\n   * @example '1.0.0'\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface SyncOptions {\n  /**\n   * The name of the channel where the latest bundle is fetched from.\n   *\n   * @since 6.7.0\n   */\n  channel?: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SyncResult {\n  /**\n   * The identifier of the next bundle to use.\n   *\n   * If `null`, the app is up-to-date and no new bundle is available.\n   *\n   * @since 5.0.0\n   */\n  nextBundleId: string | null;\n}\n\n/**\n * Listener for the download progress of a bundle.\n *\n * @since 7.0.0\n */\nexport type DownloadBundleProgressListener = (\n  event: DownloadBundleProgressEvent,\n) => void;\n\n/**\n * Event that is triggered when the download progress of a bundle changes.\n *\n * @since 7.0.0\n */\nexport interface DownloadBundleProgressEvent {\n  /**\n   * The unique identifier of the bundle that is being downloaded.\n   *\n   * @since 7.0.0\n   */\n  bundleId: string;\n  /**\n   * The number of bytes that have been downloaded.\n   *\n   * @since 7.0.0\n   */\n  downloadedBytes: number;\n  /**\n   * The progress of the download in percent as a value between `0` and `1`.\n   *\n   * @since 7.0.0\n   * @example 0.5\n   */\n  progress: number;\n  /**\n   * The total number of bytes to download.\n   *\n   * @since 7.0.0\n   */\n  totalBytes: number;\n}\n\n/**\n * Listener for when a bundle is set as the next bundle.\n *\n * @since 7.3.0\n */\nexport type NextBundleSetListener = (event: NextBundleSetEvent) => void;\n\n/**\n * Event that is triggered when a bundle is set as the next bundle.\n *\n * @since 7.3.0\n */\nexport interface NextBundleSetEvent {\n  /**\n   * The unique identifier of the bundle that is set as the next bundle.\n   *\n   * If `null`, the default bundle will be used.\n   *\n   * @since 7.3.0\n   * @example '1.0.0'\n   */\n  bundleId: string | null;\n}\n\n/**\n * Listener for when the app is reloaded.\n *\n * @since 7.4.0\n */\nexport type ReloadedListener = () => void;\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PluginListenerHandle } from '@capacitor/core';\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    LiveUpdate?: {\n      /**\n       * The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud/).\n       *\n       * This is **NOT** the same as the app identifier (e.g. `com.example.app`).\n       * This is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).\n       *\n       * @since 5.0.0\n       * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'\n       */\n      appId?: string;\n      /**\n       * Whether or not to automatically block bundles that have been rolled back.\n       *\n       * When enabled, the plugin will automatically block bundles that caused a rollback\n       * (up to 100 bundles). When the limit is reached, the oldest blocked bundle is unblocked.\n       * Blocked bundles will be skipped in future sync operations.\n       *\n       * **Attention**: This option has no effect if `readyTimeout` is set to `0`.\n       *\n       * Only available on Android and iOS.\n       *\n       * @since 7.3.0\n       * @default false\n       */\n      autoBlockRolledBackBundles?: boolean;\n      /**\n       * Whether or not to automatically delete unused bundles.\n       *\n       * When enabled, the plugin will automatically delete unused bundles after calling `ready()`.\n       *\n       * @since 5.0.0\n       * @default false\n       */\n      autoDeleteBundles?: boolean;\n      /**\n       * The auto-update strategy for live updates.\n       *\n       * - `none`: Live updates will not be applied automatically.\n       * - `background`: Live updates will be automatically downloaded\n       * and applied in the background at app startup and when the app resumes\n       * (if the last check was more than 15 minutes ago).\n       *\n       * Only available on Android and iOS.\n       *\n       * @since 7.3.0\n       * @default 'none'\n       * @example 'background'\n       */\n      autoUpdateStrategy?: 'none' | 'background';\n      /**\n       * The default channel of the app.\n       *\n       * This can be overridden by `setChannel()`, the `channel` parameter of `sync()`,\n       * or the native channel configuration\n       * (`CapawesomeLiveUpdateDefaultChannel` in `Info.plist` on iOS or `capawesome_live_update_default_channel`\n       * in `strings.xml` on Android).\n       *\n       * @since 6.3.0\n       * @example 'production'\n       */\n      defaultChannel?: string;\n      /**\n       * The timeout in milliseconds for HTTP requests.\n       *\n       * @since 6.4.0\n       * @default 60000\n       */\n      httpTimeout?: number;\n      /**\n       * The public key to verify the integrity of the bundle.\n       *\n       * The public key must be a PEM-encoded RSA public key.\n       *\n       * @since 6.1.0\n       * @example '-----BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDodf1SD0OOn6hIlDuKBza0Ed0OqtwyVJwiyjmE9BJaZ7y8ZUfcF+SKmd0l2cDPM45XIg2tAFux5n29uoKyHwSt+6tCi5CJA5Z1/1eZruRRqABLonV77KS3HUtvOgqRLDnKSV89dYZkM++NwmzOPgIF422mvc+VukcVOBfc8/AHQIDAQAB-----END PUBLIC KEY-----'\n       */\n      publicKey?: string;\n      /**\n       * The timeout in milliseconds to wait for the app to be ready\n       * before resetting to the default bundle.\n       *\n       * It is strongly **recommended** to configure this option (e.g. `10000` ms)\n       * so that the plugin can roll back to the default bundle in case of problems.\n       * If configured, the plugin will wait for the app to call the `ready()`\n       * method before resetting to the default bundle.\n       *\n       * Set to `0` to disable the timeout.\n       *\n       * @since 5.0.0\n       * @default 0\n       * @example 10000\n       */\n      readyTimeout?: number;\n      /**\n       * The API domain of the [Capawesome Cloud](https://cloud.capawesome.io) server **without** scheme or path.\n       *\n       * @since 7.0.0\n       * @default 'api.cloud.capawesome.io'\n       * @example 'api.cloud.capawesome.eu'\n       */\n      serverDomain?: string;\n    };\n  }\n}\n\nexport interface LiveUpdatePlugin {\n  /**\n   * Clear all blocked bundles from the blocked list.\n   *\n   * This removes all bundle identifiers that were automatically blocked\n   * due to rollbacks when `autoBlockRolledBackBundles` is enabled.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  clearBlockedBundles(): Promise<void>;\n  /**\n   * Delete a bundle from the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  deleteBundle(options: DeleteBundleOptions): Promise<void>;\n  /**\n   * Download a bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  downloadBundle(options: DownloadBundleOptions): Promise<void>;\n  /**\n   * Fetch channels from [Capawesome Cloud](https://capawesome.io/cloud/).\n   *\n   * This is primarily intended for development and QA purposes.\n   * It allows you to retrieve a list of available channels so you can\n   * dynamically switch between them using `setChannel(...)`.\n   *\n   * **Attention**: Only works for apps with public channels enabled.\n   * If channels are private, they can still be set using `setChannel(...)`\n   * but won't be returned by this method.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 8.2.0\n   */\n  fetchChannels(options?: FetchChannelsOptions): Promise<FetchChannelsResult>;\n  /**\n   * Fetch the latest bundle using the [Capawesome Cloud](https://capawesome.io/cloud/).\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.6.0\n   */\n  fetchLatestBundle(\n    options?: FetchLatestBundleOptions,\n  ): Promise<FetchLatestBundleResult>;\n  /**\n   * Get all blocked bundle identifiers.\n   *\n   * Returns the list of bundle identifiers that were automatically blocked\n   * due to rollbacks when `autoBlockRolledBackBundles` is enabled.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  getBlockedBundles(): Promise<GetBlockedBundlesResult>;\n  /**\n   * Get all identifiers of bundles that have been downloaded.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   * @deprecated Use `getDownloadedBundles()` instead.\n   */\n  getBundles(): Promise<GetBundlesResult>;\n  /**\n   * Get the channel that is used for the update.\n   *\n   * The channel is resolved in the following order (highest priority first):\n   * 1. `setChannel()` (SharedPreferences on Android / UserDefaults on iOS)\n   * 2. Native config (`CapawesomeLiveUpdateDefaultChannel` in `Info.plist` on iOS or\n   *    `capawesome_live_update_default_channel` in `strings.xml` on Android)\n   * 3. Capacitor config `defaultChannel`\n   *\n   * **Note**: The `channel` parameter of `sync()` takes the highest priority\n   * but is not persisted and therefore not returned by this method.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getChannel(): Promise<GetChannelResult>;\n  /**\n   * Get the runtime configuration.\n   *\n   * Returns the current plugin configuration including any runtime\n   * overrides set via `setConfig()`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  getConfig(): Promise<GetConfigResult>;\n  /**\n   * Get all identifiers of bundles that have been downloaded.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  getDownloadedBundles(): Promise<GetDownloadedBundlesResult>;\n  /**\n   * Get the bundle identifier of the current bundle.\n   * The current bundle is the bundle that is currently used by the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.7.0\n   */\n  getCurrentBundle(): Promise<GetCurrentBundleResult>;\n  /**\n   * Get the custom identifier of the device.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getCustomId(): Promise<GetCustomIdResult>;\n  /**\n   * Get the unique device identifier.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getDeviceId(): Promise<GetDeviceIdResult>;\n  /**\n   * Check whether a sync operation is currently in progress.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  isSyncing(): Promise<IsSyncingResult>;\n  /**\n   * Get the bundle identifier of the next bundle.\n   * The next bundle is the bundle that will be used after calling `reload()`\n   * or restarting the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.7.0\n   */\n  getNextBundle(): Promise<GetNextBundleResult>;\n  /**\n   * Get the version code of the app.\n   *\n   * On **Android**, this is the `versionCode` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleVersion` from the `Info.plist` file.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getVersionCode(): Promise<GetVersionCodeResult>;\n  /**\n   * Get the version name of the app.\n   *\n   * On **Android**, this is the `versionName` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleShortVersionString` from the `Info.plist` file.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getVersionName(): Promise<GetVersionNameResult>;\n  /**\n   * Notify the plugin that the app is ready to use and no rollback is needed.\n   *\n   * **Attention**: This method should be called as soon as the app is ready to use\n   * to prevent the app from being reset to the default bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  ready(): Promise<ReadyResult>;\n  /**\n   * Reload the app to apply the new bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  reload(): Promise<void>;\n  /**\n   * Reset the app to the default bundle.\n   *\n   * Call `reload()` or restart the app to apply the changes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  reset(): Promise<void>;\n  /**\n   * Reset the runtime configuration to the values from the Capacitor config file.\n   *\n   * This clears any runtime configuration set via `setConfig()`.\n   * The changes take effect immediately.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  resetConfig(): Promise<void>;\n  /**\n   * Set the channel to use for the update.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  setChannel(options: SetChannelOptions): Promise<void>;\n  /**\n   * Set the runtime configuration.\n   *\n   * This allows updating plugin configuration options at runtime.\n   * The changes are persisted across app restarts and take effect immediately.\n   *\n   * **Important:** Runtime configuration is automatically reset to default values\n   * whenever the native app is updated to a new version. This ensures that\n   * configuration from previous versions doesn't persist after an app update.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  setConfig(options: SetConfigOptions): Promise<void>;\n  /**\n   * Set the custom identifier of the device.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  setCustomId(options: SetCustomIdOptions): Promise<void>;\n  /**\n   * Set the next bundle to use for the app.\n   *\n   * Call `reload()` or restart the app to apply the changes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 6.7.0\n   */\n  setNextBundle(options: SetNextBundleOptions): Promise<void>;\n  /**\n   * Automatically download and set the latest bundle for the app using the [Capawesome Cloud](https://capawesome.io/cloud/).\n   *\n   * Call `reload()` or restart the app to apply the changes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  sync(options?: SyncOptions): Promise<SyncResult>;\n  /**\n   * Listen for the download progress of a bundle.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.0.0\n   */\n  addListener(\n    eventName: 'downloadBundleProgress',\n    listenerFunc: DownloadBundleProgressListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for when a bundle is set as the next bundle.\n   *\n   * This event is triggered whenever a bundle is set to be used on the next app restart,\n   * either through automatic updates or manual calls to `setNextBundle()`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.3.0\n   */\n  addListener(\n    eventName: 'nextBundleSet',\n    listenerFunc: NextBundleSetListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for when the app is reloaded.\n   *\n   * This event is triggered after the `reload()` method is called\n   * and the app has been reloaded.\n   *\n   * **Note:** To verify whether an update was successfully applied after a reload,\n   * use the `ready()` method instead. The `ready()` method provides detailed information\n   * about the current bundle, previous bundle, and whether a rollback occurred.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 7.4.0\n   */\n  addListener(\n    eventName: 'reloaded',\n    listenerFunc: ReloadedListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 7.2.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface DeleteBundleOptions {\n  /**\n   * The unique identifier of the bundle to delete.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n}\n\nexport interface DownloadBundleOptions {\n  /**\n   * The artifact type of the bundle.\n   *\n   * @since 6.6.0\n   * @default 'zip'\n   * @example 'manifest'\n   */\n  artifactType?: 'manifest' | 'zip';\n  /**\n   * The unique identifier of the bundle.\n   *\n   * **Attention**: The value `public` is reserved and cannot be used as a bundle identifier.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n  /**\n   * The checksum of the self-hosted bundle as a SHA-256 hash\n   * in hex format to verify the integrity of the bundle.\n   *\n   * **Attention**: Only supported for the `zip` artifact type.\n   *\n   * @since 7.1.0\n   */\n  checksum?: string;\n  /**\n   * The signature of the self-hosted bundle as a signed SHA-256 hash\n   * in base64 format to verify the integrity of the bundle.\n   *\n   * **Attention**: Only supported for the `zip` artifact type.\n   *\n   * @since 7.1.0\n   */\n  signature?: string;\n  /**\n   * The URL of the bundle to download.\n   *\n   * For the `zip` artifact type, the URL must point to a ZIP file.\n   * For the `manifest` artifact type, the URL serves as the base URL\n   * to download the individual files. For example, if the URL is\n   * `https://example.com/download`, the plugin will download the file\n   * with the href `index.html` from `https://example.com/download?href=index.html`.\n   *\n   * To **verify the integrity** of the file, the server should return\n   * a `X-Checksum` header with the SHA-256 hash in hex format.\n   *\n   * To **verify the signature** of the file, the server should return\n   * a `X-Signature` header with the signed SHA-256 hash in base64 format.\n   *\n   * @since 5.0.0\n   * @example 'https://example.com/bundle.zip'\n   */\n  url: string;\n}\n\n/**\n * @since 8.2.0\n */\nexport interface FetchChannelsOptions {\n  /**\n   * The maximum number of channels to return.\n   *\n   * @since 8.2.0\n   * @default 50\n   */\n  limit?: number;\n  /**\n   * The number of channels to skip.\n   *\n   * @since 8.2.0\n   * @default 0\n   */\n  offset?: number;\n  /**\n   * The query to filter channels by name.\n   *\n   * @since 8.2.0\n   */\n  query?: string;\n}\n\n/**\n * @since 8.2.0\n */\nexport interface FetchChannelsResult {\n  /**\n   * The list of channels.\n   *\n   * @since 8.2.0\n   */\n  channels: Channel[];\n}\n\n/**\n * @since 8.2.0\n */\nexport interface Channel {\n  /**\n   * The unique identifier of the channel.\n   *\n   * @since 8.2.0\n   */\n  id: string;\n  /**\n   * The name of the channel.\n   *\n   * @since 8.2.0\n   */\n  name: string;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface FetchLatestBundleOptions {\n  /**\n   * The name of the channel where the latest bundle is fetched from.\n   *\n   * @since 6.7.0\n   */\n  channel?: string;\n}\n\n/**\n * @since 6.6.0\n */\nexport interface FetchLatestBundleResult {\n  /**\n   * The artifact type of the bundle.\n   *\n   * @since 6.7.0\n   */\n  artifactType?: 'manifest' | 'zip';\n  /**\n   * The unique identifier of the latest bundle.\n   *\n   * On Capawesome Cloud, this is the ID of the app build artifact.\n   *\n   * If `null`, no bundle is available.\n   *\n   * @since 6.6.0\n   */\n  bundleId: string | null;\n  /**\n   * The checksum of the latest bundle if the bundle is self-hosted.\n   *\n   * If the bundle is hosted on Capawesome Cloud, the checksum will be\n   * returned as response header when downloading the bundle.\n   *\n   * @since 7.1.0\n   */\n  checksum?: string;\n  /**\n   * Custom properties that are associated with the latest bundle.\n   *\n   * @since 7.0.0\n   * @example { \"key\": \"value\" }\n   */\n  customProperties?: { [key: string]: string };\n  /**\n   * The URL of the latest bundle to download.\n   * Pass this URL to the `downloadBundle(...)` method to download the bundle.\n   *\n   * @since 6.7.0\n   */\n  downloadUrl?: string;\n  /**\n   * The signature of the latest bundle if the bundle is self-hosted.\n   *\n   * If the bundle is hosted on Capawesome Cloud, the signature will be\n   * returned as response header when downloading the bundle.\n   *\n   * @since 7.1.0\n   */\n  signature?: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetBundleResult {\n  /**\n   * The unique identifier of the active bundle.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface GetBlockedBundlesResult {\n  /**\n   * An array of unique identifiers of all blocked bundles.\n   *\n   * @since 7.4.0\n   */\n  bundleIds: string[];\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetBundlesResult {\n  /**\n   * An array of unique identifiers of all available bundles.\n   *\n   * @since 5.0.0\n   */\n  bundleIds: string[];\n}\n\n/**\n * @since 7.4.0\n */\nexport interface GetDownloadedBundlesResult {\n  /**\n   * An array of unique identifiers of all downloaded bundles.\n   *\n   * @since 7.4.0\n   */\n  bundleIds: string[];\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetChannelResult {\n  /**\n   * The channel name.\n   *\n   * If `null`, the app is using the default channel.\n   *\n   * @since 5.0.0\n   * @example 'production'\n   */\n  channel: string | null;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface GetConfigResult {\n  /**\n   * The app ID used to identify the app.\n   *\n   * If `null`, no app ID is configured.\n   *\n   * @since 7.4.0\n   * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'\n   */\n  appId: string | null;\n  /**\n   * The auto-update strategy for live updates.\n   *\n   * @since 7.4.0\n   * @example 'background'\n   */\n  autoUpdateStrategy: 'none' | 'background';\n}\n\n/**\n * @since 6.7.0\n */\nexport interface GetCurrentBundleResult {\n  /**\n   * The unique identifier of the current bundle.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 6.7.0\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetDeviceIdResult {\n  /**\n   * The unique identifier of the device.\n   *\n   * On iOS, [`identifierForVendor`](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor) is used.\n   * The value of this property is the same for apps that come from the same vendor running on the same device.\n   *\n   * @since 5.0.0\n   *\n   * @example '50d2a548-80b7-4dad-adc7-97c0e79d8a89'\n   */\n  deviceId: string;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface IsSyncingResult {\n  /**\n   * Whether a sync operation is currently in progress.\n   *\n   * @since 7.4.0\n   */\n  syncing: boolean;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface GetNextBundleResult {\n  /**\n   * The unique identifier of the next bundle.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 6.7.0\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetVersionCodeResult {\n  /**\n   * The version code of the app.\n   *\n   * On **Android**, this is the `versionCode` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleVersion` from the `Info.plist` file.\n   *\n   * @since 5.0.0\n   * @example \"1\"\n   */\n  versionCode: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetVersionNameResult {\n  /**\n   * The version name of the app.\n   *\n   * On **Android**, this is the `versionName` from the `android/app/build.gradle` file.\n   * On **iOS**, this is the `CFBundleShortVersionString` from the `Info.plist` file.\n   *\n   * @since 5.0.0\n   * @example \"1.0.0\"\n   */\n  versionName: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface GetCustomIdResult {\n  /**\n   * The custom identifier of the device.\n   *\n   * If `null`, no custom identifier is set.\n   *\n   * @since 5.0.0\n   * @example '50d2a548-80b7-4dad-adc7-97c0e79d8a89'\n   */\n  customId: string | null;\n}\n\n/**\n * @since 7.0.0\n */\nexport interface ReadyResult {\n  /**\n   * The identifier of the previous bundle used.\n   *\n   * If `null`, the default bundle was used.\n   *\n   * @since 7.0.0\n   */\n  previousBundleId: string | null;\n  /**\n   * The identifier of the current bundle used.\n   *\n   * If `null`, the default bundle is being used.\n   *\n   * @since 7.0.0\n   */\n  currentBundleId: string | null;\n  /**\n   * Whether or not the app was reset to the default bundle.\n   *\n   * @since 7.0.0\n   */\n  rollback: boolean;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetBundleOptions {\n  /**\n   * The unique identifier of the bundle to use.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetChannelOptions {\n  /**\n   * The channel name.\n   *\n   * Set `null` to remove the channel.\n   *\n   * @since 5.0.0\n   */\n  channel: string | null;\n}\n\n/**\n * @since 7.4.0\n */\nexport interface SetConfigOptions {\n  /**\n   * The app ID used to identify the app.\n   *\n   * Set `null` to reset to the value from the Capacitor config file.\n   *\n   * @since 7.4.0\n   * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'\n   */\n  appId?: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetCustomIdOptions {\n  /**\n   * The custom identifier of the device.\n   *\n   * Set `null` to remove the custom identifier.\n   *\n   * @since 5.0.0\n   */\n  customId: string | null;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface SetNextBundleOptions {\n  /**\n   * The unique identifier of the bundle to use.\n   *\n   * Set `null` to use the default bundle (same as calling `reset()`).\n   *\n   * @since 6.7.0\n   * @example '1.0.0'\n   */\n  bundleId: string | null;\n}\n\n/**\n * @since 6.7.0\n */\nexport interface SyncOptions {\n  /**\n   * The name of the channel where the latest bundle is fetched from.\n   *\n   * @since 6.7.0\n   */\n  channel?: string;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SyncResult {\n  /**\n   * The identifier of the next bundle to use.\n   *\n   * If `null`, the app is up-to-date and no new bundle is available.\n   *\n   * @since 5.0.0\n   */\n  nextBundleId: string | null;\n}\n\n/**\n * Listener for the download progress of a bundle.\n *\n * @since 7.0.0\n */\nexport type DownloadBundleProgressListener = (\n  event: DownloadBundleProgressEvent,\n) => void;\n\n/**\n * Event that is triggered when the download progress of a bundle changes.\n *\n * @since 7.0.0\n */\nexport interface DownloadBundleProgressEvent {\n  /**\n   * The unique identifier of the bundle that is being downloaded.\n   *\n   * @since 7.0.0\n   */\n  bundleId: string;\n  /**\n   * The number of bytes that have been downloaded.\n   *\n   * @since 7.0.0\n   */\n  downloadedBytes: number;\n  /**\n   * The progress of the download in percent as a value between `0` and `1`.\n   *\n   * @since 7.0.0\n   * @example 0.5\n   */\n  progress: number;\n  /**\n   * The total number of bytes to download.\n   *\n   * @since 7.0.0\n   */\n  totalBytes: number;\n}\n\n/**\n * Listener for when a bundle is set as the next bundle.\n *\n * @since 7.3.0\n */\nexport type NextBundleSetListener = (event: NextBundleSetEvent) => void;\n\n/**\n * Event that is triggered when a bundle is set as the next bundle.\n *\n * @since 7.3.0\n */\nexport interface NextBundleSetEvent {\n  /**\n   * The unique identifier of the bundle that is set as the next bundle.\n   *\n   * If `null`, the default bundle will be used.\n   *\n   * @since 7.3.0\n   * @example '1.0.0'\n   */\n  bundleId: string | null;\n}\n\n/**\n * Listener for when the app is reloaded.\n *\n * @since 7.4.0\n */\nexport type ReloadedListener = () => void;\n"]}

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

@@ -2,16 +2,28 @@ 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

@@ -18,6 +18,30 @@ 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,6 +3,7 @@ import Foundation
 public enum CustomError: Error {
     case appIdMissing
     case bundleAlreadyExists
+    case bundleDirectoryNotFound
     case bundleIdMissing
     case bundleIndexHtmlMissing
     case bundleNotFound
@@ -12,7 +13,9 @@ public enum CustomError: Error {
     case checksumMismatch
     case customIdMissing
     case downloadFailed
+    case downloadUrlMissing
     case httpTimeout
+    case managerKeyMissing
     case signatureMissing
     case signatureVerificationFailed
     case syncInProgress
@@ -27,6 +30,8 @@ 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:
@@ -45,8 +50,12 @@ 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 .signatureMissing:
             return NSLocalizedString("Bundle does not contain a signature.", comment: "signatureMissing")
         case .signatureVerificationFailed:

package/ios/Plugin/LiveUpdate.swift

@@ -161,6 +161,14 @@ 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()
 
@@ -580,6 +588,9 @@ 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()
@@ -591,7 +602,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/\(getAppId() ?? "")/bundles/latest")!
+        var urlComponents = URLComponents(string: "https://\(config.serverDomain)/v1/apps/\(appId)/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)

package/ios/Plugin/LiveUpdatePlugin.swift

@@ -1,5 +1,8 @@
 import Foundation
 import Capacitor
+#if CAPAWESOME_INCLUDE_IONIC_PROVIDER
+import LiveUpdateProvider
+#endif
 
 /**
  * Please read the Capacitor iOS Plugin Development Guide
@@ -56,6 +59,22 @@ public class LiveUpdatePlugin: CAPPlugin, CAPBridgedPlugin {
         // Notify implementation about load
         implementation?.handleLoad()
 
+        // Register the Ionic Live Update Provider when the optional SDK is linked.
+        #if CAPAWESOME_INCLUDE_IONIC_PROVIDER
+        if let implementation = implementation {
+            do {
+                if LiveUpdateProviderRegistry.shared.resolve(LiveUpdateIonicProvider.id) == nil {
+                    try LiveUpdateProviderRegistry.shared.register(
+                        LiveUpdateIonicProvider(liveUpdate: implementation)
+                    )
+                    CAPLog.print("[", LiveUpdatePlugin.tag, "] Registered Ionic provider '\(LiveUpdateIonicProvider.id)'.")
+                }
+            } catch {
+                CAPLog.print("[", LiveUpdatePlugin.tag, "] Failed to register Ionic provider: ", error.localizedDescription)
+            }
+        }
+        #endif
+
         // Register for app resume notifications
         NotificationCenter.default.addObserver(
             self,

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

@@ -0,0 +1,118 @@
+#if CAPAWESOME_INCLUDE_IONIC_PROVIDER
+import Foundation
+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 config 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: LiveUpdateManaging {
+    private static let userDefaultsPrefix = "CapawesomeLiveUpdateIonicProvider.lastSyncedBundleId."
+
+    private let appId: String?
+    private let channel: String?
+    private let liveUpdate: LiveUpdate
+    private let managerKey: String
+
+    public private(set) var latestAppDirectory: URL?
+
+    public init(config: [String: Any], liveUpdate: LiveUpdate) throws {
+        guard let managerKey = config["managerKey"] as? String, !managerKey.isEmpty else {
+            throw LiveUpdateProviderError.invalidConfiguration(
+                CustomError.managerKeyMissing.localizedDescription,
+                underlyingError: nil
+            )
+        }
+        self.managerKey = managerKey
+        self.appId = config["appId"] as? String
+        self.channel = config["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 LiveUpdateProvider.SyncResult {
+        do {
+            let fetchOptions = FetchLatestBundleOptions(appId: appId, channel: channel)
+            let result = try await liveUpdate.fetchLatestBundle(fetchOptions)
+
+            guard let bundleId = result.getBundleId() else {
+                // No update available; report success without changing state.
+                return DefaultFederatedCapacitorSyncResult(metadata: buildMetadata(bundleId: nil, customProperties: 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 DefaultFederatedCapacitorSyncResult(
+                    metadata: buildMetadata(bundleId: bundleId, customProperties: result.getCustomProperties())
+                )
+            }
+
+            // Otherwise, download and then apply.
+            guard let downloadUrl = result.getDownloadUrl(), !downloadUrl.isEmpty else {
+                throw LiveUpdateProviderError.syncFailed(
+                    CustomError.downloadUrlMissing.localizedDescription,
+                    underlyingError: nil
+                )
+            }
+            let artifactType = result.getArtifactType() ?? "zip"
+            let downloadOptions = DownloadBundleOptions(
+                artifactType: artifactType,
+                bundleId: bundleId,
+                checksum: result.getChecksum(),
+                signature: result.getSignature(),
+                url: downloadUrl
+            )
+            try await liveUpdate.downloadBundle(downloadOptions)
+
+            guard let downloadedDirectory = liveUpdate.getBundleDirectory(bundleId: bundleId) else {
+                throw LiveUpdateProviderError.syncFailed(
+                    CustomError.bundleDirectoryNotFound.localizedDescription,
+                    underlyingError: nil
+                )
+            }
+            applySyncedBundle(bundleId: bundleId, directory: downloadedDirectory)
+            return DefaultFederatedCapacitorSyncResult(
+                metadata: buildMetadata(bundleId: bundleId, customProperties: result.getCustomProperties())
+            )
+        } catch let error as LiveUpdateProviderError {
+            throw error
+        } catch {
+            throw LiveUpdateProviderError.syncFailed(error.localizedDescription, underlyingError: 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] = [:]
+        if let bundleId = bundleId {
+            metadata["bundleId"] = bundleId
+        }
+        if let channel = channel {
+            metadata["channel"] = channel
+        }
+        if let customProperties = customProperties, !customProperties.isEmpty {
+            metadata["customProperties"] = customProperties
+        }
+        return metadata.isEmpty ? nil : metadata
+    }
+
+    private func lastSyncedBundleIdKey() -> String {
+        return Self.userDefaultsPrefix + managerKey
+    }
+}
+#endif

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

@@ -0,0 +1,25 @@
+#if CAPAWESOME_INCLUDE_IONIC_PROVIDER
+import Foundation
+import LiveUpdateProvider
+
+/// Ionic Live Update Provider implementation backed by the Capawesome live update plugin.
+///
+/// Registered with `LiveUpdateProviderRegistry.shared` when the Capacitor plugin loads, so
+/// Federated Capacitor can resolve provider id `"capawesome"` and create managers from the
+/// per-shell configuration.
+public struct LiveUpdateIonicProvider: LiveUpdateProviding {
+    public static let id = "capawesome"
+
+    public let id: String = LiveUpdateIonicProvider.id
+
+    private let liveUpdate: LiveUpdate
+
+    public init(liveUpdate: LiveUpdate) {
+        self.liveUpdate = liveUpdate
+    }
+
+    public func createManager(config: [String: Any]) throws -> any LiveUpdateManaging {
+        return try LiveUpdateIonicManager(config: config, liveUpdate: liveUpdate)
+    }
+}
+#endif

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-live-update",
-  "version": "8.2.0",
+  "version": "8.2.1-dev.70823ec8.1778138208",
   "description": "Capacitor plugin to update your app remotely in real-time.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",