feat(core): export native bridge utility functions

- Export isRelativeOrProxyUrl and createProxyUrl on Capacitor global object
- Update CapacitorInstance interface to include new methods
- Remove TODO comments in native-bridge.ts

This allows plugins and other parts of the system to use these utility functions for URL handling.

Author: sahilsharda

core/native-bridge.ts

@@ -125,11 +125,9 @@ const convertBody = async (
 const CAPACITOR_HTTP_INTERCEPTOR = '/_capacitor_http_interceptor_';
 const CAPACITOR_HTTP_INTERCEPTOR_URL_PARAM = 'u';
 
-// TODO: export as Cap function
 const isRelativeOrProxyUrl = (url: string | undefined): boolean =>
   !url || !(url.startsWith('http:') || url.startsWith('https:')) || url.indexOf(CAPACITOR_HTTP_INTERCEPTOR) > -1;
 
-// TODO: export as Cap function
 const createProxyUrl = (url: string, win: WindowCapacitor): string => {
   if (isRelativeOrProxyUrl(url)) return url;
   const bridgeUrl = new URL(win.Capacitor?.getServerUrl() ?? '');
@@ -237,6 +235,9 @@ const initBridge = (w: any): void => {
       return false;
     };
 
+    cap.isRelativeOrProxyUrl = isRelativeOrProxyUrl;
+    cap.createProxyUrl = createProxyUrl;
+
     win.Capacitor = cap;
   };
 
@@ -604,7 +605,7 @@ const initBridge = (w: any): void => {
 
         // XHR patch
         interface PatchedXMLHttpRequestConstructor extends XMLHttpRequest {
-          new (): XMLHttpRequest;
+          new(): XMLHttpRequest;
         }
 
         window.XMLHttpRequest = function () {

core/src/definitions-internal.ts

@@ -89,6 +89,16 @@ export interface CapacitorInstance extends CapacitorGlobal {
    * Low-level API used by the native bridge.
    */
   withPlugin?: (pluginName: string, fn: (...args: any[]) => any) => void;
+
+  /**
+   * Checks if a URL is relative or a proxy URL.
+   */
+  isRelativeOrProxyUrl: (url: string | undefined) => boolean;
+
+  /**
+   * Creates a proxy URL for the given URL.
+   */
+  createProxyUrl: (url: string, win: WindowCapacitor) => string;
 }
 
 export interface MessageCallData {