posthog-node 4.5.2 → 4.7.0

package/lib/posthog-core/src/index.d.ts

@@ -189,6 +189,19 @@ export declare abstract class PostHogCore extends PostHogCoreStateless {
     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;
 }
 export * from './types';
 export { LZString };

package/lib/posthog-node/src/feature-flags.d.ts

@@ -58,8 +58,10 @@ declare class FeatureFlagsPoller {
     }[];
     loadFeatureFlags(forceReload?: boolean): Promise<void>;
     _loadFeatureFlags(): Promise<void>;
+    private getPersonalApiKeyRequestOptions;
     _requestFeatureFlagDefinitions(): Promise<PostHogFetchResponse>;
     stopPoller(): void;
+    _requestRemoteConfigPayload(flagKey: string): Promise<PostHogFetchResponse>;
 }
 declare function matchProperty(property: FeatureFlagCondition['properties'][number], propertyValues: Record<string, any>, warnFunction?: (msg: string) => void): boolean;
 declare function relativeDateParseForFeatureFlagMatching(value: string): Date | null;

package/lib/posthog-node/src/posthog-node.d.ts

@@ -50,6 +50,7 @@ export declare class PostHog extends PostHogCoreStateless implements PostHogNode
         sendFeatureFlagEvents?: boolean;
         disableGeoip?: boolean;
     }): Promise<JsonType | undefined>;
+    getRemoteConfigPayload(flagKey: string): Promise<JsonType | undefined>;
     isFeatureEnabled(key: string, distinctId: string, options?: {
         groups?: Record<string, string>;
         personProperties?: Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posthog-node",
-  "version": "4.5.2",
+  "version": "4.7.0",
   "description": "PostHog Node.js integration",
   "repository": {
     "type": "git",

package/src/feature-flags.ts

@@ -419,17 +419,21 @@ class FeatureFlagsPoller {
     }
   }
 
-  async _requestFeatureFlagDefinitions(): Promise<PostHogFetchResponse> {
-    const url = `${this.host}/api/feature_flag/local_evaluation?token=${this.projectApiKey}&send_cohorts`
-
-    const options: PostHogFetchOptions = {
-      method: 'GET',
+  private getPersonalApiKeyRequestOptions(method: 'GET' | 'POST' | 'PUT' | 'PATCH' = 'GET'): PostHogFetchOptions {
+    return {
+      method,
       headers: {
         ...this.customHeaders,
         'Content-Type': 'application/json',
         Authorization: `Bearer ${this.personalApiKey}`,
       },
     }
+  }
+
+  async _requestFeatureFlagDefinitions(): Promise<PostHogFetchResponse> {
+    const url = `${this.host}/api/feature_flag/local_evaluation?token=${this.projectApiKey}&send_cohorts`
+
+    const options = this.getPersonalApiKeyRequestOptions()
 
     let abortTimeout = null
 
@@ -451,6 +455,26 @@ class FeatureFlagsPoller {
   stopPoller(): void {
     clearTimeout(this.poller)
   }
+
+  _requestRemoteConfigPayload(flagKey: string): Promise<PostHogFetchResponse> {
+    const url = `${this.host}/api/projects/@current/feature_flags/${flagKey}/remote_config/`
+
+    const options = this.getPersonalApiKeyRequestOptions()
+
+    let abortTimeout = null
+    if (this.timeout && typeof this.timeout === 'number') {
+      const controller = new AbortController()
+      abortTimeout = safeSetTimeout(() => {
+        controller.abort()
+      }, this.timeout)
+      options.signal = controller.signal
+    }
+    try {
+      return this.fetch(url, options)
+    } finally {
+      clearTimeout(abortTimeout)
+    }
+  }
 }
 
 // # This function takes a distinct_id and a feature flag key and returns a float between 0 and 1.

package/src/posthog-node.ts

@@ -359,6 +359,10 @@ export class PostHog extends PostHogCoreStateless implements PostHogNodeV1 {
     return response
   }
 
+  async getRemoteConfigPayload(flagKey: string): Promise<JsonType | undefined> {
+    return (await this.featureFlagsPoller?._requestRemoteConfigPayload(flagKey))?.json()
+  }
+
   async isFeatureEnabled(
     key: string,
     distinctId: string,