@react-native-firebase/app-check 26.4.1 → 26.4.2

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [26.4.2](https://github.com/invertase/react-native-firebase/compare/v26.4.1...v26.4.2) (2026-11-10)
+
+### Bug Fixes
+
+- **app-check:** report provider setup failures and align Android provider readiness with iOS ([#9405](https://github.com/invertase/react-native-firebase/issues/9405)) ([0c56276](https://github.com/invertase/react-native-firebase/commit/0c56276075b2af3d452fe817c68e6bc1efcd81e9))
+
 ## [26.4.1](https://github.com/invertase/react-native-firebase/compare/v26.4.0...v26.4.1) (2026-10-23)
 
 **Note:** Version bump only for package @react-native-firebase/app-check

package/android/build.gradle

@@ -105,6 +105,7 @@ dependencies {
   implementation "com.google.firebase:firebase-appcheck-debug"
 
   testImplementation "junit:junit:4.13.2"
+  testImplementation "org.mockito:mockito-core:5.14.2"
 }
 
 ReactNative.shared.applyPackageVersion()

package/android/src/main/java/io/invertase/firebase/appcheck/NativeRNFBTurboAppCheck.java

@@ -83,6 +83,53 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
     return enabled;
   }
 
+  static String activateProviderName(boolean isDebuggable) {
+    return isDebuggable ? "debug" : "playIntegrity";
+  }
+
+  // build.gradle stringifies an unset FIREBASE_APP_CHECK_DEBUG_TOKEN env var as "null".
+  static String buildConfigDebugToken(String buildConfigValue) {
+    return "null".equals(buildConfigValue) ? null : buildConfigValue;
+  }
+
+  static boolean isProviderNotReady(Throwable error) {
+    for (Throwable cause = error; cause != null; cause = cause.getCause()) {
+      if (cause instanceof ReactNativeFirebaseAppCheckProvider.ProviderNotReadyException) {
+        return true;
+      }
+    }
+    return false;
+  }
+
+  static String tokenErrorCode(Throwable error) {
+    return isProviderNotReady(error) ? "provider-not-ready" : "token-error";
+  }
+
+  static String tokenErrorMessage(Throwable error) {
+    if (isProviderNotReady(error)) {
+      return ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE;
+    }
+    return error != null ? error.getMessage() : null;
+  }
+
+  static String setupErrorMessage(Throwable error) {
+    String message = error != null ? error.getMessage() : null;
+    return message == null || message.isEmpty() ? "internal-error" : message;
+  }
+
+  static boolean rejectIfProviderNotReady(
+      ReactNativeFirebaseAppCheckProviderFactory factory, String appName, Promise promise) {
+    if (factory.isProviderReady(appName)) {
+      return false;
+    }
+    Log.d(LOGTAG, "provider not ready for app " + appName + " (delegateProvider null)");
+    rejectPromiseWithCodeAndMessage(
+        promise,
+        "provider-not-ready",
+        ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE);
+    return true;
+  }
+
   public NativeRNFBTurboAppCheck(ReactApplicationContext reactContext) {
     super(reactContext);
     this.executorService = new TaskExecutorService("UniversalAppCheckModule");
@@ -134,7 +181,7 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
           .installAppCheckProviderFactory(providerFactory);
       promise.resolve(null);
     } catch (Exception e) {
-      rejectPromiseWithCodeAndMessage(promise, "unknown", "internal-error", e.getMessage());
+      rejectPromiseWithCodeAndMessage(promise, "unknown", setupErrorMessage(e), e.getMessage());
     }
   }
 
@@ -146,27 +193,27 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
           FirebaseAppCheck.getInstance(FirebaseApp.getInstance(appName));
       firebaseAppCheck.setTokenAutoRefreshEnabled(isTokenAutoRefreshEnabled);
 
-      if (isAppDebuggable()) {
+      boolean isDebuggable = isAppDebuggable();
+      String debugToken = null;
+      if (isDebuggable) {
         Log.d(LOGTAG, "app is debuggable, configuring AppCheck for testing mode");
-        if (BuildConfig.FIREBASE_APP_CHECK_DEBUG_TOKEN != "null") {
+        debugToken = buildConfigDebugToken(BuildConfig.FIREBASE_APP_CHECK_DEBUG_TOKEN);
+        if (debugToken != null) {
           Log.d(LOGTAG, "debug app check token found in BuildConfig. Installing known token.");
-          providerFactory.configure(appName, "debug", BuildConfig.FIREBASE_APP_CHECK_DEBUG_TOKEN);
         } else {
           Log.d(
               LOGTAG,
               "no debug app check token found in BuildConfig. Check Log for dynamic test token to"
                   + " configure in console.");
-          providerFactory.configure(appName, "debug", null);
         }
-      } else {
-        providerFactory.configure(appName, "safetyNet", null);
       }
+      providerFactory.configure(appName, activateProviderName(isDebuggable), debugToken);
 
       FirebaseAppCheck.getInstance(FirebaseApp.getInstance(appName))
           .installAppCheckProviderFactory(providerFactory);
       promise.resolve(null);
     } catch (Exception e) {
-      rejectPromiseWithCodeAndMessage(promise, "unknown", "internal-error", e.getMessage());
+      rejectPromiseWithCodeAndMessage(promise, "unknown", setupErrorMessage(e), e.getMessage());
     }
   }
 
@@ -185,6 +232,9 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
   public void getToken(String appName, boolean forceRefresh, Promise promise) {
     Log.d(LOGTAG, "getToken appName/forceRefresh: " + appName + "/" + forceRefresh);
     FirebaseApp firebaseApp = FirebaseApp.getInstance(appName);
+    if (rejectIfProviderNotReady(providerFactory, appName, promise)) {
+      return;
+    }
     Tasks.call(
             getExecutor(),
             () ->
@@ -198,12 +248,13 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
                 tokenResultMap.putString("token", task.getResult().getToken());
                 promise.resolve(tokenResultMap);
               } else {
+                Exception exception = task.getException();
                 Log.e(
                     LOGTAG,
                     "RNFB: Unknown error while fetching AppCheck token "
-                        + task.getException().getMessage());
+                        + tokenErrorMessage(exception));
                 rejectPromiseWithCodeAndMessage(
-                    promise, "token-error", task.getException().getMessage());
+                    promise, tokenErrorCode(exception), tokenErrorMessage(exception));
               }
             });
   }
@@ -212,6 +263,9 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
   public void getLimitedUseToken(String appName, Promise promise) {
     Log.d(LOGTAG, "getLimitedUseToken appName: " + appName);
     FirebaseApp firebaseApp = FirebaseApp.getInstance(appName);
+    if (rejectIfProviderNotReady(providerFactory, appName, promise)) {
+      return;
+    }
 
     Tasks.call(
             getExecutor(),
@@ -225,12 +279,13 @@ public class NativeRNFBTurboAppCheck extends NativeRNFBTurboAppCheckSpec {
                 tokenResultMap.putString("token", task.getResult().getToken());
                 promise.resolve(tokenResultMap);
               } else {
+                Exception exception = task.getException();
                 Log.e(
                     LOGTAG,
                     "Unknown error while fetching limited-use AppCheck token "
-                        + task.getException().getMessage());
+                        + tokenErrorMessage(exception));
                 rejectPromiseWithCodeAndMessage(
-                    promise, "token-error", task.getException().getMessage());
+                    promise, tokenErrorCode(exception), tokenErrorMessage(exception));
               }
             });
   }

