@react-native-firebase/perf 26.3.3 → 27.0.0

package/ios/RNFBPerf/RNFBPerfModule.mm

@@ -15,30 +15,17 @@
  *
  */
 
-#import <React/RCTConvert.h>
-#import <React/RCTUtils.h>
-
-#if __has_include(<Firebase/Firebase.h>)
-#import <Firebase/Firebase.h>
-#define RNFB_PERF_SDK_AVAILABLE 1
-#elif __has_include(<FirebasePerformance/FirebasePerformance.h>)
-#import <FirebaseCore/FirebaseCore.h>
-#import <FirebasePerformance/FirebasePerformance.h>
-#define RNFB_PERF_SDK_AVAILABLE 1
-#else
-// Product headers absent (typical Mac Catalyst + SPM). Upstream Package.swift
-// omits .macCatalyst from FirebasePerformanceTarget; CocoaPods historically
-// masked this via the Firebase umbrella. Temporary stubs pending
-// https://github.com/firebase/firebase-ios-sdk/pull/16468 (or permanent if
-// upstream declines). Never fall through to @import in this .mm — that
-// requires -fcxx-modules and breaks RN C++/JSI.
-#define RNFB_PERF_SDK_AVAILABLE 0
-#endif
-#import "RNFBApp/RNFBSharedUtils.h"
+// This module intentionally has no Firebase imports and no `*-Swift.h` —
+// see RNFBPerfHelper.h. Every Firebase Performance touch (and the Swift
+// stop appliers / HTTP method mapper) is routed through the plain
+// Objective-C RNFBPerfHelper class instead, which can safely import Firebase
+// and the generated Swift interface because it compiles as ObjC, not ObjC++.
 #import "RNFBPerfModule.h"
+#import "RNFBPerfHandleRegistry.h"
+#import "RNFBPerfHelper.h"
 
-static __strong NSMutableDictionary *traces;
-static __strong NSMutableDictionary *httpMetrics;
+static RNFBPerfHandleRegistry *traces;
+static RNFBPerfHandleRegistry *httpMetrics;
 
 @implementation RNFBPerfModule
 
@@ -53,48 +40,20 @@ RCT_EXPORT_MODULE(NativeRNFBTurboPerf)
 
   static dispatch_once_t onceToken;
   dispatch_once(&onceToken, ^{
-    traces = [[NSMutableDictionary alloc] init];
-    httpMetrics = [[NSMutableDictionary alloc] init];
+    traces = [[RNFBPerfHandleRegistry alloc] init];
+    httpMetrics = [[RNFBPerfHandleRegistry alloc] init];
   });
 
   return self;
 }
 
 - (void)invalidate {
-  @synchronized([self class]) {
-    for (NSString *key in [traces allKeys]) {
-      [traces removeObjectForKey:key];
-    }
-
-    for (NSString *key in [httpMetrics allKeys]) {
-      [httpMetrics removeObjectForKey:key];
-    }
-  }
-}
-
-#if !RNFB_PERF_SDK_AVAILABLE
-- (void)rejectUnavailable:(RCTPromiseRejectBlock)reject {
-  [RNFBSharedUtils rejectPromiseWithUserInfo:reject
-                                    userInfo:(NSMutableDictionary *)@{
-                                      @"code" : @"unsupported",
-                                      @"message" : @"Firebase Performance is not available on "
-                                                   @"this platform or dependency configuration.",
-                                    }];
+  [traces takeAll];
+  [httpMetrics takeAll];
 }
