@terreno/admin-frontend 57.3.0 → 57.4.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 (334) hide show
  1. package/.ai/guidelines/core.md +5 -1
  2. package/README.md +4 -2
  3. package/dist/AdminConflictSheet.d.ts +16 -0
  4. package/dist/AdminConflictSheet.js +52 -0
  5. package/dist/AdminConflictSheet.js.map +1 -0
  6. package/dist/AdminHome.js +2 -1
  7. package/dist/AdminHome.js.map +1 -1
  8. package/dist/AdminMigrations.d.ts +3 -0
  9. package/dist/AdminMigrations.js +19 -0
  10. package/dist/AdminMigrations.js.map +1 -0
  11. package/dist/AdminMigrationsView.d.ts +10 -0
  12. package/dist/AdminMigrationsView.js +94 -0
  13. package/dist/AdminMigrationsView.js.map +1 -0
  14. package/dist/AdminModelForm.js +190 -44
  15. package/dist/AdminModelForm.js.map +1 -1
  16. package/dist/AdminModelTable.js +315 -27
  17. package/dist/AdminModelTable.js.map +1 -1
  18. package/dist/AdminObjectPicker.js +30 -6
  19. package/dist/AdminObjectPicker.js.map +1 -1
  20. package/dist/AdminProvider.d.ts +6 -2
  21. package/dist/AdminProvider.js +29 -7
  22. package/dist/AdminProvider.js.map +1 -1
  23. package/dist/AdminScreenRouter.d.ts +1 -1
  24. package/dist/AdminScreenRouter.js +4 -0
  25. package/dist/AdminScreenRouter.js.map +1 -1
  26. package/dist/AdminShell.d.ts +7 -3
  27. package/dist/AdminShell.js +53 -24
  28. package/dist/AdminShell.js.map +1 -1
  29. package/dist/AdminVersionConfig.js +21 -2
  30. package/dist/AdminVersionConfig.js.map +1 -1
  31. package/dist/AnnouncementEditor.d.ts +45 -0
  32. package/dist/AnnouncementEditor.js +370 -0
  33. package/dist/AnnouncementEditor.js.map +1 -0
  34. package/dist/AnnouncementList.d.ts +15 -0
  35. package/dist/AnnouncementList.js +97 -0
  36. package/dist/AnnouncementList.js.map +1 -0
  37. package/dist/AnnouncementOverview.d.ts +46 -0
  38. package/dist/AnnouncementOverview.js +101 -0
  39. package/dist/AnnouncementOverview.js.map +1 -0
  40. package/dist/AnnouncementOverviewScreenWidget.d.ts +4 -0
  41. package/dist/AnnouncementOverviewScreenWidget.js +28 -0
  42. package/dist/AnnouncementOverviewScreenWidget.js.map +1 -0
  43. package/dist/ConsentFormEditor.js +20 -3
  44. package/dist/ConsentFormEditor.js.map +1 -1
  45. package/dist/DocumentStorageBrowser.js +3 -87
  46. package/dist/DocumentStorageBrowser.js.map +1 -1
  47. package/dist/adminApiQueryParams.d.ts +5 -0
  48. package/dist/adminApiQueryParams.js +25 -0
  49. package/dist/adminApiQueryParams.js.map +1 -0
  50. package/dist/adminConflictSheetStack.d.ts +17 -0
  51. package/dist/adminConflictSheetStack.js +64 -0
  52. package/dist/adminConflictSheetStack.js.map +1 -0
  53. package/dist/adminContext.d.ts +3 -0
  54. package/dist/adminContext.js +6 -0
  55. package/dist/adminContext.js.map +1 -0
  56. package/dist/adminModelListQueryParams.d.ts +3 -2
  57. package/dist/adminModelListQueryParams.js +74 -27
  58. package/dist/adminModelListQueryParams.js.map +1 -1
  59. package/dist/adminRequest.d.ts +51 -0
  60. package/dist/adminRequest.js +161 -0
  61. package/dist/adminRequest.js.map +1 -0
  62. package/dist/adminRpc.d.ts +7 -0
  63. package/dist/adminRpc.js +21 -0
  64. package/dist/adminRpc.js.map +1 -0
  65. package/dist/adminShellNav.d.ts +17 -1
  66. package/dist/adminShellNav.js +41 -9
  67. package/dist/adminShellNav.js.map +1 -1
  68. package/dist/adminWindowRefresh.d.ts +31 -0
  69. package/dist/adminWindowRefresh.js +48 -0
  70. package/dist/adminWindowRefresh.js.map +1 -0
  71. package/dist/adminWindowedTable.d.ts +13 -0
  72. package/dist/adminWindowedTable.js +33 -0
  73. package/dist/adminWindowedTable.js.map +1 -0
  74. package/dist/comms/commsDashboardParams.d.ts +0 -4
  75. package/dist/comms/commsDashboardParams.js +1 -1
  76. package/dist/comms/commsDashboardParams.js.map +1 -1
  77. package/dist/comms/commsMessagePayload.d.ts +2 -1
  78. package/dist/comms/useCommsDashboardApi.d.ts +3 -3
  79. package/dist/comms/useCommsDashboardApi.js +41 -0
  80. package/dist/comms/useCommsDashboardApi.js.map +1 -1
  81. package/dist/index.d.ts +24 -2
  82. package/dist/index.js +23 -1
  83. package/dist/index.js.map +1 -1
  84. package/dist/isAuditLogModel.d.ts +2 -0
  85. package/dist/isAuditLogModel.js +8 -0
  86. package/dist/isAuditLogModel.js.map +1 -0
  87. package/dist/jobs/JobsDashboardScreen.d.ts +10 -0
  88. package/dist/jobs/JobsDashboardScreen.js +155 -0
  89. package/dist/jobs/JobsDashboardScreen.js.map +1 -0
  90. package/dist/jobs/JobsDashboardScreenWidget.d.ts +4 -0
  91. package/dist/jobs/JobsDashboardScreenWidget.js +11 -0
  92. package/dist/jobs/JobsDashboardScreenWidget.js.map +1 -0
  93. package/dist/jobs/JobsHomeWidget.d.ts +4 -0
  94. package/dist/jobs/JobsHomeWidget.js +21 -0
  95. package/dist/jobs/JobsHomeWidget.js.map +1 -0
  96. package/dist/jobs/JobsJobDetail.d.ts +8 -0
  97. package/dist/jobs/JobsJobDetail.js +78 -0
  98. package/dist/jobs/JobsJobDetail.js.map +1 -0
  99. package/dist/jobs/JobsStatusBadge.d.ts +5 -0
  100. package/dist/jobs/JobsStatusBadge.js +16 -0
  101. package/dist/jobs/JobsStatusBadge.js.map +1 -0
  102. package/dist/jobs/jobPayload.d.ts +62 -0
  103. package/dist/jobs/jobPayload.js +54 -0
  104. package/dist/jobs/jobPayload.js.map +1 -0
  105. package/dist/jobs/jobsDashboardParams.d.ts +11 -0
  106. package/dist/jobs/jobsDashboardParams.js +70 -0
  107. package/dist/jobs/jobsDashboardParams.js.map +1 -0
  108. package/dist/jobs/useJobsDashboardApi.d.ts +60 -0
  109. package/dist/jobs/useJobsDashboardApi.js +88 -0
  110. package/dist/jobs/useJobsDashboardApi.js.map +1 -0
  111. package/dist/jobs/useJobsDashboardUrlFilters.d.ts +5 -0
  112. package/dist/jobs/useJobsDashboardUrlFilters.js +16 -0
  113. package/dist/jobs/useJobsDashboardUrlFilters.js.map +1 -0
  114. package/dist/orgs/OrgDirectoryScreen.d.ts +16 -0
  115. package/dist/orgs/OrgDirectoryScreen.js +81 -0
  116. package/dist/orgs/OrgDirectoryScreen.js.map +1 -0
  117. package/dist/orgs/OrgMembersScreen.d.ts +9 -0
  118. package/dist/orgs/OrgMembersScreen.js +115 -0
  119. package/dist/orgs/OrgMembersScreen.js.map +1 -0
  120. package/dist/orgs/OrgSettingsScreen.d.ts +9 -0
  121. package/dist/orgs/OrgSettingsScreen.js +80 -0
  122. package/dist/orgs/OrgSettingsScreen.js.map +1 -0
  123. package/dist/orgs/OrgSwitcher.d.ts +8 -0
  124. package/dist/orgs/OrgSwitcher.js +58 -0
  125. package/dist/orgs/OrgSwitcher.js.map +1 -0
  126. package/dist/orgs/adminModelEndpoints.d.ts +18 -0
  127. package/dist/orgs/adminModelEndpoints.js +73 -0
  128. package/dist/orgs/adminModelEndpoints.js.map +1 -0
  129. package/dist/orgs/normalizeListData.d.ts +9 -0
  130. package/dist/orgs/normalizeListData.js +8 -0
  131. package/dist/orgs/normalizeListData.js.map +1 -0
  132. package/dist/orgs/organizationSettings.d.ts +17 -0
  133. package/dist/orgs/organizationSettings.js +6 -0
  134. package/dist/orgs/organizationSettings.js.map +1 -0
  135. package/dist/orgs/shouldSkipOrgScopedAdminQuery.d.ts +4 -0
  136. package/dist/orgs/shouldSkipOrgScopedAdminQuery.js +2 -0
  137. package/dist/orgs/shouldSkipOrgScopedAdminQuery.js.map +1 -0
  138. package/dist/orgs/sortOrganizations.d.ts +6 -0
  139. package/dist/orgs/sortOrganizations.js +9 -0
  140. package/dist/orgs/sortOrganizations.js.map +1 -0
  141. package/dist/orgs/useOrgContext.d.ts +20 -0
  142. package/dist/orgs/useOrgContext.js +57 -0
  143. package/dist/orgs/useOrgContext.js.map +1 -0
  144. package/dist/orgs/useOrganizationsApi.d.ts +14 -0
  145. package/dist/orgs/useOrganizationsApi.js +103 -0
  146. package/dist/orgs/useOrganizationsApi.js.map +1 -0
  147. package/dist/pdfUtils.d.ts +0 -2
  148. package/dist/pdfUtils.js +2 -2
  149. package/dist/pdfUtils.js.map +1 -1
  150. package/dist/types.d.ts +100 -4
  151. package/dist/types.js.map +1 -1
  152. package/dist/useAdminApi.js +7 -61
  153. package/dist/useAdminApi.js.map +1 -1
  154. package/dist/useAdminBackgroundTask.d.ts +1 -1
  155. package/dist/useAdminBackgroundTask.js +18 -3
  156. package/dist/useAdminBackgroundTask.js.map +1 -1
  157. package/dist/useAdminConfig.js +16 -1
  158. package/dist/useAdminConfig.js.map +1 -1
  159. package/dist/useAdminMigrations.d.ts +40 -0
  160. package/dist/useAdminMigrations.js +43 -0
  161. package/dist/useAdminMigrations.js.map +1 -0
  162. package/dist/useAdminRoles.d.ts +1 -0
  163. package/dist/useAdminRoles.js +34 -0
  164. package/dist/useAdminRoles.js.map +1 -1
  165. package/dist/useAdminRpc.d.ts +28 -0
  166. package/dist/useAdminRpc.js +128 -0
  167. package/dist/useAdminRpc.js.map +1 -0
  168. package/dist/useAdminScripts.js +51 -0
  169. package/dist/useAdminScripts.js.map +1 -1
  170. package/dist/useConfigurationApi.js +23 -0
  171. package/dist/useConfigurationApi.js.map +1 -1
  172. package/dist/useConsentHistory.js +9 -1
  173. package/dist/useConsentHistory.js.map +1 -1
  174. package/dist/useDocumentStorageApi.js +72 -0
  175. package/dist/useDocumentStorageApi.js.map +1 -1
  176. package/dist/widgets/AIRequestsScreenWidget.js +17 -7
  177. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -1
  178. package/dist/widgets/ModelsGridWidget.js +10 -3
  179. package/dist/widgets/ModelsGridWidget.js.map +1 -1
  180. package/dist/widgets/RecentActivityWidget.js +11 -4
  181. package/dist/widgets/RecentActivityWidget.js.map +1 -1
  182. package/dist/widgets/builtInWidgets.js +5 -9
  183. package/dist/widgets/builtInWidgets.js.map +1 -1
  184. package/dist/widgets/homeWidgetUtils.d.ts +0 -1
  185. package/dist/widgets/homeWidgetUtils.js +0 -8
  186. package/dist/widgets/homeWidgetUtils.js.map +1 -1
  187. package/package.json +6 -4
  188. package/src/AdminActionMenu.test.tsx +167 -0
  189. package/src/AdminBreadcrumbs.test.tsx +21 -1
  190. package/src/AdminConflictSheet.test.tsx +173 -0
  191. package/src/AdminConflictSheet.tsx +102 -0
  192. package/src/AdminHome.test.tsx +10 -11
  193. package/src/AdminHome.tsx +2 -4
  194. package/src/AdminMigrations.tsx +45 -0
  195. package/src/AdminMigrationsView.tsx +225 -0
  196. package/src/{AdminModelForm.test.tsx → AdminModelForm.isolated.tsx} +461 -154
  197. package/src/AdminModelForm.orgSkip.test.tsx +81 -0
  198. package/src/AdminModelForm.tsx +227 -56
  199. package/src/AdminModelForm.updateDepth.test.tsx +427 -0
  200. package/src/AdminModelList.test.tsx +12 -2
  201. package/src/AdminModelTable.test.tsx +560 -57
  202. package/src/AdminModelTable.tsx +430 -73
  203. package/src/AdminModelTable.windowed.test.tsx +897 -0
  204. package/src/AdminObjectPicker.tsx +32 -6
  205. package/src/AdminPrimitiveArrayField.test.tsx +178 -0
  206. package/src/AdminProvider.test.tsx +213 -3
  207. package/src/AdminProvider.tsx +39 -7
  208. package/src/AdminRolesList.test.tsx +197 -0
  209. package/src/AdminScreenRouter.test.tsx +393 -36
  210. package/src/AdminScreenRouter.tsx +6 -1
  211. package/src/AdminScriptList.test.tsx +180 -0
  212. package/src/AdminShell.test.tsx +595 -1
  213. package/src/AdminShell.tsx +110 -22
  214. package/src/AdminVersionConfig.tsx +31 -3
  215. package/src/AnnouncementEditor.test.tsx +603 -0
  216. package/src/AnnouncementEditor.tsx +673 -0
  217. package/src/AnnouncementList.test.tsx +198 -0
  218. package/src/AnnouncementList.tsx +214 -0
  219. package/src/AnnouncementOverview.test.tsx +325 -0
  220. package/src/AnnouncementOverview.tsx +325 -0
  221. package/src/AnnouncementOverviewScreenWidget.test.tsx +69 -0
  222. package/src/AnnouncementOverviewScreenWidget.tsx +51 -0
  223. package/src/CheckboxListEditor.test.tsx +8 -1
  224. package/src/ConsentFormEditor.test.tsx +28 -29
  225. package/src/ConsentFormEditor.tsx +27 -3
  226. package/src/ConsentFormList.test.tsx +12 -11
  227. package/src/ConsentResponseViewer.test.tsx +10 -11
  228. package/src/DocumentStorageBrowser.tsx +2 -139
  229. package/src/adminApiQueryParams.ts +33 -0
  230. package/src/adminConflictSheetStack.ts +87 -0
  231. package/src/adminContext.ts +8 -0
  232. package/src/adminModelListQueryParams.test.ts +60 -1
  233. package/src/adminModelListQueryParams.ts +89 -30
  234. package/src/adminRequest.test.ts +216 -0
  235. package/src/adminRequest.ts +213 -0
  236. package/src/adminRpc.test.ts +18 -0
  237. package/src/adminRpc.ts +31 -0
  238. package/src/adminScriptsHarness.test.ts +21 -0
  239. package/src/adminShellNav.test.ts +72 -6
  240. package/src/adminShellNav.ts +55 -10
  241. package/src/adminWindowRefresh.test.ts +65 -0
  242. package/src/adminWindowRefresh.ts +76 -0
  243. package/src/adminWindowedTable.test.ts +90 -0
  244. package/src/adminWindowedTable.ts +55 -0
  245. package/src/comms/CommsDashboardScreen.test.tsx +2 -2
  246. package/src/comms/commsDashboardParams.ts +1 -1
  247. package/src/comms/commsMessagePayload.ts +1 -1
  248. package/src/comms/useCommsDashboardApi.tsx +57 -4
  249. package/src/index.tsx +79 -1
  250. package/src/isAuditLogModel.test.ts +14 -0
  251. package/src/isAuditLogModel.ts +11 -0
  252. package/src/isolated/AIRequestsScreenWidget.isolated.tsx +84 -0
  253. package/src/isolated/AdminFieldRenderer.isolated.tsx +160 -0
  254. package/src/isolated/AdminFilterDrawer.isolated.tsx +215 -2
  255. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +172 -0
  256. package/src/isolated/AdminHomeWidgets.isolated.tsx +73 -0
  257. package/src/isolated/AdminObjectPicker.isolated.tsx +7 -0
  258. package/src/isolated/AdminScriptList.isolated.tsx +124 -0
  259. package/src/isolated/AdminScriptRunModal.isolated.tsx +274 -4
  260. package/src/isolated/DocumentStorageBrowser.isolated.tsx +13 -0
  261. package/src/isolated/RecentActivityWidget.isolated.tsx +138 -0
  262. package/src/isolated/adminWidgets.isolated.tsx +190 -0
  263. package/src/isolated/generateConsentHistoryPdf.isolated.ts +251 -0
  264. package/src/isolated/generateConsentPdfMobile.isolated.ts +87 -0
  265. package/src/isolated/generateConsentPdfsMobile.isolated.ts +129 -0
  266. package/src/isolated/hooks.isolated.tsx +245 -3
  267. package/src/isolated/rpcDualRun.isolated.tsx +449 -0
  268. package/src/isolated/useAdminScripts.isolated.tsx +156 -0
  269. package/src/isolated/useJobsDashboardApi.isolated.tsx +60 -0
  270. package/src/jobs/JobsDashboardScreen.test.tsx +310 -0
  271. package/src/jobs/JobsDashboardScreen.tsx +461 -0
  272. package/src/jobs/JobsDashboardScreenWidget.test.tsx +83 -0
  273. package/src/jobs/JobsDashboardScreenWidget.tsx +20 -0
  274. package/src/jobs/JobsHomeWidget.test.tsx +92 -0
  275. package/src/jobs/JobsHomeWidget.tsx +53 -0
  276. package/src/jobs/JobsJobDetail.test.tsx +253 -0
  277. package/src/jobs/JobsJobDetail.tsx +278 -0
  278. package/src/jobs/JobsStatusBadge.tsx +16 -0
  279. package/src/jobs/jobPayload.ts +114 -0
  280. package/src/jobs/jobsDashboardParams.test.ts +80 -0
  281. package/src/jobs/jobsDashboardParams.ts +84 -0
  282. package/src/jobs/useJobsDashboardApi.test.tsx +152 -0
  283. package/src/jobs/useJobsDashboardApi.tsx +132 -0
  284. package/src/jobs/useJobsDashboardUrlFilters.test.tsx +31 -0
  285. package/src/jobs/useJobsDashboardUrlFilters.tsx +31 -0
  286. package/src/orgs/OrgDirectoryScreen.test.tsx +184 -0
  287. package/src/orgs/OrgDirectoryScreen.tsx +200 -0
  288. package/src/orgs/OrgManagementScreens.test.tsx +270 -0
  289. package/src/orgs/OrgMembersScreen.tsx +254 -0
  290. package/src/orgs/OrgSettingsScreen.tsx +145 -0
  291. package/src/orgs/OrgSwitcher.test.tsx +145 -0
  292. package/src/orgs/OrgSwitcher.tsx +101 -0
  293. package/src/orgs/adminModelEndpoints.test.ts +156 -0
  294. package/src/orgs/adminModelEndpoints.ts +96 -0
  295. package/src/orgs/normalizeListData.test.ts +17 -0
  296. package/src/orgs/normalizeListData.ts +13 -0
  297. package/src/orgs/orgSwitcherOscillation.test.tsx +107 -0
  298. package/src/orgs/organizationSettings.test.ts +11 -0
  299. package/src/orgs/organizationSettings.ts +22 -0
  300. package/src/orgs/shouldSkipOrgScopedAdminQuery.test.ts +22 -0
  301. package/src/orgs/shouldSkipOrgScopedAdminQuery.ts +7 -0
  302. package/src/orgs/sortOrganizations.test.ts +13 -0
  303. package/src/orgs/sortOrganizations.ts +14 -0
  304. package/src/orgs/useOrgContext.test.tsx +94 -0
  305. package/src/orgs/useOrgContext.tsx +90 -0
  306. package/src/orgs/useOrganizationsApi.test.tsx +165 -0
  307. package/src/orgs/useOrganizationsApi.ts +118 -0
  308. package/src/pdfUtils.test.ts +37 -0
  309. package/src/pdfUtils.ts +2 -2
  310. package/src/testing/useAdminApiDouble.ts +70 -0
  311. package/src/types.ts +92 -4
  312. package/src/useAdminApi.test.ts +88 -0
  313. package/src/useAdminApi.ts +7 -65
  314. package/src/useAdminBackgroundTask.ts +20 -4
  315. package/src/useAdminConfig.ts +20 -2
  316. package/src/useAdminMigrations.test.tsx +75 -0
  317. package/src/useAdminMigrations.ts +77 -0
  318. package/src/useAdminRoles.test.ts +28 -0
  319. package/src/useAdminRoles.ts +40 -0
  320. package/src/useAdminRpc.test.tsx +250 -0
  321. package/src/useAdminRpc.ts +173 -0
  322. package/src/useAdminScripts.ts +67 -0
  323. package/src/useConfigurationApi.ts +24 -0
  324. package/src/useConsentHistory.ts +15 -2
  325. package/src/useDocumentStorageApi.ts +77 -0
  326. package/src/widgets/AIRequestsScreenWidget.test.tsx +154 -0
  327. package/src/widgets/AIRequestsScreenWidget.tsx +21 -7
  328. package/src/widgets/ModelsGridWidget.test.tsx +91 -0
  329. package/src/widgets/ModelsGridWidget.tsx +11 -1
  330. package/src/widgets/RecentActivityWidget.tsx +10 -3
  331. package/src/widgets/builtInFieldWidgets.test.tsx +166 -0
  332. package/src/widgets/builtInWidgets.ts +6 -0
  333. package/src/widgets/homeWidgetUtils.ts +0 -9
  334. package/src/widgets/pluginWidgets.test.tsx +10 -1