package/android/src/main/java/io/invertase/firebase/appcheck/ReactNativeFirebaseAppCheckProvider.java

@@ -20,6 +20,7 @@ package io.invertase.firebase.appcheck;
 import android.util.Log;
 import androidx.annotation.NonNull;
 import com.google.android.gms.tasks.Task;
+import com.google.android.gms.tasks.Tasks;
 import com.google.firebase.FirebaseApp;
 import com.google.firebase.appcheck.AppCheckProvider;
 import com.google.firebase.appcheck.AppCheckToken;
@@ -36,13 +37,42 @@ import java.util.concurrent.Executors;
 public class ReactNativeFirebaseAppCheckProvider implements AppCheckProvider {
   private static final String LOGTAG = "RNFBAppCheck";
 
-  AppCheckProvider delegateProvider;
+  static final String PROVIDER_NOT_READY_MESSAGE =
+      "App Check provider is not ready. Call initializeAppCheck before requesting tokens.";
+
+  static final class ProviderNotReadyException extends IllegalStateException {
+    ProviderNotReadyException() {
+      super(PROVIDER_NOT_READY_MESSAGE);
+    }
+  }
+
+  volatile AppCheckProvider delegateProvider;
 
   @NonNull
   @Override
   public Task<AppCheckToken> getToken() {
+    AppCheckProvider delegate = delegateProvider;
+    if (delegate == null) {
+      return providerNotReady("getToken");
+    }
     Log.d(LOGTAG, "Provider::getToken - delegating to native provider");
-    return delegateProvider.getToken();
+    return delegate.getToken();
+  }
+
+  @NonNull
+  @Override
+  public Task<AppCheckToken> getLimitedUseToken() {
+    AppCheckProvider delegate = delegateProvider;
+    if (delegate == null) {
+      return providerNotReady("getLimitedUseToken");
+    }
+    Log.d(LOGTAG, "Provider::getLimitedUseToken - delegating to native provider");
+    return delegate.getLimitedUseToken();
+  }
+
+  private static Task<AppCheckToken> providerNotReady(String method) {
+    Log.d(LOGTAG, "Provider::" + method + " - provider not ready (no delegate configured)");
+    return Tasks.forException(new ProviderNotReadyException());
   }
 
   public void configure(String appName, String providerName, String debugToken) {
@@ -55,39 +85,16 @@ public class ReactNativeFirebaseAppCheckProvider implements AppCheckProvider {
             + "/"
             + (debugToken != null ? "(not shown)" : "null"));
 
-    try {
-      FirebaseApp app = FirebaseApp.getInstance(appName);
+    // Reset first so a failed reconfigure cannot leave the previous delegate serving tokens.
+    delegateProvider = null;
 
+    try {
       if ("debug".equals(providerName)) {
-
-        // the debug configuration may have a token, or may not
-        if (debugToken != null) {
-          // To use this token, create debug provider using local secret provider + standard thread
-          // pool
-          ExecutorService executor = Executors.newCachedThreadPool();
-          delegateProvider =
-              new DebugAppCheckProvider(
-                  app,
-                  new Provider<InternalDebugSecretProvider>() {
-                    public InternalDebugSecretProvider get() {
-                      return new InternalDebugSecretProvider() {
-                        public String getDebugSecret() {
-                          return debugToken;
-                        }
-                      };
-                    }
-                  },
-                  executor,
-                  executor,
-                  executor);
-
-        } else {
-          delegateProvider = DebugAppCheckProviderFactory.getInstance().create(app);
-        }
+        delegateProvider = createDebugProvider(getFirebaseApp(appName), debugToken);
       }
 
       if ("playIntegrity".equals(providerName)) {
-        delegateProvider = PlayIntegrityAppCheckProviderFactory.getInstance().create(app);
+        delegateProvider = createPlayIntegrityProvider(getFirebaseApp(appName));
       }
 
       if (delegateProvider == null) {
@@ -103,4 +110,33 @@ public class ReactNativeFirebaseAppCheckProvider implements AppCheckProvider {
       throw new RuntimeException(e.getMessage());
     }
   }
+
+  FirebaseApp getFirebaseApp(String appName) {
+    return FirebaseApp.getInstance(appName);
+  }
+
+  AppCheckProvider createDebugProvider(FirebaseApp app, String debugToken) {
+    if (debugToken == null) {
+      return DebugAppCheckProviderFactory.getInstance().create(app);
+    }
+    ExecutorService executor = Executors.newCachedThreadPool();
+    return new DebugAppCheckProvider(
+        app,
+        new Provider<InternalDebugSecretProvider>() {
+          public InternalDebugSecretProvider get() {
+            return new InternalDebugSecretProvider() {
+              public String getDebugSecret() {
+                return debugToken;
+              }
+            };
+          }
+        },
+        executor,
+        executor,
+        executor);
+  }
+
+  AppCheckProvider createPlayIntegrityProvider(FirebaseApp app) {
+    return PlayIntegrityAppCheckProviderFactory.getInstance().create(app);
+  }
 }

package/android/src/main/java/io/invertase/firebase/appcheck/ReactNativeFirebaseAppCheckProviderFactory.java

@@ -22,13 +22,14 @@ import androidx.annotation.NonNull;
 import com.google.firebase.FirebaseApp;
 import com.google.firebase.appcheck.AppCheckProvider;
 import com.google.firebase.appcheck.AppCheckProviderFactory;
-import java.util.HashMap;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
 
 public class ReactNativeFirebaseAppCheckProviderFactory implements AppCheckProviderFactory {
   private static final String LOGTAG = "RNFBAppCheck";
 
   // This object has one job - create + maintain control over one provider per app
-  public HashMap<String, ReactNativeFirebaseAppCheckProvider> providers = new HashMap<>();
+  public Map<String, ReactNativeFirebaseAppCheckProvider> providers = new ConcurrentHashMap<>();
 
   // Our provider will serve as a facade to all the supported native providers,
   // we will just pass through configuration calls to it
@@ -41,17 +42,16 @@ public class ReactNativeFirebaseAppCheckProviderFactory implements AppCheckProvi
             + providerName
             + (debugToken != null ? "/(not shown)" : "/null"));
 
-    ReactNativeFirebaseAppCheckProvider provider;
-
-    // Look up the correct provider for the given appName, create it if not created
-    provider = providers.get(appName);
-    if (provider == null) {
-      provider = new ReactNativeFirebaseAppCheckProvider();
-      providers.put(appName, provider);
-    }
+    ReactNativeFirebaseAppCheckProvider provider =
+        providers.computeIfAbsent(appName, k -> new ReactNativeFirebaseAppCheckProvider());
     provider.configure(appName, providerName, debugToken);
   }
 
+  boolean isProviderReady(String appName) {
+    ReactNativeFirebaseAppCheckProvider provider = providers.get(appName);
+    return provider != null && provider.delegateProvider != null;
+  }
+
   @NonNull
   public AppCheckProvider create(FirebaseApp firebaseApp) {
     String appName = firebaseApp.getName();

package/android/src/test/java/io/invertase/firebase/appcheck/ReactNativeFirebaseAppCheckProviderTest.java

@@ -0,0 +1,408 @@
+package io.invertase.firebase.appcheck;
+
+/*
+ * 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 static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertNull;
+import static org.junit.Assert.assertSame;
+import static org.junit.Assert.assertThrows;
+import static org.junit.Assert.assertTrue;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.mockStatic;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+import static org.mockito.Mockito.when;
+
+import android.util.Log;
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.WritableMap;
+import com.google.android.gms.tasks.Task;
+import com.google.android.gms.tasks.Tasks;
+import com.google.firebase.FirebaseApp;
+import com.google.firebase.appcheck.AppCheckProvider;
+import com.google.firebase.appcheck.AppCheckToken;
+import java.util.concurrent.ExecutionException;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+
+/**
+ * JVM coverage for {@link ReactNativeFirebaseAppCheckProvider} configure / token requests. Firebase
+ * lookups and native delegate construction are replaced through the package-private seams.
+ */
+public class ReactNativeFirebaseAppCheckProviderTest {
+
+  private static final class FakeDelegate implements AppCheckProvider {
+    final Task<AppCheckToken> task = Tasks.forException(new Exception("fake-delegate"));
+    final Task<AppCheckToken> limitedUseTask =
+        Tasks.forException(new Exception("fake-delegate-limited-use"));
+    int getTokenCount;
+    int getLimitedUseTokenCount;
+
+    @Override
+    public Task<AppCheckToken> getToken() {
+      getTokenCount++;
+      return task;
+    }
+
+    @Override
+    public Task<AppCheckToken> getLimitedUseToken() {
+      getLimitedUseTokenCount++;
+      return limitedUseTask;
+    }
+  }
+
+  private static final class TestProvider extends ReactNativeFirebaseAppCheckProvider {
+    final FirebaseApp app = mock(FirebaseApp.class);
+    final FakeDelegate debugDelegate = new FakeDelegate();
+    final FakeDelegate playIntegrityDelegate = new FakeDelegate();
+    String lastAppName;
+    FirebaseApp lastDebugApp;
+    String lastDebugToken;
+    FirebaseApp lastPlayIntegrityApp;
+    RuntimeException getFirebaseAppFailure;
+
+    @Override
+    FirebaseApp getFirebaseApp(String appName) {
+      lastAppName = appName;
+      if (getFirebaseAppFailure != null) {
+        throw getFirebaseAppFailure;
+      }
+      return app;
+    }
+
+    @Override
+    AppCheckProvider createDebugProvider(FirebaseApp app, String debugToken) {
+      lastDebugApp = app;
+      lastDebugToken = debugToken;
+      return debugDelegate;
+    }
+
+    @Override
+    AppCheckProvider createPlayIntegrityProvider(FirebaseApp app) {
+      lastPlayIntegrityApp = app;
+      return playIntegrityDelegate;
+    }
+  }
+
+  private MockedStatic<Log> log;
+
+  @Before
+  public void setUp() {
+    log = mockStatic(Log.class);
+  }
+
+  @After
+  public void tearDown() {
+    log.close();
+  }
+
+  @Test
+  public void getToken_withoutConfigure_failsClosedInsteadOfThrowing() {
+    Task<AppCheckToken> task = new ReactNativeFirebaseAppCheckProvider().getToken();
+
+    assertTrue(task.isComplete());
+    assertFalse(task.isSuccessful());
+    assertTrue(task.getException() instanceof IllegalStateException);
+    assertEquals(
+        ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE,
+        task.getException().getMessage());
+  }
+
+  @Test
+  public void getLimitedUseToken_withoutConfigure_failsClosedInsteadOfThrowing() {
+    Task<AppCheckToken> task = new ReactNativeFirebaseAppCheckProvider().getLimitedUseToken();
+
+    assertTrue(task.isComplete());
+    assertFalse(task.isSuccessful());
+    assertTrue(task.getException() instanceof IllegalStateException);
+    assertEquals(
+        ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE,
+        task.getException().getMessage());
+  }
+
+  @Test
+  public void getLimitedUseToken_forwardsToDelegateLimitedUseToken() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", "token-123");
+
+    assertSame(provider.debugDelegate.limitedUseTask, provider.getLimitedUseToken());
+    assertEquals(1, provider.debugDelegate.getLimitedUseTokenCount);
+    assertEquals(0, provider.debugDelegate.getTokenCount);
+  }
+
+  @Test
+  public void configure_debug_setsDelegateAndGetTokenDelegates() {
+    TestProvider provider = new TestProvider();
+
+    provider.configure("[DEFAULT]", "debug", "token-123");
+
+    assertSame(provider.debugDelegate, provider.delegateProvider);
+    assertEquals("[DEFAULT]", provider.lastAppName);
+    assertSame(provider.app, provider.lastDebugApp);
+    assertEquals("token-123", provider.lastDebugToken);
+    assertSame(provider.debugDelegate.task, provider.getToken());
+    assertEquals(1, provider.debugDelegate.getTokenCount);
+  }
+
+  @Test
+  public void configure_debugWithoutToken_passesNullToken() {
+    TestProvider provider = new TestProvider();
+
+    provider.configure("[DEFAULT]", "debug", null);
+
+    assertSame(provider.debugDelegate, provider.delegateProvider);
+    assertNull(provider.lastDebugToken);
+  }
+
+  @Test
+  public void configure_playIntegrity_setsDelegate() {
+    TestProvider provider = new TestProvider();
+
+    provider.configure("secondary", "playIntegrity", null);
+
+    assertSame(provider.playIntegrityDelegate, provider.delegateProvider);
+    assertEquals("secondary", provider.lastAppName);
+    assertSame(provider.app, provider.lastPlayIntegrityApp);
+    assertSame(provider.playIntegrityDelegate.task, provider.getToken());
+  }
+
+  @Test
+  public void configure_unknownName_throwsWithValidProviderList() {
+    TestProvider provider = new TestProvider();
+
+    RuntimeException e =
+        assertThrows(
+            RuntimeException.class, () -> provider.configure("[DEFAULT]", "safetyNet", null));
+    assertEquals(
+        "Unknown provider name \"safetyNet\". Valid providers are: debug, playIntegrity.",
+        e.getMessage());
+    assertNull(provider.delegateProvider);
+  }
+
+  @Test
+  public void reconfigure_validThenInvalid_throwsAndClearsStaleDelegate() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", "token-123");
+
+    RuntimeException e =
+        assertThrows(
+            RuntimeException.class, () -> provider.configure("[DEFAULT]", "safetyNet", null));
+    assertTrue(e.getMessage().contains("Unknown provider name \"safetyNet\""));
+
+    assertNull(provider.delegateProvider);
+    Task<AppCheckToken> task = provider.getToken();
+    assertFalse(task.isSuccessful());
+    assertEquals(
+        ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE,
+        task.getException().getMessage());
+    assertEquals(0, provider.debugDelegate.getTokenCount);
+  }
+
+  @Test
+  public void reconfigure_firebaseAppLookupFails_throwsAndClearsStaleDelegate() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", "token-123");
+    provider.getFirebaseAppFailure = new IllegalStateException("x");
+
+    RuntimeException e =
+        assertThrows(
+            RuntimeException.class, () -> provider.configure("[DEFAULT]", "debug", "token-123"));
+    assertEquals("x", e.getMessage());
+
+    assertNull(provider.delegateProvider);
+    Task<AppCheckToken> task = provider.getToken();
+    assertFalse(task.isSuccessful());
+    assertEquals(
+        ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE,
+        task.getException().getMessage());
+    assertEquals(0, provider.debugDelegate.getTokenCount);
+  }
+
+  @Test
+  public void reconfigure_switchesDelegate() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", null);
+
+    provider.configure("[DEFAULT]", "playIntegrity", null);
+
+    assertSame(provider.playIntegrityDelegate, provider.delegateProvider);
+  }
+
+  @Test
+  public void activateProviderName_releaseUsesPlayIntegrityDebuggableUsesDebug() {
+    assertEquals("playIntegrity", NativeRNFBTurboAppCheck.activateProviderName(false));
+    assertEquals("debug", NativeRNFBTurboAppCheck.activateProviderName(true));
+  }
+
+  @Test
+  public void activateProviderName_releaseNameIsAcceptedByProvider() {
+    TestProvider provider = new TestProvider();
+
+    provider.configure("[DEFAULT]", NativeRNFBTurboAppCheck.activateProviderName(false), null);
+
+    assertSame(provider.playIntegrityDelegate, provider.delegateProvider);
+  }
+
+  @Test
+  public void buildConfigDebugToken_unsetSentinelComparedByValue() {
+    assertNull(NativeRNFBTurboAppCheck.buildConfigDebugToken(new String("null")));
+    assertNull(NativeRNFBTurboAppCheck.buildConfigDebugToken("null"));
+    assertEquals("abc-123", NativeRNFBTurboAppCheck.buildConfigDebugToken("abc-123"));
+    assertNull(NativeRNFBTurboAppCheck.buildConfigDebugToken(null));
+  }
+
+  @Test
+  public void setupErrorMessage_usesExceptionMessageOrInternalErrorFallback() {
+    assertEquals(
+        "bad provider", NativeRNFBTurboAppCheck.setupErrorMessage(new Exception("bad provider")));
+    assertEquals("internal-error", NativeRNFBTurboAppCheck.setupErrorMessage(new Exception()));
+    assertEquals("internal-error", NativeRNFBTurboAppCheck.setupErrorMessage(new Exception("")));
+    assertEquals("internal-error", NativeRNFBTurboAppCheck.setupErrorMessage(null));
+  }
+
+  @Test
+  public void tokenErrorCode_providerNotReadyWrappedByTasksAwait_isProviderNotReady() {
+    Exception notReady = new ReactNativeFirebaseAppCheckProvider().getToken().getException();
+    Exception wrapped = new ExecutionException(notReady);
+
+    assertEquals("provider-not-ready", NativeRNFBTurboAppCheck.tokenErrorCode(wrapped));
+    assertEquals(
+        ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE,
+        NativeRNFBTurboAppCheck.tokenErrorMessage(wrapped));
+  }
+
+  @Test
+  public void tokenErrorCode_limitedUseProviderNotReady_isProviderNotReady() {
+    Exception notReady =
+        new ReactNativeFirebaseAppCheckProvider().getLimitedUseToken().getException();
+
+    assertEquals("provider-not-ready", NativeRNFBTurboAppCheck.tokenErrorCode(notReady));
+    assertEquals(
+        "provider-not-ready",
+        NativeRNFBTurboAppCheck.tokenErrorCode(new ExecutionException(notReady)));
+  }
+
+  @Test
+  public void tokenErrorCode_otherFailures_isTokenError() {
+    Exception delegateFailure = new ExecutionException(new Exception("fake-delegate"));
+    Exception noFactory = new Exception("No AppCheckProvider installed.");
+    Exception sameMessage =
+        new IllegalStateException(ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE);
+
+    assertEquals("token-error", NativeRNFBTurboAppCheck.tokenErrorCode(delegateFailure));
+    assertEquals("token-error", NativeRNFBTurboAppCheck.tokenErrorCode(noFactory));
+    assertEquals("token-error", NativeRNFBTurboAppCheck.tokenErrorCode(sameMessage));
+    assertEquals(
+        "token-error",
+        NativeRNFBTurboAppCheck.tokenErrorCode(new ExecutionException((Throwable) null)));
+    assertEquals(
+        delegateFailure.getMessage(), NativeRNFBTurboAppCheck.tokenErrorMessage(delegateFailure));
+  }
+
+  private static ReactNativeFirebaseAppCheckProviderFactory factoryWith(
+      String appName, ReactNativeFirebaseAppCheckProvider provider) {
+    ReactNativeFirebaseAppCheckProviderFactory factory =
+        new ReactNativeFirebaseAppCheckProviderFactory();
+    factory.providers.put(appName, provider);
+    return factory;
+  }
+
+  @Test
+  public void isProviderReady_noProvider_isFalse() {
+    assertFalse(new ReactNativeFirebaseAppCheckProviderFactory().isProviderReady("[DEFAULT]"));
+  }
+
+  @Test
+  public void isProviderReady_providerWithNullDelegate_isFalse() {
+    ReactNativeFirebaseAppCheckProviderFactory factory =
+        factoryWith("[DEFAULT]", new ReactNativeFirebaseAppCheckProvider());
+
+    assertFalse(factory.isProviderReady("[DEFAULT]"));
+  }
+
+  @Test
+  public void isProviderReady_configuredProvider_isTrueOnlyForThatApp() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", null);
+    ReactNativeFirebaseAppCheckProviderFactory factory = factoryWith("[DEFAULT]", provider);
+
+    assertTrue(factory.isProviderReady("[DEFAULT]"));
+    assertFalse(factory.isProviderReady("secondaryFromNative"));
+  }
+
+  @Test
+  public void isProviderReady_failedReconfigure_isFalse() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", null);
+    ReactNativeFirebaseAppCheckProviderFactory factory = factoryWith("[DEFAULT]", provider);
+
+    assertThrows(RuntimeException.class, () -> provider.configure("[DEFAULT]", "safetyNet", null));
+
+    assertFalse(factory.isProviderReady("[DEFAULT]"));
+  }
+
+  @Test
+  public void rejectIfProviderNotReady_notReady_rejectsWithProviderNotReady() {
+    Promise promise = mock(Promise.class);
+    WritableMap map = mock(WritableMap.class);
+    try (MockedStatic<Arguments> arguments = mockStatic(Arguments.class)) {
+      when(Arguments.createMap()).thenReturn(map);
+
+      assertTrue(
+          NativeRNFBTurboAppCheck.rejectIfProviderNotReady(
+              new ReactNativeFirebaseAppCheckProviderFactory(), "[DEFAULT]", promise));
+      assertTrue(
+          NativeRNFBTurboAppCheck.rejectIfProviderNotReady(
+              factoryWith("[DEFAULT]", new ReactNativeFirebaseAppCheckProvider()),
+              "[DEFAULT]",
+              promise));
+    }
+
+    verify(promise, times(2))
+        .reject(
+            "provider-not-ready",
+            ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE,
+            map);
+    verify(map, times(2)).putString("code", "provider-not-ready");
+    verify(map, times(2))
+        .putString("message", ReactNativeFirebaseAppCheckProvider.PROVIDER_NOT_READY_MESSAGE);
+  }
+
+  @Test
+  public void rejectIfProviderNotReady_ready_doesNotTouchPromise() {
+    TestProvider provider = new TestProvider();
+    provider.configure("[DEFAULT]", "debug", null);
+    Promise promise = mock(Promise.class);
+
+    assertFalse(
+        NativeRNFBTurboAppCheck.rejectIfProviderNotReady(
+            factoryWith("[DEFAULT]", provider), "[DEFAULT]", promise));
+    verifyNoInteractions(promise);
+  }
+
+  @Test
+  public void tokenErrorCodeAndMessage_nullException_doNotThrow() {
+    assertEquals("token-error", NativeRNFBTurboAppCheck.tokenErrorCode(null));
+    assertNull(NativeRNFBTurboAppCheck.tokenErrorMessage(null));
+  }
+}

