@capgo/capacitor-updater 7.43.3 → 7.50.1

package/dist/docs.json

@@ -156,7 +156,7 @@
             "text": "{Error} If the download fails or the bundle is invalid."
           }
         ],
-        "docs": "Download a new bundle from the provided URL for later installation.\n\nThe downloaded bundle is stored locally but not activated. To use it:\n- Call {@link next} to set it for installation on next app backgrounding/restart\n- Call {@link set} to activate it immediately (destroys current JavaScript context)\n\nThe URL should point to a zip file containing either:\n- Your app files directly in the zip root, or\n- A single folder containing all your app files\n\nThe bundle must include an `index.html` file at the root level.\n\nFor encrypted bundles, provide the `sessionKey` and `checksum` parameters.\nFor multi-file delta updates, provide the `manifest` array.",
+        "docs": "Download a new bundle from the provided URL for later installation.\n\nThe downloaded bundle is stored locally but not activated. To use it:\n- Call {@link next} to set it for installation on next app backgrounding/restart\n- Call {@link set} to activate it immediately (destroys current JavaScript context)\n\nThe URL should point to a zip file containing either:\n- Your app files directly in the zip root, or\n- A single folder containing all your app files\n\nThe bundle must include an `index.html` file at the root level.\n\nFor encrypted bundles, provide the `sessionKey` and `checksum` parameters.\nFor multi-file delta updates, provide the `manifest` array.\n\n**Android Background Runner note:** `@capacitor/background-runner` loads its\nconfigured runner script from native APK assets. Live updates cannot replace\nthat runner script. Keep it stable across OTA updates and ship a native app\nupdate when the runner code changes.",
         "complexTypes": [
           "BundleInfo",
           "DownloadOptions"
@@ -226,6 +226,228 @@
         ],
         "slug": "set"
       },
+      {
+        "name": "startPreviewSession",
+        "signature": "(options?: StartPreviewSessionOptions | undefined) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "Optional preview session options.",
+            "type": "StartPreviewSessionOptions | undefined"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options Optional preview session options."
+          },
+          {
+            "name": "returns",
+            "text": "Resolves when preview session state is prepared."
+          },
+          {
+            "name": "since",
+            "text": "8.47.0"
+          }
+        ],
+        "docs": "Start a temporary preview/testing session.\n\nThis stores the currently active bundle as the pending fallback, enables the\nnative shake menu, and makes the next applied bundle show a native notice\nexplaining that shaking the device can reload or leave the preview.\nRequires {@link PluginsConfig.CapacitorUpdater.allowPreview} to be `true`.\nWhen `appId` is provided, the preview session temporarily uses that app id\nfor update checks until the user leaves the preview. Native updater stats are\nskipped while the preview session is active.\n\nUse this before calling {@link set} for Expo Go-style preview flows.\nUse {@link listPreviews}, {@link setPreview}, {@link resetPreview},\n{@link deletePreview}, {@link checkPreviewUpdate}, and\n{@link updatePreview} to manage saved local previews.",
+        "complexTypes": [
+          "StartPreviewSessionOptions"
+        ],
+        "slug": "startpreviewsession"
+      },
+      {
+        "name": "listPreviews",
+        "signature": "() => Promise<PreviewListResult>",
+        "parameters": [],
+        "returns": "Promise<PreviewListResult>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Locally available previews and current preview state."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If preview sessions are not enabled by config."
+          },
+          {
+            "name": "since",
+            "text": "8.49.0"
+          }
+        ],
+        "docs": "Get every locally available preview bundle that was registered by\n{@link startPreviewSession} and later applied with {@link set}.\n\nThis only returns previews whose bundles are still available locally. It is\nsafe to show this in a preview switcher or native debug menu.",
+        "complexTypes": [
+          "PreviewListResult"
+        ],
+        "slug": "listpreviews"
+      },
+      {
+        "name": "setPreview",
+        "signature": "(options: BundleId) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "A {@link BundleId} object containing the preview bundle ID.",
+            "type": "BundleId"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options A {@link BundleId} object containing the preview bundle ID."
+          },
+          {
+            "name": "returns",
+            "text": "Resolves once the preview switch is staged."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If preview sessions are disabled or the preview is not available locally."
+          },
+          {
+            "name": "since",
+            "text": "8.49.0"
+          }
+        ],
+        "docs": "Switch to a locally available preview bundle and reload the WebView.\n\nIf the app is not already in a preview session, the current live bundle is\nsaved as the fallback so {@link resetPreview} or the native shake menu can\nreturn to it later.",
+        "complexTypes": [
+          "BundleId"
+        ],
+        "slug": "setpreview"
+      },
+      {
+        "name": "resetPreview",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Resolves once the live bundle reload is staged."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If there is no preview fallback bundle available."
+          },
+          {
+            "name": "since",
+            "text": "8.49.0"
+          }
+        ],
+        "docs": "Leave the active preview session and reload the saved live bundle.\n\nThis does not delete any saved previews. Use {@link deletePreview} to remove\na preview from local storage.",
+        "complexTypes": [],
+        "slug": "resetpreview"
+      },
+      {
+        "name": "deletePreview",
+        "signature": "(options: BundleId) => Promise<DeletePreviewResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "A {@link BundleId} object containing the preview bundle ID.",
+            "type": "BundleId"
+          }
+        ],
+        "returns": "Promise<DeletePreviewResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options A {@link BundleId} object containing the preview bundle ID."
+          },
+          {
+            "name": "returns",
+            "text": "Whether the underlying bundle was deleted."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If preview sessions are disabled."
+          },
+          {
+            "name": "since",
+            "text": "8.49.0"
+          }
+        ],
+        "docs": "Delete a locally saved preview and its bundle when possible.\n\nActive previews cannot be deleted until you switch away from them or call\n{@link resetPreview}. If only the preview metadata can be removed, the\nmethod still resolves with `deleted: false`.",
+        "complexTypes": [
+          "DeletePreviewResult",
+          "BundleId"
+        ],
+        "slug": "deletepreview"
+      },
+      {
+        "name": "checkPreviewUpdate",
+        "signature": "(options: BundleId) => Promise<PreviewUpdateResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "A {@link BundleId} object containing the preview bundle ID.",
+            "type": "BundleId"
+          }
+        ],
+        "returns": "Promise<PreviewUpdateResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options A {@link BundleId} object containing the preview bundle ID."
+          },
+          {
+            "name": "returns",
+            "text": "Update status for the preview."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If preview sessions are disabled or the preview has no payload URL."
+          },
+          {
+            "name": "since",
+            "text": "8.49.0"
+          }
+        ],
+        "docs": "Check whether a saved preview's payload URL points to a newer preview bundle.\n\nOnly previews started with a `payloadUrl` can be checked natively. Direct URL\npreviews can still be switched or deleted locally, but the updater does not\nknow where to check for newer versions.",
+        "complexTypes": [
+          "PreviewUpdateResult",
+          "BundleId"
+        ],
+        "slug": "checkpreviewupdate"
+      },
+      {
+        "name": "updatePreview",
+        "signature": "(options: BundleId) => Promise<PreviewUpdateResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "A {@link BundleId} object containing the preview bundle ID.",
+            "type": "BundleId"
+          }
+        ],
+        "returns": "Promise<PreviewUpdateResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options A {@link BundleId} object containing the preview bundle ID."
+          },
+          {
+            "name": "returns",
+            "text": "The update result and saved preview metadata."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If preview sessions are disabled or the preview cannot be updated."
+          },
+          {
+            "name": "since",
+            "text": "8.49.0"
+          }
+        ],
+        "docs": "Download the newest bundle for a saved preview payload URL.\n\nIf the preview being updated is active, the new bundle is applied and the\nWebView reloads. Otherwise, the saved preview entry is moved to the newly\ndownloaded bundle and can be selected later with {@link setPreview}.",
+        "complexTypes": [
+          "PreviewUpdateResult",
+          "BundleId"
+        ],
+        "slug": "updatepreview"
+      },
       {
         "name": "delete",
         "signature": "(options: BundleId) => Promise<void>",
@@ -343,7 +565,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",
@@ -470,6 +692,23 @@
         "complexTypes": [],
         "slug": "canceldelay"
       },
