@jmruthers/pace-core 0.5.87 → 0.5.88

package/dist/chunk-WUXCWRL6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/file-reference.ts"],"sourcesContent":["// File Reference System Types\n// These types define the structure for the centralized file reference system\n\nexport interface FileReference {\n  id: string;\n  table_name: string;\n  record_id: string;\n  file_path: string;\n  file_metadata: FileMetadata;\n  organisation_id: string;\n  app_id: string;\n  is_public: boolean;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface FileMetadata {\n  fileName: string;\n  fileType: string;\n  fileSize?: number;\n  width?: number;\n  height?: number;\n  category: FileCategory;\n  hash?: string;\n  uploadedBy?: string;\n  uploadedAt?: string;\n  tags?: string[];\n  customMetadata?: Record<string, any>;\n}\n\nexport enum FileCategory {\n  PROFILE_PHOTOS = 'profile_photos',\n  ID_DOCUMENTS = 'id_documents',\n  QUALIFICATIONS = 'qualifications',\n  MEDICAL_DOCUMENTS = 'medical_documents',\n  DISH_IMAGES = 'dish_images',\n  EVENT_LOGOS = 'event_logos',\n  GENERAL_DOCUMENTS = 'general_documents',\n  IMAGES = 'images',\n  AUDIO = 'audio',\n  VIDEO = 'video',\n  ARCHIVES = 'archives'\n}\n\nexport interface FileUploadOptions {\n  table_name: string;\n  record_id: string;\n  organisation_id: string;\n  app_id: string;\n  category: FileCategory;\n  is_public?: boolean;\n  custom_metadata?: Record<string, any>;\n}\n\nexport interface FileReferenceService {\n  createFileReference(options: FileUploadOptions, file: File): Promise<FileReference>;\n  getFileReference(table_name: string, record_id: string, organisation_id: string): Promise<FileReference | null>;\n  getFileUrl(table_name: string, record_id: string, organisation_id: string): Promise<string | null>;\n  getSignedUrl(table_name: string, record_id: string, organisation_id: string, expires_in?: number): Promise<string | null>;\n  updateFileReference(id: string, updates: Partial<FileReference>): Promise<FileReference>;\n  deleteFileReference(table_name: string, record_id: string, organisation_id: string, delete_file?: boolean): Promise<boolean>;\n  listFileReferences(table_name: string, record_id: string, organisation_id: string): Promise<FileReference[]>;\n  getFileCount(table_name: string, record_id: string, organisation_id: string): Promise<number>;\n}\n\nexport interface StorageUploadOptions {\n  orgId: string;\n  category: FileCategory;\n  isPublic?: boolean;\n  customPath?: string;\n}\n\nexport interface FileUploadResult {\n  file_reference: FileReference;\n  file_url: string;\n  signed_url?: string;\n}\n"],"mappings":";AA8BO,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,kBAAe;AACf,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,uBAAoB;AACpB,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,uBAAoB;AACpB,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,cAAW;AAXD,SAAAA;AAAA,GAAA;","names":["FileCategory"]}

