@jmruthers/pace-core 0.5.189 → 0.5.190

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 (420) hide show
  1. package/core-usage-manifest.json +0 -4
  2. package/dist/{AuthService-B-cd2MA4.d.ts → AuthService-CbP_utw2.d.ts} +7 -3
  3. package/dist/{DataTable-GUFUNZ3N.js → DataTable-ON3IXISJ.js} +8 -8
  4. package/dist/{PublicPageProvider-B8HaLe69.d.ts → PublicPageProvider-C4uxosp6.d.ts} +83 -24
  5. package/dist/{UnifiedAuthProvider-BG0AL5eE.d.ts → UnifiedAuthProvider-BYA9qB-o.d.ts} +4 -3
  6. package/dist/{UnifiedAuthProvider-643PUAIM.js → UnifiedAuthProvider-X5NXANVI.js} +4 -2
  7. package/dist/{api-YP7XD5L6.js → api-I6UCQ5S6.js} +4 -2
  8. package/dist/{chunk-DDM4CCYT.js → chunk-4QYC5L4K.js} +60 -35
  9. package/dist/chunk-4QYC5L4K.js.map +1 -0
  10. package/dist/{chunk-IM4QE42D.js → chunk-73HSNNOQ.js} +141 -326
  11. package/dist/chunk-73HSNNOQ.js.map +1 -0
  12. package/dist/{chunk-YHCN776L.js → chunk-DZWK57KZ.js} +2 -75
  13. package/dist/chunk-DZWK57KZ.js.map +1 -0
  14. package/dist/{chunk-3GOZZZYH.js → chunk-HQVPB5MZ.js} +238 -301
  15. package/dist/chunk-HQVPB5MZ.js.map +1 -0
  16. package/dist/{chunk-THRPYOFK.js → chunk-HW3OVDUF.js} +5 -5
  17. package/dist/chunk-HW3OVDUF.js.map +1 -0
  18. package/dist/{chunk-F2IMUDXZ.js → chunk-I7PSE6JW.js} +75 -2
  19. package/dist/chunk-I7PSE6JW.js.map +1 -0
  20. package/dist/{chunk-VGZZXKBR.js → chunk-J2XXC7R5.js} +280 -52
  21. package/dist/chunk-J2XXC7R5.js.map +1 -0
  22. package/dist/{chunk-UCQSRW7Z.js → chunk-NIU6J6OX.js} +425 -378
  23. package/dist/chunk-NIU6J6OX.js.map +1 -0
  24. package/dist/{chunk-HESYZWZW.js → chunk-QWWZ5CAQ.js} +2 -2
  25. package/dist/{chunk-HEHYGYOX.js → chunk-RUYZKXOD.js} +401 -46
  26. package/dist/chunk-RUYZKXOD.js.map +1 -0
  27. package/dist/{chunk-2UUZZJFT.js → chunk-SDMHPX3X.js} +176 -160
  28. package/dist/{chunk-2UUZZJFT.js.map → chunk-SDMHPX3X.js.map} +1 -1
  29. package/dist/{chunk-MX64ZF6I.js → chunk-STYK4OH2.js} +11 -11
  30. package/dist/chunk-STYK4OH2.js.map +1 -0
  31. package/dist/{chunk-YGPFYGA6.js → chunk-VVBAW5A5.js} +822 -498
  32. package/dist/chunk-VVBAW5A5.js.map +1 -0
  33. package/dist/chunk-Y4BUBBHD.js +614 -0
  34. package/dist/chunk-Y4BUBBHD.js.map +1 -0
  35. package/dist/{chunk-SAUPYVLF.js → chunk-ZSAAAMVR.js} +1 -1
  36. package/dist/chunk-ZSAAAMVR.js.map +1 -0
  37. package/dist/components.d.ts +3 -4
  38. package/dist/components.js +19 -19
  39. package/dist/components.js.map +1 -1
  40. package/dist/eslint-rules/pace-core-compliance.cjs +0 -2
  41. package/dist/{file-reference-D037xOFK.d.ts → file-reference-BavO2eQj.d.ts} +13 -10
  42. package/dist/hooks.d.ts +10 -5
  43. package/dist/hooks.js +14 -8
  44. package/dist/hooks.js.map +1 -1
  45. package/dist/index.d.ts +13 -11
  46. package/dist/index.js +79 -69
  47. package/dist/index.js.map +1 -1
  48. package/dist/providers.d.ts +3 -3
  49. package/dist/providers.js +3 -1
  50. package/dist/rbac/index.d.ts +76 -12
  51. package/dist/rbac/index.js +12 -9
  52. package/dist/types.d.ts +1 -1
  53. package/dist/types.js +1 -1
  54. package/dist/{usePublicRouteParams-CTDELQ7H.d.ts → usePublicRouteParams-DxIDS4bC.d.ts} +16 -9
  55. package/dist/utils.js +16 -16
  56. package/docs/README.md +2 -2
  57. package/docs/api/classes/ColumnFactory.md +1 -1
  58. package/docs/api/classes/ErrorBoundary.md +1 -1
  59. package/docs/api/classes/InvalidScopeError.md +2 -2
  60. package/docs/api/classes/Logger.md +1 -1
  61. package/docs/api/classes/MissingUserContextError.md +2 -2
  62. package/docs/api/classes/OrganisationContextRequiredError.md +1 -1
  63. package/docs/api/classes/PermissionDeniedError.md +1 -1
  64. package/docs/api/classes/RBACAuditManager.md +1 -1
  65. package/docs/api/classes/RBACCache.md +1 -1
  66. package/docs/api/classes/RBACEngine.md +4 -4
  67. package/docs/api/classes/RBACError.md +1 -1
  68. package/docs/api/classes/RBACNotInitializedError.md +2 -2
  69. package/docs/api/classes/SecureSupabaseClient.md +21 -16
  70. package/docs/api/classes/StorageUtils.md +7 -4
  71. package/docs/api/enums/FileCategory.md +1 -1
  72. package/docs/api/enums/LogLevel.md +1 -1
  73. package/docs/api/enums/RBACErrorCode.md +1 -1
  74. package/docs/api/enums/RPCFunction.md +1 -1
  75. package/docs/api/interfaces/AddressFieldProps.md +1 -1
  76. package/docs/api/interfaces/AddressFieldRef.md +1 -1
  77. package/docs/api/interfaces/AggregateConfig.md +1 -1
  78. package/docs/api/interfaces/AutocompleteOptions.md +1 -1
  79. package/docs/api/interfaces/AvatarProps.md +1 -1
  80. package/docs/api/interfaces/BadgeProps.md +1 -1
  81. package/docs/api/interfaces/ButtonProps.md +1 -1
  82. package/docs/api/interfaces/CalendarProps.md +20 -6
  83. package/docs/api/interfaces/CardProps.md +1 -1
  84. package/docs/api/interfaces/ColorPalette.md +1 -1
  85. package/docs/api/interfaces/ColorShade.md +1 -1
  86. package/docs/api/interfaces/ComplianceResult.md +1 -1
  87. package/docs/api/interfaces/DataAccessRecord.md +9 -9
  88. package/docs/api/interfaces/DataRecord.md +1 -1
  89. package/docs/api/interfaces/DataTableAction.md +1 -1
  90. package/docs/api/interfaces/DataTableColumn.md +1 -1
  91. package/docs/api/interfaces/DataTableProps.md +1 -1
  92. package/docs/api/interfaces/DataTableToolbarButton.md +1 -1
  93. package/docs/api/interfaces/DatabaseComplianceResult.md +1 -1
  94. package/docs/api/interfaces/DatabaseIssue.md +1 -1
  95. package/docs/api/interfaces/EmptyStateConfig.md +1 -1
  96. package/docs/api/interfaces/EnhancedNavigationMenuProps.md +1 -1
  97. package/docs/api/interfaces/EventAppRoleData.md +1 -1
  98. package/docs/api/interfaces/ExportColumn.md +1 -1
  99. package/docs/api/interfaces/ExportOptions.md +1 -1
  100. package/docs/api/interfaces/FileDisplayProps.md +62 -16
  101. package/docs/api/interfaces/FileMetadata.md +1 -1
  102. package/docs/api/interfaces/FileReference.md +2 -2
  103. package/docs/api/interfaces/FileSizeLimits.md +1 -1
  104. package/docs/api/interfaces/FileUploadOptions.md +26 -12
  105. package/docs/api/interfaces/FileUploadProps.md +30 -19
  106. package/docs/api/interfaces/FooterProps.md +1 -1
  107. package/docs/api/interfaces/FormFieldProps.md +1 -1
  108. package/docs/api/interfaces/FormProps.md +1 -1
  109. package/docs/api/interfaces/GrantEventAppRoleParams.md +1 -1
  110. package/docs/api/interfaces/InactivityWarningModalProps.md +1 -1
  111. package/docs/api/interfaces/InputProps.md +1 -1
  112. package/docs/api/interfaces/LabelProps.md +1 -1
  113. package/docs/api/interfaces/LoggerConfig.md +1 -1
  114. package/docs/api/interfaces/LoginFormProps.md +1 -1
  115. package/docs/api/interfaces/NavigationAccessRecord.md +10 -10
  116. package/docs/api/interfaces/NavigationContextType.md +9 -9
  117. package/docs/api/interfaces/NavigationGuardProps.md +1 -1
  118. package/docs/api/interfaces/NavigationItem.md +1 -1
  119. package/docs/api/interfaces/NavigationMenuProps.md +1 -1
  120. package/docs/api/interfaces/NavigationProviderProps.md +7 -7
  121. package/docs/api/interfaces/Organisation.md +1 -1
  122. package/docs/api/interfaces/OrganisationContextType.md +1 -1
  123. package/docs/api/interfaces/OrganisationMembership.md +1 -1
  124. package/docs/api/interfaces/OrganisationProviderProps.md +1 -1
  125. package/docs/api/interfaces/OrganisationSecurityError.md +1 -1
  126. package/docs/api/interfaces/PaceAppLayoutProps.md +1 -1
  127. package/docs/api/interfaces/PaceLoginPageProps.md +1 -1
  128. package/docs/api/interfaces/PageAccessRecord.md +8 -8
  129. package/docs/api/interfaces/PagePermissionContextType.md +8 -8
  130. package/docs/api/interfaces/PagePermissionGuardProps.md +1 -1
  131. package/docs/api/interfaces/PagePermissionProviderProps.md +7 -7
  132. package/docs/api/interfaces/PaletteData.md +1 -1
  133. package/docs/api/interfaces/ParsedAddress.md +1 -1
  134. package/docs/api/interfaces/PermissionEnforcerProps.md +1 -1
  135. package/docs/api/interfaces/ProgressProps.md +3 -11
  136. package/docs/api/interfaces/ProtectedRouteProps.md +1 -1
  137. package/docs/api/interfaces/PublicPageFooterProps.md +1 -1
  138. package/docs/api/interfaces/PublicPageHeaderProps.md +1 -1
  139. package/docs/api/interfaces/PublicPageLayoutProps.md +1 -1
  140. package/docs/api/interfaces/QuickFix.md +1 -1
  141. package/docs/api/interfaces/RBACAccessValidateParams.md +1 -1
  142. package/docs/api/interfaces/RBACAccessValidateResult.md +1 -1
  143. package/docs/api/interfaces/RBACAuditLogParams.md +1 -1
  144. package/docs/api/interfaces/RBACAuditLogResult.md +1 -1
  145. package/docs/api/interfaces/RBACConfig.md +1 -1
  146. package/docs/api/interfaces/RBACContext.md +1 -1
  147. package/docs/api/interfaces/RBACLogger.md +1 -1
  148. package/docs/api/interfaces/RBACPageAccessCheckParams.md +1 -1
  149. package/docs/api/interfaces/RBACPerformanceMetrics.md +1 -1
  150. package/docs/api/interfaces/RBACPermissionCheckParams.md +1 -1
  151. package/docs/api/interfaces/RBACPermissionCheckResult.md +1 -1
  152. package/docs/api/interfaces/RBACPermissionsGetParams.md +1 -1
  153. package/docs/api/interfaces/RBACPermissionsGetResult.md +1 -1
  154. package/docs/api/interfaces/RBACResult.md +1 -1
  155. package/docs/api/interfaces/RBACRoleGrantParams.md +1 -1
  156. package/docs/api/interfaces/RBACRoleGrantResult.md +1 -1
  157. package/docs/api/interfaces/RBACRoleRevokeParams.md +1 -1
  158. package/docs/api/interfaces/RBACRoleRevokeResult.md +1 -1
  159. package/docs/api/interfaces/RBACRoleValidateParams.md +1 -1
  160. package/docs/api/interfaces/RBACRoleValidateResult.md +1 -1
  161. package/docs/api/interfaces/RBACRolesListParams.md +1 -1
  162. package/docs/api/interfaces/RBACRolesListResult.md +1 -1
  163. package/docs/api/interfaces/RBACSessionTrackParams.md +1 -1
  164. package/docs/api/interfaces/RBACSessionTrackResult.md +1 -1
  165. package/docs/api/interfaces/ResourcePermissions.md +1 -1
  166. package/docs/api/interfaces/RevokeEventAppRoleParams.md +1 -1
  167. package/docs/api/interfaces/RoleBasedRouterContextType.md +8 -8
  168. package/docs/api/interfaces/RoleBasedRouterProps.md +10 -10
  169. package/docs/api/interfaces/RoleManagementResult.md +1 -1
  170. package/docs/api/interfaces/RouteAccessRecord.md +10 -10
  171. package/docs/api/interfaces/RouteConfig.md +10 -10
  172. package/docs/api/interfaces/RuntimeComplianceResult.md +1 -1
  173. package/docs/api/interfaces/SecureDataContextType.md +9 -9
  174. package/docs/api/interfaces/SecureDataProviderProps.md +8 -8
  175. package/docs/api/interfaces/SessionRestorationLoaderProps.md +1 -1
  176. package/docs/api/interfaces/SetupIssue.md +1 -1
  177. package/docs/api/interfaces/StorageConfig.md +4 -4
  178. package/docs/api/interfaces/StorageFileInfo.md +7 -7
  179. package/docs/api/interfaces/StorageFileMetadata.md +25 -14
  180. package/docs/api/interfaces/StorageListOptions.md +22 -9
  181. package/docs/api/interfaces/StorageListResult.md +4 -4
  182. package/docs/api/interfaces/StorageUploadOptions.md +21 -8
  183. package/docs/api/interfaces/StorageUploadResult.md +6 -6
  184. package/docs/api/interfaces/StorageUrlOptions.md +19 -6
  185. package/docs/api/interfaces/StyleImport.md +1 -1
  186. package/docs/api/interfaces/SwitchProps.md +1 -1
  187. package/docs/api/interfaces/TabsContentProps.md +1 -1
  188. package/docs/api/interfaces/TabsListProps.md +1 -1
  189. package/docs/api/interfaces/TabsProps.md +1 -1
  190. package/docs/api/interfaces/TabsTriggerProps.md +1 -1
  191. package/docs/api/interfaces/TextareaProps.md +1 -1
  192. package/docs/api/interfaces/ToastActionElement.md +1 -1
  193. package/docs/api/interfaces/ToastProps.md +1 -1
  194. package/docs/api/interfaces/UnifiedAuthContextType.md +53 -53
  195. package/docs/api/interfaces/UnifiedAuthProviderProps.md +13 -13
  196. package/docs/api/interfaces/UseFormDialogOptions.md +1 -1
  197. package/docs/api/interfaces/UseFormDialogReturn.md +1 -1
  198. package/docs/api/interfaces/UseInactivityTrackerOptions.md +1 -1
  199. package/docs/api/interfaces/UseInactivityTrackerReturn.md +1 -1
  200. package/docs/api/interfaces/UsePublicEventLogoOptions.md +1 -1
  201. package/docs/api/interfaces/UsePublicEventLogoReturn.md +1 -1
  202. package/docs/api/interfaces/UsePublicEventOptions.md +1 -1
  203. package/docs/api/interfaces/UsePublicEventReturn.md +1 -1
  204. package/docs/api/interfaces/UsePublicFileDisplayOptions.md +1 -1
  205. package/docs/api/interfaces/UsePublicFileDisplayReturn.md +1 -1
  206. package/docs/api/interfaces/UsePublicRouteParamsReturn.md +1 -1
  207. package/docs/api/interfaces/UseResolvedScopeOptions.md +4 -4
  208. package/docs/api/interfaces/UseResolvedScopeReturn.md +4 -4
  209. package/docs/api/interfaces/UseResourcePermissionsOptions.md +1 -1
  210. package/docs/api/interfaces/UserEventAccess.md +11 -11
  211. package/docs/api/interfaces/UserMenuProps.md +1 -1
  212. package/docs/api/interfaces/UserProfile.md +1 -1
  213. package/docs/api/modules.md +151 -92
  214. package/docs/api-reference/components.md +15 -7
  215. package/docs/api-reference/providers.md +2 -2
  216. package/docs/api-reference/rpc-functions.md +1 -0
  217. package/docs/best-practices/README.md +1 -1
  218. package/docs/best-practices/deployment.md +8 -8
  219. package/docs/getting-started/examples/README.md +2 -2
  220. package/docs/getting-started/installation-guide.md +4 -4
  221. package/docs/getting-started/quick-start.md +3 -3
  222. package/docs/migration/MIGRATION_GUIDE.md +3 -3
  223. package/docs/rbac/compliance/compliance-guide.md +2 -2
  224. package/docs/rbac/event-based-apps.md +2 -2
  225. package/docs/rbac/getting-started.md +2 -2
  226. package/docs/rbac/quick-start.md +2 -2
  227. package/docs/security/README.md +4 -4
  228. package/docs/standards/07-rbac-and-rls-standard.md +430 -7
  229. package/docs/troubleshooting/README.md +2 -2
  230. package/docs/troubleshooting/migration.md +3 -3
  231. package/package.json +1 -3
  232. package/scripts/check-pace-core-compliance.cjs +1 -1
  233. package/scripts/check-pace-core-compliance.js +1 -1
  234. package/src/__tests__/fixtures/supabase.ts +301 -0
  235. package/src/__tests__/public-recipe-view.test.ts +9 -9
  236. package/src/__tests__/rls-policies.test.ts +197 -61
  237. package/src/components/AddressField/AddressField.test.tsx +42 -0
  238. package/src/components/AddressField/AddressField.tsx +71 -60
  239. package/src/components/AddressField/README.md +1 -0
  240. package/src/components/Alert/Alert.test.tsx +50 -10
  241. package/src/components/Alert/Alert.tsx +5 -3
  242. package/src/components/Avatar/Avatar.test.tsx +95 -43
  243. package/src/components/Avatar/Avatar.tsx +16 -16
  244. package/src/components/Button/Button.test.tsx +2 -1
  245. package/src/components/Button/Button.tsx +3 -3
  246. package/src/components/Calendar/Calendar.test.tsx +53 -37
  247. package/src/components/Calendar/Calendar.tsx +409 -82
  248. package/src/components/Card/Card.test.tsx +7 -4
  249. package/src/components/Card/Card.tsx +3 -6
  250. package/src/components/Checkbox/Checkbox.tsx +2 -2
  251. package/src/components/DataTable/components/ActionButtons.tsx +5 -5
  252. package/src/components/DataTable/components/BulkOperationsDropdown.tsx +2 -2
  253. package/src/components/DataTable/components/ColumnFilter.tsx +1 -1
  254. package/src/components/DataTable/components/ColumnVisibilityDropdown.tsx +3 -3
  255. package/src/components/DataTable/components/DataTableBody.tsx +12 -12
  256. package/src/components/DataTable/components/DataTableCore.tsx +3 -3
  257. package/src/components/DataTable/components/DataTableToolbar.tsx +5 -5
  258. package/src/components/DataTable/components/DraggableColumnHeader.tsx +3 -3
  259. package/src/components/DataTable/components/EditableRow.tsx +2 -2
  260. package/src/components/DataTable/components/EmptyState.tsx +3 -3
  261. package/src/components/DataTable/components/GroupHeader.tsx +2 -2
  262. package/src/components/DataTable/components/GroupingDropdown.tsx +1 -1
  263. package/src/components/DataTable/components/ImportModal.tsx +4 -4
  264. package/src/components/DataTable/components/LoadingState.tsx +1 -1
  265. package/src/components/DataTable/components/PaginationControls.tsx +11 -11
  266. package/src/components/DataTable/components/UnifiedTableBody.tsx +9 -9
  267. package/src/components/DataTable/components/ViewRowModal.tsx +2 -2
  268. package/src/components/DataTable/components/__tests__/AccessDeniedPage.test.tsx +11 -37
  269. package/src/components/DataTable/components/__tests__/DataTableToolbar.test.tsx +157 -0
  270. package/src/components/DataTable/components/__tests__/LoadingState.test.tsx +2 -1
  271. package/src/components/DataTable/components/__tests__/VirtualizedDataTable.test.tsx +128 -0
  272. package/src/components/DataTable/core/__tests__/ActionManager.test.ts +19 -0
  273. package/src/components/DataTable/core/__tests__/ColumnFactory.test.ts +51 -0
  274. package/src/components/DataTable/core/__tests__/ColumnManager.test.ts +84 -0
  275. package/src/components/DataTable/core/__tests__/DataManager.test.ts +14 -0
  276. package/src/components/DataTable/core/__tests__/DataTableContext.test.tsx +136 -0
  277. package/src/components/DataTable/core/__tests__/LocalDataAdapter.test.ts +16 -0
  278. package/src/components/DataTable/core/__tests__/PluginRegistry.test.ts +18 -0
  279. package/src/components/DataTable/hooks/useDataTablePermissions.ts +28 -7
  280. package/src/components/DataTable/utils/__tests__/hierarchicalUtils.test.ts +30 -1
  281. package/src/components/DataTable/utils/hierarchicalUtils.ts +38 -10
  282. package/src/components/DatePickerWithTimezone/DatePickerWithTimezone.test.tsx +8 -3
  283. package/src/components/DatePickerWithTimezone/DatePickerWithTimezone.tsx +4 -4
  284. package/src/components/Dialog/Dialog.tsx +2 -2
  285. package/src/components/EventSelector/EventSelector.tsx +7 -7
  286. package/src/components/FileDisplay/FileDisplay.tsx +291 -179
  287. package/src/components/FileUpload/FileUpload.tsx +7 -4
  288. package/src/components/Header/Header.test.tsx +28 -0
  289. package/src/components/Header/Header.tsx +22 -9
  290. package/src/components/InactivityWarningModal/InactivityWarningModal.tsx +2 -2
  291. package/src/components/LoadingSpinner/LoadingSpinner.test.tsx +19 -14
  292. package/src/components/LoadingSpinner/LoadingSpinner.tsx +5 -5
  293. package/src/components/NavigationMenu/NavigationMenu.test.tsx +127 -1
  294. package/src/components/OrganisationSelector/OrganisationSelector.tsx +8 -8
  295. package/src/components/PaceAppLayout/PaceAppLayout.integration.test.tsx +4 -0
  296. package/src/components/PaceAppLayout/PaceAppLayout.performance.test.tsx +3 -0
  297. package/src/components/PaceAppLayout/PaceAppLayout.security.test.tsx +3 -0
  298. package/src/components/PaceAppLayout/PaceAppLayout.test.tsx +16 -6
  299. package/src/components/PaceAppLayout/PaceAppLayout.tsx +37 -3
  300. package/src/components/PaceAppLayout/test-setup.tsx +1 -0
  301. package/src/components/PaceLoginPage/PaceLoginPage.test.tsx +66 -45
  302. package/src/components/PaceLoginPage/PaceLoginPage.tsx +6 -4
  303. package/src/components/Progress/Progress.test.tsx +18 -19
  304. package/src/components/Progress/Progress.tsx +31 -32
  305. package/src/components/PublicLayout/PublicLayout.test.tsx +6 -6
  306. package/src/components/PublicLayout/PublicPageProvider.tsx +5 -3
  307. package/src/components/Select/Select.tsx +5 -5
  308. package/src/components/Switch/Switch.test.tsx +2 -1
  309. package/src/components/Switch/Switch.tsx +1 -1
  310. package/src/components/Toast/Toast.tsx +1 -1
  311. package/src/components/Tooltip/Tooltip.test.tsx +8 -2
  312. package/src/components/UserMenu/UserMenu.tsx +3 -3
  313. package/src/eslint-rules/pace-core-compliance.cjs +0 -2
  314. package/src/eslint-rules/pace-core-compliance.js +0 -2
  315. package/src/hooks/__tests__/hooks.integration.test.tsx +4 -1
  316. package/src/hooks/__tests__/useAppConfig.unit.test.ts +76 -5
  317. package/src/hooks/__tests__/useDataTableState.test.ts +76 -0
  318. package/src/hooks/__tests__/useFileUrl.unit.test.ts +25 -69
  319. package/src/hooks/__tests__/useFileUrlCache.test.ts +129 -0
  320. package/src/hooks/__tests__/usePreventTabReload.test.ts +88 -0
  321. package/src/hooks/__tests__/{usePublicEvent.unit.test.ts → usePublicEvent.test.ts} +28 -1
  322. package/src/hooks/__tests__/useQueryCache.test.ts +144 -0
  323. package/src/hooks/__tests__/useSecureDataAccess.unit.test.tsx +58 -16
  324. package/src/hooks/index.ts +1 -1
  325. package/src/hooks/public/usePublicEvent.ts +2 -2
  326. package/src/hooks/public/usePublicFileDisplay.ts +173 -87
  327. package/src/hooks/useAppConfig.ts +24 -5
  328. package/src/hooks/useFileDisplay.ts +297 -34
  329. package/src/hooks/useFileReference.ts +56 -11
  330. package/src/hooks/useFileUrl.ts +1 -1
  331. package/src/hooks/useInactivityTracker.ts +16 -7
  332. package/src/hooks/usePermissionCache.test.ts +85 -8
  333. package/src/hooks/useQueryCache.ts +21 -0
  334. package/src/hooks/useSecureDataAccess.test.ts +80 -35
  335. package/src/hooks/useSecureDataAccess.ts +80 -37
  336. package/src/providers/services/EventServiceProvider.tsx +37 -17
  337. package/src/providers/services/InactivityServiceProvider.tsx +4 -4
  338. package/src/providers/services/OrganisationServiceProvider.tsx +8 -1
  339. package/src/providers/services/UnifiedAuthProvider.tsx +115 -29
  340. package/src/rbac/__tests__/auth-rbac.e2e.test.tsx +451 -0
  341. package/src/rbac/__tests__/engine.comprehensive.test.ts +12 -0
  342. package/src/rbac/__tests__/rbac-engine-core-logic.test.ts +8 -0
  343. package/src/rbac/__tests__/rbac-engine-simplified.test.ts +4 -0
  344. package/src/rbac/api.ts +240 -36
  345. package/src/rbac/cache-invalidation.ts +21 -7
  346. package/src/rbac/compliance/quick-fix-suggestions.ts +1 -1
  347. package/src/rbac/components/NavigationGuard.tsx +23 -63
  348. package/src/rbac/components/NavigationProvider.test.tsx +52 -23
  349. package/src/rbac/components/NavigationProvider.tsx +13 -11
  350. package/src/rbac/components/PagePermissionGuard.tsx +77 -203
  351. package/src/rbac/components/PagePermissionProvider.tsx +13 -11
  352. package/src/rbac/components/PermissionEnforcer.tsx +24 -62
  353. package/src/rbac/components/RoleBasedRouter.tsx +14 -12
  354. package/src/rbac/components/SecureDataProvider.tsx +13 -11
  355. package/src/rbac/components/__tests__/NavigationGuard.test.tsx +104 -41
  356. package/src/rbac/components/__tests__/NavigationProvider.test.tsx +49 -12
  357. package/src/rbac/components/__tests__/PagePermissionGuard.race-condition.test.tsx +22 -1
  358. package/src/rbac/components/__tests__/PagePermissionGuard.test.tsx +161 -82
  359. package/src/rbac/components/__tests__/PagePermissionGuard.verification.test.tsx +22 -1
  360. package/src/rbac/components/__tests__/PermissionEnforcer.test.tsx +77 -30
  361. package/src/rbac/components/__tests__/RoleBasedRouter.test.tsx +39 -5
  362. package/src/rbac/components/__tests__/SecureDataProvider.test.tsx +47 -4
  363. package/src/rbac/engine.ts +4 -2
  364. package/src/rbac/hooks/__tests__/useSecureSupabase.test.ts +144 -52
  365. package/src/rbac/hooks/index.ts +3 -0
  366. package/src/rbac/hooks/useCan.test.ts +101 -53
  367. package/src/rbac/hooks/usePermissions.ts +108 -41
  368. package/src/rbac/hooks/useRBAC.test.ts +11 -3
  369. package/src/rbac/hooks/useRBAC.ts +83 -40
  370. package/src/rbac/hooks/useResolvedScope.test.ts +189 -63
  371. package/src/rbac/hooks/useResolvedScope.ts +128 -70
  372. package/src/rbac/hooks/useSecureSupabase.ts +36 -19
  373. package/src/rbac/hooks/useSuperAdminBypass.ts +126 -0
  374. package/src/rbac/request-deduplication.ts +1 -1
  375. package/src/rbac/secureClient.ts +72 -12
  376. package/src/rbac/security.ts +29 -23
  377. package/src/rbac/types.ts +10 -0
  378. package/src/rbac/utils/__tests__/contextValidator.test.ts +150 -0
  379. package/src/rbac/utils/__tests__/deep-equal.test.ts +53 -0
  380. package/src/rbac/utils/__tests__/eventContext.test.ts +6 -1
  381. package/src/rbac/utils/contextValidator.ts +288 -0
  382. package/src/rbac/utils/eventContext.ts +48 -2
  383. package/src/services/EventService.ts +165 -21
  384. package/src/services/OrganisationService.ts +37 -2
  385. package/src/services/__tests__/EventService.test.ts +26 -21
  386. package/src/types/file-reference.ts +13 -10
  387. package/src/utils/app/appNameResolver.test.ts +346 -73
  388. package/src/utils/context/superAdminOverride.ts +58 -0
  389. package/src/utils/file-reference/index.ts +61 -33
  390. package/src/utils/google-places/googlePlacesUtils.test.ts +98 -0
  391. package/src/utils/google-places/loadGoogleMapsScript.test.ts +83 -0
  392. package/src/utils/storage/helpers.test.ts +1 -1
  393. package/src/utils/storage/helpers.ts +38 -19
  394. package/src/utils/storage/types.ts +15 -8
  395. package/src/utils/validation/__tests__/csrf.test.ts +105 -0
  396. package/src/utils/validation/__tests__/sqlInjectionProtection.test.ts +92 -0
  397. package/src/vite-env.d.ts +2 -2
  398. package/dist/chunk-3GOZZZYH.js.map +0 -1
  399. package/dist/chunk-DDM4CCYT.js.map +0 -1
  400. package/dist/chunk-E7UAOUMY.js +0 -75
  401. package/dist/chunk-E7UAOUMY.js.map +0 -1
  402. package/dist/chunk-F2IMUDXZ.js.map +0 -1
  403. package/dist/chunk-HEHYGYOX.js.map +0 -1
  404. package/dist/chunk-IM4QE42D.js.map +0 -1
  405. package/dist/chunk-MX64ZF6I.js.map +0 -1
  406. package/dist/chunk-SAUPYVLF.js.map +0 -1
  407. package/dist/chunk-THRPYOFK.js.map +0 -1
  408. package/dist/chunk-UCQSRW7Z.js.map +0 -1
  409. package/dist/chunk-VGZZXKBR.js.map +0 -1
  410. package/dist/chunk-YGPFYGA6.js.map +0 -1
  411. package/dist/chunk-YHCN776L.js.map +0 -1
  412. package/src/hooks/__tests__/usePermissionCache.simple.test.ts +0 -192
  413. package/src/hooks/__tests__/usePermissionCache.unit.test.ts +0 -741
  414. package/src/hooks/__tests__/usePublicEvent.simple.test.ts +0 -703
  415. package/src/rbac/hooks/useRBAC.simple.test.ts +0 -95
  416. package/src/rbac/utils/__tests__/eventContext.unit.test.ts +0 -428
  417. /package/dist/{DataTable-GUFUNZ3N.js.map → DataTable-ON3IXISJ.js.map} +0 -0
  418. /package/dist/{UnifiedAuthProvider-643PUAIM.js.map → UnifiedAuthProvider-X5NXANVI.js.map} +0 -0
  419. /package/dist/{api-YP7XD5L6.js.map → api-I6UCQ5S6.js.map} +0 -0
  420. /package/dist/{chunk-HESYZWZW.js.map → chunk-QWWZ5CAQ.js.map} +0 -0
