@react-native-firebase/app 26.3.3 → 27.0.0

package/ios/RNFBAppUnitTests/RNFBSharedUtilsConfigTests.swift

@@ -0,0 +1,234 @@
+/**
+ * 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
+import XCTest
+
+private final class RecordingConfigSource: NSObject, RNFBConfigBooleanProviding {
+  var containsCalls: [String] = []
+  var getBooleanCalls: [(key: String, defaultValue: Bool)] = []
+  var containsResult = false
+  var booleanResult = false
+  /// When true, `getBooleanValue` returns the passed-in `defaultValue` (Meta missing-key path).
+  var echoDefaultValue = false
+
+  func contains(_ key: String) -> Bool {
+    containsCalls.append(key)
+    return containsResult
+  }
+
+  func getBooleanValue(_ key: String, defaultValue: Bool) -> Bool {
+    getBooleanCalls.append((key, defaultValue))
+    if echoDefaultValue {
+      return defaultValue
+    }
+    return booleanResult
+  }
+}
+
+final class RNFBSharedUtilsConfigTests: XCTestCase {
+  private let key = "rnfb.config.waterfall.test"
+
+  func testConfigContainsIsOrOfPreferencesJsonMeta() {
+    let preferences = RecordingConfigSource()
+    let json = RecordingConfigSource()
+    let meta = RecordingConfigSource()
+
+    preferences.containsResult = false
+    json.containsResult = false
+    meta.containsResult = false
+    XCTAssertFalse(
+      RNFBSharedUtilsConfig.configContains(
+        key,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+
+    meta.containsResult = true
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.configContains(
+        key,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+
+    json.containsResult = true
+    meta.containsResult = false
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.configContains(
+        key,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+
+    preferences.containsResult = true
+    json.containsResult = false
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.configContains(
+        key,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+  }
+
+  func testConfigContainsShortCircuitsLeftToRight() {
+    let preferences = RecordingConfigSource()
+    let json = RecordingConfigSource()
+    let meta = RecordingConfigSource()
+    preferences.containsResult = true
+
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.configContains(
+        key,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertEqual(preferences.containsCalls, [key])
+    XCTAssertTrue(json.containsCalls.isEmpty)
+    XCTAssertTrue(meta.containsCalls.isEmpty)
+
+    preferences.containsResult = false
+    json.containsResult = true
+    preferences.containsCalls.removeAll()
+    json.containsCalls.removeAll()
+    meta.containsCalls.removeAll()
+
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.configContains(
+        key,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertEqual(preferences.containsCalls, [key])
+    XCTAssertEqual(json.containsCalls, [key])
+    XCTAssertTrue(meta.containsCalls.isEmpty)
+  }
+
+  func testGetConfigBooleanValuePreferencesWinsOverJsonAndMeta() {
+    let preferences = RecordingConfigSource()
+    let json = RecordingConfigSource()
+    let meta = RecordingConfigSource()
+    preferences.containsResult = true
+    preferences.booleanResult = true
+    json.containsResult = true
+    json.booleanResult = false
+    meta.containsResult = true
+    meta.booleanResult = false
+
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.getConfigBooleanValue(
+        forKey: key,
+        defaultValue: false,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertEqual(preferences.getBooleanCalls.count, 1)
+    XCTAssertTrue(json.getBooleanCalls.isEmpty)
+    XCTAssertTrue(meta.getBooleanCalls.isEmpty)
+  }
+
+  func testGetConfigBooleanValueJsonWinsOverMeta() {
+    let preferences = RecordingConfigSource()
+    let json = RecordingConfigSource()
+    let meta = RecordingConfigSource()
+    preferences.containsResult = false
+    json.containsResult = true
+    json.booleanResult = true
+    meta.containsResult = true
+    meta.booleanResult = false
+
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.getConfigBooleanValue(
+        forKey: key,
+        defaultValue: false,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertTrue(preferences.getBooleanCalls.isEmpty)
+    XCTAssertEqual(json.getBooleanCalls.count, 1)
+    XCTAssertTrue(meta.getBooleanCalls.isEmpty)
+  }
+
+  func testGetConfigBooleanValueMetaPathUsesPassedInDefault() {
+    let preferences = RecordingConfigSource()
+    let json = RecordingConfigSource()
+    let meta = RecordingConfigSource()
+    preferences.containsResult = false
+    json.containsResult = false
+    // Meta missing-key path forwards the caller defaultValue.
+    meta.echoDefaultValue = true
+
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.getConfigBooleanValue(
+        forKey: key,
+        defaultValue: true,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertFalse(
+      RNFBSharedUtilsConfig.getConfigBooleanValue(
+        forKey: key,
+        defaultValue: false,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertEqual(meta.getBooleanCalls.count, 2)
+    XCTAssertEqual(meta.getBooleanCalls[0].defaultValue, true)
+    XCTAssertEqual(meta.getBooleanCalls[1].defaultValue, false)
+    XCTAssertTrue(preferences.getBooleanCalls.isEmpty)
+    XCTAssertTrue(json.getBooleanCalls.isEmpty)
+  }
+
+  func testGetConfigBooleanValueMetaPathReturnsSourceValue() {
+    let preferences = RecordingConfigSource()
+    let json = RecordingConfigSource()
+    let meta = RecordingConfigSource()
+    preferences.containsResult = false
+    json.containsResult = false
+    meta.booleanResult = true
+
+    XCTAssertTrue(
+      RNFBSharedUtilsConfig.getConfigBooleanValue(
+        forKey: key,
+        defaultValue: false,
+        preferences: preferences,
+        json: json,
+        meta: meta
+      )
+    )
+    XCTAssertEqual(meta.getBooleanCalls[0].defaultValue, false)
+  }
+}

package/ios/RNFBAppUnitTests/RNFBSharedUtilsFIRAppFacadeTests.m

@@ -0,0 +1,145 @@
+/**
+ * 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 <XCTest/XCTest.h>
+
+#import <React/RCTBridge.h>
+
+#import "FirebaseCore/FirebaseCore.h"
+#import "RNFBAppModule.h"
+#import "RNFBHandleMapStorage-Swift.inc"
+#import "RNFBRCTEventEmitter.h"
+#import "RNFBSharedUtils.h"
+
+@interface RNFBAppModule (Testing)
++ (void)setCustomDomainForTesting:(NSString *)domain forAppName:(NSString *)appName;
++ (void)resetCustomDomainsForTesting;
+@end
+
+@interface RNFBSharedUtilsFIRAppFacadeTests : XCTestCase
+@end
+
+@implementation RNFBSharedUtilsFIRAppFacadeTests
+
+- (FIROptions *)fullyPopulatedOptions {
+  FIROptions *options = [[FIROptions alloc] init];
+  options.APIKey = @"api-key";
+  options.googleAppID = @"app-id";
+  options.projectID = @"project-id";
+  options.databaseURL = @"https://example.firebaseio.com";
+  options.storageBucket = @"example.appspot.com";
+  options.GCMSenderID = @"sender-id";
+  options.clientID = @"client-id";
+  return options;
+}
+
+- (void)tearDown {
+  [RNFBAppModule resetCustomDomainsForTesting];
+  RNFBRCTEventEmitter *emitter = [RNFBRCTEventEmitter shared];
+  // Rebuild a core whose bridge/emit closures capture *shared*, not a disposable
+  // template (stealing template.core leaves dangling weakSelf → permanent queue-only).
+  __weak RNFBRCTEventEmitter *weakEmitter = emitter;
+  RNFBRCTEventEmitterCore *restoredCore = [[RNFBRCTEventEmitterCore alloc]
+      initWithIsBridgePresent:^BOOL {
+        return weakEmitter.bridge != nil;
+      }
+      emitHandler:^(NSString *eventName, id body) {
+        __strong RNFBRCTEventEmitter *strongEmitter = weakEmitter;
+        NSString *prefixedEventName = [@"rnfb_" stringByAppendingString:eventName];
+        [strongEmitter.bridge
+            enqueueJSCall:@"RCTDeviceEventEmitter"
+                   method:@"emit"
+                     args:body ? @[ prefixedEventName, body ] : @[ prefixedEventName ]
+               completion:NULL];
+      }];
+  [emitter setValue:restoredCore forKey:@"core"];
+  [emitter invalidate];
+  emitter.bridge = nil;
+  [super tearDown];
+}
+
+- (void)testFacadeDefaultNameMappingAndOptions {
+  FIRApp *app = [[FIRApp alloc] initWithName:DEFAULT_APP_NAME options:[self fullyPopulatedOptions]];
+  [app setDataCollectionDefaultEnabled:YES];
+
+  NSDictionary *result = [RNFBSharedUtils firAppToDictionary:app];
+  NSDictionary *appConfig = result[@"appConfig"];
+  NSDictionary *options = result[@"options"];
+
+  XCTAssertEqualObjects(appConfig[@"name"], DEFAULT_APP_DISPLAY_NAME);
+  XCTAssertEqualObjects(appConfig[@"automaticDataCollectionEnabled"], @YES);
+  XCTAssertEqualObjects(options[@"apiKey"], @"api-key");
+  XCTAssertEqualObjects(options[@"appId"], @"app-id");
+  XCTAssertEqualObjects(options[@"projectId"], @"project-id");
+  XCTAssertEqualObjects(options[@"databaseURL"], @"https://example.firebaseio.com");
+  XCTAssertEqualObjects(options[@"storageBucket"], @"example.appspot.com");
+  XCTAssertEqualObjects(options[@"messagingSenderId"], @"sender-id");
+  XCTAssertEqualObjects(options[@"clientId"], @"client-id");
+  XCTAssertNil(options[@"authDomain"]);
+}
+
+- (void)testFacadeAuthDomainPresentAndAbsent {
+  FIRApp *app = [[FIRApp alloc] initWithName:@"secondary" options:[self fullyPopulatedOptions]];
+
+  NSDictionary *withoutDomain = [RNFBSharedUtils firAppToDictionary:app];
+  XCTAssertNil(withoutDomain[@"options"][@"authDomain"]);
+
+  [RNFBAppModule setCustomDomainForTesting:@"custom.example.com" forAppName:@"secondary"];
+  NSDictionary *withDomain = [RNFBSharedUtils firAppToDictionary:app];
+  XCTAssertEqualObjects(withDomain[@"options"][@"authDomain"], @"custom.example.com");
+}
+
+- (void)testFacadeAuthDomainUsesMappedDefaultName {
+  FIRApp *app = [[FIRApp alloc] initWithName:DEFAULT_APP_NAME options:[self fullyPopulatedOptions]];
+  [RNFBAppModule setCustomDomainForTesting:@"default-domain.example.com"
+                                forAppName:DEFAULT_APP_DISPLAY_NAME];
+
+  NSDictionary *result = [RNFBSharedUtils firAppToDictionary:app];
+  XCTAssertEqualObjects(result[@"options"][@"authDomain"], @"default-domain.example.com");
+}
+
+- (void)testFacadeSendJSEventInjectsAppNameAndForwards {
+  FIRApp *app = [[FIRApp alloc] initWithName:DEFAULT_APP_NAME options:[self fullyPopulatedOptions]];
+  RNFBRCTEventEmitter *emitter = [RNFBRCTEventEmitter shared];
+  [emitter invalidate];
+
+  __block NSString *capturedName = nil;
+  __block NSDictionary *capturedBody = nil;
+  RNFBRCTEventEmitterCore *recordingCore = [[RNFBRCTEventEmitterCore alloc]
+      initWithIsBridgePresent:^BOOL {
+        return YES;
+      }
+      emitHandler:^(NSString *eventName, id body) {
+        capturedName = [eventName copy];
+        capturedBody = body;
+      }];
+  [emitter setValue:recordingCore forKey:@"core"];
+  [emitter notifyJsReady:YES];
+  [emitter addListener:@"facade_event"];
+
+  [RNFBSharedUtils sendJSEventForApp:app name:@"facade_event" body:@{@"foo" : @"bar"}];
+
+  XCTAssertEqualObjects(capturedName, @"facade_event");
+  XCTAssertEqualObjects(capturedBody[@"foo"], @"bar");
+  XCTAssertEqualObjects(capturedBody[@"appName"], DEFAULT_APP_DISPLAY_NAME);
+}
+
+- (void)testFacadePublicSelectorsUnchanged {
+  XCTAssertTrue([RNFBSharedUtils respondsToSelector:@selector(firAppToDictionary:)]);
+  XCTAssertTrue([RNFBSharedUtils respondsToSelector:@selector(sendJSEventForApp:name:body:)]);
+}
+
+@end

package/ios/RNFBAppUnitTests/RNFBSharedUtilsFIRAppTests.swift

@@ -0,0 +1,173 @@
+/**
+ * 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
+import XCTest
+
+private final class StubFIROptions: NSObject, RNFBFIROptionsProviding {
+  var apiKey: String?
+  var googleAppID: String?
+  var projectID: String?
+  var databaseURL: String?
+  var storageBucket: String?
+  var gcmSenderID: String?
+  var clientID: String?
+}
+
+private final class StubFIRApp: NSObject, RNFBFIRAppProviding {
+  var name: String
+  var options: RNFBFIROptionsProviding
+  var dataCollectionEnabled = false
+
+  init(name: String, options: RNFBFIROptionsProviding) {
+    self.name = name
+    self.options = options
+  }
+
+  func isDataCollectionDefaultEnabled() -> Bool {
+    dataCollectionEnabled
+  }
+}
+
+private final class StubCustomDomainProvider: NSObject, RNFBCustomDomainProviding {
+  var domains: [String: String] = [:]
+  var lastRequestedName: String?
+
+  func getCustomDomain(_ appName: String) -> String? {
+    lastRequestedName = appName
+    return domains[appName]
+  }
+}
+
+private final class RecordingEventSender: NSObject, RNFBJSEventSending {
+  var lastName: String?
+  var lastBody: Any?
+
+  func sendEvent(name: String, body: Any?) {
+    lastName = name
+    lastBody = body
+  }
+}
+
+final class RNFBSharedUtilsFIRAppTests: XCTestCase {
+  private func fullyPopulatedOptions() -> StubFIROptions {
+    let options = StubFIROptions()
+    options.apiKey = "api-key"
+    options.googleAppID = "app-id"
+    options.projectID = "project-id"
+    options.databaseURL = "https://example.firebaseio.com"
+    options.storageBucket = "example.appspot.com"
+    options.gcmSenderID = "sender-id"
+    options.clientID = "client-id"
+    return options
+  }
+
+  func testDefaultAppNameMapsToDisplayName() {
+    let app = StubFIRApp(name: "__FIRAPP_DEFAULT", options: fullyPopulatedOptions())
+    app.dataCollectionEnabled = true
+    let domains = StubCustomDomainProvider()
+
+    let result = RNFBSharedUtilsFIRApp.firAppToDictionary(app, customDomainProvider: domains)
+    let appConfig = result["appConfig"] as? NSDictionary
+
+    XCTAssertEqual(appConfig?["name"] as? String, "[DEFAULT]")
+    XCTAssertEqual(appConfig?["automaticDataCollectionEnabled"] as? Bool, true)
+    XCTAssertEqual(domains.lastRequestedName, "[DEFAULT]")
+  }
+
+  func testNamedAppPreservesName() {
+    let app = StubFIRApp(name: "secondary", options: fullyPopulatedOptions())
+    let domains = StubCustomDomainProvider()
+
+    let result = RNFBSharedUtilsFIRApp.firAppToDictionary(app, customDomainProvider: domains)
+    let appConfig = result["appConfig"] as? NSDictionary
+
+    XCTAssertEqual(appConfig?["name"] as? String, "secondary")
+    XCTAssertEqual(domains.lastRequestedName, "secondary")
+  }
+
+  func testOptionsFieldMapping() {
+    let app = StubFIRApp(name: "secondary", options: fullyPopulatedOptions())
+    let domains = StubCustomDomainProvider()
+
+    let result = RNFBSharedUtilsFIRApp.firAppToDictionary(app, customDomainProvider: domains)
+    let options = result["options"] as? NSDictionary
+
+    XCTAssertEqual(options?["apiKey"] as? String, "api-key")
+    XCTAssertEqual(options?["appId"] as? String, "app-id")
+    XCTAssertEqual(options?["projectId"] as? String, "project-id")
+    XCTAssertEqual(options?["databaseURL"] as? String, "https://example.firebaseio.com")
+    XCTAssertEqual(options?["storageBucket"] as? String, "example.appspot.com")
+    XCTAssertEqual(options?["messagingSenderId"] as? String, "sender-id")
+    XCTAssertEqual(options?["clientId"] as? String, "client-id")
+    XCTAssertNil(options?["authDomain"])
+  }
+
+  func testAuthDomainPresentWhenProviderReturnsValue() {
+    let app = StubFIRApp(name: "secondary", options: fullyPopulatedOptions())
+    let domains = StubCustomDomainProvider()
+    domains.domains["secondary"] = "custom.example.com"
+
+    let result = RNFBSharedUtilsFIRApp.firAppToDictionary(app, customDomainProvider: domains)
+    let options = result["options"] as? NSDictionary
+
+    XCTAssertEqual(options?["authDomain"] as? String, "custom.example.com")
+  }
+
+  func testAuthDomainAbsentWhenProviderReturnsNil() {
+    let app = StubFIRApp(name: "__FIRAPP_DEFAULT", options: fullyPopulatedOptions())
+    let domains = StubCustomDomainProvider()
+
+    let result = RNFBSharedUtilsFIRApp.firAppToDictionary(app, customDomainProvider: domains)
+    let options = result["options"] as? NSDictionary
+
+    XCTAssertNil(options?["authDomain"])
+    XCTAssertEqual(domains.lastRequestedName, "[DEFAULT]")
+  }
+
+  func testSendJSEventInjectsAppNameAndForwards() {
+    let app = StubFIRApp(name: "__FIRAPP_DEFAULT", options: fullyPopulatedOptions())
+    let sender = RecordingEventSender()
+    let body: NSDictionary = ["foo": "bar"]
+
+    RNFBSharedUtilsFIRApp.sendJSEvent(
+      forApp: app,
+      name: "app_event",
+      body: body,
+      eventSender: sender
+    )
+
+    XCTAssertEqual(sender.lastName, "app_event")
+    let forwarded = sender.lastBody as? NSDictionary
+    XCTAssertEqual(forwarded?["foo"] as? String, "bar")
+    XCTAssertEqual(forwarded?["appName"] as? String, "[DEFAULT]")
+  }
+
+  func testSendJSEventPreservesNamedAppName() {
+    let app = StubFIRApp(name: "secondary", options: fullyPopulatedOptions())
+    let sender = RecordingEventSender()
+
+    RNFBSharedUtilsFIRApp.sendJSEvent(
+      forApp: app,
+      name: "named_event",
+      body: [:],
+      eventSender: sender
+    )
+
+    let forwarded = sender.lastBody as? NSDictionary
+    XCTAssertEqual(forwarded?["appName"] as? String, "secondary")
+  }
+}

package/ios/RNFBAppUnitTests/RNFBSharedUtilsFormattingFacadeTests.m

@@ -0,0 +1,38 @@
+/**
+ * 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 <XCTest/XCTest.h>
+
+#import "RNFBHandleMapStorage-Swift.inc"
+#import "RNFBSharedUtils.h"
+
+@interface RNFBSharedUtilsFormattingFacadeTests : XCTestCase
+@end
+
+@implementation RNFBSharedUtilsFormattingFacadeTests
+
+- (void)testFacadeMapsDefaultAppName {
+  XCTAssertEqualObjects([RNFBSharedUtils getAppJavaScriptName:DEFAULT_APP_NAME],
+                        DEFAULT_APP_DISPLAY_NAME);
+  XCTAssertEqualObjects([RNFBSharedUtils getAppJavaScriptName:@"secondary"], @"secondary");
+}
+
+- (void)testFacadeFormatsISO8601WithTrailingZ {
+  NSDate *date = [NSDate dateWithTimeIntervalSince1970:1577934245];
+  XCTAssertEqualObjects([RNFBSharedUtils getISO8601String:date], @"2020-01-02T03:04:05Z");
+}
+
+@end

package/ios/RNFBAppUnitTests/RNFBSharedUtilsFormattingTests.swift

@@ -0,0 +1,82 @@
+/**
+ * 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
+import XCTest
+
+final class RNFBSharedUtilsFormattingTests: XCTestCase {
+  func testDefaultAppNameMapsToDisplayName() {
+    XCTAssertEqual(
+      RNFBSharedUtilsFormatting.getAppJavaScriptName("__FIRAPP_DEFAULT"),
+      "[DEFAULT]"
+    )
+  }
+
+  func testNonDefaultAppNameIsReturnedUnchanged() {
+    XCTAssertEqual(
+      RNFBSharedUtilsFormatting.getAppJavaScriptName("secondary"),
+      "secondary"
+    )
+    XCTAssertEqual(
+      RNFBSharedUtilsFormatting.getAppJavaScriptName("[DEFAULT]"),
+      "[DEFAULT]"
+    )
+    XCTAssertEqual(RNFBSharedUtilsFormatting.getAppJavaScriptName(""), "")
+  }
+
+  func testNilAppNameReturnsNil() {
+    XCTAssertNil(RNFBSharedUtilsFormatting.getAppJavaScriptName(nil))
+  }
+
+  func testISO8601UsesPOSIXUTCAndTrailingZ() {
+    var components = DateComponents()
+    components.calendar = Calendar(identifier: .gregorian)
+    components.timeZone = TimeZone(abbreviation: "UTC")
+    components.year = 2020
+    components.month = 1
+    components.day = 2
+    components.hour = 3
+    components.minute = 4
+    components.second = 5
+
+    let date = components.date!
+    XCTAssertEqual(
+      RNFBSharedUtilsFormatting.getISO8601String(date),
+      "2020-01-02T03:04:05Z"
+    )
+  }
+
+  func testISO8601FormatsInUTCRegardlessOfLocalOffset() {
+    // 2020-01-02 03:04:05 UTC as absolute instant; format must stay UTC/`Z`.
+    let date = Date(timeIntervalSince1970: 1_577_934_245)
+    XCTAssertEqual(
+      RNFBSharedUtilsFormatting.getISO8601String(date),
+      "2020-01-02T03:04:05Z"
+    )
+  }
+
+  func testISO8601OmitsFractionalSeconds() {
+    let date = Date(timeIntervalSince1970: 1_577_934_245.789)
+    XCTAssertEqual(
+      RNFBSharedUtilsFormatting.getISO8601String(date),
+      "2020-01-02T03:04:05Z"
+    )
+  }
+
+  func testNilDateReturnsNil() {
+    XCTAssertNil(RNFBSharedUtilsFormatting.getISO8601String(nil))
+  }
+}