package/dist/module/index.js

@@ -114,7 +114,7 @@ class FirebaseAppCheckModule extends FirebaseModule {
         throw new Error('Invalid configuration: no android provider configured while on android platform.');
       }
       configurePromise = this.native.configureProvider(provider.providerOptions.android.provider, provider.providerOptions.android.debugToken);
-    } else if (Platform.OS === 'ios' || Platform.OS === 'macos') {
+    } else if (Platform.OS === 'ios') {
       if (!isString(provider.providerOptions?.apple?.provider)) {
         throw new Error('Invalid configuration: no apple provider configured while on apple platform.');
       }
@@ -210,9 +210,12 @@ function getModularAppCheck(app) {
 /**
  * Initializes App Check for the given Firebase app.
  *
- * @remarks Returns synchronously for firebase-js-sdk parity; native provider setup continues in
- * the background. On native platforms use {@link ReactNativeFirebaseAppCheckProvider} to configure
- * Device Check, App Attest, Play Integrity, or debug providers. firebase-js-sdk
+ * @remarks Returns synchronously for firebase-js-sdk parity; provider setup continues in the
+ * background (native SDK, or firebase-js-sdk web interop on macOS and web), and a failure during
+ * that setup is reported with `console.warn` instead of an unhandled promise rejection. Invalid
+ * options still throw synchronously. On native platforms use
+ * {@link ReactNativeFirebaseAppCheckProvider} to configure Device Check, App Attest, Play
+ * Integrity, or debug providers. firebase-js-sdk
  * `ReCaptchaEnterpriseProvider` / `ReCaptchaV3Provider` are **web only** and have no RN equivalent.
  */
 export function initializeAppCheck(app, options) {
@@ -221,7 +224,11 @@ export function initializeAppCheck(app, options) {
   }
   validateProviderName(options);
   const appCheck = getModularAppCheck(app);
-  void appCheck.initializeAppCheck(options);
+  appCheck.initializeAppCheck(options).catch(error => {
+    const message = error instanceof Error ? error.message : String(error);
+    // eslint-disable-next-line no-console
+    console.warn(`initializeAppCheck() could not configure the App Check provider for app '${appCheck.app.name}': ${message}`);
+  });
   return appCheck;
 }
 export function getToken(appCheckInstance, forceRefresh) {

package/dist/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["isBoolean","isIOS","isObject","isString","isUndefined","isOther","parseListenerOrObserver","FirebaseModule","getOrCreateModularInstance","Platform","setReactNativeModule","fallBackModule","version","ReactNativeFirebaseAppCheckProvider","nativeModuleName","VALID_APPLE_PROVIDERS","VALID_ANDROID_PROVIDERS","hasProviderOptions","provider","undefined","providerOptions","validateProviderName","options","OS","name","android","includes","Error","join","apple","FirebaseAppCheckModule","constructor","app","config","customUrlOrRegion","emitter","addListener","eventNameForApp","event","emit","_listenerCount","getIsTokenRefreshEnabledDefault","isTokenAutoRefreshEnabled","newReactNativeFirebaseAppCheckProvider","initializeAppCheck","native","tokenRefresh","firebaseJson","app_check_token_auto_refresh","dataCollection","app_data_collection_default_enabled","configurePromise","configureProvider","debugToken","Promise","resolve","then","setTokenAutoRefreshEnabled","activate","siteKeyOrProvider","rnfbProvider","configure","web","siteKey","getToken","forceRefresh","getLimitedUseToken","onTokenChanged","onNextOrObserver","_onError","_onCompletion","console","warn","nextFn","subscription","addAppCheckListener","remove","removeAppCheckListener","namespace","nativeEvents","hasMultiAppSupport","hasCustomUrlOrRegionSupport","turboModule","SDK_VERSION","CustomProvider","getModularAppCheck","appCheck","appCheckInstance","isAutoRefreshEnabled","onError","onCompletion"],"sourceRoot":"../../lib","sources":["index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["isBoolean","isIOS","isObject","isString","isUndefined","isOther","parseListenerOrObserver","FirebaseModule","getOrCreateModularInstance","Platform","setReactNativeModule","fallBackModule","version","ReactNativeFirebaseAppCheckProvider","nativeModuleName","VALID_APPLE_PROVIDERS","VALID_ANDROID_PROVIDERS","hasProviderOptions","provider","undefined","providerOptions","validateProviderName","options","OS","name","android","includes","Error","join","apple","FirebaseAppCheckModule","constructor","app","config","customUrlOrRegion","emitter","addListener","eventNameForApp","event","emit","_listenerCount","getIsTokenRefreshEnabledDefault","isTokenAutoRefreshEnabled","newReactNativeFirebaseAppCheckProvider","initializeAppCheck","native","tokenRefresh","firebaseJson","app_check_token_auto_refresh","dataCollection","app_data_collection_default_enabled","configurePromise","configureProvider","debugToken","Promise","resolve","then","setTokenAutoRefreshEnabled","activate","siteKeyOrProvider","rnfbProvider","configure","web","siteKey","getToken","forceRefresh","getLimitedUseToken","onTokenChanged","onNextOrObserver","_onError","_onCompletion","console","warn","nextFn","subscription","addAppCheckListener","remove","removeAppCheckListener","namespace","nativeEvents","hasMultiAppSupport","hasCustomUrlOrRegionSupport","turboModule","SDK_VERSION","CustomProvider","getModularAppCheck","appCheck","catch","error","message","String","appCheckInstance","isAutoRefreshEnabled","onError","onCompletion"],"sourceRoot":"../../lib","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/dist/module/version.js

@@ -1,5 +1,5 @@
 "use strict";
 
 // Generated by genversion.
-export const version = '26.4.1';
+export const version = '26.4.2';
 //# sourceMappingURL=version.js.map

package/dist/typescript/lib/index.d.ts

@@ -1,14 +1,17 @@
 import type { FirebaseApp } from '@react-native-firebase/app';
 import './types/internal';
 import type { AppCheck, AppCheckOptions, AppCheckTokenResult, PartialObserver, Unsubscribe } from './types/appcheck';
-export declare const SDK_VERSION = "26.4.1";
+export declare const SDK_VERSION = "26.4.2";
 export { CustomProvider, ReactNativeFirebaseAppCheckProvider } from './providers';
 /**
  * Initializes App Check for the given Firebase app.
  *
- * @remarks Returns synchronously for firebase-js-sdk parity; native provider setup continues in
- * the background. On native platforms use {@link ReactNativeFirebaseAppCheckProvider} to configure
- * Device Check, App Attest, Play Integrity, or debug providers. firebase-js-sdk
+ * @remarks Returns synchronously for firebase-js-sdk parity; provider setup continues in the
+ * background (native SDK, or firebase-js-sdk web interop on macOS and web), and a failure during
+ * that setup is reported with `console.warn` instead of an unhandled promise rejection. Invalid
+ * options still throw synchronously. On native platforms use
+ * {@link ReactNativeFirebaseAppCheckProvider} to configure Device Check, App Attest, Play
+ * Integrity, or debug providers. firebase-js-sdk
  * `ReCaptchaEnterpriseProvider` / `ReCaptchaV3Provider` are **web only** and have no RN equivalent.
  */
 export declare function initializeAppCheck(app?: FirebaseApp, options?: AppCheckOptions): AppCheck;

package/dist/typescript/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/index.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAM9D,OAAO,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EAEf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAoP1B,eAAO,MAAM,WAAW,WAAU,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AAMlF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAQzF;AAED,wBAAgB,QAAQ,CACtB,gBAAgB,EAAE,QAAQ,EAC1B,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE3F;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,QAAQ,EAC1B,oBAAoB,EAAE,OAAO,GAC5B,IAAI,CAEN;AAED,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,QAAQ,EAC1B,QAAQ,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAC7C,WAAW,CAAC;AAEf,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,QAAQ,EAC1B,MAAM,EAAE,CAAC,WAAW,EAAE,mBAAmB,KAAK,IAAI,EAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,WAAW,CAAC;AAiBf,mBAAmB,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/index.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAM9D,OAAO,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EAEf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAoP1B,eAAO,MAAM,WAAW,WAAU,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AAMlF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAczF;AAED,wBAAgB,QAAQ,CACtB,gBAAgB,EAAE,QAAQ,EAC1B,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE3F;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,QAAQ,EAC1B,oBAAoB,EAAE,OAAO,GAC5B,IAAI,CAEN;AAED,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,QAAQ,EAC1B,QAAQ,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAC7C,WAAW,CAAC;AAEf,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,QAAQ,EAC1B,MAAM,EAAE,CAAC,WAAW,EAAE,mBAAmB,KAAK,IAAI,EAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,WAAW,CAAC;AAiBf,mBAAmB,kBAAkB,CAAC"}

package/dist/typescript/lib/types/appcheck.d.ts

@@ -32,16 +32,17 @@ export interface AppCheckToken {
  */
 export interface AppCheckOptions {
     /**
-     * The App Check provider to use. This can be either the built-in reCAPTCHA provider
-     * or a custom provider. For convenience, you can also pass an object with providerOptions
-     * directly, which will be accepted by the runtime.
+     * The App Check provider to use. On Android and iOS, use a configured
+     * `ReactNativeFirebaseAppCheckProvider` (or an object with `providerOptions`).
+     * On other platforms (macOS, web), use a `CustomProvider`.
      */
     provider: CustomProvider | ReactNativeFirebaseAppCheckProvider | ReactNativeFirebaseAppCheckProviderConfig;
     /**
-     * If true, enables SDK to automatically
-     * refresh AppCheck token as needed. If undefined, the value will default
-     * to the value of `app.automaticDataCollectionEnabled`. That property
-     * defaults to false and can be set in the app config.
+     * If true, enables SDK to automatically refresh AppCheck token as needed.
+     * On Android and iOS, if omitted (or not a boolean), it falls back to
+     * firebase.json `app_check_token_auto_refresh`, then firebase.json
+     * `app_data_collection_default_enabled`, then `true`.
+     * On other platforms (macOS, web), this fallback is not applied.
      */
     isTokenAutoRefreshEnabled?: boolean;
 }
@@ -73,8 +74,8 @@ export interface AppCheckTokenResult {
  */
 export type AppCheckTokenListener = (token: AppCheckTokenResult) => void;
 /**
- * An App Check provider. This can be either the built-in reCAPTCHA provider
- * or a custom provider. For more on custom providers, see
+ * An App Check provider. On Android and iOS, use `ReactNativeFirebaseAppCheckProvider`;
+ * on other platforms (macOS, web), use `CustomProvider`. For more on custom providers, see
  * https://firebase.google.com/docs/app-check/web-custom-provider
  * @public
  */
@@ -96,6 +97,7 @@ export interface ReactNativeFirebaseAppCheckProviderOptions {
 }
 /**
  * Options for ReactNativeFirebaseAppCheckProvider on web.
+ * @deprecated Not read at runtime. On other platforms (macOS, web), use `CustomProvider`.
  * @public
  */
 export interface ReactNativeFirebaseAppCheckProviderWebOptions extends ReactNativeFirebaseAppCheckProviderOptions {
@@ -135,6 +137,9 @@ export interface ReactNativeFirebaseAppCheckProviderAndroidOptions extends React
  * @public
  */
 export type ReactNativeFirebaseAppCheckProviderOptionsMap = {
+    /**
+     * @deprecated Not read at runtime. On other platforms (macOS, web), use `CustomProvider`.
+     */
     web?: ReactNativeFirebaseAppCheckProviderWebOptions;
     android?: ReactNativeFirebaseAppCheckProviderAndroidOptions;
     apple?: ReactNativeFirebaseAppCheckProviderAppleOptions;

package/dist/typescript/lib/types/appcheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appcheck.d.ts","sourceRoot":"","sources":["../../../../lib/types/appcheck.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAExF,YAAY,EACV,WAAW,EACX,eAAe,GAChB,MAAM,qDAAqD,CAAC;AAC7D;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EACJ,cAAc,GACd,mCAAmC,GACnC,yCAAyC,CAAC;IAE9C;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,6CAA8C,SAAQ,0CAA0C;IAC/G;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,qBAAqB,CAAC;IAE3D;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,+CAAgD,SAAQ,0CAA0C;IACjH;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,kCAAkC,CAAC;CACvF;AAED;;;GAGG;AACH,MAAM,WAAW,iDAAkD,SAAQ,0CAA0C;IACnH;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,GAAG,CAAC,EAAE,6CAA6C,CAAC;IACpD,OAAO,CAAC,EAAE,iDAAiD,CAAC;IAC5D,KAAK,CAAC,EAAE,+CAA+C,CAAC;IACxD,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,yCAAyC;IACxD,eAAe,EAAE,6CAA6C,CAAC;CAChE"}
+{"version":3,"file":"appcheck.d.ts","sourceRoot":"","sources":["../../../../lib/types/appcheck.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAExF,YAAY,EACV,WAAW,EACX,eAAe,GAChB,MAAM,qDAAqD,CAAC;AAC7D;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EACJ,cAAc,GACd,mCAAmC,GACnC,yCAAyC,CAAC;IAE9C;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,6CAA8C,SAAQ,0CAA0C;IAC/G;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,qBAAqB,CAAC;IAE3D;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,+CAAgD,SAAQ,0CAA0C;IACjH;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,kCAAkC,CAAC;CACvF;AAED;;;GAGG;AACH,MAAM,WAAW,iDAAkD,SAAQ,0CAA0C;IACnH;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D;;OAEG;IACH,GAAG,CAAC,EAAE,6CAA6C,CAAC;IACpD,OAAO,CAAC,EAAE,iDAAiD,CAAC;IAC5D,KAAK,CAAC,EAAE,+CAA+C,CAAC;IACxD,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,yCAAyC;IACxD,eAAe,EAAE,6CAA6C,CAAC;CAChE"}

package/dist/typescript/lib/types/internal.d.ts

@@ -23,29 +23,28 @@ export type AppCheckInternal = AppCheck & {
     /**
      * Activate App Check
      * On iOS calling this activates App Check with the DeviceCheck provider, using the token auto refresh default or
-     * the specific value (if configured) in firebase.json. Before `activate` or `initializeAppCheck` is called, the
-     * native App Check provider is pending and `getToken` / `getLimitedUseToken` fail closed with
-     * `appCheck/provider-not-ready`.
-     * On Android if you call this it will install the PlayIntegrity provider in release builds, the Debug provider if debuggable.
+     * the specific value (if configured) in firebase.json.
+     * On Android and iOS, before `activate` or `initializeAppCheck` is called, the native App Check provider is pending
+     * and `getToken` / `getLimitedUseToken` fail closed with `appCheck/provider-not-ready`.
+     * On Android this configures the PlayIntegrity provider through `initializeAppCheck`, in debug and release builds.
      * On both platforms you may use this method to alter the token refresh setting after startup.
      * On iOS if you want to set a specific AppCheckProviderFactory (for instance to FIRAppCheckDebugProviderFactory or
      * FIRAppAttestProvider) you must manually do that in your AppDelegate.m prior to calling [FIRApp configure]
      *
      * @deprecated use initializeAppCheck to gain access to all platform providers and firebase-js-sdk v9 compatibility
-     * @param siteKeyOrProvider - This is ignored, Android uses DebugProviderFactory if the app is debuggable (https://firebase.google.com/docs/app-check/android/debug-provider)
-     *                            Android uses PlayIntegrityProviderFactory for release builds.
+     * @param siteKeyOrProvider - This is ignored, Android uses the PlayIntegrity provider.
      *                            iOS uses DeviceCheckProviderFactory by default unless altered in AppDelegate.m manually
      * @param isTokenAutoRefreshEnabled - If true, enables SDK to automatically
-     * refresh AppCheck token as needed. If undefined, the value will default
-     * to the value of `app.automaticDataCollectionEnabled`. That property
-     * defaults to false and can be set in the app config.
+     * refresh AppCheck token as needed. If not a boolean, it falls back to firebase.json
+     * `app_check_token_auto_refresh`, then firebase.json `app_data_collection_default_enabled`,
+     * then `true`.
      */
     activate(siteKeyOrProvider: string | AppCheckProvider, isTokenAutoRefreshEnabled?: boolean): Promise<void>;
     /**
-     * Alter the token auto refresh setting. By default it will take the value of automaticDataCollectionEnabled from Info.plist / AndroidManifest.xml
+     * Alter the token auto refresh setting.
      * @param isTokenAutoRefreshEnabled - If true, the SDK automatically
-     * refreshes App Check tokens as needed. This overrides any value set
-     * during `activate()` or taken by default from automaticDataCollectionEnabled in plist / android manifest
+     * refreshes App Check tokens as needed. This overrides the value resolved
+     * during `initializeAppCheck()` / `activate()`.
      */
     setTokenAutoRefreshEnabled(isTokenAutoRefreshEnabled: boolean): void;
     /**

package/dist/typescript/lib/types/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../../lib/types/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,yCAAyC,EACzC,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAExE,KAAK,sBAAsB,GAAG,mBAAmB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,qDAAqD;IACrD,GAAG,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,sCAAsC,IAAI,mCAAmC,CAAC;IAE9E;;;;;;;OAOG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CACN,iBAAiB,EAAE,MAAM,GAAG,gBAAgB,EAC5C,yBAAyB,CAAC,EAAE,OAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,0BAA0B,CAAC,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;IAErE;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEnD;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,sBAAsB,CAAC,GAAG,MAAM,IAAI,CAAC;IAE9E;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CACZ,MAAM,EAAE,CAAC,WAAW,EAAE,sBAAsB,KAAK,IAAI,EACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,WAAW,CAAC;IAEf;;OAEG;IACH,cAAc,CACZ,gBAAgB,EACZ,eAAe,CAAC,mBAAmB,CAAC,GACpC,CAAC,CAAC,WAAW,EAAE,mBAAmB,KAAK,IAAI,CAAC,EAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,WAAW,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,mCAAmC,GACnC,yCAAyC,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9D,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEnD,mBAAmB,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,sBAAsB,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,OAAO,QAAQ,+DAA+D,CAAC;IAC7E,UAAU,gCAAgC;QACxC,uBAAuB,EAAE,kBAAkB,CAAC;KAC7C;CACF"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../../lib/types/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,yCAAyC,EACzC,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAExE,KAAK,sBAAsB,GAAG,mBAAmB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,qDAAqD;IACrD,GAAG,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,sCAAsC,IAAI,mCAAmC,CAAC;IAE9E;;;;;;;OAOG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,iBAAiB,EAAE,MAAM,GAAG,gBAAgB,EAC5C,yBAAyB,CAAC,EAAE,OAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,0BAA0B,CAAC,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;IAErE;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEnD;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,sBAAsB,CAAC,GAAG,MAAM,IAAI,CAAC;IAE9E;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CACZ,MAAM,EAAE,CAAC,WAAW,EAAE,sBAAsB,KAAK,IAAI,EACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,WAAW,CAAC;IAEf;;OAEG;IACH,cAAc,CACZ,gBAAgB,EACZ,eAAe,CAAC,mBAAmB,CAAC,GACpC,CAAC,CAAC,WAAW,EAAE,mBAAmB,KAAK,IAAI,CAAC,EAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAChC,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,WAAW,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,mCAAmC,GACnC,yCAAyC,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9D,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEnD,mBAAmB,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,sBAAsB,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,OAAO,QAAQ,+DAA+D,CAAC;IAC7E,UAAU,gCAAgC;QACxC,uBAAuB,EAAE,kBAAkB,CAAC;KAC7C;CACF"}

package/dist/typescript/lib/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "26.4.1";
+export declare const version = "26.4.2";
 //# sourceMappingURL=version.d.ts.map

package/lib/index.ts

@@ -172,7 +172,7 @@ class FirebaseAppCheckModule extends FirebaseModule<typeof nativeModuleName> {
         provider.providerOptions.android.provider,
         provider.providerOptions.android.debugToken,
       );
-    } else if (Platform.OS === 'ios' || Platform.OS === 'macos') {
+    } else if (Platform.OS === 'ios') {
       if (!isString(provider.providerOptions?.apple?.provider)) {
         throw new Error(
           'Invalid configuration: no apple provider configured while on apple platform.',
@@ -297,9 +297,12 @@ function getModularAppCheck(app?: FirebaseApp): AppCheck {
 /**
  * Initializes App Check for the given Firebase app.
  *
- * @remarks Returns synchronously for firebase-js-sdk parity; native provider setup continues in
- * the background. On native platforms use {@link ReactNativeFirebaseAppCheckProvider} to configure
- * Device Check, App Attest, Play Integrity, or debug providers. firebase-js-sdk
+ * @remarks Returns synchronously for firebase-js-sdk parity; provider setup continues in the
+ * background (native SDK, or firebase-js-sdk web interop on macOS and web), and a failure during
+ * that setup is reported with `console.warn` instead of an unhandled promise rejection. Invalid
+ * options still throw synchronously. On native platforms use
+ * {@link ReactNativeFirebaseAppCheckProvider} to configure Device Check, App Attest, Play
+ * Integrity, or debug providers. firebase-js-sdk
  * `ReCaptchaEnterpriseProvider` / `ReCaptchaV3Provider` are **web only** and have no RN equivalent.
  */
 export function initializeAppCheck(app?: FirebaseApp, options?: AppCheckOptions): AppCheck {
@@ -308,7 +311,13 @@ export function initializeAppCheck(app?: FirebaseApp, options?: AppCheckOptions)
   }
   validateProviderName(options);
   const appCheck = getModularAppCheck(app);
-  void (appCheck as AppCheckInternal).initializeAppCheck(options);
+  (appCheck as AppCheckInternal).initializeAppCheck(options).catch((error: unknown) => {
+    const message = error instanceof Error ? error.message : String(error);
+    // eslint-disable-next-line no-console
+    console.warn(
+      `initializeAppCheck() could not configure the App Check provider for app '${appCheck.app.name}': ${message}`,
+    );
+  });
   return appCheck;
 }
 

package/lib/types/appcheck.ts

@@ -55,9 +55,9 @@ export interface AppCheckToken {
  */
 export interface AppCheckOptions {
   /**
-   * The App Check provider to use. This can be either the built-in reCAPTCHA provider
-   * or a custom provider. For convenience, you can also pass an object with providerOptions
-   * directly, which will be accepted by the runtime.
+   * The App Check provider to use. On Android and iOS, use a configured
+   * `ReactNativeFirebaseAppCheckProvider` (or an object with `providerOptions`).
+   * On other platforms (macOS, web), use a `CustomProvider`.
    */
   provider:
     | CustomProvider
@@ -65,10 +65,11 @@ export interface AppCheckOptions {
     | ReactNativeFirebaseAppCheckProviderConfig;
 
   /**
-   * If true, enables SDK to automatically
-   * refresh AppCheck token as needed. If undefined, the value will default
-   * to the value of `app.automaticDataCollectionEnabled`. That property
-   * defaults to false and can be set in the app config.
+   * If true, enables SDK to automatically refresh AppCheck token as needed.
+   * On Android and iOS, if omitted (or not a boolean), it falls back to
+   * firebase.json `app_check_token_auto_refresh`, then firebase.json
+   * `app_data_collection_default_enabled`, then `true`.
+   * On other platforms (macOS, web), this fallback is not applied.
    */
   isTokenAutoRefreshEnabled?: boolean;
 }
@@ -104,8 +105,8 @@ export interface AppCheckTokenResult {
 export type AppCheckTokenListener = (token: AppCheckTokenResult) => void;
 
 /**
- * An App Check provider. This can be either the built-in reCAPTCHA provider
- * or a custom provider. For more on custom providers, see
+ * An App Check provider. On Android and iOS, use `ReactNativeFirebaseAppCheckProvider`;
+ * on other platforms (macOS, web), use `CustomProvider`. For more on custom providers, see
  * https://firebase.google.com/docs/app-check/web-custom-provider
  * @public
  */
@@ -129,6 +130,7 @@ export interface ReactNativeFirebaseAppCheckProviderOptions {
 
 /**
  * Options for ReactNativeFirebaseAppCheckProvider on web.
+ * @deprecated Not read at runtime. On other platforms (macOS, web), use `CustomProvider`.
  * @public
  */
 export interface ReactNativeFirebaseAppCheckProviderWebOptions extends ReactNativeFirebaseAppCheckProviderOptions {
@@ -172,6 +174,9 @@ export interface ReactNativeFirebaseAppCheckProviderAndroidOptions extends React
  * @public
  */
 export type ReactNativeFirebaseAppCheckProviderOptionsMap = {
+  /**
+   * @deprecated Not read at runtime. On other platforms (macOS, web), use `CustomProvider`.
+   */
   web?: ReactNativeFirebaseAppCheckProviderWebOptions;
   android?: ReactNativeFirebaseAppCheckProviderAndroidOptions;
   apple?: ReactNativeFirebaseAppCheckProviderAppleOptions;

package/lib/types/internal.ts

@@ -34,22 +34,21 @@ export type AppCheckInternal = AppCheck & {
   /**
    * Activate App Check
    * On iOS calling this activates App Check with the DeviceCheck provider, using the token auto refresh default or
-   * the specific value (if configured) in firebase.json. Before `activate` or `initializeAppCheck` is called, the
-   * native App Check provider is pending and `getToken` / `getLimitedUseToken` fail closed with
-   * `appCheck/provider-not-ready`.
-   * On Android if you call this it will install the PlayIntegrity provider in release builds, the Debug provider if debuggable.
+   * the specific value (if configured) in firebase.json.
+   * On Android and iOS, before `activate` or `initializeAppCheck` is called, the native App Check provider is pending
+   * and `getToken` / `getLimitedUseToken` fail closed with `appCheck/provider-not-ready`.
+   * On Android this configures the PlayIntegrity provider through `initializeAppCheck`, in debug and release builds.
    * On both platforms you may use this method to alter the token refresh setting after startup.
    * On iOS if you want to set a specific AppCheckProviderFactory (for instance to FIRAppCheckDebugProviderFactory or
    * FIRAppAttestProvider) you must manually do that in your AppDelegate.m prior to calling [FIRApp configure]
    *
    * @deprecated use initializeAppCheck to gain access to all platform providers and firebase-js-sdk v9 compatibility
-   * @param siteKeyOrProvider - This is ignored, Android uses DebugProviderFactory if the app is debuggable (https://firebase.google.com/docs/app-check/android/debug-provider)
-   *                            Android uses PlayIntegrityProviderFactory for release builds.
+   * @param siteKeyOrProvider - This is ignored, Android uses the PlayIntegrity provider.
    *                            iOS uses DeviceCheckProviderFactory by default unless altered in AppDelegate.m manually
    * @param isTokenAutoRefreshEnabled - If true, enables SDK to automatically
-   * refresh AppCheck token as needed. If undefined, the value will default
-   * to the value of `app.automaticDataCollectionEnabled`. That property
-   * defaults to false and can be set in the app config.
+   * refresh AppCheck token as needed. If not a boolean, it falls back to firebase.json
+   * `app_check_token_auto_refresh`, then firebase.json `app_data_collection_default_enabled`,
+   * then `true`.
    */
   activate(
     siteKeyOrProvider: string | AppCheckProvider,
@@ -57,10 +56,10 @@ export type AppCheckInternal = AppCheck & {
   ): Promise<void>;
 
   /**
-   * Alter the token auto refresh setting. By default it will take the value of automaticDataCollectionEnabled from Info.plist / AndroidManifest.xml
+   * Alter the token auto refresh setting.
    * @param isTokenAutoRefreshEnabled - If true, the SDK automatically
-   * refreshes App Check tokens as needed. This overrides any value set
-   * during `activate()` or taken by default from automaticDataCollectionEnabled in plist / android manifest
+   * refreshes App Check tokens as needed. This overrides the value resolved
+   * during `initializeAppCheck()` / `activate()`.
    */
   setTokenAutoRefreshEnabled(isTokenAutoRefreshEnabled: boolean): void;
 

package/lib/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '26.4.1';
+export const version = '26.4.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/app-check",
-  "version": "26.4.1",
+  "version": "26.4.2",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Firebase - App Check",
   "main": "./dist/module/index.js",
@@ -45,11 +45,11 @@
     "appCheck"
   ],
   "peerDependencies": {
-    "@react-native-firebase/app": "26.4.1",
+    "@react-native-firebase/app": "26.4.2",
     "expo": ">=47.0.0"
   },
   "devDependencies": {
-    "@react-native-firebase/app": "26.4.1",
+    "@react-native-firebase/app": "26.4.2",
     "expo": "^55.0.18",
     "react-native-builder-bob": "^0.41.0",
     "typescript": "^6.0.3"
@@ -101,5 +101,5 @@
     "node_modules/",
     "dist/"
   ],
-  "gitHead": "a3efad5f425135a5d2e66857ffae84ebaa02a7ba"
+  "gitHead": "8d24081586657530e6e0316afcc26989bff0f1d3"
 }