feat: expose invalidateRemoteConfigsCache, bump sandwich to 7.12.0 (DEV-1236)

android/build.gradle

@@ -80,7 +80,7 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation "io.qonversion:sandwich:7.11.0"
+  implementation "io.qonversion:sandwich:7.12.0"
 }
 
 if (isNewArchitectureEnabled()) {

android/src/main/java/com/qonversion/reactnativesdk/QonversionModule.kt

@@ -246,6 +246,11 @@ class QonversionModule(reactContext: ReactApplicationContext) : NativeQonversion
         )
     }
 
+    @ReactMethod
+    override fun invalidateRemoteConfigsCache() {
+        qonversionSandwich.invalidateRemoteConfigsCache()
+    }
+
     @ReactMethod
     override fun attachUserToExperiment(experimentId: String, groupId: String, promise: Promise) {
         qonversionSandwich.attachUserToExperiment(experimentId, groupId, getResultListener(promise))

ios/RNQonversion.mm

@@ -258,6 +258,14 @@ - (void)remoteConfigListForContextKeys:(NSArray<NSString *> *)contextKeys includ
     }
 }
 
+- (void)invalidateRemoteConfigsCache {
+    @try {
+        [self.impl invalidateRemoteConfigsCache];
+    } @catch (NSException *exception) {
+        QNR_LOG_EXCEPTION("invalidateRemoteConfigsCache", exception);
+    }
+}
+
 - (void)attachUserToExperiment:(NSString *)experimentId groupId:(NSString *)groupId resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
     @try {
         [self.impl attachUserToExperiment:experimentId groupId:groupId resolve:resolve reject:reject];

ios/RNQonversionImpl.swift

@@ -196,6 +196,11 @@ public class RNQonversionImpl: NSObject {
     }
   }
 
+  @objc
+  public func invalidateRemoteConfigsCache() {
+    qonversionSandwich?.invalidateRemoteConfigsCache()
+  }
+
   @objc
   public func attachUserToExperiment(_ experimentId: String, groupId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
     qonversionSandwich?.attachUserToExperiment(with: experimentId, groupId: groupId) { result, error in

qonversion-react-native-sdk.podspec

@@ -16,6 +16,6 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
   s.private_header_files = "ios/**/*.h"
 
-  s.dependency "QonversionSandwich", "7.11.0"
+  s.dependency "QonversionSandwich", "7.12.0"
   install_modules_dependencies(s)
 end

src/QonversionApi.ts

@@ -324,6 +324,31 @@ export interface QonversionApi {
    */
   remoteConfigListForContextKeys(contextKeys: string[], includeEmptyContextKey: boolean): Promise<RemoteConfigList>
 
+  /**
+   * Invalidates the cache of remote configs so the next {@link remoteConfig} or
+   * {@link remoteConfigList} call fetches a fresh targeting evaluation from the
+   * server instead of returning the cached copy.
+   *
+   * This method performs no network request itself — it only marks the cached
+   * values as stale. An in-flight remoteConfig load is re-issued once so its
+   * waiting calls receive a fresh evaluation; an in-flight remoteConfigList
+   * completes with the evaluation it started with.
+   *
+   * Call it when the targeting inputs changed and you need the change reflected
+   * immediately, for example after setting a batch of user properties your
+   * remote config targeting depends on. You do NOT need to call it after
+   * {@link identify} — the SDK invalidates the cache on identity changes
+   * automatically.
+   *
+   * If the re-issued load fails, the previously received evaluation is
+   * delivered instead of an error — the call never degrades below the
+   * pre-invalidation result.
+   *
+   * Call it after {@link Qonversion.initialize}: calling before initialization
+   * throws on Android and does nothing on iOS.
+   */
+  invalidateRemoteConfigsCache(): void;
+
   /**
    * This function should be used for the test purposes only. Do not forget to delete the usage of this function before the release.
    * Use this function to attach the user to the experiment.

src/internal/QonversionInternal.ts

@@ -376,6 +376,10 @@ export default class QonversionInternal implements QonversionApi {
     return mappedRemoteConfigList;
   }
 
+  invalidateRemoteConfigsCache() {
+    RNQonversion.invalidateRemoteConfigsCache();
+  }
+
   async attachUserToExperiment(experimentId: string, groupId: string): Promise<void> {
     await RNQonversion.attachUserToExperiment(experimentId, groupId);
     return;

src/internal/__tests__/QonversionInternal.test.ts

@@ -25,6 +25,7 @@ jest.mock('../specs/NativeQonversionModule', () => ({
     }),
     onPromoPurchaseReceived: jest.fn(),
     purchaseWithResult: jest.fn(),
+    invalidateRemoteConfigsCache: jest.fn(),
   },
 }));
 
@@ -252,3 +253,13 @@ describe('QonversionInternal - setDeferredPurchasesListener replaces wrapped ent
     expect(RNQonversion.onDeferredPurchaseCompleted).toHaveBeenCalledTimes(1);
   });
 });
+
+describe('invalidateRemoteConfigsCache', () => {
+  it('passes the call straight through to the native module', () => {
+    const instance = new QonversionInternal(createConfig());
+
+    instance.invalidateRemoteConfigsCache();
+
+    expect(RNQonversion.invalidateRemoteConfigsCache).toHaveBeenCalledTimes(1);
+  });
+});

src/internal/specs/NativeQonversionModule.ts

@@ -73,6 +73,7 @@ export interface Spec extends TurboModule {
   remoteConfig(contextKey: string | undefined): Promise<QRemoteConfig>;
   remoteConfigList(): Promise<QRemoteConfigList>;
   remoteConfigListForContextKeys(contextKeys: string[], includeEmptyContextKey: boolean): Promise<QRemoteConfigList>;
+  invalidateRemoteConfigsCache(): void;
   attachUserToExperiment(experimentId: string, groupId: string): Promise<void>;
   detachUserFromExperiment(experimentId: string): Promise<void>;
   attachUserToRemoteConfiguration(remoteConfigurationId: string): Promise<void>;