@capgo/capacitor-updater 8.50.2 → 8.51.1

package/android/src/main/java/ee/forgr/capacitor_updater/DelayCondition.java

@@ -40,7 +40,7 @@ public class DelayCondition {
     public boolean equals(Object o) {
         if (this == o) return true;
         if (!(o instanceof DelayCondition that)) return false;
-        return (getKind() == that.getKind() && Objects.equals(getValue(), that.getValue()));
+        return getKind() == that.getKind() && Objects.equals(getValue(), that.getValue());
     }
 
     @Override
@@ -51,6 +51,6 @@ public class DelayCondition {
     @NonNull
     @Override
     public String toString() {
-        return ("DelayCondition{" + "kind=" + kind + ", value='" + value + '\'' + '}');
+        return "DelayCondition{" + "kind=" + kind + ", value='" + value + '\'' + '}';
     }
 }

package/android/src/main/java/ee/forgr/capacitor_updater/DownloadService.java

@@ -174,7 +174,9 @@ public class DownloadService extends Worker {
     }
 
     static File resolveManifestBuiltinFile(final File builtinFolder, final String fileName) throws IOException {
-        return CapgoUpdater.resolvePathInsideDirectory(builtinFolder, fileName);
+        final boolean isBrotli = fileName.endsWith(".br");
+        final String resolvedName = isBrotli ? fileName.substring(0, fileName.length() - 3) : fileName;
+        return CapgoUpdater.resolvePathInsideDirectory(builtinFolder, resolvedName);
     }
 
     private String getInputString(String key, String fallback) {
@@ -642,14 +644,29 @@ public class DownloadService extends Worker {
     }
 
     private void copyFile(File source, File dest) throws IOException {
+        final File parent = dest.getParentFile();
+        if (parent != null && !parent.exists() && !parent.mkdirs()) {
+            throw new IOException("Failed to create parent directory: " + parent.getAbsolutePath());
+        }
+
+        final File tempFile = new File(parent, dest.getName() + ".capgo_tmp");
         try (
             FileInputStream inStream = new FileInputStream(source);
-            FileOutputStream outStream = new FileOutputStream(dest);
+            FileOutputStream outStream = new FileOutputStream(tempFile);
             FileChannel inChannel = inStream.getChannel();
             FileChannel outChannel = outStream.getChannel()
         ) {
             inChannel.transferTo(0, inChannel.size(), outChannel);
         }
+
+        try {
+            Files.move(tempFile.toPath(), dest.toPath(), StandardCopyOption.REPLACE_EXISTING);
+        } catch (IOException e) {
+            if (tempFile.exists()) {
+                tempFile.delete();
+            }
+            throw e;
+        }
     }
 
     private void downloadAndVerify(

package/android/src/main/java/ee/forgr/capacitor_updater/InternalUtils.java

@@ -22,7 +22,7 @@ public class InternalUtils {
     public static String getPackageName(PackageManager pm, String packageName) {
         try {
             PackageInfo pInfo = getPackageInfoInternal(pm, packageName);
-            return (pInfo != null) ? pInfo.packageName : null;
+            return pInfo != null ? pInfo.packageName : null;
         } catch (PackageManager.NameNotFoundException e) {
             // Exception is handled internally, and null is returned to indicate the package name could not be retrieved
             return null;

package/android/src/main/java/ee/forgr/capacitor_updater/ShakeMenu.java

@@ -13,6 +13,7 @@ import android.hardware.SensorManager;
 import android.text.Editable;
 import android.text.TextWatcher;
 import android.widget.ArrayAdapter;
+import android.widget.Button;
 import android.widget.EditText;
 import android.widget.LinearLayout;
 import android.widget.ListView;
@@ -117,65 +118,8 @@ public class ShakeMenu implements ShakeDetector.Listener, ThreeFingerPinchDetect
                     isShowing = false;
                     return;
                 }
-                if (Boolean.TRUE.equals(plugin.shakeChannelSelectorEnabled)) {
-                    showCombinedPreviewMenu();
-                    return;
-                }
-                String appName = activity.getPackageManager().getApplicationLabel(activity.getApplicationInfo()).toString();
-                String title = "Preview " + appName + " Menu";
-                String message = "Reload, switch, or leave the current preview.";
-                List<String> actions = new ArrayList<>();
-                actions.add("Reload preview");
-                if (plugin.previewMenuPreviews().length() > 0) {
-                    actions.add("Switch preview");
-                }
-                actions.add("Leave test app");
-                final boolean[] openingNestedSelector = { false };
-                final boolean[] previewActionRunning = { false };
 
-                AlertDialog.Builder builder = new AlertDialog.Builder(activity);
-                builder.setTitle(title);
-                builder.setMessage(message);
-                builder.setItems(actions.toArray(new String[0]), (dialogInterface, which) -> {
-                    AlertDialog dialog = (AlertDialog) dialogInterface;
-                    String action = actions.get(which);
-                    if ("Reload preview".equals(action)) {
-                        previewActionRunning[0] = true;
-                        logger.info("Reloading webview");
-                        runPreviewMenuAction(dialog, "Could not reload the test app.", "Error reloading test app: ", () ->
-                            plugin.reloadPreviewSessionFromShakeMenu()
-                        );
-                    } else if ("Switch preview".equals(action)) {
-                        openingNestedSelector[0] = true;
-                        dialog.dismiss();
-                        showPreviewSelector();
-                    } else {
-                        previewActionRunning[0] = true;
-                        runPreviewMenuAction(dialog, "Could not leave the test app.", "Error leaving test app: ", () ->
-                            plugin.leavePreviewSessionFromShakeMenu()
-                        );
-                    }
-                });
-
-                // Cancel button
-                builder.setNegativeButton(
-                    "Close menu",
-                    new DialogInterface.OnClickListener() {
-                        public void onClick(DialogInterface dialog, int id) {
-                            logger.info("Shake menu cancelled");
-                            dialog.dismiss();
-                            isShowing = false;
-                        }
-                    }
-                );
-
-                AlertDialog dialog = builder.create();
-                dialog.setOnDismissListener((dialogInterface) -> {
-                    if (!openingNestedSelector[0] && !previewActionRunning[0]) {
-                        isShowing = false;
-                    }
-                });
-                dialog.show();
+                showPreviewActionsMenu(Boolean.TRUE.equals(plugin.shakeChannelSelectorEnabled));
             } catch (Exception e) {
                 logger.error("Error showing shake menu: " + e.getMessage());
                 isShowing = false;
@@ -183,65 +127,95 @@ public class ShakeMenu implements ShakeDetector.Listener, ThreeFingerPinchDetect
         });
     }
 
-    private void showCombinedPreviewMenu() {
-        try {
-            String appName = activity.getPackageManager().getApplicationLabel(activity.getApplicationInfo()).toString();
-            String title = "Preview " + appName + " Menu";
-            String message = "Reload, switch, or leave the current preview.";
-            List<String> actions = new ArrayList<>();
-            actions.add("Reload preview");
-            if (plugin.previewMenuPreviews().length() > 0) {
-                actions.add("Switch preview");
-            }
-            actions.add("Leave test app");
-            actions.add("Switch channel");
-            final boolean[] openingNestedSelector = { false };
-            final boolean[] previewActionRunning = { false };
+    private void showPreviewActionsMenu(boolean includeChannelSelector) {
+        String appName = activity.getPackageManager().getApplicationLabel(activity.getApplicationInfo()).toString();
+        String title = "Preview " + appName + " Menu";
+        String message = "Reload, switch, or leave the current preview.";
+        final boolean[] openingNestedSelector = { false };
+        final boolean[] previewActionRunning = { false };
+        final AlertDialog[] dialogRef = { null };
+        List<Button> buttons = new ArrayList<>();
+
+        LinearLayout layout = new LinearLayout(activity);
+        layout.setOrientation(LinearLayout.VERTICAL);
+        int horizontalPadding = dpToPx(16);
+        int verticalPadding = dpToPx(8);
+        layout.setPadding(horizontalPadding, verticalPadding, horizontalPadding, verticalPadding);
+
+        addPreviewMenuButton(layout, buttons, "Reload preview", () -> {
+            AlertDialog dialog = dialogRef[0];
+            previewActionRunning[0] = true;
+            setPreviewMenuButtonsEnabled(buttons, false);
+            logger.info("Reloading webview");
+            runPreviewMenuAction(dialog, "Could not reload the test app.", "Error reloading test app: ", () ->
+                plugin.reloadPreviewSessionFromShakeMenu()
+            );
+        });
 
-            AlertDialog.Builder builder = new AlertDialog.Builder(activity);
-            builder.setTitle(title);
-            builder.setMessage(message);
-            builder.setItems(actions.toArray(new String[0]), (dialogInterface, which) -> {
-                AlertDialog dialog = (AlertDialog) dialogInterface;
-                String action = actions.get(which);
-                if ("Reload preview".equals(action)) {
-                    previewActionRunning[0] = true;
-                    logger.info("Reloading webview");
-                    runPreviewMenuAction(dialog, "Could not reload the test app.", "Error reloading test app: ", () ->
-                        plugin.reloadPreviewSessionFromShakeMenu()
-                    );
-                } else if ("Leave test app".equals(action)) {
-                    previewActionRunning[0] = true;
-                    runPreviewMenuAction(dialog, "Could not leave the test app.", "Error leaving test app: ", () ->
-                        plugin.leavePreviewSessionFromShakeMenu()
-                    );
-                } else if ("Switch preview".equals(action)) {
-                    openingNestedSelector[0] = true;
-                    dialog.dismiss();
-                    showPreviewSelector();
-                } else {
-                    openingNestedSelector[0] = true;
-                    dialog.dismiss();
-                    showChannelSelector();
-                }
-            });
-            builder.setNegativeButton("Close menu", (dialog, id) -> {
-                logger.info("Shake menu cancelled");
+        if (plugin.previewMenuPreviews().length() > 0) {
+            addPreviewMenuButton(layout, buttons, "Switch preview", () -> {
+                AlertDialog dialog = dialogRef[0];
+                openingNestedSelector[0] = true;
                 dialog.dismiss();
-                isShowing = false;
+                showPreviewSelector();
             });
+        }
 
-            AlertDialog dialog = builder.create();
-            dialog.setOnDismissListener((dialogInterface) -> {
-                if (!openingNestedSelector[0] && !previewActionRunning[0]) {
-                    isShowing = false;
-                }
+        if (includeChannelSelector) {
+            addPreviewMenuButton(layout, buttons, "Switch channel", () -> {
+                AlertDialog dialog = dialogRef[0];
+                openingNestedSelector[0] = true;
+                dialog.dismiss();
+                showChannelSelector();
             });
-            dialog.show();
-        } catch (Exception e) {
-            logger.error("Error showing combined shake menu: " + e.getMessage());
-            isShowing = false;
         }
+
+        addPreviewMenuButton(layout, buttons, "Leave test app", () -> {
+            AlertDialog dialog = dialogRef[0];
+            previewActionRunning[0] = true;
+            setPreviewMenuButtonsEnabled(buttons, false);
+            runPreviewMenuAction(dialog, "Could not leave the test app.", "Error leaving test app: ", () ->
+                plugin.leavePreviewSessionFromShakeMenu()
+            );
+        });
+
+        addPreviewMenuButton(layout, buttons, "Close menu", () -> {
+            AlertDialog dialog = dialogRef[0];
+            if (dialog != null) {
+                logger.info("Shake menu cancelled");
+                dialog.dismiss();
+                isShowing = false;
+            }
+        });
+
+        AlertDialog.Builder builder = new AlertDialog.Builder(activity);
+        builder.setTitle(title);
+        builder.setMessage(message);
+        builder.setView(layout);
+
+        AlertDialog dialog = builder.create();
+        dialogRef[0] = dialog;
+        dialog.setOnDismissListener((dialogInterface) -> {
+            if (!openingNestedSelector[0] && !previewActionRunning[0]) {
+                isShowing = false;
+            }
+        });
+        dialog.show();
+    }
+
+    private void addPreviewMenuButton(LinearLayout layout, List<Button> buttons, String title, Runnable action) {
+        Button button = new Button(activity);
+        button.setAllCaps(false);
+        button.setText(title);
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
+            LinearLayout.LayoutParams.MATCH_PARENT,
+            LinearLayout.LayoutParams.WRAP_CONTENT
+        );
+        params.setMargins(0, 0, 0, dpToPx(8));
+        button.setLayoutParams(params);
+        button.setOnClickListener((view) -> action.run());
+        buttons.add(button);
+        layout.addView(button);
     }
 
     private void runPreviewMenuAction(AlertDialog dialog, String failureMessage, String errorPrefix, PreviewMenuAction action) {
@@ -262,10 +236,10 @@ public class ShakeMenu implements ShakeDetector.Listener, ThreeFingerPinchDetect
         }).start();
     }
 
-    private void setPreviewMenuButtonsEnabled(AlertDialog dialog, boolean enabled) {
-        dialog.getButton(AlertDialog.BUTTON_POSITIVE).setEnabled(enabled);
-        dialog.getButton(AlertDialog.BUTTON_NEUTRAL).setEnabled(enabled);
-        dialog.getButton(AlertDialog.BUTTON_NEGATIVE).setEnabled(enabled);
+    private void setPreviewMenuButtonsEnabled(List<Button> buttons, boolean enabled) {
+        for (Button button : buttons) {
+            button.setEnabled(enabled);
+        }
     }
 
     private void showPreviewSelector() {
@@ -299,7 +273,7 @@ public class ShakeMenu implements ShakeDetector.Listener, ThreeFingerPinchDetect
         String name = preview.optString("name", "");
         JSObject bundle = preview.getJSObject("bundle");
         String version = bundle == null ? "" : bundle.optString("version", "");
-        String label = !name.isEmpty() ? name : (!version.isEmpty() ? version : preview.optString("id", "Preview"));
+        String label = !name.isEmpty() ? name : !version.isEmpty() ? version : preview.optString("id", "Preview");
         if (preview.optBoolean("isActive", false)) {
             label += " (current)";
         }

package/dist/docs.json

@@ -156,7 +156,7 @@
             "text": "{Error} If the download fails or the bundle is invalid."
           }
         ],
-        "docs": "Download a new bundle from the provided URL for later installation.\n\nThe downloaded bundle is stored locally but not activated. To use it:\n- Call {@link next} to set it for installation on next app backgrounding/restart\n- Call {@link set} to activate it immediately (destroys current JavaScript context)\n\nThe URL should point to a zip file containing either:\n- Your app files directly in the zip root, or\n- A single folder containing all your app files\n\nThe bundle must include an `index.html` file at the root level.\n\nFor encrypted bundles, provide the `sessionKey` and `checksum` parameters.\nFor multi-file delta updates, provide the `manifest` array.\n\n**Android Background Runner note:** `@capacitor/background-runner` loads its\nconfigured runner script from native APK assets. Live updates cannot replace\nthat runner script. Keep it stable across OTA updates and ship a native app\nupdate when the runner code changes.",
+        "docs": "Download a new bundle from the provided URL for later installation.\n\nThe downloaded bundle is stored locally but not activated. To use it:\n- Call {@link next} to set it for installation on next app backgrounding/restart\n- Call {@link set} to activate it immediately (destroys current JavaScript context)\n\nThe URL should point to a zip file containing either:\n- Your app files directly in the zip root, or\n- A single folder containing all your app files\n\nThe bundle must include an `index.html` file at the root level.\n\nFor encrypted bundles, provide the `sessionKey` and `checksum` parameters.\nFor multi-file delta updates, provide the `manifest` array.\n\n**Android Background Runner note:** `@capacitor/background-runner` loads its\nconfigured runner script from native APK assets. Live updates cannot replace\nthat runner script. Keep it stable across OTA updates and ship a native app\nupdate when the runner code changes. When a bundle switch happens, Capacitor\nUpdater cancels and reschedules configured Background Runner WorkManager jobs\nand syncs the bundled runner script into native `public/` storage when present.",
         "complexTypes": [
           "BundleInfo",
           "DownloadOptions"
@@ -4468,6 +4468,14 @@
         {
           "text": "'downloading'",
           "complexTypes": []
+        },
+        {
+          "text": "'deleted'",
+          "complexTypes": []
+        },
+        {
+          "text": "'deleting'",
+          "complexTypes": []
         }
       ]
     },
@@ -4623,7 +4631,7 @@
               "name": "example"
             }
           ],
-          "docs": "Configure how the plugin checks for, downloads, and applies live updates.\n\nThe plugin checks for updates when the app moves to the foreground and, if\n{@link periodCheckDelay} is set, on a repeating timer while the app stays open.\n\nBoolean values keep their existing behavior:\n- `true`: Same as `\"atBackground\"`.\n- `false`: Same as `\"off\"`.\n\nString values merge the previous Auto Update and Direct Update configuration:\n- `\"off\"`: Disable automatic update checks.\n- `\"atBackground\"`: Check and download automatically on each foreground check, then apply the update the next time the app moves to background.\n- `\"atInstall\"`: Apply immediately only after a fresh install or native app store update; otherwise use `\"atBackground\"` behavior.\n- `\"onLaunch\"`: Apply immediately only when the app is brought to the foreground from a killed state (cold start). After that first check, fall back to `\"atBackground\"` behavior.\n- `\"always\"`: Check on every foreground transition and apply immediately whenever an update is available.\n- `\"onlyDownload\"`: Check and download automatically, emit `updateAvailable`, and never set the next bundle or apply an update automatically.\n\nOnly available for Android and iOS.",
+          "docs": "Configure how the plugin checks for, downloads, and applies live updates.\n\nThe plugin checks for updates when the app moves to the foreground. When\n{@link periodCheckDelay} is greater than 0, it also checks on a repeating timer\nwhile the app stays open.\n\nBoolean values keep their existing behavior:\n- `true`: Same as `\"atBackground\"`.\n- `false`: Same as `\"off\"`.\n\nString values merge the previous Auto Update and Direct Update configuration:\n- `\"off\"`: Disable automatic update checks.\n- `\"atBackground\"`: Check and download automatically on each foreground check, then apply the update the next time the app moves to background.\n- `\"atInstall\"`: Apply immediately only after a fresh install or native app store update; otherwise use `\"atBackground\"` behavior.\n- `\"onLaunch\"`: Apply immediately only when the app is brought to the foreground from a killed state (cold start). After that first check, fall back to `\"atBackground\"` behavior.\n- `\"always\"`: Check on every foreground transition and apply immediately whenever an update is available.\n- `\"onlyDownload\"`: Check and download automatically, emit `updateAvailable`, and never set the next bundle or apply an update automatically.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
           "type": "boolean | 'always' | 'off' | 'atBackground' | 'atInstall' | 'onLaunch' | 'onlyDownload' | undefined"
         },
@@ -4687,7 +4695,7 @@
               "name": "example"
             }
           ],
