feat(SDK-554): expose IterableConfig.enableForegroundCriteriaFetch

CHANGELOG.md

@@ -1,3 +1,9 @@
+## Unreleased
+
+### Updates
+
+- Added `IterableConfig.enableForegroundCriteriaFetch` (default `true`) to control whether the SDK fetches unknown-user targeting criteria when the app enters the foreground (SDK-554).
+
 ## 3.2.1
 
 ### Fixes

android/src/main/java/com/iterable/reactnative/Serialization.java

@@ -246,6 +246,10 @@ static IterableConfig.Builder getConfigFromReadableMap(ReadableMap iterableConte
                 configBuilder.setDataRegion(iterableDataRegion);
             }
 
+            if (iterableContextJSON.has("enableForegroundCriteriaFetch")) {
+                configBuilder.setEnableForegroundCriteriaFetch(iterableContextJSON.optBoolean("enableForegroundCriteriaFetch"));
+            }
+
             if (iterableContextJSON.has("enableEmbeddedMessaging")) {
                 configBuilder.setEnableEmbeddedMessaging(iterableContextJSON.optBoolean("enableEmbeddedMessaging"));
             }

ios/RNIterableAPI/Serialization.swift

@@ -83,6 +83,10 @@ extension IterableConfig {
       config.useInMemoryStorageForInApps = useInMemoryStorageForInApp
     }
 
+    if let enableForegroundCriteriaFetch = dict["enableForegroundCriteriaFetch"] as? Bool {
+      config.enableForegroundCriteriaFetch = enableForegroundCriteriaFetch
+    }
+
     if let enableEmbeddedMessaging = dict["enableEmbeddedMessaging"] as? Bool {
       config.enableEmbeddedMessaging = enableEmbeddedMessaging
     }

src/core/classes/Iterable.test.ts

@@ -325,6 +325,7 @@ describe('Iterable', () => {
       expect(config.checkForDeferredDeeplink).toBe(false);
       expect(config.customActionHandler).toBe(undefined);
       expect(config.dataRegion).toBe(IterableDataRegion.US);
+      expect(config.enableForegroundCriteriaFetch).toBe(true);
       expect(config.enableEmbeddedMessaging).toBe(false);
       expect(config.encryptionEnforced).toBe(false);
       expect(config.expiringAuthTokenRefreshPeriod).toBe(60.0);
@@ -344,6 +345,7 @@ describe('Iterable', () => {
       expect(configDict.autoPushRegistration).toBe(true);
       expect(configDict.customActionHandlerPresent).toBe(false);
       expect(configDict.dataRegion).toBe(IterableDataRegion.US);
+      expect(configDict.enableForegroundCriteriaFetch).toBe(true);
       expect(configDict.enableEmbeddedMessaging).toBe(false);
       expect(configDict.encryptionEnforced).toBe(false);
       expect(configDict.expiringAuthTokenRefreshPeriod).toBe(60.0);
@@ -365,6 +367,13 @@ describe('Iterable', () => {
       expect(configDict.androidWakeDelayMs).toBe(1500);
       expect(configDict.authCallbackTimeoutMs).toBe(2500);
     });
+
+    it('should include enableForegroundCriteriaFetch in toDict() when set to false', () => {
+      const config = new IterableConfig();
+      config.enableForegroundCriteriaFetch = false;
+      const configDict = config.toDict();
+      expect(configDict.enableForegroundCriteriaFetch).toBe(false);
+    });
   });
 
   describe('urlHandler', () => {

src/core/classes/IterableConfig.ts

@@ -391,6 +391,14 @@ export class IterableConfig {
    */
   authCallbackTimeoutMs = 6000;
 
+  /**
+   * When `true` (the default), the SDK fetches unknown-user (anonymous) targeting
+   * criteria when the app enters the foreground.
+   *
+   * Set to `false` to disable that foreground fetch.
+   */
+  enableForegroundCriteriaFetch = true;
+
   /**
    * Should the SDK enable and use embedded messaging?
    *
@@ -484,6 +492,7 @@ export class IterableConfig {
       pushPlatform: this.pushPlatform,
       encryptionEnforced: this.encryptionEnforced,
       retryPolicy: this.retryPolicy,
+      enableForegroundCriteriaFetch: this.enableForegroundCriteriaFetch,
       enableEmbeddedMessaging: this.enableEmbeddedMessaging,
       androidWakeDelayMs: this.androidWakeDelayMs,
       authCallbackTimeoutMs: this.authCallbackTimeoutMs,