@iblai/web-utils 1.11.12 → 1.12.1

package/dist/index.js

@@ -27,6 +27,103 @@ function _interopNamespaceDefault(e) {
 
 var React__namespace = /*#__PURE__*/_interopNamespaceDefault(React);
 
+const MENTOR_CHAT_DOCUMENTS_EXTENSIONS = [
+    // Media types
+    "video/*",
+    "audio/*",
+    "image/*",
+    // Document types
+    ".docx",
+    ".xlsx",
+    ".pptx",
+    ".csv",
+    ".md",
+    ".txt",
+    ".pdf",
+];
+const ANONYMOUS_USERNAME = "anonymous";
+const DEFAULT_DISCLAIMER_CONTENT = `By accessing and using the [ibl.ai](http://ibl.ai/) MentorAI platform (“Platform”), you agree to the following terms. The Platform provides AI-powered mentorship and educational support. You understand that AI responses may contain inaccuracies, and you are responsible for independently verifying any information before relying on it for academic, professional, or personal decisions. Do not input confidential, sensitive, or personally identifiable information of yourself or others.
+All content, code, and data processed through the Platform remain the property of their respective owners. [ibl.ai](http://ibl.ai/) retains all rights to the Platform’s underlying technology and intellectual property. You are granted a limited, non-exclusive, revocable license to use the Platform for personal or institutional learning purposes only.
+Your use must comply with applicable laws and institutional policies. Misuse—including attempting to bypass security, copy source code, or use the service for unlawful activity—may result in suspension or termination of access. Continued use constitutes acceptance of these terms.`;
+const MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS = 3;
+const LOCAL_STORAGE_KEYS = {
+    CURRENT_TENANT: "current_tenant",
+    TENANTS: "tenants",
+    REDIRECT_TO: "redirect-to",
+    AUTH_TOKEN: "axd_token",
+    TOKEN_EXPIRY: "axd_token_expires",
+    USER_DATA: "userData",
+    USER_TENANTS: "tenants",
+    VISITING_TENANT: "visiting_tenant",
+    SESSION_ID: "session_id",
+    EDX_TOKEN_KEY: "edx_jwt_token",
+    DM_TOKEN_KEY: "dm_token",
+    DM_TOKEN_EXPIRES: "dm_token_expires",
+    DM_TOKEN_EXPIRY: "dm_token_expires",
+    AXD_TOKEN_KEY: "axd_token",
+    DEFAULT_TENANT: "tenant",
+    MODEL_DOWNLOAD_STATE: "model_download_state",
+    MODEL_DOWNLOAD_PROMPT_DISMISSED: "model_download_prompt_dismissed",
+};
+const TOOLS = {
+    WEB_SEARCH: "web-search",
+    WIKIPEDIA_SEARCH: "wikipedia-search",
+    COURSE_CREATION: "course-creation",
+    MCP: "mcp",
+    IMAGE_GENERATION: "image-generation",
+    IBL_PATHWAY_DOCUMENTS_RETRIEVER: "ibl-pathway-documents-retriever",
+    TRAINED_DOCUMENTS: "trained-documents",
+    IBL_SESSION_DOCUMENTS_RETRIEVER: "ibl-session-documents-retriever",
+    PLAYWRIGHT_BROWSER: "playwright-browser",
+    HUMAN_SUPPORT: "human-support",
+    CODE_INTERPRETER: "code-interpreter",
+    DEEP_RESEARCH: "deep-research",
+    STUDY_MODE: "study-mode",
+    MEMORY: "memory",
+    SCREEN_SHARE: "screen-share",
+    POWERPOINT: "powerpoint",
+    PROMPT: "prompt",
+    QUIZ: "quiz",
+    RUBRIC: "rubric",
+    RESOURCE: "resource",
+    LESSON_PLAN: "lesson-plan",
+    SYLLABUS: "syllabus",
+    CANVAS: "canvas",
+    GOOGLE_SLIDES: "google-slides",
+    GOOGLE_DOCUMENT: "google-docs",
+};
+// Maps WebSocket tool_call type names to human-readable UI labels
+const TOOL_NAME_MAP = {
+    web_search_call: "Searching the web",
+    vector_search: "Searching knowledge base",
+    calculator: "Calculating",
+    file_reader: "Reading file",
+    code_executor: "Running code",
+    wikipedia: "Searching Wikipedia",
+};
+const REQUIRED_ACTIONS_FOR_GROUPS = {
+    NOTIFICATIONS: "Ibl.Notifications/Notification/action",
+};
+const MENTOR_VISIBILITY_VALUES = {
+    ADMINISTRATORS: "viewable_by_tenant_admins",
+    STUDENTS: "viewable_by_tenant_students",
+    ANYONE: "viewable_by_anyone",
+};
+const MENTOR_VISIBILITY = [
+    {
+        label: "Administrators",
+        value: MENTOR_VISIBILITY_VALUES.ADMINISTRATORS,
+    },
+    {
+        label: "Users",
+        value: MENTOR_VISIBILITY_VALUES.STUDENTS,
+    },
+    {
+        label: "Anyone",
+        value: MENTOR_VISIBILITY_VALUES.ANYONE,
+    },
+];
+
 /**
  * Authentication and Authorization Utilities
  *
@@ -63,6 +160,61 @@ function deleteCookie(name, path, domain) {
     const domainValue = domain ? `domain=${domain};` : "";
     document.cookie = cookieValue + expires + pathValue + domainValue;
 }
+/* Reads a JWT's `exp` claim and reports whether it is in the past. A token that
+ * cannot be decoded (or is malformed) is treated as expired; a token with no
+ * `exp` claim is treated as non-expiring (mirrors the axd "no expiry" case).
+ */
+function isJwtExpired(token) {
+    try {
+        const payload = token.split(".")[1];
+        if (!payload)
+            return true;
+        const normalized = payload.replace(/-/g, "+").replace(/_/g, "/");
+        const padded = normalized.padEnd(normalized.length + ((4 - (normalized.length % 4)) % 4), "=");
+        const claims = JSON.parse(atob(padded));
+        if (typeof claims.exp !== "number")
+            return false;
+        return claims.exp * 1000 <= Date.now();
+    }
+    catch (_a) {
+        return true;
+    }
+}
+function hasNonExpiredAuthToken() {
+    // The edx JWT is stored alongside the axd token at SSO login; a valid session
+    // requires it to be present and unexpired too, so re-auth is triggered when
+    // it is missing or its `exp` has passed.
+    const edxToken = window.localStorage.getItem(LOCAL_STORAGE_KEYS.EDX_TOKEN_KEY);
+    if (!edxToken) {
+        console.log("################### [hasNonExpiredAuthToken] edx_jwt_token is not defined", edxToken);
+        return false;
+    }
+    if (isJwtExpired(edxToken)) {
+        console.log("################### [hasNonExpiredAuthToken] edx_jwt_token is expired");
+        return false;
+    }
+    const token = window.localStorage.getItem(LOCAL_STORAGE_KEYS.AUTH_TOKEN);
+    if (!token) {
+        console.log("################### [hasNonExpiredAuthToken] axd token is not defined", token);
+        return false;
+    }
+    const tokenExpiry = window.localStorage.getItem(LOCAL_STORAGE_KEYS.TOKEN_EXPIRY);
+    if (!tokenExpiry) {
+        console.log("################### [hasNonExpiredAuthToken] axd token expiry is not defined", tokenExpiry);
+        return true;
+    }
+    const expiryDate = new Date(tokenExpiry);
+    if (isNaN(expiryDate.getTime())) {
+        console.log("################### [hasNonExpiredAuthToken] axd token expiry date", expiryDate);
+        return false;
+    }
+    const currentDate = new Date();
+    if (expiryDate <= currentDate) {
+        console.log("################### [hasNonExpiredAuthToken] axd token expiry date is less than current date ", expiryDate, currentDate);
+        return false;
+    }
+    return true;
+}
 /**
  * Get all possible domain parts for cookie deletion
  * @param domain - The domain to split
@@ -210,7 +362,7 @@ async function redirectToAuthSpa(options) {
         logoutTimestamp: "ibl_logout_timestamp",
         loginTimestamp: "ibl_login_timestamp",
         tenantSwitching: "ibl_tenant_switching",
-    }, hasNonExpiredAuthToken, isOffline, preserveTokenKey, authRedirectProxy, isNativeApp, scheme = "iblai-mentor", forceRedirect = false, } = options;
+    }, isOffline, preserveTokenKey, authRedirectProxy, isNativeApp, scheme = "iblai-mentor", forceRedirect = false, } = options;
     console.log("[redirectToAuthSpa] starting redirect to auth spa", redirectTo, platformKey, logout, saveRedirect, forceRedirect);
     // Skip if a tenant switch is already in progress
     if (!forceRedirect &&
@@ -1285,103 +1437,6 @@ const advancedTabs = Object.keys(advancedTabsProperties).map((tab) => {
 });
 const translatePrompt = (language) => `Please translate the summarized content into ${language}`;
 
-const MENTOR_CHAT_DOCUMENTS_EXTENSIONS = [
-    // Media types
-    "video/*",
-    "audio/*",
-    "image/*",
-    // Document types
-    ".docx",
-    ".xlsx",
-    ".pptx",
-    ".csv",
-    ".md",
-    ".txt",
-    ".pdf",
-];
-const ANONYMOUS_USERNAME = "anonymous";
-const DEFAULT_DISCLAIMER_CONTENT = `By accessing and using the [ibl.ai](http://ibl.ai/) MentorAI platform (“Platform”), you agree to the following terms. The Platform provides AI-powered mentorship and educational support. You understand that AI responses may contain inaccuracies, and you are responsible for independently verifying any information before relying on it for academic, professional, or personal decisions. Do not input confidential, sensitive, or personally identifiable information of yourself or others.
-All content, code, and data processed through the Platform remain the property of their respective owners. [ibl.ai](http://ibl.ai/) retains all rights to the Platform’s underlying technology and intellectual property. You are granted a limited, non-exclusive, revocable license to use the Platform for personal or institutional learning purposes only.
-Your use must comply with applicable laws and institutional policies. Misuse—including attempting to bypass security, copy source code, or use the service for unlawful activity—may result in suspension or termination of access. Continued use constitutes acceptance of these terms.`;
-const MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS = 3;
-const LOCAL_STORAGE_KEYS = {
-    CURRENT_TENANT: "current_tenant",
-    TENANTS: "tenants",
-    REDIRECT_TO: "redirect-to",
-    AUTH_TOKEN: "axd_token",
-    TOKEN_EXPIRY: "axd_token_expires",
-    USER_DATA: "userData",
-    USER_TENANTS: "tenants",
-    VISITING_TENANT: "visiting_tenant",
-    SESSION_ID: "session_id",
-    EDX_TOKEN_KEY: "edx_jwt_token",
-    DM_TOKEN_KEY: "dm_token",
-    DM_TOKEN_EXPIRES: "dm_token_expires",
-    DM_TOKEN_EXPIRY: "dm_token_expires",
-    AXD_TOKEN_KEY: "axd_token",
-    DEFAULT_TENANT: "tenant",
-    MODEL_DOWNLOAD_STATE: "model_download_state",
-    MODEL_DOWNLOAD_PROMPT_DISMISSED: "model_download_prompt_dismissed",
-};
-const TOOLS = {
-    WEB_SEARCH: "web-search",
-    WIKIPEDIA_SEARCH: "wikipedia-search",
-    COURSE_CREATION: "course-creation",
-    MCP: "mcp",
-    IMAGE_GENERATION: "image-generation",
-    IBL_PATHWAY_DOCUMENTS_RETRIEVER: "ibl-pathway-documents-retriever",
-    TRAINED_DOCUMENTS: "trained-documents",
-    IBL_SESSION_DOCUMENTS_RETRIEVER: "ibl-session-documents-retriever",
-    PLAYWRIGHT_BROWSER: "playwright-browser",
-    HUMAN_SUPPORT: "human-support",
-    CODE_INTERPRETER: "code-interpreter",
-    DEEP_RESEARCH: "deep-research",
-    STUDY_MODE: "study-mode",
-    MEMORY: "memory",
-    SCREEN_SHARE: "screen-share",
-    POWERPOINT: "powerpoint",
-    PROMPT: "prompt",
-    QUIZ: "quiz",
-    RUBRIC: "rubric",
-    RESOURCE: "resource",
-    LESSON_PLAN: "lesson-plan",
-    SYLLABUS: "syllabus",
-    CANVAS: "canvas",
-    GOOGLE_SLIDES: "google-slides",
-    GOOGLE_DOCUMENT: "google-docs",
-};
-// Maps WebSocket tool_call type names to human-readable UI labels
-const TOOL_NAME_MAP = {
-    web_search_call: "Searching the web",
-    vector_search: "Searching knowledge base",
-    calculator: "Calculating",
-    file_reader: "Reading file",
-    code_executor: "Running code",
-    wikipedia: "Searching Wikipedia",
-};
-const REQUIRED_ACTIONS_FOR_GROUPS = {
-    NOTIFICATIONS: "Ibl.Notifications/Notification/action",
-};
-const MENTOR_VISIBILITY_VALUES = {
-    ADMINISTRATORS: "viewable_by_tenant_admins",
-    STUDENTS: "viewable_by_tenant_students",
-    ANYONE: "viewable_by_anyone",
-};
-const MENTOR_VISIBILITY = [
-    {
-        label: "Administrators",
-        value: MENTOR_VISIBILITY_VALUES.ADMINISTRATORS,
-    },
-    {
-        label: "Users",
-        value: MENTOR_VISIBILITY_VALUES.STUDENTS,
-    },
-    {
-        label: "Anyone",
-        value: MENTOR_VISIBILITY_VALUES.ANYONE,
-    },
-];
-
 /**
  * Reads the cached user_nicename from the LOCAL_STORAGE_KEYS.USER_DATA blob.
  */
@@ -9197,29 +9252,6 @@ async function syncAuthToCookies(storageService) {
         console.error("[syncAuthToCookies] Error syncing to cookies:", error);
     }
 }
