@capawesome/capacitor-live-update 6.2.0 → 6.4.0

package/README.md

@@ -65,15 +65,17 @@ We recommend to declare [`CA92.1`](https://developer.apple.com/documentation/bun
 <docgen-config>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-| Prop                    | Type                      | Description                                                                                                                                       | Default            | Since |
-| ----------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
-| **`appId`**             | <code>string</code>       | The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud).                                                |                    | 5.0.0 |
-| **`autoDeleteBundles`** | <code>boolean</code>      | Whether or not to automatically delete unused bundles. When enabled, the plugin will automatically delete unused bundles after calling `ready()`. | <code>false</code> | 5.0.0 |
-| **`enabled`**           | <code>boolean</code>      | Whether or not the plugin is enabled.                                                                                                             | <code>true</code>  | 5.0.0 |
-| **`location`**          | <code>'us' \| 'eu'</code> | The location of the server to use when using [Capawesome Cloud](https://capawesome.io/cloud).                                                     | <code>'us'</code>  | 6.2.0 |
-| **`publicKey`**         | <code>string</code>       | The public key to verify the integrity of the bundle. The public key must be a PEM-encoded RSA public key.                                        |                    | 6.1.0 |
-| **`readyTimeout`**      | <code>number</code>       | The timeout in milliseconds to wait for the app to be ready before resetting to the default bundle.                                               | <code>10000</code> | 5.0.0 |
-| **`resetOnUpdate`**     | <code>boolean</code>      | Whether or not the app should be reset to the default bundle during an update.                                                                    | <code>true</code>  | 5.0.0 |
+| Prop                    | Type                      | Description                                                                                                                                                                                                                                                                          | Default            | Since |
+| ----------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | ----- |
+| **`appId`**             | <code>string</code>       | The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud). This is **NOT** the same as the app identifier (e.g. `com.example.app`). This is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`). |                    | 5.0.0 |
+| **`autoDeleteBundles`** | <code>boolean</code>      | Whether or not to automatically delete unused bundles. When enabled, the plugin will automatically delete unused bundles after calling `ready()`.                                                                                                                                    | <code>false</code> | 5.0.0 |
+| **`defaultChannel`**    | <code>string</code>       | The default channel of the app.                                                                                                                                                                                                                                                      |                    | 6.3.0 |
+| **`enabled`**           | <code>boolean</code>      | Whether or not the plugin is enabled.                                                                                                                                                                                                                                                | <code>true</code>  | 5.0.0 |
+| **`httpTimeout`**       | <code>number</code>       | The timeout in milliseconds for HTTP requests.                                                                                                                                                                                                                                       | <code>60000</code> | 6.4.0 |
+| **`location`**          | <code>'us' \| 'eu'</code> | The location of the server to use when using [Capawesome Cloud](https://capawesome.io/cloud).                                                                                                                                                                                        | <code>'us'</code>  | 6.2.0 |
+| **`publicKey`**         | <code>string</code>       | The public key to verify the integrity of the bundle. The public key must be a PEM-encoded RSA public key.                                                                                                                                                                           |                    | 6.1.0 |
+| **`readyTimeout`**      | <code>number</code>       | The timeout in milliseconds to wait for the app to be ready before resetting to the default bundle.                                                                                                                                                                                  | <code>10000</code> | 5.0.0 |
+| **`resetOnUpdate`**     | <code>boolean</code>      | Whether or not the app should be reset to the default bundle during an update.                                                                                                                                                                                                       | <code>true</code>  | 5.0.0 |
 
 ### Examples
 
@@ -83,9 +85,11 @@ In `capacitor.config.json`:
 {
   "plugins": {
     "LiveUpdate": {
-      "appId": '4100e356-e851-47fe-9d3c-b411eb325a99',
+      "appId": '6e351b4f-69a7-415e-a057-4567df7ffe94',
       "autoDeleteBundles": undefined,
+      "defaultChannel": 'production',
       "enabled": undefined,
+      "httpTimeout": undefined,
       "location": 'eu',
       "publicKey": '-----BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDodf1SD0OOn6hIlDuKBza0Ed0OqtwyVJwiyjmE9BJaZ7y8ZUfcF+SKmd0l2cDPM45XIg2tAFux5n29uoKyHwSt+6tCi5CJA5Z1/1eZruRRqABLonV77KS3HUtvOgqRLDnKSV89dYZkM++NwmzOPgIF422mvc+VukcVOBfc8/AHQIDAQAB-----END PUBLIC KEY-----',
       "readyTimeout": undefined,
@@ -105,9 +109,11 @@ import { CapacitorConfig } from '@capacitor/cli';
 const config: CapacitorConfig = {
   plugins: {
     LiveUpdate: {
-      appId: '4100e356-e851-47fe-9d3c-b411eb325a99',
+      appId: '6e351b4f-69a7-415e-a057-4567df7ffe94',
       autoDeleteBundles: undefined,
+      defaultChannel: 'production',
       enabled: undefined,
+      httpTimeout: undefined,
       location: 'eu',
       publicKey: '-----BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDodf1SD0OOn6hIlDuKBza0Ed0OqtwyVJwiyjmE9BJaZ7y8ZUfcF+SKmd0l2cDPM45XIg2tAFux5n29uoKyHwSt+6tCi5CJA5Z1/1eZruRRqABLonV77KS3HUtvOgqRLDnKSV89dYZkM++NwmzOPgIF422mvc+VukcVOBfc8/AHQIDAQAB-----END PUBLIC KEY-----',
       readyTimeout: undefined,
@@ -641,6 +647,20 @@ Live updates are only supported for [binary-compatible changes](https://capaweso
 If you change native code, such as adding a new plugin, you need to resubmit your app to the app stores.
 For this reason, you must be careful to [restrict live updates to compatible native versions](https://capawesome.io/blog/how-to-restrict-capacitor-live-updates-to-native-versions/) of your app.
 
+## FAQ
+
+### Why can't I see my changes during development?
+
+As soon as you have installed a live update, the app will use the live update bundle and no longer the default bundle. 
+So if you make local changes to your app and execute `npx cap run`, for example, these changes will apply to the default bundle, which is not currently in use.
+You then have three options to get back to the default bundle:
+
+1. **Reset**: Call the [`reset()`](#reset) method to reset the app to the default bundle.
+2. **Reinstall**: Reinstall the app to use the default bundle.
+3. **Update**: Increase the `versionCode`/`CFBundleVersion` so that the plugin automatically performs a reset (assuming the [`resetOnUpdate`](#configuration) configuration option is active).
+
+However, this is only a problem during development. It is not a problem in production as long as you have the [`resetOnUpdate`](#configuration) configuration option enabled, as the `versionCode`/`CFBundleVersion` is always incremented during a native update and thus always resets to the default bundle.
+
 ## Changelog
 
 See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/live-update/CHANGELOG.md).

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

@@ -37,6 +37,7 @@ import java.security.Signature;
 import java.security.spec.X509EncodedKeySpec;
 import java.util.Arrays;
 import java.util.UUID;
+import java.util.concurrent.TimeUnit;
 import net.lingala.zip4j.ZipFile;
 import okhttp3.Call;
 import okhttp3.Callback;
@@ -133,7 +134,7 @@ public class LiveUpdate {
     }
 
     public void getChannel(@NonNull NonEmptyCallback callback) {
-        String channel = preferences.getChannel();
+        String channel = getChannel();
         GetChannelResult result = new GetChannelResult(channel);
         callback.success(result);
     }
@@ -213,6 +214,11 @@ public class LiveUpdate {
             new NonEmptyCallback<GetLatestBundleResponse>() {
                 @Override
                 public void error(Exception exception) {
+                    // Throw error if the exception is a timeout
+                    if (exception instanceof java.net.SocketTimeoutException) {
+                        callback.error(new Exception(LiveUpdatePlugin.ERROR_HTTP_TIMEOUT));
+                        return;
+                    }
                     // No update available
                     Logger.debug(LiveUpdatePlugin.TAG, "No update available.");
                     SyncResult syncResult = new SyncResult(null);
@@ -381,6 +387,11 @@ public class LiveUpdate {
             new NonEmptyCallback<File>() {
                 @Override
                 public void error(Exception exception) {
+                    // Throw error if the exception is a timeout
+                    if (exception instanceof java.net.SocketTimeoutException) {
+                        callback.error(new Exception(LiveUpdatePlugin.ERROR_HTTP_TIMEOUT));
+                        return;
+                    }
                     callback.error(exception);
                 }
 
@@ -425,7 +436,12 @@ public class LiveUpdate {
     }
 
     private void downloadFile(@NonNull String url, @NonNull NonEmptyCallback<File> callback) {
-        OkHttpClient okHttpClient = new OkHttpClient();
+        int httpTimeout = config.getHttpTimeout();
+        OkHttpClient okHttpClient = new OkHttpClient.Builder()
+            .connectTimeout(httpTimeout, TimeUnit.MILLISECONDS)
+            .readTimeout(httpTimeout, TimeUnit.MILLISECONDS)
+            .writeTimeout(httpTimeout, TimeUnit.MILLISECONDS)
+            .build();
         Request request = new Request.Builder().url(url).build();
         okHttpClient
             .newCall(request)
@@ -487,7 +503,7 @@ public class LiveUpdate {
             .addQueryParameter("appVersionCode", getVersionCode())
             .addQueryParameter("appVersionName", getVersionName())
             .addQueryParameter("bundleId", getCurrentBundleId())
-            .addQueryParameter("channelName", preferences.getChannel())
+            .addQueryParameter("channelName", getChannel())
             .addQueryParameter("customId", preferences.getCustomId())
             .addQueryParameter("deviceId", getDeviceId())
             .addQueryParameter("osVersion", String.valueOf(Build.VERSION.SDK_INT))
@@ -495,7 +511,13 @@ public class LiveUpdate {
             .addQueryParameter("pluginVersion", LiveUpdatePlugin.VERSION)
             .build();
         Logger.debug(LiveUpdatePlugin.TAG, "Fetching latest bundle from " + url);
-        OkHttpClient client = new OkHttpClient();
+        int httpTimeout = config.getHttpTimeout();
+        OkHttpClient client = new OkHttpClient()
+            .newBuilder()
+            .connectTimeout(httpTimeout, TimeUnit.MILLISECONDS)
+            .readTimeout(httpTimeout, TimeUnit.MILLISECONDS)
+            .writeTimeout(httpTimeout, TimeUnit.MILLISECONDS)
+            .build();
         okhttp3.Request request = new okhttp3.Request.Builder().url(url).build();
         client
             .newCall(request)
@@ -530,14 +552,6 @@ public class LiveUpdate {
             );
     }
 
-    private String getVersionCode() throws PackageManager.NameNotFoundException {
-        return String.valueOf(getPackageInfo().versionCode);
-    }
-
-    private String getVersionName() throws PackageManager.NameNotFoundException {
-        return getPackageInfo().versionName;
-    }
-
     private String[] getBundleIds() {
         File bundlesDirectory = buildBundlesDirectory();
         File[] bundles = bundlesDirectory.listFiles();
@@ -553,6 +567,18 @@ public class LiveUpdate {
         return bundleIds;
     }
 
+    @Nullable
+    private String getChannel() {
+        String channel = null;
+        if (config.getDefaultChannel() != null) {
+            channel = config.getDefaultChannel();
+        }
+        if (preferences.getChannel() != null) {
+            channel = preferences.getChannel();
+        }
+        return channel;
+    }
+
     /**
      * @return The current bundle ID (`public` for the built-in bundle).
      */
@@ -604,6 +630,14 @@ public class LiveUpdate {
             .getString(WebView.CAP_SERVER_PATH, defaultWebAssetDir);
     }
 
+    private String getVersionCode() throws PackageManager.NameNotFoundException {
+        return String.valueOf(getPackageInfo().versionCode);
+    }
+
+    private String getVersionName() throws PackageManager.NameNotFoundException {
+        return getPackageInfo().versionName;
+    }
+
     private boolean hasBundle(@NonNull String bundleId) {
         File bundleDirectory = buildBundleDirectoryFor(bundleId);
         return bundleDirectory.exists();

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

@@ -9,7 +9,12 @@ public class LiveUpdateConfig {
     private String appId = null;
 
     private boolean autoDeleteBundles = false;
+
+    @Nullable
+    private String defaultChannel = null;
+
     private boolean enabled = true;
+    private int httpTimeout = 60000;
 
     @Nullable
     private String location = null;
@@ -29,10 +34,19 @@ public class LiveUpdateConfig {
         return autoDeleteBundles;
     }
 
+    @Nullable
+    public String getDefaultChannel() {
+        return defaultChannel;
+    }
+
     public boolean getEnabled() {
         return enabled;
     }
 
+    public int getHttpTimeout() {
+        return httpTimeout;
+    }
+
     @Nullable
     public String getLocation() {
         return location;
@@ -59,10 +73,18 @@ public class LiveUpdateConfig {
         this.autoDeleteBundles = autoDeleteBundles;
     }
 
+    public void setDefaultChannel(@Nullable String defaultChannel) {
+        this.defaultChannel = defaultChannel;
+    }
+
     public void setEnabled(boolean enabled) {
         this.enabled = enabled;
     }
 
+    public void setHttpTimeout(int httpTimeout) {
+        this.httpTimeout = httpTimeout;
+    }
+
     public void setLocation(@Nullable String location) {
         this.location = location;
     }

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

@@ -19,7 +19,7 @@ import io.capawesome.capacitorjs.plugins.liveupdate.interfaces.Result;
 public class LiveUpdatePlugin extends Plugin {
 
     public static final String TAG = "LiveUpdate";
-    public static final String VERSION = "6.2.0";
+    public static final String VERSION = "6.4.0";
     public static final String SHARED_PREFERENCES_NAME = "CapawesomeLiveUpdate"; // DO NOT CHANGE
     public static final String ERROR_APP_ID_MISSING = "appId must be configured.";
     public static final String ERROR_BUNDLE_EXISTS = "bundle already exists.";
@@ -30,10 +30,14 @@ 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_HTTP_TIMEOUT = "Request timed out.";
     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.";
     public static final String ERROR_SIGNATURE_MISSING = "Bundle does not contain a signature.";
+    public static final String ERROR_SYNC_IN_PROGRESS = "Sync is already in progress.";
+
+    private boolean syncInProgress = false;
 
     @Nullable
     private LiveUpdateConfig config;
@@ -404,14 +408,23 @@ public class LiveUpdatePlugin extends Plugin {
                 call.reject(ERROR_APP_ID_MISSING);
                 return;
             }
+
+            if (syncInProgress) {
+                call.reject(ERROR_SYNC_IN_PROGRESS);
+                return;
+            }
+            syncInProgress = true;
+
             NonEmptyCallback<Result> callback = new NonEmptyCallback<>() {
                 @Override
                 public void success(Result result) {
+                    syncInProgress = false;
                     call.resolve(result.toJSObject());
                 }
 
                 @Override
                 public void error(Exception exception) {
+                    syncInProgress = false;
                     Logger.error(TAG, exception.getMessage(), exception);
                     call.reject(exception.getMessage());
                 }
@@ -419,6 +432,7 @@ public class LiveUpdatePlugin extends Plugin {
 
             implementation.sync(callback);
         } catch (Exception exception) {
+            syncInProgress = false;
             Logger.error(TAG, exception.getMessage(), exception);
             call.reject(exception.getMessage());
         }
@@ -431,8 +445,12 @@ public class LiveUpdatePlugin extends Plugin {
         config.setAppId(appId);
         boolean autoDeleteBundles = getConfig().getBoolean("autoDeleteBundles", config.getAutoDeleteBundles());
         config.setAutoDeleteBundles(autoDeleteBundles);
+        String defaultChannel = getConfig().getString("defaultChannel", config.getDefaultChannel());
+        config.setDefaultChannel(defaultChannel);
         boolean enabled = getConfig().getBoolean("enabled", config.getEnabled());
         config.setEnabled(enabled);
+        int httpTimeout = getConfig().getInt("httpTimeout", config.getHttpTimeout());
+        config.setHttpTimeout(httpTimeout);
         String location = getConfig().getString("location", config.getLocation());
         config.setLocation(location);
         String publicKey = getConfig().getString("publicKey", config.getPublicKey());

package/dist/docs.json

@@ -722,11 +722,11 @@
               "name": "since"
             },
             {
-              "text": "'4100e356-e851-47fe-9d3c-b411eb325a99'",
+              "text": "'6e351b4f-69a7-415e-a057-4567df7ffe94'",
               "name": "example"
             }
           ],
-          "docs": "The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud).",
+          "docs": "The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud).\n\nThis is **NOT** the same as the app identifier (e.g. `com.example.app`).\nThis is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -746,6 +746,22 @@
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "defaultChannel",
+          "tags": [
+            {
+              "text": "6.3.0",
+              "name": "since"
+            },
+            {
+              "text": "'production'",
+              "name": "example"
+            }
+          ],
+          "docs": "The default channel of the app.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
           "name": "enabled",
           "tags": [
@@ -762,6 +778,22 @@
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "httpTimeout",
+          "tags": [
+            {
+              "text": "6.4.0",
+              "name": "since"
+            },
+            {
+              "text": "60000",
+              "name": "default"
+            }
+          ],
+          "docs": "The timeout in milliseconds for HTTP requests.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
         {
           "name": "location",
           "tags": [

package/dist/esm/definitions.d.ts

@@ -4,8 +4,11 @@ declare module '@capacitor/cli' {
             /**
              * The app ID is used to identify the app when using [Capawesome Cloud](https://capawesome.io/cloud).
              *
+             * This is **NOT** the same as the app identifier (e.g. `com.example.app`).
+             * This is a unique identifier generated by Capawesome Cloud (e.g. `6e351b4f-69a7-415e-a057-4567df7ffe94`).
+             *
              * @since 5.0.0
-             * @example '4100e356-e851-47fe-9d3c-b411eb325a99'
+             * @example '6e351b4f-69a7-415e-a057-4567df7ffe94'
              */
             appId?: string;
             /**
@@ -17,6 +20,13 @@ declare module '@capacitor/cli' {
              * @default false
              */
             autoDeleteBundles?: boolean;
+            /**
+             * The default channel of the app.
+             *
+             * @since 6.3.0
+             * @example 'production'
+             */
+            defaultChannel?: string;
             /**
              * Whether or not the plugin is enabled.
              *
@@ -24,6 +34,13 @@ declare module '@capacitor/cli' {
              * @default true
              */
             enabled?: boolean;
+            /**
+             * The timeout in milliseconds for HTTP requests.
+             *
+             * @since 6.4.0
+             * @default 60000
+             */
+            httpTimeout?: number;
             /**
              * The location of the server to use when using [Capawesome Cloud](https://capawesome.io/cloud).
              *

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\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       * @since 5.0.0\n       * @example '4100e356-e851-47fe-9d3c-b411eb325a99'\n       */\n      appId?: string;\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       * Whether or not the plugin is enabled.\n       *\n       * @since 5.0.0\n       * @default true\n       */\n      enabled?: boolean;\n      /**\n       * The location of the server to use when using [Capawesome Cloud](https://capawesome.io/cloud).\n       *\n       * @since 6.2.0\n       * @default 'us'\n       * @example 'eu'\n       * @see https://capawesome.io/cloud/live-updates/advanced/privacy/\n       */\n      location?: 'us' | 'eu';\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 before resetting to the default bundle.\n       *\n       * @since 5.0.0\n       * @default 10000\n       */\n      readyTimeout?: number;\n      /**\n       * Whether or not the app should be reset to the default bundle during an update.\n       *\n       * @since 5.0.0\n       * @default true\n       */\n      resetOnUpdate?: boolean;\n    };\n  }\n}\n\nexport interface LiveUpdatePlugin {\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   * Get the active bundle identifier.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getBundle(): Promise<GetBundleResult>;\n  /**\n   * Get all available bundle identifiers.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getBundles(): Promise<GetBundlesResult>;\n  /**\n   * Get the channel of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getChannel(): Promise<GetChannelResult>;\n  /**\n   * Get the custom identifier of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getCustomId(): Promise<GetCustomIdResult>;\n  /**\n   * Get the device identifier of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getDeviceId(): Promise<GetDeviceIdResult>;\n  /**\n   * Get the version code of the app.\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   * 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<void>;\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   * 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 5.0.0\n   */\n  setBundle(options: SetBundleOptions): Promise<void>;\n  /**\n   * Set the channel of the app.\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 custom identifier of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  setCustomId(options: SetCustomIdOptions): 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(): Promise<SyncResult>;\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 unique identifier of the bundle.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n  /**\n   * The checksum of the bundle to verify the integrity of the ZIP file.\n   *\n   * Must be a SHA-256 hash in hexadecimal format.\n   *\n   * @since 6.1.0\n   * @example 'aab8e0a312e807c8eaeb923e2bdccd7731c5508869c62ad8e6e43ee881414c84'\n   */\n  checksum?: string;\n  /**\n   * The URL of the bundle to download.\n   *\n   * The bundle must be a ZIP file containing at least a `index.html` file.\n   *\n   * @since 5.0.0\n   * @example 'https://example.com/bundle.zip'\n   */\n  url: 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 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 5.0.0\n */\nexport interface GetChannelResult {\n  /**\n   * The channel of the app.\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 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 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 app.\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 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 of the app.\n   *\n   * Set `null` to remove the channel.\n   *\n   * @since 5.0.0\n   */\n  channel: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetCustomIdOptions {\n  /**\n   * The custom identifier of the app.\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 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"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\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 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 default channel of the app.\n       *\n       * @since 6.3.0\n       * @example 'production'\n       */\n      defaultChannel?: string;\n      /**\n       * Whether or not the plugin is enabled.\n       *\n       * @since 5.0.0\n       * @default true\n       */\n      enabled?: boolean;\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 location of the server to use when using [Capawesome Cloud](https://capawesome.io/cloud).\n       *\n       * @since 6.2.0\n       * @default 'us'\n       * @example 'eu'\n       * @see https://capawesome.io/cloud/live-updates/advanced/privacy/\n       */\n      location?: 'us' | 'eu';\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 before resetting to the default bundle.\n       *\n       * @since 5.0.0\n       * @default 10000\n       */\n      readyTimeout?: number;\n      /**\n       * Whether or not the app should be reset to the default bundle during an update.\n       *\n       * @since 5.0.0\n       * @default true\n       */\n      resetOnUpdate?: boolean;\n    };\n  }\n}\n\nexport interface LiveUpdatePlugin {\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   * Get the active bundle identifier.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getBundle(): Promise<GetBundleResult>;\n  /**\n   * Get all available bundle identifiers.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getBundles(): Promise<GetBundlesResult>;\n  /**\n   * Get the channel of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getChannel(): Promise<GetChannelResult>;\n  /**\n   * Get the custom identifier of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getCustomId(): Promise<GetCustomIdResult>;\n  /**\n   * Get the device identifier of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  getDeviceId(): Promise<GetDeviceIdResult>;\n  /**\n   * Get the version code of the app.\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   * 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<void>;\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   * 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 5.0.0\n   */\n  setBundle(options: SetBundleOptions): Promise<void>;\n  /**\n   * Set the channel of the app.\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 custom identifier of the app.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 5.0.0\n   */\n  setCustomId(options: SetCustomIdOptions): 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(): Promise<SyncResult>;\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 unique identifier of the bundle.\n   *\n   * @since 5.0.0\n   * @example '1.0.0'\n   */\n  bundleId: string;\n  /**\n   * The checksum of the bundle to verify the integrity of the ZIP file.\n   *\n   * Must be a SHA-256 hash in hexadecimal format.\n   *\n   * @since 6.1.0\n   * @example 'aab8e0a312e807c8eaeb923e2bdccd7731c5508869c62ad8e6e43ee881414c84'\n   */\n  checksum?: string;\n  /**\n   * The URL of the bundle to download.\n   *\n   * The bundle must be a ZIP file containing at least a `index.html` file.\n   *\n   * @since 5.0.0\n   * @example 'https://example.com/bundle.zip'\n   */\n  url: 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 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 5.0.0\n */\nexport interface GetChannelResult {\n  /**\n   * The channel of the app.\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 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 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 app.\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 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 of the app.\n   *\n   * Set `null` to remove the channel.\n   *\n   * @since 5.0.0\n   */\n  channel: string | null;\n}\n\n/**\n * @since 5.0.0\n */\nexport interface SetCustomIdOptions {\n  /**\n   * The custom identifier of the app.\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 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"]}

package/ios/Plugin/Classes/CustomError.swift

@@ -11,8 +11,10 @@ public enum CustomError: Error {
     case checksumMismatch
     case customIdMissing
     case downloadFailed
+    case httpTimeout
     case signatureMissing
     case signatureVerificationFailed
+    case syncInProgress
     case urlMissing
 }
 
@@ -39,10 +41,14 @@ extension CustomError: LocalizedError {
             return NSLocalizedString("customId must be provided.", comment: "customIdMissing")
         case .downloadFailed:
             return NSLocalizedString("Bundle could not be downloaded.", comment: "downloadFailed")
+        case .httpTimeout:
+            return NSLocalizedString("Request timed out.", comment: "httpTimeout")
         case .signatureMissing:
             return NSLocalizedString("Bundle does not contain a signature.", comment: "signatureMissing")
         case .signatureVerificationFailed:
             return NSLocalizedString("Signature verification failed.", comment: "signatureVerificationFailed")
+        case .syncInProgress:
+            return NSLocalizedString("Sync is already in progress.", comment: "syncInProgress")
         case .urlMissing:
             return NSLocalizedString("url must be provided.", comment: "urlMissing")
         }

package/ios/Plugin/LiveUpdate.swift

@@ -89,7 +89,7 @@ import CommonCrypto
     }
 
     @objc public func getChannel(completion: @escaping (Result?, Error?) -> Void) {
-        let channel = preferences.getChannel()
+        let channel = getChannel()
         let result = GetChannelResult(channel: channel)
         completion(result, nil)
     }
@@ -356,11 +356,22 @@ import CommonCrypto
             let temporaryZipFileUrl = self.cachesDirectoryUrl.appendingPathComponent(timestamp + ".zip")
             return (temporaryZipFileUrl, [.createIntermediateDirectories])
         }
-
-        AF.download(url, to: destination).validate().response { response in
+        var request = URLRequest(url: URL(string: url)!)
+        request.httpMethod = HTTPMethod.get.rawValue
+        request.timeoutInterval = Double(config.httpTimeout) / 1000.0
+        AF.download(request, to: destination).validate().response { response in
             if let error = response.error {
                 CAPLog.print("[", LiveUpdatePlugin.tag, "] ", error)
-                completion(nil, CustomError.downloadFailed)
+                if let urlError = error.underlyingError as? URLError {
+                    switch urlError.code {
+                    case .timedOut:
+                        completion(nil, CustomError.httpTimeout)
+                    default:
+                        completion(nil, CustomError.downloadFailed)
+                    }
+                } else {
+                    completion(nil, CustomError.downloadFailed)
+                }
                 return
             }
             completion(response.fileURL, nil)
@@ -372,7 +383,7 @@ import CommonCrypto
         parameters["appVersionCode"] = getVersionCode()
         parameters["appVersionName"] = getVersionName()
         parameters["bundleId"] = getCurrentBundleId()
-        parameters["channelName"] = preferences.getChannel()
+        parameters["channelName"] = getChannel()
         parameters["customId"] = preferences.getCustomId()
         parameters["deviceId"] = getDeviceId()
         parameters["osVersion"] = UIDevice.current.systemVersion
@@ -384,35 +395,34 @@ import CommonCrypto
                 host = "api.cloud.capawesome.eu"
             }
         }
-        let url = URL(string: "https://\(host)/v1/apps/\(config.appId ?? "")/bundles/latest")!
-        AF.request(url, method: .get, parameters: parameters).validate().responseDecodable(of: GetLatestBundleResponse.self) { response in
+        var urlComponents = URLComponents(string: "https://\(host)/v1/apps/\(config.appId ?? "")/bundles/latest")!
+        urlComponents.queryItems = parameters.map { URLQueryItem(name: $0.key, value: $0.value) }
+        var request = URLRequest(url: urlComponents.url!)
+        request.httpMethod = HTTPMethod.get.rawValue
+        request.timeoutInterval = Double(config.httpTimeout) / 1000.0
+        AF.request(request).validate().responseDecodable(of: GetLatestBundleResponse.self) { response in
             CAPLog.print("[", LiveUpdatePlugin.tag, "] Fetching latest bundle from ", response.request?.url?.absoluteString ?? "")
             if let error = response.error {
                 CAPLog.print("[", LiveUpdatePlugin.tag, "] ", error)
                 if let data = response.data {
                     CAPLog.print("[", LiveUpdatePlugin.tag, "] ", String(decoding: data, as: UTF8.self))
                 }
-                completion(nil, error)
+                if let urlError = error.underlyingError as? URLError {
+                    switch urlError.code {
+                    case .timedOut:
+                        completion(nil, CustomError.httpTimeout)
+                    default:
+                        completion(nil, error)
+                    }
+                } else {
+                    completion(nil, error)
+                }
                 return
             }
             completion(response.value, nil)
         }
     }
 
-    private func getVersionCode() -> String {
-        guard let appVersionCode = Bundle.main.infoDictionary?["CFBundleVersion"] as? String else {
-            return ""
-        }
-        return appVersionCode
-    }
-
-    private func getVersionName() -> String {
-        guard let appVersionName = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String else {
-            return ""
-        }
-        return appVersionName
-    }
-
     private func getBundleIds() -> [String] {
         let url = libraryDirectoryUrl.appendingPathComponent(bundlesDirectory)
         do {
@@ -427,6 +437,17 @@ import CommonCrypto
         }
     }
 
+    private func getChannel() -> String? {
+        var channel: String?
+        if let _ = config.defaultChannel {
+            channel = config.defaultChannel
+        }
+        if let _ = preferences.getChannel() {
+            channel = preferences.getChannel()
+        }
+        return channel
+    }
+
     /// - Returns: The current bundle ID (`public` for the built-in bundle) or `nil` if no view controller was found.
     private func getCurrentBundleId() -> String? {
         guard let path = getCurrentCapacitorServerPath() else {
@@ -463,6 +484,20 @@ import CommonCrypto
         return defaultCapacitorServerPath
     }
 
+    private func getVersionCode() -> String {
+        guard let appVersionCode = Bundle.main.infoDictionary?["CFBundleVersion"] as? String else {
+            return ""
+        }
+        return appVersionCode
+    }
+
+    private func getVersionName() -> String {
+        guard let appVersionName = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String else {
+            return ""
+        }
+        return appVersionName
+    }
+
     private func hasBundle(bundleId: String) -> Bool {
         let path = buildBundlePathFor(bundleId: bundleId)
         return FileManager.default.fileExists(atPath: path)
@@ -486,11 +521,28 @@ import CommonCrypto
     }
 
     private func searchIndexHtmlFile(url: URL) -> URL? {
-        let enumerator = FileManager.default.enumerator(atPath: url.path)
-        while let element = enumerator?.nextObject() as? String {
-            if element.hasSuffix("index.html") {
-                return url.appendingPathComponent(element)
+        do {
+            let directoryContents = try FileManager.default.contentsOfDirectory(at: url, includingPropertiesForKeys: nil, options: [])
+            if directoryContents.isEmpty {
+                return nil
             }
+            let fileNames = directoryContents.map { $0.lastPathComponent }
+            if fileNames.contains("index.html") {
+                return url.appendingPathComponent("index.html")
+            } else {
+                for fileUrl in directoryContents {
+                    var isDirectory: ObjCBool = false
+                    if FileManager.default.fileExists(atPath: fileUrl.path, isDirectory: &isDirectory) {
+                        if isDirectory.boolValue {
+                            if let indexHtmlFile = searchIndexHtmlFile(url: fileUrl) {
+                                return indexHtmlFile
+                            }
+                        }
+                    }
+                }
+            }
+        } catch {
+            CAPLog.print("[", LiveUpdatePlugin.tag, "] ", "Failed to search index.html file: \(error.localizedDescription)")
         }
         return nil
     }

package/ios/Plugin/LiveUpdateConfig.swift

@@ -1,7 +1,9 @@
 public struct LiveUpdateConfig {
     var appId: String?
     var autoDeleteBundles = false
+    var defaultChannel: String?
     var enabled = true
+    var httpTimeout = 60000
     var location: String?
     var publicKey: String?
     var readyTimeout = 10000

package/ios/Plugin/LiveUpdatePlugin.swift

@@ -8,11 +8,12 @@ import Capacitor
 @objc(LiveUpdatePlugin)
 public class LiveUpdatePlugin: CAPPlugin {
     public static let tag = "LiveUpdate"
-    public static let version = "6.2.0"
+    public static let version = "6.4.0"
     public static let userDefaultsPrefix = "CapawesomeLiveUpdate" // DO NOT CHANGE
 
     private var config: LiveUpdateConfig?
     private var implementation: LiveUpdate?
+    private var syncInProgress = false
 
     override public func load() {
         self.config = liveUpdateConfig()
@@ -222,7 +223,15 @@ public class LiveUpdatePlugin: CAPPlugin {
             call.reject(CustomError.appIdMissing.localizedDescription)
             return
         }
+
+        guard !syncInProgress else {
+            call.reject(CustomError.syncInProgress.localizedDescription)
+            return
+        }
+        syncInProgress = true
+
         implementation?.sync(completion: { result, error in
+            self.syncInProgress = false
             if let error = error {
                 CAPLog.print("[", LiveUpdatePlugin.tag, "] ", error)
                 call.reject(error.localizedDescription)
@@ -239,7 +248,9 @@ public class LiveUpdatePlugin: CAPPlugin {
 
         config.appId = getConfig().getString("appId", config.appId)
         config.autoDeleteBundles = getConfig().getBoolean("autoDeleteBundles", config.autoDeleteBundles)
+        config.defaultChannel = getConfig().getString("defaultChannel", config.defaultChannel)
         config.enabled = getConfig().getBoolean("enabled", config.enabled)
+        config.httpTimeout = getConfig().getInt("httpTimeout", config.httpTimeout)
         config.location = getConfig().getString("location", config.location)
         config.publicKey = getConfig().getString("publicKey", config.publicKey)
         config.readyTimeout = getConfig().getInt("readyTimeout", config.readyTimeout)

package/package.json

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