@jmruthers/pace-core 0.6.5 → 0.6.7

package/src/rbac/components/EnhancedNavigationMenu.tsx

@@ -1,293 +0,0 @@
-/**
- * @file Enhanced Navigation Menu Component
- * @package @jmruthers/pace-core
- * @module RBAC/Components/EnhancedNavigationMenu
- * @since 2.0.0
- *
- * An enhanced navigation menu component that integrates with the RBAC system to provide
- * secure navigation with automatic permission filtering and enforcement.
- *
- * Features:
- * - Automatic permission-based filtering
- * - Strict mode enforcement
- * - Audit logging for navigation access
- * - Integration with existing RBAC system
- * - Customizable navigation items
- * - Error handling and recovery
- *
- * @example
- * ```tsx
- * // Basic enhanced navigation menu
- * <EnhancedNavigationMenu
- *   items={navigationItems}
- *   strictMode={true}
- *   auditLog={true}
- * />
- * 
- * // With custom configuration
- * <EnhancedNavigationMenu
- *   items={navigationItems}
- *   strictMode={true}
- *   auditLog={true}
- *   onNavigationAccess={(item, allowed) => {
- *     console.log(`Navigation access: ${item.id} - ${allowed ? 'allowed' : 'denied'}`);
- *   }}
- * />
- * ```
- *
- * @security
- * - Enforces navigation-level permissions
- * - Prevents apps from bypassing navigation permission checks
- * - Automatic audit logging for all navigation access attempts
- * - Integration with existing RBAC system
- * - Clear error messages for unauthorized navigation
- *
- * @performance
- * - Optimized with useMemo and useCallback
- * - Cached permission checks
- * - Minimal re-renders
- * - Efficient filtering
- *
- * @dependencies
- * - React 19+ - Component framework
- * - NavigationProvider - Navigation permission context
- * - NavigationGuard - Individual navigation item protection
- * - RBAC types - Type definitions
- */
-
-import React, { useMemo, useCallback, useEffect, useState } from 'react';
-import { useNavigationPermissions, NavigationItem } from './NavigationProvider';
-import NavigationGuard from './NavigationGuard';
-import { getRBACLogger } from '../config';
-
-export interface EnhancedNavigationMenuProps {
-  /** Navigation items to display */
-  items: NavigationItem[];
-  
-  /** Enable strict mode to prevent bypassing (default: true) */
-  strictMode?: boolean;
-  
-  /** Enable audit logging (default: true) */
-  auditLog?: boolean;
-  
-  /** Callback when navigation access is attempted */
-  onNavigationAccess?: (item: NavigationItem, allowed: boolean) => void;
-  
-  /** Callback when strict mode violation occurs */
-  onStrictModeViolation?: (item: NavigationItem) => void;
-  
-  /** Custom className for the navigation menu */
-  className?: string;
-  
-  /** Custom className for navigation items */
-  itemClassName?: string;
-  
-  /** Custom className for active navigation items */
-  activeItemClassName?: string;
-  
-  /** Custom className for disabled navigation items */
-  disabledItemClassName?: string;
-  
-  /** Show/hide navigation items that user doesn't have permission for */
-  hideUnauthorizedItems?: boolean;
-  
-  /** Custom render function for navigation items */
-  renderItem?: (item: NavigationItem, isAuthorized: boolean) => React.ReactNode;
-  
-  /** Current active path for highlighting */
-  activePath?: string;
-  
-  /** Navigation item click handler */
-  onItemClick?: (item: NavigationItem) => void;
-}
-
-/**
- * EnhancedNavigationMenu - Secure navigation menu with RBAC integration
- * 
- * This component provides a navigation menu that automatically filters items based on
- * user permissions and enforces strict security controls.
- * 
- * @param props - Component props
- * @returns React element with enhanced navigation menu
- */
-export function EnhancedNavigationMenu({
-  items,
-  strictMode = true,
-  auditLog = true,
-  onNavigationAccess,
-  onStrictModeViolation,
-  className = 'flex flex-col space-y-1',
-  itemClassName = 'px-3 py-2 rounded-md text-sm font-medium transition-colors',
-  activeItemClassName = 'bg-main-100 text-main-700',
-  disabledItemClassName = 'text-sec-400 cursor-not-allowed',
-  hideUnauthorizedItems = false,
-  renderItem,
-  activePath,
-  onItemClick
-}: EnhancedNavigationMenuProps) {
-  const { 
-    hasNavigationPermission, 
-    getFilteredNavigationItems,
-    isEnabled,
-    isStrictMode,
-    isAuditLogEnabled 
-  } = useNavigationPermissions();
-  
-  const [navigationHistory, setNavigationHistory] = useState<NavigationItem[]>([]);
-
-  // Get filtered navigation items based on permissions
-  const filteredItems = useMemo((): NavigationItem[] => {
-    if (!isEnabled) return items;
-    
-    return getFilteredNavigationItems(items);
-  }, [isEnabled, items, getFilteredNavigationItems]);
-
-  // Handle navigation access attempt
-  const handleNavigationAccess = useCallback((item: NavigationItem, allowed: boolean) => {
-    if (onNavigationAccess) {
-      onNavigationAccess(item, allowed);
-    }
-    
-    if (auditLog) {
-      const logger = getRBACLogger();
-      logger.debug('Navigation access attempt:', {
-        item: item.id,
-        allowed,
-        strictMode,
-        timestamp: new Date().toISOString()
-      });
-    }
-  }, [onNavigationAccess, auditLog, strictMode]);
-
-  // Handle strict mode violation
-  const handleStrictModeViolation = useCallback((item: NavigationItem) => {
-    if (onStrictModeViolation) {
-      onStrictModeViolation(item);
-    }
-    
-    if (strictMode) {
-      const logger = getRBACLogger();
-      logger.error(`STRICT MODE VIOLATION: User attempted to access protected navigation item without permission`, {
-        item: item.id,
-        path: item.path,
-        permissions: item.permissions,
-        timestamp: new Date().toISOString()
-      });
-    }
-  }, [onStrictModeViolation, strictMode]);
-
-  // Handle navigation item click
-  const handleItemClick = useCallback((item: NavigationItem) => {
-    // Check if user has permission for this item
-    const isAuthorized = hasNavigationPermission(item);
-    
-    // Call navigation access handler
-    handleNavigationAccess(item, isAuthorized);
-    
-    if (onItemClick) {
-      onItemClick(item);
-    }
-    
-    // Record navigation attempt
-    if (auditLog) {
-      // Navigation item clicked logged
-    }
-    
-    // Add to navigation history
-    setNavigationHistory(prev => {
-      const newHistory = [item, ...prev.filter(i => i.id !== item.id)];
-      return newHistory.slice(0, 10); // Keep last 10 items
-    });
-  }, [onItemClick, auditLog, hasNavigationPermission, handleNavigationAccess]);
-
-  // Default render function for navigation items
-  const defaultRenderItem = useCallback((item: NavigationItem, isAuthorized: boolean) => {
-    const isActive = activePath === item.path;
-    const isDisabled = !isAuthorized;
-    
-    return (
-      <NavigationGuard
-        key={item.id}
-        navigationItem={item}
-        strictMode={strictMode}
-        auditLog={auditLog}
-        onDenied={handleStrictModeViolation}
-        fallback={
-          hideUnauthorizedItems ? null : (
-            <div className={`${itemClassName} ${disabledItemClassName}`}>
-              <div className="flex items-center space-x-2">
-                {item.meta?.icon && (
-                  <span className="text-sm">{item.meta.icon}</span>
-                )}
-                <span>{item.label}</span>
-                <span className="text-xs text-sec-400">(Access Denied)</span>
-              </div>
-            </div>
-          )
-        }
-      >
-        <button
-          onClick={() => handleItemClick(item)}
-          className={`${itemClassName} ${
-            isActive ? activeItemClassName : ''
-          } ${
-            isDisabled ? disabledItemClassName : 'hover:bg-sec-100'
-          }`}
-          disabled={isDisabled}
-        >
-          <div className="flex items-center space-x-2">
-            {item.meta?.icon && (
-              <span className="text-sm">{item.meta.icon}</span>
-            )}
-            <span>{item.label}</span>
-            {item.meta?.description && (
-              <span className="text-xs text-sec-500 ml-auto">
-                {item.meta.description}
-              </span>
-            )}
-          </div>
-        </button>
-      </NavigationGuard>
-    );
-  }, [
-    activePath,
-    itemClassName,
-    activeItemClassName,
-    disabledItemClassName,
-    hideUnauthorizedItems,
-    strictMode,
-    auditLog,
-    handleStrictModeViolation,
-    handleItemClick
-  ]);
-
-  // Log strict mode violations
-  useEffect(() => {
-    if (strictMode && auditLog) {
-      const logger = getRBACLogger();
-    }
-  }, [strictMode, auditLog]);
-
-  // Log navigation menu initialization
-  useEffect(() => {
-    if (auditLog) {
-      // Navigation menu initialized
-    }
-  }, [items.length, filteredItems.length, strictMode, auditLog]);
-
-  return (
-    <nav className={className}>
-      {filteredItems.map(item => {
-        const isAuthorized = hasNavigationPermission(item);
-        
-        if (renderItem) {
-          return renderItem(item, isAuthorized);
-        }
-        
-        return defaultRenderItem(item, isAuthorized);
-      })}
-    </nav>
-  );
-}
-
-export default EnhancedNavigationMenu;