@zeniai/client-epic-state 5.0.11 → 5.0.12-beta0ND

package/lib/common/aiCfo/aiCfoSuggestedQuestionsPageContext.d.ts

@@ -16,4 +16,4 @@
  *
  * @see README.md in this directory for maintenance expectations.
  */
-export type AiCfoSuggestedQuestionsPageContext = 'balance_sheet' | 'profit_loss' | 'vendors' | 'transactions' | 'cash_flow' | 'accounts_receivable' | 'accounts_payable' | 'transaction_details' | 'dashboard' | 'cash_balance' | 'card_balance' | 'command_centre' | 'je_schedules' | 'reconciliation' | 'flux_analysis' | 'receipts' | 'mei' | 'task_checklist' | 'performance' | 'bills_list' | 'bills_details' | 'reimbursement_list' | 'reimbursement_details' | 'vendors_summary' | 'opex_by_vendor' | 'prepaid_expenses' | 'fixed_assets' | 'form_1099' | 'accrued_expenses' | 'forecast' | 'checking' | 'checking_details' | 'treasury' | 'cards' | 'cards_detail' | 'people' | 'rewards' | 'notifications';
+export type AiCfoSuggestedQuestionsPageContext = 'balance_sheet' | 'profit_loss' | 'vendors' | 'transactions' | 'cash_flow' | 'accounts_receivable' | 'accounts_payable' | 'transaction_details' | 'dashboard' | 'cash_balance' | 'card_balance' | 'cash_in_cash_out' | 'net_burn_or_income' | 'cash_position' | 'top_expenses' | 'revenue' | 'operating_expenses' | 'command_centre' | 'je_schedules' | 'reconciliation' | 'flux_analysis' | 'receipts' | 'mei' | 'task_checklist' | 'performance' | 'bills_list' | 'bills_details' | 'reimbursement_list' | 'reimbursement_details' | 'vendors_summary' | 'opex_by_vendor' | 'prepaid_expenses' | 'fixed_assets' | 'form_1099' | 'accrued_expenses' | 'forecast' | 'checking' | 'checking_details' | 'treasury' | 'cards' | 'cards_detail' | 'people' | 'rewards' | 'notifications';

package/lib/coreEpics.js

