@capgo/capacitor-inappbrowser 8.14.3 → 8.15.0

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

@@ -81,6 +81,7 @@ import androidx.core.view.WindowInsetsControllerCompat;
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout;
 import androidx.webkit.WebMessageCompat;
 import androidx.webkit.WebSettingsCompat;
+import androidx.webkit.WebViewAssetLoader;
 import androidx.webkit.WebViewCompat;
 import androidx.webkit.WebViewFeature;
 import com.caverock.androidsvg.SVG;
@@ -344,6 +345,8 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
     private String instanceId = "";
     private final Map<String, ProxiedRequest> proxiedRequestsHashmap = new ConcurrentHashMap<>();
     private ProxyBridge proxyBridge;
+    private volatile WebViewAssetLoader bundledAssetLoader;
+    private final Object bundledAssetLoaderLock = new Object();
     private String proxyBridgeScript;
     private String proxyAccessToken;
     private final ExecutorService executorService = Executors.newCachedThreadPool();
@@ -2232,6 +2235,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
             _webView.addJavascriptInterface(proxyBridge, "__capgoProxy");
             proxyBridgeScript = loadProxyBridgeScript();
         }
+        ensureBundledAssetLoader();
         _webView.getSettings().setJavaScriptEnabled(true);
         _webView.getSettings().setJavaScriptCanOpenWindowsAutomatically(true);
         _webView.getSettings().setDatabaseEnabled(true);
@@ -4364,6 +4368,60 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
         return proxyHeaders;
     }
 
