Issue/woomob 1859 declared age range apis for app stores

WooCommerce/build.gradle

@@ -219,6 +219,7 @@ dependencies {
     implementation(libs.google.firebase.analytics)
 
     implementation(libs.google.play.services.auth)
+    implementation libs.google.play.ageSignals
 
     // Support library
     implementation(libs.androidx.core.ktx)

WooCommerce/src/main/kotlin/com/woocommerce/android/AppInitializer.kt

@@ -37,6 +37,7 @@ import com.woocommerce.android.tools.SiteConnectionType.ApplicationPasswords
 import com.woocommerce.android.tools.connectionType
 import com.woocommerce.android.tracker.SendTelemetry
 import com.woocommerce.android.tracker.TrackStoreSnapshot
+import com.woocommerce.android.ui.ageeligibility.AgeEligibilityChecker
 import com.woocommerce.android.ui.appwidgets.getWidgetName
 import com.woocommerce.android.ui.blaze.notification.BlazeCampaignsObserver
 import com.woocommerce.android.ui.common.UserEligibilityFetcher
@@ -149,6 +150,8 @@ class AppInitializer @Inject constructor() : ApplicationLifecycleListener {
 
     @Inject lateinit var getWooVersion: GetWooCorePluginCachedVersion
 
+    @Inject lateinit var ageEligibilityChecker: AgeEligibilityChecker
+
     @Inject
     @AppCoroutineScope
     lateinit var appCoroutineScope: CoroutineScope
@@ -335,6 +338,9 @@ class AppInitializer @Inject constructor() : ApplicationLifecycleListener {
                 }
             }
         }
