@terreno/admin-frontend 57.3.0 → 57.6.0

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 (564) hide show
  1. package/.ai/guidelines/core.md +5 -1
  2. package/README.md +6 -4
  3. package/dist/AdminActionMenu.d.ts +1 -0
  4. package/dist/AdminActionMenu.d.ts.map +1 -0
  5. package/dist/AdminActionMenu.js +2 -2
  6. package/dist/AdminActionMenu.js.map +1 -1
  7. package/dist/AdminBreadcrumbs.d.ts +1 -0
  8. package/dist/AdminBreadcrumbs.d.ts.map +1 -0
  9. package/dist/AdminConflictSheet.d.ts +17 -0
  10. package/dist/AdminConflictSheet.d.ts.map +1 -0
  11. package/dist/AdminConflictSheet.js +52 -0
  12. package/dist/AdminConflictSheet.js.map +1 -0
  13. package/dist/AdminFieldRenderer.d.ts +1 -0
  14. package/dist/AdminFieldRenderer.d.ts.map +1 -0
  15. package/dist/AdminFieldRendererCore.d.ts +1 -0
  16. package/dist/AdminFieldRendererCore.d.ts.map +1 -0
  17. package/dist/AdminFieldRendererCore.js +15 -16
  18. package/dist/AdminFieldRendererCore.js.map +1 -1
  19. package/dist/AdminFilterDrawer.d.ts +1 -0
  20. package/dist/AdminFilterDrawer.d.ts.map +1 -0
  21. package/dist/AdminFilterDrawer.js +10 -12
  22. package/dist/AdminFilterDrawer.js.map +1 -1
  23. package/dist/AdminHome.d.ts +1 -0
  24. package/dist/AdminHome.d.ts.map +1 -0
  25. package/dist/AdminHome.js +11 -11
  26. package/dist/AdminHome.js.map +1 -1
  27. package/dist/AdminMigrations.d.ts +4 -0
  28. package/dist/AdminMigrations.d.ts.map +1 -0
  29. package/dist/AdminMigrations.js +19 -0
  30. package/dist/AdminMigrations.js.map +1 -0
  31. package/dist/AdminMigrationsView.d.ts +11 -0
  32. package/dist/AdminMigrationsView.d.ts.map +1 -0
  33. package/dist/AdminMigrationsView.js +92 -0
  34. package/dist/AdminMigrationsView.js.map +1 -0
  35. package/dist/AdminModelForm.d.ts +1 -0
  36. package/dist/AdminModelForm.d.ts.map +1 -0
  37. package/dist/AdminModelForm.js +208 -62
  38. package/dist/AdminModelForm.js.map +1 -1
  39. package/dist/AdminModelList.d.ts +1 -0
  40. package/dist/AdminModelList.d.ts.map +1 -0
  41. package/dist/AdminModelList.js +4 -8
  42. package/dist/AdminModelList.js.map +1 -1
  43. package/dist/AdminModelTable.d.ts +1 -0
  44. package/dist/AdminModelTable.d.ts.map +1 -0
  45. package/dist/AdminModelTable.js +321 -50
  46. package/dist/AdminModelTable.js.map +1 -1
  47. package/dist/AdminNestedArrayField.d.ts +1 -0
  48. package/dist/AdminNestedArrayField.d.ts.map +1 -0
  49. package/dist/AdminNestedArrayField.js +10 -5
  50. package/dist/AdminNestedArrayField.js.map +1 -1
  51. package/dist/AdminObjectPicker.d.ts +1 -0
  52. package/dist/AdminObjectPicker.d.ts.map +1 -0
  53. package/dist/AdminObjectPicker.js +35 -14
  54. package/dist/AdminObjectPicker.js.map +1 -1
  55. package/dist/AdminPrimitiveArrayField.d.ts +1 -0
  56. package/dist/AdminPrimitiveArrayField.d.ts.map +1 -0
  57. package/dist/AdminPrimitiveArrayField.js +2 -3
  58. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  59. package/dist/AdminProvider.d.ts +7 -2
  60. package/dist/AdminProvider.d.ts.map +1 -0
  61. package/dist/AdminProvider.js +30 -9
  62. package/dist/AdminProvider.js.map +1 -1
  63. package/dist/AdminRefField.d.ts +1 -0
  64. package/dist/AdminRefField.d.ts.map +1 -0
  65. package/dist/AdminRolesField.d.ts +1 -0
  66. package/dist/AdminRolesField.d.ts.map +1 -0
  67. package/dist/AdminRolesField.js +1 -4
  68. package/dist/AdminRolesField.js.map +1 -1
  69. package/dist/AdminRolesList.d.ts +1 -0
  70. package/dist/AdminRolesList.d.ts.map +1 -0
  71. package/dist/AdminRolesList.js +17 -27
  72. package/dist/AdminRolesList.js.map +1 -1
  73. package/dist/AdminScreenPage.d.ts +1 -0
  74. package/dist/AdminScreenPage.d.ts.map +1 -0
  75. package/dist/AdminScreenPage.js +2 -14
  76. package/dist/AdminScreenPage.js.map +1 -1
  77. package/dist/AdminScreenRouter.d.ts +2 -1
  78. package/dist/AdminScreenRouter.d.ts.map +1 -0
  79. package/dist/AdminScreenRouter.js +8 -5
  80. package/dist/AdminScreenRouter.js.map +1 -1
  81. package/dist/AdminScriptList.d.ts +1 -0
  82. package/dist/AdminScriptList.d.ts.map +1 -0
  83. package/dist/AdminScriptList.js +15 -17
  84. package/dist/AdminScriptList.js.map +1 -1
  85. package/dist/AdminScriptRunModal.d.ts +1 -0
  86. package/dist/AdminScriptRunModal.d.ts.map +1 -0
  87. package/dist/AdminScriptRunModal.js +18 -25
  88. package/dist/AdminScriptRunModal.js.map +1 -1
  89. package/dist/AdminShell.d.ts +8 -3
  90. package/dist/AdminShell.d.ts.map +1 -0
  91. package/dist/AdminShell.js +59 -31
  92. package/dist/AdminShell.js.map +1 -1
  93. package/dist/AdminShellLayout.d.ts +1 -0
  94. package/dist/AdminShellLayout.d.ts.map +1 -0
  95. package/dist/AdminShellLayout.js +2 -14
  96. package/dist/AdminShellLayout.js.map +1 -1
  97. package/dist/AdminVersionConfig.d.ts +1 -0
  98. package/dist/AdminVersionConfig.d.ts.map +1 -0
  99. package/dist/AdminVersionConfig.js +34 -18
  100. package/dist/AdminVersionConfig.js.map +1 -1
  101. package/dist/AnnouncementEditor.d.ts +46 -0
  102. package/dist/AnnouncementEditor.d.ts.map +1 -0
  103. package/dist/AnnouncementEditor.js +367 -0
  104. package/dist/AnnouncementEditor.js.map +1 -0
  105. package/dist/AnnouncementList.d.ts +16 -0
  106. package/dist/AnnouncementList.d.ts.map +1 -0
  107. package/dist/AnnouncementList.js +96 -0
  108. package/dist/AnnouncementList.js.map +1 -0
  109. package/dist/AnnouncementOverview.d.ts +47 -0
  110. package/dist/AnnouncementOverview.d.ts.map +1 -0
  111. package/dist/AnnouncementOverview.js +98 -0
  112. package/dist/AnnouncementOverview.js.map +1 -0
  113. package/dist/AnnouncementOverviewScreenWidget.d.ts +5 -0
  114. package/dist/AnnouncementOverviewScreenWidget.d.ts.map +1 -0
  115. package/dist/AnnouncementOverviewScreenWidget.js +28 -0
  116. package/dist/AnnouncementOverviewScreenWidget.js.map +1 -0
  117. package/dist/CheckboxListEditor.d.ts +1 -0
  118. package/dist/CheckboxListEditor.d.ts.map +1 -0
  119. package/dist/CheckboxListEditor.js +2 -5
  120. package/dist/CheckboxListEditor.js.map +1 -1
  121. package/dist/ConfigurationScreen.d.ts +1 -0
  122. package/dist/ConfigurationScreen.d.ts.map +1 -0
  123. package/dist/ConfigurationScreen.js +16 -13
  124. package/dist/ConfigurationScreen.js.map +1 -1
  125. package/dist/ConsentFormEditor.d.ts +1 -0
  126. package/dist/ConsentFormEditor.d.ts.map +1 -0
  127. package/dist/ConsentFormEditor.js +46 -37
  128. package/dist/ConsentFormEditor.js.map +1 -1
  129. package/dist/ConsentFormList.d.ts +1 -0
  130. package/dist/ConsentFormList.d.ts.map +1 -0
  131. package/dist/ConsentFormList.js +4 -5
  132. package/dist/ConsentFormList.js.map +1 -1
  133. package/dist/ConsentHistory.d.ts +1 -0
  134. package/dist/ConsentHistory.d.ts.map +1 -0
  135. package/dist/ConsentHistory.js +5 -7
  136. package/dist/ConsentHistory.js.map +1 -1
  137. package/dist/ConsentResponseViewer.d.ts +1 -0
  138. package/dist/ConsentResponseViewer.d.ts.map +1 -0
  139. package/dist/ConsentResponseViewer.js +5 -6
  140. package/dist/ConsentResponseViewer.js.map +1 -1
  141. package/dist/Constants.d.ts +1 -0
  142. package/dist/Constants.d.ts.map +1 -0
  143. package/dist/DocumentStorageBrowser.d.ts +1 -0
  144. package/dist/DocumentStorageBrowser.d.ts.map +1 -0
  145. package/dist/DocumentStorageBrowser.js +11 -100
  146. package/dist/DocumentStorageBrowser.js.map +1 -1
  147. package/dist/LocaleContentEditor.d.ts +1 -0
  148. package/dist/LocaleContentEditor.d.ts.map +1 -0
  149. package/dist/LocaleContentEditor.js +6 -11
  150. package/dist/LocaleContentEditor.js.map +1 -1
  151. package/dist/adminApiQueryParams.d.ts +6 -0
  152. package/dist/adminApiQueryParams.d.ts.map +1 -0
  153. package/dist/adminApiQueryParams.js +25 -0
  154. package/dist/adminApiQueryParams.js.map +1 -0
  155. package/dist/adminConflictSheetStack.d.ts +18 -0
  156. package/dist/adminConflictSheetStack.d.ts.map +1 -0
  157. package/dist/adminConflictSheetStack.js +63 -0
  158. package/dist/adminConflictSheetStack.js.map +1 -0
  159. package/dist/adminContext.d.ts +4 -0
  160. package/dist/adminContext.d.ts.map +1 -0
  161. package/dist/adminContext.js +6 -0
  162. package/dist/adminContext.js.map +1 -0
  163. package/dist/adminModelListQueryParams.d.ts +4 -2
  164. package/dist/adminModelListQueryParams.d.ts.map +1 -0
  165. package/dist/adminModelListQueryParams.js +71 -27
  166. package/dist/adminModelListQueryParams.js.map +1 -1
  167. package/dist/adminPageAccess.d.ts +1 -0
  168. package/dist/adminPageAccess.d.ts.map +1 -0
  169. package/dist/adminRequest.d.ts +52 -0
  170. package/dist/adminRequest.d.ts.map +1 -0
  171. package/dist/adminRequest.js +165 -0
  172. package/dist/adminRequest.js.map +1 -0
  173. package/dist/adminRpc.d.ts +8 -0
  174. package/dist/adminRpc.d.ts.map +1 -0
  175. package/dist/adminRpc.js +21 -0
  176. package/dist/adminRpc.js.map +1 -0
  177. package/dist/adminShellNav.d.ts +18 -1
  178. package/dist/adminShellNav.d.ts.map +1 -0
  179. package/dist/adminShellNav.js +39 -12
  180. package/dist/adminShellNav.js.map +1 -1
  181. package/dist/adminWindowRefresh.d.ts +32 -0
  182. package/dist/adminWindowRefresh.d.ts.map +1 -0
  183. package/dist/adminWindowRefresh.js +48 -0
  184. package/dist/adminWindowRefresh.js.map +1 -0
  185. package/dist/adminWindowedTable.d.ts +14 -0
  186. package/dist/adminWindowedTable.d.ts.map +1 -0
  187. package/dist/adminWindowedTable.js +32 -0
  188. package/dist/adminWindowedTable.js.map +1 -0
  189. package/dist/comms/CommsDashboardScreen.d.ts +1 -0
  190. package/dist/comms/CommsDashboardScreen.d.ts.map +1 -0
  191. package/dist/comms/CommsDashboardScreen.js +37 -42
  192. package/dist/comms/CommsDashboardScreen.js.map +1 -1
  193. package/dist/comms/CommsDashboardScreenWidget.d.ts +1 -0
  194. package/dist/comms/CommsDashboardScreenWidget.d.ts.map +1 -0
  195. package/dist/comms/CommsMessageDetail.d.ts +1 -0
  196. package/dist/comms/CommsMessageDetail.d.ts.map +1 -0
  197. package/dist/comms/CommsMessageDetail.js +4 -8
  198. package/dist/comms/CommsMessageDetail.js.map +1 -1
  199. package/dist/comms/CommsStatCard.d.ts +1 -0
  200. package/dist/comms/CommsStatCard.d.ts.map +1 -0
  201. package/dist/comms/CommsStatusBadge.d.ts +1 -0
  202. package/dist/comms/CommsStatusBadge.d.ts.map +1 -0
  203. package/dist/comms/CommsStatusBadge.js +1 -2
  204. package/dist/comms/CommsStatusBadge.js.map +1 -1
  205. package/dist/comms/commsDashboardParams.d.ts +1 -4
  206. package/dist/comms/commsDashboardParams.d.ts.map +1 -0
  207. package/dist/comms/commsDashboardParams.js +5 -7
  208. package/dist/comms/commsDashboardParams.js.map +1 -1
  209. package/dist/comms/commsMessagePayload.d.ts +3 -1
  210. package/dist/comms/commsMessagePayload.d.ts.map +1 -0
  211. package/dist/comms/commsMessagePayload.js +3 -5
  212. package/dist/comms/commsMessagePayload.js.map +1 -1
  213. package/dist/comms/commsRetrySummary.d.ts +1 -0
  214. package/dist/comms/commsRetrySummary.d.ts.map +1 -0
  215. package/dist/comms/commsRetrySummary.js +1 -2
  216. package/dist/comms/commsRetrySummary.js.map +1 -1
  217. package/dist/comms/useCommsDashboardApi.d.ts +4 -3
  218. package/dist/comms/useCommsDashboardApi.d.ts.map +1 -0
  219. package/dist/comms/useCommsDashboardApi.js +41 -0
  220. package/dist/comms/useCommsDashboardApi.js.map +1 -1
  221. package/dist/comms/useCommsDashboardUrlFilters.d.ts +1 -0
  222. package/dist/comms/useCommsDashboardUrlFilters.d.ts.map +1 -0
  223. package/dist/comms/useCommsDashboardUrlFilters.js +1 -1
  224. package/dist/comms/useCommsDashboardUrlFilters.js.map +1 -1
  225. package/dist/dynamicHookApi.d.ts +1 -0
  226. package/dist/dynamicHookApi.d.ts.map +1 -0
  227. package/dist/generateConsentHistoryPdf.d.ts +1 -0
  228. package/dist/generateConsentHistoryPdf.d.ts.map +1 -0
  229. package/dist/generateConsentHistoryPdf.js +16 -22
  230. package/dist/generateConsentHistoryPdf.js.map +1 -1
  231. package/dist/generateConsentPdf.d.ts +1 -0
  232. package/dist/generateConsentPdf.d.ts.map +1 -0
  233. package/dist/generateConsentPdf.js +9 -10
  234. package/dist/generateConsentPdf.js.map +1 -1
  235. package/dist/index.d.ts +25 -2
  236. package/dist/index.d.ts.map +1 -0
  237. package/dist/index.js +23 -1
  238. package/dist/index.js.map +1 -1
  239. package/dist/isAuditLogModel.d.ts +3 -0
  240. package/dist/isAuditLogModel.d.ts.map +1 -0
  241. package/dist/isAuditLogModel.js +8 -0
  242. package/dist/isAuditLogModel.js.map +1 -0
  243. package/dist/jobs/JobsDashboardScreen.d.ts +11 -0
  244. package/dist/jobs/JobsDashboardScreen.d.ts.map +1 -0
  245. package/dist/jobs/JobsDashboardScreen.js +148 -0
  246. package/dist/jobs/JobsDashboardScreen.js.map +1 -0
  247. package/dist/jobs/JobsDashboardScreenWidget.d.ts +5 -0
  248. package/dist/jobs/JobsDashboardScreenWidget.d.ts.map +1 -0
  249. package/dist/jobs/JobsDashboardScreenWidget.js +11 -0
  250. package/dist/jobs/JobsDashboardScreenWidget.js.map +1 -0
  251. package/dist/jobs/JobsHomeWidget.d.ts +5 -0
  252. package/dist/jobs/JobsHomeWidget.d.ts.map +1 -0
  253. package/dist/jobs/JobsHomeWidget.js +20 -0
  254. package/dist/jobs/JobsHomeWidget.js.map +1 -0
  255. package/dist/jobs/JobsJobDetail.d.ts +9 -0
  256. package/dist/jobs/JobsJobDetail.d.ts.map +1 -0
  257. package/dist/jobs/JobsJobDetail.js +74 -0
  258. package/dist/jobs/JobsJobDetail.js.map +1 -0
  259. package/dist/jobs/JobsStatusBadge.d.ts +6 -0
  260. package/dist/jobs/JobsStatusBadge.d.ts.map +1 -0
  261. package/dist/jobs/JobsStatusBadge.js +15 -0
  262. package/dist/jobs/JobsStatusBadge.js.map +1 -0
  263. package/dist/jobs/jobPayload.d.ts +63 -0
  264. package/dist/jobs/jobPayload.d.ts.map +1 -0
  265. package/dist/jobs/jobPayload.js +52 -0
  266. package/dist/jobs/jobPayload.js.map +1 -0
  267. package/dist/jobs/jobsDashboardParams.d.ts +12 -0
  268. package/dist/jobs/jobsDashboardParams.d.ts.map +1 -0
  269. package/dist/jobs/jobsDashboardParams.js +69 -0
  270. package/dist/jobs/jobsDashboardParams.js.map +1 -0
  271. package/dist/jobs/useJobsDashboardApi.d.ts +61 -0
  272. package/dist/jobs/useJobsDashboardApi.d.ts.map +1 -0
  273. package/dist/jobs/useJobsDashboardApi.js +88 -0
  274. package/dist/jobs/useJobsDashboardApi.js.map +1 -0
  275. package/dist/jobs/useJobsDashboardUrlFilters.d.ts +6 -0
  276. package/dist/jobs/useJobsDashboardUrlFilters.d.ts.map +1 -0
  277. package/dist/jobs/useJobsDashboardUrlFilters.js +16 -0
  278. package/dist/jobs/useJobsDashboardUrlFilters.js.map +1 -0
  279. package/dist/orgs/OrgDirectoryScreen.d.ts +17 -0
  280. package/dist/orgs/OrgDirectoryScreen.d.ts.map +1 -0
  281. package/dist/orgs/OrgDirectoryScreen.js +78 -0
  282. package/dist/orgs/OrgDirectoryScreen.js.map +1 -0
  283. package/dist/orgs/OrgMembersScreen.d.ts +10 -0
  284. package/dist/orgs/OrgMembersScreen.d.ts.map +1 -0
  285. package/dist/orgs/OrgMembersScreen.js +114 -0
  286. package/dist/orgs/OrgMembersScreen.js.map +1 -0
  287. package/dist/orgs/OrgSettingsScreen.d.ts +10 -0
  288. package/dist/orgs/OrgSettingsScreen.d.ts.map +1 -0
  289. package/dist/orgs/OrgSettingsScreen.js +79 -0
  290. package/dist/orgs/OrgSettingsScreen.js.map +1 -0
  291. package/dist/orgs/OrgSwitcher.d.ts +9 -0
  292. package/dist/orgs/OrgSwitcher.d.ts.map +1 -0
  293. package/dist/orgs/OrgSwitcher.js +57 -0
  294. package/dist/orgs/OrgSwitcher.js.map +1 -0
  295. package/dist/orgs/adminModelEndpoints.d.ts +19 -0
  296. package/dist/orgs/adminModelEndpoints.d.ts.map +1 -0
  297. package/dist/orgs/adminModelEndpoints.js +76 -0
  298. package/dist/orgs/adminModelEndpoints.js.map +1 -0
  299. package/dist/orgs/normalizeListData.d.ts +10 -0
  300. package/dist/orgs/normalizeListData.d.ts.map +1 -0
  301. package/dist/orgs/normalizeListData.js +7 -0
  302. package/dist/orgs/normalizeListData.js.map +1 -0
  303. package/dist/orgs/organizationSettings.d.ts +18 -0
  304. package/dist/orgs/organizationSettings.d.ts.map +1 -0
  305. package/dist/orgs/organizationSettings.js +5 -0
  306. package/dist/orgs/organizationSettings.js.map +1 -0
  307. package/dist/orgs/shouldSkipOrgScopedAdminQuery.d.ts +5 -0
  308. package/dist/orgs/shouldSkipOrgScopedAdminQuery.d.ts.map +1 -0
  309. package/dist/orgs/shouldSkipOrgScopedAdminQuery.js +2 -0
  310. package/dist/orgs/shouldSkipOrgScopedAdminQuery.js.map +1 -0
  311. package/dist/orgs/sortOrganizations.d.ts +7 -0
  312. package/dist/orgs/sortOrganizations.d.ts.map +1 -0
  313. package/dist/orgs/sortOrganizations.js +9 -0
  314. package/dist/orgs/sortOrganizations.js.map +1 -0
  315. package/dist/orgs/useOrgContext.d.ts +21 -0
  316. package/dist/orgs/useOrgContext.d.ts.map +1 -0
  317. package/dist/orgs/useOrgContext.js +57 -0
  318. package/dist/orgs/useOrgContext.js.map +1 -0
  319. package/dist/orgs/useOrganizationsApi.d.ts +15 -0
  320. package/dist/orgs/useOrganizationsApi.d.ts.map +1 -0
  321. package/dist/orgs/useOrganizationsApi.js +103 -0
  322. package/dist/orgs/useOrganizationsApi.js.map +1 -0
  323. package/dist/pdfUtils.d.ts +1 -2
  324. package/dist/pdfUtils.d.ts.map +1 -0
  325. package/dist/pdfUtils.js +2 -2
  326. package/dist/pdfUtils.js.map +1 -1
  327. package/dist/scriptRunUtils.d.ts +1 -0
  328. package/dist/scriptRunUtils.d.ts.map +1 -0
  329. package/dist/scriptRunUtils.js +3 -5
  330. package/dist/scriptRunUtils.js.map +1 -1
  331. package/dist/types.d.ts +101 -4
  332. package/dist/types.d.ts.map +1 -0
  333. package/dist/types.js +2 -3
  334. package/dist/types.js.map +1 -1
  335. package/dist/useAdminApi.d.ts +1 -0
  336. package/dist/useAdminApi.d.ts.map +1 -0
  337. package/dist/useAdminApi.js +6 -61
  338. package/dist/useAdminApi.js.map +1 -1
  339. package/dist/useAdminBackgroundTask.d.ts +2 -1
  340. package/dist/useAdminBackgroundTask.d.ts.map +1 -0
  341. package/dist/useAdminBackgroundTask.js +18 -3
  342. package/dist/useAdminBackgroundTask.js.map +1 -1
  343. package/dist/useAdminConfig.d.ts +1 -0
  344. package/dist/useAdminConfig.d.ts.map +1 -0
  345. package/dist/useAdminConfig.js +15 -1
  346. package/dist/useAdminConfig.js.map +1 -1
  347. package/dist/useAdminMigrations.d.ts +41 -0
  348. package/dist/useAdminMigrations.d.ts.map +1 -0
  349. package/dist/useAdminMigrations.js +43 -0
  350. package/dist/useAdminMigrations.js.map +1 -0
  351. package/dist/useAdminRoles.d.ts +2 -0
  352. package/dist/useAdminRoles.d.ts.map +1 -0
  353. package/dist/useAdminRoles.js +45 -10
  354. package/dist/useAdminRoles.js.map +1 -1
  355. package/dist/useAdminRpc.d.ts +29 -0
  356. package/dist/useAdminRpc.d.ts.map +1 -0
  357. package/dist/useAdminRpc.js +125 -0
  358. package/dist/useAdminRpc.js.map +1 -0
  359. package/dist/useAdminScripts.d.ts +1 -0
  360. package/dist/useAdminScripts.d.ts.map +1 -0
  361. package/dist/useAdminScripts.js +61 -9
  362. package/dist/useAdminScripts.js.map +1 -1
  363. package/dist/useConfigurationApi.d.ts +1 -0
  364. package/dist/useConfigurationApi.d.ts.map +1 -0
  365. package/dist/useConfigurationApi.js +23 -0
  366. package/dist/useConfigurationApi.js.map +1 -1
  367. package/dist/useConsentHistory.d.ts +1 -0
  368. package/dist/useConsentHistory.d.ts.map +1 -0
  369. package/dist/useConsentHistory.js +10 -3
  370. package/dist/useConsentHistory.js.map +1 -1
  371. package/dist/useDocumentStorageApi.d.ts +1 -0
  372. package/dist/useDocumentStorageApi.d.ts.map +1 -0
  373. package/dist/useDocumentStorageApi.js +73 -1
  374. package/dist/useDocumentStorageApi.js.map +1 -1
  375. package/dist/widgets/AIRequestsScreenWidget.d.ts +1 -0
  376. package/dist/widgets/AIRequestsScreenWidget.d.ts.map +1 -0
  377. package/dist/widgets/AIRequestsScreenWidget.js +19 -10
  378. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -1
  379. package/dist/widgets/CustomScreensListWidget.d.ts +1 -0
  380. package/dist/widgets/CustomScreensListWidget.d.ts.map +1 -0
  381. package/dist/widgets/CustomScreensListWidget.js +2 -6
  382. package/dist/widgets/CustomScreensListWidget.js.map +1 -1
  383. package/dist/widgets/DocumentsScreenWidget.d.ts +1 -0
  384. package/dist/widgets/DocumentsScreenWidget.d.ts.map +1 -0
  385. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +1 -0
  386. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts.map +1 -0
  387. package/dist/widgets/MissingWidget.d.ts +1 -0
  388. package/dist/widgets/MissingWidget.d.ts.map +1 -0
  389. package/dist/widgets/ModelsGridWidget.d.ts +1 -0
  390. package/dist/widgets/ModelsGridWidget.d.ts.map +1 -0
  391. package/dist/widgets/ModelsGridWidget.js +10 -4
  392. package/dist/widgets/ModelsGridWidget.js.map +1 -1
  393. package/dist/widgets/RecentActivityWidget.d.ts +1 -0
  394. package/dist/widgets/RecentActivityWidget.d.ts.map +1 -0
  395. package/dist/widgets/RecentActivityWidget.js +16 -11
  396. package/dist/widgets/RecentActivityWidget.js.map +1 -1
  397. package/dist/widgets/ScriptRunnerWidget.d.ts +1 -0
  398. package/dist/widgets/ScriptRunnerWidget.d.ts.map +1 -0
  399. package/dist/widgets/VersionConfigScreenWidget.d.ts +1 -0
  400. package/dist/widgets/VersionConfigScreenWidget.d.ts.map +1 -0
  401. package/dist/widgets/VersionConfigWidget.d.ts +1 -0
  402. package/dist/widgets/VersionConfigWidget.d.ts.map +1 -0
  403. package/dist/widgets/builtInFieldWidgets.d.ts +1 -0
  404. package/dist/widgets/builtInFieldWidgets.d.ts.map +1 -0
  405. package/dist/widgets/builtInFieldWidgets.js +3 -5
  406. package/dist/widgets/builtInFieldWidgets.js.map +1 -1
  407. package/dist/widgets/builtInWidgets.d.ts +1 -0
  408. package/dist/widgets/builtInWidgets.d.ts.map +1 -0
  409. package/dist/widgets/builtInWidgets.js +20 -5
  410. package/dist/widgets/builtInWidgets.js.map +1 -1
  411. package/dist/widgets/consentWidgets.d.ts +1 -0
  412. package/dist/widgets/consentWidgets.d.ts.map +1 -0
  413. package/dist/widgets/homeWidgetUtils.d.ts +1 -1
  414. package/dist/widgets/homeWidgetUtils.d.ts.map +1 -0
  415. package/dist/widgets/homeWidgetUtils.js +1 -9
  416. package/dist/widgets/homeWidgetUtils.js.map +1 -1
  417. package/package.json +9 -7
  418. package/src/AdminActionMenu.test.tsx +167 -0
  419. package/src/AdminBreadcrumbs.test.tsx +21 -1
  420. package/src/AdminConflictSheet.test.tsx +173 -0
  421. package/src/AdminConflictSheet.tsx +102 -0
  422. package/src/AdminHome.test.tsx +10 -11
  423. package/src/AdminHome.tsx +2 -4
  424. package/src/AdminMigrations.tsx +45 -0
  425. package/src/AdminMigrationsView.tsx +225 -0
  426. package/src/{AdminModelForm.test.tsx → AdminModelForm.isolated.tsx} +461 -154
  427. package/src/AdminModelForm.orgSkip.test.tsx +81 -0
  428. package/src/AdminModelForm.tsx +227 -56
  429. package/src/AdminModelForm.updateDepth.test.tsx +427 -0
  430. package/src/AdminModelList.test.tsx +12 -2
  431. package/src/AdminModelTable.test.tsx +560 -57
  432. package/src/AdminModelTable.tsx +430 -73
  433. package/src/AdminModelTable.windowed.test.tsx +897 -0
  434. package/src/AdminObjectPicker.tsx +32 -6
  435. package/src/AdminPrimitiveArrayField.test.tsx +178 -0
  436. package/src/AdminProvider.test.tsx +213 -3
  437. package/src/AdminProvider.tsx +39 -7
  438. package/src/AdminRolesList.test.tsx +197 -0
  439. package/src/AdminScreenRouter.test.tsx +393 -36
  440. package/src/AdminScreenRouter.tsx +6 -1
  441. package/src/AdminScriptList.test.tsx +180 -0
  442. package/src/AdminShell.test.tsx +595 -1
  443. package/src/AdminShell.tsx +110 -22
  444. package/src/AdminVersionConfig.tsx +31 -3
  445. package/src/AnnouncementEditor.test.tsx +603 -0
  446. package/src/AnnouncementEditor.tsx +673 -0
  447. package/src/AnnouncementList.test.tsx +198 -0
  448. package/src/AnnouncementList.tsx +214 -0
  449. package/src/AnnouncementOverview.test.tsx +325 -0
  450. package/src/AnnouncementOverview.tsx +325 -0
  451. package/src/AnnouncementOverviewScreenWidget.test.tsx +69 -0
  452. package/src/AnnouncementOverviewScreenWidget.tsx +51 -0
  453. package/src/CheckboxListEditor.test.tsx +8 -1
  454. package/src/ConsentFormEditor.test.tsx +28 -29
  455. package/src/ConsentFormEditor.tsx +27 -3
  456. package/src/ConsentFormList.test.tsx +12 -11
  457. package/src/ConsentResponseViewer.test.tsx +10 -11
  458. package/src/DocumentStorageBrowser.tsx +2 -139
  459. package/src/adminApiQueryParams.ts +33 -0
  460. package/src/adminConflictSheetStack.ts +87 -0
  461. package/src/adminContext.ts +8 -0
  462. package/src/adminModelListQueryParams.test.ts +60 -1
  463. package/src/adminModelListQueryParams.ts +89 -30
  464. package/src/adminRequest.test.ts +216 -0
  465. package/src/adminRequest.ts +213 -0
  466. package/src/adminRpc.test.ts +18 -0
  467. package/src/adminRpc.ts +31 -0
  468. package/src/adminScriptsHarness.test.ts +21 -0
  469. package/src/adminShellNav.test.ts +72 -6
  470. package/src/adminShellNav.ts +55 -10
  471. package/src/adminWindowRefresh.test.ts +65 -0
  472. package/src/adminWindowRefresh.ts +76 -0
  473. package/src/adminWindowedTable.test.ts +90 -0
  474. package/src/adminWindowedTable.ts +55 -0
  475. package/src/comms/CommsDashboardScreen.test.tsx +2 -2
  476. package/src/comms/commsDashboardParams.ts +1 -1
  477. package/src/comms/commsMessagePayload.ts +1 -1
  478. package/src/comms/useCommsDashboardApi.tsx +57 -4
  479. package/src/index.tsx +79 -1
  480. package/src/isAuditLogModel.test.ts +14 -0
  481. package/src/isAuditLogModel.ts +11 -0
  482. package/src/isolated/AIRequestsScreenWidget.isolated.tsx +84 -0
  483. package/src/isolated/AdminFieldRenderer.isolated.tsx +160 -0
  484. package/src/isolated/AdminFilterDrawer.isolated.tsx +215 -2
  485. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +172 -0
  486. package/src/isolated/AdminHomeWidgets.isolated.tsx +73 -0
  487. package/src/isolated/AdminObjectPicker.isolated.tsx +7 -0
  488. package/src/isolated/AdminScriptList.isolated.tsx +124 -0
  489. package/src/isolated/AdminScriptRunModal.isolated.tsx +274 -4
  490. package/src/isolated/DocumentStorageBrowser.isolated.tsx +13 -0
  491. package/src/isolated/RecentActivityWidget.isolated.tsx +138 -0
  492. package/src/isolated/adminWidgets.isolated.tsx +190 -0
  493. package/src/isolated/generateConsentHistoryPdf.isolated.ts +251 -0
  494. package/src/isolated/generateConsentPdfMobile.isolated.ts +87 -0
  495. package/src/isolated/generateConsentPdfsMobile.isolated.ts +129 -0
  496. package/src/isolated/hooks.isolated.tsx +245 -3
  497. package/src/isolated/rpcDualRun.isolated.tsx +449 -0
  498. package/src/isolated/useAdminScripts.isolated.tsx +156 -0
  499. package/src/isolated/useJobsDashboardApi.isolated.tsx +60 -0
  500. package/src/jobs/JobsDashboardScreen.test.tsx +310 -0
  501. package/src/jobs/JobsDashboardScreen.tsx +461 -0
  502. package/src/jobs/JobsDashboardScreenWidget.test.tsx +83 -0
  503. package/src/jobs/JobsDashboardScreenWidget.tsx +20 -0
  504. package/src/jobs/JobsHomeWidget.test.tsx +92 -0
  505. package/src/jobs/JobsHomeWidget.tsx +53 -0
  506. package/src/jobs/JobsJobDetail.test.tsx +253 -0
  507. package/src/jobs/JobsJobDetail.tsx +278 -0
  508. package/src/jobs/JobsStatusBadge.tsx +16 -0
  509. package/src/jobs/jobPayload.ts +114 -0
  510. package/src/jobs/jobsDashboardParams.test.ts +80 -0
  511. package/src/jobs/jobsDashboardParams.ts +84 -0
  512. package/src/jobs/useJobsDashboardApi.test.tsx +152 -0
  513. package/src/jobs/useJobsDashboardApi.tsx +132 -0
  514. package/src/jobs/useJobsDashboardUrlFilters.test.tsx +31 -0
  515. package/src/jobs/useJobsDashboardUrlFilters.tsx +31 -0
  516. package/src/orgs/OrgDirectoryScreen.test.tsx +184 -0
  517. package/src/orgs/OrgDirectoryScreen.tsx +200 -0
  518. package/src/orgs/OrgManagementScreens.test.tsx +270 -0
  519. package/src/orgs/OrgMembersScreen.tsx +254 -0
  520. package/src/orgs/OrgSettingsScreen.tsx +145 -0
  521. package/src/orgs/OrgSwitcher.test.tsx +145 -0
  522. package/src/orgs/OrgSwitcher.tsx +101 -0
  523. package/src/orgs/adminModelEndpoints.test.ts +156 -0
  524. package/src/orgs/adminModelEndpoints.ts +96 -0
  525. package/src/orgs/normalizeListData.test.ts +17 -0
  526. package/src/orgs/normalizeListData.ts +13 -0
  527. package/src/orgs/orgSwitcherOscillation.test.tsx +107 -0
  528. package/src/orgs/organizationSettings.test.ts +11 -0
  529. package/src/orgs/organizationSettings.ts +22 -0
  530. package/src/orgs/shouldSkipOrgScopedAdminQuery.test.ts +22 -0
  531. package/src/orgs/shouldSkipOrgScopedAdminQuery.ts +7 -0
  532. package/src/orgs/sortOrganizations.test.ts +13 -0
  533. package/src/orgs/sortOrganizations.ts +14 -0
  534. package/src/orgs/useOrgContext.test.tsx +94 -0
  535. package/src/orgs/useOrgContext.tsx +90 -0
  536. package/src/orgs/useOrganizationsApi.test.tsx +165 -0
  537. package/src/orgs/useOrganizationsApi.ts +118 -0
  538. package/src/pdfUtils.test.ts +37 -0
  539. package/src/pdfUtils.ts +2 -2
  540. package/src/testing/useAdminApiDouble.ts +70 -0
  541. package/src/types.ts +92 -4
  542. package/src/useAdminApi.test.ts +88 -0
  543. package/src/useAdminApi.ts +7 -65
  544. package/src/useAdminBackgroundTask.ts +20 -4
  545. package/src/useAdminConfig.ts +20 -2
  546. package/src/useAdminMigrations.test.tsx +75 -0
  547. package/src/useAdminMigrations.ts +77 -0
  548. package/src/useAdminRoles.test.ts +28 -0
  549. package/src/useAdminRoles.ts +40 -0
  550. package/src/useAdminRpc.test.tsx +250 -0
  551. package/src/useAdminRpc.ts +173 -0
  552. package/src/useAdminScripts.ts +67 -0
  553. package/src/useConfigurationApi.ts +24 -0
  554. package/src/useConsentHistory.ts +15 -2
  555. package/src/useDocumentStorageApi.ts +77 -0
  556. package/src/widgets/AIRequestsScreenWidget.test.tsx +154 -0
  557. package/src/widgets/AIRequestsScreenWidget.tsx +21 -7
  558. package/src/widgets/ModelsGridWidget.test.tsx +91 -0
  559. package/src/widgets/ModelsGridWidget.tsx +11 -1
  560. package/src/widgets/RecentActivityWidget.tsx +10 -3
  561. package/src/widgets/builtInFieldWidgets.test.tsx +166 -0
  562. package/src/widgets/builtInWidgets.ts +6 -0
  563. package/src/widgets/homeWidgetUtils.ts +0 -9
  564. package/src/widgets/pluginWidgets.test.tsx +10 -1