+      {
+        "name": "triggerUpdateCheck",
+        "signature": "() => Promise<TriggerUpdateCheckResult>",
+        "parameters": [],
+        "returns": "Promise<TriggerUpdateCheckResult>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Whether a native update check was queued."
+          }
+        ],
+        "docs": "Trigger the native auto-update check/download pipeline immediately.\n\nThis starts the same background update flow used when the app moves to the\nforeground with auto-update enabled. It is useful for native integrations\nsuch as a silent push notification asking the app to check for a Capgo\nbundle without reimplementing the update protocol in JavaScript.\n\nThe promise resolves after the native background work has been queued, not\nafter the update has been downloaded or installed. Listen to updater events\nsuch as `updateAvailable`, `downloadComplete`, `downloadFailed`, and\n`noNeedUpdate` for the final result.\n\nNative support is available on iOS and Android. On Web, this method returns\na result with `status: 'unavailable'`. Native platforms also return\n`unavailable` when the native auto-update system is disabled.",
+        "complexTypes": [
+          "TriggerUpdateCheckResult"
+        ],
+        "slug": "triggerupdatecheck"
+      },
       {
         "name": "getLatest",
         "signature": "(options?: GetLatestOptions | undefined) => Promise<LatestVersion>",
@@ -492,20 +731,92 @@
           },
           {
             "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"
         ],
         "slug": "getlatest"
       },
+      {
+        "name": "getMissingBundleFiles",
+        "signature": "(options: GetMissingBundleFilesOptions) => Promise<GetMissingBundleFilesResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "A {@link GetMissingBundleFilesOptions} object, or a {@link LatestVersion} response containing `manifest`.",
+            "type": "GetMissingBundleFilesOptions"
+          }
+        ],
+        "returns": "Promise<GetMissingBundleFilesResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options A {@link GetMissingBundleFilesOptions} object, or a {@link LatestVersion} response containing `manifest`."
+          },
+          {
+            "name": "returns",
+            "text": "The manifest entries that require network download."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If the manifest is missing or invalid."
+          },
+          {
+            "name": "since",
+            "text": "8.47.0"
+          }
+        ],
+        "docs": "Return the manifest entries that still need to be downloaded for a partial update.\n\nPass the result from {@link getLatest} directly when it includes a `manifest`.\nThe native plugin compares each manifest entry with the files already available\nin the builtin bundle and the local delta cache. Entries that can be reused are\nomitted from the returned `missing` list.\n\nFor encrypted manifests, pass the `sessionKey` returned by {@link getLatest} so\nencrypted file hashes can be checked against local files.\n\n```typescript\nconst latest = await CapacitorUpdater.getLatest();\nconst missing = await CapacitorUpdater.getMissingBundleFiles(latest);\n```",
+        "complexTypes": [
+          "GetMissingBundleFilesResult",
+          "GetMissingBundleFilesOptions"
+        ],
+        "slug": "getmissingbundlefiles"
+      },
+      {
+        "name": "getBundleDownloadSize",
+        "signature": "(options: GetBundleDownloadSizeOptions) => Promise<GetBundleDownloadSizeResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "A {@link GetBundleDownloadSizeOptions} object containing manifest entries.",
+            "type": "GetBundleDownloadSizeOptions"
+          }
+        ],
+        "returns": "Promise<GetBundleDownloadSizeResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options A {@link GetBundleDownloadSizeOptions} object containing manifest entries."
+          },
+          {
+            "name": "returns",
+            "text": "Known byte totals and per-file size results."
+          },
+          {
+            "name": "throws",
+            "text": "{Error} If the manifest is missing or invalid."
+          },
+          {
+            "name": "since",
+            "text": "8.47.0"
+          }
+        ],
+        "docs": "Estimate the download size for manifest entries before downloading them.\n\nThis method sends the provided manifest entries to the Capgo update endpoint\nonce and reads the stored manifest `file_size` metadata. It does not perform\nper-file `HEAD` requests from the app.\n\nUse this after {@link getMissingBundleFiles} to estimate only the files this\ndevice still needs:\n\n```typescript\nconst latest = await CapacitorUpdater.getLatest();\nconst missing = await CapacitorUpdater.getMissingBundleFiles(latest);\nconst size = await CapacitorUpdater.getBundleDownloadSize({\n  version: latest.version,\n  manifest: missing.missing,\n});\n```",
+        "complexTypes": [
+          "GetBundleDownloadSizeResult",
+          "GetBundleDownloadSizeOptions"
+        ],
+        "slug": "getbundledownloadsize"
+      },
       {
         "name": "setChannel",
         "signature": "(options: SetChannelOptions) => Promise<ChannelRes>",
@@ -535,7 +846,7 @@
             "text": "4.7.0"
           }
         ],
