posthog-node 5.1.0 → 5.2.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Next
 
+# 5.2.1 - 2025-07-07
+
+1. feat: add captureExceptionImmediate method on posthog client
+
+# 5.1.1 - 2025-06-16
+
+1. fix: Handle double-encoded JSON payloads from the remote config endpoint
+
 # 5.1.0 - 2025-06-12
 
 1. chore: use `/flags?v=2&config=true` instead of `/decide?v=4` for the flag evaluation backend

package/lib/edge/index.cjs

@@ -877,7 +877,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
     };
@@ -887,14 +887,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;
@@ -908,7 +908,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);
@@ -928,14 +930,14 @@ 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);
   });
 }
 
-var version = "5.1.0";
+var version = "5.2.1";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -973,6 +975,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";
@@ -3164,7 +3172,24 @@ class PostHogBackendClient extends PostHogCoreStateless {
     return response;
   }
   async getRemoteConfigPayload(flagKey) {
-    return (await this.featureFlagsPoller?._requestRemoteConfigPayload(flagKey))?.json();
+    const response = await this.featureFlagsPoller?._requestRemoteConfigPayload(flagKey);
+    if (!response) {
+      return undefined;
+    }
+    const parsed = await response.json();
+    // The payload from the endpoint is stored as a JSON encoded string. So when we return
+    // it, it's effectively double encoded. As far as we know, we should never get single-encoded
+    // JSON, but we'll be defensive here just in case.
+    if (typeof parsed === 'string') {
+      try {
+        // If the parsed value is a string, try parsing it again to handle double-encoded JSON
+        return JSON.parse(parsed);
+      } catch (e) {
+        // If second parse fails, return the string as is
+        return parsed;
+      }
+    }
+    return parsed;
   }
   async isFeatureEnabled(key, distinctId, options) {
     const feat = await this.getFeatureFlag(key, distinctId, options);
@@ -3262,9 +3287,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);
   }
 }