-function hasNonExpiredAuthToken() {
-    const token = window.localStorage.getItem(LOCAL_STORAGE_KEYS.AUTH_TOKEN);
-    if (!token) {
-        console.log("################### [hasNonExpiredAuthToken] axd token is not defined", token);
-        return false;
-    }
-    const tokenExpiry = window.localStorage.getItem(LOCAL_STORAGE_KEYS.TOKEN_EXPIRY);
-    if (!tokenExpiry) {
-        console.log("################### [hasNonExpiredAuthToken] axd token expiry is not defined", tokenExpiry);
-        return true;
-    }
-    const expiryDate = new Date(tokenExpiry);
-    if (isNaN(expiryDate.getTime())) {
-        console.log("################### [hasNonExpiredAuthToken] axd token expiry date", expiryDate);
-        return false;
-    }
-    const currentDate = new Date();
-    if (expiryDate <= currentDate) {
-        console.log("################### [hasNonExpiredAuthToken] axd token expiry date is less than current date ", expiryDate, currentDate);
-        return false;
-    }
-    return true;
-}
 /**
  * Clear current tenant cookie only (web only)
  * Should be called before tenant switching
@@ -11914,46 +11946,117 @@ const selectIsReasoning = (state) => state.chatSliceShared.currentStreamingMessa
 // NEW: Get streaming tool calls
 const selectStreamingToolCalls = (state) => state.chatSliceShared.currentStreamingMessage.toolCalls;
 
+const DEFAULT_IDLE_TIMEOUT_SECONDS = 120;
+// Minimum gap between idle-timer resets. Interaction events like mousemove fire
+// rapidly; there's no need to restart the (minutes-long) idle countdown more
+// than once per second.
+const ACTIVITY_THROTTLE_MS = 1000;
+// User interactions that count as activity and keep the user "present".
+const ACTIVITY_EVENTS = [
+    "mousemove",
+    "mousedown",
+    "keydown",
+    "wheel",
+    "scroll",
+    "touchstart",
+    "pointerdown",
+];
 class TimeTracker {
     constructor(config) {
+        var _a, _b, _c;
         this.state = {
             currentUrl: "",
-            startTime: 0,
             intervalId: null,
             routeUnsubscribe: null,
+            accumulatedMs: 0,
+            activeSince: null,
+            isVisible: true,
+            isFocused: true,
+            isIdle: false,
+            idleTimerId: null,
         };
+        // Timestamp of the last activity that reset the idle timer (for throttling).
+        this.lastActivityAt = 0;
+        // Bound listeners kept so they can be removed on destroy.
+        this.handleActivity = () => this.onActivity();
+        this.handleVisibilityChange = () => this.onVisibilityChange();
+        this.handleWindowFocus = () => this.onWindowFocus();
+        this.handleWindowBlur = () => this.onWindowBlur();
         this.config = config;
+        this.idleTimeoutMs =
+            ((_a = config.idleTimeoutSeconds) !== null && _a !== void 0 ? _a : DEFAULT_IDLE_TIMEOUT_SECONDS) * 1000;
+        this.pauseOnHidden = (_b = config.pauseOnHidden) !== null && _b !== void 0 ? _b : true;
+        this.pauseOnBlur = (_c = config.pauseOnBlur) !== null && _c !== void 0 ? _c : true;
+        this.idleDetectionEnabled =
+            this.idleTimeoutMs > 0 &&
+                typeof window !== "undefined" &&
+                typeof document !== "undefined";
         this.initialize();
     }
     initialize() {
         this.state.currentUrl = this.config.getCurrentUrl();
+        // Seed activity signals from the current environment.
+        if (this.pauseOnHidden && typeof document !== "undefined") {
+            this.state.isVisible = !document.hidden;
+        }
+        this.state.isFocused = true;
+        this.state.isIdle = false;
+        this.attachActivityListeners();
         this.startTracking();
+        this.startIdleTimer();
         if (this.config.onRouteChange) {
             this.state.routeUnsubscribe = this.config.onRouteChange(() => {
                 this.handleRouteChange();
             });
         }
     }
+    // --- Active time accounting -------------------------------------------------
+    /** Whether time should currently be counted. */
+    isActive() {
+        return this.state.isVisible && this.state.isFocused && !this.state.isIdle;
+    }
+    /**
+     * Reconcile the active window with the current activity signals: open a new
+     * window when the user becomes active, or bank the elapsed time when they
+     * become inactive.
+     */
+    syncActiveWindow() {
+        const active = this.isActive();
+        if (active && this.state.activeSince === null) {
+            this.state.activeSince = Date.now();
+        }
+        else if (!active && this.state.activeSince !== null) {
+            this.state.accumulatedMs += Date.now() - this.state.activeSince;
+            this.state.activeSince = null;
+        }
+    }
+    getTimeSpent() {
+        let total = this.state.accumulatedMs;
+        if (this.state.activeSince !== null) {
+            total += Date.now() - this.state.activeSince;
+        }
+        return total;
+    }
+    resetTimer() {
+        this.state.accumulatedMs = 0;
+        this.state.activeSince = this.isActive() ? Date.now() : null;
+    }
     startTracking() {
-        this.state.startTime = Date.now();
-        this.clearInterval();
+        this.clearTrackingInterval();
+        this.resetTimer();
+        if (typeof window === "undefined")
+            return;
         this.state.intervalId = window.setInterval(() => {
             this.sendTimeUpdate();
             this.resetTimer();
         }, this.config.intervalSeconds * 1000);
     }
