@iblai/web-utils 0.2.1 → 1.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { FreeUsageCount, StripeCustomerPortalRequest } from '@iblai/iblai-api';
-import { StripeContextResponse, UploadProfileImageResponse, RemoveProfileImageResponse, StorageService, TokenResponse } from '@iblai/data-layer';
+import { StripeContextResponse, UploadProfileImageResponse, RemoveProfileImageResponse, StorageService, TokenResponse, FileUploadURLResponse } from '@iblai/data-layer';
 import * as React$1 from 'react';
 import React__default from 'react';
 import { PricingModalData as PricingModalData$1 } from '@web-utils/types/subscription';
@@ -7,6 +7,7 @@ import { OpUnitType } from 'dayjs';
 import duration from 'dayjs/plugin/duration';
 import { ChatStatus as ChatStatus$1 } from '@web-utils/features';
 import * as _reduxjs_toolkit from '@reduxjs/toolkit';
+import { Slice } from '@reduxjs/toolkit';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Tenant as Tenant$3 } from '@web-utils/types';
 import { z } from 'zod';
@@ -317,12 +318,82 @@ declare const advancedTabs: ("chat" | "summarize" | "translate" | "expand")[];
 type AdvancedTab = keyof typeof advancedTabsProperties;
 declare const translatePrompt: (language: string) => string;
 
+/**
+ * File reference sent via WebSocket to backend
+ * Backend uses this to retrieve file from S3
+ */
+interface FileReference {
+    /** Unique identifier for the ChatFile record */
+    file_id: string;
+    /** S3 object key for the uploaded file */
+    file_key: string;
+    /** Original filename */
+    file_name: string;
+    /** MIME type of the file */
+    content_type: string;
+    /** File size in bytes */
+    file_size: number;
+    /** Presigned URL for displaying the file (optional, for UI) */
+    upload_url?: string;
+}
+/**
+ * File upload state for UI tracking
+ */
+interface FileUploadState {
+    /** Original File object */
+    file: File;
+    /** Upload/processing status */
+    status: "pending" | "uploading" | "processing" | "success" | "error";
+    /** Upload progress (0-100) */
+    progress: number;
+    /** File reference after successful upload */
+    fileReference?: FileReference;
+    /** Error message if upload failed */
+    error?: string;
+}
+/**
+ * File processing event from WebSocket
+ */
+type FileProcessingEvent = {
+    type: "file_processing_progress";
+    file_name: string;
+    progress: string;
+} | {
+    type: "file_processing_success";
+    file_name: string;
+    file_url: string;
+} | {
+    type: "file_error";
+    file_name?: string;
+    error: string;
+    developer_error?: string;
+};
+/**
+ * Upload progress callback
+ */
+type UploadProgressCallback = (progress: number) => void;
+/**
+ * File info extracted from File object
+ */
+interface FileInfo {
+    fileName: string;
+    contentType: string;
+    fileSize: number;
+}
+
 type MessageActionTypes = "redirectToAuthSpaJoinTenant";
 interface MessageAction {
     text: string;
     type: "primary" | "danger";
     actionType: MessageActionTypes;
 }