package/dist/chunk-ZFLOV3OM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/OrganisationProvider.tsx","../src/components/PublicLayout/PublicErrorBoundary.tsx","../src/components/PublicLayout/PublicPageProvider.tsx","../src/hooks/useAppConfig.ts","../src/hooks/public/usePublicEventLogo.ts"],"sourcesContent":["/**\n * @file Re-export for OrganisationProvider\n * @package @jmruthers/pace-core\n * @module Providers\n * @since 0.1.0\n * \n * Re-exports the service-based OrganisationProvider for backward compatibility.\n */\n\nexport { OrganisationServiceProvider as OrganisationProvider } from './services/OrganisationServiceProvider';\nexport type { OrganisationServiceProviderProps as OrganisationProviderProps } from './services/OrganisationServiceProvider';\n\n// Re-export context and hook\nexport { OrganisationServiceContext, useOrganisationService } from './services/OrganisationServiceProvider';\nexport type { OrganisationServiceContextType } from './services/OrganisationServiceProvider';\n\n// Re-export convenience hook for backward compatibility\nexport { useOrganisations } from '../hooks/useOrganisations';\n\n","/**\n * @file Public Error Boundary Component\n * @package @jmruthers/pace-core\n * @module Components/PublicLayout\n * @since 1.0.0\n *\n * An error boundary component specifically designed for public pages.\n * Provides graceful error handling and recovery for public content.\n *\n * Features:\n * - Graceful error handling\n * - User-friendly error messages\n * - Recovery mechanisms\n * - Accessibility compliant\n * - TypeScript support\n *\n * @example\n * ```tsx\n * import { PublicErrorBoundary } from '@jmruthers/pace-core';\n *\n * function PublicEventPage() {\n *   return (\n *     <PublicErrorBoundary>\n *       <PublicPageContent />\n *     </PublicErrorBoundary>\n *   );\n * }\n * ```\n *\n * @accessibility\n * - WCAG 2.1 AA compliant\n * - Screen reader friendly error messages\n * - Keyboard accessible recovery actions\n * - High contrast support\n *\n * @dependencies\n * - React 18+ - Component framework\n * - Error boundary patterns\n * - Tailwind CSS - Styling\n */\n\nimport React, { Component, ErrorInfo, ReactNode } from 'react';\n\nexport interface PublicErrorBoundaryProps {\n  /** Child components to wrap */\n  children: ReactNode;\n  /** Custom error fallback component */\n  fallback?: React.ComponentType<PublicErrorBoundaryState>;\n  /** Custom CSS classes for error display */\n  className?: string;\n  /** Whether to show error details in development */\n  showErrorDetails?: boolean;\n  /** Custom error message */\n  customErrorMessage?: string;\n  /** Custom recovery action */\n  onRecover?: () => void;\n}\n\nexport interface PublicErrorBoundaryState {\n  /** Whether an error has occurred */\n  hasError: boolean;\n  /** The error that occurred */\n  error: Error | null;\n  /** Error information */\n  errorInfo: ErrorInfo | null;\n  /** Function to reset the error state */\n  resetError: () => void;\n}\n\n/**\n * Error boundary component for public pages\n * \n * This component catches JavaScript errors anywhere in the child component tree,\n * logs those errors, and displays a fallback UI instead of the component tree that crashed.\n * \n * @param props - Error boundary configuration\n * @returns React element with error boundary wrapper\n */\nexport class PublicErrorBoundary extends Component<PublicErrorBoundaryProps, PublicErrorBoundaryState> {\n  constructor(props: PublicErrorBoundaryProps) {\n    super(props);\n    this.state = {\n      hasError: false,\n      error: null,\n      errorInfo: null,\n      resetError: this.resetError.bind(this)\n    };\n  }\n\n  static getDerivedStateFromError(error: Error): Partial<PublicErrorBoundaryState> {\n    // Update state so the next render will show the fallback UI\n    return {\n      hasError: true,\n      error\n    };\n  }\n\n  componentDidCatch(error: Error, errorInfo: ErrorInfo) {\n    // Log the error to console in development\n    if (import.meta.env.MODE === 'development') {\n      console.error('PublicErrorBoundary caught an error:', error, errorInfo);\n    }\n\n    // Update state with error info\n    this.setState({\n      error,\n      errorInfo\n    });\n\n    // You can also log the error to an error reporting service here\n    // Example: logErrorToService(error, errorInfo);\n  }\n\n  resetError = () => {\n    this.setState({\n      hasError: false,\n      error: null,\n      errorInfo: null\n    });\n  };\n\n  render() {\n    if (this.state.hasError) {\n      // Custom fallback component\n      if (this.props.fallback) {\n        return <this.props.fallback {...this.state} />;\n      }\n\n      // Default error UI\n      return (\n        <div className={`min-h-screen bg-white flex items-center justify-center ${this.props.className || ''}`}>\n          <div className=\"max-w-md mx-auto text-center px-4\">\n            <div className=\"mb-6\">\n              <div className=\"mx-auto flex items-center justify-center h-12 w-12 rounded-full bg-red-100 mb-4\">\n                <svg\n                  className=\"h-6 w-6 text-red-600\"\n                  fill=\"none\"\n                  viewBox=\"0 0 24 24\"\n                  stroke=\"currentColor\"\n                >\n                  <path\n                    strokeLinecap=\"round\"\n                    strokeLinejoin=\"round\"\n                    strokeWidth={2}\n                    d=\"M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L3.732 16.5c-.77.833.192 2.5 1.732 2.5z\"\n                  />\n                </svg>\n              </div>\n              <h1 className=\"text-2xl font-bold text-gray-900 mb-2\">\n                Something went wrong\n              </h1>\n              <p className=\"text-gray-600 mb-6\">\n                {this.props.customErrorMessage || \n                  'We encountered an error while loading this page. Please try again.'}\n              </p>\n            </div>\n\n            {/* Error details in development */}\n            {this.props.showErrorDetails && this.state.error && (\n              <div className=\"mb-6 p-4 bg-red-50 border border-red-200 rounded-md text-left\">\n                <h3 className=\"text-sm font-medium text-red-800 mb-2\">\n                  Error Details (Development Only)\n                </h3>\n                <pre className=\"text-xs text-red-700 whitespace-pre-wrap\">\n                  {this.state.error.toString()}\n                  {this.state.errorInfo?.componentStack}\n                </pre>\n              </div>\n            )}\n\n            {/* Recovery actions */}\n            <div className=\"space-y-3\">\n              <button\n                onClick={this.resetError}\n                className=\"w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 transition-colors focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2\"\n              >\n                Try Again\n              </button>\n              \n              <button\n                onClick={() => window.location.reload()}\n                className=\"w-full px-4 py-2 bg-gray-600 text-white rounded-md hover:bg-gray-700 transition-colors focus:outline-none focus:ring-2 focus:ring-gray-500 focus:ring-offset-2\"\n              >\n                Reload Page\n              </button>\n\n              {this.props.onRecover && (\n                <button\n                  onClick={this.props.onRecover}\n                  className=\"w-full px-4 py-2 bg-green-600 text-white rounded-md hover:bg-green-700 transition-colors focus:outline-none focus:ring-2 focus:ring-green-500 focus:ring-offset-2\"\n                >\n                  Alternative Action\n                </button>\n              )}\n            </div>\n\n            {/* Help text */}\n            <div className=\"mt-6 text-sm text-gray-500\">\n              <p>\n                If this problem persists, please contact support or try accessing the page later.\n              </p>\n            </div>\n          </div>\n        </div>\n      );\n    }\n\n    return this.props.children;\n  }\n}\n\n/**\n * Hook for accessing error boundary state\n * Useful for components that need to know if they're inside an error boundary\n */\nexport function useErrorBoundary() {\n  const [error, setError] = React.useState<Error | null>(null);\n\n  const resetError = React.useCallback(() => {\n    setError(null);\n  }, []);\n\n  const captureError = React.useCallback((error: Error) => {\n    setError(error);\n  }, []);\n\n  // Throw error synchronously during render so error boundary can catch it\n  if (error) {\n    throw error;\n  }\n\n  return { captureError, resetError };\n}\n\n/**\n * Default error fallback component\n */\nexport function DefaultPublicErrorFallback({ \n  error, \n  resetError \n}: PublicErrorBoundaryState) {\n  return (\n    <div className=\"min-h-screen bg-white flex items-center justify-center\">\n      <div className=\"max-w-md mx-auto text-center px-4\">\n        <div className=\"mb-6\">\n          <div className=\"mx-auto flex items-center justify-center h-12 w-12 rounded-full bg-red-100 mb-4\">\n            <svg\n              className=\"h-6 w-6 text-red-600\"\n              fill=\"none\"\n              viewBox=\"0 0 24 24\"\n              stroke=\"currentColor\"\n            >\n              <path\n                strokeLinecap=\"round\"\n                strokeLinejoin=\"round\"\n                strokeWidth={2}\n                d=\"M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L3.732 16.5c-.77.833.192 2.5 1.732 2.5z\"\n              />\n            </svg>\n          </div>\n          <h1 className=\"text-2xl font-bold text-gray-900 mb-2\">\n            Page Error\n          </h1>\n          <p className=\"text-gray-600 mb-6\">\n            We encountered an error while loading this page.\n          </p>\n        </div>\n\n        <button\n          onClick={resetError}\n          className=\"w-full px-4 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 transition-colors focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2\"\n        >\n          Try Again\n        </button>\n      </div>\n    </div>\n  );\n}\n","/**\n * @file Public Page Provider\n * @package @jmruthers/pace-core\n * @module Components/PublicLayout\n * @since 1.0.0\n *\n * A completely isolated provider for public pages that doesn't trigger\n * any authentication context. This ensures public pages work independently\n * of the main application's authentication system.\n *\n * Features:\n * - No authentication required\n * - No organisation context\n * - No event context\n * - Completely isolated from main app context\n * - Environment variable access for public data\n * - Error boundary integration\n *\n * @example\n * ```tsx\n * import { PublicPageProvider } from '@jmruthers/pace-core';\n * \n * function PublicApp() {\n *   return (\n *     <PublicPageProvider>\n *       <Routes>\n *         <Route path=\"/events/:eventCode/recipe-grid-report\" element={<PublicRecipePage />} />\n *       </Routes>\n *     </PublicPageProvider>\n *   );\n * }\n * ```\n */\n\nimport React, { createContext, useContext, ReactNode, useMemo } from 'react';\nimport { createClient } from '@supabase/supabase-js';\nimport type { Database } from '../../types/database';\nimport { PublicErrorBoundary } from './PublicErrorBoundary';\n\ninterface PublicPageContextType {\n  isPublicPage: true;\n  supabase: ReturnType<typeof createClient<Database>> | null;\n  environment: {\n    supabaseUrl: string | null;\n    supabaseKey: string | null;\n  };\n}\n\nexport const PublicPageContext = createContext<PublicPageContextType | undefined>(undefined);\n\nexport interface PublicPageProviderProps {\n  children: ReactNode;\n}\n\n/**\n * Provider for public pages that completely isolates them from authentication context\n * \n * This provider:\n * - Does not initialize any authentication providers\n * - Provides environment variables for public data access\n * - Includes error boundary for graceful error handling\n * - Is completely separate from the main app context\n */\nexport function PublicPageProvider({ children }: PublicPageProviderProps) {\n  // Get environment variables for public data access\n  // Handle both Vite (import.meta.env) and Node.js (process.env) environments\n  const getEnvVar = (key: string): string | undefined => {\n    // Check Vite environment first (browser)\n    if (typeof import.meta !== 'undefined' && (import.meta as any).env) {\n      return (import.meta as any).env[key];\n    }\n    // Check Node.js environment (server-side)\n    if (typeof import.meta !== 'undefined' && import.meta.env) {\n      return import.meta.env[key];\n    }\n    return undefined;\n  };\n\n  const supabaseUrl = getEnvVar('VITE_SUPABASE_URL') || \n                     getEnvVar('NEXT_PUBLIC_SUPABASE_URL') || \n                     null;\n                     \n  const supabaseKey = getEnvVar('VITE_SUPABASE_ANON_KEY') || \n                     getEnvVar('NEXT_PUBLIC_SUPABASE_ANON_KEY') || \n                     null;\n\n  // Create Supabase client if environment variables are available\n  const supabase = useMemo(() => {\n    if (!supabaseUrl || !supabaseKey) {\n      console.warn('[PublicPageProvider] Missing Supabase environment variables. Please ensure VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY are set in your environment.');\n      return null;\n    }\n    return createClient<Database>(supabaseUrl, supabaseKey);\n  }, [supabaseUrl, supabaseKey]);\n\n  const contextValue: PublicPageContextType = {\n    isPublicPage: true,\n    supabase,\n    environment: {\n      supabaseUrl,\n      supabaseKey\n    }\n  };\n\n  return (\n    <PublicPageContext.Provider value={contextValue}>\n      <PublicErrorBoundary>\n        {children}\n      </PublicErrorBoundary>\n    </PublicPageContext.Provider>\n  );\n}\n\n/**\n * Hook to access public page context\n * \n * @returns Public page context with environment variables\n */\nexport function usePublicPageContext(): PublicPageContextType {\n  const context = useContext(PublicPageContext);\n  \n  if (!context) {\n    throw new Error('usePublicPageContext must be used within a PublicPageProvider');\n  }\n  \n  return context;\n}\n\n/**\n * Hook to check if we're in a public page context\n * \n * @returns True if we're in a public page context\n */\nexport function useIsPublicPage(): boolean {\n  const context = useContext(PublicPageContext);\n  return context !== undefined;\n}\n","/**\n * @file useAppConfig Hook\n * @package @jmruthers/pace-core\n * @module Hooks/useAppConfig\n * @since 0.4.0\n *\n * Hook for accessing app configuration like direct access support and event requirements.\n * This is a convenience hook that extracts app config from the UnifiedAuthProvider.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { supportsDirectAccess, requiresEvent, isLoading } = useAppConfig();\n *   \n *   if (isLoading) return <div>Loading...</div>;\n *   \n *   return (\n *     <div>\n *       {supportsDirectAccess && (\n *         <div>This app supports direct access!</div>\n *       )}\n *       {requiresEvent && (\n *         <EventSelector />\n *       )}\n *     </div>\n *   );\n * }\n * ```\n */\n\nimport { useMemo } from 'react';\nimport { useUnifiedAuth } from '../providers/UnifiedAuthProvider';\nimport { useIsPublicPage } from '../components/PublicLayout/PublicPageProvider';\n\nexport interface UseAppConfigReturn {\n  supportsDirectAccess: boolean;\n  requiresEvent: boolean;\n  isLoading: boolean;\n  appName: string;\n}\n\n/**\n * Hook to access app configuration\n * Works in both authenticated and public contexts\n * @returns App configuration and loading state\n */\nexport function useAppConfig(): UseAppConfigReturn {\n  // Check if we're in a public page context first\n  const isPublicPage = useIsPublicPage();\n  \n  if (isPublicPage) {\n    // For public pages, try to get app name from environment variables\n    const getAppName = (): string => {\n      // Check Vite environment first (browser)\n      if (typeof import.meta !== 'undefined' && (import.meta as any).env) {\n        return (import.meta as any).env.VITE_APP_NAME || \n               (import.meta as any).env.NEXT_PUBLIC_APP_NAME || \n               'PACE';\n      }\n      // Check Node.js environment (server-side)\n      if (typeof import.meta !== 'undefined' && import.meta.env) {\n        return import.meta.env.VITE_APP_NAME || \n               import.meta.env.NEXT_PUBLIC_APP_NAME || \n               'PACE';\n      }\n      return 'PACE';\n    };\n    \n    return useMemo(() => ({\n      supportsDirectAccess: false, // Public pages don't support direct access\n      requiresEvent: true, // Public pages always require an event\n      isLoading: false,\n      appName: getAppName()\n    }), []);\n  }\n  \n  // For authenticated pages, use UnifiedAuthProvider\n  try {\n    const { appConfig, appName } = useUnifiedAuth();\n    return useMemo(() => ({\n      supportsDirectAccess: !(appConfig?.requires_event ?? true),\n      requiresEvent: appConfig?.requires_event ?? true,\n      isLoading: appConfig === null,\n      appName\n    }), [appConfig?.requires_event, appName]);\n  } catch (error) {\n    // Fallback if UnifiedAuthProvider is not available\n    return useMemo(() => ({\n      supportsDirectAccess: false,\n      requiresEvent: true,\n      isLoading: false,\n      appName: 'PACE'\n    }), []);\n  }\n} ","/**\n * @file Public Event Logo Hook\n * @package @jmruthers/pace-core\n * @module Hooks/Public\n * @since 1.0.0\n *\n * A React hook for accessing public event logo URLs without authentication.\n * Provides logo URLs with fallback handling for public pages.\n *\n * Features:\n * - No authentication required\n * - Automatic fallback to event initials\n * - Caching for performance\n * - Error handling and loading states\n * - TypeScript support\n * - Image validation\n *\n * @example\n * ```tsx\n * import { usePublicEventLogo } from '@jmruthers/pace-core';\n *\n * function EventHeader() {\n *   const { logoUrl, fallbackText, isLoading, error } = usePublicEventLogo(\n *     eventId, \n *     eventName, \n *     organisationId\n *   );\n *\n *   if (isLoading) return <div>Loading logo...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return (\n *     <div>\n *       {logoUrl ? (\n *         <img src={logoUrl} alt={`${eventName} logo`} />\n *       ) : (\n *         <div className=\"logo-fallback\">{fallbackText}</div>\n *       )}\n *     </div>\n *   );\n * }\n * ```\n *\n * @accessibility\n * - No direct accessibility concerns (hook)\n * - Enables accessible logo display with proper alt text\n * - Supports screen reader friendly fallbacks\n *\n * @security\n * - Only returns public-safe logo URLs\n * - Validates image existence before returning URL\n * - No sensitive information exposed\n * - Rate limiting applied at storage level\n *\n * @performance\n * - Built-in caching with TTL\n * - Image validation and optimization\n * - Minimal re-renders with stable references\n * - Lazy loading support\n *\n * @dependencies\n * - React 18+ - Hooks and effects\n * - @supabase/supabase-js - Storage integration\n * - Event types - Type definitions\n */\n\nimport { useState, useEffect, useCallback, useMemo } from 'react';\nimport type { SupabaseClient } from '@supabase/supabase-js';\nimport type { Database } from '../../types/database';\n\n// Simple in-memory cache for public data\nconst publicDataCache = new Map<string, { data: any; timestamp: number; ttl: number }>();\n\nexport interface UsePublicEventLogoReturn {\n  /** The logo URL if available, null if not found or error */\n  logoUrl: string | null;\n  /** Fallback text (event initials) if no logo is available */\n  fallbackText: string;\n  /** Whether the logo is currently loading */\n  isLoading: boolean;\n  /** Any error that occurred during loading */\n  error: Error | null;\n  /** Function to manually refetch the logo */\n  refetch: () => Promise<void>;\n}\n\nexport interface UsePublicEventLogoOptions {\n  /** Cache TTL in milliseconds (default: 30 minutes) */\n  cacheTtl?: number;\n  /** Whether to enable caching (default: true) */\n  enableCache?: boolean;\n  /** Whether to validate image existence (default: true) */\n  validateImage?: boolean;\n  /** Custom fallback text generator */\n  generateFallbackText?: (eventName: string) => string;\n  /** Supabase client instance (required) */\n  supabase: SupabaseClient<Database>;\n}\n\n/**\n * Generate fallback text from event name (first letter of each word)\n */\nfunction defaultGenerateFallbackText(eventName: string): string {\n  if (!eventName) return 'EV';\n  \n  return eventName\n    .split(' ')\n    .map(word => word.charAt(0).toUpperCase())\n    .join('')\n    .substring(0, 3); // Max 3 characters\n}\n\n/**\n * Hook for accessing public event logo URLs\n * \n * This hook provides access to event logo URLs without requiring\n * authentication. It includes fallback handling and image validation.\n * \n * @param eventId - The event ID to fetch logo for\n * @param eventName - The event name for fallback text generation\n * @param organisationId - The organisation ID for storage path\n * @param options - Configuration options for caching and behavior\n * @returns Object containing logo URL, fallback text, loading state, error, and refetch function\n */\nexport function usePublicEventLogo(\n  eventId: string | undefined,\n  eventName: string | undefined,\n  organisationId: string | undefined,\n  options: UsePublicEventLogoOptions\n): UsePublicEventLogoReturn {\n  const {\n    cacheTtl = 30 * 60 * 1000, // 30 minutes\n    enableCache = true,\n    validateImage = true,\n    generateFallbackText = defaultGenerateFallbackText,\n    supabase\n  } = options;\n\n  const [logoUrl, setLogoUrl] = useState<string | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Generate fallback text\n  const fallbackText = useMemo(() => {\n    return eventName ? generateFallbackText(eventName) : 'EV';\n  }, [eventName, generateFallbackText]);\n\n  const fetchLogo = useCallback(async (): Promise<void> => {\n    if (!eventId || !organisationId || !supabase) {\n      setLogoUrl(null);\n      setIsLoading(false);\n      return;\n    }\n\n    // Validate UUID format for organisationId to prevent database errors\n    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n    if (!uuidRegex.test(organisationId)) {\n      console.warn('[usePublicEventLogo] Invalid organisationId format (not a valid UUID):', organisationId);\n      // Don't return early - let the database handle the validation\n      // This allows for more graceful error handling\n    }\n\n    // Check cache first\n    const cacheKey = `public_logo_${eventId}_${organisationId}`;\n    if (enableCache) {\n      const cached = publicDataCache.get(cacheKey);\n      if (cached && Date.now() - cached.timestamp < cached.ttl) {\n        setLogoUrl(cached.data);\n        setIsLoading(false);\n        setError(null);\n        return;\n      }\n    }\n\n    try {\n      setIsLoading(true);\n      setError(null);\n\n      // Call the public logo RPC function\n      const { data, error: rpcError } = await (supabase as any).rpc('get_public_event_logo', {\n        event_id_param: eventId,\n        organisation_id_param: organisationId\n      });\n\n      if (rpcError) {\n        throw new Error(rpcError.message || 'Failed to fetch logo');\n      }\n\n      if (!data || data.length === 0 || !data[0] || !data[0].logo_url) {\n        setLogoUrl(null);\n        return;\n      }\n\n      // Get the file path from the RPC function (it returns file_path as logo_url)\n      const logoPath = data[0].logo_url;\n\n      // Construct the full public URL using Supabase client's storage API\n      const { data: urlData } = supabase.storage\n        .from('public-files')\n        .getPublicUrl(logoPath);\n\n      if (!urlData?.publicUrl) {\n        console.warn('[usePublicEventLogo] Failed to construct public URL for path:', logoPath);\n        setLogoUrl(null);\n        return;\n      }\n\n      const logoUrl = urlData.publicUrl;\n\n      // Validate image existence if requested\n      if (validateImage) {\n        try {\n          const response = await fetch(logoUrl, { method: 'HEAD' });\n          if (!response.ok) {\n            console.warn('[usePublicEventLogo] Logo URL not accessible:', logoUrl);\n            setLogoUrl(null);\n            return;\n          }\n        } catch (fetchError) {\n          console.warn('[usePublicEventLogo] Error validating logo URL:', fetchError);\n          setLogoUrl(null);\n          return;\n        }\n      }\n\n      setLogoUrl(logoUrl);\n\n      // Cache the result\n      if (enableCache) {\n        publicDataCache.set(cacheKey, {\n          data: logoUrl,\n          timestamp: Date.now(),\n          ttl: cacheTtl\n        });\n      }\n\n    } catch (err) {\n      console.error('[usePublicEventLogo] Error fetching logo:', err);\n      const error = err instanceof Error ? err : new Error('Unknown error occurred');\n      setError(error);\n      setLogoUrl(null);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [eventId, organisationId, supabase, cacheTtl, enableCache, validateImage]);\n\n  // Fetch logo when parameters change\n  useEffect(() => {\n    if (eventId && organisationId) {\n      fetchLogo();\n    } else {\n      setLogoUrl(null);\n      setIsLoading(false);\n      setError(null);\n    }\n  }, [fetchLogo, eventId, organisationId]);\n\n  const refetch = useCallback(async (): Promise<void> => {\n    if (!eventId || !organisationId) return;\n    \n    // Clear cache for this logo\n    if (enableCache) {\n      const cacheKey = `public_logo_${eventId}_${organisationId}`;\n      publicDataCache.delete(cacheKey);\n    }\n    await fetchLogo();\n  }, [fetchLogo, eventId, organisationId, enableCache]);\n\n  return {\n    logoUrl,\n    fallbackText,\n    isLoading,\n    error,\n    refetch\n  };\n}\n\n/**\n * Clear all cached public logo data\n * Useful for testing or when you need to force refresh all data\n */\nexport function clearPublicLogoCache(): void {\n  for (const [key] of publicDataCache) {\n    if (key.startsWith('public_logo_')) {\n      publicDataCache.delete(key);\n    }\n  }\n}\n\n/**\n * Get cache statistics for debugging\n */\nexport function getPublicLogoCacheStats(): { size: number; keys: string[] } {\n  const keys = Array.from(publicDataCache.keys()).filter(key => key.startsWith('public_logo_'));\n  return {\n    size: keys.length,\n    keys\n  };\n}\n"],"mappings":"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","names":["error","jsx","useMemo","useMemo","useMemo","logoUrl","error"]}

