posthog-node 4.1.1 → 4.2.0

package/lib/index.d.ts

@@ -40,6 +40,8 @@ declare type PostHogCoreOptions = {
     /** Whether to post events to PostHog in JSON or compressed format. Defaults to 'form' */
     captureMode?: 'json' | 'form';
     disableGeoip?: boolean;
+    /** Special flag to indicate ingested data is for a historical migration. */
+    historicalMigration?: boolean;
 };
 declare enum PostHogPersistedProperty {
     AnonymousId = "anonymous_id",
@@ -137,6 +139,7 @@ declare abstract class PostHogCoreStateless {
     private captureMode;
     private removeDebugCallback?;
     private disableGeoip;
+    private historicalMigration;
     disabled: boolean;
     private defaultOptIn;
     private pendingPromises;

package/lib/index.esm.js

@@ -1,6 +1,6 @@
 import { createHash } from 'rusha';
 
-var version = "4.1.1";
+var version = "4.2.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -948,6 +948,7 @@ class PostHogCoreStateless {
     constructor(apiKey, options) {
         this.flushPromise = null;
         this.disableGeoip = true;
+        this.historicalMigration = false;
         this.disabled = false;
         this.defaultOptIn = true;
         this.pendingPromises = {};
@@ -973,6 +974,7 @@ class PostHogCoreStateless {
         this.featureFlagsRequestTimeoutMs = options?.featureFlagsRequestTimeoutMs ?? 3000; // 3 seconds
         this.disableGeoip = options?.disableGeoip ?? true;
         this.disabled = options?.disabled ?? false;
+        this.historicalMigration = options?.historicalMigration ?? false;
         // Init promise allows the derived class to block calls until it is ready
         this._initPromise = Promise.resolve();
         this._isInitialized = true;
@@ -1287,6 +1289,9 @@ class PostHogCoreStateless {
             batch: messages,
             sent_at: currentISOTime(),
         };
+        if (this.historicalMigration) {
+            data.historical_migration = true;
+        }
         const payload = JSON.stringify(data);
         const url = this.captureMode === 'form'
             ? `${this.host}/e/?ip=1&_=${currentTimestamp()}&v=${this.getLibraryVersion()}`