-        "docs": "Assign this device to a specific update channel at runtime.\n\nChannels allow you to distribute different bundle versions to different groups of users\n(e.g., \"production\", \"beta\", \"staging\"). This method switches the device to a new channel.\n\n**Requirements:**\n- The target channel must allow self-assignment (configured in your Capgo dashboard or backend)\n- The backend may accept or reject the request based on channel settings\n\n**When to use:**\n- After the app is ready and the user has interacted (e.g., opted into beta program)\n- To implement in-app channel switching (beta toggle, tester access, etc.)\n- For user-driven channel changes\n\n**When NOT to use:**\n- At app boot/initialization - use {@link PluginsConfig.CapacitorUpdater.defaultChannel} config instead\n- Before user interaction\n\n**Important: Listen for the `channelPrivate` event**\n\nWhen a user attempts to set a channel that doesn't allow device self-assignment, the method will\nthrow an error AND fire a {@link addListener}('channelPrivate') event. You should listen to this event\nto provide appropriate feedback to users:\n\n```typescript\nCapacitorUpdater.addListener('channelPrivate', (data) => {\n  console.warn(`Cannot access channel \"${data.channel}\": ${data.message}`);\n  // Show user-friendly message\n});\n```\n\nThis sends a request to the Capgo backend linking your device ID to the specified channel.",
+        "docs": "Assign this device to a specific update channel at runtime.\n\nChannels allow you to distribute different bundle versions to different groups of users\n(e.g., \"production\", \"beta\", \"staging\"). This method switches the device to a new channel.\n\n**Device Override UI:** `setChannel()` validates the channel with the backend, then stores the\nselected channel locally on the device. It does not create or update a backend Device Override,\nso the device will not appear as overridden in the Capgo dashboard. Only assignments created\nfrom the dashboard or the Public API are shown in the Device Override UI.\n\n**Requirements:**\n- The target channel must allow self-assignment (configured in your Capgo dashboard or backend)\n- The backend may accept or reject the request based on channel settings\n\n**When to use:**\n- After the app is ready and the user has interacted (e.g., opted into beta program)\n- To implement in-app channel switching (beta toggle, tester access, etc.)\n- For user-driven channel changes\n\n**When NOT to use:**\n- At app boot/initialization - use {@link PluginsConfig.CapacitorUpdater.defaultChannel} config instead\n- Before user interaction\n\n**Important: Listen for the `channelPrivate` event**\n\nWhen a user attempts to set a channel that doesn't allow device self-assignment, the method will\nthrow an error AND fire a {@link addListener}('channelPrivate') event. You should listen to this event\nto provide appropriate feedback to users:\n\n```typescript\nCapacitorUpdater.addListener('channelPrivate', (data) => {\n  console.warn(`Cannot access channel \"${data.channel}\": ${data.message}`);\n  // Show user-friendly message\n});\n```\n\nThis sends a request to the Capgo backend to validate the specified channel, then stores the\nchannel locally on the device.",
         "complexTypes": [
           "ChannelRes",
           "SetChannelOptions"
@@ -575,7 +886,7 @@
             "text": "4.7.0"
           }
         ],
-        "docs": "Remove the device's channel assignment and return to the default channel.\n\nThis unlinks the device from any specifically assigned channel, causing it to fall back to:\n- The {@link PluginsConfig.CapacitorUpdater.defaultChannel} if configured, or\n- Your backend's default channel for this app\n\nUse this when:\n- Users opt out of beta/testing programs\n- You want to reset a device to standard update distribution\n- Testing channel switching behavior",
+        "docs": "Remove the plugin-managed local channel assignment and return to the default channel.\n\nThis clears only the channel stored locally by {@link setChannel}; it does not delete Dashboard or Public API Device Override records. After the local assignment is cleared, normal channel precedence applies:\n- An existing Dashboard or Public API Device Override, if one exists\n- The {@link PluginsConfig.CapacitorUpdater.defaultChannel} if configured, or\n- Your backend default channel for this app\n\nUse this when:\n- Users opt out of beta/testing programs\n- You want to reset a device to standard update distribution\n- Testing channel switching behavior",
         "complexTypes": [
           "UnsetChannelOptions"
         ],
@@ -600,7 +911,7 @@
             "text": "4.8.0"
           }
         ],
-        "docs": "Get the current channel assigned to this device.\n\nReturns information about:\n- `channel`: The currently assigned channel name (if any)\n- `allowSet`: Whether the channel allows self-assignment\n- `status`: Operation status\n- `error`/`message`: Additional information (if applicable)\n\nUse this to:\n- Display current channel to users (e.g., \"You're on the Beta channel\")\n- Check if a device is on a specific channel before showing features\n- Verify channel assignment after calling {@link setChannel}",
+        "docs": "Get the current channel assigned to this device.\n\nReturns information about:\n- `channel`: The currently assigned channel name (if any)\n- `allowSet`: Whether the channel allows self-assignment\n- `status`: Operation status\n- `error`/`message`: Additional information (if applicable)\n\nUse this to:\n- Display current channel to users (e.g., \"You're on the Beta channel\")\n- Check if a device is on a specific channel before showing features\n- Verify channel assignment after calling {@link setChannel}\n\nOn native platforms, a successful response also refreshes the locally persisted\ndefault channel used by update checks.",
         "complexTypes": [
           "GetChannelRes"
         ],
@@ -702,7 +1013,7 @@
             "text": "{Error} If the operation fails."
           }
         ],
-        "docs": "Get the unique, privacy-friendly identifier for this device.\n\nThis ID is used to identify the device when communicating with update servers.\nIt's automatically generated and stored securely by the plugin.\n\n**Privacy & Security characteristics:**\n- Generated as a UUID (not based on hardware identifiers)\n- Stored securely in platform-specific secure storage\n- Android: Android Keystore (persists across app reinstalls on API 23+)\n- iOS: Keychain with `kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly`\n- Not synced to cloud (iOS)\n- Follows Apple and Google privacy best practices\n- Users can clear it via system settings (Android) or keychain access (iOS)\n\n**Persistence:**\nThe device ID persists across app reinstalls to maintain consistent device identity\nfor update tracking and analytics.\n\nUse this to:\n- Debug update delivery issues (check what ID the server sees)\n- Implement device-specific features\n- Correlate server logs with specific devices",
+        "docs": "Get the unique, privacy-friendly identifier for this device.\n\nThis ID is used to identify the device when communicating with update servers.\nIt's automatically generated and stored securely by the plugin.\n\n**Privacy & Security characteristics:**\n- Generated as a UUID (not based on hardware identifiers)\n- Stored securely in platform-specific secure storage\n- Android: mirrored into backup-restorable app preferences for reinstall restore\n- iOS: Keychain with `kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly`\n- Not synced to cloud (iOS)\n- Follows Apple and Google privacy best practices\n- Users can clear it via system settings (Android) or keychain access (iOS)\n\n**Persistence:**\nThe device ID persists across app reinstalls to maintain consistent device identity\nfor update tracking and analytics when platform storage is preserved. On Android,\napps with custom backup rules must keep the plugin app preferences eligible for\nbackup/restore; disabling Android backup or clearing app data creates a new ID.\n\nUse this to:\n- Debug update delivery issues (check what ID the server sees)\n- Implement device-specific features\n- Correlate server logs with specific devices",
         "complexTypes": [
           "DeviceId"
         ],
