@jmruthers/pace-core 0.6.9 → 0.6.11

package/docs/api/modules.md

@@ -54,6 +54,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 
 - [AddressFieldProps](undefined)
 - [AddressFieldRef](undefined)
+- [AppSwitcherProps](undefined)
 - [AvatarProps](undefined)
 - [BadgeProps](undefined)
 - [ButtonProps](undefined)
@@ -61,27 +62,30 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [CardProps](undefined)
 - [ContextSelectorProps](undefined)
 - [DataTableProps](undefined)
-- [DataRecord](undefined)
-- [DataTableColumn](undefined)
 - [DataTableAction](undefined)
 - [DataTableToolbarButton](undefined)
+- [DataRecord](undefined)
 - [AggregateConfig](undefined)
-- [EmptyStateConfig](undefined)
+- [DataTableColumn](undefined)
 - [ExportOptions](undefined)
+- [EmptyStateConfig](undefined)
+- [ImportSummary](undefined)
 - [ExportColumn](undefined)
+- [DatePickerWithTimezoneProps](undefined)
 - [DialogProps](undefined)
 - [DialogTriggerProps](undefined)
 - [DialogContentProps](undefined)
 - [DialogPortalProps](undefined)
-- [DialogCloseProps](undefined)
 - [DialogHeaderProps](undefined)
 - [DialogFooterProps](undefined)
 - [DialogBodyProps](undefined)
+- [DialogCloseProps](undefined)
 - [ErrorBoundaryState](undefined)
 - [ErrorBoundaryProps](undefined)
 - [ErrorBoundaryProviderProps](undefined)
 - [FileDisplayProps](undefined)
-- [FileUploadProps](undefined)
+- [UsePublicFileDisplayReturn](undefined)
+- [UsePublicFileDisplayOptions](undefined)
 - [FooterProps](undefined)
 - [FormProps](undefined)
 - [FormFieldProps](undefined)
@@ -91,7 +95,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [LoginFormProps](undefined)
 - [NavigationItem](undefined)
 - [NavigationMenuProps](undefined)
-- [PaceAppLayoutProps](undefined)
+- [PaceAppLayoutRouteConfigItem](undefined)
+- [PaceAppLayoutPermissionConfig](undefined)
+- [PaceAppLayoutRoutingConfig](undefined)
 - [PaceLoginPageProps](undefined)
 - [ProgressProps](undefined)
 - [ProtectedRouteProps](undefined)
@@ -112,36 +118,23 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [UsePublicEventOptions](undefined)
 - [UsePublicEventLogoReturn](undefined)
 - [UsePublicEventLogoOptions](undefined)
-- [UsePublicFileDisplayReturn](undefined)
-- [UsePublicFileDisplayOptions](undefined)
 - [UsePublicRouteParamsReturn](undefined)
+- [AccessibleApp](undefined)
+- [UseAccessibleAppsReturn](undefined)
 - [UseFormDialogOptions](undefined)
 - [UseFormDialogReturn](undefined)
 - [UseInactivityTrackerOptions](undefined)
 - [UseInactivityTrackerReturn](undefined)
-- [OrganisationProviderProps](undefined)
 - [UserEventAccess](undefined)
-- [UnifiedAuthContextType](undefined)
 - [UnifiedAuthProviderProps](undefined)
-- [DatabaseIssue](undefined)
-- [DatabaseComplianceResult](undefined)
-- [QuickFix](undefined)
-- [RuntimeComplianceResult](undefined)
-- [SetupIssue](undefined)
-- [ComplianceResult](undefined)
 - [AccessDeniedProps](undefined)
 - [NavigationGuardProps](undefined)
 - [PagePermissionGuardProps](undefined)
-- [RBACConfig](undefined)
 - [RBACLogger](undefined)
 - [UseResolvedScopeOptions](undefined)
 - [UseResolvedScopeReturn](undefined)
 - [UseResourcePermissionsOptions](undefined)
 - [ResourcePermissions](undefined)
-- [EventAppRoleData](undefined)
-- [RevokeEventAppRoleParams](undefined)
-- [GrantEventAppRoleParams](undefined)
-- [RoleManagementResult](undefined)
 - [RBACPerformanceMetrics](undefined)
 - [RBACPermissionCheckParams](undefined)
 - [RBACPermissionCheckResult](undefined)
@@ -164,6 +157,11 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [RBACAuditLogResult](undefined)
 - [RBACContext](undefined)
 - [RBACResult](undefined)
+- [EventAppRoleData](undefined)
+- [RevokeEventAppRoleParams](undefined)
+- [GrantEventAppRoleParams](undefined)
+- [RoleManagementResult](undefined)
+- [AuthSessionData](undefined)
 - [StyleImport](undefined)
 - [ColorShade](undefined)
 - [ColorPalette](undefined)
@@ -175,13 +173,14 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [OrganisationMembership](undefined)
 - [UserProfile](undefined)
 - [OrganisationSecurityError](undefined)
-- [OrganisationContextType](undefined)
+- [BuildAppUrlOptions](undefined)
 - [LoggerConfig](undefined)
 - [ParsedAddress](undefined)
 - [AutocompleteOptions](undefined)
 - [StorageUploadOptions](undefined)
 - [StorageFileMetadata](undefined)
 - [StorageUploadResult](undefined)
+- [StorageUploadSuccess](undefined)
 - [StorageUrlOptions](undefined)
 - [StorageListOptions](undefined)
 - [StorageFileInfo](undefined)
@@ -194,12 +193,17 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [BadgeVariant](undefined)
 - [GetRowId](undefined)
 - [DataTableFeatureConfig](undefined)
+- [ImportHandlerResult](undefined)
 - [DialogSize](undefined)
 - [GlobalErrorHandler](undefined)
+- [FileUploadProps](undefined)
 - [NavigationMode](undefined)
+- [PaceAppLayoutProps](undefined)
 - [UseFileReferenceOptions](undefined)
 - [UseFileReferenceReturn](undefined)
 - [UseFileReferenceForRecordReturn](undefined)
+- [UnifiedAuthContextType](undefined)
+- [RBACConfig](undefined)
 - [AllPermissions](undefined)
 - [UUID](undefined)
 - [Operation](undefined)
@@ -216,6 +220,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [SessionType](undefined)
 - [AuditEventType](undefined)
 - [RBACFunctionResponse](undefined)
+- [ApiError](undefined)
+- [ApiResult](undefined)
+- [OrganisationContextType](undefined)
 
 ### Variables
 
@@ -228,6 +235,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [ALL\_PERMISSIONS](undefined)
 - [SECURE\_CLIENT\_SYMBOL](undefined)
 - [styleConfig](undefined)
+- [DEFAULT\_APP\_PORT\_MAP](undefined)
 - [logger](undefined)
 - [FILE\_SIZE\_LIMITS](undefined)
 - [DEFAULT\_FILE\_SIZE\_LIMIT](undefined)
@@ -245,6 +253,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [Alert](undefined)
 - [AlertTitle](undefined)
 - [AlertDescription](undefined)
+- [AppSwitcher](undefined)
 - [Avatar](undefined)
 - [Badge](undefined)
 - [Button](undefined)
@@ -267,6 +276,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [generateCSVContent](undefined)
 - [exportToCSVWithTableRows](undefined)
 - [exportToCSV](undefined)
+- [DatePickerWithTimezone](undefined)
 - [Dialog](undefined)
 - [DialogTrigger](undefined)
 - [DialogPortal](undefined)
@@ -280,6 +290,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [ErrorBoundaryProvider](undefined)
 - [ErrorBoundary](undefined)
 - [FileDisplay](undefined)
+- [usePublicFileDisplay](undefined)
+- [clearPublicFileDisplayCache](undefined)
+- [getPublicFileDisplayCacheStats](undefined)
 - [FileUpload](undefined)
 - [Footer](undefined)
 - [Form](undefined)
@@ -345,9 +358,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [usePublicEventLogo](undefined)
 - [clearPublicLogoCache](undefined)
 - [getPublicLogoCacheStats](undefined)
-- [usePublicFileDisplay](undefined)
-- [clearPublicFileDisplayCache](undefined)
-- [getPublicFileDisplayCacheStats](undefined)
 - [usePublicRouteParams](undefined)
 - [usePublicEventCode](undefined)
 - [generatePublicRoutePath](undefined)
@@ -356,8 +366,10 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [useEventService](undefined)
 - [useInactivityService](undefined)
 - [useOrganisationService](undefined)
+- [useAccessibleApps](undefined)
 - [useAppConfig](undefined)
 - [useEventTheme](undefined)
+- [useOptionalEvents](undefined)
 - [useEvents](undefined)
 - [useFileReference](undefined)
 - [useFileReferenceForRecord](undefined)
@@ -371,18 +383,18 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [useSessionRestoration](undefined)
 - [useToast](undefined)
 - [useZodForm](undefined)
-- [OrganisationProvider](undefined)
 - [EventServiceProvider](undefined)
 - [InactivityServiceProvider](undefined)
 - [OrganisationServiceProvider](undefined)
-- [useUnifiedAuth](undefined)
 - [UnifiedAuthProvider](undefined)
+- [useUnifiedAuth](undefined)
 - [withPermissionGuard](undefined)
 - [withAccessLevelGuard](undefined)
 - [withRoleGuard](undefined)
 - [createRBACMiddleware](undefined)
 - [createRBACExpressMiddleware](undefined)
 - [setupRBAC](undefined)
+- [isRBACInitialized](undefined)
 - [getAccessLevel](undefined)
 - [getPermissionMap](undefined)
 - [resolveAppContext](undefined)
@@ -395,17 +407,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [setGlobalAuditManager](undefined)
 - [getGlobalAuditManager](undefined)
 - [emitAuditEvent](undefined)
-- [validateDatabaseConfiguration](undefined)
-- [getCustomAuthCodeFixes](undefined)
-- [getDuplicateConfigFixes](undefined)
-- [getUnprotectedPageFixes](undefined)
-- [getDirectSupabaseAuthFixes](undefined)
-- [getQuickFixes](undefined)
-- [checkRuntimeCompliance](undefined)
-- [validateAndWarn](undefined)
-- [isRBACInitialized](undefined)
-- [getSetupIssues](undefined)
-- [validateRBACSetup](undefined)
 - [AccessDenied](undefined)
 - [NavigationGuard](undefined)
 - [PagePermissionGuard](undefined)
@@ -444,10 +445,17 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [parseAndNormalizeEventColours](undefined)
 - [applyPalette](undefined)
 - [clearPalette](undefined)
+- [ok](undefined)
+- [err](undefined)
+- [isOk](undefined)
+- [isErr](undefined)
 - [setAppConfig](undefined)
 - [getAppConfig](undefined)
 - [getCurrentAppName](undefined)
 - [getCurrentAppId](undefined)
+- [getAppPort](undefined)
+- [getAllAppPorts](undefined)
+- [buildAppUrl](undefined)
 - [useSessionTracking](undefined)
 - [cn](undefined)
 - [createLogger](undefined)
@@ -515,7 +523,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/types/file-reference.ts:33](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L33)
+[packages/core/src/types/file-reference.ts:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L34)
 
 ___
 
@@ -533,13 +541,7 @@ Logger levels for different types of messages
 
 ### ColumnFactory
 
-• **ColumnFactory**: Class ColumnFactory\<TData\>
-
-#### Type parameters
-
-| Name | Type |
-| :------ | :------ |
-| `TData` | extends DataRecord = DataRecord |
+• **ColumnFactory**: Class ColumnFactory
 
 #### Defined in
 
@@ -557,7 +559,7 @@ Handles emission of structured audit events for all RBAC operations.
 
 #### Defined in
 
-[packages/core/src/rbac/audit.ts:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L111)
+[packages/core/src/rbac/audit.ts:112](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L112)
 
 ___
 
@@ -573,7 +575,7 @@ Provides two-tier caching:
 
 #### Defined in
 
-[packages/core/src/rbac/cache.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/cache.ts#L20)
+[packages/core/src/rbac/cache.ts:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/cache.ts#L19)
 
 ___
 
@@ -588,7 +590,7 @@ This reduces complexity, improves performance, and enhances security.
 
 #### Defined in
 
-[packages/core/src/rbac/engine.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L50)
+[packages/core/src/rbac/engine.ts:52](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L52)
 
 ___
 
@@ -608,7 +610,7 @@ if working with event-required apps.
 
 #### Defined in
 
-[packages/core/src/rbac/secureClient.ts:28](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L28)
+[packages/core/src/rbac/secureClient.ts:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L27)
 
 ___
 
@@ -618,7 +620,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/types.ts:302](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L302)
+[packages/core/src/rbac/types.ts:304](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L304)
 
 ___
 
@@ -628,7 +630,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/types.ts:313](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L313)
+[packages/core/src/rbac/types.ts:315](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L315)
 
 ___
 
@@ -638,7 +640,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/types.ts:324](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L324)
+[packages/core/src/rbac/types.ts:326](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L326)
 
 ___
 
@@ -648,7 +650,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/types.ts:344](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L344)
+[packages/core/src/rbac/types.ts:346](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L346)
 
 ___
 
@@ -658,7 +660,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/types.ts:354](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L354)
+[packages/core/src/rbac/types.ts:356](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L356)
 
 ___
 
