posthog-node 2.3.0 → 2.4.0

package/lib/index.d.ts

@@ -1,6 +1,4 @@
 /// <reference types="node" />
-import { JsonType as JsonType$1 } from 'posthog-core/src';
-
 declare type PosthogCoreOptions = {
     host?: string;
     flushAt?: number;
@@ -70,6 +68,7 @@ interface EventMessageV1 extends IdentifyMessageV1 {
     event: string;
     groups?: Record<string, string | number>;
     sendFeatureFlags?: boolean;
+    timestamp?: Date;
 }
 interface GroupIdentifyMessage {
     groupType: string;
@@ -174,7 +173,7 @@ declare type PostHogNodeV1 = {
      */
     getFeatureFlagPayload(key: string, distinctId: string, matchValue?: string | boolean, options?: {
         onlyEvaluateLocally?: boolean;
-    }): Promise<JsonType$1 | undefined>;
+    }): Promise<JsonType | undefined>;
     /**
      * @description Sets a groups properties, which allows asking questions like "Who are the most active companies"
      * using my product in PostHog.
@@ -213,7 +212,7 @@ declare class PostHog implements PostHogNodeV1 {
     private reInit;
     enable(): void;
     disable(): void;
-    capture({ distinctId, event, properties, groups, sendFeatureFlags }: EventMessageV1): void;
+    capture({ distinctId, event, properties, groups, sendFeatureFlags, timestamp }: EventMessageV1): void;
     identify({ distinctId, properties }: IdentifyMessageV1): void;
     alias(data: {
         distinctId: string;

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.3.0";
+var version = "2.4.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -870,7 +870,7 @@ var PostHogCore = /** @class */ (function () {
     /***
      *** TRACKING
      ***/
-    PostHogCore.prototype.identify = function (distinctId, properties) {
+    PostHogCore.prototype.identify = function (distinctId, properties, options) {
         var previousDistinctId = this.getDistinctId();
         distinctId = distinctId || previousDistinctId;
         if (properties === null || properties === void 0 ? void 0 : properties.$groups) {
@@ -889,21 +889,15 @@ var PostHogCore = /** @class */ (function () {
                 void this.reloadFeatureFlagsAsync();
             }
         }
-        this.enqueue('identify', payload);
+        this.enqueue('identify', payload, options);
         return this;
     };
-    PostHogCore.prototype.capture = function (event, properties, forceSendFeatureFlags) {
-        if (forceSendFeatureFlags === void 0) { forceSendFeatureFlags = false; }
+    PostHogCore.prototype.capture = function (event, properties, options) {
         if (properties === null || properties === void 0 ? void 0 : properties.$groups) {
             this.groups(properties.$groups);
         }
-        if (forceSendFeatureFlags) {
-            this._sendFeatureFlags(event, properties);
-        }
-        else {
-            var payload = this.buildPayload({ event: event, properties: properties });
-            this.enqueue('capture', payload);
-        }
+        var payload = this.buildPayload({ event: event, properties: properties });
+        this.enqueue('capture', payload, options);
         return this;
     };
     PostHogCore.prototype.alias = function (alias) {
@@ -918,13 +912,13 @@ var PostHogCore = /** @class */ (function () {
         this.enqueue('alias', payload);
         return this;
     };
-    PostHogCore.prototype.autocapture = function (eventType, elements, properties) {
+    PostHogCore.prototype.autocapture = function (eventType, elements, properties, options) {
         if (properties === void 0) { properties = {}; }
         var payload = this.buildPayload({
             event: '$autocapture',
             properties: __assign(__assign({}, properties), { $event_type: eventType, $elements: elements }),
         });
-        this.enqueue('autocapture', payload);
+        this.enqueue('autocapture', payload, options);
         return this;
     };
     /***
@@ -941,22 +935,22 @@ var PostHogCore = /** @class */ (function () {
         }
         return this;
     };
-    PostHogCore.prototype.group = function (groupType, groupKey, groupProperties) {
+    PostHogCore.prototype.group = function (groupType, groupKey, groupProperties, options) {
         var _a;
         this.groups((_a = {},
             _a[groupType] = groupKey,
             _a));
         if (groupProperties) {
-            this.groupIdentify(groupType, groupKey, groupProperties);
+            this.groupIdentify(groupType, groupKey, groupProperties, options);
         }
         return this;
     };
-    PostHogCore.prototype.groupIdentify = function (groupType, groupKey, groupProperties) {
+    PostHogCore.prototype.groupIdentify = function (groupType, groupKey, groupProperties, options) {
         var payload = this.buildPayload({
             event: '$groupidentify',
             properties: __assign({ $group_type: groupType, $group_key: groupKey, $group_set: groupProperties || {} }, this.getCommonEventProperties()),
         });
-        this.enqueue('capture', payload);
+        this.enqueue('capture', payload, options);
         return this;
     };
     /***
@@ -1173,23 +1167,15 @@ var PostHogCore = /** @class */ (function () {
         }
         return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, flags);
     };
-    PostHogCore.prototype._sendFeatureFlags = function (event, properties) {
-        var _this = this;
-        this.reloadFeatureFlagsAsync(false).finally(function () {
-            // Try to enqueue message irrespective of errors during feature flag fetching
-            var payload = _this.buildPayload({ event: event, properties: properties });
-            _this.enqueue('capture', payload);
-        });
-    };
     /***
      *** QUEUEING AND FLUSHING
      ***/
-    PostHogCore.prototype.enqueue = function (type, _message) {
+    PostHogCore.prototype.enqueue = function (type, _message, options) {
         var _this = this;
         if (this.optedOut) {
             return;
         }
-        var message = __assign(__assign({}, _message), { type: type, library: this.getLibraryId(), library_version: this.getLibraryVersion(), timestamp: _message.timestamp ? _message.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() });
         if (message.distinctId) {
             message.distinct_id = message.distinctId;
             delete message.distinctId;
@@ -2172,18 +2158,33 @@ function () {
   };
 
   PostHog.prototype.capture = function (_a) {
+    var _this = this;
+
     var distinctId = _a.distinctId,
         event = _a.event,
         properties = _a.properties,
         groups = _a.groups,
-        sendFeatureFlags = _a.sendFeatureFlags;
+        sendFeatureFlags = _a.sendFeatureFlags,
+        timestamp = _a.timestamp;
     this.reInit(distinctId);
 
     if (groups) {
       this._sharedClient.groups(groups);
     }
 
-    this._sharedClient.capture(event, properties, sendFeatureFlags || false);
+    var _capture = function () {
+      _this._sharedClient.capture(event, properties, {
+        timestamp: timestamp
+      });
+    };
+
+    if (sendFeatureFlags) {
+      this._sharedClient.reloadFeatureFlagsAsync(false).finally(function () {
+        _capture();
+      });
+    } else {
+      _capture();
+    }
   };
 
   PostHog.prototype.identify = function (_a) {