@@ -0,0 +1,157 @@
1
+ import React from 'react';
2
+ import { render, screen } from '@testing-library/react';
3
+ import userEvent from '@testing-library/user-event';
4
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
5
+ import { DataTableToolbar } from '../DataTableToolbar';
6
+ import type { DataTableFeatureConfig } from '../../types';
7
+
8
+ vi.mock('../GroupingDropdown', () => ({
9
+ GroupingDropdown: ({ onGroupByChange }: any) => (
10
+ <button onClick={() => onGroupByChange('grouped')} data-testid="grouping-dropdown">
11
+ Grouping Dropdown
12
+ </button>
13
+ ),
14
+ }));
15
+
16
+ vi.mock('../ColumnVisibilityDropdown', () => ({
17
+ ColumnVisibilityDropdown: ({ onColumnVisibilityChange }: any) => (
18
+ <button
19
+ onClick={() => onColumnVisibilityChange('column-id', true)}
20
+ data-testid="column-visibility-dropdown"
21
+ >
22
+ Column Visibility Dropdown
23
+ </button>
24
+ ),
25
+ }));
26
+
27
+ vi.mock('../../Button/Button', () => ({
28
+ Button: ({ children, onClick, variant, ...rest }: any) => (
29
+ <button onClick={onClick} data-variant={variant} {...rest}>
30
+ {children}
31
+ </button>
32
+ ),
33
+ }));
34
+
35
+ vi.mock('../../Input/Input', () => ({
36
+ Input: ({ value, onChange, placeholder, ...rest }: any) => (
37
+ <input value={value} onChange={onChange} placeholder={placeholder} {...rest} />
38
+ ),
39
+ }));
40
+
41
+ describe('[component] DataTableToolbar', () => {
42
+ const baseFeatures: DataTableFeatureConfig = {
43
+ search: true,
44
+ grouping: true,
45
+ columnVisibility: true,
46
+ filtering: true,
47
+ creation: true,
48
+ import: true,
49
+ export: true,
50
+ selection: true,
51
+ deletion: true,
52
+ deleteSelected: true,
53
+ };
54
+
55
+ const permissions = {
56
+ canCreate: { can: true, isLoading: false },
57
+ canImport: { can: true, isLoading: false },
58
+ canExport: { can: true, isLoading: false },
59
+ canDelete: { can: true, isLoading: false },
60
+ };
61
+
62
+ const commonProps = {
63
+ features: baseFeatures,
64
+ rbac: { pageId: 'test-page' },
65
+ permissions,
66
+ globalFilter: '',
67
+ onGlobalFilterChange: vi.fn(),
68
+ columns: [
69
+ { id: 'name', header: 'Name' },
70
+ { id: 'role', header: 'Role' },
71
+ ],
72
+ grouping: [],
73
+ onGroupByChange: vi.fn(),
74
+ tableColumns: [
75
+ {
76
+ id: 'name',
77
+ columnDef: { header: 'Name' },
78
+ getCanHide: () => true,
79
+ getIsVisible: () => true,
80
+ },
81
+ ] as any,
82
+ onColumnVisibilityChange: vi.fn(),
83
+ rowSelection: {},
84
+ onCreateRow: vi.fn(),
85
+ onImportClick: vi.fn(),
86
+ onExport: vi.fn(),
87
+ onDeleteSelected: vi.fn(),
88
+ onToggleFilterRow: vi.fn(),
89
+ showFilterRow: false,
90
+ };
91
+
92
+ beforeEach(() => {
93
+ vi.clearAllMocks();
94
+ });
95
+
96
+ it('renders search input and passes global filter changes', async () => {
97
+ const onGlobalFilterChange = vi.fn();
98
+
99
+ render(<DataTableToolbar {...commonProps} onGlobalFilterChange={onGlobalFilterChange} />);
100
+
101
+ const searchInput = screen.getByPlaceholderText('Search...');
102
+ await userEvent.type(searchInput, 'alpha');
103
+
104
+ const calls = onGlobalFilterChange.mock.calls.map((call) => call[0]);
105
+ expect(calls).toEqual(['a', 'l', 'p', 'h', 'a']);
106
+ });
107
+
108
+ it('shows feature controls and triggers handlers with permissions', async () => {
109
+ const onDeleteSelected = vi.fn();
110
+ const props = {
111
+ ...commonProps,
112
+ rowSelection: { row1: true },
113
+ onDeleteSelected,
114
+ showFilterRow: true,
115
+ };
116
+
117
+ render(<DataTableToolbar {...props} />);
118
+
119
+ await userEvent.click(screen.getByText('Grouping Dropdown'));
120
+ expect(props.onGroupByChange).toHaveBeenCalledWith('grouped');
121
+
122
+ await userEvent.click(screen.getByText('Column Visibility Dropdown'));
123
+ expect(props.onColumnVisibilityChange).toHaveBeenCalledWith('column-id', true);
124
+
125
+ await userEvent.click(screen.getByText('Hide Filters'));
126
+ expect(props.onToggleFilterRow).toHaveBeenCalled();
127
+
128
+ await userEvent.click(screen.getByText('Add Row'));
129
+ expect(props.onCreateRow).toHaveBeenCalled();
130
+
131
+ await userEvent.click(screen.getByText('Import'));
132
+ expect(props.onImportClick).toHaveBeenCalled();
133
+
134
+ await userEvent.click(screen.getByText('Export'));
135
+ expect(props.onExport).toHaveBeenCalled();
136
+
137
+ await userEvent.click(screen.getByText('Delete'));
138
+ expect(onDeleteSelected).toHaveBeenCalledWith({ row1: true });
139
+ });
140
+
141
+ it('respects permission gates for creation and deletion', () => {
142
+ const props = {
143
+ ...commonProps,
144
+ permissions: {
145
+ ...permissions,
146
+ canCreate: { can: false, isLoading: false },
147
+ canDelete: { can: false, isLoading: false },
148
+ },
149
+ rowSelection: { row1: true },
150
+ };
151
+
152
+ render(<DataTableToolbar {...props} />);
153
+
154
+ expect(screen.queryByText('Add Row')).not.toBeInTheDocument();
155
+ expect(screen.queryByText('Delete')).not.toBeInTheDocument();
156
+ });
157
+ });
@@ -114,7 +114,8 @@ describe('[component] LoadingState', () => {
114
114
  render(<LoadingState />);
115
115
 
116
116
  const spinner = screen.getByText('Loading...').previousElementSibling;
117
- expect(spinner).toHaveClass('h-6', 'w-6');
117
+ // LoadingState spinner uses Tailwind v4 size-* utility instead of h-* w-*
118
+ expect(spinner).toHaveClass('size-6');
118
119
  });
