@capgo/capacitor-updater 7.42.3 → 7.43.3

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

@@ -10,8 +10,19 @@ import android.app.Activity;
 import android.app.AlertDialog;
 import android.content.DialogInterface;
 import android.hardware.SensorManager;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.widget.ArrayAdapter;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.ListView;
+import android.widget.ProgressBar;
 import com.getcapacitor.Bridge;
 import com.getcapacitor.BridgeActivity;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import org.json.JSONArray;
 
 public class ShakeMenu implements ShakeDetector.Listener {
 
@@ -54,10 +65,16 @@ public class ShakeMenu implements ShakeDetector.Listener {
         }
 
         isShowing = true;
-        showShakeMenu();
+
+        // Check if channel selector mode is enabled
+        if (plugin.shakeChannelSelectorEnabled) {
+            showChannelSelector();
+        } else {
+            showDefaultMenu();
+        }
     }
 
-    private void showShakeMenu() {
+    private void showDefaultMenu() {
         activity.runOnUiThread(() -> {
             try {
                 String appName = activity.getPackageManager().getApplicationLabel(activity.getApplicationInfo()).toString();
@@ -166,4 +183,421 @@ public class ShakeMenu implements ShakeDetector.Listener {
             }
         });
     }
+
+    private void showChannelSelector() {
+        activity.runOnUiThread(() -> {
+            try {
+                // Show loading dialog
+                AlertDialog.Builder loadingBuilder = new AlertDialog.Builder(activity);
+                loadingBuilder.setTitle("Loading Channels...");
+                loadingBuilder.setCancelable(true);
+
+                ProgressBar progressBar = new ProgressBar(activity);
+                progressBar.setIndeterminate(true);
+                int padding = dpToPx(20);
+                progressBar.setPadding(padding, padding, padding, padding);
+                loadingBuilder.setView(progressBar);
+
+                final boolean[] didCancel = { false };
+
+                loadingBuilder.setNegativeButton("Cancel", (dialog, which) -> {
+                    didCancel[0] = true;
+                    dialog.dismiss();
+                    isShowing = false;
+                });
+
+                AlertDialog loadingDialog = loadingBuilder.create();
+                loadingDialog.setOnCancelListener((d) -> {
+                    didCancel[0] = true;
+                    isShowing = false;
+                });
+                loadingDialog.setOnDismissListener((d) -> {
+                    if (didCancel[0]) {
+                        isShowing = false;
+                    }
+                });
+                loadingDialog.show();
+
+                // Fetch channels in background
+                new Thread(() -> {
+                    final CapgoUpdater updater = plugin.implementation;
+                    updater.listChannels((res) -> {
+                        activity.runOnUiThread(() -> {
+                            loadingDialog.dismiss();
+
+                            if (didCancel[0]) {
+                                return;
+                            }
+
+                            if (res == null) {
+                                showError("Failed to load channels: unknown error");
+                                return;
+                            }
+
+                            Object errorObj = res.get("error");
+                            if (errorObj != null) {
+                                Object messageObj = res.get("message");
+                                String message = messageObj != null ? messageObj.toString() : errorObj.toString();
+                                showError("Failed to load channels: " + message);
+                                return;
+                            }
+
+                            Object channelsObj = res.get("channels");
+                            if (!(channelsObj instanceof List)) {
+                                showError("No channels available for self-assignment");
+                                return;
+                            }
+
+                            List<?> channelsRaw = (List<?>) channelsObj;
+                            List<Map<String, Object>> channels = new ArrayList<>();
+                            for (Object item : channelsRaw) {
+                                if (item instanceof Map) {
+                                    channels.add((Map<String, Object>) item);
+                                }
+                            }
+
+                            if (channels.isEmpty()) {
+                                showError("No channels available for self-assignment");
+                                return;
+                            }
+
+                            presentChannelPicker(channels);
+                        });
+                    });
+                })
+                    .start();
+            } catch (Exception e) {
+                logger.error("Error showing channel selector: " + e.getMessage());
+                isShowing = false;
+            }
+        });
+    }
+
+    private void presentChannelPicker(List<Map<String, Object>> channels) {
+        try {
+            AlertDialog.Builder builder = new AlertDialog.Builder(activity);
+            builder.setTitle("Select Channel");
+
+            // Create custom layout with search and channel list
+            LinearLayout layout = new LinearLayout(activity);
+            layout.setOrientation(LinearLayout.VERTICAL);
+            int padding = dpToPx(16);
+            layout.setPadding(padding, padding, padding, padding);
+
+            // Search field
+            EditText searchField = new EditText(activity);
+            searchField.setHint("Search channels...");
+            searchField.setSingleLine(true);
+            layout.addView(searchField);
+
+            // Create list of channel names
+            List<String> allChannelNames = new ArrayList<>();
+            for (Map<String, Object> channel : channels) {
+                Object nameObj = channel.get("name");
+                if (nameObj instanceof String) {
+                    allChannelNames.add((String) nameObj);
+                }
+            }
+
+            // Displayed channels (first 5 by default)
+            final List<String> displayedChannels = new ArrayList<>();
+            displayedChannels.addAll(allChannelNames.subList(0, Math.min(5, allChannelNames.size())));
+
+            final ArrayAdapter<String> adapter = new ArrayAdapter<>(activity, android.R.layout.simple_list_item_1, displayedChannels);
+
+            ListView listView = new ListView(activity);
+            listView.setAdapter(adapter);
+
+            // Set fixed height for list (about 5 items)
+            LinearLayout.LayoutParams listParams = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, dpToPx(250));
+            listView.setLayoutParams(listParams);
+            layout.addView(listView);
+
+            builder.setView(layout);
+            builder.setNegativeButton("Cancel", (dialog, which) -> {
+                dialog.dismiss();
+                isShowing = false;
+            });
+
+            AlertDialog dialog = builder.create();
+            dialog.setOnDismissListener((d) -> isShowing = false);
+
+            // Search filter
+            searchField.addTextChangedListener(
+                new TextWatcher() {
+                    @Override
+                    public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+                    @Override
+                    public void onTextChanged(CharSequence s, int start, int before, int count) {}
+
+                    @Override
+                    public void afterTextChanged(Editable s) {
+                        String query = s.toString().toLowerCase();
+                        displayedChannels.clear();
+
+                        int count = 0;
+                        for (String name : allChannelNames) {
+                            if (name.toLowerCase().contains(query)) {
+                                displayedChannels.add(name);
+                                count++;
+                                if (count >= 5) break;
+                            }
+                        }
+
+                        adapter.notifyDataSetChanged();
+                    }
+                }
+            );
+
+            // Channel selection
+            listView.setOnItemClickListener((parent, view, position, id) -> {
+                String selectedChannel = displayedChannels.get(position);
+                dialog.dismiss();
+                selectChannel(selectedChannel);
+            });
+
+            dialog.show();
+        } catch (Exception e) {
+            logger.error("Error presenting channel picker: " + e.getMessage());
+            isShowing = false;
+        }
+    }
+
+    private void selectChannel(String channelName) {
+        activity.runOnUiThread(() -> {
+            try {
+                // Show progress dialog
+                AlertDialog.Builder progressBuilder = new AlertDialog.Builder(activity);
+                progressBuilder.setTitle("Switching to " + channelName);
+                progressBuilder.setMessage("Setting channel...");
+                progressBuilder.setCancelable(false);
+
+                ProgressBar progressBar = new ProgressBar(activity);
+                progressBar.setIndeterminate(true);
+                int padding = dpToPx(20);
+                progressBar.setPadding(padding, padding, padding, padding);
+                progressBuilder.setView(progressBar);
+
+                AlertDialog progressDialog = progressBuilder.create();
+                progressDialog.show();
+
+                new Thread(() -> {
+                    final CapgoUpdater updater = plugin.implementation;
+                    final Bridge bridge = activity.getBridge();
+
+                    // Set the channel - respect plugin's allowSetDefaultChannel config
+                    updater.setChannel(
+                        channelName,
+                        updater.editor,
+                        "CapacitorUpdater.defaultChannel",
+                        plugin.allowSetDefaultChannel,
+                        (setRes) -> {
+                            if (setRes == null) {
+                                activity.runOnUiThread(() -> {
+                                    progressDialog.dismiss();
+                                    showError("Failed to set channel: unknown error");
+                                });
+                                return;
+                            }
+
+                            Object errorObj = setRes.get("error");
+                            if (errorObj != null) {
+                                Object messageObj = setRes.get("message");
+                                String message = messageObj != null ? messageObj.toString() : errorObj.toString();
+                                activity.runOnUiThread(() -> {
+                                    progressDialog.dismiss();
+                                    showError("Failed to set channel: " + message);
+                                });
+                                return;
+                            }
+
+                            // Update progress message
+                            activity.runOnUiThread(() -> progressDialog.setMessage("Checking for updates..."));
+
+                            // Check for updates
+                            String updateUrlStr = plugin.getUpdateUrl();
+                            if (updateUrlStr == null || updateUrlStr.isEmpty()) {
+                                updateUrlStr = "https://plugin.capgo.app/updates";
+                            }
+
+                            final String finalUpdateUrlStr = updateUrlStr;
+                            updater.getLatest(finalUpdateUrlStr, channelName, (latestRes) -> {
+                                if (latestRes == null) {
+                                    activity.runOnUiThread(() -> {
+                                        progressDialog.dismiss();
+                                        showSuccess("Channel set to " + channelName + ". Could not check for updates.");
+                                    });
+                                    return;
+                                }
+
+                                String latestError = getString(latestRes, "error");
+
+                                // Handle update errors first (before "no new version" check)
+                                if (latestError != null && !latestError.isEmpty() && !"no_new_version_available".equals(latestError)) {
+                                    activity.runOnUiThread(() -> {
+                                        progressDialog.dismiss();
+                                        showError("Channel set to " + channelName + ". Update check failed: " + latestError);
+                                    });
+                                    return;
+                                }
+
+                                String latestUrl = getString(latestRes, "url");
+
+                                // Check if there's an actual update available
+                                if ("no_new_version_available".equals(latestError) || latestUrl == null || latestUrl.isEmpty()) {
+                                    activity.runOnUiThread(() -> {
+                                        progressDialog.dismiss();
+                                        showSuccess("Channel set to " + channelName + ". Already on latest version.");
+                                    });
+                                    return;
+                                }
+
+                                String version = getString(latestRes, "version");
+                                if (version == null || version.isEmpty()) {
+                                    activity.runOnUiThread(() -> {
+                                        progressDialog.dismiss();
+                                        showError("Channel set to " + channelName + ". Update check failed: missing version.");
+                                    });
+                                    return;
+                                }
+
+                                // Update message
+                                final String versionForUi = version;
+                                activity.runOnUiThread(() -> progressDialog.setMessage("Downloading update " + versionForUi + "..."));
+
+                                String sessionKey = getString(latestRes, "sessionKey");
+                                String checksum = getString(latestRes, "checksum");
+                                Object manifestObj = latestRes.get("manifest");
+
+                                // Download the update
+                                try {
+                                    BundleInfo bundle;
+                                    if (manifestObj != null) {
+                                        JSONArray manifestArray = null;
+                                        if (manifestObj instanceof JSONArray) {
+                                            manifestArray = (JSONArray) manifestObj;
+                                        } else if (manifestObj instanceof List) {
+                                            manifestArray = new JSONArray((List<?>) manifestObj);
+                                        }
+
+                                        if (manifestArray == null) {
+                                            throw new IllegalArgumentException("Invalid manifest format");
+                                        }
+
+                                        bundle = updater.downloadManifest(
+                                            latestUrl,
+                                            versionForUi,
+                                            sessionKey != null ? sessionKey : "",
+                                            checksum != null ? checksum : "",
+                                            manifestArray
+                                        );
+                                    } else {
+                                        bundle = updater.download(
+                                            latestUrl,
+                                            versionForUi,
+                                            sessionKey != null ? sessionKey : "",
+                                            checksum != null ? checksum : ""
+                                        );
+                                    }
+
+                                    // Set as next bundle
+                                    updater.setNextBundle(bundle.getId());
+
+                                    activity.runOnUiThread(() -> {
+                                        progressDialog.dismiss();
+                                        showSuccessWithReload("Update downloaded! Reload to apply version " + versionForUi + "?", () -> {
+                                            try {
+                                                if (bridge == null) {
+                                                    logger.warn("Bridge is null, cannot reload app");
+                                                    return;
+                                                }
+                                                updater.set(bundle);
+                                                String path = updater.getCurrentBundlePath();
+                                                if (updater.isUsingBuiltin()) {
+                                                    bridge.setServerAssetPath(path);
+                                                } else {
+                                                    bridge.setServerBasePath(path);
+                                                }
+                                                if (bridge.getWebView() != null) {
+                                                    bridge.getWebView().reload();
+                                                }
+                                            } catch (Exception e) {
+                                                logger.error("Error applying bundle before reload: " + e.getMessage());
+                                            }
+                                        });
+                                    });
+                                } catch (Exception e) {
+                                    activity.runOnUiThread(() -> {
+                                        progressDialog.dismiss();
+                                        showError("Failed to download update: " + e.getMessage());
+                                    });
+                                }
+                            });
+                        }
+                    );
+                })
+                    .start();
+            } catch (Exception e) {
+                logger.error("Error selecting channel: " + e.getMessage());
+                isShowing = false;
+            }
+        });
+    }
+
+    private void showError(String message) {
+        logger.error(message);
+        new AlertDialog.Builder(activity)
+            .setTitle("Error")
+            .setMessage(message)
+            .setPositiveButton("OK", (d, w) -> {
+                d.dismiss();
+                isShowing = false;
+            })
+            .setOnDismissListener((d) -> isShowing = false)
+            .show();
+    }
+
+    private void showSuccess(String message) {
+        logger.info(message);
+        new AlertDialog.Builder(activity)
+            .setTitle("Success")
+            .setMessage(message)
+            .setPositiveButton("OK", (d, w) -> {
+                d.dismiss();
+                isShowing = false;
+            })
+            .setOnDismissListener((d) -> isShowing = false)
+            .show();
+    }
+
+    private void showSuccessWithReload(String message, Runnable onReload) {
+        logger.info(message);
+        new AlertDialog.Builder(activity)
+            .setTitle("Update Ready")
+            .setMessage(message)
+            .setPositiveButton("Reload Now", (d, w) -> {
+                d.dismiss();
+                isShowing = false;
+                if (onReload != null) {
+                    onReload.run();
+                }
+            })
+            .setNegativeButton("Later", (d, w) -> {
+                d.dismiss();
+                isShowing = false;
+            })
+            .setOnDismissListener((d) -> isShowing = false)
+            .show();
+    }
+
+    private String getString(Map<String, Object> map, String key) {
+        Object value = map.get(key);
+        return value != null ? value.toString() : null;
+    }
+
+    private int dpToPx(int dp) {
+        float density = activity.getResources().getDisplayMetrics().density;
+        return Math.round(dp * density);
+    }
 }

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 partial updates, provide the `manifest` array.",
+        "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.",
         "complexTypes": [
           "BundleInfo",
           "DownloadOptions"
@@ -499,7 +499,7 @@
             "text": "4.0.0"
           }
         ],
