@jmruthers/pace-core 0.5.57 → 0.5.59

package/docs/api/interfaces/UsePublicEventLogoOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UsePublicEventLogoOptions
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UsePublicEventLogoOptions
 
 # Interface: UsePublicEventLogoOptions
 

package/docs/api/interfaces/UsePublicEventLogoReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UsePublicEventLogoReturn
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UsePublicEventLogoReturn
 
 # Interface: UsePublicEventLogoReturn
 

package/docs/api/interfaces/UsePublicEventOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UsePublicEventOptions
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UsePublicEventOptions
 
 # Interface: UsePublicEventOptions
 

package/docs/api/interfaces/UsePublicEventReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UsePublicEventReturn
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UsePublicEventReturn
 
 # Interface: UsePublicEventReturn
 

package/docs/api/interfaces/UsePublicRouteParamsReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UsePublicRouteParamsReturn
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UsePublicRouteParamsReturn
 
 # Interface: UsePublicRouteParamsReturn
 

package/docs/api/interfaces/UserEventAccess.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UserEventAccess
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UserEventAccess
 
 # Interface: UserEventAccess
 

package/docs/api/interfaces/UserMenuProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UserMenuProps
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UserMenuProps
 
 # Interface: UserMenuProps
 

package/docs/api/interfaces/UserProfile.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.57](../README.md) / [Exports](../modules.md) / UserProfile
+[@jmruthers/pace-core - v0.5.59](../README.md) / [Exports](../modules.md) / UserProfile
 
 # Interface: UserProfile
 

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.57](README.md) / Exports
+[@jmruthers/pace-core - v0.5.59](README.md) / Exports
 
-# @jmruthers/pace-core - v0.5.57
+# @jmruthers/pace-core - v0.5.59
 
 **`File`**
 

package/docs/getting-started/quick-start.md

@@ -95,8 +95,13 @@ export default defineConfig({
 Create `.env.local`:
 
 ```bash
+# Supabase Configuration
 REACT_APP_SUPABASE_URL=https://your-project.supabase.co
 REACT_APP_SUPABASE_ANON_KEY=your-anon-key-here
+
+# ⚠️ CRITICAL: Use anon key, NOT service role key
+# The anon key starts with: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
+# The service role key has different permissions and can cause RPC timeouts
 ```
 
 ### 5. Create Supabase Client
@@ -108,18 +113,23 @@ import { createClient } from '@supabase/supabase-js'
 const supabaseUrl = process.env.REACT_APP_SUPABASE_URL!
 const supabaseAnonKey = process.env.REACT_APP_SUPABASE_ANON_KEY!
 
+if (!supabaseUrl || !supabaseAnonKey) {
+  throw new Error('Missing Supabase environment variables')
+}
+
 export const supabase = createClient(supabaseUrl, supabaseAnonKey)
 ```
 
-### 6. Set Up CSS Imports and HTML Structure
+### 6. Set Up RBAC System
 
-**CRITICAL**: Import the CSS file in your main entry point:
+**CRITICAL**: Setup RBAC before using any RBAC features:
 
 ```tsx
 // src/main.tsx
 import React from 'react'
 import ReactDOM from 'react-dom/client'
 import { BrowserRouter } from 'react-router-dom'
+import { setupRBAC } from '@jmruthers/pace-core/rbac'
 import { 
   UnifiedAuthProvider, 
   OrganisationProvider, 
@@ -131,10 +141,18 @@ import App from './App.tsx'
 // CRITICAL: Import the CSS system - includes everything you need
 import '@jmruthers/pace-core/styles/core.css'
 
+// ⚠️ CRITICAL: Setup RBAC before using any RBAC features
+setupRBAC(supabase)
+
 ReactDOM.createRoot(document.getElementById('root')!).render(
   <React.StrictMode>
     <BrowserRouter>
-      <UnifiedAuthProvider supabaseClient={supabase} appName="meal-manager">
+      <UnifiedAuthProvider 
+        supabaseClient={supabase} 
+        appName="meal-manager"
+        enableRBAC={true}
+        requireOrganisationContext={true}
+      >
         <OrganisationProvider>
           <EventProvider>
             <App />

package/docs/rbac/getting-started.md

@@ -373,6 +373,49 @@ function Navigation({ userId, organisationId }) {
 
 ## 🚨 **Troubleshooting Common Errors**
 
+### Error: "RPC call timeout after 10 seconds" / "Loading organisation context..." hangs
+
+**Symptoms:**
+- App hangs on "Loading organisation context..."
+- Console shows "RPC call timeout after 10 seconds"
+- No error messages, just infinite loading
+
+**Root Cause:** Wrong API key or missing RBAC setup
+
+**Solution:**
+1. **Verify API Key Type** - Ensure you're using the **anon key**, not service role key
+   ```typescript
+   // Check your environment variables
+   console.log('API Key check:', {
+     hasAnonKey: !!process.env.REACT_APP_SUPABASE_ANON_KEY,
+     keyLength: process.env.REACT_APP_SUPABASE_ANON_KEY?.length,
+     startsWithEyJ: process.env.REACT_APP_SUPABASE_ANON_KEY?.startsWith('eyJ')
+   })
+   ```
+
+2. **Ensure RBAC Setup** - Call `setupRBAC` before using RBAC features
+   ```typescript
+   // src/main.tsx - MUST be called before rendering
+   import { setupRBAC } from '@jmruthers/pace-core/rbac'
+   setupRBAC(supabase)
+   ```
+
+3. **Check Provider Configuration** - Verify correct provider hierarchy
+   ```tsx
+   <UnifiedAuthProvider 
+     supabaseClient={supabase} 
+     appName="your-app"
+     enableRBAC={true}
+     requireOrganisationContext={true}
+   >
+     <OrganisationProvider>
+       <EventProvider>
+         <YourApp />
+       </EventProvider>
+     </OrganisationProvider>
+   </UnifiedAuthProvider>
+   ```
+
 ### Error: "can't access property 'organisationId', scope is undefined"
 
 **Cause**: Missing organisation context or incorrect provider setup