Not logged in
;\n }\n\n return (\n \n
\n );\n}\n```\n\n### Tenant Provider\n\nManage tenant/platform context:\n\n```tsx\nimport { TenantProvider, useTenantContext } from '@iblai/web-utils';\n\nfunction App() {\n return (\n Welcome, {user.name}
\n \n\n
\n );\n}\n```\n\n### Mentor Provider\n\nManage mentor context for AI chat applications:\n\n```tsx\nimport { MentorProvider, useMentorContext } from '@iblai/web-utils';\n\nfunction App() {\n return (\n Current Tenant: {tenant?.name}
\nKey: {tenant?.key}
\n\n
\n );\n}\n```\n\n## React Hooks\n\n### Advanced Chat Hook\n\nManage AI chat conversations with advanced features:\n\n```tsx\nimport { useAdvancedChat } from '@iblai/web-utils';\n\nfunction ChatInterface() {\n const {\n messages,\n sendMessage,\n isStreaming,\n stopGeneration,\n sessionId,\n } = useAdvancedChat({\n wsUrl: 'wss://api.example.com/chat',\n wsToken: 'your-token',\n mentorId: 'mentor-123',\n });\n\n const handleSend = (text: string) => {\n sendMessage({\n content: text,\n sessionId,\n });\n };\n\n return (\n Active Mentor: {mentor?.name}
\nID: {mentor?.id}
\n\n
\n );\n}\n```\n\n### Time Tracker Hook\n\nTrack user time spent in application:\n\n```tsx\nimport { useTimeTracker } from '@iblai/web-utils';\n\nfunction App() {\n useTimeTracker({\n endpoint: 'https://api.example.com/time-tracking',\n token: 'your-token',\n tenantKey: 'my-tenant',\n mentorId: 'mentor-123',\n interval: 60000, // Track every minute\n });\n\n return Loading pricing...
;\n\n return (\n \n {pricingPlans.map(plan => (\n
\n );\n}\n```\n\n### Tenant Metadata Hook\n\nFetch tenant configuration and metadata:\n\n```tsx\nimport { useTenantMetadata } from '@iblai/web-utils';\n\nfunction TenantSettings() {\n const { metadata, isLoading } = useTenantMetadata('my-tenant');\n\n return (\n \n 
\n
\n );\n}\n```\n\n### Tenant Switch Sync Hook\n\nKeep other tabs in sync during a tenant switch. Ignores this tab's own broadcast\necho and refreshes the shared switch lock so the tab won't auto-revert:\n\n```tsx\nimport { useTenantSwitchSync } from '@iblai/web-utils';\n\nfunction Providers({ children }) {\n useTenantSwitchSync();\n return <>{children};\n}\n```\n\n## Utility Functions\n\n### Cookie Management\n\n```tsx\nimport {\n setCookieForAuth,\n deleteCookie,\n clearCookies,\n} from '@iblai/web-utils';\n\n// Set auth cookie\nsetCookieForAuth('token', 'abc123', 7); // 7 days\n\n// Delete specific cookie\ndeleteCookie('token');\n\n// Clear all auth cookies\nclearCookies(['token', 'refresh_token']);\n```\n\n### Iframe Detection\n\n```tsx\nimport { isInIframe, sendMessageToParentWebsite } from '@iblai/web-utils';\n\nif (isInIframe()) {\n // Send message to parent window\n sendMessageToParentWebsite({\n type: 'LOGGED_IN',\n userId: 'user-123',\n });\n}\n```\n\n### Time Utilities\n\n```tsx\nimport { getTimeAgo, useDayJs } from '@iblai/web-utils';\n\n// Get relative time\nconst timeAgo = getTimeAgo('2024-01-01T00:00:00Z');\n// Returns: \"2 months ago\"\n\n// Use Day.js in components\nfunction DateDisplay({ date }) {\n const dayjs = useDayJs();\n return {dayjs(date).format('MMM D, YYYY')};\n}\n```\n\n### Profile Utilities\n\n```tsx\nimport { getInitials } from '@iblai/web-utils';\n\nfunction Avatar({ name }) {\n const initials = getInitials(name);\n // \"John Doe\" => \"JD\"\n\n return {metadata?.name}
\n{metadata?.description}
\n{initials}
;\n}\n```\n\n### Validation\n\n```tsx\nimport { isAlphaNumeric32 } from '@iblai/web-utils';\n\nconst isValid = isAlphaNumeric32('abc123XYZ');\n// Validates alphanumeric strings up to 32 chars\n```\n\n## TypeScript Support\n\nAll utilities and hooks are fully typed:\n\n```tsx\nimport type {\n RedirectToAuthSpaOptions,\n HandleLogoutOptions,\n AuthContextType,\n TenantContextType,\n Message,\n ChatState,\n} from '@iblai/web-utils';\n\nconst authOptions: RedirectToAuthSpaOptions = {\n authUrl: 'https://auth.example.com',\n appName: 'mentor',\n platformKey: 'my-tenant',\n};\n```\n\n## Advanced Features\n\n### Custom Metadata Loading\n\n```tsx\nimport { loadMetadataConfig } from '@iblai/web-utils';\n\nconst metadata = await loadMetadataConfig('my-tenant', {\n endpoint: 'https://api.example.com/metadata',\n headers: {\n 'Authorization': 'Bearer token',\n },\n});\n```\n\n### File Upload with S3\n\n```tsx\nimport { requestPresignedUrl, uploadToS3 } from '@iblai/web-utils';\n\nasync function uploadFile(file: File) {\n // Get presigned URL\n const { url, fields } = await requestPresignedUrl({\n fileName: file.name,\n fileType: file.type,\n });\n\n // Upload to S3\n await uploadToS3(url, fields, file, {\n onProgress: (percent) => {\n console.log(`Upload progress: ${percent}%`);\n },\n });\n}\n```\n\n## Contributing\n\nWe welcome contributions! Please read our [contributing guidelines](CONTRIBUTING.md).\n\n## Development\n\n### Building\n\n```bash\npnpm build\n```\n\n### Testing\n\n```bash\npnpm test\n```\n\n### Type Checking\n\n```bash\npnpm typecheck\n```\n\n## License\n\nISC\n","readmeFilename":"README.md"}