@iblai/web-utils 1.6.8 → 1.6.10

package/dist/web-utils/src/hooks/use-show-voice-recorder.d.ts

@@ -0,0 +1,7 @@
+interface UseShowVoiceRecorderProps {
+    mentorId: string;
+    tenantKey: string;
+    isPublicRoute?: boolean;
+}
+export declare function useShowVoiceRecorder({ mentorId, tenantKey, isPublicRoute, }: UseShowVoiceRecorderProps): boolean;
+export {};

package/dist/web-utils/src/hooks/use-timer.d.ts

@@ -0,0 +1,7 @@
+export declare function useTimer(): {
+    startTime: Date | null;
+    time: number;
+    isRunning: boolean;
+    start: () => void;
+    stop: () => void;
+};

package/dist/web-utils/src/hooks/use-tokens.d.ts

@@ -0,0 +1,2 @@
+export declare function useDmToken(): string;
+export declare function useAxdToken(): string;

package/dist/web-utils/src/hooks/use-user-agreement.d.ts

@@ -0,0 +1,21 @@
+interface UseUserAgreementProps {
+    mentorId: string;
+    tenantKey: string;
+}
+export declare function useUserAgreement({ mentorId, tenantKey, }: UseUserAgreementProps): {
+    showDisclaimerModal: boolean;
+    setShowDisclaimerModal: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    isAgreeing: boolean;
+    pendingSubmitContent: string;
+    userAgreement: import("@iblai/data-layer").Disclaimer | {
+        readonly 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.\nAll 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.\nYour 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.";
+        readonly active: false;
+    };
+    hasUserAgreement: boolean;
+    hasUserAgreedToDisclaimer: boolean;
+    isDisclaimersLoading: boolean;
+    handleDisclaimerAgree: () => Promise<void>;
+    checkAgreementAndExecute: (content: string, executeCallback: (content: string) => void) => void;
+    executePendingSubmit: (executeCallback: (content: string) => void) => void;
+};
+export {};

package/dist/web-utils/src/hooks/use-user.d.ts

@@ -0,0 +1,23 @@
+import { type Tenant } from "../types";
+export declare function useUserData(): {
+    user_display_name: string;
+    user_email: string;
+    user_fullname: string;
+    user_id: number;
+    user_nicename: string;
+} | null;
+export declare function useUsername(): string | null;
+export declare function useVisitingTenant(): {
+    visitingTenant: Tenant | undefined;
+    saveVisitingTenant: import("react").Dispatch<import("react").SetStateAction<Tenant | undefined>>;
+    removeVisitingTenant: () => void;
+};
+export declare function useUserTenants(): {
+    userTenants: Tenant[];
+    saveUserTenants: import("react").Dispatch<import("react").SetStateAction<Tenant[]>>;
+};
+export declare function useCurrentTenant(): {
+    currentTenant: Tenant | null;
+    saveCurrentTenant: import("react").Dispatch<import("react").SetStateAction<Tenant | null>>;
+};
+export declare function useIsAdmin(): boolean;

package/dist/web-utils/src/hooks/use-voice-chat.d.ts

@@ -0,0 +1,11 @@
+interface Props {
+    sendMessage: (message: string) => void;
+    tenantKey: string;
+}
+export declare function useVoiceChat({ sendMessage, tenantKey }: Props): {
+    handleMicrophoneBtnClick: () => Promise<void>;
+    recording: boolean;
+    processing: boolean;
+    time: number;
+};
+export {};

package/dist/web-utils/src/hooks/use-welcome-message.d.ts

@@ -0,0 +1,16 @@
+type Props = {
+    sessionId: string;
+    username: string;
+    tenantKey: string;
+    mentorId: string;
+    mentorUniqueId: string;
+    token: string;
+    wsUrl: string;
+    isPublicRoute?: boolean;
+    isNewSession?: boolean;
+};
+export default function useWelcome({ sessionId, username, tenantKey, mentorId, mentorUniqueId, token, wsUrl, isPublicRoute, isNewSession, }: Props): {
+    welcomeMessage: string;
+    handleSendProactivePrompt: () => void;
+};
+export {};

