@capgo/capacitor-updater 7.43.3 → 7.45.10

package/dist/docs.json

@@ -343,7 +343,7 @@
           },
           {
             "name": "link",
-            "text": "ResetOptions} to control reset behavior. If `toLastSuccessful` is `false` (or omitted), resets to builtin. If `true`, resets to last successful bundle."
+            "text": "ResetOptions} to control reset behavior.\nIf `toLastSuccessful` is `false` (or omitted), resets to builtin.\nIf `true`, resets to last successful bundle.\nIf `usePendingBundle` is `true`, applies the pending bundle set via {@link next} and clears it."
           },
           {
             "name": "returns",
@@ -492,14 +492,14 @@
           },
           {
             "name": "throws",
-            "text": "{Error} Always throws when no new version is available (`error: \"no_new_version_available\"`), or when the request fails."
+            "text": "{Error} Throws for failed update checks or transport/request failures."
           },
           {
             "name": "since",
             "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 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)",
+        "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: Handling \"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 is a normal, expected condition and resolves with\n`kind: \"up_to_date\"` when the backend provides that classification.\n\nYou should check `kind` and `error` before attempting to download:\n\n```typescript\nconst latest = await CapacitorUpdater.getLatest();\nif (latest.kind === 'up_to_date') {\n  console.log('Already up to date');\n} else if (latest.kind === 'blocked') {\n  console.log('Update is blocked:', latest.error);\n} else if (latest.url) {\n  // New version is available, proceed with download\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"
@@ -765,7 +765,7 @@
             "text": "1.0.0"
           }
         ],
-        "docs": "Remove all event listeners registered for this plugin.\n\nThis unregisters all listeners added via {@link addListener} for all event types:\n- `download`\n- `noNeedUpdate`\n- `updateAvailable`\n- `downloadComplete`\n- `downloadFailed`\n- `breakingAvailable` / `majorAvailable`\n- `updateFailed`\n- `appReloaded`\n- `appReady`\n\nUse this during cleanup (e.g., when unmounting components or closing screens)\nto prevent memory leaks from lingering event listeners.",
+        "docs": "Remove all event listeners registered for this plugin.\n\nThis unregisters all listeners added via {@link addListener} for all event types:\n- `download`\n- `noNeedUpdate`\n- `updateCheckResult`\n- `updateAvailable`\n- `downloadComplete`\n- `downloadFailed`\n- `breakingAvailable` / `majorAvailable`\n- `updateFailed`\n- `appReloaded`\n- `appReady`\n\nUse this during cleanup (e.g., when unmounting components or closing screens)\nto prevent memory leaks from lingering event listeners.",
         "complexTypes": [],
         "slug": "removealllisteners"
       },
@@ -827,6 +827,35 @@
         ],
         "slug": "addlistenernoneedupdate-"
       },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'updateCheckResult', listenerFunc: (state: UpdateCheckResultEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'updateCheckResult'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(state: UpdateCheckResultEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "8.45.11"
+          }
+        ],
+        "docs": "Listen for update check results before the updater decides whether to download.\nThe backend can classify the UpdateCheckResultEvent payload as `up_to_date`, `blocked`, or `failed`.\n\nThis event is emitted alongside legacy events. For `up_to_date` and `blocked`, it is emitted before\n`noNeedUpdate` and does not emit `downloadFailed`. For `failed`, it is emitted before the legacy\n`downloadFailed` event and keeps the existing failure stats behavior.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "UpdateCheckResultEvent"
+        ],
+        "slug": "addlistenerupdatecheckresult-"
+      },
       {
         "name": "addListener",
         "signature": "(eventName: 'updateAvailable', listenerFunc: (state: UpdateAvailableEvent) => void) => Promise<PluginListenerHandle>",
@@ -976,6 +1005,64 @@
         ],
         "slug": "addlistenerupdatefailed-"
       },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'set', listenerFunc: (state: SetEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'set'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(state: SetEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "8.43.12"
+          }
+        ],
+        "docs": "Listen for set event in the App, let you know when a bundle has been applied successfully.\nThis event is retained natively until JavaScript consumes it, so if the app reloads before your\nlistener is attached, the last pending `set` event is delivered once the listener subscribes.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "SetEvent"
+        ],
+        "slug": "addlistenerset-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'setNext', listenerFunc: (state: SetNextEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'setNext'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(state: SetNextEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "6.14.0"
+          }
+        ],
+        "docs": "Listen for set next event in the App, let you know when a bundle is queued as the next bundle to install.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "SetNextEvent"
+        ],
+        "slug": "addlistenersetnext-"
+      },
       {
         "name": "addListener",
         "signature": "(eventName: 'downloadFailed', listenerFunc: (state: DownloadFailedEvent) => void) => Promise<PluginListenerHandle>",
@@ -1055,7 +1142,7 @@
             "text": "5.1.0"
           }
         ],