+        appCoroutineScope.launch {
+            ageEligibilityChecker.checkAge()
+        }
     }
 
     override fun onAppGoesToBackground() {

WooCommerce/src/main/kotlin/com/woocommerce/android/AppPrefs.kt

@@ -218,7 +218,9 @@ object AppPrefs {
 
         WOO_POS_SURVEY_NOTIFICATION_CURRENT_USER_SHOWN,
 
-        WOO_POS_SURVEY_NOTIFICATION_POTENTIAL_USER_SHOWN
+        WOO_POS_SURVEY_NOTIFICATION_POTENTIAL_USER_SHOWN,
+
+        IS_USER_AGE_ELIGIBLE_FOR_APP_USE
     }
 
     fun init(context: Context) {
@@ -323,6 +325,10 @@ object AppPrefs {
         get() = getBoolean(UndeletablePrefKey.WOO_POS_SURVEY_NOTIFICATION_POTENTIAL_USER_SHOWN, false)
         set(value) = setBoolean(UndeletablePrefKey.WOO_POS_SURVEY_NOTIFICATION_POTENTIAL_USER_SHOWN, value)
 
+    var isUserAgeEligibleForAppUse: Boolean
+        get() = getBoolean(key = UndeletablePrefKey.IS_USER_AGE_ELIGIBLE_FOR_APP_USE, default = true)
+        set(value) = setBoolean(key = UndeletablePrefKey.IS_USER_AGE_ELIGIBLE_FOR_APP_USE, value = value)
+
     fun getProductSortingChoice(currentSiteId: Int) = getString(getProductSortingKey(currentSiteId)).orNullIfEmpty()
 
     fun setProductSortingChoice(currentSiteId: Int, value: String) {

WooCommerce/src/main/kotlin/com/woocommerce/android/AppPrefsWrapper.kt

@@ -43,6 +43,8 @@ open class AppPrefsWrapper @Inject constructor() {
 
     var isWooPosSurveyNotificationCurrentUserShown by AppPrefs::isWooPosSurveyNotificationCurrentUserShown
 
+    var isUserAgeEligibleForAppUse by AppPrefs::isUserAgeEligibleForAppUse
+
     open var orderSummaryMigrated by AppPrefs::orderSummaryMigrated
     open var gatewayMigrated by AppPrefs::gatewayMigrated
 

WooCommerce/src/main/kotlin/com/woocommerce/android/analytics/AnalyticsEvent.kt

@@ -1118,7 +1118,10 @@ enum class AnalyticsEvent(override val siteless: Boolean = false) : IAnalyticsEv
     ORDER_VIEW_CUSTOM_FIELDS_TAPPED,
 
     // Black-flagged sites
-    BLACK_FLAGGED_WEBSITE_DETECTED;
+    BLACK_FLAGGED_WEBSITE_DETECTED,
+
+    // Age restriction check
+    ACCOUNT_AGE_RESTRICTION_CHECKED;
 
     override val isPosEvent: Boolean = false
 }

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/ageeligibility/AgeEligibilityChecker.kt

@@ -0,0 +1,86 @@
+package com.woocommerce.android.ui.ageeligibility
+
+import com.google.android.gms.common.api.ApiException
+import com.google.android.play.agesignals.model.AgeSignalsVerificationStatus
+import com.woocommerce.android.AppPrefsWrapper
+import com.woocommerce.android.analytics.AnalyticsEvent
+import com.woocommerce.android.analytics.AnalyticsTrackerWrapper
+import com.woocommerce.android.ui.login.AccountRepository
+import com.woocommerce.android.util.WooLog
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import javax.inject.Inject
+import javax.inject.Singleton
+
+@Singleton
+class AgeEligibilityChecker @Inject constructor(
+    private val client: AgeSignalsClient,
+    private val prefsWrapper: AppPrefsWrapper,
+    private val accountRepository: AccountRepository,
+    private val trackerWrapper: AnalyticsTrackerWrapper
+) {
+
+    private val _isUserAgeRangeEligible = MutableStateFlow(prefsWrapper.isUserAgeEligibleForAppUse)
+    val isUserAgeRangeEligible: StateFlow<Boolean> = _isUserAgeRangeEligible.asStateFlow()
+
+    suspend fun checkAge() {
+        val trackingProperties = mutableMapOf<String, Any>()
+        try {
+            val result = client.checkAge()
+            processAgeCheck(result.userStatus, result.ageUpper)
+            trackingProperties["retrieved_age"] = result.ageUpper ?: -1
+            trackingProperties["user_status"] = getUserStatusAsString(result.userStatus)
+        } catch (exception: ApiException) {
+            WooLog.i(
+                WooLog.T.UTILS,
+                "AgeEligibilityChecker ${exception.javaClass.simpleName} while checking user " +
+                    "age: ${exception.message}, reverting user eligibility to true"
+            )
+            prefsWrapper.isUserAgeEligibleForAppUse = true
+            _isUserAgeRangeEligible.value = true
+        }
+        if (isUserAgeRangeEligible.value.not()) {
+            accountRepository.logout()
+        }
+        trackingProperties["access_restricted"] = _isUserAgeRangeEligible.value
+        trackerWrapper.track(AnalyticsEvent.ACCOUNT_AGE_RESTRICTION_CHECKED, properties = trackingProperties)
+    }
+
+    private fun processAgeCheck(userStatus: Int?, ageUpper: Int?) {
+        val isUserAgeEligible = when (userStatus) {
+            AgeSignalsVerificationStatus.VERIFIED -> true
+            AgeSignalsVerificationStatus.SUPERVISED,
+            AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING -> {
+                if (ageUpper == null) {
+                    true // If we can't determine the age return true
+                } else {
+                    ageUpper >= WOOCOMMERCE_TOS_MINIMUM_AGE_FOR_APP_USE
+                }
+            }
+
+            AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED -> false
+
+            AgeSignalsVerificationStatus.UNKNOWN -> true // Safe default: allow access if unknown
+            else -> true // Handle any other cases as default
+        }
+
+        prefsWrapper.isUserAgeEligibleForAppUse = isUserAgeEligible
+        _isUserAgeRangeEligible.value = isUserAgeEligible
+    }
+
+    private fun getUserStatusAsString(userStatus: Int?): String {
+        return when (userStatus) {
+            AgeSignalsVerificationStatus.VERIFIED -> "VERIFIED"
+            AgeSignalsVerificationStatus.SUPERVISED -> "SUPERVISED"
+            AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING -> "SUPERVISED_APPROVAL_PENDING"
+            AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED -> "SUPERVISED_APPROVAL_DENIED"
+            AgeSignalsVerificationStatus.UNKNOWN -> "UNKNOWN"
+            else -> "UNKNOWN"
+        }
+    }
+
+    companion object {
+        private const val WOOCOMMERCE_TOS_MINIMUM_AGE_FOR_APP_USE = 13
+    }
+}

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/ageeligibility/AgeSignalsClient.kt

@@ -0,0 +1,29 @@
+package com.woocommerce.android.ui.ageeligibility
+
+import android.content.Context
+import com.google.android.play.agesignals.AgeSignalsManagerFactory
+import com.google.android.play.agesignals.AgeSignalsRequest
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.tasks.await
+import javax.inject.Inject
+import javax.inject.Singleton
+
+interface AgeSignalsClient {
+    suspend fun checkAge(): AgeCheckResult
+}
+
+data class AgeCheckResult(
+    val userStatus: Int?,
+    val ageUpper: Int?
+)
+
+@Singleton
+class DefaultAgeSignalsClient @Inject constructor(
+    @ApplicationContext private val context: Context
+) : AgeSignalsClient {
+    override suspend fun checkAge(): AgeCheckResult {
+        val manager = AgeSignalsManagerFactory.create(context)
+        val result = manager.checkAgeSignals(AgeSignalsRequest.builder().build()).await()
+        return AgeCheckResult(result.userStatus(), result.ageUpper())
+    }
+}

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/ageeligibility/AgeSignalsModule.kt

@@ -0,0 +1,15 @@
+package com.woocommerce.android.ui.ageeligibility
+
+import dagger.Binds
+import dagger.Module
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import javax.inject.Singleton
+
+@Module
+@InstallIn(SingletonComponent::class)
+abstract class AgeSignalsModule {
+    @Binds
+    @Singleton
+    abstract fun bindAgeSignalsClient(impl: DefaultAgeSignalsClient): AgeSignalsClient
+}

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/login/LoginActivity.kt

@@ -9,6 +9,7 @@ import android.view.MenuItem
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.SystemBarStyle
 import androidx.activity.enableEdgeToEdge
+import androidx.appcompat.app.AlertDialog
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
@@ -206,6 +207,9 @@ class LoginActivity :
             unifiedLoginTracker.setFlow(ss.getString(KEY_UNIFIED_TRACKER_FLOW))
             connectSiteInfo = ss.parcelable(KEY_CONNECT_SITE_INFO)
         }
+        if (appPrefsWrapper.isUserAgeEligibleForAppUse.not()) {
+            showAgeRestrictionDialog()
+        }
     }
 
     private fun applyDefaultWindowInsets() {
@@ -1043,6 +1047,16 @@ class LoginActivity :
         }
     }
 
+    private fun showAgeRestrictionDialog() {
+        val dialog = AlertDialog.Builder(this)
+            .setTitle(R.string.age_restriction_dialog_title)
+            .setMessage(R.string.age_restriction_dialog_message)
+            .setCancelable(false)
+            .setPositiveButton(android.R.string.ok) { _, _ -> finishAffinity() }
+            .create()
+        dialog.show()
+    }
+
     /**
      * Show a DialogFragment using the current Fragment's childFragmentManager.
      * This is useful to make sure the dialog's lifecycle is linked to the Fragment that invokes it and that it would

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/main/MainActivity.kt

@@ -894,6 +894,7 @@ class MainActivity :
         observeMoreMenuBadgeStateEvent()
         observeTrialStatus()
         observeBottomBarState()
+        observeUserAgeEligibilityState()
     }
 
     private fun showBlazeCampaignList(campaignId: String?) {
@@ -966,6 +967,14 @@ class MainActivity :
         }
     }
 
+    private fun observeUserAgeEligibilityState() {
+        viewModel.isUserAgeRangeEligible.observe(this) { isUserAgeEligible ->
+            if (isUserAgeEligible.not()) {
+                showLoginScreen()
+            }
+        }
+    }
+
     private fun requestNotificationsPermission() {
         if (VERSION.SDK_INT >= VERSION_CODES.TIRAMISU) {
             WooPermissionUtils.requestNotificationsPermission(launcher)

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/main/MainActivityViewModel.kt

@@ -25,6 +25,7 @@ import com.woocommerce.android.notifications.push.NotificationMessageHandler
 import com.woocommerce.android.tools.SelectedSite
 import com.woocommerce.android.tools.SiteConnectionType.Jetpack
 import com.woocommerce.android.tools.connectionType
+import com.woocommerce.android.ui.ageeligibility.AgeEligibilityChecker
 import com.woocommerce.android.ui.feedback.SurveyType
 import com.woocommerce.android.ui.main.MainActivityViewModel.MoreMenuBadgeState.Hidden
 import com.woocommerce.android.ui.main.MainActivityViewModel.MoreMenuBadgeState.NewFeature
@@ -62,6 +63,7 @@ class MainActivityViewModel @Inject constructor(
     private val analyticsTrackerWrapper: AnalyticsTrackerWrapper,
     private val resolveAppLink: ResolveAppLink,
     private val privacyRepository: PrivacySettingsRepository,
+    private val ageEligibilityChecker: AgeEligibilityChecker,
     moreMenuNewFeatureHandler: MoreMenuNewFeatureHandler,
     unseenReviewsCountHandler: UnseenReviewsCountHandler,
     determineTrialStatusBarState: DetermineTrialStatusBarState,
@@ -84,6 +86,8 @@ class MainActivityViewModel @Inject constructor(
 
     val trialStatusBarState = determineTrialStatusBarState(_bottomBarState).asLiveData()
 
+    val isUserAgeRangeEligible = ageEligibilityChecker.isUserAgeRangeEligible.asLiveData()
+
     fun handleShortcutAction(action: String?) {
         if (!selectedSite.exists()) return
         when (action) {

WooCommerce/src/main/res/values/strings.xml

@@ -4348,4 +4348,6 @@
     <string name="about_automattic_logo_description">Automattic logo</string>
     <string name="about_automattic_back_icon_description">Back icon</string>
     <string name="about_automattic_app_icon_description">App icon</string>
+    <string name="age_restriction_dialog_title">Account Access Required</string>
+    <string name="age_restriction_dialog_message">Your Google Account settings indicate that you need a parent or guardian\'s permission to continue. They can grant access using their Google account to get you back online.</string>
 </resources>