@coralogix/browser 3.18.0 → 3.19.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 3.19.0 (2026-07-12)
+
+### 🚀 Features
+
+- Add `createNewSession()` API to manually rotate the session (e.g. on user logout)
+
 ## 3.18.0 (2026-07-08)
 
 ### 🚀 Features

package/README.md

@@ -22,17 +22,18 @@
    - [Worker URL](#worker-url)
    - [Screenshots](#screenshots)
 
-10. [Unique Users](#unique-users)
-11. [Network Extra Configuration](#network-extra-configuration)
-12. [Multi Page Application](#multi-page-application)
-13. [Ignore Errors](#ignore-errors)
-14. [Ignore URLs](#ignore-urls)
-15. [Stack Trace Limit](#stack-trace-limit)
-16. [Mask Elements](#mask-elements)
-17. [Custom Action Names](#custom-action-names)
-18. [Label Providers](#label-providers)
-19. [URL Blueprinters](#url-blueprinters)
-20. [Traces](#traces)
+10. [Manually Create a New Session](#manually-create-a-new-session)
+11. [Unique Users](#unique-users)
+12. [Network Extra Configuration](#network-extra-configuration)
+13. [Multi Page Application](#multi-page-application)
+14. [Ignore Errors](#ignore-errors)
+15. [Ignore URLs](#ignore-urls)
+16. [Stack Trace Limit](#stack-trace-limit)
+17. [Mask Elements](#mask-elements)
+18. [Custom Action Names](#custom-action-names)
+19. [Label Providers](#label-providers)
+20. [URL Blueprinters](#url-blueprinters)
+21. [Traces](#traces)
 
     - [Propagate Trace Header for CORS URLs](#propagatetraceheadercorsurls)
     - [Allowed Tracing URLs](#allowedtracingurls)
@@ -40,34 +41,34 @@
     - [Custom Propagation](#custom-propagation)
     - [Traces Exporter](#traces-exporter)
 
-21. [Before Send](#before-send)
-22. [Proxy URL](#proxy-url)
+22. [Before Send](#before-send)
+23. [Proxy URL](#proxy-url)
 
     - [ignoreProxyUrlParams](#ignoreproxyurlparams)
 
-23. [Collect IP Data](#collect-ip-data)
-24. [SDK Fetch Priority](#sdk-fetch-priority)
-25. [Custom Measurement](#custom-measurement)
-26. [Add Timing](#add-timing)
-27. [Custom Time Measurement](#custom-time-measurement)
-28. [Microfrontend Support](#microfrontend-support)
+24. [Collect IP Data](#collect-ip-data)
+25. [SDK Fetch Priority](#sdk-fetch-priority)
+26. [Custom Measurement](#custom-measurement)
+27. [Add Timing](#add-timing)
+28. [Custom Time Measurement](#custom-time-measurement)
+29. [Microfrontend Support](#microfrontend-support)
 
     - [Pre Requisites](#pre-requisites)
 
-29. [Custom Spans](#custom-spans)
+30. [Custom Spans](#custom-spans)
 
     - [Ignored Instruments](#ignored-instruments)
 
-30. [OpenTelemetry Batch Configuration](#opentelemetry-batch-configuration)
-31. [Soft Navigations (Experimental)](#soft-navigations--experimental)
-32. [Memory Usage (Experimental)](#memory-usage---experimental)
-33. [Web Worker Support](#web-worker-support)
+31. [OpenTelemetry Batch Configuration](#opentelemetry-batch-configuration)
+32. [Soft Navigations (Experimental)](#soft-navigations--experimental)
+33. [Memory Usage (Experimental)](#memory-usage---experimental)
+34. [Web Worker Support](#web-worker-support)
 
     - [Enabling Web Worker Support](#enabling-web-worker-support)
     - [Examples](#examples)
 
-34. [Angular Zone.js Configuration](#angular-zonejs-configuration)
-35. [CDN](#cdn)
+35. [Angular Zone.js Configuration](#angular-zonejs-configuration)
+36. [CDN](#cdn)
 
     - [Specific Version](#specific-version-recommended)
     - [ES5](#es5)
@@ -76,7 +77,7 @@
       - [Via JS File](#via-js-file)
       - [Via TS File](#via-ts-file)
 
-36. [Flutter Web](#flutter-web)
+37. [Flutter Web](#flutter-web)
 
 ---
 
@@ -454,6 +455,19 @@ CoralogixRum.init({
 });
 ```
 
+### Manually Create a New Session
+
+By default the SDK rotates the session automatically — after 15 minutes of inactivity, or once a session reaches 1 hour. Starting with version `3.19.0`, you can also rotate it on demand by calling `CoralogixRum.createNewSession()`, for example when a user logs out, so that subsequent events are attributed to a fresh session.
+
+```javascript
+import { CoralogixRum } from '@coralogix/browser';
+
+// e.g. inside your logout handler
+CoralogixRum.createNewSession();
+```
+
+This ends the current session and immediately starts a new one with a new session id. If session recording is active, the current recording is finalized and a new one begins for the new session.
+
 ### Unique Users
 
 Starting with version `2.9.0`, the SDK calculates unique users based on the user’s `fingerprint`.<br>

package/index.esm2.js

@@ -4568,6 +4568,10 @@ var SessionManager = (function (_super) {
         _this._currentPageTimestamp = getNowTime();
         _this._viewNumber = 0;
         _this.debugMode = !!((_a = getSdkConfig()) === null || _a === void 0 ? void 0 : _a.debug);
+        _this.recreateSession = function () {
+            _this.clearSessionWhenIdle();
+            return _this.setSession(true);
+        };
         _this.getPrevSession = function () {
             var _a;
             return JSON.parse((_a = CxGlobal.sessionStorage) === null || _a === void 0 ? void 0 : _a.getItem(PREV_SESSION_KEY));
@@ -5035,7 +5039,7 @@ function resolveUrlBlueprinters(urlBlueprinters) {
     return resolvedUrlBlueprinters;
 }
 
-var SDK_VERSION = '3.18.0';
+var SDK_VERSION = '3.19.0';
 
 function shouldDropEvent(cxRumEvent, options) {
     if (isDocumentErrorWithoutMessage(cxRumEvent)) {
@@ -5990,6 +5994,14 @@ var CoralogixRum = {
         var _a, _b;
         return (_b = (_a = getSessionManager()) === null || _a === void 0 ? void 0 : _a.getSession()) === null || _b === void 0 ? void 0 : _b.sessionId;
     },
+    createNewSession: function () {
+        var _a;
+        if (!isInited) {
+            console.debug('CoralogixRum must be initiated before creating a new session');
+            return;
+        }
+        (_a = getSessionManager()) === null || _a === void 0 ? void 0 : _a.recreateSession();
+    },
     log: function (severity, message, data, labels) {
         if (!isInited) {
             console.debug('CoralogixRum must be initiated before using log');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralogix/browser",
-  "version": "3.18.0",
+  "version": "3.19.0",
   "description": "Official Coralogix SDK for browsers",
   "license": "Apache-2.0",
   "author": "Coralogix",

package/src/session/sessionManager.d.ts

@@ -36,6 +36,7 @@ export declare class SessionManager extends SessionIdle {
     getActiveSession(): Session;
     start(): void;
     stop(): void;
+    recreateSession: () => Session;
     getPrevSession: () => PrevSession;
     getSession: () => Session;
     private initializeSession;

package/src/types.d.ts

@@ -186,6 +186,7 @@ export interface CoralogixOtelWebType extends SendLog {
     measureUserAgentSpecificMemory: () => void;
     getUserContext: () => UserContextConfig | undefined;
     getSessionId: () => string | undefined;
+    createNewSession: () => void;
     stopSessionRecording: () => void;
     startSessionRecording: () => void;
     screenshot: (description?: string) => string | undefined;

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.18.0";
+export declare const SDK_VERSION = "3.19.0";