posthog-js 1.29.3 → 1.30.0

package/dist/module.d.ts

@@ -188,6 +188,11 @@ interface PostHogConfig {
     _onCapture: (eventName: string, eventData: CaptureResult) => void;
     _capture_metrics: boolean;
     _capture_performance: boolean;
+    bootstrap: {
+        distinctID?: string;
+        isIdentifiedID?: boolean;
+        featureFlags?: Record<string, boolean | string>;
+    };
 }
 interface OptInOutCapturingOptions {
     capture: (event: string, properties: Properties, options: CaptureOptions) => void;
@@ -418,7 +423,7 @@ declare class PostHogFeatureFlags {
         send_event?: boolean;
     }): boolean;
     addFeatureFlagsHandler(handler: FeatureFlagsCallback): void;
-    receivedFeatureFlags(response: DecideResponse): void;
+    receivedFeatureFlags(response: Partial<DecideResponse>): void;
     override(flags: boolean | string[] | Record<string, string | boolean>): void;
     onFeatureFlags(callback: FeatureFlagsCallback): void;
 }
@@ -925,6 +930,7 @@ declare class PostHog {
      * @param {Array} array
      */
     _execute_array(array: SnippetArrayItem[]): void;
+    _hasBootstrappedFeatureFlags(): boolean;
     /**
      * push() keeps the standard async-array-push
      * behavior around after the lib is loaded.

package/dist/module.js

@@ -885,7 +885,7 @@ var LZString = {
   }
 };
 
-var version = "1.29.3";
+var version = "1.30.0";
 
 // e.g.     Config.DEBUG = Config.DEBUG || instance.get_config('debug')
 
@@ -3294,6 +3294,7 @@ var PostHogFeatureFlags = /*#__PURE__*/function () {
   }, {
     key: "receivedFeatureFlags",
     value: function receivedFeatureFlags(response) {
+      this.instance.decideEndpointWasHit = true;
       parseFeatureFlagDecideResponse(response, this.instance.persistence);
       var flags = this.getFlags();
       var variants = this.getFlagVariants();
@@ -3971,8 +3972,9 @@ var Decide = /*#__PURE__*/function () {
   function Decide(instance) {
     _classCallCheck(this, Decide);
 
-    this.instance = instance;
-    this.instance.decideEndpointWasHit = false;
+    this.instance = instance; // don't need to wait for `decide` to return if flags were provided on initialisation
+
+    this.instance.decideEndpointWasHit = this.instance._hasBootstrappedFeatureFlags();
   }
 
   _createClass(Decide, [{
@@ -5958,7 +5960,8 @@ var defaultConfig = function defaultConfig() {
     _capture_metrics: false,
     _capture_performance: false,
     name: 'posthog',
-    callback_fn: 'posthog._jsc'
+    callback_fn: 'posthog._jsc',
+    bootstrap: {}
   };
 };
 /**
@@ -6107,6 +6110,8 @@ var PostHog = /*#__PURE__*/function () {
   }, {
     key: "_init",
     value: function _init(token) {
+      var _config$bootstrap;
+
       var config = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
       var name = arguments.length > 2 ? arguments[2] : undefined;
       this.__loaded = true;
@@ -6131,14 +6136,43 @@ var PostHog = /*#__PURE__*/function () {
 
       this._gdpr_init();
 
+      if (((_config$bootstrap = config.bootstrap) === null || _config$bootstrap === void 0 ? void 0 : _config$bootstrap.distinctID) !== undefined) {
+        var _config$bootstrap2;
+
+        var uuid = this.get_config('get_device_id')(_UUID());
+        var deviceID = (_config$bootstrap2 = config.bootstrap) !== null && _config$bootstrap2 !== void 0 && _config$bootstrap2.isIdentifiedID ? uuid : config.bootstrap.distinctID;
+        this.register({
+          distinct_id: config.bootstrap.distinctID,
+          $device_id: deviceID
+        });
+      }
+
+      if (this._hasBootstrappedFeatureFlags()) {
+        var _config$bootstrap3;
+
+        var activeFlags = Object.keys(((_config$bootstrap3 = config.bootstrap) === null || _config$bootstrap3 === void 0 ? void 0 : _config$bootstrap3.featureFlags) || {}).filter(function (flag) {
+          var _config$bootstrap4, _config$bootstrap4$fe;
+
+          return !!((_config$bootstrap4 = config.bootstrap) !== null && _config$bootstrap4 !== void 0 && (_config$bootstrap4$fe = _config$bootstrap4.featureFlags) !== null && _config$bootstrap4$fe !== void 0 && _config$bootstrap4$fe[flag]);
+        }).reduce(function (res, key) {
+          var _config$bootstrap5, _config$bootstrap5$fe;
+
+          return res[key] = ((_config$bootstrap5 = config.bootstrap) === null || _config$bootstrap5 === void 0 ? void 0 : (_config$bootstrap5$fe = _config$bootstrap5.featureFlags) === null || _config$bootstrap5$fe === void 0 ? void 0 : _config$bootstrap5$fe[key]) || false, res;
+        }, {});
+        this.featureFlags.receivedFeatureFlags({
+          featureFlags: activeFlags
+        });
+      }
+
       if (!this.get_distinct_id()) {
         // There is no need to set the distinct id
         // or the device id if something was already stored
         // in the persitence
-        var uuid = this.get_config('get_device_id')(_UUID());
+        var _uuid = this.get_config('get_device_id')(_UUID());
+
         this.register_once({
-          distinct_id: uuid,
-          $device_id: uuid
+          distinct_id: _uuid,
+          $device_id: _uuid
         }, '');
       } // Set up event handler for pageleave
       // Use `onpagehide` if available, see https://calendar.perfplanet.com/2020/beaconing-in-practice/#beaconing-reliability-avoiding-abandons
@@ -6419,6 +6453,13 @@ var PostHog = /*#__PURE__*/function () {
       execute(other_calls, this);
       execute(capturing_calls, this);
     }
+  }, {
+    key: "_hasBootstrappedFeatureFlags",
+    value: function _hasBootstrappedFeatureFlags() {
+      var _this$config$bootstra, _this$config$bootstra2;
+
+      return ((_this$config$bootstra = this.config.bootstrap) === null || _this$config$bootstra === void 0 ? void 0 : _this$config$bootstra.featureFlags) && Object.keys((_this$config$bootstra2 = this.config.bootstrap) === null || _this$config$bootstra2 === void 0 ? void 0 : _this$config$bootstra2.featureFlags).length > 0 || false;
+    }
     /**
      * push() keeps the standard async-array-push
      * behavior around after the lib is loaded.