@@ -0,0 +1,31 @@
1
+ import type {AdminRequestArgs} from "./adminRequest";
2
+
3
+ export type AdminRpc = (args: AdminRequestArgs) => Promise<unknown>;
4
+
5
+ export const withQueryString = ({
6
+ params,
7
+ url,
8
+ }: {
9
+ params?: Record<string, unknown>;
10
+ url: string;
11
+ }): string => {
12
+ if (!params) {
13
+ return url;
14
+ }
15
+ const search = new URLSearchParams();
16
+ for (const [key, value] of Object.entries(params)) {
17
+ if (value === undefined || value === null || value === "") {
18
+ continue;
19
+ }
20
+ search.set(key, String(value));
21
+ }
22
+ const query = search.toString();
23
+ if (!query) {
24
+ return url;
25
+ }
26
+ return `${url}?${query}`;
27
+ };
28
+
29
+ export const asJsonBody = (value: object): Record<string, unknown> => {
30
+ return value as Record<string, unknown>;
31
+ };
@@ -0,0 +1,21 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import type {BackgroundTask} from "./types";
3
+
4
+ /**
5
+ * Shared bun-test double for `useAdminScripts`. `mock.module` is process-wide,
6
+ * so AdminScriptList and AdminMigrationsView tests must read the same task query
7
+ * state instead of installing competing module mocks.
8
+ */
9
+ export const adminScriptsHarness: {
10
+ omitGetScriptTaskQuery: boolean;
11
+ taskQuery: {data: {task?: BackgroundTask} | undefined; error: unknown};
12
+ } = {
13
+ omitGetScriptTaskQuery: false,
14
+ taskQuery: {data: undefined, error: null},
15
+ };
16
+
17
+ describe("adminScriptsHarness", () => {
18
+ it("starts with an empty task query", (): void => {
19
+ expect(adminScriptsHarness.taskQuery.data).toBeUndefined();
20
+ });
21
+ });
@@ -1,6 +1,7 @@
1
- import {describe, expect, it} from "bun:test";
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
2
3
 
