@jmruthers/pace-core 0.5.193 → 0.6.2

package/dist/hooks.d.ts

@@ -1,9 +1,9 @@
-export { u as useToast } from './useToast-C8gR5ir4.js';
-import { a as StorageUploadOptions, c as StorageUploadResult, e as StorageListOptions, f as StorageListResult, m as StorageFileInfo } from './usePublicRouteParams-TZe0gy-4.js';
-export { O as OrganisationSecurityHook, K as UseAppConfigReturn, U as UseFormDialogOptions, h as UseFormDialogReturn, J as UseOrganisationPermissionsReturn, H as UsePublicEventLogoOptions, G as UsePublicEventLogoReturn, C as UsePublicEventOptions, B as UsePublicEventReturn, E as UsePublicFileDisplayOptions, D as UsePublicFileDisplayReturn, I as UsePublicRouteParamsReturn, o as clearPublicEventCache, r as clearPublicFileDisplayCache, v as clearPublicLogoCache, A as extractEventCodeFromPath, z as generatePublicRoutePath, p as getPublicEventCacheStats, s as getPublicFileDisplayCacheStats, w as getPublicLogoCacheStats, k as useAppConfig, l as useEventTheme, g as useFormDialog, i as useOrganisationPermissions, j as useOrganisationSecurity, n as usePublicEvent, y as usePublicEventCode, t as usePublicEventLogo, q as usePublicFileDisplay, x as usePublicRouteParams, u as useZodForm } from './usePublicRouteParams-TZe0gy-4.js';
+export { u as useToast } from './useToast-AyaT-x7p.js';
+import { S as StorageUploadOptions, a as StorageUploadResult, b as StorageListOptions, c as StorageListResult, d as StorageFileInfo } from './usePublicRouteParams-1oMokgLF.js';
+export { O as OrganisationSecurityHook, l as UseAppConfigReturn, i as UseFormDialogOptions, j as UseFormDialogReturn, U as UseOrganisationPermissionsReturn, F as UsePublicEventLogoOptions, E as UsePublicEventLogoReturn, B as UsePublicEventOptions, A as UsePublicEventReturn, D as UsePublicFileDisplayOptions, C as UsePublicFileDisplayReturn, G as UsePublicRouteParamsReturn, n as clearPublicEventCache, q as clearPublicFileDisplayCache, t as clearPublicLogoCache, z as extractEventCodeFromPath, y as generatePublicRoutePath, o as getPublicEventCacheStats, r as getPublicFileDisplayCacheStats, v as getPublicLogoCacheStats, k as useAppConfig, u as useEventTheme, h as useFormDialog, e as useOrganisationPermissions, f as useOrganisationSecurity, m as usePublicEvent, x as usePublicEventCode, s as usePublicEventLogo, p as usePublicFileDisplay, w as usePublicRouteParams, g as useZodForm } from './usePublicRouteParams-1oMokgLF.js';
 import * as React$1 from 'react';
 import { SortingState, ColumnFiltersState, ExpandedState } from '@tanstack/react-table';
-import { d as DataRecord, g as PerformanceConfig, S as ServerSideConfig, C as ChunkingConfig, i as SearchIndexConfig, h as PaginationMode, k as ServerSideParams, l as ServerSideResponse, A as AutocompleteOptions, m as GooglePlaceAutocompletePrediction, P as ParsedAddress } from './types-CEpcvwwF.js';
+import { d as DataRecord, g as PerformanceConfig, S as ServerSideConfig, C as ChunkingConfig, i as SearchIndexConfig, h as PaginationMode, k as ServerSideParams, l as ServerSideResponse, A as AutocompleteOptions, m as GooglePlaceAutocompletePrediction, P as ParsedAddress } from './types-CkbwOr4Y.js';
 export { u as useComponentPerformance } from './useComponentPerformance-DE9l5RkL.js';
 import { SupabaseClient } from '@supabase/supabase-js';
 import { D as Database } from './database.generated-CzIvgcPu.js';