@@ -765,7 +1076,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 +1138,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>",
@@ -978,84 +1318,142 @@
       },
       {
         "name": "addListener",
-        "signature": "(eventName: 'downloadFailed', listenerFunc: (state: DownloadFailedEvent) => void) => Promise<PluginListenerHandle>",
+        "signature": "(eventName: 'set', listenerFunc: (state: SetEvent) => void) => Promise<PluginListenerHandle>",
         "parameters": [
           {
             "name": "eventName",
             "docs": "",
-            "type": "'downloadFailed'"
+            "type": "'set'"
           },
           {
             "name": "listenerFunc",
             "docs": "",
-            "type": "(state: DownloadFailedEvent) => void"
+            "type": "(state: SetEvent) => void"
           }
         ],
         "returns": "Promise<PluginListenerHandle>",
         "tags": [
           {
             "name": "since",
-            "text": "4.0.0"
+            "text": "8.43.12"
           }
         ],
-        "docs": "Listen for download fail event in the App, let you know when a bundle download has failed",
+        "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",
-          "DownloadFailedEvent"
+          "SetEvent"
         ],
-        "slug": "addlistenerdownloadfailed-"
+        "slug": "addlistenerset-"
       },
       {
         "name": "addListener",
-        "signature": "(eventName: 'appReloaded', listenerFunc: () => void) => Promise<PluginListenerHandle>",
+        "signature": "(eventName: 'setNext', listenerFunc: (state: SetNextEvent) => void) => Promise<PluginListenerHandle>",
         "parameters": [
           {
             "name": "eventName",
             "docs": "",
-            "type": "'appReloaded'"
+            "type": "'setNext'"
           },
           {
             "name": "listenerFunc",
             "docs": "",
-            "type": "() => void"
+            "type": "(state: SetNextEvent) => void"
           }
         ],
         "returns": "Promise<PluginListenerHandle>",
         "tags": [
           {
             "name": "since",
-            "text": "4.3.0"
+            "text": "6.14.0"
           }
         ],
-        "docs": "Listen for reload event in the App, let you know when reload has happened",
+        "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"
+          "PluginListenerHandle",
+          "SetNextEvent"
         ],
-        "slug": "addlistenerappreloaded-"
+        "slug": "addlistenersetnext-"
       },
       {
         "name": "addListener",
-        "signature": "(eventName: 'appReady', listenerFunc: (state: AppReadyEvent) => void) => Promise<PluginListenerHandle>",
+        "signature": "(eventName: 'downloadFailed', listenerFunc: (state: DownloadFailedEvent) => void) => Promise<PluginListenerHandle>",
         "parameters": [
           {
             "name": "eventName",
             "docs": "",
-            "type": "'appReady'"
+            "type": "'downloadFailed'"
           },
           {
             "name": "listenerFunc",
             "docs": "",
-            "type": "(state: AppReadyEvent) => void"
+            "type": "(state: DownloadFailedEvent) => void"
           }
         ],
         "returns": "Promise<PluginListenerHandle>",
         "tags": [
           {
             "name": "since",
-            "text": "5.1.0"
+            "text": "4.0.0"
+          }
+        ],
+        "docs": "Listen for download fail event in the App, let you know when a bundle download has failed",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "DownloadFailedEvent"
+        ],
+        "slug": "addlistenerdownloadfailed-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'appReloaded', listenerFunc: () => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'appReloaded'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "() => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "4.3.0"
+          }
+        ],
+        "docs": "Listen for reload event in the App, let you know when reload has happened",
+        "complexTypes": [
+          "PluginListenerHandle"
+        ],
+        "slug": "addlistenerappreloaded-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'appReady', listenerFunc: (state: AppReadyEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'appReady'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(state: AppReadyEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "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"
@@ -1224,7 +1622,7 @@
             "text": "7.5.0"
           }
         ],
-        "docs": "Enable or disable the shake gesture menu for debugging and testing.\n\nWhen enabled, users can shake their device to open a debug menu that shows:\n- Current bundle information\n- Available bundles\n- Options to switch bundles manually\n- Update status\n\nThis is useful during development and testing to:\n- Quickly test different bundle versions\n- Debug update flows\n- Switch between production and test bundles\n- Verify bundle installations\n\n**Important:** Disable this in production builds or only enable for internal testers.\n\nCan also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.",
+        "docs": "Enable or disable the native preview menu gesture.\n\nDuring preview sessions, users can use the configured native gesture to:\n- Reload the current preview\n- Leave the test app and return to the fallback bundle\n- Switch update channel, when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is also enabled\n\nOutside preview sessions, this preview menu is ignored. The channel selector can still be\nshown outside preview sessions when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.\n\n**Important:** Disable this in production builds or only enable for internal testers.\n\nThis can also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.\nThe native gesture is configured via {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}.",
         "complexTypes": [
           "SetShakeMenuOptions"
         ],
@@ -1238,7 +1636,7 @@
         "tags": [
           {
             "name": "returns",
-            "text": "Object with `enabled: true` or `enabled: false`."
+            "text": "Object with the current enabled state and gesture."
           },
           {
             "name": "throws",
@@ -1249,7 +1647,7 @@
             "text": "7.5.0"
           }
         ],
-        "docs": "Check if the shake gesture debug menu is currently enabled.\n\nReturns the current state of the shake menu feature that can be toggled via\n{@link setShakeMenu} or configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.\n\nUse this to:\n- Check if debug features are enabled\n- Show/hide debug settings UI\n- Verify configuration during testing",
+        "docs": "Check if the native preview menu gesture is currently enabled.\n\nReturns the current state of the shake menu feature that can be toggled via\n{@link setShakeMenu} or configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.\n\nUse this to:\n- Check if debug features are enabled\n- Show/hide debug settings UI\n- Verify configuration during testing",
         "complexTypes": [
           "ShakeMenuEnabled"
         ],
@@ -1288,7 +1686,7 @@
             "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}.",
+        "docs": "Enable or disable the channel selector menu gesture at runtime.\n\nWhen enabled, the configured native gesture can show a channel selector, including outside preview sessions.\nIf {@link setShakeMenu} is also enabled while a preview session is active, the shake menu includes\nboth preview actions and channel switching.\n\nThis can also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.\nThe native gesture is configured via {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}.",
         "complexTypes": [
           "SetShakeChannelSelectorOptions"
         ],
