posthog-node 5.5.1 → 5.6.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Next
 
+# 5.6.0 – 2025-07-15
+
+1. Added support for filtering feature flags with flagKeys parameter in sendFeatureFlags options
+
 # 5.5.1 – 2025-07-15
 
 1. wrap `InconclusiveMatchError`s in `logMsgIfDebug` for local flag evaluations on `sendFeatureFlags`

package/lib/edge/index.cjs

@@ -937,7 +937,7 @@ function setupExpressErrorHandler(_posthog, app) {
   });
 }
 
-var version = "5.5.1";
+var version = "5.6.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -2176,12 +2176,7 @@ class FeatureFlagsPoller {
     if (!this.loadedSuccessfullyOnce) {
       return response;
     }
-    for (const flag of this.featureFlags) {
-      if (key === flag.key) {
-        featureFlag = flag;
-        break;
-      }
-    }
+    featureFlag = this.featureFlagsByKey[key];
     if (featureFlag !== undefined) {
       try {
         response = await this.computeFlagLocally(featureFlag, distinctId, groups, personProperties, groupProperties);
@@ -2217,12 +2212,13 @@ class FeatureFlagsPoller {
       return response;
     }
   }
-  async getAllFlagsAndPayloads(distinctId, groups = {}, personProperties = {}, groupProperties = {}) {
+  async getAllFlagsAndPayloads(distinctId, groups = {}, personProperties = {}, groupProperties = {}, flagKeysToExplicitlyEvaluate) {
     await this.loadFeatureFlags();
     const response = {};
     const payloads = {};
     let fallbackToFlags = this.featureFlags.length == 0;
-    await Promise.all(this.featureFlags.map(async flag => {
+    const flagsToEvaluate = flagKeysToExplicitlyEvaluate ? flagKeysToExplicitlyEvaluate.map(key => this.featureFlagsByKey[key]).filter(Boolean) : this.featureFlags;
+    await Promise.all(flagsToEvaluate.map(async flag => {
       try {
         const matchValue = await this.computeFlagLocally(flag, distinctId, groups, personProperties, groupProperties);
         response[flag.key] = matchValue;
@@ -3175,7 +3171,8 @@ class PostHogBackendClient extends PostHogCoreStateless {
   async getAllFlagsAndPayloads(distinctId, options) {
     const {
       groups,
-      disableGeoip
+      disableGeoip,
+      flagKeys
     } = options || {};
     let {
       onlyEvaluateLocally,
@@ -3189,7 +3186,7 @@ class PostHogBackendClient extends PostHogCoreStateless {
     if (onlyEvaluateLocally == undefined) {
       onlyEvaluateLocally = false;
     }
-    const localEvaluationResult = await this.featureFlagsPoller?.getAllFlagsAndPayloads(distinctId, groups, personProperties, groupProperties);
+    const localEvaluationResult = await this.featureFlagsPoller?.getAllFlagsAndPayloads(distinctId, groups, personProperties, groupProperties, flagKeys);
     let featureFlags = {};
     let featureFlagPayloads = {};
     let fallbackToFlags = true;
@@ -3199,7 +3196,7 @@ class PostHogBackendClient extends PostHogCoreStateless {
       fallbackToFlags = localEvaluationResult.fallbackToFlags;
     }
     if (fallbackToFlags && !onlyEvaluateLocally) {
-      const remoteEvaluationResult = await super.getFeatureFlagsAndPayloadsStateless(distinctId, groups, personProperties, groupProperties, disableGeoip);
+      const remoteEvaluationResult = await super.getFeatureFlagsAndPayloadsStateless(distinctId, groups, personProperties, groupProperties, disableGeoip, flagKeys);
       featureFlags = {
         ...featureFlags,
         ...(remoteEvaluationResult.flags || {})
@@ -3299,6 +3296,7 @@ class PostHogBackendClient extends PostHogCoreStateless {
     // Use properties directly from options if they exist
     const finalPersonProperties = sendFeatureFlagsOptions?.personProperties || {};
     const finalGroupProperties = sendFeatureFlagsOptions?.groupProperties || {};
+    const flagKeys = sendFeatureFlagsOptions?.flagKeys;
     // Check if we should only evaluate locally
     const onlyEvaluateLocally = sendFeatureFlagsOptions?.onlyEvaluateLocally ?? false;
     // If onlyEvaluateLocally is true, only use local evaluation
@@ -3313,7 +3311,8 @@ class PostHogBackendClient extends PostHogCoreStateless {
           personProperties: finalPersonProperties,
           groupProperties: finalGroupProperties,
           disableGeoip,
-          onlyEvaluateLocally: true
+          onlyEvaluateLocally: true,
+          flagKeys
         });
       } else {
         // If onlyEvaluateLocally is true but we don't have local flags, return empty
@@ -3331,7 +3330,8 @@ class PostHogBackendClient extends PostHogCoreStateless {
         personProperties: finalPersonProperties,
         groupProperties: finalGroupProperties,
         disableGeoip,
-        onlyEvaluateLocally: true
+        onlyEvaluateLocally: true,
+        flagKeys
       });
     }
     // Fall back to remote evaluation if local evaluation is not available