@@ -0,0 +1,129 @@
1
+ import {beforeEach, describe, expect, it, mock} from "bun:test";
2
+ import {Platform} from "react-native";
3
+
4
+ interface ShareCall {
5
+ filename: string;
6
+ html: string;
7
+ }
8
+
9
+ const templateCalls: unknown[] = [];
10
+ const shareCalls: ShareCall[] = [];
11
+
12
+ mock.module("@terreno/ui", () => ({
13
+ buildConsentPdfHtml: (data: unknown): string => {
14
+ templateCalls.push(data);
15
+ return "<html>consent</html>";
16
+ },
17
+ sharePdfFromHtml: async (call: ShareCall): Promise<void> => {
18
+ shareCalls.push(call);
19
+ },
20
+ }));
21
+
22
+ Platform.OS = "ios";
23
+
24
+ import {generateConsentHistoryPdf} from "../generateConsentHistoryPdf";
25
+ import {generateConsentPdf} from "../generateConsentPdf";
26
+
27
+ describe("mobile consent PDF generation", () => {
28
+ beforeEach(() => {
29
+ templateCalls.length = 0;
30
+ shareCalls.length = 0;
31
+ });
32
+
33
+ it("builds and shares a complete consent response template", async () => {
34
+ await generateConsentPdf({
35
+ _id: "response-123",
36
+ agreed: true,
37
+ agreedAt: "2026-09-01T10:00:00.000Z",
38
+ checkboxValues: {"0": true},
39
+ consentFormId: {slug: "privacy", title: "Privacy", type: "legal", version: 2},
40
+ contentSnapshot: "Terms",
41
+ formVersionSnapshot: 2,
42
+ ipAddress: "127.0.0.1",
43
+ locale: "en",
44
+ signature: "data:image/png;base64,AAA",
45
+ signedAt: "2026-09-01T10:01:00.000Z",
46
+ userAgent: "Mobile",
47
+ userId: {_id: "user-1", email: "user@example.com", name: "User"},
48
+ });
49
+
50
+ expect(templateCalls).toHaveLength(1);
51
+ expect(templateCalls[0]).toMatchObject({
52
+ auditTrail: expect.any(Array),
53
+ fields: expect.any(Array),
54
+ formTitle: "Privacy",
55
+ responseId: "response-123",
56
+ title: "Consent Record",
57
+ userInfo: {email: "user@example.com", name: "User", userId: "user-1"},
58
+ });
59
+ expect(shareCalls).toHaveLength(1);
60
+ expect(shareCalls[0].filename).toMatch(/^consent-privacy-user-1-\d{4}-\d{2}-\d{2}\.pdf$/);
61
+ expect(shareCalls[0].html).toBe("<html>consent</html>");
62
+ });
63
+
64
+ it("builds fallback consent response fields for legacy ids", async () => {
65
+ await generateConsentPdf({
66
+ agreed: false,
67
+ consentFormId: "legacy-form",
68
+ formVersionSnapshot: 3,
69
+ userId: "legacy-user",
70
+ });
71
+
72
+ expect(templateCalls[0]).toMatchObject({
73
+ auditTrail: expect.any(Array),
74
+ formTitle: "Unknown Form",
75
+ userInfo: {email: undefined, name: undefined, userId: "legacy-user"},
76
+ });
77
+ expect(shareCalls[0].filename).toMatch(/^consent-response-y-user-\d{4}-\d{2}-\d{2}\.pdf$/);
78
+ });
79
+
80
+ it("builds and shares a complete history-entry template", async () => {
81
+ await generateConsentHistoryPdf({
82
+ _id: "history-1",
83
+ agreed: true,
84
+ agreedAt: "2026-09-01T10:00:00.000Z",
85
+ checkboxValues: {"0": true, "2": false},
86
+ contentSnapshot: "Snapshot",
87
+ form: {
88
+ checkboxes: [{label: "Email"}],
89
+ slug: "terms",
90
+ title: "Terms",
91
+ type: "legal",
92
+ version: 4,
93
+ },
94
+ formVersionSnapshot: 4,
95
+ ipAddress: "127.0.0.1",
96
+ locale: "en",
97
+ signature: "data:image/png;base64,BBB",
98
+ signedAt: "2026-09-01T10:01:00.000Z",
99
+ userAgent: "Mobile",
100
+ });
101
+
102
+ expect(templateCalls[0]).toMatchObject({
103
+ auditTrail: expect.any(Array),
104
+ checkboxes: [
105
+ {checked: true, label: "Email"},
106
+ {checked: false, label: "Checkbox 2"},
107
+ ],
108
+ formTitle: "Terms",
109
+ responseId: "history-1",
110
+ title: "Consent Record",
111
+ });
112
+ expect(shareCalls[0].filename).toMatch(/^consent-terms-\d{4}-\d{2}-\d{2}\.pdf$/);
113
+ });
114
+
115
+ it("omits empty optional history sections", async () => {
116
+ await generateConsentHistoryPdf({
117
+ _id: "history-2",
118
+ agreed: false,
119
+ });
120
+
121
+ expect(templateCalls[0]).toMatchObject({
122
+ auditTrail: undefined,
123
+ checkboxes: undefined,
124
+ fields: [{label: "Decision:", value: "Declined"}],
125
+ formTitle: "Unknown Form",
126
+ });
127
+ expect(shareCalls[0].filename).toMatch(/^consent-response-\d{4}-\d{2}-\d{2}\.pdf$/);
128
+ });
129
+ });
@@ -13,7 +13,9 @@ import {describe, expect, it, mock} from "bun:test";
13
13
  import React from "react";