3
- import {groupAdminModelsByGroup} from "./adminShellNav";
4
+ import {buildAdminSidebarGroups, groupAdminModelsByGroup} from "./adminShellNav";
4
5
  import type {AdminModelConfig} from "./types";
5
6
 
6
7
  const stubModel = (name: string, displayName: string, group?: string): AdminModelConfig =>
@@ -21,9 +22,74 @@ describe("groupAdminModelsByGroup", () => {
21
22
  stubModel("B", "B"),
22
23
  stubModel("C", "C", "Alpha"),
23
24
  ]);
24
- expect(groups.map((g) => g.group)).toEqual(["Alpha", "Zebra", "General"]);
25
- expect(groups[0]?.models.map((m) => m.name)).toEqual(["C"]);
26
- expect(groups[1]?.models.map((m) => m.name)).toEqual(["A"]);
27
- expect(groups[2]?.models.map((m) => m.name)).toEqual(["B"]);
25
+ assert.deepEqual(
26
+ groups.map((g) => g.group),
27
+ ["Alpha", "Zebra", "General"]
28
+ );
29
+ assert.deepEqual(
30
+ groups[0]?.models.map((m) => m.name),
31
+ ["C"]
32
+ );
33
+ assert.deepEqual(
34
+ groups[1]?.models.map((m) => m.name),
35
+ ["A"]
36
+ );
37
+ assert.deepEqual(
38
+ groups[2]?.models.map((m) => m.name),
39
+ ["B"]
40
+ );
41
+ });
42
+
43
+ it("returns no groups when models is missing", () => {
44
+ assert.deepEqual(groupAdminModelsByGroup(undefined as unknown as AdminModelConfig[]), []);
45
+ });
46
+ });
47
+
48
+ describe("buildAdminSidebarGroups", () => {
49
+ it("places grouped custom screens in matching model groups before models", () => {
50
+ const {groups, ungroupedScreens} = buildAdminSidebarGroups({
51
+ customScreens: [
52
+ {displayName: "Overview", group: "Announcements", name: "announcements"},
53
+ {displayName: "Reports", name: "reports"},
54
+ ],
55
+ models: [
56
+ stubModel("Announcement", "All announcements", "Announcements"),
57
+ stubModel("User", "Users", "Accounts"),
58
+ ],
59
+ });
60
+
61
+ assert.deepEqual(
62
+ ungroupedScreens.map((screen) => screen.name),
63
+ ["reports"]
64
+ );
65
+ assert.deepEqual(
66
+ groups.map((entry) => entry.group),
67
+ ["Accounts", "Announcements"]
68
+ );
69
+ const announcements = groups.find((entry) => entry.group === "Announcements");
70
+ assert.deepEqual(
71
+ announcements?.customScreens.map((screen) => screen.name),
72
+ ["announcements"]
73
+ );
74
+ assert.deepEqual(
75
+ announcements?.models.map((model) => model.name),
76
+ ["Announcement"]
77
+ );
78
+ });
79
+
80
+ it("creates a sidebar group for grouped screens without matching models", () => {
81
+ const {groups, ungroupedScreens} = buildAdminSidebarGroups({
82
+ customScreens: [{displayName: "Insights", group: "Analytics", name: "insights"}],
83
+ models: [],
84
+ });
85
+
86
+ assert.deepEqual(ungroupedScreens, []);
87
+ assert.deepEqual(groups, [
88
+ {
89
+ customScreens: [{displayName: "Insights", group: "Analytics", name: "insights"}],
90
+ group: "Analytics",
91
+ models: [],
92
+ },
93
+ ]);
28
94
  });
29
95
  });
