@capgo/capacitor-inappbrowser 8.11.0 → 8.12.0

package/README.md

@@ -1540,6 +1540,7 @@ And in the AndroidManifest.xml file:
 | **`titleIcon`**                        | <code><a href="#toolbartitleiconoptions">ToolbarTitleIconOptions</a></code>                                                                                            | Native toolbar title icon displayed before the title text. For Android: - iconType can be "asset" for a bundled SVG asset or "vector" for a drawable resource - icon path should be in the public folder for assets (e.g. "brand.svg") - width and height are optional and default to 24dp For iOS: - iconType can be "sf-symbol" or "asset" - for sf-symbol, icon should be the symbol name - for asset, icon should be the asset name or bundled web asset path                                                                                                                                                                                                                                                                                                                                                                        |                                                               | 8.7.7  |
 | **`backgroundColor`**                  | <code><a href="#backgroundcolor">BackgroundColor</a></code>                                                                                                            | Background color of the browser                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <code>BackgroundColor.BLACK</code>                            | 0.1.0  |
 | **`activeNativeNavigationForWebview`** | <code>boolean</code>                                                                                                                                                   | If true, enables native navigation gestures within the webview. - Android: Native back button navigates within webview history - iOS: Enables swipe left/right gestures for back/forward navigation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false (Android), true (iOS - enabled by default)</code> |        |
