posthog-js-lite 3.4.0 → 3.4.2

package/lib/index.d.ts

@@ -114,6 +114,7 @@ type PostHogDecideResponse = {
         [key: string]: JsonType;
     };
     errorsWhileComputingFlags: boolean;
+    quotaLimited?: string[];
     sessionRecording?: boolean | {
         [key: string]: JsonType;
     };
@@ -320,7 +321,7 @@ declare abstract class PostHogCore extends PostHogCoreStateless {
     /***
      *** ERROR TRACKING
      ***/
-    captureException(error: Error, additionalProperties?: {
+    captureException(error: unknown, additionalProperties?: {
         [key: string]: any;
     }): void;
     /**

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;
 }
@@ -947,6 +950,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;
@@ -1190,6 +1198,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;
@@ -1742,7 +1758,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) || {};
@@ -1751,38 +1767,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;
@@ -1924,8 +1947,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,
@@ -1963,7 +1986,7 @@ class PostHogCore extends PostHogCoreStateless {
     }
 }
 
-var version = "3.4.0";
+var version = "3.4.2";
 
 function getContext(window) {
   let context = {};