Use product_entitlement_mapping topic blob for offline entitlements when remote config enabled

[tonidero]

Motivation

When BuildConfig.ENABLE_REMOTE_CONFIG is on, the remote-config pipeline (#3435/#3437/#3439/#3450) downloads the product_entitlement_mapping topic blob to disk. The SDK should consume that file as the source-of-truth for offline entitlements instead of issuing the legacy GET /v1/product_entitlement_mapping call. When the flag is off, behavior must be unchanged.

Description

Behavior gated on BuildConfig.ENABLE_REMOTE_CONFIG, surfaced into the SDK via a single useRemoteConfigForProductEntitlementMapping value computed once in PurchasesFactory:

• Stop the direct backend fetch. OfflineEntitlementsManager.updateProductEntitlementMappingCacheIfStale becomes a no-op (completion?.invoke(null) and return) when the flag is on, so Backend.getProductEntitlementMapping is never issued.
• Read the topic file at consumer-call time, off-main, with in-memory caching. New ProductEntitlementMappingTopicReader:
  • suspend fun read(): ProductEntitlementMapping? — reads the single non-rc_topic_ file in noBackupFilesDir/RevenueCat/topics/product_entitlement_mapping/ and parses it via ProductEntitlementMapping.fromJson(JSONObject(...), loadedFromCache = true).
  • Coalesces concurrent callers via a shared Deferred<ProductEntitlementMapping?> held in inFlight, guarded by synchronized(lock). Started with CoroutineStart.LAZY so inFlight is assigned before the body runs (otherwise an eager dispatcher would let the body's inFlight = null execute and .also { inFlight = it } would overwrite it back with a completed deferred, leaking it into the next read).
  • Owns its own CoroutineScope(SupervisorJob() + dispatcher) (dispatcher: CoroutineDispatcher = Dispatchers.IO, overridable for tests) so cancellation of one caller doesn't cancel the load others are awaiting.
  • fun invalidate() is non-suspend (it's called from a synchronous topic-update listener); just clears cached under the lock.
• Fall back to the existing SharedPreferences cache if the topic file is absent (first launch, download in-flight). New ProductEntitlementMappingSource interface (kept callback-shaped because its consumer PurchasedProductsFetcher.queryActiveProducts is pre-existing callback API):
  • DeviceCacheProductEntitlementMappingSource — synchronous, used when the flag is off.
  • RemoteConfigProductEntitlementMappingSource — owns a small CoroutineScope, launches reader.read() (suspend) and forwards topicMapping ?: deviceCache.getProductEntitlementMapping() to the callback.
• Invalidate the in-memory cache when a fresh blob is downloaded. TopicFetcher gains a topicUpdatedListener: ((Topic) -> Unit)? = null parameter, invoked after a successful downloadVerifyAndStore. PurchasesFactory registers a listener that calls productEntitlementMappingTopicReader.invalidate() when the PRODUCT_ENTITLEMENT_MAPPING topic is rewritten, so a new manifest takes effect within the same session.
• Wiring (PurchasesFactory). Hoists TopicFetcher out of RemoteConfigManager's inline construction so the same instance is shared between the manager and the reader's invalidation hook. The flag funnels in at one place, matching the existing PurchasesOrchestrator.refreshRemoteConfigIfEnabled gating style.

Tests

runTest for everything; UnconfinedTestDispatcher for the simple paths and StandardTestDispatcher for the coalescing test (so two callers can interleave before the body runs):

• ProductEntitlementMappingTopicReaderTest (new) — missing dir, empty dir, valid blob parsed, second read returns same instance with no extra disk access (counted via noBackupFilesDir mock answer), ignores rc_topic_ prefix files, corrupt JSON returns null, invalidate() clears the cache, concurrent reads coalesce into a single disk access.
• OfflineEntitlementsManagerTest — adds a "skips backend fetch when useRemoteConfigForProductEntitlementMapping = true" case and confirms the existing 25h staleness logic still runs when the flag is off.
• PurchasedProductsFetcherTest — already callback-shaped via ProductEntitlementMappingSource; reused unchanged.
• TopicFetcherTest — adds three listener cases (fires after successful download, doesn't fire on cache hit, doesn't fire on download error).

Trade-offs

• The topic blob is read into a ByteArray and decoded as UTF-8 JSON. Realistic mapping size is well under 1 MB; revisit if it grows materially.
• We do not bridge a topic-file mapping into SharedPreferences. The two stores stay independent — SharedPreferences exists only as a fallback. With the flag on and the topic system healthy, the SharedPreferences cache will go stale; that's intentional.
• Backend.getProductEntitlementMapping stays callback-based — it's the legacy network path.

All changes are internal; no public API surface change.

Stack

• ⬇ Add network scaffolding for remote config endpoint: Add network scaffolding for remote config endpoint #3435
• ⬇ Add RemoteConfigManager and TopicFetcher: Add RemoteConfigManager and TopicFetcher #3437
• ⬇ Clean up unreferenced topic files after successful remote-config refresh: Clean up unreferenced topic files after successful remote-config refresh #3439
• ⬇ Wire RemoteConfigManager refresh on first foreground and identity changes: Wire RemoteConfigManager refresh on first foreground and identity changes (off by default) #3450
• This PR: Use product_entitlement_mapping topic blob for offline entitlements when remote config enabled #3455

Checklist

• Unit tests
• Follow-up issues for purchases-ios / hybrids (deferred — feature is not yet wired to any consumer)

[tonidero]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Use product_entitlement_mapping topic blob for offline entitlements when remote config enabled #3455 👈 (View in Graphite)
• Wire RemoteConfigManager refresh on first foreground and identity changes (off by default) #3450
• Fall back across blob sources when topic downloads fail #3466
• Select blob source by priority and weighted random #3458
• Clean up unreferenced topic files after successful remote-config refresh #3439
• Cache remote config response in memory with TTL and persist to disk #3457
• Add RemoteConfigManager and TopicFetcher #3437
• Add network scaffolding for remote config endpoint #3435
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

❌ Patch coverage is 84.14634% with 13 lines in your changes missing coverage. Please review.
✅ Project coverage is 79.98%. Comparing base (bf72a8a) to head (f23483c).

Files with missing lines	Patch %	Lines
...ineentitlements/ProductEntitlementMappingSource.kt	18.18%	9 Missing ⚠️
...otlin/com/revenuecat/purchases/PurchasesFactory.kt	85.71%	2 Missing ⚠️
.../offlineentitlements/OfflineEntitlementsManager.kt	66.66%	0 Missing and 1 partial ⚠️
...titlements/ProductEntitlementMappingTopicReader.kt	97.22%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@                                        Coverage Diff                                         @@
##           toniricodiez/wire-remote-config-manager-on-configure-and-login    #3455      +/-   ##
==================================================================================================
- Coverage                                                           79.98%   79.98%   -0.01%     
==================================================================================================
  Files                                                                 369      371       +2     
  Lines                                                               14951    15015      +64     
  Branches                                                             2069     2083      +14     
==================================================================================================
+ Hits                                                                11959    12010      +51     
- Misses                                                               2153     2164      +11     
- Partials                                                              839      841       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[emerge-tools]

📸 Snapshot Test

591 unchanged

Name	Added	Removed	Modified	Renamed	Unchanged	Errored	Approval
TestPurchasesUIAndroidCompatibility Paparazzi com.revenuecat.testpurchasesuiandroidcompatibility.paparazzi	0	0	0	0	257	0	N/A
TestPurchasesUIAndroidCompatibility com.revenuecat.testpurchasesuiandroidcompatibility	0	0	0	0	334	0	N/A

---

🛸 Powered by Emerge Tools