+| **`enableReloadGesture`**              | <code>boolean</code>                                                                                                                                                   | Enable pull-to-refresh (overscroll from top) to reload the current page. - iOS: Uses UIRefreshControl on the WebView scroll view - Android: Uses SwipeRefreshLayout around the WebView On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`, the reload gesture will not work.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false</code>                                            | 8.10.8 |
 | **`disableGoBackOnNativeApplication`** | <code>boolean</code>                                                                                                                                                   | Disable the possibility to go back on native application, useful to force user to stay on the webview, Android only                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false</code>                                            |        |
 | **`isPresentAfterPageLoad`**           | <code>boolean</code>                                                                                                                                                   | Open url in a new window fullscreen isPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately. Promise timing: on Android, `openWebView()` resolves with the webview id when the webview is ready to be controlled (immediately for hidden/immediate presentation, after the first page load when `isPresentAfterPageLoad` is `true`). On iOS, the promise resolves with the id as soon as the native webview is created, even if presentation is deferred.                                                                                                                                                                                                                                                                                           | <code>false</code>                                            | 0.1.0  |
 | **`isInspectable`**                    | <code>boolean</code>                                                                                                                                                   | Whether the website in the webview is inspectable or not, ios only                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <code>false</code>                                            |        |

package/android/build.gradle

@@ -60,5 +60,6 @@ dependencies {
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
     implementation "androidx.browser:browser:$androidxBrowserVersion"
     implementation 'com.google.android.material:material:1.13.0'
+    implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0'
     implementation 'androidx.webkit:webkit:1.15.0'
 }

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/CapgoInAppBrowserPlugin.java

@@ -1227,6 +1227,7 @@ public class CapgoInAppBrowserPlugin extends Plugin implements WebViewDialog.Per
         }
 
         options.setActiveNativeNavigationForWebview(Boolean.TRUE.equals(call.getBoolean("activeNativeNavigationForWebview", false)));
+        options.setEnableReloadGesture(Boolean.TRUE.equals(call.getBoolean("enableReloadGesture", false)));
         options.setDisableGoBackOnNativeApplication(Boolean.TRUE.equals(call.getBoolean("disableGoBackOnNativeApplication", false)));
         options.setPresentAfterPageLoad(Boolean.TRUE.equals(call.getBoolean("isPresentAfterPageLoad", false)));
         options.setPluginCall(call);

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/Options.java

@@ -158,6 +158,7 @@ public class Options {
     private String shareSubject;
     private boolean disableGoBackOnNativeApplication;
     private boolean activeNativeNavigationForWebview;
+    private boolean enableReloadGesture = false;
     private boolean isPresentAfterPageLoad;
     private WebViewCallbacks callbacks;
     private PluginCall pluginCall;
@@ -539,6 +540,14 @@ public class Options {
         this.activeNativeNavigationForWebview = activeNativeNavigationForWebview;
     }
 
+    public boolean getEnableReloadGesture() {
+        return enableReloadGesture;
+    }
+
+    public void setEnableReloadGesture(boolean enableReloadGesture) {
+        this.enableReloadGesture = enableReloadGesture;
+    }
+
     public boolean getDisableGoBackOnNativeApplication() {
         return disableGoBackOnNativeApplication;
     }
@@ -763,6 +772,7 @@ public class Options {
         copy.setShareSubject(shareSubject);
         copy.setDisableGoBackOnNativeApplication(disableGoBackOnNativeApplication);
         copy.setActiveNativeNavigationForWebview(activeNativeNavigationForWebview);
+        copy.setEnableReloadGesture(enableReloadGesture);
         copy.setPresentAfterPageLoad(false);
         copy.setVisibleTitle(VisibleTitle);
         copy.setToolbarColor(ToolbarColor);

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/WebViewDialog.java

@@ -76,6 +76,7 @@ import androidx.core.graphics.Insets;
 import androidx.core.view.ViewCompat;
 import androidx.core.view.WindowInsetsCompat;
 import androidx.core.view.WindowInsetsControllerCompat;
+import androidx.swiperefreshlayout.widget.SwipeRefreshLayout;
 import androidx.webkit.WebMessageCompat;
 import androidx.webkit.WebSettingsCompat;
 import androidx.webkit.WebViewCompat;
@@ -328,6 +329,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
         }
     }
 
+    private SwipeRefreshLayout swipeRefreshLayout;
     private WebView _webView;
     private Toolbar _toolbar;
     private Options _options = null;
@@ -2171,6 +2173,14 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
 
         this._webView = findViewById(R.id.browser_view);
 
+        this.swipeRefreshLayout = findViewById(R.id.content_browser_layout);
+        if (this.swipeRefreshLayout != null) {
+            boolean enableReloadGesture = _options != null && _options.getEnableReloadGesture();
+            this.swipeRefreshLayout.setEnabled(enableReloadGesture);
+            this.swipeRefreshLayout.setOnRefreshListener(() -> reload());
+            this.swipeRefreshLayout.setOnChildScrollUpCallback((parent, child) -> _webView != null && _webView.canScrollVertically(-1));
+        }
+
         // Apply insets to fix edge-to-edge issues on Android 15+
         applyInsets();
 
@@ -3805,6 +3815,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
     public void reload() {
         if (_webView == null) {
             Log.w("InAppBrowser", "Cannot reload - WebView is null");
+            stopReloadGesture();
             return;
         }
 
@@ -3824,9 +3835,17 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                 Log.d("InAppBrowser", "Loading initial URL: " + _options.getUrl());
             } else {
                 Log.w("InAppBrowser", "Cannot reload - no valid URL available");
+                stopReloadGesture();
             }
         } catch (Exception e) {
             Log.e("InAppBrowser", "Error during reload: " + e.getMessage());
+            stopReloadGesture();
+        }
+    }
+
+    private void stopReloadGesture() {
+        if (swipeRefreshLayout != null && swipeRefreshLayout.isRefreshing()) {
+            swipeRefreshLayout.setRefreshing(false);
         }
     }
 
@@ -4916,6 +4935,9 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                     if (_options.getPreventDeeplink()) {
                         Log.d("InAppBrowser", "preventDeeplink is true");
                         if (isNotHttpOrHttps) {
+                            if (request.isForMainFrame()) {
+                                stopReloadGesture();
+                            }
                             return true;
                         }
                     }
@@ -4934,6 +4956,9 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                             intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                             context.startActivity(intent);
                             Log.i("InAppBrowser", "Intent started for authorized link: " + url);
+                            if (request.isForMainFrame()) {
+                                stopReloadGesture();
+                            }
                             return true;
                         } catch (ActivityNotFoundException e) {
                             Log.e("InAppBrowser", "No app found to handle this authorized link", e);
@@ -4955,6 +4980,9 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                             if (shouldEmitCustomSchemeEvent && _options.getCallbacks() != null) {
                                 _options.getCallbacks().customSchemeIntercepted(url, true);
                             }
+                            if (request.isForMainFrame()) {
+                                stopReloadGesture();
+                            }
                             return true;
                         } catch (ActivityNotFoundException e) {
                             Log.w("InAppBrowser", "No handler for external URL: " + url, e);
@@ -4966,6 +4994,9 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                                 _options.getCallbacks().pageLoadError();
                                 rejectOpenWebViewIfNeeded("No handler available for external URL: " + url);
                             }
+                            if (request.isForMainFrame()) {
+                                stopReloadGesture();
+                            }
                             return true; // prevent WebView from attempting to load the custom scheme
                         } catch (URISyntaxException e) {
                             Log.w("InAppBrowser", "No handler for external URL: " + url, e);
@@ -4974,6 +5005,9 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                                 _options.getCallbacks().pageLoadError();
                                 rejectOpenWebViewIfNeeded("No handler available for external URL: " + url);
                             }
+                            if (request.isForMainFrame()) {
+                                stopReloadGesture();
+                            }
                             return true; // prevent WebView from attempting to load the custom scheme
                         }
                     }
@@ -4988,6 +5022,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                                 _options.getCallbacks().urlChangeEvent(url);
                             }
                             Log.d("InAppBrowser", "Navigation blocked for URL: " + url);
+                            stopReloadGesture();
                             return true; // Block the navigation
                         }
                     }
@@ -5527,6 +5562,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                     updateNavigationButtonsState();
 
                     _options.getCallbacks().pageLoaded();
+                    stopReloadGesture();
                     injectJavaScriptInterface();
 
                     // Inject Google Pay polyfills if enabled
@@ -5544,6 +5580,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                     if (request == null || !request.isForMainFrame()) {
                         return;
                     }
+                    stopReloadGesture();
                     if (_options.getCallbacks() != null) {
                         _options.getCallbacks().pageLoadError();
                     }

package/android/src/main/res/layout/content_browser.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
+<androidx.swiperefreshlayout.widget.SwipeRefreshLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:app="http://schemas.android.com/apk/res-auto"
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
@@ -14,4 +14,4 @@
         android:layout_width="match_parent"
         android:layout_height="match_parent"/>
 
-</RelativeLayout>
+</androidx.swiperefreshlayout.widget.SwipeRefreshLayout>

package/dist/docs.json

@@ -1756,6 +1756,26 @@
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "enableReloadGesture",
+          "tags": [
+            {
+              "text": "8.10.8",
+              "name": "since"
+            },
+            {
+              "text": "false",
+              "name": "default"
+            },
+            {
+              "text": "enableReloadGesture: true",
+              "name": "example"
+            }
+          ],
+          "docs": "Enable pull-to-refresh (overscroll from top) to reload the current page.\n- iOS: Uses UIRefreshControl on the WebView scroll view\n- Android: Uses SwipeRefreshLayout around the WebView\n\nOn iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,\nthe reload gesture will not work.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        },
         {
           "name": "disableGoBackOnNativeApplication",
           "tags": [

package/dist/esm/definitions.d.ts

@@ -835,6 +835,20 @@ export interface OpenWebViewOptions {
      * Test URL: https://capgo.app
      */
     activeNativeNavigationForWebview?: boolean;
+    /**
+     * Enable pull-to-refresh (overscroll from top) to reload the current page.
+     * - iOS: Uses UIRefreshControl on the WebView scroll view
+     * - Android: Uses SwipeRefreshLayout around the WebView
+     *
+     * On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,
+     * the reload gesture will not work.
+     *
+     * @since 8.10.8
+     * @default false
+     * @example
+     * enableReloadGesture: true
+     */
+    enableReloadGesture?: boolean;
     /**
      * Disable the possibility to go back on native application,
      * useful to force user to stay on the webview, Android only

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAmEA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AACD,MAAM,CAAN,IAAY,WAqBX;AArBD,WAAY,WAAW;IACrB;;;OAGG;IACH,oCAAqB,CAAA;IACrB;;;OAGG;IACH,kCAAmB,CAAA;IACnB;;;OAGG;IACH,wCAAyB,CAAA;IACzB;;;OAGG;IACH,8BAAe,CAAA;AACjB,CAAC,EArBW,WAAW,KAAX,WAAW,QAqBtB;AAED,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,mCAAe,CAAA;IACf;;OAEG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B;AAED,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACrB;;OAEG;IACH,8BAAe,CAAA;IACf;;OAEG;IACH,4BAAa,CAAA;AACf,CAAC,EATW,WAAW,KAAX,WAAW,QAStB","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface UrlEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when the url changes\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\n/**\n * Event emitted when the managed webview intercepts a non-standard custom scheme\n * and hands it to the operating system.\n *\n * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n *\n * @since 8.6.7\n */\nexport interface CustomSchemeInterceptedEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Intercepted URL.\n   */\n  url: string;\n  /**\n   * Whether the operating system accepted the URL handoff.\n   */\n  opened: boolean;\n}\nexport interface BtnEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when a button is clicked.\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\nexport interface ButtonNearDoneEvent {\n  /**\n   * Webview instance id.\n   *\n   * @since 8.6.36\n   */\n  id: string;\n}\n\nexport type UrlChangeListener = (state: UrlEvent) => void;\nexport type ConfirmBtnListener = (state: BtnEvent) => void;\nexport type ButtonNearListener = (state: ButtonNearDoneEvent) => void;\nexport type CustomSchemeInterceptedListener = (state: CustomSchemeInterceptedEvent) => void;\n\nexport type WebViewPointerInputEventType = 'click' | 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel';\nexport type WebViewInputEventType = WebViewPointerInputEventType | 'scroll';\n\nexport enum BackgroundColor {\n  WHITE = 'white',\n  BLACK = 'black',\n}\nexport enum ToolBarType {\n  /**\n   * Shows a simple toolbar with just a close button and share button\n   * @since 0.1.0\n   */\n  ACTIVITY = 'activity',\n  /**\n   * Shows a simple toolbar with just a close button\n   * @since 7.6.8\n   */\n  COMPACT = 'compact',\n  /**\n   * Shows a full navigation toolbar with back/forward buttons\n   * @since 0.1.0\n   */\n  NAVIGATION = 'navigation',\n  /**\n   * Shows no toolbar\n   * @since 0.1.0\n   */\n  BLANK = 'blank',\n}\n\nexport enum InvisibilityMode {\n  /**\n   * WebView is aware it is hidden (dimensions may be zero).\n   */\n  AWARE = 'AWARE',\n  /**\n   * WebView is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   */\n  FAKE_VISIBLE = 'FAKE_VISIBLE',\n}\n\nexport enum CloseAction {\n  /**\n   * The toolbar close button closes and destroys the webview.\n   */\n  CLOSE = 'close',\n  /**\n   * The toolbar close button hides the webview so it can be shown again.\n   */\n  HIDE = 'hide',\n}\n\nexport interface ToolbarTitleIconOptions {\n  ios?: {\n    iconType: 'sf-symbol' | 'asset';\n    icon: string;\n  };\n  android?: {\n    iconType: 'asset' | 'vector';\n    icon: string;\n    width?: number;\n    height?: number;\n  };\n}\n\nexport interface Headers {\n  [key: string]: string;\n}\n\nexport interface GetCookieOptions {\n  url: string;\n  includeHttpOnly?: boolean;\n}\n\nexport interface ClearCookieOptions {\n  /**\n   * Target webview id.\n   * When omitted, applies to all open webviews.\n   */\n  id?: string;\n  url: string;\n}\n\nexport interface Credentials {\n  username: string;\n  password: string;\n}\n\nexport interface LayerOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Makes the Capacitor host WebView transparent while this native webview is behind it.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n}\n\nexport interface BringToFrontOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Whether bringing the webview to the front is animated on iOS.\n   *\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface DispatchPointerInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: WebViewPointerInputEventType;\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n}\n\nexport interface DispatchScrollInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: 'scroll';\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n  /**\n   * Horizontal scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaX: number;\n  /**\n   * Vertical scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaY: number;\n}\n\nexport type DispatchInputEventOptions = DispatchPointerInputEventOptions | DispatchScrollInputEventOptions;\n\n/**\n * Represents an intercepted HTTP request from the in-app browser webview.\n *\n * Request and response bodies are base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequest {\n  requestId: string;\n  phase: 'outbound' | 'inbound';\n  url: string;\n  method: string;\n  headers: Record<string, string>;\n  body: string | null;\n  status?: number;\n  responseHeaders?: Record<string, string>;\n  responseBody?: string | null;\n  webviewId: string;\n}\n\n/**\n * Response payload returned to native for a proxied request.\n *\n * The body must be base64-encoded.\n *\n * @since 8.6.0\n */\nexport interface ProxyResponse {\n  body: string;\n  status: number;\n  headers: Record<string, string>;\n}\n\n/**\n * Request override returned to native for an outbound proxied request.\n *\n * The body must be base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequestOverride {\n  url: string;\n  method?: string;\n  headers?: Record<string, string>;\n  body?: string | null;\n}\n\n/**\n * Event emitted when a web page opens a popup/new window.\n *\n * @since 8.6.0\n */\nexport interface PopupWindowEvent {\n  /**\n   * Popup webview instance id.\n   */\n  id: string;\n  /**\n   * Parent webview instance id.\n   */\n  parentId?: string;\n  /**\n   * Requested popup URL when available.\n   */\n  url?: string;\n  /**\n   * Whether the popup was presented immediately.\n   */\n  visible: boolean;\n}\n\n/**\n * Event emitted when JavaScript running inside the managed webview writes to the console.\n *\n * Enable this with `captureConsoleLogs: true` when opening the webview.\n *\n * @since 8.6.0\n */\nexport interface ConsoleMessageEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Console method or normalized severity.\n   */\n  level: 'log' | 'info' | 'warn' | 'error' | 'debug' | 'assert' | string;\n  /**\n   * Joined string representation of the console arguments.\n   */\n  message: string;\n  /**\n   * Script URL or page URL when available.\n   */\n  source?: string;\n  /**\n   * 1-based line number when available.\n   */\n  line?: number;\n  /**\n   * 1-based column number when available.\n   */\n  column?: number;\n  /**\n   * Optional subtype for runtime-originated errors on supported platforms.\n   */\n  kind?: string;\n}\n\n/**\n * Native handling mode used after a managed download finishes.\n *\n * @since 8.6.0\n */\nexport type DownloadHandledBy = 'inAppBrowser' | 'systemPreview' | 'external';\n\n/**\n * Event emitted after a managed download is saved locally.\n *\n * @since 8.6.0\n */\nexport interface DownloadCompletedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Saved filename.\n   */\n  fileName: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Absolute native filesystem path to the saved file.\n   */\n  path: string;\n  /**\n   * `file://` URL pointing at the saved file.\n   */\n  localUrl: string;\n  /**\n   * How native handled the downloaded file after saving it.\n   */\n  handledBy: DownloadHandledBy;\n}\n\n/**\n * Event emitted when managed download handling fails.\n *\n * @since 8.6.0\n */\nexport interface DownloadFailedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Intended filename when known.\n   */\n  fileName?: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Native error message.\n   */\n  error: string;\n}\n\n/**\n * Decision returned to native when handling a proxied request.\n *\n * @since 8.6.0\n */\nexport interface ProxyDecision {\n  request?: ProxyRequestOverride | null;\n  response?: ProxyResponse | null;\n  cancel?: boolean;\n}\n\n/**\n * Native-first proxy rule used on Android and iOS.\n *\n * Any regex property that is omitted is treated as a wildcard.\n *\n * @since 8.6.0\n */\nexport interface NativeProxyRule {\n  id?: string;\n  urlRegex?: string;\n  methodRegex?: string;\n  headerRegex?: string;\n  bodyRegex?: string;\n  statusRegex?: string;\n  responseHeaderRegex?: string;\n  responseBodyRegex?: string;\n  mainFrameOnly?: boolean;\n  action: 'continue' | 'cancel' | 'delegateToJs';\n}\n\nexport type ProxyHandlerResult = Response | ProxyResponse | ProxyRequestOverride | ProxyDecision | null;\n\n/**\n * JavaScript callback used to handle proxied requests.\n *\n * Return a `Response`, `ProxyResponse`, `ProxyRequestOverride`, `ProxyDecision`,\n * or `null` to let native continue unchanged.\n *\n * @since 8.6.0\n */\nexport type ProxyHandler = (request: ProxyRequest) => ProxyHandlerResult | Promise<ProxyHandlerResult>;\n\nexport interface OpenOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   */\n  url: string;\n  /**\n   * if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * @since 0.1.0\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * if true the deeplink will not be opened, if false the deeplink will be opened when clicked on the link\n   * @since 0.1.0\n   */\n  preventDeeplink?: boolean;\n\n  // --- Chrome Custom Tab customization (Android only, ignored on iOS) ---\n\n  /**\n   * Toolbar background color in hex format (e.g., \"#1A1A2E\").\n   * Applied to both light and dark color schemes.\n   * Also sets the navigation bar color to match.\n   * **Android only** — ignored on iOS.\n   * @since 8.2.0\n   */\n  toolbarColor?: string;\n\n  /**\n   * Whether the URL bar should auto-hide when the user scrolls down.\n   * The bar reappears on any upward scroll.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  urlBarHidingEnabled?: boolean;\n\n  /**\n   * Show the page's HTML <title> in the toolbar instead of the raw URL.\n   * The true URL is still visible when the user taps the title area.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showTitle?: boolean;\n\n  /**\n   * Replace the default \"X\" close icon with a back arrow.\n   * Makes the Custom Tab feel like a native navigation push rather than a modal overlay.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showArrow?: boolean;\n\n  /**\n   * Remove the share action from the overflow menu.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableShare?: boolean;\n\n  /**\n   * Hide the bookmark star icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableBookmark?: boolean;\n\n  /**\n   * Hide the download icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableDownload?: boolean;\n}\n\nexport interface OpenSecureWindowOptions {\n  /**\n   * The endpoint to open\n   */\n  authEndpoint: string;\n  /**\n   * The redirect URI to use for the openSecureWindow call.\n   * This will be checked to make sure it matches the redirect URI after the window finishes the redirection.\n   */\n  redirectUri: string;\n  /**\n   * The name of the broadcast channel to listen to, relevant only for web\n   */\n  broadcastChannelName?: string;\n  /**\n   * If true, the browser session will be ephemeral (no cookies or browsing data are shared with the system browser).\n   * On iOS, this sets `prefersEphemeralWebBrowserSession = true` on `ASWebAuthenticationSession`.\n   * On Android, this enables Custom Tabs ephemeral browsing via `setEphemeralBrowsingEnabled(true)`.\n   * @default false\n   * @since 6.6.0\n   */\n  prefersEphemeralWebBrowserSession?: boolean;\n}\n\nexport interface OpenSecureWindowResponse {\n  /**\n   * The result of the openSecureWindow call\n   */\n  redirectedUri: string;\n}\n\nexport interface DisclaimerOptions {\n  /**\n   * Title of the disclaimer dialog\n   * @default \"Title\"\n   */\n  title: string;\n  /**\n   * Message shown in the disclaimer dialog\n   * @default \"Message\"\n   */\n  message: string;\n  /**\n   * Text for the confirm button\n   * @default \"Confirm\"\n   */\n  confirmBtn: string;\n  /**\n   * Text for the cancel button\n   * @default \"Cancel\"\n   */\n  cancelBtn: string;\n}\n\nexport interface ScreenshotResult {\n  /**\n   * Image format used for the screenshot.\n   */\n  format: 'png';\n  /**\n   * MIME type of the generated screenshot.\n   */\n  mimeType: 'image/png';\n  /**\n   * Base64-encoded screenshot payload without the data URL prefix.\n   */\n  base64: string;\n  /**\n   * Data URL for direct use in HTML img tags or uploads.\n   */\n  dataUrl: string;\n  /**\n   * Screenshot width in pixels.\n   */\n  width: number;\n  /**\n   * Screenshot height in pixels.\n   */\n  height: number;\n}\n\nexport interface HideEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * URL active when the webview was hidden.\n   */\n  url: string;\n  /**\n   * Screenshot captured immediately before the toolbar close button hides the webview.\n   * Present only when `screenshotOnHide` is enabled and capture succeeds.\n   */\n  screenshot?: ScreenshotResult;\n}\n\nexport type HideListener = (state: HideEvent) => void;\n\nexport interface CloseWebviewOptions {\n  /**\n   * Target webview id to close. If omitted, closes the active webview.\n   */\n  id?: string;\n  /**\n   * Whether the webview closing is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface OpenWebViewOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   * @example \"https://capgo.app\"\n   */\n  url: string;\n  /**\n   * Headers to send with the request.\n   * @since 0.1.0\n   * @example\n   * headers: {\n   *   \"Custom-Header\": \"test-value\",\n   *   \"Authorization\": \"Bearer test-token\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  headers?: Headers;\n  /**\n   * Credentials to send with the request and all subsequent requests for the same host.\n   * @since 6.1.0\n   * @example\n   * credentials: {\n   *   username: \"test-user\",\n   *   password: \"test-pass\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  credentials?: Credentials;\n  /**\n   * HTTP method to use for the initial request.\n   *\n   * **Optional parameter - defaults to GET if not specified.**\n   * Existing code that doesn't provide this parameter will continue to work unchanged with standard GET requests.\n   *\n   * When specified with 'POST', 'PUT', or 'PATCH' methods that support a body,\n   * you can also provide a `body` parameter with the request payload.\n   *\n   * **Platform Notes:**\n   * - iOS: Full support for all HTTP methods with headers\n   * - Android: Custom headers may not be sent with POST/PUT/PATCH requests due to WebView limitations\n   *\n   * @since 8.2.0\n   * @default \"GET\"\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ token: \"auth-token\", data: \"value\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | string;\n  /**\n   * HTTP body to send with the request when using POST, PUT, or other methods that support a body.\n   * Should be a string (use JSON.stringify for JSON data).\n   *\n   * **Optional parameter - only used when `method` is specified and supports a request body.**\n   * Omitting this parameter (or using GET method) results in standard behavior without a request body.\n   *\n   * @since 8.2.0\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ username: \"user\", password: \"pass\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  body?: string;\n  /**\n   * materialPicker: if true, uses Material Design theme for date and time pickers on Android.\n   * This improves the appearance of HTML date inputs to use modern Material Design UI instead of the old style pickers.\n   * @since 7.4.1\n   * @default false\n   * @example\n   * materialPicker: true\n   * Test URL: https://show-picker.glitch.me/demo.html\n   */\n  materialPicker?: boolean;\n  /**\n   * JavaScript Interface:\n   * The webview automatically injects a JavaScript interface providing:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage(obj)`: Sends a message to the app (listen via \"messageFromWebview\" event)\n   * - `window.mobileApp.hide()` / `window.mobileApp.show()` when allowWebViewJsVisibilityControl is true in CapacitorConfig\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * @example\n   * // In your webpage loaded in the webview:\n   * document.getElementById(\"closeBtn\").addEventListener(\"click\", () => {\n   *   window.mobileApp.close();\n   * });\n   *\n   * // Send data to the app\n   * window.mobileApp.postMessage({ action: \"login\", data: { user: \"test\" }});\n   *\n   * @since 6.10.0\n   */\n  jsInterface?: never; // This property doesn't exist, it's just for documentation\n  /**\n   * Allows page JavaScript to call `window.mobileApp.takeScreenshot()`.\n   * Disabled by default so only the host app can trigger native screenshots through the plugin API.\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  allowScreenshotsFromWebPage?: boolean;\n  /**\n   * Emits `consoleMessage` events for JavaScript `console.*` output coming from the managed page.\n   * Useful when the webview stays hidden and you still need page-level diagnostics.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  captureConsoleLogs?: boolean;\n  /**\n   * Controls whether the webview should persist website data such as cache, cookies, local storage,\n   * IndexedDB, and session data.\n   *\n   * When false, iOS uses a non-persistent `WKWebsiteDataStore`. Android disables per-view cache and\n   * DOM/database storage where the system WebView supports it. Android cookies use the shared\n   * WebView cookie store, so call `clearAllBrowsingData()` to remove cookies and other global data.\n   *\n   * @default true\n   * @since 8.6.36\n   */\n  persistWebViewData?: boolean;\n  /**\n   * Controls Android TLS client certificate prompts during HTTPS handshakes.\n   * Use `prompt` to show the system certificate picker; omit or use `none` to cancel silently (default).\n   *\n   * @default \"none\"\n   * @since 8.7.5\n   */\n  clientCertificate?: 'none' | 'prompt';\n  /**\n   * @deprecated Use `clientCertificate: \"prompt\"` instead.\n   */\n  clientCertificatePrompt?: boolean;\n  /**\n   * Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge.\n   *\n   * When enabled:\n   * - Standard attachment responses are written to a temporary file.\n   * - `blob:` downloads are also captured when the platform supports them.\n   * - Previewable files reopen inside the in-app browser when possible.\n   * - Other files are handed off to the native preview or viewer flow.\n   * - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  handleDownloads?: boolean;\n  /**\n   * Share options for the webview. When provided, shows a disclaimer dialog before sharing content.\n   * This is useful for:\n   * - Warning users about sharing sensitive information\n   * - Getting user consent before sharing\n   * - Explaining what will be shared\n   * - Complying with privacy regulations\n   *\n   * Note: shareSubject is required when using shareDisclaimer\n   * @since 0.1.0\n   * @example\n   * shareDisclaimer: {\n   *   title: \"Disclaimer\",\n   *   message: \"This is a test disclaimer\",\n   *   confirmBtn: \"Accept\",\n   *   cancelBtn: \"Decline\"\n   * }\n   * Test URL: https://capgo.app\n   */\n  shareDisclaimer?: DisclaimerOptions;\n  /**\n   * Toolbar type determines the appearance and behavior of the browser's toolbar\n   * - \"activity\": Shows a simple toolbar with just a close button and share button\n   * - \"navigation\": Shows a full navigation toolbar with back/forward buttons\n   * - \"blank\": Shows no toolbar\n   * - \"\": Default toolbar with close button\n   * @since 0.1.0\n   * @default ToolBarType.DEFAULT\n   * @example\n   * toolbarType: ToolBarType.ACTIVITY,\n   * title: \"Activity Toolbar Test\"\n   * Test URL: https://capgo.app\n   */\n  toolbarType?: ToolBarType;\n  /**\n   * Subject text for sharing. Required when using shareDisclaimer.\n   * This text will be used as the subject line when sharing content.\n   * @since 0.1.0\n   * @example \"Share this page\"\n   */\n  shareSubject?: string;\n  /**\n   * Title of the browser\n   * @since 0.1.0\n   * @default \"New Window\"\n   * @example \"Camera Test\"\n   */\n  title?: string;\n  /**\n   * Native toolbar title font family.\n   * On iOS, use the registered font family name. On Android, the plugin first tries a res/font resource name,\n   * then falls back to a system font family name.\n   *\n   * @since 8.7.7\n   * @example \"Inter\"\n   */\n  titleFontFamily?: string;\n  /**\n   * Native toolbar title icon displayed before the title text.\n   *\n   * For Android:\n   * - iconType can be \"asset\" for a bundled SVG asset or \"vector\" for a drawable resource\n   * - icon path should be in the public folder for assets (e.g. \"brand.svg\")\n   * - width and height are optional and default to 24dp\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name or bundled web asset path\n   *\n   * @since 8.7.7\n   * @example\n   * titleIcon: {\n   *   ios: { iconType: \"sf-symbol\", icon: \"lock.fill\" },\n   *   android: { iconType: \"vector\", icon: \"ic_lock\", width: 20, height: 20 }\n   * }\n   */\n  titleIcon?: ToolbarTitleIconOptions;\n  /**\n   * Background color of the browser\n   * @since 0.1.0\n   * @default BackgroundColor.BLACK\n   */\n  backgroundColor?: BackgroundColor;\n  /**\n   * If true, enables native navigation gestures within the webview.\n   * - Android: Native back button navigates within webview history\n   * - iOS: Enables swipe left/right gestures for back/forward navigation\n   * @default false (Android), true (iOS - enabled by default)\n   * @example\n   * activeNativeNavigationForWebview: true,\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  activeNativeNavigationForWebview?: boolean;\n  /**\n   * Disable the possibility to go back on native application,\n   * useful to force user to stay on the webview, Android only\n   * @default false\n   * @example\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  disableGoBackOnNativeApplication?: boolean;\n  /**\n   * Open url in a new window fullscreen\n   * isPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * Promise timing: on Android, `openWebView()` resolves with the webview id when the webview is ready to be controlled\n   * (immediately for hidden/immediate presentation, after the first page load when `isPresentAfterPageLoad` is `true`).\n   * On iOS, the promise resolves with the id as soon as the native webview is created, even if presentation is deferred.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * isPresentAfterPageLoad: true,\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * Whether the website in the webview is inspectable or not, ios only\n   * @default false\n   */\n  isInspectable?: boolean;\n  /**\n   * Whether the webview opening is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n  /**\n   * Shows a reload button that reloads the web page\n   * @since 1.0.15\n   * @default false\n   * @example\n   * showReloadButton: true\n   * Test URL: https://capgo.app\n   */\n  showReloadButton?: boolean;\n  /**\n   * closeAction controls what happens when the native toolbar close button is pressed.\n   * This does not change the behavior of close(), JavaScript window.mobileApp.close(), or native back navigation.\n   *\n   * @default CloseAction.CLOSE\n   * @since 8.7.7\n   * @example\n   * closeAction: CloseAction.HIDE\n   */\n  closeAction?: CloseAction;\n  /**\n   * Captures the visible webview and includes it as `screenshot` in `hideEvent`\n   * before the toolbar close button hides the webview.\n   *\n   * Only applies when `closeAction` is `CloseAction.HIDE`.\n   *\n   * On iOS, capture uses `WKWebView.takeSnapshot`. When testing through Apple's\n   * iPhone Mirroring app with the physical device locked, the snapshot can succeed\n   * with the correct dimensions but a fully transparent PNG. Capture works as\n   * expected on a normal unlocked device. This appears to be an Apple mirroring\n   * limitation rather than a plugin bug.\n   *\n   * @default false\n   * @since 8.7.10\n   */\n  screenshotOnHide?: boolean;\n  /**\n   * CloseModal: if true a confirm will be displayed when user clicks on close button, if false the browser will be closed immediately.\n   * @since 1.1.0\n   * @default false\n   * @example\n   * closeModal: true,\n   * closeModalTitle: \"Close Window\",\n   * closeModalDescription: \"Are you sure you want to close?\",\n   * closeModalOk: \"Yes, close\",\n   * closeModalCancel: \"No, stay\"\n   * Test URL: https://capgo.app\n   */\n  closeModal?: boolean;\n  /**\n   * CloseModalTitle: title of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalTitle?: string;\n  /**\n   * CloseModalDescription: description of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Are you sure you want to close this window?\"\n   */\n  closeModalDescription?: string;\n  /**\n   * CloseModalOk: text of the confirm button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalOk?: string;\n  /**\n   * CloseModalCancel: text of the cancel button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Cancel\"\n   */\n  closeModalCancel?: string;\n  /**\n   * closeModalURLPattern: a regex pattern to match against the current URL when the close button is pressed.\n   * When provided along with closeModal: true, the close confirmation modal is only shown if the current URL matches this pattern.\n   * If the current URL does not match, the browser closes immediately without showing the modal.\n   * Requires closeModal to be true.\n   * @since 7.2.0\n   * @example\n   * closeModal: true,\n   * closeModalURLPattern: \".*checkout.*\"\n   */\n  closeModalURLPattern?: string;\n  /**\n   * visibleTitle: if true the website title would be shown else shown empty\n   * @since 1.2.5\n   * @default true\n   */\n  visibleTitle?: boolean;\n  /**\n   * toolbarColor: color of the toolbar in hex format\n   * @since 1.2.5\n   * @default \"#ffffff\"\n   * @example\n   * toolbarColor: \"#FF5733\"\n   * Test URL: https://capgo.app\n   */\n  toolbarColor?: string;\n  /**\n   * toolbarTextColor: color of the buttons and title in the toolbar in hex format\n   * When set, it overrides the automatic light/dark mode detection for text color\n   * @since 6.10.0\n   * @default calculated based on toolbarColor brightness\n   * @example\n   * toolbarTextColor: \"#FFFFFF\"\n   * Test URL: https://capgo.app\n   */\n  toolbarTextColor?: string;\n  /**\n   * showArrow: if true an arrow would be shown instead of cross for closing the window\n   * @since 1.2.5\n   * @default false\n   * @example\n   * showArrow: true\n   * Test URL: https://capgo.app\n   */\n  showArrow?: boolean;\n  /**\n   * ignoreUntrustedSSLError: if true, the webview will ignore untrusted SSL errors allowing the user to view the website.\n   * @since 6.1.0\n   * @default false\n   */\n  ignoreUntrustedSSLError?: boolean;\n  /**\n   * preShowScript: if isPresentAfterPageLoad is true and this variable is set the plugin will inject a script before showing the browser.\n   * This script will be run in an async context. The plugin will wait for the script to finish (max 10 seconds)\n   * @since 6.6.0\n   * @example\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  preShowScript?: string;\n  /**\n   * preShowScriptInjectionTime: controls when the preShowScript is injected.\n   * - \"documentStart\": injects before any page JavaScript runs (good for polyfills like Firebase)\n   * - \"pageLoad\": injects after page load (default, original behavior)\n   * @since 7.26.0\n   * @default \"pageLoad\"\n   * @example\n   * preShowScriptInjectionTime: \"documentStart\"\n   */\n  preShowScriptInjectionTime?: 'documentStart' | 'pageLoad';\n  /**\n   * Proxy interception mode.\n   *\n   * - `true`: legacy blanket mode, delegates all HTTP/HTTPS requests to JavaScript.\n   * - `string`: Android-only regex mode kept for backward compatibility.\n   *\n   * Prefer `outboundProxyRules` and `inboundProxyRules` for native-first matching.\n   *\n   * @since 6.9.0\n   */\n  proxyRequests?: boolean | string;\n  /**\n   * Native-first outbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  outboundProxyRules?: NativeProxyRule[];\n  /**\n   * Native-first inbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  inboundProxyRules?: NativeProxyRule[];\n  /**\n   * buttonNearDone allows for a creation of a custom button near the done/close button.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * For Android:\n   * - iconType must be \"asset\"\n   * - icon path should be in the public folder (e.g. \"monkey.svg\")\n   * - width and height are optional, defaults to 48dp\n   * - button is positioned at the end of toolbar with 8dp margin\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name\n   * @since 6.7.0\n   * @example\n   * buttonNearDone: {\n   *   ios: {\n   *     iconType: \"sf-symbol\",\n   *     icon: \"star.fill\"\n   *   },\n   *   android: {\n   *     iconType: \"asset\",\n   *     icon: \"public/monkey.svg\",\n   *     width: 24,\n   *     height: 24\n   *   }\n   * }\n   * Test URL: https://capgo.app\n   */\n  buttonNearDone?: {\n    ios: {\n      iconType: 'sf-symbol' | 'asset';\n      icon: string;\n    };\n    android: {\n      iconType: 'asset' | 'vector';\n      icon: string;\n      width?: number;\n      height?: number;\n    };\n  };\n  /**\n   * Shows a native screenshot button near the done/close button.\n   * The button is hidden by default and captures the current viewport when tapped.\n   * This option uses the same toolbar slot as `buttonNearDone` and is therefore incompatible with it.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  showScreenshotButton?: boolean;\n  /**\n   * textZoom: sets the text zoom of the page in percent.\n   * Allows users to increase or decrease the text size for better readability.\n   * @since 7.6.0\n   * @default 100\n   * @example\n   * textZoom: 120\n   * Test URL: https://capgo.app\n   */\n  textZoom?: number;\n  /**\n   * enableZoom: enables pinch-to-zoom gestures in the Android WebView.\n   * When true, built-in zoom controls are enabled and the zoom buttons are hidden.\n   * **Android only** — ignored on iOS where zoom is enabled by default.\n   * @since 8.5.0\n   * @default false\n   * @example\n   * enableZoom: true\n   */\n  enableZoom?: boolean;\n  /**\n   * If true, deeplinks and external app hand-off are blocked and stay in the webview.\n   * If false (default), custom schemes such as `tel:`, `mailto:`, and `sms:` open natively.\n   * On iOS, listing a custom scheme under `LSApplicationQueriesSchemes` is only required when\n   * you rely on `canOpenURL` for that scheme (for example `instagram://`). It is not required\n   * for HTTPS `authorizedAppLinks`, and `mailto`/`tel`/`sms` open without that Info.plist entry.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * preventDeeplink: true\n   * Test URL: https://aasa-tester.capgo.app/\n   */\n  preventDeeplink?: boolean;\n\n  /**\n   * When true, HTTP and HTTPS links opened from `target=\"_blank\"` anchors stay in the current webview instead of spawning a popup or opening in the system browser.\n   * By default, blank-target HTTP(S) links stay inside the plugin as managed popups that share cookies with the opener; enabling this option keeps everything in the same tab.\n   * Custom schemes such as `tel:` and `mailto:` and authorized app links still prefer their native handlers unless `preventDeeplink` is enabled.\n   *\n   * @since 8.5.6\n   * @default false\n   * @example\n   * openBlankTargetInWebView: true\n   */\n  openBlankTargetInWebView?: boolean;\n\n  /**\n   * List of base URLs whose hosts are treated as authorized App Links (Android) and Universal Links (iOS).\n   *\n   * - On both platforms, only HTTP(S) links whose host matches any entry in this list\n   *   will attempt to leave the in-app browser for the native / system handler.\n   * - iOS tries a Universal Link first (`universalLinksOnly`), then falls back to a normal\n   *   system open (App Store, Safari, etc.). Only if both fail does the URL stay in-webview.\n   * - Android uses an `ACTION_VIEW` intent for matching hosts.\n   * - Matching is host-based (case-insensitive), ignoring the \"www.\" prefix.\n   * - HTTPS hosts do not need `LSApplicationQueriesSchemes`; that Info.plist key is for\n   *   custom schemes like `instagram://`, not `https://instagram.com`.\n   * - When `preventDeeplink` is enabled, all external handling is blocked regardless of this list.\n   *\n   * @example\n   * ```ts\n   * [\"https://example.com\", \"https://instagram.com\", \"https://apps.apple.com\"]\n   * ```\n   *\n   * @since 7.12.0\n   * @default []\n   */\n  authorizedAppLinks?: string[];\n\n  /**\n   * If true, the webView will not take the full height and will have a 20px margin at the bottom.\n   * This creates a safe margin area outside the browser view.\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enabledSafeBottomMargin: true\n   */\n  enabledSafeBottomMargin?: boolean;\n\n  /**\n   * If false, the webView will extend behind the status bar for true full-screen immersive content.\n   * When true (default), respects the safe area at the top of the screen.\n   * Works independently of toolbarType - use for full-screen video players, games, or immersive web apps.\n   * @since 8.2.0\n   * @default true\n   * @example\n   * enabledSafeTopMargin: false  // Full screen, extends behind status bar\n   */\n  enabledSafeTopMargin?: boolean;\n\n  /**\n   * When true, applies the system status bar inset as the WebView top margin on Android.\n   * Keeps the legacy 0px margin by default for apps that handle padding themselves.\n   * @default false\n   * @example\n   * useTopInset: true\n   */\n  useTopInset?: boolean;\n\n  /**\n   * enableGooglePaySupport: if true, enables support for Google Pay popups and Payment Request API.\n   * This fixes OR_BIBED_15 errors by allowing popup windows and configuring Cross-Origin-Opener-Policy.\n   * Only enable this if you need Google Pay functionality as it allows popup windows.\n   *\n   * When enabled:\n   * - Allows popup windows for Google Pay authentication\n   * - Sets proper CORS headers for Payment Request API\n   * - Enables multiple window support in WebView\n   * - Configures secure context for payment processing\n   *\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enableGooglePaySupport: true\n   * Test URL: https://developers.google.com/pay/api/web/guides/tutorial\n   */\n  enableGooglePaySupport?: boolean;\n\n  /**\n   * Opens popup windows created by the page in hidden mode.\n   * Hidden popup windows can still be controlled with `executeScript`, `postMessage`, `show`, and `close`.\n   * Listen to `popupWindowOpened` to capture the popup id, then call `show({ id })` only if you want to reveal it.\n   *\n   * @default false\n   * @since 8.6.0\n   * @example\n   * hiddenPopupWindow: true\n   */\n  hiddenPopupWindow?: boolean;\n\n  /**\n   * blockedHosts: List of host patterns that should be blocked from loading in the InAppBrowser's internal navigations.\n   * Any request inside WebView to a URL with a host matching any of these patterns will be blocked.\n   * Supports wildcard patterns like:\n   * - \"*.example.com\" to block all subdomains\n   * - \"www.example.*\" to block wildcard domain extensions\n   *\n   * @since 7.17.0\n   * @default []\n   * @example\n   * blockedHosts: [\"*.tracking.com\", \"ads.example.com\"]\n   */\n  blockedHosts?: string[];\n\n  /**\n   * Width of the webview in pixels.\n   * If not set, webview will be fullscreen width.\n   * @default undefined (fullscreen)\n   * @example\n   * width: 400\n   */\n  width?: number;\n\n  /**\n   * Height of the webview in pixels.\n   * If not set, webview will be fullscreen height.\n   * @default undefined (fullscreen)\n   * @example\n   * height: 600\n   */\n  height?: number;\n\n  /**\n   * X position of the webview in pixels from the left edge.\n   * Only effective when width is set.\n   * @default 0\n   * @example\n   * x: 50\n   */\n  x?: number;\n\n  /**\n   * Y position of the webview in pixels from the top edge.\n   * Only effective when height is set.\n   * @default 0\n   * @example\n   * y: 100\n   */\n  y?: number;\n\n  /**\n   * Places the native browser behind the Capacitor host WebView.\n   * Make the app background transparent to reveal it, or rely on `transparentBackground` to clear the host WebView.\n   *\n   * @default false\n   */\n  toBack?: boolean;\n\n  /**\n   * When `toBack` is true, makes the Capacitor host WebView transparent so the native browser can be seen behind Ionic content.\n   * Ignored when the browser is in front.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n\n  /**\n   * Disables the bounce (overscroll) effect on iOS WebView.\n   * When enabled, prevents the rubber band scrolling effect when users scroll beyond content boundaries.\n   * This is useful for:\n   * - Creating a more native, app-like experience\n   * - Preventing accidental overscroll states\n   * - Avoiding issues when keyboard opens/closes\n   *\n   * Note: This option only affects iOS. Android does not have this bounce effect by default.\n   *\n   * @since 8.0.2\n   * @default false\n   * @example\n   * disableOverscroll: true\n   */\n  disableOverscroll?: boolean;\n\n  /**\n   * Opens the webview in hidden mode (not visible to user but fully functional).\n   * When hidden, the webview loads and executes JavaScript but is not displayed.\n   * All control methods (executeScript, postMessage, setUrl, etc.) work while hidden.\n   * Use close() to clean up the hidden webview when done.\n   *\n   * @since 8.0.7\n   * @default false\n   * @example\n   * hidden: true\n   */\n  hidden?: boolean;\n\n  /**\n   * Controls how a hidden webview reports its visibility and size.\n   * - AWARE: webview is aware it's hidden (dimensions may be zero).\n   * - FAKE_VISIBLE: webview is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   *\n   * @default InvisibilityMode.AWARE\n   * @example\n   * invisibilityMode: InvisibilityMode.FAKE_VISIBLE\n   */\n  invisibilityMode?: InvisibilityMode;\n}\n\nexport interface DimensionOptions {\n  /**\n   * Width of the webview in pixels\n   */\n  width?: number;\n  /**\n   * Height of the webview in pixels\n   */\n  height?: number;\n  /**\n   * X position from the left edge in pixels\n   */\n  x?: number;\n  /**\n   * Y position from the top edge in pixels\n   */\n  y?: number;\n}\n\nexport interface InAppBrowserPlugin {\n  /**\n   * Navigates back in the WebView's history if possible\n   *\n   * @since 7.21.0\n   * @returns Promise that resolves with true if navigation was possible, false otherwise\n   */\n  goBack(options?: { id?: string }): Promise<{ canGoBack: boolean }>;\n\n  /**\n   * Open url in a new window fullscreen, on android it use chrome custom tabs, on ios it use SFSafariViewController\n   *\n   * @since 0.1.0\n   */\n  open(options: OpenOptions): Promise<any>;\n\n  /**\n   * Clear cookies of url\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 0.5.0\n   */\n  clearCookies(options: ClearCookieOptions): Promise<any>;\n  /**\n   * Clear all cookies\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearAllCookies(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear cache\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearCache(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear all browsing data from the default store and any opened managed webviews.\n   *\n   * This removes cookies, disk cache, memory cache, local storage, session storage, IndexedDB,\n   * WebSQL where supported, form data, and HTTP auth data where the platform exposes it.\n   *\n   * @since 8.6.36\n   */\n  clearAllBrowsingData(): Promise<any>;\n\n  /**\n   * Get cookies for a specific URL.\n   * @param options The options, including the URL to get cookies for.\n   * @returns A promise that resolves with the cookies.\n   */\n  getCookies(options: GetCookieOptions): Promise<Record<string, string>>;\n  /**\n   * Close the webview.\n   * When `id` is omitted, closes the active webview.\n   */\n  close(options?: CloseWebviewOptions): Promise<any>;\n  /**\n   * Hide the webview without closing it.\n   * Use show() to bring it back.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  hide(options?: { id?: string }): Promise<void>;\n  /**\n   * Show a previously hidden webview.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  show(options?: { id?: string }): Promise<void>;\n  /**\n   * Moves the native browser behind the Capacitor host WebView.\n   * Use `dispatchInputEvent()` to forward overlay gestures to the browser while it is behind the app UI.\n   */\n  sendToBack(options?: LayerOptions): Promise<void>;\n  /**\n   * Moves a browser that was behind the host WebView back to the front.\n   * On iOS, set `isAnimated` to `false` to skip the presentation animation.\n   * When `id` is omitted, targets the active webview.\n   */\n  bringToFront(options?: BringToFrontOptions): Promise<void>;\n  /**\n   * Dispatches a click, touch, or scroll event to a managed browser.\n   * Coordinates are relative to the browser viewport in CSS pixels.\n   */\n  dispatchInputEvent(options: DispatchInputEventOptions): Promise<void>;\n  /**\n   * Open url in a new webview with toolbars, and enhanced capabilities, like camera access, file access, listen events, inject javascript, bi directional communication, etc.\n   *\n   * JavaScript Interface:\n   * When you open a webview with this method, a JavaScript interface is automatically injected that provides:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage({detail: {message: \"myMessage\"}})`: Sends a message from the webview to the app, detail object is the data you want to send to the webview\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * Promise timing differs by platform when `isPresentAfterPageLoad` is used.\n   * Android resolves with `{ id }` after the dialog is ready to control, while iOS resolves with `{ id }` immediately after creating the native webview.\n   *\n   * @returns Promise that resolves with the created webview id.\n   * @since 0.1.0\n   */\n  openWebView(options: OpenWebViewOptions): Promise<{ id: string }>;\n  /**\n   * Injects JavaScript code into the InAppBrowser window.\n   * When `id` is omitted, executes in all open webviews.\n   */\n  executeScript(options: { code: string; id?: string }): Promise<void>;\n  /**\n   * Sends an event to the webview(inappbrowser). you can listen to this event in the inappbrowser JS with window.addEventListener(\"messageFromNative\", listenerFunc: (event: Record<string, any>) => void)\n   * detail is the data you want to send to the webview, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, so no functions or other non-JSON-serializable types are allowed.\n   * When `id` is omitted, broadcasts to all open webviews.\n   */\n  postMessage(options: { detail: Record<string, any>; id?: string }): Promise<void>;\n  /**\n   * Captures the current webview viewport as a PNG screenshot.\n   * When `id` is omitted, targets the active webview.\n   *\n   * On iOS, when testing through Apple's iPhone Mirroring app with the physical\n   * device locked, the snapshot can succeed with the correct dimensions but a\n   * fully transparent PNG. Capture works as expected on a normal unlocked device.\n   */\n  takeScreenshot(options?: { id?: string }): Promise<ScreenshotResult>;\n  /**\n   * Sets the URL of the webview.\n   * When `id` is omitted, targets the active webview.\n   */\n  setUrl(options: { url: string; id?: string }): Promise<any>;\n  /**\n   * Listen for url change, only for openWebView\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'urlChangeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for buttonNearDone clicks.\n   *\n   * The event payload contains the webview `id`.\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'buttonNearDoneClick', listenerFunc: ButtonNearListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for close click only for openWebView\n   *\n   * @since 0.4.0\n   */\n  addListener(eventName: 'closeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for webviews hidden by the toolbar close button when closeAction is CloseAction.HIDE.\n   *\n   * @since 8.7.7\n   */\n  addListener(eventName: 'hideEvent', listenerFunc: HideListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when user clicks on confirm button when disclaimer is required,\n   * works with openWebView shareDisclaimer and closeModal\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'confirmBtnClicked', listenerFunc: ConfirmBtnListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when event is sent from webview(inappbrowser), to send an event to the main app use window.mobileApp.postMessage({ \"detail\": { \"message\": \"myMessage\" } })\n   * detail is the data you want to send to the main app, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, no functions or other non-JSON-serializable types are allowed.\n   *\n   * This method is inject at runtime in the webview\n   */\n  addListener(\n    eventName: 'messageFromWebview',\n    listenerFunc: (event: { id?: string; detail?: Record<string, any>; rawMessage?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered whenever a screenshot is captured from the plugin API,\n   * the native screenshot button, or the injected JavaScript bridge.\n   */\n  addListener(\n    eventName: 'screenshotTaken',\n    listenerFunc: (event: ScreenshotResult & { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page is loaded\n   */\n  addListener(\n    eventName: 'browserPageLoaded',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when a main-frame page load starts (link navigation, reload, etc.).\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadStart',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered as a main-frame page load progresses.\n   * `progress` is a value from `0` to `1`.\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadProgress',\n    listenerFunc: (event: { id?: string; progress: number }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page load error\n   */\n  addListener(\n    eventName: 'pageLoadError',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when the webview intercepts a non-standard custom scheme\n   * and hands it to the operating system.\n   *\n   * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n   *\n   * @since 8.6.7\n   */\n  addListener(\n    eventName: 'customSchemeIntercepted',\n    listenerFunc: CustomSchemeInterceptedListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered after native download handling saves a file locally.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadCompleted',\n    listenerFunc: (event: DownloadCompletedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when native download handling fails.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadFailed',\n    listenerFunc: (event: DownloadFailedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered whenever a page opens a popup/new window.\n   * Use the returned popup id with `executeScript`, `postMessage`, `show`, `hide`, and `close`.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'popupWindowOpened',\n    listenerFunc: (event: PopupWindowEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for proxied requests delegated by the native runtime.\n   * Prefer `addProxyHandler()` instead of calling this directly.\n   *\n   * @since 8.6.0\n   */\n  addListener(eventName: 'proxyRequest', listenerFunc: (event: ProxyRequest) => void): Promise<PluginListenerHandle>;\n  /**\n   * Listen for JavaScript console output emitted by the managed page.\n   * Enable this with `captureConsoleLogs: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'consoleMessage',\n    listenerFunc: (event: ConsoleMessageEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Internal method used by `addProxyHandler()` to send a proxy decision back to native.\n   * Forward the original `phase` when replying to a manual `proxyRequest` listener.\n   *\n   * @since 8.6.0\n   */\n  handleProxyRequest(options: {\n    requestId: string;\n    decision?: ProxyDecision | null;\n    response?: ProxyResponse | null;\n    webviewId?: string;\n    phase?: 'outbound' | 'inbound';\n  }): Promise<void>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Reload the current web page.\n   *\n   * @since 1.0.0\n   */\n  reload(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Update the dimensions of the webview.\n   * Allows changing the size and position of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @param options Dimension options (width, height, x, y)\n   * @returns Promise that resolves when dimensions are updated\n   */\n  updateDimensions(options: DimensionOptions & { id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe top margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeTopMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe bottom margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeBottomMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Opens a secured window for OAuth2 authentication.\n   * For web, you should have the code in the redirected page to use a broadcast channel to send the redirected url to the app\n   * Something like:\n   * ```html\n   * <html>\n   * <head></head>\n   * <body>\n   * <script>\n   *   const searchParams = new URLSearchParams(location.search)\n   *   if (searchParams.has(\"code\")) {\n   *     new BroadcastChannel(\"my-channel-name\").postMessage(location.href);\n   *     window.close();\n   *   }\n   * </script>\n   * </body>\n   * </html>\n   * ```\n   * For mobile, you should have a redirect uri that opens the app, something like: `myapp://oauth_callback/`\n   * And make sure to register it in the app's info.plist:\n   * ```xml\n   * <key>CFBundleURLTypes</key>\n   * <array>\n   *    <dict>\n   *       <key>CFBundleURLSchemes</key>\n   *       <array>\n   *          <string>myapp</string>\n   *       </array>\n   *    </dict>\n   * </array>\n   * ```\n   * And in the AndroidManifest.xml file:\n   * ```xml\n   * <activity>\n   *    <intent-filter>\n   *       <action android:name=\"android.intent.action.VIEW\" />\n   *       <category android:name=\"android.intent.category.DEFAULT\" />\n   *       <category android:name=\"android.intent.category.BROWSABLE\" />\n   *       <data android:host=\"oauth_callback\" android:scheme=\"myapp\" />\n   *    </intent-filter>\n   * </activity>\n   * ```\n   * @param options - the options for the openSecureWindow call\n   */\n  openSecureWindow(options: OpenSecureWindowOptions): Promise<OpenSecureWindowResponse>;\n}\n\n/**\n * JavaScript APIs available in the InAppBrowser WebView.\n *\n * These APIs are automatically injected into all webpages loaded in the InAppBrowser WebView.\n *\n * @example\n * // Closing the webview from JavaScript\n * window.mobileApp.close();\n *\n * // Sending a message from webview to the native app\n * window.mobileApp.postMessage({ key: \"value\" });\n *\n * @since 6.10.0\n */\nexport interface InAppBrowserWebViewAPIs {\n  /**\n   * mobileApp - Global object injected into the WebView providing communication with the native app\n   */\n  mobileApp: {\n    /**\n     * Close the WebView from JavaScript\n     *\n     * @example\n     * // Add a button to close the webview\n     * const closeButton = document.createElement(\"button\");\n     * closeButton.textContent = \"Close WebView\";\n     * closeButton.addEventListener(\"click\", () => {\n     *   window.mobileApp.close();\n     * });\n     * document.body.appendChild(closeButton);\n     *\n     * @since 6.10.0\n     */\n    close(): void;\n\n    /**\n     * Send a message from the WebView to the native app\n     * The native app can listen for these messages with the \"messageFromWebview\" event\n     *\n     * @param message Object to send to the native app\n     * @example\n     * // Send data to native app\n     * window.mobileApp.postMessage({\n     *   action: \"dataSubmitted\",\n     *   data: { username: \"test\", email: \"test@example.com\" }\n     * });\n     *\n     * @since 6.10.0\n     */\n    postMessage(message: Record<string, any>): void;\n\n    /**\n     * Hide the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    hide(): void;\n\n    /**\n     * Show the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    show(): void;\n\n    /**\n     * Capture the current WebView viewport as a PNG screenshot.\n     * Requires `allowScreenshotsFromWebPage` to be enabled when opening the webview.\n     *\n     * @since 8.4.0\n     */\n    takeScreenshot(): Promise<ScreenshotResult>;\n  };\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAmEA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AACD,MAAM,CAAN,IAAY,WAqBX;AArBD,WAAY,WAAW;IACrB;;;OAGG;IACH,oCAAqB,CAAA;IACrB;;;OAGG;IACH,kCAAmB,CAAA;IACnB;;;OAGG;IACH,wCAAyB,CAAA;IACzB;;;OAGG;IACH,8BAAe,CAAA;AACjB,CAAC,EArBW,WAAW,KAAX,WAAW,QAqBtB;AAED,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,mCAAe,CAAA;IACf;;OAEG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B;AAED,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACrB;;OAEG;IACH,8BAAe,CAAA;IACf;;OAEG;IACH,4BAAa,CAAA;AACf,CAAC,EATW,WAAW,KAAX,WAAW,QAStB","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface UrlEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when the url changes\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\n/**\n * Event emitted when the managed webview intercepts a non-standard custom scheme\n * and hands it to the operating system.\n *\n * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n *\n * @since 8.6.7\n */\nexport interface CustomSchemeInterceptedEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Intercepted URL.\n   */\n  url: string;\n  /**\n   * Whether the operating system accepted the URL handoff.\n   */\n  opened: boolean;\n}\nexport interface BtnEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when a button is clicked.\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\nexport interface ButtonNearDoneEvent {\n  /**\n   * Webview instance id.\n   *\n   * @since 8.6.36\n   */\n  id: string;\n}\n\nexport type UrlChangeListener = (state: UrlEvent) => void;\nexport type ConfirmBtnListener = (state: BtnEvent) => void;\nexport type ButtonNearListener = (state: ButtonNearDoneEvent) => void;\nexport type CustomSchemeInterceptedListener = (state: CustomSchemeInterceptedEvent) => void;\n\nexport type WebViewPointerInputEventType = 'click' | 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel';\nexport type WebViewInputEventType = WebViewPointerInputEventType | 'scroll';\n\nexport enum BackgroundColor {\n  WHITE = 'white',\n  BLACK = 'black',\n}\nexport enum ToolBarType {\n  /**\n   * Shows a simple toolbar with just a close button and share button\n   * @since 0.1.0\n   */\n  ACTIVITY = 'activity',\n  /**\n   * Shows a simple toolbar with just a close button\n   * @since 7.6.8\n   */\n  COMPACT = 'compact',\n  /**\n   * Shows a full navigation toolbar with back/forward buttons\n   * @since 0.1.0\n   */\n  NAVIGATION = 'navigation',\n  /**\n   * Shows no toolbar\n   * @since 0.1.0\n   */\n  BLANK = 'blank',\n}\n\nexport enum InvisibilityMode {\n  /**\n   * WebView is aware it is hidden (dimensions may be zero).\n   */\n  AWARE = 'AWARE',\n  /**\n   * WebView is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   */\n  FAKE_VISIBLE = 'FAKE_VISIBLE',\n}\n\nexport enum CloseAction {\n  /**\n   * The toolbar close button closes and destroys the webview.\n   */\n  CLOSE = 'close',\n  /**\n   * The toolbar close button hides the webview so it can be shown again.\n   */\n  HIDE = 'hide',\n}\n\nexport interface ToolbarTitleIconOptions {\n  ios?: {\n    iconType: 'sf-symbol' | 'asset';\n    icon: string;\n  };\n  android?: {\n    iconType: 'asset' | 'vector';\n    icon: string;\n    width?: number;\n    height?: number;\n  };\n}\n\nexport interface Headers {\n  [key: string]: string;\n}\n\nexport interface GetCookieOptions {\n  url: string;\n  includeHttpOnly?: boolean;\n}\n\nexport interface ClearCookieOptions {\n  /**\n   * Target webview id.\n   * When omitted, applies to all open webviews.\n   */\n  id?: string;\n  url: string;\n}\n\nexport interface Credentials {\n  username: string;\n  password: string;\n}\n\nexport interface LayerOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Makes the Capacitor host WebView transparent while this native webview is behind it.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n}\n\nexport interface BringToFrontOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Whether bringing the webview to the front is animated on iOS.\n   *\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface DispatchPointerInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: WebViewPointerInputEventType;\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n}\n\nexport interface DispatchScrollInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: 'scroll';\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n  /**\n   * Horizontal scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaX: number;\n  /**\n   * Vertical scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaY: number;\n}\n\nexport type DispatchInputEventOptions = DispatchPointerInputEventOptions | DispatchScrollInputEventOptions;\n\n/**\n * Represents an intercepted HTTP request from the in-app browser webview.\n *\n * Request and response bodies are base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequest {\n  requestId: string;\n  phase: 'outbound' | 'inbound';\n  url: string;\n  method: string;\n  headers: Record<string, string>;\n  body: string | null;\n  status?: number;\n  responseHeaders?: Record<string, string>;\n  responseBody?: string | null;\n  webviewId: string;\n}\n\n/**\n * Response payload returned to native for a proxied request.\n *\n * The body must be base64-encoded.\n *\n * @since 8.6.0\n */\nexport interface ProxyResponse {\n  body: string;\n  status: number;\n  headers: Record<string, string>;\n}\n\n/**\n * Request override returned to native for an outbound proxied request.\n *\n * The body must be base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequestOverride {\n  url: string;\n  method?: string;\n  headers?: Record<string, string>;\n  body?: string | null;\n}\n\n/**\n * Event emitted when a web page opens a popup/new window.\n *\n * @since 8.6.0\n */\nexport interface PopupWindowEvent {\n  /**\n   * Popup webview instance id.\n   */\n  id: string;\n  /**\n   * Parent webview instance id.\n   */\n  parentId?: string;\n  /**\n   * Requested popup URL when available.\n   */\n  url?: string;\n  /**\n   * Whether the popup was presented immediately.\n   */\n  visible: boolean;\n}\n\n/**\n * Event emitted when JavaScript running inside the managed webview writes to the console.\n *\n * Enable this with `captureConsoleLogs: true` when opening the webview.\n *\n * @since 8.6.0\n */\nexport interface ConsoleMessageEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Console method or normalized severity.\n   */\n  level: 'log' | 'info' | 'warn' | 'error' | 'debug' | 'assert' | string;\n  /**\n   * Joined string representation of the console arguments.\n   */\n  message: string;\n  /**\n   * Script URL or page URL when available.\n   */\n  source?: string;\n  /**\n   * 1-based line number when available.\n   */\n  line?: number;\n  /**\n   * 1-based column number when available.\n   */\n  column?: number;\n  /**\n   * Optional subtype for runtime-originated errors on supported platforms.\n   */\n  kind?: string;\n}\n\n/**\n * Native handling mode used after a managed download finishes.\n *\n * @since 8.6.0\n */\nexport type DownloadHandledBy = 'inAppBrowser' | 'systemPreview' | 'external';\n\n/**\n * Event emitted after a managed download is saved locally.\n *\n * @since 8.6.0\n */\nexport interface DownloadCompletedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Saved filename.\n   */\n  fileName: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Absolute native filesystem path to the saved file.\n   */\n  path: string;\n  /**\n   * `file://` URL pointing at the saved file.\n   */\n  localUrl: string;\n  /**\n   * How native handled the downloaded file after saving it.\n   */\n  handledBy: DownloadHandledBy;\n}\n\n/**\n * Event emitted when managed download handling fails.\n *\n * @since 8.6.0\n */\nexport interface DownloadFailedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Intended filename when known.\n   */\n  fileName?: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Native error message.\n   */\n  error: string;\n}\n\n/**\n * Decision returned to native when handling a proxied request.\n *\n * @since 8.6.0\n */\nexport interface ProxyDecision {\n  request?: ProxyRequestOverride | null;\n  response?: ProxyResponse | null;\n  cancel?: boolean;\n}\n\n/**\n * Native-first proxy rule used on Android and iOS.\n *\n * Any regex property that is omitted is treated as a wildcard.\n *\n * @since 8.6.0\n */\nexport interface NativeProxyRule {\n  id?: string;\n  urlRegex?: string;\n  methodRegex?: string;\n  headerRegex?: string;\n  bodyRegex?: string;\n  statusRegex?: string;\n  responseHeaderRegex?: string;\n  responseBodyRegex?: string;\n  mainFrameOnly?: boolean;\n  action: 'continue' | 'cancel' | 'delegateToJs';\n}\n\nexport type ProxyHandlerResult = Response | ProxyResponse | ProxyRequestOverride | ProxyDecision | null;\n\n/**\n * JavaScript callback used to handle proxied requests.\n *\n * Return a `Response`, `ProxyResponse`, `ProxyRequestOverride`, `ProxyDecision`,\n * or `null` to let native continue unchanged.\n *\n * @since 8.6.0\n */\nexport type ProxyHandler = (request: ProxyRequest) => ProxyHandlerResult | Promise<ProxyHandlerResult>;\n\nexport interface OpenOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   */\n  url: string;\n  /**\n   * if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * @since 0.1.0\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * if true the deeplink will not be opened, if false the deeplink will be opened when clicked on the link\n   * @since 0.1.0\n   */\n  preventDeeplink?: boolean;\n\n  // --- Chrome Custom Tab customization (Android only, ignored on iOS) ---\n\n  /**\n   * Toolbar background color in hex format (e.g., \"#1A1A2E\").\n   * Applied to both light and dark color schemes.\n   * Also sets the navigation bar color to match.\n   * **Android only** — ignored on iOS.\n   * @since 8.2.0\n   */\n  toolbarColor?: string;\n\n  /**\n   * Whether the URL bar should auto-hide when the user scrolls down.\n   * The bar reappears on any upward scroll.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  urlBarHidingEnabled?: boolean;\n\n  /**\n   * Show the page's HTML <title> in the toolbar instead of the raw URL.\n   * The true URL is still visible when the user taps the title area.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showTitle?: boolean;\n\n  /**\n   * Replace the default \"X\" close icon with a back arrow.\n   * Makes the Custom Tab feel like a native navigation push rather than a modal overlay.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showArrow?: boolean;\n\n  /**\n   * Remove the share action from the overflow menu.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableShare?: boolean;\n\n  /**\n   * Hide the bookmark star icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableBookmark?: boolean;\n\n  /**\n   * Hide the download icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableDownload?: boolean;\n}\n\nexport interface OpenSecureWindowOptions {\n  /**\n   * The endpoint to open\n   */\n  authEndpoint: string;\n  /**\n   * The redirect URI to use for the openSecureWindow call.\n   * This will be checked to make sure it matches the redirect URI after the window finishes the redirection.\n   */\n  redirectUri: string;\n  /**\n   * The name of the broadcast channel to listen to, relevant only for web\n   */\n  broadcastChannelName?: string;\n  /**\n   * If true, the browser session will be ephemeral (no cookies or browsing data are shared with the system browser).\n   * On iOS, this sets `prefersEphemeralWebBrowserSession = true` on `ASWebAuthenticationSession`.\n   * On Android, this enables Custom Tabs ephemeral browsing via `setEphemeralBrowsingEnabled(true)`.\n   * @default false\n   * @since 6.6.0\n   */\n  prefersEphemeralWebBrowserSession?: boolean;\n}\n\nexport interface OpenSecureWindowResponse {\n  /**\n   * The result of the openSecureWindow call\n   */\n  redirectedUri: string;\n}\n\nexport interface DisclaimerOptions {\n  /**\n   * Title of the disclaimer dialog\n   * @default \"Title\"\n   */\n  title: string;\n  /**\n   * Message shown in the disclaimer dialog\n   * @default \"Message\"\n   */\n  message: string;\n  /**\n   * Text for the confirm button\n   * @default \"Confirm\"\n   */\n  confirmBtn: string;\n  /**\n   * Text for the cancel button\n   * @default \"Cancel\"\n   */\n  cancelBtn: string;\n}\n\nexport interface ScreenshotResult {\n  /**\n   * Image format used for the screenshot.\n   */\n  format: 'png';\n  /**\n   * MIME type of the generated screenshot.\n   */\n  mimeType: 'image/png';\n  /**\n   * Base64-encoded screenshot payload without the data URL prefix.\n   */\n  base64: string;\n  /**\n   * Data URL for direct use in HTML img tags or uploads.\n   */\n  dataUrl: string;\n  /**\n   * Screenshot width in pixels.\n   */\n  width: number;\n  /**\n   * Screenshot height in pixels.\n   */\n  height: number;\n}\n\nexport interface HideEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * URL active when the webview was hidden.\n   */\n  url: string;\n  /**\n   * Screenshot captured immediately before the toolbar close button hides the webview.\n   * Present only when `screenshotOnHide` is enabled and capture succeeds.\n   */\n  screenshot?: ScreenshotResult;\n}\n\nexport type HideListener = (state: HideEvent) => void;\n\nexport interface CloseWebviewOptions {\n  /**\n   * Target webview id to close. If omitted, closes the active webview.\n   */\n  id?: string;\n  /**\n   * Whether the webview closing is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface OpenWebViewOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   * @example \"https://capgo.app\"\n   */\n  url: string;\n  /**\n   * Headers to send with the request.\n   * @since 0.1.0\n   * @example\n   * headers: {\n   *   \"Custom-Header\": \"test-value\",\n   *   \"Authorization\": \"Bearer test-token\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  headers?: Headers;\n  /**\n   * Credentials to send with the request and all subsequent requests for the same host.\n   * @since 6.1.0\n   * @example\n   * credentials: {\n   *   username: \"test-user\",\n   *   password: \"test-pass\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  credentials?: Credentials;\n  /**\n   * HTTP method to use for the initial request.\n   *\n   * **Optional parameter - defaults to GET if not specified.**\n   * Existing code that doesn't provide this parameter will continue to work unchanged with standard GET requests.\n   *\n   * When specified with 'POST', 'PUT', or 'PATCH' methods that support a body,\n   * you can also provide a `body` parameter with the request payload.\n   *\n   * **Platform Notes:**\n   * - iOS: Full support for all HTTP methods with headers\n   * - Android: Custom headers may not be sent with POST/PUT/PATCH requests due to WebView limitations\n   *\n   * @since 8.2.0\n   * @default \"GET\"\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ token: \"auth-token\", data: \"value\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | string;\n  /**\n   * HTTP body to send with the request when using POST, PUT, or other methods that support a body.\n   * Should be a string (use JSON.stringify for JSON data).\n   *\n   * **Optional parameter - only used when `method` is specified and supports a request body.**\n   * Omitting this parameter (or using GET method) results in standard behavior without a request body.\n   *\n   * @since 8.2.0\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ username: \"user\", password: \"pass\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  body?: string;\n  /**\n   * materialPicker: if true, uses Material Design theme for date and time pickers on Android.\n   * This improves the appearance of HTML date inputs to use modern Material Design UI instead of the old style pickers.\n   * @since 7.4.1\n   * @default false\n   * @example\n   * materialPicker: true\n   * Test URL: https://show-picker.glitch.me/demo.html\n   */\n  materialPicker?: boolean;\n  /**\n   * JavaScript Interface:\n   * The webview automatically injects a JavaScript interface providing:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage(obj)`: Sends a message to the app (listen via \"messageFromWebview\" event)\n   * - `window.mobileApp.hide()` / `window.mobileApp.show()` when allowWebViewJsVisibilityControl is true in CapacitorConfig\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * @example\n   * // In your webpage loaded in the webview:\n   * document.getElementById(\"closeBtn\").addEventListener(\"click\", () => {\n   *   window.mobileApp.close();\n   * });\n   *\n   * // Send data to the app\n   * window.mobileApp.postMessage({ action: \"login\", data: { user: \"test\" }});\n   *\n   * @since 6.10.0\n   */\n  jsInterface?: never; // This property doesn't exist, it's just for documentation\n  /**\n   * Allows page JavaScript to call `window.mobileApp.takeScreenshot()`.\n   * Disabled by default so only the host app can trigger native screenshots through the plugin API.\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  allowScreenshotsFromWebPage?: boolean;\n  /**\n   * Emits `consoleMessage` events for JavaScript `console.*` output coming from the managed page.\n   * Useful when the webview stays hidden and you still need page-level diagnostics.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  captureConsoleLogs?: boolean;\n  /**\n   * Controls whether the webview should persist website data such as cache, cookies, local storage,\n   * IndexedDB, and session data.\n   *\n   * When false, iOS uses a non-persistent `WKWebsiteDataStore`. Android disables per-view cache and\n   * DOM/database storage where the system WebView supports it. Android cookies use the shared\n   * WebView cookie store, so call `clearAllBrowsingData()` to remove cookies and other global data.\n   *\n   * @default true\n   * @since 8.6.36\n   */\n  persistWebViewData?: boolean;\n  /**\n   * Controls Android TLS client certificate prompts during HTTPS handshakes.\n   * Use `prompt` to show the system certificate picker; omit or use `none` to cancel silently (default).\n   *\n   * @default \"none\"\n   * @since 8.7.5\n   */\n  clientCertificate?: 'none' | 'prompt';\n  /**\n   * @deprecated Use `clientCertificate: \"prompt\"` instead.\n   */\n  clientCertificatePrompt?: boolean;\n  /**\n   * Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge.\n   *\n   * When enabled:\n   * - Standard attachment responses are written to a temporary file.\n   * - `blob:` downloads are also captured when the platform supports them.\n   * - Previewable files reopen inside the in-app browser when possible.\n   * - Other files are handed off to the native preview or viewer flow.\n   * - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  handleDownloads?: boolean;\n  /**\n   * Share options for the webview. When provided, shows a disclaimer dialog before sharing content.\n   * This is useful for:\n   * - Warning users about sharing sensitive information\n   * - Getting user consent before sharing\n   * - Explaining what will be shared\n   * - Complying with privacy regulations\n   *\n   * Note: shareSubject is required when using shareDisclaimer\n   * @since 0.1.0\n   * @example\n   * shareDisclaimer: {\n   *   title: \"Disclaimer\",\n   *   message: \"This is a test disclaimer\",\n   *   confirmBtn: \"Accept\",\n   *   cancelBtn: \"Decline\"\n   * }\n   * Test URL: https://capgo.app\n   */\n  shareDisclaimer?: DisclaimerOptions;\n  /**\n   * Toolbar type determines the appearance and behavior of the browser's toolbar\n   * - \"activity\": Shows a simple toolbar with just a close button and share button\n   * - \"navigation\": Shows a full navigation toolbar with back/forward buttons\n   * - \"blank\": Shows no toolbar\n   * - \"\": Default toolbar with close button\n   * @since 0.1.0\n   * @default ToolBarType.DEFAULT\n   * @example\n   * toolbarType: ToolBarType.ACTIVITY,\n   * title: \"Activity Toolbar Test\"\n   * Test URL: https://capgo.app\n   */\n  toolbarType?: ToolBarType;\n  /**\n   * Subject text for sharing. Required when using shareDisclaimer.\n   * This text will be used as the subject line when sharing content.\n   * @since 0.1.0\n   * @example \"Share this page\"\n   */\n  shareSubject?: string;\n  /**\n   * Title of the browser\n   * @since 0.1.0\n   * @default \"New Window\"\n   * @example \"Camera Test\"\n   */\n  title?: string;\n  /**\n   * Native toolbar title font family.\n   * On iOS, use the registered font family name. On Android, the plugin first tries a res/font resource name,\n   * then falls back to a system font family name.\n   *\n   * @since 8.7.7\n   * @example \"Inter\"\n   */\n  titleFontFamily?: string;\n  /**\n   * Native toolbar title icon displayed before the title text.\n   *\n   * For Android:\n   * - iconType can be \"asset\" for a bundled SVG asset or \"vector\" for a drawable resource\n   * - icon path should be in the public folder for assets (e.g. \"brand.svg\")\n   * - width and height are optional and default to 24dp\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name or bundled web asset path\n   *\n   * @since 8.7.7\n   * @example\n   * titleIcon: {\n   *   ios: { iconType: \"sf-symbol\", icon: \"lock.fill\" },\n   *   android: { iconType: \"vector\", icon: \"ic_lock\", width: 20, height: 20 }\n   * }\n   */\n  titleIcon?: ToolbarTitleIconOptions;\n  /**\n   * Background color of the browser\n   * @since 0.1.0\n   * @default BackgroundColor.BLACK\n   */\n  backgroundColor?: BackgroundColor;\n  /**\n   * If true, enables native navigation gestures within the webview.\n   * - Android: Native back button navigates within webview history\n   * - iOS: Enables swipe left/right gestures for back/forward navigation\n   * @default false (Android), true (iOS - enabled by default)\n   * @example\n   * activeNativeNavigationForWebview: true,\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  activeNativeNavigationForWebview?: boolean;\n\n  /**\n   * Enable pull-to-refresh (overscroll from top) to reload the current page.\n   * - iOS: Uses UIRefreshControl on the WebView scroll view\n   * - Android: Uses SwipeRefreshLayout around the WebView\n   *\n   * On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,\n   * the reload gesture will not work.\n   *\n   * @since 8.10.8\n   * @default false\n   * @example\n   * enableReloadGesture: true\n   */\n  enableReloadGesture?: boolean;\n  /**\n   * Disable the possibility to go back on native application,\n   * useful to force user to stay on the webview, Android only\n   * @default false\n   * @example\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  disableGoBackOnNativeApplication?: boolean;\n  /**\n   * Open url in a new window fullscreen\n   * isPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * Promise timing: on Android, `openWebView()` resolves with the webview id when the webview is ready to be controlled\n   * (immediately for hidden/immediate presentation, after the first page load when `isPresentAfterPageLoad` is `true`).\n   * On iOS, the promise resolves with the id as soon as the native webview is created, even if presentation is deferred.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * isPresentAfterPageLoad: true,\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * Whether the website in the webview is inspectable or not, ios only\n   * @default false\n   */\n  isInspectable?: boolean;\n  /**\n   * Whether the webview opening is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n  /**\n   * Shows a reload button that reloads the web page\n   * @since 1.0.15\n   * @default false\n   * @example\n   * showReloadButton: true\n   * Test URL: https://capgo.app\n   */\n  showReloadButton?: boolean;\n  /**\n   * closeAction controls what happens when the native toolbar close button is pressed.\n   * This does not change the behavior of close(), JavaScript window.mobileApp.close(), or native back navigation.\n   *\n   * @default CloseAction.CLOSE\n   * @since 8.7.7\n   * @example\n   * closeAction: CloseAction.HIDE\n   */\n  closeAction?: CloseAction;\n  /**\n   * Captures the visible webview and includes it as `screenshot` in `hideEvent`\n   * before the toolbar close button hides the webview.\n   *\n   * Only applies when `closeAction` is `CloseAction.HIDE`.\n   *\n   * On iOS, capture uses `WKWebView.takeSnapshot`. When testing through Apple's\n   * iPhone Mirroring app with the physical device locked, the snapshot can succeed\n   * with the correct dimensions but a fully transparent PNG. Capture works as\n   * expected on a normal unlocked device. This appears to be an Apple mirroring\n   * limitation rather than a plugin bug.\n   *\n   * @default false\n   * @since 8.7.10\n   */\n  screenshotOnHide?: boolean;\n  /**\n   * CloseModal: if true a confirm will be displayed when user clicks on close button, if false the browser will be closed immediately.\n   * @since 1.1.0\n   * @default false\n   * @example\n   * closeModal: true,\n   * closeModalTitle: \"Close Window\",\n   * closeModalDescription: \"Are you sure you want to close?\",\n   * closeModalOk: \"Yes, close\",\n   * closeModalCancel: \"No, stay\"\n   * Test URL: https://capgo.app\n   */\n  closeModal?: boolean;\n  /**\n   * CloseModalTitle: title of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalTitle?: string;\n  /**\n   * CloseModalDescription: description of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Are you sure you want to close this window?\"\n   */\n  closeModalDescription?: string;\n  /**\n   * CloseModalOk: text of the confirm button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalOk?: string;\n  /**\n   * CloseModalCancel: text of the cancel button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Cancel\"\n   */\n  closeModalCancel?: string;\n  /**\n   * closeModalURLPattern: a regex pattern to match against the current URL when the close button is pressed.\n   * When provided along with closeModal: true, the close confirmation modal is only shown if the current URL matches this pattern.\n   * If the current URL does not match, the browser closes immediately without showing the modal.\n   * Requires closeModal to be true.\n   * @since 7.2.0\n   * @example\n   * closeModal: true,\n   * closeModalURLPattern: \".*checkout.*\"\n   */\n  closeModalURLPattern?: string;\n  /**\n   * visibleTitle: if true the website title would be shown else shown empty\n   * @since 1.2.5\n   * @default true\n   */\n  visibleTitle?: boolean;\n  /**\n   * toolbarColor: color of the toolbar in hex format\n   * @since 1.2.5\n   * @default \"#ffffff\"\n   * @example\n   * toolbarColor: \"#FF5733\"\n   * Test URL: https://capgo.app\n   */\n  toolbarColor?: string;\n  /**\n   * toolbarTextColor: color of the buttons and title in the toolbar in hex format\n   * When set, it overrides the automatic light/dark mode detection for text color\n   * @since 6.10.0\n   * @default calculated based on toolbarColor brightness\n   * @example\n   * toolbarTextColor: \"#FFFFFF\"\n   * Test URL: https://capgo.app\n   */\n  toolbarTextColor?: string;\n  /**\n   * showArrow: if true an arrow would be shown instead of cross for closing the window\n   * @since 1.2.5\n   * @default false\n   * @example\n   * showArrow: true\n   * Test URL: https://capgo.app\n   */\n  showArrow?: boolean;\n  /**\n   * ignoreUntrustedSSLError: if true, the webview will ignore untrusted SSL errors allowing the user to view the website.\n   * @since 6.1.0\n   * @default false\n   */\n  ignoreUntrustedSSLError?: boolean;\n  /**\n   * preShowScript: if isPresentAfterPageLoad is true and this variable is set the plugin will inject a script before showing the browser.\n   * This script will be run in an async context. The plugin will wait for the script to finish (max 10 seconds)\n   * @since 6.6.0\n   * @example\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  preShowScript?: string;\n  /**\n   * preShowScriptInjectionTime: controls when the preShowScript is injected.\n   * - \"documentStart\": injects before any page JavaScript runs (good for polyfills like Firebase)\n   * - \"pageLoad\": injects after page load (default, original behavior)\n   * @since 7.26.0\n   * @default \"pageLoad\"\n   * @example\n   * preShowScriptInjectionTime: \"documentStart\"\n   */\n  preShowScriptInjectionTime?: 'documentStart' | 'pageLoad';\n  /**\n   * Proxy interception mode.\n   *\n   * - `true`: legacy blanket mode, delegates all HTTP/HTTPS requests to JavaScript.\n   * - `string`: Android-only regex mode kept for backward compatibility.\n   *\n   * Prefer `outboundProxyRules` and `inboundProxyRules` for native-first matching.\n   *\n   * @since 6.9.0\n   */\n  proxyRequests?: boolean | string;\n  /**\n   * Native-first outbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  outboundProxyRules?: NativeProxyRule[];\n  /**\n   * Native-first inbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  inboundProxyRules?: NativeProxyRule[];\n  /**\n   * buttonNearDone allows for a creation of a custom button near the done/close button.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * For Android:\n   * - iconType must be \"asset\"\n   * - icon path should be in the public folder (e.g. \"monkey.svg\")\n   * - width and height are optional, defaults to 48dp\n   * - button is positioned at the end of toolbar with 8dp margin\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name\n   * @since 6.7.0\n   * @example\n   * buttonNearDone: {\n   *   ios: {\n   *     iconType: \"sf-symbol\",\n   *     icon: \"star.fill\"\n   *   },\n   *   android: {\n   *     iconType: \"asset\",\n   *     icon: \"public/monkey.svg\",\n   *     width: 24,\n   *     height: 24\n   *   }\n   * }\n   * Test URL: https://capgo.app\n   */\n  buttonNearDone?: {\n    ios: {\n      iconType: 'sf-symbol' | 'asset';\n      icon: string;\n    };\n    android: {\n      iconType: 'asset' | 'vector';\n      icon: string;\n      width?: number;\n      height?: number;\n    };\n  };\n  /**\n   * Shows a native screenshot button near the done/close button.\n   * The button is hidden by default and captures the current viewport when tapped.\n   * This option uses the same toolbar slot as `buttonNearDone` and is therefore incompatible with it.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  showScreenshotButton?: boolean;\n  /**\n   * textZoom: sets the text zoom of the page in percent.\n   * Allows users to increase or decrease the text size for better readability.\n   * @since 7.6.0\n   * @default 100\n   * @example\n   * textZoom: 120\n   * Test URL: https://capgo.app\n   */\n  textZoom?: number;\n  /**\n   * enableZoom: enables pinch-to-zoom gestures in the Android WebView.\n   * When true, built-in zoom controls are enabled and the zoom buttons are hidden.\n   * **Android only** — ignored on iOS where zoom is enabled by default.\n   * @since 8.5.0\n   * @default false\n   * @example\n   * enableZoom: true\n   */\n  enableZoom?: boolean;\n  /**\n   * If true, deeplinks and external app hand-off are blocked and stay in the webview.\n   * If false (default), custom schemes such as `tel:`, `mailto:`, and `sms:` open natively.\n   * On iOS, listing a custom scheme under `LSApplicationQueriesSchemes` is only required when\n   * you rely on `canOpenURL` for that scheme (for example `instagram://`). It is not required\n   * for HTTPS `authorizedAppLinks`, and `mailto`/`tel`/`sms` open without that Info.plist entry.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * preventDeeplink: true\n   * Test URL: https://aasa-tester.capgo.app/\n   */\n  preventDeeplink?: boolean;\n\n  /**\n   * When true, HTTP and HTTPS links opened from `target=\"_blank\"` anchors stay in the current webview instead of spawning a popup or opening in the system browser.\n   * By default, blank-target HTTP(S) links stay inside the plugin as managed popups that share cookies with the opener; enabling this option keeps everything in the same tab.\n   * Custom schemes such as `tel:` and `mailto:` and authorized app links still prefer their native handlers unless `preventDeeplink` is enabled.\n   *\n   * @since 8.5.6\n   * @default false\n   * @example\n   * openBlankTargetInWebView: true\n   */\n  openBlankTargetInWebView?: boolean;\n\n  /**\n   * List of base URLs whose hosts are treated as authorized App Links (Android) and Universal Links (iOS).\n   *\n   * - On both platforms, only HTTP(S) links whose host matches any entry in this list\n   *   will attempt to leave the in-app browser for the native / system handler.\n   * - iOS tries a Universal Link first (`universalLinksOnly`), then falls back to a normal\n   *   system open (App Store, Safari, etc.). Only if both fail does the URL stay in-webview.\n   * - Android uses an `ACTION_VIEW` intent for matching hosts.\n   * - Matching is host-based (case-insensitive), ignoring the \"www.\" prefix.\n   * - HTTPS hosts do not need `LSApplicationQueriesSchemes`; that Info.plist key is for\n   *   custom schemes like `instagram://`, not `https://instagram.com`.\n   * - When `preventDeeplink` is enabled, all external handling is blocked regardless of this list.\n   *\n   * @example\n   * ```ts\n   * [\"https://example.com\", \"https://instagram.com\", \"https://apps.apple.com\"]\n   * ```\n   *\n   * @since 7.12.0\n   * @default []\n   */\n  authorizedAppLinks?: string[];\n\n  /**\n   * If true, the webView will not take the full height and will have a 20px margin at the bottom.\n   * This creates a safe margin area outside the browser view.\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enabledSafeBottomMargin: true\n   */\n  enabledSafeBottomMargin?: boolean;\n\n  /**\n   * If false, the webView will extend behind the status bar for true full-screen immersive content.\n   * When true (default), respects the safe area at the top of the screen.\n   * Works independently of toolbarType - use for full-screen video players, games, or immersive web apps.\n   * @since 8.2.0\n   * @default true\n   * @example\n   * enabledSafeTopMargin: false  // Full screen, extends behind status bar\n   */\n  enabledSafeTopMargin?: boolean;\n\n  /**\n   * When true, applies the system status bar inset as the WebView top margin on Android.\n   * Keeps the legacy 0px margin by default for apps that handle padding themselves.\n   * @default false\n   * @example\n   * useTopInset: true\n   */\n  useTopInset?: boolean;\n\n  /**\n   * enableGooglePaySupport: if true, enables support for Google Pay popups and Payment Request API.\n   * This fixes OR_BIBED_15 errors by allowing popup windows and configuring Cross-Origin-Opener-Policy.\n   * Only enable this if you need Google Pay functionality as it allows popup windows.\n   *\n   * When enabled:\n   * - Allows popup windows for Google Pay authentication\n   * - Sets proper CORS headers for Payment Request API\n   * - Enables multiple window support in WebView\n   * - Configures secure context for payment processing\n   *\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enableGooglePaySupport: true\n   * Test URL: https://developers.google.com/pay/api/web/guides/tutorial\n   */\n  enableGooglePaySupport?: boolean;\n\n  /**\n   * Opens popup windows created by the page in hidden mode.\n   * Hidden popup windows can still be controlled with `executeScript`, `postMessage`, `show`, and `close`.\n   * Listen to `popupWindowOpened` to capture the popup id, then call `show({ id })` only if you want to reveal it.\n   *\n   * @default false\n   * @since 8.6.0\n   * @example\n   * hiddenPopupWindow: true\n   */\n  hiddenPopupWindow?: boolean;\n\n  /**\n   * blockedHosts: List of host patterns that should be blocked from loading in the InAppBrowser's internal navigations.\n   * Any request inside WebView to a URL with a host matching any of these patterns will be blocked.\n   * Supports wildcard patterns like:\n   * - \"*.example.com\" to block all subdomains\n   * - \"www.example.*\" to block wildcard domain extensions\n   *\n   * @since 7.17.0\n   * @default []\n   * @example\n   * blockedHosts: [\"*.tracking.com\", \"ads.example.com\"]\n   */\n  blockedHosts?: string[];\n\n  /**\n   * Width of the webview in pixels.\n   * If not set, webview will be fullscreen width.\n   * @default undefined (fullscreen)\n   * @example\n   * width: 400\n   */\n  width?: number;\n\n  /**\n   * Height of the webview in pixels.\n   * If not set, webview will be fullscreen height.\n   * @default undefined (fullscreen)\n   * @example\n   * height: 600\n   */\n  height?: number;\n\n  /**\n   * X position of the webview in pixels from the left edge.\n   * Only effective when width is set.\n   * @default 0\n   * @example\n   * x: 50\n   */\n  x?: number;\n\n  /**\n   * Y position of the webview in pixels from the top edge.\n   * Only effective when height is set.\n   * @default 0\n   * @example\n   * y: 100\n   */\n  y?: number;\n\n  /**\n   * Places the native browser behind the Capacitor host WebView.\n   * Make the app background transparent to reveal it, or rely on `transparentBackground` to clear the host WebView.\n   *\n   * @default false\n   */\n  toBack?: boolean;\n\n  /**\n   * When `toBack` is true, makes the Capacitor host WebView transparent so the native browser can be seen behind Ionic content.\n   * Ignored when the browser is in front.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n\n  /**\n   * Disables the bounce (overscroll) effect on iOS WebView.\n   * When enabled, prevents the rubber band scrolling effect when users scroll beyond content boundaries.\n   * This is useful for:\n   * - Creating a more native, app-like experience\n   * - Preventing accidental overscroll states\n   * - Avoiding issues when keyboard opens/closes\n   *\n   * Note: This option only affects iOS. Android does not have this bounce effect by default.\n   *\n   * @since 8.0.2\n   * @default false\n   * @example\n   * disableOverscroll: true\n   */\n  disableOverscroll?: boolean;\n\n  /**\n   * Opens the webview in hidden mode (not visible to user but fully functional).\n   * When hidden, the webview loads and executes JavaScript but is not displayed.\n   * All control methods (executeScript, postMessage, setUrl, etc.) work while hidden.\n   * Use close() to clean up the hidden webview when done.\n   *\n   * @since 8.0.7\n   * @default false\n   * @example\n   * hidden: true\n   */\n  hidden?: boolean;\n\n  /**\n   * Controls how a hidden webview reports its visibility and size.\n   * - AWARE: webview is aware it's hidden (dimensions may be zero).\n   * - FAKE_VISIBLE: webview is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   *\n   * @default InvisibilityMode.AWARE\n   * @example\n   * invisibilityMode: InvisibilityMode.FAKE_VISIBLE\n   */\n  invisibilityMode?: InvisibilityMode;\n}\n\nexport interface DimensionOptions {\n  /**\n   * Width of the webview in pixels\n   */\n  width?: number;\n  /**\n   * Height of the webview in pixels\n   */\n  height?: number;\n  /**\n   * X position from the left edge in pixels\n   */\n  x?: number;\n  /**\n   * Y position from the top edge in pixels\n   */\n  y?: number;\n}\n\nexport interface InAppBrowserPlugin {\n  /**\n   * Navigates back in the WebView's history if possible\n   *\n   * @since 7.21.0\n   * @returns Promise that resolves with true if navigation was possible, false otherwise\n   */\n  goBack(options?: { id?: string }): Promise<{ canGoBack: boolean }>;\n\n  /**\n   * Open url in a new window fullscreen, on android it use chrome custom tabs, on ios it use SFSafariViewController\n   *\n   * @since 0.1.0\n   */\n  open(options: OpenOptions): Promise<any>;\n\n  /**\n   * Clear cookies of url\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 0.5.0\n   */\n  clearCookies(options: ClearCookieOptions): Promise<any>;\n  /**\n   * Clear all cookies\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearAllCookies(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear cache\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearCache(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear all browsing data from the default store and any opened managed webviews.\n   *\n   * This removes cookies, disk cache, memory cache, local storage, session storage, IndexedDB,\n   * WebSQL where supported, form data, and HTTP auth data where the platform exposes it.\n   *\n   * @since 8.6.36\n   */\n  clearAllBrowsingData(): Promise<any>;\n\n  /**\n   * Get cookies for a specific URL.\n   * @param options The options, including the URL to get cookies for.\n   * @returns A promise that resolves with the cookies.\n   */\n  getCookies(options: GetCookieOptions): Promise<Record<string, string>>;\n  /**\n   * Close the webview.\n   * When `id` is omitted, closes the active webview.\n   */\n  close(options?: CloseWebviewOptions): Promise<any>;\n  /**\n   * Hide the webview without closing it.\n   * Use show() to bring it back.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  hide(options?: { id?: string }): Promise<void>;\n  /**\n   * Show a previously hidden webview.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  show(options?: { id?: string }): Promise<void>;\n  /**\n   * Moves the native browser behind the Capacitor host WebView.\n   * Use `dispatchInputEvent()` to forward overlay gestures to the browser while it is behind the app UI.\n   */\n  sendToBack(options?: LayerOptions): Promise<void>;\n  /**\n   * Moves a browser that was behind the host WebView back to the front.\n   * On iOS, set `isAnimated` to `false` to skip the presentation animation.\n   * When `id` is omitted, targets the active webview.\n   */\n  bringToFront(options?: BringToFrontOptions): Promise<void>;\n  /**\n   * Dispatches a click, touch, or scroll event to a managed browser.\n   * Coordinates are relative to the browser viewport in CSS pixels.\n   */\n  dispatchInputEvent(options: DispatchInputEventOptions): Promise<void>;\n  /**\n   * Open url in a new webview with toolbars, and enhanced capabilities, like camera access, file access, listen events, inject javascript, bi directional communication, etc.\n   *\n   * JavaScript Interface:\n   * When you open a webview with this method, a JavaScript interface is automatically injected that provides:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage({detail: {message: \"myMessage\"}})`: Sends a message from the webview to the app, detail object is the data you want to send to the webview\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * Promise timing differs by platform when `isPresentAfterPageLoad` is used.\n   * Android resolves with `{ id }` after the dialog is ready to control, while iOS resolves with `{ id }` immediately after creating the native webview.\n   *\n   * @returns Promise that resolves with the created webview id.\n   * @since 0.1.0\n   */\n  openWebView(options: OpenWebViewOptions): Promise<{ id: string }>;\n  /**\n   * Injects JavaScript code into the InAppBrowser window.\n   * When `id` is omitted, executes in all open webviews.\n   */\n  executeScript(options: { code: string; id?: string }): Promise<void>;\n  /**\n   * Sends an event to the webview(inappbrowser). you can listen to this event in the inappbrowser JS with window.addEventListener(\"messageFromNative\", listenerFunc: (event: Record<string, any>) => void)\n   * detail is the data you want to send to the webview, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, so no functions or other non-JSON-serializable types are allowed.\n   * When `id` is omitted, broadcasts to all open webviews.\n   */\n  postMessage(options: { detail: Record<string, any>; id?: string }): Promise<void>;\n  /**\n   * Captures the current webview viewport as a PNG screenshot.\n   * When `id` is omitted, targets the active webview.\n   *\n   * On iOS, when testing through Apple's iPhone Mirroring app with the physical\n   * device locked, the snapshot can succeed with the correct dimensions but a\n   * fully transparent PNG. Capture works as expected on a normal unlocked device.\n   */\n  takeScreenshot(options?: { id?: string }): Promise<ScreenshotResult>;\n  /**\n   * Sets the URL of the webview.\n   * When `id` is omitted, targets the active webview.\n   */\n  setUrl(options: { url: string; id?: string }): Promise<any>;\n  /**\n   * Listen for url change, only for openWebView\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'urlChangeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for buttonNearDone clicks.\n   *\n   * The event payload contains the webview `id`.\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'buttonNearDoneClick', listenerFunc: ButtonNearListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for close click only for openWebView\n   *\n   * @since 0.4.0\n   */\n  addListener(eventName: 'closeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for webviews hidden by the toolbar close button when closeAction is CloseAction.HIDE.\n   *\n   * @since 8.7.7\n   */\n  addListener(eventName: 'hideEvent', listenerFunc: HideListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when user clicks on confirm button when disclaimer is required,\n   * works with openWebView shareDisclaimer and closeModal\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'confirmBtnClicked', listenerFunc: ConfirmBtnListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when event is sent from webview(inappbrowser), to send an event to the main app use window.mobileApp.postMessage({ \"detail\": { \"message\": \"myMessage\" } })\n   * detail is the data you want to send to the main app, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, no functions or other non-JSON-serializable types are allowed.\n   *\n   * This method is inject at runtime in the webview\n   */\n  addListener(\n    eventName: 'messageFromWebview',\n    listenerFunc: (event: { id?: string; detail?: Record<string, any>; rawMessage?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered whenever a screenshot is captured from the plugin API,\n   * the native screenshot button, or the injected JavaScript bridge.\n   */\n  addListener(\n    eventName: 'screenshotTaken',\n    listenerFunc: (event: ScreenshotResult & { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page is loaded\n   */\n  addListener(\n    eventName: 'browserPageLoaded',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when a main-frame page load starts (link navigation, reload, etc.).\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadStart',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered as a main-frame page load progresses.\n   * `progress` is a value from `0` to `1`.\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadProgress',\n    listenerFunc: (event: { id?: string; progress: number }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page load error\n   */\n  addListener(\n    eventName: 'pageLoadError',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when the webview intercepts a non-standard custom scheme\n   * and hands it to the operating system.\n   *\n   * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n   *\n   * @since 8.6.7\n   */\n  addListener(\n    eventName: 'customSchemeIntercepted',\n    listenerFunc: CustomSchemeInterceptedListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered after native download handling saves a file locally.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadCompleted',\n    listenerFunc: (event: DownloadCompletedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when native download handling fails.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadFailed',\n    listenerFunc: (event: DownloadFailedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered whenever a page opens a popup/new window.\n   * Use the returned popup id with `executeScript`, `postMessage`, `show`, `hide`, and `close`.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'popupWindowOpened',\n    listenerFunc: (event: PopupWindowEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for proxied requests delegated by the native runtime.\n   * Prefer `addProxyHandler()` instead of calling this directly.\n   *\n   * @since 8.6.0\n   */\n  addListener(eventName: 'proxyRequest', listenerFunc: (event: ProxyRequest) => void): Promise<PluginListenerHandle>;\n  /**\n   * Listen for JavaScript console output emitted by the managed page.\n   * Enable this with `captureConsoleLogs: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'consoleMessage',\n    listenerFunc: (event: ConsoleMessageEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Internal method used by `addProxyHandler()` to send a proxy decision back to native.\n   * Forward the original `phase` when replying to a manual `proxyRequest` listener.\n   *\n   * @since 8.6.0\n   */\n  handleProxyRequest(options: {\n    requestId: string;\n    decision?: ProxyDecision | null;\n    response?: ProxyResponse | null;\n    webviewId?: string;\n    phase?: 'outbound' | 'inbound';\n  }): Promise<void>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Reload the current web page.\n   *\n   * @since 1.0.0\n   */\n  reload(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Update the dimensions of the webview.\n   * Allows changing the size and position of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @param options Dimension options (width, height, x, y)\n   * @returns Promise that resolves when dimensions are updated\n   */\n  updateDimensions(options: DimensionOptions & { id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe top margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeTopMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe bottom margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeBottomMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Opens a secured window for OAuth2 authentication.\n   * For web, you should have the code in the redirected page to use a broadcast channel to send the redirected url to the app\n   * Something like:\n   * ```html\n   * <html>\n   * <head></head>\n   * <body>\n   * <script>\n   *   const searchParams = new URLSearchParams(location.search)\n   *   if (searchParams.has(\"code\")) {\n   *     new BroadcastChannel(\"my-channel-name\").postMessage(location.href);\n   *     window.close();\n   *   }\n   * </script>\n   * </body>\n   * </html>\n   * ```\n   * For mobile, you should have a redirect uri that opens the app, something like: `myapp://oauth_callback/`\n   * And make sure to register it in the app's info.plist:\n   * ```xml\n   * <key>CFBundleURLTypes</key>\n   * <array>\n   *    <dict>\n   *       <key>CFBundleURLSchemes</key>\n   *       <array>\n   *          <string>myapp</string>\n   *       </array>\n   *    </dict>\n   * </array>\n   * ```\n   * And in the AndroidManifest.xml file:\n   * ```xml\n   * <activity>\n   *    <intent-filter>\n   *       <action android:name=\"android.intent.action.VIEW\" />\n   *       <category android:name=\"android.intent.category.DEFAULT\" />\n   *       <category android:name=\"android.intent.category.BROWSABLE\" />\n   *       <data android:host=\"oauth_callback\" android:scheme=\"myapp\" />\n   *    </intent-filter>\n   * </activity>\n   * ```\n   * @param options - the options for the openSecureWindow call\n   */\n  openSecureWindow(options: OpenSecureWindowOptions): Promise<OpenSecureWindowResponse>;\n}\n\n/**\n * JavaScript APIs available in the InAppBrowser WebView.\n *\n * These APIs are automatically injected into all webpages loaded in the InAppBrowser WebView.\n *\n * @example\n * // Closing the webview from JavaScript\n * window.mobileApp.close();\n *\n * // Sending a message from webview to the native app\n * window.mobileApp.postMessage({ key: \"value\" });\n *\n * @since 6.10.0\n */\nexport interface InAppBrowserWebViewAPIs {\n  /**\n   * mobileApp - Global object injected into the WebView providing communication with the native app\n   */\n  mobileApp: {\n    /**\n     * Close the WebView from JavaScript\n     *\n     * @example\n     * // Add a button to close the webview\n     * const closeButton = document.createElement(\"button\");\n     * closeButton.textContent = \"Close WebView\";\n     * closeButton.addEventListener(\"click\", () => {\n     *   window.mobileApp.close();\n     * });\n     * document.body.appendChild(closeButton);\n     *\n     * @since 6.10.0\n     */\n    close(): void;\n\n    /**\n     * Send a message from the WebView to the native app\n     * The native app can listen for these messages with the \"messageFromWebview\" event\n     *\n     * @param message Object to send to the native app\n     * @example\n     * // Send data to native app\n     * window.mobileApp.postMessage({\n     *   action: \"dataSubmitted\",\n     *   data: { username: \"test\", email: \"test@example.com\" }\n     * });\n     *\n     * @since 6.10.0\n     */\n    postMessage(message: Record<string, any>): void;\n\n    /**\n     * Hide the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    hide(): void;\n\n    /**\n     * Show the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    show(): void;\n\n    /**\n     * Capture the current WebView viewport as a PNG screenshot.\n     * Requires `allowScreenshotsFromWebPage` to be enabled when opening the webview.\n     *\n     * @since 8.4.0\n     */\n    takeScreenshot(): Promise<ScreenshotResult>;\n  };\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/ios/Sources/InAppBrowserPlugin/InAppBrowserPlugin.swift

