From 15e3efd167f3a92326a032bc1ab010fcee6a8da9 Mon Sep 17 00:00:00 2001
From: "david.schkalee" <david.schkalee@sportalliance.com>
Date: Sun, 9 Aug 2026 16:15:37 +0200
Subject: [PATCH] Expose recently played games over a content provider for
 companion apps

---
 .../android/app/src/main/AndroidManifest.xml  |   5 +
 .../library/RecentGamesContentProvider.kt     | 128 ++++++++++++++++++
 2 files changed, 133 insertions(+)
 create mode 100644 platforms/android/app/src/main/java/com/armsx2/data/library/RecentGamesContentProvider.kt

diff --git a/platforms/android/app/src/main/AndroidManifest.xml b/platforms/android/app/src/main/AndroidManifest.xml
index fea105dd12..6369164d32 100644
--- a/platforms/android/app/src/main/AndroidManifest.xml
+++ b/platforms/android/app/src/main/AndroidManifest.xml
@@ -124,6 +124,11 @@
             </intent-filter>
         </receiver>
 
+        <provider
+            android:name=".data.library.RecentGamesContentProvider"
+            android:authorities="${applicationId}.romlibrary"
+            android:exported="true" />
+
         <!--
             Discord Social SDK's OAuth landing activity. Declared here rather than inherited from
             the vendor .aar on purpose: that .aar's manifest also declares RECORD_AUDIO, three
diff --git a/platforms/android/app/src/main/java/com/armsx2/data/library/RecentGamesContentProvider.kt b/platforms/android/app/src/main/java/com/armsx2/data/library/RecentGamesContentProvider.kt
new file mode 100644
index 0000000000..12a928b7a0
--- /dev/null
+++ b/platforms/android/app/src/main/java/com/armsx2/data/library/RecentGamesContentProvider.kt
@@ -0,0 +1,128 @@
+package com.armsx2.data.library
+
+import android.content.ContentProvider
+import android.content.ContentValues
+import android.content.Context
+import android.content.SharedPreferences
+import android.database.Cursor
+import android.database.MatrixCursor
+import android.net.Uri
+import org.json.JSONArray
+
+/**
+ * Exposes the recently-played list over Binder IPC instead of only the
+ * `recent_games.json` file [GameLibraryRepository] writes to systemDirPosix().
+ * That path resolves to Android/data/<pkg>/files/ on the volume-choice model
+ * (the one folder writable without extra permissions under scoped storage),
+ * which the OS blocks from cross-app filesystem reads regardless of storage
+ * permission grants. A ContentProvider sidesteps that: it runs in-process,
+ * reads its own private SharedPreferences normally, and serves the data out
+ * over IPC, no storage permissions needed on either side.
+ *
+ * Reads SharedPreferences directly rather than going through
+ * [GameLibraryRepository]/MainActivityRuntime.prefs, which is only
+ * initialized once the main activity has launched; a query from a companion
+ * app before that point would otherwise crash or return nothing.
+ */
+class RecentGamesContentProvider : ContentProvider() {
+
+    companion object {
+        private const val PREFS_NAME = "ARMSX2"
+        private const val KEY_GAMES_CACHE = "gamesCache"
+        private const val KEY_RECENT_URIS = "recentGameUris"
+        private const val LAST_PLAYED_PREFIX = "playtime.last."
+        private const val MAX_RECENT_LOOKUP = 12
+
+        const val PATH_GAMES = "games"
+        const val COLUMN_URI = "uri"
+        const val COLUMN_TITLE = "title"
+        const val COLUMN_SERIAL = "serial"
+        const val COLUMN_EXT = "ext"
+        const val COLUMN_PLATFORM = "platform"
+        const val COLUMN_LAST_PLAYED = "lastPlayed"
+
+        private val COLUMNS = arrayOf(
+            COLUMN_URI,
+            COLUMN_TITLE,
+            COLUMN_SERIAL,
+            COLUMN_EXT,
+            COLUMN_PLATFORM,
+            COLUMN_LAST_PLAYED,
+        )
+    }
+
+    override fun onCreate(): Boolean = true
+
+    override fun query(uri: Uri, projection: Array<out String>?, selection: String?, selectionArgs: Array<out String>?, sortOrder: String?): Cursor {
+        val cursor = MatrixCursor(COLUMNS)
+        val context = context ?: return cursor
+        val prefs = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+
+        val recentUris = readRecentUris(prefs)
+        if (recentUris.isEmpty()) {
+            return cursor
+        }
+
+        val gamesByUri = readGamesCache(prefs)
+        recentUris.take(MAX_RECENT_LOOKUP).forEach { uriString ->
+            val game = gamesByUri[uriString] ?: return@forEach
+            val lastPlayed = game.serial
+                ?.let { serial -> prefs.getLong(LAST_PLAYED_PREFIX + serial, 0L) }
+                ?.takeIf { it > 0L }
+
+            cursor.addRow(
+                arrayOf<Any?>(
+                    game.uri,
+                    game.title,
+                    game.serial,
+                    game.ext,
+                    game.platform,
+                    lastPlayed,
+                )
+            )
+        }
+
+        return cursor
+    }
+
+    override fun getType(uri: Uri): String? = null
+
+    override fun insert(uri: Uri, values: ContentValues?): Uri? = null
+
+    override fun delete(uri: Uri, selection: String?, selectionArgs: Array<out String>?): Int = 0
+
+    override fun update(uri: Uri, values: ContentValues?, selection: String?, selectionArgs: Array<out String>?): Int = 0
+
+    private data class CachedGame(val uri: String, val title: String, val serial: String?, val ext: String, val platform: String)
+
+    private fun readRecentUris(prefs: SharedPreferences): List<String> {
+        val raw = prefs.getString(KEY_RECENT_URIS, null) ?: return emptyList()
+        return runCatching {
+            val array = JSONArray(raw)
+            List(array.length()) { array.getString(it) }
+        }.getOrDefault(emptyList())
+    }
+
+    private fun readGamesCache(prefs: SharedPreferences): Map<String, CachedGame> {
+        val raw = prefs.getString(KEY_GAMES_CACHE, null) ?: return emptyMap()
+        return runCatching {
+            val array = JSONArray(raw)
+            buildMap {
+                repeat(array.length()) { index ->
+                    val item = array.getJSONObject(index)
+                    val uriString = item.getString("uri")
+                    put(
+                        uriString,
+                        CachedGame(
+                            uri = uriString,
+                            title = item.getString("title"),
+                            serial = if (item.isNull("serial")) null else item.optString("serial").takeIf(String::isNotBlank),
+                            ext = item.optString("ext").ifBlank { uriString.substringAfterLast('.', "").uppercase() },
+                            platform = item.optString("platform"),
+                        )
+                    )
+                }
+            }
+        }.getOrDefault(emptyMap())
+    }
+}