Add loadFeatureFlagsOnStart configuration flag

PostHog/Classes/PHGPostHog.m

@@ -86,7 +86,9 @@ - (instancetype)initWithConfiguration:(PHGPostHogConfiguration *)configuration
         }
 #endif
 
-        [self reloadFeatureFlags];
+        if (configuration.preloadFeatureFlags) {
+            [self reloadFeatureFlags];
+        }
     }
     return self;
 }

PostHog/Classes/PHGPostHogConfiguration.h

@@ -123,6 +123,15 @@ typedef NSMutableURLRequest *_Nonnull (^PHGRequestFactory)(NSURL *_Nonnull);
  */
 @property (nonatomic, assign) BOOL shouldSendDeviceID;
 
+/**
+ * Whether the posthog client should load feature flags when initialized.
+ * Changing the value of this property after initializing the client will have no effect.
+ * If set to `YES` (default), `PHGPosthog` will automatically call `reloadFeatureFlags` during initialization.
+ * If set to `NO`, you can manually call `reloadFeatureFlags` when needed.
+ * The default value is `YES`.
+ */
+@property (nonatomic, assign) BOOL preloadFeatureFlags;
+
 /**
  * Dictionary indicating the options the app was launched with.
  */

PostHog/Classes/PHGPostHogConfiguration.m

@@ -57,6 +57,7 @@ - (instancetype)init
         self.maxQueueSize = 1000;
         self.libraryName = @"posthog-ios";
         self.libraryVersion = [PHGPostHog version];
+        self.preloadFeatureFlags = YES;
         self.payloadFilters = @{
             @"(fb\\d+://authorize#access_token=)([^ ]+)": @"$1((redacted/fb-auth-token))"
         };

PostHogTests/PostHogTests.swift

@@ -15,6 +15,7 @@ class PostHogTests: QuickSpec {
       testApplication = TestApplication()
       config.application = testApplication
       config.captureApplicationLifecycleEvents = true
+      config.preloadFeatureFlags = true
 
       UserDefaults.standard.set("test PHGQueue should be removed", forKey: "PHGQueue")
       expect(UserDefaults.standard.string(forKey: "PHGQueue")).toNot(beNil())
@@ -40,6 +41,19 @@ class PostHogTests: QuickSpec {
       expect(posthog.getAnonymousId()).toNot(beNil())
     }
 
+    it("loads feature flags on init") {
+      expect(testMiddleware.lastContext?.eventType) == .reloadFeatureFlags
+    }
+
+    it("doesn't load feature flags on init when configured") {
+      config.preloadFeatureFlags = false
+      testMiddleware = TestMiddleware()
+      config.middlewares = [testMiddleware]
+
+      posthog = PHGPostHog(configuration: config)
+      expect(testMiddleware.lastContext).to(beNil())
+    }
+
     it("initialized correctly with api host") {
       let config = PHGPostHogConfiguration(apiKey: "QUI5ydwIGeFFTa1IvCBUhxL9PyW5B0jE", host: "https://testapp.posthog.test")
       config.libraryName = "posthog-ios-test"
@@ -83,7 +97,7 @@ class PostHogTests: QuickSpec {
 
     it("fires Application Opened for UIApplicationDidFinishLaunching") {
       testMiddleware.swallowEvent = true
-      NotificationCenter.default.post(name: UIApplication.didFinishLaunchingNotification, object: testApplication, userInfo: [
+      NotificationCenter.default.post(name: NSNotification.Name.UIApplicationDidFinishLaunching, object: testApplication, userInfo: [
         UIApplication.LaunchOptionsKey.sourceApplication: "testApp",
         UIApplication.LaunchOptionsKey.url: "test://test",
       ])
@@ -97,22 +111,22 @@ class PostHogTests: QuickSpec {
 
     it("fires Application Opened during UIApplicationWillEnterForeground") {
       testMiddleware.swallowEvent = true
-      NotificationCenter.default.post(name: UIApplication.willEnterForegroundNotification, object: testApplication)
+      NotificationCenter.default.post(name: NSNotification.Name.UIApplicationWillEnterForeground, object: testApplication)
       let event = testMiddleware.lastContext?.payload as? PHGCapturePayload
       expect(event?.event) == "Application Opened"
       expect(event?.properties?["from_background"] as? Bool) == true
     }
 
     it("fires Application Backgrounded during UIApplicationDidEnterBackground") {
       testMiddleware.swallowEvent = true
-      NotificationCenter.default.post(name: UIApplication.didEnterBackgroundNotification, object: testApplication)
+      NotificationCenter.default.post(name: NSNotification.Name.UIApplicationDidEnterBackground, object: testApplication)
       let event = testMiddleware.lastContext?.payload as? PHGCapturePayload
       expect(event?.event) == "Application Backgrounded"
     }
 
     it("flushes when UIApplicationDidEnterBackground is fired") {
       posthog.capture("test")
-      NotificationCenter.default.post(name: UIApplication.didEnterBackgroundNotification, object: testApplication)
+      NotificationCenter.default.post(name: NSNotification.Name.UIApplicationDidEnterBackground, object: testApplication)
       expect(testApplication.backgroundTasks.count).toEventually(equal(1))
       expect(testApplication.backgroundTasks[0].isEnded).toEventually(beFalse())
     }