@jmruthers/pace-core 0.5.188 → 0.5.190

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.188](README.md) / Exports
+[@jmruthers/pace-core - v0.5.190](README.md) / Exports
 
-# @jmruthers/pace-core - v0.5.188
+# @jmruthers/pace-core - v0.5.190
 
 **`File`**
 
@@ -57,6 +57,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 
 - [AddressFieldProps](interfaces/AddressFieldProps.md)
 - [AddressFieldRef](interfaces/AddressFieldRef.md)
+- [AvatarProps](interfaces/AvatarProps.md)
 - [BadgeProps](interfaces/BadgeProps.md)
 - [ButtonProps](interfaces/ButtonProps.md)
 - [CalendarProps](interfaces/CalendarProps.md)
@@ -247,8 +248,6 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [AlertTitle](modules.md#alerttitle)
 - [AlertDescription](modules.md#alertdescription)
 - [Avatar](modules.md#avatar)
-- [AvatarImage](modules.md#avatarimage)
-- [AvatarFallback](modules.md#avatarfallback)
 - [Badge](modules.md#badge)
 - [Button](modules.md#button)
 - [Calendar](modules.md#calendar)
@@ -444,6 +443,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [useResourcePermissions](modules.md#useresourcepermissions)
 - [useRoleManagement](modules.md#userolemanagement)
 - [useSecureSupabase](modules.md#usesecuresupabase)
+- [useSuperAdminBypass](modules.md#usesuperadminbypass)
 - [enablePerformanceMonitoring](modules.md#enableperformancemonitoring)
 - [disablePerformanceMonitoring](modules.md#disableperformancemonitoring)
 - [isPerformanceMonitoringEnabled](modules.md#isperformancemonitoringenabled)
@@ -587,7 +587,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:430](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L430)
+[packages/core/src/hooks/useFileReference.ts:475](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L475)
 
 ___
 
@@ -613,7 +613,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:436](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L436)
+[packages/core/src/hooks/useFileReference.ts:481](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L481)
 
 ___
 
@@ -641,7 +641,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:450](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L450)
+[packages/core/src/hooks/useFileReference.ts:495](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L495)
 
 ___
 
@@ -1275,7 +1275,7 @@ JSX.Element - The rendered address field
 
 #### Defined in
 
-[packages/core/src/components/AddressField/AddressField.tsx:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/AddressField/AddressField.tsx#L49)
+[packages/core/src/components/AddressField/AddressField.tsx:56](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/AddressField/AddressField.tsx#L56)
 
 ___
 
@@ -1287,7 +1287,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `HTMLAttributes`\<`HTMLDivElement`\> & \{ `variant?`: ``"default"`` \| ``"inline"`` \| ``"destructive"``  } & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | `HTMLAttributes`\<`HTMLElement`\> & \{ `variant?`: ``"default"`` \| ``"inline"`` \| ``"destructive"``  } & `RefAttributes`\<`HTMLElement`\> |
 
 #### Returns
 
@@ -1295,7 +1295,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Alert/Alert.tsx:67](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L67)
+[packages/core/src/components/Alert/Alert.tsx:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L69)
 
 ___
 
@@ -1315,7 +1315,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Alert/Alert.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L94)
+[packages/core/src/components/Alert/Alert.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L96)
 
 ___
 
@@ -1335,7 +1335,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Alert/Alert.tsx:114](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L114)
+[packages/core/src/components/Alert/Alert.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Alert/Alert.tsx#L116)
 
 ___
 
@@ -1343,51 +1343,13 @@ ___
 
 ▸ **Avatar**(`props`): `ReactNode`
 
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `props` | `Omit`\<`AvatarProps` & `RefAttributes`\<`HTMLSpanElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLSpanElement`\> |
-
-#### Returns
-
-`ReactNode`
-
-#### Defined in
-
-[packages/core/src/components/Avatar/Avatar.tsx:42](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L42)
-
-___
-
-### AvatarImage
-
-▸ **AvatarImage**(`props`): `ReactNode`
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `props` | `Omit`\<`AvatarImageProps` & `RefAttributes`\<`HTMLImageElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLImageElement`\> |
-
-#### Returns
-
-`ReactNode`
-
-#### Defined in
-
-[packages/core/src/components/Avatar/Avatar.tsx:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L57)
-
-___
-
-### AvatarFallback
-
-▸ **AvatarFallback**(`props`): `ReactNode`
+Avatar component for displaying user profile images or initials
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `Omit`\<`AvatarFallbackProps` & `RefAttributes`\<`HTMLSpanElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLSpanElement`\> |
+| `props` | [`AvatarProps`](interfaces/AvatarProps.md) & `RefAttributes`\<`HTMLDivElement`\> |
 
 #### Returns
 
@@ -1395,7 +1357,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Avatar/Avatar.tsx:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L69)
+[packages/core/src/components/Avatar/Avatar.tsx:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Avatar/Avatar.tsx#L99)
 
 ___
 
@@ -1488,11 +1450,20 @@ Calendar component
 A flexible, accessible calendar component for date selection.
 Built on react-day-picker with pace-core styling.
 
+Defaults to Australian locale (en-AU) with Monday as the first day of the week.
+The locale can be overridden by passing a `locale` prop.
+
+Month navigation is automatically managed internally when `month` and `onMonthChange` props
+are not provided. The displayed month will sync with the selected date when available,
+or default to the current month. Navigation buttons (prev/next) work automatically.
+
+For controlled month state, pass `month` and `onMonthChange` props.
+
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`CalendarProps`](interfaces/CalendarProps.md) & `RefAttributes`\<`HTMLDivElement`\> | Calendar configuration and styling |
+| `props` | [`CalendarProps`](interfaces/CalendarProps.md) & `RefAttributes`\<`HTMLTableElement`\> | Calendar configuration and styling |
 
 #### Returns
 
@@ -1503,7 +1474,7 @@ JSX.Element - The rendered calendar element
 **`Example`**
 
 ```tsx
-// Single date selection
+// Single date selection (uses default Australian locale)
 <Calendar
   mode="single"
   selected={date}
@@ -1517,11 +1488,30 @@ JSX.Element - The rendered calendar element
   onSelect={setDate}
   disabled={(date) => date < new Date()}
 />
+
+// Override locale (e.g., US locale with Sunday as first day)
+import { enUS } from 'date-fns/locale';
+<Calendar
+  mode="single"
+  selected={date}
+  onSelect={setDate}
+  locale={enUS}
+/>
+
+// Controlled month state (optional - month is auto-managed if not provided)
+const [month, setMonth] = useState(new Date());
+<Calendar
+  mode="single"
+  selected={date}
+  onSelect={setDate}
+  month={month}
+  onMonthChange={setMonth}
+/>
 ```
 
 #### Defined in
 
-[packages/core/src/components/Calendar/Calendar.tsx:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Calendar/Calendar.tsx#L111)
+[packages/core/src/components/Calendar/Calendar.tsx:188](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Calendar/Calendar.tsx#L188)
 
 ___
 
@@ -1601,7 +1591,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:215](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L215)
+[packages/core/src/components/Card/Card.tsx:212](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L212)
 
 ___
 
@@ -1621,7 +1611,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:227](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L227)
+[packages/core/src/components/Card/Card.tsx:224](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L224)
 
 ___
 
@@ -1641,7 +1631,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:239](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L239)
+[packages/core/src/components/Card/Card.tsx:236](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L236)
 
 ___
 
@@ -1661,7 +1651,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Card/Card.tsx:251](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L251)
+[packages/core/src/components/Card/Card.tsx:248](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Card/Card.tsx#L248)
 
 ___
 
@@ -2503,7 +2493,7 @@ React element with file display
 
 #### Defined in
 
-[packages/core/src/components/FileDisplay/FileDisplay.tsx:797](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L797)
+[packages/core/src/components/FileDisplay/FileDisplay.tsx:900](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileDisplay/FileDisplay.tsx#L900)
 
 ___
 
@@ -2523,7 +2513,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/FileUpload/FileUpload.tsx:49](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L49)
+[packages/core/src/components/FileUpload/FileUpload.tsx:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L50)
 
 ___
 
@@ -2804,7 +2794,7 @@ function MinimalHeader() {
 
 #### Defined in
 
-[packages/core/src/components/Header/Header.tsx:240](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L240)
+[packages/core/src/components/Header/Header.tsx:241](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L241)
 
 ___
 
@@ -3461,13 +3451,13 @@ ___
 ▸ **Progress**(`props`): `ReactNode`
 
 Progress component
-An accessible progress bar with smooth animations
+An accessible progress bar with smooth animations using native HTML `<progress>` element
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`ProgressProps`](interfaces/ProgressProps.md) & `RefAttributes`\<`HTMLDivElement`\> | Progress configuration and styling |
+| `props` | [`ProgressProps`](interfaces/ProgressProps.md) & `RefAttributes`\<`HTMLProgressElement`\> | Progress configuration and styling |
 
 #### Returns
 
@@ -3634,7 +3624,7 @@ Public page context with environment variables
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:131](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L131)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:133](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L133)
 
 ___
 
@@ -3652,7 +3642,7 @@ True if we're in a public page context
 
 #### Defined in
 
-[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:146](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L146)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:148](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L148)
 
 ___
 
@@ -4797,7 +4787,7 @@ Useful for testing or when you need to force refresh all data
 
 #### Defined in
 
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:396](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L396)
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:482](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L482)
 
 ___
 
@@ -4818,7 +4808,7 @@ Get cache statistics for debugging
 
 #### Defined in
 
-[packages/core/src/hooks/public/usePublicFileDisplay.ts:407](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L407)
+[packages/core/src/hooks/public/usePublicFileDisplay.ts:493](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicFileDisplay.ts#L493)
 
 ___
 
@@ -5133,7 +5123,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:19](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L19)
+[packages/core/src/hooks/useFileReference.ts:62](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L62)
 
 ___
 
@@ -5172,7 +5162,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:202](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L202)
+[packages/core/src/hooks/useFileReference.ts:245](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L245)
 
 ___
 
@@ -5205,7 +5195,7 @@ Hook for getting a file reference by ID
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:304](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L304)
+[packages/core/src/hooks/useFileReference.ts:349](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L349)
 
 ___
 
@@ -5249,7 +5239,7 @@ For more control, use useFileReference() directly and manage URLs yourself.
 
 #### Defined in
 
-[packages/core/src/hooks/useFileReference.ts:377](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L377)
+[packages/core/src/hooks/useFileReference.ts:422](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useFileReference.ts#L422)
 
 ___
 
@@ -5579,7 +5569,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:119](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L119)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L120)
 
 ___
 
@@ -5599,7 +5589,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/services/UnifiedAuthProvider.tsx:590](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L590)
+[packages/core/src/providers/services/UnifiedAuthProvider.tsx:675](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/services/UnifiedAuthProvider.tsx#L675)
 
 ___
 
@@ -6106,13 +6096,13 @@ Setup RBAC system
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L44)
+[packages/core/src/rbac/api.ts:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L46)
 
 ___
 
 ### getAccessLevel
 
-▸ **getAccessLevel**(`input`): `Promise`\<[`AccessLevel`](modules.md#accesslevel)\>
+▸ **getAccessLevel**(`input`, `appConfig?`, `appName?`): `Promise`\<[`AccessLevel`](modules.md#accesslevel)\>
 
 Get user's access level in a scope
 
@@ -6123,6 +6113,8 @@ Get user's access level in a scope
 | `input` | `Object` | Access level input |
 | `input.userId` | `string` | - |
 | `input.scope` | [`Scope`](modules.md#scope) | - |
+| `appConfig?` | ``null`` \| `AppConfig` | Optional app configuration |
+| `appName?` | `string` | Optional app name |
 
 #### Returns
 
@@ -6141,13 +6133,13 @@ const accessLevel = await getAccessLevel({
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:121](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L121)
+[packages/core/src/rbac/api.ts:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L125)
 
 ___
 
 ### getPermissionMap
 
-▸ **getPermissionMap**(`input`): `Promise`\<[`PermissionMap`](modules.md#permissionmap)\>
+▸ **getPermissionMap**(`input`, `appConfig?`, `appName?`): `Promise`\<[`PermissionMap`](modules.md#permissionmap)\>
 
 Get user's permission map for a scope
 
@@ -6158,6 +6150,8 @@ Get user's permission map for a scope
 | `input` | `Object` | Permission map input |
 | `input.userId` | `string` | - |
 | `input.scope` | [`Scope`](modules.md#scope) | - |
+| `appConfig?` | ``null`` \| `AppConfig` | Optional app configuration |
+| `appName?` | `string` | Optional app name |
 
 #### Returns
 
@@ -6180,7 +6174,7 @@ const permissions = await getPermissionMap({
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:147](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L147)
+[packages/core/src/rbac/api.ts:188](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L188)
 
 ___
 
@@ -6202,13 +6196,13 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:155](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L155)
+[packages/core/src/rbac/api.ts:225](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L225)
 
 ___
 
 ### getRoleContext
 
-▸ **getRoleContext**(`input`): `Promise`\<`RBACRoleContext`\>
+▸ **getRoleContext**(`input`, `appConfig?`, `appName?`): `Promise`\<`RBACRoleContext`\>
 
 #### Parameters
 
@@ -6217,6 +6211,8 @@ ___
 | `input` | `Object` |
 | `input.userId` | `string` |
 | `input.scope` | [`Scope`](modules.md#scope) |
+| `appConfig?` | ``null`` \| `AppConfig` |
+| `appName?` | `string` |
 
 #### Returns
 
@@ -6224,13 +6220,13 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:163](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L163)
+[packages/core/src/rbac/api.ts:233](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L233)
 
 ___
 
 ### isPermitted
 
-▸ **isPermitted**(`input`): `Promise`\<`boolean`\>
+▸ **isPermitted**(`input`, `appConfig?`, `appName?`): `Promise`\<`boolean`\>
 
 Check if user has a specific permission
 
@@ -6239,6 +6235,8 @@ Check if user has a specific permission
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `input` | [`PermissionCheck`](modules.md#permissioncheck) | Permission check input |
+| `appConfig?` | ``null`` \| `AppConfig` | Optional app configuration (if not provided, will be fetched) |
+| `appName?` | `string` | Optional app name (for PORTAL/ADMIN special case and config lookup) |
 
 #### Returns
 
@@ -6259,13 +6257,13 @@ const canManage = await isPermitted({
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:187](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L187)
+[packages/core/src/rbac/api.ts:288](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L288)
 
 ___
 
 ### isPermittedCached
 
-▸ **isPermittedCached**(`input`): `Promise`\<`boolean`\>
+▸ **isPermittedCached**(`input`, `appConfig?`, `appName?`): `Promise`\<`boolean`\>
 
 Check if user has a specific permission (cached version)
 
@@ -6277,6 +6275,8 @@ and checks cache before making new requests. Uses session cache for page-level c
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `input` | [`PermissionCheck`](modules.md#permissioncheck) | Permission check input |
+| `appConfig?` | ``null`` \| `AppConfig` | Optional app configuration |
+| `appName?` | `string` | Optional app name |
 
 #### Returns
 
@@ -6286,7 +6286,7 @@ Promise resolving to permission result
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:216](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L216)
+[packages/core/src/rbac/api.ts:363](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L363)
 
 ___
 
@@ -6310,7 +6310,7 @@ Promise<boolean> - True if user has permission
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:255](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L255)
+[packages/core/src/rbac/api.ts:406](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L406)
 
 ___
 
@@ -6338,7 +6338,7 @@ Promise resolving to true if user has any permission
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:265](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L265)
+[packages/core/src/rbac/api.ts:416](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L416)
 
 ___
 
@@ -6366,7 +6366,7 @@ Promise resolving to true if user has all permissions
 
 #### Defined in
 
-[packages/core/src/rbac/api.ts:293](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L293)
+[packages/core/src/rbac/api.ts:444](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/api.ts#L444)
 
 ___
 
@@ -6752,7 +6752,7 @@ React element with navigation permission context
 
 #### Defined in
 
-[packages/core/src/rbac/components/NavigationProvider.tsx:167](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L167)
+[packages/core/src/rbac/components/NavigationProvider.tsx:168](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L168)
 
 ___
 
@@ -6774,7 +6774,7 @@ Error if used outside of NavigationProvider
 
 #### Defined in
 
-[packages/core/src/rbac/components/NavigationProvider.tsx:331](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L331)
+[packages/core/src/rbac/components/NavigationProvider.tsx:333](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/NavigationProvider.tsx#L333)
 
 ___
 
@@ -6794,7 +6794,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/components/PagePermissionGuard.tsx:499](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L499)
+[packages/core/src/rbac/components/PagePermissionGuard.tsx:373](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionGuard.tsx#L373)
 
 ___
 
@@ -6821,7 +6821,7 @@ React element with page permission context
 
 #### Defined in
 
-[packages/core/src/rbac/components/PagePermissionProvider.tsx:128](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L128)
+[packages/core/src/rbac/components/PagePermissionProvider.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L129)
 
 ___
 
@@ -6843,7 +6843,7 @@ Error if used outside of PagePermissionProvider
 
 #### Defined in
 
-[packages/core/src/rbac/components/PagePermissionProvider.tsx:267](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L267)
+[packages/core/src/rbac/components/PagePermissionProvider.tsx:269](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/PagePermissionProvider.tsx#L269)
 
 ___
 
@@ -6898,7 +6898,7 @@ React element with role-based routing
 
 #### Defined in
 
-[packages/core/src/rbac/components/RoleBasedRouter.tsx:182](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L182)
+[packages/core/src/rbac/components/RoleBasedRouter.tsx:183](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L183)
 
 ___
 
@@ -6920,7 +6920,7 @@ Error if used outside of RoleBasedRouter
 
 #### Defined in
 
-[packages/core/src/rbac/components/RoleBasedRouter.tsx:397](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L397)
+[packages/core/src/rbac/components/RoleBasedRouter.tsx:399](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/RoleBasedRouter.tsx#L399)
 
 ___
 
@@ -6947,7 +6947,7 @@ React element with secure data context
 
 #### Defined in
 
-[packages/core/src/rbac/components/SecureDataProvider.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L136)
+[packages/core/src/rbac/components/SecureDataProvider.tsx:137](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L137)
 
 ___
 
@@ -6969,7 +6969,7 @@ Error if used outside of SecureDataProvider
 
 #### Defined in
 
-[packages/core/src/rbac/components/SecureDataProvider.tsx:313](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L313)
+[packages/core/src/rbac/components/SecureDataProvider.tsx:315](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/components/SecureDataProvider.tsx#L315)
 
 ___
 
@@ -7070,7 +7070,7 @@ RBACEngine instance
 
 #### Defined in
 
-[packages/core/src/rbac/engine.ts:602](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L602)
+[packages/core/src/rbac/engine.ts:604](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/engine.ts#L604)
 
 ___
 
@@ -7130,13 +7130,13 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L58)
+[packages/core/src/rbac/hooks/usePermissions.ts:60](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L60)
 
 ___
 
 ### useCan
 
-▸ **useCan**(`userId`, `scope`, `permission`, `pageId?`, `useCache?`): `Object`
+▸ **useCan**(`userId`, `scope`, `permission`, `pageId?`, `useCache?`, `appName?`): `Object`
 
 Hook to check if user can perform an action
 
@@ -7149,6 +7149,7 @@ Hook to check if user can perform an action
 | `permission` | \`create:$\{string}\` \| \`update:$\{string}\` \| \`read:$\{string}\` \| \`delete:$\{string}\` | `undefined` | Permission to check |
 | `pageId?` | `string` | `undefined` | Optional page ID |
 | `useCache` | `boolean` | `true` | Whether to use cached results |
+| `appName?` | `string` | `undefined` | Optional app name (for PORTAL/ADMIN special case) |
 
 #### Returns
 
@@ -7178,7 +7179,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:300](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L300)
+[packages/core/src/rbac/hooks/usePermissions.ts:305](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L305)
 
 ___
 
@@ -7228,7 +7229,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:511](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L511)
+[packages/core/src/rbac/hooks/usePermissions.ts:547](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L547)
 
 ___
 
@@ -7285,7 +7286,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:586](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L586)
+[packages/core/src/rbac/hooks/usePermissions.ts:653](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L653)
 
 ___
 
@@ -7336,7 +7337,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:669](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L669)
+[packages/core/src/rbac/hooks/usePermissions.ts:736](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L736)
 
 ___
 
@@ -7387,7 +7388,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:755](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L755)
+[packages/core/src/rbac/hooks/usePermissions.ts:822](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L822)
 
 ___
 
@@ -7438,7 +7439,7 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/usePermissions.ts:840](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L840)
+[packages/core/src/rbac/hooks/usePermissions.ts:907](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/usePermissions.ts#L907)
 
 ___
 
@@ -7458,7 +7459,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/useRBAC.ts:51](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRBAC.ts#L51)
+[packages/core/src/rbac/hooks/useRBAC.ts:52](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useRBAC.ts#L52)
 
 ___
 
@@ -7501,7 +7502,7 @@ const permission = useCan(userId, resolvedScope, permission);
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/useResolvedScope.ts:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L64)
+[packages/core/src/rbac/hooks/useResolvedScope.ts:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useResolvedScope.ts#L75)
 
 ___
 
@@ -7648,7 +7649,21 @@ function MyComponent() {
 
 #### Defined in
 
-[packages/core/src/rbac/hooks/useSecureSupabase.ts:205](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useSecureSupabase.ts#L205)
+[packages/core/src/rbac/hooks/useSecureSupabase.ts:208](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useSecureSupabase.ts#L208)
+
+___
+
+### useSuperAdminBypass
+
+▸ **useSuperAdminBypass**(): `SuperAdminBypassState`
+
+#### Returns
+
+`SuperAdminBypassState`
+
+#### Defined in
+
+[packages/core/src/rbac/hooks/useSuperAdminBypass.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/hooks/useSuperAdminBypass.ts#L38)
 
 ___
 
@@ -7893,19 +7908,20 @@ ___
 
 ### createSecureClient
 
-▸ **createSecureClient**(`supabaseUrl`, `supabaseKey`, `organisationId`, `eventId?`, `appId?`): [`SecureSupabaseClient`](classes/SecureSupabaseClient.md)
+▸ **createSecureClient**(`supabaseUrl`, `supabaseKey`, `organisationId`, `eventId?`, `appId?`, `isSuperAdmin?`): [`SecureSupabaseClient`](classes/SecureSupabaseClient.md)
 
 Create a secure Supabase client with organisation context
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `supabaseUrl` | `string` | Supabase project URL |
-| `supabaseKey` | `string` | Supabase publishable key or anon key (accepts both legacy anon keys and modern publishable keys) |
-| `organisationId` | `string` | Required organisation ID |
-| `eventId?` | `string` | Optional event ID |
-| `appId?` | `string` | Optional app ID |
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `supabaseUrl` | `string` | `undefined` | Supabase project URL |
+| `supabaseKey` | `string` | `undefined` | Supabase publishable key or anon key (accepts both legacy anon keys and modern publishable keys) |
+| `organisationId` | `string` | `undefined` | Required organisation ID |
+| `eventId?` | `string` | `undefined` | Optional event ID |
+| `appId?` | `string` | `undefined` | Optional app ID |
+| `isSuperAdmin` | `boolean` | `false` | Optional super admin flag (defaults to false) |
 
 #### Returns
 
@@ -7921,13 +7937,14 @@ const client = createSecureClient(
   'your-publishable-key-or-anon-key',
   'org-123',
   'event-456',
-  'app-789'
+  'app-789',
+  false // isSuperAdmin
 );
 ```
 
 #### Defined in
 
-[packages/core/src/rbac/secureClient.ts:265](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L265)
+[packages/core/src/rbac/secureClient.ts:324](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L324)
 
 ___
 
@@ -7954,7 +7971,7 @@ SecureSupabaseClient instance
 
 #### Defined in
 
-[packages/core/src/rbac/secureClient.ts:284](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L284)
+[packages/core/src/rbac/secureClient.ts:344](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/rbac/secureClient.ts#L344)
 
 ___
 
@@ -8552,7 +8569,9 @@ ___
 
 ▸ **generateFilePath**(`options`, `fileName`): `string`
 
-Generate a file path based on organization-first structure
+Generate a file path based on organization-first or user-first structure
+- If orgId is provided: {orgId}/{folder}/filename
+- If userId is provided (and orgId is not): users/{userId}/{folder}/filename
 
 #### Parameters
 
@@ -8567,7 +8586,7 @@ Generate a file path based on organization-first structure
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L23)
+[packages/core/src/utils/storage/helpers.ts:25](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L25)
 
 ___
 
@@ -8590,7 +8609,7 @@ Sanitizes the original filename to remove spaces and invalid characters for stor
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L54)
+[packages/core/src/utils/storage/helpers.ts:58](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L58)
 
 ___
 
@@ -8614,7 +8633,7 @@ Extract file metadata from a File object
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:81](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L81)
+[packages/core/src/utils/storage/helpers.ts:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L85)
 
 ___
 
@@ -8638,7 +8657,7 @@ Upload a file to Supabase storage with app segregation
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L219)
+[packages/core/src/utils/storage/helpers.ts:224](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L224)
 
 ___
 
@@ -8664,7 +8683,7 @@ Public URL for the file
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:299](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L299)
+[packages/core/src/utils/storage/helpers.ts:304](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L304)
 
 ___
 
@@ -8691,7 +8710,7 @@ Signed URL with expiration timestamp, or null if failed
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:395](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L395)
+[packages/core/src/utils/storage/helpers.ts:400](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L400)
 
 ___
 
@@ -8718,7 +8737,7 @@ Map of file ID to URL string (only includes successful URL generations)
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:462](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L462)
+[packages/core/src/utils/storage/helpers.ts:467](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L467)
 
 ___
 
@@ -8744,7 +8763,7 @@ Success status and optional error message
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:569](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L569)
+[packages/core/src/utils/storage/helpers.ts:574](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L574)
 
 ___
 
@@ -8769,7 +8788,7 @@ List of files with metadata
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:603](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L603)
+[packages/core/src/utils/storage/helpers.ts:608](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L608)
 
 ___
 
@@ -8795,7 +8814,7 @@ File blob with metadata, or null if failed
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:663](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L663)
+[packages/core/src/utils/storage/helpers.ts:675](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L675)
 
 ___
 
@@ -8813,7 +8832,8 @@ Move a file to archived location (soft delete)
 | `path` | `string` | File path within the bucket |
 | `options` | `Object` | Archive options including bucket selection via isPublic |
 | `options.appName` | `string` | - |
-| `options.orgId` | `string` | - |
+| `options.orgId?` | `string` | - |
+| `options.userId?` | `string` | - |
 | `options.isPublic?` | `boolean` | - |
 
 #### Returns
@@ -8822,7 +8842,7 @@ Move a file to archived location (soft delete)
 
 #### Defined in
 
-[packages/core/src/utils/storage/helpers.ts:716](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L716)
+[packages/core/src/utils/storage/helpers.ts:728](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L728)
 
 ___