posthog-node 3.4.0 → 3.6.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+# 3.6.0 - 2024-01-18
+
+1. Adds support for overriding the event `uuid`
+
+# 3.5.0 - 2024-01-09
+
+1. When local evaluation is enabled, we automatically add flag information to all events sent to PostHog, whenever possible. This makes it easier to use these events in experiments.
+2. Fixes a bug where in some rare cases we may drop events when send_feature_flags is enabled on capture.
+
 # 3.4.0 - 2024-01-09
 
 1. Numeric property handling for feature flags now does the expected: When passed in a number, we do a numeric comparison. When passed in a string, we do a string comparison. Previously, we always did a string comparison.

package/lib/index.cjs.js

@@ -158,7 +158,7 @@ function __spreadArray(to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 }
 
-var version = "3.4.0";
+var version = "3.6.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -751,8 +751,8 @@ var PostHogCoreStateless = /** @class */ (function () {
     function PostHogCoreStateless(apiKey, options) {
         var _a, _b, _c, _d, _e;
         this.debugMode = false;
-        this.pendingPromises = {};
         this.disableGeoip = true;
+        this.pendingPromises = {};
         // internal
         this._events = new SimpleEventEmitter();
         assert(apiKey, "You must pass your PostHog project's api key.");
@@ -810,6 +810,14 @@ var PostHogCoreStateless = /** @class */ (function () {
             properties: __assign(__assign({}, (payload.properties || {})), this.getCommonEventProperties()),
         };
     };
+    PostHogCoreStateless.prototype.addPendingPromise = function (promise) {
+        var _this = this;
+        var promiseUUID = generateUUID();
+        this.pendingPromises[promiseUUID] = promise;
+        promise.finally(function () {
+            delete _this.pendingPromises[promiseUUID];
+        });
+    };
     /***
      *** TRACKING
      ***/
@@ -860,6 +868,7 @@ var PostHogCoreStateless = /** @class */ (function () {
         if (extraPayload === void 0) { extraPayload = {}; }
         return __awaiter(this, void 0, void 0, function () {
             var url, fetchOptions;
+            var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.host, "/decide/?v=3");
                 fetchOptions = {
@@ -870,7 +879,7 @@ var PostHogCoreStateless = /** @class */ (function () {
                 return [2 /*return*/, this.fetchWithRetry(url, fetchOptions)
                         .then(function (response) { return response.json(); })
                         .catch(function (error) {
-                        console.error('Error fetching feature flags', error);
+                        _this._events.emit('error', error);
                         return undefined;
                     })];
             });
@@ -1007,7 +1016,7 @@ var PostHogCoreStateless = /** @class */ (function () {
             this._events.emit(type, "Library is disabled. Not sending event. To re-enable, call posthog.optIn()");
             return;
         }
-        var message = __assign(__assign({}, _message), { type: type, library: this.getLibraryId(), library_version: this.getLibraryVersion(), timestamp: (options === null || options === void 0 ? void 0 : options.timestamp) ? options === null || options === void 0 ? void 0 : options.timestamp : currentISOTime() });
+        var message = __assign(__assign({}, _message), { type: type, library: this.getLibraryId(), library_version: this.getLibraryVersion(), timestamp: (options === null || options === void 0 ? void 0 : options.timestamp) ? options === null || options === void 0 ? void 0 : options.timestamp : currentISOTime(), uuid: (options === null || options === void 0 ? void 0 : options.uuid) ? options.uuid : generateUUID(globalThis) });
         var addGeoipDisableProperty = (_a = options === null || options === void 0 ? void 0 : options.disableGeoip) !== null && _a !== void 0 ? _a : this.disableGeoip;
         if (addGeoipDisableProperty) {
             if (!message.properties) {
@@ -1057,14 +1066,11 @@ var PostHogCoreStateless = /** @class */ (function () {
             batch: messages,
             sent_at: currentISOTime(),
         };
-        var promiseUUID = generateUUID();
         var done = function (err) {
             if (err) {
                 _this._events.emit('error', err);
             }
             callback === null || callback === void 0 ? void 0 : callback(err, messages);
-            // remove promise from pendingPromises
-            delete _this.pendingPromises[promiseUUID];
             _this._events.emit('flush', messages);
         };
         // Don't set the user agent if we're not on a browser. The latest spec allows
@@ -1090,12 +1096,11 @@ var PostHogCoreStateless = /** @class */ (function () {
                 body: payload,
             };
         var requestPromise = this.fetchWithRetry(url, fetchOptions);
-        this.pendingPromises[promiseUUID] = requestPromise;
-        requestPromise
+        this.addPendingPromise(requestPromise
             .then(function () { return done(); })
             .catch(function (err) {
             done(err);
-        });
+        }));
     };
     PostHogCoreStateless.prototype.fetchWithRetry = function (url, options, retryOptions) {
         var _a;
@@ -1149,7 +1154,7 @@ var PostHogCoreStateless = /** @class */ (function () {
                         clearTimeout(this._flushTimer);
                         _a.label = 1;
                     case 1:
-                        _a.trys.push([1, 4, , 5]);
+                        _a.trys.push([1, 5, , 6]);
                         return [4 /*yield*/, this.flushAsync()];
                     case 2:
                         _a.sent();
@@ -1157,18 +1162,31 @@ var PostHogCoreStateless = /** @class */ (function () {
                                 return x.catch(function () {
                                     // ignore errors as we are shutting down and can't deal with them anyways.
                                 });
-                            }))];
+                            }))
+                            // flush again to make sure we send all events, some of which might've been added
+                            // while we were waiting for the pending promises to resolve
+                            // For example, see sendFeatureFlags in posthog-node/src/posthog-node.ts::capture
+                        ];
                     case 3:
                         _a.sent();
-                        return [3 /*break*/, 5];
+                        // flush again to make sure we send all events, some of which might've been added
+                        // while we were waiting for the pending promises to resolve
+                        // For example, see sendFeatureFlags in posthog-node/src/posthog-node.ts::capture
+                        return [4 /*yield*/, this.flushAsync()];
                     case 4:
+                        // flush again to make sure we send all events, some of which might've been added
+                        // while we were waiting for the pending promises to resolve
+                        // For example, see sendFeatureFlags in posthog-node/src/posthog-node.ts::capture
+                        _a.sent();
+                        return [3 /*break*/, 6];
+                    case 5:
                         e_2 = _a.sent();
                         if (!isPostHogFetchError(e_2)) {
                             throw e_2;
                         }
                         console.error('Error while shutting down PostHog', e_2);
-                        return [3 /*break*/, 5];
-                    case 5: return [2 /*return*/];
+                        return [3 /*break*/, 6];
+                    case 6: return [2 /*return*/];
                 }
             });
         });
