@zeniai/client-epic-state 5.0.12-beta1ND → 5.0.12-beta2ND

package/lib/entity/tenant/SessionManager.d.ts

@@ -27,6 +27,8 @@ export declare class SessionManager {
     private running;
     private warningActive;
     private secondsRemaining;
+    /** Wall-clock timestamp when the warning countdown began (for background-tab accuracy). */
+    private warningStartTime;
     /** Cross-tab activity sync */
     private broadcastChannel;
     /** Bound handlers for event listener cleanup. */

package/lib/entity/tenant/SessionManager.js

@@ -44,6 +44,8 @@ class SessionManager {
         this.running = false;
         this.warningActive = false;
         this.secondsRemaining = 0;
+        /** Wall-clock timestamp when the warning countdown began (for background-tab accuracy). */
+        this.warningStartTime = 0;
         /** Cross-tab activity sync */
         this.broadcastChannel = null;
         /** Bound handlers for event listener cleanup. */
@@ -163,8 +165,19 @@ class SessionManager {
         if (!this.running) {
             return;
         }
-        // Industry-standard idle detection: resetting on tab focus is expected.
         if (document.visibilityState === 'visible') {
+            if (this.warningActive) {
+                // Tab was hidden while countdown was running — check if it already expired.
+                const elapsed = Math.floor((Date.now() - this.warningStartTime) / 1000);
+                if (elapsed >= this.config.warningDurationSeconds) {
+                    this.secondsRemaining = 0;
+                    this.clearTimer('countdownInterval');
+                    this.warningActive = false;
+                    this.callbacks?.onAutoLogout();
+                }
+                return;
+            }
+            // Industry-standard idle detection: resetting on tab focus is expected.
             this.registerActivity(Date.now());
             this.checkIdle();
         }
@@ -186,18 +199,25 @@ class SessionManager {
     }
     startWarning() {
         this.warningActive = true;
+        this.warningStartTime = Date.now();
         this.secondsRemaining = this.config.warningDurationSeconds;
         // Don't extend session while warning is showing.
         this.clearTimer('heartbeatInterval');
         this.callbacks?.onWarningStart(this.secondsRemaining);
+        // Use wall-clock elapsed time so countdown stays accurate in background tabs.
+        // Browsers throttle setInterval when the tab is hidden, but each tick
+        // recomputes from the real start time so no seconds are "lost".
         this.countdownInterval = setInterval(() => {
-            this.secondsRemaining -= 1;
-            if (this.secondsRemaining <= 0) {
+            const elapsed = Math.floor((Date.now() - this.warningStartTime) / 1000);
+            const remaining = this.config.warningDurationSeconds - elapsed;
+            if (remaining <= 0) {
+                this.secondsRemaining = 0;
                 this.clearTimer('countdownInterval');
                 this.warningActive = false;
                 this.callbacks?.onAutoLogout();
             }
             else {
+                this.secondsRemaining = remaining;
                 this.callbacks?.onWarningTick(this.secondsRemaining);
             }
         }, 1000);

package/lib/esm/entity/tenant/SessionManager.js

@@ -41,6 +41,8 @@ export class SessionManager {
         this.running = false;
         this.warningActive = false;
         this.secondsRemaining = 0;
+        /** Wall-clock timestamp when the warning countdown began (for background-tab accuracy). */
+        this.warningStartTime = 0;
         /** Cross-tab activity sync */
         this.broadcastChannel = null;
         /** Bound handlers for event listener cleanup. */
@@ -160,8 +162,19 @@ export class SessionManager {
         if (!this.running) {
             return;
         }
-        // Industry-standard idle detection: resetting on tab focus is expected.
         if (document.visibilityState === 'visible') {
+            if (this.warningActive) {
+                // Tab was hidden while countdown was running — check if it already expired.
+                const elapsed = Math.floor((Date.now() - this.warningStartTime) / 1000);
+                if (elapsed >= this.config.warningDurationSeconds) {
+                    this.secondsRemaining = 0;
+                    this.clearTimer('countdownInterval');
+                    this.warningActive = false;
+                    this.callbacks?.onAutoLogout();
+                }
+                return;
+            }
+            // Industry-standard idle detection: resetting on tab focus is expected.
             this.registerActivity(Date.now());
             this.checkIdle();
         }
@@ -183,18 +196,25 @@ export class SessionManager {
     }
     startWarning() {
         this.warningActive = true;
+        this.warningStartTime = Date.now();
         this.secondsRemaining = this.config.warningDurationSeconds;
         // Don't extend session while warning is showing.
         this.clearTimer('heartbeatInterval');
         this.callbacks?.onWarningStart(this.secondsRemaining);
+        // Use wall-clock elapsed time so countdown stays accurate in background tabs.
+        // Browsers throttle setInterval when the tab is hidden, but each tick
+        // recomputes from the real start time so no seconds are "lost".
         this.countdownInterval = setInterval(() => {
-            this.secondsRemaining -= 1;
-            if (this.secondsRemaining <= 0) {
+            const elapsed = Math.floor((Date.now() - this.warningStartTime) / 1000);
+            const remaining = this.config.warningDurationSeconds - elapsed;
+            if (remaining <= 0) {
+                this.secondsRemaining = 0;
                 this.clearTimer('countdownInterval');
                 this.warningActive = false;
                 this.callbacks?.onAutoLogout();
             }
             else {
+                this.secondsRemaining = remaining;
                 this.callbacks?.onWarningTick(this.secondsRemaining);
             }
         }, 1000);