preserve initial flags configuration API

Author: sameerank

packages/browser/src/domain/configuration.ts

@@ -14,6 +14,11 @@ export interface FlaggingInitConfiguration extends InitConfiguration {
    */
   applicationId?: string
 
+  /**
+   * Initial flags configuration (precomputed flags)
+   */
+  initialFlagsConfiguration?: FlagsConfiguration
+
   /**
    * RUM integration options
    * @deprecated Use enableExposureLogging instead. RUM-based exposure tracking will be removed in a future version.

packages/browser/src/openfeature/provider.ts

@@ -133,6 +133,7 @@ export class DatadogProvider extends DatadogCoreProvider {
       this.flagsCache = new IndexedDBFlagsCache(options.clientToken)
     }
 
+    this.flagsConfiguration = options.initialFlagsConfiguration || {}
     this.status = ProviderStatus.NOT_READY
   }
 

packages/browser/test/openfeature/provider-persistence.spec.ts

@@ -88,6 +88,25 @@ describe('DatadogProvider IndexedDB persistence', () => {
   })
 
   describe('falls back to cached flags on network failure', () => {
+    it('should preserve initialFlagsConfiguration as an in-memory fallback', async () => {
+      const context = { targetingKey: 'initial-user' }
+      const initialFlagsConfiguration: FlagsConfiguration = {
+        precomputed: {
+          response: precomputedResponse as any,
+          context,
+          fetchedAt: 1731939819456 as TimeStamp,
+        },
+      }
+      global.fetch = failingFetchMock()
+      const provider = new DatadogProvider({ ...options, initialFlagsConfiguration })
+
+      await provider.initialize(context)
+
+      expect(provider.status).toBe(ProviderStatus.STALE)
+      const mockLogger = { debug: jest.fn(), info: jest.fn(), warn: jest.fn(), error: jest.fn() }
+      expect(provider.resolveStringEvaluation('string-flag', 'default', {}, mockLogger).value).toBe('red')
+    })
+
     it('should use IndexedDB cache and enter STALE state when network fails', async () => {
       // First: seed IndexedDB with a known config
       const context = { targetingKey: 'cached-user' }