@jmruthers/pace-core 0.5.1 → 0.5.4

package/src/styles/core.css

@@ -1,15 +1,5 @@
 @import "tailwindcss";
 
-/* @source directives for Tailwind v4 content scanning */
-@source "../../src/**/*.{js,ts,jsx,tsx}";
-@source "../../src/components/**/*.{js,ts,jsx,tsx}";
-@source "../../src/providers/**/*.{js,ts,jsx,tsx}";
-@source "../../src/hooks/**/*.{js,ts,jsx,tsx}";
-@source "../../src/utils/**/*.{js,ts,jsx,tsx}";
-@source "../../src/types/**/*.{js,ts,jsx,tsx}";
-@source "../../src/validation/**/*.{js,ts,jsx,tsx}";
-@source "../../src/rbac/**/*.{js,ts,jsx,tsx}";
-
 @theme {
   /* reset all color variables and fonts */
   --color-*: initial;
@@ -17,55 +7,10 @@
   --font-serif: "Open Sans", sans-serif;
   --font-mono: "Reddit Mono", monospace;
 }
-
 @theme static {
-
   --app-width: 90rem;
-
-  /* MAIN palette - silver */
-  --color-main-raw: oklch(0.7 0.057 252.02);
-  --color-main-50: oklch(0.98 0.001 252.02);
-  --color-main-100: oklch(0.96 0.005 252.02);
-  --color-main-200: oklch(0.927 0.012 252.02);
-  --color-main-300: oklch(0.881 0.021 252.02);
-  --color-main-400: oklch(0.822 0.032 252.02);
-  --color-main-500: oklch(0.75 0.047 252.02);
-  --color-main-600: oklch(0.7 0.057 252.02);
-  --color-main-700: oklch(0.567 0.044 252.02);
-  --color-main-800: oklch(0.456 0.034 252.02);
-  --color-main-900: oklch(0.332 0.024 252.02);
-  --color-main-950: oklch(0.195 0.014 252.02);
-
-  /* SEC palette - violet */
-  --color-sec-raw: oklch(0.58 0.23 280.75);
-  --color-sec-50: oklch(0.98 0.003 280.75);
-  --color-sec-100: oklch(0.96 0.014 280.75);
-  --color-sec-200: oklch(0.927 0.033 280.75);
-  --color-sec-300: oklch(0.881 0.059 280.75);
-  --color-sec-400: oklch(0.822 0.093 280.75);
-  --color-sec-500: oklch(0.75 0.133 280.75);
-  --color-sec-600: oklch(0.665 0.182 280.75);
-  --color-sec-700: oklch(0.58 0.23 280.75);
-  --color-sec-800: oklch(0.456 0.158 280.75);
-  --color-sec-900: oklch(0.332 0.099 280.75);
-  --color-sec-950: oklch(0.195 0.047 280.75);
-
-  /* ACC palette - blood orange */
-  --color-acc-raw: oklch(0.64 0.21 37.76);
-  --color-acc-50: oklch(0.98 0.003 37.76);
-  --color-acc-100: oklch(0.96 0.015 37.76);
-  --color-acc-200: oklch(0.927 0.035 37.76);
-  --color-acc-300: oklch(0.881 0.063 37.76);
-  --color-acc-400: oklch(0.822 0.099 37.76);
-  --color-acc-500: oklch(0.75 0.143 37.76);
-  --color-acc-600: oklch(0.64 0.21 37.76);
-  --color-acc-700: oklch(0.567 0.177 37.76);
-  --color-acc-800: oklch(0.456 0.13 37.76);
-  --color-acc-900: oklch(0.332 0.085 37.76);
-  --color-acc-950: oklch(0.195 0.044 37.76);
 }
 