-        "docs": "Listen for app ready event in the App, let you know when app is ready to use, this event is retain till consumed.",
+        "docs": "Listen for app ready event in the App, let you know when app is ready to use.\nThis event is retained natively until JavaScript consumes it, so it can still be delivered after\na reload even if the listener is attached later in app startup.",
         "complexTypes": [
           "PluginListenerHandle",
           "AppReadyEvent"
@@ -1814,10 +1901,27 @@
       "properties": [
         {
           "name": "toLastSuccessful",
-          "tags": [],
-          "docs": "",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            }
+          ],
+          "docs": "Reset to the last successfully loaded bundle instead of the builtin one.",
           "complexTypes": [],
-          "type": "boolean"
+          "type": "boolean | undefined"
+        },
+        {
+          "name": "usePendingBundle",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            }
+          ],
+          "docs": "Apply the pending bundle set via {@link next} while resetting.\n\nWhen `true`, the plugin will switch to the pending bundle immediately and clear the pending flag.\nIf no pending bundle exists, the reset will fail.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },
@@ -1970,10 +2074,36 @@
         {
           "name": "error",
           "tags": [],
-          "docs": "Error code from the server, if any.\nCommon values:\n- `\"no_new_version_available\"`: Device is already on the latest version (not a failure)\n- Other error codes indicate actual failures in the update process",
+          "docs": "Error code from the server, if any. Use `kind` for classification instead of parsing this value.",
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "kind",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "Classification for this response, provided by the backend.",
+          "complexTypes": [
+            "UpdateResponseKind"
+          ],
+          "type": "UpdateResponseKind"
+        },
+        {
+          "name": "statusCode",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "HTTP status code returned by the update server for classified update-check responses.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
         {
           "name": "old",
           "tags": [],
@@ -2405,6 +2535,91 @@
         }
       ]
     },
+    {
+      "name": "UpdateCheckResultEvent",
+      "slug": "updatecheckresultevent",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "kind",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "Classification for the update check result, provided by the backend.",
+          "complexTypes": [
+            "UpdateResponseKind"
+          ],
+          "type": "UpdateResponseKind"
+        },
+        {
+          "name": "error",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "Backend error code, when provided.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "message",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "Backend message, when provided.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "statusCode",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "HTTP status code returned by the update endpoint.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "version",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "Version referenced by the update check result.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "bundle",
+          "tags": [
+            {
+              "text": "8.45.11",
+              "name": "since"
+            }
+          ],
+          "docs": "Current bundle on the device.",
+          "complexTypes": [
+            "BundleInfo"
+          ],
+          "type": "BundleInfo"
+        }
+      ]
+    },
     {
       "name": "UpdateAvailableEvent",
       "slug": "updateavailableevent",
@@ -2499,6 +2714,52 @@
         }
       ]
     },
+    {
+      "name": "SetEvent",
+      "slug": "setevent",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundle",
+          "tags": [
+            {
+              "text": "8.43.12",
+              "name": "since"
+            }
+          ],
+          "docs": "Emit when a bundle has been applied successfully.\nThis event uses native `retainUntilConsumed` behavior.",
+          "complexTypes": [
+            "BundleInfo"
+          ],
+          "type": "BundleInfo"
+        }
+      ]
+    },
+    {
+      "name": "SetNextEvent",
+      "slug": "setnextevent",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundle",
+          "tags": [
+            {
+              "text": "6.14.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Emit when a bundle is queued as the next bundle to install.",
+          "complexTypes": [
+            "BundleInfo"
+          ],
+          "type": "BundleInfo"
+        }
+      ]
+    },
     {
       "name": "DownloadFailedEvent",
       "slug": "downloadfailedevent",
@@ -2535,7 +2796,7 @@
               "name": "since"
             }
           ],
-          "docs": "Emitted when the app is ready to use.",
+          "docs": "Emitted when the app is ready to use.\nThis event uses native `retainUntilConsumed` behavior.",
           "complexTypes": [
             "BundleInfo"
           ],
@@ -3172,6 +3433,25 @@
         }
       ]
     },
