@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
@@ -97,12 +97,38 @@ describe("buildAdminListQueryParams", () => {
97
97
  assert.equal(params.created_gte, "2026-01-01");
98
98
  assert.equal(params.created_lte, "2026-01-31");
99
99
  assert.equal(params.status, "open");
100
- assert.equal(params.title, "hello");
100
+ assert.deepEqual(params.title, {$options: "i", $regex: "hello"});
101
101
  assert.equal(params.ownerId, "abc");
102
102
  assert.equal(params.q, "q");
103
103
  assert.isUndefined(params.completed);
104
104
  });
105
105
 
106
+ it("forwards choice multi-select as $in and omits $or", () => {
107
+ const modelConfig = {
108
+ filters: [
109
+ {
110
+ choices: [
111
+ {label: "Open", value: "open"},
112
+ {label: "Closed", value: "closed"},
113
+ ],
114
+ field: "status",
115
+ kind: "choice",
116
+ },
117
+ ],
118
+ searchFields: ["title"],
119
+ } as AdminModelConfig;
120
+ const params = buildAdminListQueryParams({
121
+ filterState: {status: ["open", "closed"]},
122
+ limit: 10,
123
+ modelConfig,
124
+ page: 1,
125
+ searchDebounced: "find me",
126
+ });
127
+ assert.deepEqual(params.status, {$in: ["open", "closed"]});
128
+ assert.equal(params.q, "find me");
129
+ assert.isUndefined(params.$or);
130
+ });
131
+
106
132
  it("coerces boolean filters and skips blank date bounds", () => {
107
133
  const modelConfig = {
108
134
  filters: [
@@ -125,4 +151,37 @@ describe("buildAdminListQueryParams", () => {
125
151
  assert.isUndefined(params.created_gte);
126
152
  assert.isUndefined(params.created_lte);
127
153
  });
154
+
155
+ it("forwards allowEmpty priority filters as scalar or empty sentinel", () => {
156
+ const modelConfig = {
157
+ filters: [
158
+ {
159
+ allowEmpty: true,
160
+ choices: [
161
+ {label: "High", value: "high"},
162
+ {label: "Low", value: "low"},
163
+ ],
164
+ field: "priority",
165
+ kind: "choice",
166
+ },
167
+ ],
168
+ } as AdminModelConfig;
169
+ const highOnly = buildAdminListQueryParams({
170
+ filterState: {priority: ["high"]},
171
+ limit: 25,
172
+ modelConfig,
173
+ page: 1,
174
+ searchDebounced: "",
175
+ });
176
+ assert.equal(highOnly.priority, "high");
177
+
178
+ const emptyOnly = buildAdminListQueryParams({
179
+ filterState: {priority: ["__empty__"]},
180
+ limit: 25,
181
+ modelConfig,
182
+ page: 1,
183
+ searchDebounced: "",
184
+ });
185
+ assert.deepEqual(emptyOnly.priority, {$in: ["__empty__"]});
186
+ });
128
187
  });
@@ -1,24 +1,34 @@
1
+ import {
2
+ buildDataTableListQuery,
3
+ type DataTableColumn,
4
+ type DataTableColumnFilter,
5
+ } from "@terreno/ui";
6
+
1
7
  import type {AdminModelConfig} from "./types";
2
8
 
3
9
  export const ADMIN_LIST_MAX_SELECTION = 1000;
4
10
 
5
- export type AdminListFilterState = Record<string, string | boolean | undefined>;
11
+ export type AdminListFilterState = Record<string, string | boolean | string[] | undefined>;
6
12
 
7
- const isEmptyFilterValue = (value: string | boolean | undefined): boolean => {
13
+ const isEmptyFilterValue = (value: string | boolean | string[] | undefined): boolean => {
8
14
  if (value === undefined || value === "") {
9
15
  return true;
10
16
  }
11
17
  if (value === "all") {
12
18
  return true;
13
19
  }
20
+ if (Array.isArray(value) && value.length === 0) {
21
+ return true;
22
+ }
14
23
  return false;
15
24
  };
16
25
 
17
26
  /** Drops unset / "all" keys so draft vs applied comparison is stable. */
27
+ /** @internal */
18
28
  export const compactAdminFilterState = (
19
29
  state: AdminListFilterState
20
- ): Record<string, string | boolean> => {
21
- const compacted: Record<string, string | boolean> = {};
30
+ ): Record<string, string | boolean | string[]> => {
31
+ const compacted: Record<string, string | boolean | string[]> = {};
22
32
  const keys = Object.keys(state).sort();
23
33
  for (const key of keys) {
24
34
  const value = state[key];
@@ -29,6 +39,10 @@ export const compactAdminFilterState = (
29
39
  compacted[key] = value;
30
40
  continue;
31
41
  }
42
+ if (Array.isArray(value)) {
43
+ compacted[key] = value;
44
+ continue;
45
+ }
32
46
  compacted[key] = String(value).trim();
33
47
  if (compacted[key] === "") {
34
48
  delete compacted[key];
@@ -50,6 +64,41 @@ export const adminFilterStateHasValues = (state: AdminListFilterState): boolean
50
64
  return Object.keys(compactAdminFilterState(state)).length > 0;
51
65
  };
52
66
 
67
+ const toDataTableFilter = (
68
+ filter: NonNullable<AdminModelConfig["filters"]>[number]
69
+ ): DataTableColumnFilter | undefined => {
70
+ if (filter.kind === "text") {
71
+ return {field: filter.field, kind: "text"};
72
+ }
73
+ if (filter.kind === "boolean") {
74
+ return {field: filter.field, kind: "boolean"};
75
+ }
76
+ if (filter.kind === "dateRange") {
77
+ return {field: filter.field, kind: "dateRange"};
78
+ }
79
+ if (filter.kind === "choice") {
80
+ return {
81
+ allowEmpty: filter.allowEmpty === true,
82
+ field: filter.field,
83
+ kind: "choice",
84
+ options: filter.choices ?? [],
85
+ };
86
+ }
87
+ return undefined;
88
+ };
89
+
90
+ const toDataTableColumns = (modelConfig: AdminModelConfig): DataTableColumn[] => {
91
+ const filters = modelConfig.filters ?? [];
92
+ return filters
93
+ .filter((filter) => filter.kind !== "ref")
94
+ .map((filter) => ({
95
+ columnType: "text",
96
+ filter: toDataTableFilter(filter),
97
+ title: filter.field,
98
+ width: 1,
99
+ }));
100
+ };
101
+
53
102
  /**
54
103
  * Builds query params for `GET` admin modelRouter list routes from UI state.
55
104
  */
@@ -68,40 +117,50 @@ export const buildAdminListQueryParams = (input: {
68
117
  if (input.sort) {
69
118
  out.sort = input.sort;
70
119
  }
71
- const {filterState, modelConfig, searchDebounced} = input;
72
- const filters = modelConfig.filters ?? [];
73
- for (const f of filters) {
74
- if (f.kind === "dateRange") {
75
- const gteKey = `${f.field}_gte`;
76
- const lteKey = `${f.field}_lte`;
77
- const gteVal = filterState[gteKey];
78
- const lteVal = filterState[lteKey];
79
- if (gteVal !== undefined && String(gteVal).trim() !== "") {
80
- out[gteKey] = String(gteVal).trim();
81
- }
82
- if (lteVal !== undefined && String(lteVal).trim() !== "") {
83
- out[lteKey] = String(lteVal).trim();
84
- }
120
+
121
+ const normalizedFilterValues: Record<string, unknown> = {...input.filterState};
122
+ for (const filter of input.modelConfig.filters ?? []) {
123
+ if (filter.kind !== "boolean") {
85
124
  continue;
86
125
  }
87
- const raw = filterState[f.field];
88
- if (raw === undefined || raw === "") {
126
+ const raw = normalizedFilterValues[filter.field];
127
+ if (raw === "true" || raw === true) {
128
+ normalizedFilterValues[filter.field] = true;
129
+ continue;
130
+ }
131
+ if (raw === "false" || raw === false) {
132
+ normalizedFilterValues[filter.field] = false;
133
+ }
134
+ }
135
+
136
+ const tableQuery = buildDataTableListQuery({
137
+ columns: toDataTableColumns(input.modelConfig),
138
+ filterValues: normalizedFilterValues,
139
+ search: "",
140
+ searchFields: [],
141
+ });
142
+ for (const [key, value] of Object.entries(tableQuery)) {
143
+ if (key === "$or") {
89
144
  continue;
90
145
  }
91
- if (f.kind === "boolean") {
92
- if (raw === "all") {
93
- continue;
94
- }
95
- out[f.field] = raw === true || raw === "true";
146
+ out[key] = value;
147
+ }
148
+
149
+ for (const filter of input.modelConfig.filters ?? []) {
150
+ if (filter.kind !== "ref") {
96
151
  continue;
97
152
  }
98
- if (f.kind === "choice" || f.kind === "text" || f.kind === "ref") {
99
- out[f.field] = String(raw);
153
+ const raw = input.filterState[filter.field];
154
+ if (raw === undefined || raw === "") {
155
+ continue;
100
156
  }
157
+ out[filter.field] = String(raw);
101
158
  }
102
- const searchFields = modelConfig.searchFields ?? [];
103
- if (searchFields.length > 0 && searchDebounced.trim() !== "") {
104
- out.q = searchDebounced.trim();
159
+
160
+ const searchFields = input.modelConfig.searchFields ?? [];
161
+ if (searchFields.length > 0 && input.searchDebounced.trim() !== "") {
162
+ out.q = input.searchDebounced.trim();
105
163
  }
164
+
106
165
  return out;
107
166
  };
@@ -0,0 +1,216 @@
1
+ import {afterEach, describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {
5
+ AdminAPIError,
6
+ adminRequest,
7
+ bindAdminRequest,
8
+ DEFAULT_ADMIN_REQUEST_TIMEOUT_MS,
9
+ } from "./adminRequest";
10
+
11
+ describe("adminRequest", () => {
12
+ const originalFetch = globalThis.fetch;
13
+
14
+ afterEach(() => {
15
+ globalThis.fetch = originalFetch;
16
+ });
17
+
18
+ it("forwards credentials and JSON-stringifies object bodies", async () => {
19
+ let captured: RequestInit | undefined;
20
+ globalThis.fetch = (async (_url: string, init?: RequestInit) => {
21
+ captured = init;
22
+ return new Response(JSON.stringify({ok: true}), {
23
+ headers: {"Content-Type": "application/json"},
24
+ status: 200,
25
+ });
26
+ }) as typeof fetch;
27
+
28
+ const result = await adminRequest({
29
+ body: {title: "Hi"},
30
+ credentials: "same-origin",
31
+ method: "POST",
32
+ url: "/admin/todos",
33
+ });
34
+ assert.deepEqual(result, {ok: true});
35
+ assert.strictEqual(captured?.credentials, "same-origin");
36
+ assert.strictEqual(captured?.method, "POST");
37
+ assert.strictEqual(captured?.body, JSON.stringify({title: "Hi"}));
38
+ const headers = new Headers(captured?.headers);
39
+ assert.strictEqual(headers.get("Content-Type"), "application/json");
40
+ });
41
+
42
+ it("does not JSON-stringify FormData and does not set Content-Type", async () => {
43
+ let captured: RequestInit | undefined;
44
+ globalThis.fetch = (async (_url: string, init?: RequestInit) => {
45
+ captured = init;
46
+ return new Response(null, {status: 204});
47
+ }) as typeof fetch;
48
+
49
+ const formData = new FormData();
50
+ formData.append("file", "bytes");
51
+ await adminRequest({body: formData, method: "POST", url: "/documents"});
52
+ assert.instanceOf(captured?.body, FormData);
53
+ const headers = new Headers(captured?.headers);
54
+ assert.isNull(headers.get("Content-Type"));
55
+ });
56
+
57
+ it("maps 4xx JSON failures to AdminAPIError", async () => {
58
+ globalThis.fetch = (async () => {
59
+ return new Response(JSON.stringify({detail: "q", title: "Invalid filter"}), {
60
+ headers: {"Content-Type": "application/json"},
61
+ status: 400,
62
+ });
63
+ }) as typeof fetch;
64
+
65
+ try {
66
+ await adminRequest({method: "GET", url: "/admin/todos"});
67
+ assert.fail("expected AdminAPIError");
68
+ } catch (error) {
69
+ assert.instanceOf(error, AdminAPIError);
70
+ const apiError = error as AdminAPIError;
71
+ assert.strictEqual(apiError.status, 400);
72
+ assert.strictEqual(apiError.data.title, "Invalid filter");
73
+ assert.strictEqual(apiError.data.detail, "q");
74
+ }
75
+ });
76
+
77
+ it("maps 5xx failures without JSON to AdminAPIError", async () => {
78
+ globalThis.fetch = (async () => {
79
+ return new Response("nope", {status: 503, statusText: "Service Unavailable"});
80
+ }) as typeof fetch;
81
+
82
+ try {
83
+ await adminRequest({method: "GET", url: "/admin/config"});
84
+ assert.fail("expected AdminAPIError");
85
+ } catch (error) {
86
+ assert.instanceOf(error, AdminAPIError);
87
+ const apiError = error as AdminAPIError;
88
+ assert.strictEqual(apiError.status, 503);
89
+ assert.strictEqual(apiError.data.title, "Service Unavailable");
90
+ }
91
+ });
92
+
93
+ it("aborts when the timeout elapses", async () => {
94
+ globalThis.fetch = (async (_url: string, init?: RequestInit) => {
95
+ return await new Promise((_resolve, reject) => {
96
+ init?.signal?.addEventListener("abort", () => {
97
+ reject(Object.assign(new Error("Aborted"), {name: "AbortError"}));
98
+ });
99
+ });
100
+ }) as typeof fetch;
101
+
102
+ try {
103
+ await adminRequest({method: "GET", timeoutMs: 5, url: "/admin/slow"});
104
+ assert.fail("expected timeout AdminAPIError");
105
+ } catch (error) {
106
+ assert.instanceOf(error, AdminAPIError);
107
+ const apiError = error as AdminAPIError;
108
+ assert.strictEqual(apiError.status, 0);
109
+ assert.include(apiError.data.title.toLowerCase(), "timed out");
110
+ }
111
+ });
112
+
113
+ it("uses the default timeout constant", () => {
114
+ assert.strictEqual(DEFAULT_ADMIN_REQUEST_TIMEOUT_MS, 30_000);
115
+ });
116
+
117
+ it("returns a Blob when parseAs is blob", async () => {
118
+ globalThis.fetch = (async () => {
119
+ return new Response(new Uint8Array([1, 2, 3]), {
120
+ headers: {"Content-Type": "application/pdf"},
121
+ status: 200,
122
+ });
123
+ }) as typeof fetch;
124
+ const result = await adminRequest({
125
+ method: "GET",
126
+ parseAs: "blob",
127
+ url: "/documents/download/a",
128
+ });
129
+ assert.instanceOf(result, Blob);
130
+ });
131
+ });
132
+
133
+ describe("bindAdminRequest host auth", () => {
134
+ const originalFetch = globalThis.fetch;
135
+
136
+ afterEach(() => {
137
+ globalThis.fetch = originalFetch;
138
+ });
139
+
140
+ const captureFetch = (): {captured: RequestInit | undefined} => {
141
+ const state: {captured: RequestInit | undefined} = {captured: undefined};
142
+ globalThis.fetch = (async (_url: string, init?: RequestInit) => {
143
+ state.captured = init;
144
+ return new Response(JSON.stringify({ok: true}), {
145
+ headers: {"Content-Type": "application/json"},
146
+ status: 200,
147
+ });
148
+ }) as typeof fetch;
149
+ return state;
150
+ };
151
+
152
+ it("SPA fixture uses same-origin credentials and omits Authorization", async () => {
153
+ const state = captureFetch();
154
+ const request = bindAdminRequest({
155
+ credentials: "same-origin",
156
+ getAuthHeaders: () => ({}),
157
+ });
158
+
159
+ await request({method: "GET", url: "/admin/config"});
160
+
161
+ assert.strictEqual(state.captured?.credentials, "same-origin");
162
+ const headers = new Headers(state.captured?.headers);
163
+ assert.isFalse(headers.has("Authorization"));
164
+ assert.isFalse(headers.has("authorization"));
165
+ });
166
+
167
+ it("embedded fixture sends Bearer from getAuthHeaders", async () => {
168
+ const state = captureFetch();
169
+ const request = bindAdminRequest({
170
+ getAuthHeaders: () => ({Authorization: "Bearer test-session-token"}),
171
+ });
172
+
173
+ await request({method: "GET", url: "/admin/config"});
174
+
175
+ assert.isUndefined(state.captured?.credentials);
176
+ const headers = new Headers(state.captured?.headers);
177
+ assert.strictEqual(headers.get("Authorization"), "Bearer test-session-token");
178
+ });
179
+
180
+ it("prefixes relative RPC URLs with the embedded API origin", async () => {
181
+ let capturedUrl = "";
182
+ globalThis.fetch = (async (url: string) => {
183
+ capturedUrl = String(url);
184
+ return new Response(JSON.stringify({ok: true}), {
185
+ headers: {"Content-Type": "application/json"},
186
+ status: 200,
187
+ });
188
+ }) as typeof fetch;
189
+ const request = bindAdminRequest({
190
+ getAuthHeaders: () => ({Authorization: "Bearer test-session-token"}),
191
+ origin: "http://localhost:4000/",
192
+ });
193
+
194
+ await request({method: "GET", url: "/admin/config"});
195
+
196
+ assert.strictEqual(capturedUrl, "http://localhost:4000/admin/config");
197
+ });
198
+
199
+ it("leaves absolute RPC URLs unchanged when origin is set", async () => {
200
+ let capturedUrl = "";
201
+ globalThis.fetch = (async (url: string) => {
202
+ capturedUrl = String(url);
203
+ return new Response(JSON.stringify({ok: true}), {
204
+ headers: {"Content-Type": "application/json"},
205
+ status: 200,
206
+ });
207
+ }) as typeof fetch;
208
+ const request = bindAdminRequest({
209
+ origin: "http://localhost:4000",
210
+ });
211
+
212
+ await request({method: "GET", url: "https://api.example.com/admin/config"});
213
+
214
+ assert.strictEqual(capturedUrl, "https://api.example.com/admin/config");
215
+ });
216
+ });
@@ -0,0 +1,213 @@
1
+ import type {AdminGetAuthHeaders} from "./types";
2
+
3
+ /** Default AbortController timeout for {@link adminRequest}. */
4
+ export const DEFAULT_ADMIN_REQUEST_TIMEOUT_MS = 30_000;
5
+
6
+ export interface AdminRequestArgs {
7
+ url: string;
8
+ method?: string;
9
+ body?: BodyInit | Record<string, unknown> | null;
10
+ signal?: AbortSignal;
11
+ credentials?: RequestCredentials;
12
+ headers?: HeadersInit;
13
+ timeoutMs?: number;
14
+ parseAs?: "json" | "text" | "blob";
15
+ }
16
+
17
+ /**
18
+ * Thrown for non-2xx responses and timeouts. Shape matches `@terreno/ui` `APIError`
19
+ * (`status` + `data.title`) so existing admin screens can display it.
20
+ */
21
+ export class AdminAPIError extends Error {
22
+ data: {detail?: string; title: string};
23
+ status: number;
24
+
25
+ constructor({
26
+ detail,
27
+ status,
28
+ title,
29
+ }: {
30
+ detail?: string;
31
+ status: number;
32
+ title: string;
33
+ }) {
34
+ super(title);
35
+ this.name = "AdminAPIError";
36
+ this.data = {detail, title};
37
+ this.status = status;
38
+ }
39
+ }
40
+
41
+ const isFormData = (value: unknown): value is FormData => {
42
+ return typeof FormData !== "undefined" && value instanceof FormData;
43
+ };
44
+
45
+ const isJsonBody = (value: unknown): value is Record<string, unknown> => {
46
+ if (value == null || typeof value !== "object") {
47
+ return false;
48
+ }
49
+ if (isFormData(value)) {
50
+ return false;
51
+ }
52
+ if (typeof Blob !== "undefined" && value instanceof Blob) {
53
+ return false;
54
+ }
55
+ if (typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer) {
56
+ return false;
57
+ }
58
+ return true;
59
+ };
60
+
61
+ const readErrorPayload = async (response: Response): Promise<{detail?: string; title: string}> => {
62
+ const contentType = response.headers.get("Content-Type") ?? "";
63
+ if (contentType.includes("application/json")) {
64
+ try {
65
+ const parsed = (await response.json()) as {detail?: string; title?: string};
66
+ if (typeof parsed.title === "string" && parsed.title.length > 0) {
67
+ return {detail: parsed.detail, title: parsed.title};
68
+ }
69
+ } catch {
70
+ // Fall through to status text.
71
+ }
72
+ }
73
+ const fallback = response.statusText.trim();
74
+ return {title: fallback.length > 0 ? fallback : `Request failed (${response.status})`};
75
+ };
76
+
77
+ /**
78
+ * Native `fetch` helper for admin RPC (config, scripts, roles, …). Not axios and not
79
+ * RTK `injectEndpoints`. Hosts inject auth via {@link bindAdminRequest} /
80
+ * `AdminProvider` `{getAuthHeaders, credentials}`.
81
+ */
82
+ export const adminRequest = async <T = unknown>({
83
+ body,
84
+ credentials,
85
+ headers,
86
+ method = "GET",
87
+ parseAs,
88
+ signal,
89
+ timeoutMs = DEFAULT_ADMIN_REQUEST_TIMEOUT_MS,
90
+ url,
91
+ }: AdminRequestArgs): Promise<T> => {
92
+ const controller = new AbortController();
93
+ const onAbort = (): void => {
94
+ controller.abort();
95
+ };
96
+ if (signal) {
97
+ if (signal.aborted) {
98
+ controller.abort();
99
+ } else {
100
+ signal.addEventListener("abort", onAbort, {once: true});
101
+ }
102
+ }
103
+ const timeoutId = setTimeout(() => {
104
+ controller.abort();
105
+ }, timeoutMs);
106
+
107
+ const requestHeaders = new Headers(headers);
108
+ let requestBody: BodyInit | undefined;
109
+ if (isFormData(body)) {
110
+ requestBody = body;
111
+ } else if (isJsonBody(body)) {
112
+ requestBody = JSON.stringify(body);
113
+ if (!requestHeaders.has("Content-Type")) {
114
+ requestHeaders.set("Content-Type", "application/json");
115
+ }
116
+ } else if (body != null) {
117
+ requestBody = body as BodyInit;
118
+ }
119
+
120
+ try {
121
+ const response = await globalThis.fetch(url, {
122
+ body: requestBody,
123
+ credentials,
124
+ headers: requestHeaders,
125
+ method,
126
+ signal: controller.signal,
127
+ });
128
+ if (!response.ok) {
129
+ const payload = await readErrorPayload(response);
130
+ throw new AdminAPIError({...payload, status: response.status});
131
+ }
132
+ if (response.status === 204) {
133
+ return undefined as T;
134
+ }
135
+ if (parseAs === "blob") {
136
+ return (await response.blob()) as T;
137
+ }
138
+ if (parseAs === "text") {
139
+ return (await response.text()) as T;
140
+ }
141
+ const contentType = response.headers.get("Content-Type") ?? "";
142
+ if (contentType.includes("application/json")) {
143
+ return (await response.json()) as T;
144
+ }
145
+ return (await response.text()) as T;
146
+ } catch (error) {
147
+ if (error instanceof AdminAPIError) {
148
+ throw error;
149
+ }
150
+ const name = error instanceof Error ? error.name : "";
151
+ if (name === "AbortError" || controller.signal.aborted) {
152
+ throw new AdminAPIError({status: 0, title: "Request timed out"});
153
+ }
154
+ throw error;
155
+ } finally {
156
+ clearTimeout(timeoutId);
157
+ signal?.removeEventListener("abort", onAbort);
158
+ }
159
+ };
160
+
161
+ export interface BindAdminRequestOptions {
162
+ credentials?: RequestCredentials;
163
+ getAuthHeaders?: AdminGetAuthHeaders;
164
+ /**
165
+ * API origin for embedded hosts (e.g. `http://localhost:4000`). Absolute `url`
166
+ * values are left unchanged. Relative paths such as `/admin/config` and
167
+ * `/rbac/roles` are prefixed so they do not hit the Expo web origin.
168
+ */
169
+ origin?: string;
170
+ }
171
+
172
+ /**
173
+ * Prefix a relative admin RPC URL with the host API origin. Same-origin SPA
174
+ * hosts omit `origin` and keep path-only URLs.
175
+ */
176
+ const resolveAdminFetchUrl = ({origin, url}: {origin?: string; url: string}): string => {
177
+ if (!origin) {
178
+ return url;
179
+ }
180
+ if (/^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith("//")) {
181
+ return url;
182
+ }
183
+ const trimmedOrigin = origin.replace(/\/$/, "");
184
+ const path = url.startsWith("/") ? url : `/${url}`;
185
+ return `${trimmedOrigin}${path}`;
186
+ };
187
+
188
+ /**
189
+ * Bind host auth onto {@link adminRequest}.
190
+ * SPA: `credentials: "same-origin"` and no Bearer headers.
191
+ * Embedded: `getAuthHeaders` returns `Authorization: Bearer …` plus `origin`.
192
+ */
193
+ export const bindAdminRequest = ({
194
+ credentials,
195
+ getAuthHeaders,
196
+ origin,
197
+ }: BindAdminRequestOptions): ((args: AdminRequestArgs) => Promise<unknown>) => {
198
+ return async (args: AdminRequestArgs): Promise<unknown> => {
199
+ const headers = new Headers(args.headers);
200
+ if (getAuthHeaders) {
201
+ const extra = await getAuthHeaders();
202
+ new Headers(extra).forEach((value, key) => {
203
+ headers.set(key, value);
204
+ });
205
+ }
206
+ return adminRequest({
207
+ ...args,
208
+ credentials: args.credentials ?? credentials,
209
+ headers,
210
+ url: resolveAdminFetchUrl({origin, url: args.url}),
211
+ });
212
+ };
213
+ };
@@ -0,0 +1,18 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {asJsonBody, withQueryString} from "./adminRpc";
5
+
6
+ describe("withQueryString", () => {
7
+ it("omits empty params and stringifies the rest", () => {
8
+ assert.strictEqual(withQueryString({url: "/comms/messages"}), "/comms/messages");
9
+ assert.strictEqual(
10
+ withQueryString({params: {limit: 20, page: 1, q: ""}, url: "/comms/messages"}),
11
+ "/comms/messages?limit=20&page=1"
12
+ );
13
+ });
14
+
15
+ it("asJsonBody preserves JSON objects for adminRequest", () => {
16
+ assert.deepEqual(asJsonBody({kind: "bulk-patch"}), {kind: "bulk-patch"});
17
+ });
18
+ });