Remove browser warmup functionality from all platforms

Eliminates the warmup API, implementation, and documentation for both Android and iOS. Removes related code, hooks, and references, including the CustomTabsConnection and BrowserWarmupCoordinator classes. Updates the README and example app to reflect the removal of warmup, focusing on streamlined browser session management and improved code clarity.

Author: mCodex

README.md

@@ -32,15 +32,15 @@ Lightning-fast, modern in-app browser for React Native powered by Nitro Modules.
 - Fully typed TypeScript API plus ergonomic React hook helpers.
 - ✅ **iOS 26 ready**: high-contrast dynamic colors, edge-dismiss control, and UI style overrides.
 - ✅ **Android 16 ready**: partial custom tabs, referrer controls, and per-theme palettes.
-- Authentication-first design with ephemeral sessions, warmup, and graceful fallbacks.
+- Authentication-first design with ephemeral sessions and graceful fallbacks.
 - Works great with Hermes, Fabric, and the React Native New Architecture.
 
 ## Platform Support
 
 | Platform | Minimum | Targeted | Highlights |
 |----------|---------|----------|------------|
 | iOS | 11.0 | 17 / 26* | SafariViewController + ASWebAuthentication support. |
-| Android | API 23 | API 34 / 16* | Chrome Custom Tabs with warmup and dynamic theming. |
+| Android | API 23 | API 34 / 16* | Chrome Custom Tabs with dynamic theming. |
 | React Native | 0.70.0 | Latest | Nitro Modules + TypeScript bindings. |
 
 \* iOS 26 and Android 16 features are automatically gated behind runtime checks.
@@ -113,22 +113,6 @@ export function LaunchButton() {
 }
 ```
 
-### Warmup & Prefetch
-
-```tsx
-import { useEffect } from 'react'
-import { InAppBrowser } from 'react-native-inappbrowser-nitro'
-
-export function useBrowserWarmup() {
-  useEffect(() => {
-    InAppBrowser.warmup({
-      toolbarColor: { base: '#0EA5E9' },
-      includeReferrer: true,
-    }).catch(console.warn)
-  }, [])
-}
-```
-
 ### Authentication Flow (OAuth / SSO)
 
 ```tsx
@@ -177,17 +161,7 @@ If you depended on awaiting dismissal, refactor to handle completion via deep li
 +InAppBrowser.open(url, { toolbarColor: { base: '#6200EE', dark: '#3700B3' } })
 ```
 
-### 3. Use `warmup()` instead of manual Custom Tabs priming
-
-Chrome warmup is wrapped in a cross-platform helper. Call it during app boot or screen focus:
-
-```tsx
-useEffect(() => {
-  InAppBrowser.warmup({ toolbarColor: { base: '#0EA5E9' } }).catch(console.warn)
-}, [])
-```
-
-### 4. Prefer the hook for loading/error handling
+### 3. Prefer the hook for loading/error handling
 
 `useInAppBrowser` wraps the imperative API with loading state and error capture, aligning with the new async semantics.
 
@@ -197,7 +171,7 @@ useEffect(() => {
 +const handleOpen = () => open(url)
 ```
 
-### 5. Regenerate bindings after upgrading
+### 4. Regenerate bindings after upgrading
 
 Run `yarn codegen && yarn build` (or your project script) to regenerate Nitro bindings so the new enums and options are available on both platforms.
 
@@ -210,7 +184,6 @@ Run `yarn codegen && yarn build` (or your project script) to regenerate Nitro bi
 | `openAuth(url, redirectUrl, options?)` | Open an OAuth/SSO flow that resolves once the redirect URL is reached. |
 | `close()` | Programmatically dismiss an open browser session. |
 | `closeAuth()` | Abort an authentication session. |
-| `warmup(options?)` | Pre-initialize native resources to improve first paint. |
 
 All functions return Promises and are fully typed. See `src/core/InAppBrowser.ts` for the higher-level wrapper implementation.
 

android/build.gradle