119
120
  });
120
121
  });
@@ -0,0 +1,128 @@
1
+ import React from 'react';
2
+ import { render, screen, waitFor } from '@testing-library/react';
3
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
4
+ import { renderHook } from '@testing-library/react';
5
+ import { useReactTable, getCoreRowModel, type ColumnDef } from '@tanstack/react-table';
6
+ import { VirtualizedDataTable, EnhancedVirtualizedDataTable } from '../VirtualizedDataTable';
7
+ import type { DataRecord } from '../../types';
8
+
9
+ const virtualItems = [{ index: 0, key: '0', start: 0, size: 40 }];
10
+
11
+ vi.mock('@tanstack/react-virtual', () => ({
12
+ useVirtualizer: vi.fn(() => ({
13
+ getVirtualItems: () => virtualItems,
14
+ getTotalSize: () => 40,
15
+ })),
16
+ }));
17
+
18
+ describe('[component] VirtualizedDataTable', () => {
19
+ type Row = DataRecord & { id: string; name: string };
20
+
21
+ const columns: ColumnDef<Row>[] = [
22
+ {
23
+ accessorKey: 'name',
24
+ header: 'Name',
25
+ cell: (info) => <span>{info.getValue() as string}</span>,
26
+ },
27
+ ];
28
+
29
+ const createTable = (data: Row[]) =>
30
+ renderHook(() =>
31
+ useReactTable({
32
+ data,
33
+ columns,
34
+ getCoreRowModel: getCoreRowModel(),
35
+ })
36
+ ).result.current;
37
+
38
+ beforeEach(() => {
39
+ vi.clearAllMocks();
40
+ });
41
+
42
+ it('renders headers and cells when data is available', () => {
43
+ const table = createTable([{ id: '1', name: 'Alice' }]);
44
+
45
+ render(<VirtualizedDataTable table={table} height={200} />);
46
+
47
+ expect(screen.getByText('Name')).toBeInTheDocument();
48
+ expect(screen.getByText('Alice')).toBeInTheDocument();
49
+ expect(screen.getByText(/Showing 1 to 1 of 1 rows/)).toBeInTheDocument();
50
+ });
51
+
52
+ it('renders an empty state when no rows are present', () => {
53
+ const table = createTable([]);
54
+
55
+ render(<VirtualizedDataTable table={table} />);
56
+
57
+ expect(screen.getByText('No data available')).toBeInTheDocument();
58
+ expect(screen.getByText('Name')).toBeInTheDocument();
59
+ });
60
+
61
+ it('reports visible range changes', async () => {
62
+ const table = createTable([{ id: '1', name: 'Alice' }, { id: '2', name: 'Bob' }]);
63
+ const onVisibilityChange = vi.fn();
64
+
65
+ render(
66
+ <VirtualizedDataTable
67
+ table={table}
68
+ onVisibilityChange={onVisibilityChange}
69
+ />
70
+ );
71
+
72
+ await waitFor(() => {
73
+ expect(onVisibilityChange).toHaveBeenCalledWith({ start: 0, end: 0 });
74
+ });
75
+ });
76
+ });
77
+
78
+ describe('[component] EnhancedVirtualizedDataTable', () => {
79
+ type Row = DataRecord & { id: string; name: string };
80
+
81
+ const columns: ColumnDef<Row>[] = [
82
+ {
83
+ accessorKey: 'name',
84
+ header: 'Name',
85
+ cell: (info) => <span>{info.getValue() as string}</span>,
86
+ },
87
+ ];
88
+
89
+ const createTable = (data: Row[]) =>
90
+ renderHook(() =>
91
+ useReactTable({
92
+ data,
93
+ columns,
94
+ getCoreRowModel: getCoreRowModel(),
95
+ })
96
+ ).result.current;
97
+
98
+ beforeEach(() => {
99
+ vi.clearAllMocks();
100
+ });
101
+
102
+ it('shows loading placeholder rows when loading', () => {
103
+ const table = createTable([{ id: '1', name: 'Alice' }]);
104
+
105
+ render(
106
+ <EnhancedVirtualizedDataTable
107
+ table={table}
108
+ isLoading
109
+ loadingRows={2}
110
+ />
111
+ );
112
+
113
+ expect(screen.getByText('Loading...')).toBeInTheDocument();
114
+ });
115
+
116
+ it('renders custom empty message when no data is available and not loading', () => {
117
+ const table = createTable([]);
118
+
119
+ render(
120
+ <EnhancedVirtualizedDataTable
121
+ table={table}
122
+ emptyMessage="Nothing here"
123
+ />
124
+ );
125
+
126
+ expect(screen.getByText('Nothing here')).toBeInTheDocument();
127
+ });
128
+ });
@@ -101,4 +101,23 @@ describe('ActionManagerImpl', () => {
101
101
  expect(manager.isActionDisabled('disabled', { id: '1', status: 'draft' })).toBe(true);
102
102
  expect(manager.isActionDisabled('unknown', { id: '1', status: 'draft' })).toBe(true);
103
103
  });
