@zeniai/client-epic-state 5.1.18-betaDI1 → 5.1.18-betaDI3

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

@@ -0,0 +1,337 @@
+/**
+ * SessionManager — Central session lifecycle manager.
+ *
+ * Responsibilities:
+ * 1. Track user activity (mousemove, keydown, click, scroll, touch)
+ * 2. Send heartbeat at configurable intervals — only when user has been active
+ * 3. Show warning popup after idle timeout
+ * 4. Auto-logout after warning countdown expires
+ * 5. Sync activity across same-origin tabs via BroadcastChannel so one
+ *    active tab keeps other tabs' sessions alive (no cascading logout).
+ */
+import { DEFAULT_SESSION_CONFIG, } from './sessionTypes';
+/** Events that indicate user activity. */
+const ACTIVITY_EVENTS = [
+    'mousemove',
+    'mousedown',
+    'keydown',
+    'scroll',
+    'touchstart',
+    'click',
+];
+/** Debounce interval for activity events. Also reused as the cadence for
+ *  idle checks and the countdown ticker — all are 1-second taps. */
+const ACTIVITY_DEBOUNCE_MS = 1000;
+/** Pure unit-conversion constants. Kept separate from ACTIVITY_DEBOUNCE_MS
+ *  so changing the debounce cadence cannot silently change time math. */
+const MS_PER_SECOND = 1000;
+const MS_PER_MINUTE = 60 * MS_PER_SECOND;
+/** Name of the BroadcastChannel used for cross-tab activity sync. */
+const BROADCAST_CHANNEL_NAME = 'zeni-session-activity';
+export class SessionManager {
+    constructor() {
+        this.config = DEFAULT_SESSION_CONFIG;
+        this.callbacks = null;
+        /** Timestamps and timers */
+        this.lastActivityTime = 0;
+        /** Timestamp of the last heartbeat fire (initial/periodic/continue/activity). */
+        this.lastHeartbeatTime = 0;
+        /** Set to true whenever user (or any same-origin tab) shows activity. */
+        this.hadActivitySinceLastHeartbeat = false;
+        this.idleCheckInterval = null;
+        this.heartbeatInterval = null;
+        this.countdownInterval = null;
+        this.activityDebounceTimer = null;
+        /** State */
+        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. */
+        this.boundOnActivity = this.onActivity.bind(this);
+        this.boundOnVisibilityChange = this.onVisibilityChange.bind(this);
+        this.boundOnBroadcastMessage = this.onBroadcastMessage.bind(this);
+    }
+    // ─── Public API ────────────────────────────────────────────
+    start(config = {}, callbacks) {
+        if (this.running) {
+            this.stop();
+        }
+        this.config = { ...DEFAULT_SESSION_CONFIG, ...config };
+        this.callbacks = callbacks;
+        this.running = true;
+        this.warningActive = false;
+        this.lastActivityTime = Date.now();
+        this.lastHeartbeatTime = 0;
+        this.hadActivitySinceLastHeartbeat = true; // initial heartbeat is expected
+        const heartbeatEnabled = this.config.heartbeatIntervalMinutes > 0;
+        const idleTrackingEnabled = this.config.isAutoLogoutEnabled;
+        if (!heartbeatEnabled && !idleTrackingEnabled) {
+            return;
+        }
+        // Activity listeners — needed for both heartbeat activity-gate and idle
+        // detection. BroadcastChannel keeps multiple tabs in sync.
+        ACTIVITY_EVENTS.forEach((event) => {
+            document.addEventListener(event, this.boundOnActivity, {
+                capture: true,
+                passive: true,
+            });
+        });
+        this.setupBroadcastChannel();
+        if (heartbeatEnabled) {
+            this.startHeartbeat();
+            // Initial heartbeat on sign-in
+            this.fireHeartbeat();
+        }
+        if (idleTrackingEnabled) {
+            document.addEventListener('visibilitychange', this.boundOnVisibilityChange);
+            this.idleCheckInterval = setInterval(() => this.checkIdle(), ACTIVITY_DEBOUNCE_MS);
+        }
+    }
+    stop() {
+        this.running = false;
+        this.warningActive = false;
+        ACTIVITY_EVENTS.forEach((event) => {
+            document.removeEventListener(event, this.boundOnActivity, {
+                capture: true,
+            });
+        });
+        document.removeEventListener('visibilitychange', this.boundOnVisibilityChange);
+        this.teardownBroadcastChannel();
+        this.clearTimer('idleCheckInterval');
+        this.clearTimer('heartbeatInterval');
+        this.clearTimer('countdownInterval');
+        this.clearTimer('activityDebounceTimer');
+    }
+    continueSession() {
+        if (!this.running) {
+            return;
+        }
+        this.warningActive = false;
+        this.secondsRemaining = 0;
+        this.lastActivityTime = Date.now();
+        this.hadActivitySinceLastHeartbeat = true;
+        this.clearTimer('countdownInterval');
+        // Fire heartbeat immediately — user explicitly extended the session
+        this.fireHeartbeat();
+        this.callbacks?.onSessionExtended();
+        this.broadcast({ type: 'activity', timestamp: Date.now() });
+        this.startHeartbeat();
+    }
+    isWarningActive() {
+        return this.warningActive;
+    }
+    getSecondsRemaining() {
+        return this.secondsRemaining;
+    }
+    // ─── Private ───────────────────────────────────────────────
+    onActivity() {
+        if (!this.running || this.warningActive) {
+            return;
+        }
+        // Debounce: only update lastActivityTime at most once per second
+        if (this.activityDebounceTimer != null) {
+            return;
+        }
+        const now = Date.now();
+        this.registerActivity(now);
+        this.broadcast({ type: 'activity', timestamp: now });
+        // If heartbeat is enabled and the interval has elapsed since the last
+        // heartbeat, fire one immediately and restart the timer. This covers
+        // the "user active again after >interval idle" case without waiting
+        // for the next scheduled tick.
+        if (this.config.heartbeatIntervalMinutes > 0) {
+            const intervalMs = this.config.heartbeatIntervalMinutes * MS_PER_MINUTE;
+            const timeSinceLastHeartbeat = now - this.lastHeartbeatTime;
+            if (timeSinceLastHeartbeat >= intervalMs) {
+                this.fireHeartbeat();
+                this.startHeartbeat();
+            }
+        }
+        this.activityDebounceTimer = setTimeout(() => {
+            this.activityDebounceTimer = null;
+        }, ACTIVITY_DEBOUNCE_MS);
+    }
+    onVisibilityChange() {
+        if (!this.running) {
+            return;
+        }
+        if (document.visibilityState === 'visible') {
+            // Sleep/wake case: before resetting activity for the "user switched
+            // tabs" path, check whether the full grace period has already elapsed.
+            // If so, log out immediately rather than handing back another window.
+            const idleMs = Date.now() - this.lastActivityTime;
+            const fullGracePeriodMs = this.config.idleTimeoutMinutes * MS_PER_MINUTE +
+                this.config.warningDurationSeconds * MS_PER_SECOND;
+            if (idleMs >= fullGracePeriodMs) {
+                this.secondsRemaining = 0;
+                this.stop();
+                this.callbacks?.onAutoLogout();
+                return;
+            }
+            if (this.warningActive) {
+                // Tab was hidden while countdown was running — check if it already expired.
+                const elapsed = Math.floor((Date.now() - this.warningStartTime) / MS_PER_SECOND);
+                if (elapsed >= this.config.warningDurationSeconds) {
+                    this.secondsRemaining = 0;
+                    this.stop();
+                    this.callbacks?.onAutoLogout();
+                }
+                return;
+            }
+            // Industry-standard idle detection: resetting on tab focus is expected.
+            this.registerActivity(Date.now());
+            this.checkIdle();
+        }
+    }
+    /** Single source of truth for marking activity locally. */
+    registerActivity(timestamp) {
+        this.lastActivityTime = Math.max(this.lastActivityTime, timestamp);
+        this.hadActivitySinceLastHeartbeat = true;
+    }
+    checkIdle() {
+        if (!this.running || this.warningActive) {
+            return;
+        }
+        const idleMs = Date.now() - this.lastActivityTime;
+        const idleTimeoutMs = this.config.idleTimeoutMinutes * MS_PER_MINUTE;
+        const warningDurationMs = this.config.warningDurationSeconds * MS_PER_SECOND;
+        const fullGracePeriodMs = idleTimeoutMs + warningDurationMs;
+        // System-sleep / long-idle case: if the full grace period (idle timeout +
+        // warning countdown) has already elapsed, skip the popup and log out
+        // immediately. This catches the wake-from-sleep case where JS was paused
+        // long enough that the user has effectively missed both windows.
+        if (idleMs >= fullGracePeriodMs) {
+            this.secondsRemaining = 0;
+            this.stop();
+            this.callbacks?.onAutoLogout();
+            return;
+        }
+        if (idleMs >= idleTimeoutMs) {
+            this.startWarning();
+        }
+    }
+    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(() => {
+            const elapsed = Math.floor((Date.now() - this.warningStartTime) / MS_PER_SECOND);
+            const remaining = this.config.warningDurationSeconds - elapsed;
+            if (remaining <= 0) {
+                this.secondsRemaining = 0;
+                // stop() clears all timers and listeners before the callback fires so
+                // no late tick can re-trigger checkIdle → startWarning if the consumer
+                // delays or skips the redirect in onAutoLogout.
+                this.stop();
+                this.callbacks?.onAutoLogout();
+            }
+            else {
+                this.secondsRemaining = remaining;
+                this.callbacks?.onWarningTick(this.secondsRemaining);
+            }
+        }, ACTIVITY_DEBOUNCE_MS);
+    }
+    startHeartbeat() {
+        this.clearTimer('heartbeatInterval');
+        const intervalMs = this.config.heartbeatIntervalMinutes * MS_PER_MINUTE;
+        this.heartbeatInterval = setInterval(() => {
+            if (!this.running || this.warningActive) {
+                return;
+            }
+            if (!this.hadActivitySinceLastHeartbeat) {
+                return;
+            }
+            this.fireHeartbeat();
+        }, intervalMs);
+    }
+    fireHeartbeat() {
+        this.lastHeartbeatTime = Date.now();
+        this.hadActivitySinceLastHeartbeat = false;
+        this.callbacks?.onHeartbeat();
+        // Let other tabs know we just fired a heartbeat — they can skip theirs
+        // this cycle to avoid N tabs all firing heartbeats.
+        this.broadcast({
+            type: 'heartbeat-fired',
+            timestamp: this.lastHeartbeatTime,
+        });
+    }
+    // ─── BroadcastChannel (cross-tab activity sync) ───────────
+    setupBroadcastChannel() {
+        if (typeof BroadcastChannel === 'undefined') {
+            return;
+        }
+        try {
+            this.broadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+            this.broadcastChannel.addEventListener('message', this.boundOnBroadcastMessage);
+        }
+        catch (err) {
+            console.warn('[SessionManager] BroadcastChannel setup failed:', err);
+            this.broadcastChannel = null;
+        }
+    }
+    teardownBroadcastChannel() {
+        if (this.broadcastChannel == null) {
+            return;
+        }
+        this.broadcastChannel.removeEventListener('message', this.boundOnBroadcastMessage);
+        this.broadcastChannel.close();
+        this.broadcastChannel = null;
+    }
+    broadcast(message) {
+        this.broadcastChannel?.postMessage(message);
+    }
+    onBroadcastMessage(event) {
+        if (!this.running) {
+            return;
+        }
+        const msg = event.data;
+        if (msg == null) {
+            return;
+        }
+        if (msg.type === 'activity') {
+            // Another tab saw user activity — treat as activity here too.
+            this.registerActivity(msg.timestamp);
+        }
+        else if (msg.type === 'heartbeat-fired') {
+            // Another tab already fired a heartbeat in this interval — backend
+            // session is already extended. Reset our local tracking so we don't
+            // also fire one this cycle.
+            this.lastHeartbeatTime = Math.max(this.lastHeartbeatTime, msg.timestamp);
+            this.hadActivitySinceLastHeartbeat = false;
+        }
+        // If this tab is showing the warning but another tab is active, dismiss it —
+        // the user is clearly still working. Backend session is already being
+        // extended by the active tab, so we just reset local state and resume
+        // the heartbeat timer that was paused when the warning started.
+        if (this.warningActive) {
+            this.warningActive = false;
+            this.secondsRemaining = 0;
+            this.clearTimer('countdownInterval');
+            this.callbacks?.onSessionExtended();
+            this.startHeartbeat();
+        }
+    }
+    clearTimer(name) {
+        const timer = this[name];
+        if (timer != null) {
+            if (name === 'activityDebounceTimer') {
+                clearTimeout(timer);
+            }
+            else {
+                clearInterval(timer);
+            }
+            this[name] = null;
+        }
+    }
+}
+//# sourceMappingURL=SessionManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.js","sourceRoot":"","sources":["../../../../src/entity/tenant/SessionManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SessionManager — Central session lifecycle manager.\n *\n * Responsibilities:\n * 1. Track user activity (mousemove, keydown, click, scroll, touch)\n * 2. Send heartbeat at configurable intervals — only when user has been active\n * 3. Show warning popup after idle timeout\n * 4. Auto-logout after warning countdown expires\n * 5. Sync activity across same-origin tabs via BroadcastChannel so one\n *    active tab keeps other tabs' sessions alive (no cascading logout).\n */\nimport {\n  DEFAULT_SESSION_CONFIG,\n  SessionCallbacks,\n  SessionConfig,\n} from './sessionTypes';\n\n/** Events that indicate user activity. */\nconst ACTIVITY_EVENTS: Array<keyof DocumentEventMap> = [\n  'mousemove',\n  'mousedown',\n  'keydown',\n  'scroll',\n  'touchstart',\n  'click',\n];\n\n/** Debounce interval for activity events. Also reused as the cadence for\n *  idle checks and the countdown ticker — all are 1-second taps. */\nconst ACTIVITY_DEBOUNCE_MS = 1_000;\n/** Pure unit-conversion constants. Kept separate from ACTIVITY_DEBOUNCE_MS\n *  so changing the debounce cadence cannot silently change time math. */\nconst MS_PER_SECOND = 1_000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\n\n/** Name of the BroadcastChannel used for cross-tab activity sync. */\nconst BROADCAST_CHANNEL_NAME = 'zeni-session-activity';\n\ntype BroadcastMessage =\n  | {timestamp: number; type: 'activity'}\n  | {timestamp: number; type: 'heartbeat-fired'};\n\nexport class SessionManager {\n  private config: SessionConfig = DEFAULT_SESSION_CONFIG;\n  private callbacks: SessionCallbacks | null = null;\n\n  /** Timestamps and timers */\n  private lastActivityTime = 0;\n  /** Timestamp of the last heartbeat fire (initial/periodic/continue/activity). */\n  private lastHeartbeatTime = 0;\n  /** Set to true whenever user (or any same-origin tab) shows activity. */\n  private hadActivitySinceLastHeartbeat = false;\n  private idleCheckInterval: ReturnType<typeof setInterval> | null = null;\n  private heartbeatInterval: ReturnType<typeof setInterval> | null = null;\n  private countdownInterval: ReturnType<typeof setInterval> | null = null;\n  private activityDebounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  /** State */\n  private running = false;\n  private warningActive = false;\n  private secondsRemaining = 0;\n  /** Wall-clock timestamp when the warning countdown began (for background-tab accuracy). */\n  private warningStartTime = 0;\n\n  /** Cross-tab activity sync */\n  private broadcastChannel: BroadcastChannel | null = null;\n\n  /** Bound handlers for event listener cleanup. */\n  private boundOnActivity = this.onActivity.bind(this);\n  private boundOnVisibilityChange = this.onVisibilityChange.bind(this);\n  private boundOnBroadcastMessage = this.onBroadcastMessage.bind(this);\n\n  // ─── Public API ────────────────────────────────────────────\n\n  start(\n    config: Partial<SessionConfig> = {},\n    callbacks: SessionCallbacks\n  ): void {\n    if (this.running) {\n      this.stop();\n    }\n\n    this.config = {...DEFAULT_SESSION_CONFIG, ...config};\n    this.callbacks = callbacks;\n    this.running = true;\n    this.warningActive = false;\n    this.lastActivityTime = Date.now();\n    this.lastHeartbeatTime = 0;\n    this.hadActivitySinceLastHeartbeat = true; // initial heartbeat is expected\n\n    const heartbeatEnabled = this.config.heartbeatIntervalMinutes > 0;\n    const idleTrackingEnabled = this.config.isAutoLogoutEnabled;\n\n    if (!heartbeatEnabled && !idleTrackingEnabled) {\n      return;\n    }\n\n    // Activity listeners — needed for both heartbeat activity-gate and idle\n    // detection. BroadcastChannel keeps multiple tabs in sync.\n    ACTIVITY_EVENTS.forEach((event) => {\n      document.addEventListener(event, this.boundOnActivity, {\n        capture: true,\n        passive: true,\n      });\n    });\n    this.setupBroadcastChannel();\n\n    if (heartbeatEnabled) {\n      this.startHeartbeat();\n      // Initial heartbeat on sign-in\n      this.fireHeartbeat();\n    }\n\n    if (idleTrackingEnabled) {\n      document.addEventListener(\n        'visibilitychange',\n        this.boundOnVisibilityChange\n      );\n      this.idleCheckInterval = setInterval(\n        () => this.checkIdle(),\n        ACTIVITY_DEBOUNCE_MS\n      );\n    }\n  }\n\n  stop(): void {\n    this.running = false;\n    this.warningActive = false;\n\n    ACTIVITY_EVENTS.forEach((event) => {\n      document.removeEventListener(event, this.boundOnActivity, {\n        capture: true,\n      });\n    });\n    document.removeEventListener(\n      'visibilitychange',\n      this.boundOnVisibilityChange\n    );\n\n    this.teardownBroadcastChannel();\n\n    this.clearTimer('idleCheckInterval');\n    this.clearTimer('heartbeatInterval');\n    this.clearTimer('countdownInterval');\n    this.clearTimer('activityDebounceTimer');\n  }\n\n  continueSession(): void {\n    if (!this.running) {\n      return;\n    }\n\n    this.warningActive = false;\n    this.secondsRemaining = 0;\n    this.lastActivityTime = Date.now();\n    this.hadActivitySinceLastHeartbeat = true;\n\n    this.clearTimer('countdownInterval');\n\n    // Fire heartbeat immediately — user explicitly extended the session\n    this.fireHeartbeat();\n    this.callbacks?.onSessionExtended();\n\n    this.broadcast({type: 'activity', timestamp: Date.now()});\n    this.startHeartbeat();\n  }\n\n  isWarningActive(): boolean {\n    return this.warningActive;\n  }\n\n  getSecondsRemaining(): number {\n    return this.secondsRemaining;\n  }\n\n  // ─── Private ───────────────────────────────────────────────\n\n  private onActivity(): void {\n    if (!this.running || this.warningActive) {\n      return;\n    }\n\n    // Debounce: only update lastActivityTime at most once per second\n    if (this.activityDebounceTimer != null) {\n      return;\n    }\n\n    const now = Date.now();\n    this.registerActivity(now);\n    this.broadcast({type: 'activity', timestamp: now});\n\n    // If heartbeat is enabled and the interval has elapsed since the last\n    // heartbeat, fire one immediately and restart the timer. This covers\n    // the \"user active again after >interval idle\" case without waiting\n    // for the next scheduled tick.\n    if (this.config.heartbeatIntervalMinutes > 0) {\n      const intervalMs = this.config.heartbeatIntervalMinutes * MS_PER_MINUTE;\n      const timeSinceLastHeartbeat = now - this.lastHeartbeatTime;\n      if (timeSinceLastHeartbeat >= intervalMs) {\n        this.fireHeartbeat();\n        this.startHeartbeat();\n      }\n    }\n\n    this.activityDebounceTimer = setTimeout(() => {\n      this.activityDebounceTimer = null;\n    }, ACTIVITY_DEBOUNCE_MS);\n  }\n\n  private onVisibilityChange(): void {\n    if (!this.running) {\n      return;\n    }\n\n    if (document.visibilityState === 'visible') {\n      // Sleep/wake case: before resetting activity for the \"user switched\n      // tabs\" path, check whether the full grace period has already elapsed.\n      // If so, log out immediately rather than handing back another window.\n      const idleMs = Date.now() - this.lastActivityTime;\n      const fullGracePeriodMs =\n        this.config.idleTimeoutMinutes * MS_PER_MINUTE +\n        this.config.warningDurationSeconds * MS_PER_SECOND;\n      if (idleMs >= fullGracePeriodMs) {\n        this.secondsRemaining = 0;\n        this.stop();\n        this.callbacks?.onAutoLogout();\n        return;\n      }\n\n      if (this.warningActive) {\n        // Tab was hidden while countdown was running — check if it already expired.\n        const elapsed = Math.floor(\n          (Date.now() - this.warningStartTime) / MS_PER_SECOND\n        );\n        if (elapsed >= this.config.warningDurationSeconds) {\n          this.secondsRemaining = 0;\n          this.stop();\n          this.callbacks?.onAutoLogout();\n        }\n        return;\n      }\n\n      // Industry-standard idle detection: resetting on tab focus is expected.\n      this.registerActivity(Date.now());\n      this.checkIdle();\n    }\n  }\n\n  /** Single source of truth for marking activity locally. */\n  private registerActivity(timestamp: number): void {\n    this.lastActivityTime = Math.max(this.lastActivityTime, timestamp);\n    this.hadActivitySinceLastHeartbeat = true;\n  }\n\n  private checkIdle(): void {\n    if (!this.running || this.warningActive) {\n      return;\n    }\n\n    const idleMs = Date.now() - this.lastActivityTime;\n    const idleTimeoutMs = this.config.idleTimeoutMinutes * MS_PER_MINUTE;\n    const warningDurationMs =\n      this.config.warningDurationSeconds * MS_PER_SECOND;\n    const fullGracePeriodMs = idleTimeoutMs + warningDurationMs;\n\n    // System-sleep / long-idle case: if the full grace period (idle timeout +\n    // warning countdown) has already elapsed, skip the popup and log out\n    // immediately. This catches the wake-from-sleep case where JS was paused\n    // long enough that the user has effectively missed both windows.\n    if (idleMs >= fullGracePeriodMs) {\n      this.secondsRemaining = 0;\n      this.stop();\n      this.callbacks?.onAutoLogout();\n      return;\n    }\n\n    if (idleMs >= idleTimeoutMs) {\n      this.startWarning();\n    }\n  }\n\n  private startWarning(): void {\n    this.warningActive = true;\n    this.warningStartTime = Date.now();\n    this.secondsRemaining = this.config.warningDurationSeconds;\n\n    // Don't extend session while warning is showing.\n    this.clearTimer('heartbeatInterval');\n\n    this.callbacks?.onWarningStart(this.secondsRemaining);\n\n    // Use wall-clock elapsed time so countdown stays accurate in background tabs.\n    // Browsers throttle setInterval when the tab is hidden, but each tick\n    // recomputes from the real start time so no seconds are \"lost\".\n    this.countdownInterval = setInterval(() => {\n      const elapsed = Math.floor(\n        (Date.now() - this.warningStartTime) / MS_PER_SECOND\n      );\n      const remaining = this.config.warningDurationSeconds - elapsed;\n\n      if (remaining <= 0) {\n        this.secondsRemaining = 0;\n        // stop() clears all timers and listeners before the callback fires so\n        // no late tick can re-trigger checkIdle → startWarning if the consumer\n        // delays or skips the redirect in onAutoLogout.\n        this.stop();\n        this.callbacks?.onAutoLogout();\n      } else {\n        this.secondsRemaining = remaining;\n        this.callbacks?.onWarningTick(this.secondsRemaining);\n      }\n    }, ACTIVITY_DEBOUNCE_MS);\n  }\n\n  private startHeartbeat(): void {\n    this.clearTimer('heartbeatInterval');\n\n    const intervalMs = this.config.heartbeatIntervalMinutes * MS_PER_MINUTE;\n    this.heartbeatInterval = setInterval(() => {\n      if (!this.running || this.warningActive) {\n        return;\n      }\n      if (!this.hadActivitySinceLastHeartbeat) {\n        return;\n      }\n      this.fireHeartbeat();\n    }, intervalMs);\n  }\n\n  private fireHeartbeat(): void {\n    this.lastHeartbeatTime = Date.now();\n    this.hadActivitySinceLastHeartbeat = false;\n    this.callbacks?.onHeartbeat();\n    // Let other tabs know we just fired a heartbeat — they can skip theirs\n    // this cycle to avoid N tabs all firing heartbeats.\n    this.broadcast({\n      type: 'heartbeat-fired',\n      timestamp: this.lastHeartbeatTime,\n    });\n  }\n\n  // ─── BroadcastChannel (cross-tab activity sync) ───────────\n\n  private setupBroadcastChannel(): void {\n    if (typeof BroadcastChannel === 'undefined') {\n      return;\n    }\n    try {\n      this.broadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);\n      this.broadcastChannel.addEventListener(\n        'message',\n        this.boundOnBroadcastMessage\n      );\n    } catch (err) {\n      console.warn('[SessionManager] BroadcastChannel setup failed:', err);\n      this.broadcastChannel = null;\n    }\n  }\n\n  private teardownBroadcastChannel(): void {\n    if (this.broadcastChannel == null) {\n      return;\n    }\n    this.broadcastChannel.removeEventListener(\n      'message',\n      this.boundOnBroadcastMessage\n    );\n    this.broadcastChannel.close();\n    this.broadcastChannel = null;\n  }\n\n  private broadcast(message: BroadcastMessage): void {\n    this.broadcastChannel?.postMessage(message);\n  }\n\n  private onBroadcastMessage(event: MessageEvent<BroadcastMessage>): void {\n    if (!this.running) {\n      return;\n    }\n    const msg = event.data;\n    if (msg == null) {\n      return;\n    }\n\n    if (msg.type === 'activity') {\n      // Another tab saw user activity — treat as activity here too.\n      this.registerActivity(msg.timestamp);\n    } else if (msg.type === 'heartbeat-fired') {\n      // Another tab already fired a heartbeat in this interval — backend\n      // session is already extended. Reset our local tracking so we don't\n      // also fire one this cycle.\n      this.lastHeartbeatTime = Math.max(this.lastHeartbeatTime, msg.timestamp);\n      this.hadActivitySinceLastHeartbeat = false;\n    }\n\n    // If this tab is showing the warning but another tab is active, dismiss it —\n    // the user is clearly still working. Backend session is already being\n    // extended by the active tab, so we just reset local state and resume\n    // the heartbeat timer that was paused when the warning started.\n    if (this.warningActive) {\n      this.warningActive = false;\n      this.secondsRemaining = 0;\n      this.clearTimer('countdownInterval');\n      this.callbacks?.onSessionExtended();\n      this.startHeartbeat();\n    }\n  }\n\n  private clearTimer(\n    name:\n      | 'idleCheckInterval'\n      | 'heartbeatInterval'\n      | 'countdownInterval'\n      | 'activityDebounceTimer'\n  ): void {\n    const timer = this[name];\n    if (timer != null) {\n      if (name === 'activityDebounceTimer') {\n        clearTimeout(timer);\n      } else {\n        clearInterval(timer as ReturnType<typeof setInterval>);\n      }\n      this[name] = null;\n    }\n  }\n}\n"]}