-#endif
 
 - (NSDictionary *)perfConstantsDictionary {
-  NSMutableDictionary *constants = [NSMutableDictionary new];
-#if RNFB_PERF_SDK_AVAILABLE
-  constants[@"isPerformanceCollectionEnabled"] =
-      @([RCTConvert BOOL:@([FIRPerformance sharedInstance].dataCollectionEnabled)]);
-  constants[@"isInstrumentationEnabled"] =
-      @([RCTConvert BOOL:@([FIRPerformance sharedInstance].instrumentationEnabled)]);
-#else
-  constants[@"isPerformanceCollectionEnabled"] = @(NO);
-  constants[@"isInstrumentationEnabled"] = @(NO);
-#endif
-  return constants;
+  return [RNFBPerfHelper constantsDictionary];
 }
 
 - (facebook::react::ModuleConstants<JS::NativeRNFBTurboPerf::Constants>)constantsToExport {
@@ -113,71 +72,26 @@ RCT_EXPORT_MODULE(NativeRNFBTurboPerf)
 - (void)setPerformanceCollectionEnabled:(BOOL)enabled
                                 resolve:(RCTPromiseResolveBlock)resolve
                                  reject:(RCTPromiseRejectBlock)reject {
-#if RNFB_PERF_SDK_AVAILABLE
-  [FIRPerformance sharedInstance].dataCollectionEnabled = (BOOL)enabled;
-  resolve([NSNull null]);
-#else
-  (void)enabled;
-  (void)resolve;
-  [self rejectUnavailable:reject];
-#endif
+  [RNFBPerfHelper setPerformanceCollectionEnabled:enabled resolve:resolve reject:reject];
 }
 
 - (void)instrumentationEnabled:(BOOL)enabled
                        resolve:(RCTPromiseResolveBlock)resolve
                         reject:(RCTPromiseRejectBlock)reject {
-#if RNFB_PERF_SDK_AVAILABLE
-  [FIRPerformance sharedInstance].instrumentationEnabled = (BOOL)enabled;
-  resolve([NSNull null]);
-#else
-  (void)enabled;
-  (void)resolve;
-  [self rejectUnavailable:reject];
-#endif
+  [RNFBPerfHelper setInstrumentationEnabled:enabled resolve:resolve reject:reject];
 }
 
 - (void)startTrace:(double)id identifier:(NSString *)identifier {
-#if RNFB_PERF_SDK_AVAILABLE
-  FIRTrace *trace = [[FIRPerformance sharedInstance] traceWithName:identifier];
-  [trace start];
-
-  @synchronized([self class]) {
-    traces[@((int)id)] = trace;
-  }
-#else
-  (void)id;
-  (void)identifier;
-#endif
+  [RNFBPerfHelper startTraceWithId:@((int)id) identifier:identifier inRegistry:traces];
 }
 
 - (void)stopTrace:(double)id traceData:(JS::NativeRNFBTurboPerf::TraceData &)traceData {
-#if RNFB_PERF_SDK_AVAILABLE
-  FIRTrace *trace;
-  @synchronized([self class]) {
-    trace = traces[@((int)id)];
-  }
-
   NSDictionary *metrics = (NSDictionary *)traceData.metrics();
   NSDictionary *attributes = (NSDictionary *)traceData.attributes();
-
-  [metrics enumerateKeysAndObjectsUsingBlock:^(NSString *metricName, NSNumber *value, BOOL *stop) {
-    [trace setIntValue:[value longLongValue] forMetric:metricName];
-  }];
-
-  [attributes
-      enumerateKeysAndObjectsUsingBlock:^(NSString *attributeName, NSString *value, BOOL *stop) {
-        [trace setValue:value forAttribute:attributeName];
-      }];
-
-  [trace stop];
-
-  @synchronized([self class]) {
-    [traces removeObjectForKey:@((int)id)];
-  }
-#else
-  (void)id;
-  (void)traceData;
-#endif
+  [RNFBPerfHelper stopTraceWithId:@((int)id)
+                          metrics:metrics
+                       attributes:attributes
+                       inRegistry:traces];
 }
 
 - (void)startScreenTrace:(double)id identifier:(NSString *)identifier {
@@ -192,77 +106,30 @@ RCT_EXPORT_MODULE(NativeRNFBTurboPerf)
 }
 
 - (void)startHttpMetric:(double)id url:(NSString *)url httpMethod:(NSString *)httpMethod {
-#if RNFB_PERF_SDK_AVAILABLE
-  FIRHTTPMethod method = FIRHTTPMethodGET;
-  NSURL *toNSURL = [NSURL URLWithString:url];
-  if ([httpMethod compare:@"put" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodPUT;
-  if ([httpMethod compare:@"post" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodPOST;
-  if ([httpMethod compare:@"head" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodHEAD;
-  if ([httpMethod compare:@"trace" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodTRACE;
-  if ([httpMethod compare:@"patch" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodPATCH;
-  if ([httpMethod compare:@"delete" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodDELETE;
-  if ([httpMethod compare:@"options" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodOPTIONS;
-  if ([httpMethod compare:@"connect" options:NSCaseInsensitiveSearch] == NSOrderedSame)
-    method = FIRHTTPMethodCONNECT;
-
-  FIRHTTPMetric *httpMetric = [[FIRHTTPMetric alloc] initWithURL:toNSURL HTTPMethod:method];
-  [httpMetric start];
-
-  @synchronized([self class]) {
-    httpMetrics[@((int)id)] = httpMetric;
-  }
-#else
-  (void)id;
-  (void)url;
-  (void)httpMethod;
-#endif
+  [RNFBPerfHelper startHttpMetricWithId:@((int)id)
+                                    url:url
+                             httpMethod:httpMethod
+                             inRegistry:httpMetrics];
 }
 
 - (void)stopHttpMetric:(double)id metricData:(JS::NativeRNFBTurboPerf::HttpMetricData &)metricData {
-#if RNFB_PERF_SDK_AVAILABLE
-  FIRHTTPMetric *httpMetric;
-  @synchronized([self class]) {
-    httpMetric = httpMetrics[@((int)id)];
-  }
-
   NSDictionary *attributes = (NSDictionary *)metricData.attributes();
-  [attributes
-      enumerateKeysAndObjectsUsingBlock:^(NSString *attributeName, NSString *value, BOOL *stop) {
-        [httpMetric setValue:value forAttribute:attributeName];
-      }];
-
-  if (metricData.httpResponseCode().has_value()) {
-    [httpMetric setResponseCode:(NSInteger)metricData.httpResponseCode().value()];
-  }
-
-  if (metricData.requestPayloadSize().has_value()) {
-    [httpMetric setRequestPayloadSize:(NSInteger)metricData.requestPayloadSize().value()];
-  }
-
-  if (metricData.responsePayloadSize().has_value()) {
-    [httpMetric setResponsePayloadSize:(NSInteger)metricData.responsePayloadSize().value()];
-  }
-
-  if (metricData.responseContentType() != nil) {
-    [httpMetric setResponseContentType:metricData.responseContentType()];
-  }
-
-  [httpMetric stop];
-
-  @synchronized([self class]) {
-    [httpMetrics removeObjectForKey:@((int)id)];
-  }
-#else
-  (void)id;
-  (void)metricData;
-#endif
+  NSNumber *httpResponseCode = metricData.httpResponseCode().has_value()
+                                   ? @((NSInteger)metricData.httpResponseCode().value())
+                                   : nil;
+  NSNumber *requestPayloadSize = metricData.requestPayloadSize().has_value()
+                                     ? @((NSInteger)metricData.requestPayloadSize().value())
+                                     : nil;
+  NSNumber *responsePayloadSize = metricData.responsePayloadSize().has_value()
+                                      ? @((NSInteger)metricData.responsePayloadSize().value())
+                                      : nil;
+  [RNFBPerfHelper stopHttpMetricWithId:@((int)id)
+                            attributes:attributes
+                      httpResponseCode:httpResponseCode
+                    requestPayloadSize:requestPayloadSize
+                   responsePayloadSize:responsePayloadSize
+                   responseContentType:metricData.responseContentType()
+                            inRegistry:httpMetrics];
 }
 
 @end

package/ios/RNFBPerf/RNFBPerfTraceStopApplier.swift

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/**
+ * Subset of `FIRTrace` metric/attribute setters used by
+ * `-[RNFBPerfModule stopTrace:traceData:]`. Protocol-shaped so unit tests can
+ * stub without linking FirebasePerformance.
+ */
+@objc public protocol RNFBPerfTraceApplying: AnyObject {
+  @objc(setIntValue:forMetric:)
+  func setIntValue(_ value: Int64, forMetric metricName: String)
+
+  @objc(setValue:forAttribute:)
+  func setValue(_ value: String, forAttribute attributeName: String)
+}
+
+/**
+ * Applies `metrics` then `attributes` dictionaries previously enumerated inline
+ * in `-[RNFBPerfModule stopTrace:traceData:]`.
+ *
+ * Pre-port contracts:
+ * - metrics: `[trace setIntValue:[value longLongValue] forMetric:metricName]`
+ * - attributes: `[trace setValue:value forAttribute:attributeName]`
+ * - nil / missing dictionaries → empty (no crash)
+ * - order: metrics first, then attributes
+ */
+@objc(RNFBPerfTraceStopApplier)
+public final class RNFBPerfTraceStopApplier: NSObject {
+  @objc(applyMetrics:attributes:to:)
+  public static func apply(
+    metrics: NSDictionary?,
+    attributes: NSDictionary?,
+    to trace: RNFBPerfTraceApplying
+  ) {
+    if let metrics {
+      metrics.enumerateKeysAndObjects { key, value, _ in
+        guard let metricName = key as? String, let number = value as? NSNumber else {
+          return
+        }
+        trace.setIntValue(number.int64Value, forMetric: metricName)
+      }
+    }
+
+    if let attributes {
+      attributes.enumerateKeysAndObjects { key, value, _ in
+        guard let attributeName = key as? String, let stringValue = value as? String else {
+          return
+        }
+        trace.setValue(stringValue, forAttribute: attributeName)
+      }
+    }
+  }
+}

package/ios/RNFBPerf.xcodeproj/project.pbxproj

@@ -8,6 +8,12 @@
 
 /* Begin PBXBuildFile section */
 		2744B98621F45429004F8E3F /* RNFBPerfModule.mm in Sources */ = {isa = PBXBuildFile; fileRef = 2744B98521F45429004F8E3F /* RNFBPerfModule.mm */; };
+		RNFBPERF0000000000000001 /* RNFBPerfHandleRegistry.m in Sources */ = {isa = PBXBuildFile; fileRef = RNFBPERF0000000000000002 /* RNFBPerfHandleRegistry.m */; };
+		RNFBPERF0000000000000003 /* RNFBPerfHandleRegistryStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBPERF0000000000000004 /* RNFBPerfHandleRegistryStorage.swift */; };
+		RNFBPERF0000000000000006 /* RNFBPerfHttpMethodMapper.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBPERF0000000000000007 /* RNFBPerfHttpMethodMapper.swift */; };
+		RNFBPERF0000000000000008 /* RNFBPerfTraceStopApplier.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBPERF0000000000000009 /* RNFBPerfTraceStopApplier.swift */; };
+		RNFBPERF000000000000000A /* RNFBPerfHttpMetricStopApplier.swift in Sources */ = {isa = PBXBuildFile; fileRef = RNFBPERF000000000000000B /* RNFBPerfHttpMetricStopApplier.swift */; };
+		RNFBPERF000000000000000C /* RNFBPerfHelper.m in Sources */ = {isa = PBXBuildFile; fileRef = RNFBPERF000000000000000D /* RNFBPerfHelper.m */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXCopyFilesBuildPhase section */
@@ -26,6 +32,14 @@
 		2744B98221F45429004F8E3F /* libRNFBPerf.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libRNFBPerf.a; sourceTree = BUILT_PRODUCTS_DIR; };
 		2744B98421F45429004F8E3F /* RNFBPerfModule.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = RNFBPerfModule.h; path = RNFBPerf/RNFBPerfModule.h; sourceTree = SOURCE_ROOT; };
 		2744B98521F45429004F8E3F /* RNFBPerfModule.mm */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = RNFBPerfModule.mm; path = RNFBPerf/RNFBPerfModule.mm; sourceTree = SOURCE_ROOT; };
+		RNFBPERF0000000000000005 /* RNFBPerfHandleRegistry.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = RNFBPerfHandleRegistry.h; path = RNFBPerf/RNFBPerfHandleRegistry.h; sourceTree = SOURCE_ROOT; };
+		RNFBPERF0000000000000002 /* RNFBPerfHandleRegistry.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = RNFBPerfHandleRegistry.m; path = RNFBPerf/RNFBPerfHandleRegistry.m; sourceTree = SOURCE_ROOT; };
+		RNFBPERF0000000000000004 /* RNFBPerfHandleRegistryStorage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBPerfHandleRegistryStorage.swift; path = RNFBPerf/RNFBPerfHandleRegistryStorage.swift; sourceTree = SOURCE_ROOT; };
+		RNFBPERF0000000000000007 /* RNFBPerfHttpMethodMapper.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBPerfHttpMethodMapper.swift; path = RNFBPerf/RNFBPerfHttpMethodMapper.swift; sourceTree = SOURCE_ROOT; };
+		RNFBPERF0000000000000009 /* RNFBPerfTraceStopApplier.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBPerfTraceStopApplier.swift; path = RNFBPerf/RNFBPerfTraceStopApplier.swift; sourceTree = SOURCE_ROOT; };
+		RNFBPERF000000000000000B /* RNFBPerfHttpMetricStopApplier.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = RNFBPerfHttpMetricStopApplier.swift; path = RNFBPerf/RNFBPerfHttpMetricStopApplier.swift; sourceTree = SOURCE_ROOT; };
+		RNFBPERF000000000000000E /* RNFBPerfHelper.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = RNFBPerfHelper.h; path = RNFBPerf/RNFBPerfHelper.h; sourceTree = SOURCE_ROOT; };
+		RNFBPERF000000000000000D /* RNFBPerfHelper.m */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.objc; name = RNFBPerfHelper.m; path = RNFBPerf/RNFBPerfHelper.m; sourceTree = SOURCE_ROOT; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -52,6 +66,14 @@
 			children = (
 				2744B9A121F48736004F8E3F /* converters */,
 				2744B98C21F45C64004F8E3F /* common */,
+				RNFBPERF0000000000000005 /* RNFBPerfHandleRegistry.h */,
+				RNFBPERF0000000000000002 /* RNFBPerfHandleRegistry.m */,
+				RNFBPERF0000000000000004 /* RNFBPerfHandleRegistryStorage.swift */,
+				RNFBPERF0000000000000007 /* RNFBPerfHttpMethodMapper.swift */,
+				RNFBPERF0000000000000009 /* RNFBPerfTraceStopApplier.swift */,
+				RNFBPERF000000000000000B /* RNFBPerfHttpMetricStopApplier.swift */,
+				RNFBPERF000000000000000E /* RNFBPerfHelper.h */,
+				RNFBPERF000000000000000D /* RNFBPerfHelper.m */,
 				2744B98421F45429004F8E3F /* RNFBPerfModule.h */,
 				2744B98521F45429004F8E3F /* RNFBPerfModule.mm */,
 			);
@@ -124,6 +146,12 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				RNFBPERF0000000000000003 /* RNFBPerfHandleRegistryStorage.swift in Sources */,
+				RNFBPERF0000000000000006 /* RNFBPerfHttpMethodMapper.swift in Sources */,
+				RNFBPERF0000000000000008 /* RNFBPerfTraceStopApplier.swift in Sources */,
+				RNFBPERF000000000000000A /* RNFBPerfHttpMetricStopApplier.swift in Sources */,
+				RNFBPERF0000000000000001 /* RNFBPerfHandleRegistry.m in Sources */,
+				RNFBPERF000000000000000C /* RNFBPerfHelper.m in Sources */,
 				2744B98621F45429004F8E3F /* RNFBPerfModule.mm in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
@@ -150,6 +178,7 @@
 				CODE_SIGN_STYLE = Automatic;
 				COPY_PHASE_STRIP = NO;
 				DEBUG_INFORMATION_FORMAT = dwarf;
+				DEFINES_MODULE = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_DYNAMIC_NO_PIC = NO;
 				GCC_OPTIMIZATION_LEVEL = 0;
@@ -166,6 +195,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.10;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Debug;
@@ -189,6 +219,7 @@
 				CODE_SIGN_STYLE = Automatic;
 				COPY_PHASE_STRIP = NO;
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				DEFINES_MODULE = YES;
 				ENABLE_NS_ASSERTIONS = NO;
 				GCC_C_LANGUAGE_STANDARD = gnu11;
 				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
@@ -200,6 +231,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SDKROOT = iphoneos;
 				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.10;
 				TARGETED_DEVICE_FAMILY = "1,2";
 				VALIDATE_PRODUCT = YES;
 			};

package/ios/RNFBPerfUnitTests/HostStubs/Firebase/FIRPerformanceHostStub.m

@@ -0,0 +1,170 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import <Firebase/Firebase.h>
+
+@implementation FIRTrace {
+  NSString *_name;
+  NSMutableDictionary<NSString *, NSNumber *> *_metrics;
+  NSMutableDictionary<NSString *, NSString *> *_attributes;
+}
+
+- (instancetype)initWithName:(NSString *)name {
+  self = [super init];
+  if (self) {
+    _name = [name copy];
+    _metrics = [NSMutableDictionary new];
+    _attributes = [NSMutableDictionary new];
+  }
+  return self;
+}
+
+- (NSString *)name {
+  return _name;
+}
+
+- (NSMutableDictionary<NSString *, NSNumber *> *)metrics {
+  return _metrics;
+}
+
+- (NSMutableDictionary<NSString *, NSString *> *)attributes {
+  return _attributes;
+}
+
+- (void)start {
+  self.startCallCount += 1;
+}
+
+- (void)stop {
+  self.stopCallCount += 1;
+}
+
+- (void)setIntValue:(int64_t)value forMetric:(NSString *)metricName {
+  _metrics[metricName] = @(value);
+}
+
+- (void)setValue:(NSString *)value forAttribute:(NSString *)attributeName {
+  _attributes[attributeName] = value;
+}
+
+@end
+
+@implementation FIRHTTPMetric {
+  NSURL *_url;
+  FIRHTTPMethod _HTTPMethod;
+  NSMutableDictionary<NSString *, NSString *> *_attributes;
+}
+
+- (instancetype)initWithURL:(NSURL *)url HTTPMethod:(FIRHTTPMethod)httpMethod {
+  self = [super init];
+  if (self) {
+    _url = url;
+    _HTTPMethod = httpMethod;
+    _attributes = [NSMutableDictionary new];
+    _responseCode = 0;
+    _requestPayloadSize = 0;
+    _responsePayloadSize = 0;
+    [FIRPerformance recordCreatedHttpMetric:self];
+  }
+  return self;
+}
+
+- (NSURL *)url {
+  return _url;
+}
+
+- (FIRHTTPMethod)HTTPMethod {
+  return _HTTPMethod;
+}
+
+- (NSMutableDictionary<NSString *, NSString *> *)attributes {
+  return _attributes;
+}
+
+- (void)start {
+  self.startCallCount += 1;
+}
+
+- (void)stop {
+  self.stopCallCount += 1;
+}
+
+- (void)setValue:(NSString *)value forAttribute:(NSString *)attributeName {
+  _attributes[attributeName] = value;
+}
+
+- (void)setResponseCode:(NSInteger)responseCode {
+  _responseCode = responseCode;
+}
+
+- (void)setRequestPayloadSize:(NSInteger)bytes {
+  _requestPayloadSize = bytes;
+}
+
+- (void)setResponsePayloadSize:(NSInteger)bytes {
+  _responsePayloadSize = bytes;
+}
+
+- (void)setResponseContentType:(NSString *)contentType {
+  _responseContentType = [contentType copy];
+}
+
+@end
+
+@implementation FIRPerformance
+
+static FIRPerformance *sShared;
+static NSMutableArray<FIRTrace *> *sCreatedTraces;
+static NSMutableArray<FIRHTTPMetric *> *sCreatedHttpMetrics;
+
++ (void)initialize {
+  if (self == [FIRPerformance class]) {
+    sCreatedTraces = [NSMutableArray new];
+    sCreatedHttpMetrics = [NSMutableArray new];
+  }
+}
+
++ (instancetype)sharedInstance {
+  static dispatch_once_t once;
+  dispatch_once(&once, ^{
+    sShared = [[FIRPerformance alloc] init];
+  });
+  return sShared;
+}
+
+- (FIRTrace *)traceWithName:(NSString *)name {
+  FIRTrace *trace = [[FIRTrace alloc] initWithName:name];
+  [sCreatedTraces addObject:trace];
+  return trace;
+}
+
++ (NSArray<FIRTrace *> *)createdTraces {
+  return [sCreatedTraces copy];
+}
+
++ (void)setCreatedTraces:(NSArray<FIRTrace *> *)createdTraces {
+  sCreatedTraces = createdTraces ? [createdTraces mutableCopy] : [NSMutableArray new];
+}
+
++ (NSArray<FIRHTTPMetric *> *)createdHttpMetrics {
+  return [sCreatedHttpMetrics copy];
+}
+
++ (void)setCreatedHttpMetrics:(NSArray<FIRHTTPMetric *> *)createdHttpMetrics {
+  sCreatedHttpMetrics =
+      createdHttpMetrics ? [createdHttpMetrics mutableCopy] : [NSMutableArray new];
+}
+
++ (void)recordCreatedHttpMetric:(FIRHTTPMetric *)metric {
+  [sCreatedHttpMetrics addObject:metric];
+}
+
++ (void)resetTestState {
+  FIRPerformance *shared = [self sharedInstance];
+  shared.dataCollectionEnabled = NO;
+  shared.instrumentationEnabled = NO;
+  [sCreatedTraces removeAllObjects];
+  [sCreatedHttpMetrics removeAllObjects];
+}
+
+@end

package/ios/RNFBPerfUnitTests/HostStubs/Firebase/Firebase.h

@@ -0,0 +1,75 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ * Enough of Firebase Performance for compiling RNFBPerfHelper.m and
+ * asserting SDK call wiring without linking the real SDK.
+ */
+#import <Foundation/Foundation.h>
+
+typedef NS_ENUM(NSInteger, FIRHTTPMethod) {
+  FIRHTTPMethodGET = 0,
+  FIRHTTPMethodPUT = 1,
+  FIRHTTPMethodPOST = 2,
+  FIRHTTPMethodDELETE = 3,
+  FIRHTTPMethodHEAD = 4,
+  FIRHTTPMethodPATCH = 5,
+  FIRHTTPMethodOPTIONS = 6,
+  FIRHTTPMethodTRACE = 7,
+  FIRHTTPMethodCONNECT = 8,
+};
+
+@interface FIRTrace : NSObject
+
+@property(nonatomic, readonly, copy) NSString *name;
+@property(nonatomic, assign) NSUInteger startCallCount;
+@property(nonatomic, assign) NSUInteger stopCallCount;
+@property(nonatomic, readonly, strong) NSMutableDictionary<NSString *, NSNumber *> *metrics;
+@property(nonatomic, readonly, strong) NSMutableDictionary<NSString *, NSString *> *attributes;
+
+- (instancetype)initWithName:(NSString *)name;
+- (void)start;
+- (void)stop;
+- (void)setIntValue:(int64_t)value forMetric:(NSString *)metricName;
+- (void)setValue:(NSString *)value forAttribute:(NSString *)attributeName;
+
+@end
+
+@interface FIRHTTPMetric : NSObject
+
+@property(nonatomic, readonly, copy) NSURL *url;
+@property(nonatomic, readonly, assign) FIRHTTPMethod HTTPMethod;
+@property(nonatomic, assign) NSUInteger startCallCount;
+@property(nonatomic, assign) NSUInteger stopCallCount;
+@property(nonatomic, assign) NSInteger responseCode;
+@property(nonatomic, assign) NSInteger requestPayloadSize;
+@property(nonatomic, assign) NSInteger responsePayloadSize;
+@property(nonatomic, copy, nullable) NSString *responseContentType;
+@property(nonatomic, readonly, strong) NSMutableDictionary<NSString *, NSString *> *attributes;
+
+- (instancetype)initWithURL:(NSURL *)url HTTPMethod:(FIRHTTPMethod)httpMethod;
+- (void)start;
+- (void)stop;
+- (void)setValue:(NSString *)value forAttribute:(NSString *)attributeName;
+- (void)setResponseCode:(NSInteger)responseCode;
+- (void)setRequestPayloadSize:(NSInteger)bytes;
+- (void)setResponsePayloadSize:(NSInteger)bytes;
+- (void)setResponseContentType:(NSString *)contentType;
+
+@end
+
+@interface FIRPerformance : NSObject
+
+@property(nonatomic, assign) BOOL dataCollectionEnabled;
+@property(nonatomic, assign) BOOL instrumentationEnabled;
+
++ (instancetype)sharedInstance;
+
+- (FIRTrace *)traceWithName:(NSString *)name;
+
+/** Test seams */
+@property(class, nonatomic, copy, nullable) NSArray<FIRTrace *> *createdTraces;
+@property(class, nonatomic, copy, nullable) NSArray<FIRHTTPMetric *> *createdHttpMetrics;
+
++ (void)resetTestState;
++ (void)recordCreatedHttpMetric:(FIRHTTPMetric *)metric;
+
+@end

package/ios/RNFBPerfUnitTests/HostStubs/RNFBApp/RNFBSharedUtils.h

@@ -0,0 +1,12 @@
+/**
+ * Host-only stub for macOS XCTest. Not shipped in the production pod.
+ */
+#import <Foundation/Foundation.h>
+#import <React/RCTBridgeModule.h>
+
+@interface RNFBSharedUtils : NSObject
+
++ (void)rejectPromiseWithUserInfo:(RCTPromiseRejectBlock)reject
+                         userInfo:(NSMutableDictionary *)userInfo;
+
+@end