@react-native-firebase/app 26.3.3 → 27.0.0

package/CHANGELOG.md

@@ -3,6 +3,81 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [27.0.0](https://github.com/invertase/react-native-firebase/compare/v26.4.0...v27.0.0) (2026-10-19)
+
+### ⚠ BREAKING CHANGES
+
+- **ios:** drop CocoaPods Firebase matrix; SPM-only
+- **app, sdk:** bump Firebase Android 35, Apple 13, and JS 13
+- **ml:** remove discontinued @react-native-firebase/ml package
+- **app, ios:** initializeApp now reads automaticDataCollectionEnabled as a
+  boolean. Previously any non-nil value (including JS false) enabled collection
+  via pointer cast; false, 0, null, and absent now disable it. See
+  docs/migrating-to-v27.mdx.
+
+### Features
+
+- **app, sdk:** bump Firebase Android 35, Apple 13, and JS 13 ([0ca03d1](https://github.com/invertase/react-native-firebase/commit/0ca03d11b0c271fb37cfbee8a0c3074a21969f0b))
+- **app, sdk:** bump Firebase Android SDK to 34.19.0 ([ca054bc](https://github.com/invertase/react-native-firebase/commit/ca054bc2fdcb298575f1e7412aa8b02540d53def))
+- **app, sdk:** bump Firebase iOS SDK to 12.19.0 ([95dca6a](https://github.com/invertase/react-native-firebase/commit/95dca6a4eeb849bc2910946e1477694635bee6b7))
+- **app, sdk:** bump Firebase JS SDK to 12.18.0 ([5e2617d](https://github.com/invertase/react-native-firebase/commit/5e2617dcddfd55f10f441f2e9d83fe7b4681470e))
+- **app, sdk:** bump Firebase JS SDK to 12.19.0 ([34d0318](https://github.com/invertase/react-native-firebase/commit/34d031849146527ab9b9ee3ba4fbd207bdab0803))
+- **messaging:** add messaging_installation_id_enabled firebase.json opt-in ([e9c9741](https://github.com/invertase/react-native-firebase/commit/e9c9741a65a76cc102d2d27ff675c453fd506243))
+- **ml:** remove discontinued @react-native-firebase/ml package ([58622b1](https://github.com/invertase/react-native-firebase/commit/58622b1a24a32008fd33ff56346cceb4f71bc29f))
+
+### Bug Fixes
+
+- **app, android:** bind nullable recent-task fields before use ([bed8c71](https://github.com/invertase/react-native-firebase/commit/bed8c71313cd3c0bf60bf9a9d86417ae550ec98f))
+- **app, android:** harden RecentTaskInfo null and JSON parse ([908400b](https://github.com/invertase/react-native-firebase/commit/908400b230cfd5d7d4406da9bb350332d6bc8c4c))
+- **app, expo:** match scene-based AppDelegate for Expo SDK 58 config plugin ([dce165d](https://github.com/invertase/react-native-firebase/commit/dce165d7283a30060c5b08066cf5841d9247105a))
+- **app, ios:** clarify SPM static linkage error when use_frameworks is absent ([cdf99cd](https://github.com/invertase/react-native-firebase/commit/cdf99cde79d46be737b671096e1cc3af7a14f58f))
+- **app, ios:** import ObjC NullSentinelDecoder in SharedUtils ([9a565c8](https://github.com/invertase/react-native-firebase/commit/9a565c879edc11c18b5c7ffca92c7f22e2b639e7))
+- **app, ios:** pin SPM Firebase SDK and retain Measurement ObjC categories ([7e271af](https://github.com/invertase/react-native-firebase/commit/7e271afecab65ef150140056171265e9c9ca621c))
+- **app, ios:** read automaticDataCollectionEnabled as a boolean ([cc18140](https://github.com/invertase/react-native-firebase/commit/cc181400e465895bdb012eff881209315adaed70))
+- **app, ios:** tighten the dynamic Firebase probe and import guard ([cac843c](https://github.com/invertase/react-native-firebase/commit/cac843c09156237751274073c67b6105fa7b4188))
+- **app, storage:** link Photos framework on tvOS ([56f5c1f](https://github.com/invertase/react-native-firebase/commit/56f5c1fcf83bc89d8cd80f019696e13bc96578dd))
+- **app, tests:** ignore iOS host stubs in TurboModule spec parity lookup ([e2f515d](https://github.com/invertase/react-native-firebase/commit/e2f515da36a180d16d6f6002886c17f6fd511749))
+- **app,database:** resolve platform native module when bundlers apply package exports ([959d91f](https://github.com/invertase/react-native-firebase/commit/959d91fc79d7155d1d9a08e1f836789e6e6d6156))
+- **app:** import e2e native module resolver via internal barrel ([93f51ff](https://github.com/invertase/react-native-firebase/commit/93f51fff8b2b4f1355bc213f5f98fbbf7986c7e0))
+- **app:** reject unsafe deepSet path segments ([ec3ac24](https://github.com/invertase/react-native-firebase/commit/ec3ac2455b30cfabc501845364623d9ab55e7193))
+- **app:** restore vendor EventEmitter for RN macOS 0.78 ([6b13c9d](https://github.com/invertase/react-native-firebase/commit/6b13c9d468abde5b5acc990e43a3d3fd6c7a140e))
+- **app:** seed automaticDataCollectionEnabled from the native initializeApp result ([5d187f9](https://github.com/invertase/react-native-firebase/commit/5d187f9271f183ccac4d7b70e233a4ccd2145fd0))
+- **app:** stop evaluating firebase.json content as Ruby/Python source in ios_config.sh ([d333ab3](https://github.com/invertase/react-native-firebase/commit/d333ab39a83454606d9ede4aa4a3c031a63cf898))
+- **app:** swizzle null sentinels after codegen converters load ([bcff184](https://github.com/invertase/react-native-firebase/commit/bcff18471b187bda0476c8bbc76e4c216de58ec2))
+- **ci:** unblock Yarn hardened CI and Xcode 27 iOS archive ([9c63630](https://github.com/invertase/react-native-firebase/commit/9c636307e9f87e106e802f5d39d2be32ef2cecdb))
+- **e2e:** skip watchman watch-del when a sibling Metro owns the root ([7695132](https://github.com/invertase/react-native-firebase/commit/769513224d0e6f9bb6fb2a98c578411a5016615d))
+
+### Continuous Integration
+
+- **ios:** drop CocoaPods Firebase matrix; SPM-only ([89e270f](https://github.com/invertase/react-native-firebase/commit/89e270f3d1f4c1f3c22e32ca539ebe3da30dbd7e))
+
+## [26.4.0](https://github.com/invertase/react-native-firebase/compare/v26.3.3...v26.4.0) (2026-09-05)
+
+### Features
+
+- **app:** add RNFBHandleMap for thread-safe handle registries ([d28edd5](https://github.com/invertase/react-native-firebase/commit/d28edd579281da523b626934e89a14dd38dd3ed8))
+
+### Bug Fixes
+
+- **app, android:** clear stale custom auth domains ([ccde348](https://github.com/invertase/react-native-firebase/commit/ccde3483511efd1c54bcc4676bd02893f28e9014))
+- **app, android:** discard tasks posted to shut-down transactional executors ([de98eaa](https://github.com/invertase/react-native-firebase/commit/de98eaa9ff0484eeb9e00ec99d5228067611a4f3))
+- **app, expo:** add missing Firebase imports ([7d6f19c](https://github.com/invertase/react-native-firebase/commit/7d6f19c5ba513c5880dd401e225ce19d550e27df))
+- **app, ios:** clear stale custom auth domains ([d747981](https://github.com/invertase/react-native-firebase/commit/d7479818e52f4b4df84bba53c53345942b80af85))
+- **app:** handle empty Android Firebase JSON ([5c48832](https://github.com/invertase/react-native-firebase/commit/5c48832f70a62c1061448a723f1e6a193e09c74a))
+- **app:** isolate native routing keys ([fd13a7a](https://github.com/invertase/react-native-firebase/commit/fd13a7adf84791ce1c1c4ce38a1728a86ae9c6c0))
+- **app:** make debug native proxies behavior-safe ([6caff3c](https://github.com/invertase/react-native-firebase/commit/6caff3cfc706133d132a2762b355c65979631555))
+- **app:** parse data URL payloads completely ([eb5d54e](https://github.com/invertase/react-native-firebase/commit/eb5d54e8bdbd6748e6c024b26f19bf63b764d5bb))
+- **app:** preserve empty memory storage values ([41ac6bc](https://github.com/invertase/react-native-firebase/commit/41ac6bc2f1113a6412e23dd171752f6e5762c335))
+- **app:** preserve memidb event listeners ([c8648a6](https://github.com/invertase/react-native-firebase/commit/c8648a622533afd2f2a94ed36c3acd57c611a2b2))
+- **app:** preserve web Promise contracts ([36c586e](https://github.com/invertase/react-native-firebase/commit/36c586ea908a2faaebf1d40846497bde096a779c))
+- **app:** reject FileReader startup failures ([08319ae](https://github.com/invertase/react-native-firebase/commit/08319aed8191ab823a506b3166c18b8ef02853ac))
+- **app:** retain global logger configuration ([23aeb7b](https://github.com/invertase/react-native-firebase/commit/23aeb7bb5fe60f9421ba81b3f88c859dfd6d3d49))
+- **app:** support arbitrary web storage keys ([c2c9f42](https://github.com/invertase/react-native-firebase/commit/c2c9f4261464bf56c3e6521f54448dbe4649392f))
+- **app:** support prototype-named apps ([0ed7a0f](https://github.com/invertase/react-native-firebase/commit/0ed7a0fd7c99c894e2b94fd3de733dfa43096af2))
+- **auth, ios:** look up customAuthDomains with JS app name ([9873f61](https://github.com/invertase/react-native-firebase/commit/9873f618a972c3324ec05b9e30f5aaefa7ab163b))
+- **database:** use RNFBHandleMap for transaction and query maps ([8adba4c](https://github.com/invertase/react-native-firebase/commit/8adba4cb88dffec2442ea0fe37738d1080d0a185))
+- **messaging, android:** support disabled notification storage ([afaba0b](https://github.com/invertase/react-native-firebase/commit/afaba0b3862b65a2bd83bbbfebfae3ac576811fd))
+
 ## [26.3.3](https://github.com/invertase/react-native-firebase/compare/v26.3.2...v26.3.3) (2026-09-01)
 
 ### Bug Fixes

package/README.md

@@ -36,40 +36,23 @@ yarn add @react-native-firebase/app
 
 - [Utils](https://rnfirebase.io/app/utils)
 
-## iOS Dependency Resolution: SPM vs CocoaPods
+## iOS Dependency Resolution (SPM-only)
 
-React Native 0.75 and newer use Swift Package Manager by default to resolve
-Firebase iOS SDK dependencies. SPM requires dynamic linkage:
+Firebase Apple SDK 13+ is distributed **only** via Swift Package Manager.
+React Native Firebase requires React Native 0.75+ (`spm_dependency`) and
+dynamic linkage:
 
 ```ruby
 use_frameworks! :linkage => :dynamic
 ```
 
-To use CocoaPods instead, add this before any target block in your Podfile:
+`$RNFirebaseDisableSPM = true` and Expo `ios.disableSPM: true` /
+`disableSPM: true` **fail** `pod install` / prebuild — CocoaPods Firebase is
+no longer available. Remove those flags and stay on SPM + dynamic frameworks.
 
-```ruby
-$RNFirebaseDisableSPM = true
-```
-
-Expo projects can set the same flag through the config plugin, which adds it
-to the generated Podfile during prebuild:
-
-```json
-[
-  "@react-native-firebase/app",
-  {
-    "ios": {
-      "disableSPM": true
-    }
-  }
-]
-```
-
-CocoaPods mode supports static or dynamic linkage. React Native versions older
-than 0.75 fall back to CocoaPods automatically.
-
-See the [iOS SPM guide](https://rnfirebase.io/ios-spm) for Xcode 26 setup,
-Expo configuration, framework-embedding fallback, and troubleshooting.
+See [iOS SPM Support](https://rnfirebase.io/ios-spm) and
+[Migrating to v27](https://rnfirebase.io/migrating-to-v27) for setup,
+Expo configuration, and troubleshooting.
 
 ## License
 

package/RNFBApp.podspec

@@ -23,9 +23,15 @@ Pod::Spec.new do |s|
   s.macos.deployment_target = firebase_macos_target
   s.tvos.deployment_target = firebase_tvos_target
   s.cocoapods_version   = '>= 1.12.0'
-  s.source_files        = "ios/**/*.{h,m,mm,cpp}"
+  s.swift_version       = '5.10'
+  s.source_files        = "ios/**/*.{h,m,mm,cpp,swift}"
   s.private_header_files = "ios/**/*.h"
-  s.exclude_files       = 'ios/generated/RCTThirdPartyComponentsProvider.*', 'ios/generated/RCTAppDependencyProvider.*', 'ios/generated/RCTModuleProviders.*', 'ios/generated/RCTModulesConformingToProtocolsProvider.*', 'ios/generated/RCTUnstableModulesRequiringMainQueueSetupProvider.*'
+  # CocoaPods FileList uses FNM_PATHNAME: `ios/*UnitTests/**` does not match nested
+  # paths like `ios/RNFBAppUnitTests/HostStubs/**` (those would compile into the pod).
+  # CocoaPods FileList uses FNM_PATHNAME: a trailing `/**` alone does not match
+  # nested files (same reason UnitTests use `/**/*`). Exclude the CI-only local
+  # SPM package so its sources are never compiled into the RNFBApp pod.
+  s.exclude_files       = 'ios/generated/RCTThirdPartyComponentsProvider.*', 'ios/generated/RCTAppDependencyProvider.*', 'ios/generated/RCTModuleProviders.*', 'ios/generated/RCTModulesConformingToProtocolsProvider.*', 'ios/generated/RCTUnstableModulesRequiringMainQueueSetupProvider.*', 'ios/*UnitTests/**/*', 'ios/RNFBFirebase/**/*'
 
   # Fail fast for old architecture users, but safely in case the variable goes away
   # completely in future react-native versions
@@ -42,15 +48,17 @@ Pod::Spec.new do |s|
     "CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES" => "YES",
   }
 
-  # RNFBUtilsModule.mm uses PHAsset (Photos.framework) to resolve local asset paths.
+  # RNFBUtilsModule+PhotoAssets.m uses PHAsset (Photos.framework) to resolve local asset paths.
   # Not declaring this explicitly used to work by luck (CocoaPods normally relies on
   # this declaration -- not Clang autolinking -- to populate OTHER_LDFLAGS), but with
   # use_frameworks! each pod is a standalone dynamic framework that must resolve its
   # own symbols at its own link step, so the missing declaration now surfaces as
-  # "Undefined symbols ... _OBJC_CLASS_$_PHAsset". iOS/macOS only -- PhotoKit doesn't
-  # exist on tvOS.
+  # "Undefined symbols ... _OBJC_CLASS_$_PHAsset". PhotoKit is available on
+  # tvOS 10+, and this .m file emits no Clang autolink record, so tvOS needs
+  # the same explicit link.
   s.ios.frameworks = 'Photos'
   s.osx.frameworks = 'Photos'
+  s.tvos.frameworks = 'Photos'
 
   # React Native dependencies
   if defined?(install_modules_dependencies()) != nil

package/android/build.gradle

@@ -14,6 +14,7 @@ buildscript {
 
     dependencies {
       classpath("com.android.tools.build:gradle:8.4.0")
+      classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:${project.findProperty('kotlinVersion') ?: '2.4.0'}")
     }
   }
 }
@@ -22,6 +23,8 @@ plugins {
   id "io.invertase.gradle.build" version "1.5"
 }
 
+apply plugin: "org.jetbrains.kotlin.android"
+
 def packageJson = PackageJson.getForProject(project)
 def firebaseBomVersion = packageJson['sdkVersions']['android']['firebase']
 def playServicesAuthVersion = packageJson['sdkVersions']['android']['playServicesAuth']

package/android/src/main/java/io/invertase/firebase/common/RNFBHandleCollisionException.kt

@@ -0,0 +1,29 @@
+package io.invertase.firebase.common
+
+/*
+ * 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.
+ *
+ */
+
+/**
+ * Thrown when [RNFBHandleMap.put] is asked to register an id that is already occupied.
+ *
+ * This remains a checked Java-visible exception ([Exception], not [RuntimeException]) so callers
+ * must handle collisions explicitly. There is no upsert: replace an existing registration with
+ * [RNFBHandleMap.take] then [RNFBHandleMap.put].
+ */
+open class RNFBHandleCollisionException(
+  id: Any?,
+) : Exception("Handle id already registered: $id")

package/android/src/main/java/io/invertase/firebase/common/RNFBHandleMap.kt

@@ -0,0 +1,146 @@
+package io.invertase.firebase.common
+
+/*
+ * 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 java.util.function.Predicate
+
+/**
+ * Thread-safe id → handle registry. The lock only moves pointers; this class never invokes methods
+ * on stored values (no SDK `cancel`/`remove`). Callers [take] or [takeAll], then act on the returned
+ * object(s) outside the lock.
+ *
+ * [put] is unique: an occupied id throws [RNFBHandleCollisionException]. There is no upsert. Use
+ * [putIfAbsent] (first wins), [putIfAbsentOrSame] (first wins or same instance), or [putReplacing]
+ * (last wins) for atomic upsert. Replace at the call site with `take` then `put` only when neither
+ * helper fits.
+ *
+ * **Do not lock on the map or on a [RNFBHandleMap] instance.** Callers that synchronize on `this`
+ * (or on the internal map) can deadlock with the dedicated monitor. Android uses a private [lock]
+ * object; never expose it and never `synchronized(this)` around these methods.
+ */
+open class RNFBHandleMap<K, V> {
+  private val lock = Any()
+  private val map = HashMap<K, V>()
+
+  /**
+   * Registers [handle] under [id].
+   *
+   * @throws RNFBHandleCollisionException if [id] is already occupied
+   */
+  @Throws(RNFBHandleCollisionException::class)
+  open fun put(
+    id: K,
+    handle: V,
+  ) {
+    synchronized(lock) {
+      if (map.containsKey(id)) {
+        throw RNFBHandleCollisionException(id)
+      }
+      map[id] = handle
+    }
+  }
+
+  /**
+   * Stores [handle] under [id] only when the id is free (first wins).
+   *
+   * @return `true` if stored, `false` if [id] was already occupied
+   */
+  open fun putIfAbsent(
+    id: K,
+    handle: V,
+  ): Boolean =
+    synchronized(lock) {
+      if (map.containsKey(id)) {
+        false
+      } else {
+        map[id] = handle
+        true
+      }
+    }
+
+  /**
+   * Under one lock: stores [handle] when the id is free, or returns `true` when the existing mapping
+   * is the same instance (`===`). Returns `false` when occupied by a different handle.
+   */
+  open fun putIfAbsentOrSame(
+    id: K,
+    handle: V,
+  ): Boolean =
+    synchronized(lock) {
+      if (!map.containsKey(id)) {
+        map[id] = handle
+        true
+      } else {
+        map[id] === handle
+      }
+    }
+
+  /**
+   * Atomically replaces the mapping for [id] (last wins). Returns the previous handle, or `null` if
+   * the id was free.
+   */
+  open fun putReplacing(
+    id: K,
+    handle: V,
+  ): V? = synchronized(lock) { map.put(id, handle) }
+
+  /**
+   * Peeks at the handle for [id] without removing it (for emit while still registered).
+   *
+   * @return the handle, or `null` if absent
+   */
+  open fun get(id: K): V? = synchronized(lock) { map[id] }
+
+  /**
+   * Removes and returns the handle for [id].
+   *
+   * @return the handle, or `null` if absent
+   */
+  open fun take(id: K): V? = synchronized(lock) { map.remove(id) }
+
+  /**
+   * When [id] is mapped and [shouldTake] accepts the handle, removes and returns it; otherwise
+   * returns `null` and leaves the map unchanged. Lookup, predicate, and removal run under one lock —
+   * use for check-and-take that must not race with concurrent [put] / [take] on the same id.
+   *
+   * The predicate runs under this map's lock; keep it lightweight (no SDK cancel/remove).
+   */
+  open fun takeIf(
+    id: K,
+    shouldTake: Predicate<V>,
+  ): V? =
+    synchronized(lock) {
+      val value = map[id]
+      if (value != null && shouldTake.test(value)) {
+        map.remove(id)
+      } else {
+        null
+      }
+    }
+
+  /**
+   * Snapshot of current values, then clear. Cancel/remove each returned object after this method
+   * returns, not under this map's lock.
+   */
+  open fun takeAll(): List<V> =
+    synchronized(lock) {
+      val values = ArrayList(map.values)
+      map.clear()
+      values
+    }
+}

package/android/src/main/java/io/invertase/firebase/common/TaskExecutorService.kt

@@ -0,0 +1,156 @@
+package io.invertase.firebase.common
+
+/*
+ * 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 java.util.concurrent.ExecutorService
+import java.util.concurrent.LinkedBlockingQueue
+import java.util.concurrent.RejectedExecutionException
+import java.util.concurrent.RejectedExecutionHandler
+import java.util.concurrent.SynchronousQueue
+import java.util.concurrent.ThreadPoolExecutor
+import java.util.concurrent.TimeUnit
+
+open class TaskExecutorService(
+  private val name: String,
+) {
+  private val maximumPoolSize: Int
+  private val keepAliveSeconds: Int
+
+  init {
+    val json = ReactNativeFirebaseJSON.getSharedInstance()
+    maximumPoolSize = json.getIntValue(MAXIMUM_POOL_SIZE_KEY, 1)
+    keepAliveSeconds = json.getIntValue(KEEP_ALIVE_SECONDS_KEY, 3)
+  }
+
+  open fun getExecutor(): ExecutorService {
+    val isTransactional = maximumPoolSize <= 1
+    return getExecutor(isTransactional, "")
+  }
+
+  open fun getTransactionalExecutor(): ExecutorService = getExecutor(true, "")
+
+  open fun getTransactionalExecutor(identifier: String): ExecutorService {
+    val executorIdentifier = if (maximumPoolSize != 0) identifier else ""
+    return getExecutor(true, executorIdentifier)
+  }
+
+  open fun getExecutor(
+    isTransactional: Boolean,
+    identifier: String,
+  ): ExecutorService {
+    val executorName = getExecutorName(isTransactional, identifier)
+    synchronized(executors) {
+      val existingExecutor = executors[executorName]
+      if (existingExecutor == null) {
+        val newExecutor = getNewExecutor(isTransactional)
+        executors[executorName] = newExecutor
+        return newExecutor
+      }
+      return existingExecutor
+    }
+  }
+
+  private fun getNewExecutor(isTransactional: Boolean): ExecutorService {
+    if (isTransactional) {
+      // A bare Executors.newSingleThreadExecutor() has no rejection handler, so a
+      // play-services Task completing after shutdown() (module invalidation racing
+      // in-flight work, e.g. App Check attestation or Auth network calls finishing
+      // while the React instance is torn down) posts to the dead executor and
+      // crashes the process with an uncaught RejectedExecutionException. Use an
+      // equivalent single-thread pool that discards work arriving after shutdown.
+      return ThreadPoolExecutor(
+        1,
+        1,
+        0L,
+        TimeUnit.MILLISECONDS,
+        LinkedBlockingQueue(),
+      ).apply { rejectedExecutionHandler = discardAfterShutdown }
+    }
+
+    return ThreadPoolExecutor(
+      0,
+      maximumPoolSize,
+      keepAliveSeconds.toLong(),
+      TimeUnit.SECONDS,
+      SynchronousQueue(),
+    ).apply { rejectedExecutionHandler = executeInFallback }
+  }
+
+  private val executeInFallback =
+    RejectedExecutionHandler { runnable, executor ->
+      // isShutdown() remains true through the terminating and terminated states,
+      // so it is the only check needed to detect work arriving after shutdown.
+      if (executor.isShutdown) {
+        return@RejectedExecutionHandler
+      }
+      val fallbackExecutor = getTransactionalExecutor()
+      fallbackExecutor.execute(runnable)
+    }
+
+  open fun getExecutorName(
+    isTransactional: Boolean,
+    identifier: String,
+  ): String =
+    if (isTransactional) {
+      "${name}TransactionalExecutor$identifier"
+    } else {
+      "${name}Executor$identifier"
+    }
+
+  open fun shutdown() {
+    synchronized(executors) {
+      val existingExecutorNames = ArrayList(executors.keys)
+      for (executorName in existingExecutorNames) {
+        if (!executorName.startsWith(name)) {
+          executors.remove(executorName)
+        } else {
+          removeExecutor(executorName)
+        }
+      }
+    }
+  }
+
+  open fun removeExecutor(executorName: String) {
+    synchronized(executors) {
+      val existingExecutor = executors[executorName]
+      if (existingExecutor != null) {
+        existingExecutor.shutdownNow()
+        executors.remove(executorName)
+      }
+    }
+  }
+
+  private companion object {
+    private const val MAXIMUM_POOL_SIZE_KEY = "android_task_executor_maximum_pool_size"
+    private const val KEEP_ALIVE_SECONDS_KEY = "android_task_executor_keep_alive_seconds"
+
+    private val executors = HashMap<String, ExecutorService>()
+
+    private val discardAfterShutdown =
+      RejectedExecutionHandler { runnable, executor ->
+        // isShutdown() remains true through the terminating and terminated states,
+        // so it is the only check needed to detect work arriving after shutdown.
+        if (executor.isShutdown) {
+          return@RejectedExecutionHandler
+        }
+        // Unreachable with an unbounded queue, but preserve AbortPolicy semantics
+        // for any rejection that is not caused by shutdown.
+        throw RejectedExecutionException("Task $runnable rejected from $executor")
+      }
+  }
+}

package/android/src/main/java/io/invertase/firebase/common/UniversalFirebaseModule.kt

@@ -0,0 +1,44 @@
+package io.invertase.firebase.common
+
+/*
+ * 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 android.content.Context
+import java.util.HashMap
+import java.util.concurrent.ExecutorService
+import javax.annotation.OverridingMethodsMustInvokeSuper
+
+open class UniversalFirebaseModule(
+  private val context: Context?,
+  private val serviceName: String?,
+) {
+  private val executorService: TaskExecutorService = TaskExecutorService(getName())
+
+  open fun getContext(): Context? = context
+
+  open fun getApplicationContext(): Context? = getContext()!!.applicationContext
+
+  open fun getExecutor(): ExecutorService = executorService.getExecutor()
+
+  open fun getName(): String = "Universal${serviceName}Module"
+
+  @OverridingMethodsMustInvokeSuper
+  open fun onTearDown() {
+    executorService.shutdown()
+  }
+
+  open fun getConstants(): Map<String, Any> = HashMap()
+}

package/android/src/main/java/io/invertase/firebase/common/UniversalFirebasePreferences.kt

@@ -0,0 +1,100 @@
+package io.invertase.firebase.common
+
+/*
+ * 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 android.content.Context
+import android.content.SharedPreferences
+import io.invertase.firebase.app.ReactNativeFirebaseApp
+
+open class UniversalFirebasePreferences {
+  private var preferences: SharedPreferences? = null
+
+  open fun contains(key: String?): Boolean = getPreferences().contains(key)
+
+  open fun setBooleanValue(
+    key: String?,
+    value: Boolean,
+  ) {
+    getPreferences().edit().putBoolean(key, value).apply()
+  }
+
+  open fun getBooleanValue(
+    key: String?,
+    defaultValue: Boolean,
+  ): Boolean = getPreferences().getBoolean(key, defaultValue)
+
+  open fun setIntValue(
+    key: String?,
+    value: Int,
+  ) {
+    getPreferences().edit().putInt(key, value).apply()
+  }
+
+  open fun getIntValue(
+    key: String?,
+    defaultValue: Int,
+  ): Int = getPreferences().getInt(key, defaultValue)
+
+  open fun setLongValue(
+    key: String?,
+    value: Long,
+  ) {
+    getPreferences().edit().putLong(key, value).apply()
+  }
+
+  open fun getLongValue(
+    key: String?,
+    defaultValue: Long,
+  ): Long = getPreferences().getLong(key, defaultValue)
+
+  open fun setStringValue(
+    key: String?,
+    value: String?,
+  ) {
+    getPreferences().edit().putString(key, value).apply()
+  }
+
+  open fun getStringValue(
+    key: String?,
+    defaultValue: String?,
+  ): String? = getPreferences().getString(key, defaultValue)
+
+  open fun clearAll() {
+    getPreferences().edit().clear().apply()
+  }
+
+  // The caller is responsible for calling apply() or commit() on the returned editor.
+  open fun remove(key: String?): SharedPreferences.Editor = getPreferences().edit().remove(key)
+
+  private fun getPreferences(): SharedPreferences {
+    if (preferences == null) {
+      preferences =
+        ReactNativeFirebaseApp
+          .getApplicationContext()
+          .getSharedPreferences(PREFERENCES_FILE, Context.MODE_PRIVATE)
+    }
+    return preferences!!
+  }
+
+  companion object {
+    private const val PREFERENCES_FILE = "io.invertase.firebase"
+    private val sharedInstance = UniversalFirebasePreferences()
+
+    @JvmStatic fun getSharedInstance(): UniversalFirebasePreferences = sharedInstance
+  }
+}