refactor: extract widget storage behind WidgetRepository interface

Author: Giyutomioka-SS

AnkiDroid/src/main/java/com/ichi2/anki/AnkiDroidApp.kt

@@ -132,6 +132,8 @@ open class AnkiDroidApp :
         // Get preferences
         val preferences = this.sharedPrefs()
 
+        initializeWidgetRepository()
+
         // Ensures any change is propagated to widgets
         ChangeManager.subscribe(this)
 

AnkiDroid/src/main/java/com/ichi2/anki/MetaDbWidgetRepository.kt

@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: 2026 Sumit Singh <sumitsinghkoranga7@gmail.com>
+// SPDX-License-Identifier: GPL-3.0-or-later
+package com.ichi2.anki
+
+import android.app.Application
+import android.content.Context
+import com.ichi2.widget.SmallWidgetStatus
+import com.ichi2.widget.WidgetRepository
+import com.ichi2.widget.WidgetStorage
+
+/**
+ * Delegates [WidgetRepository] to [MetaDB]. Replace this class to migrate
+ * widget storage to MMKV/DataStore without touching callers.
+ *
+ * TODO: replace MetaDB backing with MMKV or DataStore (#20737)
+ */
+internal class MetaDbWidgetRepository(
+    private val context: Context,
+) : WidgetRepository {
+    override fun storeSmallWidgetStatus(status: SmallWidgetStatus) = MetaDB.storeSmallWidgetStatus(context, status)
+
+    override fun getWidgetSmallStatus(): SmallWidgetStatus = MetaDB.getWidgetSmallStatus(context)
+
+    override fun dueCardsCount(): Int = MetaDB.getNotificationStatus(context)
+}
+
+context(application: Application)
+fun initializeWidgetRepository() {
+    WidgetStorage.setRepository(MetaDbWidgetRepository(application))
+}

AnkiDroid/src/main/java/com/ichi2/anki/services/NotificationService.kt

@@ -332,7 +332,7 @@ class NotificationService : AnkiBroadcastReceiver() {
                         PENDING_NOTIFICATIONS_ONLY.toString(),
                     )!!
                     .toInt()
-            val dueCardsCount = WidgetStatus.fetchDue(context)
+            val dueCardsCount = WidgetStatus.fetchDue()
             if (dueCardsCount >= minCardsDue) {
                 // Build basic notification
                 val cardsDueText =

AnkiDroid/src/main/java/com/ichi2/widget/AnkiDroidWidgetSmall.kt

@@ -148,7 +148,7 @@ class AnkiDroidWidgetSmall : AnalyticsWidgetProvider() {
                 }
             } else {
                 // Compute the total number of cards due.
-                val (dueCardsCount, eta) = WidgetStatus.fetchSmall(context)
+                val (dueCardsCount, eta) = WidgetStatus.fetchSmall()
                 if (dueCardsCount == 0) {
                     updateViews.setViewVisibility(R.id.ankidroid_widget_small_finish_layout, View.VISIBLE)
                     updateViews.setViewVisibility(R.id.widget_eta, View.INVISIBLE)

AnkiDroid/src/main/java/com/ichi2/widget/WidgetRepository.kt

@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: 2026 Sumit Singh <sumitsinghkoranga7@gmail.com>
+// SPDX-License-Identifier: GPL-3.0-or-later
+package com.ichi2.widget
+
+/**
+ * Storage abstraction for widget status, decoupling widget code from [com.ichi2.anki.MetaDB].
+ * When `:widgets` becomes a separate module, this interface moves with it.
+ */
+interface WidgetRepository {
+    fun storeSmallWidgetStatus(status: SmallWidgetStatus)
+
+    fun getWidgetSmallStatus(): SmallWidgetStatus
+
+    fun dueCardsCount(): Int
+}
+
+object WidgetStorage {
+    lateinit var instance: WidgetRepository
+        private set
+
+    fun setRepository(repository: WidgetRepository) {
+        instance = repository
+    }
+
+    fun storeSmallWidgetStatus(status: SmallWidgetStatus) = instance.storeSmallWidgetStatus(status)
+
+    fun getWidgetSmallStatus(): SmallWidgetStatus = instance.getWidgetSmallStatus()
+
+    fun dueCardsCount(): Int = instance.dueCardsCount()
+}

AnkiDroid/src/main/java/com/ichi2/widget/WidgetStatus.kt

@@ -17,7 +17,6 @@ package com.ichi2.widget
 import android.content.Context
 import com.ichi2.anki.AnkiDroidApp
 import com.ichi2.anki.CollectionManager.withCol
-import com.ichi2.anki.MetaDB
 import com.ichi2.anki.R
 import com.ichi2.anki.common.utils.android.SdCard
 import com.ichi2.anki.preferences.sharedPrefs
@@ -94,7 +93,7 @@ object WidgetStatus {
             return
         }
         val status = querySmallWidgetStatus()
-        MetaDB.storeSmallWidgetStatus(context, status)
+        WidgetStorage.storeSmallWidgetStatus(status)
         if (smallWidgetEnabled) {
             Timber.i("triggering small widget UI update")
             AnkiDroidWidgetSmall.UpdateService().doUpdate(context)
@@ -105,9 +104,9 @@ object WidgetStatus {
     }
 
     /** Returns the status of each of the decks.  */
-    fun fetchSmall(context: Context): SmallWidgetStatus = MetaDB.getWidgetSmallStatus(context)
+    fun fetchSmall(): SmallWidgetStatus = WidgetStorage.getWidgetSmallStatus()
 
-    fun fetchDue(context: Context): Int = MetaDB.getNotificationStatus(context)
+    fun fetchDue(): Int = WidgetStorage.dueCardsCount()
 
     private suspend fun querySmallWidgetStatus(): SmallWidgetStatus =
         withCol {