+interface FileAttachment {
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+    uploadUrl?: string;
+    fileId?: string;
+}
 interface Message {
     id: string;
     role: "user" | "assistant" | "system";
@@ -333,9 +404,11 @@ interface Message {
     contentType?: string;
     visible: boolean;
     actions?: MessageAction[];
+    fileAttachments?: FileAttachment[];
 }
 type SendMessageOptions = {
     visible?: boolean;
+    fileReferences?: FileReference[];
 } | undefined;
 interface UseChatProps {
     wsUrl: string;
@@ -353,7 +426,7 @@ interface UseChatProps {
     hapticFeedback?: {
         impactAsync: (style: any) => Promise<void>;
     };
-    redirectToAuthSpa: () => void;
+    redirectToAuthSpa: (redirectTo?: string, platformKey?: string, logout?: boolean) => void;
     store?: {
         sendMessage?: (text: string) => Promise<void>;
     };
@@ -429,6 +502,187 @@ declare const addProtocolToUrl: (url: string) => string;
 declare function getTimeAgo(createdAt: string): string;
 declare const formatRelativeTime: (timestamp: string) => string;
 
+/**
+ * Authentication and Authorization Utilities
+ *
+ * This module provides utility functions for handling authentication flows,
+ * including redirects to auth SPA, cookie management, and session handling.
+ */
+/**
+ * Check if the current window is inside an iframe
+ * @returns {boolean} True if running in an iframe, false otherwise
+ */
+declare function isInIframe(): boolean;
+/**
+ * Send a message to the parent website (when in iframe)
+ * @param payload - The data to send to parent window
+ */
+declare function sendMessageToParentWebsite(payload: unknown): void;
+/**
+ * Delete a cookie with specific name, path, and domain
+ * @param name - Cookie name
+ * @param path - Cookie path
+ * @param domain - Cookie domain
+ */
+declare function deleteCookie(name: string, path: string, domain: string): void;
+/**
+ * Get all possible domain parts for cookie deletion
+ * @param domain - The domain to split
+ * @returns Array of domain parts
+ * @example
+ * getDomainParts('app.example.com') // returns ['app.example.com', 'example.com', 'com']
+ */
+declare function getDomainParts(domain: string): string[];
+/**
+ * Delete a cookie across all possible domain variations
+ * @param name - Cookie name to delete
+ * @param childDomain - The current domain
+ */
+declare function deleteCookieOnAllDomains(name: string, childDomain: string): void;
+/**
+ * Get the parent domain from a given domain
+ * @param domain - The domain to process
+ * @returns The parent domain (e.g., 'app.example.com' → '.example.com')
+ */
+declare function getParentDomain(domain?: string): string;
+/**
+ * Set a cookie for authentication with cross-domain support
+ * @param name - Cookie name
+ * @param value - Cookie value
+ * @param days - Number of days until expiration (default: 365)
+ */
+declare function setCookieForAuth(name: string, value: string, days?: number): void;
+/**
+ * Clear all cookies for the current domain
+ */
+declare function clearCookies(): void;
+/**
+ * Check if user is currently logged in
+ * @param tokenKey - The localStorage key for the auth token (default: 'axd_token')
+ * @returns True if logged in, false otherwise
+ */
+declare function isLoggedIn(tokenKey?: string): boolean;
+/**
+ * Extract platform/tenant key from URL
+ * @param url - The URL to parse
+ * @param pattern - RegExp pattern to match platform key (default matches /platform/[key]/...)
+ * @returns The platform key or null if not found
+ */
+declare function getPlatformKey(url: string, pattern?: RegExp): string | null;
+interface RedirectToAuthSpaOptions {
+    /** URL to redirect to after auth (defaults to current path + search) */
+    redirectTo?: string;
+    /** Platform/tenant key */
+    platformKey?: string;
+    /** Whether this is a logout action */
+    logout?: boolean;
+    /** Whether to save redirect path to localStorage (default: true) */
+    saveRedirect?: boolean;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** Current app/platform identifier (e.g., 'mentor', 'skills') */
+    appName: string;
+    /** Query param names */
+    queryParams?: {
+        app?: string;
+        redirectTo?: string;
+        tenant?: string;
+    };
+    /** localStorage key for saving redirect path */
+    redirectPathStorageKey?: string;
+    /** Cookie names for cross-SPA sync */
+    cookieNames?: {
+        currentTenant?: string;
+        userData?: string;
+        tenant?: string;
+        logoutTimestamp?: string;
+    };
+}
+/**
+ * Redirect to authentication SPA for login/logout
+ *
+ * This function handles the complete authentication flow:
+ * - Clears localStorage and cookies on logout
+ * - Saves redirect path for post-auth return
+ * - Handles iframe scenarios
+ * - Syncs logout across multiple SPAs via cookies
+ *
+ * @param options - Configuration options for the redirect
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ * });
+ *
+ * // With logout
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   logout: true,
+ *   platformKey: 'my-tenant',
+ * });
+ *
+ * // With custom redirect
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   redirectTo: '/dashboard',
+ *   platformKey: 'my-tenant',
+ * });
+ * ```
+ */
+declare function redirectToAuthSpa(options: RedirectToAuthSpaOptions): Promise<void>;
+/**
+ * Get the URL for joining a tenant (sign up flow)
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ * @returns The join URL
+ */
+declare function getAuthSpaJoinUrl(authUrl: string, tenantKey?: string, redirectUrl?: string): string;
+/**
+ * Redirect to auth SPA's join/signup page for a specific tenant
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ */
+declare function redirectToAuthSpaJoinTenant(authUrl: string, tenantKey?: string, redirectUrl?: string): void;
+interface HandleLogoutOptions {
+    /** URL to redirect to after logout (defaults to current origin) */
+    redirectUrl?: string;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** localStorage key for tenant */
+    tenantStorageKey?: string;
+    /** Cookie name for logout timestamp */
+    logoutTimestampCookie?: string;
+    /** Callback to execute before logout */
+    callback?: () => void;
+}
+/**
+ * Handle user logout
+ *
+ * This function:
+ * - Clears localStorage (preserving tenant)
+ * - Sets logout timestamp cookie for cross-SPA sync
+ * - Clears all cookies
+ * - Redirects to auth SPA logout endpoint
+ *
+ * @param options - Logout configuration options
+ *
+ * @example
+ * ```tsx
+ * handleLogout({
+ *   authUrl: 'https://auth.example.com',
+ *   redirectUrl: 'https://app.example.com',
+ * });
+ * ```
+ */
+declare function handleLogout(options: HandleLogoutOptions): void;
+
 type ChatState = Record<AdvancedTab, Message[]>;
 interface SessionIds extends Record<AdvancedTab, string> {
 }
@@ -530,6 +784,94 @@ declare const selectShowingSharedChat: (state: {
     chatSliceShared: ChatSliceState;
 }) => boolean;
 
+interface TimeTrackerConfig {
+    intervalSeconds: number;
+    onTimeUpdate: (url: string, timeSpent: number) => void;
+    getCurrentUrl: () => string;
+    onRouteChange?: (callback: () => void) => () => void;
+}
+interface TimeTrackerState {
+    currentUrl: string;
+    startTime: number;
+    intervalId: number | null;
+    routeUnsubscribe: (() => void) | null;
+}
+declare class TimeTracker {
+    private state;
+    private config;
+    constructor(config: TimeTrackerConfig);
+    private initialize;
+    private startTracking;
+    private clearInterval;
+    private resetTimer;
+    private getTimeSpent;
+    private sendTimeUpdate;
+    private handleRouteChange;
+    pause(): void;
+    resume(): void;
+    destroy(): void;
+    getCurrentUrl(): string;
+    getTimeSpentSinceLastReset(): number;
+}
+
+interface UseTimeTrackerConfig {
+    intervalSeconds: number;
+    onTimeUpdate: (url: string, timeSpent: number) => void;
+    enabled?: boolean;
+    getCurrentUrl?: () => string;
+    onRouteChange?: (callback: () => void) => () => void;
+}
+interface UseTimeTrackerReturn {
+    pause: () => void;
+    resume: () => void;
+    getCurrentUrl: () => string;
+    getTimeSpentSinceLastReset: () => number;
+}
+declare function useTimeTracker(config: UseTimeTrackerConfig): UseTimeTrackerReturn;
+
+interface UseTimeTrackerNativeConfig {
+    intervalSeconds: number;
+    onTimeUpdate: (url: string, timeSpent: number) => void;
+    getCurrentRoute: () => string;
+    onRouteChange?: (callback: () => void) => () => void;
+    enabled?: boolean;
+}
+interface UseTimeTrackerNativeReturn {
+    pause: () => void;
+    resume: () => void;
+    getCurrentUrl: () => string;
+    getTimeSpentSinceLastReset: () => number;
+}
+declare function useTimeTrackerNative(config: UseTimeTrackerNativeConfig): UseTimeTrackerNativeReturn;
+
+interface AttachedFile {
+    id: string;
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+    uploadUrl: string;
+    uploadProgress: number;
+    uploadStatus: "pending" | "uploading" | "processing" | "success" | "error";
+    fileKey?: string;
+    fileId?: string;
+    retryCount?: number;
+    fileUrl?: string;
+}
+interface FilesState {
+    attachedFiles: AttachedFile[];
+}
+declare const filesSlice: Slice<FilesState>;
+declare const addFiles: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const removeFile: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const clearFiles: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const updateFileProgress: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const updateFileStatus: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const updateFileUrl: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const updateFileMetadata: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const updateFileRetryCount: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const updateFileUrlFromWebSocket: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const filesReducer: Reducer<State>;
+
 type ChatMode = "advanced" | "default";
 
 interface UseExternalPricingProps {
@@ -619,15 +961,17 @@ type Props$5 = {
     username: string;
     token: string;
     wsUrl: string;
-    redirectToAuthSpa: () => void;
+    redirectToAuthSpa: (redirectTo?: string, platformKey?: string, logout?: boolean) => void;
     stopGenerationWsUrl: string;
     sendMessageToParentWebsite?: (payload: unknown) => void;
     errorHandler?: (message: string, error?: any) => void;
     isPreviewMode?: boolean;
     mentorShareableToken?: string | null;
     on402Error?: (message: Record<string, unknown>) => void;
+    cachedSessionId?: string;
+    onStartNewChat?: (sessionId: string) => void;
 };
-declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl, stopGenerationWsUrl, redirectToAuthSpa, errorHandler, sendMessageToParentWebsite, isPreviewMode, mentorShareableToken, on402Error, }: Props$5): {
+declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl, stopGenerationWsUrl, redirectToAuthSpa, errorHandler, sendMessageToParentWebsite, isPreviewMode, mentorShareableToken, on402Error, cachedSessionId, onStartNewChat, }: Props$5): {
     messages: Message[];
     isStreaming: boolean;
     status: ChatStatus;
@@ -798,6 +1142,12 @@ declare function useMentorSettings({ mentorId, tenantKey, username }: Props$3):
  * On React Native, this is a no-op
  */
 declare function syncAuthToCookies(storageService: StorageService): Promise<void>;
+/**
+ * Clear current tenant cookie only (web only)
+ * Should be called before tenant switching
+ * On React Native, this is a no-op
+ */
+declare function clearCurrentTenantCookie(): void;
 /**
  * Clear all authentication cookies (web only)
  * Should be called on logout
@@ -840,7 +1190,7 @@ type Props$2 = {
     middleware?: Map<string | RegExp, () => Promise<boolean>>;
     onAuthSuccess?: () => void;
     onAuthFailure?: (reason: string) => void;
-    redirectToAuthSpa: (redirectTo?: string, platformKey?: string, logout?: boolean) => void;
+    redirectToAuthSpa: (redirectTo?: string, platformKey?: string, logout?: boolean, saveRedirect?: boolean) => void;
     hasNonExpiredAuthToken: () => boolean;
     username: string;
     pathname: string;
@@ -944,6 +1294,7 @@ type Props = {
     saveUserTokens?: (tokens: TokenResponse) => void;
     saveTenant?: (tenant: string) => void;
     onAutoJoinUserToTenant?: (platformName: string) => void;
+    redirectToAuthSpa?: (redirectTo?: string, platformKey?: string, logout?: boolean, saveRedirect?: boolean) => void;
 };
 /**
  * TenantProvider Component
@@ -955,67 +1306,75 @@ type Props = {
  * 4. Handles tenant-specific domain redirects
  * 5. Maintains tenant access state
  */
-declare function TenantProvider({ children, fallback, onAuthSuccess, onAuthFailure, currentTenant, requestedTenant, saveCurrentTenant, saveUserTenants, handleTenantSwitch, saveVisitingTenant, removeVisitingTenant, saveUserTokens, saveTenant, onAutoJoinUserToTenant, }: Props): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+declare function TenantProvider({ children, fallback, onAuthSuccess, onAuthFailure, currentTenant, requestedTenant, saveCurrentTenant, saveUserTenants, handleTenantSwitch, saveVisitingTenant, removeVisitingTenant, saveUserTokens, saveTenant, onAutoJoinUserToTenant, redirectToAuthSpa, }: Props): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
 
-interface TimeTrackerConfig {
-    intervalSeconds: number;
-    onTimeUpdate: (url: string, timeSpent: number) => void;
-    getCurrentUrl: () => string;
-    onRouteChange?: (callback: () => void) => () => void;
-}
-interface TimeTrackerState {
-    currentUrl: string;
-    startTime: number;
-    intervalId: number | null;
-    routeUnsubscribe: (() => void) | null;
-}
-declare class TimeTracker {
-    private state;
-    private config;
-    constructor(config: TimeTrackerConfig);
-    private initialize;
-    private startTracking;
-    private clearInterval;
-    private resetTimer;
-    private getTimeSpent;
-    private sendTimeUpdate;
-    private handleRouteChange;
-    pause(): void;
-    resume(): void;
-    destroy(): void;
-    getCurrentUrl(): string;
-    getTimeSpentSinceLastReset(): number;
-}
-
-interface UseTimeTrackerConfig {
-    intervalSeconds: number;
-    onTimeUpdate: (url: string, timeSpent: number) => void;
-    enabled?: boolean;
-    getCurrentUrl?: () => string;
-    onRouteChange?: (callback: () => void) => () => void;
-}
-interface UseTimeTrackerReturn {
-    pause: () => void;
-    resume: () => void;
-    getCurrentUrl: () => string;
-    getTimeSpentSinceLastReset: () => number;
-}
-declare function useTimeTracker(config: UseTimeTrackerConfig): UseTimeTrackerReturn;
+/**
+ * Chat area size constants
+ */
+declare const CHAT_AREA_SIZE: {
+    readonly DEFAULT: 672;
+    readonly MIN: 672;
+    readonly MAX: 1024;
+};
 
-interface UseTimeTrackerNativeConfig {
-    intervalSeconds: number;
-    onTimeUpdate: (url: string, timeSpent: number) => void;
-    getCurrentRoute: () => string;
-    onRouteChange?: (callback: () => void) => () => void;
-    enabled?: boolean;
-}
-interface UseTimeTrackerNativeReturn {
-    pause: () => void;
-    resume: () => void;
-    getCurrentUrl: () => string;
-    getTimeSpentSinceLastReset: () => number;
-}
-declare function useTimeTrackerNative(config: UseTimeTrackerNativeConfig): UseTimeTrackerNativeReturn;
+/**
+ * Extract file information from File object
+ */
+declare function getFileInfo(file: File): FileInfo;
+/**
+ * Request presigned S3 URL from backend
+ * Note: This function should be called via the RTK Query mutation hook
+ * This is a helper to show the data flow
+ */
+declare function requestPresignedUrl(sessionId: string, file: File, getUploadUrlFn: (params: {
+    org: string;
+    userId: string;
+    requestBody: {
+        session_id: string;
+        file_name: string;
+        content_type: string;
+        file_size: number;
+    };
+}) => Promise<FileUploadURLResponse>, org: string, userId: string): Promise<FileUploadURLResponse>;
+/**
+ * Upload file directly to S3 using presigned URL
+ * Uses axios for cross-platform support (web + React Native)
+ */
+declare function uploadToS3(presignedUrl: string, file: File, contentType: string, onProgress?: UploadProgressCallback): Promise<void>;
+/**
+ * Complete file upload flow:
+ * 1. Request presigned URL
+ * 2. Upload to S3
+ * 3. Return file reference
+ */
+declare function createFileReference(file: File, sessionId: string, getUploadUrlFn: (params: {
+    org: string;
+    userId: string;
+    requestBody: {
+        session_id: string;
+        file_name: string;
+        content_type: string;
+        file_size: number;
+    };
+}) => Promise<FileUploadURLResponse>, org: string, userId: string, onProgress?: UploadProgressCallback): Promise<FileReference>;
+/**
+ * Upload multiple files and return their references
+ */
+declare function createMultipleFileReferences(files: File[], sessionId: string, getUploadUrlFn: (params: {
+    org: string;
+    userId: string;
+    requestBody: {
+        session_id: string;
+        file_name: string;
+        content_type: string;
+        file_size: number;
+    };
+}) => Promise<FileUploadURLResponse>, org: string, userId: string, onFileProgress?: (fileIndex: number, progress: number) => void): Promise<FileReference[]>;
+/**
+ * Validate file before upload
+ * Returns error message if invalid, null if valid
+ */
+declare function validateFile(file: File, maxSizeBytes?: number, allowedTypes?: string[]): string | null;
 
-export { ALPHANUMERIC_32_REGEX, ANONYMOUS_USERNAME, AuthContext, AuthContextProvider, AuthProvider, LOCAL_STORAGE_KEYS, MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS, MENTOR_CHAT_DOCUMENTS_EXTENSIONS, METADATAS, MentorProvider, SUBSCRIPTION_MESSAGES, SUBSCRIPTION_PACKAGES, SUBSCRIPTION_TRIGGERS, SUBSCRIPTION_V2_TRIGGERS, SubscriptionFlow, SubscriptionFlowV2, TOOLS, TenantContext, TenantContextProvider, TenantProvider, TimeTracker, addProtocolToUrl, advancedTabs, advancedTabsProperties, chatActions, chatSliceReducerShared, clearAuthCookies, defaultSessionIds, formatRelativeTime, getInitials, getTimeAgo, getUserName, isAlphaNumeric32, isJSON, loadMetadataConfig, selectActiveChatMessages, selectActiveTab, selectChats, selectCurrentStreamingMessage, selectDocumentFilter, selectIframeContext, selectIsError, selectIsPending, selectIsStopped, selectIsTyping, selectNumberOfActiveChatMessages, selectSessionId, selectSessionIds, selectShouldStartNewChat, selectShowingSharedChat, selectStatus, selectStreaming, selectToken, selectTokenEnabled, selectTools, syncAuthToCookies, tenantKeySchema, tenantSchema, translatePrompt, useAdvancedChat, useAuthContext, useAuthProvider, useChat, useDayJs, useExternalPricingPlan, useMentorSettings, useMentorTools, useProfileImageUpload, useSubscriptionHandler, useSubscriptionHandlerV2, useTenantContext, useTenantMetadata, useTimeTracker, useTimeTrackerNative, useUserProfileUpdate, userDataSchema };
-export type { AdvancedTab, AuthContextType, ChatMode, ChatState, ChatStatus, CreateStripeCustomerPortalRequest, Message, MessageAction, PricingModalData, Prompt, SendMessageOptions, SessionIds, StreamingMessage, SubscriptionFlowConfig, SubscriptionFlowConfigV2, Tenant, TenantContextType, TenantKeyMentorIdParams, TenantMetadata, TimeTrackerConfig, TimeTrackerState, TopTrialBannerProps, UseChatProps, UseChatReturn, UseExternalPricingProps, UseProfileImageUploadOptions, UseProfileImageUploadReturn, UseTimeTrackerConfig, UseTimeTrackerNativeConfig, UseTimeTrackerNativeReturn, UseTimeTrackerReturn, UseUserProfileUpdateResult, UserProfileUpdateData };
+export { ALPHANUMERIC_32_REGEX, ANONYMOUS_USERNAME, AuthContext, AuthContextProvider, AuthProvider, CHAT_AREA_SIZE, LOCAL_STORAGE_KEYS, MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS, MENTOR_CHAT_DOCUMENTS_EXTENSIONS, METADATAS, MentorProvider, SUBSCRIPTION_MESSAGES, SUBSCRIPTION_PACKAGES, SUBSCRIPTION_TRIGGERS, SUBSCRIPTION_V2_TRIGGERS, SubscriptionFlow, SubscriptionFlowV2, TOOLS, TenantContext, TenantContextProvider, TenantProvider, TimeTracker, addFiles, addProtocolToUrl, advancedTabs, advancedTabsProperties, chatActions, chatSliceReducerShared, clearAuthCookies, clearCookies, clearCurrentTenantCookie, clearFiles, createFileReference, createMultipleFileReferences, defaultSessionIds, deleteCookie, deleteCookieOnAllDomains, filesReducer, filesSlice, formatRelativeTime, getAuthSpaJoinUrl, getDomainParts, getFileInfo, getInitials, getParentDomain, getPlatformKey, getTimeAgo, getUserName, handleLogout, isAlphaNumeric32, isInIframe, isJSON, isLoggedIn, loadMetadataConfig, redirectToAuthSpa, redirectToAuthSpaJoinTenant, removeFile, requestPresignedUrl, selectActiveChatMessages, selectActiveTab, selectChats, selectCurrentStreamingMessage, selectDocumentFilter, selectIframeContext, selectIsError, selectIsPending, selectIsStopped, selectIsTyping, selectNumberOfActiveChatMessages, selectSessionId, selectSessionIds, selectShouldStartNewChat, selectShowingSharedChat, selectStatus, selectStreaming, selectToken, selectTokenEnabled, selectTools, sendMessageToParentWebsite, setCookieForAuth, syncAuthToCookies, tenantKeySchema, tenantSchema, translatePrompt, updateFileMetadata, updateFileProgress, updateFileRetryCount, updateFileStatus, updateFileUrl, updateFileUrlFromWebSocket, uploadToS3, useAdvancedChat, useAuthContext, useAuthProvider, useChat, useDayJs, useExternalPricingPlan, useMentorSettings, useMentorTools, useProfileImageUpload, useSubscriptionHandler, useSubscriptionHandlerV2, useTenantContext, useTenantMetadata, useTimeTracker, useTimeTrackerNative, useUserProfileUpdate, userDataSchema, validateFile };
+export type { AdvancedTab, AttachedFile, AuthContextType, ChatMode, ChatState, ChatStatus, CreateStripeCustomerPortalRequest, FileAttachment, FileInfo, FileProcessingEvent, FileReference, FileUploadState, FilesState, HandleLogoutOptions, Message, MessageAction, PricingModalData, Prompt, RedirectToAuthSpaOptions, SendMessageOptions, SessionIds, StreamingMessage, SubscriptionFlowConfig, SubscriptionFlowConfigV2, Tenant, TenantContextType, TenantKeyMentorIdParams, TenantMetadata, TimeTrackerConfig, TimeTrackerState, TopTrialBannerProps, UploadProgressCallback, UseChatProps, UseChatReturn, UseExternalPricingProps, UseProfileImageUploadOptions, UseProfileImageUploadReturn, UseTimeTrackerConfig, UseTimeTrackerNativeConfig, UseTimeTrackerNativeReturn, UseTimeTrackerReturn, UseUserProfileUpdateResult, UserProfileUpdateData };