@@ -230,7 +230,7 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
         case aware = "AWARE"
         case fakeVisible = "FAKE_VISIBLE"
     }
-    private let pluginVersion: String = "8.11.0"
+    private let pluginVersion: String = "8.12.0"
     public let identifier = "CapgoInAppBrowserPlugin"
     public let jsName = "CapgoInAppBrowser"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -1249,6 +1249,7 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
 
         // Read disableOverscroll option (iOS only - controls WebView bounce effect)
         let disableOverscroll = call.getBool("disableOverscroll", false)
+        let enableReloadGesture = call.getBool("enableReloadGesture", false)
 
         let legacyProxyRequests = ProxySchemeRequestSupport.legacyProxyRequestsConfiguration(from: call.options["proxyRequests"])
         let outboundProxyRulesRaw = call.getArray("outboundProxyRules", [])
@@ -1319,6 +1320,8 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
                 authorizedAppLinks: authorizedAppLinks,
                 openBlankTargetInWebView: openBlankTargetInWebView
             )
+            webViewController.enableReloadGesture = enableReloadGesture
+            webViewController.disableOverscroll = disableOverscroll
             webViewController.initWebview(isInspectable: isInspectable)
             self.webViewController = webViewController
 
@@ -1348,8 +1351,6 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
                 webViewController.customY = CGFloat(yPos)
             }
 
