Integrate Chucker for network troubleshooting (#22381)

* Add Chucker integration research documentation

Document the plan for integrating Chucker HTTP inspector into the app
for production use (disabled by default, user opt-in for troubleshooting).

Research findings:
- 7 network paths identified, 5 are OkHttp-based (interceptable)
- OkHttpClientModule is the main path covering ~90% of traffic
- 2 HttpURLConnection usages cannot be intercepted (edge cases)
- Wrapper interceptor approach recommended for runtime enable/disable

* Add track network requests interceptor foundation for Chucker integration

Add an OkHttp interceptor that will serve as the foundation for HTTP
traffic inspection via Chucker. The interceptor is disabled by default
and can be toggled by users in the Help screen for troubleshooting.

Changes:
- Add `TrackNetworkRequestsInterceptor` in FluxC with preference interface
- Add `TrackNetworkRequestsModule` to inject interceptor into OkHttpClient
- Add preference `IS_TRACK_NETWORK_REQUESTS_ENABLED` in `AppPrefs`
- Add toggle UI in Help screen below "Contact email"

* Integrate Chucker library into TrackNetworkRequestsInterceptor

Add Chucker v4.2.0 as the HTTP traffic inspection backend for the
Track Network Requests feature. The interceptor now delegates to
ChuckerInterceptor when the feature is enabled.

Configuration:
- 1-hour retention period
- Sensitive headers redacted (Authorization, Cookie, Set-Cookie, X-WP-Nonce)
- Notifications disabled (custom UI entry point to be added)
- Max content length: 250KB

Changes:
- Add Chucker dependency to libs.versions.toml and build.gradle files
- Update TrackNetworkRequestsInterceptor to create and use ChuckerInterceptor
- Simplify TrackNetworkRequestsModule (Chucker is now an implementation detail)

* Add View Network Requests button to launch Chucker UI

Add a button in the Help screen that launches Chucker's traffic
inspector UI. The button is only visible when Track Network Requests
is enabled.

Changes:
- Add `viewNetworkRequestsButton` to help_activity.xml
- Add `view_network_requests` string resource
- Update `setupTrackNetworkRequestsToggle()` to show/hide button and handle click

* Add configurable retention period and dialog-based UX for network tracking

Implement retention period selection when enabling Track Network Requests,
with dialog-based enable/disable flow for better user communication.

Features:
- Retention period options: 1 Hour, 1 Day, 1 Week, Until Cleared
- Enable dialog with privacy explanation and retention picker
- Disable dialog with guidance on clearing logs manually
- "View Network Requests" now shows current retention period

Technical changes:
- Add `NetworkRequestsRetentionPeriod` enum with stable int values for persistence
- Interceptor lazily creates and recreates ChuckerInterceptor when retention changes
- Add `dialog_title_with_message.xml` layout for dialogs with description text
- Use `setSwitchCheckedSilently()` to prevent listener loops on cancel

Changes:
- Add retention period preference to `AppPrefs` and `AppPrefsWrapper`
- Update `TrackNetworkRequestsPreference` interface with `getRetentionPeriod()`
- Add enable/disable dialogs to `HelpActivity`
- Update `help_activity.xml` with container showing retention info
- Add string resources for retention options and dialog messages

* Add login request tracking and make preferences device-level

Enable network request tracking for OAuth login flows by adding
interceptors to WPcomLoginClient. Move tracking preferences to
UndeletablePrefKey so they persist across logout/login cycles,
allowing users to troubleshoot login issues.

Changes:
- Add interceptors to WPcomLoginClient for OAuth token exchange
- Move IS_TRACK_NETWORK_REQUESTS_ENABLED to UndeletablePrefKey
- Move TRACK_NETWORK_REQUESTS_RETENTION_PERIOD to UndeletablePrefKey
- Add documentation for Chucker export API options

* Add GutenbergKit network request logging to Chucker

Integrates GutenbergKit's WebView network requests with Chucker by
replaying them through OkHttp. This allows editor network traffic
to appear alongside native app requests in the unified log.

Changes:
- Add `GutenbergKitNetworkLogger` to replay JS fetch requests through OkHttp
- Add `isNetworkLoggingEnabled` to `FeatureConfig` and `EditorConfiguration`
- Wire up `NetworkRequestListener` in `GutenbergKitActivity`
- Update GutenbergKit to PR #238 branch with network logging support

* Remove debug logs from GutenbergKit network logging

Remove verbose debug logging used during development.
Keep error logging for diagnosing failures.

* Add experimental feature flag for Network Debugging

Hide the Track Network Requests section in Help behind an experimental
feature flag. When the flag is disabled, the section is completely
hidden. When trying to disable the flag while tracking is enabled,
show an error dialog instructing the user to disable tracking first.

Changes:
- Add NETWORK_DEBUGGING to ExperimentalFeatures.Feature enum
- Add validation in ExperimentalFeaturesViewModel to prevent disabling
  the flag while tracking is active
- Add NetworkDebuggingErrorDialog composable for the error state
- Update HelpActivity to check the feature flag before showing section
- Wrap track network requests UI in a single container for cleaner
  visibility management

* Fix detekt issues in Chucker integration code

Add suppress annotations for:
- LongMethod in ExperimentalFeaturesActivity.onCreate (Compose UI)
- TooGenericExceptionCaught in GutenbergKitNetworkLogger (intentional)
- MagicNumber in GutenbergKitNetworkLogger (HTTP status codes)

* Add network debugging to new Support screen

Duplicate the network tracking functionality from HelpActivity to the
new Compose-based SupportActivity (behind MODERN_SUPPORT flag).

Also update help_activity.xml to show retention info under the toggle
instead of under the view button, for consistency between both UIs.

Changes:
- Add NetworkTrackingState and DialogEvent to SupportViewModel
- Add NetworkTrackingToggleItem composable to SupportScreen
- Add dialog handling and Chucker navigation to SupportActivity
- Restructure help_activity.xml for consistent retention info placement

* Integrate Chucker interceptor into wordpress-rs clients

Wire `TrackNetworkRequestsInterceptor` into all wordpress-rs based
network clients so their requests are captured when network debugging
is enabled.

Changes:
- `WpApiClientProvider`: Accept interceptors via Dagger `@Named` set
- `ApplicationModule`: Pass interceptor to `WpLoginClient`
- `DataViewViewModel`: Inject interceptor for `WpComApiClient`
- `JetpackConnectionHelper`: Inject interceptor for connection client
- `AddSubscribersViewModel`: Inject interceptor for subscriber API
- Child ViewModels: Pass interceptor to parent `DataViewViewModel`

* Update GutenbergKit to v0.11.0 and adapt to API changes

GutenbergKit v0.11.0 renamed `NetworkRequest` to `RecordedNetworkRequest`
and added a `statusText` field, allowing us to remove our custom HTTP
status code mapping.

Changes:
- Update GutenbergKit version to v0.11.0
- Rename NetworkRequest to RecordedNetworkRequest
- Use statusText from RecordedNetworkRequest instead of toStatusMessage()

* Use OkHttpClientQualifiers.INTERCEPTORS constant for @nAmed annotations

Replace hardcoded "interceptors" strings with the constant to prevent
typos and enable easier refactoring.

* Remove research documentation files

* Fix lint warnings and update tests for new constructor parameters

- Add @nonnull annotation to ApplicationModule parameter
- Add @SuppressLint("InflateParams") for AlertDialog custom title inflation
- Update SupportViewModelTest with appPrefsWrapper and experimentalFeatures
- Update DataViewViewModelTest with trackNetworkRequestsInterceptor
- Update ExperimentalFeaturesViewModelTest with appPrefsWrapper
- Update TermsViewModelTest with trackNetworkRequestsInterceptor

* Refactor retention period display string into two methods  Split getRetentionPeriodDisplayString into separate methods for better readability and reusability: - getRetentionPeriodStringRes: returns the string resource ID - getRetentionPeriodDisplayString: resolves it to a String  Changes: - Extract resource ID mapping to dedicated method - Simplify the display string method to delegate

Co-authored-by: Adalberto Plaza <[email protected]>

* Migrate network tracking dialogs to Compose

Replace View-based AlertDialogs with Compose AlertDialogs in SupportScreen.
This addresses PR feedback about using Compose dialogs in a Compose activity.

Changes:
- Add reusable SingleChoiceAlertDialog component
- Convert DialogEvent (SharedFlow) to DialogState (StateFlow) in ViewModel
- Add EnableTrackingDialog and DisableTrackingDialog composables
- Remove XML layout inflation and View-based dialog code from Activity

* Add tests for network tracking functionality in SupportViewModel

Cover the new network tracking dialog state management with tests for:
- init() network debugging state based on feature flag and preferences
- onNetworkTrackingToggle showing enable/disable dialogs
- onEnableTrackingConfirmed/onDisableTrackingConfirmed state updates
- onDialogDismissed without side effects
- onRetentionPeriodSelected updating dialog state

Changes:
- Add 10 new tests in SupportViewModelTest
- Move init-related tests to existing init() region
- Create new region for dialog interaction tests

* Update GutenbergKit to v0.11.1

---------

Co-authored-by: Adalberto Plaza <[email protected]>

Author: oguzkocer

WordPress/build.gradle

@@ -452,6 +452,7 @@ dependencies {
     implementation(libs.greenrobot.eventbus.main)
     implementation(libs.greenrobot.eventbus.java)
     implementation(libs.squareup.retrofit)
+    implementation(libs.chucker)
     implementation(libs.apache.commons.text)
     implementation(libs.airbnb.lottie.main)
     implementation(libs.facebook.shimmer)

WordPress/src/main/java/org/wordpress/android/modules/ApplicationModule.java

@@ -5,6 +5,7 @@
 import android.content.SharedPreferences;
 import android.hardware.SensorManager;
 
+import androidx.annotation.NonNull;
 import androidx.lifecycle.LiveData;
 import androidx.preference.PreferenceManager;
 
@@ -36,6 +37,7 @@
 import org.wordpress.android.util.config.InAppUpdatesFeatureConfig;
 import org.wordpress.android.util.config.RemoteConfigWrapper;
 import org.wordpress.android.util.wizard.WizardManager;
+import org.wordpress.android.fluxc.network.TrackNetworkRequestsInterceptor;
 import org.wordpress.android.viewmodel.helpers.ConnectionStatus;
 import org.wordpress.android.viewmodel.helpers.ConnectionStatusLiveData;
 
@@ -153,7 +155,9 @@ public static RecordingStrategy provideVoiceToContentRecordingStrategy() {
     }
 
     @Provides
-    public static WpLoginClient provideWpLoginClient() {
-        return new WpLoginClient(Collections.emptyList());
+    public static WpLoginClient provideWpLoginClient(
+            @NonNull TrackNetworkRequestsInterceptor trackNetworkRequestsInterceptor
+    ) {
+        return new WpLoginClient(Collections.singletonList(trackNetworkRequestsInterceptor));
     }
 }

WordPress/src/main/java/org/wordpress/android/modules/TrackNetworkRequestsModule.kt

@@ -0,0 +1,56 @@
+package org.wordpress.android.modules
+
+import android.content.Context
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.android.qualifiers.ApplicationContext
+import dagger.hilt.components.SingletonComponent
+import dagger.multibindings.IntoSet
+import okhttp3.Interceptor
+import org.wordpress.android.fluxc.module.OkHttpClientQualifiers
+import org.wordpress.android.fluxc.network.NetworkRequestsRetentionPeriod
+import org.wordpress.android.fluxc.network.TrackNetworkRequestsInterceptor
+import org.wordpress.android.fluxc.network.TrackNetworkRequestsPreference
+import org.wordpress.android.ui.posts.editor.GutenbergKitNetworkLogger
+import org.wordpress.android.ui.prefs.AppPrefsWrapper
+import javax.inject.Named
+import javax.inject.Singleton
+
+@InstallIn(SingletonComponent::class)
+@Module
+class TrackNetworkRequestsModule {
+    @Singleton
+    @Provides
+    fun provideTrackNetworkRequestsPreference(appPrefsWrapper: AppPrefsWrapper): TrackNetworkRequestsPreference {
+        return object : TrackNetworkRequestsPreference {
+            override fun isEnabled(): Boolean = appPrefsWrapper.isTrackNetworkRequestsEnabled
+            override fun getRetentionPeriod(): NetworkRequestsRetentionPeriod =
+                NetworkRequestsRetentionPeriod.fromInt(appPrefsWrapper.trackNetworkRequestsRetentionPeriod)
+        }
+    }
+
+    @Singleton
+    @Provides
+    fun provideTrackNetworkRequestsInterceptor(
+        @ApplicationContext context: Context,
+        preference: TrackNetworkRequestsPreference
+    ): TrackNetworkRequestsInterceptor {
+        return TrackNetworkRequestsInterceptor(context, preference)
+    }
+
+    @Provides
+    @IntoSet
+    @Named(OkHttpClientQualifiers.INTERCEPTORS)
+    fun provideTrackNetworkRequestsInterceptorAsInterceptor(
+        interceptor: TrackNetworkRequestsInterceptor
+    ): Interceptor = interceptor
+
+    @Singleton
+    @Provides
+    fun provideGutenbergKitNetworkLogger(
+        interceptor: TrackNetworkRequestsInterceptor
+    ): GutenbergKitNetworkLogger {
+        return GutenbergKitNetworkLogger(interceptor)
+    }
+}

WordPress/src/main/java/org/wordpress/android/support/main/ui/SupportActivity.kt

@@ -14,15 +14,18 @@ import androidx.core.net.toUri
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
+import com.chuckerteam.chucker.api.Chucker
 import dagger.hilt.android.AndroidEntryPoint
 import kotlinx.coroutines.launch
 import org.wordpress.android.BuildConfig
+import org.wordpress.android.R
+import org.wordpress.android.WordPress
 import org.wordpress.android.analytics.AnalyticsTracker
 import org.wordpress.android.analytics.AnalyticsTracker.Stat
-import org.wordpress.android.WordPress
+import org.wordpress.android.fluxc.network.NetworkRequestsRetentionPeriod
 import org.wordpress.android.support.aibot.ui.AIBotSupportActivity
-import org.wordpress.android.support.logs.ui.LogsActivity
 import org.wordpress.android.support.he.ui.HESupportActivity
+import org.wordpress.android.support.logs.ui.LogsActivity
 import org.wordpress.android.ui.ActivityLauncher
 import org.wordpress.android.ui.compose.theme.AppThemeM3
 
@@ -47,6 +50,8 @@ class SupportActivity : AppCompatActivity() {
                     val userInfo by viewModel.userInfo.collectAsState()
                     val optionsVisibility by viewModel.optionsVisibility.collectAsState()
                     val isLoggedIn by viewModel.isLoggedIn.collectAsState()
+                    val networkTrackingState by viewModel.networkTrackingState.collectAsState()
+                    val dialogState by viewModel.dialogState.collectAsState()
                     AppThemeM3 {
                         SupportScreen(
                             userName = userInfo.userName,
@@ -55,20 +60,50 @@ class SupportActivity : AppCompatActivity() {
                             isLoggedIn = isLoggedIn,
                             showAskTheBots = optionsVisibility.showAskTheBots,
                             showAskHappinessEngineers = optionsVisibility.showAskHappinessEngineers,
+                            showNetworkDebugging = networkTrackingState.showNetworkDebugging,
+                            isNetworkTrackingEnabled = networkTrackingState.isTrackingEnabled,
+                            networkTrackingRetentionInfo = getRetentionInfoText(
+                                networkTrackingState.retentionPeriod
+                            ),
                             versionName = WordPress.versionName,
+                            dialogState = dialogState,
                             onBackClick = { finish() },
                             onLoginClick = { viewModel.onLoginClick() },
                             onHelpCenterClick = { viewModel.onHelpCenterClick() },
                             onAskTheBotsClick = { viewModel.onAskTheBotsClick() },
                             onAskHappinessEngineersClick = { viewModel.onAskHappinessEngineersClick() },
-                            onApplicationLogsClick = { viewModel.onApplicationLogsClick() }
+                            onApplicationLogsClick = { viewModel.onApplicationLogsClick() },
+                            onNetworkTrackingToggle = { viewModel.onNetworkTrackingToggle(it) },
+                            onViewNetworkRequestsClick = { viewModel.onViewNetworkRequestsClick() },
+                            onRetentionPeriodSelected = { viewModel.onRetentionPeriodSelected(it) },
+                            onEnableTrackingConfirmed = { viewModel.onEnableTrackingConfirmed(it) },
+                            onDisableTrackingConfirmed = { viewModel.onDisableTrackingConfirmed() },
+                            onDialogDismissed = { viewModel.onDialogDismissed() },
                         )
                     }
                 }
             }
         )
     }
 
