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

QonversionCapacitorPlugin.podspec

@@ -14,5 +14,5 @@ Pod::Spec.new do |s|
   s.ios.deployment_target  = '14.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'
-  s.dependency "QonversionSandwich", "7.11.0"
+  s.dependency "QonversionSandwich", "7.12.0"
 end

android/build.gradle

@@ -61,7 +61,7 @@ dependencies {
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation 'androidx.core:core-ktx:1.13.1'
-    implementation "io.qonversion:sandwich:7.11.0"
+    implementation "io.qonversion:sandwich:7.12.0"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

android/src/main/java/io/qonversion/capacitor/QonversionPlugin.kt

@@ -142,6 +142,12 @@ class QonversionPlugin : Plugin() {
         }
     }
 
+    @PluginMethod
+    fun invalidateRemoteConfigsCache(call: PluginCall) {
+        qonversionSandwich.invalidateRemoteConfigsCache()
+        call.resolve()
+    }
+
     @PluginMethod
     fun syncHistoricalData(call: PluginCall) {
         qonversionSandwich.syncHistoricalData()

ios/Sources/QonversionPlugin/QonversionPlugin.swift

@@ -17,6 +17,7 @@ public class QonversionPlugin: CAPPlugin, CAPBridgedPlugin {
     CAPPluginMethod(name: "checkEntitlements", returnType: CAPPluginReturnPromise),
     CAPPluginMethod(name: "remoteConfig", returnType: CAPPluginReturnPromise),
     CAPPluginMethod(name: "remoteConfigList", returnType: CAPPluginReturnPromise),
+    CAPPluginMethod(name: "invalidateRemoteConfigsCache", returnType: CAPPluginReturnPromise),
     CAPPluginMethod(name: "userInfo", returnType: CAPPluginReturnPromise),
     CAPPluginMethod(name: "userProperties", returnType: CAPPluginReturnPromise),
     CAPPluginMethod(name: "forceSendProperties", returnType: CAPPluginReturnPromise),
@@ -244,6 +245,11 @@ public class QonversionPlugin: CAPPlugin, CAPBridgedPlugin {
     call.resolve()
   }
 
+  @objc func invalidateRemoteConfigsCache(_ call: CAPPluginCall) {
+    qonversionSandwich?.invalidateRemoteConfigsCache()
+    call.resolve()
+  }
+
   @objc func syncHistoricalData(_ call: CAPPluginCall) {
     qonversionSandwich?.syncHistoricalData()
     call.resolve()

src/QonversionApi.ts

@@ -161,6 +161,31 @@ export interface QonversionApi {
    */
   remoteConfigListForContextKeys(contextKeys: Array<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/QonversionNativePlugin.ts

@@ -62,6 +62,8 @@ export interface QonversionNativePlugin {
 
   remoteConfigList(params?: {contextKeys: string[], includeEmptyContextKey: boolean}): Promise<QRemoteConfigList>;
 
+  invalidateRemoteConfigsCache(): void;
+
   attachUserToExperiment(params: {experimentId: string, groupId: string}): Promise<void>;
 
   detachUserFromExperiment(params: {experimentId: string}): Promise<void>;

src/internal/QonversionInternal.ts

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

src/internal/web.ts

@@ -116,6 +116,10 @@ export class QonversionWeb extends WebPlugin implements QonversionNativePlugin {
         throw this.unimplemented("not implemented yet");
     }
 
+    invalidateRemoteConfigsCache(): void {
+        throw this.unimplemented("not implemented yet");
+    }
+
     restore(): Promise<Record<string, QEntitlement> | null | undefined> {
         throw this.unimplemented("not implemented yet");
     }