@@ -1763,291 +2161,1070 @@
       ]
     },
     {
-      "name": "BundleListResult",
-      "slug": "bundlelistresult",
+      "name": "StartPreviewSessionOptions",
+      "slug": "startpreviewsessionoptions",
       "docs": "",
       "tags": [],
       "methods": [],
       "properties": [
         {
-          "name": "bundles",
-          "tags": [],
-          "docs": "",
-          "complexTypes": [
-            "BundleInfo"
+          "name": "appId",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            },
+            {
+              "text": "undefined",
+              "name": "default"
+            }
           ],
-          "type": "BundleInfo[]"
-        }
-      ]
-    },
-    {
-      "name": "ListOptions",
-      "slug": "listoptions",
-      "docs": "",
-      "tags": [],
-      "methods": [],
-      "properties": [
+          "docs": "App id to use while the preview session is active.\nThe previous app id is restored when leaving the preview session.\nRequires {@link PluginsConfig.CapacitorUpdater.allowPreview} to be `true`.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
-          "name": "raw",
+          "name": "payloadUrl",
           "tags": [
             {
-              "text": "6.14.0",
+              "text": "8.48.0",
               "name": "since"
             },
             {
-              "text": "false",
+              "text": "undefined",
               "name": "default"
             }
           ],
-          "docs": "Whether to return the raw bundle list or the manifest. If true, the list will attempt to read the internal database instead of files on disk.",
+          "docs": "HTTP(S) URL returning a preview download payload.\nWhen provided, the native shake reload action fetches this payload again\nbefore reloading so channel previews can move to the latest bundle.\nRequires {@link PluginsConfig.CapacitorUpdater.allowPreview} to be `true`.",
           "complexTypes": [],
-          "type": "boolean | undefined"
-        }
-      ]
-    },
-    {
-      "name": "ResetOptions",
-      "slug": "resetoptions",
-      "docs": "",
-      "tags": [],
-      "methods": [],
-      "properties": [
+          "type": "string | undefined"
+        },
         {
-          "name": "toLastSuccessful",
-          "tags": [],
-          "docs": "",
+          "name": "name",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            },
+            {
+              "text": "undefined",
+              "name": "default"
+            }
+          ],
+          "docs": "Human-readable preview name stored with the next preview bundle applied by\n{@link set}. Native preview menus and {@link listPreviews} can display it.",
           "complexTypes": [],