package/docs/CONTENT_AUDIT_REPORT.md

@@ -1,253 +0,0 @@
----
-lastUpdated: 2025-10-29T22:43:00+11:00
-version: 0.5.76
-reviewedBy: content-audit
----
-
-# 📋 PACE Core Content Audit Report
-
-> **🔍 Comprehensive Content Analysis** | [← Back to Documentation](./README.md) | [Style Guide Compliance](./DOCUMENTATION_AUDIT.md)
-
-This report provides a comprehensive analysis of PACE Core documentation content accuracy, completeness, and freshness.
-
----
-
-## 🎯 Executive Summary
-
-| Metric | Status | Count | Percentage |
-|--------|--------|--------|------------|
-| **Exported Features Documented** | ✅ Excellent | 65/67 | 97% |
-| **Documentation Accuracy** | ✅ Accurate | 95/95 | 100% |
-| **Duplicate Content** | ✅ Fully Consolidated | Single authoritative guide | Complete |
-| **Last Updated Tracking** | ✅ Complete | 95/95 | 100% |
-| **Overall Content Health** | ✅ **Excellent** | | |
-
----
-
-## 📊 Detailed Analysis
-
-### 1. Missing Documentation (2 Missing Features) ⬆️ Improved from 22
-
-#### 🚨 **Critical Missing Components**
-| Component | Export Status | Documentation Status | Priority |
-|-----------|---------------|----------------------|----------|
-| ~~`Avatar`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`Switch`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`Progress`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`Table` (Basic)~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`TableHeader`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`TableBody`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`TableCell`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`TableFooter`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`TableHead`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`TableRow`~~ | ✅ Exported | ✅ **Documented** | High |
-
-#### 🔧 **Missing Utilities**
-| Utility | Export Status | Documentation Status | Priority |
-|---------|---------------|----------------------|----------|
-| ~~`cn`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`setAppConfig`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`getAppConfig`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`getCurrentAppName`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`getCurrentAppId`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`formatCurrency`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`formatNumber`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`formatPercent`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`formatCompactNumber`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`formatFileSize`~~ | ✅ Exported | ✅ **Documented** | Medium |
-
-#### 🔗 **Missing Hooks**
-| Hook | Export Status | Documentation Status | Priority |
-|------|---------------|----------------------|----------|
-| ~~`useFocusManagement`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useFocusTrap`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useKeyboardShortcuts`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useIsMobile`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useDebounce`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useDataTableState`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useZodForm`~~ | ✅ Exported | ✅ **Documented** | Medium |
-| ~~`useComponentPerformance`~~ | ✅ Exported | ✅ **Documented** | Low |
-| ~~`usePerformanceMonitor`~~ | ✅ Exported | ✅ **Documented** | Low |
-| ~~`useDataTablePerformance`~~ | ✅ Exported | ✅ **Documented** | Low |
-
-#### 🏗️ **Missing Providers**
-| Provider | Export Status | Documentation Status | Priority |
-|----------|---------------|----------------------|----------|
-| ~~`EventProvider`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`OrganisationProvider`~~ | ✅ Exported | ✅ **Documented** | High |
-| ~~`InactivityProvider`~~ | ✅ Exported | ✅ **Documented** | High |
-
----
-
-### 2. Duplicate Content Analysis
-
-#### 🔄 **Identified Duplicates**
-
-| Content Area | Files | Duplication Level | Action Required |
-|--------------|-------|------------------|-----------------|
-| **DataTable Usage** | 8 files | ✅ Consolidated | Cross-referenced |
-| **Authentication Setup** | 6 files | ✅ Fully Consolidated | Single authoritative guide |
-| **RBAC Implementation** | 5 files | Medium | Consolidate RBAC patterns |
-| **Migration Instructions** | 4 files | ✅ Fully Consolidated | Single authoritative guide |
-| **Quick Start Examples** | 3 files | ✅ Fully Consolidated | Single authoritative guide |
-| **Performance Tips** | 3 files | ✅ Fully Consolidated | Single authoritative guide |
-| **Troubleshooting** | 3 files | ✅ Fully Consolidated | Single authoritative guide |
-| **Styling Guide** | 2 files | Low | Cross-reference instead |
-
-#### 📝 **Specific Duplicate Content**
-
-1. **DataTable Implementation** (8 files) - ✅ **Fully Consolidated**
-   - `implementation-guides/data-tables.md` - **Single authoritative guide** with all content merged
-   - ~~`implementation-guides/datatable-rbac-usage.md`~~ - **Deleted** (merged into main guide)
-   - ~~`implementation-guides/hierarchical-datatable.md`~~ - **Deleted** (merged into main guide)
-   - ~~`implementation-guides/datatable-filtering.md`~~ - **Deleted** (merged into main guide)
-   - ~~`implementation-guides/large-datasets.md`~~ - **Deleted** (merged into main guide)
-   - ~~`implementation-guides/performance.md`~~ - **Deleted** (merged into main guide)
-   - `api-reference/components.md` (DataTable section) - API reference
-   - `getting-started/examples/full-featured-app.md` - Examples
-   - `best-practices/common-patterns.md` - Best practices
-
-2. **Authentication Setup** (6 files) - ✅ **Fully Consolidated**
-   - `implementation-guides/authentication.md` - **Single authoritative guide** with all content merged
-   - ~~`getting-started/quick-start.md`~~ - **Deleted** (merged into main guide)
-   - ~~`getting-started/examples/basic-auth-app.md`~~ - **Deleted** (merged into main guide)
-   - ~~`troubleshooting/authentication-issues.md`~~ - **Deleted** (merged into main guide)
-   - `api-reference/hooks.md` (useUnifiedAuth section) - API reference
-   - `best-practices/common-patterns.md` - Best practices
-   - `implementation-guides/navigation.md` - Navigation integration
-
-3. **Migration Instructions** (4 files) - ✅ **Fully Consolidated**
-   - `migration/MIGRATION_GUIDE.md` - **Single authoritative guide** with all content merged
-   - ~~`migration/breaking-changes.md`~~ - **Deleted** (merged into main guide)
-   - ~~`migration/quick-migration-guide.md`~~ - **Deleted** (merged into main guide)
-   - ~~`troubleshooting/migration.md`~~ - **Deleted** (merged into main guide)
-
----
-
-### 3. Documentation Accuracy Assessment
-
-#### ✅ **Accurate Documentation** (95/95 files)
-
-All documented features accurately represent the current implementation:
-
-- **Component APIs**: All documented props, methods, and usage patterns match actual implementation
-- **Hook Interfaces**: All documented return types and parameters are accurate
-- **Utility Functions**: All documented function signatures and behaviors are correct
-- **Type Definitions**: All documented TypeScript interfaces match actual types
-- **Code Examples**: All examples are syntactically correct and runnable
-
-#### 🔍 **Implementation Verification**
-
-| Category | Verified | Accuracy |
-|----------|----------|----------|
-| **Components** | 45/45 | 100% |
-| **Hooks** | 25/25 | 100% |
-| **Utilities** | 15/15 | 100% |
-| **Types** | 10/10 | 100% |
-
----
-
-### 4. Last Updated Tracking Analysis
-
-#### ❌ **Missing Timestamps** (95/95 files)
-
-**Current State**: No documentation files have last updated timestamps.
-
-**Required Action**: Add last updated timestamps to all documentation files.
-
-#### 📅 **Proposed Timestamp Format**
-
-```markdown
----
-lastUpdated: 2025-10-29T22:43:00+11:00
-version: 0.5.76
-reviewedBy: [username]
----
-```
-
----
-
-## 🎯 Recommendations
-
-### 🚨 **Immediate Actions (High Priority)**
-
-1. **Document Missing Components**
-   - Add documentation for `Avatar`, `Switch`, `Progress` components
-   - Add documentation for basic `Table` components
-   - Add documentation for missing utilities (`cn`, formatting functions)
-
-2. **Consolidate Duplicate Content**
-   - Merge DataTable implementation guides into single comprehensive guide
-   - Consolidate migration documentation
-   - Create master authentication setup guide
-
-3. **Add Last Updated Timestamps**
-   - Implement timestamp tracking system
-   - Add timestamps to all 95 documentation files
-   - Establish review schedule
-
-### 🔧 **Medium Priority Actions**
-
-1. **Document Missing Hooks**
-   - Add documentation for performance hooks
-   - Add documentation for form hooks
-   - Add documentation for utility hooks
-
-2. **Document Missing Providers**
-   - Add documentation for `EventProvider`
-   - Add documentation for `OrganisationProvider`
-   - Add documentation for `InactivityProvider`
-
-### 📈 **Long-term Improvements**
-
-1. **Automated Documentation Generation**
-   - Implement automated API documentation generation
-   - Set up CI/CD checks for documentation completeness
-   - Create documentation coverage reports
-
-2. **Content Management System**
-   - Implement documentation versioning
-   - Create automated stale content detection
-   - Establish documentation review workflow
-
----
-
-## 📋 Action Plan
-
-### Phase 1: Critical Missing Documentation (Week 1)
-- [ ] Document missing UI components (`Avatar`, `Switch`, `Progress`, `Table`)
-- [ ] Document missing utilities (`cn`, formatting functions)
-- [ ] Add last updated timestamps to all files
-
-### Phase 2: Consolidation (Week 2)
-- [ ] Consolidate DataTable documentation
-- [ ] Merge migration guides
-- [ ] Create master authentication guide
-
-### Phase 3: Complete Coverage (Week 3)
-- [ ] Document missing hooks
-- [ ] Document missing providers
-- [ ] Implement automated documentation checks
-
-### Phase 4: Long-term Improvements (Week 4)
-- [ ] Set up automated documentation generation
-- [ ] Implement documentation versioning
-- [ ] Create documentation review workflow
-
----
-
-## 📊 Success Metrics
-
-| Metric | Current | Target | Timeline |
-|--------|---------|--------|----------|
-| **Documentation Coverage** | 97% | 100% | ⏱️ Almost complete |
-| **Duplicate Content** | ✅ Fully Consolidated | Single authoritative guide | ✅ Complete |
-| **Last Updated Tracking** | 100% | 100% | ✅ Complete |
-| **Content Accuracy** | 100% | 100% | Maintained |
-| **Review Cycle** | None | Quarterly | Ongoing |
-
----
-
-**Report Generated**: October 29, 2025 (9:43am AEDT)
-**Next Review**: January 29, 2026
-**Status**: ✅ **Excellent - 97% Coverage Achieved**

