posthog-js-lite 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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

package/README.md

@@ -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 };
@@ -1939,9 +1941,33 @@ class PostHogCore extends PostHogCoreStateless {
         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.3.0";
+var version = "3.4.0";
 
 function getContext(window) {
   let context = {};