-          "type": "boolean"
+          "type": "string | undefined"
+        },
+        {
+          "name": "source",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            },
+            {
+              "text": "undefined",
+              "name": "default"
+            }
+          ],
+          "docs": "Optional source label for the preview, such as `channel`, `bundle`, `url`,\nor `payload`. This is stored as metadata only.",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ]
     },
     {
-      "name": "CurrentBundleResult",
-      "slug": "currentbundleresult",
+      "name": "PreviewListResult",
+      "slug": "previewlistresult",
       "docs": "",
       "tags": [],
       "methods": [],
       "properties": [
         {
-          "name": "bundle",
-          "tags": [],
-          "docs": "",
+          "name": "previews",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Locally available preview bundles.",
+          "complexTypes": [
+            "PreviewInfo"
+          ],
+          "type": "PreviewInfo[]"
+        },
+        {
+          "name": "current",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Current preview when a preview session is active.",
+          "complexTypes": [
+            "PreviewInfo"
+          ],
+          "type": "PreviewInfo"
+        },
+        {
+          "name": "currentBundle",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Bundle currently loaded by the WebView.",
           "complexTypes": [
             "BundleInfo"
           ],
           "type": "BundleInfo"
         },
         {
-          "name": "native",
-          "tags": [],
-          "docs": "",
-          "complexTypes": [],
-          "type": "string"
-        }
-      ]
-    },
-    {
-      "name": "MultiDelayConditions",
-      "slug": "multidelayconditions",
-      "docs": "",
-      "tags": [],
-      "methods": [],
-      "properties": [
-        {
-          "name": "delayConditions",
-          "tags": [],
-          "docs": "",
+          "name": "liveBundle",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Bundle that will be restored when leaving preview mode.",
           "complexTypes": [
-            "DelayCondition"
+            "BundleInfo"
           ],
-          "type": "DelayCondition[]"
+          "type": "BundleInfo"
         }
       ]
     },
     {
-      "name": "DelayCondition",
-      "slug": "delaycondition",
+      "name": "PreviewInfo",
+      "slug": "previewinfo",
       "docs": "",
       "tags": [],
       "methods": [],
       "properties": [
         {
-          "name": "kind",
+          "name": "id",
           "tags": [
             {
-              "text": "value is useless for",
-              "name": "param"
-            },
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Preview bundle id.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "bundle",
+          "tags": [
             {
-              "text": "kind \"kill\", optional for \"background\" (default value: \"0\") and required for \"nativeVersion\" and \"date\"",
-              "name": "param"
+              "text": "8.49.0",
+              "name": "since"
             }
           ],
-          "docs": "Set up delay conditions in setMultiDelay",
+          "docs": "Locally downloaded bundle backing this preview.",
           "complexTypes": [
-            "DelayUntilNext"
+            "BundleInfo"
           ],
-          "type": "DelayUntilNext"
+          "type": "BundleInfo"
         },
         {
-          "name": "value",
-          "tags": [],
-          "docs": "",
+          "name": "name",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Human-readable name supplied when the preview was started.",
           "complexTypes": [],
           "type": "string | undefined"
-        }
-      ]
-    },
-    {
-      "name": "LatestVersion",
-      "slug": "latestversion",
-      "docs": "",
-      "tags": [],
-      "methods": [],
-      "properties": [
+        },
         {
-          "name": "version",
+          "name": "source",
           "tags": [
             {
-              "text": "4.0.0",
+              "text": "8.49.0",
               "name": "since"
             }
           ],
-          "docs": "Result of getLatest method",
+          "docs": "Metadata source label supplied when the preview was started.",
           "complexTypes": [],
-          "type": "string"
+          "type": "string | undefined"
         },
         {
-          "name": "checksum",
+          "name": "appId",
           "tags": [
             {
-              "text": "6",
+              "text": "8.49.0",
               "name": "since"
             }
           ],
-          "docs": "",
+          "docs": "Preview app id, when the session uses an app id override.",
           "complexTypes": [],
           "type": "string | undefined"
         },
         {
-          "name": "breaking",
+          "name": "payloadUrl",
           "tags": [
             {
-              "text": "7.22.0",
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Payload URL used to refresh this preview.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "createdAt",
+          "tags": [
+            {
+              "text": "8.49.0",
               "name": "since"
             }
           ],
-          "docs": "Indicates whether the update was flagged as breaking by the backend.",
+          "docs": "ISO timestamp for when this preview was first saved.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "updatedAt",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "ISO timestamp for the last metadata or bundle update.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "lastUsedAt",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "ISO timestamp for the last time this preview was activated.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "isActive",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Whether this preview is the currently active bundle in a preview session.",
+          "complexTypes": [],
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "name": "DeletePreviewResult",
+      "slug": "deletepreviewresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "removed",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Whether preview metadata was removed.",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "deleted",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Whether the underlying local bundle was deleted.",
+          "complexTypes": [],
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "name": "PreviewUpdateResult",
+      "slug": "previewupdateresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "preview",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Saved preview metadata after the check or update.",
+          "complexTypes": [
+            "PreviewInfo"
+          ],
+          "type": "PreviewInfo"
+        },
+        {
+          "name": "latestVersion",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Latest version returned by the preview payload endpoint.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "upToDate",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Whether the saved preview already matches the latest payload version.",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "updated",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Whether a newer bundle was downloaded and saved.",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "bundle",
+          "tags": [
+            {
+              "text": "8.49.0",
+              "name": "since"
+            }
+          ],
+          "docs": "New bundle when {@link updatePreview} downloaded one.",
+          "complexTypes": [
+            "BundleInfo"
+          ],
+          "type": "BundleInfo"
+        }
+      ]
+    },
+    {
+      "name": "BundleListResult",
+      "slug": "bundlelistresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundles",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "BundleInfo"
+          ],
+          "type": "BundleInfo[]"
+        }
+      ]
+    },
+    {
+      "name": "ListOptions",
+      "slug": "listoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "raw",
+          "tags": [
+            {
+              "text": "6.14.0",
+              "name": "since"
+            },
+            {
+              "text": "false",
+              "name": "default"
+            }
+          ],
+          "docs": "Whether to return the raw bundle list or the manifest. If true, the list will attempt to read the internal database instead of files on disk.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        }
+      ]
+    },
+    {
+      "name": "ResetOptions",
+      "slug": "resetoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "toLastSuccessful",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            }
+          ],
+          "docs": "Reset to the last successfully loaded bundle instead of the builtin one.",
+          "complexTypes": [],
+          "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"
+        }
+      ]
+    },
+    {
+      "name": "CurrentBundleResult",
+      "slug": "currentbundleresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "bundle",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "BundleInfo"
+          ],
+          "type": "BundleInfo"
+        },
+        {
+          "name": "native",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "name": "MultiDelayConditions",
+      "slug": "multidelayconditions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "delayConditions",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "DelayCondition"
+          ],
+          "type": "DelayCondition[]"
+        }
+      ]
+    },
+    {
+      "name": "DelayCondition",
+      "slug": "delaycondition",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "kind",
+          "tags": [
+            {
+              "text": "value is useless for",
+              "name": "param"
+            },
+            {
+              "text": "kind \"kill\", optional for \"background\" (default value: \"0\") and required for \"nativeVersion\" and \"date\"",
+              "name": "param"
+            }
+          ],
+          "docs": "Set up delay conditions in setMultiDelay",
+          "complexTypes": [
+            "DelayUntilNext"
+          ],
+          "type": "DelayUntilNext"
+        },
+        {
+          "name": "value",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "TriggerUpdateCheckResult",
+      "slug": "triggerupdatecheckresult",
+      "docs": "Result returned after requesting an immediate native auto-update check.",
+      "tags": [
+        {
+          "text": "status - Native trigger state: `queued` when a check was queued,\n`already_running` when the native update pipeline is already active, or\n`unavailable` on Web or when native auto-update is disabled.",
+          "name": "property"
+        },
+        {
+          "text": "queued - Whether a new native update check was queued. This is\n`true` only when `status` is `queued`; otherwise it is `false`.",
+          "name": "property"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "status",
+          "tags": [],
+          "docs": "Native trigger state: `queued` when a check was queued, `already_running`\nwhen the native update pipeline is already active, or `unavailable` on Web\nor when native auto-update is disabled.",
+          "complexTypes": [],
+          "type": "'queued' | 'already_running' | 'unavailable'"
+        },
+        {
+          "name": "queued",
+          "tags": [],
+          "docs": "Whether a new native update check was queued. This is `true` only when\n`status` is `queued`; otherwise it is `false`.",
+          "complexTypes": [],
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "name": "LatestVersion",
+      "slug": "latestversion",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "version",
+          "tags": [
+            {
+              "text": "4.0.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Result of getLatest method",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "checksum",
+          "tags": [
+            {
+              "text": "6",
+              "name": "since"
+            }
+          ],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "breaking",
+          "tags": [
+            {
+              "text": "7.22.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Indicates whether the update was flagged as breaking by the backend.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        },
+        {
+          "name": "major",
+          "tags": [
+            {
+              "text": "Use {@link LatestVersion.breaking} instead.",
+              "name": "deprecated"
+            }
+          ],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        },
+        {
+          "name": "message",
+          "tags": [],
+          "docs": "Optional message from the server.\nWhen no new version is available, this will be \"No new version available\".",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "sessionKey",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "error",
+          "tags": [],
+          "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": [],
+          "docs": "The previous/current version name (provided for reference).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "url",
+          "tags": [],
+          "docs": "Download URL for the bundle (when a new version is available).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "manifest",
+          "tags": [
+            {
+              "text": "6.1",
+              "name": "since"
+            }
+          ],
+          "docs": "File list for delta updates (when using multi-file downloads).",
+          "complexTypes": [
+            "ManifestEntry"
+          ],
+          "type": "ManifestEntry[] | undefined"
+        },
+        {
+          "name": "missing",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Missing manifest entries for this device when {@link GetLatestOptions.includeBundleSize}\nis enabled.",
+          "complexTypes": [
+            "GetMissingBundleFilesResult"
+          ],
+          "type": "GetMissingBundleFilesResult"
+        },
+        {
+          "name": "downloadSize",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Estimated download size for missing manifest entries when\n{@link GetLatestOptions.includeBundleSize} is enabled.",
+          "complexTypes": [
+            "GetBundleDownloadSizeResult"
+          ],
+          "type": "GetBundleDownloadSizeResult"
+        },
+        {
+          "name": "link",
+          "tags": [
+            {
+              "text": "7.35.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Optional link associated with this bundle version (e.g., release notes URL, changelog, GitHub release).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "comment",
+          "tags": [
+            {
+              "text": "7.35.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Optional comment or description for this bundle version.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "GetMissingBundleFilesResult",
+      "slug": "getmissingbundlefilesresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "missing",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Entries that are not available locally and need to be downloaded.",
+          "complexTypes": [
+            "ManifestEntry"
+          ],
+          "type": "ManifestEntry[]"
+        },
+        {
+          "name": "total",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Total entries in the provided manifest.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "missingCount",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Number of entries that need to be downloaded.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "reusableCount",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Number of entries that can be reused from builtin files or local cache.",
+          "complexTypes": [],
+          "type": "number"
+        }
+      ]
+    },
+    {
+      "name": "GetBundleDownloadSizeResult",
+      "slug": "getbundledownloadsizeresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "totalSize",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Sum of all known file sizes in bytes.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "knownFiles",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Number of files with a known size.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "unknownFiles",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Number of files whose size could not be determined.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "files",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Per-file size results.",
+          "complexTypes": [
+            "BundleFileSize"
+          ],
+          "type": "BundleFileSize[]"
+        }
+      ]
+    },
+    {
+      "name": "BundleFileSize",
+      "slug": "bundlefilesize",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "file_name",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "File name from the manifest entry.",
+          "complexTypes": [],
+          "type": "string | null"
+        },
+        {
+          "name": "file_hash",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "File hash from the manifest entry.",
+          "complexTypes": [],
+          "type": "string | null"
+        },
+        {
+          "name": "download_url",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Download URL from the manifest entry.",
+          "complexTypes": [],
+          "type": "string | null"
+        },
+        {
+          "name": "size",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Estimated bytes to download when the server exposes a size.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "error",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Error for this entry when the size could not be determined.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "GetLatestOptions",
+      "slug": "getlatestoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "channel",
+          "tags": [
+            {
+              "text": "6.8.0",
+              "name": "since"
+            },
+            {
+              "text": "undefined",
+              "name": "default"
+            }
+          ],
+          "docs": "The channel to get the latest version for\nThe channel must allow 'self_assign' for this to work",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "appId",
+          "tags": [
+            {
+              "text": "8.47.0",
+              "name": "since"
+            },
+            {
+              "text": "undefined",
+              "name": "default"
+            }
+          ],
+          "docs": "Temporarily use another app id for this update check while using a trusted preview container.\nThis only changes the app id sent by this request; it does not persist a preview session.\nRequires {@link PluginsConfig.CapacitorUpdater.allowPreview} to be `true`.",
           "complexTypes": [],
-          "type": "boolean | undefined"
+          "type": "string | undefined"
         },
         {
-          "name": "major",
+          "name": "includeBundleSize",
           "tags": [
             {
-              "text": "Use {@link LatestVersion.breaking} instead.",
-              "name": "deprecated"
+              "text": "8.47.0",
+              "name": "since"
+            },
+            {
+              "text": "false",
+              "name": "default"
             }
           ],
-          "docs": "",
+          "docs": "When true, the native plugin computes which manifest files are missing on\nthis device and asks the Capgo update endpoint for their stored sizes before\nresolving {@link getLatest}.\n\nThis adds one backend request only when the update response contains a\nmanifest. It does not perform per-file network checks.",
           "complexTypes": [],
           "type": "boolean | undefined"
-        },
-        {
-          "name": "message",
-          "tags": [],
-          "docs": "Optional message from the server.\nWhen no new version is available, this will be \"No new version available\".",
-          "complexTypes": [],
-          "type": "string | undefined"
-        },
-        {
-          "name": "sessionKey",
-          "tags": [],
-          "docs": "",
-          "complexTypes": [],
-          "type": "string | undefined"
-        },
-        {
-          "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",
-          "complexTypes": [],
-          "type": "string | undefined"
-        },
-        {
-          "name": "old",
-          "tags": [],
-          "docs": "The previous/current version name (provided for reference).",
-          "complexTypes": [],
-          "type": "string | undefined"
-        },
-        {
-          "name": "url",
-          "tags": [],
-          "docs": "Download URL for the bundle (when a new version is available).",
-          "complexTypes": [],
-          "type": "string | undefined"
-        },
+        }
+      ]
+    },
+    {
+      "name": "GetMissingBundleFilesOptions",
+      "slug": "getmissingbundlefilesoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
         {
           "name": "manifest",
           "tags": [
             {
-              "text": "6.1",
+              "text": "8.47.0",
               "name": "since"
             }
           ],
-          "docs": "File list for delta updates (when using multi-file downloads).",
+          "docs": "Manifest returned by {@link getLatest}. Passing the full {@link LatestVersion}\nresponse is supported because it contains this field.",
           "complexTypes": [
             "ManifestEntry"
           ],
           "type": "ManifestEntry[] | undefined"
         },
         {
-          "name": "link",
+          "name": "version",
           "tags": [
             {
-              "text": "7.35.0",
+              "text": "8.47.0",
               "name": "since"
             }
           ],
-          "docs": "Optional link associated with this bundle version (e.g., release notes URL, changelog, GitHub release).",
+          "docs": "Target bundle version. Passing the full {@link LatestVersion} response is\nsupported because it contains this field.",
           "complexTypes": [],
           "type": "string | undefined"
         },
         {
-          "name": "comment",
+          "name": "sessionKey",
           "tags": [
             {
-              "text": "7.35.0",
+              "text": "8.47.0",
               "name": "since"
             }
           ],
-          "docs": "Optional comment or description for this bundle version.",
+          "docs": "Session key returned by {@link getLatest}, required only when file hashes are encrypted.",
           "complexTypes": [],
           "type": "string | undefined"
         }
       ]
     },
     {
-      "name": "GetLatestOptions",
-      "slug": "getlatestoptions",
+      "name": "GetBundleDownloadSizeOptions",
+      "slug": "getbundledownloadsizeoptions",
       "docs": "",
       "tags": [],
       "methods": [],
       "properties": [
         {
-          "name": "channel",
+          "name": "manifest",
           "tags": [
             {
-              "text": "6.8.0",
+              "text": "8.47.0",
               "name": "since"
-            },
+            }
+          ],
+          "docs": "Manifest entries to estimate. Pass `missing.missing` from {@link getMissingBundleFiles}\nto estimate only the bytes this device still needs to download.",
+          "complexTypes": [
+            "ManifestEntry"
+          ],
+          "type": "ManifestEntry[] | undefined"
+        },
+        {
+          "name": "version",
+          "tags": [
             {
-              "text": "undefined",
-              "name": "default"
+              "text": "8.47.0",
+              "name": "since"
             }
           ],
-          "docs": "The channel to get the latest version for\nThe channel must allow 'self_assign' for this to work",
+          "docs": "Target bundle version. Pass `latest.version` when estimating files returned\nby {@link getLatest}.",
           "complexTypes": [],
           "type": "string | undefined"
         }
@@ -2216,7 +3393,7 @@
           ],
           "docs": "The channel ID",
           "complexTypes": [],
-          "type": "string"
+          "type": "number"
         },
         {
           "name": "name",
@@ -2405,6 +3582,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 +3761,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 +3843,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"
           ],
@@ -2675,6 +3983,20 @@
           "docs": "",
           "complexTypes": [],
           "type": "boolean"
+        },
+        {
+          "name": "gesture",
+          "tags": [
+            {
+              "text": "8.48.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The currently configured native gesture used to open the preview/channel menu.\nUndefined means consumers should treat the gesture as the default `shake` behavior.",
+          "complexTypes": [
+            "ShakeMenuGesture"
+          ],
+          "type": "ShakeMenuGesture"
         }
       ]
     },
@@ -3172,6 +4494,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",
@@ -3184,6 +4525,21 @@
           ]
         }
       ]
