posthog-js-lite 3.3.0 → 3.4.1

package/lib/index.d.ts

@@ -320,9 +320,22 @@ declare abstract class PostHogCore extends PostHogCoreStateless {
     /***
      *** ERROR TRACKING
      ***/
-    captureException(error: Error, additionalProperties?: {
+    captureException(error: unknown, 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

@@ -62,6 +62,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;
 }
@@ -1486,6 +1489,7 @@ class PostHogCore extends PostHogCoreStateless {
                     this.setPersistedProperty(PostHogPersistedProperty[key], null);
                 }
             }
+            this.reloadFeatureFlags();
         });
     }
     getCommonEventProperties() {
@@ -1761,6 +1765,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 };
@@ -1922,8 +1927,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,
@@ -1935,9 +1940,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 = {};