-    clearInterval() {
+    clearTrackingInterval() {
         if (this.state.intervalId !== null) {
             clearInterval(this.state.intervalId);
             this.state.intervalId = null;
         }
     }
-    resetTimer() {
-        this.state.startTime = Date.now();
-    }
-    getTimeSpent() {
-        return Date.now() - this.state.startTime;
-    }
     sendTimeUpdate() {
         const timeSpent = this.getTimeSpent();
         if (timeSpent > 0) {
@@ -11968,16 +12071,116 @@ class TimeTracker {
             this.resetTimer();
         }
     }
+    // --- Activity / inactivity detection ---------------------------------------
+    attachActivityListeners() {
+        if (typeof window !== "undefined" && window.addEventListener) {
+            if (this.idleDetectionEnabled) {
+                for (const event of ACTIVITY_EVENTS) {
+                    window.addEventListener(event, this.handleActivity, {
+                        passive: true,
+                    });
+                }
+            }
+            if (this.pauseOnBlur) {
+                window.addEventListener("focus", this.handleWindowFocus);
+                window.addEventListener("blur", this.handleWindowBlur);
+            }
+        }
+        if (this.pauseOnHidden &&
+            typeof document !== "undefined" &&
+            document.addEventListener) {
+            document.addEventListener("visibilitychange", this.handleVisibilityChange);
+        }
+    }
+    detachActivityListeners() {
+        if (typeof window !== "undefined" && window.removeEventListener) {
+            for (const event of ACTIVITY_EVENTS) {
+                window.removeEventListener(event, this.handleActivity);
+            }
+            window.removeEventListener("focus", this.handleWindowFocus);
+            window.removeEventListener("blur", this.handleWindowBlur);
+        }
+        if (typeof document !== "undefined" && document.removeEventListener) {
+            document.removeEventListener("visibilitychange", this.handleVisibilityChange);
+        }
+    }
+    startIdleTimer() {
+        if (!this.idleDetectionEnabled)
+            return;
+        this.clearIdleTimer();
+        this.lastActivityAt = Date.now();
+        this.state.idleTimerId = window.setTimeout(() => {
+            this.markIdle();
+        }, this.idleTimeoutMs);
+    }
+    clearIdleTimer() {
+        if (this.state.idleTimerId !== null) {
+            clearTimeout(this.state.idleTimerId);
+            this.state.idleTimerId = null;
+        }
+    }
+    markIdle() {
+        if (this.state.isIdle)
+            return;
+        this.state.isIdle = true;
+        this.syncActiveWindow();
+    }
+    onActivity() {
+        // Returning from idle must always restart the countdown immediately.
+        if (this.state.isIdle) {
+            this.state.isIdle = false;
+            this.syncActiveWindow();
+            this.startIdleTimer();
+            return;
+        }
+        // Otherwise throttle: no need to reset a minutes-long timer on every
+        // mousemove.
+        if (Date.now() - this.lastActivityAt < ACTIVITY_THROTTLE_MS)
+            return;
+        this.startIdleTimer();
+    }
+    onVisibilityChange() {
+        if (typeof document === "undefined")
+            return;
+        this.state.isVisible = !document.hidden;
+        if (this.state.isVisible) {
+            // Returning to the tab counts as being present again.
+            this.state.isIdle = false;
+            this.startIdleTimer();
+        }
+        this.syncActiveWindow();
+    }
+    onWindowFocus() {
+        this.state.isFocused = true;
+        this.state.isIdle = false;
+        this.startIdleTimer();
+        this.syncActiveWindow();
+    }
+    onWindowBlur() {
+        this.state.isFocused = false;
+        this.syncActiveWindow();
+    }
+    // --- Public API -------------------------------------------------------------
     pause() {
         this.sendTimeUpdate();
-        this.clearInterval();
+        this.clearTrackingInterval();
+        this.clearIdleTimer();
+        // Stop accounting until resumed.
+        this.state.accumulatedMs = 0;
+        this.state.activeSince = null;
     }
     resume() {
+        // Treat resume as a fresh, present start so a stale idle flag can't keep
+        // the tracker from counting.
+        this.state.isIdle = false;
         this.startTracking();
+        this.startIdleTimer();
     }
     destroy() {
         this.sendTimeUpdate();
-        this.clearInterval();
+        this.clearTrackingInterval();
+        this.clearIdleTimer();
+        this.detachActivityListeners();
         if (this.state.routeUnsubscribe) {
             this.state.routeUnsubscribe();
             this.state.routeUnsubscribe = null;
@@ -11989,6 +12192,10 @@ class TimeTracker {
     getTimeSpentSinceLastReset() {
         return this.getTimeSpent();
     }
+    /** Whether the user is currently considered active (present & interacting). */
+    getIsActive() {
+        return this.isActive();
+    }
 }
 
 function useTimeTracker(config) {
@@ -19077,6 +19284,7 @@ exports.isExpo = isExpo;
 exports.isFileAccepted = isFileAccepted;
 exports.isInIframe = isInIframe;
 exports.isJSON = isJSON;
+exports.isJwtExpired = isJwtExpired;
 exports.isLoggedIn = isLoggedIn;
 exports.isNode = isNode;
 exports.isReactNative = isReactNative;