+    },
+    {
+      "name": "ShakeMenuGesture",
+      "slug": "shakemenugesture",
+      "docs": "Native gesture options that open the shake menu.\n\nSupported values are `shake` and `threeFingerPinch`.",
+      "types": [
+        {
+          "text": "'shake'",
+          "complexTypes": []
+        },
+        {
+          "text": "'threeFingerPinch'",
+          "complexTypes": []
+        }
+      ]
     }
   ],
   "pluginConfigs": [
@@ -3263,13 +4619,13 @@
               "name": "default"
             },
             {
-              "text": "false",
+              "text": "\"onlyDownload\"",
               "name": "example"
             }
           ],
-          "docs": "Configure whether the plugin should use Auto Update via an update server.\n\nOnly available for Android and iOS.",
+          "docs": "Configure how the plugin checks for, downloads, and applies live updates.\n\nThe plugin checks for updates when the app moves to the foreground and, if\n{@link periodCheckDelay} is set, on a repeating timer while the app stays open.\n\nBoolean values keep their existing behavior:\n- `true`: Same as `\"atBackground\"`.\n- `false`: Same as `\"off\"`.\n\nString values merge the previous Auto Update and Direct Update configuration:\n- `\"off\"`: Disable automatic update checks.\n- `\"atBackground\"`: Check and download automatically on each foreground check, then apply the update the next time the app moves to background.\n- `\"atInstall\"`: Apply immediately only after a fresh install or native app store update; otherwise use `\"atBackground\"` behavior.\n- `\"onLaunch\"`: Apply immediately only when the app is brought to the foreground from a killed state (cold start). After that first check, fall back to `\"atBackground\"` behavior.\n- `\"always\"`: Check on every foreground transition and apply immediately whenever an update is available.\n- `\"onlyDownload\"`: Check and download automatically, emit `updateAvailable`, and never set the next bundle or apply an update automatically.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
-          "type": "boolean | undefined"
+          "type": "boolean | 'always' | 'off' | 'atBackground' | 'atInstall' | 'onLaunch' | 'onlyDownload' | undefined"
         },
         {
           "name": "resetWhenUpdate",
@@ -3331,7 +4687,7 @@
               "name": "example"
             }
           ],
