fix: prevent crash when transactionId is nil in transactionBegin

[rgomezp]

Fix crash when transactionId is nil in transactionBegin

Description

This PR fixes a critical crash in the iOS Firestore transaction module where the app would crash with com.google.firebase.firestore.transaction when transactionId is nil. The crash occurs at line 156 in RNFBFirestoreTransactionModule.m when attempting to use a nil key in an NSMutableDictionary.

Crashed: com.google.firebase.firestore.transaction
0  CoreFoundation                 0x1e4cc -[NSDictionaryM setObject:forKeyedSubscript:] + 460
1  FitnessWolf                    0x7ed978 53-[RNFBFirestoreTransactionModule transactionBegin:::]_block_invoke + 156 (RNFBFirestoreTransactionModule.m:156)
2  FitnessWolf                    0x39be80 invocation function for block in -[FIRFirestore runTransactionWithOptions:block:dispatchQueue:completion:]::TransactionResult::RunUpdateBlock(std::1::shared_ptr<firebase::firestore::core::Transaction>, std::1::function<void (firebase::firestore::util::Status)>) + 329 (FIRFirestore.mm:329)
3  libdispatch.dylib              0x1aac dispatchcall_block_and_release + 32
4  libdispatch.dylib              0x1b584 dispatchclient_callout + 16
5  libdispatch.dylib              0x6560 dispatchcontinuation_pop + 596
6  libdispatch.dylib              0x5bd4 dispatchasync_redirect_invoke + 580
7  libdispatch.dylib              0x13db0 dispatchroot_queue_drain + 364
8  libdispatch.dylib              0x1454c dispatchworker_thread2 + 156
9  libsystem_pthread.dylib        0x9d0 pthreadwqthread + 232
10 libsystem_pthread.dylib        0xaac start_wqthread + 8

Root Cause

• The transactionId parameter can be nil in certain edge cases
• Calling [transactionId stringValue] on a nil NSNumber returns nil
• Using nil as a key in NSMutableDictionary causes a crash in setObject:forKeyedSubscript:

Solution

• Add early validation to check if transactionId is nil and return early with logging
• Implement safe dictionary key handling by validating the string key before use
• Return proper Firestore error instead of crashing when transactionId is invalid

Related issues

Fixes crash in com.google.firebase.firestore.transaction at line 156

Release Summary

• iOS: Fixed crash when transactionId is nil in Firestore transactions
• Breaking Change: No

Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
  • Yes
• My change supports the following platforms;
  • Android
  • iOS
  • Other (macOS, web)
• My change includes tests;
  • e2e tests added or updated in packages/**/e2e
  • jest tests added or updated in packages/**/__tests__
• I have updated TypeScript types that are affected by my change.
• This is a breaking change;
  • Yes
  • No

Test Plan

Before Fix

• App would crash with com.google.firebase.firestore.transaction when transactionId is nil
• Crash occurs at line 156 in RNFBFirestoreTransactionModule.m
• No error handling for invalid transaction IDs

After Fix

• App no longer crashes when transactionId is nil
• Proper error logging: "Error: transactionId is nil in transactionBegin"
• Returns FIRFirestoreErrorCodeInvalidArgument error instead of crashing
• Valid transactions continue to work normally

Test Cases

1. Valid transaction: Should work as before
2. Nil transactionId: Should log error and return early (no crash)
3. Invalid transactionId: Should return proper Firestore error

Code Changes

// Early validation
if (transactionId == nil) {
  DLog(@"Error: transactionId is nil in transactionBegin");
  return;
}

// Safe dictionary key handling
NSString *transactionKey = [transactionId stringValue];
if (transactionKey != nil && !transactions[transactionKey]) {
  transactions[transactionKey] = transactionState;
} else {
  DLog(@"Invalid transactionId provided: %@", transactionId);
  *errorPointer = [NSError errorWithDomain:FIRFirestoreErrorDomain
                                      code:FIRFirestoreErrorCodeInvalidArgument
                                  userInfo:@{NSLocalizedDescriptionKey: @"Invalid transaction ID"}];
  return nil;
}

---

Think react-native-firebase is great? Please consider supporting the project with any of the below:

• 👉 Star this repo on GitHub ⭐️
• 👉 Follow React Native Firebase and Invertase on Twitter

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
react-native-firebase	Ready	Preview	Comment	Sep 27, 2025 7:29pm

[CLAassistant]

All committers have signed the CLA.