@capgo/inappbrowser 8.2.0 → 8.3.0-alpha.1

package/ios/Sources/InAppBrowserPlugin/WKWebView+SchemeHandling.swift

@@ -0,0 +1,53 @@
+import Foundation
+import ObjectiveC
+import WebKit
+
+/// Enables registering a `WKURLSchemeHandler` for built-in schemes like `http` and `https`.
+///
+/// Apple's public `setURLSchemeHandler(_:forURLScheme:)` API throws for http/https because
+/// `WKWebView.handlesURLScheme(_:)` returns `true` for them. This extension swizzles that
+/// class method to return `false` for specified schemes, allowing the public API to work.
+///
+/// This is the industry-standard approach used by DuckDuckGo Browser, TON Proxy, and others.
+extension WKWebView {
+
+    /// Tracks which schemes have been overridden to allow custom handling
+    private static var _overriddenSchemes = Set<String>()
+
+    /// One-time swizzle — matches the pattern used by DuckDuckGo and ton-proxy-swift
+    private static let _swizzleOnce: Void = {
+        let original = class_getClassMethod(WKWebView.self, #selector(WKWebView.handlesURLScheme(_:)))
+        let swizzled = class_getClassMethod(
+            WKWebView.self,
+            #selector(WKWebView._capgo_handlesURLScheme(_:))
+        )
+
+        guard let original, let swizzled else {
+            print("[InAppBrowser][Proxy] WARNING: Could not get methods for swizzle")
+            return
+        }
+
+        method_exchangeImplementations(original, swizzled)
+    }()
+
+    /// Swizzled replacement — returns false for overridden schemes, calls original for all others
+    @objc(capgo_handlesURLScheme:)
+    private static func _capgo_handlesURLScheme(_ urlScheme: String) -> Bool {
+        if _overriddenSchemes.contains(urlScheme.lowercased()) {
+            return false
+        }
+        // After swizzle, this actually calls the ORIGINAL handlesURLScheme
+        return _capgo_handlesURLScheme(urlScheme)
+    }
+
+    /// Call this before `setURLSchemeHandler(_:forURLScheme:)` to allow registering for http/https.
+    static func enableCustomSchemeHandling(for schemes: [String]) {
+        // Add schemes BEFORE triggering the swizzle
+        for scheme in schemes {
+            _overriddenSchemes.insert(scheme.lowercased())
+        }
+
+        // Trigger the one-time swizzle
+        _ = _swizzleOnce
+    }
+}

package/ios/Sources/InAppBrowserPlugin/WKWebViewController.swift

@@ -101,11 +101,13 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
         self.initWebview(isInspectable: isInspectable)
     }
 
-    public init(url: URL, headers: [String: String], isInspectable: Bool, credentials: WKWebViewCredentials? = nil, preventDeeplink: Bool, blankNavigationTab: Bool, enabledSafeBottomMargin: Bool, enabledSafeTopMargin: Bool = true, blockedHosts: [String], authorizedAppLinks: [String]) {
+    public init(url: URL, headers: [String: String], isInspectable: Bool, credentials: WKWebViewCredentials? = nil, preventDeeplink: Bool, blankNavigationTab: Bool, enabledSafeBottomMargin: Bool, enabledSafeTopMargin: Bool = true, blockedHosts: [String], authorizedAppLinks: [String], proxyRequests: Bool = false, proxySchemeHandler: ProxySchemeHandler? = nil) {
         super.init(nibName: nil, bundle: nil)
         self.blankNavigationTab = blankNavigationTab
         self.enabledSafeBottomMargin = enabledSafeBottomMargin
         self.enabledSafeTopMargin = enabledSafeTopMargin
+        self.proxyRequests = proxyRequests
+        self.proxySchemeHandler = proxySchemeHandler
         self.source = .remote(url)
         self.credentials = credentials
         self.setHeaders(headers: headers)
@@ -153,6 +155,8 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
     var authorizedAppLinks: [String] = []
     var activeNativeNavigationForWebview: Bool = true
     var disableOverscroll: Bool = false
+    var proxyRequests: Bool = false
+    var proxySchemeHandler: ProxySchemeHandler?
 
     // Dimension properties
     var customWidth: CGFloat?
@@ -669,6 +673,19 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
         // Enable background task processing
         webConfiguration.processPool = WKProcessPool()
 
+        // Register proxy scheme handler if enabled
+        // Swizzles WKWebView.handlesURLScheme to allow registering for http/https via the public API
+        // This is the industry-standard approach used by DuckDuckGo Browser and others
+        if proxyRequests, let handler = proxySchemeHandler {
+            WKWebView.enableCustomSchemeHandling(for: ["https", "http"])
+            if !WKWebView.handlesURLScheme("https") && !WKWebView.handlesURLScheme("http") {
+                webConfiguration.setURLSchemeHandler(handler, forURLScheme: "https")
+                webConfiguration.setURLSchemeHandler(handler, forURLScheme: "http")
+            } else {
+                print("[InAppBrowser][Proxy] WARNING: handlesURLScheme swizzle failed; proxy scheme handler not registered")
+            }
+        }
+
         // Enable JavaScript to run automatically (needed for preShowScript and Firebase polyfill)
         webConfiguration.preferences.javaScriptCanOpenWindowsAutomatically = true
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/inappbrowser",
-  "version": "8.2.0",
+  "version": "8.3.0-alpha.1",
   "description": "Capacitor plugin in app browser",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -41,7 +41,8 @@
     "prettier": "prettier-pretty-check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
     "swiftlint": "node-swiftlint",
     "docgen": "docgen --api InAppBrowserPlugin --output-readme README.md --output-json dist/docs.json",
-    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "build:proxy-bridge": "esbuild src/proxy-bridge.ts --bundle --outfile=android/src/main/assets/proxy-bridge.js --format=iife --target=es2015",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs && npm run build:proxy-bridge",
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
     "prepublishOnly": "npm run build"
@@ -56,6 +57,7 @@
     "@ionic/prettier-config": "^4.0.0",
     "@ionic/swiftlint-config": "^2.0.0",
     "@types/node": "^24.10.1",
+    "esbuild": "^0.27.3",
     "eslint": "^8.57.1",
     "eslint-plugin-import": "^2.31.0",
     "husky": "^9.1.7",