104
+
105
+ it('filters actions by variant and resets state through setter helpers', () => {
106
+ const actions = [
107
+ buildAction({ testId: 'primary', variant: 'default', label: 'Primary' }),
108
+ buildAction({ testId: 'secondary', variant: 'secondary', label: 'Secondary' }),
109
+ buildAction({ testId: 'danger', variant: 'destructive', label: 'Danger' }),
110
+ ];
111
+
112
+ const manager = new ActionManagerImpl<TestRecord>(actions);
113
+ expect(manager.getPrimaryActions().map(action => action.testId)).toEqual(['primary']);
114
+ expect(manager.getSecondaryActions().map(action => action.testId)).toEqual(['secondary']);
115
+ expect(manager.getDestructiveActions().map(action => action.testId)).toEqual(['danger']);
116
+
117
+ manager.clearActions();
118
+ expect(manager.getActionCount()).toBe(0);
119
+
120
+ manager.setActions(actions.slice(0, 2));
121
+ expect(manager.getActionIds()).toEqual(['primary', 'secondary']);
122
+ });
104
123
  });
@@ -115,6 +115,21 @@ describe('ColumnFactory', () => {
115
115
  expect(column.meta?.align).toBe('right');
116
116
  expect(column.meta?.type).toBe('number');
117
117
  });