-          "docs": "Configure the URL / endpoint to which update statistics are sent.\n\nOnly available for Android and iOS. Set to \"\" to disable stats reporting.\nNative stats include update lifecycle events, app health signals such as crashes,\nAndroid ANRs, low-memory exits, iOS memory warnings, and WebView health signals\nsuch as JavaScript errors, unhandled promise rejections, resource load failures,\nWebView renderer exits, and unclean WebView restarts when available.",
+          "docs": "Configure the URL / endpoint to which update statistics are sent.\n\nOnly available for Android and iOS. Set to \"\" to disable stats reporting.\nNative stats include update lifecycle events, app health signals such as crashes,\nAndroid ANRs, low-memory exits, iOS memory warnings, and WebView health signals\nsuch as JavaScript errors, unhandled promise rejections, resource load failures,\nWebView renderer exits, unclean WebView restarts, app launch readiness timing,\nand WebView load milestones when available.",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -4727,7 +4735,7 @@
           "name": "directUpdate",
           "tags": [
             {
-              "text": "Use {@link PluginsConfig.CapacitorUpdater.autoUpdate} string modes instead.\nWorks well for apps less than 10MB and with uploads done using --delta flag.\nZip or apps more than 10MB will be relatively slow for users to update.\n- false: Never do direct updates (use default behavior: download on foreground check, apply when backgrounded)\n- atInstall: Direct update only after app install or native app store update, otherwise act as directUpdate = false\n- onLaunch: Direct update only when the app is brought to the foreground from a killed state, otherwise act as directUpdate = false\n- always: Direct update on every foreground check whenever an update is available, never act as directUpdate = false\n- true: (deprecated) Same as \"always\" for backward compatibility\n\nActivate this flag will automatically make the CLI upload delta in CICD envs and will ask for confirmation in local uploads.\nOnly available for Android and iOS.",
+              "text": "Use {@link PluginsConfig.CapacitorUpdater.autoUpdate} string modes instead.\nWorks well for apps less than 10MB and with uploads done using --delta flag.\nZip or apps more than 10MB will be relatively slow for users to update.\n- false: Never do direct updates\n- atInstall: Same as `\"atInstall\"` for {@link autoUpdate}\n- onLaunch: Same as `\"onLaunch\"` for {@link autoUpdate}\n- always: Same as `\"always\"` for {@link autoUpdate}\n- true: (deprecated) Same as \"always\" for backward compatibility\n\nActivate this flag will automatically make the CLI upload delta in CICD envs and will ask for confirmation in local uploads.\nOnly available for Android and iOS.",
               "name": "deprecated"
             },
             {
@@ -4807,7 +4815,7 @@
               "name": "example"
             }
           ],