@@ -668,7 +670,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/types.ts:365](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L365)
+[packages/core/src/rbac/types.ts:367](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types.ts#L367)
 
 ___
 
@@ -693,7 +695,7 @@ StorageUtils class for convenient access to storage functions
 
 #### Defined in
 
-[packages/core/src/utils/storage/index.ts:56](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/index.ts#L56)
+[packages/core/src/utils/storage/storageUtils.ts:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/storageUtils.ts#L21)
 
 ## Interfaces
 
@@ -721,13 +723,25 @@ Ref type for AddressField component
 
 ___
 
+### AppSwitcherProps
+
+• **AppSwitcherProps**: Interface AppSwitcherProps
+
+Props for AppSwitcher component.
+
+#### Defined in
+
+[packages/core/src/components/AppSwitcher/AppSwitcher.tsx:24](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/AppSwitcher/AppSwitcher.tsx#L24)
+
+___
+
 ### AvatarProps
 
 • **AvatarProps**: Interface AvatarProps
 
 #### Defined in
 
-[packages/core/src/components/Avatar/Avatar.tsx:74](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L74)
+[packages/core/src/components/Avatar/Avatar.tsx:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L75)
 
 ___
 
@@ -770,7 +784,7 @@ Extends DayPickerProps with pace-core specific customizations.
 
 #### Defined in
 
-[packages/core/src/components/Calendar/Calendar.tsx:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Calendar/Calendar.tsx#L101)
+[packages/core/src/components/Calendar/Calendar.tsx:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Calendar/Calendar.tsx#L75)
 
 ___
 
@@ -783,7 +797,7 @@ Extends standard HTML attributes for semantic HTML elements.
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:72](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L72)
+[packages/core/src/components/Card/Card.tsx:73](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L73)
 
 ___
 
@@ -795,7 +809,7 @@ Props for the ContextSelector component.
 
 #### Defined in
 
-[packages/core/src/components/ContextSelector/ContextSelector.tsx:65](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ContextSelector/ContextSelector.tsx#L65)
+[packages/core/src/components/ContextSelector/ContextSelector.types.ts:14](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ContextSelector/ContextSelector.types.ts#L14)
 
 ___
 
@@ -813,70 +827,51 @@ Enhanced DataTable props with performance features
 
 #### Defined in
 
-[packages/core/src/components/DataTable/DataTable.tsx:297](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L297)
-
-___
-
-### DataRecord
-
-• **DataRecord**: Interface DataRecord
-
-Base data record type - all DataTable data must extend this
-This is a marker type that allows any object to be used as a data record
-Individual implementations should define more specific types
-
-#### Defined in
-
-[packages/core/src/components/DataTable/types.ts:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L49)
+[packages/core/src/components/DataTable/DataTable.tsx:295](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L295)
 
 ___
 
-### DataTableColumn
+### DataTableAction
 
-• **DataTableColumn**: Interface DataTableColumn\<TData\>
+• **DataTableAction**: Interface DataTableAction\<TData\>
 
-Enhanced column definition that extends TanStack's ColumnDef
+Action definition for DataTable rows.
+Defines custom actions that can be performed on table rows.
 
 #### Type parameters
 
 | Name | Type |
 | :------ | :------ |
-| `TData` | extends DataRecord = DataRecord |
+| `TData` | extends DataRecord |
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:245](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L245)
+[packages/core/src/components/DataTable/types/actions.ts:17](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/actions.ts#L17)
 
 ___
 
-### DataTableAction
-
-• **DataTableAction**: Interface DataTableAction\<TData\>
-
-Action definition for DataTable rows.
-Defines custom actions that can be performed on table rows.
+### DataTableToolbarButton
 
-#### Type parameters
+• **DataTableToolbarButton**: Interface DataTableToolbarButton
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `TData` | extends DataRecord | The type of data records in the table |
+Toolbar button definition
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:379](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L379)
+[packages/core/src/components/DataTable/types/actions.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/actions.ts#L58)
 
 ___
 
-### DataTableToolbarButton
+### DataRecord
 
-• **DataTableToolbarButton**: Interface DataTableToolbarButton
+• **DataRecord**: Interface DataRecord
 
-Toolbar button definition
+Base data record type - all DataTable data must extend this.
+Individual implementations should define more specific types.
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:419](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L419)
+[packages/core/src/components/DataTable/types/base.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/base.ts#L31)
 
 ___
 
@@ -888,19 +883,25 @@ Aggregate configuration
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:441](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L441)
+[packages/core/src/components/DataTable/types/columns.ts:12](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/columns.ts#L12)
 
 ___
 
-### EmptyStateConfig
+### DataTableColumn
 
-• **EmptyStateConfig**: Interface EmptyStateConfig
+• **DataTableColumn**: Interface DataTableColumn\<TData\>
 
-Empty state configuration
+Enhanced column definition that extends TanStack's ColumnDef
+
+#### Type parameters
+
+| Name | Type |
+| :------ | :------ |
+| `TData` | extends DataRecord = DataRecord |
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:450](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L450)
+[packages/core/src/components/DataTable/types/columns.ts:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/columns.ts#L21)
 
 ___
 
@@ -910,25 +911,6 @@ ___
 
 Options provided to the onExport handler for custom export functionality
 
-**`Example`**
-
-```tsx
-<DataTable
-  onExport={async (options) => {
-    // Export only specific columns
-    const customColumns = options.allColumns.filter(col => 
-      ['name', 'email', 'role'].includes(col.accessorKey || '')
-    );
-    await exportToCSVWithTableRows(
-      options.tableRows,
-      customColumns,
-      options.columnIdToTableColumn,
-      'custom-export.csv'
-    );
-  }}
-/>
-```
-
 #### Type parameters
 
 | Name | Type |
@@ -937,7 +919,29 @@ Options provided to the onExport handler for custom export functionality
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:628](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L628)
+[packages/core/src/components/DataTable/types/export.ts:13](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/export.ts#L13)
+
+___
+
+### EmptyStateConfig
+
+• **EmptyStateConfig**: Interface EmptyStateConfig
+
+Empty state configuration
+
+#### Defined in
+
+[packages/core/src/components/DataTable/types/features.ts:73](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/features.ts#L73)
+
+___
+
+### ImportSummary
+
+• **ImportSummary**: Interface ImportSummary
+
+#### Defined in
+
+[packages/core/src/components/DataTable/ui/modals/importModalPersistence.ts:15](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/ui/modals/importModalPersistence.ts#L15)
 
 ___
 
@@ -953,6 +957,18 @@ Column definition for export
 
 ___
 
+### DatePickerWithTimezoneProps
+
+• **DatePickerWithTimezoneProps**: Interface DatePickerWithTimezoneProps
+
+Props for the DatePickerWithTimezone component
+
+#### Defined in
+
+[packages/core/src/components/DatePickerWithTimezone/DatePickerWithTimezone.tsx:55](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DatePickerWithTimezone/DatePickerWithTimezone.tsx#L55)
+
+___
+
 ### DialogProps
 
 • **DialogProps**: Interface DialogProps
@@ -961,7 +977,7 @@ Props for the Dialog root component
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L167)
+[packages/core/src/components/Dialog/Dialog.tsx:142](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L142)
 
 ___
 
@@ -973,7 +989,7 @@ Props for the DialogTrigger component
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:178](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L178)
+[packages/core/src/components/Dialog/Dialog.tsx:153](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L153)
 
 ___
 
@@ -986,7 +1002,7 @@ Uses semantic HTML dialog element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:190](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L190)
+[packages/core/src/components/Dialog/Dialog.tsx:165](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L165)
 
 ___
 
@@ -998,21 +1014,7 @@ Props for the DialogPortal component
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:231](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L231)
-
-___
-
-### DialogCloseProps
-
-• **DialogCloseProps**: Interface DialogCloseProps
-
-Props for the DialogClose component
-
-#### Defined in
-
-[packages/core/src/components/Dialog/Dialog.tsx:239](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L239)
-
-[packages/core/src/components/Dialog/Dialog.tsx:1365](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1365)
+[packages/core/src/components/Dialog/Dialog.tsx:200](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L200)
 
 ___
 
@@ -1024,7 +1026,7 @@ Props for the DialogHeader component (semantic header element)
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:245](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L245)
+[packages/core/src/components/Dialog/Dialog.tsx:208](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L208)
 
 ___
 
@@ -1036,7 +1038,7 @@ Props for the DialogFooter component (semantic footer element)
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:254](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L254)
+[packages/core/src/components/Dialog/Dialog.tsx:217](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L217)
 
 ___
 
@@ -1048,7 +1050,19 @@ Props for the DialogBody component (semantic main element)
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:263](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L263)
+[packages/core/src/components/Dialog/Dialog.tsx:226](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L226)
+
+___
+
+### DialogCloseProps
+
+• **DialogCloseProps**: Interface DialogCloseProps
+
+Props for the DialogClose component
+
+#### Defined in
+
+[packages/core/src/components/Dialog/Dialog.tsx:582](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L582)
 
 ___
 
@@ -1084,7 +1098,7 @@ Props for ErrorBoundaryProvider component
 
 #### Defined in
 
-[packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx#L69)
+[packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.types.ts:36](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.types.ts#L36)
 
 ___
 
@@ -1094,20 +1108,30 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/FileDisplay/FileDisplay.tsx:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L57)
+[packages/core/src/components/FileDisplay/FileDisplay.tsx:15](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L15)
 
 ___
 
-### FileUploadProps
+### UsePublicFileDisplayReturn
+
+• **UsePublicFileDisplayReturn**: Interface UsePublicFileDisplayReturn
+
+Return value of the usePublicFileDisplay hook.
+Provides file URLs, references, loading state, error, and refetch function.
+
+#### Defined in
+
+[packages/core/src/components/FileDisplay/usePublicFileDisplay.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/usePublicFileDisplay.ts#L63)
+
+___
 
-• **FileUploadProps**: Interface FileUploadProps
+### UsePublicFileDisplayOptions
 
-Props for the FileUpload component.
-Configures file upload behavior including storage location, validation, and callbacks.
+• **UsePublicFileDisplayOptions**: Interface UsePublicFileDisplayOptions
 
 #### Defined in
 
-[packages/core/src/components/FileUpload/FileUpload.tsx:26](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L26)
+[packages/core/src/components/FileDisplay/usePublicFileDisplay.ts:82](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/usePublicFileDisplay.ts#L82)
 
 ___
 
@@ -1119,7 +1143,7 @@ Props for the Footer component.
 
 #### Defined in
 
-[packages/core/src/components/Footer/Footer.tsx:93](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L93)
+[packages/core/src/components/Footer/Footer.tsx:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L42)
 
 ___
 
@@ -1137,7 +1161,7 @@ Props for the Form component
 
 #### Defined in
 
-[packages/core/src/components/Form/Form.tsx:88](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L88)
+[packages/core/src/components/Form/Form.tsx:97](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L97)
 
 ___
 
@@ -1156,7 +1180,7 @@ Props for the FormField component
 
 #### Defined in
 
-[packages/core/src/components/Form/Form.tsx:533](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L533)
+[packages/core/src/components/Form/Form.tsx:333](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L333)
 
 ___
 
@@ -1232,16 +1256,39 @@ Navigation menu component props
 
 ___
 
-### PaceAppLayoutProps
+### PaceAppLayoutRouteConfigItem
+
+• **PaceAppLayoutRouteConfigItem**: Interface PaceAppLayoutRouteConfigItem
 
-• **PaceAppLayoutProps**: Interface PaceAppLayoutProps
+Route config item for role-based routing.
 
-Props for the PaceAppLayout component.
-Configures the application layout including navigation, header, and footer.
+#### Defined in
+
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:126](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L126)
+
+___
+
+### PaceAppLayoutPermissionConfig
+
+• **PaceAppLayoutPermissionConfig**: Interface PaceAppLayoutPermissionConfig
+
+Optional grouped permission options. When provided, overrides flat permission props.
+
+#### Defined in
+
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:143](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L143)
+
+___
+
+### PaceAppLayoutRoutingConfig
+
+• **PaceAppLayoutRoutingConfig**: Interface PaceAppLayoutRoutingConfig
+
+Optional grouped routing options. When provided, overrides flat routing props.
 
 #### Defined in
 
-[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L132)
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:158](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L158)
 
 ___
 
@@ -1253,7 +1300,7 @@ Props for the PaceLoginPage component.
 
 #### Defined in
 
-[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:137](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L137)
+[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L136)
 
 ___
 
@@ -1277,7 +1324,7 @@ Props for the ProtectedRoute component.
 
 #### Defined in
 
-[packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx#L85)
+[packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx:81](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx#L81)
 
 ___
 
@@ -1287,7 +1334,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:78](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L78)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:79](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L79)
 
 ___
 
@@ -1297,7 +1344,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:109](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L109)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:113](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L113)
 
 ___
 
@@ -1307,7 +1354,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:212](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L212)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:215](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L215)
 
 ___
 
@@ -1415,7 +1462,7 @@ Props for the UserMenu component.
 
 #### Defined in
 
-[packages/core/src/components/UserMenu/UserMenu.tsx:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L130)
+[packages/core/src/components/UserMenu/UserMenu.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L129)
 
 ___
 
@@ -1465,54 +1512,49 @@ ___
 
 ___
 
-### UsePublicFileDisplayReturn
+### UsePublicRouteParamsReturn
 
-• **UsePublicFileDisplayReturn**: Interface UsePublicFileDisplayReturn
+• **UsePublicRouteParamsReturn**: Interface UsePublicRouteParamsReturn
 
-Return value of the usePublicFileDisplay hook.
-Provides file URLs, references, loading state, error, and refetch function.
+Return value of the usePublicRouteParams hook.
+Provides event code, event ID, event data, loading state, error, and refetch function.
 
 #### Defined in
 
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L53)
+[packages/core/src/hooks/public/usePublicRouteParams.ts:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L68)
 
 ___
 
-### UsePublicFileDisplayOptions
+### AccessibleApp
 
-• **UsePublicFileDisplayOptions**: Interface UsePublicFileDisplayOptions
+• **AccessibleApp**: Interface AccessibleApp
+
+App information returned by the hook.
 
 #### Defined in
 
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:72](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L72)
+[packages/core/src/hooks/useAccessibleApps.ts:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAccessibleApps.ts#L21)
 
 ___
 
-### UsePublicRouteParamsReturn
+### UseAccessibleAppsReturn
 
-• **UsePublicRouteParamsReturn**: Interface UsePublicRouteParamsReturn
+• **UseAccessibleAppsReturn**: Interface UseAccessibleAppsReturn
 
-Return value of the usePublicRouteParams hook.
-Provides event code, event ID, event data, loading state, error, and refetch function.
+Return type for useAccessibleApps hook.
 
 #### Defined in
 
-[packages/core/src/hooks/public/usePublicRouteParams.ts:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L68)
+[packages/core/src/hooks/useAccessibleApps.ts:33](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAccessibleApps.ts#L33)
 
 ___
 
 ### UseFormDialogOptions
 
-• **UseFormDialogOptions**: Interface UseFormDialogOptions\<T\>
+• **UseFormDialogOptions**: Interface UseFormDialogOptions
 
 Options for configuring the useFormDialog hook behavior
 
-#### Type parameters
-
-| Name | Type |
-| :------ | :------ |
-| `T` | unknown |
-
 #### Defined in
 
 [packages/core/src/hooks/useFormDialog.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFormDialog.ts#L31)
@@ -1559,16 +1601,6 @@ ___
 
 ___
 
-### OrganisationProviderProps
-
-• **OrganisationProviderProps**: Interface OrganisationProviderProps
-
-#### Defined in
-
-[packages/core/src/providers/OrganisationProvider.tsx:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L21)
-
-___
-
 ### UserEventAccess
 
 • **UserEventAccess**: Interface UserEventAccess
@@ -1578,236 +1610,113 @@ Represents a user's access to a specific event.
 
 #### Defined in
 
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:35](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L35)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:43](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L43)
 
 ___
 
-### UnifiedAuthContextType
+### UnifiedAuthProviderProps
 
-• **UnifiedAuthContextType**: Interface UnifiedAuthContextType
+• **UnifiedAuthProviderProps**: Interface UnifiedAuthProviderProps
 
-Unified auth context type.
-Provides combined authentication, organisation, event, and inactivity state and methods.
+Props for the UnifiedAuthProvider component.
 
 #### Defined in
 
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L53)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L60)
 
 ___
 
