posthog-js-lite 3.4.1 → 3.4.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Next
 
+# 3.4.2 - 2025-02-27
+
+## Fixed
+
+1. Supports gracefully handling quotaLimited responses from the PostHog API for feature flags.
+
 # 3.4.1 - 2025-02-20
 
 ## Fixed

package/README.md

@@ -28,9 +28,9 @@ const posthog = new PostHog('my-api-key', {
 posthog.capture('my-event', { myProperty: 'foo' })
 
 // Identify a user (e.g. on login)
-posthog.identify('my-unique-user-id', { email: 'exampke@posthog.com', name: 'Jane Doe' })
+posthog.identify('my-unique-user-id', { email: 'example@posthog.com', name: 'Jane Doe' })
 // ...or with Set Once additional properties
-posthog.identify('my-unique-user-id', { $set: { email: 'exampke@posthog.com', name: 'Jane Doe' }, $set_once: { vip: true } })
+posthog.identify('my-unique-user-id', { $set: { email: 'example@posthog.com', name: 'Jane Doe' }, $set_once: { vip: true } })
 
 // Reset a user (e.g. on logout)
 posthog.reset()

package/lib/index.cjs.js

@@ -954,6 +954,11 @@ class PostHogFetchNetworkError extends Error {
 function isPostHogFetchError(err) {
     return typeof err === 'object' && (err instanceof PostHogFetchHttpError || err instanceof PostHogFetchNetworkError);
 }
+var QuotaLimitedFeature;
+(function (QuotaLimitedFeature) {
+    QuotaLimitedFeature["FeatureFlags"] = "feature_flags";
+    QuotaLimitedFeature["Recordings"] = "recordings";
+})(QuotaLimitedFeature || (QuotaLimitedFeature = {}));
 class PostHogCoreStateless {
     constructor(apiKey, options) {
         this.flushPromise = null;
@@ -1197,6 +1202,14 @@ class PostHogCoreStateless {
             extraPayload['geoip_disable'] = true;
         }
         const decideResponse = await this.getDecide(distinctId, groups, personProperties, groupProperties, extraPayload);
+        // Add check for quota limitation on feature flags
+        if (decideResponse?.quotaLimited?.includes(QuotaLimitedFeature.FeatureFlags)) {
+            console.warn('[FEATURE FLAGS] Feature flags quota limit exceeded - feature flags unavailable. Learn more about billing limits at https://posthog.com/docs/billing/limits-alerts');
+            return {
+                flags: undefined,
+                payloads: undefined,
+            };
+        }
         const flags = decideResponse?.featureFlags;
         const payloads = decideResponse?.featureFlagPayloads;
         let parsedPayloads = payloads;
@@ -1749,7 +1762,7 @@ class PostHogCore extends PostHogCoreStateless {
     }
     async _decideAsync(sendAnonDistinctId = true) {
         this._decideResponsePromise = this._initPromise
-            .then(() => {
+            .then(async () => {
             const distinctId = this.getDistinctId();
             const groups = this.props.$groups || {};
             const personProperties = this.getPersistedProperty(PostHogPersistedProperty.PersonProperties) || {};
@@ -1758,38 +1771,45 @@ class PostHogCore extends PostHogCoreStateless {
             const extraProperties = {
                 $anon_distinct_id: sendAnonDistinctId ? this.getAnonymousId() : undefined,
             };
-            return super.getDecide(distinctId, groups, personProperties, groupProperties, extraProperties).then((res) => {
-                if (res?.featureFlags) {
-                    // clear flag call reported if we have new flags since they might have changed
-                    if (this.sendFeatureFlagEvent) {
-                        this.flagCallReported = {};
-                    }
-                    let newFeatureFlags = res.featureFlags;
-                    let newFeatureFlagPayloads = res.featureFlagPayloads;
-                    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 };
-                    }
-                    this.setKnownFeatureFlags(newFeatureFlags);
-                    this.setKnownFeatureFlagPayloads(Object.fromEntries(Object.entries(newFeatureFlagPayloads || {}).map(([k, v]) => [k, this._parsePayload(v)])));
-                    // Mark that we hit the /decide endpoint so we can capture this in the $feature_flag_called event
-                    this.setPersistedProperty(PostHogPersistedProperty.DecideEndpointWasHit, true);
-                    const sessionReplay = res?.sessionRecording;
-                    if (sessionReplay) {
-                        this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, sessionReplay);
-                        this.logMsgIfDebug(() => console.log('PostHog Debug', 'Session replay config: ', JSON.stringify(sessionReplay)));
-                    }
-                    else {
-                        this.logMsgIfDebug(() => console.info('PostHog Debug', 'Session replay config disabled.'));
-                        this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, null);
-                    }
-                }
+            const res = await super.getDecide(distinctId, groups, personProperties, groupProperties, extraProperties);
+            // Add check for quota limitation on feature flags
+            if (res?.quotaLimited?.includes(QuotaLimitedFeature.FeatureFlags)) {
+                // Unset all feature flags by setting to null
+                this.setKnownFeatureFlags(null);
+                this.setKnownFeatureFlagPayloads(null);
+                console.warn('[FEATURE FLAGS] Feature flags quota limit exceeded - unsetting all flags. Learn more about billing limits at https://posthog.com/docs/billing/limits-alerts');
                 return res;
-            });
+            }
+            if (res?.featureFlags) {
+                // clear flag call reported if we have new flags since they might have changed
+                if (this.sendFeatureFlagEvent) {
+                    this.flagCallReported = {};
+                }
+                let newFeatureFlags = res.featureFlags;
+                let newFeatureFlagPayloads = res.featureFlagPayloads;
+                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 };
+                }
+                this.setKnownFeatureFlags(newFeatureFlags);
+                this.setKnownFeatureFlagPayloads(Object.fromEntries(Object.entries(newFeatureFlagPayloads || {}).map(([k, v]) => [k, this._parsePayload(v)])));
+                // Mark that we hit the /decide endpoint so we can capture this in the $feature_flag_called event
+                this.setPersistedProperty(PostHogPersistedProperty.DecideEndpointWasHit, true);
+                const sessionReplay = res?.sessionRecording;
+                if (sessionReplay) {
+                    this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, sessionReplay);
+                    this.logMsgIfDebug(() => console.log('PostHog Debug', 'Session replay config: ', JSON.stringify(sessionReplay)));
+                }
+                else {
+                    this.logMsgIfDebug(() => console.info('PostHog Debug', 'Session replay config disabled.'));
+                    this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, null);
+                }
+            }
+            return res;
         })
             .finally(() => {
             this._decideResponsePromise = undefined;
@@ -1970,7 +1990,7 @@ class PostHogCore extends PostHogCoreStateless {
     }
 }
 
-var version = "3.4.1";
+var version = "3.4.2";
 
 function getContext(window) {
   let context = {};