@capgo/capacitor-updater 8.0.0-alpha → 8.0.0-alpha.2

package/README.md

@@ -68,6 +68,16 @@ Join the [discord](https://discord.gg/VnYRvBfgA6) to get help.
 
 ## Migration to v8
 
+## Migration to v7.34
+
+- **Channel storage change**: `setChannel()` now stores channel assignments locally on the device instead of in the cloud. This provides better offline support and reduces backend load.
+  - Channel assignments persist between app restarts
+  - Use `unsetChannel()` to clear the local assignment and revert to `defaultChannel`
+  - Old devices (< v7.34.0) will continue using cloud-based storage
+- **New event**: Listen to the `channelPrivate` event to handle cases where a user tries to assign themselves to a private channel (one that doesn't allow self-assignment). See example in the `setChannel()` documentation above.
+
+## Migration to v7
+
 The min version of IOS is now 15.5 instead of 15 as Capacitor 8 requirement.
 This is due to bump of ZipArchive to latest, a key dependency of this project is the zlib library. zlib before version 1.2.12 allows memory corruption when deflating (i.e., when compressing) if the input has many distant matches according to [CVE-2018-25032](https://nvd.nist.gov/vuln/detail/cve-2018-25032).
 zlib is a native library so we need to bump the minimum iOS version to 15.5 as ZipArchive did the same in their latest versions.
@@ -273,6 +283,7 @@ CapacitorUpdater can be configured with these options:
 | **`allowManualBundleError`**  | <code>boolean</code>                                          | Allow marking bundles as errored from JavaScript while using manual update flows. When enabled, {@link CapacitorUpdaterPlugin.setBundleError} can change a bundle status to `error`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <code>false</code>                                                            | 7.20.0  |
 | **`persistCustomId`**         | <code>boolean</code>                                          | Persist the customId set through {@link CapacitorUpdaterPlugin.setCustomId} across app restarts. Only available for Android and iOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <code>false (will be true by default in a future major release v8.x.x)</code> | 7.17.3  |
 | **`persistModifyUrl`**        | <code>boolean</code>                                          | Persist the updateUrl, statsUrl and channelUrl set through {@link CapacitorUpdaterPlugin.setUpdateUrl}, {@link CapacitorUpdaterPlugin.setStatsUrl} and {@link CapacitorUpdaterPlugin.setChannelUrl} across app restarts. Only available for Android and iOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false</code>                                                            | 7.20.0  |
+| **`allowSetDefaultChannel`**  | <code>boolean</code>                                          | Allow or disallow the {@link CapacitorUpdaterPlugin.setChannel} method to modify the defaultChannel. When set to `false`, calling `setChannel()` will return an error with code `disabled_by_config`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <code>true</code>                                                             | 7.34.0  |
 | **`defaultChannel`**          | <code>string</code>                                           | Set the default channel for the app in the config. Case sensitive. This will setting will override the default channel set in the cloud, but will still respect overrides made in the cloud. This requires the channel to allow devices to self dissociate/associate in the channel settings. https://capgo.app/docs/public-api/channels/#channel-configuration-options                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <code>undefined</code>                                                        | 5.5.0   |
 | **`appId`**                   | <code>string</code>                                           | Configure the app id for the app in the config.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <code>undefined</code>                                                        | 6.0.0   |
 | **`keepUrlPathAfterReload`**  | <code>boolean</code>                                          | Configure the plugin to keep the URL path after a reload. WARNING: When a reload is triggered, 'window.history' will be cleared.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <code>false</code>                                                            | 6.8.0   |
@@ -315,6 +326,7 @@ In `capacitor.config.json`:
       "allowManualBundleError": undefined,
       "persistCustomId": undefined,
       "persistModifyUrl": undefined,
+      "allowSetDefaultChannel": undefined,
       "defaultChannel": undefined,
       "appId": undefined,
       "keepUrlPathAfterReload": undefined,
@@ -363,6 +375,7 @@ const config: CapacitorConfig = {
       allowManualBundleError: undefined,
       persistCustomId: undefined,
       persistModifyUrl: undefined,
+      allowSetDefaultChannel: undefined,
       defaultChannel: undefined,
       appId: undefined,
       keepUrlPathAfterReload: undefined,
@@ -418,6 +431,7 @@ export default config;
 * [`addListener('downloadFailed', ...)`](#addlistenerdownloadfailed-)
 * [`addListener('appReloaded', ...)`](#addlistenerappreloaded-)
 * [`addListener('appReady', ...)`](#addlistenerappready-)
+* [`addListener('channelPrivate', ...)`](#addlistenerchannelprivate-)
 * [`isAutoUpdateAvailable()`](#isautoupdateavailable)
 * [`getNextBundle()`](#getnextbundle)
 * [`getFailedUpdate()`](#getfailedupdate)
@@ -865,6 +879,34 @@ After receiving the latest version info, you can:
 2. Download it using {@link download}
 3. Apply it using {@link next} or {@link set}
 
+**Important: Error handling for "no new version available"**
+
+When the device's current version matches the latest version on the server (i.e., the device is already
+up-to-date), the server returns a 200 response with `error: "no_new_version_available"` and
+`message: "No new version available"`. **This causes `getLatest()` to throw an error**, even though
+this is a normal, expected condition.
+
+You should catch this specific error to handle it gracefully:
+
+```typescript
+try {
+  const latest = await CapacitorUpdater.getLatest();
+  // New version is available, proceed with download
+} catch (error) {
+  if (error.message === 'No new version available') {
+    // Device is already on the latest version - this is normal
+    console.log('Already up to date');
+  } else {
+    // Actual error occurred
+    console.error('Failed to check for updates:', error);
+  }
+}
+```
+
+In this scenario, the server:
+- Logs the request with a "No new version available" message
+- Sends a "noNew" stat action to track that the device checked for updates but was already current (done on the backend)
+
 | Param         | Type                                                          | Description                                                                                          |
 | ------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
 | **`options`** | <code><a href="#getlatestoptions">GetLatestOptions</a></code> | Optional {@link <a href="#getlatestoptions">GetLatestOptions</a>} to specify which channel to check. |
@@ -900,6 +942,19 @@ Channels allow you to distribute different bundle versions to different groups o
 - At app boot/initialization - use {@link PluginsConfig.CapacitorUpdater.defaultChannel} config instead
 - Before user interaction
 
+**Important: Listen for the `channelPrivate` event**
+
+When a user attempts to set a channel that doesn't allow device self-assignment, the method will
+throw an error AND fire a {@link addListener}('channelPrivate') event. You should listen to this event
+to provide appropriate feedback to users:
+
+```typescript
+CapacitorUpdater.addListener('channelPrivate', (data) =&gt; {
+  console.warn(`Cannot access channel "${data.channel}": ${data.message}`);
+  // Show user-friendly message
+});
+```
+
 This sends a request to the Capgo backend linking your device ID to the specified channel.
 
 | Param         | Type                                                            | Description                                                                                                                  |
@@ -1364,6 +1419,31 @@ Listen for app ready event in the App, let you know when app is ready to use, th
 --------------------
 
 
+#### addListener('channelPrivate', ...)
+
+```typescript
+addListener(eventName: 'channelPrivate', listenerFunc: (state: ChannelPrivateEvent) => void) => Promise<PluginListenerHandle>
+```
+
+Listen for channel private event, fired when attempting to set a channel that doesn't allow device self-assignment.
+
+This event is useful for:
+- Informing users they don't have permission to switch to a specific channel
+- Implementing custom error handling for channel restrictions
+- Logging unauthorized channel access attempts
+
+| Param              | Type                                                                                    |
+| ------------------ | --------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'channelPrivate'</code>                                                           |
+| **`listenerFunc`** | <code>(state: <a href="#channelprivateevent">ChannelPrivateEvent</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 7.34.0
+
+--------------------
+
+
 #### isAutoUpdateAvailable()
 
 ```typescript
@@ -1680,18 +1760,20 @@ If you don't use backend, you need to provide the URL and version of the bundle.
 
 ##### LatestVersion
 
-| Prop             | Type                         | Description                                                          | Since  |
-| ---------------- | ---------------------------- | -------------------------------------------------------------------- | ------ |
-| **`version`**    | <code>string</code>          | Result of getLatest method                                           | 4.0.0  |
-| **`checksum`**   | <code>string</code>          |                                                                      | 6      |
-| **`breaking`**   | <code>boolean</code>         | Indicates whether the update was flagged as breaking by the backend. | 7.22.0 |
-| **`major`**      | <code>boolean</code>         |                                                                      |        |
-| **`message`**    | <code>string</code>          |                                                                      |        |
-| **`sessionKey`** | <code>string</code>          |                                                                      |        |
-| **`error`**      | <code>string</code>          |                                                                      |        |
-| **`old`**        | <code>string</code>          |                                                                      |        |
-| **`url`**        | <code>string</code>          |                                                                      |        |
-| **`manifest`**   | <code>ManifestEntry[]</code> |                                                                      | 6.1    |
+| Prop             | Type                         | Description                                                                                                                                                                                                   | Since  |
+| ---------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
+| **`version`**    | <code>string</code>          | Result of getLatest method                                                                                                                                                                                    | 4.0.0  |
+| **`checksum`**   | <code>string</code>          |                                                                                                                                                                                                               | 6      |
+| **`breaking`**   | <code>boolean</code>         | Indicates whether the update was flagged as breaking by the backend.                                                                                                                                          | 7.22.0 |
+| **`major`**      | <code>boolean</code>         |                                                                                                                                                                                                               |        |
+| **`message`**    | <code>string</code>          | Optional message from the server. When no new version is available, this will be "No new version available".                                                                                                  |        |
+| **`sessionKey`** | <code>string</code>          |                                                                                                                                                                                                               |        |
+| **`error`**      | <code>string</code>          | Error code from the server, if any. Common values: - `"no_new_version_available"`: Device is already on the latest version (not a failure) - Other error codes indicate actual failures in the update process |        |
+| **`old`**        | <code>string</code>          | The previous/current version name (provided for reference).                                                                                                                                                   |        |
+| **`url`**        | <code>string</code>          | Download URL for the bundle (when a new version is available).                                                                                                                                                |        |
+| **`manifest`**   | <code>ManifestEntry[]</code> | File list for partial updates (when using multi-file downloads).                                                                                                                                              | 6.1    |
+| **`link`**       | <code>string</code>          | Optional link associated with this bundle version (e.g., release notes URL, changelog, GitHub release).                                                                                                       | 7.35.0 |
+| **`comment`**    | <code>string</code>          | Optional comment or description for this bundle version.                                                                                                                                                      | 7.35.0 |
 
 
 ##### GetLatestOptions
@@ -1853,6 +1935,14 @@ If you don't use backend, you need to provide the URL and version of the bundle.
 | **`status`** | <code>string</code>                               |                                       |       |
 
 
+##### ChannelPrivateEvent
+
+| Prop          | Type                | Description                                                                         | Since  |
+| ------------- | ------------------- | ----------------------------------------------------------------------------------- | ------ |
+| **`channel`** | <code>string</code> | Emitted when attempting to set a channel that doesn't allow device self-assignment. | 7.34.0 |
+| **`message`** | <code>string</code> |                                                                                     |        |
+
+
 ##### AutoUpdateAvailable
 
 | Prop            | Type                 |

package/android/build.gradle

@@ -49,16 +49,16 @@ repositories {
 
 
 dependencies {
-    def work_version = "2.11.0"
+    def work_version = "2.10.5"
     implementation "androidx.work:work-runtime:$work_version"
     implementation "com.google.android.gms:play-services-tasks:18.4.0"
-    implementation "com.google.guava:guava:33.4.8-android"
+    implementation "com.google.guava:guava:33.5.0-android"
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation 'io.github.g00fy2:versioncompare:1.5.0'
     testImplementation "junit:junit:$junitVersion"
-    testImplementation 'org.mockito:mockito-core:5.14.2'
+    testImplementation 'org.mockito:mockito-core:5.20.0'
     testImplementation 'org.json:json:20250517'
     testImplementation 'org.robolectric:robolectric:4.13'
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"

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

@@ -29,25 +29,53 @@ public class BundleInfo {
     private final String version;
     private final String checksum;
     private final BundleStatus status;
+    private final String link;
+    private final String comment;
 
     static {
         sdf.setTimeZone(TimeZone.getTimeZone("GMT"));
     }
 
     public BundleInfo(final BundleInfo source) {
-        this(source.id, source.version, source.status, source.downloaded, source.checksum);
+        this(source.id, source.version, source.status, source.downloaded, source.checksum, source.link, source.comment);
     }
 
     public BundleInfo(final String id, final String version, final BundleStatus status, final Date downloaded, final String checksum) {
-        this(id, version, status, sdf.format(downloaded), checksum);
+        this(id, version, status, sdf.format(downloaded), checksum, null, null);
+    }
+
+    public BundleInfo(
+        final String id,
+        final String version,
+        final BundleStatus status,
+        final Date downloaded,
+        final String checksum,
+        final String link,
+        final String comment
+    ) {
+        this(id, version, status, sdf.format(downloaded), checksum, link, comment);
     }
 
     public BundleInfo(final String id, final String version, final BundleStatus status, final String downloaded, final String checksum) {
+        this(id, version, status, downloaded, checksum, null, null);
+    }
+
+    public BundleInfo(
+        final String id,
+        final String version,
+        final BundleStatus status,
+        final String downloaded,
+        final String checksum,
+        final String link,
+        final String comment
+    ) {
         this.downloaded = downloaded != null ? downloaded.trim() : "";
         this.id = id != null ? id : "";
         this.version = version;
         this.checksum = checksum != null ? checksum : "";
         this.status = status != null ? status : BundleStatus.ERROR;
+        this.link = link;
+        this.comment = comment;
     }
 
     public Boolean isBuiltin() {
@@ -75,7 +103,7 @@ public class BundleInfo {
     }
 
     public BundleInfo setDownloaded(Date downloaded) {
-        return new BundleInfo(this.id, this.version, this.status, downloaded, this.checksum);
+        return new BundleInfo(this.id, this.version, this.status, downloaded, this.checksum, this.link, this.comment);
     }
 
     public String getChecksum() {
@@ -83,7 +111,7 @@ public class BundleInfo {
     }
 
     public BundleInfo setChecksum(String checksum) {
-        return new BundleInfo(this.id, this.version, this.status, this.downloaded, checksum);
+        return new BundleInfo(this.id, this.version, this.status, this.downloaded, checksum, this.link, this.comment);
     }
 
     public String getId() {
@@ -91,7 +119,7 @@ public class BundleInfo {
     }
 
     public BundleInfo setId(String id) {
-        return new BundleInfo(id, this.version, this.status, this.downloaded, this.checksum);
+        return new BundleInfo(id, this.version, this.status, this.downloaded, this.checksum, this.link, this.comment);
     }
 
     public String getVersionName() {
@@ -99,7 +127,7 @@ public class BundleInfo {
     }
 
     public BundleInfo setVersionName(String version) {
-        return new BundleInfo(this.id, version, this.status, this.downloaded, this.checksum);
+        return new BundleInfo(this.id, version, this.status, this.downloaded, this.checksum, this.link, this.comment);
     }
 
     public BundleStatus getStatus() {
@@ -110,7 +138,23 @@ public class BundleInfo {
     }
 
     public BundleInfo setStatus(BundleStatus status) {
-        return new BundleInfo(this.id, this.version, status, this.downloaded, this.checksum);
+        return new BundleInfo(this.id, this.version, status, this.downloaded, this.checksum, this.link, this.comment);
+    }
+
+    public String getLink() {
+        return this.link;
+    }
+
+    public BundleInfo setLink(String link) {
+        return new BundleInfo(this.id, this.version, this.status, this.downloaded, this.checksum, link, this.comment);
+    }
+
+    public String getComment() {
+        return this.comment;
+    }
+
+    public BundleInfo setComment(String comment) {
+        return new BundleInfo(this.id, this.version, this.status, this.downloaded, this.checksum, this.link, comment);
     }
 
     public static BundleInfo fromJSON(final String jsonString) throws JSONException {
@@ -120,7 +164,9 @@ public class BundleInfo {
             json.has("version") ? json.getString("version") : BundleInfo.VERSION_UNKNOWN,
             json.has("status") ? BundleStatus.fromString(json.getString("status")) : BundleStatus.PENDING,
             json.has("downloaded") ? json.getString("downloaded") : "",
-            json.has("checksum") ? json.getString("checksum") : ""
+            json.has("checksum") ? json.getString("checksum") : "",
+            json.has("link") ? json.getString("link") : null,
+            json.has("comment") ? json.getString("comment") : null
         );
     }
 
@@ -131,6 +177,12 @@ public class BundleInfo {
         result.put("downloaded", this.getDownloaded());
         result.put("checksum", this.getChecksum());
         result.put("status", this.getStatus().toString());
+        if (this.link != null && !this.link.isEmpty()) {
+            result.put("link", this.link);
+        }
+        if (this.comment != null && !this.comment.isEmpty()) {
+            result.put("comment", this.comment);
+        }
         return result;
     }
 

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

@@ -68,10 +68,11 @@ public class CapacitorUpdaterPlugin extends Plugin {
     private static final String UPDATE_URL_PREF_KEY = "CapacitorUpdater.updateUrl";
     private static final String STATS_URL_PREF_KEY = "CapacitorUpdater.statsUrl";
     private static final String CHANNEL_URL_PREF_KEY = "CapacitorUpdater.channelUrl";
+    private static final String DEFAULT_CHANNEL_PREF_KEY = "CapacitorUpdater.defaultChannel";
     private static final String[] BREAKING_EVENT_NAMES = { "breakingAvailable", "majorAvailable" };
     private static final String LAST_FAILED_BUNDLE_PREF_KEY = "CapacitorUpdater.lastFailedBundle";
 
-    private final String pluginVersion = "7.32.0";
+    private final String pluginVersion = "8.0.0";
     private static final String DELAY_CONDITION_PREFERENCES = "";
 
     private SharedPreferences.Editor editor;
@@ -100,6 +101,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
     private Boolean onLaunchDirectUpdateUsed = false;
     Boolean shakeMenuEnabled = false;
     private Boolean allowManualBundleError = false;
+    private Boolean allowSetDefaultChannel = true;
 
     private Boolean isPreviousMainActivity = true;
 
@@ -301,6 +303,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
 
         this.persistCustomId = this.getConfig().getBoolean("persistCustomId", false);
         this.persistModifyUrl = this.getConfig().getBoolean("persistModifyUrl", false);
+        this.allowSetDefaultChannel = this.getConfig().getBoolean("allowSetDefaultChannel", true);
         this.implementation.publicKey = this.getConfig().getString("publicKey", "");
         this.implementation.statsUrl = this.getConfig().getString("statsUrl", statsUrlDefault);
         this.implementation.channelUrl = this.getConfig().getString("channelUrl", channelUrlDefault);
@@ -320,8 +323,21 @@ public class CapacitorUpdaterPlugin extends Plugin {
                 }
             }
         }
+
+        // Load defaultChannel: first try from persistent storage (set via setChannel), then fall back to config
+        if (this.prefs.contains(DEFAULT_CHANNEL_PREF_KEY)) {
+            final String storedDefaultChannel = this.prefs.getString(DEFAULT_CHANNEL_PREF_KEY, "");
+            if (storedDefaultChannel != null && !storedDefaultChannel.isEmpty()) {
+                this.implementation.defaultChannel = storedDefaultChannel;
+                logger.info("Loaded persisted defaultChannel from setChannel()");
+            } else {
+                this.implementation.defaultChannel = this.getConfig().getString("defaultChannel", "");
+            }
+        } else {
+            this.implementation.defaultChannel = this.getConfig().getString("defaultChannel", "");
+        }
+
         int userValue = this.getConfig().getInt("periodCheckDelay", 0);
-        this.implementation.defaultChannel = this.getConfig().getString("defaultChannel", "");
 
         if (userValue >= 0 && userValue <= 600) {
             this.periodCheckDelay = 600 * 1000;
@@ -863,27 +879,33 @@ public class CapacitorUpdaterPlugin extends Plugin {
 
         try {
             logger.info("unsetChannel triggerAutoUpdate: " + triggerAutoUpdate);
-            startNewThread(() ->
-                CapacitorUpdaterPlugin.this.implementation.unsetChannel((res) -> {
-                    JSObject jsRes = mapToJSObject(res);
-                    if (jsRes.has("error")) {
-                        String errorMessage = jsRes.has("message") ? jsRes.getString("message") : jsRes.getString("error");
-                        String errorCode = jsRes.getString("error");
-
-                        JSObject errorObj = new JSObject();
-                        errorObj.put("message", errorMessage);
-                        errorObj.put("error", errorCode);
-
-                        call.reject(errorMessage, "UNSETCHANNEL_FAILED", null, errorObj);
-                    } else {
-                        if (CapacitorUpdaterPlugin.this._isAutoUpdateEnabled() && Boolean.TRUE.equals(triggerAutoUpdate)) {
-                            logger.info("Calling autoupdater after channel change!");
-                            backgroundDownload();
+            startNewThread(() -> {
+                String configDefaultChannel = CapacitorUpdaterPlugin.this.getConfig().getString("defaultChannel", "");
+                CapacitorUpdaterPlugin.this.implementation.unsetChannel(
+                    CapacitorUpdaterPlugin.this.editor,
+                    DEFAULT_CHANNEL_PREF_KEY,
+                    configDefaultChannel,
+                    (res) -> {
+                        JSObject jsRes = mapToJSObject(res);
+                        if (jsRes.has("error")) {
+                            String errorMessage = jsRes.has("message") ? jsRes.getString("message") : jsRes.getString("error");
+                            String errorCode = jsRes.getString("error");
+
+                            JSObject errorObj = new JSObject();
+                            errorObj.put("message", errorMessage);
+                            errorObj.put("error", errorCode);
+
+                            call.reject(errorMessage, "UNSETCHANNEL_FAILED", null, errorObj);
+                        } else {
+                            if (CapacitorUpdaterPlugin.this._isAutoUpdateEnabled() && Boolean.TRUE.equals(triggerAutoUpdate)) {
+                                logger.info("Calling autoupdater after channel change!");
+                                backgroundDownload();
+                            }
+                            call.resolve(jsRes);
                         }
-                        call.resolve(jsRes);
                     }
-                })
-            );
+                );
+            });
         } catch (final Exception e) {
             logger.error("Failed to unsetChannel: " + e.getMessage());
             call.reject("Failed to unsetChannel: ", e);
@@ -906,25 +928,42 @@ public class CapacitorUpdaterPlugin extends Plugin {
         try {
             logger.info("setChannel " + channel + " triggerAutoUpdate: " + triggerAutoUpdate);
             startNewThread(() ->
-                CapacitorUpdaterPlugin.this.implementation.setChannel(channel, (res) -> {
-                    JSObject jsRes = mapToJSObject(res);
-                    if (jsRes.has("error")) {
-                        String errorMessage = jsRes.has("message") ? jsRes.getString("message") : jsRes.getString("error");
-                        String errorCode = jsRes.getString("error");
+                CapacitorUpdaterPlugin.this.implementation.setChannel(
+                    channel,
+                    CapacitorUpdaterPlugin.this.editor,
+                    DEFAULT_CHANNEL_PREF_KEY,
+                    CapacitorUpdaterPlugin.this.allowSetDefaultChannel,
+                    (res) -> {
+                        JSObject jsRes = mapToJSObject(res);
+                        if (jsRes.has("error")) {
+                            String errorMessage = jsRes.has("message") ? jsRes.getString("message") : jsRes.getString("error");
+                            String errorCode = jsRes.getString("error");
+
+                            // Fire channelPrivate event if channel doesn't allow self-assignment
+                            if (
+                                errorCode.contains("cannot_update_via_private_channel") ||
+                                errorCode.contains("channel_self_set_not_allowed")
+                            ) {
+                                JSObject eventData = new JSObject();
+                                eventData.put("channel", channel);
+                                eventData.put("message", errorMessage);
+                                notifyListeners("channelPrivate", eventData);
+                            }
 
-                        JSObject errorObj = new JSObject();
-                        errorObj.put("message", errorMessage);
-                        errorObj.put("error", errorCode);
+                            JSObject errorObj = new JSObject();
+                            errorObj.put("message", errorMessage);
+                            errorObj.put("error", errorCode);
 
-                        call.reject(errorMessage, "SETCHANNEL_FAILED", null, errorObj);
-                    } else {
-                        if (CapacitorUpdaterPlugin.this._isAutoUpdateEnabled() && Boolean.TRUE.equals(triggerAutoUpdate)) {
-                            logger.info("Calling autoupdater after channel change!");
-                            backgroundDownload();
+                            call.reject(errorMessage, "SETCHANNEL_FAILED", null, errorObj);
+                        } else {
+                            if (CapacitorUpdaterPlugin.this._isAutoUpdateEnabled() && Boolean.TRUE.equals(triggerAutoUpdate)) {
+                                logger.info("Calling autoupdater after channel change!");
+                                backgroundDownload();
+                            }
+                            call.resolve(jsRes);
                         }
-                        call.resolve(jsRes);
                     }
-                })
+                )
             );
         } catch (final Exception e) {
             logger.error("Failed to setChannel: " + channel + " " + e.getMessage());