-### UnifiedAuthProviderProps
-
-• **UnifiedAuthProviderProps**: Interface UnifiedAuthProviderProps
+### AccessDeniedProps
 
-Props for the UnifiedAuthProvider component.
+• **AccessDeniedProps**: Interface AccessDeniedProps
 
 #### Defined in
 
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L154)
+[packages/core/src/rbac/components/AccessDenied.tsx:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/AccessDenied.tsx#L53)
 
 ___
 
-### DatabaseIssue
+### NavigationGuardProps
 
-• **DatabaseIssue**: Interface DatabaseIssue
+• **NavigationGuardProps**: Interface NavigationGuardProps
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/database-validator.ts:13](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/database-validator.ts#L13)
+[packages/core/src/rbac/components/NavigationGuard.tsx:78](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationGuard.tsx#L78)
 
 ___
 
-### DatabaseComplianceResult
+### PagePermissionGuardProps
 
-• **DatabaseComplianceResult**: Interface DatabaseComplianceResult
+• **PagePermissionGuardProps**: Interface PagePermissionGuardProps
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/database-validator.ts:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/database-validator.ts#L19)
+[packages/core/src/rbac/components/PagePermissionGuard.tsx:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L83)
 
 ___
 
-### QuickFix
+### RBACLogger
 
-• **QuickFix**: Interface QuickFix
+• **RBACLogger**: Interface RBACLogger
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/quick-fix-suggestions.ts:10](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/quick-fix-suggestions.ts#L10)
+[packages/core/src/rbac/config.ts:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L85)
 
 ___
 
-### RuntimeComplianceResult
+### UseResolvedScopeOptions
 
-• **RuntimeComplianceResult**: Interface RuntimeComplianceResult
+• **UseResolvedScopeOptions**: Interface UseResolvedScopeOptions
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/runtime-compliance.ts:14](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/runtime-compliance.ts#L14)
+[packages/core/src/rbac/hooks/useResolvedScope.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L31)
 
 ___
 
-### SetupIssue
+### UseResolvedScopeReturn
 
-• **SetupIssue**: Interface SetupIssue
+• **UseResolvedScopeReturn**: Interface UseResolvedScopeReturn
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/setup-validator.ts:13](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/setup-validator.ts#L13)
+[packages/core/src/rbac/hooks/useResolvedScope.ts:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L42)
 
 ___
 
-### ComplianceResult
+### UseResourcePermissionsOptions
 
-• **ComplianceResult**: Interface ComplianceResult
+• **UseResourcePermissionsOptions**: Interface UseResourcePermissionsOptions
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/setup-validator.ts:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/setup-validator.ts#L19)
+[packages/core/src/rbac/hooks/useResourcePermissions.ts:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L53)
 
 ___
 
-### AccessDeniedProps
+### ResourcePermissions
 
-• **AccessDeniedProps**: Interface AccessDeniedProps
+• **ResourcePermissions**: Interface ResourcePermissions
 
 #### Defined in
 
-[packages/core/src/rbac/components/AccessDenied.tsx:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/AccessDenied.tsx#L46)
+[packages/core/src/rbac/hooks/useResourcePermissions.ts:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L60)
 
 ___
 
-### NavigationGuardProps
+### RBACPerformanceMetrics
 
-• **NavigationGuardProps**: Interface NavigationGuardProps
+• **RBACPerformanceMetrics**: Interface RBACPerformanceMetrics
 
 #### Defined in
 
-[packages/core/src/rbac/components/NavigationGuard.tsx:76](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationGuard.tsx#L76)
+[packages/core/src/rbac/performance.ts:10](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/performance.ts#L10)
 
 ___
 
-### PagePermissionGuardProps
-
-• **PagePermissionGuardProps**: Interface PagePermissionGuardProps
-
-#### Defined in
-
-[packages/core/src/rbac/components/PagePermissionGuard.tsx:79](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L79)
-
-___
-
-### RBACConfig
-
-• **RBACConfig**: Interface RBACConfig
-
-#### Defined in
-
-[packages/core/src/rbac/config.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L16)
-
-___
-
-### RBACLogger
-
-• **RBACLogger**: Interface RBACLogger
-
-#### Defined in
-
-[packages/core/src/rbac/config.ts:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L42)
-
-___
-
-### UseResolvedScopeOptions
-
-• **UseResolvedScopeOptions**: Interface UseResolvedScopeOptions
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResolvedScope.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L31)
-
-___
-
-### UseResolvedScopeReturn
-
-• **UseResolvedScopeReturn**: Interface UseResolvedScopeReturn
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResolvedScope.ts:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L42)
-
-___
-
-### UseResourcePermissionsOptions
-
-• **UseResourcePermissionsOptions**: Interface UseResourcePermissionsOptions
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResourcePermissions.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L54)
-
-___
-
-### ResourcePermissions
-
-• **ResourcePermissions**: Interface ResourcePermissions
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useResourcePermissions.ts:61](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L61)
-
-___
-
-### EventAppRoleData
-
-• **EventAppRoleData**: Interface EventAppRoleData
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useRoleManagement.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRoleManagement.ts#L64)
-
-___
-
-### RevokeEventAppRoleParams
-
-• **RevokeEventAppRoleParams**: Interface RevokeEventAppRoleParams
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useRoleManagement.ts:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRoleManagement.ts#L83)
-
-___
-
-### GrantEventAppRoleParams
-
-• **GrantEventAppRoleParams**: Interface GrantEventAppRoleParams
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useRoleManagement.ts:87](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRoleManagement.ts#L87)
-
-___
-
-### RoleManagementResult
-
-• **RoleManagementResult**: Interface RoleManagementResult
-
-#### Defined in
-
-[packages/core/src/rbac/hooks/useRoleManagement.ts:113](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRoleManagement.ts#L113)
-
-___
-
-### RBACPerformanceMetrics
-
-• **RBACPerformanceMetrics**: Interface RBACPerformanceMetrics
-
-#### Defined in
-
-[packages/core/src/rbac/performance.ts:10](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/performance.ts#L10)
-
-___
-
-### RBACPermissionCheckParams
+### RBACPermissionCheckParams
 
 • **RBACPermissionCheckParams**: Interface RBACPermissionCheckParams
 
@@ -2023,6 +1932,58 @@ ___
 
 ___
 
+### EventAppRoleData
+
+• **EventAppRoleData**: Interface EventAppRoleData
+
+#### Defined in
+
+[packages/core/src/rbac/types/roleManagement.ts:12](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types/roleManagement.ts#L12)
+
+___
+
+### RevokeEventAppRoleParams
+
+• **RevokeEventAppRoleParams**: Interface RevokeEventAppRoleParams
+
+#### Defined in
+
+[packages/core/src/rbac/types/roleManagement.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types/roleManagement.ts#L31)
+
+___
+
+### GrantEventAppRoleParams
+
+• **GrantEventAppRoleParams**: Interface GrantEventAppRoleParams
+
+#### Defined in
+
+[packages/core/src/rbac/types/roleManagement.ts:35](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types/roleManagement.ts#L35)
+
+___
+
+### RoleManagementResult
+
+• **RoleManagementResult**: Interface RoleManagementResult
+
+#### Defined in
+
+[packages/core/src/rbac/types/roleManagement.ts:61](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types/roleManagement.ts#L61)
+
+___
+
+### AuthSessionData
+
+• **AuthSessionData**: Interface AuthSessionData
+
+Success payload for auth methods: user and session (both null when signed out).
+
+#### Defined in
+
+[packages/core/src/services/interfaces/IAuthService.ts:15](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/services/interfaces/IAuthService.ts#L15)
+
+___
+
 ### StyleImport
 
 • **StyleImport**: Interface StyleImport
@@ -2094,7 +2055,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/types/file-reference.ts:6](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L6)
+[packages/core/src/types/file-reference.ts:7](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L7)
 
 ___
 
@@ -2104,7 +2065,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/types/file-reference.ts:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L19)
+[packages/core/src/types/file-reference.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L20)
 
 ___
 
@@ -2116,7 +2077,7 @@ Options for uploading a file with a file reference
 
 #### Defined in
 
-[packages/core/src/types/file-reference.ts:62](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L62)
+[packages/core/src/types/file-reference.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/file-reference.ts#L63)
 
 ___
 
@@ -2160,13 +2121,15 @@ ___
 
 ___
 
-### OrganisationContextType
+### BuildAppUrlOptions
+
+• **BuildAppUrlOptions**: Interface BuildAppUrlOptions
 
-• **OrganisationContextType**: Interface OrganisationContextType
+Options for building app URLs.
 
 #### Defined in
 
-[packages/core/src/types/organisation.ts:108](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L108)
+[packages/core/src/utils/app/buildAppUrl.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/buildAppUrl.ts#L16)
 
 ___
 
@@ -2238,13 +2201,25 @@ ___
 
 ___
 
+### StorageUploadSuccess
+
+• **StorageUploadSuccess**: Interface StorageUploadSuccess
+
+Success payload for uploadFile when using ApiResult.
+
+#### Defined in
+
+[packages/core/src/utils/storage/types.ts:47](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L47)
+
+___
+
 ### StorageUrlOptions
 
 • **StorageUrlOptions**: Interface StorageUrlOptions
 
 #### Defined in
 
-[packages/core/src/utils/storage/types.ts:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L46)
+[packages/core/src/utils/storage/types.ts:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L53)
 
 ___
 
@@ -2254,7 +2229,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/utils/storage/types.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L57)
+[packages/core/src/utils/storage/types.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L64)
 
 ___
 
@@ -2264,7 +2239,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/utils/storage/types.ts:74](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L74)
+[packages/core/src/utils/storage/types.ts:81](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L81)
 
 ___
 
@@ -2274,7 +2249,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/utils/storage/types.ts:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L83)
+[packages/core/src/utils/storage/types.ts:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L90)
 
 ___
 
@@ -2284,7 +2259,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/utils/storage/types.ts:89](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L89)
+[packages/core/src/utils/storage/types.ts:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L96)
 
 ___
 
@@ -2294,7 +2269,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/utils/storage/types.ts:93](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L93)
+[packages/core/src/utils/storage/types.ts:100](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/types.ts#L100)
 
 ## Type Aliases
 
@@ -2344,7 +2319,7 @@ RowId
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:61](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L61)
+[packages/core/src/components/DataTable/types/base.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/base.ts#L39)
 
 ___
 
@@ -2353,12 +2328,23 @@ ___
 Ƭ **DataTableFeatureConfig**: Partial\<DataTableFeatureFlags\>
 
 Consumer-facing feature configuration. All properties are optional and will be
-merged with defaultDataTableFeatures at runtime to keep the public API
-ergonomic while maintaining strict internal guarantees.
+merged with defaultDataTableFeatures at runtime.
+
+#### Defined in
+
+[packages/core/src/components/DataTable/types/features.ts:35](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types/features.ts#L35)
+
+___
+
+### ImportHandlerResult
+
+Ƭ **ImportHandlerResult**: void \| Promise\<void\> \| ImportSummary \| Promise\<ImportSummary\> \| Promise\<void \| ImportSummary\>
+
+Return type for onImport: void/Promise<void> or ImportSummary/Promise<ImportSummary>. Async handlers may return Promise<void | ImportSummary>.
 
 #### Defined in
 
-[packages/core/src/components/DataTable/types.ts:518](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/types.ts#L518)
+[packages/core/src/components/DataTable/ui/modals/importModalPersistence.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/ui/modals/importModalPersistence.ts#L23)
 
 ___
 
@@ -2370,7 +2356,7 @@ Dialog size variants
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L135)
+[packages/core/src/components/Dialog/Dialog.tsx:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L111)
 
 ___
 
@@ -2389,7 +2375,7 @@ Type definition for the global error handler function
 | Name | Type |
 | :------ | :------ |
 | `error` | Error |
-| `errorInfo` | React.ErrorInfo |
+| `errorInfo` | ErrorInfo |
 | `errorId` | string |
 | `componentName` | string |
 
@@ -2399,7 +2385,21 @@ void
 
 #### Defined in
 
-[packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx:43](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx#L43)
+[packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.types.ts:16](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.types.ts#L16)
+
+___
+
+### FileUploadProps
+
+Ƭ **FileUploadProps**: FileUploadPropsStorage & FileUploadPropsValidation & FileUploadPropsUI & FileUploadPropsCallbacks & FileUploadPropsChildren
+
+Props for the FileUpload component (ISP: composed from focused interfaces).
+Callers should pass the secure Supabase client (e.g. from useSecureSupabase()) when
+used in apps with RBAC. className is for instance-specific layout only (e.g. max-w-*).
+
+#### Defined in
+
+[packages/core/src/components/FileUpload/FileUpload.tsx:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L68)
 
 ___
 
@@ -2415,6 +2415,19 @@ Navigation mode type
 
 ___
 
+### PaceAppLayoutProps
+
+Ƭ **PaceAppLayoutProps**: PaceAppLayoutPropsLayout & PaceAppLayoutPropsPermission & PaceAppLayoutPropsRouting
+
+Props for the PaceAppLayout component (ISP: composed from focused interfaces).
+Permission and routing options can be passed either as flat props or via permissionConfig / routingConfig.
+
+#### Defined in
+
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:210](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L210)
+
+___
+
 ### UseFileReferenceOptions
 
 Ƭ **UseFileReferenceOptions**: `Object`
@@ -2429,35 +2442,19 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:487](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L487)
+[packages/core/src/hooks/useFileReference.ts:476](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L476)
 
 ___
 
 ### UseFileReferenceReturn
 
-Ƭ **UseFileReferenceReturn**: `Object`
-
-Return value of the useFileReference hook.
+Ƭ **UseFileReferenceReturn**: UseFileReferenceReturnState & UseFileReferenceReturnUpload & UseFileReferenceReturnQueries & UseFileReferenceReturnMutations
 
-#### Type declaration
-
-| Name | Type |
-| :------ | :------ |
-| `isLoading` | boolean |
-| `error` | string \| null |
-| `uploadFile` | Function |
-| `getFileReference` | Function |
-| `getFileUrl` | Function |
-| `getSignedUrl` | Function |
-| `updateFileReference` | Function |
-| `deleteFileReference` | Function |
-| `listFileReferences` | Function |
-| `getFileCount` | Function |
-| `clearError` | Function |
+Return value of the useFileReference hook (ISP: composed from focused interfaces).
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:496](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L496)
+[packages/core/src/hooks/useFileReference.ts:510](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L510)
 
 ___
 
@@ -2487,7 +2484,31 @@ Return value of the useFileReferenceForRecord hook.
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:513](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L513)
+[packages/core/src/hooks/useFileReference.ts:518](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L518)
+
+___
+
+### UnifiedAuthContextType
+
+Ƭ **UnifiedAuthContextType**: UnifiedAuthContextAuth & UnifiedAuthContextOrganisation & UnifiedAuthContextEvent & UnifiedAuthContextInactivity & UnifiedAuthContextUnified
+
+Unified auth context type (ISP: composed from focused interfaces).
+
+#### Defined in
+
+[packages/core/src/providers/services/UnifiedAuthContext.ts:92](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthContext.ts#L92)
+
+___
+
+### RBACConfig
+
+Ƭ **RBACConfig**: RBACConfigCore & RBACConfigCache & RBACConfigAudit & RBACConfigSecurity & RBACConfigPerformance
+
+RBAC config (ISP: composed from focused interfaces).
+
+#### Defined in
+
+[packages/core/src/rbac/config.ts:79](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L79)
 
 ___
 
@@ -2497,7 +2518,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:181](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L181)
+[packages/core/src/rbac/permissions.ts:178](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L178)
 
 ___
 
@@ -2693,6 +2714,56 @@ ___
 
 [packages/core/src/rbac/types/functions.ts:284](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/types/functions.ts#L284)
 
+___
+
+### ApiError
+
+Ƭ **ApiError**: `Object`
+
+Machine-readable error code and user-facing message for API failures.
+
+#### Type declaration
+
+| Name | Type |
+| :------ | :------ |
+| `code` | string |
+| `message` | string |
+| `details?` | object |
+
+#### Defined in
+
+[packages/core/src/types/api-result.ts:14](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/api-result.ts#L14)
+
+___
+
+### ApiResult
+
+Ƭ **ApiResult**: Object \| Object
+
+Type-safe result for async API functions: either success with data or failure with error.
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Defined in
+
+[packages/core/src/types/api-result.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/api-result.ts#L23)
+
+___
+
+### OrganisationContextType
+
+Ƭ **OrganisationContextType**: OrganisationContextState & OrganisationContextMethods & OrganisationContextEnhanced
+
+Organisation context type (ISP: composed from focused interfaces).
+
+#### Defined in
+
+[packages/core/src/types/organisation.ts:141](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/organisation.ts#L141)
+
 ## Variables
 
 ### rbacCache
@@ -2706,7 +2777,7 @@ You can create additional instances if needed for different contexts.
 
 #### Defined in
 
-[packages/core/src/rbac/cache.ts:303](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/cache.ts#L303)
+[packages/core/src/rbac/cache.ts:302](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/cache.ts#L302)
 
 ___
 
@@ -2728,7 +2799,7 @@ Cache key patterns for invalidation
 
 #### Defined in
 
-[packages/core/src/rbac/cache.ts:308](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/cache.ts#L308)
+[packages/core/src/rbac/cache.ts:307](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/cache.ts#L307)
 
 ___
 
@@ -2747,7 +2818,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L20)
+[packages/core/src/rbac/permissions.ts:17](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L17)
 
 ___
 
@@ -2781,7 +2852,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L31)
+[packages/core/src/rbac/permissions.ts:28](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L28)
 
 ___
 
@@ -2820,7 +2891,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L66)
+[packages/core/src/rbac/permissions.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L63)
 
 ___
 
@@ -2855,7 +2926,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:108](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L108)
+[packages/core/src/rbac/permissions.ts:105](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L105)
 
 ___
 
@@ -2937,7 +3008,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:174](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L174)
+[packages/core/src/rbac/permissions.ts:171](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L171)
 
 ___
 
@@ -2950,7 +3021,7 @@ This is attached to clients created by SecureSupabaseClient
 
 #### Defined in
 
-[packages/core/src/rbac/utils/clientSecurity.ts:17](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L17)
+[packages/core/src/rbac/utils/clientSecurity.ts:18](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L18)
 
 ___
 
@@ -2972,6 +3043,19 @@ ___
 
 ___
 
+### DEFAULT\_APP\_PORT\_MAP
+
+• **DEFAULT\_APP\_PORT\_MAP**: Record\<string, number\>
+
+Default port mapping for pace apps in development.
+Maps app names (uppercase) to their development server ports.
+
+#### Defined in
+
+[packages/core/src/utils/app/appPortMap.ts:15](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appPortMap.ts#L15)
+
+___
+
 ### logger
 
 • **logger**: `Object`
@@ -2991,7 +3075,7 @@ Default logger instance for convenience
 
 #### Defined in
 
-[packages/core/src/utils/core/logger.ts:163](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/core/logger.ts#L163)
+[packages/core/src/utils/core/logger.ts:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/core/logger.ts#L167)
 
 ___
 
@@ -3122,7 +3206,7 @@ JSX.Element - The rendered address field
 
 #### Defined in
 
-[packages/core/src/components/AddressField/AddressField.tsx:56](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/AddressField/AddressField.tsx#L56)
+[packages/core/src/components/AddressField/AddressField.tsx:266](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/AddressField/AddressField.tsx#L266)
 
 ___
 
@@ -3134,7 +3218,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | HTMLAttributes\<HTMLParagraphElement\> & Object & RefAttributes\<HTMLParagraphElement\> |
+| `props` | HTMLAttributes\<HTMLDivElement\> & Object & RefAttributes\<HTMLDivElement\> |
 
 #### Returns
 
@@ -3186,6 +3270,26 @@ ReactNode
 
 ___
 
+### AppSwitcher
+
+▸ **AppSwitcher**(`«destructured»`): null \| Element
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | AppSwitcherProps |
+
+#### Returns
+
+null \| Element
+
+#### Defined in
+
+[packages/core/src/components/AppSwitcher/AppSwitcher.tsx:155](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/AppSwitcher/AppSwitcher.tsx#L155)
+
+___
+
 ### Avatar
 
 ▸ **Avatar**(`props`): ReactNode
@@ -3202,7 +3306,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Avatar/Avatar.tsx:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L99)
+[packages/core/src/components/Avatar/Avatar.tsx:100](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L100)
 
 ___
 
@@ -3285,7 +3389,7 @@ JSX.Element - The rendered calendar element
 
 #### Defined in
 
-[packages/core/src/components/Calendar/Calendar.tsx:197](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Calendar/Calendar.tsx#L197)
+[packages/core/src/components/Calendar/Calendar.tsx:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Calendar/Calendar.tsx#L154)
 
 ___
 
@@ -3305,7 +3409,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:179](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L179)
+[packages/core/src/components/Card/Card.tsx:180](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L180)
 
 ___
 
@@ -3325,7 +3429,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:192](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L192)
+[packages/core/src/components/Card/Card.tsx:193](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L193)
 
 ___
 
@@ -3345,7 +3449,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:204](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L204)
+[packages/core/src/components/Card/Card.tsx:205](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L205)
 
 ___
 
@@ -3365,7 +3469,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:216](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L216)
+[packages/core/src/components/Card/Card.tsx:217](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L217)
 
 ___
 
@@ -3385,7 +3489,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:228](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L228)
+[packages/core/src/components/Card/Card.tsx:229](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L229)
 
 ___
 
@@ -3405,7 +3509,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:240](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L240)
+[packages/core/src/components/Card/Card.tsx:241](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L241)
 
 ___
 
@@ -3425,7 +3529,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:252](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L252)
+[packages/core/src/components/Card/Card.tsx:253](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L253)
 
 ___
 
@@ -3487,7 +3591,7 @@ null \| Element
 
 #### Defined in
 
-[packages/core/src/components/ContextSelector/ContextSelector.tsx:107](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ContextSelector/ContextSelector.tsx#L107)
+[packages/core/src/components/ContextSelector/ContextSelector.tsx:81](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ContextSelector/ContextSelector.tsx#L81)
 
 ___
 
@@ -3546,7 +3650,7 @@ Function
 
 An aggregation function that sums the specified field across all rows
 
-▸ \<`TRow`\>(`rows`, `column`): number
+▸ \<`TRow`\>(`rows`, `_column`): number
 
 ##### Type parameters
 
@@ -3559,7 +3663,7 @@ An aggregation function that sums the specified field across all rows
 | Name | Type |
 | :------ | :------ |
 | `rows` | TRow[] |
-| `column` | DataTableColumn\<TRow\> |
+| `_column` | DataTableColumn\<TRow\> |
 
 ##### Returns
 
@@ -3605,7 +3709,7 @@ Function
 
 An aggregation function that calculates the average of the specified field across all rows
 
-▸ \<`TRow`\>(`rows`, `column`): number
+▸ \<`TRow`\>(`rows`, `_column`): number
 
 ##### Type parameters
 
@@ -3618,7 +3722,7 @@ An aggregation function that calculates the average of the specified field acros
 | Name | Type |
 | :------ | :------ |
 | `rows` | TRow[] |
-| `column` | DataTableColumn\<TRow\> |
+| `_column` | DataTableColumn\<TRow\> |
 
 ##### Returns
 
@@ -3659,7 +3763,7 @@ Function
 
 An aggregation function that counts the number of rows
 
-▸ \<`TRow`\>(`rows`, `column`): number
+▸ \<`TRow`\>(`rows`, `_column`): number
 
 ##### Type parameters
 
@@ -3672,7 +3776,7 @@ An aggregation function that counts the number of rows
 | Name | Type |
 | :------ | :------ |
 | `rows` | TRow[] |
-| `column` | DataTableColumn\<TRow\> |
+| `_column` | DataTableColumn\<TRow\> |
 
 ##### Returns
 
@@ -3718,7 +3822,7 @@ Function
 
 An aggregation function that returns the minimum value of the specified field
 
-▸ \<`TRow`\>(`rows`, `column`): null \| number
+▸ \<`TRow`\>(`rows`, `_column`): null \| number
 
 ##### Type parameters
 
@@ -3731,7 +3835,7 @@ An aggregation function that returns the minimum value of the specified field
 | Name | Type |
 | :------ | :------ |
 | `rows` | TRow[] |
-| `column` | DataTableColumn\<TRow\> |
+| `_column` | DataTableColumn\<TRow\> |
 
 ##### Returns
 
@@ -3777,7 +3881,7 @@ Function
 
 An aggregation function that returns the maximum value of the specified field
 
-▸ \<`TRow`\>(`rows`, `column`): null \| number
+▸ \<`TRow`\>(`rows`, `_column`): null \| number
 
 ##### Type parameters
 
@@ -3790,7 +3894,7 @@ An aggregation function that returns the maximum value of the specified field
 | Name | Type |
 | :------ | :------ |
 | `rows` | TRow[] |
-| `column` | DataTableColumn\<TRow\> |
+| `_column` | DataTableColumn\<TRow\> |
 
 ##### Returns
 
@@ -3910,6 +4014,31 @@ Promise\<void\>
 
 ___
 
+### DatePickerWithTimezone
+
+▸ **DatePickerWithTimezone**(`props`): Element
+
+DatePickerWithTimezone component
+Date picker with timezone information display
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | DatePickerWithTimezoneProps | DatePickerWithTimezone configuration |
+
+#### Returns
+
+Element
+
+JSX.Element - The rendered date picker with timezone
+
+#### Defined in
+
+[packages/core/src/components/DatePickerWithTimezone/DatePickerWithTimezone.tsx:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DatePickerWithTimezone/DatePickerWithTimezone.tsx#L85)
+
+___
+
 ### Dialog
 
 ▸ **Dialog**(`props`): ReactNode
@@ -3926,7 +4055,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:312](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L312)
+[packages/core/src/components/Dialog/Dialog.tsx:263](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L263)
 
 ___
 
@@ -3938,7 +4067,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | DialogTriggerProps & RefAttributes\<HTMLElement\> |
+| `props` | DialogTriggerProps & RefAttributes\<HTMLButtonElement\> |
 
 #### Returns
 
@@ -3946,7 +4075,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:380](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L380)
+[packages/core/src/components/Dialog/Dialog.tsx:319](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L319)
 
 ___
 
@@ -3966,9 +4095,9 @@ ReactNode \| Promise\<ReactNode\>
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:417](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L417)
+[packages/core/src/components/Dialog/Dialog.tsx:357](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L357)
 
-[packages/core/src/components/Dialog/Dialog.tsx:429](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L429)
+[packages/core/src/components/Dialog/Dialog.tsx:369](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L369)
 
 ___
 
@@ -3990,7 +4119,7 @@ JSX.Element - The semantic dialog content with overlay and optional close button
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:641](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L641)
+[packages/core/src/components/Dialog/Dialog.tsx:510](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L510)
 
 ___
 
@@ -4010,7 +4139,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:1374](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1374)
+[packages/core/src/components/Dialog/Dialog.tsx:591](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L591)
 
 ___
 
@@ -4030,7 +4159,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:1426](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1426)
+[packages/core/src/components/Dialog/Dialog.tsx:634](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L634)
 
 ___
 
@@ -4050,7 +4179,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:1446](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1446)
+[packages/core/src/components/Dialog/Dialog.tsx:650](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L650)
 
 ___
 
@@ -4070,7 +4199,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:1548](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1548)
+[packages/core/src/components/Dialog/Dialog.tsx:751](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L751)
 
 ___
 
@@ -4090,7 +4219,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:1568](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1568)
+[packages/core/src/components/Dialog/Dialog.tsx:767](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L767)
 
 ___
 
@@ -4110,7 +4239,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:1607](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L1607)
+[packages/core/src/components/Dialog/Dialog.tsx:805](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L805)
 
 ___
 