-        "docs": "Check the update server for the latest available bundle version.\n\nThis queries your configured update URL (or Capgo backend) to see if a newer bundle\nis available for download. It does NOT download the bundle automatically.\n\nThe response includes:\n- `version`: The latest available version identifier\n- `url`: Download URL for the bundle (if available)\n- `breaking`: Whether this update is marked as incompatible (requires native app update)\n- `message`: Optional message from the server\n- `manifest`: File list for partial updates (if using multi-file downloads)\n\nAfter receiving the latest version info, you can:\n1. Compare it with your current version\n2. Download it using {@link download}\n3. Apply it using {@link next} or {@link set}\n\n**Important: Error handling for \"no new version available\"**\n\nWhen the device's current version matches the latest version on the server (i.e., the device is already\nup-to-date), the server returns a 200 response with `error: \"no_new_version_available\"` and\n`message: \"No new version available\"`. **This causes `getLatest()` to throw an error**, even though\nthis is a normal, expected condition.\n\nYou should catch this specific error to handle it gracefully:\n\n```typescript\ntry {\n  const latest = await CapacitorUpdater.getLatest();\n  // New version is available, proceed with download\n} catch (error) {\n  if (error.message === 'No new version available') {\n    // Device is already on the latest version - this is normal\n    console.log('Already up to date');\n  } else {\n    // Actual error occurred\n    console.error('Failed to check for updates:', error);\n  }\n}\n```\n\nIn this scenario, the server:\n- Logs the request with a \"No new version available\" message\n- Sends a \"noNew\" stat action to track that the device checked for updates but was already current (done on the backend)",
+        "docs": "Check the update server for the latest available bundle version.\n\nThis queries your configured update URL (or Capgo backend) to see if a newer bundle\nis available for download. It does NOT download the bundle automatically.\n\nThe response includes:\n- `version`: The latest available version identifier\n- `url`: Download URL for the bundle (if available)\n- `breaking`: Whether this update is marked as incompatible (requires native app update)\n- `message`: Optional message from the server\n- `manifest`: File list for delta updates (if using multi-file downloads)\n\nAfter receiving the latest version info, you can:\n1. Compare it with your current version\n2. Download it using {@link download}\n3. Apply it using {@link next} or {@link set}\n\n**Important: Error handling for \"no new version available\"**\n\nWhen the device's current version matches the latest version on the server (i.e., the device is already\nup-to-date), the server returns a 200 response with `error: \"no_new_version_available\"` and\n`message: \"No new version available\"`. **This causes `getLatest()` to throw an error**, even though\nthis is a normal, expected condition.\n\nYou should catch this specific error to handle it gracefully:\n\n```typescript\ntry {\n  const latest = await CapacitorUpdater.getLatest();\n  // New version is available, proceed with download\n} catch (error) {\n  if (error.message === 'No new version available') {\n    // Device is already on the latest version - this is normal\n    console.log('Already up to date');\n  } else {\n    // Actual error occurred\n    console.error('Failed to check for updates:', error);\n  }\n}\n```\n\nIn this scenario, the server:\n- Logs the request with a \"No new version available\" message\n- Sends a \"noNew\" stat action to track that the device checked for updates but was already current (done on the backend)",
         "complexTypes": [
           "LatestVersion",
           "GetLatestOptions"
@@ -1255,6 +1255,70 @@
         ],
         "slug": "isshakemenuenabled"
       },
