Merge pull request #342 from Countly/refresh_content_zone

Refresh content zone

Author: turtledreams

CHANGELOG.md

@@ -1,5 +1,6 @@
 ## XX.XX.XX
 * Extended server configuration capabilities of the SDK.
+* Added a Content feature method "refreshContentZone" that does a manual refresh.
 
 ## 25.1.1
 * Removed Android v1 embedding support

android/src/main/java/ly/count/dart/countly_flutter/CountlyFlutterPlugin.java

@@ -1410,6 +1410,9 @@ else if ("getRequestQueue".equals(call.method)) {
             } else if ("exitContentZone".equals(call.method)) {
                 Countly.sharedInstance().contents().exitContentZone();
                 result.success(null);
+            } else if ("refreshContentZone".equals(call.method)) {
+                Countly.sharedInstance().contents().refreshContentZone();
+                result.success(null);
             }
             //------------------End------------------------------------
 

ios/Classes/CountlyFlutterPlugin.m

@@ -1373,16 +1373,17 @@ - (void)handleMethodCall:(FlutterMethodCall *)call result:(FlutterResult)result
             [Countly.sharedInstance.content enterContentZone];
             result(nil);
         });
-
-        // setRequiresConsent
     } else if ([@"exitContentZone" isEqualToString:call.method]) {
         dispatch_async(dispatch_get_main_queue(), ^{
             [Countly.sharedInstance.content exitContentZone];
             result(nil);
         });
-
-        // setRequiresConsent
-    } else {
+    }  else if ([@"refreshContentZone" isEqualToString:call.method]) {
+        dispatch_async(dispatch_get_main_queue(), ^{
+            [Countly.sharedInstance.content refreshContentZone];
+            result(nil);
+        });
+    }  else {
         result(FlutterMethodNotImplemented);
     }
 }

lib/src/content_builder.dart

@@ -4,11 +4,18 @@ enum ContentStatus { completed, closed}
 typedef ContentCallback = void Function(ContentStatus contentStatus, Map<String, dynamic> contentData);
 
 abstract class ContentBuilder {
-  /// This is an experimental feature and it can have breaking changes
-  //  Opt in user for the content fetching and updates
+  /// Enables content fetching and updates for the user.
+  /// This method opts the user into receiving content updates
+  /// and ensures that relevant data is fetched accordingly.
   Future<void>  enterContentZone();
 
-  /// This is an experimental feature and it can have breaking changes
-  //  Opt out user for the content fetching and updates
+  /// Disables content fetching and updates for the user.
+  /// This method opts the user out of receiving content updates
+  /// and stops any ongoing content retrieval processes.
   Future<void>  exitContentZone();
+
+  /// Triggers a manual refresh of the content zone.
+  /// This method forces an update by fetching the latest content,
+  /// ensuring the user receives the most up-to-date information.
+  Future<void>  refreshContentZone();
 }

lib/src/content_builder_internal.dart

@@ -28,6 +28,16 @@ class ContentBuilderInternal implements ContentBuilder {
     await _countlyState.channel.invokeMethod('exitContentZone');
   }
 
+  @override
+  Future<void> refreshContentZone() async {
+    if (!_countlyState.isInitialized) {
+      Countly.log('refreshContentZone, "initWithConfig" must be called before "clear"', logLevel: LogLevel.ERROR);
+      return;
+    }
+    Countly.log('Calling "refreshContentZone"');
+    await _countlyState.channel.invokeMethod('refreshContentZone');
+  }
+
   void registerContentCallback(ContentCallback callback) {
     _contentCallback = callback;
   }