@posthog/browser-common 0.10.5 → 0.10.7

package/dist/autocapture.js

@@ -90,7 +90,7 @@ function isInputValueEligible(target, config) {
     }
     return true;
 }
-const logger = (0, logger_js_namespaceObject.createLogger)('[AutoCapture]');
+const logger = /* @__PURE__ */ (0, logger_js_namespaceObject.createLogger)('[AutoCapture]');
 function limitText(length, text) {
     if (text.length > length) return text.slice(0, length) + '...';
     return text;

package/dist/autocapture.mjs

@@ -42,7 +42,7 @@ function isInputValueEligible(target, config) {
     }
     return true;
 }
-const logger = createLogger('[AutoCapture]');
+const logger = /* @__PURE__ */ createLogger('[AutoCapture]');
 function limitText(length, text) {
     if (text.length > length) return text.slice(0, length) + '...';
     return text;

package/dist/client.d.ts

@@ -108,8 +108,14 @@ export interface Client {
     readonly isOptedOut: boolean;
     /** Whether the host currently permits data capture. */
     readonly canCapture: boolean;
-    /** Synchronously admits an analytics event to the client's normal pipeline. */
-    capture(event: string, properties?: Properties | null, options?: CaptureOptions): void;
+    /** Whether the client rate limit drops an event captured now. Reading it must not use a token. */
+    readonly isRateLimited?: boolean;
+    /**
+     * Synchronously admits an analytics event to the client's normal pipeline.
+     * Returns `false` when the client rate limit dropped the event, so the caller can send it again later.
+     * An event that is dropped for another reason, for example by `before_send`, returns `true`.
+     */
+    capture(event: string, properties?: Properties | null, options?: CaptureOptions): boolean;
     /** Registers a synchronous producer of properties merged into every captured event. */
     registerDynamicEventProperties(producer: () => Record<string, unknown>): Disposable;
     /** Returns the extension registered under a typed stable name, or `undefined` when it is not installed. */

package/dist/config.js

@@ -27,7 +27,7 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
-const packageVersion = "0.10.5";
+const packageVersion = "0.10.7";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/config.mjs

@@ -1,4 +1,4 @@
-const packageVersion = "0.10.5";
+const packageVersion = "0.10.7";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/feature-flags.d.ts

@@ -228,7 +228,11 @@ export declare class PostHogFeatureFlags implements Extension {
      * @returns {FeatureFlagResult | undefined} The feature flag result including key, enabled, variant, and payload.
      */
     getFeatureFlagResult(key: string, options?: FeatureFlagOptions): FeatureFlagResult | undefined;
+    /** Returns `false` when the client rate limit dropped the event. */
     private _captureFeatureFlagCalled;
+    private _holdFlagCall;
+    private _flagCallContext;
+    private _unmarkFlagCallReported;
     getRemoteConfigPayload(key: string, callback: RemoteConfigFeatureFlagCallback): void;
     private _getRemoteConfigPayload;
     /**

package/dist/feature-flags.js

@@ -41,8 +41,8 @@ const logger_js_namespaceObject = require("./utils/logger.js");
 const timezone_js_namespaceObject = require("./utils/timezone.js");
 const promise_utils_js_namespaceObject = require("./utils/promise-utils.js");
 const request_reachability_js_namespaceObject = require("./utils/request-reachability.js");
-const logger = (0, logger_js_namespaceObject.createLogger)('[FeatureFlags]');
-const forceDebugLogger = (0, logger_js_namespaceObject.createLogger)('[FeatureFlags]', {
+const logger = /* @__PURE__ */ (0, logger_js_namespaceObject.createLogger)('[FeatureFlags]');
+const forceDebugLogger = /* @__PURE__ */ (0, logger_js_namespaceObject.createLogger)('[FeatureFlags]', {
     debugEnabled: true
 });
 const FLAG_TIMEOUT_MSG = '" failed. Feature flags didn\'t load in time.';
@@ -190,6 +190,11 @@ const QuotaLimitedResource = {
     FeatureFlags: 'feature_flags',
     Recordings: 'recordings'
 };
+const haveSameGroups = (a, b)=>{
+    const keys = Object.keys(a);
+    return keys.length === Object.keys(b).length && keys.every((key)=>a[key] === b[key]);
+};
+const isSameFlagCallContext = (a, b)=>a.distinctId === b.distinctId && a.sessionId === b.sessionId && haveSameGroups(a.groups, b.groups);
 class PostHogFeatureFlags {
     constructor(configSource){
         this.name = 'featureFlags';
@@ -655,13 +660,21 @@ class PostHogFeatureFlags {
         this._flagCallsPendingCapture = new Map();
     }
     sendFlagCallsPendingCapture() {
-        if (0 === this._flagCallsPendingCapture.size || this._sendingFlagCallsPendingCapture || !this._client?.canCapture) return;
+        if (0 === this._flagCallsPendingCapture.size || this._sendingFlagCallsPendingCapture || !this._client?.canCapture || this._client.isRateLimited) return;
         this._sendingFlagCallsPendingCapture = true;
         try {
-            this._flagCallsPendingCapture.forEach((readBy, key)=>{
-                if (readBy === this._client?.distinctId) this.getFeatureFlagResult(key);
-                else this._flagCallsPendingCapture.delete(key);
-            });
+            const flagVariants = this.getFlagVariants();
+            for (const key of Array.from(this._flagCallsPendingCapture.keys())){
+                const pending = this._flagCallsPendingCapture.get(key);
+                if (pending) {
+                    if (pending.value !== String(flagVariants[key]) || !isSameFlagCallContext(pending.context, this._flagCallContext())) {
+                        this._flagCallsPendingCapture.delete(key);
+                        continue;
+                    }
+                    this.getFeatureFlagResult(key);
+                    if (this._flagCallsPendingCapture.has(key)) break;
+                }
+            }
         } finally{
             this._sendingFlagCallsPendingCapture = false;
         }
@@ -827,16 +840,17 @@ class PostHogFeatureFlags {
                 [external_constants_js_namespaceObject.FLAG_CALL_REPORTED_SESSION_ID]: sessionIdToPersist
             });
         } else {
-            const canCapture = this._client?.canCapture;
+            const captureOff = !this._client?.canCapture;
+            const canCapture = !captureOff && !this._client?.isRateLimited;
             if (canCapture) this._flagCallsPendingCapture.delete(key);
             else {
-                if (Object.keys(flagCallReported).length > 0) {
+                if (captureOff && Object.keys(flagCallReported).length > 0) {
                     flagCallReported = {};
                     this._set({
                         [external_constants_js_namespaceObject.FLAG_CALL_REPORTED]: flagCallReported
                     });
                 }
-                this._flagCallsPendingCapture.set(key, this._client?.distinctId);
+                if (!flagCallReported[key]?.includes(flagReportValue)) this._holdFlagCall(key, flagReportValue);
             }
             if (canCapture && !flagCallReported[key]?.includes(flagReportValue)) {
                 if ((0, core_namespaceObject.isArray)(flagCallReported[key])) flagCallReported[key].push(flagReportValue);
@@ -872,7 +886,10 @@ class PostHogFeatureFlags {
                 if (!(0, core_namespaceObject.isUndefined)(flagDetails?.original_variant) || !(0, core_namespaceObject.isUndefined)(flagDetails?.original_enabled)) properties.$feature_flag_original_response = (0, core_namespaceObject.isUndefined)(flagDetails.original_variant) ? flagDetails.original_enabled : flagDetails.original_variant;
                 if (flagDetails?.metadata?.original_payload) properties.$feature_flag_original_payload = flagDetails?.metadata?.original_payload;
                 if (errors.length) properties.$feature_flag_error = errors.join(',');
-                this._captureFeatureFlagCalled(properties);
+                if (!this._captureFeatureFlagCalled(properties)) {
+                    this._unmarkFlagCallReported(key, flagReportValue);
+                    this._holdFlagCall(key, flagReportValue);
+                }
             } else if (sessionIdToPersist) this._set({
                 [external_constants_js_namespaceObject.FLAG_CALL_REPORTED]: flagCallReported,
                 [external_constants_js_namespaceObject.FLAG_CALL_REPORTED_SESSION_ID]: sessionIdToPersist
@@ -888,11 +905,36 @@ class PostHogFeatureFlags {
     }
     _captureFeatureFlagCalled(properties) {
         try {
-            this._client?.capture('$feature_flag_called', properties);
+            return this._client?.capture('$feature_flag_called', properties) !== false;
         } catch (error) {
             this._logger.error('Failed to capture feature flag call', error);
+            return true;
         }
     }
+    _holdFlagCall(key, value) {
+        this._flagCallsPendingCapture.set(key, {
+            value,
+            context: this._flagCallContext()
+        });
+    }
+    _flagCallContext() {
+        return {
+            distinctId: this._client?.distinctId,
+            groups: {
+                ...this._client?.groups
+            },
+            sessionId: this._config.deduplicateCallsPerSession ? this._client?.session?.sessionId : void 0
+        };
+    }
+    _unmarkFlagCallReported(key, flagReportValue) {
+        const flagCallReported = this._prop(external_constants_js_namespaceObject.FLAG_CALL_REPORTED) || {};
+        const reportedValues = flagCallReported[key];
+        if (!(0, core_namespaceObject.isArray)(reportedValues) || !reportedValues.includes(flagReportValue)) return;
+        flagCallReported[key] = reportedValues.filter((value)=>value !== flagReportValue);
+        this._set({
+            [external_constants_js_namespaceObject.FLAG_CALL_REPORTED]: flagCallReported
+        });
+    }
     getRemoteConfigPayload(key, callback) {
         this._getRemoteConfigPayload(key, callback);
     }

package/dist/feature-flags.mjs

@@ -5,8 +5,8 @@ import { createLogger } from "./utils/logger.mjs";
 import { getTimezone } from "./utils/timezone.mjs";
 import { continueWith } from "./utils/promise-utils.mjs";
 import { isStatusZeroFailureCircuitBreakerTripped, updateStatusZeroFailureCount } from "./utils/request-reachability.mjs";
-const logger = createLogger('[FeatureFlags]');
-const forceDebugLogger = createLogger('[FeatureFlags]', {
+const logger = /* @__PURE__ */ createLogger('[FeatureFlags]');
+const forceDebugLogger = /* @__PURE__ */ createLogger('[FeatureFlags]', {
     debugEnabled: true
 });
 const FLAG_TIMEOUT_MSG = '" failed. Feature flags didn\'t load in time.';
@@ -154,6 +154,11 @@ const QuotaLimitedResource = {
     FeatureFlags: 'feature_flags',
     Recordings: 'recordings'
 };
+const haveSameGroups = (a, b)=>{
+    const keys = Object.keys(a);
+    return keys.length === Object.keys(b).length && keys.every((key)=>a[key] === b[key]);
+};
+const isSameFlagCallContext = (a, b)=>a.distinctId === b.distinctId && a.sessionId === b.sessionId && haveSameGroups(a.groups, b.groups);
 class PostHogFeatureFlags {
     constructor(configSource){
         this.name = 'featureFlags';
@@ -619,13 +624,21 @@ class PostHogFeatureFlags {
         this._flagCallsPendingCapture = new Map();
     }
     sendFlagCallsPendingCapture() {
-        if (0 === this._flagCallsPendingCapture.size || this._sendingFlagCallsPendingCapture || !this._client?.canCapture) return;
+        if (0 === this._flagCallsPendingCapture.size || this._sendingFlagCallsPendingCapture || !this._client?.canCapture || this._client.isRateLimited) return;
         this._sendingFlagCallsPendingCapture = true;
         try {
-            this._flagCallsPendingCapture.forEach((readBy, key)=>{
-                if (readBy === this._client?.distinctId) this.getFeatureFlagResult(key);
-                else this._flagCallsPendingCapture.delete(key);
-            });
+            const flagVariants = this.getFlagVariants();
+            for (const key of Array.from(this._flagCallsPendingCapture.keys())){
+                const pending = this._flagCallsPendingCapture.get(key);
+                if (pending) {
+                    if (pending.value !== String(flagVariants[key]) || !isSameFlagCallContext(pending.context, this._flagCallContext())) {
+                        this._flagCallsPendingCapture.delete(key);
+                        continue;
+                    }
+                    this.getFeatureFlagResult(key);
+                    if (this._flagCallsPendingCapture.has(key)) break;
+                }
+            }
         } finally{
             this._sendingFlagCallsPendingCapture = false;
         }
@@ -791,16 +804,17 @@ class PostHogFeatureFlags {
                 [FLAG_CALL_REPORTED_SESSION_ID]: sessionIdToPersist
             });
         } else {
-            const canCapture = this._client?.canCapture;
+            const captureOff = !this._client?.canCapture;
+            const canCapture = !captureOff && !this._client?.isRateLimited;
             if (canCapture) this._flagCallsPendingCapture.delete(key);
             else {
-                if (Object.keys(flagCallReported).length > 0) {
+                if (captureOff && Object.keys(flagCallReported).length > 0) {
                     flagCallReported = {};
                     this._set({
                         [FLAG_CALL_REPORTED]: flagCallReported
                     });
                 }
-                this._flagCallsPendingCapture.set(key, this._client?.distinctId);
+                if (!flagCallReported[key]?.includes(flagReportValue)) this._holdFlagCall(key, flagReportValue);
             }
             if (canCapture && !flagCallReported[key]?.includes(flagReportValue)) {
                 if (isArray(flagCallReported[key])) flagCallReported[key].push(flagReportValue);
@@ -836,7 +850,10 @@ class PostHogFeatureFlags {
                 if (!isUndefined(flagDetails?.original_variant) || !isUndefined(flagDetails?.original_enabled)) properties.$feature_flag_original_response = isUndefined(flagDetails.original_variant) ? flagDetails.original_enabled : flagDetails.original_variant;
                 if (flagDetails?.metadata?.original_payload) properties.$feature_flag_original_payload = flagDetails?.metadata?.original_payload;
                 if (errors.length) properties.$feature_flag_error = errors.join(',');
-                this._captureFeatureFlagCalled(properties);
+                if (!this._captureFeatureFlagCalled(properties)) {
+                    this._unmarkFlagCallReported(key, flagReportValue);
+                    this._holdFlagCall(key, flagReportValue);
+                }
             } else if (sessionIdToPersist) this._set({
                 [FLAG_CALL_REPORTED]: flagCallReported,
                 [FLAG_CALL_REPORTED_SESSION_ID]: sessionIdToPersist
@@ -852,11 +869,36 @@ class PostHogFeatureFlags {
     }
     _captureFeatureFlagCalled(properties) {
         try {
-            this._client?.capture('$feature_flag_called', properties);
+            return this._client?.capture('$feature_flag_called', properties) !== false;
         } catch (error) {
             this._logger.error('Failed to capture feature flag call', error);
+            return true;
         }
     }
+    _holdFlagCall(key, value) {
+        this._flagCallsPendingCapture.set(key, {
+            value,
+            context: this._flagCallContext()
+        });
+    }
+    _flagCallContext() {
+        return {
+            distinctId: this._client?.distinctId,
+            groups: {
+                ...this._client?.groups
+            },
+            sessionId: this._config.deduplicateCallsPerSession ? this._client?.session?.sessionId : void 0
+        };
+    }
+    _unmarkFlagCallReported(key, flagReportValue) {
+        const flagCallReported = this._prop(FLAG_CALL_REPORTED) || {};
+        const reportedValues = flagCallReported[key];
+        if (!isArray(reportedValues) || !reportedValues.includes(flagReportValue)) return;
+        flagCallReported[key] = reportedValues.filter((value)=>value !== flagReportValue);
+        this._set({
+            [FLAG_CALL_REPORTED]: flagCallReported
+        });
+    }
     getRemoteConfigPayload(key, callback) {
         this._getRemoteConfigPayload(key, callback);
     }

package/dist/utils/autocapture-utils.js

@@ -149,14 +149,14 @@ const DEFAULT_CONTENT_IGNORELIST = [
     '❯',
     '❮'
 ];
-const DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS = [
-    ...DEFAULT_CONTENT_IGNORELIST,
-    '+',
-    '-',
-    '−',
-    '–'
-];
-const MAX_CONTENT_IGNORELIST_ENTRIES = DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS.length + 10;
+const DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS = /* @__PURE__ */ (()=>[
+        ...DEFAULT_CONTENT_IGNORELIST,
+        '+',
+        '-',
+        '−',
+        '–'
+    ])();
+const MAX_CONTENT_IGNORELIST_ENTRIES = /* @__PURE__ */ (()=>DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS.length + 10)();
 const INTERACTIVE_TAGS = [
     'button',
     'a',

package/dist/utils/autocapture-utils.mjs

@@ -95,14 +95,14 @@ const DEFAULT_CONTENT_IGNORELIST = [
     '❯',
     '❮'
 ];
-const DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS = [
-    ...DEFAULT_CONTENT_IGNORELIST,
-    '+',
-    '-',
-    '−',
-    '–'
-];
-const MAX_CONTENT_IGNORELIST_ENTRIES = DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS.length + 10;
+const DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS = /* @__PURE__ */ (()=>[
+        ...DEFAULT_CONTENT_IGNORELIST,
+        '+',
+        '-',
+        '−',
+        '–'
+    ])();
+const MAX_CONTENT_IGNORELIST_ENTRIES = /* @__PURE__ */ (()=>DEFAULT_CONTENT_IGNORELIST_WITH_STEPPERS.length + 10)();
 const INTERACTIVE_TAGS = [
     'button',
     'a',

package/dist/utils/event-utils.js

@@ -88,16 +88,16 @@ const PERSONAL_DATA_CAMPAIGN_PARAMS = [
     'irclid',
     '_kx'
 ];
-const CAMPAIGN_PARAMS = [
-    'utm_source',
-    'utm_medium',
-    'utm_campaign',
-    'utm_content',
-    'utm_term',
-    'gad_source',
-    'mc_cid',
-    ...PERSONAL_DATA_CAMPAIGN_PARAMS
-];
+const CAMPAIGN_PARAMS = /* @__PURE__ */ (()=>[
+        'utm_source',
+        'utm_medium',
+        'utm_campaign',
+        'utm_content',
+        'utm_term',
+        'gad_source',
+        'mc_cid',
+        ...PERSONAL_DATA_CAMPAIGN_PARAMS
+    ])();
 const EVENT_TO_PERSON_PROPERTIES = [
     '$app_build',
     '$app_name',

package/dist/utils/event-utils.mjs

@@ -28,16 +28,16 @@ const PERSONAL_DATA_CAMPAIGN_PARAMS = [
     'irclid',
     '_kx'
 ];
-const CAMPAIGN_PARAMS = [
-    'utm_source',
-    'utm_medium',
-    'utm_campaign',
-    'utm_content',
-    'utm_term',
-    'gad_source',
-    'mc_cid',
-    ...PERSONAL_DATA_CAMPAIGN_PARAMS
-];
+const CAMPAIGN_PARAMS = /* @__PURE__ */ (()=>[
+        'utm_source',
+        'utm_medium',
+        'utm_campaign',
+        'utm_content',
+        'utm_term',
+        'gad_source',
+        'mc_cid',
+        ...PERSONAL_DATA_CAMPAIGN_PARAMS
+    ])();
 const EVENT_TO_PERSON_PROPERTIES = [
     '$app_build',
     '$app_name',

package/dist/utils/logger.js

@@ -79,8 +79,8 @@ const _createLogger = (prefix, { debugEnabled } = {})=>{
     };
     return logger;
 };
-const logger_logger = _createLogger('[PostHog.js]');
-const createLogger = logger_logger.createLogger;
+const logger_logger = /* @__PURE__ */ _createLogger('[PostHog.js]');
+const createLogger = (prefix, options)=>logger_logger.createLogger(prefix, options);
 exports.createLogger = __webpack_exports__.createLogger;
 exports.logger = __webpack_exports__.logger;
 for(var __rspack_i in __webpack_exports__)if (-1 === [

package/dist/utils/logger.mjs

@@ -36,6 +36,6 @@ const _createLogger = (prefix, { debugEnabled } = {})=>{
     };
     return logger;
 };
-const logger_logger = _createLogger('[PostHog.js]');
-const createLogger = logger_logger.createLogger;
+const logger_logger = /* @__PURE__ */ _createLogger('[PostHog.js]');
+const createLogger = (prefix, options)=>logger_logger.createLogger(prefix, options);
 export { createLogger, logger_logger as logger };

package/dist/utils/survey-utils.js

@@ -48,7 +48,7 @@ __webpack_require__.d(__webpack_exports__, {
 const surveys_namespaceObject = require("@posthog/core/surveys");
 const external_survey_constants_js_namespaceObject = require("../survey-constants.js");
 const external_logger_js_namespaceObject = require("./logger.js");
-const SURVEY_LOGGER = (0, external_logger_js_namespaceObject.createLogger)('[Surveys]');
+const SURVEY_LOGGER = /* @__PURE__ */ (0, external_logger_js_namespaceObject.createLogger)('[Surveys]');
 const SURVEY_CAPTURING_DISABLED = 'PostHog is not capturing, so a survey response cannot be recorded';
 function isSurveyRunning(survey) {
     return !!(survey.start_date && !survey.end_date);

package/dist/utils/survey-utils.mjs

@@ -1,7 +1,7 @@
 import { doesSurveyActivateByEvent, getSurveyInteractionProperty, getSurveyIterationKey, isSurveyIterationBased } from "@posthog/core/surveys";
 import { DisplaySurveyType, SurveyType } from "../survey-constants.mjs";
 import { createLogger } from "./logger.mjs";
-const SURVEY_LOGGER = createLogger('[Surveys]');
+const SURVEY_LOGGER = /* @__PURE__ */ createLogger('[Surveys]');
 const SURVEY_CAPTURING_DISABLED = 'PostHog is not capturing, so a survey response cannot be recorded';
 function isSurveyRunning(survey) {
     return !!(survey.start_date && !survey.end_date);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/browser-common",
-  "version": "0.10.5",
+  "version": "0.10.7",
   "description": "Internal shared browser utilities and extension primitives for PostHog Browser SDKs",
   "license": "MIT",
   "repository": {
@@ -241,8 +241,8 @@
   "dependencies": {
     "dompurify": "^3.4.13",
     "preact": "^10.29.3",
-    "@posthog/core": "^1.63.1",
-    "@posthog/types": "^1.419.0"
+    "@posthog/core": "^1.63.2",
+    "@posthog/types": "^1.420.0"
   },
   "devDependencies": {
     "@rsbuild/plugin-react": "^2.1.0",