package/docs/STYLE_GUIDE.md

@@ -1,37 +0,0 @@
-# Documentation style checklist
-
-Use this checklist every time you add or revise a doc in `packages/core/docs/`.
-
-## Voice & tone
-
-- [ ] Write in clear, direct sentences (active voice, present tense where possible).
-- [ ] Assume the reader is a React developer comfortable with TypeScript.
-- [ ] Explain *why* a step matters before diving into *how* to do it.
-
-## Structure
-
-- [ ] Use `#` for the page title once per file, then start sections at `##`.
-- [ ] Open with context (goal, prerequisites, or summary) before commands or code.
-- [ ] End with next steps, validation checks, or related links.
-- [ ] Place new pages in the directory that matches their topic (e.g. RBAC docs in `docs/rbac/`).
-
-## Formatting
-
-- [ ] Prefer fenced code blocks with a language tag (`ts`, `tsx`, `bash`).
-- [ ] Include imports in code samples so they can be copied directly.
-- [ ] Keep bullet lists parallel and under seven items; switch to tables if structure matters.
-- [ ] Link to neighbouring docs using relative paths (e.g. `../rbac/quick-start.md`).
-
-## Accuracy & maintenance
-
-- [ ] Check the referenced APIs against the current implementation in `packages/core/src/`.
-- [ ] Verify commands run against the repo (lint, build, scripts) before publishing.
-- [ ] Update [documentation-index.md](./documentation-index.md) if you add, remove, or rename a page.
-- [ ] Note follow-up work or TODOs in the "Known gaps" area of [README.md](./README.md) so they remain visible.
-
-## Review before merging
-
-- [ ] Run a spell check or read the page aloud to catch awkward phrasing.
-- [ ] Confirm headings appear in order (no skipping from `##` to `####`).
-- [ ] Validate that all links resolve locally.
-- [ ] Capture screenshots when you change visual components and attach them to the PR if applicable.

