@iblai/web-utils 0.3.0 → 1.0.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/web-utils",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "main": "./dist/index.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
@@ -22,6 +22,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@rollup/plugin-commonjs": "^28.0.9",
+    "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
     "@testing-library/jest-dom": "6.6.3",
@@ -48,8 +49,9 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@iblai/data-layer": "workspace:*",
+    "@iblai/data-layer": "1.0.0",
     "@reduxjs/toolkit": "^2.10.0",
+    "axios": "^1.13.1",
     "dayjs": "^1.11.19",
     "jwt-decode": "^4.0.0",
     "react-redux": "^9.2.0",

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

@@ -0,0 +1,8 @@
+/**
+ * Chat area size constants
+ */
+export declare const CHAT_AREA_SIZE: {
+    readonly DEFAULT: 672;
+    readonly MIN: 672;
+    readonly MAX: 1024;
+};

package/dist/web-utils/src/features/files/filesSlice.d.ts

@@ -0,0 +1,20 @@
+import { Slice } from "@reduxjs/toolkit";
+export 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;
+}
+export interface FilesState {
+    attachedFiles: AttachedFile[];
+}
+export declare const filesSlice: Slice<FilesState>;
+export declare const addFiles: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, removeFile: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, clearFiles: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, updateFileProgress: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, updateFileStatus: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, updateFileUrl: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, updateFileMetadata: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, updateFileRetryCount: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>, updateFileUrlFromWebSocket: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<`${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPayload<any, `${string}/${string}`> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+export declare const filesReducer: import("@reduxjs/toolkit").Reducer<FilesState>;

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

@@ -1,2 +1,3 @@
 export * from "./chat/slice";
 export * from "./tracking";
+export * from "./files/filesSlice";

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

@@ -10,22 +10,24 @@ type Props = {
     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;
 };
-export declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl, stopGenerationWsUrl, redirectToAuthSpa, errorHandler, sendMessageToParentWebsite, isPreviewMode, mentorShareableToken, on402Error, }: Props): {
+export declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl, stopGenerationWsUrl, redirectToAuthSpa, errorHandler, sendMessageToParentWebsite, isPreviewMode, mentorShareableToken, on402Error, cachedSessionId, onStartNewChat, }: Props): {
     messages: Message[];
     isStreaming: boolean;
     status: ChatStatus;
     isPending: boolean;
     isStopped: boolean;
     isError: boolean;
-    currentStreamingMessage: import("../../features/chat/slice").StreamingMessage;
+    currentStreamingMessage: import("../../features").StreamingMessage;
     activeTab: "chat" | "summarize" | "translate" | "expand";
     uniqueMentorId: string;
     mentorName: string;
@@ -41,7 +43,7 @@ export declare function useAdvancedChat({ tenantKey, mentorId, username, token,
     ws: React.MutableRefObject<WebSocket | null>;
     isConnected: React.MutableRefObject<boolean>;
     messageQueue: React.MutableRefObject<any[]>;
-    sessionIds: import("../../features/chat/slice").SessionIds;
+    sessionIds: import("../../features").SessionIds;
     enableSafetyDisclaimer: any;
     resetConnection: () => void;
 };

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

@@ -1,11 +1,19 @@
 import type { AdvancedTab } from "../../utils/data/advanced-tab";
 import { ChatStatus } from "@web-utils/features";
+import { FileReference } from "../../types/file-upload";
 type MessageActionTypes = "redirectToAuthSpaJoinTenant";
 export interface MessageAction {
     text: string;
     type: "primary" | "danger";
     actionType: MessageActionTypes;
 }
+export interface FileAttachment {
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+    uploadUrl?: string;
+    fileId?: string;
+}
 export interface Message {
     id: string;
     role: "user" | "assistant" | "system";
@@ -16,9 +24,11 @@ export interface Message {
     contentType?: string;
     visible: boolean;
     actions?: MessageAction[];
+    fileAttachments?: FileAttachment[];
 }
 export type SendMessageOptions = {
     visible?: boolean;
+    fileReferences?: FileReference[];
 } | undefined;
 export interface UseChatProps {
     wsUrl: string;
@@ -36,7 +46,7 @@ export interface UseChatProps {
     hapticFeedback?: {
         impactAsync: (style: any) => Promise<void>;
     };
-    redirectToAuthSpa: () => void;
+    redirectToAuthSpa: (redirectTo?: string, platformKey?: string, logout?: boolean) => void;
     store?: {
         sendMessage?: (text: string) => Promise<void>;
     };

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

@@ -3,3 +3,5 @@ export * from "./providers";
 export * from "./utils";
 export * from "./types";
 export * from "./features";
+export * from "./constants/chat";
+export * from "./services";

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

@@ -1,12 +1,14 @@
-export { useGetChatDetails } from './hooks/chat/use-get-chat-details';
-export { useAdvancedChat } from './hooks/chat/use-advanced-chat';
-export { useTimeTracker } from './features/tracking/use-time-tracker';
-export { useMentorSettings } from './hooks/use-mentor-settings';
-export type { ChatMode } from './types';
-export { advancedTabsProperties, ANONYMOUS_USERNAME } from './utils';
-export { isAlphaNumeric32 } from './utils';
-export { getTimeAgo } from './utils';
-export { getInitials } from './utils';
-export { chatActions, selectSessionId } from './features/chat/slice';
-export { AuthProvider, TenantProvider, MentorProvider } from './providers';
-export { useSearchParams, useParams, useRouter, usePathname } from 'next/navigation';
+export { useGetChatDetails } from "./hooks/chat/use-get-chat-details";
+export { useAdvancedChat } from "./hooks/chat/use-advanced-chat";
+export { useTimeTracker } from "./features/tracking/use-time-tracker";
+export { useMentorSettings } from "./hooks/use-mentor-settings";
+export type { ChatMode } from "./types";
+export { advancedTabsProperties, ANONYMOUS_USERNAME } from "./utils";
+export { isAlphaNumeric32 } from "./utils";
+export { getTimeAgo } from "./utils";
+export { getInitials } from "./utils";
+export { isInIframe, sendMessageToParentWebsite, deleteCookie, getDomainParts, deleteCookieOnAllDomains, getParentDomain, setCookieForAuth, clearCookies, isLoggedIn, getPlatformKey, redirectToAuthSpa, getAuthSpaJoinUrl, redirectToAuthSpaJoinTenant, handleLogout, } from "./utils/auth";
+export type { RedirectToAuthSpaOptions, HandleLogoutOptions, } from "./utils/auth";
+export { chatActions, selectSessionId } from "./features/chat/slice";
+export { AuthProvider, TenantProvider, MentorProvider } from "./providers";
+export { useSearchParams, useParams, useRouter, usePathname, } from "next/navigation";

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

@@ -40,6 +40,8 @@
  * - Polls for cookie changes every 2 seconds
  * - Refreshes the page when cross-SPA changes are detected
  * - Listens for storage events to update cookies when localStorage changes
+ * - Monitors logout timestamp cookie to trigger cross-SPA logout
+ * - Automatically logs out when another SPA initiates logout
  *
  * For React Native:
  * - Relies on AsyncStorage only (handled by StorageService)
@@ -54,6 +56,12 @@ import { StorageService } from "@iblai/data-layer";
  * On React Native, this is a no-op
  */
 export 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
+ */
+export declare function clearCurrentTenantCookie(): void;
 /**
  * Clear all authentication cookies (web only)
  * Should be called on logout
@@ -96,7 +104,7 @@ type Props = {
     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;

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

@@ -53,6 +53,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
@@ -64,5 +65,5 @@ type Props = {
  * 4. Handles tenant-specific domain redirects
  * 5. Maintains tenant access state
  */
-export declare function TenantProvider({ children, fallback, onAuthSuccess, onAuthFailure, currentTenant, requestedTenant, saveCurrentTenant, saveUserTenants, handleTenantSwitch, saveVisitingTenant, removeVisitingTenant, saveUserTokens, saveTenant, onAutoJoinUserToTenant, }: Props): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export 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.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
 export {};

package/dist/web-utils/src/services/__tests__/file-upload.test.d.ts

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

package/dist/web-utils/src/services/file-upload.d.ts

@@ -0,0 +1,60 @@
+import type { FileInfo, FileReference, UploadProgressCallback } from "../types/file-upload";
+import type { FileUploadURLResponse } from "@iblai/data-layer";
+/**
+ * Extract file information from File object
+ */
+export 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
+ */
+export 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)
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare function validateFile(file: File, maxSizeBytes?: number, allowedTypes?: string[]): string | null;

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

@@ -0,0 +1 @@
+export * from "./file-upload";

package/dist/web-utils/src/types/file-upload.d.ts

@@ -0,0 +1,62 @@
+/**
+ * File reference sent via WebSocket to backend
+ * Backend uses this to retrieve file from S3
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export type UploadProgressCallback = (progress: number) => void;
+/**
+ * File info extracted from File object
+ */
+export interface FileInfo {
+    fileName: string;
+    contentType: string;
+    fileSize: number;
+}

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

@@ -62,3 +62,4 @@ export interface Tenant {
 }
 export * from "./chat";
 export * from "./subscription";
+export * from "./file-upload";

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

@@ -0,0 +1,180 @@
+/**
+ * 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
+ */
+export declare function isInIframe(): boolean;
+/**
+ * Send a message to the parent website (when in iframe)
+ * @param payload - The data to send to parent window
+ */
+export 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
+ */
+export 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']
+ */
+export 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
+ */
+export 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')
+ */
+export 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)
+ */
+export declare function setCookieForAuth(name: string, value: string, days?: number): void;
+/**
+ * Clear all cookies for the current domain
+ */
+export 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
+ */
+export 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
+ */
+export declare function getPlatformKey(url: string, pattern?: RegExp): string | null;
+export 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',
+ * });
+ * ```
+ */
+export 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
+ */
+export 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)
+ */
+export declare function redirectToAuthSpaJoinTenant(authUrl: string, tenantKey?: string, redirectUrl?: string): void;
+export 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',
+ * });
+ * ```
+ */
+export declare function handleLogout(options: HandleLogoutOptions): void;

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

@@ -1,3 +1,4 @@
 export * from "./data/advanced-tab";
 export * from "./constants";
 export * from "./helpers";
+export * from "./auth";