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

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

@@ -1,6 +1,7 @@
 package io.capawesome.capacitorjs.plugins.liveupdate;
 
 import android.app.Activity;
+import android.content.Context;
 import android.content.SharedPreferences;
 import android.content.pm.PackageInfo;
 import android.content.pm.PackageManager;
@@ -87,12 +88,15 @@ public class LiveUpdate {
     @NonNull
     private final LiveUpdateConfig config;
 
+    @NonNull
+    private final Context context;
+
     private final String defaultWebAssetDir = Bridge.DEFAULT_WEB_ASSET_DIR;
 
     @NonNull
     private final LiveUpdateHttpClient httpClient;
 
-    @NonNull
+    @Nullable
     private final LiveUpdatePlugin plugin;
 
     @NonNull
@@ -111,11 +115,26 @@ public class LiveUpdate {
     private boolean syncInProgress = false;
 
     public LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull LiveUpdatePlugin plugin) throws PackageManager.NameNotFoundException {
+        this(config, plugin.getContext(), plugin);
+    }
+
+    /**
+     * Creates a headless instance without a Capacitor plugin, e.g. for Ionic Portals hosts
+     * that construct a provider manager directly. WebView-related operations (server path
+     * changes, reload) and plugin events are skipped in this mode.
+     */
+    public LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull Context context) throws PackageManager.NameNotFoundException {
+        this(config, context, null);
+    }
+
+    private LiveUpdate(@NonNull LiveUpdateConfig config, @NonNull Context context, @Nullable LiveUpdatePlugin plugin)
+        throws PackageManager.NameNotFoundException {
         this.config = config;
+        this.context = context;
         this.httpClient = new LiveUpdateHttpClient(config);
         this.plugin = plugin;
-        this.preferences = new LiveUpdatePreferences(plugin.getContext());
-        this.webViewSettingsEditor = plugin.getContext().getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE).edit();
+        this.preferences = new LiveUpdatePreferences(context);
+        this.webViewSettingsEditor = context.getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE).edit();
 
         // Check version and reset config if version changed
         checkAndResetConfigIfVersionChanged();