118
+
119
+ it('formats numeric values and falls back to locale strings', () => {
120
+ const formatted = ColumnFactory.createNumberColumn<TestDataRecord>('age', {
121
+ format: value => `#${value}`,
122
+ });
123
+ const formattedResult = formatted.cell?.({ getValue: () => 42 } as any);
124
+ expect(formattedResult).toBe('#42');
125
+
126
+ const defaultFormatted = ColumnFactory.createNumberColumn<TestDataRecord>('age');
127
+ const defaultResult = defaultFormatted.cell?.({ getValue: () => 1000 } as any);
128
+ expect(defaultResult).toBe('1,000');
129
+
130
+ const passthroughResult = defaultFormatted.cell?.({ getValue: () => 'n/a' } as any);
131
+ expect(passthroughResult).toBe('n/a');
132
+ });
118
133
  });
119
134
 
120
135
  describe('createDateColumn', () => {
@@ -154,6 +169,18 @@ describe('ColumnFactory', () => {
154
169
  expect(column.cell).toBeDefined();
155
170
  // The cell renderer handles invalid dates by returning empty string
156
171
  });
172
+
173
+ it('returns localized dates and preserves non-date values', () => {
174
+ const column = ColumnFactory.createDateColumn<TestDataRecord>('createdAt', {
175
+ locale: 'en-GB',
176
+ });
177
+
178
+ const displayValue = column.cell?.({ getValue: () => '2020-01-02T00:00:00Z' } as any) as string;
179
+ expect(displayValue).toContain('2020');
180
+
181
+ const invalidValue = column.cell?.({ getValue: () => 'not-a-date' } as any);
182
+ expect(invalidValue).toBe('not-a-date');
183
+ });
157
184
  });