@@ -24,6 +24,7 @@ const resendVerifyDeviceOTPEpic_1 = require("./entity/tenant/epic/resendVerifyDe
 const saveExternalConnectionEpic_1 = require("./entity/tenant/epic/saveExternalConnectionEpic");
 const sendEmailMagicLinkToUserEpic_1 = require("./entity/tenant/epic/sendEmailMagicLinkToUserEpic");
 const signInUserEpic_1 = require("./entity/tenant/epic/signInUserEpic");
+const sessionHeartbeatEpic_1 = require("./entity/tenant/epic/sessionHeartbeatEpic");
 const signOutUserEpic_1 = require("./entity/tenant/epic/signOutUserEpic");
 const verifyDeviceWithTwoFAEpic_1 = require("./entity/tenant/epic/verifyDeviceWithTwoFAEpic");
 // ── Toast Notification Epic ──────────────────────────────────────────
@@ -48,7 +49,7 @@ const verifyOtpEpic_1 = require("./view/twoFactorAuthentication/verifyOtpEpic");
 // RootActionType is only available in the dynamically imported epic.ts.
 const coreRootEpic = (0, redux_observable_1.combineEpics)(
 // Auth & tenant
-clearAllEpic_1.clearAllEpic, doMagicLinkSignInEpic_1.doMagicLinkSignInEpic, signInUserEpic_1.doSignInEpic, signOutUserEpic_1.doSignOutEpic, fetchActiveTenantEpic_1.fetchActiveTenantEpic, fetchAllTenantsEpic_1.fetchAllTenantsEpic, fetchExcludedResourcesEpic_1.fetchExcludedResourcesEpic, fetchExternalConnectionsEpic_1.fetchExternalConnectionsEpic, fetchSubscriptionSummaryForTenantEpic_1.fetchSubscriptionSummaryForTenantEpic, resendVerifyDeviceOTPEpic_1.resendVerifyDeviceOTPEpic, saveExternalConnectionEpic_1.saveExternalConnectionEpic, sendEmailMagicLinkToUserEpic_1.sendEmailMagicLinkToUserEpic, verifyDeviceWithTwoFAEpic_1.verifyDeviceWithTwoFAEpic, 
+clearAllEpic_1.clearAllEpic, doMagicLinkSignInEpic_1.doMagicLinkSignInEpic, signInUserEpic_1.doSignInEpic, signOutUserEpic_1.doSignOutEpic, sessionHeartbeatEpic_1.sessionHeartbeatEpic, fetchActiveTenantEpic_1.fetchActiveTenantEpic, fetchAllTenantsEpic_1.fetchAllTenantsEpic, fetchExcludedResourcesEpic_1.fetchExcludedResourcesEpic, fetchExternalConnectionsEpic_1.fetchExternalConnectionsEpic, fetchSubscriptionSummaryForTenantEpic_1.fetchSubscriptionSummaryForTenantEpic, resendVerifyDeviceOTPEpic_1.resendVerifyDeviceOTPEpic, saveExternalConnectionEpic_1.saveExternalConnectionEpic, sendEmailMagicLinkToUserEpic_1.sendEmailMagicLinkToUserEpic, verifyDeviceWithTwoFAEpic_1.verifyDeviceWithTwoFAEpic, 
 // Toast
 pushToastNotificationEpic_1.pushToastNotificationEpic, 
 // Collaboration

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

@@ -0,0 +1,54 @@
+/**
+ * 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 { SessionCallbacks, SessionConfig } from './sessionTypes';
+export declare class SessionManager {
+    private config;
+    private callbacks;
+    /** Timestamps and timers */
+    private lastActivityTime;
+    /** Timestamp of the last heartbeat fire (initial/periodic/continue/activity). */
+    private lastHeartbeatTime;
+    /** Set to true whenever user (or any same-origin tab) shows activity. */
+    private hadActivitySinceLastHeartbeat;
+    private idleCheckInterval;
+    private heartbeatInterval;
+    private countdownInterval;
+    private activityDebounceTimer;
+    /** State */
+    private running;
+    private warningActive;
+    private secondsRemaining;
+    /** Cross-tab activity sync */
+    private broadcastChannel;
+    /** Bound handlers for event listener cleanup. */
+    private boundOnActivity;
+    private boundOnVisibilityChange;
+    private boundOnBroadcastMessage;
+    start(config: Partial<SessionConfig> | undefined, callbacks: SessionCallbacks): void;
+    stop(): void;
+    continueSession(): void;
+    isWarningActive(): boolean;
+    getSecondsRemaining(): number;
+    private onActivity;
+    private onVisibilityChange;
+    /** Single source of truth for marking activity locally. */
+    private registerActivity;
+    private checkIdle;
+    private startWarning;
+    private startHeartbeat;
+    private fireHeartbeat;
+    private setupBroadcastChannel;
+    private teardownBroadcastChannel;
+    private broadcast;
+    private onBroadcastMessage;
+    private clearTimer;
+}

package/lib/entity/tenant/SessionManager.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * 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).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const sessionTypes_1 = require("./sessionTypes");
+/** Events that indicate user activity. */
+const ACTIVITY_EVENTS = [
+    'mousemove',
+    'mousedown',
+    'keydown',
+    'scroll',
+    'touchstart',
+    'click',
+];
+/** Debounce interval for activity events (ms). */
+const ACTIVITY_DEBOUNCE_MS = 1000;
+/** Name of the BroadcastChannel used for cross-tab activity sync. */
+const BROADCAST_CHANNEL_NAME = 'zeni-session-activity';
+class SessionManager {
+    constructor() {
+        this.config = sessionTypes_1.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;
+        /** 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 = { ...sessionTypes_1.DEFAULT_SESSION_CONFIG, ...config };
+        this.callbacks = callbacks;
+        this.running = true;
+        this.warningActive = false;
+        this.lastActivityTime = Date.now();
+        this.lastHeartbeatTime = 0; // fireHeartbeat('initial') below will set this
+        this.hadActivitySinceLastHeartbeat = true; // initial heartbeat is expected
+        console.log('[SessionManager] start() called with config:', this.config);
+        const heartbeatEnabled = this.config.heartbeatIntervalMinutes > 0;
+        const idleTrackingEnabled = this.config.isAutoLogoutEnabled;
+        if (!heartbeatEnabled && !idleTrackingEnabled) {
+            console.log('[SessionManager] Heartbeat and idle tracking both disabled — nothing to start');
+            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('initial');
+        }
+        else {
+            console.log('[SessionManager] Heartbeat disabled (heartbeatIntervalMinutes <= 0)');
+        }
+        if (idleTrackingEnabled) {
+            document.addEventListener('visibilitychange', this.boundOnVisibilityChange);
+            this.idleCheckInterval = setInterval(() => this.checkIdle(), 1000);
+        }
+        else {
+            console.log('[SessionManager] Idle tracking disabled for this user — heartbeat-only mode');
+        }
+    }
+    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('continue-session');
+        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 * 60 * 1000;
+            const timeSinceLastHeartbeat = now - this.lastHeartbeatTime;
+            if (timeSinceLastHeartbeat >= intervalMs) {
+                this.fireHeartbeat('activity-after-idle');
+                this.startHeartbeat();
+            }
+        }
+        this.activityDebounceTimer = setTimeout(() => {
+            this.activityDebounceTimer = null;
+        }, ACTIVITY_DEBOUNCE_MS);
+    }
+    onVisibilityChange() {
+        if (!this.running) {
+            return;
+        }
+        // Industry-standard idle detection: resetting on tab focus is expected.
+        if (document.visibilityState === 'visible') {
+            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 * 60 * 1000;
+        if (idleMs >= idleTimeoutMs) {
+            this.startWarning();
+        }
+    }
+    startWarning() {
+        this.warningActive = true;
+        this.secondsRemaining = this.config.warningDurationSeconds;
+        // Don't extend session while warning is showing.
+        this.clearTimer('heartbeatInterval');
+        this.callbacks?.onWarningStart(this.secondsRemaining);
+        this.countdownInterval = setInterval(() => {
+            this.secondsRemaining -= 1;
+            if (this.secondsRemaining <= 0) {
+                this.clearTimer('countdownInterval');
+                this.warningActive = false;
+                this.callbacks?.onAutoLogout();
+            }
+            else {
+                this.callbacks?.onWarningTick(this.secondsRemaining);
+            }
+        }, 1000);
+    }
+    startHeartbeat() {
+        this.clearTimer('heartbeatInterval');
+        const intervalMs = this.config.heartbeatIntervalMinutes * 60 * 1000;
+        console.log(`[SessionManager] Heartbeat timer set to fire every ${this.config.heartbeatIntervalMinutes} min (${intervalMs} ms)`);
+        this.heartbeatInterval = setInterval(() => {
+            if (!this.running || this.warningActive) {
+                console.log('[SessionManager] Heartbeat tick skipped — running:', this.running, 'warningActive:', this.warningActive);
+                return;
+            }
+            if (!this.hadActivitySinceLastHeartbeat) {
+                console.log('[SessionManager] Heartbeat tick skipped — no activity in this interval');
+                return;
+            }
+            this.fireHeartbeat('periodic');
+        }, intervalMs);
+    }
+    fireHeartbeat(reason) {
+        console.log(`[SessionManager] Heartbeat fired (${reason})`);
+        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') {
+            console.log('[SessionManager] BroadcastChannel not available — cross-tab sync disabled');
+            return;
+        }
+        try {
+            this.broadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+            this.broadcastChannel.addEventListener('message', this.boundOnBroadcastMessage);
+            console.log('[SessionManager] BroadcastChannel ready for cross-tab sync');
+        }
+        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;
+        }
+    }
+    clearTimer(name) {
+        const timer = this[name];
+        if (timer != null) {
+            if (name === 'activityDebounceTimer') {
+                clearTimeout(timer);
+            }
+            else {
+                clearInterval(timer);
+            }
+            this[name] = null;
+        }
+    }
+}
+exports.SessionManager = SessionManager;

package/lib/entity/tenant/epic/sessionHeartbeatEpic.d.ts

@@ -0,0 +1,16 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { sendSessionHeartbeat, sessionHeartbeatFailure, sessionHeartbeatSuccess } from '../tenantReducer';
+export type ActionType = ReturnType<typeof sendSessionHeartbeat> | ReturnType<typeof sessionHeartbeatSuccess> | ReturnType<typeof sessionHeartbeatFailure>;
+export declare const sessionHeartbeatEpic: (actions$: ActionsObservable<ActionType>, _: StateObservable<RootState>, zeniAPI: ZeniAPI) => import("rxjs").Observable<{
+    payload: {
+        expiresAt: string;
+    };
+    type: "tenant/sessionHeartbeatSuccess";
+} | {
+    payload: {
+        error: import("../../../responsePayload").ZeniAPIStatus<Record<string, unknown>>;
+    };
+    type: "tenant/sessionHeartbeatFailure";
+}>;

package/lib/entity/tenant/epic/sessionHeartbeatEpic.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionHeartbeatEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../responsePayload");
+const tenantReducer_1 = require("../tenantReducer");
+const sessionHeartbeatEpic = (actions$, _, zeniAPI) => actions$.pipe((0, operators_1.filter)(tenantReducer_1.sendSessionHeartbeat.match), (0, operators_1.switchMap)(() => zeniAPI
+    .postAndGetJSON(`${zeniAPI.apiEndPoints.authMicroServiceBaseUrl}/1.0/heartbeat`)
+    .pipe((0, operators_1.mergeMap)((response) => {
+    if ((0, responsePayload_1.isSuccessResponse)(response)) {
+        return (0, rxjs_1.of)((0, tenantReducer_1.sessionHeartbeatSuccess)(response.data?.expiry ?? ''));
+    }
+    return (0, rxjs_1.of)((0, tenantReducer_1.sessionHeartbeatFailure)(response.status));
+}), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, tenantReducer_1.sessionHeartbeatFailure)((0, responsePayload_1.createZeniAPIStatus)('Heartbeat failed', 'Session heartbeat API call errored: ' + JSON.stringify(error))))))));
+exports.sessionHeartbeatEpic = sessionHeartbeatEpic;

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

@@ -0,0 +1,26 @@
+/**
+ * Session management types for idle timeout and heartbeat.
+ */
+export interface SessionConfig {
+    /** Minutes between heartbeat API calls while user is active. Default: 10 */
+    heartbeatIntervalMinutes: number;
+    /** Minutes of inactivity before the warning popup appears. Default: 30 */
+    idleTimeoutMinutes: number;
+    /** Whether auto-logout is enabled. Default: true */
+    isAutoLogoutEnabled: boolean;
+    /** Seconds to count down in the warning popup before auto-logout. Default: 60 */
+    warningDurationSeconds: number;
+}
+export declare const DEFAULT_SESSION_CONFIG: SessionConfig;
+export interface SessionCallbacks {
+    /** Called when the countdown reaches zero — app should sign out. */
+    onAutoLogout: () => void;
+    /** Called to send a heartbeat API request. */
+    onHeartbeat: () => void;
+    /** Called when the session is extended (heartbeat success or "Continue Session"). */
+    onSessionExtended: () => void;
+    /** Called when the warning countdown starts. */
+    onWarningStart: (secondsRemaining: number) => void;
+    /** Called every second during the countdown. */
+    onWarningTick: (secondsRemaining: number) => void;
+}

package/lib/entity/tenant/sessionTypes.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Session management types for idle timeout and heartbeat.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SESSION_CONFIG = void 0;
+exports.DEFAULT_SESSION_CONFIG = {
+    heartbeatIntervalMinutes: 10,
+    idleTimeoutMinutes: 30,
+    isAutoLogoutEnabled: true,
+    warningDurationSeconds: 60,
+};

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

@@ -51,7 +51,11 @@ export declare const updateTenants: import("@reduxjs/toolkit").ActionCreatorWith
     accountLockTime?: string;
     accountUnlockTime?: string;
     isAccountLocked?: boolean;
-}, "tenant/sendEmailMagicLinkToUserFailure">, updateSignInState: import("@reduxjs/toolkit").ActionCreatorWithPayload<FetchState, "tenant/updateSignInState">, doSignOut: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"tenant/doSignOut">, signOutSuccess: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"tenant/signOutSuccess">, updateLoggedInUser: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[userPayload: LoggedInUserPayload, zeniSessionId: string, authProvider: AuthProvider], {
+}, "tenant/sendEmailMagicLinkToUserFailure">, updateSignInState: import("@reduxjs/toolkit").ActionCreatorWithPayload<FetchState, "tenant/updateSignInState">, doSignOut: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"tenant/doSignOut">, signOutSuccess: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"tenant/signOutSuccess">, sendSessionHeartbeat: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"tenant/sendSessionHeartbeat">, sessionHeartbeatSuccess: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[expiresAt: string], {
+    expiresAt: string;
+}, "tenant/sessionHeartbeatSuccess", never, never>, sessionHeartbeatFailure: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[error: ZeniAPIStatus<Record<string, unknown>>], {
+    error: ZeniAPIStatus<Record<string, unknown>>;
+}, "tenant/sessionHeartbeatFailure", never, never>, updateLoggedInUser: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[userPayload: LoggedInUserPayload, zeniSessionId: string, authProvider: AuthProvider], {
     userPayload: LoggedInUserPayload;
     zeniSessionId: string;
     authProvider: AuthProvider;

package/lib/entity/tenant/tenantReducer.js

@@ -4,7 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toConnection = exports.toRoleResource = exports.resendVerifyDeviceOTPFailure = exports.resendVerifyDeviceOTPSuccess = exports.resendVerifyDeviceOTP = exports.verifyDeviceWithTwoFAFailure = exports.verifyDeviceWithTwoFASuccess = exports.verifyDeviceWithTwoFA = exports.updateTenantMasterTOSInfo = exports.updateTenantAccountingClassesEnabled = exports.trigger2FA = exports.resetSignInState = exports.updateTreasuryVideoViewedForLoggedInUser = exports.updateReferViewedForLoggedInUser = exports.updateTenantReimbursementInfo = exports.removeOnboardingTenant = exports.updateOnboardingTenants = exports.updateSubscriptionSummaryForTenantFailure = exports.updateSubscriptionSummaryForTenantSuccess = exports.fetchSubscriptionSummaryForTenant = exports.clearAll = exports.fetchExternalConnectionsSuccess = exports.fetchExternalConnectionsFailure = exports.saveExternalConnectionFailure = exports.saveExternalConnectionSuccess = exports.saveExternalConnection = exports.fetchExternalConnections = exports.updateLoggedInUser = exports.signOutSuccess = exports.doSignOut = exports.updateSignInState = exports.sendEmailMagicLinkToUserFailure = exports.sendEmailMagicLinkToUserSuccess = exports.sendEmailMagicLinkToUser = exports.magicLinkSignInFailure = exports.magicLinkSignInSuccess = exports.doMagicLinkSignIn = exports.doSignIn = exports.updateExcludedResourcesFailure = exports.updateExcludedResourcesSuccess = exports.fetchExcludedResources = exports.updateCurrentTenant = exports.updateTenantFailure = exports.updateTenantSuccess = exports.fetchActiveTenant = exports.updateTenantsFailure = exports.updateTenantsSuccess = exports.fetchAllTenants = exports.updateTenants = exports.initialState = void 0;
+exports.resendVerifyDeviceOTPSuccess = exports.resendVerifyDeviceOTP = exports.verifyDeviceWithTwoFAFailure = exports.verifyDeviceWithTwoFASuccess = exports.verifyDeviceWithTwoFA = exports.updateTenantMasterTOSInfo = exports.updateTenantAccountingClassesEnabled = exports.trigger2FA = exports.resetSignInState = exports.updateTreasuryVideoViewedForLoggedInUser = exports.updateReferViewedForLoggedInUser = exports.updateTenantReimbursementInfo = exports.removeOnboardingTenant = exports.updateOnboardingTenants = exports.updateSubscriptionSummaryForTenantFailure = exports.updateSubscriptionSummaryForTenantSuccess = exports.fetchSubscriptionSummaryForTenant = exports.clearAll = exports.fetchExternalConnectionsSuccess = exports.fetchExternalConnectionsFailure = exports.saveExternalConnectionFailure = exports.saveExternalConnectionSuccess = exports.saveExternalConnection = exports.fetchExternalConnections = exports.updateLoggedInUser = exports.sessionHeartbeatFailure = exports.sessionHeartbeatSuccess = exports.sendSessionHeartbeat = exports.signOutSuccess = exports.doSignOut = exports.updateSignInState = exports.sendEmailMagicLinkToUserFailure = exports.sendEmailMagicLinkToUserSuccess = exports.sendEmailMagicLinkToUser = exports.magicLinkSignInFailure = exports.magicLinkSignInSuccess = exports.doMagicLinkSignIn = exports.doSignIn = exports.updateExcludedResourcesFailure = exports.updateExcludedResourcesSuccess = exports.fetchExcludedResources = exports.updateCurrentTenant = exports.updateTenantFailure = exports.updateTenantSuccess = exports.fetchActiveTenant = exports.updateTenantsFailure = exports.updateTenantsSuccess = exports.fetchAllTenants = exports.updateTenants = exports.initialState = void 0;
+exports.toConnection = exports.toRoleResource = exports.resendVerifyDeviceOTPFailure = void 0;
 exports.mapConnectionsPayloadToState = mapConnectionsPayloadToState;
 const toolkit_1 = require("@reduxjs/toolkit");
 const js_base64_1 = require("js-base64");
@@ -436,6 +437,26 @@ const tenant = (0, toolkit_1.createSlice)({
         signOutSuccess(draft) {
             draft.loggedInUser = undefined;
             draft.currentTenantId = undefined;
+            draft.sessionExpiresAt = undefined;
+        },
+        sendSessionHeartbeat() {
+            // No state change needed — epic handles the API call
+        },
+        sessionHeartbeatSuccess: {
+            prepare(expiresAt) {
+                return { payload: { expiresAt } };
+            },
+            reducer(draft, action) {
+                draft.sessionExpiresAt = action.payload.expiresAt;
+            },
+        },
+        sessionHeartbeatFailure: {
+            prepare(error) {
+                return { payload: { error } };
+            },
+            reducer(draft, action) {
+                draft.error = action.payload.error;
+            },
         },
         fetchSubscriptionSummaryForTenant: {
             prepare(tenantId) {
@@ -543,7 +564,7 @@ const tenant = (0, toolkit_1.createSlice)({
         },
     },
 });
-_a = tenant.actions, exports.updateTenants = _a.updateTenants, exports.fetchAllTenants = _a.fetchAllTenants, exports.updateTenantsSuccess = _a.updateTenantsSuccess, exports.updateTenantsFailure = _a.updateTenantsFailure, exports.fetchActiveTenant = _a.fetchActiveTenant, exports.updateTenantSuccess = _a.updateTenantSuccess, exports.updateTenantFailure = _a.updateTenantFailure, exports.updateCurrentTenant = _a.updateCurrentTenant, exports.fetchExcludedResources = _a.fetchExcludedResources, exports.updateExcludedResourcesSuccess = _a.updateExcludedResourcesSuccess, exports.updateExcludedResourcesFailure = _a.updateExcludedResourcesFailure, exports.doSignIn = _a.doSignIn, exports.doMagicLinkSignIn = _a.doMagicLinkSignIn, exports.magicLinkSignInSuccess = _a.magicLinkSignInSuccess, exports.magicLinkSignInFailure = _a.magicLinkSignInFailure, exports.sendEmailMagicLinkToUser = _a.sendEmailMagicLinkToUser, exports.sendEmailMagicLinkToUserSuccess = _a.sendEmailMagicLinkToUserSuccess, exports.sendEmailMagicLinkToUserFailure = _a.sendEmailMagicLinkToUserFailure, exports.updateSignInState = _a.updateSignInState, exports.doSignOut = _a.doSignOut, exports.signOutSuccess = _a.signOutSuccess, exports.updateLoggedInUser = _a.updateLoggedInUser, exports.fetchExternalConnections = _a.fetchExternalConnections, exports.saveExternalConnection = _a.saveExternalConnection, exports.saveExternalConnectionSuccess = _a.saveExternalConnectionSuccess, exports.saveExternalConnectionFailure = _a.saveExternalConnectionFailure, exports.fetchExternalConnectionsFailure = _a.fetchExternalConnectionsFailure, exports.fetchExternalConnectionsSuccess = _a.fetchExternalConnectionsSuccess, exports.clearAll = _a.clearAll, exports.fetchSubscriptionSummaryForTenant = _a.fetchSubscriptionSummaryForTenant, exports.updateSubscriptionSummaryForTenantSuccess = _a.updateSubscriptionSummaryForTenantSuccess, exports.updateSubscriptionSummaryForTenantFailure = _a.updateSubscriptionSummaryForTenantFailure, exports.updateOnboardingTenants = _a.updateOnboardingTenants, exports.removeOnboardingTenant = _a.removeOnboardingTenant, exports.updateTenantReimbursementInfo = _a.updateTenantReimbursementInfo, exports.updateReferViewedForLoggedInUser = _a.updateReferViewedForLoggedInUser, exports.updateTreasuryVideoViewedForLoggedInUser = _a.updateTreasuryVideoViewedForLoggedInUser, exports.resetSignInState = _a.resetSignInState, exports.trigger2FA = _a.trigger2FA, exports.updateTenantAccountingClassesEnabled = _a.updateTenantAccountingClassesEnabled, exports.updateTenantMasterTOSInfo = _a.updateTenantMasterTOSInfo, exports.verifyDeviceWithTwoFA = _a.verifyDeviceWithTwoFA, exports.verifyDeviceWithTwoFASuccess = _a.verifyDeviceWithTwoFASuccess, exports.verifyDeviceWithTwoFAFailure = _a.verifyDeviceWithTwoFAFailure, exports.resendVerifyDeviceOTP = _a.resendVerifyDeviceOTP, exports.resendVerifyDeviceOTPSuccess = _a.resendVerifyDeviceOTPSuccess, exports.resendVerifyDeviceOTPFailure = _a.resendVerifyDeviceOTPFailure;
+_a = tenant.actions, exports.updateTenants = _a.updateTenants, exports.fetchAllTenants = _a.fetchAllTenants, exports.updateTenantsSuccess = _a.updateTenantsSuccess, exports.updateTenantsFailure = _a.updateTenantsFailure, exports.fetchActiveTenant = _a.fetchActiveTenant, exports.updateTenantSuccess = _a.updateTenantSuccess, exports.updateTenantFailure = _a.updateTenantFailure, exports.updateCurrentTenant = _a.updateCurrentTenant, exports.fetchExcludedResources = _a.fetchExcludedResources, exports.updateExcludedResourcesSuccess = _a.updateExcludedResourcesSuccess, exports.updateExcludedResourcesFailure = _a.updateExcludedResourcesFailure, exports.doSignIn = _a.doSignIn, exports.doMagicLinkSignIn = _a.doMagicLinkSignIn, exports.magicLinkSignInSuccess = _a.magicLinkSignInSuccess, exports.magicLinkSignInFailure = _a.magicLinkSignInFailure, exports.sendEmailMagicLinkToUser = _a.sendEmailMagicLinkToUser, exports.sendEmailMagicLinkToUserSuccess = _a.sendEmailMagicLinkToUserSuccess, exports.sendEmailMagicLinkToUserFailure = _a.sendEmailMagicLinkToUserFailure, exports.updateSignInState = _a.updateSignInState, exports.doSignOut = _a.doSignOut, exports.signOutSuccess = _a.signOutSuccess, exports.sendSessionHeartbeat = _a.sendSessionHeartbeat, exports.sessionHeartbeatSuccess = _a.sessionHeartbeatSuccess, exports.sessionHeartbeatFailure = _a.sessionHeartbeatFailure, exports.updateLoggedInUser = _a.updateLoggedInUser, exports.fetchExternalConnections = _a.fetchExternalConnections, exports.saveExternalConnection = _a.saveExternalConnection, exports.saveExternalConnectionSuccess = _a.saveExternalConnectionSuccess, exports.saveExternalConnectionFailure = _a.saveExternalConnectionFailure, exports.fetchExternalConnectionsFailure = _a.fetchExternalConnectionsFailure, exports.fetchExternalConnectionsSuccess = _a.fetchExternalConnectionsSuccess, exports.clearAll = _a.clearAll, exports.fetchSubscriptionSummaryForTenant = _a.fetchSubscriptionSummaryForTenant, exports.updateSubscriptionSummaryForTenantSuccess = _a.updateSubscriptionSummaryForTenantSuccess, exports.updateSubscriptionSummaryForTenantFailure = _a.updateSubscriptionSummaryForTenantFailure, exports.updateOnboardingTenants = _a.updateOnboardingTenants, exports.removeOnboardingTenant = _a.removeOnboardingTenant, exports.updateTenantReimbursementInfo = _a.updateTenantReimbursementInfo, exports.updateReferViewedForLoggedInUser = _a.updateReferViewedForLoggedInUser, exports.updateTreasuryVideoViewedForLoggedInUser = _a.updateTreasuryVideoViewedForLoggedInUser, exports.resetSignInState = _a.resetSignInState, exports.trigger2FA = _a.trigger2FA, exports.updateTenantAccountingClassesEnabled = _a.updateTenantAccountingClassesEnabled, exports.updateTenantMasterTOSInfo = _a.updateTenantMasterTOSInfo, exports.verifyDeviceWithTwoFA = _a.verifyDeviceWithTwoFA, exports.verifyDeviceWithTwoFASuccess = _a.verifyDeviceWithTwoFASuccess, exports.verifyDeviceWithTwoFAFailure = _a.verifyDeviceWithTwoFAFailure, exports.resendVerifyDeviceOTP = _a.resendVerifyDeviceOTP, exports.resendVerifyDeviceOTPSuccess = _a.resendVerifyDeviceOTPSuccess, exports.resendVerifyDeviceOTPFailure = _a.resendVerifyDeviceOTPFailure;
 exports.default = tenant.reducer;
 /**
  * Converts tenants payload to Tenant and User State

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

@@ -45,6 +45,7 @@ export interface TenantState extends FetchedState {
     magicLinkCodeVerifier?: string;
     magicLinkEmail?: string;
     otpChallenge?: string;
+    sessionExpiresAt?: string;
     twoFAPhoneNumber?: string;
 }
 export interface TenantProductSettings {

package/lib/esm/coreEpics.js

@@ -22,6 +22,7 @@ import { resendVerifyDeviceOTPEpic } from './entity/tenant/epic/resendVerifyDevi
 import { saveExternalConnectionEpic } from './entity/tenant/epic/saveExternalConnectionEpic';
 import { sendEmailMagicLinkToUserEpic } from './entity/tenant/epic/sendEmailMagicLinkToUserEpic';
 import { doSignInEpic } from './entity/tenant/epic/signInUserEpic';
+import { sessionHeartbeatEpic } from './entity/tenant/epic/sessionHeartbeatEpic';
 import { doSignOutEpic } from './entity/tenant/epic/signOutUserEpic';
 import { verifyDeviceWithTwoFAEpic } from './entity/tenant/epic/verifyDeviceWithTwoFAEpic';
 // ── Toast Notification Epic ──────────────────────────────────────────
@@ -46,7 +47,7 @@ import { verifyOtpEpic } from './view/twoFactorAuthentication/verifyOtpEpic';
 // RootActionType is only available in the dynamically imported epic.ts.
 const coreRootEpic = combineEpics(
 // Auth & tenant
-clearAllEpic, doMagicLinkSignInEpic, doSignInEpic, doSignOutEpic, fetchActiveTenantEpic, fetchAllTenantsEpic, fetchExcludedResourcesEpic, fetchExternalConnectionsEpic, fetchSubscriptionSummaryForTenantEpic, resendVerifyDeviceOTPEpic, saveExternalConnectionEpic, sendEmailMagicLinkToUserEpic, verifyDeviceWithTwoFAEpic, 
+clearAllEpic, doMagicLinkSignInEpic, doSignInEpic, doSignOutEpic, sessionHeartbeatEpic, fetchActiveTenantEpic, fetchAllTenantsEpic, fetchExcludedResourcesEpic, fetchExternalConnectionsEpic, fetchSubscriptionSummaryForTenantEpic, resendVerifyDeviceOTPEpic, saveExternalConnectionEpic, sendEmailMagicLinkToUserEpic, verifyDeviceWithTwoFAEpic, 
 // Toast
 pushToastNotificationEpic, 
 // Collaboration