posthog-node 5.1.1 → 5.3.1

package/lib/index.d.ts

@@ -230,6 +230,12 @@ type SurveyAppearance = {
     widgetColor?: string;
 };
 declare enum SurveyPosition {
+    TopLeft = "top_left",
+    TopCenter = "top_center",
+    TopRight = "top_right",
+    MiddleLeft = "middle_left",
+    MiddleCenter = "middle_center",
+    MiddleRight = "middle_right",
     Left = "left",
     Right = "right",
     Center = "center"
@@ -620,6 +626,7 @@ type PostHogOptions = PostHogCoreOptions & {
     featureFlagsPollingInterval?: number;
     maxCacheSize?: number;
     fetch?: (url: string, options: PostHogFetchOptions) => Promise<PostHogFetchResponse>;
+    enableLocalEvaluation?: boolean;
 };
 type PostHogFeatureFlag = {
     id: number;
@@ -818,7 +825,7 @@ declare class ErrorTracking {
     private _exceptionAutocaptureEnabled;
     static stackParser: StackParser;
     static frameModifiers: StackFrameModifierFn[];
-    static captureException(client: PostHogBackendClient, error: unknown, hint: EventHint, distinctId?: string, additionalProperties?: Record<string | number, any>): Promise<void>;
+    static buildEventMessage(error: unknown, hint: EventHint, distinctId?: string, additionalProperties?: Record<string | number, any>): Promise<EventMessage>;
     constructor(client: PostHogBackendClient, options: PostHogOptions);
     private startAutocaptureIfEnabled;
     private onException;
@@ -904,8 +911,10 @@ declare abstract class PostHogBackendClient extends PostHogCoreStateless impleme
      */
     reloadFeatureFlags(): Promise<void>;
     _shutdown(shutdownTimeoutMs?: number): Promise<void>;
+    private _requestRemoteConfigPayload;
     private addLocalPersonAndGroupProperties;
     captureException(error: unknown, distinctId?: string, additionalProperties?: Record<string | number, any>): void;
+    captureExceptionImmediate(error: unknown, distinctId?: string, additionalProperties?: Record<string | number, any>): Promise<void>;
 }
 
 /**

package/lib/node/index.cjs

@@ -881,7 +881,7 @@ function applyChunkIds(frames, parser) {
 
 const SHUTDOWN_TIMEOUT = 2000;
 class ErrorTracking {
-  static async captureException(client, error, hint, distinctId, additionalProperties) {
+  static async buildEventMessage(error, hint, distinctId, additionalProperties) {
     const properties = {
       ...additionalProperties
     };
@@ -891,14 +891,14 @@ class ErrorTracking {
       properties.$process_person_profile = false;
     }
     const exceptionProperties = await propertiesFromUnknownInput(this.stackParser, this.frameModifiers, error, hint);
-    client.capture({
+    return {
       event: '$exception',
       distinctId: distinctId || uuidv7(),
       properties: {
         ...exceptionProperties,
         ...properties
       }
-    });
+    };
   }
   constructor(client, options) {
     this.client = client;
@@ -912,7 +912,9 @@ class ErrorTracking {
     }
   }
   onException(exception, hint) {
-    ErrorTracking.captureException(this.client, exception, hint);
+    void ErrorTracking.buildEventMessage(exception, hint).then(msg => {
+      this.client.capture(msg);
+    });
   }
   async onFatalError() {
     await this.client.shutdown(SHUTDOWN_TIMEOUT);
@@ -932,9 +934,9 @@ function setupExpressErrorHandler(_posthog, app) {
     };
     // Given stateless nature of Node SDK we capture exceptions using personless processing
     // when no user can be determined e.g. in the case of exception autocapture
-    ErrorTracking.captureException(_posthog, error, hint, uuidv7(), {
+    ErrorTracking.buildEventMessage(error, hint, uuidv7(), {
       $process_person_profile: false
-    });
+    }).then(msg => _posthog.capture(msg));
     next(error);
   });
 }
@@ -1340,7 +1342,7 @@ function snipLine(line, colno) {
   return newLine;
 }
 
-var version = "5.1.1";
+var version = "5.3.1";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -1378,6 +1380,12 @@ var Compression;
 })(Compression || (Compression = {}));
 var SurveyPosition;
 (function (SurveyPosition) {
+    SurveyPosition["TopLeft"] = "top_left";
+    SurveyPosition["TopCenter"] = "top_center";
+    SurveyPosition["TopRight"] = "top_right";
+    SurveyPosition["MiddleLeft"] = "middle_left";
+    SurveyPosition["MiddleCenter"] = "middle_center";
+    SurveyPosition["MiddleRight"] = "middle_right";
     SurveyPosition["Left"] = "left";
     SurveyPosition["Right"] = "right";
     SurveyPosition["Center"] = "center";
@@ -2898,23 +2906,6 @@ class FeatureFlagsPoller {
   stopPoller() {
     clearTimeout(this.poller);
   }
-  _requestRemoteConfigPayload(flagKey) {
-    const url = `${this.host}/api/projects/@current/feature_flags/${flagKey}/remote_config/`;
-    const options = this.getPersonalApiKeyRequestOptions();
-    let abortTimeout = null;
-    if (this.timeout && typeof this.timeout === 'number') {
-      const controller = new AbortController();
-      abortTimeout = safeSetTimeout(() => {
-        controller.abort();
-      }, this.timeout);
-      options.signal = controller.signal;
-    }
-    try {
-      return this.fetch(url, options);
-    } finally {
-      clearTimeout(abortTimeout);
-    }
-  }
 }
 // # This function takes a distinct_id and a feature flag key and returns a float between 0 and 1.
 // # Given the same distinct_id and key, it'll always return the same float. These floats are
@@ -3199,21 +3190,25 @@ class PostHogBackendClient extends PostHogCoreStateless {
       if (options.personalApiKey.includes('phc_')) {
         throw new Error('Your Personal API key is invalid. These keys are prefixed with "phx_" and can be created in PostHog project settings.');
       }
-      this.featureFlagsPoller = new FeatureFlagsPoller({
-        pollingInterval: this.options.featureFlagsPollingInterval,
-        personalApiKey: options.personalApiKey,
-        projectApiKey: apiKey,
-        timeout: options.requestTimeout ?? 10000,
-        host: this.host,
-        fetch: options.fetch,
-        onError: err => {
-          this._events.emit('error', err);
-        },
-        onLoad: count => {
-          this._events.emit('localEvaluationFlagsLoaded', count);
-        },
-        customHeaders: this.getCustomHeaders()
-      });
+      // Only start the poller if local evaluation is enabled (defaults to true for backward compatibility)
+      const shouldEnableLocalEvaluation = options.enableLocalEvaluation !== false;
+      if (shouldEnableLocalEvaluation) {
+        this.featureFlagsPoller = new FeatureFlagsPoller({
+          pollingInterval: this.options.featureFlagsPollingInterval,
+          personalApiKey: options.personalApiKey,
+          projectApiKey: apiKey,
+          timeout: options.requestTimeout ?? 10000,
+          host: this.host,
+          fetch: options.fetch,
+          onError: err => {
+            this._events.emit('error', err);
+          },
+          onLoad: count => {
+            this._events.emit('localEvaluationFlagsLoaded', count);
+          },
+          customHeaders: this.getCustomHeaders()
+        });
+      }
     }
     this.errorTracking = new ErrorTracking(this, options);
     this.distinctIdHasSentFlagCalls = {};
@@ -3569,7 +3564,10 @@ class PostHogBackendClient extends PostHogCoreStateless {
     return response;
   }
   async getRemoteConfigPayload(flagKey) {
-    const response = await this.featureFlagsPoller?._requestRemoteConfigPayload(flagKey);
+    if (!this.options.personalApiKey) {
+      throw new Error('Personal API key is required for remote config payload decryption');
+    }
+    const response = await this._requestRemoteConfigPayload(flagKey);
     if (!response) {
       return undefined;
     }
@@ -3663,6 +3661,38 @@ class PostHogBackendClient extends PostHogCoreStateless {
     this.featureFlagsPoller?.stopPoller();
     return super._shutdown(shutdownTimeoutMs);
   }
+  async _requestRemoteConfigPayload(flagKey) {
+    if (!this.options.personalApiKey) {
+      return undefined;
+    }
+    const url = `${this.host}/api/projects/@current/feature_flags/${flagKey}/remote_config/`;
+    const options = {
+      method: 'GET',
+      headers: {
+        ...this.getCustomHeaders(),
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${this.options.personalApiKey}`
+      }
+    };
+    let abortTimeout = null;
+    if (this.options.requestTimeout && typeof this.options.requestTimeout === 'number') {
+      const controller = new AbortController();
+      abortTimeout = safeSetTimeout(() => {
+        controller.abort();
+      }, this.options.requestTimeout);
+      options.signal = controller.signal;
+    }
+    try {
+      return await this.fetch(url, options);
+    } catch (error) {
+      this._events.emit('error', error);
+      return undefined;
+    } finally {
+      if (abortTimeout) {
+        clearTimeout(abortTimeout);
+      }
+    }
+  }
   addLocalPersonAndGroupProperties(distinctId, groups, personProperties, groupProperties) {
     const allPersonProperties = {
       distinct_id: distinctId,
@@ -3684,9 +3714,18 @@ class PostHogBackendClient extends PostHogCoreStateless {
   }
   captureException(error, distinctId, additionalProperties) {
     const syntheticException = new Error('PostHog syntheticException');
-    ErrorTracking.captureException(this, error, {
+    ErrorTracking.buildEventMessage(error, {
+      syntheticException
+    }, distinctId, additionalProperties).then(msg => {
+      this.capture(msg);
+    });
+  }
+  async captureExceptionImmediate(error, distinctId, additionalProperties) {
+    const syntheticException = new Error('PostHog syntheticException');
+    const evtMsg = await ErrorTracking.buildEventMessage(error, {
       syntheticException
     }, distinctId, additionalProperties);
+    return await this.captureImmediate(evtMsg);
   }
 }