@react-native-firebase/app 26.4.0 → 27.0.0

package/ios/RNFBAppUnitTests/RNFBFirebaseAppClientTests.swift

@@ -0,0 +1,165 @@
+/**
+ * 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 FirebaseCore
+import Foundation
+import RNFBFirebase
+import XCTest
+
+@_silgen_name("RNFBFirebaseInstallationsLinked")
+private func RNFBFirebaseInstallationsLinked() -> ObjCBool
+
+final class RNFBFirebaseAppClientTests: XCTestCase {
+  override func tearDown() {
+    FirebaseApp.resetRegistryForTesting()
+    FirebaseConfiguration.resetForTesting()
+    super.tearDown()
+  }
+
+  func testInstallationsLinkageAnchorIsDistinctFromNSObject() {
+    XCTAssertTrue(RNFBFirebaseInstallationsLinked().boolValue)
+  }
+
+  func testCreateOptionsPreservesNilIdentifiersAndDeallocates() {
+    weak var released: FirebaseOptions?
+    autoreleasepool {
+      let created = RNFBFirebaseOptionsClient.create(googleAppID: nil, gcmSenderID: nil)
+      let options = created as! FirebaseOptions
+      released = options
+      XCTAssertNil(options.googleAppID)
+      XCTAssertNil(options.gcmSenderID)
+    }
+    XCTAssertNil(released)
+  }
+
+  func testOptionsClientRoundTripsMutableFields() {
+    let created = RNFBFirebaseOptionsClient.create(googleAppID: "app-id", gcmSenderID: "sender-id")
+    let createdOptions = created as! FirebaseOptions
+    XCTAssertEqual(createdOptions.googleAppID, "app-id")
+    XCTAssertEqual(createdOptions.gcmSenderID, "sender-id")
+
+    RNFBFirebaseOptionsClient.setAPIKey("api-key", on: created)
+    RNFBFirebaseOptionsClient.setProjectID("project-id", on: created)
+    RNFBFirebaseOptionsClient.setClientID("client-id", on: created)
+    RNFBFirebaseOptionsClient.setDatabaseURL("https://example.firebaseio.com", on: created)
+    RNFBFirebaseOptionsClient.setStorageBucket("example.appspot.com", on: created)
+    RNFBFirebaseOptionsClient.setBundleID("com.example.app", on: created)
+    RNFBFirebaseOptionsClient.setAppGroupID("group.com.example", on: created)
+
+    XCTAssertEqual(RNFBFirebaseOptionsClient.apiKey(created), "api-key")
+    XCTAssertEqual(RNFBFirebaseOptionsClient.projectID(created), "project-id")
+    XCTAssertEqual(RNFBFirebaseOptionsClient.clientID(created), "client-id")
+    XCTAssertEqual(RNFBFirebaseOptionsClient.databaseURL(created), "https://example.firebaseio.com")
+    XCTAssertEqual(RNFBFirebaseOptionsClient.storageBucket(created), "example.appspot.com")
+    XCTAssertEqual(RNFBFirebaseOptionsClient.bundleID(created), "com.example.app")
+    XCTAssertEqual(RNFBFirebaseOptionsClient.appGroupID(created), "group.com.example")
+
+    // Pre-port `options.bundleID = nil` removed the key. nil must reach the SDK setter.
+    RNFBFirebaseOptionsClient.setBundleID(nil, on: created)
+    RNFBFirebaseOptionsClient.setAppGroupID(nil, on: created)
+    XCTAssertNil(createdOptions.bundleID)
+    XCTAssertNil(RNFBFirebaseOptionsClient.bundleID(created))
+    XCTAssertNil(RNFBFirebaseOptionsClient.appGroupID(created))
+  }
+
+  func testAppLookupConfigureSnapshotAndAllApps() {
+    XCTAssertNil(RNFBFirebaseAppClient.defaultApp())
+    XCTAssertNil(RNFBFirebaseAppClient.app(named: "missing"))
+    XCTAssertNil(RNFBFirebaseAppClient.allApps())
+
+    let options = RNFBFirebaseOptionsClient.create(googleAppID: "app-id", gcmSenderID: "sender-id")
+    RNFBFirebaseOptionsClient.setAPIKey("api-key", on: options)
+    RNFBFirebaseOptionsClient.setProjectID("project-id", on: options)
+    RNFBFirebaseOptionsClient.setClientID("client-id", on: options)
+    RNFBFirebaseOptionsClient.setDatabaseURL("https://example.firebaseio.com", on: options)
+    RNFBFirebaseOptionsClient.setStorageBucket("example.appspot.com", on: options)
+
+    RNFBFirebaseAppClient.configure(options: options)
+    let defaultApp = RNFBFirebaseAppClient.defaultApp()
+    XCTAssertNotNil(defaultApp)
+
+    let namedOptions = RNFBFirebaseOptionsClient.create(googleAppID: "named-app", gcmSenderID: "named-sender")
+    RNFBFirebaseAppClient.configure(name: "secondary", options: namedOptions)
+    let named = RNFBFirebaseAppClient.app(named: "secondary")
+    XCTAssertNotNil(named)
+
+    let apps = RNFBFirebaseAppClient.allApps()
+    XCTAssertEqual(apps?.count, 2)
+
+    let snapshot = RNFBFirebaseAppClient.snapshot(of: defaultApp!)
+    XCTAssertEqual(snapshot.name, "__FIRAPP_DEFAULT")
+    XCTAssertEqual(snapshot.googleAppID, "app-id")
+    XCTAssertEqual(snapshot.gcmSenderID, "sender-id")
+    XCTAssertEqual(snapshot.apiKey, "api-key")
+    XCTAssertEqual(snapshot.projectID, "project-id")
+    XCTAssertEqual(snapshot.clientID, "client-id")
+    XCTAssertEqual(snapshot.databaseURL, "https://example.firebaseio.com")
+    XCTAssertEqual(snapshot.storageBucket, "example.appspot.com")
+    XCTAssertFalse(snapshot.isDataCollectionDefaultEnabled)
+
+    XCTAssertFalse(RNFBFirebaseAppClient.setDataCollectionDefaultEnabled(true, forApp: NSObject()))
+    XCTAssertTrue(RNFBFirebaseAppClient.setDataCollectionDefaultEnabled(true, forApp: defaultApp!))
+    XCTAssertTrue(RNFBFirebaseAppClient.snapshot(of: defaultApp!).isDataCollectionDefaultEnabled)
+  }
+
+  func testDefaultPlistConfigureCreatesDefaultApp() {
+    // The dynamic probe app (test-rn-bare) calls this overload from its AppDelegate.
+    XCTAssertNil(RNFBFirebaseAppClient.defaultApp())
+    RNFBFirebaseAppClient.configure()
+    XCTAssertNotNil(RNFBFirebaseAppClient.defaultApp())
+  }
+
+  func testDeleteAppRejectsNonFirebaseAndRemovesLiveApp() {
+    var completionCalled = false
+    XCTAssertFalse(
+      RNFBFirebaseAppClient.deleteApp(NSObject()) { _ in
+        completionCalled = true
+      }
+    )
+    XCTAssertFalse(completionCalled)
+
+    let options = RNFBFirebaseOptionsClient.create(googleAppID: "app-id", gcmSenderID: "sender")
+    RNFBFirebaseAppClient.configure(name: "secondary", options: options)
+    let app = RNFBFirebaseAppClient.app(named: "secondary")!
+    let expectation = expectation(description: "delete")
+    XCTAssertTrue(
+      RNFBFirebaseAppClient.deleteApp(app) { success in
+        XCTAssertTrue(success)
+        expectation.fulfill()
+      }
+    )
+    waitForExpectations(timeout: 1)
+    XCTAssertNil(RNFBFirebaseAppClient.app(named: "secondary"))
+  }
+
+  func testLoggerLevelPassesThroughKnownAndUnknownValues() {
+    RNFBFirebaseAppClient.setLoggerLevel(7)
+    XCTAssertEqual(FirebaseConfiguration.shared.loggerLevel, unsafeBitCast(7, to: FirebaseLoggerLevel.self))
+    RNFBFirebaseAppClient.setLoggerLevel(99)
+    XCTAssertEqual(FirebaseConfiguration.shared.loggerLevel, unsafeBitCast(99, to: FirebaseLoggerLevel.self))
+  }
+
+  func testRegisterLibrarySkipsMissingSelectorAndRecordsWhenPresent() {
+    FirebaseApp.setRegisterLibraryAvailableForTesting(false)
+    RNFBFirebaseAppClient.registerLibrary(name: "skipped-c", version: "0")
+    XCTAssertNil(FirebaseApp.lastRegisteredLibraryNameForTesting())
+    FirebaseApp.setRegisterLibraryAvailableForTesting(true)
+
+    RNFBFirebaseAppClient.registerLibrary(name: "react-native-firebase", version: "9.9.9")
+    XCTAssertEqual(FirebaseApp.lastRegisteredLibraryNameForTesting(), "react-native-firebase")
+    XCTAssertEqual(FirebaseApp.lastRegisteredLibraryVersionForTesting(), "9.9.9")
+  }
+}

package/ios/RNFBAppUnitTests/RNFBHandleMapStorageTests.swift

@@ -0,0 +1,121 @@
+/**
+ * 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 RNFBHandleMapStorageTests: XCTestCase {
+  private var storage: RNFBHandleMapStorage!
+
+  override func setUp() {
+    super.setUp()
+    storage = RNFBHandleMapStorage()
+  }
+
+  func testStorageOperationsPreserveExactPointers() {
+    let first = NSMutableString(string: "equal")
+    let equalButDistinct = NSMutableString(string: "equal")
+    let replacement = NSObject()
+
+    XCTAssertEqual(first, equalButDistinct)
+    XCTAssertFalse(first === equalButDistinct)
+
+    XCTAssertTrue(storage.putIfAbsent(1 as NSNumber, value: first))
+    XCTAssertFalse(storage.putIfAbsent(1 as NSNumber, value: replacement))
+    XCTAssertTrue(storage.get(1 as NSNumber) === first)
+
+    XCTAssertTrue(storage.putIfAbsentOrSame(1 as NSNumber, value: first))
+    XCTAssertFalse(storage.putIfAbsentOrSame(1 as NSNumber, value: equalButDistinct))
+    XCTAssertTrue(storage.get(1 as NSNumber) === first)
+
+    XCTAssertTrue(storage.putIfAbsentOrSame(2 as NSNumber, value: equalButDistinct))
+    XCTAssertTrue(storage.get(2 as NSNumber) === equalButDistinct)
+
+    XCTAssertNil(storage.putReplacing(3 as NSNumber, value: first))
+    XCTAssertTrue(storage.putReplacing(3 as NSNumber, value: replacement) === first)
+    XCTAssertTrue(storage.take(3 as NSNumber) === replacement)
+    XCTAssertNil(storage.take(3 as NSNumber))
+  }
+
+  func testTakeIfMissingDoesNotCallConditionAndFalseLeavesValue() {
+    var conditionCalled = false
+    XCTAssertNil(storage.takeIf(1 as NSNumber) { _ in
+      conditionCalled = true
+      return true
+    })
+    XCTAssertFalse(conditionCalled)
+
+    let value = NSObject()
+    XCTAssertTrue(storage.putIfAbsent(1 as NSNumber, value: value))
+    XCTAssertNil(storage.takeIf(1 as NSNumber) { candidate in
+      conditionCalled = true
+      XCTAssertTrue(candidate === value)
+      return false
+    })
+    XCTAssertTrue(conditionCalled)
+    XCTAssertTrue(storage.get(1 as NSNumber) === value)
+  }
+
+  func testTakeIfConditionRunsUnderRecursiveLock() {
+    let value = NSObject()
+    XCTAssertTrue(storage.putIfAbsent(1 as NSNumber, value: value))
+
+    let conditionEntered = DispatchSemaphore(value: 0)
+    let releaseCondition = DispatchSemaphore(value: 0)
+    let takeIfDone = DispatchSemaphore(value: 0)
+    let competingTakeDone = DispatchSemaphore(value: 0)
+    var taken: AnyObject?
+    var competingTake: AnyObject?
+
+    DispatchQueue.global().async {
+      taken = self.storage.takeIf(1 as NSNumber) { candidate in
+        XCTAssertTrue(candidate === value)
+        XCTAssertTrue(self.storage.get(1 as NSNumber) === value)
+        conditionEntered.signal()
+        XCTAssertEqual(releaseCondition.wait(timeout: .now() + 5), .success)
+        return true
+      }
+      takeIfDone.signal()
+    }
+
+    XCTAssertEqual(conditionEntered.wait(timeout: .now() + 5), .success)
+    DispatchQueue.global().async {
+      competingTake = self.storage.take(1 as NSNumber)
+      competingTakeDone.signal()
+    }
+
+    XCTAssertEqual(competingTakeDone.wait(timeout: .now() + 0.1), .timedOut)
+    releaseCondition.signal()
+    XCTAssertEqual(takeIfDone.wait(timeout: .now() + 5), .success)
+    XCTAssertEqual(competingTakeDone.wait(timeout: .now() + 5), .success)
+    XCTAssertTrue(taken === value)
+    XCTAssertNil(competingTake)
+  }
+
+  func testTakeAllReturnsSnapshotThenClears() {
+    let first = NSObject()
+    let second = NSObject()
+    XCTAssertTrue(storage.putIfAbsent(1 as NSNumber, value: first))
+    XCTAssertTrue(storage.putIfAbsent(2 as NSNumber, value: second))
+
+    let values = storage.takeAll()
+
+    XCTAssertEqual(values.count, 2)
+    XCTAssertTrue(values.contains { $0 === first })
+    XCTAssertTrue(values.contains { $0 === second })
+    XCTAssertTrue(storage.takeAll().isEmpty)
+  }
+}

package/ios/RNFBAppUnitTests/RNFBInitializeAppArgumentsTests.swift

@@ -0,0 +1,256 @@
+/**
+ * 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 RNFBInitializeAppArgumentsTests: XCTestCase {
+  private func nullSentinel() -> NSDictionary {
+    ["__rnfbNull": true] as NSDictionary
+  }
+
+  private func requiredOptions() -> NSDictionary {
+    [
+      "apiKey": "key",
+      "appId": "1:123:ios:abc",
+      "messagingSenderId": "123",
+      "projectId": "project",
+    ] as NSDictionary
+  }
+
+  private func optionsByAdding(_ extra: [String: Any]) -> NSDictionary {
+    let options = NSMutableDictionary(dictionary: requiredOptions())
+    options.addEntries(from: extra)
+    return options
+  }
+
+  func testOptions_sentinelIosBundleId_isDropped() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["iosBundleId": nullSentinel()])
+    )!
+    XCTAssertNil(result["iosBundleId"])
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "iosBundleId" })
+  }
+
+  func testOptions_sentinelIosClientId_isDropped() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["iosClientId": nullSentinel()])
+    )!
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "iosClientId" })
+  }
+
+  func testOptions_sentinelAppGroupId_isDropped() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["appGroupId": nullSentinel()])
+    )!
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "appGroupId" })
+  }
+
+  func testOptions_sentinelAuthDomain_isDropped() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["authDomain": nullSentinel()])
+    )!
+    XCTAssertNil(result["authDomain"])
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "authDomain" })
+  }
+
+  func testOptions_sentinelDatabaseUrlAndStorageBucket_areDropped() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["databaseURL": nullSentinel(), "storageBucket": nullSentinel()])
+    )!
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "databaseURL" })
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "storageBucket" })
+  }
+
+  func testOptions_plainNSNullOptionalKey_isDropped() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["iosBundleId": NSNull()])
+    )!
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "iosBundleId" })
+  }
+
+  func testOptions_allOptionalKeysNull_onlyRequiredKeysRemain() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding([
+        "databaseURL": nullSentinel(),
+        "storageBucket": nullSentinel(),
+        "iosBundleId": nullSentinel(),
+        "iosClientId": nullSentinel(),
+        "appGroupId": nullSentinel(),
+        "authDomain": nullSentinel(),
+      ])
+    )
+    XCTAssertEqual(result, requiredOptions())
+  }
+
+  func testOptions_realStrings_areUnchanged() {
+    let input = optionsByAdding([
+      "databaseURL": "https://db.firebaseio.com",
+      "storageBucket": "bucket.appspot.com",
+      "iosBundleId": "com.example.app",
+      "iosClientId": "client-id",
+      "appGroupId": "group.com.example",
+      "authDomain": "example.firebaseapp.com",
+    ])
+    XCTAssertEqual(RNFBInitializeAppArguments.normalizedOptions(input), input)
+  }
+
+  func testOptions_nullOptionalKeyDoesNotAffectSiblingStrings() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding([
+        "iosBundleId": nullSentinel(),
+        "iosClientId": "client-id",
+        "authDomain": "example.firebaseapp.com",
+      ])
+    )!
+    XCTAssertFalse(result.allKeys.contains { ($0 as? String) == "iosBundleId" })
+    XCTAssertEqual(result["iosClientId"] as? String, "client-id")
+    XCTAssertEqual(result["authDomain"] as? String, "example.firebaseapp.com")
+    XCTAssertEqual(result["apiKey"] as? String, "key")
+  }
+
+  func testOptions_nonOptionalKeyWithNull_isLeftAsNSNull() {
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["projectId": nullSentinel()])
+    )!
+    XCTAssertTrue(result["projectId"] is NSNull)
+    XCTAssertEqual(result["apiKey"] as? String, "key")
+  }
+
+  func testOptions_oneKeyDictionaryThatIsNotSentinel_isUnchanged() {
+    let input = ["apiKey": "key"] as NSDictionary
+    XCTAssertEqual(RNFBInitializeAppArguments.normalizedOptions(input), input)
+  }
+
+  func testOptions_sentinelLookalikeValueForOptionalKey_isNotDropped() {
+    let notSentinel = ["__rnfbNull": false] as NSDictionary
+    let result = RNFBInitializeAppArguments.normalizedOptions(
+      optionsByAdding(["iosBundleId": notSentinel])
+    )!
+    XCTAssertEqual(result["iosBundleId"] as? NSDictionary, notSentinel)
+  }
+
+  func testOptions_nil_returnsNil() {
+    XCTAssertNil(RNFBInitializeAppArguments.normalizedOptions(nil))
+  }
+
+  func testOptions_rootSentinel_returnsNil() {
+    XCTAssertNil(RNFBInitializeAppArguments.normalizedOptions(nullSentinel()))
+  }
+
+  func testOptions_doesNotMutateInput() {
+    let input = optionsByAdding(["iosBundleId": nullSentinel()])
+    let copy = input.copy() as! NSDictionary
+    _ = RNFBInitializeAppArguments.normalizedOptions(input)
+    XCTAssertEqual(input, copy)
+  }
+
+  func testAppConfig_sentinelName_isDropped_andSentinelDataCollection_becomesNo() {
+    let result = RNFBInitializeAppArguments.normalizedAppConfig([
+      "name": nullSentinel(),
+      "automaticDataCollectionEnabled": nullSentinel(),
+    ])!
+    XCTAssertEqual(result.count, 1)
+    XCTAssertNil(result["name"])
+    XCTAssertEqual(result["automaticDataCollectionEnabled"] as? Bool, false)
+  }
+
+  func testAppConfig_nsNullDataCollection_becomesNo() {
+    let result = RNFBInitializeAppArguments.normalizedAppConfig([
+      "automaticDataCollectionEnabled": NSNull(),
+    ])!
+    XCTAssertEqual(result["automaticDataCollectionEnabled"] as? Bool, false)
+  }
+
+  func testAppConfig_omittedDataCollection_staysOmitted() {
+    let result = RNFBInitializeAppArguments.normalizedAppConfig(["name": "secondary"])!
+    XCTAssertNil(result["automaticDataCollectionEnabled"])
+  }
+
+  func testAppConfig_realValues_areUnchanged() {
+    let input = ["name": "secondary", "automaticDataCollectionEnabled": true] as NSDictionary
+    XCTAssertEqual(RNFBInitializeAppArguments.normalizedAppConfig(input), input)
+  }
+
+  func testAppConfig_unknownKeyWithNull_isLeftAsNSNull() {
+    let result = RNFBInitializeAppArguments.normalizedAppConfig([
+      "name": "secondary",
+      "extra": nullSentinel(),
+    ])!
+    XCTAssertEqual(result["name"] as? String, "secondary")
+    XCTAssertTrue(result["extra"] is NSNull)
+  }
+
+  func testAppConfig_nil_returnsNil() {
+    XCTAssertNil(RNFBInitializeAppArguments.normalizedAppConfig(nil))
+  }
+
+  func testAppConfig_rootSentinel_returnsNil() {
+    XCTAssertNil(RNFBInitializeAppArguments.normalizedAppConfig(nullSentinel()))
+  }
+
+  func testAutoDataCollection_yes_returnsYes() {
+    XCTAssertEqual(
+      RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: [
+        "automaticDataCollectionEnabled": true,
+      ]),
+      NSNumber(value: true)
+    )
+  }
+
+  func testAutoDataCollection_explicitNo_returnsNo() {
+    let result = RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: [
+      "automaticDataCollectionEnabled": false,
+    ])
+    XCTAssertNotNil(result)
+    XCTAssertFalse(result!.boolValue)
+  }
+
+  func testAutoDataCollection_absentKey_returnsNil() {
+    XCTAssertNil(
+      RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: ["name": "secondary"])
+    )
+  }
+
+  func testAutoDataCollection_nilAppConfig_returnsNil() {
+    XCTAssertNil(RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: nil))
+  }
+
+  func testAutoDataCollection_NSNull_returnsNil() {
+    XCTAssertNil(
+      RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: [
+        "automaticDataCollectionEnabled": NSNull(),
+      ])
+    )
+  }
+
+  func testAutoDataCollection_sentinelNormalizedUpstream_returnsNo() {
+    let normalized = RNFBInitializeAppArguments.normalizedAppConfig([
+      "automaticDataCollectionEnabled": nullSentinel(),
+    ])
+    let result = RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: normalized)
+    XCTAssertNotNil(result)
+    XCTAssertFalse(result!.boolValue)
+  }
+
+  func testAutoDataCollection_nonNumberValue_returnsNil() {
+    XCTAssertNil(
+      RNFBInitializeAppArguments.automaticDataCollectionEnabled(fromAppConfig: [
+        "automaticDataCollectionEnabled": "true",
+      ])
+    )
+  }
+}

package/ios/RNFBAppUnitTests/RNFBJSONImplementationTests.swift

@@ -0,0 +1,126 @@
+/**
+ * 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 RNFBJSONImplementationTests: XCTestCase {
+  private func base64(_ object: Any) throws -> String {
+    try JSONSerialization.data(withJSONObject: object).base64EncodedString()
+  }
+
+  func testNilInvalidBase64AndInvalidJSONProduceEmptyDictionaries() {
+    let implementations = [
+      RNFBJSONImplementation(rawValue: nil),
+      RNFBJSONImplementation(rawValue: "not base64"),
+      RNFBJSONImplementation(rawValue: Data("{".utf8).base64EncodedString()),
+    ]
+
+    for implementation in implementations {
+      XCTAssertFalse(implementation.contains("missing"))
+      XCTAssertEqual(
+        implementation.value(forKey: "missing", defaultValue: "fallback" as NSString) as? String,
+        "fallback"
+      )
+      XCTAssertEqual(implementation.jsonObject() as? NSDictionary, NSDictionary())
+    }
+  }
+
+  func testValidObjectPreservesFoundationValuesAndDefaultsOnlyForNilLookup() throws {
+    let implementation = RNFBJSONImplementation(rawValue: try base64([
+      "boolean": true,
+      "number": 3,
+      "string": "value",
+      "array": ["one", 2],
+      "object": ["nested": "value"],
+      "null": NSNull(),
+    ]))
+
+    XCTAssertTrue(implementation.contains("boolean"))
+    XCTAssertTrue(implementation.contains("null"))
+    XCTAssertFalse(implementation.contains("missing"))
+    XCTAssertEqual(
+      implementation.value(forKey: "missing", defaultValue: "fallback" as NSString) as? String,
+      "fallback"
+    )
+    XCTAssertTrue(implementation.value(
+      forKey: "null",
+      defaultValue: "fallback" as NSString
+    ) is NSNull)
+
+    let parsed = implementation.jsonObject() as! NSDictionary
+    XCTAssertEqual(parsed["boolean"] as? Bool, true)
+    XCTAssertEqual(parsed["number"] as? Int, 3)
+    XCTAssertEqual(parsed["string"] as? String, "value")
+    XCTAssertEqual(parsed["array"] as? NSArray, ["one", 2] as NSArray)
+    XCTAssertEqual(parsed["object"] as? NSDictionary, ["nested": "value"] as NSDictionary)
+  }
+
+  func testLookupMatchesNSDictionaryKVCForSpecialKeys() {
+    let dictionary: NSDictionary = [
+      "count": "count value",
+      "@count": "at-count value",
+      "description": "description value",
+    ]
+    let implementation = RNFBJSONImplementation(jsonObject: dictionary)
+
+    for key in ["count", "@count", "description"] {
+      XCTAssertEqual(
+        implementation.value(forKey: key, defaultValue: nil) as? NSObject,
+        dictionary.value(forKey: key) as? NSObject
+      )
+      XCTAssertEqual(implementation.contains(key), dictionary.value(forKey: key) != nil)
+    }
+  }
+
+  func testValidTopLevelArrayIsPreserved() throws {
+    let implementation = RNFBJSONImplementation(rawValue: try base64(["one", 2]))
+
+    XCTAssertEqual(implementation.jsonObject() as? NSArray, ["one", 2] as NSArray)
+  }
+
+  func testParsingIsAnInitializationSnapshot() throws {
+    let first = RNFBJSONImplementation(rawValue: try base64(["value": "first"]))
+    let second = RNFBJSONImplementation(rawValue: try base64(["value": "second"]))
+
+    XCTAssertEqual(first.value(forKey: "value", defaultValue: nil) as? String, "first")
+    XCTAssertEqual(second.value(forKey: "value", defaultValue: nil) as? String, "second")
+  }
+
+  func testRawJSONPreservesLegacyDecodeBehavior() {
+    XCTAssertEqual(RNFBJSONImplementation.rawJSON(from: nil), "{}")
+    XCTAssertNil(RNFBJSONImplementation.rawJSON(from: "not base64"))
+
+    let invalidJSON = "not JSON"
+    XCTAssertEqual(
+      RNFBJSONImplementation.rawJSON(
+        from: Data(invalidJSON.utf8).base64EncodedString()
+      ),
+      invalidJSON
+    )
+
+    let invalidUTF8 = Data([0xff, 0xfe]).base64EncodedString()
+    XCTAssertNil(RNFBJSONImplementation.rawJSON(from: invalidUTF8))
+
+    let validJSON = #"{"value":true}"#
+    XCTAssertEqual(
+      RNFBJSONImplementation.rawJSON(
+        from: Data(validJSON.utf8).base64EncodedString()
+      ),
+      validJSON
+    )
+  }
+}