@jmruthers/pace-core 0.6.5 → 0.6.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (473) hide show
  1. package/CHANGELOG.md +104 -0
  2. package/README.md +5 -403
  3. package/audit-tool/00-dependencies.cjs +394 -0
  4. package/audit-tool/audits/01-pace-core-compliance.cjs +556 -0
  5. package/audit-tool/audits/02-project-structure.cjs +255 -0
  6. package/audit-tool/audits/03-architecture.cjs +196 -0
  7. package/audit-tool/audits/04-code-quality.cjs +149 -0
  8. package/audit-tool/audits/05-styling.cjs +224 -0
  9. package/audit-tool/audits/06-security-rbac.cjs +544 -0
  10. package/audit-tool/audits/07-api-tech-stack.cjs +301 -0
  11. package/audit-tool/audits/08-testing-documentation.cjs +202 -0
  12. package/audit-tool/audits/09-operations.cjs +208 -0
  13. package/audit-tool/index.cjs +291 -0
  14. package/audit-tool/utils/code-utils.cjs +218 -0
  15. package/audit-tool/utils/file-utils.cjs +230 -0
  16. package/audit-tool/utils/report-utils.cjs +241 -0
  17. package/core-usage-manifest.json +93 -0
  18. package/cursor-rules/00-standards-overview.mdc +156 -0
  19. package/cursor-rules/01-pace-core-compliance.mdc +586 -0
  20. package/cursor-rules/02-project-structure.mdc +42 -4
  21. package/cursor-rules/{03-solid-principles.mdc → 03-architecture.mdc} +126 -10
  22. package/cursor-rules/04-code-quality.mdc +419 -0
  23. package/cursor-rules/{08-markup-quality.mdc → 05-styling.mdc} +104 -34
  24. package/cursor-rules/06-security-rbac.mdc +518 -0
  25. package/cursor-rules/07-api-tech-stack.mdc +377 -0
  26. package/cursor-rules/08-testing-documentation.mdc +324 -0
  27. package/cursor-rules/09-operations.mdc +365 -0
  28. package/dist/{AuthService-Cb34EQs3.d.ts → AuthService-DmfO5rGS.d.ts} +10 -0
  29. package/dist/DataTable-7PMH7XN7.js +15 -0
  30. package/dist/{DataTable-BMRU8a1j.d.ts → DataTable-DRUIgtUH.d.ts} +1 -1
  31. package/dist/{PublicPageProvider-QTFVrL-Z.d.ts → PublicPageProvider-DlsCaR5v.d.ts} +33 -72
  32. package/dist/UnifiedAuthProvider-ZT6TIGM7.js +7 -0
  33. package/dist/api-Y4MQWOFW.js +4 -0
  34. package/dist/audit-MYQXYZFU.js +3 -0
  35. package/dist/{chunk-DGUM43GV.js → chunk-3RG5ZIWI.js} +1 -4
  36. package/dist/{chunk-QXHPKYJV.js → chunk-4SXLQIZO.js} +1 -26
  37. package/dist/{chunk-UPPMRMYG.js → chunk-5X4QLXRG.js} +73 -151
  38. package/dist/chunk-6F3IILHI.js +62 -0
  39. package/dist/{chunk-E66EQZE6.js → chunk-6GLLNA6U.js} +3 -9
  40. package/dist/{chunk-ZSAAAMVR.js → chunk-6QYDGKQY.js} +1 -4
  41. package/dist/{chunk-FMUCXFII.js → chunk-7ILTDCL2.js} +9 -5
  42. package/dist/{chunk-M43Y4SSO.js → chunk-A3W6LW53.js} +15 -13
  43. package/dist/{chunk-63FOKYGO.js → chunk-AHU7G2R5.js} +2 -11
  44. package/dist/{chunk-HU2C6SSC.js → chunk-BM4CQ5P3.js} +606 -559
  45. package/dist/chunk-C7NSAPTL.js +1 -0
  46. package/dist/{chunk-J36DSWQK.js → chunk-FEJLJNWA.js} +7 -41
  47. package/dist/{chunk-IHB5DR3H.js → chunk-FTCRZOG2.js} +188 -387
  48. package/dist/{chunk-G37KK66H.js → chunk-FYHN4DD5.js} +60 -19
  49. package/dist/chunk-GHYHJTYV.js +994 -0
  50. package/dist/{chunk-VBXEHIUJ.js → chunk-HF6O3O37.js} +6 -88
  51. package/dist/{chunk-FFQEQTNW.js → chunk-IUBRCBSY.js} +134 -45
  52. package/dist/{chunk-6COVEUS7.js → chunk-JGWDVX64.js} +983 -1034
  53. package/dist/{chunk-RGAWHO7N.js → chunk-L4XMVJKY.js} +77 -222
  54. package/dist/chunk-MBADTM7L.js +64 -0
  55. package/dist/{chunk-M7MPQISP.js → chunk-OJ4SKRSV.js} +3 -16
  56. package/dist/{chunk-IVOFDYWT.js → chunk-Q7Q7V5NV.js} +2109 -1604
  57. package/dist/{chunk-JGRYX5UX.js → chunk-S7DKJPLT.js} +29 -58
  58. package/dist/{chunk-PWLANIRT.js → chunk-TTRFSOKR.js} +1 -7
  59. package/dist/{chunk-5DRSZLL2.js → chunk-UH3NTO3F.js} +1 -6
  60. package/dist/{chunk-NTM7ZSB6.js → chunk-VBCS3DUA.js} +261 -168
  61. package/dist/{chunk-EFN2EIMK.js → chunk-ZFYPMX46.js} +271 -87
  62. package/dist/{chunk-L4OXEN46.js → chunk-ZKAWKYT4.js} +10 -24
  63. package/dist/components.d.ts +7 -5
  64. package/dist/components.js +46 -257
  65. package/dist/{database.generated-CzIvgcPu.d.ts → database.generated-CcnC_DRc.d.ts} +4795 -3691
  66. package/dist/eslint-rules/index.cjs +35 -0
  67. package/{src/eslint-rules/pace-core-compliance.cjs → dist/eslint-rules/rules/01-pace-core-compliance.cjs} +234 -235
  68. package/dist/eslint-rules/rules/04-code-quality.cjs +290 -0
  69. package/dist/eslint-rules/rules/05-styling.cjs +61 -0
  70. package/dist/eslint-rules/rules/06-security-rbac.cjs +806 -0
  71. package/dist/eslint-rules/rules/07-api-tech-stack.cjs +263 -0
  72. package/dist/eslint-rules/rules/08-testing.cjs +94 -0
  73. package/dist/eslint-rules/utils/helpers.cjs +42 -0
  74. package/dist/eslint-rules/utils/manifest-loader.cjs +75 -0
  75. package/dist/hooks.d.ts +6 -6
  76. package/dist/hooks.js +62 -172
  77. package/dist/icons/index.d.ts +1 -0
  78. package/dist/icons/index.js +1 -0
  79. package/dist/index.d.ts +12 -11
  80. package/dist/index.js +67 -660
  81. package/dist/providers.d.ts +2 -2
  82. package/dist/providers.js +8 -35
  83. package/dist/rbac/eslint-rules.d.ts +46 -44
  84. package/dist/rbac/eslint-rules.js +7 -4
  85. package/dist/rbac/index.d.ts +109 -586
  86. package/dist/rbac/index.js +14 -207
  87. package/dist/styles/index.js +2 -12
  88. package/dist/theming/runtime.d.ts +14 -1
  89. package/dist/theming/runtime.js +3 -19
  90. package/dist/{timezone-CHhWg6b4.d.ts → timezone-BZe_eUxx.d.ts} +175 -1
  91. package/dist/{types-CkbwOr4Y.d.ts → types-DXstZpNI.d.ts} +4 -17
  92. package/dist/types-t9H8qKRw.d.ts +55 -0
  93. package/dist/types.d.ts +1 -1
  94. package/dist/types.js +7 -94
  95. package/dist/{usePublicRouteParams-ClnV4tnv.d.ts → usePublicRouteParams-MamNgwqe.d.ts} +20 -20
  96. package/dist/utils.d.ts +24 -117
  97. package/dist/utils.js +54 -392
  98. package/docs/README.md +17 -7
  99. package/docs/api/README.md +4 -402
  100. package/docs/api/modules.md +301 -871
  101. package/docs/api-reference/components.md +21 -21
  102. package/docs/api-reference/deprecated.md +31 -6
  103. package/docs/api-reference/hooks.md +80 -80
  104. package/docs/api-reference/rpc-functions.md +78 -3
  105. package/docs/api-reference/types.md +1 -1
  106. package/docs/api-reference/utilities.md +1 -1
  107. package/docs/architecture/README.md +1 -1
  108. package/docs/core-concepts/events.md +3 -3
  109. package/docs/core-concepts/organisations.md +6 -6
  110. package/docs/core-concepts/permissions.md +6 -6
  111. package/docs/documentation-index.md +12 -18
  112. package/docs/getting-started/cursor-rules.md +3 -23
  113. package/docs/getting-started/dependencies.md +650 -0
  114. package/docs/getting-started/documentation-index.md +1 -1
  115. package/docs/getting-started/examples/README.md +4 -4
  116. package/docs/getting-started/examples/full-featured-app.md +1 -1
  117. package/docs/getting-started/faq.md +2 -2
  118. package/docs/getting-started/installation-guide.md +20 -7
  119. package/docs/getting-started/quick-reference.md +4 -4
  120. package/docs/getting-started/quick-start.md +23 -12
  121. package/docs/implementation-guides/authentication.md +15 -15
  122. package/docs/implementation-guides/component-styling.md +1 -1
  123. package/docs/implementation-guides/data-tables.md +126 -33
  124. package/docs/implementation-guides/datatable-rbac-usage.md +1 -1
  125. package/docs/implementation-guides/dynamic-colors.md +3 -3
  126. package/docs/implementation-guides/file-upload-storage.md +2 -2
  127. package/docs/implementation-guides/hierarchical-datatable.md +40 -60
  128. package/docs/implementation-guides/inactivity-tracking.md +3 -3
  129. package/docs/implementation-guides/large-datasets.md +3 -2
  130. package/docs/implementation-guides/organisation-security.md +2 -2
  131. package/docs/implementation-guides/performance.md +2 -2
  132. package/docs/implementation-guides/permission-enforcement.md +5 -1
  133. package/docs/migration/V0.3.44_organisation-context-timing-fix.md +1 -1
  134. package/docs/migration/V0.4.0_rbac-migration.md +6 -6
  135. package/docs/rbac/MIGRATION_GUIDE.md +819 -0
  136. package/docs/rbac/RBAC_CONTRACT.md +724 -0
  137. package/docs/rbac/README.md +17 -8
  138. package/docs/rbac/advanced-patterns.md +6 -6
  139. package/docs/rbac/api-reference.md +20 -20
  140. package/docs/rbac/edge-functions-guide.md +376 -0
  141. package/docs/rbac/event-based-apps.md +3 -3
  142. package/docs/rbac/examples.md +41 -41
  143. package/docs/rbac/getting-started.md +37 -37
  144. package/docs/rbac/performance.md +1 -1
  145. package/docs/rbac/quick-start.md +52 -52
  146. package/docs/rbac/secure-client-protection.md +1 -35
  147. package/docs/rbac/troubleshooting.md +1 -1
  148. package/docs/security/README.md +5 -5
  149. package/docs/standards/0-standards-overview.md +220 -0
  150. package/docs/standards/1-pace-core-compliance-standards.md +986 -0
  151. package/docs/standards/2-project-structure-standards.md +949 -0
  152. package/docs/standards/3-architecture-standards.md +606 -0
  153. package/docs/standards/4-code-quality-standards.md +728 -0
  154. package/docs/standards/5-styling-standards.md +348 -0
  155. package/docs/standards/{07-rbac-and-rls-standard.md → 6-security-rbac-standards.md} +269 -66
  156. package/docs/standards/7-api-tech-stack-standards.md +662 -0
  157. package/docs/standards/8-testing-documentation-standards.md +401 -0
  158. package/docs/standards/9-operations-standards.md +1102 -0
  159. package/docs/standards/README.md +185 -57
  160. package/docs/troubleshooting/README.md +4 -4
  161. package/docs/troubleshooting/common-issues.md +2 -2
  162. package/docs/troubleshooting/debugging.md +9 -9
  163. package/docs/troubleshooting/migration.md +4 -4
  164. package/docs/troubleshooting/organisation-context-setup.md +42 -19
  165. package/eslint-config-pace-core.cjs +33 -6
  166. package/package.json +35 -23
  167. package/scripts/install-cursor-rules.cjs +25 -6
  168. package/scripts/install-eslint-config.cjs +284 -0
  169. package/src/__tests__/fixtures/supabase.ts +1 -1
  170. package/src/__tests__/helpers/__tests__/component-test-utils.test.tsx +3 -3
  171. package/src/__tests__/helpers/__tests__/optimized-test-setup.test.ts +1 -1
  172. package/src/__tests__/helpers/__tests__/supabaseMock.test.ts +1 -1
  173. package/src/__tests__/helpers/__tests__/test-providers.test.tsx +2 -2
  174. package/src/__tests__/helpers/__tests__/test-utils.test.tsx +13 -13
  175. package/src/__tests__/helpers/component-test-utils.tsx +1 -1
  176. package/src/__tests__/helpers/supabaseMock.ts +2 -2
  177. package/src/__tests__/integration/UserProfile.test.tsx +14 -14
  178. package/src/__tests__/public-recipe-view.test.ts +38 -9
  179. package/src/__tests__/rbac/PagePermissionGuard.test.tsx +6 -6
  180. package/src/__tests__/templates/accessibility.test.template.tsx +9 -9
  181. package/src/__tests__/templates/component.test.template.tsx +18 -15
  182. package/src/components/Button/Button.tsx +5 -1
  183. package/src/components/Calendar/Calendar.tsx +201 -47
  184. package/src/components/ContextSelector/ContextSelector.tsx +106 -119
  185. package/src/components/DataTable/AUDIT_REPORT.md +293 -0
  186. package/src/components/DataTable/__tests__/DataTableCore.test.tsx +10 -2
  187. package/src/components/DataTable/__tests__/a11y.basic.test.tsx +10 -4
  188. package/src/components/DataTable/__tests__/test-utils/sharedTestUtils.tsx +9 -9
  189. package/src/components/DataTable/components/ColumnFilter.tsx +63 -74
  190. package/src/components/DataTable/components/ColumnVisibilityDropdown.tsx +43 -41
  191. package/src/components/DataTable/components/DataTableCore.tsx +186 -13
  192. package/src/components/DataTable/components/DataTableErrorBoundary.tsx +9 -11
  193. package/src/components/DataTable/components/DataTableLayout.tsx +35 -21
  194. package/src/components/DataTable/components/EditFields.tsx +23 -3
  195. package/src/components/DataTable/components/EditableRow.tsx +12 -9
  196. package/src/components/DataTable/components/EmptyState.tsx +10 -9
  197. package/src/components/DataTable/components/FilterRow.tsx +2 -4
  198. package/src/components/DataTable/components/ImportModal.tsx +124 -126
  199. package/src/components/DataTable/components/LoadingState.tsx +5 -6
  200. package/src/components/DataTable/components/RowComponent.tsx +12 -0
  201. package/src/components/DataTable/components/SortIndicator.tsx +50 -0
  202. package/src/components/DataTable/components/__tests__/COVERAGE_NOTE.md +4 -4
  203. package/src/components/DataTable/components/__tests__/ColumnFilter.test.tsx +23 -82
  204. package/src/components/DataTable/components/__tests__/DataTableErrorBoundary.test.tsx +37 -9
  205. package/src/components/DataTable/components/__tests__/EmptyState.test.tsx +7 -4
  206. package/src/components/DataTable/components/__tests__/FilterRow.test.tsx +12 -4
  207. package/src/components/DataTable/components/__tests__/LoadingState.test.tsx +41 -27
  208. package/src/components/DataTable/components/hooks/usePermissionTracking.ts +0 -4
  209. package/src/components/DataTable/components/index.ts +2 -1
  210. package/src/components/DataTable/hooks/__tests__/useDataTableState.test.ts +51 -47
  211. package/src/components/DataTable/hooks/useDataTablePermissions.ts +24 -21
  212. package/src/components/DataTable/hooks/useDataTableState.ts +125 -9
  213. package/src/components/DataTable/hooks/useTableColumns.ts +40 -2
  214. package/src/components/DataTable/hooks/useTableHandlers.ts +11 -0
  215. package/src/components/DataTable/types.ts +5 -18
  216. package/src/components/DataTable/utils/a11yUtils.ts +17 -0
  217. package/src/components/DatePickerWithTimezone/DatePickerWithTimezone.test.tsx +2 -1
  218. package/src/components/DatePickerWithTimezone/DatePickerWithTimezone.tsx +11 -15
  219. package/src/components/DateTimeField/DateTimeField.tsx +10 -9
  220. package/src/components/Dialog/Dialog.test.tsx +128 -104
  221. package/src/components/Dialog/Dialog.tsx +742 -24
  222. package/src/components/ErrorBoundary/ErrorBoundary.tsx +77 -79
  223. package/src/components/FileDisplay/FileDisplay.test.tsx +4 -2
  224. package/src/components/FileDisplay/FileDisplay.tsx +23 -17
  225. package/src/components/FileUpload/FileUpload.test.tsx +52 -14
  226. package/src/components/FileUpload/FileUpload.tsx +112 -130
  227. package/src/components/Form/Form.test.tsx +6 -8
  228. package/src/components/Form/Form.tsx +365 -4
  229. package/src/components/NavigationMenu/NavigationMenu.test.tsx +14 -13
  230. package/src/components/NavigationMenu/useNavigationFiltering.ts +11 -21
  231. package/src/components/PaceAppLayout/PaceAppLayout.test.tsx +6 -4
  232. package/src/components/PaceAppLayout/PaceAppLayout.tsx +11 -15
  233. package/src/components/PaceLoginPage/PaceLoginPage.test.tsx +108 -61
  234. package/src/components/PaceLoginPage/PaceLoginPage.tsx +27 -3
  235. package/src/components/Progress/Progress.tsx +2 -4
  236. package/src/components/ProtectedRoute/ProtectedRoute.tsx +8 -8
  237. package/src/components/Select/Select.tsx +109 -98
  238. package/src/components/Select/types.ts +4 -1
  239. package/src/components/UserMenu/UserMenu.tsx +9 -6
  240. package/src/hooks/__tests__/ServiceHooks.test.tsx +16 -16
  241. package/src/hooks/__tests__/hooks.integration.test.tsx +55 -57
  242. package/src/hooks/__tests__/useAppConfig.unit.test.ts +129 -67
  243. package/src/hooks/__tests__/useFocusTrap.unit.test.tsx +97 -97
  244. package/src/hooks/__tests__/usePublicEvent.simple.test.ts +149 -67
  245. package/src/hooks/__tests__/usePublicEvent.test.ts +149 -79
  246. package/src/hooks/__tests__/usePublicEvent.unit.test.ts +158 -109
  247. package/src/hooks/__tests__/useSessionDraft.test.ts +163 -0
  248. package/src/hooks/__tests__/useSessionRestoration.unit.test.tsx +10 -5
  249. package/src/hooks/public/usePublicEvent.ts +67 -195
  250. package/src/hooks/public/usePublicEventLogo.test.ts +70 -17
  251. package/src/hooks/public/usePublicEventLogo.ts +24 -14
  252. package/src/hooks/public/usePublicFileDisplay.ts +2 -2
  253. package/src/hooks/public/usePublicRouteParams.ts +5 -5
  254. package/src/hooks/useAppConfig.ts +28 -26
  255. package/src/hooks/useEventTheme.test.ts +217 -239
  256. package/src/hooks/useEventTheme.ts +16 -28
  257. package/src/hooks/useFileDisplay.ts +2 -2
  258. package/src/hooks/useOrganisationPermissions.ts +5 -7
  259. package/src/hooks/useQueryCache.ts +0 -1
  260. package/src/hooks/useSessionDraft.ts +380 -0
  261. package/src/hooks/useSessionRestoration.ts +3 -1
  262. package/src/icons/index.ts +27 -0
  263. package/src/index.ts +5 -0
  264. package/src/providers/OrganisationProvider.tsx +23 -14
  265. package/src/providers/UnifiedAuthProvider.smoke.test.tsx +21 -21
  266. package/src/providers/__tests__/AuthProvider.test.tsx +21 -21
  267. package/src/providers/__tests__/EventProvider.test.tsx +61 -61
  268. package/src/providers/__tests__/InactivityProvider.test.tsx +56 -56
  269. package/src/providers/__tests__/OrganisationProvider.test.tsx +75 -75
  270. package/src/providers/__tests__/ProviderLifecycle.test.tsx +37 -37
  271. package/src/providers/__tests__/UnifiedAuthProvider.test.tsx +103 -103
  272. package/src/providers/services/EventServiceProvider.tsx +1 -24
  273. package/src/providers/services/UnifiedAuthProvider.tsx +5 -48
  274. package/src/providers/services/__tests__/AuthServiceProvider.integration.test.tsx +7 -7
  275. package/src/providers/services/__tests__/UnifiedAuthProvider.integration.test.tsx +13 -10
  276. package/src/rbac/__tests__/adapters.comprehensive.test.tsx +7 -457
  277. package/src/rbac/__tests__/auth-rbac.e2e.test.tsx +33 -7
  278. package/src/rbac/adapters.tsx +7 -295
  279. package/src/rbac/api.test.ts +44 -56
  280. package/src/rbac/api.ts +10 -17
  281. package/src/rbac/cache-invalidation.ts +0 -1
  282. package/src/rbac/compliance/index.ts +10 -0
  283. package/src/rbac/compliance/pattern-detector.ts +553 -0
  284. package/src/rbac/compliance/runtime-compliance.ts +22 -0
  285. package/src/rbac/components/AccessDenied.tsx +150 -0
  286. package/src/rbac/components/NavigationGuard.tsx +12 -20
  287. package/src/rbac/components/PagePermissionGuard.tsx +4 -24
  288. package/src/rbac/components/__tests__/NavigationGuard.test.tsx +21 -8
  289. package/src/rbac/components/index.ts +3 -41
  290. package/src/rbac/eslint-rules.js +1 -1
  291. package/src/rbac/hooks/index.ts +0 -3
  292. package/src/rbac/hooks/permissions/index.ts +0 -3
  293. package/src/rbac/hooks/permissions/useAccessLevel.ts +4 -8
  294. package/src/rbac/hooks/usePermissions.ts +0 -3
  295. package/src/rbac/hooks/useResolvedScope.test.ts +57 -47
  296. package/src/rbac/hooks/useResolvedScope.ts +58 -140
  297. package/src/rbac/hooks/useResourcePermissions.test.ts +124 -38
  298. package/src/rbac/hooks/useResourcePermissions.ts +139 -48
  299. package/src/rbac/hooks/useRoleManagement.test.ts +65 -22
  300. package/src/rbac/hooks/useRoleManagement.ts +147 -19
  301. package/src/rbac/hooks/useSecureSupabase.ts +4 -8
  302. package/src/rbac/index.ts +7 -9
  303. package/src/rbac/utils/contextValidator.ts +9 -7
  304. package/src/services/AuthService.ts +130 -18
  305. package/src/services/EventService.ts +4 -97
  306. package/src/services/InactivityService.ts +16 -0
  307. package/src/services/OrganisationService.ts +7 -44
  308. package/src/services/__tests__/OrganisationService.test.ts +26 -8
  309. package/src/services/base/BaseService.ts +0 -3
  310. package/src/styles/core.css +7 -0
  311. package/src/theming/__tests__/parseEventColours.test.ts +9 -3
  312. package/src/theming/parseEventColours.ts +22 -10
  313. package/src/types/database.generated.ts +4733 -3809
  314. package/src/utils/__tests__/lazyLoad.unit.test.tsx +42 -39
  315. package/src/utils/__tests__/organisationContext.unit.test.ts +9 -10
  316. package/src/utils/context/organisationContext.test.ts +13 -28
  317. package/src/utils/context/organisationContext.ts +21 -52
  318. package/src/utils/dynamic/dynamicUtils.ts +1 -1
  319. package/src/utils/file-reference/index.ts +39 -15
  320. package/src/utils/formatting/formatDateTime.test.ts +3 -2
  321. package/src/utils/google-places/loadGoogleMapsScript.ts +29 -4
  322. package/src/utils/index.ts +4 -1
  323. package/src/utils/persistence/__tests__/keyDerivation.test.ts +135 -0
  324. package/src/utils/persistence/__tests__/sensitiveFieldDetection.test.ts +123 -0
  325. package/src/utils/persistence/keyDerivation.ts +304 -0
  326. package/src/utils/persistence/sensitiveFieldDetection.ts +212 -0
  327. package/src/utils/security/secureStorage.ts +5 -5
  328. package/src/utils/storage/README.md +1 -1
  329. package/src/utils/storage/helpers.ts +3 -3
  330. package/src/utils/supabase/createBaseClient.ts +147 -0
  331. package/src/utils/timezone/timezone.test.ts +1 -2
  332. package/src/utils/timezone/timezone.ts +1 -1
  333. package/src/utils/validation/csrf.ts +4 -4
  334. package/cursor-rules/00-pace-core-compliance.mdc +0 -331
  335. package/cursor-rules/01-standards-compliance.mdc +0 -244
  336. package/cursor-rules/04-testing-standards.mdc +0 -268
  337. package/cursor-rules/05-bug-reports-and-features.mdc +0 -246
  338. package/cursor-rules/06-code-quality.mdc +0 -309
  339. package/cursor-rules/07-tech-stack-compliance.mdc +0 -214
  340. package/cursor-rules/CHANGELOG.md +0 -119
  341. package/cursor-rules/README.md +0 -192
  342. package/dist/DataTable-AOVNCPTX.js +0 -175
  343. package/dist/DataTable-AOVNCPTX.js.map +0 -1
  344. package/dist/UnifiedAuthProvider-4SBX4LU5.js +0 -18
  345. package/dist/UnifiedAuthProvider-4SBX4LU5.js.map +0 -1
  346. package/dist/api-O6HTBX5Y.js +0 -52
  347. package/dist/api-O6HTBX5Y.js.map +0 -1
  348. package/dist/audit-V53FV5AG.js +0 -17
  349. package/dist/audit-V53FV5AG.js.map +0 -1
  350. package/dist/chunk-5DRSZLL2.js.map +0 -1
  351. package/dist/chunk-63FOKYGO.js.map +0 -1
  352. package/dist/chunk-6COVEUS7.js.map +0 -1
  353. package/dist/chunk-AFVQODI2.js +0 -263
  354. package/dist/chunk-AFVQODI2.js.map +0 -1
  355. package/dist/chunk-DGUM43GV.js.map +0 -1
  356. package/dist/chunk-E66EQZE6.js.map +0 -1
  357. package/dist/chunk-EFN2EIMK.js.map +0 -1
  358. package/dist/chunk-FFQEQTNW.js.map +0 -1
  359. package/dist/chunk-FMUCXFII.js.map +0 -1
  360. package/dist/chunk-G37KK66H.js.map +0 -1
  361. package/dist/chunk-G7QEZTYQ.js +0 -2053
  362. package/dist/chunk-G7QEZTYQ.js.map +0 -1
  363. package/dist/chunk-HU2C6SSC.js.map +0 -1
  364. package/dist/chunk-IHB5DR3H.js.map +0 -1
  365. package/dist/chunk-IVOFDYWT.js.map +0 -1
  366. package/dist/chunk-J36DSWQK.js.map +0 -1
  367. package/dist/chunk-JGRYX5UX.js.map +0 -1
  368. package/dist/chunk-KQCRWDSA.js +0 -1
  369. package/dist/chunk-KQCRWDSA.js.map +0 -1
  370. package/dist/chunk-L4OXEN46.js.map +0 -1
  371. package/dist/chunk-LMC26NLJ.js +0 -84
  372. package/dist/chunk-LMC26NLJ.js.map +0 -1
  373. package/dist/chunk-M43Y4SSO.js.map +0 -1
  374. package/dist/chunk-M7MPQISP.js.map +0 -1
  375. package/dist/chunk-NTM7ZSB6.js.map +0 -1
  376. package/dist/chunk-PWLANIRT.js.map +0 -1
  377. package/dist/chunk-QXHPKYJV.js.map +0 -1
  378. package/dist/chunk-RGAWHO7N.js.map +0 -1
  379. package/dist/chunk-UPPMRMYG.js.map +0 -1
  380. package/dist/chunk-VBXEHIUJ.js.map +0 -1
  381. package/dist/chunk-ZSAAAMVR.js.map +0 -1
  382. package/dist/components.js.map +0 -1
  383. package/dist/contextValidator-5OGXSPKS.js +0 -9
  384. package/dist/contextValidator-5OGXSPKS.js.map +0 -1
  385. package/dist/eslint-rules/pace-core-compliance.cjs +0 -510
  386. package/dist/hooks.js.map +0 -1
  387. package/dist/index.js.map +0 -1
  388. package/dist/providers.js.map +0 -1
  389. package/dist/rbac/eslint-rules.js.map +0 -1
  390. package/dist/rbac/index.js.map +0 -1
  391. package/dist/styles/index.js.map +0 -1
  392. package/dist/theming/runtime.js.map +0 -1
  393. package/dist/types.js.map +0 -1
  394. package/dist/utils.js.map +0 -1
  395. package/docs/best-practices/README.md +0 -472
  396. package/docs/best-practices/accessibility.md +0 -601
  397. package/docs/best-practices/common-patterns.md +0 -516
  398. package/docs/best-practices/deployment.md +0 -1103
  399. package/docs/best-practices/performance.md +0 -1328
  400. package/docs/best-practices/security.md +0 -940
  401. package/docs/best-practices/testing.md +0 -1034
  402. package/docs/rbac/compliance/compliance-guide.md +0 -544
  403. package/docs/standards/01-architecture-standard.md +0 -44
  404. package/docs/standards/02-api-and-rpc-standard.md +0 -39
  405. package/docs/standards/03-component-standard.md +0 -32
  406. package/docs/standards/04-code-style-standard.md +0 -32
  407. package/docs/standards/05-security-standard.md +0 -44
  408. package/docs/standards/06-testing-and-docs-standard.md +0 -29
  409. package/docs/standards/pace-core-compliance.md +0 -432
  410. package/scripts/audit/core/checks/accessibility.cjs +0 -197
  411. package/scripts/audit/core/checks/api-usage.cjs +0 -191
  412. package/scripts/audit/core/checks/bundle.cjs +0 -142
  413. package/scripts/audit/core/checks/compliance.cjs +0 -2706
  414. package/scripts/audit/core/checks/config.cjs +0 -54
  415. package/scripts/audit/core/checks/coverage.cjs +0 -84
  416. package/scripts/audit/core/checks/dependencies.cjs +0 -994
  417. package/scripts/audit/core/checks/documentation.cjs +0 -268
  418. package/scripts/audit/core/checks/environment.cjs +0 -116
  419. package/scripts/audit/core/checks/error-handling.cjs +0 -340
  420. package/scripts/audit/core/checks/forms.cjs +0 -172
  421. package/scripts/audit/core/checks/heuristics.cjs +0 -68
  422. package/scripts/audit/core/checks/hooks.cjs +0 -334
  423. package/scripts/audit/core/checks/imports.cjs +0 -244
  424. package/scripts/audit/core/checks/performance.cjs +0 -325
  425. package/scripts/audit/core/checks/routes.cjs +0 -117
  426. package/scripts/audit/core/checks/state.cjs +0 -130
  427. package/scripts/audit/core/checks/structure.cjs +0 -65
  428. package/scripts/audit/core/checks/style.cjs +0 -584
  429. package/scripts/audit/core/checks/testing.cjs +0 -122
  430. package/scripts/audit/core/checks/typescript.cjs +0 -61
  431. package/scripts/audit/core/scanner.cjs +0 -199
  432. package/scripts/audit/core/utils.cjs +0 -137
  433. package/scripts/audit/index.cjs +0 -223
  434. package/scripts/audit/reporters/console.cjs +0 -151
  435. package/scripts/audit/reporters/json.cjs +0 -54
  436. package/scripts/audit/reporters/markdown.cjs +0 -124
  437. package/scripts/audit-consuming-app.cjs +0 -86
  438. package/src/components/DataTable/components/DataTableBody.tsx +0 -454
  439. package/src/components/DataTable/components/DraggableColumnHeader.tsx +0 -156
  440. package/src/components/DataTable/components/ExpandButton.tsx +0 -113
  441. package/src/components/DataTable/components/GroupHeader.tsx +0 -54
  442. package/src/components/DataTable/components/ViewRowModal.tsx +0 -68
  443. package/src/components/DataTable/components/VirtualizedDataTable.tsx +0 -525
  444. package/src/components/DataTable/components/__tests__/ExpandButton.test.tsx +0 -462
  445. package/src/components/DataTable/components/__tests__/GroupHeader.test.tsx +0 -393
  446. package/src/components/DataTable/components/__tests__/ViewRowModal.test.tsx +0 -476
  447. package/src/components/DataTable/components/__tests__/VirtualizedDataTable.test.tsx +0 -128
  448. package/src/components/DataTable/core/DataTableContext.tsx +0 -216
  449. package/src/components/DataTable/core/__tests__/DataTableContext.test.tsx +0 -136
  450. package/src/components/DataTable/hooks/__tests__/useColumnReordering.test.ts +0 -570
  451. package/src/components/DataTable/hooks/useColumnReordering.ts +0 -123
  452. package/src/components/DataTable/utils/debugTools.ts +0 -514
  453. package/src/eslint-rules/pace-core-compliance.js +0 -638
  454. package/src/rbac/components/EnhancedNavigationMenu.test.tsx +0 -555
  455. package/src/rbac/components/EnhancedNavigationMenu.tsx +0 -293
  456. package/src/rbac/components/NavigationProvider.test.tsx +0 -481
  457. package/src/rbac/components/NavigationProvider.tsx +0 -345
  458. package/src/rbac/components/PagePermissionProvider.test.tsx +0 -476
  459. package/src/rbac/components/PagePermissionProvider.tsx +0 -279
  460. package/src/rbac/components/PermissionEnforcer.tsx +0 -312
  461. package/src/rbac/components/RoleBasedRouter.tsx +0 -440
  462. package/src/rbac/components/SecureDataProvider.test.tsx +0 -543
  463. package/src/rbac/components/SecureDataProvider.tsx +0 -339
  464. package/src/rbac/components/__tests__/EnhancedNavigationMenu.test.tsx +0 -620
  465. package/src/rbac/components/__tests__/NavigationProvider.test.tsx +0 -726
  466. package/src/rbac/components/__tests__/PagePermissionProvider.test.tsx +0 -661
  467. package/src/rbac/components/__tests__/PermissionEnforcer.test.tsx +0 -881
  468. package/src/rbac/components/__tests__/RoleBasedRouter.test.tsx +0 -783
  469. package/src/rbac/components/__tests__/SecureDataProvider.fixed.test.tsx +0 -645
  470. package/src/rbac/components/__tests__/SecureDataProvider.test.tsx +0 -659
  471. package/src/rbac/hooks/permissions/useCachedPermissions.ts +0 -79
  472. package/src/rbac/hooks/permissions/useHasAllPermissions.ts +0 -90
  473. package/src/rbac/hooks/permissions/useHasAnyPermission.ts +0 -90
