catalyst-core 0.2.0-beta.2 → 0.3.0-beta.1

package/dist/native/bridge/utils/NativeBridge.js

@@ -1,144 +1,428 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=exports.NativeBridgeUtil=void 0;var _NativeInterfaces=require("../constants/NativeInterfaces.js");/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.NativeBridgeUtil = void 0;
+var _NativeInterfaces = require("../constants/NativeInterfaces.js");
+/**
  * NativeBridge Utility
  * Handles communication from Web to Native platforms
  * Supports both Android (window.NativeBridge) and iOS (webkit.messageHandlers)
- */class NativeBridgeUtil{constructor(){this.isAndroid=this._detectAndroid();this.isIOS=this._detectIOS();this.isNativeEnvironment=this.isAndroid||this.isIOS;if(typeof window!=="undefined"){this._logEnvironmentInfo();}}/**
-     * Detect if running on Android WebView
-     */_detectAndroid(){if(typeof window==="undefined")return false;return!!(window.NativeBridge&&typeof window.NativeBridge==="object");}/**
-     * Detect if running on iOS WebView
-     */_detectIOS(){if(typeof window==="undefined")return false;return!!window.webkit?.messageHandlers?.NativeBridge;}/**
-     * Log environment detection info for debugging
-     */_logEnvironmentInfo(){console.log("🌉 NativeBridge Environment Detection:",{isAndroid:this.isAndroid,isIOS:this.isIOS,isNativeEnvironment:this.isNativeEnvironment,hasAndroidBridge:!!window.NativeBridge,hasIOSBridge:!!window.webkit?.messageHandlers?.NativeBridge});}/**
-     * Validate command before execution
-     */_validateCommand(command){if(!command){throw new Error("Command is required");}if(!(0,_NativeInterfaces.isValidCommand)(command)){throw new Error(`Invalid command: ${command}. Available commands: ${Object.values(_NativeInterfaces.NATIVE_COMMANDS).join(", ")}`);}if(!this.isAvailable()){throw new Error("Native bridge not available. Ensure you are running in a native WebView environment.");}}/**
-     * Execute command on Android platform
-     */_executeAndroidCommand(command,data){try{if(typeof window.NativeBridge[command]==="function"){console.log("🌉 Calling Android method",command,data?{data}:"(no data)");// Always pass data parameter to match Kotlin method signatures
-window.NativeBridge[command](data);return true;}else{console.error(`Android bridge method '${command}' not found`);return false;}}catch(error){console.error("Error executing Android command:",command,error);return false;}}/**
-     * Execute command on iOS platform
-     */_executeIOSCommand(command,data){try{// For iOS, we always send a message object
-const message={command:command,data:data// This can be null/undefined, iOS bridge should handle it
-};console.log("🌉 Calling iOS method",command,data?{data}:"(no data)");window.webkit.messageHandlers.NativeBridge.postMessage(message);return true;}catch(error){console.error("Error executing iOS command:",command,error);throw error;}}/**
-     * Main method to call native commands
-     * @param {string} command - The command to execute (from NATIVE_COMMANDS)
-     * @param {any} data - Optional data to pass to the native side
-     * @returns {boolean} - Success status
-     */call(command,data=null){try{// Validate environment and command
-this._validateCommand(command);console.log("🌉 Executing native command:",command,data?{data}:"");// Execute on appropriate platform
-if(this.isAndroid){return this._executeAndroidCommand(command,data);}else if(this.isIOS){return this._executeIOSCommand(command,data);}return false;}catch(error){console.error("🌉 Failed to execute command:",command,error);// In development, we might want to show user-friendly errors
-if(process.env.NODE_ENV==="development"){console.warn(`🌉 Development mode: Native command '${command}' failed. This is expected when running in browser.`);}throw error;}}/**
-     * Video stream methods
-     */videoStream={/**
-         * Start native camera video stream
-         * @param {Object} options - Stream options
-         *   facing: 'back' | 'front'
-         *   format: 'qr' | 'barcode' | 'all'  — format filter (default: 'all')
-         *   zoom: { auto: true, initial: 1.0 }  — auto-zoom via ML Kit, initial is multiplier (1.0=1x)
-         *   zoom: { auto: false, initial: 2.0 } — manual, starts at 2x
-         */start:(options={})=>this.call(_NativeInterfaces.NATIVE_COMMANDS.START_VIDEO_STREAM,options),/**
-         * Stop native camera video stream
-         */stop:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.STOP_VIDEO_STREAM),/**
-         * Set zoom level multiplier (e.g. 1.0 = 1x, 2.0 = 2x)
-         * @param {number} zoomPct - multiplier >= 1.0
-         */setZoom:zoomPct=>{if(zoomPct==null||typeof zoomPct!=="number"||isNaN(zoomPct)){console.warn("[NativeBridge] setZoom: invalid value, ignoring:",zoomPct);return false;}return this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_VIDEO_STREAM_ZOOM,zoomPct.toString());},/**
-         * Enable or disable torch (back camera only)
-         * @param {boolean} on
-         */setTorch:on=>this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_VIDEO_STREAM_TORCH,JSON.stringify({on:!!on})),/**
-         * Set target FPS range — triggers session restart
-         * @param {number|null} min - minimum fps (e.g. 15), null to clear
-         * @param {number|null} max - maximum fps (e.g. 30), null to clear
-         */setFps:(min,max)=>this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_VIDEO_STREAM_FPS,JSON.stringify({min:min??null,max:max??null})),/**
-         * Flip between front and back camera — restarts the native session internally
-         * Torch resets to off after flip; ON_TORCH_CHANGED(false) fires automatically.
-         */flip:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.FLIP_VIDEO_STREAM)};/**
-     * Camera-specific methods for easier usage
-     */camera={/**
-         * Open camera for photo capture
-         * @param {string} options - JSON string of camera options
-         */open:(options=null)=>this.call(_NativeInterfaces.NATIVE_COMMANDS.OPEN_CAMERA,options),/**
-         * Request camera permission
-         * @param {string} config - JSON string of permission config
-         */requestPermission:(config=null)=>this.call(_NativeInterfaces.NATIVE_COMMANDS.REQUEST_CAMERA_PERMISSION,config)};/**
-     * File-specific methods for easier usage
-     */file={/**
-         * Open file picker
-         * @param {string|Object|null} options - MIME type string or options object with advanced config
-         */pick:(options="*/*")=>{if(options==null){return this.call(_NativeInterfaces.NATIVE_COMMANDS.PICK_FILE,"*/*");}if(typeof options==="string"){const mimeType=options.trim()||"*/*";return this.call(_NativeInterfaces.NATIVE_COMMANDS.PICK_FILE,mimeType);}const payload={...options};if(!payload.mimeType||typeof payload.mimeType!=="string"){payload.mimeType="*/*";}return this.call(_NativeInterfaces.NATIVE_COMMANDS.PICK_FILE,JSON.stringify(payload));},/**
-         * Open file with external app
-         * @param {string} fileUrl - URL of the file to open
-         * @param {string} mimeType - Optional MIME type
-         */openWithIntent:(fileUrl,mimeType=null)=>{const params=mimeType?`${fileUrl}|${mimeType}`:fileUrl;return this.call(_NativeInterfaces.NATIVE_COMMANDS.OPEN_FILE_WITH_INTENT,params);}};/**
-     * Network helpers
-     */network={/**
-         * Request current network status from native side
-         */getStatus:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_NETWORK_STATUS)};/**
-     * Haptic feedback methods
-     */haptic={/**
-         * Request haptic feedback
-         * @param {string} feedbackType - Type of haptic feedback
-         */feedback:(feedbackType="light")=>this.call(_NativeInterfaces.NATIVE_COMMANDS.REQUEST_HAPTIC_FEEDBACK,feedbackType)};/**
-     * Notification methods for local and push notifications
-     */notification={/**
-         * Schedule a local notification
-         * @param {Object} config - Notification configuration object
-         */scheduleLocal:config=>this.call(_NativeInterfaces.NATIVE_COMMANDS.SCHEDULE_LOCAL_NOTIFICATION,JSON.stringify(config)),/**
-         * Cancel a local notification
-         * @param {string} notificationId - ID of the notification to cancel
-         */cancelLocal:notificationId=>this.call(_NativeInterfaces.NATIVE_COMMANDS.CANCEL_LOCAL_NOTIFICATION,notificationId),/**
-         * Request notification permission
-         */requestPermission:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.REQUEST_NOTIFICATION_PERMISSION),/**
-         * Register for push notifications
-         */registerForPush:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.REGISTER_FOR_PUSH_NOTIFICATIONS),/**
-         * Update badge count
-         * @param {number} count - Badge count number
-         */updateBadge:count=>this.call(_NativeInterfaces.NATIVE_COMMANDS.UPDATE_BADGE_COUNT,count?.toString()),/**
-         * Subscribe to push notification topic
-         * @param {string} topic - Topic name to subscribe to
-         */subscribeToTopic:topic=>this.call(_NativeInterfaces.NATIVE_COMMANDS.SUBSCRIBE_TO_TOPIC,JSON.stringify({topic})),/**
-         * Unsubscribe from push notification topic
-         * @param {string} topic - Topic name to unsubscribe from
-         */unsubscribeFromTopic:topic=>this.call(_NativeInterfaces.NATIVE_COMMANDS.UNSUBSCRIBE_FROM_TOPIC,JSON.stringify({topic})),/**
-         * Get list of subscribed topics
-         */getSubscribedTopics:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_SUBSCRIBED_TOPICS)};/**
-     * Device info methods
-     */device={/**
-         * Get device information
-         * @returns {Promise} - Returns device info through callback
-         */getDeviceInfo:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_DEVICE_INFO)};/**
-     * Auth methods
-     */auth={/**
-         * Trigger Google Sign-In (Credential Manager)
-         * @param {Object} options - config (clientId, nonce, autoSelect, etc.)
-         */googleSignIn:(options={})=>{const payload=options&&typeof options==="object"?JSON.stringify(options):options?.toString?.();return this.call(_NativeInterfaces.NATIVE_COMMANDS.GOOGLE_SIGN_IN,payload);}};/** Safe area methods
-     */safeArea={/**
-         * Get current safe area insets
-         * Returns insets through ON_SAFE_AREA_INSETS_UPDATED callback
-         */get:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_SAFE_AREA)};/**
-     * Security methods
-     */security={/**
-         * Enable or disable FLAG_SECURE (prevents screenshots / app-switcher caching)
-         * @param {boolean} enable - true to secure, false to unsecure
-         */setScreenSecure:enable=>this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_SCREEN_SECURE,JSON.stringify({enable})),/**
-         * Query current FLAG_SECURE status
-         * Returns result through ON_SCREEN_SECURE_SET callback
-         */getScreenSecure:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_SCREEN_SECURE),/**
-         * Clear all WebView data (cache, history, cookies, WebStorage)
-         * Returns result through ON_WEB_DATA_CLEARED / ON_WEB_DATA_CLEAR_ERROR callback
-         */clearWebData:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.CLEAR_WEB_DATA)};transition={/**
-         * Begin a native transition — native takes a snapshot/overlay of the current screen.
-         * @param {Object} options
-         *   type: 'slide' | 'fade'
-         *   direction: 'left' | 'right' | 'up' | 'down'  (slide only)
-         *   duration: number (ms, default 300)
-         *   timeout: number (ms, safety timer — native force-fades overlay if commitTransition is never called)
-         */start:(options={})=>this.call(_NativeInterfaces.NATIVE_COMMANDS.START_TRANSITION,JSON.stringify(options)),/**
-         * Commit the transition — native animates the snapshot overlay out, revealing the new page.
-         */commit:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.COMMIT_TRANSITION),/**
-         * Cancel the transition — native removes the overlay immediately without animating.
-         */cancel:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.CANCEL_TRANSITION)};/**
-     * Get environment info
-     */getEnvironmentInfo(){return{isAndroid:this.isAndroid,isIOS:this.isIOS,isNativeEnvironment:this.isNativeEnvironment,platform:this.isAndroid?"android":this.isIOS?"ios":"web"};}/**
-     * Check if native bridge is available — live check, never stale
-     */isAvailable(){return this._detectAndroid()||this._detectIOS();}/**
-     * Debug method to test native bridge connectivity
-     */testConnection(){console.group("🌉 NativeBridge Connection Test");console.log("Environment:",this.getEnvironmentInfo());console.log("Available commands:",Object.values(_NativeInterfaces.NATIVE_COMMANDS));if(this.isAndroid&&window.NativeBridge){console.log("Android bridge methods:",Object.getOwnPropertyNames(window.NativeBridge));}if(this.isIOS&&window.webkit?.messageHandlers?.NativeBridge){console.log("iOS webkit bridge available");}console.groupEnd();}}// Export singleton instance
-exports.NativeBridgeUtil=NativeBridgeUtil;const nativeBridge=new NativeBridgeUtil();var _default=exports.default=nativeBridge;// Also export the class for advanced usage
+ */
+class NativeBridgeUtil {
+  constructor() {
+    this.isAndroid = this._detectAndroid();
+    this.isIOS = this._detectIOS();
+    this.isNativeEnvironment = this.isAndroid || this.isIOS;
+    if (typeof window !== "undefined") {
+      this._logEnvironmentInfo();
+    }
+  }
+
+  /**
+   * Detect if running on Android WebView
+   */
+  _detectAndroid() {
+    if (typeof window === "undefined") return false;
+    return !!(window.NativeBridge && typeof window.NativeBridge === "object");
+  }
+
+  /**
+   * Detect if running on iOS WebView
+   */
+  _detectIOS() {
+    if (typeof window === "undefined") return false;
+    return !!window.webkit?.messageHandlers?.NativeBridge;
+  }
+
+  /**
+   * Log environment detection info for debugging
+   */
+  _logEnvironmentInfo() {
+    console.log("🌉 NativeBridge Environment Detection:", {
+      isAndroid: this.isAndroid,
+      isIOS: this.isIOS,
+      isNativeEnvironment: this.isNativeEnvironment,
+      hasAndroidBridge: !!window.NativeBridge,
+      hasIOSBridge: !!window.webkit?.messageHandlers?.NativeBridge
+    });
+  }
+
+  /**
+   * Validate command before execution
+   */
+  _validateCommand(command) {
+    if (!command) {
+      throw new Error("Command is required");
+    }
+    if (!(0, _NativeInterfaces.isValidCommand)(command)) {
+      throw new Error(`Invalid command: ${command}. Available commands: ${Object.values(_NativeInterfaces.NATIVE_COMMANDS).join(", ")}`);
+    }
+    if (!this.isAvailable()) {
+      throw new Error("Native bridge not available. Ensure you are running in a native WebView environment.");
+    }
+  }
+
+  /**
+   * Execute command on Android platform
+   */
+  _executeAndroidCommand(command, data) {
+    try {
+      if (typeof window.NativeBridge[command] === "function") {
+        console.log("🌉 Calling Android method", command, data ? {
+          data
+        } : "(no data)");
+        // Always pass data parameter to match Kotlin method signatures
+        window.NativeBridge[command](data);
+        return true;
+      } else {
+        console.error(`Android bridge method '${command}' not found`);
+        return false;
+      }
+    } catch (error) {
+      console.error("Error executing Android command:", command, error);
+      return false;
+    }
+  }
+
+  /**
+   * Execute command on iOS platform
+   */
+  _executeIOSCommand(command, data) {
+    try {
+      // For iOS, we always send a message object
+      const message = {
+        command: command,
+        data: data // This can be null/undefined, iOS bridge should handle it
+      };
+      console.log("🌉 Calling iOS method", command, data ? {
+        data
+      } : "(no data)");
+      window.webkit.messageHandlers.NativeBridge.postMessage(message);
+      return true;
+    } catch (error) {
+      console.error("Error executing iOS command:", command, error);
+      throw error;
+    }
+  }
+
+  /**
+   * Main method to call native commands
+   * @param {string} command - The command to execute (from NATIVE_COMMANDS)
+   * @param {any} data - Optional data to pass to the native side
+   * @returns {boolean} - Success status
+   */
+  call(command, data = null) {
+    try {
+      // Validate environment and command
+      this._validateCommand(command);
+      console.log("🌉 Executing native command:", command, data ? {
+        data
+      } : "");
+
+      // Execute on appropriate platform
+      if (this.isAndroid) {
+        return this._executeAndroidCommand(command, data);
+      } else if (this.isIOS) {
+        return this._executeIOSCommand(command, data);
+      }
+      return false;
+    } catch (error) {
+      console.error("🌉 Failed to execute command:", command, error);
+
+      // In development, we might want to show user-friendly errors
+      if (process.env.NODE_ENV === "development") {
+        console.warn(`🌉 Development mode: Native command '${command}' failed. This is expected when running in browser.`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Video stream methods
+   */
+  videoStream = {
+    /**
+     * Start native camera video stream
+     * @param {Object} options - Stream options
+     *   facing: 'back' | 'front'
+     *   format: 'qr' | 'barcode' | 'all'  — format filter (default: 'all')
+     *   zoom: { auto: true, initial: 1.0 }  — auto-zoom via ML Kit, initial is multiplier (1.0=1x)
+     *   zoom: { auto: false, initial: 2.0 } — manual, starts at 2x
+     */
+    start: (options = {}) => this.call(_NativeInterfaces.NATIVE_COMMANDS.START_VIDEO_STREAM, options),
+    /**
+     * Stop native camera video stream
+     */
+    stop: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.STOP_VIDEO_STREAM),
+    /**
+     * Set zoom level multiplier (e.g. 1.0 = 1x, 2.0 = 2x)
+     * @param {number} zoomPct - multiplier >= 1.0
+     */
+    setZoom: zoomPct => {
+      if (zoomPct == null || typeof zoomPct !== "number" || isNaN(zoomPct)) {
+        console.warn("[NativeBridge] setZoom: invalid value, ignoring:", zoomPct);
+        return false;
+      }
+      return this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_VIDEO_STREAM_ZOOM, zoomPct.toString());
+    },
+    /**
+     * Enable or disable torch (back camera only)
+     * @param {boolean} on
+     */
+    setTorch: on => this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_VIDEO_STREAM_TORCH, JSON.stringify({
+      on: !!on
+    })),
+    /**
+     * Set target FPS range — triggers session restart
+     * @param {number|null} min - minimum fps (e.g. 15), null to clear
+     * @param {number|null} max - maximum fps (e.g. 30), null to clear
+     */
+    setFps: (min, max) => this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_VIDEO_STREAM_FPS, JSON.stringify({
+      min: min ?? null,
+      max: max ?? null
+    })),
+    /**
+     * Flip between front and back camera — restarts the native session internally
+     * Torch resets to off after flip; ON_TORCH_CHANGED(false) fires automatically.
+     */
+    flip: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.FLIP_VIDEO_STREAM)
+  };
+
+  /**
+   * Camera-specific methods for easier usage
+   */
+  camera = {
+    /**
+     * Open camera for photo capture
+     * @param {string} options - JSON string of camera options
+     */
+    open: (options = null) => this.call(_NativeInterfaces.NATIVE_COMMANDS.OPEN_CAMERA, options),
+    /**
+     * Request camera permission
+     * @param {string} config - JSON string of permission config
+     */
+    requestPermission: (config = null) => this.call(_NativeInterfaces.NATIVE_COMMANDS.REQUEST_CAMERA_PERMISSION, config)
+  };
+
+  /**
+   * File-specific methods for easier usage
+   */
+  file = {
+    /**
+     * Open file picker
+     * @param {string|Object|null} options - MIME type string or options object with advanced config
+     */
+    pick: (options = "*/*") => {
+      if (options == null) {
+        return this.call(_NativeInterfaces.NATIVE_COMMANDS.PICK_FILE, "*/*");
+      }
+      if (typeof options === "string") {
+        const mimeType = options.trim() || "*/*";
+        return this.call(_NativeInterfaces.NATIVE_COMMANDS.PICK_FILE, mimeType);
+      }
+      const payload = {
+        ...options
+      };
+      if (!payload.mimeType || typeof payload.mimeType !== "string") {
+        payload.mimeType = "*/*";
+      }
+      return this.call(_NativeInterfaces.NATIVE_COMMANDS.PICK_FILE, JSON.stringify(payload));
+    },
+    /**
+     * Open file with external app
+     * @param {string} fileUrl - URL of the file to open
+     * @param {string} mimeType - Optional MIME type
+     */
+    openWithIntent: (fileUrl, mimeType = null) => {
+      const params = mimeType ? `${fileUrl}|${mimeType}` : fileUrl;
+      return this.call(_NativeInterfaces.NATIVE_COMMANDS.OPEN_FILE_WITH_INTENT, params);
+    }
+  };
+
+  /**
+   * Network helpers
+   */
+  network = {
+    /**
+     * Request current network status from native side
+     */
+    getStatus: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_NETWORK_STATUS)
+  };
+
+  /**
+   * Haptic feedback methods
+   */
+  haptic = {
+    /**
+     * Request haptic feedback
+     * @param {string} feedbackType - Type of haptic feedback
+     */
+    feedback: (feedbackType = "light") => this.call(_NativeInterfaces.NATIVE_COMMANDS.REQUEST_HAPTIC_FEEDBACK, feedbackType)
+  };
+
+  /**
+   * Notification methods for local and push notifications
+   */
+  notification = {
+    /**
+     * Schedule a local notification
+     * @param {Object} config - Notification configuration object
+     */
+    scheduleLocal: config => this.call(_NativeInterfaces.NATIVE_COMMANDS.SCHEDULE_LOCAL_NOTIFICATION, JSON.stringify(config)),
+    /**
+     * Cancel a local notification
+     * @param {string} notificationId - ID of the notification to cancel
+     */
+    cancelLocal: notificationId => this.call(_NativeInterfaces.NATIVE_COMMANDS.CANCEL_LOCAL_NOTIFICATION, notificationId),
+    /**
+     * Request notification permission
+     */
+    requestPermission: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.REQUEST_NOTIFICATION_PERMISSION),
+    /**
+     * Register for push notifications
+     */
+    registerForPush: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.REGISTER_FOR_PUSH_NOTIFICATIONS),
+    /**
+     * Update badge count
+     * @param {number} count - Badge count number
+     */
+    updateBadge: count => this.call(_NativeInterfaces.NATIVE_COMMANDS.UPDATE_BADGE_COUNT, count?.toString()),
+    /**
+     * Subscribe to push notification topic
+     * @param {string} topic - Topic name to subscribe to
+     */
+    subscribeToTopic: topic => this.call(_NativeInterfaces.NATIVE_COMMANDS.SUBSCRIBE_TO_TOPIC, JSON.stringify({
+      topic
+    })),
+    /**
+     * Unsubscribe from push notification topic
+     * @param {string} topic - Topic name to unsubscribe from
+     */
+    unsubscribeFromTopic: topic => this.call(_NativeInterfaces.NATIVE_COMMANDS.UNSUBSCRIBE_FROM_TOPIC, JSON.stringify({
+      topic
+    })),
+    /**
+     * Get list of subscribed topics
+     */
+    getSubscribedTopics: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_SUBSCRIBED_TOPICS)
+  };
+
+  /**
+   * Device info methods
+   */
+  device = {
+    /**
+     * Get device information
+     * @returns {Promise} - Returns device info through callback
+     */
+    getDeviceInfo: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_DEVICE_INFO)
+  };
+
+  /**
+   * Auth methods
+   */
+  auth = {
+    /**
+     * Trigger Google Sign-In (Credential Manager)
+     * @param {Object} options - config (clientId, nonce, autoSelect, etc.)
+     */
+    googleSignIn: (options = {}) => {
+      const payload = options && typeof options === "object" ? JSON.stringify(options) : options?.toString?.();
+      return this.call(_NativeInterfaces.NATIVE_COMMANDS.GOOGLE_SIGN_IN, payload);
+    }
+  };
+
+  /** Safe area methods
+   */
+  safeArea = {
+    /**
+     * Get current safe area insets
+     * Returns insets through ON_SAFE_AREA_INSETS_UPDATED callback
+     */
+    get: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_SAFE_AREA)
+  };
+
+  /**
+   * Security methods
+   */
+  security = {
+    /**
+     * Enable or disable FLAG_SECURE (prevents screenshots / app-switcher caching)
+     * @param {boolean} enable - true to secure, false to unsecure
+     */
+    setScreenSecure: enable => this.call(_NativeInterfaces.NATIVE_COMMANDS.SET_SCREEN_SECURE, JSON.stringify({
+      enable
+    })),
+    /**
+     * Query current FLAG_SECURE status
+     * Returns result through ON_SCREEN_SECURE_SET callback
+     */
+    getScreenSecure: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_SCREEN_SECURE),
+    /**
+     * Clear all WebView data (cache, history, cookies, WebStorage)
+     * Returns result through ON_WEB_DATA_CLEARED / ON_WEB_DATA_CLEAR_ERROR callback
+     */
+    clearWebData: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.CLEAR_WEB_DATA)
+  };
+  transition = {
+    /**
+     * Begin a native transition — native takes a snapshot/overlay of the current screen.
+     * @param {Object} options
+     *   type: 'slide' | 'fade'
+     *   direction: 'left' | 'right' | 'up' | 'down'  (slide only)
+     *   duration: number (ms, default 300)
+     *   timeout: number (ms, safety timer — native force-fades overlay if commitTransition is never called)
+     */
+    start: (options = {}) => this.call(_NativeInterfaces.NATIVE_COMMANDS.START_TRANSITION, JSON.stringify(options)),
+    /**
+     * Commit the transition — native animates the snapshot overlay out, revealing the new page.
+     */
+    commit: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.COMMIT_TRANSITION),
+    /**
+     * Cancel the transition — native removes the overlay immediately without animating.
+     */
+    cancel: () => this.call(_NativeInterfaces.NATIVE_COMMANDS.CANCEL_TRANSITION)
+  };
+
+  /**
+   * Get environment info
+   */
+  getEnvironmentInfo() {
+    return {
+      isAndroid: this.isAndroid,
+      isIOS: this.isIOS,
+      isNativeEnvironment: this.isNativeEnvironment,
+      platform: this.isAndroid ? "android" : this.isIOS ? "ios" : "web"
+    };
+  }
+
+  /**
+   * Check if native bridge is available — live check, never stale
+   */
+  isAvailable() {
+    return this._detectAndroid() || this._detectIOS();
+  }
+
+  /**
+   * Debug method to test native bridge connectivity
+   */
+  testConnection() {
+    console.group("🌉 NativeBridge Connection Test");
+    console.log("Environment:", this.getEnvironmentInfo());
+    console.log("Available commands:", Object.values(_NativeInterfaces.NATIVE_COMMANDS));
+    if (this.isAndroid && window.NativeBridge) {
+      console.log("Android bridge methods:", Object.getOwnPropertyNames(window.NativeBridge));
+    }
+    if (this.isIOS && window.webkit?.messageHandlers?.NativeBridge) {
+      console.log("iOS webkit bridge available");
+    }
+    console.groupEnd();
+  }
+}
+
+// Export singleton instance
+exports.NativeBridgeUtil = NativeBridgeUtil;
+const nativeBridge = new NativeBridgeUtil();
+var _default = exports.default = nativeBridge; // Also export the class for advanced usage