posthog-js 1.310.2 → 1.312.0

package/dist/src/page-view.d.ts

@@ -20,7 +20,11 @@ export declare class PageViewManager {
         pathname: string | undefined;
     };
     _instance: PostHog;
+    private _unsubscribeSessionId?;
     constructor(instance: PostHog);
+    private _setupSessionRotationHandler;
+    private _onSessionIdChange;
+    destroy(): void;
     doPageView(timestamp: Date, pageViewId?: string): PageViewEventProperties;
     doPageLeave(timestamp: Date): PageViewEventProperties;
     doEvent(): PageViewEventProperties;

package/dist/src/posthog-core.d.ts

@@ -470,6 +470,45 @@ export declare class PostHog {
      * @public
      */
     reloadFeatureFlags(): void;
+    /**
+     * Manually update feature flag values without making a network request.
+     *
+     * This is useful when you have feature flag values from an external source
+     * (e.g., server-side evaluation, edge middleware) and want to inject them
+     * into the client SDK.
+     *
+     * {@label Feature flags}
+     *
+     * @example
+     * ```js
+     * // Replace all flags with server-evaluated values
+     * posthog.updateFlags({
+     *   'my-flag': true,
+     *   'my-experiment': 'variant-a'
+     * })
+     *
+     * // Merge with existing flags (update only specified flags)
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   undefined,
+     *   { merge: true }
+     * )
+     *
+     * // With payloads
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   { 'my-flag': { some: 'data' } }
+     * )
+     * ```
+     *
+     * @param flags - An object mapping flag keys to their values (boolean or string variant)
+     * @param payloads - Optional object mapping flag keys to their JSON payloads
+     * @param options - Optional settings. Use `{ merge: true }` to merge with existing flags instead of replacing.
+     * @public
+     */
+    updateFlags(flags: Record<string, boolean | string>, payloads?: Record<string, JsonType>, options?: {
+        merge?: boolean;
+    }): void;
     /**
      * Opt the user in or out of an early access feature. [Learn more in the docs](/docs/feature-flags/early-access-feature-management#option-2-custom-implementation)
      *

package/dist/surveys-preview.d.ts

@@ -2757,7 +2757,11 @@ declare class PageViewManager {
         pathname: string | undefined;
     };
     _instance: PostHog;
+    private _unsubscribeSessionId?;
     constructor(instance: PostHog);
+    private _setupSessionRotationHandler;
+    private _onSessionIdChange;
+    destroy(): void;
     doPageView(timestamp: Date, pageViewId?: string): PageViewEventProperties;
     doPageLeave(timestamp: Date): PageViewEventProperties;
     doEvent(): PageViewEventProperties;
@@ -3970,6 +3974,45 @@ declare class PostHog {
      * @public
      */
     reloadFeatureFlags(): void;
+    /**
+     * Manually update feature flag values without making a network request.
+     *
+     * This is useful when you have feature flag values from an external source
+     * (e.g., server-side evaluation, edge middleware) and want to inject them
+     * into the client SDK.
+     *
+     * {@label Feature flags}
+     *
+     * @example
+     * ```js
+     * // Replace all flags with server-evaluated values
+     * posthog.updateFlags({
+     *   'my-flag': true,
+     *   'my-experiment': 'variant-a'
+     * })
+     *
+     * // Merge with existing flags (update only specified flags)
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   undefined,
+     *   { merge: true }
+     * )
+     *
+     * // With payloads
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   { 'my-flag': { some: 'data' } }
+     * )
+     * ```
+     *
+     * @param flags - An object mapping flag keys to their values (boolean or string variant)
+     * @param payloads - Optional object mapping flag keys to their JSON payloads
+     * @param options - Optional settings. Use `{ merge: true }` to merge with existing flags instead of replacing.
+     * @public
+     */
+    updateFlags(flags: Record<string, boolean | string>, payloads?: Record<string, JsonType>, options?: {
+        merge?: boolean;
+    }): void;
     /**
      * Opt the user in or out of an early access feature. [Learn more in the docs](/docs/feature-flags/early-access-feature-management#option-2-custom-implementation)
      *

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "posthog-js",
-    "version": "1.310.2",
+    "version": "1.312.0",
     "description": "Posthog-js allows you to automatically capture usage and send events to PostHog.",
     "repository": "https://github.com/PostHog/posthog-js",
     "author": "hey@posthog.com",

package/lib/src/page-view.d.ts

@@ -20,7 +20,11 @@ export declare class PageViewManager {
         pathname: string | undefined;
     };
     _instance: PostHog;
+    private _unsubscribeSessionId?;
     constructor(instance: PostHog);
+    private _setupSessionRotationHandler;
+    private _onSessionIdChange;
+    destroy(): void;
     doPageView(timestamp: Date, pageViewId?: string): PageViewEventProperties;
     doPageLeave(timestamp: Date): PageViewEventProperties;
     doEvent(): PageViewEventProperties;

package/lib/src/page-view.js

@@ -14,8 +14,37 @@ var logger_1 = require("./utils/logger");
 // event name is $pageview or $pageleave and where $prev_pageview_id matches the original pageview event's id.
 var PageViewManager = /** @class */ (function () {
     function PageViewManager(instance) {
+        var _this = this;
+        this._onSessionIdChange = function (sessionId, _windowId, changeReason) {
+            // Only act on actual session rotations, not initial session creation
+            if (!changeReason) {
+                return;
+            }
+            // Clear state when session changes for any of these reasons:
+            // - noSessionId: after posthog.reset() or forced idle reset
+            // - activityTimeout: 30 min idle (default, configurable up to 10 hours)
+            // - sessionPastMaximumLength: 24 hour max session
+            if (changeReason.noSessionId || changeReason.activityTimeout || changeReason.sessionPastMaximumLength) {
+                logger_1.logger.info('[PageViewManager] Session rotated, clearing pageview state', {
+                    sessionId: sessionId,
+                    changeReason: changeReason,
+                });
+                _this._currentPageview = undefined;
+                _this._instance.scrollManager.resetContext();
+            }
+        };
         this._instance = instance;
+        this._setupSessionRotationHandler();
     }
+    PageViewManager.prototype._setupSessionRotationHandler = function () {
+        var _a;
+        this._unsubscribeSessionId = (_a = this._instance.sessionManager) === null || _a === void 0 ? void 0 : _a.onSessionId(this._onSessionIdChange);
+    };
+    PageViewManager.prototype.destroy = function () {
+        var _a;
+        (_a = this._unsubscribeSessionId) === null || _a === void 0 ? void 0 : _a.call(this);
+        this._unsubscribeSessionId = undefined;
+    };
     PageViewManager.prototype.doPageView = function (timestamp, pageViewId) {
         var _a;
         var response = this._previousPageViewProperties(timestamp, pageViewId);

package/lib/src/page-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-view.js","sourceRoot":"","sources":["../../src/page-view.ts"],"names":[],"mappings":"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","sourcesContent":["import { window } from './utils/globals'\nimport { PostHog } from './posthog-core'\nimport { clampToRange, isUndefined } from '@posthog/core'\nimport { extend } from './utils'\nimport { logger } from './utils/logger'\n\ninterface PageViewEventProperties {\n    $pageview_id?: string\n    $prev_pageview_id?: string\n    $prev_pageview_pathname?: string\n    $prev_pageview_duration?: number // seconds\n    $prev_pageview_last_scroll?: number\n    $prev_pageview_last_scroll_percentage?: number\n    $prev_pageview_max_scroll?: number\n    $prev_pageview_max_scroll_percentage?: number\n    $prev_pageview_last_content?: number\n    $prev_pageview_last_content_percentage?: number\n    $prev_pageview_max_content?: number\n    $prev_pageview_max_content_percentage?: number\n}\n\n// This keeps track of the PageView state (such as the previous PageView's path, timestamp, id, and scroll properties).\n// We store the state in memory, which means that for non-SPA sites, the state will be lost on page reload. This means\n// that non-SPA sites should always send a $pageleave event on any navigation, before the page unloads. For SPA sites,\n// they only need to send a $pageleave event when the user navigates away from the site, as the information is not lost\n// on an internal navigation, and is included as the $prev_pageview_ properties in the next $pageview event.\n\n// Practically, this means that to find the scroll properties for a given pageview, you need to find the event where\n// event name is $pageview or $pageleave and where $prev_pageview_id matches the original pageview event's id.\n\nexport class PageViewManager {\n    _currentPageview?: { timestamp: Date; pageViewId: string | undefined; pathname: string | undefined }\n    _instance: PostHog\n\n    constructor(instance: PostHog) {\n        this._instance = instance\n    }\n\n    doPageView(timestamp: Date, pageViewId?: string): PageViewEventProperties {\n        const response = this._previousPageViewProperties(timestamp, pageViewId)\n\n        // On a pageview we reset the contexts\n        this._currentPageview = { pathname: window?.location.pathname ?? '', pageViewId, timestamp }\n        this._instance.scrollManager.resetContext()\n\n        return response\n    }\n\n    doPageLeave(timestamp: Date): PageViewEventProperties {\n        return this._previousPageViewProperties(timestamp, this._currentPageview?.pageViewId)\n    }\n\n    doEvent(): PageViewEventProperties {\n        return { $pageview_id: this._currentPageview?.pageViewId }\n    }\n\n    private _previousPageViewProperties(timestamp: Date, pageviewId: string | undefined): PageViewEventProperties {\n        const previousPageView = this._currentPageview\n\n        if (!previousPageView) {\n            return { $pageview_id: pageviewId }\n        }\n\n        let properties: PageViewEventProperties = {\n            $pageview_id: pageviewId,\n            $prev_pageview_id: previousPageView.pageViewId,\n        }\n\n        const scrollContext = this._instance.scrollManager.getContext()\n\n        if (scrollContext && !this._instance.config.disable_scroll_properties) {\n            let { maxScrollHeight, lastScrollY, maxScrollY, maxContentHeight, lastContentY, maxContentY } =\n                scrollContext\n\n            if (\n                !isUndefined(maxScrollHeight) &&\n                !isUndefined(lastScrollY) &&\n                !isUndefined(maxScrollY) &&\n                !isUndefined(maxContentHeight) &&\n                !isUndefined(lastContentY) &&\n                !isUndefined(maxContentY)\n            ) {\n                // Use ceil, so that e.g. scrolling 999.5px of a 1000px page is considered 100% scrolled\n                maxScrollHeight = Math.ceil(maxScrollHeight)\n                lastScrollY = Math.ceil(lastScrollY)\n                maxScrollY = Math.ceil(maxScrollY)\n                maxContentHeight = Math.ceil(maxContentHeight)\n                lastContentY = Math.ceil(lastContentY)\n                maxContentY = Math.ceil(maxContentY)\n\n                // if the maximum scroll height is near 0, then the percentage is 1\n                const lastScrollPercentage =\n                    maxScrollHeight <= 1 ? 1 : clampToRange(lastScrollY / maxScrollHeight, 0, 1, logger)\n                const maxScrollPercentage =\n                    maxScrollHeight <= 1 ? 1 : clampToRange(maxScrollY / maxScrollHeight, 0, 1, logger)\n                const lastContentPercentage =\n                    maxContentHeight <= 1 ? 1 : clampToRange(lastContentY / maxContentHeight, 0, 1, logger)\n                const maxContentPercentage =\n                    maxContentHeight <= 1 ? 1 : clampToRange(maxContentY / maxContentHeight, 0, 1, logger)\n\n                properties = extend(properties, {\n                    $prev_pageview_last_scroll: lastScrollY,\n                    $prev_pageview_last_scroll_percentage: lastScrollPercentage,\n                    $prev_pageview_max_scroll: maxScrollY,\n                    $prev_pageview_max_scroll_percentage: maxScrollPercentage,\n                    $prev_pageview_last_content: lastContentY,\n                    $prev_pageview_last_content_percentage: lastContentPercentage,\n                    $prev_pageview_max_content: maxContentY,\n                    $prev_pageview_max_content_percentage: maxContentPercentage,\n                })\n            }\n        }\n\n        if (previousPageView.pathname) {\n            properties.$prev_pageview_pathname = previousPageView.pathname\n        }\n        if (previousPageView.timestamp) {\n            // Use seconds, for consistency with our other duration-related properties like $duration\n            properties.$prev_pageview_duration = (timestamp.getTime() - previousPageView.timestamp.getTime()) / 1000\n        }\n\n        return properties\n    }\n}\n"]}
+{"version":3,"file":"page-view.js","sourceRoot":"","sources":["../../src/page-view.ts"],"names":[],"mappings":"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","sourcesContent":["import { window } from './utils/globals'\nimport { PostHog } from './posthog-core'\nimport { clampToRange, isUndefined } from '@posthog/core'\nimport { extend } from './utils'\nimport { logger } from './utils/logger'\nimport { SessionIdChangedCallback } from './types'\n\ninterface PageViewEventProperties {\n    $pageview_id?: string\n    $prev_pageview_id?: string\n    $prev_pageview_pathname?: string\n    $prev_pageview_duration?: number // seconds\n    $prev_pageview_last_scroll?: number\n    $prev_pageview_last_scroll_percentage?: number\n    $prev_pageview_max_scroll?: number\n    $prev_pageview_max_scroll_percentage?: number\n    $prev_pageview_last_content?: number\n    $prev_pageview_last_content_percentage?: number\n    $prev_pageview_max_content?: number\n    $prev_pageview_max_content_percentage?: number\n}\n\n// This keeps track of the PageView state (such as the previous PageView's path, timestamp, id, and scroll properties).\n// We store the state in memory, which means that for non-SPA sites, the state will be lost on page reload. This means\n// that non-SPA sites should always send a $pageleave event on any navigation, before the page unloads. For SPA sites,\n// they only need to send a $pageleave event when the user navigates away from the site, as the information is not lost\n// on an internal navigation, and is included as the $prev_pageview_ properties in the next $pageview event.\n\n// Practically, this means that to find the scroll properties for a given pageview, you need to find the event where\n// event name is $pageview or $pageleave and where $prev_pageview_id matches the original pageview event's id.\n\nexport class PageViewManager {\n    _currentPageview?: { timestamp: Date; pageViewId: string | undefined; pathname: string | undefined }\n    _instance: PostHog\n    private _unsubscribeSessionId?: () => void\n\n    constructor(instance: PostHog) {\n        this._instance = instance\n        this._setupSessionRotationHandler()\n    }\n\n    private _setupSessionRotationHandler(): void {\n        this._unsubscribeSessionId = this._instance.sessionManager?.onSessionId(this._onSessionIdChange)\n    }\n\n    private _onSessionIdChange: SessionIdChangedCallback = (sessionId, _windowId, changeReason) => {\n        // Only act on actual session rotations, not initial session creation\n        if (!changeReason) {\n            return\n        }\n\n        // Clear state when session changes for any of these reasons:\n        // - noSessionId: after posthog.reset() or forced idle reset\n        // - activityTimeout: 30 min idle (default, configurable up to 10 hours)\n        // - sessionPastMaximumLength: 24 hour max session\n        if (changeReason.noSessionId || changeReason.activityTimeout || changeReason.sessionPastMaximumLength) {\n            logger.info('[PageViewManager] Session rotated, clearing pageview state', {\n                sessionId,\n                changeReason,\n            })\n            this._currentPageview = undefined\n            this._instance.scrollManager.resetContext()\n        }\n    }\n\n    destroy(): void {\n        this._unsubscribeSessionId?.()\n        this._unsubscribeSessionId = undefined\n    }\n\n    doPageView(timestamp: Date, pageViewId?: string): PageViewEventProperties {\n        const response = this._previousPageViewProperties(timestamp, pageViewId)\n\n        // On a pageview we reset the contexts\n        this._currentPageview = { pathname: window?.location.pathname ?? '', pageViewId, timestamp }\n        this._instance.scrollManager.resetContext()\n\n        return response\n    }\n\n    doPageLeave(timestamp: Date): PageViewEventProperties {\n        return this._previousPageViewProperties(timestamp, this._currentPageview?.pageViewId)\n    }\n\n    doEvent(): PageViewEventProperties {\n        return { $pageview_id: this._currentPageview?.pageViewId }\n    }\n\n    private _previousPageViewProperties(timestamp: Date, pageviewId: string | undefined): PageViewEventProperties {\n        const previousPageView = this._currentPageview\n\n        if (!previousPageView) {\n            return { $pageview_id: pageviewId }\n        }\n\n        let properties: PageViewEventProperties = {\n            $pageview_id: pageviewId,\n            $prev_pageview_id: previousPageView.pageViewId,\n        }\n\n        const scrollContext = this._instance.scrollManager.getContext()\n\n        if (scrollContext && !this._instance.config.disable_scroll_properties) {\n            let { maxScrollHeight, lastScrollY, maxScrollY, maxContentHeight, lastContentY, maxContentY } =\n                scrollContext\n\n            if (\n                !isUndefined(maxScrollHeight) &&\n                !isUndefined(lastScrollY) &&\n                !isUndefined(maxScrollY) &&\n                !isUndefined(maxContentHeight) &&\n                !isUndefined(lastContentY) &&\n                !isUndefined(maxContentY)\n            ) {\n                // Use ceil, so that e.g. scrolling 999.5px of a 1000px page is considered 100% scrolled\n                maxScrollHeight = Math.ceil(maxScrollHeight)\n                lastScrollY = Math.ceil(lastScrollY)\n                maxScrollY = Math.ceil(maxScrollY)\n                maxContentHeight = Math.ceil(maxContentHeight)\n                lastContentY = Math.ceil(lastContentY)\n                maxContentY = Math.ceil(maxContentY)\n\n                // if the maximum scroll height is near 0, then the percentage is 1\n                const lastScrollPercentage =\n                    maxScrollHeight <= 1 ? 1 : clampToRange(lastScrollY / maxScrollHeight, 0, 1, logger)\n                const maxScrollPercentage =\n                    maxScrollHeight <= 1 ? 1 : clampToRange(maxScrollY / maxScrollHeight, 0, 1, logger)\n                const lastContentPercentage =\n                    maxContentHeight <= 1 ? 1 : clampToRange(lastContentY / maxContentHeight, 0, 1, logger)\n                const maxContentPercentage =\n                    maxContentHeight <= 1 ? 1 : clampToRange(maxContentY / maxContentHeight, 0, 1, logger)\n\n                properties = extend(properties, {\n                    $prev_pageview_last_scroll: lastScrollY,\n                    $prev_pageview_last_scroll_percentage: lastScrollPercentage,\n                    $prev_pageview_max_scroll: maxScrollY,\n                    $prev_pageview_max_scroll_percentage: maxScrollPercentage,\n                    $prev_pageview_last_content: lastContentY,\n                    $prev_pageview_last_content_percentage: lastContentPercentage,\n                    $prev_pageview_max_content: maxContentY,\n                    $prev_pageview_max_content_percentage: maxContentPercentage,\n                })\n            }\n        }\n\n        if (previousPageView.pathname) {\n            properties.$prev_pageview_pathname = previousPageView.pathname\n        }\n        if (previousPageView.timestamp) {\n            // Use seconds, for consistency with our other duration-related properties like $duration\n            properties.$prev_pageview_duration = (timestamp.getTime() - previousPageView.timestamp.getTime()) / 1000\n        }\n\n        return properties\n    }\n}\n"]}

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

@@ -470,6 +470,45 @@ export declare class PostHog {
      * @public
      */
     reloadFeatureFlags(): void;
+    /**
+     * Manually update feature flag values without making a network request.
+     *
+     * This is useful when you have feature flag values from an external source
+     * (e.g., server-side evaluation, edge middleware) and want to inject them
+     * into the client SDK.
+     *
+     * {@label Feature flags}
+     *
+     * @example
+     * ```js
+     * // Replace all flags with server-evaluated values
+     * posthog.updateFlags({
+     *   'my-flag': true,
+     *   'my-experiment': 'variant-a'
+     * })
+     *
+     * // Merge with existing flags (update only specified flags)
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   undefined,
+     *   { merge: true }
+     * )
+     *
+     * // With payloads
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   { 'my-flag': { some: 'data' } }
+     * )
+     * ```
+     *
+     * @param flags - An object mapping flag keys to their values (boolean or string variant)
+     * @param payloads - Optional object mapping flag keys to their JSON payloads
+     * @param options - Optional settings. Use `{ merge: true }` to merge with existing flags instead of replacing.
+     * @public
+     */
+    updateFlags(flags: Record<string, boolean | string>, payloads?: Record<string, JsonType>, options?: {
+        merge?: boolean;
+    }): void;
     /**
      * Opt the user in or out of an early access feature. [Learn more in the docs](/docs/feature-flags/early-access-feature-management#option-2-custom-implementation)
      *

package/lib/src/posthog-core.js

@@ -1375,6 +1375,78 @@ var PostHog = /** @class */ (function () {
     PostHog.prototype.reloadFeatureFlags = function () {
         this.featureFlags.reloadFeatureFlags();
     };
+    /**
+     * Manually update feature flag values without making a network request.
+     *
+     * This is useful when you have feature flag values from an external source
+     * (e.g., server-side evaluation, edge middleware) and want to inject them
+     * into the client SDK.
+     *
+     * {@label Feature flags}
+     *
+     * @example
+     * ```js
+     * // Replace all flags with server-evaluated values
+     * posthog.updateFlags({
+     *   'my-flag': true,
+     *   'my-experiment': 'variant-a'
+     * })
+     *
+     * // Merge with existing flags (update only specified flags)
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   undefined,
+     *   { merge: true }
+     * )
+     *
+     * // With payloads
+     * posthog.updateFlags(
+     *   { 'my-flag': true },
+     *   { 'my-flag': { some: 'data' } }
+     * )
+     * ```
+     *
+     * @param flags - An object mapping flag keys to their values (boolean or string variant)
+     * @param payloads - Optional object mapping flag keys to their JSON payloads
+     * @param options - Optional settings. Use `{ merge: true }` to merge with existing flags instead of replacing.
+     * @public
+     */
+    PostHog.prototype.updateFlags = function (flags, payloads, options) {
+        var e_1, _a;
+        // If merging, combine with existing flags
+        var existingFlags = (options === null || options === void 0 ? void 0 : options.merge) ? this.featureFlags.getFlagVariants() : {};
+        var existingPayloads = (options === null || options === void 0 ? void 0 : options.merge) ? this.featureFlags.getFlagPayloads() : {};
+        var finalFlags = __assign(__assign({}, existingFlags), flags);
+        var finalPayloads = __assign(__assign({}, existingPayloads), payloads);
+        // Convert simple flags to v4 format to avoid deprecation warning
+        var flagDetails = {};
+        try {
+            for (var _b = __values(Object.entries(finalFlags)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
+                var isVariant = typeof value === 'string';
+                flagDetails[key] = {
+                    key: key,
+                    enabled: isVariant ? true : Boolean(value),
+                    variant: isVariant ? value : undefined,
+                    reason: undefined,
+                    // id: 0 indicates manually injected flags (not from server evaluation)
+                    metadata: !(0, core_1.isUndefined)(finalPayloads === null || finalPayloads === void 0 ? void 0 : finalPayloads[key])
+                        ? { id: 0, version: undefined, description: undefined, payload: finalPayloads[key] }
+                        : undefined,
+                };
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        this.featureFlags.receivedFeatureFlags({
+            flags: flagDetails,
+        });
+    };
     /**
      * Opt the user in or out of an early access feature. [Learn more in the docs](/docs/feature-flags/early-access-feature-management#option-2-custom-implementation)
      *
@@ -2696,7 +2768,7 @@ var PostHog = /** @class */ (function () {
      * @param {Object} [config.capture_properties] Set of properties to be captured along with the opt-in action
      */
     PostHog.prototype.opt_in_capturing = function (options) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         if (this.config.cookieless_mode === 'always') {
             logger_1.logger.warn('Consent opt in/out is not valid with cookieless_mode="always" and will be ignored');
             return;
@@ -2706,7 +2778,9 @@ var PostHog = /** @class */ (function () {
             // we need to reset the instance to ensure that there is no leaking of state or data between the cookieless and regular events
             this.reset(true);
             (_a = this.sessionManager) === null || _a === void 0 ? void 0 : _a.destroy();
+            (_b = this.pageViewManager) === null || _b === void 0 ? void 0 : _b.destroy();
             this.sessionManager = new sessionid_1.SessionIdManager(this);
+            this.pageViewManager = new page_view_1.PageViewManager(this);
             if (this.persistence) {
                 this.sessionPropsManager = new session_props_1.SessionPropsManager(this, this.sessionManager, this.persistence);
             }
@@ -2719,14 +2793,14 @@ var PostHog = /** @class */ (function () {
         this._start_queue_if_opted_in();
         // Restart session recording if it should now be enabled
         // (this handles the case where opt_out_capturing_by_default or cookieless_mode prevented it from starting)
-        (_b = this.sessionRecording) === null || _b === void 0 ? void 0 : _b.startIfEnabledOrStop();
+        (_c = this.sessionRecording) === null || _c === void 0 ? void 0 : _c.startIfEnabledOrStop();
         // Reinitialize surveys if we're in cookieless mode and just opted in
         if (this.config.cookieless_mode == 'on_reject') {
             this.surveys.loadIfEnabled();
         }
         // Don't capture if captureEventName is null or false
         if ((0, core_1.isUndefined)(options === null || options === void 0 ? void 0 : options.captureEventName) || (options === null || options === void 0 ? void 0 : options.captureEventName)) {
-            this.capture((_c = options === null || options === void 0 ? void 0 : options.captureEventName) !== null && _c !== void 0 ? _c : '$opt_in', options === null || options === void 0 ? void 0 : options.captureProperties, { send_instantly: true });
+            this.capture((_d = options === null || options === void 0 ? void 0 : options.captureEventName) !== null && _d !== void 0 ? _d : '$opt_in', options === null || options === void 0 ? void 0 : options.captureProperties, { send_instantly: true });
         }
         if (this.config.capture_pageview) {
             this._captureInitialPageview();
@@ -2750,7 +2824,7 @@ var PostHog = /** @class */ (function () {
      * @public
      */
     PostHog.prototype.opt_out_capturing = function () {
-        var _a, _b;
+        var _a, _b, _c;
         if (this.config.cookieless_mode === 'always') {
             logger_1.logger.warn('Consent opt in/out is not valid with cookieless_mode="always" and will be ignored');
             return;
@@ -2768,9 +2842,10 @@ var PostHog = /** @class */ (function () {
                 $device_id: null,
             });
             (_a = this.sessionManager) === null || _a === void 0 ? void 0 : _a.destroy();
+            (_b = this.pageViewManager) === null || _b === void 0 ? void 0 : _b.destroy();
             this.sessionManager = undefined;
             this.sessionPropsManager = undefined;
-            (_b = this.sessionRecording) === null || _b === void 0 ? void 0 : _b.stopRecording();
+            (_c = this.sessionRecording) === null || _c === void 0 ? void 0 : _c.stopRecording();
             this.sessionRecording = undefined;
             this._captureInitialPageview();
         }
@@ -2980,7 +3055,7 @@ var PostHog = /** @class */ (function () {
         return (0, utils_1.migrateConfigField)(originalConfig, 'advanced_disable_flags', 'advanced_disable_decide', false, logger_1.logger);
     };
     PostHog.prototype._runBeforeSend = function (data) {
-        var e_1, _a;
+        var e_2, _a;
         if ((0, core_1.isNullish)(this.config.before_send)) {
             return data;
         }
@@ -3005,12 +3080,12 @@ var PostHog = /** @class */ (function () {
                 }
             }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
         finally {
             try {
                 if (fns_1_1 && !fns_1_1.done && (_a = fns_1.return)) _a.call(fns_1);
             }
-            finally { if (e_1) throw e_1.error; }
+            finally { if (e_2) throw e_2.error; }
         }
         return beforeSendResult;
     };