14
14
  import {renderWithTheme} from "../../../ui/src/test-utils";
15
15
  import {useAdminApi} from "../useAdminApi";
16
+ import {useAdminBackgroundTaskMutation} from "../useAdminBackgroundTask";
16
17
  import {useAdminConfig} from "../useAdminConfig";
18
+ import {normalizeRoles, normalizeStatements, useAdminRoles} from "../useAdminRoles";
17
19
  import {useAdminScripts} from "../useAdminScripts";
18
20
  import {useConfigurationApi} from "../useConfigurationApi";
19
21
  import {useDocumentStorageApi} from "../useDocumentStorageApi";
@@ -123,18 +125,19 @@ describe("useAdminApi", () => {
123
125
  // Each endpoint's query fn produces expected URL/method
124
126
  const listDef = injected.adminList_User;
125
127
  expect(listDef.query({limit: 1})).toEqual({
128
+ headers: undefined,
126
129
  method: "GET",
127
- params: {limit: 1},
128
- url: "/admin/users",
130
+ url: "/admin/users?limit=1",
129
131
  });
130
132
  expect(listDef.query(undefined)).toEqual({
133
+ headers: undefined,
131
134
  method: "GET",
132
- params: {},
133
135
  url: "/admin/users",
134
136
  });
135
137
 
136
138
  const readDef = injected.adminRead_User;
137
139
  expect(readDef.query("abc")).toEqual({
140
+ headers: undefined,
138
141
  method: "GET",
139
142
  url: "/admin/users/abc",
140
143
  });
@@ -143,6 +146,7 @@ describe("useAdminApi", () => {
143
146
  const createDef = injected.adminCreate_User;
144
147
  expect(createDef.query({name: "x"})).toEqual({
145
148
  body: {name: "x"},
149
+ headers: undefined,
146
150
  method: "POST",
147
151
  url: "/admin/users",
148
152
  });
@@ -151,6 +155,7 @@ describe("useAdminApi", () => {
151
155
  const updateDef = injected.adminUpdate_User;
152
156
  expect(updateDef.query({body: {x: 1}, id: "123"})).toEqual({
153
157
  body: {x: 1},
158
+ headers: undefined,
154
159
  method: "PATCH",
155
160
  url: "/admin/users/123",
156
161
  });
@@ -161,16 +166,71 @@ describe("useAdminApi", () => {
161
166
 
162
167
  const deleteDef = injected.adminDelete_User;
163
168
  expect(deleteDef.query("123")).toEqual({
169
+ headers: undefined,
164
170
  method: "DELETE",
165
171
  url: "/admin/users/123",
166
172
  });
167
173
 
174
+ const bulkPatchDef = injected.adminBulkPatch_User;
175
+ expect(bulkPatchDef.query({ids: ["123"], patch: {name: "Patched"}})).toEqual({
176
+ body: {ids: ["123"], patch: {name: "Patched"}},
177
+ headers: undefined,
178
+ method: "POST",
179
+ url: "/admin/users/bulk-patch",
180
+ });
181
+
168
182
  // Returned hooks should be functions (generated by our mock)
169
183
  expect(typeof result.useListQuery).toBe("function");
170
184
  expect(typeof result.useReadQuery).toBe("function");
171
185
  expect(typeof result.useCreateMutation).toBe("function");
172
186
  expect(typeof result.useUpdateMutation).toBe("function");
173
187
  expect(typeof result.useDeleteMutation).toBe("function");
188
+ expect(typeof result.useBulkPatchMutation).toBe("function");
189
+ });
190
+
191
+ it("pins list/read/create/update/delete/bulk-patch URLs for String-_id routePath", () => {
192
+ const api = makeMockApi();
193
+ const result = runHook(() => useAdminApi(api, "/admin/todos", "Todo"));
194
+ const injected = (api as Record<string, unknown>).__injected as CapturedEndpoints;
195
+
196
+ expect(
197
+ injected.adminList_Todo.query({limit: 20, page: 1, q: "Alpha", sort: "-created"})
198
+ ).toEqual({
199
+ headers: undefined,
200
+ method: "GET",
201
+ url: "/admin/todos?limit=20&page=1&q=Alpha&sort=-created",
202
+ });
203
+ expect(injected.adminRead_Todo.query("todo-alpha")).toEqual({
204
+ headers: undefined,
205
+ method: "GET",
206
+ url: "/admin/todos/todo-alpha",
207
+ });
208
+ expect(injected.adminCreate_Todo.query({title: "New"})).toEqual({
209
+ body: {title: "New"},
210
+ headers: undefined,
211
+ method: "POST",
212
+ url: "/admin/todos",
213
+ });
214
+ expect(injected.adminUpdate_Todo.query({body: {completed: true}, id: "todo-alpha"})).toEqual({
215
+ body: {completed: true},
216
+ headers: undefined,
217
+ method: "PATCH",
218
+ url: "/admin/todos/todo-alpha",
219
+ });
220
+ expect(injected.adminDelete_Todo.query("todo-alpha")).toEqual({
221
+ headers: undefined,
222
+ method: "DELETE",
223
+ url: "/admin/todos/todo-alpha",
224
+ });
225
+ expect(
226
+ injected.adminBulkPatch_Todo.query({ids: ["todo-alpha"], patch: {completed: true}})
227
+ ).toEqual({
228
+ body: {ids: ["todo-alpha"], patch: {completed: true}},
229
+ headers: undefined,
230
+ method: "POST",
231
+ url: "/admin/todos/bulk-patch",
232
+ });
233
+ expect(typeof result.useBulkPatchMutation).toBe("function");
174
234
  });
175
235
  });
176
236
 
@@ -201,6 +261,7 @@ describe("useAdminScripts", () => {
201
261
  expect(injected.adminRunScript).toBeDefined();
202
262
  expect(injected.adminGetScriptTask).toBeDefined();
203
263
  expect(injected.adminCancelScriptTask).toBeDefined();
264
+ expect(injected.adminListScriptRuns).toBeDefined();
204
265
 
205
266
  const runDef = injected.adminRunScript;
206
267
  expect(runDef.query({name: "migrate", wetRun: false})).toEqual({
@@ -222,9 +283,135 @@ describe("useAdminScripts", () => {
222
283
  });
223
284
  expect(cancelDef.invalidatesTags).toEqual(["admin_scriptTask", "admin_scriptRuns"]);
224
285
 
286
+ const listDef = injected.adminListScriptRuns;
287
+ expect(listDef.query()).toEqual({
288
+ method: "GET",
289
+ url: "/admin/scripts/runs?page=1&limit=25",
290
+ });
291
+ expect(listDef.query({limit: 10, name: "migrate", page: 2})).toEqual({
292
+ method: "GET",
293
+ url: "/admin/scripts/runs?page=2&limit=10&name=migrate",
294
+ });
295
+ expect(listDef.providesTags).toEqual(["admin_scriptRuns"]);
225
296
  expect(typeof result.useRunScriptMutation).toBe("function");
226
297
  expect(typeof result.useGetScriptTaskQuery).toBe("function");
227
298
  expect(typeof result.useCancelScriptTaskMutation).toBe("function");
299
+ expect(typeof result.useListScriptRunsQuery).toBe("function");
300
+ });
301
+
302
+ it("returns safe script hooks when endpoint injection is unavailable", async () => {
303
+ const result = runHook(() => useAdminScripts({} as never, "/admin"));
304
+
305
+ expect(await result.useCancelScriptTaskMutation()[0]("task-1").unwrap()).toEqual({});
306
+ expect(result.useGetScriptTaskQuery("task-1")).toEqual({
307
+ data: undefined,
308
+ error: null,
309
+ isLoading: false,
310
+ });
311
+ expect(result.useListScriptRunsQuery()).toEqual({
312
+ data: undefined,
313
+ error: null,
314
+ isFetching: false,
315
+ isLoading: false,
316
+ });
317
+ expect(
318
+ await result.useRunScriptMutation()[0]({name: "migrate", wetRun: false}).unwrap()
319
+ ).toEqual({taskId: ""});
320
+ });
321
+ });
322
+
323
+ describe("useAdminRoles", () => {
324
+ it("injects RBAC endpoints outside the admin base", () => {
325
+ const api = makeMockApi();
326
+ const result = runHook(() => useAdminRoles(api, "/admin"));
327
+ const injected = (api as Record<string, unknown>).__injected as CapturedEndpoints;
328
+
329
+ expect(
330
+ injected.adminCreateRbacRole.query({
331
+ displayName: "Operators",
332
+ name: "operator",
333
+ permissions: {todos: ["read"]},
334
+ })
335
+ ).toEqual({
336
+ body: {
337
+ displayName: "Operators",
338
+ name: "operator",
339
+ permissions: {todos: ["read"]},
340
+ },
341
+ method: "POST",
342
+ url: "/rbac/roles",
343
+ });
344
+ expect(injected.adminListRbacRoles.query()).toEqual({method: "GET", url: "/rbac/roles"});
345
+ expect(injected.adminListRbacStatements.query()).toEqual({
346
+ method: "GET",
347
+ url: "/rbac/statements",
348
+ });
349
+ expect(
350
+ injected.adminUpdateRbacRole.query({
351
+ changes: {displayName: "Operators", permissions: {}},
352
+ roleName: "operator/admin",
353
+ })
354
+ ).toEqual({
355
+ body: {displayName: "Operators", permissions: {}},
356
+ method: "PATCH",
357
+ url: "/rbac/roles/operator%2Fadmin",
358
+ });
359
+ expect(typeof result.useCreateRoleMutation).toBe("function");
360
+ expect(typeof result.useListRolesQuery).toBe("function");
361
+ expect(typeof result.useListStatementsQuery).toBe("function");
362
+ expect(typeof result.useUpdateRoleMutation).toBe("function");
363
+ });
364
+
365
+ it("uses safe empty hooks when RTK injection is unavailable", async () => {
366
+ const result = runHook(() => useAdminRoles({} as never, "/admin"));
367
+
368
+ expect(result.useListRolesQuery()).toMatchObject({data: undefined, isLoading: false});
369
+ expect(result.useListStatementsQuery()).toMatchObject({data: undefined, isLoading: false});
370
+ await expect(
371
+ result.useCreateRoleMutation()[0]({displayName: "x", name: "x", permissions: {}}).unwrap()
372
+ ).rejects.toThrow("Role management API is unavailable");
373
+ await expect(
374
+ result
375
+ .useUpdateRoleMutation()[0]({
376
+ changes: {displayName: "x", permissions: {}},
377
+ roleName: "x",
378
+ })
379
+ .unwrap()
380
+ ).rejects.toThrow("Role management API is unavailable");
381
+ expect(normalizeRoles([{displayName: "x", name: "x"}])).toHaveLength(1);
382
+ expect(normalizeRoles({data: [{displayName: "x", name: "x"}]})).toHaveLength(1);
383
+ expect(normalizeRoles(undefined)).toEqual([]);
384
+ expect(normalizeStatements({data: {statements: {todos: ["read"]}}})).toEqual({
385
+ todos: ["read"],
386
+ });
387
+ expect(normalizeStatements(undefined)).toEqual({});
388
+ });
389
+ });
390
+
391
+ describe("useAdminBackgroundTaskMutation", () => {
392
+ it("injects a background-task request at a normalized admin root", () => {
393
+ const api = makeMockApi();
394
+ const result = runHook(() => useAdminBackgroundTaskMutation(api, "/admin/"));
395
+ const injected = (api as Record<string, unknown>).__injected as CapturedEndpoints;
396
+
397
+ expect(
398
+ injected.adminPostBackgroundTask.query({
399
+ ids: ["todo-1"],
400
+ kind: "bulk-patch",
401
+ resourceRoute: "todos",
402
+ })
403
+ ).toEqual({
404
+ body: {
405
+ ids: ["todo-1"],
406
+ kind: "bulk-patch",
407
+ resourceRoute: "todos",
408
+ },
409
+ method: "POST",
410
+ url: "/admin/background-tasks",
411
+ });
412
+ expect(injected.adminPostBackgroundTask.invalidatesTags).toEqual([]);
413
+ expect(typeof result[0]).toBe("function");
414
+ expect(result[1]).toEqual({isLoading: false});
228
415
  });
229
416
  });
230
417
 
@@ -395,3 +582,58 @@ describe("useDocumentStorageApi", () => {
395
582
  });
396
583
  });
397
584
  });