+    {
+      "name": "UpdateResponseKind",
+      "slug": "updateresponsekind",
+      "docs": "Classification for update-check responses that do not provide a downloadable bundle.\nThe update backend provides this field directly. Missing or unknown values are treated as\nfailed by native clients.",
+      "types": [
+        {
+          "text": "'up_to_date'",
+          "complexTypes": []
+        },
+        {
+          "text": "'blocked'",
+          "complexTypes": []
+        },
+        {
+          "text": "'failed'",
+          "complexTypes": []
+        }
+      ]
+    },
     {
       "name": "BreakingAvailableEvent",
       "slug": "breakingavailableevent",

package/dist/esm/definitions.d.ts

@@ -568,7 +568,10 @@ export interface CapacitorUpdaterPlugin {
      * - Testing rollback functionality
      * - Providing users a "reset to factory" option
      *
-     * @param options {@link ResetOptions} to control reset behavior. If `toLastSuccessful` is `false` (or omitted), resets to builtin. If `true`, resets to last successful bundle.
+     * @param options {@link ResetOptions} to control reset behavior.
+     * If `toLastSuccessful` is `false` (or omitted), resets to builtin.
+     * If `true`, resets to last successful bundle.
+     * If `usePendingBundle` is `true`, applies the pending bundle set via {@link next} and clears it.
      * @returns {Promise<void>} A promise that may never resolve because the app will be reloaded.
      * @throws {Error} If the reset operation fails.
      */
@@ -692,27 +695,23 @@ export interface CapacitorUpdaterPlugin {
      * 2. Download it using {@link download}
      * 3. Apply it using {@link next} or {@link set}
      *
-     * **Important: Error handling for "no new version available"**
+     * **Important: Handling "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.
+     * `message: "No new version available"`. This is a normal, expected condition and resolves with
+     * `kind: "up_to_date"` when the backend provides that classification.
      *
-     * You should catch this specific error to handle it gracefully:
+     * You should check `kind` and `error` before attempting to download:
      *
      * ```typescript
-     * try {
-     *   const latest = await CapacitorUpdater.getLatest();
+     * const latest = await CapacitorUpdater.getLatest();
+     * if (latest.kind === 'up_to_date') {
+     *   console.log('Already up to date');
+     * } else if (latest.kind === 'blocked') {
+     *   console.log('Update is blocked:', latest.error);
+     * } else if (latest.url) {
      *   // 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);
-     *   }
      * }
      * ```
      *
@@ -722,7 +721,7 @@ export interface CapacitorUpdaterPlugin {
      *
      * @param options Optional {@link GetLatestOptions} to specify which channel to check.
      * @returns {Promise<LatestVersion>} Information about the latest available bundle version.
-     * @throws {Error} Always throws when no new version is available (`error: "no_new_version_available"`), or when the request fails.
+     * @throws {Error} Throws for failed update checks or transport/request failures.
      * @since 4.0.0
      */
     getLatest(options?: GetLatestOptions): Promise<LatestVersion>;
@@ -938,6 +937,7 @@ export interface CapacitorUpdaterPlugin {
      * This unregisters all listeners added via {@link addListener} for all event types:
      * - `download`
      * - `noNeedUpdate`
+     * - `updateCheckResult`
      * - `updateAvailable`
      * - `downloadComplete`
      * - `downloadFailed`
@@ -966,6 +966,17 @@ export interface CapacitorUpdaterPlugin {
      * @since 4.0.0
      */
     addListener(eventName: 'noNeedUpdate', listenerFunc: (state: NoNeedEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for update check results before the updater decides whether to download.
+     * The backend can classify the UpdateCheckResultEvent payload as `up_to_date`, `blocked`, or `failed`.
+     *
+     * This event is emitted alongside legacy events. For `up_to_date` and `blocked`, it is emitted before
+     * `noNeedUpdate` and does not emit `downloadFailed`. For `failed`, it is emitted before the legacy
+     * `downloadFailed` event and keeps the existing failure stats behavior.
+     *
+     * @since 8.45.11
+     */
+    addListener(eventName: 'updateCheckResult', listenerFunc: (state: UpdateCheckResultEvent) => void): Promise<PluginListenerHandle>;
     /**
      * Listen for available update event, useful when you want to force check every time the app is launched
      *
@@ -998,6 +1009,20 @@ export interface CapacitorUpdaterPlugin {
      * @since 2.3.0
      */
     addListener(eventName: 'updateFailed', listenerFunc: (state: UpdateFailedEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for set event in the App, let you know when a bundle has been applied successfully.
+     * This event is retained natively until JavaScript consumes it, so if the app reloads before your
+     * listener is attached, the last pending `set` event is delivered once the listener subscribes.
+     *
+     * @since 8.43.12
+     */
+    addListener(eventName: 'set', listenerFunc: (state: SetEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for set next event in the App, let you know when a bundle is queued as the next bundle to install.
+     *
+     * @since 6.14.0
+     */
+    addListener(eventName: 'setNext', listenerFunc: (state: SetNextEvent) => void): Promise<PluginListenerHandle>;
     /**
      * Listen for download fail event in the App, let you know when a bundle download has failed
      *
@@ -1011,7 +1036,9 @@ export interface CapacitorUpdaterPlugin {
      */
     addListener(eventName: 'appReloaded', listenerFunc: () => void): Promise<PluginListenerHandle>;
     /**
-     * Listen for app ready event in the App, let you know when app is ready to use, this event is retain till consumed.
+     * Listen for app ready event in the App, let you know when app is ready to use.
+     * This event is retained natively until JavaScript consumes it, so it can still be delivered after
+     * a reload even if the listener is attached later in app startup.
      *
      * @since 5.1.0
      */
@@ -1357,6 +1384,14 @@ export interface CapacitorUpdaterPlugin {
  */
 export type BundleStatus = 'success' | 'error' | 'pending' | 'downloading';
 export type DelayUntilNext = 'background' | 'kill' | 'nativeVersion' | 'date';
+/**
+ * Classification for update-check responses that do not provide a downloadable bundle.
+ * The update backend provides this field directly. Missing or unknown values are treated as
+ * failed by native clients.
+ *
+ * @since 8.45.11
+ */
+export type UpdateResponseKind = 'up_to_date' | 'blocked' | 'failed';
 export interface NoNeedEvent {
     /**
      * Current status of download, between 0 and 100.
@@ -1365,6 +1400,44 @@ export interface NoNeedEvent {
      */
     bundle: BundleInfo;
 }
+export interface UpdateCheckResultEvent {
+    /**
+     * Classification for the update check result, provided by the backend.
+     *
+     * @since 8.45.11
+     */
+    kind: UpdateResponseKind;
+    /**
+     * Backend error code, when provided.
+     *
+     * @since 8.45.11
+     */
+    error?: string;
+    /**
+     * Backend message, when provided.
+     *
+     * @since 8.45.11
+     */
+    message?: string;
+    /**
+     * HTTP status code returned by the update endpoint.
+     *
+     * @since 8.45.11
+     */
+    statusCode?: number;
+    /**
+     * Version referenced by the update check result.
+     *
+     * @since 8.45.11
+     */
+    version?: string;
+    /**
+     * Current bundle on the device.
+     *
+     * @since 8.45.11
+     */
+    bundle: BundleInfo;
+}
 export interface UpdateAvailableEvent {
     /**
      * Current status of download, between 0 and 100.
@@ -1477,9 +1550,27 @@ export interface UpdateFailedEvent {
      */
     bundle: BundleInfo;
 }
+export interface SetEvent {
+    /**
+     * Emit when a bundle has been applied successfully.
+     * This event uses native `retainUntilConsumed` behavior.
+     *
+     * @since 8.43.12
+     */
+    bundle: BundleInfo;
+}
+export interface SetNextEvent {
+    /**
+     * Emit when a bundle is queued as the next bundle to install.
+     *
+     * @since 6.14.0
+     */
+    bundle: BundleInfo;
+}
 export interface AppReadyEvent {
     /**
      * Emitted when the app is ready to use.
+     * This event uses native `retainUntilConsumed` behavior.
      *
      * @since  5.2.0
      */
@@ -1528,12 +1619,21 @@ export interface LatestVersion {
     message?: string;
     sessionKey?: string;
     /**
-     * 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
+     * Error code from the server, if any. Use `kind` for classification instead of parsing this value.
      */
     error?: string;
+    /**
+     * Classification for this response, provided by the backend.
+     *
+     * @since 8.45.11
+     */
+    kind?: UpdateResponseKind;
+    /**
+     * HTTP status code returned by the update server for classified update-check responses.
+     *
+     * @since 8.45.11
+     */
+    statusCode?: number;
     /**
      * The previous/current version name (provided for reference).
      */
@@ -1646,7 +1746,19 @@ export interface BundleListResult {
     bundles: BundleInfo[];
 }
 export interface ResetOptions {
-    toLastSuccessful: boolean;
+    /**
+     * Reset to the last successfully loaded bundle instead of the builtin one.
+     * @default false
+     */
+    toLastSuccessful?: boolean;
+    /**
+     * Apply the pending bundle set via {@link next} while resetting.
+     *
+     * When `true`, the plugin will switch to the pending bundle immediately and clear the pending flag.
+     * If no pending bundle exists, the reset will fail.
+     * @default false
+     */
+    usePendingBundle?: boolean;
 }
 export interface ListOptions {
     /**