-          "docs": "Configure the URL / endpoint to which update statistics are sent.\n\nOnly available for Android and iOS. Set to \"\" to disable stats reporting.",
+          "docs": "Configure the URL / endpoint to which update statistics are sent.\n\nOnly available for Android and iOS. Set to \"\" to disable stats reporting.\nNative stats include update lifecycle events, app health signals such as crashes,\nAndroid ANRs, low-memory exits, iOS memory warnings, and WebView health signals\nsuch as JavaScript errors, unhandled promise rejections, resource load failures,\nWebView renderer exits, and unclean WebView restarts when available.",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -3370,6 +4726,10 @@
         {
           "name": "directUpdate",
           "tags": [
+            {
+              "text": "Use {@link PluginsConfig.CapacitorUpdater.autoUpdate} string modes instead.\nWorks well for apps less than 10MB and with uploads done using --delta flag.\nZip or apps more than 10MB will be relatively slow for users to update.\n- false: Never do direct updates (use default behavior: download on foreground check, apply when backgrounded)\n- atInstall: Direct update only after app install or native app store update, otherwise act as directUpdate = false\n- onLaunch: Direct update only when the app is brought to the foreground from a killed state, otherwise act as directUpdate = false\n- always: Direct update on every foreground check whenever an update is available, never act as directUpdate = false\n- true: (deprecated) Same as \"always\" for backward compatibility\n\nActivate this flag will automatically make the CLI upload delta in CICD envs and will ask for confirmation in local uploads.\nOnly available for Android and iOS.",
+              "name": "deprecated"
+            },
             {
               "text": "false",
               "name": "default"
@@ -3379,7 +4739,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 --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.",
+          "docs": "Configure when the plugin should direct install updates. Only for autoUpdate mode.",
           "complexTypes": [],
           "type": "boolean | 'always' | 'atInstall' | 'onLaunch' | undefined"
         },
@@ -3395,7 +4755,7 @@
               "name": "since"
             }
           ],
-          "docs": "Automatically handle splashscreen hiding when using directUpdate. When enabled, the plugin will automatically hide the splashscreen after updates are applied or when no update is needed.\nThis removes the need to manually listen for appReady events and call SplashScreen.hide().\nOnly works when directUpdate is set to \"atInstall\", \"always\", \"onLaunch\", or true.\nRequires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false.\nRequires autoUpdate and directUpdate to be enabled.\n\nOnly available for Android and iOS.",
+          "docs": "Automatically handle splashscreen hiding when using directUpdate. When enabled, the plugin will automatically hide the splashscreen after updates are applied or when no update is needed.\nThis removes the need to manually listen for appReady events and call SplashScreen.hide().\nOnly works when autoUpdate is set to \"atInstall\", \"always\", or \"onLaunch\", or when the deprecated directUpdate option is set to \"atInstall\", \"always\", \"onLaunch\", or true.\nRequires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false.\nRequires Auto Update and Direct Update behavior to be enabled.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
@@ -3611,6 +4971,22 @@
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "allowPreview",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            },
+            {
+              "text": "8.47.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Allow JavaScript to start a native preview session and temporarily request updates for another app id.\nThis is intended for trusted container apps that implement Expo Go-style preview flows.\n\nOnly available for Android and iOS.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        },
         {
           "name": "persistCustomId",
           "tags": [
@@ -3751,10 +5127,28 @@
               "name": "since"
             }
           ],
-          "docs": "Enable shake gesture to show update menu for debugging/testing purposes",
+          "docs": "Enable the native preview menu gesture while a preview session is active.\nOutside preview sessions this preview menu is ignored, unless\n{@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "shakeMenuGesture",
+          "tags": [
+            {
+              "text": "'shake'",
+              "name": "default"
+            },
+            {
+              "text": "8.48.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Choose which native gesture opens the preview/channel menu.\nThis applies to both {@link PluginsConfig.CapacitorUpdater.shakeMenu}\nand {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.\n\nOnly available for Android and iOS.",
+          "complexTypes": [
+            "ShakeMenuGesture"
+          ],
+          "type": "ShakeMenuGesture"
+        },
         {
           "name": "allowShakeChannelSelector",
           "tags": [
@@ -3767,7 +5161,7 @@
               "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.",
+          "docs": "Enable the native menu gesture to show a channel selector menu for switching between update channels.\nIf {@link PluginsConfig.CapacitorUpdater.shakeMenu} is also enabled while a preview session is active,\nthe shake menu includes both preview actions and channel switching.\nThe native gesture can be changed with {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
           "type": "boolean | undefined"
         }