@@ -232,6 +251,7 @@ public class LiveUpdate {
                 public void success(@Nullable GetLatestBundleResponse response) {
                     ArtifactType artifactType = response == null ? null : response.getArtifactType();
                     String bundleId = response == null ? null : response.getBundleId();
+                    String channel = response == null ? null : response.getChannelName();
                     String checksum = response == null ? null : response.getChecksum();
                     JSONObject customProperties = response == null ? null : response.getCustomProperties();
                     String downloadUrl = response == null ? null : response.getUrl();
@@ -239,6 +259,7 @@ public class LiveUpdate {
                     FetchLatestBundleResult result = new FetchLatestBundleResult(
                         artifactType,
                         bundleId,
+                        channel,
                         checksum,
                         customProperties,
                         downloadUrl,
@@ -298,6 +319,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);
@@ -547,21 +579,21 @@ public class LiveUpdate {
     }
 
     private File buildBundlesDirectory() {
-        return new File(plugin.getContext().getFilesDir(), bundlesDirectory);
+        return new File(context.getFilesDir(), bundlesDirectory);
     }
 
     private File buildBundleDirectoryFor(@NonNull String bundleId) {
-        return new File(plugin.getContext().getFilesDir(), bundlesDirectory + "/" + bundleId);
+        return new File(context.getFilesDir(), bundlesDirectory + "/" + bundleId);
     }
 
     private File buildTemporaryDirectory() {
         String fileName = UUID.randomUUID().toString();
-        return new File(plugin.getContext().getCacheDir(), fileName);
+        return new File(context.getCacheDir(), fileName);
     }
 
     private File buildTemporaryZipFile() {
         String fileName = UUID.randomUUID().toString() + ".zip";
-        return new File(plugin.getContext().getCacheDir(), fileName);
+        return new File(context.getCacheDir(), fileName);
     }
 
     private void copyCurrentBundleFile(@NonNull ManifestItem fileToCopy, @NonNull File destinationDirectory) throws IOException {
@@ -569,7 +601,7 @@ public class LiveUpdate {
         String currentBundleId = getCurrentBundleId();
         if (currentBundleId == null) {
             // Create the source input stream
-            AssetManager assets = plugin.getContext().getAssets();
+            AssetManager assets = context.getAssets();
             InputStream inputStream = assets.open(defaultWebAssetDir + "/" + href);
             // Create the destination file
             File destination = new File(destinationDirectory, href);
@@ -975,13 +1007,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())
@@ -1095,14 +1131,11 @@ public class LiveUpdate {
 
     @Nullable
     private String getNativeChannel() {
-        int resId = plugin
-            .getContext()
-            .getResources()
-            .getIdentifier("capawesome_live_update_default_channel", "string", plugin.getContext().getPackageName());
+        int resId = context.getResources().getIdentifier("capawesome_live_update_default_channel", "string", context.getPackageName());
         if (resId == 0) {
             return null;
         }
-        return plugin.getContext().getResources().getString(resId);
+        return context.getResources().getString(resId);
     }
 
     /**
@@ -1121,6 +1154,10 @@ public class LiveUpdate {
      * @return The absolute path to the current bundle directory (`public` for the built-in bundle).
      */
     private String getCurrentCapacitorServerPath() {
+        if (plugin == null) {
+            // Headless mode: there is no WebView, so the default bundle is always current.
+            return defaultWebAssetDir;
+        }
         return plugin.getBridge().getServerBasePath();
     }
 
@@ -1151,8 +1188,7 @@ public class LiveUpdate {
      */
     @NonNull
     private String getNextCapacitorServerPath() {
-        String path = plugin
-            .getContext()
+        String path = context
             .getSharedPreferences(WebView.WEBVIEW_PREFS_NAME, Activity.MODE_PRIVATE)
             .getString(WebView.CAP_SERVER_PATH, defaultWebAssetDir);
         // Empty path means default path
@@ -1197,7 +1233,7 @@ public class LiveUpdate {
     private Manifest loadCurrentManifest() throws Exception {
         String currentBundleId = getCurrentBundleId();
         if (currentBundleId == null) {
-            AssetManager assets = plugin.getContext().getAssets();
+            AssetManager assets = context.getAssets();
             boolean manifestFileExists = Arrays.asList(assets.list(defaultWebAssetDir)).contains(manifestFileName);
             if (manifestFileExists) {
                 InputStream inputStream = assets.open(defaultWebAssetDir + "/" + manifestFileName);
@@ -1229,6 +1265,9 @@ public class LiveUpdate {
     }
 
     private void notifyDownloadBundleProgressListeners(@NonNull final DownloadBundleProgressEvent event) {
+        if (plugin == null) {
+            return;
+        }
         plugin.notifyDownloadBundleProgressListeners(event);
     }
 
@@ -1315,6 +1354,10 @@ public class LiveUpdate {
     }
 
     private void setCurrentCapacitorServerPath(@NonNull String path) {
+        if (plugin == null) {
+            // Headless mode: there is no WebView to point at the new path.
+            return;
+        }
         if (path.equals(defaultWebAssetDir)) {
             this.plugin.getBridge().setServerAssetPath(path);
         } else {
@@ -1341,11 +1384,17 @@ public class LiveUpdate {
     }
 
     private void notifyNextBundleSetListeners(@Nullable String bundleId) {
+        if (plugin == null) {
+            return;
+        }
         NextBundleSetEvent event = new NextBundleSetEvent(bundleId);
         plugin.notifyNextBundleSetListeners(event);
     }
 
     private void notifyReloadedListeners() {
+        if (plugin == null) {
+            return;
+        }
         plugin.notifyReloadedListeners();
     }
 
@@ -1498,11 +1547,11 @@ public class LiveUpdate {
     }
 
     private PackageInfo getPackageInfo() throws PackageManager.NameNotFoundException {
-        String packageName = this.plugin.getContext().getPackageName();
+        String packageName = this.context.getPackageName();
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-            return this.plugin.getContext().getPackageManager().getPackageInfo(packageName, PackageManager.PackageInfoFlags.of(0));
+            return this.context.getPackageManager().getPackageInfo(packageName, PackageManager.PackageInfoFlags.of(0));
         } else {
-            return this.plugin.getContext().getPackageManager().getPackageInfo(packageName, 0);
+            return this.context.getPackageManager().getPackageInfo(packageName, 0);
         }
     }
 }

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

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

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

@@ -16,6 +16,9 @@ public class GetLatestBundleResponse {
     @NonNull
     private String bundleId;
 
+    @Nullable
+    private String channelName;
+
     @Nullable
     private String checksum;
 
@@ -36,6 +39,7 @@ public class GetLatestBundleResponse {
             this.artifactType = ArtifactType.ZIP;
         }
         this.bundleId = responseJson.optString("bundleId");
+        this.channelName = responseJson.isNull("channelName") ? null : responseJson.optString("channelName");
         this.checksum = responseJson.isNull("checksum") ? null : responseJson.optString("checksum");
         this.customProperties = responseJson.optJSONObject("customProperties");
         this.signature = responseJson.isNull("signature") ? null : responseJson.optString("signature");
@@ -52,6 +56,11 @@ public class GetLatestBundleResponse {
         return bundleId;
     }
 
+    @Nullable
+    public String getChannelName() {
+        return channelName;
+    }
+
     @Nullable
     public JSONObject getCustomProperties() {
         return customProperties;

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

@@ -15,6 +15,9 @@ public class FetchLatestBundleResult implements Result {
     @Nullable
     private final String bundleId;
 
+    @Nullable
+    private final String channel;
+
     @Nullable
     private final String checksum;
 
@@ -30,6 +33,7 @@ public class FetchLatestBundleResult implements Result {
     public FetchLatestBundleResult(
         @Nullable ArtifactType artifactType,
         @Nullable String bundleId,
+        @Nullable String channel,
         @Nullable String checksum,
         @Nullable JSONObject customProperties,
         @Nullable String downloadUrl,
@@ -37,12 +41,43 @@ public class FetchLatestBundleResult implements Result {
     ) {
         this.artifactType = artifactType;
         this.bundleId = bundleId;
+        this.channel = channel;
         this.checksum = checksum;
         this.customProperties = customProperties;
         this.downloadUrl = downloadUrl;
         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();
@@ -52,6 +87,9 @@ public class FetchLatestBundleResult implements Result {
             result.put("artifactType", "zip");
         }
         result.put("bundleId", bundleId == null ? JSONObject.NULL : bundleId);
+        if (channel != null) {
+            result.put("channel", channel);
+        }
         if (checksum != null) {
             result.put("checksum", checksum);
         }

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

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

package/dist/docs.json

@@ -881,6 +881,18 @@
           "complexTypes": [],
           "type": "string | null"
         },
+        {
+          "name": "channel",
+          "tags": [
+            {
+              "text": "8.3.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The name of the channel that the bundle is actually from.\n\nThis is the resolved channel after applying any forced channel assignment\nand may differ from the channel set by the Live Update SDK.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
           "name": "checksum",
           "tags": [
@@ -955,7 +967,7 @@
               "name": "since"
             }
           ],
-          "docs": "The name of the channel where the latest bundle is fetched from.",
+          "docs": "The preferred channel name from which the latest bundle should be fetched.\n\nThis is the SDK preference and may be overridden by a forced channel assignment\nconfigured in the Capawesome Cloud Console.",
           "complexTypes": [],
           "type": "string | undefined"
         }
@@ -1521,7 +1533,7 @@
               "name": "since"
             }
           ],
-          "docs": "The name of the channel where the latest bundle is fetched from.",
+          "docs": "The preferred channel name from which the latest bundle should be fetched.\n\nThis is the SDK preference and may be overridden by a forced channel assignment\nconfigured in the Capawesome Cloud Console.",
           "complexTypes": [],
           "type": "string | undefined"
         }