posthog-js-lite 3.2.1 → 3.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Next
 
+# 3.4.0 - 2025-02-20
+
+## Added
+
+1. Adds the ability to capture user feedback in LLM Observability using the `captureTraceFeedback` and `captureTraceMetric` methods.
+
+# 3.3.0 - 2025-02-06
+
+## Added
+
+1. Adds `captureException` function to allow manual capture of exceptions
+
 # 3.2.1 - 2025-01-17
 
 ## Fixed
@@ -12,13 +24,12 @@
 
 1. Add new debugging property `$feature_flag_bootstrapped_response`, `$feature_flag_bootstrapped_payload` and `$used_bootstrap_value` to `$feature_flag_called` event
 
-
 # 3.1.0 - 2024-11-21
 
 ## Changed
 
 1. chore: default `captureMode` changed to `json`.
-    1. To keep using the `form` mode, just set the `captureMode` option to `form` when initializing the PostHog client.
+   1. To keep using the `form` mode, just set the `captureMode` option to `form` when initializing the PostHog client.
 2. fix: identify method allows passing a $set_once object
 
 # 3.0.2 - 2024-06-15

package/README.md

@@ -2,7 +2,7 @@
 
 > 🚧 This is a reduced feature set package. Currently the only officially supported feature complete way of using PostHog on the web is [posthog-js](https://github.com/PostHog/posthog-js)
 
-This package is currently published to npm as [posthog-js-lite](https://www.npmjs.com/package/posthog-js-lite) and is a simplified version of the recommended and offically supported `posthog-js`.
+This package is currently published to npm as [posthog-js-lite](https://www.npmjs.com/package/posthog-js-lite) and is a simplified version of the recommended and officially supported `posthog-js`.
 
 You'd want to use this only if you're very conscious about package sizes, and this reduced feature set (only analytics and feature flags) works for your use case. The most common use case is in chrome extensions.
 
@@ -71,5 +71,5 @@ posthog.onFeatureFlag('my-feature-flag', (value) => {
 
 // Opt users in or out, persisting across sessions (default is they are opted in)
 posthog.optOut() // Will stop tracking
-posthog.optIn() // Will stop tracking
+posthog.optIn() // Will start tracking
 ```

package/lib/index.cjs.js

@@ -1490,6 +1490,7 @@ class PostHogCore extends PostHogCoreStateless {
                     this.setPersistedProperty(PostHogPersistedProperty[key], null);
                 }
             }
+            this.reloadFeatureFlags();
         });
     }
     getCommonEventProperties() {
@@ -1765,6 +1766,7 @@ class PostHogCore extends PostHogCoreStateless {
                     if (res.errorsWhileComputingFlags) {
                         // if not all flags were computed, we upsert flags instead of replacing them
                         const currentFlags = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlags);
+                        this.logMsgIfDebug(() => console.log('PostHog Debug', 'Cached feature flags: ', JSON.stringify(currentFlags)));
                         const currentFlagPayloads = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlagPayloads);
                         newFeatureFlags = { ...currentFlags, ...res.featureFlags };
                         newFeatureFlagPayloads = { ...currentFlagPayloads, ...res.featureFlagPayloads };
@@ -1918,9 +1920,54 @@ class PostHogCore extends PostHogCoreStateless {
             return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, flags);
         });
     }
+    /***
+     *** ERROR TRACKING
+     ***/
+    captureException(error, additionalProperties) {
+        const properties = {
+            $exception_level: 'error',
+            $exception_list: [
+                {
+                    type: error.name,
+                    value: error.message,
+                    mechanism: {
+                        handled: true,
+                        synthetic: false,
+                    },
+                },
+            ],
+            ...additionalProperties,
+        };
+        properties.$exception_personURL = new URL(`/project/${this.apiKey}/person/${this.getDistinctId()}`, this.host).toString();
+        this.capture('$exception', properties);
+    }
+    /**
+     * Capture written user feedback for a LLM trace. Numeric values are converted to strings.
+     * @param traceId The trace ID to capture feedback for.
+     * @param userFeedback The feedback to capture.
+     */
+    captureTraceFeedback(traceId, userFeedback) {
+        this.capture('$ai_feedback', {
+            $ai_feedback_text: userFeedback,
+            $ai_trace_id: String(traceId),
+        });
+    }
+    /**
+     * Capture a metric for a LLM trace. Numeric values are converted to strings.
+     * @param traceId The trace ID to capture the metric for.
+     * @param metricName The name of the metric to capture.
+     * @param metricValue The value of the metric to capture.
+     */
+    captureTraceMetric(traceId, metricName, metricValue) {
+        this.capture('$ai_metric', {
+            $ai_metric_name: metricName,
+            $ai_metric_value: String(metricValue),
+            $ai_trace_id: String(traceId),
+        });
+    }
 }
 
-var version = "3.2.1";
+var version = "3.4.0";
 
 function getContext(window) {
   let context = {};