posthog-js-lite 3.2.1 → 3.4.0

package/lib/index.d.ts

@@ -317,6 +317,25 @@ declare abstract class PostHogCore extends PostHogCoreStateless {
     onFeatureFlags(cb: (flags: PostHogDecideResponse['featureFlags']) => void): () => void;
     onFeatureFlag(key: string, cb: (value: string | boolean) => void): () => void;
     overrideFeatureFlag(flags: PostHogDecideResponse['featureFlags'] | null): Promise<void>;
+    /***
+     *** ERROR TRACKING
+     ***/
+    captureException(error: Error, additionalProperties?: {
+        [key: string]: any;
+    }): void;
+    /**
+     * 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: string | number, userFeedback: string): void;
+    /**
+     * 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: string | number, metricName: string, metricValue: string | number | boolean): void;
 }
 
 type PostHogOptions = {

package/lib/index.esm.js

@@ -1486,6 +1486,7 @@ class PostHogCore extends PostHogCoreStateless {
                     this.setPersistedProperty(PostHogPersistedProperty[key], null);
                 }
             }
+            this.reloadFeatureFlags();
         });
     }
     getCommonEventProperties() {
@@ -1761,6 +1762,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 };
@@ -1914,9 +1916,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 = {};