@jmruthers/pace-core 0.5.126 → 0.5.128

package/dist/{DataTable-6FN7XDXA.js → DataTable-3Z5HLOWF.js}

@@ -54,8 +54,8 @@ import {
   sortHierarchicalDataWithSorting,
   validateHierarchicalData,
   validatePaginationConfig
-} from "./chunk-QXGLU2O5.js";
-import "./chunk-35ZDPMBM.js";
+} from "./chunk-27MGXDD6.js";
+import "./chunk-BYXRHAIF.js";
 import "./chunk-WP5I5GLN.js";
 import "./chunk-3DBFLLLU.js";
 import {
@@ -76,9 +76,9 @@ import {
   throttle,
   useDataTablePerformance
 } from "./chunk-GKHF54DI.js";
-import "./chunk-4MXVZVNS.js";
-import "./chunk-C43QIDN3.js";
-import "./chunk-ZBLK676C.js";
+import "./chunk-TGIY2AR2.js";
+import "./chunk-CTJRBUX2.js";
+import "./chunk-3CG5L6RN.js";
 import "./chunk-JCQZ6LA7.js";
 import "./chunk-PYUXFQJ3.js";
 import "./chunk-BDZUMRBD.js";
@@ -157,4 +157,4 @@ export {
   validateHierarchicalData,
   validatePaginationConfig
 };
-//# sourceMappingURL=DataTable-6FN7XDXA.js.map
+//# sourceMappingURL=DataTable-3Z5HLOWF.js.map

package/dist/{PublicLoadingSpinner-CaoRbHvJ.d.ts → PublicLoadingSpinner-CUAnTvcg.d.ts}

@@ -1876,6 +1876,11 @@ interface HeaderProps {
  * A flexible header component that supports various configurations including custom logos,
  * navigation menus, user authentication, event selection, and custom actions.
  *
+ * **Logo Display:** When used via PaceAppLayout, the logo URL is automatically constructed
+ * from the appName prop as `/${appName.toLowerCase()}_logo_wide.svg`. The appName should
+ * come from an APP_NAME constant declared in your App.tsx file to ensure consistency across
+ * authenticated and public pages.
+ *
  * Features:
  * - Customizable logo (URL or custom component)
  * - Clickable logo that automatically routes to dashboard (configurable via logoHref)
@@ -2284,6 +2289,17 @@ interface PaceAppLayoutProps {
  * Outlet to render child routes. It provides integrated authentication, navigation,
  * and user management functionality.
  *
+ * **Super Admin Access:** When `enforcePermissions={true}`, PaceAppLayout automatically
+ * checks if the user is a super admin before enforcing permissions. Super admins bypass
+ * all permission checks and can access any route without violations. The component extracts
+ * base page names from route paths (e.g., `/organisation/scouts-victoria` → `"organisation"`)
+ * for permission checking, which can be overridden using `pageIdMapping`.
+ *
+ * **Important:** The appName prop should use an APP_NAME constant declared in your App.tsx
+ * file. This ensures consistency with public pages (via PublicPageProvider) which should
+ * also receive the same APP_NAME constant. The logo URL is automatically constructed as
+ * `/${appName.toLowerCase()}_logo_wide.svg` from the public folder.
+ *
  * Features:
  * - React Router v6 integration with nested routing
  * - Unified authentication integration
@@ -2295,23 +2311,27 @@ interface PaceAppLayoutProps {
  * - Layout-level permission enforcement
  * - Permission-based navigation filtering
  * - Automatic page permission validation
+ * - Super admin bypass (super admins automatically bypass all permission checks)
  *
  * @example
  * Basic React Router setup with permission enforcement (RECOMMENDED):
  * ```tsx
  * import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
  * import { UnifiedAuthProvider } from '@jmruthers/pace-core/providers';
- * import { PaceAppLayout, PaceLoginPage } from '@jmruthers/pace-core';
+ * import { PaceAppLayout, PaceLoginPage, PublicPageApp } from '@jmruthers/pace-core';
+ *
+ * const APP_NAME = 'CORE';
  *
  * function App() {
  *   return (
- *     <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
+ *     <UnifiedAuthProvider supabaseClient={supabase} appName={APP_NAME}>
  *       <Router>
  *         <Routes>
- *           <Route path="/login" element={<PaceLoginPage appName="My App" />} />
+ *           <Route path="/login" element={<PaceLoginPage appName={APP_NAME} />} />
+ *           <Route path="/events/*" element={<PublicPageApp appName={APP_NAME} />} />
  *           <Route path="/" element={
  *             <PaceAppLayout
- *               appName="My Application"
+ *               appName={APP_NAME}
  *               enforcePermissions={true}
  *               defaultPermission="read"
  *             />
@@ -3286,16 +3306,8 @@ interface PublicPageHeaderProps {
     className?: string;
     /** Custom content to display in the header */
     children?: ReactNode;
-    /** Custom app logo component (overrides logoUrl and auto-generated path) */
-    customAppLogo?: ReactNode;
     /** Custom event logo component */
     customEventLogo?: ReactNode;
-    /** URL to the app logo image (overrides auto-generated path, but customAppLogo takes precedence) */
-    logoUrl?: string;
-    /** Alt text for the app logo (defaults to appName from useAppConfig) */
-    logoAlt?: string;
-    /** URL to navigate to when app logo is clicked */
-    logoHref?: string;
 }
 /**
  * Header component for public pages with event-specific branding
@@ -3303,23 +3315,28 @@ interface PublicPageHeaderProps {
  * This component displays the app logo, event logo, and event information
  * in a clean, accessible layout suitable for public pages.
  *
- * Logo handling follows a priority order:
- * 1. customAppLogo prop (if provided) - highest priority
- * 2. logoUrl prop (if provided) - direct URL override
- * 3. Auto-generated path from appName via useAppConfig() - convention-based
- * 4. Default SVG fallback - lowest priority
+ * The app logo is automatically generated from the appName using the pattern:
+ * `/{appName.toLowerCase()}_logo_wide.svg` from the public folder.
  *
- * The logo can be made clickable by providing the logoHref prop, which will
- * wrap the logo in a Link component for navigation.
+ * **Important:** The appName is obtained from PublicPageProvider context, which should
+ * receive the APP_NAME constant from your App.tsx file. This ensures consistency with
+ * authenticated pages that use the same APP_NAME constant.
+ *
+ * **Event Logo Requirements:**
+ * - Event logo files must be marked as `is_public = true` in the `file_references` table
+ * - The RPC function `data_file_reference_by_category_list` must be accessible to the anonymous/public role
+ * - Storage bucket must allow public read access for logo files
+ * - If no public logo is available, a fallback UI with event initials will be displayed
  *
  * @param props - Header configuration and content
  * @returns React element with public page header
  */
-declare function PublicPageHeader({ event, eventCode, title, description, showEventLogo, showAppLogo, className, children, customAppLogo, customEventLogo, logoUrl, logoAlt, logoHref }: PublicPageHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PublicPageHeader({ event, eventCode, title, description, showEventLogo, showAppLogo, className, children, customEventLogo }: PublicPageHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface PublicPageContextType {
     isPublicPage: true;
     supabase: ReturnType<typeof createClient<Database>> | null;
+    appName: string | null;
     environment: {
         supabaseUrl: string | null;
         supabaseKey: string | null;
@@ -3327,6 +3344,8 @@ interface PublicPageContextType {
 }
 interface PublicPageProviderProps {
     children: ReactNode;
+    /** Application name for logo display and branding. Should match the APP_NAME constant used in App.tsx */
+    appName?: string;
 }
 /**
  * Provider for public pages that completely isolates them from authentication context
@@ -3336,8 +3355,9 @@ interface PublicPageProviderProps {
  * - Provides environment variables for public data access
  * - Includes error boundary for graceful error handling
  * - Is completely separate from the main app context
+ * - Provides appName for consistent logo display
  */
-declare function PublicPageProvider({ children }: PublicPageProviderProps): react_jsx_runtime.JSX.Element;
+declare function PublicPageProvider({ children, appName }: PublicPageProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access public page context
  *

package/dist/{UnifiedAuthProvider-6C47WIML.js → UnifiedAuthProvider-CQDZRJIS.js}

@@ -1,10 +1,10 @@
 import {
   init_UnifiedAuthProvider
-} from "./chunk-C43QIDN3.js";
+} from "./chunk-CTJRBUX2.js";
 import {
   UnifiedAuthProvider,
   useUnifiedAuth
-} from "./chunk-ZBLK676C.js";
+} from "./chunk-3CG5L6RN.js";
 import "./chunk-BDZUMRBD.js";
 import "./chunk-UJI6WSMD.js";
 import "./chunk-PLDDJCW6.js";
@@ -13,4 +13,4 @@ export {
   UnifiedAuthProvider,
   useUnifiedAuth
 };
-//# sourceMappingURL=UnifiedAuthProvider-6C47WIML.js.map
+//# sourceMappingURL=UnifiedAuthProvider-CQDZRJIS.js.map