chore: FDv2 Cache Initializer

launchdarkly-android-client-sdk/src/main/java/com/launchdarkly/sdk/android/ClientContextImpl.java

@@ -207,6 +207,11 @@ public PersistentDataStoreWrapper.PerEnvironmentData getPerEnvironmentData() {
         return throwExceptionIfNull(perEnvironmentData);
     }
 
+    @Nullable
+    public PersistentDataStoreWrapper.PerEnvironmentData getPerEnvironmentDataIfAvailable() {
+        return perEnvironmentData;
+    }
+
     @Nullable
     public TransactionalDataStore getTransactionalDataStore() {
         return transactionalDataStore;

launchdarkly-android-client-sdk/src/main/java/com/launchdarkly/sdk/android/FDv2DataSourceBuilder.java

@@ -2,6 +2,7 @@
 
 import androidx.annotation.NonNull;
 
+import com.launchdarkly.sdk.android.subsystems.CachedFlagStore;
 import com.launchdarkly.sdk.android.subsystems.ClientContext;
 import com.launchdarkly.sdk.android.subsystems.ComponentConfigurer;
 import com.launchdarkly.sdk.android.subsystems.DataSource;
@@ -149,18 +150,30 @@ public void close() {
     }
 
     private DataSourceBuildInputs makeInputs(ClientContext clientContext) {
-        TransactionalDataStore store = ClientContextImpl.get(clientContext).getTransactionalDataStore();
+        ClientContextImpl impl = ClientContextImpl.get(clientContext);
+        TransactionalDataStore store = impl.getTransactionalDataStore();
         SelectorSource selectorSource = store != null
                 ? new SelectorSourceFacade(store)
                 : () -> com.launchdarkly.sdk.fdv2.Selector.EMPTY;
+
+        PersistentDataStoreWrapper.PerEnvironmentData envData = impl.getPerEnvironmentDataIfAvailable();
+        CachedFlagStore cachedFlagStore = envData != null
+                ? context -> {
+                    String hashedId = LDUtil.urlSafeBase64HashedContextId(context);
+                    EnvironmentData stored = envData.getContextData(hashedId);
+                    return stored != null ? stored.getAll() : null;
+                }
+                : null;
+
         return new DataSourceBuildInputs(
                 clientContext.getEvaluationContext(),
                 clientContext.getServiceEndpoints(),
                 clientContext.getHttp(),
                 clientContext.isEvaluationReasons(),
                 selectorSource,
                 sharedExecutor,
-                ClientContextImpl.get(clientContext).getPlatformState().getCacheDir(),
+                impl.getPlatformState().getCacheDir(),
+                cachedFlagStore,
                 clientContext.getBaseLogger()
         );
     }

launchdarkly-android-client-sdk/src/main/java/com/launchdarkly/sdk/android/subsystems/CachedFlagStore.java

@@ -0,0 +1,27 @@
+package com.launchdarkly.sdk.android.subsystems;
+
+import androidx.annotation.Nullable;
+
+import com.launchdarkly.sdk.LDContext;
+import com.launchdarkly.sdk.android.DataModel;
+
+import java.util.Map;
+
+/**
+ * Provides read access to cached flag data for a specific evaluation context.
+ * <p>
+ * This interface bridges the persistence layer with FDv2 data source builders,
+ * allowing the cache initializer to load stored flags without depending on
+ * package-private types.
+ */
+public interface CachedFlagStore {
+    /**
+     * Returns the cached flag data for the given context, or null if no
+     * cached data exists.
+     *
+     * @param context the evaluation context to look up
+     * @return the cached flags, or null on cache miss
+     */
+    @Nullable
+    Map<String, DataModel.Flag> getCachedFlags(LDContext context);
+}

launchdarkly-android-client-sdk/src/main/java/com/launchdarkly/sdk/android/subsystems/DataSourceBuildInputs.java

@@ -1,6 +1,7 @@
 package com.launchdarkly.sdk.android.subsystems;
 
 import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 import com.launchdarkly.logging.LDLogger;
 import com.launchdarkly.sdk.LDContext;
@@ -31,6 +32,8 @@ public final class DataSourceBuildInputs {
     private final SelectorSource selectorSource;
     private final ScheduledExecutorService sharedExecutor;
     private final File cacheDir;
+    @Nullable
+    private final CachedFlagStore cachedFlagStore;
     private final LDLogger baseLogger;
 
     /**
@@ -44,6 +47,8 @@ public final class DataSourceBuildInputs {
      * @param sharedExecutor    shared executor for scheduling tasks; owned and shut down by
      *                          the calling data source, so components must not shut it down
      * @param cacheDir          the platform's cache directory for HTTP-level caching
+     * @param cachedFlagStore   read access to cached flag data, or null if no persistent
+     *                          store is configured
      * @param baseLogger        the base logger instance
      */
     public DataSourceBuildInputs(
@@ -54,6 +59,7 @@ public DataSourceBuildInputs(
             SelectorSource selectorSource,
             ScheduledExecutorService sharedExecutor,
             @NonNull File cacheDir,
+            @Nullable CachedFlagStore cachedFlagStore,
             LDLogger baseLogger
     ) {
         this.evaluationContext = evaluationContext;
@@ -63,6 +69,7 @@ public DataSourceBuildInputs(
         this.selectorSource = selectorSource;
         this.sharedExecutor = sharedExecutor;
         this.cacheDir = cacheDir;
+        this.cachedFlagStore = cachedFlagStore;
         this.baseLogger = baseLogger;
     }
 
@@ -133,6 +140,17 @@ public File getCacheDir() {
         return cacheDir;
     }
 
+    /**
+     * Returns read access to cached flag data, or null if no persistent store
+     * is configured. Used by the cache initializer to load stored flags.
+     *
+     * @return the cached flag store, or null
+     */
+    @Nullable
+    public CachedFlagStore getCachedFlagStore() {
+        return cachedFlagStore;
+    }
+
     /**
      * Returns the base logger instance.
      *