@@ -4135,7 +4264,7 @@ The error boundary provider
 
 #### Defined in
 
-[packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx:107](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx#L107)
+[packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/ErrorBoundaryContext.tsx#L71)
 
 ___
 
@@ -4155,32 +4284,100 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/ErrorBoundary/index.ts:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/index.ts#L21)
+[packages/core/src/components/ErrorBoundary/index.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ErrorBoundary/index.ts#L20)
 
 ___
 
 ### FileDisplay
 
-▸ **FileDisplay**(`props`): Element
+▸ **FileDisplay**(`«destructured»`): Element
 
 File display component.
 Renders files from the file reference system with support for previews, downloads, and public/private access.
+Context-aware: uses PublicPageProvider for public pages and UnifiedAuthProvider for authenticated pages.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | FileDisplayProps |
+
+#### Returns
+
+Element
+
+#### Defined in
+
+[packages/core/src/components/FileDisplay/FileDisplay.tsx:335](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L335)
+
+___
+
+### usePublicFileDisplay
+
+▸ **usePublicFileDisplay**(`table_name`, `record_id`, `organisation_id`, `category`, `options`): UsePublicFileDisplayReturn
+
+Hook for accessing public file references
+
+This hook provides access to file references without requiring
+authentication. It only returns public files and generates public URLs.
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | FileDisplayProps | File display configuration |
+| `table_name` | undefined \| string | The table name containing the file reference |
+| `record_id` | undefined \| string | The record ID that owns the file(s) |
+| `organisation_id` | undefined \| string | The organisation ID for storage path |
+| `category` | undefined \| FileCategory | Optional file category to filter by (for single file mode) |
+| `options` | UsePublicFileDisplayOptions | Configuration options for caching and behavior |
 
 #### Returns
 
-Element
+UsePublicFileDisplayReturn
+
+Object containing file data, loading state, error, and refetch function
+
+#### Defined in
+
+[packages/core/src/components/FileDisplay/usePublicFileDisplay.ts:104](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/usePublicFileDisplay.ts#L104)
+
+___
+
+### clearPublicFileDisplayCache
+
+▸ **clearPublicFileDisplayCache**(): void
+
+Clear all cached public file data
+Useful for testing or when you need to force refresh all data
 
-The rendered file display
+#### Returns
+
+void
 
 #### Defined in
 
-[packages/core/src/components/FileDisplay/FileDisplay.tsx:961](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L961)
+[packages/core/src/components/FileDisplay/usePublicFileDisplay.ts:562](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/usePublicFileDisplay.ts#L562)
+
+___
+
+### getPublicFileDisplayCacheStats
+
+▸ **getPublicFileDisplayCacheStats**(): Object
+
+Get cache statistics for debugging
+
+#### Returns
+
+Object
+
+| Name | Type |
+| :------ | :------ |
+| `size` | number |
+| `keys` | string[] |
+
+#### Defined in
+
+[packages/core/src/components/FileDisplay/usePublicFileDisplay.ts:573](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/usePublicFileDisplay.ts#L573)
 
 ___
 
@@ -4200,7 +4397,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/FileUpload/FileUpload.tsx:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L58)
+[packages/core/src/components/FileUpload/FileUpload.tsx:74](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L74)
 
 ___
 
@@ -4220,7 +4417,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/Footer/Footer.tsx:199](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L199)
+[packages/core/src/components/Footer/Footer.tsx:82](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L82)
 
 ___
 
@@ -4265,7 +4462,7 @@ JSX.Element - The rendered form with FormProvider context
 
 #### Defined in
 
-[packages/core/src/components/Form/Form.tsx:147](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L147)
+[packages/core/src/components/Form/Form.tsx:156](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L156)
 
 ___
 
@@ -4357,32 +4554,27 @@ JSX.Element - The rendered form field with validation
 
 #### Defined in
 
-[packages/core/src/components/Form/Form.tsx:668](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L668)
+[packages/core/src/components/Form/Form.tsx:468](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L468)
 
 ___
 
 ### Header
 
-▸ **Header**(`props`): Element
-
-Header component for application layouts.
-Provides navigation, user menu, organisation/event selectors, and customizable branding.
+▸ **Header**(`«destructured»`): Element
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | HeaderProps | Header configuration |
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | HeaderProps |
 
 #### Returns
 
 Element
 
-The rendered header
-
 #### Defined in
 
-[packages/core/src/components/Header/Header.tsx:250](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L250)
+[packages/core/src/components/Header/Header.tsx:252](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L252)
 
 ___
 
@@ -4536,7 +4728,7 @@ React element with navigation menu functionality
 
 #### Defined in
 
-[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:393](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L393)
+[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:207](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L207)
 
 ___
 
@@ -4706,7 +4898,7 @@ function AdminApp() {
 
 #### Defined in
 
-[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:355](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L355)
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:426](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L426)
 
 ___
 
@@ -4728,7 +4920,7 @@ JSX.Element - The rendered login page with enhanced functionality
 
 #### Defined in
 
-[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:170](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L170)
+[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:169](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L169)
 
 ___
 
@@ -4776,7 +4968,7 @@ ___
 
 ### ProtectedRoute
 
-▸ **ProtectedRoute**(`props`): string \| number \| bigint \| true \| Iterable\<ReactNode, any, any\> \| Promise\<AwaitedReactNode\> \| Element
+▸ **ProtectedRoute**(`props`): string \| number \| bigint \| boolean \| Iterable\<ReactNode, any, any\> \| Promise\<AwaitedReactNode\> \| Element
 
 ProtectedRoute component that handles authentication and optional event selection.
 
@@ -4798,13 +4990,13 @@ Strategy:
 
 #### Returns
 
-string \| number \| bigint \| true \| Iterable\<ReactNode, any, any\> \| Promise\<AwaitedReactNode\> \| Element
+string \| number \| bigint \| boolean \| Iterable\<ReactNode, any, any\> \| Promise\<AwaitedReactNode\> \| Element
 
 React element with route protection logic
 
 #### Defined in
 
-[packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx#L129)
+[packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/ProtectedRoute/ProtectedRoute.tsx#L125)
 
 ___
 
@@ -4824,7 +5016,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L130)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:134](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L134)
 
 ___
 
@@ -4844,7 +5036,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:234](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L234)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:237](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L237)
 
 ___
 
@@ -4874,7 +5066,7 @@ React element with complete public page layout
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:287](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L287)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:350](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L350)
 
 ___
 