+    private void ensureBundledAssetLoader() {
+        synchronized (bundledAssetLoaderLock) {
+            ensureBundledAssetLoaderLocked();
+        }
+    }
+
+    private void ensureBundledAssetLoaderLocked() {
+        if (bundledAssetLoader != null || _options == null || !_options.getServeBundledAssets()) {
+            return;
+        }
+
+        bundledAssetLoader = BundledAssetSupport.createAssetLoader(
+            _context,
+            _options.getBundledAssetHost(),
+            _options.getBundledAssetScheme()
+        );
+    }
+
+    public void applyBundledAssetResolution(BundledAssetSupport.Resolution resolution, String localUrl) {
+        if (_options == null || resolution == null) {
+            return;
+        }
+
+        synchronized (bundledAssetLoaderLock) {
+            bundledAssetLoader = null;
+            _options.setUrl(resolution.url);
+            if (resolution.needsAssetLoader) {
+                BundledAssetSupport.LocalConfig localConfig = BundledAssetSupport.parseLocalConfig(localUrl);
+                _options.setBundledAssetHost(localConfig != null ? localConfig.host : "localhost");
+                _options.setBundledAssetScheme(localConfig != null ? BundledAssetSupport.assetLoaderScheme(localConfig) : "https");
+                _options.setServeBundledAssets(true);
+            } else {
+                _options.setServeBundledAssets(false);
+            }
+        }
+    }
+
+    private WebResourceResponse interceptBundledAssetRequest(WebResourceRequest request) {
+        final WebViewAssetLoader loader;
+        synchronized (bundledAssetLoaderLock) {
+            if (_options == null || !_options.getServeBundledAssets()) {
+                return null;
+            }
+
+            ensureBundledAssetLoaderLocked();
+            loader = bundledAssetLoader;
+        }
+
+        if (loader == null) {
+            return null;
+        }
+        return loader.shouldInterceptRequest(request.getUrl());
+    }
+
     public void setUrl(String url) {
         if (_webView == null) {
             Log.w("InAppBrowser", "Cannot set URL - WebView is null");
@@ -5586,186 +5644,254 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                     if (view == null || _webView == null) {
                         return null;
                     }
-                    if (!shouldUseNativeProxy()) {
-                        return null;
-                    }
 
-                    String requestUrl = request.getUrl().toString();
-                    boolean bridgeBackedRequest = ProxyRequestSupport.isBridgeMarkerRequestUrl(requestUrl);
-                    String originalUrl;
-                    String method;
-                    Map<String, String> requestHeaders = new HashMap<>();
-                    String base64Body = "";
-                    String credentialsMode = "same-origin";
-
-                    if (bridgeBackedRequest) {
-                        Uri uri = request.getUrl();
-                        originalUrl = uri.getQueryParameter("u");
-                        String requestId = uri.getQueryParameter("rid");
-                        if (originalUrl == null || requestId == null) {
-                            return null;
-                        }
+                    if (shouldUseNativeProxy()) {
+                        String requestUrl = request.getUrl().toString();
+                        boolean bridgeBackedRequest = ProxyRequestSupport.isBridgeMarkerRequestUrl(requestUrl);
+                        String originalUrl;
+                        String method;
+                        Map<String, String> requestHeaders = new HashMap<>();
+                        String base64Body = "";
+                        String credentialsMode = "same-origin";
+
+                        if (bridgeBackedRequest) {
+                            Uri uri = request.getUrl();
+                            originalUrl = uri.getQueryParameter("u");
+                            String requestId = uri.getQueryParameter("rid");
+                            if (originalUrl == null || requestId == null) {
+                                return null;
+                            }
 
-                        if (
-                            ProxyRequestSupport.usesLegacyJsProxyMode(_options) &&
-                            !ProxyRequestSupport.shouldDelegateLegacyJsProxyRequest(_options, originalUrl)
-                        ) {
-                            if (proxyBridge != null) {
-                                proxyBridge.getAndRemove(requestId);
+                            if (
+                                ProxyRequestSupport.usesLegacyJsProxyMode(_options) &&
+                                !ProxyRequestSupport.shouldDelegateLegacyJsProxyRequest(_options, originalUrl)
+                            ) {
+                                if (proxyBridge != null) {
+                                    proxyBridge.getAndRemove(requestId);
+                                }
+                                Log.w("InAppBrowserProxy", "Ignoring legacy regex miss for bridge-backed request: " + originalUrl);
+                                return createCanceledResponse();
                             }
-                            Log.w("InAppBrowserProxy", "Ignoring legacy regex miss for bridge-backed request: " + originalUrl);
-                            return createCanceledResponse();
-                        }
 
-                        ProxyBridge.StoredRequest stored = proxyBridge != null ? proxyBridge.getAndRemove(requestId) : null;
-                        if (stored == null) {
-                            Log.e("InAppBrowserProxy", "Missing stored proxy bridge payload for request id: " + requestId);
-                            return createCanceledResponse();
-                        }
-                        method = stored.method;
-                        base64Body = stored.base64Body;
-                        credentialsMode = stored.credentialsMode;
-                        Map<String, String> safeMarkerHeaders = ProxyRequestSupport.extractSafeMarkerHeaders(request.getRequestHeaders());
-                        try {
-                            requestHeaders = ProxyRequestSupport.mergeRequestHeaders(null, stored.headersJson);
-                            requestHeaders = ProxyRequestSupport.mergeMissingHeaders(requestHeaders, safeMarkerHeaders);
-                        } catch (JSONException error) {
-                            Log.e("InAppBrowserProxy", "Failed to parse stored proxy headers", error);
-                            return createCanceledResponse();
-                        }
-                        String initiatorUrl = request.getRequestHeaders().get("Referer");
-                        if (initiatorUrl == null || initiatorUrl.isBlank()) {
-                            initiatorUrl = getWebViewUrlOrFallback(
-                                _options != null && _options.getUrl() != null ? _options.getUrl() : originalUrl
+                            ProxyBridge.StoredRequest stored = proxyBridge != null ? proxyBridge.getAndRemove(requestId) : null;
+                            if (stored == null) {
+                                Log.e("InAppBrowserProxy", "Missing stored proxy bridge payload for request id: " + requestId);
+                                return createCanceledResponse();
+                            }
+                            method = stored.method;
+                            base64Body = stored.base64Body;
+                            credentialsMode = stored.credentialsMode;
+                            Map<String, String> safeMarkerHeaders = ProxyRequestSupport.extractSafeMarkerHeaders(
+                                request.getRequestHeaders()
                             );
+                            try {
+                                requestHeaders = ProxyRequestSupport.mergeRequestHeaders(null, stored.headersJson);
+                                requestHeaders = ProxyRequestSupport.mergeMissingHeaders(requestHeaders, safeMarkerHeaders);
+                            } catch (JSONException error) {
+                                Log.e("InAppBrowserProxy", "Failed to parse stored proxy headers", error);
+                                return createCanceledResponse();
+                            }
+                            String initiatorUrl = request.getRequestHeaders().get("Referer");
+                            if (initiatorUrl == null || initiatorUrl.isBlank()) {
+                                initiatorUrl = getWebViewUrlOrFallback(
+                                    _options != null && _options.getUrl() != null ? _options.getUrl() : originalUrl
+                                );
+                            }
+                            String targetCookies = CookieManager.getInstance().getCookie(originalUrl);
+                            if (
+                                targetCookies != null &&
+                                !targetCookies.isBlank() &&
+                                ProxyRequestSupport.shouldInjectCookies(credentialsMode, initiatorUrl, originalUrl, requestHeaders)
+                            ) {
+                                requestHeaders.put("Cookie", targetCookies);
+                            }
+                        } else {
+                            if (!ProxyRequestSupport.shouldHandleNonBridgeRequest(_options, requestUrl)) {
+                                return interceptBundledAssetRequest(request);
+                            }
+
+                            originalUrl = requestUrl;
+                            method = request.getMethod();
+                            if (request.getRequestHeaders() != null) {
+                                requestHeaders.putAll(request.getRequestHeaders());
+                            }
                         }
-                        String targetCookies = CookieManager.getInstance().getCookie(originalUrl);
+
+                        NativeRequestContext requestContext = new NativeRequestContext(
+                            originalUrl,
+                            method,
+                            requestHeaders,
+                            base64Body,
+                            request.isForMainFrame(),
+                            credentialsMode
+                        );
+
                         if (
-                            targetCookies != null &&
-                            !targetCookies.isBlank() &&
-                            ProxyRequestSupport.shouldInjectCookies(credentialsMode, initiatorUrl, originalUrl, requestHeaders)
+                            ProxyRequestSupport.shouldLetWebViewHandleMissingBody(
+                                requestUrl,
+                                requestContext.method,
+                                requestContext.base64Body
+                            )
                         ) {
-                            requestHeaders.put("Cookie", targetCookies);
-                        }
-                    } else {
-                        if (!ProxyRequestSupport.shouldHandleNonBridgeRequest(_options, requestUrl)) {
+                            Log.w("InAppBrowserProxy", "Allowing WebView to handle request with uncaptured body: " + requestContext.url);
                             return null;
                         }
 
-                        originalUrl = requestUrl;
-                        method = request.getMethod();
-                        if (request.getRequestHeaders() != null) {
-                            requestHeaders.putAll(request.getRequestHeaders());
+                        boolean legacyProxyMode = ProxyRequestSupport.usesLegacyJsProxyMode(_options);
+                        boolean shouldDelegateLegacyRequest = ProxyRequestSupport.shouldDelegateLegacyJsProxyRequest(
+                            _options,
+                            requestContext.url
+                        );
+                        NativeResponseData directResponseData = null;
+
+                        NativeProxyRule outboundRule =
+                            legacyProxyMode && shouldDelegateLegacyRequest
+                                ? new NativeProxyRule(
+                                      null,
+                                      null,
+                                      null,
+                                      null,
+                                      null,
+                                      null,
+                                      null,
+                                      null,
+                                      false,
+                                      NativeProxyRule.Action.DELEGATE_TO_JS
+                                  )
+                                : findMatchingRule(_options.getOutboundProxyRules(), requestContext, null);
+
+                        if (outboundRule != null && outboundRule.getAction() == NativeProxyRule.Action.CANCEL) {
+                            return createCanceledResponse();
                         }
-                    }
-
-                    NativeRequestContext requestContext = new NativeRequestContext(
-                        originalUrl,
-                        method,
-                        requestHeaders,
-                        base64Body,
-                        request.isForMainFrame(),
-                        credentialsMode
-                    );
-
-                    if (
-                        ProxyRequestSupport.shouldLetWebViewHandleMissingBody(requestUrl, requestContext.method, requestContext.base64Body)
-                    ) {
-                        Log.w("InAppBrowserProxy", "Allowing WebView to handle request with uncaptured body: " + requestContext.url);
-                        return null;
-                    }
 
-                    boolean legacyProxyMode = ProxyRequestSupport.usesLegacyJsProxyMode(_options);
-                    boolean shouldDelegateLegacyRequest = ProxyRequestSupport.shouldDelegateLegacyJsProxyRequest(
-                        _options,
-                        requestContext.url
-                    );
-                    NativeResponseData directResponseData = null;
-
-                    NativeProxyRule outboundRule =
-                        legacyProxyMode && shouldDelegateLegacyRequest
-                            ? new NativeProxyRule(
-                                  null,
-                                  null,
-                                  null,
-                                  null,
-                                  null,
-                                  null,
-                                  null,
-                                  null,
-                                  false,
-                                  NativeProxyRule.Action.DELEGATE_TO_JS
-                              )
-                            : findMatchingRule(_options.getOutboundProxyRules(), requestContext, null);
-
-                    if (outboundRule != null && outboundRule.getAction() == NativeProxyRule.Action.CANCEL) {
-                        return createCanceledResponse();
-                    }
-
-                    if (outboundRule != null && outboundRule.getAction() == NativeProxyRule.Action.DELEGATE_TO_JS) {
-                        String proxyId = UUID.randomUUID().toString();
-                        ProxiedRequest proxiedRequest = new ProxiedRequest();
-                        proxiedRequest.requestContext = requestContext;
-                        addProxiedRequest(proxyId, proxiedRequest);
-
-                        String dialogId = instanceId != null ? instanceId : "";
-                        _options
-                            .getCallbacks()
-                            .proxyRequestEvent(
-                                proxyId,
-                                "outbound",
-                                requestContext.url,
-                                requestContext.method,
-                                serializeHeaders(requestContext.headers),
-                                requestContext.base64Body.isEmpty() ? null : requestContext.base64Body,
-                                null,
-                                null,
-                                null,
-                                dialogId
-                            );
+                        if (outboundRule != null && outboundRule.getAction() == NativeProxyRule.Action.DELEGATE_TO_JS) {
+                            String proxyId = UUID.randomUUID().toString();
+                            ProxiedRequest proxiedRequest = new ProxiedRequest();
+                            proxiedRequest.requestContext = requestContext;
+                            addProxiedRequest(proxyId, proxiedRequest);
+
+                            String dialogId = instanceId != null ? instanceId : "";
+                            _options
+                                .getCallbacks()
+                                .proxyRequestEvent(
+                                    proxyId,
+                                    "outbound",
+                                    requestContext.url,
+                                    requestContext.method,
+                                    serializeHeaders(requestContext.headers),
+                                    requestContext.base64Body.isEmpty() ? null : requestContext.base64Body,
+                                    null,
+                                    null,
+                                    null,
+                                    dialogId
+                                );
 
-                        try {
-                            if (proxiedRequest.semaphore.tryAcquire(1, 10, TimeUnit.SECONDS)) {
-                                if (proxiedRequest.canceled) {
-                                    return createCanceledResponse();
-                                }
-                                if (proxiedRequest.response != null) {
-                                    return proxiedRequest.response;
-                                }
-                                if (proxiedRequest.nativeResponse != null) {
-                                    directResponseData = proxiedRequest.nativeResponse;
+                            try {
+                                if (proxiedRequest.semaphore.tryAcquire(1, 10, TimeUnit.SECONDS)) {
+                                    if (proxiedRequest.canceled) {
+                                        return createCanceledResponse();
+                                    }
+                                    if (proxiedRequest.response != null) {
+                                        return proxiedRequest.response;
+                                    }
+                                    if (proxiedRequest.nativeResponse != null) {
+                                        directResponseData = proxiedRequest.nativeResponse;
+                                    } else {
+                                        requestContext =
+                                            proxiedRequest.requestContext != null ? proxiedRequest.requestContext : requestContext;
+                                    }
                                 } else {
-                                    requestContext = proxiedRequest.requestContext != null ? proxiedRequest.requestContext : requestContext;
-                                }
-                            } else {
-                                synchronized (proxiedRequest) {
-                                    proxiedRequest.timedOut = true;
+                                    synchronized (proxiedRequest) {
+                                        proxiedRequest.timedOut = true;
+                                    }
+                                    removeProxiedRequest(proxyId);
+                                    Log.w("InAppBrowserProxy", "Proxy timeout, falling back to native replay for: " + requestContext.url);
                                 }
+                            } catch (InterruptedException error) {
                                 removeProxiedRequest(proxyId);
-                                Log.w("InAppBrowserProxy", "Proxy timeout, falling back to native replay for: " + requestContext.url);
+                                Thread.currentThread().interrupt();
+                                Log.e("InAppBrowserProxy", "Semaphore wait error", error);
+                                return bridgeBackedRequest ? createCanceledResponse() : null;
                             }
-                        } catch (InterruptedException error) {
-                            removeProxiedRequest(proxyId);
-                            Thread.currentThread().interrupt();
-                            Log.e("InAppBrowserProxy", "Semaphore wait error", error);
-                            return bridgeBackedRequest ? createCanceledResponse() : null;
                         }
-                    }
 
-                    NativeResponseData nativeResponse = directResponseData;
-                    if (nativeResponse == null) {
-                        try {
-                            nativeResponse = performNativeRequest(requestContext);
-                        } catch (IOException error) {
-                            Log.e("InAppBrowserProxy", "Native request failed for: " + requestContext.url, error);
-                            return createProxiedNativeFailureResponse(requestContext.url, bridgeBackedRequest, error);
+                        NativeResponseData nativeResponse = directResponseData;
+                        if (nativeResponse == null) {
+                            try {
+                                nativeResponse = performNativeRequest(requestContext);
+                            } catch (IOException error) {
+                                Log.e("InAppBrowserProxy", "Native request failed for: " + requestContext.url, error);
+                                return createProxiedNativeFailureResponse(requestContext.url, bridgeBackedRequest, error);
+                            }
                         }
-                    }
 
-                    int redirectsFollowed = 0;
-                    while (true) {
-                        NativeProxyRule inboundRule = findMatchingRule(_options.getInboundProxyRules(), requestContext, nativeResponse);
-                        if (inboundRule == null || inboundRule.getAction() == NativeProxyRule.Action.CONTINUE) {
+                        int redirectsFollowed = 0;
+                        while (true) {
+                            NativeProxyRule inboundRule = findMatchingRule(_options.getInboundProxyRules(), requestContext, nativeResponse);
+                            if (inboundRule == null || inboundRule.getAction() == NativeProxyRule.Action.CONTINUE) {
+                                RedirectReplayResult redirectReplay;
+                                try {
+                                    redirectReplay = followRedirectForWebView(requestContext, nativeResponse, redirectsFollowed);
+                                } catch (IOException error) {
+                                    Log.e("InAppBrowserProxy", "Native redirect replay failed for: " + requestContext.url, error);
+                                    return createProxiedNativeFailureResponse(requestContext.url, bridgeBackedRequest, error);
+                                }
+                                if (redirectReplay != null) {
+                                    requestContext = redirectReplay.requestContext;
+                                    nativeResponse = redirectReplay.responseData;
+                                    redirectsFollowed++;
+                                    continue;
+                                }
+                                return createWebResourceResponseOrFallback(nativeResponse, bridgeBackedRequest, requestContext.url);
+                            }
+                            if (inboundRule.getAction() == NativeProxyRule.Action.CANCEL) {
+                                return createCanceledResponse();
+                            }
+
+                            String proxyId = UUID.randomUUID().toString();
+                            ProxiedRequest proxiedRequest = new ProxiedRequest();
+                            proxiedRequest.requestContext = requestContext;
+                            proxiedRequest.nativeResponse = nativeResponse;
+                            addProxiedRequest(proxyId, proxiedRequest);
+
+                            String dialogId = instanceId != null ? instanceId : "";
+                            _options
+                                .getCallbacks()
+                                .proxyRequestEvent(
+                                    proxyId,
+                                    "inbound",
+                                    requestContext.url,
+                                    requestContext.method,
+                                    serializeHeaders(requestContext.headers),
+                                    requestContext.base64Body.isEmpty() ? null : requestContext.base64Body,
+                                    nativeResponse.statusCode,
+                                    serializeHeaders(nativeResponse.headers),
+                                    Base64.encodeToString(nativeResponse.bodyBytes, Base64.NO_WRAP),
+                                    dialogId
+                                );
+
+                            try {
+                                if (proxiedRequest.semaphore.tryAcquire(1, 10, TimeUnit.SECONDS)) {
+                                    if (proxiedRequest.canceled) {
+                                        return createCanceledResponse();
+                                    }
+                                    if (proxiedRequest.response != null) {
+                                        return proxiedRequest.response;
+                                    }
+                                    if (proxiedRequest.nativeResponse != null) {
+                                        nativeResponse = proxiedRequest.nativeResponse;
+                                    }
+                                } else {
+                                    synchronized (proxiedRequest) {
+                                        proxiedRequest.timedOut = true;
+                                    }
+                                    removeProxiedRequest(proxyId);
+                                }
+                            } catch (InterruptedException error) {
+                                Thread.currentThread().interrupt();
+                                Log.e("InAppBrowserProxy", "Semaphore wait error", error);
+                            }
+
                             RedirectReplayResult redirectReplay;
                             try {
                                 redirectReplay = followRedirectForWebView(requestContext, nativeResponse, redirectsFollowed);
@@ -5781,69 +5907,9 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
                             }
                             return createWebResourceResponseOrFallback(nativeResponse, bridgeBackedRequest, requestContext.url);
                         }
-                        if (inboundRule.getAction() == NativeProxyRule.Action.CANCEL) {
-                            return createCanceledResponse();
-                        }
-
-                        String proxyId = UUID.randomUUID().toString();
-                        ProxiedRequest proxiedRequest = new ProxiedRequest();
-                        proxiedRequest.requestContext = requestContext;
-                        proxiedRequest.nativeResponse = nativeResponse;
-                        addProxiedRequest(proxyId, proxiedRequest);
-
-                        String dialogId = instanceId != null ? instanceId : "";
-                        _options
-                            .getCallbacks()
-                            .proxyRequestEvent(
-                                proxyId,
-                                "inbound",
-                                requestContext.url,
-                                requestContext.method,
-                                serializeHeaders(requestContext.headers),
-                                requestContext.base64Body.isEmpty() ? null : requestContext.base64Body,
-                                nativeResponse.statusCode,
-                                serializeHeaders(nativeResponse.headers),
-                                Base64.encodeToString(nativeResponse.bodyBytes, Base64.NO_WRAP),
-                                dialogId
-                            );
-
-                        try {
-                            if (proxiedRequest.semaphore.tryAcquire(1, 10, TimeUnit.SECONDS)) {
-                                if (proxiedRequest.canceled) {
-                                    return createCanceledResponse();
-                                }
-                                if (proxiedRequest.response != null) {
-                                    return proxiedRequest.response;
-                                }
-                                if (proxiedRequest.nativeResponse != null) {
-                                    nativeResponse = proxiedRequest.nativeResponse;
-                                }
-                            } else {
-                                synchronized (proxiedRequest) {
-                                    proxiedRequest.timedOut = true;
-                                }
-                                removeProxiedRequest(proxyId);
-                            }
-                        } catch (InterruptedException error) {
-                            Thread.currentThread().interrupt();
-                            Log.e("InAppBrowserProxy", "Semaphore wait error", error);
-                        }
-
-                        RedirectReplayResult redirectReplay;
-                        try {
-                            redirectReplay = followRedirectForWebView(requestContext, nativeResponse, redirectsFollowed);
-                        } catch (IOException error) {
-                            Log.e("InAppBrowserProxy", "Native redirect replay failed for: " + requestContext.url, error);
-                            return createProxiedNativeFailureResponse(requestContext.url, bridgeBackedRequest, error);
-                        }
-                        if (redirectReplay != null) {
-                            requestContext = redirectReplay.requestContext;
-                            nativeResponse = redirectReplay.responseData;
-                            redirectsFollowed++;
-                            continue;
-                        }
-                        return createWebResourceResponseOrFallback(nativeResponse, bridgeBackedRequest, requestContext.url);
                     }
+
+                    return interceptBundledAssetRequest(request);
                 }
 
                 @Override

package/dist/docs.json

@@ -999,9 +999,13 @@
             {
               "text": "0.1.0",
               "name": "since"
+            },
+            {
+              "text": "\"https://capgo.app\"",
+              "name": "example"
             }
           ],
-          "docs": "Target URL to load.",
+          "docs": "Target URL to load.\n\nRemote `http://` and `https://` URLs are loaded as-is. Relative bundled paths\nsuch as `/index.html` are not supported; use `openWebView()` instead.",
           "complexTypes": [],
           "type": "string"
         },
@@ -1403,12 +1407,20 @@
               "text": "0.1.0",
               "name": "since"
             },
+            {
+              "text": "8.15.0 Relative bundled paths (`/index.html`, `assets/page.html`) are supported.",
+              "name": "since"
+            },
             {
               "text": "\"https://capgo.app\"",
               "name": "example"
+            },
+            {
+              "text": "\"/index.html\"",
+              "name": "example"
             }
           ],
-          "docs": "Target URL to load.",
+          "docs": "Target URL to load.\n\nRemote `http://` and `https://` URLs are loaded as-is.\n\nTo open bundled web assets from the app bundle without running a local HTTP server,\npass a relative path such as `/index.html` or `assets/page.html`. The plugin resolves it to\nthe Capacitor local URL for the current platform (defaults: `capacitor://localhost/...` on iOS,\n`https://localhost/...` on Android; actual scheme and host follow the app's configured Capacitor\nlocal URL) and serves files from the packaged `public/` directory, or `www/` on iOS when `public/`\nis absent.",
           "complexTypes": [],
           "type": "string"
         },

package/dist/esm/bundled-asset-support.d.ts

@@ -0,0 +1,40 @@
+export type BundledAssetPlatform = 'ios' | 'android';
+export interface BundledAssetLocalConfig {
+    scheme: string;
+    host: string;
+}
+export interface BundledAssetResolution {
+    url: string;
+}
+/** Default Capacitor local URL settings used when no runtime config is available. */
+export declare const BUNDLED_ASSET_DEFAULTS: Record<BundledAssetPlatform, BundledAssetLocalConfig>;
+/** Returns true when the input looks like an absolute URL (including protocol-relative URLs). */
+export declare function isAbsoluteUrl(url: string): boolean;
+/** Returns true when any path segment is `..`. */
+export declare function containsPathTraversal(path: string): boolean;
+/**
+ * Normalizes a relative bundled asset path to a leading-slash form.
+ * Returns null when the path contains traversal segments.
+ */
+export declare function normalizeBundledPath(path: string): string | null;
+/** Parses a Capacitor local URL into scheme and host components. */
+export declare function parseBundledLocalConfig(localUrl?: string | null): BundledAssetLocalConfig | null;
+/** Returns the scheme WebView navigation should use for bundled assets on a platform. */
+export declare function handlerSchemeForPlatform(platform: BundledAssetPlatform, localConfig: BundledAssetLocalConfig): string;
+/**
+ * Returns true when the URL targets the configured Capacitor local host/scheme
+ * (including the platform handler scheme rewrite).
+ */
+export declare function isBundledLocalUrl(url: string, platform: BundledAssetPlatform, localConfig?: BundledAssetLocalConfig | null): boolean;
+/** Returns true when the input is a non-empty relative bundled asset path. */
+export declare function isRelativeBundledPath(url: string): boolean;
+/**
+ * Resolves a bundled asset URL for the given platform.
+ * Relative paths become platform-local URLs; bundled local URLs may be rewritten to the handler scheme.
+ */
+export declare function resolveBundledAssetUrl(url: string, platform: BundledAssetPlatform, localConfig?: BundledAssetLocalConfig | null): BundledAssetResolution | null;
+/**
+ * Resolves relative bundled paths for legacy native plugins that do not perform native resolution.
+ * Throws when the path is invalid.
+ */
+export declare function resolveLegacyNativeWebViewUrl(url: string, platform: BundledAssetPlatform, localConfig?: BundledAssetLocalConfig | null): string;