@jmruthers/pace-core 0.5.110 → 0.5.111

package/docs/rbac/advanced-patterns.md

@@ -29,7 +29,7 @@ function UserManagementDashboard({ userId, scope }) {
           { userId, scope, permission: 'create:users' },
           { userId, scope, permission: 'update:users' },
           { userId, scope, permission: 'delete:users' },
-          { userId, scope, permission: 'manage:roles' },
+          { userId, scope, permission: 'update:roles' },
           { userId, scope, permission: 'read:audit_logs' }
         ]);
         
@@ -52,7 +52,7 @@ function UserManagementDashboard({ userId, scope }) {
       {permissions['create:users'] && <CreateUserButton />}
       {permissions['update:users'] && <EditUserButton />}
       {permissions['delete:users'] && <DeleteUserButton />}
-      {permissions['manage:roles'] && <RoleManagement />}
+      {permissions['update:roles'] && <RoleManagement />}
       {permissions['read:audit_logs'] && <AuditLogs />}
     </div>
   );
@@ -289,7 +289,7 @@ function HierarchicalUserManagement({ userId, scope, users }) {
         const permissionChecks = await Promise.all(
           users.map(async (user) => {
             // Check if current user can manage this user based on hierarchy
-            const canManage = await hasPermission('manage:users', { 
+            const canUpdate = await hasPermission('update:users', { 
               userId, 
               scope: { 
                 ...scope, 
@@ -592,27 +592,20 @@ describe('Advanced Permission Patterns', () => {
   });
 
   test('should handle conditional permissions', async () => {
-    const mockHasPermission = jest.fn()
-      .mockResolvedValueOnce(true)  // canEditAny
-      .mockResolvedValueOnce(false); // canDeleteAny
-
-    (useCan as jest.Mock).mockReturnValue({
-      hasPermission: mockHasPermission,
-      isLoading: false,
-      error: null
-    });
-
-    const { result } = renderHook(() => useCan());
+    // Mock the underlying permission API
+    vi.mock('../api', () => ({
+      isPermittedCached: vi.fn().mockResolvedValue(true)
+    }));
 
-    const canEdit = await result.current.hasPermission('update:users', {
-      userId: 'user-123',
-      scope: { organisationId: 'org-456' }
-    });
+    const { result } = renderHook(() => useCan(
+      'user-123',
+      { organisationId: 'org-456', eventId: undefined, appId: undefined },
+      'update:users'
+    ));
 
-    expect(canEdit).toBe(true);
-    expect(mockHasPermission).toHaveBeenCalledWith('update:users', {
-      userId: 'user-123',
-      scope: { organisationId: 'org-456' }
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+      expect(result.current.can).toBe(true);
     });
   });
 

package/docs/rbac/examples.md

@@ -234,7 +234,7 @@ function UserForm({ userId, scope, userData }) {
       if (!isLoading) {
         const [canEditRole, canEditPermissions] = await Promise.all([
           hasPermission('update:user_roles', { userId, scope }),
-          hasPermission('manage:permissions', { userId, scope })
+          hasPermission('update:permissions', { userId, scope })
         ]);
         
         setPermissions({ canEditRole, canEditPermissions });
@@ -295,7 +295,7 @@ function Navigation({ userId, scope }) {
     { id: 'users', label: 'Users', permission: 'read:users' },
     { id: 'events', label: 'Events', permission: 'read:events' },
     { id: 'settings', label: 'Settings', permission: 'read:settings' },
-    { id: 'admin', label: 'Admin', permission: 'manage:system' },
+    { id: 'admin', label: 'Admin', permission: 'update:system' },
   ];
 
   useEffect(() => {
@@ -693,19 +693,19 @@ test('renders fallback when user lacks permission', () => {
 ### Testing Hooks
 
 ```tsx
-import { renderHook, act } from '@testing-library/react';
+import { renderHook, waitFor } from '@testing-library/react';
 import { useCan } from '@jmruthers/pace-core/rbac';
 
 test('useCan hook returns permission result', async () => {
-  const { result } = renderHook(() => useCan());
+  const { result } = renderHook(() => useCan(
+    'user-123',
+    { organisationId: 'org-456', eventId: undefined, appId: undefined },
+    'read:users'
+  ));
   
-  await act(async () => {
-    const hasPermission = await result.current.hasPermission('read:users', {
-      userId: 'user-123',
-      scope: { organisationId: 'org-456' }
-    });
-    
-    expect(hasPermission).toBe(true);
+  await waitFor(() => {
+    expect(result.current.isLoading).toBe(false);
+    expect(result.current.can).toBe(true);
   });
 });
 ```
@@ -765,7 +765,7 @@ function EventDashboard() {
       </PermissionEnforcer>
       
       <PermissionEnforcer
-        permissions={['manage:participants']}
+        permissions={['update:participants']}
         operation="participant-management"
         fallback={null}
       >

package/docs/rbac/getting-started.md

@@ -150,7 +150,7 @@ function UserActions() {
       eventId: undefined,
       appId: undefined
     },
-    'manage:users',
+    'update:users',
     'page-123' // optional pageId
   );
 
@@ -239,7 +239,7 @@ function UserManagement({ userId, organisationId }) {
   const { can, isLoading, error } = useCan(
     userId || '',
     { organisationId: organisationId || '' },
-    'manage:users'
+    'update:users'
   );
 
   if (isLoading) return <div>Checking permissions...</div>;
@@ -495,7 +495,7 @@ function MyComponent() {
   const { can, isLoading, error } = useCan(
     user?.id || '',
     { organisationId: selectedOrganisationId || '' },
-    'manage:users'
+    'update:users'
   );
 
   if (isLoading) return <div>Checking permissions...</div>;

package/docs/rbac/troubleshooting.md

@@ -185,7 +185,8 @@ function App() {
 **Fix:**
 ```typescript
 // ❌ WRONG - This causes the issue
-const { hasPermission } = useRBAC();
+// Don't use useRBAC().hasPermission() - it has been removed
+// Use useCan() hook or PagePermissionGuard instead
 
 // ✅ CORRECT - Use PagePermissionGuard instead
 <PagePermissionGuard

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmruthers/pace-core",
-  "version": "0.5.110",
+  "version": "0.5.111",
   "description": "Clean, modern React component library with Tailwind v4 styling and native utilities",
   "private": false,
   "publishConfig": {