@@ -1,15 +1,36 @@
1
- import type {AdminModelConfig} from "./types";
1
+ import type {AdminCustomScreen, AdminModelConfig} from "./types";
2
2
 
3
3
  export interface AdminModelGroup {
4
4
  group: string;
5
5
  models: AdminModelConfig[];
6
6
  }
7
7
 
8
+ export interface AdminSidebarGroup {
9
+ customScreens: AdminCustomScreen[];
10
+ group: string;
11
+ models: AdminModelConfig[];
12
+ }
13
+
14
+ const sortSidebarGroupKeys = (keys: string[]): string[] => {
15
+ return [...keys].sort((a, b) => {
16
+ if (a === "General") {
17
+ return 1;
18
+ }
19
+ if (b === "General") {
20
+ return -1;
21
+ }
22
+ return a.localeCompare(b);
23
+ });
24
+ };
25
+
8
26
  /**
9
27
  * Groups admin models by {@link AdminModelConfig.group} for sidebar navigation.
10
28
  * Models without a group go under "General", which is sorted last.
11
29
  */
12
30
  export const groupAdminModelsByGroup = (models: AdminModelConfig[]): AdminModelGroup[] => {
31
+ if (!Array.isArray(models)) {
32
+ return [];
33
+ }
13
34
  const map = new Map<string, AdminModelConfig[]>();
14
35
  for (const model of models) {
15
36
  const group = model.group?.trim() || "General";
@@ -20,14 +41,38 @@ export const groupAdminModelsByGroup = (models: AdminModelConfig[]): AdminModelG
20
41
  map.set(group, [model]);
21
42
  }
22
43
  }