@@ -31,6 +31,10 @@ declare enum DataTableErrorType {
     SERVER_FETCH = "server_fetch",
     MEMORY = "memory"
 }
+/**
+ * Custom error class for DataTable operations.
+ * Provides error type and recoverability information.
+ */
 declare class DataTableError extends Error {
     type: DataTableErrorType;
     recoverable: boolean;
@@ -82,6 +86,9 @@ interface UseDataTablePerformanceReturn<TData extends DataRecord> {
  */
 declare function useDataTablePerformance<TData extends DataRecord>({ data, performance, serverSide, chunking, searchIndex, fallbackConfig, onError, enableErrorRecovery }: UseDataTablePerformanceOptions<TData>): UseDataTablePerformanceReturn<TData>;
 
+/**
+ * Options for the useFocusManagement hook.
+ */
 interface FocusManagementOptions {
     trapFocus?: boolean;
     autoFocus?: boolean;
@@ -90,9 +97,13 @@ interface FocusManagementOptions {
     onFocusFirst?: () => void;
     onFocusLast?: () => void;
 }
+/**
+ * Return value of the useFocusManagement hook.
+ * Provides focus management utilities for accessible components.
+ */
 interface FocusManagementReturn {
-    containerRef: React.RefObject<HTMLDivElement>;
-    focusRef: React.RefObject<HTMLElement>;
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    focusRef: React.RefObject<HTMLElement | null>;
     setFocus: (element: HTMLElement | null) => void;
     focusFirst: () => void;
     focusLast: () => void;
@@ -101,8 +112,18 @@ interface FocusManagementReturn {
     getFocusableElements: () => HTMLElement[];
     handleEscape: (callback: () => void) => () => void;
 }
+/**
+ * Hook for managing focus in accessible components.
+ * Provides focus trapping, restoration, and navigation utilities.
+ *
+ * @param options - Focus management configuration
+ * @returns Focus management utilities and refs
+ */
 declare function useFocusManagement(options?: FocusManagementOptions): FocusManagementReturn;
 
+/**
+ * Options for the useFocusTrap hook.
+ */
 interface FocusTrapOptions {
     /** Whether the focus trap is active */
     isActive?: boolean;
@@ -117,7 +138,7 @@ interface FocusTrapOptions {
 }
 interface FocusTrapReturn {
     /** Ref to attach to the container element */
-    containerRef: React.RefObject<HTMLElement>;
+    containerRef: React.RefObject<HTMLElement | null>;
     /** Focus the first focusable element */
     focusFirst: () => void;
     /** Focus the last focusable element */
@@ -131,6 +152,10 @@ interface FocusTrapReturn {
  */
 declare function useFocusTrap(options?: FocusTrapOptions): FocusTrapReturn;
 
+/**
+ * Keyboard shortcut definition.
+ * Defines a key combination and its handler function.
+ */
 interface KeyboardShortcut {
     /** Key combination (e.g., 'Escape', 'Enter', 'ArrowDown', 'ctrl+s') */
     key: string;
@@ -190,6 +215,15 @@ declare function useKeyboardShortcuts(shortcuts: KeyboardShortcut[], options?: K
  */
 declare function useIsMobile(): boolean;
 
+/**
+ * Hook for debouncing a value.
+ * Returns a debounced version of the value that only updates after the specified delay.
+ *
+ * @template T - The type of the value to debounce
+ * @param value - The value to debounce
+ * @param delay - The delay in milliseconds
+ * @returns The debounced value
+ */
 declare function useDebounce<T>(value: T, delay: number): T;
 
 interface UseDataTableStateOptions {
@@ -286,113 +320,9 @@ interface UseAddressAutocompleteReturn {
 declare function useAddressAutocomplete(apiKey: string, inputValue: string, options?: UseAddressAutocompleteOptions): UseAddressAutocompleteReturn;
 
 /**
- * @file useSecureDataAccess Hook
- * @package @jmruthers/pace-core
- * @module Hooks/useSecureDataAccess
- * @since 0.4.0
- *
- * Hook for secure database operations with mandatory organisation context.
- * Ensures all data access is properly scoped to the user's current organisation.
- *
- * @example
- * ```tsx
- * function DataComponent() {
- *   const { secureQuery, secureInsert, secureUpdate, secureDelete } = useSecureDataAccess();
- *
- *   const loadData = async () => {
- *     try {
- *       // Automatically includes organisation_id filter
- *       const events = await secureQuery('core_events', '*', { is_visible: true });
- *       console.log('Organisation events:', events);
- *     } catch (error) {
- *       console.error('Failed to load data:', error);
- *     }
- *   };
- *
- *   const createEvent = async (eventData) => {
- *     try {
- *       // Automatically sets organisation_id
- *       const newEvent = await secureInsert('core_events', eventData);
- *       console.log('Created event:', newEvent);
- *     } catch (error) {
- *       console.error('Failed to create event:', error);
- *     }
- *   };
- *
- *   return (
- *     <div>
- *       <button onClick={loadData}>Load Data</button>
- *       <button onClick={() => createEvent({ event_name: 'New Event' })}>
- *         Create Event
- *       </button>
- *     </div>
- *   );
- * }
- * ```
- *
- * @security
- * - All queries automatically include organisation_id filter
- * - Validates organisation context before any operation
- * - Prevents data leaks between organisations
- * - Error handling for security violations
- * - Type-safe database operations
- */
-interface SecureDataAccessReturn {
-    /** Execute a secure query with organisation filtering */
-    secureQuery: <T = any>(table: string, columns: string, filters?: Record<string, any>, options?: {
-        orderBy?: string;
-        ascending?: boolean;
-        limit?: number;
-        offset?: number;
-    }) => Promise<T[]>;
-    /** Execute a secure insert with organisation context */
-    secureInsert: <T = any>(table: string, data: Record<string, any>) => Promise<T>;
-    /** Execute a secure update with organisation filtering */
-    secureUpdate: <T = any>(table: string, data: Record<string, any>, filters: Record<string, any>) => Promise<T[]>;
-    /** Execute a secure delete with organisation filtering */
-    secureDelete: (table: string, filters: Record<string, any>) => Promise<void>;
-    /** Execute a secure RPC call with organisation context */
-    secureRpc: <T = any>(functionName: string, params?: Record<string, any>) => Promise<T>;
-    /** Get current organisation ID */
-    getCurrentOrganisationId: () => string;
-    /** Validate organisation context */
-    validateContext: () => void;
-    /** Check if data access is allowed for a table and operation */
-    isDataAccessAllowed: (table: string, operation: string) => boolean;
-    /** Get all data access permissions for current user */
-    getDataAccessPermissions: () => Record<string, string[]>;
-    /** Check if strict mode is enabled */
-    isStrictMode: boolean;
-    /** Check if audit logging is enabled */
-    isAuditLogEnabled: boolean;
-    /** Get data access history */
-    getDataAccessHistory: () => DataAccessRecord[];
-    /** Clear data access history */
-    clearDataAccessHistory: () => void;
-    /** Validate data access attempt */
-    validateDataAccess: (table: string, operation: string) => boolean;
-}
-interface DataAccessRecord {
-    table: string;
-    operation: string;
-    userId: string;
-    organisationId: string;
-    allowed: boolean;
-    timestamp: string;
-    query?: string;
-    filters?: Record<string, any>;
-}
-/**
- * Hook for secure data access with automatic organisation filtering
- *
- * All database operations automatically include organisation context:
- * - Queries filter by organisation_id
- * - Inserts include organisation_id
- * - Updates/deletes are scoped to organisation
- * - RPC calls include organisation_id parameter
+ * Performance metrics interface.
+ * Represents performance measurement data for components or operations.
  */
-declare function useSecureDataAccess(): SecureDataAccessReturn;
-
 interface PerformanceMetrics {
     renderTime: number;
     componentName: string;
@@ -480,25 +410,20 @@ interface UseQueryCacheReturn {
  * );
  * ```
  */
+/**
+ * Hook for in-memory query result caching.
+ * Provides caching for frequently accessed data to eliminate duplicate queries.
+ *
+ * @param supabase - Optional Supabase client instance
+ * @returns Query cache utilities including get, invalidate, and clear functions
+ */
 declare function useQueryCache(supabase?: SupabaseClient<Database>): UseQueryCacheReturn;
 /**
  * Pre-configured cache helpers for common queries
  */
 declare const queryCacheHelpers: {
-    /**
-     * Cache core_person queries by user_id
-     * TTL: 5 minutes
-     */
     pacePersonByUserId: <T>(supabase: SupabaseClient<Database>, userId: string, fetchFn: () => Promise<T>) => Promise<T>;
-    /**
-     * Cache core_member queries by person_id
-     * TTL: 5 minutes
-     */
     paceMemberByPersonId: <T>(supabase: SupabaseClient<Database>, personId: string, fetchFn: () => Promise<T>) => Promise<T>;
-    /**
-     * Cache rbac_app_pages queries by app_id
-     * TTL: 15 minutes (app pages are relatively static)
-     */
     rbacAppPagesByAppId: <T>(supabase: SupabaseClient<Database>, appId: string, fetchFn: () => Promise<T>) => Promise<T>;
 };
 
@@ -538,6 +463,10 @@ declare const queryCacheHelpers: {
  * ```
  */
 
+/**
+ * Return value of the useFileDisplay hook.
+ * Provides file URLs, references, loading state, error, and refetch function.
+ */
 interface UseFileDisplayReturn {
     /** Single file URL if category is provided and file found, null otherwise */
     fileUrl: string | null;
@@ -688,6 +617,10 @@ interface UseStorageOptions {
     appName: string;
     orgId: string;
 }
+/**
+ * Return value of the useStorage hook.
+ * Provides storage operations including upload, URL generation, file management, and listing.
+ */
 interface UseStorageReturn {
     uploadFile: (file: File, options?: Partial<StorageUploadOptions>) => Promise<StorageUploadResult>;
     isUploading: boolean;
@@ -769,4 +702,4 @@ interface UsePreventTabReloadOptions {
  */
 declare function usePreventTabReload(options?: UsePreventTabReloadOptions): void;
 
-export { type SecureDataAccessReturn, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseDataTablePerformanceOptions, type UseDataTablePerformanceReturn, type UseFileDisplayOptions, type UseFileDisplayReturn, type UseFileUrlCacheReturn, type UsePreventTabReloadOptions, type UseQueryCacheOptions, type UseQueryCacheReturn, type UseStorageOptions, type UseStorageReturn, cleanupQueryCache, clearFileDisplayCache, getFileDisplayCacheStats, invalidateFileDisplayCache, queryCacheHelpers, useAddressAutocomplete, useDataTablePerformance, useDataTableState, useDebounce, useFileDisplay, useFileUpload, useFileUrlCache, useFocusManagement, useFocusTrap, useIsMobile, useKeyboardShortcuts, usePerformanceMonitor, usePreventTabReload, useQueryCache, useSecureDataAccess, useStorage };
+export { type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseDataTablePerformanceOptions, type UseDataTablePerformanceReturn, type UseFileDisplayOptions, type UseFileDisplayReturn, type UseFileUrlCacheReturn, type UsePreventTabReloadOptions, type UseQueryCacheOptions, type UseQueryCacheReturn, type UseStorageOptions, type UseStorageReturn, cleanupQueryCache, clearFileDisplayCache, getFileDisplayCacheStats, invalidateFileDisplayCache, queryCacheHelpers, useAddressAutocomplete, useDataTablePerformance, useDataTableState, useDebounce, useFileDisplay, useFileUpload, useFileUrlCache, useFocusManagement, useFocusTrap, useIsMobile, useKeyboardShortcuts, usePerformanceMonitor, usePreventTabReload, useQueryCache, useStorage };

package/dist/hooks.js

@@ -12,10 +12,7 @@ import {
   usePublicEventLogo,
   usePublicRouteParams,
   useZodForm
-} from "./chunk-HWIIPPNI.js";
-import {
-  useSecureDataAccess
-} from "./chunk-LFNCN2SP.js";
+} from "./chunk-2UOI2FG5.js";
 import {
   archiveFile,
   cleanupQueryCache,
@@ -37,18 +34,18 @@ import {
   usePreventTabReload,
   usePublicFileDisplay,
   useQueryCache
-} from "./chunk-BC4IJKSL.js";
+} from "./chunk-SFZUDBL5.js";
 import {
   useDataTablePerformance,
   useToast
-} from "./chunk-6C4YBBJM.js";
+} from "./chunk-6SOIHG6Z.js";
 import {
   useAppConfig,
   useOrganisationSecurity
-} from "./chunk-IIELH4DL.js";
+} from "./chunk-MMZ7JXPU.js";
 import "./chunk-KQCRWDSA.js";
-import "./chunk-7FLMSG37.js";
-import "./chunk-KNC55RTG.js";
+import "./chunk-EHMR7VYL.js";
+import "./chunk-24UVZUZG.js";
 import "./chunk-63FOKYGO.js";
 import "./chunk-ZSAAAMVR.js";
 import "./chunk-QXHPKYJV.js";
@@ -59,9 +56,9 @@ import "./chunk-G37KK66H.js";
 import {
   PERFORMANCE_BUDGETS,
   performanceBudgetMonitor
-} from "./chunk-I7PSE6JW.js";
+} from "./chunk-FMUCXFII.js";
 import "./chunk-VBXEHIUJ.js";
-import "./chunk-SQGMNID3.js";
+import "./chunk-L4OXEN46.js";
 import {
   createLogger
 } from "./chunk-PWLANIRT.js";
@@ -208,7 +205,10 @@ function useFocusTrap(options = {}) {
     return Array.from(
       containerRef.current.querySelectorAll(focusableSelector)
     ).filter((element) => {
-      return !element.hasAttribute("disabled") && !element.hasAttribute("hidden") && element.offsetParent !== null;
+      return (
+        // visible check
+        !element.hasAttribute("disabled") && !element.hasAttribute("hidden") && element.offsetParent !== null
+      );
     });
   }, [focusableSelector]);
   const focusFirst = useCallback2(() => {
@@ -347,7 +347,7 @@ function useIsMobile() {
 }
 
 // src/hooks/useDataTableState.ts
-import { useState as useState2, useCallback as useCallback4, useMemo } from "react";
+import { useState as useState2, useCallback as useCallback4 } from "react";
 function useDataTableState(options) {
   const { initialPageSize = 10, data } = options;
   const [sorting, setSorting] = useState2([]);
@@ -364,20 +364,12 @@ function useDataTableState(options) {
     setPageIndex(0);
     setSelectedRows([]);
   }, [initialPageSize]);
-  const paginatedData = useMemo(() => {
-    const start = pageIndex * pageSize;
-    const end = start + pageSize;
-    return data.slice(start, end);
-  }, [data, pageIndex, pageSize]);
-  const totalPages = useMemo(() => {
-    return Math.ceil(data.length / pageSize);
-  }, [data.length, pageSize]);
-  const hasNextPage = useMemo(() => {
-    return pageIndex < totalPages - 1;
-  }, [pageIndex, totalPages]);
-  const hasPreviousPage = useMemo(() => {
-    return pageIndex > 0;
-  }, [pageIndex]);
+  const start = pageIndex * pageSize;
+  const end = start + pageSize;
+  const paginatedData = data.slice(start, end);
+  const totalPages = Math.ceil(data.length / pageSize);
+  const hasNextPage = pageIndex < totalPages - 1;
+  const hasPreviousPage = pageIndex > 0;
   return {
     state: {
       sorting,
@@ -787,7 +779,6 @@ export {
   usePublicFileDisplay,
   usePublicRouteParams,
   useQueryCache,
-  useSecureDataAccess,
   useStorage,
   useToast,
   useZodForm