Add support for ephemeral session in Custom Tabs

[Copilot]

This PR adds support for ephemeral browsing sessions in Custom Tabs, leveraging the functionality introduced in androidx.browser:browser:1.9.0. Ephemeral sessions enhance privacy and security by preventing the persistence of browsing data, cookies, or history during authentication flows.

Features Added

CustomTabsOptions Updates

• Added ephemeralBrowsingEnabled field to store the ephemeral browsing preference
• Added withEphemeralBrowsingEnabled(boolean) method in CustomTabsOptions.Builder to enable/disable ephemeral browsing
• Updated toIntent() method to call setEphemeralBrowsingEnabled() on the CustomTabsIntent.Builder when the option is enabled
• Updated Parcelable implementation to include the new field for proper state serialization/deserialization
• Updated constructor and builder to handle the new parameter

WebAuthProvider Updates

• Added enableEphemeralSession() method in WebAuthProvider.Builder to enable ephemeral browsing sessions with a simple API
• This method creates CustomTabsOptions with ephemeral browsing enabled and sets it on the builder

API Usage

Recommended Approach (Simple)

WebAuthProvider.login(auth0)
    .enableEphemeralSession()
    .start(this, callback)

Advanced Approach (Full Control)

val customTabsOptions = CustomTabsOptions.newBuilder()
    .withEphemeralBrowsingEnabled(true)
    .withToolbarColor(R.color.primary)
    .showTitle(true)
    .build()

WebAuthProvider.login(auth0)
    .withCustomTabsOptions(customTabsOptions)
    .start(this, callback)

Benefits

• Enhanced Privacy: Ephemeral sessions don't persist browsing data, cookies, or history
• Better Security: Reduces risk of session data being accessed by other apps or users
• User Control: Developers can choose when to use ephemeral sessions based on their security requirements
• Backward Compatibility: When ephemeral browsing is not explicitly enabled, the behavior remains unchanged

Testing

• Added comprehensive unit tests for the new functionality in CustomTabsOptionsTest.java
• Added integration tests in WebAuthProviderTest.kt to verify the enableEphemeralSession() method
• Updated existing tests to verify backward compatibility
• Added tests to ensure proper Parcelable serialization/deserialization

The implementation follows the existing patterns in the codebase and maintains complete backward compatibility. When ephemeral browsing is not explicitly enabled, the behavior remains identical to the current implementation.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• dl.google.com
  • Triggering command: /usr/lib/jvm/temurin-17-jdk-amd64/bin/java --add-opens java.base/java.util=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.lang.invoke=ALL-UNNAMED --add-opens java.base/java.util=ALL-UNNAMED --add-opens java.prefs/java.util.prefs=ALL-UNNAMED --add-opens java.prefs/java.util.prefs=ALL-UNNAMED --add-opens java.base/java.nio.charset=ALL-UNNAMED --add-opens java.base/java.net=ALL-UNNAMED --add-opens java.base/java.util.concurrent.atomic=ALL-UNNAMED -Xmx2048m -Dfile.encoding=UTF-8 -Duser.country -Duser.language=en -Duser.variant -cp /home/REDACTED/.gradle/wrapper/dists/gradle-7.5-all/6qsw290k5lz422uaf8jf6m7co/gradle-7.5/lib/gradle-launcher-7.5.jar org.gradle.launcher.daemon.bootstrap.GradleDaemon 7.5 (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[pmathew92]

Closing this PR as it was an experimental attempt