@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,198 @@
1
+ // noExplicitAny: test mocks use type-erased RTK Query API doubles and UNSAFE_root traversal
2
+ // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
3
+ import {beforeEach, describe, expect, it, mock} from "bun:test";
4
+ import {act, fireEvent} from "@testing-library/react-native";
5
+ import React from "react";
6
+ import type {ReactTestInstance} from "react-test-renderer";
7
+ import {renderWithTheme} from "../../ui/src/test-utils";
8
+ import {configureUseAdminApiDouble, resetUseAdminApiDouble} from "./testing/useAdminApiDouble";
9
+ import type {AdminApi} from "./types";
10
+
11
+ interface ListState {
12
+ data: unknown;
13
+ isLoading: boolean;
14
+ error: unknown;
15
+ }
16
+ const listState: ListState = {data: undefined, error: null, isLoading: false};
17
+
18
+ import {AnnouncementList} from "./AnnouncementList";
19
+
20
+ describe("AnnouncementList", () => {
21
+ beforeEach(() => {
22
+ resetUseAdminApiDouble();
23
+ configureUseAdminApiDouble({
24
+ useListQuery: () => ({
25
+ data: listState.data,
26
+ error: listState.error,
27
+ isLoading: listState.isLoading,
28
+ }),
29
+ });
30
+ listState.data = undefined;
31
+ listState.isLoading = false;
32
+ listState.error = null;
33
+ });
34
+
35
+ it("renders loading state", () => {
36
+ listState.isLoading = true;
37
+ const {toJSON} = renderWithTheme(
38
+ <AnnouncementList api={{} as unknown as AdminApi} baseUrl="/admin" />
39
+ );
40
+ expect(toJSON()).toBeDefined();
41
+ });
42
+
43
+ it("renders error state", () => {
44
+ listState.error = new Error("x");
45
+ const {getByText} = renderWithTheme(
46
+ <AnnouncementList api={{} as unknown as AdminApi} baseUrl="/admin" />
47
+ );
48
+ expect(getByText(/Failed to load announcements/)).toBeDefined();
49
+ });
50
+
51
+ it("renders empty state", () => {
52
+ listState.data = {data: [], total: 0};
53
+ const {getByText} = renderWithTheme(
54
+ <AnnouncementList api={{} as unknown as AdminApi} baseUrl="/admin" />
55
+ );
56
+ expect(getByText(/No announcements found/)).toBeDefined();
57
+ });
58
+
59
+ it("renders data without onRowClick so the ActionsCell edit-callback branch is absent", () => {
60
+ listState.data = {
61
+ data: [
62
+ {
63
+ _id: "a",
64
+ acknowledgementPolicy: "required",
65
+ audienceType: "staff",
66
+ displayMode: "modal",
67
+ priority: 1,
68
+ publishedAt: "2026-01-01T12:00:00.000Z",
69
+ status: "published",
70
+ title: "Hello",
71
+ version: 2,
72
+ },
73
+ ],
74
+ total: 1,
75
+ };
76
+ const {toJSON} = renderWithTheme(
77
+ <AnnouncementList api={{} as unknown as AdminApi} baseUrl="/admin" />
78
+ );
79
+ expect(toJSON()).toBeDefined();
80
+ });
81
+
82
+ it("renders data with create button and edit callback", async () => {
83
+ listState.data = {
84
+ data: [
85
+ {
86
+ _id: "a",
87
+ expiresAt: "2026-12-31T12:00:00.000Z",
88
+ priority: 1,
89
+ publishedAt: "2026-01-01T12:00:00.000Z",
90
+ status: "published",
91
+ title: "T1",
92
+ version: 2,
93
+ },
94
+ {_id: "b", priority: "x", status: "draft", title: "T2", version: 1},
95
+ ],
96
+ total: 2,
97
+ };
98
+ const onCreateNew = mock(() => undefined);
99
+ const onRowClick = mock((_: string) => undefined);
100
+ const {getByTestId} = renderWithTheme(
101
+ <AnnouncementList
102
+ api={{} as unknown as AdminApi}
103
+ baseUrl="/admin"
104
+ onCreateNew={onCreateNew}
105
+ onRowClick={onRowClick}
106
+ />
107
+ );
108
+ await act(async () => {
109
+ fireEvent.press(getByTestId("announcement-list-create-button"));
110
+ await new Promise((r) => setTimeout(r, 50));
111
+ });
112
+ expect(onCreateNew).toHaveBeenCalled();
113
+ });
114
+
115
+ it("falls back when sort column is out of range (buildSortString returns undefined)", async () => {
116
+ listState.data = {
117
+ data: [{_id: "a", priority: 1, status: "draft", title: "T1", version: 1}],
118
+ total: 1,
119
+ };
120
+ const {UNSAFE_root, toJSON} = renderWithTheme(
121
+ <AnnouncementList
122
+ api={{} as unknown as AdminApi}
123
+ baseUrl="/admin"
124
+ onRowClick={() => undefined}
125
+ />
126
+ );
127
+ const tables = UNSAFE_root.findAll(
128
+ (n: ReactTestInstance) => typeof n.props?.setSortColumn === "function"
129
+ );
130
+ expect(tables.length).toBeGreaterThan(0);
131
+ await act(async () => {
132
+ (tables[0] as ReactTestInstance).props.setSortColumn({column: 99, direction: "asc"});
133
+ await new Promise((r) => setTimeout(r, 10));
134
+ });
135
+ await act(async () => {
136
+ (tables[0] as ReactTestInstance).props.setSortColumn({column: 0, direction: "desc"});
137
+ await new Promise((r) => setTimeout(r, 10));
138
+ });
139
+ expect(toJSON()).toBeDefined();
140
+ });
141
+
142
+ it("invokes onRowClick from the actions cell", async () => {
143
+ listState.data = {
144
+ data: [{_id: "row-1", priority: 1, status: "draft", title: "Row", version: 1}],
145
+ total: 1,
146
+ };
147
+ const onRowClick = mock((_: string) => undefined);
148
+ const {UNSAFE_root} = renderWithTheme(
149
+ <AnnouncementList api={{} as unknown as AdminApi} baseUrl="/admin" onRowClick={onRowClick} />
150
+ );
151
+ const editButtons = UNSAFE_root.findAll(
152
+ (node: ReactTestInstance) => node.props?.accessibilityLabel === "Edit"
153
+ );
154
+ expect(editButtons.length).toBeGreaterThan(0);
155
+ await act(async () => {
156
+ const editButton = editButtons[0] as ReactTestInstance;
157
+ editButton.props.onClick?.();
158
+ await new Promise((r) => setTimeout(r, 50));
159
+ });
160
+ expect(onRowClick).toHaveBeenCalledWith("row-1");
161
+ });
162
+
163
+ it("formats invalid date cells and paginates results", async () => {
164
+ listState.data = {
165
+ data: [
166
+ {
167
+ _id: "a",
168
+ expiresAt: "not-a-date",
169
+ priority: "bad",
170
+ publishedAt: "also-bad",
171
+ status: "draft",
172
+ title: "Row",
173
+ version: "bad",
174
+ },
175
+ ],
176
+ total: 40,
177
+ };
178
+ const {UNSAFE_root} = renderWithTheme(
179
+ <AnnouncementList api={{} as unknown as AdminApi} baseUrl="/admin" />
180
+ );
181
+ const tables = UNSAFE_root.findAll(
182
+ (node: ReactTestInstance) => typeof node.props?.setPage === "function"
183
+ );
184
+ expect(tables.length).toBeGreaterThan(0);
185
+ await act(async () => {
186
+ (tables[0] as ReactTestInstance).props.setPage(2);
187
+ await new Promise((r) => setTimeout(r, 10));
188
+ });
189
+ });
190
+
191
+ it("accepts apiBase and routeBase aliases", () => {
192
+ listState.data = {data: [], total: 0};
193
+ const {getByText} = renderWithTheme(
194
+ <AnnouncementList api={{} as unknown as AdminApi} apiBase="/admin" routeBase="/admin" />
195
+ );
196
+ expect(getByText(/No announcements found/)).toBeDefined();
197
+ });
198
+ });
@@ -0,0 +1,214 @@
1
+ import {
2
+ Box,
3
+ Button,
4
+ type ColumnSortInterface,
5
+ DataTable,
6
+ type DataTableCellData,
7
+ type DataTableColumn,
8
+ type DataTableCustomComponentMap,
9
+ IconButton,
10
+ Page,
11
+ Spinner,
12
+ Text,
13
+ } from "@terreno/ui";
14
+ import {DateTime} from "luxon";
15
+ import React, {useCallback, useMemo, useState} from "react";
16
+ import {type AdminApi, resolveAdminBases} from "./types";
17
+ import {useAdminApi} from "./useAdminApi";
18
+
19
+ interface AnnouncementListProps {
20
+ /** @deprecated Use `apiBase`/`routeBase`. Kept as a backward-compatible alias. */
21
+ baseUrl?: string;
22
+ /** Base path where admin API requests are sent. Falls back to `baseUrl`. */
23
+ apiBase?: string;
24
+ /** Base path used for in-app navigation. Falls back to `baseUrl`. */
25
+ routeBase?: string;
26
+ api: AdminApi;
27
+ onCreateNew?: () => void;
28
+ onRowClick?: (id: string) => void;
29
+ }
30
+
31
+ /** Row shape returned by the announcements list endpoint. */
32
+ interface AnnouncementListItem {
33
+ _id: string;
34
+ title?: string;
35
+ status?: string;
36
+ displayMode?: string;
37
+ audienceType?: string;
38
+ acknowledgementPolicy?: string;
39
+ priority?: number;
40
+ version?: number;
41
+ publishedAt?: string;
42
+ expiresAt?: string;
43
+ [key: string]: unknown;
44
+ }
45
+
46
+ const DEFAULT_LIMIT = 20;
47
+
48
+ const ACTIONS_COLUMN_TYPE = "announcementActions";
49
+
50
+ const DATA_COLUMNS: DataTableColumn[] = [
51
+ {columnType: "text", sortable: true, title: "Title", width: 200},
52
+ {columnType: "text", sortable: true, title: "Status", width: 90},
53
+ {columnType: "text", sortable: true, title: "Display", width: 80},
54
+ {columnType: "text", sortable: true, title: "Audience", width: 90},
55
+ {columnType: "text", sortable: true, title: "Policy", width: 100},
56
+ {columnType: "number", sortable: true, title: "Priority", width: 80},
57
+ {columnType: "number", sortable: true, title: "Version", width: 80},
58
+ {columnType: "text", sortable: true, title: "Published", width: 140},
59
+ {columnType: "text", sortable: true, title: "Expires", width: 140},
60
+ ];
61
+
62
+ const DATA_COLUMN_KEYS = [
63
+ "title",
64
+ "status",
65
+ "displayMode",
66
+ "audienceType",
67
+ "acknowledgementPolicy",
68
+ "priority",
69
+ "version",
70
+ "publishedAt",
71
+ "expiresAt",
72
+ ];
73
+
74
+ const formatDateCell = (value: unknown): string => {
75
+ if (!value) {
76
+ return "";
77
+ }
78
+ const parsed = DateTime.fromISO(String(value));
79
+ if (!parsed.isValid) {
80
+ return String(value);
81
+ }
82
+ return parsed.toLocaleString(DateTime.DATETIME_MED);
83
+ };
84
+
85
+ const buildSortString = (sort: ColumnSortInterface | undefined): string | undefined => {
86
+ if (!sort) {
87
+ return undefined;
88
+ }
89
+ const fieldKey = DATA_COLUMN_KEYS[sort.column];
90
+ if (!fieldKey) {
91
+ return undefined;
92
+ }
93
+ return sort.direction === "desc" ? `-${fieldKey}` : fieldKey;
94
+ };
95
+
96
+ export const AnnouncementList: React.FC<AnnouncementListProps> = ({
97
+ baseUrl,
98
+ apiBase,
99
+ routeBase,
100
+ api,
101
+ onCreateNew,
102
+ onRowClick,
103
+ }) => {
104
+ const {apiBase: resolvedApiBase} = resolveAdminBases({apiBase, baseUrl, routeBase});
105
+ const [page, setPage] = useState(1);
106
+ const [sortColumn, setSortColumn] = useState<ColumnSortInterface | undefined>();
107
+
108
+ const routePath = `${resolvedApiBase}/announcements`;
109
+ const {useListQuery} = useAdminApi(api, routePath, "Announcement");
110
+
111
+ const sortString = buildSortString(sortColumn) ?? "-priority,-publishedAt";
112
+
113
+ const {
114
+ data: listData,
115
+ isLoading,
116
+ error,
117
+ } = useListQuery({
118
+ limit: DEFAULT_LIMIT,
119
+ page,
120
+ sort: sortString,
121
+ });
122
+
123
+ const ActionsCell: React.FC<{column: DataTableColumn; cellData: DataTableCellData}> = useCallback(
124
+ ({cellData}: {column: DataTableColumn; cellData: DataTableCellData}) => {
125
+ const {id} = cellData.value as {id: string};
126
+ if (!onRowClick) {
127
+ return null;
128
+ }
129
+ return (
130
+ <Box alignItems="center" direction="row" gap={1} justifyContent="end">
131
+ <IconButton
132
+ accessibilityLabel="Edit"
133
+ iconName="pen-to-square"
134
+ onClick={() => onRowClick(id)}
135
+ tooltipText="Edit"
136
+ variant="muted"
137
+ />
138
+ </Box>
139
+ );
140
+ },
141
+ [onRowClick]
142
+ );
143
+
144
+ const customColumnComponentMap: DataTableCustomComponentMap = useMemo(
145
+ () => ({[ACTIONS_COLUMN_TYPE]: ActionsCell}),
146
+ [ActionsCell]
147
+ );
148
+
149
+ const columns: DataTableColumn[] = [
150
+ ...DATA_COLUMNS,
151
+ ...(onRowClick
152
+ ? [{columnType: ACTIONS_COLUMN_TYPE, sortable: false, title: "", width: 60}]
153
+ : []),
154
+ ];
155
+
156
+ const rows = ((listData?.data ?? []) as AnnouncementListItem[]).map((item) => {
157
+ const dataCells = DATA_COLUMN_KEYS.map((key) => {
158
+ const value = item[key];
159
+ if (key === "publishedAt" || key === "expiresAt") {
160
+ return {value: formatDateCell(value)};
161
+ }
162
+ if (key === "priority" || key === "version") {
163
+ return {value: typeof value === "number" ? String(value) : (value ?? "0")};
164
+ }
165
+ return {value: value ?? ""};
166
+ });
167
+ if (onRowClick) {
168
+ dataCells.push({value: {id: item._id}});
169
+ }
170
+ return dataCells;
171
+ });
172
+
173
+ const totalPages = listData ? Math.ceil(listData.total / DEFAULT_LIMIT) : 1;
174
+
175
+ return (
176
+ <Page color="transparent" maxWidth="100%" padding={0}>
177
+ <Box alignItems="center" direction="row" justifyContent="between" padding={3}>
178
+ <Text size="lg">Announcements</Text>
179
+ {onCreateNew && (
180
+ <Button
181
+ onClick={onCreateNew}
182
+ testID="announcement-list-create-button"
183
+ text="Create New"
184
+ variant="primary"
185
+ />
186
+ )}
187
+ </Box>
188
+ {isLoading ? (
189
+ <Box alignItems="center" justifyContent="center" padding={6}>
190
+ <Spinner />
191
+ </Box>
192
+ ) : error ? (
193
+ <Box alignItems="center" padding={6}>
194
+ <Text color="error">Failed to load announcements.</Text>
195
+ </Box>
196
+ ) : rows.length === 0 ? (
197
+ <Box alignItems="center" padding={6}>
198
+ <Text color="secondaryDark">No announcements found.</Text>
199
+ </Box>
200
+ ) : (
201
+ <DataTable
202
+ columns={columns}
203
+ customColumnComponentMap={customColumnComponentMap}
204
+ data={rows}
205
+ page={page}
206
+ setPage={setPage}
207
+ setSortColumn={setSortColumn}
208
+ sortColumn={sortColumn}
209
+ totalPages={totalPages}
210
+ />
211
+ )}
212
+ </Page>
213
+ );
214
+ };