ref: mode -> lifecycle

Author: JPeer264

…ests/suites/sessions/single-mode/init.js …s/suites/sessions/page-lifecycle/init.jsdev-packages/browser-integration-tests/suites/sessions/single-mode/init.js renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/init.js dev-packages/browser-integration-tests/suites/sessions/single-mode/init.js renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/init.js

@@ -5,5 +5,5 @@ window.Sentry = Sentry;
 Sentry.init({
   dsn: 'https://public@dsn.ingest.sentry.io/1337',
   release: '0.1',
-  integrations: [Sentry.browserSessionIntegration({ mode: 'single' })],
+  integrations: [Sentry.browserSessionIntegration({ lifecycle: 'page' })],
 });

…s/suites/sessions/single-mode/subject.js …uites/sessions/page-lifecycle/subject.jsdev-packages/browser-integration-tests/suites/sessions/single-mode/subject.js renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/subject.js dev-packages/browser-integration-tests/suites/sessions/single-mode/subject.js renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/subject.js

@@ -3,7 +3,7 @@ import type { SessionContext } from '@sentry/core';
 import { sentryTest } from '../../../utils/fixtures';
 import { getMultipleSentryEnvelopeRequests } from '../../../utils/helpers';
 
-sentryTest('should start a session on pageload in single mode.', async ({ getLocalTestUrl, page }) => {
+sentryTest('should start a session on pageload with page lifecycle.', async ({ getLocalTestUrl, page }) => {
   const url = await getLocalTestUrl({ testDir: __dirname });
 
   const sessions = await getMultipleSentryEnvelopeRequests<SessionContext>(page, 1, {
@@ -21,7 +21,7 @@ sentryTest('should start a session on pageload in single mode.', async ({ getLoc
 });
 
 sentryTest(
-  'should NOT start a new session on pushState navigation in single mode.',
+  'should NOT start a new session on pushState navigation with page lifecycle.',
   async ({ getLocalTestUrl, page }) => {
     const url = await getLocalTestUrl({ testDir: __dirname });
 

…uites/sessions/single-mode/template.html …es/sessions/page-lifecycle/template.htmldev-packages/browser-integration-tests/suites/sessions/single-mode/template.html renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/template.html dev-packages/browser-integration-tests/suites/sessions/single-mode/template.html renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/template.html

@@ -3,7 +3,7 @@ import type { SessionContext } from '@sentry/core';
 import { sentryTest } from '../../../utils/fixtures';
 import { getMultipleSentryEnvelopeRequests } from '../../../utils/helpers';
 
-sentryTest('should start new sessions on pushState navigation in default mode.', async ({ getLocalTestUrl, page }) => {
+sentryTest('should start new sessions on pushState navigation with route lifecycle (default).', async ({ getLocalTestUrl, page }) => {
   const url = await getLocalTestUrl({ testDir: __dirname });
 
   const sessionsPromise = getMultipleSentryEnvelopeRequests<SessionContext>(page, 10, {

…ests/suites/sessions/single-mode/test.ts …s/suites/sessions/page-lifecycle/test.tsdev-packages/browser-integration-tests/suites/sessions/single-mode/test.ts renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/test.ts dev-packages/browser-integration-tests/suites/sessions/single-mode/test.ts renamed to dev-packages/browser-integration-tests/suites/sessions/page-lifecycle/test.ts

@@ -5,17 +5,17 @@ import { WINDOW } from '../helpers';
 
 interface BrowserSessionOptions {
   /**
-   * Controls when sessions are created.
+   * Controls the session lifecycle - when new sessions are created.
    *
-   * - `'single'`: A session is created once when the page is loaded. Session is not
+   * - `'route'`: A session is created on page load and on every navigation.
+   *   This is the default behavior.
+   * - `'page'`: A session is created once when the page is loaded. Session is not
    *   updated on navigation. This is useful for webviews or single-page apps where
    *   URL changes should not trigger new sessions.
-   * - `'navigation'`: A session is created on page load and on every navigation.
-   *   This is the default behavior.
    *
-   * @default 'navigation'
+   * @default 'route'
    */
-  mode?: 'single' | 'navigation';
+  lifecycle?: 'route' | 'page';
 }
 
 /**
@@ -25,7 +25,7 @@ interface BrowserSessionOptions {
  * Note: In order for session tracking to work, you need to set up Releases: https://docs.sentry.io/product/releases/
  */
 export const browserSessionIntegration = defineIntegration((options: BrowserSessionOptions = {}) => {
-  const mode = options.mode ?? 'navigation';
+  const lifecycle = options.lifecycle ?? 'route';
 
   return {
     name: 'BrowserSession',
@@ -43,7 +43,7 @@ export const browserSessionIntegration = defineIntegration((options: BrowserSess
       startSession({ ignoreDuration: true });
       captureSession();
 
-      if (mode === 'navigation') {
+      if (lifecycle === 'route') {
         // We want to create a session for every navigation as well
         addHistoryInstrumentationHandler(({ from, to }) => {
           // Don't create an additional session for the initial route or if the location did not change