@@ -1760,6 +1778,8 @@ function () {
   };
 
   FeatureFlagsPoller.prototype.getFeatureFlag = function (key, distinctId, groups, personProperties, groupProperties) {
+    var _a;
+
     if (groups === void 0) {
       groups = {};
     }
@@ -1773,17 +1793,17 @@ function () {
     }
 
     return __awaiter(this, void 0, void 0, function () {
-      var response, featureFlag, _i, _a, flag;
+      var response, featureFlag, _i, _b, flag;
 
-      return __generator(this, function (_b) {
-        switch (_b.label) {
+      return __generator(this, function (_c) {
+        switch (_c.label) {
           case 0:
             return [4
             /*yield*/
             , this.loadFeatureFlags()];
 
           case 1:
-            _b.sent();
+            _c.sent();
 
             response = undefined;
             featureFlag = undefined;
@@ -1794,8 +1814,8 @@ function () {
               , response];
             }
 
-            for (_i = 0, _a = this.featureFlags; _i < _a.length; _i++) {
-              flag = _a[_i];
+            for (_i = 0, _b = this.featureFlags; _i < _b.length; _i++) {
+              flag = _b[_i];
 
               if (key === flag.key) {
                 featureFlag = flag;
@@ -1816,7 +1836,7 @@ function () {
                     console.debug("InconclusiveMatchError when computing flag locally: ".concat(key, ": ").concat(e));
                   }
                 } else if (e instanceof Error) {
-                  console.error("Error computing flag locally: ".concat(key, ": ").concat(e));
+                  (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, new Error("Error computing flag locally: ".concat(key, ": ").concat(e)));
                 }
               }
             }
@@ -1992,12 +2012,18 @@ function () {
       var groupName = this.groupTypeMapping[String(aggregation_group_type_index)];
 
       if (!groupName) {
-        console.warn("[FEATURE FLAGS] Unknown group type index ".concat(aggregation_group_type_index, " for feature flag ").concat(flag.key));
+        if (this.debugMode) {
+          console.warn("[FEATURE FLAGS] Unknown group type index ".concat(aggregation_group_type_index, " for feature flag ").concat(flag.key));
+        }
+
         throw new InconclusiveMatchError('Flag has unknown group type index');
       }
 
       if (!(groupName in groups)) {
-        console.warn("[FEATURE FLAGS] Can't compute group feature flag: ".concat(flag.key, " without group names passed in"));
+        if (this.debugMode) {
+          console.warn("[FEATURE FLAGS] Can't compute group feature flag: ".concat(flag.key, " without group names passed in"));
+        }
+
         return false;
       }
 
@@ -2174,15 +2200,15 @@ function () {
   };
 
   FeatureFlagsPoller.prototype._loadFeatureFlags = function () {
-    var _a;
+    var _a, _b;
 
     return __awaiter(this, void 0, void 0, function () {
       var res, responseJson, err_1;
 
       var _this = this;
 
-      return __generator(this, function (_b) {
-        switch (_b.label) {
+      return __generator(this, function (_c) {
+        switch (_c.label) {
           case 0:
             if (this.poller) {
               clearTimeout(this.poller);
@@ -2192,17 +2218,17 @@ function () {
             this.poller = setTimeout(function () {
               return _this._loadFeatureFlags();
             }, this.pollingInterval);
-            _b.label = 1;
+            _c.label = 1;
 
           case 1:
-            _b.trys.push([1, 4,, 5]);
+            _c.trys.push([1, 4,, 5]);
 
             return [4
             /*yield*/
             , this._requestFeatureFlagDefinitions()];
 
           case 2:
-            res = _b.sent();
+            res = _c.sent();
 
             if (res && res.status === 401) {
               throw new ClientError("Your personalApiKey is invalid. Are you sure you're not using your Project API key? More information: https://posthog.com/docs/api/overview");
@@ -2221,10 +2247,10 @@ function () {
             , res.json()];
 
           case 3:
-            responseJson = _b.sent();
+            responseJson = _c.sent();
 
             if (!('flags' in responseJson)) {
-              console.error("Invalid response when getting feature flags: ".concat(JSON.stringify(responseJson)));
+              (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, new Error("Invalid response when getting feature flags: ".concat(JSON.stringify(responseJson))));
             }
 
             this.featureFlags = responseJson.flags || [];
@@ -2239,11 +2265,11 @@ function () {
             , 5];
 
           case 4:
-            err_1 = _b.sent(); // if an error that is not an instance of ClientError is thrown
+            err_1 = _c.sent(); // if an error that is not an instance of ClientError is thrown
             // we silently ignore the error when reloading feature flags
 
             if (err_1 instanceof ClientError) {
-              (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, err_1);
+              (_b = this.onError) === null || _b === void 0 ? void 0 : _b.call(this, err_1);
             }
 
             return [3
@@ -2724,48 +2750,103 @@ function (_super) {
         groups = _a.groups,
         sendFeatureFlags = _a.sendFeatureFlags,
         timestamp = _a.timestamp,
-        disableGeoip = _a.disableGeoip;
+        disableGeoip = _a.disableGeoip,
+        uuid = _a.uuid;
 
     var _capture = function (props) {
       _super.prototype.captureStateless.call(_this, distinctId, event, props, {
         timestamp: timestamp,
-        disableGeoip: disableGeoip
+        disableGeoip: disableGeoip,
+        uuid: uuid
       });
-    };
+    }; // :TRICKY: If we flush, or need to shut down, to not lose events we want this promise to resolve before we flush
 
-    if (sendFeatureFlags) {
-      _super.prototype.getFeatureFlagsStateless.call(this, distinctId, groups, undefined, undefined, disableGeoip).then(function (flags) {
-        var featureVariantProperties = {};
 
-        if (flags) {
-          for (var _i = 0, _a = Object.entries(flags); _i < _a.length; _i++) {
-            var _b = _a[_i],
-                feature = _b[0],
-                variant = _b[1];
+    var capturePromise = Promise.resolve().then(function () {
+      return __awaiter(_this, void 0, void 0, function () {
+        var groupsWithStringValues, _i, _a, _b, key, value;
 
-            if (variant !== false) {
-              featureVariantProperties["$feature/".concat(feature)] = variant;
-            }
+        var _c, _d;
+
+        return __generator(this, function (_e) {
+          switch (_e.label) {
+            case 0:
+              if (!sendFeatureFlags) return [3
+              /*break*/
+              , 2];
+              return [4
+              /*yield*/
+              , _super.prototype.getFeatureFlagsStateless.call(this, distinctId, groups, undefined, undefined, disableGeoip)];
+
+            case 1:
+              // If we are sending feature flags, we need to make sure we have the latest flags
+              return [2
+              /*return*/
+              , _e.sent()];
+
+            case 2:
+              if (!((((_d = (_c = this.featureFlagsPoller) === null || _c === void 0 ? void 0 : _c.featureFlags) === null || _d === void 0 ? void 0 : _d.length) || 0) > 0)) return [3
+              /*break*/
+              , 4];
+              groupsWithStringValues = {};
+
+              for (_i = 0, _a = Object.entries(groups || {}); _i < _a.length; _i++) {
+                _b = _a[_i], key = _b[0], value = _b[1];
+                groupsWithStringValues[key] = String(value);
+              }
+
+              return [4
+              /*yield*/
+              , this.getAllFlags(distinctId, {
+                groups: groupsWithStringValues,
+                disableGeoip: disableGeoip,
+                onlyEvaluateLocally: true
+              })];
+
+            case 3:
+              return [2
+              /*return*/
+              , _e.sent()];
+
+            case 4:
+              return [2
+              /*return*/
+              , {}];
           }
+        });
+      });
+    }).then(function (flags) {
+      // Derive the relevant flag properties to add
+      var additionalProperties = {};
+
+      if (flags) {
+        for (var _i = 0, _a = Object.entries(flags); _i < _a.length; _i++) {
+          var _b = _a[_i],
+              feature = _b[0],
+              variant = _b[1];
+          additionalProperties["$feature/".concat(feature)] = variant;
         }
+      }
 
-        var activeFlags = Object.keys(flags || {}).filter(function (flag) {
-          return (flags === null || flags === void 0 ? void 0 : flags[flag]) !== false;
-        });
+      var activeFlags = Object.keys(flags || {}).filter(function (flag) {
+        return (flags === null || flags === void 0 ? void 0 : flags[flag]) !== false;
+      });
 
-        var flagProperties = __assign({
-          $active_feature_flags: activeFlags || undefined
-        }, featureVariantProperties);
+      if (activeFlags.length > 0) {
+        additionalProperties['$active_feature_flags'] = activeFlags;
+      }
 
-        _capture(__assign(__assign(__assign({}, properties), {
-          $groups: groups
-        }), flagProperties));
-      });
-    } else {
-      _capture(__assign(__assign({}, properties), {
+      return additionalProperties;
+    }).catch(function () {
+      // Something went wrong getting the flag info - we should capture the event anyways
+      return {};
+    }).then(function (additionalProperties) {
+      // No matter what - capture the event
+      _capture(__assign(__assign(__assign({}, additionalProperties), properties), {
         $groups: groups
       }));
-    }
+    });
+    this.addPendingPromise(capturePromise);
   };
 
   PostHog.prototype.identify = function (_a) {
@@ -2792,15 +2873,18 @@ function (_super) {
     var _a;
 
     return __awaiter(this, void 0, void 0, function () {
-      var _b, groups, personProperties, groupProperties, disableGeoip, _c, onlyEvaluateLocally, sendFeatureFlagEvents, response, flagWasLocallyEvaluated, featureFlagReportedKey;
+      var _b, groups, disableGeoip, _c, onlyEvaluateLocally, sendFeatureFlagEvents, personProperties, groupProperties, adjustedProperties, response, flagWasLocallyEvaluated, featureFlagReportedKey;
 
       var _d;
 
       return __generator(this, function (_e) {
         switch (_e.label) {
           case 0:
-            _b = options || {}, groups = _b.groups, personProperties = _b.personProperties, groupProperties = _b.groupProperties, disableGeoip = _b.disableGeoip;
-            _c = options || {}, onlyEvaluateLocally = _c.onlyEvaluateLocally, sendFeatureFlagEvents = _c.sendFeatureFlagEvents; // set defaults
+            _b = options || {}, groups = _b.groups, disableGeoip = _b.disableGeoip;
+            _c = options || {}, onlyEvaluateLocally = _c.onlyEvaluateLocally, sendFeatureFlagEvents = _c.sendFeatureFlagEvents, personProperties = _c.personProperties, groupProperties = _c.groupProperties;
+            adjustedProperties = this.addLocalPersonAndGroupProperties(distinctId, groups, personProperties, groupProperties);
+            personProperties = adjustedProperties.allPersonProperties;
+            groupProperties = adjustedProperties.allGroupProperties; // set defaults
 
             if (onlyEvaluateLocally == undefined) {
               onlyEvaluateLocally = false;
@@ -2867,13 +2951,16 @@ function (_super) {
     var _a;
 
     return __awaiter(this, void 0, void 0, function () {
-      var _b, groups, personProperties, groupProperties, disableGeoip, _c, onlyEvaluateLocally, response, payloadWasLocallyEvaluated;
+      var _b, groups, disableGeoip, _c, onlyEvaluateLocally, personProperties, groupProperties, adjustedProperties, response, payloadWasLocallyEvaluated;
 
       return __generator(this, function (_d) {
         switch (_d.label) {
           case 0:
-            _b = options || {}, groups = _b.groups, personProperties = _b.personProperties, groupProperties = _b.groupProperties, disableGeoip = _b.disableGeoip;
-            _c = options || {}, onlyEvaluateLocally = _c.onlyEvaluateLocally, _c.sendFeatureFlagEvents;
+            _b = options || {}, groups = _b.groups, disableGeoip = _b.disableGeoip;
+            _c = options || {}, onlyEvaluateLocally = _c.onlyEvaluateLocally, _c.sendFeatureFlagEvents, personProperties = _c.personProperties, groupProperties = _c.groupProperties;
+            adjustedProperties = this.addLocalPersonAndGroupProperties(distinctId, groups, personProperties, groupProperties);
+            personProperties = adjustedProperties.allPersonProperties;
+            groupProperties = adjustedProperties.allGroupProperties;
             response = undefined;
             if (!!matchValue) return [3
             /*break*/
@@ -2993,13 +3080,16 @@ function (_super) {
     var _a;
 
     return __awaiter(this, void 0, void 0, function () {
-      var _b, groups, personProperties, groupProperties, disableGeoip, onlyEvaluateLocally, localEvaluationResult, featureFlags, featureFlagPayloads, fallbackToDecide, remoteEvaluationResult;
+      var _b, groups, disableGeoip, _c, onlyEvaluateLocally, personProperties, groupProperties, adjustedProperties, localEvaluationResult, featureFlags, featureFlagPayloads, fallbackToDecide, remoteEvaluationResult;
 
-      return __generator(this, function (_c) {
-        switch (_c.label) {
+      return __generator(this, function (_d) {
+        switch (_d.label) {
           case 0:
-            _b = options || {}, groups = _b.groups, personProperties = _b.personProperties, groupProperties = _b.groupProperties, disableGeoip = _b.disableGeoip;
-            onlyEvaluateLocally = (options || {}).onlyEvaluateLocally; // set defaults
+            _b = options || {}, groups = _b.groups, disableGeoip = _b.disableGeoip;
+            _c = options || {}, onlyEvaluateLocally = _c.onlyEvaluateLocally, personProperties = _c.personProperties, groupProperties = _c.groupProperties;
+            adjustedProperties = this.addLocalPersonAndGroupProperties(distinctId, groups, personProperties, groupProperties);
+            personProperties = adjustedProperties.allPersonProperties;
+            groupProperties = adjustedProperties.allGroupProperties; // set defaults
 
             if (onlyEvaluateLocally == undefined) {
               onlyEvaluateLocally = false;
@@ -3010,7 +3100,7 @@ function (_super) {
             , (_a = this.featureFlagsPoller) === null || _a === void 0 ? void 0 : _a.getAllFlagsAndPayloads(distinctId, groups, personProperties, groupProperties)];
 
           case 1:
-            localEvaluationResult = _c.sent();
+            localEvaluationResult = _d.sent();
             featureFlags = {};
             featureFlagPayloads = {};
             fallbackToDecide = true;
@@ -3029,10 +3119,10 @@ function (_super) {
             , _super.prototype.getFeatureFlagsAndPayloadsStateless.call(this, distinctId, groups, personProperties, groupProperties, disableGeoip)];
 
           case 2:
-            remoteEvaluationResult = _c.sent();
+            remoteEvaluationResult = _d.sent();
             featureFlags = __assign(__assign({}, featureFlags), remoteEvaluationResult.flags || {});
             featureFlagPayloads = __assign(__assign({}, featureFlagPayloads), remoteEvaluationResult.payloads || {});
-            _c.label = 3;
+            _d.label = 3;
 
           case 3:
             return [2
@@ -3097,6 +3187,28 @@ function (_super) {
     });
   };
 
+  PostHog.prototype.addLocalPersonAndGroupProperties = function (distinctId, groups, personProperties, groupProperties) {
+    var allPersonProperties = __assign({
+      $current_distinct_id: distinctId
+    }, personProperties || {});
+
+    var allGroupProperties = {};
+
+    if (groups) {
+      for (var _i = 0, _a = Object.keys(groups); _i < _a.length; _i++) {
+        var groupName = _a[_i];
+        allGroupProperties[groupName] = __assign({
+          $group_key: groups[groupName]
+        }, (groupProperties === null || groupProperties === void 0 ? void 0 : groupProperties[groupName]) || {});
+      }
+    }
+
+    return {
+      allPersonProperties: allPersonProperties,
+      allGroupProperties: allGroupProperties
+    };
+  };
+
   return PostHog;
 }(PostHogCoreStateless);