158
185
 
159
186
  describe('createBooleanColumn', () => {
@@ -186,6 +213,17 @@ describe('ColumnFactory', () => {
186
213
  expect(column.enableGrouping).toBe(false);
187
214
  expect(column.enableHiding).toBe(false);
188
215
  });
216
+
217
+ it('renders boolean values and delegates to custom renderers', () => {
218
+ const defaultColumn = ColumnFactory.createBooleanColumn<TestDataRecord>('active');
219
+ expect(defaultColumn.cell?.({ getValue: () => true } as any)).toBe('Yes');
220
+ expect(defaultColumn.cell?.({ getValue: () => false } as any)).toBe('No');
221
+
222
+ const renderColumn = ColumnFactory.createBooleanColumn<TestDataRecord>('active', {
223
+ render: value => (value ? 'Active' : 'Inactive'),
224
+ });
225
+ expect(renderColumn.cell?.({ getValue: () => true } as any)).toBe('Active');
226
+ });
189
227
  });
190
228
 
191
229
  describe('createActionColumn', () => {
@@ -249,6 +287,19 @@ describe('ColumnFactory', () => {
249
287
  expect(column.id).toBe(longKey);
250
288
  expect(column.accessorKey).toBe(longKey);
251
289
  });
290
+
291
+ it('creates columns from config and falls back to text for unknown types', () => {
292
+ const columns = ColumnFactory.createColumnsFromConfig<TestDataRecord>([
293
+ { key: 'name', type: 'text' },
294
+ { key: 'active', type: 'boolean' },
295
+ { key: 'custom', type: 'unknown' as any },
296
+ ]);
297
+
298
+ expect(columns).toHaveLength(3);
299
+ expect(columns[1].id).toBe('active');
300
+ expect(columns[2].id).toBe('custom');
301
+ expect(columns[2].enableColumnFilter).toBe(true);
302
+ });
252
303
  });