23
- const keys = [...map.keys()].sort((a, b) => {
24
- if (a === "General") {
25
- return 1;
26
- }
27
- if (b === "General") {
28
- return -1;
29
- }
30
- return a.localeCompare(b);
31
- });
44
+ const keys = sortSidebarGroupKeys([...map.keys()]);
32
45
  return keys.map((group) => ({group, models: map.get(group) ?? []}));
33
46
  };
47
+
48
+ /**
49
+ * Merges grouped custom screens into model sidebar groups (screens first), leaving
50
+ * ungrouped screens for the separate Screens section.
51
+ */
52
+ export const buildAdminSidebarGroups = ({
53
+ customScreens,
54
+ models,
55
+ }: {
56
+ customScreens: AdminCustomScreen[];
57
+ models: AdminModelConfig[];
58
+ }): {groups: AdminSidebarGroup[]; ungroupedScreens: AdminCustomScreen[]} => {
59
+ const modelGroups = groupAdminModelsByGroup(models);
60
+ const groupedScreens = customScreens.filter((screen) => Boolean(screen.group?.trim()));
61
+ const ungroupedScreens = customScreens.filter((screen) => !screen.group?.trim());
62
+
63
+ const groupNames = new Set<string>();
64
+ for (const {group} of modelGroups) {
65
+ groupNames.add(group);
66
+ }
67
+ for (const screen of groupedScreens) {
68
+ groupNames.add(screen.group?.trim() ?? "General");
69
+ }
70
+
71
+ const groups = sortSidebarGroupKeys([...groupNames]).map((group) => ({
72
+ customScreens: groupedScreens.filter((screen) => (screen.group?.trim() || "General") === group),
73
+ group,
74
+ models: modelGroups.find((entry) => entry.group === group)?.models ?? [],
75
+ }));
76
+
77
+ return {groups, ungroupedScreens};
78
+ };
@@ -0,0 +1,65 @@
1
+ import {beforeEach, describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import {
4
+ clearAdminWindowMembershipStale,
5
+ getAdminWindowMembershipStale,
6
+ markAdminWindowMembershipStale,
7
+ resetAdminWindowRefreshForTests,
8
+ subscribeAdminWindowRefresh,
9
+ } from "./adminWindowRefresh";
10
+
11
+ describe("adminWindowRefresh", () => {
12
+ beforeEach(() => {
13
+ resetAdminWindowRefreshForTests();
14
+ });
15
+
16
+ it("flags and clears a collection, notifying subscribers once per change", () => {
17
+ let notifications = 0;
18
+ const unsubscribe = subscribeAdminWindowRefresh(() => {
19
+ notifications += 1;
20
+ });
21
+
22
+ assert.isUndefined(getAdminWindowMembershipStale("todos"));
23
+ markAdminWindowMembershipStale({collection: "todos"});
24
+ assert.deepEqual(getAdminWindowMembershipStale("todos"), {});
25
+ assert.equal(notifications, 1);
26
+
27
+ markAdminWindowMembershipStale({collection: "todos"});
28
+ assert.equal(notifications, 1);
29
+
30
+ clearAdminWindowMembershipStale({collection: "todos"});
31
+ assert.isUndefined(getAdminWindowMembershipStale("todos"));
32
+ assert.equal(notifications, 2);
33
+
34
+ clearAdminWindowMembershipStale({collection: "todos"});
35
+ assert.equal(notifications, 2);
36
+
37
+ unsubscribe();
38
+ markAdminWindowMembershipStale({collection: "todos"});
39
+ assert.equal(notifications, 2);
40
+ });
41
+
42
+ it("keeps a stable entry reference so it can back useSyncExternalStore", () => {
43
+ markAdminWindowMembershipStale({awaitId: "todo-9", collection: "todos"});
44
+ const first = getAdminWindowMembershipStale("todos");
45
+ assert.deepEqual(first, {awaitId: "todo-9"});
46
+ markAdminWindowMembershipStale({awaitId: "todo-9", collection: "todos"});
47
+ assert.strictEqual(getAdminWindowMembershipStale("todos"), first);
48
+
49
+ markAdminWindowMembershipStale({awaitId: "todo-10", collection: "todos"});
50
+ assert.deepEqual(getAdminWindowMembershipStale("todos"), {awaitId: "todo-10"});
51
+ });
52
+
53
+ it("ignores an empty collection and treats an undefined collection as fresh", () => {
54
+ markAdminWindowMembershipStale({collection: ""});
55
+ assert.isUndefined(getAdminWindowMembershipStale(""));
56
+ assert.isUndefined(getAdminWindowMembershipStale(undefined));
57
+ });
58
+
59
+ it("keeps collections independent", () => {
60
+ markAdminWindowMembershipStale({collection: "todos"});
61
+ assert.isUndefined(getAdminWindowMembershipStale("users"));
62
+ clearAdminWindowMembershipStale({collection: "users"});
63
+ assert.deepEqual(getAdminWindowMembershipStale("todos"), {});
64
+ });
65
+ });
@@ -0,0 +1,76 @@
1
+ /**
2
+ * Windowed admin writes go through the syncdb outbox instead of the REST list endpoint, so the
3
+ * cached membership page never learns that a row was created or removed. Forms flag the
4
+ * collection here and the changelist refetches membership, whether it stayed mounted behind the
5
+ * form or remounts when the form pops.
6
+ *
7
+ * A create also has to outrun the outbox: `mutate` only enqueues, so the first refetch can land
8
+ * before the server has the row. `awaitId` tells the changelist which id to wait for, and it
9
+ * retries a bounded number of times before falling back to the manual Refresh control.
10
+ */
11
+ export interface AdminWindowMembershipStale {
12
+ /** Id a create is waiting on; absent for deletes, where any refetch is authoritative. */
13
+ awaitId?: string;
14
+ }
15
+
16
+ const staleByCollection = new Map<string, AdminWindowMembershipStale>();
17
+ const listeners = new Set<() => void>();
18
+
19
+ const notify = (): void => {
20
+ for (const listener of listeners) {
21
+ listener();
22
+ }
23
+ };
24
+
25
+ export const subscribeAdminWindowRefresh = (listener: () => void): (() => void) => {
26
+ listeners.add(listener);
27
+ return (): void => {
28
+ listeners.delete(listener);
29
+ };
30
+ };
31
+
32
+ /**
33
+ * Returns a stable entry reference while the flag is unchanged, so it can back
34
+ * `useSyncExternalStore` without re-rendering on every notification.
35
+ */
36
+ export const getAdminWindowMembershipStale = (
37
+ collection: string | undefined
38
+ ): AdminWindowMembershipStale | undefined => {
39
+ if (!collection) {
40
+ return undefined;
41
+ }
42
+ return staleByCollection.get(collection);
43
+ };
44
+
45
+ /** Signal that a windowed write changed which rows belong to `collection`. */
46
+ export const markAdminWindowMembershipStale = ({
47
+ collection,
48
+ awaitId,
49
+ }: {
50
+ collection: string;
51
+ awaitId?: string;
52
+ }): void => {
53
+ if (collection.length === 0) {
54
+ return;
55
+ }
56
+ const existing = staleByCollection.get(collection);
57
+ if (existing && existing.awaitId === awaitId) {
58
+ return;
59
+ }
60
+ staleByCollection.set(collection, awaitId ? {awaitId} : {});
61
+ notify();
62
+ };
63
+
64
+ /** Called by the changelist once it has taken ownership of the refetch for `collection`. */
65
+ export const clearAdminWindowMembershipStale = ({collection}: {collection: string}): void => {
66
+ if (!staleByCollection.delete(collection)) {
67
+ return;
68
+ }
69
+ notify();
70
+ };
71
+
72
+ /** @internal Test helper — clears every stale flag. */
73
+ export const resetAdminWindowRefreshForTests = (): void => {
74
+ staleByCollection.clear();
75
+ notify();
76
+ };
@@ -0,0 +1,90 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {isWindowedAdminTable, resolveWindowedTableRows} from "./adminWindowedTable";
5
+ import type {AdminModelConfig, AdminSyncDb} from "./types";
6
+
7
+ const stringIdConfig = {
8
+ adminBroadcast: true,
9
+ fields: {_id: {required: true, type: "string"}, title: {required: true, type: "string"}},
10
+ syncCollection: "todos",
11
+ } as AdminModelConfig;
12
+
13
+ const fakeSyncDb = {
14
+ hydrateWindow: async () => ({hydratedIds: []}),
15
+ store: {getEntity: () => undefined},
16
+ } as AdminSyncDb;
17
+
18
+ describe("isWindowedAdminTable", () => {
19
+ it("requires syncDb, fetch client, adminBroadcast, syncCollection, and string _id", () => {
20
+ assert.isTrue(
21
+ isWindowedAdminTable({
22
+ hasFetchClient: true,
23
+ modelConfig: stringIdConfig,
24
+ syncDb: fakeSyncDb,
25
+ })
26
+ );
27
+ assert.isFalse(
28
+ isWindowedAdminTable({
29
+ hasFetchClient: true,
30
+ modelConfig: stringIdConfig,
31
+ })
32
+ );
33
+ assert.isFalse(
34
+ isWindowedAdminTable({
35
+ hasFetchClient: false,
36
+ modelConfig: stringIdConfig,
37
+ syncDb: fakeSyncDb,
38
+ })
39
+ );
40
+ assert.isFalse(
41
+ isWindowedAdminTable({
42
+ hasFetchClient: true,
43
+ modelConfig: {...stringIdConfig, adminBroadcast: false},
44
+ syncDb: fakeSyncDb,
45
+ })
46
+ );
47
+ assert.isFalse(
48
+ isWindowedAdminTable({
49
+ hasFetchClient: true,
50
+ modelConfig: {...stringIdConfig, syncCollection: undefined},
51
+ syncDb: fakeSyncDb,
52
+ })
53
+ );
54
+ assert.isFalse(
55
+ isWindowedAdminTable({
56
+ hasFetchClient: true,
57
+ modelConfig: {
58
+ ...stringIdConfig,
59
+ fields: {_id: {required: true, type: "objectid"}},
60
+ },
61
+ syncDb: fakeSyncDb,
62
+ })
63
+ );
64
+ });
65
+ });
66
+
67
+ describe("resolveWindowedTableRows", () => {
68
+ it("keeps REST membership order and ignores store ids outside the page", () => {
69
+ const restById = new Map([
70
+ ["a", {_id: "a", title: "Alpha"}],
71
+ ["b", {_id: "b", title: "Beta"}],
72
+ ]);
73
+ const store: Record<string, {data: unknown; deleted?: boolean; id: string}> = {
74
+ a: {data: {_id: "a", title: "Alpha store"}, id: "a"},
75
+ b: {data: {_id: "b", title: "Beta"}, deleted: true, id: "b"},
76
+ ghost: {data: {_id: "ghost", title: "Should not render"}, id: "ghost"},
77
+ };
78
+ const rows = resolveWindowedTableRows({
79
+ collection: "todos",
80
+ getEntity: ({id}) => store[id],
81
+ membershipIds: ["a", "b", "c"],
82
+ restById,
83
+ });
84
+ assert.deepEqual(
85
+ rows.map((row) => row.title),
86
+ ["Alpha store"]
87
+ );
88
+ assert.isUndefined(rows.find((row) => row._id === "ghost"));
89
+ });
90
+ });
@@ -0,0 +1,55 @@
1
+ import type {AdminFieldValue, AdminModelConfig, AdminSyncDb} from "./types";
2
+
3
+ export interface WindowedAdminTableGate {
4
+ hasFetchClient: boolean;
5
+ modelConfig?: AdminModelConfig;
6
+ syncDb?: AdminSyncDb;
7
+ }
8
+
9
+ export const isWindowedAdminTable = ({
10
+ hasFetchClient,
11
+ modelConfig,
12
+ syncDb,
13
+ }: WindowedAdminTableGate): boolean => {
14
+ if (!syncDb || !hasFetchClient || !modelConfig) {
15
+ return false;
16
+ }
17
+ if (modelConfig.adminBroadcast !== true) {
18
+ return false;
19
+ }
20
+ if (!modelConfig.syncCollection) {
21
+ return false;
22
+ }
23
+ return modelConfig.fields._id?.type === "string";
24
+ };
25
+
26
+ export const resolveWindowedTableRows = ({
27
+ collection,
28
+ getEntity,
29
+ membershipIds,
30
+ restById,
31
+ }: {
32
+ collection: string;
33
+ getEntity: AdminSyncDb["store"]["getEntity"];
34
+ membershipIds: string[];
35
+ restById: Map<string, Record<string, AdminFieldValue>>;
36
+ }): Array<Record<string, AdminFieldValue>> => {
37
+ const rows: Array<Record<string, AdminFieldValue>> = [];
38
+ for (const id of membershipIds) {
39
+ const entity = getEntity({collection, id});
40
+ if (entity?.deleted) {
41
+ continue;
42
+ }
43
+ const storeData =
44
+ entity?.data && typeof entity.data === "object"
45
+ ? (entity.data as Record<string, AdminFieldValue>)
46
+ : undefined;
47
+ const restData = restById.get(id);
48
+ const data = storeData ?? restData;
49
+ if (!data) {
50
+ continue;
51
+ }
52
+ rows.push({...data, _id: id});
53
+ }
54
+ return rows;
55
+ };
@@ -1,5 +1,4 @@
1
1
  import {beforeEach, describe, expect, it, mock} from "bun:test";
2
- import {Page} from "@terreno/ui";
3
2
  import {act, fireEvent, within} from "@testing-library/react-native";
4
3
  import {assert} from "chai";
5
4
  import React from "react";
@@ -65,6 +64,7 @@ const failedRow = {
65
64
  to: "a***@example.com",
66
65
  };
67
66
 
67
+ import {AdminScreenPage} from "../AdminScreenPage";
68
68
  import {CommsDashboardScreen} from "./CommsDashboardScreen";
69
69
  import {formatCommsTimestamp} from "./commsMessagePayload";
70
70
 
@@ -114,7 +114,7 @@ describe("CommsDashboardScreen", () => {
114
114
  );
115
115
  expect(getByTestId("comms-dashboard-empty")).toBeTruthy();
116
116
  expect(getByTestId("comms-stats-range-label")).toBeTruthy();
117
- assert.isTrue(UNSAFE_root.findByType(Page).props.backButton);
117
+ assert.isTrue(UNSAFE_root.findByType(AdminScreenPage).props.backHref !== undefined);
118
118
  });