@@ -4903,7 +5095,7 @@ Element
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L75)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L60)
 
 ___
 
@@ -4921,7 +5113,7 @@ Public page context with environment variables
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L136)
+[packages/core/src/components/PublicLayout/usePublicPageContext.ts:18](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/usePublicPageContext.ts#L18)
 
 ___
 
@@ -4939,7 +5131,7 @@ True if we're in a public page context
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:151](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L151)
+[packages/core/src/components/PublicLayout/usePublicPageContext.ts:33](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/usePublicPageContext.ts#L33)
 
 ___
 
@@ -4983,7 +5175,7 @@ The rendered select trigger
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:233](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L233)
+[packages/core/src/components/Select/Select.tsx:243](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L243)
 
 ___
 
@@ -5005,7 +5197,7 @@ The rendered select value display
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:409](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L409)
+[packages/core/src/components/Select/Select.tsx:426](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L426)
 
 ___
 
@@ -5027,7 +5219,7 @@ The rendered select content
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:439](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L439)
+[packages/core/src/components/Select/Select.tsx:456](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L456)
 
 ___
 
@@ -5049,7 +5241,7 @@ The rendered select item
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:553](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L553)
+[packages/core/src/components/Select/Select.tsx:570](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L570)
 
 ___
 
@@ -5071,7 +5263,7 @@ The rendered select group
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:663](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L663)
+[packages/core/src/components/Select/Select.tsx:680](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L680)
 
 ___
 
@@ -5093,7 +5285,7 @@ The rendered select label
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:688](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L688)
+[packages/core/src/components/Select/Select.tsx:705](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L705)
 
 ___
 
@@ -5115,7 +5307,7 @@ The rendered select separator
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:707](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L707)
+[packages/core/src/components/Select/Select.tsx:724](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L724)
 
 ___
 
@@ -5752,7 +5944,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/components/UserMenu/UserMenu.tsx:138](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L138)
+[packages/core/src/components/UserMenu/UserMenu.tsx:137](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L137)
 
 ___
 
@@ -5890,75 +6082,6 @@ Object
 
 ___
 
-### usePublicFileDisplay
-
-▸ **usePublicFileDisplay**(`table_name`, `record_id`, `organisation_id`, `category`, `options`): UsePublicFileDisplayReturn
-
-Hook for accessing public file references
-
-This hook provides access to file references without requiring
-authentication. It only returns public files and generates public URLs.
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `table_name` | undefined \| string | The table name containing the file reference |
-| `record_id` | undefined \| string | The record ID that owns the file(s) |
-| `organisation_id` | undefined \| string | The organisation ID for storage path |
-| `category` | undefined \| FileCategory | Optional file category to filter by (for single file mode) |
-| `options` | UsePublicFileDisplayOptions | Configuration options for caching and behavior |
-
-#### Returns
-
-UsePublicFileDisplayReturn
-
-Object containing file data, loading state, error, and refetch function
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L94)
-
-___
-
-### clearPublicFileDisplayCache
-
-▸ **clearPublicFileDisplayCache**(): void
-
-Clear all cached public file data
-Useful for testing or when you need to force refresh all data
-
-#### Returns
-
-void
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:486](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L486)
-
-___
-
-### getPublicFileDisplayCacheStats
-
-▸ **getPublicFileDisplayCacheStats**(): Object
-
-Get cache statistics for debugging
-
-#### Returns
-
-Object
-
-| Name | Type |
-| :------ | :------ |
-| `size` | number |
-| `keys` | string[] |
-
-#### Defined in
-
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:497](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L497)
-
-___
-
 ### usePublicRouteParams
 
 ▸ **usePublicRouteParams**(`options?`): UsePublicRouteParamsReturn
@@ -6117,6 +6240,58 @@ OrganisationService
 
 ___
 