253
304
  });
254
305
 
@@ -0,0 +1,84 @@
1
+ import { describe, it, expect, vi } from 'vitest';
2
+ import { ColumnManagerImpl } from '../ColumnManager';
3
+ import type { DataRecord } from '../../types';
4
+ import type { ColumnDef } from '@tanstack/react-table';
5
+
6
+ interface TestRecord extends DataRecord {
7
+ id: string;
8
+ name: string;
9
+ status: string;
10
+ }
11
+
12
+ describe('ColumnManagerImpl', () => {
13
+ const buildColumn = (overrides: Partial<ColumnDef<TestRecord>> = {}): ColumnDef<TestRecord> => ({
14
+ id: 'name',
15
+ accessorKey: 'name',
16
+ header: 'Name',
17
+ ...overrides,
18
+ });
19
+
20
+ it('adds, replaces, and removes columns while keeping map state in sync', () => {
21
+ const manager = new ColumnManagerImpl<TestRecord>();
22
+ const first = buildColumn({ id: 'name', header: 'First' });
23
+ const replacement = buildColumn({ id: 'name', header: 'Replacement' });
24
+ const secondary = buildColumn({ id: 'status', header: 'Status' });
25
+
26
+ manager.addColumn(first);
27
+ manager.addColumn(replacement);
28
+ manager.addColumn(secondary);
29
+
30
+ expect(manager.getColumns()).toHaveLength(2);
31
+ expect(manager.getColumn('name')?.header).toBe('Replacement');
32
+ expect(manager.hasColumn('status')).toBe(true);
33
+
34
+ manager.removeColumn('status');
35
+ expect(manager.getColumn('status')).toBeUndefined();
36
+ expect(manager.getColumnCount()).toBe(1);
37
+ });
38
+
39
+ it('updates, moves, and indexes columns with validation', () => {
40
+ const alpha = buildColumn({ id: 'alpha', header: 'Alpha' });
41
+ const beta = buildColumn({ id: 'beta', header: 'Beta' });
42
+ const manager = new ColumnManagerImpl<TestRecord>([alpha, beta]);
43
+
44
+ manager.updateColumn('alpha', { header: 'Renamed' });
45
+ expect(manager.getColumn('alpha')?.header).toBe('Renamed');
46
+
47
+ manager.moveColumn('beta', 0);
48
+ expect(manager.getColumnByIndex(0)?.id).toBe('beta');
49
+ expect(manager.getColumnIndex('beta')).toBe(0);
50
+
51
+ expect(() => manager.updateColumn('missing', { header: 'x' })).toThrow('Column with ID "missing" not found');
52
+ expect(() => manager.moveColumn('missing', 0)).toThrow('Column with ID "missing" not found');
53
+ expect(() => manager.moveColumn('beta', 5)).toThrow('Invalid index: 5');
54
+ });
55
+
56
+ it('filters columns by capabilities', () => {
57
+ const sortable = buildColumn({ id: 'sortable', enableSorting: true });
58
+ const filterable = buildColumn({ id: 'filterable', enableColumnFilter: true });
59
+ const groupable = buildColumn({ id: 'groupable', enableGrouping: true });
60
+ const hidden = buildColumn({ id: 'hidden', enableHiding: false });
61
+
62
+ const manager = new ColumnManagerImpl<TestRecord>([sortable, filterable, groupable, hidden]);
63
+
64
+ expect(manager.getSortableColumns()).toEqual([sortable]);
65
+ expect(manager.getFilterableColumns()).toEqual([filterable]);
66
+ expect(manager.getGroupableColumns()).toEqual([groupable]);
67
+ expect(manager.getVisibleColumns().map(col => col.id)).not.toContain('hidden');
68
+ });
69
+
70
+ it('derives stable identifiers for accessor functions', () => {
71
+ const randomSpy = vi.spyOn(Math, 'random').mockReturnValue(0.123456789);
72
+ const manager = new ColumnManagerImpl<TestRecord>();
73
+
74
+ manager.addColumn({
75
+ header: 'AccessorFn',
76
+ accessorFn: row => row.name,
77
+ } as ColumnDef<TestRecord>);
78
+
79
+ const generatedId = manager.getColumnIds()[0];
80
+ expect(generatedId).toMatch(/^fn-/);
81
+
82
+ randomSpy.mockRestore();
83
+ });
84
+ });
@@ -98,4 +98,18 @@ describe('DataManager', () => {
98
98
 
99
99
  await expect(manager.getCachedData('query')).resolves.toBeNull();
100
100
  });
101
+
102
+ it('returns cached data until expiry and clears when switching adapters', async () => {
103
+ const manager = new DataManager<TestRecord>(adapter, 10_000);
104
+ const cachedRows = [{ id: 'cached', name: 'Cached' }];
105
+ manager.setCachedData('list', cachedRows);
106
+
107
+ await expect(manager.getCachedData('list')).resolves.toEqual(cachedRows);
108
+
109
+ const newAdapter = createAdapter();
110
+ manager.setAdapter(newAdapter);
111
+
112
+ await expect(manager.getCachedData('list')).resolves.toBeNull();
113
+ expect(manager.getAdapter()).toBe(newAdapter);
114
+ });
101
115
  });
