Merge branch 'main' into feat/start-stop-session-recording

Author: ioannisj

CHANGELOG.md

@@ -4,6 +4,7 @@
   - `startSessionRecording({bool resumeCurrent = true})` Start session recording, optionally starting a new session
   - `stopSessionRecording()` Stop the current session recording
   - `isSessionReplayActive()` Check if session replay is currently active
+- feat: add `getFeatureFlagResult` API ([#279](https://github.com/PostHog/posthog-flutter/pull/279))
 
 # 5.13.0
 

android/build.gradle

@@ -53,8 +53,8 @@ android {
     dependencies {
         testImplementation 'org.jetbrains.kotlin:kotlin-test'
         testImplementation 'org.mockito:mockito-core:5.0.0'
-        // + Version 3.30.0 and the versions up to 4.0.0, not including 4.0.0 and higher
-        implementation 'com.posthog:posthog-android:[3.30.0,4.0.0]'
+        // + Version 3.31.0 and the versions up to 4.0.0, not including 4.0.0 and higher
+        implementation 'com.posthog:posthog-android:[3.31.0,4.0.0]'
     }
 
     testOptions {

android/src/main/kotlin/com/posthog/flutter/PosthogFlutterPlugin.kt

@@ -146,6 +146,10 @@ class PosthogFlutterPlugin :
                 getFeatureFlagPayload(call, result)
             }
 
+            "getFeatureFlagResult" -> {
+                getFeatureFlagResult(call, result)
+            }
+
             "register" -> {
                 register(call, result)
             }
@@ -387,6 +391,36 @@ class PosthogFlutterPlugin :
         }
     }
 
+    private fun getFeatureFlagResult(
+        call: MethodCall,
+        result: Result,
+    ) {
+        try {
+            val featureFlagKey = call.argument<String>("key")
+            if (featureFlagKey.isNullOrEmpty()) {
+                result.error("PosthogFlutterException", "Missing argument: key", null)
+                return
+            }
+            val sendEvent: Boolean = call.argument("sendEvent") ?: true
+            val flagResult = PostHog.getFeatureFlagResult(featureFlagKey, sendEvent)
+
+            if (flagResult != null) {
+                result.success(
+                    mapOf(
+                        "key" to flagResult.key,
+                        "enabled" to flagResult.enabled,
+                        "variant" to flagResult.variant,
+                        "payload" to flagResult.payload,
+                    ),
+                )
+            } else {
+                result.success(null)
+            }
+        } catch (e: Throwable) {
+            result.error("PosthogFlutterException", e.localizedMessage, null)
+        }
+    }
+
     private fun identify(
         call: MethodCall,
         result: Result,

android/src/test/kotlin/com/posthog/flutter/PosthogFlutterPluginTest.kt

@@ -39,4 +39,19 @@ internal class PosthogFlutterPluginTest {
 
         Mockito.verify(mockResult).success(true)
     }
+
+    @Test
+    fun onMethodCall_getFeatureFlagResult_missingKey_returnsError() {
+        val plugin = PosthogFlutterPlugin()
+
+        val call = MethodCall("getFeatureFlagResult", mapOf<String, Any>())
+        val mockResult: MethodChannel.Result = Mockito.mock(MethodChannel.Result::class.java)
+        plugin.onMethodCall(call, mockResult)
+
+        Mockito.verify(mockResult).error(
+            Mockito.eq("PosthogFlutterException"),
+            Mockito.eq("Missing argument: key"),
+            Mockito.isNull()
+        )
+    }
 }

example/lib/main.dart

@@ -580,6 +580,16 @@ class InitialScreenState extends State<InitialScreen> {
                   },
                   child: const Text("getFeatureFlagPayload"),
                 ),
