posthog-node 5.5.1 → 5.6.0

package/lib/index.d.ts

@@ -592,6 +592,7 @@ interface SendFeatureFlagsOptions {
     onlyEvaluateLocally?: boolean;
     personProperties?: Record<string, any>;
     groupProperties?: Record<string, Record<string, any>>;
+    flagKeys?: string[];
 }
 interface EventMessage extends IdentifyMessage {
     event: string;
@@ -901,6 +902,7 @@ declare abstract class PostHogBackendClient extends PostHogCoreStateless impleme
         groupProperties?: Record<string, Record<string, string>>;
         onlyEvaluateLocally?: boolean;
         disableGeoip?: boolean;
+        flagKeys?: string[];
     }): Promise<Record<string, FeatureFlagValue>>;
     getAllFlagsAndPayloads(distinctId: string, options?: {
         groups?: Record<string, string>;
@@ -908,6 +910,7 @@ declare abstract class PostHogBackendClient extends PostHogCoreStateless impleme
         groupProperties?: Record<string, Record<string, string>>;
         onlyEvaluateLocally?: boolean;
         disableGeoip?: boolean;
+        flagKeys?: string[];
     }): Promise<PostHogFlagsAndPayloadsResponse>;
     groupIdentify({ groupType, groupKey, properties, distinctId, disableGeoip }: GroupIdentifyMessage): void;
     /**

package/lib/node/index.cjs

@@ -1342,7 +1342,7 @@ function snipLine(line, colno) {
   return newLine;
 }
 
-var version = "5.5.1";
+var version = "5.6.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -2581,12 +2581,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);
@@ -2622,12 +2617,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;
@@ -3580,7 +3576,8 @@ class PostHogBackendClient extends PostHogCoreStateless {
   async getAllFlagsAndPayloads(distinctId, options) {
     const {
       groups,
-      disableGeoip
+      disableGeoip,
+      flagKeys
     } = options || {};
     let {
       onlyEvaluateLocally,
@@ -3594,7 +3591,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;
@@ -3604,7 +3601,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 || {})
@@ -3704,6 +3701,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
@@ -3718,7 +3716,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
@@ -3736,7 +3735,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