@@ -0,0 +1,136 @@
1
+ import React from 'react';
2
+ import { render, renderHook, waitFor, act } from '@testing-library/react';
3
+ import { describe, it, expect, vi } from 'vitest';
4
+ import { DataTableProvider, useActionManager, useColumnManager, useDataManager, useDataTableContext, usePluginRegistry, useStateManager } from '../DataTableContext';
5
+ import type { DataTableConfig, DataTableContext as IDataTableContext } from '../interfaces';
6
+ import type { DataRecord, DataTableAction } from '../../types';
7
+ import type { ColumnDef } from '@tanstack/react-table';
8
+
9
+ interface TestRecord extends DataRecord {
10
+ id: string;
11
+ name: string;
12
+ }
13
+
14
+ const baseConfig: DataTableConfig<TestRecord> = {
15
+ features: {},
16
+ enableVirtualization: false,
17
+ enableCaching: false,
18
+ cacheTimeout: 0,
19
+ enableKeyboardNavigation: true,
20
+ enableScreenReaderSupport: true,
21
+ };
22
+
23
+ const columns: ColumnDef<TestRecord>[] = [
24
+ { id: 'name', header: 'Name', accessorKey: 'name' },
25
+ ];
26
+
27
+ const actions: DataTableAction<TestRecord>[] = [
28
+ { label: 'View', testId: 'view', onClick: vi.fn() },
29
+ ];
30
+
31
+ describe('DataTableContext', () => {
32
+ it('throws when hooks are used outside of the provider', () => {
33
+ expect(() => renderHook(() => useDataTableContext<TestRecord>())).toThrow(
34
+ 'useDataTableContext must be used within a DataTableProvider'
35
+ );
36
+ });
37
+
38
+ it('exposes initialized managers populated from props', async () => {
39
+ const onContext = vi.fn();
40
+ const data: TestRecord[] = [{ id: '1', name: 'Alpha' }];
41
+
42
+ render(
43
+ <DataTableProvider config={baseConfig} data={data} columns={columns} actions={actions}>
44
+ <TestConsumer onContext={onContext} />
45
+ </DataTableProvider>
46
+ );
47
+
48
+ await waitFor(() => expect(onContext).toHaveBeenCalled());
49
+ const ctx = onContext.mock.calls.at(-1)?.[0];
50
+
51
+ expect(ctx.dataManager.getAdapter().name).toBe('local');
52
+ expect(ctx.stateManager.getState().data).toEqual(data);
53
+ expect(ctx.columnManager.getColumns()).toHaveLength(1);
54
+ expect(ctx.actionManager.getActions()).toHaveLength(1);
55
+ });
56
+
57
+ it('reacts to prop changes and updates managed state', async () => {
58
+ const onContext = vi.fn();
59
+ const initialData: TestRecord[] = [{ id: '1', name: 'Alpha' }];
60
+ const updatedData: TestRecord[] = [{ id: '2', name: 'Beta' }];
61
+ const updatedColumns: ColumnDef<TestRecord>[] = [
62
+ { id: 'name', header: 'Name', accessorKey: 'name' },
63
+ { id: 'id', header: 'Identifier', accessorKey: 'id' },
64
+ ];
65
+
66
+ const { rerender } = render(
67
+ <DataTableProvider config={baseConfig} data={initialData} columns={columns} actions={actions}>
68
+ <TestConsumer onContext={onContext} />
69
+ </DataTableProvider>
70
+ );
71
+
72
+ await waitFor(() => expect(onContext).toHaveBeenCalled());
73
+ onContext.mockClear();
74
+
75
+ rerender(
76
+ <DataTableProvider config={baseConfig} data={updatedData} columns={updatedColumns} actions={[...actions]}>
77
+ <TestConsumer onContext={onContext} />
78
+ </DataTableProvider>
79
+ );
80
+
81
+ await waitFor(() => expect(onContext).toHaveBeenCalled());
82
+ const ctx = onContext.mock.calls.at(-1)?.[0];
83
+
84
+ expect(ctx.stateManager.getState().data).toEqual(updatedData);
85
+ expect(ctx.columnManager.getColumns()).toHaveLength(2);
86
+ expect(ctx.actionManager.getActions()).toHaveLength(actions.length);
87
+ });
88
+
89
+ it('exposes hook shorthands and utility helpers', async () => {
90
+ vi.useFakeTimers();
91
+ const wrapper = ({ children }: { children: React.ReactNode }) => (
92
+ <DataTableProvider config={baseConfig} data={[{ id: '1', name: 'Alpha' }]} columns={columns} actions={actions}>
93
+ {children}
94
+ </DataTableProvider>
95
+ );
96
+
97
+ const { result: managerResult } = renderHook(
98
+ () => ({
99
+ data: useDataManager<TestRecord>(),
100
+ columns: useColumnManager<TestRecord>(),
101
+ actions: useActionManager<TestRecord>(),
102
+ state: useStateManager<TestRecord>(),
103
+ plugins: usePluginRegistry<TestRecord>(),
104
+ context: useDataTableContext<TestRecord>(),
105
+ }),
106
+ { wrapper }
107
+ );
108
+
109
+ expect(managerResult.current.data.getAdapter().name).toBe('local');
110
+ expect(managerResult.current.columns.getColumns()).toHaveLength(1);
111
+ expect(managerResult.current.actions.getActionCount()).toBe(1);
112
+ expect(managerResult.current.state.getObserverCount()).toBe(0);
113
+ expect(managerResult.current.plugins.getPluginCount()).toBe(0);
114
+
115
+ const debounced = managerResult.current.context.utils.debounce(vi.fn(), 50);
116
+ debounced();
117
+ debounced();
118
+ expect(managerResult.current.context.utils.getRowId?.({} as any, 3)).toBe('3');
119
+
120
+ await act(async () => {
121
+ vi.advanceTimersByTime(60);
122
+ });
123
+
124
+ expect(managerResult.current.context.utils.debounce).toBeDefined();
125
+ expect((managerResult.current.context.utils.debounce as any).mock).toBeUndefined();
126
+ vi.useRealTimers();
127
+ });
128
+ });
129
+
130
+ function TestConsumer({ onContext }: { onContext: (ctx: IDataTableContext<TestRecord>) => void }) {
131
+ const ctx = useDataTableContext<TestRecord>();
132
+ React.useEffect(() => {
133
+ onContext(ctx);
134
+ }, [ctx, onContext]);
135
+ return null;
136
+ }
@@ -81,4 +81,20 @@ describe('LocalDataAdapter', () => {
81
81
  await expect(adapter.exportData('xlsx')).resolves.toContain('Alice');
82
82
  await expect(adapter.exportData('unsupported' as any)).rejects.toThrow('Unsupported export format: unsupported');
83
83
  });
84
+
85
+ it('imports replacements, clears data, and reports connection/error state', async () => {
86
+ await adapter.importData([{ id: '9', name: 'Imported', role: 'viewer', active: false }]);
87
+ expect(adapter.getDataCount()).toBe(1);
88
+ expect(adapter.getAllData()[0].id).toBe('9');
89
+
90
+ adapter.clearData();
91
+ expect(adapter.getDataCount()).toBe(0);
92
+ expect(adapter.isConnected()).toBe(true);
93
+
94
+ await expect(adapter.updateData('missing', { name: 'Nope' })).rejects.toThrow();
95
+ expect(adapter.getError()).toBeInstanceOf(Error);
96
+
97
+ const emptyExport = await adapter.exportData('csv');
98
+ expect(emptyExport).toBe('');
99
+ });
84
100
  });
@@ -99,4 +99,22 @@ describe('PluginRegistryImpl', () => {
99
99
  expect(plugin.cleanup).toHaveBeenCalled();
100
100
  expect(registry.getPlugin('alpha')).toBeUndefined();
101
101
  });
102
+
103
+ it('validates dependencies, dependents, and unregistration edge cases', async () => {
104
+ const orphan = createPlugin('orphan', ['missing']);
105
+ const parent = createPlugin('parent');
106
+ const child = createPlugin('child', ['parent']);
107
+
108
+ registry.register(parent);
109
+ registry.register(child);
110
+ expect(registry.areDependenciesSatisfied('child')).toBe(true);
111
+ expect(registry.getDependents('parent').map(plugin => plugin.name)).toEqual(['child']);
112
+
113
+ registry.register(orphan);
114
+ const validation = registry.validateDependencies();
115
+ expect(validation.valid).toBe(false);
116
+ expect(validation.errors[0]).toContain('depends on "missing"');
117
+
118
+ expect(() => registry.unregister('unknown')).toThrow('Plugin "unknown" is not registered');
119
+ });
102
120
  });