119
119
 
120
120
  it("writes filter changes through onFiltersChange for URL persistence", () => {
@@ -72,7 +72,7 @@ export const serializeCommsDashboardSearchParams = (
72
72
 
73
73
  const DEFAULT_STATS_DAYS = 7;
74
74
 
75
- export const defaultCommsDashboardDateRange = (): {endDate: string; startDate: string} => {
75
+ const defaultCommsDashboardDateRange = (): {endDate: string; startDate: string} => {
76
76
  const endDate = DateTime.utc();
77
77
  const startDate = endDate.minus({days: DEFAULT_STATS_DAYS});
78
78
  return {
@@ -1,6 +1,6 @@
1
1
  import {DateTime} from "luxon";
2
2
 
3
- export interface CommsMessageAttempt {
3
+ interface CommsMessageAttempt {
4
4
  at?: string;
5
5
  error?: string;
6
6
  errorClass?: string;
@@ -1,12 +1,12 @@
1
1
  import {useMemo} from "react";
2
+ import {withQueryString} from "../adminRpc";
2
3
  import {asDynamicHookApi} from "../dynamicHookApi";
3
4
  import type {AdminApi, EndpointBuilder} from "../types";
5
+ import {useAdminRpc, useAdminRpcMutation, useAdminRpcQuery} from "../useAdminRpc";
4
6
  import type {CommsDashboardFilters} from "./commsDashboardParams";
5
7
  import type {CommsMessageRow} from "./commsMessagePayload";
6
8
 
7
- export type {CommsMessageAttempt, CommsMessageRow} from "./commsMessagePayload";
8
-
9
- export interface CommsListResponse {
9
+ interface CommsListResponse {
10
10
  data: CommsMessageRow[];
11
11
  limit: number;
12
12
  more: boolean;
@@ -36,7 +36,7 @@ export interface CommsStatsResponse {
36
36
  };
37
37
  }
38
38
 
39
- export interface CommsRetryManyResponse {
39
+ interface CommsRetryManyResponse {
40
40
  retried: CommsMessageRow[];
41
41
  skipped: Array<{id: string; reason: string}>;
42
42
  }
@@ -46,8 +46,10 @@ const DETAIL_KEY = "commsDashboardDetail";
46
46
  const STATS_KEY = "commsDashboardStats";
47
47
  const RETRY_KEY = "commsDashboardRetry";
48
48
  const RETRY_MANY_KEY = "commsDashboardRetryMany";
49
+ const COMMS_MESSAGE_TAGS = ["commsMessages"] as const;
49
50
 
50
51
  export const useCommsDashboardApi = (api: AdminApi) => {
52
+ const rpc = useAdminRpc();
51
53
  const enhancedApi = useMemo(
52
54
  () =>
53
55
  api.enhanceEndpoints({addTagTypes: ["commsMessages"]}).injectEndpoints({
@@ -96,6 +98,57 @@ export const useCommsDashboardApi = (api: AdminApi) => {
96
98
  );
97
99
 
98
100
  const hooks = asDynamicHookApi(enhancedApi);
101
+ if (rpc) {
102
+ return {
103
+ useDetailQuery: (id: string) =>
104
+ useAdminRpcQuery<CommsMessageRow | {data: CommsMessageRow}>({
105
+ providesTags: COMMS_MESSAGE_TAGS,
106
+ rpc,
107
+ url: `/comms/messages/${id}`,
108
+ }),
109
+ useListQuery: (
110
+ params: CommsDashboardFilters & {
111
+ limit?: number;
112
+ }
113
+ ) =>
114
+ useAdminRpcQuery<CommsListResponse>({
115
+ providesTags: COMMS_MESSAGE_TAGS,
116
+ rpc,
117
+ url: withQueryString({params: params as Record<string, unknown>, url: "/comms/messages"}),
118
+ }),
119
+ useRetryManyMutation: () => {
120
+ const [trigger, meta] = useAdminRpcMutation(rpc, {
121
+ invalidatesTags: COMMS_MESSAGE_TAGS,
122
+ });
123
+ return [
124
+ (body: Record<string, unknown>) =>
125
+ trigger({body, method: "POST", url: "/comms/messages/retryMany"}),
126
+ meta,
127
+ ] as [
128
+ (body: Record<string, unknown>) => {unwrap: () => Promise<CommsRetryManyResponse>},
129
+ {isLoading: boolean},
130
+ ];
131
+ },
132
+ useRetryMutation: () => {
133
+ const [trigger, meta] = useAdminRpcMutation(rpc, {
134
+ invalidatesTags: COMMS_MESSAGE_TAGS,
135
+ });
136
+ return [
137
+ (id: string) => trigger({method: "POST", url: `/comms/messages/${id}/retry`}),
138
+ meta,
139
+ ] as [
140
+ (id: string) => {unwrap: () => Promise<CommsMessageRow | {data: CommsMessageRow}>},
141
+ {isLoading: boolean},
142
+ ];
143
+ },
144
+ useStatsQuery: (params: CommsDashboardFilters) =>
145
+ useAdminRpcQuery<CommsStatsResponse>({
146
+ providesTags: COMMS_MESSAGE_TAGS,
147
+ rpc,
148
+ url: withQueryString({params: params as Record<string, unknown>, url: "/comms/stats"}),
149
+ }),
150
+ };
151
+ }
99
152
  return {
100
153
  useDetailQuery: hooks.useCommsDashboardDetailQuery as (id: string) => {
101
154
  data?: CommsMessageRow | {data: CommsMessageRow};