-            // Set disableOverscroll option
-            webViewController.disableOverscroll = disableOverscroll
             webViewController.handleDownloads = handleDownloads
 
             // Set native navigation gestures before view loads

package/ios/Sources/InAppBrowserPlugin/WKWebViewController.swift

@@ -471,6 +471,7 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
     var blockedHosts: [String] = []
     var authorizedAppLinks: [String] = []
     var activeNativeNavigationForWebview: Bool = true
+    var enableReloadGesture: Bool = false
     var disableOverscroll: Bool = false
     var proxyRequests: Bool = false
     var proxySchemeHandler: ProxySchemeHandler?
@@ -2212,6 +2213,7 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
 
         // Disable bounce effect by setting scrollView.bounces to false when disableOverscroll is true
         webView.scrollView.bounces = !self.disableOverscroll
+        configureReloadGesture(for: webView)
         configureWebViewScrollViewSafeArea(webView)
 
         webView.addObserver(self, forKeyPath: estimatedProgressKeyPath, options: .new, context: nil)
@@ -2294,6 +2296,7 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
         configuration.userContentController = WKUserContentController()
         self.initialWebConfiguration = configuration
         self.persistWebViewData = parent.persistWebViewData
+        self.enableReloadGesture = parent.enableReloadGesture
         self.disableOverscroll = parent.disableOverscroll
         self.proxyRequests = parent.proxyRequests
         self.proxySchemeHandler = proxySchemeHandler
