@jmruthers/pace-core 0.5.184 → 0.5.186

package/src/hooks/usePreventTabReload.ts

@@ -0,0 +1,106 @@
+/**
+ * @file usePreventTabReload Hook
+ * @package @jmruthers/pace-core
+ * @module Hooks
+ * @since 0.6.0
+ *
+ * Prevents full page reloads when switching browser tabs.
+ * Handles browser back-forward cache (bfcache) restoration and tab visibility changes.
+ */
+
+import { useEffect, useRef } from 'react';
+
+export interface UsePreventTabReloadOptions {
+  /**
+   * Whether to enable the prevention logic
+   * @default true
+   */
+  enabled?: boolean;
+
+  /**
+   * Grace period in milliseconds to wait after tab becomes visible
+   * before allowing any potential reloads
+   * @default 2000
+   */
+  gracePeriodMs?: number;
+}
+
+/**
+ * Hook to prevent full page reloads when switching browser tabs.
+ * 
+ * This hook handles:
+ * - Browser back-forward cache (bfcache) restoration
+ * - Tab visibility changes
+ * - Prevents unwanted page reloads when returning to a tab
+ * 
+ * @param options - Configuration options
+ * 
+ * @example
+ * ```tsx
+ * import { usePreventTabReload } from '@jmruthers/pace-core';
+ * 
+ * function MyComponent() {
+ *   usePreventTabReload();
+ *   // Component code...
+ * }
+ * ```
+ */
+export function usePreventTabReload(options: UsePreventTabReloadOptions = {}): void {
+  const { enabled = true, gracePeriodMs = 2000 } = options;
+  const isRestoringFromCacheRef = useRef(false);
+  const gracePeriodTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  useEffect(() => {
+    if (!enabled || typeof window === 'undefined') return;
+
+    // Handle pageshow event - detects when page is restored from bfcache
+    const handlePageShow = (event: PageTransitionEvent) => {
+      // If page was restored from bfcache, prevent any reload behavior
+      if (event.persisted) {
+        isRestoringFromCacheRef.current = true;
+        
+        // Clear any existing timeout
+        if (gracePeriodTimeoutRef.current) {
+          clearTimeout(gracePeriodTimeoutRef.current);
+        }
+        
+        // Set grace period to prevent reloads
+        gracePeriodTimeoutRef.current = setTimeout(() => {
+          isRestoringFromCacheRef.current = false;
+        }, gracePeriodMs);
+      }
+    };
+
+    // Handle visibility changes - when tab becomes visible
+    const handleVisibilityChange = () => {
+      if (!document.hidden) {
+        // Tab just became visible - set flag to prevent reloads
+        isRestoringFromCacheRef.current = true;
+        
+        // Clear any existing timeout
+        if (gracePeriodTimeoutRef.current) {
+          clearTimeout(gracePeriodTimeoutRef.current);
+        }
+        
+        // Set grace period
+        gracePeriodTimeoutRef.current = setTimeout(() => {
+          isRestoringFromCacheRef.current = false;
+        }, gracePeriodMs);
+      }
+    };
+
+    // Add event listeners
+    window.addEventListener('pageshow', handlePageShow);
+    document.addEventListener('visibilitychange', handleVisibilityChange);
+
+    return () => {
+      window.removeEventListener('pageshow', handlePageShow);
+      document.removeEventListener('visibilitychange', handleVisibilityChange);
+      
+      if (gracePeriodTimeoutRef.current) {
+        clearTimeout(gracePeriodTimeoutRef.current);
+      }
+    };
+  }, [enabled, gracePeriodMs]);
+}
+

package/src/hooks/useSecureDataAccess.ts