+                ElevatedButton(
+                  onPressed: () async {
+                    final result = await _posthogFlutterPlugin
+                        .getFeatureFlagResult("feature_name");
+                    setState(() {
+                      _result = result?.toString();
+                    });
+                  },
+                  child: const Text("getFeatureFlagResult"),
+                ),
                 ElevatedButton(
                   onPressed: () async {
                     await _posthogFlutterPlugin.reloadFeatureFlags();

ios/Classes/PosthogFlutterPlugin.swift

@@ -183,6 +183,8 @@ public class PosthogFlutterPlugin: NSObject, FlutterPlugin {
             isFeatureEnabled(call, result: result)
         case "getFeatureFlagPayload":
             getFeatureFlagPayload(call, result: result)
+        case "getFeatureFlagResult":
+            getFeatureFlagResult(call, result: result)
         case "identify":
             identify(call, result: result)
         case "capture":
@@ -557,6 +559,31 @@ extension PosthogFlutterPlugin {
         }
     }
 
+    private func getFeatureFlagResult(
+        _ call: FlutterMethodCall,
+        result: @escaping FlutterResult
+    ) {
+        if let args = call.arguments as? [String: Any],
+           let featureFlagKey = args["key"] as? String
+        {
+            let sendEvent = args["sendEvent"] as? Bool ?? true
+            let flagResult = PostHogSDK.shared.getFeatureFlagResult(featureFlagKey, sendFeatureFlagEvent: sendEvent)
+
+            if let flagResult {
+                result([
+                    "key": flagResult.key,
+                    "enabled": flagResult.enabled,
+                    "variant": flagResult.variant as Any,
+                    "payload": flagResult.payload as Any
+                ])
+            } else {
+                result(nil)
+            }
+        } else {
+            _badArgumentError(result)
+        }
+    }
+
     private func identify(
         _ call: FlutterMethodCall,
         result: @escaping FlutterResult

ios/posthog_flutter.podspec

@@ -21,8 +21,8 @@ Postog flutter plugin
   s.ios.dependency 'Flutter'
   s.osx.dependency 'FlutterMacOS'
 
-  # ~> Version 3.38.0 up to, but not including, 4.0.0
-  s.dependency 'PostHog', '>= 3.38.0', '< 4.0.0'
+  # ~> Version 3.40.0 up to, but not including, 4.0.0
+  s.dependency 'PostHog', '>= 3.40.0', '< 4.0.0'
 
   s.ios.deployment_target = '13.0'
   # PH iOS SDK 3.0.0 requires >= 10.15

lib/posthog_flutter.dart

@@ -1,5 +1,6 @@
 library posthog_flutter;
 
+export 'src/feature_flag_result.dart';
 export 'src/posthog.dart';
 export 'src/posthog_config.dart';
 export 'src/posthog_event.dart';

lib/posthog_flutter_web.dart

@@ -9,6 +9,7 @@ import 'package:posthog_flutter/src/error_tracking/dart_exception_processor.dart
 import 'package:posthog_flutter/src/util/logging.dart';
 import 'package:posthog_flutter/src/utils/property_normalizer.dart';
 
+import 'src/feature_flag_result.dart';
 import 'src/posthog_config.dart';
 import 'src/posthog_flutter_platform_interface.dart';
 import 'src/posthog_flutter_web_handler.dart';
@@ -229,6 +230,18 @@ class PosthogFlutterWeb extends PosthogFlutterPlatformInterface {
         MethodCall('getFeatureFlagPayload', {'key': key}));
   }
 
+  @override
+  Future<PostHogFeatureFlagResult?> getFeatureFlagResult({
+    required String key,
+    bool sendEvent = true,
+  }) async {
+    final result = await handleWebMethodCall(MethodCall(
+        'getFeatureFlagResult', {'key': key, 'sendEvent': sendEvent}));
+
+    // Web SDK returns: { key, enabled, variant, payload }
+    return PostHogFeatureFlagResult.fromMap(result, key);
+  }
+
   @override
   Future<void> flush() async {
     return handleWebMethodCall(const MethodCall('flush'));

lib/src/feature_flag_result.dart

@@ -0,0 +1,61 @@
+/// Represents the result of a feature flag evaluation.
+///
+/// Contains the flag key, whether it's enabled, the variant (for multivariate flags),
+/// and any associated payload.
+class PostHogFeatureFlagResult {
+  /// The feature flag key.
+  final String key;
+
+  /// Whether the flag is enabled.
+  ///
+  /// For boolean flags, this is the flag value.
+  /// For multivariate flags, this is true when the flag evaluates to any variant.
+  final bool enabled;
+
+  /// The variant key for multivariate flags, or null for boolean flags.
+  final String? variant;
+
+  /// The JSON payload associated with the flag, if any.
+  final Object? payload;
+
+  const PostHogFeatureFlagResult({
+    required this.key,
+    required this.enabled,
+    this.variant,
+    this.payload,
+  });
+
+  @override
+  String toString() {
+    return 'PostHogFeatureFlagResult(key: $key, enabled: $enabled, variant: $variant, payload: $payload)';
+  }
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+    return other is PostHogFeatureFlagResult &&
+        other.key == key &&
+        other.enabled == enabled &&
+        other.variant == variant;
+  }
+
+  @override
+  int get hashCode => Object.hash(key, enabled, variant);
+
+  /// Creates a [PostHogFeatureFlagResult] from a native SDK response map.
+  ///
+  /// The [map] should contain: key, enabled, variant, payload.
+  /// Falls back to [fallbackKey] if the map doesn't include a key.
+  /// Returns null if [result] is null or not a Map.
+  static PostHogFeatureFlagResult? fromMap(Object? result, String fallbackKey) {
+    if (result == null) return null;
+    if (result is! Map) return null;
+
+    return PostHogFeatureFlagResult(
+      key: result['key'] as String? ?? fallbackKey,
+      enabled: result['enabled'] as bool? ?? false,
+      variant: result['variant'] as String?,
+      payload: result['payload'],
+    );
+  }
+}