posthog-node 2.1.0 → 2.2.0

package/lib/index.d.ts

@@ -6,6 +6,11 @@ declare type PosthogCoreOptions = {
     enable?: boolean;
     sendFeatureFlagEvent?: boolean;
     preloadFeatureFlags?: boolean;
+    bootstrap?: {
+        distinctId?: string;
+        isIdentifiedId?: boolean;
+        featureFlags?: Record<string, boolean | string>;
+    };
     fetchRetryCount?: number;
     fetchRetryDelay?: number;
     sessionExpirationTimeSeconds?: number;

package/lib/index.esm.js

@@ -155,7 +155,7 @@ function __spreadArray(to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 }
 
-var version = "2.1.0";
+var version = "2.2.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -752,6 +752,26 @@ var PostHogCore = /** @class */ (function () {
         }
         return __assign({ $lib: this.getLibraryId(), $lib_version: this.getLibraryVersion(), $active_feature_flags: featureFlags ? Object.keys(featureFlags) : undefined }, featureVariantProperties);
     };
+    PostHogCore.prototype.setupBootstrap = function (options) {
+        var _a, _b, _c, _d;
+        if ((_a = options === null || options === void 0 ? void 0 : options.bootstrap) === null || _a === void 0 ? void 0 : _a.distinctId) {
+            if ((_b = options === null || options === void 0 ? void 0 : options.bootstrap) === null || _b === void 0 ? void 0 : _b.isIdentifiedId) {
+                this.setPersistedProperty(PostHogPersistedProperty.DistinctId, options.bootstrap.distinctId);
+            }
+            else {
+                this.setPersistedProperty(PostHogPersistedProperty.AnonymousId, options.bootstrap.distinctId);
+            }
+        }
+        if ((_c = options === null || options === void 0 ? void 0 : options.bootstrap) === null || _c === void 0 ? void 0 : _c.featureFlags) {
+            var activeFlags = Object.keys(((_d = options.bootstrap) === null || _d === void 0 ? void 0 : _d.featureFlags) || {})
+                .filter(function (flag) { var _a, _b; return !!((_b = (_a = options.bootstrap) === null || _a === void 0 ? void 0 : _a.featureFlags) === null || _b === void 0 ? void 0 : _b[flag]); })
+                .reduce(function (res, key) {
+                var _a, _b;
+                return ((res[key] = ((_b = (_a = options.bootstrap) === null || _a === void 0 ? void 0 : _a.featureFlags) === null || _b === void 0 ? void 0 : _b[key]) || false), res);
+            }, {});
+            this.setKnownFeatureFlags(activeFlags);
+        }
+    };
     Object.defineProperty(PostHogCore.prototype, "props", {
         // NOTE: Props are lazy loaded from localstorage hence the complex getter setter logic
         get: function () {
@@ -995,8 +1015,7 @@ var PostHogCore = /** @class */ (function () {
                     .then(function (r) { return r.json(); })
                     .then(function (res) {
                     if (res.featureFlags) {
-                        _this.setPersistedProperty(PostHogPersistedProperty.FeatureFlags, res.featureFlags);
-                        _this._events.emit('featureflags', res.featureFlags);
+                        _this.setKnownFeatureFlags(res.featureFlags);
                     }
                     return res;
                 })
@@ -1007,6 +1026,10 @@ var PostHogCore = /** @class */ (function () {
             });
         });
     };
+    PostHogCore.prototype.setKnownFeatureFlags = function (featureFlags) {
+        this.setPersistedProperty(PostHogPersistedProperty.FeatureFlags, featureFlags);
+        this._events.emit('featureflags', featureFlags);
+    };
     PostHogCore.prototype.getFeatureFlag = function (key) {
         var featureFlags = this.getFeatureFlags();
         if (!featureFlags) {
@@ -1497,16 +1520,44 @@ function () {
   };
 
   FeatureFlagsPoller.prototype.matchFeatureFlagProperties = function (flag, distinctId, properties) {
-    var _this = this;
+    var _a;
 
     var flagFilters = flag.filters || {};
     var flagConditions = flagFilters.groups || [];
     var isInconclusive = false;
-    var result = undefined;
-    flagConditions.forEach(function (condition) {
+    var result = undefined; // # Stable sort conditions with variant overrides to the top. This ensures that if overrides are present, they are
+    // # evaluated first, and the variant override is applied to the first matching condition.
+
+    var sortedFlagConditions = __spreadArray([], flagConditions, true).sort(function (conditionA, conditionB) {
+      var AHasVariantOverride = !!conditionA.variant;
+      var BHasVariantOverride = !!conditionB.variant;
+
+      if (AHasVariantOverride && BHasVariantOverride) {
+        return 0;
+      } else if (AHasVariantOverride) {
+        return -1;
+      } else if (BHasVariantOverride) {
+        return 1;
+      } else {
+        return 0;
+      }
+    });
+
+    var _loop_1 = function (condition) {
       try {
-        if (_this.isConditionMatch(flag, distinctId, condition, properties)) {
-          result = _this.getMatchingVariant(flag, distinctId) || true;
+        if (this_1.isConditionMatch(flag, distinctId, condition, properties)) {
+          var variantOverride_1 = condition.variant;
+          var flagVariants = ((_a = flagFilters.multivariate) === null || _a === void 0 ? void 0 : _a.variants) || [];
+
+          if (variantOverride_1 && flagVariants.some(function (variant) {
+            return variant.key === variantOverride_1;
+          })) {
+            result = variantOverride_1;
+          } else {
+            result = this_1.getMatchingVariant(flag, distinctId) || true;
+          }
+
+          return "break";
         }
       } catch (e) {
         if (e instanceof InconclusiveMatchError) {
@@ -1515,7 +1566,17 @@ function () {
           throw e;
         }
       }
-    });
+    };
+
+    var this_1 = this;
+
+    for (var _i = 0, sortedFlagConditions_1 = sortedFlagConditions; _i < sortedFlagConditions_1.length; _i++) {
+      var condition = sortedFlagConditions_1[_i];
+
+      var state_1 = _loop_1(condition);
+
+      if (state_1 === "break") break;
+    }
 
     if (result !== undefined) {
       return result;
@@ -1812,6 +1873,17 @@ function matchProperty(property, propertyValues) {
     case 'lte':
       return typeof overrideValue == typeof value && overrideValue <= value;
 
+    case 'is_date_after':
+    case 'is_date_before':
+      var parsedDate = convertToDateTime(value);
+      var overrideDate = convertToDateTime(overrideValue);
+
+      if (operator === 'is_date_before') {
+        return overrideDate < parsedDate;
+      }
+
+      return overrideDate > parsedDate;
+
     default:
       console.error("Unknown operator: ".concat(operator));
       return false;
@@ -1827,6 +1899,22 @@ function isValidRegex(regex) {
   }
 }
 
+function convertToDateTime(value) {
+  if (value instanceof Date) {
+    return value;
+  } else if (typeof value === 'string' || typeof value === 'number') {
+    var date = new Date(value);
+
+    if (!isNaN(date.valueOf())) {
+      return date;
+    }
+
+    throw new InconclusiveMatchError("".concat(value, " is in an invalid date format"));
+  } else {
+    throw new InconclusiveMatchError("The date provided ".concat(value, " must be a string, number, or date object"));
+  }
+}
+
 var THIRTY_SECONDS = 30 * 1000;
 var MAX_CACHE_SIZE = 50 * 1000;