@@ -219,7 +219,7 @@ export function useSecureDataAccess(): SecureDataAccessReturn {
       'cake_meal', 'cake_mealtype', 'pace_person', 'pace_member',
       // SECURITY: Phase 3A additions - medical and personal data
       'medi_profile', 'medi_condition', 'medi_diet', 'medi_action_plan', 'medi_profile_versions',
-      'pace_consent', 'pace_contact', 'pace_id_documents', 'pace_qualifications',
+      'pace_consent', 'pace_contact', 'pace_identification', 'pace_identification_type', 'pace_qualification',
       'form_responses', 'form_response_values', 'forms',
       // SECURITY: Phase 3B additions - remaining critical tables
       'invoice', 'line_item', 'credit_balance', 'payment_method',
@@ -379,7 +379,7 @@ export function useSecureDataAccess(): SecureDataAccessReturn {
       'cake_meal', 'cake_mealtype', 'pace_person', 'pace_member',
       // SECURITY: Phase 3A additions - medical and personal data
       'medi_profile', 'medi_condition', 'medi_diet', 'medi_action_plan', 'medi_profile_versions',
-      'pace_consent', 'pace_contact', 'pace_id_documents', 'pace_qualifications',
+      'pace_consent', 'pace_contact', 'pace_identification', 'pace_identification_type', 'pace_qualification',
       'form_responses', 'form_response_values', 'forms',
       // SECURITY: Phase 3B additions - remaining critical tables
       'invoice', 'line_item', 'credit_balance', 'payment_method',

package/src/index.ts

@@ -189,6 +189,17 @@ export type { FormProps, FormFieldProps } from './components/Form/Form';
 export { LoginForm } from './components/LoginForm';
 export type { LoginFormProps } from './components/LoginForm';
 
+// FORM HOOKS
+export { useZodForm } from './hooks/useZodForm';
+export { useFormDialog } from './hooks/useFormDialog';
+export type { UseFormDialogOptions, UseFormDialogReturn } from './hooks/useFormDialog';
+
+// VALIDATION - Re-export zod for schema creation
+export { z } from 'zod';
+// Common validation schemas
+export { emailSchema, nameSchema, phoneSchema, urlSchema } from './utils/validation/common';
+export { passwordSchema } from './utils/validation/passwordSchema';
+
 // LAYOUT COMPONENTS
 export { Header } from './components/Header/Header';
 export { Footer } from './components/Footer/Footer';
@@ -236,6 +247,10 @@ export { useEventTheme } from './hooks/useEventTheme';
 export { cn } from './utils/core/cn';
 export { setAppConfig, getAppConfig, getCurrentAppName, getCurrentAppId } from './utils/app/appConfig';
 
+// LOGGING UTILITIES
+export { Logger, logger, createLogger, LogLevel } from './utils/core/logger';
+export type { LoggerConfig } from './utils/core/logger';
+
 // FORMATTING UTILITIES
 export { 
   formatDate,
@@ -248,6 +263,18 @@ export {
   formatFileSize
 } from './utils/formatting/formatting';
 
+// TIMEZONE UTILITIES
+export {
+  formatInTimeZone,
+  getTimezoneAbbreviation,
+  formatTimeInTimeZone,
+  getUserTimeZone,
+  toZonedTime,
+  fromZonedTime,
+  roundToNearestMinutes,
+  getTimeZoneDifference
+} from './utils/timezone';
+
 // STORAGE UTILITIES
 export { FileUpload } from './components/FileUpload';
 export type { FileUploadProps } from './components/FileUpload';

package/src/providers/services/OrganisationServiceProvider.tsx

@@ -49,11 +49,12 @@ export function OrganisationServiceProvider({
     // Re-initialize service when user/session changes
     let isMounted = true;
     
-    organisationService.initialize().catch(error => {
-      if (isMounted) {
-        logger.error('OrganisationServiceProvider', 'Failed to initialize organisation service:', error);
-      }
-    });
+    organisationService.initialize()
+      .catch(error => {
+        if (isMounted) {
+          logger.error('OrganisationServiceProvider', 'Failed to initialize organisation service:', error);
+        }
+      });
 
     return () => {
       isMounted = false;

package/src/providers/services/UnifiedAuthProvider.tsx

@@ -8,7 +8,7 @@
  * Note: RBAC functionality is available via useRBAC() hook from '@jmruthers/pace-core/rbac'
  */
 
-import React, { createContext, useContext, useMemo, useCallback, useRef, useEffect, useState } from 'react';
+import React, { createContext, useContext, useMemo, useCallback, useRef, useEffect, useState, useReducer } from 'react';
 import { type SupabaseClient, type User, type Session } from '@supabase/supabase-js';
 import { AuthServiceProvider } from './AuthServiceProvider';
 import { OrganisationServiceProvider } from './OrganisationServiceProvider';
@@ -114,7 +114,7 @@ export interface UnifiedAuthContextType {
   sessionRestorationTimeoutMs: number;
 }
 
-const UnifiedAuthContext = createContext<UnifiedAuthContextType | undefined>(undefined);
+export const UnifiedAuthContext = createContext<UnifiedAuthContextType | undefined>(undefined);
 
 export const useUnifiedAuth = () => {
   const context = useContext(UnifiedAuthContext);
@@ -179,13 +179,15 @@ function UnifiedAuthContextProvider({
     eventService = useEventService();
   } catch (error) {
     // EventService not available - provide fallback implementation
+    // Include subscribe method to match BaseService interface
     eventService = {
       getEvents: () => [],
       getSelectedEvent: () => null,
       isLoading: () => false,
       getError: () => null,
       setSelectedEvent: () => {},
-      refreshEvents: async () => {}
+      refreshEvents: async () => {},
+      subscribe: () => () => {} // No-op subscribe/unsubscribe for fallback
     };
   }
 
@@ -256,6 +258,25 @@ function UnifiedAuthContextProvider({
     }
   }, [isAuth, currentUser?.id, supabase, appName, appId]);
 
+  // Subscribe to service state changes to trigger re-renders
+  // Use useReducer to force updates when services notify
+  const [, forceUpdate] = useReducer(x => x + 1, 0);
+  
+  useEffect(() => {
+    // Subscribe to all service changes
+    const unsubscribeAuth = authService.subscribe(() => forceUpdate());
+    const unsubscribeOrg = organisationService.subscribe(() => forceUpdate());
+    const unsubscribeEvent = eventService.subscribe(() => forceUpdate());
+    const unsubscribeInactivity = inactivityService.subscribe(() => forceUpdate());
+    
+    return () => {
+      unsubscribeAuth();
+      unsubscribeOrg();
+      unsubscribeEvent();
+      unsubscribeInactivity();
+    };
+  }, [authService, organisationService, eventService, inactivityService]);
+
   // Get loading states - these will trigger re-renders when services change
   const authLoading = authService.isLoading();
   const orgLoading = organisationService.isLoading();