package/examples/RBAC/__tests__/PermissionExample.test.tsx

@@ -1,150 +0,0 @@
-/**
- * @file PermissionExample Unit Tests
- * @package @jmruthers/pace-core
- * @module Examples/RBAC/Tests
- * @since 0.4.0
- */
-
-import React from 'react';
-import { screen } from '@testing-library/react';
-import { describe, it, expect, vi } from 'vitest';
-import '@testing-library/jest-dom';
-import { renderWithProviders } from '../../../src/__tests__/helpers/test-utils';
-import { PermissionExample } from '../PermissionExample';
-
-// Mock the hooks since this is a demonstration component
-vi.mock('../../src/providers', () => ({
-  useUnifiedAuth: () => ({
-    user: { email: 'test@example.com' },
-    isAuthenticated: true,
-    hasPermission: (permission: string) => permission === 'app:read',
-    hasAccessLevel: (level: string) => level === 'editor',
-    accessLevel: 'editor',
-    selectedEventId: 'event-123',
-    setSelectedEventId: vi.fn()
-  })
-}));
-
-vi.mock('../../src/hooks', () => ({
-  useAppConfig: () => ({
-    supportsDirectAccess: true,
-    requiresEvent: false,
-    isLoading: false,
-    appName: 'Test App'
-  })
-}));
-
-vi.mock('../../src/types', () => ({
-  AccessLevel: {
-    EDITOR: 'editor',
-    PLANNER: 'planner',
-    ADMIN: 'admin'
-  }
-}));
-
-describe('PermissionExample Component', () => {
-  describe('Rendering', () => {
-    it('renders without crashing', () => {
-      renderWithProviders(<PermissionExample />);
-      expect(screen.getByText('Permission System Example')).toBeInTheDocument();
-    });
-
-    it('renders app configuration information', () => {
-      renderWithProviders(<PermissionExample />);
-      expect(screen.getByText(/App Configuration: Test App/)).toBeInTheDocument();
-      expect(screen.getByText(/Supports Direct Access: ✅/)).toBeInTheDocument();
-    });
-
-    it('displays current user information', () => {
-      renderWithProviders(<PermissionExample />);
-      expect(screen.getByText(/User: test@example.com/)).toBeInTheDocument();
-    });
-
-    it('renders permission examples section', () => {
-      renderWithProviders(<PermissionExample />);
-      expect(screen.getByText('Permission Examples')).toBeInTheDocument();
-      expect(screen.getByText('Basic Permissions')).toBeInTheDocument();
-      expect(screen.getByText('Access Level Checks')).toBeInTheDocument();
-    });
-  });
-
-  describe('Permission Display', () => {
-    it('shows permission statuses', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      // Should show read permission is granted
-      expect(screen.getByText(/Can Read: ✅/)).toBeInTheDocument();
-      // Should show other permissions are denied (mocked to only return true for read)
-      expect(screen.getByText(/Can Write: ❌/)).toBeInTheDocument();
-    });
-
-    it('displays access level information', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      expect(screen.getByText(/Is Editor\+: ✅/)).toBeInTheDocument();
-      expect(screen.getByText(/Is Planner\+: ❌/)).toBeInTheDocument();
-      expect(screen.getByText(/Is Admin: ❌/)).toBeInTheDocument();
-    });
-  });
-
-  describe('Conditional Rendering', () => {
-    it('shows conditional UI elements based on permissions', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      // Should show read permission content
-      expect(screen.getByText(/You can see this because you have read permission/)).toBeInTheDocument();
-      
-      // Should show message about missing delete permission
-      expect(screen.getByText(/Delete functionality not available for your access level/)).toBeInTheDocument();
-    });
-
-    it('does not show write permission content when not granted', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      // Should not show edit button (write permission not granted in mock)
-      expect(screen.queryByText(/Edit \(Available with write permission\)/)).not.toBeInTheDocument();
-    });
-
-    it('does not show admin content when access level is insufficient', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      // Should not show admin-only content (mock returns editor level, not admin)
-      expect(screen.queryByText(/Admin-only content visible/)).not.toBeInTheDocument();
-    });
-  });
-
-  describe('Component Structure', () => {
-    it('has proper heading structure', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      expect(screen.getByRole('heading', { level: 2, name: 'Permission System Example' })).toBeInTheDocument();
-      expect(screen.getByRole('heading', { level: 3, name: 'Permission Examples' })).toBeInTheDocument();
-    });
-
-    it('organizes content into logical sections', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      expect(screen.getByText('App Configuration')).toBeInTheDocument();
-      expect(screen.getByText('Permission Examples')).toBeInTheDocument();
-      expect(screen.getByText('Current Status')).toBeInTheDocument();
-    });
-  });
-
-  describe('Data Display', () => {
-    it('displays current status information', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      expect(screen.getByText(/App: Test App/)).toBeInTheDocument();
-      expect(screen.getByText(/Event: event-123/)).toBeInTheDocument();
-      expect(screen.getByText(/Permission Model: Direct Access/)).toBeInTheDocument();
-    });
-
-    it('shows correct access model based on configuration', () => {
-      renderWithProviders(<PermissionExample />);
-      
-      // Since supportsDirectAccess is true and requiresEvent is false
-      expect(screen.getByText(/Permission Model: Direct Access/)).toBeInTheDocument();
-    });
-  });
-});
-