@@ -137,6 +137,9 @@ dependencies {
 
   // Add a dependency on NitroModules
   implementation project(":react-native-nitro-modules")
+
+  implementation "androidx.browser:browser:1.7.0"
+  implementation "androidx.core:core-ktx:1.13.1"
 }
 
 if (isNewArchitectureEnabled()) {

android/src/main/java/com/inappbrowsernitro/HybridInappbrowserNitro.kt

@@ -1,9 +1,109 @@
 package com.inappbrowsernitro
 
+import android.app.Activity
+import android.content.ActivityNotFoundException
+import android.content.Context
+import android.content.Intent
+import android.net.Uri
+import androidx.browser.customtabs.CustomTabsIntent
+import com.inappbrowsernitro.browser.BrowserFallback
+import com.inappbrowsernitro.browser.CustomTabsIntentFactory
+import com.inappbrowsernitro.browser.CustomTabsPackageHelper
+import com.margelo.nitro.NitroModules
+import com.margelo.nitro.core.Promise
+import com.margelo.nitro.inappbrowsernitro.BrowserResultType
 import com.margelo.nitro.inappbrowsernitro.HybridInappbrowserNitroSpec
+import com.margelo.nitro.inappbrowsernitro.InAppBrowserAuthResult
+import com.margelo.nitro.inappbrowsernitro.InAppBrowserOptions
+import com.margelo.nitro.inappbrowsernitro.InAppBrowserResult
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
 
-class HybridInappbrowserNitro: HybridInappbrowserNitroSpec() {    
-    override fun sum(num1: Double, num2: Double): Double {
-        return num1 + num2
+class HybridInappbrowserNitro : HybridInappbrowserNitroSpec() {
+    private val reactContext get() = NitroModules.applicationContext
+    private val applicationContext: Context?
+        get() = reactContext ?: NitroModules.applicationContext
+
+    override fun isAvailable(): Promise<Boolean> {
+        val context = applicationContext ?: return Promise.resolved(false)
+        val customTabsPackage = CustomTabsPackageHelper.resolvePackage(context, null)
+        if (customTabsPackage != null) {
+            return Promise.resolved(true)
+        }
+
+        val intent = Intent(Intent.ACTION_VIEW, Uri.parse(SCHEME_CHECK_URL))
+        val canHandle = intent.resolveActivity(context.packageManager) != null
+        return Promise.resolved(canHandle)
+    }
+
+    override fun open(url: String, options: InAppBrowserOptions?): Promise<InAppBrowserResult> {
+        return Promise.async {
+            openInternal(url, options)
+        }
+    }
+
+    override fun openAuth(url: String, redirectUrl: String, options: InAppBrowserOptions?): Promise<InAppBrowserAuthResult> {
+        return Promise.async {
+            val result = openInternal(url, options)
+            InAppBrowserAuthResult(result.type, result.url, result.message)
+        }
+    }
+
+    override fun close(): Promise<Unit> {
+        return Promise.resolved(Unit)
+    }
+
+    override fun closeAuth(): Promise<Unit> {
+        return Promise.resolved(Unit)
+    }
+
+    private suspend fun openInternal(url: String, options: InAppBrowserOptions?): InAppBrowserResult {
+        val context = applicationContext ?: return dismiss("React context unavailable")
+        val parsedUri = runCatching { Uri.parse(url) }.getOrNull()
+            ?: return dismiss("Invalid URL: $url")
+
+        val intent = CustomTabsIntentFactory(context, null).create(options)
+        val launchContext = reactContext?.currentActivity ?: context
+        val launched = launchCustomTab(intent, launchContext, parsedUri)
+
+        if (launched) {
+            return InAppBrowserResult(BrowserResultType.SUCCESS, parsedUri.toString(), null)
+        }
+
+        val fallbackLaunched = (launchContext as? Activity)?.let { launchFallback(it, url) } ?: false
+        return if (fallbackLaunched) {
+            InAppBrowserResult(BrowserResultType.SUCCESS, parsedUri.toString(), null)
+        } else {
+            dismiss("No browser available to handle $url")
+        }
+    }
+
+    private suspend fun launchCustomTab(intent: CustomTabsIntent, context: Context, uri: Uri): Boolean {
+        return withContext(Dispatchers.Main) {
+            try {
+                if (context !is Activity) {
+                    intent.intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+                }
+                intent.launchUrl(context, uri)
+                true
+            } catch (_: ActivityNotFoundException) {
+                false
+            }
+        }
+    }
+
+    private fun launchFallback(activity: Activity, url: String): Boolean {
+        val fallback = BrowserFallback(activity)
+        if (fallback.openSystemBrowser(url)) return true
+        if (fallback.openChooser(url)) return true
+        return fallback.redirectToStore()
+    }
+
+    private fun dismiss(message: String): InAppBrowserResult {
+        return InAppBrowserResult(BrowserResultType.DISMISS, null, message)
+    }
+
+    private companion object {
+        private const val SCHEME_CHECK_URL = "https://example.com"
     }
 }

android/src/main/java/com/inappbrowsernitro/browser/CustomTabsConnection.kt

@@ -1,8 +1,6 @@
 package com.inappbrowsernitro.browser
 
 import android.content.Context
-import android.content.Intent
-import android.net.Uri
 import androidx.browser.customtabs.CustomTabsClient
 
 internal object CustomTabsPackageHelper {
@@ -11,10 +9,6 @@ internal object CustomTabsPackageHelper {
       return preferred
     }
 
-    return CustomTabsClient.getPackageName(context, buildIntent())
-  }
-
-  private fun buildIntent(): Intent {
-    return Intent(Intent.ACTION_VIEW, Uri.parse("http://www.example.com"))
+    return CustomTabsClient.getPackageName(context, null)
   }
 }

android/src/main/java/com/inappbrowsernitro/browser/CustomTabsPackageHelper.kt

@@ -2,7 +2,6 @@ package com.inappbrowsernitro.browser
 
 import android.content.Context
 import android.graphics.Color
-import android.os.Build
 import android.view.accessibility.AccessibilityManager
 import androidx.core.content.getSystemService
 import com.margelo.nitro.inappbrowsernitro.DynamicColor
@@ -12,7 +11,12 @@ internal object DynamicColorResolver {
     dynamicColor ?: return null
 
     val accessibilityManager = context.getSystemService<AccessibilityManager>()
-    val isHighContrast = accessibilityManager?.isHighTextContrastEnabled == true
+    val isHighContrast = accessibilityManager?.let { manager ->
+      runCatching {
+        val method = AccessibilityManager::class.java.getMethod("isHighTextContrastEnabled")
+        (method.invoke(manager) as? Boolean) == true
+      }.getOrDefault(false)
+    } == true
 
     val isDark = (context.resources.configuration.uiMode and android.content.res.Configuration.UI_MODE_NIGHT_MASK) == android.content.res.Configuration.UI_MODE_NIGHT_YES