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

package/dist/native/iosnativeWebView/Sources/Core/WebView/WebView.swift

@@ -31,6 +31,10 @@ public struct WebView: UIViewRepresentable, Equatable {
 
         let totalTime = (CFAbsoluteTimeGetCurrent() - start) * 1000
         logWithTimestamp("🏗️ WebView init completed (total: \(String(format: "%.2f", totalTime))ms, protocol: \(String(format: "%.2f", protocolTime))ms)")
+        CatalystPerf.add([
+            "type": "boot-activity-created",
+            "durationMs": totalTime,
+        ])
     }
     
     public func makeUIView(context: Context) -> WKWebView {
@@ -54,12 +58,33 @@ public struct WebView: UIViewRepresentable, Equatable {
         preferences.allowsContentJavaScript = true
         configuration.defaultWebpagePreferences = preferences
 
+        #if DEBUG
+        if ConfigConstants.Profiler.enabled {
+            configuration.userContentController.addUserScript(
+                WKUserScript(
+                    source: "window.__CATALYST_PROFILER_ENABLED = true;",
+                    injectionTime: .atDocumentStart,
+                    forMainFrameOnly: true
+                )
+            )
+        }
+        #endif
+
         let webViewCreateStart = CFAbsoluteTimeGetCurrent()
         let webView = WKWebView(frame: .zero, configuration: configuration)
         let webViewCreateTime = (CFAbsoluteTimeGetCurrent() - webViewCreateStart) * 1000
         logWithTimestamp("📦 WKWebView created (took \(String(format: "%.2f", webViewCreateTime))ms)")
+        CatalystPerf.add([
+            "type": "boot-webview-constructed",
+            "durationMs": webViewCreateTime,
+        ])
 
         webView.navigationDelegate = navigationDelegate
+        #if DEBUG
+        if ConfigConstants.Profiler.enabled {
+            webView.scrollView.delegate = context.coordinator
+        }
+        #endif
         webView.allowsBackForwardNavigationGestures = true
         webView.isOpaque = false
         webView.backgroundColor = .clear
@@ -101,6 +126,10 @@ public struct WebView: UIViewRepresentable, Equatable {
                 let request = URLRequest(url: url)
                 logWithTimestamp("🚀 Calling webView.load()")
                 let loadStart = CFAbsoluteTimeGetCurrent()
+                CatalystPerf.add([
+                    "type": "boot-load-url",
+                    "url": url.absoluteString,
+                ])
                 webView.load(request)
                 let loadTime = (CFAbsoluteTimeGetCurrent() - loadStart) * 1000
                 logWithTimestamp("✅ webView.load() returned (took \(String(format: "%.2f", loadTime))ms)")
@@ -118,6 +147,11 @@ public struct WebView: UIViewRepresentable, Equatable {
 
         let makeUIViewTime = (CFAbsoluteTimeGetCurrent() - makeUIViewStart) * 1000
         logWithTimestamp("🔨 makeUIView() completed (took \(String(format: "%.2f", makeUIViewTime))ms)")
+        #if DEBUG
+        if ConfigConstants.Profiler.enabled {
+            context.coordinator.startKeyboardPerfTracking(webView)
+        }
+        #endif
 
         return webView
     }
@@ -145,6 +179,9 @@ public struct WebView: UIViewRepresentable, Equatable {
         }
 
         // Clean up native bridge
+        coordinator.stopPerfMonitoring()
+        coordinator.stopKeyboardPerfTracking()
+        webView.scrollView.delegate = nil
         coordinator.nativeBridge?.unregister()
         coordinator.nativeBridge = nil
         coordinator.pluginBridge?.unregister()
@@ -163,6 +200,10 @@ public struct WebView: UIViewRepresentable, Equatable {
         var pluginBridge: PluginBridge?
         var hostingController: UIViewController?
         var isObserverAdded = false
+        private weak var perfWebView: WKWebView?
+        private var keyboardObserverTokens: [NSObjectProtocol] = []
+        private var scrollSessionOpen = false
+        private var fpsMonitor: DisplayLinkPerfMonitor?
 
         public init(_ parent: WebView) {
             self.parent = parent
@@ -189,6 +230,17 @@ public struct WebView: UIViewRepresentable, Equatable {
             pluginBridge.register()
             self.nativeBridge = bridge
             self.pluginBridge = pluginBridge
+            #if DEBUG
+            if ConfigConstants.Profiler.enabled {
+                self.fpsMonitor = DisplayLinkPerfMonitor(webView: webView)
+                self.fpsMonitor?.start()
+            }
+            #endif
+        }
+
+        func stopPerfMonitoring() {
+            fpsMonitor?.stop()
+            fpsMonitor = nil
         }
         
         @objc func handleCameraPinch(_ gesture: UIPinchGestureRecognizer) {
@@ -218,9 +270,83 @@ public struct WebView: UIViewRepresentable, Equatable {
 
         deinit {
             // Ensure observer is removed even if dismantleUIView is skipped.
+            CatalystPerf.reset()
+            stopPerfMonitoring()
+            stopKeyboardPerfTracking()
             if isObserverAdded, let webView = nativeBridge?.webView {
                 webView.removeObserver(self, forKeyPath: #keyPath(WKWebView.estimatedProgress))
             }
         }
     }
 }
+
+extension WebView.Coordinator: UIScrollViewDelegate {
+    public func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
+        guard !scrollSessionOpen else { return }
+        scrollSessionOpen = true
+        CatalystPerf.emit([
+            "type": "scroll-start",
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+        ], to: perfWebView)
+    }
+
+    public func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
+        if !decelerate {
+            closeScrollSession()
+        }
+    }
+
+    public func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
+        closeScrollSession()
+    }
+
+    private func closeScrollSession() {
+        guard scrollSessionOpen else { return }
+        scrollSessionOpen = false
+        CatalystPerf.emit([
+            "type": "scroll-end",
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+        ], to: perfWebView)
+    }
+
+    func startKeyboardPerfTracking(_ webView: WKWebView) {
+        perfWebView = webView
+        stopKeyboardPerfTracking()
+
+        let center = NotificationCenter.default
+        keyboardObserverTokens = [
+            center.addObserver(
+                forName: UIResponder.keyboardWillShowNotification,
+                object: nil,
+                queue: .main
+            ) { [weak self] notification in
+                self?.emitKeyboardEvent("keyboard-show", notification: notification)
+            },
+            center.addObserver(
+                forName: UIResponder.keyboardWillHideNotification,
+                object: nil,
+                queue: .main
+            ) { [weak self] notification in
+                self?.emitKeyboardEvent("keyboard-hide", notification: notification)
+            },
+        ]
+    }
+
+    func stopKeyboardPerfTracking() {
+        let center = NotificationCenter.default
+        keyboardObserverTokens.forEach { center.removeObserver($0) }
+        keyboardObserverTokens.removeAll()
+        perfWebView = nil
+    }
+
+    private func emitKeyboardEvent(_ type: String, notification: Notification) {
+        let frame = notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey] as? CGRect
+        let durationSeconds = notification.userInfo?[UIResponder.keyboardAnimationDurationUserInfoKey] as? Double
+        CatalystPerf.emit([
+            "type": type,
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+            "keyboardHeight": frame?.height ?? 0,
+            "durationMs": Int((durationSeconds ?? 0) * 1000),
+        ], to: perfWebView)
+    }
+}

package/dist/native/iosnativeWebView/Sources/Core/WebView/WebViewNavigationDelegate.swift

@@ -13,6 +13,9 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
     private var lastTargetURL: URL?
     private let initialURL: URL?
     private weak var cameraManager: NativeCameraManager?
+    private var pageLoadStartMs: Int64?
+    private var didEmitColdStart = false
+    private var hasStartedProfilerNavigation = false
 
     init(viewModel: WebViewModel, initialURL: URL?, cameraManager: NativeCameraManager? = nil) {
         self.viewModel = viewModel
@@ -155,15 +158,26 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
             }
 
             if isCacheableMethod && CacheManager.shared.shouldCacheURL(url) {
-                logger.info("🎯 URL matches cache pattern: \(url.absoluteString)")
+            logger.info("🎯 URL matches cache pattern: \(url.absoluteString)")
 
+                let cacheStartMs = CatalystPerf.nativeTimeMs()
                 let (cachedData, cacheState, mimeType) = await CacheManager.shared.getCachedResource(
                     for: navigationAction.request
                 )
+                let cacheDurationMs = CatalystPerf.nativeTimeMs() - cacheStartMs
                 
                 switch cacheState {
                 case .fresh, .stale:
                     logger.info("✅ Serving fresh/stale cached content")
+                    CatalystPerf.add([
+                        "type": "cache-hit-memory",
+                        "url": url.absoluteString,
+                        "resourceType": "document",
+                        "nativeTime": cacheStartMs,
+                        "nativeStartMs": cacheStartMs,
+                        "durationMs": cacheDurationMs,
+                        "source": cacheState == .fresh ? "fresh" : "stale",
+                    ])
 
                     if let cachedData = cachedData,
                        let mimeType = mimeType {
@@ -182,6 +196,14 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
                     
                 case .expired:
                     logger.info("♻️ Cache expired, fetching fresh content")
+                    CatalystPerf.add([
+                        "type": "cache-miss-fetch",
+                        "url": url.absoluteString,
+                        "resourceType": "document",
+                        "nativeTime": cacheStartMs,
+                        "nativeStartMs": cacheStartMs,
+                        "durationMs": cacheDurationMs,
+                    ])
                     break
                 }
             } else {
@@ -235,6 +257,25 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
     
     func webView(_ webView: WKWebView, didStartProvisionalNavigation navigation: WKNavigation!) {
         logWithTimestamp("📡 didStartProvisionalNavigation - loading started")
+        if hasStartedProfilerNavigation {
+            CatalystPerf.reset()
+        }
+        hasStartedProfilerNavigation = true
+        let nativeNow = CatalystPerf.nativeTimeMs()
+        pageLoadStartMs = nativeNow
+        CatalystPerf.injectNativeTimeOffset(into: webView)
+        if let url = webView.url?.absoluteString ?? lastTargetURL?.absoluteString {
+            CatalystPerf.add([
+                "type": "boot-page-started",
+                "nativeTime": nativeNow,
+                "url": url,
+            ])
+            CatalystPerf.add([
+                "type": "page-load-start",
+                "nativeTime": nativeNow,
+                "url": url,
+            ])
+        }
         // Stop camera on navigation — mirrors Android CustomWebview onPageStarted lambda
         cameraManager?.stop()
         Task { @MainActor in
@@ -261,6 +302,32 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
 
     func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
         logWithTimestamp("🎉 didFinish - page fully loaded")
+        let nativeNow = CatalystPerf.nativeTimeMs()
+        let url = webView.url?.absoluteString ?? lastTargetURL?.absoluteString ?? ""
+        let durationMs = pageLoadStartMs.map { nativeNow - $0 } ?? 0
+        CatalystPerf.add([
+            "type": "boot-page-finished",
+            "nativeTime": nativeNow,
+            "url": url,
+        ])
+        CatalystPerf.add([
+            "type": "page-load-end",
+            "nativeTime": nativeNow,
+            "url": url,
+            "durationMs": durationMs,
+        ])
+        if !didEmitColdStart {
+            didEmitColdStart = true
+            CatalystPerf.add([
+                "type": "cold-start",
+                "nativeTime": nativeNow,
+                "url": url,
+                "durationMs": nativeNow - AppBoot.nativeStartMs,
+            ])
+        }
+        CatalystPerf.memorySnapshot(to: nil, label: "page-finish")
+        CatalystPerf.scheduleFlush(webView)
+
         Task { @MainActor in
             if let url = webView.url {
                 if !isOfflinePageURL(url) {
@@ -287,6 +354,13 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
     }
 
     private func handleNavigationError(_ error: Error, webView: WKWebView?) {
+        CatalystPerf.emit([
+            "type": "page-load-error",
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+            "url": webView?.url?.absoluteString ?? lastTargetURL?.absoluteString ?? "",
+            "description": error.localizedDescription,
+        ], to: webView)
+
         Task { @MainActor in
             viewModel.reset()
             logWithTimestamp("🔴 Navigation error: \(error.localizedDescription)")

package/dist/native/iosnativeWebView/iosnativeWebViewTests/BridgeMessageValidatorTests.swift

@@ -386,6 +386,19 @@ final class BridgeMessageValidatorTests: XCTestCase {
         XCTAssertEqual(result.command, "openCamera")
     }
 
+    func testTraceExportAvailabilityRequiresDebugProfiler() {
+        XCTAssertTrue(CatalystConstants.Bridge.isTraceExportEnabled(debugBuild: true, profilerEnabled: true))
+        XCTAssertFalse(CatalystConstants.Bridge.isTraceExportEnabled(debugBuild: false, profilerEnabled: true))
+        XCTAssertFalse(CatalystConstants.Bridge.isTraceExportEnabled(debugBuild: true, profilerEnabled: false))
+    }
+
+    func testTraceExportAllowlistMatchesAvailabilityGate() {
+        XCTAssertEqual(
+            CatalystConstants.Bridge.validCommands.contains("exportCatalystTrace"),
+            CatalystConstants.Bridge.isTraceExportEnabled()
+        )
+    }
+
     // ========================================
     // MARK: - Helper Methods
     // ========================================

package/dist/native/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

package/dist/native/plugin-bridge/PluginBridge.js

@@ -1 +1,227 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;class PluginNativeBridge{constructor(){this.handlers=new Map();this.requestCount=0;this.isInitialized=false;}createRequestId=()=>{this.requestCount+=1;return`plugin_${Date.now()}_${this.requestCount}`;};normalizeRequiredString=(value,fieldName)=>{if(typeof value!=="string"||!value.trim()){throw new Error(`${fieldName} must be a non-empty string`);}return value.trim();};normalizeCommand=command=>{if(command==null){return null;}return this.normalizeRequiredString(command,"command");};getHandlerKey=({pluginId,eventName,command=null}={})=>{return JSON.stringify([this.normalizeRequiredString(pluginId,"pluginId"),this.normalizeRequiredString(eventName,"eventName"),this.normalizeCommand(command)]);};getHandlerSet=(key,create=false)=>{let handlers=this.handlers.get(key);if(!handlers&&create){handlers=new Set();this.handlers.set(key,handlers);}return handlers||null;};addHandler=({pluginId,eventName,command}={},handler)=>{if(typeof handler!=="function"){throw new Error("handler must be a function");}this.getHandlerSet(this.getHandlerKey({pluginId,eventName,command}),true).add(handler);};removeHandler=({pluginId,eventName,command}={},handler)=>{const key=this.getHandlerKey({pluginId,eventName,command});const handlers=this.getHandlerSet(key,false);if(!handlers){return false;}if(handler==null){handlers.clear();this.handlers.delete(key);return true;}const removed=handlers.delete(handler);if(handlers.size===0){this.handlers.delete(key);}return removed;};ensureInitialized=()=>{if(typeof window==="undefined"||this.isInitialized){return this;}window.PluginBridgeWeb=window.PluginBridgeWeb||{};window.PluginBridgeWeb.callback=this.dispatchCallback;window.PluginBridgeWeb.dispatch=message=>{let parsed=message;if(typeof parsed==="string"){try{parsed=JSON.parse(parsed);}catch{return false;}}if(!parsed||typeof parsed!=="object"){return false;}const payload=Object.prototype.hasOwnProperty.call(parsed,"payload")?parsed.payload:null;return this.dispatchCallback(parsed.pluginId,parsed.eventName,payload,parsed.requestId??null,parsed.command??null);};this.isInitialized=true;return this;};hasAndroidBridge=()=>typeof window!=="undefined"&&!!window.PluginBridge;hasIOSBridge=()=>typeof window!=="undefined"&&!!window.webkit?.messageHandlers?.PluginBridge;init=()=>this.ensureInitialized();assertInitialized=()=>{if(!this.isInitialized){throw new Error("PluginBridge.init() must be called before using emit() or register()");}};reportHandlerError=error=>{if(typeof queueMicrotask==="function"){queueMicrotask(()=>{throw error;});return;}setTimeout(()=>{throw error;},0);};emit=({pluginId,command,data=null}={})=>{const normalizedPluginId=this.normalizeRequiredString(pluginId,"pluginId");const normalizedCommand=this.normalizeRequiredString(command,"command");if(typeof window==="undefined"){throw new Error("PluginBridge is not available in this environment");}this.assertInitialized();const payload={pluginId:normalizedPluginId,command:normalizedCommand,data,requestId:this.createRequestId()};if(this.hasAndroidBridge()){window.PluginBridge.emit(JSON.stringify(payload));return;}if(this.hasIOSBridge()){window.webkit.messageHandlers.PluginBridge.postMessage(payload);return;}throw new Error("PluginBridge is not available in this environment");};register=({pluginId,eventName,command,handler}={})=>{this.assertInitialized();this.addHandler({pluginId,eventName,command},handler);return()=>this.removeHandler({pluginId,eventName,command},handler);};unregister=({pluginId,eventName,command,handler}={})=>{if(typeof handler!=="function"){throw new Error("handler must be a function");}return this.removeHandler({pluginId,eventName,command},handler);};dispatchCallback=(pluginId,eventName,payload,requestId=null,command=null)=>{void requestId;const normalizedPluginId=typeof pluginId==="string"&&pluginId.trim()?pluginId.trim():null;const normalizedEventName=typeof eventName==="string"&&eventName.trim()?eventName.trim():null;if(normalizedPluginId==null||normalizedEventName==null){return false;}const normalizedCommand=typeof command==="string"&&command.trim()?command.trim():null;const toCall=new Set();const collectHandlers=commandScope=>{const handlers=this.getHandlerSet(JSON.stringify([normalizedPluginId,normalizedEventName,commandScope]),false);if(!handlers){return;}handlers.forEach(handler=>{toCall.add(handler);});};if(normalizedCommand!=null){collectHandlers(normalizedCommand);}collectHandlers(null);if(toCall.size===0){return false;}const meta={pluginId:normalizedPluginId,eventName:normalizedEventName,command:normalizedCommand};toCall.forEach(handler=>{try{handler(payload,meta);}catch(error){this.reportHandlerError(error);}});return true;};}const pluginNativeBridge=new PluginNativeBridge();var _default=exports.default=pluginNativeBridge;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+class PluginNativeBridge {
+  constructor() {
+    this.handlers = new Map();
+    this.requestCount = 0;
+    this.isInitialized = false;
+  }
+  createRequestId = () => {
+    this.requestCount += 1;
+    return `plugin_${Date.now()}_${this.requestCount}`;
+  };
+  normalizeRequiredString = (value, fieldName) => {
+    if (typeof value !== "string" || !value.trim()) {
+      throw new Error(`${fieldName} must be a non-empty string`);
+    }
+    return value.trim();
+  };
+  normalizeCommand = command => {
+    if (command == null) {
+      return null;
+    }
+    return this.normalizeRequiredString(command, "command");
+  };
+  getHandlerKey = ({
+    pluginId,
+    eventName,
+    command = null
+  } = {}) => {
+    return JSON.stringify([this.normalizeRequiredString(pluginId, "pluginId"), this.normalizeRequiredString(eventName, "eventName"), this.normalizeCommand(command)]);
+  };
+  getHandlerSet = (key, create = false) => {
+    let handlers = this.handlers.get(key);
+    if (!handlers && create) {
+      handlers = new Set();
+      this.handlers.set(key, handlers);
+    }
+    return handlers || null;
+  };
+  addHandler = ({
+    pluginId,
+    eventName,
+    command
+  } = {}, handler) => {
+    if (typeof handler !== "function") {
+      throw new Error("handler must be a function");
+    }
+    this.getHandlerSet(this.getHandlerKey({
+      pluginId,
+      eventName,
+      command
+    }), true).add(handler);
+  };
+  removeHandler = ({
+    pluginId,
+    eventName,
+    command
+  } = {}, handler) => {
+    const key = this.getHandlerKey({
+      pluginId,
+      eventName,
+      command
+    });
+    const handlers = this.getHandlerSet(key, false);
+    if (!handlers) {
+      return false;
+    }
+    if (handler == null) {
+      handlers.clear();
+      this.handlers.delete(key);
+      return true;
+    }
+    const removed = handlers.delete(handler);
+    if (handlers.size === 0) {
+      this.handlers.delete(key);
+    }
+    return removed;
+  };
+  ensureInitialized = () => {
+    if (typeof window === "undefined" || this.isInitialized) {
+      return this;
+    }
+    window.PluginBridgeWeb = window.PluginBridgeWeb || {};
+    window.PluginBridgeWeb.callback = this.dispatchCallback;
+    window.PluginBridgeWeb.dispatch = message => {
+      let parsed = message;
+      if (typeof parsed === "string") {
+        try {
+          parsed = JSON.parse(parsed);
+        } catch {
+          return false;
+        }
+      }
+      if (!parsed || typeof parsed !== "object") {
+        return false;
+      }
+      const payload = Object.prototype.hasOwnProperty.call(parsed, "payload") ? parsed.payload : null;
+      return this.dispatchCallback(parsed.pluginId, parsed.eventName, payload, parsed.requestId ?? null, parsed.command ?? null);
+    };
+    this.isInitialized = true;
+    return this;
+  };
+  hasAndroidBridge = () => typeof window !== "undefined" && !!window.PluginBridge;
+  hasIOSBridge = () => typeof window !== "undefined" && !!window.webkit?.messageHandlers?.PluginBridge;
+  init = () => this.ensureInitialized();
+  assertInitialized = () => {
+    if (!this.isInitialized) {
+      throw new Error("PluginBridge.init() must be called before using emit() or register()");
+    }
+  };
+  reportHandlerError = error => {
+    if (typeof queueMicrotask === "function") {
+      queueMicrotask(() => {
+        throw error;
+      });
+      return;
+    }
+    setTimeout(() => {
+      throw error;
+    }, 0);
+  };
+  emit = ({
+    pluginId,
+    command,
+    data = null
+  } = {}) => {
+    const normalizedPluginId = this.normalizeRequiredString(pluginId, "pluginId");
+    const normalizedCommand = this.normalizeRequiredString(command, "command");
+    if (typeof window === "undefined") {
+      throw new Error("PluginBridge is not available in this environment");
+    }
+    this.assertInitialized();
+    const payload = {
+      pluginId: normalizedPluginId,
+      command: normalizedCommand,
+      data,
+      requestId: this.createRequestId()
+    };
+    if (this.hasAndroidBridge()) {
+      window.PluginBridge.emit(JSON.stringify(payload));
+      return;
+    }
+    if (this.hasIOSBridge()) {
+      window.webkit.messageHandlers.PluginBridge.postMessage(payload);
+      return;
+    }
+    throw new Error("PluginBridge is not available in this environment");
+  };
+  register = ({
+    pluginId,
+    eventName,
+    command,
+    handler
+  } = {}) => {
+    this.assertInitialized();
+    this.addHandler({
+      pluginId,
+      eventName,
+      command
+    }, handler);
+    return () => this.removeHandler({
+      pluginId,
+      eventName,
+      command
+    }, handler);
+  };
+  unregister = ({
+    pluginId,
+    eventName,
+    command,
+    handler
+  } = {}) => {
+    if (typeof handler !== "function") {
+      throw new Error("handler must be a function");
+    }
+    return this.removeHandler({
+      pluginId,
+      eventName,
+      command
+    }, handler);
+  };
+  dispatchCallback = (pluginId, eventName, payload, requestId = null, command = null) => {
+    void requestId;
+    const normalizedPluginId = typeof pluginId === "string" && pluginId.trim() ? pluginId.trim() : null;
+    const normalizedEventName = typeof eventName === "string" && eventName.trim() ? eventName.trim() : null;
+    if (normalizedPluginId == null || normalizedEventName == null) {
+      return false;
+    }
+    const normalizedCommand = typeof command === "string" && command.trim() ? command.trim() : null;
+    const toCall = new Set();
+    const collectHandlers = commandScope => {
+      const handlers = this.getHandlerSet(JSON.stringify([normalizedPluginId, normalizedEventName, commandScope]), false);
+      if (!handlers) {
+        return;
+      }
+      handlers.forEach(handler => {
+        toCall.add(handler);
+      });
+    };
+    if (normalizedCommand != null) {
+      collectHandlers(normalizedCommand);
+    }
+    collectHandlers(null);
+    if (toCall.size === 0) {
+      return false;
+    }
+    const meta = {
+      pluginId: normalizedPluginId,
+      eventName: normalizedEventName,
+      command: normalizedCommand
+    };
+    toCall.forEach(handler => {
+      try {
+        handler(payload, meta);
+      } catch (error) {
+        this.reportHandlerError(error);
+      }
+    });
+    return true;
+  };
+}
+const pluginNativeBridge = new PluginNativeBridge();
+var _default = exports.default = pluginNativeBridge;