posthog-node 5.5.0 → 5.6.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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`
+
 # 5.5.0 – 2025-07-10
 
 1. feat: make the `sendFeatureFlags` parameter more declarative and ergonomic.  Implementation notes below:

package/lib/edge/index.cjs

@@ -937,7 +937,7 @@ function setupExpressErrorHandler(_posthog, app) {
   });
 }
 
-var version = "5.5.0";
+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;
@@ -2232,7 +2228,7 @@ class FeatureFlagsPoller {
         }
       } catch (e) {
         if (e instanceof InconclusiveMatchError) {
-          this.onError?.(new Error(`Unable to compute flag locally: ${flag.key} - ${e.message}`));
+          this.logMsgIfDebug(() => console.debug(`InconclusiveMatchError when computing flag locally: ${flag.key}: ${e}`));
         } else if (e instanceof Error) {
           this.onError?.(new Error(`Error computing flag locally: ${flag.key}: ${e}`));
         }
@@ -2329,6 +2325,9 @@ class FeatureFlagsPoller {
         let matches = false;
         if (propertyType === 'cohort') {
           matches = matchCohort(prop, properties, this.cohorts, this.debugMode);
+        } else if (propertyType === 'flag') {
+          this.logMsgIfDebug(() => console.warn(`[FEATURE FLAGS] Flag dependency filters are not supported in local evaluation. ` + `Skipping condition for flag '${flag.key}' with dependency on flag '${prop.key || 'unknown'}'`));
+          continue;
         } else {
           matches = matchProperty(prop, properties, warnFunction);
         }
@@ -2666,6 +2665,11 @@ function matchPropertyGroup(propertyGroup, propertyValues, cohortProperties, deb
         let matches;
         if (prop.type === 'cohort') {
           matches = matchCohort(prop, propertyValues, cohortProperties, debugMode);
+        } else if (prop.type === 'flag') {
+          if (debugMode) {
+            console.warn(`[FEATURE FLAGS] Flag dependency filters are not supported in local evaluation. ` + `Skipping condition with dependency on flag '${prop.key || 'unknown'}'`);
+          }
+          continue;
         } else {
           matches = matchProperty(prop, propertyValues);
         }
@@ -3167,7 +3171,8 @@ class PostHogBackendClient extends PostHogCoreStateless {
   async getAllFlagsAndPayloads(distinctId, options) {
     const {
       groups,
-      disableGeoip
+      disableGeoip,
+      flagKeys
     } = options || {};
     let {
       onlyEvaluateLocally,
@@ -3181,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;
@@ -3191,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 || {})
@@ -3291,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
@@ -3305,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
@@ -3323,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