+      {
+        "name": "setShakeChannelSelector",
+        "signature": "(options: SetShakeChannelSelectorOptions) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "SetShakeChannelSelectorOptions"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options"
+          },
+          {
+            "name": "link",
+            "text": "SetShakeChannelSelectorOptions} with `enabled: true` to enable or `enabled: false` to disable."
+          },
+          {
+            "name": "returns",
+            "text": "Resolves when the setting is applied."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If the operation fails."
+          },
+          {
+            "name": "since",
+            "text": "8.43.0"
+          }
+        ],
+        "docs": "Enable or disable the shake channel selector at runtime.\n\nWhen enabled AND shakeMenu is true, shaking the device shows a channel\nselector instead of the debug menu. This allows users to switch between\nupdate channels by shaking their device.\n\nAfter selecting a channel, the app automatically checks for updates\nand downloads if available.\n\nCan also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.",
+        "complexTypes": [
+          "SetShakeChannelSelectorOptions"
+        ],
+        "slug": "setshakechannelselector"
+      },
+      {
+        "name": "isShakeChannelSelectorEnabled",
+        "signature": "() => Promise<ShakeChannelSelectorEnabled>",
+        "parameters": [],
+        "returns": "Promise<ShakeChannelSelectorEnabled>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Object with `enabled: true` or `enabled: false`."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If the operation fails."
+          },
+          {
+            "name": "since",
+            "text": "8.43.0"
+          }
+        ],
+        "docs": "Check if the shake channel selector is currently enabled.\n\nReturns the current state of the shake channel selector feature that can be toggled via\n{@link setShakeChannelSelector} or configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.",
+        "complexTypes": [
+          "ShakeChannelSelectorEnabled"
+        ],
+        "slug": "isshakechannelselectorenabled"
+      },
       {
         "name": "getAppId",
         "signature": "() => Promise<GetAppIdRes>",
@@ -1932,7 +1996,7 @@
               "name": "since"
             }
           ],