package/dist/web-utils/src/providers/__tests__/auth-provider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web-utils/src/providers/__tests__/service-worker-provider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web-utils/src/providers/auth-provider.d.ts

@@ -68,7 +68,7 @@ export declare function clearCurrentTenantCookie(): void;
  * On React Native, this is a no-op
  */
 export declare function clearAuthCookies(): void;
-export declare function getUserName(storageService: StorageService): Promise<any>;
+export declare function getStoredUserName(storageService: StorageService): Promise<any>;
 export declare function useAuthProvider({ middleware, onAuthSuccess, onAuthFailure, redirectToAuthSpa, hasNonExpiredAuthToken, username, pathname, storageService, skipAuthCheck, token, enableStorageSync, }: Props): {
     isAuthenticating: boolean;
     userIsAccessingPublicRoute: boolean;

package/dist/web-utils/src/providers/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./auth-provider";
 export * from "./mentor-provider";
 export * from "./tenant-provider";
+export * from "./service-worker-provider";

package/dist/web-utils/src/providers/service-worker-provider.d.ts

@@ -0,0 +1,21 @@
+import { type ServiceWorkerStatus } from '../services/register-sw';
+interface ServiceWorkerContextValue {
+    status: ServiceWorkerStatus;
+    applyUpdate: () => void;
+    clearCache: () => void;
+    refreshCacheStatus: () => Promise<Record<string, number> | null>;
+    checkNetworkNow: () => Promise<boolean>;
+}
+export declare function useServiceWorker(): ServiceWorkerContextValue;
+interface ServiceWorkerProviderProps {
+    children: React.ReactNode;
+    /**
+     * Base path used when registering the service worker. The SW is fetched
+     * from `${basePath}/sw.js` and scoped to `basePath || '/'`. Pass the
+     * host app's bundler-resolved base path (e.g. Next.js's
+     * `process.env.NEXT_PUBLIC_BASE_PATH`). Defaults to '' (root).
+     */
+    basePath?: string;
+}
+export declare function ServiceWorkerProvider({ children, basePath, }: ServiceWorkerProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/web-utils/src/services/__tests__/event-bus.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web-utils/src/services/__tests__/register-sw.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web-utils/src/services/event-bus.d.ts

@@ -0,0 +1,6 @@
+export declare const eventBus: import("mitt").Emitter<Record<import("mitt").EventType, unknown>>;
+export declare enum RemoteEvents {
+    newChat = "MENTOR:NEW_CHAT",
+    stopChatGenerating = "MENTOR:STOP_CHAT_GENERATING",
+    sendChatMessage = "MENTOR:SEND_CHAT_MESSAGE"
+}

package/dist/web-utils/src/services/index.d.ts

@@ -1 +1,3 @@
 export * from "./file-upload";
+export * from "./register-sw";
+export * from "./event-bus";

package/dist/web-utils/src/services/register-sw.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Service Worker Registration Helper
+ *
+ * Handles registration, updates, and communication with the service worker.
+ */
+export interface ServiceWorkerStatus {
+    isSupported: boolean;
+    isRegistered: boolean;
+    isOnline: boolean;
+    registration: ServiceWorkerRegistration | null;
+    updateAvailable: boolean;
+}
+type UpdateCallback = (registration: ServiceWorkerRegistration) => void;
+type StatusChangeCallback = (status: ServiceWorkerStatus) => void;
+/**
+ * Check if service workers are supported
+ */
+export declare function isServiceWorkerSupported(): boolean;
+/**
+ * Get current service worker status
+ */
+export declare function getServiceWorkerStatus(): ServiceWorkerStatus;
+/**
+ * Register the service worker.
+ * Defers registration until the page is fully loaded to avoid
+ * interfering with chunk loading — especially in WebKit/Safari where
+ * early SW registration can cause ChunkLoadError timeouts.
+ */
+export declare function registerServiceWorker(basePath?: string): Promise<ServiceWorkerRegistration | null>;
+/**
+ * Unregister the service worker
+ */
+export declare function unregisterServiceWorker(): Promise<boolean>;
+/**
+ * Skip waiting and activate new service worker immediately
+ */
+export declare function skipWaiting(): void;
+/**
+ * Clear all caches
+ */
+export declare function clearAllCaches(): void;
+/**
+ * Tell service worker we're running in Tauri
+ */
+export declare function setTauriMode(isTauri: boolean): void;
+/**
+ * Tell service worker about offline status (from Tauri)
+ */
+export declare function setOfflineStatus(isOffline: boolean): void;
+/**
+ * Request cache status from service worker
+ */
+export declare function getCacheStatus(): Promise<Record<string, number> | null>;
+/**
+ * Subscribe to service worker updates
+ */
+export declare function onUpdate(callback: UpdateCallback): () => void;
+/**
+ * Subscribe to status changes (online/offline, registration, updates)
+ */
+export declare function onStatusChange(callback: StatusChangeCallback): () => void;
+/**
+ * Setup online/offline listeners
+ */
+export declare function setupNetworkListeners(): () => void;
+/**
+ * Initialize service worker and network listeners
+ * Call this once when app loads
+ */
+export declare function initServiceWorker(basePath?: string): Promise<ServiceWorkerStatus>;
+export {};

package/dist/web-utils/src/utils/__tests__/tauri-api-cache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web-utils/src/utils/constants.d.ts

@@ -1,5 +1,6 @@
 export declare const MENTOR_CHAT_DOCUMENTS_EXTENSIONS: string[];
 export declare const ANONYMOUS_USERNAME = "anonymous";
+export declare const DEFAULT_DISCLAIMER_CONTENT = "By accessing and using the [ibl.ai](http://ibl.ai/) MentorAI platform (\u201CPlatform\u201D), 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.\nAll 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\u2019s 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.\nYour use must comply with applicable laws and institutional policies. Misuse\u2014including attempting to bypass security, copy source code, or use the service for unlawful activity\u2014may result in suspension or termination of access. Continued use constitutes acceptance of these terms.";
 export declare const MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS = 3;
 export declare const LOCAL_STORAGE_KEYS: {
     CURRENT_TENANT: string;
@@ -9,6 +10,8 @@ export declare const LOCAL_STORAGE_KEYS: {
     TOKEN_EXPIRY: string;
     USER_DATA: string;
     USER_TENANTS: string;
+    VISITING_TENANT: string;
+    SESSION_ID: string;
     EDX_TOKEN_KEY: string;
     DM_TOKEN_KEY: string;
     DM_TOKEN_EXPIRES: string;
@@ -43,3 +46,18 @@ export declare const TOOLS: {
 export declare const REQUIRED_ACTIONS_FOR_GROUPS: {
     readonly NOTIFICATIONS: "Ibl.Notifications/Notification/action";
 };
+export declare const MENTOR_VISIBILITY_VALUES: {
+    ADMINISTRATORS: "viewable_by_tenant_admins";
+    STUDENTS: "viewable_by_tenant_students";
+    ANYONE: "viewable_by_anyone";
+};
+export declare const MENTOR_VISIBILITY: ({
+    label: string;
+    value: "viewable_by_tenant_admins";
+} | {
+    label: string;
+    value: "viewable_by_tenant_students";
+} | {
+    label: string;
+    value: "viewable_by_anyone";
+})[];

package/dist/web-utils/src/utils/helpers.d.ts

@@ -1,3 +1,23 @@
+import type { Tenant } from "../types";
+/**
+ * Reads the cached user_nicename from the LOCAL_STORAGE_KEYS.USER_DATA blob.
+ */
+export declare const getUserName: () => string | null;
+/**
+ * Reads the cached user_email from the LOCAL_STORAGE_KEYS.USER_DATA blob.
+ */
+export declare const getUserEmail: () => string | null;
+/**
+ * Whether Stripe-backed billing is active for the given tenant. The Stripe
+ * feature flag is a host-side config value; pass it in. Tenants opt in via
+ * `show_paywall` or by being the "main" platform tenant.
+ */
+export declare function isStripeActivated(currentTenant: Tenant | null | undefined, stripeEnabled: boolean): boolean;
+/**
+ * Checks whether a file matches any of the accepted type specifiers.
+ * Supports MIME types (image/png), wildcard MIME (image/*), and extensions (.pdf).
+ */
+export declare function isFileAccepted(file: File, acceptedTypes: string[]): boolean;
 export declare const isJSON: (text: string) => boolean;
 export declare const getInitials: (fullName: string) => string;
 export declare const ALPHANUMERIC_32_REGEX: RegExp;

package/dist/web-utils/src/utils/index.d.ts

@@ -3,3 +3,4 @@ export * from "./constants";
 export * from "./helpers";
 export * from "./auth";
 export * from "./platform";
+export * from "./tauri-api-cache";

package/dist/web-utils/src/utils/platform.d.ts

@@ -3,6 +3,7 @@ export declare const isWeb: () => boolean;
 export declare const isNode: () => string | false;
 export declare const isExpo: () => any;
 export declare const isTauri: () => boolean;
+export declare function isSafariBrowser(): boolean;
 export declare const getPlatform: () => "react-native" | "web" | "node" | "unknown";
 export declare const safeRequire: (moduleName: string) => any;
 export declare const getNextNavigation: () => any;

package/dist/web-utils/src/utils/tauri-api-cache.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tauri API Cache
+ *
+ * localStorage-backed caching for API responses when running inside Tauri.
+ * In offline mode, cached responses are returned instead of making network requests.
+ */
+export declare function isTauriOfflineMode(): boolean;
+export declare function getCachedApiResponse<T>(endpoint: string, params?: Record<string, unknown>): T | null;
+export declare function setCachedApiResponse<T>(endpoint: string, data: T, params?: Record<string, unknown>, ttlMs?: number): void;
+export declare function clearApiCache(): void;
+export declare function fetchWithCache<T>(endpoint: string, fetchFn: () => Promise<T>, params?: Record<string, unknown>, ttlMs?: number): Promise<T>;
+export declare const CacheKeys: {
+    readonly mentorSettings: (org: string, mentor: string, userId: string) => string;
+    readonly mentorPublicSettings: (org: string, mentor: string) => string;
+    readonly tenantMetadata: (org: string) => string;
+    readonly userTenants: (userId: string) => string;
+    readonly sessionChats: (sessionId: string) => string;
+};
+export declare function preCacheMentorData(org: string, mentorId: string, userId: string, fetchMentorSettings: () => Promise<unknown>, fetchTenantMetadata: () => Promise<unknown>): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/web-utils",
-  "version": "1.6.8",
+  "version": "1.6.10",
   "main": "./dist/index.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
@@ -57,6 +57,7 @@
     "axios": "1.13.6",
     "dayjs": "1.11.20",
     "jwt-decode": "4.0.0",
+    "mitt": "3.0.1",
     "react-redux": "9.2.0",
     "rollup": "4.59.0",
     "rollup-plugin-copy": "3.5.0",
@@ -65,12 +66,20 @@
   "peerDependencies": {
     "@iblai/data-layer": "^1.1.2",
     "@iblai/iblai-api": "4.166.0-ai",
+    "@tauri-apps/plugin-os": "2.3.2",
     "react": "19.1.0",
-    "react-dom": "19.1.0"
+    "react-dom": "19.1.0",
+    "sonner": "^2.0.0"
   },
   "peerDependenciesMeta": {
     "@tauri-apps/api": {
       "optional": true
+    },
+    "@tauri-apps/plugin-os": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
     }
   },
   "publishConfig": {