Merge pull request #416 from OpenHub-Store/deffered-installation

Author: rainxchzed

.claude/settings.local.json

@@ -4,7 +4,13 @@
       "Bash(grep -r \"\\\\.FLATPAK\\\\|Flatpak\\\\|flatpak\" . --include=*.kt)",
       "Bash(./gradlew :composeApp:assembleDebug)",
       "Bash(./gradlew :composeApp:jvmJar)",
-      "Bash(./gradlew :composeApp:assembleDebug :composeApp:jvmJar)"
+      "Bash(./gradlew :composeApp:assembleDebug :composeApp:jvmJar)",
+      "Bash(./gradlew :core:data:compileDebugKotlinAndroid :core:domain:compileDebugKotlinAndroid)",
+      "Bash(./gradlew :feature:details:presentation:compileDebugKotlinAndroid)",
+      "Bash(./gradlew :feature:apps:presentation:compileDebugKotlinAndroid)",
+      "Bash(./gradlew :core:data:compileDebugKotlinAndroid)",
+      "Bash(./gradlew :core:data:compileDebugKotlinAndroid :feature:details:presentation:compileDebugKotlinAndroid :feature:apps:presentation:compileDebugKotlinAndroid)",
+      "Bash(./gradlew :composeApp:compileDebugKotlinAndroid :core:data:compileDebugKotlinAndroid :core:domain:compileDebugKotlinAndroid :feature:details:presentation:compileDebugKotlinAndroid :feature:apps:presentation:compileDebugKotlinAndroid)"
     ]
   }
 }

composeApp/src/androidMain/AndroidManifest.xml

@@ -63,6 +63,18 @@
                     android:scheme="githubstore" />
             </intent-filter>
 
+            <!-- Pending-install notification deep link -->
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data
+                    android:host="apps"
+                    android:scheme="githubstore" />
+            </intent-filter>
+
             <intent-filter>
                 <action android:name="android.intent.action.SEND" />
                 <category android:name="android.intent.category.DEFAULT" />

composeApp/src/androidMain/res/xml/filepaths.xml

@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
 <paths xmlns:android="http://schemas.android.com/apk/res/android">
 
-    <!-- Public Downloads/GitHub Store folder (visible in file managers) -->
-    <external-path
+    <!-- App-private downloads (no permissions required) -->
+    <external-files-path
         name="ghs_downloads"
-        path="Download/GitHub Store/" />
+        path="Download/" />
 
-    <!-- Legacy app-private downloads (for migration) -->
-    <external-files-path
-        name="ghs_legacy_downloads"
-        path="/" />
+    <!-- Internal fallback when external files dir is unavailable -->
+    <files-path
+        name="ghs_internal_downloads"
+        path="downloads/" />
 
     <cache-path
         name="exports"

composeApp/src/commonMain/kotlin/zed/rainxch/githubstore/Main.kt

@@ -41,6 +41,19 @@ fun App(deepLinkUri: String? = null) {
                     )
                 }
 
+                DeepLinkDestination.Apps -> {
+                    // Pending-install notification dropped us here.
+                    // Navigate to the apps tab so the user can finish
+                    // the deferred install from the row.
+                    navController.navigate(GithubStoreGraph.AppsScreen) {
+                        popUpTo(GithubStoreGraph.HomeScreen) {
+                            saveState = true
+                        }
+                        launchSingleTop = true
+                        restoreState = true
+                    }
+                }
+
                 DeepLinkDestination.None -> {
                     // ignore unrecognized deep links
                 }

composeApp/src/commonMain/kotlin/zed/rainxch/githubstore/app/deeplink/DeepLinkParser.kt

@@ -6,6 +6,13 @@ sealed interface DeepLinkDestination {
         val repo: String,
     ) : DeepLinkDestination
 
+    /**
+     * Deep link to the apps tab. Used by the pending-install
+     * notification to bring the user back to the row where they can
+     * complete a deferred install.
+     */
+    data object Apps : DeepLinkDestination
+
     data object None : DeepLinkDestination
 }
 
@@ -52,6 +59,14 @@ object DeepLinkParser {
 
     fun parse(uri: String): DeepLinkDestination {
         return when {
+            // Pending-install notification opens the apps tab. No path
+            // segments — the deferred install is keyed by package name
+            // on the row itself, so the link only needs to bring the
+            // user to the right tab.
+            uri == "githubstore://apps" || uri == "githubstore://apps/" || uri.startsWith("githubstore://apps?") -> {
+                DeepLinkDestination.Apps
+            }
+
             uri.startsWith("githubstore://repo/") -> {
                 val path = uri.removePrefix("githubstore://repo/")
                 val decoded = urlDecode(path)