-
 @theme inline {
   /* Semantic token mapping */
   --color-border: var(--color-main-500);

package/src/utils/formatDate.test.ts

@@ -0,0 +1,241 @@
+/**
+ * @file formatDate Utility Tests
+ * @description Comprehensive tests for the formatDate utility function
+ */
+
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { formatDate } from './formatting';
+
+describe('formatDate Utility', () => {
+  let originalLocale: string;
+  let originalTimezone: string;
+
+  beforeEach(() => {
+    // Store original values
+    originalLocale = Intl.DateTimeFormat().resolvedOptions().locale;
+    originalTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  describe('Date Object Input', () => {
+    it('formats a Date object correctly', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result = formatDate(date);
+      
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+
+    it('formats different Date objects', () => {
+      const dates = [
+        new Date('2023-12-25T00:00:00.000Z'),
+        new Date('2024-06-15T12:00:00.000Z'),
+        new Date('2024-12-31T23:59:59.999Z')
+      ];
+      
+      dates.forEach(date => {
+        const result = formatDate(date);
+        expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+      });
+    });
+  });
+
+  describe('String Input', () => {
+    it('formats ISO date strings correctly', () => {
+      const result = formatDate('2024-01-15T10:30:00.000Z');
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+
+    it('formats date-only strings correctly', () => {
+      const result = formatDate('2024-01-15');
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+
+    it('formats various date string formats', () => {
+      const dateStrings = [
+        '2024-01-15',
+        '2024-01-15T10:30:00Z',
+        '2024-01-15T10:30:00.000Z',
+        '2024-01-15T10:30:00+00:00'
+      ];
+      
+      dateStrings.forEach(dateString => {
+        const result = formatDate(dateString);
+        expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+      });
+    });
+  });
+
+  describe('Number Input', () => {
+    it('formats timestamp numbers correctly', () => {
+      const timestamp = new Date('2024-01-15T10:30:00.000Z').getTime();
+      const result = formatDate(timestamp);
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+
+    it('formats Unix timestamps correctly', () => {
+      const unixTimestamp = Math.floor(new Date('2024-01-15T10:30:00.000Z').getTime() / 1000);
+      const result = formatDate(unixTimestamp * 1000); // Convert back to milliseconds
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+  });
+
+  describe('Edge Cases', () => {
+    it('handles invalid date strings gracefully', () => {
+      const invalidDates = [
+        'invalid-date',
+        'not-a-date',
+        '2024-13-45', // Invalid month and day
+        '2024-02-30'  // Invalid day for February
+      ];
+      
+      invalidDates.forEach(invalidDate => {
+        const result = formatDate(invalidDate);
+        // Should return a string even for invalid dates (may be "Invalid Date")
+        expect(typeof result).toBe('string');
+        expect(result.length).toBeGreaterThan(0);
+      });
+    });
+
+    it('handles empty string input', () => {
+      const result = formatDate('');
+      expect(typeof result).toBe('string');
+    });
+
+    it('handles null and undefined input', () => {
+      // @ts-expect-error - Testing runtime behavior with invalid types
+      expect(() => formatDate(null)).toThrow();
+      // @ts-expect-error - Testing runtime behavior with invalid types
+      expect(() => formatDate(undefined)).toThrow();
+    });
+
+    it('handles very large numbers', () => {
+      const largeNumber = Number.MAX_SAFE_INTEGER;
+      const result = formatDate(largeNumber);
+      expect(typeof result).toBe('string');
+    });
+
+    it('handles negative numbers', () => {
+      const negativeNumber = -1000000;
+      const result = formatDate(negativeNumber);
+      expect(typeof result).toBe('string');
+    });
+
+    it('handles zero', () => {
+      const result = formatDate(0);
+      expect(typeof result).toBe('string');
+    });
+  });
+
+  describe('Format Consistency', () => {
+    it('returns consistent format for same date', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result1 = formatDate(date);
+      const result2 = formatDate(date);
+      
+      expect(result1).toBe(result2);
+    });
+
+    it('returns consistent format across different input types for same date', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const dateString = '2024-01-15T10:30:00.000Z';
+      const timestamp = date.getTime();
+      
+      const result1 = formatDate(date);
+      const result2 = formatDate(dateString);
+      const result3 = formatDate(timestamp);
+      
+      expect(result1).toBe(result2);
+      expect(result2).toBe(result3);
+    });
+  });
+
+  describe('Locale Handling', () => {
+    it('uses default locale when no locale is specified', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result = formatDate(date);
+      
+      // Should use the default locale format
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+
+    it('handles different locales correctly', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      
+      const result = formatDate(date);
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+  });
+
+  describe('Time Zone Handling', () => {
+    it('handles different time zones correctly', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result = formatDate(date);
+      
+      // Should format consistently regardless of timezone
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+  });
+
+  describe('Performance', () => {
+    it('handles large number of calls efficiently', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const startTime = performance.now();
+      
+      // Call formatDate many times
+      for (let i = 0; i < 1000; i++) {
+        formatDate(date);
+      }
+      
+      const endTime = performance.now();
+      const duration = endTime - startTime;
+      
+      // Should complete in reasonable time (less than 100ms for 1000 calls)
+      expect(duration).toBeLessThan(100);
+    });
+  });
+
+  describe('Type Safety', () => {
+    it('accepts valid Date types', () => {
+      const date = new Date();
+      expect(() => formatDate(date)).not.toThrow();
+    });
+
+    it('accepts valid string types', () => {
+      const dateString = '2024-01-15';
+      expect(() => formatDate(dateString)).not.toThrow();
+    });
+
+    it('accepts valid number types', () => {
+      const timestamp = Date.now();
+      expect(() => formatDate(timestamp)).not.toThrow();
+    });
+  });
+
+  describe('Return Value', () => {
+    it('returns a string', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result = formatDate(date);
+      
+      expect(typeof result).toBe('string');
+    });
+
+    it('returns non-empty string for valid dates', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result = formatDate(date);
+      
+      expect(result).toBeTruthy();
+      expect(result.length).toBeGreaterThan(0);
+    });
+
+    it('returns expected format pattern', () => {
+      const date = new Date('2024-01-15T10:30:00.000Z');
+      const result = formatDate(date);
+      
+      // Should match pattern: "MMM DD, YYYY"
+      expect(result).toMatch(/^[A-Za-z]{3} \d{1,2}, \d{4}$/);
+    });
+  });
+});

package/dist/chunk-AUE24LVR.js

@@ -1,268 +0,0 @@
-import {
-  getAccessLevel,
-  getPermissionMap,
-  isPermitted,
-  isPermittedCached
-} from "./chunk-C5G2A4PO.js";
-
-// src/rbac/hooks.ts
-import { useState, useEffect, useCallback, useMemo } from "react";
-function usePermissions(userId, scope) {
-  const [permissions, setPermissions] = useState({});
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const fetchPermissions = useCallback(async () => {
-    if (!userId) {
-      setPermissions({});
-      setIsLoading(false);
-      return;
-    }
-    try {
-      setIsLoading(true);
-      setError(null);
-      const result = await getPermissionMap({ userId, scope });
-      setPermissions(result);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to fetch permissions"));
-    } finally {
-      setIsLoading(false);
-    }
-  }, [userId, scope.organisationId, scope.eventId, scope.appId]);
-  useEffect(() => {
-    fetchPermissions();
-  }, [fetchPermissions]);
-  return {
-    permissions,
-    isLoading,
-    error,
-    refetch: fetchPermissions
-  };
-}
-function useCan(userId, scope, permission, pageId, useCache = true) {
-  const [can, setCan] = useState(false);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const check = useCallback(async () => {
-    console.log("[useCan] check() called with:", { userId, scope, permission, pageId });
-    console.log("[useCan] Hook parameters:", { userId, scope, permission, pageId, useCache });
-    if (!userId) {
-      console.log("[useCan] No userId, denying access");
-      setCan(false);
-      setIsLoading(false);
-      return;
-    }
-    try {
-      const { isSuperAdmin } = await import("./api-ETQ6YJ3C.js");
-      const isSuper = await isSuperAdmin(userId);
-      if (isSuper) {
-        console.log("[useCan] User is super admin, granting access");
-        setCan(true);
-        setIsLoading(false);
-        return;
-      }
-    } catch (error2) {
-      console.error("[useCan] Error checking super admin status:", error2);
-    }
-    if (!scope || !scope.organisationId || !scope.appId) {
-      console.log("[useCan] Incomplete scope, waiting for resolution:", scope);
-      setCan(false);
-      setIsLoading(true);
-      return;
-    }
-    console.log("[useCan] Scope is complete, checking permission...");
-    console.log("[useCan] Detailed scope info:", {
-      organisationId: scope.organisationId,
-      eventId: scope.eventId,
-      appId: scope.appId,
-      permission,
-      pageId
-    });
-    try {
-      setIsLoading(true);
-      setError(null);
-      console.log("[useCan] About to call isPermitted/isPermittedCached...");
-      const result = useCache ? await isPermittedCached({ userId, scope, permission, pageId }) : await isPermitted({ userId, scope, permission, pageId });
-      console.log("[useCan] Permission check result:", result);
-      console.log("[useCan] Permission check details:", {
-        userId,
-        scope,
-        permission,
-        pageId,
-        result,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      });
-      setCan(result);
-    } catch (err) {
-      console.error("[useCan] Permission check error:", err);
-      console.error("[useCan] Error details:", {
-        userId,
-        scope,
-        permission,
-        pageId,
-        error: err instanceof Error ? err.message : "Unknown error",
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      });
-      setError(err instanceof Error ? err : new Error("Failed to check permission"));
-      setCan(false);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [userId, scope.organisationId, scope.eventId, scope.appId, permission, pageId, useCache]);
-  useEffect(() => {
-    check();
-  }, [check]);
-  return {
-    can,
-    isLoading,
-    error,
-    check
-  };
-}
-function useAccessLevel(userId, scope) {
-  const [accessLevel, setAccessLevel] = useState(null);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const fetchAccessLevel = useCallback(async () => {
-    if (!userId) {
-      setAccessLevel(null);
-      setIsLoading(false);
-      return;
-    }
-    try {
-      setIsLoading(true);
-      setError(null);
-      const result = await getAccessLevel({ userId, scope });
-      setAccessLevel(result);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to fetch access level"));
-      setAccessLevel(null);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [userId, scope.organisationId, scope.eventId, scope.appId]);
-  useEffect(() => {
-    fetchAccessLevel();
-  }, [fetchAccessLevel]);
-  return {
-    accessLevel,
-    isLoading,
-    error,
-    refetch: fetchAccessLevel
-  };
-}
-function useMultiplePermissions(userId, scope, permissions, pageId, useCache = true) {
-  const [permissionResults, setPermissionResults] = useState({});
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const fetchPermissions = useCallback(async () => {
-    if (!userId || permissions.length === 0) {
-      setPermissionResults({});
-      setIsLoading(false);
-      return;
-    }
-    try {
-      setIsLoading(true);
-      setError(null);
-      const results = {};
-      const promises = permissions.map(async (permission) => {
-        const result = useCache ? await isPermittedCached({ userId, scope, permission, pageId }) : await isPermitted({ userId, scope, permission, pageId });
-        return { permission, result };
-      });
-      const resolved = await Promise.all(promises);
-      resolved.forEach(({ permission, result }) => {
-        results[permission] = result;
-      });
-      setPermissionResults(results);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to check permissions"));
-      setPermissionResults({});
-    } finally {
-      setIsLoading(false);
-    }
-  }, [userId, scope.organisationId, scope.eventId, scope.appId, permissions, pageId, useCache]);
-  useEffect(() => {
-    fetchPermissions();
-  }, [fetchPermissions]);
-  return {
-    permissions: permissionResults,
-    isLoading,
-    error,
-    refetch: fetchPermissions
-  };
-}
-function useHasAnyPermission(userId, scope, permissions, pageId) {
-  const { permissions: permissionResults, isLoading, error, refetch } = useMultiplePermissions(
-    userId,
-    scope,
-    permissions,
-    pageId
-  );
-  const hasAny = useMemo(() => {
-    return Object.values(permissionResults).some(Boolean);
-  }, [permissionResults]);
-  return {
-    hasAny,
-    isLoading,
-    error,
-    refetch
-  };
-}
-function useHasAllPermissions(userId, scope, permissions, pageId) {
-  const { permissions: permissionResults, isLoading, error, refetch } = useMultiplePermissions(
-    userId,
-    scope,
-    permissions,
-    pageId
-  );
-  const hasAll = useMemo(() => {
-    return Object.values(permissionResults).every(Boolean);
-  }, [permissionResults]);
-  return {
-    hasAll,
-    isLoading,
-    error,
-    refetch
-  };
-}
-function useCachedPermissions(userId, scope) {
-  const [permissions, setPermissions] = useState({});
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const fetchCachedPermissions = useCallback(async () => {
-    if (!userId) {
-      setPermissions({});
-      setIsLoading(false);
-      return;
-    }
-    try {
-      setIsLoading(true);
-      setError(null);
-      const result = await getPermissionMap({ userId, scope });
-      setPermissions(result);
-    } catch (err) {
-      setError(err instanceof Error ? err : new Error("Failed to fetch cached permissions"));
-    } finally {
-      setIsLoading(false);
-    }
-  }, [userId, scope.organisationId, scope.eventId, scope.appId]);
-  useEffect(() => {
-    fetchCachedPermissions();
-  }, [fetchCachedPermissions]);
-  return {
-    permissions,
-    isLoading,
-    error,
-    refetch: fetchCachedPermissions
-  };
-}
-
-export {
-  usePermissions,
-  useCan,
-  useAccessLevel,
-  useMultiplePermissions,
-  useHasAnyPermission,
-  useHasAllPermissions,
-  useCachedPermissions
-};
-//# sourceMappingURL=chunk-AUE24LVR.js.map

package/dist/chunk-AUE24LVR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rbac/hooks.ts"],"sourcesContent":["/**\n * RBAC React Hooks\n * @package @jmruthers/pace-core\n * @module RBAC/Hooks\n * @since 1.0.0\n * \n * This module provides React hooks for RBAC functionality.\n */\n\nimport { useState, useEffect, useCallback, useMemo } from 'react';\nimport { \n  UUID, \n  Scope, \n  Permission, \n  AccessLevel, \n  PermissionMap,\n  UsePermissionsReturn,\n  UseCanReturn\n} from './types';\nimport { \n  getAccessLevel, \n  getPermissionMap, \n  isPermitted,\n  isPermittedCached \n} from './api';\n\n/**\n * Hook to get user's permissions in a scope\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @returns Permission data and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { permissions, isLoading, error } = usePermissions(\n *     'user-123',\n *     { organisationId: 'org-456' }\n *   );\n *   \n *   if (isLoading) return <div>Loading...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   return (\n *     <div>\n *       {permissions['page-1']?.includes('read') && <ReadButton />}\n *       {permissions['page-1']?.includes('manage') && <ManageButton />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function usePermissions(userId: UUID, scope: Scope): UsePermissionsReturn {\n  const [permissions, setPermissions] = useState<PermissionMap>({});\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const fetchPermissions = useCallback(async () => {\n    if (!userId) {\n      setPermissions({});\n      setIsLoading(false);\n      return;\n    }\n\n    try {\n      setIsLoading(true);\n      setError(null);\n      \n      const result = await getPermissionMap({ userId, scope });\n      setPermissions(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Failed to fetch permissions'));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [userId, scope.organisationId, scope.eventId, scope.appId]);\n\n  useEffect(() => {\n    fetchPermissions();\n  }, [fetchPermissions]);\n\n  return {\n    permissions,\n    isLoading,\n    error,\n    refetch: fetchPermissions,\n  };\n}\n\n/**\n * Hook to check if user has a specific permission\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @param permission - Permission to check\n * @param pageId - Optional page ID\n * @param useCache - Whether to use cached results (default: true)\n * @returns Permission check result and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { can, isLoading } = useCan(\n *     'user-123',\n *     { organisationId: 'org-456' },\n *     'manage:events',\n *     'page-789'\n *   );\n *   \n *   if (isLoading) return <div>Checking permission...</div>;\n *   \n *   return (\n *     <div>\n *       {can ? <AdminPanel /> : <AccessDenied />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useCan(\n  userId: UUID,\n  scope: Scope,\n  permission: Permission,\n  pageId?: UUID,\n  useCache: boolean = true\n): UseCanReturn {\n  const [can, setCan] = useState(false);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const check = useCallback(async () => {\n    console.log('[useCan] check() called with:', { userId, scope, permission, pageId });\n    console.log('[useCan] Hook parameters:', { userId, scope, permission, pageId, useCache });\n    \n    if (!userId) {\n      console.log('[useCan] No userId, denying access');\n      setCan(false);\n      setIsLoading(false);\n      return;\n    }\n\n    // Check for super admin status first - super admins bypass all scope requirements\n    try {\n      const { isSuperAdmin } = await import('./api');\n      const isSuper = await isSuperAdmin(userId);\n      if (isSuper) {\n        console.log('[useCan] User is super admin, granting access');\n        setCan(true);\n        setIsLoading(false);\n        return;\n      }\n    } catch (error) {\n      console.error('[useCan] Error checking super admin status:', error);\n      // Continue with normal permission check if super admin check fails\n    }\n\n    // Check if scope is incomplete (missing required fields)\n    if (!scope || !scope.organisationId || !scope.appId) {\n      console.log('[useCan] Incomplete scope, waiting for resolution:', scope);\n      setCan(false);\n      setIsLoading(true); // Keep loading until scope is complete\n      return;\n    }\n\n    console.log('[useCan] Scope is complete, checking permission...');\n    console.log('[useCan] Detailed scope info:', {\n      organisationId: scope.organisationId,\n      eventId: scope.eventId,\n      appId: scope.appId,\n      permission,\n      pageId\n    });\n    \n    try {\n      setIsLoading(true);\n      setError(null);\n      \n      console.log('[useCan] About to call isPermitted/isPermittedCached...');\n      const result = useCache \n        ? await isPermittedCached({ userId, scope, permission, pageId })\n        : await isPermitted({ userId, scope, permission, pageId });\n      \n      console.log('[useCan] Permission check result:', result);\n      console.log('[useCan] Permission check details:', {\n        userId,\n        scope,\n        permission,\n        pageId,\n        result,\n        timestamp: new Date().toISOString()\n      });\n      setCan(result);\n    } catch (err) {\n      console.error('[useCan] Permission check error:', err);\n      console.error('[useCan] Error details:', {\n        userId,\n        scope,\n        permission,\n        pageId,\n        error: err instanceof Error ? err.message : 'Unknown error',\n        timestamp: new Date().toISOString()\n      });\n      setError(err instanceof Error ? err : new Error('Failed to check permission'));\n      setCan(false);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [userId, scope.organisationId, scope.eventId, scope.appId, permission, pageId, useCache]);\n\n  useEffect(() => {\n    check();\n  }, [check]);\n\n  return {\n    can,\n    isLoading,\n    error,\n    check,\n  };\n}\n\n/**\n * Hook to get user's access level in a scope\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @returns Access level and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { accessLevel, isLoading } = useAccessLevel(\n *     'user-123',\n *     { organisationId: 'org-456' }\n *   );\n *   \n *   if (isLoading) return <div>Loading...</div>;\n *   \n *   return (\n *     <div>\n *       {accessLevel === 'super' && <SuperAdminPanel />}\n *       {accessLevel === 'admin' && <AdminPanel />}\n *       {accessLevel === 'planner' && <PlannerPanel />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useAccessLevel(userId: UUID, scope: Scope): {\n  accessLevel: AccessLevel | null;\n  isLoading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const [accessLevel, setAccessLevel] = useState<AccessLevel | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const fetchAccessLevel = useCallback(async () => {\n    if (!userId) {\n      setAccessLevel(null);\n      setIsLoading(false);\n      return;\n    }\n\n    try {\n      setIsLoading(true);\n      setError(null);\n      \n      const result = await getAccessLevel({ userId, scope });\n      setAccessLevel(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Failed to fetch access level'));\n      setAccessLevel(null);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [userId, scope.organisationId, scope.eventId, scope.appId]);\n\n  useEffect(() => {\n    fetchAccessLevel();\n  }, [fetchAccessLevel]);\n\n  return {\n    accessLevel,\n    isLoading,\n    error,\n    refetch: fetchAccessLevel,\n  };\n}\n\n/**\n * Hook to check multiple permissions at once\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @param permissions - Array of permissions to check\n * @param pageId - Optional page ID\n * @param useCache - Whether to use cached results (default: true)\n * @returns Object with permission results and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { permissions, isLoading } = useMultiplePermissions(\n *     'user-123',\n *     { organisationId: 'org-456' },\n *     ['read:events', 'manage:events', 'delete:events']\n *   );\n *   \n *   return (\n *     <div>\n *       {permissions['read:events'] && <ReadButton />}\n *       {permissions['manage:events'] && <ManageButton />}\n *       {permissions['delete:events'] && <DeleteButton />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMultiplePermissions(\n  userId: UUID,\n  scope: Scope,\n  permissions: Permission[],\n  pageId?: UUID,\n  useCache: boolean = true\n): {\n  permissions: Record<Permission, boolean>;\n  isLoading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const [permissionResults, setPermissionResults] = useState<Record<Permission, boolean>>({} as Record<Permission, boolean>);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const fetchPermissions = useCallback(async () => {\n    if (!userId || permissions.length === 0) {\n      setPermissionResults({} as Record<Permission, boolean>);\n      setIsLoading(false);\n      return;\n    }\n\n    try {\n      setIsLoading(true);\n      setError(null);\n      \n      const results: Record<Permission, boolean> = {} as Record<Permission, boolean>;\n      \n      // Check all permissions in parallel\n      const promises = permissions.map(async (permission) => {\n        const result = useCache \n          ? await isPermittedCached({ userId, scope, permission, pageId })\n          : await isPermitted({ userId, scope, permission, pageId });\n        \n        return { permission, result };\n      });\n      \n      const resolved = await Promise.all(promises);\n      \n      resolved.forEach(({ permission, result }) => {\n        results[permission] = result;\n      });\n      \n      setPermissionResults(results);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Failed to check permissions'));\n      setPermissionResults({} as Record<Permission, boolean>);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [userId, scope.organisationId, scope.eventId, scope.appId, permissions, pageId, useCache]);\n\n  useEffect(() => {\n    fetchPermissions();\n  }, [fetchPermissions]);\n\n  return {\n    permissions: permissionResults,\n    isLoading,\n    error,\n    refetch: fetchPermissions,\n  };\n}\n\n/**\n * Hook to check if user has any of the specified permissions\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @param permissions - Array of permissions to check\n * @param pageId - Optional page ID\n * @returns True if user has any permission and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { hasAny, isLoading } = useHasAnyPermission(\n *     'user-123',\n *     { organisationId: 'org-456' },\n *     ['read:events', 'manage:events']\n *   );\n *   \n *   return (\n *     <div>\n *       {hasAny ? <EventContent /> : <AccessDenied />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useHasAnyPermission(\n  userId: UUID,\n  scope: Scope,\n  permissions: Permission[],\n  pageId?: UUID\n): {\n  hasAny: boolean;\n  isLoading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const { permissions: permissionResults, isLoading, error, refetch } = useMultiplePermissions(\n    userId,\n    scope,\n    permissions,\n    pageId\n  );\n\n  const hasAny = useMemo(() => {\n    return Object.values(permissionResults).some(Boolean);\n  }, [permissionResults]);\n\n  return {\n    hasAny,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n\n/**\n * Hook to check if user has all of the specified permissions\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @param permissions - Array of permissions to check\n * @param pageId - Optional page ID\n * @returns True if user has all permissions and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { hasAll, isLoading } = useHasAllPermissions(\n *     'user-123',\n *     { organisationId: 'org-456' },\n *     ['read:events', 'manage:events']\n *   );\n *   \n *   return (\n *     <div>\n *       {hasAll ? <FullAccessPanel /> : <LimitedAccessPanel />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useHasAllPermissions(\n  userId: UUID,\n  scope: Scope,\n  permissions: Permission[],\n  pageId?: UUID\n): {\n  hasAll: boolean;\n  isLoading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const { permissions: permissionResults, isLoading, error, refetch } = useMultiplePermissions(\n    userId,\n    scope,\n    permissions,\n    pageId\n  );\n\n  const hasAll = useMemo(() => {\n    return Object.values(permissionResults).every(Boolean);\n  }, [permissionResults]);\n\n  return {\n    hasAll,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n\n/**\n * Hook to read cached permissions (contract requirement)\n * \n * This hook only reads from the core cache and does not perform\n * any bespoke caching as per the contract requirements.\n * \n * @param userId - User ID\n * @param scope - Permission scope\n * @returns Cached permission data and loading state\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const { permissions, isLoading, error } = useCachedPermissions(\n *     'user-123',\n *     { organisationId: 'org-456' }\n *   );\n *   \n *   if (isLoading) return <div>Loading cached permissions...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   return (\n *     <div>\n *       {permissions['page-1']?.includes('read') && <ReadButton />}\n *       {permissions['page-1']?.includes('manage') && <ManageButton />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useCachedPermissions(userId: UUID, scope: Scope): {\n  permissions: PermissionMap;\n  isLoading: boolean;\n  error: Error | null;\n  refetch: () => Promise<void>;\n} {\n  const [permissions, setPermissions] = useState<PermissionMap>({});\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const fetchCachedPermissions = useCallback(async () => {\n    if (!userId) {\n      setPermissions({});\n      setIsLoading(false);\n      return;\n    }\n\n    try {\n      setIsLoading(true);\n      setError(null);\n      \n      // Use cached version of getPermissionMap\n      const result = await getPermissionMap({ userId, scope });\n      setPermissions(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Failed to fetch cached permissions'));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [userId, scope.organisationId, scope.eventId, scope.appId]);\n\n  useEffect(() => {\n    fetchCachedPermissions();\n  }, [fetchCachedPermissions]);\n\n  return {\n    permissions,\n    isLoading,\n    error,\n    refetch: fetchCachedPermissions,\n  };\n}\n"],"mappings":"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","names":["error"]}