Bootstrap Fusebox NetworkReporter API

Summary:
Bootstraps the `NetworkReporter` API and `jsinspector_network` library. This will form the common C++ logic for Network Inspection in React Native DevTools.

Changelog: [Internal]

Differential Revision: D70554862

Author: huntie

packages/react-native/ReactAndroid/src/main/jni/CMakeLists.txt

@@ -70,6 +70,7 @@ add_react_common_subdir(jsi)
 add_react_common_subdir(callinvoker)
 add_react_common_subdir(oscompat)
 add_react_common_subdir(jsinspector-modern)
+add_react_common_subdir(jsinspector-modern/network)
 add_react_common_subdir(jsinspector-modern/tracing)
 add_react_common_subdir(hermes/executor)
 add_react_common_subdir(hermes/inspector-modern)
@@ -167,6 +168,7 @@ add_library(reactnative
           $<TARGET_OBJECTS:jserrorhandler>
           $<TARGET_OBJECTS:jsinspector>
           $<TARGET_OBJECTS:jsitooling>
+          $<TARGET_OBJECTS:jsinspector_network>
           $<TARGET_OBJECTS:jsinspector_tracing>
           $<TARGET_OBJECTS:jsireact>
           $<TARGET_OBJECTS:logger>
@@ -254,6 +256,7 @@ target_include_directories(reactnative
         $<TARGET_PROPERTY:glog_init,INTERFACE_INCLUDE_DIRECTORIES>
         $<TARGET_PROPERTY:jserrorhandler,INTERFACE_INCLUDE_DIRECTORIES>
         $<TARGET_PROPERTY:jsinspector,INTERFACE_INCLUDE_DIRECTORIES>
+        $<TARGET_PROPERTY:jsinspector_network,INTERFACE_INCLUDE_DIRECTORIES>
         $<TARGET_PROPERTY:jsinspector_tracing,INTERFACE_INCLUDE_DIRECTORIES>
         $<TARGET_PROPERTY:jsireact,INTERFACE_INCLUDE_DIRECTORIES>
         $<TARGET_PROPERTY:mapbufferjni,INTERFACE_INCLUDE_DIRECTORIES>

packages/react-native/ReactCommon/jsinspector-modern/CMakeLists.txt

@@ -21,6 +21,7 @@ target_include_directories(jsinspector PUBLIC ${REACT_COMMON_DIR})
 target_link_libraries(jsinspector
         folly_runtime
         glog
+        jsinspector_network
         jsinspector_tracing
         react_featureflags
         runtimeexecutor

packages/react-native/ReactCommon/jsinspector-modern/NetworkIOAgent.cpp

@@ -11,7 +11,11 @@
 #include "Base64.h"
 #include "Utf8.h"
 
+#include <jsinspector-modern/network/NetworkReporter.h>
+
+#include <sstream>
 #include <utility>
+#include <variant>
 
 namespace facebook::react::jsinspector_modern {
 
@@ -267,7 +271,16 @@ bool NetworkIOAgent::handleRequest(
   }
 
   if (InspectorFlags::getInstance().getNetworkInspectionEnabled()) {
+    // @cdp Network.enable support is experimental.
     if (req.method == "Network.enable") {
+      NetworkReporter::getInstance().enableDebugging();
+      frontendChannel_(cdp::jsonResult(req.id));
+      return true;
+    }
+
+    // @cdp Network.disable support is experimental.
+    if (req.method == "Network.disable") {
+      NetworkReporter::getInstance().disableDebugging();
       frontendChannel_(cdp::jsonResult(req.id));
       return true;
     }

packages/react-native/ReactCommon/jsinspector-modern/NetworkIOAgent.h

@@ -12,12 +12,9 @@
 #include "ScopedExecutor.h"
 
 #include <folly/dynamic.h>
-#include <mutex>
-#include <sstream>
 #include <string>
 #include <unordered_map>
 #include <utility>
-#include <variant>
 
 namespace facebook::react::jsinspector_modern {
 

packages/react-native/ReactCommon/jsinspector-modern/React-jsinspector.podspec

@@ -64,6 +64,7 @@ Pod::Spec.new do |s|
   s.dependency "DoubleConversion"
   s.dependency "React-runtimeexecutor", version
   s.dependency "React-jsi"
+  add_dependency(s, "React-jsinspectornetwork", :framework_name => 'jsinspector_modernnetwork')
   add_dependency(s, "React-jsinspectortracing", :framework_name => 'jsinspector_moderntracing')
   s.dependency "React-perflogger", version
   if ENV["USE_HERMES"] == nil || ENV["USE_HERMES"] == "1"

packages/react-native/ReactCommon/jsinspector-modern/network/CMakeLists.txt

@@ -0,0 +1,27 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+
+include(${REACT_ANDROID_DIR}/src/main/jni/first-party/jni-lib-merge/SoMerging-utils.cmake)
+
+add_compile_options(
+        -fexceptions
+        -std=c++20
+        -Wall
+        -Wpedantic)
+
+file(GLOB jsinspector_network_SRC CONFIGURE_DEPENDS *.cpp)
+
+add_library(jsinspector_network OBJECT ${jsinspector_network_SRC})
+target_merge_so(jsinspector_network)
+
+target_include_directories(jsinspector_network PUBLIC ${REACT_COMMON_DIR})
+
+target_link_libraries(jsinspector_network
+        folly_runtime
+        glog
+)

packages/react-native/ReactCommon/jsinspector-modern/network/NetworkReporter.cpp

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#include "NetworkReporter.h"
+
+#include <glog/logging.h>
+
+namespace facebook::react::jsinspector_modern {
+
+NetworkReporter& NetworkReporter::getInstance() {
+  static NetworkReporter tracer;
+  return tracer;
+}
+
+bool NetworkReporter::enableDebugging() {
+  std::lock_guard lock(mutex_);
+  if (enabled_) {
+    return false;
+  }
+
+  enabled_ = true;
+  LOG(INFO) << "Network debugging enabled" << std::endl;
+  return true;
+}
+
+bool NetworkReporter::disableDebugging() {
+  std::lock_guard lock(mutex_);
+  if (!enabled_) {
+    return false;
+  }
+
+  enabled_ = false;
+  LOG(INFO) << "Network debugging disabled" << std::endl;
+  return true;
+}
+
+} // namespace facebook::react::jsinspector_modern

packages/react-native/ReactCommon/jsinspector-modern/network/NetworkReporter.h

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#pragma once
+
+#include <mutex>
+
+namespace facebook::react::jsinspector_modern {
+
+/**
+ * [Experimental] An interface for reporting network events to the modern
+ * debugger server and Web Performance APIs.
+ */
+class NetworkReporter {
+ public:
+  static NetworkReporter& getInstance();
+
+  /**
+   * Enable network tracking over CDP. Once enabled, network events will be
+   * sent to the debugger client. Returns `false` if already enabled.
+   *
+   * Corresponds to @cdp `Network.enable`.
+   */
+  bool enableDebugging();
+
+  /**
+   * Disable network tracking over CDP, preventing network events from being
+   * sent to the debugger client. Returns `false` if not initially enabled.
+   *
+   * Corresponds to @cdp `Network.disable`.
+   */
+  bool disableDebugging();
+
+ private:
+  NetworkReporter() = default;
+  NetworkReporter(const NetworkReporter&) = delete;
+  NetworkReporter& operator=(const NetworkReporter&) = delete;
+  ~NetworkReporter() = default;
+
+  bool enabled_{false};
+  std::mutex mutex_;
+};
+
+} // namespace facebook::react::jsinspector_modern

packages/react-native/ReactCommon/jsinspector-modern/network/React-jsinspectornetwork.podspec

@@ -0,0 +1,57 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "..", "..", "..", "package.json")))
+version = package['version']
+
+source = { :git => 'https://github.com/facebook/react-native.git' }
+if version == '1000.0.0'
+  # This is an unpublished version, use the latest commit hash of the react-native repo, which we’re presumably in.
+  source[:commit] = `git rev-parse HEAD`.strip if system("git rev-parse --git-dir > /dev/null 2>&1")
+else
+  source[:tag] = "v#{version}"
+end
+
+folly_config = get_folly_config()
+folly_compiler_flags = folly_config[:compiler_flags]
+
+header_search_paths = [
+  "\"$(PODS_ROOT)/RCT-Folly\"",
+]
+
+if ENV['USE_FRAMEWORKS']
+  header_search_paths << "\"$(PODS_TARGET_SRCROOT)/../..\""
+end
+
+header_dir = 'jsinspector-modern/network'
+module_name = "jsinspector_modernnetwork"
+
+Pod::Spec.new do |s|
+  s.name                   = "React-jsinspectornetwork"
+  s.version                = version
+  s.summary                = "Network inspection for React Native DevTools"
+  s.homepage               = "https://reactnative.dev/"
+  s.license                = package["license"]
+  s.author                 = "Meta Platforms, Inc. and its affiliates"
+  s.platforms              = min_supported_versions
+  s.source                 = source
+  s.source_files           = "*.{cpp,h}"
+  s.header_dir             = header_dir
+  s.compiler_flags         = folly_compiler_flags
+  s.pod_target_xcconfig    = {
+    "HEADER_SEARCH_PATHS" => header_search_paths.join(' '),
+    "CLANG_CXX_LANGUAGE_STANDARD" => rct_cxx_language_standard(),
+    "DEFINES_MODULE" => "YES"}
+
+  if ENV['USE_FRAMEWORKS']
+    s.module_name = module_name
+    s.header_mappings_dir = "../.."
+  end
+
+  s.dependency "glog"
+  s.dependency "RCT-Folly"
+end

packages/react-native/scripts/react_native_pods.rb

@@ -146,6 +146,7 @@ def use_react_native! (
   pod 'React-jsiexecutor', :path => "#{prefix}/ReactCommon/jsiexecutor"
   pod 'React-jsinspector', :path => "#{prefix}/ReactCommon/jsinspector-modern"
   pod 'React-jsitooling', :path => "#{prefix}/ReactCommon/jsitooling"
+  pod 'React-jsinspectornetwork', :path => "#{prefix}/ReactCommon/jsinspector-modern/network"
   pod 'React-jsinspectortracing', :path => "#{prefix}/ReactCommon/jsinspector-modern/tracing"
 
   pod 'React-callinvoker', :path => "#{prefix}/ReactCommon/callinvoker"