+    private fun getRetentionInfoText(period: NetworkRequestsRetentionPeriod): String {
+        val periodString = getRetentionPeriodDisplayString(period)
+        return getString(R.string.network_requests_retention_info, periodString)
+    }
+
+private fun getRetentionPeriodDisplayString(period: NetworkRequestsRetentionPeriod): String {
+    return getString(getRetentionPeriodStringRes(period))
+}
+
+private fun getRetentionPeriodStringRes(period: NetworkRequestsRetentionPeriod): Int {
+    return when (period) {
+        NetworkRequestsRetentionPeriod.ONE_HOUR -> R.string.network_requests_retention_one_hour
+        NetworkRequestsRetentionPeriod.ONE_DAY -> R.string.network_requests_retention_one_day
+        NetworkRequestsRetentionPeriod.ONE_WEEK -> R.string.network_requests_retention_one_week
+        NetworkRequestsRetentionPeriod.FOREVER -> R.string.network_requests_retention_until_cleared
+    }
+}
+
     private fun observeNavigationEvents() {
         lifecycleScope.launch {
             repeatOnLifecycle(Lifecycle.State.STARTED) {
@@ -81,6 +116,9 @@ class SupportActivity : AppCompatActivity() {
                         is SupportViewModel.NavigationEvent.NavigateToAskHappinessEngineers -> {
                             navigateToAskTheHappinessEngineers()
                         }
+                        is SupportViewModel.NavigationEvent.NavigateToNetworkRequests -> {
+                            navigateToNetworkRequests()
+                        }
                     }
                 }
             }
@@ -120,6 +158,10 @@ class SupportActivity : AppCompatActivity() {
         startActivity(LogsActivity.createIntent(this))
     }
 
+    private fun navigateToNetworkRequests() {
+        startActivity(Chucker.getLaunchIntent(this))
+    }
+
     companion object {
         @JvmStatic
         fun createIntent(context: Context): Intent = Intent(context, SupportActivity::class.java)