@@ -2558,6 +2561,31 @@ public extension WKWebViewController {
         self.webView?.allowsBackForwardNavigationGestures = self.activeNativeNavigationForWebview
     }
 
+    private func configureReloadGesture(for webView: WKWebView) {
+        if let existing = webView.scrollView.refreshControl {
+            existing.endRefreshing()
+            existing.removeTarget(nil, action: nil, for: .allEvents)
+            webView.scrollView.refreshControl = nil
+        }
+
+        guard enableReloadGesture, !disableOverscroll else {
+            return
+        }
+
+        webView.scrollView.alwaysBounceVertical = true
+        let refreshControl = UIRefreshControl()
+        refreshControl.addTarget(self, action: #selector(handleReloadGesture(_:)), for: .valueChanged)
+        webView.scrollView.refreshControl = refreshControl
+    }
+
+    @objc private func handleReloadGesture(_ sender: UIRefreshControl) {
+        reload()
+    }
+
+    private func stopReloadGesture() {
+        webView?.scrollView.refreshControl?.endRefreshing()
+    }
+
     func cleanupWebView() {
         guard let webView = self.webView else { return }
         webView.stopLoading()
@@ -3508,6 +3536,7 @@ extension WKWebViewController: WKNavigationDelegate {
         lastInjectedSafeAreaInsets = nil
         syncWebViewSafeAreaLayout()
         emit("browserPageLoaded")
+        stopReloadGesture()
     }
 
     public func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
@@ -3517,6 +3546,7 @@ extension WKWebViewController: WKNavigationDelegate {
             self.url = url
             delegate?.webViewController?(self, didFail: url, withError: error)
         }
+        stopReloadGesture()
         emit("pageLoadError")
     }
 
@@ -3527,6 +3557,7 @@ extension WKWebViewController: WKNavigationDelegate {
             self.url = url
             delegate?.webViewController?(self, didFail: url, withError: error)
         }
+        stopReloadGesture()
         emit("pageLoadError")
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-inappbrowser",
-  "version": "8.11.0",
+  "version": "8.12.0",
   "description": "Capacitor plugin in app browser",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",