posthog-js 1.275.1 → 1.275.3

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

@@ -1541,6 +1541,7 @@ export declare class PostHog {
      * @param metricValue The value of the metric to capture.
      */
     captureTraceMetric(traceId: string | number, metricName: string, metricValue: string | number | boolean): void;
+    private _checkLocalStorageForDebug;
 }
 export declare function init_from_snippet(): void;
 export declare function init_as_module(): PostHog;

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

@@ -19,7 +19,11 @@ export declare class PostHogPersistence {
      * @param {boolean=} isDisabled should persistence be disabled (e.g. because of consent management)
      */
     constructor(config: PostHogConfig, isDisabled?: boolean);
-    isDisabled(): boolean;
+    /**
+     * Returns whether persistence is disabled. Only available in SDKs > 1.257.1. Do not use on extensions, otherwise
+     * it'll break backwards compatibility for any version before 1.257.1.
+     */
+    isDisabled?(): boolean;
     private _buildStorage;
     properties(): Properties;
     load(): void;

package/dist/surveys-preview.d.ts

@@ -2176,7 +2176,11 @@ declare class PostHogPersistence {
      * @param {boolean=} isDisabled should persistence be disabled (e.g. because of consent management)
      */
     constructor(config: PostHogConfig, isDisabled?: boolean);
-    isDisabled(): boolean;
+    /**
+     * Returns whether persistence is disabled. Only available in SDKs > 1.257.1. Do not use on extensions, otherwise
+     * it'll break backwards compatibility for any version before 1.257.1.
+     */
+    isDisabled?(): boolean;
     private _buildStorage;
     properties(): Properties;
     load(): void;
@@ -4208,6 +4212,7 @@ declare class PostHog {
      * @param metricValue The value of the metric to capture.
      */
     captureTraceMetric(traceId: string | number, metricName: string, metricValue: string | number | boolean): void;
+    private _checkLocalStorageForDebug;
 }
 
 declare function getNextSurveyStep(survey: Survey, currentQuestionIndex: number, response: string | string[] | number | null): any;

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "posthog-js",
-    "version": "1.275.1",
+    "version": "1.275.3",
     "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/extensions/sentry-integration.js

@@ -59,7 +59,6 @@ function createEventProcessor(_posthog, _a) {
             // PostHog Exception Properties,
             $exception_message: ((_b = exceptions[0]) === null || _b === void 0 ? void 0 : _b.value) || event.message,
             $exception_type: (_c = exceptions[0]) === null || _c === void 0 ? void 0 : _c.type,
-            $exception_personURL: personUrl,
             $exception_level: event.level,
             $exception_list: exceptionList,
             // Sentry Exception Properties

package/lib/src/extensions/sentry-integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"sentry-integration.js","sourceRoot":"","sources":["../../../src/extensions/sentry-integration.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Integrate Sentry with PostHog. This will add a direct link to the person in Sentry, and an $exception event in PostHog\n *\n * ### Usage\n *\n *     Sentry.init({\n *          dsn: 'https://example',\n *          integrations: [\n *              new posthog.SentryIntegration(posthog)\n *          ]\n *     })\n *\n * @param {Object} [posthog] The posthog object\n * @param {string} [organization] Optional: The Sentry organization, used to send a direct link from PostHog to Sentry\n * @param {Number} [projectId] Optional: The Sentry project id, used to send a direct link from PostHog to Sentry\n * @param {string} [prefix] Optional: Url of a self-hosted sentry instance (default: https://sentry.io/organizations/)\n * @param {SeverityLevel[] | '*'} [severityAllowList] Optional: send events matching the provided levels. Use '*' to send all events (default: ['error'])\n * @param {boolean} [sendExceptionsToPostHog] Optional: capture exceptions as events in PostHog (default: true)\n */\n\nimport { PostHog } from '../posthog-core'\nimport { SeverityLevel } from '../types'\n\n// NOTE - we can't import from @sentry/types because it changes frequently and causes clashes\n// We only use a small subset of the types, so we can just define the integration overall and use any for the rest\n\n// import {\n//     Event as _SentryEvent,\n//     EventProcessor as _SentryEventProcessor,\n//     Hub as _SentryHub,\n//     Integration as _SentryIntegration,\n//     SeverityLevel as _SeverityLevel,\n//     IntegrationClass as _SentryIntegrationClass,\n// } from '@sentry/types'\n\n// Uncomment the above and comment the below to get type checking for development\n\ntype _SentryEvent = any\ntype _SentryException = any\ntype _SentryEventProcessor = any\ntype _SentryHub = any\n\ninterface _SentryIntegration {\n    name: string\n    processEvent(event: _SentryEvent): _SentryEvent\n}\n\ninterface _SentryIntegrationClass {\n    name: string\n    setupOnce(addGlobalEventProcessor: (callback: _SentryEventProcessor) => void, getCurrentHub: () => _SentryHub): void\n}\n\ninterface SentryExceptionProperties {\n    $sentry_event_id: any\n    $sentry_exception: any\n    $sentry_exception_message: any\n    $sentry_exception_type: any\n    $sentry_tags: any\n    $sentry_url?: string\n}\n\nexport type SentryIntegrationOptions = {\n    organization?: string\n    projectId?: number\n    prefix?: string\n    severityAllowList?: SeverityLevel[] | '*'\n    sendExceptionsToPostHog?: boolean\n}\n\nconst NAME = 'posthog-js'\n\nexport function createEventProcessor(\n    _posthog: PostHog,\n    {\n        organization,\n        projectId,\n        prefix,\n        severityAllowList = ['error'],\n        sendExceptionsToPostHog = true,\n    }: SentryIntegrationOptions = {}\n): (event: _SentryEvent) => _SentryEvent {\n    return (event) => {\n        const shouldProcessLevel = severityAllowList === '*' || severityAllowList.includes(event.level as SeverityLevel)\n        if (!shouldProcessLevel || !_posthog.__loaded) return event\n        if (!event.tags) event.tags = {}\n\n        const personUrl = _posthog.requestRouter.endpointFor(\n            'ui',\n            `/project/${_posthog.config.token}/person/${_posthog.get_distinct_id()}`\n        )\n        event.tags['PostHog Person URL'] = personUrl\n        if (_posthog.sessionRecordingStarted()) {\n            event.tags['PostHog Recording URL'] = _posthog.get_session_replay_url({ withTimestamp: true })\n        }\n\n        const exceptions: _SentryException[] = event.exception?.values || []\n\n        const exceptionList = exceptions.map((exception) => {\n            return {\n                ...exception,\n                stacktrace: exception.stacktrace\n                    ? {\n                          ...exception.stacktrace,\n                          type: 'raw',\n                          frames: (exception.stacktrace.frames || []).map((frame: any) => {\n                              return { ...frame, platform: 'web:javascript' }\n                          }),\n                      }\n                    : undefined,\n            }\n        })\n\n        const data: SentryExceptionProperties & {\n            // two properties added to match any exception auto-capture\n            // added manually to avoid any dependency on the lazily loaded content\n            $exception_message: any\n            $exception_type: any\n            $exception_list: any\n            $exception_personURL: string\n            $exception_level: SeverityLevel\n        } = {\n            // PostHog Exception Properties,\n            $exception_message: exceptions[0]?.value || event.message,\n            $exception_type: exceptions[0]?.type,\n            $exception_personURL: personUrl,\n            $exception_level: event.level,\n            $exception_list: exceptionList,\n            // Sentry Exception Properties\n            $sentry_event_id: event.event_id,\n            $sentry_exception: event.exception,\n            $sentry_exception_message: exceptions[0]?.value || event.message,\n            $sentry_exception_type: exceptions[0]?.type,\n            $sentry_tags: event.tags,\n        }\n\n        if (organization && projectId) {\n            data['$sentry_url'] =\n                (prefix || 'https://sentry.io/organizations/') +\n                organization +\n                '/issues/?project=' +\n                projectId +\n                '&query=' +\n                event.event_id\n        }\n\n        if (sendExceptionsToPostHog) {\n            _posthog.exceptions.sendExceptionEvent(data)\n        }\n\n        return event\n    }\n}\n\n// V8 integration - function based\nexport function sentryIntegration(_posthog: PostHog, options?: SentryIntegrationOptions): _SentryIntegration {\n    const processor = createEventProcessor(_posthog, options)\n    return {\n        name: NAME,\n        processEvent(event) {\n            return processor(event)\n        },\n    }\n}\n// V7 integration - class based\nexport class SentryIntegration implements _SentryIntegrationClass {\n    name: string\n\n    setupOnce: (\n        addGlobalEventProcessor: (callback: _SentryEventProcessor) => void,\n        getCurrentHub: () => _SentryHub\n    ) => void\n\n    constructor(\n        _posthog: PostHog,\n        organization?: string,\n        projectId?: number,\n        prefix?: string,\n        severityAllowList?: SeverityLevel[] | '*',\n        sendExceptionsToPostHog?: boolean\n    ) {\n        // setupOnce gets called by Sentry when it intializes the plugin\n        this.name = NAME\n        this.setupOnce = function (addGlobalEventProcessor: (callback: _SentryEventProcessor) => void) {\n            addGlobalEventProcessor(\n                createEventProcessor(_posthog, {\n                    organization,\n                    projectId,\n                    prefix,\n                    severityAllowList,\n                    sendExceptionsToPostHog: sendExceptionsToPostHog ?? true,\n                })\n            )\n        }\n    }\n}\n"]}
+{"version":3,"file":"sentry-integration.js","sourceRoot":"","sources":["../../../src/extensions/sentry-integration.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Integrate Sentry with PostHog. This will add a direct link to the person in Sentry, and an $exception event in PostHog\n *\n * ### Usage\n *\n *     Sentry.init({\n *          dsn: 'https://example',\n *          integrations: [\n *              new posthog.SentryIntegration(posthog)\n *          ]\n *     })\n *\n * @param {Object} [posthog] The posthog object\n * @param {string} [organization] Optional: The Sentry organization, used to send a direct link from PostHog to Sentry\n * @param {Number} [projectId] Optional: The Sentry project id, used to send a direct link from PostHog to Sentry\n * @param {string} [prefix] Optional: Url of a self-hosted sentry instance (default: https://sentry.io/organizations/)\n * @param {SeverityLevel[] | '*'} [severityAllowList] Optional: send events matching the provided levels. Use '*' to send all events (default: ['error'])\n * @param {boolean} [sendExceptionsToPostHog] Optional: capture exceptions as events in PostHog (default: true)\n */\n\nimport { PostHog } from '../posthog-core'\nimport { SeverityLevel } from '../types'\n\n// NOTE - we can't import from @sentry/types because it changes frequently and causes clashes\n// We only use a small subset of the types, so we can just define the integration overall and use any for the rest\n\n// import {\n//     Event as _SentryEvent,\n//     EventProcessor as _SentryEventProcessor,\n//     Hub as _SentryHub,\n//     Integration as _SentryIntegration,\n//     SeverityLevel as _SeverityLevel,\n//     IntegrationClass as _SentryIntegrationClass,\n// } from '@sentry/types'\n\n// Uncomment the above and comment the below to get type checking for development\n\ntype _SentryEvent = any\ntype _SentryException = any\ntype _SentryEventProcessor = any\ntype _SentryHub = any\n\ninterface _SentryIntegration {\n    name: string\n    processEvent(event: _SentryEvent): _SentryEvent\n}\n\ninterface _SentryIntegrationClass {\n    name: string\n    setupOnce(addGlobalEventProcessor: (callback: _SentryEventProcessor) => void, getCurrentHub: () => _SentryHub): void\n}\n\ninterface SentryExceptionProperties {\n    $sentry_event_id: any\n    $sentry_exception: any\n    $sentry_exception_message: any\n    $sentry_exception_type: any\n    $sentry_tags: any\n    $sentry_url?: string\n}\n\nexport type SentryIntegrationOptions = {\n    organization?: string\n    projectId?: number\n    prefix?: string\n    severityAllowList?: SeverityLevel[] | '*'\n    sendExceptionsToPostHog?: boolean\n}\n\nconst NAME = 'posthog-js'\n\nexport function createEventProcessor(\n    _posthog: PostHog,\n    {\n        organization,\n        projectId,\n        prefix,\n        severityAllowList = ['error'],\n        sendExceptionsToPostHog = true,\n    }: SentryIntegrationOptions = {}\n): (event: _SentryEvent) => _SentryEvent {\n    return (event) => {\n        const shouldProcessLevel = severityAllowList === '*' || severityAllowList.includes(event.level as SeverityLevel)\n        if (!shouldProcessLevel || !_posthog.__loaded) return event\n        if (!event.tags) event.tags = {}\n\n        const personUrl = _posthog.requestRouter.endpointFor(\n            'ui',\n            `/project/${_posthog.config.token}/person/${_posthog.get_distinct_id()}`\n        )\n        event.tags['PostHog Person URL'] = personUrl\n        if (_posthog.sessionRecordingStarted()) {\n            event.tags['PostHog Recording URL'] = _posthog.get_session_replay_url({ withTimestamp: true })\n        }\n\n        const exceptions: _SentryException[] = event.exception?.values || []\n\n        const exceptionList = exceptions.map((exception) => {\n            return {\n                ...exception,\n                stacktrace: exception.stacktrace\n                    ? {\n                          ...exception.stacktrace,\n                          type: 'raw',\n                          frames: (exception.stacktrace.frames || []).map((frame: any) => {\n                              return { ...frame, platform: 'web:javascript' }\n                          }),\n                      }\n                    : undefined,\n            }\n        })\n\n        const data: SentryExceptionProperties & {\n            // two properties added to match any exception auto-capture\n            // added manually to avoid any dependency on the lazily loaded content\n            $exception_message: any\n            $exception_type: any\n            $exception_list: any\n            $exception_level: SeverityLevel\n        } = {\n            // PostHog Exception Properties,\n            $exception_message: exceptions[0]?.value || event.message,\n            $exception_type: exceptions[0]?.type,\n            $exception_level: event.level,\n            $exception_list: exceptionList,\n            // Sentry Exception Properties\n            $sentry_event_id: event.event_id,\n            $sentry_exception: event.exception,\n            $sentry_exception_message: exceptions[0]?.value || event.message,\n            $sentry_exception_type: exceptions[0]?.type,\n            $sentry_tags: event.tags,\n        }\n\n        if (organization && projectId) {\n            data['$sentry_url'] =\n                (prefix || 'https://sentry.io/organizations/') +\n                organization +\n                '/issues/?project=' +\n                projectId +\n                '&query=' +\n                event.event_id\n        }\n\n        if (sendExceptionsToPostHog) {\n            _posthog.exceptions.sendExceptionEvent(data)\n        }\n\n        return event\n    }\n}\n\n// V8 integration - function based\nexport function sentryIntegration(_posthog: PostHog, options?: SentryIntegrationOptions): _SentryIntegration {\n    const processor = createEventProcessor(_posthog, options)\n    return {\n        name: NAME,\n        processEvent(event) {\n            return processor(event)\n        },\n    }\n}\n// V7 integration - class based\nexport class SentryIntegration implements _SentryIntegrationClass {\n    name: string\n\n    setupOnce: (\n        addGlobalEventProcessor: (callback: _SentryEventProcessor) => void,\n        getCurrentHub: () => _SentryHub\n    ) => void\n\n    constructor(\n        _posthog: PostHog,\n        organization?: string,\n        projectId?: number,\n        prefix?: string,\n        severityAllowList?: SeverityLevel[] | '*',\n        sendExceptionsToPostHog?: boolean\n    ) {\n        // setupOnce gets called by Sentry when it intializes the plugin\n        this.name = NAME\n        this.setupOnce = function (addGlobalEventProcessor: (callback: _SentryEventProcessor) => void) {\n            addGlobalEventProcessor(\n                createEventProcessor(_posthog, {\n                    organization,\n                    projectId,\n                    prefix,\n                    severityAllowList,\n                    sendExceptionsToPostHog: sendExceptionsToPostHog ?? true,\n                })\n            )\n        }\n    }\n}\n"]}

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

@@ -1541,6 +1541,7 @@ export declare class PostHog {
      * @param metricValue The value of the metric to capture.
      */
     captureTraceMetric(traceId: string | number, metricName: string, metricValue: string | number | boolean): void;
+    private _checkLocalStorageForDebug;
 }
 export declare function init_from_snippet(): void;
 export declare function init_as_module(): PostHog;

package/lib/src/posthog-core.js

@@ -394,11 +394,14 @@ var PostHog = /** @class */ (function () {
             return this;
         }
         if (this.__loaded) {
-            logger_1.logger.warn('You have already initialized PostHog! Re-initializing is a no-op');
+            // need to be able to log before having processed debug config
+            // eslint-disable-next-line no-console
+            console.warn('[PostHog.js]', 'You have already initialized PostHog! Re-initializing is a no-op');
             return this;
         }
         this.__loaded = true;
         this.config = {}; // will be set right below
+        config.debug = this._checkLocalStorageForDebug(config.debug);
         this._originalUserConfig = config; // Store original user config for migration
         this._triggered_notifs = [];
         if (config.person_profiles) {
@@ -2210,16 +2213,24 @@ var PostHog = /** @class */ (function () {
                 this.config.persistence === 'sessionStorage' || this.config.persistence === 'memory'
                     ? this.persistence
                     : new posthog_persistence_1.PostHogPersistence(__assign(__assign({}, this.config), { persistence: 'sessionStorage' }), isPersistenceDisabled);
-            if (storage_1.localStore._is_supported() && storage_1.localStore._get('ph_debug') === 'true') {
-                this.config.debug = true;
+            var debugConfigFromLocalStorage = this._checkLocalStorageForDebug(this.config.debug);
+            if ((0, core_1.isBoolean)(debugConfigFromLocalStorage)) {
+                this.config.debug = debugConfigFromLocalStorage;
             }
-            if (this.config.debug) {
-                config_1.default.DEBUG = true;
-                logger_1.logger.info('set_config', {
-                    config: config,
-                    oldConfig: oldConfig,
-                    newConfig: __assign({}, this.config),
-                });
+            if ((0, core_1.isBoolean)(this.config.debug)) {
+                if (this.config.debug) {
+                    config_1.default.DEBUG = true;
+                    storage_1.localStore._is_supported() && storage_1.localStore._set('ph_debug', 'true');
+                    logger_1.logger.info('set_config', {
+                        config: config,
+                        oldConfig: oldConfig,
+                        newConfig: __assign({}, this.config),
+                    });
+                }
+                else {
+                    config_1.default.DEBUG = false;
+                    storage_1.localStore._is_supported() && storage_1.localStore._remove('ph_debug');
+                }
             }
             (_b = this.sessionRecording) === null || _b === void 0 ? void 0 : _b.startIfEnabledOrStop();
             (_c = this.autocapture) === null || _c === void 0 ? void 0 : _c.startIfEnabled();
@@ -2810,12 +2821,10 @@ var PostHog = /** @class */ (function () {
     PostHog.prototype.debug = function (debug) {
         if (debug === false) {
             globals_1.window === null || globals_1.window === void 0 ? void 0 : globals_1.window.console.log("You've disabled debug mode.");
-            localStorage && localStorage.removeItem('ph_debug');
             this.set_config({ debug: false });
         }
         else {
             globals_1.window === null || globals_1.window === void 0 ? void 0 : globals_1.window.console.log("You're now in debug mode. All calls to PostHog will be logged in your console.\nYou can disable this with `posthog.debug(false)`.");
-            localStorage && localStorage.setItem('ph_debug', 'true');
             this.set_config({ debug: true });
         }
     };
@@ -2924,6 +2933,11 @@ var PostHog = /** @class */ (function () {
             $ai_metric_value: String(metricValue),
         });
     };
+    PostHog.prototype._checkLocalStorageForDebug = function (debugConfig) {
+        var explicitlyFalse = (0, core_1.isBoolean)(debugConfig) && !debugConfig;
+        var isTrueInLocalStorage = storage_1.localStore._is_supported() && storage_1.localStore._get('ph_debug') === 'true';
+        return explicitlyFalse ? false : isTrueInLocalStorage ? true : debugConfig;
+    };
     return PostHog;
 }());
 exports.PostHog = PostHog;