Add ACTION_USER_UNLOCKED support for Private Space VPN auto-start

Co-authored-by: ignoramous <852289+ignoramous@users.noreply.github.com>

Author: Copilot

app/src/full/AndroidManifest.xml

@@ -203,6 +203,7 @@
             android:exported="false">
             <intent-filter>
                 <action android:name="android.intent.action.USER_PRESENT" />
+                <action android:name="android.intent.action.USER_UNLOCKED" />
             </intent-filter>
         </receiver>
 

app/src/full/java/com/celzero/bravedns/receiver/UserPresentReceiver.kt

@@ -15,26 +15,71 @@
  */
 package com.celzero.bravedns.receiver
 
+import Logger
 import Logger.LOG_TAG_UI
+import Logger.LOG_TAG_VPN
 import android.content.BroadcastReceiver
 import android.content.Context
 import android.content.Intent
+import android.net.VpnService
+import com.celzero.bravedns.service.PersistentState
 import com.celzero.bravedns.service.VpnController
+import org.koin.core.component.KoinComponent
+import org.koin.core.component.inject
 
 /**
- * BroadcastReceiver to handle screen state changes (on/off) and user presence.
- * Informs the VpnController about these events.
+ * BroadcastReceiver to handle user presence and user unlocking events.
+ * Informs the VpnController about these events and handles VPN auto-start for Private Space unlock.
  */
-class UserPresentReceiver : BroadcastReceiver() {
+class UserPresentReceiver : BroadcastReceiver(), KoinComponent {
+
+    val persistentState by inject<PersistentState>()
     override fun onReceive(context: Context, intent: Intent) {
-        if (Intent.ACTION_SCREEN_OFF == intent.action) {
-            VpnController.screenLock()
-            Logger.v(LOG_TAG_UI, "user-present: action screen off, inform vpn service")
-        } else if (Intent.ACTION_SCREEN_ON == intent.action || Intent.ACTION_USER_PRESENT == intent.action) {
-            VpnController.screenUnlock()
-            Logger.v(LOG_TAG_UI, "user-present: action screen on, inform vpn service")
+        when (intent.action) {
+            Intent.ACTION_USER_PRESENT -> {
+                VpnController.screenUnlock()
+                Logger.v(LOG_TAG_UI, "user-present: action user present, inform vpn service")
+            }
+            Intent.ACTION_USER_UNLOCKED -> {
+                handleUserUnlocked(context)
+            }
+            else -> {
+                Logger.v(LOG_TAG_UI, "user-present: unknown action ${intent.action}, skipping")
+            }
+        }
+    }
+
+    private fun handleUserUnlocked(context: Context) {
+        Logger.v(LOG_TAG_UI, "user-present: user unlocked (Private Space), inform vpn service")
+        VpnController.screenUnlock()
+
+        // Auto-start VPN if auto-start is enabled and VPN was previously active
+        // This handles Private Space unlock scenario where VPN should auto-start
+        if (!persistentState.prefAutoStartBootUp) {
+            Logger.v(LOG_TAG_VPN, "user-unlocked: auto start is not enabled, skipping auto-start")
+            return
+        }
+
+        // Check if VPN was activated and should be auto-started
+        // Similar logic to BraveAutoStartReceiver but for user unlock events
+        if (VpnController.state().activationRequested) {
+            val prepareVpnIntent: Intent? =
+                try {
+                    Logger.i(LOG_TAG_VPN, "user-unlocked: attempting to auto-start VPN for Private Space")
+                    VpnService.prepare(context)
+                } catch (e: NullPointerException) {
+                    Logger.w(LOG_TAG_VPN, "user-unlocked: device does not support system-wide VPN mode")
+                    return
+                }
+
+            if (prepareVpnIntent == null) {
+                Logger.i(LOG_TAG_VPN, "user-unlocked: VPN is already prepared, invoking start")
+                VpnController.start(context)
+            } else {
+                Logger.i(LOG_TAG_VPN, "user-unlocked: VPN needs preparation, cannot auto-start")
+            }
         } else {
-            Logger.v(LOG_TAG_UI, "user-present: unknown action ${intent.action}, skipping")
+            Logger.v(LOG_TAG_VPN, "user-unlocked: VPN activation not requested, skipping auto-start")
         }
     }
 }