-          "docs": "Configure the delay period for period update check. the unit is in seconds.\n\nOnly available for Android and iOS.\nCannot be less than 600 seconds (10 minutes).",
+          "docs": "Configure the interval in seconds for repeating update checks while the app stays open.\nForeground checks still run when this is 0. Values below 600 are normalized to 600.\n\nOnly available for Android and iOS.\nCannot be less than 600 seconds (10 minutes).",
           "complexTypes": [],
           "type": "number | undefined"
         },

package/dist/esm/definitions.d.ts

@@ -44,8 +44,9 @@ declare module '@capacitor/cli' {
             /**
              * Configure how the plugin checks for, downloads, and applies live updates.
              *
-             * The plugin checks for updates when the app moves to the foreground and, if
-             * {@link periodCheckDelay} is set, on a repeating timer while the app stays open.
+             * The plugin checks for updates when the app moves to the foreground. When
+             * {@link periodCheckDelay} is greater than 0, it also checks on a repeating timer
+             * while the app stays open.
              *
              * Boolean values keep their existing behavior:
              * - `true`: Same as `"atBackground"`.
@@ -99,7 +100,8 @@ declare module '@capacitor/cli' {
              * Native stats include update lifecycle events, app health signals such as crashes,
              * Android ANRs, low-memory exits, iOS memory warnings, and WebView health signals
              * such as JavaScript errors, unhandled promise rejections, resource load failures,
-             * WebView renderer exits, and unclean WebView restarts when available.
+             * WebView renderer exits, unclean WebView restarts, app launch readiness timing,
+             * and WebView load milestones when available.
              *
              * @default https://plugin.capgo.app/stats
              * @example https://example.com/api/stats
@@ -130,10 +132,10 @@ declare module '@capacitor/cli' {
              * @deprecated Use {@link PluginsConfig.CapacitorUpdater.autoUpdate} string modes instead.
              * Works well for apps less than 10MB and with uploads done using --delta flag.
              * Zip or apps more than 10MB will be relatively slow for users to update.
-             * - false: Never do direct updates (use default behavior: download on foreground check, apply when backgrounded)
-             * - atInstall: Direct update only after app install or native app store update, otherwise act as directUpdate = false
-             * - onLaunch: Direct update only when the app is brought to the foreground from a killed state, otherwise act as directUpdate = false
-             * - always: Direct update on every foreground check whenever an update is available, never act as directUpdate = false
+             * - false: Never do direct updates
+             * - atInstall: Same as `"atInstall"` for {@link autoUpdate}
+             * - onLaunch: Same as `"onLaunch"` for {@link autoUpdate}
+             * - always: Same as `"always"` for {@link autoUpdate}
              * - true: (deprecated) Same as "always" for backward compatibility
              *
              * Activate this flag will automatically make the CLI upload delta in CICD envs and will ask for confirmation in local uploads.
@@ -181,7 +183,8 @@ declare module '@capacitor/cli' {
              */
             autoSplashscreenTimeout?: number;
             /**
-             * Configure the delay period for period update check. the unit is in seconds.
+             * Configure the interval in seconds for repeating update checks while the app stays open.
+             * Foreground checks still run when this is 0. Values below 600 are normalized to 600.
              *
              * Only available for Android and iOS.
              * Cannot be less than 600 seconds (10 minutes).
@@ -485,7 +488,9 @@ export interface CapacitorUpdaterPlugin {
      * **Android Background Runner note:** `@capacitor/background-runner` loads its
      * configured runner script from native APK assets. Live updates cannot replace
      * that runner script. Keep it stable across OTA updates and ship a native app
-     * update when the runner code changes.
+     * update when the runner code changes. When a bundle switch happens, Capacitor
+     * Updater cancels and reschedules configured Background Runner WorkManager jobs
+     * and syncs the bundled runner script into native `public/` storage when present.
      *
      * @example
      * const bundle = await CapacitorUpdater.download({
@@ -1599,7 +1604,7 @@ export interface CapacitorUpdaterPlugin {
  * success: The bundle has been downloaded and is ready to be **SET** as the next bundle.
  * error: The bundle has failed to download.
  */
-export type BundleStatus = 'success' | 'error' | 'pending' | 'downloading';
+export type BundleStatus = 'success' | 'error' | 'pending' | 'downloading' | 'deleted' | 'deleting';
 export type DelayUntilNext = 'background' | 'kill' | 'nativeVersion' | 'date';
 /**
  * Classification for update-check responses that do not provide a downloadable bundle.