@jmruthers/pace-core 0.6.4 → 0.6.6

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 (387) hide show
  1. package/CHANGELOG.md +104 -0
  2. package/README.md +5 -403
  3. package/core-usage-manifest.json +93 -0
  4. package/cursor-rules/00-pace-core-compliance.mdc +128 -26
  5. package/cursor-rules/01-standards-compliance.mdc +49 -8
  6. package/cursor-rules/02-project-structure.mdc +6 -0
  7. package/cursor-rules/03-solid-principles.mdc +2 -0
  8. package/cursor-rules/04-testing-standards.mdc +2 -0
  9. package/cursor-rules/05-bug-reports-and-features.mdc +2 -0
  10. package/cursor-rules/06-code-quality.mdc +2 -0
  11. package/cursor-rules/07-tech-stack-compliance.mdc +2 -0
  12. package/cursor-rules/08-markup-quality.mdc +52 -27
  13. package/cursor-rules/09-rbac-compliance.mdc +462 -0
  14. package/cursor-rules/10-error-handling-patterns.mdc +179 -0
  15. package/cursor-rules/11-performance-optimization.mdc +169 -0
  16. package/cursor-rules/12-ci-cd-integration.mdc +150 -0
  17. package/dist/{AuthService-Cb34EQs3.d.ts → AuthService-DmfO5rGS.d.ts} +10 -0
  18. package/dist/{DataTable-BMRU8a1j.d.ts → DataTable-2N_tqbfq.d.ts} +1 -1
  19. package/dist/DataTable-LRJL4IRV.js +15 -0
  20. package/dist/{PublicPageProvider-DEMpysFR.d.ts → PublicPageProvider-BBH6Vqg7.d.ts} +72 -139
  21. package/dist/UnifiedAuthProvider-ZT6TIGM7.js +7 -0
  22. package/dist/api-Y4MQWOFW.js +4 -0
  23. package/dist/audit-MYQXYZFU.js +3 -0
  24. package/dist/{chunk-J36DSWQK.js → chunk-2HGJFNAH.js} +8 -28
  25. package/dist/{chunk-OEWDTMG7.js → chunk-3O3WHILE.js} +38 -121
  26. package/dist/{chunk-M43Y4SSO.js → chunk-3QC3KRHK.js} +1 -14
  27. package/dist/{chunk-DGUM43GV.js → chunk-3RG5ZIWI.js} +1 -4
  28. package/dist/{chunk-QXHPKYJV.js → chunk-4SXLQIZO.js} +1 -26
  29. package/dist/chunk-4T7OBVTU.js +62 -0
  30. package/dist/{chunk-E66EQZE6.js → chunk-6GLLNA6U.js} +3 -9
  31. package/dist/{chunk-ZSAAAMVR.js → chunk-6QYDGKQY.js} +1 -4
  32. package/dist/{chunk-NN6WWZ5U.js → chunk-7TYHROIV.js} +579 -563
  33. package/dist/{chunk-M7MPQISP.js → chunk-A55DK444.js} +9 -16
  34. package/dist/{chunk-63FOKYGO.js → chunk-AHU7G2R5.js} +2 -11
  35. package/dist/{chunk-L4OXEN46.js → chunk-BVP2BCJF.js} +2 -16
  36. package/dist/chunk-C7NSAPTL.js +1 -0
  37. package/dist/{chunk-YKRAFF5K.js → chunk-FENMYN2U.js} +73 -149
  38. package/dist/{chunk-AVMLPIM7.js → chunk-FTCRZOG2.js} +284 -432
  39. package/dist/{chunk-G37KK66H.js → chunk-FYHN4DD5.js} +60 -19
  40. package/dist/{chunk-VBXEHIUJ.js → chunk-HF6O3O37.js} +6 -88
  41. package/dist/{chunk-I6DAQMWX.js → chunk-LAZMKTTF.js} +930 -891
  42. package/dist/{chunk-5EC5MEWX.js → chunk-MAGBIDNS.js} +77 -222
  43. package/dist/chunk-MBADTM7L.js +64 -0
  44. package/dist/chunk-OHIK3MIO.js +994 -0
  45. package/dist/{chunk-6SOIHG6Z.js → chunk-S7DKJPLT.js} +115 -44
  46. package/dist/{chunk-FMUCXFII.js → chunk-SD6WQY43.js} +1 -5
  47. package/dist/{chunk-PWLANIRT.js → chunk-TTRFSOKR.js} +1 -7
  48. package/dist/{chunk-5DRSZLL2.js → chunk-UH3NTO3F.js} +1 -6
  49. package/dist/{chunk-FFQEQTNW.js → chunk-UIYSCEV7.js} +134 -45
  50. package/dist/{chunk-3LPHPB62.js → chunk-ZFYPMX46.js} +271 -87
  51. package/dist/{chunk-7JPAB3T5.js → chunk-ZS5VO5JB.js} +1989 -1283
  52. package/dist/components.d.ts +6 -6
  53. package/dist/components.js +57 -267
  54. package/dist/{database.generated-CzIvgcPu.d.ts → database.generated-CcnC_DRc.d.ts} +4795 -3691
  55. package/dist/eslint-rules/index.cjs +22 -0
  56. package/dist/eslint-rules/rules/compliance.cjs +348 -0
  57. package/dist/eslint-rules/rules/components.cjs +113 -0
  58. package/dist/eslint-rules/rules/imports.cjs +102 -0
  59. package/dist/eslint-rules/rules/rbac.cjs +790 -0
  60. package/dist/eslint-rules/utils/helpers.cjs +42 -0
  61. package/dist/eslint-rules/utils/manifest-loader.cjs +75 -0
  62. package/dist/hooks.d.ts +5 -5
  63. package/dist/hooks.js +62 -270
  64. package/dist/icons/index.d.ts +1 -0
  65. package/dist/icons/index.js +1 -0
  66. package/dist/index.d.ts +36 -26
  67. package/dist/index.js +87 -690
  68. package/dist/providers.d.ts +2 -2
  69. package/dist/providers.js +8 -35
  70. package/dist/rbac/eslint-rules.d.ts +46 -44
  71. package/dist/rbac/eslint-rules.js +7 -4
  72. package/dist/rbac/index.d.ts +124 -594
  73. package/dist/rbac/index.js +14 -207
  74. package/dist/styles/index.js +2 -12
  75. package/dist/theming/runtime.js +3 -19
  76. package/dist/{timezone-CHhWg6b4.d.ts → timezone-BZe_eUxx.d.ts} +175 -1
  77. package/dist/{types-CkbwOr4Y.d.ts → types-B-K_5VnO.d.ts} +4 -0
  78. package/dist/types-t9H8qKRw.d.ts +55 -0
  79. package/dist/types.d.ts +1 -1
  80. package/dist/types.js +7 -94
  81. package/dist/{usePublicRouteParams-i3qtoBgg.d.ts → usePublicRouteParams-COZ28Mvq.d.ts} +9 -9
  82. package/dist/utils.d.ts +24 -117
  83. package/dist/utils.js +54 -392
  84. package/docs/README.md +16 -6
  85. package/docs/api/README.md +4 -402
  86. package/docs/api/modules.md +454 -930
  87. package/docs/api-reference/components.md +3 -1
  88. package/docs/api-reference/deprecated.md +31 -6
  89. package/docs/api-reference/rpc-functions.md +78 -3
  90. package/docs/best-practices/accessibility.md +6 -3
  91. package/docs/getting-started/cursor-rules.md +3 -23
  92. package/docs/getting-started/dependencies.md +650 -0
  93. package/docs/getting-started/installation-guide.md +20 -7
  94. package/docs/getting-started/quick-start.md +23 -12
  95. package/docs/implementation-guides/permission-enforcement.md +4 -0
  96. package/docs/rbac/MIGRATION_GUIDE.md +819 -0
  97. package/docs/rbac/RBAC_CONTRACT.md +724 -0
  98. package/docs/rbac/README.md +12 -3
  99. package/docs/rbac/edge-functions-guide.md +376 -0
  100. package/docs/rbac/secure-client-protection.md +0 -34
  101. package/docs/standards/00-pace-core-compliance.md +967 -0
  102. package/docs/standards/01-standards-compliance.md +188 -0
  103. package/docs/standards/02-project-structure.md +985 -0
  104. package/docs/standards/03-solid-principles.md +39 -0
  105. package/docs/standards/04-testing-standards.md +36 -0
  106. package/docs/standards/05-bug-reports-and-features.md +27 -0
  107. package/docs/standards/{04-code-style-standard.md → 06-code-quality.md} +2 -0
  108. package/docs/standards/07-tech-stack-compliance.md +30 -0
  109. package/docs/standards/08-markup-quality.md +345 -0
  110. package/docs/standards/{07-rbac-and-rls-standard.md → 09-rbac-compliance.md} +149 -54
  111. package/docs/standards/10-error-handling-patterns.md +401 -0
  112. package/docs/standards/11-performance-optimization.md +348 -0
  113. package/docs/standards/12-ci-cd-integration.md +370 -0
  114. package/docs/standards/ALIGNMENT_REVIEW_SUMMARY.md +192 -0
  115. package/docs/standards/README.md +62 -33
  116. package/docs/troubleshooting/organisation-context-setup.md +42 -19
  117. package/eslint-config-pace-core.cjs +20 -4
  118. package/package.json +31 -21
  119. package/scripts/audit/audit-compliance.cjs +1295 -0
  120. package/scripts/audit/audit-components.cjs +260 -0
  121. package/scripts/audit/audit-dependencies.cjs +395 -0
  122. package/scripts/audit/audit-rbac.cjs +954 -0
  123. package/scripts/audit/audit-standards.cjs +1268 -0
  124. package/scripts/audit/index.cjs +1898 -194
  125. package/scripts/install-cursor-rules.cjs +259 -8
  126. package/scripts/validate-master.js +1 -1
  127. package/src/__tests__/fixtures/supabase.ts +1 -1
  128. package/src/__tests__/helpers/__tests__/component-test-utils.test.tsx +1 -1
  129. package/src/__tests__/helpers/__tests__/optimized-test-setup.test.ts +1 -1
  130. package/src/__tests__/helpers/__tests__/supabaseMock.test.ts +1 -1
  131. package/src/__tests__/helpers/__tests__/test-utils.test.tsx +3 -3
  132. package/src/__tests__/helpers/component-test-utils.tsx +1 -1
  133. package/src/__tests__/helpers/supabaseMock.ts +2 -2
  134. package/src/__tests__/public-recipe-view.test.ts +38 -9
  135. package/src/components/Button/Button.tsx +5 -1
  136. package/src/components/ContextSelector/ContextSelector.tsx +42 -39
  137. package/src/components/DataTable/__tests__/keyboard.test.tsx +15 -2
  138. package/src/components/DataTable/components/DataTableBody.tsx +55 -31
  139. package/src/components/DataTable/components/DataTableCore.tsx +186 -13
  140. package/src/components/DataTable/components/DataTableLayout.tsx +30 -5
  141. package/src/components/DataTable/components/EditFields.tsx +23 -3
  142. package/src/components/DataTable/components/EditableRow.tsx +7 -2
  143. package/src/components/DataTable/components/ImportModal.tsx +4 -6
  144. package/src/components/DataTable/components/RowComponent.tsx +12 -0
  145. package/src/components/DataTable/components/ViewRowModal.tsx +4 -4
  146. package/src/components/DataTable/components/__tests__/ImportModal.test.tsx +455 -96
  147. package/src/components/DataTable/components/__tests__/ViewRowModal.test.tsx +122 -58
  148. package/src/components/DataTable/components/hooks/usePermissionTracking.ts +0 -4
  149. package/src/components/DataTable/core/DataTableContext.tsx +1 -1
  150. package/src/components/DataTable/hooks/__tests__/useDataTableState.test.ts +51 -47
  151. package/src/components/DataTable/hooks/useDataTablePermissions.ts +24 -21
  152. package/src/components/DataTable/hooks/useDataTableState.ts +125 -9
  153. package/src/components/DataTable/hooks/useTableColumns.ts +40 -2
  154. package/src/components/DataTable/hooks/useTableHandlers.ts +11 -0
  155. package/src/components/DataTable/types.ts +5 -0
  156. package/src/components/DateTimeField/DateTimeField.tsx +20 -20
  157. package/src/components/DateTimeField/README.md +5 -2
  158. package/src/components/Dialog/Dialog.test.tsx +361 -318
  159. package/src/components/Dialog/Dialog.tsx +1154 -323
  160. package/src/components/Dialog/index.ts +3 -3
  161. package/src/components/FileDisplay/FileDisplay.test.tsx +45 -2
  162. package/src/components/FileDisplay/FileDisplay.tsx +28 -22
  163. package/src/components/Form/Form.test.tsx +9 -10
  164. package/src/components/Form/Form.tsx +369 -9
  165. package/src/components/InactivityWarningModal/InactivityWarningModal.test.tsx +28 -28
  166. package/src/components/InactivityWarningModal/InactivityWarningModal.tsx +40 -54
  167. package/src/components/LoginForm/LoginForm.tsx +2 -2
  168. package/src/components/NavigationMenu/NavigationMenu.test.tsx +14 -13
  169. package/src/components/NavigationMenu/NavigationMenu.tsx +2 -2
  170. package/src/components/NavigationMenu/useNavigationFiltering.ts +11 -21
  171. package/src/components/PaceAppLayout/PaceAppLayout.test.tsx +6 -4
  172. package/src/components/PaceAppLayout/PaceAppLayout.tsx +30 -41
  173. package/src/components/PaceAppLayout/README.md +10 -9
  174. package/src/components/PaceAppLayout/test-setup.tsx +40 -31
  175. package/src/components/PaceLoginPage/PaceLoginPage.test.tsx +108 -61
  176. package/src/components/PaceLoginPage/PaceLoginPage.tsx +27 -3
  177. package/src/components/PasswordChange/PasswordChangeForm.test.tsx +61 -0
  178. package/src/components/PasswordChange/PasswordChangeForm.tsx +20 -13
  179. package/src/components/PublicLayout/PublicLayout.test.tsx +7 -3
  180. package/src/components/PublicLayout/PublicPageLayout.tsx +5 -8
  181. package/src/components/Select/Select.tsx +23 -21
  182. package/src/components/Select/types.ts +1 -1
  183. package/src/components/UserMenu/UserMenu.test.tsx +38 -6
  184. package/src/components/UserMenu/UserMenu.tsx +39 -34
  185. package/src/components/index.ts +3 -4
  186. package/src/eslint-rules/index.cjs +22 -0
  187. package/src/eslint-rules/rules/compliance.cjs +348 -0
  188. package/src/eslint-rules/rules/components.cjs +113 -0
  189. package/src/eslint-rules/rules/imports.cjs +102 -0
  190. package/src/eslint-rules/rules/rbac.cjs +790 -0
  191. package/src/eslint-rules/utils/helpers.cjs +42 -0
  192. package/src/eslint-rules/utils/manifest-loader.cjs +75 -0
  193. package/src/hooks/__tests__/hooks.integration.test.tsx +6 -8
  194. package/src/hooks/__tests__/useAppConfig.unit.test.ts +129 -67
  195. package/src/hooks/__tests__/usePublicEvent.simple.test.ts +149 -67
  196. package/src/hooks/__tests__/usePublicEvent.test.ts +149 -79
  197. package/src/hooks/__tests__/usePublicEvent.unit.test.ts +158 -109
  198. package/src/hooks/__tests__/useSessionDraft.test.ts +163 -0
  199. package/src/hooks/__tests__/useSessionRestoration.unit.test.tsx +10 -5
  200. package/src/hooks/public/usePublicEvent.ts +62 -190
  201. package/src/hooks/public/usePublicEventLogo.test.ts +70 -17
  202. package/src/hooks/public/usePublicEventLogo.ts +19 -9
  203. package/src/hooks/useAppConfig.ts +26 -24
  204. package/src/hooks/useEventTheme.test.ts +211 -233
  205. package/src/hooks/useEventTheme.ts +19 -28
  206. package/src/hooks/useEvents.ts +11 -7
  207. package/src/hooks/useKeyboardShortcuts.ts +1 -1
  208. package/src/hooks/useOrganisationPermissions.ts +9 -11
  209. package/src/hooks/useOrganisations.ts +13 -7
  210. package/src/hooks/useQueryCache.ts +0 -1
  211. package/src/hooks/useSessionDraft.ts +380 -0
  212. package/src/hooks/useSessionRestoration.ts +3 -1
  213. package/src/icons/index.ts +27 -0
  214. package/src/index.ts +16 -1
  215. package/src/providers/OrganisationProvider.tsx +23 -14
  216. package/src/providers/services/EventServiceProvider.tsx +1 -24
  217. package/src/providers/services/UnifiedAuthProvider.tsx +5 -48
  218. package/src/providers/services/__tests__/UnifiedAuthProvider.integration.test.tsx +3 -0
  219. package/src/rbac/README.md +20 -20
  220. package/src/rbac/__tests__/adapters.comprehensive.test.tsx +7 -457
  221. package/src/rbac/__tests__/auth-rbac.e2e.test.tsx +33 -7
  222. package/src/rbac/adapters.tsx +7 -295
  223. package/src/rbac/api.test.ts +44 -56
  224. package/src/rbac/api.ts +10 -17
  225. package/src/rbac/cache-invalidation.ts +0 -1
  226. package/src/rbac/compliance/index.ts +10 -0
  227. package/src/rbac/compliance/pattern-detector.ts +553 -0
  228. package/src/rbac/compliance/runtime-compliance.ts +22 -0
  229. package/src/rbac/components/AccessDenied.tsx +150 -0
  230. package/src/rbac/components/NavigationGuard.tsx +12 -20
  231. package/src/rbac/components/PagePermissionGuard.tsx +4 -24
  232. package/src/rbac/components/__tests__/NavigationGuard.test.tsx +21 -8
  233. package/src/rbac/components/index.ts +3 -41
  234. package/src/rbac/eslint-rules.js +1 -1
  235. package/src/rbac/hooks/index.ts +0 -3
  236. package/src/rbac/hooks/permissions/index.ts +0 -3
  237. package/src/rbac/hooks/permissions/useAccessLevel.ts +4 -8
  238. package/src/rbac/hooks/usePermissions.ts +0 -3
  239. package/src/rbac/hooks/useRBAC.test.ts +21 -3
  240. package/src/rbac/hooks/useRBAC.ts +4 -3
  241. package/src/rbac/hooks/useResolvedScope.test.ts +57 -47
  242. package/src/rbac/hooks/useResolvedScope.ts +58 -140
  243. package/src/rbac/hooks/useResourcePermissions.test.ts +241 -60
  244. package/src/rbac/hooks/useResourcePermissions.ts +182 -63
  245. package/src/rbac/hooks/useRoleManagement.test.ts +65 -22
  246. package/src/rbac/hooks/useRoleManagement.ts +147 -19
  247. package/src/rbac/hooks/useSecureSupabase.ts +4 -8
  248. package/src/rbac/index.ts +7 -9
  249. package/src/rbac/permissions.ts +17 -17
  250. package/src/rbac/utils/contextValidator.ts +45 -7
  251. package/src/services/AuthService.ts +132 -23
  252. package/src/services/EventService.ts +4 -97
  253. package/src/services/InactivityService.ts +155 -58
  254. package/src/services/OrganisationService.ts +7 -44
  255. package/src/services/__tests__/OrganisationService.test.ts +26 -8
  256. package/src/services/base/BaseService.ts +0 -3
  257. package/src/styles/core.css +4 -0
  258. package/src/types/database.generated.ts +4733 -3809
  259. package/src/utils/__tests__/organisationContext.unit.test.ts +9 -10
  260. package/src/utils/context/organisationContext.test.ts +13 -28
  261. package/src/utils/context/organisationContext.ts +21 -52
  262. package/src/utils/dynamic/dynamicUtils.ts +1 -1
  263. package/src/utils/file-reference/index.ts +39 -15
  264. package/src/utils/formatting/formatDateTime.test.ts +3 -2
  265. package/src/utils/formatting/formatTime.test.ts +3 -2
  266. package/src/utils/google-places/loadGoogleMapsScript.ts +29 -4
  267. package/src/utils/index.ts +4 -1
  268. package/src/utils/persistence/__tests__/keyDerivation.test.ts +135 -0
  269. package/src/utils/persistence/__tests__/sensitiveFieldDetection.test.ts +123 -0
  270. package/src/utils/persistence/keyDerivation.ts +304 -0
  271. package/src/utils/persistence/sensitiveFieldDetection.ts +212 -0
  272. package/src/utils/security/secureStorage.ts +5 -5
  273. package/src/utils/storage/helpers.ts +3 -3
  274. package/src/utils/supabase/createBaseClient.ts +147 -0
  275. package/src/utils/timezone/timezone.test.ts +1 -2
  276. package/src/utils/timezone/timezone.ts +1 -1
  277. package/src/utils/validation/csrf.ts +4 -4
  278. package/cursor-rules/CHANGELOG.md +0 -119
  279. package/cursor-rules/README.md +0 -192
  280. package/dist/DataTable-E7YQZD7D.js +0 -175
  281. package/dist/DataTable-E7YQZD7D.js.map +0 -1
  282. package/dist/UnifiedAuthProvider-QPXO24B4.js +0 -18
  283. package/dist/UnifiedAuthProvider-QPXO24B4.js.map +0 -1
  284. package/dist/api-6LVZTHDS.js +0 -52
  285. package/dist/api-6LVZTHDS.js.map +0 -1
  286. package/dist/audit-V53FV5AG.js +0 -17
  287. package/dist/audit-V53FV5AG.js.map +0 -1
  288. package/dist/chunk-36LVWXB2.js +0 -227
  289. package/dist/chunk-36LVWXB2.js.map +0 -1
  290. package/dist/chunk-3LPHPB62.js.map +0 -1
  291. package/dist/chunk-5DRSZLL2.js.map +0 -1
  292. package/dist/chunk-5EC5MEWX.js.map +0 -1
  293. package/dist/chunk-63FOKYGO.js.map +0 -1
  294. package/dist/chunk-6SOIHG6Z.js.map +0 -1
  295. package/dist/chunk-7JPAB3T5.js.map +0 -1
  296. package/dist/chunk-ATKZM7RX.js +0 -2053
  297. package/dist/chunk-ATKZM7RX.js.map +0 -1
  298. package/dist/chunk-AVMLPIM7.js.map +0 -1
  299. package/dist/chunk-DGUM43GV.js.map +0 -1
  300. package/dist/chunk-E66EQZE6.js.map +0 -1
  301. package/dist/chunk-FFQEQTNW.js.map +0 -1
  302. package/dist/chunk-FMUCXFII.js.map +0 -1
  303. package/dist/chunk-G37KK66H.js.map +0 -1
  304. package/dist/chunk-I6DAQMWX.js.map +0 -1
  305. package/dist/chunk-J36DSWQK.js.map +0 -1
  306. package/dist/chunk-KQCRWDSA.js +0 -1
  307. package/dist/chunk-KQCRWDSA.js.map +0 -1
  308. package/dist/chunk-L4OXEN46.js.map +0 -1
  309. package/dist/chunk-LMC26NLJ.js +0 -84
  310. package/dist/chunk-LMC26NLJ.js.map +0 -1
  311. package/dist/chunk-M43Y4SSO.js.map +0 -1
  312. package/dist/chunk-M7MPQISP.js.map +0 -1
  313. package/dist/chunk-NN6WWZ5U.js.map +0 -1
  314. package/dist/chunk-OEWDTMG7.js.map +0 -1
  315. package/dist/chunk-PWLANIRT.js.map +0 -1
  316. package/dist/chunk-QXHPKYJV.js.map +0 -1
  317. package/dist/chunk-VBXEHIUJ.js.map +0 -1
  318. package/dist/chunk-YKRAFF5K.js.map +0 -1
  319. package/dist/chunk-ZSAAAMVR.js.map +0 -1
  320. package/dist/components.js.map +0 -1
  321. package/dist/contextValidator-OOPCLPZW.js +0 -9
  322. package/dist/contextValidator-OOPCLPZW.js.map +0 -1
  323. package/dist/eslint-rules/pace-core-compliance.cjs +0 -510
  324. package/dist/hooks.js.map +0 -1
  325. package/dist/index.js.map +0 -1
  326. package/dist/providers.js.map +0 -1
  327. package/dist/rbac/eslint-rules.js.map +0 -1
  328. package/dist/rbac/index.js.map +0 -1
  329. package/dist/styles/index.js.map +0 -1
  330. package/dist/theming/runtime.js.map +0 -1
  331. package/dist/types.js.map +0 -1
  332. package/dist/utils.js.map +0 -1
  333. package/docs/standards/01-architecture-standard.md +0 -44
  334. package/docs/standards/02-api-and-rpc-standard.md +0 -39
  335. package/docs/standards/03-component-standard.md +0 -32
  336. package/docs/standards/05-security-standard.md +0 -44
  337. package/docs/standards/06-testing-and-docs-standard.md +0 -29
  338. package/docs/standards/pace-core-compliance.md +0 -432
  339. package/scripts/audit/core/checks/accessibility.cjs +0 -197
  340. package/scripts/audit/core/checks/api-usage.cjs +0 -191
  341. package/scripts/audit/core/checks/bundle.cjs +0 -142
  342. package/scripts/audit/core/checks/compliance.cjs +0 -2706
  343. package/scripts/audit/core/checks/config.cjs +0 -54
  344. package/scripts/audit/core/checks/coverage.cjs +0 -84
  345. package/scripts/audit/core/checks/dependencies.cjs +0 -994
  346. package/scripts/audit/core/checks/documentation.cjs +0 -268
  347. package/scripts/audit/core/checks/environment.cjs +0 -116
  348. package/scripts/audit/core/checks/error-handling.cjs +0 -340
  349. package/scripts/audit/core/checks/forms.cjs +0 -172
  350. package/scripts/audit/core/checks/heuristics.cjs +0 -68
  351. package/scripts/audit/core/checks/hooks.cjs +0 -334
  352. package/scripts/audit/core/checks/imports.cjs +0 -244
  353. package/scripts/audit/core/checks/performance.cjs +0 -325
  354. package/scripts/audit/core/checks/routes.cjs +0 -117
  355. package/scripts/audit/core/checks/state.cjs +0 -130
  356. package/scripts/audit/core/checks/structure.cjs +0 -65
  357. package/scripts/audit/core/checks/style.cjs +0 -584
  358. package/scripts/audit/core/checks/testing.cjs +0 -122
  359. package/scripts/audit/core/checks/typescript.cjs +0 -61
  360. package/scripts/audit/core/scanner.cjs +0 -199
  361. package/scripts/audit/core/utils.cjs +0 -137
  362. package/scripts/audit/reporters/console.cjs +0 -151
  363. package/scripts/audit/reporters/json.cjs +0 -54
  364. package/scripts/audit/reporters/markdown.cjs +0 -124
  365. package/scripts/audit-consuming-app.cjs +0 -86
  366. package/src/eslint-rules/pace-core-compliance.cjs +0 -510
  367. package/src/eslint-rules/pace-core-compliance.js +0 -638
  368. package/src/rbac/components/EnhancedNavigationMenu.test.tsx +0 -555
  369. package/src/rbac/components/EnhancedNavigationMenu.tsx +0 -293
  370. package/src/rbac/components/NavigationProvider.test.tsx +0 -481
  371. package/src/rbac/components/NavigationProvider.tsx +0 -345
  372. package/src/rbac/components/PagePermissionProvider.test.tsx +0 -476
  373. package/src/rbac/components/PagePermissionProvider.tsx +0 -279
  374. package/src/rbac/components/PermissionEnforcer.tsx +0 -312
  375. package/src/rbac/components/RoleBasedRouter.tsx +0 -440
  376. package/src/rbac/components/SecureDataProvider.test.tsx +0 -543
  377. package/src/rbac/components/SecureDataProvider.tsx +0 -339
  378. package/src/rbac/components/__tests__/EnhancedNavigationMenu.test.tsx +0 -620
  379. package/src/rbac/components/__tests__/NavigationProvider.test.tsx +0 -726
  380. package/src/rbac/components/__tests__/PagePermissionProvider.test.tsx +0 -661
  381. package/src/rbac/components/__tests__/PermissionEnforcer.test.tsx +0 -881
  382. package/src/rbac/components/__tests__/RoleBasedRouter.test.tsx +0 -783
  383. package/src/rbac/components/__tests__/SecureDataProvider.fixed.test.tsx +0 -645
  384. package/src/rbac/components/__tests__/SecureDataProvider.test.tsx +0 -659
  385. package/src/rbac/hooks/permissions/useCachedPermissions.ts +0 -79
  386. package/src/rbac/hooks/permissions/useHasAllPermissions.ts +0 -90
  387. 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
- });