posthog-js-lite 3.3.0 → 3.4.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Next
 
+# 3.4.1 - 2025-02-20
+
+## Fixed
+
+1. fix: handle cases when non Error is passed to `captureException`
+
+# 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

@@ -66,6 +66,9 @@ function safeSetTimeout(fn, timeout) {
     t?.unref && t?.unref();
     return t;
 }
+const isError = (x) => {
+    return x instanceof Error;
+};
 function getFetch() {
     return typeof fetch !== 'undefined' ? fetch : typeof global.fetch !== 'undefined' ? global.fetch : undefined;
 }
@@ -1490,6 +1493,7 @@ class PostHogCore extends PostHogCoreStateless {
                     this.setPersistedProperty(PostHogPersistedProperty[key], null);
                 }
             }
+            this.reloadFeatureFlags();
         });
     }
     getCommonEventProperties() {
@@ -1765,6 +1769,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 };
@@ -1926,8 +1931,8 @@ class PostHogCore extends PostHogCoreStateless {
             $exception_level: 'error',
             $exception_list: [
                 {
-                    type: error.name,
-                    value: error.message,
+                    type: isError(error) ? error.name : 'Error',
+                    value: isError(error) ? error.message : error,
                     mechanism: {
                         handled: true,
                         synthetic: false,
@@ -1939,9 +1944,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.1";
 
 function getContext(window) {
   let context = {};