585
+
586
+ describe("useAdminBackgroundTaskMutation", () => {
587
+ it("posts to the background-tasks collection under the admin root", () => {
588
+ const api = makeMockApi();
589
+ const result = runHook(() => useAdminBackgroundTaskMutation(api as never, "/admin/"));
590
+ const injected = (api as Record<string, unknown>).__injected as CapturedEndpoints;
591
+ expect(injected.adminPostBackgroundTask.query({ids: ["a"], kind: "reindex"})).toEqual({
592
+ body: {ids: ["a"], kind: "reindex"},
593
+ method: "POST",
594
+ url: "/admin/background-tasks",
595
+ });
596
+ expect(Array.isArray(result)).toBe(true);
597
+ });
598
+ });
599
+
600
+ describe("useAdminRoles", () => {
601
+ it("falls back to no-op hooks when injectEndpoints is missing", async () => {
602
+ const result = runHook(() => useAdminRoles({} as never, "/admin"));
603
+ await expect(
604
+ result.useCreateRoleMutation()[0]({displayName: "A", name: "a", permissions: {}}).unwrap()
605
+ ).rejects.toThrow(/unavailable/);
606
+ expect(result.useListRolesQuery()).toMatchObject({data: undefined, isLoading: false});
607
+ expect(result.useListStatementsQuery()).toMatchObject({data: undefined, isLoading: false});
608
+ });
609
+
610
+ it("injects rbac list and mutation endpoints at the API root", () => {
611
+ const api = makeMockApi();
612
+ const result = runHook(() => useAdminRoles(api as never, "/v1/admin"));
613
+ const injected = (api as Record<string, unknown>).__injected as CapturedEndpoints;
614
+ expect(injected.adminListRbacRoles.query()).toEqual({method: "GET", url: "/v1/rbac/roles"});
615
+ expect(injected.adminListRbacStatements.query()).toEqual({
616
+ method: "GET",
617
+ url: "/v1/rbac/statements",
618
+ });
619
+ expect(
620
+ injected.adminCreateRbacRole.query({displayName: "A", name: "a", permissions: {}})
621
+ ).toEqual({
622
+ body: {displayName: "A", name: "a", permissions: {}},
623
+ method: "POST",
624
+ url: "/v1/rbac/roles",
625
+ });
626
+ expect(
627
+ injected.adminUpdateRbacRole.query({
628
+ changes: {displayName: "B", permissions: {}},
629
+ roleName: "a b",
630
+ })
631
+ ).toEqual({
632
+ body: {displayName: "B", permissions: {}},
633
+ method: "PATCH",
634
+ url: "/v1/rbac/roles/a%20b",
635
+ });
636
+ expect(typeof result.useListRolesQuery).toBe("function");
637
+ expect(typeof result.useUpdateRoleMutation).toBe("function");
638
+ });
639
+ });