-          "docs": "File list for partial updates (when using multi-file downloads).",
+          "docs": "File list for delta updates (when using multi-file downloads).",
           "complexTypes": [
             "ManifestEntry"
           ],
@@ -2614,6 +2678,38 @@
         }
       ]
     },
+    {
+      "name": "SetShakeChannelSelectorOptions",
+      "slug": "setshakechannelselectoroptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "enabled",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "name": "ShakeChannelSelectorEnabled",
+      "slug": "shakechannelselectorenabled",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "enabled",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        }
+      ]
+    },
     {
       "name": "GetAppIdRes",
       "slug": "getappidres",
@@ -3283,7 +3379,7 @@
               "name": "since"
             }
           ],
-          "docs": "Configure when the plugin should direct install updates. Only for autoUpdate mode.\nWorks well for apps less than 10MB and with uploads done using --partial 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 at start, set when backgrounded)\n- atInstall: Direct update only when app is installed, updated from store, otherwise act as directUpdate = false\n- onLaunch: Direct update only on app installed, updated from store or after app kill, otherwise act as directUpdate = false\n- always: Direct update in all previous cases (app installed, updated from store, after app kill or app resume), never act as directUpdate = false\n- true: (deprecated) Same as \"always\" for backward compatibility\n\nOnly available for Android and iOS.",
+          "docs": "Configure when the plugin should direct install updates. Only for autoUpdate mode.\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 at start, set when backgrounded)\n- atInstall: Direct update only when app is installed, updated from store, otherwise act as directUpdate = false\n- onLaunch: Direct update only on app installed, updated from store or after app kill, otherwise act as directUpdate = false\n- always: Direct update in all previous cases (app installed, updated from store, after app kill or app resume), 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.",
           "complexTypes": [],
           "type": "boolean | 'always' | 'atInstall' | 'onLaunch' | undefined"
         },
@@ -3658,6 +3754,22 @@
           "docs": "Enable shake gesture to show update menu for debugging/testing purposes",
           "complexTypes": [],
           "type": "boolean | undefined"
+        },
+        {
+          "name": "allowShakeChannelSelector",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            },
+            {
+              "text": "8.43.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Enable the shake gesture to show a channel selector menu for switching between update channels.\nWhen enabled AND `shakeMenu` is true, the shake gesture shows a channel selector\ninstead of the default debug menu (Go Home/Reload/Close).\n\nAfter selecting a channel, the app automatically checks for updates and downloads if available.\nOnly works if channels have `allow_self_set` enabled on the backend.\n\nOnly available for Android and iOS.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ],
       "docs": "CapacitorUpdater can be configured with these options:"