+### useAccessibleApps
+
+▸ **useAccessibleApps**(`currentAppName?`): UseAccessibleAppsReturn
+
+Hook to fetch all apps the current user has access to.
+
+Queries rbac_event_app_roles to find all apps where the user has active roles,
+then joins with rbac_apps to get app details. Excludes the current app.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `currentAppName?` | string | The name of the current app to exclude from results |
+
+#### Returns
+
+UseAccessibleAppsReturn
+
+Object with apps array, loading state, error, and refetch function
+
+**`Example`**
+
+```tsx
+import { useAccessibleApps } from '@jmruthers/pace-core';
+import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
+
+function AppSwitcher() {
+  const { appName } = useUnifiedAuth();
+  const { apps, loading, error } = useAccessibleApps(appName);
+
+  if (loading) return <div>Loading apps...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <select>
+      {apps.map(app => (
+        <option key={app.id} value={app.name}>
+          {app.displayName}
+        </option>
+      ))}
+    </select>
+  );
+}
+```
+
+#### Defined in
+
+[packages/core/src/hooks/useAccessibleApps.ts:77](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAccessibleApps.ts#L77)
+
+___
+
 ### useAppConfig
 
 ▸ **useAppConfig**(): UseAppConfigReturn
@@ -6132,30 +6307,60 @@ App configuration and loading state
 
 #### Defined in
 
-[packages/core/src/hooks/useAppConfig.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAppConfig.ts#L38)
+[packages/core/src/hooks/useAppConfig.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAppConfig.ts#L39)
+
+___
+
+### useEventTheme
+
+▸ **useEventTheme**(`event?`): void
+
+Hook that automatically applies event-specific theming.
+Works in authenticated mode (via EventProvider) or public page mode (via event prop).
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `event?` | null \| Event | Optional event object for public page mode. If not provided, uses EventProvider context. |
+
+#### Returns
+
+void
+
+#### Defined in
+
+[packages/core/src/hooks/useEventTheme.ts:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEventTheme.ts#L101)
+
+___
+
+### useOptionalEvents
 
-___
+▸ **useOptionalEvents**(): Object
 
-### useEventTheme
+Optional event context hook that never throws.
+Use when a component must work with or without EventServiceProvider (e.g. PaceAppLayout).
 
-▸ **useEventTheme**(`event?`): void
+#### Returns
 
-Hook that automatically applies event-specific theming.
-Works in authenticated mode (via EventProvider) or public page mode (via event prop).
+Object
 
-#### Parameters
+`{ selectedEvent: Event | null }` — when provider is absent, `selectedEvent` is always null.
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `event?` | null \| Event | Optional event object for public page mode. If not provided, uses EventProvider context. |
+| Name | Type |
+| :------ | :------ |
+| `selectedEvent` | Event \| null |
 
-#### Returns
+**`Example`**
 
-void
+```ts
+const { selectedEvent } = useOptionalEvents();
+// selectedEvent is null when outside EventServiceProvider; otherwise the current selected event.
+```
 
 #### Defined in
 
-[packages/core/src/hooks/useEventTheme.ts:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEventTheme.ts#L101)
+[packages/core/src/hooks/useEvents.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEvents.ts#L31)
 
 ___
 
@@ -6199,7 +6404,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/hooks/useEvents.ts:55](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEvents.ts#L55)
+[packages/core/src/hooks/useEvents.ts:95](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useEvents.ts#L95)
 
 ___
 
@@ -6240,7 +6445,7 @@ File reference service with upload, get, and URL methods
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L69)
+[packages/core/src/hooks/useFileReference.ts:91](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L91)
 
 ___
 
@@ -6279,7 +6484,7 @@ Object
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:252](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L252)
+[packages/core/src/hooks/useFileReference.ts:243](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L243)
 
 ___
 
@@ -6312,7 +6517,7 @@ Object
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:356](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L356)
+[packages/core/src/hooks/useFileReference.ts:347](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L347)
 
 ___
 
@@ -6356,7 +6561,7 @@ Object
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:434](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L434)
+[packages/core/src/hooks/useFileReference.ts:424](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L424)
 
 ___
 
@@ -6382,7 +6587,7 @@ Provides state management for form dialogs including:
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `options` | UseFormDialogOptions\<T\> | Configuration options for the hook |
+| `options` | UseFormDialogOptions | Configuration options for the hook |
 
 #### Returns
 
@@ -6435,7 +6640,7 @@ UseInactivityTrackerReturn
 
 #### Defined in
 
-[packages/core/src/hooks/useInactivityTracker.ts:131](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useInactivityTracker.ts#L131)
+[packages/core/src/hooks/useInactivityTracker.ts:218](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useInactivityTracker.ts#L218)
 
 ___
 
@@ -6473,7 +6678,7 @@ OrganisationSecurityHook
 
 #### Defined in
 
-[packages/core/src/hooks/useOrganisationSecurity.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useOrganisationSecurity.ts#L44)
+[packages/core/src/hooks/useOrganisationSecurity.ts:182](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useOrganisationSecurity.ts#L182)
 
 ___
 
@@ -6588,40 +6793,6 @@ UseFormReturn\<TypeOf\<T\>, any, TypeOf\<T\>\>
 
 ___
 
-### OrganisationProvider
-
-▸ **OrganisationProvider**(`«destructured»`): Element
-
-OrganisationProvider component
-
-Wraps OrganisationServiceProvider and automatically gets auth context.
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | OrganisationProviderProps |
-
-#### Returns
-
-Element
-
-**`Example`**
-
-```tsx
-<UnifiedAuthProvider supabaseClient={supabase} appName="my-app">
-  <OrganisationProvider>
-    <App />
-  </OrganisationProvider>
-</UnifiedAuthProvider>
-```
-
-#### Defined in
-
-[packages/core/src/providers/OrganisationProvider.tsx:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L42)
-
-___
-
 ### EventServiceProvider
 
 ▸ **EventServiceProvider**(`props`): Element
@@ -6643,7 +6814,7 @@ The event service provider
 
 #### Defined in
 
-[packages/core/src/providers/services/EventServiceProvider.tsx:52](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/EventServiceProvider.tsx#L52)
+[packages/core/src/providers/services/EventServiceProvider.tsx:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/EventServiceProvider.tsx#L38)
 
 ___
 
@@ -6668,7 +6839,7 @@ The inactivity service provider
 
 #### Defined in
 
-[packages/core/src/providers/services/InactivityServiceProvider.tsx:51](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/InactivityServiceProvider.tsx#L51)
+[packages/core/src/providers/services/InactivityServiceProvider.tsx:37](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/InactivityServiceProvider.tsx#L37)
 
 ___
 
@@ -6693,23 +6864,7 @@ The organisation service provider
 
 #### Defined in
 
-[packages/core/src/providers/services/OrganisationServiceProvider.tsx:48](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/OrganisationServiceProvider.tsx#L48)
-
-___
-
-### useUnifiedAuth
-
-▸ **useUnifiedAuth**(): UnifiedAuthContextType
-
-#### Returns
-
-UnifiedAuthContextType
-
-Unified authentication context
-
-#### Defined in
-
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:141](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L141)
+[packages/core/src/providers/services/OrganisationServiceProvider.tsx:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/OrganisationServiceProvider.tsx#L34)
 
 ___
 
@@ -6734,13 +6889,36 @@ The unified auth provider
 
 #### Defined in
 
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:756](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L756)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:398](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L398)
+
+___
+
+### useUnifiedAuth
+
+▸ **useUnifiedAuth**(): UnifiedAuthContextType
+
+Hook to access unified authentication context.
+Must be used within a UnifiedAuthProvider.
+
+#### Returns
+
+UnifiedAuthContextType
+
+Unified authentication context
+
+**`Throws`**
+
+Error if used outside UnifiedAuthProvider
+
+#### Defined in
+
+[packages/core/src/providers/services/useUnifiedAuth.ts:21](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/useUnifiedAuth.ts#L21)
 
 ___
 
 ### withPermissionGuard
 
-▸ **withPermissionGuard**\<`T`\>(`config`, `handler`): Function
+▸ **withPermissionGuard**\<`T`, `R`\>(`config`, `handler`): Function
 
 Permission Guard for Server Handlers
 
@@ -6750,7 +6928,8 @@ Wraps a server handler with permission checking.
 
 | Name | Type |
 | :------ | :------ |
-| `T` | extends any[] |
+| `T` | extends readonly [ServerRequest, unknown] |
+| `R` | `R` |
 
 #### Parameters
 
@@ -6767,7 +6946,7 @@ Function
 
 Wrapped handler function
 
-▸ (`...args`): Promise\<any\>
+▸ (`...args`): Promise\<R\>
 
 ##### Parameters
 
@@ -6777,7 +6956,7 @@ Wrapped handler function
 
 ##### Returns
 
-Promise\<any\>
+Promise\<R\>
 
 **`Example`**
 
@@ -6793,13 +6972,13 @@ const protectedHandler = withPermissionGuard(
 
 #### Defined in
 
-[packages/core/src/rbac/adapters.tsx:43](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L43)
+[packages/core/src/rbac/adapters.tsx:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L58)
 
 ___
 
 ### withAccessLevelGuard
 
-▸ **withAccessLevelGuard**\<`T`\>(`minLevel`, `handler`): Function
+▸ **withAccessLevelGuard**\<`T`, `R`\>(`minLevel`, `handler`): Function
 
 Access Level Guard for Server Handlers
 
@@ -6809,7 +6988,8 @@ Wraps a server handler with access level checking.
 
 | Name | Type |
 | :------ | :------ |
-| `T` | extends any[] |
+| `T` | extends readonly [ServerRequest, unknown] |
+| `R` | `R` |
 
 #### Parameters
 
@@ -6824,7 +7004,7 @@ Function
 
 Wrapped handler function
 
-▸ (`...args`): Promise\<any\>
+▸ (`...args`): Promise\<R\>
 
 ##### Parameters
 
@@ -6834,7 +7014,7 @@ Wrapped handler function
 
 ##### Returns
 
-Promise\<any\>
+Promise\<R\>
 
 **`Example`**
 
@@ -6850,13 +7030,13 @@ const adminHandler = withAccessLevelGuard(
 
 #### Defined in
 
-[packages/core/src/rbac/adapters.tsx:100](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L100)
+[packages/core/src/rbac/adapters.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L116)
 
 ___
 
 ### withRoleGuard
 
-▸ **withRoleGuard**\<`T`\>(`config`, `handler`): Function
+▸ **withRoleGuard**\<`T`, `R`\>(`config`, `handler`): Function
 
 Role Guard for Server Handlers
 
@@ -6867,7 +7047,8 @@ This is the primary middleware for routing protection as specified in the contra
 
 | Name | Type |
 | :------ | :------ |
-| `T` | extends any[] |
+| `T` | extends readonly [ServerRequest, unknown] |
+| `R` | `R` |
 
 #### Parameters
 
@@ -6886,7 +7067,7 @@ Function
 
 Wrapped handler function
 
-▸ (`...args`): Promise\<any\>
+▸ (`...args`): Promise\<R\>
 
 ##### Parameters
 
@@ -6896,7 +7077,7 @@ Wrapped handler function
 
 ##### Returns
 
-Promise\<any\>
+Promise\<R\>
 
 **`Example`**
 
@@ -6916,7 +7097,7 @@ const adminHandler = withRoleGuard(
 
 #### Defined in
 
-[packages/core/src/rbac/adapters.tsx:161](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L161)
+[packages/core/src/rbac/adapters.tsx:180](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L180)
 
 ___
 
@@ -6979,7 +7160,7 @@ export default createRBACMiddleware({
 
 #### Defined in
 
-[packages/core/src/rbac/adapters.tsx:284](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L284)
+[packages/core/src/rbac/adapters.tsx:303](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L303)
 
 ___
 
@@ -7038,7 +7219,7 @@ app.use(createRBACExpressMiddleware({
 
 #### Defined in
 
-[packages/core/src/rbac/adapters.tsx:351](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L351)
+[packages/core/src/rbac/adapters.tsx:368](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/adapters.tsx#L368)
 
 ___
 
@@ -7061,13 +7242,31 @@ void
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L45)
+[packages/core/src/rbac/api.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L57)
+
+___
+
+### isRBACInitialized
+
+▸ **isRBACInitialized**(): boolean
+
+Check if RBAC system is initialized
+
+#### Returns
+
+boolean
+
+True if RBAC is initialized
+
+#### Defined in
+
+[packages/core/src/rbac/api.ts:110](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L110)
 
 ___
 
 ### getAccessLevel
 
-▸ **getAccessLevel**(`input`, `appName?`): Promise\<AccessLevel\>
+▸ **getAccessLevel**(`input`, `appName?`): Promise\<ApiResult\<AccessLevel\>\>
 
 Get user's access level in a scope
 
@@ -7082,7 +7281,7 @@ Get user's access level in a scope
 
 #### Returns
 
-Promise\<AccessLevel\>
+Promise\<ApiResult\<AccessLevel\>\>
 
 Promise resolving to access level
 
@@ -7097,13 +7296,13 @@ const accessLevel = await getAccessLevel({
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L132)
+[packages/core/src/rbac/api.ts:143](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L143)
 
 ___
 
 ### getPermissionMap
 
-▸ **getPermissionMap**(`input`, `appName?`): Promise\<PermissionMap\>
+▸ **getPermissionMap**(`input`, `appName?`): Promise\<ApiResult\<PermissionMap\>\>
 
 Get user's permission map for a scope
 
@@ -7118,7 +7317,7 @@ Get user's permission map for a scope
 
 #### Returns
 
-Promise\<PermissionMap\>
+Promise\<ApiResult\<PermissionMap\>\>
 
 Promise resolving to permission map
 
@@ -7137,13 +7336,13 @@ const permissions = await getPermissionMap({
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:192](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L192)
+[packages/core/src/rbac/api.ts:203](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L203)
 
 ___
 
 ### resolveAppContext
 
-▸ **resolveAppContext**(`input`): Promise\<RBACAppContext \| null\>
+▸ **resolveAppContext**(`input`): Promise\<ApiResult\<RBACAppContext \| null\>\>
 
 #### Parameters
 
@@ -7155,17 +7354,17 @@ ___
 
 #### Returns
 
-Promise\<RBACAppContext \| null\>
+Promise\<ApiResult\<RBACAppContext \| null\>\>
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:226](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L226)
+[packages/core/src/rbac/api.ts:237](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L237)
 
 ___
 
 ### getRoleContext
 
-▸ **getRoleContext**(`input`, `appName?`): Promise\<RBACRoleContext\>
+▸ **getRoleContext**(`input`, `appName?`): Promise\<ApiResult\<RBACRoleContext\>\>
 
 #### Parameters
 
@@ -7178,17 +7377,17 @@ ___
 
 #### Returns
 
-Promise\<RBACRoleContext\>
+Promise\<ApiResult\<RBACRoleContext\>\>
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:239](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L239)
+[packages/core/src/rbac/api.ts:250](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L250)
 
 ___
 
 ### isPermitted
 
-▸ **isPermitted**(`input`, `appName?`, `precomputedSuperAdmin?`): Promise\<boolean\>
+▸ **isPermitted**(`input`, `appName?`, `precomputedSuperAdmin?`): Promise\<ApiResult\<boolean\>\>
 
 Check if user has a specific permission
 
@@ -7202,7 +7401,7 @@ Check if user has a specific permission
 
 #### Returns
 
-Promise\<boolean\>
+Promise\<ApiResult\<boolean\>\>
 
 Promise resolving to permission result
 
@@ -7219,13 +7418,13 @@ const canManage = await isPermitted({
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:285](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L285)
+[packages/core/src/rbac/api.ts:301](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L301)
 
 ___
 
 ### isPermittedCached
 
-▸ **isPermittedCached**(`input`, `appName?`): Promise\<boolean\>
+▸ **isPermittedCached**(`input`, `appName?`): Promise\<ApiResult\<boolean\>\>
 
 Check if user has a specific permission (cached version)
 
@@ -7241,19 +7440,19 @@ and checks cache before making new requests. Uses session cache for page-level c
 
 #### Returns
 
-Promise\<boolean\>
+Promise\<ApiResult\<boolean\>\>
 
 Promise resolving to permission result
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:455](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L455)
+[packages/core/src/rbac/api.ts:465](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L465)
 
 ___
 
 ### hasAnyPermission
 
-▸ **hasAnyPermission**(`input`): Promise\<boolean\>
+▸ **hasAnyPermission**(`input`): Promise\<ApiResult\<boolean\>\>
 
 Check if user has any of the specified permissions
 
@@ -7269,19 +7468,19 @@ Check if user has any of the specified permissions
 
 #### Returns
 
-Promise\<boolean\>
+Promise\<ApiResult\<boolean\>\>
 
 Promise resolving to true if user has any permission
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:499](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L499)
+[packages/core/src/rbac/api.ts:506](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L506)
 
 ___
 
 ### hasAllPermissions
 
-▸ **hasAllPermissions**(`input`): Promise\<boolean\>
+▸ **hasAllPermissions**(`input`): Promise\<ApiResult\<boolean\>\>
 
 Check if user has all of the specified permissions
 
@@ -7297,13 +7496,13 @@ Check if user has all of the specified permissions
 
 #### Returns
 
-Promise\<boolean\>
+Promise\<ApiResult\<boolean\>\>
 
 Promise resolving to true if user has all permissions
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:527](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L527)
+[packages/core/src/rbac/api.ts:536](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L536)
 
 ___
 
@@ -7313,239 +7512,39 @@ ___
 
 Create an audit manager instance
 
-#### Parameters
-
-| Name | Type | Default value | Description |
-| :------ | :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<Database, "public", "public", Object, Object\> | `undefined` | Supabase client |
-| `useBatching` | boolean | `true` | Whether to use batched audit logging (default: true) |
-| `batchConfig?` | Object | `undefined` | Optional batch configuration |
-| `batchConfig.batchWindow?` | number | `undefined` | - |
-| `batchConfig.batchSize?` | number | `undefined` | - |
-
-#### Returns
-
-RBACAuditManager
-
-RBACAuditManager instance
-
-#### Defined in
-
-[packages/core/src/rbac/audit.ts:444](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L444)
-
-___
-
-### setGlobalAuditManager
-
-▸ **setGlobalAuditManager**(`manager`): void
-
-Set the global audit manager
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `manager` | RBACAuditManager | Audit manager instance |
-
-#### Returns
-
-void
-
-#### Defined in
-
-[packages/core/src/rbac/audit.ts:464](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L464)
-
-___
-
-### getGlobalAuditManager
-
-▸ **getGlobalAuditManager**(): RBACAuditManager \| null
-
-Get the global audit manager
-
-#### Returns
-
-RBACAuditManager \| null
-
-Global audit manager or null if not set
-
-#### Defined in
-
-[packages/core/src/rbac/audit.ts:473](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L473)
-
-___
-
-### emitAuditEvent
-
-▸ **emitAuditEvent**(`event`): Promise\<void\>
-
-Emit an audit event using the global audit manager
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `event` | AuditEventPayload | Audit event payload |
-
-#### Returns
-
-Promise\<void\>
-
-#### Defined in
-
-[packages/core/src/rbac/audit.ts:482](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L482)
-
-___
-
-### validateDatabaseConfiguration
-
-▸ **validateDatabaseConfiguration**(`supabase`, `appName`): Promise\<DatabaseComplianceResult\>
-
-Validate database configuration
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<Database, "public", "public", Object, Object\> | Supabase client |
-| `appName` | string | Application name to validate |
-
-#### Returns
-
-Promise\<DatabaseComplianceResult\>
-
-Database compliance result
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/database-validator.ts:36](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/database-validator.ts#L36)
-
-___
-
-### getCustomAuthCodeFixes
-
-▸ **getCustomAuthCodeFixes**(`customCodeName`, `type`): QuickFix
-
-Get quick fix suggestions for custom auth code
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `customCodeName` | string |
-| `type` | "hook" \| "component" \| "util" |
-
-#### Returns
-
-QuickFix
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/quick-fix-suggestions.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/quick-fix-suggestions.ts#L20)
-
-___
-
-### getDuplicateConfigFixes
-
-▸ **getDuplicateConfigFixes**(): QuickFix
-
-Get quick fix suggestions for duplicate Supabase config
-
-#### Returns
-
-QuickFix
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/quick-fix-suggestions.ts:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/quick-fix-suggestions.ts#L99)
-
-___
-
-### getUnprotectedPageFixes
-
-▸ **getUnprotectedPageFixes**(): QuickFix
-
-Get quick fix suggestions for unprotected pages
-
-#### Returns
-
-QuickFix
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/quick-fix-suggestions.ts:132](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/quick-fix-suggestions.ts#L132)
-
-___
-
-### getDirectSupabaseAuthFixes
-
-▸ **getDirectSupabaseAuthFixes**(): QuickFix
-
-Get quick fix suggestions for direct Supabase auth usage
-
-#### Returns
-
-QuickFix
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/quick-fix-suggestions.ts:161](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/quick-fix-suggestions.ts#L161)
-
-___
-
-### getQuickFixes
-
-▸ **getQuickFixes**(`issueType`, `details?`): QuickFix[]
-
-Get all quick fix suggestions for a compliance issue
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `issueType` | string |
-| `details?` | Record\<string, any\> |
-
-#### Returns
-
-QuickFix[]
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/quick-fix-suggestions.ts:187](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/quick-fix-suggestions.ts#L187)
-
-___
-
-### checkRuntimeCompliance
-
-▸ **checkRuntimeCompliance**(): RuntimeComplianceResult
-
-Check runtime compliance
+#### Parameters
 
-This function checks if the RBAC system is properly set up and logs warnings
-to the console if issues are found. This is intended for development-time
-validation only.
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `supabase` | SupabaseClient\<Database, "public", "public", Object, Object\> | `undefined` | Supabase client |
+| `useBatching` | boolean | `true` | Whether to use batched audit logging (default: true) |
+| `batchConfig?` | Object | `undefined` | Optional batch configuration |
+| `batchConfig.batchWindow?` | number | `undefined` | - |
+| `batchConfig.batchSize?` | number | `undefined` | - |
 
 #### Returns
 
-RuntimeComplianceResult
+RBACAuditManager
 
-Runtime compliance result
+RBACAuditManager instance
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/runtime-compliance.ts:36](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/runtime-compliance.ts#L36)
+[packages/core/src/rbac/audit.ts:450](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L450)
 
 ___
 
-### validateAndWarn
+### setGlobalAuditManager
+
+▸ **setGlobalAuditManager**(`manager`): void
 
-▸ **validateAndWarn**(): void
+Set the global audit manager
 
-Validate and warn about RBAC setup issues
+#### Parameters
 
-This is a convenience function that checks compliance and logs warnings.
-Call this in development mode to get early warnings about setup issues.
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `manager` | RBACAuditManager | Audit manager instance |
 
 #### Returns
 
@@ -7553,61 +7552,49 @@ void
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/runtime-compliance.ts:74](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/runtime-compliance.ts#L74)
+[packages/core/src/rbac/audit.ts:470](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L470)
 
 ___
 
-### isRBACInitialized
+### getGlobalAuditManager
 
-▸ **isRBACInitialized**(): boolean
+▸ **getGlobalAuditManager**(): RBACAuditManager \| null
 
-Check if RBAC system is initialized
+Get the global audit manager
 
 #### Returns
 
-boolean
+RBACAuditManager \| null
 
-true if RBAC is initialized, false otherwise
+Global audit manager or null if not set
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/setup-validator.ts:29](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/setup-validator.ts#L29)
+[packages/core/src/rbac/audit.ts:479](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L479)
 
 ___
 
-### getSetupIssues
-
-▸ **getSetupIssues**(): SetupIssue[]
-
-Get setup issues
-
-#### Returns
-
-SetupIssue[]
-
-Array of setup issues
-
-#### Defined in
-
-[packages/core/src/rbac/compliance/setup-validator.ts:47](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/setup-validator.ts#L47)
+### emitAuditEvent
 
-___
+▸ **emitAuditEvent**(`event`): Promise\<ApiResult\<void\>\>
 
-### validateRBACSetup
+Emit an audit event using the global audit manager
 
-▸ **validateRBACSetup**(): ComplianceResult
+#### Parameters
 
-Validate RBAC setup
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `event` | AuditEventPayload | Audit event payload |
 
 #### Returns
 
-ComplianceResult
+Promise\<ApiResult\<void\>\>
 
-Compliance result with issues and recommendations
+ApiResult for consistency with API error handling
 
 #### Defined in
 
-[packages/core/src/rbac/compliance/setup-validator.ts:122](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/compliance/setup-validator.ts#L122)
+[packages/core/src/rbac/audit.ts:489](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/audit.ts#L489)
 
 ___
 
@@ -7634,7 +7621,7 @@ JSX.Element - The rendered access denied page
 
 #### Defined in
 
-[packages/core/src/rbac/components/AccessDenied.tsx:78](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/AccessDenied.tsx#L78)
+[packages/core/src/rbac/components/AccessDenied.tsx:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/AccessDenied.tsx#L85)
 
 ___
 
@@ -7662,7 +7649,7 @@ React element with navigation permission enforcement
 
 #### Defined in
 
-[packages/core/src/rbac/components/NavigationGuard.tsx:115](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationGuard.tsx#L115)
+[packages/core/src/rbac/components/NavigationGuard.tsx:117](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationGuard.tsx#L117)
 
 ___
 
@@ -7682,7 +7669,7 @@ ReactNode
 
 #### Defined in
 
-[packages/core/src/rbac/components/PagePermissionGuard.tsx:521](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L521)
+[packages/core/src/rbac/components/PagePermissionGuard.tsx:328](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L328)
 
 ___
 
@@ -7702,7 +7689,7 @@ RBACConfig
 
 #### Defined in
 
-[packages/core/src/rbac/config.ts:121](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L121)
+[packages/core/src/rbac/config.ts:164](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L164)
 
 ___
 
@@ -7716,7 +7703,7 @@ RBACConfig \| null
 
 #### Defined in
 
-[packages/core/src/rbac/config.ts:126](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L126)
+[packages/core/src/rbac/config.ts:169](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L169)
 
 ___
 
@@ -7730,7 +7717,7 @@ RBACLogger
 
 #### Defined in
 
-[packages/core/src/rbac/config.ts:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L130)
+[packages/core/src/rbac/config.ts:173](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L173)
 
 ___
 
@@ -7744,7 +7731,7 @@ boolean
 
 #### Defined in
 
-[packages/core/src/rbac/config.ts:134](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L134)
+[packages/core/src/rbac/config.ts:177](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L177)
 
 ___
 
@@ -7758,7 +7745,7 @@ boolean
 
 #### Defined in
 
-[packages/core/src/rbac/config.ts:138](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L138)
+[packages/core/src/rbac/config.ts:181](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/config.ts#L181)
 
 ___
 
@@ -7783,7 +7770,7 @@ RBACEngine instance
 
 #### Defined in
 
-[packages/core/src/rbac/engine.ts:640](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L640)
+[packages/core/src/rbac/engine.ts:680](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L680)
 
 ___
 
@@ -7819,21 +7806,21 @@ Access level state and methods
 function MyComponent() {
   const { accessLevel, isLoading, error } = useAccessLevel(userId, scope);
 
-  if (isLoading) return <div>Loading access level...</div>;
-  if (error) return <div>Error: {error.message}</div>;
+  if (isLoading) return null; // or use a loading component
+  if (error) return <Alert variant="destructive"><AlertDescription>Error: {error.message}</AlertDescription></Alert>;
 
   return (
-    <div>
-      Access Level: {accessLevel}
+    <>
+      <p>Access Level: {accessLevel}</p>
       {accessLevel >= AccessLevel.ADMIN && <AdminPanel />}
-    </div>
+    </>
   );
 }
 ```
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/permissions/useAccessLevel.ts:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/permissions/useAccessLevel.ts#L32)
+[packages/core/src/rbac/hooks/permissions/useAccessLevel.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/permissions/useAccessLevel.ts#L31)
 
 ___
 
@@ -7874,16 +7861,16 @@ Permission check state and methods
 function MyComponent() {
   const { can, isLoading, error } = useCan(userId, scope, 'read:users');
 
-  if (isLoading) return <div>Checking permission...</div>;
-  if (error) return <div>Error: {error.message}</div>;
+  if (isLoading) return null; // or use a loading component
+  if (error) return <Alert variant="destructive"><AlertDescription>Error: {error.message}</AlertDescription></Alert>;
 
-  return can ? <UserList /> : <div>Access denied</div>;
+  return can ? <UserList /> : <AccessDenied />;
 }
 ```
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/permissions/useCan.ts:31](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/permissions/useCan.ts#L31)
+[packages/core/src/rbac/hooks/permissions/useCan.ts:109](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/permissions/useCan.ts#L109)
 
 ___
 
@@ -7925,15 +7912,15 @@ function MyComponent() {
     ['read:users', 'create:users', 'update:users']
   );
 
-  if (isLoading) return <div>Checking permissions...</div>;
-  if (error) return <div>Error: {error.message}</div>;
+  if (isLoading) return null; // or use a loading component
+  if (error) return <Alert variant="destructive"><AlertDescription>Error: {error.message}</AlertDescription></Alert>;
 
   return (
-    <div>
+    <>
       {results['read:users'] && <UserList />}
       {results['create:users'] && <CreateUserButton />}
       {results['update:users'] && <EditUserButton />}
-    </div>
+    </>
   );
 }
 ```
@@ -7986,21 +7973,21 @@ function MyComponent() {
     appId
   );
 
-  if (isLoading) return <div>Loading...</div>;
-  if (error) return <div>Error: {error.message}</div>;
+  if (isLoading) return null; // or use a loading component
+  if (error) return <Alert variant="destructive"><AlertDescription>Error: {error.message}</AlertDescription></Alert>;
 
   return (
-    <div>
+    <>
       {permissions['read:users'] && <UserList />}
       {permissions['create:users'] && <CreateUserButton />}
-    </div>
+    </>
   );
 }
 ```
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/permissions/usePermissions.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/permissions/usePermissions.ts#L38)
+[packages/core/src/rbac/hooks/permissions/usePermissions.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/permissions/usePermissions.ts#L39)
 
 ___
 
@@ -8020,7 +8007,7 @@ UserRBACContext
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/useRBAC.ts:53](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRBAC.ts#L53)
+[packages/core/src/rbac/hooks/useRBAC.ts:175](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRBAC.ts#L175)
 
 ___
 
@@ -8071,79 +8058,20 @@ ___
 
 ▸ **useResourcePermissions**(`resource`, `options?`): ResourcePermissions
 
-Hook to check permissions for a specific resource
-
-This hook encapsulates the common pattern of checking create/update/delete/read
-permissions for a resource type. It handles scope resolution, user context,
-and provides a simple API for permission checking.
-
-**Page Permission Support:**
-When an `appId` is available in the resolved scope, the hook automatically:
-1. Waits for scope resolution to complete (including `appId` being set)
-2. Constructs permission strings with the `page.` prefix (e.g., `create:page.planning`)
-3. Passes the resource name as `pageId` to enable page-based permission checks
-
-This ensures permission strings match the format returned by `rbac_permissions_get`
-(e.g., `create:page.planning`) rather than resource-based format (e.g., `create:planning`).
-
-**Scope Resolution Timing:**
-The hook waits for scope resolution to complete before constructing permission strings.
-This prevents timing issues where permission checks use the wrong format (e.g., `delete:planning`
-instead of `delete:page.planning`) when `appId` is not yet available in the scope.
-
-The RPC function `rbac_check_permission_simplified` will resolve the page name to a page ID
-and check page permissions if the resource matches a registered page in `rbac_app_pages`.
-If the resource is not a registered page, it will fall back to resource-based permission checking.
-
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `resource` | string | The resource name (e.g., 'contacts', 'risks', 'planning') Can be a resource name or a page name registered in rbac_app_pages |
-| `options` | UseResourcePermissionsOptions | Optional configuration |
+| Name | Type |
+| :------ | :------ |
+| `resource` | string |
+| `options` | UseResourcePermissionsOptions |
 
 #### Returns
 
 ResourcePermissions
 
-Object with permission check functions and scope
-
-**`Example`**
-
-```tsx
-function useContacts() {
-  const { canCreate, canUpdate, canDelete } = useResourcePermissions('contacts');
-  
-  const addContact = async (data: ContactData) => {
-    if (!canCreate('contacts')) {
-      throw new Error("Permission denied");
-    }
-    // ... perform mutation
-  };
-}
-```
-
-**`Example`**
-
-```tsx
-// Works with page names when appId is available in scope
-function usePlanning() {
-  const { canCreate, canUpdate, canDelete } = useResourcePermissions('planning');
-  
-  // Will check page permissions if 'planning' is registered in rbac_app_pages
-  // Falls back to resource permissions if not a registered page
-  const deleteItem = async (id: string) => {
-    if (!canDelete('planning')) {
-      throw new Error("Permission denied");
-    }
-    // ... perform deletion
-  };
-}
-```
-
 #### Defined in
 
-[packages/core/src/rbac/hooks/useResourcePermissions.ts:141](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L141)
+[packages/core/src/rbac/hooks/useResourcePermissions.ts:177](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResourcePermissions.ts#L177)
 
 ___
 
@@ -8169,7 +8097,7 @@ Object
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/useRoleManagement.ts:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRoleManagement.ts#L120)
+[packages/core/src/rbac/hooks/useRoleManagement.ts:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRoleManagement.ts#L101)
 
 ___
 
@@ -8207,7 +8135,7 @@ function MyComponent() {
   const supabase = useSecureSupabase();
   
   if (!supabase) {
-    return <div>Loading context...</div>;
+    return null; // or use a loading component
   }
   
   // Use supabase client - organisation context is automatically injected
@@ -8217,7 +8145,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/useSecureSupabase.ts:208](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useSecureSupabase.ts#L208)
+[packages/core/src/rbac/hooks/useSecureSupabase.ts:209](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useSecureSupabase.ts#L209)
 
 ___
 
@@ -8383,7 +8311,7 @@ True if valid, false otherwise
 
 #### Defined in
 
-[packages/core/src/rbac/permissions.ts:159](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L159)
+[packages/core/src/rbac/permissions.ts:156](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/permissions.ts#L156)
 
 ___
 
@@ -8399,7 +8327,7 @@ void
 
 #### Defined in
 
-[packages/core/src/rbac/request-deduplication.ts:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/request-deduplication.ts#L75)
+[packages/core/src/rbac/request-deduplication.ts:76](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/request-deduplication.ts#L76)
 
 ___
 
@@ -8417,7 +8345,7 @@ Number of in-flight requests
 
 #### Defined in
 
-[packages/core/src/rbac/request-deduplication.ts:84](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/request-deduplication.ts#L84)
+[packages/core/src/rbac/request-deduplication.ts:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/request-deduplication.ts#L85)
 
 ___
 
@@ -8469,7 +8397,7 @@ const superAdminClient = createSecureClient(
 
 #### Defined in
 
-[packages/core/src/rbac/secureClient.ts:592](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L592)
+[packages/core/src/rbac/secureClient.ts:618](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L618)
 
 ___
 
@@ -8497,7 +8425,7 @@ SecureSupabaseClient instance
 
 #### Defined in
 
-[packages/core/src/rbac/secureClient.ts:612](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L612)
+[packages/core/src/rbac/secureClient.ts:638](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L638)
 
 ___
 
@@ -8532,7 +8460,7 @@ if (isSecureClient(supabase)) {
 
 #### Defined in
 
-[packages/core/src/rbac/utils/clientSecurity.ts:35](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L35)
+[packages/core/src/rbac/utils/clientSecurity.ts:36](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L36)
 
 ___
 
@@ -8564,7 +8492,7 @@ warnIfInsecureClient(supabase, 'MyComponent');
 
 #### Defined in
 
-[packages/core/src/rbac/utils/clientSecurity.ts:56](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L56)
+[packages/core/src/rbac/utils/clientSecurity.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/utils/clientSecurity.ts#L57)
 
 ___
 
@@ -8706,22 +8634,24 @@ const palette = parseAndNormalizeEventColours(colours);
 
 #### Defined in
 
-[packages/core/src/theming/parseEventColours.ts:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/parseEventColours.ts#L99)
+[packages/core/src/theming/parseEventColours.ts:107](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/parseEventColours.ts#L107)
 
 ___
 
 ### applyPalette
 
-▸ **applyPalette**(`palette`): void
+▸ **applyPalette**(`palette`, `eventName?`): void
 
 Applies a complete palette to the document by setting CSS variables on :root.
 Uses document.documentElement.style.setProperty() for runtime updates.
+When eventName is provided, also sets --print-event-name for print styles.
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `palette` | PaletteData | Complete palette data with main, sec, and acc palettes |
+| `eventName?` | string | Optional event name to set as --print-event-name (e.g. for print headers/footers) |
 
 #### Returns
 
@@ -8729,7 +8659,7 @@ void
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:70](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L70)
+[packages/core/src/theming/runtime.ts:133](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L133)
 
 ___
 
@@ -8746,7 +8676,113 @@ void
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L120)
+[packages/core/src/theming/runtime.ts:187](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L187)
+
+___
+
+### ok
+
+▸ **ok**\<`T`\>(`data`): ApiResult\<T\>
+
+Creates a successful ApiResult.
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `data` | T |
+
+#### Returns
+
+ApiResult\<T\>
+
+#### Defined in
+
+[packages/core/src/types/api-result.ts:30](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/api-result.ts#L30)
+
+___
+
+### err
+
+▸ **err**(`error`): ApiResult\<never\>
+
+Creates a failed ApiResult.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `error` | ApiError |
+
+#### Returns
+
+ApiResult\<never\>
+
+#### Defined in
+
+[packages/core/src/types/api-result.ts:37](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/api-result.ts#L37)
+
+___
+
+### isOk
+
+▸ **isOk**\<`T`\>(`result`): result is Object
+
+Type guard: narrows ApiResult to success variant.
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `result` | ApiResult\<T\> |
+
+#### Returns
+
+result is Object
+
+#### Defined in
+
+[packages/core/src/types/api-result.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/api-result.ts#L44)
+
+___
+
+### isErr
+
+▸ **isErr**\<`T`\>(`result`): result is Object
+
+Type guard: narrows ApiResult to failure variant.
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `result` | ApiResult\<T\> |
+
+#### Returns
+
+result is Object
+
+#### Defined in
+
+[packages/core/src/types/api-result.ts:51](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/types/api-result.ts#L51)
 
 ___
 
@@ -8820,6 +8856,98 @@ string
 
 ___
 
+### getAppPort
+
+▸ **getAppPort**(`appName`): number \| undefined
+
+Get the port for an app in development.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `appName` | string | The app name (case-insensitive) |
+
+#### Returns
+
+number \| undefined
+
+The port number, or undefined if not found
+
+**`Example`**
+
+```ts
+const port = getAppPort('CAKE'); // Returns 8091
+const port = getAppPort('cake'); // Returns 8091 (case-insensitive)
+```
+
+#### Defined in
+
+[packages/core/src/utils/app/appPortMap.ts:39](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appPortMap.ts#L39)
+
+___
+
+### getAllAppPorts
+
+▸ **getAllAppPorts**(): Record\<string, number\>
+
+Get all registered app ports.
+
+#### Returns
+
+Record\<string, number\>
+
+Record of app names to ports
+
+#### Defined in
+
+[packages/core/src/utils/app/appPortMap.ts:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/appPortMap.ts#L49)
+
+___
+
+### buildAppUrl
+
+▸ **buildAppUrl**(`options`): string
+
+Builds a URL for switching to another pace app.
+
+In development: Uses port-based URLs (e.g., `http://localhost:8091/`)
+In production: Uses subdomain pattern (e.g., `https://cake.example.com/`)
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `options` | BuildAppUrlOptions | URL building options |
+
+#### Returns
+
+string
+
+The full URL to the app
+
+**`Example`**
+
+```ts
+// Development
+buildAppUrl({ appName: 'CAKE' }); 
+// Returns: 'http://localhost:8091/'
+
+// Production
+buildAppUrl({ appName: 'CAKE' }); 
+// Returns: 'https://cake.example.com/'
+
+// With custom path
+buildAppUrl({ appName: 'TRAC', path: '/dashboard' }); 
+// Returns: 'http://localhost:8092/dashboard' (dev) or 'https://trac.example.com/dashboard' (prod)
+```
+
+#### Defined in
+
+[packages/core/src/utils/app/buildAppUrl.ts:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/app/buildAppUrl.ts#L49)
+
+___
+
 ### useSessionTracking
 
 ▸ **useSessionTracking**(`supabaseClient`, `appName?`): Object
@@ -8898,7 +9026,7 @@ Object
 
 #### Defined in
 
-[packages/core/src/utils/core/logger.ts:179](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/core/logger.ts#L179)
+[packages/core/src/utils/core/logger.ts:183](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/core/logger.ts#L183)
 
 ___
 
@@ -9124,7 +9252,7 @@ Secure data access utilities
 
 #### Defined in
 
-[packages/core/src/utils/security/secureDataAccess.ts:76](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/security/secureDataAccess.ts#L76)
+[packages/core/src/utils/security/secureDataAccess.ts:279](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/security/secureDataAccess.ts#L279)
 
 ___
 
@@ -9222,7 +9350,7 @@ string
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:25](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L25)
+[packages/core/src/utils/storage/helpers.ts:26](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L26)
 
 ___
 
@@ -9245,15 +9373,15 @@ string
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L58)
+[packages/core/src/utils/storage/helpers.ts:59](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L59)
 
 ___
 
 ### extractFileMetadata
 
-▸ **extractFileMetadata**(`file`, `options`, `uploadedBy`): Promise\<StorageFileMetadata\>
+▸ **extractFileMetadata**(`file`, `options`, `uploadedBy`): Promise\<ApiResult\<StorageFileMetadata\>\>
 
-Extract file metadata from a File object
+Extract file metadata from a File object.
 
 #### Parameters
 
@@ -9265,19 +9393,22 @@ Extract file metadata from a File object
 
 #### Returns
 
-Promise\<StorageFileMetadata\>
+Promise\<ApiResult\<StorageFileMetadata\>\>
+
+ApiResult with metadata on success; optional dimensions/hash are best-effort.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L85)
+[packages/core/src/utils/storage/helpers.ts:87](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L87)
 
 ___
 
 ### uploadFile
 
-▸ **uploadFile**(`supabase`, `file`, `options`): Promise\<StorageUploadResult\>
+▸ **uploadFile**(`supabase`, `file`, `options`): Promise\<ApiResult\<StorageUploadSuccess\>\>
 
-Upload a file to Supabase storage with app segregation
+Upload a file to Supabase storage with app segregation.
+Returns ApiResult with path, optional publicUrl and metadata on success.
 
 #### Parameters
 
@@ -9289,11 +9420,11 @@ Upload a file to Supabase storage with app segregation
 
 #### Returns
 
-Promise\<StorageUploadResult\>
+Promise\<ApiResult\<StorageUploadSuccess\>\>
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:224](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L224)
+[packages/core/src/utils/storage/helpers.ts:230](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L230)
 
 ___
 
@@ -9319,166 +9450,167 @@ Public URL for the file
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:304](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L304)
+[packages/core/src/utils/storage/helpers.ts:286](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L286)
 
 ___
 
 ### getSignedUrl
 
-▸ **getSignedUrl**(`supabase`, `path`, `options`): Promise\<Object \| null\>
+▸ **getSignedUrl**(`supabase`, `path`, `options`): Promise\<ApiResult\<Object\>\>
 
-Get a signed URL for a protected file
-Private files are always in the 'files' bucket, so this always uses 'files' bucket
+Get a signed URL for a protected file.
+Private files are always in the 'files' bucket.
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | Supabase client instance |
-| `path` | string | File path within the bucket |
-| `options` | StorageUrlOptions | URL options including expiry time |
+| Name | Type |
+| :------ | :------ |
+| `supabase` | SupabaseClient\<any, "public", "public", any, any\> |
+| `path` | string |
+| `options` | StorageUrlOptions |
 
 #### Returns
 
-Promise\<Object \| null\>
+Promise\<ApiResult\<Object\>\>
 
-Signed URL with expiration timestamp, or null if failed
+ApiResult with url and expiresAt on success.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:400](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L400)
+[packages/core/src/utils/storage/helpers.ts:379](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L379)
 
 ___
 
 ### generateFileUrlsBatch
 
-▸ **generateFileUrlsBatch**(`supabase`, `fileReferences`, `options`): Promise\<Map\<string, string\>\>
+▸ **generateFileUrlsBatch**(`supabase`, `fileReferences`, `options`): Promise\<ApiResult\<Map\<string, string\>\>\>
 
-Generate URLs for multiple file references in parallel
-This batches URL generation to reduce sequential requests and uses caching
+Generate URLs for multiple file references in parallel (best-effort; partial success returns ok with map).
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | Supabase client instance |
-| `fileReferences` | Object[] | Array of file references to generate URLs for |
-| `options` | StorageUrlOptions & Object | URL options including expiry time and organisation ID |
+| Name | Type |
+| :------ | :------ |
+| `supabase` | SupabaseClient\<any, "public", "public", any, any\> |
+| `fileReferences` | Object[] |
+| `options` | StorageUrlOptions & Object |
 
 #### Returns
 
-Promise\<Map\<string, string\>\>
+Promise\<ApiResult\<Map\<string, string\>\>\>
 
-Map of file ID to URL string (only includes successful URL generations)
+ApiResult with Map of file ID to URL string.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:467](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L467)
+[packages/core/src/utils/storage/helpers.ts:442](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L442)
 
 ___
 
 ### deleteFile
 
-▸ **deleteFile**(`supabase`, `path`, `isPublic?`): Promise\<Object\>
+▸ **deleteFile**(`supabase`, `path`, `isPublic?`): Promise\<ApiResult\<void\>\>
 
-Delete a file from storage
+Delete a file from storage.
 
 #### Parameters
 
-| Name | Type | Default value | Description |
-| :------ | :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | `undefined` | Supabase client instance |
-| `path` | string | `undefined` | File path within the bucket |
-| `isPublic` | boolean | `false` | Whether the file is in the public-files bucket (default: false) |
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | `undefined` |
+| `path` | string | `undefined` |
+| `isPublic` | boolean | `false` |
 
 #### Returns
 
-Promise\<Object\>
+Promise\<ApiResult\<void\>\>
 
-Success status and optional error message
+ApiResult<void> on success.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:574](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L574)
+[packages/core/src/utils/storage/helpers.ts:528](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L528)
 
 ___
 
 ### listFiles
 
-▸ **listFiles**(`supabase`, `options`): Promise\<StorageListResult\>
+▸ **listFiles**(`supabase`, `options`): Promise\<ApiResult\<StorageListResult\>\>
 
-List files in an organization scope
+List files in an organization scope.
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | Supabase client instance |
-| `options` | StorageListOptions & Object | List options including bucket selection via isPublic |
+| Name | Type |
+| :------ | :------ |
+| `supabase` | SupabaseClient\<any, "public", "public", any, any\> |
+| `options` | StorageListOptions & Object |
 
 #### Returns
 
-Promise\<StorageListResult\>
+Promise\<ApiResult\<StorageListResult\>\>
 
-List of files with metadata
+ApiResult with files, totalCount, hasMore on success.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:608](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L608)
+[packages/core/src/utils/storage/helpers.ts:552](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L552)
 
 ___
 
 ### downloadFile
 
-▸ **downloadFile**(`supabase`, `path`, `isPublic?`): Promise\<Object \| null\>
+▸ **downloadFile**(`supabase`, `path`, `isPublic?`): Promise\<ApiResult\<Object\>\>
 
-Download a file from storage
+Download a file from storage.
 
 #### Parameters
 
-| Name | Type | Default value | Description |
-| :------ | :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | `undefined` | Supabase client instance |
-| `path` | string | `undefined` | File path within the bucket |
-| `isPublic` | boolean | `false` | Whether the file is in the public-files bucket (default: false) |
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | `undefined` |
+| `path` | string | `undefined` |
+| `isPublic` | boolean | `false` |
 
 #### Returns
 
-Promise\<Object \| null\>
+Promise\<ApiResult\<Object\>\>
 
-File blob with metadata, or null if failed
+ApiResult with blob and metadata on success.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:675](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L675)
+[packages/core/src/utils/storage/helpers.ts:615](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L615)
 
 ___
 
 ### archiveFile
 
-▸ **archiveFile**(`supabase`, `path`, `options`): Promise\<Object\>
+▸ **archiveFile**(`supabase`, `path`, `options`): Promise\<ApiResult\<void\>\>
 
-Move a file to archived location (soft delete)
+Move a file to archived location (soft delete).
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabase` | SupabaseClient\<any, "public", "public", any, any\> | Supabase client instance |
-| `path` | string | File path within the bucket |
-| `options` | Object | Archive options including bucket selection via isPublic |
-| `options.appName` | string | - |
-| `options.orgId?` | string | - |
-| `options.userId?` | string | - |
-| `options.isPublic?` | boolean | - |
+| Name | Type |
+| :------ | :------ |
+| `supabase` | SupabaseClient\<any, "public", "public", any, any\> |
+| `path` | string |
+| `options` | Object |
+| `options.appName` | string |
+| `options.orgId?` | string |
+| `options.userId?` | string |
+| `options.isPublic?` | boolean |
 
 #### Returns
 
-Promise\<Object\>
+Promise\<ApiResult\<void\>\>
+
+ApiResult<void> on success.
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:728](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L728)
+[packages/core/src/utils/storage/helpers.ts:660](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L660)
 
 ___
 
@@ -9545,7 +9677,7 @@ function App() {
 
 #### Defined in
 
-[packages/core/src/utils/supabase/createBaseClient.ts:138](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/supabase/createBaseClient.ts#L138)
+[packages/core/src/utils/supabase/createBaseClient.ts:139](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/supabase/createBaseClient.ts#L139)
 
 ___
 
@@ -9834,7 +9966,7 @@ const dangerousHtml = sanitizeHtml('<script>alert("xss")</script><p>Safe content
 
 #### Defined in
 
-[packages/core/src/utils/validation/htmlSanitization.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/validation/htmlSanitization.ts#L54)
+[packages/core/src/utils/validation/htmlSanitization.ts:52](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/validation/htmlSanitization.ts#L52)
 
 ___