@@ -1,881 +0,0 @@
1
- /**
2
- * @file PermissionEnforcer Component Tests
3
- * @package @jmruthers/pace-core
4
- * @module RBAC/Components/PermissionEnforcer
5
- * @since 2.0.0
6
- *
7
- * Comprehensive tests for the PermissionEnforcer component covering all critical functionality.
8
- */
9
-
10
- import { render, screen, waitFor } from '@testing-library/react';
11
- import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
12
- import { ReactNode } from 'react';
13
- import { PermissionEnforcer } from '../PermissionEnforcer';
14
- import { useMultiplePermissions } from '../../hooks/usePermissions';
15
- import { useUnifiedAuth } from '../../../providers/services/UnifiedAuthProvider';
16
-
17
- // Mock the RBAC hooks
18
- vi.mock('../../hooks/usePermissions', () => ({
19
- useMultiplePermissions: vi.fn()
20
- }));
21
-
22
- // Mock the auth provider
23
- const mockUseUnifiedAuthFn = vi.fn();
24
- vi.mock('../../../providers/services/UnifiedAuthProvider', () => ({
25
- useUnifiedAuth: () => mockUseUnifiedAuthFn(),
26
- UnifiedAuthProvider: ({ children }: { children: React.ReactNode }) => <>{children}</>,
27
- }));
28
-
29
- // Mock the event context utility
30
- vi.mock('../../utils/eventContext', () => ({
31
- createScopeFromEvent: vi.fn()
32
- }));
33
-
34
- // Mock useResolvedScope hook
35
- vi.mock('../../hooks/useResolvedScope', () => ({
36
- useResolvedScope: vi.fn()
37
- }));
38
-
39
- // Mock the Logger module
40
- vi.mock('../../../utils/core/logger', () => {
41
- const mockLoggerInstance = {
42
- debug: vi.fn(),
43
- warn: vi.fn(),
44
- error: vi.fn(),
45
- };
46
- return {
47
- createLogger: vi.fn(() => mockLoggerInstance),
48
- };
49
- });
50
-
51
- // Get the mock instance after mock is set up
52
- import { createLogger } from '../../../utils/core/logger';
53
- const getMockLogger = () => createLogger('test');
54
-
55
- import { createScopeFromEvent } from '../../utils/eventContext';
56
- import { useResolvedScope } from '../../hooks/useResolvedScope';
57
-
58
- // Mock data
59
- const mockUser = {
60
- id: 'user-123',
61
- email: 'test@example.com'
62
- };
63
-
64
- const mockScope = {
65
- organisationId: 'org-123',
66
- eventId: 'event-123',
67
- appId: 'app-123'
68
- };
69
-
70
- const mockPermissions = ['read:events', 'update:events'] as const;
71
- const mockOperation = 'event-management';
72
-
73
- // Test component
74
- const TestComponent = ({ children }: { children: ReactNode }) => (
75
- <div data-testid="test-component">{children}</div>
76
- );
77
-
78
- const TestFallback = () => (
79
- <div data-testid="test-fallback">Access Denied</div>
80
- );
81
-
82
- const TestLoading = () => (
83
- <div data-testid="test-loading">Loading...</div>
84
- );
85
-
86
- describe('PermissionEnforcer Component', () => {
87
- const mockUseMultiplePermissions = vi.mocked(useMultiplePermissions);
88
- const mockCreateScopeFromEvent = vi.mocked(createScopeFromEvent);
89
- const mockUseResolvedScope = vi.mocked(useResolvedScope);
90
-
91
- beforeEach(() => {
92
- vi.clearAllMocks();
93
-
94
- // Default mock implementations
95
- mockUseUnifiedAuthFn.mockReturnValue({
96
- user: mockUser,
97
- selectedOrganisation: { id: 'org-123' },
98
- selectedEvent: { event_id: 'event-123' },
99
- supabase: {} as any
100
- });
101
-
102
- // Mock useResolvedScope to return resolved scope immediately
103
- mockUseResolvedScope.mockReturnValue({
104
- resolvedScope: {
105
- organisationId: 'org-123',
106
- eventId: 'event-123',
107
- appId: 'app-123'
108
- },
109
- isLoading: false,
110
- error: null
111
- });
112
-
113
- mockUseMultiplePermissions.mockReturnValue({
114
- results: {
115
- 'read:events': true,
116
- 'update:events': true
117
- } as Record<string, boolean>,
118
- isLoading: false,
119
- error: null,
120
- refetch: vi.fn()
121
- });
122
- });
123
-
124
- describe('Rendering', () => {
125
- it('renders children when permission is granted', async () => {
126
- mockUseMultiplePermissions.mockReturnValue({
127
- results: { 'read:events': true, 'update:events': true } as Record<string, boolean>,
128
- isLoading: false,
129
- error: null,
130
- refetch: vi.fn()
131
- });
132
-
133
- render(
134
- <PermissionEnforcer
135
- permissions={mockPermissions}
136
- operation={mockOperation}
137
- >
138
- <TestComponent>Protected Content</TestComponent>
139
- </PermissionEnforcer>
140
- );
141
-
142
- await waitFor(() => {
143
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
144
- expect(screen.getByText('Protected Content')).toBeInTheDocument();
145
- }, { interval: 10 });
146
- });
147
-
148
- it('renders fallback when permission is denied', async () => {
149
- mockUseMultiplePermissions.mockReturnValue({
150
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
151
- isLoading: false,
152
- error: null,
153
- refetch: vi.fn()
154
- });
155
-
156
- render(
157
- <PermissionEnforcer
158
- permissions={mockPermissions}
159
- operation={mockOperation}
160
- fallback={<TestFallback />}
161
- >
162
- <TestComponent>Protected Content</TestComponent>
163
- </PermissionEnforcer>
164
- );
165
-
166
- await waitFor(() => {
167
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
168
- expect(screen.queryByTestId('test-component')).not.toBeInTheDocument();
169
- }, { interval: 10 });
170
- });
171
-
172
- it('shows loading state during permission check', async () => {
173
- mockUseMultiplePermissions.mockReturnValue({
174
- results: {} as Record<string, boolean>,
175
- isLoading: true,
176
- error: null,
177
- refetch: vi.fn()
178
- });
179
-
180
- render(
181
- <PermissionEnforcer
182
- permissions={mockPermissions}
183
- operation={mockOperation}
184
- loading={<TestLoading />}
185
- >
186
- <TestComponent>Protected Content</TestComponent>
187
- </PermissionEnforcer>
188
- );
189
-
190
- expect(screen.getByTestId('test-loading')).toBeInTheDocument();
191
- expect(screen.queryByTestId('test-component')).not.toBeInTheDocument();
192
- });
193
-
194
- it('uses default fallback when none provided', async () => {
195
- mockUseMultiplePermissions.mockReturnValue({
196
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
197
- isLoading: false,
198
- error: null,
199
- refetch: vi.fn()
200
- });
201
-
202
- render(
203
- <PermissionEnforcer
204
- permissions={mockPermissions}
205
- operation={mockOperation}
206
- >
207
- <TestComponent>Protected Content</TestComponent>
208
- </PermissionEnforcer>
209
- );
210
-
211
- await waitFor(() => {
212
- expect(screen.getByText('Access Denied')).toBeInTheDocument();
213
- expect(screen.getByText('You don\'t have permission to perform this operation.')).toBeInTheDocument();
214
- }, { interval: 10 });
215
- });
216
-
217
- it('uses default loading when none provided', () => {
218
- mockUseMultiplePermissions.mockReturnValue({
219
- results: {} as Record<string, boolean>,
220
- isLoading: true,
221
- error: null,
222
- refetch: vi.fn()
223
- });
224
-
225
- render(
226
- <PermissionEnforcer
227
- permissions={mockPermissions}
228
- operation={mockOperation}
229
- >
230
- <TestComponent>Protected Content</TestComponent>
231
- </PermissionEnforcer>
232
- );
233
-
234
- expect(screen.getByText('Checking permissions...')).toBeInTheDocument();
235
- });
236
- });
237
-
238
- describe('Permission Checking', () => {
239
- it('enforces single permission correctly', async () => {
240
- const singlePermission = ['read:events'] as const;
241
-
242
- mockUseMultiplePermissions.mockReturnValue({
243
- results: { 'read:events': true } as Record<string, boolean>,
244
- isLoading: false,
245
- error: null,
246
- refetch: vi.fn()
247
- });
248
-
249
- render(
250
- <PermissionEnforcer
251
- permissions={singlePermission}
252
- operation={mockOperation}
253
- >
254
- <TestComponent>Protected Content</TestComponent>
255
- </PermissionEnforcer>
256
- );
257
-
258
- await waitFor(() => {
259
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
260
- }, { interval: 10 });
261
-
262
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
263
- 'user-123',
264
- {
265
- organisationId: 'org-123',
266
- eventId: 'event-123',
267
- appId: 'app-123'
268
- },
269
- ['read:events'], // singlePermission only includes read:events
270
- true
271
- );
272
- });
273
-
274
- it('enforces multiple permissions with AND logic (requireAll=true)', async () => {
275
- mockUseMultiplePermissions.mockReturnValue({
276
- results: { 'read:events': true, 'update:events': true } as Record<string, boolean>,
277
- isLoading: false,
278
- error: null,
279
- refetch: vi.fn()
280
- });
281
-
282
- render(
283
- <PermissionEnforcer
284
- permissions={mockPermissions}
285
- operation={mockOperation}
286
- requireAll={true}
287
- >
288
- <TestComponent>Protected Content</TestComponent>
289
- </PermissionEnforcer>
290
- );
291
-
292
- await waitFor(() => {
293
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
294
- }, { interval: 10 });
295
-
296
- // Should check all permissions when requireAll=true
297
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
298
- 'user-123',
299
- {
300
- organisationId: 'org-123',
301
- eventId: 'event-123',
302
- appId: 'app-123'
303
- },
304
- ['read:events', 'update:events'],
305
- true
306
- );
307
- });
308
-
309
- it('handles permission checking errors gracefully', async () => {
310
- const error = new Error('Permission check failed');
311
- mockUseMultiplePermissions.mockReturnValue({
312
- results: {} as Record<string, boolean>,
313
- isLoading: false,
314
- error,
315
- refetch: vi.fn()
316
- });
317
-
318
- render(
319
- <PermissionEnforcer
320
- permissions={mockPermissions}
321
- operation={mockOperation}
322
- fallback={<TestFallback />}
323
- >
324
- <TestComponent>Protected Content</TestComponent>
325
- </PermissionEnforcer>
326
- );
327
-
328
- await waitFor(() => {
329
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
330
- }, { interval: 10 });
331
- });
332
-
333
- it('handles empty permissions array', async () => {
334
- mockUseMultiplePermissions.mockReturnValue({
335
- results: { 'read:events': true } as Record<string, boolean>,
336
- isLoading: false,
337
- error: null,
338
- refetch: vi.fn()
339
- });
340
-
341
- render(
342
- <PermissionEnforcer
343
- permissions={[]}
344
- operation={mockOperation}
345
- >
346
- <TestComponent>Protected Content</TestComponent>
347
- </PermissionEnforcer>
348
- );
349
-
350
- await waitFor(() => {
351
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
352
- }, { interval: 10 });
353
- });
354
- });
355
-
356
- describe('Scope Resolution', () => {
357
- it('uses provided scope when available', async () => {
358
- const customScope = {
359
- organisationId: 'custom-org',
360
- eventId: 'custom-event',
361
- appId: 'custom-app'
362
- };
363
-
364
- mockUseMultiplePermissions.mockReturnValue({
365
- results: { 'read:events': true } as Record<string, boolean>,
366
- isLoading: false,
367
- error: null,
368
- refetch: vi.fn()
369
- });
370
-
371
- render(
372
- <PermissionEnforcer
373
- permissions={mockPermissions}
374
- operation={mockOperation}
375
- scope={customScope}
376
- >
377
- <TestComponent>Protected Content</TestComponent>
378
- </PermissionEnforcer>
379
- );
380
-
381
- await waitFor(() => {
382
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
383
- }, { interval: 10 });
384
-
385
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
386
- 'user-123',
387
- customScope,
388
- ['read:events', 'update:events'], // mockPermissions includes both
389
- true
390
- );
391
- });
392
-
393
- it('resolves scope from organisation and event context', async () => {
394
- mockUseMultiplePermissions.mockReturnValue({
395
- results: { 'read:events': true } as Record<string, boolean>,
396
- isLoading: false,
397
- error: null,
398
- refetch: vi.fn()
399
- });
400
-
401
- render(
402
- <PermissionEnforcer
403
- permissions={mockPermissions}
404
- operation={mockOperation}
405
- >
406
- <TestComponent>Protected Content</TestComponent>
407
- </PermissionEnforcer>
408
- );
409
-
410
- await waitFor(() => {
411
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
412
- }, { interval: 10 });
413
-
414
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
415
- 'user-123',
416
- {
417
- organisationId: 'org-123',
418
- eventId: 'event-123',
419
- appId: 'app-123'
420
- },
421
- ['read:events', 'update:events'], // mockPermissions includes both
422
- true
423
- );
424
- });
425
-
426
- it('resolves scope from organisation only (org-required app)', async () => {
427
- // For org-required apps, organisation is primary context, event is optional
428
- mockUseUnifiedAuthFn.mockReturnValue({
429
- user: mockUser,
430
- selectedOrganisation: { id: 'org-123' },
431
- selectedEvent: null,
432
- supabase: {} as any
433
- });
434
-
435
- mockUseResolvedScope.mockReturnValue({
436
- resolvedScope: {
437
- organisationId: 'org-123',
438
- eventId: undefined,
439
- appId: 'app-123'
440
- },
441
- isLoading: false,
442
- error: null
443
- });
444
-
445
- mockUseMultiplePermissions.mockReturnValue({
446
- results: { 'read:events': true } as Record<string, boolean>,
447
- isLoading: false,
448
- error: null,
449
- refetch: vi.fn()
450
- });
451
-
452
- render(
453
- <PermissionEnforcer
454
- permissions={mockPermissions}
455
- operation={mockOperation}
456
- >
457
- <TestComponent>Protected Content</TestComponent>
458
- </PermissionEnforcer>
459
- );
460
-
461
- await waitFor(() => {
462
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
463
- }, { interval: 10 });
464
-
465
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
466
- 'user-123',
467
- {
468
- organisationId: 'org-123',
469
- eventId: undefined,
470
- appId: 'app-123'
471
- },
472
- ['read:events', 'update:events'], // mockPermissions includes both
473
- true
474
- );
475
- });
476
-
477
- it('resolves scope from event context when organisation not available (event-required app)', async () => {
478
- // For event-required apps, selectedOrganisation is null, org is derived from event
479
- mockUseUnifiedAuthFn.mockReturnValue({
480
- user: mockUser,
481
- selectedOrganisation: null, // Not available for event-required apps
482
- selectedEvent: { event_id: 'event-123' },
483
- supabase: {} as any
484
- });
485
-
486
- mockUseResolvedScope.mockReturnValue({
487
- resolvedScope: {
488
- organisationId: 'resolved-org',
489
- eventId: 'event-123',
490
- appId: 'resolved-app'
491
- },
492
- isLoading: false,
493
- error: null
494
- });
495
-
496
- mockUseMultiplePermissions.mockReturnValue({
497
- results: { 'read:events': true } as Record<string, boolean>,
498
- isLoading: false,
499
- error: null,
500
- refetch: vi.fn()
501
- });
502
-
503
- render(
504
- <PermissionEnforcer
505
- permissions={mockPermissions}
506
- operation={mockOperation}
507
- >
508
- <TestComponent>Protected Content</TestComponent>
509
- </PermissionEnforcer>
510
- );
511
-
512
- await waitFor(() => {
513
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
514
- }, { interval: 10 });
515
-
516
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
517
- 'user-123',
518
- {
519
- organisationId: 'resolved-org',
520
- eventId: 'event-123',
521
- appId: 'resolved-app'
522
- },
523
- ['read:events', 'update:events'], // mockPermissions includes both
524
- true
525
- );
526
- });
527
-
528
- it('handles scope resolution errors', async () => {
529
- mockUseUnifiedAuthFn.mockReturnValue({
530
- user: mockUser,
531
- selectedOrganisation: null,
532
- selectedEvent: { event_id: 'event-123' },
533
- supabase: {} as any
534
- });
535
-
536
- const error = new Error('Could not resolve organisation from event');
537
- mockUseResolvedScope.mockReturnValue({
538
- resolvedScope: null,
539
- isLoading: false,
540
- error
541
- });
542
-
543
- render(
544
- <PermissionEnforcer
545
- permissions={mockPermissions}
546
- operation={mockOperation}
547
- fallback={<TestFallback />}
548
- >
549
- <TestComponent>Protected Content</TestComponent>
550
- </PermissionEnforcer>
551
- );
552
-
553
- await waitFor(() => {
554
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
555
- }, { interval: 10 });
556
- });
557
-
558
- it('handles missing context gracefully', async () => {
559
- mockUseUnifiedAuthFn.mockReturnValue({
560
- user: mockUser,
561
- selectedOrganisation: null,
562
- selectedEvent: null,
563
- supabase: null
564
- });
565
-
566
- mockUseResolvedScope.mockReturnValue({
567
- resolvedScope: null,
568
- isLoading: true,
569
- error: null
570
- });
571
-
572
- render(
573
- <PermissionEnforcer
574
- permissions={mockPermissions}
575
- operation={mockOperation}
576
- fallback={<TestFallback />}
577
- >
578
- <TestComponent>Protected Content</TestComponent>
579
- </PermissionEnforcer>
580
- );
581
-
582
- expect(screen.getByText('Checking permissions...')).toBeInTheDocument();
583
- });
584
- });
585
-
586
- describe('Security Features', () => {
587
- it('prevents bypassing in strict mode', async () => {
588
- const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
589
-
590
- mockUseMultiplePermissions.mockReturnValue({
591
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
592
- isLoading: false,
593
- error: null,
594
- refetch: vi.fn()
595
- });
596
-
597
- render(
598
- <PermissionEnforcer
599
- permissions={mockPermissions}
600
- operation={mockOperation}
601
- strictMode={true}
602
- fallback={<TestFallback />}
603
- >
604
- <TestComponent>Protected Content</TestComponent>
605
- </PermissionEnforcer>
606
- );
607
-
608
- await waitFor(() => {
609
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
610
- }, { interval: 10 });
611
-
612
- expect(consoleSpy).toHaveBeenCalledWith(
613
- expect.stringContaining('STRICT MODE VIOLATION'),
614
- expect.objectContaining({
615
- permissions: mockPermissions,
616
- operation: mockOperation,
617
- userId: 'user-123'
618
- })
619
- );
620
-
621
- consoleSpy.mockRestore();
622
- });
623
-
624
- it('logs security violations for audit', async () => {
625
- mockUseMultiplePermissions.mockReturnValue({
626
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
627
- isLoading: false,
628
- error: null,
629
- refetch: vi.fn()
630
- });
631
-
632
- render(
633
- <PermissionEnforcer
634
- permissions={mockPermissions}
635
- operation={mockOperation}
636
- auditLog={true}
637
- fallback={<TestFallback />}
638
- >
639
- <TestComponent>Protected Content</TestComponent>
640
- </PermissionEnforcer>
641
- );
642
-
643
- await waitFor(() => {
644
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
645
- }, { interval: 10 });
646
-
647
- const logger = getMockLogger();
648
- expect(vi.mocked(logger.debug)).toHaveBeenCalledWith(
649
- 'Permission check attempt:',
650
- expect.objectContaining({
651
- permissions: mockPermissions,
652
- operation: mockOperation,
653
- userId: 'user-123',
654
- allowed: false
655
- })
656
- );
657
- });
658
-
659
- it('calls onDenied callback when access is denied', async () => {
660
- const onDeniedSpy = vi.fn();
661
-
662
- mockUseMultiplePermissions.mockReturnValue({
663
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
664
- isLoading: false,
665
- error: null,
666
- refetch: vi.fn()
667
- });
668
-
669
- render(
670
- <PermissionEnforcer
671
- permissions={mockPermissions}
672
- operation={mockOperation}
673
- onDenied={onDeniedSpy}
674
- fallback={<TestFallback />}
675
- >
676
- <TestComponent>Protected Content</TestComponent>
677
- </PermissionEnforcer>
678
- );
679
-
680
- await waitFor(() => {
681
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
682
- }, { interval: 10 });
683
-
684
- expect(onDeniedSpy).toHaveBeenCalledWith(mockPermissions, mockOperation);
685
- });
686
-
687
- it('does not call onDenied when access is granted', async () => {
688
- const onDeniedSpy = vi.fn();
689
-
690
- mockUseMultiplePermissions.mockReturnValue({
691
- results: { 'read:events': true } as Record<string, boolean>,
692
- isLoading: false,
693
- error: null,
694
- refetch: vi.fn()
695
- });
696
-
697
- render(
698
- <PermissionEnforcer
699
- permissions={mockPermissions}
700
- operation={mockOperation}
701
- onDenied={onDeniedSpy}
702
- >
703
- <TestComponent>Protected Content</TestComponent>
704
- </PermissionEnforcer>
705
- );
706
-
707
- await waitFor(() => {
708
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
709
- }, { interval: 10 });
710
-
711
- expect(onDeniedSpy).not.toHaveBeenCalled();
712
- });
713
- });
714
-
715
- describe('Configuration Options', () => {
716
- it('respects strictMode setting', async () => {
717
- const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
718
-
719
- mockUseMultiplePermissions.mockReturnValue({
720
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
721
- isLoading: false,
722
- error: null,
723
- refetch: vi.fn()
724
- });
725
-
726
- render(
727
- <PermissionEnforcer
728
- permissions={mockPermissions}
729
- operation={mockOperation}
730
- strictMode={false}
731
- fallback={<TestFallback />}
732
- >
733
- <TestComponent>Protected Content</TestComponent>
734
- </PermissionEnforcer>
735
- );
736
-
737
- await waitFor(() => {
738
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
739
- }, { interval: 10 });
740
-
741
- expect(consoleSpy).not.toHaveBeenCalledWith(
742
- expect.stringContaining('STRICT MODE VIOLATION')
743
- );
744
-
745
- consoleSpy.mockRestore();
746
- });
747
-
748
- it('respects auditLog setting', async () => {
749
- const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
750
-
751
- mockUseMultiplePermissions.mockReturnValue({
752
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
753
- isLoading: false,
754
- error: null,
755
- refetch: vi.fn()
756
- });
757
-
758
- render(
759
- <PermissionEnforcer
760
- permissions={mockPermissions}
761
- operation={mockOperation}
762
- auditLog={false}
763
- fallback={<TestFallback />}
764
- >
765
- <TestComponent>Protected Content</TestComponent>
766
- </PermissionEnforcer>
767
- );
768
-
769
- await waitFor(() => {
770
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
771
- }, { interval: 10 });
772
-
773
- expect(consoleSpy).not.toHaveBeenCalledWith(
774
- expect.stringContaining('Permission check attempt')
775
- );
776
-
777
- consoleSpy.mockRestore();
778
- });
779
-
780
- it('respects requireAll=false (any permission granted)', async () => {
781
- mockUseMultiplePermissions.mockReturnValue({
782
- results: { 'read:events': true, 'update:events': false } as Record<string, boolean>,
783
- isLoading: false,
784
- error: null,
785
- refetch: vi.fn()
786
- });
787
-
788
- render(
789
- <PermissionEnforcer
790
- permissions={mockPermissions}
791
- operation={mockOperation}
792
- requireAll={false}
793
- >
794
- <TestComponent>Protected Content</TestComponent>
795
- </PermissionEnforcer>
796
- );
797
-
798
- await waitFor(() => {
799
- expect(screen.getByTestId('test-component')).toBeInTheDocument();
800
- }, { interval: 10 });
801
-
802
- // Should check all permissions and allow access if any is granted
803
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
804
- 'user-123',
805
- expect.objectContaining({
806
- organisationId: 'org-123',
807
- eventId: 'event-123'
808
- }),
809
- ['read:events', 'update:events'],
810
- true
811
- );
812
- });
813
- });
814
-
815
- describe('Error Handling', () => {
816
- it('handles missing user gracefully', async () => {
817
- mockUseUnifiedAuthFn.mockReturnValue({
818
- user: null,
819
- selectedOrganisation: { id: 'org-123' },
820
- selectedEvent: { event_id: 'event-123' },
821
- supabase: {} as any
822
- });
823
-
824
- mockUseMultiplePermissions.mockReturnValue({
825
- results: { 'read:events': false, 'update:events': false } as Record<string, boolean>,
826
- isLoading: false,
827
- error: null,
828
- refetch: vi.fn()
829
- });
830
-
831
- render(
832
- <PermissionEnforcer
833
- permissions={mockPermissions}
834
- operation={mockOperation}
835
- fallback={<TestFallback />}
836
- >
837
- <TestComponent>Protected Content</TestComponent>
838
- </PermissionEnforcer>
839
- );
840
-
841
- await waitFor(() => {
842
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
843
- }, { interval: 10 });
844
-
845
- expect(mockUseMultiplePermissions).toHaveBeenCalledWith(
846
- '',
847
- {
848
- organisationId: 'org-123',
849
- eventId: 'event-123',
850
- appId: 'app-123'
851
- },
852
- ['read:events', 'update:events'], // mockPermissions includes both
853
- true
854
- );
855
- });
856
-
857
- it('handles permission check errors', async () => {
858
- const error = new Error('Database connection failed');
859
- mockUseMultiplePermissions.mockReturnValue({
860
- results: {} as Record<string, boolean>,
861
- isLoading: false,
862
- error,
863
- refetch: vi.fn()
864
- });
865
-
866
- render(
867
- <PermissionEnforcer
868
- permissions={mockPermissions}
869
- operation={mockOperation}
870
- fallback={<TestFallback />}
871
- >
872
- <TestComponent>Protected Content</TestComponent>
873
- </PermissionEnforcer>
874
- );
875
-
876
- await waitFor(() => {
877
- expect(screen.getByTestId('test-fallback')).toBeInTheDocument();
878
- }, { interval: 10 });
879
- });
880
- });
881
- });